yummies 7.10.0 → 7.12.0

package/format.js

@@ -1,87 +1,123 @@
+import { n as __exportAll } from "./chunk-YKewjYmz.js";
 import { parser } from "yummies/parser";
 import { typeGuard } from "yummies/type-guard";
-const NO_VALUE = "–";
-const HYPHEN = "-";
-const INFINITY = "∞";
-const number = (rawValue, userSettings) => {
-  const settings = {
-    ...number.defaultSettings,
-    ...userSettings
-  };
-  const digits = settings.digits ?? 0;
-  const cutZeros = settings?.cutZeros ?? false;
-  const delimiter = settings.delimiter ?? " ";
-  const postfix = settings.postfix ?? "";
-  const emptyText = settings.emptyText ?? NO_VALUE;
-  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;
-  let value;
-  if (typeGuard.isString(rawValue)) {
-    value = parser.number(value, { fallback: void 0 });
-  } else {
-    value = rawValue;
-  }
-  if (typeGuard.isNumber(value)) {
-    let raw = `${value}`;
-    if (digits !== false) {
-      if (settings.cropDigitsOnly) {
-        const [integerPart2, decimalPart2] = `${raw}`.split(".");
-        const leftPart = integerPart2;
-        const rightPart = (decimalPart2 || "").slice(0, digits).padEnd(digits, "0");
-        if (rightPart) {
-          raw = `${leftPart}.${rightPart}`;
-        } else {
-          raw = leftPart;
-        }
-      } else {
-        raw = value.toFixed(digits);
-      }
-    }
-    if (cutZeros) {
-      raw = `${+raw}`;
-    }
-    const [integerPart, decimalPart] = raw.split(".", 2);
-    let formattedIntegerPart = integerPart;
-    let formattedDecimalPart = "";
-    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {
-      formattedDecimalPart = `.${decimalPart}`;
-    }
-    const rgx = /(\d+)(\d{3})/;
-    while (rgx.test(formattedIntegerPart) && delimiter) {
-      formattedIntegerPart = formattedIntegerPart.replace(
-        rgx,
-        `$1${delimiter}$2`
-      );
-    }
-    return formattedIntegerPart + formattedDecimalPart + postfix;
-  }
-  return emptyText;
+//#region src/format/number.ts
+/**
+* Formats a numeric value with thousands separators, fractional digit control
+* and optional postfix text.
+*
+* Invalid, empty or unsupported values fall back to `emptyText`.
+*
+* @param rawValue Number or numeric string to format.
+* @param userSettings Formatting overrides merged with `number.defaultSettings`.
+* @returns Formatted number string or fallback text.
+*
+* @example
+* ```ts
+* number(12000); // '12 000'
+* ```
+*
+* @example
+* ```ts
+* number(12.5, { digits: 1, postfix: '%' }); // '12.5%'
+* ```
+*/
+var number = (rawValue, userSettings) => {
+	const settings = {
+		...number.defaultSettings,
+		...userSettings
+	};
+	const digits = settings.digits ?? 0;
+	const cutZeros = settings?.cutZeros ?? false;
+	const delimiter = settings.delimiter ?? " ";
+	const postfix = settings.postfix ?? "";
+	const emptyText = settings.emptyText ?? "–";
+	const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;
+	let value;
+	if (typeGuard.isString(rawValue)) value = parser.number(value, { fallback: void 0 });
+	else value = rawValue;
+	if (typeGuard.isNumber(value)) {
+		let raw = `${value}`;
+		if (digits !== false) if (settings.cropDigitsOnly) {
+			const [integerPart, decimalPart] = `${raw}`.split(".");
+			const leftPart = integerPart;
+			const rightPart = (decimalPart || "").slice(0, digits).padEnd(digits, "0");
+			if (rightPart) raw = `${leftPart}.${rightPart}`;
+			else raw = leftPart;
+		} else raw = value.toFixed(digits);
+		if (cutZeros) raw = `${+raw}`;
+		const [integerPart, decimalPart] = raw.split(".", 2);
+		let formattedIntegerPart = integerPart;
+		let formattedDecimalPart = "";
+		if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) formattedDecimalPart = `.${decimalPart}`;
+		const rgx = /(\d+)(\d{3})/;
+		while (rgx.test(formattedIntegerPart) && delimiter) formattedIntegerPart = formattedIntegerPart.replace(rgx, `$1${delimiter}$2`);
+		return formattedIntegerPart + formattedDecimalPart + postfix;
+	}
+	return emptyText;
 };
 number.defaultSettings = {};
