torch-glare 2.5.5 → 2.6.0

package/apps/lib/utils/cn.ts

@@ -1,6 +0,0 @@
-import { clsx, type ClassValue } from "clsx";
-import { twMerge } from "tailwind-merge";
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}

package/apps/lib/utils/color.ts

@@ -1,175 +0,0 @@
-/**
- * Pure color-math helpers for the `ColorPicker` component (and anything else that
- * needs to move between hex, RGB, HSV and HSL). No dependencies, no DOM — safe to
- * unit-test and to import on the server.
- *
- * Conventions:
- *  - `RGBA` channels are 0–255 (`r`,`g`,`b`) and 0–1 (`a`).
- *  - `HSV`/`HSL` use `h` 0–360, everything else 0–100.
- *  - Hex output is uppercase, `#rrggbb` when fully opaque and `#rrggbbaa` otherwise.
- */
-
-export interface RGBA {
-  r: number;
-  g: number;
-  b: number;
-  a: number;
-}
-
-export interface HSV {
-  h: number;
-  s: number;
-  v: number;
-}
-
-export interface HSL {
-  h: number;
-  s: number;
-  l: number;
-}
-
-/** Clamp `n` into the inclusive `[min, max]` range. */
-export function clamp(n: number, min: number, max: number): number {
-  return n < min ? min : n > max ? max : n;
-}
-
-/** Round to `digits` decimal places (default 0). */
-export function round(n: number, digits = 0): number {
-  const f = 10 ** digits;
-  return Math.round(n * f) / f;
-}
-
-const toHex2 = (n: number) => clamp(Math.round(n), 0, 255).toString(16).padStart(2, "0");
-
-/**
- * Parse a hex color into `RGBA`. Accepts `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`
- * with or without the leading `#`. Returns `null` for anything unparseable.
- */
-export function parseHex(input: string): RGBA | null {
-  if (typeof input !== "string") return null;
-  let hex = input.trim().replace(/^#/, "");
-
-  // Expand shorthand (#rgb / #rgba → #rrggbb(aa)).
-  if (hex.length === 3 || hex.length === 4) {
-    hex = hex
-      .split("")
-      .map((c) => c + c)
-      .join("");
-  }
-
-  if (hex.length !== 6 && hex.length !== 8) return null;
-  if (!/^[0-9a-fA-F]+$/.test(hex)) return null;
-
-  const r = parseInt(hex.slice(0, 2), 16);
-  const g = parseInt(hex.slice(2, 4), 16);
-  const b = parseInt(hex.slice(4, 6), 16);
-  const a = hex.length === 8 ? parseInt(hex.slice(6, 8), 16) / 255 : 1;
-  return { r, g, b, a: round(a, 2) };
-}
-
-/** Format `RGBA` as an uppercase hex string — `#rrggbb` if opaque, else `#rrggbbaa`. */
-export function formatHex({ r, g, b, a }: RGBA): string {
-  const base = `#${toHex2(r)}${toHex2(g)}${toHex2(b)}`.toUpperCase();
-  if (a >= 1) return base;
-  return `${base}${toHex2(clamp(a, 0, 1) * 255).toUpperCase()}`;
-}
-
-/** RGB (0–255) → HSV (h 0–360, s/v 0–100). Alpha is carried through unchanged elsewhere. */
-export function rgbToHsv({ r, g, b }: { r: number; g: number; b: number }): HSV {
-  const rn = r / 255;
-  const gn = g / 255;
-  const bn = b / 255;
-  const max = Math.max(rn, gn, bn);
-  const min = Math.min(rn, gn, bn);
-  const d = max - min;
-
-  let h = 0;
-  if (d !== 0) {
-    if (max === rn) h = ((gn - bn) / d) % 6;
-    else if (max === gn) h = (bn - rn) / d + 2;
-    else h = (rn - gn) / d + 4;
-    h *= 60;
-    if (h < 0) h += 360;
-  }
-  const s = max === 0 ? 0 : d / max;
-  // Keep 2 decimals: HSV is the picker's internal state, so rounding to whole degrees/percents
-  // here would visibly shift a color that was only ever passed in (e.g. #10B981 → #11BA82).
-  return { h: round(h, 2), s: round(s * 100, 2), v: round(max * 100, 2) };
-}
-
-/** HSV (h 0–360, s/v 0–100) → RGB (0–255). */
-export function hsvToRgb({ h, s, v }: HSV): { r: number; g: number; b: number } {
-  const hn = ((h % 360) + 360) % 360;
-  const sn = clamp(s, 0, 100) / 100;
-  const vn = clamp(v, 0, 100) / 100;
-
-  const c = vn * sn;
-  const x = c * (1 - Math.abs(((hn / 60) % 2) - 1));
-  const m = vn - c;
-
-  let rp = 0;
-  let gp = 0;
-  let bp = 0;
-  if (hn < 60) [rp, gp, bp] = [c, x, 0];
-  else if (hn < 120) [rp, gp, bp] = [x, c, 0];
-  else if (hn < 180) [rp, gp, bp] = [0, c, x];
-  else if (hn < 240) [rp, gp, bp] = [0, x, c];
-  else if (hn < 300) [rp, gp, bp] = [x, 0, c];
-  else [rp, gp, bp] = [c, 0, x];
-
-  return {
-    r: round((rp + m) * 255),
-    g: round((gp + m) * 255),
-    b: round((bp + m) * 255),
-  };
-}
-
-/** RGB (0–255) → HSL (h 0–360, s/l 0–100). */
-export function rgbToHsl({ r, g, b }: { r: number; g: number; b: number }): HSL {
-  const rn = r / 255;
-  const gn = g / 255;
-  const bn = b / 255;
-  const max = Math.max(rn, gn, bn);
-  const min = Math.min(rn, gn, bn);
-  const d = max - min;
-  const l = (max + min) / 2;
-
-  let h = 0;
-  let s = 0;
-  if (d !== 0) {
-    s = d / (1 - Math.abs(2 * l - 1));
-    if (max === rn) h = ((gn - bn) / d) % 6;
-    else if (max === gn) h = (bn - rn) / d + 2;
-    else h = (rn - gn) / d + 4;
-    h *= 60;
-    if (h < 0) h += 360;
-  }
-  return { h: round(h), s: round(s * 100), l: round(l * 100) };
-}
-
-/** HSL (h 0–360, s/l 0–100) → RGB (0–255). */
-export function hslToRgb({ h, s, l }: HSL): { r: number; g: number; b: number } {
-  const hn = ((h % 360) + 360) % 360;
-  const sn = clamp(s, 0, 100) / 100;
-  const ln = clamp(l, 0, 100) / 100;
-
-  const c = (1 - Math.abs(2 * ln - 1)) * sn;
-  const x = c * (1 - Math.abs(((hn / 60) % 2) - 1));
-  const m = ln - c / 2;
-
-  let rp = 0;
-  let gp = 0;
-  let bp = 0;
-  if (hn < 60) [rp, gp, bp] = [c, x, 0];
-  else if (hn < 120) [rp, gp, bp] = [x, c, 0];
-  else if (hn < 180) [rp, gp, bp] = [0, c, x];
-  else if (hn < 240) [rp, gp, bp] = [0, x, c];
-  else if (hn < 300) [rp, gp, bp] = [x, 0, c];
-  else [rp, gp, bp] = [c, 0, x];
-
-  return {
-    r: round((rp + m) * 255),
-    g: round((gp + m) * 255),
-    b: round((bp + m) * 255),
-  };
-}

package/apps/lib/utils/dataViews/path.ts

@@ -1,67 +0,0 @@
-import type { Path, Row } from "./types";
-
-/**
- * Split cache. Bounded on purpose — the previous implementation used an unbounded module-level
- * `Map`, which in a long-lived app grows for every distinct path string it ever sees. Paths come
- * from a fixed field config in practice, so a small cap costs nothing and removes the leak.
- */
-const CACHE_LIMIT = 512;
-const cache = new Map<string, string[]>();
-
-function split(path: Path): string[] {
-  const hit = cache.get(path);
-  if (hit) return hit;
-  const parts = path.split(".");
-  if (cache.size >= CACHE_LIMIT) cache.clear();
-  cache.set(path, parts);
-  return parts;
-}
-
-/** Read a dotted path off a row. Returns `undefined` for any missing link in the chain. */
-export function getByPath(obj: unknown, path: Path | undefined | null): unknown {
-  if (obj == null || path == null || path === "") return undefined;
-  if (typeof obj !== "object") return undefined;
-  let cur: unknown = obj;
-  for (const key of split(path)) {
-    if (cur == null) return undefined;
-    cur = (cur as Record<string, unknown>)[key];
-  }
-  return cur;
-}
-
-/** Read a path and coerce to string for display/compare. `undefined`/`null` become `""`. */
-export function getString(obj: unknown, path: Path | undefined | null): string {
-  const v = getByPath(obj, path);
-  return v == null ? "" : String(v);
-}
-
-/** `"created_at"` / `"createdAt"` → `"Created At"`. Uses the last segment of a dotted path. */
-export function formatPathLabel(path: Path): string {
-  if (!path) return "";
-  const tail = path.includes(".") ? path.split(".").pop()! : path;
-
-  if (tail.includes("_")) {
-    return tail
-      .split("_")
-      .filter(Boolean)
-      .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-      .join(" ");
-  }
-
-  return tail
-    .replace(/([A-Z])/g, " $1")
-    .replace(/^./, (s) => s.toUpperCase())
-    .trim();
-}
-
-/**
- * The default row identity: the first of `row.id`, `row._id`, `row.uuid`, else the array index.
- *
- * The previous implementation fell back through three candidates ending in the array index, so
- * selection and drag-and-drop both broke the moment rows were reordered. Pass `getRowId` when
- * your id lives elsewhere.
- */
-export function defaultGetRowId(row: Row, index: number): string {
-  const id = row.id ?? row._id ?? row.uuid;
-  return id == null ? String(index) : String(id);
-}

package/apps/lib/utils/dataViews/query.ts

@@ -1,73 +0,0 @@
-import type { DataViewsQuery, FilterState, Sort } from "./types";
-
-/**
- * The wire format for a `DataViewsQuery`, both directions.
- *
- * A query is written in the browser and read on the server, and the two have to agree exactly.
- * Keeping the encoder and the decoder in one file is what makes that true by construction —
- * split across a page and a route handler, they drift the first time either side gains a field.
- *
- * No React here, like its neighbours `path.ts` and `types.ts`, so a route handler can import it.
- */
-
-/** A query nobody has touched yet: everything, first page. */
-export function emptyQuery(overrides?: Partial<DataViewsQuery>): DataViewsQuery {
-  return { search: "", filters: {}, sort: null, page: 1, pageSize: 10, ...overrides };
-}
-
-/**
- * Browser → wire.
- *
- * `filters` goes as JSON because it is a nested structure, not a flat list of values. `sort` goes
- * as `total:desc` — one parameter rather than two, since neither half means anything alone.
- *
- * Extra parameters an endpoint of your own needs are yours to append:
- *
- * ```ts
- * const params = queryToParams(query);
- * params.set("shape", "wide");
- * ```
- */
-export function queryToParams(query: DataViewsQuery): URLSearchParams {
-  return new URLSearchParams({
-    search: query.search,
-    filters: JSON.stringify(query.filters),
-    sort: query.sort ? `${query.sort.path}:${query.sort.direction}` : "",
-    page: String(query.page),
-    pageSize: String(query.pageSize),
-  });
-}
-
-/**
- * Wire → server.
- *
- * Malformed `filters` is treated as "no filters" rather than a 400: a filter you cannot parse
- * should not take the page down. `pageSize` is clamped, because it arrives from the client and a
- * request for a million rows is a request to fall over.
- */
-export function parseQuery(url: URL): DataViewsQuery {
-  const params = url.searchParams;
-
-  let filters: FilterState = {};
-  const raw = params.get("filters");
-  if (raw) {
-    try {
-      filters = JSON.parse(raw) as FilterState;
-    } catch {
-      filters = {};
-    }
-  }
-
-  const [sortPath, sortDir] = (params.get("sort") ?? "").split(":");
-  const sort: Sort = sortPath
-    ? { path: sortPath, direction: sortDir === "desc" ? "desc" : "asc" }
-    : null;
-
-  return {
-    search: params.get("search") ?? "",
-    filters,
-    sort,
-    page: Math.max(1, Number(params.get("page")) || 1),
-    pageSize: Math.min(500, Math.max(1, Number(params.get("pageSize")) || 10)),
-  };
-}

package/apps/lib/utils/dataViews/types.ts

@@ -1,187 +0,0 @@
-/**
- * The vocabulary DataViews speaks — nothing more.
- *
- * DataViews does no data work: it never filters, searches, sorts, groups, or infers a schema.
- * Those are the app's job, almost always server-side. What is described here is only what the
- * component needs in order to **paint** rows and to **emit intent** back to you:
- * `FilterState` and `Sort` are things it hands you so you can go and query, not things it applies.
- *
- * These types live in the utils layer so the dependency runs one way — the component imports its
- * vocabulary from here, and nothing here imports React or any component.
- */
-
-import type { ReactNode } from "react";
-
-/** A row is any record. DataViews never assumes a shape beyond the id resolved by `getRowId`. */
-export type Row = Record<string, unknown>;
-
-/** A dotted accessor into a row, e.g. `"customer.name"`. */
-export type Path = string;
-
-export type FieldType =
-  | "text"
-  | "number"
-  | "date"
-  | "boolean"
-  | "hidden"
-  | "enum-badge"
-  | "badge-array"
-  | "currency"
-  | "number-format"
-  | "progress-bar"
-  | "star-rating"
-  | "icon-text"
-  | "two-line"
-  | "avatar"
-  | "link"
-  | "image"
-  | "date-format";
-
-export type BadgeVariant =
-  | "green"
-  | "greenLight"
-  | "cocktailGreen"
-  | "yellow"
-  | "redOrange"
-  | "redLight"
-  | "rose"
-  | "purple"
-  | "bluePurple"
-  | "blue"
-  | "navy"
-  | "gray"
-  | "highlight";
-
-/** Palette keys for a board column pill. */
-export type ColumnColor = "gray" | "purple" | "orange" | "blue" | "green" | "red";
-
-export type CurrencyOptions = {
-  symbol?: string;
-  locale?: string;
-  decimals?: number;
-  code?: string;
-};
-
-/** How one field is read and painted. You author these — nothing is inferred from the data. */
-export type FieldConfig = {
-  path: Path;
-  label?: string;
-  type?: FieldType;
-  visible?: boolean;
-
-  /** Value → badge colour, for `enum-badge` / `badge-array`. */
-  variants?: Record<string, BadgeVariant>;
-  defaultVariant?: BadgeVariant;
-  variant?: BadgeVariant;
-
-  limit?: number;
-  currency?: string | CurrencyOptions;
-  format?: Intl.NumberFormatOptions;
-  thresholds?: [number, number];
-  max?: number;
-  icon?: string;
-  iconPosition?: "before" | "after";
-  secondaryPath?: Path;
-  linkType?: "mailto" | "tel" | "url";
-  fallbackPath?: Path;
-  dateFormat?: string | Intl.DateTimeFormatOptions;
-  trueLabel?: string;
-  falseLabel?: string;
-  trueVariant?: BadgeVariant;
-  falseVariant?: BadgeVariant;
-
-  /** Paint this field yourself. Wins over `type`. */
-  render?: (value: unknown, row: Row) => ReactNode;
-};
-
-/** A column as the user has arranged it — the projection the config panel edits. */
-export type ColumnState = {
-  path: Path;
-  label: string;
-  visible: boolean;
-};
-
-type SortDirection = "asc" | "desc";
-/** Which column the header shows as sorted. Emitted on click; the component never re-orders rows. */
-export type Sort = { path: Path; direction: SortDirection } | null;
-
-type NumericRange = { kind: "number"; min?: number; max?: number };
-type DateRange = { kind: "date"; from?: string; to?: string };
-type RangeValue = NumericRange | DateRange;
-/** A categorical selection, or a range. */
-export type FilterValue = string[] | RangeValue;
-/** Keyed by field path. */
-export type FilterState = Record<Path, FilterValue>;
-
-/** A one-click shortcut on a numeric filter, e.g. "Under 500". */
-export type NumberPreset = { label: string; min?: number; max?: number };
-/** A one-click shortcut on a date filter, e.g. "Last 30 days". */
-export type DatePreset = { label: string; from?: string; to?: string };
-/** `Filters.Presets` takes both shapes; each control renders the ones it understands. */
-export type Preset = NumberPreset | DatePreset;
-
-/**
- * Everything the user asked for, in one object.
- *
- * This is the whole contract between `DataViews` and your data layer. The component collects it —
- * a search typed in the header, filters set in the rail, a column header clicked, a page turned —
- * and hands it over whole; going and fetching the matching rows is your half.
- *
- * It is one object rather than five callbacks because it is one question. A query with a new
- * filter and a stale page number is not a query anyone meant to ask, and keeping the parts
- * together is what lets the component keep them consistent — changing a filter resets `page` to 1,
- * because a different result set has no page 4 to stay on.
- */
-export interface DataViewsQuery {
-  search: string;
-  filters: FilterState;
-  sort: Sort;
-  /** 1-based. */
-  page: number;
-  pageSize: number;
-}
-
-/** How a filter maps between its control's value and `FilterState`. */
-type FilterKind = "choice" | "number" | "date" | "text";
-
-/**
- * What `DataViews.Filters` learned about one of its children.
- *
- * You never write these: filters are authored as `FormBuilder` fields, and `Filters` reads each
- * child's `name`, `label` and bounds off the element to build this. It exists because the mapping
- * to `FilterState` needs to know a slider from a multi-select — a `[0, 500]` is a numeric range,
- * while `["a", "b"]` is a selection, and the two are indistinguishable once they are just values.
- */
-export type FilterFieldDescriptor = {
-  path: Path;
-  label?: string;
-  kind: FilterKind;
-  /** Single-valued choice (`FormBuilder.Select`) rather than multi (`.MultiSelect`). */
-  single?: boolean;
-  /** Slider bounds, read from the child. A slider resting on them emits no filter at all. */
-  min?: number;
-  max?: number;
-};
-
-export type TreeNode = {
-  id: string;
-  row: Row;
-  children: TreeNode[];
-  depth: number;
-};
-
-/** Emitted by a board or tree drag. The component never applies it. */
-export type MoveIntent = {
-  id: string;
-  from: string | null;
-  to: string | null;
-  index?: number;
-};
-
-/** A pre-grouped column for the board view. You build these; the component only paints them. */
-export type RowGroup = {
-  id: string;
-  label: string;
-  color?: ColumnColor;
-  rows: Row[];
-};

package/apps/lib/utils/dateFormat.ts

@@ -1,108 +0,0 @@
-import { DateRange } from "react-day-picker";
-import { format } from "date-fns";
-
-export type TimePickerValue = {
-  hour: string;
-  minute: string;
-  time: string;
-};
-
-/**
- * Applies time from a picker value to a given date object
- * @param {Date} date - The base date to apply time to
- * @param {TimePickerValue} TimePickerValue - Object containing hour, minute, and time period (AM/PM)
- * @returns {Date} A new Date object with the applied time
- */
-export const applyTimeToDate = (date: Date, TimePickerValue: TimePickerValue): Date => {
-  const newDate = new Date(date);
-  let hours = parseInt(String(TimePickerValue.hour));
-
-  // Convert to 24-hour format
-  if (TimePickerValue.time === "PM" && hours < 12) {
-    hours += 12;
-  } else if (TimePickerValue.time === "AM" && hours === 12) {
-    hours = 0;
-  }
-
-  newDate.setHours(hours);
-  newDate.setMinutes(parseInt(String(TimePickerValue.minute)));
-  return newDate;
-};
-
-/**
- * Validates if a given value is a valid Date object
- * @param {Date} date - The date to validate
- * @returns {boolean} True if the value is a valid Date object, false otherwise
- */
-export const isValidDateObject = (date: Date): boolean =>
-  date instanceof Date && !isNaN(date.getTime());
-
-/**
- * Applies time from a picker value to various date value types
- * @param {Date | Date[] | DateRange | undefined} dateValue - The date value to apply time to
- * @param {TimePickerValue} TimePickerValue - Object containing hour, minute, and time period (AM/PM)
- * @returns {Date | Date[] | DateRange | undefined} The date value with applied time, or undefined if invalid
- */
-export const applyTimeToDateValue = (
-  dateValue: Date | Date[] | DateRange | undefined,
-  TimePickerValue: TimePickerValue,
-): Date | Date[] | DateRange | undefined => {
-  if (!dateValue) return undefined;
-
-  // Handle array of dates
-  if (Array.isArray(dateValue)) {
-    return dateValue
-      .filter(isValidDateObject)
-      .map((date) => applyTimeToDate(date, TimePickerValue));
-  }
-
-  // Handle date range
-  if (dateValue && "from" in dateValue) {
-    const from =
-      dateValue.from && isValidDateObject(dateValue.from as Date)
-        ? applyTimeToDate(dateValue.from as Date, TimePickerValue)
-        : undefined;
-    const to =
-      dateValue.to && isValidDateObject(dateValue.to as Date)
-        ? applyTimeToDate(dateValue.to as Date, TimePickerValue)
-        : undefined;
-    return { from, to };
-  }
-
-  // Handle single date
-  return isValidDateObject(dateValue as Date)
-    ? applyTimeToDate(dateValue as Date, TimePickerValue)
-    : undefined;
-};
-
-/**
- * Formats a date value to a string based on the provided format
- * @param {Date | Date[] | DateRange | undefined} date - The date value to format
- * @param {TimePickerValue} TimePickerValue - Object containing hour, minute, and time period (AM/PM)
- * @param {string} dateFormat - The format string to use for formatting (e.g., 'MM/dd/yyyy')
- * @returns {string} Formatted date string, or empty string if date is undefined
- */
-export const formatDateValueToString = (
-  date: Date | Date[] | DateRange | undefined,
-  TimePickerValue: TimePickerValue,
-  dateFormat: string,
-): string => {
-  if (!date) return "";
-
-  // Handle array of dates
-  if (Array.isArray(date)) {
-    return date.map((d) => format(applyTimeToDate(d, TimePickerValue), dateFormat)).join(", ");
-  }
-
-  // Handle date range
-  if ("from" in date) {
-    const from = date.from
-      ? format(applyTimeToDate(date.from as Date, TimePickerValue), dateFormat)
-      : "";
-    const to = date.to ? format(applyTimeToDate(date.to as Date, TimePickerValue), dateFormat) : "";
-    return from && to ? `${from} - ${to}` : from || to;
-  }
-
-  // Handle single date
-  return format(applyTimeToDate(date as Date, TimePickerValue), dateFormat);
-};

package/apps/lib/utils/resize.ts

@@ -1,31 +0,0 @@
-import { MutableRefObject, RefObject } from "react";
-
-// Extracted function to get the new width based on the mouse event
-export const calculateNewWidthFromMouse = (
-  event: MouseEvent,
-  resizableRef: MutableRefObject<HTMLElement | null> | RefObject<HTMLElement | null>,
-  isRtl: boolean,
-): number => {
-  if (resizableRef.current) {
-    const rect = resizableRef.current.getBoundingClientRect();
-    return isRtl
-      ? rect.right - event.clientX // Reverse calculation for RTL
-      : event.clientX - rect.left;
-  }
-  return 0;
-};
-
-// Extracted function to get the new width based on the touch event
-export const calculateNewWidthFromTouch = (
-  event: TouchEvent,
-  resizableRef: MutableRefObject<HTMLElement | null> | RefObject<HTMLElement | null>,
-  isRtl: boolean,
-): number => {
-  if (resizableRef.current) {
-    const rect = resizableRef.current.getBoundingClientRect();
-    return isRtl
-      ? rect.right - event.touches[0].clientX // Reverse calculation for RTL
-      : event.touches[0].clientX - rect.left;
-  }
-  return 0;
-};

package/apps/lib/utils/types.ts

@@ -1,16 +0,0 @@
-export type Themes = "dark" | "light" | "default";
-
-export type ButtonVariant =
-  | "PrimeStyle"
-  | "BluSecStyle"
-  | "YelSecStyle"
-  | "RedSecStyle"
-  | "BorderStyle"
-  | "PrimeContStyle"
-  | "BluContStyle"
-  | "RedContStyle"
-  | "PrimeColStyle"
-  | "BluColStyle"
-  | "RedColStyle"
-  | "GreenColStyle"
-  | "YelColStyle";