@ogify/core 0.1.4 → 0.5.0

package/dist/index.d.mts

@@ -22,6 +22,30 @@ import { FontWeight, FontStyle } from 'satori';
  * - `openmoji`: Open-source emoji with outlined style
  */
 type OgEmojiProvider = 'twemoji' | 'fluent' | 'fluentFlat' | 'noto' | 'blobmoji' | 'openmoji';
+/**
+ * Cache configuration for fonts and icons.
+ *
+ * Supports two caching strategies:
+ * - Memory: Fast in-memory cache with LRU eviction
+ * - Filesystem: Persistent cache stored on disk
+ */
+type OgCacheConfig = {
+    /** Memory-based caching strategy */
+    type: 'memory';
+    /** Time-to-live in milliseconds (default: 3600000 = 1 hour) */
+    ttl?: number;
+    /** Maximum number of items to cache (default: 100) */
+    max?: number;
+} | {
+    /** Filesystem-based caching strategy */
+    type: 'filesystem';
+    /** Directory to store cache files (default: '.ogify-cache') */
+    dir?: string;
+    /** Time-to-live in milliseconds (default: 3600000 = 1 hour) */
+    ttl?: number;
+    /** Maximum number of items to cache (default: 100) */
+    max?: number;
+};
 /**
  * Supported font file formats.
  *
@@ -90,12 +114,15 @@ type OgFontConfig = {
  * `;
  */
 type OgTemplateOptions = {
-    /** User-provided parameters that populate the template (e.g., title, description, author) */
-    params: OgTemplateParams;
+    /** Custom fonts to use in this template */
+    fonts?: OgFontConfig[];
+    /** Optional emoji provider to use in this template */
+    emojiProvider?: OgEmojiProvider;
     /** Optional custom width in pixels (default: 1200) */
     width?: number;
     /** Optional custom height in pixels (default: 630) */
     height?: number;
+    isRTL?: boolean;
 };
 /**
  * Key-value pairs representing dynamic template parameters.
@@ -103,6 +130,7 @@ type OgTemplateOptions = {
  * Parameters are the data that gets injected into templates to create
  * personalized OG images. Values can be:
  * - Strings: Text content (titles, descriptions, names)
+ * - String Arrays: Lists of tags, categories
  * - Numbers: Counts, dates, metrics
  * - Booleans: Flags, toggles, states
  *
@@ -114,7 +142,7 @@ type OgTemplateOptions = {
  *   published: true
  * };
  */
-type OgTemplateParams = Record<string, string | number | boolean>;
+type OgTemplateParams = Record<string, string | string[] | number | boolean>;
 /**
  * Complete definition of an Open Graph image template.
  *
@@ -124,20 +152,16 @@ type OgTemplateParams = Record<string, string | number | boolean>;
  * - What fonts to use
  * - Metadata for identification
  */
-type OgTemplate = {
-    /** Unique identifier for this template (e.g., 'blog-post', 'product-card') */
-    id: string;
-    /** Human-readable name for display purposes */
-    name: string;
-    /** Brief description of what this template is used for */
-    description: string;
+type OgTemplate<TParams = OgTemplateParams> = {
     /**
      * Function that generates HTML markup from template parameters.
      *
      * The HTML should use inline styles (Tailwind-like utilities are supported).
      * Flexbox and basic CSS properties are supported by Satori.
      */
-    renderer: (props: OgTemplateOptions) => string;
+    renderer: (props: OgTemplateOptions & {
+        params: TParams;
+    }) => string;
     /**
      * Custom fonts to use in this template.
      *
@@ -159,16 +183,29 @@ type OgTemplate = {
  * The handler manages a registry of templates and provides a unified
  * interface for rendering them to images.
  */
-type OgTemplateRenderer = {
-    /** Array of template definitions to register */
-    templates: OgTemplate[];
+type OgTemplateRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>> = {
+    /** Map of template definitions to register, keyed by template ID */
+    templates: {
+        [K in keyof TMap]: OgTemplate<TMap[K]>;
+    };
     /**
-     * Default parameter values applied to all templates.
+     * Shared parameter values applied to all templates.
      *
      * These values are merged with user-provided parameters,
      * with user values taking precedence.
      */
-    defaultParams?: OgTemplateParams | (() => Promise<OgTemplateParams>);
+    sharedParams?: Partial<TMap[keyof TMap]> | (() => Promise<Partial<TMap[keyof TMap]>>);
+    /**
+     * Cache configuration for fonts and icons.
+     *
+     * When provided, enables LRU caching to improve performance by:
+     * - Reducing redundant network requests for fonts and emojis
+     * - Supporting memory or filesystem-based caching strategies
+     * - Configurable TTL and maximum cache size
+     *
+     * If not provided, falls back to simple in-memory caching.
+     */
+    cache?: OgCacheConfig;
     /**
      * Hook called before rendering.
      *
@@ -178,7 +215,7 @@ type OgTemplateRenderer = {
      * - Authentication checks
      * - Rate limiting
      */
-    beforeRender?: (templateId: string, params: OgTemplateParams) => void | Promise<void>;
+    beforeRender?: (templateId: keyof TMap, params: TMap[keyof TMap]) => void | Promise<void>;
     /**
      * Hook called after rendering.
      *
@@ -188,7 +225,7 @@ type OgTemplateRenderer = {
      * - Sending notifications
      * - Updating metrics
      */
-    afterRender?: (templateId: string, params: OgTemplateParams, imageBuffer: Buffer) => void | Promise<void>;
+    afterRender?: (templateId: keyof TMap, params: TMap[keyof TMap], imageBuffer: Buffer) => void | Promise<void>;
 };
 
 /**
@@ -217,7 +254,7 @@ type OgTemplateRenderer = {
  * @returns true if validation passes
  * @throws Error if any required field is missing or invalid
  */
-declare function validateTemplate(config: OgTemplate): boolean;
+declare function validateTemplate<TemplateParams>(config: OgTemplate<TemplateParams>): boolean;
 /**
  * Defines and validates a new OG template.
  *
@@ -229,17 +266,19 @@ declare function validateTemplate(config: OgTemplate): boolean;
  * - Type safety ensures correct template structure
  * - Clear intent in code (self-documenting)
  *
- * @param config - Complete template configuration including id, name, and renderer function
+ * @param config - Complete template configuration including renderer function and fonts
  * @returns The validated template configuration
  * @throws Error if validation fails
  */
-declare function defineTemplate(config: OgTemplate): OgTemplate;
+declare function defineTemplate<TemplateParams>(config: OgTemplate<TemplateParams>): OgTemplate<TemplateParams>;
 /**
  * Template Handler class for managing multiple templates and rendering them to images.
  */
-declare class TemplateRenderer {
+declare class TemplateRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>> {
     /** Configuration including global settings and lifecycle hooks */
     private config;
+    /** Cache manager for fonts and icons */
+    private cacheManager;
     /**
      * Internal registry mapping template IDs to template definitions.
      *
@@ -254,14 +293,14 @@ declare class TemplateRenderer {
      *
      * @param config - Handler configuration with templates and global settings
      */
-    constructor(config: OgTemplateRenderer);
+    constructor(config: OgTemplateRenderer<TMap>);
     /**
      * Registers multiple templates into the internal registry.
      *
      * Templates are indexed by their ID for fast lookup.
      * If a template with the same ID already exists, it will be overwritten.
      *
-     * @param templates - Array of template definitions to register
+     * @param templates - Map of template definitions to register
      */
     private registerTemplates;
     /**
@@ -275,18 +314,7 @@ declare class TemplateRenderer {
      * @param id - The template ID to look up
      * @returns The template definition, or undefined if not found
      */
-    getTemplate(id: string): OgTemplate | undefined;
-    /**
-     * Gets all registered template IDs.
-     *
-     * Useful for:
-     * - Building template selection dropdowns
-     * - Listing available templates in documentation
-     * - Debugging template registration
-     *
-     * @returns Array of template IDs
-     */
-    getTemplateIds(): string[];
+    getTemplate<K extends keyof TMap>(id: K): OgTemplate<TMap[K]> | undefined;
     /**
      * Renders a template to a PNG image buffer.
      *
@@ -308,17 +336,14 @@ declare class TemplateRenderer {
      * - Throws if rendering fails (font loading, HTML generation, etc.)
      *
      * @param templateId - ID of the template to render
-     * @param params - Parameters to pass to the template
+     * @param params - Parameters (or function returning params) to pass to the template
      * @param options - Optional rendering options
      * @param options.width - Custom image width in pixels (default: 1200)
      * @param options.height - Custom image height in pixels (default: 630)
      * @returns Promise resolving to a PNG image buffer
      * @throws Error if template is not found or rendering fails
      */
-    renderToImage(templateId: string, params: OgTemplateParams | (() => Promise<OgTemplateParams>), options?: {
-        width: number;
-        height: number;
-    }): Promise<Buffer>;
+    renderToImage<K extends keyof TMap>(templateId: K, params: TMap[K] | (() => Promise<TMap[K]>), options?: OgTemplateOptions): Promise<Buffer>;
 }
 /**
  * Factory function to create a new TemplateRenderer instance.
@@ -329,7 +354,7 @@ declare class TemplateRenderer {
  * @param config - Handler configuration with templates and settings
  * @returns A new TemplateRenderer instance
  */
-declare function createTemplateRenderer(config: OgTemplateRenderer): TemplateRenderer;
+declare function createRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>>(config: OgTemplateRenderer<TMap>): TemplateRenderer<TMap>;
 
 /**
  * OG image rendering engine.
@@ -366,35 +391,15 @@ declare function createTemplateRenderer(config: OgTemplateRenderer): TemplateRen
  *   - SVG rendering fails
  *   - PNG conversion fails
  */
-declare function renderTemplate(template: OgTemplate, params: OgTemplateParams | (() => Promise<OgTemplateParams>), options?: {
-    width: number;
-    height: number;
-}): Promise<Buffer>;
+declare function renderTemplate<TParams = OgTemplateParams>(template: OgTemplate<TParams>, params: TParams, options?: OgTemplateOptions): Promise<Buffer>;
 
-/**
- * Network utility for fetching remote resources with caching.
- *
- * This module provides HTTP fetching functionality for loading font files
- * and other binary assets from remote URLs, with built-in caching to avoid
- * redundant network requests for the same resources.
- */
-/**
- * Fetches a font file from a URL and returns it as an ArrayBuffer, with caching.
- *
- * This function is used to download font files from CDNs (like Google Fonts)
- * so they can be embedded in OG images during server-side rendering.
- * @param url - The URL of the font file to download
- * @returns Promise resolving to the font data as an ArrayBuffer
- *
- * @throws Will throw if the network request fails or the URL is invalid
- *
- * @example
- * // First call - downloads from network
- * const fontData1 = await loadFontFromUrl('https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMw2boKoduKmMEVuLyfAZ9hiA.woff2');
- *
- * // Second call - returns cached data (no network request)
- * const fontData2 = await loadFontFromUrl('https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMw2boKoduKmMEVuLyfAZ9hiA.woff2');
- */
-declare const loadFontFromUrl: (url: string) => Promise<ArrayBuffer>;
+type ClassValue = ClassArray | ClassDictionary | string | number | bigint | null | boolean | undefined;
+type ClassDictionary = Record<string, any>;
+type ClassArray = ClassValue[];
+declare function clsx(...inputs: ClassValue[]): string;
+
+declare const objectToStyle: (style: Record<string, string | number | undefined | null> | undefined | null, options?: {
+    isRTL?: boolean;
+}) => string;
 
-export { type OgEmojiProvider, type OgFontConfig, type OgFontFormat, type OgTemplate, type OgTemplateOptions, type OgTemplateParams, type OgTemplateRenderer, TemplateRenderer, createTemplateRenderer, defineTemplate, loadFontFromUrl, renderTemplate, validateTemplate };
+export { type OgCacheConfig, type OgEmojiProvider, type OgFontConfig, type OgFontFormat, type OgTemplate, type OgTemplateOptions, type OgTemplateParams, type OgTemplateRenderer, TemplateRenderer, clsx, createRenderer, defineTemplate, objectToStyle, renderTemplate, validateTemplate };

package/dist/index.d.ts

@@ -22,6 +22,30 @@ import { FontWeight, FontStyle } from 'satori';
  * - `openmoji`: Open-source emoji with outlined style
  */
 type OgEmojiProvider = 'twemoji' | 'fluent' | 'fluentFlat' | 'noto' | 'blobmoji' | 'openmoji';
+/**
+ * Cache configuration for fonts and icons.
+ *
+ * Supports two caching strategies:
+ * - Memory: Fast in-memory cache with LRU eviction
+ * - Filesystem: Persistent cache stored on disk
+ */
+type OgCacheConfig = {
+    /** Memory-based caching strategy */
+    type: 'memory';
+    /** Time-to-live in milliseconds (default: 3600000 = 1 hour) */
+    ttl?: number;
+    /** Maximum number of items to cache (default: 100) */
+    max?: number;
+} | {
+    /** Filesystem-based caching strategy */
+    type: 'filesystem';
+    /** Directory to store cache files (default: '.ogify-cache') */
+    dir?: string;
+    /** Time-to-live in milliseconds (default: 3600000 = 1 hour) */
+    ttl?: number;
+    /** Maximum number of items to cache (default: 100) */
+    max?: number;
+};
 /**
  * Supported font file formats.
  *
@@ -90,12 +114,15 @@ type OgFontConfig = {
  * `;
  */
 type OgTemplateOptions = {
-    /** User-provided parameters that populate the template (e.g., title, description, author) */
-    params: OgTemplateParams;
+    /** Custom fonts to use in this template */
+    fonts?: OgFontConfig[];
+    /** Optional emoji provider to use in this template */
+    emojiProvider?: OgEmojiProvider;
     /** Optional custom width in pixels (default: 1200) */
     width?: number;
     /** Optional custom height in pixels (default: 630) */
     height?: number;
+    isRTL?: boolean;
 };
 /**
  * Key-value pairs representing dynamic template parameters.
@@ -103,6 +130,7 @@ type OgTemplateOptions = {
  * Parameters are the data that gets injected into templates to create
  * personalized OG images. Values can be:
  * - Strings: Text content (titles, descriptions, names)
+ * - String Arrays: Lists of tags, categories
  * - Numbers: Counts, dates, metrics
  * - Booleans: Flags, toggles, states
  *
@@ -114,7 +142,7 @@ type OgTemplateOptions = {
  *   published: true
  * };
  */
-type OgTemplateParams = Record<string, string | number | boolean>;
+type OgTemplateParams = Record<string, string | string[] | number | boolean>;
 /**
  * Complete definition of an Open Graph image template.
  *
@@ -124,20 +152,16 @@ type OgTemplateParams = Record<string, string | number | boolean>;
  * - What fonts to use
  * - Metadata for identification
  */
-type OgTemplate = {
-    /** Unique identifier for this template (e.g., 'blog-post', 'product-card') */
-    id: string;
-    /** Human-readable name for display purposes */
-    name: string;
-    /** Brief description of what this template is used for */
-    description: string;
+type OgTemplate<TParams = OgTemplateParams> = {
     /**
      * Function that generates HTML markup from template parameters.
      *
      * The HTML should use inline styles (Tailwind-like utilities are supported).
      * Flexbox and basic CSS properties are supported by Satori.
      */
-    renderer: (props: OgTemplateOptions) => string;
+    renderer: (props: OgTemplateOptions & {
+        params: TParams;
+    }) => string;
     /**
      * Custom fonts to use in this template.
      *
@@ -159,16 +183,29 @@ type OgTemplate = {
  * The handler manages a registry of templates and provides a unified
  * interface for rendering them to images.
  */
-type OgTemplateRenderer = {
-    /** Array of template definitions to register */
-    templates: OgTemplate[];
+type OgTemplateRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>> = {
+    /** Map of template definitions to register, keyed by template ID */
+    templates: {
+        [K in keyof TMap]: OgTemplate<TMap[K]>;
+    };
     /**
-     * Default parameter values applied to all templates.
+     * Shared parameter values applied to all templates.
      *
      * These values are merged with user-provided parameters,
      * with user values taking precedence.
      */
-    defaultParams?: OgTemplateParams | (() => Promise<OgTemplateParams>);
+    sharedParams?: Partial<TMap[keyof TMap]> | (() => Promise<Partial<TMap[keyof TMap]>>);
+    /**
+     * Cache configuration for fonts and icons.
+     *
+     * When provided, enables LRU caching to improve performance by:
+     * - Reducing redundant network requests for fonts and emojis
+     * - Supporting memory or filesystem-based caching strategies
+     * - Configurable TTL and maximum cache size
+     *
+     * If not provided, falls back to simple in-memory caching.
+     */
+    cache?: OgCacheConfig;
     /**
      * Hook called before rendering.
      *
@@ -178,7 +215,7 @@ type OgTemplateRenderer = {
      * - Authentication checks
      * - Rate limiting
      */
-    beforeRender?: (templateId: string, params: OgTemplateParams) => void | Promise<void>;
+    beforeRender?: (templateId: keyof TMap, params: TMap[keyof TMap]) => void | Promise<void>;
     /**
      * Hook called after rendering.
      *
@@ -188,7 +225,7 @@ type OgTemplateRenderer = {
      * - Sending notifications
      * - Updating metrics
      */
-    afterRender?: (templateId: string, params: OgTemplateParams, imageBuffer: Buffer) => void | Promise<void>;
+    afterRender?: (templateId: keyof TMap, params: TMap[keyof TMap], imageBuffer: Buffer) => void | Promise<void>;
 };
 
 /**
@@ -217,7 +254,7 @@ type OgTemplateRenderer = {
  * @returns true if validation passes
  * @throws Error if any required field is missing or invalid
  */
-declare function validateTemplate(config: OgTemplate): boolean;
+declare function validateTemplate<TemplateParams>(config: OgTemplate<TemplateParams>): boolean;
 /**
  * Defines and validates a new OG template.
  *
@@ -229,17 +266,19 @@ declare function validateTemplate(config: OgTemplate): boolean;
  * - Type safety ensures correct template structure
  * - Clear intent in code (self-documenting)
  *
- * @param config - Complete template configuration including id, name, and renderer function
+ * @param config - Complete template configuration including renderer function and fonts
  * @returns The validated template configuration
  * @throws Error if validation fails
  */
-declare function defineTemplate(config: OgTemplate): OgTemplate;
+declare function defineTemplate<TemplateParams>(config: OgTemplate<TemplateParams>): OgTemplate<TemplateParams>;
 /**
  * Template Handler class for managing multiple templates and rendering them to images.
  */
-declare class TemplateRenderer {
+declare class TemplateRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>> {
     /** Configuration including global settings and lifecycle hooks */
     private config;
+    /** Cache manager for fonts and icons */
+    private cacheManager;
     /**
      * Internal registry mapping template IDs to template definitions.
      *
@@ -254,14 +293,14 @@ declare class TemplateRenderer {
      *
      * @param config - Handler configuration with templates and global settings
      */
-    constructor(config: OgTemplateRenderer);
+    constructor(config: OgTemplateRenderer<TMap>);
     /**
      * Registers multiple templates into the internal registry.
      *
      * Templates are indexed by their ID for fast lookup.
      * If a template with the same ID already exists, it will be overwritten.
      *
-     * @param templates - Array of template definitions to register
+     * @param templates - Map of template definitions to register
      */
     private registerTemplates;
     /**
@@ -275,18 +314,7 @@ declare class TemplateRenderer {
      * @param id - The template ID to look up
      * @returns The template definition, or undefined if not found
      */
-    getTemplate(id: string): OgTemplate | undefined;
-    /**
-     * Gets all registered template IDs.
-     *
-     * Useful for:
-     * - Building template selection dropdowns
-     * - Listing available templates in documentation
-     * - Debugging template registration
-     *
-     * @returns Array of template IDs
-     */
-    getTemplateIds(): string[];
+    getTemplate<K extends keyof TMap>(id: K): OgTemplate<TMap[K]> | undefined;
     /**
      * Renders a template to a PNG image buffer.
      *
@@ -308,17 +336,14 @@ declare class TemplateRenderer {
      * - Throws if rendering fails (font loading, HTML generation, etc.)
      *
      * @param templateId - ID of the template to render
-     * @param params - Parameters to pass to the template
+     * @param params - Parameters (or function returning params) to pass to the template
      * @param options - Optional rendering options
      * @param options.width - Custom image width in pixels (default: 1200)
      * @param options.height - Custom image height in pixels (default: 630)
      * @returns Promise resolving to a PNG image buffer
      * @throws Error if template is not found or rendering fails
      */
-    renderToImage(templateId: string, params: OgTemplateParams | (() => Promise<OgTemplateParams>), options?: {
-        width: number;
-        height: number;
-    }): Promise<Buffer>;
+    renderToImage<K extends keyof TMap>(templateId: K, params: TMap[K] | (() => Promise<TMap[K]>), options?: OgTemplateOptions): Promise<Buffer>;
 }
 /**
  * Factory function to create a new TemplateRenderer instance.
@@ -329,7 +354,7 @@ declare class TemplateRenderer {
  * @param config - Handler configuration with templates and settings
  * @returns A new TemplateRenderer instance
  */
-declare function createTemplateRenderer(config: OgTemplateRenderer): TemplateRenderer;
+declare function createRenderer<TMap extends Record<string, OgTemplateParams> = Record<string, OgTemplateParams>>(config: OgTemplateRenderer<TMap>): TemplateRenderer<TMap>;
 
 /**
  * OG image rendering engine.
@@ -366,35 +391,15 @@ declare function createTemplateRenderer(config: OgTemplateRenderer): TemplateRen
  *   - SVG rendering fails
  *   - PNG conversion fails
  */
-declare function renderTemplate(template: OgTemplate, params: OgTemplateParams | (() => Promise<OgTemplateParams>), options?: {
-    width: number;
-    height: number;
-}): Promise<Buffer>;
+declare function renderTemplate<TParams = OgTemplateParams>(template: OgTemplate<TParams>, params: TParams, options?: OgTemplateOptions): Promise<Buffer>;
 
-/**
- * Network utility for fetching remote resources with caching.
- *
- * This module provides HTTP fetching functionality for loading font files
- * and other binary assets from remote URLs, with built-in caching to avoid
- * redundant network requests for the same resources.
- */
-/**
- * Fetches a font file from a URL and returns it as an ArrayBuffer, with caching.
- *
- * This function is used to download font files from CDNs (like Google Fonts)
- * so they can be embedded in OG images during server-side rendering.
- * @param url - The URL of the font file to download
- * @returns Promise resolving to the font data as an ArrayBuffer
- *
- * @throws Will throw if the network request fails or the URL is invalid
- *
- * @example
- * // First call - downloads from network
- * const fontData1 = await loadFontFromUrl('https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMw2boKoduKmMEVuLyfAZ9hiA.woff2');
- *
- * // Second call - returns cached data (no network request)
- * const fontData2 = await loadFontFromUrl('https://fonts.gstatic.com/s/inter/v12/UcCO3FwrK3iLTeHuS_fvQtMwCp50KnMw2boKoduKmMEVuLyfAZ9hiA.woff2');
- */
-declare const loadFontFromUrl: (url: string) => Promise<ArrayBuffer>;
+type ClassValue = ClassArray | ClassDictionary | string | number | bigint | null | boolean | undefined;
+type ClassDictionary = Record<string, any>;
+type ClassArray = ClassValue[];
+declare function clsx(...inputs: ClassValue[]): string;
+
+declare const objectToStyle: (style: Record<string, string | number | undefined | null> | undefined | null, options?: {
+    isRTL?: boolean;
+}) => string;
 
-export { type OgEmojiProvider, type OgFontConfig, type OgFontFormat, type OgTemplate, type OgTemplateOptions, type OgTemplateParams, type OgTemplateRenderer, TemplateRenderer, createTemplateRenderer, defineTemplate, loadFontFromUrl, renderTemplate, validateTemplate };
+export { type OgCacheConfig, type OgEmojiProvider, type OgFontConfig, type OgFontFormat, type OgTemplate, type OgTemplateOptions, type OgTemplateParams, type OgTemplateRenderer, TemplateRenderer, clsx, createRenderer, defineTemplate, objectToStyle, renderTemplate, validateTemplate };