miki-template 1.3.3 → 1.3.6

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 (101) hide show
  1. package/.github/release-notes/v1.3.1.md +55 -55
  2. package/.github/release-notes/v1.3.3.md +77 -0
  3. package/.github/workflows/ci.yml +38 -54
  4. package/.github/workflows/release.yml +106 -0
  5. package/AGENT.md +71 -71
  6. package/API_REFERENCE.md +314 -314
  7. package/CHANGELOG.md +173 -169
  8. package/CODE_OF_CONDUCT.md +14 -14
  9. package/CONTRIBUTING.md +27 -27
  10. package/README.md +342 -321
  11. package/ROADMAP.md +40 -40
  12. package/benchmarks/report.json +16 -16
  13. package/benchmarks/run.js +49 -49
  14. package/benchmarks/stress.mjs +647 -647
  15. package/benchmarks/templates/large.dtpl +7 -7
  16. package/benchmarks/templates/medium.dtpl +3 -3
  17. package/benchmarks/templates/small.dtpl +7 -7
  18. package/context/component.md +109 -109
  19. package/context/prd.md +131 -131
  20. package/context/project-structure.md +33 -33
  21. package/dir/base.html +22 -22
  22. package/dir/cmpnt.html +10 -10
  23. package/dir/footer.html +2 -2
  24. package/dir/home.html +80 -80
  25. package/dir/index.html +80 -0
  26. package/dir/navbar.html +8 -8
  27. package/docs/README.md +18 -18
  28. package/docs/advanced_usage.md +71 -71
  29. package/docs/api.md +119 -119
  30. package/docs/filters.md +708 -708
  31. package/docs/installation.md +106 -106
  32. package/docs/overview.md +57 -57
  33. package/docs/partialdef.md +70 -70
  34. package/docs/security.md +27 -27
  35. package/docs/tags.md +673 -673
  36. package/docs/usage.md +646 -646
  37. package/eslint.config.mjs +42 -42
  38. package/ex.mjs +32 -32
  39. package/miki-template-extension/.github/workflows/ci.yml +116 -116
  40. package/miki-template-extension/.vscodeignore +7 -7
  41. package/miki-template-extension/CHANGELOG.md +99 -99
  42. package/miki-template-extension/LICENSE +21 -21
  43. package/miki-template-extension/README.md +273 -273
  44. package/miki-template-extension/extension.js +1013 -1013
  45. package/miki-template-extension/icon.svg +10 -10
  46. package/miki-template-extension/package.json +280 -280
  47. package/miki-template-extension/snippets/miki-template.json +717 -717
  48. package/miki-template-extension/syntaxes/language-configuration.json +114 -114
  49. package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +355 -355
  50. package/miki-template-extension/tests/grammar-tests.json +162 -162
  51. package/miki-template-extension/tests/run-grammar-tests.js +82 -82
  52. package/package.json +37 -34
  53. package/sample-app/package-lock.json +901 -0
  54. package/sample-app/package.json +9 -0
  55. package/sample-app/server.js +14 -0
  56. package/sample-app/views/index.html +1 -0
  57. package/scripts/build-vsix.js +129 -129
  58. package/scripts/build-vsix.ps1 +15 -15
  59. package/snippets/miki-template.json +177 -177
  60. package/src/asyncRender.js +20 -20
  61. package/src/cache.js +80 -80
  62. package/src/context.js +126 -126
  63. package/src/context_processors.js +48 -48
  64. package/src/esm.mjs +84 -84
  65. package/src/filters.js +975 -975
  66. package/src/i18n.js +171 -171
  67. package/src/index.js +974 -940
  68. package/src/lexer.js +114 -114
  69. package/src/libraries.js +371 -371
  70. package/src/parser.js +270 -270
  71. package/src/security.js +53 -53
  72. package/src/tags/control.js +719 -719
  73. package/src/tags/extra.js +154 -154
  74. package/src/tags/helpers.js +26 -26
  75. package/src/tags/i18n.js +256 -256
  76. package/src/tags/inheritance.js +335 -335
  77. package/src/tags/registry.js +18 -18
  78. package/src/tags/util.js +400 -400
  79. package/src/types.d.ts +107 -107
  80. package/syntaxes/language-configuration.json +26 -26
  81. package/syntaxes/miki-template.tmLanguage.json +146 -146
  82. package/tests/asyncRender.test.js +17 -17
  83. package/tests/base.html +6 -6
  84. package/tests/child.html +3 -3
  85. package/tests/context_processors.test.js +13 -13
  86. package/tests/esm.test.mjs +61 -61
  87. package/tests/filters.test.js +254 -254
  88. package/tests/include_security.test.js +9 -9
  89. package/tests/integration/README.md +32 -32
  90. package/tests/integration/features.test.cjs +1681 -1681
  91. package/tests/integration/features.test.mjs +1697 -1697
  92. package/tests/integration/templates/base.miki +6 -6
  93. package/tests/integration/templates/child.miki +6 -6
  94. package/tests/integration/templates/index.html +17 -17
  95. package/tests/lexer.test.js +45 -45
  96. package/tests/parser.test.js +57 -57
  97. package/tests/partial.html +1 -1
  98. package/tests/partialdef.test.js +79 -79
  99. package/tests/production_checks.js +57 -57
  100. package/tests/security.test.js +28 -28
  101. package/tests/tags.test.js +233 -233
