miki-template 1.2.0 → 1.3.3

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 (60) hide show
  1. package/.github/release-notes/v1.3.1.md +55 -0
  2. package/CHANGELOG.md +72 -0
  3. package/README.md +43 -26
  4. package/assets/banner.png +0 -0
  5. package/benchmarks/stress.mjs +647 -0
  6. package/dir/base.html +23 -0
  7. package/dir/cmpnt.html +11 -0
  8. package/dir/footer.html +3 -0
  9. package/dir/home.html +80 -0
  10. package/dir/navbar.html +9 -0
  11. package/docs/api.md +20 -3
  12. package/docs/filters.md +301 -133
  13. package/docs/partialdef.md +30 -1
  14. package/docs/tags.md +63 -0
  15. package/docs/usage.md +50 -3
  16. package/eslint.config.mjs +9 -1
  17. package/ex.mjs +33 -0
  18. package/miki-template-extension/.github/workflows/ci.yml +116 -0
  19. package/miki-template-extension/.vscodeignore +7 -0
  20. package/miki-template-extension/CHANGELOG.md +99 -0
  21. package/miki-template-extension/README.md +244 -53
  22. package/miki-template-extension/extension.js +1013 -0
  23. package/miki-template-extension/icon.png +0 -0
  24. package/miki-template-extension/miki-template-1.7.1.vsix +0 -0
  25. package/miki-template-extension/package.json +244 -10
  26. package/miki-template-extension/snippets/miki-template.json +612 -72
  27. package/miki-template-extension/syntaxes/language-configuration.json +101 -13
  28. package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +270 -61
  29. package/miki-template-extension/tests/grammar-tests.json +162 -0
  30. package/miki-template-extension/tests/run-grammar-tests.js +82 -0
  31. package/package.json +7 -4
  32. package/scripts/build-vsix.js +129 -0
  33. package/scripts/build-vsix.ps1 +15 -0
  34. package/src/cache.js +41 -2
  35. package/src/context.js +9 -5
  36. package/src/context_processors.js +9 -2
  37. package/src/esm.mjs +12 -0
  38. package/src/filters.js +472 -24
  39. package/src/index.js +571 -85
  40. package/src/lexer.js +76 -54
  41. package/src/libraries.js +134 -3
  42. package/src/parser.js +22 -2
  43. package/src/security.js +4 -2
  44. package/src/tags/control.js +150 -21
  45. package/src/tags/extra.js +154 -0
  46. package/src/tags/i18n.js +49 -23
  47. package/src/tags/inheritance.js +142 -23
  48. package/src/tags/util.js +102 -24
  49. package/tests/esm.test.mjs +37 -2
  50. package/tests/filters.test.js +155 -0
  51. package/tests/integration/README.md +32 -0
  52. package/tests/integration/features.test.cjs +1681 -0
  53. package/tests/integration/features.test.mjs +1697 -0
  54. package/tests/integration/templates/base.miki +6 -0
  55. package/tests/integration/templates/child.miki +6 -0
  56. package/tests/integration/templates/index.html +17 -0
  57. package/tests/parser.test.js +5 -3
  58. package/tests/partialdef.test.js +40 -1
  59. package/tests/tags.test.js +30 -0
  60. package/miki-template-1.2.0.vsix +0 -0
@@ -1,7 +1,19 @@
1
- // Test ESM import support
2
- import { render, compile, SafeString, markSafe } from '../src/esm.mjs';
1
+ // Test ESM import support using the real-world default import pattern.
2
+ import mikiTemplate from '../src/esm.mjs';
3
3
  import test from 'node:test';
4
4
  import assert from 'node:assert';
5
+ import fs from 'node:fs';
6
+ import path from 'node:path';
7
+ import os from 'node:os';
8
+
9
+ const {
10
+ render,
11
+ compile,
12
+ SafeString,
13
+ markSafe,
14
+ __express,
15
+ __expressAsync
16
+ } = mikiTemplate;
5
17
 
