miki-template 1.3.7 → 2.0.1

package/live-test/package-lock.json

@@ -9,9 +9,60 @@
       "version": "1.0.0",
       "dependencies": {
         "express": "^5.2.1",
-        "miki-template": "1.3.6"
+        "miki-template": "file:../miki-template-2.0.0.tgz"
+      },
+      "devDependencies": {
+        "elysia": "^1.4.30",
+        "hono": "^4.13.7"
       }
     },
+    "node_modules/@borewit/text-codec": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/@borewit/text-codec/-/text-codec-0.2.2.tgz",
+      "integrity": "sha512-DDaRehssg1aNrH4+2hnj1B7vnUGEjU6OIlyRdkMd0aUdIUvKXrJfXsy8LVtXAy7DRvYVluWbMspsRhz2lcW0mQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
+    "node_modules/@sinclair/typebox": {
+      "version": "0.34.52",
+      "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.52.tgz",
+      "integrity": "sha512-XiMQh7qqVlxZzcVD+kkGMNGMzcTrDMLWI7S4x7z1MkCkbDPrekpZXEUK0eZqZFMuHQg2a2DZOcDIh9o5v3Gonw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tokenizer/inflate": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/@tokenizer/inflate/-/inflate-0.4.1.tgz",
+      "integrity": "sha512-2mAv+8pkG6GIZiF1kNg1jAjh27IDxEPKwdGul3snfztFerfPGI1LjDezZp3i7BElXompqEtPmoPx6c2wgtWsOA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "debug": "^4.4.3",
+        "token-types": "^6.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
+    "node_modules/@tokenizer/token": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/@tokenizer/token/-/token-0.3.0.tgz",
+      "integrity": "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
     "node_modules/accepts": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
@@ -196,6 +247,49 @@
       "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
       "license": "MIT"
     },
+    "node_modules/elysia": {
+      "version": "1.4.30",
+      "resolved": "https://registry.npmjs.org/elysia/-/elysia-1.4.30.tgz",
+      "integrity": "sha512-S2qqV0CbM4faB1hQQ5IYoeYnAUinjHlzRduxaBc4OoNqh0GjOc8k6tt3hv5ozWcG6Svr6hugw6JL4zNke4jwfA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cookie": "^1.1.1",
+        "exact-mirror": "^0.2.7",
+        "fast-decode-uri-component": "^1.0.1",
+        "memoirist": "^0.4.0"
+      },
+      "peerDependencies": {
+        "@sinclair/typebox": ">= 0.34.0 < 1",
+        "@types/bun": ">= 1.2.0",
+        "exact-mirror": ">= 0.0.9",
+        "file-type": ">= 20.0.0",
+        "openapi-types": ">= 12.0.0",
+        "typescript": ">= 5.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/bun": {
+          "optional": true
+        },
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/elysia/node_modules/cookie": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz",
+      "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/encodeurl": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
@@ -250,6 +344,21 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/exact-mirror": {
+      "version": "0.2.7",
+      "resolved": "https://registry.npmjs.org/exact-mirror/-/exact-mirror-0.2.7.tgz",
+      "integrity": "sha512-+MeEmDcLA4o/vjK2zujgk+1VTxPR4hdp23qLqkWfStbECtAq9gmsvQa3LW6z/0GXZyHJobrCnmy1cdeE7BjsYg==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@sinclair/typebox": "^0.34.15"
+      },
+      "peerDependenciesMeta": {
+        "@sinclair/typebox": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/express": {
       "version": "5.2.1",
       "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
@@ -293,6 +402,33 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/fast-decode-uri-component": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/fast-decode-uri-component/-/fast-decode-uri-component-1.0.1.tgz",
+      "integrity": "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/file-type": {
+      "version": "22.0.2",
+      "resolved": "https://registry.npmjs.org/file-type/-/file-type-22.0.2.tgz",
+      "integrity": "sha512-0H8TsCUGBLx+V5adH3EY52hTAcyLKbV1D4gq5cIOJ6DnQAHeV9Z2Hhuc5CoBX4YmvB2oL+JIC84z0qO7JsCoNw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@tokenizer/inflate": "^0.4.1",
+        "strtok3": "^10.3.5",
+        "token-types": "^6.1.2",
+        "uint8array-extras": "^1.5.0"
+      },
+      "engines": {
+        "node": ">=22"
+      },
+      "funding": {
+        "url": "https://github.com/sindresorhus/file-type?sponsor=1"
+      }
+    },
     "node_modules/finalhandler": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
