miki-template 1.2.0 → 1.3.3

package/dir/home.html

@@ -0,0 +1,80 @@
+{% extends 'base.html' %}
+
+{% block title %}
+  {{ siteName|default:'Home page Here'|title }} | {{ block.super }}
+{% endblock %}
+
+{% block content %}
+  {% partialdef card  inline %}
+  <div class="card">
+    <h3>{{ title|default:'No title' }}</h3>
+    <p>{{ description|default:'{% lorem 20 %}'|upper }}</p>
+  </div>
+  {% endpartialdef %}
+
+  {% partial card with title='Hello' description='World' %}
+
+  {% with a=5 %}
+    <marquee behavior="" direction="">
+      <span>some new stuff with with tag : {{ a|add:5 }}</span>
+    </marquee>
+  {% endwith %}
+
+  {{ name }}
+  {{ login.name }}
+  {{ login.email }}
+  <h1>Users table goes below</h1>
+  <table border="3">
+    <th>name</th>
+    <th>email</th>
+    <th>action</th>
+
+    {% for user in users %}
+      <tr>
+        <td>{{ user.name|title }}</td>
+        <td>{{ user.email }}</td>
+        <td>
+          <a href="">Delete user</a>
+        </td>
+      </tr>
+    {% endfor %}
+    
+  </table>
+  <h1>Data list</h1>
+  <h2>data list of data</h2>
+  {% for obj in data %}
+    {% partialdef mike inline %}
+
+    <li>{{ obj.name }}</li>
+    <li>{{ forloop.counter }}</li>
+   <li> {{ obj.email }}</li>
+    {% endpartialdef %}
+  {% endfor %}
+
+  <h2>users list of data</h2>
+  <ul style="background-color: aqua;color: blueviolet; list-style-type:upper-roman;">
+
+    {% for obj in users %}
+    {% partial mike %}
+    {% endfor %}
+  </ul>
+
+  <h3>form with crsf</h3>
+
+  <form action="">
+    {% csrf_token %}
+    <input type="text" name="" id="" title="some text"/>
+  </form>
+<h3>included content here</h3>
+  {% include 'cmpnt.html#me' %}
+
+  {{"2324"|filesizeformat}}
+  {{"224"|filesizeformat}}
+  {{ "123456789"|filesizeformat }}
+  {{ "1234567890"|filesizeformat }}
+  {{ "1234567890123"|filesizeformat }}
+  {{ "1234567890123456"|filesizeformat }}
+  {{ "1234567890123456789"|filesizeformat }}
+
+
+{% endblock %}

package/dir/navbar.html

@@ -0,0 +1,9 @@
+<header>
+    <div class="brand">
+        <img src="/path/to/logo.png" alt="Logo" width="40px">
+    </div>
+    <nav>
+        <a href="/">Home</a>
+
+    </nav>
+</header>

package/docs/api.md

@@ -7,8 +7,13 @@ This document lists the public API exported by **miki-template** for developers
 | `compile(templateStr, options?)` | `compile(string, object?) → { render, asyncRender, renderBlock, renderPartial }` | Compiles a template string into a renderable object. Optional `options` can include `views` directories, custom tags/filters, etc. | `const tpl = compile('Hello {{ name }}');` |
 | `render(templateStr, context?, options?)` | `render(string, object?, object?) → string` | One‑off rendering of a template string with the provided context. | `render('Hello {{ name }}', { name: 'World' });` |
 | `asyncRender(templateStr, context?, options?)` | `asyncRender(string, object?, object?) → Promise<string>` | Asynchronous rendering (useful with async helpers). | `await asyncRender(tpl, ctx);` |
