@techzyapp/ui-library 1.0.25 → 1.0.28

package/dist/components/ColorPicker/colorUtils.d.cts

@@ -7,22 +7,13 @@ export interface HSV {
     /** Value/brightness 0–1 */
     v: number;
 }
-export interface RGB {
-    r: number;
-    g: number;
-    b: number;
-}
+import { type RGB } from '../../helpers/color';
+export { clamp01, normalizeHex, isValidHex, hexToRgb, rgbToHex } from '../../helpers/color';
+export type { RGB } from '../../helpers/color';
 export interface RGBA extends RGB {
     /** Alpha 0–1 */
     a: number;
 }
-export declare const clamp01: (n: number) => number;
-/** Normalizes any `#rgb`/`#rrggbb` (with or without `#`) to a lowercase `#rrggbb`, or `null` if invalid. */
-export declare function normalizeHex(input: string): string | null;
-/** True for a complete `#rrggbb` (or `#rgb`) color. */
-export declare const isValidHex: (input: string) => boolean;
-export declare function hexToRgb(hex: string): RGB;
-export declare function rgbToHex({ r, g, b }: RGB): string;
 /** RGB (0–255) → HSV. */
 export declare function rgbToHsv({ r, g, b }: RGB): HSV;
 /** HSV → RGB (0–255). */

package/dist/components/ColorPicker/colorUtils.d.ts

@@ -7,22 +7,13 @@ export interface HSV {
     /** Value/brightness 0–1 */
     v: number;
 }
-export interface RGB {
-    r: number;
-    g: number;
-    b: number;
-}
+import { type RGB } from '../../helpers/color';
+export { clamp01, normalizeHex, isValidHex, hexToRgb, rgbToHex } from '../../helpers/color';
+export type { RGB } from '../../helpers/color';
 export interface RGBA extends RGB {
     /** Alpha 0–1 */
     a: number;
 }
-export declare const clamp01: (n: number) => number;
-/** Normalizes any `#rgb`/`#rrggbb` (with or without `#`) to a lowercase `#rrggbb`, or `null` if invalid. */
-export declare function normalizeHex(input: string): string | null;
-/** True for a complete `#rrggbb` (or `#rgb`) color. */
-export declare const isValidHex: (input: string) => boolean;
-export declare function hexToRgb(hex: string): RGB;
-export declare function rgbToHex({ r, g, b }: RGB): string;
 /** RGB (0–255) → HSV. */
 export declare function rgbToHsv({ r, g, b }: RGB): HSV;
 /** HSV → RGB (0–255). */

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-DtzFwNWk.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-Bqypsy5E.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-Dw6Qk0iy.js";
+import { C as a, C as e } from "../../ColorPicker-DXDAXvlA.js";
 export {
   a as ColorPicker,
   e as default

package/dist/components/ColorRamp/ColorRamp.d.cts

@@ -0,0 +1,36 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type GeneratePaletteOptions, type PaletteSwatch } from '../../helpers/palette';
+export type ColorRampSize = 'sm' | 'md' | 'lg';
+export interface ColorRampProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color' | 'onCopy'> {
+    /** The base (500) color — any value `generatePalette` accepts. Invalid → the empty-state caption. */
+    baseColor: string;
+    /** Token prefix for step names (`primary` → "primary-500") — used in tooltips, aria-labels and the copy toast. Default `'color'`. */
+    name?: string;
+    /** Passed to `generatePalette` (override any subset of the tint / shade fractions). */
+    options?: GeneratePaletteOptions;
+    /** Band height. `sm` 32 · `md` 40 (default) · `lg` 48 px. */
+    size?: ColorRampSize;
+    /** Click a step to copy its hex (default `true`). `false` renders the steps as non-interactive cells. */
+    copyable?: boolean;
+    /** After a successful copy — in addition to the built-in toast. */
+    onCopy?: (swatch: PaletteSwatch) => void;
+    /** Show the "Lightest … Darkest" caption row under the band (default `true`). */
+    showBounds?: boolean;
+    /** Label rendered above the band (field-family chrome, like `Slider` / `SwatchPicker`). */
+    label?: ReactNode;
+    /** Helper / validation text under the band. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Marks the field invalid — reddens the label/asterisk and shows `helperText` in the error color. */
+    error?: boolean;
+    /** Adds a red asterisk after the label. */
+    required?: boolean;
+}
+/**
+ * The generated tonal scale for one color as **a single horizontal band of ten equal steps** sharing
+ * one rounded, clipped frame (reads as a continuous ramp, not ten chips). Display + copy only — it never
+ * edits the color; pair it with `ColorPicker` (or use `PaletteField`, which composes both). Each step
+ * is a `Tooltip`-wrapped button whose fill / ink are the swatch's own colors (inline — the color IS the
+ * data), showing its number on the base step and on hover / focus; clicking copies the hex with a toast.
+ * `role="group"` labelled "{name} color scale"; an invalid `baseColor` renders only a muted caption.
+ */
+export declare const ColorRamp: import("react").ForwardRefExoticComponent<ColorRampProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/ColorRamp/ColorRamp.d.ts

