@aceshooting/lyra-ui 14.1.1 → 14.3.0

package/dist/components/charts/chart/chart-legend-visibility.d.ts

@@ -6,6 +6,14 @@ readonly datasetIndex:number;
 readonly visible:boolean;
 /** Canonical complete list of hidden zero-based dataset indexes. */
 readonly hiddenDatasets:readonly number[];}
+/** Complete category visibility proposal or committed snapshot for radial charts. */
+export interface LyraChartDatumVisibilityChangeDetail{
+/** Zero-based source category index, shared by every dataset/ring. */
+readonly index:number;
+/** Proposed or committed visibility of this category. */
+readonly visible:boolean;
+/** Complete canonical list of hidden source category indexes. */
+readonly hiddenDatums:readonly number[];}
 /**
 * Returns a stable, bounded visibility snapshot. A defined empty array deliberately means every
 * dataset is visible; `undefined` is left distinct so component configuration can supply its

package/dist/components/charts/chart/chart.class.d.ts

@@ -1,4 +1,4 @@
-import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import'../../overlays/skeleton/skeleton.class.js';import type{LyraVariant}from'../../../internal/variants.js';import{type LyraChartLegendVisibilityChangeDetail}from'./chart-legend-visibility.js';export type{LyraChartLegendVisibilityChangeDetail}from'./chart-legend-visibility.js';export{seriesPalette}from'./chart-colors.js';export interface LyraChartPoint{readonly x:number;readonly y:number;
+import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import'../../overlays/skeleton/skeleton.class.js';import type{LyraVariant}from'../../../internal/variants.js';import{type LyraChartLegendVisibilityChangeDetail,type LyraChartDatumVisibilityChangeDetail}from'./chart-legend-visibility.js';export type{LyraChartLegendVisibilityChangeDetail,LyraChartDatumVisibilityChangeDetail}from'./chart-legend-visibility.js';export{seriesPalette}from'./chart-colors.js';export interface LyraChartPoint{readonly x:number;readonly y:number;
 /** Bubble radius. Ignored by chart types that do not consume a radius. */
 readonly r?:number;
 /**
@@ -19,7 +19,9 @@ readonly pointRadius?:number|readonly number[];
 * when shorter than the segment count. Sampled segments retain the original source starting
 * point's palette index. Only meaningful for line-type series.
 */
-readonly segmentColors?:readonly string[];readonly type?:'line'|'bar';}export type LyraChartType='line'|'bar'|'scatter'|'pie'|'doughnut'|'radar'|'polarArea'|'bubble';export type LyraChartGrid='x'|'y'|'both'|'none';export type LyraChartIndexAxis='x'|'y';
+readonly segmentColors?:readonly string[];readonly type?:'line'|'bar';}export type LyraChartType='line'|'bar'|'scatter'|'pie'|'doughnut'|'radar'|'polarArea'|'bubble';export type LyraChartGrid='x'|'y'|'both'|'none';
+/** Complete cartesian axes, including their ticks, labels, borders and grid lines. */
+export type LyraChartAxes=LyraChartGrid;export type LyraChartIndexAxis='x'|'y';
 /** Scale type for a chart's value axis. The categorical axis is never affected. */
 export type LyraChartScaleType='linear'|'logarithmic';
 /**
@@ -30,7 +32,11 @@ export type LyraChartScaleType='linear'|'logarithmic';
 * numbers, is dropped rather than handed to Chart.js, where it would silently render nothing or
 * throw. `axis` defaults to `'y'`, the value axis for the common threshold case.
 */
