npm - miki-template - Versions diffs - 2.3.1 → 2.3.2 - Mend

miki-template 2.3.1 → 2.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (159) hide show

package/package.json +45 -1
package/.eslintrc.json +0 -16
package/.github/release-notes/v1.3.1.md +0 -55
package/.github/release-notes/v1.3.3.md +0 -77
package/.github/release-notes/v1.3.7.md +0 -20
package/.github/workflows/ci.yml +0 -42
package/.github/workflows/docs.yml +0 -107
package/.github/workflows/release.yml +0 -107
package/AGENT.md +0 -71
package/API_REFERENCE.md +0 -341
package/CHANGELOG.md +0 -173
package/CODE_OF_CONDUCT.md +0 -14
package/CONTRIBUTING.md +0 -27
package/ROADMAP.md +0 -40
package/assets/banner.png +0 -0
package/assets/logo.png +0 -0
package/benchmarks/ejs-results.json +0 -17
package/benchmarks/ejs.js +0 -38
package/benchmarks/handlebars-results.json +0 -17
package/benchmarks/handlebars.js +0 -45
package/benchmarks/miki-results.json +0 -17
package/benchmarks/miki.js +0 -39
package/benchmarks/pug-results.json +0 -17
package/benchmarks/pug.js +0 -38
package/benchmarks/report.json +0 -17
package/benchmarks/run.js +0 -81
package/benchmarks/stress.mjs +0 -647
package/benchmarks/templates/large.dtpl +0 -7
package/benchmarks/templates/medium.dtpl +0 -3
package/benchmarks/templates/small.dtpl +0 -7
package/context/component.md +0 -109
package/context/prd.md +0 -131
package/context/project-structure.md +0 -33
package/dir/base.html +0 -23
package/dir/cmpnt.html +0 -11
package/dir/footer.html +0 -3
package/dir/home.html +0 -80
package/dir/index.html +0 -80
package/dir/navbar.html +0 -9
package/docs/api/async-render.md +0 -170
package/docs/api/cache.md +0 -174
package/docs/api/compile.md +0 -256
package/docs/api/context-processors.md +0 -154
package/docs/api/filters.md +0 -437
package/docs/api/finder.md +0 -188
package/docs/api/helpers.md +0 -106
package/docs/api/i18n.md +0 -314
package/docs/api/index.md +0 -108
package/docs/api/libraries.md +0 -414
package/docs/api/render-partial.md +0 -162
package/docs/api/render.md +0 -184
package/docs/api/security.md +0 -290
package/docs/api/setup-express.md +0 -152
package/docs/api/tags.md +0 -268
package/docs/assets/banner.png +0 -0
package/docs/assets/logo.png +0 -0
package/docs/filter.md +0 -0
package/docs/guide/advanced-usage.md +0 -794
package/docs/guide/async-rendering.md +0 -616
package/docs/guide/context-processors.md +0 -514
package/docs/guide/custom-filters.md +0 -622
package/docs/guide/custom-tags.md +0 -542
package/docs/guide/filters.md +0 -1314
package/docs/guide/getting-started.md +0 -204
package/docs/guide/installation.md +0 -190
package/docs/guide/partial-templates.md +0 -734
package/docs/guide/quick-start.md +0 -444
package/docs/guide/security.md +0 -690
package/docs/guide/tags.md +0 -1566
package/docs/guide/template-discovery.md +0 -340
package/docs/guide/template-inheritance.md +0 -546
package/docs/guide/what-is-miki-template.md +0 -28
package/docs/guide/why-miki-template.md +0 -75
package/docs/index.md +0 -86
package/docs/integrations/elysia.md +0 -80
package/docs/integrations/express.md +0 -219
package/docs/integrations/fastify.md +0 -79
package/docs/integrations/hono.md +0 -80
package/docs/integrations/index.md +0 -68
package/docs/integrations/koa.md +0 -90
package/docs/integrations/nestjs.md +0 -80
package/docs/integrations/tsed.md +0 -83
package/docs/performance.md +0 -74
package/eslint.config.mjs +0 -42
package/ex.mjs +0 -36
package/live-test/integrations/elysia-example.js +0 -16
package/live-test/integrations/express-example.js +0 -24
package/live-test/integrations/fastify-example.js +0 -20
package/live-test/integrations/hono-example.js +0 -16
package/live-test/integrations/koa-example.js +0 -30
package/live-test/integrations/nestjs-example.js +0 -25
package/live-test/integrations/smoke-test.js +0 -166
package/live-test/integrations/tsed-example.js +0 -23
package/live-test/package-lock.json +0 -1150
package/live-test/package.json +0 -13
package/live-test/packages/product/templates/product/detail.html +0 -7
package/live-test/server.js +0 -38
package/live-test/templates/app_templates/detail.html +0 -6
package/live-test/views/base.html +0 -8
package/live-test/views/child.html +0 -7
package/live-test/views/home.html +0 -17
package/live-test/views/index.html +0 -1
package/miki-template-extension/.github/workflows/ci.yml +0 -116
package/miki-template-extension/.vscodeignore +0 -7
package/miki-template-extension/CHANGELOG.md +0 -99
package/miki-template-extension/LICENSE +0 -21
package/miki-template-extension/README.md +0 -273
package/miki-template-extension/extension.js +0 -1013
package/miki-template-extension/icon.png +0 -0
package/miki-template-extension/icon.svg +0 -10
package/miki-template-extension/miki-template-1.7.1.vsix +0 -0
package/miki-template-extension/package.json +0 -280
package/miki-template-extension/snippets/miki-template.json +0 -717
package/miki-template-extension/syntaxes/language-configuration.json +0 -114
package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +0 -355
package/miki-template-extension/tests/grammar-tests.json +0 -162
package/miki-template-extension/tests/run-grammar-tests.js +0 -82
package/mkdocs.yml +0 -195
package/overrides/main.html +0 -26
package/requirements-docs.txt +0 -2
package/sample-app/package-lock.json +0 -901
package/sample-app/package.json +0 -9
package/sample-app/server.js +0 -14
package/sample-app/views/index.html +0 -1
package/scripts/build-vsix.js +0 -129
package/scripts/build-vsix.ps1 +0 -15
package/snippets/miki-template.json +0 -177
package/src/asyncRender.js +0 -21
package/src/types.d.ts +0 -107
package/syntaxes/language-configuration.json +0 -26
package/syntaxes/miki-template.tmLanguage.json +0 -146
package/tests/asyncRender.test.js +0 -17
package/tests/base.html +0 -6
package/tests/child.html +0 -3
package/tests/context_processors.test.js +0 -13
package/tests/esm.test.mjs +0 -61
package/tests/filters.test.js +0 -263
package/tests/finder-appdirs.test.js +0 -19
package/tests/finder.test.js +0 -17
package/tests/fixtures/views/nested/index.html +0 -1
package/tests/fixtures/views/partial.html +0 -1
package/tests/fixtures/views/sub/deepfile.html +0 -1
package/tests/fixtures/views-appdirs/product/site/detail.html +0 -1
package/tests/include_security.test.js +0 -9
package/tests/integration/README.md +0 -32
package/tests/integration/features.test.cjs +0 -1681
package/tests/integration/features.test.mjs +0 -1697
package/tests/integration/finder.esm.test.mjs +0 -13
package/tests/integration/partial-render.test.cjs +0 -13
package/tests/integration/templates/base.miki +0 -6
package/tests/integration/templates/child.miki +0 -6
package/tests/integration/templates/index.html +0 -17
package/tests/lexer.test.js +0 -45
package/tests/parser.test.js +0 -57
package/tests/partial.html +0 -1
package/tests/partialdef.test.js +0 -79
package/tests/production_checks.js +0 -57
package/tests/security.test.js +0 -28
package/tests/tags.test.js +0 -233

