A continuation of HomeBox the inventory and organization system built for the Home User
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;
}