6
18
  test('ESM - default named imports', () => {
7
19
  const result = render('Hello {{ name }}!', { name: 'ESM' });
@@ -24,3 +36,26 @@ test('ESM - markSafe import', () => {
24
36
  const result = render('{{ x }}', { x: safe });
25
37
  assert.strictEqual(result, '<i>Italic</i>');
26
38
  });
39
+
40
+ test('ESM - __express via default import', () => {
41
+ assert.strictEqual(typeof mikiTemplate.__express, 'function');
42
+ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-esm-'));
43
+ const tplPath = path.join(tmpDir, 'hello.html');
44
+ fs.writeFileSync(tplPath, 'Hi {{ name }}!');
45
+ let result;
46
+ mikiTemplate.__express(tplPath, {}, (err, html) => {
47
+ result = html;
48
+ });
49
+ assert.strictEqual(result, 'Hi !');
50
+ fs.rmSync(tmpDir, { recursive: true });
51
+ });
52
+
53
+ test('ESM - __expressAsync via default import', async () => {
54
+ assert.strictEqual(typeof mikiTemplate.__expressAsync, 'function');
55
+ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-esm-'));
56
+ const tplPath = path.join(tmpDir, 'hello.html');
57
+ fs.writeFileSync(tplPath, 'Hi {{ name }}!');
58
+ const result = await mikiTemplate.__expressAsync(tplPath, {});
59
+ assert.strictEqual(result, 'Hi !');
60
+ fs.rmSync(tmpDir, { recursive: true });
61
+ });
@@ -97,3 +97,158 @@ test('Filter chaining on string literal', () => {
97
97
  const result2 = render('{{ " trim me "|cut:" " }}', {});
98
98
  assert.strictEqual(result2, 'trimme');
99
99
  });
100
+
101
+ test('Filters - Math filters', () => {
102
+ const sub = getFilter('sub');
103
+ assert.strictEqual(sub(10, 3), 7);
104
+
105
+ const mult = getFilter('mult');
106
+ assert.strictEqual(mult(4, 5), 20);
107
+
108
+ const square = getFilter('square');
109
+ assert.strictEqual(square(6), 36);
110
+
111
+ const sqrt = getFilter('sqrt');
112
+ assert.strictEqual(sqrt(9), 3);
113
+ assert.strictEqual(sqrt(0), 0);
114
+ assert.strictEqual(sqrt(-1), 0);
115
+
116
+ const mod = getFilter('mod');
117
+ assert.strictEqual(mod(10, 3), 1);
118
+ assert.strictEqual(mod(10, 0), 0);
119
+ });
120
+
121
+ test('Filters - Data formatting filters', () => {
122
+ const currency = getFilter('currency');
123
+ assert.strictEqual(currency(1234.5), '$1,234.50');
124
+ assert.strictEqual(currency(1234.5, '€'), '€1,234.50');
125
+
126
+ const phone_number = getFilter('phone_number');
127
+ assert.strictEqual(phone_number('1234567890'), '(123) 456-7890');
128
+ assert.strictEqual(phone_number('11234567890'), '+1 (123) 456-7890');
129
+
130
+ const email = getFilter('email');
131
+ assert.strictEqual(email('user@example.com'), 'mailto:user@example.com');
132
+
133
+ const url = getFilter('url');
134
+ assert.strictEqual(url('example.com'), 'https://example.com');
135
+ assert.strictEqual(url('https://example.com'), 'https://example.com');
136
+
137
+ const mask = getFilter('mask');
138
+ assert.strictEqual(mask('1234567890'), '******7890');
139
+ assert.strictEqual(mask('1234567890', '#'), '######7890');
140
+
141
+ const whatsapp_link = getFilter('whatsapp_link');
142
+ assert.strictEqual(whatsapp_link('1234567890'), 'https://wa.me/1234567890');
143
+ assert.strictEqual(whatsapp_link('1234567890', 'Hello'), 'https://wa.me/1234567890?text=Hello');
144
+ });
145
+
146
+ test('Filters - Additional Math filters (abs, round, floor, ceil)', () => {
147
+ const abs = getFilter('abs');
148
+ assert.strictEqual(abs(-5), 5);
149
+ assert.strictEqual(abs(5), 5);
150
+ assert.strictEqual(abs(0), 0);
151
+
152
+ const round = getFilter('round');
153
+ assert.strictEqual(round(3.14159, 2), 3.14);
154
+ assert.strictEqual(round(3.5), 4);
155
+ assert.strictEqual(round(3.4), 3);
156
+
157
+ const floor = getFilter('floor');
158
+ assert.strictEqual(floor(3.7), 3);
159
+ assert.strictEqual(floor(-3.7), -4);
160
+
161
+ const ceil = getFilter('ceil');
162
+ assert.strictEqual(ceil(3.2), 4);
163
+ assert.strictEqual(ceil(-3.2), -3);
164
+ });
165
+
166
+ test('Filters - min/max/sum/average', () => {
167
+ const min = getFilter('min');
168
+ assert.strictEqual(min([5, 2, 8, 1]), 1);
169
+ assert.strictEqual(min(5, 2), 2);
170
+
171
+ const max = getFilter('max');
172
+ assert.strictEqual(max([5, 2, 8, 1]), 8);
173
+ assert.strictEqual(max(5, 2), 5);
174
+
175
+ const sum = getFilter('sum');
176
+ assert.strictEqual(sum([1, 2, 3, 4]), 10);
177
+ assert.strictEqual(sum([]), 0);
178
+
179
+ const average = getFilter('average');
180
+ assert.strictEqual(average([1, 2, 3, 4]), 2.5);
181
+ assert.strictEqual(average([]), 0);
182
+ });
183
+
184
+ test('Filters - reverse, sort, unique, random', () => {
185
+ const reverse = getFilter('reverse');
186
+ assert.strictEqual(reverse('hello'), 'olleh');
187
+ assert.deepEqual(reverse([1, 2, 3]), [3, 2, 1]);
188
+
189
+ const sort = getFilter('sort');
190
+ assert.deepEqual(sort([3, 1, 2]), [1, 2, 3]);
191
+
192
+ const unique = getFilter('unique');
193
+ assert.deepEqual(unique([1, 2, 2, 3]), [1, 2, 3]);
194
+
195
+ const random = getFilter('random');
196
+ const arr = [1, 2, 3, 4, 5];
197
+ const r = random(arr);
198
+ assert.ok(arr.includes(r));
199
+ });
200
+
201
+ test('Filters - split, replace', () => {
202
+ const split = getFilter('split');
203
+ assert.deepEqual(split('a,b,c', ','), ['a', 'b', 'c']);
204
+ assert.deepEqual(split('hello world'), ['hello', 'world']);
205
+
206
+ const replace = getFilter('replace');
207
+ assert.strictEqual(replace('hello world', 'world,Earth'), 'hello Earth');
208
+ });
209
+
210
+ test('Filters - base64_encode, base64_decode', () => {
211
+ const encode = getFilter('base64_encode');
212
+ const decode = getFilter('base64_decode');
213
+ assert.strictEqual(encode('hello'), 'aGVsbG8=');
214
+ assert.strictEqual(decode('aGVsbG8='), 'hello');
215
+ assert.strictEqual(decode('not-base64'), 'not-base64');
216
+ });
217
+
218
+ test('Filters - urlize, json, truncatechars_html', () => {
219
+ const urlize = getFilter('urlize');
220
+ assert.ok(urlize('visit https://example.com for more').includes('<a href="https://example.com">https://example.com</a>'));
221
+
222
+ const json = getFilter('json');
223
+ assert.ok(json({a: 1, b: 2}).value.includes('"a":1'));
224
+
225
+ const truncatechars_html = getFilter('truncatechars_html');
226
+ const result = truncatechars_html('<p>Hello world</p>', 10);
227
+ assert.ok(result.value.includes('Hello worl'));
228
+ assert.ok(result.value.includes('...'));
229
+ });
230
+
231
+ test('Filters - time_diff, ago, until', () => {
232
+ const time_diff = getFilter('time_diff');
233
+ assert.ok(time_diff(new Date(Date.now() - 3600000)).includes('hour'));
234
+
235
+ const ago = getFilter('ago');
236
+ assert.ok(ago(new Date(Date.now() - 86400000)).includes('day ago'));
237
+
238
+ const until = getFilter('until');
239
+ assert.ok(until(new Date(Date.now() + 86400000)).includes('day'));
240
+ });
241
+
242
+ test('Filters - credit_card, ssn, ip_address, uuid', () => {
243
+ const credit_card = getFilter('credit_card');
244
+ assert.strictEqual(credit_card('4111111111111111'), '4111-1111-1111-1111');
245
+
246
+ const ssn = getFilter('ssn');
247
+ assert.strictEqual(ssn('123456789'), '123-45-6789');
248
+
249
+ const ip_address = getFilter('ip_address');
250
+ assert.strictEqual(ip_address('192168011001'), '1921.6801.10.01');
251
+
252
+ const uuid = getFilter('uuid');
253
+ 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}$/));
254
+ });
@@ -0,0 +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.