@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/charts/chart/chart.styles.js

@@ -1 +1 @@
-import{focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";import{chartLegendPositionStyles}from"./chart-surface.styles.js";const styles=css` [part='base'] { position: relative; inline-size: 100%; min-inline-size: 0; block-size: 100%; box-sizing: border-box; display: grid; grid-template-areas: 'plot' 'legend' 'warning' 'table-toggle' 'table'; grid-template-columns: minmax(0, 1fr); align-items: start; } .config-slot { display: none; } [part='notices'] { grid-area: warning; display: grid; gap: var(--lr-space-2xs); } [part='feature-warning'], [part='data-truncation'] { margin: 0; padding: var(--lr-space-xs); color: var(--lr-color-warning); font-size: var(--lr-font-size-sm); overflow-wrap: anywhere; } ${chartLegendPositionStyles("warning")} [part='data-table'] button { font: inherit; color: inherit; border: 0; border-radius: var(--lr-radius); background: transparent; padding: var(--lr-space-2xs); cursor: pointer; } [part='data-table'] button:hover { background: var(--lr-chart-data-table-button-hover-bg, var(--lr-color-brand-quiet)); } [part='data-table'] button:active { background: var( --lr-chart-data-table-button-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } [part='data-table'] button:focus-visible { ${focusRing} } [part='center'] { position: absolute; transform: translate(-50%, -50%); pointer-events: none; text-align: center; } [part='reset-zoom-button'] { position: absolute; inset-block-start: var(--lr-space-xs); inset-inline-end: var(--lr-space-xs); font: inherit; font-size: var(--lr-font-size-xs); padding: var(--lr-size-0-15rem) var(--lr-size-0-5rem); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); color: var(--lr-color-text); max-inline-size: calc(100% - var(--lr-space-xs) - var(--lr-space-xs)); white-space: normal; overflow-wrap: anywhere; cursor: pointer; } [part='reset-zoom-button']:hover { background: var(--lr-chart-reset-zoom-button-hover-bg, var(--lr-color-brand-quiet)); } [part='reset-zoom-button']:active { background: var( --lr-chart-reset-zoom-button-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } [part='reset-zoom-button']:focus-visible { ${focusRing} } [part='data-table-toggle']:hover { background: var(--lr-chart-data-table-toggle-hover-bg, var(--lr-color-brand-quiet)); } [part='data-table-toggle']:active { background: var( --lr-chart-data-table-toggle-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } `;export{styles};
+import{focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";import{chartLegendPositionStyles}from"./chart-surface.styles.js";const styles=css` [part='base'] { position: relative; inline-size: 100%; min-inline-size: 0; block-size: 100%; box-sizing: border-box; display: grid; grid-template-areas: 'plot' 'legend' 'warning' 'table-toggle' 'table'; grid-template-columns: minmax(0, 1fr); align-items: start; } .config-slot { display: none; } [part='notices'] { grid-area: warning; display: grid; gap: var(--lr-space-2xs); } [part='feature-warning'], [part='data-truncation'], [part='limit'] { margin: 0; padding: var(--lr-space-xs); color: var(--lr-color-warning); font-size: var(--lr-font-size-sm); overflow-wrap: anywhere; } ${chartLegendPositionStyles("warning")} [part='data-table'] button { font: inherit; color: inherit; border: 0; border-radius: var(--lr-radius); background: transparent; padding: var(--lr-space-2xs); cursor: pointer; } [part='data-table'] button:hover { background: var(--lr-chart-data-table-button-hover-bg, var(--lr-color-brand-quiet)); } [part='data-table'] button:active { background: var( --lr-chart-data-table-button-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } [part='data-table'] button:focus-visible { ${focusRing} } [part='center'] { position: absolute; transform: translate(-50%, -50%); pointer-events: none; text-align: center; } [part='reset-zoom-button'] { position: absolute; inset-block-start: var(--lr-space-xs); inset-inline-end: var(--lr-space-xs); font: inherit; font-size: var(--lr-font-size-xs); padding: var(--lr-size-0-15rem) var(--lr-size-0-5rem); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); color: var(--lr-color-text); max-inline-size: calc(100% - var(--lr-space-xs) - var(--lr-space-xs)); white-space: normal; overflow-wrap: anywhere; cursor: pointer; } [part='reset-zoom-button']:hover { background: var(--lr-chart-reset-zoom-button-hover-bg, var(--lr-color-brand-quiet)); } [part='reset-zoom-button']:active { background: var( --lr-chart-reset-zoom-button-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } [part='reset-zoom-button']:focus-visible { ${focusRing} } [part='data-table-toggle']:hover { background: var(--lr-chart-data-table-toggle-hover-bg, var(--lr-color-brand-quiet)); } [part='data-table-toggle']:active { background: var( --lr-chart-data-table-toggle-active-bg, color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)) ); } `;export{styles};

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

@@ -1,7 +1,11 @@
-import{LyraChart,type LyraChartType}from'./chart.class.js';
+export type{LyraChartPreparedData,LyraChartSourcePointSelectDetail,LyraChartSourceCategorySelectDetail,LyraPreparedSeriesData,LyraPreparedCategoryData,LyraSeriesPointRef}from'./chart.class.js';import{LyraChart,type LyraChartType}from'./chart.class.js';
 /**
 * `<lr-doughnut-chart>` — `<lr-chart>` with a `"doughnut"` default and the mirrored writable type.
 *
+* Prepared-data compatibility follows the current writable type: line accepts series, bar
+* accepts series/categories, radial category types accept categories. Spatial types require
+* their own source route and reject these prepared kinds.
+*
 * @customElement lr-doughnut-chart
 * @status stable
 * @since 4.0.0

package/dist/components/charts/chart/histogram-buckets.d.ts

@@ -1 +1 @@
-import{type HistogramBucket}from'./histogram-bin.js';interface HistogramBucketSource{readonly bins:number;readonly values:readonly number[];}export declare function binnedBuckets(el:HistogramBucketSource):HistogramBucket[];export{};
+import type{LyraHistogramDistribution}from'../../../utilities/data-preparation.js';import{type HistogramBucket}from'./histogram-bin.js';interface HistogramBucketSource{readonly distribution?:LyraHistogramDistribution|null;readonly bins:number;readonly values:readonly number[];}export declare function binnedBuckets(el:HistogramBucketSource):HistogramBucket[];export{};

package/dist/components/charts/chart/histogram-buckets.js

@@ -1 +1 @@
-import{binValues,normalizeHistogramBinCount}from"./histogram-bin.js";const bucketCache=new WeakMap;function binnedBuckets(el){const bins=normalizeHistogramBinCount(el.bins),locale=el.effectiveLocale,cached=bucketCache.get(el);if(cached&&cached.values===el.values&&cached.bins===bins&&cached.locale===locale)return cached.buckets;const buckets=binValues(el.values,bins,locale);return bucketCache.set(el,{values:el.values,bins,locale,buckets}),buckets}export{binnedBuckets};
+import{sourceCount,sourceRevision}from"../../../internal/source-request-controller.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{resolveActiveOrExplicitLocale}from"../../../internal/localization-runtime.js";import{binValues,normalizeHistogramBinCount}from"./histogram-bin.js";function own(value,key){if(value===null||typeof value!="object")throw new TypeError("Invalid distribution");const descriptor=Object.getOwnPropertyDescriptor(value,key);if(!descriptor||!("value"in descriptor))throw new TypeError("Invalid distribution");return descriptor.value}function snapshotHistogramDistribution(value){const revision=sourceRevision(own(value,"revision")),rawCounts=own(value,"counts"),source=sourceCount(own(rawCounts,"sourceCount")),valid=sourceCount(own(rawCounts,"validCount")),invalid=sourceCount(own(rawCounts,"invalidCount"));if(valid>source||invalid!==source-valid)throw new TypeError("Invalid counts");const rawEdges=own(value,"edges"),rawBins=own(value,"binCounts");if(!Array.isArray(rawEdges)||!Array.isArray(rawBins))throw new TypeError("Invalid bins");const edgeLength=sourceCount(own(rawEdges,"length")),binLength=sourceCount(own(rawBins,"length"));if(edgeLength>1001||binLength>1e3||edgeLength!==0&&edgeLength<2||binLength!==Math.max(0,edgeLength-1))throw new TypeError("Invalid bins");const edges=[],binCounts=[];for(let index=0;index<edgeLength;index++){const edge=own(rawEdges,index);if(typeof edge!="number"||!Number.isFinite(edge)||index>0&&edge<=edges[index-1])throw new TypeError("Invalid edge");edges.push(edge)}let remainder=valid;for(let index=0;index<binLength;index++){const count=sourceCount(own(rawBins,index));if(count>remainder)throw new TypeError("Invalid bin count");remainder-=count,binCounts.push(count)}const belowCount=sourceCount(own(value,"belowCount")),aboveCount=sourceCount(own(value,"aboveCount"));if(belowCount>remainder||aboveCount!==remainder-belowCount||!edges.length&&valid!==0)throw new TypeError("Invalid outliers");const rawDomain=own(value,"domain");let domain=null;if(valid){const min=own(rawDomain,"min"),max=own(rawDomain,"max");if(typeof min!="number"||typeof max!="number"||!Number.isFinite(min)||!Number.isFinite(max)||min>max)throw new TypeError("Invalid domain");if(belowCount>0!=min<edges[0]||aboveCount>0!=max>edges.at(-1))throw new TypeError("Invalid outlier domain");for(let index=0;index<binLength;index++){if(binCounts[index]===0)continue;const lo=edges[index],hi=edges[index+1];if(lo>max||(index===binLength-1?hi<min:hi<=min))throw new TypeError("Populated bin outside domain")}const partition=point=>{if(point<edges[0])return-1;if(point>edges[edgeLength-1])return binLength;let index=0;for(;index<binLength-1&&point>=edges[index+1];)index++;return index},partitionCount=index=>index<0?belowCount:index===binLength?aboveCount:binCounts[index],minPartition=partition(min),maxPartition=partition(max);if(partitionCount(minPartition)===0||partitionCount(maxPartition)===0||min!==max&&minPartition===maxPartition&&partitionCount(minPartition)<2)throw new TypeError("Unrepresented domain extrema");domain=Object.freeze({min,max})}else if(rawDomain!==null)throw new TypeError("Invalid empty domain");return Object.freeze({revision,counts:Object.freeze({sourceCount:source,validCount:valid,invalidCount:invalid}),domain,edges:Object.freeze(edges),binCounts:Object.freeze(binCounts),belowCount,aboveCount})}function distributionBuckets(distribution,locale){return Object.freeze(distribution.binCounts.map((count,index)=>{const lo=distribution.edges[index],hi=distribution.edges[index+1],width=hi-lo,formatter=getNumberFormat(resolveActiveOrExplicitLocale(locale),{maximumFractionDigits:Math.min(20,Math.max(0,1-Math.floor(Math.log10(width))))||0}),range=formatter.formatRange,label=range?range.call(formatter,lo,hi):`${formatter.format(lo)}–${formatter.format(hi)}`;return Object.freeze({label:`⁦${label}⁩`,count})}))}const distributionCache=new WeakMap,distributionGenerations=new WeakMap;function invalidateHistogramBuckets(el){distributionGenerations.set(el,{}),distributionCache.delete(el)}const bucketCache=new WeakMap;function binnedBuckets(el){const locale=el.effectiveLocale,distribution=el.distribution;if(distribution!=null){const generation=distributionGenerations.get(el),cached2=distributionCache.get(el);if(cached2?.source===distribution&&cached2.locale===locale)return cached2.buckets;let buckets2;try{buckets2=distributionBuckets(snapshotHistogramDistribution(distribution),locale)}catch{buckets2=[]}return el.distribution===distribution&&distributionGenerations.get(el)===generation&&distributionCache.set(el,{source:distribution,locale,buckets:buckets2}),buckets2}const bins=normalizeHistogramBinCount(el.bins),cached=bucketCache.get(el);if(cached&&cached.values===el.values&&cached.bins===bins&&cached.locale===locale)return cached.buckets;const buckets=binValues(el.values,bins,locale);return bucketCache.set(el,{values:el.values,bins,locale,buckets}),buckets}export{binnedBuckets,distributionBuckets,invalidateHistogramBuckets,snapshotHistogramDistribution};

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

@@ -1,4 +1,4 @@
-import type{PropertyValues}from'lit';import{LyraChart,type LyraChartConfiguration}from'./chart.class.js';export{binnedBuckets}from'./histogram-buckets.js';
+import type{PropertyValues}from'lit';import{LyraChart,type LyraChartConfiguration}from'./chart.class.js';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraHistogramDistribution}from'../../../utilities/data-preparation.js';export type{LyraHistogramDistribution}from'../../../utilities/data-preparation.js';import type{LyraChartPreparedData}from'./chart-prepared-data.js';export{binnedBuckets}from'./histogram-buckets.js';
 /**
 * `<lr-histogram>` — bins `values` into `bins` equal-width buckets and
 * renders them as a bar chart. Chart.js has no built-in histogram
@@ -7,6 +7,13 @@ import type{PropertyValues}from'lit';import{LyraChart,type LyraChartConfiguratio
 * Public collection properties take bounded, clone-owned readonly snapshots. Create a new
 * collection and reassign it after changes; mutating the assigned array does not update the view.
 *
+* `distribution` supplies exact pre-binned whole-source counts without retaining raw samples.
+* It takes precedence over values, bins and inherited preparedData. The plot/table/CSV contain
+* only bins; the visible and accessible summary also reports invalid and out-of-range counts.
+* Bin intervals are half-open except the final inclusive upper edge. Bins must fit maxRecords
+* and the inherited table budget; incompatible distributions are visibly rejected, never sampled.
+* Inherited preparedData without distribution is incompatible with histogram bin semantics.
+*
 * @customElement lr-histogram
 * @status stable
 * @since 4.0.0
@@ -19,17 +26,25 @@ protected static readonly appendOrderedCollectionProperties:readonly string[];st
 values:readonly number[];
 /** Dataset label used for the legend, tooltip, table, and summary. */
 seriesLabel:string;
+/** Exact bounded distribution, normally from prepareLyraHistogram. Property-only; null keeps
+* the raw rolling-window route. At most 1,000 bins; maxRecords must admit every bin. A bounded
+* own-data snapshot is taken on assignment or explicit requestUpdate(); accessors are rejected.
+* Reassign or explicitly refresh after mutating a descriptor. Raw append calls are inactive
+* while supplied, and assignment cancels any unfinished raw append. */
+get distribution():LyraHistogramDistribution|null;set distribution(value:LyraHistogramDistribution|null);private _distribution;private distributionDirty;private distributionSnapshot?;private distributionProjection?;private distributionLocale?;private distributionLabel?;private refreshDistribution;protected preparedDataInput():LyraChartPreparedData|null;protected willUpdate(changed:PropertyValues):void;private readonly sampleBatches;private sampleTimer?;private committingSamples;
 /**
 * Appends raw finite samples to `values`, keeping a rolling window of the newest `maxSamples`
 * samples (at most 10,000, the `values` snapshot bound, which is also the default). The inherited
 * signature is retained so histogram remains substitutable for `LyraChart`; its category label
-* has no meaning for rebinned samples.
+* has no meaning for rebinned samples. Invalid-heavy batches finish in bounded asynchronous
+* chunks, in call order; assigning values or disconnecting cancels unfinished appends.
+* Queued arrays remain caller-owned and must stay unchanged until their batch is applied.
 */
-appendSamples(values:readonly(number|null)[],maxSamples?:number):void;private normalizedConfig?;protected normalizeEffectiveConfig(config:LyraChartConfiguration|undefined):LyraChartConfiguration|undefined;
+appendSamples(values:readonly(number|null)[],maxSamples?:number):void;private cancelSampleBatches;requestUpdate(name?:PropertyKey,oldValue?:unknown,options?:Parameters<LyraElement['requestUpdate']>[2]):void;disconnectedCallback():void;private continueSampleBatch;private normalizedConfig?;protected normalizeEffectiveConfig(config:LyraChartConfiguration|undefined):LyraChartConfiguration|undefined;
 /**
 * Inherited `LyraChart` signature, retained so histogram stays substitutable for its base class;
 * `_label` has no meaning for rebinned samples and is ignored. Prefer the histogram-specific
 * `appendSamples(values, maxSamples?)` alongside it — same behavior, without the unused label
 * parameter.
 */
-appendData(_label:string,values:(number|null)[],maxPoints?:number):void;protected chartContentChanged(changed:PropertyValues):boolean;}declare global{interface HTMLElementTagNameMap{'lr-histogram':LyraHistogram;}}
+appendData(_label:string,values:(number|null)[],maxPoints?:number):void;protected inputLimitMessage():string;protected chartContentChanged(changed:PropertyValues):boolean;}declare global{interface HTMLElementTagNameMap{'lr-histogram':LyraHistogram;}}