package/tests/base.html DELETED Viewed

@@ -1,6 +0,0 @@
-<html>
-<body>
-  {% block header %}Default Header{% endblock %}
-  {% block content %}{% endblock %}
-</body>
-</html>

package/tests/child.html DELETED Viewed

@@ -1,3 +0,0 @@
-{% extends "base.html" %}
-{% block header %}Child Header ({{ block.super }}){% endblock %}
-{% block content %}Child Content{% endblock %}

package/tests/context_processors.test.js DELETED Viewed

@@ -1,13 +0,0 @@
-// Context Processors test using node:test
-const test = require('node:test');
-const assert = require('node:assert');
-const { registerContextProcessor, clearContextProcessors } = require('../src/context_processors');
-const { compile } = require('../src');
-test('Context processor injects variable', () => {
-  clearContextProcessors();
-  registerContextProcessor(() => ({ siteName: 'DemoSite' }));
-  const tmpl = '{{ siteName }}';
-  const rendered = compile(tmpl).render({});
-  assert.strictEqual(rendered, 'DemoSite');
-});

package/tests/esm.test.mjs DELETED Viewed

@@ -1,61 +0,0 @@
-// Test ESM import support using the real-world default import pattern.
-import mikiTemplate from '../src/esm.mjs';
-import test from 'node:test';
-import assert from 'node:assert';
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-const {
-  render,
-  compile,
-  SafeString,
-  markSafe,
-  __express,
-  __expressAsync
-} = mikiTemplate;
-test('ESM - default named imports', () => {
-  const result = render('Hello {{ name }}!', { name: 'ESM' });
-  assert.strictEqual(result, 'Hello ESM!');
-});
-test('ESM - compile import', () => {
-  const compiled = compile('Hi {{ user }}!');
-  assert.strictEqual(compiled.render({ user: 'World' }), 'Hi World!');
-});
-test('ESM - SafeString import', () => {
-  const html = new SafeString('<b>Bold</b>');
-  const result = render('{{ html }}', { html });
-  assert.strictEqual(result, '<b>Bold</b>');
-});
-test('ESM - markSafe import', () => {
-  const safe = markSafe('<i>Italic</i>');
-  const result = render('{{ x }}', { x: safe });
-  assert.strictEqual(result, '<i>Italic</i>');
-});
-test('ESM - __express via default import', () => {
-  assert.strictEqual(typeof mikiTemplate.__express, 'function');
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-esm-'));
-  const tplPath = path.join(tmpDir, 'hello.html');
-  fs.writeFileSync(tplPath, 'Hi {{ name }}!');
-  let result;
-  mikiTemplate.__express(tplPath, {}, (err, html) => {
-    result = html;
-  });
-  assert.strictEqual(result, 'Hi !');
-  fs.rmSync(tmpDir, { recursive: true });
-});
-test('ESM - __expressAsync via default import', async () => {
-  assert.strictEqual(typeof mikiTemplate.__expressAsync, 'function');
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-esm-'));
-  const tplPath = path.join(tmpDir, 'hello.html');
-  fs.writeFileSync(tplPath, 'Hi {{ name }}!');
-  const result = await mikiTemplate.__expressAsync(tplPath, {});
-  assert.strictEqual(result, 'Hi !');
-  fs.rmSync(tmpDir, { recursive: true });
-});

