miki-template 1.2.0 → 1.3.3

package/miki-template-extension/tests/grammar-tests.json

@@ -0,0 +1,162 @@
+{
+  "grammarTests": [
+    {
+      "name": "Basic template structure",
+      "input": "{% extends \"base.html\" %}\n{% block content %}\n{{ title }}\n{% endblock %}",
+      "expectedTokens": [
+        { "line": 0, "scope": "meta.tag.django" },
+        { "line": 0, "scope": "entity.name.tag.django" },
+        { "line": 1, "scope": "meta.tag.django" },
+        { "line": 2, "scope": "meta.variable.django" },
+        { "line": 2, "scope": "support.function.django" }
+      ]
+    },
+    {
+      "name": "If/else/endif tags",
+      "input": "{% if user.is_authenticated %}\n  <p>Hello</p>\n{% else %}\n  <p>Login</p>\n{% endif %}",
+      "expectedTags": ["if", "else", "endif"]
+    },
+    {
+      "name": "For loop with empty",
+      "input": "{% for item in items %}\n  {{ item }}\n{% empty %}\n  No items\n{% endfor %}",
+      "expectedTags": ["for", "empty", "endfor"]
+    },
+    {
+      "name": "Filter chain",
+      "input": "{{ name|lower|capfirst|truncatewords:10 }}",
+      "expectedFilters": ["lower", "capfirst", "truncatewords"]
+    },
+    {
+      "name": "Comment block",
+      "input": "{# This is a comment #}",
+      "scope": "comment.block.django"
+    },
+    {
+      "name": "Prettier ignore",
+      "input": "{# prettier-ignore #}",
+      "scope": "meta.prettier-ignore.django"
+    },
+    {
+      "name": "Include with context",
+      "input": "{% include \"partial.html\" with user=user %}",
+      "expectedTags": ["include"]
+    },
+    {
+      "name": "Partialdef and partial",
+      "input": "{% partialdef card %}\n<div>{{ title }}</div>\n{% endpartialdef %}\n{% partial card %}",
+      "expectedTags": ["partialdef", "endpartialdef", "partial"]
+    },
+    {
+      "name": "i18n tags",
+      "input": "{% trans \"Hello\" %}\n{% blocktrans with name=user.name %}\n  {{ name }}\n{% endblocktrans %}",
+      "expectedTags": ["trans", "blocktrans", "endblocktrans"]
+    },
+    {
+      "name": "Operators",
+      "input": "{% if user.age >= 18 and user.is_verified or user.is_admin %}",
+      "expectedOperators": ["and", "or"]
+    },
+    {
+      "name": "Cycle tag",
+      "input": "{% cycle 'odd' 'even' as marker silent %}",
+      "expectedTags": ["cycle"]
+    },
+    {
+      "name": "Widthratio",
+      "input": "{% widthratio this_value max_value 100 %}",
+      "expectedTags": ["widthratio"]
+    },
+    {
+      "name": "Cache tag",
+      "input": "{% cache 500 my_key %}\n{{ content }}\n{% endcache %}",
+      "expectedTags": ["cache", "endcache"]
+    },
+    {
+      "name": "Spaceless",
+      "input": "{% spaceless %}\n  <p>   </p>\n{% endspaceless %}",
+      "expectedTags": ["spaceless", "endspaceless"]
+    },
+    {
+      "name": "Autoescape",
+      "input": "{% autoescape off %}\n{{ html|safe }}\n{% endautoescape %}",
+      "expectedTags": ["autoescape", "endautoescape"]
+    },
+    {
+      "name": "With block",
+      "input": "{% with user.profile as profile %}\n  {{ profile.name }}\n{% endwith %}",
+      "expectedTags": ["with", "endwith"]
+    },
+    {
+      "name": "Regroup",
+      "input": "{% regroup items by category as grouped %}\n{% for group in grouped %}\n  {{ group.grouper }}\n{% endfor %}",
+      "expectedTags": ["regroup"]
+    },
+    {
+      "name": "Block.super",
+      "input": "{% block content %}\n  {{ block.super }}\n{% endblock %}",
+      "expectedTokens": [{ "scope": "variable.other.django" }]
+    },
+    {
+      "name": "CSRF token",
+      "input": "{% csrf_token %}",
+      "expectedTags": ["csrf_token"]
+    },
+    {
+      "name": "Static tag",
+      "input": "{% static \"css/style.css\" %}",
+      "expectedTags": ["static"]
+    },
+    {
+      "name": "URL tag",
+      "input": "{% url \"home\" user.id %}",
+      "expectedTags": ["url"]
+    },
+    {
+      "name": "Debug tag",
+      "input": "{% debug %}",
+      "expectedTags": ["debug"]
+    },
+    {
+      "name": "Verbatim",
+      "input": "{% verbatim %}\n  {{ not_a_variable }}\n  {% not_a_tag %}\n{% endverbatim %}",
+      "expectedTags": ["verbatim", "endverbatim"]
+    },
+    {
+      "name": "Filter block",
+      "input": "{% filter upper %}\n  {{ name }}\n{% endfilter %}",
+      "expectedTags": ["filter", "endfilter"]
+    },
+    {
+      "name": "Template tag symbol",
+      "input": "{% templatetag openblock %}",
+      "expectedTags": ["templatetag"]
+    },
+    {
+      "name": "Addtoblock",
+      "input": "{% addtoblock css %}\n.selector { color: red; }\n{% endaddtoblock %}",
+      "expectedTags": ["addtoblock", "endaddtoblock"]
+    }
+  ],
+  "validationTests": [
+    {
+      "name": "Unclosed if tag",
+      "input": "{% if condition %}\n  content\n{% endfor %}",
+      "expectedErrors": ["Unclosed tag: {% if %}"]
+    },
+    {
+      "name": "Mismatched tags",
+      "input": "{% if condition %}\n  content\n{% endfor %}",
+      "expectedErrors": ["Mismatched tag: expected {% endif %} but found {% endfor %}"]
+    },
+    {
+      "name": "Extends not first",
+      "input": "{% if true %}\n{% extends \"base.html\" %}\n{% endif %}",
+      "expectedErrors": ["{% extends %} must be the first tag"]
+    },
+    {
+      "name": "Tag after extends",
+      "input": "{% extends \"base.html\" %}\n{% if true %}\n{% include \"other.html\" %}\n{% endif %}",
+      "expectedErrors": []
+    }
+  ]
+}

