@techzyapp/ui-library 1.0.32 → 1.0.33

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

@@ -1,3 +1,11 @@
+/**
+ * Internal (not in the barrel): a development build? Read per call (not at import) so a test can switch modes.
+ * Written as the bare `process.env.NODE_ENV` member expression on purpose — that's the exact text bundlers
+ * replace (Vite / esbuild / webpack `define`). A `typeof process` guard would NOT be replaced and is `false`
+ * in every browser, hiding dev-only UI in development too; with no bundler define and no `process`, the
+ * `ReferenceError` lands in the `catch` → production.
+ */
+export declare function isDev(): boolean;
 /**
  * Pull a human-readable message out of whatever was thrown / returned — the shapes admin apps actually see:
  *
@@ -19,8 +27,32 @@ export declare function getErrorDetails(error: unknown): string | undefined;
  */
 export declare function getErrorTraceId(error: unknown): string | undefined;
 /**
- * Per-field validation messages of a `400` — `{ field: 'message' }`. Read from `error.fieldErrors` (an app
- * `ApiError`) or an axios-style `error.response.data.errors` (ASP.NET sends a string **or** an array of
- * strings per field — the first string wins). `undefined` when there are none.
+ * Per-field validation messages of a `400` — `{ field: 'message' }`. Tolerant of the shapes apps actually have:
+ *
+ * - `error.fieldErrors` — an object (`{ field: message }`), **a method returning one** (an app `ApiError`
+ *   exposing `fieldErrors()`), or an array of `{ field, message }`;
+ * - `error.details` — an array of `{ field, message }` (a common response-envelope shape);
+ * - axios-style `error.response.data.errors` — an object (ASP.NET: a string **or** an array of strings per
+ *   field; the first string wins) or an array of `{ field, message }`.
+ *
+ * In a list the first message per field wins. `undefined` when there are none.
  */
 export declare function getErrorFieldErrors(error: unknown): Record<string, string> | undefined;
+/**
+ * A field key as UI text: the last segment of a dotted path, split on camelCase / snake_case / kebab-case and
+ * Title Cased — `newPassword` / `NewPassword` / `new_password` → `"New Password"`, `address.zipCode` → `"Zip
+ * Code"`.
+ */
+export declare function humanizeField(key: string): string;
+/** The HTTP status on an error — `error.status` or axios-style `error.response.status` — when it's a number. */
+export declare function getErrorStatus(error: unknown): number | undefined;
+/**
+ * Whether the error came back **from the server** (a `traceId` or a numeric status other than `0`) — such a
+ * message is written for people. A render crash's message ("Cannot read properties of undefined") isn't.
+ */
+export declare function isServerError(error: unknown): boolean;
+/**
+ * Whether the request **never got a response** — only when the error says so explicitly: a `status` of `0`, or
+ * a network error code (`'network_error'`, or axios' `'ERR_NETWORK'`). No guessing from messages.
+ */
+export declare function isNetworkError(error: unknown): boolean;

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

@@ -1,3 +1,11 @@
+/**
+ * Internal (not in the barrel): a development build? Read per call (not at import) so a test can switch modes.
+ * Written as the bare `process.env.NODE_ENV` member expression on purpose — that's the exact text bundlers
+ * replace (Vite / esbuild / webpack `define`). A `typeof process` guard would NOT be replaced and is `false`
+ * in every browser, hiding dev-only UI in development too; with no bundler define and no `process`, the
+ * `ReferenceError` lands in the `catch` → production.
+ */
+export declare function isDev(): boolean;
 /**
  * Pull a human-readable message out of whatever was thrown / returned — the shapes admin apps actually see:
  *
@@ -19,8 +27,32 @@ export declare function getErrorDetails(error: unknown): string | undefined;
  */
 export declare function getErrorTraceId(error: unknown): string | undefined;
 /**
- * Per-field validation messages of a `400` — `{ field: 'message' }`. Read from `error.fieldErrors` (an app
- * `ApiError`) or an axios-style `error.response.data.errors` (ASP.NET sends a string **or** an array of
- * strings per field — the first string wins). `undefined` when there are none.
+ * Per-field validation messages of a `400` — `{ field: 'message' }`. Tolerant of the shapes apps actually have:
+ *
+ * - `error.fieldErrors` — an object (`{ field: message }`), **a method returning one** (an app `ApiError`
+ *   exposing `fieldErrors()`), or an array of `{ field, message }`;
+ * - `error.details` — an array of `{ field, message }` (a common response-envelope shape);
+ * - axios-style `error.response.data.errors` — an object (ASP.NET: a string **or** an array of strings per
+ *   field; the first string wins) or an array of `{ field, message }`.
+ *
+ * In a list the first message per field wins. `undefined` when there are none.
  */
 export declare function getErrorFieldErrors(error: unknown): Record<string, string> | undefined;
