abdk-mustache-js 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [1.0.0] — 2026-04-11
+
+### Added
+
+- `compile(template)` — compiles a Mustache template string to a native JS
+  function
+- `renderCompiled(template, view, partials?, escape?)` — renders a
+  pre-compiled template synchronously
+- `render(template, view, partials?, escape?)` — compiles and renders in one
+  call; string partials compiled lazily
+- `renderCompiledAsync(template, view, partials?, escape?)` — async render
+  with automatic resolution of Promise-returning view functions and async
+  partial loaders
+- `renderAsync(template, view, partials?, escape?)` — async convenience
+  wrapper accepting template strings and `string | (() => Promise<string>)`
+  partials
+- Full Mustache syntax: variables, escaped / unescaped, sections, inverted
+  sections, comments, partials, dynamic partials, set-delimiter tags
+- Template inheritance extension: `{{< parent}}` / `{{$ block}}`
+- Built-in HTML escape function; custom escape function supported on all APIs
+- Zero runtime dependencies
+- TypeScript declarations included
+
+[1.0.0]: https://github.com/abdk-consulting/abdk-mustache-js/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ABDK Consulting
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,258 @@
+# abdk-mustache-js
+
+[![npm version](https://img.shields.io/npm/v/abdk-mustache-js.svg)](https://www.npmjs.com/package/abdk-mustache-js)
+[![CI](https://github.com/abdk-consulting/abdk-mustache-js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/abdk-consulting/abdk-mustache-js/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A fast, spec-compliant [Mustache](https://mustache.github.io/) template engine
+for JavaScript / TypeScript that **compiles templates into native JavaScript
+functions** for high-throughput rendering.
+
+---
+
+## Features
+
+- **Compiled templates** — each template is compiled once to a plain JS
+  function; subsequent renders are pure function calls with no parsing overhead
+- **Full Mustache syntax** — variables, sections, inverted sections, comments,
+  partials, dynamic partials, and set-delimiter tags
+- **Template inheritance** — `{{< parent}}` / `{{$ block}}` for layout
+  composition (extends the base Mustache spec)
+- **Async rendering** — `renderAsync` / `renderCompiledAsync` resolve async
+  and Promise-returning view values automatically, with lazy async partial
+  loading
+- **TypeScript-first** — full type declarations included, zero runtime
+  dependencies
+- **No extra dependencies** — only the Node.js built-in `node:test` runner is
+  used for tests
+
+---
+
+## Installation
+
+```bash
+npm install abdk-mustache-js
+```
+
+---
+
+## Usage
+
+### Quick start
+
+```ts
+import { render } from "abdk-mustache-js";
+
+const html = render("Hello, {{name}}!", { name: "World" });
+// → "Hello, World!"
+```
+
+### Pre-compile a template
+
+Compile once, render many times:
+
+```ts
+import { compile, renderCompiled } from "abdk-mustache-js";
+
+const tmpl = compile("Hello, {{name}}!");
+
+console.log(renderCompiled(tmpl, { name: "Alice" })); // Hello, Alice!
+console.log(renderCompiled(tmpl, { name: "Bob" }));   // Hello, Bob!
+```
+
+### Sections
+
+```ts
+render("{{#show}}visible{{/show}}", { show: true });   // "visible"
+render("{{#show}}visible{{/show}}", { show: false });  // ""
+render("{{^empty}}fallback{{/empty}}", { empty: [] }); // "fallback"
+```
+
+Arrays are iterated automatically:
+
+```ts
+render(
+  "{{#items}}- {{name}}\n{{/items}}",
+  { items: [{ name: "One" }, { name: "Two" }] }
+);
+// "- One\n- Two\n"
+```
+
+### Partials
+
+```ts
+import { render } from "abdk-mustache-js";
+
+const output = render(
+  "{{> header}}Content{{> footer}}",
+  { title: "Home", year: 2026 },
+  {
+    header: "<h1>{{title}}</h1>\n",
+    footer: "<footer>{{year}}</footer>",
+  }
+);
+```
+
+### Template inheritance (blocks & parents)
+
+```ts
+import { compile, renderCompiled } from "abdk-mustache-js";
+
+const layout = compile(`
+<html>
+  <head><title>{{$title}}Default Title{{/title}}</title></head>
+  <body>{{$body}}{{/body}}</body>
+</html>
+`);
+
+const page = compile(`
+{{< layout}}
+  {{$title}}My Page{{/title}}
+  {{$body}}<p>Hello, {{name}}!</p>{{/body}}
+{{/layout}}
+`);
+
+renderCompiled(page, { name: "Alice" }, { layout });
+```
+
+### Unescaped output
+
+Use triple mustaches `{{{…}}}` or `{{& …}}` to skip HTML escaping:
+
+```ts
+render("{{{html}}}", { html: "<b>bold</b>" }); // "<b>bold</b>"
+```
+
+### Custom escape function
+
+```ts
+render("{{val}}", { val: "x" }, {}, s => s); // disable escaping entirely
+```
+
+### Async rendering
+
+`renderAsync` and `renderCompiledAsync` resolve any view property that is an
+async / Promise-returning function. Partials can also be loaded asynchronously.
+
+```ts
+import { renderAsync } from "abdk-mustache-js";
+
+const html = await renderAsync(
+  "Hello, {{name}}! You have {{count}} messages.",
+  {
+    name: async () => fetchUserName(),
+    count: async () => fetchMessageCount(),
+  }
+);
+```
+
+Async partials (loaded on demand):
+
+```ts
+import { renderAsync } from "abdk-mustache-js";
+
+const html = await renderAsync(
+  "{{> header}}{{body}}",
+  { body: "Content" },
+  {
+    // string partial — compiled eagerly
+    header: "<h1>ABDK</h1>",
+    // async partial — compiled lazily, result cached for subsequent iterations
+    nav: async () => fetchNavTemplate(),
+  }
+);
+```
+
+---
+
+## API
+
+### `compile(template: string): CompiledTemplate`
+
+Parses the template string and returns a compiled function. Throws a
+descriptive `Error` if the template is syntactically invalid (unmatched tags,
+unclosed sections, etc.).
+
+### `renderCompiled(template, view, partials?, escape?): string`
+
+Renders a pre-compiled template synchronously.
+
+| Parameter | Type | Default |
+|-----------|------|---------|
+| `template` | `CompiledTemplate` | — |
+| `view` | `any` | — |
+| `partials` | `{ [name: string]: CompiledTemplate }` | `{}` |
+| `escape` | `(s: string) => string` | built-in HTML escape |
+
+### `render(template, view, partials?, escape?): string`
+
+Compiles and renders in one call. Accepts string partials (compiled lazily on
+first use per `render` call).
+
+| Parameter | Type | Default |
+|-----------|------|---------|
+| `template` | `string` | — |
+| `view` | `any` | — |
+| `partials` | `{ [name: string]: string }` | `{}` |
+| `escape` | `(s: string) => string` | built-in HTML escape |
+
+### `renderCompiledAsync(template, view, partials?, escape?): Promise<string>`
+
+Renders a pre-compiled template; asynchronous view property functions are
+resolved automatically (re-rendering until all promises settle). Partial
+loaders are called at most once per `renderCompiledAsync` call.
+
+| Parameter | Type | Default |
+|-----------|------|---------|
+| `template` | `CompiledTemplate` | — |
+| `view` | `any` | — |
+| `partials` | `{ [name: string]: () => Promise<CompiledTemplate> }` | `{}` |
+| `escape` | `(s: string) => string` | built-in HTML escape |
+
+### `renderAsync(template, view, partials?, escape?): Promise<string>`
+
+Convenience wrapper around `renderCompiledAsync` that accepts a template
+string and string / async-function partials.
+
+| Parameter | Type | Default |
+|-----------|------|---------|
+| `template` | `string` | — |
+| `view` | `any` | — |
+| `partials` | `{ [name: string]: string \| (() => Promise<string>) }` | `{}` |
+| `escape` | `(s: string) => string` | built-in HTML escape |
+
+### `CompiledTemplate` (type)
+
+```ts
+type CompiledTemplate = (
+  view: any[],
+  partials: { [name: string]: CompiledTemplate },
+  blocks: { [name: string]: () => string },
+  escape: (string: string) => string
+) => string;
+```
+
+---
+
+## Mustache compatibility
+
+| Feature | Supported |
+|---------|-----------|
+| Variables `{{name}}` | ✓ |
+| Unescaped `{{{name}}}` / `{{& name}}` | ✓ |
+| Sections `{{#name}}…{{/name}}` | ✓ |
+| Inverted sections `{{^name}}…{{/name}}` | ✓ |
+| Comments `{{! … }}` | ✓ |
+| Partials `{{> name}}` | ✓ |
+| Dynamic partials `{{> *name}}` | ✓ |
+| Set delimiters `{{= <% %> =}}` | ✓ |
+| Template inheritance `{{< parent}}` / `{{$ block}}` | ✓ (extension) |
+| Lambda sections (raw text + render callback) | ✗ (optional spec feature) |
+| Standalone tag whitespace stripping | ✗ |
+| Partial indentation | ✗ |
+
+---
+
+## License
+
+[MIT](LICENSE) © ABDK Consulting

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type CompiledTemplate = (view: any[], partials: {
+    [name: string]: CompiledTemplate;
+}, blocks: {
+    [name: string]: () => string;
+}, escape: (string: string) => string) => string;
+export declare function compile(template: string): CompiledTemplate;
+export declare function renderCompiled(template: CompiledTemplate, view: any, partials?: {
+    [name: string]: CompiledTemplate;
+}, escape?: (string: string) => string): string;
+export declare function render(template: string, view: any, partials?: {
+    [name: string]: string;
+}, escape?: (string: string) => string): string;
+export declare function renderCompiledAsync(template: CompiledTemplate, view: any, partials?: {
+    [name: string]: () => Promise<CompiledTemplate>;
+}, escape?: (string: string) => string): Promise<string>;
+export declare function renderAsync(template: string, view: any, partials?: {
+    [name: string]: string | (() => Promise<string>);
+}, escape?: (string: string) => string): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,gBAAgB,GAAG,CAC7B,IAAI,EAAE,GAAG,EAAE,EACX,QAAQ,EAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,EAC9C,MAAM,EAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CAAA;CAAE,EACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,CAAC;AAEhD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA0I1D;AAeD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAO,EACnD,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAmB,GAC9C,MAAM,CAER;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAO,EACzC,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAmB,GAC9C,MAAM,CAYR;AAED,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAO,EAClE,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAmB,GAC9C,OAAO,CAAC,MAAM,CAAC,CAiEjB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CAAO,EACnE,MAAM,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAmB,GAC9C,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/index.js

@@ -0,0 +1,298 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = compile;
+exports.renderCompiled = renderCompiled;
+exports.render = render;
+exports.renderCompiledAsync = renderCompiledAsync;
+exports.renderAsync = renderAsync;
+function throwError(error) {
+    throw error;
+}
+function quoteString(string) {
+    return JSON.stringify(string);
+}
+function isIdentifier(string) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(string);
+}
+function escapeRegExp(string) {
+    return string.replace(/[-\/\\^$*+?.()|[\]{}]/g, "\\$&");
+}
+function compileTagRegExp(leftDelimiter, rightDelimiter) {
+    const escapedLeftDelimiter = escapeRegExp(leftDelimiter);
+    const escapedRightDelimiter = escapeRegExp(rightDelimiter);
+    return new RegExp(`${escapedLeftDelimiter}\\s*(\\{[^}]*\\}\\s*|[^{\\s].*?)${escapedRightDelimiter}`, "g");
+}
+function compile(template) {
+    let code = ``;
+    const resolve = (path) => {
+        if (path === '.') {
+            code += `x=v[0];`;
+        }
+        else {
+            const parts = path.split('.');
+            code += `x=o(${quoteString(parts[0])});`;
+            for (const part of parts) {
+                if (isIdentifier(part))
+                    code += `x=x&&f(x.${part});`;
+                else
+                    code += `x=x&&f(x[${quoteString(part)}]);`;
+            }
+        }
+    };
+    code += `const f=(x)=>typeof x==="function"?x():x;`;
+    code += `const a=(x)=>Array.isArray(x)?x:x?[x]:[];`;
+    code += `const s=(x)=>x==null?"":String(x);`;
+    code += `const S=(x)=>x==null?"":e(x);`;
+    code += `const o=(n)=>v.find(x=>x!=null&&typeof x==="object"&&n in x);`;
+    code += `let x;`;
+    code += `let r="";`;
+    let tagRegExp = compileTagRegExp('{{', '}}');
+    let index = 0;
+    let stack = [];
+    let inParent = false;
+    while (true) {
+        tagRegExp.lastIndex = index;
+        const match = tagRegExp.exec(template);
+        if (!match)
+            break;
+        if (!inParent && match.index > index)
+            code += `r+=${quoteString(template.slice(index, match.index))};`;
+        index = tagRegExp.lastIndex;
+        const tag = match[1].trim();
+        const tagMatch = tag.match(/^(?:=\s*([^=\s]+)\s+([^=\s]+)\s*=|#\s*(\S+)|\^\s*(\S+)|\/\s*(\S+)|\{\s*(\S+)\s*\}|&\s*(\S+)|!.*|>\s*\*\s*(\S+)|>\s*(\S+)|\$\s*(\S+)|<\s*\*\s*(\S+)|<\s*(\S+)|\s*(\S+))$/);
+        if (!tagMatch)
+            throw new Error(`Invalid tag: ${tag}`);
+        if (tagMatch[1] && tagMatch[2]) { // Set delimiters
+            tagRegExp = compileTagRegExp(tagMatch[1], tagMatch[2]);
+        }
+        else if (tagMatch[3]) { // Section
+            if (inParent)
+                throw new Error("Sections cannot be nested inside parents");
+            resolve(tagMatch[3]);
+            code += `x=a(x);`;
+            code += `for(const i of x){v.unshift(i);`;
+            stack.push([tagMatch[3], () => code += `v.shift();}`]);
+        }
+        else if (tagMatch[4]) { // Inverted section
+            if (inParent)
+                throw new Error("Sections cannot be nested inside parents");
+            resolve(tagMatch[4]);
+            code += `if(!a(x).length){`;
+            stack.push([tagMatch[4], () => code += `}`]);
+        }
+        else if (tagMatch[5]) { // End section
+            const [startTag, endCode] = stack.pop()
+                || throwError(Error("Unmatched end tag: " + tagMatch[5]));
+            if (startTag !== tagMatch[5])
+                throw new Error(`Unmatched end tag: ${startTag} -> ${tagMatch[5]}`);
+            endCode();
+        }
+        else if (tagMatch[6]) { // Unescaped variable with {{{}}}
+            if (inParent)
+                throw new Error("Variables cannot be nested inside parents");
+            resolve(tagMatch[6]);
+            code += `r+=s(x);`;
+        }
+        else if (tagMatch[7]) { // Unescaped variable with {{& }}
+            if (inParent)
+                throw new Error("Variables cannot be nested inside parents");
+            resolve(tagMatch[7]);
+            code += `r+=s(x);`;
+        }
+        else if (tagMatch[8]) { // Dynamic partial
+            if (inParent)
+                throw new Error("Partials cannot be nested inside parents");
+            resolve(tagMatch[8]);
+            code += `x=p[x];`;
+            code += `r+=x?x(v,p,{},e):"";`;
+        }
+        else if (tagMatch[9]) { // Partial
+            if (inParent)
+                throw new Error("Partials cannot be nested inside parents");
+            if (isIdentifier(tagMatch[9]))
+                code += `x=p.${tagMatch[9]};`;
+            else
+                code += `x=p[${quoteString(tagMatch[9])}];`;
+            code += `r+=x?x(v,p,{},e):"";`;
+        }
+        else if (tagMatch[10]) { // Block
+            if (inParent) {
+                if (isIdentifier(tagMatch[10]))
+                    code += `${tagMatch[10]}`;
+                else
+                    code += `${quoteString(tagMatch[10])}`;
+                code += `:()=>{let r="";`;
+                inParent = false;
+                stack.push([tagMatch[10], () => {
+                        code += `return r;},`;
+                        inParent = true;
+                    }]);
+            }
+            else {
+                if (isIdentifier(tagMatch[10]))
+                    code += `x=b.${tagMatch[10]};`;
+                else
+                    code += `x=b[${quoteString(tagMatch[10])}];`;
+                code += `if(x)r+=x();else{`;
+                stack.push([tagMatch[10], () => code += `}`]);
+            }
+        }
+        else if (tagMatch[11]) { // Dynamic Parent
+            if (inParent)
+                throw new Error("Parents cannot be nested inside parents");
+            resolve(tagMatch[11]);
+            code += `x=p[x];`;
+            code += `if(x)r+=x(v,p,{`;
+            stack.push([tagMatch[11], () => code += `},e);`]);
+        }
+        else if (tagMatch[12]) { // Parent
+            if (inParent)
+                throw new Error("Parents cannot be nested inside parents");
+            if (isIdentifier(tagMatch[12]))
+                code += `x=p.${tagMatch[12]};`;
+            else
+                code += `x=p[${quoteString(tagMatch[12])}];`;
+            code += `if(x)r+=x(v,p,{`;
+            inParent = true;
+            stack.push([tagMatch[12], () => {
+                    code += `},e);`;
+                    inParent = false;
+                }]);
+        }
+        else if (tagMatch[13]) { // Variable
+            if (inParent)
+                throw new Error("Variables cannot be nested inside parents");
+            resolve(tagMatch[13]);
+            code += `r+=S(x);`;
+        }
+        else {
+            // Comment, do nothing
+        }
+    }
+    if (stack.length > 0) {
+        const [startTag] = stack.pop();
+        throw new Error(`Unclosed tag: ${startTag}`);
+    }
+    code += `r+=${quoteString(template.slice(index))};`;
+    code += `return r;`;
+    try {
+        return new Function("v", "p", "b", "e", code);
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            err.message += `\n${code}`;
+        }
+        throw err;
+    }
+}
+function escapeHTML(string) {
+    return String(string).replace(/[&<>"']/g, ch => {
+        switch (ch) {
+            case "&": return "&amp;";
+            case "<": return "&lt;";
+            case ">": return "&gt;";
+            case '"': return "&quot;";
+            case "'": return "&#39;";
+            default: throw Error("Unexpected character: " + ch);
+        }
+    });
+}
+function renderCompiled(template, view, partials = {}, escape = escapeHTML) {
+    return template([view], partials, {}, escape);
+}
+function render(template, view, partials = {}, escape = escapeHTML) {
+    const compiledPartials = {};
+    return renderCompiled(compile(template), view, Object.fromEntries(Object.entries(partials).map(([name, template]) => [name, (v, p, b, e) => {
+            if (!(name in compiledPartials)) {
+                compiledPartials[name] = compile(template);
+            }
+            return compiledPartials[name](v, p, b, e);
+        }])), escape);
+}
+function renderCompiledAsync(template_1, view_1) {
+    return __awaiter(this, arguments, void 0, function* (template, view, partials = {}, escape = escapeHTML) {
+        const values = new Map();
+        const pendingValues = new Map();
+        const wrapView = (view) => {
+            if (Array.isArray(view))
+                return view.map(wrapView);
+            else if (view && typeof view === "object")
+                return Object.fromEntries(Object.entries(view).map(([key, value]) => [key, wrapView(value)]));
+            else if (typeof view === "function") {
+                if (values.has(view))
+                    return values.get(view);
+                else if (pendingValues.has(view))
+                    return null;
+                else {
+                    const promise = Promise.resolve(view());
+                    pendingValues.set(view, promise);
+                    promise.then(value => {
+                        values.set(view, value);
+                        pendingValues.delete(view);
+                    }).catch(() => {
+                        // Rejection is handled by Promise.all in the render loop;
+                        // suppress the unhandled rejection on this detached chain.
+                    });
+                    return values.has(view) ? values.get(view) : null;
+                }
+            }
+            else
+                return view;
+        };
+        const wrappedPartials = {};
+        const pendingPartials = {};
+        const wrapPartials = (partials) => {
+            return Object.fromEntries(Object.entries(partials)
+                .map(([name, partial]) => {
+                if (name in wrappedPartials)
+                    return [name, wrappedPartials[name]];
+                else if (name in pendingPartials)
+                    return null;
+                else {
+                    const promise = Promise.resolve(partial());
+                    pendingPartials[name] = promise;
+                    promise.then(compiled => {
+                        wrappedPartials[name] = compiled;
+                        delete pendingPartials[name];
+                    }).catch(() => {
+                        // Rejection is handled by Promise.all in the render loop;
+                        // suppress the unhandled rejection on this detached chain.
+                    });
+                    return name in wrappedPartials
+                        ? [name, wrappedPartials[name]]
+                        : null;
+                }
+            })
+                .filter((entry) => entry !== null));
+        };
+        while (true) {
+            const result = template([wrapView(view)], wrapPartials(partials), {}, escape);
+            if (pendingValues.size === 0 && Object.keys(pendingPartials).length === 0)
+                return result;
+            yield Promise.all([
+                ...pendingValues.values(),
+                ...Object.values(pendingPartials)
+            ]);
+        }
+    });
+}
+function renderAsync(template_1, view_1) {
+    return __awaiter(this, arguments, void 0, function* (template, view, partials = {}, escape = escapeHTML) {
+        return renderCompiledAsync(compile(template), view, Object.fromEntries(Object.entries(partials).map(([name, template]) => [name, () => __awaiter(this, void 0, void 0, function* () {
+                return compile(typeof template === "function"
+                    ? yield template()
+                    : template);
+            })
+        ])), escape);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "abdk-mustache-js",
+  "version": "1.0.0",
+  "description": "Mustache Template Engine for JavaScript by ABDK Consulting",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/index.js",
+    "dist/index.js.map",
+    "dist/index.d.ts",
+    "dist/index.d.ts.map",
+    "src/index.ts",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "build:watch": "tsc --project tsconfig.json --watch",
+    "test": "npm run build && node --test dist/test/index.test.js",
+    "lint": "tsc --project tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build && npm test",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "mustache",
+    "template"
+  ],
+  "author": "ABDK Consulting",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abdk-consulting/abdk-mustache-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/abdk-consulting/abdk-mustache-js/issues"
+  },
+  "homepage": "https://github.com/abdk-consulting/abdk-mustache-js#readme",
+  "devDependencies": {
+    "@types/node": "20.0.0",
+    "typescript": "6.0.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,298 @@
+function throwError(error: Error): never {
+  throw error;
+}
+
+function quoteString(string: string): string {
+  return JSON.stringify(string);
+}
+
+function isIdentifier(string: string): boolean {
+  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(string);
+}
+
+function escapeRegExp(string: string): string {
+  return string.replace(/[-\/\\^$*+?.()|[\]{}]/g, "\\$&");
+}
+
+function compileTagRegExp(leftDelimiter: string, rightDelimiter: string): RegExp {
+  const escapedLeftDelimiter = escapeRegExp(leftDelimiter);
+  const escapedRightDelimiter = escapeRegExp(rightDelimiter);
+  return new RegExp(`${escapedLeftDelimiter}\\s*(\\{[^}]*\\}\\s*|[^{\\s].*?)${escapedRightDelimiter}`,
+    "g");
+}
+
+export type CompiledTemplate = (
+  view: any[],
+  partials: { [name: string]: CompiledTemplate },
+  blocks: { [name: string]: () => string },
+  escape: (string: string) => string) => string;
+
+export function compile(template: string): CompiledTemplate {
+  let code = ``;
+
+  const resolve = (path: string) => {
+    if (path === '.') {
+      code += `x=v[0];`;
+    } else {
+      const parts = path.split('.');
+      code += `x=o(${quoteString(parts[0])});`;
+      for (const part of parts) {
+        if (isIdentifier(part))
+          code += `x=x&&f(x.${part});`;
+        else code += `x=x&&f(x[${quoteString(part)}]);`;
+      }
+    }
+  };
+
+  code += `const f=(x)=>typeof x==="function"?x():x;`;
+  code += `const a=(x)=>Array.isArray(x)?x:x?[x]:[];`;
+  code += `const s=(x)=>x==null?"":String(x);`;
+  code += `const S=(x)=>x==null?"":e(x);`;
+  code += `const o=(n)=>v.find(x=>x!=null&&typeof x==="object"&&n in x);`;
+  code += `let x;`;
+  code += `let r="";`;
+
+  let tagRegExp = compileTagRegExp('{{', '}}');
+  let index = 0;
+  let stack: [string, () => void][] = [];
+  let inParent = false;
+  while (true) {
+    tagRegExp.lastIndex = index;
+    const match = tagRegExp.exec(template);
+    if (!match) break;
+    if (!inParent && match.index > index)
+      code += `r+=${quoteString(template.slice(index, match.index))};`;
+    index = tagRegExp.lastIndex;
+    const tag = match[1].trim();
+    const tagMatch = tag.match(/^(?:=\s*([^=\s]+)\s+([^=\s]+)\s*=|#\s*(\S+)|\^\s*(\S+)|\/\s*(\S+)|\{\s*(\S+)\s*\}|&\s*(\S+)|!.*|>\s*\*\s*(\S+)|>\s*(\S+)|\$\s*(\S+)|<\s*\*\s*(\S+)|<\s*(\S+)|\s*(\S+))$/);
+    if (!tagMatch) throw new Error(`Invalid tag: ${tag}`);
+    if (tagMatch[1] && tagMatch[2]) { // Set delimiters
+      tagRegExp = compileTagRegExp(tagMatch[1], tagMatch[2]);
+    } else if (tagMatch[3]) { // Section
+      if (inParent) throw new Error("Sections cannot be nested inside parents");
+      resolve(tagMatch[3]);
+      code += `x=a(x);`;
+      code += `for(const i of x){v.unshift(i);`;
+      stack.push([tagMatch[3], () => code += `v.shift();}`]);
+    } else if (tagMatch[4]) { // Inverted section
+      if (inParent) throw new Error("Sections cannot be nested inside parents");
+      resolve(tagMatch[4]);
+      code += `if(!a(x).length){`;
+      stack.push([tagMatch[4], () => code += `}`]);
+    } else if (tagMatch[5]) { // End section
+      const [startTag, endCode] = stack.pop()
+        || throwError(Error("Unmatched end tag: " + tagMatch[5]));
+      if (startTag !== tagMatch[5])
+        throw new Error(`Unmatched end tag: ${startTag} -> ${tagMatch[5]}`);
+      endCode();
+    } else if (tagMatch[6]) { // Unescaped variable with {{{}}}
+      if (inParent)
+        throw new Error("Variables cannot be nested inside parents");
+      resolve(tagMatch[6]);
+      code += `r+=s(x);`;
+    } else if (tagMatch[7]) { // Unescaped variable with {{& }}
+      if (inParent)
+        throw new Error("Variables cannot be nested inside parents");
+      resolve(tagMatch[7]);
+      code += `r+=s(x);`;
+    } else if (tagMatch[8]) { // Dynamic partial
+      if (inParent)
+        throw new Error("Partials cannot be nested inside parents");
+      resolve(tagMatch[8]);
+      code += `x=p[x];`;
+      code += `r+=x?x(v,p,{},e):"";`;
+    } else if (tagMatch[9]) { // Partial
+      if (inParent) throw new Error("Partials cannot be nested inside parents");
+      if (isIdentifier(tagMatch[9]))
+        code += `x=p.${tagMatch[9]};`;
+      else code += `x=p[${quoteString(tagMatch[9])}];`;
+      code += `r+=x?x(v,p,{},e):"";`;
+    } else if (tagMatch[10]) { // Block
+      if (inParent) {
+        if (isIdentifier(tagMatch[10]))
+          code += `${tagMatch[10]}`;
+        else code += `${quoteString(tagMatch[10])}`;
+        code += `:()=>{let r="";`;
+        inParent = false;
+        stack.push([tagMatch[10], () => {
+          code += `return r;},`;
+          inParent = true;
+        }]);
+      } else {
+        if (isIdentifier(tagMatch[10]))
+          code += `x=b.${tagMatch[10]};`;
+        else code += `x=b[${quoteString(tagMatch[10])}];`;
+        code += `if(x)r+=x();else{`;
+        stack.push([tagMatch[10], () => code += `}`]);
+      }
+    } else if (tagMatch[11]) { // Dynamic Parent
+      if (inParent) throw new Error("Parents cannot be nested inside parents");
+      resolve(tagMatch[11]);
+      code += `x=p[x];`;
+      code += `if(x)r+=x(v,p,{`;
+      stack.push([tagMatch[11], () => code += `},e);`]);
+    } else if (tagMatch[12]) { // Parent
+      if (inParent) throw new Error("Parents cannot be nested inside parents");
+      if (isIdentifier(tagMatch[12]))
+        code += `x=p.${tagMatch[12]};`;
+      else code += `x=p[${quoteString(tagMatch[12])}];`;
+      code += `if(x)r+=x(v,p,{`;
+      inParent = true;
+      stack.push([tagMatch[12], () => {
+        code += `},e);`;
+        inParent = false;
+      }]);
+    } else if (tagMatch[13]) { // Variable
+      if (inParent)
+        throw new Error("Variables cannot be nested inside parents");
+      resolve(tagMatch[13]);
+      code += `r+=S(x);`;
+    } else {
+      // Comment, do nothing
+    }
+  }
+  if (stack.length > 0) {
+    const [startTag] = stack.pop()!;
+    throw new Error(`Unclosed tag: ${startTag}`);
+  }
+  code += `r+=${quoteString(template.slice(index))};`;
+  code += `return r;`;
+  try {
+    return new Function("v", "p", "b", "e", code) as CompiledTemplate;
+  } catch (err: unknown) {
+    if (err instanceof SyntaxError) {
+      err.message += `\n${code}`;
+    }
+    throw err;
+  }
+}
+
+function escapeHTML(string: string): string {
+  return String(string).replace(/[&<>"']/g, ch => {
+    switch (ch) {
+      case "&": return "&amp;";
+      case "<": return "&lt;";
+      case ">": return "&gt;";
+      case '"': return "&quot;";
+      case "'": return "&#39;";
+      default: throw Error("Unexpected character: " + ch);
+    }
+  });
+}
+
+export function renderCompiled(
+  template: CompiledTemplate,
+  view: any,
+  partials: { [name: string]: CompiledTemplate } = {},
+  escape: (string: string) => string = escapeHTML
+): string {
+  return template([view], partials, {}, escape);
+}
+
+export function render(
+  template: string,
+  view: any,
+  partials: { [name: string]: string } = {},
+  escape: (string: string) => string = escapeHTML
+): string {
+  const compiledPartials: { [name: string]: CompiledTemplate } = {};
+  return renderCompiled(
+    compile(template),
+    view,
+    Object.fromEntries(Object.entries(partials).map(([name, template]) =>
+      [name, (v, p, b, e) => {
+        if (!(name in compiledPartials)) {
+          compiledPartials[name] = compile(template);
+        }
+        return compiledPartials[name](v, p, b, e);
+      }])), escape);
+}
+
+export async function renderCompiledAsync(
+  template: CompiledTemplate,
+  view: any,
+  partials: { [name: string]: () => Promise<CompiledTemplate> } = {},
+  escape: (string: string) => string = escapeHTML
+): Promise<string> {
+  const values = new Map<Function, any>();
+  const pendingValues = new Map<Function, Promise<any>>();
+
+  const wrapView = (view: any): any => {
+    if (Array.isArray(view)) return view.map(wrapView);
+    else if (view && typeof view === "object")
+      return Object.fromEntries(Object.entries(view).map(([key, value]) =>
+        [key, wrapView(value)]));
+    else if (typeof view === "function") {
+      if (values.has(view)) return values.get(view);
+      else if (pendingValues.has(view)) return null;
+      else {
+        const promise = Promise.resolve(view());
+        pendingValues.set(view, promise);
+        promise.then(value => {
+          values.set(view, value);
+          pendingValues.delete(view);
+        }).catch(() => {
+          // Rejection is handled by Promise.all in the render loop;
+          // suppress the unhandled rejection on this detached chain.
+        });
+        return values.has(view) ? values.get(view) : null;
+      }
+    } else return view;
+  };
+
+  const wrappedPartials: { [name: string]: CompiledTemplate } = {};
+  const pendingPartials: { [name: string]: Promise<CompiledTemplate> } = {};
+
+  const wrapPartials = (partials: {
+    [name: string]: () => Promise<CompiledTemplate>
+  }) => {
+    return Object.fromEntries(
+      Object.entries(partials)
+        .map(([name, partial]) => {
+          if (name in wrappedPartials) return [name, wrappedPartials[name]];
+          else if (name in pendingPartials) return null;
+          else {
+            const promise = Promise.resolve(partial());
+            pendingPartials[name] = promise;
+            promise.then(compiled => {
+              wrappedPartials[name] = compiled;
+              delete pendingPartials[name];
+            }).catch(() => {
+              // Rejection is handled by Promise.all in the render loop;
+              // suppress the unhandled rejection on this detached chain.
+            });
+            return name in wrappedPartials
+              ? [name, wrappedPartials[name]]
+              : null;
+          }
+        })
+        .filter((entry): entry is [string, CompiledTemplate] => entry !== null)
+    );
+  };
+
+  while (true) {
+    const result = template([wrapView(view)], wrapPartials(partials), {}, escape);
+    if (pendingValues.size === 0 && Object.keys(pendingPartials).length === 0) return result;
+    await Promise.all([
+      ...pendingValues.values(),
+      ...Object.values(pendingPartials)
+    ]);
+  }
+}
+
+export async function renderAsync(
+  template: string,
+  view: any,
+  partials: { [name: string]: string | (() => Promise<string>) } = {},
+  escape: (string: string) => string = escapeHTML
+): Promise<string> {
+  return renderCompiledAsync(
+    compile(template),
+    view,
+    Object.fromEntries(Object.entries(partials).map(([name, template]) =>
+      [name, async () =>
+        compile(typeof template === "function"
+          ? await template()
+          : template)
+      ])), escape);
+}