-const percent = (value, settings) => {
-  const numericValue = parser.number(value, {
-    ...settings,
-    digits: settings?.digits ?? 2,
-    fallback: Number.NaN
-  });
-  if (typeGuard.isNumber(numericValue)) {
-    const divider = settings?.divider ?? ".";
-    const formattedPercent = divider === "." ? numericValue : `${numericValue}`.replace(".", divider);
-    return `${formattedPercent}${settings?.delimiter ?? ""}${settings?.symbol ?? "%"}`;
-  } else {
-    return settings?.emptyText ?? NO_VALUE;
-  }
+//#endregion
+//#region src/format/percent.ts
+/**
+* Formats a value as a percent string with configurable decimal precision,
+* decimal divider and suffix symbol.
+*
+* @param value Number or numeric string to format.
+* @param settings Parser and formatting options.
+* @returns Formatted percent string or fallback text for invalid values.
+*
+* @example
+* ```ts
+* percent(12.345); // '12.35%'
+* ```
+*
+* @example
+* ```ts
+* percent(12.345, { divider: ',', symbol: ' pct' }); // '12,35 pct'
+* ```
+*/
+var percent = (value, settings) => {
+	const numericValue = parser.number(value, {
+		...settings,
+		digits: settings?.digits ?? 2,
+		fallback: NaN
+	});
+	if (typeGuard.isNumber(numericValue)) {
+		const divider = settings?.divider ?? ".";
+		return `${divider === "." ? numericValue : `${numericValue}`.replace(".", divider)}${settings?.delimiter ?? ""}${settings?.symbol ?? "%"}`;
+	} else return settings?.emptyText ?? "–";
 };
-const skipSpaces = (value) => value.replaceAll(/\s/g, "");
-const _exports = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  HYPHEN,
-  INFINITY,
-  NO_VALUE,
-  number,
-  percent,
-  skipSpaces
-}, Symbol.toStringTag, { value: "Module" }));
-export {
-  _exports as format
-};
-//# sourceMappingURL=format.js.map
+//#endregion
+//#region src/format/skip-spaces.ts
+/**
+* Removes all whitespace characters from a string.
+*
+* @param value Source string.
+* @returns String without spaces, tabs and line breaks.
+*
+* @example
+* ```ts
+* skipSpaces('1 000 000'); // '1000000'
+* ```
+*
+* @example
+* ```ts
+* skipSpaces('a\tb\nc'); // 'abc'
+* ```
+*/
+var skipSpaces = (value) => value.replaceAll(/\s/g, "");
+//#endregion
+//#region src/format/_exports.ts
+var _exports_exports = /* @__PURE__ */ __exportAll({
+	HYPHEN: () => "-",
+	INFINITY: () => "∞",
+	NO_VALUE: () => "–",
+	number: () => number,
+	percent: () => percent,
+	skipSpaces: () => skipSpaces
+});
+//#endregion
+export { _exports_exports as format };
+
+//# sourceMappingURL=format.js.map

