pixelize-design-library 2.4.2-beta.42 → 2.4.2-beta.44

package/dist/Utils/apiError.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiErrorMessage = getApiErrorMessage;
+exports.getApiErrorStatus = getApiErrorStatus;
+const asRecord = (value) => typeof value === "object" && value !== null ? value : {};
+// Structural sniffing only — RTK Query's FetchBaseQueryError/SerializedError shapes, no @reduxjs/toolkit import.
+function getApiErrorMessage(error, fallback = "Something went wrong. Please try again.") {
+    const record = asRecord(error);
+    if (Object.keys(record).length === 0)
+        return fallback;
+    if ("status" in record) {
+        const message = asRecord(record.data).message;
+        if (typeof message === "string" && message)
+            return message;
+        if (record.status === "FETCH_ERROR")
+            return "Network error. Check your connection and try again.";
+        if (record.status === "PARSING_ERROR")
+            return "Received an unreadable response from the server.";
+        if (record.status === "TIMEOUT_ERROR")
+            return "The request timed out. Please try again.";
+        return fallback;
+    }
+    return typeof record.message === "string" && record.message ? record.message : fallback;
+}
+function getApiErrorStatus(error) {
+    const record = asRecord(error);
+    return typeof record.status === "number" ? record.status : null;
+}

package/dist/Utils/functions.d.ts

@@ -1 +1,2 @@
+/** `deal_stage` / `nextFollowUp` / `close-date` → `Deal Stage` / `Next Follow Up` / `Close Date`. */
 export declare function toWords(str: string): string;

package/dist/Utils/functions.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toWords = toWords;
+/** `deal_stage` / `nextFollowUp` / `close-date` → `Deal Stage` / `Next Follow Up` / `Close Date`. */
 function toWords(str) {
     return str
-        .toLowerCase()
-        .split('_')
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-        .join(' ');
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .split(/[_\-\s]+/)
+        .filter(Boolean)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(" ");
 }

package/dist/Utils/humanize.d.ts

@@ -0,0 +1,4 @@
+/** `snake_case` / `kebab-case` → `Snake case` — first letter capitalized, rest untouched. */
+export declare function humanize(value: string | null | undefined): string;
+export type EnumLabelResolver = (value: string | null | undefined) => string;
+export declare function createEnumLabelResolver(keyMap: Record<string, string>): EnumLabelResolver;

