miki-template 2.2.3 → 2.3.0

package/docs/api/i18n.md

@@ -1,157 +1,314 @@
-# i18n API
+# i18n API
+
+
 
 ## registerTranslation
 
+
+
 Register translations for a language. Keys match the `{% trans "text" %}` source string.
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { registerTranslation } = require('miki-template');
 
+
+
     registerTranslation('en', {
+
       hello: 'Hello',
+
       goodbye: 'Goodbye'
+
     });
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { registerTranslation } from 'miki-template';
 
+
+
     registerTranslation('en', {
+
       hello: 'Hello',
+
       goodbye: 'Goodbye'
+
     });
+
     ```
 
+
+
 You can also register nested keys for `blocktrans` with variables:
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { registerTranslation, setLanguage } = require('miki-template');
 
+
+
     setLanguage('en');
+
     registerTranslation('en', {
+
       'Welcome, {name}!': 'Welcome, {name}!',
+
       'Goodbye, {name}!': 'Goodbye, {name}!'
+
     });
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { registerTranslation, setLanguage } from 'miki-template';
 
+
+
     setLanguage('en');
+
     registerTranslation('en', {
+
       'Welcome, {name}!': 'Welcome, {name}!',
+
       'Goodbye, {name}!': 'Goodbye, {name}!'
+
     });
+
     ```
 
+
+
 ## unregisterTranslation
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { unregisterTranslation } = require('miki-template');
 
+
+
     // Unregister a specific key
+
     unregisterTranslation('en', 'hello');
 
+
+
     // Unregister entire language
+
     unregisterTranslation('en');
 
+
+
     // Unregister all translations
+
     unregisterTranslation();
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { unregisterTranslation } from 'miki-template';
 
+
+
     unregisterTranslation('en', 'hello');
+
     ```
 
+
+
 ## setLanguage / getLanguage
 
+
+
 Set or get the active language.
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { setLanguage, getLanguage } = require('miki-template');
 
+
+
     setLanguage('fr');
+
     console.log(getLanguage()); // 'fr'
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { setLanguage, getLanguage } from 'miki-template';
 
+
+
     setLanguage('fr');
+
     console.log(getLanguage()); // 'fr'
+
     ```
 
+
+
 ## setFallbackLanguage / getFallbackLanguage
 
+
+
 Set or get the fallback language (used when a key is missing from the active language).
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { setFallbackLanguage, getFallbackLanguage } = require('miki-template');
 
+
+
     setFallbackLanguage('en');
+
     console.log(getFallbackLanguage()); // 'en'
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { setFallbackLanguage, getFallbackLanguage } from 'miki-template';
 
+
+
     setFallbackLanguage('en');
+
     ```
 
+
+
 ## getAvailableLanguages
 
+
+
 List all registered languages.
 
+
+
 === "CommonJS"
 
+
+
     ```javascript
+
     const { getAvailableLanguages } = require('miki-template');
 
+
+
     console.log(getAvailableLanguages());
+
     // ['en', 'fr', 'es']
+
     ```
 
+
+
 === "ES Modules"
 
+
+
     ```javascript
+
     import { getAvailableLanguages } from 'miki-template';
 
+
+
     console.log(getAvailableLanguages());
+
     ```
 
+
+
 ## Template Tags
 
+
+
 The `{% trans %}` and `{% blocktrans %}` tags are provided by the auto-activated `i18n` library:
 
+
+
 ```html
+
 {% trans "Hello" %}
+
 {% blocktrans %}Welcome, {{ name }}!{% endblocktrans %}
+
 {% language "fr" %}...{% endlanguage %}
