chore(release): 9.11.7 [skip ci]

## [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))
chore: try fix travis again
2026-09-15 04:10:40 -07:00 · 2020-03-28 10:12:33 +00:00 · 2020-03-28 18:08:30 +08:00 · 2020-03-28 17:50:51 +08:00 · 2020-03-28 17:21:07 +08:00 · 2020-03-25 17:42:48 +00:00
544 changed files with 44058 additions and 7504 deletions
@@ -0,0 +1,267 @@
+{
+  "projectName": "liquidjs",
+  "projectOwner": "harttle",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": true,
+  "commitConvention": "eslint",
+  "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"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true
+}
@@ -0,0 +1,5 @@
+node_modules
+dist
+demo
+coverage
+docs
@@ -0,0 +1,40 @@
+{
+  "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,
+    "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']
@@ -1,40 +1,19 @@
-# Logs
-logs
+# logs
 *.log
 npm-debug.log*

-# Runtime data
-pids
-*.pid
-*.seed
+# cache
+.rpt2_cache
+coverage/
+.nyc_output/

-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+# modules
+node_modules/
+dist/
+demo/*/package-lock.json
+demo/*/yarn.json

-# Coverage directory used by tools like istanbul
-coverage
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules
-jspm_packages
-
-# Optional npm cache directory
-.npm
-
-# Optional REPL history
-.node_repl_history
-
-# vim
+# editors
 .*.swp
+.vscode
+
@@ -1 +0,0 @@
-test/
@@ -1,7 +1,28 @@
 language: node_js
 node_js:
-  - "4"
-before_script:
-  - npm install -g mocha
-after_script: 
-  - NODE_ENV=test ./node_modules/.bin/istanbul cover --report lcovonly ./node_modules/mocha/bin/_mocha -- -R spec --recursive && cat ./coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js && rm -rf ./coverage
+    - "10"
+    - "8"
+jobs:
+  include:
+    - stage: test
+      name: 'Linting'
+      script:
+        - npm run lint
+        - commitlint-travis
+    - name: 'Coverage'
+      script: npm run coverage-coveralls
+    - stage: release
+      name: 'Publish'
+      if: branch = master
+      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
+        local_dir: docs/public
@@ -0,0 +1,462 @@
+## [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)
+
+
+### Bug Fixes
+
+* regenerator undefined ([a2caeb5](https://github.com/harttle/liquidjs/commit/a2caeb5))
@@ -1,219 +1,144 @@
-# shopify-liquid
+# liquidjs
+[![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)
+[![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)

-[![NPM version](https://img.shields.io/npm/v/shopify-liquid.svg?style=flat)](https://www.npmjs.org/package/shopify-liquid)
-[![Build Status](https://travis-ci.org/harttle/shopify-liquid.svg?branch=master)](https://travis-ci.org/harttle/shopify-liquid)
-[![Coverage Status](https://img.shields.io/coveralls/harttle/shopify-liquid/master.svg)](https://coveralls.io/github/harttle/shopify-liquid?branch=master)
-[![Dependency manager](https://img.shields.io/david/harttle/shopify-liquid.svg?style=flat)](https://david-dm.org/harttle/shopify-liquid)
+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.

-A feature-rich Liquid template engine for Node.js and browsers,
-with compliance with [the Ruby version][shopify-liquid].
-New to Liquid? Here's a live demo: <http://harttle.com/shopify-liquid/>
+* [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.
+* All features, filters and tags in [shopify/liquid](https://github.com/Shopify/liquid) are supposed to be built in LiquidJS, though there are still some differences and limitations (see below).

-> The Liquid template engine is implemented in Ruby originally, 
-> which is used by [Jekyll][jekyll] and [Github Pages][gh].
+> Version 9 has published, [see how to migrate to 9.0.0](https://github.com/harttle/liquidjs/wiki/Migrate-to-9)!

-Features:
+## Get Started

-* Pretty much [builtin filters](https://github.com/harttle/shopify-liquid/wiki/Builtin-Filters) and [builtin tags](https://github.com/harttle/shopify-liquid/wiki/Builtin-Tags)
-* Async rendering, especially for tags
-* [any-promise][any-promise]
-
-Installation:
+Install via npm:

 ```bash
-npm install --save shopify-liquid
+npm install --save liquidjs
 ```

-## Render from String
-
-Parse and Render:
-
 ```javascript
-var Liquid = require('shopify-liquid');
-var engine = Liquid();
+var { Liquid } = require('liquidjs');
+var engine = new Liquid();

-engine.parseAndRender('{{name | capitalize}}', {name: 'alice'})
-    .then(function(html){
-        // html === 'Alice'
-    });
+engine
+    .parseAndRender('{{name | capitalize}}', {name: 'alice'})
+    .then(console.log);     // outputs 'Alice'
 ```

-Caching templates:
-
-```javascript
-var tpl = engine.parse('{{name | capitalize}}');
-engine.render(tpl, {name: 'alice'})
-    .then(function(html){   
-        // html === 'Alice'
-    });
-```
-
-## Render from File
-
-```javascript
-var engine = Liquid({
-    root: path.resolve(__dirname, 'views/'),  // for layouts and includes
-    extname: '.liquid',
-    cache: false,
-    strict_filters: false,       // default: false
-    strict_variables: false      // default: false
-});
-engine.renderFile("hello.liquid", {name: 'alice'})
-    .then(function(html){
-       // html === 'Alice'
-    });
-// equivalent to: 
-engine.renderFile("hello", {name: 'alice'})
-    .then(function(html){
-       // html === 'Alice'
-    });
-```
-
-* `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 `process.cwd()`
-
-* `extname` is used to lookup the template file when filepath doesn't include an extension name. Defaults to `.liquid`
-
-* `cache` indicates whether or not to cache resolved templates. Defaults to `false`.
-
-* `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`.
-
-## Use with Express.js
-
-```javascript
-// register liquid engine
-app.engine('liquid', engine.express({
-    strict_variables: true,         // Default: fasle
-    strict_filters: true            // Default: false
-})); 
-app.set('views', './views');            // specify the views directory
-app.set('view engine', 'liquid');       // set to default
-```
-
-> There's an Express demo [here](demo/express/).
-
-When using with Express.js, partials(includes and layouts) will be looked up in
-both Liquid `root` and Express `views` directories.
-
-## Use in Browser
-
-[Download][releases] the dist files and import into your HTML.
-And `window.Liquid` is what you want. There's also a [demo](demo/browser/).
+Or include the UMD build, a live demo is available on jsfiddle: <https://jsfiddle.net/x43eb0z6/>. You may need a [Promise polyfill][pp] for Node.js &lt; 4 and ES5 browsers like [IE and Android UC][caniuse-promises].

 ```html
-<html lang="en">
-<head>
-  <script src="dist/liquid.min.js"></script>
-</head>
-<body>
-  <script>
-    var engine = window.Liquid();
-    var src = '{{ name | capitalize}}';
-    var ctx = {
-      name: 'welcome to Shopify Liquid'
-    };
-    engine.parseAndRender(src, ctx)
-      .then(function(html) {
-        // html === Welcome to Shopify Liquid 
-      });
-  </script>
-</body>
-</html>
+<script src="//unpkg.com/liquidjs/dist/liquid.min.js"></script>     <!--for production-->
+<script src="//unpkg.com/liquidjs/dist/liquid.js"></script>         <!--for development-->
 ```

-Note: In [IE and Android UC][caniuse-promises] browser, you need a Promise implementation
-registered to [any-promise][any-promise].
+Also available from CLI:

-## Includes
-
-```
-// 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' %}
+```bash
+echo '{{"hello" | capitalize}}' | npx liquidjs
 ```

-The output will be:
+For detailed documents, see:

-```
-color: '' shape: 'circle'
-color: 'red' shape: 'circle'
-color: 'yellow' shape: 'square'
-```
+* The [Wiki Page](https://github.com/harttle/liquidjs/wiki) contains tutorials and advanced topics.
+* The [API Reference](https://harttle.github.io/liquidjs/classes/_liquid_.liquid.html) provides detailed descriptions for classes, methods and properties.

-## Layouts
+## Differences and Limitations

-```
-// file: default-layout.liquid
-Header
-{% block content %}My default content{% endblock %}
-Footer
+* Dynamic file locating (enabled by default), that means layout/partial names are treated as variables 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. In JavaScript we cannot distinguish or convert between `float` and `integer`, see [#59](https://github.com/harttle/liquidjs/issues/59). And when applied `size` filter, numbers always return 0, which is 8 for integer in ruby, cause they do not have a `length` property.
+* [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) is replaced by `.toLiquid()`
+* [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) is replaced by JavaScript `.toString()`
+* Iteration order for objects. The iteration order of JavaScript objects, and thus LiquidJS objects, is a combination of the insertion order for string keys, and ascending order for number-like keys, while the iteration order of Ruby Hash is simply the insertion order.
+* Sort stability. The [sort](https://shopify.github.io/liquid/filters/sort/) stability is also not defined in both shopify/liquid and LiquidJS, but it's [considered stable](https://v8.dev/features/stable-sort) for LiquidJS in Node.js 12+ and Google Chrome 70+.

-// file: page.liquid
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
+Features that available on shopify website but not on shopify/liquid repo will not be implemented in this repo,
+but there're some plugins available: <https://github.com/harttle/liquidjs/wiki/Plugins>

-The output of `page.liquid`:
+## Related Packages

-```
-Header
-My page content
-Footer
-```
+* [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.

-* It's possible to define multiple blocks.
-* block name is optional when there's only one block.
+## Backers

-## Register Filters
+Love LiquidJS and want to contribute? [Become a backer](https://opencollective.com/liquidjs).

-```javascript
-// Usage: {{ name | uppper }}
-engine.registerFilter('upper', function(v){
-    return v.toUpperCase();
-});
-```
+![backers from open-collective](https://opencollective.com/liquidjs/tiers/backer.svg?avatarHeight=97)

-> See existing filter implementations: <https://github.com/harttle/shopify-liquid/blob/master/filters.js>
+## Contributors ✨

-## Register Tags
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification.
+Contributions of any [kind](https://allcontributors.org/docs/en/emoji-key) are welcome!
+Thanks goes to these wonderful people:

-```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'
-    }
-});
-```
+<!-- 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="Jun Yang"/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4" width="100px;" alt="chenos"/><br /><sub><b>chenos</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=chenos" title="Code">💻</a></td>
+    <td align="center"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4" width="100px;" alt="Zach Leatherman"/><br /><sub><b>Zach Leatherman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/issues?q=author%3Azachleat" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4" width="100px;" alt="Tim Hardy"/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
+    <td align="center"><a href="https://paulrobertlloyd.com/"><img src="https://avatars3.githubusercontent.com/u/813383?v=4" width="100px;" alt="Paul Robert Lloyd"/><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="Alec Larson"/><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="Patrick Malouin"/><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="jaswrks"/><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="ssendev"/><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="wojtask9"/><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="Andrew Barclay"/><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="Cory Mawhorter"/><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="Mehdi Jaffery"/><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="Robin Bijlani"/><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="Ryan Kennedy"/><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="Sami Kukkonen"/><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="Scott Santucci"/><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="Steven "/><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="azu"/><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="Joonas"/><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="Jamel A."/><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="Brandon Pittman"/><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="tgrandgent"/><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="Martin Schuster"/><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="Ray"/><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="Cristofer Gonzales"/><br /><sub><b>Cristofer Gonzales</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=CriGoT" title="Code">💻</a></td>
+  </tr>
+</table>

-> See existing tag implementations: <https://github.com/harttle/shopify-liquid/blob/master/tags/>
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->

-## Contribution Guide
+## Contribute Guideline

-1. Write a [test][test] to define the feature you want.
-2. Just initiate an issue, or optionally:
-3. Get your test pass and make a pull request.
+* **Code Style**: <https://github.com/standard/eslint-config-standard>, `npm run lint` to check locally.
+* **Testing**: make sure test cases still pass, use `npm test` to check locally.
+* **Commit Message**: align to [The Angular Commit Message Guidelines](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits), especially the [Type identifier](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type), to allow the semantic-release bot do the work.

-[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/shopify-liquid/releases
-[any-promise]: https://github.com/kevinbeaty/any-promise
-[test]: https://github.com/harttle/shopify-liquid/tree/master/test
+[shopify/liquid]: https://shopify.github.io/liquid/
 [caniuse-promises]: http://caniuse.com/#feat=promises
+[pp]: https://github.com/taylorhakes/promise-polyfill
+[tutorial]: https://shopify.github.io/liquid/basics/introduction/
@@ -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"\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,4 @@
+#!/usr/bin/env bash
+
+./bin/build-contributors.sh
+./bin/build-apidoc.sh
@@ -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,36 @@
+#!/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 isVariable = c => '_-?'.includes(c) || isCharacter(c) || isNumber(c)
+const isBlank = c => c === '\n' || c === '\t' || c === ' ' || c === '\r'
+const isInlineBlank = c => c === '\t' || c === ' ' || c === '\r'
+const isSign = c => c === '-' || c === '+'
+
+const types = []
+for (let i = 0; i < 128; i++) {
+  const c = String.fromCharCode(i)
+  let n = 0
+  if (isVariable(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(`
+// bitmask character types to boost performance
+// generated by bin/character-gen.js
+export const TYPES = [${types.join(', ')}]
+export const VARIABLE = 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())
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# env required: HEXO_ALGOLIA_INDEXING_KEY
+
+cd docs && hexo algolia
@@ -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
+```
@@ -0,0 +1 @@
+access time: {{date|date: "%Y-%m-%d %H:%M:%S"}}
@@ -1,26 +1,26 @@
 <!DOCTYPE html>
-<html lang="en">
+<html>

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

 <body>
-  <h2 id="header"></h2>
  <script>
-    var engine = window.Liquid();
-
-    var src = 'Welcome to {{ name | capitalize}}, ' +
-      'access time: {{date|date: "%Y-%m-%d %H:%M:%S"}}';
+    var Liquid = window.liquidjs.Liquid
+    var engine = new Liquid({
+      extname: '.html',
+      cache: true
+    });
+    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) {
-        document.getElementById('header').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,22 +1,22 @@
-var express = require('express');
-var app = express();
-var Liquid = require('../..');
+const express = require('express')
+const { Liquid } = require('liquidjs')

-var engine = Liquid({
-    root: __dirname,  // for layouts and partials
-    extname: '.liquid'
-});
+const app = express()
+const engine = new Liquid({
+  root: __dirname, // for layouts and partials
+  extname: '.liquid'
+})

-app.engine('liquid', engine.express()); // register liquid engine
-app.set('views', ['./partials', './views']);            // specify the views directory
-app.set('view engine', 'liquid');       // set to default
+app.engine('liquid', engine.express()) // register liquid engine
+app.set('views', ['./partials', './views']) // specify the views directory
+app.set('view engine', 'liquid') // set to default

 app.get('/', function (req, res) {
-    var todos = ['fork and clone', 'make it better', 'make a pull request'];
-    res.render('todolist', {
-        todos: todos,
-        title: 'Welcome to shopify-liquid!'
-    });
-});
+  const todos = ['fork and clone', 'make it better', 'make a pull request']
+  res.render('todolist', {
+    todos: todos,
+    title: 'Welcome to liquidjs!'
+  })
+})

-module.exports = app;
+module.exports = app
@@ -1,6 +1,5 @@
-const app = require('./app.js');
+const app = require('./app.js')

 app.listen(3000, function () {
-    console.log('Example app listening on port 3000!');
-});
-
+  console.log('Express running: http://localhost:3000')
+})
@@ -1,15 +1,17 @@
 {
  "name": "express-demo",
  "version": "1.0.0",
-  "description": "Express Demo Using Shopify-Liquid",
+  "private": true,
+  "description": "Express Demo Using liquidjs",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "harttle",
-  "license": "ISC",
+  "license": "MIT",
  "dependencies": {
-    "express": "^4.14.0"
+    "express": "^4.14.0",
+    "liquidjs": "*"
  }
 }
@@ -1,8 +1,8 @@
 {% layout 'layout' %}

 <ul>
-  {% for todo in todolist %}
-    <li>{% include 'todo' id=forloop.index %}</li>
+  {% for todo in todos %}
+    <li>{% include 'todo', id:forloop.index %}</li>
  {% endfor %}
 </ul>

@@ -0,0 +1,9 @@
+# LiquidJS for Node.js
+
+## Get Started
+
+```bash
+cd demo/nodejs
+npm install
+npm start
+```
@@ -0,0 +1,26 @@
+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)
+  .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": "*"
+  }
+}
@@ -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 @@
+SKIP_PREFLIGHT_CHECK=true
@@ -0,0 +1,3 @@
+{
+  "extends": ["react-app"]
+}
@@ -0,0 +1,21 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# testing
+/coverage
+
+# production
+/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
@@ -0,0 +1,28 @@
+{
+  "name": "react-liquidjs",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "html-react-parser": "^0.4.7",
+    "liquidjs": "^9.1.0",
+    "react": "^16.5.2",
+    "react-dom": "^16.5.2",
+    "react-promise": "^2.0.3",
+    "react-scripts": "2.0.4"
+  },
+  "scripts": {
+    "start": "react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test",
+    "eject": "react-scripts eject"
+  },
+  "browserslist": [
+    ">0.2%",
+    "not dead",
+    "not ie <= 11",
+    "not op_mini all"
+  ],
+  "devDependencies": {
+    "@babel/core": "^7.8.7"
+  }
+}
@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <link rel="shortcut icon" href="%PUBLIC_URL%/favicon.ico">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="theme-color" content="#000000">
+    <!--
+      manifest.json provides metadata used when your web app is added to the
+      homescreen on Android. See https://developers.google.com/web/fundamentals/engage-and-retain/web-app-manifest/
+    -->
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.json">
+    <!--
+      Notice the use of %PUBLIC_URL% in the tags above.
+      It will be replaced with the URL of the `public` folder during the build.
+      Only files inside the `public` folder can be referenced from the HTML.
+
+      Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+      work correctly both with client-side routing and a non-root public URL.
+      Learn how to configure a non-root public URL by running `npm run build`.
+    -->
+    <title>React App</title>
+  </head>
+  <body>
+    <noscript>
+      You need to enable JavaScript to run this app.
+    </noscript>
+    <div id="result"></div>
+    <div id="root"></div>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm start` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+  </body>
+</html>
@@ -0,0 +1,15 @@
+{
+  "short_name": "React App",
+  "name": "Create React App Sample",
+  "icons": [
+    {
+      "src": "favicon.ico",
+      "sizes": "64x64 32x32 24x24 16x16",
+      "type": "image/x-icon"
+    }
+  ],
+  "start_url": ".",
+  "display": "standalone",
+  "theme_color": "#000000",
+  "background_color": "#ffffff"
+}
@@ -0,0 +1,32 @@
+.App {
+  text-align: center;
+}
+
+.App-logo {
+  animation: App-logo-spin infinite 20s linear;
+  height: 40vmin;
+}
+
+.App-header {
+  background-color: #282c34;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  font-size: calc(10px + 2vmin);
+  color: white;
+}
+
+.App-link {
+  color: #61dafb;
+}
+
+@keyframes App-logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}
@@ -0,0 +1,23 @@
+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';
+
+export class App extends Component {
+  async componentDidMount() {
+    const html = await engine.renderFile(tpl.toString(), {name: 'alice', logo: logo })
+    this.setState({ html })  // outputs "Alice"
+  }
+
+  state = { html: '' }
+
+  render() { 
+    return (
+      <div className="App">
+        {Parser(`${this.state.html}`)}
+      </div>
+    );
+  }
+}
@@ -0,0 +1,9 @@
+import React from 'react';
+import ReactDOM from 'react-dom';
+import App from './App';
+
+it('renders without crashing', () => {
+  const div = document.createElement('div');
+  ReactDOM.render(<App />, div);
+  ReactDOM.unmountComponentAtNode(div);
+});
@@ -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 
+})
@@ -0,0 +1,14 @@
+body {
+  margin: 0;
+  padding: 0;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Roboto", "Oxygen",
+    "Ubuntu", "Cantarell", "Fira Sans", "Droid Sans", "Helvetica Neue",
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+code {
+  font-family: source-code-pro, Menlo, Monaco, Consolas, "Courier New",
+    monospace;
+}
@@ -0,0 +1,13 @@
+import React from 'react';
+import ReactDOM from 'react-dom';
+import './index.css';
+import * as serviceWorker from './serviceWorker';
+import { App } from './App';
+// import { App } from './AppWithHooks';
+
+ReactDOM.render(<App />, document.getElementById('root'));
+
+// If you want your app to work offline and load faster, you can change
+// unregister() to register() below. Note this comes with some pitfalls.
+// Learn more about service workers: http://bit.ly/CRA-PWA
+serviceWorker.unregister();
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 841.9 595.3">
+    <g fill="#61DAFB">
+        <path d="M666.3 296.5c0-32.5-40.7-63.3-103.1-82.4 14.4-63.6 8-114.2-20.2-130.4-6.5-3.8-14.1-5.6-22.4-5.6v22.3c4.6 0 8.3.9 11.4 2.6 13.6 7.8 19.5 37.5 14.9 75.7-1.1 9.4-2.9 19.3-5.1 29.4-19.6-4.8-41-8.5-63.5-10.9-13.5-18.5-27.5-35.3-41.6-50 32.6-30.3 63.2-46.9 84-46.9V78c-27.5 0-63.5 19.6-99.9 53.6-36.4-33.8-72.4-53.2-99.9-53.2v22.3c20.7 0 51.4 16.5 84 46.6-14 14.7-28 31.4-41.3 49.9-22.6 2.4-44 6.1-63.6 11-2.3-10-4-19.7-5.2-29-4.7-38.2 1.1-67.9 14.6-75.8 3-1.8 6.9-2.6 11.5-2.6V78.5c-8.4 0-16 1.8-22.6 5.6-28.1 16.2-34.4 66.7-19.9 130.1-62.2 19.2-102.7 49.9-102.7 82.3 0 32.5 40.7 63.3 103.1 82.4-14.4 63.6-8 114.2 20.2 130.4 6.5 3.8 14.1 5.6 22.5 5.6 27.5 0 63.5-19.6 99.9-53.6 36.4 33.8 72.4 53.2 99.9 53.2 8.4 0 16-1.8 22.6-5.6 28.1-16.2 34.4-66.7 19.9-130.1 62-19.1 102.5-49.9 102.5-82.3zm-130.2-66.7c-3.7 12.9-8.3 26.2-13.5 39.5-4.1-8-8.4-16-13.1-24-4.6-8-9.5-15.8-14.4-23.4 14.2 2.1 27.9 4.7 41 7.9zm-45.8 106.5c-7.8 13.5-15.8 26.3-24.1 38.2-14.9 1.3-30 2-45.2 2-15.1 0-30.2-.7-45-1.9-8.3-11.9-16.4-24.6-24.2-38-7.6-13.1-14.5-26.4-20.8-39.8 6.2-13.4 13.2-26.8 20.7-39.9 7.8-13.5 15.8-26.3 24.1-38.2 14.9-1.3 30-2 45.2-2 15.1 0 30.2.7 45 1.9 8.3 11.9 16.4 24.6 24.2 38 7.6 13.1 14.5 26.4 20.8 39.8-6.3 13.4-13.2 26.8-20.7 39.9zm32.3-13c5.4 13.4 10 26.8 13.8 39.8-13.1 3.2-26.9 5.9-41.2 8 4.9-7.7 9.8-15.6 14.4-23.7 4.6-8 8.9-16.1 13-24.1zM421.2 430c-9.3-9.6-18.6-20.3-27.8-32 9 .4 18.2.7 27.5.7 9.4 0 18.7-.2 27.8-.7-9 11.7-18.3 22.4-27.5 32zm-74.4-58.9c-14.2-2.1-27.9-4.7-41-7.9 3.7-12.9 8.3-26.2 13.5-39.5 4.1 8 8.4 16 13.1 24 4.7 8 9.5 15.8 14.4 23.4zM420.7 163c9.3 9.6 18.6 20.3 27.8 32-9-.4-18.2-.7-27.5-.7-9.4 0-18.7.2-27.8.7 9-11.7 18.3-22.4 27.5-32zm-74 58.9c-4.9 7.7-9.8 15.6-14.4 23.7-4.6 8-8.9 16-13 24-5.4-13.4-10-26.8-13.8-39.8 13.1-3.1 26.9-5.8 41.2-7.9zm-90.5 125.2c-35.4-15.1-58.3-34.9-58.3-50.6 0-15.7 22.9-35.6 58.3-50.6 8.6-3.7 18-7 27.7-10.1 5.7 19.6 13.2 40 22.5 60.9-9.2 20.8-16.6 41.1-22.2 60.6-9.9-3.1-19.3-6.5-28-10.2zM310 490c-13.6-7.8-19.5-37.5-14.9-75.7 1.1-9.4 2.9-19.3 5.1-29.4 19.6 4.8 41 8.5 63.5 10.9 13.5 18.5 27.5 35.3 41.6 50-32.6 30.3-63.2 46.9-84 46.9-4.5-.1-8.3-1-11.3-2.7zm237.2-76.2c4.7 38.2-1.1 67.9-14.6 75.8-3 1.8-6.9 2.6-11.5 2.6-20.7 0-51.4-16.5-84-46.6 14-14.7 28-31.4 41.3-49.9 22.6-2.4 44-6.1 63.6-11 2.3 10.1 4.1 19.8 5.2 29.1zm38.5-66.7c-8.6 3.7-18 7-27.7 10.1-5.7-19.6-13.2-40-22.5-60.9 9.2-20.8 16.6-41.1 22.2-60.6 9.9 3.1 19.3 6.5 28.1 10.2 35.4 15.1 58.3 34.9 58.3 50.6-.1 15.7-23 35.6-58.4 50.6zM320.8 78.4z"/>
+        <circle cx="420.9" cy="296.5" r="45.7"/>
+        <path d="M520.5 78.1z"/>
+    </g>
+</svg>
@@ -0,0 +1,127 @@
+// In production, we register a service worker to serve assets from local cache.
+
+// This lets the app load faster on subsequent visits in production, and gives
+// it offline capabilities. However, it also means that developers (and users)
+// will only see deployed updates on the "N+1" visit to a page, since previously
+// cached resources are updated in the background.
+
+// To learn more about the benefits of this model, read https://goo.gl/KwvDNy.
+// This link also includes instructions on opting out of this behavior.
+
+const isLocalhost = Boolean(
+  window.location.hostname === 'localhost' ||
+    // [::1] is the IPv6 localhost address.
+    window.location.hostname === '[::1]' ||
+    // 127.0.0.1/8 is considered localhost for IPv4.
+    window.location.hostname.match(
+      /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/
+    )
+);
+
+export function register(config) {
+  if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) {
+    // The URL constructor is available in all browsers that support SW.
+    const publicUrl = new URL(process.env.PUBLIC_URL, window.location);
+    if (publicUrl.origin !== window.location.origin) {
+      // Our service worker won't work if PUBLIC_URL is on a different origin
+      // from what our page is served on. This might happen if a CDN is used to
+      // serve assets; see https://github.com/facebook/create-react-app/issues/2374
+      return;
+    }
+
+    window.addEventListener('load', () => {
+      const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`;
+
+      if (isLocalhost) {
+        // This is running on localhost. Let's check if a service worker still exists or not.
+        checkValidServiceWorker(swUrl, config);
+
+        // Add some additional logging to localhost, pointing developers to the
+        // service worker/PWA documentation.
+        navigator.serviceWorker.ready.then(() => {
+          console.log(
+            'This web app is being served cache-first by a service ' +
+              'worker. To learn more, visit https://goo.gl/SC7cgQ'
+          );
+        });
+      } else {
+        // Is not local host. Just register service worker
+        registerValidSW(swUrl, config);
+      }
+    });
+  }
+}
+
+function registerValidSW(swUrl, config) {
+  navigator.serviceWorker
+    .register(swUrl)
+    .then(registration => {
+      registration.onupdatefound = () => {
+        const installingWorker = registration.installing;
+        installingWorker.onstatechange = () => {
+          if (installingWorker.state === 'installed') {
+            if (navigator.serviceWorker.controller) {
+              // At this point, the old content will have been purged and
+              // the fresh content will have been added to the cache.
+              // It's the perfect time to display a "New content is
+              // available; please refresh." message in your web app.
+              console.log('New content is available; please refresh.');
+
+              // Execute callback
+              if (config.onUpdate) {
+                config.onUpdate(registration);
+              }
+            } else {
+              // At this point, everything has been precached.
+              // It's the perfect time to display a
+              // "Content is cached for offline use." message.
+              console.log('Content is cached for offline use.');
+
+              // Execute callback
+              if (config.onSuccess) {
+                config.onSuccess(registration);
+              }
+            }
+          }
+        };
+      };
+    })
+    .catch(error => {
+      console.error('Error during service worker registration:', error);
+    });
+}
+
+function checkValidServiceWorker(swUrl, config) {
+  // Check if the service worker can be found. If it can't reload the page.
+  fetch(swUrl)
+    .then(response => {
+      // Ensure service worker exists, and that we really are getting a JS file.
+      if (
+        response.status === 404 ||
+        response.headers.get('content-type').indexOf('javascript') === -1
+      ) {
+        // No service worker found. Probably a different app. Reload the page.
+        navigator.serviceWorker.ready.then(registration => {
+          registration.unregister().then(() => {
+            window.location.reload();
+          });
+        });
+      } else {
+        // Service worker found. Proceed as normal.
+        registerValidSW(swUrl, config);
+      }
+    })
+    .catch(() => {
+      console.log(
+        'No internet connection found. App is running in offline mode.'
+      );
+    });
+}
+
+export function unregister() {
+  if ('serviceWorker' in navigator) {
+    navigator.serviceWorker.ready.then(registration => {
+      registration.unregister();
+    });
+  }
+}
@@ -0,0 +1,18 @@
+<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 are using liquidjs & Reactjs 
+    </p>
+    <a
+        className="App-link"
+        href="https://reactjs.org"
+        target="_blank"
+        rel="noopener noreferrer"
+    >
+        Learn React
+    </a>
+</header>
@@ -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,5 @@
+.all-contributorsrc
+source/api/
+source/zh-cn/api/
+.vuepress
+db.json
@@ -0,0 +1 @@
+liquidjs.com
@@ -0,0 +1,34 @@
+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://harttle.land/liquidjs
+root: /
+permalink: news/:year/:month/:day/:title/
+archive_dir: news
+code_dir: downloads/code
+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,36 @@
+{
+  "name": "liquidjs-website",
+  "version": "0.0.0",
+  "private": true,
+  "hexo": {
+    "version": "4.2.0"
+  },
+  "scripts": {
+    "build": "hexo generate",
+    "start": "hexo serve",
+    "eslint": "eslint ."
+  },
+  "dependencies": {
+    "cheerio": "^0.22.0",
+    "hexo": "hexojs/hexo",
+    "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,146 @@
+/* global hexo */
+
+'use strict';
+
+const { resolve, basename } = require('path');
+const { readFileSync } = require('fs');
+const cheerio = require('cheerio');
+const lunr = require('lunr');
+const full_url_for = 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 self = 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 = self.__(prefix + text) === prefix + text ? text : self.__(prefix + text);
+    result += '<a href="' + link + '" class="' + itemClass + '">' + localized + '</a>';
+  }
+
+  function renderSection(title, menu) {
+    result += '<strong class="' + className + '-title">' + self.__(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 self = this;
+  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 = self.url_for(langPath);
+    const active = ('/' + this.page.canonical_path).slice(0, path.length) === path ? ' active' : '';
+    result += `<a href="${url}" class="${className}-link${active}">${self.__('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 full_url_for(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/hexojs/site/edit/master/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 full_url_for 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/overview.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: '2016-09-15'
+  title:
+    zh-cn: '性能提升：引入 AST 并重新设计 Token 类型系统，使渲染性能平均提升 100.3%。'
+    en: 'Performance Boost: a simple AST to improve render performance by 100.3%.'
@@ -0,0 +1,135 @@
+tutorials:
+  getting_started:
+    overview: overview.html
+    syntax: syntax.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
+    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. The format for this syntax is the same as [`strftime`](http://strftime.net). The input is first converted to Date object by [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
+```
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`module.exports = { extends: ['@commitlint/config-conventional'] }`
				`@@ -0,0 +1 @@`
				`access time: {{date\|date: "%Y-%m-%d %H:%M:%S"}}`