@lichens-innovation/ts-common 1.17.0 → 1.20.0

package/dist/index.d.cts

@@ -1,4 +1,7 @@
-export { D as Dimensions } from './dimensions.utils-BwIBA5op.cjs';
+export { D as Dimensions, N as NormalizedRgb, R as RgbColor, a as RgbaColor, g as getColorForPercentage, b as getContrastTextColor, c as getLuminance, d as getOpacityHexValue, h as hexToNormalizedRgb, e as hexToRgb, i as isLightColor, r as rgbToHex, f as rgbToString, j as rgbaToHex, k as rgbaToHexWithAlpha, l as rgbaToString } from './dimensions.utils-C7MsHTQd.cjs';
+
+declare const encodeBase64: (text: string) => string;
+declare const decodeBase64: (base64: string) => string;
 
 interface ToleranceArea {
     flow: number;
@@ -46,47 +49,6 @@ declare const roundToNiceNumber: (rawValue: number) => number;
  */
 declare const buildTicksForChart: (max: number, targetTickCount?: number) => number[];
 
-interface RgbColor {
-    r: number;
-    g: number;
-    b: number;
-}
-interface RgbaColor extends RgbColor {
-    a: number;
-}
-declare const rgbToHex: (r: number, g: number, b: number) => string;
-declare const hexToRgb: (hex: string) => RgbColor;
-declare const rgbaToHex: (color: RgbaColor) => string;
-declare const getOpacityHexValue: (opacity: number) => string;
-declare const rgbaToHexWithAlpha: (color: RgbaColor) => string;
-declare const rgbToString: (color: RgbColor) => string;
-declare const rgbaToString: (color: RgbaColor) => string;
-declare const getLuminance: (r: number, g: number, b: number) => number;
-declare const getContrastTextColor: (hexColor: string) => string;
-/**
- * Normalized RGB color with values between 0 and 1.
- * Useful for graphics libraries like Three.js.
- */
-interface NormalizedRgb {
-    r: number;
-    g: number;
-    b: number;
-}
-/**
- * Convert a hex color string to normalized RGB values (0-1 range).
- * @param hex - Hex color string (with or without # prefix)
- * @returns Normalized RGB object with values between 0 and 1
- */
-declare const hexToNormalizedRgb: (hex: string) => NormalizedRgb;
-/**
- * Determine if a color is light or dark based on relative luminance.
- * Useful for choosing contrasting text colors.
- * @param hex - Hex color string
- * @returns True if the color is considered light (luminance > 0.5)
- */
-declare const isLightColor: (hex: string) => boolean;
-declare const getColorForPercentage: (percent: number) => string;
-
 type DateInput = Date | string | number | null;
 declare const dateAs_HHMMSS: (value?: DateInput) => string;
 declare const dateAs_YYYYMMDD: (value?: DateInput) => string;
@@ -133,10 +95,27 @@ declare const toFormString: (n?: number | null) => string;
  */
 declare const toFormStringInteger: (n?: number | null) => string;
 
+declare const escapeHtml: (text: string) => string;
+declare const unescapeHtml: (text: string) => string;
+
 declare const isHttpSuccessStatus: (status?: number | null) => boolean;
 declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
 declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
 
+declare const safeJsonParse: <T>(value: string, fallback?: T) => T | undefined;
+declare const safeJsonStringify: (obj: unknown, space?: number) => string;
+declare const sortObjectKeys: (_key: string, value: unknown) => unknown;
+interface FormatJsonArgs {
+    value?: string;
+    space?: number;
+    sortKeys?: boolean;
+}
+declare const formatJson: ({ value, space, sortKeys }: FormatJsonArgs) => string;
+declare const prettifyJson: (value?: string) => string;
+declare const minifyJson: (value?: string) => string;
+declare const isValidJson: (value: string) => boolean;
+declare const isMinifiedJson: (value: string) => boolean;
+
 /**
  * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).
  */
@@ -159,6 +138,16 @@ declare const isInputValidNegativeInteger: (value: string) => boolean;
 declare const formatIntegerDisplay: (value?: number | null) => string;
 declare const toFixed: (value?: number | null, decimals?: number) => number;
 declare const roundUpToNearest10: (value?: number | null) => number;
+/**
+ * Format a number with K (thousands) or M (millions) suffix.
+ */
+declare const formatCount: (count: number) => string;
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+declare const formatDuration: (ms: number) => string;
+declare const formatWithSpaceSeparator: (val?: number | string | null) => string;
+declare const parseWithSpaceSeparator: (val?: string) => number;
 declare const getOrderOfMagnitudeExponent: (n?: number | null) => number;
 
 declare const REGEX_ALPHANUMERIC: RegExp;
@@ -207,11 +196,32 @@ declare const countWords: (text: string) => number;
  * @returns The truncated string
  */
 declare const truncate: (str: string, maxLength: number, ellipsis?: string) => string;
+/**
+ * Converts a string to a URL-safe slug.
+ * Removes diacritical marks, lowercases, replaces non-alphanumeric characters with hyphens,
+ * and strips leading/trailing hyphens.
+ *
+ * @param value - The input string to slugify
+ * @returns The slugified string
+ *
+ * @example
+ * slugify("Héllo Wörld!") // → "hello-world"
+ * slugify("  My Blog Post  ") // → "my-blog-post"
+ */
+declare const slugify: (value: string) => string;
 /**
  * Parses an optional comma-separated string into a trimmed, non-blank string array.
  */
 declare const parseCommaSeparatedList: (raw?: string | null) => string[];
 
+declare const firstSentence: (s: string) => string;
+interface TitleFromNameArgs {
+    name: string;
+    fallback?: string;
+}
+declare const titleFromName: ({ name, fallback }: TitleFromNameArgs) => string;
+declare const joinOxford: (items: string[]) => string;
+
 declare const sleep: (milliseconds: number) => Promise<void>;
 /**
  * Yields to the main thread so the UI can process events and repaint.
@@ -269,9 +279,17 @@ declare const hasScheme: (uri?: string | null) => boolean;
  * @returns The base64 data without the data URI prefix, or the original string if no comma is found
  */
 declare const extractBase64FromDataUri: (dataUri: string) => string;
+declare const encodeUrl: (value?: string) => string;
+declare const decodeUrl: (value?: string) => string;
+interface FormatDataUriArgs {
+    mimeType: string;
+    base64: string;
+}
+declare const formatDataUri: ({ mimeType, base64 }: FormatDataUriArgs) => string;
+declare const getBase64ApproxSize: (base64: string) => number;
 
 declare const isWsClosable: (ws?: WebSocket | null) => ws is WebSocket;
 declare const isWsOpenOrConnecting: (ws?: WebSocket | null) => ws is WebSocket;
 declare const closeWebSocket: (ws?: WebSocket | null) => void;
 
-export { type ChartPoint, DATA_URI_PATTERN, type DateInput, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, type NormalizedRgb, type NullableChartPoint, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, type RgbColor, type RgbaColor, SCHEME_PREFIXES, type ToleranceArea, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, extractBase64FromDataUri, formatIntegerDisplay, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isLightColor, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, yieldToMainThread };
+export { type ChartPoint, DATA_URI_PATTERN, type DateInput, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, type NullableChartPoint, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, SCHEME_PREFIXES, type ToleranceArea, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, decodeBase64, decodeUrl, encodeBase64, encodeUrl, escapeHtml, extractBase64FromDataUri, firstSentence, formatCount, formatDataUri, formatDuration, formatIntegerDisplay, formatJson, formatUnixTimestamp, formatWithSpaceSeparator, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getBase64ApproxSize, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isMinifiedJson, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isValidJson, isWsClosable, isWsOpenOrConnecting, joinOxford, minifyJson, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, parseWithSpaceSeparator, prettifyJson, removeDiacriticalMarks, roundToNiceNumber, roundUpToNearest10, safeJsonParse, safeJsonStringify, sleep, slugify, sortObjectKeys, tickFormatter, titleFromName, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, unescapeHtml, yieldToMainThread };

package/dist/index.d.ts

@@ -1,4 +1,7 @@
-export { D as Dimensions } from './dimensions.utils-BwIBA5op.js';
+export { D as Dimensions, N as NormalizedRgb, R as RgbColor, a as RgbaColor, g as getColorForPercentage, b as getContrastTextColor, c as getLuminance, d as getOpacityHexValue, h as hexToNormalizedRgb, e as hexToRgb, i as isLightColor, r as rgbToHex, f as rgbToString, j as rgbaToHex, k as rgbaToHexWithAlpha, l as rgbaToString } from './dimensions.utils-C7MsHTQd.js';
+
+declare const encodeBase64: (text: string) => string;
+declare const decodeBase64: (base64: string) => string;
 
 interface ToleranceArea {
     flow: number;
@@ -46,47 +49,6 @@ declare const roundToNiceNumber: (rawValue: number) => number;
  */
 declare const buildTicksForChart: (max: number, targetTickCount?: number) => number[];
 
-interface RgbColor {
-    r: number;
-    g: number;
-    b: number;
-}
-interface RgbaColor extends RgbColor {
-    a: number;
-}
-declare const rgbToHex: (r: number, g: number, b: number) => string;
-declare const hexToRgb: (hex: string) => RgbColor;
-declare const rgbaToHex: (color: RgbaColor) => string;
-declare const getOpacityHexValue: (opacity: number) => string;
-declare const rgbaToHexWithAlpha: (color: RgbaColor) => string;
-declare const rgbToString: (color: RgbColor) => string;
-declare const rgbaToString: (color: RgbaColor) => string;
-declare const getLuminance: (r: number, g: number, b: number) => number;
-declare const getContrastTextColor: (hexColor: string) => string;
-/**
- * Normalized RGB color with values between 0 and 1.
- * Useful for graphics libraries like Three.js.
- */
-interface NormalizedRgb {
-    r: number;
-    g: number;
-    b: number;
-}
-/**
- * Convert a hex color string to normalized RGB values (0-1 range).
- * @param hex - Hex color string (with or without # prefix)
- * @returns Normalized RGB object with values between 0 and 1
- */
-declare const hexToNormalizedRgb: (hex: string) => NormalizedRgb;
-/**
- * Determine if a color is light or dark based on relative luminance.
- * Useful for choosing contrasting text colors.
- * @param hex - Hex color string
- * @returns True if the color is considered light (luminance > 0.5)
- */
-declare const isLightColor: (hex: string) => boolean;
-declare const getColorForPercentage: (percent: number) => string;
-
 type DateInput = Date | string | number | null;
 declare const dateAs_HHMMSS: (value?: DateInput) => string;
 declare const dateAs_YYYYMMDD: (value?: DateInput) => string;
@@ -133,10 +95,27 @@ declare const toFormString: (n?: number | null) => string;
  */
 declare const toFormStringInteger: (n?: number | null) => string;
 
+declare const escapeHtml: (text: string) => string;
+declare const unescapeHtml: (text: string) => string;
+
 declare const isHttpSuccessStatus: (status?: number | null) => boolean;
 declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
 declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
 
+declare const safeJsonParse: <T>(value: string, fallback?: T) => T | undefined;
+declare const safeJsonStringify: (obj: unknown, space?: number) => string;
+declare const sortObjectKeys: (_key: string, value: unknown) => unknown;
+interface FormatJsonArgs {
+    value?: string;
+    space?: number;
+    sortKeys?: boolean;
+}
+declare const formatJson: ({ value, space, sortKeys }: FormatJsonArgs) => string;
+declare const prettifyJson: (value?: string) => string;
+declare const minifyJson: (value?: string) => string;
+declare const isValidJson: (value: string) => boolean;
+declare const isMinifiedJson: (value: string) => boolean;
+
 /**
  * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).
  */
@@ -159,6 +138,16 @@ declare const isInputValidNegativeInteger: (value: string) => boolean;
 declare const formatIntegerDisplay: (value?: number | null) => string;
 declare const toFixed: (value?: number | null, decimals?: number) => number;
 declare const roundUpToNearest10: (value?: number | null) => number;
+/**
+ * Format a number with K (thousands) or M (millions) suffix.
+ */
+declare const formatCount: (count: number) => string;
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+declare const formatDuration: (ms: number) => string;
+declare const formatWithSpaceSeparator: (val?: number | string | null) => string;
+declare const parseWithSpaceSeparator: (val?: string) => number;
 declare const getOrderOfMagnitudeExponent: (n?: number | null) => number;
 
 declare const REGEX_ALPHANUMERIC: RegExp;
@@ -207,11 +196,32 @@ declare const countWords: (text: string) => number;
  * @returns The truncated string
  */
 declare const truncate: (str: string, maxLength: number, ellipsis?: string) => string;
+/**
+ * Converts a string to a URL-safe slug.
+ * Removes diacritical marks, lowercases, replaces non-alphanumeric characters with hyphens,
+ * and strips leading/trailing hyphens.
+ *
+ * @param value - The input string to slugify
+ * @returns The slugified string
+ *
+ * @example
+ * slugify("Héllo Wörld!") // → "hello-world"
+ * slugify("  My Blog Post  ") // → "my-blog-post"
+ */
+declare const slugify: (value: string) => string;
 /**
  * Parses an optional comma-separated string into a trimmed, non-blank string array.
  */
 declare const parseCommaSeparatedList: (raw?: string | null) => string[];
 
+declare const firstSentence: (s: string) => string;
+interface TitleFromNameArgs {
+    name: string;
+    fallback?: string;
+}
+declare const titleFromName: ({ name, fallback }: TitleFromNameArgs) => string;
+declare const joinOxford: (items: string[]) => string;
+
 declare const sleep: (milliseconds: number) => Promise<void>;
 /**
  * Yields to the main thread so the UI can process events and repaint.
@@ -269,9 +279,17 @@ declare const hasScheme: (uri?: string | null) => boolean;
  * @returns The base64 data without the data URI prefix, or the original string if no comma is found
  */
 declare const extractBase64FromDataUri: (dataUri: string) => string;
+declare const encodeUrl: (value?: string) => string;
+declare const decodeUrl: (value?: string) => string;
+interface FormatDataUriArgs {
+    mimeType: string;
+    base64: string;
+}
+declare const formatDataUri: ({ mimeType, base64 }: FormatDataUriArgs) => string;
+declare const getBase64ApproxSize: (base64: string) => number;
 
 declare const isWsClosable: (ws?: WebSocket | null) => ws is WebSocket;
 declare const isWsOpenOrConnecting: (ws?: WebSocket | null) => ws is WebSocket;
 declare const closeWebSocket: (ws?: WebSocket | null) => void;
 
-export { type ChartPoint, DATA_URI_PATTERN, type DateInput, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, type NormalizedRgb, type NullableChartPoint, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, type RgbColor, type RgbaColor, SCHEME_PREFIXES, type ToleranceArea, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, extractBase64FromDataUri, formatIntegerDisplay, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isLightColor, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, yieldToMainThread };
+export { type ChartPoint, DATA_URI_PATTERN, type DateInput, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, type NullableChartPoint, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, SCHEME_PREFIXES, type ToleranceArea, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, decodeBase64, decodeUrl, encodeBase64, encodeUrl, escapeHtml, extractBase64FromDataUri, firstSentence, formatCount, formatDataUri, formatDuration, formatIntegerDisplay, formatJson, formatUnixTimestamp, formatWithSpaceSeparator, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getBase64ApproxSize, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isMinifiedJson, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isValidJson, isWsClosable, isWsOpenOrConnecting, joinOxford, minifyJson, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, parseWithSpaceSeparator, prettifyJson, removeDiacriticalMarks, roundToNiceNumber, roundUpToNearest10, safeJsonParse, safeJsonStringify, sleep, slugify, sortObjectKeys, tickFormatter, titleFromName, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, unescapeHtml, yieldToMainThread };

package/dist/index.js

@@ -1,5 +1,115 @@
 import { format } from 'date-fns';
 
+// src/utils/base64.utils.ts
+var BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var encodeUtf8ToBytes = (text) => {
+  const codePoints = [];
+  for (let i = 0; i < text.length; i++) {
+    const codeUnit = text.charCodeAt(i);
+    if (codeUnit >= 55296 && codeUnit <= 56319 && i + 1 < text.length) {
+      const next = text.charCodeAt(i + 1);
+      if (next >= 56320 && next <= 57343) {
+        codePoints.push(65536 + (codeUnit - 55296 << 10) + (next - 56320));
+        i++;
+        continue;
+      }
+    }
+    codePoints.push(codeUnit);
+  }
+  const bytes = [];
+  for (const codePoint of codePoints) {
+    if (codePoint < 128) {
+      bytes.push(codePoint);
+    } else if (codePoint < 2048) {
+      bytes.push(192 | codePoint >> 6, 128 | codePoint & 63);
+    } else if (codePoint < 65536) {
+      bytes.push(224 | codePoint >> 12, 128 | codePoint >> 6 & 63, 128 | codePoint & 63);
+    } else {
+      bytes.push(
+        240 | codePoint >> 18,
+        128 | codePoint >> 12 & 63,
+        128 | codePoint >> 6 & 63,
+        128 | codePoint & 63
+      );
+    }
+  }
+  return bytes;
+};
+var decodeUtf8FromBytes = (bytes) => {
+  let result = "";
+  let i = 0;
+  while (i < bytes.length) {
+    const b0 = bytes[i];
+    let codePoint;
+    if (b0 < 128) {
+      codePoint = b0;
+      i += 1;
+    } else if ((b0 & 224) === 192) {
+      codePoint = (b0 & 31) << 6 | bytes[i + 1] & 63;
+      i += 2;
+    } else if ((b0 & 240) === 224) {
+      codePoint = (b0 & 15) << 12 | (bytes[i + 1] & 63) << 6 | bytes[i + 2] & 63;
+      i += 3;
+    } else {
+      codePoint = (b0 & 7) << 18 | (bytes[i + 1] & 63) << 12 | (bytes[i + 2] & 63) << 6 | bytes[i + 3] & 63;
+      i += 4;
+    }
+    if (codePoint <= 65535) {
+      result += String.fromCharCode(codePoint);
+    } else {
+      const adjusted = codePoint - 65536;
+      result += String.fromCharCode(55296 + (adjusted >> 10), 56320 + (adjusted & 1023));
+    }
+  }
+  return result;
+};
+var encodeBytesToBase64 = (bytes) => {
+  let output = "";
+  for (let i = 0; i < bytes.length; i += 3) {
+    const b0 = bytes[i];
+    const b1 = i + 1 < bytes.length ? bytes[i + 1] : 0;
+    const b2 = i + 2 < bytes.length ? bytes[i + 2] : 0;
+    const triplet = b0 << 16 | b1 << 8 | b2;
+    output += BASE64_CHARS[triplet >> 18 & 63];
+    output += BASE64_CHARS[triplet >> 12 & 63];
+    output += i + 1 < bytes.length ? BASE64_CHARS[triplet >> 6 & 63] : "=";
+    output += i + 2 < bytes.length ? BASE64_CHARS[triplet & 63] : "=";
+  }
+  return output;
+};
+var decodeBase64ToBytes = (base64) => {
+  const sanitized = base64.replace(/[^A-Za-z0-9+/=]/g, "");
+  const bytes = [];
+  for (let i = 0; i < sanitized.length; i += 4) {
+    const c0 = BASE64_CHARS.indexOf(sanitized[i]);
+    const c1 = BASE64_CHARS.indexOf(sanitized[i + 1]);
+    const c2 = sanitized[i + 2] === "=" ? 0 : BASE64_CHARS.indexOf(sanitized[i + 2]);
+    const c3 = sanitized[i + 3] === "=" ? 0 : BASE64_CHARS.indexOf(sanitized[i + 3]);
+    if (c0 < 0 || c1 < 0 || sanitized[i + 2] !== "=" && c2 < 0 || sanitized[i + 3] !== "=" && c3 < 0) {
+      throw new Error("Invalid base64 character");
+    }
+    const triplet = c0 << 18 | c1 << 12 | c2 << 6 | c3;
+    bytes.push(triplet >> 16 & 255);
+    if (sanitized[i + 2] !== "=") bytes.push(triplet >> 8 & 255);
+    if (sanitized[i + 3] !== "=") bytes.push(triplet & 255);
+  }
+  return bytes;
+};
+var encodeBase64 = (text) => {
+  try {
+    return encodeBytesToBase64(encodeUtf8ToBytes(text));
+  } catch {
+    return "";
+  }
+};
+var decodeBase64 = (base64) => {
+  try {
+    return decodeUtf8FromBytes(decodeBase64ToBytes(base64));
+  } catch {
+    return "";
+  }
+};
+
 // src/utils/types.utils.ts
 var NO_OP = () => {
 };
@@ -247,6 +357,10 @@ var truncate = (str, maxLength, ellipsis = "...") => {
   if (!str || str.length <= maxLength) return str;
   return str.slice(0, maxLength - ellipsis.length) + ellipsis;
 };
+var slugify = (value) => {
+  if (!value) return "";
+  return removeDiacriticalMarks(value).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+};
 var parseCommaSeparatedList = (raw) => {
   if (isBlank(raw)) {
     return [];
@@ -282,6 +396,29 @@ var toFormStringInteger = (n) => {
   return String(Math.round(n));
 };
 
+// src/utils/html.utils.ts
+var HTML_ESCAPE_MAP = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+var HTML_UNESCAPE_MAP = {
+  "&amp;": "&",
+  "&lt;": "<",
+  "&gt;": ">",
+  "&quot;": '"',
+  "&#39;": "'",
+  "&#x27;": "'"
+};
+var escapeHtml = (text) => {
+  return text.replace(/[&<>"']/g, (char) => HTML_ESCAPE_MAP[char] ?? char);
+};
+var unescapeHtml = (text) => {
+  return text.replace(/&(?:amp|lt|gt|quot|#39|#x27);/g, (entity) => HTML_UNESCAPE_MAP[entity] ?? entity);
+};
+
 // src/utils/http.utils.ts
 var isHttpSuccessStatus = (status) => {
   if (isNullish(status)) {
@@ -302,6 +439,56 @@ var isHttpServerErrorStatus = (status) => {
   return status >= 500;
 };
 
+// src/utils/json.utils.ts
+var safeJsonParse = (value, fallback) => {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+};
+var safeJsonStringify = (obj, space = 2) => {
+  if (!obj) return "";
+  try {
+    return JSON.stringify(obj, null, space);
+  } catch {
+    return "";
+  }
+};
+var sortObjectKeys = (_key, value) => value instanceof Object && !(value instanceof Array) ? Object.keys(value).sort().reduce(
+  (sorted, key) => {
+    sorted[key] = value[key];
+    return sorted;
+  },
+  {}
+) : value;
+var formatJson = ({ value, space = 2, sortKeys = false }) => {
+  if (!value) return "";
+  try {
+    const obj = JSON.parse(value);
+    return JSON.stringify(obj, sortKeys ? sortObjectKeys : void 0, space);
+  } catch {
+    return value;
+  }
+};
+var prettifyJson = (value) => {
+  return formatJson({ value, space: 4, sortKeys: true });
+};
+var minifyJson = (value) => {
+  return formatJson({ value, space: 0, sortKeys: true });
+};
+var isValidJson = (value) => {
+  try {
+    JSON.parse(value);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var isMinifiedJson = (value) => {
+  return value === minifyJson(value);
+};
+
 // src/utils/number.utils.ts
 var isInputValidNumber = (value) => {
   if (isBlank(value)) return false;
@@ -335,6 +522,28 @@ var roundUpToNearest10 = (value) => {
   if (isNullish(value)) return 0;
   return Math.ceil(value / 10) * 10;
 };
+var formatCount = (count) => {
+  if (count >= 1e6) {
+    return `${(count / 1e6).toFixed(1)}M`;
+  }
+  if (count >= 1e3) {
+    return `${(count / 1e3).toFixed(1)}K`;
+  }
+  return count.toString();
+};
+var formatDuration = (ms) => {
+  if (ms < 1e3) {
+    return `${ms}ms`;
+  }
+  return `${(ms / 1e3).toFixed(1)}s`;
+};
+var formatWithSpaceSeparator = (val) => {
+  if (isNullish(val)) return "";
+  return String(val).replace(/\B(?=(\d{3})+(?!\d))/g, "\xA0");
+};
+var parseWithSpaceSeparator = (val) => {
+  return Number(val?.replace(/\u00a0/g, ""));
+};
 var getOrderOfMagnitudeExponent = (n) => {
   if (isNullish(n)) return 0;
   if (!isNumber(n)) return 0;
@@ -354,6 +563,20 @@ var isRuntimeEnvNodeJs = () => {
   return true;
 };
 
+// src/utils/text.utils.ts
+var firstSentence = (s) => {
+  const m = s.match(/^[^.!?]+[.!?]/);
+  return m ? m[0].trim() : s.trim();
+};
+var titleFromName = ({ name, fallback = "" }) => {
+  return (name || fallback).split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+};
+var joinOxford = (items) => {
+  if (items.length === 0) return "";
+  if (items.length === 1) return items[0];
+  return items.slice(0, -1).join(", ") + " or " + items.slice(-1)[0];
+};
+
 // src/utils/thread.utils.ts
 var sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
 var yieldToMainThread = () => sleep(0);
@@ -426,6 +649,24 @@ var hasScheme = (uri) => {
 var extractBase64FromDataUri = (dataUri) => {
   return dataUri.split(",")[1] ?? dataUri;
 };
+var encodeUrl = (value) => {
+  if (!value) return "";
+  return encodeURIComponent(value);
+};
+var decodeUrl = (value) => {
+  if (!value) return "";
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+};
+var formatDataUri = ({ mimeType, base64 }) => {
+  return `data:${mimeType};base64,${base64}`;
+};
+var getBase64ApproxSize = (base64) => {
+  return Math.round(base64.length * 3 / 4);
+};
 
 // src/utils/websocket.utils.ts
 var WEBSOCKET_CONNECT_STATES = [WebSocket.CONNECTING, WebSocket.OPEN];
@@ -445,6 +686,6 @@ var closeWebSocket = (ws) => {
   }
 };
 
-export { DATA_URI_PATTERN, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, SCHEME_PREFIXES, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, extractBase64FromDataUri, formatIntegerDisplay, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isLightColor, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, yieldToMainThread };
+export { DATA_URI_PATTERN, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, SCHEME_PREFIXES, W_TO_HP, buildTicksForChart, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, decodeBase64, decodeUrl, encodeBase64, encodeUrl, escapeHtml, extractBase64FromDataUri, firstSentence, formatCount, formatDataUri, formatDuration, formatIntegerDisplay, formatJson, formatUnixTimestamp, formatWithSpaceSeparator, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getBase64ApproxSize, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getFileExtension, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNegativeInteger, isInputValidNumber, isInputValidPositiveInteger, isLightColor, isMinifiedJson, isNotBlank, isNullish, isNumber, isRuntimeEnvNodeJs, isString, isValidDataUri, isValidJson, isWsClosable, isWsOpenOrConnecting, joinOxford, minifyJson, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, parseCommaSeparatedList, parseOptionalFormNumber, parseWithSpaceSeparator, prettifyJson, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, safeJsonParse, safeJsonStringify, sleep, slugify, sortObjectKeys, tickFormatter, titleFromName, toError, toFixed, toFormString, toFormStringInteger, toToleranceLabel, tooltipValueFormatter, truncate, unescapeHtml, yieldToMainThread };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map