@@ -0,0 +1,36 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type GeneratePaletteOptions, type PaletteSwatch } from '../../helpers/palette';
+export type ColorRampSize = 'sm' | 'md' | 'lg';
+export interface ColorRampProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color' | 'onCopy'> {
+    /** The base (500) color — any value `generatePalette` accepts. Invalid → the empty-state caption. */
+    baseColor: string;
+    /** Token prefix for step names (`primary` → "primary-500") — used in tooltips, aria-labels and the copy toast. Default `'color'`. */
+    name?: string;
+    /** Passed to `generatePalette` (override any subset of the tint / shade fractions). */
+    options?: GeneratePaletteOptions;
+    /** Band height. `sm` 32 · `md` 40 (default) · `lg` 48 px. */
+    size?: ColorRampSize;
+    /** Click a step to copy its hex (default `true`). `false` renders the steps as non-interactive cells. */
+    copyable?: boolean;
+    /** After a successful copy — in addition to the built-in toast. */
+    onCopy?: (swatch: PaletteSwatch) => void;
+    /** Show the "Lightest … Darkest" caption row under the band (default `true`). */
+    showBounds?: boolean;
+    /** Label rendered above the band (field-family chrome, like `Slider` / `SwatchPicker`). */
+    label?: ReactNode;
+    /** Helper / validation text under the band. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Marks the field invalid — reddens the label/asterisk and shows `helperText` in the error color. */
+    error?: boolean;
+    /** Adds a red asterisk after the label. */
+    required?: boolean;
+}
+/**
+ * The generated tonal scale for one color as **a single horizontal band of ten equal steps** sharing
+ * one rounded, clipped frame (reads as a continuous ramp, not ten chips). Display + copy only — it never
+ * edits the color; pair it with `ColorPicker` (or use `PaletteField`, which composes both). Each step
+ * is a `Tooltip`-wrapped button whose fill / ink are the swatch's own colors (inline — the color IS the
+ * data), showing its number on the base step and on hover / focus; clicking copies the hex with a toast.
+ * `role="group"` labelled "{name} color scale"; an invalid `baseColor` renders only a muted caption.
+ */
+export declare const ColorRamp: import("react").ForwardRefExoticComponent<ColorRampProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/ColorRamp/index.cjs

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

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

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

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

@@ -0,0 +1,3 @@
+export { ColorRamp, ColorRamp as default } from './ColorRamp';
+export type { ColorRampProps, ColorRampSize } from './ColorRamp';
+export type { PaletteSwatch, PaletteStep, GeneratePaletteOptions, Legibility, WcagRating, Rgb, } from '../../helpers/palette';

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

@@ -0,0 +1,3 @@
+export { ColorRamp, ColorRamp as default } from './ColorRamp';
+export type { ColorRampProps, ColorRampSize } from './ColorRamp';
+export type { PaletteSwatch, PaletteStep, GeneratePaletteOptions, Legibility, WcagRating, Rgb, } from '../../helpers/palette';

package/dist/components/ColorRamp/index.js

