@nxgt/material 3.57.0 → 3.58.0

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

@@ -0,0 +1,62 @@
+import { BandRange, Domain, RefBand, RefThreshold } from './reference.js';
+/**
+ * Where reference bands and threshold lines fall on the plot: the runs of
+ * rows that share a value, their spans, the clipping to the value domain,
+ * label baselines, and the count of values outside a band.
+ */
+/** 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<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<RefBand, 'from' | 'to'>, domain: Domain, y: (value: number) => number): {
+    top: number;
+    height: number;
+} | null;
+/** Where a threshold's line falls; null when its value is outside the domain. */
+export declare function thresholdAt(value: number, domain: Domain, y: (value: number) => number): number | null;
+/** The baseline of a band's label: inside the band under its top edge, or above a band too thin to hold it. */
+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, 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;
+};
+/**
+ * How a label sits at a plot's physical `edge` (the plot is drawn left to
+ * right whatever the page): a label in a right-to-left script is set `rtl`,
+ * and the anchor that grows it inward from that edge flips with it.
+ */
+export declare function labelFlow(label: string, edge: 'left' | 'right'): {
+    direction: 'ltr' | 'rtl';
+    textAnchor: 'start' | 'end';
+};

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

@@ -0,0 +1,35 @@
+import { Tone } from '../../../tones.js';
+import { ChartRow } from './types.js';
+/** 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): 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. */
+    tone?: Tone;
+}
+/** A horizontal line at a value, with a direct label at its end. */
+export interface ChartThreshold {
+    /** 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. */
+    tone?: Tone;
+    /** Dashed (default) or, with `false`, solid. */
+    dash?: boolean;
+}

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

@@ -34,59 +34,4 @@ export declare function normalizeBands(bands: readonly ChartBand[] | undefined,
 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 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<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<RefBand, 'from' | 'to'>, domain: Domain, y: (value: number) => number): {
-    top: number;
-    height: number;
-} | null;
-/** Where a threshold's line falls; null when its value is outside the domain. */
-export declare function thresholdAt(value: number, domain: Domain, y: (value: number) => number): number | null;
-/** The baseline of a band's label: inside the band under its top edge, or above a band too thin to hold it. */
-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, 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;
-};
-/**
- * How a label sits at a plot's physical `edge` (the plot is drawn left to
- * right whatever the page): a label in a right-to-left script is set `rtl`,
- * and the anchor that grows it inward from that edge flips with it.
- */
-export declare function labelFlow(label: string, edge: 'left' | 'right'): {
-    direction: 'ltr' | 'rtl';
-    textAnchor: 'start' | 'end';
-};
+export { bandBox, bandLabelBaseline, bandRuns, clipBand, labelFlow, outsideBand, type Run, refRuns, runSpan, thresholdAt, thresholdLabelBaseline, thresholdRuns, } from './reference-geometry.js';

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