package/tests/filters.test.js DELETED Viewed

@@ -1,263 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-const { getFilter } = require('../src/filters');
-test('Filters - Text filters', () => {
-  const upper = getFilter('upper');
-  assert.strictEqual(upper('hello'), 'HELLO');
-  const capfirst = getFilter('capfirst');
-  assert.strictEqual(capfirst('hello'), 'Hello');
-  const truncatewords = getFilter('truncatewords');
-  assert.strictEqual(truncatewords('one two three four', 2), 'one two ...');
-  const slugify = getFilter('slugify');
-  assert.strictEqual(slugify('Hello World! New-Post'), 'hello-world-new-post');
-});
-test('Filters - HTML / Security filters', () => {
-  const safe = getFilter('safe');
-  const escape = getFilter('escape');
-  assert.strictEqual(String(escape('<script>')), '&lt;script&gt;');
-  // Safe returns SafeString which resolves when cast to string
-  assert.strictEqual(String(safe('<p>')), '<p>');
-});
-test('Filters - List filters', () => {
-  const length = getFilter('length');
-  assert.strictEqual(length([1, 2, 3]), 3);
-  const join = getFilter('join');
-  assert.strictEqual(join(['a', 'b', 'c'], '-'), 'a-b-c');
-  const slice = getFilter('slice');
-  assert.deepEqual(slice([1, 2, 3, 4], '1:3'), [2, 3]);
-});
-test('Filters - Default filters', () => {
-  const def = getFilter('default');
-  assert.strictEqual(def(null, 'fallback'), 'fallback');
-  assert.strictEqual(def('value', 'fallback'), 'value');
-});
-test('Filters - Misc filters', () => {
-  const pluralize = getFilter('pluralize');
-  assert.strictEqual(pluralize(1), '');
-  assert.strictEqual(pluralize(2), 's');
-  assert.strictEqual(pluralize(1, 'y,ies'), 'y');
-  assert.strictEqual(pluralize(2, 'y,ies'), 'ies');
-});
-test('Filters - urlencode and escapeuri', () => {
-  const urlencode = getFilter('urlencode');
-  assert.strictEqual(urlencode('hello world'), 'hello+world');
-  assert.strictEqual(urlencode('a b c'), 'a+b+c');
-  const escapeuri = getFilter('escapeuri');
-  assert.ok(escapeuri('http://example.com/path with spaces').includes('path%20with%20spaces'));
-});
-test('Filters - stringformat', () => {
-  const stringformat = getFilter('stringformat');
-  assert.strictEqual(stringformat('hello', '%s'), 'hello');
-  assert.strictEqual(stringformat(42, '%d'), '42');
-  assert.strictEqual(stringformat(3.14159, '%.2f'), '3.14');
-});
-test('Filters - cut and addslashes', () => {
-  const cut = getFilter('cut');
-  assert.strictEqual(cut('hello hello', ' '), 'hellohello');
-  const addslashes = getFilter('addslashes');
-  assert.strictEqual(addslashes('He said "Hi"'), 'He said \\"Hi\\"');
-});
-test('Filters - length_is', () => {
-  const length_is = getFilter('length_is');
-  assert.strictEqual(length_is([1, 2, 3], 3), true);
-  assert.strictEqual(length_is([1, 2], 3), false);
-});
-test('Filter chaining via template', () => {
-  const { render } = require('../src/index');
-  const result = render('{{ value|lower|capfirst }}', { value: 'Hello World' });
-  assert.strictEqual(result, 'Hello world');
-  const result2 = render('{{ items|length|add:5 }}', { items: [1, 2, 3] });
-  assert.strictEqual(result2, '8');
-});
-test('Filter chaining on string literal', () => {
-  const { render } = require('../src/index');
-  const result = render('{{ "Hello World"|lower|capfirst }}', {});
-  assert.strictEqual(result, 'Hello world');
-  const result2 = render('{{ "  trim me  "|cut:" " }}', {});
-  assert.strictEqual(result2, 'trimme');
-});
-test('Filters - Math filters', () => {
-  const sub = getFilter('sub');
-  assert.strictEqual(sub(10, 3), 7);
-  const mult = getFilter('mult');
-  assert.strictEqual(mult(4, 5), 20);
-  const square = getFilter('square');
-  assert.strictEqual(square(6), 36);
-  const sqrt = getFilter('sqrt');
-  assert.strictEqual(sqrt(9), 3);
-  assert.strictEqual(sqrt(0), 0);
-  assert.strictEqual(sqrt(-1), 0);
-  const mod = getFilter('mod');
-  assert.strictEqual(mod(10, 3), 1);
-  assert.strictEqual(mod(10, 0), 0);
-});
-test('Filters - Data formatting filters', () => {
-  const currency = getFilter('currency');
-  assert.strictEqual(currency(1234.5), '$1,234.50');
-  assert.strictEqual(currency(1234.5, '€'), '€1,234.50');
-  const phone_number = getFilter('phone_number');
-  assert.strictEqual(phone_number('1234567890'), '(123) 456-7890');
-  assert.strictEqual(phone_number('11234567890'), '+1 (123) 456-7890');
-  const email = getFilter('email');
-  assert.strictEqual(email('user@example.com'), 'mailto:user@example.com');
-  const url = getFilter('url');
-  assert.strictEqual(url('example.com'), 'https://example.com');
-  assert.strictEqual(url('https://example.com'), 'https://example.com');
-  const mask = getFilter('mask');
-  assert.strictEqual(mask('1234567890'), '******7890');
-  assert.strictEqual(mask('1234567890', '#'), '######7890');
-  const whatsapp_link = getFilter('whatsapp_link');
-  assert.strictEqual(whatsapp_link('1234567890'), 'https://wa.me/1234567890');
-  assert.strictEqual(whatsapp_link('1234567890', 'Hello'), 'https://wa.me/1234567890?text=Hello');
-});
-test('Filters - Additional Math filters (abs, round, floor, ceil)', () => {
-  const abs = getFilter('abs');
-  assert.strictEqual(abs(-5), 5);
-  assert.strictEqual(abs(5), 5);
-  assert.strictEqual(abs(0), 0);
-  const round = getFilter('round');
-  assert.strictEqual(round(3.14159, 2), 3.14);
-  assert.strictEqual(round(3.5), 4);
-  assert.strictEqual(round(3.4), 3);
-  const floor = getFilter('floor');
-  assert.strictEqual(floor(3.7), 3);
-  assert.strictEqual(floor(-3.7), -4);
-  const ceil = getFilter('ceil');
-  assert.strictEqual(ceil(3.2), 4);
-  assert.strictEqual(ceil(-3.2), -3);
-});
-test('Filters - min/max/sum/average', () => {
-  const min = getFilter('min');
-  assert.strictEqual(min([5, 2, 8, 1]), 1);
-  assert.strictEqual(min(5, 2), 2);
-  const max = getFilter('max');
-  assert.strictEqual(max([5, 2, 8, 1]), 8);
-  assert.strictEqual(max(5, 2), 5);
-  const sum = getFilter('sum');
-  assert.strictEqual(sum([1, 2, 3, 4]), 10);
-  assert.strictEqual(sum([]), 0);
-  const average = getFilter('average');
-  assert.strictEqual(average([1, 2, 3, 4]), 2.5);
-  assert.strictEqual(average([]), 0);
-});
-test('Filters - reverse, sort, unique, random', () => {
-  const reverse = getFilter('reverse');
-  assert.strictEqual(reverse('hello'), 'olleh');
-  assert.deepEqual(reverse([1, 2, 3]), [3, 2, 1]);
-  const sort = getFilter('sort');
-  assert.deepEqual(sort([3, 1, 2]), [1, 2, 3]);
-  const unique = getFilter('unique');
-  assert.deepEqual(unique([1, 2, 2, 3]), [1, 2, 3]);
-  const random = getFilter('random');
-  const arr = [1, 2, 3, 4, 5];
-  const r = random(arr);
-  assert.ok(arr.includes(r));
-});
-test('Filters - split, replace', () => {
-  const split = getFilter('split');
-  assert.deepEqual(split('a,b,c', ','), ['a', 'b', 'c']);
-  assert.deepEqual(split('hello world'), ['hello', 'world']);
-  const replace = getFilter('replace');
-  assert.strictEqual(replace('hello world', 'world,Earth'), 'hello Earth');
-});
-test('Filters - base64_encode, base64_decode', () => {
-  const encode = getFilter('base64_encode');
-  const decode = getFilter('base64_decode');
-  assert.strictEqual(encode('hello'), 'aGVsbG8=');
-  assert.strictEqual(decode('aGVsbG8='), 'hello');
-  assert.strictEqual(decode('not-base64'), 'not-base64');
-});
-test('Filters - urlize, json, truncatechars_html', () => {
-  const urlize = getFilter('urlize');
-  assert.ok(urlize('visit https://example.com for more').includes('<a href="https://example.com">https://example.com</a>'));
-  const json = getFilter('json');
-  assert.ok(json({a: 1, b: 2}).value.includes('"a":1'));
-  const truncatechars_html = getFilter('truncatechars_html');
-  const result = truncatechars_html('<p>Hello world</p>', 10);
-  assert.ok(result.value.includes('Hello worl'));
-  assert.ok(result.value.includes('...'));
-});
-test('Filters - time_diff, ago, until', () => {
-  const time_diff = getFilter('time_diff');
-  assert.ok(time_diff(new Date(Date.now() - 3600000)).includes('hour'));
-  const ago = getFilter('ago');
-  assert.ok(ago(new Date(Date.now() - 86400000)).includes('day ago'));
-  const until = getFilter('until');
-  assert.ok(until(new Date(Date.now() + 86400000)).includes('day'));
-});
-test('Filters - credit_card, ssn, ip_address, uuid', () => {
-  const credit_card = getFilter('credit_card');
-  assert.strictEqual(credit_card('4111111111111111'), '4111-1111-1111-1111');
-  const ssn = getFilter('ssn');
-  assert.strictEqual(ssn('123456789'), '123-45-6789');
-  const ip_address = getFilter('ip_address');
-  assert.strictEqual(ip_address('192168011001'), '1921.6801.10.01');
-  const uuid = getFilter('uuid');
-  assert.ok(uuid().match(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/));
-  test('Filters - repeat and range', () => {
-    const repeat = getFilter('repeat');
-    assert.strictEqual(repeat('a', 3), 'aaa');
-    assert.strictEqual(repeat('', 5), '');
-    const range = getFilter('range');
-    assert.deepEqual(range('5'), [0,1,2,3,4]);
-    assert.deepEqual(range('5', '2'), [2,3,4]);
-  });
-});

