import { type SanitizedHtml } from '../security/trusted-html';
/**
 * Public shape of a boolean HTML attribute created by {@link bool}.
 *
 * This type is returned from {@link bool} and can be interpolated into
 * {@link html} / {@link safeHtml} templates to conditionally include or omit
 * an attribute by name. The internal marker property used for runtime checks
 * remains private and is not part of the public API.
 *
 * @example
 * ```ts
 * const disabled = bool('disabled', isDisabled);
 * const button = html`<button ${disabled}>Click</button>`;
 * ```
 */
export interface BooleanAttribute {
    readonly enabled: boolean;
    readonly name: string;
}
/**
 * Creates a boolean-attribute marker for the {@link html} and {@link safeHtml} template tags.
 *
 * When the condition is truthy, the attribute name is rendered without a value.
 * When the condition is falsy, an empty string is rendered and any surrounding
 * template-literal whitespace is preserved.
 *
 * @param name - HTML attribute name to emit
 * @param enabled - Whether the boolean attribute should be present
 * @returns Internal marker consumed by template tags
 *
 * @example
 * ```ts
 * html`<button ${bool('disabled', isDisabled)}>Save</button>`;
 * // Result when isDisabled = true: '<button disabled>Save</button>'
 * ```
 */
export declare const bool: (name: string, enabled: unknown) => BooleanAttribute;
/**
 * Tagged template literal for creating HTML strings.
 *
 * This function handles interpolation of values into HTML templates,
 * converting null/undefined to empty strings.
 *
 * @param strings - Template literal string parts
 * @param values - Interpolated values
 * @returns Combined HTML string
 *
 * @example
 * ```ts
 * const name = 'World';
 * const greeting = html`<h1>Hello, ${name}!</h1>`;
 * // Result: '<h1>Hello, World!</h1>'
 * ```
 */
export declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => string;
/**
 * Escapes HTML entities in interpolated values for XSS prevention.
 * Use this when you need to safely embed user content in templates.
 *
 * @param strings - Template literal string parts
 * @param values - Interpolated values to escape
 * @returns Branded escaped HTML string safe for bQuery template composition
 *
 * @example
 * ```ts
 * const userInput = '<script>alert("xss")</script>';
 * const safe = safeHtml`<div>${userInput}</div>`;
 * // Result: '<div>&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;</div>'
 * ```
 */
export declare const safeHtml: (strings: TemplateStringsArray, ...values: unknown[]) => SanitizedHtml;
//# sourceMappingURL=html.d.ts.map