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
package/src/lexer.js CHANGED
@@ -1,92 +1,114 @@
1
- /**
2
- * Lexer for tokenizing Django-style templates.
3
- */
4
-
5
- /**
6
- * Token types:
7
- * - 'text': Raw template content.
8
- * - 'var': Variable interpolation, e.g. {{ user.name }}.
9
- * - 'block': Structural tag block, e.g. {% if user.is_active %}.
10
- */
11
-
12
- function tokenize(template) {
13
- if (typeof template !== 'string') {
14
- throw new TypeError('Template must be a string');
15
- }
16
-
17
- // Regex to split by delimiters: {{ ... }}, {% ... %}, and {# ... #}
18
- // Using 's' flag to match dot as newline (dotAll)
19
- const tagRegexp = /(\{\{.*?\}\}|\{\%.*?\%\}|\{\#.*?\#\})/gs;
20
- const parts = template.split(tagRegexp);
21
- const tokens = [];
22
-
23
- let inVerbatim = false;
24
- let verbatimBuffer = [];
25
-
26
- for (let i = 0; i < parts.length; i++) {
27
- const part = parts[i];
28
- if (part === undefined || part === null) continue;
29
-
30
- // Handle verbatim mode
31
- if (inVerbatim) {
32
- if (part.startsWith('{%') && part.endsWith('%}') && part.slice(2, -2).trim() === 'endverbatim') {
33
- inVerbatim = false;
34
- if (verbatimBuffer.length > 0) {
35
- tokens.push({
36
- type: 'text',
37
- content: verbatimBuffer.join('')
38
- });
39
- verbatimBuffer = [];
40
- }
41
- } else {
42
- verbatimBuffer.push(part);
43
- }
44
- continue;
45
- }
46
-
47
- if (part.startsWith('{#') && part.endsWith('#}')) {
48
- // Comments are ignored in the token output
49
- continue;
50
- } else if (part.startsWith('{{') && part.endsWith('}}')) {
51
- const content = part.slice(2, -2).trim();
52
- tokens.push({
53
- type: 'var',
54
- content,
55
- raw: part
56
- });
57
- } else if (part.startsWith('{%') && part.endsWith('%}')) {
58
- const content = part.slice(2, -2).trim();
59
- if (content === 'verbatim') {
60
- inVerbatim = true;
61
- } else {
62
- tokens.push({
63
- type: 'block',
64
- content,
65
- raw: part
66
- });
67
- }
68
- } else {
69
- // Do not push empty text tokens to keep AST clean
70
- if (part !== '') {
71
- tokens.push({
72
- type: 'text',
73
- content: part
74
- });
75
- }
76
- }
77
- }
78
-
79
- // If verbatim wasn't closed, treat the remaining buffer as text
80
- if (inVerbatim && verbatimBuffer.length > 0) {
81
- tokens.push({
82
- type: 'text',
83
- content: verbatimBuffer.join('')
84
- });
85
- }
86
-
87
- return tokens;
88
- }
89
-
90
- module.exports = {
91
- tokenize
92
- };
1
+ /**
2
+ * Lexer for tokenizing Django-style templates.
3
+ */
4
+
5
+ /**
6
+ * Token types:
7
+ * - 'text': Raw template content.
8
+ * - 'var': Variable interpolation, e.g. {{ user.name }}.
9
+ * - 'block': Structural tag block, e.g. {% if user.is_active %}.
10
+ */
11
+
12
+ function tokenize(template) {
13
+ if (typeof template !== 'string') {
14
+ throw new TypeError('Template must be a string');
15
+ }
16
+
17
+ const tokens = [];
18
+ let i = 0;
19
+ const len = template.length;
20
+ let inVerbatim = false;
21
+ let verbatimBuffer = [];
22
+
23
+ while (i < len) {
24
+ // Detect the start of a variable, block, or comment.
25
+ if (template[i] === '{' && i + 1 < len) {
26
+ const next = template[i + 1];
27
+ if (next === '{' || next === '%' || next === '#') {
28
+ // Find the matching closer, accounting for nested {{ }} and {% %}
29
+ // so expressions like {{ x|default:"{{ y }}" }} parse correctly.
30
+ const isVar = next === '{';
31
+ const isBlock = next === '%';
32
+ const isComment = next === '#';
33
+ const closer = isVar ? '}}' : (isBlock ? '%}' : '#}');
34
+ let j = i + 2;
35
+ let depth = 1;
36
+ while (j < len && depth > 0) {
37
+ if (isVar && template[j] === '{' && template[j + 1] === '{') {
38
+ depth++;
39
+ j += 2;
40
+ continue;
41
+ }
42
+ if (isBlock && template[j] === '{' && template[j + 1] === '%') {
43
+ depth++;
44
+ j += 2;
45
+ continue;
46
+ }
47
+ if (template.substr(j, closer.length) === closer) {
48
+ depth--;
49
+ if (depth === 0) break;
50
+ j += closer.length;
51
+ continue;
52
+ }
53
+ j++;
54
+ }
55
+ if (depth !== 0) {
56
+ throw new Error(`Unclosed template tag at position ${i}`);
57
+ }
58
+ const raw = template.slice(i, j + closer.length);
59
+ const inner = template.slice(i + 2, j).trim();
60
+
61
+ if (inVerbatim) {
62
+ if (isBlock && inner === 'endverbatim') {
63
+ inVerbatim = false;
64
+ if (verbatimBuffer.length > 0) {
65
+ tokens.push({ type: 'text', content: verbatimBuffer.join('') });
66
+ verbatimBuffer = [];
67
+ }
68
+ } else {
69
+ verbatimBuffer.push(raw);
70
+ }
71
+ } else if (isComment) {
72
+ // Comments are ignored
73
+ } else if (isVar) {
74
+ tokens.push({ type: 'var', content: inner, raw });
75
+ } else {
76
+ // Block tag
77
+ if (inner === 'verbatim') {
78
+ inVerbatim = true;
79
+ } else {
80
+ tokens.push({ type: 'block', content: inner, raw });
81
+ }
82
+ }
83
+ i = j + closer.length;
84
+ continue;
85
+ }
86
+ }
87
+
88
+ // Plain text — collect until the next special delimiter.
89
+ let textStart = i;
90
+ while (i < len) {
91
+ if (template[i] === '{' && i + 1 < len) {
92
+ const nx = template[i + 1];
93
+ if (nx === '{' || nx === '%' || nx === '#') break;
94
+ }
95
+ i++;
96
+ }
97
+ const text = template.slice(textStart, i);
98
+ if (inVerbatim) {
99
+ verbatimBuffer.push(text);
100
+ } else if (text !== '') {
101
+ tokens.push({ type: 'text', content: text });
102
+ }
103
+ }
104
+
105
+ if (inVerbatim && verbatimBuffer.length > 0) {
106
+ tokens.push({ type: 'text', content: verbatimBuffer.join('') });
107
+ }
108
+
109
+ return tokens;
110
+ }
111
+
112
+ module.exports = {
113
+ tokenize
114
+ };