+
 ```
 
+
+
 ## Next Steps
 
-- [Advanced Usage: i18n](../guide/advanced-usage#i18n--internationalization)
-- [API Reference](../)
+
+
+- [Advanced Usage: i18n](../guide/advanced-usage.md#i18n--internationalization)
+
+- [API Reference](../index.md)
+

package/docs/api/index.md

@@ -1,54 +1,108 @@
-# API Reference
+# API Reference
+
+
 
 ## Core Functions
 
-- [render()](./render) — Render a template string or file partial
-- [compile()](./compile) — Compile a template into a reusable object with `render()`, `asyncRender()`, `renderBlock()`, `renderPartial()`
-- [asyncRender()](./async-render) — Asynchronous rendering (supports async filters/tags)
-- [renderPartialFromFile()](./render-partial) — Render a named partial from a file
-- [renderPartialFromSource()](./render-partial) — Render a named partial from source
-- [setupExpress()](./setup-express) — One-line Express integration
+
+
+- [render()](./render.md) — Render a template string or file partial
+
+- [compile()](./compile.md) — Compile a template into a reusable object with `render()`, `asyncRender()`, `renderBlock()`, `renderPartial()`
+
+- [asyncRender()](./async-render.md) — Asynchronous rendering (supports async filters/tags)
+
+- [renderPartialFromFile()](./render-partial.md) — Render a named partial from a file
+
+- [renderPartialFromSource()](./render-partial.md) — Render a named partial from source
+
+- [setupExpress()](./setup-express.md) — One-line Express integration
+
+
 
 ## Tag and Filter Registration
 
-- [registerFilter()](./filters) — Register a custom filter
-- [getFilter()](./filters) — Retrieve a registered filter
-- [registerTag()](./tags) — Register a custom tag
-- [registerHelper()](./helpers) — Register a custom helper
+
+
+- [registerFilter()](./filters.md) — Register a custom filter
+
+- [getFilter()](./filters.md) — Retrieve a registered filter
+
+- [registerTag()](./tags.md) — Register a custom tag
+
+- [registerHelper()](./helpers.md) — Register a custom helper
+
+
 
 ## Utilities
 
-- [findTemplateInViews()](./finder) — Locate a template in views directories
-- [setAppTemplateDirNames()](./finder) — Configure app-style template directory names
-- [clearCache()](./cache) — Clear the compiled template cache
-- [registerContextProcessor()](./context-processors) — Register a global context processor
-- [clearContextProcessors()](./context-processors) — Clear all context processors
+
+
+- [findTemplateInViews()](./finder.md) — Locate a template in views directories
+
+- [setAppTemplateDirNames()](./finder.md) — Configure app-style template directory names
+
+- [clearCache()](./cache.md) — Clear the compiled template cache
+
+- [registerContextProcessor()](./context-processors.md) — Register a global context processor
+
+- [clearContextProcessors()](./context-processors.md) — Clear all context processors
+
+
 
 ## Security
 
-- [markSafe()](./security) — Mark a string as safe (bypass escaping)
-- [isSafe()](./security) — Check if a value is marked safe
-- [escapeHtml()](./security) — Escape HTML special characters
-- [SafeString](./security) — SafeString class
+
+
+- [markSafe()](./security.md) — Mark a string as safe (bypass escaping)
+
+- [isSafe()](./security.md) — Check if a value is marked safe
+
+- [escapeHtml()](./security.md) — Escape HTML special characters
+
+- [SafeString](./security.md) — SafeString class
+
+
 
 ## Express Engine Functions
 
+
+
 - `__express(filePath, options, callback)` — Express-compatible sync view engine
+
 - `__expressAsync(filePath, options)` — Express 5 async view engine (returns Promise)
+
 - `express(options)` — Returns a view engine function for `app.engine()`
+
 - `expressPartialRenderer()` — Express middleware adding `res.renderPartial()`
+
 - `stripExpressContext(options)` — Remove Express framework keys from context
 
+
+
 ## i18n
 
-- [registerTranslation()](./i18n) — Register translations for a language
-- [unregisterTranslation()](./i18n) — Unregister translations
-- [setLanguage()](./i18n) / [getLanguage()](./i18n) — Set/get active language
-- [setFallbackLanguage()](./i18n) / [getFallbackLanguage()](./i18n) — Set/get fallback language
-- [getAvailableLanguages()](./i18n) — List registered languages
+
+
+- [registerTranslation()](./i18n.md) — Register translations for a language
+
+- [unregisterTranslation()](./i18n.md) — Unregister translations
+
+- [setLanguage()](./i18n.md) / [getLanguage()](./i18n.md) — Set/get active language
+
+- [setFallbackLanguage()](./i18n.md) / [getFallbackLanguage()](./i18n.md) — Set/get fallback language
+
+- [getAvailableLanguages()](./i18n.md) — List registered languages
+
+
 
 ## Libraries
 
-- [registerLibrary()](./libraries) — Register a named library (filters, tags, helpers)
-- [activateLibrary()](./libraries) / [registerLibraryFromPath()](./libraries) — Activate or load from file
-- [unregisterLibrary()](./libraries) / [hasLibrary()](./libraries) / [getLibraryNames()](./libraries) — Library management
+
+
+- [registerLibrary()](./libraries.md) — Register a named library (filters, tags, helpers)
+
+- [activateLibrary()](./libraries.md) / [registerLibraryFromPath()](./libraries.md) — Activate or load from file
+
+- [unregisterLibrary()](./libraries.md) / [hasLibrary()](./libraries.md) / [getLibraryNames()](./libraries.md) — Library management
+