@techzyapp/ui-library 1.0.40 → 1.0.42

package/dist/{UserCard-1ubnvBV6.cjs → UserCard-DbudGMvG.cjs}

@@ -1,2 +1,2 @@
-"use strict";const t=require("react/jsx-runtime"),q=require("react"),p=require("clsx"),g=require("./Avatar-l48Ice6t.cjs"),C=require("./Button-CYZoF18-.cjs"),S=require("./Icon-B6lz-V0A.cjs"),a=require("./Skeleton-DK0lAjS9.cjs"),d=require("./Typography-d97DdbNd.cjs"),w=require("./ConfigProvider-B_Bb6pk1.cjs"),T="_card_1fykc_3",U="_identity_1fykc_16",b="_text_1fykc_20",I="_sm_1fykc_33",N="_lg_1fykc_37",s={card:T,identity:U,text:b,sm:I,lg:N},A=q.forwardRef(function({name:c,email:n,avatar:l,icon:u="User",color:y="primary",size:e="md",onLogout:i,logoutLabel:x,children:m,loading:r=!1,className:_,style:f,...h},v){const o=w.useT(),j=e==="lg"?"lg":e==="sm"?"sm":"md",k=e==="lg"?"md":"sm";return t.jsxs("div",{ref:v,className:p.clsx(s.card,s[e],_),style:f,"aria-busy":r||void 0,...h,children:[t.jsxs("div",{className:s.identity,children:[t.jsx(g.Avatar,{size:j,name:c,src:l,icon:c?void 0:u,color:y,loading:r}),t.jsxs("div",{className:s.text,children:[t.jsx(d.Typography,{variant:"bodySmall",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"60%"}):c??o("userCard.welcome")}),(r||n!=null)&&t.jsx(d.Typography,{variant:"caption",color:"muted",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"85%"}):n})]})]}),m,i?t.jsx(C.Button,{variant:"filled",color:"error",size:k,fullWidth:!0,startIcon:t.jsx(S.Icon,{name:"Logout2"}),onClick:i,children:x??o("userCard.signOut")}):null]})});exports.UserCard=A;
-//# sourceMappingURL=UserCard-1ubnvBV6.cjs.map
+"use strict";const t=require("react/jsx-runtime"),q=require("react"),p=require("clsx"),g=require("./Avatar-l48Ice6t.cjs"),C=require("./Button-CwrDiZek.cjs"),S=require("./Icon-B6lz-V0A.cjs"),a=require("./Skeleton-DK0lAjS9.cjs"),d=require("./Typography-d97DdbNd.cjs"),w=require("./ConfigProvider-BaiTKZKC.cjs"),T="_card_1fykc_3",U="_identity_1fykc_16",b="_text_1fykc_20",I="_sm_1fykc_33",N="_lg_1fykc_37",s={card:T,identity:U,text:b,sm:I,lg:N},A=q.forwardRef(function({name:c,email:n,avatar:l,icon:u="User",color:y="primary",size:e="md",onLogout:i,logoutLabel:x,children:m,loading:r=!1,className:_,style:f,...h},v){const o=w.useT(),j=e==="lg"?"lg":e==="sm"?"sm":"md",k=e==="lg"?"md":"sm";return t.jsxs("div",{ref:v,className:p.clsx(s.card,s[e],_),style:f,"aria-busy":r||void 0,...h,children:[t.jsxs("div",{className:s.identity,children:[t.jsx(g.Avatar,{size:j,name:c,src:l,icon:c?void 0:u,color:y,loading:r}),t.jsxs("div",{className:s.text,children:[t.jsx(d.Typography,{variant:"bodySmall",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"60%"}):c??o("userCard.welcome")}),(r||n!=null)&&t.jsx(d.Typography,{variant:"caption",color:"muted",truncate:!0,children:r?t.jsx(a.Skeleton,{width:"85%"}):n})]})]}),m,i?t.jsx(C.Button,{variant:"filled",color:"error",size:k,fullWidth:!0,startIcon:t.jsx(S.Icon,{name:"Logout2"}),onClick:i,children:x??o("userCard.signOut")}):null]})});exports.UserCard=A;
+//# sourceMappingURL=UserCard-DbudGMvG.cjs.map

