miki-template 1.2.0 → 1.3.6

package/ROADMAP.md

@@ -1,40 +1,40 @@
-# Project Roadmap - Django-Style Template Engine
-
-Our release and packaging timeline.
-
----
-
-## 🏁 Phase 1 - Core Delivery (Day 1-2)
-- [x] High-performance tokenizing Lexer.
-- [x] AST parser mapping nested blocks.
-- [x] Context Stack Manager supporting dotted lookup and function calls.
-- [x] HTML Auto-escaping using `he` library and `SafeString` wrappers.
-- [x] Complete suite of built-in filters (25+ filters).
-- [x] Core control flow tags (`if`, `for`, `with`, `cycle`, `autoescape`, `comment`, `verbatim`).
-- [x] Dynamic inheritance (`extends`, `block`, `include` with parameter scope).
-- [x] Express layout adapter (`__express`).
-- [x] Complete test suite verification.
-
----
-
-## 🚀 Phase 2 - Advanced Performance & Ecosystem (Next Month)
-- [x] **CI/CD Pipeline** – linting, testing, and automated npm publishing via GitHub Actions.
-- [x] **AST Caching** – cache compiled ASTs for static templates (implemented).
-- [x] **Custom Tag Helpers** – simplify registration of custom block tags (implemented via helpers).
-- [x] **Async Render Options** – support async filters/tags for DB lookups (implemented).
-- [x] **Extended Date Syntax** – integrate `date-fns` for full date formatting parity (implemented).
-- [x] **Advanced Usage Docs** – examples covering partialdef, block rendering, and API (added).
-- [x] **Performance Benchmarks** – baseline measurements and optimization guide (added).
-
----
-
-## 📦 Phase 3 - Ecosystem & Tooling (Q4)
-- [ ] VS Code Extension: Syntax highlighting for `.dtpl` or `.html` Django templates.
-- [ ] Web Playground: An interactive sandbox to experiment with the engine.
-- [ ] CLI Compiler: Render templates from the command line.
-
----
-
-## 📚 Documentation
-- [x] Comprehensive docs in `docs/` covering installation, usage, tags, filters, partialdef, security, and API.
-- [x] Advanced examples and performance guide (added).
+# Project Roadmap - Django-Style Template Engine
+
+Our release and packaging timeline.
+
+---
+
+## 🏁 Phase 1 - Core Delivery (Day 1-2)
+- [x] High-performance tokenizing Lexer.
+- [x] AST parser mapping nested blocks.
+- [x] Context Stack Manager supporting dotted lookup and function calls.
+- [x] HTML Auto-escaping using `he` library and `SafeString` wrappers.
+- [x] Complete suite of built-in filters (25+ filters).
+- [x] Core control flow tags (`if`, `for`, `with`, `cycle`, `autoescape`, `comment`, `verbatim`).
+- [x] Dynamic inheritance (`extends`, `block`, `include` with parameter scope).
+- [x] Express layout adapter (`__express`).
+- [x] Complete test suite verification.
+
+---
+
+## 🚀 Phase 2 - Advanced Performance & Ecosystem (Next Month)
+- [x] **CI/CD Pipeline** – linting, testing, and automated npm publishing via GitHub Actions.
+- [x] **AST Caching** – cache compiled ASTs for static templates (implemented).
+- [x] **Custom Tag Helpers** – simplify registration of custom block tags (implemented via helpers).
+- [x] **Async Render Options** – support async filters/tags for DB lookups (implemented).
+- [x] **Extended Date Syntax** – integrate `date-fns` for full date formatting parity (implemented).
+- [x] **Advanced Usage Docs** – examples covering partialdef, block rendering, and API (added).
+- [x] **Performance Benchmarks** – baseline measurements and optimization guide (added).
+
+---
+
+## 📦 Phase 3 - Ecosystem & Tooling (Q4)
+- [ ] VS Code Extension: Syntax highlighting for `.dtpl` or `.html` Django templates.
+- [ ] Web Playground: An interactive sandbox to experiment with the engine.
+- [ ] CLI Compiler: Render templates from the command line.
+
+---
+
+## 📚 Documentation
+- [x] Comprehensive docs in `docs/` covering installation, usage, tags, filters, partialdef, security, and API.
+- [x] Advanced examples and performance guide (added).