@@ -1,4 +1,3 @@
-import { ReactNode } from 'react';
 import { Tone } from '../../../tones.js';
 /**
  * The shared types of `@nxgt/material/charts`. Every chart takes rows of
@@ -77,98 +76,5 @@ export interface ChartXAxis {
     format?: (value: ChartValue, index: number) => string;
     label?: string;
 }
-/** A point a tooltip, a click or the keyboard lands on. */
-export interface ChartPoint {
-    seriesKey: string;
-    seriesLabel: string;
-    /** The row index (or the slice, step or cell index). */
-    index: number;
-    /** The formatted x value or category. */
-    label: string;
-    value: number;
-    formatted: string;
-    row?: ChartRow;
-}
-/**
- * The series colours: `'default'` draws from `--chart-1..5`; `'soft'` from
- * `--chart-soft-1..5`, each filled mark a soft fill with a crisp outline in
- * 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): 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. */
-    tone?: Tone;
-}
-/** A horizontal line at a value, with a direct label at its end. */
-export interface ChartThreshold {
-    /** 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. */
-    tone?: Tone;
-    /** Dashed (default) or, with `false`, solid. */
-    dash?: boolean;
-}
-/** What every chart accepts. */
-export interface ChartBaseProps {
-    /** The card's title, and the chart's accessible name. */
-    title: string;
-    /** A line under the title. */
-    description?: ReactNode;
-    /** The big number line under the header. */
-    headline?: ReactNode;
-    /** The screen-reader summary; default generated from the data. */
-    summary?: string | ((auto: string) => string);
-    /** The plot's height in pixels; default 260 (220 under 480px wide); a radar 340, a gauge by its `size`. */
-    height?: number;
-    /** Where the legend goes; default `'top'`. Always below on a phone. */
-    legend?: 'top' | 'bottom' | false;
-    /** The hidden series' keys, controlled. */
-    hidden?: string[];
-    defaultHidden?: string[];
-    onHiddenChange?: (hidden: string[]) => void;
-    /** Shapes, dashes and fill patterns beside the colours. */
-    patterns?: boolean;
-    /**
-     * The series colours. Unset, a chart follows `data-chart-palette="soft"`
-     * on an ancestor (an app-wide switch), else the default palette; set, it
-     * wins over the ancestor both ways. A `tone` is the same in either.
-     */
-    palette?: ChartPalette;
-    /** Default `'dotted'`; `'hairline'` draws thin solid lines. */
-    grid?: 'dotted' | 'hairline' | 'none';
-    /** The "View data" button and its table; default true. */
-    dataTable?: boolean;
-    /** `false` draws no tooltip; a function renders its content. */
-    tooltip?: false | ((points: ChartPoint[]) => ReactNode);
-    /** A pointer click, or Enter or Space on a focused point. */
-    onPointClick?: (point: ChartPoint) => void;
-    /** The entry motion; default true. Reduced motion always wins. */
-    animate?: boolean;
-    /** Shows a skeleton instead of the plot. */
-    loading?: boolean;
-    /** Shown when there is no data. */
-    emptyState?: ReactNode;
-    /** Default `'card'`, a 12px card; `'plain'` draws no surface. */
-    surface?: 'card' | 'plain';
-    className?: string;
-}
+export type { ChartBaseProps, ChartPalette, ChartPoint, } from './base-props-types.js';
+export type { ChartBand, ChartRowValue, ChartThreshold, } from './reference-types.js';

package/dist/lib/components/ui/widgets/native-charts/hooks/use-model-parts.d.ts

@@ -0,0 +1,20 @@
+import { ResolvedSeries } from '../core/colors.js';
+import { SeriesAxis } from '../core/combo-axes.js';
+import { ChartKind } from '../core/summary.js';
+import { ChartSeries } from '../core/types.js';
+import { ChartModel, ChartModelProps } from './chart-model-types.js';
+import { ModelSeries } from './model-series.js';
+/** The model's text parts, each memoized: the summary, the legend and the lazy table. */
+export declare function useModelParts(props: ChartModelProps, kind: ChartKind, view: {
+    series: ResolvedSeries[];
+    shown: ModelSeries[];
+    labels: string[];
+    hidden: string[];
+    axes?: (series: ChartSeries) => SeriesAxis;
+    refs: ChartModel['refs'];
+}): {
+    summary: string;
+    legendItems: import('../partials/chart-legend.js').LegendItem[];
+    table: (() => import('../core/table.js').ChartTableModel) | null;
+    tableCaption: string;
+};

package/dist/lib/components/ui/widgets/native-charts/hooks/use-model-shown.d.ts

@@ -0,0 +1,23 @@
+import { ResolvedSeries } from '../core/colors.js';
+import { ChartModelOptions, ChartModelProps } from './chart-model-types.js';
+/**
+ * The reference bands and thresholds, cleaned against the data, and the
+ * series that are shown (visible ones, with the tones the reference gives
+ * their points).
+ */
+export declare function useModelShown({ series, hidden, data, axes, yAxis, labels, offset, reference, }: {
+    series: ResolvedSeries[];
+    hidden: string[];
+    data: ChartModelProps['data'];
+    axes: ChartModelOptions['axes'];
+    yAxis: ChartModelProps['yAxis'];
+    labels: string[];
+    offset: number | undefined;
+    reference: ChartModelOptions['reference'];
+}): {
+    refs: {
+        bands: import('../core/reference.js').RefBand[];
+        thresholds: import('../core/reference.js').RefThreshold[];
+    };
+    shown: import('./model-series.js').ModelSeries[];
+};

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

