chore(release): 9.19.0 [skip ci]

# [9.19.0](https://github.com/harttle/liquidjs/compare/v9.18.0...v9.19.0) (2020-12-18) ### Bug Fixes * lint ([de32259](https://github.com/harttle/liquidjs/commit/de32259)) * move offset adding complexity inside TimezoneDate ([26b2175](https://github.com/harttle/liquidjs/commit/26b2175)) * simpler timezone regex and non-null offset ([e3ecfe3](https://github.com/harttle/liquidjs/commit/e3ecfe3)) ### Features * add preserveTimezones option ([d70cd2a](https://github.com/harttle/liquidjs/commit/d70cd2a)) * parse and handle date timezone offsets ([c16c787](https://github.com/harttle/liquidjs/commit/c16c787))
fix: lint
2026-09-12 19:00:39 -07:00 · 2020-12-18 14:07:14 +00:00 · 2020-12-18 22:03:58 +08:00 · 2020-12-18 22:03:58 +08:00 · 2020-12-18 22:03:58 +08:00 · 2020-12-18 22:03:58 +08:00
551 changed files with 36366 additions and 43035 deletions
@@ -0,0 +1,349 @@
+{
+  "projectName": "liquidjs",
+  "projectOwner": "harttle",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": false,
+  "commitConvention": "angular",
+  "contributors": [
+    {
+      "login": "harttle",
+      "name": "Jun Yang",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4427974?v=4",
+      "profile": "https://harttle.land",
+      "contributions": [
+        "maintenance",
+        "code"
+      ]
+    },
+    {
+      "login": "chenos",
+      "name": "chenos",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2993310?v=4",
+      "profile": "https://github.com/chenos",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "zachleat",
+      "name": "Zach Leatherman",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/39355?v=4",
+      "profile": "https://zachleat.com/",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "thardy",
+      "name": "Tim Hardy",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/120636?v=4",
+      "profile": "https://github.com/thardy",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "paulrobertlloyd",
+      "name": "Paul Robert Lloyd",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/813383?v=4",
+      "profile": "https://paulrobertlloyd.com/",
+      "contributions": [
+        "code",
+        "bug"
+      ]
+    },
+    {
+      "login": "aleclarson",
+      "name": "Alec Larson",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/1925840?v=4",
+      "profile": "https://twitter.com/alecdotbiz",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pmalouin",
+      "name": "Patrick Malouin",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1411117?v=4",
+      "profile": "https://github.com/pmalouin",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "jaswrks",
+      "name": "jaswrks",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1563559?v=4",
+      "profile": "https://jaswrks.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "oott123",
+      "name": "三三",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/905663?v=4",
+      "profile": "https://oott123.com",
+      "contributions": [
+        "code",
+        "ideas"
+      ]
+    },
+    {
+      "login": "ssendev",
+      "name": "ssendev",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/450793?v=4",
+      "profile": "https://github.com/ssendev",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "wojtask9",
+      "name": "wojtask9",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/6099236?v=4",
+      "profile": "https://github.com/wojtask9",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "thelornenelson",
+      "name": "Andrew Barclay",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/24596583?v=4",
+      "profile": "https://github.com/thelornenelson",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "cmawhorter",
+      "name": "Cory Mawhorter",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/142338?v=4",
+      "profile": "https://www.stam.pr/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "thehappybug",
+      "name": "Mehdi Jaffery",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3393530?v=4",
+      "profile": "https://github.com/thehappybug",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "robinbijlani",
+      "name": "Robin Bijlani",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2503108?v=4",
+      "profile": "https://github.com/robinbijlani",
+      "contributions": [
+        "code",
+        "bug"
+      ]
+    },
+    {
+      "login": "ryaninvents",
+      "name": "Ryan Kennedy",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8356669?v=4",
+      "profile": "https://www.rmkennedy.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "strax",
+      "name": "Sami Kukkonen",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/587213?v=4",
+      "profile": "https://github.com/strax",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ScottFreeCode",
+      "name": "Scott Santucci",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/16506071?v=4",
+      "profile": "https://ScottFreeCode.github.io/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "stevenanthonyrevo",
+      "name": "Steven ",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8505293?v=4",
+      "profile": "http://stevenrescigno.com",
+      "contributions": [
+        "example",
+        "code"
+      ]
+    },
+    {
+      "login": "azu",
+      "name": "azu",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/19714?v=4",
+      "profile": "https://efcl.info/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "wyozi",
+      "name": "Joonas",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4894573?v=4",
+      "profile": "https://github.com/wyozi",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jamelait",
+      "name": "Jamel A.",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/14369255?v=4",
+      "profile": "https://github.com/jamelait",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "brandonpittman",
+      "name": "Brandon Pittman",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/967145?v=4",
+      "profile": "https://brandonpittman.net",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tgrandgent",
+      "name": "tgrandgent",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/17069042?v=4",
+      "profile": "https://github.com/tgrandgent",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "mastodon0",
+      "name": "Martin Schuster",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7924332?v=4",
+      "profile": "https://github.com/mastodon0",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "richardo2016",
+      "name": "Ray",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/6339390?v=4",
+      "profile": "http://js.chenlei.me",
+      "contributions": [
+        "test",
+        "code"
+      ]
+    },
+    {
+      "login": "CriGoT",
+      "name": "Cristofer Gonzales",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1936786?v=4",
+      "profile": "https://github.com/CriGoT",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "cfjedimaster",
+      "name": "Raymond Camden",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/393660?v=4",
+      "profile": "https://www.raymondcamden.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "stedman",
+      "name": "Steve Stedman",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/183122?v=4",
+      "profile": "https://stedman.dev",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "aciccarello",
+      "name": "Anthony Ciccarello",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/11273838?v=4",
+      "profile": "https://ciccarello.me",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "TrySound",
+      "name": "Bogdan Chadkin",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5635476?v=4",
+      "profile": "https://twitter.com/IAmTrySound",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tejasmanohar",
+      "name": "Tejas Manohar",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5959235?v=4",
+      "profile": "https://hightouch.io",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pdehaan",
+      "name": "Peter deHaan",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/557895?v=4",
+      "profile": "http://about.me/peterdehaan",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "amit777",
+      "name": "amit777",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2703309?v=4",
+      "profile": "https://github.com/amit777",
+      "contributions": [
+        "code",
+        "financial"
+      ]
+    },
+    {
+      "login": "sschuldenzucker",
+      "name": "Steffen Schuldenzucker",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1100776?v=4",
+      "profile": "http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "Pixcell",
+      "name": "Pixcell",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4005291?v=4",
+      "profile": "https://github.com/Pixcell",
+      "contributions": [
+        "code"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true
+}
@@ -1,4 +1,5 @@
 node_modules
 dist
-build
+demo
 coverage
+docs
@@ -1,16 +1,40 @@
 {
-  "extends": "standard",
+  "extends": ["standard", "plugin:@typescript-eslint/recommended"],
  "env": {
+    "mocha": true,
    "es6": true,
    "browser": true,
    "node": true
  },
+  "parser": "@typescript-eslint/parser",
  "plugins": [
+    "mocha",
    "standard",
+    "@typescript-eslint",
    "promise"
  ],
  "rules": {
    "no-var": 2,
-    "prefer-const": 2
-  }
+    "prefer-const": 2,
+    "no-unused-vars": "off",
+    "indent": "off",
+    "no-dupe-class-members": "off",
+    "no-useless-constructor": "off",
+    "@typescript-eslint/indent": ["error", 2],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-empty-function": "off",
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-object-literal-type-assertion": "off",
+    "@typescript-eslint/no-use-before-define": "off",
+    "@typescript-eslint/interface-name-prefix": "off",
+    "@typescript-eslint/no-non-null-assertion": "off",
+    "import/export": "off",
+    "@typescript-eslint/no-unused-vars": ["error", { "vars": "all", "args": "none", "ignoreRestSiblings": false }]
+  },
+  "overrides": [{
+    "files": ["**/*.js", "*.js"],
+    "rules": {
+      "@typescript-eslint/no-var-requires": "off"
+    }
+  }]
 }
@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+# github: harttle
+patreon: harttle
+open_collective: liquidjs
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
@@ -2,13 +2,18 @@
 *.log
 npm-debug.log*

-# tests
+# cache
+.rpt2_cache
 coverage/
 .nyc_output/

 # modules
 node_modules/
-build/
+dist/
+demo/*/package-lock.json
+demo/*/yarn.json

 # editors
 .*.swp
+.vscode
+
@@ -1,3 +0,0 @@
-/coverage
-/test
-.*
@@ -1,19 +1,28 @@
 language: node_js
 node_js:
-  - "8"
-  - "6"
-  - "4"
+    - "10"
+    - "8"
 jobs:
  include:
    - stage: test
      name: 'Linting'
-      script: npm run lint
+      script:
+        - npm run lint
    - name: 'Coverage'
-      script: npm run coverage && npm run coveralls
+      script: npm run coverage-coveralls
    - stage: release
+      name: 'Publish'
      if: branch = master
-      script: skip
+      script: npm run build
      deploy:
        provider: script
        skip_cleanup: true
        script: npx semantic-release
+    - name: 'Document'
+      if: branch = master
+      script: npm run build-docs
+      deploy:
+        skip_cleanup: true
+        provider: pages
+        github_token: $GH_TOKEN
+        local_dir: docs/public
@@ -1,3 +1,584 @@
+# [9.19.0](https://github.com/harttle/liquidjs/compare/v9.18.0...v9.19.0) (2020-12-18)
+
+
+### Bug Fixes
+
+* lint ([de32259](https://github.com/harttle/liquidjs/commit/de32259))
+* move offset adding complexity inside TimezoneDate ([26b2175](https://github.com/harttle/liquidjs/commit/26b2175))
+* simpler timezone regex and non-null offset ([e3ecfe3](https://github.com/harttle/liquidjs/commit/e3ecfe3))
+
+
+### Features
+
+* add preserveTimezones option ([d70cd2a](https://github.com/harttle/liquidjs/commit/d70cd2a))
+* parse and handle date timezone offsets ([c16c787](https://github.com/harttle/liquidjs/commit/c16c787))
+
+# [9.18.0](https://github.com/harttle/liquidjs/compare/v9.17.0...v9.18.0) (2020-12-17)
+
+
+### Bug Fixes
+
+* address refactor comments ([6a0ad10](https://github.com/harttle/liquidjs/commit/6a0ad10))
+
+
+### Features
+
+* add option for keeping variable type in output ([cd92e77](https://github.com/harttle/liquidjs/commit/cd92e77))
+
+# [9.17.0](https://github.com/harttle/liquidjs/compare/v9.16.1...v9.17.0) (2020-12-07)
+
+
+### Bug Fixes
+
+* elsif is not supported for unless, fixes [#268](https://github.com/harttle/liquidjs/issues/268) ([2bbf501](https://github.com/harttle/liquidjs/commit/2bbf501))
+* enforce string-type pattern in `replace`, fixes [#243](https://github.com/harttle/liquidjs/issues/243) ([c8afa39](https://github.com/harttle/liquidjs/commit/c8afa39))
+* raw block not ignoring {% characters, fixes [#263](https://github.com/harttle/liquidjs/issues/263) ([a492d8e](https://github.com/harttle/liquidjs/commit/a492d8e))
+
+
+### Features
+
+* passing liquid to FilterImpl, closes [#277](https://github.com/harttle/liquidjs/issues/277) ([f9f595f](https://github.com/harttle/liquidjs/commit/f9f595f))
+
+## [9.16.1](https://github.com/harttle/liquidjs/compare/v9.16.0...v9.16.1) (2020-10-09)
+
+
+### Bug Fixes
+
+* braced property access ([18a807e](https://github.com/harttle/liquidjs/commit/18a807e))
+
+# [9.16.0](https://github.com/harttle/liquidjs/compare/v9.15.1...v9.16.0) (2020-10-08)
+
+
+### Features
+
+* support jsTruthy, [#255](https://github.com/harttle/liquidjs/issues/255) [#257](https://github.com/harttle/liquidjs/issues/257) ([72ee7b4](https://github.com/harttle/liquidjs/commit/72ee7b4))
+
+## [9.15.1](https://github.com/harttle/liquidjs/compare/v9.15.0...v9.15.1) (2020-10-03)
+
+
+### Bug Fixes
+
+* allow quoted variable name in capture, fixes [#252](https://github.com/harttle/liquidjs/issues/252) ([5b3f419](https://github.com/harttle/liquidjs/commit/5b3f419))
+
+# [9.15.0](https://github.com/harttle/liquidjs/compare/v9.14.1...v9.15.0) (2020-08-04)
+
+
+### Features
+
+* export toPromise and toValue, see [#158](https://github.com/harttle/liquidjs/issues/158) ([2e5ab98](https://github.com/harttle/liquidjs/commit/2e5ab98))
+
+## [9.14.1](https://github.com/harttle/liquidjs/compare/v9.14.0...v9.14.1) (2020-07-08)
+
+
+### Bug Fixes
+
+* enumerate Promises (e.g. in for & tablerow) ([#237](https://github.com/harttle/liquidjs/issues/237)) ([941dd66](https://github.com/harttle/liquidjs/commit/941dd66))
+
+# [9.14.0](https://github.com/harttle/liquidjs/compare/v9.13.0...v9.14.0) (2020-06-25)
+
+
+### Features
+
+* setup universal browser and node builds ([6cf6ffa](https://github.com/harttle/liquidjs/commit/6cf6ffa))
+
+# [9.13.0](https://github.com/harttle/liquidjs/compare/v9.12.0...v9.13.0) (2020-06-25)
+
+
+### Features
+
+* async filters, closes [#232](https://github.com/harttle/liquidjs/issues/232) ([e36f3ff](https://github.com/harttle/liquidjs/commit/e36f3ff))
+
+# [9.12.0](https://github.com/harttle/liquidjs/compare/v9.11.11...v9.12.0) (2020-05-15)
+
+
+### Features
+
+* sort by key, see [#227](https://github.com/harttle/liquidjs/issues/227) ([4f17c94](https://github.com/harttle/liquidjs/commit/4f17c94))
+
+## [9.11.11](https://github.com/harttle/liquidjs/compare/v9.11.10...v9.11.11) (2020-05-01)
+
+
+### Bug Fixes
+
+* properly treat unicode blanks, fixes [#221](https://github.com/harttle/liquidjs/issues/221) ([673b015](https://github.com/harttle/liquidjs/commit/673b015))
+
+## [9.11.10](https://github.com/harttle/liquidjs/compare/v9.11.9...v9.11.10) (2020-04-03)
+
+
+### Bug Fixes
+
+* respect cache render options ([a93f11d](https://github.com/harttle/liquidjs/commit/a93f11d))
+
+## [9.11.9](https://github.com/harttle/liquidjs/compare/v9.11.8...v9.11.9) (2020-03-31)
+
+
+### Bug Fixes
+
+* coerce to Array in `map` and `where` filter ([c923598](https://github.com/harttle/liquidjs/commit/c923598))
+
+## [9.11.8](https://github.com/harttle/liquidjs/compare/v9.11.7...v9.11.8) (2020-03-31)
+
+
+### Bug Fixes
+
+* throw an error if : omitted unintentionally, [#212](https://github.com/harttle/liquidjs/issues/212), [#208](https://github.com/harttle/liquidjs/issues/208) ([8daf281](https://github.com/harttle/liquidjs/commit/8daf281))
+
+## [9.11.7](https://github.com/harttle/liquidjs/compare/v9.11.6...v9.11.7) (2020-03-28)
+
+
+### Bug Fixes
+
+* try fix travis ([b3db412](https://github.com/harttle/liquidjs/commit/b3db412))
+
+## [9.11.6](https://github.com/harttle/liquidjs/compare/v9.11.5...v9.11.6) (2020-03-25)
+
+
+### Bug Fixes
+
+* default filter not applied for empty array ([c371762](https://github.com/harttle/liquidjs/commit/c371762))
+
+## [9.11.5](https://github.com/harttle/liquidjs/compare/v9.11.4...v9.11.5) (2020-03-24)
+
+
+### Bug Fixes
+
+* throws on invalid arguments for prepend/append, fixes [#208](https://github.com/harttle/liquidjs/issues/208) ([479c633](https://github.com/harttle/liquidjs/commit/479c633))
+
+## [9.11.4](https://github.com/harttle/liquidjs/compare/v9.11.3...v9.11.4) (2020-03-23)
+
+
+### Bug Fixes
+
+* return variable name in include error ([93433a8](https://github.com/harttle/liquidjs/commit/93433a8))
+
+## [9.11.3](https://github.com/harttle/liquidjs/compare/v9.11.2...v9.11.3) (2020-03-14)
+
+
+### Performance Improvements
+
+* introduce AST to avoid reparse ([d2d6a38](https://github.com/harttle/liquidjs/commit/d2d6a38))
+* remove instanceof DelimitedToken ([1673e84](https://github.com/harttle/liquidjs/commit/1673e84))
+
+## [9.11.2](https://github.com/harttle/liquidjs/compare/v9.11.1...v9.11.2) (2020-03-14)
+
+
+### Performance Improvements
+
+* remove transient strings to reduce memory ([3dfdf98](https://github.com/harttle/liquidjs/commit/3dfdf98))
+
+## [9.11.1](https://github.com/harttle/liquidjs/compare/v9.11.0...v9.11.1) (2020-03-09)
+
+
+### Bug Fixes
+
+* concurrent write on LRU cache ([#200](https://github.com/harttle/liquidjs/issues/200)) ([6de9338](https://github.com/harttle/liquidjs/commit/6de9338))
+
+# [9.11.0](https://github.com/harttle/liquidjs/compare/v9.10.0...v9.11.0) (2020-03-04)
+
+
+### Bug Fixes
+
+* `Buffer not defined` for browser bundles, fixes [#197](https://github.com/harttle/liquidjs/issues/197) ([65b849c](https://github.com/harttle/liquidjs/commit/65b849c))
+* stable sort for undefined keys, fixes [#191](https://github.com/harttle/liquidjs/issues/191) ([f57156b](https://github.com/harttle/liquidjs/commit/f57156b))
+
+
+### Features
+
+* async cache.read()/write(), remove .has() ([61dac49](https://github.com/harttle/liquidjs/commit/61dac49))
+
+# [9.10.0](https://github.com/harttle/liquidjs/compare/v9.9.0...v9.10.0) (2020-03-03)
+
+
+### Features
+
+* support json filter, closes [#192](https://github.com/harttle/liquidjs/issues/192) ([aa27a6c](https://github.com/harttle/liquidjs/commit/aa27a6c))
+* with & for in `render` tag, closes [#195](https://github.com/harttle/liquidjs/issues/195) ([6ea6881](https://github.com/harttle/liquidjs/commit/6ea6881))
+
+# [9.9.0](https://github.com/harttle/liquidjs/compare/v9.8.0...v9.9.0) (2020-03-02)
+
+
+### Features
+
+* move filters/tags to instances, fixes [#188](https://github.com/harttle/liquidjs/issues/188) ([df8a919](https://github.com/harttle/liquidjs/commit/df8a919))
+
+# [9.8.0](https://github.com/harttle/liquidjs/compare/v9.7.2...v9.8.0) (2020-02-20)
+
+
+### Features
+
+* "today" when using date filter, fixes [#193](https://github.com/harttle/liquidjs/issues/193) ([185312d](https://github.com/harttle/liquidjs/commit/185312d))
+
+## [9.7.2](https://github.com/harttle/liquidjs/compare/v9.7.1...v9.7.2) (2020-02-20)
+
+
+### Bug Fixes
+
+* add funding entry to show up in npm fund command ([40095a8](https://github.com/harttle/liquidjs/commit/40095a8))
+
+## [9.7.1](https://github.com/harttle/liquidjs/compare/v9.7.0...v9.7.1) (2020-02-19)
+
+
+### Bug Fixes
+
+* update index.html ([22386b0](https://github.com/harttle/liquidjs/commit/22386b0))
+
+# [9.7.0](https://github.com/harttle/liquidjs/compare/v9.6.2...v9.7.0) (2020-02-07)
+
+
+### Bug Fixes
+
+* expression and string literal parser, [#186](https://github.com/harttle/liquidjs/issues/186) ([fc0cf6f](https://github.com/harttle/liquidjs/commit/fc0cf6f))
+
+
+### Features
+
+* globals shared between tags, see [#185](https://github.com/harttle/liquidjs/issues/185) ([870e7ec](https://github.com/harttle/liquidjs/commit/870e7ec))
+
+## [9.6.2](https://github.com/harttle/liquidjs/compare/v9.6.1...v9.6.2) (2020-01-10)
+
+
+### Performance Improvements
+
+* prevent multiple case evaluations ([807e840](https://github.com/harttle/liquidjs/commit/807e840))
+
+## [9.6.1](https://github.com/harttle/liquidjs/compare/v9.6.0...v9.6.1) (2020-01-04)
+
+
+### Bug Fixes
+
+* add `this` to fs references in parseFile ([4b079c5](https://github.com/harttle/liquidjs/commit/4b079c5))
+
+# [9.6.0](https://github.com/harttle/liquidjs/compare/v9.5.0...v9.6.0) (2019-12-15)
+
+
+### Features
+
+* full syntax for strftime, close [#177](https://github.com/harttle/liquidjs/issues/177) ([ba5ff3f](https://github.com/harttle/liquidjs/commit/ba5ff3f))
+
+# [9.5.0](https://github.com/harttle/liquidjs/compare/v9.4.2...v9.5.0) (2019-12-12)
+
+
+### Features
+
+* nested property for the `where` filter, [#178](https://github.com/harttle/liquidjs/issues/178) ([60ec74f](https://github.com/harttle/liquidjs/commit/60ec74f))
+
+## [9.4.2](https://github.com/harttle/liquidjs/compare/v9.4.1...v9.4.2) (2019-11-15)
+
+
+### Bug Fixes
+
+* reading .first, .last of Array, closes [#175](https://github.com/harttle/liquidjs/issues/175) ([f82da11](https://github.com/harttle/liquidjs/commit/f82da11))
+
+## [9.4.1](https://github.com/harttle/liquidjs/compare/v9.4.0...v9.4.1) (2019-11-15)
+
+
+### Bug Fixes
+
+* remove node dependencies for esm bundle, see [#173](https://github.com/harttle/liquidjs/issues/173) ([04df929](https://github.com/harttle/liquidjs/commit/04df929))
+
+# [9.4.0](https://github.com/harttle/liquidjs/compare/v9.3.1...v9.4.0) (2019-11-14)
+
+
+### Features
+
+* add ability to pass JSON context to CLI ([9504e4e](https://github.com/harttle/liquidjs/commit/9504e4e))
+
+## [9.3.1](https://github.com/harttle/liquidjs/compare/v9.3.0...v9.3.1) (2019-11-09)
+
+
+### Bug Fixes
+
+* liquidjs command in /bin/liquid.js, fixes [#169](https://github.com/harttle/liquidjs/issues/169) ([0073b90](https://github.com/harttle/liquidjs/commit/0073b90))
+
+# [9.3.0](https://github.com/harttle/liquidjs/compare/v9.2.0...v9.3.0) (2019-11-07)
+
+
+### Features
+
+* support require.resolve for lookup, see [#168](https://github.com/harttle/liquidjs/issues/168) ([2dd4355](https://github.com/harttle/liquidjs/commit/2dd4355))
+
+## [9.1.1](https://github.com/harttle/liquidjs/compare/v9.1.0...v9.1.1) (2019-10-10)
+
+
+### Performance Improvements
+
+* add string flattening to reduce retained memory (node only) ([3ad512c](https://github.com/harttle/liquidjs/commit/3ad512c))
+
+# [9.1.0](https://github.com/harttle/liquidjs/compare/v9.0.1...v9.1.0) (2019-10-07)
+
+
+### Features
+
+* alias getTemplate() to parseFile() ([6b83788](https://github.com/harttle/liquidjs/commit/6b83788))
+
+## [9.0.1](https://github.com/harttle/liquidjs/compare/v9.0.0...v9.0.1) (2019-10-02)
+
+
+### Bug Fixes
+
+* `unless` content is not waited, fixes [#160](https://github.com/harttle/liquidjs/issues/160) ([d2c8d13](https://github.com/harttle/liquidjs/commit/d2c8d13))
+
+# [9.0.0](https://github.com/harttle/liquidjs/compare/v8.5.3...v9.0.0) (2019-08-26)
+
+
+### Bug Fixes
+
+* break/continue omitting output before them, [#123](https://github.com/harttle/liquidjs/issues/123) ([ae45c46](https://github.com/harttle/liquidjs/commit/ae45c46))
+* reactjs demo during yarn install, fixes [#145](https://github.com/harttle/liquidjs/issues/145) ([b65df44](https://github.com/harttle/liquidjs/commit/b65df44))
+
+
+### Code Refactoring
+
+* return value of Tag#render is no longer used ([8028f82](https://github.com/harttle/liquidjs/commit/8028f82))
+
+
+### Features
+
+* renderSync, parseAndRenderSync and renderFileSync, see [#48](https://github.com/harttle/liquidjs/issues/48) ([7fb01ad](https://github.com/harttle/liquidjs/commit/7fb01ad))
+
+
+### Performance Improvements
+
+* target to es6, fixes [#137](https://github.com/harttle/liquidjs/issues/137) ([3b9fc7e](https://github.com/harttle/liquidjs/commit/3b9fc7e))
+
+
+### BREAKING CHANGES
+
+* Tag#render now returns void, use emitter argument
+to write rendered html.
+* ship to Node.js 8, the dist/liquid.cjs.js (main) nolonger
+supports Node.js 6, other bundles are also provided via dist/liquid.esm.js, dist/liquid.js (ES5 umd) and liquid.min.js (minified ES5 umd)
+* remove default export, now should be used like import
+{Liquid} from 'liquidjs'
+
+## [8.5.3](https://github.com/harttle/liquidjs/compare/v8.5.2...v8.5.3) (2019-08-25)
+
+
+### Bug Fixes
+
+* escape filter when input is undefined ([a00945c](https://github.com/harttle/liquidjs/commit/a00945c))
+
+## [8.5.2](https://github.com/harttle/liquidjs/compare/v8.5.1...v8.5.2) (2019-08-09)
+
+
+### Bug Fixes
+
+* quotation tokenizing, [#151](https://github.com/harttle/liquidjs/issues/151) ([1e4f237](https://github.com/harttle/liquidjs/commit/1e4f237))
+
+## [8.5.1](https://github.com/harttle/liquidjs/compare/v8.5.0...v8.5.1) (2019-08-05)
+
+
+### Bug Fixes
+
+* publish bin directory to npm, fixes [#146](https://github.com/harttle/liquidjs/issues/146) ([a85b650](https://github.com/harttle/liquidjs/commit/a85b650))
+
+# [8.5.0](https://github.com/harttle/liquidjs/compare/v8.4.1...v8.5.0) (2019-08-01)
+
+
+### Features
+
+* CLI support ([fc045b5](https://github.com/harttle/liquidjs/commit/fc045b5))
+
+## [8.4.1](https://github.com/harttle/liquidjs/compare/v8.4.0...v8.4.1) (2019-07-22)
+
+
+### Bug Fixes
+
+* some filters on undefined variable throws, [#140](https://github.com/harttle/liquidjs/issues/140) ([6e6ea0a](https://github.com/harttle/liquidjs/commit/6e6ea0a))
+
+# [8.4.0](https://github.com/harttle/liquidjs/compare/v8.3.0...v8.4.0) (2019-07-06)
+
+
+### Features
+
+* at_least, at_most, sort_naturual for [#132](https://github.com/harttle/liquidjs/issues/132) ([e6f5f1c](https://github.com/harttle/liquidjs/commit/e6f5f1c))
+
+# [8.3.0](https://github.com/harttle/liquidjs/compare/v8.2.4...v8.3.0) (2019-06-27)
+
+
+### Features
+
+* fs option implemented by [#138](https://github.com/harttle/liquidjs/issues/138) ([3f5e23c](https://github.com/harttle/liquidjs/commit/3f5e23c))
+
+## [8.2.4](https://github.com/harttle/liquidjs/compare/v8.2.3...v8.2.4) (2019-06-17)
+
+
+### Performance Improvements
+
+* improve getTemplate() when cache is enabled ([1ffba2b](https://github.com/harttle/liquidjs/commit/1ffba2b))
+
+## [8.2.3](https://github.com/harttle/liquidjs/compare/v8.2.2...v8.2.3) (2019-05-19)
+
+
+### Bug Fixes
+
+* reverse filter not pure, see [#126](https://github.com/harttle/liquidjs/issues/126) ([505c408](https://github.com/harttle/liquidjs/commit/505c408))
+
+## [8.2.2](https://github.com/harttle/liquidjs/compare/v8.2.1...v8.2.2) (2019-05-12)
+
+
+### Bug Fixes
+
+* date from integer, [#125](https://github.com/harttle/liquidjs/issues/125) ([fdf0043](https://github.com/harttle/liquidjs/commit/fdf0043))
+* pass drops directly to filters/tags ([bef2909](https://github.com/harttle/liquidjs/commit/bef2909))
+
+## [8.2.1](https://github.com/harttle/liquidjs/compare/v8.2.0...v8.2.1) (2019-04-26)
+
+
+### Bug Fixes
+
+* `default` filter is not working with an empty string, [#122](https://github.com/harttle/liquidjs/issues/122) ([6075c0a](https://github.com/harttle/liquidjs/commit/6075c0a))
+
+# [8.2.0](https://github.com/harttle/liquidjs/compare/v8.1.0...v8.2.0) (2019-04-17)
+
+
+### Features
+
+* pass context to filters ([00bc1ef](https://github.com/harttle/liquidjs/commit/00bc1ef))
+
+# [8.1.0](https://github.com/harttle/liquidjs/compare/v8.0.3...v8.1.0) (2019-04-02)
+
+
+### Features
+
+* where filter, working on [#118](https://github.com/harttle/liquidjs/issues/118) ([daa0b57](https://github.com/harttle/liquidjs/commit/daa0b57))
+
+## [8.0.3](https://github.com/harttle/liquidjs/compare/v8.0.2...v8.0.3) (2019-04-01)
+
+
+### Bug Fixes
+
+* slice filter on negative `begin`, [#117](https://github.com/harttle/liquidjs/issues/117) ([eadb6f3](https://github.com/harttle/liquidjs/commit/eadb6f3))
+
+## [8.0.2](https://github.com/harttle/liquidjs/compare/v8.0.1...v8.0.2) (2019-03-25)
+
+
+### Performance Improvements
+
+* use polymophism instead duck test ([82d7673](https://github.com/harttle/liquidjs/commit/82d7673))
+
+## [8.0.1](https://github.com/harttle/liquidjs/compare/v8.0.0...v8.0.1) (2019-03-22)
+
+
+### Bug Fixes
+
+* incorrect scope when using assign with for, fixes [#115](https://github.com/harttle/liquidjs/issues/115) ([defbb58](https://github.com/harttle/liquidjs/commit/defbb58))
+
+# [8.0.0](https://github.com/harttle/liquidjs/compare/v7.5.1...v8.0.0) (2019-03-10)
+
+
+### Code Refactoring
+
+* use camelCase for JavaScript APIs ([64e0c87](https://github.com/harttle/liquidjs/commit/64e0c87))
+
+
+### Features
+
+* promise support for drops, working on [#65](https://github.com/harttle/liquidjs/issues/65) ([4a8088d](https://github.com/harttle/liquidjs/commit/4a8088d))
+
+
+### BREAKING CHANGES
+
+* Options and method names in JavaScript API are now renamed to cammelCase, for a complete list see #109
+
+## [7.5.1](https://github.com/harttle/liquidjs/compare/v7.5.0...v7.5.1) (2019-03-05)
+
+
+### Bug Fixes
+
+* named params for filters, working on [#113](https://github.com/harttle/liquidjs/issues/113) ([5ffc904](https://github.com/harttle/liquidjs/commit/5ffc904))
+
+# [7.5.0](https://github.com/harttle/liquidjs/compare/v7.4.0...v7.5.0) (2019-03-01)
+
+
+### Features
+
+* tablerowloop object ([3647305](https://github.com/harttle/liquidjs/commit/3647305))
+
+# [7.4.0](https://github.com/harttle/liquidjs/compare/v7.3.1...v7.4.0) (2019-02-28)
+
+
+### Bug Fixes
+
+* math filters now return number, resolves [#110](https://github.com/harttle/liquidjs/issues/110) ([b4acdb4](https://github.com/harttle/liquidjs/commit/b4acdb4))
+
+
+### Features
+
+* exported Drop interface for [#107](https://github.com/harttle/liquidjs/issues/107) ([7bee9fc](https://github.com/harttle/liquidjs/commit/7bee9fc)), closes [#109](https://github.com/harttle/liquidjs/issues/109)
+
+## [7.3.1](https://github.com/harttle/liquidjs/compare/v7.3.0...v7.3.1) (2019-02-25)
+
+
+### Bug Fixes
+
+* **#108:** remove absolute path in emitted d.ts ([53a835a](https://github.com/harttle/liquidjs/commit/53a835a)), closes [#108](https://github.com/harttle/liquidjs/issues/108)
+
+# [7.3.0](https://github.com/harttle/liquidjs/compare/v7.2.2...v7.3.0) (2019-02-24)
+
+
+### Features
+
+* nil/null/empty/blank literals, resolves [#102](https://github.com/harttle/liquidjs/issues/102) ([88c9e96](https://github.com/harttle/liquidjs/commit/88c9e96))
+
+## [7.2.2](https://github.com/harttle/liquidjs/compare/v7.2.1...v7.2.2) (2019-02-23)
+
+
+### Bug Fixes
+
+* filters break when argument contains [()|, fixes [#89](https://github.com/harttle/liquidjs/issues/89) ([e977669](https://github.com/harttle/liquidjs/commit/e977669))
+
+## [7.2.1](https://github.com/harttle/liquidjs/compare/v7.2.0...v7.2.1) (2019-02-22)
+
+
+### Bug Fixes
+
+* default length for truncate and truncatewords ([56c7992](https://github.com/harttle/liquidjs/commit/56c7992))
+
+# [7.2.0](https://github.com/harttle/liquidjs/compare/v7.1.0...v7.2.0) (2019-02-20)
+
+
+### Features
+
+* override output/tag delimiter, fixes [#54](https://github.com/harttle/liquidjs/issues/54) ([d20a043](https://github.com/harttle/liquidjs/commit/d20a043))
+
+### BREAKING CHANGES
+
+* `trim_value_left` option renamed to `trim_output_left`, `trim_value_right` option renamed to `trim_output_right`
+
+# [7.1.0](https://github.com/harttle/liquidjs/compare/v7.0.2...v7.1.0) (2019-02-20)
+
+
+### Features
+
+* throw an Error if delimiter not matched ([c33d8f6](https://github.com/harttle/liquidjs/commit/c33d8f6))
+
+# [7.0.0](https://github.com/harttle/liquidjs/compare/v6.4.3...v7.0.0) (2019-02-14)
+
+
+### chore
+
+* **TypeScript:** ship Liquid to class ([1cc7249](https://github.com/harttle/liquidjs/commit/1cc7249))
+
+
+### BREAKING CHANGES
+
+* **TypeScript:** calling `Liquid()` without `new` now becomes invalid
+
+## [6.4.3](https://github.com/harttle/liquidjs/compare/v6.4.2...v6.4.3) (2019-02-13)
+
+
+### Bug Fixes
+
+* better index.d.ts and a demo ([2015f68](https://github.com/harttle/liquidjs/commit/2015f68)), closes [#98](https://github.com/harttle/liquidjs/issues/98)
+
+## [6.4.2](https://github.com/harttle/liquidjs/compare/v6.4.1...v6.4.2) (2019-01-28)
+
+
+### Bug Fixes
+
+* **CI:** e2e not building cjs ([dde7b3b](https://github.com/harttle/liquidjs/commit/dde7b3b))
+
 ## [6.4.1](https://github.com/harttle/liquidjs/compare/v6.4.0...v6.4.1) (2019-01-28)


@@ -1,276 +1,123 @@
 # liquidjs
-
-[![npm](https://img.shields.io/npm/v/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
-[![npm](https://img.shields.io/npm/dm/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
-[![Build Status](https://travis-ci.org/harttle/liquidjs.svg?branch=master)](https://travis-ci.org/harttle/liquidjs)
-[![Coveralls](https://img.shields.io/coveralls/harttle/liquidjs.svg)](https://coveralls.io/github/harttle/liquidjs?branch=master)
+[![npm version](https://img.shields.io/npm/v/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
+[![npm downloads](https://img.shields.io/npm/dm/liquidjs.svg)](https://www.npmjs.org/package/liquidjs)
+[![coveralls coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg)](https://coveralls.io/github/harttle/liquidjs?branch=master)
+[![travis Build Status](https://travis-ci.org/harttle/liquidjs.svg?branch=master)](https://travis-ci.org/harttle/liquidjs)
 [![GitHub issues](https://img.shields.io/github/issues-closed/harttle/liquidjs.svg)](https://github.com/harttle/liquidjs/issues)
 [![GitHub contributors](https://img.shields.io/github/contributors/harttle/liquidjs.svg)](https://github.com/harttle/liquidjs/graphs/contributors)
-[![David](https://img.shields.io/david/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs)
-[![David Dev](https://img.shields.io/david/dev/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs?type=dev)
-[![DUB](https://img.shields.io/dub/l/vibe-d.svg)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
-[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://github.com/harttle/liquidjs)
+[![Open Collective contributors](https://img.shields.io/opencollective/all/liquidjs)](https://opencollective.com/liquidjs)
+[![David dependencies](https://img.shields.io/david/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs)
+[![David devDependencies](https://img.shields.io/david/dev/harttle/liquidjs.svg)](https://david-dm.org/harttle/liquidjs?type=dev)
+[![DUB license](https://img.shields.io/dub/l/vibe-d.svg)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits)
 [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/harttle/liquidjs)

-This is a liquid implementation for both Node.js and browsers. Website: <http://harttle.github.io/liquidjs/>, Live Demo: <https://jsfiddle.net/6u40xbzs/> 
+A simple, expressive, safe and [Shopify][shopify/liquid] 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.

-**Features**
+* [Documentation][doc]
+* Please star [LiquidJS on GitHub][github]!
+* Support [LiquidJS on Open Collective][oc] or [Patreon][patreon]

-* Fully compatible to [shopify][shopify/liquid], with all [tags][tags] and [filters][filters] implemented
-* Support layout(extend) and include syntax
-* In pure JavaScript with Promise-based API
+<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>

-**Differences**
+## Installation

-Though being compatible with [Ruby Liquid](https://github.com/shopify/liquid) is one of our priorities, there're still certain differences. You may need some configuration to get it compatible in these senarios:
-
-* Dynamic file locating (enabled by default), which means layout/partial name can be an variable in liquidjs. See [#51](https://github.com/harttle/liquidjs/issues/51).
-* Truthy and Falsy. All values except `undefined`, `null`, `false` are truthy, whereas in Ruby Liquid all except `nil` and `false` are truthy. See [#26](https://github.com/harttle/liquidjs/pull/26).
-* Number Rendering. Since JavaScript do not distinguish `float` and `integer`, we cannot either convert between them nor render regarding to their type. See [#59](https://github.com/harttle/liquidjs/issues/59).
-* [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) has a `.toLiquid()` alias and and the JavaScript `.toString()` is aliased to `.to_s()`.
-* [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) uses `JSON.prototype.stringify` as default, rather than Ruby's inspect.
-
-## TOC
-
-* Usage
-    * [Render from String](#render-from-string)
-    * [Render from File](#render-from-file)
-    * [Use with Express.js](#use-with-expressjs)
-    * [Use in Browser](#use-in-browser)
-    * [Include Partials](#include-partials)
-    * [Layout Templates (Extends)](#layout-templates-extends)
-* API Spec
-    * [Constructor Options](#options)
-    * [Register Filters](#register-filters), [Builtin Filters](https://github.com/harttle/liquidjs/wiki/Builtin-Filters)
-    * [Register Tags](#register-tags), [Builtin Tags](https://github.com/harttle/liquidjs/wiki/Builtin-Tags)
-    * [Operators](https://github.com/harttle/liquidjs/wiki/Operators)
-    * [Whitespace Control](https://github.com/harttle/liquidjs/wiki/Whitespace-Control)
-* [Contribute Guidelines](#contribute-guidelines)
-
-## Render from String
-
-Install as Node.js dependency:
+Install from npm in Node.js:

 ```bash
-# You'll need a promise-polyfill for Node.js < 4
 npm install --save liquidjs
 ```

-Parse and Render:
+Or use the UMD bundle from jsDelivr:

-```javascript
-var Liquid = require('liquidjs');
-var engine = Liquid();
-
-engine
-    .parseAndRender('{{name | capitalize}}', {name: 'alice'})
-    .then(console.log);
-
-// outputs 'Alice'
+```html
+<script src="https://cdn.jsdelivr.net/npm/liquidjs/dist/liquid.min.js"></script>
 ```

-Caching templates:
+More details, refer to [The Setup Guide][setup].

-```javascript
-var tpl = engine.parse('{{name | capitalize}}');
-engine
-    .render(tpl, {name: 'alice'})
-    .then(console.log);
+## Related Packages

-// outputs 'Alice'
-```
+* [gulp-liquidjs](https://www.npmjs.com/package/@tuanpham-dev/gulp-liquidjs): A shopify compatible Liquid template engine for Gulp using liquidjs.
+* [grunt-liquify](https://www.npmjs.com/package/grunt-liquify): A Grunt task to process Liquid using liquidjs. Use it to add Liquid magic to your scripts and css assets.
+* [react-liquid](https://github.com/aquibm/react-liquid#readme): Liquid templating language component for React
+* [@11ty/eleventy](https://www.npmjs.com/package/@11ty/eleventy): A simpler static site generator. An alternative to Jekyll. Written in JavaScript. Transforms a directory of templates (of varying types) into HTML.

-## Render from File
+## Backers

-```javascript
-var engine = Liquid({
-    root: path.resolve(__dirname, 'views/'),  // dirs to lookup layouts/includes
-    extname: '.liquid'          // the extname used for layouts/includes, defaults ""
-});
-engine.renderFile("hello.liquid", {name: 'alice'})
-    .then(console.log)  // outputs "Alice"
+If you love LiquidJS or your company is using LiquidJS? Please consider [support us on Open Collective or Patreon][financial-support].

-// which is equivalent to: 
-engine
-    .renderFile("hello", {name: 'alice'})
-    .then(console.log)  // outputs "Alice"
-```
+![backers from open-collective](https://opencollective.com/liquidjs/tiers/backer.svg?avatarHeight=97)

-## Use with Express.js
+## Contributors ✨

-```javascript
-// register liquid engine
-app.engine('liquid', engine.express()); 
-app.set('views', './views');            // specify the views directory
-app.set('view engine', 'liquid');       // set to default
-```
+Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to these wonderful people:

-[Here](demo/express/)'s an Express demo. When used with Express.js,
-Express [`views`][express-views] will be included when looking up
-partials(includes and layouts).
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://harttle.land"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4" width="100px;" alt=""/><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"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4" width="100px;" alt=""/><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"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4" width="100px;" alt=""/><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"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4" width="100px;" alt=""/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
+    <td align="center"><a href="https://paulrobertlloyd.com/"><img src="https://avatars3.githubusercontent.com/u/813383?v=4" width="100px;" alt=""/><br /><sub><b>Paul Robert Lloyd</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=paulrobertlloyd" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Apaulrobertlloyd" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://twitter.com/alecdotbiz"><img src="https://avatars2.githubusercontent.com/u/1925840?v=4" width="100px;" alt=""/><br /><sub><b>Alec Larson</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aleclarson" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/pmalouin"><img src="https://avatars1.githubusercontent.com/u/1411117?v=4" width="100px;" alt=""/><br /><sub><b>Patrick Malouin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=pmalouin" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://jaswrks.com"><img src="https://avatars3.githubusercontent.com/u/1563559?v=4" width="100px;" alt=""/><br /><sub><b>jaswrks</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jaswrks" title="Code">💻</a></td>
+    <td align="center"><a href="https://oott123.com"><img src="https://avatars2.githubusercontent.com/u/905663?v=4" width="100px;" alt=""/><br /><sub><b>三三</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=oott123" title="Code">💻</a> <a href="#ideas-oott123" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/ssendev"><img src="https://avatars0.githubusercontent.com/u/450793?v=4" width="100px;" alt=""/><br /><sub><b>ssendev</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/commits?author=ssendev" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/wojtask9"><img src="https://avatars3.githubusercontent.com/u/6099236?v=4" width="100px;" alt=""/><br /><sub><b>wojtask9</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wojtask9" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/thelornenelson"><img src="https://avatars3.githubusercontent.com/u/24596583?v=4" width="100px;" alt=""/><br /><sub><b>Andrew Barclay</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thelornenelson" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.stam.pr/"><img src="https://avatars2.githubusercontent.com/u/142338?v=4" width="100px;" alt=""/><br /><sub><b>Cory Mawhorter</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cmawhorter" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/thehappybug"><img src="https://avatars0.githubusercontent.com/u/3393530?v=4" width="100px;" alt=""/><br /><sub><b>Mehdi Jaffery</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thehappybug" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/robinbijlani"><img src="https://avatars0.githubusercontent.com/u/2503108?v=4" width="100px;" alt=""/><br /><sub><b>Robin Bijlani</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=robinbijlani" title="Code">💻</a> <a href="https://github.com/harttle/liquidjs/issues?q=author%3Arobinbijlani" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://www.rmkennedy.com"><img src="https://avatars3.githubusercontent.com/u/8356669?v=4" width="100px;" alt=""/><br /><sub><b>Ryan Kennedy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ryaninvents" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/strax"><img src="https://avatars2.githubusercontent.com/u/587213?v=4" width="100px;" alt=""/><br /><sub><b>Sami Kukkonen</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=strax" title="Code">💻</a></td>
+    <td align="center"><a href="https://ScottFreeCode.github.io/"><img src="https://avatars3.githubusercontent.com/u/16506071?v=4" width="100px;" alt=""/><br /><sub><b>Scott Santucci</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ScottFreeCode" title="Code">💻</a></td>
+    <td align="center"><a href="http://stevenrescigno.com"><img src="https://avatars3.githubusercontent.com/u/8505293?v=4" width="100px;" alt=""/><br /><sub><b>Steven </b></sub></a><br /><a href="#example-stevenanthonyrevo" title="Examples">💡</a> <a href="https://github.com/harttle/liquidjs/commits?author=stevenanthonyrevo" title="Code">💻</a></td>
+    <td align="center"><a href="https://efcl.info/"><img src="https://avatars1.githubusercontent.com/u/19714?v=4" width="100px;" alt=""/><br /><sub><b>azu</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=azu" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/wyozi"><img src="https://avatars3.githubusercontent.com/u/4894573?v=4" width="100px;" alt=""/><br /><sub><b>Joonas</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=wyozi" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/jamelait"><img src="https://avatars1.githubusercontent.com/u/14369255?v=4" width="100px;" alt=""/><br /><sub><b>Jamel A.</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jamelait" title="Code">💻</a></td>
+    <td align="center"><a href="https://brandonpittman.net"><img src="https://avatars0.githubusercontent.com/u/967145?v=4" width="100px;" alt=""/><br /><sub><b>Brandon Pittman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=brandonpittman" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/tgrandgent"><img src="https://avatars3.githubusercontent.com/u/17069042?v=4" width="100px;" alt=""/><br /><sub><b>tgrandgent</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tgrandgent" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/mastodon0"><img src="https://avatars1.githubusercontent.com/u/7924332?v=4" width="100px;" alt=""/><br /><sub><b>Martin Schuster</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mastodon0" title="Code">💻</a></td>
+    <td align="center"><a href="http://js.chenlei.me"><img src="https://avatars0.githubusercontent.com/u/6339390?v=4" width="100px;" alt=""/><br /><sub><b>Ray</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Tests">⚠️</a> <a href="https://github.com/harttle/liquidjs/commits?author=richardo2016" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/CriGoT"><img src="https://avatars0.githubusercontent.com/u/1936786?v=4" width="100px;" alt=""/><br /><sub><b>Cristofer Gonzales</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=CriGoT" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.raymondcamden.com"><img src="https://avatars3.githubusercontent.com/u/393660?v=4" width="100px;" alt=""/><br /><sub><b>Raymond Camden</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cfjedimaster" title="Documentation">📖</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://stedman.dev"><img src="https://avatars1.githubusercontent.com/u/183122?v=4" width="100px;" alt=""/><br /><sub><b>Steve Stedman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=stedman" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://ciccarello.me"><img src="https://avatars0.githubusercontent.com/u/11273838?v=4" width="100px;" alt=""/><br /><sub><b>Anthony Ciccarello</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aciccarello" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://twitter.com/IAmTrySound"><img src="https://avatars0.githubusercontent.com/u/5635476?v=4" width="100px;" alt=""/><br /><sub><b>Bogdan Chadkin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=TrySound" title="Code">💻</a></td>
+    <td align="center"><a href="https://hightouch.io"><img src="https://avatars0.githubusercontent.com/u/5959235?v=4" width="100px;" alt=""/><br /><sub><b>Tejas Manohar</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tejasmanohar" title="Code">💻</a></td>
+    <td align="center"><a href="http://about.me/peterdehaan"><img src="https://avatars2.githubusercontent.com/u/557895?v=4" width="100px;" alt=""/><br /><sub><b>Peter deHaan</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pdehaan" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/amit777"><img src="https://avatars0.githubusercontent.com/u/2703309?v=4" width="100px;" alt=""/><br /><sub><b>amit777</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=amit777" title="Code">💻</a> <a href="#financial-amit777" title="Financial">💵</a></td>
+    <td align="center"><a href="http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html"><img src="https://avatars3.githubusercontent.com/u/1100776?v=4" width="100px;" alt=""/><br /><sub><b>Steffen Schuldenzucker</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=sschuldenzucker" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/Pixcell"><img src="https://avatars0.githubusercontent.com/u/4005291?v=4" width="100px;" alt=""/><br /><sub><b>Pixcell</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=Pixcell" title="Code">💻</a></td>
+  </tr>
+</table>

-## Use in Browser
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->

-You can get a dist file for browsers from
-
-* [Releases][releases] page for liquidjs, or
-* unpkg.com: <https://unpkg.com/liquidjs/dist/liquid.min.js> 
-
-Here's the demo:
-
-* JSFiddle: <https://jsfiddle.net/6u40xbzs/> 
-* Demo directory: [/demo/browser/](demo/browser/).
-
-Note: For [IE and Android UC][caniuse-promises] browser, you will need a [Promise polyfill][pp].
-
-## Include Partials
-
-```
-// file: color.liquid
-color: '{{ color }}' shape: '{{ shape }}'
-
-// file: theme.liquid
-{% assign shape = 'circle' %}
-{% include 'color' %}
-{% include 'color' with 'red' %}
-{% include 'color', color: 'yellow', shape: 'square' %}
-```
-
-The output will be:
-
-```
-color: '' shape: 'circle'
-color: 'red' shape: 'circle'
-color: 'yellow' shape: 'square'
-```
-
-## Layout Templates (Extends)
-
-```
-// file: default-layout.liquid
-Header
-{% block content %}My default content{% endblock %}
-Footer
-
-// file: page.liquid
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
-
-The output of `page.liquid`:
-
-```
-Header
-My page content
-Footer
-```
-
-* It's possible to define multiple blocks.
-* block name is optional when there's only one block.
-
-## Options
-
-The full list of options for `Liquid()` is listed as following:
-
-* `root` is a directory or an array of directories to resolve layouts and includes, as well as the filename passed in when calling `.renderFile()`.
-If an array, the files are looked up in the order they occur in the array.
-Defaults to `["."]`
-
-* `extname` is used to lookup the template file when filepath doesn't include an extension name. Eg: setting to `".html"` will allow including file by basename. Defaults to `""`.
-
-* `cache` indicates whether or not to cache resolved templates. Defaults to `false`.
-
-* `dynamicPartials`: if set, treat `<filepath>` parameter in `{%include filepath %}`, `{%layout filepath%}` as a variable, otherwise as a literal value. Defaults to `true`.
-
-* `strict_filters` is used to enable strict filter existence. If set to `false`, undefined filters will be rendered as empty string. Otherwise, undefined filters will cause an exception. Defaults to `false`.
-
-* `strict_variables` is used to enable strict variable derivation. 
-If set to `false`, undefined variables will be rendered as empty string.
-Otherwise, undefined variables will cause an exception. Defaults to `false`.
-
-* `trim_tag_right` is used to strip blank characters (including ` `, `\t`, and `\r`) from the right of tags (`{% %}`) until `\n` (inclusive). Defaults to `false`.
-
-* `trim_tag_left` is similiar to `trim_tag_right`, whereas the `\n` is exclusive. Defaults to `false`. See [Whitespace Control][whitespace control] for details.
-
-* `trim_value_right` is used to strip blank characters (including ` `, `\t`, and `\r`) from the right of values (`{{ }}`) until `\n` (inclusive). Defaults to `false`.
-
-* `trim_value_left` is similiar to `trim_value_right`, whereas the `\n` is exclusive. Defaults to `false`. See [Whitespace Control][whitespace control] for details.
-
-* `greedy` is used to specify whether `trim_left`/`trim_right` is greedy. When set to `true`, all consecutive blank characters including `\n` will be trimed regardless of line breaks. Defaults to `true`.
-
-## Register Filters
-
-```javascript
-// Usage: {{ name | uppper }}
-engine.registerFilter('upper', v => v.toUpperCase())
-```
-
-Filter arguments will be passed to the registered filter function, for example:
-
-```javascript
-// Usage: {{ 1 | add: 2, 3 }}
-engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)
-```
-
-See existing filter implementations here: <https://github.com/harttle/liquidjs/blob/master/filters.js>
-
-## Register Tags
-
-```javascript
-// Usage: {% upper name%}
-engine.registerTag('upper', {
-    parse: function(tagToken, remainTokens) {
-        this.str = tagToken.args; // name
-    },
-    render: function(scope, hash) {
-        var str = Liquid.evalValue(this.str, scope); // 'alice'
-        return Promise.resolve(str.toUpperCase()); // 'Alice'
-    }
-});
-```
-
-* `parse`: Read tokens from `remainTokens` until your end token.
-* `render`: Combine scope data with your parsed tokens into HTML string.
-
-See existing tag implementations here: <https://github.com/harttle/liquidjs/blob/master/tags/>
-
-## Plugin API
-
-A pack of tags or filters can be encapsulated into a **plugin**, which will be typically installed via npm.
-
-```javascript
-engine.plugin(require('./some-plugin'));
-
-// some-plugin.js
-module.exports = function (Liquid) {
-    // here `this` refers to the engine instance
-    // `Liquid` provides facilities to implement tags and filters
-    this.registerFilter('foo', x => x);
-}
-```
-
-Plugin List:
-
-* To add your plugin, contact me or simply send a PR.
-
-## Contribute Guidelines
-
-This repo uses [eslint](https://eslint.org/) to check code style, [semantic-release](https://github.com/semantic-release/semantic-release) to generate changelog and publish to npm and Github Releases.
-
-* Code Style: <https://github.com/standard/eslint-config-standard>, `npm run lint` to check locally.
-* Commit Message: <https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits>
-
-[nunjucks]: http://mozilla.github.io/nunjucks/
-[liquid-node]: https://github.com/sirlantis/liquid-node
 [shopify/liquid]: https://shopify.github.io/liquid/
-[jekyll]: http://jekyllrb.com/
-[gh]: https://pages.github.com/
-[releases]: https://github.com/harttle/liquidjs/releases
-[any-promise]: https://github.com/kevinbeaty/any-promise
-[test]: https://github.com/harttle/liquidjs/tree/master/test
-[caniuse-promises]: http://caniuse.com/#feat=promises
-[whitespace control]: https://github.com/harttle/liquidjs/wiki/Whitespace-Control
-[tags]: https://github.com/harttle/liquidjs/wiki/Builtin-Tags
-[filters]: https://github.com/harttle/liquidjs/wiki/Builtin-Filters
-[express-views]: http://expressjs.com/en/guide/using-template-engines.html
-[pp]: https://github.com/taylorhakes/promise-polyfill
+[plugins]: https://liquidjs.com/tutorials/plugins.html#Plugin-List
+[setup]: https://liquidjs.com/tutorials/setup.html
+[doc]: https://liquidjs.com
+[github]: https://github.com/harttle/liquidjs
+[patreon]: https://www.patreon.com/harttle
+[oc]: https://opencollective.com/liquidjs/
+[contribution]: https://liquidjs.com/tutorials/contribution-guidelines.html
+[financial-support]: https://liquidjs.com/tutorials/contribution-guidelines.html#Financial-Support
@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+Only the latest major version is supported with security updates. It can be changed if many people are relying on a specific version for some reason. If this is the case, welcome to file an issue.
+
+## Reporting a Vulnerability
+
+Please contact yangjvn@126.com to report a vulnerability.
+
+- It will be fixed very soon (maybe within 1 week or couple of days) if that vulnerability obviously affects common use cases.
+- Otherwise, it'll be scheduled with a priority just like requested features (which is lower than bugs).
+- If it's declined, you'll receive an email (more oftenly there will be a discuss).
@@ -0,0 +1,7 @@
+{
+  "extends": ["standard"],
+  "rules": {
+    "no-unused-expressions": "off",
+    "@typescript-eslint/no-var-requires": "off"
+  }
+}
@@ -0,0 +1,49 @@
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')
+
+const engine = new Liquid({
+  root: __dirname,
+  extname: '.liquid'
+})
+
+engine.registerTag('header', {
+  parse: function (token) {
+    const [key, val] = token.args.split(':')
+    this[key] = val
+  },
+  render: function (ctx) {
+    const title = this.liquid.evalValue(this.content, ctx)
+    return `<h1>${title}</h1>`
+  }
+})
+
+const ctx = {
+  todos: ['fork and clone', 'make it better', 'make a pull request'],
+  title: 'Welcome to liquidjs!'
+}
+
+const template = `
+{%header content: "welcome to liquid" | capitalize%}
+
+<ul>
+  {% for todo in todos %}
+  <li>{{forloop.index}} - {{todo}}</li>
+  {% endfor %}
+</ul>
+`
+
+function demo () {
+  console.log('--- demo ---')
+  return new Promise(resolve => {
+    new Benchmark.Suite('demo')
+      .add('demo', {
+        defer: true,
+        fn: d => engine.parseAndRender(template, ctx).then(x => d.resolve(x))
+      })
+      .on('cycle', event => console.log(String(event.target)))
+      .on('complete', resolve)
+      .run({ 'async': true })
+  })
+}
+
+module.exports = { demo }
@@ -0,0 +1,15 @@
+const { output } = require('./output')
+const { tag } = require('./tag')
+const { demo } = require('./demo')
+const { layout } = require('./layout')
+const { memory } = require('./memory')
+
+async function main () {
+  await output()
+  await tag()
+  await demo()
+  await layout()
+  await memory()
+}
+
+main()
@@ -0,0 +1,38 @@
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')
+
+const engineOptions = {
+  root: __dirname,
+  extname: '.liquid'
+}
+
+const engine = new Liquid(engineOptions)
+const cachingEngine = new Liquid({
+  ...engineOptions,
+  cache: true
+})
+
+const template = `
+{% layout "./templates/layout.liquid" %}
+{% block body %}a small body{% endblock %}
+`
+
+function layout () {
+  console.log('--- layout ---')
+  return new Promise(resolve => {
+    new Benchmark.Suite('layout')
+      .add('cache=false', {
+        defer: true,
+        fn: d => engine.parseAndRender(template, {}).then(x => d.resolve(x))
+      })
+      .add('cache=true', {
+        defer: true,
+        fn: d => cachingEngine.parseAndRender(template, {}).then(x => d.resolve(x))
+      })
+      .on('cycle', event => console.log(String(event.target)))
+      .on('complete', resolve)
+      .run({ 'async': true })
+  })
+}
+
+module.exports = { layout }
@@ -0,0 +1,61 @@
+const { join } = require('path')
+const { readFileSync } = require('fs')
+const { getHeapStatistics } = require('v8')
+const { Liquid } = require('..')
+
+const engineOptions = {
+  root: __dirname,
+  extname: '.liquid'
+}
+
+const engine = new Liquid(engineOptions)
+
+const SAMPLE_COUNT = 1024
+
+function memory () {
+  console.log('--- memory ---')
+  html()
+  todolist()
+}
+
+function html () {
+  const str = readFileSync(join(__dirname, 'templates/lorem-html.liquid'), 'utf8')
+
+  global.gc()
+  const base = getHeapStatistics().used_heap_size
+  const templates = []
+
+  for (let i = 0; i < SAMPLE_COUNT; i++) {
+    templates.push(engine.parse(str))
+  }
+  const diff1 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`${h(str.length)} lorem-html before GC x ${h(diff1)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+
+  global.gc()
+  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`${h(str.length)} lorem-html after GC x ${h(diff2)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+}
+
+function todolist () {
+  const str = readFileSync(join(__dirname, 'templates/todolist.liquid'), 'utf8')
+
+  global.gc()
+  const base = getHeapStatistics().used_heap_size
+  const templates = []
+
+  for (let i = 0; i < SAMPLE_COUNT; i++) {
+    templates.push(engine.parse(str))
+  }
+  const diff1 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`${h(str.length)} todolist before GC x ${h(diff1)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+
+  global.gc()
+  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`${h(str.length)} todolist after GC x ${h(diff2)}/tpl (${SAMPLE_COUNT} instances sampled)`)
+}
+
+function h (size) {
+  return (size / 1024).toFixed(3) + ' kB'
+}
+
+module.exports = { memory }
@@ -0,0 +1,28 @@
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')
+
+const liquid = new Liquid()
+
+function output () {
+  console.log('--- output ---')
+  return new Promise(resolve => {
+    new Benchmark.Suite('output')
+      .add('literal', test('{{false}}{{"foo"}}{{32.322}}'))
+      .add('truncate', test('{{"foobar" | truncate: 3}}'))
+      .add('date', test('{{"now" | date: "%d%Y%m"}}'))
+      .add('escape', test('{{"1<2" | escape}}'))
+      .add('default', test('{{"" | default: 3}}'))
+      .on('cycle', (event) => console.log(String(event.target)))
+      .on('complete', resolve)
+      .run({ 'async': true })
+  })
+}
+
+function test (str) {
+  return {
+    defer: true,
+    fn: d => liquid.parseAndRender(str).then(x => d.resolve(x))
+  }
+}
+
+module.exports = { output }
@@ -0,0 +1,32 @@
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')
+
+const liquid = new Liquid()
+
+function tag () {
+  console.log('--- tag ---')
+  return new Promise(resolve => {
+    new Benchmark.Suite('tag')
+      .add('if', test('{% if "foobar" %}foo{% endif %}'))
+      .add('unless', test('{%unless "foo"%}true{%else%}false{%endunless%}'))
+      .add('for', test('{% for i in (1..3) %}{{fooloop.index}}{% endfor %}'))
+      .add('switch', test('{%case 3%}{% when 1 %}1{% when 2 %}2{% when 3 %}3{%endcase%}'))
+      .add('assign', test('{%assign a="foo bar"%}'))
+      .add('capture', test('{%capture foo%}what is this{%endcapture%}'))
+      .add('increment', test('{%increment a%}'))
+      .add('decrement', test('{%decrement a%}'))
+      .add('tablerow', test('{%tablerow i in (1..10) cols:3%}{%endtablerow%}'))
+      .on('cycle', (event) => console.log(String(event.target)))
+      .on('complete', resolve)
+      .run({ 'async': true })
+  })
+}
+
+function test (str) {
+  return {
+    defer: true,
+    fn: d => liquid.parseAndRender(str).then(x => d.resolve(x))
+  }
+}
+
+module.exports = { tag }
@@ -0,0 +1,2 @@
+This is a barely empty layout with a body:
+{% block body %}{% endblock %}
@@ -0,0 +1,38 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"><head>
+
+    <meta http-equiv="content-type" content="text/html; charset=utf-8">
+    <!-- You may use a different charset if needed -->
+
+    <title>Latin Lipsum -  Courtesy generator.lorem-ipsum.info</title>
+</head>
+
+<body>
+<p>Lorem ipsum dolor sit amet, falli detraxit facilisis sit ex. Nec vidit nihil ut, vis utamur definitionem in. Ancillae phaedrum ut eos. Ne eam errem cotidieque.
+</p>
+<p>
+    Sit amet vitae referrentur ad, oportere necessitatibus vituperatoribus vim ne. Audiam quaeque nusquam ei eos, mel ex adhuc prompta complectitur. Decore voluptua cotidieque vel ei, veri novum persecuti te sea. Nisl novum sea cu. Dicta delicatissimi ut est. Et has eripuit impedit mediocrem.
+</p>
+<p>
+    Eu vim evertitur argumentum, pro legendos iudicabit voluptatibus ne. Ne alii nullam deserunt duo, vis no animal verterem. Ne quo veniam euripidis. Pri discere mentitum vituperatoribus ne. Meliore corrumpit vim at, has ea admodum convenire.
+</p>
+<p>
+    Ne mea alii detraxit electram, his ne epicurei gloriatur consetetur. Ex pro aeque omnes appareat, possit integre accommodare eu quo. Qui in porro molestiae, no sit equidem petentium patrioque, omnes voluptaria vim te. Odio quot rebum ad sed, ei sale reque inani sea.
+</p>
+<p>
+    At mea vidit petentium, mei lorem pertinacia signiferumque ne. Per eu dicam postea probatus, sea pericula accusamus omittantur ad. Id mei munere ullamcorper. Oportere ocurreret cu vel. Pri ne dicant soluta graecis, duis ponderum corrumpit sed eu, pro ei rebum vivendum.
+</p>
+<p>
+    Eum ea exerci sententiae constituam, ut lorem putant volutpat pro. Vix ex iudicabit salutatus principes, pri nisl erat ut, ne cum persius verterem phaedrum. Vix mundi vitae eu. Vel summo vocent albucius in. Qui omnis partem possim ex, wisi doctus efficiantur cu has. Aperiri denique ea pri, cum dissentias signiferumque eu. Per posse dissentiet necessitatibus id, omnis eleifend te mel.
+</p>
+<p>
+    Phaedrum erroribus adolescens ut nec, duo mutat viris id. In tale purto dolores sit, ei consul inermis est, his ea movet expetenda. Cibo scribentur id eam, per an quem iracundia, has erat zril solet eu. Falli fierent ne cum, eam placerat facilisis suscipiantur te. Id quo dicat tractatos definiebas, est copiosae splendide id.
+</p>
+<p>
+    Constituto neglegentur qui ne, eum ne putent phaedrum, no quod nominati consulatu per. Mei cu accusam principes interesset, vim fugit abhorreant eu, ludus feugait an sed. Clita expetendis definitionem has in, meis pericula no mea, soluta nemore cotidieque eos cu. Summo populo signiferumque pri eu, eum no labores democritum posidonium, pro ignota adipisci in. Tollit molestie id mei.
+</p>
+<p>
+    Ipsum impetus et eam, ei his epicuri instructior. Impedit ullamcorper vim an. Impedit ullamcorper vim an. Et eum senserit sententiae reprimique, quem detracto sententiae at sed, no inermis ocurreret rationibus sea pericula no.
+
+</body></html>
@@ -0,0 +1,49 @@
+<section class="todo-list">
+    <h1>
+        posuere cubilia Curae; Vestibulum hendrerit malesuada odio. Fusce ut elit
+        ut augue sollicitudin blandit. Phasellus volutpat lorem. Duis non pede et
+        neque luctus tincidunt. Duis interdum tempus elit.
+        <small>Aenean metus. Vestibulum ac lacus. Vivamus porttitor, massa ut.</small>
+    </h1>
+    <a href={{"/add" | url}} class="todo-add"><i class="fa fa-plus-square"></i>Add Todo</a>
+    <ul class="filter-category">
+        {% for i in (0..categories.length) %}
+        {% assign item=categories[i] %}
+        <li style="background: {{ item.color }}">
+            <a href="/todos/category/{{ item.id }}">{{ item.title }}</a>
+        </li>
+        {% endfor %}
+    </ul>
+    {% for todo in todos %}
+    <div>
+        <h2>
+            Todo {{ forloop.index }}:
+            <span class="todo-item content" data-todo-index="{{ forloop.index0 }}">
+                {{ todo.title | prepend: 'TODO: ' | upcase }}
+            </span>
+        </h2>
+    
+        <img
+            title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices"
+            src="{% include "todo-icon", id=todo.id }} %}"
+        >
+
+        <p class="description">
+            Purus eu mi. Proin commodo, massa commodo dapibus elementum,
+            libero lacus pulvinar eros, ut tincidunt nisl elit ut velit. Cras rutrum
+            porta purus. Vivamus lorem. Sed turpis enim, faucibus quis, pharetra in,
+            sagittis sed, magna. Curabitur ultricies felis ut libero. Nullam tincidunt
+            enim eu nibh. Nunc eget ipsum in sem facilisis convallis. Proin fermentum
+        </p>
+
+        <div class="todo-meta">
+            {% if todo.category %}
+                <span>{{  todo.category.title | capitalize }}</span>
+            {% endif %}
+        </div>
+        <a class="btn btn-primary" href={{"/edit/" | append todo.id | url }}><i class="fa fa-pencil"></i> Edit</a>
+        <a class="btn btn-default"><i class="fa fa-check"></i> Check</a>
+        <a class="btn ben-danger" href={{"/delete/" | append todo.id | url }}><i class="fa fa-trash-o"</i> Trash</a>
+    </div>
+    {% endfor %}
+</section>
@@ -0,0 +1,21 @@
+{
+  "extends": ["standard"],
+  "env": {
+    "mocha": true,
+    "es6": true,
+    "browser": true,
+    "node": true
+  },
+  "plugins": [
+    "mocha",
+    "standard",
+    "promise"
+  ],
+  "rules": {
+    "no-var": 2,
+    "prefer-const": 2,
+    "@typescript-eslint/no-var-requires": "off",
+    "no-unused-vars": "off",
+    "indent": "off"
+  }
+}
@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+rm -rf docs/source/api docs/source/zh-cn/api
+typedoc ./src --gitRevision master --out docs/source/api --plugin typedoc-plugin-markdown --theme vuepress
+rm docs/source/api/README.md
+
+for file in $(find docs/source/api -name "*.md"); do
+    sed -i \
+        -e 's/\(\]([^_)]*\)\/_/\1\//g' \
+        -e 's/\(\]([^)]*\.\)md/\1html/g' \
+        -e 's/\](_/\](/g' \
+        -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' \
+        -e '1 s/\*//g' \
+        -e '1 s/^# \(.*\)/---\ntitle: "\1"\nauto: true\n---/' \
+        $file
+    target=${file/\/_/\/}
+    if [ "$file" != "$target" ]; then
+        mv $file $target
+    fi
+done
+
+cp -r docs/source/api docs/source/zh-cn/api
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+cp .all-contributorsrc docs/.all-contributorsrc
+sed -i \
+    -e 's/README.md/docs\/themes\/navy\/layout\/partial\/all-contributors.swig/g' \
+    -e 's/"contributorsPerLine": 7/"contributorsPerLine": 65535/g' \
+    docs/.all-contributorsrc
+
+all-contributors --config docs/.all-contributorsrc generate
+sed -i 's/<br \/>.*<\/td>/<\/a><\/td>/g' docs/themes/navy/layout/partial/all-contributors.swig
@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+./bin/build-contributors.sh
+./bin/build-apidoc.sh
+
+cd docs
+npm ci
+npm run build
+cp CNAME public/
+
+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 '1i ---\ntitle: Changelog\nauto: true\n---\n' source/tutorials/changelog.md
+sed -i '1i ---\ntitle: 更新日志\nauto: true\n---\n' source/zh-cn/tutorials/changelog.md
+
+if [ "$HEXO_ALGOLIA_INDEXING_KEY" != "" ]; then
+    npm run index
+fi
@@ -0,0 +1,36 @@
+#!/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
@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const isQuote = c => c === '"' || c === "'"
+const isOperator = c => '!=<>'.includes(c)
+const isNumber = c => c >= '0' && c <= '9'
+const isCharacter = c => (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')
+const isIdentifier = c => '_-?'.includes(c) || isCharacter(c) || isNumber(c)
+const isBlank = c => c === '\n' || c === '\t' || c === ' ' || c === '\r' || c === '\v' || c === '\f'
+const isInlineBlank = c => c === '\t' || c === ' ' || c === '\r'
+const isSign = c => c === '-' || c === '+'
+// See https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+const unicodeBlanks = '\u00a0\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000'
+
+const types = []
+for (let i = 0; i < 128; i++) {
+  const c = String.fromCharCode(i)
+  let n = 0
+  if (isIdentifier(c)) n |= 1
+  if (isOperator(c)) n |= 2
+  if (isBlank(c)) n |= 4
+  if (isQuote(c)) n |= 8
+  if (isInlineBlank(c)) n |= 16
+  if (isNumber(c)) n |= 32
+  if (isSign(c)) n |= 64
+  types.push(n)
+}
+
+console.log(`
+// **DO NOT CHANGE THIS FILE**
+//
+// This file is generated by bin/character-gen.js
+// bitmask character types to boost performance
+export const TYPES = [${types.join(', ')}]
+export const IDENTIFIER = 1
+export const OPERATOR = 2
+export const BLANK = 4
+export const QUOTE = 8
+export const INLINE_BLANK = 16
+export const NUMBER = 32
+export const SIGN = 64
+`.trim())
+
+console.log([...unicodeBlanks].map(char => `TYPES[${char.charCodeAt(0)}]`).join(' = ') + ' = BLANK')
@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+
+const Liquid = require('..').Liquid
+const contextArg = process.argv.slice(2)[0]
+let context = {}
+
+if (contextArg) {
+  if (contextArg.endsWith('.json')) {
+    const fs = require('fs')
+    context = JSON.parse(fs.readFileSync(contextArg, 'utf8'))
+  } else {
+    context = JSON.parse(contextArg)
+  }
+}
+
+let tpl = ''
+process.stdin.on('data', chunk => (tpl += chunk))
+process.stdin.on('end', () => render(tpl))
+
+async function render (tpl) {
+  const liquid = new Liquid()
+  const html = await liquid.parseAndRender(tpl, context)
+  process.stdout.write(html)
+}
@@ -0,0 +1 @@
+module.exports = { extends: ['@commitlint/config-conventional'] }
@@ -0,0 +1,9 @@
+# LiquidJS for Browsers
+
+## Get Started
+
+```bash
+cd demo/browser
+npm install
+npm start
+```
@@ -1 +0,0 @@
-<h2>Welcome to {{ name | capitalize}}, {% include 'date.html' %}</h2>
@@ -3,27 +3,24 @@

 <head>
  <title>liquidjs for the browser</title>
-  <script src="../../dist/liquid.js"></script>
+  <script src="node_modules/liquidjs/dist/liquid.min.js"></script>
 </head>

 <body>
  <script>
-    var engine = window.Liquid({
+    var Liquid = window.liquidjs.Liquid
+    var engine = new Liquid({
      extname: '.html',
      cache: true
    });
-    var src = '<h2>Welcome to {{ name | capitalize}}, ' +
-      'access time: {{date|date: "%Y-%m-%d %H:%M:%S"}}&lt;/h2>';
+    var src = "<h2>Welcome to {{ name | capitalize}}, {% include 'date.html' %}</h2>";
    var ctx = {
      name: 'Liquid',
      date: new Date()
    };
    engine.parseAndRender(src, ctx)
      .then(function(html) {
-        return engine.renderFile('hello', ctx);
-      })
-      .then(function(html) {
-        document.body.innerHTML += html
+        document.body.innerHTML = html
      });
  </script>
 </body>
@@ -0,0 +1,16 @@
+{
+  "name": "liquidjs-demo-browser",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Liquidjs Demo for Browser Usage",
+  "main": "index.html",
+  "scripts": {
+    "start": "http-server -c-1 "
+  },
+  "author": "harttle <[email protected]>",
+  "license": "ISC",
+  "dependencies": {
+    "http-server": "^0.11.1",
+    "liquidjs": "*"
+  }
+}
@@ -0,0 +1,9 @@
+# LiquidJS for Express.js
+
+## Get Started
+
+```bash
+cd demo/express
+npm install
+npm start
+```
@@ -1,8 +1,8 @@
 const express = require('express')
-const Liquid = require('../..')
+const { Liquid } = require('liquidjs')

-let app = express()
-let engine = Liquid({
+const app = express()
+const engine = new Liquid({
  root: __dirname, // for layouts and partials
  extname: '.liquid'
 })
@@ -12,7 +12,7 @@ app.set('views', ['./partials', './views']) // specify the views directory
 app.set('view engine', 'liquid') // set to default

 app.get('/', function (req, res) {
-  let todos = ['fork and clone', 'make it better', 'make a pull request']
+  const todos = ['fork and clone', 'make it better', 'make a pull request']
  res.render('todolist', {
    todos: todos,
    title: 'Welcome to liquidjs!'
@@ -1,6 +1,7 @@
 {
  "name": "express-demo",
  "version": "1.0.0",
+  "private": true,
  "description": "Express Demo Using liquidjs",
  "main": "index.js",
  "scripts": {
@@ -10,6 +11,7 @@
  "author": "harttle",
  "license": "MIT",
  "dependencies": {
-    "express": "^4.14.0"
+    "express": "^4.14.0",
+    "liquidjs": "*"
  }
 }
@@ -0,0 +1,9 @@
+# LiquidJS for Node.js
+
+## Get Started
+
+```bash
+cd demo/nodejs
+npm install
+npm start
+```
@@ -1,12 +1,26 @@
-const Liquid = require('../..')
+const { Liquid } = require('liquidjs')

 const engine = new Liquid({
  root: __dirname,
  extname: '.liquid'
 })
+
+engine.registerTag('header', {
+  parse: function (token) {
+    const [key, val] = token.args.split(':')
+    this[key] = val
+  },
+  render: async function (scope, emitter) {
+    const title = await this.liquid.evalValue(this.content, scope)
+    emitter.write(`<h1>${title}</h1>`)
+  }
+})
+
 const ctx = {
  todos: ['fork and clone', 'make it better', 'make a pull request'],
  title: 'Welcome to liquidjs!'
 }

-engine.renderFile('todolist', ctx).then(console.log)
+engine.renderFile('todolist', ctx)
+  .then(console.log)
+  .catch(err => console.error(err.stack))
@@ -0,0 +1,12 @@
+{
+  "name": "liquidjs-demo-nodejs",
+  "description": "Node.js demo for liquidjs",
+  "private": true,
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "liquidjs": "*"
+  }
+}
@@ -1,3 +1,5 @@
+{%header content: "welcome to liquid" | capitalize%}
+
 <ul>
  {% for todo in todos %}
  <li>{{forloop.index}} - {{todo}}</li>
@@ -0,0 +1 @@
+SKIP_PREFLIGHT_CHECK=true
@@ -0,0 +1,3 @@
+{
+  "extends": ["react-app"]
+}
@@ -3,10 +3,8 @@
  "version": "0.1.0",
  "private": true,
  "dependencies": {
-    "dns": "^0.2.2",
    "html-react-parser": "^0.4.7",
-    "liquidjs": "^6.0.1",
-    "path": "^0.12.7",
+    "liquidjs": "^9.1.0",
    "react": "^16.5.2",
    "react-dom": "^16.5.2",
    "react-promise": "^2.0.3",
@@ -18,13 +16,13 @@
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  },
-  "eslintConfig": {
-    "extends": "react-app"
-  },
  "browserslist": [
    ">0.2%",
    "not dead",
    "not ie <= 11",
    "not op_mini all"
-  ]
+  ],
+  "devDependencies": {
+    "@babel/core": "^7.8.7"
+  }
 }
@@ -1,38 +1,17 @@
 import React, { Component } from 'react';
 import logo from './logo.svg';
 import './App.css';
+import tpl from './views/demo.liquid';
+import Parser from 'html-react-parser';
+import { engine } from './engine';

-let path   = require('path')
-let Liquid = require('liquidjs'); 
+export class App extends Component {
+  async componentDidMount() {
+    const html = await engine.renderFile(tpl.toString(), {name: 'alice', logo: logo })
+    this.setState({ html })  // outputs "Alice"
+  }

-let config = require('./views/demo.liquid');
-let pageConfig = config.toString()
-
-let Parser = require('html-react-parser');
-
-class App extends Component {
-
-componentDidMount() {
-
-  let engine = Liquid({
-      root: path.resolve(__dirname, 'views/'),  // dirs to lookup layouts/includes
-      extname: '.liquid'     // the extname used for layouts/includes, defaults 
-  });
-
-  engine.registerFilter('image', d => {
-    let img = `<img src="${d}" class="App-logo" alt="logo"></img>`;  
-    return img 
-  })
-    
-  engine.renderFile(pageConfig, {name: 'alice', logo: logo })
-    .then((htmlTemp) => {
-      this.setState({ html: htmlTemp })
-    })  // outputs "Alice"
-}
-
-state = { 
-  html: []
-}
+  state = { html: '' }

  render() { 
    return (
@@ -42,5 +21,3 @@ state = {
    );
  }
 }
-
-export default App;
@@ -0,0 +1,41 @@
+/*
+ * function Component with Hooks: Modify ./index.js to apply this file
+ */
+import React, { useState, useLayoutEffect } from 'react';
+import './App.css';
+import logo from './logo.svg';
+import tplsrc from './views/showing-click-times.liquid';
+import Parser from 'html-react-parser';
+import { engine } from './engine';
+import { Context } from './Context';
+import { ClickButton } from './ClickButton';
+
+const fetchTpl = engine.getTemplate(tplsrc.toString())
+
+export function App() {
+  const [state, setState] = useState({
+    logo: logo,
+    name: 'alice',
+    clickCount: 0,
+    html: ''
+  });
+
+  useLayoutEffect(() => {
+    fetchTpl
+      .then(tpl => engine.render(tpl, state))
+      .then(html => setState({...state, html}))
+  }, [state.clickCount])
+
+  return (
+    <div className="App">
+      {Parser(`${state.html}`)}
+      <Context.Provider
+        value={{
+          count: () => setState({...state, clickCount: state.clickCount + 1})
+        }}
+      >
+        <ClickButton/>
+      </Context.Provider>
+    </div>
+  );
+}
@@ -0,0 +1,5 @@
+button {
+  position: fixed;
+  right: 20px;
+  bottom: 20px;
+}
@@ -0,0 +1,15 @@
+import './ClickButton.css';
+import React from 'react';
+import { Context } from './Context';
+
+export function ClickButton() {
+  return (
+    <Context.Consumer>
+      {context => (
+        <button onClick={context.count}>
+          Click Here!
+        </button>
+      )}
+    </Context.Consumer>
+  );
+};
@@ -0,0 +1,3 @@
+import React from "react";
+
+export const Context = React.createContext()
@@ -0,0 +1,12 @@
+import path from 'path';
+import { Liquid } from 'liquidjs';
+
+export const engine = new Liquid({
+    root: path.resolve(__dirname, 'views/'),  // dirs to lookup layouts/includes
+    extname: '.liquid'     // the extname used for layouts/includes, defaults 
+});
+
+engine.registerFilter('image', d => {
+  let img = `<img src="${d}" class="App-logo" alt="logo"></img>`;  
+  return img 
+})
@@ -1,8 +1,9 @@
 import React from 'react';
 import ReactDOM from 'react-dom';
 import './index.css';
-import App from './App';
 import * as serviceWorker from './serviceWorker';
+import { App } from './App';
+// import { App } from './AppWithHooks';

 ReactDOM.render(<App />, document.getElementById('root'));

@@ -0,0 +1,14 @@
+<header className="App-header">
+    {{ logo | image }}
+    <h2>Welcome {{name | capitalize}}</h2>
+    <p>Edit <code>src/App.js</code> and save to reload.</p>
+    <p>You have clicked {{clickCount}} times.</p>
+    <a
+        className="App-link"
+        href="https://reactjs.org"
+        target="_blank"
+        rel="noopener noreferrer"
+    >
+        Learn React
+    </a>
+</header>
@@ -0,0 +1,11 @@
+# LiquidJS for TypeScript
+
+LiquidJS is written in TypeScript and type definitions are available in `liquidjs` package.
+
+## Get Started
+
+```bash
+cd demo/typescript
+npm install
+npm start
+```
@@ -0,0 +1,25 @@
+import { Liquid, TagToken, Context, Emitter } from 'liquidjs'
+
+const engine = new Liquid({
+  root: __dirname,
+  extname: '.liquid'
+})
+
+engine.registerTag('header', {
+  parse: function (token: TagToken) {
+    const [key, val] = token.args.split(':')
+    this[key] = val
+  },
+  render: async function (context: Context, emitter: Emitter) {
+    const title = await this.liquid.evalValue(this['content'], context)
+    emitter.write(`<h1>${title}</h1>`)
+  }
+})
+
+const ctx = {
+  todos: ['fork and clone', 'make it better', 'make a pull request'],
+  title: 'Welcome to liquidjs!'
+}
+
+// console.log('isTruthy:', isTruthy('a string here'));
+engine.renderFile('todolist', ctx).then(console.log)
@@ -0,0 +1,13 @@
+{
+  "name": "liquidjs-demo-typescript",
+  "private": true,
+  "description": "TypeScript demo for liquidjs",
+  "main": "index.ts",
+  "scripts": {
+    "start": "ts-node index.ts"
+  },
+  "dependencies": {
+    "ts-node": "^8.0.2",
+    "liquidjs": "*"
+  }
+}
@@ -0,0 +1,7 @@
+{%header content: "welcome to liquid" | capitalize%}
+
+<ul>
+  {% for todo in todos %}
+  <li>{{forloop.index}} - {{todo}}</li>
+  {% endfor %}
+</ul>
@@ -0,0 +1,7 @@
+.all-contributorsrc
+source/api/
+source/zh-cn/api/
+.vuepress
+db.json
+public
+changelog.md
@@ -0,0 +1 @@
+liquidjs.com
@@ -0,0 +1,32 @@
+title: LiquidJS
+subtitle: "A simple, expressive and safe template engine."
+description: "LiquidJS is a simple, expressive and safe template engine."
+author: Harttle
+language: en
+timezone: UTC
+
+url: https://liquidjs.com
+root: /
+permalink: news/:year/:month/:day/:title/
+relative_link: true
+new_post_name: :year-:month-:day-:title.md # File name of new posts
+post_asset_folder: true
+per_page: 0
+pretty_urls:
+  trailing_index: false
+  trailing_html: false
+
+theme: navy
+
+highlight:
+  enable: true
+  line_number: false
+
+algolia:
+  applicationID: 0X19J927JZ
+  apiKey: 533161d821384919672e4ce8a39451b3
+  indexName: liquidjs
+twitter: harttleharttle
+github: harttle/liquidjs
+patreon: harttle
+oc: liquidjs
@@ -0,0 +1,37 @@
+{
+  "name": "liquidjs-website",
+  "version": "0.0.0",
+  "private": true,
+  "hexo": {
+    "version": "4.2.0"
+  },
+  "scripts": {
+    "build": "hexo generate",
+    "start": "hexo serve",
+    "lint": "eslint .",
+    "index": "hexo algolia"
+  },
+  "dependencies": {
+    "cheerio": "^0.22.0",
+    "hexo": "^4.2.0",
+    "hexo-algolia": "^1.3.1",
+    "hexo-clean-css": "^1.0.0",
+    "hexo-filter-nofollow": "^2.0.2",
+    "hexo-generator-archive": "^1.0.0",
+    "hexo-generator-feed": "^2.0.0",
+    "hexo-generator-sitemap": "^2.0.0",
+    "hexo-renderer-marked": "^2.0.0",
+    "hexo-renderer-pug": "^1.0.0",
+    "hexo-renderer-stylus": "^1.0.0",
+    "hexo-server": "^1.0.0",
+    "hexo-uglify": "^1.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^6.0.1",
+    "eslint-config-hexo": "^4.0.0",
+    "all-contributors-cli": "^6.8.1"
+  },
+  "engines": {
+    "node": ">=8.10.0"
+  }
+}
@@ -0,0 +1,143 @@
+/* global hexo */
+
+'use strict'
+
+const { resolve, basename } = require('path')
+const { readFileSync } = require('fs')
+const cheerio = require('cheerio')
+const fullUrlFor = hexo.extend.helper.get('full_url_for').bind(hexo)
+
+const localizedPath = ['tutorials', 'filters', 'tags', 'playground', 'api']
+
+hexo.extend.helper.register('page_nav', function () {
+  const type = this.page.canonical_path.split('/')[0]
+  const sidebar = this.site.data.sidebar[type]
+  const path = basename(this.path)
+  const list = {}
+  const prefix = 'sidebar.' + type + '.'
+
+  for (const i in sidebar) {
+    if (typeof sidebar[i] === 'string') list[sidebar[i]] = i
+    else for (const j in sidebar[i]) list[sidebar[i][j]] = j
+  }
+
+  const keys = Object.keys(list)
+  const index = keys.indexOf(path)
+  let result = ''
+
+  if (index > 0) {
+    result += `<a href="${keys[index - 1]}" class="article-footer-prev" title="${this.__(prefix + list[keys[index - 1]])}"><i class="icon-chevron-left"></i><span>${this.__('page.prev')}</span></a>`
+  }
+
+  if (index < keys.length - 1) {
+    result += `<a href="${keys[index + 1]}" class="article-footer-next" title="${this.__(prefix + list[keys[index + 1]])}"><span>${this.__('page.next')}</span><i class="icon-chevron-right"></i></a>`
+  }
+
+  return result
+})
+
+hexo.extend.helper.register('raw', function (filepath) {
+  const content = readFileSync(resolve(this.view_dir, filepath))
+  return content
+})
+
+hexo.extend.helper.register('doc_sidebar', function (className) {
+  const type = this.page.canonical_path.split('/')[0]
+  const sidebar = this.site.data.sidebar[type]
+  const path = basename(this.path)
+  let result = ''
+  const { __ } = this
+  const prefix = 'sidebar.' + type + '.'
+
+  if (typeof sidebar === 'undefined') {
+    return ''
+  }
+
+  for (const [title, menu] of Object.entries(sidebar)) {
+    if (typeof menu === 'string') renderLink(title, menu)
+    else renderSection(title, menu)
+  }
+
+  return result
+
+  function renderLink (text, link) {
+    let itemClass = className + '-link'
+    if (link === path) itemClass += ' current'
+
+    const localized = __(prefix + text) === prefix + text ? text : __(prefix + text)
+    result += '<a href="' + link + '" class="' + itemClass + '">' + localized + '</a>'
+  }
+
+  function renderSection (title, menu) {
+    result += '<strong class="' + className + '-title">' + __(prefix + title) + '</strong>'
+    for (const [text, link] of Object.entries(menu)) renderLink(text, link)
+  }
+})
+
+hexo.extend.helper.register('header_menu', function (className) {
+  const menu = this.site.data.menu
+  let result = ''
+  const lang = this.page.lang
+  const isEnglish = lang === 'en'
+
+  for (const [title, path] of Object.entries(menu)) {
+    let langPath = path
+    if (!isEnglish && ~localizedPath.indexOf(title)) langPath = lang + path
+    const url = this.url_for(langPath)
+    const active = ('/' + this.page.canonical_path).slice(0, path.length) === path ? ' active' : ''
+    result += `<a href="${url}" class="${className}-link${active}">${this.__('menu.' + title)}</a>`
+  }
+
+  return result
+})
+
+hexo.extend.helper.register('canonical_url', function (lang) {
+  let path = this.page.path
+  if (lang && lang !== 'en') path = lang + '/' + path
+
+  return fullUrlFor(path)
+})
+
+hexo.extend.helper.register('url_for_lang', function (path) {
+  const lang = this.page.lang
+  let url = this.url_for(path)
+
+  if (lang !== 'en' && path[0] === '/') url = '/' + lang + path
+
+  return url
+})
+
+hexo.extend.helper.register('raw_link', path => `https://github.com/harttle/liquidjs/edit/master/docs/source/${path}`)
+
+hexo.extend.helper.register('page_anchor', str => {
+  const $ = cheerio.load(str, { decodeEntities: false })
+  const headings = $('h1, h2, h3, h4, h5, h6')
+
+  if (!headings.length) return str
+
+  headings.each(function () {
+    const id = $(this).attr('id')
+
+    $(this)
+      .addClass('article-heading')
+      .append(`<a class="article-anchor" href="#${id}" aria-hidden="true"></a>`)
+  })
+
+  return $.html()
+})
+
+// Will be replace with fullUrlFor after hexo v4 release
+hexo.extend.helper.register('canonical_path_for_nav', function () {
+  const path = this.page.canonical_path
+  for (const slug of localizedPath) if (path.startsWith(slug)) return path
+  return ''
+})
+
+hexo.extend.helper.register('lang_name', function (lang) {
+  const data = this.site.data.languages[lang]
+  return data.name || data
+})
+
+hexo.extend.helper.register('hexo_version', function () {
+  return this.env.version
+})
@@ -0,0 +1,19 @@
+/* global hexo */
+
+'use strict'
+
+hexo.extend.tag.register('note', (args, content) => {
+  const className = args.shift()
+  let header = ''
+  let result = ''
+
+  if (args.length) {
+    header += `<strong class="note-title">${args.join(' ')}</strong>`
+  }
+
+  result += `<blockquote class="note ${className}">${header}`
+  result += hexo.render.renderSync({ text: content, engine: 'markdown' })
+  result += '</blockquote>'
+
+  return result
+}, true)
@@ -0,0 +1,3 @@
+en: English
+zh-cn:
+  name: 简体中文
@@ -0,0 +1,5 @@
+tutorials: /tutorials/setup.html
+tags: /tags/overview.html
+filters: /filters/overview.html
+playground: /playground.html
+api: /api/classes/liquid_.liquid.html
@@ -0,0 +1,24 @@
+-
+  url: https://github.com/harttle/liquidjs/pull/5
+  date: '2016-09-12'
+  title:
+    zh-cn: '异步化：重写了解析器和渲染器，使 LiquidJS 可以提供 Promise API 并支持异步的自定义 Tag 实现。'
+    en: 'Async spike: rewrite the parser and render to support Promise, which enables async tags.'
+-
+  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%.'
@@ -0,0 +1,138 @@
+tutorials:
+  getting_started:
+    intro: intro-to-liquid.html
+    setup: setup.html
+    options: options.html
+    render_file: render-file.html
+    partials: partials-and-layouts.html
+    express: use-in-expressjs.html
+  advanced:
+    caching: caching.html
+    registeration: register-filters-tags.html
+    whitespace: whitespace-control.html
+    plugins: plugins.html
+    operators: operators.html
+    truth: truthy-and-falsy.html
+  miscellaneous:
+    migration9: migrate-to-9.html
+    changelog: changelog.html
+    differences: differences.html
+    contribution_guidelines: contribution-guidelines.html
+
+filters:
+  overview: overview.html
+  abs: abs.html
+  append: append.html
+  at_least: at_least.html
+  at_most: at_most.html
+  capitalize: capitalize.html
+  ceil: ceil.html
+  date: date.html
+  default: default.html
+  divided_by: divided_by.html
+  downcase: downcase.html
+  escape: escape.html
+  escape_once: escape_once.html
+  first: first.html
+  floor: floor.html
+  join: join.html
+  json: json.html
+  last: last.html
+  lstrip: lstrip.html
+  map: map.html
+  minus: minus.html
+  modulo: modulo.html
+  newline_to_br: newline_to_br.html
+  plus: plus.html
+  prepend: prepend.html
+  remove: remove.html
+  remove_first: remove_first.html
+  replace: replace.html
+  replace_first: replace_first.html
+  reverse: reverse.html
+  round: round.html
+  rstrip: rstrip.html
+  size: size.html
+  slice: slice.html
+  sort: sort.html
+  sort_natural: sort_natural.html
+  split: split.html
+  strip: strip.html
+  strip_html: strip_html.html
+  strip_newlines: strip_newlines.html
+  times: times.html
+  truncate: truncate.html
+  truncatewords: truncatewords.html
+  uniq: uniq.html
+  upcase: upcase.html
+  url_decode: url_decode.html
+  url_encode: url_encode.html
+  where: where.html
+
+tags:
+  overview: overview.html
+  assign: assign.html
+  capture: capture.html
+  case: case.html
+  comment: comment.html
+  cycle: cycle.html
+  decrement: decrement.html
+  for: for.html
+  if: if.html
+  include: include.html
+  increment: increment.html
+  layout: layout.html
+  raw: raw.html
+  render: render.html
+  tablerow: tablerow.html
+  unless: unless.html
+
+api:
+  quick_entry:
+    Liquid: "../classes/liquid_.liquid.html"
+    LiquidOptions: "../interfaces/liquid_options_.liquidoptions.html"
+    FS: "../interfaces/fs_fs_.fs.html"
+    Cache: "../interfaces/cache_cache_.cache.html"
+  classes:
+    BlankDrop: "../classes/drop_blank_drop_.blankdrop.html"
+    Context: "../classes/context_context_.context.html"
+    DelimitedToken: "../classes/tokens_delimited_token_.delimitedtoken.html"
+    Drop: "../classes/drop_drop_.drop.html"
+    EmptyDrop: "../classes/drop_empty_drop_.emptydrop.html"
+    Expression: "../classes/render_expression_.expression.html"
+    FilterToken: "../classes/tokens_filter_token_.filtertoken.html"
+    ForloopDrop: "../classes/drop_forloop_drop_.forloopdrop.html"
+    HTMLToken: "../classes/tokens_html_token_.htmltoken.html"
+    HashToken: "../classes/tokens_hash_token_.hashtoken.html"
+    LRU: "../classes/cache_lru_.lru.html"
+    Liquid: "../classes/liquid_.liquid.html"
+    LiteralToken: "../classes/tokens_literal_token_.literaltoken.html"
+    NullDrop: "../classes/drop_null_drop_.nulldrop.html"
+    NumberToken: "../classes/tokens_number_token_.numbertoken.html"
+    OperatorToken: "../classes/tokens_operator_token_.operatortoken.html"
+    OutputToken: "../classes/tokens_output_token_.outputtoken.html"
+    ParseError: "../classes/util_error_.parseerror.html"
+    ParseStream: "../classes/parser_parse_stream_.parsestream.html"
+    Parser: "../classes/parser_parser_.parser.html"
+    PropertyaccessToken: "../classes/tokens_property_access_token_.propertyaccesstoken.html"
+    QuotedToken: "../classes/tokens_quoted_token_.quotedtoken.html"
+    RangeToken: "../classes/tokens_range_token_.rangetoken.html"
+    Render: "../classes/render_render_.render.html"
+    RenderError: "../classes/util_error_.rendererror.html"
+    TablerowloopDrop: "../classes/drop_tablerowloop_drop_.tablerowloopdrop.html"
+    TagToken: "../classes/tokens_tag_token_.tagtoken.html"
+    Token: "../classes/tokens_token_.token.html"
+    TokenizationError: "../classes/util_error_.tokenizationerror.html"
+    Tokenizer: "../classes/parser_tokenizer_.tokenizer.html"
+    WordToken: "../classes/tokens_word_token_.wordtoken.html"
+  enums:
+    BlockMode: "../enums/context_block_mode_.blockmode.html"
+    TokenKind: "../enums/parser_token_kind_.tokenkind.html"
+  interfaces:
+    Cache: "../interfaces/cache_cache_.cache.html"
+    FilterImplOptions: "../interfaces/template_filter_filter_impl_options_.filterimploptions.html"
+    FS: "../interfaces/fs_fs_.fs.html"
+    LiquidOptions: "../interfaces/liquid_options_.liquidoptions.html"
+    NormalizedFullOptions: "../interfaces/liquid_options_.normalizedfulloptions.html"
+    PlainObject: "../interfaces/context_scope_.plainobject.html"
+    TagImplOptions: "../interfaces/template_tag_tag_impl_options_.tagimploptions.html"
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<browserconfig>
+  <msapplication>
+    <tile>
+      <square70x70logo src="/icon/mstile-70x70.png"/>
+      <square150x150logo src="/icon/mstile-150x150.png"/>
+      <square310x310logo src="/icon/mstile-310x310.png"/>
+      <wide310x150logo src="/icon/mstile-310x150.png"/>
+      <TileColor>#2f83cd</TileColor>
+    </tile>
+  </msapplication>
+</browserconfig>
@@ -0,0 +1,37 @@
+---
+title: abs
+---
+
+Liquid filter that returns the absolute value of a number.
+
+Input
+```liquid
+{{ -17 | abs }}
+```
+
+Output
+```text
+17
+```
+
+Input
+```liquid
+{{ 4 | abs }}
+```
+
+Output
+```text
+4
+```
+
+`abs` will also work on a string that only contains a number:
+
+Input
+```liquid
+{{ "-19.86" | abs }}
+```
+
+Output
+```text
+19.86
+```
@@ -0,0 +1,29 @@
+---
+title: append
+---
+
+Concatenates two strings and returns the concatenated value.
+
+Input
+```liquid
+{{ "/my/fancy/url" | append: ".html" }}
+```
+
+Output
+```text
+/my/fancy/url.html
+```
+
+`append` can also be used with variables:
+
+Input
+```liquid
+{% assign filename = "/index.html" %}
+{{ "website.com" | append: filename }}
+```
+
+Output
+```text
+
+website.com/index.html
+```
@@ -0,0 +1,25 @@
+---
+title: at_least
+---
+
+Limits a number to a minimum value.
+
+Input
+```liquid
+{{ 4 | at_least: 5 }}
+```
+
+Output
+```text
+5
+```
+
+Input
+```liquid
+{{ 4 | at_least: 3 }}
+```
+
+Output
+```text
+4
+```
@@ -0,0 +1,25 @@
+---
+title: at_most
+---
+
+Limits a number to a maximum value.
+
+Input
+```liquid
+{{ 4 | at_most: 5 }}
+```
+
+Output
+```text
+4
+```
+
+Input
+```liquid
+{{ 4 | at_most: 3 }}
+```
+
+Output
+```text
+3
+```
@@ -0,0 +1,27 @@
+---
+title: capitalize
+---
+
+Makes the first character of a string capitalized.
+
+Input
+```liquid
+{{ "title" | capitalize }}
+```
+
+Output
+```text
+Title
+```
+
+`capitalize` only capitalizes the first character of a string, so later words are not affected:
+
+ Input
+```liquid
+{{ "my great title" | capitalize }}
+```
+
+Output
+```text
+My great title
+```
@@ -0,0 +1,47 @@
+---
+title: ceil
+---
+
+Rounds the input up to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied.
+
+Input
+```liquid
+{{ 1.2 | ceil }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ 2.0 | ceil }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ 183.357 | ceil }}
+```
+
+Output
+```text
+184
+```
+
+Here the input value is a string:
+
+Input
+```liquid
+{{ "3.5" | ceil }}
+```
+
+Output
+```text
+4
+```
@@ -0,0 +1,47 @@
+---
+title: compact
+---
+
+Removes any `nil` values from an array.
+
+For this example, assume `site.pages` is an array of content pages for a website, and some of these pages have an attribute called `category` that specifies their content category. If we `map` those categories to an array, some of the array items might be `nil` if any pages do not have a `category` attribute.
+
+Input
+```liquid
+{% assign site_categories = site.pages | map: "category" %}
+
+{% for category in site_categories %}
+- {{ category }}
+{% endfor %}
+```
+
+Output
+```text
+- business
+- celebrities
+-
+- lifestyle
+- sports
+-
+- technology
+```
+
+By using `compact` when we create our `site_categories` array, we can remove all the `nil` values in the array.
+
+Input
+```liquid
+{% assign site_categories = site.pages | map: "category" | compact %}
+
+{% for category in site_categories %}
+- {{ category }}
+{% endfor %}
+```
+
+Output
+```text
+- business
+- celebrities
+- lifestyle
+- sports
+- technology
+```
@@ -0,0 +1,53 @@
+---
+title: concat
+---
+
+Concatenates (joins together) multiple arrays. The resulting array contains all the items from the input arrays.
+
+Input
+```liquid
+{% assign fruits = "apples, oranges, peaches" | split: ", " %}
+{% assign vegetables = "carrots, turnips, potatoes" | split: ", " %}
+
+{% assign everything = fruits | concat: vegetables %}
+
+{% for item in everything %}
+- {{ item }}
+{% endfor %}
+```
+
+Output
+```text
+- apples
+- oranges
+- peaches
+- carrots
+- turnips
+- potatoes
+```
+
+You can string together `concat` filters to join more than two arrays:
+
+Input
+```liquid
+{% assign furniture = "chairs, tables, shelves" | split: ", " %}
+
+{% assign everything = fruits | concat: vegetables | concat: furniture %}
+
+{% for item in everything %}
+- {{ item }}
+{% endfor %}
+```
+
+Output
+```text
+- apples
+- oranges
+- peaches
+- carrots
+- turnips
+- potatoes
+- chairs
+- tables
+- shelves
+```
@@ -0,0 +1,53 @@
+---
+title: date
+---
+
+Converts a timestamp into another date format. LiquidJS tries to be conformant with Shopify/Liquid which is using Ruby's core [Time#strftime(string)](http://www.ruby-doc.org/core/Time.html#method-i-strftime). The input is firstly converted to `Date` object via [new Date()][newDate].
+
+Input
+```liquid
+{{ article.published_at | date: "%a, %b %d, %y" }}
+```
+
+Output
+```text
+Fri, Jul 17, 15
+```
+
+Input
+```liquid
+{{ article.published_at | date: "%Y" }}
+```
+
+Output
+```text
+2015
+```
+
+`date` works on strings if they contain well-formatted dates:
+
+Input
+```liquid
+{{ "March 14, 2016" | date: "%b %d, %y" }}
+```
+
+Output
+```text
+Mar 14, 16
+```
+
+To get the current time, pass the special word `"now"` (or `"today"`) to `date`:
+
+Input
+```liquid
+This page was last updated at {{ "now" | date: "%Y-%m-%d %H:%M" }}.
+```
+
+Output
+```text
+This page was last updated at 2020-03-25 15:57.
+```
+
+{% note info now %}Note that the value will be the current time of when the page was last generated from the template, not when the page is presented to a user if caching or static site generation is involved.{% endnote %}
+
+[newDate]: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date
@@ -0,0 +1,45 @@
+---
+title: default
+---
+
+Allows you to specify a fallback in case a value doesn't exist. `default` will show its value if the left side is [falsy][falsy] or empty (`string` or `Array`).
+
+In this example, `product_price` is not defined, so the default value is used.
+
+Input
+```liquid
+{{ product_price | default: 2.99 }}
+```
+
+Output
+```text
+2.99
+```
+
+In this example, `product_price` is defined, so the default value is not used.
+
+Input
+```liquid
+{% assign product_price = 4.99 %}
+{{ product_price | default: 2.99 }}
+```
+
+Output
+```text
+4.99
+```
+
+In this example, `product_price` is empty, so the default value is used.
+
+Input
+```liquid
+{% assign product_price = "" %}
+{{ product_price | default: 2.99 }}
+```
+
+Output
+```text
+2.99
+```
+
+[falsy]: ../tutorials/truthy-and-falsy.html
@@ -0,0 +1,29 @@
+---
+title: divided_by
+---
+
+Divides a number by another number. The result is the string obtained by JavaScript `.toString()` of the result number.
+
+Input
+```liquid
+{{ 16 | divided_by: 4 }}
+```
+
+Output
+```text
+4
+```
+
+Input
+```liquid
+{{ 5 | divided_by: 3 }}
+```
+
+Output
+```text
+1.6666666666666667
+```
+
+{% note info Integer Arithmetic %}Since JavaScript doesn't differentiate integers and floats, LiquidJS is not capable of integer arithmetic and the return type is always `number`, the string representation of which depends on its value.{% endnote %}
+
+[floor]: ./floor.html
@@ -0,0 +1,25 @@
+---
+title: downcase
+---
+
+Makes each character in a string lowercase. It has no effect on strings which are already all lowercase.
+
+Input
+```liquid
+{{ "Parker Moore" | downcase }}
+```
+
+Output
+```text
+parker moore
+```
+
+Input
+```liquid
+{{ "apple" | downcase }}
+```
+
+Output
+```text
+apple
+```
@@ -0,0 +1,25 @@
+---
+title: escape
+---
+
+Escapes a string by replacing HTML special characters with escape sequences. It doesn't change strings that don't have anything to escape.
+
+Input
+```liquid
+{{ "Have you read 'James & the Giant Peach'?" | escape }}
+```
+
+Output
+<pre class="highlight">
+{{"Have you read &#39;James &amp; the Giant Peach&#39;?" | escape}}
+</pre>
+
+Input
+```liquid
+{{ "Tetsuro Takara" | escape }}
+```
+
+Output
+```text
+Tetsuro Takara
+```
@@ -0,0 +1,25 @@
+---
+title: escape_once
+---
+
+Escapes a string without changing existing escaped entities. It doesn't change strings that don't have anything to escape.
+
+Input
+```liquid
+{{ "1 < 2 & 3" | escape_once }}
+```
+
+Output
+<pre class="highlight">
+{{"1 &lt; 2 &amp; 3" | escape}}
+</pre>
+
+Input
+<pre class="highlight">
+&#x7B;&#x7B; "{{"1 &lt; 2 &amp; 3" | escape}}" | escape_once }}
+</pre>
+
+Output
+<pre class="highlight">
+{{"1 &lt; 2 &amp; 3" | escape}}
+</pre>
@@ -0,0 +1,35 @@
+---
+title: first
+---
+
+Returns the first item of an array.
+
+Input
+```liquid
+{{ "Ground control to Major Tom." | split: " " | first }}
+```
+
+Output
+```text
+Ground
+```
+
+Input
+```liquid
+{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
+{{ my_array.first }}
+```
+
+Output
+```text
+
+zebra
+```
+
+You can use `first` with dot notation when you need to use the filter inside a tag:
+
+```liquid
+{% if my_array.first == "zebra" %}
+  Here comes a zebra!
+{% endif %}
+```
@@ -0,0 +1,47 @@
+---
+title: floor
+---
+
+Rounds the input down to the nearest whole number. LiquidJS tries to convert the input to a number before the filter is applied.
+
+Input
+```liquid
+{{ 1.2 | floor }}
+```
+
+Output
+```text
+1
+```
+
+Input
+```liquid
+{{ 2.0 | floor }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ 183.357 | floor }}
+```
+
+Output
+```text
+183
+```
+
+Here the input value is a string:
+
+Input
+```liquid
+{{ "3.5" | floor }}
+```
+
+Output
+```text
+3
+```
@@ -0,0 +1,17 @@
+---
+title: join
+---
+
+Combines the items in an array into a single string using the argument as a separator.
+
+Input
+```liquid
+{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
+{{ beatles | join: " and " }}
+```
+
+Output
+```text
+
+John and Paul and George and Ringo
+```
@@ -0,0 +1,16 @@
+---
+title: json
+---
+
+Convert values to string via `JSON.stringify()`, for debug purpose.
+
+Input
+```liquid
+{% assign arr = "foo bar coo" | split: " " %}
+{{ arr | json }}
+```
+
+Output
+```text
+["foo","bar","coo"]
+```
@@ -0,0 +1,35 @@
+---
+title: last
+---
+
+Returns the last item of an array.
+
+Input
+```liquid
+{{ "Ground control to Major Tom." | split: " " | last }}
+```
+
+Output
+```text
+Tom.
+```
+
+Input
+```liquid
+{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
+{{ my_array.last }}
+```
+
+Output
+```text
+
+tiger
+```
+
+You can use `last` with dot notation when you need to use the filter inside a tag:
+
+```liquid
+{% if my_array.last == "tiger" %}
+  There goes a tiger!
+{% endif %}
+```
@@ -0,0 +1,15 @@
+---
+title: lstrip
+---
+
+Removes all whitespace (tabs, spaces, and newlines) from the left side of a string. It does not affect spaces between words.
+
+Input
+```liquid
+BEGIN{{ "          So much room for activities!          " | lstrip }}END
+```
+
+Output
+```text
+BEGINSo much room for activities!          END
+```
@@ -0,0 +1,25 @@
+---
+title: map
+---
+
+Creates an array of values by extracting the values of a named property from another object.
+
+In this example, assume the object `site.pages` contains all the metadata for a website. Using `assign` with the `map` filter creates a variable that contains only the values of the `category` properties of everything in the `site.pages` object.
+
+Input
+```liquid
+{% assign all_categories = site.pages | map: "category" %}
+
+{% for item in all_categories %}
+- {{ item }}
+{% endfor %}
+```
+
+Output
+```text
+- business
+- celebrities
+- lifestyle
+- sports
+- technology
+```
@@ -0,0 +1,35 @@
+---
+title: minus
+---
+
+Subtracts a number from another number.
+
+Input
+```liquid
+{{ 4 | minus: 2 }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ 16 | minus: 4 }}
+```
+
+Output
+```text
+12
+```
+
+Input
+```liquid
+{{ 183.357 | minus: 12 }}
+```
+
+Output
+```text
+171.357
+```
@@ -0,0 +1,35 @@
+---
+title: modulo
+---
+
+Returns the remainder of a division operation.
+
+Input
+```liquid
+{{ 3 | modulo: 2 }}
+```
+
+Output
+```text
+1
+```
+
+Input
+```liquid
+{{ 24 | modulo: 7 }}
+```
+
+Output
+```text
+3
+```
+
+Input
+```liquid
+{{ 183.357 | modulo: 12 }}
+```
+
+Output
+```text
+3.3569999999999993
+```
@@ -0,0 +1,21 @@
+---
+title: newline_to_br
+---
+
+Replaces every newline (`\n`) in a string with an HTML line break (`<br />`).
+
+Input
+```liquid
+{% capture string_with_newlines %}
+Hello
+there
+{% endcapture %}
+
+{{ string_with_newlines | newline_to_br }}
+```
+
+Output
+```html
+
+<br/>Hello<br/>there<br/>
+```
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`module.exports = { extends: ['@commitlint/config-conventional'] }`
				`@@ -1 +0,0 @@`
				`<h2>Welcome to {{ name \| capitalize}}, {% include 'date.html' %}</h2>`