package/miki-template-extension/tests/run-grammar-tests.js

@@ -0,0 +1,82 @@
+const fs = require('fs');
+const path = require('path');
+
+const grammarTests = JSON.parse(fs.readFileSync(__dirname + '/grammar-tests.json', 'utf8'));
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running grammar tests...\n');
+
+grammarTests.grammarTests.forEach(test => {
+  try {
+    console.log(`Test: ${test.name}`);
+
+    if (test.input) {
+      console.log(`  Input: ${test.input.substring(0, 50)}${test.input.length > 50 ? '...' : ''}`);
+    }
+
+    if (test.expectedTags) {
+      const missing = test.expectedTags.filter(tag => !test.input.includes(`{% ${tag}`));
+      if (missing.length > 0) {
+        console.log(`  FAIL: Missing tags: ${missing.join(', ')}`);
+        failed++;
+        return;
+      }
+    }
+
+    if (test.expectedFilters) {
+      const missing = test.expectedFilters.filter(f => !test.input.includes(`|${f}`));
+      if (missing.length > 0) {
+        console.log(`  FAIL: Missing filters: ${missing.join(', ')}`);
+        failed++;
+        return;
+      }
+    }
+
+    if (test.expectedOperators) {
+      const missing = test.expectedOperators.filter(op => !test.input.includes(op));
+      if (missing.length > 0) {
+        console.log(`  FAIL: Missing operators: ${missing.join(', ')}`);
+        failed++;
+        return;
+      }
+    }
+
+    console.log('  PASS');
+    passed++;
+  } catch (err) {
+    console.log(`  ERROR: ${err.message}`);
+    failed++;
+  }
+});
+
+console.log('\nValidation tests...\n');
+
+grammarTests.validationTests.forEach(test => {
+  try {
+    console.log(`Test: ${test.name}`);
+    console.log(`  Input: ${test.input.substring(0, 50)}${test.input.length > 50 ? '...' : ''}`);
+
+    // Simple validation checks
+    if (test.input.includes('{% extends') && test.input.indexOf('{% extends') > 0) {
+      const firstNonWhitespace = test.input.match(/^\s*({%)/);
+      if (firstNonWhitespace && firstNonWhitespace.index > 0) {
+        console.log(`  PASS: Detected extends not first`);
+        passed++;
+      }
+    }
+
+    console.log('  PASS');
+    passed++;
+  } catch (err) {
+    console.log(`  ERROR: ${err.message}`);
+    failed++;
+  }
+});
+
+console.log(`\n========================================`);
+console.log(`Tests: ${passed} passed, ${failed} failed`);
+console.log(`========================================`);
+
+process.exit(failed > 0 ? 1 : 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miki-template",
-  "version": "1.2.0",
+  "version": "1.3.3",
   "description": "Django-Style template engine for Node.js and Express",
   "main": "src/index.js",
   "exports": {
@@ -11,7 +11,7 @@
     }
   },
   "scripts": {
-    "test": "node -e \"const fs=require('fs');const path=require('path');const files=fs.readdirSync('tests').filter(f=>f.endsWith('.test.js')||f.endsWith('.test.mjs')).map(f=>path.join('tests',f));require('child_process').execSync('node --test '+files.join(' '),{stdio:'inherit'})\"",
+    "test": "node -e \"const fs=require('fs');const path=require('path');function walk(d){const out=[];for(const e of fs.readdirSync(d,{withFileTypes:true})){const p=path.join(d,e.name);if(e.isDirectory())out.push(...walk(p));else if(/\\\\.test\\\\.(cjs|mjs|js)$/.test(e.name))out.push(p);}return out;}const files=walk('tests');require('child_process').execSync('node --test '+files.join(' '),{stdio:'inherit'})\"",
     "bench": "node benchmarks/run.js"
   },
   "keywords": [
@@ -25,7 +25,10 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "he": "^1.2.0",
-    "date-fns": "^3.6.0"
+    "date-fns": "^3.6.0",
+    "he": "^1.2.0"
+  },
+  "devDependencies": {
+    "express": "^5.2.1"
   }
 }

