@nxgt/material 3.52.0 → 3.53.0

package/dist/lib/components/ui/selection/switcher/switcher.d.ts

@@ -7,4 +7,4 @@ export type { SwitcherFooter, SwitcherItem, SwitcherProps, } from './types.js';
  * on a phone, a bottom sheet. `variant="expressive"` is a pill with a larger
  * panel and a "Recent" strip. With `getHref` the options are links.
  */
-export declare function Switcher({ options, label, value, onValueChange, variant, searchable, recent, getHref, linkComponent, footer, emptyLabel, sheet, open: openProp, onOpenChange, ...props }: SwitcherProps): import("react").JSX.Element;
+export declare function Switcher({ options, label, value, onValueChange, variant, size, searchable, recent, getHref, linkComponent, footer, emptyLabel, sheet, open: openProp, onOpenChange, ...props }: SwitcherProps): import("react").JSX.Element;

package/dist/lib/components/ui/selection/switcher/types.d.ts

@@ -34,6 +34,13 @@ export type SwitcherProps = {
     onValueChange?: (value: string) => void;
     /** `default` is the tile trigger and menu; `expressive` is the pill and the large panel. */
     variant?: 'default' | 'expressive';
+    /**
+     * `default` is the full trigger (tile, title, subtitle). `compact` is an icon-only
+     * round button, for a bar whose title already names the chosen option (the
+     * `titleAfter` slot): named by the label and the chosen title, its tooltip shows
+     * them, the panel is unchanged. A 44px box on a coarse pointer.
+     */
+    size?: 'default' | 'compact';
     /** A search field in the panel; default: from 8 options (always, when expressive). */
     searchable?: boolean;
     /** Up to 3 option ids shown as tiles above the groups while nothing is typed (expressive). */

package/dist/lib/components/ui/widgets/native-charts/core/reference-text.d.ts

@@ -1,6 +1,6 @@
 import { ToneMark } from './point-tones.js';
+import { RefBand, RefThreshold } from './reference.js';
 import { ChartTranslate } from './translate.js';
-import { ChartBand, ChartThreshold } from './types.js';
 /**
  * The words of a chart's reference bands, thresholds and toned points, for
  * the summary and the "View data" notes. Pure: the translator comes in as an
@@ -12,19 +12,27 @@ export type ReferenceSeries = {
     /** The tone mark of each row, null where there is none. */
     tones?: readonly (ToneMark | null)[];
 };
-/** One line per band ("Normal range: 40 to 60") then one per threshold ("High: 70"): the notes under the data table. */
+/**
+ * One line per band ("Normal range: 40 to 60") then one per threshold
+ * ("High: 70"): the notes under the data table. A band or a threshold that
+ * steps along x names each of its values with the x labels it covers
+ * ("Normal range: 40 to 60 (Jan to Mar), 45 to 70 (Apr to Jun)"); `labels` are
+ * the x labels, one per row.
+ */
 export declare function referenceNotes(t: ChartTranslate, input: {
-    bands: readonly ChartBand[];
-    thresholds: readonly ChartThreshold[];
+    bands: readonly RefBand[];
+    thresholds: readonly RefThreshold[];
     format: (value: number) => string;
+    labels?: readonly string[];
 }): string[];
 /**
  * The summary sentences: the ranges and the lines, then for each series how
  * many values lie outside each band, then how many points carry each tone.
  */
 export declare function referenceSummary(t: ChartTranslate, input: {
-    bands: readonly ChartBand[];
-    thresholds: readonly ChartThreshold[];
+    bands: readonly RefBand[];
+    thresholds: readonly RefThreshold[];
     series: readonly ReferenceSeries[];
     format: (value: number) => string;
+    labels?: readonly string[];
 }): string[];

package/dist/lib/components/ui/widgets/native-charts/core/reference.d.ts

@@ -1,4 +1,4 @@
-import { ChartBand, ChartThreshold } from './types.js';
+import { ChartBand, ChartRow, ChartThreshold } from './types.js';
 /**
  * The maths of a line chart's reference bands and threshold lines: they are
  * cleaned once (a range given backwards, a value that is not a number), fed
@@ -7,19 +7,66 @@ import { ChartBand, ChartThreshold } from './types.js';
  */
 /** A value-axis span, low then high. */
 export type Domain = readonly [number, number];
