@nxgt/material 3.47.0 → 3.49.0

package/dist/lib/components/ui/collections/filter/query/filter-query-model.d.ts

@@ -0,0 +1,49 @@
+import { FilterApply, FilterCountsOption, FilterDefaults, FilterEvent, FilterFieldErrors, FilterFocusTarget, FilterMachineState, FilterModel, FilterPreviewCount, FilterQuery } from '@nxgt/material-core/filter';
+import { ReactNode, RefObject } from 'react';
+import { FilterDensity, FilterSearchApply } from './types.js';
+import { FilterBarFields } from './use-filter-bar-fields.js';
+/** What every part of the bar reads (`useFilterQueryContext`). */
+export type FilterQueryModel = FilterBarFields & {
+    model: FilterModel;
+    machine: FilterMachineState;
+    /** The `default: 'page'` fields' values (the `defaults` prop). */
+    defaults?: FilterDefaults;
+    /** A server's refusal per field id (the `errors` prop). */
+    errors?: FilterFieldErrors;
+    /** The search box's refusal (the `searchError` prop). */
+    searchError?: ReactNode;
+    /** A refusal of no field (the `formError` prop). */
+    formError?: ReactNode;
+    /** Show the field errors' words under the bar (the `errorSummary` prop). */
+    errorSummary: boolean;
+    applied: FilterQuery;
+    editing: string | null;
+    /** An edit not carried yet: the count shown is the previous query's. */
+    pending: boolean;
+    /** The applied query is the one "Clear all" left. */
+    cleared: boolean;
+    /** The field "Add filter" just added, while the applied query is the one it left. */
+    added: string | null;
+    /** How many filters Done added, so each is told. */
+    addedCount: number;
+    loading: boolean;
+    resultCount?: number;
+    density: FilterDensity;
+    apply: FilterApply;
+    searchApply: FilterSearchApply;
+    searchMinLength: number;
+    previewCount?: FilterPreviewCount;
+    counts?: FilterCountsOption;
+    /** The element around the bar (a `div`): the focus contract finds the chips in it. */
+    rootRef: RefObject<HTMLDivElement | null>;
+    send: (event: FilterEvent) => void;
+    /** Applies `query` at once, without live apply's delay (the sheet's "Show N results"). */
+    applyNow: (query: FilterQuery) => void;
+    /** Makes the pending edit apply now rather than after `liveDelayMs` (a text field's Enter). */
+    applyPending: () => void;
+    /** Holds live apply while the phone sheet holds its history entry. */
+    suspendLive: (suspended: boolean) => void;
+    setEditing: (field: string | null) => void;
+    /** Focuses a target of the core's focus contract, once painted. */
+    focus: (target: FilterFocusTarget) => void;
+};

package/dist/lib/components/ui/collections/filter/query/types.d.ts

