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
477 changed files with 27781 additions and 39305 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
+}
@@ -2,3 +2,4 @@ node_modules
 dist
 demo
 coverage
+docs
@@ -1,5 +1,5 @@
 {
-  "extends": "standard",
+  "extends": ["standard", "plugin:@typescript-eslint/recommended"],
  "env": {
    "mocha": true,
    "es6": true,
@@ -17,7 +17,24 @@
    "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']
@@ -10,7 +10,10 @@ coverage/
 # modules
 node_modules/
 dist/
+demo/*/package-lock.json
+demo/*/yarn.json

 # editors
 .*.swp
 .vscode
+
@@ -2,18 +2,27 @@ language: node_js
 node_js:
    - "10"
    - "8"
-    - "6"
 jobs:
  include:
    - stage: test
      name: 'Linting'
-      script: npm run lint
+      script:
+        - npm run lint
+        - commitlint-travis
    - name: 'Coverage'
      script: npm run coverage-coveralls
    - stage: release
+      name: 'Publish'
      if: branch = master
-      script: skip
+      script: npm run build
      deploy:
        provider: script
        skip_cleanup: true
        script: npx semantic-release
+    - name: 'Document'
+      if: branch = master
+      script: npm run build-docs
+      deploy:
+        skip_cleanup: true
+        provider: pages
+        local_dir: docs/public
@@ -1,3 +1,368 @@
+## [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)


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

-This is a liquid implementation for both Node.js and browsers. Website: <http://harttle.github.io/liquidjs/>, Live Demo: <https://jsfiddle.net/6u40xbzs/> 
+A simple, expressive, safe and [shopify][shopify/liquid] compatible template engine in pure JavaScript.
+**The purpose of this repo** is to provide a standard Liquid implementation for the JavaScript community.

-**Features**
+* [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).

-* Fully compatible to [shopify][shopify/liquid], with all [tags][tags] and [filters][filters] implemented
-* Support layout(extend) and include syntax
-* In pure JavaScript with Promise-based API
+> Version 9 has published, [see how to migrate to 9.0.0](https://github.com/harttle/liquidjs/wiki/Migrate-to-9)!

-**Differences**
+## Get Started

-Though being compatible with [Ruby Liquid](https://github.com/shopify/liquid) is one of our priorities, there're still certain differences. You may need some configuration to get it compatible in these senarios:
-
-* Dynamic file locating (enabled by default), 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 Rendering. Since JavaScript do not distinguish `float` and `integer`, we cannot either convert between them nor render regarding to their type. See [#59](https://github.com/harttle/liquidjs/issues/59).
-* [.to_liquid()](https://github.com/Shopify/liquid/wiki/Introduction-to-Drops) is replaced by `.toLiquid()`
-* [.to_s()](https://www.rubydoc.info/gems/liquid/Liquid/Drop) is replaced by JavaScript `.toString()`
-
-## TOC
-
-* Usage
-    * [Render from String](#render-from-string)
-    * [Render from File](#render-from-file)
-    * [Use with Express.js](#use-with-expressjs)
-    * [Use in Browser](#use-in-browser)
-    * [Include Partials](#include-partials)
-    * [Layout Templates (Extends)](#layout-templates-extends)
-* API Spec
-    * [Constructor Options](#options)
-    * [Register Filters](#register-filters), [Builtin Filters](https://github.com/harttle/liquidjs/wiki/Builtin-Filters)
-    * [Register Tags](#register-tags), [Builtin Tags](https://github.com/harttle/liquidjs/wiki/Builtin-Tags)
-    * [Operators](https://github.com/harttle/liquidjs/wiki/Operators)
-    * [Whitespace Control](https://github.com/harttle/liquidjs/wiki/Whitespace-Control)
-* [Contribute Guidelines](#contribute-guidelines)
-
-## Render from String
-
-Install as Node.js dependency:
+Install via npm:

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

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

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

-Caching templates:
+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].

-```javascript
-var tpl = engine.parse('{{name | capitalize}}');
-engine
-    .render(tpl, {name: 'alice'})
-    .then(console.log);
-
-// outputs 'Alice'
+```html
+<script src="//unpkg.com/liquidjs/dist/liquid.min.js"></script>     <!--for production-->
+<script src="//unpkg.com/liquidjs/dist/liquid.js"></script>         <!--for development-->
 ```

-## Render from File
+Also available from CLI:

-```javascript
-var engine = new Liquid({
-    root: path.resolve(__dirname, 'views/'),  // dirs to lookup layouts/includes
-    extname: '.liquid'          // the extname used for layouts/includes, defaults ""
-});
-engine.renderFile("hello.liquid", {name: 'alice'})
-    .then(console.log)  // outputs "Alice"
-
-// which is equivalent to: 
-engine
-    .renderFile("hello", {name: 'alice'})
-    .then(console.log)  // outputs "Alice"
+```bash
+echo '{{"hello" | capitalize}}' | npx liquidjs
 ```

-## Use with Express.js
+For detailed documents, see:

-```javascript
-// register liquid engine
-app.engine('liquid', engine.express()); 
-app.set('views', './views');            // specify the views directory
-app.set('view engine', 'liquid');       // set to default
-```
+* 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.

-[Here](demo/express/)'s an Express demo. When used with Express.js,
-Express [`views`][express-views] will be included when looking up
-partials(includes and layouts).
+## Differences and Limitations

-## Use in Browser
+* 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+.

-You can get a dist file for browsers from
+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>

-* [Releases][releases] page for liquidjs, or
-* unpkg.com: <https://unpkg.com/liquidjs/dist/liquid.min.js> 
+## Related Packages

-Here's the demo:
+* [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.

-* JSFiddle: <https://jsfiddle.net/6u40xbzs/> 
-* Demo directory: [/demo/browser/](demo/browser/).
+## Backers

-Note: For [IE and Android UC][caniuse-promises] browser, you will need a [Promise polyfill][pp].
+Love LiquidJS and want to contribute? [Become a backer](https://opencollective.com/liquidjs).

-## Include Partials
+![backers from open-collective](https://opencollective.com/liquidjs/tiers/backer.svg?avatarHeight=97)

-```
-// file: color.liquid
-color: '{{ color }}' shape: '{{ shape }}'
+## Contributors ✨

-// file: theme.liquid
-{% assign shape = 'circle' %}
-{% include 'color' %}
-{% include 'color' with 'red' %}
-{% include 'color', color: 'yellow', shape: 'square' %}
-```
+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:

-The output will be:
+<!-- 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>

-```
-color: '' shape: 'circle'
-color: 'red' shape: 'circle'
-color: 'yellow' shape: 'square'
-```
+<!-- markdownlint-enable -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->

-## Layout Templates (Extends)
+## Contribute Guideline

-```
-// file: default-layout.liquid
-Header
-{% block content %}My default content{% endblock %}
-Footer
+* **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.

-// file: page.liquid
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
-
-The output of `page.liquid`:
-
-```
-Header
-My page content
-Footer
-```
-
-* It's possible to define multiple blocks.
-* block name is optional when there's only one block.
-
-## Options
-
-The full list of options for `Liquid()` is listed as following:
-
-* `root` is a directory or an array of directories to resolve layouts and includes, as well as the filename passed in when calling `.renderFile()`.
-If an array, the files are looked up in the order they occur in the array.
-Defaults to `["."]`
-
-* `extname` is used to lookup the template file when filepath doesn't include an extension name. Eg: setting to `".html"` will allow including file by basename. Defaults to `""`.
-
-* `cache` indicates whether or not to cache resolved templates. Defaults to `false`.
-
-* `dynamicPartials`: if set, treat `<filepath>` parameter in `{%include filepath %}`, `{%layout filepath%}` as a variable, otherwise as a literal value. Defaults to `true`.
-
-* `strictFilters` 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`.
-
-* `strictVariables` 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`.
-
-* `trimTagRight` is used to strip blank characters (including ` `, `\t`, and `\r`) from the right of tags (`{% %}`) until `\n` (inclusive). Defaults to `false`.
-
-* `trimTagLeft` is similiar to `trimTagRight`, whereas the `\n` is exclusive. Defaults to `false`. See [Whitespace Control][whitespace control] for details.
-
-* `trimOutputRight` is used to strip blank characters (including ` `, `\t`, and `\r`) from the right of values (`{{ }}`) until `\n` (inclusive). Defaults to `false`.
-
-* `trimOutputLeft` is similiar to `trimOutputRight`, whereas the `\n` is exclusive. Defaults to `false`. See [Whitespace Control][whitespace control] for details.
-
-* `tagDelimiterLeft` and `tagDelimiterRight` are used to override the delimiter for liquid tags.
-
-* `outputDelimiterLeft` and `outputDelimiterRight` are used to override the delimiter for liquid outputs.
-
-* `greedy` is used to specify whether `trim*Left`/`trim*Right` is greedy. When set to `true`, all consecutive blank characters including `\n` will be trimed regardless of line breaks. Defaults to `true`.
-
-## Register Filters
-
-```javascript
-// Usage: {{ name | uppper }}
-engine.registerFilter('upper', v => v.toUpperCase())
-```
-
-Filter arguments will be passed to the registered filter function, for example:
-
-```javascript
-// Usage: {{ 1 | add: 2, 3 }}
-engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)
-```
-
-See existing filter implementations here: <https://github.com/harttle/liquidjs/tree/master/src/builtin/filters>
-
-## Register Tags
-
-```javascript
-// Usage: {% upper name%}
-engine.registerTag('upper', {
-    parse: function(tagToken, remainTokens) {
-        this.str = tagToken.args; // name
-    },
-    render: function(scope, hash) {
-        var str = Liquid.evalValue(this.str, scope); // 'alice'
-        return Promise.resolve(str.toUpperCase()); // 'Alice'
-    }
-});
-```
-
-* `parse`: Read tokens from `remainTokens` until your end token.
-* `render`: Combine scope data with your parsed tokens into HTML string.
-
-See existing tag implementations here: <https://github.com/harttle/liquidjs/tree/master/src/builtin/tags>
-
-## Plugin API
-
-A pack of tags or filters can be encapsulated into a **plugin**, which will be typically installed via npm.
-
-```javascript
-engine.plugin(require('./some-plugin'));
-
-// some-plugin.js
-module.exports = function (Liquid) {
-    // here `this` refers to the engine instance
-    // `Liquid` provides facilities to implement tags and filters
-    this.registerFilter('foo', x => x);
-}
-```
-
-Plugin List:
-
-* To add your plugin, contact me or simply send a PR.
-
-## Contribute Guidelines
-
-This repo uses [eslint](https://eslint.org/) to check code style, [semantic-release](https://github.com/semantic-release/semantic-release) to generate changelog and publish to npm and Github Releases.
-
-* Code Style: <https://github.com/standard/eslint-config-standard>, `npm run lint` to check locally.
-* Commit Message: <https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits>
-
-[nunjucks]: http://mozilla.github.io/nunjucks/
-[liquid-node]: https://github.com/sirlantis/liquid-node
 [shopify/liquid]: https://shopify.github.io/liquid/
-[jekyll]: http://jekyllrb.com/
-[gh]: https://pages.github.com/
-[releases]: https://github.com/harttle/liquidjs/releases
-[any-promise]: https://github.com/kevinbeaty/any-promise
-[test]: https://github.com/harttle/liquidjs/tree/master/test
 [caniuse-promises]: http://caniuse.com/#feat=promises
-[whitespace control]: https://github.com/harttle/liquidjs/wiki/Whitespace-Control
-[tags]: https://github.com/harttle/liquidjs/wiki/Builtin-Tags
-[filters]: https://github.com/harttle/liquidjs/wiki/Builtin-Filters
-[express-views]: http://expressjs.com/en/guide/using-template-engines.html
 [pp]: https://github.com/taylorhakes/promise-polyfill
+[tutorial]: https://shopify.github.io/liquid/basics/introduction/
@@ -1,5 +1,7 @@
 {
+  "extends": ["standard"],
  "rules": {
-    "no-unused-expressions": "off"
+    "no-unused-expressions": "off",
+    "@typescript-eslint/no-var-requires": "off"
  }
 }
@@ -1,7 +1,5 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
-import TagToken from '../src/parser/tag-token'
-import Scope from '../src/scope/scope'
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')

 const engine = new Liquid({
  root: __dirname,
@@ -9,12 +7,12 @@ const engine = new Liquid({
 })

 engine.registerTag('header', {
-  parse: function (token: TagToken) {
+  parse: function (token) {
    const [key, val] = token.args.split(':')
    this[key] = val
  },
-  render: function (scope: Scope) {
-    const title = this.liquid.evalValue(this.content, scope)
+  render: function (ctx) {
+    const title = this.liquid.evalValue(this.content, ctx)
    return `<h1>${title}</h1>`
  }
 })
@@ -34,16 +32,18 @@ const template = `
 </ul>
 `

-export default function () {
+function demo () {
  console.log('--- demo ---')
  return new Promise(resolve => {
    new Benchmark.Suite('demo')
      .add('demo', {
        defer: true,
-        fn: (d: any) => engine.parseAndRender(template, ctx).then(x => d.resolve(x))
+        fn: d => engine.parseAndRender(template, ctx).then(x => d.resolve(x))
      })
-      .on('cycle', (event: any) => console.log(String(event.target)))
+      .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()
@@ -1,11 +0,0 @@
-import output from './output'
-import tag from './tag'
-import demo from './demo'
-
-async function main () {
-  await output()
-  await tag()
-  await demo()
-}
-
-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 }
@@ -1,9 +1,9 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')

 const liquid = new Liquid()

-export default function () {
+function output () {
  console.log('--- output ---')
  return new Promise(resolve => {
    new Benchmark.Suite('output')
@@ -12,15 +12,17 @@ export default function () {
      .add('date', test('{{"now" | date: "%d%Y%m"}}'))
      .add('escape', test('{{"1<2" | escape}}'))
      .add('default', test('{{"" | default: 3}}'))
-      .on('cycle', (event: any) => console.log(String(event.target)))
+      .on('cycle', (event) => console.log(String(event.target)))
      .on('complete', resolve)
      .run({ 'async': true })
  })
 }

-function test (str: string) {
+function test (str) {
  return {
    defer: true,
-    fn: (d: any) => liquid.parseAndRender(str).then(x => d.resolve(x))
+    fn: d => liquid.parseAndRender(str).then(x => d.resolve(x))
  }
 }
+
+module.exports = { output }
@@ -1,9 +1,9 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')

 const liquid = new Liquid()

-export default function () {
+function tag () {
  console.log('--- tag ---')
  return new Promise(resolve => {
    new Benchmark.Suite('tag')
@@ -16,15 +16,17 @@ export default function () {
      .add('increment', test('{%increment a%}'))
      .add('decrement', test('{%decrement a%}'))
      .add('tablerow', test('{%tablerow i in (1..10) cols:3%}{%endtablerow%}'))
-      .on('cycle', (event: any) => console.log(String(event.target)))
+      .on('cycle', (event) => console.log(String(event.target)))
      .on('complete', resolve)
      .run({ 'async': true })
  })
 }

-function test (str: string) {
+function test (str) {
  return {
    defer: true,
-    fn: (d: any) => liquid.parseAndRender(str).then(x => d.resolve(x))
+    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
+```
@@ -1 +0,0 @@
-<h2>Welcome to {{ name | capitalize}}, {% include 'date.html' %}</h2>
@@ -8,22 +8,19 @@

 <body>
  <script>
-    var engine = new window.Liquid({
+    var Liquid = window.liquidjs.Liquid
+    var engine = new Liquid({
      extname: '.html',
      cache: true
    });
-    var src = '<h2>Welcome to {{ name | capitalize}}, ' +
-      'access time: {{date|date: "%Y-%m-%d %H:%M:%S"}}&lt;/h2>';
+    var src = "<h2>Welcome to {{ name | capitalize}}, {% include 'date.html' %}</h2>";
    var ctx = {
      name: 'Liquid',
      date: new Date()
    };
    engine.parseAndRender(src, ctx)
      .then(function(html) {
-        return engine.renderFile('hello', ctx);
-      })
-      .then(function(html) {
-        document.body.innerHTML += html
+        document.body.innerHTML = html
      });
  </script>
 </body>
@@ -1,220 +0,0 @@
-{
-  "name": "liquidjs-demo-browser",
-  "version": "1.0.0",
-  "lockfileVersion": 1,
-  "requires": true,
-  "dependencies": {
-    "async": {
-      "version": "1.5.2",
-      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
-      "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo=",
-      "dev": true
-    },
-    "colors": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/colors/-/colors-1.0.3.tgz",
-      "integrity": "sha1-BDP0TYCWgP3rYO0mDxsMJi6CpAs=",
-      "dev": true
-    },
-    "corser": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz",
-      "integrity": "sha1-jtolLsqrWEDc2XXOuQ2TcMgZ/4c=",
-      "dev": true
-    },
-    "debug": {
-      "version": "3.2.6",
-      "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.6.tgz",
-      "integrity": "sha512-mel+jf7nrtEl5Pn1Qx46zARXKDpBbvzezse7p7LqINmdoIk8PYP5SySaxEmYv6TZ0JyEKA1hsCId6DIhgITtWQ==",
-      "dev": true,
-      "requires": {
-        "ms": "2.1.1"
-      }
-    },
-    "ecstatic": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/ecstatic/-/ecstatic-3.3.1.tgz",
-      "integrity": "sha512-/rrctvxZ78HMI/tPIsqdvFKHHscxR3IJuKrZI2ZoUgkt2SiufyLFBmcco+aqQBIu6P1qBsUNG3drAAGLx80vTQ==",
-      "dev": true,
-      "requires": {
-        "he": "1.2.0",
-        "mime": "1.6.0",
-        "minimist": "1.2.0",
-        "url-join": "2.0.5"
-      }
-    },
-    "eventemitter3": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-3.1.0.tgz",
-      "integrity": "sha512-ivIvhpq/Y0uSjcHDcOIccjmYjGLcP09MFGE7ysAwkAvkXfpZlC985pH2/ui64DKazbTW/4kN3yqozUxlXzI6cA==",
-      "dev": true
-    },
-    "follow-redirects": {
-      "version": "1.7.0",
-      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.7.0.tgz",
-      "integrity": "sha512-m/pZQy4Gj287eNy94nivy5wchN3Kp+Q5WgUPNy5lJSZ3sgkVKSYV/ZChMAQVIgx1SqfZ2zBZtPA2YlXIWxxJOQ==",
-      "dev": true,
-      "requires": {
-        "debug": "3.2.6"
-      }
-    },
-    "he": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
-      "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
-      "dev": true
-    },
-    "http-proxy": {
-      "version": "1.17.0",
-      "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.17.0.tgz",
-      "integrity": "sha512-Taqn+3nNvYRfJ3bGvKfBSRwy1v6eePlm3oc/aWVxZp57DQr5Eq3xhKJi7Z4hZpS8PC3H4qI+Yly5EmFacGuA/g==",
-      "dev": true,
-      "requires": {
-        "eventemitter3": "3.1.0",
-        "follow-redirects": "1.7.0",
-        "requires-port": "1.0.0"
-      }
-    },
-    "http-server": {
-      "version": "0.11.1",
-      "resolved": "https://registry.npmjs.org/http-server/-/http-server-0.11.1.tgz",
-      "integrity": "sha512-6JeGDGoujJLmhjiRGlt8yK8Z9Kl0vnl/dQoQZlc4oeqaUoAKQg94NILLfrY3oWzSyFaQCVNTcKE5PZ3cH8VP9w==",
-      "dev": true,
-      "requires": {
-        "colors": "1.0.3",
-        "corser": "2.0.1",
-        "ecstatic": "3.3.1",
-        "http-proxy": "1.17.0",
-        "opener": "1.4.3",
-        "optimist": "0.6.1",
-        "portfinder": "1.0.20",
-        "union": "0.4.6"
-      }
-    },
-    "liquidjs": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-7.0.0.tgz",
-      "integrity": "sha512-/JL+VQUI++6iCS7JQ4fPPeji6vyvHCU/iuz2bLSiE0tn0eO3kf8GEyfaXnQUHSroy8SmJu7HQIvjvOErtYEvUg=="
-    },
-    "mime": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
-      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
-      "dev": true
-    },
-    "minimist": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
-      "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=",
-      "dev": true
-    },
-    "mkdirp": {
-      "version": "0.5.1",
-      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
-      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
-      "dev": true,
-      "requires": {
-        "minimist": "0.0.8"
-      },
-      "dependencies": {
-        "minimist": {
-          "version": "0.0.8",
-          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
-          "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=",
-          "dev": true
-        }
-      }
-    },
-    "ms": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.1.tgz",
-      "integrity": "sha512-tgp+dl5cGk28utYktBsrFqA7HKgrhgPsg6Z/EfhWI4gl1Hwq8B/GmY/0oXZ6nF8hDVesS/FpnYaD/kOWhYQvyg==",
-      "dev": true
-    },
-    "opener": {
-      "version": "1.4.3",
-      "resolved": "https://registry.npmjs.org/opener/-/opener-1.4.3.tgz",
-      "integrity": "sha1-XG2ixdflgx6P+jlklQ+NZnSskLg=",
-      "dev": true
-    },
-    "optimist": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz",
-      "integrity": "sha1-2j6nRob6IaGaERwybpDrFaAZZoY=",
-      "dev": true,
-      "requires": {
-        "minimist": "0.0.10",
-        "wordwrap": "0.0.3"
-      },
-      "dependencies": {
-        "minimist": {
-          "version": "0.0.10",
-          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.10.tgz",
-          "integrity": "sha1-3j+YVD2/lggr5IrRoMfNqDYwHc8=",
-          "dev": true
-        }
-      }
-    },
-    "portfinder": {
-      "version": "1.0.20",
-      "resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.20.tgz",
-      "integrity": "sha512-Yxe4mTyDzTd59PZJY4ojZR8F+E5e97iq2ZOHPz3HDgSvYC5siNad2tLooQ5y5QHyQhc3xVqvyk/eNA3wuoa7Sw==",
-      "dev": true,
-      "requires": {
-        "async": "1.5.2",
-        "debug": "2.6.9",
-        "mkdirp": "0.5.1"
-      },
-      "dependencies": {
-        "debug": {
-          "version": "2.6.9",
-          "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
-          "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
-          "dev": true,
-          "requires": {
-            "ms": "2.0.0"
-          }
-        },
-        "ms": {
-          "version": "2.0.0",
-          "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
-          "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=",
-          "dev": true
-        }
-      }
-    },
-    "qs": {
-      "version": "2.3.3",
-      "resolved": "https://registry.npmjs.org/qs/-/qs-2.3.3.tgz",
-      "integrity": "sha1-6eha2+ddoLvkyOBHaghikPhjtAQ=",
-      "dev": true
-    },
-    "requires-port": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz",
-      "integrity": "sha1-kl0mAdOaxIXgkc8NpcbmlNw9yv8=",
-      "dev": true
-    },
-    "union": {
-      "version": "0.4.6",
-      "resolved": "https://registry.npmjs.org/union/-/union-0.4.6.tgz",
-      "integrity": "sha1-GY+9rrolTniLDvy2MLwR8kopWeA=",
-      "dev": true,
-      "requires": {
-        "qs": "2.3.3"
-      }
-    },
-    "url-join": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/url-join/-/url-join-2.0.5.tgz",
-      "integrity": "sha1-WvIvGMBSoACkjXuCxenC4v7tpyg=",
-      "dev": true
-    },
-    "wordwrap": {
-      "version": "0.0.3",
-      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz",
-      "integrity": "sha1-o9XabNXAvAAI03I0u68b7WMFkQc=",
-      "dev": true
-    }
-  }
-}
@@ -1,6 +1,7 @@
 {
  "name": "liquidjs-demo-browser",
  "version": "1.0.0",
+  "private": true,
  "description": "Liquidjs Demo for Browser Usage",
  "main": "index.html",
  "scripts": {
@@ -8,10 +9,8 @@
  },
  "author": "harttle <[email protected]>",
  "license": "ISC",
-  "devDependencies": {
-    "http-server": "^0.11.1"
-  },
  "dependencies": {
-    "liquidjs": "^7.0.0"
+    "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,5 +1,5 @@
 const express = require('express')
-const Liquid = require('../..')
+const { Liquid } = require('liquidjs')

 const app = express()
 const engine = new Liquid({
@@ -1,6 +1,7 @@
 {
  "name": "express-demo",
  "version": "1.0.0",
+  "private": true,
  "description": "Express Demo Using liquidjs",
  "main": "index.js",
  "scripts": {
@@ -10,6 +11,7 @@
  "author": "harttle",
  "license": "MIT",
  "dependencies": {
-    "express": "^4.14.0"
+    "express": "^4.14.0",
+    "liquidjs": "*"
  }
 }
@@ -0,0 +1,9 @@
+# LiquidJS for Node.js
+
+## Get Started
+
+```bash
+cd demo/nodejs
+npm install
+npm start
+```
@@ -1,4 +1,4 @@
-const Liquid = require('liquidjs')
+const { Liquid } = require('liquidjs')

 const engine = new Liquid({
  root: __dirname,
@@ -10,9 +10,9 @@ engine.registerTag('header', {
    const [key, val] = token.args.split(':')
    this[key] = val
  },
-  render: function (scope, hash) {
-    const title = this.liquid.evalValue(this.content, scope)
-    return `<h1>${title}</h1>`
+  render: async function (scope, emitter) {
+    const title = await this.liquid.evalValue(this.content, scope)
+    emitter.write(`<h1>${title}</h1>`)
  }
 })

@@ -1,12 +0,0 @@
-{
-  "name": "Node.js demo for liquidjs",
-  "requires": true,
-  "lockfileVersion": 1,
-  "dependencies": {
-    "liquidjs": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-7.0.0.tgz",
-      "integrity": "sha512-/JL+VQUI++6iCS7JQ4fPPeji6vyvHCU/iuz2bLSiE0tn0eO3kf8GEyfaXnQUHSroy8SmJu7HQIvjvOErtYEvUg=="
-    }
-  }
-}
@@ -1,11 +1,12 @@
 {
  "name": "liquidjs-demo-nodejs",
  "description": "Node.js demo for liquidjs",
+  "private": true,
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
-    "liquidjs": "^7.0.0"
+    "liquidjs": "*"
  }
 }
@@ -0,0 +1 @@
+SKIP_PREFLIGHT_CHECK=true
@@ -0,0 +1,3 @@
+{
+  "extends": ["react-app"]
+}
@@ -3,10 +3,8 @@
  "version": "0.1.0",
  "private": true,
  "dependencies": {
-    "dns": "^0.2.2",
    "html-react-parser": "^0.4.7",
-    "liquidjs": "^6.0.1",
-    "path": "^0.12.7",
+    "liquidjs": "^9.1.0",
    "react": "^16.5.2",
    "react-dom": "^16.5.2",
    "react-promise": "^2.0.3",
@@ -18,13 +16,13 @@
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  },
-  "eslintConfig": {
-    "extends": "react-app"
-  },
  "browserslist": [
    ">0.2%",
    "not dead",
    "not ie <= 11",
    "not op_mini all"
-  ]
+  ],
+  "devDependencies": {
+    "@babel/core": "^7.8.7"
+  }
 }
@@ -1,38 +1,17 @@
 import React, { Component } from 'react';
 import logo from './logo.svg';
 import './App.css';
+import tpl from './views/demo.liquid';
+import Parser from 'html-react-parser';
+import { engine } from './engine';

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

-let config = require('./views/demo.liquid');
-let pageConfig = config.toString()
-
-let Parser = require('html-react-parser');
-
-class App extends Component {
-
-componentDidMount() {
-
-  let engine = 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 
-  })
-    
-  engine.renderFile(pageConfig, {name: 'alice', logo: logo })
-    .then((htmlTemp) => {
-      this.setState({ html: htmlTemp })
-    })  // outputs "Alice"
-}
-
-state = { 
-  html: []
-}
+  state = { html: '' }

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

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

@@ -0,0 +1,14 @@
+<header className="App-header">
+    {{ logo | image }}
+    <h2>Welcome {{name | capitalize}}</h2>
+    <p>Edit <code>src/App.js</code> and save to reload.</p>
+    <p>You have clicked {{clickCount}} times.</p>
+    <a
+        className="App-link"
+        href="https://reactjs.org"
+        target="_blank"
+        rel="noopener noreferrer"
+    >
+        Learn React
+    </a>
+</header>
@@ -0,0 +1,11 @@
+# LiquidJS for TypeScript
+
+LiquidJS is written in TypeScript and type definitions are available in `liquidjs` package.
+
+## Get Started
+
+```bash
+cd demo/typescript
+npm install
+npm start
+```
@@ -1,25 +1,25 @@
-import Liquid from '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: function (scope, hash) {
-    const title = this.liquid.evalValue(this['content'], scope)
-    return `<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)
+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)
@@ -1,14 +1,13 @@
 {
  "name": "liquidjs-demo-typescript",
+  "private": true,
  "description": "TypeScript demo for liquidjs",
  "main": "index.ts",
  "scripts": {
    "start": "ts-node index.ts"
  },
  "dependencies": {
-    "liquidjs": "^7.0.0"
-  },
-  "devDependencies": {
-    "ts-node": "^8.0.2"
+    "ts-node": "^8.0.2",
+    "liquidjs": "*"
  }
 }
@@ -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
+```
@@ -0,0 +1,16 @@
+---
+title: json
+---
+
+Convert values to string via `JSON.stringify()`, for debug purpose.
+
+Input
+```liquid
+{% assign arr = "foo bar coo" | split: " " %}
+{{ arr | json }}
+```
+
+Output
+```text
+["foo","bar","coo"]
+```
@@ -0,0 +1,35 @@
+---
+title: last
+---
+
+Returns the last item of an array.
+
+Input
+```liquid
+{{ "Ground control to Major Tom." | split: " " | last }}
+```
+
+Output
+```text
+Tom.
+```
+
+Input
+```liquid
+{% assign my_array = "zebra, octopus, giraffe, tiger" | split: ", " %}
+{{ my_array.last }}
+```
+
+Output
+```text
+
+tiger
+```
+
+You can use `last` with dot notation when you need to use the filter inside a tag:
+
+```liquid
+{% if my_array.last == "tiger" %}
+  There goes a tiger!
+{% endif %}
+```
@@ -0,0 +1,15 @@
+---
+title: lstrip
+---
+
+Removes all whitespace (tabs, spaces, and newlines) from the left side of a string. It does not affect spaces between words.
+
+Input
+```liquid
+BEGIN{{ "          So much room for activities!          " | lstrip }}END
+```
+
+Output
+```text
+BEGINSo much room for activities!          END
+```
@@ -0,0 +1,25 @@
+---
+title: map
+---
+
+Creates an array of values by extracting the values of a named property from another object.
+
+In this example, assume the object `site.pages` contains all the metadata for a website. Using `assign` with the `map` filter creates a variable that contains only the values of the `category` properties of everything in the `site.pages` object.
+
+Input
+```liquid
+{% assign all_categories = site.pages | map: "category" %}
+
+{% for item in all_categories %}
+- {{ item }}
+{% endfor %}
+```
+
+Output
+```text
+- business
+- celebrities
+- lifestyle
+- sports
+- technology
+```
@@ -0,0 +1,35 @@
+---
+title: minus
+---
+
+Subtracts a number from another number.
+
+Input
+```liquid
+{{ 4 | minus: 2 }}
+```
+
+Output
+```text
+2
+```
+
+Input
+```liquid
+{{ 16 | minus: 4 }}
+```
+
+Output
+```text
+12
+```
+
+Input
+```liquid
+{{ 183.357 | minus: 12 }}
+```
+
+Output
+```text
+171.357
+```
@@ -0,0 +1,35 @@
+---
+title: modulo
+---
+
+Returns the remainder of a division operation.
+
+Input
+```liquid
+{{ 3 | modulo: 2 }}
+```
+
+Output
+```text
+1
+```
+
+Input
+```liquid
+{{ 24 | modulo: 7 }}
+```
+
+Output
+```text
+3
+```
+
+Input
+```liquid
+{{ 183.357 | modulo: 12 }}
+```
+
+Output
+```text
+3.3569999999999993
+```
@@ -0,0 +1,21 @@
+---
+title: newline_to_br
+---
+
+Replaces every newline (`\n`) in a string with an HTML line break (`<br />`).
+
+Input
+```liquid
+{% capture string_with_newlines %}
+Hello
+there
+{% endcapture %}
+
+{{ string_with_newlines | newline_to_br }}
+```
+
+Output
+```html
+
+<br/>Hello<br/>there<br/>
+```
@@ -0,0 +1,17 @@
+---
+title: Filters
+---
+
+LiquidJS implements business-logic independent filters that are typically implemented in [shopify/liquid][shopify/liquid]. This section contains the specification and demoes for all the filters implemented by LiquidJS.
+
+There's 40+ filters supported by LiquidJS. These filters can be categorized into these groups:
+
+Categories | Filters
+--- | ---
+Math | plus, minus, modulo, times, floor, ceil, round, divided_by, abs
+String | append, prepend, capitalize, upcase, downcase, strip, lstrip, rstrip, strip_newlines, split, replace, replace_first, remove, remove_first, truncate, truncatewords
+HTML/URI | escape, escape_once, url_encode, url_decode, strip_html, newline_to_br
+Array | slice, map, sort, sort_natural, uniq, wheres, first, last, join, reverse
+Date | date
+
+[shopify/liquid]: https://github.com/Shopify/liquid
@@ -0,0 +1,35 @@
+---
+title: plus
+---
+
+Adds a number to another number.
+
+Input
+```liquid
+{{ 4 | plus: 2 }}
+```
+
+Output
+```text
+6
+```
+
+Input
+```liquid
+{{ 16 | plus: 4 }}
+```
+
+Output
+```text
+20
+```
+
+Input
+```liquid
+{{ 183.357 | plus: 12 }}
+```
+
+Output
+```text
+195.357
+```
@@ -0,0 +1,29 @@
+---
+title: prepend
+---
+
+Adds the specified string to the beginning of another string.
+
+Input
+```liquid
+{{ "apples, oranges, and bananas" | prepend: "Some fruit: " }}
+```
+
+Output
+```text
+Some fruit: apples, oranges, and bananas
+```
+
+`prepend` can also be used with variables:
+
+Input
+```liquid
+{% assign url = "example.com" %}
+{{ "/index.html" | prepend: url }}
+```
+
+Output
+```text
+
+example.com/index.html
+```
@@ -0,0 +1,15 @@
+---
+title: remove
+---
+
+Removes every occurrence of the specified substring from a string.
+
+Input
+```liquid
+{{ "I strained to see the train through the rain" | remove: "rain" }}
+```
+
+Output
+```text
+I strained to see the t through the 
+```
@@ -0,0 +1,15 @@
+---
+title: remove_first
+---
+
+Removes only the first occurrence of the specified substring from a string.
+
+Input
+```liquid
+{{ "I strained to see the train through the rain" | remove_first: "rain" }}
+```
+
+Output
+```text
+I strained to see the t through the rain
+```
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`module.exports = { extends: ['@commitlint/config-conventional'] }`
				`@@ -1 +0,0 @@`
				`<h2>Welcome to {{ name \| capitalize}}, {% include 'date.html' %}</h2>`