miki-template 2.3.0 → 2.3.2

package/docs/guide/filters.md

@@ -1,1314 +0,0 @@
-# Filters
-
-
-
-Filters transform variable output using the pipe (`|`) syntax. You can chain multiple filters left-to-right, and many accept arguments after a colon (`:`).
-
-
-
-## Table of Contents
-
-
-
-- [Basic Usage](#basic-usage)
-
-- [Filter Chaining](#filter-chaining)
-
-- [Filter Arguments](#filter-arguments)
-
-- [Text Filters](#text-filters)
-
-- [HTML / Security Filters](#html--security-filters)
-
-- [List / Array Filters](#list--array-filters)
-
-- [Default Value Filters](#default-value-filters)
-
-- [Date and Time Filters](#date-and-time-filters)
-
-- [Numeric / Math Filters](#numeric--math-filters)
-
-- [Data Formatting Filters](#data-formatting-filters)
-
-- [Encoding Filters](#encoding-filters)
-
-- [Time-Ago Filters](#time-ago-filters)
-
-- [Built-in Library Filters](#built-in-library-filters)
-
-- [Writing Custom Filters](#writing-custom-filters)
-
-
-
----
-
-
-
-## Basic Usage
-
-
-
-```html
-
-{{ name|upper }}
-
-{{ price|floatformat:2 }}
-
-{{ body|truncatewords:30|escape }}
-
-```
-
-
-
-Each `|` applies a filter to the value on its left. Filters are evaluated left-to-right: the output of one filter becomes the input of the next.
-
-
-
-## Filter Chaining
-
-
-
-Filters apply left-to-right. The output of each filter becomes the input of the next:
-
-
-
-```html
-
-{{ name|lower|capfirst }}
-
-<!-- "Miki" → "miki" → "Miki" -->
-
-
-
-{{ bio|striptags|truncatewords:20 }}
-
-<!-- Strip HTML tags, then truncate to 20 words -->
-
-
-
-{{ text|escape|truncatechars:50|upper }}
-
-```
-
-
-
-You can chain any number of filters:
-
-
-
-```html
-
-{{ price|mult:1.2|add:2|floatformat:2|currency:"$" }}
-
-<!-- price = 10 → 12.0 → 14.0 → "14.00" → "$14.00" -->
-
-```
-
-
-
-## Filter Arguments
-
-
-
-Filters accept the following argument types:
-
-
-
-| Syntax | Type | Example |
-
-|--------|------|---------|
-
-| Unquoted | Variable lookup | `value|filter:count` |
-
-| Double-quoted | String literal | `value|filter:"hello"` |
-
-| Single-quoted | String literal | `value|filter:'world'` |
-
-| Number | Integer/float literal | `value|truncatewords:10` |
-
-| Boolean | `true`/`false` | `value|yesno:"yes,no"` |
-
-
-
-**Real-world example — conditional greeting with fallback:**
-
-
-
-```html
-
-<h1>{{ user.name|default:"Guest"|capfirst }}</h1>
-
-<span class="badge {% if user.is_premium|yesno:"yes,no" %}premium{% else %}free{% endif %}">
-
-  {{ user.plan|default:"Free" }}
-
-</span>
-
-```
-
-
-
----
-
-
-
-## Text Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `upper` | Uppercase | `{{ "hello"|upper }}` |
-
-| `lower` | Lowercase | `{{ "HELLO"|lower }}` |
-
-| `title` | Title case | `{{ "miki coder"|title }}` |
-
-| `capfirst` | Capitalize first letter | `{{ "hello"|capfirst }}` |
-
-| `truncatewords:N` | Truncate to N words, appends ` ...` | `{{ body|truncatewords:30 }}` |
-
-| `truncatechars:N` | Truncate to N chars, appends `...` | `{{ title|truncatechars:50 }}` |
-
-| `truncatechars_html:N` | HTML-aware truncation to N chars, preserves tags | `{{ html|truncatechars_html:100 }}` |
-
-| `wordcount` | Count words | `{{ body|wordcount }}` |
-
-| `linebreaks` | Convert double newlines to `<p>` and single to `<br>` | `{{ text|linebreaks }}` |
-
-| `linebreaksbr` | Convert all newlines to `<br>` | `{{ text|linebreaksbr }}` |
-
-| `striptags` | Remove HTML tags | `{{ html|striptags }}` |
-| `repeat` | Repeat a string N times | `{{ "ha"|repeat:3 }}` |
-| `range` | Generate a range of integers | `{{ 5|range }}` |
-
-
-| `slugify` | URL-friendly slug | `{{ title|slugify }}` |
-
-| `length_is:N` | Test if length equals N | `{{ items|length_is:0 }}` |
-
-
-
-### truncatechars_html
-
-
-
-Like `truncatechars` but respects HTML tags — tags are preserved in full and only visible text counts toward the limit:
-
-
-
-```html
-
-{{ "<p>Hello world</p>"|truncatechars_html:10 }}
-
-<!-- → "<p>Hello worl...</p>" -->
-
-```
-
-
-
-**Real-world blog excerpt:**
-
-
-
-```html
-
-<article>
-
-  {{ post.body|truncatechars_html:200 }}
-
-</article>
-
-```
-
-
-
-### linebreaks
-
-
-
-Converts newlines into paragraphs (`<p>`) and standalone line breaks into `<br>`:
-
-
-
-```html
-
-{{ "Line one\n\nLine two\nLine three"|linebreaks }}
-
-<!-- Output: <p>Line one</p><p>Line two<br>Line three</p> -->
-
-```
-
-
-
-### slugify
-
-
-
-Converts text to a URL-safe slug (lowercase, hyphens, no special characters):
-
-
-
-```html
-
-<a href="/posts/{{ post.title|slugify }}">{{ post.title }}</a>
-
-<!-- title: "Hello World: A New Beginning!" → href="/posts/hello-world-a-new-beginning" -->
-
-```
-
-
-
-### wordcount
-
-
-
-Use with `pluralize` for dynamic labels:
-
-
-
-```html
-
-<p>{{ post.body|wordcount }} {{ post.body|wordcount|pluralize:"word,words" }} read</p>
-
-```
-
-
-
----
-
-
-
-## HTML / Security Filters
-
-
-
-| Filter | Description |
-
-|--------|-------------|
-
-| `safe` | Mark string as safe (no escaping) |
-
-| `escape` | Force HTML escaping, even on SafeString |
-
-
-
-**Real-world CMS rendering:**
-
-
-
-```html
-
-<!-- Body is trusted HTML from the CMS -->
-
-<div class="content">{{ post.body_html|safe }}</div>
-
-
-
-<!-- User comments are always escaped -->
-
-<div class="comment">{{ comment.text|escape }}</div>
-
-```
-
-
-
----
-
-
-
-## List / Array Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `length` | Length of list/string | `{{ items|length }}` |
-
-| `join:","` | Join with separator | `{{ tags|join:", " }}` |
-
-| `slice:"start:end"` | Slice list | `{{ items|slice:"0:5" }}` |
-
-| `dictsort:"key"` | Sort dict by key | `{{ dict|dictsort:"name" }}` |
-
-| `dictsortreversed:"key"` | Reverse sort dict | `{{ dict|dictsortreversed:"name" }}` |
-
-| `sort` | Sort array | `{{ items|sort }}` |
-
-| `unique` | Deduplicate array | `{{ tags|unique }}` |
-
-| `random` | Random item from array | `{{ items|random }}` |
-
-| `reverse` | Reverse array or string | `{{ items|reverse }}` |
-
-| `split:","` | Split string into array | `{{ csv|split:"," }}` |
-
-| `replace:"old,new"` | Replace substring | `{{ text|replace:"foo,bar" }}` |
-
-
-
-### slice
-
-
-
-Slices an array or string like Python (`[start:end]`). Supports negative indices:
-
-
-
-```html
-
-<!-- First 3 items -->
-
-{{ items|slice:"0:3" }}
-
-
-
-<!-- From index 2 onwards -->
-
-{{ items|slice:"2:" }}
-
-
-
-<!-- Last 2 items -->
-
-{{ items|slice:"-2:" }}
-
-```
-
-
-
-### join
-
-
-
-**Real-world tag cloud:**
-
-
-
-```html
-
-<div class="tag-cloud">
-
-  {% for tag in post.tags|join:", " %}
-
-    <span class="tag">{{ tag }}</span>
-
-  {% endfor %}
-
-</div>
-
-<!-- But better as: -->
-
-<span class="tag-cloud">{{ post.tags|join:", " }}</span>
-
-```
-
-
-
-### sort + unique
-
-
-
-**Real-world: deduplicated, sorted navigation:**
-
-
-
-```html
-
-<ul>
-
-  {% for category in categories|sort %}
-
-    <li>{{ category|capfirst }}</li>
-
-  {% endfor %}
-
-</ul>
-
-```
-
-
-
-### split
-
-
-
-**Real-world: parsing comma-separated metadata:**
-
-
-
-```html
-
-<!-- post.keywords = "nature,landscape,autumn" -->
-
-<div class="meta">
-
-  {% for kw in post.keywords|split:"," %}
-
-    <a href="/tag/{{ kw|slugify }}">{{ kw|capfirst }}</a>
-
-  {% endfor %}
-
-</div>
-
-```
-
-
-
----
-
-
-
-## Default Value Filters
-
-
-
-| Filter | Description |
-
-|--------|-------------|
-
-| `default:"fallback"` | Use fallback for empty string, null, or undefined |
-
-| `default_if_none:"fallback"` | Use fallback only for null/undefined |
-
-| `firstof:v1 v2 v3` | Return first truthy value |
-
-
-
-### default vs default_if_none
-
-
-
-- `default` uses the fallback for falsy values: `null`, `undefined`, `""`, `0`, `false`
-
-- `default_if_none` only uses the fallback for `null` and `undefined`
-
-
-
-```html
-
-{{ ""|default:"empty" }}           → "empty"
-
-{{ ""|default_if_none:"N/A" }}     → "" (empty string is not none)
-
-{{ 0|default:"zero" }}             → "zero"
-
-{{ 0|default_if_none:"N/A" }}      → 0 (zero is not none)
-
-```
-
-
-
-**Real-world user profile:**
-
-
-
-```html
-
-<!-- Show "No bio yet" only when bio is truly empty -->
-
-<p class="bio">{{ user.bio|default:"No bio yet." }}</p>
-
-
-
-<!-- Distinguish between "never set" and "explicitly empty" -->
-
-{% if user.display_name %}
-
-  <h2>{{ user.display_name|default_if_none:"Anonymous" }}</h2>
-
-{% endif %}
-
-```
-
-
-
----
-
-
-
-## Date and Time Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `date:"Y-m-d"` | Format date (Django-style tokens) | `{{ d|date:"Y-m-d" }}` |
-
-| `time:"H:i"` | Format time | `{{ d|time:"H:i" }}` |
-
-| `date_format:"yyyy-MM-dd"` | Format date (date-fns tokens) | `{{ d|date_format:"yyyy-MM-dd" }}` |
-
-| `strftime:"PPpp"` | Format date (date-fns tokens) | `{{ now|strftime:"PPpp" }}` |
-
-| `timesince` | Time since date | `{{ created|timesince }}` |
-
-| `timeuntil` | Time until date | `{{ start|timeuntil }}` |
-
-| `ago` | Time since date, human-readable | `{{ created|ago }}` |
-
-| `until` | Time until date, human-readable | `{{ start|until }}` |
-
-| `time_diff:other_date` | Difference between two dates | `{{ start|time_diff:end }}` |
-
-
-
-### Date format tokens (`date` and `time` filters)
-
-
-
-The `date` filter uses Django-style format tokens with longest-first matching:
-
-
-
-| Token | Output |
-
-|-------|--------|
-
-| `Y` | 4-digit year |
-
-| `y` | 2-digit year |
-
-| `m` | Month number (no pad) |
-
-| `n` | Month number (no pad) |
-
-| `d` | Day number (no pad) |
-
-| `j` | Day number (no pad) |
-
-| `H` | 24-hour hour (no pad) |
-
-| `G` | 24-hour hour (no pad) |
-
-| `i` | Minutes |
-
-| `s` | Seconds |
-
-| `F` | Long month name |
-
-| `D` | Short day name |
-
-| `M` | Long month name |
-
-
-
-### date_format and strftime (date-fns tokens)
-
-
-
-For ISO and date-fns patterns:
-
-
-
-```html
-
-{{ post.published_at|date_format:"yyyy-MM-dd" }}  → "2026-08-31"
-
-{{ post.published_at|strftime:"PPpp" }}           → "Aug 31, 2026 at 10:30 PM"
-
-{{ event.date|strftime:"EEEE, MMMM do yyyy, h:mm a" }} → "Sunday, August 31st 2026, 10:30 PM"
-
-```
-
-
-
-### timesince / timeuntil
-
-
-
-Returns a human-readable time difference:
-
-
-
-```html
-
-{{ post.created|timesince }}  → "2 hours"
-
-{{ post.created|timesince:other_date }}  → "3 days" (relative to other_date)
-
-{{ event.date|timeuntil }}  → "5 days"
-
-```
-
-
-
-### ago / until
-
-
-
-More human-readable relative time strings:
-
-
-
-```html
-
-<!-- "2 days ago", "just now", "3 months ago" -->
-
-<span class="timestamp">{{ comment.created|ago }}</span>
-
-
-
-<!-- "2 days", "3 weeks", "1 month" -->
-
-<time datetime="{{ event.date|date:'c' }}">{{ event.date|until }}</time>
-
-```
-
-
-
-**Real-world blog post metadata:**
-
-
-
-```html
-
-<article class="post">
-
-  <header>
-
-    <h1>{{ post.title }}</h1>
-
-    <time class="posted-at">
-
-      Published {{ post.published_at|date:"F j, Y" }} ({{ post.published_at|ago }})
-
-    </time>
-
-  </header>
-
-  <div class="content">
-
-    {{ post.body|linebreaks }}
-
-  </div>
-
-</article>
-
-```
-
-
-
----
-
-
-
-## Numeric / Math Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `add:N` | Add number | `{{ count\|add:1 }}` |
-
-| `sub:N` | Subtract number | `{{ total\|sub:tax }}` |
-
-| `mult:N` | Multiply number | `{{ price\|mult:1.2 }}` |
-
-| `divisibleby:N` | Test divisibility | `{{ i\|divisibleby:2 }}` |
-
-| `mod:N` | Modulo | `{{ i\|mod:3 }}` |
-
-| `floatformat:N` | Format float | `{{ price\|floatformat:2 }}` |
-
-| `square` | Square a number | `{{ n\|square }}` |
-
-| `sqrt` | Square root | `{{ n\|sqrt }}` |
-
-| `abs` | Absolute value | `{{ delta\|abs }}` |
-
-| `round:N` | Round to N decimals | `{{ price\|round:2 }}` |
-
-| `floor` | Floor | `{{ ratio\|floor }}` |
-
-| `ceil` | Ceiling | `{{ ratio\|ceil }}` |
-
-| `min:N` | Minimum of value and arg | `{{ temp\|min:0 }}` |
-
-| `max:N` | Maximum of value and arg | `{{ temp\|max:100 }}` |
-
-| `sum` | Sum array | `{{ numbers\|sum }}` |
-
-| `average` | Average array | `{{ scores\|average }}` |
-
-
-
-### floatformat behavior
-
-
-
-| arg | behavior |
-
-|-----|----------|
-
-| (none) | 1 decimal (`3.4`) |
-
-| `0` | 0 decimals (`3`) |
-
-| `1` | 1 decimal (`3.4`) |
-
-| `2` | 2 decimals (`3.40`) |
-
-| `-1` | all decimals, trimmed |
-
-
-
-### Real-world pricing example
-
-
-
-```html
-
-<td class="price">
-
-  ${{ item.price|mult:item.qty|floatformat:2 }}
-
-</td>
-
-<!-- If not on sale, apply discount -->
-
-{% if not item.on_sale %}
-
-  <td>{{ item.base_price|mult:0.9|floatformat:2 }}</td>
-
-{% endif %}
-
-```
-
-
-
----
-
-
-
-## Data Formatting Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `currency:"$"` | Format as currency | `{{ price|currency:"$" }}` |
-
-| `phone_number` | Format as phone number | `{{ raw|phone_number }}` |
-
-| `email` | Format as mailto link | `{{ address|email }}` |
-
-| `url` | Format as URL | `{{ domain|url }}` |
-
-| `mask:"*"` | Mask string, show last 4 chars | `{{ card|mask }}` |
-
-| `whatsapp_link:"msg"` | Generate WhatsApp link | `{{ phone|whatsapp_link }}` |
-
-| `credit_card` | Format as credit card | `{{ raw|credit_card }}` |
-
-| `ssn` | Format as SSN | `{{ raw|ssn }}` |
-
-| `ip_address` | Format as IP address | `{{ raw|ip_address }}` |
-
-| `uuid` | Generate UUID (no input needed) | `{{ x|uuid }}` |
-
-| `filesizeformat` | Human-readable file size | `{{ bytes|filesizeformat }}` |
-
-| `yesno:"yes,no,maybe"` | Convert bool to string | `{{ active|yesno:"Active,Inactive" }}` |
-
-| `pluralize:"s"` | Pluralize based on count | `{{ count|pluralize }}` |
-
-| `urlencode` | URL encode | `{{ text|urlencode }}` |
-
-| `escapeuri` | URI encode | `{{ text|escapeuri }}` |
-
-| `stringformat:"%s"` | sprintf-style formatting | `{{ name|stringformat:"%s" }}` |
-
-| `cut:"text"` | Remove substring | `{{ text|cut:"foo" }}` |
-
-| `addslashes` | Escape quotes | `{{ text|addslashes }}` |
-
-| `removetags:"p,div"` | Remove specific tags | `{{ html|removetags:"p,div" }}` |
-
-| `trans` | Translate via i18n | `{{ "hello"|trans }}` |
-
-| `regroup:"attr"` | Group list by attribute | `{{ items|regroup:"category" }}` |
-
-| `json` | JSON-encode value | `{{ obj|json }}` |
-
-| `urlize` | Convert URLs to links | `{{ text|urlize }}` |
-
-
-
-### phone_number
-
-
-
-Formats a 10-digit US phone number as `(123) 456-7890`. Handles 11-digit numbers with leading `1` as `+1 (123) 456-7890`:
-
-
-
-```html
-
-{{ "1234567890"|phone_number }}       → "(123) 456-7890"
-
-{{ "11234567890"|phone_number }}      → "+1 (123) 456-7890"
-
-```
-
-
-
-### credit_card
-
-
-
-Formats a credit card number with dashes every 4 digits:
-
-
-
-```html
-
-{{ "4111111111111111"|credit_card }}  → "4111-1111-1111-1111"
-
-```
-
-
-
-### ssn
-
-
-
-Formats a 9-digit Social Security Number:
-
-
-
-```html
-
-{{ "123456789"|ssn }}  → "123-45-6789"
-
-```
-
-
-
-### mask
-
-
-
-Masks all but the last 4 characters. Default mask character is `*`:
-
-
-
-```html
-
-<!-- Mask a phone number or credit card in display -->
-
-<span class="masked">{{ user.phone|mask }}</span>
-
-
-
-<!-- Custom mask character -->
-
-{{ "1234567890"|mask:"#" }}  → "######7890"
-
-```
-
-
-
-### url (with safe filter)
-
-
-
-```html
-
-<a href="{{ post.share_url|url|safe }}">{{ post.share_url|url }}</a>
-
-```
-
-
-
-### email
-
-
-
-```html
-
-<a href="{{ user.email|email }}">{{ user.email }}</a>
-
-<!-- → <a href="mailto:user@example.com">user@example.com</a> -->
-
-```
-
-
-
-### whatsapp_link
-
-
-
-Generates a WhatsApp link with an optional pre-filled message:
-
-
-
-```html
-
-<a href="{{ phone|whatsapp_link:"Hello! I'd like to know more." }}" target="_blank">
-
-  Chat on WhatsApp
-
-</a>
-
-```
-
-
-
-### json (safe for `<script>` blocks)
-
-
-
-Safely serializes data to JSON for client-side consumption:
-
-
-
-```html
-
-<script>
-
-  const initialState = {{ page_state|json|safe }};
-
-</script>
-
-```
-
-
-
-> Note: `json` output is marked safe automatically. Use `|safe` in the template only to signal intent — the engine handles it correctly either way.
-
-
-
-### stringformat
-
-
-
-```html
-
-{{ 3.14159|stringformat:".2f" }}  → "3.14"
-
-{{ count|stringformat:"04d" }}     → "0042"
-
-{{ name|stringformat:"%s" }}        → "Alice"
-
-```
-
-
-
-### cut
-
-
-
-Removes all occurrences of a substring:
-
-
-
-```html
-
-<!-- Sanitize a URL by removing unwanted query params -->
-
-{{ request_uri|cut:"?debug=1" }}
-
-```
-
-
-
-### pluralize
-
-
-
-**Real-world item count:**
-
-
-
-```html
-
-<p>{{ cart.items|length }} item{{ cart.items|length|pluralize }} in your cart</p>
-
-<!-- "1 item in your cart" / "3 items in your cart" -->
-
-
-
-<!-- Custom suffixes -->
-
-<p>{{ count|pluralize:"y,ies" }} comment{{ count|pluralize:"y,ies" }}</p>
-
-```
-
-
-
-### yesno
-
-
-
-**Real-world status badge:**
-
-
-
-```html
-
-<span class="status {{ user.is_active|yesno:"active,inactive" }}">
-
-  {{ user.is_active|yesno:"Active,Inactive" }}
-
-</span>
-
-```
-
-
-
----
-
-
-
-## Encoding Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `base64_encode` | Base64 encode | `{{ text|base64_encode }}` |
-
-| `base64_decode` | Base64 decode | `{{ text|base64_decode }}` |
-
-
-
-### Real-world: embedding a CSRF token in a header
-
-
-
-```html
-
-<meta name="csrf-token" content="{{ csrf_token|base64_encode }}">
-
-```
-
-
-
----
-
-
-
-## Time-Ago Filters
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `time_diff:other` | Human-readable time difference | `{{ start|time_diff:end }}` |
-
-| `ago` | Time since date | `{{ created|ago }}` |
-
-| `until` | Time until date | `{{ start|until }}` |
-
-
-
-### ago — human-readable "time since"
-
-
-
-```html
-
-<!-- "just now", "5 minutes ago", "2 hours ago", "3 days ago", "1 year ago" -->
-
-<span class="time-ago">{{ post.created_at|ago }}</span>
-
-```
-
-
-
-### until — human-readable "time remaining"
-
-
-
-```html
-
-<!-- "2 days", "3 weeks", "1 month" -->
-
-<span class="countdown">{{ auction.ends_at|until }}</span>
-
-```
-
-
-
----
-
-
-
-## Built-in Library Filters
-
-
-
-### humanize
-
-
-
-Available after `{% load humanize %}`:
-
-
-
-| Filter | Description | Example |
-
-|--------|-------------|---------|
-
-| `intcomma` | Add comma separators | `{{ views|intcomma }}` → `1,234` |
-
-| `intword` | Convert to human word | `{{ 1000000|intword }}` → `1.0 million` |
-
-| `apnumber` | Convert 0-19 to words | `{{ 3|apnumber }}` → `three` |
-
-| `ordinal` | Add ordinal suffix | `{{ 1|ordinal }}` → `1st` |
-
-| `naturalday` | Convert date to relative day | `{{ date|naturalday }}` → `today` |
-
-
-
-Usage:
-
-
-
-```html
-
-{% load humanize %}
-
-{{ post.view_count|intcomma }}
-
-{{ comment_count|ordinal }}
-
-```
-
-
-
-### cache
-
-
-
-The `cache` library provides a `{% cache %}` tag, not a filter. See [Tags: cache](#cache-tag) for details.
-
-
-
-### lorem
-
-
-
-The `lorem` library provides a `{% lorem %}` tag and a `lorem` filter. These are auto-activated (no `{% load %}` needed).
-
-
-
-```html
-
-<!-- Generate placeholder text -->
-
-{{ 5|lorem }}
-
-```
-
-
-
----
-
-
-
-## Writing Custom Filters
-
-
-
-You can register your own filters. See the [Custom Filters guide](custom-filters.md) for details.
-
-
-
-=== "CommonJS"
-
-
-
-    ```javascript
-
-    const { registerFilter } = require('miki-template');
-
-
-
-    registerFilter('reverse', (val) => {
-
-      return String(val).split('').reverse().join('');
-
-    });
-
-    ```
-
-
-
-=== "ES Modules"
-
-
-
-    ```javascript
-
-    import { registerFilter } from 'miki-template';
-
-
-
-    registerFilter('reverse', (val) => {
-
-      return String(val).split('').reverse().join('');
-
-    });
-
-    ```
-
-
-
----
-
-# Filter Documentation
-
-## `repeat`
-
-**Signature:** `repeat(value, count)`
-
-- **Purpose:** Returns a new string consisting of `value` repeated `count` times.
-- **Parameters:**
-  - `value` – Any value that can be converted to a string (null/undefined become empty string).
-  - `count` – Number of repetitions, parsed as integer; non‑positive yields empty string.
-- **Implementation:** Uses native `String.prototype.repeat` for optimal V8 performance.
-- **Example:** `{{ "ab"|repeat:3 }}  => "ababab"`
-
-## `range`
-
-**Signature:** `range(end, start?)`
-
-- **Purpose:** Generates an array of integers from `start` (inclusive) to `end` (exclusive) with step 1.
-- **Parameters:**
-  - `end` – Upper bound (exclusive), parsed as integer.
-  - `start` – Optional lower bound, defaults to `0`.
-- **Implementation:** Simple for‑loop building a JavaScript array.
-- **Example:** `{% for i in 5|range %}{{ i }}{% endfor %}` outputs `0 1 2 3 4`.
-
-These filters are covered by unit tests in `tests/filters.test.js` and are documented here for developers and template authors.
-
-
-
-
-## Next Steps
-
-
-
-- [Custom Filters](./custom-filters.md)
-
-- [Tags](./tags.md)
-
-- [API Reference: Filters](../api/filters.md)
-