import { Config } from 'dompurify';
import { Maybe } from 'yummies/types';

/**
 * @internal Separate chunk so DOMPurify is tree-shaken away when `sanitizeHtml` is not used.
 * Consumers import from `yummies/html` — this module is not a public entry point.
 */

type SanitizeHtmlFn = ((html: Maybe<string>, config?: Config) => string) & {
    /**
     * Default DOMPurify settings
     */
    defaults: Config;
};
/**
 * Sanitizes HTML using the default allowlist merged with custom DOMPurify config.
 *
 * Default DOMPurify settings are exposed on `sanitizeHtml.defaults` and can be
 * overridden per call via `config`.
 *
 * @example
 * ```ts
 * sanitizeHtml('<img src=x onerror=alert(1) />');
 * ```
 */
declare const sanitizeHtml: SanitizeHtmlFn;

export { sanitizeHtml };