@nxgt/material 3.65.0 → 3.67.0

package/dist/{empty-state-CFLcVzKL.js → empty-state-CQ0CV0kA.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./utils-BLfntITJ.js";
-import { t } from "./use-material-translation-mY3U83TV.js";
-import { t as n } from "./typography-CwhEwPay.js";
+import { t } from "./use-material-translation-DkE9J5NE.js";
+import { t as n } from "./typography-C4JSRr2B.js";
 import { a as r, c as i, i as a, n as o, o as s, r as c, t as l, u } from "./state-scenes-BX03WmSu.js";
 import { Suspense as d } from "react";
 import { jsx as f, jsxs as p } from "react/jsx-runtime";

package/dist/{field-blur-CV9orzdJ.js → field-blur-B2y-bNYi.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./field-blur-context-C8BX8IBy.js";
+import { t as e } from "./field-blur-context-BZtwcPUV.js";
 import { t } from "./useEvent-2fKq-6w8.js";
 import n, { useCallback as r, useEffect as i, useRef as a } from "react";
 import { jsx as o } from "react/jsx-runtime";

package/dist/{field-blur-context-C8BX8IBy.js → field-blur-context-BZtwcPUV.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { l as t } from "./dist-lmHmz_bu.js";
-import { t as n } from "./typography-CwhEwPay.js";
+import { t as n } from "./typography-C4JSRr2B.js";
 import * as r from "react";
 import { createContext as i, use as a, useMemo as o } from "react";
 import { jsx as s, jsxs as c } from "react/jsx-runtime";

package/dist/{hooks-DilW-3jc.js → hooks-DjuYsY-j.js}

@@ -1,6 +1,6 @@
-import { i as e } from "./translate-material-BHL4g2UB.js";
+import { i as e } from "./translate-material-BlCQ6AW9.js";
 import { t } from "./number.utils-BG_eEt5g.js";
-import { n } from "./use-heading-spy-Brcn0l_J.js";
+import { n } from "./use-heading-spy-K-HUp4o_.js";
 import { useCallback as r, useEffect as i, useMemo as a, useRef as o, useState as s } from "react";
 import { jsx as c } from "react/jsx-runtime";
 import { useBlocker as l, useNavigate as u, useSearchParams as d } from "react-router";

package/dist/hooks.js

@@ -1,8 +1,8 @@
 import { a as e, i as t, o as n, r, s as i } from "./theme-store-BdPp43cV.js";
 import { n as a, t as o } from "./use-theme-BCLireTd.js";
-import { a as s, c, d as l, o as u, r as d, s as f, t as p } from "./use-heading-spy-Brcn0l_J.js";
+import { a as s, c, d as l, o as u, r as d, s as f, t as p } from "./use-heading-spy-K-HUp4o_.js";
 import { r as m } from "./use-csp-nonce-ZKs9k-ov.js";
 import { t as h } from "./use-mobile-BDro060N.js";
 import { t as g } from "./use-scroll-away-PQRFZkT2.js";
-import { a as _, c as v, d as y, f as b, g as x, h as S, i as C, l as w, m as T, n as E, o as D, p as O, r as k, s as A, t as j, u as M } from "./hooks-DilW-3jc.js";
+import { a as _, c as v, d as y, f as b, g as x, h as S, i as C, l as w, m as T, n as E, o as D, p as O, r as k, s as A, t as j, u as M } from "./hooks-DjuYsY-j.js";
 export { r as DEFAULT_THEME, t as applyResolvedTheme, e as applyThemeName, _ as buildOptions, s as busySettler, b as clearDrafts, u as createSubmitGuard, D as extractNode, S as isLeaving, n as resolveTheme, i as resolveThemeName, x as shouldBlockNavigation, T as useAllowedTransitions, d as useCountdown, m as useCspNonce, E as useDiscardGuard, O as useDrafts, c as useFocusOnMount, y as useFormatters, p as useHeadingSpy, a as useIsClient, h as useIsMobile, l as useLocalizedDate, w as useNavigationHandler, M as useNavigationHandlers, v as useNumberFormatter, A as useOptions, C as useReactRouterBlock, g as useScrollAway, k as useSearchParam, f as useSubmitOnce, o as useTheme, j as useUnsavedGuard };

package/dist/{hover-card-IeS_1RPH.js → hover-card-BeBVy6tB.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { o as t } from "./dist-DVRQkaTK.js";
 import { a as n, c as r, i, l as a, s as o } from "./dist-lmHmz_bu.js";
-import { C as s, S as c, f as l, m as u, p as d, u as f } from "./spinner-OQAweH2r.js";
+import { C as s, S as c, f as l, m as u, p as d, u as f } from "./spinner-PdSk7zEs.js";
 import { t as p } from "./in-dialog-Vwkyp-M5.js";
 import { i as m } from "./escape-owner-DpaP0lm1.js";
 import * as h from "react";

package/dist/i18n.js

@@ -1,8 +1,8 @@
 import { t as e } from "./is-production-GLw59WU8.js";
-import { c as t, d as n, i as r, l as i, n as a, o, r as s, t as c, u as l } from "./translator-BJsjXcAp.js";
-import { i as u, n as d, r as f, t as p } from "./translate-material-BHL4g2UB.js";
+import { c as t, d as n, i as r, l as i, n as a, o, r as s, t as c, u as l } from "./translator-ChpeKCO3.js";
+import { i as u, n as d, r as f, t as p } from "./translate-material-BlCQ6AW9.js";
 import { o as m, t as h } from "./merge-BCZE6HGq.js";
-import { t as g } from "./use-material-translation-mY3U83TV.js";
+import { t as g } from "./use-material-translation-DkE9J5NE.js";
 import { useCallback as _ } from "react";
 //#region lib/i18n/merge-resources.ts
 function v(e, t, n = "") {

package/dist/{icon-badge-Bf4SoA2i.js → icon-badge-DbYsbzwZ.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./utils-BLfntITJ.js";
-import { a as t, i as n, n as r } from "./field-blur-context-C8BX8IBy.js";
-import { t as i } from "./icon-button-l3dQTRrC.js";
-import { f as a } from "./dialog-DWNaxpa-.js";
+import { a as t, i as n, n as r } from "./field-blur-context-BZtwcPUV.js";
+import { t as i } from "./icon-button-Co6ttdv1.js";
+import { f as a } from "./dialog-Co5oksU1.js";
 import { isValidElement as o, useId as s } from "react";
 import { jsx as c, jsxs as l } from "react/jsx-runtime";
 import { describedBy as u } from "@nxgt/material-core/described-by";

package/dist/{icon-button-l3dQTRrC.js → icon-button-Co6ttdv1.js}

@@ -1,7 +1,7 @@
 import { t as e } from "./utils-BLfntITJ.js";
 import { n as t } from "./use-shape-morph-BKA_R5P5.js";
 import { n, t as r } from "./dist-DVRQkaTK.js";
-import { n as i, r as a, t as o } from "./spinner-OQAweH2r.js";
+import { n as i, r as a, t as o } from "./spinner-PdSk7zEs.js";
 import { a as s, i as c, n as l, o as u, r as d, s as f, t as p } from "./use-click-lock-BZYtTmVt.js";
 import { t as m } from "./is-production-GLw59WU8.js";
 import { t as h } from "./button-group-context-CaP0X5p_.js";

package/dist/lib/components/ui/actions/back-link/back-link.d.ts

@@ -0,0 +1,10 @@
+import { ComponentProps } from 'react';
+import { LinkButton } from '../link/link.js';
+export type BackLinkProps = ComponentProps<typeof LinkButton>;
+/**
+ * A link to the parent page: a ghost `LinkButton` with a leading arrow. The
+ * label names the destination and is the link's accessible name (the arrow is
+ * hidden from assistive tech); the arrow mirrors in right-to-left. It takes
+ * every `LinkButton` prop, `variant`, `color`, `size` and `linkComponent` included.
+ */
+export declare function BackLink({ variant, className, children, ...props }: BackLinkProps): import("react").JSX.Element;

package/dist/lib/components/ui/actions/back-link/index.d.ts

@@ -0,0 +1 @@
+export * from './back-link.js';

package/dist/lib/components/ui/actions/index.d.ts

@@ -1,4 +1,5 @@
 export * from './action-card/index.js';
+export * from './back-link/index.js';
 export * from './button/index.js';
 export * from './button-group/index.js';
 export * from './copy-button/index.js';
@@ -12,6 +13,7 @@ export * from './load-more-footer/index.js';
 export * from './responsive-button/index.js';
 export * from './scroll-to-latest-button/index.js';
 export * from './scroll-to-top/index.js';
+export * from './share-button/index.js';
 export * from './split-button/index.js';
 export * from './theme-toggle/index.js';
 export * from './toolbar/index.js';

package/dist/lib/components/ui/actions/link/link.d.ts

@@ -1,25 +1,7 @@
-import { LinkProps } from 'react-router';
-import { LinkComponent } from '../../primitives/link/link-component.js';
+import { RouterLinkProps } from '../../primitives/link/router-link.js';
 import { ButtonProps } from '../button/button.js';
 import { IconButtonProps } from '../icon-button/icon-button.js';
 import { ResponsiveButtonProps } from '../responsive-button/responsive-button.js';
-type RouterLinkProps = Pick<LinkProps, 'to' | 'replace' | 'state' | 'target' | 'reloadDocument' | 'preventScrollReset'> & {
-    /**
-     * @deprecated Use ActivityLayout's route transition (React's
-     * `<ViewTransition>`); removed after React Router v9.
-     */
-    viewTransition?: LinkProps['viewTransition'];
-    /** Saves the target instead of opening it: `true`, or the file name. */
-    download?: boolean | string;
-    /**
-     * Renders the link with this component instead of React Router's `Link`;
-     * it wins over `LinkComponentProvider`. It receives `to` as `href`, with
-     * `target`, `download` and the button's classes; `replace`, `state`,
-     * `reloadDocument` and `preventScrollReset` are router-only and not passed.
-     */
-    linkComponent?: LinkComponent;
-};
 export declare function LinkButton({ variant, className, children, ...props }: Omit<ButtonProps, 'asChild'> & RouterLinkProps): import("react").JSX.Element;
 export declare function IconLinkButton({ variant, children, ...props }: Omit<IconButtonProps, 'asChild'> & RouterLinkProps): import("react").JSX.Element;
 export declare function ResponsiveLinkButton({ variant, children, ...props }: Omit<ResponsiveButtonProps, 'asChild'> & RouterLinkProps): import("react").JSX.Element;
-export {};

package/dist/lib/components/ui/actions/share-button/index.d.ts

@@ -0,0 +1,3 @@
+export type { ShareButtonProps } from './share-button.js';
+export { SHARE_BUTTON_LABEL, ShareButton } from './share-button.js';
+export type { ShareData, ShareOutcome } from './share-or-copy.js';

package/dist/lib/components/ui/actions/share-button/share-button.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { IconButtonProps } from '../icon-button/icon-button.js';
+import { ShareData, ShareOutcome } from './share-or-copy.js';
+/** The button's accessible name when no `label` is given (English fallback). */
+export declare const SHARE_BUTTON_LABEL = "Share";
+export type ShareButtonProps = Omit<IconButtonProps, 'onClick' | 'children' | 'tooltip' | 'title'> & ShareData & {
+    /** The button's accessible name; it never changes after a click. */
+    label?: string;
+    /** Announced (not a new name) once the link is on the clipboard. */
+    copiedLabel?: string;
+    /** Announced when the clipboard refused the text. */
+    failedLabel?: string;
+    icon?: ReactNode;
+    /** Called with the outcome once the share or the copy is over. */
+    onShare?: (outcome: ShareOutcome) => void;
+};
+export declare function ShareButton({ title, text, url, label, copiedLabel, failedLabel, icon, onShare, variant, color, ...props }: ShareButtonProps): import("react").JSX.Element;

package/dist/lib/components/ui/actions/share-button/share-or-copy.d.ts

@@ -0,0 +1,17 @@
+import { CopyResult } from '../copy-button/use-copy-status.js';
+/** What the Web Share API takes. */
+export type ShareData = {
+    title?: string;
+    text?: string;
+    url?: string;
+};
+/** `shared` and `cancelled` happen in the system sheet; the others are a copy. */
+export type ShareOutcome = 'shared' | 'cancelled' | CopyResult;
+/** What the fallback puts on the clipboard: the link, else the text, else the title. */
+export declare function copyTextOf(data: ShareData): string;
+/**
+ * Opens the system share sheet when there is one; copies otherwise, or when
+ * the sheet failed for a reason other than the user closing it. Reads
+ * `navigator` when called (a click), never during render, so it is SSR-safe.
+ */
+export declare function shareOrCopy(data: ShareData, copy: (text: string) => Promise<CopyResult | undefined>): Promise<ShareOutcome | undefined>;

package/dist/lib/components/ui/collections/dnd/index.d.ts

@@ -1,7 +1,7 @@
 export { type CollisionDetection, closestCenter, type DragEndEvent, pointerWithin, rectIntersection, type UniqueIdentifier, } from '@dnd-kit/core';
 export { arrayMove, horizontalListSortingStrategy, verticalListSortingStrategy, } from '@dnd-kit/sortable';
 export { CSS } from '@dnd-kit/utilities';
-export { composeRefs } from './compose-refs.js';
+export { composeRefs } from '../../../../lib/compose-refs.js';
 export type { DndItemContextValue } from './dnd-item-context.js';
 export { useDndItem } from './dnd-item-context.js';
 export type { DndOverlayProps } from './dnd-overlay.js';

package/dist/lib/components/ui/collections/row-menu/index.d.ts

@@ -1,3 +1,4 @@
 export * from './row-menu.js';
 export * from './row-menu-column.js';
 export * from './row-menu-trigger.js';
+export * from './use-row-menu-focus.js';

package/dist/lib/components/ui/collections/row-menu/row-menu.d.ts

@@ -24,6 +24,11 @@ export type RowMenuProps = {
     items?: RowMenuItem[];
     /** Menu content of your own (groups, checkbox items), above `items`. */
     children?: ReactNode;
+    /**
+     * The row's id (`getRowId`'s), written on the trigger so `useRowMenuFocus`
+     * can hand the focus back to this row's trigger. `rowMenuColumn` sets it.
+     */
+    rowId?: string;
     /** The trigger's own props (`disabled`, `className`, `data-*`). */
     triggerProps?: RowMenuTriggerAttrs;
     /** Controlled state, as `DropdownMenu`'s. */
@@ -37,4 +42,4 @@ export type RowMenuProps = {
  * ones come last, after a separator. Focus returns to the trigger when the
  * menu closes, and when a dialog opened from an item closes.
  */
-export declare function RowMenu({ label, items, children, triggerProps, open, onOpenChange, className, }: RowMenuProps): import("react").JSX.Element;
+export declare function RowMenu({ label, items, children, rowId, triggerProps, open, onOpenChange, className, }: RowMenuProps): import("react").JSX.Element;

package/dist/lib/components/ui/collections/row-menu/use-row-menu-focus.d.ts

@@ -0,0 +1,30 @@
+/** The row menu trigger carrying exactly this id, inside `scope`. */
+export declare function findRowMenuTrigger(rowId: string, scope?: ParentNode): HTMLElement | null;
+/**
+ * Focuses the trigger of row `rowId` inside `scope`, and claims it again for
+ * the next frames if something takes the focus meanwhile (a dialog's
+ * focus scope restores the focus in its own `setTimeout(0)`, a toast can
+ * grab it). Answers at once: `true` when the trigger is found and holds the
+ * focus right now.
+ */
+export declare function focusRowMenuTrigger(rowId: string, scope?: ParentNode): boolean;
+/**
+ * Hands the focus back to one row's `RowMenu` trigger once an async action
+ * settles, or a toast or a dialog it opened has closed (#2075). Pass `focusRef`
+ * to the table (`DataTable`'s `focusRef`, or the `ref` of any element holding
+ * the rows) so two tables never share a row id, and call
+ * `focusRowMenu(row.id)` right after the action settles or the dialog closes.
+ * The row is matched by its id exactly (`getRowId`'s, `RowMenu`'s `rowId`),
+ * never by its label. The focus is taken at once and claimed again for two
+ * frames if a dialog's focus restore or a toast takes it. For those two frames
+ * the focus is claimed back to the trigger whatever took it, so a deliberate
+ * focus move (Tab, or a dialog or toast opened right after the call) within
+ * them is overridden: call it once the follow-up UI is done. Returns `true`
+ * when the trigger was found and holds the focus; `false` for a row that went
+ * away
+ * (archived, deleted) or a trigger that cannot take it (disabled, inert).
+ */
+export declare function useRowMenuFocus(): {
+    focusRef: import('react').RefObject<HTMLElement | null>;
+    focusRowMenu: (rowId: string) => boolean;
+};

package/dist/lib/components/ui/display/enrolment-card/use-enrolment-card-labels.d.ts

@@ -1,3 +1,3 @@
 import { EnrolmentCardLabels } from './types.js';
-/** The built-in words (English or the active language), with their overrides. */
+/** The built-in words (English or the active language), with their overrides (an explicit `undefined` keeps the built-in label). */
 export declare function useEnrolmentCardLabels(overrides?: Partial<EnrolmentCardLabels>): EnrolmentCardLabels;

package/dist/lib/components/ui/display/recovery-codes/use-recovery-codes-labels.d.ts

@@ -1,5 +1,5 @@
 import { RecoveryCodesLabels } from './types.js';
-/** The built-in title and warning, and the labels with their overrides. */
+/** The built-in title and warning, and the labels with their overrides (an explicit `undefined` keeps the built-in label). */
 export declare function useRecoveryCodesLabels(overrides?: Partial<RecoveryCodesLabels>): {
     labels: RecoveryCodesLabels;
     title: string;

package/dist/lib/components/ui/display/recovery-codes-status/use-recovery-codes-status-labels.d.ts

@@ -1,3 +1,3 @@
 import { RecoveryCodesStatusLabels } from './types.js';
-/** The built-in words (English or the active language), with their overrides. */
+/** The built-in words (English or the active language), with their overrides (an explicit `undefined` keeps the built-in label). */
 export declare function useRecoveryCodesStatusLabels(overrides?: Partial<RecoveryCodesStatusLabels>): RecoveryCodesStatusLabels;

package/dist/lib/components/ui/display/stat-card/partials/stat-card-link-parts.d.ts

@@ -0,0 +1,7 @@
+import { StatCardSize } from '../types.js';
+/** What a linked card adds to its own classes: the anchor's hover and focus-visible states. */
+export declare const STAT_CARD_LINKED = "relative group-hover/stat-link:border-primary/40 group-focus-visible/stat-link:ring-[3px] group-focus-visible/stat-link:ring-ring/50";
+/** A link must read as one without hover (a phone has none): a trailing chevron. */
+export declare function StatCardChevron({ size }: {
+    size: StatCardSize;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/display/stat-card/stat-card.d.ts

@@ -1,3 +1,8 @@
 import { StatCardProps } from './types.js';
 export type { StatCardProps, StatCardSize, StatCardValueSize, StatCardVariant, } from './types.js';
-export declare function StatCard({ label, value, hint, delta, deltaTone, icon, loading, tone, variant, valueSize, size, className, ...props }: StatCardProps): import("react").JSX.Element;
+/**
+ * The KPI tile. With `href` the whole card is one link (an `<a>`, or the
+ * `linkComponent` / `LinkComponentProvider` link) with the card's hover and
+ * focus-visible styles, named by its label and value.
+ */
+export declare function StatCard({ href, linkComponent, ...props }: StatCardProps): import("react").JSX.Element;

package/dist/lib/components/ui/display/stat-card/types.d.ts

@@ -1,5 +1,6 @@
 import { ComponentProps, ReactNode } from 'react';
 import { Card } from '../../primitives/card/card.js';
+import { LinkComponent } from '../../primitives/link/link-component.js';
 import { Tone } from '../../tones.js';
 import { StatDeltaTone } from './format-stat-delta.js';
 export type StatCardVariant = 'outlined' | 'tonal' | 'filled';
@@ -34,6 +35,19 @@ export type StatCardProps = Omit<ComponentProps<typeof Card>, 'children'> & {
      * apply to it.
      */
     size?: StatCardSize;
+    /**
+     * Makes the whole card one link to this address. The anchor wraps the card
+     * (one tab stop; its accessible name is the label and the value), the card
+     * gains a hover border and a focus-visible ring, and `className` and the
+     * other props still go on the card. An external address (`https://`, `mailto:`) is a plain `<a target="_blank" rel="noreferrer">`, as in `LinkCard`. Without it the card is a plain `div`.
+     */
+    href?: string;
+    /**
+     * With `href`: renders the link with this component (your router's `Link`
+     * wrapped to take `href`) instead of a plain `<a>`; it wins over
+     * `LinkComponentProvider`. It must spread every prop it receives.
+     */
+    linkComponent?: LinkComponent;
     /** `display` draws the value larger (`headline-large`); `default` is `headline-small`. */
     valueSize?: StatCardValueSize;
 };

package/dist/lib/components/ui/feedback/step-up-dialog/use-step-up-labels.d.ts

@@ -1,3 +1,3 @@
 import { StepUpDialogLabels } from './types.js';
-/** The built-in words (English or the active language), with their overrides. */
+/** The built-in words (English or the active language), with their overrides (an explicit `undefined` keeps the built-in label). */
 export declare function useStepUpLabels(overrides?: Partial<StepUpDialogLabels>): StepUpDialogLabels;