miki-template 1.3.3 → 1.3.7

package/snippets/miki-template.json

@@ -1,177 +1,177 @@
-{
-  "miki-template": {
-    "if": {
-      "prefix": "if",
-      "body": [
-        "{% if ${1:condition} %}",
-        "  ${2:content}",
-        "{% endif %}"
-      ],
-      "description": "If block"
-    },
-    "ifelse": {
-      "prefix": "ifelse",
-      "body": [
-        "{% if ${1:condition} %}",
-        "  ${2:content}",
-        "{% else %}",
-        "  ${3:fallback}",
-        "{% endif %}"
-      ],
-      "description": "If/else block"
-    },
-    "for": {
-      "prefix": "for",
-      "body": [
-        "{% for ${1:item} in ${2:items} %}",
-        "  ${3:{{ ${1} }}}",
-        "{% empty %}",
-        "  ${4:No items}",
-        "{% endfor %}"
-      ],
-      "description": "For loop"
-    },
-    "block": {
-      "prefix": "block",
-      "body": [
-        "{% block ${1:name} %}",
-        "  ${2:content}",
-        "{% endblock %}"
-      ],
-      "description": "Block definition"
-    },
-    "extends": {
-      "prefix": "extends",
-      "body": "{% extends \"${1:base.html}\" %}",
-      "description": "Extends parent template"
-    },
-    "include": {
-      "prefix": "include",
-      "body": "{% include \"${1:header.html}\" %}",
-      "description": "Include template"
-    },
-    "with": {
-      "prefix": "with",
-      "body": [
-        "{% with ${1:var} as ${2:alias} %}",
-        "  ${3:{{ ${2} }}}",
-        "{% endwith %}"
-      ],
-      "description": "With block"
-    },
-    "cycle": {
-      "prefix": "cycle",
-      "body": "{% cycle '${1:odd}' '${2:even}' %}",
-      "description": "Cycle tag"
-    },
-    "trans": {
-      "prefix": "trans",
-      "body": "{% trans \"${1:Hello, World!}\" %}",
-      "description": "Translate string"
-    },
-    "blocktrans": {
-      "prefix": "blocktrans",
-      "body": [
-        "{% blocktrans with ${1:name}=${2:user.name} %}",
-        "  ${3:Hello {{ ${1} }}}",
-        "{% endblocktrans %}"
-      ],
-      "description": "Translate block"
-    },
-    "language": {
-      "prefix": "language",
-      "body": [
-        "{% language \"${1:fr}\" %}",
-        "  ${2}",
-        "{% endlanguage %}"
-      ],
-      "description": "Switch language"
-    },
-    "partialdef": {
-      "prefix": "partialdef",
-      "body": [
-        "{% partialdef ${1:name} %}",
-        "  ${2}",
-        "{% endpartialdef %}"
-      ],
-      "description": "Define partial"
-    },
-    "partial": {
-      "prefix": "partial",
-      "body": "{% partial ${1:name} %}",
-      "description": "Render partial"
-    },
-    "csrf": {
-      "prefix": "csrf",
-      "body": "{% csrf_token %}",
-      "description": "CSRF token input"
-    },
-    "csp": {
-      "prefix": "csp",
-      "body": "<script {% csp_nonce_attr %}></script>",
-      "description": "CSP nonce attribute"
-    },
-    "static": {
-      "prefix": "static",
-      "body": "{% static \"${1:css/app.css}\" %}",
-      "description": "Static file URL"
-    },
-    "url": {
-      "prefix": "url",
-      "body": "{% url \"${1:route_name}\" ${2:args} %}",
-      "description": "URL for named route"
-    },
-    "widthratio": {
-      "prefix": "widthratio",
-      "body": "{% widthratio ${1:value} ${2:max} ${3:max_width} %}",
-      "description": "Proportional width"
-    },
-    "debug": {
-      "prefix": "debug",
-      "body": "{% debug %}",
-      "description": "Dump template context"
-    },
-    "load": {
-      "prefix": "load",
-      "body": "{% load ${1:i18n} %}",
-      "description": "Load tag library"
-    },
-    "comment": {
-      "prefix": "comment",
-      "body": [
-        "{#",
-        "  ${1:comment}",
-        "#}"
-      ],
-      "description": "Comment block"
-    },
-    "verbatim": {
-      "prefix": "verbatim",
-      "body": [
-        "{% verbatim %}",
-        "  ${1}",
-        "{% endverbatim %}"
-      ],
-      "description": "Verbatim block"
-    },
-    "regroup": {
-      "prefix": "regroup",
-      "body": "{% for ${1:group} in ${2:items}|regroup:\"${3:category}\" %}{{ ${1}.grouper }}{% endfor %}",
-      "description": "Regroup by attribute"
-    },
-    "firstof": {
-      "prefix": "firstof",
-      "body": "{% firstof ${1:var1} ${2:var2} \"${3:fallback}\" %}",
-      "description": "First truthy value"
-    },
-    "filter_block": {
-      "prefix": "filter",
-      "body": [
-        "{% filter ${1:lower} %}",
-        "  ${2}",
-        "{% endfilter %}"
-      ],
-      "description": "Filter block"
-    }
-  }
-}
+{
+  "miki-template": {
+    "if": {
+      "prefix": "if",
+      "body": [
+        "{% if ${1:condition} %}",
+        "  ${2:content}",
+        "{% endif %}"
+      ],
+      "description": "If block"
+    },
+    "ifelse": {
+      "prefix": "ifelse",
+      "body": [
+        "{% if ${1:condition} %}",
+        "  ${2:content}",
+        "{% else %}",
+        "  ${3:fallback}",
+        "{% endif %}"
+      ],
+      "description": "If/else block"
+    },
+    "for": {
+      "prefix": "for",
+      "body": [
+        "{% for ${1:item} in ${2:items} %}",
+        "  ${3:{{ ${1} }}}",
+        "{% empty %}",
+        "  ${4:No items}",
+        "{% endfor %}"
+      ],
+      "description": "For loop"
+    },
+    "block": {
+      "prefix": "block",
+      "body": [
+        "{% block ${1:name} %}",
+        "  ${2:content}",
+        "{% endblock %}"
+      ],
+      "description": "Block definition"
+    },
+    "extends": {
+      "prefix": "extends",
+      "body": "{% extends \"${1:base.html}\" %}",
+      "description": "Extends parent template"
+    },
+    "include": {
+      "prefix": "include",
+      "body": "{% include \"${1:header.html}\" %}",
+      "description": "Include template"
+    },
+    "with": {
+      "prefix": "with",
+      "body": [
+        "{% with ${1:var} as ${2:alias} %}",
+        "  ${3:{{ ${2} }}}",
+        "{% endwith %}"
+      ],
+      "description": "With block"
+    },
+    "cycle": {
+      "prefix": "cycle",
+      "body": "{% cycle '${1:odd}' '${2:even}' %}",
+      "description": "Cycle tag"
+    },
+    "trans": {
+      "prefix": "trans",
+      "body": "{% trans \"${1:Hello, World!}\" %}",
+      "description": "Translate string"
+    },
+    "blocktrans": {
+      "prefix": "blocktrans",
+      "body": [
+        "{% blocktrans with ${1:name}=${2:user.name} %}",
+        "  ${3:Hello {{ ${1} }}}",
+        "{% endblocktrans %}"
+      ],
+      "description": "Translate block"
+    },
+    "language": {
+      "prefix": "language",
+      "body": [
+        "{% language \"${1:fr}\" %}",
+        "  ${2}",
+        "{% endlanguage %}"
+      ],
+      "description": "Switch language"
+    },
+    "partialdef": {
+      "prefix": "partialdef",
+      "body": [
+        "{% partialdef ${1:name} %}",
+        "  ${2}",
+        "{% endpartialdef %}"
+      ],
+      "description": "Define partial"
+    },
+    "partial": {
+      "prefix": "partial",
+      "body": "{% partial ${1:name} %}",
+      "description": "Render partial"
+    },
+    "csrf": {
+      "prefix": "csrf",
+      "body": "{% csrf_token %}",
+      "description": "CSRF token input"
+    },
+    "csp": {
+      "prefix": "csp",
+      "body": "<script {% csp_nonce_attr %}></script>",
+      "description": "CSP nonce attribute"
+    },
+    "static": {
+      "prefix": "static",
+      "body": "{% static \"${1:css/app.css}\" %}",
+      "description": "Static file URL"
+    },
+    "url": {
+      "prefix": "url",
+      "body": "{% url \"${1:route_name}\" ${2:args} %}",
+      "description": "URL for named route"
+    },
+    "widthratio": {
+      "prefix": "widthratio",
+      "body": "{% widthratio ${1:value} ${2:max} ${3:max_width} %}",
+      "description": "Proportional width"
+    },
+    "debug": {
+      "prefix": "debug",
+      "body": "{% debug %}",
+      "description": "Dump template context"
+    },
+    "load": {
+      "prefix": "load",
+      "body": "{% load ${1:i18n} %}",
+      "description": "Load tag library"
+    },
+    "comment": {
+      "prefix": "comment",
+      "body": [
+        "{#",
+        "  ${1:comment}",
+        "#}"
+      ],
+      "description": "Comment block"
+    },
+    "verbatim": {
+      "prefix": "verbatim",
+      "body": [
+        "{% verbatim %}",
+        "  ${1}",
+        "{% endverbatim %}"
+      ],
+      "description": "Verbatim block"
+    },
+    "regroup": {
+      "prefix": "regroup",
+      "body": "{% for ${1:group} in ${2:items}|regroup:\"${3:category}\" %}{{ ${1}.grouper }}{% endfor %}",
+      "description": "Regroup by attribute"
+    },
+    "firstof": {
+      "prefix": "firstof",
+      "body": "{% firstof ${1:var1} ${2:var2} \"${3:fallback}\" %}",
+      "description": "First truthy value"
+    },
+    "filter_block": {
+      "prefix": "filter",
+      "body": [
+        "{% filter ${1:lower} %}",
+        "  ${2}",
+        "{% endfilter %}"
+      ],
+      "description": "Filter block"
+    }
+  }
+}