package/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sources":["../src/format/constants.ts","../src/format/number.ts","../src/format/percent.ts","../src/format/skip-spaces.ts"],"sourcesContent":["export const NO_VALUE = '–'; // en-dash\n\nexport const HYPHEN = '-';\n\nexport const INFINITY = '∞';\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\nimport { NO_VALUE } from './constants.js';\n\nexport interface NumberFormatSettings {\n  delimiter?: string;\n  /**\n   * digitsOnlyForFloat - Show digits after decimal point only if they are not zeros after converting to number.\n   * Example: \"0.00\" -> \"0\", \"0.10\" -> \"0.1\", but \"0.003\" -> \"0.003\"\n   *\n   * @default true\n   */\n  digitsOnlyForFloat?: boolean;\n  /**\n   * Text which will be returned if the value is undefined, null, NaN, Infinity or empty string.\n   * Example: \"–\" will be returned if the value is undefined and emptyText is \"–\".\n   */\n  emptyText?: string;\n  /**\n   * Text to append to the end of the formatted number.\n   * Example: if value is 1000 and postfix is \"₽\", result will be \"1 000₽\".\n   */\n  postfix?: string;\n  /**\n   * Fixed number of digits after the decimal point (number.toFixed() method)\n   * If set to false, the truncation is ignored!\n   */\n  digits?: number | false;\n  /**\n   * Remove trailing zeros from the end of the number\n   * Example: 0.010000000000000000000000000000000000000000000 -> 0.01\n   */\n  cutZeros?: boolean;\n  cropDigitsOnly?: boolean;\n}\n\nexport const number = (\n  rawValue: Maybe<string | number>,\n  userSettings?: Maybe<NumberFormatSettings>,\n): string => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const digits = settings.digits ?? 0;\n  const cutZeros = settings?.cutZeros ?? false;\n  const delimiter = settings.delimiter ?? ' ';\n  const postfix = settings.postfix ?? '';\n  const emptyText = settings.emptyText ?? NO_VALUE;\n  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;\n\n  let value: Maybe<number>;\n\n  if (typeGuard.isString(rawValue)) {\n    value = parser.number(value, { fallback: undefined });\n  } else {\n    value = rawValue;\n  }\n\n  if (typeGuard.isNumber(value)) {\n    let raw: string = `${value}`;\n\n    if (digits !== false) {\n      if (settings.cropDigitsOnly) {\n        const [integerPart, decimalPart] = `${raw}`.split('.');\n        const leftPart = integerPart;\n        const rightPart = (decimalPart || '')\n          .slice(0, digits)\n          .padEnd(digits, '0');\n\n        if (rightPart) {\n          raw = `${leftPart}.${rightPart}`;\n        } else {\n          raw = leftPart;\n        }\n      } else {\n        raw = value.toFixed(digits);\n      }\n    }\n\n    if (cutZeros) {\n      raw = `${+raw}`;\n    }\n\n    const [integerPart, decimalPart] = raw.split('.', 2);\n\n    let formattedIntegerPart = integerPart;\n    let formattedDecimalPart = '';\n\n    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {\n      formattedDecimalPart = `.${decimalPart}`;\n    }\n\n    const rgx = /(\\d+)(\\d{3})/;\n\n    while (rgx.test(formattedIntegerPart) && delimiter) {\n      formattedIntegerPart = formattedIntegerPart.replace(\n        rgx,\n        `$1${delimiter}$2`,\n      );\n    }\n\n    return formattedIntegerPart + formattedDecimalPart + postfix;\n  }\n\n  return emptyText;\n};\n\nnumber.defaultSettings = {} as NumberFormatSettings;\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nimport { NO_VALUE } from './constants.js';\n\nexport interface PercentFormatSettings\n  extends Omit<parser.NumberParserSettings, 'fallback'> {\n  divider?: string;\n  delimiter?: string;\n  symbol?: string;\n  emptyText?: string;\n}\n\n/**\n * 100 -> 100%\n * 99.123214412 -> 99.12%\n * 99.123214412 -> 99,12%\n */\nexport const percent = (\n  value: Maybe<number | string>,\n  settings?: PercentFormatSettings,\n) => {\n  const numericValue = parser.number(value, {\n    ...settings,\n    digits: settings?.digits ?? 2,\n    fallback: Number.NaN,\n  });\n\n  if (typeGuard.isNumber(numericValue)) {\n    const divider = settings?.divider ?? '.';\n\n    const formattedPercent =\n      divider === '.' ? numericValue : `${numericValue}`.replace('.', divider);\n\n    return `${formattedPercent}${settings?.delimiter ?? ''}${settings?.symbol ?? '%'}`;\n  } else {\n    return settings?.emptyText ?? NO_VALUE;\n  }\n};\n","/**\n * Removes all spaces in string\n */\nexport const skipSpaces = (value: string) => value.replaceAll(/\\s/g, '');\n"],"names":["integerPart","decimalPart"],"mappings":";;AAAO,MAAM,WAAW;AAEjB,MAAM,SAAS;AAEf,MAAM,WAAW;ACiCjB,MAAM,SAAS,CACpB,UACA,iBACW;AACX,QAAM,WAAW;AAAA,IACf,GAAG,OAAO;AAAA,IACV,GAAG;AAAA,EAAA;AAGL,QAAM,SAAS,SAAS,UAAU;AAClC,QAAM,WAAW,UAAU,YAAY;AACvC,QAAM,YAAY,SAAS,aAAa;AACxC,QAAM,UAAU,SAAS,WAAW;AACpC,QAAM,YAAY,SAAS,aAAa;AACxC,QAAM,qBAAqB,SAAS,sBAAsB;AAE1D,MAAI;AAEJ,MAAI,UAAU,SAAS,QAAQ,GAAG;AAChC,YAAQ,OAAO,OAAO,OAAO,EAAE,UAAU,QAAW;AAAA,EACtD,OAAO;AACL,YAAQ;AAAA,EACV;AAEA,MAAI,UAAU,SAAS,KAAK,GAAG;AAC7B,QAAI,MAAc,GAAG,KAAK;AAE1B,QAAI,WAAW,OAAO;AACpB,UAAI,SAAS,gBAAgB;AAC3B,cAAM,CAACA,cAAaC,YAAW,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG;AACrD,cAAM,WAAWD;AACjB,cAAM,aAAaC,gBAAe,IAC/B,MAAM,GAAG,MAAM,EACf,OAAO,QAAQ,GAAG;AAErB,YAAI,WAAW;AACb,gBAAM,GAAG,QAAQ,IAAI,SAAS;AAAA,QAChC,OAAO;AACL,gBAAM;AAAA,QACR;AAAA,MACF,OAAO;AACL,cAAM,MAAM,QAAQ,MAAM;AAAA,MAC5B;AAAA,IACF;AAEA,QAAI,UAAU;AACZ,YAAM,GAAG,CAAC,GAAG;AAAA,IACf;AAEA,UAAM,CAAC,aAAa,WAAW,IAAI,IAAI,MAAM,KAAK,CAAC;AAEnD,QAAI,uBAAuB;AAC3B,QAAI,uBAAuB;AAE3B,QAAI,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,KAAK,WAAW,IAAI;AACrE,6BAAuB,IAAI,WAAW;AAAA,IACxC;AAEA,UAAM,MAAM;AAEZ,WAAO,IAAI,KAAK,oBAAoB,KAAK,WAAW;AAClD,6BAAuB,qBAAqB;AAAA,QAC1C;AAAA,QACA,KAAK,SAAS;AAAA,MAAA;AAAA,IAElB;AAEA,WAAO,uBAAuB,uBAAuB;AAAA,EACvD;AAEA,SAAO;AACT;AAEA,OAAO,kBAAkB,CAAA;AC3FlB,MAAM,UAAU,CACrB,OACA,aACG;AACH,QAAM,eAAe,OAAO,OAAO,OAAO;AAAA,IACxC,GAAG;AAAA,IACH,QAAQ,UAAU,UAAU;AAAA,IAC5B,UAAU,OAAO;AAAA,EAAA,CAClB;AAED,MAAI,UAAU,SAAS,YAAY,GAAG;AACpC,UAAM,UAAU,UAAU,WAAW;AAErC,UAAM,mBACJ,YAAY,MAAM,eAAe,GAAG,YAAY,GAAG,QAAQ,KAAK,OAAO;AAEzE,WAAO,GAAG,gBAAgB,GAAG,UAAU,aAAa,EAAE,GAAG,UAAU,UAAU,GAAG;AAAA,EAClF,OAAO;AACL,WAAO,UAAU,aAAa;AAAA,EAChC;AACF;ACpCO,MAAM,aAAa,CAAC,UAAkB,MAAM,WAAW,OAAO,EAAE;;;;;;;;;;"}
+{"version":3,"file":"format.js","names":[],"sources":["../src/format/number.ts","../src/format/percent.ts","../src/format/skip-spaces.ts","../src/format/_exports.ts"],"sourcesContent":["import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\nimport { NO_VALUE } from './constants.js';\n\nexport interface NumberFormatSettings {\n  delimiter?: string;\n  /**\n   * digitsOnlyForFloat - Show digits after decimal point only if they are not zeros after converting to number.\n   * Example: \"0.00\" -> \"0\", \"0.10\" -> \"0.1\", but \"0.003\" -> \"0.003\"\n   *\n   * @default true\n   */\n  digitsOnlyForFloat?: boolean;\n  /**\n   * Text which will be returned if the value is undefined, null, NaN, Infinity or empty string.\n   * Example: \"–\" will be returned if the value is undefined and emptyText is \"–\".\n   */\n  emptyText?: string;\n  /**\n   * Text to append to the end of the formatted number.\n   * Example: if value is 1000 and postfix is \"₽\", result will be \"1 000₽\".\n   */\n  postfix?: string;\n  /**\n   * Fixed number of digits after the decimal point (number.toFixed() method)\n   * If set to false, the truncation is ignored!\n   */\n  digits?: number | false;\n  /**\n   * Remove trailing zeros from the end of the number\n   * Example: 0.010000000000000000000000000000000000000000000 -> 0.01\n   */\n  cutZeros?: boolean;\n  cropDigitsOnly?: boolean;\n}\n\n/**\n * Formats a numeric value with thousands separators, fractional digit control\n * and optional postfix text.\n *\n * Invalid, empty or unsupported values fall back to `emptyText`.\n *\n * @param rawValue Number or numeric string to format.\n * @param userSettings Formatting overrides merged with `number.defaultSettings`.\n * @returns Formatted number string or fallback text.\n *\n * @example\n * ```ts\n * number(12000); // '12 000'\n * ```\n *\n * @example\n * ```ts\n * number(12.5, { digits: 1, postfix: '%' }); // '12.5%'\n * ```\n */\nexport const number = (\n  rawValue: Maybe<string | number>,\n  userSettings?: Maybe<NumberFormatSettings>,\n): string => {\n  const settings = {\n    ...number.defaultSettings,\n    ...userSettings,\n  };\n\n  const digits = settings.digits ?? 0;\n  const cutZeros = settings?.cutZeros ?? false;\n  const delimiter = settings.delimiter ?? ' ';\n  const postfix = settings.postfix ?? '';\n  const emptyText = settings.emptyText ?? NO_VALUE;\n  const digitsOnlyForFloat = settings.digitsOnlyForFloat ?? true;\n\n  let value: Maybe<number>;\n\n  if (typeGuard.isString(rawValue)) {\n    value = parser.number(value, { fallback: undefined });\n  } else {\n    value = rawValue;\n  }\n\n  if (typeGuard.isNumber(value)) {\n    let raw: string = `${value}`;\n\n    if (digits !== false) {\n      if (settings.cropDigitsOnly) {\n        const [integerPart, decimalPart] = `${raw}`.split('.');\n        const leftPart = integerPart;\n        const rightPart = (decimalPart || '')\n          .slice(0, digits)\n          .padEnd(digits, '0');\n\n        if (rightPart) {\n          raw = `${leftPart}.${rightPart}`;\n        } else {\n          raw = leftPart;\n        }\n      } else {\n        raw = value.toFixed(digits);\n      }\n    }\n\n    if (cutZeros) {\n      raw = `${+raw}`;\n    }\n\n    const [integerPart, decimalPart] = raw.split('.', 2);\n\n    let formattedIntegerPart = integerPart;\n    let formattedDecimalPart = '';\n\n    if (decimalPart && (!digitsOnlyForFloat || !/^0+$/.test(decimalPart))) {\n      formattedDecimalPart = `.${decimalPart}`;\n    }\n\n    const rgx = /(\\d+)(\\d{3})/;\n\n    while (rgx.test(formattedIntegerPart) && delimiter) {\n      formattedIntegerPart = formattedIntegerPart.replace(\n        rgx,\n        `$1${delimiter}$2`,\n      );\n    }\n\n    return formattedIntegerPart + formattedDecimalPart + postfix;\n  }\n\n  return emptyText;\n};\n\nnumber.defaultSettings = {} as NumberFormatSettings;\n","import { parser } from 'yummies/parser';\nimport { typeGuard } from 'yummies/type-guard';\nimport type { Maybe } from 'yummies/types';\n\nimport { NO_VALUE } from './constants.js';\n\nexport interface PercentFormatSettings\n  extends Omit<parser.NumberParserSettings, 'fallback'> {\n  divider?: string;\n  delimiter?: string;\n  symbol?: string;\n  emptyText?: string;\n}\n\n/**\n * Formats a value as a percent string with configurable decimal precision,\n * decimal divider and suffix symbol.\n *\n * @param value Number or numeric string to format.\n * @param settings Parser and formatting options.\n * @returns Formatted percent string or fallback text for invalid values.\n *\n * @example\n * ```ts\n * percent(12.345); // '12.35%'\n * ```\n *\n * @example\n * ```ts\n * percent(12.345, { divider: ',', symbol: ' pct' }); // '12,35 pct'\n * ```\n */\nexport const percent = (\n  value: Maybe<number | string>,\n  settings?: PercentFormatSettings,\n) => {\n  const numericValue = parser.number(value, {\n    ...settings,\n    digits: settings?.digits ?? 2,\n    fallback: Number.NaN,\n  });\n\n  if (typeGuard.isNumber(numericValue)) {\n    const divider = settings?.divider ?? '.';\n\n    const formattedPercent =\n      divider === '.' ? numericValue : `${numericValue}`.replace('.', divider);\n\n    return `${formattedPercent}${settings?.delimiter ?? ''}${settings?.symbol ?? '%'}`;\n  } else {\n    return settings?.emptyText ?? NO_VALUE;\n  }\n};\n","/**\n * Removes all whitespace characters from a string.\n *\n * @param value Source string.\n * @returns String without spaces, tabs and line breaks.\n *\n * @example\n * ```ts\n * skipSpaces('1 000 000'); // '1000000'\n * ```\n *\n * @example\n * ```ts\n * skipSpaces('a\\tb\\nc'); // 'abc'\n * ```\n */\nexport const skipSpaces = (value: string) => value.replaceAll(/\\s/g, '');\n","export * from './constants.js';\nexport * from './number.js';\nexport * from './percent.js';\nexport * from './skip-spaces.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyDA,IAAa,UACX,UACA,iBACW;CACX,MAAM,WAAW;EACf,GAAG,OAAO;EACV,GAAG;EACJ;CAED,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,WAAW,UAAU,YAAY;CACvC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,UAAU,SAAS,WAAW;CACpC,MAAM,YAAY,SAAS,aAAA;CAC3B,MAAM,qBAAqB,SAAS,sBAAsB;CAE1D,IAAI;AAEJ,KAAI,UAAU,SAAS,SAAS,CAC9B,SAAQ,OAAO,OAAO,OAAO,EAAE,UAAU,KAAA,GAAW,CAAC;KAErD,SAAQ;AAGV,KAAI,UAAU,SAAS,MAAM,EAAE;EAC7B,IAAI,MAAc,GAAG;AAErB,MAAI,WAAW,MACb,KAAI,SAAS,gBAAgB;GAC3B,MAAM,CAAC,aAAa,eAAe,GAAG,MAAM,MAAM,IAAI;GACtD,MAAM,WAAW;GACjB,MAAM,aAAa,eAAe,IAC/B,MAAM,GAAG,OAAO,CAChB,OAAO,QAAQ,IAAI;AAEtB,OAAI,UACF,OAAM,GAAG,SAAS,GAAG;OAErB,OAAM;QAGR,OAAM,MAAM,QAAQ,OAAO;AAI/B,MAAI,SACF,OAAM,GAAG,CAAC;EAGZ,MAAM,CAAC,aAAa,eAAe,IAAI,MAAM,KAAK,EAAE;EAEpD,IAAI,uBAAuB;EAC3B,IAAI,uBAAuB;AAE3B,MAAI,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,KAAK,YAAY,EAClE,wBAAuB,IAAI;EAG7B,MAAM,MAAM;AAEZ,SAAO,IAAI,KAAK,qBAAqB,IAAI,UACvC,wBAAuB,qBAAqB,QAC1C,KACA,KAAK,UAAU,IAChB;AAGH,SAAO,uBAAuB,uBAAuB;;AAGvD,QAAO;;AAGT,OAAO,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;AClG3B,IAAa,WACX,OACA,aACG;CACH,MAAM,eAAe,OAAO,OAAO,OAAO;EACxC,GAAG;EACH,QAAQ,UAAU,UAAU;EAC5B,UAAU;EACX,CAAC;AAEF,KAAI,UAAU,SAAS,aAAa,EAAE;EACpC,MAAM,UAAU,UAAU,WAAW;AAKrC,SAAO,GAFL,YAAY,MAAM,eAAe,GAAG,eAAe,QAAQ,KAAK,QAAQ,GAE7C,UAAU,aAAa,KAAK,UAAU,UAAU;OAE7E,QAAO,UAAU,aAAA;;;;;;;;;;;;;;;;;;;;AClCrB,IAAa,cAAc,UAAkB,MAAM,WAAW,OAAO,GAAG"}

package/html.cjs

@@ -1,156 +1,244 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const DOMPurify = require("dompurify");
-const media = require("yummies/media");
-const 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]}`;
+const require_chunk = require("./chunk-CVq3Gv4J.cjs");
+let dompurify = require("dompurify");
+dompurify = require_chunk.__toESM(dompurify);
+let yummies_media = require("yummies/media");
+//#region src/html.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]}`;
 };