package/dist/components/charts/chart/histogram.class.js

@@ -1 +1 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{property}from"lit/decorators.js";import{LyraChart}from"./chart.class.js";import{lockChartType}from"./chart-type-lock.js";import{LyraElement}from"../../../internal/lyra-element.js";import{srOnly}from"../../../internal/a11y.js";import{specialistTokens}from"../../../internal/specialist-host-tokens.styles.js";import{normalizeHistogramBinCount}from"./histogram-bin.js";import{styles}from"./histogram.styles.js";import{chartSurfaceStyles}from"./chart-surface.styles.js";import{binnedBuckets}from"./histogram-buckets.js";import{binnedBuckets as binnedBuckets2}from"./histogram-buckets.js";import{bidiStyles}from"./chart-bidi.js";import{LYRA_DEFAULT_histogramFrequency}from"../../../internal/default-strings/charts.generated.js";const MAX_HISTOGRAM_SAMPLES=1e4;class LyraHistogram extends LyraChart{constructor(){super(...arguments),this.type="bar",this.bins=10,this.values=[],this.seriesLabel=""}static{this.defaultStrings={...super.defaultStrings,histogramFrequency:LYRA_DEFAULT_histogramFrequency}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["values"])}static{this.appendOrderedCollectionProperties=Object.freeze(["values"])}static{this.styles=[LyraElement.styles,specialistTokens,chartSurfaceStyles,styles,srOnly,bidiStyles]}appendSamples(values,maxSamples=0){const appended=values.filter(value=>typeof value=="number"&&Number.isFinite(value)),requested=Number.isFinite(maxSamples)?Math.max(0,Math.floor(maxSamples)):0,limit=requested>0?Math.min(requested,MAX_HISTOGRAM_SAMPLES):MAX_HISTOGRAM_SAMPLES;this.values=[...this.values,...appended].slice(-limit)}normalizeEffectiveConfig(config){if(!config)return;if(this.normalizedConfig?.source===config)return this.normalizedConfig.value;const normalized={...config};return delete normalized.type,delete normalized.data,this.normalizedConfig={source:config,value:normalized},normalized}appendData(_label,values,maxPoints=0){this.appendSamples(values,maxPoints)}chartContentChanged(changed){return super.chartContentChanged(changed)||["values","bins","seriesLabel"].some(name=>changed.has(name))}}__decorate([property({converter:{fromAttribute:value=>normalizeHistogramBinCount(value)}})],LyraHistogram.prototype,"bins",void 0),__decorate([property({attribute:!1})],LyraHistogram.prototype,"values",void 0),__decorate([property({attribute:"series-label"})],LyraHistogram.prototype,"seriesLabel",void 0);const derivedCache=new WeakMap;function derivedSeries(el,label){const buckets=binnedBuckets(el);let cached=derivedCache.get(el);return(cached?.buckets!==buckets||cached.label!==label)&&(cached={buckets,label,labels:Object.freeze(buckets.map(b=>b.label.replace(/^\u2066|\u2069$/gu,""))),datasets:Object.freeze([Object.freeze({label,data:Object.freeze(buckets.map(b=>b.count))})])},derivedCache.set(el,cached)),cached}Object.defineProperty(LyraHistogram.prototype,"labels",{configurable:!0,enumerable:!0,get(){return derivedSeries(this,this.seriesLabel||this.localize("histogramFrequency")).labels},set(_v){}}),Object.defineProperty(LyraHistogram.prototype,"datasets",{configurable:!0,enumerable:!0,get(){return derivedSeries(this,this.seriesLabel||this.localize("histogramFrequency")).datasets},set(_v){}}),lockChartType(LyraHistogram,"bar");export{LyraHistogram,binnedBuckets2 as binnedBuckets};
+import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{property}from"lit/decorators.js";import{LyraChart,projectChartSeries}from"./chart.class.js";import{lockChartType}from"./chart-type-lock.js";import{LyraElement}from"../../../internal/lyra-element.js";import{srOnly}from"../../../internal/a11y.js";import{specialistTokens}from"../../../internal/specialist-host-tokens.styles.js";import{normalizeHistogramBinCount}from"./histogram-bin.js";import{styles}from"./histogram.styles.js";import{chartSurfaceStyles}from"./chart-surface.styles.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{binnedBuckets,distributionBuckets,invalidateHistogramBuckets,snapshotHistogramDistribution}from"./histogram-buckets.js";import{binnedBuckets as binnedBuckets2}from"./histogram-buckets.js";import{bidiStyles}from"./chart-bidi.js";import{LYRA_DEFAULT_histogramDistributionRange,LYRA_DEFAULT_histogramDistributionSummary,LYRA_DEFAULT_histogramFrequency,LYRA_DEFAULT_histogramInputLimit}from"../../../internal/default-strings/charts.generated.js";import{LYRA_DEFAULT_chartSummarySeparator}from"../../../internal/default-strings/shared.generated.js";const MAX_HISTOGRAM_SAMPLES=1e4,incompatibleDistribution=Object.freeze({});class LyraHistogram extends LyraChart{constructor(){super(...arguments),this.type="bar",this.bins=10,this.values=[],this.seriesLabel="",this._distribution=null,this.distributionDirty=!0,this.sampleBatches=[],this.committingSamples=!1}static{this.defaultStrings={...super.defaultStrings,chartSummarySeparator:LYRA_DEFAULT_chartSummarySeparator,histogramDistributionRange:LYRA_DEFAULT_histogramDistributionRange,histogramDistributionSummary:LYRA_DEFAULT_histogramDistributionSummary,histogramFrequency:LYRA_DEFAULT_histogramFrequency,histogramInputLimit:LYRA_DEFAULT_histogramInputLimit}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["values"])}static{this.appendOrderedCollectionProperties=Object.freeze(["values"])}static{this.styles=[LyraElement.styles,specialistTokens,chartSurfaceStyles,styles,srOnly,bidiStyles]}get distribution(){return this._distribution}set distribution(value){const old=this._distribution;this._distribution=value,this.requestUpdate("distribution",old)}refreshDistribution(){if(this.distributionDirty&&(this.distributionDirty=!1,this.distributionSnapshot=void 0,this.distributionProjection=void 0,this._distribution!=null))try{const snapshot=snapshotHistogramDistribution(this._distribution),buckets=distributionBuckets(snapshot,this.effectiveLocale),count=snapshot.counts.validCount-snapshot.belowCount-snapshot.aboveCount;this.distributionProjection=Object.freeze({kind:"categories",revision:snapshot.revision,aggregation:"count",counts:Object.freeze({sourceCount:count,validCount:count,invalidCount:0}),categories:Object.freeze(buckets.map((bucket,index)=>Object.freeze({id:`bin${index}`,label:bucket.label.replace(/^\u2066|\u2069$/gu,"")}))),categoryCounts:snapshot.binCounts,series:Object.freeze([Object.freeze({id:"histogram",label:this.seriesLabel||this.localize("histogramFrequency"),values:snapshot.binCounts})])}),this.distributionSnapshot=snapshot}catch{}}preparedDataInput(){return this.refreshDistribution(),this._distribution!=null?this.distributionProjection??incompatibleDistribution:this.preparedData==null?null:incompatibleDistribution}willUpdate(changed){const locale=this.effectiveLocale,label=this.seriesLabel||this.localize("histogramFrequency");(locale!==this.distributionLocale||label!==this.distributionLabel)&&(this.distributionLocale=locale,this.distributionLabel=label,this.distributionDirty=!0,this._distribution!=null&&super.requestUpdate("preparedData",void 0)),super.willUpdate(changed)}emitPreparedSourceSelection(_datasetIndex,_index){}preparedSummary(){const snapshot=this.distributionSnapshot;if(!snapshot)return;const format=getNumberFormat(this.effectiveLocale),summary=this.localize("histogramDistributionSummary",void 0,{validCount:format.format(snapshot.counts.validCount),invalidCount:format.format(snapshot.counts.invalidCount),belowCount:format.format(snapshot.belowCount),aboveCount:format.format(snapshot.aboveCount)});return snapshot.domain?[summary,this.localize("histogramDistributionRange",void 0,{min:format.format(snapshot.domain.min),max:format.format(snapshot.domain.max)})].join(this.localize("chartSummarySeparator")):summary}appendSamples(values,maxSamples=0){if(this._distribution!=null||!Array.isArray(values))return;const requested=Number.isFinite(maxSamples)?Math.max(0,Math.floor(maxSamples)):0,limit=requested>0?Math.min(requested,MAX_HISTOGRAM_SAMPLES):MAX_HISTOGRAM_SAMPLES;this.sampleBatches.push({source:values,limit,newest:[],cursor:values.length-1}),this.sampleBatches.length===1&&this.continueSampleBatch()}cancelSampleBatches(){clearTimeout(this.sampleTimer),this.sampleTimer=void 0,this.sampleBatches&&(this.sampleBatches.length=0)}requestUpdate(name,oldValue,options){(name==="values"&&!this.committingSamples||name==="distribution"||name===void 0&&this._distribution!=null)&&this.cancelSampleBatches(),(name===void 0||["distribution","seriesLabel","locale","strings"].includes(String(name)))&&(this.distributionDirty=!0,invalidateHistogramBuckets(this),name!==void 0&&this._distribution!=null&&super.requestUpdate("preparedData",void 0),name==="distribution"&&this._distribution==null&&super.requestUpdate("preparedData",void 0)),super.requestUpdate(name,oldValue,options)}disconnectedCallback(){this.cancelSampleBatches(),super.disconnectedCallback()}continueSampleBatch(){const batch=this.sampleBatches[0];if(!batch)return;const end=Math.max(-1,batch.cursor-1e4);for(;batch.cursor>end&&batch.newest.length<batch.limit;batch.cursor--){let value;try{value=batch.source[batch.cursor]}catch{if(this.sampleBatches[0]!==batch)return;continue}if(this.sampleBatches[0]!==batch)return;typeof value=="number"&&Number.isFinite(value)&&batch.newest.push(value)}if(batch.cursor<0||batch.newest.length===batch.limit){for(let index=this.values.length-1;index>=0&&batch.newest.length<batch.limit;index--)batch.newest.push(this.values[index]);batch.newest.reverse(),this.sampleBatches.shift(),this.committingSamples=!0;try{this.withStreamedTableUpdate(()=>{this.values=batch.newest})}finally{this.committingSamples=!1}}this.sampleBatches.length&&(this.sampleTimer=setTimeout(()=>{this.sampleTimer=void 0,this.continueSampleBatch()},0))}normalizeEffectiveConfig(config){if(!config)return;if(this.normalizedConfig?.source===config)return this.normalizedConfig.value;const normalized={...config};return delete normalized.type,delete normalized.data,this.normalizedConfig={source:config,value:normalized},normalized}appendData(_label,values,maxPoints=0){this.appendSamples(values,maxPoints)}inputLimitMessage(){return this._distribution!=null?this.preparedSummary()??"":publicCollectionTruncation(this,"values")?this.localize("histogramInputLimit"):super.inputLimitMessage()}chartContentChanged(changed){return super.chartContentChanged(changed)||["values","bins","seriesLabel","distribution"].some(name=>changed.has(name))}}__decorate([property({converter:{fromAttribute:value=>normalizeHistogramBinCount(value)}})],LyraHistogram.prototype,"bins",void 0),__decorate([property({attribute:!1})],LyraHistogram.prototype,"values",void 0),__decorate([property({attribute:"series-label"})],LyraHistogram.prototype,"seriesLabel",void 0),__decorate([property({attribute:!1})],LyraHistogram.prototype,"distribution",null);const derivedCache=new WeakMap;function derivedSeries(el,label){const buckets=binnedBuckets(el);let cached=derivedCache.get(el);return(cached?.buckets!==buckets||cached.label!==label)&&(cached={buckets,label,labels:Object.freeze(buckets.map(b=>b.label.replace(/^\u2066|\u2069$/gu,""))),datasets:Object.freeze([projectChartSeries({label,data:Object.freeze(buckets.map(b=>b.count))})])},derivedCache.set(el,cached)),cached}Object.defineProperty(LyraHistogram.prototype,"labels",{configurable:!0,enumerable:!0,get(){return derivedSeries(this,this.seriesLabel||this.localize("histogramFrequency")).labels},set(_v){}}),Object.defineProperty(LyraHistogram.prototype,"datasets",{configurable:!0,enumerable:!0,get(){return derivedSeries(this,this.seriesLabel||this.localize("histogramFrequency")).datasets},set(_v){}}),lockChartType(LyraHistogram,"bar");export{LyraHistogram,binnedBuckets2 as binnedBuckets};

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