package/benchmarks/report.json

@@ -1,17 +1,17 @@
-[
-  {
-    "name": "small",
-    "syncAvgMs": "0.04",
-    "asyncAvgMs": "0.03"
-  },
-  {
-    "name": "medium",
-    "syncAvgMs": "0.00",
-    "asyncAvgMs": "0.01"
-  },
-  {
-    "name": "large",
-    "syncAvgMs": "0.00",
-    "asyncAvgMs": "0.01"
-  }
+[
+  {
+    "name": "small",
+    "syncAvgMs": "0.04",
+    "asyncAvgMs": "0.03"
+  },
+  {
+    "name": "medium",
+    "syncAvgMs": "0.00",
+    "asyncAvgMs": "0.01"
+  },
+  {
+    "name": "large",
+    "syncAvgMs": "0.00",
+    "asyncAvgMs": "0.01"
+  }
 ]

package/benchmarks/run.js

@@ -1,49 +1,49 @@
-// benchmarks/run.js
-// Simple benchmark for sync vs async rendering
-const { compile, asyncRender } = require('../src');
-const fs = require('fs');
-const path = require('path');
-const { performance } = require('perf_hooks');
-
-function loadTemplate(name) {
-  const filePath = path.join(__dirname, 'templates', `${name}.dtpl`);
-  return fs.readFileSync(filePath, 'utf8');
-}
-
-function benchRender(name, iterations = 20) {
-  const tmplStr = loadTemplate(name);
-  const compiled = compile(tmplStr);
-  // warm up cache
-  compiled.render({});
-  compiled.asyncRender({});
-
-  const syncTimes = [];
-  const asyncTimes = [];
-  for (let i = 0; i < iterations; i++) {
-    const t0 = performance.now();
-    compiled.render({});
-    syncTimes.push(performance.now() - t0);
-
-    const t1 = performance.now();
-    asyncRender(tmplStr, {});
-    asyncTimes.push(performance.now() - t1);
-  }
-  const avg = arr => arr.reduce((a,b)=>a+b,0)/arr.length;
-  return {
-    name,
-    syncAvgMs: avg(syncTimes).toFixed(2),
-    asyncAvgMs: avg(asyncTimes).toFixed(2)
-  };
-}
-
-function main() {
-  const results = [];
-  ['small','medium','large'].forEach(name => {
-    results.push(benchRender(name));
-  });
-  console.log('Benchmark results:', results);
-  const outPath = path.join(__dirname, 'report.json');
-  fs.writeFileSync(outPath, JSON.stringify(results, null, 2));
-}
-
-main();
+// benchmarks/run.js
+// Simple benchmark for sync vs async rendering
+const { compile, asyncRender } = require('../src');
+const fs = require('fs');
+const path = require('path');
+const { performance } = require('perf_hooks');
+
+function loadTemplate(name) {
+  const filePath = path.join(__dirname, 'templates', `${name}.dtpl`);
+  return fs.readFileSync(filePath, 'utf8');
+}
+
+function benchRender(name, iterations = 20) {
+  const tmplStr = loadTemplate(name);
+  const compiled = compile(tmplStr);
+  // warm up cache
+  compiled.render({});
+  compiled.asyncRender({});
+
+  const syncTimes = [];
+  const asyncTimes = [];
+  for (let i = 0; i < iterations; i++) {
+    const t0 = performance.now();
+    compiled.render({});
+    syncTimes.push(performance.now() - t0);
+
+    const t1 = performance.now();
+    asyncRender(tmplStr, {});
+    asyncTimes.push(performance.now() - t1);
+  }
+  const avg = arr => arr.reduce((a,b)=>a+b,0)/arr.length;
+  return {
+    name,
+    syncAvgMs: avg(syncTimes).toFixed(2),
+    asyncAvgMs: avg(asyncTimes).toFixed(2)
+  };
+}
+
+function main() {
+  const results = [];
+  ['small','medium','large'].forEach(name => {
+    results.push(benchRender(name));
+  });
+  console.log('Benchmark results:', results);
+  const outPath = path.join(__dirname, 'report.json');
+  fs.writeFileSync(outPath, JSON.stringify(results, null, 2));
+}
+
+main();