pixelize-design-library 2.4.2-beta.5 → 2.4.2-beta.50

package/dist/Theme/tokens/builders/viewportHeight.d.ts

@@ -0,0 +1,8 @@
+/** Full viewport height. `dvh` excludes mobile browser chrome; `vh` does not. */
+export declare const fullViewportHeight: {
+    height: string;
+    "@supports (height: 100dvh)": {
+        height: string;
+    };
+};
+export default fullViewportHeight;

package/dist/Theme/tokens/builders/viewportHeight.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fullViewportHeight = void 0;
+/** Full viewport height. `dvh` excludes mobile browser chrome; `vh` does not. */
+exports.fullViewportHeight = {
+    height: "100vh",
+    "@supports (height: 100dvh)": { height: "100dvh" },
+};
+exports.default = exports.fullViewportHeight;

package/dist/Theme/tokens/index.d.ts

@@ -1,13 +1,3 @@
-/**
- * Pixelize design tokens — the portable core of the design system.
- *
- * PURITY CONTRACT: nothing in this folder imports Chakra, React, or CSS. It is plain
- * TypeScript data + pure functions, so the mobile design library can consume this
- * folder as-is. Keep it that way — a single Chakra/CSS import here breaks the mobile port.
- *
- * Web-only concerns (Chakra `extendTheme`, `cssVarPrefix`, the Inter font-face CSS import)
- * live in `Theme/chakra/` instead.
- */
 export * from "./types";
 export * from "./primitives";
 export * from "./brands";

package/dist/Theme/tokens/index.js

@@ -1,14 +1,4 @@
 "use strict";
-/**
- * Pixelize design tokens — the portable core of the design system.
- *
- * PURITY CONTRACT: nothing in this folder imports Chakra, React, or CSS. It is plain
- * TypeScript data + pure functions, so the mobile design library can consume this
- * folder as-is. Keep it that way — a single Chakra/CSS import here breaks the mobile port.
- *
- * Web-only concerns (Chakra `extendTheme`, `cssVarPrefix`, the Inter font-face CSS import)
- * live in `Theme/chakra/` instead.
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -24,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// NOTE: purity contract — nothing here imports Chakra/React/CSS, so the mobile design library can consume it as-is.
 __exportStar(require("./types"), exports);
 __exportStar(require("./primitives"), exports);
 __exportStar(require("./brands"), exports);

package/dist/Theme/tokens/primitives/controlSizes.d.ts

@@ -0,0 +1,12 @@
+export type ControlSize = "xs" | "sm" | "md" | "lg";
+export type ControlSizeSpec = {
+    height: string;
+    fontSize: string;
+    paddingX: string;
+    iconSize: number;
+};
+/** One height scale for fields, selects and buttons, so controls side by side line up. */
+export declare const CONTROL_SIZES: Readonly<Record<ControlSize, ControlSizeSpec>>;
+export declare const CONTROL_SIZE_NAMES: readonly ControlSize[];
+export declare const DEFAULT_CONTROL_SIZE: ControlSize;
+export declare const isControlSize: (value: unknown) => value is ControlSize;

package/dist/Theme/tokens/primitives/controlSizes.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isControlSize = exports.DEFAULT_CONTROL_SIZE = exports.CONTROL_SIZE_NAMES = exports.CONTROL_SIZES = void 0;
+/** One height scale for fields, selects and buttons, so controls side by side line up. */
+exports.CONTROL_SIZES = {
+    xs: { height: "1.75rem", fontSize: "0.75rem", paddingX: "0.5rem", iconSize: 12 },
+    sm: { height: "2.1875rem", fontSize: "0.8125rem", paddingX: "0.75rem", iconSize: 14 },
+    md: { height: "2.5rem", fontSize: "0.875rem", paddingX: "1rem", iconSize: 16 },
+    lg: { height: "3rem", fontSize: "1rem", paddingX: "1.5rem", iconSize: 18 },
+};
+exports.CONTROL_SIZE_NAMES = ["xs", "sm", "md", "lg"];
+exports.DEFAULT_CONTROL_SIZE = "sm";
+const isControlSize = (value) => typeof value === "string" && exports.CONTROL_SIZE_NAMES.includes(value);
+exports.isControlSize = isControlSize;