@@ -1,7 +1,11 @@
-import{LyraChart,type LyraChartType}from'./chart.class.js';
+export type{LyraChartPreparedData,LyraChartSourcePointSelectDetail,LyraChartSourceCategorySelectDetail,LyraPreparedSeriesData,LyraPreparedCategoryData,LyraSeriesPointRef}from'./chart.class.js';import{LyraChart,type LyraChartType}from'./chart.class.js';
 /**
 * `<lr-line-chart>` — `<lr-chart>` with a `"line"` default and the mirrored writable type.
 *
+* Prepared-data compatibility follows the current writable type: line accepts series, bar
+* accepts series/categories, radial category types accept categories. Spatial types require
+* their own source route and reject these prepared kinds.
+*
 * @customElement lr-line-chart
 * @status stable
 * @since 4.0.0

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

@@ -1,4 +1,4 @@
-import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import'../../utility/live-region/live-region.class.js';import{type LyraChartChromeLegendPosition}from'./chart-chrome.js';import type{LyraChartDatumActivateDetail,LyraChartFormatter}from'./chart.class.js';export interface LyraLiteChartSeries{readonly label:string;readonly data:readonly(number|null)[];
+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,LyraSeriesPointRef}from'../../../utilities/data-preparation.js';import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import'../../utility/live-region/live-region.class.js';import{type LyraChartChromeLegendPosition}from'./chart-chrome.js';import type{LyraChartDatumActivateDetail,LyraChartFormatter}from'./chart.class.js';export interface LyraLiteChartSeries{readonly label:string;readonly data:readonly(number|null)[];
 /** A CSS color. Invalid values and `url()` paint servers fall back to the semantic categorical
 *  color keyed by dataset index. */
 readonly color?:string;}export type LyraLiteChartType='bar'|'line';