@@ -423,6 +559,16 @@
         "he": "bin/he"
       }
     },
+    "node_modules/hono": {
+      "version": "4.13.7",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.13.7.tgz",
+      "integrity": "sha512-c8/gF9ac8Y78/agExVocyLevgR+JlpNB444Py0FSX8pJoPdYUfUzRcXtYEYGwt6l19qIlVZPN5Mfsw9jFShmQQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.9.0"
+      }
+    },
     "node_modules/http-errors": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
@@ -459,6 +605,28 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause",
+      "peer": true
+    },
     "node_modules/inherits": {
       "version": "2.0.4",
       "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
@@ -502,6 +670,13 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/memoirist": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/memoirist/-/memoirist-0.4.0.tgz",
+      "integrity": "sha512-zxTgA0mSYELa66DimuNQDvyLq36AwDlTuVRbnQtB+VuTcKWm5Qc4z3WkSpgsFWHNhexqkIooqpv4hdcqrX5Nmg==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/merge-descriptors": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
@@ -515,9 +690,9 @@
       }
     },
     "node_modules/miki-template": {
-      "version": "1.3.6",
-      "resolved": "https://registry.npmjs.org/miki-template/-/miki-template-1.3.6.tgz",
-      "integrity": "sha512-xB658VrwCMAg8abpMzKF8ZKlnYgMaX7eimpxSx/GR35sor5kW/bhqiYr54HXpNux3d0Qgv7uUPszid3MFYcpSA==",
+      "version": "1.3.7",
+      "resolved": "file:../miki-template-2.0.0.tgz",
+      "integrity": "sha512-FGTWjPS3CTm3X4+dnRKqHwqQUKgqtz/0VNTjN1BQjBcgwhXnEbVYg06VZmBtZ8SYr6z12JIX3LGj2pQog3h84Q==",
       "license": "MIT",
       "dependencies": {
         "date-fns": "^3.6.0",
@@ -617,6 +792,14 @@
         "wrappy": "1"
       }
     },
+    "node_modules/openapi-types": {
+      "version": "12.1.3",
+      "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz",
+      "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -847,6 +1030,24 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/strtok3": {
+      "version": "10.3.5",
+      "resolved": "https://registry.npmjs.org/strtok3/-/strtok3-10.3.5.tgz",
+      "integrity": "sha512-ki4hZQfh5rX0QDLLkOCj+h+CVNkqmp/CMf8v8kZpkNVK6jGQooMytqzLZYUVYIZcFZ6yDB70EfD8POcFXiF5oA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@tokenizer/token": "^0.3.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
     "node_modules/toidentifier": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
@@ -856,6 +1057,26 @@
         "node": ">=0.6"
       }
     },
+    "node_modules/token-types": {
+      "version": "6.1.2",
+      "resolved": "https://registry.npmjs.org/token-types/-/token-types-6.1.2.tgz",
+      "integrity": "sha512-dRXchy+C0IgK8WPC6xvCHFRIWYUbqqdEIKPaKo/AcTUNzwLTK6AH7RjdLWsEZcAN/TBdtfUw3PYEgPr5VPr6ww==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@borewit/text-codec": "^0.2.1",
+        "@tokenizer/token": "^0.3.0",
+        "ieee754": "^1.2.1"
+      },
+      "engines": {
+        "node": ">=14.16"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Borewit"
+      }
+    },
     "node_modules/type-is": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz",
