yummies 7.19.3 → 7.20.0

package/html.cjs

@@ -1,67 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_chunk = require("./chunk-CZWwpsFl.cjs");
-let dompurify = require("dompurify");
-dompurify = require_chunk.__toESM(dompurify, 1);
+const require_sanitize_html = require("./sanitize-html.cjs");
 let yummies_media = require("yummies/media");
-//#region src/html.ts
+//#region src/html/calc-scrollbar-width.ts
 /**
-* ---header-docs-section---
-* # yummies/html
-*
-* ## Description
-*
-* DOM-centric utilities: sanitizing HTML with **DOMPurify**, computed style probes, downloads via
-* temporary anchors, and small string helpers for safe markup. Prefer these over `innerHTML` with
-* raw user input; keep CSP and server-side validation as the real security boundary.
-*
-* ## Usage
-*
-* ```ts
-* import { getComputedColor } from "yummies/html";
-* ```
-*/
-/**
-* Extracts an RGB value from any valid CSS color.
-*
-* Not recommended for frequent use because it triggers a reflow.
+* Calculates the scrollbar width.
 */
-var getComputedColor = (color) => {
-	if (!color) return null;
-	const d = document.createElement("div");
-	d.style.color = color;
-	document.body.append(d);
-	const rgbcolor = globalThis.getComputedStyle(d).color;
-	const match = /rgba?\((\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*\d+[.d+]*)*\)/g.exec(rgbcolor);
-	d.remove();
-	if (!match) return null;
-	return `${match[1]}, ${match[2]}, ${match[3]}`;
+var calcScrollbarWidth = (elementToAppend = document.body) => {
+	const outer = document.createElement("div");
+	outer.style.visibility = "hidden";
+	outer.style.width = "100px";
+	outer.style.overflow = "scroll";
+	elementToAppend.append(outer);
+	const inner = document.createElement("div");
+	inner.style.width = "100%";
+	outer.append(inner);
+	const scrollbarWidth = outer.offsetWidth - inner.offsetWidth;
+	outer.parentNode?.removeChild(outer);
+	return scrollbarWidth;
 };
+//#endregion
+//#region src/html/check-element-has-parent.ts
 /**
-* Triggers a file download by creating and clicking a temporary anchor element.
+* Checks whether the element is nested inside the provided parent element.
 *
 * @example
 * ```ts
-* downloadUsingAnchor('/report.pdf', 'report.pdf');
+* checkElementHasParent(childElement, modalElement);
 * ```
 */
-var downloadUsingAnchor = (urlOrBlob, fileName) => {
-	const url = (0, yummies_media.blobToUrl)(urlOrBlob);
-	const a = document.createElement("a");
-	a.href = url;
-	a.download = fileName ?? "file";
-	a.target = "_blank";
-	document.body.append(a);
-	a.click();
-	a.remove();
+var checkElementHasParent = (element, parent) => {
+	let node = element;
+	if (!parent) return false;
+	while (node != null) if (node === parent) return true;
+	else node = node.parentElement;
+	return false;
 };
-/**
-* Surrounds string in an anchor tag
-*/
-function wrapTextToTagLink(link) {
-	const descr = String(link).replace(/^(https?:\/{0,2})?(w{3}\.)?/, "www.");
-	if (!/^https?:\/{2}/.test(link)) link = `http://${link}`;
-	return `<a href=${link} target="_blank">${descr}</a>`;
-}
+//#endregion
+//#region src/html/collect-offset-top.ts
 /**
 * Collects the cumulative `offsetTop` value through the element parent chain.
 *
@@ -79,19 +54,66 @@ var collectOffsetTop = (element) => {
 	}
 	return offsetTop;
 };
+//#endregion
+//#region src/html/download-using-anchor.ts
 /**
-* Prevents the default browser action and stops event propagation.
+* Triggers a file download by creating and clicking a temporary anchor element.
 *
 * @example
 * ```ts
-* button.addEventListener('click', (event) => skipEvent(event));
+* downloadUsingAnchor('/report.pdf', 'report.pdf');
 * ```
 */
-var skipEvent = (e) => {
-	e.preventDefault();
-	e.stopPropagation();
-	return false;
+var downloadUsingAnchor = (urlOrBlob, fileName) => {
+	const url = (0, yummies_media.blobToUrl)(urlOrBlob);
+	const a = document.createElement("a");
+	a.href = url;
+	a.download = fileName ?? "file";
+	a.target = "_blank";
+	document.body.append(a);
+	a.click();
+	a.remove();
 };
+//#endregion
+//#region src/html/get-computed-color.ts
+/**
+* Extracts an RGB value from any valid CSS color.
+*
+* Not recommended for frequent use because it triggers a reflow.
+*/
+var getComputedColor = (color) => {
+	if (!color) return null;
+	const d = document.createElement("div");
+	d.style.color = color;
+	document.body.append(d);
+	const rgbcolor = globalThis.getComputedStyle(d).color;
+	const match = /rgba?\((\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(,\s*\d+[.d+]*)*\)/g.exec(rgbcolor);
+	d.remove();
+	if (!match) return null;
+	return `${match[1]}, ${match[2]}, ${match[3]}`;
+};
+//#endregion
+//#region src/html/get-element-inner-height.ts
+/**
+* Calculates the inner height of an HTML element, accounting for padding.
+*/
+function getElementInnerHeight(element) {
+	const { clientHeight } = element;
+	const { paddingTop, paddingBottom } = getComputedStyle(element);
+	return clientHeight - Number.parseFloat(paddingTop) - Number.parseFloat(paddingBottom);
+}
+//#endregion
+//#region src/html/get-element-inner-width.ts
+/**
+* Calculates the inner width of an HTML element, accounting for padding.
+*/
+function getElementInnerWidth(el) {
+	const { clientWidth } = el;
+	const { paddingLeft, paddingRight } = getComputedStyle(el);
+	return clientWidth - Number.parseFloat(paddingLeft) - Number.parseFloat(paddingRight);
+}
+//#endregion
+//#region src/html/global-scroll-into-view-for-y.ts
 /**
 * Scrolls the page vertically to the viewport section containing the target element.
 *
@@ -111,87 +133,45 @@ var globalScrollIntoViewForY = (node) => {
 		behavior: "smooth"
 	});
 };
-var sanitizeDefaults = {
-	ALLOWED_TAGS: [
-		"a",
-		"article",
-		"b",
-		"blockquote",
-		"br",
-		"caption",
-		"code",
-		"del",
-		"details",
-		"div",
-		"em",
-		"h1",
-		"h2",
-		"h3",
-		"h4",
-		"h5",
-		"h6",
-		"hr",
-		"i",
-		"img",
-		"ins",
-		"kbd",
-		"li",
-		"main",
-		"ol",
-		"p",
-		"pre",
-		"section",
-		"span",
-		"strong",
-		"sub",
-		"summary",
-		"sup",
-		"table",
-		"tbody",
-		"td",
-		"th",
-		"thead",
-		"tr",
-		"u",
-		"ul"
-	],
-	ALLOWED_ATTR: [
-		"href",
-		"target",
-		"name",
-		"src",
-		"class"
-	]
-};
+//#endregion
+//#region src/html/is-prefers-dark-theme.ts
 /**
-* Sanitizes HTML using the default allowlist merged with custom DOMPurify config.
+* Checks whether the user prefers a dark color scheme.
 *
 * @example
 * ```ts
-* sanitizeHtml('<img src=x onerror=alert(1) />');
+* const prefersDark = isPrefersDarkTheme();
 * ```
 */
-var sanitizeHtml = (html, config) => {
-	return dompurify.default.sanitize(html || "", {
-		...sanitizeDefaults,
-		...config
-	});
-};
+var isPrefersDarkTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: dark)")?.matches;
+//#endregion
+//#region src/html/is-prefers-light-theme.ts
 /**
-* Checks whether the element is nested inside the provided parent element.
+* Checks whether the user prefers a light color scheme.
 *
 * @example
 * ```ts
-* checkElementHasParent(childElement, modalElement);
+* const prefersLight = isPrefersLightTheme();
 * ```
 */
-var checkElementHasParent = (element, parent) => {
-	let node = element;
-	if (!parent) return false;
-	while (node != null) if (node === parent) return true;
-	else node = node.parentElement;
+var isPrefersLightTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: light)")?.matches;
+//#endregion
+//#region src/html/skip-event.ts
+/**
+* Prevents the default browser action and stops event propagation.
+*
+* @example
+* ```ts
+* button.addEventListener('click', (event) => skipEvent(event));
+* ```
+*/
+var skipEvent = (e) => {
+	e.preventDefault();
+	e.stopPropagation();
 	return false;
 };
+//#endregion
+//#region src/html/start-view-transition-safety.ts
 /**
 * Executes a function within a view transition if supported by the browser.
 *
@@ -204,56 +184,16 @@ var startViewTransitionSafety = (fn, params) => {
 	if (typeof document !== "undefined" && document.startViewTransition && !params?.disabled) return document.startViewTransition(fn);
 	fn();
 };
+//#endregion
+//#region src/html/wrap-text-to-tag-link.ts
 /**
-* Calculates the scrollbar width.
-*/
-var calcScrollbarWidth = (elementToAppend = document.body) => {
-	const outer = document.createElement("div");
-	outer.style.visibility = "hidden";
-	outer.style.width = "100px";
-	outer.style.overflow = "scroll";
-	elementToAppend.append(outer);
-	const inner = document.createElement("div");
-	inner.style.width = "100%";
-	outer.append(inner);
-	const scrollbarWidth = outer.offsetWidth - inner.offsetWidth;
-	outer.parentNode?.removeChild(outer);
-	return scrollbarWidth;
-};
-/**
-* Calculates the inner height of an HTML element, accounting for padding.
-*/
-function getElementInnerHeight(element) {
-	const { clientHeight } = element;
-	const { paddingTop, paddingBottom } = getComputedStyle(element);
-	return clientHeight - Number.parseFloat(paddingTop) - Number.parseFloat(paddingBottom);
-}
-/**
-* Calculates the inner width of an HTML element, accounting for padding.
+* Surrounds string in an anchor tag
 */
-function getElementInnerWidth(el) {
-	const { clientWidth } = el;
-	const { paddingLeft, paddingRight } = getComputedStyle(el);
-	return clientWidth - Number.parseFloat(paddingLeft) - Number.parseFloat(paddingRight);
+function wrapTextToTagLink(link) {
+	const descr = String(link).replace(/^(https?:\/{0,2})?(w{3}\.)?/, "www.");
+	if (!/^https?:\/{2}/.test(link)) link = `http://${link}`;
+	return `<a href=${link} target="_blank">${descr}</a>`;
 }
-/**
-* Checks whether the user prefers a dark color scheme.
-*
-* @example
-* ```ts
-* const prefersDark = isPrefersDarkTheme();
-* ```
-*/
-var isPrefersDarkTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: dark)")?.matches;
-/**
-* Checks whether the user prefers a light color scheme.
-*
-* @example
-* ```ts
-* const prefersLight = isPrefersLightTheme();
-* ```
-*/
-var isPrefersLightTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: light)")?.matches;
 //#endregion
 exports.calcScrollbarWidth = calcScrollbarWidth;
 exports.checkElementHasParent = checkElementHasParent;
@@ -265,7 +205,7 @@ exports.getElementInnerWidth = getElementInnerWidth;
 exports.globalScrollIntoViewForY = globalScrollIntoViewForY;
 exports.isPrefersDarkTheme = isPrefersDarkTheme;
 exports.isPrefersLightTheme = isPrefersLightTheme;
-exports.sanitizeHtml = sanitizeHtml;
+exports.sanitizeHtml = require_sanitize_html.sanitizeHtml;
 exports.skipEvent = skipEvent;
 exports.startViewTransitionSafety = startViewTransitionSafety;
 exports.wrapTextToTagLink = wrapTextToTagLink;

package/html.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"html.cjs","names":[],"sources":["../src/html.ts"],"sourcesContent":["/**\n * ---header-docs-section---\n * # yummies/html\n *\n * ## Description\n *\n * DOM-centric utilities: sanitizing HTML with **DOMPurify**, computed style probes, downloads via\n * temporary anchors, and small string helpers for safe markup. Prefer these over `innerHTML` with\n * raw user input; keep CSP and server-side validation as the real security boundary.\n *\n * ## Usage\n *\n * ```ts\n * import { getComputedColor } from \"yummies/html\";\n * ```\n */\n\nimport DOMPurify, { type Config as DOMPurifyConfig } from 'dompurify';\nimport { blobToUrl } from 'yummies/media';\nimport type { Maybe } from 'yummies/types';\n\n/**\n * Extracts an RGB value from any valid CSS color.\n *\n * Not recommended for frequent use because it triggers a reflow.\n */\nexport const getComputedColor = (color?: string): string | null => {\n  if (!color) return null;\n\n  const d = document.createElement('div');\n  d.style.color = color;\n  document.body.append(d);\n  const rgbcolor = globalThis.getComputedStyle(d).color;\n  const match =\n    /rgba?\\((\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*(,\\s*\\d+[.d+]*)*\\)/g.exec(rgbcolor);\n\n  d.remove();\n\n  if (!match) return null;\n\n  return `${match[1]}, ${match[2]}, ${match[3]}`;\n};\n\n/**\n * Triggers a file download by creating and clicking a temporary anchor element.\n *\n * @example\n * ```ts\n * downloadUsingAnchor('/report.pdf', 'report.pdf');\n * ```\n */\nexport const downloadUsingAnchor = (\n  urlOrBlob: string | Blob,\n  fileName?: string,\n) => {\n  const url = blobToUrl(urlOrBlob);\n\n  const a = document.createElement('a');\n  a.href = url;\n\n  a.download = fileName ?? 'file';\n\n  a.target = '_blank';\n\n  document.body.append(a);\n\n  a.click();\n\n  a.remove();\n};\n\n/**\n * Surrounds string in an anchor tag\n */\nexport function wrapTextToTagLink(link: string) {\n  const descr = String(link).replace(/^(https?:\\/{0,2})?(w{3}\\.)?/, 'www.');\n  if (!/^https?:\\/{2}/.test(link)) link = `http://${link}`;\n  return `<a href=${link} target=\"_blank\">${descr}</a>`;\n}\n\n/**\n * Collects the cumulative `offsetTop` value through the element parent chain.\n *\n * @example\n * ```ts\n * const offsetTop = collectOffsetTop(document.getElementById('section'));\n * ```\n */\nexport const collectOffsetTop = (element: HTMLElement | null) => {\n  let offsetTop = 0;\n  let node = element;\n\n  while (node != null) {\n    offsetTop += node.offsetTop;\n    node = node.parentElement;\n  }\n\n  return offsetTop;\n};\n\n/**\n * Prevents the default browser action and stops event propagation.\n *\n * @example\n * ```ts\n * button.addEventListener('click', (event) => skipEvent(event));\n * ```\n */\nexport const skipEvent = (e: Event) => {\n  e.preventDefault();\n  e.stopPropagation();\n\n  return false;\n};\n\n/**\n * Scrolls the page vertically to the viewport section containing the target element.\n *\n * @example\n * ```ts\n * globalScrollIntoViewForY(document.getElementById('footer')!);\n * ```\n */\nexport const globalScrollIntoViewForY = (node: HTMLElement) => {\n  const scrollContainer = document.body;\n  const pageHeight = window.innerHeight;\n  const nodeBounding = node.getBoundingClientRect();\n  const scrollPagesCount = scrollContainer.scrollHeight / pageHeight;\n\n  const scrollPageNumber = Math.min(\n    Math.max(nodeBounding.top / pageHeight, 1),\n    scrollPagesCount,\n  );\n\n  window.scroll({\n    top: scrollPageNumber * pageHeight,\n    behavior: 'smooth',\n  });\n};\n\nconst sanitizeDefaults: DOMPurifyConfig = {\n  ALLOWED_TAGS: [\n    'a',\n    'article',\n    'b',\n    'blockquote',\n    'br',\n    'caption',\n    'code',\n    'del',\n    'details',\n    'div',\n    'em',\n    'h1',\n    'h2',\n    'h3',\n    'h4',\n    'h5',\n    'h6',\n    'hr',\n    'i',\n    'img',\n    'ins',\n    'kbd',\n    'li',\n    'main',\n    'ol',\n    'p',\n    'pre',\n    'section',\n    'span',\n    'strong',\n    'sub',\n    'summary',\n    'sup',\n    'table',\n    'tbody',\n    'td',\n    'th',\n    'thead',\n    'tr',\n    'u',\n    'ul',\n  ],\n  ALLOWED_ATTR: ['href', 'target', 'name', 'src', 'class'],\n};\n\n/**\n * Sanitizes HTML using the default allowlist merged with custom DOMPurify config.\n *\n * @example\n * ```ts\n * sanitizeHtml('<img src=x onerror=alert(1) />');\n * ```\n */\nexport const sanitizeHtml = (html: Maybe<string>, config?: DOMPurifyConfig) => {\n  return DOMPurify.sanitize(html || '', {\n    ...sanitizeDefaults,\n    ...config,\n  });\n};\n\n/**\n * Checks whether the element is nested inside the provided parent element.\n *\n * @example\n * ```ts\n * checkElementHasParent(childElement, modalElement);\n * ```\n */\nexport const checkElementHasParent = (\n  element: HTMLElement | null,\n  parent: Maybe<HTMLElement>,\n) => {\n  let node = element;\n\n  if (!parent) return false;\n\n  while (node != null) {\n    if (node === parent) {\n      return true;\n    } else {\n      node = node.parentElement;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Executes a function within a view transition if supported by the browser.\n *\n * @param {VoidFunction} fn - The function to be executed.\n * @returns {ViewTransition} - The result of the executed function.\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/startViewTransition | MDN: Document.startViewTransition}\n */\nexport const startViewTransitionSafety = (\n  fn: VoidFunction,\n  params?: { disabled?: boolean },\n) => {\n  if (\n    typeof document !== 'undefined' &&\n    document.startViewTransition &&\n    !params?.disabled\n  ) {\n    return document.startViewTransition(fn);\n  }\n  fn();\n};\n\n/**\n * Calculates the scrollbar width.\n */\nexport const calcScrollbarWidth = (elementToAppend = document.body) => {\n  const outer = document.createElement('div');\n\n  outer.style.visibility = 'hidden';\n  outer.style.width = '100px';\n  outer.style.overflow = 'scroll';\n\n  elementToAppend.append(outer);\n\n  const inner = document.createElement('div');\n  inner.style.width = '100%';\n\n  outer.append(inner);\n\n  const scrollbarWidth = outer.offsetWidth - inner.offsetWidth;\n\n  outer.parentNode?.removeChild(outer);\n\n  return scrollbarWidth;\n};\n\n/**\n * Calculates the inner height of an HTML element, accounting for padding.\n */\nexport function getElementInnerHeight(element: HTMLElement) {\n  const { clientHeight } = element;\n  const { paddingTop, paddingBottom } = getComputedStyle(element);\n  return (\n    clientHeight -\n    Number.parseFloat(paddingTop) -\n    Number.parseFloat(paddingBottom)\n  );\n}\n\n/**\n * Calculates the inner width of an HTML element, accounting for padding.\n */\nexport function getElementInnerWidth(el: HTMLElement) {\n  const { clientWidth } = el;\n  const { paddingLeft, paddingRight } = getComputedStyle(el);\n  return (\n    clientWidth -\n    Number.parseFloat(paddingLeft) -\n    Number.parseFloat(paddingRight)\n  );\n}\n\n/**\n * Checks whether the user prefers a dark color scheme.\n *\n * @example\n * ```ts\n * const prefersDark = isPrefersDarkTheme();\n * ```\n */\nexport const isPrefersDarkTheme = () =>\n  !!globalThis.matchMedia?.('(prefers-color-scheme: dark)')?.matches;\n\n/**\n * Checks whether the user prefers a light color scheme.\n *\n * @example\n * ```ts\n * const prefersLight = isPrefersLightTheme();\n * ```\n */\nexport const isPrefersLightTheme = () =>\n  !!globalThis.matchMedia?.('(prefers-color-scheme: light)')?.matches;\n"],"mappings":"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"}
+{"version":3,"file":"html.cjs","names":[],"sources":["../src/html/calc-scrollbar-width.ts","../src/html/check-element-has-parent.ts","../src/html/collect-offset-top.ts","../src/html/download-using-anchor.ts","../src/html/get-computed-color.ts","../src/html/get-element-inner-height.ts","../src/html/get-element-inner-width.ts","../src/html/global-scroll-into-view-for-y.ts","../src/html/is-prefers-dark-theme.ts","../src/html/is-prefers-light-theme.ts","../src/html/skip-event.ts","../src/html/start-view-transition-safety.ts","../src/html/wrap-text-to-tag-link.ts"],"sourcesContent":["/**\n * Calculates the scrollbar width.\n */\nexport const calcScrollbarWidth = (elementToAppend = document.body) => {\n  const outer = document.createElement('div');\n\n  outer.style.visibility = 'hidden';\n  outer.style.width = '100px';\n  outer.style.overflow = 'scroll';\n\n  elementToAppend.append(outer);\n\n  const inner = document.createElement('div');\n  inner.style.width = '100%';\n\n  outer.append(inner);\n\n  const scrollbarWidth = outer.offsetWidth - inner.offsetWidth;\n\n  outer.parentNode?.removeChild(outer);\n\n  return scrollbarWidth;\n};\n","import type { Maybe } from 'yummies/types';\n\n/**\n * Checks whether the element is nested inside the provided parent element.\n *\n * @example\n * ```ts\n * checkElementHasParent(childElement, modalElement);\n * ```\n */\nexport const checkElementHasParent = (\n  element: HTMLElement | null,\n  parent: Maybe<HTMLElement>,\n) => {\n  let node = element;\n\n  if (!parent) return false;\n\n  while (node != null) {\n    if (node === parent) {\n      return true;\n    } else {\n      node = node.parentElement;\n    }\n  }\n\n  return false;\n};\n","/**\n * Collects the cumulative `offsetTop` value through the element parent chain.\n *\n * @example\n * ```ts\n * const offsetTop = collectOffsetTop(document.getElementById('section'));\n * ```\n */\nexport const collectOffsetTop = (element: HTMLElement | null) => {\n  let offsetTop = 0;\n  let node = element;\n\n  while (node != null) {\n    offsetTop += node.offsetTop;\n    node = node.parentElement;\n  }\n\n  return offsetTop;\n};\n","import { blobToUrl } from 'yummies/media';\n\n/**\n * Triggers a file download by creating and clicking a temporary anchor element.\n *\n * @example\n * ```ts\n * downloadUsingAnchor('/report.pdf', 'report.pdf');\n * ```\n */\nexport const downloadUsingAnchor = (\n  urlOrBlob: string | Blob,\n  fileName?: string,\n) => {\n  const url = blobToUrl(urlOrBlob);\n\n  const a = document.createElement('a');\n  a.href = url;\n\n  a.download = fileName ?? 'file';\n\n  a.target = '_blank';\n\n  document.body.append(a);\n\n  a.click();\n\n  a.remove();\n};\n","/**\n * Extracts an RGB value from any valid CSS color.\n *\n * Not recommended for frequent use because it triggers a reflow.\n */\nexport const getComputedColor = (color?: string): string | null => {\n  if (!color) return null;\n\n  const d = document.createElement('div');\n  d.style.color = color;\n  document.body.append(d);\n  const rgbcolor = globalThis.getComputedStyle(d).color;\n  const match =\n    /rgba?\\((\\d+)\\s*,\\s*(\\d+)\\s*,\\s*(\\d+)\\s*(,\\s*\\d+[.d+]*)*\\)/g.exec(rgbcolor);\n\n  d.remove();\n\n  if (!match) return null;\n\n  return `${match[1]}, ${match[2]}, ${match[3]}`;\n};\n","/**\n * Calculates the inner height of an HTML element, accounting for padding.\n */\nexport function getElementInnerHeight(element: HTMLElement) {\n  const { clientHeight } = element;\n  const { paddingTop, paddingBottom } = getComputedStyle(element);\n  return (\n    clientHeight -\n    Number.parseFloat(paddingTop) -\n    Number.parseFloat(paddingBottom)\n  );\n}\n","/**\n * Calculates the inner width of an HTML element, accounting for padding.\n */\nexport function getElementInnerWidth(el: HTMLElement) {\n  const { clientWidth } = el;\n  const { paddingLeft, paddingRight } = getComputedStyle(el);\n  return (\n    clientWidth -\n    Number.parseFloat(paddingLeft) -\n    Number.parseFloat(paddingRight)\n  );\n}\n","/**\n * Scrolls the page vertically to the viewport section containing the target element.\n *\n * @example\n * ```ts\n * globalScrollIntoViewForY(document.getElementById('footer')!);\n * ```\n */\nexport const globalScrollIntoViewForY = (node: HTMLElement) => {\n  const scrollContainer = document.body;\n  const pageHeight = window.innerHeight;\n  const nodeBounding = node.getBoundingClientRect();\n  const scrollPagesCount = scrollContainer.scrollHeight / pageHeight;\n\n  const scrollPageNumber = Math.min(\n    Math.max(nodeBounding.top / pageHeight, 1),\n    scrollPagesCount,\n  );\n\n  window.scroll({\n    top: scrollPageNumber * pageHeight,\n    behavior: 'smooth',\n  });\n};\n","/**\n * Checks whether the user prefers a dark color scheme.\n *\n * @example\n * ```ts\n * const prefersDark = isPrefersDarkTheme();\n * ```\n */\nexport const isPrefersDarkTheme = () =>\n  !!globalThis.matchMedia?.('(prefers-color-scheme: dark)')?.matches;\n","/**\n * Checks whether the user prefers a light color scheme.\n *\n * @example\n * ```ts\n * const prefersLight = isPrefersLightTheme();\n * ```\n */\nexport const isPrefersLightTheme = () =>\n  !!globalThis.matchMedia?.('(prefers-color-scheme: light)')?.matches;\n","/**\n * Prevents the default browser action and stops event propagation.\n *\n * @example\n * ```ts\n * button.addEventListener('click', (event) => skipEvent(event));\n * ```\n */\nexport const skipEvent = (e: Event) => {\n  e.preventDefault();\n  e.stopPropagation();\n\n  return false;\n};\n","/**\n * Executes a function within a view transition if supported by the browser.\n *\n * @param {VoidFunction} fn - The function to be executed.\n * @returns {ViewTransition} - The result of the executed function.\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/startViewTransition | MDN: Document.startViewTransition}\n */\nexport const startViewTransitionSafety = (\n  fn: VoidFunction,\n  params?: { disabled?: boolean },\n) => {\n  if (\n    typeof document !== 'undefined' &&\n    document.startViewTransition &&\n    !params?.disabled\n  ) {\n    return document.startViewTransition(fn);\n  }\n  fn();\n};\n","/**\n * Surrounds string in an anchor tag\n */\nexport function wrapTextToTagLink(link: string) {\n  const descr = String(link).replace(/^(https?:\\/{0,2})?(w{3}\\.)?/, 'www.');\n  if (!/^https?:\\/{2}/.test(link)) link = `http://${link}`;\n  return `<a href=${link} target=\"_blank\">${descr}</a>`;\n}\n"],"mappings":"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"}

package/html.d.ts

@@ -1,29 +1,31 @@
-import { Config } from 'dompurify';
 import { Maybe } from 'yummies/types';
+import { Config } from 'dompurify';
 
 /**
- * ---header-docs-section---
- * # yummies/html
- *
- * ## Description
- *
- * DOM-centric utilities: sanitizing HTML with **DOMPurify**, computed style probes, downloads via
- * temporary anchors, and small string helpers for safe markup. Prefer these over `innerHTML` with
- * raw user input; keep CSP and server-side validation as the real security boundary.
- *
- * ## Usage
+ * Calculates the scrollbar width.
+ */
+declare const calcScrollbarWidth: (elementToAppend?: HTMLElement) => number;
+
+/**
+ * Checks whether the element is nested inside the provided parent element.
  *
+ * @example
  * ```ts
- * import { getComputedColor } from "yummies/html";
+ * checkElementHasParent(childElement, modalElement);
  * ```
  */
+declare const checkElementHasParent: (element: HTMLElement | null, parent: Maybe<HTMLElement>) => boolean;
 
 /**
- * Extracts an RGB value from any valid CSS color.
+ * Collects the cumulative `offsetTop` value through the element parent chain.
  *
- * Not recommended for frequent use because it triggers a reflow.
+ * @example
+ * ```ts
+ * const offsetTop = collectOffsetTop(document.getElementById('section'));
+ * ```
  */
-declare const getComputedColor: (color?: string) => string | null;
+declare const collectOffsetTop: (element: HTMLElement | null) => number;
+
 /**
  * Triggers a file download by creating and clicking a temporary anchor element.
  *
@@ -33,55 +35,88 @@ declare const getComputedColor: (color?: string) => string | null;
  * ```
  */
 declare const downloadUsingAnchor: (urlOrBlob: string | Blob, fileName?: string) => void;
+
 /**
- * Surrounds string in an anchor tag
+ * Extracts an RGB value from any valid CSS color.
+ *
+ * Not recommended for frequent use because it triggers a reflow.
  */
-declare function wrapTextToTagLink(link: string): string;
+declare const getComputedColor: (color?: string) => string | null;
+
 /**
- * Collects the cumulative `offsetTop` value through the element parent chain.
+ * Calculates the inner height of an HTML element, accounting for padding.
+ */
+declare function getElementInnerHeight(element: HTMLElement): number;
+
+/**
+ * Calculates the inner width of an HTML element, accounting for padding.
+ */
+declare function getElementInnerWidth(el: HTMLElement): number;
+
+/**
+ * Scrolls the page vertically to the viewport section containing the target element.
  *
  * @example
  * ```ts
- * const offsetTop = collectOffsetTop(document.getElementById('section'));
+ * globalScrollIntoViewForY(document.getElementById('footer')!);
  * ```
  */
-declare const collectOffsetTop: (element: HTMLElement | null) => number;
+declare const globalScrollIntoViewForY: (node: HTMLElement) => void;
+
 /**
- * Prevents the default browser action and stops event propagation.
+ * Checks whether the user prefers a dark color scheme.
  *
  * @example
  * ```ts
- * button.addEventListener('click', (event) => skipEvent(event));
+ * const prefersDark = isPrefersDarkTheme();
  * ```
  */
-declare const skipEvent: (e: Event) => boolean;
+declare const isPrefersDarkTheme: () => boolean;
+
 /**
- * Scrolls the page vertically to the viewport section containing the target element.
+ * Checks whether the user prefers a light color scheme.
  *
  * @example
  * ```ts
- * globalScrollIntoViewForY(document.getElementById('footer')!);
+ * const prefersLight = isPrefersLightTheme();
  * ```
  */
-declare const globalScrollIntoViewForY: (node: HTMLElement) => void;
+declare const isPrefersLightTheme: () => boolean;
+
+/**
+ * @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: (html: Maybe<string>, config?: Config) => string;
+declare const sanitizeHtml: SanitizeHtmlFn;
+
 /**
- * Checks whether the element is nested inside the provided parent element.
+ * Prevents the default browser action and stops event propagation.
  *
  * @example
  * ```ts
- * checkElementHasParent(childElement, modalElement);
+ * button.addEventListener('click', (event) => skipEvent(event));
  * ```
  */
-declare const checkElementHasParent: (element: HTMLElement | null, parent: Maybe<HTMLElement>) => boolean;
+declare const skipEvent: (e: Event) => boolean;
+
 /**
  * Executes a function within a view transition if supported by the browser.
  *
@@ -93,35 +128,10 @@ declare const checkElementHasParent: (element: HTMLElement | null, parent: Maybe
 declare const startViewTransitionSafety: (fn: VoidFunction, params?: {
     disabled?: boolean;
 }) => ViewTransition | undefined;
+
 /**
- * Calculates the scrollbar width.
- */
-declare const calcScrollbarWidth: (elementToAppend?: HTMLElement) => number;
-/**
- * Calculates the inner height of an HTML element, accounting for padding.
- */
-declare function getElementInnerHeight(element: HTMLElement): number;
-/**
- * Calculates the inner width of an HTML element, accounting for padding.
- */
-declare function getElementInnerWidth(el: HTMLElement): number;
-/**
- * Checks whether the user prefers a dark color scheme.
- *
- * @example
- * ```ts
- * const prefersDark = isPrefersDarkTheme();
- * ```
- */
-declare const isPrefersDarkTheme: () => boolean;
-/**
- * Checks whether the user prefers a light color scheme.
- *
- * @example
- * ```ts
- * const prefersLight = isPrefersLightTheme();
- * ```
+ * Surrounds string in an anchor tag
  */
-declare const isPrefersLightTheme: () => boolean;
+declare function wrapTextToTagLink(link: string): string;
 
 export { calcScrollbarWidth, checkElementHasParent, collectOffsetTop, downloadUsingAnchor, getComputedColor, getElementInnerHeight, getElementInnerWidth, globalScrollIntoViewForY, isPrefersDarkTheme, isPrefersLightTheme, sanitizeHtml, skipEvent, startViewTransitionSafety, wrapTextToTagLink };