@humanspeak/svelte-markdown/dist/utils/unsupportedHtmlRenderers.js

Markdown and HTML renderer for Svelte 5 — built for rendering streaming AI agent output from Claude Code, ChatGPT, and agentic workflows. XSS-safe defaults, streaming-aware sanitization, token caching, TypeScript types, and Svelte 5 runes.

import Html, { UnsupportedHTML } from '../renderers/html/index.js';
import { htmlRendererKeysInternal } from './rendererKeys.js';
import { createFilterUtilities } from './createFilterUtilities.js';
// Create filter utilities using the generic factory
const filterUtils = createFilterUtilities(htmlRendererKeysInternal, UnsupportedHTML, Html);
/**
 * Builds a map of HTML renderers where every known HTML tag is mapped to `UnsupportedHTML`.
 * This is useful when you want to disable all built‑in HTML rendering and provide
 * explicit allow-lists or a minimal subset afterwards.
 *
 * @function buildUnsupportedHTML
 * @returns {HtmlRenderers} A map containing all tags set to `UnsupportedHTML`.
 * @example
 * import { buildUnsupportedHTML } from '@humanspeak/svelte-markdown'
 * const renderers = {
 *   html: buildUnsupportedHTML()
 * }
 */
export const buildUnsupportedHTML = filterUtils.buildUnsupported;
/**
 * Produces an HTML renderer map that allows only the specified tags.
 * All non‑listed tags are set to `UnsupportedHTML`.
 *
 * Each entry can be either a tag name (to use the library's default component for that tag),
 * or a tuple `[tag, component]` to specify a custom component for that tag.
 *
 * @function allowHtmlOnly
 * @param {Array<keyof HtmlRenderers | [keyof HtmlRenderers, Component | null]>} allowed
 *        Tag names to allow, or tuples specifying a custom component per allowed tag.
 *        Any tag not listed will be mapped to `UnsupportedHTML`.
 * @returns {HtmlRenderers} A renderer map with only the provided tags enabled.
 * @example
 * // Only allow strong/em/a with default components; everything else UnsupportedHTML
 * const html = allowHtmlOnly(['strong', 'em', 'a'])
 *
 * @example
 * // Allow a custom component for div while allowing the default for a
 * const html = allowHtmlOnly([['div', MyDiv], 'a'])
 */
export const allowHtmlOnly = filterUtils.allowOnly;
/**
 * Produces an HTML renderer map that excludes only the specified tags.
 * Excluded tags are mapped to `UnsupportedHTML`, while all other tags use the
 * library's default components. Optionally, you can override specific non‑excluded
 * tags with custom components using `[tag, component]` tuples.
 *
 * Exclusions take precedence over overrides. If a tag is listed in `excluded`, an
 * override for the same tag will be ignored.
 *
 * @function excludeHtmlOnly
 * @param {Array<keyof HtmlRenderers>} excluded
 *        Tag names to exclude (set to `UnsupportedHTML`).
 * @param {Array<[keyof HtmlRenderers, Component | null]>} [overrides]
 *        Optional tuples mapping non‑excluded tags to custom components.
 * @returns {HtmlRenderers} A renderer map with only the provided tags excluded.
 * @example
 * // Disable just span and div, keep others as defaults
 * const html = excludeHtmlOnly(['span', 'div'])
 *
 * @example
 * // Disable span; override 'a' to CustomA component
 * const html = excludeHtmlOnly(['span'], [['a', CustomA]])
 */
export const excludeHtmlOnly = filterUtils.excludeOnly;