+/**
+ * A field key as UI text: the last segment of a dotted path, split on camelCase / snake_case / kebab-case and
+ * Title Cased — `newPassword` / `NewPassword` / `new_password` → `"New Password"`, `address.zipCode` → `"Zip
+ * Code"`.
+ */
+export declare function humanizeField(key: string): string;
+/** The HTTP status on an error — `error.status` or axios-style `error.response.status` — when it's a number. */
+export declare function getErrorStatus(error: unknown): number | undefined;
+/**
+ * Whether the error came back **from the server** (a `traceId` or a numeric status other than `0`) — such a
+ * message is written for people. A render crash's message ("Cannot read properties of undefined") isn't.
+ */
+export declare function isServerError(error: unknown): boolean;
+/**
+ * Whether the request **never got a response** — only when the error says so explicitly: a `status` of `0`, or
+ * a network error code (`'network_error'`, or axios' `'ERR_NETWORK'`). No guessing from messages.
+ */
+export declare function isNetworkError(error: unknown): boolean;

package/dist/components/ErrorState/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../ErrorBoundary-DbKRtdgS.cjs"),e=require("../../QueryError-RF7Mh5zg.cjs");exports.ErrorBoundary=r.ErrorBoundary;exports.ErrorState=r.ErrorState;exports.default=r.ErrorState;exports.getErrorDetails=r.getErrorDetails;exports.getErrorFieldErrors=r.getErrorFieldErrors;exports.getErrorMessage=r.getErrorMessage;exports.getErrorTraceId=r.getErrorTraceId;exports.QueryError=e.QueryError;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ErrorState-BXMjBWav.cjs"),o=require("../../ErrorBoundary-8iu-mR5Y.cjs"),r=require("../../errorMessage-C7N4KvUS.cjs");exports.ErrorState=e.ErrorState;exports.default=e.ErrorState;exports.ErrorBoundary=o.ErrorBoundary;exports.QueryError=o.QueryError;exports.getErrorDetails=r.getErrorDetails;exports.getErrorFieldErrors=r.getErrorFieldErrors;exports.getErrorMessage=r.getErrorMessage;exports.getErrorStatus=r.getErrorStatus;exports.getErrorTraceId=r.getErrorTraceId;exports.humanizeField=r.humanizeField;exports.isNetworkError=r.isNetworkError;exports.isServerError=r.isServerError;
 //# sourceMappingURL=index.cjs.map

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

@@ -1,7 +1,7 @@
 export { ErrorState, ErrorState as default } from './ErrorState';
-export type { ErrorStateProps } from './ErrorState';
+export type { ErrorStateProps, ErrorStateVariant } from './ErrorState';
 export { QueryError } from './QueryError';
 export type { QueryErrorProps } from './QueryError';
 export { ErrorBoundary } from './ErrorBoundary';
 export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, } from './errorMessage';
+export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, getErrorStatus, humanizeField, isNetworkError, isServerError, } from './errorMessage';

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

@@ -1,7 +1,7 @@
 export { ErrorState, ErrorState as default } from './ErrorState';
-export type { ErrorStateProps } from './ErrorState';
+export type { ErrorStateProps, ErrorStateVariant } from './ErrorState';
 export { QueryError } from './QueryError';
 export type { QueryErrorProps } from './QueryError';
 export { ErrorBoundary } from './ErrorBoundary';
 export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, } from './errorMessage';
+export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, getErrorStatus, humanizeField, isNetworkError, isServerError, } from './errorMessage';

package/dist/components/ErrorState/index.js