-/** The bands with a finite range, each as `from <= to`; the rest are dropped. */
-export declare function normalizeBands(bands: readonly ChartBand[] | undefined): ChartBand[];
-/** The thresholds with a finite value. */
-export declare function normalizeThresholds(thresholds: readonly ChartThreshold[] | undefined): ChartThreshold[];
+/** One row's range of a stepped band. */
+export type BandRange = {
+    from: number;
+    to: number;
+};
+/** A band as the chart draws it: numbers only. `from` and `to` hold the whole span (the envelope of a stepped band), `ranges` the range of each row. */
+export type RefBand = Omit<ChartBand, 'from' | 'to'> & {
+    from: number;
+    to: number;
+    /** Set when the band steps along x: the range of each row, null where it has none. */
+    ranges?: (BandRange | null)[];
+};
+/** A threshold as the chart draws it; `values` holds the value of each row when it steps along x. */
+export type RefThreshold = Omit<ChartThreshold, 'value'> & {
+    value: number;
+    values?: (number | null)[];
+};
+/**
+ * The bands with a finite range, each as `from <= to`; the rest are dropped.
+ * A band whose ends are a row field or a function is read against each row of
+ * `data`: it keeps its `ranges` unless every row gives the same one.
+ */
+export declare function normalizeBands(bands: readonly ChartBand[] | undefined, data?: readonly ChartRow[]): RefBand[];
+/** The thresholds with a finite value; one given by a row field or a function keeps its `values` unless every row gives the same one. */
+export declare function normalizeThresholds(thresholds: readonly ChartThreshold[] | undefined, data?: readonly ChartRow[]): RefThreshold[];
 /** Every value a band or a threshold marks: the value domain grows to hold them. */
-export declare function referenceValues(bands: readonly ChartBand[], thresholds: readonly ChartThreshold[]): number[];
+export declare function referenceValues(bands: readonly RefBand[], thresholds: readonly RefThreshold[]): number[];
+/** A stretch of consecutive rows with the same reference value: `first` to `last` are row indexes. */
+export type Run<V> = {
+    first: number;
+    last: number;
+    value: V;
+};
+/**
+ * The runs of consecutive rows that share a value (`same` tells), a row with
+ * no value (null) ending the run and leaving a gap. Without `perRow` the one
+ * constant value covers every row.
+ */
+export declare function refRuns<V>(count: number, constant: V, perRow: readonly (V | null)[] | undefined, same: (a: V, b: V) => boolean): Run<V>[];
+/** The runs of a band's ranges. */
+export declare const bandRuns: (b: RefBand, count: number) => Run<BandRange>[];
+/** The runs of a threshold's values. */
+export declare const thresholdRuns: (th: RefThreshold, count: number) => Run<number>[];
+/**
+ * Where a run sits across the plot, `x` mapping a row index to a pixel and
+ * `width` the plot's width: each row owns the stretch up to the midpoint to
+ * its neighbour, the first row from the plot's left edge and the last up to
+ * its right edge.
+ */
+export declare function runSpan(run: Pick<Run<unknown>, 'first' | 'last'>, count: number, x: (index: number) => number, width: number): {
+    x1: number;
+    x2: number;
+};
 /** The part of `band` inside `domain`; null when none of it is, or it has no height. */
