miki-template 2.3.1 → 2.3.2

package/API_REFERENCE.md

@@ -1,341 +0,0 @@
-# API Reference - miki-template
-
-This document provides complete details for the public APIs exported by the **miki-template** engine — a Django-style template engine for Node.js and Express.
-
----
-
-## Core Exports
-
-```javascript
-const {
-  compile,
-  render,
-  asyncRender,
-  __express,
-  clearCache,
-  registerTag,
-  registerFilter,
-  registerHelper,
-  registerContextProcessor,
-  SafeString,
-  markSafe,
-  isSafe,
-  escapeHtml
-} = require('miki-template');
-```
-
----
-
-### `compile(templateStr, options)`
-
-Compiles a raw template string into a reusable compiled template object. The compiled template caches its AST internally.
-
-**Parameters**:
-- `templateStr` (string): The raw template string to compile.
-- `options` (object): Config parameters:
-  - `views` (string|string[]): Directories to search for templates when using `extends` or `include`.
-  - `staticUrl` (string): Prefix for the `{% static %}` tag. Defaults to `/static/`.
-  - `urlHelper` (function): Custom URL resolver for `{% url %}` tag.
-
-**Returns**: An object containing:
-- `render(context)` — Synchronously renders the template.
-- `asyncRender(context)` — Returns a Promise for async rendering.
-- `renderBlock(blockName, context)` — Renders a specific block by name.
-- `renderPartial(partialName, context)` — Renders a defined partial by name.
-
-**Example**:
-```javascript
-const { compile } = require('miki-template');
-
-const template = compile('Hello {{ name }}!');
-const output = template.render({ name: 'World' });
-console.log(output); // Hello World!
-```
-
----
-
-### `render(templateStr, context, options)`
-
-One-step convenience function that compiles and renders a template.
-
-**Parameters**:
-- `templateStr` (string): Raw template string.
-- `context` (object): Variables available to the template.
-- `options` (object): Same as `compile()` options.
-
-**Returns**: Rendered HTML string.
-
----
-
-### `asyncRender(templateStr, context, options)`
-
-Asynchronous rendering for templates with async helpers or async context processors.
-
-**Parameters**: Same as `render()`.
-
-**Returns**: `Promise<string>` — resolved rendered HTML.
-
-**Example**:
-```javascript
-const { asyncRender } = require('miki-template');
-const html = await asyncRender('Hello {{ name }}!', { name: 'Async' });
-```
-
----
-
-### `__express(filePath, options, callback)`
-
-Express-compatible view engine adapter. Use with `app.engine()`.
-
-**Parameters**:
-- `filePath` (string): Absolute path to the template file.
-- `options` (object): Express `res.render()` context (view engine strips `_locals`, `settings`, and other Express internals).
-- `callback` (function): Node.js callback `(err, html)`.
-
-**Example**:
-```javascript
-const express = require('express');
-const { __express } = require('miki-template');
-
-const app = express();
-app.engine('html', __express);
-app.set('view engine', 'html');
-app.set('views', './views');
-
-app.get('/', (req, res) => {
-  res.render('home', { title: 'Home Page' });
-});
-```
-
-### Template discovery helpers
-
-`miki-template` exposes helpers to discover templates across multiple
-`views` roots and to configure what directory names are considered
-app-style template folders (e.g. `templates` or `app_templates`). These
-are useful for projects that place templates in nested app folders or
-package-level `templates/` directories.
-
-#### `findTemplateInViews(name, viewsDirs)`
-
-Search for a template by `name` across the provided `viewsDirs` array
-or single string. Performs direct resolution first, then a recursive
-search for bare filenames. Returns the absolute file path or `null`.
-
-Example:
-```js
-const found = require('miki-template').findTemplateInViews('detail', ['./views', './templates']);
-```
-
-#### `setAppTemplateDirNames(names)` / `getAppTemplateDirNames()`
-
-Configure and retrieve the directory names treated as app-style
-template folders when scanning the project tree. The default is
-`['templates']`. Use `setAppTemplateDirNames(['templates','app_templates'])`
-to include additional conventions.
-
-
----
-
-### `registerTag(name, parserFn)`
-
-Registers a custom block tag parser. Must be called **before** compiling templates that use the tag.
-
-**Parameters**:
-- `name` (string): Tag identifier word (e.g. `mytag` for `{% mytag %}`).
-- `parserFn` (function): `(tagContent: string, parser: Parser) => ASTNode`. Receives the raw tag content and the parser instance.
-
-**Returns**: `undefined`.
-
-**Example**:
-```javascript
-const { registerTag } = require('miki-template');
-
-registerTag('greet', (tagContent, parser) => {
-  const name = tagContent.slice(5).trim(); // strip 'greet'
-  return {
-    render: (context) => `Hello ${context.get(name) || 'Guest'}!`
-  };
-});
-
-// In template: {% greet user.name %}
-```
-
----
-
-### `registerFilter(name, filterFn)`
-
-Registers a custom filter function.
-
-**Parameters**:
-- `name` (string): Filter name used after the pipe `|`.
-- `filterFn` (function): `(value: any, arg?: any) => any`. Receives the filtered value and optional argument.
-
-**Returns**: `undefined`.
-
-**Example**:
-```javascript
-const { registerFilter } = require('miki-template');
-
-registerFilter('reverse', (val) => {
-  return String(val).split('').reverse().join('');
-});
-
-// In template: {{ name|reverse }}
-```
-
----
-
-### `registerHelper(name, fn)`
-
-Registers a custom block helper tag. The helper receives the **rendered** inner content as a string.
-
-**Parameters**:
-- `name` (string): Tag name (e.g. `markdown` creates `{% markdown %}...{% endmarkdown %}`).
-- `fn` (function): `(innerContent: string, context: Context) => string | Promise<string>`.
-
-**Returns**: `undefined`.
-
-**Example**:
-```javascript
-const { registerHelper } = require('miki-template');
-const markdownIt = require('markdown-it')();
-registerHelper('markdown', (content) => markdownIt.render(content));
-
-// In template:
-// {% markdown %}
-// # Hello
-// {% endmarkdown %}
-```
-
----
-
-### `registerContextProcessor(fn)`
-
-Adds a context processor function. Similar to Django's custom context processors.
-
-**Parameters**:
-- `fn` (function): `(context: object) => object | undefined`. Receives the render context and returns extra key-value pairs to merge in.
-
-**Returns**: `undefined`.
-
-**Example**:
-```javascript
-const { registerContextProcessor } = require('miki-template');
-
-registerContextProcessor((ctx) => ({
-  siteName: 'MySite',
-  currentYear: new Date().getFullYear()
-}));
-
-// Available in all templates as {{ siteName }} and {{ currentYear }}
-```
-
----
-
-### `SafeString`
-
-Class for values that should **bypass HTML auto-escaping**. Construct directly or use `markSafe()`.
-
-**Example**:
-```javascript
-const { SafeString } = require('miki-template');
-
-const html = new SafeString('<b>Bold</b>');
-// {{ html }} renders as <b>Bold</b>, NOT &lt;b&gt;Bold&lt;/b&gt;
-```
-
----
-
-### `markSafe(value)`
-
-Wraps any value in a `SafeString`, instructing the engine to skip HTML escaping for that value.
-
-**Parameters**:
-- `value` (any): Value to mark as safe.
-
-**Returns**: `SafeString`.
-
-**Example**:
-```javascript
-const { markSafe } = require('miki-template');
-
-const html = markSafe('<script>alert("xss")</script>');
-// {{ html }} outputs the script tag literally (use with caution)
-```
-
----
-
-### `isSafe(value)`
-
-Checks whether a value is a `SafeString` instance.
-
-**Parameters**:
-- `value` (any): Value to check.
-
-**Returns**: `boolean`.
-
----
-
-### `escapeHtml(str)`
-
-Programmatically escapes HTML special characters (`<`, `>`, `&`, `"`, `'`).
-
-**Parameters**:
-- `str` (string): String to escape.
-
-**Returns**: `string`.
-
----
-
-### `clearCache()`
-
-Clears the in-memory AST cache. Useful for development or when templates change at runtime.
-
-**Example**:
-```javascript
-const { clearCache } = require('miki-template');
-
-app.on('restart', () => clearCache());
-```
-
----
-
-## Compiled Template API
-
-`compile()` returns an object with these methods:
-
-### `compiled.render(context)`
-
-Synchronously renders the template with the given context.
-
-```javascript
-const compiled = compile('Hello {{ name }}!');
-compiled.render({ name: 'World' }); // "Hello World!"
-```
-
-### `compiled.asyncRender(context)`
-
-Renders asynchronously, awaiting any Promise-returning helpers.
-
-```javascript
-const html = await compiled.asyncRender({ name: 'Async' });
-```
-
-### `compiled.renderBlock(blockName, context)`
-
-Renders **only** the named block. Useful for HTMX or AJAX partial responses.
-
-```javascript
-// Template: {% extends "base.html" %}
-//          {% block content %}Main{% endblock %}
-compiled.renderBlock('content', {}); // "Main"
-```
-
-### `compiled.renderPartial(partialName, context)`
-
-Renders a `{% partialdef %}` block by name.
-
-```javascript
-// Template: {% partialdef header %}My Header{% endpartialdef %}
-compiled.renderPartial('header', {}); // "My Header"
-```