package/src/asyncRender.js

@@ -1,21 +1,21 @@
-// Async rendering utilities
-
-/**
- * Async version of renderAST that awaits any Promise returned by node.render.
- * Handles async nodes anywhere in the AST (inside conditionals, loops, etc.)
- */
-async function asyncRenderAST(nodes, context) {
-  // Helper to render a single node, awaiting if needed, and recursively handling children
-  const renderNode = async (node) => {
-    const result = node.render(context);
-    return result instanceof Promise ? await result : result;
-  };
-
-  const parts = [];
-  for (const node of nodes) {
-    parts.push(await renderNode(node));
-  }
-  return parts.join('');
-}
-
+// Async rendering utilities
+
+/**
+ * Async version of renderAST that awaits any Promise returned by node.render.
+ * Handles async nodes anywhere in the AST (inside conditionals, loops, etc.)
+ */
+async function asyncRenderAST(nodes, context) {
+  // Helper to render a single node, awaiting if needed, and recursively handling children
+  const renderNode = async (node) => {
+    const result = node.render(context);
+    return result instanceof Promise ? await result : result;
+  };
+
+  const parts = [];
+  for (const node of nodes) {
+    parts.push(await renderNode(node));
+  }
+  return parts.join('');
+}
+
 module.exports = { asyncRenderAST };