-const downloadUsingAnchor = (urlOrBlob, fileName) => {
-  const url = 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();
+/**
+* Triggers a file download by creating and clicking a temporary anchor element.
+*
+* @example
+* ```ts
+* downloadUsingAnchor('/report.pdf', 'report.pdf');
+* ```
+*/
+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();
 };
+/**
+* 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>`;
+	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>`;
 }
-const collectOffsetTop = (element) => {
-  let offsetTop = 0;
-  let node = element;
-  while (node != null) {
-    offsetTop += node.offsetTop;
-    node = node.parentElement;
-  }
-  return offsetTop;
+/**
+* Collects the cumulative `offsetTop` value through the element parent chain.
+*
+* @example
+* ```ts
+* const offsetTop = collectOffsetTop(document.getElementById('section'));
+* ```
+*/
+var collectOffsetTop = (element) => {
+	let offsetTop = 0;
+	let node = element;
+	while (node != null) {
+		offsetTop += node.offsetTop;
+		node = node.parentElement;
+	}
+	return offsetTop;
 };
-const skipEvent = (e) => {
-  e.preventDefault();
-  e.stopPropagation();
-  return false;
+/**
+* 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;
 };
-const globalScrollIntoViewForY = (node) => {
-  const scrollContainer = document.body;
-  const pageHeight = window.innerHeight;
-  const nodeBounding = node.getBoundingClientRect();
-  const scrollPagesCount = scrollContainer.scrollHeight / pageHeight;
-  const scrollPageNumber = Math.min(
-    Math.max(nodeBounding.top / pageHeight, 1),
-    scrollPagesCount
-  );
-  window.scroll({
-    top: scrollPageNumber * pageHeight,
-    behavior: "smooth"
-  });
+/**
+* Scrolls the page vertically to the viewport section containing the target element.
+*
+* @example
+* ```ts
+* globalScrollIntoViewForY(document.getElementById('footer')!);
+* ```
+*/
+var globalScrollIntoViewForY = (node) => {
+	const scrollContainer = document.body;
+	const pageHeight = window.innerHeight;
+	const nodeBounding = node.getBoundingClientRect();
+	const scrollPagesCount = scrollContainer.scrollHeight / pageHeight;
+	const scrollPageNumber = Math.min(Math.max(nodeBounding.top / pageHeight, 1), scrollPagesCount);
+	window.scroll({
+		top: scrollPageNumber * pageHeight,
+		behavior: "smooth"
+	});
 };
-const 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"]
+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"
+	]
 };