@@ -0,0 +1,6 @@
+import { C as r, C } from "../../ColorRamp-DQ8wkgvF.js";
+export {
+  r as ColorRamp,
+  C as default
+};
+//# sourceMappingURL=index.js.map

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

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

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-Ct-8AmmX.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-B5aicGl3.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-DJ1PSJZU.js";
+import { C as a, C } from "../../CopyButton-BplPYm8i.js";
 export {
   a as CopyButton,
   C as default

package/dist/components/DashedButton/index.cjs

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

package/dist/components/DashedButton/index.js

@@ -1,4 +1,4 @@
-import { D as e, D as o } from "../../DashedButton-BXZAyMtw.js";
+import { D as e, D as o } from "../../DashedButton-iM7kzopW.js";
 export {
   e as DashedButton,
   o 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-BxEydgfu.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-Cdl2JYBd.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-CJioG5M7.js";
+import { D as r, D as t } from "../../DatePicker-U5TJ9FYM.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-COEj2Z0F.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-DUFtddxJ.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-e2zj2bhS.js";
+import { D as r, D as t } from "../../DateTimePicker-laJsZYJX.js";
 export {
   r as DateTimePicker,
   t as default

package/dist/components/DescriptionList/DescriptionList.d.cts

@@ -0,0 +1,76 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type Breakpoint, type Responsive } from '../../theme/breakpoints';
+import { type IconName } from '../../icons/names';
+export type DescriptionListSize = 'sm' | 'md' | 'lg';
+export type DescriptionListLayout = 'vertical' | 'horizontal';
+export type DescriptionListColumns = 1 | 2 | 3 | 4;
+export type DescriptionListValueWeight = 'regular' | 'medium' | 'bold';
+export interface DescriptionItem {
+    /** Stable key (defaults to the index). */
+    key?: string;
+    /** The term — "Entry fee". */
+    label: ReactNode;
+    /** The value. `null` / `undefined` / `''` / `false` render the `emptyText` placeholder ("—"). */
+    value?: ReactNode;
+    /** Columns this pair spans (clamped to the resolved column count) — for long text, addresses, lists. */
+    span?: DescriptionListColumns;
+    /** Show a copy button: `true` copies a string/number `value`; pass a string to copy something else (an id behind a label). */
+    copyable?: boolean | string;
+    /** Drop the pair entirely (e.g. by role). */
+    hidden?: boolean;
+    /** Small leading icon in the label — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+}
+export interface DescriptionListProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
+    /** The label / value pairs, in order. Declarative so `loading` skeletons and `hidden` stay trivial. */
+    items: DescriptionItem[];
+    /** Column count — a number or a desktop-first breakpoint map. Defaults to `{ xs: 1, sm: 2, lg: 3 }`. */
+    columns?: Responsive<DescriptionListColumns>;
+    /** `vertical` (label above value, default) or `horizontal` (label beside value; stacks again on phones). */
+    layout?: DescriptionListLayout;
+    /** Text + spacing scale. Defaults to `md`. */
+    size?: DescriptionListSize;
+    /** Font weight of the values. Defaults to `regular` (the library's body default); `medium` / `bold` add emphasis. */
+    valueWeight?: DescriptionListValueWeight;
+    /** Frame the list as a surface card (border + radius); `horizontal` also tints the label column. */
+    bordered?: boolean;
+    /** Hairlines between rows. Defaults to `true` (turn off inside an already-ruled container). */
+    dividers?: boolean;
+    /** Label column width for `horizontal` (px number or CSS length). Defaults to `160px`. */
+    labelWidth?: number | string;
+    /**
+     * `horizontal` only — the breakpoint at (and below) which the label stacks back above the value.
+     * A breakpoint token (`'xxs'` ≤ 576px default, `'xs'` ≤ 768px, …) or `false` to keep the two columns
+     * side by side at every width. Uses the shared JS breakpoint layer, so `config.theme.breakpoints` applies.
+     */
+    stackBelow?: Breakpoint | false;
+    /** Render shimmering placeholders instead of values — `true` uses `items.length` rows, a number sets the count. */
+    loading?: boolean | number;
+    /** Placeholder for an empty value. Defaults to `"—"`. */
+    emptyText?: ReactNode;
+    /** Optional header title. */
+    title?: ReactNode;
+    /** Leading header icon (a tinted box before the title, like `Card`) — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+    /** Theme color that tints the header icon box. Defaults to `accent`. */
+    color?: ThemeColor;
+    /** Muted line under the title. */
+    subtitle?: ReactNode;
+    /** Header slot on the right (buttons, a status chip …). */
+    actions?: ReactNode;
+}
+/**
+ * Label / value pairs for a **detail page** (the read-only twin of a form: "User #42" → Name, Email,
+ * Role …). Renders a semantic `<dl>` of `<dt>` / `<dd>` groups laid out on a responsive CSS grid
+ * (`columns`, desktop-first breakpoint map — default 1 → 2 → 3), each pair optionally spanning several
+ * columns. An optional Card-style header carries an `icon` box (tinted by `color`), `title`,
+ * `subtitle` and `actions`. Values are regular weight by default (`valueWeight` adds emphasis) and any node: `null` / `''` show a muted "—" placeholder (`emptyText`), string / number
+ * values can grow a `CopyButton` (revealed on hover / focus; always visible without hover), and
+ * `hidden` drops a pair (e.g. by role). `layout="horizontal"` puts the label beside the value in a
+ * `labelWidth` column and stacks back on phones (`stackBelow` — a breakpoint, or `false` to never stack); `bordered` frames the list as a surface card (tinting the
+ * label column when horizontal). `loading` swaps the values for `Skeleton` lines of the same shape.
+ * Rows are separated by hairline `dividers`. Token-only; the grid is never `overflow: hidden` so the
+ * copy tooltip is never clipped. `forwardRef` to the root `<div>`.
+ */
+export declare const DescriptionList: import("react").ForwardRefExoticComponent<DescriptionListProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/DescriptionList/DescriptionList.d.ts

@@ -0,0 +1,76 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
+import { type Breakpoint, type Responsive } from '../../theme/breakpoints';
+import { type IconName } from '../../icons/names';
+export type DescriptionListSize = 'sm' | 'md' | 'lg';
+export type DescriptionListLayout = 'vertical' | 'horizontal';
+export type DescriptionListColumns = 1 | 2 | 3 | 4;
+export type DescriptionListValueWeight = 'regular' | 'medium' | 'bold';
+export interface DescriptionItem {
+    /** Stable key (defaults to the index). */
+    key?: string;
+    /** The term — "Entry fee". */
+    label: ReactNode;
+    /** The value. `null` / `undefined` / `''` / `false` render the `emptyText` placeholder ("—"). */
+    value?: ReactNode;
+    /** Columns this pair spans (clamped to the resolved column count) — for long text, addresses, lists. */
+    span?: DescriptionListColumns;
+    /** Show a copy button: `true` copies a string/number `value`; pass a string to copy something else (an id behind a label). */
+    copyable?: boolean | string;
+    /** Drop the pair entirely (e.g. by role). */
+    hidden?: boolean;
+    /** Small leading icon in the label — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+}
+export interface DescriptionListProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
+    /** The label / value pairs, in order. Declarative so `loading` skeletons and `hidden` stay trivial. */
+    items: DescriptionItem[];
+    /** Column count — a number or a desktop-first breakpoint map. Defaults to `{ xs: 1, sm: 2, lg: 3 }`. */
+    columns?: Responsive<DescriptionListColumns>;
+    /** `vertical` (label above value, default) or `horizontal` (label beside value; stacks again on phones). */
+    layout?: DescriptionListLayout;
+    /** Text + spacing scale. Defaults to `md`. */
+    size?: DescriptionListSize;
+    /** Font weight of the values. Defaults to `regular` (the library's body default); `medium` / `bold` add emphasis. */
+    valueWeight?: DescriptionListValueWeight;
+    /** Frame the list as a surface card (border + radius); `horizontal` also tints the label column. */
+    bordered?: boolean;
+    /** Hairlines between rows. Defaults to `true` (turn off inside an already-ruled container). */
+    dividers?: boolean;
+    /** Label column width for `horizontal` (px number or CSS length). Defaults to `160px`. */
+    labelWidth?: number | string;
+    /**
+     * `horizontal` only — the breakpoint at (and below) which the label stacks back above the value.
+     * A breakpoint token (`'xxs'` ≤ 576px default, `'xs'` ≤ 768px, …) or `false` to keep the two columns
+     * side by side at every width. Uses the shared JS breakpoint layer, so `config.theme.breakpoints` applies.
+     */
+    stackBelow?: Breakpoint | false;
+    /** Render shimmering placeholders instead of values — `true` uses `items.length` rows, a number sets the count. */
+    loading?: boolean | number;
+    /** Placeholder for an empty value. Defaults to `"—"`. */
+    emptyText?: ReactNode;
+    /** Optional header title. */
+    title?: ReactNode;
+    /** Leading header icon (a tinted box before the title, like `Card`) — a known `IconName` or any node. */
+    icon?: IconName | ReactNode;
+    /** Theme color that tints the header icon box. Defaults to `accent`. */
+    color?: ThemeColor;
+    /** Muted line under the title. */
+    subtitle?: ReactNode;
+    /** Header slot on the right (buttons, a status chip …). */
+    actions?: ReactNode;
+}
+/**
+ * Label / value pairs for a **detail page** (the read-only twin of a form: "User #42" → Name, Email,
+ * Role …). Renders a semantic `<dl>` of `<dt>` / `<dd>` groups laid out on a responsive CSS grid
+ * (`columns`, desktop-first breakpoint map — default 1 → 2 → 3), each pair optionally spanning several
+ * columns. An optional Card-style header carries an `icon` box (tinted by `color`), `title`,
+ * `subtitle` and `actions`. Values are regular weight by default (`valueWeight` adds emphasis) and any node: `null` / `''` show a muted "—" placeholder (`emptyText`), string / number
+ * values can grow a `CopyButton` (revealed on hover / focus; always visible without hover), and
+ * `hidden` drops a pair (e.g. by role). `layout="horizontal"` puts the label beside the value in a
+ * `labelWidth` column and stacks back on phones (`stackBelow` — a breakpoint, or `false` to never stack); `bordered` frames the list as a surface card (tinting the
+ * label column when horizontal). `loading` swaps the values for `Skeleton` lines of the same shape.
+ * Rows are separated by hairline `dividers`. Token-only; the grid is never `overflow: hidden` so the
+ * copy tooltip is never clipped. `forwardRef` to the root `<div>`.
+ */
+export declare const DescriptionList: import("react").ForwardRefExoticComponent<DescriptionListProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/DescriptionList/index.cjs

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

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

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

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

@@ -0,0 +1,2 @@
+export { DescriptionList, DescriptionList as default } from './DescriptionList';
+export type { DescriptionListProps, DescriptionItem, DescriptionListSize, DescriptionListLayout, DescriptionListColumns, DescriptionListValueWeight, } from './DescriptionList';

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

@@ -0,0 +1,2 @@
+export { DescriptionList, DescriptionList as default } from './DescriptionList';
+export type { DescriptionListProps, DescriptionItem, DescriptionListSize, DescriptionListLayout, DescriptionListColumns, DescriptionListValueWeight, } from './DescriptionList';

package/dist/components/DescriptionList/index.js

@@ -0,0 +1,6 @@
+import { D as a, D as e } from "../../DescriptionList-Y9jF_4L0.js";
+export {
+  a as DescriptionList,
+  e as default
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/Dropdown/index.cjs

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

package/dist/components/Dropdown/index.js

@@ -1,4 +1,4 @@
-import { D as r, D } from "../../Dropdown-FfkmluRu.js";
+import { D as r, D } from "../../Dropdown--1mNTVZJ.js";
 export {
   r as Dropdown,
   D as default

package/dist/components/EmptyState/EmptyState.d.cts

@@ -1,7 +1,8 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export type EmptyStateSize = 'sm' | 'md' | 'lg';
-export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Leading glyph shown in a soft circle — an `IconName`, any node, or `false` to hide it. Defaults to `FolderOpen`. */
     icon?: IconName | ReactNode | false;
     /** Heading line. Defaults to `"No Results Found"`. */
@@ -17,6 +18,8 @@ export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * (gradient + drop shadow). Defaults to `true`; pass `pattern={false}` for the flat, compact placeholder.
      */
     pattern?: boolean;
+    /** Tint the icon puck with a theme color (e.g. `error` for a failure). Omitted → the neutral muted puck. */
+    color?: ThemeColor;
     /** Extra content rendered below the action. */
     children?: ReactNode;
 }

package/dist/components/EmptyState/EmptyState.d.ts

@@ -1,7 +1,8 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export type EmptyStateSize = 'sm' | 'md' | 'lg';
-export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Leading glyph shown in a soft circle — an `IconName`, any node, or `false` to hide it. Defaults to `FolderOpen`. */
     icon?: IconName | ReactNode | false;
     /** Heading line. Defaults to `"No Results Found"`. */
@@ -17,6 +18,8 @@ export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * (gradient + drop shadow). Defaults to `true`; pass `pattern={false}` for the flat, compact placeholder.
      */
     pattern?: boolean;
+    /** Tint the icon puck with a theme color (e.g. `error` for a failure). Omitted → the neutral muted puck. */
+    color?: ThemeColor;
     /** Extra content rendered below the action. */
     children?: ReactNode;
 }

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-Bv4XXnD1.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-CO_NRZ6w.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-BTd7aVgu.js";
+import { E as e, E } from "../../EmptyState-BtwuzX9Z.js";
 export {
   e as EmptyState,
   E as default

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

@@ -0,0 +1,35 @@
+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.
+     */
+    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). */
+    onReset?: () => void;
+    /** Reset automatically when any of these change (shallow) — e.g. `[location.pathname]` clears on navigation. */
+    resetKeys?: unknown[];
+    children?: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * 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);
+ * `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.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    componentDidUpdate(prev: ErrorBoundaryProps, prevState: ErrorBoundaryState): void;
+    reset: () => void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};

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

@@ -0,0 +1,35 @@
+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.
+     */
+    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). */
+    onReset?: () => void;
+    /** Reset automatically when any of these change (shallow) — e.g. `[location.pathname]` clears on navigation. */
+    resetKeys?: unknown[];
+    children?: ReactNode;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * 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);
+ * `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.
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: unknown): ErrorBoundaryState;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    componentDidUpdate(prev: ErrorBoundaryProps, prevState: ErrorBoundaryState): void;
+    reset: () => void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};

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