@@ -17,7 +17,7 @@ export type LyraLiteChartLayout='fit'|'scroll';export type LyraLiteChartExportFo
 *  so `datasetIndex` and `seriesLabel` are `null` for `kind: 'total'`. */
 export interface LyraLiteChartTableCellContext{kind:LyraLiteChartTableCellKind;datasetIndex:number|null;index:number;label:string;seriesLabel:string|null;}
 /** Formats one finite numeric value in the built-in multi-series accessible table. */
-export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartTableCellContext)=>string;export interface LyraLiteChartEventMap{'lr-datum-activate':CustomEvent<LyraChartDatumActivateDetail<'bar'|'point',number|null>>;
+export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartTableCellContext)=>string;export interface LyraLiteChartEventMap{'lr-source-point-select':CustomEvent<LyraChartSourcePointSelectDetail>;'lr-source-category-select':CustomEvent<LyraChartSourceCategorySelectDetail>;'lr-datum-activate':CustomEvent<LyraChartDatumActivateDetail<'bar'|'point',number|null>>;
 /** A bar/point was activated by pointer or keyboard. */
 'lr-point-activate':CustomEvent<{datasetIndex:number;index:number;label:string|undefined;value:number|null;}>;}
 /**
@@ -87,7 +87,17 @@ export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartT
 * per mark (`pointText`), not a multi-item tooltip with separate regions for several datasets
 * sharing a hovered category.
 *
+* Prepared inputs replace legacy normalization with bounded whole-source summaries. Series use
+* original numeric x coordinates and original source indices, and reject stacking. Generated lists
+* and synchronous CSV/SVG export contain only the displayed summary/refinement. CSV keeps its
+* label/series columns and writes each independently indexed observation on its own row, with
+* original index and coordinates in the label. barX/barSlotWidth apply only to legacy/categories.
+*
 * @customElement lr-lite-chart
+* @event lr-source-point-select - A prepared observation was activated; detail contains revision,
+* seriesId, sourceIndex and point { x, y }.
+* @event lr-source-category-select - A prepared category was activated; detail contains revision,
+* seriesId, categoryId, value and observationCount.
 * @event lr-datum-activate - Fired when a bar/point is activated. The
 *   normalized detail includes `kind`, `datasetIndex`, `index`, `label`, and
 *   `value` across the chart family.
@@ -96,7 +106,7 @@ export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartT
 *   number, label: string | undefined, value: number | null }` — same shape
 *   as `lr-chart`'s `lr-point-activate`.
 * @csspart base - The host's flex layout wrapper.
-* @csspart description - The visually hidden accessible chart description, when set.
+* @csspart description - Accessible chart summary; also the visible prepared-input loading/error message.
 * @csspart grid-line - Each horizontal gridline.
 * @csspart axis-label - Each axis tick label.
 * @csspart axis-title - The x/y axis title text, when set.
@@ -128,8 +138,9 @@ export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartT
 *   `data-list` when there is more than one dataset so a screen-reader user hears series grouping
 *   rather than one flattened N×M sequence.
 * @csspart table - The generated semantic table inside the `data-table` container.
-* @csspart data-truncation - Explanation shown when built-in marks/data alternatives sample more
-*   than 1,000 records.
+* @csspart limit - Explanation shown when admission retains only part of the supplied input.
+* @csspart data-truncation - Explanation shown when built-in marks/data alternatives sample
+*   the retained input within the record and width budgets.
 * @slot data-table - An optional consumer-provided complete/paginated accessible data alternative.
 * @cssprop [--lr-chart-height=var(--lr-size-280px)] - Consumer-owned chart height. The `height`
 *   property supplies only a private fallback, so this public token always wins when set.
@@ -164,7 +175,31 @@ export type LyraLiteChartTableCellFormatter=(value:number,context:LyraLiteChartT
 * @status stable
 * @since 4.0.0
 */