-const sanitizeHtml = (html, config) => {
-  return DOMPurify.sanitize(html || "", {
-    ...sanitizeDefaults,
-    ...config
-  });
+/**
+* Sanitizes HTML using the default allowlist merged with custom DOMPurify config.
+*
+* @example
+* ```ts
+* sanitizeHtml('<img src=x onerror=alert(1) />');
+* ```
+*/
+var sanitizeHtml = (html, config) => {
+	return dompurify.default.sanitize(html || "", {
+		...sanitizeDefaults,
+		...config
+	});
 };
-const checkElementHasParent = (element, parent) => {
-  let node = element;
-  if (!parent) return false;
-  while (node != null) {
-    if (node === parent) {
-      return true;
-    } else {
-      node = node.parentElement;
-    }
-  }
-  return false;
+/**
+* Checks whether the element is nested inside the provided parent element.
+*
+* @example
+* ```ts
+* checkElementHasParent(childElement, modalElement);
+* ```
+*/
+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;
 };
-const startViewTransitionSafety = (fn, params) => {
-  if (typeof document !== "undefined" && document.startViewTransition && !params?.disabled) {
-    return document.startViewTransition(fn);
-  }
-  fn();
+/**
+* Executes a function within a view transition if supported by the browser.
+*
+* @param {VoidFunction} fn - The function to be executed.
+* @returns {ViewTransition} - The result of the executed function.
+*
+* @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/startViewTransition | MDN: Document.startViewTransition}
+*/
+var startViewTransitionSafety = (fn, params) => {
+	if (typeof document !== "undefined" && document.startViewTransition && !params?.disabled) return document.startViewTransition(fn);
+	fn();
 };
-const 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 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);
+	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.
+*/
 function getElementInnerWidth(el) {
-  const { clientWidth } = el;
-  const { paddingLeft, paddingRight } = getComputedStyle(el);
-  return clientWidth - Number.parseFloat(paddingLeft) - Number.parseFloat(paddingRight);
+	const { clientWidth } = el;
+	const { paddingLeft, paddingRight } = getComputedStyle(el);
+	return clientWidth - Number.parseFloat(paddingLeft) - Number.parseFloat(paddingRight);
 }
-const isPrefersDarkTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: dark)")?.matches;
-const isPrefersLightTheme = () => !!globalThis.matchMedia?.("(prefers-color-scheme: light)")?.matches;
+/**
+* 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;
 exports.collectOffsetTop = collectOffsetTop;
@@ -165,4 +253,5 @@ exports.sanitizeHtml = sanitizeHtml;
 exports.skipEvent = skipEvent;
 exports.startViewTransitionSafety = startViewTransitionSafety;
 exports.wrapTextToTagLink = wrapTextToTagLink;
-//# sourceMappingURL=html.cjs.map
+
+//# sourceMappingURL=html.cjs.map