@techzyapp/ui-library 1.0.32 → 1.0.33

package/dist/app/AdminRoot.d.cts

@@ -1,5 +1,39 @@
 import type { ReactNode } from 'react';
-import { type ErrorBoundaryProps, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ErrorBoundaryProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ThemeColor } from '../theme';
+/** Why the session can't be used — see `AdminRootUnavailable.reason`. */
+export type AdminRootUnavailableReason = 'forbidden' | 'unreachable';
+/** The `unavailable` state of `AdminRoot` — the session could not be checked, or may not be used here. */
+export interface AdminRootUnavailable {
+    /** What failed — passed to `QueryError` (message, trace id). */
+    error: unknown;
+    /**
+     * Why. `'forbidden'` = a valid session this panel may not use (no retry, only Sign Out).
+     * `'unreachable'` = the check itself failed (Try Again + Sign Out). Defaults to `'forbidden'` when the
+     * error carries HTTP status 403 (`error.status` or `error.response.status`), else `'unreachable'`.
+     */
+    reason?: AdminRootUnavailableReason;
+    /** Re-runs the session check. Shown as "Try Again" for `'unreachable'` only. */
+    onRetry?: () => void;
+    /**
+     * The `AuthLayout` icon. Default: none — apps differ here (one shows a tinted `CloudCross`, another keeps
+     * every auth page icon-free), so it's the app's choice.
+     */
+    icon?: IconName | false;
+    /** Tint for `icon` (`AuthLayout`'s `color`). Default `'error'`. */
+    color?: ThemeColor;
+}
+/** What an `unavailableFallback` receives. */
+export interface AdminRootUnavailableFallbackProps {
+    /** The `unavailable.error`. */
+    error: unknown;
+    /** The resolved reason (explicit, or inferred from a 403). */
+    reason: AdminRootUnavailableReason;
+    /** `unavailable.onRetry`, when given — whatever the reason (the fallback decides whether to offer it). */
+    retry?: () => void;
+    /** The shell's Sign Out: `onLogout()`, then navigate to `loginPath`. */
+    signOut: () => void;
+}
 /** The minimal user shape `AdminRoot` reads — apps pass their own richer type via the generic. */
 export interface AdminUser {
     name?: string;
@@ -32,9 +66,31 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     /**
      * Wrap the page content in an `ErrorBoundary` (reset on navigation), so a crashing page shows an
      * `ErrorState` inside the shell instead of a white screen. Default `true`; `false` opts out; an object
-     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`).
+     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`). It only catches what
+     * the router doesn't: TanStack Router catches a route's component / `loader` / `beforeLoad` errors in its own
+     * per-route boundary, so page crashes need `createRouter({ defaultErrorComponent: PageError })`.
      */
     errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
+    /**
+     * The app is still finding out who is signed in (e.g. verifying a stored token or refreshing a cookie
+     * session). While `true`, AdminRoot renders only `pendingFallback` — no shell, no public page, no
+     * `AuthGuard`, and `getUser()` isn't read — so a signed-in admin is never redirected to sign-in before the
+     * check resolves. Route `beforeLoad` guards (e.g. `authLayoutRoute`) still run in the router, independent
+     * of this — they must tolerate the unknown state themselves. No minimum display time. Default `false`.
+     */
+    pending?: boolean;
+    /** What to show while `pending`. Default: a `Loader size="lg"` centred in the full viewport. */
+    pendingFallback?: ReactNode;
+    /**
+     * The session could not be checked, or the server will not serve this account here. While set, AdminRoot
+     * renders a standalone `AuthLayout` screen (the app's `logo`, a `QueryError`, Try Again / Sign Out) instead
+     * of the shell or a public page — and never redirects. Sign Out calls `onLogout` then navigates to
+     * `loginPath`, so **`onLogout` must clear whatever set `unavailable`** (or this screen shows again).
+     * `pending` wins when both are set. `null` / `undefined` = not unavailable (the default).
+     */
+    unavailable?: AdminRootUnavailable | null;
+    /** Replaces the whole `unavailable` screen — for an app that needs its own wording or extra actions. */
+    unavailableFallback?: (props: AdminRootUnavailableFallbackProps) => ReactNode;
 }
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
@@ -43,6 +99,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  * `AuthGuard` (signed-out visitors bounce to `loginPath`). Logout clears the session and navigates to
  * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (the inner `RootLayout` gets `toaster={false}`),
  * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
