@lichens-innovation/ts-common 1.7.0 → 1.8.0

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   dateAs_YYYYMMDD: () => dateAs_YYYYMMDD,
   dateAs_YYYYMMDD_HHMMSS: () => dateAs_YYYYMMDD_HHMMSS,
   extractBase64FromDataUri: () => extractBase64FromDataUri,
+  formatIntegerDisplay: () => formatIntegerDisplay,
   formatUnixTimestamp: () => formatUnixTimestamp,
   fromHzToRpm: () => fromHzToRpm,
   fromM3psToGPM: () => fromM3psToGPM,
@@ -62,6 +63,8 @@ __export(index_exports, {
   isHttpClientErrorStatus: () => isHttpClientErrorStatus,
   isHttpServerErrorStatus: () => isHttpServerErrorStatus,
   isHttpSuccessStatus: () => isHttpSuccessStatus,
+  isInputValidInteger: () => isInputValidInteger,
+  isInputValidNumber: () => isInputValidNumber,
   isLightColor: () => isLightColor,
   isNotBlank: () => isNotBlank,
   isNullish: () => isNullish,
@@ -86,7 +89,8 @@ __export(index_exports, {
   toFixed: () => toFixed,
   toToleranceLabel: () => toToleranceLabel,
   tooltipValueFormatter: () => tooltipValueFormatter,
-  truncate: () => truncate
+  truncate: () => truncate,
+  yieldToMainThread: () => yieldToMainThread
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -322,29 +326,6 @@ var isHttpServerErrorStatus = (status) => {
   return status >= 500;
 };
 
-// src/utils/number.utils.ts
-var toFixed = (value, decimals = 0) => {
-  if (isNullish(value)) return 0;
-  if (decimals < 0) throw new Error("[toFixed] decimals must be >= 0");
-  if (decimals === 0) return Math.round(value);
-  const multiplier = Math.pow(10, decimals);
-  return Math.round(value * multiplier) / multiplier;
-};
-var roundUpToNearest10 = (value) => {
-  if (isNullish(value)) return 0;
-  return Math.ceil(value / 10) * 10;
-};
-var getOrderOfMagnitudeExponent = (n) => {
-  if (isNullish(n)) return 0;
-  if (!isNumber(n)) return 0;
-  const absValue = Math.abs(n);
-  if (absValue === 0) {
-    return 0;
-  }
-  const integerPart = Math.floor(absValue);
-  return Math.floor(Math.log10(integerPart));
-};
-
 // src/utils/regex.ts
 var REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;
 var REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
@@ -378,8 +359,43 @@ var truncate = (str, maxLength, ellipsis = "...") => {
   return str.slice(0, maxLength - ellipsis.length) + ellipsis;
 };
 
+// src/utils/number.utils.ts
+var isInputValidNumber = (value) => {
+  if (isBlank(value)) return false;
+  const num = Number(value.trim());
+  return Number.isFinite(num);
+};
+var isInputValidInteger = (value) => {
+  if (!isInputValidNumber(value)) return false;
+  const num = Number(value.trim());
+  return Number.isInteger(num);
+};
+var formatIntegerDisplay = (value) => String(toFixed(value, 0));
+var toFixed = (value, decimals = 0) => {
+  if (isNullish(value)) return 0;
+  if (decimals < 0) throw new Error("[toFixed] decimals must be >= 0");
+  if (decimals === 0) return Math.round(value);
+  const multiplier = Math.pow(10, decimals);
+  return Math.round(value * multiplier) / multiplier;
+};
+var roundUpToNearest10 = (value) => {
+  if (isNullish(value)) return 0;
+  return Math.ceil(value / 10) * 10;
+};
+var getOrderOfMagnitudeExponent = (n) => {
+  if (isNullish(n)) return 0;
+  if (!isNumber(n)) return 0;
+  const absValue = Math.abs(n);
+  if (absValue === 0) {
+    return 0;
+  }
+  const integerPart = Math.floor(absValue);
+  return Math.floor(Math.log10(integerPart));
+};
+
 // src/utils/thread.utils.ts
 var sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+var yieldToMainThread = () => sleep(0);
 
 // src/utils/time.utils.ts
 var ONE_SECOND_IN_MS = 1e3;
@@ -480,6 +496,7 @@ var closeWebSocket = (ws) => {
   dateAs_YYYYMMDD,
   dateAs_YYYYMMDD_HHMMSS,
   extractBase64FromDataUri,
+  formatIntegerDisplay,
   formatUnixTimestamp,
   fromHzToRpm,
   fromM3psToGPM,
@@ -504,6 +521,8 @@ var closeWebSocket = (ws) => {
   isHttpClientErrorStatus,
   isHttpServerErrorStatus,
   isHttpSuccessStatus,
+  isInputValidInteger,
+  isInputValidNumber,
   isLightColor,
   isNotBlank,
   isNullish,
@@ -528,6 +547,7 @@ var closeWebSocket = (ws) => {
   toFixed,
   toToleranceLabel,
   tooltipValueFormatter,
-  truncate
+  truncate,
+  yieldToMainThread
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/utils/types.utils.ts","../src/utils/chart.utils.ts","../src/utils/color.utils.ts","../src/utils/date.utils.ts","../src/utils/errors.utils.ts","../src/utils/http.utils.ts","../src/utils/number.utils.ts","../src/utils/regex.ts","../src/utils/string.utils.ts","../src/utils/thread.utils.ts","../src/utils/time.utils.ts","../src/utils/units.utils.ts","../src/utils/uri.utils.ts","../src/utils/websocket.utils.ts"],"sourcesContent":["export * from \"./utils\";\n","export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\nexport interface ToleranceArea {\n  flow: number;\n  toleranceRange: [number, number];\n}\n\n/**\n * A chart point with required x and y coordinates.\n */\nexport interface ChartPoint {\n  x: number;\n  y: number;\n}\n\n/**\n * A chart point with optional nullable x and y coordinates.\n */\nexport interface NullableChartPoint {\n  x?: number | null;\n  y?: number | null;\n}\n\nexport const getTickDomain = (ticks: number[]): [number, number] => [0, ticks.at(-1) ?? 0];\n\nexport const tickFormatter = (value: number): string => value.toFixed(0);\n\nexport const toToleranceLabel = (value: number): string => `±${(value * 100).toFixed(0)}%`;\n\nexport const tooltipValueFormatter = (data?: unknown | null): string => {\n  if (isNullish(data)) {\n    return '';\n  }\n\n  if (typeof data === 'number') {\n    return data.toFixed(2);\n  }\n\n  if (Array.isArray(data) && data.length >= 2) {\n    const [min, max] = data;\n    if (typeof min === 'number' && typeof max === 'number') {\n      return `[${min.toFixed(2)} … ${max.toFixed(2)}]`;\n    }\n  }\n\n  return String(data ?? '');\n};\n\n/**\n * Rounds a raw value to a \"nice\" number for chart axis increments.\n * Nice numbers are easy to read: 1, 2, 2.5, 5, or 10 multiplied by a power of 10.\n *\n * @param rawValue - The raw value to round to a nice number\n * @returns A nice number close to the raw value\n *\n * @example\n * roundToNiceNumber(0.7)  // returns 1\n * roundToNiceNumber(3)    // returns 5\n * roundToNiceNumber(17)   // returns 20\n * roundToNiceNumber(80)   // returns 100\n */\nexport const roundToNiceNumber = (rawValue: number): number => {\n  if (rawValue <= 0) return 0;\n\n  // Get order of magnitude\n  const magnitude = Math.pow(10, Math.floor(Math.log10(rawValue)));\n\n  // Normalize to find the multiplier (between 1 and 10)\n  const normalized = rawValue / magnitude;\n\n  // Round to nice values: 1, 2, 2.5, 5, 10\n  let niceMultiplier: number;\n  if (normalized <= 1) niceMultiplier = 1;\n  else if (normalized <= 2) niceMultiplier = 2;\n  else if (normalized <= 2.5) niceMultiplier = 2.5;\n  else if (normalized <= 5) niceMultiplier = 5;\n  else niceMultiplier = 10;\n\n  return niceMultiplier * magnitude;\n};\n\nconst roundToPrecision = (value: number, precision = 10): number => {\n  const factor = 10 ** precision;\n  return Math.round(value * factor) / factor;\n};\n\n/**\n * Builds an array of \"nice\" tick values for a chart axis.\n * The algorithm aims for approximately `targetTickCount` ticks with clean, readable values.\n *\n * @param max - The maximum value to display on the axis\n * @param targetTickCount - The desired number of ticks (default: 10)\n * @returns An array of tick values from 0 to at least `max`\n */\nexport const buildTicksForChart = (max: number, targetTickCount = 10): number[] => {\n  if (max <= 0) return [0];\n\n  // Calculate raw increment for desired tick count and round to nice value\n  const rawIncrement = max / targetTickCount;\n  const niceIncrement = roundToNiceNumber(rawIncrement);\n\n  // Build ticks from 0 to just past max\n  const ticks: number[] = [];\n  for (let value = 0; value <= max + niceIncrement * 0.5; value += niceIncrement) {\n    // Round to avoid floating point precision issues\n    ticks.push(roundToPrecision(value));\n  }\n\n  // Ensure we have at least one tick >= max\n  const lastTick = ticks[ticks.length - 1];\n  if (lastTick < max) {\n    ticks.push(roundToPrecision(lastTick + niceIncrement));\n  }\n\n  return ticks;\n};\n","export interface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface RgbaColor extends RgbColor {\n  a: number;\n}\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  if (r > 255 || g > 255 || b > 255) {\n    throw new Error(\"Invalid color component\");\n  }\n\n  return ((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\");\n};\n\nexport const hexToRgb = (hex: string): RgbColor => {\n  const cleanHex = hex.replace(\"#\", \"\");\n\n  const r = parseInt(cleanHex.substring(0, 2), 16);\n  const g = parseInt(cleanHex.substring(2, 4), 16);\n  const b = parseInt(cleanHex.substring(4, 6), 16);\n\n  return { r, g, b };\n};\n\nexport const rgbaToHex = (color: RgbaColor): string => {\n  return \"#\" + rgbToHex(color.r, color.g, color.b);\n};\n\nexport const getOpacityHexValue = (opacity: number): string => {\n  if (opacity < 0 || opacity > 1) {\n    throw new Error(\"Invalid opacity value\");\n  }\n\n  return Math.round(opacity * 255)\n    .toString(16)\n    .padStart(2, \"0\");\n};\n\nexport const rgbaToHexWithAlpha = (color: RgbaColor): string => {\n  return rgbaToHex(color) + getOpacityHexValue(color.a);\n};\n\nexport const rgbToString = (color: RgbColor): string => {\n  return `rgb(${color.r}, ${color.g}, ${color.b})`;\n};\n\nexport const rgbaToString = (color: RgbaColor): string => {\n  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;\n};\n\nexport const getLuminance = (r: number, g: number, b: number): number => {\n  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n};\n\nexport const getContrastTextColor = (hexColor: string): string => {\n  const { r, g, b } = hexToRgb(hexColor);\n  return getLuminance(r, g, b) > 0.5 ? \"#000000\" : \"#ffffff\";\n};\n\n/**\n * Normalized RGB color with values between 0 and 1.\n * Useful for graphics libraries like Three.js.\n */\nexport interface NormalizedRgb {\n  r: number;\n  g: number;\n  b: number;\n}\n\n/**\n * Convert a hex color string to normalized RGB values (0-1 range).\n * @param hex - Hex color string (with or without # prefix)\n * @returns Normalized RGB object with values between 0 and 1\n */\nexport const hexToNormalizedRgb = (hex: string): NormalizedRgb => {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16) / 255,\n        g: parseInt(result[2], 16) / 255,\n        b: parseInt(result[3], 16) / 255,\n      }\n    : { r: 0, g: 0, b: 0 };\n};\n\n/**\n * Determine if a color is light or dark based on relative luminance.\n * Useful for choosing contrasting text colors.\n * @param hex - Hex color string\n * @returns True if the color is considered light (luminance > 0.5)\n */\nexport const isLightColor = (hex: string): boolean => {\n  const rgb = hexToNormalizedRgb(hex);\n  // Calculate relative luminance using standard coefficients\n  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;\n  return luminance > 0.5;\n};\n\nconst PERCENT_COLORS = [\n  { pct: 0.0, color: { r: 0xff, g: 0x00, b: 0 } },\n  { pct: 0.5, color: { r: 0xff, g: 0xff, b: 0 } },\n  { pct: 1.0, color: { r: 0x00, g: 0xff, b: 0 } },\n] as const;\n\n// https://stackoverflow.com/a/7128796/704681\nexport const getColorForPercentage = (percent: number): string => {\n  if (percent < 0 || percent > 1) {\n    throw new Error(`Percentage must be between 0 and 1: ${percent}`);\n  }\n\n  let i = 0;\n  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {\n    if (percent < PERCENT_COLORS[i].pct) {\n      break;\n    }\n  }\n\n  const lower = PERCENT_COLORS[i - 1];\n  const upper = PERCENT_COLORS[i];\n  const range = upper.pct - lower.pct;\n  const rangePct = (percent - lower.pct) / range;\n  const pctLower = 1 - rangePct;\n  const pctUpper = rangePct;\n  const color = {\n    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),\n    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),\n    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper),\n  };\n\n  return \"rgb(\" + [color.r, color.g, color.b].join(\",\") + \")\";\n};\n","import { format } from \"date-fns\";\nimport { isNullish } from \"./types.utils\";\n\nexport type DateInput = Date | string | number | null;\n\nexport const dateAs_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"HH:mm:ss\");\n};\n\nexport const dateAs_YYYYMMDD = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd\");\n};\n\nexport const dateAs_YYYYMMDD_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd HH:mm:ss\");\n};\n\nexport const nowAsTime = () => dateAs_HHMMSS(new Date());\nexport const nowAsDate = () => dateAs_YYYYMMDD(new Date());\nexport const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());\n\nexport const nowAsDateTimeForFilename = () => {\n  return format(new Date(), \"yyyy-MM-dd_HH-mm-ss\");\n};\n\nconst DEFAULT_DATE_FORMAT = \"yyyy-MM-dd HH:mm:ss\";\n\n/**\n * Format a Unix timestamp (seconds since epoch) to a human-readable string.\n * @param timestamp - Unix timestamp in seconds\n * @param dateFormat - Date format string (default: \"yyyy-MM-dd HH:mm:ss\")\n * @returns Formatted date string or \"N/A\" if invalid or zero.\n */\nexport const formatUnixTimestamp = (\n  timestamp: number,\n  dateFormat: string = DEFAULT_DATE_FORMAT\n): string => {\n  if (!timestamp) return \"N/A\";\n  try {\n    return format(new Date(timestamp * 1000), dateFormat);\n  } catch {\n    return \"Invalid date\";\n  }\n};\n\n/**\n * Get the current Unix timestamp in seconds.\n * @returns Current Unix timestamp\n */\nexport const getCurrentUnixTimestamp = (): number => {\n  return Math.floor(Date.now() / 1000);\n};\n\n/**\n * Check if a Unix timestamp has expired (is in the past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is in the past\n */\nexport const isExpiredTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp < now;\n};\n\n/**\n * Check if a Unix timestamp is active (current or past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is current or in the past\n */\nexport const isActiveTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp <= now;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { isNullish } from './types.utils';\n\nexport const isHttpSuccessStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 200 && status < 300;\n};\n\nexport const isHttpClientErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 400 && status < 500;\n};\n\nexport const isHttpServerErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 500;\n};\n","import { isNullish, isNumber } from \"./types.utils\";\n\n// Example: toFixed(3.14159, 3) // 3.142\nexport const toFixed = (value?: number | null, decimals = 0): number => {\n  if (isNullish(value)) return 0;\n  if (decimals < 0) throw new Error(\"[toFixed] decimals must be >= 0\");\n  if (decimals === 0) return Math.round(value);\n\n  const multiplier = Math.pow(10, decimals);\n  return Math.round(value * multiplier) / multiplier;\n};\n\nexport const roundUpToNearest10 = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n  return Math.ceil(value / 10) * 10;\n};\n\nexport const getOrderOfMagnitudeExponent = (n?: number | null): number => {\n  if (isNullish(n)) return 0;\n  if (!isNumber(n)) return 0;\n\n  const absValue = Math.abs(n);  \n  if (absValue === 0) {\n    return 0;\n  }\n  \n  const integerPart = Math.floor(absValue);\n  return Math.floor(Math.log10(integerPart));\n}\n","export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;\n\nexport const REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n","export const sleep = (milliseconds: number) =>\n  new Promise((resolve) => setTimeout(resolve, milliseconds));\n","const ONE_SECOND_IN_MS = 1000;\nconst ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;\nconst ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;\nconst ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;\n\nexport const PeriodsInMS = {\n  oneSecond: ONE_SECOND_IN_MS,\n  oneMinute: ONE_MINUTE_IN_MS,\n  oneHour: ONE_HOUR_IN_MS,\n  oneDay: ONE_DAY_IN_MS,\n} as const;\n","import { isNullish } from \"./types.utils\";\n\n/** m³/s to gallons per minute */\nexport const M3PS_TO_GPM = 15850.3;\n\n/** Pascals to feet of head (1 Pa = 1 N/m²) */\nexport const PA_TO_FT = 0.000334553;\n\n/** Watts to Horsepower */\nexport const W_TO_HP = 0.00134102;\n\n/** meters to inches */\nexport const M_TO_INCHES = 39.3701;\n\n/** Hz to RPM (for synchronous speed) */\nexport const HZ_TO_RPM = 60;\n\nexport const fromM3psToGPM = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M3PS_TO_GPM;\n};\n\nexport const fromPaToFt = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * PA_TO_FT;\n};\n\nexport const fromWToHp = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * W_TO_HP;\n};\n\nexport const fromMToInches = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M_TO_INCHES;\n};\n\nexport const fromHzToRpm = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * HZ_TO_RPM;\n};\n","export const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","import { isNullish } from \"./types.utils\";\n\nconst WEBSOCKET_CONNECT_STATES: number[] = [WebSocket.CONNECTING, WebSocket.OPEN] as const;\n\nexport const isWsClosable = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const isWsOpenOrConnecting = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const closeWebSocket = (ws?: WebSocket | null) => {\n  if (isNullish(ws) || !isWsClosable(ws)) return;\n\n  try {\n    ws.close();\n  } catch {\n    // do nothing (best effort to close, ignore unexpected errors)\n  }\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/utils/types.utils.ts","../src/utils/chart.utils.ts","../src/utils/color.utils.ts","../src/utils/date.utils.ts","../src/utils/errors.utils.ts","../src/utils/http.utils.ts","../src/utils/regex.ts","../src/utils/string.utils.ts","../src/utils/number.utils.ts","../src/utils/thread.utils.ts","../src/utils/time.utils.ts","../src/utils/units.utils.ts","../src/utils/uri.utils.ts","../src/utils/websocket.utils.ts"],"sourcesContent":["export * from \"./utils\";\n","export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\nexport interface ToleranceArea {\n  flow: number;\n  toleranceRange: [number, number];\n}\n\n/**\n * A chart point with required x and y coordinates.\n */\nexport interface ChartPoint {\n  x: number;\n  y: number;\n}\n\n/**\n * A chart point with optional nullable x and y coordinates.\n */\nexport interface NullableChartPoint {\n  x?: number | null;\n  y?: number | null;\n}\n\nexport const getTickDomain = (ticks: number[]): [number, number] => [0, ticks.at(-1) ?? 0];\n\nexport const tickFormatter = (value: number): string => value.toFixed(0);\n\nexport const toToleranceLabel = (value: number): string => `±${(value * 100).toFixed(0)}%`;\n\nexport const tooltipValueFormatter = (data?: unknown | null): string => {\n  if (isNullish(data)) {\n    return '';\n  }\n\n  if (typeof data === 'number') {\n    return data.toFixed(2);\n  }\n\n  if (Array.isArray(data) && data.length >= 2) {\n    const [min, max] = data;\n    if (typeof min === 'number' && typeof max === 'number') {\n      return `[${min.toFixed(2)} … ${max.toFixed(2)}]`;\n    }\n  }\n\n  return String(data ?? '');\n};\n\n/**\n * Rounds a raw value to a \"nice\" number for chart axis increments.\n * Nice numbers are easy to read: 1, 2, 2.5, 5, or 10 multiplied by a power of 10.\n *\n * @param rawValue - The raw value to round to a nice number\n * @returns A nice number close to the raw value\n *\n * @example\n * roundToNiceNumber(0.7)  // returns 1\n * roundToNiceNumber(3)    // returns 5\n * roundToNiceNumber(17)   // returns 20\n * roundToNiceNumber(80)   // returns 100\n */\nexport const roundToNiceNumber = (rawValue: number): number => {\n  if (rawValue <= 0) return 0;\n\n  // Get order of magnitude\n  const magnitude = Math.pow(10, Math.floor(Math.log10(rawValue)));\n\n  // Normalize to find the multiplier (between 1 and 10)\n  const normalized = rawValue / magnitude;\n\n  // Round to nice values: 1, 2, 2.5, 5, 10\n  let niceMultiplier: number;\n  if (normalized <= 1) niceMultiplier = 1;\n  else if (normalized <= 2) niceMultiplier = 2;\n  else if (normalized <= 2.5) niceMultiplier = 2.5;\n  else if (normalized <= 5) niceMultiplier = 5;\n  else niceMultiplier = 10;\n\n  return niceMultiplier * magnitude;\n};\n\nconst roundToPrecision = (value: number, precision = 10): number => {\n  const factor = 10 ** precision;\n  return Math.round(value * factor) / factor;\n};\n\n/**\n * Builds an array of \"nice\" tick values for a chart axis.\n * The algorithm aims for approximately `targetTickCount` ticks with clean, readable values.\n *\n * @param max - The maximum value to display on the axis\n * @param targetTickCount - The desired number of ticks (default: 10)\n * @returns An array of tick values from 0 to at least `max`\n */\nexport const buildTicksForChart = (max: number, targetTickCount = 10): number[] => {\n  if (max <= 0) return [0];\n\n  // Calculate raw increment for desired tick count and round to nice value\n  const rawIncrement = max / targetTickCount;\n  const niceIncrement = roundToNiceNumber(rawIncrement);\n\n  // Build ticks from 0 to just past max\n  const ticks: number[] = [];\n  for (let value = 0; value <= max + niceIncrement * 0.5; value += niceIncrement) {\n    // Round to avoid floating point precision issues\n    ticks.push(roundToPrecision(value));\n  }\n\n  // Ensure we have at least one tick >= max\n  const lastTick = ticks[ticks.length - 1];\n  if (lastTick < max) {\n    ticks.push(roundToPrecision(lastTick + niceIncrement));\n  }\n\n  return ticks;\n};\n","export interface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface RgbaColor extends RgbColor {\n  a: number;\n}\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  if (r > 255 || g > 255 || b > 255) {\n    throw new Error(\"Invalid color component\");\n  }\n\n  return ((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\");\n};\n\nexport const hexToRgb = (hex: string): RgbColor => {\n  const cleanHex = hex.replace(\"#\", \"\");\n\n  const r = parseInt(cleanHex.substring(0, 2), 16);\n  const g = parseInt(cleanHex.substring(2, 4), 16);\n  const b = parseInt(cleanHex.substring(4, 6), 16);\n\n  return { r, g, b };\n};\n\nexport const rgbaToHex = (color: RgbaColor): string => {\n  return \"#\" + rgbToHex(color.r, color.g, color.b);\n};\n\nexport const getOpacityHexValue = (opacity: number): string => {\n  if (opacity < 0 || opacity > 1) {\n    throw new Error(\"Invalid opacity value\");\n  }\n\n  return Math.round(opacity * 255)\n    .toString(16)\n    .padStart(2, \"0\");\n};\n\nexport const rgbaToHexWithAlpha = (color: RgbaColor): string => {\n  return rgbaToHex(color) + getOpacityHexValue(color.a);\n};\n\nexport const rgbToString = (color: RgbColor): string => {\n  return `rgb(${color.r}, ${color.g}, ${color.b})`;\n};\n\nexport const rgbaToString = (color: RgbaColor): string => {\n  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;\n};\n\nexport const getLuminance = (r: number, g: number, b: number): number => {\n  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n};\n\nexport const getContrastTextColor = (hexColor: string): string => {\n  const { r, g, b } = hexToRgb(hexColor);\n  return getLuminance(r, g, b) > 0.5 ? \"#000000\" : \"#ffffff\";\n};\n\n/**\n * Normalized RGB color with values between 0 and 1.\n * Useful for graphics libraries like Three.js.\n */\nexport interface NormalizedRgb {\n  r: number;\n  g: number;\n  b: number;\n}\n\n/**\n * Convert a hex color string to normalized RGB values (0-1 range).\n * @param hex - Hex color string (with or without # prefix)\n * @returns Normalized RGB object with values between 0 and 1\n */\nexport const hexToNormalizedRgb = (hex: string): NormalizedRgb => {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16) / 255,\n        g: parseInt(result[2], 16) / 255,\n        b: parseInt(result[3], 16) / 255,\n      }\n    : { r: 0, g: 0, b: 0 };\n};\n\n/**\n * Determine if a color is light or dark based on relative luminance.\n * Useful for choosing contrasting text colors.\n * @param hex - Hex color string\n * @returns True if the color is considered light (luminance > 0.5)\n */\nexport const isLightColor = (hex: string): boolean => {\n  const rgb = hexToNormalizedRgb(hex);\n  // Calculate relative luminance using standard coefficients\n  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;\n  return luminance > 0.5;\n};\n\nconst PERCENT_COLORS = [\n  { pct: 0.0, color: { r: 0xff, g: 0x00, b: 0 } },\n  { pct: 0.5, color: { r: 0xff, g: 0xff, b: 0 } },\n  { pct: 1.0, color: { r: 0x00, g: 0xff, b: 0 } },\n] as const;\n\n// https://stackoverflow.com/a/7128796/704681\nexport const getColorForPercentage = (percent: number): string => {\n  if (percent < 0 || percent > 1) {\n    throw new Error(`Percentage must be between 0 and 1: ${percent}`);\n  }\n\n  let i = 0;\n  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {\n    if (percent < PERCENT_COLORS[i].pct) {\n      break;\n    }\n  }\n\n  const lower = PERCENT_COLORS[i - 1];\n  const upper = PERCENT_COLORS[i];\n  const range = upper.pct - lower.pct;\n  const rangePct = (percent - lower.pct) / range;\n  const pctLower = 1 - rangePct;\n  const pctUpper = rangePct;\n  const color = {\n    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),\n    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),\n    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper),\n  };\n\n  return \"rgb(\" + [color.r, color.g, color.b].join(\",\") + \")\";\n};\n","import { format } from \"date-fns\";\nimport { isNullish } from \"./types.utils\";\n\nexport type DateInput = Date | string | number | null;\n\nexport const dateAs_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"HH:mm:ss\");\n};\n\nexport const dateAs_YYYYMMDD = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd\");\n};\n\nexport const dateAs_YYYYMMDD_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd HH:mm:ss\");\n};\n\nexport const nowAsTime = () => dateAs_HHMMSS(new Date());\nexport const nowAsDate = () => dateAs_YYYYMMDD(new Date());\nexport const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());\n\nexport const nowAsDateTimeForFilename = () => {\n  return format(new Date(), \"yyyy-MM-dd_HH-mm-ss\");\n};\n\nconst DEFAULT_DATE_FORMAT = \"yyyy-MM-dd HH:mm:ss\";\n\n/**\n * Format a Unix timestamp (seconds since epoch) to a human-readable string.\n * @param timestamp - Unix timestamp in seconds\n * @param dateFormat - Date format string (default: \"yyyy-MM-dd HH:mm:ss\")\n * @returns Formatted date string or \"N/A\" if invalid or zero.\n */\nexport const formatUnixTimestamp = (\n  timestamp: number,\n  dateFormat: string = DEFAULT_DATE_FORMAT\n): string => {\n  if (!timestamp) return \"N/A\";\n  try {\n    return format(new Date(timestamp * 1000), dateFormat);\n  } catch {\n    return \"Invalid date\";\n  }\n};\n\n/**\n * Get the current Unix timestamp in seconds.\n * @returns Current Unix timestamp\n */\nexport const getCurrentUnixTimestamp = (): number => {\n  return Math.floor(Date.now() / 1000);\n};\n\n/**\n * Check if a Unix timestamp has expired (is in the past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is in the past\n */\nexport const isExpiredTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp < now;\n};\n\n/**\n * Check if a Unix timestamp is active (current or past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is current or in the past\n */\nexport const isActiveTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp <= now;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { isNullish } from './types.utils';\n\nexport const isHttpSuccessStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 200 && status < 300;\n};\n\nexport const isHttpClientErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 400 && status < 500;\n};\n\nexport const isHttpServerErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 500;\n};\n","export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;\n\nexport const REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n","import { isBlank } from './string.utils';\nimport { isNullish, isNumber } from \"./types.utils\";\n\n/**\n * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).\n */\nexport const isInputValidNumber = (value: string): boolean => {\n  if (isBlank(value)) return false;\n  const num = Number(value.trim());\n  return Number.isFinite(num);\n};\n\n/**\n * Returns true if the input string is a valid integer (decimals like \"1500.5\" are invalid).\n */\nexport const isInputValidInteger = (value: string): boolean => {\n  if (!isInputValidNumber(value)) return false;\n  const num = Number(value.trim());\n  return Number.isInteger(num);\n};\n\n/**\n * Formats a number as an integer display string (removes decimals).\n */\nexport const formatIntegerDisplay = (value?: number | null): string =>\n  String(toFixed(value, 0));\n\n// Example: toFixed(3.14159, 3) // 3.142\nexport const toFixed = (value?: number | null, decimals = 0): number => {\n  if (isNullish(value)) return 0;\n  if (decimals < 0) throw new Error(\"[toFixed] decimals must be >= 0\");\n  if (decimals === 0) return Math.round(value);\n\n  const multiplier = Math.pow(10, decimals);\n  return Math.round(value * multiplier) / multiplier;\n};\n\nexport const roundUpToNearest10 = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n  return Math.ceil(value / 10) * 10;\n};\n\nexport const getOrderOfMagnitudeExponent = (n?: number | null): number => {\n  if (isNullish(n)) return 0;\n  if (!isNumber(n)) return 0;\n\n  const absValue = Math.abs(n);  \n  if (absValue === 0) {\n    return 0;\n  }\n  \n  const integerPart = Math.floor(absValue);\n  return Math.floor(Math.log10(integerPart));\n}\n","export const sleep = (milliseconds: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, milliseconds));\n\n/**\n * Yields to the main thread so the UI can process events and repaint.\n * Use during long-running synchronous work (e.g. report generation) to keep the app responsive.\n */\nexport const yieldToMainThread = (): Promise<void> => sleep(0);\n","const ONE_SECOND_IN_MS = 1000;\nconst ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;\nconst ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;\nconst ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;\n\nexport const PeriodsInMS = {\n  oneSecond: ONE_SECOND_IN_MS,\n  oneMinute: ONE_MINUTE_IN_MS,\n  oneHour: ONE_HOUR_IN_MS,\n  oneDay: ONE_DAY_IN_MS,\n} as const;\n","import { isNullish } from \"./types.utils\";\n\n/** m³/s to gallons per minute */\nexport const M3PS_TO_GPM = 15850.3;\n\n/** Pascals to feet of head (1 Pa = 1 N/m²) */\nexport const PA_TO_FT = 0.000334553;\n\n/** Watts to Horsepower */\nexport const W_TO_HP = 0.00134102;\n\n/** meters to inches */\nexport const M_TO_INCHES = 39.3701;\n\n/** Hz to RPM (for synchronous speed) */\nexport const HZ_TO_RPM = 60;\n\nexport const fromM3psToGPM = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M3PS_TO_GPM;\n};\n\nexport const fromPaToFt = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * PA_TO_FT;\n};\n\nexport const fromWToHp = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * W_TO_HP;\n};\n\nexport const fromMToInches = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M_TO_INCHES;\n};\n\nexport const fromHzToRpm = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * HZ_TO_RPM;\n};\n","export const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","import { isNullish } from \"./types.utils\";\n\nconst WEBSOCKET_CONNECT_STATES: number[] = [WebSocket.CONNECTING, WebSocket.OPEN] as const;\n\nexport const isWsClosable = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const isWsOpenOrConnecting = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const closeWebSocket = (ws?: WebSocket | null) => {\n  if (isNullish(ws) || !isWsClosable(ws)) return;\n\n  try {\n    ws.close();\n  } catch {\n    // do nothing (best effort to close, ignore unexpected errors)\n  }\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -129,6 +129,18 @@ declare const isHttpSuccessStatus: (status?: number | null) => boolean;
 declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
 declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
 
+/**
+ * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).
+ */
+declare const isInputValidNumber: (value: string) => boolean;
+/**
+ * Returns true if the input string is a valid integer (decimals like "1500.5" are invalid).
+ */
+declare const isInputValidInteger: (value: string) => boolean;
+/**
+ * Formats a number as an integer display string (removes decimals).
+ */
+declare const formatIntegerDisplay: (value?: number | null) => string;
 declare const toFixed: (value?: number | null, decimals?: number) => number;
 declare const roundUpToNearest10: (value?: number | null) => number;
 declare const getOrderOfMagnitudeExponent: (n?: number | null) => number;
@@ -174,7 +186,12 @@ declare const countWords: (text: string) => number;
  */
 declare const truncate: (str: string, maxLength: number, ellipsis?: string) => string;
 
-declare const sleep: (milliseconds: number) => Promise<unknown>;
+declare const sleep: (milliseconds: number) => Promise<void>;
+/**
+ * Yields to the main thread so the UI can process events and repaint.
+ * Use during long-running synchronous work (e.g. report generation) to keep the app responsive.
+ */
+declare const yieldToMainThread: () => Promise<void>;
 
 declare const PeriodsInMS: {
     readonly oneSecond: 1000;
@@ -229,4 +246,4 @@ 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, type DateInput, type Dimensions, 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, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isLightColor, isNotBlank, isNullish, isNumber, isString, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toFixed, toToleranceLabel, tooltipValueFormatter, truncate };
+export { type ChartPoint, type DateInput, type Dimensions, 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, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNumber, isLightColor, isNotBlank, isNullish, isNumber, isString, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toFixed, toToleranceLabel, tooltipValueFormatter, truncate, yieldToMainThread };

package/dist/index.d.ts

@@ -129,6 +129,18 @@ declare const isHttpSuccessStatus: (status?: number | null) => boolean;
 declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
 declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
 
+/**
+ * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).
+ */
+declare const isInputValidNumber: (value: string) => boolean;
+/**
+ * Returns true if the input string is a valid integer (decimals like "1500.5" are invalid).
+ */
+declare const isInputValidInteger: (value: string) => boolean;
+/**
+ * Formats a number as an integer display string (removes decimals).
+ */
+declare const formatIntegerDisplay: (value?: number | null) => string;
 declare const toFixed: (value?: number | null, decimals?: number) => number;
 declare const roundUpToNearest10: (value?: number | null) => number;
 declare const getOrderOfMagnitudeExponent: (n?: number | null) => number;
@@ -174,7 +186,12 @@ declare const countWords: (text: string) => number;
  */
 declare const truncate: (str: string, maxLength: number, ellipsis?: string) => string;
 
-declare const sleep: (milliseconds: number) => Promise<unknown>;
+declare const sleep: (milliseconds: number) => Promise<void>;
+/**
+ * Yields to the main thread so the UI can process events and repaint.
+ * Use during long-running synchronous work (e.g. report generation) to keep the app responsive.
+ */
+declare const yieldToMainThread: () => Promise<void>;
 
 declare const PeriodsInMS: {
     readonly oneSecond: 1000;
@@ -229,4 +246,4 @@ 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, type DateInput, type Dimensions, 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, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isLightColor, isNotBlank, isNullish, isNumber, isString, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toFixed, toToleranceLabel, tooltipValueFormatter, truncate };
+export { type ChartPoint, type DateInput, type Dimensions, 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, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, getTickDomain, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isInputValidInteger, isInputValidNumber, isLightColor, isNotBlank, isNullish, isNumber, isString, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundToNiceNumber, roundUpToNearest10, sleep, tickFormatter, toFixed, toToleranceLabel, tooltipValueFormatter, truncate, yieldToMainThread };

package/dist/index.js

@@ -230,29 +230,6 @@ var isHttpServerErrorStatus = (status) => {
   return status >= 500;
 };
 
-// src/utils/number.utils.ts
-var toFixed = (value, decimals = 0) => {
-  if (isNullish(value)) return 0;
-  if (decimals < 0) throw new Error("[toFixed] decimals must be >= 0");
-  if (decimals === 0) return Math.round(value);
-  const multiplier = Math.pow(10, decimals);
-  return Math.round(value * multiplier) / multiplier;
-};
-var roundUpToNearest10 = (value) => {
-  if (isNullish(value)) return 0;
-  return Math.ceil(value / 10) * 10;
-};
-var getOrderOfMagnitudeExponent = (n) => {
-  if (isNullish(n)) return 0;
-  if (!isNumber(n)) return 0;
-  const absValue = Math.abs(n);
-  if (absValue === 0) {
-    return 0;
-  }
-  const integerPart = Math.floor(absValue);
-  return Math.floor(Math.log10(integerPart));
-};
-
 // src/utils/regex.ts
 var REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;
 var REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
@@ -286,8 +263,43 @@ var truncate = (str, maxLength, ellipsis = "...") => {
   return str.slice(0, maxLength - ellipsis.length) + ellipsis;
 };
 
+// src/utils/number.utils.ts
+var isInputValidNumber = (value) => {
+  if (isBlank(value)) return false;
+  const num = Number(value.trim());
+  return Number.isFinite(num);
+};
+var isInputValidInteger = (value) => {
+  if (!isInputValidNumber(value)) return false;
+  const num = Number(value.trim());
+  return Number.isInteger(num);
+};
+var formatIntegerDisplay = (value) => String(toFixed(value, 0));
+var toFixed = (value, decimals = 0) => {
+  if (isNullish(value)) return 0;
+  if (decimals < 0) throw new Error("[toFixed] decimals must be >= 0");
+  if (decimals === 0) return Math.round(value);
+  const multiplier = Math.pow(10, decimals);
+  return Math.round(value * multiplier) / multiplier;
+};
+var roundUpToNearest10 = (value) => {
+  if (isNullish(value)) return 0;
+  return Math.ceil(value / 10) * 10;
+};
+var getOrderOfMagnitudeExponent = (n) => {
+  if (isNullish(n)) return 0;
+  if (!isNumber(n)) return 0;
+  const absValue = Math.abs(n);
+  if (absValue === 0) {
+    return 0;
+  }
+  const integerPart = Math.floor(absValue);
+  return Math.floor(Math.log10(integerPart));
+};
+
 // src/utils/thread.utils.ts
 var sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+var yieldToMainThread = () => sleep(0);
 
 // src/utils/time.utils.ts
 var ONE_SECOND_IN_MS = 1e3;
@@ -387,6 +399,7 @@ export {
   dateAs_YYYYMMDD,
   dateAs_YYYYMMDD_HHMMSS,
   extractBase64FromDataUri,
+  formatIntegerDisplay,
   formatUnixTimestamp,
   fromHzToRpm,
   fromM3psToGPM,
@@ -411,6 +424,8 @@ export {
   isHttpClientErrorStatus,
   isHttpServerErrorStatus,
   isHttpSuccessStatus,
+  isInputValidInteger,
+  isInputValidNumber,
   isLightColor,
   isNotBlank,
   isNullish,
@@ -435,6 +450,7 @@ export {
   toFixed,
   toToleranceLabel,
   tooltipValueFormatter,
-  truncate
+  truncate,
+  yieldToMainThread
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/chart.utils.ts","../src/utils/color.utils.ts","../src/utils/date.utils.ts","../src/utils/errors.utils.ts","../src/utils/http.utils.ts","../src/utils/number.utils.ts","../src/utils/regex.ts","../src/utils/string.utils.ts","../src/utils/thread.utils.ts","../src/utils/time.utils.ts","../src/utils/units.utils.ts","../src/utils/uri.utils.ts","../src/utils/websocket.utils.ts"],"sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\nexport interface ToleranceArea {\n  flow: number;\n  toleranceRange: [number, number];\n}\n\n/**\n * A chart point with required x and y coordinates.\n */\nexport interface ChartPoint {\n  x: number;\n  y: number;\n}\n\n/**\n * A chart point with optional nullable x and y coordinates.\n */\nexport interface NullableChartPoint {\n  x?: number | null;\n  y?: number | null;\n}\n\nexport const getTickDomain = (ticks: number[]): [number, number] => [0, ticks.at(-1) ?? 0];\n\nexport const tickFormatter = (value: number): string => value.toFixed(0);\n\nexport const toToleranceLabel = (value: number): string => `±${(value * 100).toFixed(0)}%`;\n\nexport const tooltipValueFormatter = (data?: unknown | null): string => {\n  if (isNullish(data)) {\n    return '';\n  }\n\n  if (typeof data === 'number') {\n    return data.toFixed(2);\n  }\n\n  if (Array.isArray(data) && data.length >= 2) {\n    const [min, max] = data;\n    if (typeof min === 'number' && typeof max === 'number') {\n      return `[${min.toFixed(2)} … ${max.toFixed(2)}]`;\n    }\n  }\n\n  return String(data ?? '');\n};\n\n/**\n * Rounds a raw value to a \"nice\" number for chart axis increments.\n * Nice numbers are easy to read: 1, 2, 2.5, 5, or 10 multiplied by a power of 10.\n *\n * @param rawValue - The raw value to round to a nice number\n * @returns A nice number close to the raw value\n *\n * @example\n * roundToNiceNumber(0.7)  // returns 1\n * roundToNiceNumber(3)    // returns 5\n * roundToNiceNumber(17)   // returns 20\n * roundToNiceNumber(80)   // returns 100\n */\nexport const roundToNiceNumber = (rawValue: number): number => {\n  if (rawValue <= 0) return 0;\n\n  // Get order of magnitude\n  const magnitude = Math.pow(10, Math.floor(Math.log10(rawValue)));\n\n  // Normalize to find the multiplier (between 1 and 10)\n  const normalized = rawValue / magnitude;\n\n  // Round to nice values: 1, 2, 2.5, 5, 10\n  let niceMultiplier: number;\n  if (normalized <= 1) niceMultiplier = 1;\n  else if (normalized <= 2) niceMultiplier = 2;\n  else if (normalized <= 2.5) niceMultiplier = 2.5;\n  else if (normalized <= 5) niceMultiplier = 5;\n  else niceMultiplier = 10;\n\n  return niceMultiplier * magnitude;\n};\n\nconst roundToPrecision = (value: number, precision = 10): number => {\n  const factor = 10 ** precision;\n  return Math.round(value * factor) / factor;\n};\n\n/**\n * Builds an array of \"nice\" tick values for a chart axis.\n * The algorithm aims for approximately `targetTickCount` ticks with clean, readable values.\n *\n * @param max - The maximum value to display on the axis\n * @param targetTickCount - The desired number of ticks (default: 10)\n * @returns An array of tick values from 0 to at least `max`\n */\nexport const buildTicksForChart = (max: number, targetTickCount = 10): number[] => {\n  if (max <= 0) return [0];\n\n  // Calculate raw increment for desired tick count and round to nice value\n  const rawIncrement = max / targetTickCount;\n  const niceIncrement = roundToNiceNumber(rawIncrement);\n\n  // Build ticks from 0 to just past max\n  const ticks: number[] = [];\n  for (let value = 0; value <= max + niceIncrement * 0.5; value += niceIncrement) {\n    // Round to avoid floating point precision issues\n    ticks.push(roundToPrecision(value));\n  }\n\n  // Ensure we have at least one tick >= max\n  const lastTick = ticks[ticks.length - 1];\n  if (lastTick < max) {\n    ticks.push(roundToPrecision(lastTick + niceIncrement));\n  }\n\n  return ticks;\n};\n","export interface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface RgbaColor extends RgbColor {\n  a: number;\n}\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  if (r > 255 || g > 255 || b > 255) {\n    throw new Error(\"Invalid color component\");\n  }\n\n  return ((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\");\n};\n\nexport const hexToRgb = (hex: string): RgbColor => {\n  const cleanHex = hex.replace(\"#\", \"\");\n\n  const r = parseInt(cleanHex.substring(0, 2), 16);\n  const g = parseInt(cleanHex.substring(2, 4), 16);\n  const b = parseInt(cleanHex.substring(4, 6), 16);\n\n  return { r, g, b };\n};\n\nexport const rgbaToHex = (color: RgbaColor): string => {\n  return \"#\" + rgbToHex(color.r, color.g, color.b);\n};\n\nexport const getOpacityHexValue = (opacity: number): string => {\n  if (opacity < 0 || opacity > 1) {\n    throw new Error(\"Invalid opacity value\");\n  }\n\n  return Math.round(opacity * 255)\n    .toString(16)\n    .padStart(2, \"0\");\n};\n\nexport const rgbaToHexWithAlpha = (color: RgbaColor): string => {\n  return rgbaToHex(color) + getOpacityHexValue(color.a);\n};\n\nexport const rgbToString = (color: RgbColor): string => {\n  return `rgb(${color.r}, ${color.g}, ${color.b})`;\n};\n\nexport const rgbaToString = (color: RgbaColor): string => {\n  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;\n};\n\nexport const getLuminance = (r: number, g: number, b: number): number => {\n  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n};\n\nexport const getContrastTextColor = (hexColor: string): string => {\n  const { r, g, b } = hexToRgb(hexColor);\n  return getLuminance(r, g, b) > 0.5 ? \"#000000\" : \"#ffffff\";\n};\n\n/**\n * Normalized RGB color with values between 0 and 1.\n * Useful for graphics libraries like Three.js.\n */\nexport interface NormalizedRgb {\n  r: number;\n  g: number;\n  b: number;\n}\n\n/**\n * Convert a hex color string to normalized RGB values (0-1 range).\n * @param hex - Hex color string (with or without # prefix)\n * @returns Normalized RGB object with values between 0 and 1\n */\nexport const hexToNormalizedRgb = (hex: string): NormalizedRgb => {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16) / 255,\n        g: parseInt(result[2], 16) / 255,\n        b: parseInt(result[3], 16) / 255,\n      }\n    : { r: 0, g: 0, b: 0 };\n};\n\n/**\n * Determine if a color is light or dark based on relative luminance.\n * Useful for choosing contrasting text colors.\n * @param hex - Hex color string\n * @returns True if the color is considered light (luminance > 0.5)\n */\nexport const isLightColor = (hex: string): boolean => {\n  const rgb = hexToNormalizedRgb(hex);\n  // Calculate relative luminance using standard coefficients\n  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;\n  return luminance > 0.5;\n};\n\nconst PERCENT_COLORS = [\n  { pct: 0.0, color: { r: 0xff, g: 0x00, b: 0 } },\n  { pct: 0.5, color: { r: 0xff, g: 0xff, b: 0 } },\n  { pct: 1.0, color: { r: 0x00, g: 0xff, b: 0 } },\n] as const;\n\n// https://stackoverflow.com/a/7128796/704681\nexport const getColorForPercentage = (percent: number): string => {\n  if (percent < 0 || percent > 1) {\n    throw new Error(`Percentage must be between 0 and 1: ${percent}`);\n  }\n\n  let i = 0;\n  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {\n    if (percent < PERCENT_COLORS[i].pct) {\n      break;\n    }\n  }\n\n  const lower = PERCENT_COLORS[i - 1];\n  const upper = PERCENT_COLORS[i];\n  const range = upper.pct - lower.pct;\n  const rangePct = (percent - lower.pct) / range;\n  const pctLower = 1 - rangePct;\n  const pctUpper = rangePct;\n  const color = {\n    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),\n    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),\n    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper),\n  };\n\n  return \"rgb(\" + [color.r, color.g, color.b].join(\",\") + \")\";\n};\n","import { format } from \"date-fns\";\nimport { isNullish } from \"./types.utils\";\n\nexport type DateInput = Date | string | number | null;\n\nexport const dateAs_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"HH:mm:ss\");\n};\n\nexport const dateAs_YYYYMMDD = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd\");\n};\n\nexport const dateAs_YYYYMMDD_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd HH:mm:ss\");\n};\n\nexport const nowAsTime = () => dateAs_HHMMSS(new Date());\nexport const nowAsDate = () => dateAs_YYYYMMDD(new Date());\nexport const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());\n\nexport const nowAsDateTimeForFilename = () => {\n  return format(new Date(), \"yyyy-MM-dd_HH-mm-ss\");\n};\n\nconst DEFAULT_DATE_FORMAT = \"yyyy-MM-dd HH:mm:ss\";\n\n/**\n * Format a Unix timestamp (seconds since epoch) to a human-readable string.\n * @param timestamp - Unix timestamp in seconds\n * @param dateFormat - Date format string (default: \"yyyy-MM-dd HH:mm:ss\")\n * @returns Formatted date string or \"N/A\" if invalid or zero.\n */\nexport const formatUnixTimestamp = (\n  timestamp: number,\n  dateFormat: string = DEFAULT_DATE_FORMAT\n): string => {\n  if (!timestamp) return \"N/A\";\n  try {\n    return format(new Date(timestamp * 1000), dateFormat);\n  } catch {\n    return \"Invalid date\";\n  }\n};\n\n/**\n * Get the current Unix timestamp in seconds.\n * @returns Current Unix timestamp\n */\nexport const getCurrentUnixTimestamp = (): number => {\n  return Math.floor(Date.now() / 1000);\n};\n\n/**\n * Check if a Unix timestamp has expired (is in the past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is in the past\n */\nexport const isExpiredTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp < now;\n};\n\n/**\n * Check if a Unix timestamp is active (current or past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is current or in the past\n */\nexport const isActiveTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp <= now;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { isNullish } from './types.utils';\n\nexport const isHttpSuccessStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 200 && status < 300;\n};\n\nexport const isHttpClientErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 400 && status < 500;\n};\n\nexport const isHttpServerErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 500;\n};\n","import { isNullish, isNumber } from \"./types.utils\";\n\n// Example: toFixed(3.14159, 3) // 3.142\nexport const toFixed = (value?: number | null, decimals = 0): number => {\n  if (isNullish(value)) return 0;\n  if (decimals < 0) throw new Error(\"[toFixed] decimals must be >= 0\");\n  if (decimals === 0) return Math.round(value);\n\n  const multiplier = Math.pow(10, decimals);\n  return Math.round(value * multiplier) / multiplier;\n};\n\nexport const roundUpToNearest10 = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n  return Math.ceil(value / 10) * 10;\n};\n\nexport const getOrderOfMagnitudeExponent = (n?: number | null): number => {\n  if (isNullish(n)) return 0;\n  if (!isNumber(n)) return 0;\n\n  const absValue = Math.abs(n);  \n  if (absValue === 0) {\n    return 0;\n  }\n  \n  const integerPart = Math.floor(absValue);\n  return Math.floor(Math.log10(integerPart));\n}\n","export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;\n\nexport const REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n","export const sleep = (milliseconds: number) =>\n  new Promise((resolve) => setTimeout(resolve, milliseconds));\n","const ONE_SECOND_IN_MS = 1000;\nconst ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;\nconst ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;\nconst ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;\n\nexport const PeriodsInMS = {\n  oneSecond: ONE_SECOND_IN_MS,\n  oneMinute: ONE_MINUTE_IN_MS,\n  oneHour: ONE_HOUR_IN_MS,\n  oneDay: ONE_DAY_IN_MS,\n} as const;\n","import { isNullish } from \"./types.utils\";\n\n/** m³/s to gallons per minute */\nexport const M3PS_TO_GPM = 15850.3;\n\n/** Pascals to feet of head (1 Pa = 1 N/m²) */\nexport const PA_TO_FT = 0.000334553;\n\n/** Watts to Horsepower */\nexport const W_TO_HP = 0.00134102;\n\n/** meters to inches */\nexport const M_TO_INCHES = 39.3701;\n\n/** Hz to RPM (for synchronous speed) */\nexport const HZ_TO_RPM = 60;\n\nexport const fromM3psToGPM = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M3PS_TO_GPM;\n};\n\nexport const fromPaToFt = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * PA_TO_FT;\n};\n\nexport const fromWToHp = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * W_TO_HP;\n};\n\nexport const fromMToInches = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M_TO_INCHES;\n};\n\nexport const fromHzToRpm = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * HZ_TO_RPM;\n};\n","export const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","import { isNullish } from \"./types.utils\";\n\nconst WEBSOCKET_CONNECT_STATES: number[] = [WebSocket.CONNECTING, WebSocket.OPEN] as const;\n\nexport const isWsClosable = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const isWsOpenOrConnecting = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const closeWebSocket = (ws?: WebSocket | null) => {\n  if (isNullish(ws) || !isWsClosable(ws)) return;\n\n  try {\n    ws.close();\n  } catch {\n    // do nothing (best effort to close, ignore unexpected errors)\n  }\n};\n"],"mappings":";AAAO,IAAM,QAAoB,MAAM;AAAC;AAEjC,IAAM,YAAY,CAAC,UAA8C,UAAU,QAAQ,UAAU;AAE7F,IAAM,WAAW,CAAC,UAA4C;AACnE,MAAI,UAAU,KAAK,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,KAAK,GAAG;AAChB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,IAAM,WAAW,CAAC,UAA4C;AACnE,MAAI,UAAU,KAAK,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;ACPO,IAAM,gBAAgB,CAAC,UAAsC,CAAC,GAAG,MAAM,GAAG,EAAE,KAAK,CAAC;AAElF,IAAM,gBAAgB,CAAC,UAA0B,MAAM,QAAQ,CAAC;AAEhE,IAAM,mBAAmB,CAAC,UAA0B,QAAK,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAEhF,IAAM,wBAAwB,CAAC,SAAkC;AACtE,MAAI,UAAU,IAAI,GAAG;AACnB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,KAAK,QAAQ,CAAC;AAAA,EACvB;AAEA,MAAI,MAAM,QAAQ,IAAI,KAAK,KAAK,UAAU,GAAG;AAC3C,UAAM,CAAC,KAAK,GAAG,IAAI;AACnB,QAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAAU;AACtD,aAAO,IAAI,IAAI,QAAQ,CAAC,CAAC,WAAM,IAAI,QAAQ,CAAC,CAAC;AAAA,IAC/C;AAAA,EACF;AAEA,SAAO,OAAO,QAAQ,EAAE;AAC1B;AAeO,IAAM,oBAAoB,CAAC,aAA6B;AAC7D,MAAI,YAAY,EAAG,QAAO;AAG1B,QAAM,YAAY,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,QAAQ,CAAC,CAAC;AAG/D,QAAM,aAAa,WAAW;AAG9B,MAAI;AACJ,MAAI,cAAc,EAAG,kBAAiB;AAAA,WAC7B,cAAc,EAAG,kBAAiB;AAAA,WAClC,cAAc,IAAK,kBAAiB;AAAA,WACpC,cAAc,EAAG,kBAAiB;AAAA,MACtC,kBAAiB;AAEtB,SAAO,iBAAiB;AAC1B;AAEA,IAAM,mBAAmB,CAAC,OAAe,YAAY,OAAe;AAClE,QAAM,SAAS,MAAM;AACrB,SAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC;AAUO,IAAM,qBAAqB,CAAC,KAAa,kBAAkB,OAAiB;AACjF,MAAI,OAAO,EAAG,QAAO,CAAC,CAAC;AAGvB,QAAM,eAAe,MAAM;AAC3B,QAAM,gBAAgB,kBAAkB,YAAY;AAGpD,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,GAAG,SAAS,MAAM,gBAAgB,KAAK,SAAS,eAAe;AAE9E,UAAM,KAAK,iBAAiB,KAAK,CAAC;AAAA,EACpC;AAGA,QAAM,WAAW,MAAM,MAAM,SAAS,CAAC;AACvC,MAAI,WAAW,KAAK;AAClB,UAAM,KAAK,iBAAiB,WAAW,aAAa,CAAC;AAAA,EACvD;AAEA,SAAO;AACT;;;ACzGO,IAAM,WAAW,CAAC,GAAW,GAAW,MAAsB;AACnE,MAAI,IAAI,OAAO,IAAI,OAAO,IAAI,KAAK;AACjC,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAEA,UAAS,KAAK,KAAO,KAAK,IAAK,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAChE;AAEO,IAAM,WAAW,CAAC,QAA0B;AACjD,QAAM,WAAW,IAAI,QAAQ,KAAK,EAAE;AAEpC,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAC/C,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAC/C,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAE/C,SAAO,EAAE,GAAG,GAAG,EAAE;AACnB;AAEO,IAAM,YAAY,CAAC,UAA6B;AACrD,SAAO,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACjD;AAEO,IAAM,qBAAqB,CAAC,YAA4B;AAC7D,MAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,SAAO,KAAK,MAAM,UAAU,GAAG,EAC5B,SAAS,EAAE,EACX,SAAS,GAAG,GAAG;AACpB;AAEO,IAAM,qBAAqB,CAAC,UAA6B;AAC9D,SAAO,UAAU,KAAK,IAAI,mBAAmB,MAAM,CAAC;AACtD;AAEO,IAAM,cAAc,CAAC,UAA4B;AACtD,SAAO,OAAO,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC;AAC/C;AAEO,IAAM,eAAe,CAAC,UAA6B;AACxD,SAAO,QAAQ,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC;AAC5D;AAEO,IAAM,eAAe,CAAC,GAAW,GAAW,MAAsB;AACvE,UAAQ,QAAQ,IAAI,QAAQ,IAAI,QAAQ,KAAK;AAC/C;AAEO,IAAM,uBAAuB,CAAC,aAA6B;AAChE,QAAM,EAAE,GAAG,GAAG,EAAE,IAAI,SAAS,QAAQ;AACrC,SAAO,aAAa,GAAG,GAAG,CAAC,IAAI,MAAM,YAAY;AACnD;AAiBO,IAAM,qBAAqB,CAAC,QAA+B;AAChE,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,IAC7B,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,IAC7B,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,EAC/B,IACA,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE;AACzB;AAQO,IAAM,eAAe,CAAC,QAAyB;AACpD,QAAM,MAAM,mBAAmB,GAAG;AAElC,QAAM,YAAY,QAAQ,IAAI,IAAI,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC9D,SAAO,YAAY;AACrB;AAEA,IAAM,iBAAiB;AAAA,EACrB,EAAE,KAAK,GAAK,OAAO,EAAE,GAAG,KAAM,GAAG,GAAM,GAAG,EAAE,EAAE;AAAA,EAC9C,EAAE,KAAK,KAAK,OAAO,EAAE,GAAG,KAAM,GAAG,KAAM,GAAG,EAAE,EAAE;AAAA,EAC9C,EAAE,KAAK,GAAK,OAAO,EAAE,GAAG,GAAM,GAAG,KAAM,GAAG,EAAE,EAAE;AAChD;AAGO,IAAM,wBAAwB,CAAC,YAA4B;AAChE,MAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAM,IAAI,MAAM,uCAAuC,OAAO,EAAE;AAAA,EAClE;AAEA,MAAI,IAAI;AACR,OAAK,IAAI,GAAG,IAAI,eAAe,SAAS,GAAG,KAAK;AAC9C,QAAI,UAAU,eAAe,CAAC,EAAE,KAAK;AACnC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,QAAQ,eAAe,IAAI,CAAC;AAClC,QAAM,QAAQ,eAAe,CAAC;AAC9B,QAAM,QAAQ,MAAM,MAAM,MAAM;AAChC,QAAM,YAAY,UAAU,MAAM,OAAO;AACzC,QAAM,WAAW,IAAI;AACrB,QAAM,WAAW;AACjB,QAAM,QAAQ;AAAA,IACZ,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,IACjE,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,IACjE,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,EACnE;AAEA,SAAO,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI;AAC1D;;;ACtIA,SAAS,cAAc;AAKhB,IAAM,gBAAgB,CAAC,UAAsB;AAClD,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,UAAU;AACjC;AAEO,IAAM,kBAAkB,CAAC,UAAsB;AACpD,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,YAAY;AACnC;AAEO,IAAM,yBAAyB,CAAC,UAAsB;AAC3D,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,qBAAqB;AAC5C;AAEO,IAAM,YAAY,MAAM,cAAc,oBAAI,KAAK,CAAC;AAChD,IAAM,YAAY,MAAM,gBAAgB,oBAAI,KAAK,CAAC;AAClD,IAAM,gBAAgB,MAAM,uBAAuB,oBAAI,KAAK,CAAC;AAE7D,IAAM,2BAA2B,MAAM;AAC5C,SAAO,OAAO,oBAAI,KAAK,GAAG,qBAAqB;AACjD;AAEA,IAAM,sBAAsB;AAQrB,IAAM,sBAAsB,CACjC,WACA,aAAqB,wBACV;AACX,MAAI,CAAC,UAAW,QAAO;AACvB,MAAI;AACF,WAAO,OAAO,IAAI,KAAK,YAAY,GAAI,GAAG,UAAU;AAAA,EACtD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,IAAM,0BAA0B,MAAc;AACnD,SAAO,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACrC;AAOO,IAAM,qBAAqB,CAAC,cAA+B;AAChE,QAAM,MAAM,wBAAwB;AACpC,SAAO,YAAY;AACrB;AAOO,IAAM,oBAAoB,CAAC,cAA+B;AAC/D,QAAM,MAAM,wBAAwB;AACpC,SAAO,aAAa;AACtB;;;AC1EO,IAAM,kBAAkB,CAAC,UAA2B;AACzD,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,YAAY,aAAa,OAAO;AACnD,WAAQ,MAA8B;AAAA,EACxC;AAEA,SAAO,KAAK,UAAU,KAAK;AAC7B;;;ACZO,IAAM,sBAAsB,CAAC,WAAoC;AACtE,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU,OAAO,SAAS;AACnC;AAEO,IAAM,0BAA0B,CAAC,WAAoC;AAC1E,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU,OAAO,SAAS;AACnC;AAEO,IAAM,0BAA0B,CAAC,WAAoC;AAC1E,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU;AACnB;;;ACrBO,IAAM,UAAU,CAAC,OAAuB,WAAW,MAAc;AACtE,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,MAAI,WAAW,EAAG,OAAM,IAAI,MAAM,iCAAiC;AACnE,MAAI,aAAa,EAAG,QAAO,KAAK,MAAM,KAAK;AAE3C,QAAM,aAAa,KAAK,IAAI,IAAI,QAAQ;AACxC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;AAEO,IAAM,qBAAqB,CAAC,UAAkC;AACnE,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,KAAK,KAAK,QAAQ,EAAE,IAAI;AACjC;AAEO,IAAM,8BAA8B,CAAC,MAA8B;AACxE,MAAI,UAAU,CAAC,EAAG,QAAO;AACzB,MAAI,CAAC,SAAS,CAAC,EAAG,QAAO;AAEzB,QAAM,WAAW,KAAK,IAAI,CAAC;AAC3B,MAAI,aAAa,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,KAAK,MAAM,QAAQ;AACvC,SAAO,KAAK,MAAM,KAAK,MAAM,WAAW,CAAC;AAC3C;;;AC5BO,IAAM,qBAAqB;AAE3B,IAAM,aAAa;;;ACCnB,IAAM,UAAU,CAAC,QAAsD;AAC5E,SAAO,UAAU,GAAG,KAAK,KAAK,KAAK,MAAM;AAC3C;AAEO,IAAM,aAAa,CAAC,QAAuC;AAChE,SAAO,CAAC,QAAQ,GAAG;AACrB;AAEO,IAAM,iBAAiB,CAAC,UAA2B;AACxD,SAAO,mBAAmB,KAAK,KAAK;AACtC;AAcO,IAAM,yBAAyB,CAAC,UAA0B;AAC/D,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,UAAU,KAAK,EAAE,QAAQ,oBAAoB,EAAE;AAC9D;AAOO,IAAM,kBAAkB,CAAC,QAAwB;AACtD,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AAClD;AAQO,IAAM,aAAa,CAAC,SAAyB;AAClD,MAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,WAAW,EAAG,QAAO;AAC9C,SAAO,KAAK,MAAM,KAAK,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE;AAC7D;AASO,IAAM,WAAW,CAAC,KAAa,WAAmB,WAAW,UAAkB;AACpF,MAAI,CAAC,OAAO,IAAI,UAAU,UAAW,QAAO;AAC5C,SAAO,IAAI,MAAM,GAAG,YAAY,SAAS,MAAM,IAAI;AACrD;;;AClEO,IAAM,QAAQ,CAAC,iBACpB,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,YAAY,CAAC;;;ACD5D,IAAM,mBAAmB;AACzB,IAAM,mBAAmB,KAAK;AAC9B,IAAM,iBAAiB,KAAK;AAC5B,IAAM,gBAAgB,KAAK;AAEpB,IAAM,cAAc;AAAA,EACzB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AACV;;;ACPO,IAAM,cAAc;AAGpB,IAAM,WAAW;AAGjB,IAAM,UAAU;AAGhB,IAAM,cAAc;AAGpB,IAAM,YAAY;AAElB,IAAM,gBAAgB,CAAC,UAAkC;AAC9D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,aAAa,CAAC,UAAkC;AAC3D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,YAAY,CAAC,UAAkC;AAC1D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,gBAAgB,CAAC,UAAkC;AAC9D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,cAAc,CAAC,UAAkC;AAC5D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;;;AC7CO,IAAM,kBAAkB;AAAA,EAC7B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AACP;AAEA,IAAM,wBAAwB,OAAO,OAAO,eAAe;AAEpD,IAAM,YAAY,CAAC,QAAiC;AACzD,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,IAAI,YAAY;AACjC,SAAO,sBAAsB,KAAK,CAAC,WAAW,SAAS,WAAW,GAAG,MAAM,KAAK,CAAC;AACnF;AAUO,IAAM,2BAA2B,CAAC,YAA4B;AACnE,SAAO,QAAQ,MAAM,GAAG,EAAE,CAAC,KAAK;AAClC;;;AC9BA,IAAM,2BAAqC,CAAC,UAAU,YAAY,UAAU,IAAI;AAEzE,IAAM,eAAe,CAAC,OAA2C;AACtE,MAAI,UAAU,EAAE,EAAG,QAAO;AAC1B,SAAO,yBAAyB,SAAS,GAAG,UAAU;AACxD;AAEO,IAAM,uBAAuB,CAAC,OAA2C;AAC9E,MAAI,UAAU,EAAE,EAAG,QAAO;AAC1B,SAAO,yBAAyB,SAAS,GAAG,UAAU;AACxD;AAEO,IAAM,iBAAiB,CAAC,OAA0B;AACvD,MAAI,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,EAAG;AAExC,MAAI;AACF,OAAG,MAAM;AAAA,EACX,QAAQ;AAAA,EAER;AACF;","names":[]}
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/chart.utils.ts","../src/utils/color.utils.ts","../src/utils/date.utils.ts","../src/utils/errors.utils.ts","../src/utils/http.utils.ts","../src/utils/regex.ts","../src/utils/string.utils.ts","../src/utils/number.utils.ts","../src/utils/thread.utils.ts","../src/utils/time.utils.ts","../src/utils/units.utils.ts","../src/utils/uri.utils.ts","../src/utils/websocket.utils.ts"],"sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\nexport interface ToleranceArea {\n  flow: number;\n  toleranceRange: [number, number];\n}\n\n/**\n * A chart point with required x and y coordinates.\n */\nexport interface ChartPoint {\n  x: number;\n  y: number;\n}\n\n/**\n * A chart point with optional nullable x and y coordinates.\n */\nexport interface NullableChartPoint {\n  x?: number | null;\n  y?: number | null;\n}\n\nexport const getTickDomain = (ticks: number[]): [number, number] => [0, ticks.at(-1) ?? 0];\n\nexport const tickFormatter = (value: number): string => value.toFixed(0);\n\nexport const toToleranceLabel = (value: number): string => `±${(value * 100).toFixed(0)}%`;\n\nexport const tooltipValueFormatter = (data?: unknown | null): string => {\n  if (isNullish(data)) {\n    return '';\n  }\n\n  if (typeof data === 'number') {\n    return data.toFixed(2);\n  }\n\n  if (Array.isArray(data) && data.length >= 2) {\n    const [min, max] = data;\n    if (typeof min === 'number' && typeof max === 'number') {\n      return `[${min.toFixed(2)} … ${max.toFixed(2)}]`;\n    }\n  }\n\n  return String(data ?? '');\n};\n\n/**\n * Rounds a raw value to a \"nice\" number for chart axis increments.\n * Nice numbers are easy to read: 1, 2, 2.5, 5, or 10 multiplied by a power of 10.\n *\n * @param rawValue - The raw value to round to a nice number\n * @returns A nice number close to the raw value\n *\n * @example\n * roundToNiceNumber(0.7)  // returns 1\n * roundToNiceNumber(3)    // returns 5\n * roundToNiceNumber(17)   // returns 20\n * roundToNiceNumber(80)   // returns 100\n */\nexport const roundToNiceNumber = (rawValue: number): number => {\n  if (rawValue <= 0) return 0;\n\n  // Get order of magnitude\n  const magnitude = Math.pow(10, Math.floor(Math.log10(rawValue)));\n\n  // Normalize to find the multiplier (between 1 and 10)\n  const normalized = rawValue / magnitude;\n\n  // Round to nice values: 1, 2, 2.5, 5, 10\n  let niceMultiplier: number;\n  if (normalized <= 1) niceMultiplier = 1;\n  else if (normalized <= 2) niceMultiplier = 2;\n  else if (normalized <= 2.5) niceMultiplier = 2.5;\n  else if (normalized <= 5) niceMultiplier = 5;\n  else niceMultiplier = 10;\n\n  return niceMultiplier * magnitude;\n};\n\nconst roundToPrecision = (value: number, precision = 10): number => {\n  const factor = 10 ** precision;\n  return Math.round(value * factor) / factor;\n};\n\n/**\n * Builds an array of \"nice\" tick values for a chart axis.\n * The algorithm aims for approximately `targetTickCount` ticks with clean, readable values.\n *\n * @param max - The maximum value to display on the axis\n * @param targetTickCount - The desired number of ticks (default: 10)\n * @returns An array of tick values from 0 to at least `max`\n */\nexport const buildTicksForChart = (max: number, targetTickCount = 10): number[] => {\n  if (max <= 0) return [0];\n\n  // Calculate raw increment for desired tick count and round to nice value\n  const rawIncrement = max / targetTickCount;\n  const niceIncrement = roundToNiceNumber(rawIncrement);\n\n  // Build ticks from 0 to just past max\n  const ticks: number[] = [];\n  for (let value = 0; value <= max + niceIncrement * 0.5; value += niceIncrement) {\n    // Round to avoid floating point precision issues\n    ticks.push(roundToPrecision(value));\n  }\n\n  // Ensure we have at least one tick >= max\n  const lastTick = ticks[ticks.length - 1];\n  if (lastTick < max) {\n    ticks.push(roundToPrecision(lastTick + niceIncrement));\n  }\n\n  return ticks;\n};\n","export interface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface RgbaColor extends RgbColor {\n  a: number;\n}\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  if (r > 255 || g > 255 || b > 255) {\n    throw new Error(\"Invalid color component\");\n  }\n\n  return ((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\");\n};\n\nexport const hexToRgb = (hex: string): RgbColor => {\n  const cleanHex = hex.replace(\"#\", \"\");\n\n  const r = parseInt(cleanHex.substring(0, 2), 16);\n  const g = parseInt(cleanHex.substring(2, 4), 16);\n  const b = parseInt(cleanHex.substring(4, 6), 16);\n\n  return { r, g, b };\n};\n\nexport const rgbaToHex = (color: RgbaColor): string => {\n  return \"#\" + rgbToHex(color.r, color.g, color.b);\n};\n\nexport const getOpacityHexValue = (opacity: number): string => {\n  if (opacity < 0 || opacity > 1) {\n    throw new Error(\"Invalid opacity value\");\n  }\n\n  return Math.round(opacity * 255)\n    .toString(16)\n    .padStart(2, \"0\");\n};\n\nexport const rgbaToHexWithAlpha = (color: RgbaColor): string => {\n  return rgbaToHex(color) + getOpacityHexValue(color.a);\n};\n\nexport const rgbToString = (color: RgbColor): string => {\n  return `rgb(${color.r}, ${color.g}, ${color.b})`;\n};\n\nexport const rgbaToString = (color: RgbaColor): string => {\n  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;\n};\n\nexport const getLuminance = (r: number, g: number, b: number): number => {\n  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n};\n\nexport const getContrastTextColor = (hexColor: string): string => {\n  const { r, g, b } = hexToRgb(hexColor);\n  return getLuminance(r, g, b) > 0.5 ? \"#000000\" : \"#ffffff\";\n};\n\n/**\n * Normalized RGB color with values between 0 and 1.\n * Useful for graphics libraries like Three.js.\n */\nexport interface NormalizedRgb {\n  r: number;\n  g: number;\n  b: number;\n}\n\n/**\n * Convert a hex color string to normalized RGB values (0-1 range).\n * @param hex - Hex color string (with or without # prefix)\n * @returns Normalized RGB object with values between 0 and 1\n */\nexport const hexToNormalizedRgb = (hex: string): NormalizedRgb => {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16) / 255,\n        g: parseInt(result[2], 16) / 255,\n        b: parseInt(result[3], 16) / 255,\n      }\n    : { r: 0, g: 0, b: 0 };\n};\n\n/**\n * Determine if a color is light or dark based on relative luminance.\n * Useful for choosing contrasting text colors.\n * @param hex - Hex color string\n * @returns True if the color is considered light (luminance > 0.5)\n */\nexport const isLightColor = (hex: string): boolean => {\n  const rgb = hexToNormalizedRgb(hex);\n  // Calculate relative luminance using standard coefficients\n  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;\n  return luminance > 0.5;\n};\n\nconst PERCENT_COLORS = [\n  { pct: 0.0, color: { r: 0xff, g: 0x00, b: 0 } },\n  { pct: 0.5, color: { r: 0xff, g: 0xff, b: 0 } },\n  { pct: 1.0, color: { r: 0x00, g: 0xff, b: 0 } },\n] as const;\n\n// https://stackoverflow.com/a/7128796/704681\nexport const getColorForPercentage = (percent: number): string => {\n  if (percent < 0 || percent > 1) {\n    throw new Error(`Percentage must be between 0 and 1: ${percent}`);\n  }\n\n  let i = 0;\n  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {\n    if (percent < PERCENT_COLORS[i].pct) {\n      break;\n    }\n  }\n\n  const lower = PERCENT_COLORS[i - 1];\n  const upper = PERCENT_COLORS[i];\n  const range = upper.pct - lower.pct;\n  const rangePct = (percent - lower.pct) / range;\n  const pctLower = 1 - rangePct;\n  const pctUpper = rangePct;\n  const color = {\n    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),\n    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),\n    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper),\n  };\n\n  return \"rgb(\" + [color.r, color.g, color.b].join(\",\") + \")\";\n};\n","import { format } from \"date-fns\";\nimport { isNullish } from \"./types.utils\";\n\nexport type DateInput = Date | string | number | null;\n\nexport const dateAs_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"HH:mm:ss\");\n};\n\nexport const dateAs_YYYYMMDD = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd\");\n};\n\nexport const dateAs_YYYYMMDD_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd HH:mm:ss\");\n};\n\nexport const nowAsTime = () => dateAs_HHMMSS(new Date());\nexport const nowAsDate = () => dateAs_YYYYMMDD(new Date());\nexport const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());\n\nexport const nowAsDateTimeForFilename = () => {\n  return format(new Date(), \"yyyy-MM-dd_HH-mm-ss\");\n};\n\nconst DEFAULT_DATE_FORMAT = \"yyyy-MM-dd HH:mm:ss\";\n\n/**\n * Format a Unix timestamp (seconds since epoch) to a human-readable string.\n * @param timestamp - Unix timestamp in seconds\n * @param dateFormat - Date format string (default: \"yyyy-MM-dd HH:mm:ss\")\n * @returns Formatted date string or \"N/A\" if invalid or zero.\n */\nexport const formatUnixTimestamp = (\n  timestamp: number,\n  dateFormat: string = DEFAULT_DATE_FORMAT\n): string => {\n  if (!timestamp) return \"N/A\";\n  try {\n    return format(new Date(timestamp * 1000), dateFormat);\n  } catch {\n    return \"Invalid date\";\n  }\n};\n\n/**\n * Get the current Unix timestamp in seconds.\n * @returns Current Unix timestamp\n */\nexport const getCurrentUnixTimestamp = (): number => {\n  return Math.floor(Date.now() / 1000);\n};\n\n/**\n * Check if a Unix timestamp has expired (is in the past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is in the past\n */\nexport const isExpiredTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp < now;\n};\n\n/**\n * Check if a Unix timestamp is active (current or past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is current or in the past\n */\nexport const isActiveTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp <= now;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { isNullish } from './types.utils';\n\nexport const isHttpSuccessStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 200 && status < 300;\n};\n\nexport const isHttpClientErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 400 && status < 500;\n};\n\nexport const isHttpServerErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 500;\n};\n","export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;\n\nexport const REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n","import { isBlank } from './string.utils';\nimport { isNullish, isNumber } from \"./types.utils\";\n\n/**\n * Returns true if the input string is a valid number (blank and non-numeric strings are invalid).\n */\nexport const isInputValidNumber = (value: string): boolean => {\n  if (isBlank(value)) return false;\n  const num = Number(value.trim());\n  return Number.isFinite(num);\n};\n\n/**\n * Returns true if the input string is a valid integer (decimals like \"1500.5\" are invalid).\n */\nexport const isInputValidInteger = (value: string): boolean => {\n  if (!isInputValidNumber(value)) return false;\n  const num = Number(value.trim());\n  return Number.isInteger(num);\n};\n\n/**\n * Formats a number as an integer display string (removes decimals).\n */\nexport const formatIntegerDisplay = (value?: number | null): string =>\n  String(toFixed(value, 0));\n\n// Example: toFixed(3.14159, 3) // 3.142\nexport const toFixed = (value?: number | null, decimals = 0): number => {\n  if (isNullish(value)) return 0;\n  if (decimals < 0) throw new Error(\"[toFixed] decimals must be >= 0\");\n  if (decimals === 0) return Math.round(value);\n\n  const multiplier = Math.pow(10, decimals);\n  return Math.round(value * multiplier) / multiplier;\n};\n\nexport const roundUpToNearest10 = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n  return Math.ceil(value / 10) * 10;\n};\n\nexport const getOrderOfMagnitudeExponent = (n?: number | null): number => {\n  if (isNullish(n)) return 0;\n  if (!isNumber(n)) return 0;\n\n  const absValue = Math.abs(n);  \n  if (absValue === 0) {\n    return 0;\n  }\n  \n  const integerPart = Math.floor(absValue);\n  return Math.floor(Math.log10(integerPart));\n}\n","export const sleep = (milliseconds: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, milliseconds));\n\n/**\n * Yields to the main thread so the UI can process events and repaint.\n * Use during long-running synchronous work (e.g. report generation) to keep the app responsive.\n */\nexport const yieldToMainThread = (): Promise<void> => sleep(0);\n","const ONE_SECOND_IN_MS = 1000;\nconst ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;\nconst ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;\nconst ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;\n\nexport const PeriodsInMS = {\n  oneSecond: ONE_SECOND_IN_MS,\n  oneMinute: ONE_MINUTE_IN_MS,\n  oneHour: ONE_HOUR_IN_MS,\n  oneDay: ONE_DAY_IN_MS,\n} as const;\n","import { isNullish } from \"./types.utils\";\n\n/** m³/s to gallons per minute */\nexport const M3PS_TO_GPM = 15850.3;\n\n/** Pascals to feet of head (1 Pa = 1 N/m²) */\nexport const PA_TO_FT = 0.000334553;\n\n/** Watts to Horsepower */\nexport const W_TO_HP = 0.00134102;\n\n/** meters to inches */\nexport const M_TO_INCHES = 39.3701;\n\n/** Hz to RPM (for synchronous speed) */\nexport const HZ_TO_RPM = 60;\n\nexport const fromM3psToGPM = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M3PS_TO_GPM;\n};\n\nexport const fromPaToFt = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * PA_TO_FT;\n};\n\nexport const fromWToHp = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * W_TO_HP;\n};\n\nexport const fromMToInches = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M_TO_INCHES;\n};\n\nexport const fromHzToRpm = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * HZ_TO_RPM;\n};\n","export const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","import { isNullish } from \"./types.utils\";\n\nconst WEBSOCKET_CONNECT_STATES: number[] = [WebSocket.CONNECTING, WebSocket.OPEN] as const;\n\nexport const isWsClosable = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const isWsOpenOrConnecting = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const closeWebSocket = (ws?: WebSocket | null) => {\n  if (isNullish(ws) || !isWsClosable(ws)) return;\n\n  try {\n    ws.close();\n  } catch {\n    // do nothing (best effort to close, ignore unexpected errors)\n  }\n};\n"],"mappings":";AAAO,IAAM,QAAoB,MAAM;AAAC;AAEjC,IAAM,YAAY,CAAC,UAA8C,UAAU,QAAQ,UAAU;AAE7F,IAAM,WAAW,CAAC,UAA4C;AACnE,MAAI,UAAU,KAAK,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,KAAK,GAAG;AAChB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEO,IAAM,WAAW,CAAC,UAA4C;AACnE,MAAI,UAAU,KAAK,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO;AACT;;;ACPO,IAAM,gBAAgB,CAAC,UAAsC,CAAC,GAAG,MAAM,GAAG,EAAE,KAAK,CAAC;AAElF,IAAM,gBAAgB,CAAC,UAA0B,MAAM,QAAQ,CAAC;AAEhE,IAAM,mBAAmB,CAAC,UAA0B,QAAK,QAAQ,KAAK,QAAQ,CAAC,CAAC;AAEhF,IAAM,wBAAwB,CAAC,SAAkC;AACtE,MAAI,UAAU,IAAI,GAAG;AACnB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,KAAK,QAAQ,CAAC;AAAA,EACvB;AAEA,MAAI,MAAM,QAAQ,IAAI,KAAK,KAAK,UAAU,GAAG;AAC3C,UAAM,CAAC,KAAK,GAAG,IAAI;AACnB,QAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,UAAU;AACtD,aAAO,IAAI,IAAI,QAAQ,CAAC,CAAC,WAAM,IAAI,QAAQ,CAAC,CAAC;AAAA,IAC/C;AAAA,EACF;AAEA,SAAO,OAAO,QAAQ,EAAE;AAC1B;AAeO,IAAM,oBAAoB,CAAC,aAA6B;AAC7D,MAAI,YAAY,EAAG,QAAO;AAG1B,QAAM,YAAY,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,MAAM,QAAQ,CAAC,CAAC;AAG/D,QAAM,aAAa,WAAW;AAG9B,MAAI;AACJ,MAAI,cAAc,EAAG,kBAAiB;AAAA,WAC7B,cAAc,EAAG,kBAAiB;AAAA,WAClC,cAAc,IAAK,kBAAiB;AAAA,WACpC,cAAc,EAAG,kBAAiB;AAAA,MACtC,kBAAiB;AAEtB,SAAO,iBAAiB;AAC1B;AAEA,IAAM,mBAAmB,CAAC,OAAe,YAAY,OAAe;AAClE,QAAM,SAAS,MAAM;AACrB,SAAO,KAAK,MAAM,QAAQ,MAAM,IAAI;AACtC;AAUO,IAAM,qBAAqB,CAAC,KAAa,kBAAkB,OAAiB;AACjF,MAAI,OAAO,EAAG,QAAO,CAAC,CAAC;AAGvB,QAAM,eAAe,MAAM;AAC3B,QAAM,gBAAgB,kBAAkB,YAAY;AAGpD,QAAM,QAAkB,CAAC;AACzB,WAAS,QAAQ,GAAG,SAAS,MAAM,gBAAgB,KAAK,SAAS,eAAe;AAE9E,UAAM,KAAK,iBAAiB,KAAK,CAAC;AAAA,EACpC;AAGA,QAAM,WAAW,MAAM,MAAM,SAAS,CAAC;AACvC,MAAI,WAAW,KAAK;AAClB,UAAM,KAAK,iBAAiB,WAAW,aAAa,CAAC;AAAA,EACvD;AAEA,SAAO;AACT;;;ACzGO,IAAM,WAAW,CAAC,GAAW,GAAW,MAAsB;AACnE,MAAI,IAAI,OAAO,IAAI,OAAO,IAAI,KAAK;AACjC,UAAM,IAAI,MAAM,yBAAyB;AAAA,EAC3C;AAEA,UAAS,KAAK,KAAO,KAAK,IAAK,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAChE;AAEO,IAAM,WAAW,CAAC,QAA0B;AACjD,QAAM,WAAW,IAAI,QAAQ,KAAK,EAAE;AAEpC,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAC/C,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAC/C,QAAM,IAAI,SAAS,SAAS,UAAU,GAAG,CAAC,GAAG,EAAE;AAE/C,SAAO,EAAE,GAAG,GAAG,EAAE;AACnB;AAEO,IAAM,YAAY,CAAC,UAA6B;AACrD,SAAO,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACjD;AAEO,IAAM,qBAAqB,CAAC,YAA4B;AAC7D,MAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAM,IAAI,MAAM,uBAAuB;AAAA,EACzC;AAEA,SAAO,KAAK,MAAM,UAAU,GAAG,EAC5B,SAAS,EAAE,EACX,SAAS,GAAG,GAAG;AACpB;AAEO,IAAM,qBAAqB,CAAC,UAA6B;AAC9D,SAAO,UAAU,KAAK,IAAI,mBAAmB,MAAM,CAAC;AACtD;AAEO,IAAM,cAAc,CAAC,UAA4B;AACtD,SAAO,OAAO,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC;AAC/C;AAEO,IAAM,eAAe,CAAC,UAA6B;AACxD,SAAO,QAAQ,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,CAAC;AAC5D;AAEO,IAAM,eAAe,CAAC,GAAW,GAAW,MAAsB;AACvE,UAAQ,QAAQ,IAAI,QAAQ,IAAI,QAAQ,KAAK;AAC/C;AAEO,IAAM,uBAAuB,CAAC,aAA6B;AAChE,QAAM,EAAE,GAAG,GAAG,EAAE,IAAI,SAAS,QAAQ;AACrC,SAAO,aAAa,GAAG,GAAG,CAAC,IAAI,MAAM,YAAY;AACnD;AAiBO,IAAM,qBAAqB,CAAC,QAA+B;AAChE,QAAM,SAAS,4CAA4C,KAAK,GAAG;AACnE,SAAO,SACH;AAAA,IACE,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,IAC7B,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,IAC7B,GAAG,SAAS,OAAO,CAAC,GAAG,EAAE,IAAI;AAAA,EAC/B,IACA,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE;AACzB;AAQO,IAAM,eAAe,CAAC,QAAyB;AACpD,QAAM,MAAM,mBAAmB,GAAG;AAElC,QAAM,YAAY,QAAQ,IAAI,IAAI,QAAQ,IAAI,IAAI,QAAQ,IAAI;AAC9D,SAAO,YAAY;AACrB;AAEA,IAAM,iBAAiB;AAAA,EACrB,EAAE,KAAK,GAAK,OAAO,EAAE,GAAG,KAAM,GAAG,GAAM,GAAG,EAAE,EAAE;AAAA,EAC9C,EAAE,KAAK,KAAK,OAAO,EAAE,GAAG,KAAM,GAAG,KAAM,GAAG,EAAE,EAAE;AAAA,EAC9C,EAAE,KAAK,GAAK,OAAO,EAAE,GAAG,GAAM,GAAG,KAAM,GAAG,EAAE,EAAE;AAChD;AAGO,IAAM,wBAAwB,CAAC,YAA4B;AAChE,MAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAM,IAAI,MAAM,uCAAuC,OAAO,EAAE;AAAA,EAClE;AAEA,MAAI,IAAI;AACR,OAAK,IAAI,GAAG,IAAI,eAAe,SAAS,GAAG,KAAK;AAC9C,QAAI,UAAU,eAAe,CAAC,EAAE,KAAK;AACnC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,QAAQ,eAAe,IAAI,CAAC;AAClC,QAAM,QAAQ,eAAe,CAAC;AAC9B,QAAM,QAAQ,MAAM,MAAM,MAAM;AAChC,QAAM,YAAY,UAAU,MAAM,OAAO;AACzC,QAAM,WAAW,IAAI;AACrB,QAAM,WAAW;AACjB,QAAM,QAAQ;AAAA,IACZ,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,IACjE,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,IACjE,GAAG,KAAK,MAAM,MAAM,MAAM,IAAI,WAAW,MAAM,MAAM,IAAI,QAAQ;AAAA,EACnE;AAEA,SAAO,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI;AAC1D;;;ACtIA,SAAS,cAAc;AAKhB,IAAM,gBAAgB,CAAC,UAAsB;AAClD,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,UAAU;AACjC;AAEO,IAAM,kBAAkB,CAAC,UAAsB;AACpD,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,YAAY;AACnC;AAEO,IAAM,yBAAyB,CAAC,UAAsB;AAC3D,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,OAAO,OAAO,qBAAqB;AAC5C;AAEO,IAAM,YAAY,MAAM,cAAc,oBAAI,KAAK,CAAC;AAChD,IAAM,YAAY,MAAM,gBAAgB,oBAAI,KAAK,CAAC;AAClD,IAAM,gBAAgB,MAAM,uBAAuB,oBAAI,KAAK,CAAC;AAE7D,IAAM,2BAA2B,MAAM;AAC5C,SAAO,OAAO,oBAAI,KAAK,GAAG,qBAAqB;AACjD;AAEA,IAAM,sBAAsB;AAQrB,IAAM,sBAAsB,CACjC,WACA,aAAqB,wBACV;AACX,MAAI,CAAC,UAAW,QAAO;AACvB,MAAI;AACF,WAAO,OAAO,IAAI,KAAK,YAAY,GAAI,GAAG,UAAU;AAAA,EACtD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMO,IAAM,0BAA0B,MAAc;AACnD,SAAO,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACrC;AAOO,IAAM,qBAAqB,CAAC,cAA+B;AAChE,QAAM,MAAM,wBAAwB;AACpC,SAAO,YAAY;AACrB;AAOO,IAAM,oBAAoB,CAAC,cAA+B;AAC/D,QAAM,MAAM,wBAAwB;AACpC,SAAO,aAAa;AACtB;;;AC1EO,IAAM,kBAAkB,CAAC,UAA2B;AACzD,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,YAAY,aAAa,OAAO;AACnD,WAAQ,MAA8B;AAAA,EACxC;AAEA,SAAO,KAAK,UAAU,KAAK;AAC7B;;;ACZO,IAAM,sBAAsB,CAAC,WAAoC;AACtE,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU,OAAO,SAAS;AACnC;AAEO,IAAM,0BAA0B,CAAC,WAAoC;AAC1E,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU,OAAO,SAAS;AACnC;AAEO,IAAM,0BAA0B,CAAC,WAAoC;AAC1E,MAAI,UAAU,MAAM,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,UAAU;AACnB;;;ACxBO,IAAM,qBAAqB;AAE3B,IAAM,aAAa;;;ACCnB,IAAM,UAAU,CAAC,QAAsD;AAC5E,SAAO,UAAU,GAAG,KAAK,KAAK,KAAK,MAAM;AAC3C;AAEO,IAAM,aAAa,CAAC,QAAuC;AAChE,SAAO,CAAC,QAAQ,GAAG;AACrB;AAEO,IAAM,iBAAiB,CAAC,UAA2B;AACxD,SAAO,mBAAmB,KAAK,KAAK;AACtC;AAcO,IAAM,yBAAyB,CAAC,UAA0B;AAC/D,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,UAAU,KAAK,EAAE,QAAQ,oBAAoB,EAAE;AAC9D;AAOO,IAAM,kBAAkB,CAAC,QAAwB;AACtD,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,OAAO,CAAC,EAAE,YAAY,IAAI,IAAI,MAAM,CAAC;AAClD;AAQO,IAAM,aAAa,CAAC,SAAyB;AAClD,MAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,WAAW,EAAG,QAAO;AAC9C,SAAO,KAAK,MAAM,KAAK,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE;AAC7D;AASO,IAAM,WAAW,CAAC,KAAa,WAAmB,WAAW,UAAkB;AACpF,MAAI,CAAC,OAAO,IAAI,UAAU,UAAW,QAAO;AAC5C,SAAO,IAAI,MAAM,GAAG,YAAY,SAAS,MAAM,IAAI;AACrD;;;AC5DO,IAAM,qBAAqB,CAAC,UAA2B;AAC5D,MAAI,QAAQ,KAAK,EAAG,QAAO;AAC3B,QAAM,MAAM,OAAO,MAAM,KAAK,CAAC;AAC/B,SAAO,OAAO,SAAS,GAAG;AAC5B;AAKO,IAAM,sBAAsB,CAAC,UAA2B;AAC7D,MAAI,CAAC,mBAAmB,KAAK,EAAG,QAAO;AACvC,QAAM,MAAM,OAAO,MAAM,KAAK,CAAC;AAC/B,SAAO,OAAO,UAAU,GAAG;AAC7B;AAKO,IAAM,uBAAuB,CAAC,UACnC,OAAO,QAAQ,OAAO,CAAC,CAAC;AAGnB,IAAM,UAAU,CAAC,OAAuB,WAAW,MAAc;AACtE,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,MAAI,WAAW,EAAG,OAAM,IAAI,MAAM,iCAAiC;AACnE,MAAI,aAAa,EAAG,QAAO,KAAK,MAAM,KAAK;AAE3C,QAAM,aAAa,KAAK,IAAI,IAAI,QAAQ;AACxC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;AAEO,IAAM,qBAAqB,CAAC,UAAkC;AACnE,MAAI,UAAU,KAAK,EAAG,QAAO;AAC7B,SAAO,KAAK,KAAK,QAAQ,EAAE,IAAI;AACjC;AAEO,IAAM,8BAA8B,CAAC,MAA8B;AACxE,MAAI,UAAU,CAAC,EAAG,QAAO;AACzB,MAAI,CAAC,SAAS,CAAC,EAAG,QAAO;AAEzB,QAAM,WAAW,KAAK,IAAI,CAAC;AAC3B,MAAI,aAAa,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,KAAK,MAAM,QAAQ;AACvC,SAAO,KAAK,MAAM,KAAK,MAAM,WAAW,CAAC;AAC3C;;;ACrDO,IAAM,QAAQ,CAAC,iBACpB,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,YAAY,CAAC;AAMrD,IAAM,oBAAoB,MAAqB,MAAM,CAAC;;;ACP7D,IAAM,mBAAmB;AACzB,IAAM,mBAAmB,KAAK;AAC9B,IAAM,iBAAiB,KAAK;AAC5B,IAAM,gBAAgB,KAAK;AAEpB,IAAM,cAAc;AAAA,EACzB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AACV;;;ACPO,IAAM,cAAc;AAGpB,IAAM,WAAW;AAGjB,IAAM,UAAU;AAGhB,IAAM,cAAc;AAGpB,IAAM,YAAY;AAElB,IAAM,gBAAgB,CAAC,UAAkC;AAC9D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,aAAa,CAAC,UAAkC;AAC3D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,YAAY,CAAC,UAAkC;AAC1D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,gBAAgB,CAAC,UAAkC;AAC9D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;AAEO,IAAM,cAAc,CAAC,UAAkC;AAC5D,MAAI,UAAU,KAAK,EAAG,QAAO;AAE7B,SAAO,QAAQ;AACjB;;;AC7CO,IAAM,kBAAkB;AAAA,EAC7B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM;AAAA,EACN,OAAO;AAAA,EACP,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AACP;AAEA,IAAM,wBAAwB,OAAO,OAAO,eAAe;AAEpD,IAAM,YAAY,CAAC,QAAiC;AACzD,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,IAAI,YAAY;AACjC,SAAO,sBAAsB,KAAK,CAAC,WAAW,SAAS,WAAW,GAAG,MAAM,KAAK,CAAC;AACnF;AAUO,IAAM,2BAA2B,CAAC,YAA4B;AACnE,SAAO,QAAQ,MAAM,GAAG,EAAE,CAAC,KAAK;AAClC;;;AC9BA,IAAM,2BAAqC,CAAC,UAAU,YAAY,UAAU,IAAI;AAEzE,IAAM,eAAe,CAAC,OAA2C;AACtE,MAAI,UAAU,EAAE,EAAG,QAAO;AAC1B,SAAO,yBAAyB,SAAS,GAAG,UAAU;AACxD;AAEO,IAAM,uBAAuB,CAAC,OAA2C;AAC9E,MAAI,UAAU,EAAE,EAAG,QAAO;AAC1B,SAAO,yBAAyB,SAAS,GAAG,UAAU;AACxD;AAEO,IAAM,iBAAiB,CAAC,OAA0B;AACvD,MAAI,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,EAAG;AAExC,MAAI;AACF,OAAG,MAAM;AAAA,EACX,QAAQ;AAAA,EAER;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lichens-innovation/ts-common",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Reusable generic typescript utilities, types, constants, helpers",
   "keywords": [
     "typescript",