-| `__express(filePath, options, callback)` | `__express(string, object, function)` | Express view engine adapter – reads the file at `filePath` and renders it. | `app.set('view engine', 'miki');` |
-| `__expressAsync(filePath, options)` | `__expressAsync(string, object) → Promise<string>` | Async Express 5+ view engine adapter. Returns a Promise that resolves to rendered HTML. | `app.engine('html', miki.__expressAsync);` |
+| `__express(filePath, options, callback)` | `__express(string, object, function)` | Express view engine adapter – reads the file at `filePath` and renders it. Honors `view#partial` suffixes for HTMX-style partial responses. | `app.engine('html', miki.__express);` |
+| `__expressAsync(filePath, options)` | `__expressAsync(string, object) → Promise<string>` | Async Express 5+ view engine adapter. Returns a Promise that resolves to rendered HTML. Also honors `view#partial` suffixes. | `app.engine('html', miki.__expressAsync);` |
+| `express(options?)` | `express(object?) → function` | Factory that returns a view-engine function suitable for `app.engine(...)`. Honors `view#partial` selectors. | `app.engine('html', miki.express());` |
+| `setupExpress(app, opts?)` | `setupExpress(expressApp, object?) → void` | **One-line Express integration.** Wires `app.engine(...)`, `app.set('views')`, and patches `res.render` so `res.render('view#partial', ...)` returns just that partial. Options: `{ extension?, views?, async? }`. | `miki.setupExpress(app, { extension: 'html', views: './views' });` |
+| `expressPartialRenderer()` | `expressPartialRenderer() → function` | Express middleware that adds `res.renderPartial(view, locals)`. Useful as a drop-in HTMX helper without the full `setupExpress` shim. | `app.use(miki.expressPartialRenderer());` |
+| `renderPartialFromFile(filePath, partialName, context?, options?)` | `renderPartialFromFile(string, string, object?, object?) → string` | Load a file from disk and render only the named `{% partialdef %}`. | `miki.renderPartialFromFile('views/home.html', 'card', { user });` |
+| `renderPartialFromSource(source, partialName, context?, options?)` | `renderPartialFromSource(string, string, object?, object?) → string` | Render a single named partial directly from a template string. Walks the AST (and `extends` chain) to discover partials nested inside blocks. | `miki.renderPartialFromSource(src, 'card', ctx, { views });` |
 | `stripExpressContext(options)` | `stripExpressContext(object) → object` | Remove Express framework keys (`_locals`, `settings`, `cache`) from an options object. | `const ctx = stripExpressContext(res.locals);` |
 | `clearCache()` | `clearCache() → void` | Clear the in-memory compiled template cache. | `clearCache();` |
 | `registerTag(name, parserFn)` | `registerTag(string, function)` | Register a custom tag parser. Must be called before compiling templates. | `registerTag('mytag', parserFn);` |
@@ -39,6 +44,11 @@ const {
   asyncRender,
   __express,
   __expressAsync,
+  express,
+  setupExpress,
+  expressPartialRenderer,
+  renderPartialFromFile,
+  renderPartialFromSource,
   stripExpressContext,
   clearCache,
   registerTag,
@@ -46,6 +56,7 @@ const {
   getFilter,
   registerHelper,
   registerContextProcessor,
+  clearContextProcessors,
   registerTranslation,
   setLanguage,
   getLanguage,
@@ -69,6 +80,11 @@ import {
   asyncRender,
   __express,
   __expressAsync,
+  express,
+  setupExpress,
+  expressPartialRenderer,
+  renderPartialFromFile,
+  renderPartialFromSource,
   stripExpressContext,
   clearCache,
   registerTag,
@@ -76,6 +92,7 @@ import {
   getFilter,
   registerHelper,
   registerContextProcessor,
+  clearContextProcessors,
   registerTranslation,
   setLanguage,
   getLanguage,
@@ -92,7 +109,7 @@ import {
 
 // Or import all as default
 import miki from 'miki-template';
-const { render: mikiRender } = miki;
+const { render: mikiRender, setupExpress } = miki;
 ```
 
 For detailed usage, refer to the corresponding sections in the documentation: