/**
 * Template registry for reusable DOM.
 *
 * @remarks
 * Templates are just reusable HTML. The registry provides async access
 * to templates from various sources: inline `<template>` tags, fetched
 * files, or custom sources.
 *
 * @packageDocumentation
 */
/**
 * Interface for template retrieval.
 *
 * @remarks
 * Implementations can source templates from anywhere:
 * inline tags, files, network, bundled, etc.
 */
export interface TemplateRegistry {
    /**
     * Get a template by name.
     *
     * @param name - Template name/path
     * @returns The template HTML string
     */
    get(name: string): Promise<string>;
}
/**
 * Create a template registry with inline -> fetch fallback.
 *
 * @remarks
 * First checks for a `<template id="{name}">` in the document.
 * If not found, fetches from `/{name}` (or custom base path).
 * Results are cached.
 *
 * @param options - Configuration options
 * @returns A template registry
 *
 * @example
 * ```ts
 * // Default: inline -> fetch from /
 * const templates = createTemplateRegistry();
 *
 * // Custom base path
 * const templates = createTemplateRegistry({ basePath: '/templates/' });
 *
 * // Usage
 * const html = await templates.get('dialog');
 * ```
 */
export declare function createTemplateRegistry(options?: {
    basePath?: string;
    fetch?: typeof globalThis.fetch;
}): TemplateRegistry;
/**
 * Create a simple in-memory template registry.
 *
 * @remarks
 * Useful for testing or when templates are bundled.
 *
 * @param templates - Map of template names to HTML
 * @returns A template registry
 *
 * @example
 * ```ts
 * const templates = createMemoryRegistry({
 *   dialog: '<div class="dialog"><slot></slot></div>',
 *   card: '<div class="card"><slot name="title"></slot><slot></slot></div>'
 * });
 * ```
 */
export declare function createMemoryRegistry(templates: Record<string, string>): TemplateRegistry;
/**
 * Create a server-side template registry that reads from filesystem.
 *
 * @remarks
 * For Node.js/server environments. Reads templates from disk.
 *
 * @param readFile - Async file reader function
 * @param basePath - Base directory path
 * @returns A template registry
 *
 * @example
 * ```ts
 * import { readFile } from 'fs/promises';
 *
 * const templates = createServerRegistry(
 *   (path) => readFile(path, 'utf-8'),
 *   './templates/'
 * );
 * ```
 */
export declare function createServerRegistry(readFile: (path: string) => Promise<string>, basePath?: string): TemplateRegistry;