@@ -0,0 +1,36 @@
+import { type ReactNode } from 'react';
+import { type EmptyStateProps } from '../EmptyState';
+import type { IconName } from '../../icons/names';
+export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title' | 'color'> {
+    /**
+     * 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". */
+    title?: ReactNode;
+    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger`, tinted `error`. */
+    icon?: IconName | ReactNode | false;
+    /** 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". */
+    retryLabel?: ReactNode;
+    /**
+     * Show a collapsible technical details panel (stack / raw error). `'dev'` (default) shows it only in
+     * development builds; `true` always; `false` never.
+     */
+    showDetails?: boolean | 'dev';
+    /** The inline variant — small, no hero pattern — for inside a table, card or panel. Defaults to `false`. */
+    compact?: boolean;
+}
+/**
+ * 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
+ * (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
+ * developer-only details panel with the stack (`showDetails`, default `'dev'`). `compact` is the inline
+ * variant for a table / card. Announced to assistive tech (`role="alert"`, `aria-live="polite"`).
+ * `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

@@ -0,0 +1,36 @@
+import { type ReactNode } from 'react';
+import { type EmptyStateProps } from '../EmptyState';
+import type { IconName } from '../../icons/names';
+export interface ErrorStateProps extends Omit<EmptyStateProps, 'icon' | 'title' | 'color'> {
+    /**
+     * 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". */
+    title?: ReactNode;
+    /** Leading icon — a known `IconName`, any node, or `false`. Defaults to `Danger`, tinted `error`. */
+    icon?: IconName | ReactNode | false;
+    /** 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". */
+    retryLabel?: ReactNode;
+    /**
+     * Show a collapsible technical details panel (stack / raw error). `'dev'` (default) shows it only in
+     * development builds; `true` always; `false` never.
+     */
+    showDetails?: boolean | 'dev';
+    /** The inline variant — small, no hero pattern — for inside a table, card or panel. Defaults to `false`. */
+    compact?: boolean;
+}
+/**
+ * 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
+ * (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
+ * developer-only details panel with the stack (`showDetails`, default `'dev'`). `compact` is the inline
+ * variant for a table / card. Announced to assistive tech (`role="alert"`, `aria-live="polite"`).
+ * `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>>;