From 1c6316111d93426ecd4252f568ebe834e4439bb9 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sat, 10 Jan 2026 22:09:10 +0800
Subject: [PATCH 01/64] docs: update docs for operators (#847)

---
 docs/source/tutorials/operators.md       | 46 ++++++++++++++++++++
 docs/source/zh-cn/tutorials/operators.md | 53 ++++++++++++++++++++++--
 2 files changed, 96 insertions(+), 3 deletions(-)

diff --git a/docs/source/tutorials/operators.md b/docs/source/tutorials/operators.md
index 34e5a0202..f8b5949d3 100644
--- a/docs/source/tutorials/operators.md
+++ b/docs/source/tutorials/operators.md
@@ -9,6 +9,52 @@ LiquidJS operators are very simple and different. There're 2 types of operators
 
 Thus numerical operators are not supported and you cannot even plus two numbers like this `{% raw %}{{a + b}}{% endraw %}`, instead we need a filter `{% raw %}{{ a | plus: b}}{% endraw %}`. Actually `+` is a valid variable name in LiquidJS.
 
+## Logic Operators
+
+### not
+
+Negates a condition. Returns `true` if the condition is false, and `false` if the condition is true.
+
+Input
+```liquid
+{% if not user.active %}
+  User is inactive
+{% endif %}
+```
+
+### and
+
+Returns `true` if both conditions are true.
+
+Input
+```liquid
+{% if user.age >= 18 and user.verified %}
+  Access granted
+{% endif %}
+```
+
+### or
+
+Returns `true` if at least one condition is true.
+
+Input
+```liquid
+{% if user.isAdmin or user.isModerator %}
+  You have elevated privileges
+{% endif %}
+```
+
+### contains
+
+Checks if a string contains a substring, or if an array contains an element.
+
+Input
+```liquid
+{% if product.title contains "Pack" %}
+  This is a pack
+{% endif %}
+```
+
 ## Precedence
 
 1. Comparison operators, and `contains`. All comparison operators alongside `contains` have the same (highest) precedence.
diff --git a/docs/source/zh-cn/tutorials/operators.md b/docs/source/zh-cn/tutorials/operators.md
index 1b567d335..68fe1a4d0 100644
--- a/docs/source/zh-cn/tutorials/operators.md
+++ b/docs/source/zh-cn/tutorials/operators.md
@@ -5,14 +5,61 @@ title: 运算符
 LiquidJS 运算符非常简单也很特别，只支持两类运算符：
 
 * 比较运算符：`==`, `!=`, `>`, `<`, `>=`, `<=`
-* 逻辑运算符：`or`, `and`, `contains`
+* 逻辑运算符：`not`, `or`, `and`, `contains`
 
 因此普通的数学运算是不支持的，比如 `{% raw %}{{a + b}}{% endraw %}`。它的替代方案是过滤器 `{% raw %}{{ a | plus: b}}{% endraw %}`。事实上 `+` 在 LiquidJS 中是一个合法的变量名。
 
+## 逻辑运算符
+
+### not
+
+对条件取反。如果条件为假则返回 `true`，如果条件为真则返回 `false`。
+
+输入
+```liquid
+{% if not user.active %}
+  用户未激活
+{% endif %}
+```
+
+### and
+
+当两个条件都为真时返回 `true`。
+
+输入
+```liquid
+{% if user.age >= 18 and user.verified %}
+  允许访问
+{% endif %}
+```
+
+### or
+
+当至少一个条件为真时返回 `true`。
+
+输入
+```liquid
+{% if user.isAdmin or user.isModerator %}
+  您拥有提升的权限
+{% endif %}
+```
+
+### contains
+
+检查字符串是否包含子字符串，或数组是否包含元素。
+
+输入
+```liquid
+{% if product.title contains "Pack" %}
+  这是一个套装
+{% endif %}
+```
+
 ## 优先级
 
-1. 比较运算符。所有比较运算符具有同样的优先级，且高于逻辑运算符。
-2. 逻辑运算符。所有逻辑运算符具有同样的有衔接。
+1. 比较运算符和 `contains`。所有比较运算符和 `contains` 具有同样的（最高）优先级。
+2. `not` 运算符。它的优先级略高于 `or` 和 `and`。
+3. `or` 和 `and` 运算符。这些逻辑运算符具有同样的（最低）优先级。
 
 ## 结合性
 

From 02403a18798716f220ff65c222b86ae7896060f5 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 19 Jan 2026 23:26:49 +0800
Subject: [PATCH 02/64] docs: Change LambdaTest to TestMu AI (#848)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index afabdccf9..a7d574115 100644
--- a/README.md
+++ b/README.md
@@ -81,7 +81,7 @@ If you personally love LiquidJS or it's benefiting your business, please conside
   <a href="https://customer.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/1152079?v=4&s=100" height="80" style="vertical-align: middle;" alt="Customer IO" title="Customer IO"/></a>
   <a href="https://syntax.fm/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/130389858?v=4&s=100" height="80" style="vertical-align: middle;" alt="Syntax Podcast" title="Syntax Podcast"/></a>
   <br/>
-  <a href="https://www.lambdatest.com/?utm_source=liquidjs&utm_medium=sponsor" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://www.lambdatest.com/blue-logo.png" width="240" style="vertical-align: middle;" alt="LambdaTest" title="LambdaTest"/></a>
+  <a href="https://www.testmu.ai/?utm_source=liquidjs&utm_medium=sponsor" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/27130435?s=200&v=4" width="80" style="vertical-align: middle;" alt="TestMu AI" title="TestMu AI"/></a>
   <a href="https://chudovo.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/Chudovo/avatar/256.png?height=100" width="160" style="vertical-align: middle;background: white;padding: 8px 16px;" alt="Chudovo" title="Chudovo"/></a>
   <a href="https://dailycontributors.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/dailycontributors/3c2e057/logo/256.png?height=50&width=100" width="120" style="vertical-align: middle;" alt="Dailycontributors" title="Dailycontributors"/></a>
   <a href="https://www.pakstyle.pk/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/pakstyle/2b81605/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="PakStyle.pk" title="PakStyle.pk"/></a>

From 85233e0568e5bfe7d5b9d8673335e4872ad21e88 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sat, 14 Feb 2026 13:54:03 +0800
Subject: [PATCH 03/64] docs: update testmu sponsor link (#850)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a7d574115..3f9a2baef 100644
--- a/README.md
+++ b/README.md
@@ -81,7 +81,7 @@ If you personally love LiquidJS or it's benefiting your business, please conside
   <a href="https://customer.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/1152079?v=4&s=100" height="80" style="vertical-align: middle;" alt="Customer IO" title="Customer IO"/></a>
   <a href="https://syntax.fm/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/130389858?v=4&s=100" height="80" style="vertical-align: middle;" alt="Syntax Podcast" title="Syntax Podcast"/></a>
   <br/>
-  <a href="https://www.testmu.ai/?utm_source=liquidjs&utm_medium=sponsor" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/27130435?s=200&v=4" width="80" style="vertical-align: middle;" alt="TestMu AI" title="TestMu AI"/></a>
+  <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=liquidjs" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/27130435?s=200&v=4" width="80" style="vertical-align: middle;" alt="TestMu AI" title="TestMu AI"/></a>
   <a href="https://chudovo.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/Chudovo/avatar/256.png?height=100" width="160" style="vertical-align: middle;background: white;padding: 8px 16px;" alt="Chudovo" title="Chudovo"/></a>
   <a href="https://dailycontributors.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/dailycontributors/3c2e057/logo/256.png?height=50&width=100" width="120" style="vertical-align: middle;" alt="Dailycontributors" title="Dailycontributors"/></a>
   <a href="https://www.pakstyle.pk/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/pakstyle/2b81605/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="PakStyle.pk" title="PakStyle.pk"/></a>

From 3cd024d652dc883c46307581e979fe32302adbac Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 8 Mar 2026 02:36:09 +0800
Subject: [PATCH 04/64] fix: path traversal vulnerability, #851 (#855)

* Fix Path Traversal fallback

* Update loader.ts

Fixed nested

* Update loader.ts

padding fix

* refactor: reuse root enforcing

* docs: update test case and docs

---------

Co-authored-by: MorielHarush <93482738+MorielHarush@users.noreply.github.com>
---
 demo/esm/index.mjs                   |  2 +-
 demo/esm/test.sh                     |  2 +-
 demo/express/test.sh                 |  2 +-
 demo/nodejs/test.sh                  |  2 +-
 demo/template/test.sh                |  2 +-
 demo/typescript/test.sh              |  2 +-
 demo/webpack/test.sh                 |  2 +-
 docs/source/tutorials/render-file.md | 20 +++++++-------------
 src/fs/loader.ts                     | 23 ++++++++++++-----------
 test/e2e/issues.spec.ts              | 20 ++++++++++++++++++++
 test/tsconfig.json                   |  3 +--
 11 files changed, 47 insertions(+), 33 deletions(-)

diff --git a/demo/esm/index.mjs b/demo/esm/index.mjs
index 20b04df59..ff77ab3c2 100644
--- a/demo/esm/index.mjs
+++ b/demo/esm/index.mjs
@@ -8,7 +8,7 @@ const engine = new Liquid({
   // layout files for `{% layout %}`
   layouts: process.cwd() + '/layouts',
   // partial files for `{% include %}` and `{% render %}`
-  partials: process.cwd() + '/partials'
+  partials: [process.cwd() + '/partials', 'node_modules']
 })
 
 const ctx = {
diff --git a/demo/esm/test.sh b/demo/esm/test.sh
index ed85b9cd7..3beedd07d 100755
--- a/demo/esm/test.sh
+++ b/demo/esm/test.sh
@@ -1,3 +1,3 @@
-set -ex
+set -e
 
 npm start | grep 'LiquidJS Demo'
diff --git a/demo/express/test.sh b/demo/express/test.sh
index 66c15deac..ebf5f976d 100755
--- a/demo/express/test.sh
+++ b/demo/express/test.sh
@@ -1,4 +1,4 @@
-set -x
+set -e
 
 LOG_FILE=$(mktemp)
 npm start > $LOG_FILE 2>&1 &
diff --git a/demo/nodejs/test.sh b/demo/nodejs/test.sh
index 03beaae99..0593783fa 100755
--- a/demo/nodejs/test.sh
+++ b/demo/nodejs/test.sh
@@ -1,3 +1,3 @@
-set -ex
+set -e
 
 npm start | grep 'NodeJS Demo for LiquidJS'
diff --git a/demo/template/test.sh b/demo/template/test.sh
index 80d5ffd38..efcab2301 100755
--- a/demo/template/test.sh
+++ b/demo/template/test.sh
@@ -1,3 +1,3 @@
-set -ex
+set -e
 
 npm start | grep '\[11:8] {{ todo }}'
diff --git a/demo/typescript/test.sh b/demo/typescript/test.sh
index 59bedb032..6bf336a25 100755
--- a/demo/typescript/test.sh
+++ b/demo/typescript/test.sh
@@ -1,3 +1,3 @@
-set -ex
+set -e
 
 npm run build && npm start | grep 'TypeScript Demo for LiquidJS'
diff --git a/demo/webpack/test.sh b/demo/webpack/test.sh
index 7dc39dc1b..106350db1 100755
--- a/demo/webpack/test.sh
+++ b/demo/webpack/test.sh
@@ -1,4 +1,4 @@
-set -ex
+set -e
 
 npm run build
 npm start | grep 'Webpack Demo for LiquidJS'
diff --git a/docs/source/tutorials/render-file.md b/docs/source/tutorials/render-file.md
index 30c417888..0f636852f 100644
--- a/docs/source/tutorials/render-file.md
+++ b/docs/source/tutorials/render-file.md
@@ -45,26 +45,20 @@ It can be a string-typed path (see above example), or a list of root directories
 
 ```javascript
 var engine = new Liquid({
-    root: ['views/', 'views/partials/'],
+    root: ['views/'],
+    partials: ['views/partials/'],
+    layouts: ['views/layouts/'],
     extname: '.liquid'
 });
 ```
 
 {% note tip Relative Paths %}Relative paths in <code>root</code> will be resolved against <code>cwd()</code>.{% endnote %}
 
-When `{% raw %}{% render "foo" %}{% endraw %}` is rendered or `liquid.renderFile('foo')` is called, the following files will be looked up and the first existing file will be used:
+- When `parse()`, `render()` functions are called, for example `liquid.renderFile('foo')`, templates under `root` will be looked up.
+- When a partial is requested, for example `{% raw %}{% render "foo" %}{% endraw %}`, templates under `partials` will be looked up.
+- When a layout is requested, for example `{% raw %}{% layout "foo" %}{% endraw %}`, templates under `layouts` will be looked up.
 
-- `cwd()`/views/foo.liquid
-- `cwd()`/views/partials/foo.liquid
-
-If none of the above files exists, an `ENOENT` error will be thrown. Here's a demo for Node.js: [demo/nodejs](https://github.com/harttle/liquidjs/tree/master/demo/nodejs).
-
-When LiquidJS is used in browser, say current location is <https://example.com/bar/index.html>, only the first `root` will be used and the file to be fetched is:
-
-- <https://example.com/bar/foo.liquid>
-
-If fetch fails, a 404/500 error or network failures for example, an `ENOENT` error will be thrown.
-Here's a demo for browsers: [demo/browser](https://github.com/harttle/liquidjs/tree/master/demo/browser).
+When LiquidJS is used in browser, the paths will be resolved based on current location. Here's a demo for browsers: [demo/browser](https://github.com/harttle/liquidjs/tree/master/demo/browser).
 
 ## Abstract File System
 
diff --git a/src/fs/loader.ts b/src/fs/loader.ts
index cb59041b1..62c061a1a 100644
--- a/src/fs/loader.ts
+++ b/src/fs/loader.ts
@@ -43,25 +43,26 @@ export class Loader {
 
   public * candidates (file: string, dirs: string[], currentFile?: string, enforceRoot?: boolean) {
     const { fs, extname } = this.options
+    const isAllowed = (filepath: string) => {
+      if (!enforceRoot) return true
+      for (const dir of dirs) {
+        if (this.contains(dir, filepath)) return true
+      }
+      return false
+    }
+
     if (this.shouldLoadRelative(file) && currentFile) {
       const referenced = fs.resolve(this.dirname(currentFile), file, extname)
-      for (const dir of dirs) {
-        if (!enforceRoot || this.contains(dir, referenced)) {
-          // the relatively referenced file is within one of root dirs
-          yield referenced
-          break
-        }
-      }
+      if (isAllowed(referenced)) yield referenced
     }
     for (const dir of dirs) {
       const referenced = fs.resolve(dir, file, extname)
-      if (!enforceRoot || this.contains(dir, referenced)) {
-        yield referenced
-      }
+      if (isAllowed(referenced)) yield referenced
     }
+
     if (fs.fallback !== undefined) {
       const filepath = fs.fallback(file)
-      if (filepath !== undefined) yield filepath
+      if (filepath !== undefined && isAllowed(filepath)) yield filepath
     }
   }
 
diff --git a/test/e2e/issues.spec.ts b/test/e2e/issues.spec.ts
index 65ed98536..c5243fe66 100644
--- a/test/e2e/issues.spec.ts
+++ b/test/e2e/issues.spec.ts
@@ -1,4 +1,6 @@
 import { TopLevelToken, TagToken, Tokenizer, Context, Liquid, Drop, toValueSync, LiquidError, IfTag } from '../..'
+import { spawnSync } from 'child_process'
+import { resolve as resolvePath } from 'path'
 const LiquidUMD = require('../../dist/liquid.browser.umd.js').Liquid
 
 describe('Issues', function () {
@@ -173,6 +175,24 @@ describe('Issues', function () {
     const html = await engine.render(tpl, { my_variable: 'foo' })
     expect(html).toBe('CONTENT for /tmp/prefix/foo-bar/suffix')
   })
+  it('should prevent path traversal in dynamic include with restricted root, #851', () => {
+    const projectRoot = resolvePath(__dirname, '../..')
+    const poc = `
+      const { Liquid } = require('./dist/liquid.node.js');
+      const e = new Liquid({ root: ['/tmp'], partials: ['/tmp'], dynamicPartials: true });
+      e.parseAndRender('{% include page %}', { page: '../../../etc/passwd' })
+        .then(() => { console.log('OK'); })
+        .catch(err => { console.error('ERR:' + err.message); process.exit(1); });
+    `
+    const result = spawnSync(
+      process.execPath,
+      ['-e', poc],
+      { cwd: projectRoot, encoding: 'utf8' }
+    )
+
+    expect(result.status).not.toBe(0)
+    expect(result.stderr).toContain('Failed to lookup')
+  })
   it('Implement liquid/echo tags #428', () => {
     const template = `{%- liquid
       for value in array
diff --git a/test/tsconfig.json b/test/tsconfig.json
index 83e0923c2..8c81c92cc 100644
--- a/test/tsconfig.json
+++ b/test/tsconfig.json
@@ -10,8 +10,7 @@
     "allowSyntheticDefaultImports": true,
     "resolveJsonModule": true,
     "downlevelIteration": true,
-    "strict": true,
-    "suppressImplicitAnyIndexErrors": true
+    "strict": true
   },
   "all": true
 }

From 0d9e7978898b5d098caca65e8fae65b960c5d76d Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 8 Mar 2026 02:39:45 +0800
Subject: [PATCH 05/64] docs: add MorielHarush as a contributor for code (#856)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 4ba3ba4df..e8244fc7b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -784,6 +784,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "MorielHarush",
+      "name": "MorielHarush",
+      "avatar_url": "https://avatars.githubusercontent.com/u/93482738?v=4",
+      "profile": "https://github.com/MorielHarush",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index 3f9a2baef..a9394985d 100644
--- a/README.md
+++ b/README.md
@@ -217,6 +217,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
     </tr>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rongjiecomputer"><img src="https://avatars.githubusercontent.com/u/13115060?v=4?s=100" width="100px;" alt="Loo Rong Jie"/><br /><sub><b>Loo Rong Jie</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=rongjiecomputer" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/MorielHarush"><img src="https://avatars.githubusercontent.com/u/93482738?v=4?s=100" width="100px;" alt="MorielHarush"/><br /><sub><b>MorielHarush</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=MorielHarush" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From 524cd92cfec1f234a261082a2ee6d2ac3462d3ff Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 8 Mar 2026 02:40:16 +0800
Subject: [PATCH 06/64] docs: add peaktwilight as a contributor for code (#857)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index e8244fc7b..bafc21df8 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -793,6 +793,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "peaktwilight",
+      "name": "Peak Twilight",
+      "avatar_url": "https://avatars.githubusercontent.com/u/77903714?v=4",
+      "profile": "https://doruk.ch",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index a9394985d..238e70963 100644
--- a/README.md
+++ b/README.md
@@ -218,6 +218,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rongjiecomputer"><img src="https://avatars.githubusercontent.com/u/13115060?v=4?s=100" width="100px;" alt="Loo Rong Jie"/><br /><sub><b>Loo Rong Jie</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=rongjiecomputer" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/MorielHarush"><img src="https://avatars.githubusercontent.com/u/93482738?v=4?s=100" width="100px;" alt="MorielHarush"/><br /><sub><b>MorielHarush</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=MorielHarush" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://doruk.ch"><img src="https://avatars.githubusercontent.com/u/77903714?v=4?s=100" width="100px;" alt="Peak Twilight"/><br /><sub><b>Peak Twilight</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=peaktwilight" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From f1fc573a657e5d09d0f8264941f9ed59b812a25b Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 8 Mar 2026 03:14:13 +0800
Subject: [PATCH 07/64] docs: state differences regarding inspect array/hash,
 #852, #853 (#858)

---
 docs/source/tutorials/differences.md       | 2 ++
 docs/source/zh-cn/tutorials/differences.md | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/docs/source/tutorials/differences.md b/docs/source/tutorials/differences.md
index b8b5d0ab5..cb98c08e3 100644
--- a/docs/source/tutorials/differences.md
+++ b/docs/source/tutorials/differences.md
@@ -24,6 +24,7 @@ Though we're trying to be compatible with the Ruby version, there are still some
 
 * Truthy and Falsy. All values except `undefined`, `null`, `false` are truthy, whereas in Ruby Liquid all except `nil` and `false` are truthy. See [#26][#26].
 * Number. In JavaScript we cannot distinguish or convert between `float` and `integer`, see [#59][#59]. And when applied `size` filter, numbers always return 0, which is 8 for integer in ruby, cause they do not have a `length` property.
+* Stringify: We've aligned string coercion for primitive types. While some differences remain; for example, in Shopify/liquid, `strip` returns the "inspected" string of an input array, whereas in LiquidJS, the `strip` filter simply stringifies the input array [#852][#852].
 * [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) is replaced by `.toLiquid()`
 * [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) is replaced by JavaScript `.toString()`
 * Iteration order for objects. The iteration order of JavaScript objects, and thus LiquidJS objects, is a combination of the insertion order for string keys, and ascending order for number-like keys, while the iteration order of Ruby Hash is simply the insertion order.
@@ -47,6 +48,7 @@ Though we're trying to be compatible with the Ruby version, there are still some
 [#236]: https://github.com/harttle/liquidjs/issues/236
 [#414]: https://github.com/harttle/liquidjs/discussions/414
 [#485]: https://github.com/harttle/liquidjs/discussions/485
+[#852]: https://github.com/harttle/liquidjs/discussions/852
 [sort]: https://liquidjs.com/filters/sort.html
 [stable-sort]: https://v8.dev/features/stable-sort
 [plugins]: ./plugins.html#Plugin-List
diff --git a/docs/source/zh-cn/tutorials/differences.md b/docs/source/zh-cn/tutorials/differences.md
index f89b44278..9cdf3b22d 100644
--- a/docs/source/zh-cn/tutorials/differences.md
+++ b/docs/source/zh-cn/tutorials/differences.md
@@ -24,6 +24,7 @@ LiquidJS 一直很重视兼容于 Ruby 版本的 Liquid。Liquid 模板语言最
 
 * 真和假。在 LiquidJS 中 `undefined`, `null`, `false` 是假，之外的都是真；在 Ruby 中 `nil` 和 `false` 是假，其他都是真。见 [#26][#26]。
 * 数字。JavaScript 不区分浮点数和整数，因此缺失一部分整数算术，见 [#59][#59]。此外 `size` 过滤器作用于数字时总是返回零，而不是 Ruby 中的浮点数或整数的内存大小。
+* 输出字符串。基本类型的输出已经和 Shopify/liquid 对齐，但是仍然存在一些区别。比如在 Shopify/liquid 中 `strip` 会返回 inspect 字符串，但 LiquidJS `strip` 只是简单地把输入转换为字符串 [#852][#852]。
 * Drop 中的 [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) 替换为 `.toLiquid()`。
 * 数据的 [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) 替换为 `.toString()`。
 * 对象的迭代顺序。JavaScript 对象的迭代顺序是插入顺序和数字键递增顺序的组合，但 Ruby Hash 中只是插入顺序（JavaScript 字面量 Object 和 Ruby 字面量 Hash 的插入顺序解释也不同）。
@@ -46,6 +47,7 @@ LiquidJS 一直很重视兼容于 Ruby 版本的 Liquid。Liquid 模板语言最
 [#236]: https://github.com/harttle/liquidjs/issues/236
 [#414]: https://github.com/harttle/liquidjs/discussions/414
 [#485]: https://github.com/harttle/liquidjs/discussions/485
+[#852]: https://github.com/harttle/liquidjs/discussions/852
 [sort]: https://liquidjs.com/filters/sort.html
 [stable-sort]: https://v8.dev/features/stable-sort
 [plugins]: ./plugins.html#插件列表

From eb4683ee3ffbecc4d86108d2bc2c83fcb8d61c28 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 8 Mar 2026 03:35:49 +0800
Subject: [PATCH 08/64] chore: update to NPM Trusted Release (#860)

---
 .github/workflows/release.yml | 5 +++++
 package.json                  | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index dd202544f..42013f43a 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -4,6 +4,11 @@ jobs:
   release:
     name: Release
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      id-token: write # MANDATORY for Trusted Publishing
     steps:
       - name: Checkout
         uses: actions/checkout@v3
diff --git a/package.json b/package.json
index c7999ccca..ac31e6ea6 100644
--- a/package.json
+++ b/package.json
@@ -151,6 +151,9 @@
       ]
     ]
   },
+  "publishConfig": {
+    "provenance": true
+  },
   "nyc": {
     "extension": [
       ".ts"

From c7a291b46bbc51fad80c4c00d2463c189af1f0be Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 8 Mar 2026 04:00:26 +0800
Subject: [PATCH 09/64] chore: update semantic-release dependencies (#861)

---
 .github/workflows/release.yml |    2 +-
 package-lock.json             | 5217 +++++++++++++++++++++------------
 package.json                  |    4 +-
 3 files changed, 3320 insertions(+), 1903 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 42013f43a..931877818 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -8,7 +8,7 @@ jobs:
       contents: write
       issues: write
       pull-requests: write
-      id-token: write # MANDATORY for Trusted Publishing
+      id-token: write
     steps:
       - name: Checkout
         uses: actions/checkout@v3
diff --git a/package-lock.json b/package-lock.json
index 1a53dc88c..9d2fd8d94 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -21,7 +21,7 @@
         "@semantic-release/changelog": "^6.0.2",
         "@semantic-release/commit-analyzer": "^9.0.2",
         "@semantic-release/git": "^10.0.1",
-        "@semantic-release/npm": "^9.0.2",
+        "@semantic-release/npm": "^13.1.5",
         "@semantic-release/release-notes-generator": "^10.0.3",
         "@types/benchmark": "^1.0.31",
         "@types/express": "^4.17.2",
@@ -53,7 +53,7 @@
         "rollup-plugin-typescript2": "^0.31.1",
         "rollup-plugin-uglify": "^6.0.4",
         "rollup-plugin-version-injector": "^1.3.3",
-        "semantic-release": "^19.0.3",
+        "semantic-release": "^25.0.3",
         "sinon": "^15.0.2",
         "supertest": "^3.4.2",
         "ts-jest": "^29.0.5",
@@ -63,13 +63,52 @@
         "typescript": "^4.5.3"
       },
       "engines": {
-        "node": ">=14"
+        "node": ">=16"
       },
       "funding": {
         "type": "opencollective",
         "url": "https://opencollective.com/liquidjs"
       }
     },
+    "node_modules/@actions/core": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/@actions/core/-/core-3.0.0.tgz",
+      "integrity": "sha512-zYt6cz+ivnTmiT/ksRVriMBOiuoUpDCJJlZ5KPl2/FRdvwU3f7MPh9qftvbkXJThragzUZieit2nyHUyw53Seg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@actions/exec": "^3.0.0",
+        "@actions/http-client": "^4.0.0"
+      }
+    },
+    "node_modules/@actions/exec": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/@actions/exec/-/exec-3.0.0.tgz",
+      "integrity": "sha512-6xH/puSoNBXb72VPlZVm7vQ+svQpFyA96qdDBvhB8eNZOE8LtPf9L4oAsfzK/crCL8YZ+19fKYVnM63Sl+Xzlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@actions/io": "^3.0.2"
+      }
+    },
+    "node_modules/@actions/http-client": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@actions/http-client/-/http-client-4.0.0.tgz",
+      "integrity": "sha512-QuwPsgVMsD6qaPD57GLZi9sqzAZCtiJT8kVBCDpLtxhL5MydQ4gS+DrejtZZPdIYyB1e95uCK9Luyds7ybHI3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tunnel": "^0.0.6",
+        "undici": "^6.23.0"
+      }
+    },
+    "node_modules/@actions/io": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/@actions/io/-/io-3.0.2.tgz",
+      "integrity": "sha512-nRBchcMM+QK1pdjO7/idu86rbJI5YHUKCvKs0KxnSYbVe3F51UfGxuZX4Qy/fWlp6l7gWFwIkrOzN+oUK03kfw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@ampproject/remapping": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.2.0.tgz",
@@ -84,12 +123,15 @@
       }
     },
     "node_modules/@babel/code-frame": {
-      "version": "7.18.6",
-      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.18.6.tgz",
-      "integrity": "sha512-TDCmlK5eOvH+eH7cdAFlNXeVJqWIQ7gW9tY1GJIpUtFb6CmjVyq2VM3u71bOyR8CRihcCgMUYoDNyLXao3+70Q==",
+      "version": "7.29.0",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
+      "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@babel/highlight": "^7.18.6"
+        "@babel/helper-validator-identifier": "^7.28.5",
+        "js-tokens": "^4.0.0",
+        "picocolors": "^1.1.1"
       },
       "engines": {
         "node": ">=6.9.0"
@@ -341,10 +383,11 @@
       }
     },
     "node_modules/@babel/helper-validator-identifier": {
-      "version": "7.19.1",
-      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.19.1.tgz",
-      "integrity": "sha512-awrNfaMtnHUr653GgGEs++LlAvW6w+DcPrOliSMXWCKo597CwL5Acf/wWdNkf/tfEQE3mjkeD1YOVZOUV/od1w==",
+      "version": "7.28.5",
+      "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
+      "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
       "dev": true,
+      "license": "MIT",
       "engines": {
         "node": ">=6.9.0"
       }
@@ -718,6 +761,7 @@
       "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
       "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
       "dev": true,
+      "license": "MIT",
       "optional": true,
       "engines": {
         "node": ">=0.1.90"
@@ -1471,162 +1515,160 @@
       }
     },
     "node_modules/@octokit/auth-token": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@octokit/auth-token/-/auth-token-3.0.3.tgz",
-      "integrity": "sha512-/aFM2M4HVDBT/jjDBa84sJniv1t9Gm/rLkalaz9htOm+L+8JMj1k9w0CkUdcxNyNxZPlTxKPVko+m1VlM58ZVA==",
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/@octokit/auth-token/-/auth-token-6.0.0.tgz",
+      "integrity": "sha512-P4YJBPdPSpWTQ1NU4XYdvHvXJJDxM6YwpS0FZHRgP7YFkdVxsWcpWGy/NVqlAA7PcPCnMacXlRm1y2PFZRWL/w==",
       "dev": true,
-      "dependencies": {
-        "@octokit/types": "^9.0.0"
-      },
+      "license": "MIT",
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/core": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/@octokit/core/-/core-4.2.0.tgz",
-      "integrity": "sha512-AgvDRUg3COpR82P7PBdGZF/NNqGmtMq2NiPqeSsDIeCfYFOZ9gddqWNQHnFdEUf+YwOj4aZYmJnlPp7OXmDIDg==",
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/@octokit/core/-/core-7.0.6.tgz",
+      "integrity": "sha512-DhGl4xMVFGVIyMwswXeyzdL4uXD5OGILGX5N8Y+f6W7LhC1Ze2poSNrkF/fedpVDHEEZ+PHFW0vL14I+mm8K3Q==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/auth-token": "^3.0.0",
-        "@octokit/graphql": "^5.0.0",
-        "@octokit/request": "^6.0.0",
-        "@octokit/request-error": "^3.0.0",
-        "@octokit/types": "^9.0.0",
-        "before-after-hook": "^2.2.0",
-        "universal-user-agent": "^6.0.0"
+        "@octokit/auth-token": "^6.0.0",
+        "@octokit/graphql": "^9.0.3",
+        "@octokit/request": "^10.0.6",
+        "@octokit/request-error": "^7.0.2",
+        "@octokit/types": "^16.0.0",
+        "before-after-hook": "^4.0.0",
+        "universal-user-agent": "^7.0.0"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/endpoint": {
-      "version": "7.0.5",
-      "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-7.0.5.tgz",
-      "integrity": "sha512-LG4o4HMY1Xoaec87IqQ41TQ+glvIeTKqfjkCEmt5AIwDZJwQeVZFIEYXrYY6yLwK+pAScb9Gj4q+Nz2qSw1roA==",
+      "version": "11.0.3",
+      "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-11.0.3.tgz",
+      "integrity": "sha512-FWFlNxghg4HrXkD3ifYbS/IdL/mDHjh9QcsNyhQjN8dplUoZbejsdpmuqdA76nxj2xoWPs7p8uX2SNr9rYu0Ag==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/types": "^9.0.0",
-        "is-plain-object": "^5.0.0",
-        "universal-user-agent": "^6.0.0"
+        "@octokit/types": "^16.0.0",
+        "universal-user-agent": "^7.0.2"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/graphql": {
-      "version": "5.0.5",
-      "resolved": "https://registry.npmjs.org/@octokit/graphql/-/graphql-5.0.5.tgz",
-      "integrity": "sha512-Qwfvh3xdqKtIznjX9lz2D458r7dJPP8l6r4GQkIdWQouZwHQK0mVT88uwiU2bdTU2OtT1uOlKpRciUWldpG0yQ==",
+      "version": "9.0.3",
+      "resolved": "https://registry.npmjs.org/@octokit/graphql/-/graphql-9.0.3.tgz",
+      "integrity": "sha512-grAEuupr/C1rALFnXTv6ZQhFuL1D8G5y8CN04RgrO4FIPMrtm+mcZzFG7dcBm+nq+1ppNixu+Jd78aeJOYxlGA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/request": "^6.0.0",
-        "@octokit/types": "^9.0.0",
-        "universal-user-agent": "^6.0.0"
+        "@octokit/request": "^10.0.6",
+        "@octokit/types": "^16.0.0",
+        "universal-user-agent": "^7.0.0"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/openapi-types": {
-      "version": "16.0.0",
-      "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-16.0.0.tgz",
-      "integrity": "sha512-JbFWOqTJVLHZSUUoF4FzAZKYtqdxWu9Z5m2QQnOyEa04fOFljvyh7D3GYKbfuaSWisqehImiVIMG4eyJeP5VEA==",
-      "dev": true
+      "version": "27.0.0",
+      "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-27.0.0.tgz",
+      "integrity": "sha512-whrdktVs1h6gtR+09+QsNk2+FO+49j6ga1c55YZudfEG+oKJVvJLQi3zkOm5JjiUXAagWK2tI2kTGKJ2Ys7MGA==",
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/@octokit/plugin-paginate-rest": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/@octokit/plugin-paginate-rest/-/plugin-paginate-rest-6.0.0.tgz",
-      "integrity": "sha512-Sq5VU1PfT6/JyuXPyt04KZNVsFOSBaYOAq2QRZUwzVlI10KFvcbUo8lR258AAQL1Et60b0WuVik+zOWKLuDZxw==",
+      "version": "14.0.0",
+      "resolved": "https://registry.npmjs.org/@octokit/plugin-paginate-rest/-/plugin-paginate-rest-14.0.0.tgz",
+      "integrity": "sha512-fNVRE7ufJiAA3XUrha2omTA39M6IXIc6GIZLvlbsm8QOQCYvpq/LkMNGyFlB1d8hTDzsAXa3OKtybdMAYsV/fw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/types": "^9.0.0"
+        "@octokit/types": "^16.0.0"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       },
       "peerDependencies": {
-        "@octokit/core": ">=4"
+        "@octokit/core": ">=6"
       }
     },
-    "node_modules/@octokit/plugin-request-log": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/@octokit/plugin-request-log/-/plugin-request-log-1.0.4.tgz",
-      "integrity": "sha512-mLUsMkgP7K/cnFEw07kWqXGF5LKrOkD+lhCrKvPHXWDywAwuDUeDwWBpc69XK3pNX0uKiVt8g5z96PJ6z9xCFA==",
-      "dev": true,
-      "peerDependencies": {
-        "@octokit/core": ">=3"
-      }
-    },
-    "node_modules/@octokit/plugin-rest-endpoint-methods": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/@octokit/plugin-rest-endpoint-methods/-/plugin-rest-endpoint-methods-7.0.1.tgz",
-      "integrity": "sha512-pnCaLwZBudK5xCdrR823xHGNgqOzRnJ/mpC/76YPpNP7DybdsJtP7mdOwh+wYZxK5jqeQuhu59ogMI4NRlBUvA==",
+    "node_modules/@octokit/plugin-retry": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/@octokit/plugin-retry/-/plugin-retry-8.1.0.tgz",
+      "integrity": "sha512-O1FZgXeiGb2sowEr/hYTr6YunGdSAFWnr2fyW39Ah85H8O33ELASQxcvOFF5LE6Tjekcyu2ms4qAzJVhSaJxTw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/types": "^9.0.0",
-        "deprecation": "^2.3.1"
+        "@octokit/request-error": "^7.0.2",
+        "@octokit/types": "^16.0.0",
+        "bottleneck": "^2.15.3"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       },
       "peerDependencies": {
-        "@octokit/core": ">=3"
+        "@octokit/core": ">=7"
+      }
+    },
+    "node_modules/@octokit/plugin-throttling": {
+      "version": "11.0.3",
+      "resolved": "https://registry.npmjs.org/@octokit/plugin-throttling/-/plugin-throttling-11.0.3.tgz",
+      "integrity": "sha512-34eE0RkFCKycLl2D2kq7W+LovheM/ex3AwZCYN8udpi6bxsyjZidb2McXs69hZhLmJlDqTSP8cH+jSRpiaijBg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@octokit/types": "^16.0.0",
+        "bottleneck": "^2.15.3"
+      },
+      "engines": {
+        "node": ">= 20"
+      },
+      "peerDependencies": {
+        "@octokit/core": "^7.0.0"
       }
     },
     "node_modules/@octokit/request": {
-      "version": "6.2.3",
-      "resolved": "https://registry.npmjs.org/@octokit/request/-/request-6.2.3.tgz",
-      "integrity": "sha512-TNAodj5yNzrrZ/VxP+H5HiYaZep0H3GU0O7PaF+fhDrt8FPrnkei9Aal/txsN/1P7V3CPiThG0tIvpPDYUsyAA==",
+      "version": "10.0.8",
+      "resolved": "https://registry.npmjs.org/@octokit/request/-/request-10.0.8.tgz",
+      "integrity": "sha512-SJZNwY9pur9Agf7l87ywFi14W+Hd9Jg6Ifivsd33+/bGUQIjNujdFiXII2/qSlN2ybqUHfp5xpekMEjIBTjlSw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/endpoint": "^7.0.0",
-        "@octokit/request-error": "^3.0.0",
-        "@octokit/types": "^9.0.0",
-        "is-plain-object": "^5.0.0",
-        "node-fetch": "^2.6.7",
-        "universal-user-agent": "^6.0.0"
+        "@octokit/endpoint": "^11.0.3",
+        "@octokit/request-error": "^7.0.2",
+        "@octokit/types": "^16.0.0",
+        "fast-content-type-parse": "^3.0.0",
+        "json-with-bigint": "^3.5.3",
+        "universal-user-agent": "^7.0.2"
       },
       "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/request-error": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@octokit/request-error/-/request-error-3.0.3.tgz",
-      "integrity": "sha512-crqw3V5Iy2uOU5Np+8M/YexTlT8zxCfI+qu+LxUB7SZpje4Qmx3mub5DfEKSO8Ylyk0aogi6TYdf6kxzh2BguQ==",
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/@octokit/request-error/-/request-error-7.1.0.tgz",
+      "integrity": "sha512-KMQIfq5sOPpkQYajXHwnhjCC0slzCNScLHs9JafXc4RAJI+9f+jNDlBNaIMTvazOPLgb4BnlhGJOTbnN0wIjPw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/types": "^9.0.0",
-        "deprecation": "^2.0.0",
-        "once": "^1.4.0"
+        "@octokit/types": "^16.0.0"
       },
       "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/@octokit/rest": {
-      "version": "19.0.7",
-      "resolved": "https://registry.npmjs.org/@octokit/rest/-/rest-19.0.7.tgz",
-      "integrity": "sha512-HRtSfjrWmWVNp2uAkEpQnuGMJsu/+dBr47dRc5QVgsCbnIc1+GFEaoKBWkYG+zjrsHpSqcAElMio+n10c0b5JA==",
-      "dev": true,
-      "dependencies": {
-        "@octokit/core": "^4.1.0",
-        "@octokit/plugin-paginate-rest": "^6.0.0",
-        "@octokit/plugin-request-log": "^1.0.4",
-        "@octokit/plugin-rest-endpoint-methods": "^7.0.0"
-      },
-      "engines": {
-        "node": ">= 14"
+        "node": ">= 20"
       }
     },
     "node_modules/@octokit/types": {
-      "version": "9.0.0",
-      "resolved": "https://registry.npmjs.org/@octokit/types/-/types-9.0.0.tgz",
-      "integrity": "sha512-LUewfj94xCMH2rbD5YJ+6AQ4AVjFYTgpp6rboWM5T7N3IsIF65SBEOVcYMGAEzO/kKNiNaW4LoWtoThOhH06gw==",
+      "version": "16.0.0",
+      "resolved": "https://registry.npmjs.org/@octokit/types/-/types-16.0.0.tgz",
+      "integrity": "sha512-sKq+9r1Mm4efXW1FCk7hFSeJo4QKreL/tTbR0rz/qx/r1Oa2VV83LTA/H/MuCOX7uCIJmQVRKBcbmWoySjAnSg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/openapi-types": "^16.0.0"
+        "@octokit/openapi-types": "^27.0.0"
       }
     },
     "node_modules/@pnpm/config.env-replace": {
@@ -1689,6 +1731,13 @@
       "integrity": "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w==",
       "dev": true
     },
+    "node_modules/@sec-ant/readable-stream": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@sec-ant/readable-stream/-/readable-stream-0.4.1.tgz",
+      "integrity": "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@semantic-release/changelog": {
       "version": "6.0.2",
       "resolved": "https://registry.npmjs.org/@semantic-release/changelog/-/changelog-6.0.2.tgz",
@@ -1774,109 +1823,297 @@
       }
     },
     "node_modules/@semantic-release/github": {
-      "version": "8.0.7",
-      "resolved": "https://registry.npmjs.org/@semantic-release/github/-/github-8.0.7.tgz",
-      "integrity": "sha512-VtgicRIKGvmTHwm//iqTh/5NGQwsncOMR5vQK9pMT92Aem7dv37JFKKRuulUsAnUOIlO4G8wH3gPiBAA0iW0ww==",
+      "version": "12.0.6",
+      "resolved": "https://registry.npmjs.org/@semantic-release/github/-/github-12.0.6.tgz",
+      "integrity": "sha512-aYYFkwHW3c6YtHwQF0t0+lAjlU+87NFOZuH2CvWFD0Ylivc7MwhZMiHOJ0FMpIgPpCVib/VUAcOwvrW0KnxQtA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@octokit/rest": "^19.0.0",
-        "@semantic-release/error": "^3.0.0",
-        "aggregate-error": "^3.0.0",
-        "bottleneck": "^2.18.1",
-        "debug": "^4.0.0",
-        "dir-glob": "^3.0.0",
-        "fs-extra": "^11.0.0",
-        "globby": "^11.0.0",
-        "http-proxy-agent": "^5.0.0",
-        "https-proxy-agent": "^5.0.0",
-        "issue-parser": "^6.0.0",
-        "lodash": "^4.17.4",
-        "mime": "^3.0.0",
-        "p-filter": "^2.0.0",
-        "p-retry": "^4.0.0",
-        "url-join": "^4.0.0"
+        "@octokit/core": "^7.0.0",
+        "@octokit/plugin-paginate-rest": "^14.0.0",
+        "@octokit/plugin-retry": "^8.0.0",
+        "@octokit/plugin-throttling": "^11.0.0",
+        "@semantic-release/error": "^4.0.0",
+        "aggregate-error": "^5.0.0",
+        "debug": "^4.3.4",
+        "dir-glob": "^3.0.1",
+        "http-proxy-agent": "^7.0.0",
+        "https-proxy-agent": "^7.0.0",
+        "issue-parser": "^7.0.0",
+        "lodash-es": "^4.17.21",
+        "mime": "^4.0.0",
+        "p-filter": "^4.0.0",
+        "tinyglobby": "^0.2.14",
+        "undici": "^7.0.0",
+        "url-join": "^5.0.0"
       },
       "engines": {
-        "node": ">=14.17"
+        "node": "^22.14.0 || >= 24.10.0"
       },
       "peerDependencies": {
-        "semantic-release": ">=18.0.0-beta.1"
+        "semantic-release": ">=24.1.0"
       }
     },
-    "node_modules/@semantic-release/github/node_modules/@tootallnate/once": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/@tootallnate/once/-/once-2.0.0.tgz",
-      "integrity": "sha512-XCuKFP5PS55gnMVu3dty8KPatLqUoy/ZYzDzAGCQ8JNFCkLXzmI7vNHCR+XpbZaMWQK/vQubr7PkYq8g470J/A==",
+    "node_modules/@semantic-release/github/node_modules/@semantic-release/error": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@semantic-release/error/-/error-4.0.0.tgz",
+      "integrity": "sha512-mgdxrHTLOjOddRVYIYDo0fR3/v61GNN1YGkfbrjuIKg/uMgCd+Qzo3UAXJ+woLQQpos4pl5Esuw5A7AoNlzjUQ==",
       "dev": true,
+      "license": "MIT",
       "engines": {
-        "node": ">= 10"
+        "node": ">=18"
       }
     },
-    "node_modules/@semantic-release/github/node_modules/fs-extra": {
-      "version": "11.1.0",
-      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.1.0.tgz",
-      "integrity": "sha512-0rcTq621PD5jM/e0a3EJoGC/1TC5ZBCERW82LQuwfGnCa1V8w7dpYH1yNu+SLb6E5dkeCBzKEyLGlFrnr+dUyw==",
+    "node_modules/@semantic-release/github/node_modules/agent-base": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
       "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/aggregate-error": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-5.0.0.tgz",
+      "integrity": "sha512-gOsf2YwSlleG6IjRYG2A7k0HmBMEo6qVNk9Bp/EaLgAJT5ngH6PXbqa4ItvnEwCm/velL5jAnQgsHsWnjhGmvw==",
+      "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "graceful-fs": "^4.2.0",
-        "jsonfile": "^6.0.1",
-        "universalify": "^2.0.0"
+        "clean-stack": "^5.2.0",
+        "indent-string": "^5.0.0"
       },
       "engines": {
-        "node": ">=14.14"
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/clean-stack": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-5.3.0.tgz",
+      "integrity": "sha512-9ngPTOhYGQqNVSfeJkYXHmF7AGWp4/nN5D/QqNQs3Dvxd1Kk/WpjHfNujKHYUQ/5CoGyOyFNoWSPk5afzP0QVg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "escape-string-regexp": "5.0.0"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/escape-string-regexp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+      "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/@semantic-release/github/node_modules/http-proxy-agent": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-5.0.0.tgz",
-      "integrity": "sha512-n2hY8YdoRE1i7r6M0w9DIw5GgZN0G25P8zLCRQ8rjXtTU3vsNFBI/vWK/UIeE6g5MUUz6avwAPXmL6Fy9D/90w==",
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+      "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@tootallnate/once": "2",
-        "agent-base": "6",
+        "agent-base": "^7.1.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/https-proxy-agent": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.2",
         "debug": "4"
       },
       "engines": {
-        "node": ">= 6"
+        "node": ">= 14"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/indent-string": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz",
+      "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/@semantic-release/github/node_modules/mime": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/mime/-/mime-3.0.0.tgz",
-      "integrity": "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==",
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-4.1.0.tgz",
+      "integrity": "sha512-X5ju04+cAzsojXKes0B/S4tcYtFAJ6tTMuSPBEn9CPGlrWr8Fiw7qYeLT0XyH80HSoAoqWCaz+MWKh22P7G1cw==",
       "dev": true,
+      "funding": [
+        "https://github.com/sponsors/broofa"
+      ],
+      "license": "MIT",
       "bin": {
-        "mime": "cli.js"
+        "mime": "bin/cli.js"
       },
       "engines": {
-        "node": ">=10.0.0"
+        "node": ">=16"
+      }
+    },
+    "node_modules/@semantic-release/github/node_modules/undici": {
+      "version": "7.22.0",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-7.22.0.tgz",
+      "integrity": "sha512-RqslV2Us5BrllB+JeiZnK4peryVTndy9Dnqq62S3yYRRTj0tFQCwEniUy2167skdGOy3vqRzEvl1Dm4sV2ReDg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.18.1"
       }
     },
     "node_modules/@semantic-release/npm": {
-      "version": "9.0.2",
-      "resolved": "https://registry.npmjs.org/@semantic-release/npm/-/npm-9.0.2.tgz",
-      "integrity": "sha512-zgsynF6McdzxPnFet+a4iO9HpAlARXOM5adz7VGVCvj0ne8wtL2ZOQoDV2wZPDmdEotDIbVeJjafhelZjs9j6g==",
+      "version": "13.1.5",
+      "resolved": "https://registry.npmjs.org/@semantic-release/npm/-/npm-13.1.5.tgz",
+      "integrity": "sha512-Hq5UxzoatN3LHiq2rTsWS54nCdqJHlsssGERCo8WlvdfFA9LoN0vO+OuKVSjtNapIc/S8C2LBj206wKLHg62mg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@semantic-release/error": "^3.0.0",
-        "aggregate-error": "^3.0.0",
-        "execa": "^5.0.0",
+        "@actions/core": "^3.0.0",
+        "@semantic-release/error": "^4.0.0",
+        "aggregate-error": "^5.0.0",
+        "env-ci": "^11.2.0",
+        "execa": "^9.0.0",
         "fs-extra": "^11.0.0",
-        "lodash": "^4.17.15",
+        "lodash-es": "^4.17.21",
         "nerf-dart": "^1.0.0",
-        "normalize-url": "^6.0.0",
-        "npm": "^8.3.0",
+        "normalize-url": "^9.0.0",
+        "npm": "^11.6.2",
         "rc": "^1.2.8",
-        "read-pkg": "^5.0.0",
+        "read-pkg": "^10.0.0",
         "registry-auth-token": "^5.0.0",
         "semver": "^7.1.2",
-        "tempy": "^1.0.0"
+        "tempy": "^3.0.0"
       },
       "engines": {
-        "node": ">=16 || ^14.17"
+        "node": "^22.14.0 || >= 24.10.0"
       },
       "peerDependencies": {
-        "semantic-release": ">=19.0.0"
+        "semantic-release": ">=20.1.0"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/@semantic-release/error": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@semantic-release/error/-/error-4.0.0.tgz",
+      "integrity": "sha512-mgdxrHTLOjOddRVYIYDo0fR3/v61GNN1YGkfbrjuIKg/uMgCd+Qzo3UAXJ+woLQQpos4pl5Esuw5A7AoNlzjUQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/aggregate-error": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-5.0.0.tgz",
+      "integrity": "sha512-gOsf2YwSlleG6IjRYG2A7k0HmBMEo6qVNk9Bp/EaLgAJT5ngH6PXbqa4ItvnEwCm/velL5jAnQgsHsWnjhGmvw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "clean-stack": "^5.2.0",
+        "indent-string": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/clean-stack": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-5.3.0.tgz",
+      "integrity": "sha512-9ngPTOhYGQqNVSfeJkYXHmF7AGWp4/nN5D/QqNQs3Dvxd1Kk/WpjHfNujKHYUQ/5CoGyOyFNoWSPk5afzP0QVg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "escape-string-regexp": "5.0.0"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/escape-string-regexp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+      "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/execa": {
+      "version": "9.6.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-9.6.1.tgz",
+      "integrity": "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/merge-streams": "^4.0.0",
+        "cross-spawn": "^7.0.6",
+        "figures": "^6.1.0",
+        "get-stream": "^9.0.0",
+        "human-signals": "^8.0.1",
+        "is-plain-obj": "^4.1.0",
+        "is-stream": "^4.0.1",
+        "npm-run-path": "^6.0.0",
+        "pretty-ms": "^9.2.0",
+        "signal-exit": "^4.1.0",
+        "strip-final-newline": "^4.0.0",
+        "yoctocolors": "^2.1.1"
+      },
+      "engines": {
+        "node": "^18.19.0 || >=20.5.0"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/figures": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/figures/-/figures-6.1.0.tgz",
+      "integrity": "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-unicode-supported": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/@semantic-release/npm/node_modules/fs-extra": {
@@ -1893,6 +2130,246 @@
         "node": ">=14.14"
       }
     },
+    "node_modules/@semantic-release/npm/node_modules/get-stream": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-9.0.1.tgz",
+      "integrity": "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sec-ant/readable-stream": "^0.4.1",
+        "is-stream": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/hosted-git-info": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.2.tgz",
+      "integrity": "sha512-M422h7o/BR3rmCQ8UHi7cyyMqKltdP9Uo+J2fXK+RSAY+wTcKOIRyhTuKv4qn+DJf3g+PL890AzId5KZpX+CBg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^11.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/human-signals": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-8.0.1.tgz",
+      "integrity": "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/indent-string": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz",
+      "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/is-plain-obj": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",
+      "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/is-stream": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-4.0.1.tgz",
+      "integrity": "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/lru-cache": {
+      "version": "11.2.6",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.6.tgz",
+      "integrity": "sha512-ESL2CrkS/2wTPfuend7Zhkzo2u0daGJ/A2VucJOgQ/C48S/zB8MMeMHSGKYpXhIjbPxfuezITkaBH1wqv00DDQ==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/normalize-package-data": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-8.0.0.tgz",
+      "integrity": "sha512-RWk+PI433eESQ7ounYxIp67CYuVsS1uYSonX3kA6ps/3LWfjVQa/ptEg6Y3T6uAMq1mWpX9PQ+qx+QaHpsc7gQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "hosted-git-info": "^9.0.0",
+        "semver": "^7.3.5",
+        "validate-npm-package-license": "^3.0.4"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/npm-run-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-6.0.0.tgz",
+      "integrity": "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0",
+        "unicorn-magic": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/parse-json": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-8.3.0.tgz",
+      "integrity": "sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.26.2",
+        "index-to-position": "^1.1.0",
+        "type-fest": "^4.39.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/parse-json/node_modules/type-fest": {
+      "version": "4.41.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
+      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/read-pkg": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-10.1.0.tgz",
+      "integrity": "sha512-I8g2lArQiP78ll51UeMZojewtYgIRCKCWqZEgOO8c/uefTI+XDXvCSXu3+YNUaTNvZzobrL5+SqHjBrByRRTdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/normalize-package-data": "^2.4.4",
+        "normalize-package-data": "^8.0.0",
+        "parse-json": "^8.3.0",
+        "type-fest": "^5.4.4",
+        "unicorn-magic": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/read-pkg/node_modules/unicorn-magic": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.0.tgz",
+      "integrity": "sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/strip-final-newline": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-4.0.0.tgz",
+      "integrity": "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@semantic-release/npm/node_modules/type-fest": {
+      "version": "5.4.4",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.4.4.tgz",
+      "integrity": "sha512-JnTrzGu+zPV3aXIUhnyWJj4z/wigMsdYajGLIYakqyOW1nPllzXEJee0QQbHj+CTIQtXGlAjuK0UY+2xTyjVAw==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "dependencies": {
+        "tagged-tag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/@semantic-release/release-notes-generator": {
       "version": "10.0.3",
       "resolved": "https://registry.npmjs.org/@semantic-release/release-notes-generator/-/release-notes-generator-10.0.3.tgz",
@@ -1926,12 +2403,51 @@
         "@types/hast": "^3.0.4"
       }
     },
+    "node_modules/@simple-libs/stream-utils": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@simple-libs/stream-utils/-/stream-utils-1.2.0.tgz",
+      "integrity": "sha512-KxXvfapcixpz6rVEB6HPjOUZT22yN6v0vI0urQSk1L8MlEWPDFCZkhw2xmkyoTGYeFw7tWTZd7e3lVzRZRN/EA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://ko-fi.com/dangreen"
+      }
+    },
     "node_modules/@sinclair/typebox": {
       "version": "0.25.24",
       "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.25.24.tgz",
       "integrity": "sha512-XJfwUVUKDHF5ugKwIcxEgc9k8b7HbznCp6eUfWgu710hMPNIO4aw4/zB5RogDQz8nd6gyCDpU9O/m6qYEWY6yQ==",
       "dev": true
     },
+    "node_modules/@sindresorhus/is": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-4.6.0.tgz",
+      "integrity": "sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/is?sponsor=1"
+      }
+    },
+    "node_modules/@sindresorhus/merge-streams": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-4.0.0.tgz",
+      "integrity": "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/@sinonjs/commons": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-2.0.0.tgz",
@@ -2174,10 +2690,11 @@
       }
     },
     "node_modules/@types/normalize-package-data": {
-      "version": "2.4.1",
-      "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.1.tgz",
-      "integrity": "sha512-Gj7cI7z+98M282Tqmp2K5EIsoouUEzbBJhQQzDE3jSIRk6r9gsz0oUokqIUR4u1R3dMHo0pDHM7sNOHyhulypw==",
-      "dev": true
+      "version": "2.4.4",
+      "resolved": "https://registry.npmjs.org/@types/normalize-package-data/-/normalize-package-data-2.4.4.tgz",
+      "integrity": "sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==",
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/@types/parse-json": {
       "version": "4.0.0",
@@ -2203,12 +2720,6 @@
       "integrity": "sha512-EEhsLsD6UsDM1yFhAvy0Cjr6VwmpMWqFBCb9w07wVugF7w9nfajxLuVmngTIpgS6svCnm6Vaw+MZhoDCKnOfsw==",
       "dev": true
     },
-    "node_modules/@types/retry": {
-      "version": "0.12.0",
-      "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",
-      "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",
-      "dev": true
-    },
     "node_modules/@types/semver": {
       "version": "7.3.13",
       "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.3.13.tgz",
@@ -2806,11 +3317,12 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
-    "node_modules/ansicolors": {
-      "version": "0.3.2",
-      "resolved": "https://registry.npmjs.org/ansicolors/-/ansicolors-0.3.2.tgz",
-      "integrity": "sha512-QXu7BPrP29VllRxH8GwB7x5iX5qWKAAMLqKQGWTeLWVlNHNOpVMJ91dsxQAIWXpjuW5wqvxu3Jd/nRjrJ+0pqg==",
-      "dev": true
+    "node_modules/any-promise": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
+      "integrity": "sha512-7UvmKalWRt1wgjL1RrGxoSJW/0QZFIegpeGvZG9kjp8vrRu55XTHbwnqq2GpXm9uLbcuhxm3IqX9OB4MZR1b2A==",
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/anymatch": {
       "version": "3.1.3",
@@ -3120,10 +3632,11 @@
       }
     },
     "node_modules/before-after-hook": {
-      "version": "2.2.3",
-      "resolved": "https://registry.npmjs.org/before-after-hook/-/before-after-hook-2.2.3.tgz",
-      "integrity": "sha512-NzUnlZexiaH/46WDhANlyR2bXRopNg4F/zuSA3OpZnllCUgRaOF2znDioDWrmbNVsuZk6l9pMquQB38cfBZwkQ==",
-      "dev": true
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/before-after-hook/-/before-after-hook-4.0.0.tgz",
+      "integrity": "sha512-q6tR3RPqIB1pMiTRMFcZwuG5T8vwp+vUvEG0vuI6B+Rikh5BfPp2fQ82c925FOs+b0lcFQ8CFrL+KbilfZFhOQ==",
+      "dev": true,
+      "license": "Apache-2.0"
     },
     "node_modules/benchmark": {
       "version": "2.1.4",
@@ -3193,7 +3706,8 @@
       "version": "2.19.5",
       "resolved": "https://registry.npmjs.org/bottleneck/-/bottleneck-2.19.5.tgz",
       "integrity": "sha512-VHiNCbI1lKdl44tGrhNfU3lup0Tj/ZBMJB5/2ZbNXRCPuRCO7ed2mgcK4r17y+KB2EfuYuRaVlwNbAeaWGSpbw==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/brace-expansion": {
       "version": "1.1.11",
@@ -3351,19 +3865,6 @@
         }
       ]
     },
-    "node_modules/cardinal": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/cardinal/-/cardinal-2.1.1.tgz",
-      "integrity": "sha512-JSr5eOgoEymtYHBjNWyjrMqet9Am2miJhlfKNdqLp6zoeAh0KN5dRAcxlecj5mAJrmQomgiOBj35xHLrFjqBpw==",
-      "dev": true,
-      "dependencies": {
-        "ansicolors": "~0.3.2",
-        "redeyed": "~2.1.0"
-      },
-      "bin": {
-        "cdl": "bin/cdl.js"
-      }
-    },
     "node_modules/caseless": {
       "version": "0.12.0",
       "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz",
@@ -3443,11 +3944,41 @@
         "node": ">=8"
       }
     },
-    "node_modules/cli-table3": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.3.tgz",
-      "integrity": "sha512-w5Jac5SykAeZJKntOxJCrm63Eg5/4dhMWIcuTbo9rpE+brgaSZo0RuNJZeOyMgsUdhDeojvgyQLmjI+K50ZGyg==",
+    "node_modules/cli-highlight": {
+      "version": "2.1.11",
+      "resolved": "https://registry.npmjs.org/cli-highlight/-/cli-highlight-2.1.11.tgz",
+      "integrity": "sha512-9KDcoEVwyUXrjcJNvHD0NFc/hiwe/WPVYIleQh2O1N2Zro5gWJZ/K+3DGn8w8P/F6FxOgzyC5bxDyHIgCSPhGg==",
       "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "chalk": "^4.0.0",
+        "highlight.js": "^10.7.1",
+        "mz": "^2.4.0",
+        "parse5": "^5.1.1",
+        "parse5-htmlparser2-tree-adapter": "^6.0.0",
+        "yargs": "^16.0.0"
+      },
+      "bin": {
+        "highlight": "bin/highlight"
+      },
+      "engines": {
+        "node": ">=8.0.0",
+        "npm": ">=5.0.0"
+      }
+    },
+    "node_modules/cli-highlight/node_modules/parse5": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/parse5/-/parse5-5.1.1.tgz",
+      "integrity": "sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/cli-table3": {
+      "version": "0.6.5",
+      "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz",
+      "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==",
+      "dev": true,
+      "license": "MIT",
       "dependencies": {
         "string-width": "^4.2.0"
       },
@@ -3720,6 +4251,19 @@
         "node": ">=10"
       }
     },
+    "node_modules/convert-hrtime": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/convert-hrtime/-/convert-hrtime-5.0.0.tgz",
+      "integrity": "sha512-lOETlkIeYSJWcbbcvjRKGxVMXJR+8+OQb/mTPbA4ObPMytYIsUbuOE0Jzy60hjARYszq1id0j8KgVhC+WGZVTg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/convert-source-map": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
@@ -3872,10 +4416,11 @@
       }
     },
     "node_modules/cross-spawn": {
-      "version": "7.0.3",
-      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",
-      "integrity": "sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w==",
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "path-key": "^3.1.0",
         "shebang-command": "^2.0.0",
@@ -3886,12 +4431,32 @@
       }
     },
     "node_modules/crypto-random-string": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-2.0.0.tgz",
-      "integrity": "sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA==",
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/crypto-random-string/-/crypto-random-string-4.0.0.tgz",
+      "integrity": "sha512-x8dy3RnvYdlUcPOjkEHqozhiwzKNSq7GcPuXFbnyMOCHxX8V3OgIg/pYuabl2sbUPfIJaeAQB7PMOK8DFIdoRA==",
       "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^1.0.1"
+      },
       "engines": {
-        "node": ">=8"
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/crypto-random-string/node_modules/type-fest": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-1.4.0.tgz",
+      "integrity": "sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/cssom": {
@@ -4100,28 +4665,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/del": {
-      "version": "6.1.1",
-      "resolved": "https://registry.npmjs.org/del/-/del-6.1.1.tgz",
-      "integrity": "sha512-ua8BhapfP0JUJKC/zV9yHHDW/rDoDxP4Zhn3AkA6/xT6gY7jYXJiaeyBZznYVujhZZET+UgcbZiQ7sN3WqcImg==",
-      "dev": true,
-      "dependencies": {
-        "globby": "^11.0.1",
-        "graceful-fs": "^4.2.4",
-        "is-glob": "^4.0.1",
-        "is-path-cwd": "^2.2.0",
-        "is-path-inside": "^3.0.2",
-        "p-map": "^4.0.0",
-        "rimraf": "^3.0.2",
-        "slash": "^3.0.0"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/delayed-stream": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
@@ -4140,12 +4683,6 @@
         "node": ">= 0.8"
       }
     },
-    "node_modules/deprecation": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/deprecation/-/deprecation-2.3.1.tgz",
-      "integrity": "sha512-xmHIy4F3scKVwMsQ4WnVaS8bHOx0DmVwRywosKhaILI0ywMDWPtBSku2HNxRvF7jtwDRsoEwYQSfbxj8b7RlJQ==",
-      "dev": true
-    },
     "node_modules/destroy": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
@@ -4326,6 +4863,13 @@
       "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
       "dev": true
     },
+    "node_modules/emojilib": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/emojilib/-/emojilib-2.4.0.tgz",
+      "integrity": "sha512-5U0rVMU5Y2n2+ykNLQqMoqklN9ICBT/KsvC1Gz6vqHbz2AXXGkG+Pm5rMWk/8Vjrr/mY9985Hi8DYzn1F09Nyw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/encodeurl": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-1.0.2.tgz",
@@ -4360,17 +4904,184 @@
       }
     },
     "node_modules/env-ci": {
-      "version": "5.5.0",
-      "resolved": "https://registry.npmjs.org/env-ci/-/env-ci-5.5.0.tgz",
-      "integrity": "sha512-o0JdWIbOLP+WJKIUt36hz1ImQQFuN92nhsfTkHHap+J8CiI8WgGpH/a9jEGHh4/TU5BUUGjlnKXNoDb57+ne+A==",
+      "version": "11.2.0",
+      "resolved": "https://registry.npmjs.org/env-ci/-/env-ci-11.2.0.tgz",
+      "integrity": "sha512-D5kWfzkmaOQDioPmiviWAVtKmpPT4/iJmMVQxWxMPJTFyTkdc5JQUfc5iXEeWxcOdsYTKSAiA/Age4NUOqKsRA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "execa": "^5.0.0",
-        "fromentries": "^1.3.2",
-        "java-properties": "^1.0.0"
+        "execa": "^8.0.0",
+        "java-properties": "^1.0.2"
       },
       "engines": {
-        "node": ">=10.17"
+        "node": "^18.17 || >=20.6.1"
+      }
+    },
+    "node_modules/env-ci/node_modules/execa": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-8.0.1.tgz",
+      "integrity": "sha512-VyhnebXciFV2DESc+p6B+y0LjSm0krU4OgJN44qFAhBY0TJ+1V61tYD2+wHusZ6F9n5K+vl8k0sTy7PEfV4qpg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cross-spawn": "^7.0.3",
+        "get-stream": "^8.0.1",
+        "human-signals": "^5.0.0",
+        "is-stream": "^3.0.0",
+        "merge-stream": "^2.0.0",
+        "npm-run-path": "^5.1.0",
+        "onetime": "^6.0.0",
+        "signal-exit": "^4.1.0",
+        "strip-final-newline": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=16.17"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/env-ci/node_modules/get-stream": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-8.0.1.tgz",
+      "integrity": "sha512-VaUJspBffn/LMCJVoMvSAdmscJyS1auj5Zulnn5UoYcY531UWmdwhRWkcGKnGU93m5HSXP9LP2usOryrBtQowA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/human-signals": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-5.0.0.tgz",
+      "integrity": "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=16.17.0"
+      }
+    },
+    "node_modules/env-ci/node_modules/is-stream": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
+      "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/mimic-fn": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-4.0.0.tgz",
+      "integrity": "sha512-vqiC06CuhBTUdZH+RYl8sFrL096vA45Ok5ISO6sE/Mr1jRbGH4Csnhi8f3wKVl7x8mO4Au7Ir9D3Oyv1VYMFJw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/npm-run-path": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-5.3.0.tgz",
+      "integrity": "sha512-ppwTtiJZq0O/ai0z7yfudtBpWIoxM8yE6nHi1X47eFR2EWORqfbu6CnPlNsjeN683eT0qG6H/Pyf9fCcvjnnnQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0"
+      },
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/onetime": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/onetime/-/onetime-6.0.0.tgz",
+      "integrity": "sha512-1FlR+gjXK7X+AsAHso35MnyN5KqGwJRi/31ft6x0M194ht7S+rWAvd7PHss9xSKMzE0asv1pyIHaJYq+BbacAQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mimic-fn": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-ci/node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/env-ci/node_modules/strip-final-newline": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-3.0.0.tgz",
+      "integrity": "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/env-paths": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/environment": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz",
+      "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/error-ex": {
@@ -5267,6 +5978,23 @@
         "node >=0.6.0"
       ]
     },
+    "node_modules/fast-content-type-parse": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/fast-content-type-parse/-/fast-content-type-parse-3.0.0.tgz",
+      "integrity": "sha512-ZvLdcY8P+N8mGQJahJV5G4U88CSvT1rP8ApL6uETe88MBXrBHAkZlSEySdUlyztF7ccb+Znos3TFqaepHxdhBg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "MIT"
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
@@ -5433,6 +6161,19 @@
         "node": ">=8"
       }
     },
+    "node_modules/find-up-simple": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/find-up-simple/-/find-up-simple-1.0.1.tgz",
+      "integrity": "sha512-afd4O7zpqHeRyg4PfDQsXmlDe2PfdHtJt6Akt8jOWaApLOZk5JXs6VMR29lz03pRe9mpykrRCYIYxaJYcfpncQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/find-versions": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/find-versions/-/find-versions-4.0.0.tgz",
@@ -5567,26 +6308,6 @@
         "safe-buffer": "~5.1.0"
       }
     },
-    "node_modules/fromentries": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/fromentries/-/fromentries-1.3.2.tgz",
-      "integrity": "sha512-cHEpEQHUg0f8XdtZCc2ZAhrHzKzT0MrFUTcvx+hfxYu7rGMDc5SKoXFh+n4YigxsHXRzc6OrCshdR1bWH6HHyg==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ]
-    },
     "node_modules/fs-extra": {
       "version": "9.1.0",
       "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
@@ -5628,6 +6349,19 @@
       "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==",
       "dev": true
     },
+    "node_modules/function-timeout": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/function-timeout/-/function-timeout-1.0.2.tgz",
+      "integrity": "sha512-939eZS4gJ3htTHAldmyyuzlrD58P03fHG49v2JfFXbV6OhvZKRC9j2yAtdHw/zrp2zXHuv05zMIy40F0ge7spA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/function.prototype.name": {
       "version": "1.1.5",
       "resolved": "https://registry.npmjs.org/function.prototype.name/-/function.prototype.name-1.1.5.tgz",
@@ -5679,6 +6413,19 @@
         "node": "6.* || 8.* || >= 10.*"
       }
     },
+    "node_modules/get-east-asian-width": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.5.0.tgz",
+      "integrity": "sha512-CQ+bEO+Tva/qlmw24dCejulK5pMzVnUOFOijVogd3KQs07HnRIgp8TGipvCCRT06xeYEbpbgwaCxglFyiuIcmA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/get-intrinsic": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.2.0.tgz",
@@ -6086,13 +6833,27 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/hook-std": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/hook-std/-/hook-std-2.0.0.tgz",
-      "integrity": "sha512-zZ6T5WcuBMIUVh49iPQS9t977t7C0l7OtHrpeMb5uk48JdflRX0NSFvCekfYNmGQETnLq9W/isMyHl69kxGi8g==",
+    "node_modules/highlight.js": {
+      "version": "10.7.3",
+      "resolved": "https://registry.npmjs.org/highlight.js/-/highlight.js-10.7.3.tgz",
+      "integrity": "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A==",
       "dev": true,
+      "license": "BSD-3-Clause",
       "engines": {
-        "node": ">=8"
+        "node": "*"
+      }
+    },
+    "node_modules/hook-std": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/hook-std/-/hook-std-4.0.0.tgz",
+      "integrity": "sha512-IHI4bEVOt3vRUDJ+bFA9VUJlo7SzvFARPNLw75pqSmAOP2HmTWfFJtPvLBrDrlgjEYXY9zs7SFdHPQaJShkSCQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/hosted-git-info": {
@@ -6286,6 +7047,20 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/import-from-esm": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/import-from-esm/-/import-from-esm-2.0.0.tgz",
+      "integrity": "sha512-YVt14UZCgsX1vZQ3gKjkWVdBdHQ6eu3MPU1TBgL1H5orXe2+jWD006WCPPtOuwlQm10NuzOW5WawiF1Q9veW8g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.3.4",
+        "import-meta-resolve": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=18.20"
+      }
+    },
     "node_modules/import-local": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.1.0.tgz",
@@ -6317,6 +7092,17 @@
         "node": ">=8"
       }
     },
+    "node_modules/import-meta-resolve": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz",
+      "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
     "node_modules/imurmurhash": {
       "version": "0.1.4",
       "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
@@ -6335,6 +7121,19 @@
         "node": ">=8"
       }
     },
+    "node_modules/index-to-position": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/index-to-position/-/index-to-position-1.2.0.tgz",
+      "integrity": "sha512-Yg7+ztRkqslMAS2iFaU+Oa4KTSidr63OsFGlOrJoW981kIYO3CGCS3wA95P1mUi/IVSJkn0D479KTJpVpvFNuw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/inflight": {
       "version": "1.0.6",
       "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
@@ -6592,24 +7391,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/is-path-cwd": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/is-path-cwd/-/is-path-cwd-2.2.0.tgz",
-      "integrity": "sha512-w942bTcih8fdJPJmQHFzkS76NEP8Kzzvmw92cXsazb8intwLqPibPPdXf4ANdKV3rYMuuQYGIWtvz9JilB3NFQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/is-path-inside": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz",
-      "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      }
-    },
     "node_modules/is-plain-obj": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz",
@@ -6619,15 +7400,6 @@
         "node": ">=0.10.0"
       }
     },
-    "node_modules/is-plain-object": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-5.0.0.tgz",
-      "integrity": "sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==",
-      "dev": true,
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/is-potential-custom-element-name": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
@@ -6741,6 +7513,19 @@
       "integrity": "sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==",
       "dev": true
     },
+    "node_modules/is-unicode-supported": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-2.1.0.tgz",
+      "integrity": "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/is-weakref": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/is-weakref/-/is-weakref-1.0.2.tgz",
@@ -6772,10 +7557,11 @@
       "dev": true
     },
     "node_modules/issue-parser": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/issue-parser/-/issue-parser-6.0.0.tgz",
-      "integrity": "sha512-zKa/Dxq2lGsBIXQ7CUZWTHfvxPC2ej0KfO7fIPqLlHB9J2hJ7rGhZ5rilhuufylr4RXYPzJUeFjKxz305OsNlA==",
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/issue-parser/-/issue-parser-7.0.1.tgz",
+      "integrity": "sha512-3YZcUUR2Wt1WsapF+S/WiA2WmlW0cWAoPccMqne7AxEBhCdFeTPjfv/Axb8V2gyCgY3nRw+ksZ3xSUX+R47iAg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "lodash.capitalize": "^4.2.1",
         "lodash.escaperegexp": "^4.1.2",
@@ -6784,7 +7570,7 @@
         "lodash.uniqby": "^4.7.0"
       },
       "engines": {
-        "node": ">=10.13"
+        "node": "^18.17 || >=20.6.1"
       }
     },
     "node_modules/istanbul-lib-coverage": {
@@ -6867,6 +7653,7 @@
       "resolved": "https://registry.npmjs.org/java-properties/-/java-properties-1.0.2.tgz",
       "integrity": "sha512-qjdpeo2yKlYTH7nFdK0vbZWuTCesk4o63v5iVOlhMQPfuIZQfW/HI35SjfhA+4qpg36rnFSvUK5b1m+ckIblQQ==",
       "dev": true,
+      "license": "MIT",
       "engines": {
         "node": ">= 0.6.0"
       }
@@ -7760,6 +8547,13 @@
       "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
       "dev": true
     },
+    "node_modules/json-with-bigint": {
+      "version": "3.5.7",
+      "resolved": "https://registry.npmjs.org/json-with-bigint/-/json-with-bigint-3.5.7.tgz",
+      "integrity": "sha512-7ei3MdAI5+fJPVnKlW77TKNKwQ5ppSzWvhPuSuINT/GYW9ZOC1eRKOuhV9yHG5aEsUPj9BBx5JIekkmoLHxZOw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/json5": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/json5/-/json5-1.0.2.tgz",
@@ -7949,17 +8743,26 @@
       "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
       "dev": true
     },
+    "node_modules/lodash-es": {
+      "version": "4.17.23",
+      "resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.23.tgz",
+      "integrity": "sha512-kVI48u3PZr38HdYz98UmfPnXl2DXrpdctLrFLCd3kOx1xUkOmpFPx7gCWWM5MPkL/fD8zb+Ph0QzjGFs4+hHWg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/lodash.capitalize": {
       "version": "4.2.1",
       "resolved": "https://registry.npmjs.org/lodash.capitalize/-/lodash.capitalize-4.2.1.tgz",
       "integrity": "sha512-kZzYOKspf8XVX5AvmQF94gQW0lejFVgb80G85bU4ZWzoJ6C03PQg3coYAUpSTpQWelrZELd3XWgHzw4Ck5kaIw==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/lodash.escaperegexp": {
       "version": "4.1.2",
       "resolved": "https://registry.npmjs.org/lodash.escaperegexp/-/lodash.escaperegexp-4.1.2.tgz",
       "integrity": "sha512-TM9YBvyC84ZxE3rgfefxUWiQKLilstD6k7PTGt6wfbtXF8ixIJLOL3VYyV/z+ZiPLsVxAsKAFVwWlWeb2Y8Yyw==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/lodash.get": {
       "version": "4.4.2",
@@ -7978,13 +8781,15 @@
       "version": "4.0.6",
       "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
       "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/lodash.isstring": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz",
       "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/lodash.memoize": {
       "version": "4.1.2",
@@ -8008,7 +8813,8 @@
       "version": "4.7.0",
       "resolved": "https://registry.npmjs.org/lodash.uniqby/-/lodash.uniqby-4.7.0.tgz",
       "integrity": "sha512-e/zcLx6CSbmaEgFHCA7BnoQKyCtKMxnuWrJygbwPs/AIn+IMKl66L8/s+wBUn5LRw2pZx3bUHibiV1b6aTWIww==",
-      "dev": true
+      "dev": true,
+      "license": "MIT"
     },
     "node_modules/log-driver": {
       "version": "1.2.7",
@@ -8046,6 +8852,37 @@
         "sourcemap-codec": "^1.4.8"
       }
     },
+    "node_modules/make-asynchronous": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/make-asynchronous/-/make-asynchronous-1.1.0.tgz",
+      "integrity": "sha512-ayF7iT+44LXdxJLTrTd3TLQpFDDvPCBxXxbv+pMUSuHA5Q8zyAfwkRP6aHHwNVFBUFWtxAHqwNJxF8vMZLAbVg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-event": "^6.0.0",
+        "type-fest": "^4.6.0",
+        "web-worker": "^1.5.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/make-asynchronous/node_modules/type-fest": {
+      "version": "4.41.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
+      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/make-dir": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-3.1.0.tgz",
@@ -8121,57 +8958,75 @@
       "dev": true
     },
     "node_modules/marked": {
-      "version": "4.2.12",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-4.2.12.tgz",
-      "integrity": "sha512-yr8hSKa3Fv4D3jdZmtMMPghgVt6TWbk86WQaWhDloQjRSQhMMYCAro7jP7VDJrjjdV8pxVxMssXS8B8Y5DZ5aw==",
+      "version": "15.0.12",
+      "resolved": "https://registry.npmjs.org/marked/-/marked-15.0.12.tgz",
+      "integrity": "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA==",
       "dev": true,
+      "license": "MIT",
       "bin": {
         "marked": "bin/marked.js"
       },
       "engines": {
-        "node": ">= 12"
+        "node": ">= 18"
       }
     },
     "node_modules/marked-terminal": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/marked-terminal/-/marked-terminal-5.1.1.tgz",
-      "integrity": "sha512-+cKTOx9P4l7HwINYhzbrBSyzgxO2HaHKGZGuB1orZsMIgXYaJyfidT81VXRdpelW/PcHEWxywscePVgI/oUF6g==",
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/marked-terminal/-/marked-terminal-7.3.0.tgz",
+      "integrity": "sha512-t4rBvPsHc57uE/2nJOLmMbZCQ4tgAccAED3ngXQqW6g+TxA488JzJ+FK3lQkzBQOI1mRV/r/Kq+1ZlJ4D0owQw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "ansi-escapes": "^5.0.0",
-        "cardinal": "^2.1.1",
-        "chalk": "^5.0.0",
-        "cli-table3": "^0.6.1",
-        "node-emoji": "^1.11.0",
-        "supports-hyperlinks": "^2.2.0"
+        "ansi-escapes": "^7.0.0",
+        "ansi-regex": "^6.1.0",
+        "chalk": "^5.4.1",
+        "cli-highlight": "^2.1.11",
+        "cli-table3": "^0.6.5",
+        "node-emoji": "^2.2.0",
+        "supports-hyperlinks": "^3.1.0"
       },
       "engines": {
-        "node": ">=14.13.1 || >=16.0.0"
+        "node": ">=16.0.0"
       },
       "peerDependencies": {
-        "marked": "^1.0.0 || ^2.0.0 || ^3.0.0 || ^4.0.0"
+        "marked": ">=1 <16"
       }
     },
     "node_modules/marked-terminal/node_modules/ansi-escapes": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-5.0.0.tgz",
-      "integrity": "sha512-5GFMVX8HqE/TB+FuBJGuO5XG0WrsA6ptUqoODaT/n9mmUaZFkqnBueB4leqGBCmrUHnCnC4PCZTCd0E7QQ83bA==",
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.3.0.tgz",
+      "integrity": "sha512-BvU8nYgGQBxcmMuEeUEmNTvrMVjJNSH7RgW24vXexN4Ven6qCvy4TntnvlnwnMLTVlcRQQdbRY8NKnaIoeWDNg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "type-fest": "^1.0.2"
+        "environment": "^1.0.0"
       },
       "engines": {
-        "node": ">=12"
+        "node": ">=18"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/marked-terminal/node_modules/chalk": {
-      "version": "5.2.0",
-      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.2.0.tgz",
-      "integrity": "sha512-ree3Gqw/nazQAPuJJEy+avdl7QfZMcUvmHIKgEZkGL+xOBzRvup5Hxo6LHuMceSxOabuJLJm5Yp/92R9eMmMvA==",
+    "node_modules/marked-terminal/node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
       "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/marked-terminal/node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "dev": true,
+      "license": "MIT",
       "engines": {
         "node": "^12.17.0 || ^14.13 || >=16.0.0"
       },
@@ -8179,18 +9034,6 @@
         "url": "https://github.com/chalk/chalk?sponsor=1"
       }
     },
-    "node_modules/marked-terminal/node_modules/type-fest": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-1.4.0.tgz",
-      "integrity": "sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==",
-      "dev": true,
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/mdurl": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/mdurl/-/mdurl-2.0.0.tgz",
@@ -8381,6 +9224,18 @@
       "integrity": "sha512-nnbWWOkoWyUsTjKrhgD0dcz22mdkSnpYqbEjIm2nhwhuxlSkpywJmBo8h0ZqJdkp73mb90SssHkN4rsRaBAfAA==",
       "dev": true
     },
+    "node_modules/mz": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/mz/-/mz-2.7.0.tgz",
+      "integrity": "sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "any-promise": "^1.0.0",
+        "object-assign": "^4.0.1",
+        "thenify-all": "^1.0.0"
+      }
+    },
     "node_modules/natural-compare": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
@@ -8449,12 +9304,19 @@
       }
     },
     "node_modules/node-emoji": {
-      "version": "1.11.0",
-      "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-1.11.0.tgz",
-      "integrity": "sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A==",
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-2.2.0.tgz",
+      "integrity": "sha512-Z3lTE9pLaJF47NyMhd4ww1yFTAP8YhYI8SleJiHzM46Fgpm5cnNzSl9XfzFNqbaz+VlJrIj3fXQ4DeN1Rjm6cw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "lodash": "^4.17.21"
+        "@sindresorhus/is": "^4.6.0",
+        "char-regex": "^1.0.2",
+        "emojilib": "^2.4.0",
+        "skin-tone": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/node-fetch": {
@@ -8514,38 +9376,39 @@
       }
     },
     "node_modules/normalize-url": {
-      "version": "6.1.0",
-      "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-6.1.0.tgz",
-      "integrity": "sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A==",
+      "version": "9.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-9.0.0.tgz",
+      "integrity": "sha512-z9nC87iaZXXySbWWtTHfCFJyFvKaUAW6lODhikG7ILSbVgmwuFjUqkgnheHvAUcGedO29e2QGBRXMUD64aurqQ==",
       "dev": true,
+      "license": "MIT",
       "engines": {
-        "node": ">=10"
+        "node": ">=20"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/npm": {
-      "version": "8.19.4",
-      "resolved": "https://registry.npmjs.org/npm/-/npm-8.19.4.tgz",
-      "integrity": "sha512-3HANl8i9DKnUA89P4KEgVNN28EjSeDCmvEqbzOAuxCFDzdBZzjUl99zgnGpOUumvW5lvJo2HKcjrsc+tfyv1Hw==",
+      "version": "11.11.0",
+      "resolved": "https://registry.npmjs.org/npm/-/npm-11.11.0.tgz",
+      "integrity": "sha512-82gRxKrh/eY5UnNorkTFcdBQAGpgjWehkfGVqAGlJjejEtJZGGJUqjo3mbBTNbc5BTnPKGVtGPBZGhElujX5cw==",
       "bundleDependencies": [
         "@isaacs/string-locale-compare",
         "@npmcli/arborist",
-        "@npmcli/ci-detect",
         "@npmcli/config",
         "@npmcli/fs",
         "@npmcli/map-workspaces",
+        "@npmcli/metavuln-calculator",
         "@npmcli/package-json",
+        "@npmcli/promise-spawn",
+        "@npmcli/redact",
         "@npmcli/run-script",
+        "@sigstore/tuf",
         "abbrev",
         "archy",
         "cacache",
         "chalk",
-        "chownr",
-        "cli-columns",
-        "cli-table3",
-        "columnify",
+        "ci-info",
         "fastest-levenshtein",
         "fs-minipass",
         "glob",
@@ -8559,7 +9422,6 @@
         "libnpmdiff",
         "libnpmexec",
         "libnpmfund",
-        "libnpmhook",
         "libnpmorg",
         "libnpmpack",
         "libnpmpublish",
@@ -8570,8 +9432,6 @@
         "minimatch",
         "minipass",
         "minipass-pipeline",
-        "mkdirp",
-        "mkdirp-infer-owner",
         "ms",
         "node-gyp",
         "nopt",
@@ -8582,110 +9442,105 @@
         "npm-profile",
         "npm-registry-fetch",
         "npm-user-validate",
-        "npmlog",
-        "opener",
         "p-map",
         "pacote",
         "parse-conflict-json",
         "proc-log",
         "qrcode-terminal",
         "read",
-        "read-package-json",
-        "read-package-json-fast",
-        "readdir-scoped-modules",
-        "rimraf",
         "semver",
+        "spdx-expression-parse",
         "ssri",
+        "supports-color",
         "tar",
         "text-table",
         "tiny-relative-date",
         "treeverse",
         "validate-npm-package-name",
-        "which",
-        "write-file-atomic"
+        "which"
       ],
       "dev": true,
+      "license": "Artistic-2.0",
+      "workspaces": [
+        "docs",
+        "smoke-tests",
+        "mock-globals",
+        "mock-registry",
+        "workspaces/*"
+      ],
       "dependencies": {
         "@isaacs/string-locale-compare": "^1.1.0",
-        "@npmcli/arborist": "^5.6.3",
-        "@npmcli/ci-detect": "^2.0.0",
-        "@npmcli/config": "^4.2.1",
-        "@npmcli/fs": "^2.1.0",
-        "@npmcli/map-workspaces": "^2.0.3",
-        "@npmcli/package-json": "^2.0.0",
-        "@npmcli/run-script": "^4.2.1",
-        "abbrev": "~1.1.1",
+        "@npmcli/arborist": "^9.4.0",
+        "@npmcli/config": "^10.7.1",
+        "@npmcli/fs": "^5.0.0",
+        "@npmcli/map-workspaces": "^5.0.3",
+        "@npmcli/metavuln-calculator": "^9.0.3",
+        "@npmcli/package-json": "^7.0.5",
+        "@npmcli/promise-spawn": "^9.0.1",
+        "@npmcli/redact": "^4.0.0",
+        "@npmcli/run-script": "^10.0.3",
+        "@sigstore/tuf": "^4.0.1",
+        "abbrev": "^4.0.0",
         "archy": "~1.0.0",
-        "cacache": "^16.1.3",
-        "chalk": "^4.1.2",
-        "chownr": "^2.0.0",
-        "cli-columns": "^4.0.0",
-        "cli-table3": "^0.6.2",
-        "columnify": "^1.6.0",
-        "fastest-levenshtein": "^1.0.12",
-        "fs-minipass": "^2.1.0",
-        "glob": "^8.0.1",
-        "graceful-fs": "^4.2.10",
-        "hosted-git-info": "^5.2.1",
-        "ini": "^3.0.1",
-        "init-package-json": "^3.0.2",
-        "is-cidr": "^4.0.2",
-        "json-parse-even-better-errors": "^2.3.1",
-        "libnpmaccess": "^6.0.4",
-        "libnpmdiff": "^4.0.5",
-        "libnpmexec": "^4.0.14",
-        "libnpmfund": "^3.0.5",
-        "libnpmhook": "^8.0.4",
-        "libnpmorg": "^4.0.4",
-        "libnpmpack": "^4.1.3",
-        "libnpmpublish": "^6.0.5",
-        "libnpmsearch": "^5.0.4",
-        "libnpmteam": "^4.0.4",
-        "libnpmversion": "^3.0.7",
-        "make-fetch-happen": "^10.2.0",
-        "minimatch": "^5.1.0",
-        "minipass": "^3.1.6",
+        "cacache": "^20.0.3",
+        "chalk": "^5.6.2",
+        "ci-info": "^4.4.0",
+        "fastest-levenshtein": "^1.0.16",
+        "fs-minipass": "^3.0.3",
+        "glob": "^13.0.6",
+        "graceful-fs": "^4.2.11",
+        "hosted-git-info": "^9.0.2",
+        "ini": "^6.0.0",
+        "init-package-json": "^8.2.5",
+        "is-cidr": "^6.0.3",
+        "json-parse-even-better-errors": "^5.0.0",
+        "libnpmaccess": "^10.0.3",
+        "libnpmdiff": "^8.1.3",
+        "libnpmexec": "^10.2.3",
+        "libnpmfund": "^7.0.17",
+        "libnpmorg": "^8.0.1",
+        "libnpmpack": "^9.1.3",
+        "libnpmpublish": "^11.1.3",
+        "libnpmsearch": "^9.0.1",
+        "libnpmteam": "^8.0.2",
+        "libnpmversion": "^8.0.3",
+        "make-fetch-happen": "^15.0.4",
+        "minimatch": "^10.2.2",
+        "minipass": "^7.1.3",
         "minipass-pipeline": "^1.2.4",
-        "mkdirp": "^1.0.4",
-        "mkdirp-infer-owner": "^2.0.0",
         "ms": "^2.1.2",
-        "node-gyp": "^9.1.0",
-        "nopt": "^6.0.0",
-        "npm-audit-report": "^3.0.0",
-        "npm-install-checks": "^5.0.0",
-        "npm-package-arg": "^9.1.0",
-        "npm-pick-manifest": "^7.0.2",
-        "npm-profile": "^6.2.0",
-        "npm-registry-fetch": "^13.3.1",
-        "npm-user-validate": "^1.0.1",
-        "npmlog": "^6.0.2",
-        "opener": "^1.5.2",
-        "p-map": "^4.0.0",
-        "pacote": "^13.6.2",
-        "parse-conflict-json": "^2.0.2",
-        "proc-log": "^2.0.1",
+        "node-gyp": "^12.2.0",
+        "nopt": "^9.0.0",
+        "npm-audit-report": "^7.0.0",
+        "npm-install-checks": "^8.0.0",
+        "npm-package-arg": "^13.0.2",
+        "npm-pick-manifest": "^11.0.3",
+        "npm-profile": "^12.0.1",
+        "npm-registry-fetch": "^19.1.1",
+        "npm-user-validate": "^4.0.0",
+        "p-map": "^7.0.4",
+        "pacote": "^21.4.0",
+        "parse-conflict-json": "^5.0.1",
+        "proc-log": "^6.1.0",
         "qrcode-terminal": "^0.12.0",
-        "read": "~1.0.7",
-        "read-package-json": "^5.0.2",
-        "read-package-json-fast": "^2.0.3",
-        "readdir-scoped-modules": "^1.1.0",
-        "rimraf": "^3.0.2",
-        "semver": "^7.3.7",
-        "ssri": "^9.0.1",
-        "tar": "^6.1.11",
+        "read": "^5.0.1",
+        "semver": "^7.7.4",
+        "spdx-expression-parse": "^4.0.0",
+        "ssri": "^13.0.1",
+        "supports-color": "^10.2.2",
+        "tar": "^7.5.9",
         "text-table": "~0.2.0",
-        "tiny-relative-date": "^1.3.0",
-        "treeverse": "^2.0.0",
-        "validate-npm-package-name": "^4.0.0",
-        "which": "^2.0.2",
-        "write-file-atomic": "^4.0.1"
+        "tiny-relative-date": "^2.0.2",
+        "treeverse": "^3.0.0",
+        "validate-npm-package-name": "^7.0.2",
+        "which": "^6.0.1"
       },
       "bin": {
         "npm": "bin/npm-cli.js",
         "npx": "bin/npx-cli.js"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm-run-path": {
@@ -8700,21 +9555,38 @@
         "node": ">=8"
       }
     },
-    "node_modules/npm/node_modules/@colors/colors": {
-      "version": "1.5.0",
+    "node_modules/npm/node_modules/@gar/promise-retry": {
+      "version": "1.0.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
-      "optional": true,
+      "dependencies": {
+        "retry": "^0.13.1"
+      },
       "engines": {
-        "node": ">=0.1.90"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/@gar/promisify": {
-      "version": "1.1.3",
+    "node_modules/npm/node_modules/@gar/promise-retry/node_modules/retry": {
+      "version": "0.13.1",
       "dev": true,
       "inBundle": true,
-      "license": "MIT"
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/npm/node_modules/@isaacs/fs-minipass": {
+      "version": "4.0.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "dependencies": {
+        "minipass": "^7.0.4"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
     },
     "node_modules/npm/node_modules/@isaacs/string-locale-compare": {
       "version": "1.1.0",
@@ -8722,347 +9594,368 @@
       "inBundle": true,
       "license": "ISC"
     },
+    "node_modules/npm/node_modules/@npmcli/agent": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "dependencies": {
+        "agent-base": "^7.1.0",
+        "http-proxy-agent": "^7.0.0",
+        "https-proxy-agent": "^7.0.1",
+        "lru-cache": "^11.2.1",
+        "socks-proxy-agent": "^8.0.3"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
     "node_modules/npm/node_modules/@npmcli/arborist": {
-      "version": "5.6.3",
+      "version": "9.4.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
         "@isaacs/string-locale-compare": "^1.1.0",
-        "@npmcli/installed-package-contents": "^1.0.7",
-        "@npmcli/map-workspaces": "^2.0.3",
-        "@npmcli/metavuln-calculator": "^3.0.1",
-        "@npmcli/move-file": "^2.0.0",
-        "@npmcli/name-from-folder": "^1.0.1",
-        "@npmcli/node-gyp": "^2.0.0",
-        "@npmcli/package-json": "^2.0.0",
-        "@npmcli/query": "^1.2.0",
-        "@npmcli/run-script": "^4.1.3",
-        "bin-links": "^3.0.3",
-        "cacache": "^16.1.3",
-        "common-ancestor-path": "^1.0.1",
-        "hosted-git-info": "^5.2.1",
-        "json-parse-even-better-errors": "^2.3.1",
+        "@npmcli/fs": "^5.0.0",
+        "@npmcli/installed-package-contents": "^4.0.0",
+        "@npmcli/map-workspaces": "^5.0.0",
+        "@npmcli/metavuln-calculator": "^9.0.2",
+        "@npmcli/name-from-folder": "^4.0.0",
+        "@npmcli/node-gyp": "^5.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "@npmcli/query": "^5.0.0",
+        "@npmcli/redact": "^4.0.0",
+        "@npmcli/run-script": "^10.0.0",
+        "bin-links": "^6.0.0",
+        "cacache": "^20.0.1",
+        "common-ancestor-path": "^2.0.0",
+        "hosted-git-info": "^9.0.0",
         "json-stringify-nice": "^1.1.4",
-        "minimatch": "^5.1.0",
-        "mkdirp": "^1.0.4",
-        "mkdirp-infer-owner": "^2.0.0",
-        "nopt": "^6.0.0",
-        "npm-install-checks": "^5.0.0",
-        "npm-package-arg": "^9.0.0",
-        "npm-pick-manifest": "^7.0.2",
-        "npm-registry-fetch": "^13.0.0",
-        "npmlog": "^6.0.2",
-        "pacote": "^13.6.1",
-        "parse-conflict-json": "^2.0.1",
-        "proc-log": "^2.0.0",
+        "lru-cache": "^11.2.1",
+        "minimatch": "^10.0.3",
+        "nopt": "^9.0.0",
+        "npm-install-checks": "^8.0.0",
+        "npm-package-arg": "^13.0.0",
+        "npm-pick-manifest": "^11.0.1",
+        "npm-registry-fetch": "^19.0.0",
+        "pacote": "^21.0.2",
+        "parse-conflict-json": "^5.0.1",
+        "proc-log": "^6.0.0",
+        "proggy": "^4.0.0",
         "promise-all-reject-late": "^1.0.0",
-        "promise-call-limit": "^1.0.1",
-        "read-package-json-fast": "^2.0.2",
-        "readdir-scoped-modules": "^1.1.0",
-        "rimraf": "^3.0.2",
+        "promise-call-limit": "^3.0.1",
         "semver": "^7.3.7",
-        "ssri": "^9.0.0",
-        "treeverse": "^2.0.0",
-        "walk-up-path": "^1.0.0"
+        "ssri": "^13.0.0",
+        "treeverse": "^3.0.0",
+        "walk-up-path": "^4.0.0"
       },
       "bin": {
         "arborist": "bin/index.js"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/@npmcli/ci-detect": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/config": {
-      "version": "4.2.2",
+      "version": "10.7.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/map-workspaces": "^2.0.2",
-        "ini": "^3.0.0",
-        "mkdirp-infer-owner": "^2.0.0",
-        "nopt": "^6.0.0",
-        "proc-log": "^2.0.0",
-        "read-package-json-fast": "^2.0.3",
+        "@npmcli/map-workspaces": "^5.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "ci-info": "^4.0.0",
+        "ini": "^6.0.0",
+        "nopt": "^9.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.5",
-        "walk-up-path": "^1.0.0"
+        "walk-up-path": "^4.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/@npmcli/disparity-colors": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "ansi-styles": "^4.3.0"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/fs": {
-      "version": "2.1.2",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@gar/promisify": "^1.1.3",
         "semver": "^7.3.5"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/git": {
-      "version": "3.0.2",
+      "version": "7.0.2",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/promise-spawn": "^3.0.0",
-        "lru-cache": "^7.4.4",
-        "mkdirp": "^1.0.4",
-        "npm-pick-manifest": "^7.0.0",
-        "proc-log": "^2.0.0",
-        "promise-inflight": "^1.0.1",
-        "promise-retry": "^2.0.1",
+        "@gar/promise-retry": "^1.0.0",
+        "@npmcli/promise-spawn": "^9.0.0",
+        "ini": "^6.0.0",
+        "lru-cache": "^11.2.1",
+        "npm-pick-manifest": "^11.0.1",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.5",
-        "which": "^2.0.2"
+        "which": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/installed-package-contents": {
-      "version": "1.0.7",
+      "version": "4.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-bundled": "^1.1.1",
-        "npm-normalize-package-bin": "^1.0.1"
+        "npm-bundled": "^5.0.0",
+        "npm-normalize-package-bin": "^5.0.0"
       },
       "bin": {
-        "installed-package-contents": "index.js"
+        "installed-package-contents": "bin/index.js"
       },
       "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/npm/node_modules/@npmcli/installed-package-contents/node_modules/npm-bundled": {
-      "version": "1.1.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "npm-normalize-package-bin": "^1.0.1"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/map-workspaces": {
-      "version": "2.0.4",
+      "version": "5.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/name-from-folder": "^1.0.1",
-        "glob": "^8.0.1",
-        "minimatch": "^5.0.1",
-        "read-package-json-fast": "^2.0.3"
+        "@npmcli/name-from-folder": "^4.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "glob": "^13.0.0",
+        "minimatch": "^10.0.3"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/metavuln-calculator": {
-      "version": "3.1.1",
+      "version": "9.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "cacache": "^16.0.0",
-        "json-parse-even-better-errors": "^2.3.1",
-        "pacote": "^13.0.3",
+        "cacache": "^20.0.0",
+        "json-parse-even-better-errors": "^5.0.0",
+        "pacote": "^21.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.5"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/@npmcli/move-file": {
-      "version": "2.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "mkdirp": "^1.0.4",
-        "rimraf": "^3.0.2"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/name-from-folder": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/@npmcli/node-gyp": {
-      "version": "2.0.0",
+      "version": "4.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/@npmcli/node-gyp": {
+      "version": "5.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/package-json": {
-      "version": "2.0.0",
+      "version": "7.0.5",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "json-parse-even-better-errors": "^2.3.1"
+        "@npmcli/git": "^7.0.0",
+        "glob": "^13.0.0",
+        "hosted-git-info": "^9.0.0",
+        "json-parse-even-better-errors": "^5.0.0",
+        "proc-log": "^6.0.0",
+        "semver": "^7.5.3",
+        "spdx-expression-parse": "^4.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/promise-spawn": {
-      "version": "3.0.0",
+      "version": "9.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "infer-owner": "^1.0.4"
+        "which": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/query": {
-      "version": "1.2.0",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-package-arg": "^9.1.0",
-        "postcss-selector-parser": "^6.0.10",
-        "semver": "^7.3.7"
+        "postcss-selector-parser": "^7.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/@npmcli/redact": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/@npmcli/run-script": {
-      "version": "4.2.1",
+      "version": "10.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/node-gyp": "^2.0.0",
-        "@npmcli/promise-spawn": "^3.0.0",
-        "node-gyp": "^9.0.0",
-        "read-package-json-fast": "^2.0.3",
-        "which": "^2.0.2"
+        "@npmcli/node-gyp": "^5.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "@npmcli/promise-spawn": "^9.0.0",
+        "node-gyp": "^12.1.0",
+        "proc-log": "^6.0.0",
+        "which": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/@tootallnate/once": {
-      "version": "2.0.0",
+    "node_modules/npm/node_modules/@sigstore/bundle": {
+      "version": "4.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/npm/node_modules/abbrev": {
-      "version": "1.1.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/agent-base": {
-      "version": "6.0.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
+      "license": "Apache-2.0",
       "dependencies": {
-        "debug": "4"
+        "@sigstore/protobuf-specs": "^0.5.0"
       },
       "engines": {
-        "node": ">= 6.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/agentkeepalive": {
-      "version": "4.2.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "debug": "^4.1.0",
-        "depd": "^1.1.2",
-        "humanize-ms": "^1.2.1"
-      },
-      "engines": {
-        "node": ">= 8.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/aggregate-error": {
+    "node_modules/npm/node_modules/@sigstore/core": {
       "version": "3.1.0",
       "dev": true,
       "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "clean-stack": "^2.0.0",
-        "indent-string": "^4.0.0"
-      },
+      "license": "Apache-2.0",
       "engines": {
-        "node": ">=8"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/ansi-regex": {
-      "version": "5.0.1",
+    "node_modules/npm/node_modules/@sigstore/protobuf-specs": {
+      "version": "0.5.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/npm/node_modules/@sigstore/sign": {
+      "version": "4.1.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@sigstore/bundle": "^4.0.0",
+        "@sigstore/core": "^3.1.0",
+        "@sigstore/protobuf-specs": "^0.5.0",
+        "make-fetch-happen": "^15.0.3",
+        "proc-log": "^6.1.0",
+        "promise-retry": "^2.0.1"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/@sigstore/tuf": {
+      "version": "4.0.1",
+      "dev": true,
+      "inBundle": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@sigstore/protobuf-specs": "^0.5.0",
+        "tuf-js": "^4.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/@sigstore/verify": {
+      "version": "3.1.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@sigstore/bundle": "^4.0.0",
+        "@sigstore/core": "^3.1.0",
+        "@sigstore/protobuf-specs": "^0.5.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/@tufjs/canonical-json": {
+      "version": "2.0.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": "^16.14.0 || >=18.0.0"
       }
     },
-    "node_modules/npm/node_modules/ansi-styles": {
-      "version": "4.3.0",
+    "node_modules/npm/node_modules/@tufjs/models": {
+      "version": "4.1.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "color-convert": "^2.0.1"
+        "@tufjs/canonical-json": "2.0.0",
+        "minimatch": "^10.1.1"
       },
       "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/abbrev": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/agent-base": {
+      "version": "7.1.4",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14"
       }
     },
     "node_modules/npm/node_modules/aproba": {
-      "version": "2.0.0",
+      "version": "2.1.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC"
@@ -9073,265 +9966,139 @@
       "inBundle": true,
       "license": "MIT"
     },
-    "node_modules/npm/node_modules/are-we-there-yet": {
-      "version": "3.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "delegates": "^1.0.0",
-        "readable-stream": "^3.6.0"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/asap": {
-      "version": "2.0.6",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
     "node_modules/npm/node_modules/balanced-match": {
-      "version": "1.0.2",
+      "version": "4.0.4",
       "dev": true,
       "inBundle": true,
-      "license": "MIT"
+      "license": "MIT",
+      "engines": {
+        "node": "18 || 20 || >=22"
+      }
     },
     "node_modules/npm/node_modules/bin-links": {
-      "version": "3.0.3",
+      "version": "6.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "cmd-shim": "^5.0.0",
-        "mkdirp-infer-owner": "^2.0.0",
-        "npm-normalize-package-bin": "^2.0.0",
-        "read-cmd-shim": "^3.0.0",
-        "rimraf": "^3.0.0",
-        "write-file-atomic": "^4.0.0"
+        "cmd-shim": "^8.0.0",
+        "npm-normalize-package-bin": "^5.0.0",
+        "proc-log": "^6.0.0",
+        "read-cmd-shim": "^6.0.0",
+        "write-file-atomic": "^7.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/bin-links/node_modules/npm-normalize-package-bin": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/binary-extensions": {
-      "version": "2.2.0",
+      "version": "3.1.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": ">=18.20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/npm/node_modules/brace-expansion": {
-      "version": "2.0.1",
+      "version": "5.0.3",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "balanced-match": "^1.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/builtins": {
-      "version": "5.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "semver": "^7.0.0"
+        "balanced-match": "^4.0.2"
+      },
+      "engines": {
+        "node": "18 || 20 || >=22"
       }
     },
     "node_modules/npm/node_modules/cacache": {
-      "version": "16.1.3",
+      "version": "20.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/fs": "^2.1.0",
-        "@npmcli/move-file": "^2.0.0",
-        "chownr": "^2.0.0",
-        "fs-minipass": "^2.1.0",
-        "glob": "^8.0.1",
-        "infer-owner": "^1.0.4",
-        "lru-cache": "^7.7.1",
-        "minipass": "^3.1.6",
-        "minipass-collect": "^1.0.2",
+        "@npmcli/fs": "^5.0.0",
+        "fs-minipass": "^3.0.0",
+        "glob": "^13.0.0",
+        "lru-cache": "^11.1.0",
+        "minipass": "^7.0.3",
+        "minipass-collect": "^2.0.1",
         "minipass-flush": "^1.0.5",
         "minipass-pipeline": "^1.2.4",
-        "mkdirp": "^1.0.4",
-        "p-map": "^4.0.0",
-        "promise-inflight": "^1.0.1",
-        "rimraf": "^3.0.2",
-        "ssri": "^9.0.0",
-        "tar": "^6.1.11",
-        "unique-filename": "^2.0.0"
+        "p-map": "^7.0.2",
+        "ssri": "^13.0.0",
+        "unique-filename": "^5.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/chalk": {
-      "version": "4.1.2",
+      "version": "5.6.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
-      "dependencies": {
-        "ansi-styles": "^4.1.0",
-        "supports-color": "^7.1.0"
-      },
       "engines": {
-        "node": ">=10"
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
       },
       "funding": {
         "url": "https://github.com/chalk/chalk?sponsor=1"
       }
     },
     "node_modules/npm/node_modules/chownr": {
-      "version": "2.0.0",
+      "version": "3.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "engines": {
-        "node": ">=10"
+        "node": ">=18"
+      }
+    },
+    "node_modules/npm/node_modules/ci-info": {
+      "version": "4.4.0",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/sibiraj-s"
+        }
+      ],
+      "inBundle": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
       }
     },
     "node_modules/npm/node_modules/cidr-regex": {
-      "version": "3.1.1",
+      "version": "5.0.3",
       "dev": true,
       "inBundle": true,
       "license": "BSD-2-Clause",
-      "dependencies": {
-        "ip-regex": "^4.1.0"
-      },
       "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/npm/node_modules/clean-stack": {
-      "version": "2.2.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/npm/node_modules/cli-columns": {
-      "version": "4.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "string-width": "^4.2.3",
-        "strip-ansi": "^6.0.1"
-      },
-      "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/npm/node_modules/cli-table3": {
-      "version": "0.6.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "string-width": "^4.2.0"
-      },
-      "engines": {
-        "node": "10.* || >= 12.*"
-      },
-      "optionalDependencies": {
-        "@colors/colors": "1.5.0"
-      }
-    },
-    "node_modules/npm/node_modules/clone": {
-      "version": "1.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.8"
+        "node": ">=20"
       }
     },
     "node_modules/npm/node_modules/cmd-shim": {
-      "version": "5.0.0",
+      "version": "8.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
-      "dependencies": {
-        "mkdirp-infer-owner": "^2.0.0"
-      },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/color-convert": {
-      "version": "2.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "color-name": "~1.1.4"
-      },
-      "engines": {
-        "node": ">=7.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/color-name": {
-      "version": "1.1.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/color-support": {
-      "version": "1.1.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "bin": {
-        "color-support": "bin.js"
-      }
-    },
-    "node_modules/npm/node_modules/columnify": {
-      "version": "1.6.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "strip-ansi": "^6.0.1",
-        "wcwidth": "^1.0.0"
-      },
-      "engines": {
-        "node": ">=8.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/common-ancestor-path": {
-      "version": "1.0.1",
+      "version": "2.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/concat-map": {
-      "version": "0.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/console-control-strings": {
-      "version": "1.1.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">= 18"
+      }
     },
     "node_modules/npm/node_modules/cssesc": {
       "version": "3.0.0",
@@ -9346,12 +10113,12 @@
       }
     },
     "node_modules/npm/node_modules/debug": {
-      "version": "4.3.4",
+      "version": "4.4.3",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "ms": "2.1.2"
+        "ms": "^2.1.3"
       },
       "engines": {
         "node": ">=6.0"
@@ -9362,57 +10129,8 @@
         }
       }
     },
-    "node_modules/npm/node_modules/debug/node_modules/ms": {
-      "version": "2.1.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/debuglog": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/npm/node_modules/defaults": {
-      "version": "1.0.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "clone": "^1.0.2"
-      }
-    },
-    "node_modules/npm/node_modules/delegates": {
-      "version": "1.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/depd": {
-      "version": "1.1.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.6"
-      }
-    },
-    "node_modules/npm/node_modules/dezalgo": {
-      "version": "1.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "asap": "^2.0.0",
-        "wrappy": "1"
-      }
-    },
     "node_modules/npm/node_modules/diff": {
-      "version": "5.1.0",
+      "version": "8.0.3",
       "dev": true,
       "inBundle": true,
       "license": "BSD-3-Clause",
@@ -9420,22 +10138,6 @@
         "node": ">=0.3.1"
       }
     },
-    "node_modules/npm/node_modules/emoji-regex": {
-      "version": "8.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/encoding": {
-      "version": "0.1.13",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "iconv-lite": "^0.6.2"
-      }
-    },
     "node_modules/npm/node_modules/env-paths": {
       "version": "2.2.1",
       "dev": true,
@@ -9451,163 +10153,102 @@
       "inBundle": true,
       "license": "MIT"
     },
-    "node_modules/npm/node_modules/fastest-levenshtein": {
-      "version": "1.0.12",
+    "node_modules/npm/node_modules/exponential-backoff": {
+      "version": "3.1.3",
       "dev": true,
       "inBundle": true,
-      "license": "MIT"
+      "license": "Apache-2.0"
     },
-    "node_modules/npm/node_modules/fs-minipass": {
-      "version": "2.1.0",
+    "node_modules/npm/node_modules/fastest-levenshtein": {
+      "version": "1.0.16",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "minipass": "^3.0.0"
-      },
+      "license": "MIT",
       "engines": {
-        "node": ">= 8"
+        "node": ">= 4.9.1"
       }
     },
-    "node_modules/npm/node_modules/fs.realpath": {
-      "version": "1.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/function-bind": {
-      "version": "1.1.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/gauge": {
-      "version": "4.0.4",
+    "node_modules/npm/node_modules/fs-minipass": {
+      "version": "3.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "aproba": "^1.0.3 || ^2.0.0",
-        "color-support": "^1.1.3",
-        "console-control-strings": "^1.1.0",
-        "has-unicode": "^2.0.1",
-        "signal-exit": "^3.0.7",
-        "string-width": "^4.2.3",
-        "strip-ansi": "^6.0.1",
-        "wide-align": "^1.1.5"
+        "minipass": "^7.0.3"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
       }
     },
     "node_modules/npm/node_modules/glob": {
-      "version": "8.0.3",
+      "version": "13.0.6",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "dependencies": {
-        "fs.realpath": "^1.0.0",
-        "inflight": "^1.0.4",
-        "inherits": "2",
-        "minimatch": "^5.0.1",
-        "once": "^1.3.0"
+        "minimatch": "^10.2.2",
+        "minipass": "^7.1.3",
+        "path-scurry": "^2.0.2"
       },
       "engines": {
-        "node": ">=12"
+        "node": "18 || 20 || >=22"
       },
       "funding": {
         "url": "https://github.com/sponsors/isaacs"
       }
     },
     "node_modules/npm/node_modules/graceful-fs": {
-      "version": "4.2.10",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/has": {
-      "version": "1.0.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "function-bind": "^1.1.1"
-      },
-      "engines": {
-        "node": ">= 0.4.0"
-      }
-    },
-    "node_modules/npm/node_modules/has-flag": {
-      "version": "4.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/npm/node_modules/has-unicode": {
-      "version": "2.0.1",
+      "version": "4.2.11",
       "dev": true,
       "inBundle": true,
       "license": "ISC"
     },
     "node_modules/npm/node_modules/hosted-git-info": {
-      "version": "5.2.1",
+      "version": "9.0.2",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "lru-cache": "^7.5.1"
+        "lru-cache": "^11.1.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/http-cache-semantics": {
-      "version": "4.1.1",
+      "version": "4.2.0",
       "dev": true,
       "inBundle": true,
       "license": "BSD-2-Clause"
     },
     "node_modules/npm/node_modules/http-proxy-agent": {
-      "version": "5.0.0",
+      "version": "7.0.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "@tootallnate/once": "2",
-        "agent-base": "6",
-        "debug": "4"
+        "agent-base": "^7.1.0",
+        "debug": "^4.3.4"
       },
       "engines": {
-        "node": ">= 6"
+        "node": ">= 14"
       }
     },
     "node_modules/npm/node_modules/https-proxy-agent": {
-      "version": "5.0.1",
+      "version": "7.0.6",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "agent-base": "6",
+        "agent-base": "^7.1.2",
         "debug": "4"
       },
       "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/npm/node_modules/humanize-ms": {
-      "version": "1.2.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "ms": "^2.0.0"
+        "node": ">= 14"
       }
     },
     "node_modules/npm/node_modules/iconv-lite": {
-      "version": "0.6.3",
+      "version": "0.7.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
@@ -9617,18 +10258,22 @@
       },
       "engines": {
         "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
       }
     },
     "node_modules/npm/node_modules/ignore-walk": {
-      "version": "5.0.1",
+      "version": "8.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "minimatch": "^5.0.1"
+        "minimatch": "^10.0.3"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/imurmurhash": {
@@ -9640,129 +10285,70 @@
         "node": ">=0.8.19"
       }
     },
-    "node_modules/npm/node_modules/indent-string": {
-      "version": "4.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/npm/node_modules/infer-owner": {
-      "version": "1.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/inflight": {
-      "version": "1.0.6",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "once": "^1.3.0",
-        "wrappy": "1"
-      }
-    },
-    "node_modules/npm/node_modules/inherits": {
-      "version": "2.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
     "node_modules/npm/node_modules/ini": {
-      "version": "3.0.1",
+      "version": "6.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/init-package-json": {
-      "version": "3.0.2",
+      "version": "8.2.5",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-package-arg": "^9.0.1",
-        "promzard": "^0.3.0",
-        "read": "^1.0.7",
-        "read-package-json": "^5.0.0",
-        "semver": "^7.3.5",
-        "validate-npm-package-license": "^3.0.4",
-        "validate-npm-package-name": "^4.0.0"
+        "@npmcli/package-json": "^7.0.0",
+        "npm-package-arg": "^13.0.0",
+        "promzard": "^3.0.1",
+        "read": "^5.0.1",
+        "semver": "^7.7.2",
+        "validate-npm-package-name": "^7.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/ip": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
-    "node_modules/npm/node_modules/ip-regex": {
-      "version": "4.3.0",
+    "node_modules/npm/node_modules/ip-address": {
+      "version": "10.1.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": ">= 12"
       }
     },
     "node_modules/npm/node_modules/is-cidr": {
-      "version": "4.0.2",
+      "version": "6.0.3",
       "dev": true,
       "inBundle": true,
       "license": "BSD-2-Clause",
       "dependencies": {
-        "cidr-regex": "^3.1.1"
+        "cidr-regex": "^5.0.1"
       },
       "engines": {
-        "node": ">=10"
+        "node": ">=20"
       }
     },
-    "node_modules/npm/node_modules/is-core-module": {
-      "version": "2.10.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "has": "^1.0.3"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/npm/node_modules/is-fullwidth-code-point": {
-      "version": "3.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/npm/node_modules/is-lambda": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT"
-    },
     "node_modules/npm/node_modules/isexe": {
-      "version": "2.0.0",
+      "version": "4.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=20"
+      }
     },
     "node_modules/npm/node_modules/json-parse-even-better-errors": {
-      "version": "2.3.1",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "MIT"
+      "license": "MIT",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
     },
     "node_modules/npm/node_modules/json-stringify-nice": {
       "version": "1.1.4",
@@ -9783,272 +10369,254 @@
       "license": "MIT"
     },
     "node_modules/npm/node_modules/just-diff": {
-      "version": "5.1.1",
+      "version": "6.0.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT"
     },
     "node_modules/npm/node_modules/just-diff-apply": {
-      "version": "5.4.1",
+      "version": "5.5.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT"
     },
     "node_modules/npm/node_modules/libnpmaccess": {
-      "version": "6.0.4",
+      "version": "10.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "aproba": "^2.0.0",
-        "minipass": "^3.1.1",
-        "npm-package-arg": "^9.0.1",
-        "npm-registry-fetch": "^13.0.0"
+        "npm-package-arg": "^13.0.0",
+        "npm-registry-fetch": "^19.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmdiff": {
-      "version": "4.0.5",
+      "version": "8.1.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/disparity-colors": "^2.0.0",
-        "@npmcli/installed-package-contents": "^1.0.7",
-        "binary-extensions": "^2.2.0",
-        "diff": "^5.1.0",
-        "minimatch": "^5.0.1",
-        "npm-package-arg": "^9.0.1",
-        "pacote": "^13.6.1",
-        "tar": "^6.1.0"
+        "@npmcli/arborist": "^9.4.0",
+        "@npmcli/installed-package-contents": "^4.0.0",
+        "binary-extensions": "^3.0.0",
+        "diff": "^8.0.2",
+        "minimatch": "^10.0.3",
+        "npm-package-arg": "^13.0.0",
+        "pacote": "^21.0.2",
+        "tar": "^7.5.1"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmexec": {
-      "version": "4.0.14",
+      "version": "10.2.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/arborist": "^5.6.3",
-        "@npmcli/ci-detect": "^2.0.0",
-        "@npmcli/fs": "^2.1.1",
-        "@npmcli/run-script": "^4.2.0",
-        "chalk": "^4.1.0",
-        "mkdirp-infer-owner": "^2.0.0",
-        "npm-package-arg": "^9.0.1",
-        "npmlog": "^6.0.2",
-        "pacote": "^13.6.1",
-        "proc-log": "^2.0.0",
-        "read": "^1.0.7",
-        "read-package-json-fast": "^2.0.2",
+        "@gar/promise-retry": "^1.0.0",
+        "@npmcli/arborist": "^9.4.0",
+        "@npmcli/package-json": "^7.0.0",
+        "@npmcli/run-script": "^10.0.0",
+        "ci-info": "^4.0.0",
+        "npm-package-arg": "^13.0.0",
+        "pacote": "^21.0.2",
+        "proc-log": "^6.0.0",
+        "read": "^5.0.1",
         "semver": "^7.3.7",
-        "walk-up-path": "^1.0.0"
+        "signal-exit": "^4.1.0",
+        "walk-up-path": "^4.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmfund": {
-      "version": "3.0.5",
+      "version": "7.0.17",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/arborist": "^5.6.3"
+        "@npmcli/arborist": "^9.4.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/libnpmhook": {
-      "version": "8.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "aproba": "^2.0.0",
-        "npm-registry-fetch": "^13.0.0"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmorg": {
-      "version": "4.0.4",
+      "version": "8.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
         "aproba": "^2.0.0",
-        "npm-registry-fetch": "^13.0.0"
+        "npm-registry-fetch": "^19.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmpack": {
-      "version": "4.1.3",
+      "version": "9.1.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/run-script": "^4.1.3",
-        "npm-package-arg": "^9.0.1",
-        "pacote": "^13.6.1"
+        "@npmcli/arborist": "^9.4.0",
+        "@npmcli/run-script": "^10.0.0",
+        "npm-package-arg": "^13.0.0",
+        "pacote": "^21.0.2"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmpublish": {
-      "version": "6.0.5",
+      "version": "11.1.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "normalize-package-data": "^4.0.0",
-        "npm-package-arg": "^9.0.1",
-        "npm-registry-fetch": "^13.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "ci-info": "^4.0.0",
+        "npm-package-arg": "^13.0.0",
+        "npm-registry-fetch": "^19.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.7",
-        "ssri": "^9.0.0"
+        "sigstore": "^4.0.0",
+        "ssri": "^13.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmsearch": {
-      "version": "5.0.4",
+      "version": "9.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-registry-fetch": "^13.0.0"
+        "npm-registry-fetch": "^19.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmteam": {
-      "version": "4.0.4",
+      "version": "8.0.2",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
         "aproba": "^2.0.0",
-        "npm-registry-fetch": "^13.0.0"
+        "npm-registry-fetch": "^19.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/libnpmversion": {
-      "version": "3.0.7",
+      "version": "8.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/git": "^3.0.0",
-        "@npmcli/run-script": "^4.1.3",
-        "json-parse-even-better-errors": "^2.3.1",
-        "proc-log": "^2.0.0",
+        "@npmcli/git": "^7.0.0",
+        "@npmcli/run-script": "^10.0.0",
+        "json-parse-even-better-errors": "^5.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.7"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/lru-cache": {
-      "version": "7.13.2",
+      "version": "11.2.6",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "engines": {
-        "node": ">=12"
+        "node": "20 || >=22"
       }
     },
     "node_modules/npm/node_modules/make-fetch-happen": {
-      "version": "10.2.1",
+      "version": "15.0.4",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "agentkeepalive": "^4.2.1",
-        "cacache": "^16.1.0",
-        "http-cache-semantics": "^4.1.0",
-        "http-proxy-agent": "^5.0.0",
-        "https-proxy-agent": "^5.0.0",
-        "is-lambda": "^1.0.1",
-        "lru-cache": "^7.7.1",
-        "minipass": "^3.1.6",
-        "minipass-collect": "^1.0.2",
-        "minipass-fetch": "^2.0.3",
+        "@gar/promise-retry": "^1.0.0",
+        "@npmcli/agent": "^4.0.0",
+        "cacache": "^20.0.1",
+        "http-cache-semantics": "^4.1.1",
+        "minipass": "^7.0.2",
+        "minipass-fetch": "^5.0.0",
         "minipass-flush": "^1.0.5",
         "minipass-pipeline": "^1.2.4",
-        "negotiator": "^0.6.3",
-        "promise-retry": "^2.0.1",
-        "socks-proxy-agent": "^7.0.0",
-        "ssri": "^9.0.0"
+        "negotiator": "^1.0.0",
+        "proc-log": "^6.0.0",
+        "ssri": "^13.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/minimatch": {
-      "version": "5.1.0",
+      "version": "10.2.2",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "dependencies": {
-        "brace-expansion": "^2.0.1"
+        "brace-expansion": "^5.0.2"
       },
       "engines": {
-        "node": ">=10"
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
       }
     },
     "node_modules/npm/node_modules/minipass": {
-      "version": "3.3.4",
+      "version": "7.1.3",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "yallist": "^4.0.0"
-      },
+      "license": "BlueOak-1.0.0",
       "engines": {
-        "node": ">=8"
+        "node": ">=16 || 14 >=14.17"
       }
     },
     "node_modules/npm/node_modules/minipass-collect": {
-      "version": "1.0.2",
+      "version": "2.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "minipass": "^3.0.0"
+        "minipass": "^7.0.3"
       },
       "engines": {
-        "node": ">= 8"
+        "node": ">=16 || 14 >=14.17"
       }
     },
     "node_modules/npm/node_modules/minipass-fetch": {
-      "version": "2.1.1",
+      "version": "5.0.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "minipass": "^3.1.6",
-        "minipass-sized": "^1.0.3",
-        "minizlib": "^2.1.2"
+        "minipass": "^7.0.3",
+        "minipass-sized": "^2.0.0",
+        "minizlib": "^3.0.1"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       },
       "optionalDependencies": {
-        "encoding": "^0.1.13"
+        "iconv-lite": "^0.7.2"
       }
     },
     "node_modules/npm/node_modules/minipass-flush": {
@@ -10063,16 +10631,24 @@
         "node": ">= 8"
       }
     },
-    "node_modules/npm/node_modules/minipass-json-stream": {
-      "version": "1.0.1",
+    "node_modules/npm/node_modules/minipass-flush/node_modules/minipass": {
+      "version": "3.3.6",
       "dev": true,
       "inBundle": true,
-      "license": "MIT",
+      "license": "ISC",
       "dependencies": {
-        "jsonparse": "^1.3.1",
-        "minipass": "^3.0.0"
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
       }
     },
+    "node_modules/npm/node_modules/minipass-flush/node_modules/yallist": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC"
+    },
     "node_modules/npm/node_modules/minipass-pipeline": {
       "version": "1.2.4",
       "dev": true,
@@ -10085,55 +10661,46 @@
         "node": ">=8"
       }
     },
-    "node_modules/npm/node_modules/minipass-sized": {
-      "version": "1.0.3",
+    "node_modules/npm/node_modules/minipass-pipeline/node_modules/minipass": {
+      "version": "3.3.6",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "minipass": "^3.0.0"
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/npm/node_modules/minipass-pipeline/node_modules/yallist": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC"
+    },
+    "node_modules/npm/node_modules/minipass-sized": {
+      "version": "2.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "dependencies": {
+        "minipass": "^7.1.2"
       },
       "engines": {
         "node": ">=8"
       }
     },
     "node_modules/npm/node_modules/minizlib": {
-      "version": "2.1.2",
+      "version": "3.1.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "minipass": "^3.0.0",
-        "yallist": "^4.0.0"
+        "minipass": "^7.1.2"
       },
       "engines": {
-        "node": ">= 8"
-      }
-    },
-    "node_modules/npm/node_modules/mkdirp": {
-      "version": "1.0.4",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "bin": {
-        "mkdirp": "bin/cmd.js"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/npm/node_modules/mkdirp-infer-owner": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "chownr": "^2.0.0",
-        "infer-owner": "^1.0.4",
-        "mkdirp": "^1.0.3"
-      },
-      "engines": {
-        "node": ">=10"
+        "node": ">= 18"
       }
     },
     "node_modules/npm/node_modules/ms": {
@@ -10143,13 +10710,16 @@
       "license": "MIT"
     },
     "node_modules/npm/node_modules/mute-stream": {
-      "version": "0.0.8",
+      "version": "3.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
     },
     "node_modules/npm/node_modules/negotiator": {
-      "version": "0.6.3",
+      "version": "1.0.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
@@ -10158,151 +10728,67 @@
       }
     },
     "node_modules/npm/node_modules/node-gyp": {
-      "version": "9.1.0",
+      "version": "12.2.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
         "env-paths": "^2.2.0",
-        "glob": "^7.1.4",
+        "exponential-backoff": "^3.1.1",
         "graceful-fs": "^4.2.6",
-        "make-fetch-happen": "^10.0.3",
-        "nopt": "^5.0.0",
-        "npmlog": "^6.0.0",
-        "rimraf": "^3.0.2",
+        "make-fetch-happen": "^15.0.0",
+        "nopt": "^9.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.5",
-        "tar": "^6.1.2",
-        "which": "^2.0.2"
+        "tar": "^7.5.4",
+        "tinyglobby": "^0.2.12",
+        "which": "^6.0.0"
       },
       "bin": {
         "node-gyp": "bin/node-gyp.js"
       },
       "engines": {
-        "node": "^12.22 || ^14.13 || >=16"
-      }
-    },
-    "node_modules/npm/node_modules/node-gyp/node_modules/brace-expansion": {
-      "version": "1.1.11",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "balanced-match": "^1.0.0",
-        "concat-map": "0.0.1"
-      }
-    },
-    "node_modules/npm/node_modules/node-gyp/node_modules/glob": {
-      "version": "7.2.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "fs.realpath": "^1.0.0",
-        "inflight": "^1.0.4",
-        "inherits": "2",
-        "minimatch": "^3.1.1",
-        "once": "^1.3.0",
-        "path-is-absolute": "^1.0.0"
-      },
-      "engines": {
-        "node": "*"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/npm/node_modules/node-gyp/node_modules/minimatch": {
-      "version": "3.1.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "brace-expansion": "^1.1.7"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/npm/node_modules/node-gyp/node_modules/nopt": {
-      "version": "5.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "abbrev": "1"
-      },
-      "bin": {
-        "nopt": "bin/nopt.js"
-      },
-      "engines": {
-        "node": ">=6"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/nopt": {
-      "version": "6.0.0",
+      "version": "9.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "abbrev": "^1.0.0"
+        "abbrev": "^4.0.0"
       },
       "bin": {
         "nopt": "bin/nopt.js"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/normalize-package-data": {
-      "version": "4.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "BSD-2-Clause",
-      "dependencies": {
-        "hosted-git-info": "^5.0.0",
-        "is-core-module": "^2.8.1",
-        "semver": "^7.3.5",
-        "validate-npm-package-license": "^3.0.4"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-audit-report": {
-      "version": "3.0.0",
+      "version": "7.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
-      "dependencies": {
-        "chalk": "^4.0.0"
-      },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-bundled": {
-      "version": "2.0.1",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-normalize-package-bin": "^2.0.0"
+        "npm-normalize-package-bin": "^5.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/npm-bundled/node_modules/npm-normalize-package-bin": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-install-checks": {
-      "version": "5.0.0",
+      "version": "8.0.0",
       "dev": true,
       "inBundle": true,
       "license": "BSD-2-Clause",
@@ -10310,226 +10796,177 @@
         "semver": "^7.1.1"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-normalize-package-bin": {
-      "version": "1.0.1",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
     },
     "node_modules/npm/node_modules/npm-package-arg": {
-      "version": "9.1.0",
+      "version": "13.0.2",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "hosted-git-info": "^5.0.0",
-        "proc-log": "^2.0.1",
+        "hosted-git-info": "^9.0.0",
+        "proc-log": "^6.0.0",
         "semver": "^7.3.5",
-        "validate-npm-package-name": "^4.0.0"
+        "validate-npm-package-name": "^7.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-packlist": {
-      "version": "5.1.3",
+      "version": "10.0.4",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "glob": "^8.0.1",
-        "ignore-walk": "^5.0.1",
-        "npm-bundled": "^2.0.0",
-        "npm-normalize-package-bin": "^2.0.0"
-      },
-      "bin": {
-        "npm-packlist": "bin/index.js"
+        "ignore-walk": "^8.0.0",
+        "proc-log": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/npm-packlist/node_modules/npm-normalize-package-bin": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-pick-manifest": {
-      "version": "7.0.2",
+      "version": "11.0.3",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-install-checks": "^5.0.0",
-        "npm-normalize-package-bin": "^2.0.0",
-        "npm-package-arg": "^9.0.0",
+        "npm-install-checks": "^8.0.0",
+        "npm-normalize-package-bin": "^5.0.0",
+        "npm-package-arg": "^13.0.0",
         "semver": "^7.3.5"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/npm-pick-manifest/node_modules/npm-normalize-package-bin": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-profile": {
-      "version": "6.2.1",
+      "version": "12.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "npm-registry-fetch": "^13.0.1",
-        "proc-log": "^2.0.0"
+        "npm-registry-fetch": "^19.0.0",
+        "proc-log": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-registry-fetch": {
-      "version": "13.3.1",
+      "version": "19.1.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "make-fetch-happen": "^10.0.6",
-        "minipass": "^3.1.6",
-        "minipass-fetch": "^2.0.3",
-        "minipass-json-stream": "^1.0.1",
-        "minizlib": "^2.1.2",
-        "npm-package-arg": "^9.0.1",
-        "proc-log": "^2.0.0"
+        "@npmcli/redact": "^4.0.0",
+        "jsonparse": "^1.3.1",
+        "make-fetch-happen": "^15.0.0",
+        "minipass": "^7.0.2",
+        "minipass-fetch": "^5.0.0",
+        "minizlib": "^3.0.1",
+        "npm-package-arg": "^13.0.0",
+        "proc-log": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/npm-user-validate": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "BSD-2-Clause"
-    },
-    "node_modules/npm/node_modules/npmlog": {
-      "version": "6.0.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "are-we-there-yet": "^3.0.0",
-        "console-control-strings": "^1.1.0",
-        "gauge": "^4.0.3",
-        "set-blocking": "^2.0.0"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/once": {
-      "version": "1.4.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "wrappy": "1"
-      }
-    },
-    "node_modules/npm/node_modules/opener": {
-      "version": "1.5.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "(WTFPL OR MIT)",
-      "bin": {
-        "opener": "bin/opener-bin.js"
-      }
-    },
-    "node_modules/npm/node_modules/p-map": {
       "version": "4.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "aggregate-error": "^3.0.0"
-      },
+      "license": "BSD-2-Clause",
       "engines": {
-        "node": ">=10"
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/p-map": {
+      "version": "7.0.4",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/npm/node_modules/pacote": {
-      "version": "13.6.2",
+      "version": "21.4.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "@npmcli/git": "^3.0.0",
-        "@npmcli/installed-package-contents": "^1.0.7",
-        "@npmcli/promise-spawn": "^3.0.0",
-        "@npmcli/run-script": "^4.1.0",
-        "cacache": "^16.0.0",
-        "chownr": "^2.0.0",
-        "fs-minipass": "^2.1.0",
-        "infer-owner": "^1.0.4",
-        "minipass": "^3.1.6",
-        "mkdirp": "^1.0.4",
-        "npm-package-arg": "^9.0.0",
-        "npm-packlist": "^5.1.0",
-        "npm-pick-manifest": "^7.0.0",
-        "npm-registry-fetch": "^13.0.1",
-        "proc-log": "^2.0.0",
-        "promise-retry": "^2.0.1",
-        "read-package-json": "^5.0.0",
-        "read-package-json-fast": "^2.0.3",
-        "rimraf": "^3.0.2",
-        "ssri": "^9.0.0",
-        "tar": "^6.1.11"
+        "@gar/promise-retry": "^1.0.0",
+        "@npmcli/git": "^7.0.0",
+        "@npmcli/installed-package-contents": "^4.0.0",
+        "@npmcli/package-json": "^7.0.0",
+        "@npmcli/promise-spawn": "^9.0.0",
+        "@npmcli/run-script": "^10.0.0",
+        "cacache": "^20.0.0",
+        "fs-minipass": "^3.0.0",
+        "minipass": "^7.0.2",
+        "npm-package-arg": "^13.0.0",
+        "npm-packlist": "^10.0.1",
+        "npm-pick-manifest": "^11.0.1",
+        "npm-registry-fetch": "^19.0.0",
+        "proc-log": "^6.0.0",
+        "sigstore": "^4.0.0",
+        "ssri": "^13.0.0",
+        "tar": "^7.4.3"
       },
       "bin": {
-        "pacote": "lib/bin.js"
+        "pacote": "bin/index.js"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/parse-conflict-json": {
-      "version": "2.0.2",
+      "version": "5.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "json-parse-even-better-errors": "^2.3.1",
-        "just-diff": "^5.0.1",
+        "json-parse-even-better-errors": "^5.0.0",
+        "just-diff": "^6.0.0",
         "just-diff-apply": "^5.2.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/path-is-absolute": {
-      "version": "1.0.1",
+    "node_modules/npm/node_modules/path-scurry": {
+      "version": "2.0.2",
       "dev": true,
       "inBundle": true,
-      "license": "MIT",
+      "license": "BlueOak-1.0.0",
+      "dependencies": {
+        "lru-cache": "^11.0.0",
+        "minipass": "^7.1.2"
+      },
       "engines": {
-        "node": ">=0.10.0"
+        "node": "18 || 20 || >=22"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
       }
     },
     "node_modules/npm/node_modules/postcss-selector-parser": {
-      "version": "6.0.10",
+      "version": "7.1.1",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
@@ -10542,12 +10979,21 @@
       }
     },
     "node_modules/npm/node_modules/proc-log": {
-      "version": "2.0.1",
+      "version": "6.1.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/npm/node_modules/proggy": {
+      "version": "4.0.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/promise-all-reject-late": {
@@ -10560,7 +11006,7 @@
       }
     },
     "node_modules/npm/node_modules/promise-call-limit": {
-      "version": "1.0.1",
+      "version": "3.0.2",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
@@ -10568,12 +11014,6 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/npm/node_modules/promise-inflight": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
     "node_modules/npm/node_modules/promise-retry": {
       "version": "2.0.1",
       "dev": true,
@@ -10588,12 +11028,15 @@
       }
     },
     "node_modules/npm/node_modules/promzard": {
-      "version": "0.3.0",
+      "version": "3.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "read": "1"
+        "read": "^5.0.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/qrcode-terminal": {
@@ -10605,87 +11048,24 @@
       }
     },
     "node_modules/npm/node_modules/read": {
-      "version": "1.0.7",
+      "version": "5.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "mute-stream": "~0.0.4"
+        "mute-stream": "^3.0.0"
       },
       "engines": {
-        "node": ">=0.8"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/read-cmd-shim": {
-      "version": "3.0.0",
+      "version": "6.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/read-package-json": {
-      "version": "5.0.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "glob": "^8.0.1",
-        "json-parse-even-better-errors": "^2.3.1",
-        "normalize-package-data": "^4.0.0",
-        "npm-normalize-package-bin": "^2.0.0"
-      },
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/read-package-json-fast": {
-      "version": "2.0.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "json-parse-even-better-errors": "^2.3.0",
-        "npm-normalize-package-bin": "^1.0.1"
-      },
-      "engines": {
-        "node": ">=10"
-      }
-    },
-    "node_modules/npm/node_modules/read-package-json/node_modules/npm-normalize-package-bin": {
-      "version": "2.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/readable-stream": {
-      "version": "3.6.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "inherits": "^2.0.3",
-        "string_decoder": "^1.1.1",
-        "util-deprecate": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 6"
-      }
-    },
-    "node_modules/npm/node_modules/readdir-scoped-modules": {
-      "version": "1.1.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "debuglog": "^1.0.1",
-        "dezalgo": "^1.0.0",
-        "graceful-fs": "^4.1.2",
-        "once": "^1.3.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/retry": {
@@ -10697,83 +11077,6 @@
         "node": ">= 4"
       }
     },
-    "node_modules/npm/node_modules/rimraf": {
-      "version": "3.0.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "glob": "^7.1.3"
-      },
-      "bin": {
-        "rimraf": "bin.js"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/npm/node_modules/rimraf/node_modules/brace-expansion": {
-      "version": "1.1.11",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "balanced-match": "^1.0.0",
-        "concat-map": "0.0.1"
-      }
-    },
-    "node_modules/npm/node_modules/rimraf/node_modules/glob": {
-      "version": "7.2.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "fs.realpath": "^1.0.0",
-        "inflight": "^1.0.4",
-        "inherits": "2",
-        "minimatch": "^3.1.1",
-        "once": "^1.3.0",
-        "path-is-absolute": "^1.0.0"
-      },
-      "engines": {
-        "node": "*"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/isaacs"
-      }
-    },
-    "node_modules/npm/node_modules/rimraf/node_modules/minimatch": {
-      "version": "3.1.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "brace-expansion": "^1.1.7"
-      },
-      "engines": {
-        "node": "*"
-      }
-    },
-    "node_modules/npm/node_modules/safe-buffer": {
-      "version": "5.2.1",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "inBundle": true,
-      "license": "MIT"
-    },
     "node_modules/npm/node_modules/safer-buffer": {
       "version": "2.1.2",
       "dev": true,
@@ -10782,13 +11085,10 @@
       "optional": true
     },
     "node_modules/npm/node_modules/semver": {
-      "version": "7.3.7",
+      "version": "7.7.4",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
-      "dependencies": {
-        "lru-cache": "^6.0.0"
-      },
       "bin": {
         "semver": "bin/semver.js"
       },
@@ -10796,29 +11096,34 @@
         "node": ">=10"
       }
     },
-    "node_modules/npm/node_modules/semver/node_modules/lru-cache": {
-      "version": "6.0.0",
+    "node_modules/npm/node_modules/signal-exit": {
+      "version": "4.1.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
-      "dependencies": {
-        "yallist": "^4.0.0"
-      },
       "engines": {
-        "node": ">=10"
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
       }
     },
-    "node_modules/npm/node_modules/set-blocking": {
-      "version": "2.0.0",
+    "node_modules/npm/node_modules/sigstore": {
+      "version": "4.1.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/signal-exit": {
-      "version": "3.0.7",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@sigstore/bundle": "^4.0.0",
+        "@sigstore/core": "^3.1.0",
+        "@sigstore/protobuf-specs": "^0.5.0",
+        "@sigstore/sign": "^4.1.0",
+        "@sigstore/tuf": "^4.0.1",
+        "@sigstore/verify": "^3.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
     },
     "node_modules/npm/node_modules/smart-buffer": {
       "version": "4.2.0",
@@ -10831,51 +11136,41 @@
       }
     },
     "node_modules/npm/node_modules/socks": {
-      "version": "2.7.0",
+      "version": "2.8.7",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "ip": "^2.0.0",
+        "ip-address": "^10.0.1",
         "smart-buffer": "^4.2.0"
       },
       "engines": {
-        "node": ">= 10.13.0",
+        "node": ">= 10.0.0",
         "npm": ">= 3.0.0"
       }
     },
     "node_modules/npm/node_modules/socks-proxy-agent": {
-      "version": "7.0.0",
+      "version": "8.0.5",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
       "dependencies": {
-        "agent-base": "^6.0.2",
-        "debug": "^4.3.3",
-        "socks": "^2.6.2"
+        "agent-base": "^7.1.2",
+        "debug": "^4.3.4",
+        "socks": "^2.8.3"
       },
       "engines": {
-        "node": ">= 10"
-      }
-    },
-    "node_modules/npm/node_modules/spdx-correct": {
-      "version": "3.1.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "spdx-expression-parse": "^3.0.0",
-        "spdx-license-ids": "^3.0.0"
+        "node": ">= 14"
       }
     },
     "node_modules/npm/node_modules/spdx-exceptions": {
-      "version": "2.3.0",
+      "version": "2.5.0",
       "dev": true,
       "inBundle": true,
       "license": "CC-BY-3.0"
     },
     "node_modules/npm/node_modules/spdx-expression-parse": {
-      "version": "3.0.1",
+      "version": "4.0.0",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
@@ -10885,85 +11180,49 @@
       }
     },
     "node_modules/npm/node_modules/spdx-license-ids": {
-      "version": "3.0.11",
+      "version": "3.0.23",
       "dev": true,
       "inBundle": true,
       "license": "CC0-1.0"
     },
     "node_modules/npm/node_modules/ssri": {
-      "version": "9.0.1",
+      "version": "13.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "minipass": "^3.1.1"
+        "minipass": "^7.0.3"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/string_decoder": {
-      "version": "1.3.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.2.0"
-      }
-    },
-    "node_modules/npm/node_modules/string-width": {
-      "version": "4.2.3",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "emoji-regex": "^8.0.0",
-        "is-fullwidth-code-point": "^3.0.0",
-        "strip-ansi": "^6.0.1"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/npm/node_modules/strip-ansi": {
-      "version": "6.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "ansi-regex": "^5.0.1"
-      },
-      "engines": {
-        "node": ">=8"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/supports-color": {
-      "version": "7.2.0",
+      "version": "10.2.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT",
-      "dependencies": {
-        "has-flag": "^4.0.0"
-      },
       "engines": {
-        "node": ">=8"
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-color?sponsor=1"
       }
     },
     "node_modules/npm/node_modules/tar": {
-      "version": "6.1.11",
+      "version": "7.5.9",
       "dev": true,
       "inBundle": true,
-      "license": "ISC",
+      "license": "BlueOak-1.0.0",
       "dependencies": {
-        "chownr": "^2.0.0",
-        "fs-minipass": "^2.0.0",
-        "minipass": "^3.0.0",
-        "minizlib": "^2.1.1",
-        "mkdirp": "^1.0.3",
-        "yallist": "^4.0.0"
+        "@isaacs/fs-minipass": "^4.0.0",
+        "chownr": "^3.0.0",
+        "minipass": "^7.1.2",
+        "minizlib": "^3.1.0",
+        "yallist": "^5.0.0"
       },
       "engines": {
-        "node": ">= 10"
+        "node": ">=18"
       }
     },
     "node_modules/npm/node_modules/text-table": {
@@ -10973,34 +11232,93 @@
       "license": "MIT"
     },
     "node_modules/npm/node_modules/tiny-relative-date": {
-      "version": "1.3.0",
+      "version": "2.0.2",
       "dev": true,
       "inBundle": true,
       "license": "MIT"
     },
+    "node_modules/npm/node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/npm/node_modules/tinyglobby/node_modules/fdir": {
+      "version": "6.5.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/npm/node_modules/tinyglobby/node_modules/picomatch": {
+      "version": "4.0.3",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/npm/node_modules/treeverse": {
-      "version": "2.0.0",
+      "version": "3.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+      }
+    },
+    "node_modules/npm/node_modules/tuf-js": {
+      "version": "4.1.0",
+      "dev": true,
+      "inBundle": true,
+      "license": "MIT",
+      "dependencies": {
+        "@tufjs/models": "4.1.0",
+        "debug": "^4.4.3",
+        "make-fetch-happen": "^15.0.1"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/unique-filename": {
-      "version": "2.0.1",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "unique-slug": "^3.0.0"
+        "unique-slug": "^6.0.0"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/unique-slug": {
-      "version": "3.0.0",
+      "version": "6.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
@@ -11008,7 +11326,7 @@
         "imurmurhash": "^0.1.4"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/util-deprecate": {
@@ -11017,91 +11335,60 @@
       "inBundle": true,
       "license": "MIT"
     },
-    "node_modules/npm/node_modules/validate-npm-package-license": {
-      "version": "3.0.4",
+    "node_modules/npm/node_modules/validate-npm-package-name": {
+      "version": "7.0.2",
       "dev": true,
       "inBundle": true,
-      "license": "Apache-2.0",
-      "dependencies": {
-        "spdx-correct": "^3.0.0",
-        "spdx-expression-parse": "^3.0.0"
+      "license": "ISC",
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/validate-npm-package-name": {
+    "node_modules/npm/node_modules/walk-up-path": {
       "version": "4.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
-      "dependencies": {
-        "builtins": "^5.0.0"
-      },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
-      }
-    },
-    "node_modules/npm/node_modules/walk-up-path": {
-      "version": "1.0.0",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
-    "node_modules/npm/node_modules/wcwidth": {
-      "version": "1.0.1",
-      "dev": true,
-      "inBundle": true,
-      "license": "MIT",
-      "dependencies": {
-        "defaults": "^1.0.3"
+        "node": "20 || >=22"
       }
     },
     "node_modules/npm/node_modules/which": {
-      "version": "2.0.2",
+      "version": "6.0.1",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
-        "isexe": "^2.0.0"
+        "isexe": "^4.0.0"
       },
       "bin": {
-        "node-which": "bin/node-which"
+        "node-which": "bin/which.js"
       },
       "engines": {
-        "node": ">= 8"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
-    "node_modules/npm/node_modules/wide-align": {
-      "version": "1.1.5",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC",
-      "dependencies": {
-        "string-width": "^1.0.2 || 2 || 3 || 4"
-      }
-    },
-    "node_modules/npm/node_modules/wrappy": {
-      "version": "1.0.2",
-      "dev": true,
-      "inBundle": true,
-      "license": "ISC"
-    },
     "node_modules/npm/node_modules/write-file-atomic": {
-      "version": "4.0.2",
+      "version": "7.0.0",
       "dev": true,
       "inBundle": true,
       "license": "ISC",
       "dependencies": {
         "imurmurhash": "^0.1.4",
-        "signal-exit": "^3.0.7"
+        "signal-exit": "^4.0.1"
       },
       "engines": {
-        "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
+        "node": "^20.17.0 || >=22.9.0"
       }
     },
     "node_modules/npm/node_modules/yallist": {
-      "version": "4.0.0",
+      "version": "5.0.0",
       "dev": true,
       "inBundle": true,
-      "license": "ISC"
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
     },
     "node_modules/nwsapi": {
       "version": "2.2.2",
@@ -11118,6 +11405,16 @@
         "node": "*"
       }
     },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/object-inspect": {
       "version": "1.12.3",
       "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.12.3.tgz",
@@ -11243,36 +11540,48 @@
       }
     },
     "node_modules/p-each-series": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/p-each-series/-/p-each-series-2.2.0.tgz",
-      "integrity": "sha512-ycIL2+1V32th+8scbpTvyHNaHe02z0sjgh91XXjAk+ZeXoPN4Z46DVUnzdso0aX4KckKw0FNNFHdjZ2UsZvxiA==",
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/p-each-series/-/p-each-series-3.0.0.tgz",
+      "integrity": "sha512-lastgtAdoH9YaLyDa5i5z64q+kzOcQHsQ5SsZJD3q0VEyI8mq872S3geuNbRUQLVAE9siMfgKrpj7MloKFHruw==",
       "dev": true,
+      "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-event": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/p-event/-/p-event-6.0.1.tgz",
+      "integrity": "sha512-Q6Bekk5wpzW5qIyUP4gdMEujObYstZl6DMMOSenwBvV0BlE5LkDwkjs5yHbZmdCEq2o4RJx4tE1vwxFVf2FG1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-timeout": "^6.1.2"
+      },
+      "engines": {
+        "node": ">=16.17"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/p-filter": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/p-filter/-/p-filter-2.1.0.tgz",
-      "integrity": "sha512-ZBxxZ5sL2HghephhpGAQdoskxplTwr7ICaehZwLIlfL6acuVgZPm8yBNuRAFBGEqtD/hmUeq9eqLg2ys9Xr/yw==",
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/p-filter/-/p-filter-4.1.0.tgz",
+      "integrity": "sha512-37/tPdZ3oJwHaS3gNJdenCDB3Tz26i9sjhnguBtvN0vYlRIiDNnvTWkuh+0hETV9rLPdJ3rlL3yVOYPIAnM8rw==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "p-map": "^2.0.0"
+        "p-map": "^7.0.1"
       },
       "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/p-filter/node_modules/p-map": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/p-map/-/p-map-2.1.0.tgz",
-      "integrity": "sha512-y3b8Kpd8OAN444hxfBbFfj1FY/RjtTd8tzYwhUqNYXx0fXx2iX4maP4Qr6qhIKbQXI02wTLAda4fYUbDagTUFw==",
-      "dev": true,
-      "engines": {
-        "node": ">=6"
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/p-is-promise": {
@@ -11312,15 +11621,13 @@
       }
     },
     "node_modules/p-map": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/p-map/-/p-map-4.0.0.tgz",
-      "integrity": "sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==",
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/p-map/-/p-map-7.0.4.tgz",
+      "integrity": "sha512-tkAQEw8ysMzmkhgw8k+1U/iPhWNhykKnSk4Rd5zLoPJCuJaGRPo6YposrZgaxHKzDHdDWWZvE/Sk7hsL2X/CpQ==",
       "dev": true,
-      "dependencies": {
-        "aggregate-error": "^3.0.0"
-      },
+      "license": "MIT",
       "engines": {
-        "node": ">=10"
+        "node": ">=18"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
@@ -11335,17 +11642,17 @@
         "node": ">=8"
       }
     },
-    "node_modules/p-retry": {
-      "version": "4.6.2",
-      "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",
-      "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",
+    "node_modules/p-timeout": {
+      "version": "6.1.4",
+      "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-6.1.4.tgz",
+      "integrity": "sha512-MyIV3ZA/PmyBN/ud8vV9XzwTrNtR4jFrObymZYnZqMmW0zA8Z17vnT0rBgFE/TlohB+YCHqXMgZzb3Csp49vqg==",
       "dev": true,
-      "dependencies": {
-        "@types/retry": "0.12.0",
-        "retry": "^0.13.1"
-      },
+      "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/p-try": {
@@ -11387,12 +11694,42 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/parse-ms": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/parse-ms/-/parse-ms-4.0.0.tgz",
+      "integrity": "sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/parse5": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/parse5/-/parse5-4.0.0.tgz",
       "integrity": "sha512-VrZ7eOd3T1Fk4XWNXMgiGBK/z0MG48BWG2uQNU4I72fkQuKUTZpl+u9k+CxEG0twMVzSmXEEz12z5Fnw1jIQFA==",
       "dev": true
     },
+    "node_modules/parse5-htmlparser2-tree-adapter": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-6.0.1.tgz",
+      "integrity": "sha512-qPuWvbLgvDGilKc5BoicRovlT4MtYT6JfJyBOMDsKoiT+GiuP5qyrPCnR9HcPECIJJmZh5jRndyNThnhhb/vlA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "parse5": "^6.0.1"
+      }
+    },
+    "node_modules/parse5-htmlparser2-tree-adapter/node_modules/parse5": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/parse5/-/parse5-6.0.1.tgz",
+      "integrity": "sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -11487,10 +11824,11 @@
       "dev": true
     },
     "node_modules/picocolors": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.0.0.tgz",
-      "integrity": "sha512-1fygroTLlHu66zi26VoTDv8yRgm0Fccecssto+MhsZ0D/DGW2sm8E8AjW7NU5VVTRt5GxbeZ5qBuJr+HyLYkjQ==",
-      "dev": true
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
     },
     "node_modules/picomatch": {
       "version": "2.3.1",
@@ -11728,6 +12066,22 @@
         "url": "https://github.com/chalk/ansi-styles?sponsor=1"
       }
     },
+    "node_modules/pretty-ms": {
+      "version": "9.3.0",
+      "resolved": "https://registry.npmjs.org/pretty-ms/-/pretty-ms-9.3.0.tgz",
+      "integrity": "sha512-gjVS5hOP+M3wMm5nmNOucbIrqudzs9v/57bWRHQWLYklXqoXKrVfYW2W9+glfGsqtPgpiz5WwyEEB+ksXIx3gQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "parse-ms": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/process-nextick-args": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
@@ -11921,6 +12275,142 @@
       "integrity": "sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==",
       "dev": true
     },
+    "node_modules/read-package-up": {
+      "version": "12.0.0",
+      "resolved": "https://registry.npmjs.org/read-package-up/-/read-package-up-12.0.0.tgz",
+      "integrity": "sha512-Q5hMVBYur/eQNWDdbF4/Wqqr9Bjvtrw2kjGxxBbKLbx8bVCL8gcArjTy8zDUuLGQicftpMuU0riQNcAsbtOVsw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "find-up-simple": "^1.0.1",
+        "read-pkg": "^10.0.0",
+        "type-fest": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/read-package-up/node_modules/hosted-git-info": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.2.tgz",
+      "integrity": "sha512-M422h7o/BR3rmCQ8UHi7cyyMqKltdP9Uo+J2fXK+RSAY+wTcKOIRyhTuKv4qn+DJf3g+PL890AzId5KZpX+CBg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^11.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/read-package-up/node_modules/lru-cache": {
+      "version": "11.2.6",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.6.tgz",
+      "integrity": "sha512-ESL2CrkS/2wTPfuend7Zhkzo2u0daGJ/A2VucJOgQ/C48S/zB8MMeMHSGKYpXhIjbPxfuezITkaBH1wqv00DDQ==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/read-package-up/node_modules/normalize-package-data": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-8.0.0.tgz",
+      "integrity": "sha512-RWk+PI433eESQ7ounYxIp67CYuVsS1uYSonX3kA6ps/3LWfjVQa/ptEg6Y3T6uAMq1mWpX9PQ+qx+QaHpsc7gQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "hosted-git-info": "^9.0.0",
+        "semver": "^7.3.5",
+        "validate-npm-package-license": "^3.0.4"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/read-package-up/node_modules/parse-json": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-8.3.0.tgz",
+      "integrity": "sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.26.2",
+        "index-to-position": "^1.1.0",
+        "type-fest": "^4.39.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/read-package-up/node_modules/parse-json/node_modules/type-fest": {
+      "version": "4.41.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
+      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/read-package-up/node_modules/read-pkg": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-10.1.0.tgz",
+      "integrity": "sha512-I8g2lArQiP78ll51UeMZojewtYgIRCKCWqZEgOO8c/uefTI+XDXvCSXu3+YNUaTNvZzobrL5+SqHjBrByRRTdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/normalize-package-data": "^2.4.4",
+        "normalize-package-data": "^8.0.0",
+        "parse-json": "^8.3.0",
+        "type-fest": "^5.4.4",
+        "unicorn-magic": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/read-package-up/node_modules/type-fest": {
+      "version": "5.4.4",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-5.4.4.tgz",
+      "integrity": "sha512-JnTrzGu+zPV3aXIUhnyWJj4z/wigMsdYajGLIYakqyOW1nPllzXEJee0QQbHj+CTIQtXGlAjuK0UY+2xTyjVAw==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "dependencies": {
+        "tagged-tag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/read-package-up/node_modules/unicorn-magic": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.0.tgz",
+      "integrity": "sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/read-pkg": {
       "version": "5.2.0",
       "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-5.2.0.tgz",
@@ -12025,15 +12515,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/redeyed": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/redeyed/-/redeyed-2.1.1.tgz",
-      "integrity": "sha512-FNpGGo1DycYAdnrKFxCMmKYgo/mILAqtRYbkdQD8Ep/Hk2PQ5+aEAEx+IU713RTDmuBaH0c8P5ZozurNu5ObRQ==",
-      "dev": true,
-      "dependencies": {
-        "esprima": "~4.0.0"
-      }
-    },
     "node_modules/regenerator-runtime": {
       "version": "0.13.11",
       "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.13.11.tgz",
@@ -12215,15 +12696,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/retry": {
-      "version": "0.13.1",
-      "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
-      "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
-      "dev": true,
-      "engines": {
-        "node": ">= 4"
-      }
-    },
     "node_modules/reusify": {
       "version": "1.0.4",
       "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.0.4.tgz",
@@ -12488,45 +12960,789 @@
       }
     },
     "node_modules/semantic-release": {
-      "version": "19.0.5",
-      "resolved": "https://registry.npmjs.org/semantic-release/-/semantic-release-19.0.5.tgz",
-      "integrity": "sha512-NMPKdfpXTnPn49FDogMBi36SiBfXkSOJqCkk0E4iWOY1tusvvgBwqUmxTX1kmlT6kIYed9YwNKD1sfPpqa5yaA==",
+      "version": "25.0.3",
+      "resolved": "https://registry.npmjs.org/semantic-release/-/semantic-release-25.0.3.tgz",
+      "integrity": "sha512-WRgl5GcypwramYX4HV+eQGzUbD7UUbljVmS+5G1uMwX/wLgYuJAxGeerXJDMO2xshng4+FXqCgyB5QfClV6WjA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "@semantic-release/commit-analyzer": "^9.0.2",
-        "@semantic-release/error": "^3.0.0",
-        "@semantic-release/github": "^8.0.0",
-        "@semantic-release/npm": "^9.0.0",
-        "@semantic-release/release-notes-generator": "^10.0.0",
-        "aggregate-error": "^3.0.0",
-        "cosmiconfig": "^7.0.0",
+        "@semantic-release/commit-analyzer": "^13.0.1",
+        "@semantic-release/error": "^4.0.0",
+        "@semantic-release/github": "^12.0.0",
+        "@semantic-release/npm": "^13.1.1",
+        "@semantic-release/release-notes-generator": "^14.1.0",
+        "aggregate-error": "^5.0.0",
+        "cosmiconfig": "^9.0.0",
         "debug": "^4.0.0",
-        "env-ci": "^5.0.0",
-        "execa": "^5.0.0",
-        "figures": "^3.0.0",
-        "find-versions": "^4.0.0",
+        "env-ci": "^11.0.0",
+        "execa": "^9.0.0",
+        "figures": "^6.0.0",
+        "find-versions": "^6.0.0",
         "get-stream": "^6.0.0",
         "git-log-parser": "^1.2.0",
-        "hook-std": "^2.0.0",
-        "hosted-git-info": "^4.0.0",
-        "lodash": "^4.17.21",
-        "marked": "^4.0.10",
-        "marked-terminal": "^5.0.0",
+        "hook-std": "^4.0.0",
+        "hosted-git-info": "^9.0.0",
+        "import-from-esm": "^2.0.0",
+        "lodash-es": "^4.17.21",
+        "marked": "^15.0.0",
+        "marked-terminal": "^7.3.0",
         "micromatch": "^4.0.2",
-        "p-each-series": "^2.1.0",
-        "p-reduce": "^2.0.0",
-        "read-pkg-up": "^7.0.0",
+        "p-each-series": "^3.0.0",
+        "p-reduce": "^3.0.0",
+        "read-package-up": "^12.0.0",
         "resolve-from": "^5.0.0",
         "semver": "^7.3.2",
-        "semver-diff": "^3.1.1",
         "signale": "^1.2.1",
-        "yargs": "^16.2.0"
+        "yargs": "^18.0.0"
       },
       "bin": {
         "semantic-release": "bin/semantic-release.js"
       },
       "engines": {
-        "node": ">=16 || ^14.17"
+        "node": "^22.14.0 || >= 24.10.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/@semantic-release/commit-analyzer": {
+      "version": "13.0.1",
+      "resolved": "https://registry.npmjs.org/@semantic-release/commit-analyzer/-/commit-analyzer-13.0.1.tgz",
+      "integrity": "sha512-wdnBPHKkr9HhNhXOhZD5a2LNl91+hs8CC2vsAVYxtZH3y0dV3wKn+uZSN61rdJQZ8EGxzWB3inWocBHV9+u/CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "conventional-changelog-angular": "^8.0.0",
+        "conventional-changelog-writer": "^8.0.0",
+        "conventional-commits-filter": "^5.0.0",
+        "conventional-commits-parser": "^6.0.0",
+        "debug": "^4.0.0",
+        "import-from-esm": "^2.0.0",
+        "lodash-es": "^4.17.21",
+        "micromatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=20.8.1"
+      },
+      "peerDependencies": {
+        "semantic-release": ">=20.1.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/@semantic-release/error": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@semantic-release/error/-/error-4.0.0.tgz",
+      "integrity": "sha512-mgdxrHTLOjOddRVYIYDo0fR3/v61GNN1YGkfbrjuIKg/uMgCd+Qzo3UAXJ+woLQQpos4pl5Esuw5A7AoNlzjUQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/semantic-release/node_modules/@semantic-release/release-notes-generator": {
+      "version": "14.1.0",
+      "resolved": "https://registry.npmjs.org/@semantic-release/release-notes-generator/-/release-notes-generator-14.1.0.tgz",
+      "integrity": "sha512-CcyDRk7xq+ON/20YNR+1I/jP7BYKICr1uKd1HHpROSnnTdGqOTburi4jcRiTYz0cpfhxSloQO3cGhnoot7IEkA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "conventional-changelog-angular": "^8.0.0",
+        "conventional-changelog-writer": "^8.0.0",
+        "conventional-commits-filter": "^5.0.0",
+        "conventional-commits-parser": "^6.0.0",
+        "debug": "^4.0.0",
+        "get-stream": "^7.0.0",
+        "import-from-esm": "^2.0.0",
+        "into-stream": "^7.0.0",
+        "lodash-es": "^4.17.21",
+        "read-package-up": "^11.0.0"
+      },
+      "engines": {
+        "node": ">=20.8.1"
+      },
+      "peerDependencies": {
+        "semantic-release": ">=20.1.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/@semantic-release/release-notes-generator/node_modules/get-stream": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-7.0.1.tgz",
+      "integrity": "sha512-3M8C1EOFN6r8AMUhwUAACIoXZJEOufDU5+0gFFN5uNs6XYOralD2Pqkl7m046va6x77FwposWXbAhPPIOus7mQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/@semantic-release/release-notes-generator/node_modules/read-package-up": {
+      "version": "11.0.0",
+      "resolved": "https://registry.npmjs.org/read-package-up/-/read-package-up-11.0.0.tgz",
+      "integrity": "sha512-MbgfoNPANMdb4oRBNg5eqLbB2t2r+o5Ua1pNt8BqGp4I0FJZhuVSOj3PaBPni4azWuSzEdNn2evevzVmEk1ohQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "find-up-simple": "^1.0.0",
+        "read-pkg": "^9.0.0",
+        "type-fest": "^4.6.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/aggregate-error": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-5.0.0.tgz",
+      "integrity": "sha512-gOsf2YwSlleG6IjRYG2A7k0HmBMEo6qVNk9Bp/EaLgAJT5ngH6PXbqa4ItvnEwCm/velL5jAnQgsHsWnjhGmvw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "clean-stack": "^5.2.0",
+        "indent-string": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/ansi-regex": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+      "integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/semantic-release/node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/semantic-release/node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
+    "node_modules/semantic-release/node_modules/clean-stack": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-5.3.0.tgz",
+      "integrity": "sha512-9ngPTOhYGQqNVSfeJkYXHmF7AGWp4/nN5D/QqNQs3Dvxd1Kk/WpjHfNujKHYUQ/5CoGyOyFNoWSPk5afzP0QVg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "escape-string-regexp": "5.0.0"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/cliui": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
+      "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^7.2.0",
+        "strip-ansi": "^7.1.0",
+        "wrap-ansi": "^9.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/semantic-release/node_modules/conventional-changelog-angular": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/conventional-changelog-angular/-/conventional-changelog-angular-8.3.0.tgz",
+      "integrity": "sha512-DOuBwYSqWzfwuRByY9O4oOIvDlkUCTDzfbOgcSbkY+imXXj+4tmrEFao3K+FxemClYfYnZzsvudbwrhje9VHDA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "compare-func": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/semantic-release/node_modules/conventional-changelog-writer": {
+      "version": "8.4.0",
+      "resolved": "https://registry.npmjs.org/conventional-changelog-writer/-/conventional-changelog-writer-8.4.0.tgz",
+      "integrity": "sha512-HHBFkk1EECxxmCi4CTu091iuDpQv5/OavuCUAuZmrkWpmYfyD816nom1CvtfXJ/uYfAAjavgHvXHX291tSLK8g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@simple-libs/stream-utils": "^1.2.0",
+        "conventional-commits-filter": "^5.0.0",
+        "handlebars": "^4.7.7",
+        "meow": "^13.0.0",
+        "semver": "^7.5.2"
+      },
+      "bin": {
+        "conventional-changelog-writer": "dist/cli/index.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/semantic-release/node_modules/conventional-commits-filter": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/conventional-commits-filter/-/conventional-commits-filter-5.0.0.tgz",
+      "integrity": "sha512-tQMagCOC59EVgNZcC5zl7XqO30Wki9i9J3acbUvkaosCT6JX3EeFwJD7Qqp4MCikRnzS18WXV3BLIQ66ytu6+Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/semantic-release/node_modules/conventional-commits-parser": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/conventional-commits-parser/-/conventional-commits-parser-6.3.0.tgz",
+      "integrity": "sha512-RfOq/Cqy9xV9bOA8N+ZH6DlrDR+5S3Mi0B5kACEjESpE+AviIpAptx9a9cFpWCCvgRtWT+0BbUw+e1BZfts9jg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@simple-libs/stream-utils": "^1.2.0",
+        "meow": "^13.0.0"
+      },
+      "bin": {
+        "conventional-commits-parser": "dist/cli/index.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/semantic-release/node_modules/cosmiconfig": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/cosmiconfig/-/cosmiconfig-9.0.1.tgz",
+      "integrity": "sha512-hr4ihw+DBqcvrsEDioRO31Z17x71pUYoNe/4h6Z0wB72p7MU7/9gH8Q3s12NFhHPfYBBOV3qyfUxmr/Yn3shnQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "env-paths": "^2.2.1",
+        "import-fresh": "^3.3.0",
+        "js-yaml": "^4.1.0",
+        "parse-json": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/d-fischer"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.9.5"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/semantic-release/node_modules/emoji-regex": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+      "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/semantic-release/node_modules/escape-string-regexp": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+      "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/execa": {
+      "version": "9.6.1",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-9.6.1.tgz",
+      "integrity": "sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sindresorhus/merge-streams": "^4.0.0",
+        "cross-spawn": "^7.0.6",
+        "figures": "^6.1.0",
+        "get-stream": "^9.0.0",
+        "human-signals": "^8.0.1",
+        "is-plain-obj": "^4.1.0",
+        "is-stream": "^4.0.1",
+        "npm-run-path": "^6.0.0",
+        "pretty-ms": "^9.2.0",
+        "signal-exit": "^4.1.0",
+        "strip-final-newline": "^4.0.0",
+        "yoctocolors": "^2.1.1"
+      },
+      "engines": {
+        "node": "^18.19.0 || >=20.5.0"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/execa?sponsor=1"
+      }
+    },
+    "node_modules/semantic-release/node_modules/execa/node_modules/get-stream": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-9.0.1.tgz",
+      "integrity": "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sec-ant/readable-stream": "^0.4.1",
+        "is-stream": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/figures": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/figures/-/figures-6.1.0.tgz",
+      "integrity": "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-unicode-supported": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/find-versions": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/find-versions/-/find-versions-6.0.0.tgz",
+      "integrity": "sha512-2kCCtc+JvcZ86IGAz3Z2Y0A1baIz9fL31pH/0S1IqZr9Iwnjq8izfPtrCyQKO6TLMPELLsQMre7VDqeIKCsHkA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "semver-regex": "^4.0.5",
+        "super-regex": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/hosted-git-info": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-9.0.2.tgz",
+      "integrity": "sha512-M422h7o/BR3rmCQ8UHi7cyyMqKltdP9Uo+J2fXK+RSAY+wTcKOIRyhTuKv4qn+DJf3g+PL890AzId5KZpX+CBg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^11.1.0"
+      },
+      "engines": {
+        "node": "^20.17.0 || >=22.9.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/human-signals": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-8.0.1.tgz",
+      "integrity": "sha512-eKCa6bwnJhvxj14kZk5NCPc6Hb6BdsU9DZcOnmQKSnO1VKrfV0zCvtttPZUsBvjmNDn8rpcJfpwSYnHBjc95MQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18.18.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/indent-string": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-5.0.0.tgz",
+      "integrity": "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/into-stream": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/into-stream/-/into-stream-7.0.0.tgz",
+      "integrity": "sha512-2dYz766i9HprMBasCMvHMuazJ7u4WzhJwo5kb3iPSiW/iRYV6uPari3zHoqZlnuaR7V1bEiNMxikhp37rdBXbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "from2": "^2.3.0",
+        "p-is-promise": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/is-plain-obj": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",
+      "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/is-stream": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-4.0.1.tgz",
+      "integrity": "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/js-yaml": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz",
+      "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/semantic-release/node_modules/lru-cache": {
+      "version": "11.2.6",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.6.tgz",
+      "integrity": "sha512-ESL2CrkS/2wTPfuend7Zhkzo2u0daGJ/A2VucJOgQ/C48S/zB8MMeMHSGKYpXhIjbPxfuezITkaBH1wqv00DDQ==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": "20 || >=22"
+      }
+    },
+    "node_modules/semantic-release/node_modules/meow": {
+      "version": "13.2.0",
+      "resolved": "https://registry.npmjs.org/meow/-/meow-13.2.0.tgz",
+      "integrity": "sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/normalize-package-data": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-6.0.2.tgz",
+      "integrity": "sha512-V6gygoYb/5EmNI+MEGrWkC+e6+Rr7mTmfHrxDbLzxQogBkgzo76rkok0Am6thgSF7Mv2nLOajAJj5vDJZEFn7g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "dependencies": {
+        "hosted-git-info": "^7.0.0",
+        "semver": "^7.3.5",
+        "validate-npm-package-license": "^3.0.4"
+      },
+      "engines": {
+        "node": "^16.14.0 || >=18.0.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/normalize-package-data/node_modules/hosted-git-info": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-7.0.2.tgz",
+      "integrity": "sha512-puUZAUKT5m8Zzvs72XWy3HtvVbTWljRE66cP60bxJzAqf2DgICo7lYTY2IHUmLnNpjYvw5bvmoHvPc0QO2a62w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "lru-cache": "^10.0.1"
+      },
+      "engines": {
+        "node": "^16.14.0 || >=18.0.0"
+      }
+    },
+    "node_modules/semantic-release/node_modules/normalize-package-data/node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/semantic-release/node_modules/npm-run-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-6.0.0.tgz",
+      "integrity": "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^4.0.0",
+        "unicorn-magic": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/p-reduce": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/p-reduce/-/p-reduce-3.0.0.tgz",
+      "integrity": "sha512-xsrIUgI0Kn6iyDYm9StOpOeK29XM1aboGji26+QEortiFST1hGZaUQOLhtEbqHErPpGW/aSz6allwK2qcptp0Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/path-key": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-4.0.0.tgz",
+      "integrity": "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/read-pkg": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-9.0.1.tgz",
+      "integrity": "sha512-9viLL4/n1BJUCT1NXVTdS1jtm80yDEgR5T4yCelII49Mbj0v1rZdKqj7zCiYdbB0CuCgdrvHcNogAKTFPBocFA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/normalize-package-data": "^2.4.3",
+        "normalize-package-data": "^6.0.0",
+        "parse-json": "^8.0.0",
+        "type-fest": "^4.6.0",
+        "unicorn-magic": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/read-pkg/node_modules/parse-json": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-8.3.0.tgz",
+      "integrity": "sha512-ybiGyvspI+fAoRQbIPRddCcSTV9/LsJbf0e/S85VLowVGzRmokfneg2kwVW/KU5rOXrPSbF1qAKPMgNTqqROQQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@babel/code-frame": "^7.26.2",
+        "index-to-position": "^1.1.0",
+        "type-fest": "^4.39.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/read-pkg/node_modules/unicorn-magic": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.1.0.tgz",
+      "integrity": "sha512-lRfVq8fE8gz6QMBuDM6a+LO3IAzTi05H6gCVaUpir2E1Rwpo4ZUog45KpNXKC/Mn3Yb9UDuHumeFTo9iV/D9FQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/semantic-release/node_modules/semver-regex": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/semver-regex/-/semver-regex-4.0.5.tgz",
+      "integrity": "sha512-hunMQrEy1T6Jr2uEVjrAIqjwWcQTgOAcIM52C8MY1EZSD3DDNft04XzvYKPqjED65bNVVko0YI38nYeEHCX3yw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/semantic-release/node_modules/string-width": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+      "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^10.3.0",
+        "get-east-asian-width": "^1.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/strip-ansi": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+      "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^6.2.2"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/semantic-release/node_modules/strip-final-newline": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-4.0.0.tgz",
+      "integrity": "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/type-fest": {
+      "version": "4.41.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-4.41.0.tgz",
+      "integrity": "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/semantic-release/node_modules/wrap-ansi": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",
+      "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "string-width": "^7.0.0",
+        "strip-ansi": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/semantic-release/node_modules/yargs": {
+      "version": "18.0.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.0.0.tgz",
+      "integrity": "sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^9.0.1",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "string-width": "^7.2.0",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^22.0.0"
+      },
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
+      }
+    },
+    "node_modules/semantic-release/node_modules/yargs-parser": {
+      "version": "22.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz",
+      "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
       }
     },
     "node_modules/semver": {
@@ -12550,27 +13766,6 @@
       "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
       "dev": true
     },
-    "node_modules/semver-diff": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/semver-diff/-/semver-diff-3.1.1.tgz",
-      "integrity": "sha512-GX0Ix/CJcHyB8c4ykpHGIAvLyOwOobtM/8d+TQkAd81/bEjgPHrfba41Vpesr7jX/t8Uh+R3EX9eAS5be+jQYg==",
-      "dev": true,
-      "dependencies": {
-        "semver": "^6.3.0"
-      },
-      "engines": {
-        "node": ">=8"
-      }
-    },
-    "node_modules/semver-diff/node_modules/semver": {
-      "version": "6.3.0",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.0.tgz",
-      "integrity": "sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw==",
-      "dev": true,
-      "bin": {
-        "semver": "bin/semver.js"
-      }
-    },
     "node_modules/semver-regex": {
       "version": "3.1.4",
       "resolved": "https://registry.npmjs.org/semver-regex/-/semver-regex-3.1.4.tgz",
@@ -12834,6 +14029,19 @@
       "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
       "dev": true
     },
+    "node_modules/skin-tone": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/skin-tone/-/skin-tone-2.0.0.tgz",
+      "integrity": "sha512-kUMbT1oBJCpgrnKoSr0o6wPtvRWT9W9UKvGLwfJYO2WuahZRHOpEyL1ckyMGgMWh0UdpmaoFqKKD29WTomNEGA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "unicode-emoji-modifier-base": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/slash": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
@@ -13178,6 +14386,24 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/super-regex": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/super-regex/-/super-regex-1.1.0.tgz",
+      "integrity": "sha512-WHkws2ZflZe41zj6AolvvmaTrWds/VuyeYr9iPVv/oQeaIoVxMKaushfFWpOGDT+GuBrM/sVqF8KUCYQlSSTdQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "function-timeout": "^1.0.1",
+        "make-asynchronous": "^1.0.1",
+        "time-span": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/superagent": {
       "version": "3.8.3",
       "resolved": "https://registry.npmjs.org/superagent/-/superagent-3.8.3.tgz",
@@ -13266,16 +14492,20 @@
       }
     },
     "node_modules/supports-hyperlinks": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/supports-hyperlinks/-/supports-hyperlinks-2.3.0.tgz",
-      "integrity": "sha512-RpsAZlpWcDwOPQA22aCH4J0t7L8JmAvsCxfOSEwm7cQs3LshN36QaTkwd70DnBOXDWGssw2eUoc8CaRWT0XunA==",
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/supports-hyperlinks/-/supports-hyperlinks-3.2.0.tgz",
+      "integrity": "sha512-zFObLMyZeEwzAoKCyu1B91U79K2t7ApXuQfo8OuxwXLDgcKxuwM+YvcbIhm6QWqz7mHUH1TVytR1PwVVjEuMig==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "has-flag": "^4.0.0",
         "supports-color": "^7.0.0"
       },
       "engines": {
-        "node": ">=8"
+        "node": ">=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-hyperlinks?sponsor=1"
       }
     },
     "node_modules/supports-preserve-symlinks-flag": {
@@ -13334,41 +14564,69 @@
       "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
       "dev": true
     },
-    "node_modules/temp-dir": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-2.0.0.tgz",
-      "integrity": "sha512-aoBAniQmmwtcKp/7BzsH8Cxzv8OL736p7v1ihGb5e9DJ9kTwGWHrQrVB5+lfVDzfGrdRzXch+ig7LHaY1JTOrg==",
+    "node_modules/tagged-tag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/tagged-tag/-/tagged-tag-1.0.0.tgz",
+      "integrity": "sha512-yEFYrVhod+hdNyx7g5Bnkkb0G6si8HJurOoOEgC8B/O0uXLHlaey/65KRv6cuWBNhBgHKAROVpc7QyYqE5gFng==",
       "dev": true,
+      "license": "MIT",
       "engines": {
-        "node": ">=8"
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/temp-dir": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-3.0.0.tgz",
+      "integrity": "sha512-nHc6S/bwIilKHNRgK/3jlhDoIHcp45YgyiwcAk46Tr0LfEqGBVpmiAyuiuxeVE44m3mXnEeVhaipLOEWmH+Njw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.16"
       }
     },
     "node_modules/tempy": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/tempy/-/tempy-1.0.1.tgz",
-      "integrity": "sha512-biM9brNqxSc04Ee71hzFbryD11nX7VPhQQY32AdDmjFvodsRFz/3ufeoTZ6uYkRFfGo188tENcASNs3vTdsM0w==",
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/tempy/-/tempy-3.2.0.tgz",
+      "integrity": "sha512-d79HhZya5Djd7am0q+W4RTsSU+D/aJzM+4Y4AGJGuGlgM2L6sx5ZvOYTmZjqPhrDrV6xJTtRSm1JCLj6V6LHLQ==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "del": "^6.0.0",
-        "is-stream": "^2.0.0",
-        "temp-dir": "^2.0.0",
-        "type-fest": "^0.16.0",
-        "unique-string": "^2.0.0"
+        "is-stream": "^3.0.0",
+        "temp-dir": "^3.0.0",
+        "type-fest": "^2.12.2",
+        "unique-string": "^3.0.0"
       },
       "engines": {
-        "node": ">=10"
+        "node": ">=14.16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tempy/node_modules/is-stream": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-3.0.0.tgz",
+      "integrity": "sha512-LnQR4bZ9IADDRSkvpqMGvt/tEJWclzklNgSw48V5EAaAeDd6qGvN8ei6k5p0tvxSR171VmGyHuTiAOfxAbr8kA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/tempy/node_modules/type-fest": {
-      "version": "0.16.0",
-      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.16.0.tgz",
-      "integrity": "sha512-eaBzG6MxNzEn9kiwvtre90cXaNLkmadMWa1zQMs3XORCXNbsH/OewwbxC5ia9dCxIxnTAsSxXJaa/p5y8DlvJg==",
+      "version": "2.19.0",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-2.19.0.tgz",
+      "integrity": "sha512-RAH822pAdBgcNMAfWnCBU3CFZcfZ/i1eZjwFU/dsLKumyuuP3niueg2UAukXYF0E2AAoc82ZSSf9J0WQBinzHA==",
       "dev": true,
+      "license": "(MIT OR CC0-1.0)",
       "engines": {
-        "node": ">=10"
+        "node": ">=12.20"
       },
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
@@ -13403,6 +14661,29 @@
       "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==",
       "dev": true
     },
+    "node_modules/thenify": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/thenify/-/thenify-3.3.1.tgz",
+      "integrity": "sha512-RVZSIV5IG10Hk3enotrhvz0T9em6cyHBLkH/YAZuKqd8hRkKhSfCGIcP2KUY0EPxndzANBmNllzWPwak+bheSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "any-promise": "^1.0.0"
+      }
+    },
+    "node_modules/thenify-all": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/thenify-all/-/thenify-all-1.6.0.tgz",
+      "integrity": "sha512-RNxQH/qI8/t3thXJDwcstUO4zeqo64+Uy/+sNVRBx4Xn2OX+OZ9oP+iJnNFqplFra2ZUVeKCSa2oVWi3T4uVmA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "thenify": ">= 3.1.0 < 4"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/through": {
       "version": "2.3.8",
       "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz",
@@ -13418,6 +14699,70 @@
         "readable-stream": "3"
       }
     },
+    "node_modules/time-span": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/time-span/-/time-span-5.1.0.tgz",
+      "integrity": "sha512-75voc/9G4rDIJleOo4jPvN4/YC4GRZrY8yy1uU4lwrB3XEQbWve8zXoO5No4eFrGcTAMYyoY67p8jRQdtA1HbA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "convert-hrtime": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.5.0",
+        "picomatch": "^4.0.3"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tinyglobby/node_modules/fdir": {
+      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/tinyglobby/node_modules/picomatch": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
     "node_modules/tmp": {
       "version": "0.0.33",
       "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
@@ -13606,6 +14951,16 @@
       "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
       "dev": true
     },
+    "node_modules/tunnel": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/tunnel/-/tunnel-0.0.6.tgz",
+      "integrity": "sha512-1h/Lnq9yajKY2PEbBadPXj3VxsDDu844OnaAo52UVmIzIvwwtBPIuNvkjuzBlTWpfJyUbG3ez0KSBibQkj4ojg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6.11 <=0.7.0 || >=0.7.3"
+      }
+    },
     "node_modules/tunnel-agent": {
       "version": "0.6.0",
       "resolved": "https://registry.npmjs.org/tunnel-agent/-/tunnel-agent-0.6.0.tgz",
@@ -13797,29 +15152,67 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/undici": {
+      "version": "6.23.0",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-6.23.0.tgz",
+      "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.17"
+      }
+    },
     "node_modules/undici-types": {
       "version": "6.18.2",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.18.2.tgz",
       "integrity": "sha512-5ruQbENj95yDYJNS3TvcaxPMshV7aizdv/hWYjGIKoANWKjhWNBsr2YEuYZKodQulB1b8l7ILOuDQep3afowQQ==",
       "dev": true
     },
-    "node_modules/unique-string": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-2.0.0.tgz",
-      "integrity": "sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg==",
+    "node_modules/unicode-emoji-modifier-base": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unicode-emoji-modifier-base/-/unicode-emoji-modifier-base-1.0.0.tgz",
+      "integrity": "sha512-yLSH4py7oFH3oG/9K+XWrz1pSi3dfUrWEnInbxMfArOfc1+33BlGPQtLsOYwvdMy11AwUBetYuaRxSPqgkq+8g==",
       "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/unicorn-magic": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.3.0.tgz",
+      "integrity": "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/unique-string": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/unique-string/-/unique-string-3.0.0.tgz",
+      "integrity": "sha512-VGXBUVwxKMBUznyffQweQABPRRW1vHZAbadFZud4pLFAqRGvv/96vafgjWFqzourzr8YonlQiPgH0YCJfawoGQ==",
+      "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "crypto-random-string": "^2.0.0"
+        "crypto-random-string": "^4.0.0"
       },
       "engines": {
-        "node": ">=8"
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
       }
     },
     "node_modules/universal-user-agent": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/universal-user-agent/-/universal-user-agent-6.0.0.tgz",
-      "integrity": "sha512-isyNax3wXoKaulPDZWHQqbmIx1k2tb9fb3GGDBRxCscfYV2Ch7WxPArBsFEG8s/safwXTT7H4QGhaIkTp9447w==",
-      "dev": true
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/universal-user-agent/-/universal-user-agent-7.0.3.tgz",
+      "integrity": "sha512-TmnEAEAsBJVZM/AADELsK76llnwcf9vMKuPz8JflO1frO8Lchitr0fNaN9d+Ap0BjKtqWqd/J17qeDnXh8CL2A==",
+      "dev": true,
+      "license": "ISC"
     },
     "node_modules/universalify": {
       "version": "2.0.0",
@@ -13887,10 +15280,14 @@
       }
     },
     "node_modules/url-join": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz",
-      "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==",
-      "dev": true
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/url-join/-/url-join-5.0.0.tgz",
+      "integrity": "sha512-n2huDr9h9yzd6exQVnH/jU5mr+Pfx08LRXXZhkLLetAMESRj+anQsTAh940iMrIetKAmry9coFuZQ2jY8/p3WA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+      }
     },
     "node_modules/url-parse": {
       "version": "1.5.10",
@@ -14023,6 +15420,13 @@
         "makeerror": "1.0.12"
       }
     },
+    "node_modules/web-worker": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/web-worker/-/web-worker-1.5.0.tgz",
+      "integrity": "sha512-RiMReJrTAiA+mBjGONMnjVDP2u3p9R1vkcGz6gDIrOMT3oGuYwX2WRMYI9ipkphSuE5XKEhydbhNEJh4NY9mlw==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
     "node_modules/webidl-conversions": {
       "version": "3.0.1",
       "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
@@ -14275,6 +15679,19 @@
       "funding": {
         "url": "https://github.com/sponsors/sindresorhus"
       }
+    },
+    "node_modules/yoctocolors": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/yoctocolors/-/yoctocolors-2.1.2.tgz",
+      "integrity": "sha512-CzhO+pFNo8ajLM2d2IW/R93ipy99LWjtwblvC1RsoSUMZgyLbYFr221TnSNT7GjGdYui6P459mw9JH/g/zW2ug==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
     }
   }
 }
diff --git a/package.json b/package.json
index ac31e6ea6..7e9a8ab50 100644
--- a/package.json
+++ b/package.json
@@ -68,7 +68,7 @@
     "@semantic-release/changelog": "^6.0.2",
     "@semantic-release/commit-analyzer": "^9.0.2",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/npm": "^9.0.2",
+    "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^10.0.3",
     "@types/benchmark": "^1.0.31",
     "@types/express": "^4.17.2",
@@ -100,7 +100,7 @@
     "rollup-plugin-typescript2": "^0.31.1",
     "rollup-plugin-uglify": "^6.0.4",
     "rollup-plugin-version-injector": "^1.3.3",
-    "semantic-release": "^19.0.3",
+    "semantic-release": "^25.0.3",
     "sinon": "^15.0.2",
     "supertest": "^3.4.2",
     "ts-jest": "^29.0.5",

From 93c38c7c6d1f3e4a3c64fc5f205cf6bff4be46a6 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sat, 7 Mar 2026 20:01:42 +0000
Subject: [PATCH 10/64] chore(release): 10.25.0 [skip ci]

# [10.25.0](https://github.com/harttle/liquidjs/compare/v10.24.0...v10.25.0) (2026-03-07)

### Bug Fixes

* path traversal vulnerability, [#851](https://github.com/harttle/liquidjs/issues/851) ([#855](https://github.com/harttle/liquidjs/issues/855)) ([3cd024d](https://github.com/harttle/liquidjs/commit/3cd024d652dc883c46307581e979fe32302adbac))

### Features

* export error types, resolving [#837](https://github.com/harttle/liquidjs/issues/837) ([#840](https://github.com/harttle/liquidjs/issues/840)) ([71aa1b1](https://github.com/harttle/liquidjs/commit/71aa1b1998a3a66e536af67c6ea8947a28616eaf))
---
 CHANGELOG.md      | 12 ++++++++++++
 package-lock.json |  4 ++--
 package.json      |  2 +-
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 872f4b81e..c19619bfe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,15 @@
+# [10.25.0](https://github.com/harttle/liquidjs/compare/v10.24.0...v10.25.0) (2026-03-07)
+
+
+### Bug Fixes
+
+* path traversal vulnerability, [#851](https://github.com/harttle/liquidjs/issues/851) ([#855](https://github.com/harttle/liquidjs/issues/855)) ([3cd024d](https://github.com/harttle/liquidjs/commit/3cd024d652dc883c46307581e979fe32302adbac))
+
+
+### Features
+
+* export error types, resolving [#837](https://github.com/harttle/liquidjs/issues/837) ([#840](https://github.com/harttle/liquidjs/issues/840)) ([71aa1b1](https://github.com/harttle/liquidjs/commit/71aa1b1998a3a66e536af67c6ea8947a28616eaf))
+
 # [10.24.0](https://github.com/harttle/liquidjs/compare/v10.23.0...v10.24.0) (2025-10-27)
 
 
diff --git a/package-lock.json b/package-lock.json
index 9d2fd8d94..eb1207c78 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.24.0",
+  "version": "10.25.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.24.0",
+      "version": "10.25.0",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 7e9a8ab50..4308cb985 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.24.0",
+  "version": "10.25.0",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 1b85fdaa9c535021f7030a239a64003af26d31b5 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 8 Mar 2026 15:41:45 +0800
Subject: [PATCH 11/64] docs: update contact in security.md (#862)

---
 SECURITY.md               | 2 +-
 demo/browser/package.json | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/SECURITY.md b/SECURITY.md
index 3f59961df..c3fcbdd97 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -6,7 +6,7 @@ Only the latest major version is supported with security updates. It can be chan
 
 ## Reporting a Vulnerability
 
-Please contact yangjvn@126.com to report a vulnerability or change request.
+Please contact harttleharttle@gmail.com to report a vulnerability or change request.
 
 - If the vulnerability in question affects common use cases, it will be treated as a bug and fixed very soon (typically within 1 week).
 - Otherwise, it'll be scheduled in the same priority of feature request (which is lower than bugs).
diff --git a/demo/browser/package.json b/demo/browser/package.json
index 326b959ff..e71554cba 100644
--- a/demo/browser/package.json
+++ b/demo/browser/package.json
@@ -8,7 +8,7 @@
     "test": "echo not implemented",
     "start": "http-server -c-1 "
   },
-  "author": "harttle <yangjvn@126.com>",
+  "author": "harttle <harttleharttle@gmail.com>",
   "license": "ISC",
   "dependencies": {
     "http-server": "^0.11.1",

From 95ddefc056a11a44d9e753fd47a39db2c241e578 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Thu, 19 Mar 2026 21:20:57 +0800
Subject: [PATCH 12/64] fix: mem limiter for invalid ranges

---
 src/util/limiter.ts | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/util/limiter.ts b/src/util/limiter.ts
index 32c6c7815..f241f5e53 100644
--- a/src/util/limiter.ts
+++ b/src/util/limiter.ts
@@ -9,12 +9,14 @@ export class Limiter {
     this.limit = limit
   }
   use (count: number) {
-    count = +count || 0
-    assert(this.base + count <= this.limit, this.message)
-    this.base += count
+    if (+count > 0) {
+      assert(this.base + +count <= this.limit, this.message)
+      this.base += +count
+    }
   }
   check (count: number) {
-    count = +count || 0
-    assert(count <= this.limit, this.message)
+    if (+count > 0) {
+      assert(+count <= this.limit, this.message)
+    }
   }
 }

From 94440a065333c78dee461af0049dd712c35f9e45 Mon Sep 17 00:00:00 2001
From: Harttle <yangjvn@126.com>
Date: Sun, 22 Mar 2026 22:10:05 +0800
Subject: [PATCH 13/64] chore: more strict mem limit for string filters

---
 src/filters/string.ts  | 67 +++++++++++++++++++++++++++---------------
 src/fs/loader.ts       |  6 ++--
 src/util/underscore.ts |  4 ---
 3 files changed, 47 insertions(+), 30 deletions(-)

diff --git a/src/filters/string.ts b/src/filters/string.ts
index ec163d717..944857eeb 100644
--- a/src/filters/string.ts
+++ b/src/filters/string.ts
@@ -11,7 +11,7 @@
 // Hiragana (Japanese): \u3040-\u309F
 // Hangul (Korean): \uAC00-\uD7AF
 import { FilterImpl } from '../template'
-import { assert, escapeRegExp, stringify } from '../util'
+import { assert, stringify } from '../util'
 
 const rCJKWord = /[\u4E00-\u9FFF\uF900-\uFAFF\u3400-\u4DBF\u3040-\u309F\u30A0-\u30FF\uAC00-\uD7AF]/gu
 
@@ -38,10 +38,14 @@ export function lstrip (this: FilterImpl, v: string, chars?: string) {
   const str = stringify(v)
   this.context.memoryLimit.use(str.length)
   if (chars) {
-    chars = escapeRegExp(stringify(chars))
-    return str.replace(new RegExp(`^[${chars}]+`, 'g'), '')
+    chars = stringify(chars)
+    this.context.memoryLimit.use(chars.length)
+    for (let i = 0, set = new Set(chars); i < str.length; i++) {
+      if (!set.has(str[i])) return str.slice(i)
+    }
+    return ''
   }
-  return str.replace(/^\s+/, '')
+  return str.trimStart()
 }
 
 export function downcase (this: FilterImpl, v: string) {
@@ -58,20 +62,22 @@ export function upcase (this: FilterImpl, v: string) {
 
 export function remove (this: FilterImpl, v: string, arg: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
-  return str.split(stringify(arg)).join('')
+  arg = stringify(arg)
+  this.context.memoryLimit.use(str.length + arg.length)
+  return str.split(arg).join('')
 }
 
 export function remove_first (this: FilterImpl, v: string, l: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
-  return str.replace(stringify(l), '')
+  l = stringify(l)
+  this.context.memoryLimit.use(str.length + l.length)
+  return str.replace(l, '')
 }
 
 export function remove_last (this: FilterImpl, v: string, l: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
   const pattern = stringify(l)
+  this.context.memoryLimit.use(str.length + pattern.length)
   const index = str.lastIndexOf(pattern)
   if (index === -1) return str
   return str.substring(0, index) + str.substring(index + pattern.length)
@@ -81,10 +87,14 @@ export function rstrip (this: FilterImpl, str: string, chars?: string) {
   str = stringify(str)
   this.context.memoryLimit.use(str.length)
   if (chars) {
-    chars = escapeRegExp(stringify(chars))
-    return str.replace(new RegExp(`[${chars}]+$`, 'g'), '')
+    chars = stringify(chars)
+    this.context.memoryLimit.use(chars.length)
+    for (let i = str.length - 1, set = new Set(chars); i >= 0; i--) {
+      if (!set.has(str[i])) return str.slice(0, i + 1)
+    }
+    return ''
   }
-  return str.replace(/\s+$/, '')
+  return str.trimEnd()
 }
 
 export function split (this: FilterImpl, v: string, arg: string) {
@@ -101,10 +111,13 @@ export function strip (this: FilterImpl, v: string, chars?: string) {
   const str = stringify(v)
   this.context.memoryLimit.use(str.length)
   if (chars) {
-    chars = escapeRegExp(stringify(chars))
-    return str
-      .replace(new RegExp(`^[${chars}]+`, 'g'), '')
-      .replace(new RegExp(`[${chars}]+$`, 'g'), '')
+    const set = new Set(stringify(chars))
+    this.context.memoryLimit.use(set.size)
+    let i = 0
+    let j = str.length - 1
+    while (set.has(str[i])) i++
+    while (j >= i && set.has(str[j])) j--
+    return str.slice(i, j + 1)
   }
   return str.trim()
 }
@@ -123,36 +136,43 @@ export function capitalize (this: FilterImpl, str: string) {
 
 export function replace (this: FilterImpl, v: string, pattern: string, replacement: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
-  return str.split(stringify(pattern)).join(replacement)
+  pattern = stringify(pattern)
+  this.context.memoryLimit.use(str.length + pattern.length + replacement.length)
+  return str.split(pattern).join(replacement)
 }
 
 export function replace_first (this: FilterImpl, v: string, arg1: string, arg2: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
-  return str.replace(stringify(arg1), arg2)
+  arg1 = stringify(arg1)
+  arg2 = stringify(arg2)
+  this.context.memoryLimit.use(str.length + arg1.length + arg2.length)
+  return str.replace(arg1, arg2)
 }
 
 export function replace_last (this: FilterImpl, v: string, arg1: string, arg2: string) {
   const str = stringify(v)
   this.context.memoryLimit.use(str.length)
   const pattern = stringify(arg1)
+  this.context.memoryLimit.use(pattern.length)
   const index = str.lastIndexOf(pattern)
   if (index === -1) return str
   const replacement = stringify(arg2)
+  this.context.memoryLimit.use(replacement.length)
   return str.substring(0, index) + replacement + str.substring(index + pattern.length)
 }
 
 export function truncate (this: FilterImpl, v: string, l = 50, o = '...') {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
+  o = stringify(o)
+  this.context.memoryLimit.use(str.length + o.length)
   if (str.length <= l) return v
   return str.substring(0, l - o.length) + o
 }
 
 export function truncatewords (this: FilterImpl, v: string, words = 15, o = '...') {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
+  o = stringify(o)
+  this.context.memoryLimit.use(str.length + o.length)
   const arr = str.split(/\s+/)
   if (words <= 0) words = 1
   let ret = arr.slice(0, words).join(' ')
@@ -187,7 +207,8 @@ export function number_of_words (this: FilterImpl, input: string, mode?: 'cjk' |
 }
 
 export function array_to_sentence_string (this: FilterImpl, array: unknown[], connector = 'and') {
-  this.context.memoryLimit.use(array.length)
+  connector = stringify(connector)
+  this.context.memoryLimit.use(array.length + connector.length)
   switch (array.length) {
     case 0:
       return ''
diff --git a/src/fs/loader.ts b/src/fs/loader.ts
index 62c061a1a..2c58e231c 100644
--- a/src/fs/loader.ts
+++ b/src/fs/loader.ts
@@ -1,5 +1,5 @@
 import { FS } from './fs'
-import { assert, escapeRegex } from '../util'
+import { assert } from '../util'
 
 export interface LoaderOptions {
   fs: FS;
@@ -24,8 +24,8 @@ export class Loader {
     if (options.relativeReference) {
       const sep = options.fs.sep
       assert(sep, '`fs.sep` is required for relative reference')
-      const rRelativePath = new RegExp(['.' + sep, '..' + sep, './', '../'].map(prefix => escapeRegex(prefix)).join('|'))
-      this.shouldLoadRelative = (referencedFile: string) => rRelativePath.test(referencedFile)
+      const prefixes = ['.' + sep, '..' + sep, './', '../']
+      this.shouldLoadRelative = (referencedFile: string) => prefixes.some(prefix => referencedFile.startsWith(prefix))
     } else {
       this.shouldLoadRelative = (_referencedFile: string) => false
     }
diff --git a/src/util/underscore.ts b/src/util/underscore.ts
index 617a32b07..ad829e0bc 100644
--- a/src/util/underscore.ts
+++ b/src/util/underscore.ts
@@ -22,10 +22,6 @@ export function isIterator (val: any): val is IterableIterator<any> {
   return val && isFunction(val.next) && isFunction(val.throw) && isFunction(val.return)
 }
 
-export function escapeRegex (str: string) {
-  return str.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&')
-}
-
 export function promisify<T1, T2> (fn: (arg1: T1, cb: (err: Error | null, result: T2) => void) => void): (arg1: T1) => Promise<T2>;
 export function promisify<T1, T2, T3> (fn: (arg1: T1, arg2: T2, cb: (err: Error | null, result: T3) => void) => void): (arg1: T1, arg2: T2) => Promise<T3>;
 export function promisify (fn: any) {

From 35d523026345d80458df24c72e653db78b5d061d Mon Sep 17 00:00:00 2001
From: Harttle <yangjvn@126.com>
Date: Sun, 22 Mar 2026 22:16:45 +0800
Subject: [PATCH 14/64] fix: treat args for replace_first as literal

---
 src/filters/string.ts | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/src/filters/string.ts b/src/filters/string.ts
index 944857eeb..fe012fb2f 100644
--- a/src/filters/string.ts
+++ b/src/filters/string.ts
@@ -146,18 +146,16 @@ export function replace_first (this: FilterImpl, v: string, arg1: string, arg2:
   arg1 = stringify(arg1)
   arg2 = stringify(arg2)
   this.context.memoryLimit.use(str.length + arg1.length + arg2.length)
-  return str.replace(arg1, arg2)
+  return str.replace(arg1, () => arg2)
 }
 
 export function replace_last (this: FilterImpl, v: string, arg1: string, arg2: string) {
   const str = stringify(v)
-  this.context.memoryLimit.use(str.length)
   const pattern = stringify(arg1)
-  this.context.memoryLimit.use(pattern.length)
+  const replacement = stringify(arg2)
+  this.context.memoryLimit.use(str.length + pattern.length + replacement.length)
   const index = str.lastIndexOf(pattern)
   if (index === -1) return str
-  const replacement = stringify(arg2)
-  this.context.memoryLimit.use(replacement.length)
   return str.substring(0, index) + replacement + str.substring(index + pattern.length)
 }
 

From 97d829116c6774d8608f65b2bb41905ab4c8eddf Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 22 Mar 2026 14:18:52 +0000
Subject: [PATCH 15/64] chore(release): 10.25.1 [skip ci]

## [10.25.1](https://github.com/harttle/liquidjs/compare/v10.25.0...v10.25.1) (2026-03-22)

### Bug Fixes

* mem limiter for invalid ranges ([95ddefc](https://github.com/harttle/liquidjs/commit/95ddefc056a11a44d9e753fd47a39db2c241e578))
* treat args for replace_first as literal ([35d5230](https://github.com/harttle/liquidjs/commit/35d523026345d80458df24c72e653db78b5d061d))
---
 CHANGELOG.md      | 8 ++++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c19619bfe..74597d562 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [10.25.1](https://github.com/harttle/liquidjs/compare/v10.25.0...v10.25.1) (2026-03-22)
+
+
+### Bug Fixes
+
+* mem limiter for invalid ranges ([95ddefc](https://github.com/harttle/liquidjs/commit/95ddefc056a11a44d9e753fd47a39db2c241e578))
+* treat args for replace_first as literal ([35d5230](https://github.com/harttle/liquidjs/commit/35d523026345d80458df24c72e653db78b5d061d))
+
 # [10.25.0](https://github.com/harttle/liquidjs/compare/v10.24.0...v10.25.0) (2026-03-07)
 
 
diff --git a/package-lock.json b/package-lock.json
index eb1207c78..6f244f692 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.0",
+  "version": "10.25.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.0",
+      "version": "10.25.1",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 4308cb985..8b701f8e7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.0",
+  "version": "10.25.1",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 0ad2b11ab15e7da608a9ef936b2a00a6a6517038 Mon Sep 17 00:00:00 2001
From: Joe Cottam <44173086+joecottam@users.noreply.github.com>
Date: Wed, 25 Mar 2026 17:18:40 +0000
Subject: [PATCH 16/64] fix: handle undefined replacement argument in replace
 filter (#864)

---
 src/filters/string.ts                   | 1 +
 test/integration/filters/string.spec.ts | 8 ++++++++
 2 files changed, 9 insertions(+)

diff --git a/src/filters/string.ts b/src/filters/string.ts
index fe012fb2f..3ef570566 100644
--- a/src/filters/string.ts
+++ b/src/filters/string.ts
@@ -137,6 +137,7 @@ export function capitalize (this: FilterImpl, str: string) {
 export function replace (this: FilterImpl, v: string, pattern: string, replacement: string) {
   const str = stringify(v)
   pattern = stringify(pattern)
+  replacement = stringify(replacement)
   this.context.memoryLimit.use(str.length + pattern.length + replacement.length)
   return str.split(pattern).join(replacement)
 }
diff --git a/test/integration/filters/string.spec.ts b/test/integration/filters/string.spec.ts
index 9ea5bd088..1f0a93a33 100644
--- a/test/integration/filters/string.spec.ts
+++ b/test/integration/filters/string.spec.ts
@@ -109,6 +109,14 @@ describe('filters/string', function () {
     return test('{{ "Take my protein pills and put my helmet on" | replace: "my", "your" }}',
       'Take your protein pills and put your helmet on')
   })
+  it('should support replace with undefined replacement', function () {
+    return test('{{ "Take my protein pills and put my helmet on" | replace: "my" }}',
+      'Take  protein pills and put  helmet on')
+  })
+  it('should support replace with undefined variable as replacement', function () {
+    return test('{{ "Take my protein pills and put my helmet on" | replace: "my", missing_variable }}',
+      'Take  protein pills and put  helmet on')
+  })
   it('should support replace_first', function () {
     return test('{% assign my_string = "Take my protein pills and put my helmet on" %}\n' +
             '{{ my_string | replace_first: "my", "your" }}',

From 75e06eff92f4fa7e2c42277ac6527295730ee9b3 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 01:19:19 +0800
Subject: [PATCH 17/64] docs: add joecottam as a contributor for code (#865)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index bafc21df8..12904768f 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -802,6 +802,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "joecottam",
+      "name": "Joe Cottam",
+      "avatar_url": "https://avatars.githubusercontent.com/u/44173086?v=4",
+      "profile": "https://github.com/joecottam",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index 238e70963..7d5473e50 100644
--- a/README.md
+++ b/README.md
@@ -219,6 +219,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rongjiecomputer"><img src="https://avatars.githubusercontent.com/u/13115060?v=4?s=100" width="100px;" alt="Loo Rong Jie"/><br /><sub><b>Loo Rong Jie</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=rongjiecomputer" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/MorielHarush"><img src="https://avatars.githubusercontent.com/u/93482738?v=4?s=100" width="100px;" alt="MorielHarush"/><br /><sub><b>MorielHarush</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=MorielHarush" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://doruk.ch"><img src="https://avatars.githubusercontent.com/u/77903714?v=4?s=100" width="100px;" alt="Peak Twilight"/><br /><sub><b>Peak Twilight</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=peaktwilight" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/joecottam"><img src="https://avatars.githubusercontent.com/u/44173086?v=4?s=100" width="100px;" alt="Joe Cottam"/><br /><sub><b>Joe Cottam</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=joecottam" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From 521177e3f63c160c2e093cc4f2b151f51f333f45 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Wed, 25 Mar 2026 17:20:39 +0000
Subject: [PATCH 18/64] chore(release): 10.25.2 [skip ci]

## [10.25.2](https://github.com/harttle/liquidjs/compare/v10.25.1...v10.25.2) (2026-03-25)

### Bug Fixes

* handle undefined replacement argument in replace filter ([#864](https://github.com/harttle/liquidjs/issues/864)) ([0ad2b11](https://github.com/harttle/liquidjs/commit/0ad2b11ab15e7da608a9ef936b2a00a6a6517038))
---
 CHANGELOG.md      | 7 +++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 74597d562..99fca13cc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [10.25.2](https://github.com/harttle/liquidjs/compare/v10.25.1...v10.25.2) (2026-03-25)
+
+
+### Bug Fixes
+
+* handle undefined replacement argument in replace filter ([#864](https://github.com/harttle/liquidjs/issues/864)) ([0ad2b11](https://github.com/harttle/liquidjs/commit/0ad2b11ab15e7da608a9ef936b2a00a6a6517038))
+
 ## [10.25.1](https://github.com/harttle/liquidjs/compare/v10.25.0...v10.25.1) (2026-03-22)
 
 
diff --git a/package-lock.json b/package-lock.json
index 6f244f692..f8fb4133e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.1",
+  "version": "10.25.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.1",
+      "version": "10.25.2",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 8b701f8e7..dce665fe7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.1",
+  "version": "10.25.2",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From abc058be0f33d6372cd2216f4945183167abeb25 Mon Sep 17 00:00:00 2001
From: Harttle <yangjvn@126.com>
Date: Thu, 26 Mar 2026 19:35:40 +0800
Subject: [PATCH 19/64] fix: precise memoryLimit for string replace

---
 src/filters/string.ts | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/filters/string.ts b/src/filters/string.ts
index 3ef570566..f96d4b492 100644
--- a/src/filters/string.ts
+++ b/src/filters/string.ts
@@ -138,8 +138,10 @@ export function replace (this: FilterImpl, v: string, pattern: string, replaceme
   const str = stringify(v)
   pattern = stringify(pattern)
   replacement = stringify(replacement)
-  this.context.memoryLimit.use(str.length + pattern.length + replacement.length)
-  return str.split(pattern).join(replacement)
+  const parts = str.split(pattern)
+  const outputSize = str.length + (parts.length - 1) * (replacement.length - pattern.length)
+  this.context.memoryLimit.use(outputSize)
+  return parts.join(replacement)
 }
 
 export function replace_first (this: FilterImpl, v: string, arg1: string, arg2: string) {

From 529dd67eeb6b125637623d6a723601f0938d3613 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 6 Apr 2026 14:40:35 +0800
Subject: [PATCH 20/64] fix: use realpath for fs.contains (#867)

* fix: use realpath for fs.contains

* chore: reset file mode changes

Made-with: Cursor

* fix: Windows compat for contains/containsSync and toLiquidAsync arg order

Made-with: Cursor
---
 .cursor/rules/architecture.mdc       | 17 +++++++++++
 .cursor/rules/conventions.mdc        |  6 ++++
 docs/source/tutorials/render-file.md |  2 +-
 src/fs/fs-impl.spec.ts               | 36 +++++++++++++++++++++++
 src/fs/fs-impl.ts                    | 27 +++++++++++++----
 src/fs/fs.ts                         |  6 ++--
 src/fs/loader.spec.ts                | 43 +++++++++++++++-------------
 src/fs/loader.ts                     | 43 +++++++++++++++++-----------
 src/parser/parser.ts                 |  9 ++++--
 src/util/async.ts                    | 13 +++++++++
 test/e2e/parse-and-render.spec.ts    | 25 ++++++++++++++++
 test/stub/mockfs.ts                  | 18 ++++++++++--
 12 files changed, 195 insertions(+), 50 deletions(-)
 create mode 100644 .cursor/rules/architecture.mdc
 create mode 100644 .cursor/rules/conventions.mdc

diff --git a/.cursor/rules/architecture.mdc b/.cursor/rules/architecture.mdc
new file mode 100644
index 000000000..d83fabffa
--- /dev/null
+++ b/.cursor/rules/architecture.mdc
@@ -0,0 +1,17 @@
+---
+description: Architecture overview for liquidjs internals
+alwaysApply: true
+---
+
+## Async/sync duality via generators
+
+All core logic is written once as a `Generator` function (`function *`). Use `yield` where you'd normally `await` a potentially async value.
+
+- `toPromise(generator)` drives it **asynchronously** — awaits yielded promises.
+- `toValueSync(generator)` drives it **synchronously** — passes yielded values through as-is.
+
+Never duplicate logic into separate async and sync methods. A single generator serves both paths.
+
+When wrapping an async+sync function pair (e.g. `contains`/`containsSync`, `exists`/`existsSync`, `readFile`/`readFileSync`), use `toLiquidAsync(asyncFn, syncFn?)` which returns a `LiquidAsync<F>` — one function that picks the sync or async implementation based on a leading `sync: boolean` arg. Then `yield` the result inside a generator to let the driver handle it in both modes.
+
+See `src/util/async.ts`.
diff --git a/.cursor/rules/conventions.mdc b/.cursor/rules/conventions.mdc
new file mode 100644
index 000000000..55febef8e
--- /dev/null
+++ b/.cursor/rules/conventions.mdc
@@ -0,0 +1,6 @@
+---
+description: Project conventions for liquidjs
+alwaysApply: true
+---
+
+- Keep edits minimal: change only what the task requires, match existing style.
diff --git a/docs/source/tutorials/render-file.md b/docs/source/tutorials/render-file.md
index 0f636852f..6701882c6 100644
--- a/docs/source/tutorials/render-file.md
+++ b/docs/source/tutorials/render-file.md
@@ -92,7 +92,7 @@ var engine = new Liquid({
 });
 ```
 
-{% note warn Path Traversal Vulnerability %}The default value of <code>contains()</code> always returns true. That means when specifying an abstract file system, you'll need to provide a proper <code>contains()</code> to avoid expose such vulnerabilities.{% endnote %}
+{% note warn Path Traversal Vulnerability %}The built-in Node <code>fs</code> implements <code>contains()</code> with realpath so templates cannot escape the root via symlinks. The browser bundle omits <code>contains</code> (loader treats paths as allowed). For a custom abstract <code>fs</code>, implement <code>contains</code> unless every resolved path is trusted.{% endnote %}
 
 ## In-memory Template
 
diff --git a/src/fs/fs-impl.spec.ts b/src/fs/fs-impl.spec.ts
index 4881cec74..1258ca78e 100644
--- a/src/fs/fs-impl.spec.ts
+++ b/src/fs/fs-impl.spec.ts
@@ -1,5 +1,9 @@
 import * as fs from './fs-impl'
 import * as path from 'path'
+import { mkdtempSync, writeFileSync, symlinkSync, rmSync } from 'fs'
+import { tmpdir } from 'os'
+
+const { join } = path
 
 describe('fs-impl', function () {
   describe('.resolve()', function () {
@@ -50,4 +54,36 @@ describe('fs-impl', function () {
       expect(content).toContain('should read content if exists')
     })
   })
+  describe('.contains()', () => {
+    const canSymlink = process.platform !== 'win32'
+    ;(canSymlink ? it : it.skip)('should return false when path is a symlink to outside root', async () => {
+      const root = mkdtempSync(join(tmpdir(), 'liquid-contains-'))
+      const outside = join(tmpdir(), `secret-${Date.now()}.liquid`)
+      writeFileSync(outside, 'x')
+      const link = join(root, 'link.liquid')
+      symlinkSync(outside, link)
+      try {
+        expect(await fs.contains(root, link)).toBe(false)
+      } finally {
+        rmSync(root, { recursive: true, force: true })
+        rmSync(outside, { force: true })
+      }
+    })
+  })
+  describe('.containsSync()', () => {
+    const canSymlink = process.platform !== 'win32'
+    ;(canSymlink ? it : it.skip)('should return false when path is a symlink to outside root', () => {
+      const root = mkdtempSync(join(tmpdir(), 'liquid-contains-'))
+      const outside = join(tmpdir(), `secret-${Date.now()}.liquid`)
+      writeFileSync(outside, 'x')
+      const link = join(root, 'link.liquid')
+      symlinkSync(outside, link)
+      try {
+        expect(fs.containsSync(root, link)).toBe(false)
+      } finally {
+        rmSync(root, { recursive: true, force: true })
+        rmSync(outside, { force: true })
+      }
+    })
+  })
 })
diff --git a/src/fs/fs-impl.ts b/src/fs/fs-impl.ts
index d542c1916..ea167a8d6 100644
--- a/src/fs/fs-impl.ts
+++ b/src/fs/fs-impl.ts
@@ -1,6 +1,6 @@
 import { promisify } from '../util'
 import { sep, resolve as nodeResolve, extname, dirname as nodeDirname } from 'path'
-import { stat, statSync, readFile as nodeReadFile, readFileSync as nodeReadFileSync } from 'fs'
+import { stat, statSync, readFile as nodeReadFile, readFileSync as nodeReadFileSync, realpath, realpathSync } from 'fs'
 import { requireResolve } from './node-require'
 
 type NodeReadFile = (file: string, encoding: string, cb: ((err: Error | null, result: string) => void)) => void
@@ -41,10 +41,27 @@ export function fallback (file: string) {
 export function dirname (filepath: string) {
   return nodeDirname(filepath)
 }
-export function contains (root: string, file: string) {
-  root = nodeResolve(root)
-  root = root.endsWith(sep) ? root : root + sep
-  return file.startsWith(root)
+const realpathAsync = promisify(realpath)
+
+export async function contains (root: string, file: string) {
+  try {
+    const realRoot = await realpathAsync(root)
+    const realFile = await realpathAsync(file)
+    const prefix = realRoot.endsWith(sep) ? realRoot : realRoot + sep
+    return realFile.startsWith(prefix)
+  } catch {
+    return false
+  }
+}
+export function containsSync (root: string, file: string) {
+  try {
+    const realRoot = realpathSync(root)
+    const realFile = realpathSync(file)
+    const prefix = realRoot.endsWith(sep) ? realRoot : realRoot + sep
+    return realFile.startsWith(prefix)
+  } catch {
+    return false
+  }
 }
 
 export { sep } from 'path'
diff --git a/src/fs/fs.ts b/src/fs/fs.ts
index 0a0104591..15f16eb8b 100644
--- a/src/fs/fs.ts
+++ b/src/fs/fs.ts
@@ -9,8 +9,10 @@ export interface FS {
   readFileSync: (filepath: string) => string;
   /** resolve a file against directory, for given `ext` option */
   resolve: (dir: string, file: string, ext: string) => string;
-  /** check if file is contained in `root`, always return `true` by default. Warning: not setting this could expose path traversal vulnerabilities. */
-  contains?: (root: string, file: string) => boolean;
+  /** check if file is contained in `root`. Node default fs uses realpath; if omitted, loader assumes contained. */
+  contains?: (root: string, file: string) => Promise<boolean>;
+  /** sync check if file is contained in `root`, allows both renderSync and render. */
+  containsSync?: (root: string, file: string) => boolean;
   /** defaults to "/" */
   sep?: string;
   /** required for relative path resolving */
diff --git a/src/fs/loader.spec.ts b/src/fs/loader.spec.ts
index b694ef1d3..81116b2d9 100644
--- a/src/fs/loader.spec.ts
+++ b/src/fs/loader.spec.ts
@@ -1,31 +1,34 @@
 import * as fs from './fs-impl'
-import { Loader } from './loader'
+import { resolve } from 'path'
+import { Loader, LookupType } from './loader'
+import { toValueSync } from '../util/async'
 
 describe('fs/loader', function () {
   describe('.candidates()', function () {
-    it('should resolve relatively', async function () {
+    it('should resolve relatively', function () {
       const loader = new Loader({ relativeReference: true, fs, extname: '' } as any)
-      const candidates = [...loader.candidates('./foo/bar', ['/root', '/root/foo'], '/root/current', true)]
-      expect(candidates).toContain('/root/foo/bar')
+      const candidates = [...loader.candidates('./foo/bar', ['/root', '/root/foo'], '/root/current')]
+      expect(candidates).toContain(resolve('/root/foo/bar'))
     })
-    it('should not include out of root candidates', async function () {
-      const loader = new Loader({ relativeReference: true, fs, extname: '' } as any)
-      const candidates = [...loader.candidates('../foo/bar', ['/root'], '/root/current', true)]
-      expect(candidates).toHaveLength(0)
+  })
+  describe('.lookup()', function () {
+    it('should not include out of root candidates', function () {
+      const mockFs = { ...fs, existsSync: () => true, exists: async () => true }
+      const loader = new Loader({ relativeReference: true, fs: mockFs, extname: '', partials: ['/root'] } as any)
+      expect(() => toValueSync(loader.lookup('../foo/bar', LookupType.Partials, true, '/root/current')))
+        .toThrow(/ENOENT/)
     })
-    it('should treat root as a terminated path', async function () {
-      const loader = new Loader({ relativeReference: true, fs, extname: '' } as any)
-      const candidates = [...loader.candidates('../root-dir/bar', ['/root'], '/root/current', true)]
-      expect(candidates).toHaveLength(0)
+    it('should treat root as a terminated path', function () {
+      const mockFs = { ...fs, existsSync: () => true, exists: async () => true }
+      const loader = new Loader({ relativeReference: true, fs: mockFs, extname: '', partials: ['/root'] } as any)
+      expect(() => toValueSync(loader.lookup('../root-dir/bar', LookupType.Partials, true, '/root/current')))
+        .toThrow(/ENOENT/)
     })
-    it('should default `.contains()` to () => true', async function () {
-      const customFs = {
-        ...fs,
-        contains: undefined
-      }
-      const loader = new Loader({ relativeReference: true, fs: customFs, extname: '' } as any)
-      const candidates = [...loader.candidates('../foo/bar', ['/root'], '/root/current', true)]
-      expect(candidates).toContain('/foo/bar')
+    it('should use permissive contains when fs.contains is omitted', function () {
+      const mockFs = { ...fs, existsSync: () => true, exists: async () => true, contains: undefined, containsSync: undefined }
+      const loader = new Loader({ relativeReference: true, fs: mockFs, extname: '', partials: ['/root'] } as any)
+      const result = toValueSync(loader.lookup('./foo/bar', LookupType.Partials, true, '/root/current'))
+      expect(result).toBe(resolve('/root/foo/bar'))
     })
   })
 })
diff --git a/src/fs/loader.ts b/src/fs/loader.ts
index 2c58e231c..b0e471e11 100644
--- a/src/fs/loader.ts
+++ b/src/fs/loader.ts
@@ -1,5 +1,5 @@
 import { FS } from './fs'
-import { assert } from '../util'
+import { assert, LiquidAsync, toLiquidAsync } from '../util'
 
 export interface LoaderOptions {
   fs: FS;
@@ -17,7 +17,8 @@ export enum LookupType {
 export class Loader {
   public shouldLoadRelative: (referencedFile: string) => boolean
   private options: LoaderOptions
-  private contains: (root: string, file: string) => boolean
+  private contains: LiquidAsync<NonNullable<FS['containsSync']>>
+  private exists: LiquidAsync<FS['existsSync']>
 
   constructor (options: LoaderOptions) {
     this.options = options
@@ -29,40 +30,48 @@ export class Loader {
     } else {
       this.shouldLoadRelative = (_referencedFile: string) => false
     }
-    this.contains = this.options.fs.contains || (() => true)
+    const fs = options.fs
+    this.contains = toLiquidAsync(
+      fs.contains?.bind(fs) || (async () => true),
+      fs.containsSync?.bind(fs) || (() => true)
+    )
+    this.exists = toLiquidAsync(
+      fs.exists?.bind(fs) || (async () => false),
+      fs.existsSync?.bind(fs)
+    )
   }
 
   public * lookup (file: string, type: LookupType, sync?: boolean, currentFile?: string): Generator<unknown, string, string> {
-    const { fs } = this.options
     const dirs = this.options[type]
-    for (const filepath of this.candidates(file, dirs, currentFile, type !== LookupType.Root)) {
-      if (sync ? fs.existsSync(filepath) : yield fs.exists(filepath)) return filepath
+    const enforceRoot = type !== LookupType.Root
+    for (const filepath of this.candidates(file, dirs, currentFile)) {
+      if (enforceRoot) {
+        let allowed = false
+        for (const dir of dirs) {
+          if (yield this.contains(!!sync, dir, filepath)) { allowed = true; break }
+        }
+        if (!allowed) continue
+      }
+      if (yield this.exists(!!sync, filepath)) return filepath
     }
     throw this.lookupError(file, dirs)
   }
 
-  public * candidates (file: string, dirs: string[], currentFile?: string, enforceRoot?: boolean) {
+  public * candidates (file: string, dirs: string[], currentFile?: string) {
     const { fs, extname } = this.options
-    const isAllowed = (filepath: string) => {
-      if (!enforceRoot) return true
-      for (const dir of dirs) {
-        if (this.contains(dir, filepath)) return true
-      }
-      return false
-    }
 
     if (this.shouldLoadRelative(file) && currentFile) {
       const referenced = fs.resolve(this.dirname(currentFile), file, extname)
-      if (isAllowed(referenced)) yield referenced
+      yield referenced
     }
     for (const dir of dirs) {
       const referenced = fs.resolve(dir, file, extname)
-      if (isAllowed(referenced)) yield referenced
+      yield referenced
     }
 
     if (fs.fallback !== undefined) {
       const filepath = fs.fallback(file)
-      if (filepath !== undefined && isAllowed(filepath)) yield filepath
+      if (filepath !== undefined) yield filepath
     }
   }
 
diff --git a/src/parser/parser.ts b/src/parser/parser.ts
index 2c02dc407..f61f2323e 100644
--- a/src/parser/parser.ts
+++ b/src/parser/parser.ts
@@ -1,4 +1,4 @@
-import { Limiter, toPromise, assert, isTagToken, isOutputToken, ParseError } from '../util'
+import { Limiter, toPromise, assert, isTagToken, isOutputToken, ParseError, toLiquidAsync, LiquidAsync } from '../util'
 import { Tokenizer } from './tokenizer'
 import { ParseStream } from './parse-stream'
 import { TopLevelToken, OutputToken } from '../tokens'
@@ -16,6 +16,7 @@ export class Parser {
   private cache?: LiquidCache
   private loader: Loader
   private parseLimit: Limiter
+  private readFile: LiquidAsync<FS['readFileSync']>
 
   public constructor (liquid: Liquid) {
     this.liquid = liquid
@@ -24,6 +25,10 @@ export class Parser {
     this.parseFile = this.cache ? this._parseFileCached : this._parseFile
     this.loader = new Loader(this.liquid.options)
     this.parseLimit = new Limiter('parse length', liquid.options.parseLimit)
+    this.readFile = toLiquidAsync(
+      this.fs.readFile?.bind(this.fs) || (async () => { throw new Error('readFile not implemented') }),
+      this.fs.readFileSync?.bind(this.fs)
+    )
   }
   public parse (html: string, filepath?: string): Template[] {
     html = String(html)
@@ -82,6 +87,6 @@ export class Parser {
   }
   private * _parseFile (file: string, sync?: boolean, type: LookupType = LookupType.Root, currentFile?: string): Generator<unknown, Template[], string> {
     const filepath = yield this.loader.lookup(file, type, sync, currentFile)
-    return this.parse(sync ? this.fs.readFileSync(filepath) : yield this.fs.readFile(filepath), filepath)
+    return this.parse(yield this.readFile(!!sync, filepath), filepath)
   }
 }
diff --git a/src/util/async.ts b/src/util/async.ts
index 9d836cd42..c190cd860 100644
--- a/src/util/async.ts
+++ b/src/util/async.ts
@@ -1,5 +1,18 @@
 import { isPromise, isIterator } from './underscore'
 
+export type LiquidAsync<F extends (...args: any[]) => any> =
+  (sync: boolean, ...args: Parameters<F>) => ReturnType<F> | Promise<ReturnType<F>>
+
+export function toLiquidAsync<F extends (...args: any[]) => any> (
+  asyncFn: (...args: Parameters<F>) => Promise<ReturnType<F>>,
+  syncFn?: F
+): LiquidAsync<F> {
+  const syncImpl = syncFn || asyncFn as any
+  return (sync: boolean, ...args: any[]) => {
+    return sync ? syncImpl(...args as Parameters<F>) : asyncFn(...args as Parameters<F>)
+  }
+}
+
 // convert an async iterator to a Promise
 export async function toPromise<T> (val: Generator<unknown, T, unknown> | Promise<T> | T): Promise<T> {
   if (!isIterator(val)) return val
diff --git a/test/e2e/parse-and-render.spec.ts b/test/e2e/parse-and-render.spec.ts
index 43bf3c162..cfca9c2b2 100644
--- a/test/e2e/parse-and-render.spec.ts
+++ b/test/e2e/parse-and-render.spec.ts
@@ -1,4 +1,7 @@
 import { Liquid } from '../..'
+import { mkdtempSync, writeFileSync, symlinkSync, rmSync } from 'fs'
+import { join } from 'path'
+import { tmpdir } from 'os'
 
 describe('.parseAndRender()', function () {
   var engine: Liquid, strictEngine: Liquid
@@ -57,4 +60,26 @@ describe('.parseAndRender()', function () {
     const html = await engine.parseAndRender(src)
     expect(html).toBe('true')
   })
+  const canSymlink = process.platform !== 'win32'
+  ;(canSymlink ? describe : describe.skip)('symlink outside root', function () {
+    let root: string, secret: string
+    beforeAll(function () {
+      root = mkdtempSync(join(tmpdir(), 'liquid-e2e-root-'))
+      secret = join(tmpdir(), `liquid-e2e-secret-${Date.now()}.liquid`)
+      writeFileSync(secret, 'SECRET_OUTSIDE')
+      symlinkSync(secret, join(root, 'link.liquid'))
+    })
+    afterAll(function () {
+      rmSync(root, { recursive: true, force: true })
+      rmSync(secret, { force: true })
+    })
+    it('should not render a symlink partial whose target is outside root', async function () {
+      const e = new Liquid({ root: [root], extname: '.liquid', relativeReference: false })
+      await expect(e.parseAndRender('{% render "link" %}')).rejects.toThrow(/ENOENT|Failed to lookup/)
+    })
+    it('should not render a symlink partial via parseAndRenderSync', function () {
+      const e = new Liquid({ root: [root], extname: '.liquid', relativeReference: false })
+      expect(() => e.parseAndRenderSync('{% render "link" %}')).toThrow(/ENOENT|Failed to lookup/)
+    })
+  })
 })
diff --git a/test/stub/mockfs.ts b/test/stub/mockfs.ts
index bd3c77717..4c9d4cea3 100644
--- a/test/stub/mockfs.ts
+++ b/test/stub/mockfs.ts
@@ -1,6 +1,6 @@
 import { isString, forOwn } from '../../src/util/underscore'
 import * as fs from '../../src/fs/fs-impl'
-import { resolve } from 'path'
+import { resolve, sep } from 'path'
 
 interface FileDescriptor {
   mode: string;
@@ -8,7 +8,7 @@ interface FileDescriptor {
 }
 
 let files: { [path: string]: FileDescriptor } = {}
-const { readFile, exists, readFileSync, existsSync } = fs
+const { readFile, exists, readFileSync, existsSync, contains, containsSync } = fs
 
 export function mock (options: { [path: string]: (string | FileDescriptor) }) {
   forOwn(options, (val, key) => {
@@ -30,6 +30,16 @@ export function mock (options: { [path: string]: (string | FileDescriptor) }) {
   };
   (fs as any).existsSync = function (path: string) {
     return !!files[path]
+  };
+  (fs as any).contains = async (root: string, file: string) => {
+    root = resolve(root)
+    if (!root.endsWith(sep)) root += sep
+    return file.startsWith(root)
+  };
+  (fs as any).containsSync = (root: string, file: string) => {
+    root = resolve(root)
+    if (!root.endsWith(sep)) root += sep
+    return file.startsWith(root)
   }
 }
 
@@ -38,5 +48,7 @@ export function restore () {
   (fs as any).readFileSync = readFileSync;
   (fs as any).existsSync = existsSync;
   (fs as any).readFile = readFile;
-  (fs as any).exists = exists
+  (fs as any).exists = exists;
+  (fs as any).contains = contains;
+  (fs as any).containsSync = containsSync
 }

From 8f69a0839903d85c7b5c9097e39ecce6ac3eab05 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Mon, 6 Apr 2026 06:45:50 +0000
Subject: [PATCH 21/64] chore(release): 10.25.3 [skip ci]

## [10.25.3](https://github.com/harttle/liquidjs/compare/v10.25.2...v10.25.3) (2026-04-06)

### Bug Fixes

* precise memoryLimit for string replace ([abc058b](https://github.com/harttle/liquidjs/commit/abc058be0f33d6372cd2216f4945183167abeb25))
* use realpath for fs.contains ([#867](https://github.com/harttle/liquidjs/issues/867)) ([529dd67](https://github.com/harttle/liquidjs/commit/529dd67eeb6b125637623d6a723601f0938d3613))
---
 CHANGELOG.md      | 8 ++++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99fca13cc..7368d6130 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,11 @@
+## [10.25.3](https://github.com/harttle/liquidjs/compare/v10.25.2...v10.25.3) (2026-04-06)
+
+
+### Bug Fixes
+
+* precise memoryLimit for string replace ([abc058b](https://github.com/harttle/liquidjs/commit/abc058be0f33d6372cd2216f4945183167abeb25))
+* use realpath for fs.contains ([#867](https://github.com/harttle/liquidjs/issues/867)) ([529dd67](https://github.com/harttle/liquidjs/commit/529dd67eeb6b125637623d6a723601f0938d3613))
+
 ## [10.25.2](https://github.com/harttle/liquidjs/compare/v10.25.1...v10.25.2) (2026-03-25)
 
 
diff --git a/package-lock.json b/package-lock.json
index f8fb4133e..cffedacdc 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.2",
+  "version": "10.25.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.2",
+      "version": "10.25.3",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index dce665fe7..05be86283 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.2",
+  "version": "10.25.3",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From e743da0020d34e2ee547e1cc1a86b58377ebe1ce Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Tue, 7 Apr 2026 21:01:20 +0800
Subject: [PATCH 22/64] fix: sort and sort_natural filters bypass
 ownPropertyOnly (#869)

Use _getFromScope for property access in sort/sort_natural filters to respect the ownPropertyOnly security option, preventing prototype chain traversal that could leak sensitive inherited properties.

Also extract shared sortBy helper, add orderedCompare with nil handling consistent with caseInsensitiveCompare and Ruby Liquid.

Made-with: Cursor
---
 src/context/scope.ts                   |  2 +-
 src/filters/array.ts                   | 26 +++++++-----------
 src/util/underscore.ts                 | 15 ++++++++---
 test/integration/filters/array.spec.ts | 37 ++++++++++++++++++++++++++
 4 files changed, 60 insertions(+), 20 deletions(-)

diff --git a/src/context/scope.ts b/src/context/scope.ts
index f8f0ab057..9fcc06dae 100644
--- a/src/context/scope.ts
+++ b/src/context/scope.ts
@@ -1,6 +1,6 @@
 import { Drop } from '../drop/drop'
 
-interface ScopeObject extends Record<string, any> {
+interface ScopeObject extends Record<string | number | symbol, any> {
   toLiquid?: () => any;
 }
 
diff --git a/src/filters/array.ts b/src/filters/array.ts
index 6792d572c..f22fcce20 100644
--- a/src/filters/array.ts
+++ b/src/filters/array.ts
@@ -1,4 +1,4 @@
-import { toArray, argumentsToValue, toValue, stringify, caseInsensitiveCompare, isArray, isNil, last as arrayLast, isArrayLike, toEnumerable } from '../util'
+import { toArray, argumentsToValue, toValue, stringify, caseInsensitiveCompare, orderedCompare, isArray, isNil, last as arrayLast, isArrayLike, toEnumerable } from '../util'
 import { arrayIncludes, equals, evalToken, isTruthy } from '../render'
 import { Value, FilterImpl } from '../template'
 import { Tokenizer } from '../parser'
@@ -20,8 +20,8 @@ export const reverse = argumentsToValue(function (this: FilterImpl, v: any[]) {
   return [...array].reverse()
 })
 
-export function * sort<T> (this: FilterImpl, arr: T[], property?: string): IterableIterator<unknown> {
-  const values: [T, string | number][] = []
+function * sortBy<T> (this: FilterImpl, arr: T[], property: string | undefined, comparator: (a: unknown, b: unknown) => number): IterableIterator<unknown> {
+  const values: [T, unknown][] = []
   const array = toArray(arr)
   this.context.memoryLimit.use(array.length)
   for (const item of array) {
@@ -30,21 +30,15 @@ export function * sort<T> (this: FilterImpl, arr: T[], property?: string): Itera
       property ? yield this.context._getFromScope(item, stringify(property).split('.'), false) : item
     ])
   }
-  return values.sort((lhs, rhs) => {
-    const lvalue = lhs[1]
-    const rvalue = rhs[1]
-    return lvalue < rvalue ? -1 : (lvalue > rvalue ? 1 : 0)
-  }).map(tuple => tuple[0])
+  return values.sort((lhs, rhs) => comparator(lhs[1], rhs[1])).map(tuple => tuple[0])
 }
 
-export function sort_natural<T> (this: FilterImpl, input: T[], property?: string) {
-  const propertyString = stringify(property)
-  const compare = property === undefined
-    ? caseInsensitiveCompare
-    : (lhs: T, rhs: T) => caseInsensitiveCompare(lhs[propertyString], rhs[propertyString])
-  const array = toArray(input)
-  this.context.memoryLimit.use(array.length)
-  return [...array].sort(compare)
+export function * sort<T> (this: FilterImpl, arr: T[], property?: string): IterableIterator<unknown> {
+  return yield * sortBy.call(this, arr, property, orderedCompare)
+}
+
+export function * sort_natural<T> (this: FilterImpl, arr: T[], property?: string): IterableIterator<unknown> {
+  return yield * sortBy.call(this, arr, property, caseInsensitiveCompare)
 }
 
 export const size = (v: string | any[]) => (v && v.length) || 0
diff --git a/src/util/underscore.ts b/src/util/underscore.ts
index ad829e0bc..f3558da1a 100644
--- a/src/util/underscore.ts
+++ b/src/util/underscore.ts
@@ -170,11 +170,20 @@ export function ellipsis (str: string, N: number): string {
   return str.length > N ? str.slice(0, N - 3) + '...' : str
 }
 
+export function orderedCompare (a: any, b: any) {
+  if (isNil(a) && isNil(b)) return 0
+  if (isNil(a)) return 1
+  if (isNil(b)) return -1
+  if (a < b) return -1
+  if (a > b) return 1
+  return 0
+}
+
 // compare string in case-insensitive way, undefined values to the tail
 export function caseInsensitiveCompare (a: any, b: any) {
-  if (a == null && b == null) return 0
-  if (a == null) return 1
-  if (b == null) return -1
+  if (isNil(a) && isNil(b)) return 0
+  if (isNil(a)) return 1
+  if (isNil(b)) return -1
   a = toLowerCase.call(a)
   b = toLowerCase.call(b)
   if (a < b) return -1
diff --git a/test/integration/filters/array.spec.ts b/test/integration/filters/array.spec.ts
index eb28db78d..b9212686f 100644
--- a/test/integration/filters/array.spec.ts
+++ b/test/integration/filters/array.spec.ts
@@ -315,6 +315,26 @@ describe('filters/array', function () {
     it('should return empty array for nil value', () => {
       return test('{{notDefined | sort | size}}', {}, '0')
     })
+    it('should respect ownPropertyOnly', async () => {
+      const engine = new Liquid({ ownPropertyOnly: true })
+      const a = Object.create({ secret: 'ccc' })
+      a.name = 'a'
+      const b = Object.create({ secret: 'aaa' })
+      b.name = 'b'
+      const html = await engine.parseAndRender(
+        '{{ arr | sort: "secret" | map: "name" | join: "," }}',
+        { arr: [a, b] }
+      )
+      expect(html).toBe('a,b')
+    })
+    it('should handle nil property values', async () => {
+      const arr = [{ age: 'cc' }, { name: 'x' }, { age: 'aa' }, { age: 'bb' }]
+      await test('{% assign sorted = arr | sort: "age" %}{% for item in sorted %}[{{ item.age }}]{% endfor %}', { arr }, '[aa][bb][cc][]')
+    })
+    it('should handle mixed-type items', async () => {
+      const arr = ['40', null, 30, undefined, true, false, 0, 'str', 50]
+      await test('{% assign sorted = arr | sort %}{% for item in sorted %}[{{ item }}]{% endfor %}', { arr }, '[false][0][true][30][40][str][50][][]')
+    })
   })
   describe('sort_natural', function () {
     it('should sort alphabetically', () => {
@@ -360,6 +380,23 @@ describe('filters/array', function () {
       { students: undefined },
       '0'
     ))
+    it('should respect ownPropertyOnly', async () => {
+      const engine = new Liquid({ ownPropertyOnly: true })
+      const target = Object.create({ secret: 'bbb' })
+      const html = await engine.parseAndRender(
+        '{{ arr | sort_natural: "secret" | map: "secret" | join: "," }}',
+        { arr: [{ secret: 'ccc' }, target, { secret: 'aaa' }] }
+      )
+      expect(html).toBe('aaa,ccc,')
+    })
+    it('should handle nil property values', async () => {
+      const arr = [{ age: '40' }, { name: 'x' }, { age: 30 }, { age: 50 }]
+      await test('{% assign sorted = arr | sort_natural: "age" %}{% for item in sorted %}[{{ item.age }}]{% endfor %}', { arr }, '[30][40][50][]')
+    })
+    it('should handle mixed-type items', async () => {
+      const arr = ['40', null, 30, undefined, true, false, 0, 'str', 50]
+      await test('{% assign sorted = arr | sort_natural %}{% for item in sorted %}[{{ item }}]{% endfor %}', { arr }, '[0][30][40][50][false][str][true][][]')
+    })
   })
   describe('uniq', function () {
     it('should uniq string list', function () {

From db4348507e6aa205ab2ba5e3fa273c40767e6764 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 7 Apr 2026 13:02:49 +0000
Subject: [PATCH 23/64] chore(release): 10.25.4 [skip ci]

## [10.25.4](https://github.com/harttle/liquidjs/compare/v10.25.3...v10.25.4) (2026-04-07)

### Bug Fixes

* sort and sort_natural filters bypass ownPropertyOnly ([#869](https://github.com/harttle/liquidjs/issues/869)) ([e743da0](https://github.com/harttle/liquidjs/commit/e743da0020d34e2ee547e1cc1a86b58377ebe1ce))
---
 CHANGELOG.md      | 7 +++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7368d6130..d7cb307da 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [10.25.4](https://github.com/harttle/liquidjs/compare/v10.25.3...v10.25.4) (2026-04-07)
+
+
+### Bug Fixes
+
+* sort and sort_natural filters bypass ownPropertyOnly ([#869](https://github.com/harttle/liquidjs/issues/869)) ([e743da0](https://github.com/harttle/liquidjs/commit/e743da0020d34e2ee547e1cc1a86b58377ebe1ce))
+
 ## [10.25.3](https://github.com/harttle/liquidjs/compare/v10.25.2...v10.25.3) (2026-04-06)
 
 
diff --git a/package-lock.json b/package-lock.json
index cffedacdc..47aba7346 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.3",
+  "version": "10.25.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.3",
+      "version": "10.25.4",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 05be86283..19b18f4e9 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.3",
+  "version": "10.25.4",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From f41c1fc02fe901598f3328118b42b13bc6bc9b04 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Tue, 7 Apr 2026 23:18:53 +0800
Subject: [PATCH 24/64] fix: enforce root containment for renderFile/parseFile
 lookups (#870)

Made-with: Cursor
---
 src/fs/loader.spec.ts                  |  6 ++++++
 src/fs/loader.ts                       | 11 ++++-------
 test/e2e/render-file.spec.ts           |  1 +
 test/e2e/render-to-node-stream.spec.ts |  4 ++--
 test/integration/liquid/liquid.spec.ts | 19 ++++++++++++++++++-
 5 files changed, 31 insertions(+), 10 deletions(-)

diff --git a/src/fs/loader.spec.ts b/src/fs/loader.spec.ts
index 81116b2d9..d45fce830 100644
--- a/src/fs/loader.spec.ts
+++ b/src/fs/loader.spec.ts
@@ -30,5 +30,11 @@ describe('fs/loader', function () {
       const result = toValueSync(loader.lookup('./foo/bar', LookupType.Partials, true, '/root/current'))
       expect(result).toBe(resolve('/root/foo/bar'))
     })
+    it('should enforce containment for LookupType.Root', function () {
+      const mockFs = { ...fs, existsSync: () => true, exists: async () => true }
+      const loader = new Loader({ relativeReference: false, fs: mockFs, extname: '', root: ['/safe'] } as any)
+      expect(() => toValueSync(loader.lookup('/etc/hosts', LookupType.Root, true)))
+        .toThrow(/ENOENT/)
+    })
   })
 })
diff --git a/src/fs/loader.ts b/src/fs/loader.ts
index b0e471e11..bf2fc8261 100644
--- a/src/fs/loader.ts
+++ b/src/fs/loader.ts
@@ -43,15 +43,12 @@ export class Loader {
 
   public * lookup (file: string, type: LookupType, sync?: boolean, currentFile?: string): Generator<unknown, string, string> {
     const dirs = this.options[type]
-    const enforceRoot = type !== LookupType.Root
     for (const filepath of this.candidates(file, dirs, currentFile)) {
-      if (enforceRoot) {
-        let allowed = false
-        for (const dir of dirs) {
-          if (yield this.contains(!!sync, dir, filepath)) { allowed = true; break }
-        }
-        if (!allowed) continue
+      let allowed = false
+      for (const dir of dirs) {
+        if (yield this.contains(!!sync, dir, filepath)) { allowed = true; break }
       }
+      if (!allowed) continue
       if (yield this.exists(!!sync, filepath)) return filepath
     }
     throw this.lookupError(file, dirs)
diff --git a/test/e2e/render-file.spec.ts b/test/e2e/render-file.spec.ts
index 3bc1f5a55..6c6227e5a 100644
--- a/test/e2e/render-file.spec.ts
+++ b/test/e2e/render-file.spec.ts
@@ -38,6 +38,7 @@ describe('#renderFile()', function () {
     return expect(html).toContain('"name": "liquidjs"')
   })
   it('should render file with context', async function () {
+    engine = new Liquid({ root: views, extname: '.html' })
     const html = await engine.renderFile(resolve(views, 'name.html'), { name: 'harttle' })
     return expect(html).toBe('My name is harttle.')
   })
diff --git a/test/e2e/render-to-node-stream.spec.ts b/test/e2e/render-to-node-stream.spec.ts
index edfc25fc5..1488d3bee 100644
--- a/test/e2e/render-to-node-stream.spec.ts
+++ b/test/e2e/render-to-node-stream.spec.ts
@@ -4,8 +4,8 @@ import { drainStream } from '../stub/stream'
 describe('.renderToNodeStream()', function () {
   it('should render to stream in Node.js', done => {
     const cjs = require('../../dist/liquid.node')
-    const engine = new cjs.Liquid()
-    const tpl = engine.parseFileSync(resolve(__dirname, '../stub/root/foo.html'))
+    const engine = new cjs.Liquid({ root: resolve(__dirname, '../stub/root/') })
+    const tpl = engine.parseFileSync('foo.html')
     const stream = engine.renderToNodeStream(tpl)
     let html = ''
     stream.on('data', (data: string) => { html += data })
diff --git a/test/integration/liquid/liquid.spec.ts b/test/integration/liquid/liquid.spec.ts
index c778acb4b..918b1aabe 100644
--- a/test/integration/liquid/liquid.spec.ts
+++ b/test/integration/liquid/liquid.spec.ts
@@ -109,6 +109,7 @@ describe('Liquid', function () {
     })
   })
   describe('#renderFile', function () {
+    afterEach(restore)
     it('should throw with lookup list when file not exist', function () {
       const engine = new Liquid({
         root: ['/boo', '/root/'],
@@ -116,6 +117,22 @@ describe('Liquid', function () {
       })
       return expect(engine.renderFile('/not/exist.html')).rejects.toThrow(/Failed to lookup "\/not\/exist.html" in "\/boo,\/root\/"/)
     })
+    it('should reject absolute paths outside root', async function () {
+      mock({
+        '/safe/foo.html': 'safe',
+        '/etc/secret': 'SECRET'
+      })
+      const engine = new Liquid({ root: ['/safe'] })
+      await expect(engine.renderFile('/etc/secret')).rejects.toThrow(/Failed to lookup/)
+    })
+    it('should reject absolute paths outside root (sync)', function () {
+      mock({
+        '/safe/foo.html': 'safe',
+        '/etc/secret': 'SECRET'
+      })
+      const engine = new Liquid({ root: ['/safe'] })
+      expect(() => engine.renderFileSync('/etc/secret')).toThrow(/Failed to lookup/)
+    })
   })
   describe('#parseFile', function () {
     it('should throw with lookup list when file not exist', function () {
@@ -127,7 +144,7 @@ describe('Liquid', function () {
     })
     it('should fallback to require.resolve in Node.js', async function () {
       const engine = new Liquid({
-        root: ['/root/'],
+        root: [process.cwd()],
         extname: '.html'
       })
       const tpls = await engine.parseFileSync('jest')

From 4f9a49988a93c156524981e189a4fec238e682b8 Mon Sep 17 00:00:00 2001
From: Timmy Braun <35117769+timbze@users.noreply.github.com>
Date: Tue, 7 Apr 2026 10:10:33 -0600
Subject: [PATCH 25/64] fix: null date should return empty (#868) (#872)

---
 src/filters/date.ts                   | 4 +++-
 test/integration/filters/date.spec.ts | 8 ++++++--
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/filters/date.ts b/src/filters/date.ts
index 5f86178ce..6bbef46c3 100644
--- a/src/filters/date.ts
+++ b/src/filters/date.ts
@@ -45,7 +45,9 @@ function parseDate (v: string | Date, opts: NormalizedFullOptions, timezoneOffse
   const defaultTimezoneOffset = timezoneOffset ?? opts.timezoneOffset
   const locale = opts.locale
   v = toValue(v)
-  if (v === 'now' || v === 'today') {
+  if (isNil(v)) {
+    return undefined
+  } else if (v === 'now' || v === 'today') {
     date = new LiquidDate(Date.now(), locale, defaultTimezoneOffset)
   } else if (isNumber(v)) {
     date = new LiquidDate(v * 1000, locale, defaultTimezoneOffset)
diff --git a/test/integration/filters/date.spec.ts b/test/integration/filters/date.spec.ts
index 294d48dc0..384aecedf 100644
--- a/test/integration/filters/date.spec.ts
+++ b/test/integration/filters/date.spec.ts
@@ -21,8 +21,12 @@ describe('filters/date', function () {
       const time = String(new Date('2017-03-07T12:00:00').getTime() / 1000)
       return test('{{ time | date: "%Y-%m-%dT%H:%M:%S" }}', { time }, '2017-03-07T12:00:00')
     })
-    it('should treat nil as 0', () => {
-      expect(liquid.parseAndRenderSync('{{ nil | date: "%Y-%m-%dT%H:%M:%S", "Asia/Shanghai" }}')).toEqual('1970-01-01T08:00:00')
+    it('should treat null as invalid', () => {
+      const time = null
+      return test('{{ time | date: "%Y-%m-%dT%H:%M:%S" }}', { time }, '')
+    })
+    it('should treat nil as invalid', () => {
+      expect(liquid.parseAndRenderSync('{{ nil | date: "%Y-%m-%dT%H:%M:%S", "Asia/Shanghai" }}')).toEqual('')
     })
     it('should treat undefined as invalid', () => {
       expect(liquid.parseAndRenderSync('{{ num | date: "%Y-%m-%dT%H:%M:%S", "Asia/Shanghai" }}', { num: undefined })).toEqual('')

From 1cdf10b57d82f0592414efbfca19e204b37aea9f Mon Sep 17 00:00:00 2001
From: Timmy Braun <35117769+timbze@users.noreply.github.com>
Date: Tue, 7 Apr 2026 10:52:35 -0600
Subject: [PATCH 26/64] fix: rounding negative away from zero when half (#873)

---
 src/filters/math.ts                   | 4 +++-
 test/integration/filters/math.spec.ts | 2 ++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/filters/math.ts b/src/filters/math.ts
index 219d7e64b..fa06b4ef8 100644
--- a/src/filters/math.ts
+++ b/src/filters/math.ts
@@ -15,5 +15,7 @@ export function round (v: number, arg = 0) {
   v = toNumber(v)
   arg = toNumber(arg)
   const amp = Math.pow(10, arg)
-  return Math.round(v * amp) / amp
+  const scaled = v * amp
+  // Round half away from zero
+  return Math.sign(v) * Math.round(Math.abs(scaled)) / amp
 }
diff --git a/test/integration/filters/math.spec.ts b/test/integration/filters/math.spec.ts
index be77d3ec4..e8a4722a5 100644
--- a/test/integration/filters/math.spec.ts
+++ b/test/integration/filters/math.spec.ts
@@ -65,6 +65,8 @@ describe('filters/math', function () {
   describe('round', function () {
     it('should return "1" for 1.2', () => test('{{1.2|round}}', '1'))
     it('should return "3" for 2.7', () => test('{{2.7|round}}', '3'))
+    it('should return "-3" for -2.5 (away from zero)', () => test('{{num|round}}', { num: -2.5 }, '-3'))
+    it('should return "-2" for -2.49 (closest integer)', () => test('{{num|round}}', { num: -2.49 }, '-2'))
     it('should return "183.36" for 183.357,2',
       () => test('{{183.357|round: 2}}', '183.36'))
     it('should convert string to number', () => test('{{"2.7"|round}}', '3'))

From 66011d14b06d37c25976fb924e54d359114dd8e1 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Wed, 8 Apr 2026 00:53:27 +0800
Subject: [PATCH 27/64] docs: add timbze as a contributor for code (#874)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 12904768f..ad5c1bf1b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -811,6 +811,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "timbze",
+      "name": "Timmy Braun",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35117769?v=4",
+      "profile": "https://github.com/timbze",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index 7d5473e50..31f473426 100644
--- a/README.md
+++ b/README.md
@@ -220,6 +220,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/MorielHarush"><img src="https://avatars.githubusercontent.com/u/93482738?v=4?s=100" width="100px;" alt="MorielHarush"/><br /><sub><b>MorielHarush</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=MorielHarush" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://doruk.ch"><img src="https://avatars.githubusercontent.com/u/77903714?v=4?s=100" width="100px;" alt="Peak Twilight"/><br /><sub><b>Peak Twilight</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=peaktwilight" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/joecottam"><img src="https://avatars.githubusercontent.com/u/44173086?v=4?s=100" width="100px;" alt="Joe Cottam"/><br /><sub><b>Joe Cottam</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=joecottam" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/timbze"><img src="https://avatars.githubusercontent.com/u/35117769?v=4?s=100" width="100px;" alt="Timmy Braun"/><br /><sub><b>Timmy Braun</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=timbze" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From 05c47da46d545478b5c14cf76c46fe55929bf044 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Wed, 8 Apr 2026 01:16:49 +0800
Subject: [PATCH 28/64] refactor: replace shell scripts with JS for
 cross-platform support (#875)

Convert bin/ shell scripts to Node.js and npm scripts using shx and npm-run-all2. Remove unused build-icons.sh. Inlined simple scripts (build-docs-liquid, build-apidoc) as npm scripts.

Made-with: Cursor
---
 bin/build-apidoc.sh       |   4 -
 bin/build-changelog.js    |  24 +++
 bin/build-changelog.sh    |  15 --
 bin/build-contributors.js |  39 ++++
 bin/build-contributors.sh |  25 ---
 bin/build-docs-liquid.sh  |   6 -
 bin/build-docs.sh         |  17 --
 bin/build-icons.sh        |  36 ----
 bin/perf-diff.js          |  17 ++
 bin/perf-diff.sh          |  12 --
 package-lock.json         | 429 ++++++++++++++++++++++++++++++++++++--
 package.json              |  11 +-
 12 files changed, 503 insertions(+), 132 deletions(-)
 delete mode 100755 bin/build-apidoc.sh
 create mode 100644 bin/build-changelog.js
 delete mode 100755 bin/build-changelog.sh
 create mode 100644 bin/build-contributors.js
 delete mode 100755 bin/build-contributors.sh
 delete mode 100755 bin/build-docs-liquid.sh
 delete mode 100755 bin/build-docs.sh
 delete mode 100755 bin/build-icons.sh
 create mode 100644 bin/perf-diff.js
 delete mode 100755 bin/perf-diff.sh

diff --git a/bin/build-apidoc.sh b/bin/build-apidoc.sh
deleted file mode 100755
index fb6471f8b..000000000
--- a/bin/build-apidoc.sh
+++ /dev/null
@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-
-rm -rf docs/source/api
-typedoc --plugin typedoc-plugin-missing-exports ./src --gitRevision master --out docs/source/api
diff --git a/bin/build-changelog.js b/bin/build-changelog.js
new file mode 100644
index 000000000..5c6b6c0ac
--- /dev/null
+++ b/bin/build-changelog.js
@@ -0,0 +1,24 @@
+const fs = require('fs')
+const path = require('path')
+
+const root = path.resolve(__dirname, '..')
+const src = path.join(root, 'CHANGELOG.md')
+
+let content = fs.readFileSync(src, 'utf8').replace(/\r\n/g, '\n')
+
+const lines = content.split('\n')
+lines[0] = lines[0]
+  .replace(/"/g, '&quot;')
+  .replace(/</g, '&lt;')
+  .replace(/>/g, '&gt;')
+content = lines.join('\n')
+
+content = content
+  .replace(/{%/g, '{% raw %}{%{% endraw %}')
+  .replace(/\{\{/g, '{% raw %}{{{% endraw %}')
+
+const enFrontmatter = '---\ntitle: Changelog\nauto: true\n---\n\n'
+const zhFrontmatter = '---\ntitle: 更新日志\nauto: true\n---\n\n'
+
+fs.writeFileSync(path.join(root, 'docs/source/tutorials/changelog.md'), enFrontmatter + content)
+fs.writeFileSync(path.join(root, 'docs/source/zh-cn/tutorials/changelog.md'), zhFrontmatter + content)
diff --git a/bin/build-changelog.sh b/bin/build-changelog.sh
deleted file mode 100755
index 1f9f4e3ab..000000000
--- a/bin/build-changelog.sh
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-
-cd docs
-cp ../CHANGELOG.md source/tutorials/changelog.md
-sed -i \
-  -e 's/{%/{% raw %}{%{% endraw %}/g' \
-  -e 's/{{/{% raw %}{{{% endraw %}/g' \
-  -e '1 s/"/\&quot;/g' \
-  -e '1 s/</\&lt;/g' \
-  -e '1 s/>/\&gt;/g' \
-  source/tutorials/changelog.md
-cp source/tutorials/changelog.md source/zh-cn/tutorials/changelog.md
-
-sed -i -e '1i\---\ntitle: Changelog\nauto: true\n---\n' source/tutorials/changelog.md
-sed -i -e '1i\---\ntitle: 更新日志\nauto: true\n---\n' source/zh-cn/tutorials/changelog.md
diff --git a/bin/build-contributors.js b/bin/build-contributors.js
new file mode 100644
index 000000000..d2c774c91
--- /dev/null
+++ b/bin/build-contributors.js
@@ -0,0 +1,39 @@
+const fs = require('fs')
+const path = require('path')
+
+const root = path.resolve(__dirname, '..')
+const readme = fs.readFileSync(path.join(root, 'README.md'), 'utf8').replace(/\r\n/g, '\n')
+
+function extractSection (text, beginMarker, endMarker) {
+  const lines = text.split('\n')
+  let inside = false
+  const result = []
+  for (const line of lines) {
+    if (line.includes(endMarker)) inside = false
+    if (inside) result.push(line)
+    if (line.includes(beginMarker)) inside = true
+  }
+  return result.join('\n')
+}
+
+function transformContributors (html) {
+  return html
+    .replace(/<br \/>.*?<\/td>/g, '</a></td>')
+    .replace(/width="[^"]*"/g, '')
+    .replace(/\n/g, '')
+    .replace(/<\/tr>\s*<tr>/g, '')
+}
+
+function transformFinancial (html) {
+  return html
+    .replace(/<br \/>.*?<\/td>/g, '</a></td>')
+    .replace(/\n/g, '')
+    .replace(/<\/tr>\s*<tr>/g, '')
+}
+
+const allContributors = transformContributors(extractSection(readme, 'ALL-CONTRIBUTORS-LIST:START', 'ALL-CONTRIBUTORS-LIST:END'))
+const financialContributors = transformFinancial(extractSection(readme, 'FINANCIAL-CONTRIBUTORS-BEGIN', 'FINANCIAL-CONTRIBUTORS-END'))
+
+const outDir = path.join(root, 'docs/themes/navy/layout/partial')
+fs.writeFileSync(path.join(outDir, 'all-contributors.swig'), allContributors)
+fs.writeFileSync(path.join(outDir, 'financial-contributors.swig'), financialContributors)
diff --git a/bin/build-contributors.sh b/bin/build-contributors.sh
deleted file mode 100755
index 5ea7b6290..000000000
--- a/bin/build-contributors.sh
+++ /dev/null
@@ -1,25 +0,0 @@
-#!/usr/bin/env bash
-
-# Run `sed` in a way that's compatible with both macOS (BSD) and Linux (GNU)
-sedi() {
-  if [[ "$OSTYPE" == "darwin"* ]]; then
-    /usr/bin/sed -i '' "$@"
-  else
-    sed -i "$@"
-  fi
-}
-
-# create docs/themes/navy/layout/partial/all-contributors.swig
-awk '/ALL-CONTRIBUTORS-LIST:START/{flag=1;next}/ALL-CONTRIBUTORS-LIST:END/{flag=0}flag' README.md | \
-  sed 's/<br \/>.*<\/td>/<\/a><\/td>/g' | \
-  sed 's/width="[^"]*"//g' | \
-  tr -d '\n' | \
-  sed 's/<\/tr>\s*<tr>//g' \
-  > docs/themes/navy/layout/partial/all-contributors.swig
-
-# create docs/themes/navy/layout/partial/financial-contributors.swig
-awk '/FINANCIAL-CONTRIBUTORS-BEGIN/{flag=1;next}/FINANCIAL-CONTRIBUTORS-END/{flag=0}flag' README.md | \
-  sed 's/<br \/>.*<\/td>/<\/a><\/td>/g' | \
-  tr -d '\n' | \
-  sed 's/<\/tr>\s*<tr>//g' \
-  > docs/themes/navy/layout/partial/financial-contributors.swig
diff --git a/bin/build-docs-liquid.sh b/bin/build-docs-liquid.sh
deleted file mode 100755
index 72d203fce..000000000
--- a/bin/build-docs-liquid.sh
+++ /dev/null
@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-
-BUNDLES=min npm run build
-mkdir -p docs/public/js/
-cp dist/liquid.browser.min.js docs/public/js/
-
diff --git a/bin/build-docs.sh b/bin/build-docs.sh
deleted file mode 100755
index 3d9fb1dda..000000000
--- a/bin/build-docs.sh
+++ /dev/null
@@ -1,17 +0,0 @@
-#!/usr/bin/env bash
-
-set -ex
-
-./bin/build-docs-liquid.sh
-./bin/build-contributors.sh
-./bin/build-apidoc.sh
-./bin/build-changelog.sh
-
-cd docs
-npm ci
-npm run build
-cp CNAME public/
-
-if [ "$HEXO_ALGOLIA_INDEXING_KEY" != "" ]; then
-    npm run index
-fi
diff --git a/bin/build-icons.sh b/bin/build-icons.sh
deleted file mode 100755
index 2a9737433..000000000
--- a/bin/build-icons.sh
+++ /dev/null
@@ -1,36 +0,0 @@
-#!/usr/bin/env bash
-
-# Prerequisites:
-# 1.imagemagick. try brew install imagemagick
-# 2. logo.png in size 512x512
-# 3. this script should be run with cwd docs/source/icon/
-
-echo creating apple touch icons...
-apple=(57x57 60x60 72x72 76x76 114x114 120x120 144x144 152x152)
-for size in "${apple[@]}"; do
-    echo $size
-    convert logo.png -resize $size apple-touch-icon-$size.png
-done
-cp logo.png apple-touch-icon.png
-convert logo.png \
-     \( +clone -alpha extract \
-        -draw 'fill black polygon 0,0 0,80 80,0 fill white circle 80,80 80,0' \
-        \( +clone -flip \) -compose Multiply -composite \
-        \( +clone -flop \) -compose Multiply -composite \
-     \) -alpha off -compose CopyOpacity -composite apple-touch-icon-precomposed.png
-
-echo creating favicon...
-convert logo.png -resize 48x48 ../favicon.ico
-favicon=(16x16 32x32 96x96 160x160 196x196)
-for size in "${favicon[@]}"; do
-    echo $size
-    convert logo.png -resize $size favicon-$size.png
-done
-
-echo creating mstile icons...
-mstile=(70x70 144x144 150x150 310x310)
-for size in "${mstile[@]}"; do
-    echo $size
-    convert logo.png -resize $size mstile-$size.png
-done
-convert mstile-150x150.png -gravity center -background white -extent 310x150 mstile-310x150.png
\ No newline at end of file
diff --git a/bin/perf-diff.js b/bin/perf-diff.js
new file mode 100644
index 000000000..dfedbc0ff
--- /dev/null
+++ b/bin/perf-diff.js
@@ -0,0 +1,17 @@
+const { execSync } = require('child_process')
+const fs = require('fs')
+const path = require('path')
+
+const root = path.resolve(__dirname, '..')
+const version = require(path.join(root, 'package.json')).version
+
+const fileLocal = path.join(root, 'dist/liquid.node.js')
+const fileLatest = path.join(root, `dist/liquid.node.${version}.js`)
+
+if (!fs.existsSync(fileLatest)) {
+  const url = `https://unpkg.com/liquidjs@${version}/dist/liquid.node.js`
+  console.log(`Downloading liquidjs@${version}...`)
+  execSync(`curl -sL -o "${fileLatest}" "${url}"`)
+}
+
+execSync(`node benchmark/diff.js "${fileLocal}" "${fileLatest}"`, { cwd: root, stdio: 'inherit' })
diff --git a/bin/perf-diff.sh b/bin/perf-diff.sh
deleted file mode 100755
index 98146ee5e..000000000
--- a/bin/perf-diff.sh
+++ /dev/null
@@ -1,12 +0,0 @@
-#!/usr/bin/env bash
-
-VERSION_LATEST=$(cat package.json | grep '"version":' | head -1 | awk -F'"' '{print $4}')
-FILE_LOCAL=dist/liquid.node.js
-FILE_LATEST=dist/liquid.node.$VERSION_LATEST.js
-URL_LATEST=https://unpkg.com/liquidjs@$VERSION_LATEST/dist/liquid.node.js
-
-if [ ! -f "$FILE_LATEST" ]; then
-    curl $URL_LATEST > $FILE_LATEST
-fi
-
-exec node benchmark/diff.js $FILE_LOCAL $FILE_LATEST
diff --git a/package-lock.json b/package-lock.json
index 47aba7346..7bbc93931 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -48,12 +48,14 @@
         "husky": "^4.2.5",
         "jest": "^29.5.0",
         "jsdom": "^16.5.0",
+        "npm-run-all2": "^8.0.4",
         "rollup": "^1.26.3",
         "rollup-plugin-replace": "^2.1.0",
         "rollup-plugin-typescript2": "^0.31.1",
         "rollup-plugin-uglify": "^6.0.4",
         "rollup-plugin-version-injector": "^1.3.3",
         "semantic-release": "^25.0.3",
+        "shx": "^0.4.0",
         "sinon": "^15.0.2",
         "supertest": "^3.4.2",
         "ts-jest": "^29.0.5",
@@ -151,6 +153,7 @@
       "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.21.3.tgz",
       "integrity": "sha512-qIJONzoa/qiHghnm0l1n4i/6IIziDpzqc36FBs4pzMhDUraHqponwJLiAKm1hGLP3OSB/TVNz6rMwVGpwxxySw==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@ampproject/remapping": "^2.2.0",
         "@babel/code-frame": "^7.18.6",
@@ -1530,6 +1533,7 @@
       "integrity": "sha512-DhGl4xMVFGVIyMwswXeyzdL4uXD5OGILGX5N8Y+f6W7LhC1Ze2poSNrkF/fedpVDHEEZ+PHFW0vL14I+mm8K3Q==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@octokit/auth-token": "^6.0.0",
         "@octokit/graphql": "^9.0.3",
@@ -2876,6 +2880,7 @@
       "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-5.55.0.tgz",
       "integrity": "sha512-ppvmeF7hvdhUUZWSd2EEWfzcFkjJzgNQzVST22nzg958CR+sphy8A6K7LXQZd6V75m1VKjp+J4g/PCEfSCmzhw==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@typescript-eslint/scope-manager": "5.55.0",
         "@typescript-eslint/types": "5.55.0",
@@ -3091,6 +3096,7 @@
       "resolved": "https://registry.npmjs.org/acorn/-/acorn-7.4.1.tgz",
       "integrity": "sha512-nQyp0o1/mNdbTO1PO6kHkwSrmgZ0MT/jCCpNiwbUjGoRN4dlBhqJtoQuCnEOKzgTVwg0ZWiCoQy6SxMebQVh8A==",
       "dev": true,
+      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -3720,12 +3726,13 @@
       }
     },
     "node_modules/braces": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.2.tgz",
-      "integrity": "sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==",
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "fill-range": "^7.0.1"
+        "fill-range": "^7.1.1"
       },
       "engines": {
         "node": ">=8"
@@ -3752,6 +3759,7 @@
           "url": "https://tidelift.com/funding/github/npm/browserslist"
         }
       ],
+      "peer": true,
       "dependencies": {
         "caniuse-lite": "^1.0.30001449",
         "electron-to-chromium": "^1.4.284",
@@ -4879,6 +4887,16 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/end-of-stream": {
+      "version": "1.4.5",
+      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.5.tgz",
+      "integrity": "sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "once": "^1.4.0"
+      }
+    },
     "node_modules/enquirer": {
       "version": "2.3.6",
       "resolved": "https://registry.npmjs.org/enquirer/-/enquirer-2.3.6.tgz",
@@ -5293,6 +5311,7 @@
       "integrity": "sha512-VHZ8gX+EDfz+97jGcgyGCyRia/dPOd6Xh9yPv8Bl1+SoaIwD+a/vlrOmGRUyOYu7MwUhc7CxqeaDZU13S4+EpA==",
       "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@babel/code-frame": "7.12.11",
         "@eslint/eslintrc": "^0.4.3",
@@ -5470,6 +5489,7 @@
       "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.27.5.tgz",
       "integrity": "sha512-LmEt3GVofgiGuiE+ORpnvP+kAm3h6MLZJ4Q5HCyHADofsb4VzXFsRiWj3c0OFiV+3DWFh0qg3v9gcPlfc3zRow==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "array-includes": "^3.1.6",
         "array.prototype.flat": "^1.3.1",
@@ -5544,6 +5564,7 @@
       "resolved": "https://registry.npmjs.org/eslint-plugin-node/-/eslint-plugin-node-8.0.1.tgz",
       "integrity": "sha512-ZjOjbjEi6jd82rIpFSgagv4CHWzG9xsQAVp1ZPlhRnnYxcTgENUVBvhYmkQ7GvT1QFijUSo69RaiOJKhMu6i8w==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "eslint-plugin-es": "^1.3.1",
         "eslint-utils": "^1.3.1",
@@ -5594,6 +5615,7 @@
       "resolved": "https://registry.npmjs.org/eslint-plugin-promise/-/eslint-plugin-promise-4.3.1.tgz",
       "integrity": "sha512-bY2sGqyptzFBDLh/GMbAxfdJC+b0f23ME63FOE4+Jao0oZ3E1LEwFtWJX/1pGMJLiTtrSSern2CRM/g+dfc0eQ==",
       "dev": true,
+      "peer": true,
       "engines": {
         "node": ">=6"
       }
@@ -5617,6 +5639,7 @@
           "url": "https://feross.org/support"
         }
       ],
+      "peer": true,
       "peerDependencies": {
         "eslint": ">=5.0.0"
       }
@@ -6002,16 +6025,17 @@
       "dev": true
     },
     "node_modules/fast-glob": {
-      "version": "3.2.12",
-      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.2.12.tgz",
-      "integrity": "sha512-DVj4CQIYYow0BlaelwK1pHl5n5cRSJfM60UA0zK891sVInoPri2Ekj7+e1CT3/3qxXenpI+nBBmQAcJPJgaj4w==",
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "@nodelib/fs.stat": "^2.0.2",
         "@nodelib/fs.walk": "^1.2.3",
         "glob-parent": "^5.1.2",
         "merge2": "^1.3.0",
-        "micromatch": "^4.0.4"
+        "micromatch": "^4.0.8"
       },
       "engines": {
         "node": ">=8.6.0"
@@ -6075,10 +6099,11 @@
       }
     },
     "node_modules/fill-range": {
-      "version": "7.0.1",
-      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.0.1.tgz",
-      "integrity": "sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==",
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "to-regex-range": "^5.0.1"
       },
@@ -7195,6 +7220,16 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/interpret": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/interpret/-/interpret-1.4.0.tgz",
+      "integrity": "sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/into-stream": {
       "version": "6.0.0",
       "resolved": "https://registry.npmjs.org/into-stream/-/into-stream-6.0.0.tgz",
@@ -7363,6 +7398,7 @@
       "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
       "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
       "dev": true,
+      "license": "MIT",
       "engines": {
         "node": ">=0.12.0"
       }
@@ -8963,6 +8999,7 @@
       "integrity": "sha512-8dD6FusOQSrpv9Z1rdNMdlSgQOIP880DHqnohobOmYLElGEqAL/JvxvuxZO16r4HtjTlfPRDC1hbvxC9dPN2nA==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "bin": {
         "marked": "bin/marked.js"
       },
@@ -9049,6 +9086,15 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
     "node_modules/meow": {
       "version": "8.1.2",
       "resolved": "https://registry.npmjs.org/meow/-/meow-8.1.2.tgz",
@@ -9105,12 +9151,13 @@
       }
     },
     "node_modules/micromatch": {
-      "version": "4.0.5",
-      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.5.tgz",
-      "integrity": "sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==",
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
-        "braces": "^3.0.2",
+        "braces": "^3.0.3",
         "picomatch": "^2.3.1"
       },
       "engines": {
@@ -9543,6 +9590,95 @@
         "node": "^20.17.0 || >=22.9.0"
       }
     },
+    "node_modules/npm-normalize-package-bin": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-4.0.0.tgz",
+      "integrity": "sha512-TZKxPvItzai9kN9H/TkmCtx/ZN/hvr3vUycjlfmH0ootY9yFBzNOpiXAdIn1Iteqsvk4lQn6B5PTrt+n6h8k/w==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/npm-run-all2": {
+      "version": "8.0.4",
+      "resolved": "https://registry.npmjs.org/npm-run-all2/-/npm-run-all2-8.0.4.tgz",
+      "integrity": "sha512-wdbB5My48XKp2ZfJUlhnLVihzeuA1hgBnqB2J9ahV77wLS+/YAJAlN8I+X3DIFIPZ3m5L7nplmlbhNiFDmXRDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^6.2.1",
+        "cross-spawn": "^7.0.6",
+        "memorystream": "^0.3.1",
+        "picomatch": "^4.0.2",
+        "pidtree": "^0.6.0",
+        "read-package-json-fast": "^4.0.0",
+        "shell-quote": "^1.7.3",
+        "which": "^5.0.0"
+      },
+      "bin": {
+        "npm-run-all": "bin/npm-run-all/index.js",
+        "npm-run-all2": "bin/npm-run-all/index.js",
+        "run-p": "bin/run-p/index.js",
+        "run-s": "bin/run-s/index.js"
+      },
+      "engines": {
+        "node": "^20.5.0 || >=22.0.0",
+        "npm": ">= 10"
+      }
+    },
+    "node_modules/npm-run-all2/node_modules/ansi-styles": {
+      "version": "6.2.3",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+      "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/npm-run-all2/node_modules/isexe": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-3.1.5.tgz",
+      "integrity": "sha512-6B3tLtFqtQS4ekarvLVMZ+X+VlvQekbe4taUkf/rhVO3d/h0M2rfARm/pXLcPEsjjMsFgrFgSrhQIxcSVrBz8w==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/npm-run-all2/node_modules/picomatch": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/npm-run-all2/node_modules/which": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/which/-/which-5.0.0.tgz",
+      "integrity": "sha512-JEdGzHwwkrbWoGOlIHqQ5gtprKGOenpDHpxE9zVR1bWbOtYRyPPHMe9FaP6x61CmNaTThSkb0DAJte5jD+DmzQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^3.1.1"
+      },
+      "bin": {
+        "node-which": "bin/which.js"
+      },
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
     "node_modules/npm-run-path": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
@@ -11275,6 +11411,7 @@
       "dev": true,
       "inBundle": true,
       "license": "MIT",
+      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -11584,6 +11721,16 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/p-finally": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/p-finally/-/p-finally-1.0.0.tgz",
+      "integrity": "sha512-LICb2p9CB7FS+0eR1oqWnHhp0FljGLZCWBE9aix0Uye9W8LTQPwMTYVGWQWIw9RdQiDg4+epXQODwIYJtSJaow==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
     "node_modules/p-is-promise": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/p-is-promise/-/p-is-promise-3.0.0.tgz",
@@ -11842,6 +11989,19 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/pidtree": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/pidtree/-/pidtree-0.6.0.tgz",
+      "integrity": "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "pidtree": "bin/pidtree.js"
+      },
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
     "node_modules/pify": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/pify/-/pify-5.0.0.tgz",
@@ -12135,6 +12295,17 @@
       "integrity": "sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag==",
       "dev": true
     },
+    "node_modules/pump": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/pump/-/pump-3.0.4.tgz",
+      "integrity": "sha512-VS7sjc6KR7e1ukRFhQSY5LM2uBWAUPiOPa/A3mkKmiMwSmRFUITt0xuj+/lesgnCv+dPIEYlkzrcyXgquIHMcA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "end-of-stream": "^1.1.0",
+        "once": "^1.3.1"
+      }
+    },
     "node_modules/punycode": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.0.tgz",
@@ -12275,6 +12446,30 @@
       "integrity": "sha512-xWGDIW6x921xtzPkhiULtthJHoJvBbF3q26fzloPCK0hsvxtPVelvftw3zjbHWSkR2km9Z+4uxbDDK/6Zw9B8w==",
       "dev": true
     },
+    "node_modules/read-package-json-fast": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/read-package-json-fast/-/read-package-json-fast-4.0.0.tgz",
+      "integrity": "sha512-qpt8EwugBWDw2cgE2W+/3oxC+KTez2uSVR8JU9Q36TXPAGCaozfQUs59v4j4GFpWTaw0i6hAZSvOmu1J0uOEUg==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "json-parse-even-better-errors": "^4.0.0",
+        "npm-normalize-package-bin": "^4.0.0"
+      },
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
+    "node_modules/read-package-json-fast/node_modules/json-parse-even-better-errors": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-4.0.0.tgz",
+      "integrity": "sha512-lR4MXjGNgkJc7tkQ97kb2nuEMnNCyU//XYVH0MKTGcXEiSudQ5MKGKen3C5QubYy0vmq+JGitUg92uuywGEwIA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^18.17.0 || >=20.5.0"
+      }
+    },
     "node_modules/read-package-up": {
       "version": "12.0.0",
       "resolved": "https://registry.npmjs.org/read-package-up/-/read-package-up-12.0.0.tgz",
@@ -12502,6 +12697,18 @@
         "node": ">= 6"
       }
     },
+    "node_modules/rechoir": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
+      "integrity": "sha512-HFM8rkZ+i3zrV+4LQjwQ0W+ez98pApMGM3HUrN04j3CqzPOzl9nmP15Y8YXNm8QHGv/eacOVEjqhmWpkRV0NAw==",
+      "dev": true,
+      "dependencies": {
+        "resolve": "^1.1.6"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/redent": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/redent/-/redent-3.0.0.tgz",
@@ -12727,6 +12934,7 @@
       "resolved": "https://registry.npmjs.org/rollup/-/rollup-1.32.1.tgz",
       "integrity": "sha512-/2HA0Ec70TvQnXdzynFffkjA6XN+1e2pEv/uKS5Ulca40g2L7KuOE3riasHoNVHOsFD5KKZgDsMk1CP3Tw9s+A==",
       "dev": true,
+      "peer": true,
       "dependencies": {
         "@types/estree": "*",
         "@types/node": "*",
@@ -12965,6 +13173,7 @@
       "integrity": "sha512-WRgl5GcypwramYX4HV+eQGzUbD7UUbljVmS+5G1uMwX/wLgYuJAxGeerXJDMO2xshng4+FXqCgyB5QfClV6WjA==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "dependencies": {
         "@semantic-release/commit-analyzer": "^13.0.1",
         "@semantic-release/error": "^4.0.0",
@@ -13877,6 +14086,166 @@
         "node": ">=8"
       }
     },
+    "node_modules/shell-quote": {
+      "version": "1.8.3",
+      "resolved": "https://registry.npmjs.org/shell-quote/-/shell-quote-1.8.3.tgz",
+      "integrity": "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/shelljs": {
+      "version": "0.9.2",
+      "resolved": "https://registry.npmjs.org/shelljs/-/shelljs-0.9.2.tgz",
+      "integrity": "sha512-S3I64fEiKgTZzKCC46zT/Ib9meqofLrQVbpSswtjFfAVDW+AZ54WTnAM/3/yENoxz/V1Cy6u3kiiEbQ4DNphvw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "execa": "^1.0.0",
+        "fast-glob": "^3.3.2",
+        "interpret": "^1.0.0",
+        "rechoir": "^0.6.2"
+      },
+      "bin": {
+        "shjs": "bin/shjs"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/shelljs/node_modules/cross-spawn": {
+      "version": "6.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-6.0.6.tgz",
+      "integrity": "sha512-VqCUuhcd1iB+dsv8gxPttb5iZh/D0iubSP21g36KXdEuf6I5JiioesUVjpCdHV9MZRUfVFlvwtIUyPfxo5trtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "nice-try": "^1.0.4",
+        "path-key": "^2.0.1",
+        "semver": "^5.5.0",
+        "shebang-command": "^1.2.0",
+        "which": "^1.2.9"
+      },
+      "engines": {
+        "node": ">=4.8"
+      }
+    },
+    "node_modules/shelljs/node_modules/execa": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-1.0.0.tgz",
+      "integrity": "sha512-adbxcyWV46qiHyvSp50TKt05tB4tK3HcmF7/nxfAdhnox83seTDbwnaqKO4sXRy7roHAIFqJP/Rw/AuEbX61LA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cross-spawn": "^6.0.0",
+        "get-stream": "^4.0.0",
+        "is-stream": "^1.1.0",
+        "npm-run-path": "^2.0.0",
+        "p-finally": "^1.0.0",
+        "signal-exit": "^3.0.0",
+        "strip-eof": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/shelljs/node_modules/get-stream": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-4.1.0.tgz",
+      "integrity": "sha512-GMat4EJ5161kIy2HevLlr4luNjBgvmj413KaQA7jt4V8B4RDsfpHk7WQ9GVqfYyyx8OS/L66Kox+rJRNklLK7w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "pump": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/shelljs/node_modules/is-stream": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-1.1.0.tgz",
+      "integrity": "sha512-uQPm8kcs47jx38atAcWTVxyltQYoPT68y9aWYdV6yWXSyW8mzSat0TL6CiWdZeCdF3KrAvpVtnHbTv4RN+rqdQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/shelljs/node_modules/npm-run-path": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-2.0.2.tgz",
+      "integrity": "sha512-lJxZYlT4DW/bRUtFh1MQIWqmLwQfAxnqWG4HhEdjMlkrJYnJn0Jrr2u3mgxqaWsdiBc76TYkTG/mhrnYTuzfHw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/shelljs/node_modules/path-key": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-2.0.1.tgz",
+      "integrity": "sha512-fEHGKCSmUSDPv4uoj8AlD+joPlq3peND+HRYyxFz4KPw4z926S/b8rIuFs2FYJg3BwsxJf6A9/3eIdLaYC+9Dw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/shelljs/node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/shelljs/node_modules/shebang-command": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-1.2.0.tgz",
+      "integrity": "sha512-EV3L1+UQWGor21OmnvojK36mhg+TyIKDh3iFBKBohr5xeXIhNBcx8oWdgkTEEQ+BEFFYdLRuqMfd5L84N1V5Vg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/shelljs/node_modules/shebang-regex": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-1.0.0.tgz",
+      "integrity": "sha512-wpoSFAxys6b2a2wHZ1XpDSgD7N9iVjg29Ph9uV/uaP9Ex/KXlkTZTeddxDPSYQpgvzKLGJke2UU0AzoGCjNIvQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/shelljs/node_modules/which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "which": "bin/which"
+      }
+    },
     "node_modules/shiki": {
       "version": "1.13.0",
       "resolved": "https://registry.npmjs.org/shiki/-/shiki-1.13.0.tgz",
@@ -13887,6 +14256,23 @@
         "@types/hast": "^3.0.4"
       }
     },
+    "node_modules/shx": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/shx/-/shx-0.4.0.tgz",
+      "integrity": "sha512-Z0KixSIlGPpijKgcH6oCMCbltPImvaKy0sGH8AkLRXw1KyzpKtaCTizP2xen+hNDqVF4xxgvA0KXSb9o4Q6hnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "minimist": "^1.2.8",
+        "shelljs": "^0.9.2"
+      },
+      "bin": {
+        "shx": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/side-channel": {
       "version": "1.0.4",
       "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.0.4.tgz",
@@ -14356,6 +14742,16 @@
         "node": ">=4"
       }
     },
+    "node_modules/strip-eof": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-eof/-/strip-eof-1.0.0.tgz",
+      "integrity": "sha512-7FCwGGmx8mD5xQd3RPUvnSpUXHM3BWuzjtpD4TXsfcZ9EL4azvVVUscFYwD9nx8Kh+uCBC00XBtAykoMHwTh8Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/strip-final-newline": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
@@ -14756,6 +15152,7 @@
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
+      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -14795,6 +15192,7 @@
       "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
       "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
       "dev": true,
+      "license": "MIT",
       "dependencies": {
         "is-number": "^7.0.0"
       },
@@ -15111,6 +15509,7 @@
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-4.9.5.tgz",
       "integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==",
       "dev": true,
+      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"
diff --git a/package.json b/package.json
index 19b18f4e9..7210c81b3 100644
--- a/package.json
+++ b/package.json
@@ -21,7 +21,7 @@
     "test:coverage": "jest --coverage src test/integration",
     "test:e2e": "jest test/e2e",
     "test:demo": "./test/demo/test.sh",
-    "perf:diff": "bin/perf-diff.sh",
+    "perf:diff": "node bin/perf-diff.js",
     "perf:engines": "cd benchmark && npm run engines",
     "version": "npm run build && npm test",
     "build": "rollup -c rollup.config.mjs",
@@ -29,7 +29,12 @@
     "build:min": "BUNDLES=min rollup -c rollup.config.mjs",
     "build:umd": "BUNDLES=umd rollup -c rollup.config.mjs",
     "build:charmap": "./bin/character-gen.js > src/util/character.ts",
-    "build:docs": "bin/build-docs.sh"
+    "build:docs": "run-s build:docs-liquid build:contributors build:apidoc build:changelog build:docs-hexo",
+    "build:docs-liquid": "cross-env BUNDLES=min rollup -c rollup.config.mjs && shx mkdir -p docs/public/js && shx cp dist/liquid.browser.min.js docs/public/js/",
+    "build:contributors": "node bin/build-contributors.js",
+    "build:apidoc": "shx rm -rf docs/source/api && typedoc --plugin typedoc-plugin-missing-exports ./src --gitRevision master --out docs/source/api",
+    "build:changelog": "node bin/build-changelog.js",
+    "build:docs-hexo": "cd docs && npm ci && npm run build && shx cp CNAME public/"
   },
   "bin": {
     "liquidjs": "./bin/liquid.js",
@@ -95,12 +100,14 @@
     "husky": "^4.2.5",
     "jest": "^29.5.0",
     "jsdom": "^16.5.0",
+    "npm-run-all2": "^8.0.4",
     "rollup": "^1.26.3",
     "rollup-plugin-replace": "^2.1.0",
     "rollup-plugin-typescript2": "^0.31.1",
     "rollup-plugin-uglify": "^6.0.4",
     "rollup-plugin-version-injector": "^1.3.3",
     "semantic-release": "^25.0.3",
+    "shx": "^0.4.0",
     "sinon": "^15.0.2",
     "supertest": "^3.4.2",
     "ts-jest": "^29.0.5",

From 4af7be695cb715bf227113729d36396d45ee922a Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 7 Apr 2026 17:18:16 +0000
Subject: [PATCH 29/64] chore(release): 10.25.5 [skip ci]

## [10.25.5](https://github.com/harttle/liquidjs/compare/v10.25.4...v10.25.5) (2026-04-07)

### Bug Fixes

* enforce root containment for renderFile/parseFile lookups ([#870](https://github.com/harttle/liquidjs/issues/870)) ([f41c1fc](https://github.com/harttle/liquidjs/commit/f41c1fc02fe901598f3328118b42b13bc6bc9b04))
* null date should return empty ([#868](https://github.com/harttle/liquidjs/issues/868)) ([#872](https://github.com/harttle/liquidjs/issues/872)) ([4f9a499](https://github.com/harttle/liquidjs/commit/4f9a49988a93c156524981e189a4fec238e682b8))
* rounding negative away from zero when half ([#873](https://github.com/harttle/liquidjs/issues/873)) ([1cdf10b](https://github.com/harttle/liquidjs/commit/1cdf10b57d82f0592414efbfca19e204b37aea9f))
---
 CHANGELOG.md      | 9 +++++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d7cb307da..5d3e96a6a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,12 @@
+## [10.25.5](https://github.com/harttle/liquidjs/compare/v10.25.4...v10.25.5) (2026-04-07)
+
+
+### Bug Fixes
+
+* enforce root containment for renderFile/parseFile lookups ([#870](https://github.com/harttle/liquidjs/issues/870)) ([f41c1fc](https://github.com/harttle/liquidjs/commit/f41c1fc02fe901598f3328118b42b13bc6bc9b04))
+* null date should return empty ([#868](https://github.com/harttle/liquidjs/issues/868)) ([#872](https://github.com/harttle/liquidjs/issues/872)) ([4f9a499](https://github.com/harttle/liquidjs/commit/4f9a49988a93c156524981e189a4fec238e682b8))
+* rounding negative away from zero when half ([#873](https://github.com/harttle/liquidjs/issues/873)) ([1cdf10b](https://github.com/harttle/liquidjs/commit/1cdf10b57d82f0592414efbfca19e204b37aea9f))
+
 ## [10.25.4](https://github.com/harttle/liquidjs/compare/v10.25.3...v10.25.4) (2026-04-07)
 
 
diff --git a/package-lock.json b/package-lock.json
index 7bbc93931..c4a1bc368 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.4",
+  "version": "10.25.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.4",
+      "version": "10.25.5",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 7210c81b3..14100eec9 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.4",
+  "version": "10.25.5",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 2def22c85ea7a13cf5e9f682fef412774a184e8e Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 19 Apr 2026 21:38:15 +0800
Subject: [PATCH 30/64] docs(readme): add Kibana to README.md (#882)

* docs(readme): add Kibana and Sentry to Who's Using LiquidJS

Made-with: Cursor

* docs(readme): drop Semgrep and Sentry from Who's Using; keep Kibana

Made-with: Cursor

* docs(readme): restore Sentry in financial sponsors block

Made-with: Cursor

* docs(readme): restore Timmy Braun in all-contributors table

Made-with: Cursor
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 31f473426..48c567826 100644
--- a/README.md
+++ b/README.md
@@ -54,9 +54,9 @@ For more details, refer to the [Setup Guide][setup].
 
 - [Eleventy](https://www.11ty.dev/): Eleventy, a simpler static site generator.
 - [Github Docs](https://github.com/github/docs): The open-source repo for docs.github.com.
+- [Kibana](https://github.com/elastic/kibana): Elastic's analytics and visualization platform for Elasticsearch; workflow features use LiquidJS for Liquid templates.
 - [Opensense](https://www.opensense.com/): The smarter way to send email.
 - [Directus](https://docs.directus.io/): an instant REST+GraphQL API and intuitive no-code data collaboration app for any SQL database.
-- [Semgrep](https://github.com/returntocorp/semgrep): Lightweight static analysis for many languages.
 - [Rock](https://www.rockrms.com/): An open source CMS, Relationship Management System (RMS) and Church Management System (ChMS) all rolled into one.
 - [Mitosis](https://github.com/BuilderIO/mitosis): Write components once, run everywhere. Compiles to React, Vue, Qwik, Solid, Angular, Svelte, and more.
 - [Pattern Lab](https://patternlab.io/): a frontend workshop environment that helps you build, view, test, and showcase your design system's UI components.

From e2311dfd6e82f73509308aa8a3a1fafc92e226f0 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 19 Apr 2026 23:41:35 +0800
Subject: [PATCH 31/64] fix: nested block for layout (#883)

---
 .all-contributorsrc                   |  2 +-
 .cursor/rules/testing.mdc             | 17 +++++++++++++
 README.md                             |  2 +-
 src/context/context.ts                |  4 +--
 src/tags/block.ts                     | 11 ++++++---
 src/tags/cycle.ts                     |  2 +-
 src/tags/for.ts                       |  2 +-
 src/tags/layout.ts                    |  2 +-
 test/e2e/parse-and-render.spec.ts     | 35 +++++++++++++++++++++++++++
 test/integration/tags/include.spec.ts |  2 +-
 test/integration/tags/layout.spec.ts  | 21 ++++++++++++++++
 11 files changed, 89 insertions(+), 11 deletions(-)
 create mode 100644 .cursor/rules/testing.mdc

diff --git a/.all-contributorsrc b/.all-contributorsrc
index ad5c1bf1b..b29f4c2bd 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -14,7 +14,7 @@
       "login": "harttle",
       "name": "Jun Yang",
       "avatar_url": "https://avatars3.githubusercontent.com/u/4427974?v=4",
-      "profile": "https://harttle.land",
+      "profile": "https://github.com/harttle",
       "contributions": [
         "maintenance",
         "code"
diff --git a/.cursor/rules/testing.mdc b/.cursor/rules/testing.mdc
new file mode 100644
index 000000000..6c27faae0
--- /dev/null
+++ b/.cursor/rules/testing.mdc
@@ -0,0 +1,17 @@
+---
+description: Testing conventions — e2e uses built dist, integration uses src
+globs: test/**/*.ts
+alwaysApply: false
+---
+
+# Testing
+
+## End-to-end tests (`test/e2e`)
+
+- **Use the built package**, not TypeScript sources under `src/`.
+- Import the public API from the package root (for example `import { Liquid } from '../..'`), which resolves through `package.json` to **`dist/`** (`main`, `module`, etc.).
+- **Avoid** `import … from '../../src/liquid'` (or other `src/` paths) in `test/e2e/**` so e2e matches what consumers get from npm and you do not depend on an unbuilt tree.
+
+## Integration and unit tests
+
+- Tests under `test/integration/`, `src/**/*.spec.ts`, and similar may import from **`src/`** when the suite is meant to run against the current TypeScript sources (typical for this repo’s Jest setup).
diff --git a/README.md b/README.md
index 48c567826..bd928e96b 100644
--- a/README.md
+++ b/README.md
@@ -108,7 +108,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
 <table>
   <tbody>
     <tr>
-      <td align="center" valign="top" width="14.28%"><a href="https://harttle.land"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4?s=100" width="100px;" alt="Jun Yang"/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/harttle"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4?s=100" width="100px;" alt="Jun Yang"/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4?s=100" width="100px;" alt="chenos"/><br /><sub><b>chenos</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=chenos" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4?s=100" width="100px;" alt="Zach Leatherman"/><br /><sub><b>Zach Leatherman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/issues?q=author%3Azachleat" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4?s=100" width="100px;" alt="Tim Hardy"/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
diff --git a/src/context/context.ts b/src/context/context.ts
index ce396fe36..5a0fe576a 100644
--- a/src/context/context.ts
+++ b/src/context/context.ts
@@ -48,8 +48,8 @@ export class Context {
     this.memoryLimit = memoryLimit ?? new Limiter('memory alloc', renderOptions.memoryLimit ?? opts.memoryLimit)
     this.renderLimit = renderLimit ?? new Limiter('template render', getPerformance().now() + (renderOptions.renderLimit ?? opts.renderLimit))
   }
-  public getRegister (key: string) {
-    return (this.registers[key] = this.registers[key] || {})
+  public getRegister<T> (key: string, defaultValue: T = undefined as T): T {
+    return (this.registers[key] = this.registers[key] || defaultValue)
   }
   public setRegister (key: string, value: any) {
     return (this.registers[key] = value)
diff --git a/src/tags/block.ts b/src/tags/block.ts
index 6ae147ac0..947f0b3e5 100644
--- a/src/tags/block.ts
+++ b/src/tags/block.ts
@@ -23,20 +23,25 @@ export default class extends Tag {
   * render (ctx: Context, emitter: Emitter) {
     const blockRender = this.getBlockRender(ctx)
     if (ctx.getRegister('blockMode') === BlockMode.STORE) {
-      ctx.getRegister('blocks')[this.block] = blockRender
+      ctx.getRegister('blocks', {} as Record<string, any>)[this.block] = blockRender
     } else {
       yield blockRender(new BlockDrop(), emitter)
     }
   }
 
   private getBlockRender (ctx: Context) {
+    const self = this as Tag
     const { liquid, templates } = this
-    const renderChild = ctx.getRegister('blocks')[this.block]
+    const renderChild = ctx.getRegister('blocks', {} as Record<string, any>)[this.block]
     const renderCurrent = function * (superBlock: BlockDrop, emitter: Emitter) {
-      // add {{ block.super }} support when rendering
+      const stack: Tag[] = ctx.getRegister('blockStack', [])
+      if (stack.includes(self)) throw new Error('block tag cannot be nested')
+
+      stack.push(self)
       ctx.push({ block: superBlock })
       yield liquid.renderer.renderTemplates(templates, ctx, emitter)
       ctx.pop()
+      stack.pop()
     }
     return renderChild
       ? (superBlock: BlockDrop, emitter: Emitter) => renderChild(
diff --git a/src/tags/cycle.ts b/src/tags/cycle.ts
index 3f5ce9674..063c01b01 100644
--- a/src/tags/cycle.ts
+++ b/src/tags/cycle.ts
@@ -27,7 +27,7 @@ export default class extends Tag {
   * render (ctx: Context, emitter: Emitter): Generator<unknown, unknown, unknown> {
     const group = (yield evalToken(this.group, ctx)) as ValueToken
     const fingerprint = `cycle:${group}:` + this.candidates.join(',')
-    const groups = ctx.getRegister('cycle')
+    const groups = ctx.getRegister('cycle', {} as Record<string, number>)
     let idx = groups[fingerprint]
 
     if (idx === undefined) {
diff --git a/src/tags/for.ts b/src/tags/for.ts
index 779eee207..0d29dee78 100644
--- a/src/tags/for.ts
+++ b/src/tags/for.ts
@@ -50,7 +50,7 @@ export default class extends Tag {
     }
 
     const continueKey = 'continue-' + this.variable + '-' + this.collection.getText()
-    ctx.push({ continue: ctx.getRegister(continueKey) })
+    ctx.push({ continue: ctx.getRegister(continueKey, {}) })
     const hash = yield this.hash.render(ctx)
     ctx.pop()
 
diff --git a/src/tags/layout.ts b/src/tags/layout.ts
index f1da55f78..cf1e7270f 100644
--- a/src/tags/layout.ts
+++ b/src/tags/layout.ts
@@ -32,7 +32,7 @@ export default class extends Tag {
     // render remaining contents and store rendered results
     ctx.setRegister('blockMode', BlockMode.STORE)
     const html = yield renderer.renderTemplates(this.templates, ctx)
-    const blocks = ctx.getRegister('blocks')
+    const blocks = ctx.getRegister('blocks', {} as Record<string, any>)
 
     // set whole content to anonymous block if anonymous doesn't specified
     if (blocks[''] === undefined) blocks[''] = (parent: BlankDrop, emitter: Emitter) => emitter.write(html)
diff --git a/test/e2e/parse-and-render.spec.ts b/test/e2e/parse-and-render.spec.ts
index cfca9c2b2..81803d15c 100644
--- a/test/e2e/parse-and-render.spec.ts
+++ b/test/e2e/parse-and-render.spec.ts
@@ -82,4 +82,39 @@ describe('.parseAndRender()', function () {
       expect(() => e.parseAndRenderSync('{% render "link" %}')).toThrow(/ENOENT|Failed to lookup/)
     })
   })
+  describe('layout: nested {% block %} regression', function () {
+    let root: string
+    beforeEach(function () {
+      root = mkdtempSync(join(tmpdir(), 'liquid-e2e-layout-nested-'))
+    })
+    afterEach(function () {
+      rmSync(root, { recursive: true, force: true })
+    })
+    it('should reject same-name {% block %} nested in child template (no hang / OOM)', async function () {
+      writeFileSync(
+        join(root, 'layout.html'),
+        '<header>{% block a %}default-a{% endblock %}</header>' +
+        '<main>{% block b %}default-b{% endblock %}</main>' +
+        '<footer>{% block c %}default-c{% endblock %}</footer>'
+      )
+      writeFileSync(
+        join(root, 'template.html'),
+        '{% layout "layout" %}' +
+        '{% block a %}outer-a {% block a %}inner-a{% endblock %}{% endblock %}' +
+        '{% block b %}content-b{% endblock %}' +
+        '{% block c %}content-c{% endblock %}'
+      )
+      const liquid = new Liquid({ root, extname: '.html' })
+      await expect(liquid.renderFile('template')).rejects.toThrow(/block tag cannot be nested/)
+    })
+    it('should reject nested anonymous {% block %} in child template (no hang / OOM)', async function () {
+      writeFileSync(join(root, 'parent.html'), 'X{%block%}{%endblock%}Y')
+      writeFileSync(
+        join(root, 'template.html'),
+        '{% layout "parent" %}{%block%}A{%block%}B{%endblock%}{%endblock%}'
+      )
+      const liquid = new Liquid({ root, extname: '.html' })
+      await expect(liquid.renderFile('template')).rejects.toThrow(/block tag cannot be nested/)
+    })
+  })
 })
diff --git a/test/integration/tags/include.spec.ts b/test/integration/tags/include.spec.ts
index d72bab861..9698cab5e 100644
--- a/test/integration/tags/include.spec.ts
+++ b/test/integration/tags/include.spec.ts
@@ -50,7 +50,7 @@ describe('tags/include', function () {
     })
     return liquid.renderFile('/parent.html').catch(function (e) {
       expect(e.name).toBe('TokenizationError')
-      expect(e.message).toMatch('illegal file path, file:/parent.html, line:1, col:11')
+      expect(e.message).toMatch(/illegal file path, file:.*parent.html, line:1, col:11/)
     })
   })
 
diff --git a/test/integration/tags/layout.spec.ts b/test/integration/tags/layout.spec.ts
index 5f0e4beb8..b7a5d3ce8 100644
--- a/test/integration/tags/layout.spec.ts
+++ b/test/integration/tags/layout.spec.ts
@@ -166,6 +166,27 @@ describe('tags/layout', function () {
     const html = await liquid.renderFile('/main.html')
     return expect(html).toBe('XAY')
   })
+  it('should reject nested {% block %} with the same name (no OOM / hang)', function () {
+    mock({
+      '/layout.html':
+        '<header>{% block a %}default-a{% endblock %}</header>' +
+        '<main>{% block b %}default-b{% endblock %}</main>' +
+        '<footer>{% block c %}default-c{% endblock %}</footer>',
+      '/template.html':
+        '{% layout "layout" %}' +
+        '{% block a %}outer-a {% block a %}inner-a{% endblock %}{% endblock %}' +
+        '{% block b %}content-b{% endblock %}' +
+        '{% block c %}content-c{% endblock %}'
+    })
+    return expect(liquid.renderFile('/template.html')).rejects.toThrow(/block tag cannot be nested/)
+  })
+  it('should reject nested anonymous {% block %} (no OOM / hang)', function () {
+    mock({
+      '/parent.html': 'X{%block%}{%endblock%}Y'
+    })
+    const src = '{% layout "parent.html" %}{%block%}A{%block%}B{%endblock%}{%endblock%}'
+    return expect(liquid.parseAndRender(src)).rejects.toThrow(/block tag cannot be nested/)
+  })
   it('should not bleed scope into `include` layout', async function () {
     mock({
       '/parent.html': 'X{%block a%}{%endblock%}Y{%block b%}{%endblock%}Z',

From 30e04ba16d73697ea897a463729bca02095ce44c Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Sun, 19 Apr 2026 15:42:53 +0000
Subject: [PATCH 32/64] chore(release): 10.25.6 [skip ci]

## [10.25.6](https://github.com/harttle/liquidjs/compare/v10.25.5...v10.25.6) (2026-04-19)

### Bug Fixes

* nested block for layout ([#883](https://github.com/harttle/liquidjs/issues/883)) ([e2311df](https://github.com/harttle/liquidjs/commit/e2311dfd6e82f73509308aa8a3a1fafc92e226f0))
---
 CHANGELOG.md      | 7 +++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d3e96a6a..c80d0670c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [10.25.6](https://github.com/harttle/liquidjs/compare/v10.25.5...v10.25.6) (2026-04-19)
+
+
+### Bug Fixes
+
+* nested block for layout ([#883](https://github.com/harttle/liquidjs/issues/883)) ([e2311df](https://github.com/harttle/liquidjs/commit/e2311dfd6e82f73509308aa8a3a1fafc92e226f0))
+
 ## [10.25.5](https://github.com/harttle/liquidjs/compare/v10.25.4...v10.25.5) (2026-04-07)
 
 
diff --git a/package-lock.json b/package-lock.json
index c4a1bc368..d445eee74 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.5",
+  "version": "10.25.6",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.5",
+      "version": "10.25.6",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 14100eec9..789e4d96f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.5",
+  "version": "10.25.6",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 0ee6dbb511aa926f6d490293282060abf3bab37f Mon Sep 17 00:00:00 2001
From: Tal <talboren2@gmail.com>
Date: Thu, 23 Apr 2026 16:30:58 +0300
Subject: [PATCH 33/64] fix(filters): support Buffer input in base64_encode to
 prevent binary data corruption (#881)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix: support Buffer input in base64_encode filter

When binary data (e.g. images, PDFs) is passed through the template
context as a Node.js Buffer, the base64_encode filter would call
stringify() on it first, which internally does String(value). This
triggers Buffer.toString() with the default 'utf-8' encoding, which
is a lossy conversion for non-UTF-8 byte sequences — invalid bytes
get replaced with U+FFFD, permanently destroying the original data.

The fix checks for Buffer.isBuffer() before stringify, and calls
buffer.toString('base64') directly, bypassing the lossy UTF-8
intermediate step. String inputs continue through the existing path
unchanged.

Made-with: Cursor

* fix: handle Buffer in filter layer to fix browser build

Move Buffer handling from base64-impl.ts (which gets swapped for the
browser impl at build time) into base64.ts (the filter layer). This
avoids a type error during the browser rollup build where the browser
impl only accepts string.

Also guard Buffer.isBuffer() with typeof Buffer !== 'undefined' for
safety in browser environments.

Made-with: Cursor
---
 src/filters/base64.ts                   |  6 ++++-
 test/integration/filters/base64.spec.ts | 29 ++++++++++++++++++++++++-
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/src/filters/base64.ts b/src/filters/base64.ts
index c0e1a7993..29ef84e52 100644
--- a/src/filters/base64.ts
+++ b/src/filters/base64.ts
@@ -8,7 +8,11 @@ import { FilterImpl } from '../template'
 import { stringify } from '../util'
 import { base64Encode, base64Decode } from './base64-impl'
 
-export function base64_encode (this: FilterImpl, value: string): string {
+export function base64_encode (this: FilterImpl, value: string | Buffer): string {
+  if (typeof Buffer !== 'undefined' && Buffer.isBuffer(value)) {
+    this.context.memoryLimit.use(value.byteLength)
+    return value.toString('base64')
+  }
   const str = stringify(value)
   this.context.memoryLimit.use(str.length)
   return base64Encode(str)
diff --git a/test/integration/filters/base64.spec.ts b/test/integration/filters/base64.spec.ts
index cf54fc4f6..67eab977f 100644
--- a/test/integration/filters/base64.spec.ts
+++ b/test/integration/filters/base64.spec.ts
@@ -1,4 +1,4 @@
-import { test } from '../../stub/render'
+import { test, liquid } from '../../stub/render'
 
 describe('filters/base64', function () {
   describe('base64_encode', function () {
@@ -65,6 +65,33 @@ describe('filters/base64', function () {
     })
   })
 
+  describe('base64_encode with Buffer input', function () {
+    it('should encode a Buffer to base64 without data corruption', async () => {
+      const buf = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0xff, 0xfe])
+      const result = await liquid.parseAndRender('{{ data | base64_encode }}', { data: buf })
+      expect(result).toBe(buf.toString('base64'))
+    })
+
+    it('should preserve bytes that are invalid UTF-8', async () => {
+      const buf = Buffer.from([0x80, 0xff, 0xfe, 0x00, 0x01])
+      const result = await liquid.parseAndRender('{{ data | base64_encode }}', { data: buf })
+      const decoded = Buffer.from(result, 'base64')
+      expect(decoded).toEqual(buf)
+    })
+
+    it('should handle an empty Buffer', async () => {
+      const buf = Buffer.alloc(0)
+      const result = await liquid.parseAndRender('{{ data | base64_encode }}', { data: buf })
+      expect(result).toBe('')
+    })
+
+    it('should handle a Buffer containing valid UTF-8 text', async () => {
+      const buf = Buffer.from('Hello World', 'utf8')
+      const result = await liquid.parseAndRender('{{ data | base64_encode }}', { data: buf })
+      expect(result).toBe(Buffer.from('Hello World').toString('base64'))
+    })
+  })
+
   describe('base64 round-trip', function () {
     it('should encode and decode back to original', () => {
       return test('{{ "Hello, World!" | base64_encode | base64_decode }}', 'Hello, World!')

From f1f896c29d7b7ceed9b1873c9f655b8160c5559b Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Thu, 23 Apr 2026 21:31:50 +0800
Subject: [PATCH 34/64] docs: add talboren as a contributor for code (#885)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index b29f4c2bd..c3b95f92c 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -820,6 +820,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "talboren",
+      "name": "Tal",
+      "avatar_url": "https://avatars.githubusercontent.com/u/68807791?v=4",
+      "profile": "https://github.com/talboren",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index bd928e96b..f0d34733d 100644
--- a/README.md
+++ b/README.md
@@ -221,6 +221,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
       <td align="center" valign="top" width="14.28%"><a href="https://doruk.ch"><img src="https://avatars.githubusercontent.com/u/77903714?v=4?s=100" width="100px;" alt="Peak Twilight"/><br /><sub><b>Peak Twilight</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=peaktwilight" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/joecottam"><img src="https://avatars.githubusercontent.com/u/44173086?v=4?s=100" width="100px;" alt="Joe Cottam"/><br /><sub><b>Joe Cottam</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=joecottam" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/timbze"><img src="https://avatars.githubusercontent.com/u/35117769?v=4?s=100" width="100px;" alt="Timmy Braun"/><br /><sub><b>Timmy Braun</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=timbze" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/talboren"><img src="https://avatars.githubusercontent.com/u/68807791?v=4?s=100" width="100px;" alt="Tal"/><br /><sub><b>Tal</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=talboren" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From 75c815a4d70583fcf43acc1ee009e28297efc4de Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Thu, 23 Apr 2026 21:39:50 +0800
Subject: [PATCH 35/64] docs: add @talboren as financial contributor (#886)

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index f0d34733d..59c745535 100644
--- a/README.md
+++ b/README.md
@@ -82,6 +82,7 @@ If you personally love LiquidJS or it's benefiting your business, please conside
   <a href="https://syntax.fm/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/130389858?v=4&s=100" height="80" style="vertical-align: middle;" alt="Syntax Podcast" title="Syntax Podcast"/></a>
   <br/>
   <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=liquidjs" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/27130435?s=200&v=4" width="80" style="vertical-align: middle;" alt="TestMu AI" title="TestMu AI"/></a>
+  <a href="https://github.com/talboren" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/68807791?v=4&s=100" height="80" style="vertical-align: middle;" alt="Tal" title="Tal (@talboren)"/></a>
   <a href="https://chudovo.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/Chudovo/avatar/256.png?height=100" width="160" style="vertical-align: middle;background: white;padding: 8px 16px;" alt="Chudovo" title="Chudovo"/></a>
   <a href="https://dailycontributors.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/dailycontributors/3c2e057/logo/256.png?height=50&width=100" width="120" style="vertical-align: middle;" alt="Dailycontributors" title="Dailycontributors"/></a>
   <a href="https://www.pakstyle.pk/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/pakstyle/2b81605/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="PakStyle.pk" title="PakStyle.pk"/></a>

From 34877950bfd0f88666f4ef61f7704defdea546b0 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 23 Apr 2026 13:41:11 +0000
Subject: [PATCH 36/64] chore(release): 10.25.7 [skip ci]

## [10.25.7](https://github.com/harttle/liquidjs/compare/v10.25.6...v10.25.7) (2026-04-23)

### Bug Fixes

* **filters:** support Buffer input in base64_encode to prevent binary data corruption ([#881](https://github.com/harttle/liquidjs/issues/881)) ([0ee6dbb](https://github.com/harttle/liquidjs/commit/0ee6dbb511aa926f6d490293282060abf3bab37f))
---
 CHANGELOG.md      | 7 +++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c80d0670c..847bba40f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+## [10.25.7](https://github.com/harttle/liquidjs/compare/v10.25.6...v10.25.7) (2026-04-23)
+
+
+### Bug Fixes
+
+* **filters:** support Buffer input in base64_encode to prevent binary data corruption ([#881](https://github.com/harttle/liquidjs/issues/881)) ([0ee6dbb](https://github.com/harttle/liquidjs/commit/0ee6dbb511aa926f6d490293282060abf3bab37f))
+
 ## [10.25.6](https://github.com/harttle/liquidjs/compare/v10.25.5...v10.25.6) (2026-04-19)
 
 
diff --git a/package-lock.json b/package-lock.json
index d445eee74..a82f3a764 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.6",
+  "version": "10.25.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.6",
+      "version": "10.25.7",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 789e4d96f..bb60bc9d0 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.6",
+  "version": "10.25.7",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 1c816d4fc3bcd2cba011f7a84f56a4251fca0622 Mon Sep 17 00:00:00 2001
From: Vladimir Filonov <vladimir@filonov.dev>
Date: Sun, 3 May 2026 08:03:26 +0400
Subject: [PATCH 37/64] feat: add sha256 and hmac_sha256 filters for
 cryptographic operations (#889)

---
 docs/source/filters/hmac_sha256.md      | 20 +++++++
 docs/source/filters/overview.md         |  1 +
 docs/source/filters/sha256.md           | 20 +++++++
 rollup.config.mjs                       | 12 ++++-
 src/build/crypto-impl-browser.spec.ts   | 45 ++++++++++++++++
 src/build/crypto-impl-browser.ts        | 27 ++++++++++
 src/filters/crypto-impl.ts              |  9 ++++
 src/filters/crypto.ts                   | 22 ++++++++
 src/filters/index.ts                    |  2 +
 test/integration/filters/crypto.spec.ts | 70 +++++++++++++++++++++++++
 10 files changed, 226 insertions(+), 2 deletions(-)
 create mode 100644 docs/source/filters/hmac_sha256.md
 create mode 100644 docs/source/filters/sha256.md
 create mode 100644 src/build/crypto-impl-browser.spec.ts
 create mode 100644 src/build/crypto-impl-browser.ts
 create mode 100644 src/filters/crypto-impl.ts
 create mode 100644 src/filters/crypto.ts
 create mode 100644 test/integration/filters/crypto.spec.ts

diff --git a/docs/source/filters/hmac_sha256.md b/docs/source/filters/hmac_sha256.md
new file mode 100644
index 000000000..24e00140e
--- /dev/null
+++ b/docs/source/filters/hmac_sha256.md
@@ -0,0 +1,20 @@
+---
+title: hmac_sha256
+---
+
+{% since %}vNEXT{% endsince %}
+
+Converts a string into an SHA-256 hash using a hash message authentication code (HMAC). The secret key is passed as the filter argument. The output is a lowercase hexadecimal string.
+
+Input
+
+```liquid
+{%- assign secret_potion = 'Polyjuice' | hmac_sha256: 'Polina' -%}
+My secret potion: {{ secret_potion }}
+```
+
+Output
+
+```text
+My secret potion: 8e0d5d65cff1242a4af66c8f4a32854fd5fb80edcc8aabe9b302b29c7c71dc20
+```
diff --git a/docs/source/filters/overview.md b/docs/source/filters/overview.md
index eee2cb0e2..342fab0c5 100644
--- a/docs/source/filters/overview.md
+++ b/docs/source/filters/overview.md
@@ -16,5 +16,6 @@ Array | slice, map, sort, sort_natural, uniq, where, where_exp, group_by, group_
 Date | date, date_to_xmlschema, date_to_rfc822, date_to_string, date_to_long_string
 Misc | default, json, jsonify, inspect, raw, to_integer
 Base64 | base64_encode, base64_decode
+Crypto | sha256, hmac_sha256
 
 [shopify/liquid]: https://github.com/Shopify/liquid
diff --git a/docs/source/filters/sha256.md b/docs/source/filters/sha256.md
new file mode 100644
index 000000000..659b86355
--- /dev/null
+++ b/docs/source/filters/sha256.md
@@ -0,0 +1,20 @@
+---
+title: sha256
+---
+
+{% since %}vNEXT{% endsince %}
+
+Converts a string into an SHA-256 hash. The output is a lowercase hexadecimal string.
+
+Input
+
+```liquid
+{%- assign secret_potion = 'Polyjuice' | sha256 -%}
+My secret potion: {{ secret_potion }}
+```
+
+Output
+
+```text
+My secret potion: 44ac1d7a2936e30a5de07082fd65d6fe9b1fb658a1a98bfe65bc5959beac5dd0
+```
diff --git a/rollup.config.mjs b/rollup.config.mjs
index 5b353886b..328505fdc 100644
--- a/rollup.config.mjs
+++ b/rollup.config.mjs
@@ -50,6 +50,11 @@ const browserBase64 = {
   delimiters: ['', ''],
   './base64-impl': '../build/base64-impl-browser'
 }
+const browserCrypto = {
+  include: './src/filters/crypto.ts',
+  delimiters: ['', ''],
+  './crypto-impl': '../build/crypto-impl-browser'
+}
 const browserStream = {
   include: './src/emitters/index.ts',
   delimiters: ['', ''],
@@ -67,7 +72,7 @@ const nodeCjs = {
     format: 'cjs',
     banner
   }],
-  external: ['path', 'fs', 'stream'],
+  external: ['path', 'fs', 'stream', 'crypto'],
   plugins: [versionInjection, typescript(tsconfig('ES2020'))],
   treeshake,
   input
@@ -79,7 +84,7 @@ const nodeEsm = {
     format: 'esm',
     banner
   }],
-  external: ['path', 'fs', 'stream'],
+  external: ['path', 'fs', 'stream', 'crypto'],
   plugins: [
     versionInjection,
     replace(esmRequire),
@@ -100,6 +105,7 @@ const browserEsm = {
     versionInjection,
     replace(browserFS),
     replace(browserBase64),
+    replace(browserCrypto),
     replace(browserStream),
     typescript(tsconfig('es6'))
   ],
@@ -119,6 +125,7 @@ const browserUmd = {
     versionInjection,
     replace(browserFS),
     replace(browserBase64),
+    replace(browserCrypto),
     replace(browserStream),
     typescript(tsconfig('es5'))
   ],
@@ -138,6 +145,7 @@ const browserMin = {
     versionInjection,
     replace(browserFS),
     replace(browserBase64),
+    replace(browserCrypto),
     replace(browserStream),
     typescript(tsconfig('es5')),
     uglify()
diff --git a/src/build/crypto-impl-browser.spec.ts b/src/build/crypto-impl-browser.spec.ts
new file mode 100644
index 000000000..820838438
--- /dev/null
+++ b/src/build/crypto-impl-browser.spec.ts
@@ -0,0 +1,45 @@
+import { webcrypto } from 'crypto'
+import * as cryptoImpl from './crypto-impl-browser'
+
+describe('crypto-impl/browser', function () {
+  beforeEach(function () {
+    Object.defineProperty(global, 'crypto', {
+      value: webcrypto,
+      writable: true,
+      configurable: true
+    })
+  })
+
+  afterEach(function () {
+    delete (global as any).crypto
+  })
+
+  describe('#sha256()', function () {
+    it('should hash the Shopify reference example', async function () {
+      expect(await cryptoImpl.sha256('Polyjuice'))
+        .toBe('44ac1d7a2936e30a5de07082fd65d6fe9b1fb658a1a98bfe65bc5959beac5dd0')
+    })
+
+    it('should hash an empty string', async function () {
+      expect(await cryptoImpl.sha256(''))
+        .toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855')
+    })
+
+    it('should hash unicode characters', async function () {
+      expect(await cryptoImpl.sha256('你好世界'))
+        .toBe('beca6335b20ff57ccc47403ef4d9e0b8fccb4442b3151c2e7d50050673d43172')
+    })
+  })
+
+  describe('#hmacSha256()', function () {
+    it('should hash the Shopify reference example', async function () {
+      expect(await cryptoImpl.hmacSha256('Polyjuice', 'Polina'))
+        .toBe('8e0d5d65cff1242a4af66c8f4a32854fd5fb80edcc8aabe9b302b29c7c71dc20')
+    })
+
+    it('should hash an empty message with a key', async function () {
+      expect(await cryptoImpl.hmacSha256('', 'key'))
+        .toBe('5d5d139563c95b5967b9bd9a8c9b233a9dedb45072794cd232dc1b74832607d0')
+    })
+  })
+})
diff --git a/src/build/crypto-impl-browser.ts b/src/build/crypto-impl-browser.ts
new file mode 100644
index 000000000..20eb5c649
--- /dev/null
+++ b/src/build/crypto-impl-browser.ts
@@ -0,0 +1,27 @@
+function bufferToHex (buffer: ArrayBuffer): string {
+  const bytes = new Uint8Array(buffer)
+  let hex = ''
+  for (let i = 0; i < bytes.length; i++) {
+    hex += bytes[i].toString(16).padStart(2, '0')
+  }
+  return hex
+}
+
+export async function sha256 (str: string): Promise<string> {
+  const data = new TextEncoder().encode(str)
+  const digest = await crypto.subtle.digest('SHA-256', data)
+  return bufferToHex(digest)
+}
+
+export async function hmacSha256 (str: string, key: string): Promise<string> {
+  const encoder = new TextEncoder()
+  const cryptoKey = await crypto.subtle.importKey(
+    'raw',
+    encoder.encode(key),
+    { name: 'HMAC', hash: 'SHA-256' },
+    false,
+    ['sign']
+  )
+  const signature = await crypto.subtle.sign('HMAC', cryptoKey, encoder.encode(str))
+  return bufferToHex(signature)
+}
diff --git a/src/filters/crypto-impl.ts b/src/filters/crypto-impl.ts
new file mode 100644
index 000000000..c2ed06f3b
--- /dev/null
+++ b/src/filters/crypto-impl.ts
@@ -0,0 +1,9 @@
+import { createHash, createHmac } from 'crypto'
+
+export function sha256 (str: string): string {
+  return createHash('sha256').update(str, 'utf8').digest('hex')
+}
+
+export function hmacSha256 (str: string, key: string): string {
+  return createHmac('sha256', key).update(str, 'utf8').digest('hex')
+}
diff --git a/src/filters/crypto.ts b/src/filters/crypto.ts
new file mode 100644
index 000000000..7210523bd
--- /dev/null
+++ b/src/filters/crypto.ts
@@ -0,0 +1,22 @@
+/**
+ * Crypto related filters
+ *
+ * Implements sha256 and hmac_sha256 filters for Shopify compatibility
+ */
+
+import { FilterImpl } from '../template'
+import { stringify } from '../util'
+import { sha256 as sha256Impl, hmacSha256 as hmacSha256Impl } from './crypto-impl'
+
+export function sha256 (this: FilterImpl, value: unknown): string | Promise<string> {
+  const str = stringify(value)
+  this.context.memoryLimit.use(str.length)
+  return sha256Impl(str)
+}
+
+export function hmac_sha256 (this: FilterImpl, value: unknown, key: unknown): string | Promise<string> {
+  const str = stringify(value)
+  const keyStr = stringify(key)
+  this.context.memoryLimit.use(str.length + keyStr.length)
+  return hmacSha256Impl(str, keyStr)
+}
diff --git a/src/filters/index.ts b/src/filters/index.ts
index ef245a1c2..d3b304b5f 100644
--- a/src/filters/index.ts
+++ b/src/filters/index.ts
@@ -5,6 +5,7 @@ import * as arrayFilters from './array'
 import * as dateFilters from './date'
 import * as stringFilters from './string'
 import * as base64Filters from './base64'
+import * as cryptoFilters from './crypto'
 import misc from './misc'
 import { FilterImplOptions } from '../template'
 
@@ -16,5 +17,6 @@ export const filters: Record<string, FilterImplOptions> = {
   ...dateFilters,
   ...stringFilters,
   ...base64Filters,
+  ...cryptoFilters,
   ...misc
 }
diff --git a/test/integration/filters/crypto.spec.ts b/test/integration/filters/crypto.spec.ts
new file mode 100644
index 000000000..be35aea54
--- /dev/null
+++ b/test/integration/filters/crypto.spec.ts
@@ -0,0 +1,70 @@
+import { test } from '../../stub/render'
+
+const SHA256_EMPTY = 'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'
+
+describe('filters/crypto', function () {
+  describe('sha256', function () {
+    it('should hash the Shopify reference example', () => {
+      return test(
+        '{{ "Polyjuice" | sha256 }}',
+        '44ac1d7a2936e30a5de07082fd65d6fe9b1fb658a1a98bfe65bc5959beac5dd0'
+      )
+    })
+
+    it('should hash an empty string', () => {
+      return test('{{ "" | sha256 }}', SHA256_EMPTY)
+    })
+
+    it('should treat undefined as empty string', () => {
+      return test('{{ foo | sha256 }}', SHA256_EMPTY)
+    })
+
+    it('should treat null as empty string', () => {
+      return test('{{ null | sha256 }}', SHA256_EMPTY)
+    })
+
+    it('should stringify numeric input', () => {
+      return test(
+        '{{ 123 | sha256 }}',
+        'a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3'
+      )
+    })
+
+    it('should stringify boolean input', () => {
+      return test(
+        '{{ true | sha256 }}',
+        'b5bea41b6c623f7c09f1bf24dcae58ebab3c0cdd90ad966bc43a45b44867e12b'
+      )
+    })
+  })
+
+  describe('hmac_sha256', function () {
+    it('should hash the Shopify reference example', () => {
+      return test(
+        "{{ 'Polyjuice' | hmac_sha256: 'Polina' }}",
+        '8e0d5d65cff1242a4af66c8f4a32854fd5fb80edcc8aabe9b302b29c7c71dc20'
+      )
+    })
+
+    it('should accept a numeric key (stringified)', () => {
+      return test(
+        "{{ 'hello' | hmac_sha256: 42 }}",
+        '3bdadea6ed0e95ededc15dc4421ce7654c970156843dfd997be3fef5358168ca'
+      )
+    })
+
+    it('should hash an empty message with an empty key', () => {
+      return test(
+        "{{ '' | hmac_sha256: '' }}",
+        'b613679a0814d9ec772f95d778c35fc5ff1697c493715653c6c712144292c5ad'
+      )
+    })
+
+    it('should treat undefined input as empty string', () => {
+      return test(
+        "{{ foo | hmac_sha256: '' }}",
+        'b613679a0814d9ec772f95d778c35fc5ff1697c493715653c6c712144292c5ad'
+      )
+    })
+  })
+})

From d1d517d1eca66fff546beb98131e8254d6eccad1 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 3 May 2026 12:03:52 +0800
Subject: [PATCH 38/64] docs: add VladimirFilonov as a contributor for code
 (#891)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 1 +
 2 files changed, 10 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index c3b95f92c..90bcb6ab2 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -829,6 +829,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "VladimirFilonov",
+      "name": "Vladimir Filonov",
+      "avatar_url": "https://avatars.githubusercontent.com/u/813224?v=4",
+      "profile": "https://filonov.dev",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index 59c745535..1c630bcfd 100644
--- a/README.md
+++ b/README.md
@@ -223,6 +223,7 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/joecottam"><img src="https://avatars.githubusercontent.com/u/44173086?v=4?s=100" width="100px;" alt="Joe Cottam"/><br /><sub><b>Joe Cottam</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=joecottam" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/timbze"><img src="https://avatars.githubusercontent.com/u/35117769?v=4?s=100" width="100px;" alt="Timmy Braun"/><br /><sub><b>Timmy Braun</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=timbze" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/talboren"><img src="https://avatars.githubusercontent.com/u/68807791?v=4?s=100" width="100px;" alt="Tal"/><br /><sub><b>Tal</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=talboren" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://filonov.dev"><img src="https://avatars.githubusercontent.com/u/813224?v=4?s=100" width="100px;" alt="Vladimir Filonov"/><br /><sub><b>Vladimir Filonov</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=VladimirFilonov" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

From a55f543f49aea8f769e680b0d115aa903952efd0 Mon Sep 17 00:00:00 2001
From: MattAltermatt <altermatt@gmail.com>
Date: Sat, 2 May 2026 21:05:12 -0700
Subject: [PATCH 39/64] docs(readme): add Freshet to Who's Using LiquidJS
 (#888)

Co-authored-by: MattAltermatt <1435066+MattAltermatt@users.noreply.github.com>
---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 1c630bcfd..eb4d616b6 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,7 @@ For more details, refer to the [Setup Guide][setup].
 - [Microsoft Power Pages](https://learn.microsoft.com/en-us/power-pages/introduction): a secure, enterprise-grade, low-code software as a service (SaaS) platform for creating, hosting, and administering modern external-facing business websites.
 - [Azure API Management developer portal](https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal): an automatically generated, fully customizable website with the documentation of your APIs.
 - [WISMOlabs](https://wismolabs.com/): Post Purchase Experience platform for eCommerce retailers enhancing customer satisfaction by using LiquidJS to provide customizable post-purchase experiences through programmable email, SMS, order tracking pages, and webhooks.
+- [Freshet](https://chromewebstore.google.com/detail/freshet/mpclplhdencffbilobpcapccnihpelcg): *JSON in, page out* — a Chrome extension that uses LiquidJS templates per URL pattern, so the JSON becomes a rendered, useful page.
 
 Feel free to create a PR or contact me to add your use case into this list!
 

From 26ea2856c7a90aec892b98d94a9b7a3e18539045 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 3 May 2026 21:36:09 +0800
Subject: [PATCH 40/64] fix: strip html newline tags (#892)

* docs: add @talboren as financial contributor

* fix(strip_html): match tags that span newlines inside angle brackets

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/filters/html.ts                   | 2 +-
 test/integration/filters/html.spec.ts | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/filters/html.ts b/src/filters/html.ts
index 3121857e3..0dd5f77d3 100644
--- a/src/filters/html.ts
+++ b/src/filters/html.ts
@@ -45,5 +45,5 @@ export function newline_to_br (this: FilterImpl, v: string) {
 export function strip_html (this: FilterImpl, v: string) {
   const str = stringify(v)
   this.context.memoryLimit.use(str.length)
-  return str.replace(/<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<.*?>|<!--[\s\S]*?-->/g, '')
+  return str.replace(/<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<[\s\S]*?>|<!--[\s\S]*?-->/g, '')
 }
diff --git a/test/integration/filters/html.spec.ts b/test/integration/filters/html.spec.ts
index fce809d3a..c4551dad4 100644
--- a/test/integration/filters/html.spec.ts
+++ b/test/integration/filters/html.spec.ts
@@ -77,5 +77,10 @@ describe('filters/html', function () {
     it('should strip until empty', function () {
       return test('{{"<br/><br />< p ></p></ p >" | strip_html }}', '')
     })
+    it('should strip generic tags spanning ASCII newlines inside the tag', function () {
+      expect(liquid.parseAndRenderSync('{{"<img\nsrc=x\nonerror=alert(1)>" | strip_html}}')).toBe('')
+      expect(liquid.parseAndRenderSync('{{"<img\rsrc=x\ronerror=alert(1)>" | strip_html}}')).toBe('')
+      expect(liquid.parseAndRenderSync('{{"<svg\nonload=alert(1)>" | strip_html}}')).toBe('')
+    })
   })
 })

From dbbf6288030591bf6da28d8c1cce5a17bca97bb6 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 3 May 2026 22:35:31 +0800
Subject: [PATCH 41/64] fix: propagate ownPropertyOnly into Context.spawn() for
 {% render %} (#893)

Child contexts from spawn() re-derived ownPropertyOnly from Liquid opts
only, dropping per-render RenderOptions overrides. That broke the contract
that parseAndRender(..., { ownPropertyOnly: true }) locks down a single
render, including partials loaded via {% render %}.

Add regression test matching prototype-chain leak PoC.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/context/context.ts               |  3 ++-
 test/integration/tags/render.spec.ts | 21 +++++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/src/context/context.ts b/src/context/context.ts
index 5a0fe576a..205a57622 100644
--- a/src/context/context.ts
+++ b/src/context/context.ts
@@ -106,7 +106,8 @@ export class Context {
     return new Context(scope, this.opts, {
       sync: this.sync,
       globals: this.globals,
-      strictVariables: this.strictVariables
+      strictVariables: this.strictVariables,
+      ownPropertyOnly: this.ownPropertyOnly
     }, {
       renderLimit: this.renderLimit,
       memoryLimit: this.memoryLimit
diff --git a/test/integration/tags/render.spec.ts b/test/integration/tags/render.spec.ts
index 1ce90c4ab..2530cec6a 100644
--- a/test/integration/tags/render.spec.ts
+++ b/test/integration/tags/render.spec.ts
@@ -271,6 +271,27 @@ describe('tags/render', function () {
     return expect(staticLiquid.renderFile('parent.html')).rejects.toThrow(/Failed to lookup "..\/bar\/child.html"/)
   })
 
+  describe('per-render ownPropertyOnly', function () {
+    it('should propagate to {% render %} partial (spawned context)', async function () {
+      mock({
+        '/_user.liquid': '{{ user.passwordHash }}'
+      })
+      const engine = new Liquid({ ownPropertyOnly: false, root: '/' })
+      class User {
+        name: string
+        constructor (n: string) {
+          this.name = n
+        }
+      }
+      Object.assign(User.prototype, { passwordHash: 'secret-from-prototype' })
+      const u = new User('alice')
+      const tpl = 'Direct:[{{ user.passwordHash }}] Render:[{% render "_user.liquid", user: user %}]'
+      const html = await engine.parseAndRender(tpl, { user: u }, { ownPropertyOnly: true })
+      expect(html).toBe('Direct:[] Render:[]')
+      expect(engine.parseAndRenderSync(tpl, { user: u }, { ownPropertyOnly: true })).toBe('Direct:[] Render:[]')
+    })
+  })
+
   describe('static partial', function () {
     let staticLiquid: Liquid
     beforeEach(() => {

From 5b9c3469085e01c79e2d0af28e2a13f730e1793d Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Thu, 7 May 2026 23:03:43 +0800
Subject: [PATCH 42/64] fix: enforce renderLimit for empty renderTemplates
 calls (#894)

renderLimit was only checked inside the per-template loop, so
renderTemplates([], ...) skipped it. Empty {% for %} and {% tablerow %}
bodies call that path once per iteration (tablerow still does emitter
work for <tr>/<td>), bypassing the documented time budget. Check the
limiter at renderTemplates entry before the loop.

Add regression tests for empty for-body and empty tablerow-body.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/render/render.ts                |  1 +
 test/integration/liquid/dos.spec.ts | 10 ++++++++++
 2 files changed, 11 insertions(+)

diff --git a/src/render/render.ts b/src/render/render.ts
index 6cfc9a99a..8d0b7d806 100644
--- a/src/render/render.ts
+++ b/src/render/render.ts
@@ -15,6 +15,7 @@ export class Render {
     if (!emitter) {
       emitter = ctx.opts.keepOutputType ? new KeepingTypeEmitter() : new SimpleEmitter()
     }
+    ctx.renderLimit.check(getPerformance().now())
     const errors = []
     for (const tpl of templates) {
       ctx.renderLimit.check(getPerformance().now())
diff --git a/test/integration/liquid/dos.spec.ts b/test/integration/liquid/dos.spec.ts
index 875d299a1..796f2db8e 100644
--- a/test/integration/liquid/dos.spec.ts
+++ b/test/integration/liquid/dos.spec.ts
@@ -48,6 +48,16 @@ describe('DoS related', function () {
       await expect(liquid.parseAndRender('{% render "large" %}')).rejects.toThrow('template render limit exceeded')
       await expect(liquid.parseAndRender('{% render "small" %}')).resolves.toBe('12345')
     })
+    it('should enforce renderLimit when for body has no template nodes', () => {
+      const liquid = new Liquid({ memoryLimit: 1e9, renderLimit: 1 })
+      expect(() => liquid.parseAndRenderSync('{%- for i in (1..5000000) -%}{%- endfor -%}', {}))
+        .toThrow('template render limit exceeded')
+    })
+    it('should enforce renderLimit when tablerow body has no template nodes', () => {
+      const liquid = new Liquid({ memoryLimit: 1e9, renderLimit: 1 })
+      expect(() => liquid.parseAndRenderSync('{%- tablerow i in (1..1000000) cols:1 -%}{%- endtablerow -%}', {}))
+        .toThrow('template render limit exceeded')
+    })
   })
   describe('#memoryLimit', () => {
     it('should throw for too many array creation in filters', async () => {

From 3129d46dc95efa357b00e5a57ee1af80a13d72ed Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 10 May 2026 14:35:28 +0800
Subject: [PATCH 43/64] fix(date): cap strftime widths and account padding in
 memoryLimit (#895)

* fix(date): cap strftime widths and account padding in memoryLimit

- Clamp numeric strftime pad widths to MAX_STRFTIME_PAD (1024)
- Export estimateStrftimePaddingMemory for the date filter to charge memoryLimit
- Replace unbounded pad() concatenation loop with ch.repeat + single concat
- Add regression tests for clamping and memoryLimit on huge %width directives

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(date): harden strftime memory accounting and document security model

Move strftime memory charging into the same formatting path used for padding, enforce pre-allocation checks, and add regression tests for non-string date format PoCs. Add dedicated docs clarifying that memoryLimit is cooperative DoS mitigation and not strict heap isolation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(zh-cn): add security model docs for DoS limits

Add a Chinese security-model tutorial and link it from the Chinese DoS guide to clarify that memoryLimit is cooperative accounting, list uncounted custom conversion cases, and recommend avoiding fully user-defined templates in online services.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: consolidate DoS docs into security-model pages

Merge DoS guidance into security-model docs in both English and Chinese, and remove the placeholder dos.md pages to avoid duplicate/redirect-only docs.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: merge DoS details into security-model docs

Move the detailed parseLimit/renderLimit/memoryLimit explanations and examples into the English and Chinese security-model pages so content from the removed dos pages is preserved.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: reorganize security-model structure for clarity

Restructure English and Chinese security-model docs into a consistent flow: security boundary, limits overview, per-limit details, and online service guidance.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strftime): simplify %N width parsing logic

Use regex-backed width assumptions to simplify %N width normalization and padding memory accounting while keeping behavior equivalent.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strftime): rely on memoryLimit for width control

Remove MAX_STRFTIME_PAD hard capping and rely on memoryLimit enforcement before padding allocation. Update strftime/date tests and security-model docs to match the new boundary and renderLimit caveats.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(strftime): use add() once for padding, minimize churn

- pad(): replace per-char loop with a single add(str, ch.repeat(n)) call.
  The earlier `probe[0] === ch` heuristic was wrong when ch happened to
  equal a leading char of 'probe' (e.g. ch === 'p').
- strftime.ts: revert unrelated typing/structural refactors so the diff
  contains only the memoryLimit threading and the %N memory charge.
- docs: rewire the deleted dos.html sidebar entry to security-model.html
  (with localized labels) so the deleted page does not 404 from the
  sidebar.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/source/_data/sidebar.yml                 |  2 +-
 docs/source/tutorials/dos.md                  | 57 --------------
 docs/source/tutorials/security-model.md       | 76 +++++++++++++++++++
 docs/source/zh-cn/tutorials/dos.md            | 55 --------------
 docs/source/zh-cn/tutorials/security-model.md | 76 +++++++++++++++++++
 docs/themes/navy/languages/en.yml             |  2 +-
 docs/themes/navy/languages/zh-cn.yml          |  2 +-
 src/filters/date.ts                           | 12 +--
 src/util/strftime.ts                          | 12 ++-
 src/util/underscore.ts                        |  6 +-
 test/integration/filters/date.spec.ts         | 27 +++++++
 11 files changed, 200 insertions(+), 127 deletions(-)
 delete mode 100644 docs/source/tutorials/dos.md
 create mode 100644 docs/source/tutorials/security-model.md
 delete mode 100644 docs/source/zh-cn/tutorials/dos.md
 create mode 100644 docs/source/zh-cn/tutorials/security-model.md

diff --git a/docs/source/_data/sidebar.yml b/docs/source/_data/sidebar.yml
index 7f54e8baa..6edcc6b29 100644
--- a/docs/source/_data/sidebar.yml
+++ b/docs/source/_data/sidebar.yml
@@ -19,7 +19,7 @@ tutorials:
     plugins: plugins.html
     operators: operators.html
     truth: truthy-and-falsy.html
-    dos: dos.html
+    security_model: security-model.html
     static_analysis: static-analysis.html
   miscellaneous:
     migration9: migrate-to-9.html
diff --git a/docs/source/tutorials/dos.md b/docs/source/tutorials/dos.md
deleted file mode 100644
index 03feb0d3a..000000000
--- a/docs/source/tutorials/dos.md
+++ /dev/null
@@ -1,57 +0,0 @@
----
-title: DoS Prevention
----
-
-When the template or data context cannot be trusted, enabling DoS prevention options is crucial. LiquidJS provides 3 options for this purpose: `parseLimit`, `renderLimit`, and `memoryLimit`.
-
-## TL;DR
-
-Setting these options can largely ensure that your LiquidJS instance won't hang for extended periods or consume excessive memory. These limits are based on the available JavaScript APIs, so they are not precise hard limits but thresholds to help prevent your process from failing or hanging.
-
-```typescript
-const liquid = new Liquid({
-    parseLimit: 1e8, // typical size of your templates in each render
-    renderLimit: 1000, // limit each render to be completed in 1s
-    memoryLimit: 1e9, // memory available for LiquidJS (1e9 for 1GB)
-})
-```
-
-When a `parse()` or `render()` cannot be completed within given resource, it throws.
-
-## parseLimit
-
-[parseLimit][parseLimit] restricts the size (character length) of templates parsed in each `.parse()` call, including referenced partials and layouts. Since LiquidJS parses template strings in near O(n) time, limiting total template length is usually sufficient.
-
-A typical PC handles `1e8` (100M) characters without issues.
-
-## renderLimit
-
-Restricting template size alone is insufficient because dynamic loops with large counts can occur in render time. [renderLimit][renderLimit] mitigates this by limiting the time consumed by each `render()` call.
-
-```liquid
-{%- for i in (1..10000000) -%}
-    order: {{i}}
-{%- endfor -%}
-```
-
-Render time is checked on a per-template basis (before rendering each template). In the above example, there are 2 templates in the loop: `order: ` and `{{i}}`, render time will be checked 10000000x2 times.
-
-For time-consuming tags and filters within a single template, the process can still hang. For fully controlled rendering, consider using a process manager like [paralleljs][paralleljs].
-
-## memoryLimit
-
-Even with small number of templates and iterations, memory usage can grow exponentially. In the following example, memory doubles with each iteration:
-
-```liquid
-{% assign array = "1,2,3" | split: "," %}
-{% for i in (1..32) %}
-    {% assign array = array | concat: array %}
-{% endfor %}
-```
-
-[memoryLimit][memoryLimit] restricts memory-sensitive filters to prevent excessive memory allocation. As [JavaScript uses GC to manage memory](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management), `memoryLimit` limits only the total number of objects allocated by memory sensitive filters in LiquidJS thus may not reflect the actual memory footprint.
-
-[paralleljs]: https://www.npmjs.com/package/paralleljs
-[parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
-[renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
-[memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
\ No newline at end of file
diff --git a/docs/source/tutorials/security-model.md b/docs/source/tutorials/security-model.md
new file mode 100644
index 000000000..f4021639b
--- /dev/null
+++ b/docs/source/tutorials/security-model.md
@@ -0,0 +1,76 @@
+---
+title: Security Model
+---
+
+LiquidJS provides DoS-oriented limits (`parseLimit`, `renderLimit`, `memoryLimit`) to reduce risk. This page explains what each limit protects, and the security boundary you should assume in production.
+
+## Security boundary
+
+The built-in limits are cooperative safeguards, not strict runtime isolation.
+
+- They do **not** equal process RSS/heap usage.
+- They do **not** sandbox JavaScript execution.
+- They should be combined with process/container limits and request timeouts for defense in depth.
+
+## Limits at a glance
+
+- [parseLimit][parseLimit]: limit total template size per `parse()` call.
+- [renderLimit][renderLimit]: limit total render time per `render()` call.
+- [memoryLimit][memoryLimit]: cooperatively limit memory-sensitive allocations counted by LiquidJS.
+
+## Limit details
+
+### parseLimit
+
+[parseLimit][parseLimit] restricts the size (character length) of templates parsed in each `.parse()` call, including referenced partials and layouts. Since LiquidJS parses template strings in near O(n) time, limiting total template length is usually sufficient.
+
+A typical PC handles `1e8` (100M) characters without issues.
+
+### renderLimit
+
+Restricting template size alone is insufficient because dynamic loops with large counts can occur in render time. [renderLimit][renderLimit] mitigates this by limiting the time consumed by each `render()` call.
+
+```liquid
+{%- for i in (1..10000000) -%}
+    order: {{i}}
+{%- endfor -%}
+```
+
+Render time is checked on a per-template basis (before rendering each template). In the above example, there are 2 templates in the loop: `order: ` and `{{i}}`, render time will be checked 10000000x2 times.
+
+`renderLimit` is not a hard CPU limiter. It is checked between template renders, so compute-intensive filters/tags/user-defined functions or deeply nested template execution between checks can still cause DoS.
+
+### memoryLimit
+
+`memoryLimit` only limits operations that LiquidJS explicitly counts.
+
+- Counted: memory-sensitive LiquidJS operations that call internal memory accounting.
+- Not guaranteed counted: arbitrary user object behavior such as custom `toValue()`/`toString()` chains, or other host-side code that allocates outside LiquidJS accounting points.
+
+In other words, `memoryLimit` limits what LiquidJS counts, not every byte your process may allocate.
+
+Even with small number of templates and iterations, memory usage can grow exponentially. In the following example, memory doubles with each iteration:
+
+```liquid
+{% assign array = "1,2,3" | split: "," %}
+{% for i in (1..32) %}
+    {% assign array = array | concat: array %}
+{% endfor %}
+```
+
+As [JavaScript uses GC to manage memory](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management), `memoryLimit` may not reflect the actual memory footprint.
+
+## Online service guidance
+
+If you run an online service, avoid rendering fully user-defined templates whenever possible.
+
+- Prefer curated templates or a restricted template subset.
+- If user-defined templates are required, isolate rendering (worker/process/container), enforce OS/container memory and CPU limits, and apply request rate limits.
+- Treat `parseLimit`/`renderLimit`/`memoryLimit` as one layer in a broader DoS defense strategy.
+
+For heavy single-template operations, process-level isolation is still recommended (for example with [paralleljs][paralleljs]).
+
+[paralleljs]: https://www.npmjs.com/package/paralleljs
+[parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
+[renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
+[memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
diff --git a/docs/source/zh-cn/tutorials/dos.md b/docs/source/zh-cn/tutorials/dos.md
deleted file mode 100644
index a06be68af..000000000
--- a/docs/source/zh-cn/tutorials/dos.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: 防止 DoS 攻击
----
-
-当模板或数据上下文不可信时，启用DoS预防选项至关重要。LiquidJS 提供了三个选项用于此目的：`parseLimit`、`renderLimit` 和 `memoryLimit`。
-
-## TL;DR
-
-设置这些选项可以在很大程度上确保你的 LiquidJS 实例不会长时间挂起或消耗过多内存。这些限制基于可用的 JavaScript API，因此它们不是精确的硬性限制，而是确保你的进程不会失败或挂起的阈值。
-
-```typescript
-const liquid = new Liquid({
-    parseLimit: 1e8, // 每次渲染的模板的典型大小
-    renderLimit: 1000, // 每次渲染最多 1s
-    memoryLimit: 1e9, // LiquidJS 可用的内存（1e9 对应 1GB）
-})
-```
-
-## parseLimit
-
-[parseLimit][parseLimit] 限制每次 `.parse()` 调用中解析的模板大小（字符长度），包括引用的 partials 和 layouts。由于 LiquidJS 解析模板字符串的时间复杂度接近 O(n)，限制模板总长度通常就足够了。
-
-普通电脑可以很容易处理 `1e8`（100M）个字符的模板。
-
-## renderLimit
-
-仅限制模板大小是不够的，因为在渲染时可能会出现动态的数组和循环。[renderLimit][renderLimit] 通过限制每次 `render()` 调用的时间来缓解这些问题。
-
-```liquid
-{%- for i in (1..10000000) -%}
-    order: {{i}}
-{%- endfor -%}
-```
-
-渲染时间是在渲染每个模板之前检查的。在上面的例子中，循环中有两个模板：`order: ` 和 `{{i}}`，因此会检查 2x10000000 次。
-
-单个模板内的标签和过滤器仍然可能把进程挂起。要完全控制渲染过程，建议使用类似 [paralleljs][paralleljs] 的进程管理器。
-
-## memoryLimit
-
-即使模板和迭代次数较少，内存使用量也可能呈指数增长。在下面的示例中，内存会在每次迭代中翻倍：
-
-```liquid
-{% assign array = "1,2,3" | split: "," %}
-{% for i in (1..32) %}
-    {% assign array = array | concat: array %}
-{% endfor %}
-```
-
-[memoryLimit][memoryLimit] 限制内存敏感的过滤器，以防止过度的内存分配。由于 [JavaScript 使用 GC 来管理内存](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management)，`memoryLimit` 仅限制 LiquidJS 中内存敏感过滤器分配的对象总数，因此可能无法反映实际的内存占用。
-
-[paralleljs]: https://www.npmjs.com/package/paralleljs
-[parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
-[renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
-[memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
\ No newline at end of file
diff --git a/docs/source/zh-cn/tutorials/security-model.md b/docs/source/zh-cn/tutorials/security-model.md
new file mode 100644
index 000000000..ce3cdd17c
--- /dev/null
+++ b/docs/source/zh-cn/tutorials/security-model.md
@@ -0,0 +1,76 @@
+---
+title: 安全模型
+---
+
+LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`memoryLimit`）来降低风险。本文按统一结构说明每个限制的作用范围，以及你在生产环境应采用的安全边界。
+
+## 安全边界
+
+内置限制是协作式防护，不是严格的运行时隔离。
+
+- 它**不等于**进程的 RSS/heap 实际占用。
+- 它**不是** JavaScript 沙箱。
+- 在生产环境中应结合进程/容器资源限制和请求超时做分层防护。
+
+## 限制速览
+
+- [parseLimit][parseLimit]：限制每次 `parse()` 的模板总长度。
+- [renderLimit][renderLimit]：限制每次 `render()` 的总渲染时间。
+- [memoryLimit][memoryLimit]：协作式限制 LiquidJS 已记账的内存敏感分配。
+
+## 限制详解
+
+### parseLimit
+
+[parseLimit][parseLimit] 限制每次 `.parse()` 调用中解析的模板大小（字符长度），包括引用的 partials 和 layouts。由于 LiquidJS 解析模板字符串的时间复杂度接近 O(n)，限制模板总长度通常就足够了。
+
+普通电脑可以很容易处理 `1e8`（100M）个字符的模板。
+
+### renderLimit
+
+仅限制模板大小是不够的，因为在渲染时可能会出现动态的数组和循环。[renderLimit][renderLimit] 通过限制每次 `render()` 调用的时间来缓解这些问题。
+
+```liquid
+{%- for i in (1..10000000) -%}
+    order: {{i}}
+{%- endfor -%}
+```
+
+渲染时间是在渲染每个模板之前检查的。在上面的例子中，循环中有两个模板：`order: ` 和 `{{i}}`，因此会检查 2x10000000 次。
+
+`renderLimit` 不是硬性的 CPU 限制器。它是在模板渲染边界做检查，因此检查点之间的高计算开销过滤器/标签/用户自定义函数，或深层模板嵌套，仍可能导致 DoS。
+
+### memoryLimit
+
+`memoryLimit` 只限制 LiquidJS 显式记账到的操作。
+
+- 会被统计：LiquidJS 内部调用了内存记账逻辑的内存敏感操作。
+- 不保证被统计：任意用户对象行为（例如自定义 `toValue()` / `toString()` 链）以及其他发生在 LiquidJS 记账点之外的宿主侧分配。
+
+换句话说，`memoryLimit` 限制的是 LiquidJS 的“已记账分配”，而不是进程里每一个字节的分配。
+
+即使模板和迭代次数较少，内存使用量也可能呈指数增长。在下面的示例中，内存会在每次迭代中翻倍：
+
+```liquid
+{% assign array = "1,2,3" | split: "," %}
+{% for i in (1..32) %}
+    {% assign array = array | concat: array %}
+{% endfor %}
+```
+
+由于 [JavaScript 使用 GC 来管理内存](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management)，`memoryLimit` 可能无法反映实际的内存占用。
+
+## 在线服务建议
+
+如果你运行在线服务，建议尽量避免渲染完全由用户定义的模板。
+
+- 优先使用受控模板或受限模板子集。
+- 如果必须支持用户自定义模板，请隔离渲染（worker/进程/容器），并同时配置操作系统或容器级的内存/CPU 限额与请求限流。
+- 将 `parseLimit` / `renderLimit` / `memoryLimit` 视为 DoS 防护体系中的一层，而不是唯一防线。
+
+对于单个模板中的重型操作，仍建议使用进程级隔离（例如 [paralleljs][paralleljs]）。
+
+[paralleljs]: https://www.npmjs.com/package/paralleljs
+[parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
+[renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
+[memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
diff --git a/docs/themes/navy/languages/en.yml b/docs/themes/navy/languages/en.yml
index 51cb9052e..e75e09d00 100644
--- a/docs/themes/navy/languages/en.yml
+++ b/docs/themes/navy/languages/en.yml
@@ -51,7 +51,7 @@ sidebar:
     plugins: Plugins
     operators: Operators
     truth: Truthy and Falsy
-    dos: DoS
+    security_model: Security Model
     static_analysis: Static Analysis
 
     miscellaneous: Miscellaneous
diff --git a/docs/themes/navy/languages/zh-cn.yml b/docs/themes/navy/languages/zh-cn.yml
index cd2889a61..e5ea5d3b2 100644
--- a/docs/themes/navy/languages/zh-cn.yml
+++ b/docs/themes/navy/languages/zh-cn.yml
@@ -51,7 +51,7 @@ sidebar:
     plugins: 插件
     operators: 运算符
     truth: 真和假
-    dos: DoS
+    security_model: 安全模型
     static_analysis: 静态分析
 
     miscellaneous: 其他
diff --git a/src/filters/date.ts b/src/filters/date.ts
index 6bbef46c3..07665c957 100644
--- a/src/filters/date.ts
+++ b/src/filters/date.ts
@@ -3,13 +3,14 @@ import { FilterImpl } from '../template'
 import { NormalizedFullOptions } from '../liquid-options'
 
 export function date (this: FilterImpl, v: string | Date, format?: string, timezoneOffset?: number | string) {
-  const size = ((v as string)?.length ?? 0) + (format?.length ?? 0) + ((timezoneOffset as string)?.length ?? 0)
+  const size = ((v as string)?.length ?? 0) + ((timezoneOffset as string)?.length ?? 0)
   this.context.memoryLimit.use(size)
   const date = parseDate(v, this.context.opts, timezoneOffset)
   if (!date) return v
   format = toValue(format)
   format = isNil(format) ? this.context.opts.dateFormat : stringify(format)
-  return strftime(date, format)
+  this.context.memoryLimit.use(format.length)
+  return strftime(date, format, this.context.memoryLimit)
 }
 
 export function date_to_xmlschema (this: FilterImpl, v: string | Date) {
@@ -31,13 +32,14 @@ export function date_to_long_string (this: FilterImpl, v: string | Date, type?:
 function stringify_date (this: FilterImpl, v: string | Date, month_type: string, type?: string, style?: string) {
   const date = parseDate(v, this.context.opts)
   if (!date) return v
+  const ml = this.context.memoryLimit
   if (type === 'ordinal') {
     const d = date.getDate()
     return style === 'US'
-      ? strftime(date, `${month_type} ${d}%q, %Y`)
-      : strftime(date, `${d}%q ${month_type} %Y`)
+      ? strftime(date, `${month_type} ${d}%q, %Y`, ml)
+      : strftime(date, `${d}%q ${month_type} %Y`, ml)
   }
-  return strftime(date, `%d ${month_type} %Y`)
+  return strftime(date, `%d ${month_type} %Y`, ml)
 }
 
 function parseDate (v: string | Date, opts: NormalizedFullOptions, timezoneOffset?: number | string): LiquidDate | undefined {
diff --git a/src/util/strftime.ts b/src/util/strftime.ts
index 535152fd4..e6ac04ebf 100644
--- a/src/util/strftime.ts
+++ b/src/util/strftime.ts
@@ -1,11 +1,13 @@
 import { changeCase, padStart, padEnd } from './underscore'
 import { LiquidDate } from './liquid-date'
+import type { Limiter } from './limiter'
 
 const rFormat = /%([-_0^#:]+)?(\d+)?([EO])?(.)/
 interface FormatOptions {
   flags: object;
   width?: string;
   modifier?: string;
+  memoryLimit?: Pick<Limiter, 'use'>;
 }
 
 // prototype extensions
@@ -95,6 +97,7 @@ const formatCodes = {
   N: (d: LiquidDate, opts: FormatOptions) => {
     const width = Number(opts.width) || 9
     const str = String(d.getMilliseconds()).slice(0, width)
+    opts.memoryLimit?.use(width - str.length)
     return padEnd(str, width, '0')
   },
   p: (d: LiquidDate) => (d.getHours() < 12 ? 'AM' : 'PM'),
@@ -118,25 +121,25 @@ const formatCodes = {
 };
 (formatCodes as any).h = formatCodes.b
 
-export function strftime (d: LiquidDate, formatStr: string) {
+export function strftime (d: LiquidDate, formatStr: string, memoryLimit?: Pick<Limiter, 'use'>) {
   let output = ''
   let remaining = formatStr
   let match
   while ((match = rFormat.exec(remaining))) {
     output += remaining.slice(0, match.index)
     remaining = remaining.slice(match.index + match[0].length)
-    output += format(d, match)
+    output += format(d, match, memoryLimit)
   }
   return output + remaining
 }
 
-function format (d: LiquidDate, match: RegExpExecArray) {
+function format (d: LiquidDate, match: RegExpExecArray, memoryLimit?: Pick<Limiter, 'use'>) {
   const [input, flagStr = '', width, modifier, conversion] = match
   const convert = formatCodes[conversion]
   if (!convert) return input
   const flags = {}
   for (const flag of flagStr) flags[flag] = true
-  let ret = String(convert(d, { flags, width, modifier }))
+  let ret = String(convert(d, { flags, width, modifier, memoryLimit }))
   let padChar = padSpaceChars.has(conversion) ? ' ' : '0'
   let padWidth = width || padWidths[conversion] || 0
   if (flags['^']) ret = ret.toUpperCase()
@@ -144,5 +147,6 @@ function format (d: LiquidDate, match: RegExpExecArray) {
   if (flags['_']) padChar = ' '
   else if (flags['0']) padChar = '0'
   if (flags['-']) padWidth = 0
+  memoryLimit?.use(Number(padWidth) - ret.length)
   return padStart(ret, padWidth, padChar)
 }
diff --git a/src/util/underscore.ts b/src/util/underscore.ts
index f3558da1a..665fdef6c 100644
--- a/src/util/underscore.ts
+++ b/src/util/underscore.ts
@@ -152,9 +152,9 @@ export function padEnd (str: any, length: number, ch = ' ') {
 
 export function pad (str: any, length: number, ch: string, add: (str: string, ch: string) => string) {
   str = String(str)
-  let n = length - str.length
-  while (n-- > 0) str = add(str, ch)
-  return str
+  const n = length - str.length
+  if (n <= 0) return str
+  return add(str, ch.repeat(n))
 }
 
 export function identify<T> (val: T): T {
diff --git a/test/integration/filters/date.spec.ts b/test/integration/filters/date.spec.ts
index 384aecedf..992876906 100644
--- a/test/integration/filters/date.spec.ts
+++ b/test/integration/filters/date.spec.ts
@@ -204,6 +204,33 @@ describe('filters/date', function () {
       return test('{{ "1990-12-31T23:00:00Z" | date: "%Y-%m-%dT%H:%M:%S" }}', '1991-01-01T04:30:00', undefined, optsWithDateFormat)
     })
   })
+  describe('strftime width / memoryLimit', () => {
+    it('should charge memoryLimit for huge numeric strftime widths', () => {
+      const liquid = new Liquid({ memoryLimit: 500 })
+      expect(() => liquid.parseAndRenderSync('{{ d | date: f }}', { d: 'now', f: '%5000000d' }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should charge memoryLimit for array format PoC', () => {
+      const liquid = new Liquid({ memoryLimit: 50, renderLimit: 1e9 })
+      expect(() => liquid.parseAndRenderSync('{{ d | date: f }}', { d: 'now', f: ['a'.repeat(2000000)] }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should charge memoryLimit for object toString format PoC', () => {
+      const liquid = new Liquid({ memoryLimit: 50, renderLimit: 1e9 })
+      const huge = 'a'.repeat(2000000)
+      const f = { toString: () => huge }
+      expect(() => liquid.parseAndRenderSync('{{ d | date: f }}', { d: 'now', f }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should honor numeric strftime pad width when memoryLimit allows', () => {
+      const liquid = new Liquid({ memoryLimit: 1e7 })
+      const out = liquid.parseAndRenderSync('{{ d | date: f }}', { d: 'now', f: '%5000d' })
+      expect(out.length).toBe(5000)
+      const tight = new Liquid({ memoryLimit: 100 })
+      expect(() => tight.parseAndRenderSync('{{ d | date: f }}', { d: 'now', f: '%5000d' }))
+        .toThrow('memory alloc limit exceeded')
+    })
+  })
 })
 describe('filters/date_to_xmlschema', function () {
   const liquid = new Liquid()

From 3616a744b9abeb425c217b340a2397d46176afb8 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 11 May 2026 23:59:40 +0800
Subject: [PATCH 44/64] fix(strip_html): rewrite as linear single-pass scan to
 avoid ReDoS (#896)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix(strip_html): rewrite as linear single-pass scan to avoid ReDoS

The previous strip_html regex
  /<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<[\s\S]*?>|<!--[\s\S]*?-->/g
contains lazy alternatives that backtrack O(n^2) on inputs with many
unclosed `<script` / `<style` openers. A 350KB payload of
`'<script'.repeat(50000)` blocked the Node.js event loop for ~10s, and
cost grew quadratically with input size. memoryLimit only charged
str.length, which does not bound regex CPU.

Replace the regex with an indexOf-based single-pass scan. For each `<`
we:
- if `<script` opener: find next `</script>` and skip the whole block;
  cache "no closer after pos k" so subsequent unclosed `<script`
  openers do not re-scan the tail.
- same for `<style` / `</style>`.
- otherwise treat as a generic `<...>` tag (matches the original
  behavior, where the `<[\s\S]*?>` alternative also caught comments).
- if no closing `>` exists, emit the tail as literal text and stop.

Total work is O(n). All existing strip_html test cases pass unchanged.

Add regression tests covering the PoCs (`<script` / `<style` repeats,
and `<script>foo` repeats with `>` but no `</script>`) plus a
memoryLimit assertion.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strip_html): factor block kinds into a small table

Same algorithm and complexity, fewer lines. Document why a regex-only
solution can't be O(n) in V8 (no atomic groups / possessive quantifiers
/ memoization, so unrolled-loop patterns are still O(n^2) on unclosed
openers — empirically confirmed: original 280KB ~4s, Friedl unrolled
~14s, atomic lookahead ~7s; tokenizer ~1ms).

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strip_html): inline block kinds to match file style

Drop the module-level STRIP_BLOCKS table; the rest of the file keeps
each filter self-contained (only escapeMap/unescapeMap are top-level
maps shared across filters). Two openers don't justify a table.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strip_html): unify raw-text blocks; treat <!--...--> as opaque

In HTML5, <script>, <style>, and <!-- --> are all raw-text blocks: their
content is opaque until the matching closer, so a `>` inside CSS, JS, or
a comment must not be treated as a tag end. The previous code only had
this special handling for <script> and <style>; comments containing `>`
fell through to the generic `<...>` branch and were partially stripped
(e.g. `<!-- a > b -->` left `b -->` in the output).

Match Shopify Liquid's STRIP_HTML_BLOCKS set (script + style + comment),
and consolidate the three near-identical branches into a small
opener/closer table inside the function.

Algorithm and complexity unchanged (O(n) via indexOf + cached closer
positions). Add a regression test for `>` inside a comment.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strip_html): drop position cache, delete dead blocks from Set

Once `indexOf(closer, X)` returns -1, all subsequent searches (with
monotonically increasing start) also return -1. So tracking absence is
enough; storing positions is unnecessary. Make `blocks` a Set and
delete a kind once its closer is known absent — no parallel `dead`
bookkeeping. Use Jest's per-test timeout for the ReDoS regressions
instead of manual Date.now() bookkeeping.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(strip_html): treat '<...>' as a catch-all block kind

Adding ['<', '>'] as the lowest-priority entry of `blocks` lets the
inner loop subsume the generic-tag fallback: the `end` sentinel and
its `< 0` / `<= 0` follow-up checks disappear, the "no terminator"
exit becomes a single `i === lt` test, and Set<[string, string]>
collapses to Map<string, string>.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/filters/html.ts                   | 19 ++++++++++++++++++-
 test/integration/filters/html.spec.ts |  3 +++
 test/integration/liquid/dos.spec.ts   | 25 +++++++++++++++++++++++++
 3 files changed, 46 insertions(+), 1 deletion(-)

diff --git a/src/filters/html.ts b/src/filters/html.ts
index 0dd5f77d3..21cb8c4a9 100644
--- a/src/filters/html.ts
+++ b/src/filters/html.ts
@@ -42,8 +42,25 @@ export function newline_to_br (this: FilterImpl, v: string) {
   return str.replace(/\r?\n/gm, '<br />\n')
 }
 
+// Raw-text blocks (HTML5) plus '<...>' as the catch-all kind; a regex
+// equivalent is O(n^2) in V8 on unclosed openers.
 export function strip_html (this: FilterImpl, v: string) {
   const str = stringify(v)
   this.context.memoryLimit.use(str.length)
-  return str.replace(/<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<[\s\S]*?>|<!--[\s\S]*?-->/g, '')
+  const blocks = new Map([['<script', '</script>'], ['<style', '</style>'], ['<!--', '-->'], ['<', '>']])
+  let out = ''
+  let i = 0
+  while (i < str.length) {
+    const lt = str.indexOf('<', i)
+    if (lt < 0) return out + str.slice(i)
+    out += str.slice(i, lt)
+    for (const [opener, closer] of blocks) {
+      if (!str.startsWith(opener, lt)) continue
+      const e = str.indexOf(closer, lt + opener.length)
+      if (e >= 0) { i = e + closer.length; break }
+      blocks.delete(opener)
+    }
+    if (i === lt) return out + str.slice(lt)
+  }
+  return out
 }
diff --git a/test/integration/filters/html.spec.ts b/test/integration/filters/html.spec.ts
index c4551dad4..e858420e0 100644
--- a/test/integration/filters/html.spec.ts
+++ b/test/integration/filters/html.spec.ts
@@ -57,6 +57,9 @@ describe('filters/html', function () {
     it('should strip multiline comments', function () {
       expect(liquid.parseAndRenderSync('{{"<!--foo\r\nbar \ncoo\t  \r\n  -->"|strip_html}}')).toBe('')
     })
+    it('should treat > inside comments as comment content (not a tag end)', function () {
+      expect(liquid.parseAndRenderSync('{{ "<!-- a > b -->after" | strip_html }}')).toBe('after')
+    })
     it('should strip all style tags and their contents', function () {
       return test('{{ "<style>cite { font-style: italic; }</style><cite>Ulysses<cite>?" | strip_html }}',
         'Ulysses?')
diff --git a/test/integration/liquid/dos.spec.ts b/test/integration/liquid/dos.spec.ts
index 796f2db8e..85783564e 100644
--- a/test/integration/liquid/dos.spec.ts
+++ b/test/integration/liquid/dos.spec.ts
@@ -79,5 +79,30 @@ describe('DoS related', function () {
       await expect(liquid.parseAndRender(src, { array, count: 3 })).resolves.toBe('a a a a a a a a')
       await expect(liquid.parseAndRender(src, { array, count: 100 })).rejects.toThrow('memory alloc limit exceeded, line:1, col:26')
     })
+    it('should charge strip_html input length to memoryLimit', () => {
+      const liquid = new Liquid({ memoryLimit: 100 })
+      expect(() => liquid.parseAndRenderSync('{{ s | strip_html }}', { s: 'a'.repeat(200) }))
+        .toThrow('memory alloc limit exceeded')
+    })
+  })
+  describe('strip_html ReDoS', () => {
+    // Regression for O(n^2) backtracking on unclosed `<script` / `<style` openers.
+    // The previous regex stalled the event loop for ~10s on 350KB of `'<script'.repeat`.
+    // The per-test timeout below caps total time; an O(n^2) regression would blow it.
+    it('should handle many unclosed <script openers in linear time', () => {
+      const liquid = new Liquid()
+      const payload = '<script'.repeat(50000)
+      expect(liquid.parseAndRenderSync('{{ x | strip_html }}', { x: payload })).toBe(payload)
+    }, 1000)
+    it('should handle many unclosed <style openers in linear time', () => {
+      const liquid = new Liquid()
+      const payload = '<style'.repeat(50000)
+      expect(liquid.parseAndRenderSync('{{ x | strip_html }}', { x: payload })).toBe(payload)
+    }, 1000)
+    it('should handle <script openers that have > but no </script> in linear time', () => {
+      const liquid = new Liquid()
+      const payload = '<script>foo'.repeat(50000)
+      expect(liquid.parseAndRenderSync('{{ x | strip_html }}', { x: payload })).toBe('foo'.repeat(50000))
+    }, 1000)
   })
 })

From 457fae0736c3ec862539b9dbf7f477e6c08fb6c6 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Thu, 14 May 2026 22:18:10 +0800
Subject: [PATCH 45/64] fix(security): block Object.prototype filter/tag
 lookups (RCE) (#897)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix(security): block Object.prototype filter/tag lookups (RCE)

`liquid.filters` and `liquid.tags` were plain `{}` so bracket access on
template-controlled keys inherited from `Object.prototype`. Most damaging:
`{{ x | valueOf }}` resolved to `Object.prototype.valueOf`, which the
filter pipeline called as a handler with `this = FilterImpl`; valueOf
returns its receiver, leaking `context`, `liquid`, `token` (and via them
parser, loader, fs) into the template — chain that with `group_by`/`where`
gadgets and an attacker reaches `Function`/`child_process` for RCE.
Same shape on the tag side: `{% constructor %}` bypassed the
"tag not found" assertion and crashed with a confusing message.

Use null-prototype storage so `liquid.filters[name]` / `liquid.tags[name]`
only resolve to explicitly registered entries. The existing
`assert(impl || !strictFilters)` and `assert(TagClass, ...)` now do the
right thing for `valueOf`, `toString`, `constructor`, `__proto__`,
`hasOwnProperty`, `isPrototypeOf`, `__defineGetter__`, etc.

Co-authored-by: Cursor <cursoragent@cursor.com>

* test: fold prototype-registry regressions into register + e2e

Co-authored-by: Cursor <cursoragent@cursor.com>

* test: assert null-prototype registries vs all Object.prototype keys

Co-authored-by: Cursor <cursoragent@cursor.com>

* test: dedupe registry checks; merge filter prototype loop

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(context): use null-prototype scope and register objects

Add createScope(); use for bottom scope, spawn default, getAll merge, ctx.push frames, filter loops, include/layout blocks registers, and cycle groups. registers uses Object.create(null) and getRegister uses ??.

For-loop continue register defaults to 0 (not {}): Array.slice coerces plain {} but not null-prototype objects.

Export createScope from the package entry.

Co-authored-by: Cursor <cursoragent@cursor.com>

* revert(context): plain {} registers and getRegister ||

Registers are only mutated by tag implementations, not templates; keep null-prototype scopes/createScope for push frames.

Co-authored-by: Cursor <cursoragent@cursor.com>

* test(context): assert scope isolation without probing prototypes

Replace Object.getPrototypeOf checks for bottom() and getAll() with
'in' checks on typical Object.prototype names plus a merge assertion.

Co-authored-by: Cursor <cursoragent@cursor.com>

* test(e2e): assert constructor filter/tag lookups (node + UMD)

Co-authored-by: Cursor <cursoragent@cursor.com>

* test(context): cover Object.prototype keys under ownPropertyOnly

- Add getSync cases for constructor and valueOf on plain objects
- Remove scope storage tests that used the in operator

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor: remove createScope helper

Drop the exported helper and finish migrating call sites. Revert incidental context/for/include/layout churn so behavior matches mainline aside from the removal. Trim duplicate e2e and heavy Object.prototype loops in registry tests.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: document ownPropertyOnly and Drop security in security model

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(zh-cn): sync security model with ownPropertyOnly and Drop notes

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/source/tutorials/security-model.md          | 15 ++++++++++++++-
 docs/source/zh-cn/tutorials/security-model.md    | 15 ++++++++++++++-
 src/liquid.ts                                    |  4 ++--
 test/integration/liquid/register-filters.spec.ts |  6 ++++++
 test/integration/liquid/register-tags.spec.ts    |  6 ++++++
 5 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/docs/source/tutorials/security-model.md b/docs/source/tutorials/security-model.md
index f4021639b..d1f0854d9 100644
--- a/docs/source/tutorials/security-model.md
+++ b/docs/source/tutorials/security-model.md
@@ -2,7 +2,7 @@
 title: Security Model
 ---
 
-LiquidJS provides DoS-oriented limits (`parseLimit`, `renderLimit`, `memoryLimit`) to reduce risk. This page explains what each limit protects, and the security boundary you should assume in production.
+LiquidJS provides DoS-oriented limits (`parseLimit`, `renderLimit`, `memoryLimit`) to reduce risk. This page summarizes those limits, [`ownPropertyOnly`][ownPropertyOnly], custom [`Drop`][drop] usage, and the security boundary to assume in production.
 
 ## Security boundary
 
@@ -60,6 +60,14 @@ Even with small number of templates and iterations, memory usage can grow expone
 
 As [JavaScript uses GC to manage memory](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management), `memoryLimit` may not reflect the actual memory footprint.
 
+## `ownPropertyOnly` and scope data
+
+With [`ownPropertyOnly`][ownPropertyOnly] `true`, plain scope objects only expose **own** properties (no inherited / `Object.prototype` keys). Default `false` follows normal JS property access. Use `true` for untrusted or polluted objects; add [`strictVariables`][strictVariables] if missing paths should error. Override per render via [`RenderOptions`][renderOwnPropertyOnly]. This is a read policy for scope data—not a sandbox for filters, tags, or your code.
+
+## Custom `Drop` classes
+
+[`Drop`][drop] values are not restricted the same way: LiquidJS still reads the prototype chain and may call [`liquidMethodMissing`][liquidMethodMissing]. **You** control what a drop exposes; narrow APIs and never feed unsafe data into drops unless the class is built for template access. `ownPropertyOnly` alone does not harden custom drops—audit them like any privileged code.
+
 ## Online service guidance
 
 If you run an online service, avoid rendering fully user-defined templates whenever possible.
@@ -74,3 +82,8 @@ For heavy single-template operations, process-level isolation is still recommend
 [parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
 [renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
 [memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
+[ownPropertyOnly]: /api/interfaces/LiquidOptions.html#ownPropertyOnly
+[renderOwnPropertyOnly]: /api/interfaces/RenderOptions.html#ownPropertyOnly
+[strictVariables]: /api/interfaces/LiquidOptions.html#strictVariables
+[drop]: /api/classes/Drop.html
+[liquidMethodMissing]: /api/classes/Drop.html#liquidMethodMissing
diff --git a/docs/source/zh-cn/tutorials/security-model.md b/docs/source/zh-cn/tutorials/security-model.md
index ce3cdd17c..a859370e8 100644
--- a/docs/source/zh-cn/tutorials/security-model.md
+++ b/docs/source/zh-cn/tutorials/security-model.md
@@ -2,7 +2,7 @@
 title: 安全模型
 ---
 
-LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`memoryLimit`）来降低风险。本文按统一结构说明每个限制的作用范围，以及你在生产环境应采用的安全边界。
+LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`memoryLimit`）来降低风险。本文概述这些限制、[`ownPropertyOnly`][ownPropertyOnly]、自定义 [`Drop`][drop] 的注意事项，以及生产环境应采用的安全边界。
 
 ## 安全边界
 
@@ -60,6 +60,14 @@ LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`m
 
 由于 [JavaScript 使用 GC 来管理内存](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management)，`memoryLimit` 可能无法反映实际的内存占用。
 
+## `ownPropertyOnly` 与作用域数据
+
+将 [`ownPropertyOnly`][ownPropertyOnly] 设为 `true` 时，普通作用域对象只暴露**自有**属性（不包含继承链与 `Object.prototype` 上的键）。默认 `false` 与常规 JavaScript 属性访问一致。对不可信或可能被污染的对象应使用 `true`；若缺少路径需报错，可配合 [`strictVariables`][strictVariables]。单次渲染可通过 [`RenderOptions`][renderOwnPropertyOnly] 覆盖。该选项只约束作用域数据的读取，不是过滤器、标签或宿主代码的沙箱。
+
+## 自定义 `Drop` 类
+
+[`Drop`][drop] 与普通对象处理不同：即使开启 [`ownPropertyOnly`][ownPropertyOnly]，LiquidJS 仍可能沿原型链读取属性，并在未解析时调用 [`liquidMethodMissing`][liquidMethodMissing]。**你**对 Drop 暴露的能力负责：收窄 API，勿向 Drop 传入不安全数据，除非该类明确为模板访问而设计。仅靠 `ownPropertyOnly` 无法硬化自定义 Drop，应像审计其他特权代码一样审查其实现。
+
 ## 在线服务建议
 
 如果你运行在线服务，建议尽量避免渲染完全由用户定义的模板。
@@ -74,3 +82,8 @@ LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`m
 [parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
 [renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
 [memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
+[ownPropertyOnly]: /api/interfaces/LiquidOptions.html#ownPropertyOnly
+[renderOwnPropertyOnly]: /api/interfaces/RenderOptions.html#ownPropertyOnly
+[strictVariables]: /api/interfaces/LiquidOptions.html#strictVariables
+[drop]: /api/classes/Drop.html
+[liquidMethodMissing]: /api/classes/Drop.html#liquidMethodMissing
diff --git a/src/liquid.ts b/src/liquid.ts
index 54714bb8c..57ff27361 100644
--- a/src/liquid.ts
+++ b/src/liquid.ts
@@ -15,8 +15,8 @@ export class Liquid {
    * @deprecated will be removed. In tags use `this.parser` instead
    */
   public readonly parser: Parser
-  public readonly filters: Record<string, FilterImplOptions> = {}
-  public readonly tags: Record<string, TagClass> = {}
+  public readonly filters: Record<string, FilterImplOptions> = Object.create(null)
+  public readonly tags: Record<string, TagClass> = Object.create(null)
 
   public constructor (opts: LiquidOptions = {}) {
     this.options = normalize(opts)
diff --git a/test/integration/liquid/register-filters.spec.ts b/test/integration/liquid/register-filters.spec.ts
index 54a24751c..a0c6bcd64 100644
--- a/test/integration/liquid/register-filters.spec.ts
+++ b/test/integration/liquid/register-filters.spec.ts
@@ -60,4 +60,10 @@ describe('liquid#registerFilter()', function () {
       return expect(html).toBe(dst)
     })
   })
+
+  it('should not treat Object.prototype names as registered filters', async () => {
+    expect(Object.getPrototypeOf(liquid.filters)).toBeNull()
+    await expect(liquid.parseAndRender('{{ x | constructor }}', { x: 42 })).resolves.toBe('42')
+    await expect(new Liquid({ strictFilters: true }).parseAndRender('{{ 1 | constructor }}')).rejects.toThrow('undefined filter')
+  })
 })
diff --git a/test/integration/liquid/register-tags.spec.ts b/test/integration/liquid/register-tags.spec.ts
index f0c85facf..76d6cdf4e 100644
--- a/test/integration/liquid/register-tags.spec.ts
+++ b/test/integration/liquid/register-tags.spec.ts
@@ -38,4 +38,10 @@ describe('liquid#registerTag()', function () {
     })
     return expect(html).toBe('ABC')
   })
+
+  it('should not treat Object.prototype names as registered tags', () => {
+    const l = new Liquid()
+    expect(Object.getPrototypeOf(l.tags)).toBeNull()
+    expect(() => l.parse('{% constructor %}')).toThrow('tag "constructor" not found')
+  })
 })

From c20c0af02d33e8d2ca6b08925eadca8755257c39 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Thu, 14 May 2026 14:23:44 +0000
Subject: [PATCH 46/64] chore(release): 10.26.0 [skip ci]

# [10.26.0](https://github.com/harttle/liquidjs/compare/v10.25.7...v10.26.0) (2026-05-14)

### Bug Fixes

* **date:** cap strftime widths and account padding in memoryLimit ([#895](https://github.com/harttle/liquidjs/issues/895)) ([3129d46](https://github.com/harttle/liquidjs/commit/3129d46dc95efa357b00e5a57ee1af80a13d72ed))
* enforce renderLimit for empty renderTemplates calls ([#894](https://github.com/harttle/liquidjs/issues/894)) ([5b9c346](https://github.com/harttle/liquidjs/commit/5b9c3469085e01c79e2d0af28e2a13f730e1793d))
* propagate ownPropertyOnly into Context.spawn() for {% render %} ([#893](https://github.com/harttle/liquidjs/issues/893)) ([dbbf628](https://github.com/harttle/liquidjs/commit/dbbf6288030591bf6da28d8c1cce5a17bca97bb6))
* **security:** block Object.prototype filter/tag lookups (RCE) ([#897](https://github.com/harttle/liquidjs/issues/897)) ([457fae0](https://github.com/harttle/liquidjs/commit/457fae0736c3ec862539b9dbf7f477e6c08fb6c6))
* strip html newline tags ([#892](https://github.com/harttle/liquidjs/issues/892)) ([26ea285](https://github.com/harttle/liquidjs/commit/26ea2856c7a90aec892b98d94a9b7a3e18539045))
* **strip_html:** rewrite as linear single-pass scan to avoid ReDoS ([#896](https://github.com/harttle/liquidjs/issues/896)) ([3616a74](https://github.com/harttle/liquidjs/commit/3616a744b9abeb425c217b340a2397d46176afb8))

### Features

* add sha256 and hmac_sha256 filters for cryptographic operations ([#889](https://github.com/harttle/liquidjs/issues/889)) ([1c816d4](https://github.com/harttle/liquidjs/commit/1c816d4fc3bcd2cba011f7a84f56a4251fca0622))
---
 CHANGELOG.md      | 17 +++++++++++++++++
 package-lock.json |  4 ++--
 package.json      |  2 +-
 3 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 847bba40f..3ff0928b9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,20 @@
+# [10.26.0](https://github.com/harttle/liquidjs/compare/v10.25.7...v10.26.0) (2026-05-14)
+
+
+### Bug Fixes
+
+* **date:** cap strftime widths and account padding in memoryLimit ([#895](https://github.com/harttle/liquidjs/issues/895)) ([3129d46](https://github.com/harttle/liquidjs/commit/3129d46dc95efa357b00e5a57ee1af80a13d72ed))
+* enforce renderLimit for empty renderTemplates calls ([#894](https://github.com/harttle/liquidjs/issues/894)) ([5b9c346](https://github.com/harttle/liquidjs/commit/5b9c3469085e01c79e2d0af28e2a13f730e1793d))
+* propagate ownPropertyOnly into Context.spawn() for {% render %} ([#893](https://github.com/harttle/liquidjs/issues/893)) ([dbbf628](https://github.com/harttle/liquidjs/commit/dbbf6288030591bf6da28d8c1cce5a17bca97bb6))
+* **security:** block Object.prototype filter/tag lookups (RCE) ([#897](https://github.com/harttle/liquidjs/issues/897)) ([457fae0](https://github.com/harttle/liquidjs/commit/457fae0736c3ec862539b9dbf7f477e6c08fb6c6))
+* strip html newline tags ([#892](https://github.com/harttle/liquidjs/issues/892)) ([26ea285](https://github.com/harttle/liquidjs/commit/26ea2856c7a90aec892b98d94a9b7a3e18539045))
+* **strip_html:** rewrite as linear single-pass scan to avoid ReDoS ([#896](https://github.com/harttle/liquidjs/issues/896)) ([3616a74](https://github.com/harttle/liquidjs/commit/3616a744b9abeb425c217b340a2397d46176afb8))
+
+
+### Features
+
+* add sha256 and hmac_sha256 filters for cryptographic operations ([#889](https://github.com/harttle/liquidjs/issues/889)) ([1c816d4](https://github.com/harttle/liquidjs/commit/1c816d4fc3bcd2cba011f7a84f56a4251fca0622))
+
 ## [10.25.7](https://github.com/harttle/liquidjs/compare/v10.25.6...v10.25.7) (2026-04-23)
 
 
diff --git a/package-lock.json b/package-lock.json
index a82f3a764..6eb01756b 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.25.7",
+  "version": "10.26.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.25.7",
+      "version": "10.26.0",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index bb60bc9d0..eeef62368 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.25.7",
+  "version": "10.26.0",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 47d3f1b1cf33be91fe587821f288d1c9d8e1ace7 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sat, 16 May 2026 02:20:03 +0800
Subject: [PATCH 47/64] feat(context): null-prototype scope frames via
 createScope (#899)

- Add createScope() building Object.create(null) with optional own props

- Initialize context stack bottom with createScope() for assign/capture

- Push null-proto scopes from for, tablerow, block, layout, include (incl. Jekyll)

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/context/context.ts | 4 ++--
 src/context/scope.ts   | 8 +++++++-
 src/tags/block.ts      | 4 ++--
 src/tags/for.ts        | 5 +++--
 src/tags/include.ts    | 6 +++---
 src/tags/layout.ts     | 4 ++--
 src/tags/tablerow.ts   | 3 ++-
 7 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/src/context/context.ts b/src/context/context.ts
index 205a57622..083a17cfe 100644
--- a/src/context/context.ts
+++ b/src/context/context.ts
@@ -2,7 +2,7 @@ import { getPerformance } from '../util/performance'
 import { Drop } from '../drop/drop'
 import { __assign } from 'tslib'
 import { NormalizedFullOptions, defaultOptions, RenderOptions } from '../liquid-options'
-import { Scope } from './scope'
+import { createScope, Scope } from './scope'
 import { hasOwnProperty, isArray, isNil, isUndefined, isString, isFunction, toLiquid, InternalUndefinedVariableError, toValueSync, isObject, Limiter, toValue } from '../util'
 
 type PropertyKey = string | number;
@@ -12,7 +12,7 @@ export class Context {
    * insert a Context-level empty scope,
    * for tags like `{% capture %}` `{% assign %}` to operate
    */
-  private scopes: Scope[] = [{}]
+  private scopes: Scope[] = [createScope()]
   private registers = {}
   /**
    * user passed in scope
diff --git a/src/context/scope.ts b/src/context/scope.ts
index 9fcc06dae..2cd261588 100644
--- a/src/context/scope.ts
+++ b/src/context/scope.ts
@@ -1,7 +1,13 @@
 import { Drop } from '../drop/drop'
 
-interface ScopeObject extends Record<string | number | symbol, any> {
+export interface ScopeObject extends Record<string | number | symbol, any> {
   toLiquid?: () => any;
 }
 
 export type Scope = ScopeObject | Drop
+
+export function createScope (from?: ScopeObject): ScopeObject {
+  const scope = Object.create(null)
+  if (from) Object.assign(scope, from)
+  return scope
+}
diff --git a/src/tags/block.ts b/src/tags/block.ts
index 947f0b3e5..56dca80af 100644
--- a/src/tags/block.ts
+++ b/src/tags/block.ts
@@ -1,4 +1,4 @@
-import { BlockMode } from '../context'
+import { BlockMode, createScope } from '../context'
 import { isTagToken } from '../util'
 import { BlockDrop } from '../drop'
 import { Liquid, TagToken, TopLevelToken, Template, Context, Emitter, Tag } from '..'
@@ -38,7 +38,7 @@ export default class extends Tag {
       if (stack.includes(self)) throw new Error('block tag cannot be nested')
 
       stack.push(self)
-      ctx.push({ block: superBlock })
+      ctx.push(createScope({ block: superBlock }))
       yield liquid.renderer.renderTemplates(templates, ctx, emitter)
       ctx.pop()
       stack.pop()
diff --git a/src/tags/for.ts b/src/tags/for.ts
index 0d29dee78..fec0b0603 100644
--- a/src/tags/for.ts
+++ b/src/tags/for.ts
@@ -1,5 +1,6 @@
 import { Hash, ValueToken, Liquid, Tag, evalToken, Emitter, TagToken, TopLevelToken, Context, Template, ParseStream } from '..'
 import { assertEmpty, isValueToken, toEnumerable } from '../util'
+import { createScope } from '../context/scope'
 import { ForloopDrop } from '../drop/forloop-drop'
 import { Parser } from '../parser'
 import { Arguments } from '../template'
@@ -50,7 +51,7 @@ export default class extends Tag {
     }
 
     const continueKey = 'continue-' + this.variable + '-' + this.collection.getText()
-    ctx.push({ continue: ctx.getRegister(continueKey, {}) })
+    ctx.push(createScope({ continue: ctx.getRegister(continueKey, {}) }))
     const hash = yield this.hash.render(ctx)
     ctx.pop()
 
@@ -65,7 +66,7 @@ export default class extends Tag {
     }, collection)
 
     ctx.setRegister(continueKey, (hash['offset'] || 0) + collection.length)
-    const scope = { forloop: new ForloopDrop(collection.length, this.collection.getText(), this.variable) }
+    const scope = createScope({ forloop: new ForloopDrop(collection.length, this.collection.getText(), this.variable) })
     ctx.push(scope)
     for (const item of collection) {
       scope[this.variable] = item
diff --git a/src/tags/include.ts b/src/tags/include.ts
index 3ad785b90..0db1ee749 100644
--- a/src/tags/include.ts
+++ b/src/tags/include.ts
@@ -1,5 +1,5 @@
 import { Template, ValueToken, TopLevelToken, Liquid, Tag, assert, evalToken, Hash, Emitter, TagToken, Context } from '..'
-import { BlockMode, Scope } from '../context'
+import { BlockMode, createScope, Scope } from '../context'
 import { Parser } from '../parser'
 import { Argument, Arguments, PartialScope } from '../template'
 import { isString, isValueToken } from '../util'
@@ -34,10 +34,10 @@ export default class extends Tag {
     const saved = ctx.saveRegister('blocks', 'blockMode')
     ctx.setRegister('blocks', {})
     ctx.setRegister('blockMode', BlockMode.OUTPUT)
-    const scope = (yield hash.render(ctx)) as Scope
+    const scope = createScope((yield hash.render(ctx)) as Scope)
     if (withVar) scope[filepath] = yield evalToken(withVar, ctx)
     const templates = (yield liquid._parsePartialFile(filepath, ctx.sync, this['currentFile'])) as Template[]
-    ctx.push(ctx.opts.jekyllInclude ? { include: scope } : scope)
+    ctx.push(ctx.opts.jekyllInclude ? createScope({ include: scope }) : scope)
     yield renderer.renderTemplates(templates, ctx, emitter)
     ctx.pop()
     ctx.restoreRegister(saved)
diff --git a/src/tags/layout.ts b/src/tags/layout.ts
index cf1e7270f..ab2b3b539 100644
--- a/src/tags/layout.ts
+++ b/src/tags/layout.ts
@@ -1,5 +1,5 @@
 import { Scope, Template, Liquid, Tag, assert, Emitter, Hash, TagToken, TopLevelToken, Context } from '..'
-import { BlockMode } from '../context'
+import { BlockMode, createScope } from '../context'
 import { parseFilePath, renderFilePath, ParsedFileName } from './render'
 import { BlankDrop } from '../drop'
 import { Parser } from '../parser'
@@ -39,7 +39,7 @@ export default class extends Tag {
     ctx.setRegister('blockMode', BlockMode.OUTPUT)
 
     // render the layout file use stored blocks
-    ctx.push((yield args.render(ctx)) as Scope)
+    ctx.push(createScope((yield args.render(ctx)) as Scope))
     yield renderer.renderTemplates(templates, ctx, emitter)
     ctx.pop()
   }
diff --git a/src/tags/tablerow.ts b/src/tags/tablerow.ts
index 91f840445..1676fe46d 100644
--- a/src/tags/tablerow.ts
+++ b/src/tags/tablerow.ts
@@ -1,4 +1,5 @@
 import { isValueToken, toEnumerable } from '../util'
+import { createScope } from '../context/scope'
 import { ValueToken, Liquid, Tag, evalToken, Emitter, Hash, TagToken, TopLevelToken, Context, Template, ParseStream } from '..'
 import { TablerowloopDrop } from '../drop/tablerowloop-drop'
 import { Parser } from '../parser'
@@ -48,7 +49,7 @@ export default class extends Tag {
 
     const r = this.liquid.renderer
     const tablerowloop = new TablerowloopDrop(collection.length, cols, this.collection.getText(), this.variable)
-    const scope = { tablerowloop }
+    const scope = createScope({ tablerowloop })
     ctx.push(scope)
 
     for (let idx = 0; idx < collection.length; idx++, tablerowloop.next()) {

From a8fd734b5ec4e0a6ffd1501a5961edc1e241be17 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Fri, 15 May 2026 18:21:41 +0000
Subject: [PATCH 48/64] chore(release): 10.27.0 [skip ci]

# [10.27.0](https://github.com/harttle/liquidjs/compare/v10.26.0...v10.27.0) (2026-05-15)

### Features

* **context:** null-prototype scope frames via createScope ([#899](https://github.com/harttle/liquidjs/issues/899)) ([47d3f1b](https://github.com/harttle/liquidjs/commit/47d3f1b1cf33be91fe587821f288d1c9d8e1ace7))
---
 CHANGELOG.md      | 7 +++++++
 package-lock.json | 4 ++--
 package.json      | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3ff0928b9..6c3cbb8ff 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,10 @@
+# [10.27.0](https://github.com/harttle/liquidjs/compare/v10.26.0...v10.27.0) (2026-05-15)
+
+
+### Features
+
+* **context:** null-prototype scope frames via createScope ([#899](https://github.com/harttle/liquidjs/issues/899)) ([47d3f1b](https://github.com/harttle/liquidjs/commit/47d3f1b1cf33be91fe587821f288d1c9d8e1ace7))
+
 # [10.26.0](https://github.com/harttle/liquidjs/compare/v10.25.7...v10.26.0) (2026-05-14)
 
 
diff --git a/package-lock.json b/package-lock.json
index 6eb01756b..ab2b103bb 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.26.0",
+  "version": "10.27.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.26.0",
+      "version": "10.27.0",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index eeef62368..4e2e8b696 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.26.0",
+  "version": "10.27.0",
   "sideEffects": false,
   "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
   "main": "dist/liquid.node.js",

From 705e5d1b6e92d87e67af98224e723cc419822420 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sat, 6 Jun 2026 14:04:21 +0800
Subject: [PATCH 49/64] docs: add consent banner and GA (#903)

---
 docs/themes/navy/layout/partial/after_footer.swig | 10 ++++++++++
 docs/themes/navy/layout/partial/head.swig         |  7 +++++++
 2 files changed, 17 insertions(+)

diff --git a/docs/themes/navy/layout/partial/after_footer.swig b/docs/themes/navy/layout/partial/after_footer.swig
index 68e981045..8c36be6fb 100644
--- a/docs/themes/navy/layout/partial/after_footer.swig
+++ b/docs/themes/navy/layout/partial/after_footer.swig
@@ -15,4 +15,14 @@ indexName: 'liquidjs',
 inputSelector: '#search-input',
 debug: false
 });
+</script>
+
+<!-- Google tag (gtag.js) -->
+<script async src="https://www.googletagmanager.com/gtag/js?id=G-GM713991QQ"></script>
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('js', new Date());
+
+  gtag('config', 'G-GM713991QQ');
 </script>
\ No newline at end of file
diff --git a/docs/themes/navy/layout/partial/head.swig b/docs/themes/navy/layout/partial/head.swig
index 106eafb8a..2f245b2a5 100644
--- a/docs/themes/navy/layout/partial/head.swig
+++ b/docs/themes/navy/layout/partial/head.swig
@@ -32,4 +32,11 @@
   <meta name="msapplication-TileImage" content="{{ url_for('icon/mstile-144x144.png') }}">
   {{ css('css/navy') }}
   {{ feed_tag('atom.xml') }}
+  <script src="https://cdn.cookiehub.eu/c2/e8e44c93.js"></script>
+  <script type="text/javascript">
+  document.addEventListener("DOMContentLoaded", function(event) {
+    var cpm = {};
+    window.cookiehub.load(cpm);
+  });
+  </script>
 </head>

From 499b221f33a55835295d10f26174230da69a8490 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 7 Jun 2026 01:37:51 +0800
Subject: [PATCH 50/64] docs: remove translations & update homepage (#904)

* docs: add GitHub buttons and improve option docs

* chore: replace husky with prepush check

* docs: revamp homepage and switch to custom GitHub buttons

- Make the docs English-only by removing all zh-cn content, the language switcher UI, and related JS/config

- Rework homepage feature cards (Safe & Typed, Pure JavaScript, Shopify & Jekyll, Streaming) and refresh section colors/layout

- Replace buttons.github.io with custom Star/Sponsor buttons featuring a live star count and dark-mode support

- Drop the buttons.js script and tidy banner, header, footer, and share partials

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: restore tsconfig settings and changelog build

Re-add suppressImplicitAnyIndexErrors and downlevelIteration removed in
a75033e2c, which broke the rollup TypeScript build on CI. Drop zh-cn
changelog output now that translations were removed.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: resolve TS errors without deprecated tsconfig options

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 bin/build-changelog.js                        |   2 -
 docs/_config.yml                              |   8 +-
 docs/source/_data/languages.yml               |   2 -
 docs/source/_data/news.yml                    |  24 --
 docs/source/index.pug                         |  16 +-
 docs/source/zh-cn/filters/abs.md              |  39 ---
 docs/source/zh-cn/filters/append.md           |  31 --
 .../zh-cn/filters/array_to_sentence_string.md |  27 --
 docs/source/zh-cn/filters/at_least.md         |  27 --
 docs/source/zh-cn/filters/at_most.md          |  27 --
 docs/source/zh-cn/filters/capitalize.md       |  29 --
 docs/source/zh-cn/filters/ceil.md             |  49 ---
 docs/source/zh-cn/filters/cgi_escape.md       |  17 -
 docs/source/zh-cn/filters/compact.md          |  49 ---
 docs/source/zh-cn/filters/concat.md           |  55 ----
 docs/source/zh-cn/filters/date.md             |  86 ------
 .../zh-cn/filters/date_to_long_string.md      |  31 --
 docs/source/zh-cn/filters/date_to_rfc822.md   |  20 --
 docs/source/zh-cn/filters/date_to_string.md   |  30 --
 .../source/zh-cn/filters/date_to_xmlschema.md |  20 --
 docs/source/zh-cn/filters/default.md          |  64 ----
 docs/source/zh-cn/filters/divided_by.md       |  48 ---
 docs/source/zh-cn/filters/downcase.md         |  27 --
 docs/source/zh-cn/filters/escape.md           |  27 --
 docs/source/zh-cn/filters/escape_once.md      |  27 --
 docs/source/zh-cn/filters/find.md             |  25 --
 docs/source/zh-cn/filters/find_exp.md         |  25 --
 docs/source/zh-cn/filters/first.md            |  37 ---
 docs/source/zh-cn/filters/floor.md            |  49 ---
 docs/source/zh-cn/filters/group_by.md         |  48 ---
 docs/source/zh-cn/filters/group_by_exp.md     |  48 ---
 docs/source/zh-cn/filters/inspect.md          |  42 ---
 docs/source/zh-cn/filters/join.md             |  19 --
 docs/source/zh-cn/filters/json.md             |  39 ---
 docs/source/zh-cn/filters/jsonify.md          |   9 -
 docs/source/zh-cn/filters/last.md             |  37 ---
 docs/source/zh-cn/filters/lstrip.md           |  17 -
 docs/source/zh-cn/filters/map.md              |  27 --
 docs/source/zh-cn/filters/minus.md            |  37 ---
 docs/source/zh-cn/filters/modulo.md           |  37 ---
 docs/source/zh-cn/filters/newline_to_br.md    |  23 --
 .../zh-cn/filters/normalize_whitespace.md     |  17 -
 docs/source/zh-cn/filters/number_of_words.md  |  49 ---
 docs/source/zh-cn/filters/overview.md         |  19 --
 docs/source/zh-cn/filters/plus.md             |  37 ---
 docs/source/zh-cn/filters/pop.md              |  24 --
 docs/source/zh-cn/filters/prepend.md          |  31 --
 docs/source/zh-cn/filters/push.md             |  25 --
 docs/source/zh-cn/filters/raw.md              |  52 ----
 docs/source/zh-cn/filters/remove.md           |  17 -
 docs/source/zh-cn/filters/remove_first.md     |  17 -
 docs/source/zh-cn/filters/remove_last.md      |  17 -
 docs/source/zh-cn/filters/replace.md          |  17 -
 docs/source/zh-cn/filters/replace_first.md    |  17 -
 docs/source/zh-cn/filters/replace_last.md     |  17 -
 docs/source/zh-cn/filters/reverse.md          |  33 --
 docs/source/zh-cn/filters/round.md            |  37 ---
 docs/source/zh-cn/filters/rstrip.md           |  17 -
 docs/source/zh-cn/filters/shift.md            |  24 --
 docs/source/zh-cn/filters/size.md             |  39 ---
 docs/source/zh-cn/filters/slice.md            |  49 ---
 docs/source/zh-cn/filters/slugify.md          |  59 ----
 docs/source/zh-cn/filters/sort.md             |  30 --
 docs/source/zh-cn/filters/sort_natural.md     |  30 --
 docs/source/zh-cn/filters/split.md            |  31 --
 docs/source/zh-cn/filters/strip.md            |  17 -
 docs/source/zh-cn/filters/strip_html.md       |  17 -
 docs/source/zh-cn/filters/strip_newlines.md   |  23 --
 docs/source/zh-cn/filters/times.md            |  37 ---
 docs/source/zh-cn/filters/to_integer.md       |  17 -
 docs/source/zh-cn/filters/truncate.md         |  47 ---
 docs/source/zh-cn/filters/truncatewords.md    |  47 ---
 docs/source/zh-cn/filters/uniq.md             |  18 --
 docs/source/zh-cn/filters/unshift.md          |  25 --
 docs/source/zh-cn/filters/upcase.md           |  27 --
 docs/source/zh-cn/filters/uri_escape.md       |  19 --
 docs/source/zh-cn/filters/url_decode.md       |  17 -
 docs/source/zh-cn/filters/url_encode.md       |  27 --
 docs/source/zh-cn/filters/where.md            | 134 --------
 docs/source/zh-cn/filters/where_exp.md        |  37 ---
 docs/source/zh-cn/filters/xml_escape.md       |  17 -
 docs/source/zh-cn/index.pug                   |  29 --
 docs/source/zh-cn/manifest.json               |  58 ----
 docs/source/zh-cn/playground.pug              |   5 -
 docs/source/zh-cn/tags/assign.md              |  33 --
 docs/source/zh-cn/tags/capture.md             |  37 ---
 docs/source/zh-cn/tags/case.md                |  25 --
 docs/source/zh-cn/tags/comment.md             |  19 --
 docs/source/zh-cn/tags/cycle.md               |  50 ---
 docs/source/zh-cn/tags/decrement.md           |  27 --
 docs/source/zh-cn/tags/echo.md                |  20 --
 docs/source/zh-cn/tags/for.md                 | 245 ---------------
 docs/source/zh-cn/tags/if.md                  |  44 ---
 docs/source/zh-cn/tags/include.md             | 110 -------
 docs/source/zh-cn/tags/increment.md           |  45 ---
 docs/source/zh-cn/tags/inline_comment.md      |  50 ---
 docs/source/zh-cn/tags/layout.md              |  66 ----
 docs/source/zh-cn/tags/liquid.md              |  28 --
 docs/source/zh-cn/tags/overview.md            |  18 --
 docs/source/zh-cn/tags/raw.md                 |  20 --
 docs/source/zh-cn/tags/render.md              |  65 ----
 docs/source/zh-cn/tags/tablerow.md            | 130 --------
 docs/source/zh-cn/tags/unless.md              |  27 --
 .../tutorials/access-scope-in-filters.md      |  32 --
 docs/source/zh-cn/tutorials/caching.md        |  55 ----
 .../tutorials/contribution-guidelines.md      |  30 --
 docs/source/zh-cn/tutorials/differences.md    |  58 ----
 docs/source/zh-cn/tutorials/drops.md          | 201 ------------
 docs/source/zh-cn/tutorials/escaping.md       |  76 -----
 .../source/zh-cn/tutorials/intro-to-liquid.md |  60 ----
 docs/source/zh-cn/tutorials/migrate-to-9.md   |  29 --
 docs/source/zh-cn/tutorials/operators.md      |  68 ----
 docs/source/zh-cn/tutorials/options.md        | 159 ----------
 .../zh-cn/tutorials/parse-parameters.md       | 100 ------
 .../zh-cn/tutorials/partials-and-layouts.md   |  60 ----
 docs/source/zh-cn/tutorials/plugins.md        |  49 ---
 .../zh-cn/tutorials/register-filters-tags.md  |  97 ------
 docs/source/zh-cn/tutorials/render-file.md    | 113 -------
 .../zh-cn/tutorials/render-tag-content.md     | 137 --------
 docs/source/zh-cn/tutorials/security-model.md |  89 ------
 docs/source/zh-cn/tutorials/setup.md          |  70 -----
 .../source/zh-cn/tutorials/static-analysis.md | 292 ------------------
 docs/source/zh-cn/tutorials/sync-and-async.md | 112 -------
 .../zh-cn/tutorials/truthy-and-falsy.md       |  45 ---
 .../zh-cn/tutorials/use-in-expressjs.md       |  72 -----
 .../zh-cn/tutorials/whitespace-control.md     |  56 ----
 docs/themes/navy/languages/en.yml             |   2 +-
 docs/themes/navy/languages/zh-cn.yml          |  68 ----
 docs/themes/navy/layout/index.swig            |  48 +--
 docs/themes/navy/layout/partial/header.swig   |  20 +-
 .../navy/layout/partial/mobile_nav.swig       |   8 -
 docs/themes/navy/layout/partial/share.swig    |   2 -
 .../navy/source/css/_partial/header.styl      |  76 ++++-
 .../navy/source/css/_partial/index.styl       | 116 +++----
 .../themes/navy/source/css/_partial/page.styl |   5 +-
 docs/themes/navy/source/css/_variables.styl   |   2 -
 docs/themes/navy/source/js/main.js            |  41 +--
 package-lock.json                             | 103 ------
 package.json                                  |   7 -
 rollup.config.mjs                             |   3 +-
 src/context/context.ts                        |   2 +-
 src/drop/drop.ts                              |   1 +
 src/filters/html.ts                           |   4 +-
 src/liquid-options.ts                         |   2 +-
 src/parser/tokenizer.ts                       |  10 +-
 src/render/string.ts                          |   2 +-
 src/tags/for.ts                               |   2 +-
 src/tags/include.ts                           |  26 +-
 src/tags/layout.ts                            |   7 +-
 src/tags/render.ts                            |  52 ++--
 src/template/hash.ts                          |   2 +-
 src/tokens/literal-token.ts                   |   6 +-
 src/tokens/operator-token.ts                  |   9 +-
 src/util/async.ts                             |   8 +-
 src/util/error.ts                             |   2 +-
 src/util/operator-trie.ts                     |  18 +-
 src/util/strftime.ts                          |  16 +-
 test/integration/liquid/liquid.spec.ts        |   3 +-
 tsconfig.json                                 |   4 +-
 159 files changed, 259 insertions(+), 6161 deletions(-)
 delete mode 100644 docs/source/_data/news.yml
 delete mode 100644 docs/source/zh-cn/filters/abs.md
 delete mode 100644 docs/source/zh-cn/filters/append.md
 delete mode 100644 docs/source/zh-cn/filters/array_to_sentence_string.md
 delete mode 100644 docs/source/zh-cn/filters/at_least.md
 delete mode 100644 docs/source/zh-cn/filters/at_most.md
 delete mode 100644 docs/source/zh-cn/filters/capitalize.md
 delete mode 100644 docs/source/zh-cn/filters/ceil.md
 delete mode 100644 docs/source/zh-cn/filters/cgi_escape.md
 delete mode 100644 docs/source/zh-cn/filters/compact.md
 delete mode 100644 docs/source/zh-cn/filters/concat.md
 delete mode 100644 docs/source/zh-cn/filters/date.md
 delete mode 100644 docs/source/zh-cn/filters/date_to_long_string.md
 delete mode 100644 docs/source/zh-cn/filters/date_to_rfc822.md
 delete mode 100644 docs/source/zh-cn/filters/date_to_string.md
 delete mode 100644 docs/source/zh-cn/filters/date_to_xmlschema.md
 delete mode 100644 docs/source/zh-cn/filters/default.md
 delete mode 100644 docs/source/zh-cn/filters/divided_by.md
 delete mode 100644 docs/source/zh-cn/filters/downcase.md
 delete mode 100644 docs/source/zh-cn/filters/escape.md
 delete mode 100644 docs/source/zh-cn/filters/escape_once.md
 delete mode 100644 docs/source/zh-cn/filters/find.md
 delete mode 100644 docs/source/zh-cn/filters/find_exp.md
 delete mode 100644 docs/source/zh-cn/filters/first.md
 delete mode 100644 docs/source/zh-cn/filters/floor.md
 delete mode 100644 docs/source/zh-cn/filters/group_by.md
 delete mode 100644 docs/source/zh-cn/filters/group_by_exp.md
 delete mode 100644 docs/source/zh-cn/filters/inspect.md
 delete mode 100644 docs/source/zh-cn/filters/join.md
 delete mode 100644 docs/source/zh-cn/filters/json.md
 delete mode 100644 docs/source/zh-cn/filters/jsonify.md
 delete mode 100644 docs/source/zh-cn/filters/last.md
 delete mode 100644 docs/source/zh-cn/filters/lstrip.md
 delete mode 100644 docs/source/zh-cn/filters/map.md
 delete mode 100644 docs/source/zh-cn/filters/minus.md
 delete mode 100644 docs/source/zh-cn/filters/modulo.md
 delete mode 100644 docs/source/zh-cn/filters/newline_to_br.md
 delete mode 100644 docs/source/zh-cn/filters/normalize_whitespace.md
 delete mode 100644 docs/source/zh-cn/filters/number_of_words.md
 delete mode 100644 docs/source/zh-cn/filters/overview.md
 delete mode 100644 docs/source/zh-cn/filters/plus.md
 delete mode 100644 docs/source/zh-cn/filters/pop.md
 delete mode 100644 docs/source/zh-cn/filters/prepend.md
 delete mode 100644 docs/source/zh-cn/filters/push.md
 delete mode 100644 docs/source/zh-cn/filters/raw.md
 delete mode 100644 docs/source/zh-cn/filters/remove.md
 delete mode 100644 docs/source/zh-cn/filters/remove_first.md
 delete mode 100644 docs/source/zh-cn/filters/remove_last.md
 delete mode 100644 docs/source/zh-cn/filters/replace.md
 delete mode 100644 docs/source/zh-cn/filters/replace_first.md
 delete mode 100644 docs/source/zh-cn/filters/replace_last.md
 delete mode 100644 docs/source/zh-cn/filters/reverse.md
 delete mode 100644 docs/source/zh-cn/filters/round.md
 delete mode 100644 docs/source/zh-cn/filters/rstrip.md
 delete mode 100644 docs/source/zh-cn/filters/shift.md
 delete mode 100644 docs/source/zh-cn/filters/size.md
 delete mode 100644 docs/source/zh-cn/filters/slice.md
 delete mode 100644 docs/source/zh-cn/filters/slugify.md
 delete mode 100644 docs/source/zh-cn/filters/sort.md
 delete mode 100644 docs/source/zh-cn/filters/sort_natural.md
 delete mode 100644 docs/source/zh-cn/filters/split.md
 delete mode 100644 docs/source/zh-cn/filters/strip.md
 delete mode 100644 docs/source/zh-cn/filters/strip_html.md
 delete mode 100644 docs/source/zh-cn/filters/strip_newlines.md
 delete mode 100644 docs/source/zh-cn/filters/times.md
 delete mode 100644 docs/source/zh-cn/filters/to_integer.md
 delete mode 100644 docs/source/zh-cn/filters/truncate.md
 delete mode 100644 docs/source/zh-cn/filters/truncatewords.md
 delete mode 100644 docs/source/zh-cn/filters/uniq.md
 delete mode 100644 docs/source/zh-cn/filters/unshift.md
 delete mode 100644 docs/source/zh-cn/filters/upcase.md
 delete mode 100644 docs/source/zh-cn/filters/uri_escape.md
 delete mode 100644 docs/source/zh-cn/filters/url_decode.md
 delete mode 100644 docs/source/zh-cn/filters/url_encode.md
 delete mode 100644 docs/source/zh-cn/filters/where.md
 delete mode 100644 docs/source/zh-cn/filters/where_exp.md
 delete mode 100644 docs/source/zh-cn/filters/xml_escape.md
 delete mode 100644 docs/source/zh-cn/index.pug
 delete mode 100644 docs/source/zh-cn/manifest.json
 delete mode 100644 docs/source/zh-cn/playground.pug
 delete mode 100644 docs/source/zh-cn/tags/assign.md
 delete mode 100644 docs/source/zh-cn/tags/capture.md
 delete mode 100644 docs/source/zh-cn/tags/case.md
 delete mode 100644 docs/source/zh-cn/tags/comment.md
 delete mode 100644 docs/source/zh-cn/tags/cycle.md
 delete mode 100644 docs/source/zh-cn/tags/decrement.md
 delete mode 100644 docs/source/zh-cn/tags/echo.md
 delete mode 100644 docs/source/zh-cn/tags/for.md
 delete mode 100644 docs/source/zh-cn/tags/if.md
 delete mode 100644 docs/source/zh-cn/tags/include.md
 delete mode 100644 docs/source/zh-cn/tags/increment.md
 delete mode 100644 docs/source/zh-cn/tags/inline_comment.md
 delete mode 100644 docs/source/zh-cn/tags/layout.md
 delete mode 100644 docs/source/zh-cn/tags/liquid.md
 delete mode 100644 docs/source/zh-cn/tags/overview.md
 delete mode 100644 docs/source/zh-cn/tags/raw.md
 delete mode 100644 docs/source/zh-cn/tags/render.md
 delete mode 100644 docs/source/zh-cn/tags/tablerow.md
 delete mode 100644 docs/source/zh-cn/tags/unless.md
 delete mode 100644 docs/source/zh-cn/tutorials/access-scope-in-filters.md
 delete mode 100644 docs/source/zh-cn/tutorials/caching.md
 delete mode 100644 docs/source/zh-cn/tutorials/contribution-guidelines.md
 delete mode 100644 docs/source/zh-cn/tutorials/differences.md
 delete mode 100644 docs/source/zh-cn/tutorials/drops.md
 delete mode 100644 docs/source/zh-cn/tutorials/escaping.md
 delete mode 100644 docs/source/zh-cn/tutorials/intro-to-liquid.md
 delete mode 100644 docs/source/zh-cn/tutorials/migrate-to-9.md
 delete mode 100644 docs/source/zh-cn/tutorials/operators.md
 delete mode 100644 docs/source/zh-cn/tutorials/options.md
 delete mode 100644 docs/source/zh-cn/tutorials/parse-parameters.md
 delete mode 100644 docs/source/zh-cn/tutorials/partials-and-layouts.md
 delete mode 100644 docs/source/zh-cn/tutorials/plugins.md
 delete mode 100644 docs/source/zh-cn/tutorials/register-filters-tags.md
 delete mode 100644 docs/source/zh-cn/tutorials/render-file.md
 delete mode 100644 docs/source/zh-cn/tutorials/render-tag-content.md
 delete mode 100644 docs/source/zh-cn/tutorials/security-model.md
 delete mode 100644 docs/source/zh-cn/tutorials/setup.md
 delete mode 100644 docs/source/zh-cn/tutorials/static-analysis.md
 delete mode 100644 docs/source/zh-cn/tutorials/sync-and-async.md
 delete mode 100644 docs/source/zh-cn/tutorials/truthy-and-falsy.md
 delete mode 100644 docs/source/zh-cn/tutorials/use-in-expressjs.md
 delete mode 100644 docs/source/zh-cn/tutorials/whitespace-control.md
 delete mode 100644 docs/themes/navy/languages/zh-cn.yml

diff --git a/bin/build-changelog.js b/bin/build-changelog.js
index 5c6b6c0ac..cfdfed37a 100644
--- a/bin/build-changelog.js
+++ b/bin/build-changelog.js
@@ -18,7 +18,5 @@ content = content
   .replace(/\{\{/g, '{% raw %}{{{% endraw %}')
 
 const enFrontmatter = '---\ntitle: Changelog\nauto: true\n---\n\n'
-const zhFrontmatter = '---\ntitle: 更新日志\nauto: true\n---\n\n'
 
 fs.writeFileSync(path.join(root, 'docs/source/tutorials/changelog.md'), enFrontmatter + content)
-fs.writeFileSync(path.join(root, 'docs/source/zh-cn/tutorials/changelog.md'), zhFrontmatter + content)
diff --git a/docs/_config.yml b/docs/_config.yml
index d28a0fbed..b2055096c 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -1,10 +1,8 @@
 title: LiquidJS
-subtitle: "A simple, expressive and safe template engine."
-description: "LiquidJS is a simple, expressive and safe Shopify / GitHub Pages compatible template engine in pure JavaScript."
+subtitle: "A simple, expressive, and safe template engine for JavaScript."
+description: "LiquidJS is a simple, expressive, and safe template engine for JavaScript, compatible with Shopify and GitHub Pages."
 author: Harttle
-language:
-  - en
-  - zh-cn
+language: en
 timezone: UTC
 
 url: https://liquidjs.com
diff --git a/docs/source/_data/languages.yml b/docs/source/_data/languages.yml
index e4b3acd42..6cf5ad282 100644
--- a/docs/source/_data/languages.yml
+++ b/docs/source/_data/languages.yml
@@ -1,3 +1 @@
 en: English
-zh-cn:
-  name: 简体中文
diff --git a/docs/source/_data/news.yml b/docs/source/_data/news.yml
deleted file mode 100644
index 0e2236057..000000000
--- a/docs/source/_data/news.yml
+++ /dev/null
@@ -1,24 +0,0 @@
--
-  url: https://opencollective.com/liquidjs/#section-contribute
-  date: '2020-02-26'
-  title:
-    zh-cn: '赞助人：第一个 backer 通过 Open Collective 贡献于 LiquidJS。'
-    en: 'Backers: the first backer contributed to LiquidJS via Open Collective.'
--
-  url: https://github.com/harttle/liquidjs/pull/202
-  date: '2020-03-11'
-  title:
-    zh-cn: '内存优化：用更精细的手法重写了解析器，来避免临时字符串的生成，内存占用降低 57.7% 以上。'
-    en: 'Memory Optimization: a more elaborate parser reducing the memory footprint by 57.7%.'
--
-  url: https://github.com/harttle/liquidjs/pull/205
-  date: '2020-03-15'
-  title:
-    zh-cn: '性能提升：引入 AST 并重新设计 Token 类型系统，使渲染性能平均提升 100.3%。'
-    en: 'Performance Boost: a simple AST to improve render performance by 100.3%.'
--
-  url: https://github.com/harttle/liquidjs/milestone/3?closed=1
-  date: '2021-09-30'
-  title:
-    zh-cn: '流式渲染：4 倍渲染速度，并增加了对流式渲染的支持。'
-    en: 'Streamed Rendering: now render is 4x faster and support streamed rendering.'
diff --git a/docs/source/index.pug b/docs/source/index.pug
index 41ba55af0..64048edf7 100644
--- a/docs/source/index.pug
+++ b/docs/source/index.pug
@@ -7,23 +7,23 @@ ul#intro-feature-list
     .intro-feature
       .intro-feature-icon
         i.icon-shield
-      h3.intro-feature-title Safe Rendering
-      p.intro-feature-desc Liquid templates are highly readable and fault-tolerant thus suitable for designers and customers. Operators and expressions are parsed to AST and no #[code eval] or #[code new Function] are used. 
+      h3.intro-feature-title Safe &amp; Typed
+      p.intro-feature-desc Templates are readable and fault-tolerant, parsed to an AST with no #[code eval] or #[code new Function]. The whole repo is written in TypeScript strict mode, so types stay precise and docs accurate.
   li.intro-feature-wrap
     .intro-feature
       .intro-feature-icon
         i.icon-rocket
       h3.intro-feature-title Pure JavaScript
-      p.intro-feature-desc Written with pure JavaScript with no native bindings, available in both Node.js and browsers. All of the CMD, ESM and CJS bundles are available on CDN.
+      p.intro-feature-desc Written in pure JavaScript with no native bindings, running in both Node.js and the browser. The CMD, ESM and CJS bundles are all available on CDN.
   li.intro-feature-wrap
     .intro-feature
       .intro-feature-icon
         i.icon-shopify
-      h3.intro-feature-title Shopify Compatible
-      p.intro-feature-desc All filters and tags from Ruby #[a(href="https://github.com/shopify/liquid") shopify/liquid] are supported by LiquidJS. #[a(href="https://jekyllrb.com/") Jekyll sites], #[a(href="https://pages.github.com/") GitHub Pages] and #[a(href="https://themes.shopify.com/") Shopify templates] can be ported to Node.js without pain.
+      h3.intro-feature-title Shopify &amp; Jekyll
+      p.intro-feature-desc All filters and tags from Ruby #[a(href="https://github.com/shopify/liquid") shopify/liquid] are supported, so #[a(href="https://themes.shopify.com/") Shopify templates] work out of the box — as do #[a(href="https://jekyllrb.com/") Jekyll] sites and #[a(href="https://pages.github.com/") GitHub Pages].
   li.intro-feature-wrap
     .intro-feature
       .intro-feature-icon
-        i.icon-typescript
-      h3.intro-feature-title TypeScript Strict
-      p.intro-feature-desc The whole repo is re-written in TypeScript strict mode to ensure a smooth experience using this lib and the document is precise and always up to date.
\ No newline at end of file
+        i.icon-network
+      h3.intro-feature-title Streaming
+      p.intro-feature-desc Render directly to a Node.js stream with #[code renderToNodeStream], emitting output as it's produced — for a faster time to first byte and low memory usage on large pages.
\ No newline at end of file
diff --git a/docs/source/zh-cn/filters/abs.md b/docs/source/zh-cn/filters/abs.md
deleted file mode 100644
index 84483954a..000000000
--- a/docs/source/zh-cn/filters/abs.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: abs
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回数字的绝对值。
-
-输入
-```liquid
-{{ -17 | abs }}
-```
-
-输出
-```text
-17
-```
-
-输入
-```liquid
-{{ 4 | abs }}
-```
-
-输出
-```text
-4
-```
-
-对于只包含数字的字符串也好使：
-
-输入
-```liquid
-{{ "-19.86" | abs }}
-```
-
-输出
-```text
-19.86
-```
diff --git a/docs/source/zh-cn/filters/append.md b/docs/source/zh-cn/filters/append.md
deleted file mode 100644
index 7fa4cca10..000000000
--- a/docs/source/zh-cn/filters/append.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-title: append
----
-
-{% since %}v1.9.1{% endsince %}
-
-连接两个字符串并返回结果。
-
-输入
-```liquid
-{{ "/my/fancy/url" | append: ".html" }}
-```
-
-输出
-```text
-/my/fancy/url.html
-```
-
-也可以用于变量。
-
-输入
-```liquid
-{% assign filename = "/index.html" %}
-{{ "website.com" | append: filename }}
-```
-
-输出
-```text
-
-website.com/index.html
-```
diff --git a/docs/source/zh-cn/filters/array_to_sentence_string.md b/docs/source/zh-cn/filters/array_to_sentence_string.md
deleted file mode 100644
index 3e1d8b537..000000000
--- a/docs/source/zh-cn/filters/array_to_sentence_string.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: array_to_sentence_string
----
-
-{% since %}v10.13.0{% endsince %}
-
-把数组转化为句子，用于做标签列表。有一个可选的连接词参数。
-
-输入
-```liquid
-{{ "foo,bar,baz" | split: "," | array_to_sentence_string }}
-```
-
-输出
-```text
-foo, bar, and baz
-```
-
-输入
-```liquid
-{{ "foo,bar,baz" | split: "," | array_to_sentence_string: "or" }}
-```
-
-输出
-```text
-foo, bar, or baz
-```
diff --git a/docs/source/zh-cn/filters/at_least.md b/docs/source/zh-cn/filters/at_least.md
deleted file mode 100644
index 0a1f2e85e..000000000
--- a/docs/source/zh-cn/filters/at_least.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: at_least
----
-
-{% since %}v8.4.0{% endsince %}
-
-限制数字到某个最小值。
-
-输入
-```liquid
-{{ 4 | at_least: 5 }}
-```
-
-输出
-```text
-5
-```
-
-输入
-```liquid
-{{ 4 | at_least: 3 }}
-```
-
-输出
-```text
-4
-```
diff --git a/docs/source/zh-cn/filters/at_most.md b/docs/source/zh-cn/filters/at_most.md
deleted file mode 100644
index 7410c1d06..000000000
--- a/docs/source/zh-cn/filters/at_most.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: at_most
----
-
-{% since %}v8.4.0{% endsince %}
-
-限制数字到某个最大值。
-
-输入
-```liquid
-{{ 4 | at_most: 5 }}
-```
-
-输出
-```text
-4
-```
-
-输入
-```liquid
-{{ 4 | at_most: 3 }}
-```
-
-输出
-```text
-3
-```
diff --git a/docs/source/zh-cn/filters/capitalize.md b/docs/source/zh-cn/filters/capitalize.md
deleted file mode 100644
index 5e7562931..000000000
--- a/docs/source/zh-cn/filters/capitalize.md
+++ /dev/null
@@ -1,29 +0,0 @@
----
-title: capitalize
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串首字母改为大写。
-
-输入
-```liquid
-{{ "title" | capitalize }}
-```
-
-输出
-```text
-Title
-```
-
-`capitalize` 只会大写首字母，因此后续单词的不会受影响：
-
- Input
-```liquid
-{{ "my great title" | capitalize }}
-```
-
-输出
-```text
-My great title
-```
diff --git a/docs/source/zh-cn/filters/ceil.md b/docs/source/zh-cn/filters/ceil.md
deleted file mode 100644
index 5217227d0..000000000
--- a/docs/source/zh-cn/filters/ceil.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: ceil
----
-
-{% since %}v1.9.1{% endsince %}
-
-向上取整，取整前 LiquidJS 会首先把输入转换为数字。
-
-输入
-```liquid
-{{ 1.2 | ceil }}
-```
-
-输出
-```text
-2
-```
-
-输入
-```liquid
-{{ 2.0 | ceil }}
-```
-
-输出
-```text
-2
-```
-
-输入
-```liquid
-{{ 183.357 | ceil }}
-```
-
-输出
-```text
-184
-```
-
-下面的例子中输入是字符串：
-
-输入
-```liquid
-{{ "3.5" | ceil }}
-```
-
-输出
-```text
-4
-```
diff --git a/docs/source/zh-cn/filters/cgi_escape.md b/docs/source/zh-cn/filters/cgi_escape.md
deleted file mode 100644
index 159dd5bdb..000000000
--- a/docs/source/zh-cn/filters/cgi_escape.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: cgi_escape
----
-
-{% since %}v10.13.0{% endsince %}
-
-把字符串 CGI 转义，用于 URL。用对应的 `%XX` 替换特殊字符，空格会被转义为 `+` 号。
-
-输入
-```liquid
-{{ "foo, bar; baz?" | cgi_escape }}
-```
-
-输出
-```text
-foo%2C+bar%3B+baz%3F
-```
diff --git a/docs/source/zh-cn/filters/compact.md b/docs/source/zh-cn/filters/compact.md
deleted file mode 100644
index 6760b62a4..000000000
--- a/docs/source/zh-cn/filters/compact.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: compact
----
-
-{% since %}v9.22.0{% endsince %}
-
-从数组里移除任何 `null` 和 `undefined` 值。
-
-假设 `site.pages` 是网页列表，有些网页包含 `category` 属性用来标明类别。如果把它们 `map` 到数组里，那么对于没有 `category` 属性的元素就会是 `undefined`。
-
-输入
-```liquid
-{% assign site_categories = site.pages | map: "category" %}
-
-{% for category in site_categories %}
-- {{ category }}
-{% endfor %}
-```
-
-输出
-```text
-- business
-- celebrities
--
-- lifestyle
-- sports
--
-- technology
-```
-
-使用 `compact` 创建 `site_categories` 数组，可以移除所有 `null` 和 `undefined` 值。
-
-输入
-```liquid
-{% assign site_categories = site.pages | map: "category" | compact %}
-
-{% for category in site_categories %}
-- {{ category }}
-{% endfor %}
-```
-
-输出
-```text
-- business
-- celebrities
-- lifestyle
-- sports
-- technology
-```
diff --git a/docs/source/zh-cn/filters/concat.md b/docs/source/zh-cn/filters/concat.md
deleted file mode 100644
index 376375039..000000000
--- a/docs/source/zh-cn/filters/concat.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: concat
----
-
-{% since %}v2.0.0{% endsince %}
-
-连接多个数组，返回的数组包含所有传入数组的元素。
-
-输入
-```liquid
-{% assign fruits = "apples, oranges, peaches" | split: ", " %}
-{% assign vegetables = "carrots, turnips, potatoes" | split: ", " %}
-
-{% assign everything = fruits | concat: vegetables %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- apples
-- oranges
-- peaches
-- carrots
-- turnips
-- potatoes
-```
-
-可以链式地使用 `concat` 过滤器来连接多个数组：
-
-输入
-```liquid
-{% assign furniture = "chairs, tables, shelves" | split: ", " %}
-
-{% assign everything = fruits | concat: vegetables | concat: furniture %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- apples
-- oranges
-- peaches
-- carrots
-- turnips
-- potatoes
-- chairs
-- tables
-- shelves
-```
diff --git a/docs/source/zh-cn/filters/date.md b/docs/source/zh-cn/filters/date.md
deleted file mode 100644
index be922a665..000000000
--- a/docs/source/zh-cn/filters/date.md
+++ /dev/null
@@ -1,86 +0,0 @@
----
-title: date
----
-
-{% since %}v1.9.1{% endsince %}
-
-把时间戳转换为字符串。LiquidJS 尝试跟 Shopify/Liquid 保持一致，它用的是 Ruby 核心的 [Time#strftime(string)](http://www.ruby-doc.org/core/Time.html#method-i-strftime)。此外 LiquidJS 会先通过 [new Date()][newDate] 尝试把输入转换为 Date 对象。
-
-但 LiquidJS 支持的格式与 [Ruby 的 flag](https://ruby-doc.org/core/strftime_formatting_rdoc.html) 有些不同：
-  * `%Z`（自 v10.11.1 起支持）只有在传入了时区时才起作用（可以通过 `LiquidOption` 传入，也可以在创建日期时单独传入，见下文）。如果传入的时区是个数字，那么它的表现将会与 `%z` 相同。如果没有传入时区，将会返回 [运行时默认时区](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions#timezone)。
-  * LiquidJS 提供额外的 `%q` 用来处理序数：`{{ '2023/02/02' | date: '%d%q of %b'}}` => `02nd of Feb`
-* 日期字面量会通过 [new Date()][jsDate] 转化为 `Date` 对象，这意味着字面量默认使用运行时默认时区。
-* 格式字参数是可选的：
-    * 如果不传，默认为 `%A, %B %-e, %Y at %-l:%M %P %z`。
-    * 上述默认值可以通过 [`dateFormat`](/api/interfaces/LiquidOptions.html#dateFormat) 参数覆盖。
-
-输入
-```liquid
-{{ article.published_at | date: "%a, %b %d, %y" }}
-```
-
-输出
-```text
-Fri, Jul 17, 15
-```
-
-{% note info 时区 %}
-日期在输出时会转换为当地时区，设置 `timezoneOffset` LiquidJS 参数可以指定一个不同的时区。或者设置 `preserveTimezones` 为 `true` 来保持字面量时间戳的时区，数据中的日期对象不受此参数的影响。
-{% endnote %}
-
-你也可以在使用 `date` 时再设置时区：
-
-输入
-```liquid
-{{ "1990-12-31T23:00:00Z" | date: "%Y-%m-%dT%H:%M:%S", 360}} // 等价于设置 `options.timezoneOffset` to `360`.
-{{ "1990-12-31T23:00:00Z" | date: "%Y-%m-%dT%H:%M:%S", "Asia/Colombo" }}
-```
-
-输出
-```liquid
-1990-12-31T17:00:00
-1991-01-01T04:30:00
-```
-
-
-输入
-```liquid
-{{ article.published_at | date: "%Y" }}
-```
-
-输出
-```text
-2015
-```
-
-输入也可以是符合 JavaScript `Date` 格式的字符串：：
-
-输入
-```liquid
-{{ "March 14, 2016" | date: "%b %d, %y" }}
-```
-
-输出
-```text
-Mar 14, 16
-```
-
-{% note info 时间戳字符串 %}
-LiquidJS 使用 JavaScript [Date][newDate] 来解析输入字符串，意味着支持 [IETF-compliant RFC 2822 时间戳](https://datatracker.ietf.org/doc/html/rfc2822#page-14) 和 [特定版本的 ISO8601](https://www.ecma-international.org/ecma-262/11.0/#sec-date.parse)。
-{% endnote %}
-
-可以用特殊值 `"now"`（或`"today"`）来获取当前时间：
-
-输入
-```liquid
-This page was last updated at {{ "now" | date: "%Y-%m-%d %H:%M" }}.
-```
-
-输出
-```text
-This page was last updated at 2020-03-25 15:57.
-```
-
-{% note info 当前时间 %}注意得到的当前时间是模板渲染时的时间，如果你在用静态站点生成器或者模板有被缓存这一时间可能与用户看到的时间不同。{% endnote %}
-
-[newDate]: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date
diff --git a/docs/source/zh-cn/filters/date_to_long_string.md b/docs/source/zh-cn/filters/date_to_long_string.md
deleted file mode 100644
index 0cb54dc74..000000000
--- a/docs/source/zh-cn/filters/date_to_long_string.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-title: date_to_long_string
----
-{% since %}v10.13.0{% endsince %}
-
-把日期转换为长格式（只支持 US/UK 两种），与 Jekyll 的 `date_to_long_string` 过滤器一样。
-
-输入
-```liquid
-{{ site.time | date_to_long_string }}
-```
-
-输出
-```text
-07 November 2008
-```
-
-输入
-```liquid
-{{ site.time | date_to_long_string: "ordinal" }}
-```
-
-输出
-```text
-7th November 2008
-```
-
-
-注意 JavaScript `Date` 没有时区信息，详情请参考 [date][date] 过滤器。
-
-[date]: ./date.html
diff --git a/docs/source/zh-cn/filters/date_to_rfc822.md b/docs/source/zh-cn/filters/date_to_rfc822.md
deleted file mode 100644
index fd704397e..000000000
--- a/docs/source/zh-cn/filters/date_to_rfc822.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-title: date_to_rfc822
----
-{% since %}v10.13.0{% endsince %}
-
-把日期转换为 RFC-822 格式用于 RSS feed，与 Jekyll 的 `date_to_rfc822` 过滤器一样。
-
-输入
-```liquid
-{{ site.time | date_to_rfc822 }}
-```
-
-输入
-```text
-Mon, 07 Nov 2008 13:07:54 -0800
-```
-
-注意 JavaScript `Date` 没有时区信息，详情请参考 [date][date] 过滤器。
-
-[date]: ./date.html
diff --git a/docs/source/zh-cn/filters/date_to_string.md b/docs/source/zh-cn/filters/date_to_string.md
deleted file mode 100644
index 569454bf4..000000000
--- a/docs/source/zh-cn/filters/date_to_string.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-title: date_to_string
----
-{% since %}v10.13.0{% endsince %}
-
-把日期转换为短格式（只支持 US/UK 两种），与 Jekyll 的 `date_to_string` 过滤器一样。
-
-输入
-```liquid
-{{ site.time | date_to_string }}
-```
-
-输出
-```text
-07 Nov 2008
-```
-
-输入
-```liquid
-{{ site.time | date_to_string: "ordinal", "US" }}
-```
-
-输出
-```text
-Nov 7th, 2008
-```
-
-注意 JavaScript `Date` 没有时区信息，详情请参考 [date][date] 过滤器。
-
-[date]: ./date.html
diff --git a/docs/source/zh-cn/filters/date_to_xmlschema.md b/docs/source/zh-cn/filters/date_to_xmlschema.md
deleted file mode 100644
index e1051cdc3..000000000
--- a/docs/source/zh-cn/filters/date_to_xmlschema.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-title: date_to_xmlschema
----
-{% since %}v10.13.0{% endsince %}
-
-把日期转换为 XML Schema (ISO 8601) 格式，与 Jekyll 的 `date_to_xmlschema` 过滤器一样。
-
-输入
-```liquid
-{{ site.time | date_to_xmlschema }}
-```
-
-输出
-```text
-2008-11-07T13:07:54-08:00
-```
-
-注意 JavaScript `Date` 没有时区信息，详情请参考 [date][date] 过滤器。
-
-[date]: ./date.html
diff --git a/docs/source/zh-cn/filters/default.md b/docs/source/zh-cn/filters/default.md
deleted file mode 100644
index ad16cf45b..000000000
--- a/docs/source/zh-cn/filters/default.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-title: default
----
-
-{% since %}v1.9.1{% endsince %}
-
-在值不存在时给一个默认值，如果左侧是 [falsy][falsy] 或空（`string` 或 `Array`）就会使用这个默认值。下面的例子中 `product_price` 没有定义，因此使用了默认值。
-
-输入
-```liquid
-{{ product_price | default: 2.99 }}
-```
-
-输出
-```text
-2.99
-```
-
-下面的例子中定义了 `product_price` 所以没有使用默认值。
-
-输入
-```liquid
-{% assign product_price = 4.99 %}
-{{ product_price | default: 2.99 }}
-```
-
-输出
-```text
-4.99
-```
-
-下面例子中 `product_price` 为空，所以使用了默认值。
-
-输入
-```liquid
-{% assign product_price = "" %}
-{{ product_price | default: 2.99 }}
-```
-
-输出
-```text
-2.99
-```
-
-## 允许 `false`
-
-{% since %}v9.32.0{% endsince %}
-
-为了允许让 `false` 直接输出而不是用默认值，可以用 `allow_false` 参数。
-
-输入
-
-```liquid
-{% assign display_price = false %}
-{{ display_price | default: true, allow_false: true }}
-```
-
-输出
-
-```text
-false
-```
-
-[falsy]: ../tutorials/truthy-and-falsy.html
diff --git a/docs/source/zh-cn/filters/divided_by.md b/docs/source/zh-cn/filters/divided_by.md
deleted file mode 100644
index 2eb2d4264..000000000
--- a/docs/source/zh-cn/filters/divided_by.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-title: divided_by
----
-
-{% since %}v1.9.1{% endsince %}
-
-两数相除返回商，返回结果数字在 JavaScript 中 `.toString()` 得到的字符串。
-
-输入
-```liquid
-{{ 16 | divided_by: 4 }}
-```
-
-输出
-```text
-4
-```
-
-输入
-```liquid
-{{ 5 | divided_by: 3 }}
-```
-
-输出
-```text
-1.6666666666666667
-```
-
-在 JavaScript 里数字没有浮点和整数的区分，它们的类型都是 `number`：
-
-```javascript
-// always true
-5.0 === 5
-```
-
-因此如果需要做整数运算，需要传入额外的 `integerArithmetic` 参数：
-
-Input
-```liquid
-{{ 5 | divided_by: 3, true }}
-```
-
-Output
-```text
-1
-```
-
-[floor]: ./floor.html
diff --git a/docs/source/zh-cn/filters/downcase.md b/docs/source/zh-cn/filters/downcase.md
deleted file mode 100644
index 4fb4cdbb9..000000000
--- a/docs/source/zh-cn/filters/downcase.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: downcase
----
-
-{% since %}v1.9.1{% endsince %}
-
-字符串中每个字符都转为小写，对已经是小写的字符没有影响。
-
-输入
-```liquid
-{{ "Parker Moore" | downcase }}
-```
-
-输出
-```text
-parker moore
-```
-
-输入
-```liquid
-{{ "apple" | downcase }}
-```
-
-输出
-```text
-apple
-```
diff --git a/docs/source/zh-cn/filters/escape.md b/docs/source/zh-cn/filters/escape.md
deleted file mode 100644
index 02e5c781e..000000000
--- a/docs/source/zh-cn/filters/escape.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: escape
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串中的 HTML 特殊字符转义，对不需要转义的字符串不会产生影响。
-
-输入
-```liquid
-{{ "Have you read 'James & the Giant Peach'?" | escape }}
-```
-
-输出
-<pre class="highlight">
-{{"Have you read &#39;James &amp; the Giant Peach&#39;?" | escape}}
-</pre>
-
-输入
-```liquid
-{{ "Tetsuro Takara" | escape }}
-```
-
-输出
-```text
-Tetsuro Takara
-```
diff --git a/docs/source/zh-cn/filters/escape_once.md b/docs/source/zh-cn/filters/escape_once.md
deleted file mode 100644
index 14a2f2e8f..000000000
--- a/docs/source/zh-cn/filters/escape_once.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: escape_once
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串中的特殊字符转义得到可用在 URL 里的字符串，对已经转义过的字符串和不需要转义的字符串不会产生影响。
-
-输入
-```liquid
-{{ "1 < 2 & 3" | escape_once }}
-```
-
-输出
-<pre class="highlight">
-{{"1 &lt; 2 &amp; 3" | escape}}
-</pre>
-
-输入
-<pre class="highlight">
-&#x7B;&#x7B; "{{"1 &lt; 2 &amp; 3" | escape}}" | escape_once }}
-</pre>
-
-输出
-<pre class="highlight">
-{{"1 &lt; 2 &amp; 3" | escape}}
-</pre>
diff --git a/docs/source/zh-cn/filters/find.md b/docs/source/zh-cn/filters/find.md
deleted file mode 100644
index baebe69b8..000000000
--- a/docs/source/zh-cn/filters/find.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: find
----
-
-{% since %}v10.11.0{% endsince %}
-
-在数组中找到给定的属性为给定的值的第一个元素并返回；如果没有这样的元素则返回 `nil`。对于 `members` 数组：
-
-```javascript
-const members = [
-  { graduation_year: 2013, name: 'Jay' },
-  { graduation_year: 2014, name: 'John' },
-  { graduation_year: 2014, name: 'Jack' }
-]
-```
-
-输入
-```liquid
-{{ members | find: "graduation_year", 2014 | json }}
-```
-
-输出
-```text
-{"graduation_year":2014,"name":"John"}
-```
diff --git a/docs/source/zh-cn/filters/find_exp.md b/docs/source/zh-cn/filters/find_exp.md
deleted file mode 100644
index 60a55c70e..000000000
--- a/docs/source/zh-cn/filters/find_exp.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: find_exp
----
-
-{% since %}v10.11.0{% endsince %}
-
-找到数组中给定的表达式值为 `true` 的第一个元素，如果没有这样的元素则返回 `nil`。对于下面的 `members` 数组：
-
-```javascript
-const members = [
-  { graduation_year: 2013, name: 'Jay' },
-  { graduation_year: 2014, name: 'John' },
-  { graduation_year: 2014, name: 'Jack' }
-]
-```
-
-输入
-```liquid
-{{ members | find_exp: "item", "item.graduation_year == 2014" | json }}
-```
-
-输出
-```text
-{"graduation_year":2014,"name":"John"}
-```
diff --git a/docs/source/zh-cn/filters/first.md b/docs/source/zh-cn/filters/first.md
deleted file mode 100644
index fd98ba7ea..000000000
--- a/docs/source/zh-cn/filters/first.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: first
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回数组的第一个元素。
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | split: " " | first }}
-```
-
-输出
-```text
-Ground
-```
-
-输入
-```liquid
-{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
-{{ my_array.first }}
-```
-
-输出
-```text
-
-zebra
-```
-
-需要在标签中使用的时候，可以用点来计算 `first`：
-
-```liquid
-{% if my_array.first == "zebra" %}
-  Here comes a zebra!
-{% endif %}
-```
diff --git a/docs/source/zh-cn/filters/floor.md b/docs/source/zh-cn/filters/floor.md
deleted file mode 100644
index 3401b52a6..000000000
--- a/docs/source/zh-cn/filters/floor.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: floor
----
-
-{% since %}v1.9.1{% endsince %}
-
-数字下取整，LiquidJS 会尝试把输入转换为数字再做下取整操作。
-
-输入
-```liquid
-{{ 1.2 | floor }}
-```
-
-输出
-```text
-1
-```
-
-输入
-```liquid
-{{ 2.0 | floor }}
-```
-
-输出
-```text
-2
-```
-
-输入
-```liquid
-{{ 183.357 | floor }}
-```
-
-输出
-```text
-183
-```
-
-下面的例子中输入是个数字：
-
-输入
-```liquid
-{{ "3.5" | floor }}
-```
-
-输出
-```text
-3
-```
diff --git a/docs/source/zh-cn/filters/group_by.md b/docs/source/zh-cn/filters/group_by.md
deleted file mode 100644
index 2ce1b08ac..000000000
--- a/docs/source/zh-cn/filters/group_by.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-title: group_by
----
-
-{% since %}v10.11.0{% endsince %}
-
-把数组元素按照给定的属性的值分组。对于 `members` 数组：
-
-```javascript
-const members = [
-  { graduation_year: 2003, name: 'Jay' },
-  { graduation_year: 2003, name: 'John' },
-  { graduation_year: 2004, name: 'Jack' }
-]
-```
-
-输入
-```liquid
-{{ members | group_by: "graduation_year" | json: 2 }}
-```
-
-输出
-```text
-[
-  {
-    "name": 2003,
-    "items": [
-      {
-        "graduation_year": 2003,
-        "name": "Jay"
-      },
-      {
-        "graduation_year": 2003,
-        "name": "John"
-      }
-    ]
-  },
-  {
-    "name": 2004,
-    "items": [
-      {
-        "graduation_year": 2004,
-        "name": "Jack"
-      }
-    ]
-  }
-]
-```
diff --git a/docs/source/zh-cn/filters/group_by_exp.md b/docs/source/zh-cn/filters/group_by_exp.md
deleted file mode 100644
index a68aaaee6..000000000
--- a/docs/source/zh-cn/filters/group_by_exp.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-title: group_by_exp
----
-
-{% since %}v10.11.0{% endsince %}
-
-把数组元素按照给定的 Liquid 表达式的值分组。对于 `members` 数组：
-
-```javascript
-const members = [
-  { graduation_year: 2013, name: 'Jay' },
-  { graduation_year: 2014, name: 'John' },
-  { graduation_year: 2009, name: 'Jack' }
-]
-```
-
-输入
-```liquid
-{{ members | group_by_exp: "item", "item.graduation_year | truncate: 3, ''" | json: 2 }}
-```
-
-输出
-```text
-[
-  {
-    "name": "201",
-    "items": [
-      {
-        "graduation_year": 2013,
-        "name": "Jay"
-      },
-      {
-        "graduation_year": 2014,
-        "name": "John"
-      }
-    ]
-  },
-  {
-    "name": "200",
-    "items": [
-      {
-        "graduation_year": 2009,
-        "name": "Jack"
-      }
-    ]
-  }
-]
-```
diff --git a/docs/source/zh-cn/filters/inspect.md b/docs/source/zh-cn/filters/inspect.md
deleted file mode 100644
index e59dff12f..000000000
--- a/docs/source/zh-cn/filters/inspect.md
+++ /dev/null
@@ -1,42 +0,0 @@
----
-title: inspect
----
-
-{% since %}v10.13.0{% endsince %}
-
-类似于 `json`，但可以处理循环引用的情况。例如对于上下文：
-
-```
-const foo = {
-    bar: 'BAR'
-}
-foo.foo = foo
-const scope = { foo }
-```
-
-输入
-```liquid
-{% foo | inspect %}
-```
-
-输出
-```text
-{"bar":"BAR","foo":"[Circular]"}
-```
-
-## 格式化
-
-可以指定一个 `space` 参数来缩进长度。
-
-输入
-```liquid
-{{ foo | inspect: 4 }}
-```
-
-输出
-```text
-{
-    "bar": "BAR",
-    "foo": "[Circular]"
-}
-```
diff --git a/docs/source/zh-cn/filters/join.md b/docs/source/zh-cn/filters/join.md
deleted file mode 100644
index cfda7ffb8..000000000
--- a/docs/source/zh-cn/filters/join.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-title: join
----
-
-{% since %}v1.9.1{% endsince %}
-
-把数组中的元素连接成为一个字符串，以传入的参数作为分隔符。
-
-输入
-```liquid
-{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
-{{ beatles | join: " and " }}
-```
-
-输出
-```text
-
-John and Paul and George and Ringo
-```
diff --git a/docs/source/zh-cn/filters/json.md b/docs/source/zh-cn/filters/json.md
deleted file mode 100644
index 3fc6e71f7..000000000
--- a/docs/source/zh-cn/filters/json.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: json
----
-
-{% since %}v9.10.0{% endsince %}
-
-通过 `JSON.stringify()` 把值转换为字符串，多用于调试用途。
-
-输入
-```liquid
-{% assign arr = "foo bar coo" | split: " " %}
-{{ arr | json }}
-```
-
-输出
-```text
-["foo","bar","coo"]
-```
-
-## 格式化
-
-{% since %}v10.11.0{% endsince %}
-
-可以指定一个 `space` 参数来格式化 JSON。
-
-输入
-```liquid
-{% assign arr = "foo bar coo" | split: " " %}
-{{ arr | json: 4 }}
-```
-
-输出
-```text
-[
-    "foo",
-    "bar",
-    "coo"
-]
-```
diff --git a/docs/source/zh-cn/filters/jsonify.md b/docs/source/zh-cn/filters/jsonify.md
deleted file mode 100644
index 55ff26ed6..000000000
--- a/docs/source/zh-cn/filters/jsonify.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-title: jsonify
----
-
-{% since %}v10.13.0{% endsince %}
-
-见 [json][json]。
-
-[json]: ./json.html
diff --git a/docs/source/zh-cn/filters/last.md b/docs/source/zh-cn/filters/last.md
deleted file mode 100644
index 971acb5a2..000000000
--- a/docs/source/zh-cn/filters/last.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: last
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回数组的最后一个元素。
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | split: " " | last }}
-```
-
-输出
-```text
-Tom.
-```
-
-输入
-```liquid
-{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
-{{ my_array.last }}
-```
-
-输出
-```text
-
-tiger
-```
-
-需要在标签中使用的时候，可以用点来计算 `last`：
-
-```liquid
-{% if my_array.last == "tiger" %}
-  There goes a tiger!
-{% endif %}
-```
diff --git a/docs/source/zh-cn/filters/lstrip.md b/docs/source/zh-cn/filters/lstrip.md
deleted file mode 100644
index f7e07a85e..000000000
--- a/docs/source/zh-cn/filters/lstrip.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: lstrip
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串左侧的空白字符（制表符、空格、换行），不影响词之间的空格。
-
-输入
-```liquid
-BEGIN{{ "          So much room for activities!          " | lstrip }}END
-```
-
-输出
-```text
-BEGINSo much room for activities!          END
-```
diff --git a/docs/source/zh-cn/filters/map.md b/docs/source/zh-cn/filters/map.md
deleted file mode 100644
index 5686e8c8a..000000000
--- a/docs/source/zh-cn/filters/map.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: map
----
-
-{% since %}v1.9.1{% endsince %}
-
-按照属性名提取对象的属性形成另一个数组并返回。
-
-下面的例子中假设 `site.pages` 包含了站点的所有网页元信息。使用 `assign` 加 `map` 过滤器创建了一个 `site.pages` 中所有对象的 `category` 属性的值构成的数组。
-
-输入
-```liquid
-{% assign all_categories = site.pages | map: "category" %}
-
-{% for item in all_categories %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- business
-- celebrities
-- lifestyle
-- sports
-- technology
-```
diff --git a/docs/source/zh-cn/filters/minus.md b/docs/source/zh-cn/filters/minus.md
deleted file mode 100644
index 8c7c45a04..000000000
--- a/docs/source/zh-cn/filters/minus.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: minus
----
-
-{% since %}v1.9.1{% endsince %}
-
-两数相减。
-
-输入
-```liquid
-{{ 4 | minus: 2 }}
-```
-
-输出
-```text
-2
-```
-
-输入
-```liquid
-{{ 16 | minus: 4 }}
-```
-
-输出
-```text
-12
-```
-
-输入
-```liquid
-{{ 183.357 | minus: 12 }}
-```
-
-输出
-```text
-171.357
-```
diff --git a/docs/source/zh-cn/filters/modulo.md b/docs/source/zh-cn/filters/modulo.md
deleted file mode 100644
index 037502bc4..000000000
--- a/docs/source/zh-cn/filters/modulo.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: modulo
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回两数相除的余数。
-
-输入
-```liquid
-{{ 3 | modulo: 2 }}
-```
-
-输出
-```text
-1
-```
-
-输入
-```liquid
-{{ 24 | modulo: 7 }}
-```
-
-输出
-```text
-3
-```
-
-输入
-```liquid
-{{ 183.357 | modulo: 12 }}
-```
-
-输出
-```text
-3.3569999999999993
-```
diff --git a/docs/source/zh-cn/filters/newline_to_br.md b/docs/source/zh-cn/filters/newline_to_br.md
deleted file mode 100644
index 8c60e7725..000000000
--- a/docs/source/zh-cn/filters/newline_to_br.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: newline_to_br
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串里的所有换行符（`\n`）替换为 HTML 换行（`<br />`）。
-
-输入
-```liquid
-{% capture string_with_newlines %}
-Hello
-there
-{% endcapture %}
-
-{{ string_with_newlines | newline_to_br }}
-```
-
-输出
-```html
-
-<br/>Hello<br/>there<br/>
-```
diff --git a/docs/source/zh-cn/filters/normalize_whitespace.md b/docs/source/zh-cn/filters/normalize_whitespace.md
deleted file mode 100644
index db203419b..000000000
--- a/docs/source/zh-cn/filters/normalize_whitespace.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: normalize_whitespace
----
-
-{% since %}v10.13.0{% endsince %}
-
-把连续的空白字符替换为单个空格。
-
-输入
-```liquid
-{{ "a \n b" | normalize_whitespace }}
-```
-
-输出
-```html
-a b
-```
diff --git a/docs/source/zh-cn/filters/number_of_words.md b/docs/source/zh-cn/filters/number_of_words.md
deleted file mode 100644
index 2e239b876..000000000
--- a/docs/source/zh-cn/filters/number_of_words.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: number_of_words
----
-
-{% since %}v10.13.0{% endsince %}
-
-计算文本中的单词数。此过滤器接受一个可选参数，用于控制输入字符串中汉字-日语-韩语（CJK）字符的处理方式：
-- `'cjk'`：将每个检测到的 CJK 字符计为一个单词，无论是否由空格分隔。
-- `'auto'`：与 `'cjk'` 类似，但如果过滤器用于可能包含或不包含 CJK 字符的字符串，则性能更好。
-
-输入
-```liquid
-{{ "Hello world!" | number_of_words }}
-```
-
-输出
-```text
-2
-```
-
-输入
-```liquid
-{{ "你好hello世界world" | number_of_words }}
-```
-
-输出
-```text
-1
-```
-
-输入
-```liquid
-{{ "你好hello世界world" | number_of_words: "cjk" }}
-```
-
-输出
-```text
-6
-```
-
-输入
-```liquid
-{{ "你好hello世界world" | number_of_words: "auto" }}
-```
-
-输出
-```text
-6
-```
diff --git a/docs/source/zh-cn/filters/overview.md b/docs/source/zh-cn/filters/overview.md
deleted file mode 100644
index 3e19c0852..000000000
--- a/docs/source/zh-cn/filters/overview.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-title: 过滤器
-description: 每个 Liquid 过滤器的描述和示例
----
-
-LiquidJS 支持 Liquid 语法中具体业务无关的过滤器，基本上 [shopify/liquid 核心][shopify/liquid] 支持的 LiquidJS 都支持。这部分包含了所有 LiquidJS 支持的过滤器的文档和使用示例。
-
-LiquidJS 共支持 40+ 个过滤器，可以分为如下几类：
-
-类别 | 过滤器
---- | ---
-数学 | plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
-字符串 | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last, remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace, number_of_words, array_to_sentence_string
-HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br, xml_escape, cgi_escape, uri_escape, slugify
-数组 | slice, map, sort, sort_natural, uniq, where, where_exp, group_by, group_by_exp, find, find_exp, first, last, join, reverse, concat, compact, size, push, pop, shift, unshift
-日期 | date, date_to_xmlschema, date_to_rfc822, date_to_string, date_to_long_string
-其他 | default, json, jsonify, inspect, raw, to_integer
-
-[shopify/liquid]: https://github.com/Shopify/liquid
diff --git a/docs/source/zh-cn/filters/plus.md b/docs/source/zh-cn/filters/plus.md
deleted file mode 100644
index a44740656..000000000
--- a/docs/source/zh-cn/filters/plus.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: plus
----
-
-{% since %}v1.9.1{% endsince %}
-
-两数相加。
-
-输入
-```liquid
-{{ 4 | plus: 2 }}
-```
-
-输出
-```text
-6
-```
-
-输入
-```liquid
-{{ 16 | plus: 4 }}
-```
-
-输出
-```text
-20
-```
-
-输入
-```liquid
-{{ 183.357 | plus: 12 }}
-```
-
-输出
-```text
-195.357
-```
diff --git a/docs/source/zh-cn/filters/pop.md b/docs/source/zh-cn/filters/pop.md
deleted file mode 100644
index fb72a9788..000000000
--- a/docs/source/zh-cn/filters/pop.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: pop
----
-
-{% since %}v10.11.0{% endsince %}
-
-从数组末尾弹出一个元素。注意该操作不会改变原数组，而是在一份拷贝上操作。
-
-输入
-```liquid
-{% assign fruits = "apples, oranges, peaches" | split: ", " %}
-
-{% assign everything = fruits | pop %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- apples
-- oranges
-```
diff --git a/docs/source/zh-cn/filters/prepend.md b/docs/source/zh-cn/filters/prepend.md
deleted file mode 100644
index fa0cb9e22..000000000
--- a/docs/source/zh-cn/filters/prepend.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-title: prepend
----
-
-{% since %}v1.9.1{% endsince %}
-
-在字符串开头添加另一个字符串。
-
-输入
-```liquid
-{{ "apples, oranges, and bananas" | prepend: "Some fruit: " }}
-```
-
-输出
-```text
-Some fruit: apples, oranges, and bananas
-```
-
-`prepend` 也可以用于变量。
-
-输入
-```liquid
-{% assign url = "example.com" %}
-{{ "/index.html" | prepend: url }}
-```
-
-输出
-```text
-
-example.com/index.html
-```
diff --git a/docs/source/zh-cn/filters/push.md b/docs/source/zh-cn/filters/push.md
deleted file mode 100644
index ea24324d9..000000000
--- a/docs/source/zh-cn/filters/push.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: push
----
-
-{% since %}v10.8.0{% endsince %}
-
-在数组中添加一个元素。注意该操作不会改变原数组，而是在一份拷贝上操作。
-
-输入
-```liquid
-{% assign fruits = "apples, oranges" | split: ", " %}
-
-{% assign everything = fruits | push: "peaches" %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- apples
-- oranges
-- peaches
-```
diff --git a/docs/source/zh-cn/filters/raw.md b/docs/source/zh-cn/filters/raw.md
deleted file mode 100644
index 03be9fca9..000000000
--- a/docs/source/zh-cn/filters/raw.md
+++ /dev/null
@@ -1,52 +0,0 @@
----
-title: raw
----
-
-{% since %}v9.37.0{% endsince %}
-
-直接返回变量的值。配合 [outputEscape](/api/interfaces/LiquidOptions.html#outputEscape) 参数使用。
-
-{% note info 自动转义 %}
-默认情况下 `outputEscape` 为 `undefined`，这意味着 LiquidJS 输出不会默认转义，因此这时使用 `raw` 没有意义。
-{% endnote %}
-
-输入（未设置 `outputEscape`）
-```liquid
-{{ "<" }}
-```
-
-输出
-```text
-<
-```
-
-输入（`outputEscape="escape"`）
-```liquid
-{{ "<" }}
-```
-
-输出
-```text
-&lt;
-```
-
-输入（`outputEscape="json"`）
-```liquid
-{{ "<" }}
-```
-
-输出
-```text
-"<"
-```
-
-输入（`outputEscape="escape"`）
-```liquid
-{{ "<" | raw }}
-```
-
-输出
-```text
-<
-```
-
diff --git a/docs/source/zh-cn/filters/remove.md b/docs/source/zh-cn/filters/remove.md
deleted file mode 100644
index 3489e6d4a..000000000
--- a/docs/source/zh-cn/filters/remove.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: remove
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串中出现的所有指定子字符串。
-
-输入
-```liquid
-{{ "I strained to see the train through the rain" | remove: "rain" }}
-```
-
-输出
-```text
-I strained to see the t through the 
-```
diff --git a/docs/source/zh-cn/filters/remove_first.md b/docs/source/zh-cn/filters/remove_first.md
deleted file mode 100644
index cc3400f04..000000000
--- a/docs/source/zh-cn/filters/remove_first.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: remove_first
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串中出现的第一个指定子字符串。
-
-输入
-```liquid
-{{ "I strained to see the train through the rain" | remove_first: "rain" }}
-```
-
-输出
-```text
-I strained to see the t through the rain
-```
diff --git a/docs/source/zh-cn/filters/remove_last.md b/docs/source/zh-cn/filters/remove_last.md
deleted file mode 100644
index f5afdb45d..000000000
--- a/docs/source/zh-cn/filters/remove_last.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: remove_last
----
-
-{% since %}v10.2.0{% endsince %}
-
-移除字符串中出现的最后一个指定子字符串。
-
-输入
-```liquid
-{{ "I strained to see the train through the rain" | remove_last: "rain" }}
-```
-
-输出
-```text
-I strained to see the train through the
-```
diff --git a/docs/source/zh-cn/filters/replace.md b/docs/source/zh-cn/filters/replace.md
deleted file mode 100644
index c7109f9cc..000000000
--- a/docs/source/zh-cn/filters/replace.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: replace
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串中出现的每一个指定子字符串替换为另一个字符串。
-
-输入
-```liquid
-{{ "Take my protein pills and put my helmet on" | replace: "my", "your" }}
-```
-
-输出
-```text
-Take your protein pills and put your helmet on
-```
diff --git a/docs/source/zh-cn/filters/replace_first.md b/docs/source/zh-cn/filters/replace_first.md
deleted file mode 100644
index 6636db913..000000000
--- a/docs/source/zh-cn/filters/replace_first.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: replace_first
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串中出现的第一个指定子字符串替换为另一个字符串。
-
-输入
-```liquid
-{{ "Take my protein pills and put my helmet on" | replace_first: "my", "your" }}
-```
-
-输出
-```text
-Take your protein pills and put my helmet on
-```
diff --git a/docs/source/zh-cn/filters/replace_last.md b/docs/source/zh-cn/filters/replace_last.md
deleted file mode 100644
index 46736de7d..000000000
--- a/docs/source/zh-cn/filters/replace_last.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: replace_last
----
-
-{% since %}v10.2.0{% endsince %}
-
-把字符串中出现的最后一个指定子字符串替换为另一个字符串。
-
-输入
-```liquid
-{{ "Take my protein pills and put my helmet on" | replace_last: "my", "your" }}
-```
-
-输出
-```text
-Take my protein pills and put your helmet on
-```
diff --git a/docs/source/zh-cn/filters/reverse.md b/docs/source/zh-cn/filters/reverse.md
deleted file mode 100644
index 0ebef2698..000000000
--- a/docs/source/zh-cn/filters/reverse.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-title: reverse
----
-
-{% since %}v1.9.1{% endsince %}
-
-反转数组的所有元素，不可用于字符串。
-
-输入
-```liquid
-{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
-
-{{ my_array | reverse | join: ", " }}
-```
-
-输出
-```text
-
-
-plums, peaches, oranges, apples
-```
-
-尽管 `reverse` 不能直接用于字符串，可以把字符串分割成数组，反转后再连接成字符串：
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | split: "" | reverse | join: "" }}
-```
-
-输出
-```text
-.moT rojaM ot lortnoc dnuorG
-```
diff --git a/docs/source/zh-cn/filters/round.md b/docs/source/zh-cn/filters/round.md
deleted file mode 100644
index 9f013db75..000000000
--- a/docs/source/zh-cn/filters/round.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: round
----
-
-{% since %}v1.9.1{% endsince %}
-
-数字四舍五入取整，如果传入小数位数作为参数。
-
-输入
-```liquid
-{{ 1.2 | round }}
-```
-
-输出
-```text
-1
-```
-
-输入
-```liquid
-{{ 2.7 | round }}
-```
-
-输出
-```text
-3
-```
-
-输入
-```liquid
-{{ 183.357 | round: 2 }}
-```
-
-输出
-```text
-183.36
-```
diff --git a/docs/source/zh-cn/filters/rstrip.md b/docs/source/zh-cn/filters/rstrip.md
deleted file mode 100644
index a717a7ed6..000000000
--- a/docs/source/zh-cn/filters/rstrip.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: rstrip
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串右侧的空白字符（制表符、空格、换行），不影响词之间的空格。
-
-输入
-```liquid
-BEGIN{{ "          So much room for activities!          " | rstrip }}END
-```
-
-输出
-```text
-BEGIN          So much room for activities!END
-```
diff --git a/docs/source/zh-cn/filters/shift.md b/docs/source/zh-cn/filters/shift.md
deleted file mode 100644
index e2bb70481..000000000
--- a/docs/source/zh-cn/filters/shift.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-title: shift
----
-
-{% since %}v10.11.0{% endsince %}
-
-从数组头部弹出一个元素。注意该操作不会改变原数组，而是在一份拷贝上操作。
-
-输入
-```liquid
-{% assign fruits = "apples, oranges, peaches" | split: ", " %}
-
-{% assign everything = fruits | shift %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- oranges
-- peaches
-```
diff --git a/docs/source/zh-cn/filters/size.md b/docs/source/zh-cn/filters/size.md
deleted file mode 100644
index 661273b0e..000000000
--- a/docs/source/zh-cn/filters/size.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: size
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回字符串的字符个数或者数组的元素个数。
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | size }}
-```
-
-输出
-```text
-28
-```
-
-输入
-```liquid
-{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
-
-{{ my_array.size }}
-```
-
-输出
-```text
-
-
-4
-```
-
-在标签里可以用点来计算 `size`：
-
-```liquid
-{% if site.pages.size > 10 %}
-  This is a big website!
-{% endif %}
-```
diff --git a/docs/source/zh-cn/filters/slice.md b/docs/source/zh-cn/filters/slice.md
deleted file mode 100644
index a3f2a4df7..000000000
--- a/docs/source/zh-cn/filters/slice.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: slice
----
-
-{% since %}v1.9.1{% endsince %}
-
-返回第一个参数为下标位置的一个字符，如果指定了第二个参数会被解释为子字符串的长度。字符串下标从零开始。
-
-输入
-```liquid
-{{ "Liquid" | slice: 0 }}
-```
-
-输出
-```text
-L
-```
-
-输入
-```liquid
-{{ "Liquid" | slice: 2 }}
-```
-
-输出
-```text
-q
-```
-
-输入
-```liquid
-{{ "Liquid" | slice: 2, 5 }}
-```
-
-输出
-```text
-quid
-```
-
-If the first argument is a negative number, the indices are counted from the end of the string:
-
-输入
-```liquid
-{{ "Liquid" | slice: -3, 2 }}
-```
-
-输出
-```text
-ui
-```
diff --git a/docs/source/zh-cn/filters/slugify.md b/docs/source/zh-cn/filters/slugify.md
deleted file mode 100644
index c6fd88260..000000000
--- a/docs/source/zh-cn/filters/slugify.md
+++ /dev/null
@@ -1,59 +0,0 @@
----
-title: slugify
----
-
-将字符串转换为小写的 URL “slug”。`slugify` 过滤器接受两个选项：
-
-1. `mode: string`。默认为`"default"`，它可选的值如下：
-   - `"none"`：没有字符
-   - `"raw"`：空格
-   - `"default"`：空格和非字母数字字符
-   - `"pretty"`：空格和非字母数字字符，但排除 `._~!$&'()+,;=@`
-   - `"ascii"`：空格、非字母数字和非 ASCII 字符
-   - `"latin"`：与默认相同，但拉丁字符首先进行音译（例如，àèïòü 转换为 aeiou）。
-2. `case: boolean`。默认为 `false`。如果为 `true`，则保留 `slug` 原本的大小写。
-
-输入
-```liquid
-{{ "The _config.yml file" | slugify }}
-```
-输出
-```
-the-config-yml-file
-```
-
-输入
-```liquid
-{{ "The _config.yml file" | slugify: "pretty" }}
-```
-输出
-```
-the-_config.yml-file
-```
-
-输入
-```liquid
-{{ "The _cönfig.yml file" | slugify: "ascii" }}
-```
-输出
-```
-the-c-nfig-yml-file
-```
-
-输入
-```liquid
-{{ "The cönfig.yml file" | slugify: "latin" }}
-```
-输出
-```
-the-config-yml-file
-```
-
-输入
-```liquid
-{{ "The cönfig.yml file" | slugify: "latin", true }}
-```
-输出
-```
-The-config-yml-file
-```
diff --git a/docs/source/zh-cn/filters/sort.md b/docs/source/zh-cn/filters/sort.md
deleted file mode 100644
index 705c7ca9f..000000000
--- a/docs/source/zh-cn/filters/sort.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-title: sort
----
-
-{% since %}v1.9.1{% endsince %}
-
-对数组中的元素排序，排序方式为 JavaScript `Array.prototype.sort()`。
-
-输入
-```liquid
-{% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %}
-
-{{ my_array | sort | join: ", " }}
-```
-
-输出
-```text
-
-
-Sally Snake, giraffe, octopus, zebra
-```
-
-有一个参数来指定用元素的哪个属性排序。
-
-```liquid
-{% assign products_by_price = collection.products | sort: "price" %}
-{% for product in products_by_price %}
-  <h4>{{ product.title }}</h4>
-{% endfor %}
-```
diff --git a/docs/source/zh-cn/filters/sort_natural.md b/docs/source/zh-cn/filters/sort_natural.md
deleted file mode 100644
index dc097d025..000000000
--- a/docs/source/zh-cn/filters/sort_natural.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-title: sort_natural
----
-
-{% since %}v8.4.0{% endsince %}
-
-大小写不敏感地对数组元素排序。
-
-输入
-```liquid
-{% assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %}
-
-{{ my_array | sort_natural | join: ", " }}
-```
-
-输出
-```text
-
-
-giraffe, octopus, Sally Snake, zebra
-```
-
-有一个参数来指定用元素的哪个属性排序。
-
-```liquid
-{% assign products_by_company = collection.products | sort_natural: "company" %}
-{% for product in products_by_company %}
-  <h4>{{ product.title }}</h4>
-{% endfor %}
-```
diff --git a/docs/source/zh-cn/filters/split.md b/docs/source/zh-cn/filters/split.md
deleted file mode 100644
index 328600213..000000000
--- a/docs/source/zh-cn/filters/split.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-title: split
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串按照指定的分隔符进行分割，`split` 通常用于把逗号分隔的字符串转换为数组。
-
-输入
-```liquid
-{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
-
-{% for member in beatles %}
-  {{ member }}
-{% endfor %}
-```
-
-输出
-```text
-
-
-
-
-  John
-
-  Paul
-
-  George
-
-  Ringo
-```
diff --git a/docs/source/zh-cn/filters/strip.md b/docs/source/zh-cn/filters/strip.md
deleted file mode 100644
index 08dd4d3dc..000000000
--- a/docs/source/zh-cn/filters/strip.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: strip
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串两侧的空白字符（制表符、空格、换行），不影响词之间的空格。
-
-输入
-```liquid
-BEGIN{{ "          So much room for activities!          " | strip }}END
-```
-
-输出
-```text
-BEGINSo much room for activities!END
-```
diff --git a/docs/source/zh-cn/filters/strip_html.md b/docs/source/zh-cn/filters/strip_html.md
deleted file mode 100644
index ac907c911..000000000
--- a/docs/source/zh-cn/filters/strip_html.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: strip_html
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串中的 HTML 标签。
-
-输入
-```liquid
-{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
-```
-
-输出
-```text
-Have you read Ulysses?
-```
diff --git a/docs/source/zh-cn/filters/strip_newlines.md b/docs/source/zh-cn/filters/strip_newlines.md
deleted file mode 100644
index ca9eefe9a..000000000
--- a/docs/source/zh-cn/filters/strip_newlines.md
+++ /dev/null
@@ -1,23 +0,0 @@
----
-title: strip_newlines
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除字符串中的换行符。
-
-输入
-```liquid
-{% capture string_with_newlines %}
-Hello
-there
-{% endcapture %}
-
-{{ string_with_newlines | strip_newlines }}
-```
-
-输出
-```html
-
-Hellothere
-```
diff --git a/docs/source/zh-cn/filters/times.md b/docs/source/zh-cn/filters/times.md
deleted file mode 100644
index ea0d8adaf..000000000
--- a/docs/source/zh-cn/filters/times.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: times
----
-
-{% since %}v1.9.1{% endsince %}
-
-两数相乘。
-
-输入
-```liquid
-{{ 3 | times: 2 }}
-```
-
-输出
-```text
-6
-```
-
-输入
-```liquid
-{{ 24 | times: 7 }}
-```
-
-输出
-```text
-168
-```
-
-输入
-```liquid
-{{ 183.357 | times: 12 }}
-```
-
-输出
-```text
-2200.284
-```
diff --git a/docs/source/zh-cn/filters/to_integer.md b/docs/source/zh-cn/filters/to_integer.md
deleted file mode 100644
index e79c879ec..000000000
--- a/docs/source/zh-cn/filters/to_integer.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: to_integer
----
-
-{% since %}v10.13.0{% endsince %}
-
-转换为数字类型。
-
-输入
-```liquid
-{{ "123" | to_integer | json }}
-```
-
-输出
-```text
-123
-```
diff --git a/docs/source/zh-cn/filters/truncate.md b/docs/source/zh-cn/filters/truncate.md
deleted file mode 100644
index 0ae5fa5e6..000000000
--- a/docs/source/zh-cn/filters/truncate.md
+++ /dev/null
@@ -1,47 +0,0 @@
----
-title: truncate
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串截断为指定长度，可以指定一个数字表示截断到多少长度。最后会添加一个省略号（...）且记在长度里。
-
-## 基本使用
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncate: 20 }}
-```
-
-输出
-```text
-Ground control to...
-```
-
-## 自定义省略号
-
-`truncate` 的第二个可选参数用来指定后面追加的字符串，默认为省略号（...）。这个参数的长度会计算在第一个参数的长度里。例如，如果要把字符串截断到 10 个字符，并使用了一个 3 字符长度的省略号，那么第一个参数的值要设置到 **13**。
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncate: 25, ", and so on" }}
-```
-
-输出
-```text
-Ground control, and so on
-```
-
-## 不要省略号
-
-如果需要把字符串截断到特定长度且不要添加省略号，则把第二个参数设置为空字符串：
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncate: 20, "" }}
-```
-
-输出
-```text
-Ground control to Ma
-```
diff --git a/docs/source/zh-cn/filters/truncatewords.md b/docs/source/zh-cn/filters/truncatewords.md
deleted file mode 100644
index 62ae88215..000000000
--- a/docs/source/zh-cn/filters/truncatewords.md
+++ /dev/null
@@ -1,47 +0,0 @@
----
-title: truncatewords
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串截断为指定个数的单词，可以指定一个数字表示截断到多少个单词。最后会添加一个省略号（...）。
-
-## 基本使用
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncatewords: 3 }}
-```
-
-输出
-```text
-Ground control to...
-```
-
-## 自定义省略号
-
-`truncate` 的第二个可选参数用来指定后面追加的字符串，默认为省略号（...）。
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncatewords: 3, "--" }}
-```
-
-输出
-```text
-Ground control to--
-```
-
-## 不要省略号
-
-如果不希望添加省略号，把第二个参数设置为空字符串即可：
-
-输入
-```liquid
-{{ "Ground control to Major Tom." | truncatewords: 3, "" }}
-```
-
-输出
-```text
-Ground control to
-```
diff --git a/docs/source/zh-cn/filters/uniq.md b/docs/source/zh-cn/filters/uniq.md
deleted file mode 100644
index 85cff1466..000000000
--- a/docs/source/zh-cn/filters/uniq.md
+++ /dev/null
@@ -1,18 +0,0 @@
----
-title: uniq
----
-
-{% since %}v1.9.1{% endsince %}
-
-移除数组中的重复元素。
-
-输入
-```liquid
-{% assign my_array = "ants, bugs, bees, bugs, ants" | split: ", " %}
-{{ my_array | uniq | join: ", " }}
-```
-
-输出
-```text
-
-ants, bugs, bees```
diff --git a/docs/source/zh-cn/filters/unshift.md b/docs/source/zh-cn/filters/unshift.md
deleted file mode 100644
index e29ebd2f7..000000000
--- a/docs/source/zh-cn/filters/unshift.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: unshift
----
-
-{% since %}v10.11.0{% endsince %}
-
-往数组头部添加一个元素。注意该操作不会改变原数组，而是在一份拷贝上操作。
-
-输入
-```liquid
-{% assign fruits = "oranges, peaches" | split: ", " %}
-
-{% assign everything = fruits | unshift: "apples" %}
-
-{% for item in everything %}
-- {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-- apples
-- oranges
-- peaches
-```
diff --git a/docs/source/zh-cn/filters/upcase.md b/docs/source/zh-cn/filters/upcase.md
deleted file mode 100644
index 8d4b26e58..000000000
--- a/docs/source/zh-cn/filters/upcase.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: upcase
----
-
-{% since %}v1.9.1{% endsince %}
-
-字符串中每个字符都转为大写，对已经是大写的字符没有影响。
-
-输入
-```liquid
-{{ "Parker Moore" | upcase }}
-```
-
-输出
-```text
-PARKER MOORE
-```
-
-输入
-```liquid
-{{ "APPLE" | upcase }}
-```
-
-输出
-```text
-APPLE
-```
diff --git a/docs/source/zh-cn/filters/uri_escape.md b/docs/source/zh-cn/filters/uri_escape.md
deleted file mode 100644
index 31c2c1fb5..000000000
--- a/docs/source/zh-cn/filters/uri_escape.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-title: uri_escape
----
-
-{% since %}v10.13.0{% endsince %}
-
-把 URI 中的特殊字符做百分号编码，空格会变成 `%20`。[保留字][reserved] 不会被转义。
-
-输入
-```liquid
-{{ "https://example.com/?q=foo, \bar?" | uri_escape }}
-```
-
-输出
-```text
-https://example.com/?q=foo,%20%5Cbar?
-```
-
-[reserved]: https://en.wikipedia.org/wiki/Percent-encoding#Types_of_URI_characters
diff --git a/docs/source/zh-cn/filters/url_decode.md b/docs/source/zh-cn/filters/url_decode.md
deleted file mode 100644
index 8bfa63db5..000000000
--- a/docs/source/zh-cn/filters/url_decode.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: url_decode
----
-
-{% since %}v6.1.0{% endsince %}
-
-把 URL 编码的字符串解码。
-
-输入
-```liquid
-{{ "%27Stop%21%27+said+Fred" | url_decode }}
-```
-
-输出
-```text
-'Stop!' said Fred
-```
diff --git a/docs/source/zh-cn/filters/url_encode.md b/docs/source/zh-cn/filters/url_encode.md
deleted file mode 100644
index 3817d8743..000000000
--- a/docs/source/zh-cn/filters/url_encode.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: url_encode
----
-
-{% since %}v1.9.1{% endsince %}
-
-把字符串中 URL 不安全的字符转义为百分号编码。
-
-输入
-```liquid
-{{ "john@liquid.com" | url_encode }}
-```
-
-输出
-```text
-john%40liquid.com
-```
-
-输入
-```liquid
-{{ "Tetsuro Takara" | url_encode }}
-```
-
-输出
-```text
-Tetsuro+Takara
-```
diff --git a/docs/source/zh-cn/filters/where.md b/docs/source/zh-cn/filters/where.md
deleted file mode 100644
index e35a8f0c8..000000000
--- a/docs/source/zh-cn/filters/where.md
+++ /dev/null
@@ -1,134 +0,0 @@
----
-title: where
----
-
-{% since %}v8.1.0{% endsince %}
-
-按照数组中对象的属性值来过滤得到新数组，如果未指定第二个参数（属性值）则过滤得到所有属性值为 [truthy][truthy] 的对象。
-
-下面的例子中，假设你有一个 `products` 列表并且希望展示其中的厨房产品。使用 `where` 过滤器可以得到一个只包含 `"type"` 属性值为 `"kitchen"` 的元素的数组。
-
-输入
-```liquid
-All products:
-{% for product in products %}
-- {{ product.title }}
-{% endfor %}
-
-{% assign kitchen_products = products | where: "type", "kitchen" %}
-
-Kitchen products:
-{% for product in kitchen_products %}
-- {{ product.title }}
-{% endfor %}
-```
-
-输出
-```text
-All products:
-- Vacuum
-- Spatula
-- Television
-- Garlic press
-
-Kitchen products:
-- Spatula
-- Garlic press
-```
-
-如果你有一个产品列表且希望只显示可用的产品，可以用 `where` 过滤器但不指定目标值，LiquidJS 会过滤得到 `"available"` 值为 [truthy][truthy] 的产品列表。
-
-输入
-```liquid
-All products:
-{% for product in products %}
-- {{ product.title }}
-{% endfor %}
-
-{% assign available_products = products | where: "available" %}
-
-Available products:
-{% for product in available_products %}
-- {{ product.title }}
-{% endfor %}
-```
-
-输出
-```text
-All products:
-- Coffee mug
-- Limited edition sneakers
-- Boring sneakers
-
-Available products:
-- Coffee mug
-- Boring sneakers
-```
-
-`where` 后面再加一个 `first` 可以用来得到单个元素。例如，你要展示秋季系列里的单个 T-shirt。
-
-输入
-```liquid
-{% assign new_shirt = products | where: "type", "shirt" | first %}
-
-Featured product: {{ new_shirt.title }}
-```
-
-输出
-```text
-Featured product: Hawaiian print sweater vest
-```
-
-此外 `property` 可以是任意合法的变量表达式，就像在**输出**结构中一样，只是它的上下文是数组的每一个元素。对于下面的 `products` 数组：
-
-```javascript
-const products = [
-    { meta: { details: { class: 'A' } }, order: 1 },
-    { meta: { details: { class: 'B' } }, order: 2 },
-    { meta: { details: { class: 'B' } }, order: 3 }
-]
-```
-
-输入
-```liquid
-{% assign selected = products | where: 'meta.details["class"]', "B" %}
-{% for item in selected -%}
-- {{ item.order }}
-{% endfor %}
-```
-
-输出
-```text
-- 2
-- 3
-```
-
-## Jekyll 风格
-
-{% since %}v10.19.0{% endsince %}
-
-对于从 Jekyll 迁移到 Liquid 的用户，有一个 `jekyllWhere` 选项可以模拟 Jekyll 的 `where` 过滤器的行为。该选项默认设置为 `false`。启用后，如果 `property` 是一个数组，目标值将使用 `Array.includes` 而不是 `==` 进行匹配，这在过滤标签时特别有用。
-
-例如，以下代码：
-
-```javascript
-const pages = [
-    { tags: ["cat", "food"], title: 'Cat Food' },
-    { tags: ["dog", "food"], title: 'Dog Food' },
-]
-```
-
-输入
-```liquid
-{% assign selected = pages | where: 'tags', "cat" %}
-{% for item in selected -%}
-- {{ item.title }}
-{% endfor %}
-```
-
-输出
-```text
-Cat Food
-```
-
-[truthy]: ../tutorials/truthy-and-falsy.html
diff --git a/docs/source/zh-cn/filters/where_exp.md b/docs/source/zh-cn/filters/where_exp.md
deleted file mode 100644
index f28368950..000000000
--- a/docs/source/zh-cn/filters/where_exp.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: where_exp
----
-
-{% since %}v10.12.0{% endsince %}
-
-从数组中选择所有表达式值为真的对象。下面的例子中，假设你要从产品列表中筛选出来厨房用品。利用 `where_exp` 可以创建一个只包含 `"type"` 为 `"kitchen"` 的列表。
-
-输入
-```liquid
-All products:
-{% for product in products %}
-- {{ product.title }}
-{% endfor %}
-
-{% assign kitchen_products = products | where_exp: "item", "item.type == 'kitchen'" %}
-
-Kitchen products:
-{% for product in kitchen_products %}
-- {{ product.title }}
-{% endfor %}
-```
-
-输出
-```text
-All products:
-- Vacuum
-- Spatula
-- Television
-- Garlic press
-
-Kitchen products:
-- Spatula
-- Garlic press
-```
-
-[truthy]: ../tutorials/truthy-and-falsy.html
diff --git a/docs/source/zh-cn/filters/xml_escape.md b/docs/source/zh-cn/filters/xml_escape.md
deleted file mode 100644
index 3fa6d7014..000000000
--- a/docs/source/zh-cn/filters/xml_escape.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: xml_escape
----
-
-{% since %}v10.13.0{% endsince %}
-
-把文本做 XML 转义。
-
-输入
-```liquid
-{{ "Have you read \'James & the Giant Peach\'?" | xml_escape }}
-```
-
-输出
-```text
-Have you read &#39;James &amp; the Giant Peach&#39;?
-```
diff --git a/docs/source/zh-cn/index.pug b/docs/source/zh-cn/index.pug
deleted file mode 100644
index 5d1fa0ca5..000000000
--- a/docs/source/zh-cn/index.pug
+++ /dev/null
@@ -1,29 +0,0 @@
-layout: index
-description: LiquidJS 是一个纯 JavaScript 实现的，简洁的、安全的模板引擎，兼容 Shopify / Github Pages。
-subtitle: 简单安全的 Liquid 模板引擎
----
-ul#intro-feature-list
-  li.intro-feature-wrap
-    .intro-feature
-      .intro-feature-icon
-        i.icon-shield
-      h3.intro-feature-title 安全渲染
-      p.intro-feature-desc Liquid 模板有很强的可读性和容错性，适用于开放给设计师和客户。运算符和表达式都先解析到 AST 再去渲染，避免了 #[code eval] 和 #[code new Function]。
-  li.intro-feature-wrap
-    .intro-feature
-      .intro-feature-icon
-        i.icon-rocket
-      h3.intro-feature-title 纯 JavaScript
-      p.intro-feature-desc 纯 JavaScript 的没有 Native Binding 的 Liquid 实现，Node.js 和浏览器通用。同时提供了 CDN 可用的 CMD, ESM 和 CJS 打包。
-  li.intro-feature-wrap
-    .intro-feature
-      .intro-feature-icon
-        i.icon-shopify
-      h3.intro-feature-title Shopify 兼容
-      p.intro-feature-desc 支持 #[a(href="https://github.com/shopify/liquid") shopify/liquid] 的所有标签和过滤器，#[a(href="https://jekyllrb.com/") Jekyll 站点], #[a(href="https://pages.github.com/") Github Pages] 和 #[a(href="https://themes.shopify.com/") Shopify 模板] 都可以轻松迁移到 Node.js。
-  li.intro-feature-wrap
-    .intro-feature
-      .intro-feature-icon
-        i.icon-typescript
-      h3.intro-feature-title TypeScript
-      p.intro-feature-desc 整个项目在 TypeScript strict 模式下重写，让这个库拥有顺滑的使用体验，同时确保了一致的 API 和实时的、精确的文档。
diff --git a/docs/source/zh-cn/manifest.json b/docs/source/zh-cn/manifest.json
deleted file mode 100644
index 596469ec5..000000000
--- a/docs/source/zh-cn/manifest.json
+++ /dev/null
@@ -1,58 +0,0 @@
-{
-  "short_name": "LiquidJS",
-  "name": "LiquidJS",
-  "description": "LiquidJS 是一个简单的、安全的、兼容 Shopify 的、纯 JavaScript 编写的模板引擎。",
-  "icons": [
-    {
-      "src": "/icon/apple-touch-icon-57x57.png",
-      "type": "image/png",
-      "sizes": "57x57"
-    },
-    {
-      "src": "/icon/favicon-96x96.png",
-      "type": "image/png",
-      "sizes": "96x96"
-    },
-    {
-      "src": "/icon/favicon-196x196.png",
-      "type": "image/png",
-      "sizes": "196x196"
-    },
-    {
-      "src": "/icon/apple-touch-icon.png",
-      "type": "image/png",
-      "sizes": "512x512"
-    }
-  ],
-  "shortcuts" : [
-    {
-      "name": "教程",
-      "url": "/zh-cn/tutorials/intro-to-liquid.html",
-      "description": "一系列描述如何使用 LiquidJS 的文章"
-    },
-    {
-      "name": "标签",
-      "url": "/zh-cn/tags/overview.html",
-      "description": "每个 Liquid 标签的描述和示例"
-    },
-    {
-      "name": "过滤器",
-      "url": "/zh-cn/filters/overview.html",
-      "description": "每个 Liquid 过滤器的描述和示例"
-    },
-    {
-      "name": "演示",
-      "url": "/zh-cn/playground.html",
-      "description": "一个用来尝试和分享 Liquid 模板的在线编辑器"
-    },
-    {
-      "name": "API",
-      "url": "/api/classes/Liquid.html",
-      "description": "LiquidJS 类和接口的 TypeScript 文档"
-    }
-  ],
-  "start_url": "/zh-cn",
-  "display": "standalone",
-  "theme_color": "#0f83ce",
-  "background_color": "#0f83ce"
-}
diff --git a/docs/source/zh-cn/playground.pug b/docs/source/zh-cn/playground.pug
deleted file mode 100644
index 4fc10b206..000000000
--- a/docs/source/zh-cn/playground.pug
+++ /dev/null
@@ -1,5 +0,0 @@
----
-layout: playground
-title: 演示
-description: 一个用来尝试和分享 Liquid 模板的在线编辑器
----
diff --git a/docs/source/zh-cn/tags/assign.md b/docs/source/zh-cn/tags/assign.md
deleted file mode 100644
index 3b7382bfe..000000000
--- a/docs/source/zh-cn/tags/assign.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-title: Assign
----
-
-{% since %}v1.9.1{% endsince %}
-
-创建一个新变量。
-
-输入
-```liquid
-{% assign my_variable = false %}
-{% if my_variable != true %}
-  This statement is valid.
-{% endif %}
-```
-
-输出
-```text
-This statement is valid.
-```
-
-用引号（`"`）包起来表示一个字符串。
-
-输入
-```liquid
-{% assign foo = "bar" %}
-{{ foo }}
-```
-
-输出
-```text
-bar
-```
diff --git a/docs/source/zh-cn/tags/capture.md b/docs/source/zh-cn/tags/capture.md
deleted file mode 100644
index 0d6927bff..000000000
--- a/docs/source/zh-cn/tags/capture.md
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: capture
----
-
-{% since %}v1.9.1{% endsince %}
-
-把 `capture` 开闭标签之间的内容渲染后赋值给一个变量，这个变量的类型总是字符串。
-
-输入
-```liquid
-{% capture my_variable %}I am being captured.{% endcapture %}
-{{ my_variable }}
-```
-
-输出
-```text
-I am being captured.
-```
-
-在 `capture` 里可以使用 `assign` 创建的其他变量来构建复杂字符串：
-
-输入
-```liquid
-{% assign favorite_food = "pizza" %}
-{% assign age = 35 %}
-
-{% capture about_me %}
-I am {{ age }} and my favorite food is {{ favorite_food }}.
-{% endcapture %}
-
-{{ about_me }}
-```
-
-输出
-```text
-I am 35 and my favourite food is pizza.
-```
diff --git a/docs/source/zh-cn/tags/case.md b/docs/source/zh-cn/tags/case.md
deleted file mode 100644
index dba539c13..000000000
--- a/docs/source/zh-cn/tags/case.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: case
----
-
-{% since %}v1.9.1{% endsince %}
-
-创建一个 switch 语句，把变量跟不同的值比较。`case` 创建 switch 语句，`when` 比较它的值。
-
-输入
-```liquid
-{% assign handle = "cake" %}
-{% case handle %}
-  {% when "cake" %}
-     This is a cake
-  {% when "cookie", "biscuit" %}
-     This is a cookie
-  {% else %}
-     This is neither a cake nor a cookie
-{% endcase %}
-```
-
-输出
-```text
-This is a cake
-```
diff --git a/docs/source/zh-cn/tags/comment.md b/docs/source/zh-cn/tags/comment.md
deleted file mode 100644
index 7b9da4faa..000000000
--- a/docs/source/zh-cn/tags/comment.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-title: Comment
----
-
-{% since %}v1.9.1{% endsince %}
-
-让 Liquid 模板里一段代码不渲染。处于 `comment` 开闭标签之间的文本都不会输出，Liquid 代码都不会执行。
-
-输入
-```liquid
-Anything you put between {% comment %} and {% endcomment %} tags
-is turned into a comment.
-```
-
-输出
-```liquid
-Anything you put between  tags
-is turned into a comment.
-```
diff --git a/docs/source/zh-cn/tags/cycle.md b/docs/source/zh-cn/tags/cycle.md
deleted file mode 100644
index 931b027ca..000000000
--- a/docs/source/zh-cn/tags/cycle.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-title: cycle
----
-
-{% since %}v1.9.1{% endsince %}
-
-循环一组字符串按照它们传入的顺序打印出来。每次调用 `cycle` 打印下一个参数。
-
-## 基本使用
-
-输入
-```liquid
-{% cycle "one", "two", "three" %}
-{% cycle "one", "two", "three" %}
-{% cycle "one", "two", "three" %}
-{% cycle "one", "two", "three" %}
-```
-
-输出
-```text
-one
-two
-three
-one
-```
-
-`cycle` 可以用于：
-
-- 对表格里每一行按奇偶应用不同样式
-- 对每行最后一项应用特殊样式
-
-## 参数
-
-一个模板中需要多个 `cycle` 时可以使用 "cycle 组" 参数。如果没有提供组名，使用同样参数调用的 `cycle` 会被认为处于同一组。
-
-输入
-```liquid
-{% cycle "first": "one", "two", "three" %}
-{% cycle "second": "one", "two", "three" %}
-{% cycle "second": "one", "two", "three" %}
-{% cycle "first": "one", "two", "three" %}
-```
-
-输出
-```text
-one
-one
-two
-two
-```
diff --git a/docs/source/zh-cn/tags/decrement.md b/docs/source/zh-cn/tags/decrement.md
deleted file mode 100644
index dafa6f12d..000000000
--- a/docs/source/zh-cn/tags/decrement.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: Decrement
----
-
-{% since %}v1.9.1{% endsince %}
-
-创建一个新的数字类型的变量，每次调用都把它的值减一。第一次是 `-1`。
-
-输入
-```liquid
-{% decrement variable %}
-{% decrement variable %}
-{% decrement variable %}
-```
-
-输出
-```text
--1
--2
--3
-```
-
-像 [increment][increment] 一样，在 `decrement` 里声明的变量独立于 [assign][assign] 或 [capture][capture] 创建的变量。
-
-[increment]: ./increment.html
-[assign]: ./assign.html
-[capture]: ./capture.html
diff --git a/docs/source/zh-cn/tags/echo.md b/docs/source/zh-cn/tags/echo.md
deleted file mode 100644
index 3ec0dbf09..000000000
--- a/docs/source/zh-cn/tags/echo.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-title: Echo
----
-
-{% since %}v9.31.0{% endsince %}
-
-根据表达式输出渲染 HTML。和使用 `{{` expression `}}` 包裹模板效果一样，不同的是 echo 可以在 liquid 标签中使用，同时也支持过滤器。
-
-## echo
-
-输入
-```liquid
-{% assign username = 'Bob' %}
-{% echo username | append: ", welcome to LiquidJS!" | capitalize %}
-```
-
-输出
-```text
-Bob, welcome to LiquidJS!
-```
diff --git a/docs/source/zh-cn/tags/for.md b/docs/source/zh-cn/tags/for.md
deleted file mode 100644
index 474fdef94..000000000
--- a/docs/source/zh-cn/tags/for.md
+++ /dev/null
@@ -1,245 +0,0 @@
----
-title: For
----
-
-{% since %}v1.9.1{% endsince %}
-
-重复执行代码块的迭代标签。
-
-## 基本使用
-
-### for...in
-
-重复执行一段代码。
-
-输入
-```liquid
-{% for product in collection.products %}
-  {{ product.title }}
-{% endfor %}
-```
-
-输出
-```text
-hat shirt pants
-```
-
-### else
-
-指定 `for` 循环的集合长度为零时执行的代码块。
-
-输入
-```liquid
-{% for product in collection.products %}
-  {{ product.title }}
-{% else %}
-  The collection is empty.
-{% endfor %}
-```
-
-输出
-```text
-The collection is empty.
-```
-
-### break
-
-遇到 `break` 标签时 `for` 循环停止执行。
-
-输入
-```liquid
-{% for i in (1..5) %}
-  {%- if i == 4 -%}
-    {% break %}
-  {%- else -%}
-    {{ i }}
-  {%- endif -%}
-{% endfor %}
-```
-
-输出
-```text
-123
-```
-
-### continue
-
-遇到 `continue` 标签时跳过当前这次迭代。
-
-输入
-```liquid
-{% for i in (1..5) %}
-  {%- if i == 4 -%}
-    {%- continue -%}
-  {%- else -%}
-    {{ i }}
-  {%- endif -%}
-{% endfor %}
-```
-
-输出
-```text
-1235
-```
-
-### forloop
-
-在 `for` 循环里有一个 `forloop` 变量可用，用来表示迭代的当前状态。
-
-`forloop.first`, `forloop.last` 和 `forloop.length` 属性：
-
-输入
-```
-{% for i in (1..5) %}
-  {%- if forloop.first == true -%} First
-  {%- elsif forloop.last == true -%} Last
-  {%- else -%} {{ forloop.length }}
-  {%- endif %}
-{% endfor -%}
-```
-
-输出
-```
-First
-5
-5
-5
-Last
-```
-
-`forloop.index`, `forloop.index0`, `forloop.rindex` 和 `forloop.rindex0` 属性：
-
-输入
-```
-index index0 rindex rindex0
-{% for i in (1..5) %}
-  {{- forloop.index }}     {{ forloop.index0 }}      {{ forloop.rindex }}      {{ forloop.rindex0 }}
-{% endfor -%}
-```
-
-输出
-```
-index index0 rindex rindex0
-1     0      5      4
-2     1      4      3
-3     2      3      2
-4     3      2      1
-5     4      1      0
-```
-
-## 参数
-
-### limit
-
-限制循环执行的次数。
-
-输入
-```liquid
-<!-- if array = [1,2,3,4,5,6] -->
-{% for item in array limit:2 %}
-  {{- item -}}
-{% endfor %}
-```
-
-输出
-```text
-12
-```
-
-### offset
-
-从指定的下标处开始循环。
-
-输入
-```liquid
-<!-- for array = [1,2,3,4,5,6] -->
-{% for item in array offset:2 %}
-  {{- item -}}
-{% endfor %}
-```
-
-输出
-```text
-3456
-```
-
-#### offset:continue
-
-{% since %}v9.33.0{% endsince %}
-
-`offset` 的值可以是 `continue`，用来继续上一次循环。例如：
-
-输入
-```liquid
-<!-- for array = [1,2,3,4,5,6] -->
-{% for item in array limit:2 %}
-  {{- item -}}
-{% endfor%}
-{% for item in array offset:continue %}
-  {{- item -}}
-{% endfor%}
-```
-
-输出
-```text
-12
-3456
-```
-
-对同样的变量名和集合名（这个例子中是 `"item-array"`），存在唯一的位置记录。也就是说用新的变量名就可以开启一个新的循环：
-
-输入
-```liquid
-<!-- for array = [1,2,3,4,5,6] -->
-{% for item in array limit:2 %}
-  {{- item -}}
-{% endfor%}
-{% for item2 in array offset:continue %}
-  {{- item2 -}}
-{% endfor%}
-```
-
-输出
-```text
-12
-123456
-```
-
-### range
-
-定义一个用于循环的数字范围。可以用字面量定义范围，也可以用变量定义范围。
-
-输入
-```liquid
-{% for i in (3..5) %}
-  {{ i }}
-{% endfor %}
-
-{% assign num = 4 %}
-{% for i in (1..num) %}
-  {{ i }}
-{% endfor %}
-```
-
-输出
-```text
-3 4 5
-1 2 3 4
-```
-
-### reversed
-
-反转循环的顺序。注意这个参数的拼写和过滤器 `reverse` 不同。
-
-输入
-```liquid
-<!-- if array = [1,2,3,4,5,6] -->
-{% for item in array reversed %}
-  {{ item }}
-{% endfor %}
-```
-
-输出
-```text
-6 5 4 3 2 1
-```
diff --git a/docs/source/zh-cn/tags/if.md b/docs/source/zh-cn/tags/if.md
deleted file mode 100644
index 264f9e10a..000000000
--- a/docs/source/zh-cn/tags/if.md
+++ /dev/null
@@ -1,44 +0,0 @@
----
-title: If
----
-
-{% since %}v1.9.1{% endsince %}
-
-条件为 `true` 时执行某个代码块。
-
-## if
-
-输入
-```liquid
-{% if product.title == "Awesome Shoes" %}
-  These shoes are awesome!
-{% endif %}
-```
-
-输出
-```text
-These shoes are awesome!
-```
-
-## elsif / else
-
-在 `if` 或 [unless][unless] 块中添加更多的条件。
-
-输入
-```liquid
-<!-- If customer.name = "anonymous" -->
-{% if customer.name == "kevin" %}
-  Hey Kevin!
-{% elsif customer.name == "anonymous" %}
-  Hey Anonymous!
-{% else %}
-  Hi Stranger!
-{% endif %}
-```
-
-输出
-```text
-Hey Anonymous!
-```
-
-[unless]: ./unless.html
diff --git a/docs/source/zh-cn/tags/include.md b/docs/source/zh-cn/tags/include.md
deleted file mode 100644
index 59e993fc7..000000000
--- a/docs/source/zh-cn/tags/include.md
+++ /dev/null
@@ -1,110 +0,0 @@
----
-title: Include
----
-
-{% since %}v1.9.1{% endsince %}
-
-{% note warn 已废弃 %}
-这个标签已经废弃，请使用封装更好的 <a href="./render.html">render</a> 标签。
-{% endnote %}
-
-## 引入一个模板
-
-从模板 [根路径][root] 引入一个模板：
-
-```liquid
-{% include 'footer.liquid' %}
-```
-
-设置 [extname][extname] 选项为 `".liquid"` 后上面的 `.liquid` 后缀就可以省略了，等价于：
-
-```liquid
-{% include 'footer' %}
-```
-
-通过 `include` 渲染一个子模板时，它内部的代码可以访问父模板的变量，但父模板中不能访问它里面定义的变量。
-
-## 变量传递
-
-父模板里定义的变量可以通过 `include` 标签的参数列表传递给子模板：
-
-```liquid
-{% assign my_variable = 'apples' %}
-{% include 'name', my_variable: my_variable, my_other_variable: 'oranges' %}
-```
-
-## `with` 参数
-
-使用 `with...as` 语法可以给子模板传递一个变量：
-
-```liquid
-{% assign featured_product = all_products['product_handle'] %}
-{% include 'product' with featured_product as product %}
-```
-
-上面的例子中，子模板中 `product` 会保有父模板中的 `featured_product` 变量的值。
-
-## 输出和过滤器
-
-文件名为字符串字面量时，支持 Liquid 输出和过滤器。在拼接文件名时很方便：
-
-```liquid
-{% include "prefix/{{name | append: \".html\"}}" %}
-```
-
-{% note info 转义 %}
-字符串字面量里的 `"` 需要转义为 `\"`，使用静态文件名可以避免这个问题，见下面的 Jekyll-like 文件名。
-{% endnote %}
-
-## Jekyll-like 文件名
-
-设置 [dynamicPartials][dynamicPartials] 为 `false` 来启用 Jekyll-like 文件名，这时文件名不需要用引号包含，会被当作字面量处理。 这样的字符串里面仍然支持 Liquid 输出和过滤器，例如：
-
-```liquid
-{% include prefix/{{ page.my_variable }}/suffix %}
-```
-
-这样文件名里的 `"` 就不用转义了。
-
-```liquid
-{% include prefix/{{name | append: ".html"}} %}
-```
-
-## Jekyll include
-
-{% since %}v9.33.0{% endsince %}
-
-[jekyllInclude][jekyllInclude] 用来启用 Jekyll-like include 语法。默认为 `false`，当设置为 `true` 时：
-
-- 默认启用静态文件名：`dynamicPartials` 的默认值变为 `false`（而非 `true`）。但你也可以把它设置回 `true`。
-- 参数的键和值之间由 `=` 分隔（本来是 `:`）。
-- 参数放到了 `include` 变量下，而非当前作用域。
-
-例如下面的模板：
-
-```liquid
-{% include article.html header="HEADER" content="CONTENT" %}
-```
-
-其中 `article.html` 的内容是：
-
-```liquid
-<article>
-  <header>{{include.header}}</header>
-  {{include.content}}
-</article>
-```
-
-注意我们通过 `include.header` 引用第一个参数，而不是 `header`。输出如下：
-
-```html
-<article>
-  <header>HEADER</header>
-  CONTENT
-</article>
-```
-
-[extname]: /api/interfaces/LiquidOptions.html#extname
-[root]: /api/interfaces/LiquidOptions.html#root
-[dynamicPartials]: /api/interfaces/LiquidOptions.html#dynamicPartials
-[jekyllInclude]: /api/interfaces/LiquidOptions.html#jekyllInclude
diff --git a/docs/source/zh-cn/tags/increment.md b/docs/source/zh-cn/tags/increment.md
deleted file mode 100644
index 721491f29..000000000
--- a/docs/source/zh-cn/tags/increment.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-title: Increment
----
-
-{% since %}v1.9.1{% endsince %}
-
-创建一个新的数字类型的变量，每次调用都把它的值加一。第一次为 `0`。
-
-输入
-```liquid
-{% increment my_counter %}
-{% increment my_counter %}
-{% increment my_counter %}
-```
-
-输出
-```text
-0
-1
-2
-```
-
-在 `increment` 里声明的变量独立于 [assign][assign] 或 [capture][capture] 创建的变量。
-
-下面的例子中通过 `assign` 创建了变量 `var`。然后用 `increment` 标签在同名变量上多次递增。注意 `increment` 标签不会影响 `assign` 创建的 `var` 的值。
-
-输入
-```liquid
-{% assign var = 10 %}
-{% increment var %}
-{% increment var %}
-{% increment var %}
-{{ var }}
-```
-
-输出
-```text
-0
-1
-2
-10
-```
-
-[assign]: ./assign.html
-[capture]: ./capture.html
diff --git a/docs/source/zh-cn/tags/inline_comment.md b/docs/source/zh-cn/tags/inline_comment.md
deleted file mode 100644
index 5b688d51c..000000000
--- a/docs/source/zh-cn/tags/inline_comment.md
+++ /dev/null
@@ -1,50 +0,0 @@
----
-title: "#（单行注释）"
----
-
-{% since %}v9.38.0{% endsince %}
-
-在 Liquid 模板中添加注释，注释标签内的文字不会被输出。
-
-输入
-```liquid
-注释标签内的东西都不会输出。
-{% # this is an inline comment %}
-但每行都必须以 '#' 开头。
-{%
-  # this is a comment
-  # that spans multiple lines
-%}
-```
-
-输出
-```text
-注释标签内的东西都不会输出。
-但每行都必须以 '#' 开头。
-```
-
-在 <a href="./liquid.html">`liquid`</a> 标签里也可以使用注释标签。
-
-```liquid
-{% liquid
-  # required args
-  assign product = collection.products.first
-
-  # optional args
-  assign should_show_border = should_show_border | default: true
-  assign should_highlight = should_highlight | default: false
-%}
-```
-
-但注释标签不能用于把其他标签注释掉。这时应该使用 <a href="./comment.html">`comment`</a> 标签来临时禁用其他标签。
-
-输入
-```liquid
-{%- # {% echo 'Welcome to LiquidJS!' %} -%}
-{% comment %}{% echo 'Welcome to LiquidJS!' %}{% endcomment %}
-```
-
-输出
-```text
- -%}
-```
diff --git a/docs/source/zh-cn/tags/layout.md b/docs/source/zh-cn/tags/layout.md
deleted file mode 100644
index 79bfef443..000000000
--- a/docs/source/zh-cn/tags/layout.md
+++ /dev/null
@@ -1,66 +0,0 @@
----
-title: Layout
----
-
-{% since %}v1.9.1{% endsince %}
-
-## 使用布局模板
-
-套用模板 [根路径][root] 下的某个布局模板中。
-
-```liquid
-{% layout 'footer.liquid' %}
-```
-
-设置 [extname][extname] 选项为 `".liquid"` 后上面的 `.liquid` 后缀就可以省略了，等价于：
-
-```liquid
-{% layout 'footer' %}
-```
-
-通过 `layout` 渲染一个子模板时，它内部的代码可以访问父模板的变量，但父模板中不能访问它里面定义的变量。
-
-## 变量传递
-
-当前模板里定义的变量可以通过 `layout` 标签的参数列表传递给布局模板：
-
-```liquid
-{% assign my_variable = 'apples' %}
-{% layout 'name', my_variable: my_variable, my_other_variable: 'oranges' %}
-```
-
-## 块
-
-布局模板中可以包含若干 `block` 标签，这些 `block` 渲染时会按照子模板提供的内容进行填充。例如我们有布局模板 `default-layout.liquid`：
-
-```
-Header
-{% block content %}My default content{% endblock %}
-Footer
-```
-
-它被子模板 `page.liquid` 通过 `layout` 标签引用：
-
-```
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
-
-`page.liquid` 的渲染结果将会是：
-
-```
-Header
-My page content
-Footer
-```
-
-{% note tip 块 %}
-<ul>
-    <li>一个布局模板中可以定义多个块；</li>
-    <li>如果只有一个块，它的名字可以省略。</li>
-    <li>如果子模板未定义块的内容，将会使用父模板中提供的默认内容。</li>
-</ul>
-{% endnote %}
-
-[extname]: /api/interfaces/LiquidOptions.html#extname
-[root]: /api/interfaces/LiquidOptions.html#root
diff --git a/docs/source/zh-cn/tags/liquid.md b/docs/source/zh-cn/tags/liquid.md
deleted file mode 100644
index ca74ffec9..000000000
--- a/docs/source/zh-cn/tags/liquid.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-title: Liquid
----
-
-{% since %}v9.31.0{% endsince %}
-
-通过 liquid 标签可以在一个分隔符中使用多个标签, 使 Liquid 逻辑书写更简洁。
-
-## liquid
-
-输入
-```liquid
-{% liquid
-  assign names = 'Bob, Sally' | split: ', '
-
-  for name in names
-    echo 'Hello, ' | append: name
-    unless forloop.last
-      echo ', '
-    endunless
-  endfor
-%}
-```
-
-输出
-```text
-Hello, Bob, Hello Sally
-```
diff --git a/docs/source/zh-cn/tags/overview.md b/docs/source/zh-cn/tags/overview.md
deleted file mode 100644
index 3ca4a5881..000000000
--- a/docs/source/zh-cn/tags/overview.md
+++ /dev/null
@@ -1,18 +0,0 @@
----
-title: 标签
-description: 每个 Liquid 标签的描述和示例
----
-
-LiquidJS 支持 Liquid 语法中具体业务无关的标签，包含 [shopify/liquid 核心][shopify/liquid] 里的所有标签。这部分包含了所有 LiquidJS 支持的标签的文档和使用示例。
-
-LiquidJS 支持十几个过滤器，可以分为如下几类：
-
-类别 | 用途 | 标签
---- | --- | ---
-迭代 | 遍历一个集合 | for, cycle, tablerow
-控制流 | 控制模板渲染的执行分支 | if, unless, elif, else, case, when
-变量 | 定义和修改变量 | assign, increment, decrement, capture, echo
-文件 | 引入或继承其他模板 | render, include, layout
-语言 | 暂时禁用 Liquid 语法 | # (单行注释）, raw, comment, liquid
-
-[shopify/liquid]: https://github.com/Shopify/liquid
diff --git a/docs/source/zh-cn/tags/raw.md b/docs/source/zh-cn/tags/raw.md
deleted file mode 100644
index 71f7c4599..000000000
--- a/docs/source/zh-cn/tags/raw.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-title: Raw
----
-
-{% since %}v1.9.1{% endsince %}
-
-`raw` 标签可以暂时禁用 LiquidJS 的语法。生成和 Liquid 冲突的语言（比如 Nunjucks、Handlebars）时很有用。
-
-输入
-```liquid
-{% raw %}
-  In Handlebars, {{ this }} will be HTML-escaped, but
-  {{{ that }}} will not.
-{% endraw %}
-```
-
-输出
-```text
-In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
-```
diff --git a/docs/source/zh-cn/tags/render.md b/docs/source/zh-cn/tags/render.md
deleted file mode 100644
index c6eb95a60..000000000
--- a/docs/source/zh-cn/tags/render.md
+++ /dev/null
@@ -1,65 +0,0 @@
----
-title: Render
----
-
-{% since %}v9.2.0{% endsince %}
-
-## 基本使用
-
-### 渲染一个模板
-
-从模板 [根路径][root] 引入一个模板：
-
-```liquid
-{% render 'footer.liquid' %}
-```
-
-设置 [extname][extname] 选项为 `".liquid"` 后上面的 `.liquid` 后缀就可以省略了，等价于：
-
-```liquid
-{% render 'footer' %}
-```
-
-{% note info 变量作用域 %}
-通过 `render` 渲染一个子模板时，它内部的代码不能访问父模板的变量，父模板中也不能访问它里面定义的变量。这个封装会让模板代码更容易理解和维护。{% endnote %}
-
-### 变量传递
-
-父模板里定义的变量可以通过 `render` 标签的参数列表传递给子模板：
-
-```liquid
-{% assign my_variable = 'apples' %}
-{% render 'name', my_variable: my_variable, my_other_variable: 'oranges' %}
-```
-
-[全局变量][globals] 不需要传递，所有文件都可以访问它们。
-
-## 参数
-
-### `with` 参数
-
-使用 `with...as` 语法可以给子模板传递一个变量：
-
-```liquid
-{% assign featured_product = all_products['product_handle'] %}
-{% render 'product' with featured_product as product %}
-```
-
-上面的例子中，子模板中 `product` 会保有父模板中的 `featured_product` 变量的值。
-
-### `for` 参数
-
-用 `for...as` 语法可以对可枚举对象的每一个值渲染一次子模板：
-
-```liquid
-{% assign variants = product.variants %}
-{% render 'variant' for variants as variant %}
-```
-
-上面的例子中，对 `product` 的每个 `variants` 是指都会渲染一次子模板。子模板中 `variant` 变量会保有父模板中的 `product.variants` 中对应元素的值。
-
-{% note tip forloop 对象 %} 使用 for 参数时，在子模板中可以访问 <a href="./for.html#forloop">forloop</a> 对象。{% endnote %}
-
-[extname]: /api/interfaces/LiquidOptions.html#extname
-[root]: /api/interfaces/LiquidOptions.html#root
-[globals]: /api/interfaces/LiquidOptions.html#globals
diff --git a/docs/source/zh-cn/tags/tablerow.md b/docs/source/zh-cn/tags/tablerow.md
deleted file mode 100644
index 282223afb..000000000
--- a/docs/source/zh-cn/tags/tablerow.md
+++ /dev/null
@@ -1,130 +0,0 @@
----
-title: Table Row
----
-
-{% since %}v1.9.1{% endsince %}
-
-生成一个 HTML 表示，上下必须用 `<table>` 和 `</table>` HTML 标签包裹起来。
-
-## 基本使用
-
-输入
-```liquid
-<table>
-{% tablerow product in collection.products %}
-  {{ product.title }}
-{% endtablerow %}
-</table>
-```
-
-输出
-```html
-<table>
-  <tr class="row1">
-    <td class="col1">
-      Cool Shirt
-    </td>
-    <td class="col2">
-      Alien Poster
-    </td>
-    <td class="col3">
-      Batman Poster
-    </td>
-    <td class="col4">
-      Bullseye Shirt
-    </td>
-    <td class="col5">
-      Another Classic Vinyl
-    </td>
-    <td class="col6">
-      Awesome Jeans
-    </td>
-  </tr>
-</table>
-```
-
-## 参数
-
-### cols
-
-定义表格的列数。
-
-输入
-```liquid
-{% tablerow product in collection.products cols:2 %}
-  {{ product.title }}
-{% endtablerow %}
-```
-
-输出
-```html
-<table>
-  <tr class="row1">
-    <td class="col1">
-      Cool Shirt
-    </td>
-    <td class="col2">
-      Alien Poster
-    </td>
-  </tr>
-  <tr class="row2">
-    <td class="col1">
-      Batman Poster
-    </td>
-    <td class="col2">
-      Bullseye Shirt
-    </td>
-  </tr>
-  <tr class="row3">
-    <td class="col1">
-      Another Classic Vinyl
-    </td>
-    <td class="col2">
-      Awesome Jeans
-    </td>
-  </tr>
-</table>
-```
-
-### limit
-
-限制迭代次数。
-
-```liquid
-{% tablerow product in collection.products cols:2 limit:3 %}
-  {{ product.title }}
-{% endtablerow %}
-```
-
-### offset
-
-从指定的下标处开始循环。
-
-```liquid
-{% tablerow product in collection.products cols:2 offset:3 %}
-  {{ product.title }}
-{% endtablerow %}
-```
-
-### range
-
-定义一个用于循环的数字范围。可以用字面量定义范围，也可以用变量定义范围。
-
-```liquid
-<!--variable number example-->
-
-{% assign num = 4 %}
-<table>
-{% tablerow i in (1..num) %}
-  {{ i }}
-{% endtablerow %}
-</table>
-
-<!--literal number example-->
-
-<table>
-{% tablerow i in (3..5) %}
-  {{ i }}
-{% endtablerow %}
-</table>
-```
diff --git a/docs/source/zh-cn/tags/unless.md b/docs/source/zh-cn/tags/unless.md
deleted file mode 100644
index a76ed3121..000000000
--- a/docs/source/zh-cn/tags/unless.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-title: Unless
----
-
-{% since %}v1.9.1{% endsince %}
-
-和 `if` 相反 —— 条件 **不满足** 时执行代码块。
-
-输入
-```liquid
-{% unless product.title == "Awesome Shoes" %}
-  These shoes are not awesome.
-{% endunless %}
-```
-
-输出
-```text
-These shoes are not awesome.
-```
-
-等价于执行下面的代码：
-
-```liquid
-{% if product.title != "Awesome Shoes" %}
-  These shoes are not awesome.
-{% endif %}
-```
diff --git a/docs/source/zh-cn/tutorials/access-scope-in-filters.md b/docs/source/zh-cn/tutorials/access-scope-in-filters.md
deleted file mode 100644
index e93d0f184..000000000
--- a/docs/source/zh-cn/tutorials/access-scope-in-filters.md
+++ /dev/null
@@ -1,32 +0,0 @@
----
-title: 过滤器里访问上下文
----
-
-在 [注册过滤器和标签][register-filters] 里介绍过，可以在函数参数里直接获得过滤器的参数：
-
-```javascript
-// Usage: {{ 1 | add: 2, 3 }}
-// Output: 6
-engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)
-```
-
-但有些过滤器还需要访问当前上下文的变量，比如把 URL 路径转换为完整的 URL 时，需要访问上下文的 `origin` 变量：
-
-```javascript
-// Usage: {{ '/index.html' | fullURL }}
-// Scope: { origin: "https://liquidjs.com" }
-// Output: https://liquidjs.com/index.html
-
-engine.registerFilter('fullURL', function (path) {
-    const origin = this.context.get(['origin'])
-    return new URL(path, origin).toString() 
-})
-```
-
-见这个 JSFiddle：<http://jsfiddle.net/ctj364up/1/>。
-
-{% note warn 箭头函数 %}
-在箭头函数里 `this` 会绑定到当前 JavaScript 上下文，你需要用 `function(){}` 来替代 `()=>{}` 语法，才能正确地访问 `this.context`。
-{% endnote %}
-
-[register-filters]: /tutorials/register-filters-tags.html
diff --git a/docs/source/zh-cn/tutorials/caching.md b/docs/source/zh-cn/tutorials/caching.md
deleted file mode 100644
index 290d9b165..000000000
--- a/docs/source/zh-cn/tutorials/caching.md
+++ /dev/null
@@ -1,55 +0,0 @@
----
-title: 缓存
----
-
-在典型的网站项目中，同一个模板文件可能会反复地用不同数据去渲染。在生产环境下模板文件的内容不太会发生变化（除非重新部署了服务），因此可以把从磁盘读取的文件内容和解析得到的模板结构（AST）缓存下来重复使用来节省渲染时间。
-
-LiquidJS 在这一方面比较灵活，提供了多种不同的方式来达到提升性能的目的。
-
-## 手动缓存
-
-[.parse()][parse], [.parseFile()][parseFile], [.parseFileSync()][parseFileSync] API 可以用来把字符串或文件解析成模板。得到的模板可以用不同的数据去重复地渲染得到不同的 HTML。
-
-从字符串解析：
-
-```javascript
-var tpl = engine.parse('{{name | capitalize}}');
-
-engine.renderSync(tpl, {name: 'alice'}) // 'Alice'
-engine.renderSync(tpl, {name: 'bob'}) // 'Bob'
-```
-
-从文件解析：
-
-```javascript
-var tpl = engine.parseFileSync('hello');    // contents of `hello.liquid`: {{name}}
-
-engine.renderSync(tpl, {name: 'alice'}) // 'Alice'
-engine.renderSync(tpl, {name: 'bob'}) // 'Bob'
-```
-
-上述代码中字符串或文件只被解析了一次，可以反复利用去渲染不同的数据。有很多模板文件时可以把 `tpl` 变量存在 `Map` 中，后续再 `.render()` 时直接从 Map 中拿出解析好的模板去渲染。
-
-## `cache` 选项
-
-如果你只用 `.renderFile()` 和 `.renderFileSync()` 也可以直接设置 [cache][cache] 选项，LiquidJS 会帮你缓存。
-
-```javascript
-var { Liquid } = require('liquidjs');
-var engine = new Liquid({
-    cache: true
-});
-
-// LiquidJS 将会解析 hello.liquid 然后用 {name: 'alice'} 渲染它
-engine.renderFileSync('hello', {name: 'alice'})
-
-// LiquidJS 会找到上次 hello.liquid 解析的结果模板，再用 {name: 'bob'} 渲染它
-engine.renderFileSync('hello', {name: 'bob'})
-```
-
-[parse]: /api/classes/Liquid.html#parse
-[cache]: /api/interfaces/LiquidOptions.html#cache
-[parseFile]: /api/classes/Liquid.html#parseFile
-[parseFileSync]: /api/classes/Liquid.html#parseFileSync
-[renderFile]: /api/classes/Liquid.html#renderFile
-[renderFileSync]: /api/classes/Liquid.html#renderFileSync
diff --git a/docs/source/zh-cn/tutorials/contribution-guidelines.md b/docs/source/zh-cn/tutorials/contribution-guidelines.md
deleted file mode 100644
index b5bc98875..000000000
--- a/docs/source/zh-cn/tutorials/contribution-guidelines.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-title: 贡献指南
----
-
-## Star LiquidJS 👉👉👉 [![harttle/liquidjs](https://img.shields.io/github/stars/harttle/liquidjs?style=flat-square)][liquidjs]
-
-Star 是支持 LiquidJS 最重要的方式，也是最简单的方式：通过提升排名来让更多人了解 LiquidJS，让它得到更好的改进。
-
-## 发起 Pull Request
-
-开发和构建描述在这篇文档里 [CONTRIBUTING.md](https://github.com/harttle/liquidjs/blob/master/CONTRIBUTING.md)。
-
-**代码风格**：LiquidJS 采用 [standard](https://github.com/standard/eslint-config-standard) 和 [@typescript-eslint/recommended](https://github.com/typescript-eslint/typescript-eslint/blob/master/packages/eslint-plugin/src/configs/recommended.json) 规则。
-
-**测试**：确保你改动之后测试仍然可以通过 `npm test`
-
-**提交消息**：请遵守 [Angular 提交消息规范](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits)，尤其注意 [type 标识](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type)，semantic-release 机器人依赖这个标识自动发布。
-
-**向后兼容**：请考虑向后（之前的旧的版本）兼容。LiquidJS 被用于很多层的软件，包括底层库、编译器、站点生成器、 Web 服务器。对多数最终用户来说，驱动或请求整个系统做一次主版本升级是很难办到的。
-
-## 资金支持
-
-LiquidJS 是开源和免费的，但支持 [Open Collective][oc] 和 [Github Sponsors](https://github.com/sponsors/harttle) 赞助，请通过 Twitter (harttleharttle) 或邮件 (harttleharttle at gmail) 联系我，把您加到 [贡献者列表](https://github.com/harttle/liquidjs#contributors-) 中。
-
-[oc]: https://opencollective.com/liquidjs/
-[shopify/liquid]: https://shopify.github.io/liquid/
-[caniuse-promises]: http://caniuse.com/#feat=promises
-[pp]: https://github.com/taylorhakes/promise-polyfill
-[tutorial]: https://shopify.github.io/liquid/basics/introduction/
-[liquidjs]: https://github.com/harttle/liquidjs
diff --git a/docs/source/zh-cn/tutorials/differences.md b/docs/source/zh-cn/tutorials/differences.md
deleted file mode 100644
index 9cdf3b22d..000000000
--- a/docs/source/zh-cn/tutorials/differences.md
+++ /dev/null
@@ -1,58 +0,0 @@
----
-title: 和 Shopify/liquid 的区别
----
-
-## 兼容性
-
-LiquidJS 一直很重视兼容于 Ruby 版本的 Liquid。Liquid 模板语言最初由 [Ruby 实现][ruby-liquid]，用于 Shopify，Jekyll 以及 Github Pages，它是 Ruby 里最流行的模板引擎之一。因此由很多人用 LiquidJS 来渲染他们的 Shopify 主题和 Jekyll 站点。
-
-所以“兼容”意味着让这些开发者有很好的使用体验：
-
-- **LiquidJS 应当能够渲染语法正确的 Liquid 模板**。例如 `forloop.index` 应该是 1 开始的下表，`nil` 应该渲染成空字符串而不是 `undefined` 等。即使有些功能（例如 [#236][#236]）用 JavaScript 很难实现，但至少 LiquidJS 会尝试实现所有的 Liquid 语义。
-- **所有 [shopify/liquid][ruby-liquid] 里的标签和过滤器 LiquidJS 都要实现**。这之外有些业务逻辑相关的标签/过滤器尤其是 Shopify 平台上的那些，应该维护在 [插件][plugins] 里。但是这其中有一些很有用的标签（比如 `{% layout %}`）LiquidJS 也会考虑实现，可以去开个 Issue 讨论一下。
-
-同时，既然现在用 JavaScript 实现了，那 Liquid 应该有更强的功能：
-
-* **完全支持异步**。所有过滤器和标签都可以实现为异步，只需要返回 `Promise` 即可。
-* **同时支持同步**。对一些非 I/O 密集的场景，同步渲染会更快。只要模板包含的标签和过滤器都支持同步，你就可以调用类似 `.renderSync()` 这样的 API。所有内置标签和过滤器都同时支持同步和异步。
-* **[抽象文件系统][afs]**。和异步功能一起使用，LiquidJS 可以实现渲染数据库里的模板 [#414][#414]，远程 HTTP 服务器上的模板 [#485][#485]，等等。
-* **额外的标签和过滤器**。比如 `layout` 和 `json`。
-
-## 区别
-
-[Shopify/liquid][ruby-liquid] 中的所有标签和过滤器 LiquidJS 都支持，但不包括 Shopify 主题中业务逻辑相关的标签和过滤器（如果你在找这些标签可以参考 [插件列表][plugins]，也欢迎把你的插件添加到列表中）。尽管原则上我们尽力兼容于 Shopify/liquid，但仍然存在一些区别：
-
-* 真和假。在 LiquidJS 中 `undefined`, `null`, `false` 是假，之外的都是真；在 Ruby 中 `nil` 和 `false` 是假，其他都是真。见 [#26][#26]。
-* 数字。JavaScript 不区分浮点数和整数，因此缺失一部分整数算术，见 [#59][#59]。此外 `size` 过滤器作用于数字时总是返回零，而不是 Ruby 中的浮点数或整数的内存大小。
-* 输出字符串。基本类型的输出已经和 Shopify/liquid 对齐，但是仍然存在一些区别。比如在 Shopify/liquid 中 `strip` 会返回 inspect 字符串，但 LiquidJS `strip` 只是简单地把输入转换为字符串 [#852][#852]。
-* Drop 中的 [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) 替换为 `.toLiquid()`。
-* 数据的 [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) 替换为 `.toString()`。
-* 对象的迭代顺序。JavaScript 对象的迭代顺序是插入顺序和数字键递增顺序的组合，但 Ruby Hash 中只是插入顺序（JavaScript 字面量 Object 和 Ruby 字面量 Hash 的插入顺序解释也不同）。
-* 排序稳定性。shopify/liquid 和 LiquidJS 都没有定义 [sort][sort] 过滤器的稳定性在，它取决于 Ruby/JavaScript 内置的排序算法，在 Node.js 12+ 和 Google Chrome 70+ LiquidJS 的排序是 [稳定的][stable-sort]。
-* shopify/liquid 允许过滤器尾部的未匹配字符，但 LiquidJS 不允许。这就是说如果过滤器参数前忘记写冒号比如 `{%raw%}{{ "a b" | split " "}}{%endraw%}` LiquidJS 会抛出异常。这是为了提升 Liquid 模板的易用性，参考 [#208][#208] 和 [#212][#212]。
-* LiquidJS 比 [Liquid 语言][liquid] 有更多的标签和过滤器：
-    * LiquidJS 自己定义的标签：[layout][layout]、[render][render] 和相应的 `block`。
-    * LiquidJS 自己定义的过滤器：[json][json]。
-    * 从 [Shopify][shopify-tags] 借来的不依赖 Shopify 平台的标签/过滤器。
-    * 从 [Jekyll][jekyll-filters] 借来的不依赖 Jekyll 框架的标签/过滤器。
-* 有些过滤器和标签表现不同：比如 [date][date]，非法的标签（比如重复的 `else`，`endif` 的多余参数）在 LiquidJS 中会抛出异常。
-
-[layout]: ../tags/layout.html
-[render]: ../tags/render.html
-[json]: https://liquidjs.com/filters/json.html
-[#26]: https://github.com/harttle/liquidjs/pull/26
-[#59]: https://github.com/harttle/liquidjs/issues/59
-[#208]: https://github.com/harttle/liquidjs/issues/208
-[#212]: https://github.com/harttle/liquidjs/issues/212
-[#236]: https://github.com/harttle/liquidjs/issues/236
-[#414]: https://github.com/harttle/liquidjs/discussions/414
-[#485]: https://github.com/harttle/liquidjs/discussions/485
-[#852]: https://github.com/harttle/liquidjs/discussions/852
-[sort]: https://liquidjs.com/filters/sort.html
-[stable-sort]: https://v8.dev/features/stable-sort
-[plugins]: ./plugins.html#插件列表
-[ruby-liquid]: https://github.com/Shopify/liquid
-[afs]: https://liquidjs.com/tutorials/render-file.html#Abstract-File-System
-[liquid]: https://shopify.github.io/liquid/basics/introduction/
-[shopify-tags]: https://shopify.dev/docs/api/liquid/tags
-[jekyll-filters]: https://jekyllrb.com/docs/liquid/filters/
diff --git a/docs/source/zh-cn/tutorials/drops.md b/docs/source/zh-cn/tutorials/drops.md
deleted file mode 100644
index 7f41c8bd9..000000000
--- a/docs/source/zh-cn/tutorials/drops.md
+++ /dev/null
@@ -1,201 +0,0 @@
----
-title: Liquid Drop
----
-
-LiquidJS 还提供了一种类似于 [Shopify Drop][shopify-drops] 的机制，用于为模板作者提供在自定义解析变量值的功能。
-
-{% note info JavaScript 中的 Drop %}
-<em>Drop</em> 接口在 LiquidJS 中实现方式与内置过滤器和其他模板功能不同。由于 LiquidJS 在 JavaScript 中运行，自定义 Drop 在 JavaScript 中一定需要重新实现。JavaScript 类与 Ruby 类之间没有兼容性可言。
-{% endnote %}
-
-## 基本用法
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-class SettingsDrop extends Drop {
-  constructor() {
-    super()
-    this.foo = 'FOO'
-  }
-  bar() {
-    return 'BAR'
-  }
-}
-
-const engine = new Liquid()
-const template = `foo: {{settings.foo}}, bar: {{settings.bar}}`
-const context = { settings: new SettingsDrop() }
-// 输出: "foo: FOO, bar: BAR"
-engine.parseAndRender(template, context).then(html => console.log(html))
-```
-
-[Runkit 链接](https://runkit.com/embed/2is7di4mc7kk)
-
-如上所示，除了从上下文作用域中读取属性外，还可以调用方法。您只需创建一个继承自 `Drop` 的自定义类。
-
-{% note tip 异步方法 %}
-LiquidJS 完全支持异步，您可以在 Drop 的方法中安全地返回 Promise，或将 Drop 的方法定义为 `async`。
-{% endnote %}
-
-## liquidMethodMissing
-
-如果属性名不能静态地确定的情况下，可以利用 `liquidMethodMissing` 来动态解析变量的值。
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-class SettingsDrop extends Drop {
-  liquidMethodMissing(key) {
-    return key.toUpperCase()
-  }
-}
-
-const engine = new Liquid()
-// 输出: "COO"
-engine.parseAndRender("{{settings.coo}}", { settings: new SettingsDrop() })
-  .then(html => console.log(html))
-```
-
-`liquidMethodMissing` 支持 Promise，这意味着您可以在其中进行异步调用。一个更有用的例子是通过使用 Drop 动态地从数据库获取值。通过使用 Drop，您可以避免将每个属性都硬编码到上下文中。例如：
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-class DBDrop extends Drop {
-  async liquidMethodMissing(key) {
-    const record = await db.getRecordByKey(key)
-    return record.value
-  }
-}
-
-const engine = new Liquid()
-const context = { db: new DBDrop() }
-engine.parseAndRender("{{db.coo}}", context).then(html => console.log(html))
-```
-
-## valueOf
-
-Drop 可以实现一个 `valueOf()` 方法，用于在输出中替换自身。例如：
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-class ColorDrop extends Drop {
-  valueOf() {
-    return 'red'
-  }
-}
-
-const engine = new Liquid()
-const context = { color: new ColorDrop() }
-// 输出: "red"
-engine.parseAndRender("{{color}}", context).then(html => console.log(html))
-```
-
-## toLiquid
-
-`toLiquid()` 不是 `Drop` 的方法，但它可以用于返回一个 `Drop`。在您有一个上下文中固定结构且不能更改其值的情况下，您可以实现 `toLiquid()`，以便让 LiquidJS 使用返回的值而不是自身来渲染模板。
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-const context = {
-  person: {
-    firstName: "Jun",
-    lastName: "Yang",
-    name: "Jun Yang",
-    toLiquid: () => ({
-      firstName: this.firstName,
-      lastName: this.lastName,
-      // 使用不同的 `name`
-      name: "Yang, Jun"
-    })
-  }
-}
-
-const engine = new Liquid()
-// 输出: "Yang, Jun"
-engine.parseAndRender("{{person.name}}", context).then(html => console.log(html))
-```
-
-当然，您还可以在 `toLiquid()` 方法中返回一个 `PersonDrop` 实例，并在 `PersonDrop` 中实现此功能：
-
-```javascript
-import { Liquid, Drop } from 'liquidjs'
-
-class PersonDrop extends Drop {
-  constructor(person) {
-    super()
-    this.person = person
-  }
-  name() {
-    return this.person.lastName + ", " + this.person.firstName
-  }
-}
-
-const context = {
-  person: {
-    firstName: "Jun",
-    lastName: "Yang",
-    name: "Jun Yang",
-    toLiquid: function () { return new PersonDrop(this) }
-  }
-}
-
-const engine = new Liquid()
-// 输出: "Yang, Jun"
-engine.parseAndRender("{{person.name}}", context).then(html => console.log(html))
-```
-
-{% note info <code>toLiquid()</code> 和 <code>valueOf()</code> 的区别 %}
-<ul>
-    <li><code>valueOf()</code> 通常用来定义当前变量如何渲染，<code>toLiquid()</code> 通常用来把一个对象转换为 Drop 或另一个提供给模板的 scope。</li>
-    <li><code>valueOf()</code> 是 Drop 才有的方法；而 <code>toLiquid()</code> 可以用在任何 scope 对象上。</li>
-    <li><code>valueOf()</code> 是在自己即将被渲染时，用来替代自己；而 <code>toLiquid()</code> 在即将读取它的属性时才会被调用。</li>
-</ul>
-{% endnote %}
-
-## 特殊 Drop
-
-LiquidJS 本身实现了几个内置 Drop，以促进模板编写。此部分与 Shopify Liquid 兼容，因为我们需要模板具有可移植性。
-
-### blank
-
-用于检查字符串变量是否为 `false`、`null`、`undefined`、空字符串或字符串仅包含空白字符。
-
-```liquid
-{% unless author == blank %}
-    {{author}}
-{% endif %}
-```
-
-### empty
-
-用于检查数组、字符串或对象是否为空。
-
-```liquid
-{% if authors == empty %}
-    作者列表为空
-{% endif %}
-```
-
-{% note info <code>empty</code> 的实现 %}
-对于数组和字符串，LiquidJS 检查它们的 `.length` 属性。对于对象，LiquidJS 调用 `Object.keys()` 来检查它是否有键。
-{% endnote %}
-
-### nil
-
-`nil` Drop 用于检查变量是否未定义或定义为 `null` 或 `undefined`，本质上等同于 JavaScript 的 `== null` 检查。
-
-```liquid
-{% if notexist == nil %}
-    空变量
-{% endif %}
-```
-
-### 其他 Drop
-
-仍然有一些特定标签的 Drop，例如 `forloop`、`tablerowloop`、`block`，这些在各自的标签文档中有详细介绍。
-
-[shopify-drops]: https://github.com/Shopify/liquid/wiki/Introduction-to-Drops
diff --git a/docs/source/zh-cn/tutorials/escaping.md b/docs/source/zh-cn/tutorials/escaping.md
deleted file mode 100644
index 042bcc34e..000000000
--- a/docs/source/zh-cn/tutorials/escaping.md
+++ /dev/null
@@ -1,76 +0,0 @@
----
-title: 转义
----
-
-LiquidJS 种转义有两种含义：
-
-1. 输出语言的转义，即 HTML 转义。用来让输出的变量不包含 HTML 特殊字符，不影响 HTML 的结构，也就是输出 HTML 安全的字符串。
-2. 语言自己的转义，即 Liquid 转义。用来输出包含对于 Liquid 语言来说是特殊字符的字符串，比如你在使用 Liquid 模板语言来编写一篇介绍 Liquid 语法的文章时就会需要 Liquid 转义。
-
-## HTML 转义
-
-默认情况下输出是不转义的，但你可以用 [escape][escape] 过滤器来做 HTML 转义：
-
-输入
-```liquid
-{{ "1 < 2" | escape }}
-```
-
-输出
-```text
-1 &lt; 2
-```
-
-LiquidJS 也提供了其他过滤器来支持不同的转义需求：[escape_once][escape_once], [newline_to_br][newline_to_br], [strip_html][strip_html]。
-
-当输出的变量不被信任时，可以把 [outputEscape][outputEscape] 参数设置为 `"escape"` 来启用默认 HTML 转义。这种情况下，如果你需要某个输出不被转义，则需要使用 [raw][raw] 过滤器：
-
-输入
-```liquid
-{{ "1 < 2" }}
-{{ "<button>OK</button>" | raw }}
-```
-
-输出
-```text
-1 &lt; 2
-<button>OK</button>
-```
-
-## Liquid 转义
-
-为了输出 Liquid 的特殊字符比如 `{{` 和 `{%`，你需要 [raw][raw] 标签。
-
-输入
-```liquid
-{% raw %}
-  In LiquidJS, {{ this | escape }} will be HTML-escaped, but
-  {{{ that }}} will not.
-{% endraw %}
-```
-
-输出
-```text
-In LiquidJS, {{ this | escape }} will be HTML-escaped, but
-{{{ that }}} will not.
-```
-
-Within strings literals in LiquidJS template, `\` can be used to escape special characters in string syntax. For example:
-
-输入
-```liquid
-{{ "\"" }}
-```
-
-输出
-```liquid
-"
-```
-
-[outputEscape]: ./options.html#outputEscape
-[escape]: ../filters/escape.html
-[raw]: ../filters/raw.html
-[escape_once]: ../filters/escape.html
-[strip_html]: ../filters/strip_html.html
-[newline_to_br]: ../filters/newline_to_br.html
-[raw]: ../tags/raw.html
diff --git a/docs/source/zh-cn/tutorials/intro-to-liquid.md b/docs/source/zh-cn/tutorials/intro-to-liquid.md
deleted file mode 100644
index 2e9586561..000000000
--- a/docs/source/zh-cn/tutorials/intro-to-liquid.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-title: Liquid 模板语言
-description: Liquid 模板语言的介绍，和一些示例代码
----
-
-LiquidJS 是一个简单的、安全的、兼容 Shopify 的、纯 JavaScript 编写的模板引擎。这个项目的目的是为 JavaScript 社区提供一个 Liquid 模板引擎的实现。Liquid 最初用 Ruby 实现并用于 Github Pages, Jekyll 和 Shopify，参考 [和 Shopify/liquid 的区别][diff]。
-
-LiquidJS 语法相对简单。LiquidJS 中有两种标记：
-
-- **标签**。标签由标签名和参数构成，由 `{%raw%}{%{%endraw%}` 和 `%}` 包裹。
-- **输出**。输出由一个值和一组可选的过滤器构成，由 `{%raw%}{{{%endraw%}` 和 `}}` 包裹。
-
-{% note info 在线示例 %}
-在进一步了解细节之前，这里有一个在线示例：<https://liquidjs.com/playground.html>。
-{% endnote %}
-
-## 输出
-
-**输出** 用于转换和输出变量到 HTML。下面的模板将会把 `username` 的值插入到 input 的 `value`：
-
-```liquid
-<input type="text" name="user" value="{{username}}">
-```
-
-*输出* 里的值可以在输出之前经过若干个 **过滤器** 的转换。比如在变量后面追加一个字符串：
-
-```liquid
-{{ username | append: ", welcome to LiquidJS!" }}
-```
-
-过滤器可以级联，用起来像管道一样：
-
-```liquid
-{{ username | append: ", welcome to LiquidJS!" | capitalize }}
-```
-
-[这里](../filters/overview.html) 是 LiquidJS 支持的完整的过滤器列表。
-
-## 标签
-
-**标签** 用于控制模板渲染过程，操作模板变量，和其他模板交互等。例如 `assign` 可以用来定义一个模板中可以使用的变量：
-
-```liquid
-{% assign foo = "FOO" %}
-```
-
-一般标签成对地出现，一个开始标签和一个对应的结束标签，比如：
-
-```liquid
-{% if foo == "FOO" %}
-    Variable `foo` equals "FOO"
-{% else %}
-    Variable `foo` not equals "FOO"
-{% endif %}
-```
-
-[这里](../tags/overview.html) 是 LiquidJS 支持的完整的标签列表。
-
-[shopify/liquid]: https://github.com/Shopify/liquid
-[diff]: ./differences.html
diff --git a/docs/source/zh-cn/tutorials/migrate-to-9.md b/docs/source/zh-cn/tutorials/migrate-to-9.md
deleted file mode 100644
index 76950dbf7..000000000
--- a/docs/source/zh-cn/tutorials/migrate-to-9.md
+++ /dev/null
@@ -1,29 +0,0 @@
----
-title: 迁移到 LiquidJS 9
----
-
-LiquidJS 9 有一些基础性的改进，包括一些缺陷修复、新特性、性能提升，也有一些不兼容的变更。
-
-## 新特性
-
-* 同步渲染：新增了 renderSync, parseAndRenderSync, renderFileSync API
-* 新的工具：Expression 和 Tokenizer
-
-## 修复
-
-* 布尔逻辑运算顺序，见 [#130](https://github.com/harttle/liquidjs/issues/130)；
-* `break` 和 `continue` 会忽略它们之前的代码，见 [#123](https://github.com/harttle/liquidjs/issues/123)；
-* React.js 示例无法正确 yarn install，见 [#145](https://github.com/harttle/liquidjs/issues/145)；
-* 有时没有正确地等待 Promise 类型的 Drops。
-
-## 性能
-
-* 目标平台提升到 Node.js 8 引起的性能提升（去掉了一些 Polyfill），见 [#137](https://github.com/harttle/liquidjs/issues/137)；
-* 内存使用降低了 57.5%，见 [#202](https://github.com/harttle/liquidjs/pull/202)；
-* 渲染性能提升了 100.3%，见 [#205](https://github.com/harttle/liquidjs/pull/205)。
-
-## 不兼容的变更
-
-* LiquidJS 不再有默认导出了，以后要使用 `import {Liquid} from 'liquidjs'` 语法。使用 UMD 包里的 `window.Liquid` 也需要改为 `window.liquidjs.Liquid`；
-* 移除了重复的静态方法 `Liquid.evalValue`，统一使用示例方法 `liquid.evalValue`；
-* 支持的最低目标平台为 Node.js 8，CJS 包（Node.js 下的主入口）不再支持 Node.js &leq; 6 了，ESM（dist/liquid.browser.esm.js）和 UMD（dist/liquid.browser.umd.js, dist/liquid.browser.min.js）包不受影响。
\ No newline at end of file
diff --git a/docs/source/zh-cn/tutorials/operators.md b/docs/source/zh-cn/tutorials/operators.md
deleted file mode 100644
index 68fe1a4d0..000000000
--- a/docs/source/zh-cn/tutorials/operators.md
+++ /dev/null
@@ -1,68 +0,0 @@
----
-title: 运算符
----
-
-LiquidJS 运算符非常简单也很特别，只支持两类运算符：
-
-* 比较运算符：`==`, `!=`, `>`, `<`, `>=`, `<=`
-* 逻辑运算符：`not`, `or`, `and`, `contains`
-
-因此普通的数学运算是不支持的，比如 `{% raw %}{{a + b}}{% endraw %}`。它的替代方案是过滤器 `{% raw %}{{ a | plus: b}}{% endraw %}`。事实上 `+` 在 LiquidJS 中是一个合法的变量名。
-
-## 逻辑运算符
-
-### not
-
-对条件取反。如果条件为假则返回 `true`，如果条件为真则返回 `false`。
-
-输入
-```liquid
-{% if not user.active %}
-  用户未激活
-{% endif %}
-```
-
-### and
-
-当两个条件都为真时返回 `true`。
-
-输入
-```liquid
-{% if user.age >= 18 and user.verified %}
-  允许访问
-{% endif %}
-```
-
-### or
-
-当至少一个条件为真时返回 `true`。
-
-输入
-```liquid
-{% if user.isAdmin or user.isModerator %}
-  您拥有提升的权限
-{% endif %}
-```
-
-### contains
-
-检查字符串是否包含子字符串，或数组是否包含元素。
-
-输入
-```liquid
-{% if product.title contains "Pack" %}
-  这是一个套装
-{% endif %}
-```
-
-## 优先级
-
-1. 比较运算符和 `contains`。所有比较运算符和 `contains` 具有同样的（最高）优先级。
-2. `not` 运算符。它的优先级略高于 `or` 和 `and`。
-3. `or` 和 `and` 运算符。这些逻辑运算符具有同样的（最低）优先级。
-
-## 结合性
-
-逻辑运算符是右结合的，所以连续的逻辑运算时计算顺序是从右向左，参考 [Shopify][operator-order] 的文档。
-
-[operator-order]: https://help.shopify.com/en/themes/liquid/basics/operators#order-of-operations
diff --git a/docs/source/zh-cn/tutorials/options.md b/docs/source/zh-cn/tutorials/options.md
deleted file mode 100644
index a69442039..000000000
--- a/docs/source/zh-cn/tutorials/options.md
+++ /dev/null
@@ -1,159 +0,0 @@
----
-title: 选项
----
-
-[Liquid][liquid] 构造函数接受一个参数对象，用来定义各种模板引擎行为。这些参数都是可选的，比如我可以指定其中一个参数 `cache`：
-
-```javascript
-const { Liquid } = require('liquidjs')
-const engine = new Liquid({
-    cache: true
-})
-```
-
-{% note info API 文档 %}
-下面的所有选项的概述，希望了解具体的类型和签名，请前往 <a href="https://liquidjs.com/api/interfaces/LiquidOptions.html" target="_self">LiquidOptions | API</a>.
-{% endnote %}
-
-## 缓存
-
-**cache** 用来指定是否缓存曾经读取和处理过的模板来提升性能。在生产环境模板会重复渲染的情况会很有用。
-
-默认是 `false`，当设置为 `true` 时会启用一个大小为 1024 的 LRU 缓存。当然也可以传一个数字来指定缓存大小。此外还可以是一个自定义的缓存实现，LiquidJS 会通过它来查找和读写文件。详情请参考 [Caching][caching]。
-
-## 布局和片段
-
-**root** 用来指定 LiquidJS 查找和读取模板的根目录。可以是单个字符串，也可以是一个数组 LiquidJS 会顺序查找。详情请参考 [Render Files][render-file]。
-
-**layouts** 和 `root` 具有一样的格式，用来指定 `{% layout %}` 所使用的目录。没有指定时默认为 `root`。
-
-**partials** 和 `root` 具有一样的格式，用来指定 `{% render %}` 和 `{% include %}` 所使用的目录。没有指定时默认为 `root`。
-
-**relativeReference** 默认为 `true` 用来允许以相对路径引用其他文件。注意被引用的文件仍然需要在对应的 root 目录下。例如可以这样引用一个文件 `{% render ../foo/bar %}`，但需要确保 `../foo/bar` 处于 `partials` 目录下。
-
-## 动态引用
-
-> 注意由于历史原因这个选项叫做 dynamicPartials，但它对 layout 也起作用。
-
-**dynamicPartials** 表示是否把传给 [include][include], [render][render], [layout][layout] 标签的文件名当做变量处理。默认为 `true`。例如用上下文 `{ file: 'foo.html' }` 渲染下面的模板将会引入文件 `foo.html`：
-
-```liquid
-{% include file %}
-```
-
-设置 `dynamicPartials: false` 后 LiquidJS 将会尝试去读取 `file`。当你的模板之间都是静态引入关系时会很有用：
-
-```liquid
-{% liquid foo.html %}
-```
-
-{% note warn 常见陷阱 %}
-LiquidJS 把这个选项默认值设为 <code>true</code> 以兼容于 shopify/liquid，但如果你在使用 <a href="https://github.com/11ty/eleventy" target="_blank">eleventy</a> 它会设置默认值 <code>false</code> （参考 <a href="https://www.11ty.dev/docs/languages/liquid/#quoted-include-paths" target="_blank">Quoted Include Paths</a>）以兼容于 Jekyll。{% endnote %}
-
-## Jekyll include
-
-{% since %}v9.33.0{% endsince %}
-
-[jekyllInclude][jekyllInclude] 用来启用 Jekyll-like include 语法。默认为 `false`，当设置为 `true` 时：
-
-- 默认启用静态文件名：`dynamicPartials` 的默认值变为 `false`（而非 `true`）。但你也可以把它设置回 `true`。
-- 参数的键和值之间由 `=` 分隔（本来是 `:`）。
-- 参数放到了 `include` 变量下，而非当前作用域。
-
-例如下面的模板中，`name.html` 没有带引号，`header` 和 `"HEADER"` 以 `=` 分隔，`header` 参数通过 `include.header` 来引用。更多详情请参考 [include][include]。
-
-```liquid
-// entry template
-{% include article.html header="HEADER" content="CONTENT" %}
-
-// article.html
-<article>
-  <header>{{include.header}}</header>
-  {{include.content}}
-</article>
-```
-
-## extname
-
-**extname** 定义了默认的文件后缀，当传入文件名不包含后缀时自动追加。默认值是 `''` 也就是说默认是禁用的。如果设置为 `.liquid`：
-
-```liquid
-{% render "foo" %}  没有后缀，添加 ".liquid" 并加载 foo.liquid
-{% render "foo.html" %} 已经有后缀了，直接加载 foo.html
-```
-
-{% note info 旧版行为 %}
-在 2.0.1 之前，<code>extname</code> 默认值为 `.liquid`。要禁用它需要明确设置为 <code>extname: ''</code>。详情参考 <a href="https://github.com/harttle/liquidjs/issues/41" target="_blank">#41</a>。
-{% endnote %}
-
-## fs
-
-**fs** 用来自定义文件系统实现，详情请参考 [Abstract File System][abstract-fs]。
-
-## globals
-
-**globals** 用来定义对所有模板可见的全局变量。包括 [render tag][render] 引入的子模板，见 [3185][185]。
-
-## jsTruthy
-
-**jsTruthy** 用来使用 Javascript 的真值判断，默认为 `false` 使用 Shopify 方式。
-
-例如，空字符串在 JavaScript 中为假（`jsTruthy` 为 `true` 时），在 Shopify 真值表中为真。
-
-## outputEscape
-
-[outputEscape][outputEscape] 用来自动转义输出。它的值可以是 `"escape"`、`"json"` 或 `(val: unknown) => string`，默认为 `undefined`。
-
-- 如果被输出的变量不被信任，可以设置 `outputEscape: "escape"` 来自动把它们 HTML 转义。如果要直接输出则需要使用 [raw][raw] 过滤器。
-- 如果你在用 LiquidJS 来生产 JSON 文件，可以设置为 `"json"`。
-- `outputEscape` 甚至可以是函数，你可以借此控制整个 LiquidJS 的变量输出。注意函数的输入不一定是字符串，因为过滤器的返回值可以不是字符串，你的函数将会接到这个值。
-
-## 时间日期和时区
-
-**timezoneOffset** 用来指定一个和你当地时区不同的时区，所有日期和时间输出时都转换到这个指定的时区。例如设置 `timezoneOffset: 0` 将会把所有日期按照 UTC/GMT 00:00 来输出。
-
-**preserveTimezones** 是一个布尔值，只影响时间戳字面量。当设置为 `true` 时，所有字面量的时间戳字符串会在输出时保持原状，即不论输入时采取怎样的时区，输出时仍然采用那一时区（和 Shopify Liquid 的行为一致）。注意这是一个解析器参数，渲染时传入的数据中的日期的输出不会受此参数影响。注意 `preserveTimezones` 比 `timezoneOffset` 的优先级更高。
-
-**dateFormat** 用于指定输出日期的默认格式. `%A, %B %-e, %Y at %-l:%M %P %z` 如果未指定，将使用. 例如，设置 `dateFormat: %Y-%m-%dT%H:%M:%S:%LZ` 以输出 [JavaSrcipt Date.toJson()][https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date/toJSON] 格式.
-
-## 换行和缩进
-
-**greedy**, **trimOutputLeft**, **trimOutputRight**, **trimTagLeft**, **trimTagRight** 选项用来移除 Liquid 语法周围的换行和缩进，详情请参考 [Whitespace Control][wc]。
-
-## 自定义分隔符
-
-**outputDelimiterLeft**, **outputDelimiterRight**, **tagDelimiterLeft**, **tagDelimiterRight** 用来自定义 LiquidJS 中 [标签和过滤器][intro] 的分隔符。例如设置了 `outputDelimiterLeft: <%=, outputDelimiterRight: %>` 后我们可以避免跟其他模板引擎冲突：
-
-```ejs
-<%= username | append: ", welcome to LiquidJS!" %>
-```
-
-## 严格模式
-
-**strictFilters** 用来启用过滤器的严格模式，如果设置为 `true` 过滤器不存在时解析会抛出异常。默认为 `false`，这时会跳过不存在的过滤器。
-
-**strictVariables** 用来启用变量严格模式。如果设置为 `true` 变量不存在时渲染会抛出异常，默认为 `false` 这时不存在的变量会被渲染为空字符串。
-
-**ownPropertyOnly** 用来隐藏原型上的变量，如果你需要把未经处理过的对象传递给模板时，可以设置 `ownPropertyOnly` 为 `true`，默认为 `false`。
-
-{% note info 不存在的标签 %}
-不存在的标签总是会抛出一个解析异常，这一行为无法自定义。
-{% endnote %}
-
-## 参数顺序
-
-默认会忽略参数出现的顺序，例如 `{% for i in (1..8) reversed limit:3 %}` 里总是会先执行 `limit` 再执行 `reversed`，虽然 `reversed` 先出现。为了让 LiquidJS 按顺序执行参数，需要设置 **orderedFilterParameters** 为 `true`。它的默认值为 `false`。
-
-[liquid]: /api/classes/Liquid.html
-[caching]: ./caching.html
-[abstract-fs]: ./render-file.html#Abstract-File-System
-[render-file]: ./render-file.html
-[185]: https://github.com/harttle/liquidjs/issues/185
-[render]: ../tags/render.html
-[include]: ../tags/include.html
-[layout]: ../tags/layout.html
-[wc]: ./whitespace-control.html
-[intro]: ./intro-to-liquid.html
-[jekyllInclude]: /api/interfaces/LiquidOptions.html#jekyllInclude
-[raw]: ../filters/raw.html
-[outputEscape]: /api/interfaces/LiquidOptions.html#outputEscape
diff --git a/docs/source/zh-cn/tutorials/parse-parameters.md b/docs/source/zh-cn/tutorials/parse-parameters.md
deleted file mode 100644
index 3f5cbaa65..000000000
--- a/docs/source/zh-cn/tutorials/parse-parameters.md
+++ /dev/null
@@ -1,100 +0,0 @@
----
-title: 参数解析
----
-
-## 访问原始参数
-
-在 [注册过滤器和标签][register-tags] 中提到，可以通过 `tagToken.args` 来得到标签的原始参数字符串。例如：
-
-```javascript
-// Usage: {% random foo bar coo %}
-// Output: "foo", "bar" or "coo"
-engine.registerTag('random', {
-  parse(tagToken) {
-    // tagToken.args === "foo bar coo"
-    this.items = tagToken.args.split(' ')
-  },
-  render(context, emitter) {
-    // get a random index
-    const index = Math.floor(this.items.length * Math.random())
-    // output that item
-    emitter.write(this.items[index])
-  }
-})
-```
-
-见这个 JSFiddle：<http://jsfiddle.net/ctj364up/2/>。
-
-## 解析参数的值
-
-除了静态的参数字符串之外，我们更希望把动态的值传递给标签。LiquidJS 中的值可以是字面量（字符串、数字等，也可以是当前上下文的变量。
-
-下面是修改过的模板，也包含三个值用来随机。但它们表示的是值而不是静态的字符串。第一个是字符串字面量，第二个是标识符（表示变量），第三个是属性访问表达式，包含两个标识符。
-
-```liquid
-{% random "foo" bar obj.coo %}
-```
-
-解析这么多种情况会很麻烦，但 LiquidJS 提供了 [Tokenizer][Tokenizer] 类来处理这种情况。
-
-```javascript
-const { Liquid, Tokenizer, evalToken } = require('liquidjs')
-
-engine.registerTag('random', {
-  parse(tagToken) {
-    const tokenizer = new Tokenizer(tagToken.args)
-    this.items = []
-    while (!tokenizer.end()) {
-      // here readValue() returns a LiteralToken or PropertyAccessToken
-      this.items.push(tokenizer.readValue())
-    }
-  },
-  * render(context, emitter) {
-    const index = Math.floor(this.items.length * Math.random())
-    const token = this.items[index]
-    // in LiquidJS, we use yield to wait for async call
-    const value = yield evalToken(token, context)
-    emitter.write(value)
-  }
-})
-```
-
-用上下文 `{ bar: "bar", obj: { coo: "coo" } }` 来调用这个标签可以得到上第一个例子一样的效果。见这个 JSFiddle：<http://jsfiddle.net/ctj364up/3/>.
-
-{% note info 异步和 Promise %}
-在 LiquidJS 里异步用生成器实现，这样同样一份标签的实现也可以用于同步的 API 比如 `renderSync()`，`parseAndRenderSync()`，`renderFileSync()`。如果要在标签实现里等待 Promise，只需要把 `await somePromise` 换成 `yield somePromise`，并保留 `* render()` 不要改成 `async render()`。更多细节请参考 <a href="/tutorials/sync-and-async.html">Sync and Async</a>。
-{% endnote %}
-
-## 把键值对解析为命名参数
-
-当参数很多时或者有可选参数时，使用命名参数语法会很方便。这时参数由无序的键值对构成，LiquidJS 中的 [Hash][Hash] 类就是来处理这种情况的。
-
-```liquid
-{% random from:2, to:max %}
-```
-
-上面的例子用来产生 [2, max] 范围内的随机数。我们要用 `Hash` 来解析 `from` 和 `to` 参数。
-
-```javascript
-const { Liquid, Hash } = require('liquidjs')
-
-engine.registerTag('random', {
-  parse(tagToken) {
-    // 解析参数结果，存到 `this.args` 里
-    this.args = new Hash(tagToken.args)
-  },
-  * render(context, emitter) {
-    // 在当前 `context` 下计算参数的值
-    const {from, to} = yield this.args.render(context)
-    const length = to - from + 1
-    const value = from + Math.floor(length * Math.random())
-    emitter.write(value)
-  }
-})
-```
-
-在 `{ max: 10 }` 上下文上渲染 `{% raw %}{% random from:2, to:max %}{% endraw %}` 将会得到 [2, 10] 范围内的随机数。见这个 JSFiddle：<http://jsfiddle.net/ctj364up/4/>。
-
-[register-tags]: /tutorials/register-filters-tags.html
-[Tokenizer]: /api/classes/Tokenizer.html
-[Hash]: /api/classes/Hash.html
diff --git a/docs/source/zh-cn/tutorials/partials-and-layouts.md b/docs/source/zh-cn/tutorials/partials-and-layouts.md
deleted file mode 100644
index 531ef00cb..000000000
--- a/docs/source/zh-cn/tutorials/partials-and-layouts.md
+++ /dev/null
@@ -1,60 +0,0 @@
----
-title: 引用和继承
----
-
-## 引用模板片段
-
-对于如下两个模板文件：
-
-```
-// 文件：color.liquid
-color: '{{ color }}' shape: '{{ shape }}'
-
-// 文件：theme.liquid
-{% assign shape = 'circle' %}
-{% include 'color' %}
-{% include 'color' with 'red' %}
-{% include 'color', color: 'yellow', shape: 'square' %}
-```
-
-输出为：
-
-```
-color: '' shape: 'circle'
-color: 'red' shape: 'circle'
-color: 'yellow' shape: 'square'
-```
-
-{% note tip &quot;.liquid&quot; 文件扩展名 %}
-如果设置了 `extname: ".liquid"` 选项，就可以省略 <code>layout</code>, <code>render</code> 和 <code>include</code> 里面文件名的 ".liquid" 后缀。详情请参考 <a href="./options.html#extname">extname 选项</a>。
-{% endnote %}
-
-## 布局模板（模板继承）
-
-对于如下两个模板文件：
-
-```
-// 文件：default-layout.liquid
-Header
-{% block content %}My default content{% endblock %}
-Footer
-
-// 文件：page.liquid
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
-
-渲染 `page.liquid` 将会输出：
-
-```
-Header
-My page content
-Footer
-```
-
-{% note tip Block %}
-<ul>
-    <li>布局文件（父模板）中可以定义多个 block；</li>
-    <li>只有一个 block 时，block 名字可以省略。</li>
-</ul>
-{% endnote %}
diff --git a/docs/source/zh-cn/tutorials/plugins.md b/docs/source/zh-cn/tutorials/plugins.md
deleted file mode 100644
index 0f826e6f7..000000000
--- a/docs/source/zh-cn/tutorials/plugins.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: 插件
----
-
-一组标签和过滤器可以封装为一个 **插件**，通常发包到 NPM 来方便使用。本文介绍如何创建和使用插件。
-
-## 编写插件
-
-LiquidJS 插件就是一个简单的函数，它的第一个参数是 [Liquid 类][liquid]，其中的 `this` 是它被注册到的 Liquid 实例。可以通过 `this` 来调用 Liquid API，比如 [注册标签和过滤器][register]。
-
-现在我们来写一个插件并在其中注册一个过滤器，来把输入字符串转换为大写：
-
-```javascript
-/**
- * Inside the plugin function, `this` refers to the Liquid instance.
- *
- * @param Liquid: provides facilities to implement tags and filters.
- */
-module.exports = function (Liquid) {
-    this.registerFilter('upup', x => x.toUpperCase());
-}
-```
-
-把上述代码保存为 `upup.js`。
-
-## 使用插件
-
-把插件传递给 `.plugin()` 方法即可注册插件，例如：
-
-```javascript
-const engine = new Liquid()
-
-engine.plugin(require('./upup.js'));
-engine.parseAndRender('{{ "foo" | upup }}').then(console.log)
-```
-
-上述代码将会输出 `"FOO"`。
-
-## 插件列表
-
-由于本仓库只包含 [Shopify/liquid](https://github.com/Shopify/liquid/) 核心仓库的标签和插件（参考 <https://github.com/harttle/liquidjs#differences-and-limitations>），Shopify 平台上特有的插件只能通过插件来使用。
-
-这里是一个插件列表，欢迎添加你的插件（点击右上角编辑按钮）：
-
-* Sections 标签（开发中）： https://github.com/harttle/liquidjs-section-tags
-* 颜色过滤器： https://github.com/harttle/liquidjs-color-filters
-
-[liquid]: /api/classes/Liquid.html
-[register]: ./register-filters-tags.html
\ No newline at end of file
diff --git a/docs/source/zh-cn/tutorials/register-filters-tags.md b/docs/source/zh-cn/tutorials/register-filters-tags.md
deleted file mode 100644
index f7ff29230..000000000
--- a/docs/source/zh-cn/tutorials/register-filters-tags.md
+++ /dev/null
@@ -1,97 +0,0 @@
----
-title: 注册标签和过滤器
----
-
-## 注册标签
-
-```javascript
-// 使用方式: {% upper name %}
-engine.registerTag('upper', {
-    parse: function(tagToken, remainTokens) {
-        this.value = new Value(token.args, liquid)
-    },
-    render: function*(scope, hash) {
-        const str = yield this.value.value(ctx); // 'alice'
-        return str.toUpperCase()  // 'Alice'
-    }
-});
-```
-
-* `parse`: 从 `remainTokens` 中读取后续的标签/输出/HTML，直到找到你期望的结束标签。
-* `render`: 把 scope 数据和此前解析得到的 Token 结合，输出 HTML 字符串。
-
-对于更复杂的标签实现，可以提供一个继承自 `Tag` 的类：
-
-```typescript
-// Usage: {% upper name:"alice" %}
-import { Hash, Tag, TagToken, Context, Emitter, TopLevelToken, Liquid } from 'liquidjs'
-
-engine.registerTag('upper', class UpperTag extends Tag {
-    private hash: Hash
-    constructor(tagToken: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
-        super(tagToken, remainTokens, liquid)
-        this.hash = new Hash(tagToken.args)
-    }
-    * render(ctx: Context) {
-        const hash = yield this.hash.render();
-        return hash.name.toUpperCase() // 'ALICE'
-    }
-});
-```
-
-可以参考已有的标签实现：<https://github.com/harttle/liquidjs/tree/master/src/tags>
-
-## 注册过滤器
-
-```javascript
-// 使用方式: {{ name | upper }}
-engine.registerFilter('upper', v => v.toUpperCase())
-```
-
-过滤器的参数将会传递给上面注册的过滤器函数，从第二个参数开始（第一个参数是过滤器左侧的输入），例如：
-
-```javascript
-// Usage: {{ 1 | add: 2, 3 }}
-engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)
-```
-
-查看已有的过滤器实现：<https://github.com/harttle/liquidjs/tree/master/src/filters>。对于复杂的标签，也可以用一个类来实现：
-
-```typescript
-// Usage: {% upper name:"alice" %}
-import { Hash, Tag, TagToken, Context, Emitter, TopLevelToken, Liquid } from 'liquidjs'
-
-engine.registerTag('upper', class UpperTag extends Tag {
-    private hash: Hash
-    constructor(tagToken: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
-        super(tagToken, remainTokens, liquid)
-        this.hash = new Hash(tagToken.args)
-    }
-    * render(ctx: Context) {
-        const hash = yield this.hash.render();
-        return hash.name.toUpperCase() // 'ALICE'
-    }
-});
-```
-
-## 反注册标签/过滤器
-
-有时可能需要禁用一些标签/过滤器（比如 [#324](https://github.com/harttle/liquidjs/issues/324)），注册一个假的标签/过滤器并在里面抛出相应的错误即可。
-
-```javascript
-// 禁用标签
-const disabledTag = {
-    parse: function(token) {
-        throw new Error(`tag "${token.name}" disabled`);
-    }
-}
-engine.registerTag('include', disabledTag);
-
-// 禁用过滤器
-function disabledFilter(name) {
-    return function () {
-        throw new Error(`filter "${name}" disabled`);
-    }
-}
-engine.registerFilter('plus', disabledFilter('plus'));
-```
diff --git a/docs/source/zh-cn/tutorials/render-file.md b/docs/source/zh-cn/tutorials/render-file.md
deleted file mode 100644
index 4d5c6283c..000000000
--- a/docs/source/zh-cn/tutorials/render-file.md
+++ /dev/null
@@ -1,113 +0,0 @@
----
-title: 渲染文件
----
-
-一个典型的项目会有一个目录下都是模板，最方便的方式就是设置 LiquidJS 的 [root][root] 然后调用 [.renderFile()][renderFile] 或 [.renderFileSync()][renderFileSync] 来渲染其中的一个模板文件。
-
-## 渲染一个文件
-
-例如你有如下的目录结构：
-
-```
-.
-├── index.js
-└── views/
-  ├── hello.liquid
-  └── world.liquid
-```
-
-其中 `hello.liquid` 内容为：
-
-```liquid
-name: {{name}}
-```
-
-在 `index.js` 中可以这样渲染 `hello.liquid`:
-
-```javascript
-var engine = new Liquid({
-    root: path.resolve(__dirname, 'views/'), // 设置模板查找目录
-    extname: '.liquid' // 添加后缀，默认为 "" 表示不添加后缀
-});
-// 将会读取并渲染 `views/hello.liquid`
-engine.renderFile("hello", {name: 'alice'}).then(console.log)
-```
-
-执行 `node index.js` 你将会得到类似这样的输出：
-
-```
-name: alice
-```
-
-## 模板查找
-
-传递给 [.renderFile()][renderFile], [.parseFile()][parseFile] [.renderFileSync()][renderFileSync], [.parseFileSync()][parseFileSync] 这些 API 的模板名，
-以及传递给 [include][include], [layout][layout] 这些标签的模板名，将会根据 [root][root] 选项来查找。
-
-`root` 可以设置为 `string` 类型的路径（见上面的例子）， 也可以设置为一个字符串数组表示路径列表，这时 LiquidJS 将会按顺序去查找。例如：
-
-```javascript
-var engine = new Liquid({
-    root: ['views/', 'views/partials/'],
-    extname: '.liquid'
-});
-```
-
-{% note tip 相对路径 %}<code>root</code> 中使用相对路径将会被解释为相对于 <code>cwd()</code>（当前工作目录）。{% endnote %}
-
-当模板中引入子模板时（`{% raw %}{% render "foo" %}{% endraw %}`），或者调用 `.renderFile('foo')` 时，LiquidJS 会依次查看如下几个文件，并渲染第一个存在的文件：
-
-- `cwd()`/views/foo.liquid
-- `cwd()`/views/partials/foo.liquid
-
-如果上述文件都不存在，将会抛出一个 `ENOENT` 错误。
-
-{% note info 示例 %} 在 Node.js 示例中展示了怎么渲染一个文件 <a href="https://github.com/harttle/liquidjs/blob/master/demo/nodejs/" target="_blank">liquidjs/demo/nodejs/</a>。{% endnote %}
-
-在浏览器中使用 LiquidJS 时，比如当前路径为 <https://example.com/bar/index.html>，只会去 `root` 数组中的第一个路径下获取，也就是这个文件：
-
-- <https://example.com/bar/foo.liquid>
-
-如果获取失败（比如得到一个 404/500 错误）或网络错误，将会抛出一个 `ENOENT` 错误。
-
-{% note info 示例 %} 在这个示例中展示了如何从网络获取并渲染一个模板文件 <a href="https://github.com/harttle/liquidjs/blob/master/demo/browser/" target="_blank">liquidjs/demo/browser/</a>。{% endnote %}
-
-## 文件系统接口
-
-LiquidJS 定义了一个[文件系统接口][ifs]，在 Node.js 下的默认实现是 [src/fs/node.ts][fs-node]，在浏览器打包文件中的默认实现是 [src/fs/browser.ts][fs-browser]。
-你可以通过创建 `Liquid` 时的 [fs][fs] 参数来指定一个自定义实现来指定如何读取模板文件。比如从数据库里读取：
-
-```javascript
-const engine = new Liquid({
-    fs: {
-        readFileSync (file) {
-            return db.model('Template').findByIdSync(file).text
-        },
-        await readFile (file) {
-            const template = await db.model('Template').findById(file)
-            return template.text
-        },
-        existsSync () {
-            return true
-        },
-        await exists () {
-            return true
-        },
-        resolve(root, file, ext) {
-            return file
-        }
-    }
-});
-```
-
-[fs]: /api/interfaces/LiquidOptions.html#fs
-[ifs]: /api/interfaces/FS.html
-[fs-node]: https://github.com/harttle/liquidjs/blob/master/src/fs/fs-impl.ts
-[fs-browser]: https://github.com/harttle/liquidjs/blob/master/src/fs/fs-impl-browser.ts
-[layout]: https://help.shopify.com/en/themes/liquid/tags/theme-tags#layout
-[include]: https://help.shopify.com/themes/liquid/tags/theme-tags#include
-[renderFile]: /api/classes/Liquid.html#renderFile
-[renderFileSync]: /api/classes/Liquid.html#renderFileSync
-[parseFile]: /api/classes/Liquid.html#parseFile
-[parseFileSync]: /api/classes/Liquid.html#parseFileSync
-[root]: /api/interfaces/LiquidOptions.html#root
diff --git a/docs/source/zh-cn/tutorials/render-tag-content.md b/docs/source/zh-cn/tutorials/render-tag-content.md
deleted file mode 100644
index 76968556a..000000000
--- a/docs/source/zh-cn/tutorials/render-tag-content.md
+++ /dev/null
@@ -1,137 +0,0 @@
----
-title: 渲染标签内容
----
-
-自定义标签可以有内容，也可以嵌套使用。本文描述了如何实现一个由*开始标签*，*结束标签*和之间的*标签内容*的自定义标签。
-
-## 渲染标签内容
-
-我们先实现一个简单的 `wrap` 标签，它会把内容包装在 `<div class="wrapper"></div>` 元素里：
-
-```liquid
-{% wrap %}
-  {{ "hello world!" | capitalize }}
-{% endwrap %}
-```
-
-期望输出：
-
-```html
-<div class='wrapper'>
-  Hello world!
-</div>
-```
-
-首先 [注册][register-tags] 一个名为 `wrap` 的标签，把内容解析到 `this.tpls` 数组里。`parse(tagToken, remainTokens)` 中，
-
-- `tagToken` 是当前 *Token* `{%raw%}{% wrap %}{%endraw%}`，
-- `remainTokens` 是当前模板中后续所有 *Token* 的数组。
-
-我们要做的是从 `remainTokens` 里拿出来/`.shift()` 足够的标签直到遇到 `endwrap`（其实可以是任意名字，但按照惯例应该叫 `endwrap`）。如果到模板结尾都没遇到 `endwrap`，需要抛出一个标签未关闭的 `Error`。
-
-```javascript
-engine.registerTag('wrap', {
-  parse(tagToken, remainTokens) {
-    this.tpls = []
-    let closed = false
-    while(remainTokens.length) {
-      let token = remainTokens.shift()
-      // 得到了结束标签，停止解析
-      if (token.name === 'endwrap') {
-        closed = true
-        break
-      }
-      // 把 Token 解析成 Template
-      // parseToken() 可能会消耗多个 Token
-      // 例如 {% if %}...{% endif %}
-      let tpl = this.liquid.parser.parseToken(token, remainTokens)
-      this.tpls.push(tpl)
-    }
-    if (!closed) throw new Error(`tag ${tagToken.getText()} not closed`)
-  },
-  * render(context, emitter) {
-    emitter.write("<div class='wrapper'>")
-    yield this.liquid.renderer.renderTemplates(this.tpls, context, emitter)
-    emitter.write("</div>")
-  }
-})
-```
-
-`.renderTemplates()` 可能是异步的，因此需要 `yield` 来等它完成。更多关于 LiquidJS 异步的信息可以参考 [同步和异步][async]。`render()` 的其他部分比较直观，这是 JSFiddle 版本：<http://jsfiddle.net/por0zcn1/3/>。
-
-## 使用 ParseStream
-
-对于像 [for][for] 和 [if][if] 这样的复杂标签，`parse()` 会变得很复杂。使用 [ParseStream][ParseStream] 工具可以按事件风格来组织 `parse()` 的逻辑。下面是用 `ParseStream` 重写过的 `parse()`，实现了和上面例子中完全一样的功能。
-
-```javascript
-parse(tagToken, remainTokens) {
-  this.tpls = []
-  this.liquid.parser.parseStream(remainTokens)
-    .on('template', tpl => this.tpls.push(tpl))
-    // 注意这里不能用箭头函数，因为我们需要 `this`
-    .on('tag:endwrap', function () { this.stop() })
-    .on('end', () => { throw new Error(`tag ${tagToken.getText()} not closed`) })
-    .start()
-}
-```
-
-这是 JSFiddle 链接：<http://jsfiddle.net/por0zcn1/4/>。简单起见，下面的例子都借助 `ParseStream` 来实现。
-
-## 操作上下文
-
-上面的 `wrap` 标签看起来没什么用，反正没它也可以很容易地渲染那部分内容。我们现在来实现一个 `repeat` 标签，把内容渲染两次（还可以[加个参数][parameter]让它渲染任意次）：
-
-```liquid
-{% repeat %}
-  {{ repeat.i }}. {{ "hello world!" | capitalize }}
-{% endrepeat %}`
-```
-
-期望输出：
-
-```html
-1. Hello world!
-2. Hello world!
-```
-
-你可能注意到了在 `repeat` 上下文里有个额外的变量 `repeat.i`，这就需要我们操作 *上下文*。
-
-{% note info 上下文 %}
-<em>上下文</em> 定义了 Liquid 模板中每个变量的值。在 LiquidJS 中，`Context` 由一个 `Scope` 的栈组成。*Scope* 就是一个普通对象，就像传给 `engine.render(tpl, scope)` 的 `scope` 一样。
-{% endnote %}
-
-每次进入新的 *上下文* 时，我们需要 `push` 一个新的 `Scope`。当结束渲染并退出 *上下文* 时，再把 `Scope` 从 *上下文* `pop` 出来。见下面的实现：
-
-```javascript
-engine.registerTag('repeat', {
-  parse(tagToken, remainTokens) {
-    this.tpls = []
-    this.liquid.parser.parseStream(remainTokens)
-      .on('template', tpl => this.tpls.push(tpl))
-      .on('tag:endrepeat', function () { this.stop() })
-      .on('end', () => { throw new Error(`tag ${tagToken.getText()} not closed`) })
-      .start()
-  },
-  * render(context, emitter) {
-    const repeat = { i: 1 }
-    context.push({ repeat })
-    yield this.liquid.renderer.renderTemplates(this.tpls, context, emitter)
-    repeat.i++
-    yield this.liquid.renderer.renderTemplates(this.tpls, context, emitter)
-    context.pop()
-  }
-})
-```
-
-`parse()` 部分和 `wrap` 标签完全相同，在 `render()` 部分我们通过调用两次 `.renderTemplates(this.tpls)` 来重复渲染内容。这是 JSFiddle 链接：<http://jsfiddle.net/por0zcn1/2/>。
-
-{% note warn 成对使用 Push 和 Pop %}
-必须成对地使用 `context.push()` 和 `context.pop()`。如果忘记 `pop()` 会导致 `Scope` 泄露给后面的模板内容，也可能损坏 *上下文* 栈。.
-{% endnote %}
-
-[register-tags]: ./register-filters-tags.html
-[async]: ./sync-and-async.html
-[for]: ../tags/for.html
-[if]: ../tags/if.html
-[ParseStream]: /api/classes/ParseStream.html
-[parameter]: ./parse-parameters.html
diff --git a/docs/source/zh-cn/tutorials/security-model.md b/docs/source/zh-cn/tutorials/security-model.md
deleted file mode 100644
index a859370e8..000000000
--- a/docs/source/zh-cn/tutorials/security-model.md
+++ /dev/null
@@ -1,89 +0,0 @@
----
-title: 安全模型
----
-
-LiquidJS 提供了面向 DoS 的限制选项（`parseLimit`、`renderLimit`、`memoryLimit`）来降低风险。本文概述这些限制、[`ownPropertyOnly`][ownPropertyOnly]、自定义 [`Drop`][drop] 的注意事项，以及生产环境应采用的安全边界。
-
-## 安全边界
-
-内置限制是协作式防护，不是严格的运行时隔离。
-
-- 它**不等于**进程的 RSS/heap 实际占用。
-- 它**不是** JavaScript 沙箱。
-- 在生产环境中应结合进程/容器资源限制和请求超时做分层防护。
-
-## 限制速览
-
-- [parseLimit][parseLimit]：限制每次 `parse()` 的模板总长度。
-- [renderLimit][renderLimit]：限制每次 `render()` 的总渲染时间。
-- [memoryLimit][memoryLimit]：协作式限制 LiquidJS 已记账的内存敏感分配。
-
-## 限制详解
-
-### parseLimit
-
-[parseLimit][parseLimit] 限制每次 `.parse()` 调用中解析的模板大小（字符长度），包括引用的 partials 和 layouts。由于 LiquidJS 解析模板字符串的时间复杂度接近 O(n)，限制模板总长度通常就足够了。
-
-普通电脑可以很容易处理 `1e8`（100M）个字符的模板。
-
-### renderLimit
-
-仅限制模板大小是不够的，因为在渲染时可能会出现动态的数组和循环。[renderLimit][renderLimit] 通过限制每次 `render()` 调用的时间来缓解这些问题。
-
-```liquid
-{%- for i in (1..10000000) -%}
-    order: {{i}}
-{%- endfor -%}
-```
-
-渲染时间是在渲染每个模板之前检查的。在上面的例子中，循环中有两个模板：`order: ` 和 `{{i}}`，因此会检查 2x10000000 次。
-
-`renderLimit` 不是硬性的 CPU 限制器。它是在模板渲染边界做检查，因此检查点之间的高计算开销过滤器/标签/用户自定义函数，或深层模板嵌套，仍可能导致 DoS。
-
-### memoryLimit
-
-`memoryLimit` 只限制 LiquidJS 显式记账到的操作。
-
-- 会被统计：LiquidJS 内部调用了内存记账逻辑的内存敏感操作。
-- 不保证被统计：任意用户对象行为（例如自定义 `toValue()` / `toString()` 链）以及其他发生在 LiquidJS 记账点之外的宿主侧分配。
-
-换句话说，`memoryLimit` 限制的是 LiquidJS 的“已记账分配”，而不是进程里每一个字节的分配。
-
-即使模板和迭代次数较少，内存使用量也可能呈指数增长。在下面的示例中，内存会在每次迭代中翻倍：
-
-```liquid
-{% assign array = "1,2,3" | split: "," %}
-{% for i in (1..32) %}
-    {% assign array = array | concat: array %}
-{% endfor %}
-```
-
-由于 [JavaScript 使用 GC 来管理内存](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_management)，`memoryLimit` 可能无法反映实际的内存占用。
-
-## `ownPropertyOnly` 与作用域数据
-
-将 [`ownPropertyOnly`][ownPropertyOnly] 设为 `true` 时，普通作用域对象只暴露**自有**属性（不包含继承链与 `Object.prototype` 上的键）。默认 `false` 与常规 JavaScript 属性访问一致。对不可信或可能被污染的对象应使用 `true`；若缺少路径需报错，可配合 [`strictVariables`][strictVariables]。单次渲染可通过 [`RenderOptions`][renderOwnPropertyOnly] 覆盖。该选项只约束作用域数据的读取，不是过滤器、标签或宿主代码的沙箱。
-
-## 自定义 `Drop` 类
-
-[`Drop`][drop] 与普通对象处理不同：即使开启 [`ownPropertyOnly`][ownPropertyOnly]，LiquidJS 仍可能沿原型链读取属性，并在未解析时调用 [`liquidMethodMissing`][liquidMethodMissing]。**你**对 Drop 暴露的能力负责：收窄 API，勿向 Drop 传入不安全数据，除非该类明确为模板访问而设计。仅靠 `ownPropertyOnly` 无法硬化自定义 Drop，应像审计其他特权代码一样审查其实现。
-
-## 在线服务建议
-
-如果你运行在线服务，建议尽量避免渲染完全由用户定义的模板。
-
-- 优先使用受控模板或受限模板子集。
-- 如果必须支持用户自定义模板，请隔离渲染（worker/进程/容器），并同时配置操作系统或容器级的内存/CPU 限额与请求限流。
-- 将 `parseLimit` / `renderLimit` / `memoryLimit` 视为 DoS 防护体系中的一层，而不是唯一防线。
-
-对于单个模板中的重型操作，仍建议使用进程级隔离（例如 [paralleljs][paralleljs]）。
-
-[paralleljs]: https://www.npmjs.com/package/paralleljs
-[parseLimit]: /api/interfaces/LiquidOptions.html#parseLimit
-[renderLimit]: /api/interfaces/LiquidOptions.html#renderLimit
-[memoryLimit]: /api/interfaces/LiquidOptions.html#memoryLimit
-[ownPropertyOnly]: /api/interfaces/LiquidOptions.html#ownPropertyOnly
-[renderOwnPropertyOnly]: /api/interfaces/RenderOptions.html#ownPropertyOnly
-[strictVariables]: /api/interfaces/LiquidOptions.html#strictVariables
-[drop]: /api/classes/Drop.html
-[liquidMethodMissing]: /api/classes/Drop.html#liquidMethodMissing
diff --git a/docs/source/zh-cn/tutorials/setup.md b/docs/source/zh-cn/tutorials/setup.md
deleted file mode 100644
index 26ee81540..000000000
--- a/docs/source/zh-cn/tutorials/setup.md
+++ /dev/null
@@ -1,70 +0,0 @@
----
-title: 安装和使用
----
-
-如果你还不了解 Liquid 模板语言，请参考 [Liquid 模板语言简介][intro]。
-
-## 在 Node.js 里使用
-
-通过 NPM 安装：
-
-```bash
-npm install --save liquidjs
-```
-
-```javascript
-var { Liquid } = require('liquidjs');
-var engine = new Liquid();
-
-engine
-    .parseAndRender('{{name | capitalize}}', {name: 'alice'})
-    .then(console.log);     // 输出 'Alice'
-```
-
-{% note info 示例 %} 这里有一个 LiquidJS 在 Node.js 里使用的例子：<a href="https://github.com/harttle/liquidjs/blob/master/demo/nodejs/" target="_blank">liquidjs/demo/nodejs/</a>.{% endnote %}
-
-LiquidJS 的类型定义也导出并发布到了 NPM 包里，写 TypeScript 的项目可以直接这样使用：
-
-```typescript
-import { Liquid } from 'liquidjs';
-const engine = new Liquid();
-
-engine
-    .parseAndRender('{{name | capitalize}}', {name: 'alice'})
-    .then(console.log);     // 输出 'Alice'
-```
-
-{% note info 示例 %} 这里有一个 LiquidJS 在 TypeScript 下的例子：<a href="https://github.com/harttle/liquidjs/blob/master/demo/typescript/" target="_blank">liquidjs/demo/typescript/</a>.{% endnote %}
-
-## 在浏览器里使用
-
-LiquidJS 预先构建了 UMD Bundle，可以通过 jsDelivr CDN 来引用：
-
-```html
-<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.min.js"></script>     <!--生产环境-->
-<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.umd.js"></script>         <!--开发环境-->
-```
-
-{% note info 示例 %} 这里有一个 jsFiddle 上的在线例子：<a href="https://jsfiddle.net/x43eb0z6/" target="_blank">jsfiddle.net/x43eb0z6</a>，其源码也可以在 <a href="https://github.com/harttle/liquidjs/blob/master/demo/browser/" target="_blank">liquidjs/demo/browser/</a> 找到。{% endnote %}
-
-{% note warn 兼容性 %} 在类似 IE 和 Android UC 这样的浏览器中，你可能需要引入 <a href="https://github.com/taylorhakes/promise-polyfill" target="_blank">Promise polyfill</a>，参看 <a href="http://caniuse.com/#feat=promises" target="_blank">caniuse 的统计</a>。 {% endnote %}
-
-## 在命令行里使用
-
-你还可以在命令行里使用 LiquidJS：
-
-```bash
-echo '{{"hello" | capitalize}}' | npx liquidjs
-```
-
-模板来自标准输入，数据则来自参数，这个参数可以是一个 JSON 文件的路径，也可以是一个 JSON 字符串：
-
-```bash
-echo 'Hello, {{ name }}.' | npx liquidjs '{"name": "Snake"}'
-```
-
-## 其他
-
-[@stevenanthonyrevo](https://github.com/stevenanthonyrevo) 还提供了一个 ReactJS demo，请参考 [liquidjs/demo/reactjs/](https://github.com/harttle/liquidjs/blob/master/demo/reactjs/)。
-
-[intro]: ./intro-to-liquid.html
\ No newline at end of file
diff --git a/docs/source/zh-cn/tutorials/static-analysis.md b/docs/source/zh-cn/tutorials/static-analysis.md
deleted file mode 100644
index ed6d39cd1..000000000
--- a/docs/source/zh-cn/tutorials/static-analysis.md
+++ /dev/null
@@ -1,292 +0,0 @@
----
-title: 静态模板分析
----
-
-{% since %}v10.20.0{% endsince %}
-
-{% note warn 实验性功能 %}  
-这是一个实验性功能，未来的 API 可能会发生变化，返回的内部结构也可能在不进行主要版本更新的情况下更改。
-{% endnote %}
-
-{% note info 同步与异步 %}  
-本文中的每种方法都提供了同步和异步版本。请参阅 [Liquid API][liquid-api] 了解完整的参考信息。  
-{% endnote %}
-
-## 变量
-
-可以使用 `Liquid.variables(template)` 方法获取模板中使用的变量名称。它会返回一个字符串数组，每个字符串代表一个不同的变量，不包括其属性。
-
-```javascript
-import { Liquid } from 'liquidjs'
-
-const engine = new Liquid()
-
-const template = engine.parse(`
-<p>
-  {% assign title = user.title | capitalize %}
-  {{ title }} {{ user.first_name | default: user.name }} {{ user.last_name }}
-  {% if user.address %}
-    {{ user.address.line1 }}
-  {% else %}
-    {{ user.email_addresses[0] }}
-    {% for email in user.email_addresses %}
-       - {{ email }}
-    {% endfor %}
-  {% endif %}
-  {{ a[b.c].d }}
-<p>
-`)
-
-console.log(engine.variablesSync(template))
-```
-
-**输出**
-
-```javascript
-[ 'user', 'title', 'email', 'a', 'b' ]
-```
-
-可以看到，标签和过滤器参数中的变量也会包含在内，例如示例中的嵌套变量 `b`。  
-另外，可以使用 `Liquid.fullVariables(template)` 方法获取包含其属性的完整变量列表。
-
-```javascript
-// 上例继续
-engine.fullVariables(template).then(console.log)
-```
-
-**输出**
-
-```javascript
-[
-  'user.title',
-  'user.first_name',
-  'user.name',
-  'user.last_name',
-  'user.address',
-  'user.address.line1',
-  'user.email_addresses[0]',
-  'user.email_addresses',
-  'title',
-  'email',
-  'a[b.c].d',
-  'b.c'
-]
-```
-
-或者，使用 `Liquid.variableSegments(template)` 获取每个变量路径的字符串和数字数组。
-
-```javascript
-// 上例继续
-engine.variableSegments(template).then(console.log)
-```
-
-**输出**
-
-```javascript
-[
-  [ 'user', 'title' ],
-  [ 'user', 'first_name' ],
-  [ 'user', 'name' ],
-  [ 'user', 'last_name' ],
-  [ 'user', 'address' ],
-  [ 'user', 'address', 'line1' ],
-  [ 'user', 'email_addresses', 0 ],
-  [ 'user', 'email_addresses' ],
-  [ 'title' ],
-  [ 'email' ],
-  [ 'a', [ 'b', 'c' ], 'd' ],
-  [ 'b', 'c' ]
-]
-```
-
-### 全局变量
-
-注意在上述示例中，`title` 和 `email` 被包含在结果中。通常你可能希望排除 `{% assign %}` 标签中定义的变量名，以及由 `{% for %}` 标签引入的临时变量。
-
-为了获取 _全局_ 变量（即由应用开发者提供，而不是模板作者定义的变量）的名称，可以使用 `globalVariables`、`globalFullVariables` 或 `globalVariableSegments` 方法（及其同步版本）。
-
-```javascript
-// 上例继续
-engine.globalVariableSegments(template).then(console.log)
-```
-
-**输出**
-
-```javascript
-[
-  [ 'user', 'title' ],
-  [ 'user', 'first_name' ],
-  [ 'user', 'name' ],
-  [ 'user', 'last_name' ],
-  [ 'user', 'address' ],
-  [ 'user', 'address', 'line1' ],
-  [ 'user', 'email_addresses', 0 ],
-  [ 'user', 'email_addresses' ],
-  [ 'a', [ 'b', 'c' ], 'd' ],
-  [ 'b', 'c' ]
-]
-```
-
-### 部分模板
-
-默认情况下，LiquidJS 还会尝试加载和分析任何被包含和渲染的模板。
-
-```javascript
-import { Liquid } from 'liquidjs'
-
-const footer = `
-<footer>
-  <p>&copy; {{ "now" | date: "%Y" }} {{ site_name }}</p>
-  <p>{{ site_description }}</p>
-</footer>`
-
-const engine = new Liquid({ templates: { footer } })
-
-const template = engine.parse(`
-<body>
-  <h1>Hi, {{ you | default: 'World' }}!</h1>
-  {% assign some = 'thing' %}
-  {% include 'footer' %}
-</body>
-`)
-
-engine.globalVariables(template).then(console.log)
-```
-
-**输出**
-
-```javascript
-[ 'you', 'site_name', 'site_description' ]
-```
-
-可以通过将 `partials` 选项设置为 `false` 来禁用部分模板的分析。
-
-```javascript
-// 上例继续
-engine.globalVariables(template, { partials: false }).then(console.log)
-```
-
-**输出**
-
-```javascript
-[ 'you' ]
-```
-
-如果 `{% include %}` 标签使用了动态模板名称（无法在渲染模板之前确定的模板名称），即使 `partials` 设置为 `true`，也会被忽略。
-
-### 高级用法
-
-上述示例使用的是 `Liquid` 类的便捷方法，适用于最常见的使用场景。  
-如果需要更详细的信息，可以直接处理 [分析结果][static-analysis-interface]，其中每个变量的每次出现都会记录行、列和文件名等信息。
-
-此处是对 [部分模板](#部分模板) 中模板进行 `Liquid.analyze()` 调用后返回的对象示例。
-
-```javascript
-{
-  variables: {
-    you: [
-      [String (Variable): 'you'] {
-        segments: [ 'you' ],
-        location: { row: 2, col: 14, file: undefined }
-      }
-    ],
-    site_name: [
-      [String (Variable): 'site_name'] {
-        segments: [ 'site_name' ],
-        location: { row: 2, col: 41, file: 'footer' }
-      }
-    ],
-    site_description: [
-      [String (Variable): 'site_description'] {
-        segments: [ 'site_description' ],
-        location: { row: 3, col: 9, file: 'footer' }
-      }
-    ]
-  },
-  globals: {
-    you: [
-      [String (Variable): 'you'] {
-        segments: [ 'you' ],
-        location: { row: 2, col: 14, file: undefined }
-      }
-    ],
-    site_name: [
-      [String (Variable): 'site_name'] {
-        segments: [ 'site_name' ],
-        location: { row: 2, col: 41, file: 'footer' }
-      }
-    ],
-    site_description: [
-      [String (Variable): 'site_description'] {
-        segments: [ 'site_description' ],
-        location: { row: 3, col: 9, file: 'footer' }
-      }
-    ]
-  },
-  locals: {
-    some: [
-      [String (Variable): 'some'] {
-        segments: [ 'some' ],
-        location: { row: 3, col: 13, file: undefined }
-      }
-    ]
-  }
-}
-```
-
-### 自定义标签的分析
-
-为了在静态分析中包含自定义标签的结果，这些标签必须实现 [Template 接口]( /api/interfaces/Template.html) 中定义的一些附加方法。LiquidJS 会使用这些方法返回的信息来遍历模板并报告变量使用情况。
-
-并非所有方法都是必须的，这取决于标签的类型。如果标签是一个块标签，具有起始标签、结束标签以及内容，那么它需要实现 [`children()`](/api/interfaces/Template.html#children) 方法。`children()` 需要返回一个生成器，这是为了像 `render()` 一样既可以同步也可以异步调用。该方法应返回当前标签的子节点，例如 HTML 内容、输出语句和标签。
-
-[`blockScope()`](/api/interfaces/Template.html#blockScope) 方法用于告知 LiquidJS 在标签块的持续时间内哪些名称会处于作用域中。这些名称可能依赖于标签的参数，也可能是固定的，例如 `{% for %}` 标签生成的 `forloop`。
-
-无论标签是行内标签还是块标签，如果它接受参数，则应实现 [`arguments()`](/api/interfaces/Template.html#arguments) 方法，该方法负责将标签的参数作为 [`Value`](/api/classes/Value.html) 实例或类型为 [`ValueToken`](/api/types/ValueToken.html) 的标记序列返回。
-
-以下示例展示了块标签如何实现这些方法。有关更多示例，请参见 LiquidJS 的[内置标签][built-in]。
-
-```javascript
-import { Liquid, Tag, Hash } from 'liquidjs'
-
-class ExampleTag extends Tag {
-  args
-  templates
-
-  constructor (token, remainTokens, liquid, parser) {
-    super(token, remainTokens, liquid)
-    this.args = new Hash(token.tokenizer)
-    this.templates = []
-
-    const stream = parser.parseStream(remainTokens)
-      .on('tag:endexample', () => { stream.stop() })
-      .on('template', (tpl) => this.templates.push(tpl))
-      .on('end', () => { throw new Error(`tag ${token.getText()} not closed`) })
-
-    stream.start()
-  }
-
-  * render (ctx, emitter) {
-    const scope = (yield this.args.render(ctx))
-    ctx.push(scope)
-    yield this.liquid.renderer.renderTemplates(this.templates, ctx, emitter)
-    ctx.pop()
-  }
-
-  * children () {
-    return this.templates
-  }
-
-  * arguments () {
-    yield * Object.values(this.args.hash).filter((el) => el !== undefined)
-  }
-
-  blockScope () {
-    return Object.keys(this.args.hash)
-  }
-}
-```
-
-[liquid-api]: /api/classes/Liquid.html
-[static-analysis-interface]: /api/interfaces/StaticAnalysis.html
-[built-in]: https://github.com/harttle/liquidjs/tree/master/src/tags
diff --git a/docs/source/zh-cn/tutorials/sync-and-async.md b/docs/source/zh-cn/tutorials/sync-and-async.md
deleted file mode 100644
index caaf4c9a4..000000000
--- a/docs/source/zh-cn/tutorials/sync-and-async.md
+++ /dev/null
@@ -1,112 +0,0 @@
----
-title: 同步和异步
----
-
-LiquidJS 支持同步调用也支持异步调用，支持 Promise。为了同异步复用一套标签和过滤器，LiquidJS 标签用生成器来实现。
-
-## 同异步 API
-
-[Liquid][Liquid] 上主要的方法都支持同步和异步，下面这些方法返回 `Promise`：
-
-- `render()`
-- `renderFile()`
-- `parseFile()`
-- `parseAndRender()`
-- `evalValue()`
-
-它们的同步版本带一个 `Sync` 后缀：
-
-- `renderSync()`
-- `renderFileSync()`
-- `parseFileSync()`
-- `parseAndRenderSync()`
-- `evalValueSync()`
-
-## 如何实现兼容同步的标签
-
-LiquidJS 使用基于生成器的异步实现，来让同一份代码支持同步和异步调用。例如下面的 `UpperTag` 既可以用于 `engine.renderSync()` 也可以用于 `engine.render()`：
-
-```typescript
-import { TagToken, Context, Emitter, TopLevelToken, Value, Tag, Liquid } from 'liquidjs'
-
-// Usage: {% upper "alice" %}
-// Output: ALICE
-engine.registerTag('upper', class UpperTag extends Tag {
-  private value: Value
-  constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
-    super(token, remainTokens, liquid)
-    this.value = new Value(token.args, liquid)
-  }
-  * render (ctx: Context, emitter: Emitter) {
-    const title = yield this.value.value(ctx)
-    emitter.write(title.toUpperCase())
-  }
-})
-```
-
-所有内置标签都兼容同步，可以安全地用于同步或异步 API。实现同时支持同异步的标签，需要：
-
-- render 函数声明成 `* render()`，并且在里面
-- 不能直接 `return <Promise>`，
-- 不能调用会返回 Promise 的函数。
-
-## 调用返回 Promise 的函数
-
-但 LiquidJS 是支持 `Promise` 的，你仍然可以调用返回 `Promise` 的方法并等它 resolve。只需要把 `await` 换成 `yield`。例如：
-
-```typescript
-  * render (ctx: Context, emitter: Emitter) {
-    const file = yield this.value.value(ctx)
-    const title = yield fs.readFile(file, 'utf8')
-    emitter.write(title.toUpperCase())
-  }
-```
-
-现在 `* render()` 调用了一个返回 Promise 的 API，它就不再兼容同步了。不兼容同步的标签也仍然是合法标签，在异步 API 下也会正常运行。被同步调用时，返回 <code>Promise</code> 的标签会被渲染成 <code>[object Promise]</code>。
-
-## 把 LiquidJS 生成器转换成 Promise
-
-有些 LiquidJS API 会返回 `Promise`，有些会返回生成器。你可以用 [toPromise][toPromise] 来把生成器转换为 `Promise`，比如：
-
-```typescript
-import { TagToken, Context, Emitter, TopLevelToken, Value, Tag, Liquid, toPromise } from 'liquidjs'
-
-// Usage: {% upper "alice" %}
-// Output: ALICE
-engine.registerTag('upper', class UpperTag extends Tag {
-  private value: Value
-  constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
-    super(token, remainTokens, liquid)
-    this.value = new Value(token.args, liquid)
-  }
-  async render (ctx: Context, emitter: Emitter) {
-    const title = await toPromise(this.value.value(ctx))
-    emitter.write(title.toUpperCase())
-  }
-})
-```
-
-## 纯异步标签
-
-如果你的标签就不打算支持同步，可以干脆实现成 `async render()`，这样就可以使用更熟悉的 `await` 了：
-
-```typescript
-import { toPromise, TagToken, Context, Emitter, TopLevelToken, Value, Tag, Liquid } from 'liquidjs'
-
-// Usage: {% upper "alice" %}
-// Output: ALICE
-engine.registerTag('upper', class UpperTag extends Tag {
-  private value: Value
-  constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
-    super(token, remainTokens, liquid)
-    this.value = new Value(token.args, liquid)
-  }
-  async render (ctx: Context, emitter: Emitter) {
-    const title = await toPromise(this.value.value(ctx))
-    emitter.write(`<h1>${title}</h1>`)
-  }
-})
-```
-
-[Liquid]: /api/classes/Liquid.html
-[toPromise]: /api/functions/toPromise.html
diff --git a/docs/source/zh-cn/tutorials/truthy-and-falsy.md b/docs/source/zh-cn/tutorials/truthy-and-falsy.md
deleted file mode 100644
index b7571af32..000000000
--- a/docs/source/zh-cn/tutorials/truthy-and-falsy.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-title: 真和假
----
-
-虽然我们希望 [Liquid][sl] 是平台无关的，但 JavaScript 版本和 [Ruby 版本][ruby] 仍然有[很多区别][diff]，真值就是其中之一。
-
-## 真值表
-
-根据 [Shopify 的文档](https://shopify.github.io/liquid/basics/truthy-and-falsy/)，Ruby 版本除了 `false` 和 `nil` 之外的所有值都是真，但 JavaScript 有完全不同的类型系统，比如我们有 `undefined` 类型，以及不区分 `integer` 和 `float`，因此有些不同：
-
-值             | 真     | 假
----            | ---    | ---
-`true`         | ✔️      | 
-`false`        |        | ✔️
-`null`         |        | ✔️
-`undefined`    |        | ✔️
-`string`       | ✔️      |	 
-`empty string` | ✔️      |
-`0`            | ✔️      |
-`integer`	   | ✔️      |
-`float`	       | ✔️      |
-`array`        | ✔️      |
-`empty array`  | ✔️      |
-
-## 使用 JavaScript 真值
-
-liquidjs 默认使用 Shopify 的真值表，但可以通过设置 **jsTruthy** 选项为 `true` 来使用标准的 JavaScript 真值。
-
-值             | 真     | 假
----            | ---    | ---
-`true`         | ✔️      | 
-`false`        |        | ✔️
-`null`         |        | ✔️
-`undefined`    |        | ✔️
-`string`       | ✔️      |	 
-`empty string` |        | ✔️
-`0`            |        | ✔️
-`integer`	   | ✔️      |
-`float`	       | ✔️      |
-`array`        | ✔️      |
-`empty array`  | ✔️      |
-
-[ruby]: https://shopify.github.io/liquid
-[sl]: https://www.npmjs.com/package/liquidjs
-[diff]: https://github.com/harttle/liquidjs#differences-and-limitations
\ No newline at end of file
diff --git a/docs/source/zh-cn/tutorials/use-in-expressjs.md b/docs/source/zh-cn/tutorials/use-in-expressjs.md
deleted file mode 100644
index 09d40bee4..000000000
--- a/docs/source/zh-cn/tutorials/use-in-expressjs.md
+++ /dev/null
@@ -1,72 +0,0 @@
----
-title: 在 Express.js 里使用
----
-
-LiquidJS 可以用来作为 [Express 的模板引擎](https://expressjs.com/en/resources/template-engines.html)。可以把 Liquid 设置到 [view engine][express-views] 选项上即可：
-
-```javascript
-var { Liquid } = require('liquidjs');
-var engine = new Liquid();
-
-// 注册为 liquid 文件的模板引擎
-app.engine('liquid', engine.express()); 
-app.set('views', './views');            // 指定模板目录
-app.set('view engine', 'liquid');       // 把 liquid 文件设为默认模板
-```
-
-{% note info 示例 %} 这是一个在 Express.js 中使用 LiquidJS 的例子：<a href="https://github.com/harttle/liquidjs/blob/master/demo/express/" target="_blank">liquidjs/demo/express/</a>.{% endnote %}
-
-## 模板查找
-
-LiquidJS 仍然会去 [root][root] 指定的目录查找（参考 [Render A Template File][render-a-file]），也会去 Express.js 的 [`views`][express-views] 选项指定的目录里（上述例子中是 `./views`）去查找。例如你有这样的目录结构：
-
-```
-.
-├── views1/
-│ └── hello.liquid
-└── views2/
-  └── world.liquid
-```
-
-LiquidJS 的模板 root 设置到了 `views1`，Express.js 的 views 设置到了 `views2`：
-
-```javascript
-var { Liquid } = require('liquidjs');
-var engine = new Liquid({
-    root: './views1/'
-});
-
-app.engine('liquid', engine.express()); 
-app.set('views', './views2');
-app.set('view engine', 'liquid');
-```
-
-`hello.liquid` 和 `world.liquid` 两个文件都可以找到并且成功渲染：
-
-```javascript
-res.render('hello')
-res.render('world')
-```
-
-## 缓存
-
-直接把 [cache 选项][cache] 设为 `true` 即可开启模板缓存，参考 [缓存][Caching] 一文。推荐在生产环境中开启缓存，可以用如下代码：
-
-```javascript
-var { Liquid } = require('liquidjs');
-var engine = new Liquid({
-    cache: process.env.NODE_ENV === 'production'
-});
-```
-
-`cache` 还可以是一个数字表示最大缓存的模板数量，也可以是一个自定义的缓存实现，详情请参考 [cache 选项][cache]。
-
-[cache]: /api/interfaces/LiquidOptions.html#cache
-[express-views]: http://expressjs.com/en/guide/using-template-engines.html
-[parseFile]: /api/classes/Liquid.html#parseFile
-[parseFileSync]: /api/classes/Liquid.html#parseFileSync
-[layout]: https://help.shopify.com/en/themes/liquid/tags/theme-tags#layout
-[include]: https://help.shopify.com/themes/liquid/tags/theme-tags#include
-[root]: /api/interfaces/LiquidOptions.html#root
-[render-a-file]: ./render-a-file.html
-[Caching]: ./caching.html
diff --git a/docs/source/zh-cn/tutorials/whitespace-control.md b/docs/source/zh-cn/tutorials/whitespace-control.md
deleted file mode 100644
index 402c43dad..000000000
--- a/docs/source/zh-cn/tutorials/whitespace-control.md
+++ /dev/null
@@ -1,56 +0,0 @@
----
-title: 空白字符控制
----
-
-为了让源代码缩进好看，我们会加很多空白字符比如把不会产生输出的标签也单独一行。LiquidJS 提供了空白字符控制机制，可以避免这些多余的空白字符输出到 HTML 中。
-
-## 通过标记的方式
-
-默认所有标签和输出的行，都会在行尾产生一个换行（`\n`），如果有缩进的话还会产生很多前导空格。例如：
-
-```liquid
-{%  author = "harttle" %}
-{{ author }}
-```
-
-将会输出（注意前面的空行）：
-
-```
-
-harttle
-```
-
-可以在标签和输出的标记里面加横线（`{% raw %}{{-{% endraw %}`, `-}}`, `{% raw %}{%-{% endraw %}`, `-%}`）来移除左侧/右侧的空白。例如：
-
-```liquid
-{% assign author = "harttle" -%}
-{{ author }}
-```
-
-将会输出：
-
-```
-harttle
-```
-
-这个例子中 `-%}` 移除了 `assign` 标签右侧的空白。
-
-## 通过选项
-
-此外 LiquidJS 还提供了一系列选项来帮助扫代码式地移除空白：
-
-* `trimTagLeft`
-* `trimTagRight`
-* `trimValueRight`
-* `trimValueRight`
-
-[LiquidJS][liquidjs] 默认 **不会** 移除任何空白字符，也就是说上面几个选项的默认值都为 `false`。这几个选项的详情请参考 [LiquidJS 选项][options]。
-
-## 贪婪模式
-
-上述几个设置默认情况下会跨越换行（`\n`），如果你希望保留上下空行可以把 [greedy 选项][liquidjs] 关掉，这样遇到 `\n` 就会停止。为了和 [shopify/liquid][shopify/liquid] 一致该选项默认是打开的。
-
-[shopify/liquid]: https://github.com/Shopify/liquid
-[liquidjs]: https://github.com/harttle/liquidjs
-[options]: /api/interfaces/LiquidOptions.html
-[greedy]: /api/interfaces/LiquidOptions.html#greedy
\ No newline at end of file
diff --git a/docs/themes/navy/languages/en.yml b/docs/themes/navy/languages/en.yml
index e75e09d00..f8a787a34 100644
--- a/docs/themes/navy/languages/en.yml
+++ b/docs/themes/navy/languages/en.yml
@@ -10,7 +10,7 @@ index:
   get_started: Get Started
   contributors:
     title: Contributors
-    description: 'LiquidJS follows the <a href="https://github.com/all-contributors/all-contributors">all-contributors</a> specification, see <a href="tutorials/contribution-guidelines.html">guidelines here</a>! Thanks goes to these wonderful people:'
+    description: 'Thanks to these wonderful people! See <a href="tutorials/contribution-guidelines.html">contribution guidelines</a> if you&#39;d like to help.'
   sponsors:
     title: Sponsors
     description: 'If you personally love LiquidJS or it&#39;s benefiting your business, please <a href="https://github.com/sponsors/harttle">sponsor us</a>!'
diff --git a/docs/themes/navy/languages/zh-cn.yml b/docs/themes/navy/languages/zh-cn.yml
deleted file mode 100644
index e5ea5d3b2..000000000
--- a/docs/themes/navy/languages/zh-cn.yml
+++ /dev/null
@@ -1,68 +0,0 @@
-menu:
-  tutorials: 教程
-  tags: 标签
-  filters: 过滤器
-  playground: 演示
-  api: API
-  search: 搜索
-
-index:
-  get_started: 开始使用
-  contributors:
-    title: 贡献
-    description: 'LiquidJS 欢迎任何形式的贡献，可以从 <a href="tutorials/contribution-guidelines.html">阅读贡献指南</a> 开始！感谢这些参与过 LiquidJS 项目的人：'
-  sponsors:
-    title: 赞助
-    description: '如果你喜欢 LiquidJS 或你的公司在使用 LiquidJS，请考虑 <a href="tutorials/contribution-guidelines.html#成为赞助者！">赞助 LiquidJS</a>！'
-
-playground:
-  title: 演示
-  loading: 加载中...
-
-page:
-  contents: 目录
-  back_to_top: 回到顶部
-  improve: 改进这篇文档
-  report: 报告问题
-  prev: 上一页
-  next: 下一页
-  last_updated: 上次更新：%s
-
-sidebar:
-  tutorials:
-    getting_started: 开始使用
-    intro: Liquid 简介
-    setup: 安装
-    options: 选项
-    render_file: 文件渲染
-    partials: 引用/继承
-    express: Express.js 中使用
-
-    advanced: 高级主题
-    caching: 缓存
-    escaping: 转义
-    registration: 注册标签/过滤器
-    access_scope_in_filters: 过滤器里访问上下文
-    parse_parameters: 参数解析
-    render_tag_content: 渲染标签内容
-    drops: Liquid Drop
-    sync_and_async: 同步和异步
-    whitespace: 换行和缩进
-    plugins: 插件
-    operators: 运算符
-    truth: 真和假
-    security_model: 安全模型
-    static_analysis: 静态分析
-
-    miscellaneous: 其他
-    migration9: '迁移到 LiquidJS 9'
-    contribution_guidelines: '贡献指南'
-    differences: 与 Shopify/liquid 的不同
-    changelog: '更新日志'
-  filters:
-    overview: 概述
-  tags:
-    overview: 概述
-
-footer:
-  license: '本文档通过 <a href="http://creativecommons.org/licenses/by/4.0/" target="_blank">CC BY 4.0</a> 授权。'
\ No newline at end of file
diff --git a/docs/themes/navy/layout/index.swig b/docs/themes/navy/layout/index.swig
index 282fb45c3..7b30eeabf 100644
--- a/docs/themes/navy/layout/index.swig
+++ b/docs/themes/navy/layout/index.swig
@@ -1,33 +1,28 @@
 <header id="banner" class="wrapper">
   <div class="inner inner-content">
     <h2 id="banner-title">{{ page.subtitle }}</h2>
+    <div id="banner-share">{{ partial('partial/share') }}</div>
     <div id="banner-start">
       <code id="banner-start-command">npm install liquidjs</code><a id="banner-start-link" href="./tutorials/setup.html"><i class="icon-arrow-right"></i></a>
     </div>
-    <div id="banner-share">{{ partial('partial/share') }}</div>
   </div>
 </header>
-<div id="intro-news-list">
-  <div class="wrapper">
-    <div class="inner inner-content">
-      <div id="intro-news-flex">
-        {% for news in site.data.news %}
-        <a href="{{news.url}}" class="intro-news-wrap">
-          <div class="intro-news-time">{{news.date}}</div>
-          <div class="intro-news-title">{{news.title[page.lang]}}</div>
-        </a>
-        {% endfor %}
-      </div>
-    </div>
-  </div>
-</div>
 <div id="content-wrap">
   <div class="wrapper">
     <div class="inner inner-content">
       {{ page.content }}
-      <div id="intro-cmd-wrap" class="highlight typescript"><pre><span class="line"><span class="keyword">import</span> { Liquid } <span class="keyword">from</span> <span class="string">'liquidjs'</span></span><br><span class="line"><span class="keyword">const</span> engine = <span class="keyword">new</span> Liquid()</span><br><span class="line"><span class="keyword">const</span> tpl = engine.parse(<span class="string">'Welcome to {% raw %}{{v}}{% endraw %}!'</span>)</span><br><span class="line">engine.render(tpl, {<span class="attr">v</span>: <span class="string">"Liquid"</span>}).then(<span class="built_in">console</span>.log)</span><br><span class="line"><span class="comment">// Outputs "Welcome to Liquid!"</span></span><br></pre></div>
-      <div id="intro-get-started-wrap">
-        <a href="tutorials/setup.html" id="intro-get-started-link">{{ __('index.get_started') }}</a>
+    </div>
+  </div>
+</div>
+<div id="contributors-wrap">
+  <div class="wrapper">
+    <div class="inner inner-content">
+      <div class="section-header">
+        <h3>{{__('index.contributors.title')}}</h3>
+        <p class="description">{{__('index.contributors.description')}}</p>
+      </div>
+      <div class="contributors">
+        {{ partial('partial/all-contributors') }}
       </div>
     </div>
   </div>
@@ -35,22 +30,13 @@
 <div id="sponsors-wrap">
   <div class="wrapper">
     <div class="inner inner-content">
-      <h3>{{__('index.sponsors.title')}}</h3>
-      <p class="description">{{__('index.sponsors.description')}}</p>
+      <div class="section-header">
+        <h3>{{__('index.sponsors.title')}}</h3>
+        <p class="description">{{__('index.sponsors.description')}}</p>
+      </div>
       <div class="contributors">
         {{ partial('partial/financial-contributors') }}
       </div>
     </div>
   </div>
 </div>
-<div id="contributors-wrap">
-  <div class="wrapper">
-    <div class="inner inner-content">
-      <h3>{{__('index.contributors.title')}}</h3>
-      <p class="description">{{__('index.contributors.description')}}</p>
-      <div class="contributors">
-        {{ partial('partial/all-contributors') }}
-      </div>
-    </div>
-  </div>
-</div>
diff --git a/docs/themes/navy/layout/partial/header.swig b/docs/themes/navy/layout/partial/header.swig
index 0dfcdda71..78eeda2ce 100644
--- a/docs/themes/navy/layout/partial/header.swig
+++ b/docs/themes/navy/layout/partial/header.swig
@@ -10,15 +10,19 @@
         <input type="search" id="search-input" placeholder="{{__('menu.search')}}...">
       </div>
     </nav>
-    <div class="main-nav-link icon-nav-link">
-      <label><i class="icon-network"></i> <span class="icon-nav-title">{{ lang_name(page.lang) }}</span></label>
-      <select id="lang-select" data-canonical="{{ canonical_path_for_nav() }}">
-        {% for lang in site.data.languages %}
-          <option value="{{ loop.key }}"{% if page.lang === loop.key %} selected{% endif %}>{{ lang_name(loop.key) }}</option>
-        {% endfor %}
-      </select>
+    <div class="main-nav-link icon-nav-link github-buttons-wrap"> 
+      <span class="gh-star">
+        <a class="gh-btn" href="https://github.com/harttle/liquidjs" target="_blank" rel="noopener" aria-label="Star harttle/liquidjs on GitHub">
+          <svg class="gh-btn-icon" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path></svg>
+          <span>Star</span>
+        </a>
+        <a class="gh-count" id="gh-star-count" href="https://github.com/harttle/liquidjs" target="_blank" rel="noopener" aria-label="harttle/liquidjs stargazers"></a>
+      </span>
+      <a class="gh-btn gh-sponsor" href="https://github.com/sponsors/harttle" target="_blank" rel="noopener" aria-label="Sponsor @harttle on GitHub">
+        <svg class="gh-btn-icon" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path></svg>
+        <span>Sponsor</span>
+      </a>
     </div>
-    <a href="https://github.com/{{ config.github }}" class="main-nav-link icon-nav-link"><i class="icon-github"></i> <span class="icon-nav-title">GitHub</span></a>
     <a id="mobile-nav-toggle">
       <span class="mobile-nav-toggle-bar"></span>
       <span class="mobile-nav-toggle-bar"></span>
diff --git a/docs/themes/navy/layout/partial/mobile_nav.swig b/docs/themes/navy/layout/partial/mobile_nav.swig
index bacd27ebb..8c46909eb 100644
--- a/docs/themes/navy/layout/partial/mobile_nav.swig
+++ b/docs/themes/navy/layout/partial/mobile_nav.swig
@@ -12,13 +12,5 @@
   <div id="mobile-button-list">
     <a href="https://github.com/{{ config.github }}" class="mobile-nav-link" rel="external" target="_blank"><i class="icon-github"></i></a>
     <a href="https://opencollective.com/liquidjs" class="mobile-nav-link" rel="external" target="_blank"><i class="icon-opencollective"></i></a>
-    <div id="mobile-lang-select-wrap" class="mobile-nav-link">
-      <label for="mobile-lang-select"><i class="icon-network"></i></label>
-      <select id="mobile-lang-select" data-canonical="{{ canonical_path_for_nav() }}">
-        {% for lang in site.data.languages %}
-          <option value="{{ loop.key }}"{% if page.lang === loop.key %} selected{% endif %}>{{ lang_name(loop.key) }}</option>
-        {% endfor %}
-      </select>
-    </div>
   </div>
 </nav>
\ No newline at end of file
diff --git a/docs/themes/navy/layout/partial/share.swig b/docs/themes/navy/layout/partial/share.swig
index bdc730bb3..2076d9dc1 100644
--- a/docs/themes/navy/layout/partial/share.swig
+++ b/docs/themes/navy/layout/partial/share.swig
@@ -1,5 +1,3 @@
-<!-- GitHub star -->
-<a href="https://github.com/harttle/liquidjs" target="_blank"><img src="https://img.shields.io/github/stars/harttle/liquidjs?style=flat-square" alt="Star"></a>
 <!-- NPM Download -->
 <a href="https://www.npmjs.com/package/liquidjs" target="_blank"><img src ="https://img.shields.io/npm/dm/liquidjs?logo=npm&style=flat-square" alt="NPM Downloads"></a>
 <!-- Contributors button -->
diff --git a/docs/themes/navy/source/css/_partial/header.styl b/docs/themes/navy/source/css/_partial/header.styl
index d9397b192..6c88a3a43 100644
--- a/docs/themes/navy/source/css/_partial/header.styl
+++ b/docs/themes/navy/source/css/_partial/header.styl
@@ -80,12 +80,70 @@ logo-size = 36px
   @media mq-normal
     display: block
 
-#lang-select
-  opacity: 0
-  position: absolute
-  top: 0
-  left: 0
-  width: 100%
-  height: 100%
-  -webkit-appearance: menulist-button
-  font-size: inherit
+@media mq-normal
+  .github-buttons-wrap
+    display: flex
+    align-items: center
+    line-height: normal
+    opacity: 1
+    span
+      display: inline-flex
+      align-items: center
+
+.gh-star
+  display: inline-flex
+  margin-right: 12px
+  .gh-btn
+    border-radius: 0.25em 0 0 0.25em
+
+.gh-btn, .gh-count
+  font: 600 12px/16px -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif
+  box-sizing: content-box
+  display: inline-flex
+  align-items: center
+  height: 16px
+  padding: 5px 10px
+  border: 1px solid #d1d9e0
+  color: #25292e
+  white-space: nowrap
+
+.gh-btn
+  border-radius: 0.25em
+  background-color: #ebf0f4
+  background-image: linear-gradient(180deg, #f6f8fa, #ebf0f4 90%)
+  span
+    margin-left: 4px
+  &:hover, &:focus
+    color: #25292e
+    text-decoration: none
+    background-color: #e5eaee
+    background-image: linear-gradient(180deg, #eff2f5, #e5eaee 90%)
+
+.gh-btn-icon
+  fill: currentColor
+
+.gh-count
+  border-left: 0
+  border-radius: 0 0.25em 0.25em 0
+  background-color: #fff
+  &:hover, &:focus
+    color: #0969da
+    text-decoration: none
+  &:empty
+    display: none
+
+@media (prefers-color-scheme: dark)
+  .gh-btn, .gh-count
+    border-color: #3d444d
+    color: #f0f6fc
+  .gh-btn
+    background-color: #1a2026
+    background-image: linear-gradient(180deg, #212830, #1a2026 90%)
+    &:hover, &:focus
+      color: #f0f6fc
+      background-color: #1f242c
+      background-image: linear-gradient(180deg, #262c36, #1f242c 90%)
+  .gh-count
+    background-color: #0d1117
+    &:hover, &:focus
+      color: #388bfd
diff --git a/docs/themes/navy/source/css/_partial/index.styl b/docs/themes/navy/source/css/_partial/index.styl
index 522973a84..082d7a927 100644
--- a/docs/themes/navy/source/css/_partial/index.styl
+++ b/docs/themes/navy/source/css/_partial/index.styl
@@ -23,10 +23,12 @@
 
 #banner-start
   text-align: center
-  padding: 40px 0
+  padding: 40px 0 48px
   line-height: 47px;
+  @media mq-tablet
+    padding-bottom: 64px
   @media mq-normal
-    padding: 60px 0
+    padding-top: 60px
     font-size: 18px
 
 #banner-start-command
@@ -51,52 +53,15 @@
 
 #banner-share
   display: block
-  padding-bottom: 60px
-
-#intro-news-list
-  background-color: var(--color-news-bg)
-  margin: -1px 0
-
-#intro-news-flex
-  display: flex
-  flex-flow: column
-  @media mq-normal
-    flex-flow: row wrap
-
-.intro-news-wrap
-  padding: 24px 30px
-  text-decoration: none
-  &:first-child
-    padding-left: 0
-  &:last-child
-    padding-right: 0
-  &:hover
-    background-color: var(--color-link-hover)
-  @media mq-normal
-    flex: 0 0 50%
-    padding: 36px 30px
-  @media screen and (min-width: 960px)
-    flex: 0 0 25%
-
-.intro-news-time
-  font-size: 14px
-  color: rgba(255,255,255,.6)
-
-.intro-news-wrap:hover .intro-news-time
-  color: rgba(255,255,255,.8)
-
-.intro-news-title
-  padding-top: 4px
-  font-size: 15px
-  line-height: 1.2;
-  color: #fff
+  padding-top: 24px
 
 #intro-feature-list
   display: flex
   flex-flow: column
-  margin: 30px 0
+  margin: 30px 0 50px
   @media mq-normal
     flex-flow: row wrap
+    margin: 30px 0 80px
 
 .intro-feature-wrap
   margin-top: 20px
@@ -112,7 +77,7 @@
     padding-left: 48px
 
 .intro-feature-icon
-  color: var(--color-link)
+  color: var(--color-default)
   font-size: 36px
   margin-bottom: 6px;
   text-align: center
@@ -125,36 +90,22 @@
     width: @font-size
 
 .intro-feature-title
-  color: var(--color-link)
+  color: var(--color-default)
   font-size: 24px
 
 .intro-feature-desc
+  color: var(--color-gray)
   margin-top: 1em
   @media mq-normal
     margin-top: line-height
   line-height: line-height
   a
     text-decoration: none
-    color: black
-    &:visited, &:hover
-      color: black
+    color: var(--color-link)
     &:hover
-      text-decoration: underline
-    @media (prefers-color-scheme: dark)
-      color: white
-      &:visited, &:hover
-        color: white
-
-#intro-cmd-wrap
-  max-width: 700px
-  padding: 15px 30px
-  font-size: 16px
-  pre
-    line-height: 32px
-  overflow: auto
-  margin: 50px auto 0;
-  @media mq-normal
-    margin: 70px auto 0;
+      color: var(--color-link-hover)
+  code
+    color: var(--color-gray)
 
 #intro-get-started-wrap
   text-align: center
@@ -186,18 +137,36 @@
     @media mq-tablet
       margin-top: 64px
       margin-bottom: 64px
+    .section-header
+      display: flex
+      align-items: baseline
+      justify-content: space-between
+      gap: 16px
+      margin: 0 0 24px
+      flex-wrap: wrap
+      h3
+        margin: 0
+        flex-shrink: 0
+      p.description
+        margin: 0
+        text-align: right
+        flex: 1
+        min-width: 0
+        color: var(--color-gray)
     h3
       color: #fff
       font-size: 32px
     p
       color: #ccc
-      margin: 36px 0 24px
       font-size: 20px
       line-height: 1.5
     .description a
       text-decoration: none
+      color: var(--color-link)
+      &:hover
+        color: var(--color-link-hover)
 
-#contributors-wrap
+#sponsors-wrap
   background: var(--color-content-bg)
   .inner
     h3
@@ -206,28 +175,13 @@
       color: var(--color-gray)
     .open-collective
       max-width: 100%
-    .description a
-      color: #333
-      &:hover
-        background: var(--color-navy)
-        color: #fff
     @media (prefers-color-scheme: dark)
       p
         color: var(--color-default)
-      .description a
-        color: #fff
-        &:hover
-          background: #fff
-          color: var(--color-navy-lighter)
 
-#sponsors-wrap
+#contributors-wrap
   border: none
   overflow: hidden;
-  .description a
-    color: #fff
-    &:hover
-      background: #fff
-      color: var(--color-navy-lighter)
 
 .contributors
   tr
diff --git a/docs/themes/navy/source/css/_partial/page.styl b/docs/themes/navy/source/css/_partial/page.styl
index 31337fdf5..91dc926fd 100644
--- a/docs/themes/navy/source/css/_partial/page.styl
+++ b/docs/themes/navy/source/css/_partial/page.styl
@@ -245,7 +245,4 @@ $article-footer-link
   right: 0
 
 .article-footer-updated
-  font-size: 0.9em
-
-[lang="zh-cn"] .since::before
-  content: "支持版本："
\ No newline at end of file
+  font-size: 0.9em
\ No newline at end of file
diff --git a/docs/themes/navy/source/css/_variables.styl b/docs/themes/navy/source/css/_variables.styl
index 1cf1e1e94..3ea093110 100644
--- a/docs/themes/navy/source/css/_variables.styl
+++ b/docs/themes/navy/source/css/_variables.styl
@@ -10,7 +10,6 @@ vendor-prefixes = webkit moz ms official
     --color-border: #e3e3e3
     --color-navy: hsl(210, 25%, 12%)
     --color-content-bg: #fff
-    --color-news-bg: darken(hsl(210, 25%, 12%), 5%)
     --color-navy-lighter: lighten(hsl(210, 25%, 12%), 10%)
     --color-link: #0e83cd
     --color-link-hover: lighten(#0e83cd, 10%)
@@ -24,7 +23,6 @@ vendor-prefixes = webkit moz ms official
         --color-border: #6a6a6a
         --color-background: #fff
         --color-navy: hsl(210, 25%, 12%)
-        --color-news-bg: darken(hsl(210, 25%, 12%), 5%)
         --color-navy-lighter: lighten(hsl(210, 25%, 12%), 7%)
         --color-content-bg: #1c1c1c
         --color-link: #0e83cd
diff --git a/docs/themes/navy/source/js/main.js b/docs/themes/navy/source/js/main.js
index 2a33323cb..88e4f3702 100644
--- a/docs/themes/navy/source/js/main.js
+++ b/docs/themes/navy/source/js/main.js
@@ -36,25 +36,6 @@
   }
 }());
 
-(function() {
-  // lang select
-  function changeLang() {
-    var lang = this.value;
-    var canonical = this.dataset.canonical;
-    var path = '/';
-    if (lang !== 'en') path += lang + '/';
-
-    var expires = new Date();
-    expires.setFullYear(expires.getFullYear() + 1);
-    document.cookie = 'nf_lang=' + lang + ';path=/;expires=' + expires.toGMTString();
-
-    location.href = path + canonical;
-  }
-
-  document.getElementById('lang-select').addEventListener('change', changeLang);
-  document.getElementById('mobile-lang-select').addEventListener('change', changeLang);
-}());
-
 (function() {
   // playground
   /* global liquidjs, ace */
@@ -144,6 +125,28 @@
   }
 }());
 
+(function() {
+  // GitHub star count
+  var el = document.getElementById('gh-star-count');
+  if (!el) return;
+  el.textContent = '1.8K';
+  if (!window.fetch) return;
+
+  fetch('https://api.github.com/repos/harttle/liquidjs')
+    .then(function(res) { return res.json(); })
+    .then(function(data) {
+      if (typeof data.stargazers_count === 'number') {
+        el.textContent = format(data.stargazers_count);
+      }
+    });
+
+  function format(n) {
+    if (n < 1000) return String(n);
+    var k = n / 1000;
+    return (k >= 10 ? Math.round(k) : Math.round(k * 10) / 10) + 'k';
+  }
+}());
+
 if ('serviceWorker' in navigator) {
   window.addEventListener('load', function() {
     navigator.serviceWorker.register('/sw.js').then(function(reg) {
diff --git a/package-lock.json b/package-lock.json
index ab2b103bb..e0154c1ba 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -45,7 +45,6 @@
         "eslint-plugin-promise": "^4.0.1",
         "eslint-plugin-standard": "^4.0.0",
         "express": "^4.16.4",
-        "husky": "^4.2.5",
         "jest": "^29.5.0",
         "jsdom": "^16.5.0",
         "npm-run-all2": "^8.0.4",
@@ -4087,12 +4086,6 @@
         "dot-prop": "^5.1.0"
       }
     },
-    "node_modules/compare-versions": {
-      "version": "3.6.0",
-      "resolved": "https://registry.npmjs.org/compare-versions/-/compare-versions-3.6.0.tgz",
-      "integrity": "sha512-W6Af2Iw1z4CB7q4uU4hv646dW9GQuBM+YpC0UvUCWSD8w90SJjp+ujJuXaEMtAXBtSqGfMPuFOVn4/+FlaqfBA==",
-      "dev": true
-    },
     "node_modules/component-emitter": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.3.0.tgz",
@@ -6199,21 +6192,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/find-versions": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/find-versions/-/find-versions-4.0.0.tgz",
-      "integrity": "sha512-wgpWy002tA+wgmO27buH/9KzyEOQnKsG/R0yrcjPT9BOFm0zRBVQbZ95nRGXWMywS8YR5knRbpohio0bcJABxQ==",
-      "dev": true,
-      "dependencies": {
-        "semver-regex": "^3.1.2"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/flat-cache": {
       "version": "3.0.4",
       "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-3.0.4.tgz",
@@ -6978,42 +6956,6 @@
         "node": ">=10.17.0"
       }
     },
-    "node_modules/husky": {
-      "version": "4.3.8",
-      "resolved": "https://registry.npmjs.org/husky/-/husky-4.3.8.tgz",
-      "integrity": "sha512-LCqqsB0PzJQ/AlCgfrfzRe3e3+NvmefAdKQhRYpxS4u6clblBoDdzzvHi8fmxKRzvMxPY/1WZWzomPZww0Anow==",
-      "dev": true,
-      "hasInstallScript": true,
-      "dependencies": {
-        "chalk": "^4.0.0",
-        "ci-info": "^2.0.0",
-        "compare-versions": "^3.6.0",
-        "cosmiconfig": "^7.0.0",
-        "find-versions": "^4.0.0",
-        "opencollective-postinstall": "^2.0.2",
-        "pkg-dir": "^5.0.0",
-        "please-upgrade-node": "^3.2.0",
-        "slash": "^3.0.0",
-        "which-pm-runs": "^1.0.0"
-      },
-      "bin": {
-        "husky-run": "bin/run.js",
-        "husky-upgrade": "lib/upgrader/bin.js"
-      },
-      "engines": {
-        "node": ">=10"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/husky"
-      }
-    },
-    "node_modules/husky/node_modules/ci-info": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-2.0.0.tgz",
-      "integrity": "sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ==",
-      "dev": true
-    },
     "node_modules/iconv-lite": {
       "version": "0.4.24",
       "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
@@ -11641,15 +11583,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/opencollective-postinstall": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/opencollective-postinstall/-/opencollective-postinstall-2.0.3.tgz",
-      "integrity": "sha512-8AV/sCtuzUeTo8gQK5qDZzARrulB3egtLzFgteqB2tcT4Mw7B8Kt7JcDHmltjz6FOAHsvTevk70gZEbhM4ZS9Q==",
-      "dev": true,
-      "bin": {
-        "opencollective-postinstall": "index.js"
-      }
-    },
     "node_modules/optionator": {
       "version": "0.9.1",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.1.tgz",
@@ -12182,15 +12115,6 @@
       "integrity": "sha512-fnWVljUchTro6RiCFvCXBbNhJc2NijN7oIQxbwsyL0buWJPG85v81ehlHI9fXrJsMNgTofEoWIQeClKpgxFLrg==",
       "dev": true
     },
-    "node_modules/please-upgrade-node": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/please-upgrade-node/-/please-upgrade-node-3.2.0.tgz",
-      "integrity": "sha512-gQR3WpIgNIKwBMVLkpMUeR3e1/E1y42bqDQZfql+kDeXd8COYfM8PQA4X6y7a8u9Ua9FHmsrrmirW2vHs45hWg==",
-      "dev": true,
-      "dependencies": {
-        "semver-compare": "^1.0.0"
-      }
-    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
@@ -13969,24 +13893,6 @@
         "node": ">=10"
       }
     },
-    "node_modules/semver-compare": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",
-      "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",
-      "dev": true
-    },
-    "node_modules/semver-regex": {
-      "version": "3.1.4",
-      "resolved": "https://registry.npmjs.org/semver-regex/-/semver-regex-3.1.4.tgz",
-      "integrity": "sha512-6IiqeZNgq01qGf0TId0t3NvKzSvUsjcpdEO3AQNeIjR6A2+ckTnQlDpl4qu1bjRv0RzN3FP9hzFmws3lKqRWkA==",
-      "dev": true,
-      "engines": {
-        "node": ">=8"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/send": {
       "version": "0.18.0",
       "resolved": "https://registry.npmjs.org/send/-/send-0.18.0.tgz",
@@ -15894,15 +15800,6 @@
       "integrity": "sha512-B+enWhmw6cjfVC7kS8Pj9pCrKSc5txArRyaYGe088shv/FGWH+0Rjx/xPgtsWfsUtS27FkP697E4DDhgrgoc0Q==",
       "dev": true
     },
-    "node_modules/which-pm-runs": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/which-pm-runs/-/which-pm-runs-1.1.0.tgz",
-      "integrity": "sha512-n1brCuqClxfFfq/Rb0ICg9giSZqCS+pLtccdag6C2HyufBrh3fBOiy9nb6ggRMvWOVH5GrdJskj5iGTZNxd7SA==",
-      "dev": true,
-      "engines": {
-        "node": ">=4"
-      }
-    },
     "node_modules/which-typed-array": {
       "version": "1.1.9",
       "resolved": "https://registry.npmjs.org/which-typed-array/-/which-typed-array-1.1.9.tgz",
diff --git a/package.json b/package.json
index 4e2e8b696..4821ecb77 100644
--- a/package.json
+++ b/package.json
@@ -97,7 +97,6 @@
     "eslint-plugin-promise": "^4.0.1",
     "eslint-plugin-standard": "^4.0.0",
     "express": "^4.16.4",
-    "husky": "^4.2.5",
     "jest": "^29.5.0",
     "jsdom": "^16.5.0",
     "npm-run-all2": "^8.0.4",
@@ -165,11 +164,5 @@
     "extension": [
       ".ts"
     ]
-  },
-  "husky": {
-    "hooks": {
-      "pre-commit": "npm run check",
-      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
-    }
   }
 }
diff --git a/rollup.config.mjs b/rollup.config.mjs
index 328505fdc..ca7261f10 100644
--- a/rollup.config.mjs
+++ b/rollup.config.mjs
@@ -23,7 +23,8 @@ const tsconfig = (target) => ({
     compilerOptions: {
       target,
       module: 'ES2015',
-      rootDir: 'src'
+      rootDir: 'src',
+      downlevelIteration: true
     }
   }
 })
diff --git a/src/context/context.ts b/src/context/context.ts
index 083a17cfe..b8951056f 100644
--- a/src/context/context.ts
+++ b/src/context/context.ts
@@ -13,7 +13,7 @@ export class Context {
    * for tags like `{% capture %}` `{% assign %}` to operate
    */
   private scopes: Scope[] = [createScope()]
-  private registers = {}
+  private registers: Record<string, any> = {}
   /**
    * user passed in scope
    * `{% increment %}`, `{% decrement %}` changes this scope,
diff --git a/src/drop/drop.ts b/src/drop/drop.ts
index c62768dc2..f83f5576e 100644
--- a/src/drop/drop.ts
+++ b/src/drop/drop.ts
@@ -1,6 +1,7 @@
 import { Context } from '../context'
 
 export abstract class Drop {
+  [key: string]: any
   public liquidMethodMissing (key: string | number, context: Context): Promise<any> | any {
     return undefined
   }
diff --git a/src/filters/html.ts b/src/filters/html.ts
index 21cb8c4a9..807c42373 100644
--- a/src/filters/html.ts
+++ b/src/filters/html.ts
@@ -1,14 +1,14 @@
 import { FilterImpl } from '../template'
 import { stringify } from '../util/underscore'
 
-const escapeMap = {
+const escapeMap: Record<string, string> = {
   '&': '&amp;',
   '<': '&lt;',
   '>': '&gt;',
   '"': '&#34;',
   "'": '&#39;'
 }
-const unescapeMap = {
+const unescapeMap: Record<string, string> = {
   '&amp;': '&',
   '&lt;': '<',
   '&gt;': '>',
diff --git a/src/liquid-options.ts b/src/liquid-options.ts
index a1e062088..e6fc5d1f0 100644
--- a/src/liquid-options.ts
+++ b/src/liquid-options.ts
@@ -72,7 +72,7 @@ export interface LiquidOptions {
   fs?: FS;
   /** keyValue separator */
   keyValueSeparator?: string;
-  /** Render from in-memory `templates` mapping instead of file system. File system related options like `fs`, 'root', and `relativeReference` will be ignored when `templates` is specified. */
+  /** Render from an in-memory `templates` mapping instead of the file system. When `templates` is set, Liquid uses the provided mapping for template lookup (including includes, layouts, and partials), and file-system options such as `fs`, `root`, `partials`, `layouts`, and `relativeReference` are effectively bypassed for those lookups. */
   templates?: {[key: string]: string};
   /** the global scope passed down to all partial and layout templates, i.e. templates included by `include`, `layout` and `render` tags. */
   globals?: object;
diff --git a/src/parser/tokenizer.ts b/src/parser/tokenizer.ts
index 0c2d86df7..be8ac136b 100644
--- a/src/parser/tokenizer.ts
+++ b/src/parser/tokenizer.ts
@@ -1,6 +1,6 @@
 import { FilteredValueToken, TagToken, HTMLToken, HashToken, QuotedToken, LiquidTagToken, OutputToken, ValueToken, Token, RangeToken, FilterToken, TopLevelToken, PropertyAccessToken, OperatorToken, LiteralToken, IdentifierToken, NumberToken } from '../tokens'
 import { OperatorHandler } from '../render/operator'
-import { TrieNode, LiteralValue, Trie, createTrie, ellipsis, literalValues, TokenizationError, TYPES, QUOTE, BLANK, NUMBER, SIGN, isWord, isString } from '../util'
+import { LiteralValue, Trie, createTrie, ellipsis, literalValues, TokenizationError, TYPES, QUOTE, BLANK, NUMBER, SIGN, isWord, isString } from '../util'
 import { Operators, Expression } from '../render'
 import { NormalizedFullOptions, defaultOptions } from '../liquid-options'
 import { FilterArg } from './filter-arg'
@@ -51,11 +51,11 @@ export class Tokenizer {
     return new OperatorToken(this.input, this.p, (this.p = end), this.file)
   }
   matchTrie<T> (trie: Trie<T>) {
-    let node: TrieNode<T> = trie
+    let node: Trie<T> = trie
     let i = this.p
-    let info
-    while (node[this.input[i]] && i < this.N) {
-      node = node[this.input[i++]]
+    let info: Trie<T> | undefined
+    while ((node as Trie<T>)[this.input[i]] && i < this.N) {
+      node = (node as Trie<T>)[this.input[i++]] as Trie<T>
       if (node['end']) info = node
     }
     if (!info) return -1
diff --git a/src/render/string.ts b/src/render/string.ts
index c1e8f1a3e..91b726367 100644
--- a/src/render/string.ts
+++ b/src/render/string.ts
@@ -1,6 +1,6 @@
 const rHex = /[\da-fA-F]/
 const rOct = /[0-7]/
-const escapeChar = {
+const escapeChar: Record<string, string> = {
   b: '\b',
   f: '\f',
   n: '\n',
diff --git a/src/tags/for.ts b/src/tags/for.ts
index fec0b0603..198750116 100644
--- a/src/tags/for.ts
+++ b/src/tags/for.ts
@@ -52,7 +52,7 @@ export default class extends Tag {
 
     const continueKey = 'continue-' + this.variable + '-' + this.collection.getText()
     ctx.push(createScope({ continue: ctx.getRegister(continueKey, {}) }))
-    const hash = yield this.hash.render(ctx)
+    const hash = (yield this.hash.render(ctx)) as Record<string, any>
     ctx.pop()
 
     const modifiers = this.liquid.options.orderedFilterParameters
diff --git a/src/tags/include.ts b/src/tags/include.ts
index 0db1ee749..a00dda4e2 100644
--- a/src/tags/include.ts
+++ b/src/tags/include.ts
@@ -3,16 +3,18 @@ import { BlockMode, createScope, Scope } from '../context'
 import { Parser } from '../parser'
 import { Argument, Arguments, PartialScope } from '../template'
 import { isString, isValueToken } from '../util'
-import { parseFilePath, renderFilePath } from './render'
+import { parseFilePath, renderFilePath, ParsedFileName } from './render'
 
 export default class extends Tag {
+  private file: ParsedFileName
+  private currentFile?: string
   private withVar?: ValueToken
   private hash: Hash
   constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid, parser: Parser) {
     super(token, remainTokens, liquid)
     const { tokenizer } = token
-    this['file'] = parseFilePath(tokenizer, this.liquid, parser)
-    this['currentFile'] = token.file
+    this.file = parseFilePath(tokenizer, this.liquid, parser)
+    this.currentFile = token.file
 
     const begin = tokenizer.p
     const withStr = tokenizer.readIdentifier()
@@ -28,7 +30,7 @@ export default class extends Tag {
   * render (ctx: Context, emitter: Emitter): Generator<unknown, void, unknown> {
     const { liquid, hash, withVar } = this
     const { renderer } = liquid
-    const filepath = (yield renderFilePath(this['file'], ctx, liquid)) as string
+    const filepath = (yield renderFilePath(this.file, ctx, liquid)) as string
     assert(filepath, () => `illegal file path "${filepath}"`)
 
     const saved = ctx.saveRegister('blocks', 'blockMode')
@@ -36,7 +38,7 @@ export default class extends Tag {
     ctx.setRegister('blockMode', BlockMode.OUTPUT)
     const scope = createScope((yield hash.render(ctx)) as Scope)
     if (withVar) scope[filepath] = yield evalToken(withVar, ctx)
-    const templates = (yield liquid._parsePartialFile(filepath, ctx.sync, this['currentFile'])) as Template[]
+    const templates = (yield liquid._parsePartialFile(filepath, ctx.sync, this.currentFile)) as Template[]
     ctx.push(ctx.opts.jekyllInclude ? createScope({ include: scope }) : scope)
     yield renderer.renderTemplates(templates, ctx, emitter)
     ctx.pop()
@@ -44,14 +46,14 @@ export default class extends Tag {
   }
 
   public * children (partials: boolean, sync: boolean): Generator<unknown, Template[]> {
-    if (partials && isString(this['file'])) {
-      return (yield this.liquid._parsePartialFile(this['file'], sync, this['currentFile'])) as Template[]
+    if (partials && isString(this.file)) {
+      return (yield this.liquid._parsePartialFile(this.file, sync, this.currentFile)) as Template[]
     }
     return []
   }
 
   public partialScope (): PartialScope | undefined {
-    if (isString(this['file'])) {
+    if (isString(this.file)) {
       let names: Array<string | [string, Argument]>
 
       if (this.liquid.options.jekyllInclude) {
@@ -59,19 +61,19 @@ export default class extends Tag {
       } else {
         names = Object.keys(this.hash.hash)
         if (this.withVar) {
-          names.push([this['file'], this.withVar])
+          names.push([this.file, this.withVar])
         }
       }
 
-      return { name: this['file'], isolated: false, scope: names }
+      return { name: this.file, isolated: false, scope: names }
     }
   }
 
   public * arguments (): Arguments {
     yield * Object.values(this.hash.hash).filter(isValueToken)
 
-    if (isValueToken(this['file'])) {
-      yield this['file']
+    if (isValueToken(this.file)) {
+      yield this.file
     }
 
     if (isValueToken(this.withVar)) {
diff --git a/src/tags/layout.ts b/src/tags/layout.ts
index ab2b3b539..156ab0ee4 100644
--- a/src/tags/layout.ts
+++ b/src/tags/layout.ts
@@ -10,10 +10,11 @@ export default class extends Tag {
   args: Hash
   templates: Template[]
   file?: ParsedFileName
+  private currentFile?: string
   constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid, parser: Parser) {
     super(token, remainTokens, liquid)
     this.file = parseFilePath(this.tokenizer, this.liquid, parser)
-    this['currentFile'] = token.file
+    this.currentFile = token.file
     this.args = new Hash(this.tokenizer, liquid.options.keyValueSeparator)
     this.templates = parser.parseTokens(remainTokens)
   }
@@ -27,7 +28,7 @@ export default class extends Tag {
     }
     const filepath = (yield renderFilePath(this.file, ctx, liquid)) as string
     assert(filepath, () => `illegal file path "${filepath}"`)
-    const templates = (yield liquid._parseLayoutFile(filepath, ctx.sync, this['currentFile'])) as Template[]
+    const templates = (yield liquid._parseLayoutFile(filepath, ctx.sync, this.currentFile)) as Template[]
 
     // render remaining contents and store rendered results
     ctx.setRegister('blockMode', BlockMode.STORE)
@@ -48,7 +49,7 @@ export default class extends Tag {
     const templates = this.templates.slice()
 
     if (partials && isString(this.file)) {
-      templates.push(...(yield this.liquid._parsePartialFile(this.file, true, this['currentFile'])) as Template[])
+      templates.push(...(yield this.liquid._parsePartialFile(this.file, true, this.currentFile)) as Template[])
     }
 
     return templates
diff --git a/src/tags/render.ts b/src/tags/render.ts
index 123e73a93..bf86a28cb 100644
--- a/src/tags/render.ts
+++ b/src/tags/render.ts
@@ -1,16 +1,20 @@
 import { __assign } from 'tslib'
 import { ForloopDrop } from '../drop'
 import { isString, isValueToken, toEnumerable } from '../util'
-import { TopLevelToken, assert, Liquid, Token, Template, evalQuotedToken, TypeGuards, Tokenizer, evalToken, Hash, Emitter, TagToken, Context, Tag } from '..'
+import { TopLevelToken, assert, Liquid, Token, ValueToken, Template, evalQuotedToken, TypeGuards, Tokenizer, evalToken, Hash, Emitter, TagToken, Context, Tag } from '..'
 import { Parser } from '../parser'
 import { Argument, Arguments, PartialScope } from '../template'
 
 export type ParsedFileName = Template[] | Token | string | undefined
 
+type RenderBinding = { value: ValueToken; alias?: string }
+
 export default class extends Tag {
   private file: ParsedFileName
   private currentFile?: string
   private hash: Hash
+  private with?: RenderBinding
+  private forBinding?: RenderBinding
   constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid, parser: Parser) {
     super(token, remainTokens, liquid)
     const tokenizer = this.tokenizer
@@ -33,7 +37,9 @@ export default class extends Tag {
             if (asStr.content === 'as') alias = tokenizer.readIdentifier()
             else tokenizer.p = beforeAs
 
-            this[keyword.content] = { value, alias: alias && alias.content }
+            const binding: RenderBinding = { value, alias: alias && alias.content }
+            if (keyword.content === 'with') this.with = binding
+            else this.forBinding = binding
             tokenizer.skipBlank()
             if (tokenizer.peek() === ',') tokenizer.advance()
             continue // matched!
@@ -50,46 +56,46 @@ export default class extends Tag {
   }
   * render (ctx: Context, emitter: Emitter): Generator<unknown, void, unknown> {
     const { liquid, hash } = this
-    const filepath = (yield renderFilePath(this['file'], ctx, liquid)) as string
+    const filepath = (yield renderFilePath(this.file, ctx, liquid)) as string
     assert(filepath, () => `illegal file path "${filepath}"`)
 
     const childCtx = ctx.spawn()
     const scope = childCtx.bottom()
     __assign(scope, yield hash.render(ctx))
-    if (this['with']) {
-      const { value, alias } = this['with']
+    if (this.with) {
+      const { value, alias } = this.with
       scope[alias || filepath] = yield evalToken(value, ctx)
     }
 
-    if (this['for']) {
-      const { value, alias } = this['for']
+    if (this.forBinding) {
+      const { value, alias } = this.forBinding
       const collection = toEnumerable(yield evalToken(value, ctx))
-      scope['forloop'] = new ForloopDrop(collection.length, value.getText(), alias)
+      scope['forloop'] = new ForloopDrop(collection.length, value.getText(), alias as string)
       for (const item of collection) {
-        scope[alias] = item
-        const templates = (yield liquid._parsePartialFile(filepath, childCtx.sync, this['currentFile'])) as Template[]
+        scope[alias as string] = item
+        const templates = (yield liquid._parsePartialFile(filepath, childCtx.sync, this.currentFile)) as Template[]
         yield liquid.renderer.renderTemplates(templates, childCtx, emitter)
         scope['forloop'].next()
       }
     } else {
-      const templates = (yield liquid._parsePartialFile(filepath, childCtx.sync, this['currentFile'])) as Template[]
+      const templates = (yield liquid._parsePartialFile(filepath, childCtx.sync, this.currentFile)) as Template[]
       yield liquid.renderer.renderTemplates(templates, childCtx, emitter)
     }
   }
 
   public * children (partials: boolean, sync: boolean): Generator<unknown, Template[]> {
-    if (partials && isString(this['file'])) {
-      return (yield this.liquid._parsePartialFile(this['file'], sync, this['currentFile'])) as Template[]
+    if (partials && isString(this.file)) {
+      return (yield this.liquid._parsePartialFile(this.file, sync, this.currentFile)) as Template[]
     }
     return []
   }
 
   public partialScope (): PartialScope | undefined {
-    if (isString(this['file'])) {
+    if (isString(this.file)) {
       const names: Array<string | [string, Argument]> = Object.keys(this.hash.hash)
 
-      if (this['with']) {
-        const { value, alias } = this['with']
+      if (this.with) {
+        const { value, alias } = this.with
         if (isString(alias)) {
           names.push([alias, value])
         } else if (isString(this.file)) {
@@ -97,8 +103,8 @@ export default class extends Tag {
         }
       }
 
-      if (this['for']) {
-        const { value, alias } = this['for']
+      if (this.forBinding) {
+        const { value, alias } = this.forBinding
         if (isString(alias)) {
           names.push([alias, value])
         } else if (isString(this.file)) {
@@ -106,7 +112,7 @@ export default class extends Tag {
         }
       }
 
-      return { name: this['file'], isolated: true, scope: names }
+      return { name: this.file, isolated: true, scope: names }
     }
   }
 
@@ -117,15 +123,15 @@ export default class extends Tag {
       }
     }
 
-    if (this['with']) {
-      const { value } = this['with']
+    if (this.with) {
+      const { value } = this.with
       if (isValueToken(value)) {
         yield value
       }
     }
 
-    if (this['for']) {
-      const { value } = this['for']
+    if (this.forBinding) {
+      const { value } = this.forBinding
       if (isValueToken(value)) {
         yield value
       }
diff --git a/src/template/hash.ts b/src/template/hash.ts
index 4899a8045..4ef67c1a2 100644
--- a/src/template/hash.ts
+++ b/src/template/hash.ts
@@ -24,7 +24,7 @@ export class Hash {
   }
 
   * render (ctx: Context): Generator<unknown, Record<string, any>, unknown> {
-    const hash = {}
+    const hash: Record<string, any> = {}
     for (const key of Object.keys(this.hash)) {
       hash[key] = this.hash[key] === undefined ? true : yield evalToken(this.hash[key], ctx)
     }
diff --git a/src/tokens/literal-token.ts b/src/tokens/literal-token.ts
index 2852e2e02..ce60fdfc5 100644
--- a/src/tokens/literal-token.ts
+++ b/src/tokens/literal-token.ts
@@ -1,10 +1,10 @@
 import { Token } from './token'
 import { TokenKind } from '../parser'
-import { literalValues, LiteralValue } from '../util'
+import { literalValues, LiteralValue, LiteralKey } from '../util'
 
 export class LiteralToken extends Token {
   public content: LiteralValue
-  public literal: string
+  public literal: LiteralKey
   public constructor (
     public input: string,
     public begin: number,
@@ -12,7 +12,7 @@ export class LiteralToken extends Token {
     public file?: string
   ) {
     super(TokenKind.Literal, input, begin, end, file)
-    this.literal = this.getText()
+    this.literal = this.getText() as LiteralKey
     this.content = literalValues[this.literal]
   }
 }
diff --git a/src/tokens/operator-token.ts b/src/tokens/operator-token.ts
index ae6724e22..358878278 100644
--- a/src/tokens/operator-token.ts
+++ b/src/tokens/operator-token.ts
@@ -32,8 +32,10 @@ export const operatorTypes = {
   'or': OperatorType.Binary
 }
 
+export type OperatorKey = keyof typeof operatorPrecedences
+
 export class OperatorToken extends Token {
-  public operator: string
+  public operator: OperatorKey
   public constructor (
     public input: string,
     public begin: number,
@@ -41,10 +43,9 @@ export class OperatorToken extends Token {
     public file?: string
   ) {
     super(TokenKind.Operator, input, begin, end, file)
-    this.operator = this.getText()
+    this.operator = this.getText() as OperatorKey
   }
   getPrecedence () {
-    const key = this.getText()
-    return key in operatorPrecedences ? operatorPrecedences[key] : 1
+    return this.operator in operatorPrecedences ? operatorPrecedences[this.operator] : 1
   }
 }
diff --git a/src/util/async.ts b/src/util/async.ts
index c190cd860..137753ded 100644
--- a/src/util/async.ts
+++ b/src/util/async.ts
@@ -18,10 +18,10 @@ export async function toPromise<T> (val: Generator<unknown, T, unknown> | Promis
   if (!isIterator(val)) return val
   let value: unknown
   let done = false
-  let next = 'next'
+  let next: 'next' | 'throw' = 'next'
   do {
     const state = val[next](value)
-    done = state.done
+    done = !!state.done
     value = state.value
     next = 'next'
     try {
@@ -40,10 +40,10 @@ export function toValueSync<T> (val: Generator<unknown, T, unknown> | T): T {
   if (!isIterator(val)) return val
   let value: any
   let done = false
-  let next = 'next'
+  let next: 'next' | 'throw' = 'next'
   do {
     const state = val[next](value)
-    done = state.done
+    done = !!state.done
     value = state.value
     next = 'next'
     if (isIterator(value)) {
diff --git a/src/util/error.ts b/src/util/error.ts
index 8fe76061d..3b5534bab 100644
--- a/src/util/error.ts
+++ b/src/util/error.ts
@@ -29,7 +29,7 @@ export abstract class LiquidError extends Error {
     if (this.originalError) this.stack += '\nFrom ' + this.originalError.stack
   }
   static is (obj: unknown): obj is LiquidError {
-    return obj?.[TRAIT] === 'LiquidError'
+    return (obj as Record<string, unknown> | null | undefined)?.[TRAIT] === 'LiquidError'
   }
 }
 
diff --git a/src/util/operator-trie.ts b/src/util/operator-trie.ts
index e09c90ef0..f94d7138a 100644
--- a/src/util/operator-trie.ts
+++ b/src/util/operator-trie.ts
@@ -4,22 +4,16 @@ interface TrieInput<T> {
   [key: string]: T
 }
 
-interface TrieLeafNode<T> {
-  data: T;
-  end: true;
-  needBoundary?: true;
-}
-
-export interface Trie<T> {
-  [key: string]: Trie<T> | TrieLeafNode<T>;
-}
-
-export type TrieNode<T> = Trie<T> | TrieLeafNode<T>
+export type Trie<T> = {
+  data?: T
+  end?: true
+  needBoundary?: true
+} & Record<string, any>
 
 export function createTrie<T = any> (input: TrieInput<T>): Trie<T> {
   const trie: Trie<T> = {}
   for (const [name, data] of Object.entries(input)) {
-    let node: Trie<T> | TrieLeafNode<T> = trie
+    let node = trie
 
     for (let i = 0; i < name.length; i++) {
       const c = name[i]
diff --git a/src/util/strftime.ts b/src/util/strftime.ts
index e6ac04ebf..8bf8b09d1 100644
--- a/src/util/strftime.ts
+++ b/src/util/strftime.ts
@@ -4,7 +4,7 @@ import type { Limiter } from './limiter'
 
 const rFormat = /%([-_0^#:]+)?(\d+)?([EO])?(.)/
 interface FormatOptions {
-  flags: object;
+  flags: Record<string, boolean>;
   width?: string;
   modifier?: string;
   memoryLimit?: Pick<Limiter, 'use'>;
@@ -50,7 +50,7 @@ function century (d: LiquidDate) {
 }
 
 // default to 0
-const padWidths = {
+const padWidths: Record<string, number> = {
   d: 2,
   e: 2,
   H: 2,
@@ -77,7 +77,9 @@ function getTimezoneOffset (d: LiquidDate, opts: FormatOptions) {
     (opts.flags[':'] ? ':' : '') +
     padStart(m, 2, '0')
 }
-const formatCodes = {
+type FormatCodeHandler = (d: LiquidDate, opts: FormatOptions) => unknown
+
+const formatCodes: Record<string, FormatCodeHandler> = {
   a: (d: LiquidDate) => d.getShortWeekdayName(),
   A: (d: LiquidDate) => d.getLongWeekdayName(),
   b: (d: LiquidDate) => d.getShortMonthName(),
@@ -118,8 +120,8 @@ const formatCodes = {
   't': () => '\t',
   'n': () => '\n',
   '%': () => '%'
-};
-(formatCodes as any).h = formatCodes.b
+}
+formatCodes.h = formatCodes.b
 
 export function strftime (d: LiquidDate, formatStr: string, memoryLimit?: Pick<Limiter, 'use'>) {
   let output = ''
@@ -137,11 +139,11 @@ function format (d: LiquidDate, match: RegExpExecArray, memoryLimit?: Pick<Limit
   const [input, flagStr = '', width, modifier, conversion] = match
   const convert = formatCodes[conversion]
   if (!convert) return input
-  const flags = {}
+  const flags: Record<string, boolean> = {}
   for (const flag of flagStr) flags[flag] = true
   let ret = String(convert(d, { flags, width, modifier, memoryLimit }))
   let padChar = padSpaceChars.has(conversion) ? ' ' : '0'
-  let padWidth = width || padWidths[conversion] || 0
+  let padWidth = Number(width) || padWidths[conversion] || 0
   if (flags['^']) ret = ret.toUpperCase()
   else if (flags['#']) ret = changeCase(ret)
   if (flags['_']) padChar = ' '
diff --git a/test/integration/liquid/liquid.spec.ts b/test/integration/liquid/liquid.spec.ts
index 918b1aabe..e229940a2 100644
--- a/test/integration/liquid/liquid.spec.ts
+++ b/test/integration/liquid/liquid.spec.ts
@@ -1,6 +1,7 @@
 import { Liquid, Context, isFalsy } from '../../../src'
 import { mock, restore } from '../../stub/mockfs'
 import { drainStream } from '../../stub/stream'
+import { resolve } from 'path'
 
 describe('Liquid', function () {
   describe('#plugin()', function () {
@@ -144,7 +145,7 @@ describe('Liquid', function () {
     })
     it('should fallback to require.resolve in Node.js', async function () {
       const engine = new Liquid({
-        root: [process.cwd()],
+        root: [resolve(__dirname, '../../..')],
         extname: '.html'
       })
       const tpls = await engine.parseFileSync('jest')
diff --git a/tsconfig.json b/tsconfig.json
index 258f536b4..0646fbcfe 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -9,9 +9,7 @@
     "skipLibCheck": true,
     "allowSyntheticDefaultImports": true,
     "resolveJsonModule": true,
-    "downlevelIteration": true,
-    "strict": true,
-    "suppressImplicitAnyIndexErrors": true
+    "strict": true
   },
   "all": true,
   "exclude": [ "node_modules", "dist", "demo", "test" ]

From ed15a52c260cbabacec6833b6461893b97a0c570 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 8 Jun 2026 00:26:52 +0800
Subject: [PATCH 51/64] docs: revisit wording & style for liquidjs.com (#906)

* docs: polish theme, playground, and reference pages

Improve readability of the docs site with updated light/dark tokens, shared
code-block styling, and playground editors that follow system color scheme.
Skip CookieHub on localhost, serve the browser bundle from theme source, and
use backtick titles on filter/tag reference pages for consistent navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: highlight npx in bash blocks and polish English copy

Use Prism insertBefore for CLI commands like npx, tighten tutorial and reference wording, and keep YAML titles free of backticks so sidebar and page headings stay correct.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: restore lowercase filter and tag titles

Titles should match actual filter/tag identifiers (e.g. abs, append), not capitalized English labels.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .gitignore                                    |  2 +-
 docs/scripts/helpers.js                       |  2 +
 docs/scripts/prism-bash-extend.js             | 34 +++++++
 docs/source/_data/sidebar.yml                 |  2 +-
 docs/source/filters/date.md                   | 12 +--
 docs/source/filters/json.md                   |  2 +-
 docs/source/filters/overview.md               | 18 ++--
 docs/source/filters/truncate.md               |  2 +-
 docs/source/tags/assign.md                    |  2 +-
 docs/source/tags/case.md                      |  2 +-
 docs/source/tags/comment.md                   |  2 +-
 docs/source/tags/decrement.md                 |  2 +-
 docs/source/tags/echo.md                      |  2 +-
 docs/source/tags/for.md                       |  2 +-
 docs/source/tags/if.md                        |  2 +-
 docs/source/tags/include.md                   | 14 +--
 docs/source/tags/increment.md                 |  2 +-
 docs/source/tags/layout.md                    | 10 +-
 docs/source/tags/liquid.md                    |  2 +-
 docs/source/tags/overview.md                  | 12 +--
 docs/source/tags/raw.md                       |  2 +-
 docs/source/tags/render.md                    |  4 +-
 docs/source/tags/tablerow.md                  |  6 +-
 docs/source/tags/unless.md                    |  2 +-
 .../tutorials/access-scope-in-filters.md      |  4 +-
 docs/source/tutorials/caching.md              |  4 +-
 .../tutorials/contribution-guidelines.md      |  4 +-
 docs/source/tutorials/differences.md          |  6 +-
 docs/source/tutorials/drops.md                |  2 +-
 docs/source/tutorials/escaping.md             |  6 +-
 docs/source/tutorials/intro-to-liquid.md      |  6 +-
 docs/source/tutorials/migrate-to-9.md         |  6 +-
 docs/source/tutorials/operators.md            | 12 +--
 docs/source/tutorials/options.md              | 28 +++---
 docs/source/tutorials/parse-parameters.md     |  4 +-
 docs/source/tutorials/partials-and-layouts.md |  4 +-
 docs/source/tutorials/plugins.md              |  4 +-
 .../source/tutorials/register-filters-tags.md |  2 +-
 docs/source/tutorials/render-file.md          |  4 +-
 docs/source/tutorials/render-tag-content.md   | 12 +--
 docs/source/tutorials/security-model.md       |  4 +-
 docs/source/tutorials/setup.md                |  2 +-
 docs/source/tutorials/static-analysis.md      |  6 +-
 docs/source/tutorials/sync-and-async.md       | 10 +-
 docs/source/tutorials/truthy-and-falsy.md     |  4 +-
 docs/source/tutorials/use-in-expressjs.md     |  4 +-
 docs/source/tutorials/whitespace-control.md   |  4 +-
 docs/themes/navy/layout/partial/head.swig     |  1 +
 .../themes/navy/source/css/_partial/base.styl |  1 +
 .../navy/source/css/_partial/header.styl      |  2 +-
 .../navy/source/css/_partial/highlight.styl   | 45 +++++----
 .../themes/navy/source/css/_partial/page.styl | 47 ++++++----
 .../navy/source/css/_partial/playground.styl  | 85 ++++++++++++++---
 .../navy/source/css/_partial/sidebar.styl     |  2 +-
 docs/themes/navy/source/css/_variables.styl   | 94 +++++++++++++++----
 docs/themes/navy/source/js/main.js            | 44 ++++++---
 package.json                                  |  2 +-
 57 files changed, 403 insertions(+), 204 deletions(-)
 create mode 100644 docs/scripts/prism-bash-extend.js

diff --git a/.gitignore b/.gitignore
index f86209f36..24be3ed8d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,7 +11,7 @@ coverage/
 node_modules/
 
 # tmp
-docs/public/js/liquid.browser.min.js
+docs/themes/navy/source/js/liquid.browser.min.js
 docs/themes/navy/layout/partial/all-contributors.swig
 docs/themes/navy/layout/partial/financial-contributors.swig
 dist/
diff --git a/docs/scripts/helpers.js b/docs/scripts/helpers.js
index e0757c87d..26d0f557e 100644
--- a/docs/scripts/helpers.js
+++ b/docs/scripts/helpers.js
@@ -2,6 +2,8 @@
 
 'use strict'
 
+require('./prism-bash-extend')
+
 const { resolve, basename } = require('path')
 const { readFileSync } = require('fs')
 const cheerio = require('cheerio')
diff --git a/docs/scripts/prism-bash-extend.js b/docs/scripts/prism-bash-extend.js
new file mode 100644
index 000000000..3a6cde550
--- /dev/null
+++ b/docs/scripts/prism-bash-extend.js
@@ -0,0 +1,34 @@
+'use strict'
+
+/**
+ * Extend Prism's bash grammar with extra CLI commands for docs code blocks.
+ * Hexo loads scripts from docs/scripts/ during init, before `hexo generate`
+ * highlights fenced code via syntax_highlighter: prismjs.
+ *
+ * Bash highlights known commands via a large hard-coded regex (see prism-bash).
+ * insertBefore is the supported extension point when a command is not in that list.
+ * Add names to EXTRA_BASH_COMMANDS as needed.
+ *
+ * After editing this file, run `npx hexo clean` before generate/serve so
+ * Hexo re-highlights cached pages (db.json does not invalidate on script changes).
+ */
+const EXTRA_BASH_COMMANDS = [
+  'npx'
+]
+
+const Prism = require('prismjs')
+require('prismjs/components/prism-bash')
+
+const escaped = EXTRA_BASH_COMMANDS.map((cmd) =>
+  cmd.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+)
+
+Prism.languages.insertBefore('bash', 'function', {
+  'cli-command': {
+    pattern: new RegExp(
+      `(^|[\\s;|&]|[<>]\\()(?:${escaped.join('|')})(?=$|[)\\s;|&])`
+    ),
+    lookbehind: true,
+    alias: ['builtin', 'class-name']
+  }
+})
diff --git a/docs/source/_data/sidebar.yml b/docs/source/_data/sidebar.yml
index 6edcc6b29..97f80ed26 100644
--- a/docs/source/_data/sidebar.yml
+++ b/docs/source/_data/sidebar.yml
@@ -114,7 +114,7 @@ filters:
 
 tags:
   overview: overview.html
-  "#": inline_comment.html
+  "# (inline comment)": inline_comment.html
   assign: assign.html
   capture: capture.html
   case: case.html
diff --git a/docs/source/filters/date.md b/docs/source/filters/date.md
index c38de7ddc..222b88bce 100644
--- a/docs/source/filters/date.md
+++ b/docs/source/filters/date.md
@@ -3,18 +3,18 @@ title: date
 ---
 {% since %}v1.9.1{% endsince %}
 
-Date filter is used to convert a timestamp into the specified format.
+The `date` filter is used to convert a timestamp into the specified format.
 
-* LiquidJS tries to conform to Shopify/Liquid, which uses Ruby's core [Time#strftime(string)](https://www.ruby-doc.org/core/Time.html#method-i-strftime). There're differences with [Ruby's format flags](https://ruby-doc.org/core/strftime_formatting_rdoc.html):
+* LiquidJS tries to conform to Shopify/Liquid, which uses Ruby's core [Time#strftime(string)](https://www.ruby-doc.org/core/Time.html#method-i-strftime). There are differences with [Ruby's format flags](https://ruby-doc.org/core/strftime_formatting_rdoc.html):
   * `%Z` (since v10.11.1) is replaced by the passed-in timezone name from `LiquidOption` or in-place value (see TimeZone below). If passed-in timezone is an offset number instead of string, it'll behave like `%z`. If there's none passed-in timezone, it returns [the runtime's default time zone](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions#timezone).
   * LiquidJS provides an additional `%q` flag for date ordinals. e.g. `{{ '2023/02/02' | date: '%d%q of %b'}}` => `02nd of Feb`
-* Date literals are firstly converted to `Date` object via [new Date()][jsDate], that means literal values are considered in runtime's time zone by default.
+* Date literals are first converted to a `Date` object via [new Date()][jsDate], which means literal values are considered in the runtime's time zone by default.
 * The format filter argument is optional:
     * If not provided, it defaults to `%A, %B %-e, %Y at %-l:%M %P %z`.
     * The above default can be overridden by [`dateFormat`](/api/interfaces/LiquidOptions.html#dateFormat) LiquidJS option.
 * LiquidJS `date` supports locale specific weekdays and month names, which will fallback to English where `Intl` is not supported.
     * Ordinals (`%q`) and Jekyll specific date filters are English-only.
-    * [`locale`](/api/interfaces/LiquidOptions.html#locale) can be set when creating Liquid instance. Defaults to `Intl.DateTimeFormat().resolvedOptions.locale`).
+    * [`locale`](/api/interfaces/LiquidOptions.html#locale) can be set when creating a Liquid instance. Defaults to `Intl.DateTimeFormat().resolvedOptions().locale`.
 
 ### Examples
 ```liquid
@@ -26,10 +26,10 @@ Date filter is used to convert a timestamp into the specified format.
 ```
 
 # TimeZone
-* During output, LiquidJS uses local timezone which can override by:
+* During output, LiquidJS uses the local timezone, which can be overridden by:
     * setting a timezone in-place when calling `date` filter, or
     * setting the [`timezoneOffset`](/api/interfaces/LiquidOptions.html#timezoneOffset) LiquidJS option
-        * It defaults to runtime's time one.
+        * It defaults to the runtime's timezone.
         * Offset can be set as,
             * minutes: `-360` means `'+06:00'` and `360` means `'-06:00'`
             * timeZone ID: `Asia/Colombo` or `America/New_York`
diff --git a/docs/source/filters/json.md b/docs/source/filters/json.md
index 196909c7b..e0777d498 100644
--- a/docs/source/filters/json.md
+++ b/docs/source/filters/json.md
@@ -4,7 +4,7 @@ title: json
 
 {% since %}v9.10.0{% endsince %}
 
-Convert values to string via `JSON.stringify()`, for debug purpose.
+Convert values to string via `JSON.stringify()`, for debugging purposes.
 
 Input
 ```liquid
diff --git a/docs/source/filters/overview.md b/docs/source/filters/overview.md
index 342fab0c5..6761b7438 100644
--- a/docs/source/filters/overview.md
+++ b/docs/source/filters/overview.md
@@ -5,17 +5,17 @@ description: Description and demo for each Liquid filter
 
 LiquidJS implements business-logic independent filters that are typically implemented in [shopify/liquid][shopify/liquid]. This section contains the specification and demos for all the filters implemented by LiquidJS.
 
-There's 40+ filters supported by LiquidJS. These filters can be categorized into these groups:
+There are 40+ filters supported by LiquidJS. These filters can be categorized into these groups:
 
 Categories | Filters
 --- | ---
-Math | plus, minus, modulo, times, floor, ceil, round, divided_by, abs, at_least, at_most
-String | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, replace_last,remove, remove_first, remove_last, truncate, truncatewords, normalize_whitespace, number_of_words, array_to_sentence_string
-HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br, xml_escape, cgi_escape, uri_escape, slugify
-Array | slice, map, sort, sort_natural, uniq, where, where_exp, group_by, group_by_exp, find, find_exp, first, last, join, reverse, concat, compact, size, push, pop, shift, unshift
-Date | date, date_to_xmlschema, date_to_rfc822, date_to_string, date_to_long_string
-Misc | default, json, jsonify, inspect, raw, to_integer
-Base64 | base64_encode, base64_decode
-Crypto | sha256, hmac_sha256
+Math | `plus`, `minus`, `modulo`, `times`, `floor`, `ceil`, `round`, `divided_by`, `abs`, `at_least`, `at_most`
+String | `append`, `prepend`, `capitalize`, `upcase`, `downcase`, `strip`, `lstrip`, `rstrip`, `strip_newlines`, `split`, `replace`, `replace_first`, `replace_last`,`remove`, `remove_first`, `remove_last`, `truncate`, `truncatewords`, `normalize_whitespace`, `number_of_words`, `array_to_sentence_string`
+HTML/URI | `escape`, `escape_once`, `url_encode`, `url_decode`, `strip_html`, `newline_to_br`, `xml_escape`, `cgi_escape`, `uri_escape`, `slugify`
+Array | `slice`, `map`, `sort`, `sort_natural`, `uniq`, `where`, `where_exp`, `group_by`, `group_by_exp`, `find`, `find_exp`, `first`, `last`, `join`, `reverse`, `concat`, `compact`, `size`, `push`, `pop`, `shift`, `unshift`
+Date | `date`, `date_to_xmlschema`, `date_to_rfc822`, `date_to_string`, `date_to_long_string`
+Misc | `default`, `json`, `jsonify`, `inspect`, `raw`, `to_integer`
+Base64 | `base64_encode`, `base64_decode`
+Crypto | `sha256`, `hmac_sha256`
 
 [shopify/liquid]: https://github.com/Shopify/liquid
diff --git a/docs/source/filters/truncate.md b/docs/source/filters/truncate.md
index a3cf7cb3c..dd885ef56 100644
--- a/docs/source/filters/truncate.md
+++ b/docs/source/filters/truncate.md
@@ -36,7 +36,7 @@ Ground control, and so on
 
 ## No ellipsis
 
-You can truncate to the exact number of characters specified by the first argument and avoid showing trailing characters by passing a blank string as the second argument:
+You can `truncate` to the exact number of characters specified by the first argument and avoid showing trailing characters by passing a blank string as the second argument:
 
 Input
 ```liquid
diff --git a/docs/source/tags/assign.md b/docs/source/tags/assign.md
index abe7e57fa..79e50a66f 100644
--- a/docs/source/tags/assign.md
+++ b/docs/source/tags/assign.md
@@ -1,5 +1,5 @@
 ---
-title: Assign
+title: assign
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/case.md b/docs/source/tags/case.md
index e5e662222..e78dea72f 100644
--- a/docs/source/tags/case.md
+++ b/docs/source/tags/case.md
@@ -4,7 +4,7 @@ title: case
 
 {% since %}v1.9.1{% endsince %}
 
-Creates a switch statement to compare a variable with different values. `case` initializes the switch statement, and `when` compares its values.
+Creates a switch statement to compare a variable with different values. `case` initializes the switch statement, and `when` tags compare values.
 
 Input
 ```liquid
diff --git a/docs/source/tags/comment.md b/docs/source/tags/comment.md
index 943db07f8..140c47614 100644
--- a/docs/source/tags/comment.md
+++ b/docs/source/tags/comment.md
@@ -1,5 +1,5 @@
 ---
-title: Comment
+title: comment
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/decrement.md b/docs/source/tags/decrement.md
index fdcfce9c3..fce8c9bff 100644
--- a/docs/source/tags/decrement.md
+++ b/docs/source/tags/decrement.md
@@ -1,5 +1,5 @@
 ---
-title: Decrement
+title: decrement
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/echo.md b/docs/source/tags/echo.md
index 68e31d740..f01505fa6 100644
--- a/docs/source/tags/echo.md
+++ b/docs/source/tags/echo.md
@@ -1,5 +1,5 @@
 ---
-title: Echo
+title: echo
 ---
 
 {% since %}v9.31.0{% endsince %}
diff --git a/docs/source/tags/for.md b/docs/source/tags/for.md
index 9177d9431..3e8beb7a2 100644
--- a/docs/source/tags/for.md
+++ b/docs/source/tags/for.md
@@ -1,5 +1,5 @@
 ---
-title: For
+title: for
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/if.md b/docs/source/tags/if.md
index 2e3b8063e..e1d5a50b5 100644
--- a/docs/source/tags/if.md
+++ b/docs/source/tags/if.md
@@ -1,5 +1,5 @@
 ---
-title: If
+title: if
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/include.md b/docs/source/tags/include.md
index e79b41576..7e9e63cde 100644
--- a/docs/source/tags/include.md
+++ b/docs/source/tags/include.md
@@ -1,5 +1,5 @@
 ---
-title: Include
+title: include
 ---
 
 {% since %}v1.9.1{% endsince %}
@@ -22,11 +22,11 @@ If [extname][extname] option is set, the above `.liquid` extension becomes optio
 {% include 'footer' %}
 ```
 
-When a partial template is rendered by `include`, the code inside it can access its parent's variables but its parent cannot access variables defined inside a included template.
+When a partial template is rendered by `include`, the code inside it can access its parent's variables but its parent cannot access variables defined inside an included template.
 
 ## Passing Variables
 
-Variables defined in parent's scope can be passed to a the partial template by listing them as parameters on the `include` tag:
+Variables defined in the parent's scope can be passed to the partial template by listing them as parameters on the `include` tag:
 
 ```liquid
 {% assign my_variable = 'apples' %}
@@ -70,11 +70,11 @@ This way, you don't need to escape `"` in the filename expression.
 {% include prefix/{{name | append: ".html"}} %}
 ```
 
-## Jekyll include
+## Jekyll `include`
 
 {% since %}v9.33.0{% endsince %}
 
-[jekyllInclude][jekyllInclude] is used to enable Jekyll-like include syntax. Defaults to `false`, when set to `true`:
+[jekyllInclude][jekyllInclude] is used to enable Jekyll-like `include` syntax. Defaults to `false`, when set to `true`:
 
 - Filename will be static: `dynamicPartials` now defaults to `false` (instead of `true`). And you can set `dynamicPartials` back to `true`.
 - Use `=` instead of `:` to separate parameter key-values.
@@ -86,7 +86,7 @@ For example, the following template:
 {% include article.html header="HEADER" content="CONTENT" %}
 ```
 
-`article.html` with following content:
+`article.html` with the following content:
 
 ```liquid
 <article>
@@ -95,7 +95,7 @@ For example, the following template:
 </article>
 ```
 
-Note that we're referencing the first parameter by `include.header` instead of `header`. Will output following:
+Note that we're referencing the first parameter by `include.header` instead of `header`. It will output the following:
 
 ```html
 <article>
diff --git a/docs/source/tags/increment.md b/docs/source/tags/increment.md
index 6e8b7e416..cc3fe1ebc 100644
--- a/docs/source/tags/increment.md
+++ b/docs/source/tags/increment.md
@@ -1,5 +1,5 @@
 ---
-title: Increment
+title: increment
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/layout.md b/docs/source/tags/layout.md
index 70487d203..8b6e60619 100644
--- a/docs/source/tags/layout.md
+++ b/docs/source/tags/layout.md
@@ -1,5 +1,5 @@
 ---
-title: Layout
+title: layout
 ---
 
 {% since %}v1.9.1{% endsince %}
@@ -31,12 +31,12 @@ If [extname][extname] option is set, the `.liquid` extension becomes optional:
 ```
 
 {% note info Scoping %}
-When a partial template is rendered by <code>layout</code>, its template have access for its caller's variables but not vice versa. Variables defined in layout will be popped out before control returning to its caller.
+When a partial template is rendered by the `layout` tag, its template has access to its caller's variables but not vice versa. Variables defined in `layout` will be popped out before control returns to its caller.
 {% endnote %}
 
 ## Multiple Blocks
 
-The layout file can contain multiple blocks, each with a specified name. The following snippets yield same result as in the above example.
+The `layout` file can contain multiple blocks, each with a specified name. The following snippets yield same result as in the above example.
 
 ```liquid
 // default-layout.liquid
@@ -53,7 +53,7 @@ The layout file can contain multiple blocks, each with a specified name. The fol
 
 ## Default Block Contents
 
-In the above layout files, blocks has empty contents. But it's not necessarily be empty, in which case, the block contents in layout files will be used as default templates. The following snippets are also equivalent to the above examples:
+In the above `layout` files, blocks have empty contents. They do not necessarily need to be empty; in that case, the block contents in `layout` files will be used as default templates. The following snippets are also equivalent to the above examples:
 
 ```liquid
 // default-layout.liquid
@@ -68,7 +68,7 @@ In the above layout files, blocks has empty contents. But it's not necessarily b
 
 ## Passing Variables
 
-Variables defined in current template can be passed to a the layout template by listing them as parameters on the `layout` tag:
+Variables defined in the current template can be passed to the `layout` template by listing them as parameters on the `layout` tag:
 
 ```liquid
 {% assign my_variable = 'apples' %}
diff --git a/docs/source/tags/liquid.md b/docs/source/tags/liquid.md
index 258528ac6..06478ed9f 100644
--- a/docs/source/tags/liquid.md
+++ b/docs/source/tags/liquid.md
@@ -1,5 +1,5 @@
 ---
-title: Liquid
+title: liquid
 ---
 
 {% since %}v9.31.0{% endsince %}
diff --git a/docs/source/tags/overview.md b/docs/source/tags/overview.md
index e57c2d52f..de453a8d7 100644
--- a/docs/source/tags/overview.md
+++ b/docs/source/tags/overview.md
@@ -5,14 +5,14 @@ description: Description and demo for each Liquid tag
 
 LiquidJS implements business-logic independent tags that are typically implemented in [shopify/liquid][shopify/liquid]. This section contains the specification and demos for all the tags implemented by LiquidJS.
 
-There're a dozen of tags supported by LiquidJS, with all tags in [shopify/liquid][shopify/liquid]. These tags can be categorized into these groups:
+There are a dozen tags supported by LiquidJS, including all tags in [shopify/liquid][shopify/liquid]. These tags can be categorized into these groups:
 
 Category | Purpose | Tags
 --- | --- | ---
-Iteration | iterate over a collection | for, cycle, tablerow
-Control Flow | control the execution branch of template rendering | if, unless, elsif, else, case, when
-Variable | define and alter variables | assign, increment, decrement, capture, echo
-File | include another template or extend a layout template | render, include, layout
-Language | temporarily disable LiquidJS syntax | # (inline comment), raw, comment, liquid
+Iteration | iterate over a collection | `for`, `cycle`, `tablerow`
+Control Flow | control the execution branch of template rendering | `if`, `unless`, `elsif`, `else`, `case`, `when`
+Variable | define and alter variables | `assign`, `increment`, `decrement`, `capture`, `echo`
+File | include another template or extend a layout template | `render`, `include`, `layout`
+Language | temporarily disable LiquidJS syntax | `#`, `raw`, `comment`, `liquid`
 
 [shopify/liquid]: https://github.com/Shopify/liquid
diff --git a/docs/source/tags/raw.md b/docs/source/tags/raw.md
index 70698dd16..46b2b6e06 100644
--- a/docs/source/tags/raw.md
+++ b/docs/source/tags/raw.md
@@ -1,5 +1,5 @@
 ---
-title: Raw
+title: raw
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tags/render.md b/docs/source/tags/render.md
index 374723e07..9abdd00ba 100644
--- a/docs/source/tags/render.md
+++ b/docs/source/tags/render.md
@@ -1,5 +1,5 @@
 ---
-title: Render
+title: render
 ---
 
 {% since %}v9.2.0{% endsince %}
@@ -32,7 +32,7 @@ When a partial template is rendered, the code inside it can't access its parent'
 
 ## Passing Variables
 
-Variables defined in parent's scope can be passed to a the partial template by listing them as parameters on the render tag:
+Variables defined in the parent's scope can be passed to the partial template by listing them as parameters on the `render` tag:
 
 ```liquid
 {% assign my_variable = 'apples' %}
diff --git a/docs/source/tags/tablerow.md b/docs/source/tags/tablerow.md
index f33a8ca09..5b601a28b 100644
--- a/docs/source/tags/tablerow.md
+++ b/docs/source/tags/tablerow.md
@@ -1,5 +1,5 @@
 ---
-title: Table Row
+title: tablerow
 ---
 
 {% since %}v1.9.1{% endsince %}
@@ -88,7 +88,7 @@ Output
 
 ### limit
 
-Exits the tablerow after a specific index.
+Exits the `tablerow` after a specific index.
 
 ```liquid
 {% tablerow product in collection.products cols:2 limit:3 %}
@@ -98,7 +98,7 @@ Exits the tablerow after a specific index.
 
 ### offset
 
-Starts the tablerow after a specific index.
+Starts the `tablerow` after a specific index.
 
 ```liquid
 {% tablerow product in collection.products cols:2 offset:3 %}
diff --git a/docs/source/tags/unless.md b/docs/source/tags/unless.md
index e2632aed8..0a4416be7 100644
--- a/docs/source/tags/unless.md
+++ b/docs/source/tags/unless.md
@@ -1,5 +1,5 @@
 ---
-title: Unless
+title: unless
 ---
 
 {% since %}v1.9.1{% endsince %}
diff --git a/docs/source/tutorials/access-scope-in-filters.md b/docs/source/tutorials/access-scope-in-filters.md
index b38f2db50..ffe5dc405 100644
--- a/docs/source/tutorials/access-scope-in-filters.md
+++ b/docs/source/tutorials/access-scope-in-filters.md
@@ -2,7 +2,7 @@
 title: Access Scope in Filters
 ---
 
-As covered in [Register Filters/Tags][register-filters], we can access filter arguments directly in filter function like:
+As covered in [Register Filters/Tags][register-filters], we can access filter arguments directly in a filter function like:
 
 ```javascript
 // Usage: {{ 1 | add: 2, 3 }}
@@ -10,7 +10,7 @@ As covered in [Register Filters/Tags][register-filters], we can access filter ar
 engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)
 ```
 
-When it comes to stateful filters, for example transform a URL path to full URL, we'll need to access a `origin` in current scope:
+When it comes to stateful filters, for example transforming a URL path to a full URL, we'll need to access an `origin` in the current scope:
 
 ```javascript
 // Usage: {{ '/index.html' | fullURL }}
diff --git a/docs/source/tutorials/caching.md b/docs/source/tutorials/caching.md
index 810103381..74e191513 100644
--- a/docs/source/tutorials/caching.md
+++ b/docs/source/tutorials/caching.md
@@ -2,13 +2,13 @@
 title: Caching
 ---
 
-In a typical website project, we'll have a directory of view templates and they'll be rendered multiple times. In production environment the template files are not likely to be changed over time (other than re-deployments). Thus it makes sense to cache the file contents and the parsed templates (in a kind of AST) to improve performance.
+In a typical website project, we'll have a directory of view templates and they'll be rendered multiple times. In a production environment the template files are not likely to change over time (other than re-deployments). Thus it makes sense to cache the file contents and the parsed templates (in a kind of AST) to improve performance.
 
 LiquidJS provides multiple ways to cache the parsed templates to improve performance.
 
 ## Programmatically
 
-The [.parse()][parse], [.parseFile()][parseFile], [.parseFileSync()][parseFileSync] APIs are used to parse templates from string or files. The result template can be then rendered multiple times with different context.
+The [.parse()][parse], [.parseFile()][parseFile], [.parseFileSync()][parseFileSync] APIs are used to parse templates from strings or files. The resulting template can then be rendered multiple times with different context.
 
 Parse from string:
 
diff --git a/docs/source/tutorials/contribution-guidelines.md b/docs/source/tutorials/contribution-guidelines.md
index 5bfac1a22..d2691a88c 100644
--- a/docs/source/tutorials/contribution-guidelines.md
+++ b/docs/source/tutorials/contribution-guidelines.md
@@ -16,11 +16,11 @@ Getting started and building is described in [CONTRIBUTING.md](https://github.co
 
 **Commit Message**: Please align to [the Angular Commit Message Guidelines](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits), especially note the [type identifier](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type), on which semantic-release bot depends.
 
-**Backward-Compatibility**: please be backward-compatible. LiquidJS is used by multiple layers of softwares, including underlying libraries, compilers, site generators and Web servers. It's not easy to do a major upgrade for most of them.
+**Backward-Compatibility**: please be backward-compatible. LiquidJS is used by multiple layers of software, including underlying libraries, compilers, site generators and Web servers. It's not easy to do a major upgrade for most of them.
 
 ## Financial Support
 
-LiquidJS is Open Source and Free. To help it live and thrive, especially when LiquidJS is benefiting your business, please consider contribute on [GitHub Sponsors](https://github.com/sponsors/harttle) or [Open Collective][oc].
+LiquidJS is Open Source and Free. To help it live and thrive, especially when LiquidJS is benefiting your business, consider contributing on [GitHub Sponsors](https://github.com/sponsors/harttle) or [Open Collective][oc].
 
 I'll add all financial contributors into [README.md](https://github.com/harttle/liquidjs#financial-support) and it'll be also shown on https://liquidjs.com after next GitHub Actions build.
 
diff --git a/docs/source/tutorials/differences.md b/docs/source/tutorials/differences.md
index cb98c08e3..7820669a3 100644
--- a/docs/source/tutorials/differences.md
+++ b/docs/source/tutorials/differences.md
@@ -4,7 +4,7 @@ title: Differences with Shopify/liquid
 
 ## Compatibility
 
-Being compatible with the Ruby version is one of our priorities. Liquid language is originally [implemented in Ruby][ruby-liquid] and used by Shopify and Jekyll (and thus GitHub Pages). As you can see it's one of the most popular template engines in Ruby. There're lots of people using LiquidJS to serve their templates originally written for Shopify themes and Jekyll sites.
+Being compatible with the Ruby version is one of our priorities. Liquid language is originally [implemented in Ruby][ruby-liquid] and used by Shopify and Jekyll (and thus GitHub Pages). As you can see it's one of the most popular template engines in Ruby. There are lots of people using LiquidJS to serve their templates originally written for Shopify themes and Jekyll sites.
 
 So "being compatible" means serving developers from Shopify and Jekyll well:
 
@@ -13,8 +13,8 @@ So "being compatible" means serving developers from Shopify and Jekyll well:
 
 In the meantime, it's now implemented in JavaScript, that means it has to be more powerful:
 
-* **Async as first-class citizen**. Filters and tags can be implemented asynchronously by return a `Promise`.
-* **Also can be sync**. For scenarios that are not I/O intensive, render synchronously can be much faster. You can call synchronous APIs like `.renderSync()` as long as all the filters and tags in template support to be rendered synchronously. All builtin filters/tags support both sync and async render.
+* **Async as a first-class citizen**. Filters and tags can be implemented asynchronously by returning a `Promise`.
+* **Can also be synchronous**. For scenarios that are not I/O intensive, rendering synchronously can be much faster. You can call synchronous APIs like `.renderSync()` as long as all the filters and tags in the template can be rendered synchronously. All built-in filters/tags support both sync and async render.
 * **[Abstract file system][afs]**. Along with async feature, LiquidJS can be used to serve templates stored in Databases [#414][#414], on remote HTTP server [#485][#485], and so on.
 * **Additional tags and filters** like `layout` and `json`, `inspect`, `where_exp`, `group_by`, etc., see below for details.
 
diff --git a/docs/source/tutorials/drops.md b/docs/source/tutorials/drops.md
index f2ee46da3..70fa0338e 100644
--- a/docs/source/tutorials/drops.md
+++ b/docs/source/tutorials/drops.md
@@ -95,7 +95,7 @@ engine.parseAndRender("{{color}}", context).then(html => console.log(html))
 
 ## toLiquid
 
-`toLiquid()` is not a method of `Drop`, but it can be used to return a `Drop`. In cases where you have a fixed structure in the `context` that cannot change its values, you can implement `toLiquid()` to let LiquidJS use the returned value instead of itself to render the templates.
+`toLiquid()` is not a method of `Drop`, but it can be used to return a `Drop`. In cases where you have a fixed structure in the `context` that cannot change its values, you can implement `toLiquid()` to let LiquidJS use the returned value instead of the object itself when rendering templates.
 
 ```javascript
 import { Liquid, Drop } from 'liquidjs'
diff --git a/docs/source/tutorials/escaping.md b/docs/source/tutorials/escaping.md
index 7bcbd03ee..ece18a9c9 100644
--- a/docs/source/tutorials/escaping.md
+++ b/docs/source/tutorials/escaping.md
@@ -2,10 +2,10 @@
 title: Escaping
 ---
 
-Escaping is important in all languages, including LiquidJS. While escaping has 2 different meanings for a template engine:
+Escaping is important in all languages, including LiquidJS. Escaping has two different meanings for a template engine:
 
 1. Escaping for the output, i.e. HTML escape. Used to escape HTML special characters so the output will not break HTML structures, aka HTML safe.
-2. Escaping for the language itself, i.e. Liquid escape. Used to output strings that's considered special in Liquid language. This will be useful when you're writing an article in Liquid template to introduce Liquid language.
+2. Escaping for the language itself, i.e. Liquid escape. Used to output strings that are considered special in the Liquid language. This is useful when you're writing an article in a Liquid template to introduce the Liquid language.
 
 ## HTML Escape
 
@@ -55,7 +55,7 @@ In LiquidJS, {{ this | escape }} will be HTML-escaped, but
 {{{ that }}} will not.
 ```
 
-Within strings literals in LiquidJS template, `\` can be used to escape special characters in string syntax. For example:
+Within string literals in a LiquidJS template, `\` can be used to escape special characters in string syntax. For example:
 
 Input
 ```liquid
diff --git a/docs/source/tutorials/intro-to-liquid.md b/docs/source/tutorials/intro-to-liquid.md
index d5baee03c..85b4d7d9a 100644
--- a/docs/source/tutorials/intro-to-liquid.md
+++ b/docs/source/tutorials/intro-to-liquid.md
@@ -5,7 +5,7 @@ describe: A short introduction to the Liquid template language and some simple d
 
 LiquidJS is a simple, expressive and safe [Shopify][shopify/liquid] / GitHub Pages compatible template engine in pure JavaScript. The purpose of this repo is to provide a standard Liquid implementation for the JavaScript community. Liquid is originally implemented in Ruby and used by GitHub Pages, Jekyll and Shopify, see [Differences with Shopify/liquid][diff].
 
-LiquidJS syntax is relatively simple. There're 2 types of markups in LiquidJS:
+LiquidJS syntax is relatively simple. There are 2 types of markups in LiquidJS:
 
 - **Tags**. A tag consists of a tag name and optional arguments wrapped between `{%raw%}{%{%endraw%}` and `%}`.
 - **Outputs**. An output consists of a value and a list of filters, which is optional, wrapped between `{%raw%}{{{%endraw%}` and `}}`.
@@ -38,7 +38,7 @@ A complete list of filters supported by LiquidJS can be found [here](../filters/
 
 ## Tags
 
-**Tags** are used to control the template rendering process, manipulating template variables, inter-op with other templates, etc. For example `assign` can be used to define a variable which can be later used in the template:
+**Tags** are used to control the template rendering process, manipulating template variables, interacting with other templates, etc. For example `assign` can be used to define a variable that can be later used in the template:
 
 ```liquid
 {% assign foo = "FOO" %}
@@ -50,7 +50,7 @@ Typically tags appear in pairs with a start tag and a corresponding end tag. For
 {% if foo == "FOO" %}
     Variable `foo` equals "FOO"
 {% else %}
-    Variable `foo` not equals "FOO"
+    Variable `foo` does not equal "FOO"
 {% endif %}
 ```
 
diff --git a/docs/source/tutorials/migrate-to-9.md b/docs/source/tutorials/migrate-to-9.md
index 720f345a5..7d20d8602 100644
--- a/docs/source/tutorials/migrate-to-9.md
+++ b/docs/source/tutorials/migrate-to-9.md
@@ -2,7 +2,7 @@
 title: Migrate to LiquidJS 9
 ---
 
-LiquidJS 9 has some fundamental improvements, including bugfixes, new features and performance improvement due to higher target(see #137). There're also some breaking changes.
+LiquidJS 9 has some fundamental improvements, including bugfixes, new features and performance improvements due to a higher target (see #137). There are also some breaking changes.
 
 ## Features
 
@@ -14,11 +14,11 @@ LiquidJS 9 has some fundamental improvements, including bugfixes, new features a
 * Rewrite boolean expression evaluation order, [#130](https://github.com/harttle/liquidjs/issues/130);
 * `break` and `continue` tags omitting output before them, [#123](https://github.com/harttle/liquidjs/issues/123);
 * Fixes errors in React.js demo during yarn install, [#145](https://github.com/harttle/liquidjs/issues/145);
-* Promise typed Drops are not await-ed some times.
+* Promise typed Drops are not always awaited.
 
 ## Performance
 
-* Performance Improvements due to targeting to Node.js 8, see [#137](https://github.com/harttle/liquidjs/issues/137);
+* Performance Improvements due to targeting Node.js 8, see [#137](https://github.com/harttle/liquidjs/issues/137);
 * Memory footprint is reduced by 57.5%, see [#202](https://github.com/harttle/liquidjs/pull/202);
 * Render performance is improved by 100.3%, see [#205](https://github.com/harttle/liquidjs/pull/205).
 
diff --git a/docs/source/tutorials/operators.md b/docs/source/tutorials/operators.md
index f8b5949d3..7a6358b99 100644
--- a/docs/source/tutorials/operators.md
+++ b/docs/source/tutorials/operators.md
@@ -2,14 +2,14 @@
 title: Operators
 ---
 
-LiquidJS operators are very simple and different. There're 2 types of operators supported:
+LiquidJS operators are very simple and different. There are 2 types of operators supported:
 
 * Comparison operators: `==`, `!=`, `>`, `<`, `>=`, `<=`
-* Logic operators: `not`, `or`, `and`, `contains`
+* Logical operators: `not`, `or`, `and`, `contains`
 
-Thus numerical operators are not supported and you cannot even plus two numbers like this `{% raw %}{{a + b}}{% endraw %}`, instead we need a filter `{% raw %}{{ a | plus: b}}{% endraw %}`. Actually `+` is a valid variable name in LiquidJS.
+Thus arithmetic operators are not supported and you cannot add two numbers like this `{% raw %}{{a + b}}{% endraw %}`. Instead, use a filter: `{% raw %}{{ a | plus: b}}{% endraw %}`. Actually `+` is a valid variable name in LiquidJS.
 
-## Logic Operators
+## Logical Operators
 
 ### not
 
@@ -59,10 +59,10 @@ Input
 
 1. Comparison operators, and `contains`. All comparison operators alongside `contains` have the same (highest) precedence.
 2. `not` operator. It has slightly more precedence than `or` and `and`.
-3. `or` and `and` operators. These logic operators have the same (lowest) precedence.
+3. `or` and `and` operators. These logical operators have the same (lowest) precedence.
 
 ## Associativity
 
-Logic operators are evaluated from right to left, see [shopify docs][operator-order].
+Logical operators are evaluated from right to left, see [shopify docs][operator-order].
 
 [operator-order]: https://shopify.dev/docs/api/liquid/basics#order-of-operations
diff --git a/docs/source/tutorials/options.md b/docs/source/tutorials/options.md
index f03a0a060..1fa675d0b 100644
--- a/docs/source/tutorials/options.md
+++ b/docs/source/tutorials/options.md
@@ -11,27 +11,27 @@ const engine = new Liquid({
 })
 ```
 
-{% note info API Document %}
-Following is an overview for all the options, for exact types and signatures please refer to <a href="https://liquidjs.com/api/interfaces/LiquidOptions.html" target="_self">LiquidOptions | API</a>.
+{% note info API documentation %}
+Following is an overview for all the options. For exact types and signatures, see <a href="https://liquidjs.com/api/interfaces/LiquidOptions.html" target="_self">LiquidOptions | API</a>.
 {% endnote %}
 
 ## cache
 
-**cache** is used to improve performance by caching previously parsed template structures, specially in cases when we're repeatedly parse or render files.
+**cache** is used to improve performance by caching previously parsed template structures, especially in cases when we repeatedly parse or render files.
 
-It's default to `false`. When setting to `true` a default LRU cache of size 1024 will be enabled. And certainly it can be a number which indicates the size of cache you want.
+It defaults to `false`. When set to `true`, a default LRU cache of size 1024 will be enabled. It can also be a number indicating the cache size you want.
 
 Additionally, it can also be a custom cache implementation. See [Caching][caching] for details.
 
 ## Partials/Layouts
 
-**root** is used to specify template directories for LiquidJS to lookup and read template files. Can be a single string and an array of strings. See [Render Files][render-file] for details.
+**root** is used to specify template directories for LiquidJS to look up and read template files. Can be a single string or an array of strings. See [Render Files][render-file] for details.
 
-**layouts** is used to specify template directories for LiquidJS to lookup files for `{% layout %}`. Same format as `root` and will default to `root` if not specified.
+**layouts** is used to specify template directories for LiquidJS to look up files for `{% layout %}`. Same format as `root` and will default to `root` if not specified.
 
-**partials** is used to specify template directories for LiquidJS to lookup files for `{% render %}` and `{% include %}`. Same format as `root` and will default to `root` if not specified.
+**partials** is used to specify template directories for LiquidJS to look up files for `{% render %}` and `{% include %}`. Same format as `root` and will default to `root` if not specified.
 
-**relativeReference** is set to `true` by default to allow relative filenames. Note that relatively referenced files are also need to be within corresponding root. For example you can reference another file like `{% render ../foo/bar %}` as long as `../foo/bar` is also within `partials` directory.
+**relativeReference** is set to `true` by default to allow relative filenames. Note that relatively referenced files also need to be within the corresponding root. For example you can reference another file like `{% render ../foo/bar %}` as long as `../foo/bar` is also within `partials` directory.
 
 ## dynamicPartials
 
@@ -62,7 +62,7 @@ LiquidJS defaults this option to <code>true</code> to be compatible with shopify
 - Use `=` instead of `:` to separate parameter key-values.
 - Parameters are under `include` variable instead of current scope.
 
-For example in the following template, `name.html` is not quoted, `header` and `"HEADER"` are separated by `=`, and the `header` parameter is referenced by `include.header`. More details please check out [include][include].
+For example in the following template, `name.html` is not quoted, `header` and `"HEADER"` are separated by `=`, and the `header` parameter is referenced by `include.header`. For more details, see [include][include].
 
 ```liquid
 // entry template
@@ -90,7 +90,7 @@ Before 2.0.1, <code>extname</code> is set to `.liquid` by default. To change tha
 
 ## fs
 
-**fs** is used to define a custom file system implementation which will be used by LiquidJS to lookup and read template files. See [Abstract File System][abstract-fs] for details.
+**fs** is used to define a custom file system implementation which will be used by LiquidJS to look up and read template files. See [Abstract File System][abstract-fs] for details.
 
 ## globals
 
@@ -98,9 +98,9 @@ Before 2.0.1, <code>extname</code> is set to `.liquid` by default. To change tha
 
 ## jsTruthy
 
-**jsTruthy** is used to use standard JavaScript truthiness rather than the Shopify.
+**jsTruthy** is used to use standard JavaScript truthiness rather than Shopify's.
 
-it defaults to false.  For example, when set to true, a blank string would evaluate to false with jsTruthy. With Shopify's truthiness, a blank string is true.
+It defaults to `false`. For example, when set to `true`, a blank string would evaluate to false with jsTruthy. With Shopify's truthiness, a blank string is true.
 
 ## outputEscape
 
@@ -108,13 +108,13 @@ it defaults to false.  For example, when set to true, a blank string would evalu
 
 - For untrusted output variables, set `outputEscape: "escape"` makes them be HTML escaped by default. You'll need [raw][raw] filter for direct output.
 - `"json"` is useful when you're using LiquidJS to create valid JSON files.
-- It can even be a function which allows you to control what variables are output throughout LiquidJS. Please note the input can be any type other than string, e.g. an filter returned an non-string value.
+- It can even be a function that allows you to control what variables are output throughout LiquidJS. Please note the input can be any type other than string, e.g. a filter may return a non-string value.
 
 ## Date
 
 **timezoneOffset** is used to specify a different timezone to output dates, your local timezone will be used if not specified. For example, set `timezoneOffset: 0` to output all dates in UTC/GMT 00:00.
 
-**preserveTimezones** is a boolean effects only literal timestamps. When set to `true`, all literal timestamps will remain the same when output. This is a parser option, so Date objects passed to LiquidJS as data will not be affected. Note that `preserveTimezones` has a higher priority than `timezoneOffset`.
+**preserveTimezones** is a boolean that affects only literal timestamps. When set to `true`, all literal timestamps will remain the same when output. This is a parser option, so Date objects passed to LiquidJS as data will not be affected. Note that `preserveTimezones` has a higher priority than `timezoneOffset`.
 
 **dateFormat** is used to specify a default format to output dates. `%A, %B %-e, %Y at %-l:%M %P %z` will be used if not specified. For example, set `dateFormat: %Y-%m-%dT%H:%M:%S:%LZ` to output all dates in [JavaScript Date.toJson()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toJSON) format.
 
diff --git a/docs/source/tutorials/parse-parameters.md b/docs/source/tutorials/parse-parameters.md
index dfb7c0198..ee84c46e7 100644
--- a/docs/source/tutorials/parse-parameters.md
+++ b/docs/source/tutorials/parse-parameters.md
@@ -4,7 +4,7 @@ title: Parse Parameters
 
 ## Access Raw Parameters
 
-As covered in [Register Filters/Tags][register-tags], tag parameters is available on `tagToken.args` as a raw string. For example:
+As covered in [Register Filters/Tags][register-tags], tag parameters are available on `tagToken.args` as a raw string. For example:
 
 ```javascript
 // Usage: {% random foo bar coo %}
@@ -66,7 +66,7 @@ Async calls in LiquidJS are implemented by generators directly, for we can call
 
 ## Parse Key-Value Pairs as Named Parameters
 
-Named parameters become very handy when there're optional parameters or lots of parameters, in which case the order of parameters is not important. This is exactly what [Hash][Hash] class is invented for.
+Named parameters become very handy when there are optional parameters or lots of parameters, in which case the order of parameters is not important. This is exactly what the [Hash][Hash] class was invented for.
 
 ```liquid
 {% random from:2, to:max %}
diff --git a/docs/source/tutorials/partials-and-layouts.md b/docs/source/tutorials/partials-and-layouts.md
index f7be8a635..5ca92c779 100644
--- a/docs/source/tutorials/partials-and-layouts.md
+++ b/docs/source/tutorials/partials-and-layouts.md
@@ -25,7 +25,7 @@ color: 'red' shape: 'circle'
 color: 'yellow' shape: 'square'
 ```
 
-More details please refer to the [render](../tags/render.html) tag.
+For more details, see the [render](../tags/render.html) tag.
 
 {% note tip The &quot;.liquid&quot; Extension %}
 The ".liquid" extension in <code>layout</code>, <code>render</code> and <code>include</code> can be omitted if Liquid instance is created using `extname: ".liquid"` option. See <a href="./options.html#extname">the extname option</a> for details.
@@ -54,4 +54,4 @@ My page content
 Footer
 ```
 
-More details please refer to the [layout](../tags/layout.html) tag.
+For more details, see the [layout](../tags/layout.html) tag.
diff --git a/docs/source/tutorials/plugins.md b/docs/source/tutorials/plugins.md
index bb03c2ada..f7b625bac 100644
--- a/docs/source/tutorials/plugins.md
+++ b/docs/source/tutorials/plugins.md
@@ -6,9 +6,9 @@ A number of tags and filters can be encapsulated into a **plugin**, which will b
 
 ## Write a Plugin
 
-A liquidjs plugin is simple function which takes the [Liquid class][liquid] as the first parameter and the Liquid instance for `this`. We can call liquidjs APIs on `this` to make certain changes, especially [register filters and tags][register].
+A LiquidJS plugin is a simple function that takes the [Liquid class][liquid] as the first parameter and uses the Liquid instance for `this`. We can call LiquidJS APIs on `this` to make certain changes, especially [register filters and tags][register].
 
-Now we'll make a plugin to upper case every letter of the input, save the following snippet to `upup.js`:
+Now we'll make a plugin to uppercase every letter of the input. Save the following snippet to `upup.js`:
 
 ```javascript
 /**
diff --git a/docs/source/tutorials/register-filters-tags.md b/docs/source/tutorials/register-filters-tags.md
index 743029c80..2e6bf7d33 100644
--- a/docs/source/tutorials/register-filters-tags.md
+++ b/docs/source/tutorials/register-filters-tags.md
@@ -62,7 +62,7 @@ See existing filter implementations here: <https://github.com/harttle/liquidjs/t
 
 ## Unregister Tags/Filters
 
-In some cases it's desirable to disable some tags/filters (see [#324](https://github.com/harttle/liquidjs/issues/324)), you'll need to register a dummy tag/filter in which an corresponding Error throws.
+In some cases it's desirable to disable some tags/filters (see [#324](https://github.com/harttle/liquidjs/issues/324)). You'll need to register a dummy tag/filter that throws a corresponding Error.
 
 ```javascript
 // disable a tag
diff --git a/docs/source/tutorials/render-file.md b/docs/source/tutorials/render-file.md
index 6701882c6..184bad4c6 100644
--- a/docs/source/tutorials/render-file.md
+++ b/docs/source/tutorials/render-file.md
@@ -38,7 +38,7 @@ name: alice
 
 ## Template Lookup
 
-Template files names passed to [renderFile][renderFile], [parseFile][parseFile], [renderFileSync][renderFileSync], [parseFileSync][parseFileSync] APIs,
+Template file names passed to [renderFile][renderFile], [parseFile][parseFile], [renderFileSync][renderFileSync], [parseFileSync][parseFileSync] APIs,
 and [include][include], [layout][layout] tags are resolved against [the root option][root].
 
 It can be a string-typed path (see above example), or a list of root directories, in which case templates will be looked up in that order. e.g.
@@ -96,7 +96,7 @@ var engine = new Liquid({
 
 ## In-memory Template
 
-To facilitate rendering w/o files, there's a `templates` option to specify a mapping of filenames and their content. LiquidJS will read templates from the mapping.
+To facilitate rendering without files, there's a `templates` option to specify a mapping of filenames and their content. LiquidJS will read templates from the mapping.
 
 ```typescript
 const engine = new Liquid({
diff --git a/docs/source/tutorials/render-tag-content.md b/docs/source/tutorials/render-tag-content.md
index 3b4445af5..33195b090 100644
--- a/docs/source/tutorials/render-tag-content.md
+++ b/docs/source/tutorials/render-tag-content.md
@@ -2,7 +2,7 @@
 title: Render Tag Content
 ---
 
-Custom tags can have content template and can be nested. This article describes how to implement custom tags that consists of a *begin tag*, an *end tag*, and template content between them.
+Custom tags can have content templates and can be nested. This article describes how to implement custom tags that consist of a *begin tag*, an *end tag*, and template content between them.
 
 ## Render Tag Content
 
@@ -22,12 +22,12 @@ Expected output:
 </div>
 ```
 
-Firstly, [register][register-tags] a tag with name `wrap` and parse the content into `this.tpls`. Here in `parse(tagToken, remainTokens)`,
+Firstly, [register][register-tags] a tag named `wrap` and parse the content into `this.tpls`. Here in `parse(tagToken, remainTokens)`:
 
 - `tagToken` is current token `{%raw%}{% wrap %}{%endraw%}`, and
 - `remainTokens` is an array of all tokens following `{%raw%}{% wrap %}{%endraw%}` until the end of this template file.
 
-Basically, what we need to do is take/`.shift()` enough tags from `remainTokens` until we got a `endwrap` token (the name can be arbitrary, but in convention, we need it to be `endwrap`). And if there's no `endwrap` until the end of template file, we need to throw an tag-not-closed `Error`.
+Basically, what we need to do is take/`.shift()` enough tags from `remainTokens` until we get an `endwrap` token (the name can be arbitrary, but by convention it should be `endwrap`). And if there's no `endwrap` until the end of the template file, we need to throw a tag-not-closed `Error`.
 
 ```javascript
 engine.registerTag('wrap', {
@@ -57,11 +57,11 @@ engine.registerTag('wrap', {
 })
 ```
 
-`.renderTemplates()` can be async, we need `yield` to wait it complete. More details on async in LiquidJS, please refer to [Sync and Async][async]. Other parts of `render()` method is quite straightforward. Here's a JSFiddle version: <https://jsfiddle.net/por0zcn1/3/>
+`.renderTemplates()` can be async; we need `yield` to wait for it to complete. For more details on async in LiquidJS, see [Sync and Async][async]. Other parts of the `render()` method are quite straightforward. Here's a JSFiddle version: <https://jsfiddle.net/por0zcn1/3/>
 
 ## Using ParseStream
 
-When it comes to complex tags like [for][for] and [if][if], the `parse()` can be very complicated. There's a [ParseStream][ParseStream] utility to organize the `parse()` in event-based style. Following is a re-written `parse()` using `ParseStream` and does exactly the same as above example.
+When it comes to complex tags like [for][for] and [if][if], the `parse()` can be very complicated. There's a [ParseStream][ParseStream] utility to organize the `parse()` in event-based style. Following is a re-written `parse()` using `ParseStream` that does exactly the same as the example above.
 
 ```javascript
 parse(tagToken, remainTokens) {
@@ -79,7 +79,7 @@ Here's a JSFiddle version: <https://jsfiddle.net/por0zcn1/4/>. For simplicity, t
 
 ## Manipulate the Context
 
-The `wrap` tag above doesn't seem to be very useful, without using that tag we can render the content anyway. Now we're going to implement a `repeat` tag to render the content 2 times (we can also add a [parameter][parameter] to render arbitrary times).
+The `wrap` tag above doesn't seem very useful; even without using that tag, we can render the content anyway. Now we're going to implement a `repeat` tag to render the content 2 times (we can also add a [parameter][parameter] to render an arbitrary number of times).
 
 ```liquid
 {% repeat %}
diff --git a/docs/source/tutorials/security-model.md b/docs/source/tutorials/security-model.md
index d1f0854d9..5d65a0196 100644
--- a/docs/source/tutorials/security-model.md
+++ b/docs/source/tutorials/security-model.md
@@ -28,7 +28,7 @@ A typical PC handles `1e8` (100M) characters without issues.
 
 ### renderLimit
 
-Restricting template size alone is insufficient because dynamic loops with large counts can occur in render time. [renderLimit][renderLimit] mitigates this by limiting the time consumed by each `render()` call.
+Restricting template size alone is insufficient because dynamic loops with large counts can occur during rendering. [renderLimit][renderLimit] mitigates this by limiting the time consumed by each `render()` call.
 
 ```liquid
 {%- for i in (1..10000000) -%}
@@ -49,7 +49,7 @@ Render time is checked on a per-template basis (before rendering each template).
 
 In other words, `memoryLimit` limits what LiquidJS counts, not every byte your process may allocate.
 
-Even with small number of templates and iterations, memory usage can grow exponentially. In the following example, memory doubles with each iteration:
+Even with a small number of templates and iterations, memory usage can grow exponentially. In the following example, memory doubles with each iteration:
 
 ```liquid
 {% assign array = "1,2,3" | split: "," %}
diff --git a/docs/source/tutorials/setup.md b/docs/source/tutorials/setup.md
index 8a740c495..894c938f3 100644
--- a/docs/source/tutorials/setup.md
+++ b/docs/source/tutorials/setup.md
@@ -47,7 +47,7 @@ Pre-built UMD bundles are also available:
 <script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.umd.js"></script>
 ```
 
-{% note info Working Demo %} Here's a living demo on jsFiddle: <a href="https://jsfiddle.net/pd4jhzLs/1/" target="_blank">jsfiddle.net/pd4jhzLs/1/</a>, and the source code is also available in <a href="https://github.com/harttle/liquidjs/blob/master/demo/browser/" target="_blank">liquidjs/demo/browser/</a>.{% endnote %}
+{% note info Working Demo %} Here's a live demo on jsFiddle: <a href="https://jsfiddle.net/pd4jhzLs/1/" target="_blank">jsfiddle.net/pd4jhzLs/1/</a>, and the source code is also available in <a href="https://github.com/harttle/liquidjs/blob/master/demo/browser/" target="_blank">liquidjs/demo/browser/</a>.{% endnote %}
 
 {% note warn Compatibility %} You may need a <a href="https://github.com/taylorhakes/promise-polyfill" target="_blank">Promise polyfill</a> for legacy browsers like IE and Android UC, see <a href="https://caniuse.com/#feat=promises" target="_blank">caniuse statistics</a>. {% endnote %}
 
diff --git a/docs/source/tutorials/static-analysis.md b/docs/source/tutorials/static-analysis.md
index 86c580a39..10c38a69b 100644
--- a/docs/source/tutorials/static-analysis.md
+++ b/docs/source/tutorials/static-analysis.md
@@ -5,7 +5,7 @@ title: Static Template Analysis
 {% since %}v10.20.0{% endsince %}
 
 {% note warn Experimental %}  
-Note that this is an experimental feature and future APIs are subject to change. And internal structures returned can be changed w/o a major version bump.
+Note that this is an experimental feature and future APIs are subject to change. Internal structures returned can be changed without a major version bump.
 {% endnote %}
 
 {% note info Sync and Async %}
@@ -234,9 +234,9 @@ This is an example of an object returned from `Liquid.analyze()`, passing it the
 
 ### Analyzing Custom Tags
 
-For static analysis to include results from custom tags, those tags must implement some additional methods defined on the [Template interface]( /api/interfaces/Template.html). LiquidJS will use the information returned from these methods to traverse the template and report variable usage.
+For static analysis to include results from custom tags, those tags must implement some additional methods defined on the [Template interface](/api/interfaces/Template.html). LiquidJS will use the information returned from these methods to traverse the template and report variable usage.
 
-Not all methods are required, depending in the kind of tag. If it's a block with a start tag, end tag and any amount of Liquid markup in between, it will need to implement the [`children()`](/api/interfaces/Template.html#children) method. `children()` is defined as a generator, so that we can use it in synchronous and asynchronous contexts, just like `render()`. It should return HTML content, output statements and tags that are child nodes of the current tag.
+Not all methods are required, depending on the kind of tag. If it's a block with a start tag, end tag and any amount of Liquid markup in between, it will need to implement the [`children()`](/api/interfaces/Template.html#children) method. `children()` is defined as a generator, so that we can use it in synchronous and asynchronous contexts, just like `render()`. It should return HTML content, output statements and tags that are child nodes of the current tag.
 
 The [`blockScope()`](/api/interfaces/Template.html#blockScope) method is responsible for telling LiquidJS which names will be in scope for the duration of the tag's block. Some of these names could depend on the tag's arguments, and some will be fixed, like `forloop` from the `{% for %}` tag.
 
diff --git a/docs/source/tutorials/sync-and-async.md b/docs/source/tutorials/sync-and-async.md
index ce7e1f0c2..f47c48d38 100644
--- a/docs/source/tutorials/sync-and-async.md
+++ b/docs/source/tutorials/sync-and-async.md
@@ -2,11 +2,11 @@
 title: Sync and Async
 ---
 
-LiquidJS supports both sync and async evaluate, and can be used with Promises. To reuse the same set of tag/filter implementations in both sync and async, LiquidJS tags are implemented as generators.
+LiquidJS supports both synchronous and asynchronous evaluation, and can be used with Promises. To reuse the same set of tag/filter implementations in both sync and async modes, LiquidJS tags are implemented as generators.
 
 ## Sync and Async API
 
-All major methods on [Liquid][Liquid] supports both sync and async. These methods return Promises:
+All major methods on [Liquid][Liquid] support both sync and async. These methods return Promises:
 
 - `render()`
 - `renderFile()`
@@ -44,11 +44,11 @@ engine.registerTag('upper', class UpperTag extends Tag {
 })
 ```
 
-All builtin tags are implemented this way and safe to use in both sync and async (I'll call it *sync-compatible*). To make your custom tag *sync-compatible*, you'll need to:
+All built-in tags are implemented this way and are safe to use in both sync and async modes (I'll call it *sync-compatible*). To make your custom tag *sync-compatible*, you'll need to:
 
 - declare render function as `* render()`, in which
 - do not directly `return <Promise>`, and
-- do not call any APIs that returns a Promise.
+- do not call any APIs that return a Promise.
 
 ## Call APIs that return a Promise
 
@@ -92,7 +92,7 @@ engine.registerTag('upper', class UpperTag extends Tag {
 
 ## Async only Tags
 
-If your tag is intend to be used only asynchronously, it can be declared as `async render()` so you can use `await` in its implementation directly:
+If your tag is intended to be used only asynchronously, it can be declared as `async render()` so you can use `await` in its implementation directly:
 
 ```typescript
 import { toPromise, TagToken, Context, Emitter, TopLevelToken, Value, Tag, Liquid } from 'liquidjs'
diff --git a/docs/source/tutorials/truthy-and-falsy.md b/docs/source/tutorials/truthy-and-falsy.md
index ceeb5cadc..7451aab3c 100644
--- a/docs/source/tutorials/truthy-and-falsy.md
+++ b/docs/source/tutorials/truthy-and-falsy.md
@@ -2,7 +2,7 @@
 title: Truthy and Falsy
 ---
 
-Though [Liquid][sl] is platform-independent, there're [certain differences][diff] with [the Ruby version][ruby], one of which is the `truthy` value.
+Though [Liquid][sl] is platform-independent, there are [certain differences][diff] with [the Ruby version][ruby], one of which is the `truthy` value.
 
 ## The Truth Table
 
@@ -24,7 +24,7 @@ value          | truthy | falsy
 
 ## Use JavaScript Truthy
 
-Note that liquidjs use Shopify's truthiness by default. But it can be toggled to used standard JavaScript truthiness by setting the **jsTruthy** option to `true`.
+Note that LiquidJS uses Shopify's truthiness by default. It can be toggled to use standard JavaScript truthiness by setting the **jsTruthy** option to `true`.
 
 value          | truthy | falsy
 ---            | ---    | ---
diff --git a/docs/source/tutorials/use-in-expressjs.md b/docs/source/tutorials/use-in-expressjs.md
index 31934db12..36de03722 100644
--- a/docs/source/tutorials/use-in-expressjs.md
+++ b/docs/source/tutorials/use-in-expressjs.md
@@ -2,7 +2,7 @@
 title: Use in Express.js
 ---
 
-LiquidJS is compatible to the [express template engines](https://expressjs.com/en/resources/template-engines.html). You can set liquidjs instance to the [view engine][express-views] option:
+LiquidJS is compatible with [Express template engines](https://expressjs.com/en/resources/template-engines.html). You can set the LiquidJS instance as the [view engine][express-views] option:
 
 ```javascript
 var { Liquid } = require('liquidjs');
@@ -50,7 +50,7 @@ res.render('world')
 
 ## Caching
 
-Simply setting the [cache option][cache] to true will enable template caching, as explained in [Caching][Caching]. It's recommended to enable cache in production environment, which can be done by:
+Simply setting the [cache option][cache] to true will enable template caching, as explained in [Caching][Caching]. It's recommended to enable cache in a production environment, which can be done by:
 
 ```javascript
 var { Liquid } = require('liquidjs');
diff --git a/docs/source/tutorials/whitespace-control.md b/docs/source/tutorials/whitespace-control.md
index 71dc2e606..6bff3dc51 100644
--- a/docs/source/tutorials/whitespace-control.md
+++ b/docs/source/tutorials/whitespace-control.md
@@ -13,14 +13,14 @@ By default, all tags and output markups lines will generate a NL (`\n`), and whi
 {{ author }}
 ```
 
-Outputs (note the blank link):
+Outputs (note the blank line):
 
 ```
 
 harttle
 ```
 
-We can include hyphens in your tag syntax (`{% raw %}{{-{% endraw %}`, `-}}`, `{% raw %}{%-{% endraw %}`, `-%}`) to strip whitespace from left or right. For example:
+You can include hyphens in tag syntax (`{% raw %}{{-{% endraw %}`, `-}}`, `{% raw %}{%-{% endraw %}`, `-%}`) to strip whitespace from the left or right. For example:
 
 ```liquid
 {% assign author = "harttle" -%}
diff --git a/docs/themes/navy/layout/partial/head.swig b/docs/themes/navy/layout/partial/head.swig
index 2f245b2a5..ce443bb30 100644
--- a/docs/themes/navy/layout/partial/head.swig
+++ b/docs/themes/navy/layout/partial/head.swig
@@ -35,6 +35,7 @@
   <script src="https://cdn.cookiehub.eu/c2/e8e44c93.js"></script>
   <script type="text/javascript">
   document.addEventListener("DOMContentLoaded", function(event) {
+    if (location.hostname === 'localhost' || location.hostname === '127.0.0.1') return;
     var cpm = {};
     window.cookiehub.load(cpm);
   });
diff --git a/docs/themes/navy/source/css/_partial/base.styl b/docs/themes/navy/source/css/_partial/base.styl
index f75511a29..6f3d1a6ad 100644
--- a/docs/themes/navy/source/css/_partial/base.styl
+++ b/docs/themes/navy/source/css/_partial/base.styl
@@ -63,6 +63,7 @@ a
 #content-wrap
   background: var(--color-content-bg)
   overflow: hidden
+  box-shadow: var(--panel-shadow)
   
 .video-container
   text-align: center
diff --git a/docs/themes/navy/source/css/_partial/header.styl b/docs/themes/navy/source/css/_partial/header.styl
index 6c88a3a43..bc3d7c1b4 100644
--- a/docs/themes/navy/source/css/_partial/header.styl
+++ b/docs/themes/navy/source/css/_partial/header.styl
@@ -58,7 +58,7 @@ logo-size = 36px
   text-decoration: none
   line-height: logo-size
   white-space: nowrap
-  opacity: 0.7
+  opacity: 0.85
   transition: opacity 0.2s, color 0.2s
   display: inline-block
   padding: 0 12px
diff --git a/docs/themes/navy/source/css/_partial/highlight.styl b/docs/themes/navy/source/css/_partial/highlight.styl
index 908010296..86c77609c 100644
--- a/docs/themes/navy/source/css/_partial/highlight.styl
+++ b/docs/themes/navy/source/css/_partial/highlight.styl
@@ -1,19 +1,6 @@
 // https://github.com/chriskempson/tomorrow-theme
-// Tomorrow Night Eighties
-:root {
-    --highlight-background: #2d2d2d
-    --highlight-current-line: #393939
-    --highlight-selection: #515151
-    --highlight-foreground: #cccccc
-    --highlight-comment: #999999
-    --highlight-red: #f2777a
-    --highlight-orange: #f99157
-    --highlight-yellow: #ffcc66
-    --highlight-green: #99cc99
-    --highlight-aqua: #66cccc
-    --highlight-blue: #6699cc
-    --highlight-purple: #cc99cc
-}
+// Light: GitHub-style; dark: Tomorrow Night Eighties (tuned for navy palette)
+// Palette tokens live in _variables.styl
 
 pre, code
   font-family: font-mono
@@ -23,14 +10,19 @@ pre, code
 
 code
   padding: 0 5px
+  border-radius: 4px
 
 pre
   padding: 10px 15px
   line-height: 22px
+  code-block-chrome()
   code
     border: none
     display: block
     padding: 0
+  &.line-numbers
+    white-space: pre
+    overflow-x: auto
 
 .highlight
   padding: 10px 15px
@@ -38,6 +30,7 @@ pre
   background: var(--highlight-background)
   overflow: auto
   margin: 0
+  code-block-chrome()
   table
     margin: 0 !important
     border: 0
@@ -56,6 +49,9 @@ pre
     padding: 0
     background: none
     white-space: pre
+    border: none
+    box-shadow: none
+    border-radius: 0
   .line
     height: 22px
 
@@ -107,4 +103,21 @@ pre
     color: var(--highlight-blue)
   .keyword
   .javascript .function
-    color: var(--highlight-purple)
\ No newline at end of file
+    color: var(--highlight-purple)
+  // Prism bash: builtins (echo), external commands (npm), and cli-command (npx)
+  code.language-bash
+    .builtin,
+    .class-name,
+    .function,
+    .cli-command
+      color: var(--highlight-bash-command)
+    .operator
+      color: var(--highlight-purple)
+  code.language-shell
+    .builtin,
+    .class-name,
+    .function,
+    .cli-command
+      color: var(--highlight-bash-command)
+    .operator
+      color: var(--highlight-purple)
diff --git a/docs/themes/navy/source/css/_partial/page.styl b/docs/themes/navy/source/css/_partial/page.styl
index 91dc926fd..cb76494dd 100644
--- a/docs/themes/navy/source/css/_partial/page.styl
+++ b/docs/themes/navy/source/css/_partial/page.styl
@@ -1,6 +1,6 @@
-note-tip = #0fff00
-note-info = hsl(200, 100%, 50%)
-note-warn = hsl(0, 100%, 50%)
+note-tip = #3fb950
+note-info = #58a6ff
+note-warn = #f85149
 
 #content
   position: relative
@@ -26,7 +26,7 @@ note-warn = hsl(0, 100%, 50%)
   #article-toc
     display: none
     width: sidebar-width
-    opacity: 0.8
+    opacity: 0.9
     @media mq-normal
       display: block
 
@@ -86,7 +86,7 @@ note-warn = hsl(0, 100%, 50%)
 .article-edit-link
   float: right
   text-decoration: none;
-  color: #bbb
+  color: var(--color-gray)
   font-size: 24px
   line-height: 36px
   transition: 0.2s
@@ -111,21 +111,31 @@ note-warn = hsl(0, 100%, 50%)
   color: var(--color-default)
   @media print
     font-size: 12pt
-  p, ol, ul, dl, table, blockquote, iframe, .highlight
+  p, ol, ul, dl, table, blockquote, iframe, pre, .highlight
     margin: 1em 0
+  pre + pre,
+  .highlight + .highlight,
+  pre + .highlight,
+  .highlight + pre
+    margin-top: 1em
   h1
     font-size: 2em
   h2
     font-size: 1.5em
-    border-bottom: 1px solid var(--color-border)
+    border-bottom: 1px solid var(--heading-border)
     padding-bottom: 10px
-    margin-bottom: 15px
+    margin-bottom: 0.75em
   h3
     font-size: 1.3em
   h1, h2, h3, h4, h5, h6
     line-height: 1em
     font-weight: bold
-    margin: 1em 0
+    margin-top: 1.75em
+    margin-bottom: 0.625em
+  blockquote + h1, blockquote + h2, blockquote + h3, blockquote + h4,
+  .highlight + h1, .highlight + h2, .highlight + h3, .highlight + h4,
+  pre + h1, pre + h2, pre + h3, pre + h4
+    margin-top: 2.25em
   hr
     border-bottom: none;
     border-top: 1px dashed var(--color-border);
@@ -138,6 +148,9 @@ note-warn = hsl(0, 100%, 50%)
         padding-left: 3px;
         vertical-align: super;
         zoom: .7
+  :not(pre) > code
+    background: var(--inline-code-bg)
+    color: var(--inline-code-color)
   strong
     font-weight: bold
   em
@@ -156,7 +169,7 @@ note-warn = hsl(0, 100%, 50%)
   li
     p
       margin: 0
-    table, blockquote, iframe, .highlight
+    table, blockquote, iframe, pre, .highlight
       margin: 1em 0
   img, video
     max-width: 100%
@@ -165,8 +178,11 @@ note-warn = hsl(0, 100%, 50%)
   blockquote
     padding: 0 20px
     position: relative
+    background: var(--blockquote-bg)
     border: 1px solid var(--color-border)
-    border-left: 5px solid #ddd
+    border-left: 4px solid #ddd
+    border-radius: 6px
+    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06)
     footer
       margin: 1em 0
       font-style: italic
@@ -176,15 +192,16 @@ note-warn = hsl(0, 100%, 50%)
           padding: 0 0.3em
         a
           color: color-grey
-    @media (prefers-color-scheme: dark)
-      border-color: var(--color-gray)
   .note
     &.tip
       border-left-color: note-tip
+      background: var(--note-tip-bg)
     &.info
       border-left-color: note-info
+      background: var(--note-info-bg)
     &.warn
       border-left-color: note-warn
+      background: var(--note-warn-bg)
   .since
     margin-top: 0;
     font-style: italic;
@@ -206,9 +223,7 @@ note-warn = hsl(0, 100%, 50%)
       padding: 5px 15px
     tr
       &:nth-child(2n)
-        background: #eee
-        @media (prefers-color-scheme: dark)
-          background: var(--color-gray)
+        background: var(--table-stripe-bg)
 
 .article-footer
   margin: 60px 0 0
diff --git a/docs/themes/navy/source/css/_partial/playground.styl b/docs/themes/navy/source/css/_partial/playground.styl
index b1e61ba85..953dd1e88 100644
--- a/docs/themes/navy/source/css/_partial/playground.styl
+++ b/docs/themes/navy/source/css/_partial/playground.styl
@@ -1,48 +1,107 @@
 #playground
   background: var(--color-content-bg)
   overflow: hidden
+  box-shadow: var(--panel-shadow)
+
   .wrapper
     margin-bottom: 40px
+
   h1
     font-size: 36px
     font-weight: 300
-    margin: 40px 0 24px
+    margin-top: 40px
+    margin-bottom: 24px
+    color: var(--color-default)
+
+  h2
+    font-size: 0.8125rem
+    font-weight: 600
+    text-transform: uppercase
+    letter-spacing: 0.04em
+    color: var(--color-gray)
+    margin: 0
 
   #editors
     display: grid
     overflow: hidden
-    margin-bottom: 16px
+    margin-bottom: 0
     height: 75vh
-    grid-template-columns: auto auto
-    grid-template-rows: 60% 40%
+    min-height: 480px
+    grid-template-columns: 1fr 1fr
+    grid-template-rows: 3fr 2fr
     grid-gap: 16px
+    align-items: stretch
+    @media mq-mobile
+      height: auto
+      min-height: 0
+      grid-template-columns: 1fr
+      grid-template-rows: auto
+      grid-gap: 20px
+
   .area-tpl
     grid-row: 1
     grid-column: 1
+    min-height: 0
   .area-data
     grid-row: 2
     grid-column: 1
+    min-height: 0
   .area-output
     grid-column: 2
     grid-row: 1 / -1
+    min-height: 0
+    @media mq-mobile
+      grid-row: auto
+      grid-column: 1
+
   .editor-wrapper
     display: flex
     gap: 8px
     flex-direction: column
+    min-height: 0
+    overflow: hidden
     .editor
-      flex-grow: 1
+      flex: 1 1 auto
+      min-height: 0
+      position: relative
+      code-block-chrome()
+      overflow: hidden
+      @media mq-mobile
+        min-height: 240px
+    .ace_editor
+      font-family: font-mono
+      font-size: 14px
+      line-height: 1.5
+      border-radius: 6px
+    .ace_scrollbar
+      z-index: 2
+
+  .version
+    font-size: 0.8125rem
+    line-height: 1.5
+    font-family: font-mono
+    color: var(--color-gray)
+    margin-top: 20px
+    margin-bottom: 32px
+    a
+      color: inherit
+      text-decoration: none
+      &:hover
+        color: var(--color-link)
+        text-decoration: underline
+
   .hide
     display: none
+
   .loader
-    width: 75px
-    height: 75px
+    width: 48px
+    height: 48px
     margin: 150px auto 200px
-    border-top: 5px solid #292929
-    border-right: 5px solid #efefef
-    border-bottom: 5px solid #efefef
-    border-left: 5px solid #efefef
-    border-radius: 100px
-    animation: spin 1s infinite linear
+    border: 3px solid var(--color-border)
+    border-top-color: var(--color-link)
+    border-radius: 50%
+    animation: spin 0.8s infinite linear
+
   @keyframes spin
     100%
       transform: rotate(360deg)
diff --git a/docs/themes/navy/source/css/_partial/sidebar.styl b/docs/themes/navy/source/css/_partial/sidebar.styl
index 5ff6f4876..79ade0d83 100644
--- a/docs/themes/navy/source/css/_partial/sidebar.styl
+++ b/docs/themes/navy/source/css/_partial/sidebar.styl
@@ -1,7 +1,6 @@
 #sidebar
   width: sidebar-width
   padding-bottom: 40px
-  opacity: 0.8
   display: none
   @media mq-normal
     display: block
@@ -26,6 +25,7 @@
   line-height: 1
   position: relative
   width: 100%
+  transition: color 0.15s
   &.current
     color: var(--color-link)
   &:hover
diff --git a/docs/themes/navy/source/css/_variables.styl b/docs/themes/navy/source/css/_variables.styl
index 3ea093110..cac6b94fe 100644
--- a/docs/themes/navy/source/css/_variables.styl
+++ b/docs/themes/navy/source/css/_variables.styl
@@ -4,38 +4,86 @@ vendor-prefixes = webkit moz ms official
 
 // Colors
 :root {
-    --color-default: #444
-    --color-default-invert: #d1d2d4
-    --color-gray: #999
-    --color-border: #e3e3e3
-    --color-navy: hsl(210, 25%, 12%)
+    --color-default: #374151
+    --color-default-invert: #e8eaed
+    --color-gray: #6b7280
+    --color-border: #e5e7eb
+    --color-navy: hsl(218, 32%, 11%)
     --color-content-bg: #fff
-    --color-navy-lighter: lighten(hsl(210, 25%, 12%), 10%)
-    --color-link: #0e83cd
-    --color-link-hover: lighten(#0e83cd, 10%)
+    --color-navy-lighter: hsl(218, 28%, 16%)
+    --color-link: #2563eb
+    --color-link-hover: #1d4ed8
+    --panel-shadow: 0 0 48px rgba(0, 0, 0, 0.18)
+    --heading-border: var(--color-border)
+    --code-border: #d0d7de
+    --code-shadow: 0 1px 2px rgba(0, 0, 0, 0.04)
+    --inline-code-bg: rgba(175, 184, 193, 0.2)
+    --inline-code-color: var(--color-default)
+    --blockquote-bg: transparent
+    --note-tip-bg: rgba(63, 185, 80, 0.05)
+    --note-info-bg: rgba(88, 166, 255, 0.05)
+    --note-warn-bg: rgba(248, 81, 73, 0.05)
+    --table-stripe-bg: #f3f4f6
+    --highlight-background: #f6f8fa
+    --highlight-current-line: #f0f3f6
+    --highlight-selection: #b6d4fe
+    --highlight-foreground: #24292f
+    --highlight-comment: #6e7781
+    --highlight-red: #cf222e
+    --highlight-orange: #953800
+    --highlight-bash-command: #c95100
+    --highlight-yellow: #7d4e00
+    --highlight-green: #116329
+    --highlight-aqua: #0550ae
+    --highlight-blue: #0550ae
+    --highlight-purple: #8250df
 }
 
 @media (prefers-color-scheme: dark) {
     :root {
-        --color-default: #d1d2d4
-        --color-default-invert: #444
-        --color-gray: invert(#999)
-        --color-border: #6a6a6a
+        --color-default: #e6edf3
+        --color-default-invert: #374151
+        --color-gray: #9aa4b2
+        --color-border: #3d444d
         --color-background: #fff
-        --color-navy: hsl(210, 25%, 12%)
-        --color-navy-lighter: lighten(hsl(210, 25%, 12%), 7%)
-        --color-content-bg: #1c1c1c
-        --color-link: #0e83cd
-        --color-link-hover: lighten(#0e83cd, 10%)
+        --color-navy: hsl(218, 32%, 9%)
+        --color-navy-lighter: hsl(218, 28%, 15%)
+        --color-content-bg: hsl(218, 28%, 13%)
+        --color-link: #58a6ff
+        --color-link-hover: #79b8ff
+        --panel-shadow: 0 0 64px rgba(0, 0, 0, 0.35)
+        --heading-border: rgba(255, 255, 255, 0.08)
+        --code-border: rgba(255, 255, 255, 0.06)
+        --code-shadow: 0 1px 3px rgba(0, 0, 0, 0.12)
+        --inline-code-bg: var(--highlight-background)
+        --inline-code-color: var(--highlight-foreground)
+        --blockquote-bg: rgba(255, 255, 255, 0.03)
+        --note-tip-bg: rgba(63, 185, 80, 0.07)
+        --note-info-bg: rgba(88, 166, 255, 0.07)
+        --note-warn-bg: rgba(248, 81, 73, 0.07)
+        --table-stripe-bg: rgba(255, 255, 255, 0.04)
+        --highlight-background: hsl(218, 24%, 15%)
+        --highlight-current-line: hsl(218, 18%, 18%)
+        --highlight-selection: hsl(218, 15%, 24%)
+        --highlight-foreground: #e6edf3
+        --highlight-comment: #8b949e
+        --highlight-red: #ff7b72
+        --highlight-orange: #ffa657
+        --highlight-bash-command: var(--highlight-orange)
+        --highlight-yellow: #e3b341
+        --highlight-green: #7ee787
+        --highlight-aqua: #79c0ff
+        --highlight-blue: #79c0ff
+        --highlight-purple: #d2a8ff
     }
 }
 
 // Typography
-font-sans = "Helvetica Neue", Helvetica, Arial, sans-serif
+font-sans = -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", Helvetica, Arial, sans-serif
 font-serif = Garamond, Georgia, "Times New Roman", serif
-font-mono = "Source Code Pro", Monaco, Menlo, Consolas, monospace
+font-mono = "Source Code Pro", ui-monospace, Monaco, Menlo, Consolas, monospace
 font-size = 16px
-line-height = 1.8em
+line-height = 1.75
 
 // Layout
 max-width = 1800px
@@ -48,3 +96,9 @@ mq-mobile = "screen and (max-width: 768px)"
 mq-normal = "screen and (min-width: 769px)"
 mq-small = "screen and (min-width: 992px)"
 mq-tablet = "screen and (min-width: 480px)"
+
+// Shared code-block chrome (pre, .highlight, playground editors)
+code-block-chrome()
+  border-radius: 6px
+  border: 1px solid var(--code-border)
+  box-shadow: var(--code-shadow)
diff --git a/docs/themes/navy/source/js/main.js b/docs/themes/navy/source/js/main.js
index 88e4f3702..b113fb27b 100644
--- a/docs/themes/navy/source/js/main.js
+++ b/docs/themes/navy/source/js/main.js
@@ -45,12 +45,18 @@
     memoryLimit: 1e5,
     renderLimit: 1e5
   });
+  const colorScheme = window.matchMedia('(prefers-color-scheme: dark)');
   const editor = createEditor('editorEl', 'liquid');
   const dataEditor = createEditor('dataEl', 'json');
   const preview = createEditor('previewEl', 'html');
   preview.setReadOnly(true);
   preview.renderer.setShowGutter(false);
-  preview.renderer.setPadding(20);
+  preview.renderer.setPadding(16);
+
+  const editors = [editor, dataEditor, preview];
+  colorScheme.addEventListener('change', function() {
+    editors.forEach(applyEditorTheme);
+  });
 
   const init = parseArgs(location.hash.slice(1));
   if (init) {
@@ -67,20 +73,35 @@
     loader.classList.add('hide');
     loader.setAttribute('aria-busy', false);
 
-    const editors = document.querySelector('#editors');
-    editors.classList.remove('hide');
-    editors.setAttribute('aria-hide', false);
+    const editorsEl = document.querySelector('#editors');
+    editorsEl.classList.remove('hide');
+    editorsEl.setAttribute('aria-hide', false);
+    editors.forEach(function(ed) { ed.resize(); });
+  }
+
+  function getEditorTheme() {
+    return colorScheme.matches
+      ? 'ace/theme/tomorrow_night_eighties'
+      : 'ace/theme/github';
+  }
+
+  function applyEditorTheme(editor) {
+    editor.setTheme(getEditorTheme());
   }
 
   function createEditor(id, lang) {
     const editor = ace.edit(id);
-    editor.setTheme('ace/theme/tomorrow_night');
-    editor.getSession().setMode('ace/mode/' + lang);
-    editor.getSession().setOptions({
+    applyEditorTheme(editor);
+    editor.setOptions({
+      fontFamily: '"Source Code Pro", ui-monospace, Monaco, Menlo, Consolas, monospace',
+      fontSize: '14px',
+      showPrintMargin: false,
       tabSize: 2,
-      useSoftTabs: true
+      useSoftTabs: true,
+      scrollPastEnd: 0.25
     });
-    editor.renderer.setScrollMargin(15);
+    editor.getSession().setMode('ace/mode/' + lang);
+    editor.renderer.setScrollMargin(8, 8, 0, 0);
     return editor;
   }
 
@@ -119,9 +140,8 @@
   }
   
   function updateVersion(version) {
-    document.querySelector('.version').innerHTML = `
-      liquidjs@<a target="_blank" href="https://www.npmjs.com/package/liquidjs/v/${version}">${version}</a>
-    `
+    document.querySelector('.version').innerHTML =
+      'liquidjs@<a target="_blank" rel="noopener noreferrer" href="https://www.npmjs.com/package/liquidjs/v/' + version + '">' + version + '</a>';
   }
 }());
 
diff --git a/package.json b/package.json
index 4821ecb77..a99acadc7 100644
--- a/package.json
+++ b/package.json
@@ -30,7 +30,7 @@
     "build:umd": "BUNDLES=umd rollup -c rollup.config.mjs",
     "build:charmap": "./bin/character-gen.js > src/util/character.ts",
     "build:docs": "run-s build:docs-liquid build:contributors build:apidoc build:changelog build:docs-hexo",
-    "build:docs-liquid": "cross-env BUNDLES=min rollup -c rollup.config.mjs && shx mkdir -p docs/public/js && shx cp dist/liquid.browser.min.js docs/public/js/",
+    "build:docs-liquid": "cross-env BUNDLES=min rollup -c rollup.config.mjs && shx cp dist/liquid.browser.min.js docs/themes/navy/source/js/",
     "build:contributors": "node bin/build-contributors.js",
     "build:apidoc": "shx rm -rf docs/source/api && typedoc --plugin typedoc-plugin-missing-exports ./src --gitRevision master --out docs/source/api",
     "build:changelog": "node bin/build-changelog.js",

From 8a0c74a7fcb1671aa1dcb71ec82ba0602dc90d04 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sun, 14 Jun 2026 15:50:50 +0800
Subject: [PATCH 52/64] fix(security): charge pop filter allocation to
 memoryLimit (#907)

* fix(security): charge pop filter allocation to memoryLimit (CWE-770)

The `pop` array filter cloned the input via `[...toArray(v)]` without
charging `this.context.memoryLimit.use(...)`, bypassing the memoryLimit
DoS guard that its sibling filters (shift, unshift, compact, etc.) apply.
Mirror `shift` to account for the O(N) allocation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(security): charge sample filter full clone allocation to memoryLimit (CWE-770)

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/filters/array.ts                |  8 +++++---
 test/integration/liquid/dos.spec.ts | 10 ++++++++++
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/filters/array.ts b/src/filters/array.ts
index f22fcce20..502af5355 100644
--- a/src/filters/array.ts
+++ b/src/filters/array.ts
@@ -88,8 +88,10 @@ export function unshift<T> (this: FilterImpl, v: T[], arg: T): T[] {
   return clone
 }
 
-export function pop<T> (v: T[]): T[] {
-  const clone = [...toArray(v)]
+export function pop<T> (this: FilterImpl, v: T[]): T[] {
+  const array = toArray(v)
+  this.context.memoryLimit.use(array.length)
+  const clone = [...array]
   clone.pop()
   return clone
 }
@@ -252,7 +254,7 @@ export function sample<T> (this: FilterImpl, v: T[] | string, count = 1): T | st
   v = toValue(v)
   if (isNil(v)) return []
   if (!isArray(v)) v = stringify(v)
-  this.context.memoryLimit.use(count)
+  this.context.memoryLimit.use(v.length)
   const shuffled = [...v].sort(() => Math.random() - 0.5)
   if (count === 1) return shuffled[0]
   return shuffled.slice(0, count)
diff --git a/test/integration/liquid/dos.spec.ts b/test/integration/liquid/dos.spec.ts
index 85783564e..2aea12c48 100644
--- a/test/integration/liquid/dos.spec.ts
+++ b/test/integration/liquid/dos.spec.ts
@@ -79,6 +79,16 @@ describe('DoS related', function () {
       await expect(liquid.parseAndRender(src, { array, count: 3 })).resolves.toBe('a a a a a a a a')
       await expect(liquid.parseAndRender(src, { array, count: 100 })).rejects.toThrow('memory alloc limit exceeded, line:1, col:26')
     })
+    it('should charge pop allocation to memoryLimit', async () => {
+      const array = Array(1e3).fill(0)
+      const liquid = new Liquid({ memoryLimit: 100 })
+      await expect(liquid.parseAndRender('{{ array | pop | size }}', { array })).rejects.toThrow('memory alloc limit exceeded')
+    })
+    it('should charge sample allocation to memoryLimit', async () => {
+      const array = Array(1e3).fill(0)
+      const liquid = new Liquid({ memoryLimit: 100 })
+      await expect(liquid.parseAndRender('{{ array | sample: 1 | size }}', { array })).rejects.toThrow('memory alloc limit exceeded')
+    })
     it('should charge strip_html input length to memoryLimit', () => {
       const liquid = new Liquid({ memoryLimit: 100 })
       expect(() => liquid.parseAndRenderSync('{{ s | strip_html }}', { s: 'a'.repeat(200) }))

From 47752273584797305f3750f04e9c3651cdf8bbe9 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Sat, 20 Jun 2026 00:00:05 +0800
Subject: [PATCH 53/64] docs(security): route vulnerability reports to GitHub
 Advisories (#913)

Replace the private email contact with GitHub Security Advisories and
set the common-case fix expectation to within a month.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 SECURITY.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/SECURITY.md b/SECURITY.md
index c3fcbdd97..985970f68 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -6,8 +6,10 @@ Only the latest major version is supported with security updates. It can be chan
 
 ## Reporting a Vulnerability
 
-Please contact harttleharttle@gmail.com to report a vulnerability or change request.
+**Please do not report security vulnerabilities through public GitHub issues.**
 
-- If the vulnerability in question affects common use cases, it will be treated as a bug and fixed very soon (typically within 1 week).
+Report them via [GitHub Security Advisories — Report a vulnerability](https://github.com/harttle/liquidjs/security/advisories/new).
+
+- If the vulnerability in question affects common use cases, it will be treated as a bug and fixed very soon (typically within a month).
 - Otherwise, it'll be scheduled in the same priority of feature request (which is lower than bugs).
-- If the request is declined, you'll receive a reply email anyway (most likely there will be a discussion).
+- If the request is declined, you'll receive a reply anyway (most likely there will be a discussion).

From 03a30e6dc47d0d8f90f826a59741be31bc71372f Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 22 Jun 2026 01:34:53 +0800
Subject: [PATCH 54/64] docs: replace CookieHub with cookieconsent (#918)

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../navy/layout/partial/after_footer.swig     |  4 +-
 docs/themes/navy/layout/partial/footer.swig   |  1 +
 docs/themes/navy/layout/partial/head.swig     | 11 ++---
 .../source/css/_partial/cookieconsent.styl    | 15 ++++++
 .../navy/source/css/_partial/footer.styl      |  7 +++
 docs/themes/navy/source/css/navy.styl         |  1 +
 .../navy/source/js/cookieconsent-config.js    | 49 +++++++++++++++++++
 7 files changed, 77 insertions(+), 11 deletions(-)
 create mode 100644 docs/themes/navy/source/css/_partial/cookieconsent.styl
 create mode 100644 docs/themes/navy/source/js/cookieconsent-config.js

diff --git a/docs/themes/navy/layout/partial/after_footer.swig b/docs/themes/navy/layout/partial/after_footer.swig
index 8c36be6fb..e6778541a 100644
--- a/docs/themes/navy/layout/partial/after_footer.swig
+++ b/docs/themes/navy/layout/partial/after_footer.swig
@@ -17,12 +17,10 @@ debug: false
 });
 </script>
 
-<!-- Google tag (gtag.js) -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=G-GM713991QQ"></script>
-<script>
+<script type="text/plain" data-category="analytics">
   window.dataLayer = window.dataLayer || [];
   function gtag(){dataLayer.push(arguments);}
   gtag('js', new Date());
-
   gtag('config', 'G-GM713991QQ');
 </script>
\ No newline at end of file
diff --git a/docs/themes/navy/layout/partial/footer.swig b/docs/themes/navy/layout/partial/footer.swig
index 09753d621..ba66a2353 100644
--- a/docs/themes/navy/layout/partial/footer.swig
+++ b/docs/themes/navy/layout/partial/footer.swig
@@ -5,6 +5,7 @@
       {{__('footer.license')}}
     </div>
     <div id="footer-links">
+      <button type="button" class="footer-link cookie-preferences" data-cc="show-consentModal" title="Manage cookie preferences"><i class="icon-shield"></i></button>
       <a href="https://twitter.com/{{ config.twitter }}" class="footer-link" target="_blank"><i class="icon-twitter"></i></a>
       <a href="https://opencollective.com/{{ config.oc }}" class="footer-link" target="_blank"><i class="icon-opencollective"></i></a>
       <a href="https://github.com/{{ config.github }}" class="footer-link" target="_blank"><i class="icon-github"></i></a>
diff --git a/docs/themes/navy/layout/partial/head.swig b/docs/themes/navy/layout/partial/head.swig
index ce443bb30..1e85aa221 100644
--- a/docs/themes/navy/layout/partial/head.swig
+++ b/docs/themes/navy/layout/partial/head.swig
@@ -32,12 +32,7 @@
   <meta name="msapplication-TileImage" content="{{ url_for('icon/mstile-144x144.png') }}">
   {{ css('css/navy') }}
   {{ feed_tag('atom.xml') }}
-  <script src="https://cdn.cookiehub.eu/c2/e8e44c93.js"></script>
-  <script type="text/javascript">
-  document.addEventListener("DOMContentLoaded", function(event) {
-    if (location.hostname === 'localhost' || location.hostname === '127.0.0.1') return;
-    var cpm = {};
-    window.cookiehub.load(cpm);
-  });
-  </script>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orestbida/cookieconsent@3.1.0/dist/cookieconsent.css">
+  <script src="https://cdn.jsdelivr.net/gh/orestbida/cookieconsent@3.1.0/dist/cookieconsent.umd.js"></script>
+  {{ js('js/cookieconsent-config') }}
 </head>
diff --git a/docs/themes/navy/source/css/_partial/cookieconsent.styl b/docs/themes/navy/source/css/_partial/cookieconsent.styl
new file mode 100644
index 000000000..3e6eb84f4
--- /dev/null
+++ b/docs/themes/navy/source/css/_partial/cookieconsent.styl
@@ -0,0 +1,15 @@
+#cc-main
+  --cc-btn-primary-bg: var(--color-link)
+  --cc-btn-primary-color: #fff
+  --cc-btn-primary-border-color: var(--color-link)
+  --cc-btn-primary-hover-bg: var(--color-link-hover)
+  --cc-btn-primary-hover-border-color: var(--color-link-hover)
+  --cc-btn-secondary-bg: #eaeff2
+  --cc-btn-secondary-color: var(--color-default)
+  --cc-btn-secondary-border-color: #eaeff2
+  --cc-toggle-on-bg: var(--color-link)
+
+.cc--darkmode #cc-main
+  --cc-btn-secondary-bg: #3a4248
+  --cc-btn-secondary-color: var(--color-default)
+  --cc-btn-secondary-border-color: #3a4248
diff --git a/docs/themes/navy/source/css/_partial/footer.styl b/docs/themes/navy/source/css/_partial/footer.styl
index e5914c7be..2cb312c84 100644
--- a/docs/themes/navy/source/css/_partial/footer.styl
+++ b/docs/themes/navy/source/css/_partial/footer.styl
@@ -42,6 +42,13 @@
   @media mq-normal
     font-size: 30px
 
+.cookie-preferences
+  background: none
+  border: 0
+  padding: 0
+  cursor: pointer
+  color: inherit
+
 .icon-oc
   height: 36px
   width: 30px
diff --git a/docs/themes/navy/source/css/navy.styl b/docs/themes/navy/source/css/navy.styl
index 79bf3f7f3..40c4f448d 100644
--- a/docs/themes/navy/source/css/navy.styl
+++ b/docs/themes/navy/source/css/navy.styl
@@ -9,6 +9,7 @@
 @import "_partial/page"
 @import "_partial/mobile_nav"
 @import "_partial/footer"
+@import "_partial/cookieconsent"
 @import "_partial/highlight"
 @import "_partial/icomoon.css"
 @import "_partial/docsearch.min.css"
\ No newline at end of file
diff --git a/docs/themes/navy/source/js/cookieconsent-config.js b/docs/themes/navy/source/js/cookieconsent-config.js
new file mode 100644
index 000000000..81a7f9bbf
--- /dev/null
+++ b/docs/themes/navy/source/js/cookieconsent-config.js
@@ -0,0 +1,49 @@
+(function () {
+  if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
+    document.documentElement.classList.add('cc--darkmode');
+  }
+
+  var config = {
+    guiOptions: {
+      consentModal: {
+        equalWeightButtons: false
+      }
+    },
+    categories: {
+      necessary: {
+        enabled: true,
+        readOnly: true
+      },
+      analytics: {
+        enabled: false
+      }
+    },
+    language: {
+      default: 'en',
+      translations: {
+        en: {
+          consentModal: {
+            title: 'We use cookies',
+            description: 'This site uses cookies for analytics and to improve your experience.',
+            acceptAllBtn: 'Accept',
+            acceptNecessaryBtn: 'Reject'
+          }
+        }
+      }
+    }
+  };
+
+  if (/^localhost$|^127\.0\.0\.1$/i.test(location.hostname)) {
+    config.cookie = { secure: false };
+  }
+
+  function run() {
+    CookieConsent.run(config);
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', run);
+  } else {
+    run();
+  }
+}());

From 6d00257e157e663d8ecd4df1b6170c8c32db757c Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 22 Jun 2026 02:24:54 +0800
Subject: [PATCH 55/64] docs: add AGENTS.md and llms.txt for AI agents (#919)

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .cursor/rules/architecture.mdc | 17 ------
 .cursor/rules/conventions.mdc  |  6 ---
 .cursor/rules/testing.mdc      | 17 ------
 AGENTS.md                      | 94 ++++++++++++++++++++++++++++++++++
 docs/source/llms.txt           | 28 ++++++++++
 5 files changed, 122 insertions(+), 40 deletions(-)
 delete mode 100644 .cursor/rules/architecture.mdc
 delete mode 100644 .cursor/rules/conventions.mdc
 delete mode 100644 .cursor/rules/testing.mdc
 create mode 100644 AGENTS.md
 create mode 100644 docs/source/llms.txt

diff --git a/.cursor/rules/architecture.mdc b/.cursor/rules/architecture.mdc
deleted file mode 100644
index d83fabffa..000000000
--- a/.cursor/rules/architecture.mdc
+++ /dev/null
@@ -1,17 +0,0 @@
----
-description: Architecture overview for liquidjs internals
-alwaysApply: true
----
-
-## Async/sync duality via generators
-
-All core logic is written once as a `Generator` function (`function *`). Use `yield` where you'd normally `await` a potentially async value.
-
-- `toPromise(generator)` drives it **asynchronously** — awaits yielded promises.
-- `toValueSync(generator)` drives it **synchronously** — passes yielded values through as-is.
-
-Never duplicate logic into separate async and sync methods. A single generator serves both paths.
-
-When wrapping an async+sync function pair (e.g. `contains`/`containsSync`, `exists`/`existsSync`, `readFile`/`readFileSync`), use `toLiquidAsync(asyncFn, syncFn?)` which returns a `LiquidAsync<F>` — one function that picks the sync or async implementation based on a leading `sync: boolean` arg. Then `yield` the result inside a generator to let the driver handle it in both modes.
-
-See `src/util/async.ts`.
diff --git a/.cursor/rules/conventions.mdc b/.cursor/rules/conventions.mdc
deleted file mode 100644
index 55febef8e..000000000
--- a/.cursor/rules/conventions.mdc
+++ /dev/null
@@ -1,6 +0,0 @@
----
-description: Project conventions for liquidjs
-alwaysApply: true
----
-
-- Keep edits minimal: change only what the task requires, match existing style.
diff --git a/.cursor/rules/testing.mdc b/.cursor/rules/testing.mdc
deleted file mode 100644
index 6c27faae0..000000000
--- a/.cursor/rules/testing.mdc
+++ /dev/null
@@ -1,17 +0,0 @@
----
-description: Testing conventions — e2e uses built dist, integration uses src
-globs: test/**/*.ts
-alwaysApply: false
----
-
-# Testing
-
-## End-to-end tests (`test/e2e`)
-
-- **Use the built package**, not TypeScript sources under `src/`.
-- Import the public API from the package root (for example `import { Liquid } from '../..'`), which resolves through `package.json` to **`dist/`** (`main`, `module`, etc.).
-- **Avoid** `import … from '../../src/liquid'` (or other `src/` paths) in `test/e2e/**` so e2e matches what consumers get from npm and you do not depend on an unbuilt tree.
-
-## Integration and unit tests
-
-- Tests under `test/integration/`, `src/**/*.spec.ts`, and similar may import from **`src/`** when the suite is meant to run against the current TypeScript sources (typical for this repo’s Jest setup).
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..5667f9002
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,94 @@
+# LiquidJS
+
+Shopify / GitHub Pages compatible Liquid template engine. TypeScript in `src/`, bundles in `dist/`. Docs site in `docs/` (Hexo, `navy` theme).
+
+## Layout
+
+| Path | Contents |
+| --- | --- |
+| `src/parser`, `src/render`, `src/tags`, `src/filters` | Template parse and render |
+| `src/context`, `src/template`, `src/tokens` | Scope, templates, token stream |
+| `src/util/async.ts` | `toPromise`, `toValueSync`, `toLiquidAsync` |
+| `test/` | Jest |
+| `docs/source/` | Doc markdown; sidebar in `docs/source/_data/sidebar.yml` |
+| `docs/themes/navy/` | Layout, CSS, JS |
+| `.local/` | Scratch, repro, PoC (gitignored) |
+
+## Commands
+
+```
+npm run build          # after src/ changes, before npm test
+npm test
+npm run lint
+npm run check          # build + build:docs + test + lint + perf:diff (manual)
+npm run build:docs
+cd docs && npm start   # http://localhost:4000
+npm run perf:diff
+```
+
+PR CI (`pull_request`): build, lint, test, coverage, performance. Docs build runs on push to `master` only.
+
+PR titles: conventional format (`feat:`, `fix:`, `docs:`, …) — checked by CI. Releases on `master` use semantic-release from merged commits.
+
+Backward-compatible API changes expected unless doing an intentional major break.
+
+## Architecture
+
+All core logic is one `function *` per feature. Use `yield` where you'd normally `await` a potentially async value.
+
+- `toPromise(generator)` — async driver; awaits yielded promises
+- `toValueSync(generator)` — sync driver; passes yielded values through as-is
+
+Never duplicate logic into separate async and sync methods. One generator serves both paths.
+
+When wrapping an async+sync pair (e.g. `contains`/`containsSync`, `readFile`/`readFileSync`), use `toLiquidAsync(asyncFn, syncFn?)` — returns a `LiquidAsync<F>` that picks sync or async via a leading `sync: boolean` arg. `yield` the result inside a generator. See `src/util/async.ts`.
+
+## Style
+
+Make minimal changes only. Avoid sweeping edits. Always check after you made changes.
+
+- Change only what the task requires. No drive-by refactors, test harnesses, or extra files unless asked.
+- Match existing patterns in the file you edit.
+- Repro, PoC, and scratch files go in `.local/` — not tracked `poc/` folders or one-off scripts under `docs/`.
+
+### Comments
+
+- Do not add narrative comments. Code should be clear from structure and naming; if it needs explanation, refactor instead.
+- Comments follow existing repo usage only: non-obvious invariants, `@deprecated`, JSDoc on public API where TypeDoc needs it. Not for explaining changes to the author, migration history, or restating what the code already says.
+- Comments document the code; they do not fix unclear code.
+
+### Tests
+
+- Assert observable behavior, not internal implementation details.
+- Avoid duplicate coverage; keep test diffs minimal.
+- **E2E** (`test/e2e/`): import from the package root (resolves to `dist/` via `package.json`). Do not import from `src/` — e2e must match what npm consumers get.
+- **Integration/unit** (`test/integration/`, etc.): may import from `src/` against current TypeScript sources.
+
+### Docs site
+
+- Reuse existing asset paths under `docs/source/` and `docs/themes/navy/` — no new asset directories unless asked.
+- Front matter `title:` is plain text (no backticks).
+- `docs/source/llms.txt` — deployed to https://liquidjs.com/llms.txt for web agents (llms.txt spec).
+- After theme/markdown changes: build or serve locally, check in a browser (light and dark), not only curl or editor preview.
+
+### README
+
+- Research original sources before reordering contributors, logos, or lists.
+
+## Verify
+
+- Do not commit, push, amend, or open a PR unless asked.
+- After changes: verify yourself via CLI or UI (tests, `cd docs && npm start`, browser) before reporting done. Do not tell the user to check instead.
+- Before push on sweeping changes: run `npm run check`.
+- Confirm facts from `.github/workflows`, `package.json`, and library docs — not stale human docs or assumptions.
+- When replacing or integrating a library: read its docs and understand what the previous setup did before changing behavior.
+
+### Security fixes
+
+- Reproduce on current `master` first. Smallest fix that addresses the reported issue.
+- If Shopify/Ruby Liquid behaves the same, document unsafe usage in filter/docs instead of changing behavior.
+
+## Docs
+
+- Published: https://liquidjs.com
+- Repo agent instructions: this file (`AGENTS.md`)
diff --git a/docs/source/llms.txt b/docs/source/llms.txt
new file mode 100644
index 000000000..621cdf4d1
--- /dev/null
+++ b/docs/source/llms.txt
@@ -0,0 +1,28 @@
+# LiquidJS
+
+> A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.
+
+## Tutorials
+
+- [Introduction to Liquid](https://liquidjs.com/tutorials/intro-to-liquid.html)
+- [Setup](https://liquidjs.com/tutorials/setup.html)
+- [Options](https://liquidjs.com/tutorials/options.html)
+- [Render files](https://liquidjs.com/tutorials/render-file.html)
+- [Partials and layouts](https://liquidjs.com/tutorials/partials-and-layouts.html)
+- [Express.js](https://liquidjs.com/tutorials/use-in-expressjs.html)
+- [Register filters and tags](https://liquidjs.com/tutorials/register-filters-tags.html)
+- [Plugins](https://liquidjs.com/tutorials/plugins.html)
+- [Sync and async](https://liquidjs.com/tutorials/sync-and-async.html)
+- [Operators](https://liquidjs.com/tutorials/operators.html)
+- [Truthy and falsy](https://liquidjs.com/tutorials/truthy-and-falsy.html)
+- [Security model](https://liquidjs.com/tutorials/security-model.html)
+- [Differences from Shopify Liquid](https://liquidjs.com/tutorials/differences.html)
+- [Migrate to v9](https://liquidjs.com/tutorials/migrate-to-9.html)
+- [Changelog](https://liquidjs.com/tutorials/changelog.html)
+
+## Reference
+
+- [Tags](https://liquidjs.com/tags/overview.html)
+- [Filters](https://liquidjs.com/filters/overview.html)
+- [API (TypeDoc)](https://liquidjs.com/api/)
+- [Playground](https://liquidjs.com/playground.html)

From 5c3522f33928aae66f0fe85c36e1d9015c768fe2 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 22 Jun 2026 02:28:07 +0800
Subject: [PATCH 56/64] fix(strip_html): infinite loop for strip_html

---
 .gitignore                            | 1 +
 docs/source/filters/strip_html.md     | 8 ++++++++
 src/filters/html.ts                   | 2 +-
 test/integration/filters/html.spec.ts | 4 ++++
 4 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 24be3ed8d..9fe5dbbf8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,6 +11,7 @@ coverage/
 node_modules/
 
 # tmp
+.local/
 docs/themes/navy/source/js/liquid.browser.min.js
 docs/themes/navy/layout/partial/all-contributors.swig
 docs/themes/navy/layout/partial/financial-contributors.swig
diff --git a/docs/source/filters/strip_html.md b/docs/source/filters/strip_html.md
index 86248716b..ccb4f581c 100644
--- a/docs/source/filters/strip_html.md
+++ b/docs/source/filters/strip_html.md
@@ -6,6 +6,10 @@ title: strip_html
 
 Removes any HTML tags from a string.
 
+{% note warn Not safe for HTML output %}
+This filter removes tags by string scanning; it does not parse HTML5 the way a browser does, and it is not a sanitizer. The result may still be unsafe when inserted into HTML. Use [escape][escape], [escape_once][escape_once], or [`outputEscape: "escape"`][outputEscape] for untrusted output.
+{% endnote %}
+
 Input
 ```liquid
 {{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}
@@ -15,3 +19,7 @@ Output
 ```text
 Have you read Ulysses?
 ```
+
+[escape]: ./escape.html
+[escape_once]: ./escape.html
+[outputEscape]: ../tutorials/options.html#outputEscape
diff --git a/src/filters/html.ts b/src/filters/html.ts
index 807c42373..b52f1b3da 100644
--- a/src/filters/html.ts
+++ b/src/filters/html.ts
@@ -60,7 +60,7 @@ export function strip_html (this: FilterImpl, v: string) {
       if (e >= 0) { i = e + closer.length; break }
       blocks.delete(opener)
     }
-    if (i === lt) return out + str.slice(lt)
+    if (i <= lt) return out + str.slice(lt)
   }
   return out
 }
diff --git a/test/integration/filters/html.spec.ts b/test/integration/filters/html.spec.ts
index e858420e0..fdf75e4c6 100644
--- a/test/integration/filters/html.spec.ts
+++ b/test/integration/filters/html.spec.ts
@@ -85,5 +85,9 @@ describe('filters/html', function () {
       expect(liquid.parseAndRenderSync('{{"<img\rsrc=x\ronerror=alert(1)>" | strip_html}}')).toBe('')
       expect(liquid.parseAndRenderSync('{{"<svg\nonload=alert(1)>" | strip_html}}')).toBe('')
     })
+    it('should not loop on unclosed openers (GHSA-m7fp-h3p4-hr49)', function () {
+      expect(liquid.parseAndRenderSync('{{ "a<" | strip_html }}')).toBe('a<')
+      expect(liquid.parseAndRenderSync('{{ "hello<world<again" | strip_html }}')).toBe('hello<world<again')
+    })
   })
 })

From 956b51ea953eb52d9eba7409b7f51e379023fec4 Mon Sep 17 00:00:00 2001
From: Timmy Braun <35117769+timbze@users.noreply.github.com>
Date: Mon, 22 Jun 2026 06:07:27 -0600
Subject: [PATCH 57/64] fix: improve round function; improvement to #873 (#901)

---
 src/filters/math.ts                   | 5 ++---
 test/integration/filters/math.spec.ts | 4 ++++
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/filters/math.ts b/src/filters/math.ts
index fa06b4ef8..cb6775bff 100644
--- a/src/filters/math.ts
+++ b/src/filters/math.ts
@@ -15,7 +15,6 @@ export function round (v: number, arg = 0) {
   v = toNumber(v)
   arg = toNumber(arg)
   const amp = Math.pow(10, arg)
-  const scaled = v * amp
-  // Round half away from zero
-  return Math.sign(v) * Math.round(Math.abs(scaled)) / amp
+  const scaled = (v * amp) * (1 + Number.EPSILON)
+  return Math.round(scaled) / amp
 }
diff --git a/test/integration/filters/math.spec.ts b/test/integration/filters/math.spec.ts
index e8a4722a5..ab52cb4be 100644
--- a/test/integration/filters/math.spec.ts
+++ b/test/integration/filters/math.spec.ts
@@ -70,6 +70,10 @@ describe('filters/math', function () {
     it('should return "183.36" for 183.357,2',
       () => test('{{183.357|round: 2}}', '183.36'))
     it('should convert string to number', () => test('{{"2.7"|round}}', '3'))
+    it('odd number 1.005 should round correctly', () => test('{{1.005|round:2}}', '1.01'))
+    it('odd number -1.005 should round correctly', () => test('{{num|round:2}}', { num: -1.005 }, '-1.01'))
+    it('odd number 9.075 should round correctly', () => test('{{9.075|round:2}}', '9.08'))
+    it('odd number -9.075 should round correctly', () => test('{{num|round:2}}', { num: -9.075 }, '-9.08'))
   })
   describe('times', function () {
     it('should return "6" for 3,2', () => test('{{ 3 | times: 2 }}', '6'))

From 3a0d80d1f4526af0fbca2bb2e0a9c51669d2fd3e Mon Sep 17 00:00:00 2001
From: Max Medve <23156422+amedve@users.noreply.github.com>
Date: Mon, 22 Jun 2026 08:11:06 -0400
Subject: [PATCH 58/64] perf(parser): memoize createTrie to avoid rebuilding
 tries per Tokenizer (#911)

The Tokenizer constructor calls createTrie(operators) and
createTrie(literalValues) on every instantiation, and liquidjs builds a
fresh Tokenizer per output/tag while parsing. On typical templates this
rebuilt the same prefix-tries dozens of times and showed up as a large
share of parse CPU in profiling.

Memoize createTrie with a module-level WeakMap keyed on the input object.
The inputs (operators, literalValues) are stable references and the trie
is only ever read afterward (via matchTrie), never mutated, so caching by
reference is behavior-preserving. WeakMap (not Map) lets short-lived,
per-instance operator objects and their tries be garbage collected.
---
 src/parser/tokenizer.spec.ts |  8 ++++++++
 src/util/operator-trie.ts    | 10 ++++++++++
 2 files changed, 18 insertions(+)

diff --git a/src/parser/tokenizer.spec.ts b/src/parser/tokenizer.spec.ts
index c8d4f6311..08cf084b7 100644
--- a/src/parser/tokenizer.spec.ts
+++ b/src/parser/tokenizer.spec.ts
@@ -522,6 +522,14 @@ describe('Tokenizer', function () {
       expect(new Tokenizer('contains b').matchTrie(opTrie)).toBe(8)
     })
   })
+  describe('#createTrie()', function () {
+    it('should return the same trie for the same input', () => {
+      expect(createTrie(defaultOperators)).toBe(createTrie(defaultOperators))
+    })
+    it('should return distinct tries for distinct inputs', () => {
+      expect(createTrie({ foo: 1 })).not.toBe(createTrie({ foo: 1 }))
+    })
+  })
   describe('#readLiquidTagTokens', () => {
     it('should read newline terminated tokens', () => {
       const tokenizer = new Tokenizer('echo \'hello\'')
diff --git a/src/util/operator-trie.ts b/src/util/operator-trie.ts
index f94d7138a..0ecbaa21d 100644
--- a/src/util/operator-trie.ts
+++ b/src/util/operator-trie.ts
@@ -10,7 +10,16 @@ export type Trie<T> = {
   needBoundary?: true
 } & Record<string, any>
 
+// Tries are built once per input object and reused: the Tokenizer rebuilds them
+// on every instantiation, but `input` (operators/literalValues) is a stable
+// reference. WeakMap-keying by `input` lets short-lived operator objects (and
+// their tries) be garbage collected. The returned trie is treated as read-only
+// by callers (matchTrie only reads it); do not mutate it.
+const trieCache = new WeakMap<TrieInput<any>, Trie<any>>()
+
 export function createTrie<T = any> (input: TrieInput<T>): Trie<T> {
+  const cached = trieCache.get(input)
+  if (cached) return cached
   const trie: Trie<T> = {}
   for (const [name, data] of Object.entries(input)) {
     let node = trie
@@ -29,5 +38,6 @@ export function createTrie<T = any> (input: TrieInput<T>): Trie<T> {
     node.data = data
     node.end = true
   }
+  trieCache.set(input, trie)
   return trie
 }

From afec88b04cd5363e0b6b02c0eb15b2fc575c4f20 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Tue, 23 Jun 2026 17:39:19 +0800
Subject: [PATCH 59/64] docs(readme): README overhaul, used-by grid, and docs
 homepage (#914)

* docs(readme): lead with quick start and scannable structure

Restructure the README to match common OSS conventions: tagline and
badges above the fold, copy-paste Quick start, Features list, and a
compact Used by section. Remove the star plea, centered logo, and
per-project marketing blurbs that pushed useful content down.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(readme): playground GIF, used-by grid, and docs homepage sync

Add data/used-by.json with build:used-by for README and docs homepage, playground demo capture, and shared home-section layout. Used by lists products with site logos; Financial Support keeps org and individual sponsors.

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: use .local for playground capture scratch files

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: satisfy eslint in build-used-by and capture scripts

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: drop one-off playground capture script

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(docs): copy Used by from README like financial contributors

Drop data/used-by.json and build-used-by.js; build-contributors.js now extracts USED-BY-BEGIN/END to used-by.swig.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(docs): inline Used by section, drop home-section partial

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): drop redundant logo styles from .contributors

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): build liquid bundle before hexo serve

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(docs): drop playground window chrome from capture demo

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(docs): revert playground capture changes to master behavior

Restore Ace output pane, drop Prism and output-preview styling. Simplify docs:dev to rely on docs prestart.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(docs): rely on docs prebuild for liquid bundle and contributors

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat(docs): show playground output as Prism-highlighted HTML code

Co-authored-by: Cursor <cursoragent@cursor.com>

* feat(docs): polish playground layout and regenerate README demo GIF

* fix(docs): align playground GIF capture with live editor styling

* fix(docs): unify playground pane padding and hold output on errors

Match editor inset to the output panel, drop Prism from output preview,
keep the last render while typing invalid template/context, and refresh
the README demo GIF.

* fix(docs): regenerate playground GIF with held output during typing

* feat(docs): sync Used by logos and polish playground

Inline README Used by grid on the docs homepage, refine playground layout and live output behavior, and drop the unused build-used-by script from package scripts.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): restore Rock RMS logo and remove duplicate entry

Restore the official Rock RMS wordmark (GetImage.ashx?id=72534) instead of the SparkDevNetwork GitHub org avatar that was wrongly substituted for it.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): regenerate playground GIF with live indicator states

Restore the capture script for the new pane-indicator layout so the README demo shows correct idle/active/pending/ok colors and pulsing animations while typing.

* fix(docs): static playground GIF with correct indicator colors

Capture one frame per keystroke with animations disabled so dot states
(idle/active/pending/ok) match the live playground without pulsing.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: use square Rock RMS icon in Used by section

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): ensure capture indicator colors apply instantly

Disable indicator transitions and cancel active animations before
setting data-state so pending yellow is not stuck on the prior ok green.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: point Microsoft Used by link to microsoft.com

The merged tile title covers Power Pages and Azure API Management; href should go to Microsoft home, not Power Pages only.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: remove Dailycontributors from Used by section

No evidence they run on LiquidJS; they are an OpenCollective sponsor only.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: reword intro to say Liquid, not Shopify Liquid

Move Shopify into the compatibility list and drop the shopify/liquid link from README; align package.json description.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): restore playground output as Prism-highlighted HTML

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: add extensible to README intro and package description

EOF

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: move playground capture script to .local

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(docs): drop unused Ace mode-html from playground

Output pane uses Prism, not Ace; template and context editors still need liquid/json modes and basePath for themes.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: sync intro sentence across package and site metadata

Align package.json, docs config, manifest, llms.txt, and AGENTS.md tagline to the README canonical description.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: trim verbose intro in intro-to-liquid tutorial

Remove README tagline and repo-purpose copy duplicated by the recent metadata sync.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: shorten homepage banner subtitle

Trim docs site banner and short taglines after the em dash; keep full description for meta tags and npm/README.

* docs: simplify playground GIF caption in README

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: dedupe homepage subtitle and description into _config.yml

Remove redundant front matter from index.pug; theme falls back to site config for banner and meta tags.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .gitignore                                    |   1 +
 AGENTS.md                                     |   2 +-
 README.md                                     | 100 +++---
 bin/build-contributors.js                     |   2 +
 docs/_config.yml                              |   4 +-
 docs/source/index.pug                         |   2 -
 docs/source/llms.txt                          |   2 +-
 docs/source/manifest.json                     |   2 +-
 docs/source/playground-demo.gif               | Bin 0 -> 38455 bytes
 docs/source/tutorials/intro-to-liquid.md      |   5 +-
 docs/themes/navy/languages/en.yml             |   6 +-
 docs/themes/navy/layout/index.swig            |  23 +-
 .../navy/layout/partial/after_footer.swig     |   5 +
 docs/themes/navy/layout/partial/demo.json     |   6 +-
 docs/themes/navy/layout/partial/demo.liquid   |  10 +-
 docs/themes/navy/layout/playground.swig       |  50 ++-
 .../navy/source/css/_partial/index.styl       |   4 +-
 .../navy/source/css/_partial/playground.styl  | 315 +++++++++++++++---
 docs/themes/navy/source/css/_variables.styl   |   4 +
 docs/themes/navy/source/js/main.js            | 135 +++++++-
 package.json                                  |   9 +-
 21 files changed, 526 insertions(+), 161 deletions(-)
 create mode 100644 docs/source/playground-demo.gif

diff --git a/.gitignore b/.gitignore
index 9fe5dbbf8..64519d058 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,6 +15,7 @@ node_modules/
 docs/themes/navy/source/js/liquid.browser.min.js
 docs/themes/navy/layout/partial/all-contributors.swig
 docs/themes/navy/layout/partial/financial-contributors.swig
+docs/themes/navy/layout/partial/used-by.swig
 dist/
 demo/*/yarn.json
 
diff --git a/AGENTS.md b/AGENTS.md
index 5667f9002..7359ce9f3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,6 +1,6 @@
 # LiquidJS
 
-Shopify / GitHub Pages compatible Liquid template engine. TypeScript in `src/`, bundles in `dist/`. Docs site in `docs/` (Hexo, `navy` theme).
+A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support. TypeScript in `src/`, bundles in `dist/`. Docs site in `docs/` (Hexo, `navy` theme).
 
 ## Layout
 
diff --git a/README.md b/README.md
index eb4d616b6..852d6c034 100644
--- a/README.md
+++ b/README.md
@@ -1,72 +1,86 @@
-# liquidjs
+# LiquidJS
+
+A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support.
+
 [![npm version](https://img.shields.io/npm/v/liquidjs.svg?logo=npm&style=flat-square)](https://www.npmjs.org/package/liquidjs)
 [![npm downloads](https://img.shields.io/npm/dm/liquidjs.svg?style=flat-square)](https://www.npmjs.org/package/liquidjs)
-[![Coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg?style=flat-square)](https://coveralls.io/github/harttle/liquidjs?branch=master)
 [![Build Status](https://img.shields.io/github/actions/workflow/status/harttle/liquidjs/ci-build.yml?branch=master&style=flat-square)](https://github.com/harttle/liquidjs/actions/workflows/ci-build.yml?query=branch%3Amaster)
-[![DUB license](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
-[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](https://github.com/harttle/liquidjs)
+[![Coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg?style=flat-square)](https://coveralls.io/github/harttle/liquidjs?branch=master)
+[![License: MIT](https://img.shields.io/github/license/harttle/liquidjs?style=flat-square)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
 
-A simple, expressive and safe [Shopify][shopify/liquid] / GitHub Pages compatible template engine in pure JavaScript.
-**The purpose of this repo** is to provide a standard Liquid implementation for the JavaScript community so that [Jekyll sites](https://jekyllrb.com), [GitHub Pages](https://pages.github.com/) and [Shopify templates](https://themes.shopify.com/) can be ported to Node.js without pain.
+[Documentation][doc] · [Playground](https://liquidjs.com/playground.html) · [Setup guide][setup] · [Contributing][contribution]
 
-* [Documentation][doc]
-* Please star [LiquidJS on GitHub][github]!
-* Financial support via [GitHub Sponsors](https://github.com/sponsors/harttle).
+<a href="https://liquidjs.com/playground.html">
+  <img src="docs/source/playground-demo.gif" alt="LiquidJS playground: edit a template and context, see live HTML output" width="980" style="display: block; margin: 0 auto;" />
+</a>
 
-<p align="center"><a href="https://liquidjs.com"><img height="155px" width="155px" src="https://liquidjs.com/icon/mstile-310x310.png" alt="logo"></a></p>
+<p align="center"><sub>Try the <a href="https://liquidjs.com/playground.html">online playground</a>.</sub></p>
 
-## What's it like?
+## Quick start
 
-Basically there're two types of Liquid syntax: tags enclosed by `{% %}` and outputs enclosed by `{{ }}`. A Liquid template looks like:
+```js
+import { Liquid } from 'liquidjs'
 
-```liquid
-{% if username %}
-  {{ username | append: ", welcome to LiquidJS!" | capitalize }}
-{% endif %}
+const engine = new Liquid()
+const html = await engine.parseAndRender(
+  'Hello, {{ name | capitalize }}!',
+  { name: 'liquid' }
+)
+//=> 'Hello, Liquid!'
 ```
 
-[A live demo](https://liquidjs.com/playground.html) is also available and here's a [quick tutorial](https://liquidjs.com/tutorials/intro-to-liquid.html) for Liquid syntax.
-
-
 ## Installation
 
-Install from npm in Node.js:
+**Node.js**
 
 ```bash
 npm install liquidjs
 ```
 
-Or use the UMD bundle from jsDelivr:
+**Browser** (jsDelivr UMD bundle)
 
 ```html
 <script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.browser.min.js"></script>
 ```
 
-Or render directly from CLI using npx:
+**CLI**
 
 ```bash
-npx liquidjs --template 'Hello, {{ name }}!' --context '{"name": "Snake"}'
+npx liquidjs --template 'Hello, {{ name }}!' --context '{"name": "Liquid"}'
 ```
 
-For more details, refer to the [Setup Guide][setup].
+See the [setup guide][setup] for partials, layouts, caching, and other options.
 
-## Who's Using LiquidJS?
+## Used by
 
-- [Eleventy](https://www.11ty.dev/): Eleventy, a simpler static site generator.
-- [Github Docs](https://github.com/github/docs): The open-source repo for docs.github.com.
-- [Kibana](https://github.com/elastic/kibana): Elastic's analytics and visualization platform for Elasticsearch; workflow features use LiquidJS for Liquid templates.
-- [Opensense](https://www.opensense.com/): The smarter way to send email.
-- [Directus](https://docs.directus.io/): an instant REST+GraphQL API and intuitive no-code data collaboration app for any SQL database.
-- [Rock](https://www.rockrms.com/): An open source CMS, Relationship Management System (RMS) and Church Management System (ChMS) all rolled into one.
-- [Mitosis](https://github.com/BuilderIO/mitosis): Write components once, run everywhere. Compiles to React, Vue, Qwik, Solid, Angular, Svelte, and more.
-- [Pattern Lab](https://patternlab.io/): a frontend workshop environment that helps you build, view, test, and showcase your design system's UI components.
-- [Builder.io](https://www.builder.io/m/developers): the first and only headless CMS with a visual editor that lets you drag and drop with your components, directly within your current site or app. Completely API-driven, for cleaner code and simpler workflows.
-- [Microsoft Power Pages](https://learn.microsoft.com/en-us/power-pages/introduction): a secure, enterprise-grade, low-code software as a service (SaaS) platform for creating, hosting, and administering modern external-facing business websites.
-- [Azure API Management developer portal](https://learn.microsoft.com/en-us/azure/api-management/api-management-howto-developer-portal): an automatically generated, fully customizable website with the documentation of your APIs.
-- [WISMOlabs](https://wismolabs.com/): Post Purchase Experience platform for eCommerce retailers enhancing customer satisfaction by using LiquidJS to provide customizable post-purchase experiences through programmable email, SMS, order tracking pages, and webhooks.
-- [Freshet](https://chromewebstore.google.com/detail/freshet/mpclplhdencffbilobpcapccnihpelcg): *JSON in, page out* — a Chrome extension that uses LiquidJS templates per URL pattern, so the JSON becomes a rendered, useful page.
+<!-- USED-BY-BEGIN -->
+<p align="center" style="line-height: 2.5;">
+  <a href="https://www.11ty.dev/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/35147177?v=4&s=100" height="80" style="vertical-align: middle;" alt="Eleventy" title="Eleventy"/></a>
+  <a href="https://www.opensense.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/opensense-inc/bf840ae/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="Opensense" title="Opensense"/></a>
+  <a href="https://www.microsoft.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/6154722?v=4&s=100" height="80" style="vertical-align: middle;" alt="Power Pages, Azure API Management developer portal" title="Power Pages, Azure API Management developer portal"/></a>
+  <a href="https://docs.github.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/9919?v=4&amp;s=100" height="80" style="vertical-align: middle;" alt="GitHub Docs" title="GitHub Docs"/></a>
+  <a href="https://github.com/elastic/kibana" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/6764390?v=4&s=100" height="80" style="vertical-align: middle;" alt="Kibana" title="Kibana"/></a>
+  <a href="https://www.shopify.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/8085?v=4&amp;s=100" height="80" style="vertical-align: middle;" alt="Shopify CLI, Checkout Blocks" title="Shopify CLI, Checkout Blocks"/></a>
+  <a href="https://customer.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/1152079?v=4&s=100" height="80" style="vertical-align: middle;" alt="Customer IO" title="Customer IO"/></a>
+  <br/>
+  <a href="https://syntax.fm/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/130389858?v=4&s=100" height="80" style="vertical-align: middle;" alt="Syntax Podcast" title="Syntax Podcast"/></a>
+  <a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=liquidjs" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/27130435?s=200&v=4" width="80" style="vertical-align: middle;" alt="TestMu AI" title="TestMu AI"/></a>
+  <a href="https://chudovo.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/Chudovo/avatar/256.png?height=100" width="160" style="vertical-align: middle;background: white;padding: 8px 16px;" alt="Chudovo" title="Chudovo"/></a>
+  <a href="https://www.pakstyle.pk/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/pakstyle/2b81605/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="PakStyle.pk" title="PakStyle.pk"/></a>
+  <a href="https://www.escorta.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/escortacom/avatar/256.png?height=100" height="45" style="vertical-align: middle;" alt="EscortA.com" title="EscortA.com"/></a>
+  <a href="https://opencollective.com/touchless" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/touchless/273bc74/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="Touchless" title="Touchless"/></a>
+  <br/>
+  <a href="https://www.dropkiq.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/1bertlol/43a8ea8/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="Dropkiq" title="Dropkiq"/></a>
+  <a href="https://directus.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/15967950?v=4&amp;s=100" height="80" style="vertical-align: middle;" alt="Directus" title="Directus"/></a>
+  <a href="https://www.builder.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F51a002f4a17f4fc4a829b8891a1c25ee" height="80" style="vertical-align: middle;" alt="Builder.io, Mitosis" title="Builder.io, Mitosis"/></a>
+  <a href="https://patternlab.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/4733935?v=4&amp;s=100" height="80" style="vertical-align: middle;" alt="Pattern Lab" title="Pattern Lab"/></a>
+  <a href="https://www.rockrms.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://www.rockrms.com/GetImage.ashx?id=72533" height="80" style="vertical-align: middle;" alt="Rock RMS" title="Rock RMS"/></a>
+  <a href="https://wismolabs.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://cdn-ldlap.nitrocdn.com/DsLJMZpUUekfsitqBnNmsRAnzbwPoIzE/assets/images/optimized/rev-5df8687/wismolabs.com/wp-content/uploads/2023/03/favicon-300x300.png" height="80" style="vertical-align: middle;" alt="WISMOlabs" title="WISMOlabs"/></a>
+  <a href="https://chromewebstore.google.com/detail/freshet/mpclplhdencffbilobpcapccnihpelcg" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://raw.githubusercontent.com/MattAltermatt/freshet/main/public/icon-128.png" height="80" style="vertical-align: middle;" alt="Freshet" title="Freshet"/></a>
+</p>
+<!-- USED-BY-END -->
 
-Feel free to create a PR or contact me to add your use case into this list!
+Products and projects running on LiquidJS. [Open a PR](https://github.com/harttle/liquidjs/edit/master/README.md) to add yours.
 
 ## Financial Support
 
@@ -78,7 +92,7 @@ If you personally love LiquidJS or it's benefiting your business, please conside
   <a href="https://www.opensense.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://images.opencollective.com/opensense-inc/bf840ae/logo/256.png?height=100" height="80" style="vertical-align: middle;" alt="Opensense Inc." title="Opensense"/></a>
   <a href="https://github.com/microsoft" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/6154722?v=4&s=100" height="80" style="vertical-align: middle;" alt="Microsoft" title="Microsoft"/></a>
   <a href="https://sentry.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/1396951?v=4&s=100" height="80" style="vertical-align: middle;" alt="Sentry" title="Sentry"/></a>
-  <a href="https://www.checkoutblocks.com/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/114603307?v=4&s=100" height="80" style="vertical-align: middle;" alt="Checkout Blocks" title="Checkout Blocks"/></a>
+  <a href="https://github.com/Checkout-Blocks" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/114603307?v=4&s=100" height="80" style="vertical-align: middle;" alt="Checkout Blocks" title="Checkout Blocks"/></a>
   <a href="https://customer.io/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/1152079?v=4&s=100" height="80" style="vertical-align: middle;" alt="Customer IO" title="Customer IO"/></a>
   <a href="https://syntax.fm/" style="display: inline-block; vertical-align: middle; margin: 8px;"><img src="https://avatars.githubusercontent.com/u/130389858?v=4&s=100" height="80" style="vertical-align: middle;" alt="Syntax Podcast" title="Syntax Podcast"/></a>
   <br/>
@@ -234,8 +248,10 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
 
 <!-- ALL-CONTRIBUTORS-LIST:END -->
 
-[shopify/liquid]: https://shopify.github.io/liquid/
-[plugins]: https://liquidjs.com/tutorials/plugins.html#Plugin-List
+## License
+
+[MIT](LICENSE) © [Jun Yang](https://github.com/harttle)
+
 [setup]: https://liquidjs.com/tutorials/setup.html
 [doc]: https://liquidjs.com
 [github]: https://github.com/harttle/liquidjs
diff --git a/bin/build-contributors.js b/bin/build-contributors.js
index d2c774c91..e3a303f76 100644
--- a/bin/build-contributors.js
+++ b/bin/build-contributors.js
@@ -33,7 +33,9 @@ function transformFinancial (html) {
 
 const allContributors = transformContributors(extractSection(readme, 'ALL-CONTRIBUTORS-LIST:START', 'ALL-CONTRIBUTORS-LIST:END'))
 const financialContributors = transformFinancial(extractSection(readme, 'FINANCIAL-CONTRIBUTORS-BEGIN', 'FINANCIAL-CONTRIBUTORS-END'))
+const usedBy = transformFinancial(extractSection(readme, 'USED-BY-BEGIN', 'USED-BY-END'))
 
 const outDir = path.join(root, 'docs/themes/navy/layout/partial')
 fs.writeFileSync(path.join(outDir, 'all-contributors.swig'), allContributors)
 fs.writeFileSync(path.join(outDir, 'financial-contributors.swig'), financialContributors)
+fs.writeFileSync(path.join(outDir, 'used-by.swig'), usedBy)
diff --git a/docs/_config.yml b/docs/_config.yml
index b2055096c..0b320468e 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -1,6 +1,6 @@
 title: LiquidJS
-subtitle: "A simple, expressive, and safe template engine for JavaScript."
-description: "LiquidJS is a simple, expressive, and safe template engine for JavaScript, compatible with Shopify and GitHub Pages."
+subtitle: "A simple, expressive, extensible Liquid template engine for JavaScript"
+description: "A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support."
 author: Harttle
 language: en
 timezone: UTC
diff --git a/docs/source/index.pug b/docs/source/index.pug
index 64048edf7..3856e4585 100644
--- a/docs/source/index.pug
+++ b/docs/source/index.pug
@@ -1,6 +1,4 @@
 layout: index
-description: LiquidJS is a simple, expressive and safe Shopify / GitHub Pages compatible template engine in pure JavaScript.
-subtitle: A simple, expressive and safe template engine.
 ---
 ul#intro-feature-list
   li.intro-feature-wrap
diff --git a/docs/source/llms.txt b/docs/source/llms.txt
index 621cdf4d1..b85f97b28 100644
--- a/docs/source/llms.txt
+++ b/docs/source/llms.txt
@@ -1,6 +1,6 @@
 # LiquidJS
 
-> A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.
+> A simple, expressive, extensible Liquid template engine for JavaScript
 
 ## Tutorials
 
diff --git a/docs/source/manifest.json b/docs/source/manifest.json
index 7bc095124..db01ebfd0 100644
--- a/docs/source/manifest.json
+++ b/docs/source/manifest.json
@@ -1,7 +1,7 @@
 {
   "short_name": "LiquidJS",
   "name": "LiquidJS",
-  "description": "A simple, expressive and safe Shopify / GitHub Pages compatible template engine in pure JavaScript.",
+  "description": "A simple, expressive, extensible Liquid template engine for JavaScript",
   "icons": [
     {
       "src": "/icon/apple-touch-icon-57x57.png",
diff --git a/docs/source/playground-demo.gif b/docs/source/playground-demo.gif
new file mode 100644
index 0000000000000000000000000000000000000000..3562cfa23b6994fd595e76405dcb4ff02eeefe47
GIT binary patch
literal 38455
zcmeF2RaYEbtcGzY-WF(!ySux)6&s+qyOrYZ4#lCkJA=E+;O;JiyW1dhzVkcIxywqf
zvR0n#oxCeDa?-qf#%0K&a8FQ}&!%)lww#o7ER=Lylyp{<bm5frVwCjil=L2yELN1P
zx|E#Glw8V`a^94t)s(@LRHkP%3|ur4N%V9q^nw6-)gnffXhy?Y7MpW6|6z9ROb+WN
zPNjcbEUa8&zFgAbT$Y90Vw&9IhCE`bJYw!VVre`wzj<t0dE({;q%{QTSOmqCh2%|y
zeuWDKs7iab$pGBtxY*=m<mG=#%l`z(hi)op*(v=lQ%YG-jvQ05i&14@Q5RFyDB9AN
zQTgRvscRmmpFU_1Yh_5sVpwr#%)w$RDr2goVg6IxGOW&;p2bF6)~061E`Qmf_S8{K
z^|x!Gv!>3U(iwMp7Edk~Pjd%PYk+6-m6r;Emy@)2S%j}LjGq#R-{6Hm9gDxMwtqyk
z{}?1dD=nn|DO3~?ncW#>h#zC97E>}AYoi(`rWz;B85frvH~AjVMV;8Zm?ZEsNs}un
zb})q(CWZG;iV#nV+Mg7wq7;Xsl<B)PHI+1HgN&e<EML2<rn78A=Ik)X?ADW90hnAn
z+1#$(d=2XST5zGRY_S)xWbLKYl%;fPw{#y;mYz^)%3kTrSvh)B6=YS-2UBg$QthT(
z-7-{TrPgrt(d_c8CE1}B{Mr`$tKFBc!vVeH<h66@tS8UEXJiQ!X)_cqJ6xPN`~(>Z
zW*HCrHeOdWQ5HG@Oqm>=nogCRzJ$#5HqI<>&93gwg0JS{ROga(=T>(X)^``6(8U6S
z#rEvw&Aqkzw{=kI`sC31?%_tA=f>{Q_TKSsXXx(1>F(nTxE283TmnBs_A0ISC;uHB
zpB+tAojkpq*1DdaUtV0@UOvBG-P~Q>K3%=PUv~#wuQ%P?-rd|i+>S=y-ap>nKixe%
z-B0-6-yYpRKHopS+&{fMJiR=Qg+DIkJ?>XOo;5!{Jw85z9-k*4pAR3OFCL#EPe;Q~
zH*-(VJI|oF=jZ2_mlw#x3Iqaqy<K>HeSM!ve}8}fc)$4g_<$ZZL!nbp=sXm<0)<{d
zp->no3>g$nSxQ4)LQF-9otYIL76t}}>;(Z4<-ZW)e>TkjViNxUko-R+|Cb>_fx^6h
zB9wI^6}Id5I;eQ4$R7yDrjXB)tt$XUf9J5-7^y29{!1zmMJQKaG@3-KUZFQyUp$`1
zYC4uB*HAL5)8<7rA6An$ohurQ%H+YiE1oHvM6W;ASUz8>QYfD--&C<!sZ9i482wYG
z<#U_JHX+|!wc21cU!gzVT)p06V@s8^JYTulfzTHfI^I&V-4g(hMy%NCq}%3lgI|<3
zVGPW^I$i`Qw$&eur*qhDO|&%}P3K8O6Dzehp3Il2R~k&VH=QllhJy>Aly&R%Fq7mA
zggSl?46l*@j8p1tz1bT{VlbTQY`Z&}DOAY)_~Ul5-sZjyT4rn!Jlz?HhLZg3?tHmB
zp06~#;;)jh98mc4G}Ybx{`!1(wmsd`<G**wg|Myl3^T97a{X4i6NJuvyc3KqO-p8V
zdOxSa{yd1R6Nc0sv=c%aMhlLhOtk_>mH<4A!^9@T))}VqX!l|`m#p?;c?*`a!`DI&
z3j+9%==S3!@vQd~L@!np{(9~P6EJO((j6pgXj&hnoEb|*hch}H?=z^F&>g0mrCJ~U
z%eEdh_xXVef9P&CM0b?svSdvusEaypZfW0beUux3M1P$3zWWlDGcfripB%z{dR!PU
z?WM<q!BuE%5yeh_Qj+C%dQ$493W+L4>YB&q%qyult*AmhRg}2agWCKMF6j=kscb#0
zI0H&|L*%PIoSsoxJMnDK>qdf}$7{V!s2S@<r5P?77YbS!S$}}xF{>8c&MsPZ@U$3s
z>*-6FT6Rk+FWb*8xS53?Tj>-#?w4$@x*VuYf3~^xF<f=QATwS!zO0#IN$j9kUH79`
zw%aqkns{9^eB!aY0ewe?)C#S1swoVShBLDNLpL6{(jxK~yd7g~Av7C}rP{ll;9O=j
znfN?y^K*jx>HKc`4P<8=Bl^w$es-@5qA-=xC%`$UBE#hBEWZ~vxu9)X{a{UW)L+zg
zuif>qVwUFnYZ;x&>T%7kMJT@9Aa{dY$hyP+X;WulGk(M433|aZ{um&KHSf`<FumnZ
z1ALwcbbJ{D$IB2qO9bC3B@2a%FuxpTVZEsw<%MrCAA~rDdrB0P0=-&tYc3&YphO2x
zgHl_}*NfKDHLuIgC(QD5rRB@l>p|pp@0$@CL+b0~A93xsGctw;H*;E!zHt+o3~vt`
z?jjTqTj4BzA*<iI-=B|5dq|&8Tdst?4>EIJUhkK4iC-U&YI^?MJb8b7z@QsBUt3cB
ziU~kS!_I@#U+SrOa}30e*|A1B{-=$dkMzA)6e9~8&D$#M2L(z#ip=-^ud)<;NRoL7
zS{`*sV~2qSbkfws#z-83<X=J8d6tmfD4}Q45XKo;GN{FHKY4R(P-em~E@`hMI%`6t
zmh6PNsBAxd26ia2BB}Y37%JOJP=qwPX{jD9&e5te=QRunZ)s$RD+o?GQ*7v~rf5HI
zRUTq4424+hv6PTz*k41OLelck!HGfg;Gc?=Uv06`L?9AB>>?-$9<hTyH;N|OiAtQ9
zB#ASDLrH8<#6H3Cji}W}#V`fsTSgg&ako381=EI6Aorv5$B`m%8^M!U87X|;@B5pF
zLq#X|bwYJ&E_uX7gN$ttS&IKFoYqXf#p!2p9BjmBdW{L;1=b){>buMwaVnJwS$wYU
zxs<$P8H>}tVC;`P-0RyN{;Bw&&*{BMYx^ZUN)6CShc&n?7@=Yb>B2}$VGg{k{6mzg
zlPqPmlH6DHGRaR=Q>SH#93b8!zUaUoe#c}Xe7weD5aUQ}i(Yo@cN&q0^0~-%4YhGQ
z{Lkp8iZnB(9H{12V##&kI8~wuD%X-?{6DZ%8^0pOAIqt(j|NdkXpm~yNr*Uo4%Iys
z{W|dbShV#!B7cb}a_)?=aE=Pd4q{pX$fH2(&5JhezOSaKDEm2bQmANkpYqSCNZ|N6
zP)#o?o8me^<vn3OKdctx<GbyzuPZ;l0t>MeUFpS86|mvsVCtf%@_+4){Sp8*dUEBJ
zliSA6*u=SfB`YgJk(xoYE}6lVk+nyW*a`839*Z@TY4_pg<M#_1^`|ztikmm^#(Qa~
zHI)}vi?R#!+fD6ZKM>}B`a(82rNblZ+_mv0c^A>qe*1Y55M%zEw9=c9Jj4_m#T?n>
z*F++qA?D!lQ~WNx?x7}pJ1x*U+<SGfyQS^96Bv-jqcY2@+W2!&)cTuzyx#<QlSl+2
zkCT{Y13oJPCyW@C$8Q5~ojwFdZ7J$wTDa3&Hv|B-*bmL!D2|Ys{y~5viXV2AIj01U
z3r>~DWnGkh{33j`Hi$m;x28f7H%kAGG`-(QU^C|PDCZdSMRNz)Rr?&eALWVhxcM*g
zGWVWyq4PNJw>?s<Rg(9RzRv+Fk$?a&G@M~XY;cJo{xNQKIFO4YA%EhC!8esXLXs5$
zCq|w1Ybr8XZy+aVR+%uw6X9FDbeN!y+*ei;!{>M@DsR#8Z-)F5@4YuDg!)I{UrmW(
zaZrRIb)Wc4cqHhuCpaBW5PpSUqdHtP052%agY{fEsvB?dC!K!$jpCynUSY|8H@4Jn
zaAAKZ6q9Wz*2a2HsSUGePS3uW*1LkNlR+9xSZS?L;+tpCEgVr?1mpc2MCaCsVSxZ4
zG=2-wj7t~}Tsa|ZP<IE7PN<eo8LeJmkqhY)EgiB>6c(tUcYP<0*VC)|)X+BUOTPgH
zRlj$d6@^>Ya2cgUn!ROkLo(?*)U2hQW&LX+3Be>yTI)oe?#>Kn!-n6Ehxt<F0ezHH
zE)otb1+|1z(0(v7!;G~?_#Y>G$H#>-BMIC%?9HHojogdFl4*tKg@4}qA~;y7plowx
z<6!b}DsxX2MqQ`0r{#U^X$Z=PQhb4_z~<kN=S2$0L-%mgVQ$|r8DeapXTEOf>=yrw
z(gjurOInq@Ki|eT$0gSd%_fRQule^5SK#aW-NPpVeTk&mn4~fGJq%P4%!IYS9r{<9
zJ?)>uO`n#>v#;`|yFv!5(=(%&u(EeO<zne@s&iIOv;MxVBNt#fFn2CY9h5|g1Y&se
z`rS?D3Us<o`#yISIQJDgL#@=v>;PqdG#iM;l2|~;pYI>WJy;%YO}AHouN3<f--D6u
zMP5?fpwKgTk33_nd?|IVyg#XR2G6Xh<>n@~!ya*IKH1!GBkood@vyG>fD;}^xIq7m
zZ+|{&z0SC`VYGw3KKW+ui-LIqf_L<Tov<3rFm+0;g!{0phaDe`9Fxd`?vR7LkNn>Q
zK2eamFqH<w_XXD;1yi?%JokA=<zp(`D{AFoVwVP-$heCd`^0_|A31XRIs#kGimihO
zcY^4vBPnIxYD#3`N?zvtq2gF*;jhRWK1t?f8cuhj;&z;jnaPIHd=LN91h7<*JEOtg
z7u6&Y4Y~}l8ea~hgnGE*@cxKKu_kwoxGar`DRYmL4bM9Eo#w#5HWB+?Bt}Rng;t_Y
zR)*}d0GC2)+!=ssfMbz~8))ERLT3b*a*Ya{0VJmfvZeY_)}n0GqFIu{xtO_%9V=G`
zpl0k~or@w-)WYGXqHolq7QrAouSBl3;=8p5v2jXpxk!MVu(EcIhH>FovE^h)#i;`T
zCh2Zf#}<O3@GNOD6xZ<MD>3iMa2(C3ovbD;$zej@{^qg%eV`3_O8>jw8o#?6GD)G-
z5EzhNXO}7?o`R#QBO4vh6X<xYIx8!KcO9W)Zbyy-M+$>FY=!MdD^4GR1y(V13DN5S
z#dGqB(U!>+LS^u8%vc3aemrBNi{QkH{}9K&jyPRZriz58`o_rcVsgXf-W{(u404p=
z6OU|8ex6B=(Mr-QC&Vl#91p{K%0umpP%w|TvCwwcvvMKuG_l9VN+5+lUP0jD(qoFm
zQs9D9D#rZG3(&`f6U7dL3&hOpji!Tvx0*ryvYHYT`D61rvMhm#z!|Gd1(6+FoI4)D
z69H#oMx6l$-q8q4!BbPC2`=DA*h4rv-~n){jh%g>o=2CFc$8N1BR$qLbLb{zpUf%e
zGoZ172$zOnv5y)%JTvws-BN>i@FWRQ)n9*(F-<jVh%Y-WKl3X%bKzh1L0}f2n*Z8M
z_Mvh17iduS&aa%=zHDA__F-Gj99hn1@tpG?xg&u&JOw$op1JUp0eo<|&#SrBV!7NV
zxgUIaz}+0|{#=BNydu~<F7iB7NM5mV9yWizW`7=zSAGC_{`dBLNt1j+NWNu3J}G~J
zs$0@7@;}Oq0&VgF`n3Xba6U7BAyGvxyG|h|vLDt-EO&b$cYlE(r0^BCP?W!j0$eER
zRdh;LB->tuX;P#JDZ;QW;EO6y(J4j+7ine`yV4e~6&C71iaVtXjrdFC#)=R3ip?@g
z*6B)Y)=E^P3iaiS9r#NZ0*hU|N(=IfJlad|MoWAkrJ(%M0RA%QNoj~zSp`{HM0*(;
z)TS&3QkI`z7SCUvX<VAjU!Leyo+1AuwY@w#qdW({LVUKofWItHr=pA>JFKpvYOMkY
zsi?)Ttmm)vfi1O^uWZezY;UjZT&wJcRQBRm_48K^>QoJRRgFOKn(0MG*Q%x<RWtb2
zbNtn8`It*y)hij*Ywgt=Yt>tj>K%L_m>;;W13dHs9%leg+kxk6z)J}58o%b2zvf=2
z=FzL>Iim*BUh}qA^8u+jjLL!$s727NMe?pi$*e`~s6}6|#eA*BCaC)&P<I5u#__KE
zo>_<AQAfC5NBmkxN>EQOP`^rFOX*!tn^{laQO~$u&-_}?idK(D(7>tNzzy|o;LU8{
z?`ROTt)*UX5G8077ig5!ZIt$IL=$L`?Pye7Z&ZG5R3T_$eQi+FZPN5^(#~ws>1aBs
zXw-XcG9qX;5ok6OXtEfqs!?gS>1eiFZ+3WXemiY)5@>PJZE^E%F;{5v=xFg-Z}EF=
z;bUkC5NHk2Z4L8o#jI?J=xB{uZ;g9xJ*IDs7ide?ZA(RKjq+~G=xEDYZ!=_Q%OPkl
z5NI!2Z}_L%UY6Nj(b3L+hF$gAUQ5tXKVDlZ(9!JO(VE$zf7af<-qHQq(d%8^M9?{?
z+c~t}mgn6$*3mf;-8!(|IYZDjht@JG(6!{<wbIcvo!Paq-nFIMxCnji0t<BSD>SU@
zb{}VUpPtq2c6499c3-d89uf51>-Icm)?9e^KstKfDuH+FJurm5a52>{0=-B+y-%+_
zD4o6NG2Mt8z1W0(8<o9Z^!o5RJF$HF@H_i@6#59?`bg0`eh~Ik>h%|$^-*W_)9bZS
zboMj9^+!kdvkDGyPP8!T4e(|SEO<A6B=PaT4Tx^E@DL74>J4f!3`l1U%6B$ObPg)N
z4T?q&stAHK?7BO3LE2d$)rkT66>Ob1kdaS=65)`U-q2SDkVV#zO;)XG=a9qO&_~pe
zli;w6VvW7tut(PL8U3)=#;_kD(EV*VNN@yU0>rXE5Rx?#1tqN2>KuuC8(AM4ju#xY
zAsk8e88u@ZP4682WjDHyikU|^Rv<W5q&HULGgg*0R?#_DwJ`>K8>=N8uNNF|)EjU1
z8E?%RZ|@xM+!*hE8}B8Y=og$A)SDRcnW!Ti4%3rv+N&9Po0uV-oD-Z}(3@QHnOw=5
zT<e_N*qGd!7#}+ay`W;Q&7h<1@-Addopw&0Z%kbher{Aj>zYAdgTaJUjBd+M9cG~&
zzfFC-O~Vk)z`a-82u?rvOvftL?4MJ^Z_Z%8&tMbHT9Kh6`_?>9RHHG?;&;swZq5={
zf5EYz#><|$Ma7)j;pN{&U+W!Z?CM_IK_4|DGXkTNL-lLERaaBT&W+~HF>THtyw0(0
zVmFG;Q!q`TUJx|FU<h|DoS|WuCZKZ()$qht?*uH!|2JeRbu0UlsWR2%#LNr8p>M}8
znhAAp&5%vbEMD_3E}>!?3oV%wEpK=)r4%e(K^8TLFfho_oi~>^*U1)*mM_MZcJh|P
z!OIc8T>(rh=TXb{7?|T~XffF<$x5Buz1Tf4V`^O!<sl<CsACC2t0_WjUEZrT@v8+y
zZIqk9of)<oY>XnJ^<gv&j0B8w{kkk6<w?CcAjW$A`+Bd!dX3R~rv1VdD(2?Q_coY~
ziT94y1oTa(^#iZ@k?M^}-_5qyjoFLE$}ZptG?u_8b`#9h;gE>7PE@n7iLoQJb^hLd
z;JanJxp^u-r3*&C@ZBzdrLR?)z3HkFvfH?n-)0TkMi6d?Om4d~ZJ)?bVa#G6e(Ypd
zVqgUBT*_~L>88cb*-i7_#SvaX^#hLh?&1rB8Q)OXV775{*6|KjVYe{ImBFl+tzYB7
z#F#th_+W10J$~U<4(820uUX!lW&z>-koCRe_ua#&4WQD#;ztWcAO`2w3cavahwsK_
z?Y>gZfye8<YWJ|L0Z=|?Pe=IBZu~%)87S&^V4{3zC){k|w{IH<G-lqnH#qWqMOE=T
z3=lk6!#yGe9=bRj1z|Qj5^wwE><2)FkE1@?Jhl!##*ft9j*W7TqYX~9b&o$WpX4f@
zq;8$4MxW4KZtD{sS52Pe_?;@EopLFk@;IE9eVp#BAA4Z}t>X@A{mvvRPt|}Yd;CYO
zA7^5fX9mot;S*=z)3e^3bAE>NzYgcSQRidC7hL1#9SY|Y6X0Tpv$^gIW`&E2i}M}S
ziw)sR`m>8x`-^Oh%a`-h{jE!K+sl}$%PsoLOM@#Cw5xfHlkTvKYT(7=#}z^J)qd3S
zJ?1si&pJ5h9>n1H+vVoD-!(S0_S4@(!|sz0;+yY3JL>)RkAdqLBHLKGH{@3h1dhj5
zm)GA!Zs|p8zxEsv^?+};su7_*x18HGOh3<Xx6jB7?*v8WJg08xw9jd<Zt1q~q#cK;
za!(|Bb_D$Im2<%&+uLIP7i@oLm7w?9Jsqkw_qo0gzn~BBx%c_P4=3IC&X*5HxsTgk
zcec5A!*P%MUYG`?FfKoz5LHlZa&PRes+$ZRJfRQX+tmnIPkZ!Fu8vP0&?jt?=Z&=|
zi<;+nmQItNQ+>nx6PxF7|EC1U>ll(zG!{3K>HE~4mxS$?HU8&9e_*=dQ^rroqXUHM
z^~FNt#qSCti1iw(_qxh|ciIk#aD07;drgGiY7j##b0NLCkNu9-Wi_uWr>}4`kWrD#
z@fyrHk$0fs`y}-F5Q_Rf_xF7c_+D>#z!dkk1HA`dy)BQurincL%Y8l~xd8us^PPH6
za`?D$ygzY-;?;b><STFTvB06@Gpfk%h=*Yi35R@F1xrTZG8qh}tL{n15efMr{7~DM
zO{7xFk^HB2AfL*l-yQODyU1X-*_)CjH%%<;FXa1yaQZb@$csZE=qzl~O0h&KTR0RS
zaH>%Os5Ss)0M0al=$1>Ja?Xcy39>2O^m5mv;-UJR-Jt|pmwN547h9mrG_Y1Cui?r5
z4~^^Te5u()P6f>?lc885kubtvw`OB1FJVM{k4~#aQ4$sUnYFi8bHz%z(%Cw$d*gnv
zSYa16wU+UbP@bBhY~3e^tu9~aBia(n#oy+6JoHVxXXnGoY>{x{Y*X7hfA=9`!B;og
zy}2%bWD<k7=c@&dzd~!C0<ts6Qc2+?h95qV2eFKA|L*u7^Va5bn^;6)ktu6M;hFkb
zC?`KCrV1Zd_*un2(G=D8w|?oIZts1jh$%x7IGqyzEJIl*`IV)pyyjGRpH?z~7-y&J
zt7TE0Gy&7#HN`vkek~0YTm4F!ES$1_g#6FFl^7{3<tOPMu_5g8bfuISqj7HMbrJ*L
z_5RAU^dN93ZdPSsc2WJ>7?C>|G;2`e+187kh^?KNlfmk^ACcmH+Hd$NQkbYtLB(hK
zpZE!t<b<k9t)p{N@SnXUsBnHOZd6miwZ|zGlbTBs+TYN<Q&W|pYU)*F@!}kp<-@4g
z&@v3g9aI0zsjem{z|X0v?|!h@@{2*fX&BIE+oWasSIVv1@TnqYQQYtir{Ao!xOuHT
zHJer&GrYQ5+qMUhM{mA1#Y){I_nmR=y992FzWcUN<VHl}!QXXoXDE-M?-NMgAY$SI
zPygq#PMTpbmh?&`4%_(80sf1P+X>yTC9NjWMEV}BkvymOg?cPVd}gNaz7YoJ=aXLz
z6SOQ=O%jRVo(%$pG@nLO9fy9*rV+67aVLvu@LA@EH@jJe(oB|_BHLP|S(WCda_yZO
zct1mr@PfnmZL6iYyz<l4b3Cns?6=zO8h$531S`n8lExdh!#bvch!Fha+TZ5<4qZ>p
zjt;I~VUsp-b%z~J1J?H)mz7t-oxg|a6gPG&)>EH<kF$geUW6qK$y!f{AQN?uENiAX
z>q^K7x!#f=y^&7?!i65Uq__WGMEpz>a^Lhc^)-z(*cS5Gr6|mnF;;SKe%MX3^aE~f
zItY86+|Yj*uf~gLy_~chZLv?{+HretchK~_rB~#>J?;<l^!PsQy$efR(7}E9zFtkM
zw3gel==<K>ARECDl=R$9IFdhnHG;z(X?Q-7b#CU!lf-TnMMb^#OsO<N;(BgDqCSBJ
zzDFBLQn!kINxTYbWiUp)2^U7GpLPvVH%4!9?|&Gb2|F|;L(#WN_`Ed}URSsa_2V5p
zJh=AwK+{HvY#kgxWQ!CqGr=LS9JDvSic}jUKhL7&pt6{a)+sdUsv41^^_z{+T_;~@
z_mJiWGse&m6ylGsNb?^u#=7a65<MK(V;Y<U%S=#6c(uxiN1ew-qnVN6{;T1EFvfXg
z?U7TB)<|H+{Z1OB1mXW^l_6(O{D)xPO8+A8J!~#H=G^q3Eb_=takKc+5UM8We~oHG
zbE#4a2U#E5Qk01|sXac+i~?E;MtDhDnG?!1O#fs}x$l1V`|MI>^G&Lesj~(_DT+DE
z+msZ<lEUTkK@9DEO3v*S1T}exumsKW2JGrYHH?;moBNYd>BV?8PGN!%a&(rR<ljya
zNCZGD3VfIIdFf-tdHu^w_HSU^QC=&_m;dJDH*o@bH3F#iC!t6;mz+<abb*8djHr+P
zLK=)DiKO4EVTc-q7j_2{JCSM`sS!C33(_Kn#<3ZXjj~JWpEw(5)za{>N(djU)k0m=
zA=dB&ZP%r0#rzayk8lJMT%UFl<y2&q7b`hTPGOVaV*jD+Ra$1pvs!@B1Mn8TR*H(b
zXZe>QA%LJwCweJE*ciu|#hUvYBvy;Lm`W4QLTREh*~k~Ip{QY?J17jwb*~fc!@X3$
z^?OK&#3r`6oy#{W<;+~_ENeIln^3t)nxp?EN(ZL!$J%#$JJ+OG3mEu{V>=|vaCwdC
zX6*8ML}nLx2Juemr5{~0iq0t=dWYQ0ZPTF+F2w@+r<%*{%OD50rVjl}x8;s)L`M&h
zfWd9*a_5nhqt{}G!DF*~XO~l$14f6)V1Gho4!VP1D4LoQQ!+<cwKPY_e??Ta)P*eV
z6olJpgv7JbhZW`&LM3R7s<qO;Q7pyeMHXYBA<^Bbf28o0Ks|gyqlX4K;dFJnFrrzA
zKNIjf#$3=8e|cqyXXtmFYo{sk)5@?2l5>2hpc(nM)e#wK=fo6frx`WR>gdlf=j38R
zb9$}SF)hscXg*zS?C{p^xXvqfxfm1nhOnNpTNV@PsMrymfl0@(KUoKYmi)`BQ|?25
zavnM@g`ZZZ{gGVq5QVJ7zpc%LOS=@{c3DaDtj+!nb19+{vX<AvpRu#BPV0KpG`E<~
zHb>&p*YFW7+5r%hTKuU1blGUOtS#1rxmKAA+3GB>Ewv1}0$sao4W8DPdyw2}Lxt>2
zzOAneOS{#lblF+(tglWtKa~I6#K^Srn$IO_ApJ&Q;~-+Oa1SrjS}x?^oVLDkB<<e5
z*yZ5Xvc7p0=H7WA<mk1$zV$TZ-u=+!==Zd~4Mp<kMHF^|27TMuL6-68KOwqw>X58l
zK6lX**|d*xJXi;sdJJ)O|BiFt*dsyq9FY=sPE6a_r;+g-19Us5wrm`*gnLey3;)Sj
z-Z<nL_MCF<{*&{xaYS!9Ht_oO#yG4QEYmU$O6YcZK_Q}bVuB3*6Lu}7%|6w7ikojj
z&?z_FJp0YhQQiLGT0iZOM)6_4y0}$S3(qiV8~*Ci$c$4U^XL5cu)q-iSzpJ|=2hZ9
zfx*_Ci=J-=S9d8SyBIwly}6s+!InPzeckRNkNUT1G6|w2HP7x21b4ZXcn9NVo-=7V
z7a7PL`$|1tp-~2DMV7wjxnG{oLRaUr(z>=OzD;dBLATZ$MTKbWS$=Q45?>|+S2V@;
zyaAs%o^=62cd>upv}g?>%QdLH2D8ye5<btWEW(d<#C&~m>TgHOQQVJf@A>}Qm%B0|
z^As|wR)gCgfD=ph73h7t|NQaOaK{KNeG*(RoC|7MKa$sT{lcE$R}Rq{f^6^lZselg
zH6tc3716WuuH#D4Ap)W%n=nkAz9g$KE$p!OJ&~t7krjfz6?~$H;2u2A-hanPI2-Lq
z_kur)+Gq2Tn}TSG5X58i%DzsBVuZ9mp^0zW3RsXuxucZY$@bG`p%mwZy4Us*C<@TM
zwU3aYdd-x7S`h!dAnemG`dNS;9d)2SI;%e(8QL@!%Bd((CXeLVD$Xb=!5h*`HIb^-
zi|o@Y>Jd<(2O}ZaDB@H`@6p>Uydc^)&<CZEWRK2TD-3sTWwP@a#G45FHxlYhJAf$J
zA<!xLGC$z#i5QW9?15bsjtW9uU@!_m=I4|k8tVrXwaO-AaEBmw_0#Bd_I$~TH1m+^
zy&n82NoF9(uiGhAz$;}d3jFtsXmwmE#yQmA5$PC!6rK@jP!?vi5ot_0gr6~FN(l0#
zlgg(>_u`eZY^_E!9d>gWb`Kf$NFMeq8un@&_8uI*7(=u~kv7&F#M$q4+UGXAPxzA@
zu6~YWSzE2gTI=I75*{)VkvtMvG!oS~0*$Vc(HRNVgF&*S4c97?@PCsLV3ZC-=L#z7
zV3w5eFdB7t8chosO-~;ES2UW@IGQ;)nzb;Ry+4|BKbng$mWMNzPdQe=IaVk+R-`dj
zY&KTnGFBQgR+c<gUNlzG_@8IgZy{2fv;U*Al#p|DTwLx?BXWx5aIoZfqsDlX*?6<d
zcuUB5Yw~zo(Rh2~c*o#)=fZf`{&@HOcn`uvFU~|C<wQT{#DL_)pvDBqY+}e|Vwh7A
zopHc{Q0@wCq&8&m_gk9tM4T|A!YIPz49?^%<>Vaa<h<nMg2v>c+2oST<Z{U5O7i4t
z(d1g=<oe*`#=_)(FWT1q<Tk<-bO&c@mvRcssl3ZLE_^Sotln4SA~|7JRd<ecz&L)|
zICVBSb-pllu|IWrKXrvLeT_4HLpgoRIejNNeXlY7U^e~eGW`@X{hU1gQZx-|oPHgg
zep{G+-~S2Gm>S#Y{1q~_lc=1lIt4E^g8-O8G@n6ook0$rK}nhUR6K*)G=m13L0_D~
zIGDkFn88Av#m1feOf~z3Yxb+uEDm56*L)U_N)=|4R)tXIonGa8(<}jKmT+;F=wO!k
zVU`4Ojudx}jB1XYYmP!{juJ3OWj;skI``Ny@q<cblJUos&m042j&X60>0pleVU7iH
zo)veVjcT6Vb&f)>?|bqbG_FFG!*!k~be=b5p09YGziD0oG%vWR%IT_%r>E{|qb`KI
zAV#$y&b1&RwIB&tkdjgpE+(mcn{PnXkS<=3Z(2|QEhsK7C><<}xoFgRP02n~$XzU`
zaV@G#EouN30p<YWca4!-b=3oEHTy-KrbS)QqTb@7zU#ae6;LGwP+R~opjtBFS~8Vd
zG6QI~+fK<KE*U+P8|yDw7cbc~E!l#Wcpm^-K^j&{^wyJ0PPogzsg|9&mi;$0|D9?&
zUeGxSExU&<d!#ITZZ5ho)w!B$WjJej9W47jEc+vB3pFi=IraJomHT3>gaB4T%~!&N
z<^mU+ExEM+ifco|n^vMhD=~}OwDyDA*(-(>E3vq%2~?|zOj;585kc=O5vaeCTvyXV
zSJRsS$+##f`oDs0e*Ifq%|2Mo5z@%G5RB~ll~t^kUZ<8TwN?aJE5_BXanbxsw5ATH
z^{sfVqG_!Xv{tpaR(-Grd|0bNT(8AlucOjM#8t~{S}lvEQ3D~{eXrG<VT?&$Z!2DJ
zZ(8pFt#>Z2!&ipt9fzjqOi4-V`T%r&ZPb0@!_6YryUaI+TsMY8H%3x6Mzd>m(g%7U
zn0_$n88hi1jbVDtfb_KK7zXu9xHjjd^wS;&+)2w_7kcL2rODPdR4?>G+o%nFXgy^&
zHxD+q0Bg`eA~eeYeI%Tj)y3tthm69D0gZD+kL%5&(5++FU#?a|W-5~3iS+Whw(QAe
zMLL-*<F~GHw{Kjv4fnfu4_3gN22oN5?Yk4gA@n-ONVmn?kS0S<P?*zc=o!)IdFa{$
zfKvBdqNxCJvuhh(dItfh>48FHykpqss-yC52t!Q?`v`gg?4U30U`#Fk@d~vNHMEFT
zL$xqmR;OL{2+srW;9BhBF$1!L!m+n{;{fVkkcznmk^A6~z8&roKkiDp(i(Xf*{K^6
zY?X2mN*ulKQdxkh<K}UI-Pn)Y_}pMQuz1rKB$_2K(;=AoK@3P~Fj)-_28(|>2Xjd8
zK{>hAE-DdO@wz_~?@>4yVyZ>ysO$+0?FkOediNvUXM=f#SNJ|a;d6W9-1`!TSW)sw
zJk5&uNc&%;1(C&>uch|oo6RIHOAU?o?{W8J40OdFX);>(RjJK6HKX)s#mO(teo~i?
zw9!y8A84nVlPDW&5O0ZCn6o1t{EOfH^>|=-sP8RW%0GCZmumVIv%C=T(A>h}wz$iL
z+d_2H+}z>NrrBc4_YfrvKp$tpeVT2HbmSzxY3HE%>G05jyU-Eu$koC!hsu&y`p81<
z$gSkai+a`FZQp~r)U)}>@9`)MbVR;%qzgXs=ROWTTn;ce2t-=7mOc&-v+@8OLle!c
zJl&2XhK^%~mLidcqjE}umX71`tW6HARv)aQr4K(cK9SlZ8T2A*kRodBAYxC=x{`*{
zY6pJ)4oeUaBvl)pfOML-HJjL7kmN=kKcwotgQ#Y7T4G^iaBQ9%5iW}o__@p`d+Fp$
zEh0%5vcXC)L&Ry{4iW$x{wMZn!;opgBUPdFiR__(O|z<1fOTn!t;SB6fdR5m?<r0I
zEcZ?@6$)(iqpHP>HO<bfUu_63YoLPY*^snp6EkfyH+50-Y;noi_+jW+7IGIc>{n6*
z>)Iqw(U9s()qY~wfi2ZRV%RT6cEfJ=OkwB1#B-AZI~e=0@gaM)03?yrP-sPSfabGx
zKaASEv^^2Pe#!4*-vYccRI`dyvIbNfpRz9vJC&M1ra*!HEE}>j6z8Xcm_;0j0~0ij
zg!)VSLO~Q+^*RvSD3IC%DVNo;YRCrXInq_-3L6EMR6C@1CtRZJ6#R(nK63Jv7nv*G
zvC0AdK=T^U!h!A2<x#g45h(Pe#8zwPGTb<<LKt@D5bL)`5IjjBE)1;x^QSxNK&=`0
zx1m#vqsV7rC&*=_(GKkAR-0@;Sj?VF?B@Wr<4=Aw@Sw*KUsfmVpVx>y&KM5Y>)zL4
z%GR8^Cqw{5RCgNy_J-=SBj#v07FHk$N+>`jlw#%tBiymFBoMDG1PT}l$-)d|JB~Eb
zMpT_Sq0|lq1cc_4ArpTO#M4Hw%R_=<!Y&Mj|0=T~-}z*r9Vqe??za;P;0^wa9mtdZ
zN5A!&qVyi3<P6qz4vM=bjCH27w4q-XT_g@9{~PPqi%{tXCp8#8*=)mo75TgrpotP=
zI%EC)>J#|m6A1|{<_zM8@^4Ji3y+yItm_as5?H*nSnt}9yKa!YyW4A*%k{X6ZqQ|d
z3*t{p8!c@~RT|fok=xI$FxESt-OC=>NMN<nVtsZ3ak1}oS<Z9I!n2TU^W#HtMK5!l
zkOhYWf2o`+ti<m*Tv&eduypHWEjhNHF0z5joTT1PU_O|OxI;h6kh6yZ^PV5wcy0oQ
z!=sO!{Ciz<S?#f9oN|wmRYy)Fkgp{TAH7MQQ`5GrWW+<#)|7^4ZF=3*Xp!$@9d*NF
z|3W{JiMU}-Kj-dv#QVGd`R18@>Gp>dJ{t%#NBxq5<&jnj*$RE(OnLd|=v)_U`<)5t
zCrg-I%~xj<Sd(GQ`YYIIs8fukTQ04ayU0Z@Z&-yxuyGb*mBAev@^i(Jw;l5{&(u*>
zk8wuNY<~LLhIHuIemI%TW1q?sE{b~|_VwqoXD!Fq91rimB3?eF9+AU$q`d!O@><sO
z*3I)?+yxO9vg}(X4JDB)p0YQ<_Llv0oi%m$bLaEymJQTT+fDN6ljic}4zX8@;cFbt
z>)6$&k}Er<2n@}m2LX~mf^Vn{Sb-P9?`J>P7W~&1E#Fa{-^c7u(&A43VV?P=BYv*+
z#S4J@ueng5oL3JaA8+3>L!F~a!`Uo7{YTzBuFiR2P_!J+cQbKKLL%66YjOWH(fk$h
ze@72%CI3Aifo*y&bx&hEh=QH(Bz9_bOF5QIuT^h%a!WOl&TctZWqn6ImBsIVdwz09
zGm|GC{)Nfro_4NCz_6=8CZ1Z@`#!y*(&mAFsY+)t@GLC$bg9;4IFZTrk#VijX1U(}
z?2&1s)%j?y+V+WgtJCZ0_Tub`Wv4f2l^wK%p{EZmQTz+GJ-;fSHWC(96Xq=lsg8Kw
zP%1%Zm&CND7D;S1W8Y5tOd~0?UuubHj`R7|zP=OeHpKmT^G0P7{{aOnhd*jB&^yGT
zcr1;>@$!xD{&=oby~g34-|av#8yrlJd%giQG{j(b{1AlPpDs5zUVR9?J>MS9|9l%`
zHEEABG*64HA))ua55vZGJf6!IiOq+X$EmG@kzzz~lgzLtf^Er=yStwyKvT8~`^)a_
zVgZj6Jrg|5XG5BdBJ+6?ZVs*LrBE@LtT#{2pYODl;;#_onIc{cmCwv|UF>k%eSemU
z*yDlkg)&)Ho{uU8pyNrE`s)&~V*JP?T_gvMbEULM|3WQmp=6aqNhXFOZ*`b%G{#4h
z?YibkljC_xSCrt?jkBmBA9e&t(!uwlEr_IVr!9=-hm;xU9r7&udFy!5mHe}5rz_3&
zf}H&H_4;O|uZW6DS5aQkPG4Ew4xz8ol{=;K&s+0i0JfdBGt_iJDiX^$V0CEqN`|}`
z>qqH37#k+}ZI`MbbdL;8i#py+&8s#Y_DX%^a;J$QIS|ISgA8xx_LB-U?Z#x~ai-3j
zF#(pYhqdVJ7B&n4hdMCum8BOJO^~&3teHWp_=&!gbpS))&8h39ztOS$1J8$T=!b15
z+wchyp;kY3v>^K^Ri=+~{1@myGZ1vo^^JXkZCsFJl4JmveT?s{lVe)wl`(0IS(Okt
z&Pm|QIVZ<JR5|Im`^K@LsvyL*c#X6<HxrE4#ks8S{m!*=%XP6d56JZ8UbC*$KU!oo
zXG*Ix9v9--bX`|^^wpPtJy`R7edpN;v|V0EfYd8;*10ou^X|pc2)XH+qY3jJr0Dv!
ziP+cNyXpNF_~1Lvk0xf_59x~LJ1wv5_L|P99Q5qb{VObR(X`%eb7Ctu#edcH`r+LS
zEJb+L&Dr)7yd7o0GQYIBz!bcnRS@Ya?k|+=)E#2!5qjG6-qyOa7Wygla**jS+#T{t
zcfYGc^I!eljEned?-p_iL!d8bJtENj3X#*-wE`i?=h^@yy`1-{pq>x5+CWSnBblm}
zlE=PD6XZ@(Bo35z1o1N$>^D*ri3s6OVUa=E4S7iFW&OBrvBBoQ@=#1^2Yx8Wg_yD%
zpTmvx6W!K^Bm5!zWh6U5_N6XDwIScaNm~#HQX8r4Q_vQ`i${iE7p2(=9*9pTrLy=N
zsq#ktePD#1E-ExiTaW^O{(C3%Q*<=keZluV+F?G6$e4$_Jp8+|VIehz=oRn6^JCf(
zu`kZTZpn*&U&=?M*y|JGd?+a?=tkw#>Jw8tDXBTiN0prGlXBiDX(i~!R1@oyO9ZLt
z)yu~K_4O%0A9LC^cu}Yy6I*;}Cl&LbAL$Y{h^gIgRII^t6UJW}(uV}8*^|mA%-I|M
zO`R7puA?wN{kNH1>ZIn*PHmARQ)F9xqvjnrp%rOQV1mb?;h&FGGO#cgIrX6t+<PH*
zR&EGtPNosQJCSrV0cAtpXhh*r*}44`!fp9VMZZ?4Jm1{Wf9TOlQdFpT;cGCVq|i!p
zwD;N1$rlp8m+{i+D2Zy~6j2M&&EeamgcmdxGh-CW>T1rV%{7+5sapfIZRWFY?*rJR
zHe|i&7xKB$N>69#RFf(e*58ve6nyD549zu)q?;-<vvt)k_~t8}n<^jvRq%AtFV*2Q
zRnm0Q{F<-Od<cNLR@(Y9=>0QaB1GZ>x^-1HUeBv`-Zs^YWY{uoo-X%&S;{Be)YV6;
zTmfl*s@0cdFr`pfX{Oe!PwlevCRCUkGih!xEv~YZV9;s)vf%U}SZO3vsZ$W-)&%sm
zH{i5Y=Iw88t`e&1P_td%ynQSy&erC`l3(BY(o$T_#O$1uIlm1&Z*&1LyZrRpI9B`C
zT#w6aR#~~}uk7Bjb#d;>#J_QssFl6R#NvfUu+^x?*>$N;<IqvQ{xr8-aVDkUeO9?G
zmgC;@fqUjVowyDC@*Mrn#2S=~Z`6R!+lOhf8%V;qo6X$Hh>^n@hVgwD{m)7fF7<e*
z0Hev3y~iMwI_x-n_zU=JLwflQ(Xo#%<6b;_n(q__qorll-b{+eu&}gc6sR6d^0m!D
zh?zan^~ZiKI^U@B;aWm2;{hMDCxcQBd#X9!0aak(xWNZ|`T*l0TT<JEg)m3PeAOXW
zL))Z-A4k?6;}PF{+mu^3N6uZ<k<eY+wBH9u9z4^r*w^;Spz?Z6VAg@uAG>kTyflYb
z0-BCs!(3`NX9-93iPE3;`J4~V5^L3H15OEojTnvCIy}7_i?mtb(rvUOo@Q5o1VKLx
z7w}K@nf_h-a`y*UZLq$aae4+z#8gy)VfA_DkWMC>MJ)&Idz1m?z>hU;?&jrU3`@$w
zZ;JWQP!47LG*eTm)m344oXpr3%V6Fgisgu$GfY>mVug5$a$&8-xRXJL>3w_IJiYS=
zR*&4lbiL2gy<ZKO9btm$CP&<Pp6qqpC|<Wwds_7tiQ0ap(c>$AMjDdXstW5Vz{gH&
z8VvN_8&=cXXEt2u{ed25*ja!_<Igum_JH9HEf{wvdjd>k-{srV9pVxH<ct8i0K|gn
zR$E_&)VDTLkvG8#J&^nuAlRW*;F~totI+u-%IsKaJ5-%-v6|eawn0c(=bJOnAm(lJ
zypTf6l+@}bl`BDM7rkwbz|QQQ8?|ll+!Tr+xOhKCtG8g~akZmDt9y0uKdlR&M}Hgo
z4#X&NDZI@|n?5w$^=PPJx%~%yJyQQqCO(VXqe1UFHJv6dv7)$w5A9snoHVE$?|v#<
zVlZJq^4|UmohfJ$8k-h=@Y79y0{MT42IlG>2Cux#^mLyTk^DZm%ZBJWay<^@`tA#?
zzd9lJJkQsNE(x$Kwxzw<&DMOpq$RwA|GfV>sewM)LLWDHx?b4+JzQ*mU>Fo&kiyQ9
zXzy+v9uxbK8NpTL!fIx{N#%Vo?LfP>PsH*N!?qDp36R}(9*m7ntc_rFexXF|-1!<U
z0`gF!NIp#^DrWDXL5R^R^ih|Lu0VO5_IYThr1zV7+XtlB6~tJ#>*#p-h^SC9E$sX+
zUR$4)2{F`+4u!~e*vL+Qk%6Vi)|ALlKJxH}i1GN1zatTUV>bMfy89MO_Pv4(XKnkv
z)eyd)#0`*7U_wN&woAmk`NPc+|B~$SApaX2`N{(s%m*16kdzRZi*;&D4$dOWASD+r
zz+g5(<^q$d70gM22~7&9@p4K1$Zvjw&v^3!67p#e^=NMq`HSGbC<efUh|x0>&|&_i
zgXj`WffuU_3>t&UQ37C8U@#i{1da<T7r_r3CU*w~Y+s024na&PqHz1Lf@KnH+<OIN
zdkC{+m3-vfW9uASi2S@kF!#M&ex}?yV6;(VI_JGhHVXcBJ>E4Cp9i!LVZ=nR#1u+p
z_{q(L8k0=$kYZ@kRDZ#g5%s_08`Dp1d+<n<;?#s<bD?73Jqh7|;#=4fIRz4$`<+tz
zdWw`XIz{|Qp9R)Tq`?I|VP@iS`#8HKaTkcP6_knkW?!=R*-MHP<^RcyA@V80!m^4h
z<NZ)_NKn$;mPRVBzo67B8el^2Mf?u0_OYV!q58IKrh!VOu#`))hRAOOhvCu-6Clb!
zx&b&{(V#C>)iM7CNmr{!<bN|^r50nTD*k10K*VMw;6SC{t*6^A#r75mBY0rYyz&e0
z;Hmt;=u3${d7{A@NT3&<j}{h|Qrsj*+nC$JoL<kcT}siyB3vJOD8jv~>P4-2Y5Jl>
zF67lGmPj2QNNrP3-EME8>q2cOpKc2Wut&<Wt4Fjyv<TWPQGcQ4Wwu~xqZ|*l(7Z2k
z`tse$2G^PSDB|K!hnB|WQtMB_(jQGr+b@;^KaTcKK)R?fpRFtd^({XVjw<DjbR<pT
zDB%|JOWpq+DfAz)Ia`W&S^_MN0JZSnU`$cb_xR>4Jx7mzqtX_Zm+Ev51d+nBsucw$
zehc(F3ReCRq-^D~R%*OkEN4;@Iz<@<#PM6o_j4<A^*eU9wqnOWd?BNbEYJ#VrVW#_
z^6R%s?4peoPLGK?j!mV0sn)f!*o{jqvj$^CIZ%Wnm78EfPlkx-5_L)<A({!ylu6tt
zq4acz@3i!4C*B8EJaJ{I4r#G|<$k|U1nSGu$+gmRPEv*GW_EY1D(FJ$ts~s%vNFE^
z<1YHQbmCB4o-<UQ(rl1yvY-4&7j#3HA5@-&WTS+6n*WiO&rR>TSuTA@S5&c7s9E7G
zM=$^1w|Qx)*v;m*^{J9GeOdcbX)3*Aq>WA@eMQ_-d2>Z6wG9$v&$hq9yQ`u)qoV53
z)WGB<^RU8ol&%ntq2R;%m5yE&lc7%Y8?XYK>pIXIb%>u6j%;M0UOBRYn7Y!y){N^+
zzqX%n0+zCDfIFm;P~%f;6hm8vtsx;iYuphpdLRrh6h^}!ln#cXd#+MDW&jht7nTz4
z7X(p2B@jlk7Z>4N`}@9!0f_E<uUHs7t1wK<#|ChW)Iqr_8nv=Ujb671o-O38H7=NR
zqOVOkayY1pKZ0@e5pgi8l>d8Cw*ex<49w(EZ|9P2fj&GV@X&DZtRpA1-vq>l-YW*F
z8Z@ypc(7WSw5eI5pOa2&Spo_8FcNx*kHuAysf;d6i7gsj5SlR=HdZm>@6S4bx`xg*
z8{w%Xd(qG(jFJbK6a$bZihm(o09wy}mQ-~zpU+F@&ShZMs};vR+WXj4&36wAD8et>
zz?qp;FVQm-vNH4WG8;w=U=r^0RRzK%S8HZLnWnmt`<JS1ZtVez!7%&wX6=l-V;OZ@
zhC2nt%|M5`5BoE^Gp}TcHn(a%*`QXhf#e<LWu1%5N9O;Mff+IJcoaQeJDVhr+SEZD
zJggQo2y7a=9BOhP>;^`m?$qe8m`d5}Co>Qo2l1m{wHknibIy2G`bSO!$rvR9N`l$#
z`bk30@UO*a5$pt9;E0lgcyWRVk^}i`C1@rBi9EyuDuUSs`$x7M8LdK}6Kh_=LU~cd
zi6kp^2W_{)Xih9bk8GsI!M0ltQhet@xGn)O-vcmeVZU564dRK?8G*W-fzx1yX`9eb
zg|)B~FpO^3Xv3_oUXIAdR}kx(3sh(w@XHOA!+G<E6vWT2Rr>d+4kC_B9gc_u;GBi<
zTpVXvj26eKl^kxWM52ADk1V8;09zccG?Wjgf8?>o$j3=Dgq1bUNwZdh@R<f<<$PKb
zgf)JBXds2LR~dYHM1oz7@x=B;z3NL%;b)E;a?6Tc1I7Z4IwGHb9;aYBgsUR#V8YJ+
z-SPo`oNGkgvyb+`A3K4}8~udn;zXiByc1&3L*zxjAbuZs{@Po_9!qWX8b%5yqmkd*
zk}N6~p)9BYh#qhzqK7zTK>jzjJ7*y2xGkAw9XWac9Ci?=j|5l5z?L*S#r$O*`$d>I
zJ8$?YC9)+|cqP${{mZQbsRq;(&?~`@aD0sqXL5c;xX?!fb48ffCvfhtuL;`!;s_`j
zpqqdtW(?L9WfL9#eHVquW{b$72!oD%eka}ln7Gz_w&SXlkfMQ6A>ZH;yyA0Lr%2kT
zAi0#&wc!^iEl{bZF3T1Uu1?99fK96s9v9<;VIhhs7G=0w+Jb#C2z_qn(AALO9Qng4
zbI+RVz-B1LFBk-~1B0h4C5;Ay4qwly8!BTd#jhw1Fmwf^yC~SI%eU;ytKa?_w$ZUI
z=Bwc#_Hj`93sScH4I6CVHuWHY#mVmkHwpog>N=5YTqUF2X)1DRrU%=^!T#zwKNhdi
z9CqS#=j5_PG)3$EP71C1)$;Is<NTQTCyKbvQUUK7b!hmu39#@0aDr#H>nD5bBOB}+
zIdw760vSk{s{~63#@E|r*4ZuBwBk1>lX9a-xN7=50L&gVwVE|)pE$Q!%>@2f`#<hQ
zHYW_Zy4EaNBTL)NKiKPrf_3U}*B_U`&EjXxl<1AZNiDdB*Z3llzo*%pO%YwvT+Lo@
z%>Fc)E3|CMyIVRwLAoCF|2z7yX$gqdbcY{uH$=3plt7$@B^P8hsHx(wb#r)XV&8Tx
z0JZoCxSA}xyL@B+qy8w3eEY|+*|(Bc^T<7Dn<S88PN(uNI(#We;J256hsXc4_tsHW
z_U*PXEV`w;yE{ecMjGh`>23sR1eBCUy1P518w6>Pln!YSRMuH*8IRB2@4NT=o_)qQ
zzB9)8n;3Uo_q=M(`748IUJ7JYM1E=J6^(MK_znouT-s>hB=G@lz}GC)l)dQ@7IaT*
z8Mg!rz)QUAoIaAC|5ei$ShrK2OQ)#bW`VZKKoq8+m|KgLW+R?2HZN};(p-`@S7=g5
z*lRT#V%+*Ly9y;7GOxkmEb|!i+-eH9XePkWBZ|U(^U~B0MrLqnClVzt=hOFa*Zk<I
zNztmVS4mYSC^z8cJRzX?T*#|~$78@P`rWO!-lxGiXi5z@UMRjcLoY8&fjBKMQjMOE
z&M>^@;==FgPVTwXzry7xG?MB`Z7Ov^t#@(dOE48f!7Lp01WD{52f$Ns@b-0sP&}!s
z+5cT|9{cmUB5_n6Q9Kp?k~Pd?&!XZipVlg1OG(ylPP1U9mXv54r}uI<gLZT5#g&5=
z+(X5n=Pzw3yu5VY!gTgJpN-g3?b>#PS@zC5YZUb|(9{B0df4L~q&^)&p^BnQQtz(X
z_VE{Ms`yf|i&DMqfpR--^W1G+vuqoEKFW@legoGreODSRAz0qafYU?L+)Wk|#F_8d
zQC0S?>PFF0NazRv^RkSL2f)$}_Zc~eOvBa))unfkrBCKt&BN!Yicl~^v<PPXY%GDb
zy-<|G!R&5rLow~aK93eg3xqy0kG>ZU@AM7Jyv;3aS;2TZej(-iPD0Qw)cAR@u~F!H
z-Tb;9oO4^Ka2JdK>chk?81>}(S9+fw;s8JK3-@x<bn2;eE?xO4Y(5Gf_~skg>C^vp
zA4MY|?}fMdVI*J8VcX2wL)F9g_iUPW80U{Z4{9FsPaWTM8g)IsaVbBwojLica!L+N
z+Ix&u%X`tQc`hRoDfkYjmgmZI_R`W{98(0@gZ*Z@^8nxKOI6|xImMUccWzPdLP~*_
zI{x^k@4hk<e0{(7?VZSeR`Du5^U0csXfd`xtg%=y0w$eCbF7KPOAJcs1c5kHsaKdr
z9X)esAEkl`xqVm=D~TIpsZ<L!TH-AflG#lL5(M8ody>xYyff4C#!@*8o7>^2n2Y++
z^Dp0MHCq!()O@e^G8E-LY?Wnc)jXSRO$6F%RT*`M;XX{Vo6jcE3aT%SFP*7%+!#oF
znCxKC=6SXQ_uRv3Bv&RK{@ESR!BPqB%7JEkinG~Z45dtxuny^3J%v^yuVSjJ<@+qL
zmw1nesw{G=UQ^+=r#YF%q{$5?JxcemUv9EazkZd<x;fq)h=Bk2t(WsBHut=5Wj^lf
zbMK74K7O3x<9;|_<FCY~X8&w|vHK;yNT%;?`tl<-N4765H>EopgUKRUFT5}D+iqSM
zW%>I9fzVq=k6+E`Rh3*{y0Uh`5!y|5BRnUn&i#hIjM0O_Ii}K!MjjuV3qaFH?ncJl
zn(V_?RaAY95x5y8xu@}3b%4+sHd-n|6o|@Mf~gu*F+d)OswO+^&^Odi_KsL>m^RhU
zg*|Fgh?SRADx|b8($`IGl(pputB{H^_kkQr2g~#r_mm{!7`iIV>k-n5kf~gj>GJ7`
zhspZWl$=tz*zZN4(Gnyc5s#?KkbPBDo0KB7pAiu!+~gMGBCVMDpimR+Mkyg7>Gpw{
z6HRkQ)ofaWQjYzco7N2nGa!gum{N02$9jBZCPaXDa#{noVs_pru;B11Z;WEX2TjgY
zlOQA<#7`N<IZ;n_Npg-9TKH1)T;>IzXUr`-c4t^G1gmUcFC;EmHvr5!k>*!CZAova
z?bbr-IBrBkwbuM@X=PV~M*3^@l7@h)K>?C?Pqa;hfmg|^K25k^K87+@3M_;nAg54i
z>Ie;@K=)K@Z^b3{X=m%tzw-JNDCe+fA^oJXd_j3zW7sU#XhO#l%}lyQFp+-KYd0ri
zwRShvJ7ZxdMuKf=zeub6x|WeL8hb4*XF~T7J7z+QDkpis`><x1@3U3u8tk2I(x}7o
zu}s0^@x$;grTw?OeJ}J*I>a6>kJncyJ+SRWVsCG)L@?6Z*CfRZK<uTA(Pw{G_lV~d
zpZ2}J>&An3K6KAuttjFw`Po<8DjBNg$s6{cf%Nkxj^(c1mhzTKNU*Zd@J~!nRy<SH
zs_qPz{MlE%Og^pJJA@xRwN9pW0@4S>eJZKS)Xgcp*IOPP)L*?j>8`T&7_(@V4u!|_
zru%laC?a@kJGJ`4>wLLt?LK+n<gs(i2k*YKuh3rY>(CA_?odEWxi2|4&Ir~!=Y~?+
ziA}IdDy}dIYcRwggpnOi18%wT;OVit3!P&_Lh7=&k-v0*PmB#+zn~a5r|Q9*sJ5p+
z!nx6ql^~rv36+D%ku-0XpcEPpYwe*#eVHP8a5WjoTrc||k)S^bm(xP#G6%aLMXHli
z)l}rQY%5K%6zBD;NRc{I?7@_QF=uCsR}x5qg~kDVT@q35zFLGjt^;hQQ_+4TM8v^6
zLUGw<*nn73#&0RI)*Eq;eC&XE__%~}k<e<+vHFNY@u6)n0t)dN`MA^>pN2$Rr`{Bl
z6VU3($VW=X0{Fv2?-U6~6#~yibIWPSEmB7vbK<>&E{7hjPO%xFtE<$Lyk=FmmNR8j
zf7<RF4xdW+#F(&7o>4NFr)HnkQV2F}@v^YEcpu07S}k#n2Skoe6*J0wlM#hn)RABv
z>(KZn(_fxmVn;{WuW&!3jChxOzC}4Ob3YShcvlp&wBSW;^xHGVJqc?Kl~59#TwJ&h
z;=tkY0NsQ<k$5X{h9%XwT*SP&_DxyUv?92|qQK{h`wGDtYA>;9@;Mq9gC9r6rmZFv
zIrU~H)W7UWMK>>c#CzZibn%JJB}**1)?s`>Cf${TY+mxDfypbL>3x)8V%b(4BO6-l
zY-Kd>Lmkox?cubi2fnkeHtuEKWAf_tor#rvK1_kRK4R5MZk6s=who_#a*`gqRQdBB
zSuM!7_p&7kIMdn~5fbZ+&?LQxZ(uR@FKzERz^P5XIx=Oj?Rp>mlqb5t#!@bQsU?K(
zWvTnIxnfy#X=hTS@(9bfARmc0xiyU)aQ4Qy0-B4tb4~pXxK4UFA~_CEOZs>}yHbbf
z+aP&1PByS9X+Ix7bl_*HsbKT$ekHO`B-hefQ0dy6ZkXhS-*Mp14&yl5bx!2m#O8P6
z=iRgFvYGrYIf7kbR}a{Kht>EF4sXq?muEp0dA<uRbKXCP$e0`5t9#7-G&BOvq&*X#
zxZX>OpM%6S&g~O!{baQ<?OPdS=80Ykyt7w~;-=U#a&@0e`kCKCn~}=&5mpWLN8qMx
zN>>Ub@=u&a$Bo630aFI%g{t^ofF^e|sUt{o1I#aSqUc8Xn=bua5{mRKII*`zbXK_(
zvh;U2t8_?>=V}|8^#w0<zmzYjaHsbl?QlyZcCSxL#~7KQ39By>5eA0wt&>>Jawd5D
zPlRV9L~V(`+nkJ$=FX7GMYG%L8H|(WDtaD>CRxQ_HEI!&#lK>$d`K{p+sKo}$*N^1
zN=@CPef26d4$~3{B{*b&=ai)&eyFu@H%B?a8|}S9Wo&ylQUw*p@yfv15sI36{J~Ww
z_0b^`J2CP23y*p<;bR-4ud~F_4doS6N4g}0A8*_Tq6+My%;~k3nVy|G)x?3cJ8dgp
z{5+-ODIM*4TWQxt8+g+;Hne5{1mly^@0!v<JmTPKT8FT9Oaq5@WWfZ<`=xH|&XX_^
zlFhk9fqriBSFhT1KLvH%IPuz}Szd~>@;2R$J7>CPoV?wAbaVSYkjyOyBV$jB|86QS
z)2)C#WB-Zg-E<C_dx>(!fo9X)Y)$4>(M=B_0l8P>_R+TMDDMvU{N3VIrbk0n#<9KU
z*X0c|&zAQYz|ZbY4`*9GUnRBq9+|)Q<V~Y|Z8#&o;mQAP12fC3pFQ&|%JbVNO7h#n
z>0G>y2h!Z7Ii6=O?MY-9=3~(8UOft#mj(Ra_f@leW~(x<DzbdH*|WS|UfpaL&0emR
zL8GmlWZrb#d_M^!_uatA`qIyTe-;P%rQ31O`->cMzkTJbyV<7utC}poW5=woD>wHy
z-Q@S%S`ycFYrY*X^`EDh!Q5<m0>5sM``^CLy1!}yem~3d|9+AM{ND8Vc6<C=tVFkA
zFpa}|q6Zw%xK7Z7)zGA;(3BhiS|<QwHGuULz{vr_>jWcM4fE&}MvMbi$_ZAk8urO4
ztSSc_P}2!cry9-x#GQ!!zG`>U<uJv?WQ7|0-Pj4iyBfjo6d{lUG1Lh$q8c&k6fuqi
zDRC0kB9_`}@}qgrdTS1GeGal?%=c;zlm;i1mTHuaQ<QEF)P5(_;cC?JQ`9LAv{@&#
z#cH&bQ?v~Z^lc~f{c7~%Q}i<qj4LOM+iHyOPN)?sqi-L0$=grl#?ll|A_JW;32QJ(
z&oC)Dv1pyK7;CUt&#*W-v3bwXV4RWBq94r06r!SI7FFXsIm1!q#MN}h)v3WXIKwsJ
z#Itb5v#!CjKf`n8#CLbb_pZVBJHrp;BnWjTh^QfmIwOeVBusQBw06eHdeAjl^+`Og
z7$_Y_SaC*F!%5uWOx#jK+;K+S%}LVlOfp<U5;#R@EpDdYL%3K&x^hOk!AZ95OtxP`
zc6>&5#z}tVOnzHK{{4&`nu`L?g#xLT0_~gvlZz79g_5wAlJuOC5{sgy>_I;|J=HlC
zCl@uZ3$<V^^`moYF)kV@7aF-*nkTgs^e#jS4z$o=RQ?qw+FW$Qp->jJbgC>w50z={
zu{LL%>HWC61x`|gPv|4!wcTnN9LFt>(CFgg>8)!Sb3XV5)uu&rF`bpuS70$Ea(z$X
zVt#YZ*b&drq(;=n#X^n7Jbq3;$VETO#kz>fy7GZ;UX7uQi_Mc|d+7sPS$SWf+FRgW
zckd+^v%>4?Oim7kiNU)MhKSP~4P5wmZ#Z9Jkr?LSV@+r6ZE#Xv(9_o87mxRIP184Y
zFEYL15W3*@=i&+67|HJD@v9w-H{r<<=hbngH>jI@VZvu0KV2P2)>Emz*Ujf#N9X>A
z%%Pkk*mazy4sS1zU(-@1sZJoqmG+IRplbzTZrxUz$pX`~Vd;esCELSL6F~`X_KxWe
zu3X~AX|BOK;pJoD<Tqq4tYZtVvz08usda)G*pCbB9y?Y%PR3?h?e47&6rmocvDzU0
zFl`99#Dz}~JsT6noFU5&B7+(iAf4%=!5+M?<5vwA=k5__uYboiL&%52v_&}&bfJ{&
ze?1*9Mus)RuB<Vu!85EqBNYQ6KQ$5D2%L6-mbBz)?}DCLHxYEk5s{*i**B5#8<X)*
zXbW=VdYQl<7sRobL&AhkoW|2vOG)jLL&7&B8(J%0#iPJ!r{FiHFcrqJ1x;3LFETvS
z)s9AHmmra@{$vqneHBNE8$htd^TKIHawBKaiADK@`5|<rvLlWnMxPQ~;tC>f2dd`C
zg9h0c9F>Z|9j;CM>>PuXOI2Vgbtg1YE(^6!4iR0V(%FUbzR44ITpFH4^+&T!qM90F
zxf;r|g2ir6GIBQctF-*Cv;ujxL*2C_8np4*@!#estHWqUX=rNUl6lN(8y2|hmNe*A
zT<O;E>XBpUB=V{*QftlE6Tc1IbjdlbztW%LHJEibSZpvbh`}SlCU~1evNa=>tf{IF
zufHLtKRm0ya%BX~XAI|IjMQixif-sCX1K3Ob~LM(NJa6(au5k@IVc7d4s`-U0tE%K
zT$@EA5jf524hBXeX%EFB_WT=`YtNnp2~abcH&5n_gDuxc<?D;5@_t*cu{&eU4A;@m
zlxf%5tc*02%~u)sMv^kC*@%Td^uD8kSgtvJ8p%*-s$2<v2B%ihdR_U;a;<tJ-+T60
z^Lca4r@>fig-k_3+s%G7=3ka;#71nMWy9RT*4!_DTCSO8(b(S^ZF(fY6Chr&nP@`$
zS)h<Bfi2epoDX+0JV}$0kk1n&zCRQ=KU}D@U7Ii{blv-4uK>i=k_>=*vW{NZxYW_{
z_2%@GC%q$ChgeCc2BH_|5pmB|*D(Eh04$!>y4mgVJh>rEPTeppJWma(?kuU*Mkv9v
z;tfr7afS^Em>TXOktz3J!so<=#hZ~VjSTVOfCR)i(W7r?G0+A9c?6-pEqkA0MB!UZ
zq5$hDtFL*Yi$(G2&WBQBRir_dYeU`5=5G)&XEvY&-d;Zlm{WyVuH7yq83f5rKD>R>
zmF0h+X|)5kT(i`-D_!3Sx{1<S^#%@m?`DVK*)XVILN66*tVwy&q`Z`7+RsmDov|X@
z--g3*kUHPdi%AS)Iw;Opt7oLm=;YS5HWb%AD61Y2Ct|cOGT6ztsRdiESuEWZWVgdJ
zA5}Bo5iu0^(Ul$5o)Z$&*N%ZL*ZKq%Nb6^wl^r*x>wMjR^D&J1b8`qB>|ains-Uns
z{VS{(AYnCthS?RH17n8xuRHmTrwbrqy)CZJkq8&~Phq8!H!>p_yDOfBQSe7tDS({(
z;x$m@k0NmQ7Mp&BRh!oZm15aMsWP<A6*9=luX>|59Glr=WZrSP9}-qzCqDz?s*WWN
zj-8)QewU`>n2R1Bwh$*jv(d~IHREP~jCrX@%s??L19(kf{!b^rLo|ei6o=K$K;ruE
zCxBW47$Wrb$%FLMosnNoeyL*>X7dx@mqiX>?nz^F%k(*L0X|;4!r$6Krl9Z)*<NE7
zV43CiE}1)!Ay&o+zJ@9Qw!n9HF#sG^VI*V&Z=uksXedKZN?ezrO%h->M6QaRM5*v<
z=Qe&g`90x$X)1`=@MV*K23I9g7Z{rt0%g({{wZFOZ-46zEhoLXq%@VzroA|pcQigg
zKZhp4I1Ch4{PH^Tl6oGuim?)vDLVv4@en7!h_|U$E`so}boXzzBazW!Y5dn0t@m=m
z>2wJ*5#fji5??fWPx1f|35#-5o|WzwI&unG7ZiB)7U~`|P<6qq>yPZ0mNy<8sAk?*
zsvnfBi^@Y$uV40~(*ju5<-|h_zZ_Ke;n|kUjjiY&inLwdG3Uc`iuR&nU#7`Ab&q%*
zHGTv+`Mm_lDpWKes9K7m0uhY^(5#vZN}Emxn5zoMGDas`k3Y{A#lCO<v|w`q&vM%3
znzqO;l~=i7)d<UfblS^1z@*v(yhZ>y`B^Gv_F<~FFB<jOu$&Lkqz}||YRli9nb9^K
zosTAD=sW1*;v-*-3+$5Ui2h;5YW(*Q{(+2&AY|k~{dbVD@V`Vxj(>=Z5C0J|8if2u
zWHc%GJ2LA04H-$X+pl|44C^)FF42CNQJRfj%PuYS1>PnoR<Fx(+H}?hLy*z=U5n@Q
zcv&aXWPcPazpvw8ny(<p$Tr;)us2PP1@xVdjt_uQTz#aNp4tXR#?kjmtHM54Ue1N-
zye6X2CWtkbv%X+t3`7)aH1Y>hUPfuG!PW&sQPcxs!~ms9>tQ4wdmArxr36eu@$cUd
z@aiK@ic;Y}YbFZk7yz45CWYiivfN)N8UkY_`aNF<d@_xKm{CgIA<_t7q;0Q6vKC%b
z#Y4;}=N_e+84kTJ9u<@LVMaNulZ^AiI+kA`(G?{aDu}Tl6@-kt8LllzmM>ru`MdlM
z$0H!fxTp34Fj6EmA(kvFIMd*{m!I&|hEaZ13ZcXcuzii;_yrF6V?lnB%|QvqHXT$k
zCfel_`=SUHUDDF}Ih(SKsw9tP(UUIMr1JPxrXx@YFEUFdO9>g*jPV_^L=6Mlj_PKf
z+8+B(!87bNfI`^bd2vMWplK_~w$gILwE4K@sPT}^1R5HGlaTc5^!N1p11JCe^a~0y
z*nggWIh@h|LHhkCL3S{Jc8mY4RICG*pupa%=?6|4jy0btcK~`sVaFIwRy!?$s$_Pv
zHNPBB-BgF-$<-Ri=Bsun0|imEZCe|Umz!M=S6T6|%oh@`8bLm%2X?DJ9Zy|jJ2hb}
zqjXlfH#MzA)+RdIZcf&BrGYZdx?Wd@T^6<&?>iysw~i#{F^Bv7!t4mx@e~OBJaseg
zwzH9(>3j%X{KN6o1km{`%L#!HpEw8uf|DL!aLfldc{U7jpSqiPko`!%0$Aac$Q+wa
zb7)?<FW7d9KSc|B5SVx;6M9jbJOVqO$_Cv~gCO0LB2o^Vel?;Sw_fiqG7yAmdhBl}
z8@IY!I6awT*ho?dE7?i2YxJH;xe*jJw{!ppnO7RDWuQxLgjpuU@pMn>nm9@PPL3w$
zHQzyTvQwIrW?IZsoBaZfGz&WM0~3(rY4%R>e!hPgD9DNd0!+I4g$JPY`vR}&Kq6zn
z=CGpqfRDMTV&~wns*4Tp!CxuW|L=J8BUC25K`GTFQ0@QTlv-5FP72G>ys@7lHY;NN
zvr-Fj++AJyy58lMNA*oXEUz~NTJeP|dUQKDR6r>;3+Yi1)WKZMLwqk=(IDZ@=?0Nl
z`VEh+^1&bGxLd~^_-npb->Dx6%A;~f^ZR{QN2dqa8KXLV`ECiR)N)J_nHI*yFr=+s
z2OfMpSB5KSpI#UFye^YtNescGxxE=yK=$6U80+KwD4~7f^Y<{Cggg@u5NOU#U+{rb
zs*3cjYAisQVk%DVMIO3P^tWCpG~+PAURXd#O@4w^At+RMT}t#)Oydc|0{0k#CXE0D
zlLM)C*ZUxITp}&{%*Xpk?~^>RO7O%_PYJ>1xJ>)z!Mbvo!Zewt0WbqBk+FGiAeCBY
z0b>y!5=}HRLWt@_WY%gaf>{X&j}9wjDwb>nagqAAMG$1;#`u96>WVZ<?J!K0AUry%
zqiZ2Ns_rLCXNfqd#(pX0#dS7bI|;7Tw(j#-a{ykiSYw;DF@vFCs$=`;m%j7bwtU$s
zb1dGk|LV|wQ7MxsmO=*mxf7AToFg3$rTmRq87s?KA5LC`ZuvEr&e;Ho=h#|5{Ag*-
zAWgCzmp#S&*M(u0rXwzE#^vO*QJ#6b3)7!S2k|zK{yWnBf7)octT$7_6NY&=zbR6#
z{i7lrc%<ik+#PtEJDJUC76kPUVVQ4c^mn77W4+!Tia|~CWjtN9GaQYnQMcunxAUE~
zWpFmXLR6GfeLzzM2<gV#noiadtcep!m74cTn*x7%JL?hAI|x&{e4GL|8X%-wm*4>c
zGe{rTUzIMrD>H&1ooLY;{H!lR-+p*IlY4kC3TRsD`FzI(r&BsaGC!adca}E{6T?Ob
z&Qq(LrvrW$6nfVNpmYlMc9uJb`(k8I8VzYQ5ObYR?ZT;i*dX4{omy04fWj1TqrqtI
z@G#BY)Q<<fWD8UgdTYgHk$UULD}lY8wYlIdoYgXSpC&;n!VhwSv5W|mMLHqojr%+4
zPLIta(`+(Q>0E4U2zN7muZOqZx{*o071dDP-vw2KL|fShICllPpztjTe=XFykPoT|
ztpgLq^LGog!<d*nGhD3pii<(s&JG0=U-n9?2jG|v&Hv1SnV`t{{C}iZ;QOz7g`R)X
zE5re&7=?yT#riU}12Z8lD5zIBSQ+)K)Xf5XBvX795w?LIxMpad(oprY1#PLdDA+?L
zR}$9VHR?v#;7WS_J2G?+EJHMmsBym6HT=kd<8AeJ!8N$f=pD@-CqG@ky+_x8K^Xk9
zdZK2#kQTJ#tHs_2G4-$P4jJ_~5ZCYbh74Zsd-~~V{5v`zuHWy0nG~0|0kchOkQOws
z^ooDde-<em;`+T2V!)X4)Hf2&iYydTXi=1!=Ln&GXfg?B0OvsRXzkoE76`Cy?ox%-
zrD}t6;PsxFBfk=YvAzf-2R_Ej_eIN00RtPOg}TBs*{uZaXC>Q7Tpjr6;sLaCG|3Rx
zZ@f_KLS+oZOIp2v7GAnEa0{AXQ@Mzz2`9(1n*q*&alWNyxUYlhO80V^@O<_XUxQmv
zc%g%$=mc=Du%~0QZS@umY(w5@)VcX!*YAQqd&i2uC%XUp3U4E6Jx$TI$)7Ipwuu5I
z#}SlW0a5$|=!N6oT0uzB6^sI8PH(jTh=5Q?%)4%+iIR!>xlyRS6;gP|wD^iz@4+L~
z0*RbNBiWojs!e%t94)&|FMk@%QhxXN`fU4sk<pqV2-RR7sG<u*CUQq1!??w%SQjns
zLgK;17zihjEe20joGse)jarP+vO#?aijd{PFc|wsO_TykZ@yn*!)e&^l!RiwU36)H
zTFx%G*0+0`KV0CcHW<2KFmDm_h4vWEF))SiU0*}NB~a1C>w{||7HLK(OiY7R+5|N<
z@1#U+n_-F+C$I~APlOzu<g*}xf@saVy#P+V4~%=DkpyyTilX>d5htJqlxkZ;1gOy8
z!`kc>fRKVw@3FYhr~LPb8W=%lzIpQ^(~6+B_H#$eK4>J7#l)<ZhpxgTUQ%gu5GA;C
zqvXSc7~9K*a?X2LGelR$A}@c3TwdLW-ls$Yf5sz<-YdI%Pz&xIn-HJqEj29OOQ;An
zvv799qV82AiYEmzpR`|^Mpm{SwZ76a1a@7hv|oXHN2j~CDxDNn8ITJ+zwee6(Bbg3
z4@b+6yzf-r4xH$|5f8LlADs=+B)1a|EfLv*UEuAs|7;dJKrwstA2ICTuj6+V|EoHl
z^&i&pDF3KgT=9Q4tNQmbTAue!>7%h<+0B=ibEy<?r}pdQ0+hyY9QG1ZzfLYl%*RY?
zy!%<lKPLIQel*thvsujTK)avw{c&=^L*>i|+^+i&4ExS`wY~CV-XXkjGB*y%ZqJkV
zZaYCS3p%;r41Wz$$M4=|TthG{+v*uF_PE74Ddgk=+2kOEjf4q00K<cUhqVRtknBdK
z4r&o84PoQB`^B*mdU9OIq9G?26vs!hw1#5~MYBjkQIqmneFDd<xuozNV!p-}17%l?
z*n#I3=;Q(<(>Ka&EqPP`9F-CN&VH+H(8&ef<U;yBw^16q<&>iEqmqo-;AXMN%f6G4
zUg=PUN)#YEBDb6Y9-}$?-4pJKc8_s%i=fb`DOsD6f$I2_u(>^0fTR#(<N*mc6sj7*
zMM-v-1^DCwAv&g#!l$?b4+Kuy^YDY!8bM>U_6e!OR|r4R4bt(Afg*(f3OsO)0}ovP
zUdF>BQ3*qaU6?3Jip`Uoy|0PrpI(M@g52Bi;Cx}dUCetE>G)gQ5!DPvquCXt+f%W2
zlu`w(YhjnvizIVtY|j;iG|W{Jr4iW1OK=!x3lS~FD-P-z=F64+$c{&N=oZVKb^G+o
zbK1?s+Kk={GxOLlH+Z1g;4;r1^auPg{8$EE<$oFr|NFy_|86XdE}4ux3=93(^ZXL&
z*H{=lzXP4b@hsm4_fVwdV2M#zHc&d<6UqBp<ByX#PK{gKjyr>&D}d_%)BBC_vgERj
zzfR&%AQp*!t;HlH1MpFNT--ppH(w2!-#uw-Jgx$%AYZ(?c$<urgx0tUa%uf>5(oMc
z|LIFLzcxPsU!jX1W8scA`Tg#^=fIi?U3Tvi@JSq?YR&R=@_7t~l6TqHAJtkGgKx-Y
zhE|sC&uXoB-5)_tY61tA1EA`D$@pU|oMVR}O|T}q|B<T;Za~q>F!bkGctJCqItejb
zXwO(&0s$sqa)h7m>CPs&THA_cob@t`emL+lnhIVuR+3pL1C)+I!w=dxg%4LWk^;CF
zFQI6zt=1ADIT_9esqi%#`X##X7K4~5l_^&EPKMV`3B8NsfZ*;+7*6fXnCEylp!uC4
z9fKn*s}O~A1Y|5M-e47Qsj3Y*iNjhkd4xW@Fbh2VC^p2g$-9_EvIbRa7EHDUW$;T(
z?rIa@cwW^h6V<`mC=KWUpTxlgkFqD4OAA03&!+;P#6h-jR0rSPkB*O0kiC%C_Y~Z0
z*fiNUMRs4I3uRM?>DO-$fH1hJV)?V76A}(>&gJ#t$-C-5v;X1m@8j&R@8j3x_^<B+
zj;Zd0SQkt%F6-m5;?D#UFg!uR3e74s(m|g*P_0almgST1;9k=pPME{#tv?8}YksrN
z2!j!XY%h1YEvgRlSc$}kGmkL_+qtzq(w%9#6tha+Ag!*r%jGRB$L&r-xw`vM7>#j4
zVyV*WZmYg<3aXf<R-+SS;b)Tp(URLxZL~x7a{(=pP3Yf}9O9v<?1ts(82DV&E6o_;
z`IxI+m&cXcZ0<>(Hth9RNCcC7Z`@j$E;kvWIX_ylojK@AB<2-^3Qk}?jwfq=l_%3U
zVvB$2%SrLqT<GriQwaTQE%W31>wbxd0p7H1^af#KtCf3Un)OBCuzHLYJLe6(q7mae
zV&K@8hNh={rZF5>pzwxeb_F%nbyq%}+h~AhuWn~3TOjZS&Js4Gasi@sk6kOz{#2=Q
zm9z!2CY4r&VMVUn9d@}`iNqrZTxM+B#TtjG9s^>oA6EwH<B*}lq3|L2HTl>3`H|_w
zg8tE!8A7h?CHTsU*?wJ_>Pn42#!SWXv=|f$<0$Hf5XRFT7$a=H9j~Wc=2QNdbUfOZ
zG0Sw&umrpY*3-r?%B-Vt=~U|@bvbyBbh06s8B{5HwySQ&<;Qwd&Ji93w)kvIMZS9X
zu7@`kOa6gqSOZ@@9Syo)U63gWf2lO@iow-$5axH??xEwnv9L=i7@Z_le)!~39nWD*
zrA(tVD{<rSpYTTry2&3P{r#_-{55O&D+vE3kWN~jwH$zjMs;I3f96y;5<iHpOA`Bu
zP(B{Uj~0n{Y^PNO2A$^a8P3kb2;hP$=43FlQW^`eL7is3d-^ReTCUk)qph6#N0qCb
z?qungjgC{LD2=_w@?9Qqk<7l-N#p*mm|2gQVrNB=2(~|<De7dD_~W}-Ydn>78A+7G
zaH}b-Bq#`Tr>`;}lw$0K4^WiQym2tdCji1PP?#U3I5e}o`~F-;_1d7CDq}E_@sa)I
z^m~NWzQ^B%emxOL+G6<qM0WoN0g0KB3n+*sBn<dO*d~IhOA{o6T_}_etKa{HzN?EW
z8%3Fb`CzgzkdO%E)@%Gpl)(8RvRAH;#*_$*{mc`+g^RcNfY(Dy-;zyITb%%S`b@ic
zmHKs(u$%72M@DPS>}3EvmVoMwrtl|8-|@dVeCl}#RC{(L;JP`Sh+r00E_k^;_(J48
z?@DU@L4T57QBr%_#oi*NPN^$nD(%U~PRkeQ_s(BrH#%bQ`3e7+yb1iicgT+P@5`)z
zGa8UTHb{m-A<O9oato+i412t}N0a3=>w$$cS<RtAQZ^7&0ut#5-C(THK_dzKF}K!c
zM#4mNEyChgO+t~p9};iBWACkv9fZ|jpw(Jw;RS}H3KJ-aLU#&SXI`Ag0HOwCEfFcY
zicd^K7~v>R%~NaEV-W`F_)5_;^87L2M@c&37vI4~h^m`M#ev5C$g6u?+D~+{_|#pI
zePxcX-zC80UXzBi&BmhxP`engZTDQ>Y>zzpDxKglp3Z0@{Qy?^{OiG~5N#&=dl$cn
zKR+3n-w!GLe-I%50kOio5iavo9HlTnge-Cw4?D`yBHP>GSZV|-m|<P&xaO;8YAFO=
z>AJIwREZ2TWf1W(&o(@rm5+MfXxIDm;vmth1-iH&pp^!`I4{Kj7&9Oi9ScLYi3Al4
z5|L!_DY?W;0EM)M)~T`7D*|$dErGL7QZI?9J@SiB^M|6CpM;GGa6OYs<}pcX7vwIG
zj1iW&!?CKfc%Sw#3RwzSgK;2-CY?>VRGn$4KvPGlzm#i#u1K-L5H4MlZa&M@S)BC_
z*Fw9_yiHg0E1#8qz0*okLz$L?Zt07QPLkW2<6oBx!PsZNpXL9bYee_oSGoN^c;jc3
zO^UL3g|eH&6i-qx{QAB2yR?U6VXI2MSZ++$`OkU;a^9)aJY)k#zTp0XZZaD<c26oh
z<Fca=S9otQsd@cLCvXqv`}6gwLp^ur-MK_B{*^p``qvE&wl3=x{&2$G>bteoT_6jC
zZS8@Dax<rW>F>l&)N^yi>M@lh3(+4$ay3q{G_Gl-L!epW`_4;zC<MF{SA@u{2^mKR
zI=v6kqib)hHbNxee{8oQ;S~D&&j06t;L>|#0WX2f|5&w8PCdH>8lIKN_#BOPIIu3L
zJ#sFA2p<|zSa4jhnxx%v&F&t%Nun#oky|tAwbkicd}zr=yr_K;1~$O9#2rZFu}2|!
zOjoja+5$c#1V(IX^0W2?kW{QT_z`Py^tr{**>PMe*{zI3isY(ao`?xXb!*TlwS1U)
z2kX6_n1@$HX*EYsf-A^i8~}wD^Hjv|#$hFs0EoJ$eL0@sRLRo)9maOjWjwvPY818O
z>E`tj%R3P`H1_!CqJJ$Z68`>VAhVm@c0}#wYEj0Z2N+ZuLn;9h;jpwsirQ0~60ZTg
z_n)-SsAS!#<hXc{xM=$m$@OeB7CGpolS!Y@(R49nFwtP6?oDplZ;hq_JlP_r&qT?b
zcplMRomcg~Bd)nu{X~@=R8cHcg5Gt8y8X_F3AG;jE9b^Lgj4Zoed=t4<r3_kKHl`t
zaRCUPvn^=qli7^W^kYwk7n7JwT7c*<hWfQ<?*^Yu31S6ol31juv*Xh>eUS&vePfVf
zRStMG=`3awFA7Y%5-lsyh_c1<K+|%`5kd<RpT2jYEb-<mUK*vwgWEHHU-|01wWng~
zvHYV~%KJX1I6p-}C+)oRNL{N)Mn?SW`Q-h6KAnGkGe4@Q-*ugY`yml#JiarP)GOFU
zRm=w)Bm5y`#D*mN`KB_Fxa>)7ykZh%$sA%>-wN4syAwFskuOsp6hg(apmCuFUwrDy
z2PW~^@7Y@@6f#6%1zKuCJ&n-yer&$)ZZlb<HBQDmcXjx_+I|+x8;{>ssnTk6>H9(j
z+rnG%;Z{~;?d+0Z=~2KVq0?%$JVpG&kUjO<$(+On!_TQL)hfA3?7?#^trvrTVr$*+
zTj~Md(!bQusu~OGKYeSrWu@9R2>N_0cm!%U6aqOdYiZ;-cE{52XH(M_)Ib<5Y9LM$
zS-m%v&p&&skJON_kt*_Vsb0w4Y&KK7#0CwSyL`SzzWd;tt_SN<v7oB&!)310Nq^k1
zaj7AX^?H98mp#DXO@*fWF^-^=jewburYs$g?~=e~n~Uio8Cgmy{m_J-SSidCKI;AY
zto?Y@Ki*W&@7wx=81-*g;LgT1iZVio98eM?ToLS2(ZpQqYtkqcpn_M>i6mCOwY}t%
zhiwoP$p`r`8d+u1=A>-_q+%81)ekAKXk^$b*$H!rEVH%l&y$P=E$ose7l_S1FQ*;M
zIp12kn=QXnob6}6tm@9SJlG<uEUU~!hOu97_}1j%q7t}qk7-Q9doCmeBb<&SaJhzJ
zpss$bUF=iV>XH{pWKb+R6uaa!Tc94=$MlM#_56F`SDp1X7r;Be=Lnz8F5<YW^2R!a
z*gTgPDm>vZVovS;_{Kl{elm@Jz3~6sq5UY1B|xv2)clLFsZ<QXlu2%PZE!$5qB7q%
z0?sXkH>8%PG*;Mj{crKPuluZ3p`K($It;+txb1f3D7+%`OPeVYOBJ(yN*k%RH&<-X
z!1SGQmT{=cyqAjfdE)*|ot<FP6%oFzdh65e(gNLi)&VEPSF803*r!9ev`Fcs&8k%s
zuZdb7hkexMG<Q$@Za5*Fd@kMp=jvhO_pNmO{v7`^TmeeX<Y1Lddm{13#YvjXx&kHF
z=z`j1AAD>;Lh1F&ABv^z_DG>>C*X4}kbQkXL-b91icUHQ7(Vxn@bkJj;I$8)#eoKt
zMu|dTSRIk(wnl}14c|98r$fyu9nQ34p@bdnYRl!jkWs#p<yg1=O-*9FW4%u2;|Vx@
zt$ic6$kL}FHeT$e{iuX%yhN&2W+Sk1hID#5>^nh8^sW;mJ{&6JxiEmgFy{34O%49O
zsh^a--x%}X_l~OTHNotp1k8jk>ra9OJwJpDtF64VWkL^O9CW1}b(VlN53qEy8Vfwe
zL7HSd+tzg7mPV6}4Y$#(B8_A6dpUU^RjfAd!F$VbIF~^_g^v1_9h$n)dmmkc7~W|;
z6OeO1S~Iq%*s)Kx;Y(O({lqPj&awO`sX(EdnmkyVk;r+kS4p{Pw#>(2=+7z>3h=8j
z`=4iCWR2^BU?_Ng;SNYC{>QF4d^4Z%bS?naJFKwIhXO-B9x%*E$WfR+?hpDr7mUmI
zM)ZJ82|k|JSr4J%<Xb{hK2N<vfMG-zjJ2u~a*Mv_%<gVJdyNF>A&@RYG?9mfUs9|@
z71$E<3Y*Q~sy=@<lDMfsf~a1})-xFnB#n(fT7GBKPbKJ$uS?n{0ME{SJEvzLr2o_u
zk)Vren7*XQUH%)w$(2SP?~`B)#tWgb@Fmx0NGD`|?Xo8WfFExjQkP)-emegrYw#)f
z%e={7HMpGD|3(cCDQd}oU)<q;0ULmr@7&qJvF#B^_`1FV90XAWK&mY-zM4(Ymo;L6
z<3ypV5Qiowt;jD273YX(uoEITnGk@$&x$-rIK}WGTYy~}XOCxpwB(>vTyrFWqAc&}
zOVdY<GYfNN>cfnjU0dba<s*@Z#-g9(1#{GDDwn4NDdS@GBhbwUw*zntaPpEe?xJ;c
zn!Ksw{n7+ZwX0+Cl`}~AxWpz>+t6VR2rJCT3f8a`2j!s9lS&?;pceLsrcb2Jrb>EW
znpvd~p)CZ!V$iI91Z<SR*yx}At*B=M-Tyw|?@ZgDSW^=GuN`g-$`R_Oprbv=M?MbM
z6+sR+{>iirMpyh2BNhLY4|mfor5=2^F@$MrtCe=ZkSn1%kn-NGd88h2<6M$S2!v&k
zg~iw$FA?ehtvP=jZd?TmI@niG3B?HY>%hev6f~|I=LCTg6tuMQyfbF(Myf#xY6<eM
z!;P~fi)6ck(@bb{UF#>iO*4y75g$BR<a$<pr6KV4+lj+od+CqEja_rg4Y1o8D#L?>
zAM-LBQ#qP#kA@7Q0b9Ni?mBF}hm2Goech`<G5RL`mR`VdZFTnQ^TTgm(%T!`t3TG9
zy4_ln)@$FT-*|0N!s;p^K81`_1>%Fwhv$ftFtqEHXt)(AM3F^&RmB;<l2Ql2JR`*+
z#e9%zO7<Ez2L>67j*COW-&hPWJ7njqa3fBZu4F5KWMC)9n^JA-6*4A)C=42%()#2>
z_?Gaz*A-J<u~7nkjBx^-DOO}&#&LO)A@GDU8}Sf6Ss-r&rZ0{`UJtYy%Y~BQel-@f
zqv3$n<ZGNoD>})|C)t5?`h1@V(s^ic#0a3tUhWow7T^aeK8AfoPiz$@B_!FX?s9X1
z96+JCylSF^3F;~rYn9-T?%qf!BCp)Cx4Tg`pu>&nnAJ+~GKf^2VD)=!Y79D&<I1t7
znBvmmjS(=bLK-B7p<pJv#2EXCN{(8O8g0vk#&#BT6Q&KbN9!veN7_p+NpGPyAOxa3
z6)dHQQ*YgCDFdywED@`yfPKkvb-cPLs%74^KK3b5y1txUZ2+XCS9mH!yCD?(<)F1z
z6@HcW#l(Sg!);HiV}Hzt*O^_g8Fd3tCVRRhBL|Ikms7Ga*XNQr<OzBc1myXgDS+_Q
z<1rzbz6&+OE<v|ABzo5C1#_c@%Qu(eTch56HFc?FSQPYzv!uJ<lm)Q8{8EM<c>*78
z4I3x3epwGearcmXLQFG(4x>M{B693IwEPayiz{^*MQ5CS4w%9Xw*sHY{VF2m`k1#T
zw5am#fQhuT#umFlJsb*+<{X{Z8I=O2%K_P`r(?v4Gaw@ElRmS+_G_vx_w{n_$_I`@
zR(ESgC_{Hw3zi~hF9Cg_Z)Ouy5vU|*aJnbW*kNI~m}4^5U`?OCXMJHGY1%nyMx3z8
zZ-SJe<hHPck`1MapAqU6L%E(#F0pqN?O9HZhD`v4ibxqXLQq1|$&mu>RvqsD))eZD
zI0*1)r%TpN6pGGRTxhIDq`G?2Kae;Z)v~yC|LqoW=B>;O#U@(t<RFdRtqhDQwRlRu
zX0$+YUJh0=10Qjz`AgB^F><PEXl>fK2<<V`UYmF<hWkEN?(hI8tl02yebrZ1iqy4;
zpJ?K}rs(y*${=T|WgU3SM|q8XDnbm7=f8$!S=)OMS6(zIPIMkii1ee5h2(@sAlTXY
z53uuZ5&X%KMqU@kZiv6+a6R}N?5JjPA$_R#z9|0lOm$v5sUlerZeZ9h^`$oab*B12
z8v2`3ZrW_ol4?b`SodF>96S;SlN5iK{iXg<x0CfB1pk)vfgS)ledTlfoQ1HYpJ%EU
zrSQ^ge!N}ZEiC%E$$43VS+z6fb#x5grjx(mYtnz({%F@-@yBK|xxC0!G{w^eSBPVd
zxc(AC8%uudFr>A@)!?eN>eUXWvA$ySf7}*uykas6*-X}623nB6IJ&)F1MzN(DU_i>
zPM$uu`wi=0-VLP;+K47WU?r<3crz)xA!s<0jKiPfd#)5R7O}VaibFnmf+>gPQ?}@O
zg8D=x%K(_*54b^(;YY4VCyz~-Hj4!@vCS>^VuJ=aq%!Nmpb)ldw%&lY>9l%7NCCb4
za&dWm;#$J$*`7vV-i=DZ#gI5X!5a<1CdFzoW=Xm&%C{hP1%vV?PK_v)IUU?Y?1K)v
zjcgF_hEZ-!<L*fu9Piz3KIlw!MrjwMdX49xO-^Y^PAPY3U=fIkon2CiIkHn$KeuF2
zo)&Kd+T`35{4wHu^7rKQ_Yvp6MlOt}k#)-L2}7s+&&lZniIpqm#7nt6`3(7npULUY
z*;*`uKkESGQ~fJSJPPLv1>i*O!7>mC2S;zJOsLuP_7`7Y;tuYklf&ju8OXt=|6!>W
z7eV9M!bmnaO44{*pBS`%*L!U@7=SX+={}+JV}G4zfNv=pBzgLcES+M#zuFQh!)I<B
z5+!<S%v9N8RNiIQnVH7f!?liY6Q_aEN}cVu7gNE<51_>7#nRg07>1_NHtbrmroiMv
zkqx&xP&<b{N+B65Aoa~GkZxPjEz9g)3e3)W);~dU?mm?r2q?LUab6c>AbWwEWVIQ=
z@VOoxf0p(<T9Q=hGzMmnlg}_x0L(+hkCO<6f`#Ib6Fu=l6lXpS;H3%?29pbMDjB)}
z5g|i4qKNm?0d(u(1o&@Mz<m9Q4%Zwg1dhO!L_j~kQ8L1#6mszXn%-(}j7tm_ww7_y
z1BNG1-^*yi8_docndd*Kd6_TPgNb1363PVLUw`05cb}sjUh=6PZp_a~1@HUh0<qT|
zyE{TtpM}87gdLRE&k@a78@PF=Cf6>3d8noNx*iIPvZmD_&PBOQ+Y<jl?IcJB^1SlA
z^<(|QvqRfD=f`EoP3zA_?91oFY(KZS|D2XV3O{{NY#sbZ1p3iQ|7%2g>VJwr+5Z56
z9?`LWiAfDW9_XB{kKir??~+RmKoTRpm@5q&hAaEBF8^a>G=d8jN_A+9wO_G?P0TVV
zCmQ1jJSzQ)uO-eHY(~uViyL7}Qv^DGBRHP$;p3E+lApWe^gUK+!lax=g(aTDcY(G)
zi1eGga|Bi}jyH45E&kkSFMjZOEIat1S+<7s-mn85qY0a@A^fg)Tq`utN_RrZ!z*oW
zwMQ4A*fIh(le+pLWGZ@h(;InDUloBl&R^1O1V{uZ#GK*6Rcr$U!CDZHa6D@S8mjdW
zK*{xj1cBP_21sJGx2Z6>AEu(#kr9^b%?{x>+t84?V$kAJOEO+tfjG`P+D6)9SeMk^
z_?s!<U2;j*b9iw{BTwM#aEcdC!Lc>)-O}U@pyfu{SAkX*#QYmrBort|d|)C8n<}T3
zZae}eu9o(r<5J3dO^Uw$j=f<nDGwp8+RQv`vNwJ$2@}XbmB-)82;w-0-Kn|2xS8zb
z09MYG9XxqKOXcc;Cro8BSNmLXqRNd+)>(Depx8n%8Kx^dV9~)ZQtd=OsvUb#T9nLP
z3KK0lNcBAH**HjIl(p`*Oe+<C7IECTl|*daTzPKux%DXi=Yj^3<Lv$(VgEbmmGn>1
zEA$_s7qZKLk6yNaM=z;A(M#vRv|5Qcredt64$PvL!SOm;gK<B+?t36A7CBL!CIw+D
z*q3f>5$WMGO2fj-xslS?FC|Ad6I1j|c(=7&>`vyr9P@+Lc@2$*;AC}mOn!!ljpGJn
zO#VC<0IjvfI?oCbv03g8ybz77bm@-1*;D#v1oLE@AYp<AK+}|Ic18<k(QhWELm_Vk
zK41pOsziDoBqWJa8GY{salO1;)}Nt4&`UZIBsqfhQhCHg5<A4-_h=?ZfayWkP&nf?
zIL9?6=t1LCNk(G<LIO>!`R*-Z#o_C_&0--^4Qw=>EwNoM$}ZgZGggW(k@p2?lR(ty
zXTiGCGX+p)lPMb_PsrTHVV^x4_?YH<y>IDiPnACjB_FxC!3xmG9!>S<JJ`#MgY%i>
zp-9?{%2BHA4TX}V$)|rF3uX{{%iSqIj6^(z5>U7|3#5mu$i<ck#pjYgsA%3v({vE3
zy~B8zfLI+s4}W!o0mn1eHCcA*MT8&J3Kp@6KVpD_8CIgOqv{>E7DWJSjL<_^E+*b&
zi7Om~O6znr2l#TjN;E6Gu>FVI&EcQxXj(yR1t`n>ZSGyA5Jt1-@a3S=I-O~%JLPN?
z#29NkJhgJ2BXl;#^*rLN#HWUJmTY`scRuVJ_VHK^F*x#kl;b7QA4&K5-^2FLVfnw>
z5k~&gjxh8Cjg>m3(%+LVC~UjK|DJRk^R)t>I3ouvHU3Pxqw|}fO-lbY=}(c|dtc%d
zN`qe_xtYLiNltGB{Brd{GgeU2ZLQxQ`4rGsDlj=80xg&Xea&)nwhs}1L?y1IL8D-)
z;(S3jtR@AD)(6Sxah!m{Rw3&J)@r*L0LN{gE{=|u4M0Q#G>txWRXPBZY(yTdut38&
zvAk+_GkANnJUWj)-U$+aKoMO>u`?-VlXwG%>Trb8+vobY;X~nc13;zOMyO?kdI%Jr
zmCK|NEb?g&$C|7cSr~-)D!Q0#K(_u32E%N+n4$~5H$?#7p9K=OE;CA$01^<_Y_%O%
z5tZuTJSMsk4lMqt9YXg&-cp?qF>Ij^fCec9R--kOtanoH{RVUB^jzeo6TevJWw}~`
z#UDka^j(4ESowusC!(;lF<xMjjjuQ1n(qTlH+`2;UVh44kiy7X*U4u7Ssnn6yIVw%
zfIB_gOxk<Dq`1%q=iv=p6JybKzE&QgW!{8fNon&=sjcF=3XCN4Dk}X0f$d4%vXrmK
zr66F8zC@3I!AZ9tF%D7~HIRLuC1_Xx6CE9V8dy`;lWafNE-5K|1}Ti5Tes%Z9e!@V
z-28KgO$kK?bq*5-(fI<AaQ2R{^F;$G{362~vwQyyop0fouC6{TB8B8AbHw%ITS9ra
zJ$m1JJ0^pX`jS7}fI1ud61af*D#M1!=LBeKQ*|#Wq?Sh-E0+HdWIk$z8pRKI<$n#2
zEcN_a{X;uQkO>kRL3F+%1M>~+MyxM0FzMQ#*8UP2)$f;AvFO1cIiBw1$|(OJbb(^+
zT}3%jxwii^BmB_(Uxcp5#A~ao#s)NKH0@RtJ3mO)Z8u5x08t<Uv9XVP?))$MeSLq-
z4Uwqv=|$fLL_GoosvvP@X^Hb}>AHvg5*h^qzw|D9rQCiR_kIDpi5BvMWW7o^7647d
zt-`X~|3M`joP=L-^b~~pc9_tqNZep18NCLPtU(Z2y7k_*RL*lj<O^)WBK<W9A%tX2
z8++fyo#S{ex)mcbMGz7zjw&b!CMa6(1PSc-y-^O7+roIv+}X1EL(R5GyZAoo%Ov;Q
zTQ3mFIy;1^sURg3OtJ<Ejee*{z-l&7fd?j8gW3Ra5(evhA%re4$r>!k1d(ciOoyNX
z4=gkS>wMe6Nw^EF^92bq!P5tj&KIH{0T+1nU^QFA0$Aq@A=R!!)FYr+YuPI-10~_c
z!_RFXK_-Y)J7;^+0aA~gbbbR9x}Xq1q*_>fyVGuvdIU_W1qm`A$bi)&T6SPTW;vKt
zdvrEP@e(Y^Oa?(DLlJoT02X9&46<B|fz=}*L1y{Igz(ML#d}c%*2_sre0$LJfxhDM
zgChU&<+O?n>(z{gmi^VNwq?cDoWAGr)x7ab@bn?s{(8}>sN#CbuIc!C*=dmV=A+xZ
z{mqKkZpF>2?@jaZ%~}8g8)*7~@9<?KoWAnQ=4<}XUp~dku-$GYXgS<&r&w0r?!5K<
z>|J&c!q&Q%mE5_oSDaqyV^|#1d3WgEpd@ru-%I;^uVHs}?)YHu^Yf?eKsH~^ZVX3Z
zjehc~Z)(HrC*KsuMc6wOrj#B1<Y$el9?2~_o_v>C`*{ET3zfU_{ViT<%>5l^$@}}S
zfEEmqujlV$UVOiP6XSoscJdy0egAds3c%2{5AwZ#|BwQZT-25ICx^5MK?DE|1r7R`
oVWEJ3lIQ-dA3#c{f9o$G<@`VTi~skp{`L3q|DM&q_N*TMFP@=!)c^nh

literal 0
HcmV?d00001

diff --git a/docs/source/tutorials/intro-to-liquid.md b/docs/source/tutorials/intro-to-liquid.md
index 85b4d7d9a..b4f0ee08f 100644
--- a/docs/source/tutorials/intro-to-liquid.md
+++ b/docs/source/tutorials/intro-to-liquid.md
@@ -3,9 +3,9 @@ title: The Liquid Template Language
 describe: A short introduction to the Liquid template language and some simple demos.
 ---
 
-LiquidJS is a simple, expressive and safe [Shopify][shopify/liquid] / GitHub Pages compatible template engine in pure JavaScript. The purpose of this repo is to provide a standard Liquid implementation for the JavaScript community. Liquid is originally implemented in Ruby and used by GitHub Pages, Jekyll and Shopify, see [Differences with Shopify/liquid][diff].
+Liquid is a template language originally implemented in Ruby and used by Shopify, Jekyll, and GitHub Pages. LiquidJS implements it in JavaScript; see [Differences with Shopify/liquid][diff] for compatibility notes.
 
-LiquidJS syntax is relatively simple. There are 2 types of markups in LiquidJS:
+There are 2 types of markups in LiquidJS:
 
 - **Tags**. A tag consists of a tag name and optional arguments wrapped between `{%raw%}{%{%endraw%}` and `%}`.
 - **Outputs**. An output consists of a value and a list of filters, which is optional, wrapped between `{%raw%}{{{%endraw%}` and `}}`.
@@ -56,5 +56,4 @@ Typically tags appear in pairs with a start tag and a corresponding end tag. For
 
 A complete list of tags supported by LiquidJS can be found [here](../tags/overview.html).
 
-[shopify/liquid]: https://github.com/Shopify/liquid
 [diff]: ./differences.html
diff --git a/docs/themes/navy/languages/en.yml b/docs/themes/navy/languages/en.yml
index f8a787a34..1d47ded0d 100644
--- a/docs/themes/navy/languages/en.yml
+++ b/docs/themes/navy/languages/en.yml
@@ -13,10 +13,14 @@ index:
     description: 'Thanks to these wonderful people! See <a href="tutorials/contribution-guidelines.html">contribution guidelines</a> if you&#39;d like to help.'
   sponsors:
     title: Sponsors
-    description: 'If you personally love LiquidJS or it&#39;s benefiting your business, please <a href="https://github.com/sponsors/harttle">sponsor us</a>!'
+    description: 'Organizations and individuals who <a href="https://github.com/sponsors/harttle">sponsor LiquidJS</a>. Thank you!'
+  used_by:
+    title: Used by
+    description: 'Products and projects running on LiquidJS. <a href="https://github.com/harttle/liquidjs/edit/master/README.md">Open a PR</a> to add yours.'
 
 playground:
   title: Playground
+  lead: Edit a template and context JSON — rendered HTML updates as you type.
   loading: Loading...
 
 page:
diff --git a/docs/themes/navy/layout/index.swig b/docs/themes/navy/layout/index.swig
index 7b30eeabf..34af0b3d1 100644
--- a/docs/themes/navy/layout/index.swig
+++ b/docs/themes/navy/layout/index.swig
@@ -1,6 +1,6 @@
 <header id="banner" class="wrapper">
   <div class="inner inner-content">
-    <h2 id="banner-title">{{ page.subtitle }}</h2>
+    <h2 id="banner-title">{{ page.subtitle | default(config.subtitle) }}</h2>
     <div id="banner-share">{{ partial('partial/share') }}</div>
     <div id="banner-start">
       <code id="banner-start-command">npm install liquidjs</code><a id="banner-start-link" href="./tutorials/setup.html"><i class="icon-arrow-right"></i></a>
@@ -14,15 +14,15 @@
     </div>
   </div>
 </div>
-<div id="contributors-wrap">
+<div id="used-by-wrap">
   <div class="wrapper">
     <div class="inner inner-content">
       <div class="section-header">
-        <h3>{{__('index.contributors.title')}}</h3>
-        <p class="description">{{__('index.contributors.description')}}</p>
+        <h3>{{__('index.used_by.title')}}</h3>
+        <p class="description">{{__('index.used_by.description')}}</p>
       </div>
       <div class="contributors">
-        {{ partial('partial/all-contributors') }}
+        {{ partial('partial/used-by') }}
       </div>
     </div>
   </div>
@@ -40,3 +40,16 @@
     </div>
   </div>
 </div>
+<div id="contributors-wrap">
+  <div class="wrapper">
+    <div class="inner inner-content">
+      <div class="section-header">
+        <h3>{{__('index.contributors.title')}}</h3>
+        <p class="description">{{__('index.contributors.description')}}</p>
+      </div>
+      <div class="contributors">
+        {{ partial('partial/all-contributors') }}
+      </div>
+    </div>
+  </div>
+</div>
diff --git a/docs/themes/navy/layout/partial/after_footer.swig b/docs/themes/navy/layout/partial/after_footer.swig
index e6778541a..2bf8faba3 100644
--- a/docs/themes/navy/layout/partial/after_footer.swig
+++ b/docs/themes/navy/layout/partial/after_footer.swig
@@ -1,6 +1,11 @@
 {% if page.layout === 'playground' %}
 {{ js('js/liquid.browser.min.js') }}
 <script src="https://cdn.jsdelivr.net/npm/ace-builds@1.22.0/src-min/ace.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/ace-builds@1.22.0/src-min/mode-liquid.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/ace-builds@1.22.0/src-min/mode-json.js"></script>
+<script>ace.config.set('basePath', 'https://cdn.jsdelivr.net/npm/ace-builds@1.22.0/src-min/');</script>
+<script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/prism.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/prismjs@1.29.0/components/prism-markup.min.js"></script>
 {% endif %}
 
 {{ js('js/main') }}
diff --git a/docs/themes/navy/layout/partial/demo.json b/docs/themes/navy/layout/partial/demo.json
index d237b3911..20e523f8b 100644
--- a/docs/themes/navy/layout/partial/demo.json
+++ b/docs/themes/navy/layout/partial/demo.json
@@ -1,7 +1,3 @@
 {
-  "people": [
-    "alice",
-    "bob",
-    "carol"
-  ]
+  "name": "liquid"
 }
diff --git a/docs/themes/navy/layout/partial/demo.liquid b/docs/themes/navy/layout/partial/demo.liquid
index b8bf0d5ea..0b4e32285 100644
--- a/docs/themes/navy/layout/partial/demo.liquid
+++ b/docs/themes/navy/layout/partial/demo.liquid
@@ -1,9 +1 @@
-<ul>
-{%- for person in people %}
-  <li>
-    <a href="{{person | prepend: "https://example.com/"}}">
-      {{ person | capitalize }}
-    </a>
-  </li>
-{%- endfor%}
-</ul>
+<p>Hello, {{ name | capitalize }}!</p>
diff --git a/docs/themes/navy/layout/playground.swig b/docs/themes/navy/layout/playground.swig
index e09cfa1d0..c7f1ef3e4 100644
--- a/docs/themes/navy/layout/playground.swig
+++ b/docs/themes/navy/layout/playground.swig
@@ -1,21 +1,45 @@
 <div id="playground" role="main">
   <div class="wrapper">
-    <h1 class="inner">{{__('playground.title')}}</h1>
+    <header class="playground-hero inner">
+      <div class="playground-hero-text">
+        <h1>{{__('playground.title')}}</h1>
+        <p class="playground-lead">{{__('playground.lead')}}</p>
+      </div>
+      <p class="playground-version version"></p>
+    </header>
     <div class="loader" role=status aria-busy=true></div>
     <div id="editors" class="inner hide" aria-hide=true>
-      <div class="area-tpl editor-wrapper">
-        <h2>Template</h2>
-        <div class="editor" id="editorEl">{{ raw('partial/demo.liquid') }}</div>
-      </div>
-      <div class="area-data editor-wrapper">
-        <h2>Context</h2>
-        <div class="editor" id="dataEl">{{ raw('partial/demo.json') }}</div>
-      </div>
-      <div class="area-output editor-wrapper">
-        <h2>Output</h2>
-        <div class="editor" id="previewEl">{{__('playground.loading')}}</div>
+      <div class="playground-workspace">
+        <div class="playground-pane area-tpl">
+          <div class="pane-head">
+            <span class="pane-indicator" data-state="idle" aria-hidden="true"></span>
+            <h2>Template</h2>
+          </div>
+          <div class="pane-body">
+            <div class="editor" id="editorEl">{{ raw('partial/demo.liquid') }}</div>
+          </div>
+        </div>
+        <div class="playground-pane area-data">
+          <div class="pane-head">
+            <span class="pane-indicator" data-state="idle" aria-hidden="true"></span>
+            <h2>Context</h2>
+          </div>
+          <div class="pane-body">
+            <div class="editor" id="dataEl">{{ raw('partial/demo.json') }}</div>
+          </div>
+        </div>
+        <div class="playground-pane area-output">
+          <div class="pane-head">
+            <span class="pane-indicator" data-state="idle" aria-hidden="true"></span>
+            <h2>Output</h2>
+          </div>
+          <div class="pane-body">
+            <div class="output-preview" id="previewEl">
+              <pre class="highlight"><code class="language-markup" id="previewCode">{{__('playground.loading')}}</code></pre>
+            </div>
+          </div>
+        </div>
       </div>
     </div>
-    <p class="inner version"></p>
   </div>
 </div>
diff --git a/docs/themes/navy/source/css/_partial/index.styl b/docs/themes/navy/source/css/_partial/index.styl
index 082d7a927..9a1ab78e3 100644
--- a/docs/themes/navy/source/css/_partial/index.styl
+++ b/docs/themes/navy/source/css/_partial/index.styl
@@ -126,7 +126,7 @@
     background: var(--color-link-hover)
     color: #fff
 
-#sponsors-wrap, #contributors-wrap
+#used-by-wrap, #sponsors-wrap, #contributors-wrap
   background: var(--color-navy-lighter)
   border-top: 1px solid #161d24
   border-bottom: 1px solid #161d24
@@ -181,7 +181,7 @@
 
 #contributors-wrap
   border: none
-  overflow: hidden;
+  overflow: hidden
 
 .contributors
   tr
diff --git a/docs/themes/navy/source/css/_partial/playground.styl b/docs/themes/navy/source/css/_partial/playground.styl
index 953dd1e88..11d9ca349 100644
--- a/docs/themes/navy/source/css/_partial/playground.styl
+++ b/docs/themes/navy/source/css/_partial/playground.styl
@@ -1,107 +1,312 @@
 #playground
+  --playground-gap: 12px
+  --playground-radius: 10px
+  --playground-inset: 16px
   background: var(--color-content-bg)
   overflow: hidden
   box-shadow: var(--panel-shadow)
 
   .wrapper
-    margin-bottom: 40px
+    margin-bottom: 32px
+    @media mq-mobile
+      margin-bottom: 20px
+
+  .playground-hero
+    display: flex
+    flex-wrap: wrap
+    align-items: flex-end
+    justify-content: space-between
+    gap: 16px 24px
+    padding-top: 32px
+    padding-bottom: 20px
+    @media mq-mobile
+      padding-top: 16px
+      padding-bottom: 12px
+      gap: 10px
+      align-items: flex-start
+
+  .playground-hero-text
+    flex: 1 1 280px
+    min-width: 0
 
   h1
-    font-size: 36px
-    font-weight: 300
-    margin-top: 40px
-    margin-bottom: 24px
-    color: var(--color-default)
-
-  h2
-    font-size: 0.8125rem
+    font-size: 28px
     font-weight: 600
-    text-transform: uppercase
-    letter-spacing: 0.04em
-    color: var(--color-gray)
+    letter-spacing: -0.02em
+    margin: 0 0 8px
+    color: var(--color-default)
+    @media mq-mobile
+      font-size: 22px
+      margin-bottom: 4px
+
+  .playground-lead
     margin: 0
+    font-size: 15px
+    line-height: 1.5
+    color: var(--color-gray)
+    @media mq-mobile
+      font-size: 14px
+      line-height: 1.45
+
+  .playground-version
+    flex: 0 0 auto
+    margin: 0
+    font-size: 12px
+    line-height: 1.4
+    font-family: font-mono
+    padding: 6px 12px
+    border-radius: 999px
+    background: var(--playground-surface)
+    border: 1px solid var(--color-border)
+    color: var(--color-gray)
+    a
+      color: var(--color-default)
+      text-decoration: none
+      font-weight: 500
+      &:hover
+        color: var(--color-link)
+        text-decoration: none
 
   #editors
-    display: grid
-    overflow: hidden
     margin-bottom: 0
-    height: 75vh
-    min-height: 480px
+
+  .playground-workspace
+    display: grid
+    gap: var(--playground-gap)
     grid-template-columns: 1fr 1fr
     grid-template-rows: 3fr 2fr
-    grid-gap: 16px
     align-items: stretch
+    @media mq-normal
+      overflow: hidden
+      height: 75vh
+      max-height: unquote('calc(100vh - 200px)')
+      min-height: 520px
     @media mq-mobile
-      height: auto
-      min-height: 0
       grid-template-columns: 1fr
       grid-template-rows: auto
-      grid-gap: 20px
+      gap: 12px
 
   .area-tpl
     grid-row: 1
     grid-column: 1
     min-height: 0
+    --pane-dot: var(--color-link)
   .area-data
     grid-row: 2
     grid-column: 1
     min-height: 0
+    --pane-dot: var(--highlight-orange)
   .area-output
     grid-column: 2
     grid-row: 1 / -1
     min-height: 0
+    min-width: 0
+    --pane-dot: var(--highlight-green)
     @media mq-mobile
       grid-row: auto
       grid-column: 1
 
-  .editor-wrapper
+  .playground-pane
     display: flex
-    gap: 8px
     flex-direction: column
     min-height: 0
     overflow: hidden
-    .editor
-      flex: 1 1 auto
-      min-height: 0
-      position: relative
-      code-block-chrome()
-      overflow: hidden
-      @media mq-mobile
-        min-height: 240px
-    .ace_editor
-      font-family: font-mono
-      font-size: 14px
-      line-height: 1.5
-      border-radius: 6px
-    .ace_scrollbar
-      z-index: 2
+    background: var(--playground-pane-head)
+    border: 1px solid var(--code-border)
+    border-radius: var(--playground-radius)
+    box-shadow: var(--code-shadow)
 
-  .version
-    font-size: 0.8125rem
-    line-height: 1.5
+  .pane-head
+    display: flex
+    align-items: center
+    gap: 10px
+    flex-shrink: 0
+    height: 36px
+    padding: 0 var(--playground-inset)
+    border-bottom: 1px solid var(--code-border)
+    @media mq-mobile
+      height: 32px
+      padding: 0 10px
+    h2
+      font-size: 13px
+      font-weight: 600
+      letter-spacing: 0.01em
+      text-transform: none
+      color: var(--color-default)
+      margin: 0
+      @media mq-mobile
+        font-size: 12px
+
+  .pane-indicator
+    width: 8px
+    height: 8px
+    border-radius: 50%
+    flex-shrink: 0
+    background: unquote('color-mix(in srgb, var(--pane-dot) 38%, var(--color-border))')
+    transition: background 0.25s ease, box-shadow 0.25s ease, transform 0.25s ease
+
+    &[data-state="active"]
+      background: var(--pane-dot)
+      animation: playground-dot-typing 0.85s ease-in-out infinite
+
+    &[data-state="pending"]
+      background: var(--highlight-yellow)
+
+    &[data-state="ok"]
+      background: var(--highlight-green)
+      animation: playground-dot-ok 0.45s ease-out
+
+    &[data-state="error"]
+      background: var(--highlight-red)
+      animation: playground-dot-error 0.35s ease-out
+
+  .area-output .pane-indicator
+    &[data-state="pending"]
+      animation: playground-dot-pending 0.55s ease-in-out infinite
+
+  @keyframes playground-dot-typing
+    0%, 100%
+      transform: scale(1)
+      box-shadow: 0 0 0 0 unquote('color-mix(in srgb, var(--pane-dot) 0%, transparent)')
+    50%
+      transform: scale(1.2)
+      box-shadow: 0 0 0 4px unquote('color-mix(in srgb, var(--pane-dot) 28%, transparent)')
+
+  @keyframes playground-dot-pending
+    0%, 100%
+      transform: scale(1)
+      opacity: 0.75
+    50%
+      transform: scale(1.12)
+      opacity: 1
+
+  @keyframes playground-dot-ok
+    0%
+      transform: scale(0.85)
+      box-shadow: 0 0 0 0 unquote('color-mix(in srgb, var(--highlight-green) 50%, transparent)')
+    70%
+      transform: scale(1.15)
+      box-shadow: 0 0 0 5px unquote('color-mix(in srgb, var(--highlight-green) 0%, transparent)')
+    100%
+      transform: scale(1)
+      box-shadow: none
+
+  @keyframes playground-dot-error
+    0%, 100%
+      transform: translateX(0)
+    20%
+      transform: translateX(-2px)
+    40%
+      transform: translateX(2px)
+    60%
+      transform: translateX(-1px)
+    80%
+      transform: translateX(1px)
+
+  .pane-body
+    flex: 1 1 auto
+    min-height: 0
+    min-width: 0
+    display: flex
+    flex-direction: column
+    overflow: hidden
+    background: var(--highlight-background)
+
+  .area-tpl .pane-body,
+  .area-data .pane-body
+    padding: var(--playground-inset)
+    box-sizing: border-box
+    @media mq-mobile
+      padding: 12px
+
+  .area-tpl .ace_gutter,
+  .area-data .ace_gutter
+    display: none
+    width: 0
+    min-width: 0
+
+  .area-tpl .ace_editor,
+  .area-data .ace_editor,
+  .area-tpl .ace_scroller,
+  .area-data .ace_scroller,
+  .area-tpl .ace_content,
+  .area-data .ace_content,
+  .area-tpl .ace_text-layer,
+  .area-data .ace_text-layer
+    background: transparent
+
+  .editor
+    flex: 1 1 auto
+    min-height: 0
+    position: relative
+    overflow: hidden
+    @media mq-mobile
+      min-height: 180px
+
+  .output-preview
+    flex: 1 1 auto
+    min-height: 0
+    min-width: 0
+    width: 100%
+    overflow: auto
+    @media mq-mobile
+      min-height: 120px
+    pre.highlight
+      margin: 0
+      min-height: 100%
+      width: 100%
+      box-sizing: border-box
+      padding: var(--playground-inset)
+      border: none
+      box-shadow: none
+      border-radius: 0
+      background: transparent
+      color: var(--highlight-foreground)
+      overflow-x: hidden
+      overflow-y: auto
+      white-space: pre-wrap
+      overflow-wrap: break-word
+      @media mq-mobile
+        padding: 12px
+      code
+        display: block
+        width: 100%
+        box-sizing: border-box
+        font-family: font-mono
+        font-size: 14px
+        line-height: 1.55
+        color: var(--highlight-foreground)
+        background: transparent
+        padding: 0
+        white-space: inherit
+        overflow-wrap: inherit
+        @media mq-mobile
+          font-size: 13px
+
+  .ace_editor
     font-family: font-mono
-    color: var(--color-gray)
-    margin-top: 20px
-    margin-bottom: 32px
-    a
-      color: inherit
-      text-decoration: none
-      &:hover
-        color: var(--color-link)
-        text-decoration: underline
+    font-size: 14px
+    line-height: 1.55
+    border-radius: 0
+    @media mq-mobile
+      font-size: 13px
+  .ace_scrollbar
+    z-index: 2
 
   .hide
     display: none
 
   .loader
-    width: 48px
-    height: 48px
-    margin: 150px auto 200px
-    border: 3px solid var(--color-border)
+    width: 40px
+    height: 40px
+    margin: 120px auto 160px
+    border: 2px solid var(--color-border)
     border-top-color: var(--color-link)
     border-radius: 50%
-    animation: spin 0.8s infinite linear
+    animation: playground-spin 0.7s infinite linear
+    @media mq-mobile
+      margin: 60px auto 80px
 
-  @keyframes spin
+  @keyframes playground-spin
     100%
       transform: rotate(360deg)
diff --git a/docs/themes/navy/source/css/_variables.styl b/docs/themes/navy/source/css/_variables.styl
index cac6b94fe..27363cc6b 100644
--- a/docs/themes/navy/source/css/_variables.styl
+++ b/docs/themes/navy/source/css/_variables.styl
@@ -37,6 +37,8 @@ vendor-prefixes = webkit moz ms official
     --highlight-aqua: #0550ae
     --highlight-blue: #0550ae
     --highlight-purple: #8250df
+    --playground-surface: #f3f4f6
+    --playground-pane-head: #fff
 }
 
 @media (prefers-color-scheme: dark) {
@@ -75,6 +77,8 @@ vendor-prefixes = webkit moz ms official
         --highlight-aqua: #79c0ff
         --highlight-blue: #79c0ff
         --highlight-purple: #d2a8ff
+        --playground-surface: hsl(218, 26%, 10%)
+        --playground-pane-head: hsl(218, 22%, 16%)
     }
 }
 
diff --git a/docs/themes/navy/source/js/main.js b/docs/themes/navy/source/js/main.js
index b113fb27b..1d4e5eb4c 100644
--- a/docs/themes/navy/source/js/main.js
+++ b/docs/themes/navy/source/js/main.js
@@ -38,8 +38,8 @@
 
 (function() {
   // playground
-  /* global liquidjs, ace */
-  if (!location.pathname.match(/playground.html$/)) return;
+  /* global liquidjs, ace, Prism */
+  if (!/\/playground(?:\.html)?$/.test(location.pathname)) return;
   updateVersion(liquidjs.version);
   const engine = new liquidjs.Liquid({
     memoryLimit: 1e5,
@@ -48,14 +48,19 @@
   const colorScheme = window.matchMedia('(prefers-color-scheme: dark)');
   const editor = createEditor('editorEl', 'liquid');
   const dataEditor = createEditor('dataEl', 'json');
-  const preview = createEditor('previewEl', 'html');
-  preview.setReadOnly(true);
-  preview.renderer.setShowGutter(false);
-  preview.renderer.setPadding(16);
+  const previewCode = document.getElementById('previewCode');
+  const indicatorTpl = document.querySelector('.area-tpl .pane-indicator');
+  const indicatorData = document.querySelector('.area-data .pane-indicator');
+  const indicatorOutput = document.querySelector('.area-output .pane-indicator');
 
-  const editors = [editor, dataEditor, preview];
+  const editors = [editor, dataEditor];
+  let previewValue = '';
+  let hadPreview = false;
+  let renderTimer = null;
+  const RENDER_DELAY = 180;
   colorScheme.addEventListener('change', function() {
     editors.forEach(applyEditorTheme);
+    if (previewValue) setPreview(previewValue);
   });
 
   const init = parseArgs(location.hash.slice(1));
@@ -63,9 +68,11 @@
     editor.setValue(init.tpl, 1);
     dataEditor.setValue(init.data, 1);
   }
-  editor.on('change', update);
-  dataEditor.on('change', update);
-  update();
+  editor.on('change', onTemplateChange);
+  dataEditor.on('change', onContextChange);
+  editor.on('focus', function () { setIndicator(indicatorTpl, 'active'); });
+  dataEditor.on('focus', function () { setIndicator(indicatorData, 'active'); });
+  scheduleUpdate();
   ready();
 
   function ready() {
@@ -87,6 +94,8 @@
 
   function applyEditorTheme(editor) {
     editor.setTheme(getEditorTheme());
+    editor.renderer.setPadding(0);
+    editor.container.style.background = 'transparent';
   }
 
   function createEditor(id, lang) {
@@ -96,15 +105,61 @@
       fontFamily: '"Source Code Pro", ui-monospace, Monaco, Menlo, Consolas, monospace',
       fontSize: '14px',
       showPrintMargin: false,
+      showGutter: false,
+      highlightActiveLine: false,
       tabSize: 2,
       useSoftTabs: true,
-      scrollPastEnd: 0.25
+      scrollPastEnd: 0
     });
     editor.getSession().setMode('ace/mode/' + lang);
-    editor.renderer.setScrollMargin(8, 8, 0, 0);
+    editor.renderer.setShowGutter(false);
+    if (editor.renderer.$gutter) {
+      editor.renderer.$gutter.style.display = 'none';
+    }
+    editor.renderer.setScrollMargin(0, 0, 0, 0);
+    bindClipboard(editor);
     return editor;
   }
 
+  function bindClipboard(editor) {
+    editor.commands.addCommand({
+      name: 'copy',
+      bindKey: {win: 'Ctrl-C', mac: 'Command-C'},
+      exec: function (ed) {
+        const text = ed.getCopyText();
+        if (!text) return;
+        if (navigator.clipboard && window.isSecureContext) {
+          navigator.clipboard.writeText(text);
+        }
+      },
+      readOnly: true
+    });
+    editor.commands.addCommand({
+      name: 'cut',
+      bindKey: {win: 'Ctrl-X', mac: 'Command-X'},
+      exec: function (ed) {
+        const text = ed.getCopyText();
+        if (!text) return;
+        if (navigator.clipboard && window.isSecureContext) {
+          navigator.clipboard.writeText(text).then(function () {
+            ed.insert('');
+          });
+        }
+      }
+    });
+    editor.commands.addCommand({
+      name: 'paste',
+      bindKey: {win: 'Ctrl-V', mac: 'Command-V'},
+      exec: function (ed) {
+        if (navigator.clipboard && window.isSecureContext) {
+          navigator.clipboard.readText().then(function (text) {
+            ed.insert(text);
+          });
+        }
+      }
+    });
+  }
+
   function parseArgs(hash) {
     if (!hash) return;
     try {
@@ -118,16 +173,64 @@
     return utoa(obj.tpl) + ',' + utoa(obj.data);
   }
 
+  function setPreview(value) {
+    previewValue = value;
+    previewCode.textContent = value;
+    if (window.Prism) {
+      delete previewCode.dataset.highlighted;
+      window.Prism.highlightElement(previewCode);
+    }
+  }
+
+  function setIndicator(indicator, state) {
+    if (indicator) indicator.dataset.state = state;
+  }
+
+  function onTemplateChange() {
+    setIndicator(indicatorTpl, 'active');
+    if (indicatorData.dataset.state !== 'error') setIndicator(indicatorData, 'idle');
+    setIndicator(indicatorOutput, 'pending');
+    scheduleUpdate();
+  }
+
+  function onContextChange() {
+    setIndicator(indicatorData, 'active');
+    if (indicatorTpl.dataset.state !== 'error') setIndicator(indicatorTpl, 'idle');
+    setIndicator(indicatorOutput, 'pending');
+    scheduleUpdate();
+  }
+
+  function scheduleUpdate() {
+    clearTimeout(renderTimer);
+    renderTimer = setTimeout(update, RENDER_DELAY);
+  }
+
   async function update() {
     const tpl = editor.getValue();
     const data = dataEditor.getValue();
     history.replaceState({}, '', '#' + serializeArgs({tpl, data}));
+    let parsed;
     try {
-      const html = await engine.parseAndRender(tpl, JSON.parse(data));
-      preview.setValue(html, 1);
+      parsed = JSON.parse(data);
     } catch (err) {
-      preview.setValue(err.stack, 1);
-      throw err;
+      setIndicator(indicatorData, 'error');
+      setIndicator(indicatorTpl, 'idle');
+      setIndicator(indicatorOutput, 'error');
+      return;
+    }
+    try {
+      const html = await engine.parseAndRender(tpl, parsed);
+      if (html !== '' || !hadPreview) {
+        setPreview(html);
+        if (html !== '') hadPreview = true;
+      }
+      setIndicator(indicatorTpl, 'idle');
+      setIndicator(indicatorData, 'idle');
+      setIndicator(indicatorOutput, 'ok');
+    } catch (err) {
+      setIndicator(indicatorTpl, 'error');
+      setIndicator(indicatorData, 'idle');
+      setIndicator(indicatorOutput, 'error');
     }
   }
 
diff --git a/package.json b/package.json
index a99acadc7..97220efd4 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "name": "liquidjs",
   "version": "10.27.0",
   "sideEffects": false,
-  "description": "A simple, expressive and safe Shopify / Github Pages compatible template engine in pure JavaScript.",
+  "description": "A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support.",
   "main": "dist/liquid.node.js",
   "module": "dist/liquid.node.mjs",
   "es2015": "dist/liquid.browser.mjs",
@@ -29,12 +29,15 @@
     "build:min": "BUNDLES=min rollup -c rollup.config.mjs",
     "build:umd": "BUNDLES=umd rollup -c rollup.config.mjs",
     "build:charmap": "./bin/character-gen.js > src/util/character.ts",
-    "build:docs": "run-s build:docs-liquid build:contributors build:apidoc build:changelog build:docs-hexo",
+    "prepare:docs": "run-s build:docs-liquid build:contributors build:apidoc build:changelog",
+    "build:docs": "run-s prepare:docs build:docs-hexo",
     "build:docs-liquid": "cross-env BUNDLES=min rollup -c rollup.config.mjs && shx cp dist/liquid.browser.min.js docs/themes/navy/source/js/",
     "build:contributors": "node bin/build-contributors.js",
     "build:apidoc": "shx rm -rf docs/source/api && typedoc --plugin typedoc-plugin-missing-exports ./src --gitRevision master --out docs/source/api",
     "build:changelog": "node bin/build-changelog.js",
-    "build:docs-hexo": "cd docs && npm ci && npm run build && shx cp CNAME public/"
+    "build:docs-hexo": "cd docs && npm ci && npm run build && shx cp CNAME public/",
+    "serve:docs": "cd docs && npm run start",
+    "dev:docs": "run-s prepare:docs serve:docs"
   },
   "bin": {
     "liquidjs": "./bin/liquid.js",

From ed489865b64ce8f7cae2f14875e1a05742e043b3 Mon Sep 17 00:00:00 2001
From: semantic-release-bot <semantic-release-bot@martynus.net>
Date: Tue, 23 Jun 2026 10:43:45 +0000
Subject: [PATCH 60/64] chore(release): 10.27.1 [skip ci]

## [10.27.1](https://github.com/harttle/liquidjs/compare/v10.27.0...v10.27.1) (2026-06-23)

### Bug Fixes

* improve round function; improvement to [#873](https://github.com/harttle/liquidjs/issues/873) ([#901](https://github.com/harttle/liquidjs/issues/901)) ([956b51e](https://github.com/harttle/liquidjs/commit/956b51ea953eb52d9eba7409b7f51e379023fec4))
* **security:** charge pop filter allocation to memoryLimit ([#907](https://github.com/harttle/liquidjs/issues/907)) ([8a0c74a](https://github.com/harttle/liquidjs/commit/8a0c74a7fcb1671aa1dcb71ec82ba0602dc90d04))
* **strip_html:** infinite loop for strip_html ([5c3522f](https://github.com/harttle/liquidjs/commit/5c3522f33928aae66f0fe85c36e1d9015c768fe2))

### Performance Improvements

* **parser:** memoize createTrie to avoid rebuilding tries per Tokenizer ([#911](https://github.com/harttle/liquidjs/issues/911)) ([3a0d80d](https://github.com/harttle/liquidjs/commit/3a0d80d1f4526af0fbca2bb2e0a9c51669d2fd3e))
---
 CHANGELOG.md      | 14 ++++++++++++++
 package-lock.json |  4 ++--
 package.json      |  2 +-
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6c3cbb8ff..2b7c59531 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,17 @@
+## [10.27.1](https://github.com/harttle/liquidjs/compare/v10.27.0...v10.27.1) (2026-06-23)
+
+
+### Bug Fixes
+
+* improve round function; improvement to [#873](https://github.com/harttle/liquidjs/issues/873) ([#901](https://github.com/harttle/liquidjs/issues/901)) ([956b51e](https://github.com/harttle/liquidjs/commit/956b51ea953eb52d9eba7409b7f51e379023fec4))
+* **security:** charge pop filter allocation to memoryLimit ([#907](https://github.com/harttle/liquidjs/issues/907)) ([8a0c74a](https://github.com/harttle/liquidjs/commit/8a0c74a7fcb1671aa1dcb71ec82ba0602dc90d04))
+* **strip_html:** infinite loop for strip_html ([5c3522f](https://github.com/harttle/liquidjs/commit/5c3522f33928aae66f0fe85c36e1d9015c768fe2))
+
+
+### Performance Improvements
+
+* **parser:** memoize createTrie to avoid rebuilding tries per Tokenizer ([#911](https://github.com/harttle/liquidjs/issues/911)) ([3a0d80d](https://github.com/harttle/liquidjs/commit/3a0d80d1f4526af0fbca2bb2e0a9c51669d2fd3e))
+
 # [10.27.0](https://github.com/harttle/liquidjs/compare/v10.26.0...v10.27.0) (2026-05-15)
 
 
diff --git a/package-lock.json b/package-lock.json
index e0154c1ba..c9f33eabd 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "liquidjs",
-  "version": "10.27.0",
+  "version": "10.27.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "liquidjs",
-      "version": "10.27.0",
+      "version": "10.27.1",
       "license": "MIT",
       "dependencies": {
         "commander": "^10.0.0"
diff --git a/package.json b/package.json
index 97220efd4..df58cffe1 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "liquidjs",
-  "version": "10.27.0",
+  "version": "10.27.1",
   "sideEffects": false,
   "description": "A simple, expressive, extensible Liquid template engine for JavaScript — Shopify, Jekyll and GitHub Pages compatible, for Node.js, browsers, and the CLI, with TypeScript support.",
   "main": "dist/liquid.node.js",

From 568bd5f9cb99f596292c09fd70b00284b8216f0c Mon Sep 17 00:00:00 2001
From: spokodev <spoko.dev@gmail.com>
Date: Thu, 25 Jun 2026 18:19:59 +0100
Subject: [PATCH 61/64] fix(filters): modulo should follow divisor sign for
 negative operands (#922)

The `modulo` filter used JavaScript's `%` (truncated remainder, sign
follows the dividend). Shopify/Ruby Liquid uses floored modulo, where the
result takes the sign of the divisor. Since liquidjs advertises Shopify
compatibility, negative operands produced the wrong sign.

Use `((v % arg) + arg) % arg` to match Ruby's `%`. Positive-operand
results are unchanged.
---
 src/filters/math.ts                   | 2 +-
 test/integration/filters/math.spec.ts | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/filters/math.ts b/src/filters/math.ts
index cb6775bff..61b8e5a95 100644
--- a/src/filters/math.ts
+++ b/src/filters/math.ts
@@ -8,7 +8,7 @@ export const divided_by = argumentsToNumber((dividend: number, divisor: number,
 export const floor = argumentsToNumber(Math.floor)
 export const minus = argumentsToNumber((v: number, arg: number) => v - arg)
 export const plus = argumentsToNumber((lhs: number, rhs: number) => lhs + rhs)
-export const modulo = argumentsToNumber((v: number, arg: number) => v % arg)
+export const modulo = argumentsToNumber((v: number, arg: number) => ((v % arg) + arg) % arg)
 export const times = argumentsToNumber((v: number, arg: number) => v * arg)
 
 export function round (v: number, arg = 0) {
diff --git a/test/integration/filters/math.spec.ts b/test/integration/filters/math.spec.ts
index ab52cb4be..3f4f7ba0a 100644
--- a/test/integration/filters/math.spec.ts
+++ b/test/integration/filters/math.spec.ts
@@ -50,6 +50,9 @@ describe('filters/math', function () {
       expect(Number(html)).toBeCloseTo(3.357, 3)
     })
     it('should convert string', () => test('{{ "24" | modulo: "7" }}', '3'))
+    it('should follow divisor sign for negative dividend', () => test('{{ -7 | modulo: 3 }}', '2'))
+    it('should follow divisor sign for negative divisor', () => test('{{ 7 | modulo: -3 }}', '-2'))
+    it('should follow divisor sign for negative float', () => test('{{ -4.5 | modulo: 3 }}', '1.5'))
   })
   describe('plus', function () {
     it('should return "6" for 4,2', () => test('{{ 4 | plus: 2 }}', '6'))

From 8bfb6428ae7a1cb414a77acec30d26dfd28af9e2 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 26 Jun 2026 01:21:05 +0800
Subject: [PATCH 62/64] docs: add spokodev as a contributor for code (#923)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 +++
 2 files changed, 12 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 90bcb6ab2..f3725b733 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -838,6 +838,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "spokodev",
+      "name": "spokodev",
+      "avatar_url": "https://avatars.githubusercontent.com/u/239690017?v=4",
+      "profile": "https://github.com/spokodev",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,
diff --git a/README.md b/README.md
index 852d6c034..d3f638c5f 100644
--- a/README.md
+++ b/README.md
@@ -240,6 +240,9 @@ Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/talboren"><img src="https://avatars.githubusercontent.com/u/68807791?v=4?s=100" width="100px;" alt="Tal"/><br /><sub><b>Tal</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=talboren" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://filonov.dev"><img src="https://avatars.githubusercontent.com/u/813224?v=4?s=100" width="100px;" alt="Vladimir Filonov"/><br /><sub><b>Vladimir Filonov</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=VladimirFilonov" title="Code">💻</a></td>
     </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/spokodev"><img src="https://avatars.githubusercontent.com/u/239690017?v=4?s=100" width="100px;" alt="spokodev"/><br /><sub><b>spokodev</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=spokodev" title="Code">💻</a></td>
+    </tr>
   </tbody>
 </table>
 

From 552819a84b80c62306fe61072628a756272dc749 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 6 Jul 2026 20:12:09 +0800
Subject: [PATCH 63/64] fix: enforce ownPropertyOnly for inherited array
 indices (#924)

* fix: enforce ownPropertyOnly for inherited array indices

Route array index access (including negative indices, first/last, and the
first/last filters) through a shared readArrayElement helper so that
ownPropertyOnly hides prototype-inherited array indices, closing the
GHSA-fwxr-j5w2-587m bypass. The option's scope (property/index access
only, not filter transforms or iteration) is documented on the option.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(filters): invoke Array.prototype methods on unsanitized array values

Call built-ins via Array.prototype.<m>.call(...) for values that come
from scope (join, compact, concat, slice, where/reject) so an overridden
instance method on unsanitized data cannot hijack filter behavior.
Methods on freshly-created arrays are left as-is.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(filters): use String.prototype.slice for the string branch of slice

Route the non-array branch through String.prototype.slice.call so the
slice filter never dispatches through a possibly-overridden instance
method, matching the Array.prototype guard.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/context/context.spec.ts                   | 15 ++++++
 src/context/context.ts                        | 20 +++----
 src/filters/array.ts                          | 22 +++++---
 src/liquid-options.ts                         |  5 +-
 src/util/underscore.ts                        |  6 +++
 .../context/own-property-only.spec.ts         | 54 +++++++++++++++++++
 6 files changed, 103 insertions(+), 19 deletions(-)
 create mode 100644 test/integration/context/own-property-only.spec.ts

diff --git a/src/context/context.spec.ts b/src/context/context.spec.ts
index f122174c9..d8eeac978 100644
--- a/src/context/context.spec.ts
+++ b/src/context/context.spec.ts
@@ -183,6 +183,21 @@ describe('Context', function () {
       ctx.push({ foo: Object.create({ bar: 'BAR' }) })
       return expect(() => ctx.getSync(['foo', 'bar'])).toThrow(/undefined variable: foo.bar/)
     })
+    it('should return undefined for inherited array indices', function () {
+      // eslint-disable-next-line no-extend-native
+      Array.prototype[0] = 'POLLUTED'
+      try {
+        const a: number[] = []
+        a.length = 1
+        ctx.push({ foo: a })
+        expect(ctx.getSync(['foo', 0])).toEqual(undefined)
+        expect(ctx.getSync(['foo', -1])).toEqual(undefined)
+        expect(ctx.getSync(['foo', 'first'])).toEqual(undefined)
+        expect(ctx.getSync(['foo', 'last'])).toEqual(undefined)
+      } finally {
+        delete (Array.prototype as any)[0]
+      }
+    })
   })
 
   describe('.getAll()', function () {
diff --git a/src/context/context.ts b/src/context/context.ts
index b8951056f..9dcb711ea 100644
--- a/src/context/context.ts
+++ b/src/context/context.ts
@@ -3,7 +3,7 @@ import { Drop } from '../drop/drop'
 import { __assign } from 'tslib'
 import { NormalizedFullOptions, defaultOptions, RenderOptions } from '../liquid-options'
 import { createScope, Scope } from './scope'
-import { hasOwnProperty, isArray, isNil, isUndefined, isString, isFunction, toLiquid, InternalUndefinedVariableError, toValueSync, isObject, Limiter, toValue } from '../util'
+import { hasOwnProperty, isArray, isNil, isUndefined, isString, isFunction, isNumber, toLiquid, InternalUndefinedVariableError, toValueSync, isObject, Limiter, toValue, readArrayElement } from '../util'
 
 type PropertyKey = string | number;
 
@@ -125,13 +125,13 @@ export class Context {
     obj = toLiquid(obj)
     key = toValue(key) as PropertyKey
     if (isNil(obj)) return obj
-    if (isArray(obj) && (key as number) < 0) return obj[obj.length + +key]
+    if (isArray(obj) && isNumber(key)) return readArrayElement(obj, key, this.ownPropertyOnly)
     const value = readJSProperty(obj, key, this.ownPropertyOnly)
     if (value === undefined && obj instanceof Drop) return obj.liquidMethodMissing(key, this)
     if (isFunction(value)) return value.call(obj)
     if (key === 'size') return readSize(obj)
-    else if (key === 'first') return readFirst(obj)
-    else if (key === 'last') return readLast(obj)
+    else if (key === 'first') return readFirst(obj, this.ownPropertyOnly)
+    else if (key === 'last') return readLast(obj, this.ownPropertyOnly)
     return value
   }
 }
@@ -141,14 +141,14 @@ export function readJSProperty (obj: Scope, key: PropertyKey, ownPropertyOnly: b
   return obj[key]
 }
 
-function readFirst (obj: Scope) {
-  if (isArray(obj)) return obj[0]
-  return obj['first']
+function readFirst (obj: Scope, ownPropertyOnly: boolean) {
+  if (isArray(obj)) return readArrayElement(obj, 0, ownPropertyOnly)
+  return readJSProperty(obj, 'first', ownPropertyOnly)
 }
 
-function readLast (obj: Scope) {
-  if (isArray(obj)) return obj[obj.length - 1]
-  return obj['last']
+function readLast (obj: Scope, ownPropertyOnly: boolean) {
+  if (isArray(obj)) return readArrayElement(obj, -1, ownPropertyOnly)
+  return readJSProperty(obj, 'last', ownPropertyOnly)
 }
 
 function readSize (obj: Scope) {
diff --git a/src/filters/array.ts b/src/filters/array.ts
index 502af5355..e714d6588 100644
--- a/src/filters/array.ts
+++ b/src/filters/array.ts
@@ -1,4 +1,4 @@
-import { toArray, argumentsToValue, toValue, stringify, caseInsensitiveCompare, orderedCompare, isArray, isNil, last as arrayLast, isArrayLike, toEnumerable } from '../util'
+import { toArray, argumentsToValue, toValue, stringify, caseInsensitiveCompare, orderedCompare, isArray, isNil, isArrayLike, readArrayElement, toEnumerable } from '../util'
 import { arrayIncludes, equals, evalToken, isTruthy } from '../render'
 import { Value, FilterImpl } from '../template'
 import { Tokenizer } from '../parser'
@@ -10,10 +10,14 @@ export const join = argumentsToValue(function (this: FilterImpl, v: any[], arg:
   const sep = isNil(arg) ? ' ' : stringify(arg)
   const complexity = array.length * (1 + sep.length)
   this.context.memoryLimit.use(complexity)
-  return array.join(sep)
+  return Array.prototype.join.call(array, sep)
+})
+export const last = argumentsToValue(function (this: FilterImpl, v: any) {
+  return isArrayLike(v) ? readArrayElement(v, -1, this.context.ownPropertyOnly) : ''
+})
+export const first = argumentsToValue(function (this: FilterImpl, v: any) {
+  return isArrayLike(v) ? readArrayElement(v, 0, this.context.ownPropertyOnly) : ''
 })
-export const last = argumentsToValue((v: any) => isArrayLike(v) ? arrayLast(v) : '')
-export const first = argumentsToValue((v: any) => isArrayLike(v) ? v[0] : '')
 export const reverse = argumentsToValue(function (this: FilterImpl, v: any[]) {
   const array = toArray(v)
   this.context.memoryLimit.use(array.length)
@@ -66,14 +70,14 @@ export function * sum (this: FilterImpl, arr: Scope[], property?: string): Itera
 export function compact<T> (this: FilterImpl, arr: T[]) {
   const array = toArray(arr)
   this.context.memoryLimit.use(array.length)
-  return array.filter(x => !isNil(toValue(x)))
+  return Array.prototype.filter.call(array, x => !isNil(toValue(x)))
 }
 
 export function concat<T1, T2> (this: FilterImpl, v: T1[], arg: T2[] = []): (T1 | T2)[] {
   const lhs = toArray(v)
   const rhs = toArray(arg)
   this.context.memoryLimit.use(lhs.length + rhs.length)
-  return lhs.concat(rhs)
+  return Array.prototype.concat.call(lhs, rhs)
 }
 
 export function push<T> (this: FilterImpl, v: T[], arg: T): T[] {
@@ -110,7 +114,9 @@ export function slice<T> (this: FilterImpl, v: T[] | string, begin: number, leng
   if (!isArray(v)) v = stringify(v)
   begin = begin < 0 ? v.length + begin : begin
   this.context.memoryLimit.use(length)
-  return v.slice(begin, begin + length)
+  return isArray(v)
+    ? Array.prototype.slice.call(v, begin, begin + length)
+    : String.prototype.slice.call(v, begin, begin + length)
 }
 
 function expectedMatcher (this: FilterImpl, expected: any): (v: any) => boolean {
@@ -132,7 +138,7 @@ function * filter<T extends object> (this: FilterImpl, include: boolean, arr: T[
     values.push(yield evalToken(token, this.context.spawn(item)))
   }
   const matcher = expectedMatcher.call(this, expected)
-  return arr.filter((_, i) => matcher(values[i]) === include)
+  return Array.prototype.filter.call(arr, (_, i) => matcher(values[i]) === include)
 }
 
 function * filter_exp<T extends object> (this: FilterImpl, include: boolean, arr: T[], itemName: string, exp: string): IterableIterator<unknown> {
diff --git a/src/liquid-options.ts b/src/liquid-options.ts
index e6fc5d1f0..7ab1cbe2d 100644
--- a/src/liquid-options.ts
+++ b/src/liquid-options.ts
@@ -38,7 +38,10 @@ export interface LiquidOptions {
   strictVariables?: boolean;
   /** Catch all errors instead of exit upon one. Please note that render errors won't be reached when parse fails. */
   catchAllErrors?: boolean;
-  /** Hide scope variables from prototypes, useful when you're passing a not sanitized object into LiquidJS or need to hide prototypes from templates. */
+  /**
+   * Hide scope variables from prototypes, useful when you're passing a not sanitized object into LiquidJS or need to hide prototypes from templates.
+   * This only applies to property/index access on scope objects. Filter transforms and iteration operate on the resolved value with standard JavaScript semantics, so prototype-inherited array indices may still be surfaced by them.
+   */
   ownPropertyOnly?: boolean;
   /** Modifies the behavior of `strictVariables`. If set, a single undefined variable will *not* cause an exception in the context of the `if`/`elsif`/`unless` tag and the `default` filter. Instead, it will evaluate to `false` and `null`, respectively. Irrelevant if `strictVariables` is not set. Defaults to `false`. **/
   lenientIf?: boolean;
diff --git a/src/util/underscore.ts b/src/util/underscore.ts
index 665fdef6c..c60a93ebb 100644
--- a/src/util/underscore.ts
+++ b/src/util/underscore.ts
@@ -42,6 +42,12 @@ export function stringify (value: any): string {
   return String(value)
 }
 
+export function readArrayElement (arr: any[], index: number, ownPropertyOnly: boolean) {
+  if (index < 0) index = arr.length + index
+  if (ownPropertyOnly && !hasOwnProperty.call(arr, index)) return undefined
+  return arr[index]
+}
+
 export function toEnumerable<T = unknown> (val: any): T[] {
   val = toValue(val)
   if (isArray(val)) return val
diff --git a/test/integration/context/own-property-only.spec.ts b/test/integration/context/own-property-only.spec.ts
new file mode 100644
index 000000000..1d5c1dfc1
--- /dev/null
+++ b/test/integration/context/own-property-only.spec.ts
@@ -0,0 +1,54 @@
+import { Liquid } from '../../../src/liquid'
+
+describe('ownPropertyOnly / inherited array indices', function () {
+  const engine = new Liquid({ ownPropertyOnly: true })
+
+  function pollutedArrays () {
+    // eslint-disable-next-line no-extend-native
+    Array.prototype[0] = 'ARRAY_PROTO_POLLUTED'
+    ;(Object.prototype as any).secret = 'OBJECT_PROTO_POLLUTED'
+    const a: any[] = []
+    a.length = 1
+    const o = {}
+    return {
+      a,
+      o,
+      cleanup () {
+        delete (Array.prototype as any)[0]
+        delete (Object.prototype as any).secret
+      }
+    }
+  }
+
+  const cases: [string, (ctx: ReturnType<typeof pollutedArrays>) => object, string][] = [
+    ['{{ a[0] }}', ({ a }) => ({ a }), ''],
+    ['{{ a[-1] }}', ({ a }) => ({ a }), ''],
+    ['{{ o.secret }}', ({ o }) => ({ o }), ''],
+    ['{{ a.first }}', ({ a }) => ({ a }), ''],
+    ['{{ a.last }}', ({ a }) => ({ a }), ''],
+    ['{{ a | first }}', ({ a }) => ({ a }), ''],
+    ['{{ a | last }}', ({ a }) => ({ a }), ''],
+    ['{% assign x = a | first %}{{ x }}', ({ a }) => ({ a }), '']
+  ]
+
+  it.each(cases)('%s', function (src, scopeFn, expected) {
+    const ctx = pollutedArrays()
+    try {
+      expect(engine.parseAndRenderSync(src, scopeFn(ctx))).toBe(expected)
+    } finally {
+      ctx.cleanup()
+    }
+  })
+
+  it('still allows array length and size', function () {
+    const { a, cleanup } = pollutedArrays()
+    try {
+      expect(engine.parseAndRenderSync('{{ a.size }}', { a })).toBe('1')
+      const arr = [1, 2]
+      expect(engine.parseAndRenderSync('{{ arr | first }}', { arr })).toBe('1')
+      expect(engine.parseAndRenderSync('{{ arr[-1] }}', { arr })).toBe('2')
+    } finally {
+      cleanup()
+    }
+  })
+})

From 7ab49f999ac045ec1e87f3a7a9fd68dd9e8602b3 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Mon, 6 Jul 2026 23:54:00 +0800
Subject: [PATCH 64/64] fix: charge join/json/inspect filters by produced
 output size (#925)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fix(filters): charge join/array_to_sentence_string by output size

join charged memoryLimit by array element count, not by the string it
produces, letting concat doubling (cheap reference copies) inflate an
array's element count and then materialize a huge string via join far
past the configured memoryLimit (GHSA-4r6h-5v86-94p3). Charge by the
sum of stringified element lengths plus separators before allocating.
Apply the same fix to the sibling array_to_sentence_string filter.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(filters): simplify join output-size accounting

Sum stringified element lengths in a single pass and keep the guarded
Array.prototype.join for the result, instead of building an intermediate
parts array.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(filters): charge json/jsonify/inspect serialization to memoryLimit

json/jsonify/inspect serialized values without charging memoryLimit, so
a concat-doubled array (cheap reference copies) could be materialized
into a huge JSON string past the configured limit — the same unbounded
class as the join bug (GHSA-4r6h-5v86-94p3). Charge via a JSON.stringify
replacer that accounts string lengths as it walks, aborting mid-
serialization instead of allocating the full blob first.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(memory): charge rendered output to memoryLimit at emission

Move output-length accounting into the emitters, which charge each
written chunk against ctx.memoryLimit right before it reaches the
result string or stream. Filters/tags now only pre-charge the extra
working memory they allocate apart from that output, so join drops its
bespoke output-size counting and charges array.length like its siblings.

The block.super capture emitter intentionally omits the limiter to
avoid double-counting content that is re-emitted through the final
emitter.

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(filters): rely on emitter output charge for json/inspect/array_to_sentence_string

With rendered output charged at emission, these filters no longer need
bespoke output-size counting: the emitted case is covered by the final
emitter. Revert json/inspect to their original form and array_to_sentence_string
to its element-count charge, dropping the non-emitted `| size` guards.

Co-authored-by: Cursor <cursoragent@cursor.com>

* revert(memory): drop emitter output charge, restore filter output-size accounting

join/array_to_sentence_string/json/inspect charge memoryLimit by the
string they materialize (not element count), so discarded results like
{% assign out = a | join %}{{ out | size }} are still bounded.

Remove the emitter-level limiter added in 2f343f063; it cannot catch
materialized-but-not-emitted values.

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(filters): charge json/inspect replacer by serialized node size

Replace the flat 1-unit charge for non-string JSON nodes with per-type
estimates (primitives via JSON.stringify length, containers by structure).

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/filters/array.ts                |  5 ++--
 src/filters/misc.ts                 | 34 ++++++++++++++++++++----
 src/filters/string.ts               |  4 ++-
 test/integration/liquid/dos.spec.ts | 41 +++++++++++++++++++++++++++++
 4 files changed, 76 insertions(+), 8 deletions(-)

diff --git a/src/filters/array.ts b/src/filters/array.ts
index e714d6588..57a7d802d 100644
--- a/src/filters/array.ts
+++ b/src/filters/array.ts
@@ -8,8 +8,9 @@ import { EmptyDrop } from '../drop'
 export const join = argumentsToValue(function (this: FilterImpl, v: any[], arg: string) {
   const array = toArray(v)
   const sep = isNil(arg) ? ' ' : stringify(arg)
-  const complexity = array.length * (1 + sep.length)
-  this.context.memoryLimit.use(complexity)
+  let outputSize = sep.length * Math.max(array.length - 1, 0)
+  for (let i = 0; i < array.length; i++) outputSize += String(array[i]).length
+  this.context.memoryLimit.use(outputSize)
   return Array.prototype.join.call(array, sep)
 })
 export const last = argumentsToValue(function (this: FilterImpl, v: any) {
diff --git a/src/filters/misc.ts b/src/filters/misc.ts
index 57ed57812..447376550 100644
--- a/src/filters/misc.ts
+++ b/src/filters/misc.ts
@@ -2,6 +2,18 @@ import { isFalsy } from '../render/boolean'
 import { identify, isArray, isString, toValue } from '../util/underscore'
 import { FilterImpl } from '../template'
 
+function chargeJsonReplacerValue (memoryLimit: { use(count: number): void }, val: unknown) {
+  if (typeof val === 'string') {
+    memoryLimit.use(val.length)
+  } else if (val === null || typeof val === 'number' || typeof val === 'boolean') {
+    memoryLimit.use(JSON.stringify(val).length)
+  } else if (Array.isArray(val)) {
+    memoryLimit.use(val.length + 1)
+  } else if (typeof val === 'object') {
+    memoryLimit.use(2)
+  }
+}
+
 function defaultFilter<T1 extends boolean, T2> (this: FilterImpl, value: T1, defaultValue: T2, ...args: Array<[string, any]>): T1 | T2 {
   value = toValue(value)
   if (isArray(value) || isString(value)) return value.length ? value : defaultValue
@@ -9,18 +21,30 @@ function defaultFilter<T1 extends boolean, T2> (this: FilterImpl, value: T1, def
   return isFalsy(value, this.context) ? defaultValue : value
 }
 
-function json (value: any, space = 0) {
-  return JSON.stringify(value, null, space)
+function json (this: FilterImpl, value: any, space = 0) {
+  const memoryLimit = this.context.memoryLimit
+  return JSON.stringify(value, (_key, val) => {
+    chargeJsonReplacerValue(memoryLimit, val)
+    return val
+  }, space)
 }
 
-function inspect (value: any, space = 0) {
+function inspect (this: FilterImpl, value: any, space = 0) {
+  const memoryLimit = this.context.memoryLimit
   const ancestors: object[] = []
   return JSON.stringify(value, function (this: unknown, _key: unknown, value: any) {
-    if (typeof value !== 'object' || value === null) return value
+    if (typeof value !== 'object' || value === null) {
+      chargeJsonReplacerValue(memoryLimit, value)
+      return value
+    }
     // `this` is the object that value is contained in, i.e., its direct parent.
     while (ancestors.length > 0 && ancestors[ancestors.length - 1] !== this) ancestors.pop()
-    if (ancestors.includes(value)) return '[Circular]'
+    if (ancestors.includes(value)) {
+      memoryLimit.use('[Circular]'.length)
+      return '[Circular]'
+    }
     ancestors.push(value)
+    chargeJsonReplacerValue(memoryLimit, value)
     return value
   }, space)
 }
diff --git a/src/filters/string.ts b/src/filters/string.ts
index f96d4b492..d0c59708e 100644
--- a/src/filters/string.ts
+++ b/src/filters/string.ts
@@ -209,7 +209,9 @@ export function number_of_words (this: FilterImpl, input: string, mode?: 'cjk' |
 
 export function array_to_sentence_string (this: FilterImpl, array: unknown[], connector = 'and') {
   connector = stringify(connector)
-  this.context.memoryLimit.use(array.length + connector.length)
+  let outputSize = connector.length + array.length * 2
+  for (let i = 0; i < array.length; i++) outputSize += stringify(array[i]).length
+  this.context.memoryLimit.use(outputSize)
   switch (array.length) {
     case 0:
       return ''
diff --git a/test/integration/liquid/dos.spec.ts b/test/integration/liquid/dos.spec.ts
index 2aea12c48..65d78adb5 100644
--- a/test/integration/liquid/dos.spec.ts
+++ b/test/integration/liquid/dos.spec.ts
@@ -89,6 +89,47 @@ describe('DoS related', function () {
       const liquid = new Liquid({ memoryLimit: 100 })
       await expect(liquid.parseAndRender('{{ array | sample: 1 | size }}', { array })).rejects.toThrow('memory alloc limit exceeded')
     })
+    it('should charge join by produced output size, not element count', () => {
+      const array = ['a'.repeat(100), 'b'.repeat(100)]
+      const liquid = new Liquid({ memoryLimit: 100 })
+      expect(() => liquid.parseAndRenderSync('{{ array | join: "" }}', { array }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should allow join within memoryLimit', () => {
+      const array = ['a'.repeat(20), 'b'.repeat(20)]
+      const liquid = new Liquid({ memoryLimit: 100 })
+      expect(liquid.parseAndRenderSync('{{ array | join: "" }}', { array })).toBe('a'.repeat(20) + 'b'.repeat(20))
+    })
+    it('should prevent concat doubling from bypassing join memoryLimit', () => {
+      const liquid = new Liquid({ memoryLimit: 1e4 })
+      const src = '{%- assign a = s | split: "NOSEP" -%}' +
+        '{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}' +
+        '{{ a | join: "" | size }}'
+      expect(() => liquid.parseAndRenderSync(src, { s: 'a'.repeat(5000) }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should charge array_to_sentence_string by produced output size', () => {
+      const array = ['a'.repeat(100), 'b'.repeat(100), 'c'.repeat(100)]
+      const liquid = new Liquid({ memoryLimit: 100 })
+      expect(() => liquid.parseAndRenderSync('{{ array | array_to_sentence_string }}', { array }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should charge json serialization of concat-doubled arrays', () => {
+      const liquid = new Liquid({ memoryLimit: 1e4 })
+      const src = '{%- assign a = s | split: "NOSEP" -%}' +
+        '{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}' +
+        '{{ a | json | size }}'
+      expect(() => liquid.parseAndRenderSync(src, { s: 'a'.repeat(5000) }))
+        .toThrow('memory alloc limit exceeded')
+    })
+    it('should charge inspect serialization of concat-doubled arrays', () => {
+      const liquid = new Liquid({ memoryLimit: 1e4 })
+      const src = '{%- assign a = s | split: "NOSEP" -%}' +
+        '{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}{%- assign a = a | concat: a -%}' +
+        '{{ a | inspect | size }}'
+      expect(() => liquid.parseAndRenderSync(src, { s: 'a'.repeat(5000) }))
+        .toThrow('memory alloc limit exceeded')
+    })
     it('should charge strip_html input length to memoryLimit', () => {
       const liquid = new Liquid({ memoryLimit: 100 })
       expect(() => liquid.parseAndRenderSync('{{ s | strip_html }}', { s: 'a'.repeat(200) }))