@aceshooting/lyra-ui 29.0.2 → 29.1.0

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 LyraSize,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;
+import type{LyraSpatialBounds,LyraChartSpatialPointSelectDetail,LyraSpatialBinSelectDetail}from'../../../utilities/data-spatial.js';export type{LyraSpatialBounds,LyraSpatialBin,LyraSpatialChartPoint,LyraSpatialChartSeries,LyraSpatialChartSource,LyraChartSpatialPointSelectDetail,LyraSpatialBinSelectDetail}from'../../../utilities/data-spatial.js';import{type LyraChartPreparedData,type LyraChartSourcePointSelectDetail,type LyraChartSourceCategorySelectDetail}from'./chart-prepared-data.js';import type{LyraSeriesPointRef}from'../../../utilities/data-preparation.js';export type{LyraChartPreparedData,LyraChartSourcePointSelectDetail,LyraChartSourceCategorySelectDetail}from'./chart-prepared-data.js';export type{LyraPreparedSeriesData,LyraPreparedCategoryData,LyraPreparedSeries,LyraSeriesSample,LyraSeriesPointRef,LyraSeriesObservation,LyraSeriesRangeRequest}from'../../../utilities/data-preparation.js';import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import'../../overlays/skeleton/skeleton.class.js';import{type LyraSize,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;
 /**
@@ -113,7 +113,7 @@ interface RuntimeChart{data:{labels?:unknown[];datasets:LyraChartDatasetConfigur
 * 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{
+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-spatial-point-select':CustomEvent<LyraChartSpatialPointSelectDetail>;'lr-spatial-bin-select':CustomEvent<LyraSpatialBinSelectDetail>;'lr-source-point-select':CustomEvent<LyraChartSourcePointSelectDetail>;'lr-source-category-select':CustomEvent<LyraChartSourceCategorySelectDetail>;
 /** A data point, segment or generated-table value was activated by pointer or keyboard. */
 'lr-point-activate':CustomEvent<{datasetIndex:number;index:number;label:string|undefined;value:unknown;}>;'lr-zoom':CustomEvent<{zoomed:boolean;}>;
 /** Canonical name for the legend-visibility veto point. */
@@ -151,8 +151,23 @@ export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=L
 * Create a new collection and reassign it after changes; mutating the assigned array does not
 * update the view. `labels` does not yet share this contract.
 *
+* Prepared inputs are immutable summaries of a complete source. Series preserve original x/y,
+* indices and gaps; category values represent named aggregates. Generated tables and synchronous
+* Spatial scatter/bubble sources preserve complete density counts with bounded point overlays.
+* Spatial mode requires maxRecords >= 3 and linear axes; viewport and selectedPointId are
+* property-only controls. Density always includes all series, independently of point visibility.
+* exportData contain the displayed summary, not every original observation. Exact point reveal
+* reads one original position and optionally requests an indexed neighborhood. Zoom itself remains
+* on the overview; it never guesses source indices from a numeric x coordinate.
+*
 * @customElement lr-chart
 * @event lr-zoom - `detail: { zoomed }`.
+* @event lr-spatial-point-select - A spatial point was activated; detail preserves revision and original point identity, coordinates, series and radius.
+* @event lr-spatial-bin-select - A density region was activated; detail contains revision, bounds and count.
+* @event lr-source-point-select - A prepared observation was activated. Detail contains revision,
+*   seriesId, original sourceIndex and point { x, y }; legacy activation indices remain plotted indices.
+* @event lr-source-category-select - A prepared aggregate was activated. Detail contains revision,
+*   seriesId, categoryId, value and observationCount.
 * @event lr-point-activate - Fired when pointer input lands on a data point/segment, when a
 *   generated data-table value is activated, or when Enter/Space activates the keyboard-current
 *   canvas datum. `detail: { datasetIndex: number, index: number, label: string |
@@ -193,6 +208,7 @@ export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=L
 *   the data table visible and retries on data updates or `refreshTheme()`; its transition is
 *   announced through a shared light-DOM alert.
 * @csspart notices - Wrapper for nonfatal feature warnings and generated-data truncation notices.
+* @csspart limit - Admission-limit disclosure when an input exceeds 10,000 entries.
 * @csspart data-truncation - Explanation shown when the generated accessible alternative samples
 *   a data set larger than its 1,000-record ceiling.
 * @csspart feature-warning - Static nonfatal warning when a requested optional feature peer is
@@ -281,7 +297,39 @@ export interface LyraChartDatumActivateDetail<TKind extends LyraChartDatumKind=L
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraChart extends LyraElement<LyraChartEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly immutableEventDetails:readonly string[];protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];constructor();private readonly canvasTokens;type:LyraChartType;labels:string[];private labelsSnapshot?;private annotationsSnapshot?;private appliedLegendVisibility?;private hiddenDatasetsSnapshot?;private canonicalLabels;private canonicalAnnotations;private canonicalHiddenDatasets;private _datasets;private datasetsSource;
+export declare class LyraChart extends LyraElement<LyraChartEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly immutableEventDetails:readonly string[];protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];constructor();private readonly canvasTokens;type:LyraChartType;private _preparedData;
+/**
+* Property-only immutable whole-source summary. Takes precedence over labels, datasets and
+* config.data. Series require line/bar; categories require bar or a radial category chart.
+* Spatial sources require scatter/bubble, linear axes and maxRecords >= 3. Bubble sources
+* declare an exact full-source radiusDomain and a finite nonnegative radius on every point.
+* Spatial CSV exports bounded point/bin rows with original coordinates and identity.
+* All peer entries (including gap separators) must fit aggregate maxRecords, with two slots
+* reserved for an isolated exact-point overlay. Rectangular table cells stay at most 1,000;
+* semantic samples plus the overlay stay at most 9,000. Four samples without gaps need at
+* least six maxRecords slots; each line gap needs another slot. Oversized summaries fail visibly.
+* Reassign or explicitly requestUpdate after changing a host-authored descriptor/revision.
+*/
+get preparedData():LyraChartPreparedData|null;set preparedData(value:LyraChartPreparedData|null);
+/** Specialized derived distributions may supply their own bounded semantic input. */
+protected preparedDataInput():LyraChartPreparedData|null;
+/** Full spatial viewport; null retains the exact global source bounds. */
+viewport:LyraSpatialBounds|null;
+/** Controlled exact spatial selection, independent of reveal focus. */
+selectedPointId:string;private spatialActive;private spatial;private spatialWaiters;private spatialRevealToken;private preparedGeneration;private spatialKeyboardIndex;private spatialChanged;private wakeSpatialWaiters;private spatialPoints;private spatialSeriesPoints;private spatialGuard;private spatialPointText;private spatialBinText;private activateSpatialPoint;private activateSpatialBin;private revealSpatialPoint;private spatialKeyboardItems;private spatialKeyDown;private renderSpatialTable;private preparedDirty;private preparedActive;private preparedChanged;private preparedInvalid;private preparedPending;private preparedRequestFailed;private announcedPreparedInvalid;private preparedBaseModel?;private preparedModel?;private preparedEffective?;private readonly preparedRequests;private refreshPreparedModel;
+/**
+* Resolves one original source position and adds a bounded isolated overlay. Returns false for
+* missing, invalid, canceled or obsolete points. It never interprets sourceIndex as a peer index
+* or scans the original source. An optional queryRange refines a bounded index neighborhood
+* around the revealed point. Zoom itself remains summary-only and never guesses an x/index map.
+*/
+revealSourcePoint(id:string):Promise<boolean>;revealSourcePoint(ref:LyraSeriesPointRef):Promise<boolean>;labels:string[];
+/** Maximum rendered records across all series, clamped to 2–1,000. The plot width may lower
+* this bound. Numeric bucket extremes and both endpoints are retained when the budget permits.
+* Summaries and CSV exports retain the complete admitted input (at most 10,000 entries per array).
+* @default 1000
+*/
+maxRecords:number;private samplingWidth;private labelsSnapshot?;private annotationsSnapshot?;private appliedLegendVisibility?;private hiddenDatasetsSnapshot?;private canonicalLabels;private canonicalAnnotations;private canonicalHiddenDatasets;private _datasets;private datasetsSource;
 /** Simplified chart series. Non-record entries are dropped while valid sibling series remain. */
 get datasets():readonly LyraChartSeries[];set datasets(value:readonly LyraChartSeries[]);
 /**
@@ -478,7 +526,7 @@ protected normalizeEffectiveConfig(config:LyraChartConfiguration|undefined):Lyra
 * `maxPoints` categories. An explicitly supplied `config.data` member is updated at that same
 * source; generated members continue to update `labels`/`datasets`, preserving generated styling.
 * Point-based scatter/bubble series are left unchanged because their x/y/r coordinates need a
-* richer host-defined append contract.
+* richer host-defined append contract. Inactive while preparedData is supplied.
 */
 appendData(label:string,values:(number|null)[],maxPoints?:number):void;
 /**
@@ -556,7 +604,7 @@ seriesPalette():string[];private tickLabelIsolation;private tickOptions;private
 *  documented no-op (matching `lr-histogram`'s `labels`/`datasets` pattern) so an accidental
 *  `.chartArea=${x}` Lit template binding degrades silently instead of throwing from inside
 *  lit-html's property-commit. */
-get chartArea():LyraChartArea|undefined;set chartArea(_value:LyraChartArea|undefined);private buildConfig;private scaleExtremeSlices;private draw;private setCanvasUnavailable;private drawIfVisible;private restoreZoomedBounds;private discardChart;
+get chartArea():LyraChartArea|undefined;set chartArea(_value:LyraChartArea|undefined);private spatialDescription;private buildSpatialConfig;private buildConfig;private scaleExtremeSlices;private draw;private setCanvasUnavailable;private drawIfVisible;private restoreZoomedBounds;private discardChart;
 /**
 * Renders or incrementally updates the current Chart.js instance from the effective public
 * properties/config. Offscreen/disconnected charts remain gated until visible/reconnected.
@@ -574,4 +622,6 @@ resetZoom():void;
 * observe (e.g. a same-attribute value swap the observer already covers is
 * handled, but a fully out-of-band restyle is not).
 */
-refreshTheme():void;private summarizeSeries;private formatSummaryValue;private formatTableValue;private formatExportValue;private formatSpokenValue;private tableStackAxes;private tableStackTotalLabel;private accessibleName;private chartDescription;private dataTableSample;private dataTableSampleMemo?;private generatedDataIsSampled;private dataTruncationMessage;private renderDataTable;private dataTableRows?;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private renderDataTableRows;private hasCustomDataTable;private legendMessage;private legendTextContent;private legendColor;private toggleDataset;private toggleDatum;private renderLegend;render():TemplateResult;private get showsLegend();}declare global{interface HTMLElementTagNameMap{'lr-chart':LyraChart;}}
+refreshTheme():void;private readonly seriesSummaryMemo;private summarizeSeries;private summarizeSeriesValues;private formatSummaryValue;private formatTableValue;private formatExportValue;private formatSpokenValue;private tableStackAxes;private tableStackTotalLabel;private accessibleName;private descriptionMemo?;private chartDescription;private buildChartDescription;private dataTableSample;private dataTableSampleMemo?;private generatedDataIsSampled;protected inputLimitMessage():string;private dataTruncationMessage;private renderDataTable;private dataTableRows?;private deferredTableRows?;private cancelDeferredTable?;private streamingTableUpdate;
+/** Keep only stream-originated invalidations inside a coalesced table refresh. */
+protected withStreamedTableUpdate(update:()=>void):void;private clearDeferredTable;private deferStreamedTable;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private renderDataTableRows;private hasCustomDataTable;private legendMessage;private legendTextContent;private legendColor;private toggleDataset;private toggleDatum;private renderLegend;render():TemplateResult;private get showsLegend();}declare global{interface HTMLElementTagNameMap{'lr-chart':LyraChart;}}