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.
Files changed (115) hide show
  1. package/.eslintrc.json +16 -0
  2. package/.github/release-notes/v1.3.1.md +55 -55
  3. package/.github/release-notes/v1.3.3.md +77 -0
  4. package/.github/workflows/ci.yml +38 -54
  5. package/.github/workflows/release.yml +106 -0
  6. package/AGENT.md +71 -71
  7. package/API_REFERENCE.md +314 -314
  8. package/CHANGELOG.md +173 -169
  9. package/CODE_OF_CONDUCT.md +14 -14
  10. package/CONTRIBUTING.md +27 -27
  11. package/README.md +342 -321
  12. package/ROADMAP.md +40 -40
  13. package/benchmarks/report.json +16 -16
  14. package/benchmarks/run.js +49 -49
  15. package/benchmarks/stress.mjs +647 -647
  16. package/benchmarks/templates/large.dtpl +7 -7
  17. package/benchmarks/templates/medium.dtpl +3 -3
  18. package/benchmarks/templates/small.dtpl +7 -7
  19. package/context/component.md +109 -109
  20. package/context/prd.md +131 -131
  21. package/context/project-structure.md +33 -33
  22. package/dir/base.html +22 -22
  23. package/dir/cmpnt.html +10 -10
  24. package/dir/footer.html +2 -2
  25. package/dir/home.html +80 -80
  26. package/dir/index.html +80 -0
  27. package/dir/navbar.html +8 -8
  28. package/docs/README.md +18 -18
  29. package/docs/advanced_usage.md +71 -71
  30. package/docs/api.md +119 -119
  31. package/docs/filters.md +708 -708
  32. package/docs/installation.md +106 -106
  33. package/docs/overview.md +79 -57
  34. package/docs/partialdef.md +70 -70
  35. package/docs/security.md +27 -27
  36. package/docs/tags.md +673 -673
  37. package/docs/usage.md +646 -646
  38. package/eslint.config.mjs +42 -42
  39. package/ex.mjs +34 -32
  40. package/live-test/package-lock.json +915 -0
  41. package/live-test/package.json +9 -0
  42. package/live-test/server.js +14 -0
  43. package/live-test/views/base.html +8 -0
  44. package/live-test/views/child.html +7 -0
  45. package/live-test/views/index.html +1 -0
  46. package/miki-template-extension/.github/workflows/ci.yml +116 -116
  47. package/miki-template-extension/.vscodeignore +7 -7
  48. package/miki-template-extension/CHANGELOG.md +99 -99
  49. package/miki-template-extension/LICENSE +21 -21
  50. package/miki-template-extension/README.md +273 -273
  51. package/miki-template-extension/extension.js +1013 -1013
  52. package/miki-template-extension/icon.svg +10 -10
  53. package/miki-template-extension/package.json +280 -280
  54. package/miki-template-extension/snippets/miki-template.json +717 -717
  55. package/miki-template-extension/syntaxes/language-configuration.json +114 -114
  56. package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +355 -355
  57. package/miki-template-extension/tests/grammar-tests.json +162 -162
  58. package/miki-template-extension/tests/run-grammar-tests.js +82 -82
  59. package/package.json +40 -34
  60. package/sample-app/package-lock.json +901 -0
  61. package/sample-app/package.json +9 -0
  62. package/sample-app/server.js +14 -0
  63. package/sample-app/views/index.html +1 -0
  64. package/scripts/build-vsix.js +129 -129
  65. package/scripts/build-vsix.ps1 +15 -15
  66. package/snippets/miki-template.json +177 -177
  67. package/src/asyncRender.js +20 -20
  68. package/src/cache.js +80 -80
  69. package/src/context.js +126 -126
  70. package/src/context_processors.js +48 -48
  71. package/src/esm.mjs +89 -84
  72. package/src/filters.js +975 -975
  73. package/src/i18n.js +171 -171
  74. package/src/index.js +1112 -940
  75. package/src/lexer.js +114 -114
  76. package/src/libraries.js +371 -371
  77. package/src/parser.js +270 -270
  78. package/src/security.js +53 -53
  79. package/src/tags/control.js +719 -719
  80. package/src/tags/extra.js +154 -154
  81. package/src/tags/helpers.js +26 -26
  82. package/src/tags/i18n.js +256 -256
  83. package/src/tags/inheritance.js +335 -335
  84. package/src/tags/registry.js +18 -18
  85. package/src/tags/util.js +400 -400
  86. package/src/types.d.ts +107 -107
  87. package/syntaxes/language-configuration.json +26 -26
  88. package/syntaxes/miki-template.tmLanguage.json +146 -146
  89. package/tests/asyncRender.test.js +17 -17
  90. package/tests/base.html +6 -6
  91. package/tests/child.html +3 -3
  92. package/tests/context_processors.test.js +13 -13
  93. package/tests/esm.test.mjs +61 -61
  94. package/tests/filters.test.js +254 -254
  95. package/tests/finder-appdirs.test.js +19 -0
  96. package/tests/finder.test.js +17 -0
  97. package/tests/fixtures/views/nested/index.html +1 -0
  98. package/tests/fixtures/views/partial.html +1 -0
  99. package/tests/fixtures/views/sub/deepfile.html +1 -0
  100. package/tests/fixtures/views-appdirs/product/site/detail.html +1 -0
  101. package/tests/include_security.test.js +9 -9
  102. package/tests/integration/README.md +32 -32
  103. package/tests/integration/features.test.cjs +1681 -1681
  104. package/tests/integration/features.test.mjs +1697 -1697
  105. package/tests/integration/finder.esm.test.mjs +13 -0
  106. package/tests/integration/templates/base.miki +6 -6
  107. package/tests/integration/templates/child.miki +6 -6
  108. package/tests/integration/templates/index.html +17 -17
  109. package/tests/lexer.test.js +45 -45
  110. package/tests/parser.test.js +57 -57
  111. package/tests/partial.html +1 -1
  112. package/tests/partialdef.test.js +79 -79
  113. package/tests/production_checks.js +57 -57
  114. package/tests/security.test.js +28 -28
  115. package/tests/tags.test.js +233 -233