package/scripts/build-vsix.js

@@ -0,0 +1,129 @@
+const fs = require('fs');
+const path = require('path');
+const zlib = require('zlib');
+
+const extDir = 'miki-template-extension';
+const buildDir = 'miki-template-extension/.vsix-build';
+const vsixPath = 'miki-template-1.2.0.vsix';
+
+if (fs.existsSync(buildDir)) fs.rmSync(buildDir, { recursive: true });
+if (fs.existsSync(vsixPath)) fs.unlinkSync(vsixPath);
+
+fs.mkdirSync(buildDir, { recursive: true });
+const extTarget = path.join(buildDir, 'extension');
+fs.mkdirSync(extTarget, { recursive: true });
+
+function copyDirSync(src, dest) {
+  fs.readdirSync(src).forEach(item => {
+    const s = path.join(src, item);
+    const d = path.join(dest, item);
+    if (fs.statSync(s).isDirectory()) {
+      fs.mkdirSync(d, { recursive: true });
+      copyDirSync(s, d);
+    } else {
+      fs.copyFileSync(s, d);
+    }
+  });
+}
+
+copyDirSync(extDir, extTarget);
+
+const manifest = '<?xml version="1.0" encoding="utf-8"?><PackageManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011"><Metadata><Identity Id="alainmiki.miki-template" Version="1.2.0" Language="en-US" Publisher="alainmiki" /><DisplayName>miki-template</DisplayName><Description>Django-style template language syntax highlighting and snippets for miki-template</Description><Tags>django template miki syntax highlight snippet</Tags><Categories>Programming Languages,Snippets</Categories><GalleryFlags>Public</GalleryFlags><License>LICENSE</License><Icon>extension/icon.png</Icon></Metadata><Installation><InstallationTarget Id="Microsoft.VisualStudio.Code" /></Installation><Dependencies /><Assets><Asset Type="Microsoft.VisualStudio.Code.Manifest" Path="extension/package.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Content" Path="extension/syntaxes/miki-template.tmLanguage.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Content" Path="extension/syntaxes/language-configuration.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Snippet" Path="extension/snippets/miki-template.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Image" Path="extension/icon.png" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Image" Path="extension/icon.svg" Addressable="true" /></Assets></PackageManifest>';
+const ct = '<?xml version="1.0" encoding="utf-8"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="json" ContentType="application/json" /><Default Extension="png" ContentType="image/png" /><Default Extension="svg" ContentType="image/svg+xml" /><Default Extension="md" ContentType="text/markdown" /></Types>';
+fs.writeFileSync(path.join(buildDir, 'extension.vsixmanifest'), manifest);
+fs.writeFileSync(path.join(buildDir, '[Content_Types].xml'), ct);
+
+const files = [];
+function collectFiles(dir, base) {
+  fs.readdirSync(dir).forEach(item => {
+    const s = path.join(dir, item);
+    const d = path.join(base, item);
+    if (fs.statSync(s).isDirectory()) {
+      collectFiles(s, d);
+    } else {
+      files.push({ path: d, content: fs.readFileSync(s) });
+    }
+  });
+}
+collectFiles(buildDir, '');
+
+function crc32(buf) {
+  let crc = 0xFFFFFFFF;
+  const table = new Uint32Array(256);
+  for (let i = 0; i < 256; i++) {
+    let c = i;
+    for (let j = 0; j < 8; j++) c = (c & 1) ? (0xEDB88320 ^ (c >>> 1)) : (c >>> 1);
+    table[i] = c;
+  }
+  for (let i = 0; i < buf.length; i++) crc = table[(crc ^ buf[i]) & 0xFF] ^ (crc >>> 8);
+  return (crc ^ 0xFFFFFFFF) >>> 0;
+}
+
+const localFiles = [];
+const centralDir = [];
+let offset = 0;
+
+for (const file of files) {
+  const pathBytes = Buffer.from(file.path);
+  const data = file.content;
+  const compressed = zlib.deflateSync(data);
+  const crc = crc32(data);
+  
+  const localHeader = Buffer.alloc(30);
+  localHeader.writeUInt32LE(0x04034b50, 0);
+  localHeader.writeUInt16LE(20, 4);
+  localHeader.writeUInt16LE(0, 6);
+  localHeader.writeUInt16LE(8, 8);
+  localHeader.writeUInt16LE(0, 10);
+  localHeader.writeUInt16LE(0, 12);
+  localHeader.writeUInt32LE(crc, 14);
+  localHeader.writeUInt32LE(compressed.length, 18);
+  localHeader.writeUInt32LE(data.length, 22);
+  localHeader.writeUInt16LE(pathBytes.length, 26);
+  localHeader.writeUInt16LE(0, 28);
+  
+  const localFile = Buffer.concat([localHeader, pathBytes, compressed]);
+  localFiles.push(localFile);
+  
+  const centralHeader = Buffer.alloc(46);
+  centralHeader.writeUInt32LE(0x02014b50, 0);
+  centralHeader.writeUInt16LE(20, 4);
+  centralHeader.writeUInt16LE(20, 6);
+  centralHeader.writeUInt16LE(0, 8);
+  centralHeader.writeUInt16LE(8, 10);
+  centralHeader.writeUInt16LE(0, 12);
+  centralHeader.writeUInt16LE(0, 14);
+  centralHeader.writeUInt32LE(crc, 16);
+  centralHeader.writeUInt32LE(compressed.length, 20);
+  centralHeader.writeUInt32LE(data.length, 24);
+  centralHeader.writeUInt16LE(pathBytes.length, 28);
+  centralHeader.writeUInt16LE(0, 30);
+  centralHeader.writeUInt16LE(0, 32);
+  centralHeader.writeUInt16LE(0, 34);
+  centralHeader.writeUInt16LE(0, 36);
+  centralHeader.writeUInt32LE(0, 38);
+  centralHeader.writeUInt32LE(offset, 42);
+  
+  const centralEntry = Buffer.concat([centralHeader, pathBytes]);
+  centralDir.push(centralEntry);
+  
+  offset += localFile.length;
+}
+
+const centralDirOffset = offset;
+const centralDirSize = centralDir.reduce((sum, entry) => sum + entry.length, 0);
+const endRecord = Buffer.alloc(22);
+endRecord.writeUInt32LE(0x06054b50, 0);
+endRecord.writeUInt16LE(0, 4);
+endRecord.writeUInt16LE(0, 6);
+endRecord.writeUInt16LE(centralDir.length, 8);
+endRecord.writeUInt16LE(centralDir.length, 10);
+endRecord.writeUInt32LE(centralDirSize, 12);
+endRecord.writeUInt32LE(centralDirOffset, 16);
+endRecord.writeUInt16LE(0, 20);
+
+const zipBuffer = Buffer.concat([...localFiles, ...centralDir, endRecord]);
+fs.writeFileSync(vsixPath, zipBuffer);
+
+if (fs.existsSync(buildDir)) fs.rmSync(buildDir, { recursive: true });
+console.log('VSIX created:', vsixPath, 'size:', zipBuffer.length);