-export declare class LyraLiteChart extends LyraElement<LyraLiteChartEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];type:LyraLiteChartType;labels:readonly string[];private _datasets;private datasetsSource;
+export declare class LyraLiteChart extends LyraElement<LyraLiteChartEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];type:LyraLiteChartType;private _preparedData;
+/**
+* Property-only immutable whole-source summary. Takes precedence over labels and datasets.
+* Series require line/bar; categories require bar.
+* All render 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.
+* Ordered series use original numeric x positions and reject stacked=true. barX and
+* barSlotWidth and category synchronization affect only legacy/category data. CSV exports one displayed observation per
+* row with source index and coordinates in its label; other series cells remain empty.
+* Reassign or explicitly requestUpdate after changing a host-authored descriptor/revision.
+*/
+get preparedData():LyraChartPreparedData|null;set preparedData(value:LyraChartPreparedData|null);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; no source index is inferred from an x coordinate.
+*/
+revealSourcePoint(ref:LyraSeriesPointRef):Promise<boolean>;private get displayDatasets();private get displayLabels();private datumLabel;private preparedX;private preparedDescription;labels:readonly string[];
+/** Maximum sampled records across all series, bounded to 2–1,000 (default 1,000).
+* Fit layouts also respect the measured width. Sampling retains endpoints and bucket extrema;
+* callbacks and events continue to use source indexes. */
+maxRecords:number;private _datasets;private datasetsTruncated;private readonly datasetsSources;
 /**
 * Series with an array `data` payload. Malformed entries are dropped without hiding siblings.
 * A bounded, clone-owned readonly snapshot: each series keeps its first 10,000 values (fewer
@@ -240,7 +275,7 @@ barWidth:number;
 *  derived slot; a non-finite, zero or negative value falls back to it too, and a finite value is
 *  capped so the whole category run stays within 1,000,000px. */
 barSlotWidth?:number;