+ * While the app is still checking the session, pass `pending` (a full-screen loader instead of a premature
+ * sign-in redirect); when the check failed or the server refuses this account, pass `unavailable` (a
+ * standalone "Cannot Reach the Server" / "No Access" screen with Try Again / Sign Out). The `Toaster` stays
+ * mounted in both.
  *
  * `loginPath` is a plain string, cast loosely to the router's `to` type (the library can't know the
  * app's typed route tree). The generic `<U>` preserves the app's own user type through `getUser`.
@@ -50,7 +110,18 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  * @example
  * // routes/__root.tsx
  * export const Route = createRootRoute({
- *   component: () => <AdminRoot<AuthUser> logo={<Logo />} getUser={getUser} onLogout={logout} />,
+ *   component: () => {
+ *     const { status, error, retry } = useSession()
+ *     return (
+ *       <AdminRoot<AuthUser>
+ *         pending={status === 'loading'}
+ *         unavailable={status === 'unavailable' ? { error, onRetry: retry } : null}
+ *         logo={<Logo />}
+ *         getUser={getUser}
+ *         onLogout={logout}
+ *       />
+ *     )
+ *   },
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/app/AdminRoot.d.ts

@@ -1,5 +1,39 @@
 import type { ReactNode } from 'react';
-import { type ErrorBoundaryProps, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ErrorBoundaryProps, type IconName, type RootLayoutHeader, type RootLayoutProps } from '../components';
+import { type ThemeColor } from '../theme';
+/** Why the session can't be used — see `AdminRootUnavailable.reason`. */
+export type AdminRootUnavailableReason = 'forbidden' | 'unreachable';
+/** The `unavailable` state of `AdminRoot` — the session could not be checked, or may not be used here. */
+export interface AdminRootUnavailable {
+    /** What failed — passed to `QueryError` (message, trace id). */
+    error: unknown;
+    /**
+     * Why. `'forbidden'` = a valid session this panel may not use (no retry, only Sign Out).
+     * `'unreachable'` = the check itself failed (Try Again + Sign Out). Defaults to `'forbidden'` when the
+     * error carries HTTP status 403 (`error.status` or `error.response.status`), else `'unreachable'`.
+     */
+    reason?: AdminRootUnavailableReason;
+    /** Re-runs the session check. Shown as "Try Again" for `'unreachable'` only. */
+    onRetry?: () => void;
+    /**
+     * The `AuthLayout` icon. Default: none — apps differ here (one shows a tinted `CloudCross`, another keeps
+     * every auth page icon-free), so it's the app's choice.
+     */
+    icon?: IconName | false;
+    /** Tint for `icon` (`AuthLayout`'s `color`). Default `'error'`. */
+    color?: ThemeColor;
+}
+/** What an `unavailableFallback` receives. */
+export interface AdminRootUnavailableFallbackProps {
+    /** The `unavailable.error`. */
+    error: unknown;
+    /** The resolved reason (explicit, or inferred from a 403). */
+    reason: AdminRootUnavailableReason;
+    /** `unavailable.onRetry`, when given — whatever the reason (the fallback decides whether to offer it). */
+    retry?: () => void;
+    /** The shell's Sign Out: `onLogout()`, then navigate to `loginPath`. */
+    signOut: () => void;
+}
 /** The minimal user shape `AdminRoot` reads — apps pass their own richer type via the generic. */
 export interface AdminUser {
     name?: string;
@@ -32,9 +66,31 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     /**
      * Wrap the page content in an `ErrorBoundary` (reset on navigation), so a crashing page shows an
      * `ErrorState` inside the shell instead of a white screen. Default `true`; `false` opts out; an object
-     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`).
+     * configures it (e.g. `{ onError: Sentry.captureException }` or a custom `fallback`). It only catches what
+     * the router doesn't: TanStack Router catches a route's component / `loader` / `beforeLoad` errors in its own
+     * per-route boundary, so page crashes need `createRouter({ defaultErrorComponent: PageError })`.
      */
     errorBoundary?: boolean | Omit<ErrorBoundaryProps, 'children' | 'resetKeys'>;
+    /**
+     * The app is still finding out who is signed in (e.g. verifying a stored token or refreshing a cookie
+     * session). While `true`, AdminRoot renders only `pendingFallback` — no shell, no public page, no
+     * `AuthGuard`, and `getUser()` isn't read — so a signed-in admin is never redirected to sign-in before the
+     * check resolves. Route `beforeLoad` guards (e.g. `authLayoutRoute`) still run in the router, independent
+     * of this — they must tolerate the unknown state themselves. No minimum display time. Default `false`.
+     */
+    pending?: boolean;
+    /** What to show while `pending`. Default: a `Loader size="lg"` centred in the full viewport. */
+    pendingFallback?: ReactNode;
+    /**
+     * The session could not be checked, or the server will not serve this account here. While set, AdminRoot
+     * renders a standalone `AuthLayout` screen (the app's `logo`, a `QueryError`, Try Again / Sign Out) instead
+     * of the shell or a public page — and never redirects. Sign Out calls `onLogout` then navigates to
+     * `loginPath`, so **`onLogout` must clear whatever set `unavailable`** (or this screen shows again).
+     * `pending` wins when both are set. `null` / `undefined` = not unavailable (the default).
+     */
+    unavailable?: AdminRootUnavailable | null;
+    /** Replaces the whole `unavailable` screen — for an app that needs its own wording or extra actions. */
+    unavailableFallback?: (props: AdminRootUnavailableFallbackProps) => ReactNode;
 }
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
@@ -43,6 +99,10 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  * `AuthGuard` (signed-out visitors bounce to `loginPath`). Logout clears the session and navigates to
  * `loginPath`. Mounts exactly one app-wide `<Toaster/>` (the inner `RootLayout` gets `toaster={false}`),
  * and wraps the page in an `ErrorBoundary` that resets on navigation (`errorBoundary`, default on).
+ * While the app is still checking the session, pass `pending` (a full-screen loader instead of a premature
+ * sign-in redirect); when the check failed or the server refuses this account, pass `unavailable` (a
+ * standalone "Cannot Reach the Server" / "No Access" screen with Try Again / Sign Out). The `Toaster` stays
+ * mounted in both.
  *
  * `loginPath` is a plain string, cast loosely to the router's `to` type (the library can't know the
  * app's typed route tree). The generic `<U>` preserves the app's own user type through `getUser`.
@@ -50,7 +110,18 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  * @example
  * // routes/__root.tsx
  * export const Route = createRootRoute({
- *   component: () => <AdminRoot<AuthUser> logo={<Logo />} getUser={getUser} onLogout={logout} />,
+ *   component: () => {
+ *     const { status, error, retry } = useSession()
+ *     return (
+ *       <AdminRoot<AuthUser>
+ *         pending={status === 'loading'}
+ *         unavailable={status === 'unavailable' ? { error, onRetry: retry } : null}
+ *         logo={<Logo />}
+ *         getUser={getUser}
+ *         onLogout={logout}
+ *       />
+ *     )
+ *   },
  * })
  */
-export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Alert/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Alert-B9l1VhIr.cjs");exports.Alert=e.Alert;exports.default=e.Alert;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Alert-CfjDmLR8.cjs");exports.Alert=e.Alert;exports.default=e.Alert;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Alert/index.js

@@ -1,4 +1,4 @@
-import { A as r, A as t } from "../../Alert-B7w9xD2p.js";
+import { A as r, A as t } from "../../Alert-LJDrtkJy.js";
 export {
   r as Alert,
   t as default

package/dist/components/Breadcrumbs/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Breadcrumbs-B1JMwCjO.cjs");exports.Breadcrumbs=e.Breadcrumbs;exports.default=e.Breadcrumbs;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Breadcrumbs-COb2zmDk.cjs");exports.Breadcrumbs=e.Breadcrumbs;exports.default=e.Breadcrumbs;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Breadcrumbs/index.js

@@ -1,4 +1,4 @@
-import { B as e, B as s } from "../../Breadcrumbs-Cl1CgKkk.js";
+import { B as e, B as s } from "../../Breadcrumbs-DYeVrOns.js";
 export {
   e as Breadcrumbs,
   s as default

package/dist/components/Button/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../Button-BZq1mIUH.cjs");exports.Button=t.Button;exports.default=t.Button;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../Button-BD5wpg-t.cjs");exports.Button=t.Button;exports.default=t.Button;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Button/index.js

@@ -1,4 +1,4 @@
-import { B as o, B } from "../../Button-BJ5Xd10u.js";
+import { B as o, B } from "../../Button-PBZnkRNn.js";
 export {
   o as Button,
   B as default

package/dist/components/Card/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Card-KsczbH5c.cjs");exports.Card=e.Card;exports.default=e.Card;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Card-DL7XnkOA.cjs");exports.Card=e.Card;exports.default=e.Card;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Card/index.js

@@ -1,4 +1,4 @@
-import { C, C as d } from "../../Card-Cr3D2bzJ.js";
+import { C, C as d } from "../../Card-CV_rHego.js";
 export {
   C as Card,
   d as default

package/dist/components/Chip/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Chip-BZ3I4Lbe.cjs");exports.Chip=e.Chip;exports.default=e.Chip;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Chip-CLPIPC9a.cjs");exports.Chip=e.Chip;exports.default=e.Chip;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Chip/index.js

@@ -1,4 +1,4 @@
-import { C as e, C as f } from "../../Chip-DEp1zWh1.js";
+import { C as e, C as f } from "../../Chip-DdOUVF0Z.js";
 export {
   e as Chip,
   f as default

package/dist/components/CodeBlock/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../CodeBlock-DIkyeG4S.cjs");exports.CodeBlock=e.CodeBlock;exports.default=e.CodeBlock;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../CodeBlock-C0dbyxcl.cjs");exports.CodeBlock=e.CodeBlock;exports.default=e.CodeBlock;
 //# sourceMappingURL=index.cjs.map

package/dist/components/CodeBlock/index.js

@@ -1,4 +1,4 @@
-import { C as e, C } from "../../CodeBlock-CMHqvoBJ.js";
+import { C as e, C } from "../../CodeBlock-B35NXZzd.js";
 export {
   e as CodeBlock,
   C as default

package/dist/components/ColorPicker/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorPicker-B1riGs1z.cjs");exports.ColorPicker=e.ColorPicker;exports.default=e.ColorPicker;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorPicker-DmLGKaYF.cjs");exports.ColorPicker=e.ColorPicker;exports.default=e.ColorPicker;
 //# sourceMappingURL=index.cjs.map

package/dist/components/ColorPicker/index.js

@@ -1,4 +1,4 @@
-import { C as a, C as e } from "../../ColorPicker-5SMyU5oh.js";
+import { C as a, C as e } from "../../ColorPicker-6UraVYFy.js";
 export {
   a as ColorPicker,
   e as default

package/dist/components/ColorRamp/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorRamp-D_h-hp7n.cjs");exports.ColorRamp=e.ColorRamp;exports.default=e.ColorRamp;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ColorRamp-D_9gsqJl.cjs");exports.ColorRamp=e.ColorRamp;exports.default=e.ColorRamp;
 //# sourceMappingURL=index.cjs.map

package/dist/components/ColorRamp/index.js

@@ -1,4 +1,4 @@
-import { C as r, C } from "../../ColorRamp-Qc8ZtPDh.js";
+import { C as r, C } from "../../ColorRamp-CSqzzHZx.js";
 export {
   r as ColorRamp,
   C as default

package/dist/components/CopyButton/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../CopyButton-DUtx2-Gi.cjs");exports.CopyButton=t.CopyButton;exports.default=t.CopyButton;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../CopyButton-0w4OToIy.cjs");exports.CopyButton=t.CopyButton;exports.default=t.CopyButton;
 //# sourceMappingURL=index.cjs.map

package/dist/components/CopyButton/index.js

@@ -1,4 +1,4 @@
-import { C as a, C } from "../../CopyButton-BNcW9-KU.js";
+import { C as a, C } from "../../CopyButton-B_mYxcXV.js";
 export {
   a as CopyButton,
   C as default

package/dist/components/DatePicker/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DatePicker-D_PqDvKt.cjs");exports.DatePicker=e.DatePicker;exports.default=e.DatePicker;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DatePicker-D1uFIm3M.cjs");exports.DatePicker=e.DatePicker;exports.default=e.DatePicker;
 //# sourceMappingURL=index.cjs.map

package/dist/components/DatePicker/index.js

@@ -1,4 +1,4 @@
-import { D as r, D as t } from "../../DatePicker-D2PyGdec.js";
+import { D as r, D as t } from "../../DatePicker-Bt-M87zX.js";
 export {
   r as DatePicker,
   t as default

package/dist/components/DateTimePicker/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DateTimePicker-C3Kq5hKE.cjs");exports.DateTimePicker=e.DateTimePicker;exports.default=e.DateTimePicker;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DateTimePicker-DPt-LDVJ.cjs");exports.DateTimePicker=e.DateTimePicker;exports.default=e.DateTimePicker;
 //# sourceMappingURL=index.cjs.map

package/dist/components/DateTimePicker/index.js

@@ -1,4 +1,4 @@
-import { D as r, D as t } from "../../DateTimePicker-DdXFzqO_.js";
+import { D as r, D as t } from "../../DateTimePicker-zJUc9crs.js";
 export {
   r as DateTimePicker,
   t as default

package/dist/components/DescriptionList/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DescriptionList-C7AOcw_2.cjs");exports.DescriptionList=e.DescriptionList;exports.default=e.DescriptionList;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../DescriptionList-CPCbzU9b.cjs");exports.DescriptionList=e.DescriptionList;exports.default=e.DescriptionList;
 //# sourceMappingURL=index.cjs.map

package/dist/components/DescriptionList/index.js

@@ -1,4 +1,4 @@
-import { D as a, D as e } from "../../DescriptionList-DxRgKNEJ.js";
+import { D as a, D as e } from "../../DescriptionList-BLx9NfAW.js";
 export {
   a as DescriptionList,
   e as default

package/dist/components/EmptyState/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../EmptyState-ECc6e_En.cjs");exports.EmptyState=t.EmptyState;exports.default=t.EmptyState;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../EmptyState-C54C0Qwc.cjs");exports.EmptyState=t.EmptyState;exports.default=t.EmptyState;
 //# sourceMappingURL=index.cjs.map

package/dist/components/EmptyState/index.js

@@ -1,4 +1,4 @@
-import { E as e, E } from "../../EmptyState-CvpKSYY4.js";
+import { E as e, E } from "../../EmptyState-BEVEGcLx.js";
 export {
   e as EmptyState,
   E as default

package/dist/components/ErrorState/ErrorBoundary.d.cts

@@ -2,12 +2,12 @@ import { Component, type ErrorInfo, type ReactNode } from 'react';
 export interface ErrorBoundaryProps {
     /**
      * What to render after a crash — a node, or `(error, reset) => node`. Defaults to an `ErrorState` with
-     * a friendly description, a **Try again** button (`reset`) and the stack in dev.
+     * a friendly description, a **Try Again** button (`reset`) and the stack in dev.
      */
     fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
     /** Report the crash (e.g. `Sentry.captureException`). */
     onError?: (error: Error, info: ErrorInfo) => void;
-    /** Called after the boundary resets (Try again, or a `resetKeys` change). */
+    /** Called after the boundary resets (Try Again, or a `resetKeys` change). */
     onReset?: () => void;
     /** Reset automatically when any of these change (shallow) — e.g. `[location.pathname]` clears on navigation. */
     resetKeys?: unknown[];
@@ -19,7 +19,7 @@ interface ErrorBoundaryState {
 /**
  * Catches render errors in its subtree and shows a fallback instead of unmounting the whole app (a
  * white screen). The one class component in the library — React only offers error boundaries as
- * classes. `fallback` is a node or `(error, reset) => node` (default: an `ErrorState` with Try again);
+ * classes. `fallback` is a node or `(error, reset) => node` (default: an `ErrorState` with Try Again);
  * `onError` reports the crash (Sentry); `resetKeys` resets it when they change (e.g. the route path, so
  * navigating away recovers); `onReset` runs after any reset. `AdminRoot` mounts one around the page
  * content automatically, so a crashing page keeps the sidebar + header.

package/dist/components/ErrorState/ErrorBoundary.d.ts

@@ -2,12 +2,12 @@ import { Component, type ErrorInfo, type ReactNode } from 'react';
 export interface ErrorBoundaryProps {
     /**
      * What to render after a crash — a node, or `(error, reset) => node`. Defaults to an `ErrorState` with
-     * a friendly description, a **Try again** button (`reset`) and the stack in dev.
+     * a friendly description, a **Try Again** button (`reset`) and the stack in dev.
      */
     fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
     /** Report the crash (e.g. `Sentry.captureException`). */
     onError?: (error: Error, info: ErrorInfo) => void;
-    /** Called after the boundary resets (Try again, or a `resetKeys` change). */
+    /** Called after the boundary resets (Try Again, or a `resetKeys` change). */
     onReset?: () => void;
     /** Reset automatically when any of these change (shallow) — e.g. `[location.pathname]` clears on navigation. */
     resetKeys?: unknown[];
@@ -19,7 +19,7 @@ interface ErrorBoundaryState {
 /**
  * Catches render errors in its subtree and shows a fallback instead of unmounting the whole app (a
  * white screen). The one class component in the library — React only offers error boundaries as
- * classes. `fallback` is a node or `(error, reset) => node` (default: an `ErrorState` with Try again);
+ * classes. `fallback` is a node or `(error, reset) => node` (default: an `ErrorState` with Try Again);
  * `onError` reports the crash (Sentry); `resetKeys` resets it when they change (e.g. the route path, so
  * navigating away recovers); `onReset` runs after any reset. `AdminRoot` mounts one around the page
  * content automatically, so a crashing page keeps the sidebar + header.

package/dist/components/ErrorState/ErrorState.d.cts

@@ -1,20 +1,41 @@
 import { type ReactNode } from 'react';
 import { type EmptyStateProps } from '../EmptyState';
 import type { IconName } from '../../icons/names';
+export type ErrorStateVariant = 'block' | 'alert';
 export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title' | 'color'> {
+    /**
+     * The shape. `'block'` (default) — the `EmptyState`-style block (puck, title, centred message), for a read
+     * that failed where its data would be. `'alert'` — a one-line red `Alert` banner for a **failed save**
+     * above a form or in a modal, where the form stays on screen: the message (no default title), a muted
+     * trace id line, and the copy / retry / `action` buttons in the alert's action slot. `showDetails`,
+     * `compact` and `pattern` don't apply to `'alert'`.
+     */
+    variant?: ErrorStateVariant;
     /**
      * What failed — an `Error`, a string, an axios-style error, a `{ message }` or a raw `{ status }`
      * response. Its message becomes the description (unless `description` is given) and its stack feeds
      * the details panel.
      */
     error?: unknown;
-    /** Heading. Defaults to the localized "Something went wrong". */
+    /**
+     * Heading. Block: defaults to the localized "Something Went Wrong". Alert: none unless given — the message
+     * is the point.
+     */
     title?: ReactNode;
-    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger`, tinted `error`. */
+    /**
+     * Leading icon — a known `IconName`, any node, or `false`. Block: defaults to `Danger` (or `CloudCross` when
+     * the request never got a response — an explicit `status: 0` / network error code), tinted `error`. Alert:
+     * the alert's own error icon unless overridden.
+     */
     icon?: IconName | ReactNode | false;
-    /** Adds a "Try again" button that calls this (e.g. a query's `refetch`). */
+    /** Adds a "Try Again" button that calls this (e.g. a query's `refetch`). */
     onRetry?: () => void;
-    /** Retry button label. Defaults to the localized "Try again". */
+    /**
+     * The retry is running (e.g. `query.isFetching`) — the "Try Again" button shows its loader and is disabled,
+     * so a slow refetch doesn't look like a dead click. Defaults to `false`.
+     */
+    retrying?: boolean;
+    /** Retry button label. Defaults to the localized "Try Again". */
     retryLabel?: ReactNode;
     /**
      * Show a collapsible technical details panel (stack / raw error). `'dev'` (default) shows it only in
@@ -30,19 +51,26 @@ export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title'
     traceId?: string | false;
     /**
      * Per-field validation messages (`{ field: message }`), listed as the description when there's no explicit
-     * `description`. Defaults to the ones on `error` (`error.fieldErrors` / `error.response.data.errors`);
-     * `false` hides them. In a form, put them on the inputs instead.
+     * `description`. Defaults to the ones on `error` (`getErrorFieldErrors`: `error.fieldErrors` — an object, a
+     * method or a `{ field, message }[]` —, `error.details`, `error.response.data.errors`); `false` hides them. In a form, put them on the inputs instead.
      */
     fieldErrors?: Record<string, string> | false;
+    /**
+     * Labels for the field-error keys (`{ newPassword: 'New Password' }`). A key without one is shown humanized
+     * and Title Cased (`newPassword` / `new_password` → "New Password"; a dotted path keeps its last segment).
+     */
+    fieldLabels?: Record<string, ReactNode>;
 }
 /**
  * The "loading failed" counterpart of `EmptyState` — a semantic preset over it: an `error`-tinted
- * `Danger` puck, a localized "Something went wrong" title, the failure's own message as the description
+ * `Danger` puck, a localized "Something Went Wrong" title, the failure's own message as the description
  * (extracted from an `Error`, a string, an axios-style `response.data.message`, a `{ message }`, or a raw
- * `{ status }` response → "Request failed (404)"), an optional **Try again** button (`onRetry`), and a
+ * `{ status }` response → "Request failed (404)"), an optional **Try Again** button (`onRetry`), and a
  * developer-only details panel with the stack (`showDetails`, default `'dev'`). `compact` is the inline
  * variant for a table / card. The server's `traceId` (copyable) and a 400's per-field `fieldErrors` are shown
- * when the error carries them. Announced to assistive tech (`role="alert"`, `aria-live="polite"`).
+ * when the error carries them. `variant="alert"` renders the same data as a one-line `Alert` banner — for a
+ * failed save above a form or in a modal. `retrying` puts the retry button in its loading state. Announced to
+ * assistive tech once (`role="alert"`).
  * `forwardRef` to the root; any other `EmptyState` prop (`size`, `pattern`, `action`, …) passes through.
  */
 export declare const ErrorState: import("react").ForwardRefExoticComponent<ErrorStateProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/ErrorState/ErrorState.d.ts

@@ -1,20 +1,41 @@
 import { type ReactNode } from 'react';
 import { type EmptyStateProps } from '../EmptyState';
 import type { IconName } from '../../icons/names';
+export type ErrorStateVariant = 'block' | 'alert';
 export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title' | 'color'> {
+    /**
+     * The shape. `'block'` (default) — the `EmptyState`-style block (puck, title, centred message), for a read
+     * that failed where its data would be. `'alert'` — a one-line red `Alert` banner for a **failed save**
+     * above a form or in a modal, where the form stays on screen: the message (no default title), a muted
+     * trace id line, and the copy / retry / `action` buttons in the alert's action slot. `showDetails`,
+     * `compact` and `pattern` don't apply to `'alert'`.
+     */
+    variant?: ErrorStateVariant;
     /**
      * What failed — an `Error`, a string, an axios-style error, a `{ message }` or a raw `{ status }`
      * response. Its message becomes the description (unless `description` is given) and its stack feeds
      * the details panel.
      */
     error?: unknown;
-    /** Heading. Defaults to the localized "Something went wrong". */
+    /**
+     * Heading. Block: defaults to the localized "Something Went Wrong". Alert: none unless given — the message
+     * is the point.
+     */
     title?: ReactNode;
-    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger`, tinted `error`. */
+    /**
+     * Leading icon — a known `IconName`, any node, or `false`. Block: defaults to `Danger` (or `CloudCross` when
+     * the request never got a response — an explicit `status: 0` / network error code), tinted `error`. Alert:
+     * the alert's own error icon unless overridden.
+     */
     icon?: IconName | ReactNode | false;
-    /** Adds a "Try again" button that calls this (e.g. a query's `refetch`). */
+    /** Adds a "Try Again" button that calls this (e.g. a query's `refetch`). */
     onRetry?: () => void;
-    /** Retry button label. Defaults to the localized "Try again". */
+    /**
+     * The retry is running (e.g. `query.isFetching`) — the "Try Again" button shows its loader and is disabled,
+     * so a slow refetch doesn't look like a dead click. Defaults to `false`.
+     */
+    retrying?: boolean;
+    /** Retry button label. Defaults to the localized "Try Again". */
     retryLabel?: ReactNode;
     /**
      * Show a collapsible technical details panel (stack / raw error). `'dev'` (default) shows it only in
@@ -30,19 +51,26 @@ export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title'
     traceId?: string | false;
     /**
      * Per-field validation messages (`{ field: message }`), listed as the description when there's no explicit
-     * `description`. Defaults to the ones on `error` (`error.fieldErrors` / `error.response.data.errors`);
-     * `false` hides them. In a form, put them on the inputs instead.
+     * `description`. Defaults to the ones on `error` (`getErrorFieldErrors`: `error.fieldErrors` — an object, a
+     * method or a `{ field, message }[]` —, `error.details`, `error.response.data.errors`); `false` hides them. In a form, put them on the inputs instead.
      */
     fieldErrors?: Record<string, string> | false;
+    /**
+     * Labels for the field-error keys (`{ newPassword: 'New Password' }`). A key without one is shown humanized
+     * and Title Cased (`newPassword` / `new_password` → "New Password"; a dotted path keeps its last segment).
+     */
+    fieldLabels?: Record<string, ReactNode>;
 }
 /**
  * The "loading failed" counterpart of `EmptyState` — a semantic preset over it: an `error`-tinted
- * `Danger` puck, a localized "Something went wrong" title, the failure's own message as the description
+ * `Danger` puck, a localized "Something Went Wrong" title, the failure's own message as the description
  * (extracted from an `Error`, a string, an axios-style `response.data.message`, a `{ message }`, or a raw
- * `{ status }` response → "Request failed (404)"), an optional **Try again** button (`onRetry`), and a
+ * `{ status }` response → "Request failed (404)"), an optional **Try Again** button (`onRetry`), and a
  * developer-only details panel with the stack (`showDetails`, default `'dev'`). `compact` is the inline
  * variant for a table / card. The server's `traceId` (copyable) and a 400's per-field `fieldErrors` are shown
- * when the error carries them. Announced to assistive tech (`role="alert"`, `aria-live="polite"`).
+ * when the error carries them. `variant="alert"` renders the same data as a one-line `Alert` banner — for a
+ * failed save above a form or in a modal. `retrying` puts the retry button in its loading state. Announced to
+ * assistive tech once (`role="alert"`).
  * `forwardRef` to the root; any other `EmptyState` prop (`size`, `pattern`, `action`, …) passes through.
  */
 export declare const ErrorState: import("react").ForwardRefExoticComponent<ErrorStateProps & import("react").RefAttributes<HTMLDivElement>>;