Skip to content

A continuation of HomeBox the inventory and organization system built for the Home User

2.9 KB
Raw Blame
import type { Updater } from "@tanstack/vue-table";
import { type ClassValue, clsx } from "clsx";
import { twMerge } from "tailwind-merge";

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}

// eslint-disable-next-line @typescript-eslint/no-explicit-any
export function valueUpdater<T extends Updater<any>>(updaterOrValue: T, ref: Ref) {
  ref.value = typeof updaterOrValue === "function" ? updaterOrValue(ref.value) : updaterOrValue;
}

/**
 * Returns either '#000' or '#fff' depending on which has better contrast with the given background color.
 * Accepts hex (#RRGGBB or #RGB) or rgb(a) strings.
 */
export function getContrastTextColor(bgColor: string): string {
  let r = 0;
  let g = 0;
  let b = 0;
  if (bgColor.startsWith("#")) {
    let hex = bgColor.slice(1);
    if (hex.length === 3) {
      hex = hex
        .split("")
        .map(x => x + x)
        .join("");
    }
    r = parseInt(hex.slice(0, 2), 16);
    g = parseInt(hex.slice(2, 4), 16);
    b = parseInt(hex.slice(4, 6), 16);
  } else if (bgColor.startsWith("rgb")) {
    const match = bgColor.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/) as [string, string, string, string];
    if (match) {
      r = parseInt(match[1]);
      g = parseInt(match[2]);
      b = parseInt(match[3]);
    }
  }
  // Calculate luminance
  const luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
  return luminance > 0.5 ? "#000" : "#fff";
}

export const camelToSnakeCase = (str: string) => str.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);

export function getNameOrValue(value: unknown): string | unknown {
  const nameEvaluation: string | false =
    value !== null &&
    value !== undefined &&
    typeof value === "object" &&
    "name" in value &&
    typeof value.name === "string" &&
    value.name;

  return nameEvaluation ? nameEvaluation : value;
}

export function formatArrayAsString(value: unknown): string {
  let str = "";

  if (Array.isArray(value)) {
    value.map(item => {
      str = `${str}${str ? "," : ""}${formatArrayAsString(item)}`;
    });
  } else {
    str = String(getNameOrValue(value) ?? "");
  }

  return str;
}

export function formatValueAsCsvField(value: unknown): string {
  let str: string;

  if (Array.isArray(value)) {
    str = formatArrayAsString(value);
  } else {
    str = String(getNameOrValue(value) ?? "");
  }

  // Mitigate formula injection
  if (/^[\t\r\n ]*[=+\-@]/.test(str)) {
    str = "'" + str;
  }
  // Escape double quotes
  str = str.replace(/"/g, '""');

  // Wrap in double quotes
  return `"${str}"`;
}

const utf8Encoder = new TextEncoder();

/**
 * Byte length of a string when UTF-8 encoded. The backend validates string
 * fields by byte length (ent MaxLen), so character counters must use this
 * rather than String.length to match what the server will accept.
 */
export function utf8Length(str: string): number {
  return utf8Encoder.encode(str).length;
}