pixelize-design-library 2.4.1 → 2.4.2-beta.1

package/dist/Utils/accountHandoff.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cross-app "Account handoff": deep-link from a product app (CRM, Tickets, HRMS)
+ * into the Account app carrying the token, so the user lands signed in. Consuming
+ * apps once copy-pasted this per repo; it lives here so they share one contract.
+ *
+ * Query-param contract (must stay in sync across every caller):
+ * `sourceApp`, `returnUrl`, `orgId`, `api_key` (+ `userId` on the users page).
+ *
+ * The library is pre-bundled, so it must not read `import.meta.env` — that would
+ * bake in the library's own build env. Env-derived values are injected as config.
+ */
+export declare function isAllowedReturnUrl(url: string): boolean;
+export type ResolveReturnUrlOptions = {
+    /** App-specific fallback (e.g. its own origin) used when the param is missing/disallowed. */
+    defaultReturnUrl?: string;
+};
+/**
+ * Receiver side (Account). Returns the `returnUrl` param only when it passes the
+ * allowlist, else the caller's `defaultReturnUrl` when that is allowed, else null.
+ * `fallbackOrgId` is accepted for caller symmetry; the app owns any org-derived
+ * fallback via `opts.defaultReturnUrl`.
+ */
+export declare function resolveReturnUrl(searchParams: URLSearchParams, fallbackOrgId?: number | string | null, opts?: ResolveReturnUrlOptions): string | null;
+export type AccountHandoffConfig = {
+    sourceApp: string;
+    /** The app's `VITE_ACCOUNT_UI` (may be empty). */
+    accountUiBase?: string;
+    /** This app's dev port, e.g. "3002". */
+    appLocalPort: string;
+    /** Account's dev port. Defaults to "3000". */
+    accountLocalPort?: string;
+    /** The app's `VITE_FORCE_REMOTE_ACCOUNT_UI === "true"`. */
+    forceRemote?: boolean;
+    /** Where Account returns the user to. Defaults to this app's own origin. */
+    buildReturnUrl?: (orgId?: number | string | null) => string;
+};
+export type AccountHandoffLinkOptions = {
+    sourceApp?: string;
+    returnUrl?: string;
+    orgId?: number | string | null;
+    token?: string | null;
+};
+export type AccountHandoffUsersOptions = AccountHandoffLinkOptions & {
+    userId?: number | string | null;
+};
+export type AccountHandoff = {
+    resolveAccountUiBase: () => string;
+    buildUsersPageUrl: (options?: AccountHandoffUsersOptions) => string;
+    navigateToUsersPage: (options?: AccountHandoffUsersOptions) => void;
+    buildOrganizationPageUrl: (options?: AccountHandoffLinkOptions) => string;
+    navigateToOrganizationPage: (options?: AccountHandoffLinkOptions) => void;
+};
+export declare function createAccountHandoff(config: AccountHandoffConfig): AccountHandoff;