-export interface LyraChartAnnotation{readonly axis?:LyraChartIndexAxis;readonly value?:number;readonly from?:number;readonly to?:number;readonly label?:string;readonly tone?:LyraVariant;}export type LyraChartLayoutPosition='left'|'top'|'right'|'bottom'|'center'|'chartArea'|{[scaleId:string]:number;};export type LyraChartLegendPosition=LyraChartLayoutPosition|'start'|'end'|'auto';export type LyraChartValueFormatterContext='tick'|'tooltip'|'legend'|'table';export type LyraChartValueFormatter=(value:number,context:LyraChartValueFormatterContext)=>string;export type LyraChartFormatSurface=LyraChartValueFormatterContext|'visual'|'spoken'|'export';
+export interface LyraChartAnnotation{readonly axis?:LyraChartIndexAxis;readonly value?:number;readonly from?:number;readonly to?:number;readonly label?:string;readonly tone?:LyraVariant;}export type LyraChartLayoutPosition='left'|'top'|'right'|'bottom'|'center'|'chartArea'|{[scaleId:string]:number;};export type LyraChartLegendPosition=LyraChartLayoutPosition|'start'|'end'|'auto';
+/** Dataset toggles, or shared category toggles for pie/doughnut/polar-area charts. */
+export type LyraChartLegendMode='dataset'|'datum';
+/** Text shown in the DOM legend, independently of tooltip and axis formatting. */
+export type LyraChartLegendDisplay='auto'|'label'|'value'|'percentage';export type LyraChartValueFormatterContext='tick'|'tooltip'|'legend'|'table';export type LyraChartValueFormatter=(value:number,context:LyraChartValueFormatterContext)=>string;export type LyraChartFormatSurface=LyraChartValueFormatterContext|'visual'|'spoken'|'export';
 /** Identifies which numeric component of a structured datum the formatter receives. */
 export type LyraChartStatistic='x'|'y'|'r'|'min'|'q1'|'median'|'q3'|'max'|'total';export interface LyraChartFormatterContext{readonly value:number;readonly surface:LyraChartFormatSurface;readonly datasetIndex?:number;readonly index?:number;readonly label?:string;readonly seriesLabel?:string;readonly statistic?:LyraChartStatistic;}export type LyraChartFormatter=(context:LyraChartFormatterContext)=>string;export type LyraChartExportFormat='csv'|'png';export interface LyraChartArea{readonly top:number;readonly left:number;readonly right:number;readonly bottom:number;readonly width:number;readonly height:number;}
 /** A Chart.js-compatible plugin shape without making `chart.js` a type dependency for consumers. */