package/dist/UserCard-DbudGMvG.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-DbudGMvG.cjs","sources":["../src/components/UserCard/UserCard.tsx"],"sourcesContent":["import { forwardRef, type CSSProperties, type HTMLAttributes, type ReactNode } from 'react'\nimport { clsx } from 'clsx'\nimport { useT, type ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport { Avatar } from '../Avatar'\nimport { Button } from '../Button'\nimport { Icon } from '../Icon'\nimport { Skeleton } from '../Skeleton'\nimport { Typography } from '../Typography'\nimport styles from './UserCard.module.css'\n\nexport type UserCardSize = 'sm' | 'md' | 'lg'\n\nexport interface UserCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {\n  /**\n   * Display name — the primary line, and the source of the avatar initials. When omitted, the primary\n   * line falls back to a localized **\"Welcome\"** greeting (and the avatar shows the `icon`).\n   */\n  name?: string\n  /** Secondary line under the name (usually the email). */\n  email?: ReactNode\n  /** Avatar image URL (falls back to the initials from `name`, else the `icon`). */\n  avatar?: string\n  /** Fallback avatar icon when there's no image or name. Defaults to `'User'`. */\n  icon?: IconName\n  /** Theme palette token tinting the avatar. Defaults to `'primary'`. */\n  color?: ThemeColor\n  /** Preset size (avatar + button + card padding; the text stays fixed). Defaults to `'md'`. */\n  size?: UserCardSize\n  /** When provided, a **Sign out** button is shown that calls this. */\n  onLogout?: () => void\n  /** Sign-out button label. Defaults to `'Sign Out'`. */\n  logoutLabel?: ReactNode\n  /** Extra content between the identity row and the sign-out button (e.g. a link or menu). */\n  children?: ReactNode\n  /** Show skeletons for the avatar, name and email while the user is being fetched (sign-out stays usable). Defaults to `false`. */\n  loading?: boolean\n}\n\n/**\n * A compact account card — an `Avatar` + name/email and an optional **Sign out** button — for a consistent\n * signed-in-user block across apps, instead of hand-rolling the markup each time. The shell's sidebar renders\n * one itself (`config.sidebar.userCard` / the `RootLayout` `showUserCard` prop), so place it by hand only\n * elsewhere. Shows the image (`avatar`) → initials (from `name`) →\n * `icon` (default `User`) in priority order; renders the sign-out `Button` (filled `error`) only when\n * `onLogout` is given. `size` (`sm`/`md`/`lg`) scales the avatar, button and padding; `color` (default `primary`)\n * tints the avatar. `loading` swaps the avatar + name + email for skeletons. Own CSS module (token-only).\n */\nexport const UserCard = forwardRef<HTMLDivElement, UserCardProps>(function UserCard(\n  {\n    name,\n    email,\n    avatar,\n    icon = 'User',\n    color = 'primary',\n    size = 'md',\n    onLogout,\n    logoutLabel,\n    children,\n    loading = false,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  const t = useT()\n  // the identity row + the sign-out button share the same visual size step\n  const avatarSize = size === 'lg' ? 'lg' : size === 'sm' ? 'sm' : 'md'\n  const buttonSize = size === 'lg' ? 'md' : 'sm'\n\n  return (\n    <div\n      ref={ref}\n      className={clsx(styles.card, styles[size], className)}\n      style={style as CSSProperties}\n      aria-busy={loading || undefined}\n      {...props}\n    >\n      <div className={styles.identity}>\n        {/* Avatar priority is image → icon → initials, so pass `icon` only as the last resort (no\n            name), otherwise a name would still show the icon instead of its initials */}\n        <Avatar\n          size={avatarSize}\n          name={name}\n          src={avatar}\n          icon={name ? undefined : icon}\n          color={color}\n          loading={loading}\n        />\n        <div className={styles.text}>\n          {/* primary line: the name, or a \"Welcome\" greeting fallback when no name is given */}\n          <Typography variant=\"bodySmall\" truncate>\n            {loading ? <Skeleton width=\"60%\" /> : (name ?? t('userCard.welcome'))}\n          </Typography>\n          {(loading || email != null) && (\n            <Typography variant=\"caption\" color=\"muted\" truncate>\n              {loading ? <Skeleton width=\"85%\" /> : email}\n            </Typography>\n          )}\n        </div>\n      </div>\n\n      {children}\n\n      {onLogout ? (\n        <Button\n          variant=\"filled\"\n          color=\"error\"\n          size={buttonSize}\n          fullWidth\n          startIcon={<Icon name=\"Logout2\" />}\n          onClick={onLogout}\n        >\n          {logoutLabel ?? t('userCard.signOut')}\n        </Button>\n      ) : null}\n    </div>\n  )\n})\n"],"names":["UserCard","forwardRef","name","email","avatar","icon","color","size","onLogout","logoutLabel","children","loading","className","style","props","ref","t","useT","avatarSize","buttonSize","jsxs","clsx","styles","jsx","Avatar","Typography","Skeleton","Button","Icon"],"mappings":"0bAgDaA,EAAWC,EAAAA,WAA0C,SAChE,CACE,KAAAC,EACA,MAAAC,EACA,OAAAC,EACA,KAAAC,EAAO,OACP,MAAAC,EAAQ,UACR,KAAAC,EAAO,KACP,SAAAC,EACA,YAAAC,EACA,SAAAC,EACA,QAAAC,EAAU,GACV,UAAAC,EACA,MAAAC,EACA,GAAGC,CACL,EACAC,EACA,CACA,MAAMC,EAAIC,EAAAA,KAAA,EAEJC,EAAaX,IAAS,KAAO,KAAOA,IAAS,KAAO,KAAO,KAC3DY,EAAaZ,IAAS,KAAO,KAAO,KAE1C,OACEa,EAAAA,KAAC,MAAA,CACC,IAAAL,EACA,UAAWM,EAAAA,KAAKC,EAAO,KAAMA,EAAOf,CAAI,EAAGK,CAAS,EACpD,MAAAC,EACA,YAAWF,GAAW,OACrB,GAAGG,EAEJ,SAAA,CAAAM,EAAAA,KAAC,MAAA,CAAI,UAAWE,EAAO,SAGrB,SAAA,CAAAC,EAAAA,IAACC,EAAAA,OAAA,CACC,KAAMN,EACN,KAAAhB,EACA,IAAKE,EACL,KAAMF,EAAO,OAAYG,EACzB,MAAAC,EACA,QAAAK,CAAA,CAAA,EAEFS,EAAAA,KAAC,MAAA,CAAI,UAAWE,EAAO,KAErB,SAAA,CAAAC,EAAAA,IAACE,EAAAA,WAAA,CAAW,QAAQ,YAAY,SAAQ,GACrC,SAAAd,EAAUY,EAAAA,IAACG,WAAA,CAAS,MAAM,KAAA,CAAM,EAAMxB,GAAQc,EAAE,kBAAkB,EACrE,GACEL,GAAWR,GAAS,OACpBoB,EAAAA,IAACE,EAAAA,WAAA,CAAW,QAAQ,UAAU,MAAM,QAAQ,SAAQ,GACjD,SAAAd,EAAUY,MAACG,EAAAA,UAAS,MAAM,MAAM,EAAKvB,CAAA,CACxC,CAAA,CAAA,CAEJ,CAAA,EACF,EAECO,EAEAF,EACCe,EAAAA,IAACI,EAAAA,OAAA,CACC,QAAQ,SACR,MAAM,QACN,KAAMR,EACN,UAAS,GACT,UAAWI,EAAAA,IAACK,EAAAA,KAAA,CAAK,KAAK,SAAA,CAAU,EAChC,QAASpB,EAER,SAAAC,GAAeO,EAAE,kBAAkB,CAAA,CAAA,EAEpC,IAAA,CAAA,CAAA,CAGV,CAAC"}

package/dist/{UserCard-DcTLEHFu.js → UserCard-UG_Cwe-Y.js}

@@ -2,11 +2,11 @@ import { jsxs as e, jsx as t } from "react/jsx-runtime";
 import { forwardRef as S } from "react";
 import { clsx as b } from "clsx";
 import { A as g } from "./Avatar-ClcmN0ba.js";
-import { B as w } from "./Button-Bst_NtPJ.js";
+import { B as w } from "./Button-0ZgdNjX-.js";
 import { b as U } from "./Icon-D5TxgfCc.js";
 import { S as m } from "./Skeleton-_-uGax2j.js";
 import { T as d } from "./Typography-ChSuxgkc.js";
-import { a as N } from "./ConfigProvider-DeMASTVo.js";
+import { a as N } from "./ConfigProvider-D61cpCz-.js";
 const T = "_card_1fykc_3", j = "_identity_1fykc_16", A = "_text_1fykc_20", B = "_sm_1fykc_33", I = "_lg_1fykc_37", o = {
   card: T,
   identity: j,
@@ -75,4 +75,4 @@ const T = "_card_1fykc_3", j = "_identity_1fykc_16", A = "_text_1fykc_20", B = "
 export {
   J as U
 };
-//# sourceMappingURL=UserCard-DcTLEHFu.js.map
+//# sourceMappingURL=UserCard-UG_Cwe-Y.js.map

package/dist/UserCard-UG_Cwe-Y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCard-UG_Cwe-Y.js","sources":["../src/components/UserCard/UserCard.tsx"],"sourcesContent":["import { forwardRef, type CSSProperties, type HTMLAttributes, type ReactNode } from 'react'\nimport { clsx } from 'clsx'\nimport { useT, type ThemeColor } from '../../theme'\nimport type { IconName } from '../../icons/names'\nimport { Avatar } from '../Avatar'\nimport { Button } from '../Button'\nimport { Icon } from '../Icon'\nimport { Skeleton } from '../Skeleton'\nimport { Typography } from '../Typography'\nimport styles from './UserCard.module.css'\n\nexport type UserCardSize = 'sm' | 'md' | 'lg'\n\nexport interface UserCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'> {\n  /**\n   * Display name — the primary line, and the source of the avatar initials. When omitted, the primary\n   * line falls back to a localized **\"Welcome\"** greeting (and the avatar shows the `icon`).\n   */\n  name?: string\n  /** Secondary line under the name (usually the email). */\n  email?: ReactNode\n  /** Avatar image URL (falls back to the initials from `name`, else the `icon`). */\n  avatar?: string\n  /** Fallback avatar icon when there's no image or name. Defaults to `'User'`. */\n  icon?: IconName\n  /** Theme palette token tinting the avatar. Defaults to `'primary'`. */\n  color?: ThemeColor\n  /** Preset size (avatar + button + card padding; the text stays fixed). Defaults to `'md'`. */\n  size?: UserCardSize\n  /** When provided, a **Sign out** button is shown that calls this. */\n  onLogout?: () => void\n  /** Sign-out button label. Defaults to `'Sign Out'`. */\n  logoutLabel?: ReactNode\n  /** Extra content between the identity row and the sign-out button (e.g. a link or menu). */\n  children?: ReactNode\n  /** Show skeletons for the avatar, name and email while the user is being fetched (sign-out stays usable). Defaults to `false`. */\n  loading?: boolean\n}\n\n/**\n * A compact account card — an `Avatar` + name/email and an optional **Sign out** button — for a consistent\n * signed-in-user block across apps, instead of hand-rolling the markup each time. The shell's sidebar renders\n * one itself (`config.sidebar.userCard` / the `RootLayout` `showUserCard` prop), so place it by hand only\n * elsewhere. Shows the image (`avatar`) → initials (from `name`) →\n * `icon` (default `User`) in priority order; renders the sign-out `Button` (filled `error`) only when\n * `onLogout` is given. `size` (`sm`/`md`/`lg`) scales the avatar, button and padding; `color` (default `primary`)\n * tints the avatar. `loading` swaps the avatar + name + email for skeletons. Own CSS module (token-only).\n */\nexport const UserCard = forwardRef<HTMLDivElement, UserCardProps>(function UserCard(\n  {\n    name,\n    email,\n    avatar,\n    icon = 'User',\n    color = 'primary',\n    size = 'md',\n    onLogout,\n    logoutLabel,\n    children,\n    loading = false,\n    className,\n    style,\n    ...props\n  },\n  ref,\n) {\n  const t = useT()\n  // the identity row + the sign-out button share the same visual size step\n  const avatarSize = size === 'lg' ? 'lg' : size === 'sm' ? 'sm' : 'md'\n  const buttonSize = size === 'lg' ? 'md' : 'sm'\n\n  return (\n    <div\n      ref={ref}\n      className={clsx(styles.card, styles[size], className)}\n      style={style as CSSProperties}\n      aria-busy={loading || undefined}\n      {...props}\n    >\n      <div className={styles.identity}>\n        {/* Avatar priority is image → icon → initials, so pass `icon` only as the last resort (no\n            name), otherwise a name would still show the icon instead of its initials */}\n        <Avatar\n          size={avatarSize}\n          name={name}\n          src={avatar}\n          icon={name ? undefined : icon}\n          color={color}\n          loading={loading}\n        />\n        <div className={styles.text}>\n          {/* primary line: the name, or a \"Welcome\" greeting fallback when no name is given */}\n          <Typography variant=\"bodySmall\" truncate>\n            {loading ? <Skeleton width=\"60%\" /> : (name ?? t('userCard.welcome'))}\n          </Typography>\n          {(loading || email != null) && (\n            <Typography variant=\"caption\" color=\"muted\" truncate>\n              {loading ? <Skeleton width=\"85%\" /> : email}\n            </Typography>\n          )}\n        </div>\n      </div>\n\n      {children}\n\n      {onLogout ? (\n        <Button\n          variant=\"filled\"\n          color=\"error\"\n          size={buttonSize}\n          fullWidth\n          startIcon={<Icon name=\"Logout2\" />}\n          onClick={onLogout}\n        >\n          {logoutLabel ?? t('userCard.signOut')}\n        </Button>\n      ) : null}\n    </div>\n  )\n})\n"],"names":["UserCard","forwardRef","name","email","avatar","icon","color","size","onLogout","logoutLabel","children","loading","className","style","props","ref","t","useT","avatarSize","buttonSize","jsxs","clsx","styles","jsx","Avatar","Typography","Skeleton","Button","Icon"],"mappings":";;;;;;;;;;;;;;;GAgDaA,IAAWC,EAA0C,SAChE;AAAA,EACE,MAAAC;AAAA,EACA,OAAAC;AAAA,EACA,QAAAC;AAAA,EACA,MAAAC,IAAO;AAAA,EACP,OAAAC,IAAQ;AAAA,EACR,MAAAC,IAAO;AAAA,EACP,UAAAC;AAAA,EACA,aAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC,IAAU;AAAA,EACV,WAAAC;AAAA,EACA,OAAAC;AAAA,EACA,GAAGC;AACL,GACAC,GACA;AACA,QAAMC,IAAIC,EAAA,GAEJC,IAAaX,MAAS,OAAO,OAAOA,MAAS,OAAO,OAAO,MAC3DY,IAAaZ,MAAS,OAAO,OAAO;AAE1C,SACE,gBAAAa;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAAL;AAAA,MACA,WAAWM,EAAKC,EAAO,MAAMA,EAAOf,CAAI,GAAGK,CAAS;AAAA,MACpD,OAAAC;AAAA,MACA,aAAWF,KAAW;AAAA,MACrB,GAAGG;AAAA,MAEJ,UAAA;AAAA,QAAA,gBAAAM,EAAC,OAAA,EAAI,WAAWE,EAAO,UAGrB,UAAA;AAAA,UAAA,gBAAAC;AAAA,YAACC;AAAA,YAAA;AAAA,cACC,MAAMN;AAAA,cACN,MAAAhB;AAAA,cACA,KAAKE;AAAA,cACL,MAAMF,IAAO,SAAYG;AAAA,cACzB,OAAAC;AAAA,cACA,SAAAK;AAAA,YAAA;AAAA,UAAA;AAAA,UAEF,gBAAAS,EAAC,OAAA,EAAI,WAAWE,EAAO,MAErB,UAAA;AAAA,YAAA,gBAAAC,EAACE,GAAA,EAAW,SAAQ,aAAY,UAAQ,IACrC,UAAAd,IAAU,gBAAAY,EAACG,GAAA,EAAS,OAAM,MAAA,CAAM,IAAMxB,KAAQc,EAAE,kBAAkB,GACrE;AAAA,aACEL,KAAWR,KAAS,SACpB,gBAAAoB,EAACE,GAAA,EAAW,SAAQ,WAAU,OAAM,SAAQ,UAAQ,IACjD,UAAAd,IAAU,gBAAAY,EAACG,KAAS,OAAM,OAAM,IAAKvB,EAAA,CACxC;AAAA,UAAA,EAAA,CAEJ;AAAA,QAAA,GACF;AAAA,QAECO;AAAA,QAEAF,IACC,gBAAAe;AAAA,UAACI;AAAA,UAAA;AAAA,YACC,SAAQ;AAAA,YACR,OAAM;AAAA,YACN,MAAMR;AAAA,YACN,WAAS;AAAA,YACT,WAAW,gBAAAI,EAACK,GAAA,EAAK,MAAK,UAAA,CAAU;AAAA,YAChC,SAASpB;AAAA,YAER,UAAAC,KAAeO,EAAE,kBAAkB;AAAA,UAAA;AAAA,QAAA,IAEpC;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGV,CAAC;"}

package/dist/app/AdminRoot.d.cts

@@ -56,8 +56,18 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     authRouteId?: string;
     /** Guard target for signed-out visitors + post-logout redirect. Default `'/login'`. */
     loginPath?: string;
-    /** Show a `UserCard` in the sidebar footer. Default `true`. */
+    /**
+     * Show a `UserCard` (the user + Sign Out) at the bottom of the sidebar — passed to `RootLayout`. Unset, the
+     * app-wide `config.sidebar.userCard` applies (default `false`, hidden).
+     */
     showUserCard?: boolean;
+    /**
+     * The sidebar's look, passed to `RootLayout` — `'floating'` or `'docked'` (flush to the edges). **Unset
+     * (recommended)**, each user picks it in the header Settings drawer (saved), defaulting to the app-wide
+     * `config.sidebar.variant` (`'floating'` when unset). **Set**, it pins the look and the drawer's Sidebar
+     * section is hidden.
+     */
+    sidebarVariant?: RootLayoutProps['sidebarVariant'];
     /**
      * Extra `RootLayout` header config, merged **over** the defaults (the app's fields win). Flows through
      * unchanged — e.g. **`header.menu`** (`HeaderMenuItem[]`) adds items to the account menu above Sign out.
@@ -95,7 +105,7 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
  * supply `logo` + `getUser` + `onLogout`. Public pages (route id under `authRouteId`) render standalone;
- * everything else renders inside the guarded admin shell (`RootLayout` + a sidebar `UserCard`), gated by
+ * everything else renders inside the guarded admin shell (`RootLayout`, with an optional sidebar `UserCard`), gated by
  * `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).
@@ -124,4 +134,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   },
  * })
  */
-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;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/app/AdminRoot.d.ts

@@ -56,8 +56,18 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
     authRouteId?: string;
     /** Guard target for signed-out visitors + post-logout redirect. Default `'/login'`. */
     loginPath?: string;
-    /** Show a `UserCard` in the sidebar footer. Default `true`. */
+    /**
+     * Show a `UserCard` (the user + Sign Out) at the bottom of the sidebar — passed to `RootLayout`. Unset, the
+     * app-wide `config.sidebar.userCard` applies (default `false`, hidden).
+     */
     showUserCard?: boolean;
+    /**
+     * The sidebar's look, passed to `RootLayout` — `'floating'` or `'docked'` (flush to the edges). **Unset
+     * (recommended)**, each user picks it in the header Settings drawer (saved), defaulting to the app-wide
+     * `config.sidebar.variant` (`'floating'` when unset). **Set**, it pins the look and the drawer's Sidebar
+     * section is hidden.
+     */
+    sidebarVariant?: RootLayoutProps['sidebarVariant'];
     /**
      * Extra `RootLayout` header config, merged **over** the defaults (the app's fields win). Flows through
      * unchanged — e.g. **`header.menu`** (`HeaderMenuItem[]`) adds items to the account menu above Sign out.
@@ -95,7 +105,7 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
 /**
  * Root-route component for admin apps — it wires up the whole shell orchestration so an app only has to
  * supply `logo` + `getUser` + `onLogout`. Public pages (route id under `authRouteId`) render standalone;
- * everything else renders inside the guarded admin shell (`RootLayout` + a sidebar `UserCard`), gated by
+ * everything else renders inside the guarded admin shell (`RootLayout`, with an optional sidebar `UserCard`), gated by
  * `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).
@@ -124,4 +134,4 @@ export interface AdminRootProps<U extends AdminUser = AdminUser> {
  *   },
  * })
  */
-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;
+export declare const AdminRoot: <U extends AdminUser = AdminUser>({ logo, logoTo, getUser, onLogout, authRouteId, loginPath, showUserCard, sidebarVariant, header, errorBoundary, pending, pendingFallback, unavailable, unavailableFallback, }: AdminRootProps<U>) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Alert/Alert.d.cts

@@ -16,7 +16,7 @@ export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'
     action?: ReactNode;
     /** When provided, a trailing × close button appears that calls this. */
     onClose?: () => void;
-    /** Accessible label for the close button. Defaults to `"Close"`. */
+    /** Accessible label for the close button. Defaults to the localized "Close" (`common.close`). */
     closeLabel?: string;
     /** Alert message. */
     children?: ReactNode;

package/dist/components/Alert/Alert.d.ts

@@ -16,7 +16,7 @@ export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'
     action?: ReactNode;
     /** When provided, a trailing × close button appears that calls this. */
     onClose?: () => void;
-    /** Accessible label for the close button. Defaults to `"Close"`. */
+    /** Accessible label for the close button. Defaults to the localized "Close" (`common.close`). */
     closeLabel?: string;
     /** Alert message. */
     children?: ReactNode;

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-CY8iU1zd.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-C8BBxL_7.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-CtUr-0s8.js";
+import { A as r, A as t } from "../../Alert-D6oBxBdP.js";
 export {
   r as Alert,
   t as default

package/dist/components/AuthLayout/AuthLayout.d.cts

@@ -12,7 +12,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * kept), so you can pass an unsized logo and it's sized/centered for you.
      */
     logo?: ReactNode;
-    /** Optional glyph in a soft tinted circle above the title — an `IconName` or any node. */
+    /** Optional glyph in a solid `color`-filled circle above the title — an `IconName` or any node. */
     icon?: IconName | ReactNode;
     /** Bottom slot under the form — e.g. a "Back to login" / "Sign up" link row. */
     footer?: ReactNode;
@@ -28,7 +28,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
  * reset-password, OTP, …) — so each page just supplies its `title` + form instead of hand-building the
  * layout. Fills the viewport (`100dvh`) with the app `background` canvas and vertically centers a
  * `logo` (on the canvas, above the card) + an elevated `surface` card, as a group. The card stacks: an
- * optional `icon` (in a soft tinted `Avatar` circle), the `title` + `subtitle` (centered), the
+ * optional `icon` (in a solid `color`-filled `Avatar` circle), the `title` + `subtitle` (centered), the
  * `children` (your form), and an optional `footer` (link row). Token-only styling; responsive.
  *
  * @example

package/dist/components/AuthLayout/AuthLayout.d.ts

@@ -12,7 +12,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
      * kept), so you can pass an unsized logo and it's sized/centered for you.
      */
     logo?: ReactNode;
-    /** Optional glyph in a soft tinted circle above the title — an `IconName` or any node. */
+    /** Optional glyph in a solid `color`-filled circle above the title — an `IconName` or any node. */
     icon?: IconName | ReactNode;
     /** Bottom slot under the form — e.g. a "Back to login" / "Sign up" link row. */
     footer?: ReactNode;
@@ -28,7 +28,7 @@ export interface AuthLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 't
  * reset-password, OTP, …) — so each page just supplies its `title` + form instead of hand-building the
  * layout. Fills the viewport (`100dvh`) with the app `background` canvas and vertically centers a
  * `logo` (on the canvas, above the card) + an elevated `surface` card, as a group. The card stacks: an
- * optional `icon` (in a soft tinted `Avatar` circle), the `title` + `subtitle` (centered), the
+ * optional `icon` (in a solid `color`-filled `Avatar` circle), the `title` + `subtitle` (centered), the
  * `children` (your form), and an optional `footer` (link row). Token-only styling; responsive.
  *
  * @example

package/dist/components/Breadcrumbs/Breadcrumbs.d.cts

@@ -12,6 +12,7 @@ export interface BreadcrumbsProps {
  * content. It always starts with a home icon that links to the first allowed menu page (the same
  * target as `FirstRouteRedirect`), followed by one crumb per matched route that declares a
  * `staticData.name`. Intermediate crumbs link to their page when navigable; the current page is
- * plain text. Renders nothing when the current route has no named matches. Token-only styling.
+ * plain text. Renders nothing when no path prefix has a name and the leaf route has no
+ * `staticData.breadcrumb`. Token-only styling.
  */
 export declare function Breadcrumbs({ separator }?: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -12,6 +12,7 @@ export interface BreadcrumbsProps {
  * content. It always starts with a home icon that links to the first allowed menu page (the same
  * target as `FirstRouteRedirect`), followed by one crumb per matched route that declares a
  * `staticData.name`. Intermediate crumbs link to their page when navigable; the current page is
- * plain text. Renders nothing when the current route has no named matches. Token-only styling.
+ * plain text. Renders nothing when no path prefix has a name and the leaf route has no
+ * `staticData.breadcrumb`. Token-only styling.
  */
 export declare function Breadcrumbs({ separator }?: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

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-hi6dJhfN.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-B-olYVdw.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-Dqhk-dY2.js";
+import { B as e, B as s } from "../../Breadcrumbs-cXET6OM5.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-CYZoF18-.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-CwrDiZek.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-Bst_NtPJ.js";
+import { B as o, B } from "../../Button-0ZgdNjX-.js";
 export {
   o as Button,
   B as default

package/dist/components/Card/Card.d.cts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
-import type { ThemeColor } from '../../theme';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Header title (left, next to the icon). */

package/dist/components/Card/Card.d.ts

@@ -1,5 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
-import type { ThemeColor } from '../../theme';
+import { type ThemeColor } from '../../theme';
 import { type IconName } from '../../icons/names';
 export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'color'> {
     /** Header title (left, next to the icon). */

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-CkZtVNyV.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-CxnUoWsi.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-B91LGIzF.js";
+import { C, C as d } from "../../Card-CjqStov5.js";
 export {
   C as Card,
   d as default

package/dist/components/Chip/Chip.d.cts

@@ -21,7 +21,7 @@ export interface ChipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>
     onDelete?: () => void;
     /** Custom delete icon. Defaults to a `CloseCircle`. */
     deleteIcon?: ReactNode;
-    /** Accessible label for the delete button. Defaults to `"Remove"`. */
+    /** Accessible label for the delete button. Defaults to the localized "Remove" (`common.remove`). */
     deleteLabel?: string;
     /** Tab index for the delete button — pass `-1` when the chip lives inside a composite widget (e.g. a multi-select) that owns keyboard focus. */
     deleteTabIndex?: number;

package/dist/components/Chip/Chip.d.ts

@@ -21,7 +21,7 @@ export interface ChipProps extends Omit<HTMLAttributes<HTMLDivElement>, 'color'>
     onDelete?: () => void;
     /** Custom delete icon. Defaults to a `CloseCircle`. */
     deleteIcon?: ReactNode;
-    /** Accessible label for the delete button. Defaults to `"Remove"`. */
+    /** Accessible label for the delete button. Defaults to the localized "Remove" (`common.remove`). */
     deleteLabel?: string;
     /** Tab index for the delete button — pass `-1` when the chip lives inside a composite widget (e.g. a multi-select) that owns keyboard focus. */
     deleteTabIndex?: number;

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-B7cAHjlx.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-BkU3yx6G.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-D5ZZs3QH.js";
+import { C as e, C as f } from "../../Chip-CzJjbaKx.js";
 export {
   e as Chip,
   f as default

package/dist/components/ChoiceCard/ChoiceCard.d.cts

@@ -32,7 +32,7 @@ export interface ChoiceCardProps extends Omit<InputHTMLAttributes<HTMLInputEleme
 /**
  * A selectable card — a rich checkbox/radio with an icon, title and description. The native input is
  * visually hidden but fully accessible (Space toggles; in an `exclusive` group the cards are real
- * radios, so Arrow keys rove between them); the card shows the state with a accent border + soft halo,
+ * radios, so Arrow keys rove between them); the card shows the state with a `color` border + soft halo,
  * a top-right tick indicator, and an icon circle that fills with the color while selected. Designed to
  * live inside a `<ChoiceCardGroup>` (which supplies the selection, `exclusive` mode and
  * `size`/`color`/`disabled`/`error` via context), but also works standalone as a single fancy checkbox

package/dist/components/ChoiceCard/ChoiceCard.d.ts

@@ -32,7 +32,7 @@ export interface ChoiceCardProps extends Omit<InputHTMLAttributes<HTMLInputEleme
 /**
  * A selectable card — a rich checkbox/radio with an icon, title and description. The native input is
  * visually hidden but fully accessible (Space toggles; in an `exclusive` group the cards are real
- * radios, so Arrow keys rove between them); the card shows the state with a accent border + soft halo,
+ * radios, so Arrow keys rove between them); the card shows the state with a `color` border + soft halo,
  * a top-right tick indicator, and an icon circle that fills with the color while selected. Designed to
  * live inside a `<ChoiceCardGroup>` (which supplies the selection, `exclusive` mode and
  * `size`/`color`/`disabled`/`error` via context), but also works standalone as a single fancy checkbox

package/dist/components/ChoiceCard/index.cjs

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

package/dist/components/ChoiceCard/index.js

@@ -1,4 +1,4 @@
-import { C as o, a as r, C as e } from "../../ChoiceCardGroup-Cx8CtmPl.js";
+import { C as o, a as r, C as e } from "../../ChoiceCardGroup-q0yN-TeQ.js";
 export {
   o as ChoiceCard,
   r as ChoiceCardGroup,

package/dist/components/CodeBlock/CodeBlock.d.cts

@@ -29,6 +29,6 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
  * tick on click — with an optional `title` (e.g. a filename) on its left; `showLineNumbers` (default
  * `true`), `maxHeight` (scrolls inside) and `wrap` shape the body. The whole block
  * keeps VS Code's own dark colors (a deliberate literal-color exception, like the Modal scrim); only
- * the outer border/radius uses `--tz-*` tokens.
+ * the outer radius uses a `--tz-*` token (the border is a literal white-alpha hairline).
  */
 export declare const CodeBlock: import("react").ForwardRefExoticComponent<CodeBlockProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/CodeBlock/CodeBlock.d.ts

@@ -29,6 +29,6 @@ export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ch
  * tick on click — with an optional `title` (e.g. a filename) on its left; `showLineNumbers` (default
  * `true`), `maxHeight` (scrolls inside) and `wrap` shape the body. The whole block
  * keeps VS Code's own dark colors (a deliberate literal-color exception, like the Modal scrim); only
- * the outer border/radius uses `--tz-*` tokens.
+ * the outer radius uses a `--tz-*` token (the border is a literal white-alpha hairline).
  */
 export declare const CodeBlock: import("react").ForwardRefExoticComponent<CodeBlockProps & import("react").RefAttributes<HTMLDivElement>>;

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-C3mG_seZ.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-DRBQ_S5t.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-DrWRSRmO.js";
+import { C as e, C } from "../../CodeBlock-BHcvQrs9.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-C1pDI4su.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-BzCEMN7B.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-w7NdprlW.js";
+import { C as a, C as e } from "../../ColorPicker-BQKFdTNr.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-D9_5JULy.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-n7muILK3.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-Mp_ddhmb.js";
+import { C as r, C } from "../../ColorRamp-yfMyJCyx.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-DZeYcG68.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-DlSi82gv.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-Yg5ZVTiX.js";
+import { C as a, C } from "../../CopyButton-ecxn-ghi.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-CXRsT-lt.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-BjZ_P21i.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-BMJlfCKB.js";
+import { D as r, D as t } from "../../DatePicker-CAGpJbDi.js";
 export {
   r as DatePicker,
   t as default

package/dist/components/DateTimePicker/DateTimePicker.d.cts

@@ -71,8 +71,8 @@ export interface DateTimePickerProps {
  * mode). All math runs in **UTC** so the instant never drifts with the viewer's timezone; the value is a
  * string in `valueFormat` (UTC ISO datetime with a `Z` by default, or no `Z` when `utc={false}`) — incoming values are parsed
  * leniently (a richer backend datetime is accepted) and the chosen instant is emitted in that format.
- * Picking a date keeps the time and vice-versa, and the popover stays open until you click away,
- * press Escape, or hit Done. Supports `hour12`, `minuteStep`, `showSeconds`, `min`/`max`,
+ * Picking a date keeps the time and vice-versa; a day pick advances to the Time tab, and the popover
+ * stays open until you click away, press Escape, or hit Done. Supports `hour12`, `minuteStep`, `showSeconds`, `min`/`max`,
  * `disabledDate`, `weekStartsOn`, and `clearable`. Controlled (`value` + `onChange`) or uncontrolled
  * (`defaultValue`), and binds to a surrounding `<Form>` by `name`. Requires the `dayjs` peer dependency.
  */

package/dist/components/DateTimePicker/DateTimePicker.d.ts

@@ -71,8 +71,8 @@ export interface DateTimePickerProps {
  * mode). All math runs in **UTC** so the instant never drifts with the viewer's timezone; the value is a
  * string in `valueFormat` (UTC ISO datetime with a `Z` by default, or no `Z` when `utc={false}`) — incoming values are parsed
  * leniently (a richer backend datetime is accepted) and the chosen instant is emitted in that format.
- * Picking a date keeps the time and vice-versa, and the popover stays open until you click away,
- * press Escape, or hit Done. Supports `hour12`, `minuteStep`, `showSeconds`, `min`/`max`,
+ * Picking a date keeps the time and vice-versa; a day pick advances to the Time tab, and the popover
+ * stays open until you click away, press Escape, or hit Done. Supports `hour12`, `minuteStep`, `showSeconds`, `min`/`max`,
  * `disabledDate`, `weekStartsOn`, and `clearable`. Controlled (`value` + `onChange`) or uncontrolled
  * (`defaultValue`), and binds to a surrounding `<Form>` by `name`. Requires the `dayjs` peer dependency.
  */

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-BuTIRTUX.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-DZqWQeUL.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-B-Jjejzm.js";
+import { D as r, D as t } from "../../DateTimePicker-BJmF0Su6.js";
 export {
   r as DateTimePicker,
   t as default

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

@@ -45,7 +45,7 @@ export interface DescriptionListProps extends Omit<HTMLAttributes<HTMLDivElement
      * 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. */
+    /** Render shimmering placeholders instead of values — `true` uses one row per visible item (`6` when none), a number sets the count. */
     loading?: boolean | number;
     /** Placeholder for an empty value. Defaults to `"—"`. */
     emptyText?: ReactNode;

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

@@ -45,7 +45,7 @@ export interface DescriptionListProps extends Omit<HTMLAttributes<HTMLDivElement
      * 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. */
+    /** Render shimmering placeholders instead of values — `true` uses one row per visible item (`6` when none), a number sets the count. */
     loading?: boolean | number;
     /** Placeholder for an empty value. Defaults to `"—"`. */
     emptyText?: ReactNode;

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-S9C6Tp90.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-CvPDn-kh.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-CG08_qwT.js";
+import { D as a, D as e } from "../../DescriptionList-Knq5eCiY.js";
 export {
   a as DescriptionList,
   e as default

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-DYYhzKSo.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-CMjURWYd.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-CcC-Hwx4.js";
+import { D as r, D } from "../../Dropdown-CnDBlB02.js";
 export {
   r as Dropdown,
   D 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-DnGds1ch.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-CX1g47y_.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-BCoPw8jf.js";
+import { E as e, E } from "../../EmptyState-Dqtpmtje.js";
 export {
   e as EmptyState,
   E as default

package/dist/components/ErrorState/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ErrorState-MQBeyF2n.cjs"),o=require("../../ErrorBoundary-JCNa0_Ys.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;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ErrorState-CwCqd2PU.cjs"),o=require("../../ErrorBoundary-B8KwWXXp.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.js

@@ -1,5 +1,5 @@
-import { E as a, E as o } from "../../ErrorState-DI28ZCJN.js";
-import { E as t, Q as E } from "../../ErrorBoundary-BILk_3fM.js";
+import { E as a, E as o } from "../../ErrorState-KhzrGIJ-.js";
+import { E as t, Q as E } from "../../ErrorBoundary-Dos7VLb-.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 {
   t as ErrorBoundary,

package/dist/components/FileCard/FileCard.d.cts

@@ -7,9 +7,12 @@ export interface FileCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'tit
     name: string;
     /** File URL — the download target and, for an image, the thumbnail `src`. */
     src?: string;
-    /** File type — an extension (`'pdf'`) or MIME (`'image/png'`). Derived from `name` when omitted. */
+    /**
+     * File MIME type (`'image/png'`) — `image/*` forces image rendering; it supplies the type label only when
+     * `name` has no extension (the name's extension wins). A bare extension here is ignored.
+     */
     type?: string;
-    /** Force image vs. file rendering. Inferred from `type` / `name` / `src` when omitted. */
+    /** Force image vs. file rendering. Inferred from `type` / `name` when omitted. */
     image?: boolean;
     /** File size — a **bytes** number (auto-formatted to `"2.3 MB"`) or a preformatted string. Shown after the type. */
     fileSize?: number | string;