package/tests/finder-appdirs.test.js DELETED Viewed

@@ -1,19 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-const path = require('path');
-const fs = require('fs');
-const { findTemplateInViews, setAppTemplateDirNames } = require('../src/index.js');
-test('Finder honors custom app template dir names', () => {
-  const fixtures = path.join(__dirname, 'fixtures', 'views-appdirs');
-  // Create a small fixture structure
-  if (!fs.existsSync(path.join(fixtures, 'product', 'site'))){
-    fs.mkdirSync(path.join(fixtures, 'product', 'site'), { recursive: true });
-  }
-  const fname = path.join(fixtures, 'product', 'site', 'detail.html');
-  fs.writeFileSync(fname, '<p>detail</p>');
-  setAppTemplateDirNames(['site']);
-  const found = findTemplateInViews('detail', [fixtures]);
-  assert.ok(found && fs.existsSync(found));
-});

package/tests/finder.test.js DELETED Viewed

@@ -1,17 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-const path = require('path');
-const fs = require('fs');
-const { findTemplateInViews } = require('../src/index.js');
-test('Template finder - nested subfolder', () => {
-  const views = [path.join(__dirname, 'fixtures', 'views')];
-  const found = findTemplateInViews('nested/index', views);
-  assert.ok(found && fs.existsSync(found));
-});
-test('Template finder - bare name searches subfolders', () => {
-  const views = [path.join(__dirname, 'fixtures', 'views')];
-  const found = findTemplateInViews('deepfile', views);
-  assert.ok(found && fs.existsSync(found));
-});

