@nxgt/material 3.39.0 → 3.42.0

package/dist/{empty-state-DKgPt475.js → empty-state-BzwyRX5J.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./utils-BLfntITJ.js";
-import { t } from "./use-material-translation-kISeB-fY.js";
+import { t } from "./use-material-translation-CFF73jk5.js";
 import { i as n } from "./escape-owner-C4W_sOAU.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 { AlertCircle as d, Construction as f, FileQuestion as p, PackageOpen as m, Search as h, ShieldAlert as g, WifiOff as _ } from "lucide-react";

package/dist/hooks.js

@@ -1,8 +1,8 @@
-import { r as e } from "./i18n-provider-Bc7bdIRW.js";
+import { r as e } from "./i18n-provider-DkeMr5bw.js";
 import { a as t, i as n, o as r, r as i, s as a } from "./theme-store-CSl51uNH.js";
 import { n as o, t as s } from "./use-theme-DMcyJ52N.js";
 import { t as c } from "./number.utils-BG_eEt5g.js";
-import { n as l, r as u, t as d } from "./use-heading-spy-uyhOQV2O.js";
+import { n as l, r as u, t as d } from "./use-heading-spy-wElRpO2G.js";
 import { r as f } from "./use-csp-nonce-ZKs9k-ov.js";
 import { t as p } from "./use-mobile-BDro060N.js";
 import { t as m } from "./use-scroll-away-PQRFZkT2.js";

package/dist/{i18n-provider-Bc7bdIRW.js → i18n-provider-DkeMr5bw.js}

@@ -1,4 +1,4 @@
-import { i as e, r as t, t as n } from "./stored-language-Bbwcy-Pv.js";
+import { i as e, r as t, t as n } from "./stored-language-B5SMR-W2.js";
 import { createContext as r, useCallback as i, useContext as a, useMemo as o, useState as s } from "react";
 import { jsx as c } from "react/jsx-runtime";
 //#region lib/i18n/i18n-provider.tsx

package/dist/i18n.js

@@ -1,10 +1,10 @@
 import { t as e } from "./is-production-GLw59WU8.js";
-import { a as t, i as n, n as r, r as i } from "./stored-language-Bbwcy-Pv.js";
-import { n as a, r as o, t as s } from "./i18n-provider-Bc7bdIRW.js";
-import { i as c, n as l, o as u, r as d, t as f } from "./translator-D7AVZCfQ.js";
+import { a as t, i as n, n as r, r as i } from "./stored-language-B5SMR-W2.js";
+import { n as a, r as o, t as s } from "./i18n-provider-DkeMr5bw.js";
+import { i as c, n as l, o as u, r as d, t as f } from "./translator-C-_M57ZA.js";
 import { o as p, t as m } from "./merge-BCZE6HGq.js";
-import { t as h } from "./translate-material-CRF13PON.js";
-import { t as g } from "./use-material-translation-kISeB-fY.js";
+import { t as h } from "./translate-material-BYRDtSEk.js";
+import { t as g } from "./use-material-translation-CFF73jk5.js";
 import { useCallback as _ } from "react";
 //#region lib/i18n/merge-resources.ts
 function v(e, t, n = "") {

package/dist/{icon-badge-BzLsPW3c.js → icon-badge-D_z5BGbc.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./utils-BLfntITJ.js";
-import { f as t } from "./dialog-DGlnqBbX.js";
+import { f as t } from "./dialog-uQld1gKm.js";
 import { a as n, i as r, n as i } from "./field-blur-context-Cft9s7Hg.js";
 import { t as a } from "./icon-button-CN9r5TNE.js";
 import { isValidElement as o, useId as s } from "react";

package/dist/lib/charts/index.d.ts

@@ -8,7 +8,9 @@
  *
  * `LineChart`, `AreaChart`, `BarChart` and `ComboChart` also take `zoom` (a mini
  * overview that picks the rows shown) and `scroll` (a dense plot scrolls
- * sideways on a phone). Guide: docs/guides/charts.md.
+ * sideways on a phone). `LineChart` and `AreaChart` also take `bands`,
+ * `thresholds` and `pointTone` to read values against a reference. Guide:
+ * docs/guides/charts.md.
  *
  * The parts use hooks and the browser: this entry's built files carry no
  * `'use client'` directive, so render the charts from a file of your own

package/dist/lib/components/ui/collections/server-table/bulk-action-targets.d.ts

@@ -1,3 +1,4 @@
+import { ReactNode } from 'react';
 import { ServerTableBulkAction } from './bulk-action.js';
 import { SelectedRows } from './selected-rows.js';
 /**
@@ -10,3 +11,20 @@ export declare function bulkActionTargets<T>(action: Pick<ServerTableBulkAction<
     ids: string[];
     rows: T[];
 };
+/** Whether `count` applicable rows is past the action's `max` (no `max`: never). */
+export declare function isOverMax(action: Pick<ServerTableBulkAction<unknown>, 'max'>, count: number): boolean;
+/** The action's accessible name for `count` rows: its `name`, else `fallback`. */
+export declare function bulkActionName(action: Pick<ServerTableBulkAction<unknown>, 'name'>, count: number, fallback: string): string;
+/** What replaces the button past `max`: its `maxNotice` (called with the
+ * count and `max` when a function), else `fallback`. */
+export declare function bulkActionNotice(action: Pick<ServerTableBulkAction<unknown>, 'max' | 'maxNotice'>, count: number, fallback: ReactNode): ReactNode;
+/** The actions that apply to at least one selected row, with their targets
+ * and whether they are past their `max`. */
+export declare function bulkEntries<T>(actions: readonly ServerTableBulkAction<T>[], ids: readonly string[], selectedRows: SelectedRows<T>): {
+    over: boolean;
+    action: ServerTableBulkAction<T>;
+    target: {
+        ids: string[];
+        rows: T[];
+    };
+}[];

package/dist/lib/components/ui/collections/server-table/bulk-action.d.ts

@@ -1,6 +1,26 @@
 import { ReactNode } from 'react';
 import { ButtonProps } from '../../actions/button/button.js';
 import { ServerTableSelection } from './types.js';
+/**
+ * What a bulk action's `onClick` gets last, to give the focus back after a
+ * step that moved it (a confirm dialog, a menu).
+ */
+export type ServerTableBulkContext = {
+    /**
+     * The element the action was started from: its button, or the "More"
+     * button for an item of the phone's More menu. `null` when it is not on
+     * screen.
+     */
+    trigger: HTMLElement | null;
+    /**
+     * Gives the focus back to the trigger, found again at call time, so it
+     * works after the button re-rendered. When the action is hidden since
+     * (its count fell to 0, or past `max`), the focus goes to the next bulk
+     * action, else to "More", else to the table's "Select all" (the table
+     * itself without one), never to the body.
+     */
+    focusTrigger: () => void;
+};
 /**
  * One declarative bulk action of `ServerTable`'s `bulkActions` list. Its
  * button reads "Label (n)", n being the selected rows it applies to (the
@@ -21,9 +41,36 @@ export type ServerTableBulkAction<T> = {
      * action applies to the whole selection.
      */
     appliesTo?: (row: T) => boolean;
-    /** Runs with the ids (and the rows kept for them) it applies to, never the whole
-     * selection when `appliesTo` is set. */
-    onClick: (ids: string[], selection: ServerTableSelection, rows: T[]) => void;
+    /**
+     * The button's accessible name and tooltip for `count` rows it applies
+     * to, e.g. `(n) => `Archive ${n} people``. Without it the name is
+     * "Label n rows" (`material.server-table.bulk-action-name`). Start it
+     * with the visible `label` (WCAG 2.5.3, Label in Name): the visible text
+     * is "Label (n)", so "Archive 2 people" matches it for speech input.
+     * Applies to the toolbar, the phone's bar and the More menu's items.
+     */
+    name?: (count: number) => string;
+    /**
+     * The most rows one call takes. Above it (counted on the rows the action
+     * applies to) the button is replaced by `maxNotice`: a muted text on the
+     * toolbar and the phone's bar, and a disabled item that shows it as its
+     * description in the More menu. Without it there is no limit.
+     */
+    max?: number;
+    /**
+     * What replaces the button past `max`. A function gets the count and
+     * `max`. Default `material.server-table.bulk-max-notice`: "Select 100 rows or
+     * fewer to archive". It is announced politely once, when the action goes
+     * past `max`, not each time the count changes.
+     */
+    maxNotice?: ReactNode | ((count: number, max: number) => ReactNode);
+    /**
+     * Runs with the ids (and the rows kept for them) it applies to, never the
+     * whole selection when `appliesTo` is set. `context` is the trigger and
+     * `focusTrigger()`: call it when a dialog opened by the step closes.
+     * Handlers that take three parameters stay valid.
+     */
+    onClick: (ids: string[], selection: ServerTableSelection, rows: T[], context: ServerTableBulkContext) => void;
     /** The button's variant. Default `'tonal'`. */
     variant?: ButtonProps['variant'];
     /** The button's colour, e.g. `'destructive'`. */

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-buttons.d.ts

@@ -5,9 +5,11 @@ import { ServerTableSelection } from '../types.js';
 /**
  * The buttons of a declarative `bulkActions` list: "Label (n)", n being the
  * selected rows the action applies to, named "Label n rows" for assistive
- * technology, and not rendered at all when n is 0. An action runs with the
- * rows it applies to only, tested on the rows kept for the selection (see
- * `syncSelectedRows`), so the counts hold across pages.
+ * technology (or by the action's `name`), and not rendered at all when n is
+ * 0. Past the action's `max` its button gives way to its notice. An action
+ * runs with the rows it applies to only, tested on the rows kept for the
+ * selection (see `syncSelectedRows`), so the counts hold across pages. Its
+ * `onClick` also gets the trigger and `focusTrigger()`.
  */
 export declare function ServerTableBulkButtons<T extends RowData>({ actions, ids, selectedRows, selection, onFocusLost, phone, }: {
     actions: readonly ServerTableBulkAction<T>[];

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-focus.d.ts

@@ -0,0 +1,31 @@
+import { ServerTableBulkContext } from '../bulk-action.js';
+/** The id of the phone's "More" button in the focus bookkeeping. */
+export declare const MORE = "\0more";
+/**
+ * Where the focus of a declarative bulk list goes. It remembers the bulk
+ * button that has it, and the buttons on screen, so that:
+ * - a focused button that disappears (its count fell to 0, or went past
+ *   `max`) hands the focus to the next bulk button, else "More", else
+ *   `onFocusLost` (the table's "Select all", else the table);
+ * - `focusTrigger()` of an action's context does the same from the action,
+ *   found again at call time, so it works after the button re-rendered.
+ */
+export declare function useBulkFocus({ order, shown, onFocusLost, }: {
+    /** Every action id, in the list's order. */
+    order: readonly string[];
+    /** The ids of the buttons on screen (More included). */
+    shown: readonly string[];
+    onFocusLost?: () => void;
+}): {
+    track: (id: string) => {
+        onFocus: () => void;
+        onBlur: () => void;
+    };
+    ref: (id: string) => (element: HTMLButtonElement | null) => void;
+    /** The button of `id`, if it is on screen. */
+    button: (id: string) => HTMLButtonElement | null;
+    /** Remembers `id` as the focus's place (a menu item blurred it). */
+    remember: (id: string) => void;
+    /** The context of `actionId`'s `onClick`, started from `triggerId`'s button. */
+    context: (actionId: string, triggerId: string) => ServerTableBulkContext;
+};

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-more.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { ServerTableBulkAction } from '../bulk-action.js';
+import { ServerTableSelection } from '../types.js';
+import { useBulkFocus } from './server-table-bulk-focus.js';
+export type BulkMoreEntry<T> = {
+    action: ServerTableBulkAction<T>;
+    target: {
+        ids: string[];
+        rows: T[];
+    };
+    label: string;
+    name: string;
+    /** Set past the action's `max`: the item is disabled and shows it. */
+    notice: ReactNode | null;
+};
+/** The phone bar's "More" menu: one item per action past the third, each
+ * with its count. Past its `max` an item is disabled and its notice is its
+ * description (`aria-describedby`), under the label. */
+export declare function BulkMoreMenu<T>({ entries, selection, focus, moreLabel, }: {
+    entries: BulkMoreEntry<T>[];
+    selection: ServerTableSelection;
+    focus: ReturnType<typeof useBulkFocus>;
+    moreLabel: string;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-notice.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+/** The text that stands for a bulk action past its `max`, muted, in place of its button. */
+export declare function BulkNotice({ action, children, }: {
+    action: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Tells the notices politely, once: the live region is always rendered and
+ * only its content changes, when an action goes past its `max` (its notice
+ * is added), not when the count moves while it stays past it. It empties
+ * when no action is past `max`.
+ */
+export declare function BulkNoticeAnnouncer({ notices, }: {
+    /** The notice of every action past its `max`, by action id. */
+    notices: ReadonlyMap<string, ReactNode>;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/collections/server-table/partials/server-table-bulk-texts.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { ServerTableBulkAction } from '../bulk-action.js';
+/** The visible label, accessible name and max notice of a bulk action, translated. */
+export declare function useBulkTexts<T>(): {
+    label: (action: ServerTableBulkAction<T>, count: number) => string;
+    name: (action: ServerTableBulkAction<T>, count: number) => string;
+    notice: (action: ServerTableBulkAction<T>, count: number) => ReactNode;
+    more: string;
+};

package/dist/lib/components/ui/collections/server-table/server-table.d.ts

@@ -1,6 +1,6 @@
 import { RowData } from '@tanstack/react-table';
 import { ServerTableProps } from './types.js';
-export type { ServerTableBulkAction } from './bulk-action.js';
+export type { ServerTableBulkAction, ServerTableBulkContext, } from './bulk-action.js';
 export type { ServerTableEmpty, ServerTableError, ServerTableFilter, ServerTableFilterHandle, ServerTableProps, ServerTableSelection, } from './types.js';
 /**
  * One server page of a list in a `manual` `DataTable`, its state in the URL