package/src/tags/extra.js CHANGED
@@ -1,154 +1,154 @@
1
- /**
2
- * Additional utility template tags: now, set, ifchanged.
3
- */
4
-
5
- // Helper to resolve expression values (literals, numbers, booleans, or context lookups)
6
- function resolveValue(token, context) {
7
- if (token === undefined || token === null) return '';
8
- if (typeof token !== 'string') return token;
9
- if (token === '') return '';
10
- if ((token.startsWith('"') && token.endsWith('"')) || (token.startsWith('\'') && token.endsWith('\''))) {
11
- return token.slice(1, -1);
12
- }
13
- if (token === 'true' || token === 'True') return true;
14
- if (token === 'false' || token === 'False') return false;
15
- if (token === 'none' || token === 'None' || token === 'null') return null;
16
- if (/^-?\d+(\.\d+)?$/.test(token)) return Number(token);
17
- return context.get(token);
18
- }
19
-
20
- // --- {% now %} tag ---
21
-
22
- class NowNode {
23
- constructor(formatExpr) {
24
- this.formatExpr = formatExpr;
25
- }
26
-
27
- render(context) {
28
- const fmt = resolveValue(this.formatExpr, context);
29
- const now = new Date();
30
- if (!fmt) return now.toISOString();
31
- const dateFilter = require('../filters');
32
- return dateFilter.getFilter('date')(now, fmt);
33
- }
34
- }
35
-
36
- function parseNow(tagContent, _parser) {
37
- const fmt = tagContent.slice(3).trim();
38
- return new NowNode(fmt || '"Y-m-d H:i:s"');
39
- }
40
-
41
- // --- {% set %} tag ---
42
-
43
- class SetNode {
44
- constructor(nameExpr, valueExpr, body) {
45
- this.nameExpr = nameExpr;
46
- this.valueExpr = valueExpr;
47
- this.body = body || [];
48
- }
49
-
50
- render(context) {
51
- const name = String(this.nameExpr);
52
- const value = this.valueExpr !== undefined ? resolveValue(this.valueExpr, context) : '';
53
- if (name) {
54
- context.scopes[0][name] = value;
55
- }
56
- return this.body.map(n => n.render(context)).join('');
57
- }
58
- }
59
-
60
- function parseSet(tagContent, parser) {
61
- // {% set var = expr %}
62
- // {% set var %}...{% endset %}
63
- const trimmed = tagContent.slice(3).trim();
64
-
65
- // Block form: {% set var %}...{% endset %}
66
- if (!trimmed.includes('=')) {
67
- const varName = trimmed.trim();
68
- const body = parser.parse(['endset']);
69
- const next = parser.peek();
70
- if (next && next.type === 'block' && next.content.split(/\s+/)[0] === 'endset') {
71
- parser.advance();
72
- }
73
- return new SetNode(varName, undefined, body);
74
- }
75
-
76
- // Inline form: {% set var = expr %}
77
- const eqIdx = trimmed.indexOf('=');
78
- const nameExpr = trimmed.slice(0, eqIdx).trim();
79
- const valueExpr = trimmed.slice(eqIdx + 1).trim();
80
- return new SetNode(nameExpr, valueExpr, []);
81
- }
82
-
83
- // --- {% ifchanged %} tag ---
84
-
85
- class IfChangedNode {
86
- constructor(conditionStr, body, elseBody) {
87
- this.conditionStr = conditionStr;
88
- this.body = body;
89
- this.elseBody = elseBody;
90
- }
91
-
92
- render(context) {
93
- const currentVal = this.conditionStr ? resolveValue(this.conditionStr, context) : undefined;
94
-
95
- if (!context.ifChangedState) {
96
- context.ifChangedState = new Map();
97
- }
98
-
99
- const lastVal = context.ifChangedState.get(this.conditionStr);
100
-
101
- let changed = false;
102
- if (lastVal === undefined) {
103
- changed = true;
104
- } else if (currentVal !== lastVal) {
105
- changed = true;
106
- }
107
-
108
- if (changed) {
109
- context.ifChangedState.set(this.conditionStr, currentVal);
110
- return this.body.map(n => n.render(context)).join('');
111
- }
112
-
113
- if (this.elseBody) {
114
- return this.elseBody.map(n => n.render(context)).join('');
115
- }
116
-
117
- return '';
118
- }
119
- }
120
-
121
- function parseIfChanged(tagContent, parser) {
122
- // {% ifchanged [value] %}
123
- const conditionStr = tagContent.slice(9).trim();
124
- const body = parser.parse(['else', 'endifchanged']);
125
- let elseBody = null;
126
-
127
- while (true) {
128
- const next = parser.peek();
129
- if (!next || next.type !== 'block') break;
130
- const tagName = next.content.split(/\s+/)[0];
131
- if (tagName === 'else') {
132
- parser.advance();
133
- elseBody = parser.parse(['endifchanged']);
134
- } else if (tagName === 'endifchanged') {
135
- parser.advance();
136
- break;
137
- } else {
138
- break;
139
- }
140
- }
141
-
142
- return new IfChangedNode(conditionStr, body, elseBody);
143
- }
144
-
145
- module.exports = {
146
- NowNode,
147
- SetNode,
148
- IfChangedNode,
149
- parsers: {
150
- now: parseNow,
151
- set: parseSet,
152
- ifchanged: parseIfChanged
153
- }
154
- };
1
+ /**
2
+ * Additional utility template tags: now, set, ifchanged.
3
+ */
4
+
5
+ // Helper to resolve expression values (literals, numbers, booleans, or context lookups)
6
+ function resolveValue(token, context) {
7
+ if (token === undefined || token === null) return '';
8
+ if (typeof token !== 'string') return token;
9
+ if (token === '') return '';
10
+ if ((token.startsWith('"') && token.endsWith('"')) || (token.startsWith('\'') && token.endsWith('\''))) {
11
+ return token.slice(1, -1);
12
+ }
13
+ if (token === 'true' || token === 'True') return true;
14
+ if (token === 'false' || token === 'False') return false;
15
+ if (token === 'none' || token === 'None' || token === 'null') return null;
16
+ if (/^-?\d+(\.\d+)?$/.test(token)) return Number(token);
17
+ return context.get(token);
18
+ }
19
+
20
+ // --- {% now %} tag ---
21
+
22
+ class NowNode {
23
+ constructor(formatExpr) {
24
+ this.formatExpr = formatExpr;
25
+ }
26
+
27
+ render(context) {
28
+ const fmt = resolveValue(this.formatExpr, context);
29
+ const now = new Date();
30
+ if (!fmt) return now.toISOString();
31
+ const dateFilter = require('../filters');
32
+ return dateFilter.getFilter('date')(now, fmt);
33
+ }
34
+ }
35
+
36
+ function parseNow(tagContent, _parser) {
37
+ const fmt = tagContent.slice(3).trim();
38
+ return new NowNode(fmt || '"Y-m-d H:i:s"');
39
+ }
40
+
41
+ // --- {% set %} tag ---
42
+
43
+ class SetNode {
44
+ constructor(nameExpr, valueExpr, body) {
45
+ this.nameExpr = nameExpr;
46
+ this.valueExpr = valueExpr;
47
+ this.body = body || [];
48
+ }
49
+
50
+ render(context) {
51
+ const name = String(this.nameExpr);
52
+ const value = this.valueExpr !== undefined ? resolveValue(this.valueExpr, context) : '';
53
+ if (name) {
54
+ context.scopes[0][name] = value;
55
+ }
56
+ return this.body.map(n => n.render(context)).join('');
57
+ }
58
+ }
59
+
60
+ function parseSet(tagContent, parser) {
61
+ // {% set var = expr %}
62
+ // {% set var %}...{% endset %}
63
+ const trimmed = tagContent.slice(3).trim();
64
+
65
+ // Block form: {% set var %}...{% endset %}
66
+ if (!trimmed.includes('=')) {
67
+ const varName = trimmed.trim();
68
+ const body = parser.parse(['endset']);
69
+ const next = parser.peek();
70
+ if (next && next.type === 'block' && next.content.split(/\s+/)[0] === 'endset') {
71
+ parser.advance();
72
+ }
73
+ return new SetNode(varName, undefined, body);
74
+ }
75
+
76
+ // Inline form: {% set var = expr %}
77
+ const eqIdx = trimmed.indexOf('=');
78
+ const nameExpr = trimmed.slice(0, eqIdx).trim();
79
+ const valueExpr = trimmed.slice(eqIdx + 1).trim();
80
+ return new SetNode(nameExpr, valueExpr, []);
81
+ }
82
+
83
+ // --- {% ifchanged %} tag ---
84
+
85
+ class IfChangedNode {
86
+ constructor(conditionStr, body, elseBody) {
87
+ this.conditionStr = conditionStr;
88
+ this.body = body;
89
+ this.elseBody = elseBody;
90
+ }
91
+
92
+ render(context) {
93
+ const currentVal = this.conditionStr ? resolveValue(this.conditionStr, context) : undefined;
94
+
95
+ if (!context.ifChangedState) {
96
+ context.ifChangedState = new Map();
97
+ }
98
+
99
+ const lastVal = context.ifChangedState.get(this.conditionStr);
100
+
101
+ let changed = false;
102
+ if (lastVal === undefined) {
103
+ changed = true;
104
+ } else if (currentVal !== lastVal) {
105
+ changed = true;
106
+ }
107
+
108
+ if (changed) {
109
+ context.ifChangedState.set(this.conditionStr, currentVal);
110
+ return this.body.map(n => n.render(context)).join('');
111
+ }
112
+
113
+ if (this.elseBody) {
114
+ return this.elseBody.map(n => n.render(context)).join('');
115
+ }
116
+
117
+ return '';
118
+ }
119
+ }
120
+
121
+ function parseIfChanged(tagContent, parser) {
122
+ // {% ifchanged [value] %}
123
+ const conditionStr = tagContent.slice(9).trim();
124
+ const body = parser.parse(['else', 'endifchanged']);
125
+ let elseBody = null;
126
+
127
+ while (true) {
128
+ const next = parser.peek();
129
+ if (!next || next.type !== 'block') break;
130
+ const tagName = next.content.split(/\s+/)[0];
131
+ if (tagName === 'else') {
132
+ parser.advance();
133
+ elseBody = parser.parse(['endifchanged']);
134
+ } else if (tagName === 'endifchanged') {
135
+ parser.advance();
136
+ break;
137
+ } else {
138
+ break;
139
+ }
140
+ }
141
+
142
+ return new IfChangedNode(conditionStr, body, elseBody);
143
+ }
144
+
145
+ module.exports = {
146
+ NowNode,
147
+ SetNode,
148
+ IfChangedNode,
149
+ parsers: {
150
+ now: parseNow,
151
+ set: parseSet,
152
+ ifchanged: parseIfChanged
153
+ }
154
+ };
@@ -1,27 +1,27 @@
1
- // Custom Tag Helpers module
2
-
3
- const { registerTag } = require('../tags/registry');
4
-
5
- class HelperNode {
6
- constructor(name, fn, body) {
7
- this.name = name;
8
- this.fn = fn;
9
- this.body = body;
10
- }
11
-
12
- render(context) {
13
- const inner = this.body.map(n => n.render(context)).join('');
14
- const result = this.fn(inner, context);
15
- return result instanceof Promise ? result : result;
16
- }
17
- }
18
-
19
- function registerHelper(name, fn) {
20
- const parserFn = (tagContent, parser) => {
21
- const body = parser.parseUntilTag(`end${name}`);
22
- return new HelperNode(name, fn, body);
23
- };
24
- registerTag(name, parserFn);
25
- }
26
-
1
+ // Custom Tag Helpers module
2
+
3
+ const { registerTag } = require('../tags/registry');
4
+
5
+ class HelperNode {
6
+ constructor(name, fn, body) {
7
+ this.name = name;
8
+ this.fn = fn;
9
+ this.body = body;
10
+ }
11
+
12
+ render(context) {
13
+ const inner = this.body.map(n => n.render(context)).join('');
14
+ const result = this.fn(inner, context);
15
+ return result instanceof Promise ? result : result;
16
+ }
17
+ }
18
+
19
+ function registerHelper(name, fn) {
20
+ const parserFn = (tagContent, parser) => {
21
+ const body = parser.parseUntilTag(`end${name}`);
22
+ return new HelperNode(name, fn, body);
23
+ };
24
+ registerTag(name, parserFn);
25
+ }
26
+
27
27
  module.exports = { registerHelper };