@@ -0,0 +1,13 @@
1
+ import assert from 'node:assert';
2
+ import path from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import test from 'node:test';
5
+ import { findTemplateInViews } from '../../src/esm.mjs';
6
+
7
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
8
+
9
+ test('ESM Template finder - nested index', () => {
10
+ const views = [path.join(__dirname, '..', 'fixtures', 'views')];
11
+ const found = findTemplateInViews('nested/index', views);
12
+ assert.ok(found && typeof found === 'string');
13
+ });
@@ -1,6 +1,6 @@
1
- <!DOCTYPE html>
2
- <html>
3
- <body>
4
- {% block content %}Default content from base{% endblock %}
5
- </body>
6
- </html>
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <body>
4
+ {% block content %}Default content from base{% endblock %}
5
+ </body>
6
+ </html>
@@ -1,6 +1,6 @@
1
- {% extends "base.miki" %}
2
- {% block content %}
3
- <h1>{{ heading }}</h1>
4
- <p>Welcome, {{ user.name }}!</p>
5
- {{ block.super }}
6
- {% endblock %}
1
+ {% extends "base.miki" %}
2
+ {% block content %}
3
+ <h1>{{ heading }}</h1>
4
+ <p>Welcome, {{ user.name }}!</p>
5
+ {{ block.super }}
6
+ {% endblock %}
@@ -1,17 +1,17 @@
1
- <!DOCTYPE html>
2
- <html>
3
- <head>
4
- <title>{{ title }}</title>
5
- </head>
6
- <body>
7
- <h1>{{ heading }}</h1>
8
- <ul>
9
- {% for item in items %}
10
- <li>{{ forloop.counter }}: {{ item|upper }}</li>
11
- {% empty %}
12
- <li>No items</li>
13
- {% endfor %}
14
- </ul>
15
- <p>User: {{ user.name|title }}</p>
16
- </body>
17
- </html>
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <title>{{ title }}</title>
5
+ </head>
6
+ <body>
7
+ <h1>{{ heading }}</h1>
8
+ <ul>
9
+ {% for item in items %}
10
+ <li>{{ forloop.counter }}: {{ item|upper }}</li>
11
+ {% empty %}
12
+ <li>No items</li>
13
+ {% endfor %}
14
+ </ul>
15
+ <p>User: {{ user.name|title }}</p>
16
+ </body>
17
+ </html>
@@ -1,45 +1,45 @@
1
- const test = require('node:test');
2
- const assert = require('node:assert');
3
- const { tokenize } = require('../src/lexer');
4
-
5
- test('Lexer - plain text tokenizing', () => {
6
- const tokens = tokenize('Hello World');
7
- assert.strictEqual(tokens.length, 1);
8
- assert.strictEqual(tokens[0].type, 'text');
9
- assert.strictEqual(tokens[0].content, 'Hello World');
10
- });
11
-
12
- test('Lexer - variable tokenizing', () => {
13
- const tokens = tokenize('Hello {{ name }}!');
14
- assert.strictEqual(tokens.length, 3);
15
- assert.strictEqual(tokens[0].content, 'Hello ');
16
- assert.strictEqual(tokens[1].type, 'var');
17
- assert.strictEqual(tokens[1].content, 'name');
18
- assert.strictEqual(tokens[2].content, '!');
19
- });
20
-
21
- test('Lexer - block tag tokenizing', () => {
22
- const tokens = tokenize('{% if active %}Yes{% endif %}');
23
- assert.strictEqual(tokens.length, 3);
24
- assert.strictEqual(tokens[0].type, 'block');
25
- assert.strictEqual(tokens[0].content, 'if active');
26
- assert.strictEqual(tokens[1].content, 'Yes');
27
- assert.strictEqual(tokens[2].type, 'block');
28
- assert.strictEqual(tokens[2].content, 'endif');
29
- });
30
-
31
- test('Lexer - inline comment exclusion', () => {
32
- const tokens = tokenize('Before {# comment #} After');
33
- assert.strictEqual(tokens.length, 2);
34
- assert.strictEqual(tokens[0].content, 'Before ');
35
- assert.strictEqual(tokens[1].content, ' After');
36
- });
37
-
38
- test('Lexer - verbatim tag handling', () => {
39
- const tokens = tokenize('Text {% verbatim %} {{ unparsed }} {% endverbatim %} End');
40
- assert.strictEqual(tokens.length, 3);
41
- assert.strictEqual(tokens[0].content, 'Text ');
42
- assert.strictEqual(tokens[1].type, 'text');
43
- assert.strictEqual(tokens[1].content, ' {{ unparsed }} ');
44
- assert.strictEqual(tokens[2].content, ' End');
45
- });
1
+ const test = require('node:test');
2
+ const assert = require('node:assert');
3
+ const { tokenize } = require('../src/lexer');
4
+
5
+ test('Lexer - plain text tokenizing', () => {
6
+ const tokens = tokenize('Hello World');
7
+ assert.strictEqual(tokens.length, 1);
8
+ assert.strictEqual(tokens[0].type, 'text');
9
+ assert.strictEqual(tokens[0].content, 'Hello World');
10
+ });
11
+
12
+ test('Lexer - variable tokenizing', () => {
13
+ const tokens = tokenize('Hello {{ name }}!');
14
+ assert.strictEqual(tokens.length, 3);
15
+ assert.strictEqual(tokens[0].content, 'Hello ');
16
+ assert.strictEqual(tokens[1].type, 'var');
17
+ assert.strictEqual(tokens[1].content, 'name');
18
+ assert.strictEqual(tokens[2].content, '!');
19
+ });
20
+
21
+ test('Lexer - block tag tokenizing', () => {
22
+ const tokens = tokenize('{% if active %}Yes{% endif %}');
23
+ assert.strictEqual(tokens.length, 3);
24
+ assert.strictEqual(tokens[0].type, 'block');
25
+ assert.strictEqual(tokens[0].content, 'if active');
26
+ assert.strictEqual(tokens[1].content, 'Yes');
27
+ assert.strictEqual(tokens[2].type, 'block');
28
+ assert.strictEqual(tokens[2].content, 'endif');
29
+ });
30
+
31
+ test('Lexer - inline comment exclusion', () => {
32
+ const tokens = tokenize('Before {# comment #} After');
33
+ assert.strictEqual(tokens.length, 2);
34
+ assert.strictEqual(tokens[0].content, 'Before ');
35
+ assert.strictEqual(tokens[1].content, ' After');
36
+ });
37
+
38
+ test('Lexer - verbatim tag handling', () => {
39
+ const tokens = tokenize('Text {% verbatim %} {{ unparsed }} {% endverbatim %} End');
40
+ assert.strictEqual(tokens.length, 3);
41
+ assert.strictEqual(tokens[0].content, 'Text ');
42
+ assert.strictEqual(tokens[1].type, 'text');
43
+ assert.strictEqual(tokens[1].content, ' {{ unparsed }} ');
44
+ assert.strictEqual(tokens[2].content, ' End');
45
+ });
@@ -1,57 +1,57 @@
1
- const test = require('node:test');
2
- const assert = require('node:assert');
3
- const { parseVariableExpression } = require('../src/parser');
4
- const { Context } = require('../src/context');
5
-
6
- test('Parser - variable expression parsing', () => {
7
- const res = parseVariableExpression('user.name|lower|default:"Guest"');
8
- assert.strictEqual(res.varPath, 'user.name');
9
- assert.strictEqual(res.filters.length, 2);
10
-
11
- assert.strictEqual(res.filters[0].name, 'lower');
12
- assert.strictEqual(res.filters[0].arg, null);
13
-
14
- assert.strictEqual(res.filters[1].name, 'default');
15
- assert.strictEqual(res.filters[1].arg.type, 'literal');
16
- assert.strictEqual(res.filters[1].arg.value, 'Guest');
17
- });
18
-
19
- test('Context - basic dotted lookups', () => {
20
- const ctx = new Context({
21
- user: {
22
- profile: {
23
- name: 'Miki',
24
- age: 30
25
- }
26
- },
27
- items: ['apple', 'banana']
28
- });
29
-
30
- assert.strictEqual(ctx.get('user.profile.name'), 'Miki');
31
- assert.strictEqual(ctx.get('user.profile.age'), 30);
32
- assert.strictEqual(ctx.get('items.1'), 'banana');
33
- // Missing key now returns undefined (so filters like default_if_none
34
- // can detect missing values) instead of empty string.
35
- assert.strictEqual(ctx.get('user.profile.missing'), undefined);
36
- });
37
-
38
- test('Context - scope pushing and popping', () => {
39
- const ctx = new Context({ name: 'Global' });
40
- ctx.push({ name: 'Local', age: 25 });
41
-
42
- assert.strictEqual(ctx.get('name'), 'Local');
43
- assert.strictEqual(ctx.get('age'), 25);
44
-
45
- ctx.pop();
46
- assert.strictEqual(ctx.get('name'), 'Global');
47
- assert.strictEqual(ctx.get('age'), undefined);
48
- });
49
-
50
- test('Context - automatic function calling', () => {
51
- const ctx = new Context({
52
- user: {
53
- getName: () => 'Dynamic Name'
54
- }
55
- });
56
- assert.strictEqual(ctx.get('user.getName'), 'Dynamic Name');
57
- });
1
+ const test = require('node:test');
2
+ const assert = require('node:assert');
3
+ const { parseVariableExpression } = require('../src/parser');
4
+ const { Context } = require('../src/context');
5
+
6
+ test('Parser - variable expression parsing', () => {
7
+ const res = parseVariableExpression('user.name|lower|default:"Guest"');
8
+ assert.strictEqual(res.varPath, 'user.name');
9
+ assert.strictEqual(res.filters.length, 2);
10
+
11
+ assert.strictEqual(res.filters[0].name, 'lower');
12
+ assert.strictEqual(res.filters[0].arg, null);
13
+
14
+ assert.strictEqual(res.filters[1].name, 'default');
15
+ assert.strictEqual(res.filters[1].arg.type, 'literal');
16
+ assert.strictEqual(res.filters[1].arg.value, 'Guest');
17
+ });
18
+
19
+ test('Context - basic dotted lookups', () => {
20
+ const ctx = new Context({
21
+ user: {
22
+ profile: {
23
+ name: 'Miki',
24
+ age: 30
25
+ }
26
+ },
27
+ items: ['apple', 'banana']
28
+ });
29
+
30
+ assert.strictEqual(ctx.get('user.profile.name'), 'Miki');
31
+ assert.strictEqual(ctx.get('user.profile.age'), 30);
32
+ assert.strictEqual(ctx.get('items.1'), 'banana');
33
+ // Missing key now returns undefined (so filters like default_if_none
34
+ // can detect missing values) instead of empty string.
35
+ assert.strictEqual(ctx.get('user.profile.missing'), undefined);
36
+ });
37
+
38
+ test('Context - scope pushing and popping', () => {
39
+ const ctx = new Context({ name: 'Global' });
40
+ ctx.push({ name: 'Local', age: 25 });
41
+
42
+ assert.strictEqual(ctx.get('name'), 'Local');
43
+ assert.strictEqual(ctx.get('age'), 25);
44
+
45
+ ctx.pop();
46
+ assert.strictEqual(ctx.get('name'), 'Global');
47
+ assert.strictEqual(ctx.get('age'), undefined);
48
+ });
49
+
50
+ test('Context - automatic function calling', () => {
51
+ const ctx = new Context({
52
+ user: {
53
+ getName: () => 'Dynamic Name'
54
+ }
55
+ });
56
+ assert.strictEqual(ctx.get('user.getName'), 'Dynamic Name');
57
+ });
@@ -1 +1 @@
1
- <p>Included: {{ item }}</p>
1
+ <p>Included: {{ item }}</p>
@@ -1,79 +1,79 @@
1
- // tests for partialdef support, including conditionals, loops, and inline rendering
2
- const test = require('node:test');
3
- const assert = require('node:assert');
4
- const path = require('path');
5
- const fs = require('fs');
6
- const os = require('os');
7
- const { render, compile, renderPartialFromSource } = require('../src/index');
8
-
9
- // Basic partialdef rendering via {% partial %}
10
- test('Partialdef basic rendering', () => {
11
- const tpl = `{% partialdef greeting %}Hello {{ name }}{% endpartialdef %}{% partial greeting %}`;
12
- const out = render(tpl, { name: 'Miki' });
13
- assert.strictEqual(out, 'Hello Miki');
14
- });
15
-
16
- // Partialdef with conditional logic
17
- test('Partialdef with if/else', () => {
18
- const tpl = `{% partialdef cond %}{% if show %}Visible{% else %}Hidden{% endif %}{% endpartialdef %}{% partial cond %}`;
19
- assert.strictEqual(render(tpl, { show: true }), 'Visible');
20
- assert.strictEqual(render(tpl, { show: false }), 'Hidden');
21
- });
22
-
23
- // Partialdef with loop and metadata
24
- test('Partialdef with for loop', () => {
25
- const tpl = `{% partialdef list %}{% for item in items %}{{ item }},{% empty %}none{% endfor %}{% endpartialdef %}{% partial list %}`;
26
- assert.strictEqual(render(tpl, { items: ['a', 'b'] }), 'a,b,');
27
- assert.strictEqual(render(tpl, { items: [] }), 'none');
28
- });
29
-
30
- // Inline partialdef (renders immediately)
31
- test('Inline partialdef renders inline', () => {
32
- const tpl = `{% partialdef inline_example inline %}Inline {{ val }}{% endpartialdef %}`;
33
- const out = render(tpl, { val: 'X' });
34
- assert.strictEqual(out, 'Inline X');
35
- });
36
-
37
- // Rendering a partial via compile.renderPartial API
38
- test('renderPartial API works', () => {
39
- const tpl = `{% partialdef api %}API {{ data }}{% endpartialdef %}`;
40
- const compiled = compile(tpl);
41
- const out = compiled.renderPartial('api', { data: 123 });
42
- assert.strictEqual(out, 'API 123');
43
- });
44
-
45
- // Bug fix: partials defined inside for loops are found by renderPartialFromSource
46
- test('renderPartialFromSource finds partials inside for loops', () => {
47
- const tpl = `{% for item in items %}{% partialdef loop_item %}{{ item }}{% endpartialdef %}{% endfor %}`;
48
- const out = renderPartialFromSource(tpl, 'loop_item', { item: 'X' });
49
- assert.strictEqual(out, 'X');
50
- });
51
-
52
- // Bug fix: include with partial selector does not leak other partials from included file
53
- test('include with partial selector does not leak other partials', () => {
54
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-partial-'));
55
- fs.writeFileSync(path.join(dir, 'main.html'), `{% include "frag.html#only_me" %}`);
56
- fs.writeFileSync(path.join(dir, 'frag.html'), `{% partialdef only_me %}ME{% endpartialdef %}{% partialdef secret %}SECRET{% endpartialdef %}`);
57
-
58
- const mainTpl = fs.readFileSync(path.join(dir, 'main.html'), 'utf8');
59
- assert.throws(
60
- () => renderPartialFromSource(mainTpl, 'secret', {}, { views: dir }),
61
- /Partial 'secret' not found/
62
- );
63
-
64
- fs.rmSync(dir, { recursive: true });
65
- });
66
-
67
- // Bug fix: full include makes all partials from included file available
68
- test('full include makes all included partials available', () => {
69
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-partial-full-'));
70
- fs.writeFileSync(path.join(dir, 'main.html'), `{% include "frag.html" %}`);
71
- fs.writeFileSync(path.join(dir, 'frag.html'), `{% partialdef only_me %}ME{% endpartialdef %}{% partialdef secret %}SECRET{% endpartialdef %}`);
72
-
73
- const mainTpl = fs.readFileSync(path.join(dir, 'main.html'), 'utf8');
74
- const out = renderPartialFromSource(mainTpl, 'secret', {}, { views: dir });
75
- assert.strictEqual(out, 'SECRET');
76
-
77
- fs.rmSync(dir, { recursive: true });
78
- });
79
-
1
+ // tests for partialdef support, including conditionals, loops, and inline rendering
2
+ const test = require('node:test');
3
+ const assert = require('node:assert');
4
+ const path = require('path');
5
+ const fs = require('fs');
6
+ const os = require('os');
7
+ const { render, compile, renderPartialFromSource } = require('../src/index');
8
+
9
+ // Basic partialdef rendering via {% partial %}
10
+ test('Partialdef basic rendering', () => {
11
+ const tpl = `{% partialdef greeting %}Hello {{ name }}{% endpartialdef %}{% partial greeting %}`;
12
+ const out = render(tpl, { name: 'Miki' });
13
+ assert.strictEqual(out, 'Hello Miki');
14
+ });
15
+
16
+ // Partialdef with conditional logic
17
+ test('Partialdef with if/else', () => {
18
+ const tpl = `{% partialdef cond %}{% if show %}Visible{% else %}Hidden{% endif %}{% endpartialdef %}{% partial cond %}`;
19
+ assert.strictEqual(render(tpl, { show: true }), 'Visible');
20
+ assert.strictEqual(render(tpl, { show: false }), 'Hidden');
21
+ });
22
+
23
+ // Partialdef with loop and metadata
24
+ test('Partialdef with for loop', () => {
25
+ const tpl = `{% partialdef list %}{% for item in items %}{{ item }},{% empty %}none{% endfor %}{% endpartialdef %}{% partial list %}`;
26
+ assert.strictEqual(render(tpl, { items: ['a', 'b'] }), 'a,b,');
27
+ assert.strictEqual(render(tpl, { items: [] }), 'none');
28
+ });
29
+
30
+ // Inline partialdef (renders immediately)
31
+ test('Inline partialdef renders inline', () => {
32
+ const tpl = `{% partialdef inline_example inline %}Inline {{ val }}{% endpartialdef %}`;
33
+ const out = render(tpl, { val: 'X' });
34
+ assert.strictEqual(out, 'Inline X');
35
+ });
36
+
37
+ // Rendering a partial via compile.renderPartial API
38
+ test('renderPartial API works', () => {
39
+ const tpl = `{% partialdef api %}API {{ data }}{% endpartialdef %}`;
40
+ const compiled = compile(tpl);
41
+ const out = compiled.renderPartial('api', { data: 123 });
42
+ assert.strictEqual(out, 'API 123');
43
+ });
44
+
45
+ // Bug fix: partials defined inside for loops are found by renderPartialFromSource
46
+ test('renderPartialFromSource finds partials inside for loops', () => {
47
+ const tpl = `{% for item in items %}{% partialdef loop_item %}{{ item }}{% endpartialdef %}{% endfor %}`;
48
+ const out = renderPartialFromSource(tpl, 'loop_item', { item: 'X' });
49
+ assert.strictEqual(out, 'X');
50
+ });
51
+
52
+ // Bug fix: include with partial selector does not leak other partials from included file
53
+ test('include with partial selector does not leak other partials', () => {
54
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-partial-'));
55
+ fs.writeFileSync(path.join(dir, 'main.html'), `{% include "frag.html#only_me" %}`);
56
+ fs.writeFileSync(path.join(dir, 'frag.html'), `{% partialdef only_me %}ME{% endpartialdef %}{% partialdef secret %}SECRET{% endpartialdef %}`);
57
+
58
+ const mainTpl = fs.readFileSync(path.join(dir, 'main.html'), 'utf8');
59
+ assert.throws(
60
+ () => renderPartialFromSource(mainTpl, 'secret', {}, { views: dir }),
61
+ /Partial 'secret' not found/
62
+ );
63
+
64
+ fs.rmSync(dir, { recursive: true });
65
+ });
66
+
67
+ // Bug fix: full include makes all partials from included file available
68
+ test('full include makes all included partials available', () => {
69
+ const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'miki-partial-full-'));
70
+ fs.writeFileSync(path.join(dir, 'main.html'), `{% include "frag.html" %}`);
71
+ fs.writeFileSync(path.join(dir, 'frag.html'), `{% partialdef only_me %}ME{% endpartialdef %}{% partialdef secret %}SECRET{% endpartialdef %}`);
72
+
73
+ const mainTpl = fs.readFileSync(path.join(dir, 'main.html'), 'utf8');
74
+ const out = renderPartialFromSource(mainTpl, 'secret', {}, { views: dir });
75
+ assert.strictEqual(out, 'SECRET');
76
+
77
+ fs.rmSync(dir, { recursive: true });
78
+ });
79
+
@@ -1,57 +1,57 @@
1
- // Production readiness checks
2
- const { render, compile } = require('../src/index');
3
- const checks = [];
4
-
5
- try {
6
- render('{% if x %}hello', {});
7
- checks.push('FAIL: should throw on unclosed if');
8
- } catch(e) {
9
- checks.push('OK: unclosed if throws: ' + e.message.slice(0, 50));
10
- }
11
-
12
- try {
13
- render('{{ x|nonexistent }}', { x: 'hi' });
14
- checks.push('FAIL: should throw on unknown filter');
15
- } catch(e) {
16
- checks.push('OK: unknown filter throws: ' + e.message.slice(0, 50));
17
- }
18
-
19
- try {
20
- render('{% nonexistent_tag %}', {});
21
- checks.push('FAIL: should throw on unknown tag');
22
- } catch(e) {
23
- checks.push('OK: unknown tag throws: ' + e.message.slice(0, 50));
24
- }
25
-
26
- const xss = render('{{ x }}', { x: '<script>alert(1)</script>' });
27
- checks.push(xss.includes('&lt;script&gt;') ? 'OK: XSS auto-escaped' : 'FAIL: XSS not escaped');
28
-
29
- const safe = render('{{ x|safe }}', { x: '<b>bold</b>' });
30
- checks.push(safe === '<b>bold</b>' ? 'OK: safe filter works' : 'FAIL: safe: ' + safe);
31
-
32
- const c1 = compile('{% cycle a b c %}');
33
- const r1 = c1.render({});
34
- const r2 = c1.render({});
35
- checks.push(r1 !== r2 ? 'OK: cycle resets' : 'WARN: cycle state: ' + r1 + '/' + r2);
36
-
37
- try {
38
- render('{{ x }}', { x: 'a'.repeat(100000) });
39
- checks.push('OK: handles large input');
40
- } catch(e) {
41
- checks.push('FAIL: large input: ' + e.message);
42
- }
43
-
44
- const nullTest = render('{{ x }}', { x: null });
45
- checks.push(nullTest === '' ? 'OK: null renders empty' : 'FAIL: null=' + nullTest);
46
-
47
- try {
48
- render('{% extends "../etc/passwd" %}', {});
49
- checks.push('FAIL: path traversal not blocked');
50
- } catch(e) {
51
- checks.push('OK: path traversal blocked: ' + e.message.slice(0, 50));
52
- }
53
-
54
- const nested = render('{% for i in outer %}{% for j in i %}{{ forloop.parentloop.counter }}.{{ forloop.counter }} {% endfor %}{% endfor %}', { outer: [[1,2],[3,4]] });
55
- checks.push(nested.trim() === '1.1 1.2 2.1 2.2' ? 'OK: nested forloop' : 'WARN nested: ' + nested);
56
-
57
- console.log(checks.join('\n'));
1
+ // Production readiness checks
2
+ const { render, compile } = require('../src/index');
3
+ const checks = [];
4
+
5
+ try {
6
+ render('{% if x %}hello', {});
7
+ checks.push('FAIL: should throw on unclosed if');
8
+ } catch(e) {
9
+ checks.push('OK: unclosed if throws: ' + e.message.slice(0, 50));
10
+ }
11
+
12
+ try {
13
+ render('{{ x|nonexistent }}', { x: 'hi' });
14
+ checks.push('FAIL: should throw on unknown filter');
15
+ } catch(e) {
16
+ checks.push('OK: unknown filter throws: ' + e.message.slice(0, 50));
17
+ }
18
+
19
+ try {
20
+ render('{% nonexistent_tag %}', {});
21
+ checks.push('FAIL: should throw on unknown tag');
22
+ } catch(e) {
23
+ checks.push('OK: unknown tag throws: ' + e.message.slice(0, 50));
24
+ }
25
+
26
+ const xss = render('{{ x }}', { x: '<script>alert(1)</script>' });
27
+ checks.push(xss.includes('&lt;script&gt;') ? 'OK: XSS auto-escaped' : 'FAIL: XSS not escaped');
28
+
29
+ const safe = render('{{ x|safe }}', { x: '<b>bold</b>' });
30
+ checks.push(safe === '<b>bold</b>' ? 'OK: safe filter works' : 'FAIL: safe: ' + safe);
31
+
32
+ const c1 = compile('{% cycle a b c %}');
33
+ const r1 = c1.render({});
34
+ const r2 = c1.render({});
35
+ checks.push(r1 !== r2 ? 'OK: cycle resets' : 'WARN: cycle state: ' + r1 + '/' + r2);
36
+
37
+ try {
38
+ render('{{ x }}', { x: 'a'.repeat(100000) });
39
+ checks.push('OK: handles large input');
40
+ } catch(e) {
41
+ checks.push('FAIL: large input: ' + e.message);
42
+ }
43
+
44
+ const nullTest = render('{{ x }}', { x: null });
45
+ checks.push(nullTest === '' ? 'OK: null renders empty' : 'FAIL: null=' + nullTest);
46
+
47
+ try {
48
+ render('{% extends "../etc/passwd" %}', {});
49
+ checks.push('FAIL: path traversal not blocked');
50
+ } catch(e) {
51
+ checks.push('OK: path traversal blocked: ' + e.message.slice(0, 50));
52
+ }
53
+
54
+ const nested = render('{% for i in outer %}{% for j in i %}{{ forloop.parentloop.counter }}.{{ forloop.counter }} {% endfor %}{% endfor %}', { outer: [[1,2],[3,4]] });
55
+ checks.push(nested.trim() === '1.1 1.2 2.1 2.2' ? 'OK: nested forloop' : 'WARN nested: ' + nested);
56
+
57
+ console.log(checks.join('\n'));
@@ -1,28 +1,28 @@
1
- const test = require('node:test');
2
- const assert = require('node:assert');
3
- const { render, markSafe } = require('../src/index');
4
-
5
- test('Security - HTML Auto-escaping enabled by default', () => {
6
- const tpl = '{{ value }}';
7
- const output = render(tpl, { value: '<script>alert("xss")</script>' });
8
- assert.strictEqual(output, '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;');
9
- });
10
-
11
- test('Security - safe filter disables escaping', () => {
12
- const tpl = '{{ value|safe }}';
13
- const output = render(tpl, { value: '<b>Hello</b>' });
14
- assert.strictEqual(output, '<b>Hello</b>');
15
- });
16
-
17
- test('Security - escape filter forces escaping', () => {
18
- // In autoescape off mode, escape filter still escapes
19
- const tpl = '{% autoescape off %}{{ value|escape }}{% endautoescape %}';
20
- const output = render(tpl, { value: '<b>Hello</b>' });
21
- assert.strictEqual(output, '&lt;b&gt;Hello&lt;/b&gt;');
22
- });
23
-
24
- test('Security - markSafe variables bypassed', () => {
25
- const tpl = '{{ value }}';
26
- const output = render(tpl, { value: markSafe('<h1>Title</h1>') });
27
- assert.strictEqual(output, '<h1>Title</h1>');
28
- });
1
+ const test = require('node:test');
2
+ const assert = require('node:assert');
3
+ const { render, markSafe } = require('../src/index');
4
+
5
+ test('Security - HTML Auto-escaping enabled by default', () => {
6
+ const tpl = '{{ value }}';
7
+ const output = render(tpl, { value: '<script>alert("xss")</script>' });
8
+ assert.strictEqual(output, '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;');
9
+ });
10
+
11
+ test('Security - safe filter disables escaping', () => {
12
+ const tpl = '{{ value|safe }}';
13
+ const output = render(tpl, { value: '<b>Hello</b>' });
14
+ assert.strictEqual(output, '<b>Hello</b>');
15
+ });
16
+
17
+ test('Security - escape filter forces escaping', () => {
18
+ // In autoescape off mode, escape filter still escapes
19
+ const tpl = '{% autoescape off %}{{ value|escape }}{% endautoescape %}';
20
+ const output = render(tpl, { value: '<b>Hello</b>' });
21
+ assert.strictEqual(output, '&lt;b&gt;Hello&lt;/b&gt;');
22
+ });
23
+
24
+ test('Security - markSafe variables bypassed', () => {
25
+ const tpl = '{{ value }}';
26
+ const output = render(tpl, { value: markSafe('<h1>Title</h1>') });
27
+ assert.strictEqual(output, '<h1>Title</h1>');
28
+ });