package/CHANGELOG.md

@@ -1,173 +0,0 @@
-# Changelog
-
-## [1.3.4] - 2026-09-05
-### Fixed
-- **Express views path resolution** — normalize `views` entries and ensure miki treats file paths as directories when resolving templates and `#partial` lookups. This fixes `Failed to lookup view "home" in views directory ".../dir"` when `miki-template` is used from a host project's `node_modules` and `views` is passed as a file path.
-
-## [1.3.3] - 2026-09-04
-### Fixed
-- **`date` and `time` filters** — multi-character tokens (`yyyy`, `MM`, `dd`, `HH`, `mm`, `ii`, `ss`) now work correctly. Previously `"yyyy-MM-dd"` rendered as `"24242424-JunJun-1515"` because each character was treated as an independent token. The fix uses longest-first token matching and adds backward-compatible single-character aliases (`m`/`d`/`H`/`i`/`s` for Django-style unpadded values).
-
-### Performance
-- **Inheritance parent-source cache** — `{% extends %}` no longer re-reads the parent template from disk on every render. A 64-entry LRU cache in `src/cache.js` (`getParentSource` / `hasParentSource`) memoises the parent source. Inheritance rendering improved from ~481 rps to **~2,056 rps** in the stress benchmark (4.3× faster, no functional change).
-
-### Tooling
-- **`benchmarks/stress.mjs`** — comprehensive 37-check stress benchmark covering correctness, compile speed, render speed, cache behavior, scale, endurance, partial rendering, async, and concurrency. Run with `node benchmarks/stress.mjs`. Exits with code 1 on any failure.
-- **`eslint.config.mjs`** — added `URL`, `URLSearchParams`, `TextEncoder`, `TextDecoder`, `fetch`, `crypto`, `performance` to the Node 18+ globals list so `no-undef` no longer flags standard Web APIs.
-- Removed dead code flagged by the linter: unused `elifBranches` variable in `parseIfChanged`, unused `extractPluralMappings` function in `i18n.js`. Renamed unused tag-parser `parser` parameters to `_parser` in `lorem` library and `parseLoad`.
-
-### Verification
-- `npx eslint src/**/*.js` — 0 errors, 0 warnings
-- `npm test` — 397/397 passing
-- `node benchmarks/stress.mjs` — 37/37 passing
-
-## [1.3.1] - 2026-09-03
-### Highlights
-- **One-line Express integration**: `miki.setupExpress(app, { extension: 'html', views: dir })` — wires the view engine, `views` directory, and a `res.render` shim that lets you do `res.render('home#card', ...)` for HTMX-style partial responses. No more boilerplate, no extra middleware.
-- **Render-any-partial-from-string**: `renderPartialFromSource(source, partialName, ctx, opts)` loads a template string and returns only the named `{% partialdef %}` body. This is what powers `res.render('view#partial')` and HTMX responses.
-- **True built-in libraries**: `humanize`, `cache`, and `lorem` are now auto-activated on module load — `{% lorem %}` works without `{% load lorem %}`. Existing libraries now also expose helpers, not just tags.
-- **Comprehensive integration test suite**: 382 tests covering every tag, filter, and feature under both CommonJS and ESM, all running against a **real Express HTTP server** on ephemeral ports.
-
-### Added
-- `miki.setupExpress(app, { extension, views, async })` — one-line Express bootstrap. Sets `view engine`, registers the engine, and patches `res.render` to handle `view#partial` selectors. Replaces the need to call `app.engine()`, `app.set('views')`, and `app.set('view engine')` manually.
-- `miki.express()` — factory that returns a view-engine function suitable for `app.engine(...)`. Honors `view#partial` suffixes.
-- `miki.expressPartialRenderer()` — middleware that adds `res.renderPartial(view, locals)`. Useful as a drop-in HTMX helper.
-- `renderPartialFromSource(source, partialName, context, options)` — render a single named partial from a template string. Resolves `extends` chains so partials defined inside `{% block %}` tags are discoverable. Walks the AST and registers every `PartialDefNode` it finds, even when nested inside `{% for %}` or `{% if %}` blocks that won't render during partial lookup.
-- `renderPartialFromFile(filePath, partialName, context, options)` — file-based convenience wrapper.
-- `Context.get(name)` now returns `undefined` for missing keys (was `''`). This lets `default_if_none` distinguish "not provided" from an explicit empty string, matching Django.
-- `escapeHtml(value, force = false)` — added a `force` flag so the `|escape` filter re-escapes even a `SafeString` (Django parity).
-- `Context` constructor now supports `partialDefs` and `options` for cloning the partial registry.
-- New exports: `setupExpress`, `express`, `expressPartialRenderer`, `renderPartialFromFile`, `renderPartialFromSource`, `clearContextProcessors`.
-- ESM surface (`src/esm.mjs`) now exposes all the new helpers, with the same `default` + named import shape.
-- Lorem library now ships a real `{% lorem N method %}` tag, a `lorem` filter, plus helpers. Built-in and auto-activated.
-- `library.activate(name)` now also activates helpers and `registerTag` functions, not just filters.
-
-### Changed
-- Context processors now follow Django semantics: **existing context values win** over processor defaults. If you render with `{ user: req.user }` and a processor returns `{ user: 'Guest' }`, the explicit value is preserved.
-- `__express` and `__expressAsync` now detect a `#partial` suffix in the view name and delegate to `renderPartialFromSource` automatically. This makes `app.engine('html', miki.__express)` already HTMX-ready — `setupExpress` just adds convenience.
-- `cache.getCompiled` ignores function-valued and `undefined` options when building cache keys, so passing the same `urlHelper` function to multiple `compile()` calls no longer causes cache misses.
-- Lexer rewritten with brace-depth counting for more reliable `{{ }}` and `{% %}` tokenization in templates with nested braces, escaped braces, and unusual whitespace.
-- Filters now receive the rendering `context` as a final argument, so custom filters can read other context variables (e.g. for locale-aware formatting).
-- `for` and `with` tags fully reworked for the user-reported edge cases:
-  - `{% with x=1, y=2 as pair %}` — pair list followed by an alias.
-  - `{% with value=expr %}` — single pair (no comma).
-  - `{% with x=1, y=2 %}` — pure pair list (no alias).
-  - Quoted values containing commas (`{% with a="x,y" %}`) parse correctly.
-  - Pair values may be context variables.
-- `partial` now accepts `with` kwargs and overrides context for the partial scope.
-- `include` now supports `file#partial` syntax — the same partial-selector pattern works with `{% include %}` as with `res.render`.
-- `url` tag respects `urlHelper` more cleanly: kwargs (a trailing object literal) are passed as the last argument instead of being conflated with positional args.
-- `static` tag normalizes leading slashes; prefix can be customized.
-- `csrf_token` and `csp_nonce_attr` outputs are properly escaped to prevent attribute injection.
-
-### Fixed
-- `with a=x b=y` (multi-pair) was previously treated as a single value/expression. Now correctly binds each pair.
-- `cycle` with `as` form emits nothing but stores the value, matching Django.
-- `block.super` works inside partials that override blocks.
-- `extends` resolves `views` from `options.settings.views` (Express's normal path), `options.views`, or the default.
-- Path traversal protection now applies to `extends` *and* `include`, including `include "file#partial"` form.
-- `if` conditions handle dotted lookup, function auto-call, and missing variables without throwing.
-- `default` vs `default_if_none`: `default` falls back on empty string, `null`, and `undefined`; `default_if_none` only on `null`/`undefined`. Both now match Django exactly.
-- `removetags` filter now accepts multiple tag names.
-- `safe` / `escape` filters correctly re-escape `SafeString` only when forced.
-- `Context.get('a.b.c')` no longer stringifies `undefined` to `''`, fixing `{% if x %}` checks against missing variables.
-- Cache key collisions when passing the same template string with different function-valued options (e.g. `urlHelper`).
-
-### Compatibility
-- No breaking changes. All existing public APIs continue to work. New APIs are opt-in.
-
-## [1.2.0] - 2026-09-01
-### Added
-- Full **ESM** support via `src/esm.mjs` wrapper and conditional `package.json` exports.
-- **TypeScript** type definitions (`src/types.d.ts`).
-- **Async Express 5+** adapter: `__expressAsync(filePath, options) → Promise<string>`.
-- **i18n**: `trans` tag/filter, `blocktrans`, `language`, plural rules, `registerTranslation`.
-- **Plugin/library system**: `registerLibrary`, `registerLibraryFromPath`, built-ins (`humanize`, `cache`, `lorem`).
-- **`load` tag** now activates registered libraries (no longer a stub).
-- **`widthratio`** tag for proportional width calculations.
-- **`debug`** tag for dumping template context during development.
-- **`regroup`** filter for grouping arrays by attribute.
-- **`strftime`** filter with full `date-fns` format support.
-- **Unclosed tag validation**: throws descriptive errors for missing `endif`/`endfor`/`endwith`.
-- **Filter chaining on string literals**: `{{ "Hello"|lower|capfirst }}` now works.
-- New exports: `getFilter`, `stripExpressContext`, `activateLibrary`.
-
-### Fixed
-- `for` loop now supports filter expressions in iterable path (e.g. `items|regroup:"category"`).
-- `Context.reset()` properly clears cycle state and blocks between renders.
-- `__express` strips Express framework keys (`_locals`, `settings`, `cache`) from context.
-- `renderPartial` renders only the named partial, not the full template.
-- `with` tag correctly handles multiple `key=value` assignments and quoted values.
-- `if` tag condition evaluation handles `not`, `and`, `or`, and operator precedence correctly.
-- `forloop.parentloop` correctly propagates for nested loops.
-- `floatformat` default behavior matches Django (1 decimal place).
-- `timesince`/`timeuntil` handle seconds, minutes, hours, days correctly.
-- `pluralize` correctly handles singular vs plural forms.
-- `default` filter treats empty string `''` as falsy like Django.
-- `striptags` correctly removes HTML tags and handles edge cases.
-- Spaceless tag preserves whitespace inside tag attributes correctly.
-
-### Changed
-- Condition evaluation rewritten to use shunting-yard algorithm for correct operator precedence.
-- Simplified `for` loop to use `[key, value]` tuples internally for cleaner unpacking.
-- Improved `partialdef` to support both quoted and unquoted partial names.
-- `floatformat` with `-1` argument now removes all decimals.
-
-## [1.1.0] - 2026-08-31
-### Added
-- Missing `comment`/`endcomment` tag support for block comments.
-- `firstof` tag to return the first non-falsy value from arguments.
-- `length_is` filter for comparing length to a value.
-- `urlencode`, `escapeuri`, `stringformat`, `cut`, `addslashes`, `removetags` filters for Django parity.
-- `Context.reset()` method for clearing state between renders.
-- `firstof` filter variant for inline first-truthy selection.
-
-### Fixed
-- Malformed code in `inheritance.js` with extra closing braces.
-- `__express` was not exported from the module.
-- `__express` now strips Express framework keys (`_locals`, `settings`, etc.) from context.
-- `renderPartial` now properly extracts and renders only the named partial definition.
-- `with` tag now correctly handles multiple `key=value` assignments and quoted values.
-- `if` tag condition evaluation now properly handles `not`, `and`, `or`, and operator precedence.
-- `for` loop now correctly unpacks `key, value` from objects and `item, index` from arrays.
-- `forloop.parentloop` now correctly chains for nested loops.
-- Cycle state (`cycleStates`) now resets per render via `Context.reset()`.
-- Async helpers now work correctly with `asyncRender`.
-- Partial definitions now collected at compile time for proper `renderPartial` support.
-- Path traversal protection added to `extends` tag (previously only on `include`).
-- `floatformat` default behavior now matches Django (1 decimal place).
-- `timesince`/`timeuntil` now handles seconds, minutes, hours, days correctly.
-- `pluralize` now correctly handles singular vs plural forms.
-- `default` filter now treats empty string `''` as falsy like Django.
-- `striptags` now correctly removes HTML tags and handles edge cases.
-- Spaceless tag now preserves whitespace inside tag attributes correctly.
-
-### Changed
-- Rewrote condition evaluation to use shunting-yard algorithm for correct operator precedence.
-- Simplified `for` loop to use `[key, value]` tuples internally for cleaner unpacking.
-- Improved `partialdef` to support both quoted and unquoted partial names.
-- `floatformat` with `-1` argument now removes all decimals.
-
-## [1.0.0] - 2026-08-29
-### Added
-- Full Django‑style template engine with variables, filters, tags, inheritance, partials, and context processors.
-- Security features: auto‑escaping, `markSafe`, `csrf_token` and `csp_nonce_attr` tags.
-- Extensible API: `registerTag`, `registerFilter`, `markSafe`.
-- Express integration via `__express` adapter.
-- Comprehensive test suite (40 passing tests) and benchmark suite.
-- Detailed documentation hierarchy (`docs/`): overview, installation, usage, tags, filters, partialdef, security, API reference, contribution guide.
-- CI workflow using GitHub Actions.
-- Project scaffolding, linting, and contribution guardrails (`AGENT.md`).
-
-### Fixed
-- Auto‑escaping now respects `SafeString` values.
-- Context processors correctly propagate returned context.
-- Fixed tag parsing edge cases in `IfNode` and `PartialDefNode`.
-
-### Changed
-- Updated README with npm version and CI badges.
-- Added `CHANGELOG.md` for release notes.
-
-[1.2.0]: https://github.com/your-repo/miki-template/releases/tag/v1.2.0
-[1.1.0]: https://github.com/your-repo/miki-template/releases/tag/v1.1.0
-[1.0.0]: https://github.com/your-repo/miki-template/releases/tag/v1.0.0

package/CODE_OF_CONDUCT.md

@@ -1,14 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-We pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity, experience level, nationality, personal appearance, race, religion, or sexual orientation.
-
-## Our Standards
-Examples of behavior that contributes to creating a positive environment include:
-- Using welcoming and inclusive language.
-- Being respectful of differing viewpoints and experiences.
-- Gracefully accepting constructive criticism.
-- Focusing on what is best for the community.
-- Showing empathy towards other community members.
-
-Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct.

package/CONTRIBUTING.md

@@ -1,27 +0,0 @@
-# Contributing to Django-Style Template Engine
-
-Thank you for your interest in contributing! Please follow these guidelines:
-
----
-
-## 🛠️ Development Setup
-
-1. **Clone the Repository**
-2. **Install Dependencies**:
-   ```bash
-   npm install
-   ```
-3. **Run the Tests**:
-   ```bash
-   npm test
-   ```
-
----
-
-## 🛑 Guardrails & Standards
-
-Before submitting a PR, make sure your code aligns with the strict requirements outlined in [AGENT.md](file:///c:/Users/Coder%20Miki/Desktop/miki-template/AGENT.md):
-- Ensure full parity with Django syntax behavior.
-- Do not use `eval()` for safety.
-- Write corresponding unit tests in `tests/` for all new features or bug fixes.
-- Verify that auto-escaping remains secure by default.

package/ROADMAP.md

@@ -1,40 +0,0 @@
-# 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/ejs-results.json

@@ -1,17 +0,0 @@
-[
-  {
-    "name": "ejs:small",
-    "medianMs": 0.005599999999994054,
-    "rps": 178571
-  },
-  {
-    "name": "ejs:medium",
-    "medianMs": 0.3426000000000613,
-    "rps": 2919
-  },
-  {
-    "name": "ejs:large",
-    "medianMs": 4.021499999999833,
-    "rps": 249
-  }
-]

package/benchmarks/ejs.js

@@ -1,38 +0,0 @@
-const ejs = require('ejs');
-const { performance } = require('perf_hooks');
-
-const SMALL = `<% items.forEach(item => { %>\n<%= item.toUpperCase() %>:<%= item.length %>\n<% }) %>`;
-const MEDIUM = `<% big_items.forEach(i => { %>\n<% if (i % 2 === 0) { %>Even: <%= i %>\n<% } else { %>Odd: <%= i %>\n<% } }) %>`;
-const LARGE = `<% big_items.forEach(i => { %>\n<% small_items.forEach(j => { %>\n<%= i %>:<%= j %> <%= 'x'.repeat(10) %>\n<% }) }) %>`;
-
-const data = {
-  items: ['alpha', 'beta', 'gamma', 'delta', 'epsilon'],
-  big_items: Array.from({ length: 500 }, (_, i) => i),
-  small_items: Array.from({ length: 5 }, (_, j) => j)
-};
-
-function bench(name, tpl, data, iterations = 5000) {
-  const compiled = ejs.compile(tpl);
-  for (let i = 0; i < 20; i++) compiled(data);
-
-  const times = [];
-  for (let i = 0; i < iterations; i++) {
-    const t0 = performance.now();
-    compiled(data);
-    times.push(performance.now() - t0);
-  }
-  times.sort((a, b) => a - b);
-  const median = times[Math.floor(times.length / 2)];
-  const rps = Math.round(1000 / median);
-  console.log(`${name}: ${median.toFixed(3)} ms/op  (~${rps.toLocaleString()} rps)`);
-  return { name, medianMs: median, rps };
-}
-
-const results = [];
-results.push(bench('ejs:small', SMALL, data, 10000));
-results.push(bench('ejs:medium', MEDIUM, data, 5000));
-results.push(bench('ejs:large', LARGE, data, 1000));
-
-const outPath = require('path').join(__dirname, 'ejs-results.json');
-require('fs').writeFileSync(outPath, JSON.stringify(results, null, 2));
-console.log(`\nResults saved to ${outPath}`);

package/benchmarks/handlebars-results.json

@@ -1,17 +0,0 @@
-[
-  {
-    "name": "handlebars:small",
-    "medianMs": 0.0024000000000086175,
-    "rps": 416667
-  },
-  {
-    "name": "handlebars:medium",
-    "medianMs": 0.16540000000009059,
-    "rps": 6046
-  },
-  {
-    "name": "handlebars:large",
-    "medianMs": 1.5188000000000557,
-    "rps": 658
-  }
-]