miki-template 2.3.1 → 2.3.2

package/docs/api/i18n.md

@@ -1,314 +0,0 @@
-# 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.md#i18n--internationalization)
-
-- [API Reference](../index.md)
-

package/docs/api/index.md

@@ -1,108 +0,0 @@
-# API Reference
-
-
-
-## Core Functions
-
-
-
-- [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.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.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.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.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.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
-