@@ -95,6 +95,14 @@ export type FilterQueryProps = {
      * the page when the query changes.
      */
     formError?: ReactNode;
+    /**
+     * Show the field errors' words under the bar (default `true`): one error
+     * `Alert`, a line per refused field that names it ("Period: choose 366
+     * days or fewer."), after `formError` when both are set, so a refused,
+     * empty list says what went wrong. It is no live region; the bar's one
+     * tells the refusal once. `false` keeps the "Invalid" pills only.
+     */
+    errorSummary?: boolean;
     /** How long the live apply waits after an edit (ms, default 200). */
     liveDelayMs?: number;
     /**

package/dist/lib/components/ui/collections/filter/query/use-filter-query-options.d.ts

@@ -1,10 +1,11 @@
 import { FilterQueryProps } from './types.js';
 /** The props the model only carries through, with their defaults. */
-export declare function viewOptions({ defaults, errors, searchError, formError, loading, resultCount, density, apply, searchApply, searchMinLength, previewCount, counts, }: FilterQueryProps): {
+export declare function viewOptions({ defaults, errors, searchError, formError, errorSummary, loading, resultCount, density, apply, searchApply, searchMinLength, previewCount, counts, }: FilterQueryProps): {
     defaults: Readonly<Record<string, readonly string[]>> | undefined;
     errors: Readonly<Record<string, string>> | undefined;
     searchError: import('react').ReactNode;
     formError: import('react').ReactNode;
+    errorSummary: boolean;
     loading: boolean;
     resultCount: number | undefined;
     density: import('./types.js').FilterDensity;

package/dist/lib/components/ui/collections/filter/query/use-filter-query-value.d.ts

@@ -18,6 +18,7 @@ export declare function useFilterQueryValue(props: FilterQueryProps): {
     errors?: import('@nxgt/material-core/filter').FilterFieldErrors;
     searchError?: import('react').ReactNode;
     formError?: import('react').ReactNode;
+    errorSummary: boolean;
     applied: import('@nxgt/material-core/filter').FilterQuery;
     editing: string | null;
     pending: boolean;

package/dist/lib/components/ui/collections/filter/query/use-filter-query.d.ts

@@ -1,50 +1,6 @@
-import { FilterApply, FilterCountsOption, FilterDefaults, FilterEvent, FilterFieldErrors, FilterFocusTarget, FilterMachineState, FilterModel, FilterPreviewCount, FilterQuery } from '@nxgt/material-core/filter';
-import { ReactNode, RefObject } from 'react';
-import { FilterDensity, FilterQueryProps, FilterSearchApply } from './types.js';
-import { FilterBarFields } from './use-filter-bar-fields.js';
-/** What every part of the bar reads (`useFilterQueryContext`). */
-export type FilterQueryModel = FilterBarFields & {
-    model: FilterModel;
-    machine: FilterMachineState;
-    /** The `default: 'page'` fields' values (the `defaults` prop). */
-    defaults?: FilterDefaults;
-    /** A server's refusal per field id (the `errors` prop). */
-    errors?: FilterFieldErrors;
-    /** The search box's refusal (the `searchError` prop). */
-    searchError?: ReactNode;
-    /** A refusal of no field (the `formError` prop). */
-    formError?: ReactNode;
-    applied: FilterQuery;
-    editing: string | null;
-    /** An edit not carried yet: the count shown is the previous query's. */
-    pending: boolean;
-    /** The applied query is the one "Clear all" left. */
-    cleared: boolean;
-    /** The field "Add filter" just added, while the applied query is the one it left. */
-    added: string | null;
-    /** How many filters Done added, so each is told. */
-    addedCount: number;
-    loading: boolean;
-    resultCount?: number;
-    density: FilterDensity;
-    apply: FilterApply;
-    searchApply: FilterSearchApply;
-    searchMinLength: number;
-    previewCount?: FilterPreviewCount;
-    counts?: FilterCountsOption;
-    /** The element around the bar (a `div`): the focus contract finds the chips in it. */
-    rootRef: RefObject<HTMLDivElement | null>;
-    send: (event: FilterEvent) => void;
-    /** Applies `query` at once, without live apply's delay (the sheet's "Show N results"). */
-    applyNow: (query: FilterQuery) => void;
-    /** Makes the pending edit apply now rather than after `liveDelayMs` (a text field's Enter). */
-    applyPending: () => void;
-    /** Holds live apply while the phone sheet holds its history entry. */
-    suspendLive: (suspended: boolean) => void;
-    setEditing: (field: string | null) => void;
-    /** Focuses a target of the core's focus contract, once painted. */
-    focus: (target: FilterFocusTarget) => void;
-};
+import { FilterQueryModel } from './filter-query-model.js';
+import { FilterQueryProps } from './types.js';
+export type { FilterQueryModel } from './filter-query-model.js';
 /**
  * The bar's store: the slice over the core machine, the controlled `query`
  * and `locked` mirrored into it (an equal one changes nothing), and live

package/dist/lib/components/ui/collections/filter/sections/filter-form-error.d.ts

@@ -1,8 +1,20 @@
 /**
- * A refusal that belongs to no field (the `formError` prop): one error Alert
- * in place, under the bar. It is no live region: the bar's one does the
- * telling, once (`FilterResultsStatus`). Nothing without a message.
+ * What the bar says in words under itself: one error Alert in place. First
+ * the refusal that belongs to no field (the `formError` prop), then a line
+ * per refused field that names it, "Period: choose 366 days or fewer." (the
+ * `errors` prop; `errorSummary={false}` leaves them to the pills; the facets
+ * panel passes a `fieldLines` predicate that keeps a line only for a field
+ * with no section on screen: a section shows its message inline, a field
+ * without one is a plain chip that reads "Invalid"; on a phone the sections
+ * sit in the closed sheet, so every field keeps its line).
+ * It is no live region: the bar's one does the telling, once (`FilterResultsStatus`).
+ * Nothing without a message.
  */
-export declare function FilterFormError({ className }: {
+export declare function FilterFormError({ className, fieldLines, }: {
     className?: string;
+    /**
+     * `false`, or a predicate on the field id, where the field's own section
+     * already shows its message (the facets panel).
+     */
+    fieldLines?: boolean | ((id: string) => boolean);
 }): import("react").JSX.Element | null;

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

@@ -33,7 +33,7 @@ export type RowMenuProps = {
 };
 /**
  * A row's actions menu: `RowMenuTrigger` and a `DropdownMenu` aligned to the
- * end of it. Its items are 44px high on a coarse pointer, and the destructive
+ * end of it. Every item of its menu, `children` too, is 44px high on a coarse pointer, and the destructive
  * ones come last, after a separator. Focus returns to the trigger when the
  * menu closes, and when a dialog opened from an item closes.
  */

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

@@ -88,6 +88,11 @@ export type ServerTableFilter = {
      * once by the same live region. Cleared by the page when the query changes.
      */
     formError?: ReactNode;
+    /**
+     * Show the field errors' words under the bar (default `true`), after
+     * `formError`; `false` keeps the "Invalid" pills only.
+     */
+    errorSummary?: boolean;
     /**
      * How the page reads and writes the URL, to match the loader's
      * `parseFilterQuery` / `serializeFilterQuery` options exactly:

package/dist/lib/components/ui/dates/duration-field/partials/use-duration-box.d.ts

@@ -18,10 +18,10 @@ export declare function useDurationBox({ disabled, ...values }: Model): {
         labels: {
             hour: string;
             minute: string;
+            period: string;
             day: string;
             month: string;
             year: string;
-            period: string;
         };
         placeholders: Record<import('../../../primitives/segmented-input/segment-defs.js').SegmentKey, string>;
         periodNames: [string, string];

package/dist/lib/components/ui/display/badge/badge.d.ts

@@ -3,7 +3,7 @@ import { ComponentProps, ReactNode } from 'react';
 import { IconName } from '../../primitives/icon/icon.js';
 import { Tone } from '../../tones.js';
 declare const badgeVariants: (props?: ({
-    variant?: "secondary" | "success" | "info" | "warning" | "error" | "default" | "outlined" | "soft" | null | undefined;
+    variant?: "secondary" | "success" | "info" | "warning" | "error" | "default" | "soft" | "outlined" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /** The tone of a `soft` or `outlined` badge: a named tone or one the app declared in `AppTones`. */
 export type BadgeTone = Tone;

package/dist/lib/components/ui/display/day-separator/day-separator.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from 'class-variance-authority';
 import { ComponentProps, ReactNode } from 'react';
 import { DayInput } from './day-label.js';
 declare const daySeparatorVariants: (props?: ({
-    variant?: "pill" | "line" | null | undefined;
+    variant?: "line" | "pill" | null | undefined;
     sticky?: boolean | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export type DaySeparatorProps = Omit<ComponentProps<'div'>, 'children'> & VariantProps<typeof daySeparatorVariants> & {