@@ -887,6 +1108,20 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/uint8array-extras": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/uint8array-extras/-/uint8array-extras-1.5.0.tgz",
+      "integrity": "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/unpipe": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",

package/live-test/package.json

@@ -4,6 +4,10 @@
   "private": true,
   "dependencies": {
     "express": "^5.2.1",
-    "miki-template": "1.3.6"
+    "miki-template": "file:../miki-template-2.0.0.tgz"
+  },
+  "devDependencies": {
+    "elysia": "^1.4.30",
+    "hono": "^4.13.7"
   }
 }

package/live-test/packages/product/templates/product/detail.html

@@ -0,0 +1,7 @@
+<html>
+<head><title>Product Detail</title></head>
+<body>
+  <h1>Product: {{ name }}</h1>
+  <p>Price: {{ price }}</p>
+</body>
+</html>

package/live-test/server.js

@@ -4,11 +4,35 @@ const miki = require('miki-template');
 
 const app = express();
 const views = path.join(__dirname, 'views');
+const templatesRoot = path.join(__dirname, 'templates');
 
-miki.setupExpress(app, { extension: 'html', views });
+// Demonstrate multiple discovery roots: explicit views dir,
+// plus a top-level `templates/` (Django-style) and app-style nested folders
+// discovered anywhere under the project root.
+miki.setupExpress(app, { extension: 'html', views: [views, templatesRoot, __dirname] });
+
+// Note: `miki.setupExpress` may expand `app.get('views')` to include
+// nested template directories (project-level `templates/`,
+// app-style `packages/*/templates/...`, etc.). The live-test app
+// intentionally passed multiple roots to demonstrate discovery.
 
 app.get('/', (req, res) => {
   res.render('index', { name: 'Live NPM' });
 });
 
+// Render a nested child template that extends base.html located in views/
+app.get('/child', (req, res) => {
+  res.render('child', { title: 'From Live', message: 'Hello from child' });
+});
+
+// Render a template located under templates/app_templates/detail.html
+
+app.get('/app-detail', (req, res) => {
+  res.render('detail', { item: 'Widget 42' });
+});
+
+app.get('/product', (req, res) => {
+  res.render('product/detail', { name: 'Gizmo', price: '$19.99' });
+});
+
 app.listen(3002, () => console.log('Live test app listening on 3002'));

package/live-test/templates/app_templates/detail.html

@@ -0,0 +1,6 @@
+<html>
+<head><title>App Template</title></head>
+<body>
+  <h1>App-level template: {{ item }}</h1>
+</body>
+</html>

package/live-test/views/home.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Home</title>
+  </head>
+  <body>
+    <h1>Welcome, {{ user }}</h1>
+
+    {% partialdef card %}
+    <div class="card">Card: {{ title }}</div>
+    {% endpartialdef %}
+
+    <div id="content">
+      {% partial card %}
+    </div>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miki-template",
-  "version": "1.3.7",
+  "version": "2.0.1",
   "description": "Django-Style template engine for Node.js and Express",
   "main": "src/index.js",
   "exports": {
@@ -16,7 +16,11 @@
     "engine",
     "express",
     "nodejs",
-    "esm"
+    "bun",
+    "esm",
+    "koa",
+    "fastify",
+    "nestjs"
   ],
   "author": "",
   "license": "MIT",