-/** Caps how many x-axis category labels render text once `this.labels.length` exceeds it,
+/** Caps how many x-axis category labels render text once `this.displayLabels.length` exceeds it,
 *  decimating roughly evenly while always keeping the first and last label. `'auto'` derives a
 *  deterministic cap from the resolved plot width and widest rendered category label using the
 *  same width estimate as label ellipsis. Bars themselves always render regardless — only the
@@ -343,20 +378,25 @@ selectedIndices:readonly number[];private hostAccessibleLabel;
 /** Accessible chart name. A host `aria-label` wins. */
 label:string|null;
 /** Optional accessible chart description. */
-description:string|null;private forcedColorPatternId;private descriptionId;private plotWidth;private plotHeight;private fitMeasurementAvailable;private activeMarkIndex;private syncPlot;private syncCategoryPositions;private svgEl?;private liveRegion?;private resizeObserver?;private resizeObserverDocument?;private resizeObserverTarget?;private resizeObserverGeneration;private axisTitleTargets;private axisTitleFrame?;private axisTitleFits;private categoryLabelFits;private forcedColorsQuery?;private forcedColorsWindow?;private refocusMarkAfterUpdate;private refocusChartAfterUpdate;private readonly announcements;private lastDataTruncationAnnouncement;private isMounting;
+description:string|null;private forcedColorPatternId;private descriptionId;private plotWidth;private plotHeight;private fitMeasurementAvailable;private _activeMarkIndex;private get activeMarkIndex();private set activeMarkIndex(value);private syncPlot;private syncCategoryPositions;private svgEl?;private liveRegion?;private resizeObserver?;private resizeObserverDocument?;private resizeObserverTarget?;private resizeObserverGeneration;private axisTitleTargets;private axisTitleFrame?;private axisTitleFits;private readonly themeWatcher;private refocusMarkAfterUpdate;private refocusChartAfterUpdate;private readonly announcements;private lastDataTruncationAnnouncement;private isMounting;
 /**
 * Appends one streamed category to every series and keeps a rolling window of the newest
 * `maxPoints` categories. The window never exceeds the `datasets` bound (10,000 values per
 * series, fewer when more than four series share 45,000 values), which is also the default.
 * This is a controlled convenience method: it replaces `labels`/`datasets` with new arrays, so a
 * host can listen for the property update or continue treating the chart as a normal controlled
-* component. Missing series values become `null` rather than shifting alignment.
+* component. Work is O(retained window). Missing series values become `null` rather than shifting alignment.
+* Visually hidden multi-series table formatting coalesces until idle (at most 250 ms); visible
+* tables, single-series lists, keyboard summaries and exports always use current data.
+* Inactive while preparedData is supplied.
 */
 appendData(label:string,values:(number|null)[],maxPoints?:number):void;
 /**
 * Returns a spreadsheet-safe CSV snapshot over the complete canonical record domain: the
 * greatest of the label count and every series' data count. Missing labels and values become
-* empty aligned cells, so a longer or ragged series is never truncated or shifted.
+* empty aligned cells, so a longer or ragged series is never truncated or shifted. Prepared
+* ordered series export each displayed observation on a separate row, with original index
+* and coordinates in its label and empty cells for other series. No source read is started.
 */
 exportData(format:LyraLiteChartExportFormat):string;attributeChangedCallback(name:string,oldValue:string|null,value:string|null):void;
 /**
@@ -365,4 +405,4 @@ exportData(format:LyraLiteChartExportFormat):string;attributeChangedCallback(nam
 * Duplicate labels choose the first eligible recipient category; unique labels are recommended.
 * Peer updates are visual only and never move focus, announce, activate or select data.
 */