package/dist/Utils/accountHandoff.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Cross-app "Account handoff": deep-link from a product app (CRM, Tickets, HRMS)
+ * into the Account app carrying the token, so the user lands signed in. Consuming
+ * apps once copy-pasted this per repo; it lives here so they share one contract.
+ *
+ * Query-param contract (must stay in sync across every caller):
+ * `sourceApp`, `returnUrl`, `orgId`, `api_key` (+ `userId` on the users page).
+ *
+ * The library is pre-bundled, so it must not read `import.meta.env` — that would
+ * bake in the library's own build env. Env-derived values are injected as config.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAllowedReturnUrl = isAllowedReturnUrl;
+exports.resolveReturnUrl = resolveReturnUrl;
+exports.createAccountHandoff = createAccountHandoff;
+const ALLOWED_RETURN_HOST_PATTERNS = [
+    /^localhost$/,
+    /^127\.0\.0\.1$/,
+    /\.pixelizetech\.com$/i,
+];
+const DEFAULT_ACCOUNT_PORT = "3000";
+function isAllowedReturnUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+            return false;
+        }
+        return ALLOWED_RETURN_HOST_PATTERNS.some((pattern) => pattern.test(parsed.hostname));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Receiver side (Account). Returns the `returnUrl` param only when it passes the
+ * allowlist, else the caller's `defaultReturnUrl` when that is allowed, else null.
+ * `fallbackOrgId` is accepted for caller symmetry; the app owns any org-derived
+ * fallback via `opts.defaultReturnUrl`.
+ */
+function resolveReturnUrl(searchParams, fallbackOrgId, opts) {
+    void fallbackOrgId;
+    const returnUrl = searchParams.get("returnUrl");
+    if (returnUrl && isAllowedReturnUrl(returnUrl)) {
+        return returnUrl;
+    }
+    const fallback = opts === null || opts === void 0 ? void 0 : opts.defaultReturnUrl;
+    if (fallback && isAllowedReturnUrl(fallback)) {
+        return fallback;
+    }
+    return null;
+}
+function isLocalDevHost(hostname) {
+    return /^(localhost|127\.0\.0\.1)$/i.test(hostname);
+}
+function currentPagePort() {
+    return (window.location.port ||
+        (window.location.protocol === "https:" ? "443" : "80"));
+}
+function createAccountHandoff(config) {
+    var _a;
+    /** Account origin for local dev. Never this app's own port — a same-origin URL would keep the user here. */
+    function localAccountBase(hostname) {
+        const pagePort = currentPagePort();
+        let port = String(config.accountLocalPort || DEFAULT_ACCOUNT_PORT).trim() ||
+            DEFAULT_ACCOUNT_PORT;
+        if (port === pagePort || port === config.appLocalPort) {
+            port = DEFAULT_ACCOUNT_PORT;
+        }
+        if (port === pagePort) {
+            port = pagePort === "3000" ? "3001" : DEFAULT_ACCOUNT_PORT;
+        }
+        return `http://${hostname}:${port}`;
+    }
+    function resolveAccountUiBase() {
+        const hostname = window.location.hostname;
+        const configured = String(config.accountUiBase || "")
+            .trim()
+            .replace(/\/$/, "");
+        if (!config.forceRemote && isLocalDevHost(hostname)) {
+            return localAccountBase(hostname);
+        }
+        if (!configured) {
+            return localAccountBase(hostname);
+        }
+        try {
+            if (new URL(configured).origin === window.location.origin) {
+                return localAccountBase(hostname);
+            }
+        }
+        catch {
+            return localAccountBase(hostname);
+        }
+        return configured;
+    }
+    const buildReturnUrl = (_a = config.buildReturnUrl) !== null && _a !== void 0 ? _a : (() => window.location.origin.replace(/\/$/, ""));
+    function buildParams(options) {
+        var _a, _b;
+        const params = new URLSearchParams();
+        params.set("sourceApp", (_a = options.sourceApp) !== null && _a !== void 0 ? _a : config.sourceApp);
+        const returnUrl = (_b = options.returnUrl) !== null && _b !== void 0 ? _b : buildReturnUrl(options.orgId);
+        if (returnUrl && isAllowedReturnUrl(returnUrl)) {
+            params.set("returnUrl", returnUrl);
+        }
+        if (options.orgId) {
+            params.set("orgId", String(options.orgId));
+        }
+        if (options.token) {
+            params.set("api_key", options.token);
+        }
+        return params;
+    }
+    function buildUsersPageUrl(options = {}) {
+        const params = buildParams(options);
+        if (options.userId != null && options.userId !== "") {
+            params.set("userId", String(options.userId));
+        }
+        return `${resolveAccountUiBase()}/users?${params.toString()}`;
+    }
+    function navigateToUsersPage(options = {}) {
+        const url = buildUsersPageUrl(options);
+        if (!/^https?:\/\//i.test(url)) {
+            return;
+        }
+        window.location.assign(url);
+    }
+    function buildOrganizationPageUrl(options = {}) {
+        return `${resolveAccountUiBase()}/organization?${buildParams(options).toString()}`;
+    }
+    function navigateToOrganizationPage(options = {}) {
+        const url = buildOrganizationPageUrl(options);
+        if (!/^https?:\/\//i.test(url)) {
+            return;
+        }
+        window.location.assign(url);
+    }
+    return {
+        resolveAccountUiBase,
+        buildUsersPageUrl,
+        navigateToUsersPage,
+        buildOrganizationPageUrl,
+        navigateToOrganizationPage,
+    };
+}

package/dist/Utils/functions.d.ts

@@ -1,2 +1 @@
 export declare function toWords(str: string): string;
-//# sourceMappingURL=functions.d.ts.map

package/dist/Utils/mergeRefs.d.ts