@@ -45,13 +51,13 @@ export interface LyraChartDataConfiguration{labels?:unknown[];datasets?:LyraChar
 * controller-specific checking is useful; that type remains structurally
 * assignable to this passthrough surface.
 */
-export interface LyraChartConfiguration{type?:string;data?:LyraChartDataConfiguration;options?:object;plugins?:LyraChartPlugin[];}interface ChartHit{datasetIndex:number;index:number;}interface RuntimeChart{data:{labels?:unknown[];datasets:LyraChartDatasetConfiguration[];};options:Record<string,unknown>;config:{type?:unknown;};legend?:unknown;chartArea?:LyraChartArea;destroy():void;update(mode?:string):void;toBase64Image?():string;getElementsAtEventForMode(event:Event,mode:string,options:Record<string,unknown>,useFinalPosition:boolean):ChartHit[];getDatasetMeta?(index:number):{hidden:boolean|null;};isDatasetVisible(index:number):boolean;setDatasetVisibility(index:number,visible:boolean):void;}
+export interface LyraChartConfiguration{type?:string;data?:LyraChartDataConfiguration;options?:object;plugins?:LyraChartPlugin[];}interface ChartHit{datasetIndex:number;index:number;}interface RuntimeChart{data:{labels?:unknown[];datasets:LyraChartDatasetConfiguration[];};options:Record<string,unknown>;config:{type?:unknown;};legend?:unknown;chartArea?:LyraChartArea;destroy():void;update(mode?:string):void;toBase64Image?():string;getElementsAtEventForMode(event:Event,mode:string,options:Record<string,unknown>,useFinalPosition:boolean):ChartHit[];getDatasetMeta?(index:number):{hidden:boolean|null;};isDatasetVisible(index:number):boolean;setDatasetVisibility(index:number,visible:boolean):void;getDataVisibility?(index:number):boolean;toggleDataVisibility?(index:number):void;}
 /** Public structural view of the current Chart.js instance, without imposing `chart.js` as a
 * type dependency on consumers. The value is `undefined` before the peer loads and after the
 * component disconnects. */
 export interface LyraChartInstance extends RuntimeChart{}export type LyraChartDatumKind='bar'|'point'|'segment'|'slice'|'box';type LyraCoreChartDatumKind=Exclude<LyraChartDatumKind,'box'>;
 /** Input-neutral detail shared by every chart-family `lr-datum-activate` event. */
-export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=LyraChartDatumKind,TValue=unknown>{readonly kind:TKind;readonly datasetIndex:number;readonly index:number;readonly label:string|undefined;readonly value:TValue;}export interface LyraChartEventMap{'lr-point-click':CustomEvent<{datasetIndex:number;index:number;label:string|undefined;value:unknown;}>;'lr-zoom':CustomEvent<{zoomed:boolean;}>;'lr-before-legend-visibility-change':CustomEvent<LyraChartLegendVisibilityChangeDetail>;'lr-legend-visibility-change':CustomEvent<LyraChartLegendVisibilityChangeDetail>;'lr-datum-activate':CustomEvent<LyraChartDatumActivateDetail<LyraCoreChartDatumKind>>;}
+export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=LyraChartDatumKind,TValue=unknown>{readonly kind:TKind;readonly datasetIndex:number;readonly index:number;readonly label:string|undefined;readonly value:TValue;}export interface LyraChartEventMap{'lr-point-click':CustomEvent<{datasetIndex:number;index:number;label:string|undefined;value:unknown;}>;'lr-zoom':CustomEvent<{zoomed:boolean;}>;'lr-before-legend-visibility-change':CustomEvent<LyraChartLegendVisibilityChangeDetail>;'lr-legend-visibility-change':CustomEvent<LyraChartLegendVisibilityChangeDetail>;'lr-before-datum-visibility-change':CustomEvent<LyraChartDatumVisibilityChangeDetail>;'lr-datum-visibility-change':CustomEvent<LyraChartDatumVisibilityChangeDetail>;'lr-datum-activate':CustomEvent<LyraChartDatumActivateDetail<LyraCoreChartDatumKind>>;}
 /**
 * `<lr-chart>` — the core Chart.js wrapper used directly and by the typed
 * Chart.js tags plus `<lr-histogram>`. `<lr-lite-chart>` and `<lr-box-plot>`
@@ -60,6 +66,9 @@ export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=L
 * are further optional peers loaded only on demand.
 * With IntersectionObserver available, canvas construction waits for the first delivered
 * visibility decision; without it, drawing starts as soon as the peer and canvas are ready.
+* Simplified pie/doughnut datasets with magnitudes above Number.MAX_SAFE_INTEGER are uniformly
+* scaled for finite peer arc geometry. Legends, tooltips, data labels and semantic exports retain
+* original values; direct peer callbacks see scaled values. Explicit config.data is passed through.
 *
 * **API mirror note:** the real `wa-chart` docs page
 * (https://webawesome.com/docs/components/chart/) documents a `config:
@@ -90,13 +99,18 @@ export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=L
 *   value, and the complete canonical proposed `hiddenDatasets` snapshot.
 * @event lr-legend-visibility-change - Emitted after an accepted DOM legend toggle commits the
 *   same detail. Programmatic `hiddenDatasets` changes reconcile without either event.
+* @event lr-before-datum-visibility-change - Cancelable category visibility proposal in datum
+*   legend mode. `detail: { index: number, visible: boolean, hiddenDatums: readonly number[] }`.
+*   Source category indexes apply to every dataset/ring. The complete detail is frozen.
+* @event lr-datum-visibility-change - Emitted after an accepted category toggle commits the same
+*   frozen detail. Programmatic `hiddenDatums` assignments are silent.
 * @csspart base - The chart wrapper.
 * @csspart plot - The fixed-height canvas/overlay region.
 * @csspart canvas - The Chart.js canvas.
 * @csspart legend - The wrapping DOM legend, rendered unless `withoutLegend` is set.
-* @csspart legend-item - A keyboard-operable series visibility toggle.
-* @csspart legend-item-hidden - Added to a `legend-item` while its dataset is hidden.
-* @csspart legend-swatch - The resolved series-color swatch in a legend item.
+* @csspart legend-item - A keyboard-operable dataset or category visibility toggle.
+* @csspart legend-item-hidden - Added while the legend item's dataset or category is hidden.
+* @csspart legend-swatch - The resolved dataset/category color swatch in a legend item.
 * @csspart reset-zoom-button - The reset-zoom control when zoom is active.
 * @csspart description - The accessible chart summary.
 * @csspart data-table - The optional generated or slotted data table.
@@ -190,7 +204,27 @@ get datasets():readonly LyraChartSeries[];set datasets(value:readonly LyraChartS
 * an empty array deliberately makes every dataset visible. Invalid, duplicate, and out-of-range
 * indexes are ignored when state is applied or emitted.
 */
-hiddenDatasets?:readonly number[];
+hiddenDatasets?:readonly number[];private _hiddenDatums;
+/**
+* Controlled hidden source category indexes for pie/doughnut/polar-area charts, shared by all
+* datasets/rings. Clone-owned; invalid, duplicate and out-of-range indexes are ignored when
+* applied or emitted. Empty restores all categories. Does not alter dataset visibility or exports.
+* @default []
+*/
+get hiddenDatums():readonly number[];set hiddenDatums(value:readonly number[]);
+/**
+* `datum` renders category toggles for pie/doughnut/polar-area charts. Categories use the first
+* dataset's colors and values; a toggle affects that category in every ring. Other chart types
+* retain dataset legends. Both modes use the generated accessible-data sampling budget.
+*/
+legendMode:LyraChartLegendMode;
+/**
+* `auto` retains optional legend formatting; `label` omits values even with a formatter; `value`
+* appends a formatted value. `percentage` uses locale percentages of the absolute represented
+* legend values, including hidden items (zero totals yield 0%). Dataset values are sampled sums;
+* category values come from the first dataset. Tooltip and axis formatting are unchanged.
+*/
+legendDisplay:LyraChartLegendDisplay;
 /**
 * Accessible chart description, which REPLACES the generated summary rather than adding to it.
 *
@@ -207,6 +241,13 @@ hiddenDatasets?:readonly number[];
 description:string|null;
 /** Controls which cartesian grid axes are drawn. */
 grid:LyraChartGrid;
+/** Complete cartesian axis visibility, independent of grid. `y` also controls the y2 axis.
+* Radial charts ignore this setting. Explicit config scale options retain precedence. */
+axes:LyraChartAxes;
+/** Compact cartesian plot: hide axes and remove automatic layout padding. Set height and
+* withoutLegend for a small histogram/sparkline. Preserves data tables, tooltips and keyboard
+* actions; radial charts ignore this setting. Explicit config options retain precedence. */
+compact:boolean;
 /** Chart.js index axis. `'y'` is Chart.js's own mechanism for horizontal bars (it also flips
 *  line/area types onto a horizontal category axis). */
 indexAxis:LyraChartIndexAxis;
@@ -315,7 +356,8 @@ stackTotals:boolean;
 * config in `buildConfig()` (any key at any nesting depth — e.g.
 * `config.options.scales.y.min` — wins over the generated equivalent
 * without discarding sibling keys the generated config set), for consumers
-* who need full Chart.js control beyond the simplified `LyraChartSeries` shape.
+* who need full Chart.js control beyond the simplified `LyraChartSeries` shape. Generated bar
+* borderWidth/borderRadius defer to authored bar option scopes; explicit series.width still wins.
 *
 * Caveat: the merge only recurses into plain objects — an *array* value
 * (e.g. `config.plugins` as an inline-plugin array, or `config.data.datasets`)
@@ -344,7 +386,9 @@ private callbackIndexes;
 /** The public controlled snapshot when supplied, otherwise the effective configuration default. */
 private effectiveHiddenDatasetIndexes;
 /** Applies the public controlled state to the live Chart.js metadata after any data replacement. */
-private applyDatasetVisibility;private hasExplicitConfigData;private datasetLabel;private datasetValues;private isPointDataset;
+private applyDatasetVisibility;private isSliceChart;
+/** Reconcile through Chart.js's public category visibility API after data/index remapping. */
+private applyDatumVisibility;private hasExplicitConfigData;private datasetLabel;private datasetValues;private isPointDataset;
 /**
 * Appends one streamed category to numeric `data` series and optionally keeps only the newest
 * `maxPoints` categories. An explicitly supplied `config.data` member is updated at that same
@@ -366,7 +410,7 @@ private loading;
 */
 private loadFailed;private loadLibrary;private loadZoomFeature;private loadDataLabelsFeature;private loadAnnotationFeature;private loadGeneration;private zoomLoadGeneration;private dataLabelsLoadGeneration;private annotationLoadGeneration;private zoomFeatureState;private dataLabelsFeatureState;private annotationFeatureState;private dataLabelsPlugin?;private annotationPlugin?;private stopAnnotationRegistrationWatch?;private zoomed;private visible;private intersectionObserver?;private intersectionGeneration;private reducedMotionQuery?;private reducedMotionWindow?;private canvasEl?;
 /** The current Chart.js instance. Read it only while the element is connected and loaded. */
-chart?:LyraChartInstance;private chartJsModule?;private resizeObserver?;private resizeDrawFrame?;private resizeDrawFrameOwner?;private lastObservedInlineSize?;private autoLegendPosition;private resolvedChartArea?;private chartAreaUpdateQueued;private builtType?;private builtPlugins;private visualDatasetSourceIndexes?;private visualRowSourceIndexes?;private suppressZoomComplete;private descriptionId;private keyboardDatumIndex;private keyboardDatumAnnouncement;
+chart?:LyraChartInstance;private scaledSliceDatasets;private chartJsModule?;private resizeObserver?;private resizeDrawFrame?;private resizeDrawFrameOwner?;private lastObservedInlineSize?;private autoLegendPosition;private resolvedChartArea?;private chartAreaUpdateQueued;private builtType?;private builtPlugins;private visualDatasetSourceIndexes?;private visualRowSourceIndexes?;private suppressZoomComplete;private descriptionId;private keyboardDatumIndex;private keyboardDatumAnnouncement;
 /** Shared document-level regions that carry announcements. The visually hidden datum copy is an
 *  inspection mirror only because shadow-root live regions are not consistently spoken. */
 private politeAnnouncementSink?;private assertiveAnnouncementSink?;private lastDataTruncationAnnouncement;
@@ -420,6 +464,9 @@ protected willUpdate(changed:PropertyValues):void;protected updated(changed:Prop
 * unconditional post-update redraw.
 */
 protected chartContentChanged(changed:PropertyValues):boolean;private seriesToDataset;
+/** Let Chart.js resolve authored bar defaults, including scriptable/indexable values, at their
+* native scope. A generated per-dataset fallback would shadow every chart-level scope. */
+private hasConfiguredBarOption;
 /**
 * Resolves the `--lr-chart-*` theme tokens (declared in
 * `chart.styles.ts`, each layered over an existing semantic token) via
@@ -501,7 +548,7 @@ seriesPalette():string[];private tickOptions;private effectiveIndexAxis;
 /** The resolved Chart.js scale type for a value axis, honoring `scaleType`. */
 private valueScaleType;
 /** `beginAtZero` for a value axis, suppressed on a logarithmic scale which cannot place zero. */
-private valueBeginAtZero;private scaleBounds;private gridAxisVisible;
+private valueBeginAtZero;private scaleBounds;private gridAxisVisible;private axisVisible;
 /**
 * Builds `options.scales` for the effective chart type: no scale at all for
 * pie/doughnut (a proportional-area chart has no axis), the single radial
@@ -553,7 +600,9 @@ private localizedChartType;private formatValue;private legendValue;private legen
 */
 private legendGridPlacement;private updateChartArea;
 /** The current Chart.js chart-area geometry in canvas-local coordinates. */
-get chartArea():LyraChartArea|undefined;private buildConfig;private draw;private drawIfVisible;
+get chartArea():LyraChartArea|undefined;private buildConfig;
+/** Keep proportional slice geometry finite while every Lyra readout retains source values. */
+private scaleExtremeSlices;private draw;private drawIfVisible;
 /** Destroys the peer instance and reconciles the Lyra-owned zoom state in one place. */
 private discardChart;
 /**
@@ -589,4 +638,4 @@ private summarizeSeries;private formatSummaryValue;private formatTableValue;
 private formatExportValue;
 /** The `'spoken'` surface, for the live announcement a keyboard user hears. Falls back to the
 *  locale number format, which is what it always used. */
-private formatSpokenValue;private tableStackAxes;private tableStackTotalLabel;private accessibleName;private chartDescription;private dataTableSample;private generatedDataIsSampled;private dataTruncationMessage;private renderDataTable;private hasCustomDataTable;private legendTextFor;private legendColor;private toggleDataset;private renderLegend;render():TemplateResult;private get showsLegend();}declare global{interface HTMLElementTagNameMap{'lr-chart':LyraChart;}}
+private formatSpokenValue;private tableStackAxes;private tableStackTotalLabel;private accessibleName;private chartDescription;private dataTableSample;private generatedDataIsSampled;private dataTruncationMessage;private renderDataTable;private hasCustomDataTable;private legendTextFor;private legendColor;private toggleDataset;private toggleDatum;private renderLegend;render():TemplateResult;private get showsLegend();}declare global{interface HTMLElementTagNameMap{'lr-chart':LyraChart;}}