miki-template 1.3.3 → 1.3.7
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.
- package/.eslintrc.json +16 -0
- package/.github/release-notes/v1.3.1.md +55 -55
- package/.github/release-notes/v1.3.3.md +77 -0
- package/.github/workflows/ci.yml +38 -54
- package/.github/workflows/release.yml +106 -0
- package/AGENT.md +71 -71
- package/API_REFERENCE.md +314 -314
- package/CHANGELOG.md +173 -169
- package/CODE_OF_CONDUCT.md +14 -14
- package/CONTRIBUTING.md +27 -27
- package/README.md +342 -321
- package/ROADMAP.md +40 -40
- package/benchmarks/report.json +16 -16
- package/benchmarks/run.js +49 -49
- package/benchmarks/stress.mjs +647 -647
- package/benchmarks/templates/large.dtpl +7 -7
- package/benchmarks/templates/medium.dtpl +3 -3
- package/benchmarks/templates/small.dtpl +7 -7
- package/context/component.md +109 -109
- package/context/prd.md +131 -131
- package/context/project-structure.md +33 -33
- package/dir/base.html +22 -22
- package/dir/cmpnt.html +10 -10
- package/dir/footer.html +2 -2
- package/dir/home.html +80 -80
- package/dir/index.html +80 -0
- package/dir/navbar.html +8 -8
- package/docs/README.md +18 -18
- package/docs/advanced_usage.md +71 -71
- package/docs/api.md +119 -119
- package/docs/filters.md +708 -708
- package/docs/installation.md +106 -106
- package/docs/overview.md +79 -57
- package/docs/partialdef.md +70 -70
- package/docs/security.md +27 -27
- package/docs/tags.md +673 -673
- package/docs/usage.md +646 -646
- package/eslint.config.mjs +42 -42
- package/ex.mjs +34 -32
- package/live-test/package-lock.json +915 -0
- package/live-test/package.json +9 -0
- package/live-test/server.js +14 -0
- package/live-test/views/base.html +8 -0
- package/live-test/views/child.html +7 -0
- package/live-test/views/index.html +1 -0
- package/miki-template-extension/.github/workflows/ci.yml +116 -116
- package/miki-template-extension/.vscodeignore +7 -7
- package/miki-template-extension/CHANGELOG.md +99 -99
- package/miki-template-extension/LICENSE +21 -21
- package/miki-template-extension/README.md +273 -273
- package/miki-template-extension/extension.js +1013 -1013
- package/miki-template-extension/icon.svg +10 -10
- package/miki-template-extension/package.json +280 -280
- package/miki-template-extension/snippets/miki-template.json +717 -717
- package/miki-template-extension/syntaxes/language-configuration.json +114 -114
- package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +355 -355
- package/miki-template-extension/tests/grammar-tests.json +162 -162
- package/miki-template-extension/tests/run-grammar-tests.js +82 -82
- package/package.json +40 -34
- package/sample-app/package-lock.json +901 -0
- package/sample-app/package.json +9 -0
- package/sample-app/server.js +14 -0
- package/sample-app/views/index.html +1 -0
- package/scripts/build-vsix.js +129 -129
- package/scripts/build-vsix.ps1 +15 -15
- package/snippets/miki-template.json +177 -177
- package/src/asyncRender.js +20 -20
- package/src/cache.js +80 -80
- package/src/context.js +126 -126
- package/src/context_processors.js +48 -48
- package/src/esm.mjs +89 -84
- package/src/filters.js +975 -975
- package/src/i18n.js +171 -171
- package/src/index.js +1112 -940
- package/src/lexer.js +114 -114
- package/src/libraries.js +371 -371
- package/src/parser.js +270 -270
- package/src/security.js +53 -53
- package/src/tags/control.js +719 -719
- package/src/tags/extra.js +154 -154
- package/src/tags/helpers.js +26 -26
- package/src/tags/i18n.js +256 -256
- package/src/tags/inheritance.js +335 -335
- package/src/tags/registry.js +18 -18
- package/src/tags/util.js +400 -400
- package/src/types.d.ts +107 -107
- package/syntaxes/language-configuration.json +26 -26
- package/syntaxes/miki-template.tmLanguage.json +146 -146
- package/tests/asyncRender.test.js +17 -17
- package/tests/base.html +6 -6
- package/tests/child.html +3 -3
- package/tests/context_processors.test.js +13 -13
- package/tests/esm.test.mjs +61 -61
- package/tests/filters.test.js +254 -254
- package/tests/finder-appdirs.test.js +19 -0
- package/tests/finder.test.js +17 -0
- package/tests/fixtures/views/nested/index.html +1 -0
- package/tests/fixtures/views/partial.html +1 -0
- package/tests/fixtures/views/sub/deepfile.html +1 -0
- package/tests/fixtures/views-appdirs/product/site/detail.html +1 -0
- package/tests/include_security.test.js +9 -9
- package/tests/integration/README.md +32 -32
- package/tests/integration/features.test.cjs +1681 -1681
- package/tests/integration/features.test.mjs +1697 -1697
- package/tests/integration/finder.esm.test.mjs +13 -0
- package/tests/integration/templates/base.miki +6 -6
- package/tests/integration/templates/child.miki +6 -6
- package/tests/integration/templates/index.html +17 -17
- package/tests/lexer.test.js +45 -45
- package/tests/parser.test.js +57 -57
- package/tests/partial.html +1 -1
- package/tests/partialdef.test.js +79 -79
- package/tests/production_checks.js +57 -57
- package/tests/security.test.js +28 -28
- package/tests/tags.test.js +233 -233
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
const test = require('node:test');
|
|
2
|
+
const assert = require('node:assert');
|
|
3
|
+
const path = require('path');
|
|
4
|
+
const fs = require('fs');
|
|
5
|
+
const { findTemplateInViews } = require('../src/index.js');
|
|
6
|
+
|
|
7
|
+
test('Template finder - nested subfolder', () => {
|
|
8
|
+
const views = [path.join(__dirname, 'fixtures', 'views')];
|
|
9
|
+
const found = findTemplateInViews('nested/index', views);
|
|
10
|
+
assert.ok(found && fs.existsSync(found));
|
|
11
|
+
});
|
|
12
|
+
|
|
13
|
+
test('Template finder - bare name searches subfolders', () => {
|
|
14
|
+
const views = [path.join(__dirname, 'fixtures', 'views')];
|
|
15
|
+
const found = findTemplateInViews('deepfile', views);
|
|
16
|
+
assert.ok(found && fs.existsSync(found));
|
|
17
|
+
});
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<h1>Nested Index</h1>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<p>Included: {{ item }}</p>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<div>Deep file</div>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<p>detail</p>
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
const test = require('node:test');
|
|
2
|
-
const assert = require('node:assert');
|
|
3
|
-
const { render } = require('../src/index');
|
|
4
|
-
|
|
5
|
-
test('Security - include path traversal prevented', () => {
|
|
6
|
-
const tpl = `{% include "../secret.html" %}`;
|
|
7
|
-
// Expect an error indicating path traversal
|
|
8
|
-
assert.throws(() => render(tpl, {}, { views: '.' }), /path traversal/);
|
|
9
|
-
});
|
|
1
|
+
const test = require('node:test');
|
|
2
|
+
const assert = require('node:assert');
|
|
3
|
+
const { render } = require('../src/index');
|
|
4
|
+
|
|
5
|
+
test('Security - include path traversal prevented', () => {
|
|
6
|
+
const tpl = `{% include "../secret.html" %}`;
|
|
7
|
+
// Expect an error indicating path traversal
|
|
8
|
+
assert.throws(() => render(tpl, {}, { views: '.' }), /path traversal/);
|
|
9
|
+
});
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
# Express Integration Test (CommonJS + ESM)
|
|
2
|
-
|
|
3
|
-
This is a **real**, end-to-end integration test for `miki-template` with Express. It:
|
|
4
|
-
|
|
5
|
-
- Spins up **actual Express HTTP servers** (one CJS, one ESM).
|
|
6
|
-
- Uses `app.engine('html', renderDtpl)` AND `app.engine('miki', renderDtpl)`.
|
|
7
|
-
- Verifies both file extensions render correctly via real `res.render()`.
|
|
8
|
-
- Performs real HTTP `fetch` requests against the listening servers and asserts the rendered HTML.
|
|
9
|
-
- Verifies ESM `import` syntax (named + default) and CommonJS `require` syntax both work.
|
|
10
|
-
|
|
11
|
-
## What it proves to users
|
|
12
|
-
|
|
13
|
-
```js
|
|
14
|
-
// CommonJS
|
|
15
|
-
const express = require('express');
|
|
16
|
-
const { __express: renderDtpl } = require('miki-template');
|
|
17
|
-
const app = express();
|
|
18
|
-
app.engine('html', renderDtpl);
|
|
19
|
-
app.engine('miki', renderDtpl);
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
```js
|
|
23
|
-
// ESM
|
|
24
|
-
import express from 'express';
|
|
25
|
-
import { __express as renderDtpl } from 'miki-template';
|
|
26
|
-
import mikiTemplate from 'miki-template'; // default import also works
|
|
27
|
-
const app = express();
|
|
28
|
-
app.engine('html', renderDtpl);
|
|
29
|
-
app.engine('miki', renderDtpl);
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
Both forms register the engine for `.html` and `.miki` extensions, just as the README documents.
|
|
1
|
+
# Express Integration Test (CommonJS + ESM)
|
|
2
|
+
|
|
3
|
+
This is a **real**, end-to-end integration test for `miki-template` with Express. It:
|
|
4
|
+
|
|
5
|
+
- Spins up **actual Express HTTP servers** (one CJS, one ESM).
|
|
6
|
+
- Uses `app.engine('html', renderDtpl)` AND `app.engine('miki', renderDtpl)`.
|
|
7
|
+
- Verifies both file extensions render correctly via real `res.render()`.
|
|
8
|
+
- Performs real HTTP `fetch` requests against the listening servers and asserts the rendered HTML.
|
|
9
|
+
- Verifies ESM `import` syntax (named + default) and CommonJS `require` syntax both work.
|
|
10
|
+
|
|
11
|
+
## What it proves to users
|
|
12
|
+
|
|
13
|
+
```js
|
|
14
|
+
// CommonJS
|
|
15
|
+
const express = require('express');
|
|
16
|
+
const { __express: renderDtpl } = require('miki-template');
|
|
17
|
+
const app = express();
|
|
18
|
+
app.engine('html', renderDtpl);
|
|
19
|
+
app.engine('miki', renderDtpl);
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
```js
|
|
23
|
+
// ESM
|
|
24
|
+
import express from 'express';
|
|
25
|
+
import { __express as renderDtpl } from 'miki-template';
|
|
26
|
+
import mikiTemplate from 'miki-template'; // default import also works
|
|
27
|
+
const app = express();
|
|
28
|
+
app.engine('html', renderDtpl);
|
|
29
|
+
app.engine('miki', renderDtpl);
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Both forms register the engine for `.html` and `.miki` extensions, just as the README documents.
|