-syncGroup:string;private readonly chartSync;connectedCallback():void;private armResizeObserver;disconnectedCallback():void;adoptedCallback():void;private readonly onForcedColorsChange;private armForcedColorsWatcher;private disarmForcedColorsWatcher;private resetResizeObserver;protected firstUpdated(changed:PropertyValues):void;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private fitAxisTitles;private fitOneCategoryLabel;private fitCategoryLabels;private syncAxisTitleTargets;private queueAxisTitleFit;private colorFor;private get effectiveType();private forcedColors;private markPaint;private legendEncoding;private markDash;private renderForcedColorPatterns;private resolvePointText;private formatTableCell;private tableTotalAt;private recordCount;private recordSample;private recordSampleMemo?;private marksMemo?;private generatedDataIsSampled;private dataTruncationMessage;private hasCustomDataTable;private interactiveMarks;private awaitingFitMeasurement;private refreshFitMeasurementAvailability;private markIndexMap;private normalizedMarkIndex;private markSummary;private dataTableRows?;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private renderDataTableRows;private dataListMemo?;private dataListItems;private markAnnouncement;private markListItem;private onMarkFocus;private focusMark;private barValueToY;private valueFraction;private logDomainFloor;private smallestPositive?;private effectiveMinBarHeight;private roundedBarPath;private domain;private emitPoint;private emitNearestLinePoint;private publishSyncMark;private syncPresentation;private onPointKeyDown;private formatValueAxisTick;private renderGrid;private renderBars;private renderLines;render():TemplateResult;private resolvedValueAxisGutter;private widestEstimatedCategoryLabel;private visibleLabelIndexes;private fixedBarSlotWidth;private displayCategoryLabel;private renderChart;}declare global{interface HTMLElementTagNameMap{'lr-lite-chart':LyraLiteChart;}}
+syncGroup:string;private readonly chartSync;connectedCallback():void;private armResizeObserver;disconnectedCallback():void;adoptedCallback():void;private resetResizeObserver;protected firstUpdated(changed:PropertyValues):void;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private fitAxisTitles;private fitOneCategoryLabel;private fitCategoryBatch;private fitCategoryLabels;private syncAxisTitleTargets;private queueAxisTitleFit;private colorFor;private get effectiveType();private forcedColorsMemo?;private forcedColors;private markPaint;private legendEncoding;private markDash;private renderForcedColorPatterns;private resolvePointText;private formatTableCell;private tableTotalAt;private recordCount;private recordSample;private recordSampleMemo?;private marksMemo?;private generatedDataIsSampled;private inputLimitMessage;private dataTruncationMessage;private hasCustomDataTable;private interactiveMarks;private awaitingFitMeasurement;private refreshFitMeasurementAvailability;private markIndexMap;private normalizedMarkIndex;private markSummary;private dataTableRows?;private deferredTableRows?;private cancelDeferredTable?;private deferredTableGeneration;private streamingTableUpdate;private clearDeferredTable;private deferStreamedTable;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private renderDataTableRows;private dataListMemo?;private dataListItems;private markAnnouncement;private markListItem;private onMarkFocus;private focusMark;private barValueToY;private valueFraction;private logDomainFloor;private smallestPositive?;private effectiveMinBarHeight;private roundedBarPath;private domain;private emitPoint;private emitNearestLinePoint;private publishSyncMark;private syncPresentation;private onPointKeyDown;private formatValueAxisTick;private renderGrid;private renderBars;private renderLines;render():TemplateResult;private resolvedValueAxisGutter;private widestEstimatedCategoryLabel;private visibleLabelIndexes;private fixedBarSlotWidth;private displayCategoryLabel;private renderChart;}declare global{interface HTMLElementTagNameMap{'lr-lite-chart':LyraLiteChart;}}