package/src/cache.js

@@ -1,80 +1,80 @@
-// Simple AST cache module
-
-/**
- * In‑memory LRU cache for compiled templates.
- * For demo purposes we use a plain Map limited to 100 entries.
- */
-const CACHE_LIMIT = 100;
-const cache = new Map();
-
-/**
- * Parent-source cache shared across renders. Populated by
- * renderAST/renderASTAsync in src/index.js so that `{% extends %}`
- * doesn't re-read the parent file from disk on every render.
- */
-const parentSourceCache = new Map();
-const PARENT_SOURCE_LIMIT = 64;
-
-function getParentSource(key, loader) {
-  if (parentSourceCache.has(key)) {
-    const v = parentSourceCache.get(key);
-    parentSourceCache.delete(key);
-    parentSourceCache.set(key, v);
-    return v;
-  }
-  const v = loader();
-  if (v != null) {
-    parentSourceCache.set(key, v);
-    if (parentSourceCache.size > PARENT_SOURCE_LIMIT) {
-      const firstKey = parentSourceCache.keys().next().value;
-      parentSourceCache.delete(firstKey);
-    }
-  }
-  return v;
-}
-
-function hasParentSource(key) {
-  return parentSourceCache.has(key);
-}
-
-/**
- * Retrieve a compiled template from cache or compile it and store.
- * @param {string} templateStr – template source
- * @param {object} compileOptions – options passed to compile()
- * @param {function} compileFn – the original compile function from src/index.js
- * @returns {object} compiled template object
- */
-function getCompiled(templateStr, compileOptions, compileFn) {
-  // Build a cache key that ignores non-serializable option values
-  // (e.g. functions like urlHelper, custom callbacks) — those don't
-  // affect template compilation, only render behavior.
-  const serializable = {};
-  for (const [k, v] of Object.entries(compileOptions || {})) {
-    if (typeof v === 'function' || typeof v === 'undefined') continue;
-    serializable[k] = v;
-  }
-  const key = JSON.stringify({ templateStr, compileOptions: serializable });
-  if (cache.has(key)) {
-    // Move to end to mark as recently used
-    const value = cache.get(key);
-    cache.delete(key);
-    cache.set(key, value);
-    return value;
-  }
-  const compiled = compileFn(templateStr, compileOptions);
-  cache.set(key, compiled);
-  // Trim if we exceed limit
-  if (cache.size > CACHE_LIMIT) {
-    const firstKey = cache.keys().next().value;
-    cache.delete(firstKey);
-  }
-  return compiled;
-}
-
-/** Clear the cache – useful for tests */
-function clearCache() {
-  cache.clear();
-  parentSourceCache.clear();
-}
-
-module.exports = { getCompiled, clearCache, getParentSource, hasParentSource };
+// Simple AST cache module
+
+/**
+ * In‑memory LRU cache for compiled templates.
+ * For demo purposes we use a plain Map limited to 100 entries.
+ */
+const CACHE_LIMIT = 100;
+const cache = new Map();
+
+/**
+ * Parent-source cache shared across renders. Populated by
+ * renderAST/renderASTAsync in src/index.js so that `{% extends %}`
+ * doesn't re-read the parent file from disk on every render.
+ */
+const parentSourceCache = new Map();
+const PARENT_SOURCE_LIMIT = 64;
+
+function getParentSource(key, loader) {
+  if (parentSourceCache.has(key)) {
+    const v = parentSourceCache.get(key);
+    parentSourceCache.delete(key);
+    parentSourceCache.set(key, v);
+    return v;
+  }
+  const v = loader();
+  if (v != null) {
+    parentSourceCache.set(key, v);
+    if (parentSourceCache.size > PARENT_SOURCE_LIMIT) {
+      const firstKey = parentSourceCache.keys().next().value;
+      parentSourceCache.delete(firstKey);
+    }
+  }
+  return v;
+}
+
+function hasParentSource(key) {
+  return parentSourceCache.has(key);
+}
+
+/**
+ * Retrieve a compiled template from cache or compile it and store.
+ * @param {string} templateStr – template source
+ * @param {object} compileOptions – options passed to compile()
+ * @param {function} compileFn – the original compile function from src/index.js
+ * @returns {object} compiled template object
+ */
+function getCompiled(templateStr, compileOptions, compileFn) {
+  // Build a cache key that ignores non-serializable option values
+  // (e.g. functions like urlHelper, custom callbacks) — those don't
+  // affect template compilation, only render behavior.
+  const serializable = {};
+  for (const [k, v] of Object.entries(compileOptions || {})) {
+    if (typeof v === 'function' || typeof v === 'undefined') continue;
+    serializable[k] = v;
+  }
+  const key = JSON.stringify({ templateStr, compileOptions: serializable });
+  if (cache.has(key)) {
+    // Move to end to mark as recently used
+    const value = cache.get(key);
+    cache.delete(key);
+    cache.set(key, value);
+    return value;
+  }
+  const compiled = compileFn(templateStr, compileOptions);
+  cache.set(key, compiled);
+  // Trim if we exceed limit
+  if (cache.size > CACHE_LIMIT) {
+    const firstKey = cache.keys().next().value;
+    cache.delete(firstKey);
+  }
+  return compiled;
+}
+
+/** Clear the cache – useful for tests */
+function clearCache() {
+  cache.clear();
+  parentSourceCache.clear();
+}
+
+module.exports = { getCompiled, clearCache, getParentSource, hasParentSource };