package/scripts/build-vsix.ps1

@@ -0,0 +1,15 @@
+$ErrorActionPreference = 'Stop'
+$extDir = Join-Path $PWD 'miki-template-extension'
+$vsixPath = Join-Path $PWD 'miki-template-1.2.0.vsix'
+if (Test-Path $vsixPath) { Remove-Item $vsixPath -Force }
+$tempDir = Join-Path $env:TEMP ('vsix-build-' + [Guid]::NewGuid().ToString('N').Substring(0,8))
+New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+$extTarget = Join-Path $tempDir 'extension'
+Copy-Item -Path $extDir -Destination $extTarget -Recurse -Force
+$manifest = '<?xml version="1.0" encoding="utf-8"?><PackageManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011"><Metadata><Identity Id="alainmiki.miki-template" Version="1.2.0" Language="en-US" Publisher="alainmiki" /><DisplayName>miki-template</DisplayName><Description>Django-style template language syntax highlighting and snippets for miki-template</Description><Tags>django template miki syntax highlight snippet</Tags><Categories>Programming Languages,Snippets</Categories><GalleryFlags>Public</GalleryFlags><License>LICENSE</License><Icon>extension/icon.png</Icon></Metadata><Installation><InstallationTarget Id="Microsoft.VisualStudio.Code" /></Installation><Dependencies /><Assets><Asset Type="Microsoft.VisualStudio.Code.Manifest" Path="extension/package.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Content" Path="extension/syntaxes/miki-template.tmLanguage.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Content" Path="extension/syntaxes/language-configuration.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Snippet" Path="extension/snippets/miki-template.json" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Image" Path="extension/icon.png" Addressable="true" /><Asset Type="Microsoft.VisualStudio.Code.Image" Path="extension/icon.svg" Addressable="true" /></Assets></PackageManifest>'
+Set-Content -Path (Join-Path $tempDir 'extension.vsixmanifest') -Value $manifest -Encoding UTF8
+$ct = '<?xml version="1.0" encoding="utf-8"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="json" ContentType="application/json" /><Default Extension="png" ContentType="image/png" /><Default Extension="svg" ContentType="image/svg+xml" /><Default Extension="md" ContentType="text/markdown" /></Types>'
+Set-Content -Path (Join-Path $tempDir '[Content_Types].xml') -Value $ct -Encoding UTF8
+Compress-Archive -Path (Join-Path $tempDir '*') -DestinationPath $vsixPath -Force
+Remove-Item $tempDir -Recurse -Force
+Write-Host "VSIX created at $vsixPath"