@@ -1,13 +1,18 @@
-import { E as e, a as o, a as s, g as t, b as E, c as g, d } from "../../ErrorBoundary-CJx5E9wJ.js";
-import { Q as l } from "../../QueryError-Dl8yzdxw.js";
+import { E as a, E as o } from "../../ErrorState-DKhZ4aJh.js";
+import { E as t, Q as E } from "../../ErrorBoundary-BSJL381Y.js";
+import { g as i, a as d, b as u, c as f, d as l, h as m, i as p, e as x } from "../../errorMessage-C83fB2h5.js";
 export {
-  e as ErrorBoundary,
-  o as ErrorState,
-  l as QueryError,
-  s as default,
-  t as getErrorDetails,
-  E as getErrorFieldErrors,
-  g as getErrorMessage,
-  d as getErrorTraceId
+  t as ErrorBoundary,
+  a as ErrorState,
+  E as QueryError,
+  o as default,
+  i as getErrorDetails,
+  d as getErrorFieldErrors,
+  u as getErrorMessage,
+  f as getErrorStatus,
+  l as getErrorTraceId,
+  m as humanizeField,
+  p as isNetworkError,
+  x as isServerError
 };
 //# sourceMappingURL=index.js.map

package/dist/components/ErrorState/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/components/FileCard/index.cjs

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

package/dist/components/FileCard/index.js