package/tests/fixtures/views/nested/index.html DELETED Viewed

	@@ -1 +0,0 @@
1	- <h1>Nested Index</h1>

package/tests/fixtures/views/partial.html DELETED Viewed

	@@ -1 +0,0 @@
1	- <p>Included: {{ item }}</p>

package/tests/fixtures/views/sub/deepfile.html DELETED Viewed

	@@ -1 +0,0 @@
1	- <div>Deep file</div>

package/tests/fixtures/views-appdirs/product/site/detail.html DELETED Viewed

	@@ -1 +0,0 @@
1	- <p>detail</p>

package/tests/include_security.test.js DELETED Viewed

@@ -1,9 +0,0 @@
-const test = require('node:test');
-const assert = require('node:assert');
-const { render } = require('../src/index');
-test('Security - include path traversal prevented', () => {
-  const tpl = `{% include "../secret.html" %}`;
-  // Expect an error indicating path traversal
-  assert.throws(() => render(tpl, {}, { views: '.' }), /path traversal/);
-});

package/tests/integration/README.md DELETED Viewed

@@ -1,32 +0,0 @@
-# Express Integration Test (CommonJS + ESM)
-This is a **real**, end-to-end integration test for `miki-template` with Express. It:
-- Spins up **actual Express HTTP servers** (one CJS, one ESM).
-- Uses `app.engine('html', renderDtpl)` AND `app.engine('miki', renderDtpl)`.
-- Verifies both file extensions render correctly via real `res.render()`.
-- Performs real HTTP `fetch` requests against the listening servers and asserts the rendered HTML.
-- Verifies ESM `import` syntax (named + default) and CommonJS `require` syntax both work.
-## What it proves to users
-```js
-// CommonJS
-const express = require('express');
-const { __express: renderDtpl } = require('miki-template');
-const app = express();
-app.engine('html', renderDtpl);
-app.engine('miki', renderDtpl);
-```
-```js
-// ESM
-import express from 'express';
-import { __express as renderDtpl } from 'miki-template';
-import mikiTemplate from 'miki-template'; // default import also works
-const app = express();
-app.engine('html', renderDtpl);
-app.engine('miki', renderDtpl);
-```
-Both forms register the engine for `.html` and `.miki` extensions, just as the README documents.