chore(release): 10.3.3 [skip ci]

## [10.3.3](https://github.com/harttle/liquidjs/compare/v10.3.2...v10.3.3) (2022-12-18) ### Bug Fixes * type compatible with v9 tag definition, support `Context` as scope in various render APIs, [#570](https://github.com/harttle/liquidjs/issues/570) ([fb6a9f8](https://github.com/harttle/liquidjs/commit/fb6a9f8717cd57522d53687da7e4718b28a7f68a))
fix: type compatible with v9 tag definition, support Context as scope in various render APIs, #570
2026-09-12 19:00:39 -07:00 · 2022-12-18 04:58:05 +00:00 · 2022-12-18 12:48:06 +08:00 · 2022-12-13 18:16:48 +00:00 · 2022-12-14 02:14:03 +08:00 · 2022-12-14 02:14:03 +08:00
640 changed files with 46013 additions and 43209 deletions
@@ -0,0 +1,520 @@
+{
+  "projectName": "liquidjs",
+  "projectOwner": "harttle",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 100,
+  "commit": false,
+  "commitConvention": "angular",
+  "contributors": [
+    {
+      "login": "harttle",
+      "name": "Jun Yang",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4427974?v=4",
+      "profile": "https://harttle.land",
+      "contributions": [
+        "maintenance",
+        "code"
+      ]
+    },
+    {
+      "login": "chenos",
+      "name": "chenos",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2993310?v=4",
+      "profile": "https://github.com/chenos",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "zachleat",
+      "name": "Zach Leatherman",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/39355?v=4",
+      "profile": "https://zachleat.com/",
+      "contributions": [
+        "bug"
+      ]
+    },
+    {
+      "login": "thardy",
+      "name": "Tim Hardy",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/120636?v=4",
+      "profile": "https://github.com/thardy",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "paulrobertlloyd",
+      "name": "Paul Robert Lloyd",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/813383?v=4",
+      "profile": "https://paulrobertlloyd.com/",
+      "contributions": [
+        "code",
+        "bug"
+      ]
+    },
+    {
+      "login": "aleclarson",
+      "name": "Alec Larson",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/1925840?v=4",
+      "profile": "https://twitter.com/alecdotbiz",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pmalouin",
+      "name": "Patrick Malouin",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1411117?v=4",
+      "profile": "https://github.com/pmalouin",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "jaswrks",
+      "name": "jaswrks",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1563559?v=4",
+      "profile": "https://jaswrks.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "oott123",
+      "name": "三三",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/905663?v=4",
+      "profile": "https://oott123.com",
+      "contributions": [
+        "code",
+        "ideas"
+      ]
+    },
+    {
+      "login": "ssendev",
+      "name": "ssendev",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/450793?v=4",
+      "profile": "https://github.com/ssendev",
+      "contributions": [
+        "code",
+        "doc"
+      ]
+    },
+    {
+      "login": "wojtask9",
+      "name": "wojtask9",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/6099236?v=4",
+      "profile": "https://github.com/wojtask9",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "thelornenelson",
+      "name": "Andrew Barclay",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/24596583?v=4",
+      "profile": "https://github.com/thelornenelson",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "cmawhorter",
+      "name": "Cory Mawhorter",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/142338?v=4",
+      "profile": "https://www.stam.pr/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "thehappybug",
+      "name": "Mehdi Jaffery",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3393530?v=4",
+      "profile": "https://github.com/thehappybug",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "robinbijlani",
+      "name": "Robin Bijlani",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2503108?v=4",
+      "profile": "https://github.com/robinbijlani",
+      "contributions": [
+        "code",
+        "bug"
+      ]
+    },
+    {
+      "login": "ryaninvents",
+      "name": "Ryan Kennedy",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8356669?v=4",
+      "profile": "https://www.rmkennedy.com",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "strax",
+      "name": "Sami Kukkonen",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/587213?v=4",
+      "profile": "https://github.com/strax",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ScottFreeCode",
+      "name": "Scott Santucci",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/16506071?v=4",
+      "profile": "https://ScottFreeCode.github.io/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "stevenanthonyrevo",
+      "name": "Steven ",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/8505293?v=4",
+      "profile": "http://stevenrescigno.com",
+      "contributions": [
+        "example",
+        "code"
+      ]
+    },
+    {
+      "login": "azu",
+      "name": "azu",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/19714?v=4",
+      "profile": "https://efcl.info/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "wyozi",
+      "name": "Joonas",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/4894573?v=4",
+      "profile": "https://github.com/wyozi",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jamelait",
+      "name": "Jamel A.",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/14369255?v=4",
+      "profile": "https://github.com/jamelait",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "brandonpittman",
+      "name": "Brandon Pittman",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/967145?v=4",
+      "profile": "https://brandonpittman.net",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tgrandgent",
+      "name": "tgrandgent",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/17069042?v=4",
+      "profile": "https://github.com/tgrandgent",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "mastodon0",
+      "name": "Martin Schuster",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7924332?v=4",
+      "profile": "https://github.com/mastodon0",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "richardo2016",
+      "name": "Ray",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/6339390?v=4",
+      "profile": "http://js.chenlei.me",
+      "contributions": [
+        "test",
+        "code"
+      ]
+    },
+    {
+      "login": "CriGoT",
+      "name": "Cristofer Gonzales",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/1936786?v=4",
+      "profile": "https://github.com/CriGoT",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "cfjedimaster",
+      "name": "Raymond Camden",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/393660?v=4",
+      "profile": "https://www.raymondcamden.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "stedman",
+      "name": "Steve Stedman",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/183122?v=4",
+      "profile": "https://stedman.dev",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "aciccarello",
+      "name": "Anthony Ciccarello",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/11273838?v=4",
+      "profile": "https://ciccarello.me",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "TrySound",
+      "name": "Bogdan Chadkin",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5635476?v=4",
+      "profile": "https://twitter.com/IAmTrySound",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tejasmanohar",
+      "name": "Tejas Manohar",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/5959235?v=4",
+      "profile": "https://hightouch.io",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "pdehaan",
+      "name": "Peter deHaan",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/557895?v=4",
+      "profile": "http://about.me/peterdehaan",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "amit777",
+      "name": "amit777",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/2703309?v=4",
+      "profile": "https://github.com/amit777",
+      "contributions": [
+        "code",
+        "financial"
+      ]
+    },
+    {
+      "login": "sschuldenzucker",
+      "name": "Steffen Schuldenzucker",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/1100776?v=4",
+      "profile": "http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "Pixcell",
+      "name": "Pixcell",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4005291?v=4",
+      "profile": "https://github.com/Pixcell",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "JasonEtco",
+      "name": "Jason Etcovitch",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10660468?v=4",
+      "profile": "https://jasonet.co",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "kayuapi",
+      "name": "ZC",
+      "avatar_url": "https://avatars.githubusercontent.com/u/10304328?v=4",
+      "profile": "https://github.com/kayuapi",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "mems",
+      "name": "Memmie Lenglet",
+      "avatar_url": "https://avatars.githubusercontent.com/u/729275?v=4",
+      "profile": "https://memmie.lenglet.name",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ilhamdev0",
+      "name": "ilhamdev0",
+      "avatar_url": "https://avatars.githubusercontent.com/u/57636145?v=4",
+      "profile": "https://github.com/ilhamdev0",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "c412216887",
+      "name": "一饮一啄皆是人生",
+      "avatar_url": "https://avatars.githubusercontent.com/u/29691650?v=4",
+      "profile": "https://github.com/c412216887",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "labnol",
+      "name": "Amit Agarwal",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1344071?v=4",
+      "profile": "https://digitalinspiration.com/",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "n1ru4l",
+      "name": "Laurin Quast",
+      "avatar_url": "https://avatars.githubusercontent.com/u/14338007?v=4",
+      "profile": "https://n1ru4l.cloud/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "mattvague",
+      "name": "Matt Vague",
+      "avatar_url": "https://avatars.githubusercontent.com/u/64985?v=4",
+      "profile": "https://github.com/mattvague",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "bglw",
+      "name": "Liam Bigelow",
+      "avatar_url": "https://avatars.githubusercontent.com/u/40188355?v=4",
+      "profile": "https://github.com/bglw",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "JaKXz",
+      "name": "Jason Kurian",
+      "avatar_url": "https://avatars.githubusercontent.com/u/2642545?v=4",
+      "profile": "https://about.me/jasonkurian",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "dphm",
+      "name": "d pham (they/them)",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1707217?v=4",
+      "profile": "https://github.com/dphm",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "AleksandrHovhannisyan",
+      "name": "Aleksandr Hovhannisyan",
+      "avatar_url": "https://avatars.githubusercontent.com/u/19352442?v=4",
+      "profile": "https://www.aleksandrhovhannisyan.com/",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "jg-rp",
+      "name": "jg-rp",
+      "avatar_url": "https://avatars.githubusercontent.com/u/72664870?v=4",
+      "profile": "https://github.com/jg-rp",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "ameyaapte1",
+      "name": "Ameya Apte",
+      "avatar_url": "https://avatars.githubusercontent.com/u/16054747?v=4",
+      "profile": "https://github.com/ameyaapte1",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "tbdrz",
+      "name": "tbdrz",
+      "avatar_url": "https://avatars.githubusercontent.com/u/50599116?v=4",
+      "profile": "https://github.com/tbdrz",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "santialbo",
+      "name": "Santi Albo",
+      "avatar_url": "https://avatars.githubusercontent.com/u/1557563?v=4",
+      "profile": "http://santialbo.com",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "YahangWu",
+      "name": "Yahang Wu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/12295975?v=4",
+      "profile": "https://github.com/YahangWu",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "hongl-1",
+      "name": "hongl",
+      "avatar_url": "https://avatars.githubusercontent.com/u/101576612?v=4",
+      "profile": "https://github.com/hongl-1",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "zxx-457",
+      "name": "zxx-457",
+      "avatar_url": "https://avatars.githubusercontent.com/u/114141362?v=4",
+      "profile": "https://github.com/zxx-457",
+      "contributions": [
+        "doc"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true
+}
@@ -2,3 +2,5 @@ node_modules
 dist
 demo
 coverage
+docs
+private.*
@@ -1,5 +1,5 @@
 {
-  "extends": "standard",
+  "extends": ["standard", "plugin:@typescript-eslint/recommended"],
  "env": {
    "mocha": true,
    "es6": true,
@@ -7,17 +7,49 @@
    "node": true
  },
  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "project": "tsconfig.json"
+  },
  "plugins": [
+    "deprecation",
    "mocha",
    "standard",
    "@typescript-eslint",
    "promise"
  ],
  "rules": {
+    "deprecation/deprecation": "error",
    "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": ["**/filters/*.ts"],
+    "rules": {
+      "camelcase": "off"
+    }
+  }, {
+    "files": ["**/*.js", "**/*.mjs"],
+    "rules": {
+      "@typescript-eslint/no-var-requires": "off"
+    }
+  }, {
+    "files": ["test/**/*.ts"],
+    "rules": {
+      "deprecation/deprecation": "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']
@@ -0,0 +1,30 @@
+name: Check
+on: [push, pull_request]
+jobs:
+  release:
+    name: Check
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+      - name: Build
+        run: |
+          npm ci
+          npm run build
+      - name: Test
+        run: |
+          npm run lint
+          npm run test
+      - name: Coverage
+        uses: coverallsapp/[email protected]
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Performance
+        run: |
+          npm run perf:diff
@@ -0,0 +1,27 @@
+name: Docs
+on:
+  push:
+    branches:
+      - master
+jobs:
+  docs:
+    name: Docs
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+      - name: Build
+        run: |
+          npm ci
+          npm run build:docs
+      - name: Publish
+        uses: JamesIves/[email protected]
+        with: 
+          branch: gh-pages
+          folder: docs/public
@@ -0,0 +1,32 @@
+name: Release
+on: workflow_dispatch
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-18.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: '14'
+      - name: Build
+        run: |
+          npm ci
+          npm run build:dist
+      - name: Test
+        run: |
+          npm run lint
+          npm run test
+      - name: Coverage
+        uses: coverallsapp/[email protected]
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release
@@ -10,7 +10,10 @@ coverage/
 # modules
 node_modules/
 dist/
+demo/*/package-lock.json
+demo/*/yarn.json

 # editors
 .*.swp
 .vscode
+
@@ -0,0 +1,4 @@
+module.exports = {
+  require: "ts-node/register/transpile-only",
+  reporter: "spec"
+}
@@ -0,0 +1,4 @@
+{
+  "exclude": ["dist", "test"],
+  "reporter": ["html", "lcov"]
+}
@@ -1,19 +0,0 @@
-language: node_js
-node_js:
-    - "10"
-    - "8"
-    - "6"
-jobs:
-  include:
-    - stage: test
-      name: 'Linting'
-      script: npm run lint
-    - name: 'Coverage'
-      script: npm run coverage-coveralls
-    - stage: release
-      if: branch = master
-      script: skip
-      deploy:
-        provider: script
-        skip_cleanup: true
-        script: npx semantic-release
@@ -1,280 +1,163 @@
 # liquidjs
+[![npm version](https://img.shields.io/npm/v/liquidjs.svg?logo=npm&style=flat-square)](https://www.npmjs.org/package/liquidjs)
+[![npm downloads](https://img.shields.io/npm/dm/liquidjs.svg?style=flat-square)](https://www.npmjs.org/package/liquidjs)
+[![Coverage](https://img.shields.io/coveralls/harttle/liquidjs.svg?style=flat-square)](https://coveralls.io/github/harttle/liquidjs?branch=master)
+[![Build Status](https://img.shields.io/github/workflow/status/harttle/liquidjs/Check/master.svg?style=flat-square)](https://github.com/harttle/liquidjs/actions/workflows/check.yml?query=branch%3Amaster)
+[![DUB license](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](https://github.com/harttle/liquidjs/blob/master/LICENSE)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=flat-square)](https://github.com/harttle/liquidjs)

-[![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)
-[![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)
-[![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)
+A simple, expressive and safe [Shopify][shopify/liquid] / Github Pages compatible template engine in pure JavaScript.
+**The purpose of this repo** is to provide a standard Liquid implementation for the JavaScript community so that [Jekyll sites](https://jekyllrb.com), [Github Pages](https://pages.github.com/) and [Shopify templates](https://themes.shopify.com/) can be ported to Node.js without pain.

-This is a liquid implementation for both Node.js and browsers. Website: <http://harttle.github.io/liquidjs/>, Live Demo: <https://jsfiddle.net/6u40xbzs/> 
+* [Documentation][doc]
+* Please star [LiquidJS on GitHub][github]!
+* Support [LiquidJS on Open Collective][oc] or [Patreon][patreon]

-**Features**
+<p align="center"><a href="https://liquidjs.com"><img height="155px" width="155px" src="https://liquidjs.com/icon/mstile-310x310.png" alt="logo"></a></p>

-* 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
+## What's it like?

-**Differences**
+Basically there're two types of Liquid syntax: tags enclosed by `{% %}` and outputs enclosed by `{{ }}`. A Liquid template looks like:

-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:
+```liquid
+{% if username %}
+  {{ username | append: ", welcome to LiquidJS!" | capitalize }}
+{% endif %}
+```

-* 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()`
+[A live demo](https://liquidjs.com/playground.html) is also available and here's a [quick tutorial](https://liquidjs.com/tutorials/intro-to-liquid.html) for Liquid syntax.

-## 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)
+## Installation

-## Render from String
-
-Install as Node.js dependency:
+Install from npm in Node.js:

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

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

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

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

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

-// outputs 'Alice'
-```
+* [@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.
+* [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

-## Render from File
+## Financial Support

-```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"
+If you love LiquidJS or your company is using LiquidJS? Please consider [support us on Open Collective or Patreon][financial-support].

-// which is equivalent to: 
-engine
-    .renderFile("hello", {name: 'alice'})
-    .then(console.log)  // outputs "Alice"
-```
+### Backers
+If you personally like LiquidJS and find it useful to you, you can buy me a coffee!

-## Use with Express.js
+<img src="https://opencollective.com/liquidjs/backers.svg?avatarHeight=72">

-```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
-```
+### Sponsors
+If LiquidJS is benefiting your business/company, please sponsor us to contribute to our effort!

-[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).
+<img src="https://opencollective.com/liquidjs/sponsors.svg?avatarHeight=72">
+## Contributors ✨

-## Use in Browser
+Want to contribute? see [Contribution Guidelines][contribution]. Thanks goes to these wonderful people:

-You can get a dist file for browsers from
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center"><a href="https://harttle.land"><img src="https://avatars3.githubusercontent.com/u/4427974?v=4?s=100" width="100px;" alt="Jun Yang"/><br /><sub><b>Jun Yang</b></sub></a><br /><a href="#maintenance-harttle" title="Maintenance">🚧</a> <a href="https://github.com/harttle/liquidjs/commits?author=harttle" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/chenos"><img src="https://avatars0.githubusercontent.com/u/2993310?v=4?s=100" width="100px;" alt="chenos"/><br /><sub><b>chenos</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=chenos" title="Code">💻</a></td>
+      <td align="center"><a href="https://zachleat.com/"><img src="https://avatars2.githubusercontent.com/u/39355?v=4?s=100" width="100px;" alt="Zach Leatherman"/><br /><sub><b>Zach Leatherman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/issues?q=author%3Azachleat" title="Bug reports">🐛</a></td>
+      <td align="center"><a href="https://github.com/thardy"><img src="https://avatars3.githubusercontent.com/u/120636?v=4?s=100" width="100px;" alt="Tim Hardy"/><br /><sub><b>Tim Hardy</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=thardy" title="Code">💻</a></td>
+      <td align="center"><a href="https://paulrobertlloyd.com/"><img src="https://avatars3.githubusercontent.com/u/813383?v=4?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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?s=100" 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>
+      <td align="center"><a href="https://www.raymondcamden.com"><img src="https://avatars3.githubusercontent.com/u/393660?v=4?s=100" width="100px;" alt="Raymond Camden"/><br /><sub><b>Raymond Camden</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=cfjedimaster" title="Documentation">📖</a></td>
+    </tr>
+    <tr>
+      <td align="center"><a href="https://stedman.dev"><img src="https://avatars1.githubusercontent.com/u/183122?v=4?s=100" width="100px;" alt="Steve Stedman"/><br /><sub><b>Steve Stedman</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=stedman" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://ciccarello.me"><img src="https://avatars0.githubusercontent.com/u/11273838?v=4?s=100" width="100px;" alt="Anthony Ciccarello"/><br /><sub><b>Anthony Ciccarello</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=aciccarello" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://twitter.com/IAmTrySound"><img src="https://avatars0.githubusercontent.com/u/5635476?v=4?s=100" width="100px;" alt="Bogdan Chadkin"/><br /><sub><b>Bogdan Chadkin</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=TrySound" title="Code">💻</a></td>
+      <td align="center"><a href="https://hightouch.io"><img src="https://avatars0.githubusercontent.com/u/5959235?v=4?s=100" width="100px;" alt="Tejas Manohar"/><br /><sub><b>Tejas Manohar</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tejasmanohar" title="Code">💻</a></td>
+      <td align="center"><a href="http://about.me/peterdehaan"><img src="https://avatars2.githubusercontent.com/u/557895?v=4?s=100" width="100px;" alt="Peter deHaan"/><br /><sub><b>Peter deHaan</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=pdehaan" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/amit777"><img src="https://avatars0.githubusercontent.com/u/2703309?v=4?s=100" width="100px;" alt="amit777"/><br /><sub><b>amit777</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=amit777" title="Code">💻</a> <a href="#financial-amit777" title="Financial">💵</a></td>
+      <td align="center"><a href="http://www.ifi.uzh.ch/en/ce/people/schuldenzucker.html"><img src="https://avatars3.githubusercontent.com/u/1100776?v=4?s=100" width="100px;" alt="Steffen Schuldenzucker"/><br /><sub><b>Steffen Schuldenzucker</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=sschuldenzucker" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center"><a href="https://github.com/Pixcell"><img src="https://avatars0.githubusercontent.com/u/4005291?v=4?s=100" width="100px;" alt="Pixcell"/><br /><sub><b>Pixcell</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=Pixcell" title="Code">💻</a></td>
+      <td align="center"><a href="https://jasonet.co"><img src="https://avatars.githubusercontent.com/u/10660468?v=4?s=100" width="100px;" alt="Jason Etcovitch"/><br /><sub><b>Jason Etcovitch</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=JasonEtco" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/kayuapi"><img src="https://avatars.githubusercontent.com/u/10304328?v=4?s=100" width="100px;" alt="ZC"/><br /><sub><b>ZC</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=kayuapi" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://memmie.lenglet.name"><img src="https://avatars.githubusercontent.com/u/729275?v=4?s=100" width="100px;" alt="Memmie Lenglet"/><br /><sub><b>Memmie Lenglet</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mems" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/ilhamdev0"><img src="https://avatars.githubusercontent.com/u/57636145?v=4?s=100" width="100px;" alt="ilhamdev0"/><br /><sub><b>ilhamdev0</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ilhamdev0" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/c412216887"><img src="https://avatars.githubusercontent.com/u/29691650?v=4?s=100" width="100px;" alt="一饮一啄皆是人生"/><br /><sub><b>一饮一啄皆是人生</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=c412216887" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://digitalinspiration.com/"><img src="https://avatars.githubusercontent.com/u/1344071?v=4?s=100" width="100px;" alt="Amit Agarwal"/><br /><sub><b>Amit Agarwal</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=labnol" title="Documentation">📖</a></td>
+    </tr>
+    <tr>
+      <td align="center"><a href="https://n1ru4l.cloud/"><img src="https://avatars.githubusercontent.com/u/14338007?v=4?s=100" width="100px;" alt="Laurin Quast"/><br /><sub><b>Laurin Quast</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=n1ru4l" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/mattvague"><img src="https://avatars.githubusercontent.com/u/64985?v=4?s=100" width="100px;" alt="Matt Vague"/><br /><sub><b>Matt Vague</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=mattvague" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/bglw"><img src="https://avatars.githubusercontent.com/u/40188355?v=4?s=100" width="100px;" alt="Liam Bigelow"/><br /><sub><b>Liam Bigelow</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=bglw" title="Code">💻</a></td>
+      <td align="center"><a href="https://about.me/jasonkurian"><img src="https://avatars.githubusercontent.com/u/2642545?v=4?s=100" width="100px;" alt="Jason Kurian"/><br /><sub><b>Jason Kurian</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=JaKXz" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/dphm"><img src="https://avatars.githubusercontent.com/u/1707217?v=4?s=100" width="100px;" alt="d pham (they/them)"/><br /><sub><b>d pham (they/them)</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=dphm" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://www.aleksandrhovhannisyan.com/"><img src="https://avatars.githubusercontent.com/u/19352442?v=4?s=100" width="100px;" alt="Aleksandr Hovhannisyan"/><br /><sub><b>Aleksandr Hovhannisyan</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=AleksandrHovhannisyan" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/jg-rp"><img src="https://avatars.githubusercontent.com/u/72664870?v=4?s=100" width="100px;" alt="jg-rp"/><br /><sub><b>jg-rp</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=jg-rp" title="Code">💻</a></td>
+    </tr>
+    <tr>
+      <td align="center"><a href="https://github.com/ameyaapte1"><img src="https://avatars.githubusercontent.com/u/16054747?v=4?s=100" width="100px;" alt="Ameya Apte"/><br /><sub><b>Ameya Apte</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=ameyaapte1" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/tbdrz"><img src="https://avatars.githubusercontent.com/u/50599116?v=4?s=100" width="100px;" alt="tbdrz"/><br /><sub><b>tbdrz</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=tbdrz" title="Documentation">📖</a></td>
+      <td align="center"><a href="http://santialbo.com"><img src="https://avatars.githubusercontent.com/u/1557563?v=4?s=100" width="100px;" alt="Santi Albo"/><br /><sub><b>Santi Albo</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=santialbo" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/YahangWu"><img src="https://avatars.githubusercontent.com/u/12295975?v=4?s=100" width="100px;" alt="Yahang Wu"/><br /><sub><b>Yahang Wu</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=YahangWu" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/hongl-1"><img src="https://avatars.githubusercontent.com/u/101576612?v=4?s=100" width="100px;" alt="hongl"/><br /><sub><b>hongl</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=hongl-1" title="Documentation">📖</a></td>
+      <td align="center"><a href="https://github.com/zxx-457"><img src="https://avatars.githubusercontent.com/u/114141362?v=4?s=100" width="100px;" alt="zxx-457"/><br /><sub><b>zxx-457</b></sub></a><br /><a href="https://github.com/harttle/liquidjs/commits?author=zxx-457" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>

-* [Releases][releases] page for liquidjs, or
-* unpkg.com: <https://unpkg.com/liquidjs/dist/liquid.min.js> 
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->

-Here's the demo:
+<!-- ALL-CONTRIBUTORS-LIST:END -->

-* JSFiddle: <https://jsfiddle.net/6u40xbzs/> 
-* Demo directory: [/demo/browser/](demo/browser/).
-
-Note: For [IE and Android UC][caniuse-promises] browser, you will need a [Promise polyfill][pp].
-
-## Include Partials
-
-```
-// file: color.liquid
-color: '{{ color }}' shape: '{{ shape }}'
-
-// file: theme.liquid
-{% assign shape = 'circle' %}
-{% include 'color' %}
-{% include 'color' with 'red' %}
-{% include 'color', color: 'yellow', shape: 'square' %}
-```
-
-The output will be:
-
-```
-color: '' shape: 'circle'
-color: 'red' shape: 'circle'
-color: 'yellow' shape: 'square'
-```
-
-## Layout Templates (Extends)
-
-```
-// file: default-layout.liquid
-Header
-{% block content %}My default content{% endblock %}
-Footer
-
-// file: page.liquid
-{% layout "default-layout" %}
-{% block content %}My page content{% endblock %}
-```
-
-The output of `page.liquid`:
-
-```
-Header
-My page content
-Footer
-```
-
-* It's possible to define multiple blocks.
-* block name is optional when there's only one block.
-
-## Options
-
-The full list of options for `Liquid()` is listed as following:
-
-* `root` is a directory or an array of directories to resolve layouts and includes, as well as the filename passed in when calling `.renderFile()`.
-If an array, the files are looked up in the order they occur in the array.
-Defaults to `["."]`
-
-* `extname` is used to lookup the template file when filepath doesn't include an extension name. Eg: setting to `".html"` will allow including file by basename. Defaults to `""`.
-
-* `cache` indicates whether or not to cache resolved templates. Defaults to `false`.
-
-* `dynamicPartials`: if set, treat `<filepath>` parameter in `{%include filepath %}`, `{%layout filepath%}` as a variable, otherwise as a literal value. Defaults to `true`.
-
-* `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
+[plugins]: https://liquidjs.com/tutorials/plugins.html#Plugin-List
+[setup]: https://liquidjs.com/tutorials/setup.html
+[doc]: https://liquidjs.com
+[github]: https://github.com/harttle/liquidjs
+[patreon]: https://www.patreon.com/harttle
+[oc]: https://opencollective.com/liquidjs/
+[contribution]: https://liquidjs.com/tutorials/contribution-guidelines.html
+[financial-support]: https://liquidjs.com/tutorials/contribution-guidelines.html#Financial-Support
@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported Versions
+
+Only the latest major version is supported with security updates. It can be changed if many people are relying on a specific version for some reason. If this is the case, welcome to file an issue.
+
+## Reporting a Vulnerability
+
+Please contact yangjvn@126.com to report a vulnerability or change request.
+
+- If the vulnerability in question affects common use cases, it will be treated as a bug and fixed very soon (typically within 1 week).
+- Otherwise, it'll be scheduled in the same priority of feature request (which is lower than bugs).
+- If the request is declined, you'll receive a reply email anyway (most likely there will be a discussion).
@@ -1,5 +1,7 @@
 {
+  "extends": ["standard"],
  "rules": {
-    "no-unused-expressions": "off"
+    "no-unused-expressions": "off",
+    "@typescript-eslint/no-var-requires": "off"
  }
 }
@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const Benchmark = require('benchmark')
+const data = require('./data/todolist.json')
+const path = require('path')
+
+const engines = {
+  handlebars: require('./engines/handlebars'),
+  liquid: require('./engines/liquid'),
+  react: require('./engines/react'),
+  swig: require('./engines/swig')
+}
+
+function crossEngines () {
+  console.log('     cross engines')
+  console.log('------------------------')
+  return new Promise(resolve => {
+    const suit = new Benchmark.Suite('cross engines')
+
+    for (const [name, { load, render }] of Object.entries(engines)) {
+      const tpl = load(path.resolve(__dirname, `templates/todolist`))
+      suit.add(name, () => render(tpl, data))
+    }
+
+    suit.on('cycle', event => console.log(String(event.target)))
+    suit.on('complete', resolve)
+    suit.run({ async: true })
+  })
+}
+
+module.exports = { crossEngines }
@@ -0,0 +1,28 @@
+{
+  "categories": [{
+    "color": "red",
+    "id": "CAT1",
+    "title": "work"
+  }, {
+    "color": "red",
+    "id": "CAT2",
+    "title": "emergency"
+  }, {
+    "color": "green",
+    "id": "CAT3",
+    "title": "sport"
+  }],
+  "todos": [{
+    "title": "fork and clone",
+    "id": "TODO1",
+    "category": "work"
+  }, {
+    "title": "make it better",
+    "id": "TODO2",
+    "category": "sport"
+  }, {
+    "title": "make a pull request",
+    "id": "TODO3",
+    "category": "work"
+  }]
+}
@@ -0,0 +1,26 @@
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')
+const ctx = require('./data/todolist.json')
+const { resolve } = require('path')
+
+const engine = new Liquid({
+  root: resolve(__dirname, 'templates'),
+  extname: '.liquid'
+})
+
+function demo () {
+  console.log('         demo')
+  console.log('------------------------')
+  return new Promise(resolve => {
+    new Benchmark.Suite('demo')
+      .add('demo', {
+        defer: true,
+        fn: d => engine.renderFile('todolist', ctx).then(x => d.resolve(x))
+      })
+      .on('cycle', event => console.log(String(event.target)))
+      .on('complete', resolve)
+      .run({ 'async': true })
+  })
+}
+
+module.exports = { demo }
@@ -1,49 +0,0 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
-import TagToken from '../src/parser/tag-token'
-import Scope from '../src/scope/scope'
-
-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: function (scope: Scope) {
-    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!'
-}
-
-const template = `
-{%header content: "welcome to liquid" | capitalize%}
-
-<ul>
-  {% for todo in todos %}
-  <li>{{forloop.index}} - {{todo}}</li>
-  {% endfor %}
-</ul>
-`
-
-export default function () {
-  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))
-      })
-      .on('cycle', (event: any) => console.log(String(event.target)))
-      .on('complete', resolve)
-      .run({ 'async': true })
-  })
-}
@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+const { performance } = require('perf_hooks')
+const path = require('path')
+
+const FILE_LOCAL = process.argv[2]
+const FILE_LATEST = process.argv[3]
+console.log(`Local:  ${FILE_LOCAL}`)
+console.log(`Latest: ${FILE_LATEST}`)
+
+const { createEngine } = require('./engines/create-liquid')
+const local = createEngine(require(path.resolve(__dirname, '..', FILE_LOCAL)))
+const latest = createEngine(require(path.resolve(__dirname, '..', FILE_LOCAL)))
+const data = require('./data/todolist.json')
+const tpl = path.resolve(__dirname, `templates/todolist`)
+
+const begin = performance.now()
+const tplLocal = local.load(tpl)
+const tplLatest = latest.load(tpl)
+const tasks = [
+  {
+    cycles: 0,
+    time: 0,
+    fn: () => latest.render(tplLatest, data)
+  },
+  {
+    cycles: 0,
+    time: 0,
+    fn: () => local.render(tplLocal, data)
+  }
+]
+while (performance.now() - begin < 20e3) {
+  const task = tasks[Math.floor(Math.random() * 2)]
+  task.time -= performance.now()
+  task.fn()
+  task.time += performance.now()
+  task.cycles++
+}
+
+const [ latestResult, localResult ] = tasks.map(task => {
+  task.perf = task.cycles * 1000 / task.time
+  return task
+})
+const diff = (localResult.perf - latestResult.perf) / latestResult.perf
+
+console.log(`Local: ${localResult.perf.toFixed(3)} ops/s (${localResult.cycles} cycles)`)
+console.log(`Latest: ${latestResult.perf.toFixed(3)} ops/s (${latestResult.cycles} cycles)`)
+console.log(`Diff: ${(diff * 100).toFixed(3)}%`)
+
+const THRESHOLD_PERCENT = -3
+process.exit(diff * 100 < THRESHOLD_PERCENT ? 1 : 0)
@@ -0,0 +1,17 @@
+const { readFileSync } = require('fs')
+const { join } = require('path')
+
+function createEngine (pkg) {
+  const liquid = new pkg.Liquid({
+    root: join(__dirname, '../templates'),
+    cache: true,
+    extname: '.liquid'
+  })
+  liquid.registerFilter('url', path => `http://example.com${path}`)
+  return {
+    load: path => liquid.parse(readFileSync(path + '.liquid', 'utf8')),
+    render: (tpl, data) => liquid.renderSync(tpl, data)
+  }
+}
+
+module.exports = { createEngine }
@@ -0,0 +1,33 @@
+const handlebars = require('handlebars')
+const { readFileSync } = require('fs')
+const { join } = require('path')
+
+handlebars.registerPartial(
+  'todo-icon',
+  readFileSync(join(__dirname, '../templates/todo-icon.hbs'), 'utf8')
+)
+
+handlebars.registerHelper('concat', function (...args) {
+  return args.filter(x => typeof x === 'string').join('')
+})
+
+handlebars.registerHelper('url', function (path) {
+  return `http://example.com${path}`
+})
+
+handlebars.registerHelper('inc', function (num) {
+  return Number(num) + 1
+})
+
+handlebars.registerHelper('capitalize', function (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+})
+
+handlebars.registerHelper('upcase', function (str) {
+  return str.toUpperCase()
+})
+
+module.exports = {
+  load: path => handlebars.compile(readFileSync(path + '.hbs', 'utf8')),
+  render: (tpl, data) => tpl(data)
+}
@@ -0,0 +1,3 @@
+const { createEngine } = require('./create-liquid')
+
+module.exports = createEngine(require('../../dist/liquid.node.cjs'))
@@ -0,0 +1,20 @@
+const { readFileSync } = require('fs')
+const React = require('react')
+const ReactDOMServer = require('react-dom/server')
+const babel = require('@babel/core')
+const requireFromString = require('require-from-string')
+
+const babelConfig = {
+  presets: ['@babel/preset-react', '@babel/preset-env']
+}
+
+module.exports = {
+  load: path => {
+    const src = readFileSync(path + '.jsx', 'utf8')
+    const transformed = babel.transform(src, babelConfig)
+    return requireFromString(transformed.code)
+  },
+  render: (Component, data) => {
+    return ReactDOMServer.renderToString(React.createElement(Component, data))
+  }
+}
@@ -0,0 +1,30 @@
+const swig = require('swig')
+
+swig.setFilter('url', function (path) {
+  return `http://example.com${path}`
+})
+
+swig.setFilter('prepend', function (input, arg) {
+  return arg + input
+})
+
+swig.setFilter('append', function (input, arg) {
+  return input + arg
+})
+
+swig.setFilter('inc', function (num) {
+  return Number(num) + 1
+})
+
+swig.setFilter('capitalize', function (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+})
+
+swig.setFilter('upcase', function (str) {
+  return str.toUpperCase()
+})
+
+module.exports = {
+  load: path => swig.compileFile(path + '.swig'),
+  render: (tpl, data) => tpl(data)
+}
@@ -0,0 +1,17 @@
+const { output } = require('./output')
+const { tag } = require('./tag')
+const { demo } = require('./demo')
+const { layout } = require('./layout')
+const { memory } = require('./memory')
+const { crossEngines } = require('./cross-engines')
+
+async function main () {
+  await output()
+  await tag()
+  await demo()
+  await layout()
+  await memory()
+  await crossEngines()
+}
+
+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,39 @@
+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')
+  console.log('------------------------')
+  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,62 @@
+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')
+  console.log('------------------------')
+  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(`[lorem-html ${h(str.length)}][before GC] ${h(diff1)}/tpl (${SAMPLE_COUNT} runs sampled)`)
+
+  global.gc()
+  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`[lorem-html ${h(str.length)}][after GC] ${h(diff2)}/tpl (${SAMPLE_COUNT} runs 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(`[todolist ${h(str.length)}][before GC] ${h(diff1)}/tpl (${SAMPLE_COUNT} runs sampled)`)
+
+  global.gc()
+  const diff2 = (getHeapStatistics().used_heap_size - base) / SAMPLE_COUNT
+  console.log(`[todolist ${h(str.length)}][after GC] ${h(diff2)}/tpl (${SAMPLE_COUNT} runs sampled)`)
+}
+
+function h (size) {
+  return (size / 1024).toFixed(3) + ' KB'
+}
+
+module.exports = { memory }
@@ -1,10 +1,11 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')

 const liquid = new Liquid()

-export default function () {
-  console.log('--- output ---')
+function output () {
+  console.log('         output')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('output')
      .add('literal', test('{{false}}{{"foo"}}{{32.322}}'))
@@ -12,15 +13,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 }
@@ -0,0 +1,23 @@
+{
+  "name": "benchmark",
+  "private": true,
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "start": "node --expose-gc index",
+    "engines": "node -e 'require(\"./cross-engines\").crossEngines()'"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@babel/core": "^7.13.14",
+    "@babel/preset-env": "^7.13.12",
+    "@babel/preset-react": "^7.13.13",
+    "handlebars": "^4.7.7",
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2",
+    "require-from-string": "^2.0.2",
+    "swig": "^1.4.2"
+  }
+}
@@ -1,10 +1,11 @@
-import * as Benchmark from 'benchmark'
-import Liquid from '../src/liquid'
+const Benchmark = require('benchmark')
+const { Liquid } = require('..')

 const liquid = new Liquid()

-export default function () {
-  console.log('--- tag ---')
+function tag () {
+  console.log('         tag')
+  console.log('------------------------')
  return new Promise(resolve => {
    new Benchmark.Suite('tag')
      .add('if', test('{% if "foobar" %}foo{% endif %}'))
@@ -16,15 +17,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 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">
@@ -0,0 +1 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">
@@ -0,0 +1 @@
+<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{todo.id}}.png">
@@ -0,0 +1,44 @@
+<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={{url "/add"}} class="todo-add"><i class="fa fa-plus-square"></i>Add Todo</a>
+    <ul class="filter-category">
+        {{#each categories }}
+        <li style="background: {{ color }}">
+            <a href="/todos/category/{{ id }}">{{ title }}</a>
+        </li>
+        {{/each}}
+    </ul>
+    {{#each todos }}
+    <div>
+        <h2>
+            Todo {{inc @index}}:
+            <span class="todo-item content" data-todo-index="{{@index}}">
+                {{ upcase (concat 'TODO: ' title) }}
+            </span>
+        </h2>
+        {{> todo-icon id=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 category }}
+                <span>{{ capitalize category }}</span>
+            {{/if}}
+        </div>
+        <a class="btn btn-primary" href={{ url (concat "/edit/" id) }}><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={{ url (concat "/delete/" id) }}><i class="fa fa-trash-o"</i> Trash</a>
+    </div>
+    {{/each}}
+</section>
@@ -0,0 +1,57 @@
+// eslint-disable-next-line
+const React = require('react')
+
+function capitalize (str) {
+  return str[0].toUpperCase() + str.slice(1).toLowerCase()
+}
+function url (path) {
+  return `http://example.com${path}`
+}
+function renderTodoIcon (id) {
+  return <img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{id}.png"/>
+}
+
+module.exports = ({ categories, todos }) => {
+  return <section className="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={url('/add')} className="todo-add"><i className="fa fa-plus-square"></i>Add Todo</a>
+    <ul className="filter-category">
+      {categories.map((item, i) => {
+        return <li key={i} style={{ background: item.color }}>
+          <a href={'/todos/category/' + item.id }>{ item.title }</a>
+        </li>
+      })}
+    </ul>
+    {todos.map((todo, index0) => {
+      return <div key={index0}>
+        <h2>
+                    Todo { index0 + 1 }:
+          <span className="todo-item content" data-todo-index="{{ forloop.index0 }}">
+            { ('TODO: ' + todo.title).toUpperCase() }
+          </span>
+        </h2>
+        { renderTodoIcon(todo.id) }
+
+        <p className="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 className="todo-meta">
+          { todo.category ? <span>{capitalize(todo.category)}</span> : '' }
+        </div>
+        <a className="btn btn-primary" href={url('/edit/' + todo.id)}><i className="fa fa-pencil"></i> Edit</a>
+        <a className="btn btn-default"><i className="fa fa-check"></i> Check</a>
+        <a className="btn ben-danger" href={url('/delete/' + todo.id)}><i className="fa fa-trash-o"></i> Trash</a>
+      </div>
+    })}
+  </section>
+}
@@ -0,0 +1,44 @@
+<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 item in categories %}
+        <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>
+        {% render "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 | 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,44 @@
+<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 item in categories %}
+        <li style="background: {{ item.color }}">
+            <a href="/todos/category/{{ item.id }}">{{ item.title }}</a>
+        </li>
+        {% endfor %}
+    </ul>
+    {% for todo in todos %}
+    <div>
+        <h2>
+            Todo {{ loop.index }}:
+            <span class="todo-item content" data-todo-index="{{ loop.index0 }}">
+                {{ todo.title | prepend('TODO: ') | upcase }}
+            </span>
+        </h2>
+        {% include "todo-icon.swig" %}
+
+        <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 | 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,24 @@
+#!/usr/bin/env bash
+
+set -ex
+
+rm -rf docs/source/api docs/source/zh-cn/api
+typedoc ./src --gitRevision master --out docs/source/api --plugin typedoc-plugin-markdown --ignoreCompilerErrors true --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 '1 s/"/\&quot;/g' \
+        -e '1 s/</\&lt;/g' \
+        -e '1 s/>/\&gt;/g' \
+        -e '1 s/\*//g' \
+        -e '1 s/^# \(.*\)/---\ntitle: "\1"\nauto: true\n---/' \
+        $file
+    target=${file/\/_/\/}
+    cat $file | ./bin/escape-nunjucks.js > $target
+done
+
+cp -r docs/source/api docs/source/zh-cn/api
@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+cd docs
+cp ../CHANGELOG.md source/tutorials/changelog.md
+sed -i \
+  -e 's/{%/{% raw %}{%{% endraw %}/g' \
+  -e 's/{{/{% raw %}{{{% endraw %}/g' \
+  -e '1 s/"/\&quot;/g' \
+  -e '1 s/</\&lt;/g' \
+  -e '1 s/>/\&gt;/g' \
+  source/tutorials/changelog.md
+cp source/tutorials/changelog.md source/zh-cn/tutorials/changelog.md
+
+sed -i '1i ---\ntitle: Changelog\nauto: true\n---\n' source/tutorials/changelog.md
+sed -i '1i ---\ntitle: 更新日志\nauto: true\n---\n' source/zh-cn/tutorials/changelog.md
@@ -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,16 @@
+#!/usr/bin/env bash
+
+set -ex
+
+./bin/build-contributors.sh
+./bin/build-apidoc.sh
+./bin/build-changelog.sh
+
+cd docs
+npm ci
+npm run build
+cp CNAME public/
+
+if [ "$HEXO_ALGOLIA_INDEXING_KEY" != "" ]; then
+    npm run index
+fi
@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+# Prerequisites:
+# 1.imagemagick. try brew install imagemagick
+# 2. logo.png in size 512x512
+# 3. this script should be run with cwd docs/source/icon/
+
+echo creating apple touch icons...
+apple=(57x57 60x60 72x72 76x76 114x114 120x120 144x144 152x152)
+for size in "${apple[@]}"; do
+    echo $size
+    convert logo.png -resize $size apple-touch-icon-$size.png
+done
+cp logo.png apple-touch-icon.png
+convert logo.png \
+     \( +clone -alpha extract \
+        -draw 'fill black polygon 0,0 0,80 80,0 fill white circle 80,80 80,0' \
+        \( +clone -flip \) -compose Multiply -composite \
+        \( +clone -flop \) -compose Multiply -composite \
+     \) -alpha off -compose CopyOpacity -composite apple-touch-icon-precomposed.png
+
+echo creating favicon...
+convert logo.png -resize 48x48 ../favicon.ico
+favicon=(16x16 32x32 96x96 160x160 196x196)
+for size in "${favicon[@]}"; do
+    echo $size
+    convert logo.png -resize $size favicon-$size.png
+done
+
+echo creating mstile icons...
+mstile=(70x70 144x144 150x150 310x310)
+for size in "${mstile[@]}"; do
+    echo $size
+    convert logo.png -resize $size mstile-$size.png
+done
+convert mstile-150x150.png -gravity center -background white -extent 310x150 mstile-310x150.png
@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const isQuote = c => c === '"' || c === "'"
+const isOperator = c => '!=<>'.includes(c)
+const isNumber = c => c >= '0' && c <= '9'
+const isCharacter = c => (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')
+const isIdentifier = c => '_-?'.includes(c) || isCharacter(c) || isNumber(c)
+const isBlank = c => c === '\n' || c === '\t' || c === ' ' || c === '\r' || c === '\v' || c === '\f'
+const isInlineBlank = c => c === '\t' || c === ' ' || c === '\r'
+const isSign = c => c === '-' || c === '+'
+// See https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+const unicodeBlanks = '\u00a0\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000'
+
+const types = []
+for (let i = 0; i < 128; i++) {
+  const c = String.fromCharCode(i)
+  let n = 0
+  if (isIdentifier(c)) n |= 1
+  if (isOperator(c)) n |= 2
+  if (isBlank(c)) n |= 4
+  if (isQuote(c)) n |= 8
+  if (isInlineBlank(c)) n |= 16
+  if (isNumber(c)) n |= 32
+  if (isSign(c)) n |= 64
+  types.push(n)
+}
+
+console.log(`
+// **DO NOT CHANGE THIS FILE**
+//
+// This file is generated by bin/character-gen.js
+// bitmask character types to boost performance
+export const TYPES = [${types.join(', ')}]
+export const IDENTIFIER = 1
+export const OPERATOR = 2
+export const BLANK = 4
+export const QUOTE = 8
+export const INLINE_BLANK = 16
+export const NUMBER = 32
+export const SIGN = 64
+`.trim())
+
+console.log([...unicodeBlanks].map(char => `TYPES[${char.charCodeAt(0)}]`).join(' = ') + ' = BLANK')
@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+// In Hexo, content inside markdown code/code fences,
+// will not go through nunjucks.
+// So we're escaping special chars outside code only.
+let backTick = 0
+process.stdin.on('data', (buffer) => {
+  for (const c of buffer.toString()) {
+    if (c === '`') {
+      backTick++
+    }
+    const shouldEscape = '{%%}'.includes(c) && backTick % 2 === 0
+    if (shouldEscape) {
+      const code = c.charCodeAt(0).toString(16)
+      process.stdout.write(`&#x${code};`)
+    } else process.stdout.write(c)
+  }
+})
@@ -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,16 @@
+#!/usr/bin/env bash
+
+VERSION_LATEST=$(cat package.json | grep '"version":' | awk -F'"' '{print $4}')
+FILE_LOCAL=dist/liquid.node.cjs.js
+FILE_LATEST=dist/liquid.node.cjs.$VERSION_LATEST.js
+URL_LATEST=https://unpkg.com/liquidjs@$VERSION_LATEST/dist/liquid.node.cjs.js
+
+if [ ! -f $FILE_LATEST ]; then
+    curl $URL_LATEST > $FILE_LATEST
+fi
+
+# if [ ! -f $FILE_LOCAL ]; then
+BUNDLES=cjs npm run build:dist
+# fi
+
+exec node benchmark/diff.js $FILE_LOCAL $FILE_LATEST
@@ -0,0 +1 @@
+module.exports = { extends: ['@commitlint/config-conventional'] }
@@ -0,0 +1,9 @@
+# LiquidJS for Browsers
+
+## Get Started
+
+```bash
+cd demo/browser
+npm install
+npm start
+```
@@ -1 +0,0 @@
-<h2>Welcome to {{ name | capitalize}}, {% include 'date.html' %}</h2>
@@ -3,27 +3,24 @@

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

 <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 @@
+# Using LiquidJS in ESM
+
+## Get Started
+
+```bash
+cd demo/nodejs
+npm install
+npm start
+```
@@ -0,0 +1,30 @@
+import { Liquid } from 'liquidjs'
+
+const engine = new Liquid({
+  extname: '.liquid',
+  globals: { title: 'LiquidJS Demo' },
+  // root files for `.render()` and `.parse()`
+  root: process.cwd(),
+  // layout files for `{% layout %}`
+  layouts: process.cwd() + '/layouts',
+  // partial files for `{% include %}` and `{% render %}`
+  partials: process.cwd() + '/partials'
+})
+
+const ctx = {
+  todos: ['fork and clone', 'make it better', 'make a pull request']
+}
+
+async function main () {
+  console.log('==========renderFile===========')
+  const html = await engine.renderFile('todolist', ctx)
+  console.log(html)
+
+  console.log('===========Streamed===========')
+  const tpls = await engine.parseFile('todolist')
+  engine.renderToNodeStream(tpls, ctx)
+    .on('data', data => process.stdout.write(data))
+    .on('end', () => console.log(''))
+}
+
+main()
@@ -0,0 +1,7 @@
+<html>
+  <head><meta name="title" content="{{title}}"></head>
+  <body>
+    {% block %}{% endblock %}
+    {% render "footer.liquid" %}
+  </body>
+</html>
@@ -0,0 +1,13 @@
+{
+  "name": "liquidjs-demo-nodejs",
+  "description": "Node.js demo for liquidjs",
+  "private": true,
+  "main": "index.mjs",
+  "scripts": {
+    "start": "node index.mjs"
+  },
+  "dependencies": {
+    "hello-liquid": "^1.0.0",
+    "liquidjs": "^9.28.3"
+  }
+}
@@ -0,0 +1 @@
+<small>{{title}}</small>
@@ -0,0 +1 @@
+<li>{{index}} - {{todo}}</li>
@@ -0,0 +1,7 @@
+{% layout 'html.liquid' %}
+<h1>{% include "hello-liquid" %}</h1>
+<ul>
+  {% for todo in todos %}
+    {% render 'todo.liquid' with todo, index: forloop.index%}
+  {% endfor %}
+</ul>
@@ -0,0 +1,9 @@
+# Using LiquidJS with 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,26 +1,41 @@
-const Liquid = require('liquidjs')
+const { Liquid, Tag, Value } = require('liquidjs')

 const engine = new Liquid({
+  extname: '.liquid',
+  globals: { title: 'LiquidJS Demo' },
+  // root files for `.render()` and `.parse()`
  root: __dirname,
-  extname: '.liquid'
+  // layout files for `{% layout %}`
+  layouts: './layouts',
+  // partial files for `{% include %}` and `{% render %}`
+  partials: './partials'
 })

-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>`
+engine.registerTag('header', class HeaderTag extends Tag {
+  constructor (token, remainTokens, liquid) {
+    super(token, remainTokens, liquid)
+    this.value = new Value(token.args, liquid)
+  }
+  * render (ctx, emitter) {
+    const title = yield this.value.value(ctx)
+    emitter.write(`<h1>${title}</h1>`)
  }
 })

 const ctx = {
-  todos: ['fork and clone', 'make it better', 'make a pull request'],
-  title: 'Welcome to liquidjs!'
+  todos: ['fork and clone', 'make it better', 'make a pull request']
 }

-engine.renderFile('todolist', ctx)
-  .then(console.log)
-  .catch(err => console.error(err.stack))
+async function main () {
+  console.log('==========renderFile===========')
+  const html = await engine.renderFile('todolist', ctx)
+  console.log(html)
+
+  console.log('===========Streamed===========')
+  const tpls = await engine.parseFile('todolist')
+  engine.renderToNodeStream(tpls, ctx)
+    .on('data', data => process.stdout.write(data))
+    .on('end', () => console.log(''))
+}
+
+main()
@@ -0,0 +1,7 @@
+<html>
+  <head><meta name="title" content="{{title}}"></head>
+  <body>
+    {% block %}{% endblock %}
+    {% render "footer.liquid" %}
+  </body>
+</html>
@@ -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": "^9.28.3"
  }
 }
@@ -0,0 +1 @@
+<small>{{title}}</small>
@@ -0,0 +1 @@
+<li>{{index}} - {{todo}}</li>
@@ -1,7 +1,7 @@
-{%header content: "welcome to liquid" | capitalize%}
-
+{% layout 'html.liquid' %}
+{%header title | capitalize%}
 <ul>
  {% for todo in todos %}
-  <li>{{forloop.index}} - {{todo}}</li>
+    {% render 'todo.liquid' with todo, index: forloop.index%}
  {% endfor %}
-</ul>
+</ul>
@@ -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,9 @@
+# LiquidJS for Node.js
+
+## Get Started
+
+```bash
+cd demo/nodejs
+npm install
+npm start
+```
@@ -0,0 +1,25 @@
+import { Output, Template, Tag } from 'liquidjs'
+import { isLayoutTag, isIfTag, isUnlessTag, isLiquidTag, isCaseTag, isCaptureTag, isTablerowTag, isForTag } from './type-guards'
+
+/**
+ * iterate over all `{{ output }}`
+ */
+export function * getOutputs (templates: Template[]): Generator<Output, void> {
+  for (const template of templates) {
+    if (template instanceof Tag) {
+      if (isIfTag(template) || isUnlessTag(template) || isCaseTag(template)) {
+        for (const branch of template.branches) {
+          yield * getOutputs(branch.templates)
+        }
+        yield * getOutputs(template.elseTemplates)
+      } else if (isForTag(template)) {
+        yield * getOutputs(template.templates)
+        yield * getOutputs(template.elseTemplates)
+      } else if (isLiquidTag(template) || isCaptureTag(template) || isTablerowTag(template) || isLayoutTag(template)) {
+        yield * getOutputs(template.templates)
+      }
+    } else if (template instanceof Output) {
+      yield template
+    }
+  }
+}
@@ -0,0 +1,16 @@
+import { Liquid } from 'liquidjs'
+import { getOutputs } from './get-outputs'
+
+const engine = new Liquid({
+  root: __dirname,
+  extname: '.liquid'
+})
+
+const templates = engine.parseFileSync('todolist')
+
+for (const output of getOutputs(templates)) {
+  const token = output.token
+  const [line, col] = token.getPosition()
+  const text = token.getText()
+  console.log(`[${line}:${col}] ${text}`)
+}
@@ -0,0 +1,17 @@
+{
+  "name": "liquidjs-demo-template",
+  "private": true,
+  "description": "liquid template parsing",
+  "main": "index.ts",
+  "scripts": {
+    "start": "ts-node index.ts"
+  },
+  "dependencies": {
+    "liquidjs": "latest",
+    "ts-node": "^8.10.2",
+    "typescript": "^4.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^14.14.37"
+  }
+}
@@ -0,0 +1,13 @@
+{% layout 'html.liquid' %}
+
+<h1>{{ title | capitalize }}</h1>
+<a>
+  {% if authed %} Sign out {{ username }}
+  {% else %} Sign in
+  {% endif %}
+</a>
+<ul>
+  {% for todo in todos %}
+    <p>{{ todo }}</p>
+  {% endfor %}
+</ul>
@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "downlevelIteration": true,
+    "types": [
+      "node"
+    ]
+  }
+}
@@ -0,0 +1,33 @@
+import { LayoutTag, ForTag, LiquidTag, CaptureTag, CaseTag, UnlessTag, TablerowTag, Tag, IfTag } from 'liquidjs'
+
+export function isIfTag (tag: Tag): tag is IfTag {
+  return tag.name === 'if'
+}
+
+export function isUnlessTag (tag: Tag): tag is UnlessTag {
+  return tag.name === 'unless'
+}
+
+export function isLiquidTag (tag: Tag): tag is LiquidTag {
+  return tag.name === 'liquid'
+}
+
+export function isCaseTag (tag: Tag): tag is CaseTag {
+  return tag.name === 'case'
+}
+
+export function isCaptureTag (tag: Tag): tag is CaptureTag {
+  return tag.name === 'capture'
+}
+
+export function isTablerowTag (tag: Tag): tag is TablerowTag {
+  return tag.name === 'tablerow'
+}
+
+export function isForTag (tag: Tag): tag is ForTag {
+  return tag.name === 'for'
+}
+
+export function isLayoutTag (tag: Tag): tag is LayoutTag {
+  return tag.name === 'layout'
+}
@@ -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 { Value, Liquid, TagToken, Context, Emitter, Tag, TopLevelToken } from 'liquidjs'
+
+const engine = new Liquid({
+  root: __dirname,
+  extname: '.liquid'
+})
+
+engine.registerTag('header', class HeaderTag extends Tag {
+  private value: Value
+  constructor (token: TagToken, remainTokens: TopLevelToken[], liquid: Liquid) {
+    super(token, remainTokens, liquid)
+    this.value = new Value(token.args, liquid)
+  }
+  * render (ctx: Context, emitter: Emitter) {
+    const title = yield this.value.value(ctx)
+    emitter.write(`<h1>${title}</h1>`)
+  }
+})
+
+const scope = {
+  todos: ['fork and clone', 'make it better', 'make a pull request'],
+  title: 'Welcome to liquidjs!'
+}
+
+engine.renderFile('todolist', scope).then(console.log)
@@ -1,14 +1,17 @@
 {
  "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"
+    "liquidjs": "*",
+    "ts-node": "^8.10.2",
+    "typescript": "^4.2.4"
  },
  "devDependencies": {
-    "ts-node": "^8.0.2"
+    "@types/node": "^14.14.37"
  }
 }
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				`<img title="risus. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices" src="http://images.example.com/{{id}}.png">`
				`@@ -0,0 +1 @@`
				`module.exports = { extends: ['@commitlint/config-conventional'] }`
				`@@ -1 +0,0 @@`
				`<h2>Welcome to {{ name \| capitalize}}, {% include 'date.html' %}</h2>`