@@ -1,4 +1,4 @@
-import { F as r, F } from "../../FileCard-D4t0-ms2.js";
+import { F as r, F } from "../../FileCard-R_sB8Qbx.js";
 export {
   r as FileCard,
   F as default

package/dist/components/FileUploader/index.cjs

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

package/dist/components/FileUploader/index.js

@@ -1,4 +1,4 @@
-import { F as l, F as o } from "../../FileUploader-DdcvZoUb.js";
+import { F as l, F as o } from "../../FileUploader-B55atuxq.js";
 export {
   l as FileUploader,
   o as default

package/dist/components/Flag/index.cjs

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

package/dist/components/Flag/index.js

@@ -1,4 +1,4 @@
-import { F as e, F as f } from "../../Flag-BLEBMdb-.js";
+import { F as e, F as f } from "../../Flag-D7fmMqqy.js";
 export {
   e as Flag,
   f as default

package/dist/components/FullscreenToggle/index.cjs

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

package/dist/components/FullscreenToggle/index.js

@@ -1,4 +1,4 @@
-import { F as a, F as o } from "../../FullscreenToggle-DZnKK1Lj.js";
+import { F as a, F as o } from "../../FullscreenToggle-CXmPqxJv.js";
 export {
   a as FullscreenToggle,
   o as default

package/dist/components/IconButton/index.cjs

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

package/dist/components/IconButton/index.js

@@ -1,4 +1,4 @@
-import { I as a, I } from "../../IconButton-CqFgam3J.js";
+import { I as a, I } from "../../IconButton-sC_E_TXd.js";
 export {
   a as IconButton,
   I as default

package/dist/components/Loader/index.cjs

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

package/dist/components/Loader/index.js

@@ -1,4 +1,4 @@
-import { L as o, L as r } from "../../Loader-Bsz0BkGr.js";
+import { L as o, L as r } from "../../Loader-ChrouvaR.js";
 export {
   o as Loader,
   r as default

package/dist/components/LocationPicker/index.cjs

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

package/dist/components/LocationPicker/index.js

@@ -1,4 +1,4 @@
-import { L, T as e, L as r } from "../../LocationPicker-DtMDpPFZ.js";
+import { L, T as e, L as r } from "../../LocationPicker-DxiQ27k6.js";
 export {
   L as LocationPicker,
   e as TBILISI,

package/dist/components/Modal/index.cjs

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

package/dist/components/Modal/index.js

@@ -1,4 +1,4 @@
-import { M, M as d } from "../../Modal-DCee1a9m.js";
+import { M, M as d } from "../../Modal-Do8pzyMl.js";
 export {
   M as Modal,
   d as default

package/dist/components/MultiSelect/MultiSelect.d.cts

@@ -44,7 +44,7 @@ export interface MultiSelectProps {
     /** Text shown next to the loader while `loading`. Defaults to `"Loading…"`. */
     loadingText?: ReactNode;
     /**
-     * Shown in the popover when no option matches. Defaults to `"No options"`. Pass a function
+     * Shown in the popover when no option matches. Defaults to `"No Options"`. Pass a function
      * `(query) => node` to vary the message by the current search text — e.g. a "Type to search" hint
      * while it's empty vs a "No results" message after typing.
      */

package/dist/components/MultiSelect/MultiSelect.d.ts

@@ -44,7 +44,7 @@ export interface MultiSelectProps {
     /** Text shown next to the loader while `loading`. Defaults to `"Loading…"`. */
     loadingText?: ReactNode;
     /**
-     * Shown in the popover when no option matches. Defaults to `"No options"`. Pass a function
+     * Shown in the popover when no option matches. Defaults to `"No Options"`. Pass a function
      * `(query) => node` to vary the message by the current search text — e.g. a "Type to search" hint
      * while it's empty vs a "No results" message after typing.
      */

package/dist/components/MultiSelect/index.cjs

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

package/dist/components/MultiSelect/index.js

@@ -1,4 +1,4 @@
-import { M as a, M as l } from "../../MultiSelect-JQ6iKHyI.js";
+import { M as a, M as l } from "../../MultiSelect-BfsEdXNa.js";
 export {
   a as MultiSelect,
   l as default

package/dist/components/NumberField/index.cjs

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

package/dist/components/NumberField/index.js

@@ -1,4 +1,4 @@
-import { N as r, N } from "../../NumberField-Bf-vDNLy.js";
+import { N as r, N } from "../../NumberField-P68n6q5m.js";
 export {
   r as NumberField,
   N as default

package/dist/components/OptionMenu/OptionMenu.d.cts

@@ -14,7 +14,7 @@ export interface OptionMenuProps {
     loading?: boolean;
     /** Text next to the loader. Defaults to the localized "Loading…". */
     loadingText?: ReactNode;
-    /** Empty-result content — a node or `(query) => node`. Defaults to the localized "No options". */
+    /** Empty-result content — a node or `(query) => node`. Defaults to the localized "No Options". */
     noOptionsText?: ReactNode | ((query: string) => ReactNode);
     /** Tick the selected option(s). Defaults to `true`. */
     showSelectedTick?: boolean;

package/dist/components/OptionMenu/OptionMenu.d.ts

@@ -14,7 +14,7 @@ export interface OptionMenuProps {
     loading?: boolean;
     /** Text next to the loader. Defaults to the localized "Loading…". */
     loadingText?: ReactNode;
-    /** Empty-result content — a node or `(query) => node`. Defaults to the localized "No options". */
+    /** Empty-result content — a node or `(query) => node`. Defaults to the localized "No Options". */
     noOptionsText?: ReactNode | ((query: string) => ReactNode);
     /** Tick the selected option(s). Defaults to `true`. */
     showSelectedTick?: boolean;

package/dist/components/OtpField/index.cjs

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

package/dist/components/OtpField/index.js

@@ -1,4 +1,4 @@
-import { O as t, O } from "../../OtpField-DaAIBp6C.js";
+import { O as t, O } from "../../OtpField-DjTJH4Kh.js";
 export {
   t as OtpField,
   O as default

package/dist/components/PageError/PageError.d.cts

@@ -0,0 +1,53 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import type { IconName } from '../../icons/names';
+import type { EmptyStateSize } from '../EmptyState';
+export interface PageErrorProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
+    /** What the route threw (TanStack Router's `ErrorComponentProps.error`). */
+    error: unknown;
+    /** Resets the route's error boundary (TanStack Router's `ErrorComponentProps.reset`). */
+    reset?: () => void;
+    /** The React component stack (TanStack Router's `ErrorComponentProps.info`) — unused, accepted for typing. */
+    info?: {
+        componentStack: string;
+    };
+    /**
+     * Runs **before** the reset on "Try Again" (may be async) — where an app drops cached data, e.g.
+     * `() => queryClient.resetQueries({ predicate: (q) => q.queryKey[0] !== 'session' })`. Without it, `reset()`
+     * re-renders against the same cached response and throws on the same data again.
+     */
+    onRetry?: () => void | Promise<void>;
+    /**
+     * Show the error's own message. Default: when it looks **server-originated** (a `traceId` or a numeric
+     * `status` — written for people) or in development; otherwise the localized generic sentence (a render
+     * crash's message is a developer's). `true` / `false` force it; `'dev'` = development only; a function decides
+     * per error.
+     */
+    showMessage?: boolean | 'dev' | ((error: unknown) => boolean);
+    /** A secondary "Go to Home" button to the first allowed menu page (RBAC-aware). Defaults to `true`. */
+    showHome?: boolean;
+    /** Heading. Defaults to the localized "This Page Could Not Be Shown". */
+    title?: ReactNode;
+    /** Overrides the description (the message / the generic sentence). */
+    description?: ReactNode;
+    /** Leading icon — passed to `ErrorState` (`Danger` / `CloudCross` by default; `false` hides it). */
+    icon?: IconName | ReactNode | false;
+    /** Size — passed to `ErrorState`. Defaults to `md`. */
+    size?: EmptyStateSize;
+    /** Faded-grid hero backdrop — passed to `ErrorState`. Defaults to `true`. */
+    pattern?: boolean;
+    /** The developer details panel (stack) — passed to `ErrorState`. Defaults to `'dev'`. */
+    showDetails?: boolean | 'dev';
+}
+/**
+ * The shared **route error page** — the twin of `PageNotFound`. Drop it into TanStack Router as the
+ * `defaultErrorComponent`: TanStack wraps every route in its own error boundary (inside the shell's `<Outlet/>`),
+ * so without it a crashing page shows the router's bare "Something went wrong!". Renders the full `ErrorState`
+ * hero inside the shell with **Try Again** (`await onRetry?.()` → `reset()` → `router.invalidate()`, which re-runs
+ * a throwing loader / `beforeLoad`), a **Go to Home** button, the server's `traceId`, and the error's message only
+ * when it was written for people (`showMessage`). Every error is `console.error`ed once — in production the
+ * screen hides the message, so the console is the record.
+ *
+ * @example
+ * createRouter({ routeTree, defaultNotFoundComponent: PageNotFound, defaultErrorComponent: PageError })
+ */
+export declare const PageError: import("react").ForwardRefExoticComponent<PageErrorProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/PageError/PageError.d.ts

@@ -0,0 +1,53 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import type { IconName } from '../../icons/names';
+import type { EmptyStateSize } from '../EmptyState';
+export interface PageErrorProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
+    /** What the route threw (TanStack Router's `ErrorComponentProps.error`). */
+    error: unknown;
+    /** Resets the route's error boundary (TanStack Router's `ErrorComponentProps.reset`). */
+    reset?: () => void;
+    /** The React component stack (TanStack Router's `ErrorComponentProps.info`) — unused, accepted for typing. */
+    info?: {
+        componentStack: string;
+    };
+    /**
+     * Runs **before** the reset on "Try Again" (may be async) — where an app drops cached data, e.g.
+     * `() => queryClient.resetQueries({ predicate: (q) => q.queryKey[0] !== 'session' })`. Without it, `reset()`
+     * re-renders against the same cached response and throws on the same data again.
+     */
+    onRetry?: () => void | Promise<void>;
+    /**
+     * Show the error's own message. Default: when it looks **server-originated** (a `traceId` or a numeric
+     * `status` — written for people) or in development; otherwise the localized generic sentence (a render
+     * crash's message is a developer's). `true` / `false` force it; `'dev'` = development only; a function decides
+     * per error.
+     */
+    showMessage?: boolean | 'dev' | ((error: unknown) => boolean);
+    /** A secondary "Go to Home" button to the first allowed menu page (RBAC-aware). Defaults to `true`. */
+    showHome?: boolean;
+    /** Heading. Defaults to the localized "This Page Could Not Be Shown". */
+    title?: ReactNode;
+    /** Overrides the description (the message / the generic sentence). */
+    description?: ReactNode;
+    /** Leading icon — passed to `ErrorState` (`Danger` / `CloudCross` by default; `false` hides it). */
+    icon?: IconName | ReactNode | false;
+    /** Size — passed to `ErrorState`. Defaults to `md`. */
+    size?: EmptyStateSize;
+    /** Faded-grid hero backdrop — passed to `ErrorState`. Defaults to `true`. */
+    pattern?: boolean;
+    /** The developer details panel (stack) — passed to `ErrorState`. Defaults to `'dev'`. */
+    showDetails?: boolean | 'dev';
+}
+/**
+ * The shared **route error page** — the twin of `PageNotFound`. Drop it into TanStack Router as the
+ * `defaultErrorComponent`: TanStack wraps every route in its own error boundary (inside the shell's `<Outlet/>`),
+ * so without it a crashing page shows the router's bare "Something went wrong!". Renders the full `ErrorState`
+ * hero inside the shell with **Try Again** (`await onRetry?.()` → `reset()` → `router.invalidate()`, which re-runs
+ * a throwing loader / `beforeLoad`), a **Go to Home** button, the server's `traceId`, and the error's message only
+ * when it was written for people (`showMessage`). Every error is `console.error`ed once — in production the
+ * screen hides the message, so the console is the record.
+ *
+ * @example
+ * createRouter({ routeTree, defaultNotFoundComponent: PageNotFound, defaultErrorComponent: PageError })
+ */
+export declare const PageError: import("react").ForwardRefExoticComponent<PageErrorProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/PageError/index.cjs

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

package/dist/components/PageError/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/components/PageError/index.d.cts

@@ -0,0 +1,2 @@
+export { PageError, PageError as default } from './PageError';
+export type { PageErrorProps } from './PageError';

package/dist/components/PageError/index.d.ts

@@ -0,0 +1,2 @@
+export { PageError, PageError as default } from './PageError';
+export type { PageErrorProps } from './PageError';

package/dist/components/PageError/index.js

@@ -0,0 +1,6 @@
+import { P as e, P as o } from "../../PageError-ClR7k0Zb.js";
+export {
+  e as PageError,
+  o as default
+};
+//# sourceMappingURL=index.js.map

package/dist/components/PageError/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/PageLayout/index.cjs

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

package/dist/components/PageLayout/index.js

@@ -1,4 +1,4 @@
-import { P as o, P as t } from "../../PageLayout-Bwv8Oohb.js";
+import { P as o, P as t } from "../../PageLayout-XQ_aQTf5.js";
 export {
   o as PageLayout,
   t as default

package/dist/components/PageNotFound/index.cjs

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

package/dist/components/PageNotFound/index.js

@@ -1,4 +1,4 @@
-import { P as e, P as t } from "../../PageNotFound-CMt8vnky.js";
+import { P as e, P as t } from "../../PageNotFound-CpwHMTxG.js";
 export {
   e as PageNotFound,
   t as default

package/dist/components/PageNotFound/useHomeTo.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Internal: the "home" a full-page state sends the user back to — the **first allowed menu page** (RBAC-aware,
+ * the same target as `FirstRouteRedirect`), falling back to `/`; `to` overrides it. Also returns the router
+ * (lenient: `undefined` outside a `<RouterProvider>`, so the page renders without its home action). Shared by
+ * `PageNotFound` and `PageError`.
+ */
+export declare function useHomeTo(to?: string): {
+    router: import("@tanstack/router-core").AnyRouter;
+    homeTo: string | undefined;
+};

package/dist/components/PageNotFound/useHomeTo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal: the "home" a full-page state sends the user back to — the **first allowed menu page** (RBAC-aware,
+ * the same target as `FirstRouteRedirect`), falling back to `/`; `to` overrides it. Also returns the router
+ * (lenient: `undefined` outside a `<RouterProvider>`, so the page renders without its home action). Shared by
+ * `PageNotFound` and `PageError`.
+ */
+export declare function useHomeTo(to?: string): {
+    router: import("@tanstack/router-core").AnyRouter;
+    homeTo: string | undefined;
+};

package/dist/components/Pagination/index.cjs

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

package/dist/components/Pagination/index.js

@@ -1,4 +1,4 @@
-import { P as t, P } from "../../Pagination-C0xr3D-g.js";
+import { P as t, P } from "../../Pagination-Df-F9i2o.js";
 export {
   t as Pagination,
   P as default

package/dist/components/PaletteField/index.cjs

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

package/dist/components/PaletteField/index.js

@@ -1,4 +1,4 @@
-import { P as t, P as l } from "../../PaletteField-CQv6MBKe.js";
+import { P as t, P as l } from "../../PaletteField-DUu4jz1c.js";
 export {
   t as PaletteField,
   l as default

package/dist/components/PhoneField/index.cjs

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

package/dist/components/PhoneField/index.js

@@ -1,4 +1,4 @@
-import { P as i, P as o, i as s } from "../../PhoneField-Bqj5-33G.js";
+import { P as i, P as o, i as s } from "../../PhoneField-CXIQX_hR.js";
 export {
   i as PhoneField,
   o as default,

package/dist/components/Popconfirm/index.cjs

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

package/dist/components/Popconfirm/index.js

@@ -1,4 +1,4 @@
-import { P as f, P as r } from "../../Popconfirm-CYkwGTh-.js";
+import { P as f, P as r } from "../../Popconfirm-D4J7tlk_.js";
 export {
   f as Popconfirm,
   r as default

package/dist/components/Progress/index.cjs

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

package/dist/components/Progress/index.js

@@ -1,4 +1,4 @@
-import { P as a, P as e } from "../../Progress-DZUtn3Sh.js";
+import { P as a, P as e } from "../../Progress-BxvqmmGS.js";
 export {
   a as Progress,
   e as default

package/dist/components/RemoveDialog/index.cjs

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