-export declare function clipBand(band: Pick<ChartBand, 'from' | 'to'>, domain: Domain): {
+export declare function clipBand(band: Pick<RefBand, 'from' | 'to'>, domain: Domain): {
     from: number;
     to: number;
 } | null;
 /** A band's box on the plot, `y` mapping a value to a pixel: its top and height, clipped to the domain; null when it is out of view. */
-export declare function bandBox(band: Pick<ChartBand, 'from' | 'to'>, domain: Domain, y: (value: number) => number): {
+export declare function bandBox(band: Pick<RefBand, 'from' | 'to'>, domain: Domain, y: (value: number) => number): {
     top: number;
     height: number;
 } | null;
@@ -29,8 +76,8 @@ export declare function thresholdAt(value: number, domain: Domain, y: (value: nu
 export declare function bandLabelBaseline(top: number, height: number): number;
 /** The baseline of a threshold's label: above its line, or under it at the top of the plot. */
 export declare function thresholdLabelBaseline(lineY: number): number;
-/** How many of `values` lie outside `band` (a missing value is not counted), and how many there are. */
-export declare function outsideBand(values: readonly (number | null | undefined)[], band: Pick<ChartBand, 'from' | 'to'>): {
+/** How many of `values` lie outside `band` (a missing value is not counted, nor one in a row where a stepped band has no range), and how many there are. */
+export declare function outsideBand(values: readonly (number | null | undefined)[], band: Pick<RefBand, 'from' | 'to' | 'ranges'>): {
     outside: number;
     total: number;
 };

package/dist/lib/components/ui/widgets/native-charts/core/types.d.ts

@@ -95,16 +95,23 @@ export interface ChartPoint {
  * the colour's ink (lines, points and swatches in the ink).
  */
 export type ChartPalette = 'default' | 'soft';
+/** A reference value: fixed, the name of a numeric field read from each row, or computed from the row and its index. */
+export type ChartRowValue = number | string | ((row: ChartRow, index: number) => number | null | undefined);
 /**
  * A shaded range of the value axis, drawn behind the lines: a normal range,
  * a target zone. Its `label` is drawn in the band and listed in the summary
  * and in "View data"; the shade is decorative, the label carries the meaning.
  */
 export interface ChartBand {
-    /** One end of the range, in the value axis' units (either order). */
-    from: number;
-    /** The other end. */
-    to: number;
+    /**
+     * One end of the range, in the value axis' units (either order): a
+     * number, the name of a row field, or a function of the row. With a field
+     * or a function the band steps along x, one range per row (a row it gives
+     * no number for leaves a gap).
+     */
+    from: ChartRowValue;
+    /** The other end; same forms as `from`. */
+    to: ChartRowValue;
     /** Names the range: drawn in it, read by the summary and the table. */
     label: string;
     /** Tints the band and its label in the tone; default a neutral wash. */
@@ -112,7 +119,8 @@ export interface ChartBand {
 }
 /** A horizontal line at a value, with a direct label at its end. */
 export interface ChartThreshold {
-    value: number;
+    /** Where the line sits: a number, a row field or a function of the row (then it steps along x). */
+    value: ChartRowValue;
     /** Names the line: drawn at its end, read by the summary and the table. */
     label: string;
     /** Draws the line and its label in the tone's colour; default the axis colour. */

package/dist/lib/components/ui/widgets/native-charts/hooks/chart-model-types.d.ts

@@ -2,6 +2,7 @@ import { Tone } from '../../../tones.js';
 import { ResolvedSeries } from '../core/colors.js';
 import { SeriesAxis } from '../core/combo-axes.js';
 import { ToneMark, ToneWords } from '../core/point-tones.js';
+import { RefBand, RefThreshold } from '../core/reference.js';
 import { ChartTableModel } from '../core/table.js';
 import { ChartAxis, ChartBand, ChartBaseProps, ChartPoint, ChartRow, ChartSeries, ChartThreshold, ChartXAxis, RowKey } from '../core/types.js';
 import { LegendItem } from '../partials/chart-legend.js';
@@ -39,8 +40,8 @@ export type { ToneMark };
 export type ChartModel = {
     /** The bands and thresholds, cleaned (`from <= to`, finite). */
     refs: {
-        bands: ChartBand[];
-        thresholds: ChartThreshold[];
+        bands: RefBand[];
+        thresholds: RefThreshold[];
     };
     size: ReturnType<typeof useChartSize<HTMLDivElement>>;
     /** Every series, resolved (colour, shape, dash, position). */

package/dist/lib/components/ui/widgets/native-charts/index.d.ts

@@ -4,7 +4,7 @@ export type { BarChartProps, BarLayout, BarOrientation, } from './bar-chart/bar-
 export { ComboChart } from './combo-chart/combo-chart.js';
 export type { ComboChartProps } from './combo-chart/combo-chart-types.js';
 export type { ChartRange, ChartRangeProps, ChartScrollOptions, ChartZoomOptions, } from './core/range-types.js';
-export type { ChartAxis, ChartBand, ChartBaseProps, ChartColor, ChartPalette, ChartPoint, ChartRow, ChartSeries, ChartShape, ChartSlice, ChartThreshold, ChartValue, ChartXAxis, ComboSeries, RowKey, ScatterPoint, ScatterSeries, } from './core/types.js';
+export type { ChartAxis, ChartBand, ChartBaseProps, ChartColor, ChartPalette, ChartPoint, ChartRow, ChartRowValue, ChartSeries, ChartShape, ChartSlice, ChartThreshold, ChartValue, ChartXAxis, ComboSeries, RowKey, ScatterPoint, ScatterSeries, } from './core/types.js';
 export { FunnelChart } from './funnel-chart/funnel-chart.js';
 export type { FunnelChartProps } from './funnel-chart/funnel-chart-types.js';
 export { Gauge } from './gauge/gauge.js';

package/dist/lib/components/ui/widgets/native-charts/line-chart/line-chart-types.d.ts

@@ -21,9 +21,14 @@ export type LineChartProps<T extends object = ChartRow> = ChartModelProps<T> & C
      * unless `yAxis.min` / `max` pin it (a band is then clipped); the
      * summary says how many values fall outside each, and "View data"
      * lists them. Keep the array stable (memoize it).
+     *
+     * `from` and `to` also take a row field or a function of the row: the
+     * band then steps along x, one range per row (a normal range copied
+     * with each measurement), and the summary and "View data" name each
+     * range with the x labels it covers.
      */
     bands?: ChartBand[];
-    /** Horizontal lines at a value with a label at their end, also in the summary and in "View data". Keep the array stable. */
+    /** Horizontal lines at a value with a label at their end, also in the summary and in "View data". `value` also takes a row field or a function of the row (the line then steps along x). Keep the array stable. */
     thresholds?: ChartThreshold[];
     /**
      * The tone of a point, or undefined for none. A toned point is drawn

package/dist/lib/components/ui/widgets/native-charts/line-chart/partials/reference-marks.d.ts

@@ -10,7 +10,7 @@ export declare function ReferenceLayer({ refs, geo, }: {
     refs: ChartModel['refs'];
     geo: LineGeometry;
 }): import("react").JSX.Element;
-/** The labels of the bands (inside, at the plot's left) and of the thresholds (above the line, at its right end), over the series. */
+/** The labels of the bands (inside, at the left of the widest stretch in view) and of the thresholds (above the line, at the right end of the last stretch), over the series. */
 export declare function ReferenceLabels({ refs, geo, }: {
     refs: ChartModel['refs'];
     geo: LineGeometry;

package/dist/lib/i18n/material-resources-registry.d.ts

@@ -0,0 +1,21 @@
+import { ResourceBundle } from './merge-resources.js';
+/** What the mounted `I18nProvider` told the code that runs outside React. */
+export type MaterialResourcesRegistration = {
+    resources: ResourceBundle | undefined;
+    language: string;
+};
+/**
+ * Internal, not exported by the package: `I18nProvider` registers its
+ * `resources` and language here so `toast()`, which runs outside React, reads
+ * the app's `material.*` overrides. A stack: the provider mounted last wins,
+ * and its cleanup restores the previous one.
+ */
+export declare function registerMaterialResources(resources: ResourceBundle | undefined, language: string): () => void;
+/**
+ * Changes a registration in place, keeping its place in the stack: a provider
+ * whose resources or language change must not rise above one mounted after it.
+ * `handle` is what {@link registerMaterialResources} returned.
+ */
+export declare function updateMaterialResources(handle: () => void, resources: ResourceBundle | undefined, language: string): void;
+/** The registration of the provider mounted last, or `undefined` without one. */
+export declare function currentMaterialResources(): MaterialResourcesRegistration | undefined;

package/dist/lib/i18n/resources/en/en.d.ts

@@ -2850,6 +2850,10 @@ export declare const en: {
             reference: {
                 band: string;
                 threshold: string;
+                span: string;
+                range: string;
+                step: string;
+                steps: string;
             };
             kind: {
                 line: string;

package/dist/lib/i18n/resources/en/material.json.d.ts

@@ -2839,7 +2839,11 @@ declare const _default: {
 		},
 		"reference": {
 			"band": "{label}: {from} to {to}",
-			"threshold": "{label}: {value}"
+			"threshold": "{label}: {value}",
+			"span": "{first} to {last}",
+			"range": "{from} to {to}",
+			"step": "{value} ({where})",
+			"steps": "{label}: {list}"
 		},
 		"kind": {
 			"line": "line chart",

package/dist/lib/i18n/resources/fr/fr.d.ts

@@ -2850,6 +2850,10 @@ export declare const fr: {
             reference: {
                 band: string;
                 threshold: string;
+                span: string;
+                range: string;
+                step: string;
+                steps: string;
             };
             kind: {
                 line: string;

package/dist/lib/i18n/resources/fr/material.json.d.ts

@@ -2839,7 +2839,11 @@ declare const _default: {
 		},
 		"reference": {
 			"band": "{label} : de {from} à {to}",
-			"threshold": "{label} : {value}"
+			"threshold": "{label} : {value}",
+			"span": "de {first} à {last}",
+			"range": "de {from} à {to}",
+			"step": "{value} ({where})",
+			"steps": "{label} : {list}"
 		},
 		"kind": {
 			"line": "graphique en courbes",

package/dist/lib/i18n/resources/resources.d.ts

@@ -2848,6 +2848,10 @@ export declare const resources: {
                 reference: {
                     band: string;
                     threshold: string;
+                    span: string;
+                    range: string;
+                    step: string;
+                    steps: string;
                 };
                 kind: {
                     line: string;
@@ -5752,6 +5756,10 @@ export declare const resources: {
                 reference: {
                     band: string;
                     threshold: string;
+                    span: string;
+                    range: string;
+                    step: string;
+                    steps: string;
                 };
                 kind: {
                     line: string;