@@ -0,0 +1,10 @@
+import { AreaChartProps } from '../line-chart-types.js';
+import { LineGeometry } from '../line-geometry.js';
+/** The lines, their dots and the toned points, clipped by the entry reveal while it runs. */
+export declare function LineStrokes({ geo, clipPath, phone, patterns, points, }: {
+    geo: LineGeometry;
+    clipPath?: string;
+    phone: boolean;
+    patterns?: boolean;
+    points: AreaChartProps['points'];
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import { ChartModel } from '../../hooks/use-chart-model.js';
+/**
+ * The entry motion of a line or area chart: the reveal clip's progress, and
+ * how far the area fills have faded in (they start after 60% of the reveal).
+ */
+export declare function useLineReveal(model: ChartModel, animate?: boolean): {
+    motion: import('../../hooks/use-entry-motion.js').EntryMotion;
+    fade: number;
+};

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

@@ -356,6 +356,9 @@ export declare const en: {
             "retry-wrong": string;
             retrying: string;
         };
+        "question-card": {
+            unanswered: string;
+        };
         "question-navigator": {
             label: string;
             item: string;
@@ -378,6 +381,7 @@ export declare const en: {
             left: string;
             expired: string;
             warning: string;
+            critical: string;
         };
         "option-tile": {
             correct: string;

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

@@ -346,6 +346,9 @@ declare const _default: {
 		"retry-wrong": "{count, plural, one {Retry # question} other {Retry # questions}}",
 		"retrying": "Retry round: {count, plural, one {# question} other {# questions}}"
 	},
+	"question-card": {
+		"unanswered": "No answer"
+	},
 	"question-navigator": {
 		"label": "Questions",
 		"item": "Question {number}",
@@ -367,7 +370,8 @@ declare const _default: {
 		"label": "Time remaining",
 		"left": "{time} left",
 		"expired": "Time is up",
-		"warning": "Little time left"
+		"warning": "Little time left",
+		"critical": "Almost out of time"
 	},
 	"option-tile": {
 		"correct": "correct answer",

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

@@ -356,6 +356,9 @@ export declare const fr: {
             "retry-wrong": string;
             retrying: string;
         };
+        "question-card": {
+            unanswered: string;
+        };
         "question-navigator": {
             label: string;
             item: string;
@@ -378,6 +381,7 @@ export declare const fr: {
             left: string;
             expired: string;
             warning: string;
+            critical: string;
         };
         "option-tile": {
             correct: string;

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

@@ -346,6 +346,9 @@ declare const _default: {
 		"retry-wrong": "{count, plural, one {Refaire # question} other {Refaire # questions}}",
 		"retrying": "Nouvel essai : {count, plural, one {# question} other {# questions}}"
 	},
+	"question-card": {
+		"unanswered": "Sans réponse"
+	},
 	"question-navigator": {
 		"label": "Questions",
 		"item": "Question {number}",
@@ -367,7 +370,8 @@ declare const _default: {
 		"label": "Temps restant",
 		"left": "Plus que {time}",
 		"expired": "Temps écoulé",
-		"warning": "Il reste peu de temps"
+		"warning": "Il reste peu de temps",
+		"critical": "Le temps est presque écoulé"
 	},
 	"option-tile": {
 		"correct": "bonne réponse",

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

@@ -354,6 +354,9 @@ export declare const resources: {
                 "retry-wrong": string;
                 retrying: string;
             };
+            "question-card": {
+                unanswered: string;
+            };
             "question-navigator": {
                 label: string;
                 item: string;
@@ -376,6 +379,7 @@ export declare const resources: {
                 left: string;
                 expired: string;
                 warning: string;
+                critical: string;
             };
             "option-tile": {
                 correct: string;
@@ -3297,6 +3301,9 @@ export declare const resources: {
                 "retry-wrong": string;
                 retrying: string;
             };
+            "question-card": {
+                unanswered: string;
+            };
             "question-navigator": {
                 label: string;
                 item: string;
@@ -3319,6 +3326,7 @@ export declare const resources: {
                 left: string;
                 expired: string;
                 warning: string;
+                critical: string;
             };
             "option-tile": {
                 correct: string;