package/dist/Utils/humanize.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanize = humanize;
+exports.createEnumLabelResolver = createEnumLabelResolver;
+/** `snake_case` / `kebab-case` → `Snake case` — first letter capitalized, rest untouched. */
+function humanize(value) {
+    if (!value)
+        return "";
+    const text = value.replace(/[_-]/g, " ");
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+function createEnumLabelResolver(keyMap) {
+    return (value) => {
+        var _a;
+        if (!value)
+            return "";
+        return (_a = keyMap[value]) !== null && _a !== void 0 ? _a : humanize(value);
+    };
+}

package/dist/Utils/lazyWithRetry.d.ts

@@ -0,0 +1,9 @@
+import { type ComponentType, type LazyExoticComponent } from "react";
+export declare function isChunkLoadError(error: unknown): boolean;
+/** Clears the one-shot reload guard; call once the app has rendered so a later deploy can reload again. */
+export declare function clearChunkReloadGuard(): void;
+/** Wraps `React.lazy`; on a stale-chunk 404 it reloads once instead of leaving a broken import. */
+export declare function lazyWithRetry<T extends ComponentType<any>>(factory: () => Promise<{
+    default: T;
+}>): LazyExoticComponent<T>;
+export declare function installPreloadErrorReload(): void;

package/dist/Utils/lazyWithRetry.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isChunkLoadError = isChunkLoadError;
+exports.clearChunkReloadGuard = clearChunkReloadGuard;
+exports.lazyWithRetry = lazyWithRetry;
+exports.installPreloadErrorReload = installPreloadErrorReload;
+const react_1 = require("react");
+const RELOAD_GUARD_KEY = "pixelize:chunk-reloaded";
+const CHUNK_ERROR_PATTERNS = [
+    "failed to fetch dynamically imported module",
+    "error loading dynamically imported module",
+    "importing a module script failed",
+];
+function isChunkLoadError(error) {
+    const message = error instanceof Error ? error.message : String(error !== null && error !== void 0 ? error : "");
+    const lower = message.toLowerCase();
+    return CHUNK_ERROR_PATTERNS.some((pattern) => lower.includes(pattern));
+}
+function reloadOnce() {
+    if (window.sessionStorage.getItem(RELOAD_GUARD_KEY))
+        return false;
+    window.sessionStorage.setItem(RELOAD_GUARD_KEY, "1");
+    window.location.reload();
+    return true;
+}
+/** Clears the one-shot reload guard; call once the app has rendered so a later deploy can reload again. */
+function clearChunkReloadGuard() {
+    window.sessionStorage.removeItem(RELOAD_GUARD_KEY);
+}
+/** Wraps `React.lazy`; on a stale-chunk 404 it reloads once instead of leaving a broken import. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- mirrors React.lazy's own constraint
+function lazyWithRetry(factory) {
+    return (0, react_1.lazy)(async () => {
+        try {
+            return await factory();
+        }
+        catch (error) {
+            if (isChunkLoadError(error) && reloadOnce()) {
+                return await new Promise(() => { });
+            }
+            throw error;
+        }
+    });
+}
+// Vite's vite:preloadError fires before any component renders; lazyWithRetry alone can't see it.
+function installPreloadErrorReload() {
+    window.addEventListener("vite:preloadError", (event) => {
+        event.preventDefault();
+        reloadOnce();
+    });
+}

package/dist/Utils/mergeRefs.d.ts

@@ -1,10 +1,5 @@
 import React from "react";
 /** Assign a value to a callback ref or a ref object. */
 export declare function setRef<T>(ref: React.Ref<T> | undefined, value: T | null): void;
-/**
- * Combine multiple refs into a single callback ref, so a value flows to all of
- * them. Useful when cloning an element to attach an internal ref while
- * preserving a ref the caller already set.
- */
 export declare function mergeRefs<T>(...refs: Array<React.Ref<T> | undefined>): (value: T | null) => void;
 export default mergeRefs;

package/dist/Utils/mergeRefs.js

@@ -9,11 +9,7 @@ function setRef(ref, value) {
     else if (ref && typeof ref === "object")
         ref.current = value;
 }
-/**
- * Combine multiple refs into a single callback ref, so a value flows to all of
- * them. Useful when cloning an element to attach an internal ref while
- * preserving a ref the caller already set.
- */
+// Combines multiple refs into one callback ref — for cloning an element while preserving a caller's own ref.
 function mergeRefs(...refs) {
     return (value) => refs.forEach((r) => setRef(r, value));
 }

package/dist/Utils/planBadge.d.ts

@@ -1,10 +1,7 @@
 import { PlanPillTone } from "../Components/PlanPill/PlanPillProps";
 import { PlanExpiryInput } from "./planExpiry";
 export type PlanBadgeInput = {
-    /**
-     * Whether the org is on any plan at all. Defaults to true, so a caller that
-     * only knows the plan's name/code can omit it.
-     */
+    /** Whether the org is on any plan at all. Defaults to true. */
     hasPlan?: boolean;
     planName?: string | null;
     /** Plan code, e.g. `"free"`. Used to detect the free plan when `isFreePlan` is omitted. */
@@ -28,11 +25,4 @@ export type PlanBadgeResult = {
     subtitle: string;
     tone: PlanPillTone;
 };
-/**
- * Turns an org's plan state into the label, urgency tone and inset-chip text for
- * a `PlanPill` — the "Upgrade your plan" badge in an app's top bar.
- *
- * Copy and thresholds are centralized here so every app shows the same badge for
- * the same org.
- */
 export declare function resolvePlanBadge(input: PlanBadgeInput): PlanBadgeResult;

package/dist/Utils/planBadge.js

@@ -48,13 +48,7 @@ function daysUntil(expiryDate, now) {
     const startOfDay = (d) => new Date(d.getFullYear(), d.getMonth(), d.getDate());
     return Math.round((startOfDay(expiry).getTime() - startOfDay(now).getTime()) / 86400000);
 }
-/**
- * Turns an org's plan state into the label, urgency tone and inset-chip text for
- * a `PlanPill` — the "Upgrade your plan" badge in an app's top bar.
- *
- * Copy and thresholds are centralized here so every app shows the same badge for
- * the same org.
- */
+// Turns an org's plan state into PlanPill's label, urgency tone and inset-chip text; centralized so every app matches.
 function resolvePlanBadge(input) {
     var _a, _b;
     if (!input.canManageBilling)
@@ -64,14 +58,10 @@ function resolvePlanBadge(input) {
     const daysLeft = daysUntil(input.expiryDate, now);
     const remaining = (0, planExpiry_1.formatPlanRemaining)(input.expiryDate, now);
     const elapsed = (0, planExpiry_1.formatPlanElapsed)(input.expiryDate, now);
-    // Checked before the expiry branch: a lapsed org is downgraded to free, and
-    // "Free expired" is not a state worth shouting about.
+    // NOTE: checked before expiry — a lapsed org downgrades to free, and "Free expired" isn't worth shouting about.
     if (isFreePlan(input, planName))
         return upgrade("");
     if (input.isExpired || elapsed !== "") {
-        // "<plan> expired" as the label with the elapsed time in the inset chip —
-        // folding both behind "Upgrade your plan" made the pill wide enough to
-        // crowd the header.
         return {
             visible: true,
             label: `${planName || GENERIC_PLAN_NAME} expired`,

package/dist/Utils/planExpiry.d.ts

@@ -1,34 +1,8 @@
 export type PlanExpiryInput = string | number | Date | null | undefined;
-/**
- * Calendar months + leftover days between two dates.
- * Anchoring on a real month boundary keeps "1 month" honest across 28/30/31-day
- * months, so Jan 31 → Feb 28 reads as 28 days rather than a whole month.
- */
 export declare function splitMonthsAndDays(from: Date, to: Date): {
     months: number;
     days: number;
 };
-/**
- * Time left on a plan, compactly: `"3mo left"` once a whole month remains,
- * `"18d left"` below that. Intended for `UpgradeButton`'s `subtitle`, so it
- * stays one short line. Returns `""` when there is no usable date or the plan
- * has already lapsed — an expired plan is a different message, which the
- * consuming app owns.
- */
 export declare function formatPlanExpiry(expiryDate: PlanExpiryInput, now?: Date): string;
-/**
- * Time left on a plan, to the minute in the final day: `"3mo left"`, `"18d left"`,
- * then `"23h 45m left"` down to `"1m left"`. `""` once lapsed.
- *
- * Differs from `formatPlanExpiry` only in that last day: a calendar-day count
- * reads as "Expires today" for the whole day, which goes stale next to a live
- * countdown. Prefer this for a badge that sits on screen; `formatPlanExpiry`
- * stays the cheaper day-granular option.
- */
 export declare function formatPlanRemaining(expiryDate: PlanExpiryInput, now?: Date): string;
-/**
- * How long ago a plan lapsed: `"1h 10m ago"` under a day, `"2d ago"` / `"1mo ago"`
- * beyond it. `""` while the plan is still live — so a badge can say how stale a
- * lapse is rather than a bare "expired".
- */
 export declare function formatPlanElapsed(expiryDate: PlanExpiryInput, now?: Date): string;

package/dist/Utils/planExpiry.js

@@ -21,16 +21,10 @@ function addCalendarMonths(date, months) {
 function daysBetween(from, to) {
     return Math.round((to.getTime() - from.getTime()) / MS_PER_DAY);
 }
-/** Compact units (`2mo`, `5d`) — this reads inside a badge subtitle, where
- * "2 months 5 days left" wraps. */
 function unit(count, suffix) {
     return `${count}${suffix}`;
 }
-/**
- * Calendar months + leftover days between two dates.
- * Anchoring on a real month boundary keeps "1 month" honest across 28/30/31-day
- * months, so Jan 31 → Feb 28 reads as 28 days rather than a whole month.
- */
+// NOTE: anchors on real month boundaries so Jan 31 -> Feb 28 reads as 28 days, not "1 month".
 function splitMonthsAndDays(from, to) {
     let months = (to.getFullYear() - from.getFullYear()) * 12 +
         (to.getMonth() - from.getMonth());
@@ -40,13 +34,7 @@ function splitMonthsAndDays(from, to) {
         months = 0;
     return { months, days: daysBetween(addCalendarMonths(from, months), to) };
 }
-/**
- * Time left on a plan, compactly: `"3mo left"` once a whole month remains,
- * `"18d left"` below that. Intended for `UpgradeButton`'s `subtitle`, so it
- * stays one short line. Returns `""` when there is no usable date or the plan
- * has already lapsed — an expired plan is a different message, which the
- * consuming app owns.
- */
+// Compact plan time left, e.g. "3mo left" / "18d left". "" when unusable or already lapsed.
 function formatPlanExpiry(expiryDate, now) {
     const expiry = toDate(expiryDate);
     if (!expiry)
@@ -61,7 +49,6 @@ function formatPlanExpiry(expiryDate, now) {
     const { months, days } = splitMonthsAndDays(today, expiryDay);
     return months > 0 ? `${unit(months, "mo")} left` : `${unit(days, "d")} left`;
 }
-/** Never reports `0m`; the final stretch reads `1m`. */
 function formatHoursMinutes(ms, suffix) {
     const totalMinutes = Math.floor(ms / 60000);
     const hours = Math.floor(totalMinutes / 60);
@@ -70,15 +57,7 @@ function formatHoursMinutes(ms, suffix) {
         ? `${unit(hours, "h")} ${unit(minutes, "m")} ${suffix}`
         : `${unit(Math.max(minutes, 1), "m")} ${suffix}`;
 }
-/**
- * Time left on a plan, to the minute in the final day: `"3mo left"`, `"18d left"`,
- * then `"23h 45m left"` down to `"1m left"`. `""` once lapsed.
- *
- * Differs from `formatPlanExpiry` only in that last day: a calendar-day count
- * reads as "Expires today" for the whole day, which goes stale next to a live
- * countdown. Prefer this for a badge that sits on screen; `formatPlanExpiry`
- * stays the cheaper day-granular option.
- */
+// NOTE: like formatPlanExpiry but to the minute in the final day — for a badge staying on screen.
 function formatPlanRemaining(expiryDate, now) {
     const expiry = toDate(expiryDate);
     if (!expiry)
@@ -93,11 +72,7 @@ function formatPlanRemaining(expiryDate, now) {
     const { months, days } = splitMonthsAndDays(startOfDay(referenceNow), startOfDay(expiry));
     return months > 0 ? `${unit(months, "mo")} left` : `${unit(days, "d")} left`;
 }
-/**
- * How long ago a plan lapsed: `"1h 10m ago"` under a day, `"2d ago"` / `"1mo ago"`
- * beyond it. `""` while the plan is still live — so a badge can say how stale a
- * lapse is rather than a bare "expired".
- */
+// How long ago a plan lapsed, e.g. "1h 10m ago" / "2d ago". "" while still live.
 function formatPlanElapsed(expiryDate, now) {
     const expiry = toDate(expiryDate);
     if (!expiry)

package/dist/Utils/rafThrottle.d.ts

@@ -1,14 +1,3 @@
-/**
- * Coalesces bursts of calls into one per animation frame.
- *
- * Every use in this library is a listener that reads layout (`getBoundingClientRect`) and then
- * writes position state. Unthrottled, a capture-phase `scroll` listener runs once per scrollable
- * ancestor per scroll event — on a low-end device that is a forced reflow several times per frame,
- * which is what makes menus judder while the page moves. One frame is also the fastest rate the
- * screen can show a change, so nothing is lost by dropping the rest.
- *
- * The trailing call wins: the last arguments before the frame fires are the current ones.
- */
 export declare const rafThrottle: <A extends unknown[]>(fn: (...args: A) => void) => ((...args: A) => void) & {
     cancel: () => void;
 };

package/dist/Utils/rafThrottle.js

@@ -1,17 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rafThrottle = void 0;
-/**
- * Coalesces bursts of calls into one per animation frame.
- *
- * Every use in this library is a listener that reads layout (`getBoundingClientRect`) and then
- * writes position state. Unthrottled, a capture-phase `scroll` listener runs once per scrollable
- * ancestor per scroll event — on a low-end device that is a forced reflow several times per frame,
- * which is what makes menus judder while the page moves. One frame is also the fastest rate the
- * screen can show a change, so nothing is lost by dropping the rest.
- *
- * The trailing call wins: the last arguments before the frame fires are the current ones.
- */
+// NOTE: coalesces bursts into one call per animation frame — the trailing call's args win.
 const rafThrottle = (fn) => {
     let frame = null;
     let latest;

package/dist/Utils/table.d.ts

@@ -1,10 +1,7 @@
+import { useDebouncedCallback } from "../Hooks/useDebounce";
 import React from "react";
 import { DataObject, TableHeaderProps } from "../Components/Table/TableProps";
 import type { CustomThemeProps } from "../Theme/themeProps";
-/**
- * Type-aware, null-safe comparison. Detects numbers and dates; otherwise falls
- * back to a numeric-aware locale string compare. Empty/null values sort last.
- */
 export declare function compareValues(aRaw: unknown, bRaw: unknown, direction: "asc" | "desc" | "none"): number;
 export declare function SortMultiColumnData(data: DataObject[], sortConfig: {
     column: string | number;
@@ -28,22 +25,12 @@ export type TableGroup = {
     label: string;
     rows: DataObject[];
 };
-/**
- * Partition rows by a column, preserving first-seen group order. The group key is
- * a normalized string so object/array values (e.g. a `user` field that is an object
- * or an array of users) group together by their readable text instead of by object
- * identity.
- */
 export declare function groupRows(data: DataObject[], groupBy: string | number): TableGroup[];
 export declare const calculateLeftOffset: (columns: number[], index: number) => number;
-/**
- * When a column has no `node`, raw cell values are rendered; plain objects
- * (e.g. relation/user fields) must not be passed as React children.
- */
 export declare function normalizeTableCellValue(value: unknown): React.ReactNode;
 export declare const searchAndSortData: (data: DataObject[], searchValues: Record<string, string>) => DataObject[];
 export declare function debounce<T extends (...args: never[]) => void>(func: T, delay: number): (...args: Parameters<T>) => void;
-export declare function useDebounce<T extends (...args: never[]) => void>(callback: T, delay: number): (...args: Parameters<T>) => void;
+export declare const useDebounce: typeof useDebouncedCallback;
 export declare const pageSizeCalculation: (records: number) => number[];
 type TableCellCalculationProps = {
     isFrozen?: boolean;
@@ -63,12 +50,5 @@ export declare const TableCellCalculation: ({ isFrozen, columnWidths, headerInde
     cellTextColor: string | undefined;
     rowTextColor: string | undefined;
 };
-/**
- * Filters array of objects by checking all property values against the search query.
- *
- * @param data - Array of objects
- * @param query - Search string
- * @returns Filtered data
- */
 export declare function globalSearchFilter<T extends Record<string, unknown>>(data: T[], query: string): T[];
 export {};

package/dist/Utils/table.js

@@ -1,39 +1,9 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TableCellCalculation = exports.pageSizeCalculation = exports.searchAndSortData = exports.calculateLeftOffset = void 0;
+exports.TableCellCalculation = exports.pageSizeCalculation = exports.useDebounce = exports.searchAndSortData = exports.calculateLeftOffset = void 0;
 exports.compareValues = compareValues;
 exports.SortMultiColumnData = SortMultiColumnData;
 exports.buildSemanticStatusPalette = buildSemanticStatusPalette;
@@ -42,25 +12,22 @@ exports.pickTableColor = pickTableColor;
 exports.groupRows = groupRows;
 exports.normalizeTableCellValue = normalizeTableCellValue;
 exports.debounce = debounce;
-exports.useDebounce = useDebounce;
 exports.globalSearchFilter = globalSearchFilter;
-const react_1 = __importStar(require("react"));
+const useDebounce_1 = require("../Hooks/useDebounce");
+const react_1 = __importDefault(require("react"));
 const accentText_1 = require("../Theme/tokens/builders/accentText");
 const color_1 = require("../Theme/tokens/builders/color");
 const outlineRung_1 = require("../Theme/tokens/builders/outlineRung");
 const filledSurface_1 = require("../Theme/tokens/builders/filledSurface");
 const statusTone_1 = require("../Theme/tokens/builders/statusTone");
-// Built once, not per comparison: sorting 10k rows runs this ~130k times, and constructing a
-// collator is orders of magnitude dearer than using one.
+const tone_1 = require("../Theme/tokens/builders/tone");
+// NOTE: built once — sorting 10k rows runs this ~130k times and a Collator is costly to construct.
 const COLLATOR = new Intl.Collator(undefined, {
     numeric: true,
     sensitivity: "base",
 });
 const HAS_DIGIT = /\d/;
-/**
- * Type-aware, null-safe comparison. Detects numbers and dates; otherwise falls
- * back to a numeric-aware locale string compare. Empty/null values sort last.
- */
+// Type-aware, null-safe comparison: numbers and dates detected, else numeric-aware locale compare.
 function compareValues(aRaw, bRaw, direction) {
     if (direction === "none")
         return 0;
@@ -79,8 +46,7 @@ function compareValues(aRaw, bRaw, direction) {
     const bn = Number(b);
     if (!Number.isNaN(an) && !Number.isNaN(bn))
         return (an - bn) * dir;
-    // No digit means no date, so this skips two Date.parse calls per comparison on the common
-    // text columns (names, emails, statuses) without changing which strings parse as dates.
+    // NOTE: skips Date.parse on text columns with no digits — cheap and safe, since no digit means no date.
     if (HAS_DIGIT.test(a) && HAS_DIGIT.test(b)) {
         const ad = Date.parse(a);
         const bd = Date.parse(b);
@@ -105,7 +71,6 @@ function SortMultiColumnData(data, sortConfig) {
 /** Theme-aware status palette per value — soft fill + semantic ink from `resolveStatusTone`. */
 function buildSemanticStatusPalette(toneByValue, theme) {
     const c = theme.colors;
-    const mode = (0, accentText_1.isDarkCanvas)(c.backgroundColor.main) ? "dark" : "light";
     const scales = {
         info: c.semantic.info,
         warning: c.semantic.warning,
@@ -115,7 +80,7 @@ function buildSemanticStatusPalette(toneByValue, theme) {
     };
     return Object.fromEntries(Object.entries(toneByValue).map(([value, key]) => {
         const scale = scales[key];
-        const tone = (0, statusTone_1.resolveStatusTone)(scale, mode);
+        const tone = (0, tone_1.resolveSoftTone)(c, scale);
         const solidRung = (0, filledSurface_1.solidFillRung)(scale, c.white);
         const solid = scale[solidRung];
         return [
@@ -144,7 +109,6 @@ const resolveStatusOverride = (fill, white, black, surface) => {
 /** Deterministic, theme-aware color palette for groups + status pills. */
 function buildTablePalette(theme) {
     const c = theme.colors;
-    const mode = (0, accentText_1.isDarkCanvas)(c.backgroundColor.main) ? "dark" : "light";
     const scales = [
         c.primary,
         c.semantic.success,
@@ -158,7 +122,7 @@ function buildTablePalette(theme) {
         c.purple,
     ];
     return scales.map((scale) => {
-        const tone = (0, statusTone_1.resolveStatusTone)(scale, mode);
+        const tone = (0, tone_1.resolveSoftTone)(c, scale);
         const solidRung = (0, filledSurface_1.solidFillRung)(scale, c.white);
         const solid = scale[solidRung];
         return {
@@ -190,12 +154,7 @@ function pickTableColor(value, palette, override, theme) {
     }
     return palette[hashKey(value) % palette.length];
 }
-/**
- * Partition rows by a column, preserving first-seen group order. The group key is
- * a normalized string so object/array values (e.g. a `user` field that is an object
- * or an array of users) group together by their readable text instead of by object
- * identity.
- */
+// Partitions rows by a column, preserving first-seen group order; groups by readable text, not object identity.
 function groupRows(data, groupBy) {
     const order = [];
     const map = new Map();
@@ -251,11 +210,7 @@ const objectToText = (o) => {
         return String(o.value);
     return "";
 };
-/**
- * Readable string for any cell value. Handles primitives, React elements, entity
- * objects (e.g. `user`: `{ name }` / `{ first_name, last_name }`), and arrays of
- * any of those (e.g. a multi-user field) by joining their texts.
- */
+// Readable string for any cell value: primitives, React elements, entity objects, or arrays of those.
 const getStringValue = (value) => {
     if (value === null || value === undefined)
         return "";
@@ -273,10 +228,7 @@ const getStringValue = (value) => {
     }
     return "";
 };
-/**
- * When a column has no `node`, raw cell values are rendered; plain objects
- * (e.g. relation/user fields) must not be passed as React children.
- */
+// When a column has no `node`, plain objects (relation/user fields) can't be passed as React children.
 function normalizeTableCellValue(value) {
     if (value === null || value === undefined)
         return "";
@@ -288,7 +240,6 @@ function normalizeTableCellValue(value) {
     if (react_1.default.isValidElement(value)) {
         return value;
     }
-    // Objects (relation/user) and arrays (multi-user / multi-select) → readable text.
     return getStringValue(value);
 }
 const searchAndSortData = (data, searchValues) => {
@@ -328,22 +279,7 @@ function debounce(func, delay) {
         }, delay);
     };
 }
-function useDebounce(callback, delay) {
-    const callbackRef = (0, react_1.useRef)(callback);
-    const timerRef = (0, react_1.useRef)(null);
-    (0, react_1.useEffect)(() => {
-        callbackRef.current = callback;
-    }, [callback]);
-    const debouncedFn = (0, react_1.useCallback)((...args) => {
-        if (timerRef.current) {
-            clearTimeout(timerRef.current);
-        }
-        timerRef.current = setTimeout(() => {
-            callbackRef.current(...args);
-        }, delay);
-    }, [delay]);
-    return debouncedFn;
-}
+exports.useDebounce = useDebounce_1.useDebouncedCallback;
 const pageSizeCalculation = (records) => {
     const pageSize = [5, 10];
     if (records > 100) {
@@ -385,13 +321,7 @@ const TableCellCalculation = ({ isFrozen, columnWidths, headerIndex, isCheckbox,
     return { leftOffset, cellBgColor, rowBgColor, cellTextColor, rowTextColor };
 };
 exports.TableCellCalculation = TableCellCalculation;
-/**
- * Filters array of objects by checking all property values against the search query.
- *
- * @param data - Array of objects
- * @param query - Search string
- * @returns Filtered data
- */
+// Filters an array of objects by checking all property values against the search query.
 function globalSearchFilter(data, query) {
     if (!query.trim())
         return data;

package/dist/Utils/validation.d.ts

@@ -0,0 +1,13 @@
+export declare const EMAIL_REGEX: RegExp;
+export type ValidationCode = "email_required" | "email_invalid" | "password_required" | "password_min" | "required" | "positive_number" | "file_type" | "file_too_large" | "video_type" | "youtube_required" | "youtube_invalid";
+export declare const defaultValidationMessages: Record<ValidationCode, string>;
+export declare function validateEmail(value: string): ValidationCode | undefined;
+export declare function validatePassword(value: string, minLength?: number): ValidationCode | undefined;
+export declare function validateRequired(value: string): ValidationCode | undefined;
+export declare function validatePositiveNumber(value: string): ValidationCode | undefined;
+export declare function validateFileType(file: File, allowed?: Set<string>): ValidationCode | undefined;
+export declare function validateFileSize(file: File, maxMB: number): ValidationCode | undefined;
+export declare function validateFile(file: File, maxMB: number, allowed?: Set<string>): ValidationCode | undefined;
+export declare function validateVideoFileType(file: File, allowed?: Set<string>): ValidationCode | undefined;
+export declare function validateVideoFile(file: File, maxMB: number, allowed?: Set<string>): ValidationCode | undefined;
+export declare function validateYoutubeUrl(value: string): ValidationCode | undefined;