package/dist/Theme/tokens/primitives/index.d.ts

@@ -7,3 +7,5 @@ export { default as breakpoints } from "./breakpoints";
 export { default as lineHeights } from "./lineHeights";
 export { default as letterSpacings } from "./letterSpacings";
 export { default as typography, fonts, fontSizes, fontWeights } from "./typography";
+export * from "./controlSizes";
+export * from "./motion";

package/dist/Theme/tokens/primitives/index.js

@@ -1,4 +1,18 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -25,3 +39,5 @@ Object.defineProperty(exports, "typography", { enumerable: true, get: function (
 Object.defineProperty(exports, "fonts", { enumerable: true, get: function () { return typography_1.fonts; } });
 Object.defineProperty(exports, "fontSizes", { enumerable: true, get: function () { return typography_1.fontSizes; } });
 Object.defineProperty(exports, "fontWeights", { enumerable: true, get: function () { return typography_1.fontWeights; } });
+__exportStar(require("./controlSizes"), exports);
+__exportStar(require("./motion"), exports);

package/dist/Theme/tokens/primitives/motion.d.ts

@@ -0,0 +1,8 @@
+export declare const MOTION_MS: {
+    readonly fast: 150;
+    readonly base: 200;
+};
+export type MotionSpeed = keyof typeof MOTION_MS;
+export declare const MOTION_EASE = "cubic-bezier(0.2, 0, 0, 1)";
+/** A `transition` value for named properties only — `all` also animates layout and colour flips. */
+export declare const transitionFor: (properties: readonly string[], speed?: MotionSpeed) => string;

package/dist/Theme/tokens/primitives/motion.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transitionFor = exports.MOTION_EASE = exports.MOTION_MS = void 0;
+exports.MOTION_MS = { fast: 150, base: 200 };
+exports.MOTION_EASE = "cubic-bezier(0.2, 0, 0, 1)";
+/** A `transition` value for named properties only — `all` also animates layout and colour flips. */
+const transitionFor = (properties, speed = "fast") => {
+    if (properties.includes("all"))
+        throw new Error("transitionFor: name the properties, never `all`");
+    return properties.map((p) => `${p} ${exports.MOTION_MS[speed]}ms ${exports.MOTION_EASE}`).join(", ");
+};
+exports.transitionFor = transitionFor;

package/dist/Theme/tokens/primitives/optionRowSizes.d.ts

@@ -0,0 +1,20 @@
+import type { ControlSize } from "./controlSizes";
+export type OptionRowSpec = {
+    minH: string;
+    px: string;
+    py: string;
+    gap: string;
+    /** Inset so the row's rounded fill stops short of the popup edge. */
+    mx: string;
+    fontSize: string;
+    descriptionFontSize: string;
+    iconSize: number;
+    /** Avatar token for rows that lead with one — an `sm` avatar alone outgrows an `sm` row. */
+    avatarSize: "2xs" | "xs" | "sm";
+    /** Fixed row height the virtualiser scrolls by; must match a single-line row. */
+    virtualRowHeightPx: number;
+};
+/** One density for every option row — Select, SearchSelect, SelectSearch, table filters and Chakra's MenuItem. */
+export declare const OPTION_ROW_SIZES: Readonly<Record<ControlSize, OptionRowSpec>>;
+export declare const OPTION_ROW_RADIUS = "md";
+export declare const optionRowSpec: (size: ControlSize) => OptionRowSpec;

package/dist/Theme/tokens/primitives/optionRowSizes.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionRowSpec = exports.OPTION_ROW_RADIUS = exports.OPTION_ROW_SIZES = void 0;
+/** One density for every option row — Select, SearchSelect, SelectSearch, table filters and Chakra's MenuItem. */
+exports.OPTION_ROW_SIZES = {
+    xs: {
+        minH: "1.5rem", px: "0.5rem", py: "0.125rem", gap: "0.375rem", mx: "0.25rem",
+        fontSize: "0.75rem", descriptionFontSize: "0.6875rem", iconSize: 12,
+        avatarSize: "2xs", virtualRowHeightPx: 24,
+    },
+    sm: {
+        minH: "1.875rem", px: "0.625rem", py: "0.25rem", gap: "0.5rem", mx: "0.375rem",
+        fontSize: "0.8125rem", descriptionFontSize: "0.75rem", iconSize: 14,
+        avatarSize: "xs", virtualRowHeightPx: 30,
+    },
+    md: {
+        minH: "2.125rem", px: "0.75rem", py: "0.3125rem", gap: "0.5rem", mx: "0.375rem",
+        fontSize: "0.875rem", descriptionFontSize: "0.75rem", iconSize: 16,
+        avatarSize: "xs", virtualRowHeightPx: 34,
+    },
+    lg: {
+        minH: "2.5rem", px: "0.875rem", py: "0.375rem", gap: "0.625rem", mx: "0.5rem",
+        fontSize: "1rem", descriptionFontSize: "0.8125rem", iconSize: 18,
+        avatarSize: "sm", virtualRowHeightPx: 40,
+    },
+};
+exports.OPTION_ROW_RADIUS = "md";
+const optionRowSpec = (size) => exports.OPTION_ROW_SIZES[size];
+exports.optionRowSpec = optionRowSpec;

package/dist/Theme/tokens/primitives/sizes.d.ts

@@ -1,7 +1,3 @@
-/**
- * `screenW`/`screenH` use viewport units — a web concept. The mobile port should
- * map these to `Dimensions.get("window")` rather than consuming them literally.
- */
 declare const sizes: {
     full: string;
     screenW: string;

package/dist/Theme/tokens/primitives/sizes.js

@@ -4,10 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const space_1 = __importDefault(require("./space"));
-/**
- * `screenW`/`screenH` use viewport units — a web concept. The mobile port should
- * map these to `Dimensions.get("window")` rather than consuming them literally.
- */
+// NOTE: screenW/screenH use viewport units — the mobile port should map these to Dimensions.get("window").
 const sizes = {
     ...space_1.default,
     full: "100%",

package/dist/Theme/tokens/primitives/typography.d.ts

@@ -1,10 +1,3 @@
-/**
- * Pure typography tokens. Platform-agnostic.
- *
- * NOTE: the web build must additionally load the Inter Variable font face
- * (`Theme/chakra/fonts.web.ts` does the CSS side-effect import). That import is
- * deliberately NOT here — a CSS import would break the mobile port of this folder.
- */
 export declare const fonts: {
     body: string;
     heading: string;

package/dist/Theme/tokens/primitives/typography.js

@@ -1,13 +1,7 @@
 "use strict";
-/**
- * Pure typography tokens. Platform-agnostic.
- *
- * NOTE: the web build must additionally load the Inter Variable font face
- * (`Theme/chakra/fonts.web.ts` does the CSS side-effect import). That import is
- * deliberately NOT here — a CSS import would break the mobile port of this folder.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fontWeights = exports.fontSizes = exports.fonts = void 0;
+// NOTE: pure/platform-agnostic — the Inter font-face CSS import lives in Theme/chakra/fonts.web.ts, not here.
 exports.fonts = {
     body: "Inter Variable, sans-serif",
     heading: "Inter Variable, sans-serif",

package/dist/Theme/tokens/types.d.ts

@@ -1,9 +1,3 @@
-/**
- * Pure token types — shared by web (Chakra) and mobile design libraries.
- *
- * PURITY RULE: nothing under `Theme/tokens/**` may import Chakra, React, or CSS.
- * This folder is copy-paste portable to the mobile design library as-is.
- */
 /** A 50→900 color ramp. Index roles are stable across light and dark. */
 export type ColorScale = {
     50: string;
@@ -64,16 +58,22 @@ export type SidebarTokens = {
     mutedLabel: string;
     /** Status ink resolved against the RAIL. `semanticText` is canvas-relative, not rail. */
     semanticText: SemanticTextTokens;
+    /** Row fills, opaque — replace `whiteAlpha` hover/active/divider chrome on the rail. */
+    hoverBg: string;
+    activeBg: string;
+    divider: string;
+};
+export type FocusRingTokens = {
+    /** Outer band. >=3:1 against the canvas, a card surface, and the control's own fill. */
+    ring: string;
+    /** Inner band, in the surface tone. >=3:1 against the fill it hugs and against `ring`. */
+    halo: string;
 };
 export type BoxShadowTokens = {
     primary: string;
     error: string;
     default: string;
 };
-/**
- * The full per-brand color palette. One of these exists per brand per color mode
- * (`palette.light.ts` / `palette.dark.ts`).
- */
 export type PaletteProps = {
     gradient: {
         from: string;
@@ -102,6 +102,8 @@ export type PaletteProps = {
     header: ColorScale;
     placeholder: ColorScale;
     boxShadow: BoxShadowTokens;
+    /** Two-tone `:focus-visible` indicator, resolved to 3:1 (WCAG 1.4.11). Never hand-written. */
+    focusRing: FocusRingTokens;
     sidebar: SidebarTokens;
     boxborder: ColorScale;
     border: ColorScale;
@@ -109,11 +111,7 @@ export type PaletteProps = {
         hover: ColorScale;
     };
     disabled: ColorScale;
-    /**
-     * Accent color for accent-COLORED TEXT on the canvas. Distinct from `primary[500]`, which
-     * must stay dark enough to carry a white label on a filled button and therefore cannot also
-     * be light enough to read as text on a dark canvas. Derived per brand (see `pickAccentText`).
-     */
+    /** Accent color for accent-colored text on the canvas — distinct from `primary[500]`. */
     accentText: string;
     semanticText: SemanticTextTokens;
     /** Secondary text on the canvas, resolved to 4.5:1 in both modes. */
@@ -122,10 +120,12 @@ export type PaletteProps = {
     onPrimary: string;
     /** Ink for a `semantic[tone][500]`-FILLED surface — never an ink on the canvas. */
     onSemantic: SemanticTextTokens;
+    /** Dialog/drawer/popover/menu surface: `background[50]` in light, one elevation step up in dark. */
+    surfaceRaised: string;
 };
 /** What a brand writes by hand; every token required, so a gap is a compile error. */
 /** Derived tokens are excluded — `finalizeLightPalette` resolves them per brand. */
-export type BrandPaletteSource = Omit<PaletteProps, "accentText" | "textMuted" | "semanticText" | "sidebar" | "onPrimary" | "onSemantic"> & {
+export type BrandPaletteSource = Omit<PaletteProps, "accentText" | "textMuted" | "semanticText" | "sidebar" | "onPrimary" | "onSemantic" | "focusRing" | "surfaceRaised"> & {
     sidebar: {
         background: ColorScale;
     };

package/dist/Theme/tokens/types.js

@@ -1,8 +1,3 @@
 "use strict";
-/**
- * Pure token types — shared by web (Chakra) and mobile design libraries.
- *
- * PURITY RULE: nothing under `Theme/tokens/**` may import Chakra, React, or CSS.
- * This folder is copy-paste portable to the mobile design library as-is.
- */
+// NOTE: pure token types, shared with mobile — nothing under Theme/tokens/** may import Chakra, React, or CSS.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Utils/accountHandoff.d.ts

@@ -1,25 +1,8 @@
-/**
- * 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;

package/dist/Utils/accountHandoff.js

@@ -1,15 +1,5 @@
 "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.
- */
+// NOTE: pre-bundled, so this must never read import.meta.env — env-derived values come in via config.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isAllowedReturnUrl = isAllowedReturnUrl;
 exports.resolveReturnUrl = resolveReturnUrl;
@@ -32,12 +22,7 @@ function isAllowedReturnUrl(url) {
         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`.
- */
+// Receiver side (Account) — returns returnUrl only if allowlisted, else defaultReturnUrl if allowed, else null.
 function resolveReturnUrl(searchParams, fallbackOrgId, opts) {
     void fallbackOrgId;
     const returnUrl = searchParams.get("returnUrl");

package/dist/Utils/apiError.d.ts

@@ -0,0 +1,2 @@
+export declare function getApiErrorMessage(error: unknown, fallback?: string): string;
+export declare function getApiErrorStatus(error: unknown): number | null;

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`,