package/src/cache.js

@@ -7,6 +7,36 @@
 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
@@ -15,7 +45,15 @@ const cache = new Map();
  * @returns {object} compiled template object
  */
 function getCompiled(templateStr, compileOptions, compileFn) {
-  const key = JSON.stringify({ templateStr, compileOptions });
+  // 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);
@@ -36,6 +74,7 @@ function getCompiled(templateStr, compileOptions, compileFn) {
 /** Clear the cache – useful for tests */
 function clearCache() {
   cache.clear();
+  parentSourceCache.clear();
 }
 
-module.exports = { getCompiled, clearCache };
+module.exports = { getCompiled, clearCache, getParentSource, hasParentSource };

package/src/context.js

@@ -52,7 +52,7 @@ class Context {
     const parts = path.split('.');
     const baseName = parts[0];
 
-    let current = null;
+    let current = undefined;
     let found = false;
 
     // Search scopes from top (most local) to bottom (most global)
@@ -65,13 +65,16 @@ class Context {
     }
 
     if (!found) {
-      return '';
+      // Variable truly missing — return undefined so templates can
+      // distinguish "missing" from "explicitly null". The variable node
+      // and filters handle undefined gracefully.
+      return undefined;
     }
 
     // Traverse the rest of the dotted segments
     for (let i = 1; i < parts.length; i++) {
       if (current === undefined || current === null) {
-        return '';
+        return current === null ? null : undefined;
       }
 
       const parent = current;
@@ -84,7 +87,7 @@ class Context {
         // Handle array index resolution, e.g. items.0
         current = current[parseInt(part, 10)];
       } else {
-        return '';
+        return undefined;
       }
 
       // If the property value is a function, evaluate it (Django style)
@@ -98,7 +101,8 @@ class Context {
       current = current.call(null);
     }
 
-    return current !== undefined && current !== null ? current : '';
+    // Preserve null/undefined so filters like default_if_none can detect them.
+    return current;
   }
 
   /**

package/src/context_processors.js

@@ -25,14 +25,21 @@ function clearContextProcessors() {
 
 /**
  * Apply all registered processors to the given context object.
- * Mutates the context object by merging any returned values.
+ * Values returned by a processor that are already defined in the
+ * context are kept as-is (Django-style "existing values win" semantics
+ * so explicit render-time data always takes precedence over processor
+ * defaults).
  * @param {Object} ctx
  */
 function applyContextProcessors(ctx) {
   for (const fn of processors) {
     const result = fn(ctx);
     if (result && typeof result === 'object') {
-      Object.assign(ctx, result);
+      for (const [k, v] of Object.entries(result)) {
+        if (ctx[k] === undefined) {
+          ctx[k] = v;
+        }
+      }
     }
   }
   return ctx;

package/src/esm.mjs

@@ -11,14 +11,20 @@ const {
   compile,
   render,
   asyncRender,
+  renderPartialFromFile,
+  renderPartialFromSource,
   __express,
   __expressAsync,
+  express,
+  setupExpress,
+  expressPartialRenderer,
   stripExpressContext,
   clearCache,
   registerTag,
   registerFilter,
   registerHelper,
   registerContextProcessor,
+  clearContextProcessors,
   registerTranslation,
   unregisterTranslation,
   setLanguage,
@@ -42,14 +48,20 @@ export {
   compile,
   render,
   asyncRender,
+  renderPartialFromFile,
+  renderPartialFromSource,
   __express,
   __expressAsync,
+  express,
+  setupExpress,
+  expressPartialRenderer,
   stripExpressContext,
   clearCache,
   registerTag,
   registerFilter,
   registerHelper,
   registerContextProcessor,
+  clearContextProcessors,
   registerTranslation,
   unregisterTranslation,
   setLanguage,