@@ -25,10 +29,14 @@
     "he": "^1.2.0"
   },
   "devDependencies": {
+    "koa": "^3.2.1",
+    "fastify": "^5.12.3",
+    "ejs": "^6.0.1",
+    "eslint": "^8.50.0",
     "express": "^5.2.1",
-    "eslint": "^8.50.0"
-  }
-  ,
+    "handlebars": "^4.7.9",
+    "pug": "^3.0.4"
+  },
   "scripts": {
     "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'})\"",
     "lint": "eslint . -f unix",

package/src/index.js

@@ -894,11 +894,80 @@ function setupExpress(app, opts = {}) {
   // Install the raw engine so Express can use it
   app.engine(ext, async ? __expressAsync : __express);
 
+  // Expand configured view roots to include nested directories that
+  // actually contain template files. Express will only check the
+  // directories returned by `app.get('views')`, so if templates live
+  // inside nested app folders (e.g. `packages/*/templates/...`), we
+  // must include those directories explicitly so `res.render('name')`
+  // succeeds without additional work by users.
+  function expandViewsForExpress(viewsInput, maxDepth = 6) {
+    const seen = new Set();
+    const results = [];
+    const roots = normalizeViews(viewsInput || (app.get && app.get('views')) || ['.']);
+    const isTemplateFile = name => /\.(html|miki)$/i.test(name);
+
+    for (const r of roots) {
+      let rootPath;
+      try { rootPath = path.resolve(r); } catch { continue; }
+      if (seen.has(rootPath)) continue;
+      seen.add(rootPath);
+      // BFS/DFS limited traversal
+      const stack = [{ dir: rootPath, depth: 0 }];
+      while (stack.length) {
+        const cur = stack.pop();
+        let entries;
+        try { entries = fs.readdirSync(cur.dir, { withFileTypes: true }); } catch { continue; }
+        let hasTemplate = false;
+        for (const ent of entries) {
+          if (ent.isFile() && isTemplateFile(ent.name)) {
+            hasTemplate = true;
+            break;
+          }
+        }
+        if (hasTemplate) {
+          if (!seen.has(cur.dir)) {
+            seen.add(cur.dir);
+            results.push(cur.dir);
+          }
+        }
+        if (cur.depth < maxDepth) {
+          for (const ent of entries) {
+            if (!ent.isDirectory()) continue;
+            const name = ent.name;
+            if (name === 'node_modules' || name === '.git' || name === 'dist' || name === 'build') continue;
+            const child = path.join(cur.dir, name);
+            if (!seen.has(child)) stack.push({ dir: child, depth: cur.depth + 1 });
+          }
+        }
+      }
+      // Always include the root itself so existing layouts still work
+      if (!results.includes(rootPath)) results.unshift(rootPath);
+    }
+    return results;
+  }
+
   // Capture config in a closure so patchedRender can use it even
   // when called before the request handler runs.
   const configExt = ext;
   const configViews = opts.views;
 
+  // Expand and set the app 'views' so Express's resolver can find
+  // templates placed in nested directories. Only do this when a
+  // non-empty views value exists (we don't want to change defaults
+  // if user intentionally left it unset).
+  try {
+    const currentViews = app.get && app.get('views') ? app.get('views') : configViews || app.get && app.get('views');
+    if (currentViews) {
+      const expanded = expandViewsForExpress(currentViews);
+      if (expanded && expanded.length) {
+        app.set('views', expanded);
+      }
+    }
+  } catch (e) {
+    // Don't crash setupExpress if view expansion fails; fallback to
+    // whatever the app already had configured.
+  }
+
   // Capture the original res.render so we can dispatch on #partial
   const originalRender = app.response.render;
   app.response.render = function patchedRender(view, locals, callback) {
@@ -951,9 +1020,19 @@ function setupExpress(app, opts = {}) {
           break;
         }
       }
-      // Fallback: recursive search for templates in subfolders
+      // Fallback: recursive search for templates in subfolders. If
+      // the configured views is an array, search all normalized
+      // entries rather than only the first directory so app-style
+      // templates under other roots are discovered.
       if (!filePath) {
-        const found = findTemplateInViews(fileName, [viewsDir]);
+        let searchDirs = [viewsDir];
+        if (Array.isArray(viewsDir)) {
+          searchDirs = normalizeViews(viewsDir);
+        } else if (Array.isArray(configViews)) {
+          // If setupExpress was given an array, include its normalized form
+          searchDirs = normalizeViews(configViews);
+        }
+        const found = findTemplateInViews(fileName, searchDirs);
         if (found) filePath = found;
       }
       if (!filePath) {
@@ -984,11 +1063,55 @@ function setupExpress(app, opts = {}) {
       }
     }
 
-    // No partial selector: behave exactly like the original res.render
-    if (cb) {
-      return originalRender.call(this, view, opts, cb);
+    // No partial selector: behave exactly like the original res.render.
+    // If Express fails to locate the view (no recursive lookup),
+    // fall back to our recursive/app-style finder and invoke the
+    // engine directly with the resolved file path.
+    try {
+      if (cb) {
+        return originalRender.call(this, view, opts, cb);
+      }
+      return originalRender.call(this, view, opts);
+    } catch (err) {
+      // Detect Express view-not-found error and attempt fallback
+      if (err && typeof err.message === 'string' && err.message.includes('Failed to lookup view')) {
+        // Determine normalized view roots to search. Prefer arrays
+        // returned by app.get('views') (Express supports arrays).
+        let roots = [];
+        try {
+          const appViews = this.req && this.req.app ? this.req.app.get('views') : null;
+          if (appViews) roots = roots.concat(Array.isArray(appViews) ? normalizeViews(appViews) : [appViews]);
+        } catch (e) {}
+        if (configViews) roots = roots.concat(Array.isArray(configViews) ? normalizeViews(configViews) : [configViews]);
+        // If expandViewsForExpress was used earlier, app.get('views')
+        // may already be an expanded array of candidate dirs. Ensure
+        // uniqueness and absolute resolution.
+        roots = roots.filter(Boolean).map(r => path.resolve(r));
+        roots = Array.from(new Set(roots));
+
+        // Try to find the template file using our recursive finder.
+        const searchRoots = roots.length ? roots : [process.cwd()];
+        const found = findTemplateInViews(view, searchRoots);
+        if (found) {
+          // Invoke the engine directly with the resolved file path.
+          try {
+            if (cb) return (__express)(found, opts, cb);
+            return __express(found, opts, (err2, html) => {
+              if (err2) {
+                if (cb) return cb(err2);
+                throw err2;
+              }
+              this.send(html);
+            });
+          } catch (e2) {
+            if (cb) return cb(e2);
+            throw e2;
+          }
+        }
+      }
+      // Not our error or fallback failed — rethrow
+      throw err;
     }
-    return originalRender.call(this, view, opts);
   };
 }
 
@@ -1039,9 +1162,20 @@ function expressPartialRenderer() {
           filePath = null;
         } catch { filePath = null; }
       }