@@ -8,4 +8,3 @@ export declare function setRef<T>(ref: React.Ref<T> | undefined, value: T | null
  */
 export declare function mergeRefs<T>(...refs: Array<React.Ref<T> | undefined>): (value: T | null) => void;
 export default mergeRefs;
-//# sourceMappingURL=mergeRefs.d.ts.map

package/dist/Utils/planBadge.d.ts

@@ -0,0 +1,38 @@
+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.
+     */
+    hasPlan?: boolean;
+    planName?: string | null;
+    /** Plan code, e.g. `"free"`. Used to detect the free plan when `isFreePlan` is omitted. */
+    planCode?: string | null;
+    /** Legacy numeric plan id, where `1` is the free plan. */
+    planId?: number | null;
+    /** Explicit free-plan flag. Overrides detection from `planCode`/`planId`/`planName`. */
+    isFreePlan?: boolean;
+    isTrial?: boolean;
+    isExpired?: boolean;
+    expiryDate?: PlanExpiryInput;
+    /** The badge is hidden entirely for anyone who cannot act on it. */
+    canManageBilling?: boolean;
+    /** Injectable clock, for tests. */
+    now?: Date;
+};
+export type PlanBadgeResult = {
+    visible: boolean;
+    label: string;
+    mobileLabel: string;
+    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

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePlanBadge = resolvePlanBadge;
+const planExpiry_1 = require("./planExpiry");
+const UPGRADE_LABEL = "Upgrade your plan";
+const UPGRADE_MOBILE_LABEL = "Upgrade";
+const EXPIRED_MOBILE_LABEL = "Expired";
+const TRIAL_LABEL = "Trial";
+const GENERIC_PLAN_NAME = "Plan";
+const LEGACY_FREE_PLAN_ID = 1;
+const TRIAL_DANGER_DAYS = 3;
+const ACTIVE_WARNING_DAYS = 15;
+const HIDDEN = {
+    visible: false,
+    label: "",
+    mobileLabel: "",
+    subtitle: "",
+    tone: "normal",
+};
+const upgrade = (subtitle, tone = "normal") => ({
+    visible: true,
+    label: UPGRADE_LABEL,
+    mobileLabel: UPGRADE_MOBILE_LABEL,
+    subtitle,
+    tone,
+});
+const normalize = (value) => String(value !== null && value !== void 0 ? value : "")
+    .trim()
+    .toLowerCase();
+function isFreePlan(input, planName) {
+    if (input.isFreePlan !== undefined)
+        return input.isFreePlan;
+    if (normalize(input.planCode) === "free")
+        return true;
+    if (input.planId !== null && input.planId !== undefined) {
+        return Number(input.planId) === LEGACY_FREE_PLAN_ID;
+    }
+    return normalize(planName) === "free";
+}
+/** Whole days from today to the expiry day; null when there is no usable date. */
+function daysUntil(expiryDate, now) {
+    if (expiryDate === null || expiryDate === undefined || expiryDate === "") {
+        return null;
+    }
+    const expiry = expiryDate instanceof Date ? expiryDate : new Date(expiryDate);
+    if (isNaN(expiry.getTime()))
+        return null;
+    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.
+ */
+function resolvePlanBadge(input) {
+    var _a, _b;
+    if (!input.canManageBilling)
+        return HIDDEN;
+    const now = (_a = input.now) !== null && _a !== void 0 ? _a : new Date();
+    const planName = ((_b = input.planName) === null || _b === void 0 ? void 0 : _b.trim()) || "";
+    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.
+    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`,
+            mobileLabel: EXPIRED_MOBILE_LABEL,
+            subtitle: elapsed,
+            tone: "danger",
+        };
+    }
+    if (input.hasPlan === false)
+        return upgrade("");
+    if (input.isTrial) {
+        return {
+            visible: true,
+            label: TRIAL_LABEL,
+            mobileLabel: TRIAL_LABEL,
+            subtitle: remaining,
+            tone: daysLeft !== null && daysLeft <= TRIAL_DANGER_DAYS
+                ? "danger"
+                : "warning",
+        };
+    }
+    const tone = daysLeft !== null && daysLeft < ACTIVE_WARNING_DAYS ? "warning" : "normal";
+    // An active paid plan names itself — falling through to "Upgrade your plan"
+    // told users with years remaining that they were on nothing.
+    if (!planName)
+        return upgrade(remaining, tone);
+    return {
+        visible: true,
+        label: planName,
+        mobileLabel: planName,
+        subtitle: remaining,
+        tone,
+    };
+}

package/dist/Utils/planExpiry.d.ts

@@ -0,0 +1,34 @@
+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

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitMonthsAndDays = splitMonthsAndDays;
+exports.formatPlanExpiry = formatPlanExpiry;
+exports.formatPlanRemaining = formatPlanRemaining;
+exports.formatPlanElapsed = formatPlanElapsed;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+function toDate(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+    return isNaN(date.getTime()) ? null : date;
+}
+function startOfDay(date) {
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+function addCalendarMonths(date, months) {
+    const lastDayOfTarget = new Date(date.getFullYear(), date.getMonth() + months + 1, 0).getDate();
+    return new Date(date.getFullYear(), date.getMonth() + months, Math.min(date.getDate(), lastDayOfTarget));
+}
+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.
+ */
+function splitMonthsAndDays(from, to) {
+    let months = (to.getFullYear() - from.getFullYear()) * 12 +
+        (to.getMonth() - from.getMonth());
+    if (to.getDate() < from.getDate())
+        months -= 1;
+    if (months < 0)
+        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.
+ */
+function formatPlanExpiry(expiryDate, now) {
+    const expiry = toDate(expiryDate);
+    if (!expiry)
+        return "";
+    const expiryDay = startOfDay(expiry);
+    const today = startOfDay(now !== null && now !== void 0 ? now : new Date());
+    const daysLeft = daysBetween(today, expiryDay);
+    if (daysLeft < 0)
+        return "";
+    if (daysLeft === 0)
+        return "Expires today";
+    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);
+    const minutes = totalMinutes % 60;
+    return hours > 0
+        ? `${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.
+ */
+function formatPlanRemaining(expiryDate, now) {
+    const expiry = toDate(expiryDate);
+    if (!expiry)
+        return "";
+    const referenceNow = now !== null && now !== void 0 ? now : new Date();
+    const msLeft = expiry.getTime() - referenceNow.getTime();
+    if (msLeft < 0)
+        return "";
+    if (msLeft < MS_PER_DAY) {
+        return msLeft === 0 ? "Expires today" : formatHoursMinutes(msLeft, "left");
+    }
+    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".
+ */
+function formatPlanElapsed(expiryDate, now) {
+    const expiry = toDate(expiryDate);
+    if (!expiry)
+        return "";
+    const referenceNow = now !== null && now !== void 0 ? now : new Date();
+    const msAgo = referenceNow.getTime() - expiry.getTime();
+    if (msAgo <= 0)
+        return "";
+    if (msAgo < MS_PER_DAY)
+        return formatHoursMinutes(msAgo, "ago");
+    const { months, days } = splitMonthsAndDays(startOfDay(expiry), startOfDay(referenceNow));
+    return months > 0
+        ? `${unit(months, "mo")} ago`
+        : `${unit(Math.max(days, 1), "d")} ago`;
+}

package/dist/Utils/rafThrottle.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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

@@ -0,0 +1,34 @@
+"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.
+ */
+const rafThrottle = (fn) => {
+    let frame = null;
+    let latest;
+    const throttled = (...args) => {
+        latest = args;
+        if (frame !== null)
+            return;
+        frame = requestAnimationFrame(() => {
+            frame = null;
+            fn(...latest);
+        });
+    };
+    throttled.cancel = () => {
+        if (frame !== null)
+            cancelAnimationFrame(frame);
+        frame = null;
+    };
+    return throttled;
+};
+exports.rafThrottle = rafThrottle;

package/dist/Utils/table.d.ts

@@ -18,13 +18,7 @@ export type TablePaletteColor = {
 };
 /** Deterministic, theme-aware color palette for groups + status pills. */
 export declare function buildTablePalette(theme: CustomThemeProps): TablePaletteColor[];
-/**
- * Pick a deterministic palette color for a value, with optional override hex.
- *
- * `theme` is optional so existing callers that don't have it keep compiling — when omitted,
- * `onSolid` falls back to the mode-stable absolutes ("#FFFFFF"/"#000000", same value
- * `theme.colors.white`/`black` resolve to for every brand) instead of going undefined.
- */
+/** Pick a deterministic palette color for a value, with optional consumer override hex. */
 export declare function pickTableColor(value: string | number, palette: TablePaletteColor[], override?: string, theme?: CustomThemeProps): TablePaletteColor;
 export type TableGroup = {
     value: string | number;
@@ -75,4 +69,3 @@ export declare const TableCellCalculation: ({ isFrozen, columnWidths, headerInde
  */
 export declare function globalSearchFilter<T extends Record<string, unknown>>(data: T[], query: string): T[];
 export {};
-//# sourceMappingURL=table.d.ts.map