miki-template 1.2.0 → 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 (105) hide show
  1. package/.github/release-notes/v1.3.1.md +55 -0
  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 -97
  8. package/CODE_OF_CONDUCT.md +14 -14
  9. package/CONTRIBUTING.md +27 -27
  10. package/README.md +342 -304
  11. package/ROADMAP.md +40 -40
  12. package/assets/banner.png +0 -0
  13. package/benchmarks/report.json +16 -16
  14. package/benchmarks/run.js +49 -49
  15. package/benchmarks/stress.mjs +647 -0
  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 +23 -0
  23. package/dir/cmpnt.html +11 -0
  24. package/dir/footer.html +3 -0
  25. package/dir/home.html +80 -0
  26. package/dir/index.html +80 -0
  27. package/dir/navbar.html +9 -0
  28. package/docs/README.md +18 -18
  29. package/docs/advanced_usage.md +71 -71
  30. package/docs/api.md +119 -102
  31. package/docs/filters.md +708 -540
  32. package/docs/installation.md +106 -106
  33. package/docs/overview.md +57 -57
  34. package/docs/partialdef.md +70 -41
  35. package/docs/security.md +27 -27
  36. package/docs/tags.md +673 -610
  37. package/docs/usage.md +646 -599
  38. package/eslint.config.mjs +42 -34
  39. package/ex.mjs +33 -0
  40. package/miki-template-extension/.github/workflows/ci.yml +116 -0
  41. package/miki-template-extension/.vscodeignore +7 -0
  42. package/miki-template-extension/CHANGELOG.md +99 -0
  43. package/miki-template-extension/LICENSE +21 -21
  44. package/miki-template-extension/README.md +273 -82
  45. package/miki-template-extension/extension.js +1013 -0
  46. package/miki-template-extension/icon.png +0 -0
  47. package/miki-template-extension/icon.svg +10 -10
  48. package/miki-template-extension/miki-template-1.7.1.vsix +0 -0
  49. package/miki-template-extension/package.json +280 -46
  50. package/miki-template-extension/snippets/miki-template.json +717 -177
  51. package/miki-template-extension/syntaxes/language-configuration.json +114 -26
  52. package/miki-template-extension/syntaxes/miki-template.tmLanguage.json +355 -146
  53. package/miki-template-extension/tests/grammar-tests.json +162 -0
  54. package/miki-template-extension/tests/run-grammar-tests.js +82 -0
  55. package/package.json +37 -31
  56. package/sample-app/package-lock.json +901 -0
  57. package/sample-app/package.json +9 -0
  58. package/sample-app/server.js +14 -0
  59. package/sample-app/views/index.html +1 -0
  60. package/scripts/build-vsix.js +129 -0
  61. package/scripts/build-vsix.ps1 +15 -0
  62. package/snippets/miki-template.json +177 -177
  63. package/src/asyncRender.js +20 -20
  64. package/src/cache.js +80 -41
  65. package/src/context.js +126 -122
  66. package/src/context_processors.js +48 -41
  67. package/src/esm.mjs +84 -72
  68. package/src/filters.js +975 -527
  69. package/src/i18n.js +171 -171
  70. package/src/index.js +974 -454
  71. package/src/lexer.js +114 -92
  72. package/src/libraries.js +371 -240
  73. package/src/parser.js +270 -250
  74. package/src/security.js +53 -51
  75. package/src/tags/control.js +719 -590
  76. package/src/tags/extra.js +154 -0
  77. package/src/tags/helpers.js +26 -26
  78. package/src/tags/i18n.js +256 -230
  79. package/src/tags/inheritance.js +335 -216
  80. package/src/tags/registry.js +18 -18
  81. package/src/tags/util.js +400 -322
  82. package/src/types.d.ts +107 -107
  83. package/syntaxes/language-configuration.json +26 -26
  84. package/syntaxes/miki-template.tmLanguage.json +146 -146
  85. package/tests/asyncRender.test.js +17 -17
  86. package/tests/base.html +6 -6
  87. package/tests/child.html +3 -3
  88. package/tests/context_processors.test.js +13 -13
  89. package/tests/esm.test.mjs +61 -26
  90. package/tests/filters.test.js +254 -99
  91. package/tests/include_security.test.js +9 -9
  92. package/tests/integration/README.md +32 -0
  93. package/tests/integration/features.test.cjs +1681 -0
  94. package/tests/integration/features.test.mjs +1697 -0
  95. package/tests/integration/templates/base.miki +6 -0
  96. package/tests/integration/templates/child.miki +6 -0
  97. package/tests/integration/templates/index.html +17 -0
  98. package/tests/lexer.test.js +45 -45
  99. package/tests/parser.test.js +57 -55
  100. package/tests/partial.html +1 -1
  101. package/tests/partialdef.test.js +79 -40
  102. package/tests/production_checks.js +57 -57
  103. package/tests/security.test.js +28 -28
  104. package/tests/tags.test.js +233 -203
  105. package/miki-template-1.2.0.vsix +0 -0
@@ -0,0 +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,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 };