-      // Fallback: recursive search for templates in subfolders
+      // Fallback: recursive search for templates in subfolders. Prefer
+      // searching all normalized view roots so templates in sibling
+      // folders (project-level `templates/`, packages/*/templates, etc.)
+      // are found.
       if (!filePath) {
-        const found = findTemplateInViews(fileName, Array.isArray(viewsDir) ? viewsDir : [viewsDir]);
+        let searchDirs = Array.isArray(viewsDir) ? normalizeViews(viewsDir) : [viewsDir];
+        // Also include the app-level configured views array if present
+        try {
+          const appViews = req.app.get('views');
+          if (Array.isArray(appViews)) {
+            searchDirs = searchDirs.concat(normalizeViews(appViews));
+          }
+        } catch (e) {}
+        const found = findTemplateInViews(fileName, searchDirs);
         if (found) filePath = found;
       }
       if (!filePath) {

package/tests/integration/partial-render.test.cjs

@@ -0,0 +1,13 @@
+const test = require('node:test');
+const assert = require('assert');
+const path = require('path');
+const miki = require('../../src/index.js');
+
+test('engine partial render via render() and asyncRender()', async () => {
+  const views = path.resolve(__dirname, '..', '..', 'live-test', 'views');
+  const sync = miki.render('home#card', { user: 'Tester', title: 'T' }, { views });
+  assert.ok(sync.includes('Card'), 'sync partial should contain Card');
+
+  const asyncRes = await miki.asyncRender('home#card', { user: 'Tester', title: 'T' }, { views });
+  assert.ok(asyncRes.includes('Card'), 'async partial should contain Card');
+});