@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/layout/virtual-list/virtual-list.class.js

@@ -1,33 +1,36 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing,render}from"lit";import{html as staticHtml,unsafeStatic}from"lit/static-html.js";import{property,state}from"lit/decorators.js";import{repeat}from"lit/directives/repeat.js";import{styleMap}from"lit/directives/style-map.js";import{LyraElement}from"../../../internal/lyra-element.js";import{literalSetConverter}from"../../../internal/converters.js";import{tag}from"../../../internal/prefix.js";import{VIRTUAL_LIST_ROW_ATTRIBUTE}from"./virtual-list-attributes.js";import{VIRTUAL_LIST_ROW_ATTRIBUTE as VIRTUAL_LIST_ROW_ATTRIBUTE2,VIRTUAL_LIST_STICKY_ATTRIBUTE}from"./virtual-list-attributes.js";import{MAX_OVERSCAN_ROWS}from"./virtual-list-limits.js";import{MAX_OVERSCAN_ROWS as MAX_OVERSCAN_ROWS2}from"./virtual-list-limits.js";import{prefersReducedMotion}from"../../../internal/motion.js";import{nativePopoverSupported}from"../../../internal/native-popover.js";import{finiteAdd,finiteCount,finiteInteger,finiteNumber}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{composedParentElement,deepActiveElementIn}from"../../../internal/active-element.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{styles}from"./virtual-list.styles.js";const DEFAULT_ROW_ESTIMATE_PX=48,DEFAULT_GROUP_ESTIMATE_PX=32,DEFAULT_OVERSCAN_ROWS=6,MAX_VIRTUAL_LIST_GROUPS=1e4,EMPTY_VIRTUAL_LIST_GROUPS=Object.freeze([]);function normalizeOverscan(value){if(value===null)return DEFAULT_OVERSCAN_ROWS;const numeric=typeof value=="number"?value:Number(value);return Number.isFinite(numeric)?Math.min(MAX_OVERSCAN_ROWS,Math.max(0,Math.floor(numeric))):DEFAULT_OVERSCAN_ROWS}const overscanConverter={fromAttribute(value){return normalizeOverscan(value)}};function virtualListGroupsChanged(value,oldValue){if(value===oldValue)return!1;const next=value,previous=oldValue;if(next==null||previous==null)return next!==previous;if(next.length!==previous.length)return!0;for(let index=0;index<next.length;index+=1){const a=next[index],b=previous[index];if(a.key!==b.key||a.label!==b.label||a.startIndex!==b.startIndex)return!0}return!1}const ROW_PROJECTION=literalSetConverter(["shadow","light"],"shadow"),ROW_ATTRIBUTE_STATIC=unsafeStatic(VIRTUAL_LIST_ROW_ATTRIBUTE),PROJECTION_ANCHOR_MARKER=`${tag("virtual-list")}-projection`;function normalizeRowHeight(value){if(value==="auto")return"auto";const numeric=typeof value=="number"?value:Number(value);return Number.isFinite(numeric)&&numeric>0?numeric:"auto"}const rowHeightConverter={fromAttribute(value){return value===null?"auto":normalizeRowHeight(value)}};function isIndexedSource(source){return!Array.isArray(source)}function sameSequence(a,b){return Array.isArray(a)&&Array.isArray(b)&&a.length===b.length&&a.every((item,index)=>item===b[index])}const ELEMENT_NODE_TYPE=1;function isWindowScroller(target){return target.window===target}function domKeyToken(key){if(typeof key=="number"){if(Number.isNaN(key))return"number:NaN";if(Object.is(key,-0))return"number:-0"}return`${typeof key}:${String(key)}`}const SCROLL_KEYS=new Set(["ArrowUp","ArrowDown","PageUp","PageDown","Home","End"," "]);class LyraVirtualList extends LyraElement{constructor(){super(...arguments),this.items=[],this.renderItem=()=>nothing,this.rowHeight="auto",this.itemRole="listitem",this._rowProjection="shadow",this.rowIndexOffset=0,this.overscan=DEFAULT_OVERSCAN_ROWS,this.activeItemId="",this.loading=!1,this.hasMore=!1,this.partCache=new Map,this.containerScrollTop=0,this.viewportHeight=0,this.renderUnmeasuredWindow=!0,this.offsets=[0],this.rowIdentities=[],this.fixedRowHeight=null,this.measuredHeights=new Map,this.measuredIndices=new Map,this.indexedMeasurementIndices=[],this.indexedMeasurementDeltaPrefix=[0],this.indexedMeasurementIndexDirty=!0,this.offsetsDirty=!0,this.identitiesDirty=!0,this.itemsChangedPendingPrune=!1,this.renderStart=0,this.renderEnd=-1,this.pinnedRow=-1,this.renderedWindow=[],this.projectionDeferred=!0,this.releaseRowProjection=()=>{this.projectionDeferred=!1,this.requestUpdate()},this.visibleStart=0,this.visibleEnd=-1,this.lastEmittedStart=-1,this.lastEmittedEnd=-1,this.loadMoreArmed=!0,this.measurementGeneration=0,this.isFirstUpdate=!0,this.stickyHeight=0,this.noTopLayer=!1,this.observedRows=new Map,this.observedRowKeys=new WeakMap,this.observedRowIndices=new WeakMap,this.observedGroups=new Map,this.observedGroupIndices=new WeakMap,this.externalMetricsPending=!1,this.ownerRealmGeneration=0,this.inResizeDelivery=!1,this.pendingRowMeasurements=new Map,this.pendingGroupMeasurements=new Map,this.deferredRowObservations=new Map,this.deferredGroupObservations=new Map,this.activeIndexForLength=-1,this.activeIndexForId="",this.activeIndexCache=-1,this.pendingScrollTop=null,this.normalizedGroups=EMPTY_VIRTUAL_LIST_GROUPS,this.normalizedGroupByIndex=new Map,this.measuredGroupHeights=new Map,this.groupHeightPrefix=[0],this.onExternalViewportResize=()=>{this.syncExternalScrollMetrics()},this.onUserScrollIntent=event=>{event instanceof KeyboardEvent&&!SCROLL_KEYS.has(event.key)||(this.pendingScrollCorrection=void 0)},this.onScroll=e=>{if(this.externalScroller?(this.pendingScrollTop=null,this.externalMetricsPending=!0):this.pendingScrollTop=e.currentTarget.scrollTop,this.scrollRafId!==void 0)return;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected)return;const generation=this.ownerRealmGeneration,handle=ownerWindow.requestAnimationFrame(()=>{if(!(this.scrollRafId!==handle||this.scrollRafOwner!==ownerWindow||this.scrollRafDocument!==ownerDocument||!this.isCurrentOwnerWork(ownerDocument,generation))){if(this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,this.externalMetricsPending){this.externalMetricsPending=!1;const metrics=this.readScrollMetrics();metrics&&(this.pendingScrollTop=metrics.scrollTop,this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight))}if(this.pendingScrollTop!==null){const scrollTop=this.pendingScrollTop;this.pendingScrollTop=null;const moved=this.containerScrollTop!==scrollTop;this.containerScrollTop=scrollTop,moved&&this.emit("lr-virtual-scroll",{scrollTop,viewportHeight:this.viewportHeight})}}});this.scrollRafId=handle,this.scrollRafOwner=ownerWindow,this.scrollRafDocument=ownerDocument},this.onRowsResized=entries=>{if(this.beginResizeDelivery(),this.fixedRowHeight==null){for(const entry of entries){const row=entry.target,key=this.observedRowKeys.get(row),index=this.observedRowIndices.get(row);if(key===void 0||index===void 0)continue;const height=entry.borderBoxSize?.[0]?.blockSize??entry.target.getBoundingClientRect().height;this.pendingRowMeasurements.set(key,{index,height})}this.defersMeasurementApplication||this.applyPendingRowMeasurements()}},this.onGroupsResized=entries=>{this.beginResizeDelivery();for(const entry of entries){const marker=entry.target,index=this.observedGroupIndices.get(marker);if(index===void 0||!this.normalizedGroupByIndex.has(index))continue;const height=entry.borderBoxSize?.[0]?.blockSize??entry.target.getBoundingClientRect().height;!Number.isFinite(height)||height<0||this.pendingGroupMeasurements.set(index,height)}this.defersMeasurementApplication||this.applyPendingGroupMeasurements()},this.onFocusOut=event=>{const next=event.relatedTarget;this.pinnedRow>=0&&!(next&&(this.contains(next)||this.renderRoot.contains(next)))&&this.requestUpdate()},this.onStickyResized=entries=>{this.beginResizeDelivery();const entry=entries[0];if(!entry)return;const height=entry.borderBoxSize?.[0]?.blockSize??entry.contentRect.height;Math.abs(this.stickyHeight-height)>.5&&(this.stickyHeight=height)}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["items","source","groups"])}static{this.identityCollectionProperties=Object.freeze(["items","source"])}static{this.identityCollectionObjectProperties=Object.freeze(["source"])}static{this.styles=[LyraElement.styles,styles]}get rowProjection(){return this._rowProjection}set rowProjection(next){const normalized=ROW_PROJECTION.normalize(next),previous=this._rowProjection;previous!==normalized&&(this._rowProjection=normalized,this.requestUpdate("rowProjection",previous))}get scrollContainer(){return this.cachedPart("base")}cachedPart(name){let element=this.partCache.get(name);return element?.isConnected||(element=this.renderRoot?.querySelector(`[part="${name}"]`)??void 0,element?this.partCache.set(name,element):this.partCache.delete(name)),element}get renderedRows(){const root=this.renderRoot;return root?[...root.querySelectorAll('[part="row"]')]:[]}get projectedRows(){const rows=[];for(const child of this.children)child.hasAttribute(VIRTUAL_LIST_ROW_ATTRIBUTE)&&rows.push(child);return rows}get externalScroller(){const target=this.scrollElement;if(target!=null)return isWindowScroller(target)||target.nodeType===ELEMENT_NODE_TYPE?target:void 0}get spacerElement(){return this.cachedPart("spacer")}readScrollMetrics(){const base=this.scrollContainer;if(!base)return null;const external=this.externalScroller;if(!external)return{scrollTop:base.scrollTop,rawScrollTop:base.scrollTop,viewportHeight:base.clientHeight,scrollDeltaScale:1};const spacer=this.spacerElement??base,spacerRect=spacer.getBoundingClientRect(),spacerScale=this.visualBlockScale(spacer,spacerRect),spacerTop=spacerRect.top;if(isWindowScroller(external)){const documentHeight=finiteNumber(external.document?.documentElement?.clientHeight??0,0),rawScrollTop2=finiteNumber(-spacerTop/spacerScale,0);return{scrollTop:Math.max(0,rawScrollTop2),rawScrollTop:rawScrollTop2,viewportHeight:(documentHeight>0?documentHeight:finiteNumber(external.innerHeight,0))/spacerScale,scrollDeltaScale:spacerScale}}const scrollerRect=external.getBoundingClientRect(),relativeScale=this.relativeBlockScale(spacer,external),inferredScrollerScale=relativeScale===null?0:spacerScale/relativeScale,scrollerScale=Number.isFinite(inferredScrollerScale)&&inferredScrollerScale>0?inferredScrollerScale:this.visualBlockScale(external,scrollerRect),scrollerStyle=external.ownerDocument.defaultView?.getComputedStyle(external),borderTop=Number.parseFloat(scrollerStyle?.borderTopWidth??""),scrollerTop=scrollerRect.top+(Number.isFinite(borderTop)?borderTop:external.clientTop)*scrollerScale,rawScrollTop=finiteNumber((scrollerTop-spacerTop)/spacerScale,0);return{scrollTop:Math.max(0,rawScrollTop),rawScrollTop,viewportHeight:finiteNumber(external.clientHeight*scrollerScale/spacerScale,0),scrollDeltaScale:spacerScale/scrollerScale}}visualBlockScale(element,rect){const style=element.ownerDocument.defaultView?.getComputedStyle(element);if(!style)return 1;const borderBoxHeight=Number.parseFloat(style.height)+(style.boxSizing==="border-box"?0:Number.parseFloat(style.paddingTop)+Number.parseFloat(style.paddingBottom)+Number.parseFloat(style.borderTopWidth)+Number.parseFloat(style.borderBottomWidth)),layoutHeight=borderBoxHeight>0&&Number.isFinite(borderBoxHeight)?borderBoxHeight:"offsetHeight"in element&&typeof element.offsetHeight=="number"?element.offsetHeight:0,scale=rect.height/layoutHeight;return scale>0&&Number.isFinite(scale)?scale:1}relativeBlockScale(descendant,ancestor){let scale=1,current=descendant;for(;current&&current!==ancestor;){const style=current.ownerDocument.defaultView?.getComputedStyle(current);if(!style)return null;const zoom=style.zoom?style.zoom.endsWith("%")?Number.parseFloat(style.zoom)/100:Number.parseFloat(style.zoom):1;if(!Number.isFinite(zoom)||zoom<=0)return null;scale*=zoom;const transformable=style.display!=="contents"&&style.display!=="inline";if(transformable&&style.scale&&style.scale!=="none"){const values=style.scale.split(/\s+/).map(Number),blockScale=values[1]??values[0]??Number.NaN;if(!Number.isFinite(blockScale)||blockScale<=0)return null;scale*=blockScale}if(transformable&&style.rotate&&style.rotate!=="none"&&style.rotate!=="0deg")return null;if(transformable&&style.transform!=="none"){const Matrix=current.ownerDocument.defaultView?.DOMMatrixReadOnly;if(!Matrix)return null;const matrix=new Matrix(style.transform);if(matrix.m12!==0||matrix.m13!==0||matrix.m14!==0||matrix.m21!==0||matrix.m23!==0||matrix.m24!==0||matrix.m31!==0||matrix.m32!==0||matrix.m34!==0||matrix.m44!==1||matrix.m22<=0)return null;scale*=matrix.m22}const parent=current.assignedSlot??current.parentNode;current=parent?.nodeType===Node.ELEMENT_NODE?parent:parent?.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&"host"in parent?parent.host:null}return current===ancestor&&Number.isFinite(scale)&&scale>0?scale:null}applyScrollPosition(top,behavior){const external=this.externalScroller;if(!external){const base=this.scrollContainer;if(!base)return;const next2=Math.max(0,finiteNumber(top,0));behavior===void 0?base.scrollTop=next2:base.scrollTo({top:next2,behavior});return}const metrics=this.readScrollMetrics();if(!metrics)return;const delta=(finiteNumber(top,metrics.rawScrollTop)-metrics.rawScrollTop)*metrics.scrollDeltaScale;if(isWindowScroller(external)){const options={top:Math.max(0,finiteNumber(external.scrollY+delta,0))};behavior!==void 0&&(options.behavior=behavior),external.scrollTo(options);return}const next=Math.max(0,finiteNumber(external.scrollTop+delta,0));behavior===void 0?external.scrollTop=next:external.scrollTo({top:next,behavior})}syncExternalScrollMetrics(){const metrics=this.readScrollMetrics();metrics&&(this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight),this.containerScrollTop!==metrics.scrollTop&&(this.containerScrollTop=metrics.scrollTop))}get safeRowIndexOffset(){return finiteCount(this.rowIndexOffset)}computedAriaRowIndex(index){return finiteInteger(finiteAdd(index+1,this.safeRowIndexOffset),1,1,Number.MAX_SAFE_INTEGER)}get activeIndex(){if(this.activeItemId==="")return-1;const source=this.effectiveSource,count=this.itemCount;if(this.activeIndexFor===source&&this.activeIndexForLength===count&&Object.is(this.activeIndexForId,this.activeItemId)&&this.activeIndexForKeyFn===this.keyFunction)return this.activeIndexCache;if(this.activeIndexFor=source,this.activeIndexForLength=count,this.activeIndexForId=this.activeItemId,this.activeIndexForKeyFn=this.keyFunction,this.activeIndexCache=-1,isIndexedSource(source)){if(!this.keyFunction&&source.indexOfKey){const candidate=source.indexOfKey(this.activeItemId);Number.isInteger(candidate)&&candidate>=0&&candidate<count&&(this.activeIndexCache=candidate)}return this.activeIndexCache}for(let index=0;index<count;index++){const item=this.itemAt(index);if(Object.is(this.keyOf(item,index),this.activeItemId)){this.activeIndexCache=index;break}}return this.activeIndexCache}connectedCallback(){super.connectedCallback(),this.ownerDocument.defaultView&&(this.seedFirstRenderState(()=>{this.renderUnmeasuredWindow=!1,this.requestUpdate()}),this.seedFirstRenderState(this.releaseRowProjection),this.hasUpdated&&(this.projectionDeferred=!1)),this.resetOwnerRealmWork();const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView,generation=this.ownerRealmGeneration,ResizeObserverCtor=ownerWindow?.ResizeObserver;if(ResizeObserverCtor){const rowObserver=new ResizeObserverCtor(entries=>{this.rowResizeObserver!==rowObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onRowsResized(entries)}),groupObserver=new ResizeObserverCtor(entries=>{this.groupResizeObserver!==groupObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onGroupsResized(entries)}),stickyObserver=new ResizeObserverCtor(entries=>{this.stickyResizeObserver!==stickyObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onStickyResized(entries)});this.rowResizeObserver=rowObserver,this.groupResizeObserver=groupObserver,this.stickyResizeObserver=stickyObserver}this.hasUpdated&&(this.syncRowProjection(),this.attachContainerListeners(),this.syncRowObservers(),this.syncGroupObservers(),this.syncStickyOverlay())}disconnectedCallback(){this.teardownRowProjection(),this.resetOwnerRealmWork(),super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.teardownRowProjection(),this.resetOwnerRealmWork()}isCurrentOwnerWork(ownerDocument,generation){return this.ownerRealmGeneration===generation&&this.isConnected&&this.ownerDocument===ownerDocument}resetOwnerRealmWork(){this.ownerRealmGeneration+=1,this.rowResizeObserver?.disconnect(),this.rowResizeObserver=void 0,this.groupResizeObserver?.disconnect(),this.groupResizeObserver=void 0,this.observedRows.clear(),this.observedGroups.clear(),this.deferredRowObservations.clear(),this.deferredGroupObservations.clear(),this.inResizeDelivery=!1,this.pendingRowMeasurements.clear(),this.pendingGroupMeasurements.clear(),this.rowObserveRafId!==void 0&&this.rowObserveRafOwner?.cancelAnimationFrame(this.rowObserveRafId),this.rowObserveRafId=void 0,this.rowObserveRafOwner=void 0,this.rowObserveRafDocument=void 0,this.containerResizeObserver?.disconnect(),this.containerResizeObserver=void 0,this.stickyResizeObserver?.disconnect(),this.stickyResizeObserver=void 0,this.observedSticky=void 0,this.scrollRafId!==void 0&&this.scrollRafOwner?.cancelAnimationFrame(this.scrollRafId),this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,this.pendingScrollTop=null,this.externalMetricsPending=!1,this.pendingScrollCorrection=void 0,this.detachContainerListeners(),this.scrollListenerTarget=void 0}firstUpdated(changed){super.firstUpdated(changed),this.attachContainerListeners(),queueMicrotask(()=>{this.isConnected&&(this.noTopLayer=!nativePopoverSupported())})}willUpdate(changed){super.willUpdate(changed),this.projectionDeferred&&!this.hasUpdated&&this.ownerDocument?.defaultView&&this.seedFirstRenderState(this.releaseRowProjection),this.isFirstUpdate=!this.hasUpdated,this.hasUpdated&&(this.noTopLayer=!nativePopoverSupported());const sequence=changed.has("items")&&!sameSequence(changed.get("items"),this.items)||changed.has("source")&&!sameSequence(changed.get("source"),this.source);if(sequence||changed.has("keyFunction")||changed.has("rowHeight")||changed.has("groups")||changed.has("activeItemId")||changed.has("scrollElement")?this.pendingScrollCorrection=void 0:this.pendingScrollCorrection&&(this.pendingScrollCorrection.source=this.effectiveSource),(sequence||changed.has("keyFunction"))&&(this.identitiesDirty=!0),(sequence||changed.has("rowHeight")||changed.has("keyFunction")||changed.has("groups"))&&(this.offsetsDirty=!0),sequence&&(this.itemsChangedPendingPrune=!0),changed.has("keyFunction")||isIndexedSource(this.effectiveSource)&&sequence){this.measuredHeights.clear(),this.measuredIndices.clear(),this.pendingRowMeasurements.clear(),this.indexedMeasurementIndexDirty=!0;for(const row of this.observedRows.values())this.rowResizeObserver?.unobserve(row);this.observedRows.clear(),this.deferredRowObservations.clear()}if(changed.has("groups")){this.measuredGroupHeights.clear(),this.pendingGroupMeasurements.clear();for(const marker of this.observedGroups.values())this.groupResizeObserver?.unobserve(marker);this.observedGroups.clear(),this.deferredGroupObservations.clear()}(sequence||changed.has("groups"))&&this.recomputeGroups(),changed.has("rowHeight")&&(this.fixedRowHeight=this.parseRowHeight(this.rowHeight),this.fixedRowHeight!=null&&(this.measuredHeights.clear(),this.measuredIndices.clear(),this.pendingRowMeasurements.clear(),this.indexedMeasurementIndexDirty=!0)),this.offsetsDirty&&(this.recomputeOffsets(),this.offsetsDirty=!1),this.computeRange()}updated(changed){super.updated(changed),this.syncRowProjection(),this.syncRowObservers(),this.syncGroupObservers(),this.syncStickyOverlay(),changed.has("scrollElement")&&!this.isFirstUpdate&&this.attachContainerListeners(),changed.has("activeItemId")&&!this.isFirstUpdate&&this.scrollActiveIntoView(),this.emitRangeChangeIfNeeded(),this.maybeFireLoadMore(),this.maybeCorrectPendingScroll()}parseRowHeight(value){const normalized=normalizeRowHeight(value);return normalized==="auto"?null:normalized}get effectiveSource(){return this.source??this.items}get itemCount(){const source=this.effectiveSource;return isIndexedSource(source)?finiteCount(source.count):source.length}itemAt(index){const source=this.effectiveSource;return isIndexedSource(source)?source.itemAt(index):source[index]}keyOf(item,index){const source=this.effectiveSource,key=this.keyFunction?this.keyFunction(item,index):isIndexedSource(source)?source.keyAt?.(index)??index:index;return typeof key=="string"||typeof key=="number"?key:index}rowIdentity(key,occurrence){const token=domKeyToken(key);return`${token.length}:${token}:${occurrence}`}identityAt(index,item=this.itemAt(index)){return isIndexedSource(this.effectiveSource)?this.rowIdentity(this.keyOf(item,index),index):this.rowIdentities[index]??this.rowIdentity(this.keyOf(item,index),index)}groupHeightAt(index){const group=this.normalizedGroupByIndex.get(index);return!group||group.label===""?0:this.measuredGroupHeights.get(index)??DEFAULT_GROUP_ESTIMATE_PX}rowHeightAt(index){return this.fixedRowHeight!=null?this.fixedRowHeight:this.measuredHeights.get(this.identityAt(index))??DEFAULT_ROW_ESTIMATE_PX}groupContributionThrough(index){return this.groupHeightPrefix[this.groupCountThrough(index)]??0}groupCountThrough(index){let low=0,high=this.normalizedGroups.length;for(;low<high;){const middle=low+high>>1;this.normalizedGroups[middle].startIndex<=index?low=middle+1:high=middle}return low}recomputeGroupHeightPrefix(){const prefix=new Array(this.normalizedGroups.length+1);prefix[0]=0;for(let index=0;index<this.normalizedGroups.length;index++){const group=this.normalizedGroups[index],height=group.label===""?0:this.measuredGroupHeights.get(group.startIndex)??DEFAULT_GROUP_ESTIMATE_PX;prefix[index+1]=finiteAdd(prefix[index],height)}this.groupHeightPrefix=prefix}indexedOffsetForIndex(index){const baseHeight=this.fixedRowHeight??DEFAULT_ROW_ESTIMATE_PX;let offset=index>Number.MAX_VALUE/baseHeight?Number.MAX_VALUE:index*baseHeight;if(this.fixedRowHeight==null){this.rebuildIndexedMeasurementIndex();let low=0,high=this.indexedMeasurementIndices.length;for(;low<high;){const middle=low+high>>1;this.indexedMeasurementIndices[middle]<index?low=middle+1:high=middle}offset=finiteAdd(offset,this.indexedMeasurementDeltaPrefix[low]??0)}return Math.max(0,finiteAdd(offset,this.groupContributionThrough(index)))}rebuildIndexedMeasurementIndex(){if(!this.indexedMeasurementIndexDirty)return;const retained=[];for(const[identity,index]of this.measuredIndices){const height=this.measuredHeights.get(identity);height!==void 0&&retained.push({index,delta:height-DEFAULT_ROW_ESTIMATE_PX})}retained.sort((a,b)=>a.index-b.index);const indices=new Array(retained.length),prefix=new Array(retained.length+1);prefix[0]=0;for(let position=0;position<retained.length;position++){const measurement=retained[position];indices[position]=measurement.index,prefix[position+1]=finiteAdd(prefix[position],measurement.delta)}this.indexedMeasurementIndices=indices,this.indexedMeasurementDeltaPrefix=prefix,this.indexedMeasurementIndexDirty=!1}pruneIndexedMeasurements(){if(!isIndexedSource(this.effectiveSource)||this.fixedRowHeight!=null||this.renderEnd<this.renderStart)return!1;const renderedCount=this.renderEnd-this.renderStart+1,retentionRows=Math.max(renderedCount,normalizeOverscan(this.overscan)*4),firstRetained=Math.max(0,this.renderStart-retentionRows),lastRetained=Math.min(this.itemCount-1,this.renderEnd+retentionRows);let removedDeltaBeforeWindow=0,pruned=!1;for(const[identity,measuredIndex]of this.measuredIndices)if(measuredIndex<firstRetained||measuredIndex>lastRetained){const height=this.measuredHeights.get(identity);height!==void 0&&measuredIndex<firstRetained&&(removedDeltaBeforeWindow=finiteAdd(removedDeltaBeforeWindow,height-DEFAULT_ROW_ESTIMATE_PX)),this.measuredIndices.delete(identity),this.measuredHeights.delete(identity),pruned=!0}if(pruned&&(this.indexedMeasurementIndexDirty=!0,removedDeltaBeforeWindow!==0)){const nextScrollTop=(this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop)-removedDeltaBeforeWindow;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}return pruned}offsetAt(index){return isIndexedSource(this.effectiveSource)?this.indexedOffsetForIndex(index):this.offsets[index]??0}recomputeOffsets(){const n=this.itemCount;if(this.recomputeGroupHeightPrefix(),isIndexedSource(this.effectiveSource)){this.offsets=[0],this.rowIdentities=[],this.itemsChangedPendingPrune=!1;return}const offsets=new Array(n+1);let cursor=0;const liveKeys=this.itemsChangedPendingPrune&&this.fixedRowHeight==null?new Set:null,occurrences=new Map,reuse=!this.identitiesDirty&&this.rowIdentities.length===n,identities=reuse?this.rowIdentities:new Array(n);for(let i=0;i<n;i++){if(cursor=finiteAdd(cursor,this.groupHeightAt(i)),offsets[i]=cursor,!reuse){const key=this.keyOf(this.itemAt(i),i),token=domKeyToken(key),occurrence=occurrences.get(token)??0;occurrences.set(token,occurrence+1),identities[i]=this.rowIdentity(key,occurrence)}const identity=identities[i];let h;this.fixedRowHeight!=null?h=this.fixedRowHeight:(liveKeys?.add(identity),h=this.measuredHeights.get(identity)??DEFAULT_ROW_ESTIMATE_PX),cursor=finiteAdd(cursor,h)}if(offsets[n]=cursor,this.offsets=offsets,this.rowIdentities=identities,this.identitiesDirty=!1,this.itemsChangedPendingPrune=!1,liveKeys){for(const key of this.measuredHeights.keys())liveKeys.has(key)||(this.measuredHeights.delete(key),this.measuredIndices.delete(key),this.indexedMeasurementIndexDirty=!0);for(const key of this.measuredIndices.keys())liveKeys.has(key)||(this.measuredIndices.delete(key),this.indexedMeasurementIndexDirty=!0)}}groupTopAt(index){return Math.max(0,this.offsetAt(index)-this.groupHeightAt(index))}rowBottomAt(index){return finiteAdd(this.offsetAt(index),this.rowHeightAt(index))}entryTopAt(index){return this.groupTopAt(index)}findIndexAtOrAfter(offset){let lo=0,hi=this.itemCount-1;for(;lo<hi;){const mid=lo+Math.floor((hi-lo)/2);this.rowBottomAt(mid)<=offset?lo=mid+1:hi=mid}return lo}findIndexAtOrBefore(offset){let lo=0,hi=this.itemCount-1;for(;lo<hi;){const mid=lo+Math.ceil((hi-lo)/2);this.entryTopAt(mid)<offset?lo=mid:hi=mid-1}return lo}offsetForIndex(index){const clamped=Math.min(this.itemCount,Math.max(0,Math.trunc(index)||0));return this.offsetAt(clamped)}indexAtOffset(px){const n=this.itemCount;return n===0?-1:Number.isFinite(px)?Math.min(n-1,Math.max(0,this.findIndexAtOrAfter(px))):px>0?n-1:0}computeRange(){const n=this.itemCount;if(n===0){this.visibleStart=0,this.visibleEnd=-1,this.renderStart=0,this.renderEnd=-1;return}if(this.viewportHeight<=0){if(!this.renderUnmeasuredWindow){this.visibleStart=0,this.visibleEnd=-1,this.renderStart=0,this.renderEnd=-1;return}this.visibleStart=0,this.visibleEnd=0,this.renderStart=0,this.renderEnd=Math.min(n-1,normalizeOverscan(this.overscan));return}const viewTop=this.containerScrollTop,viewBottom=viewTop+this.viewportHeight;this.visibleStart=this.findIndexAtOrAfter(viewTop),this.visibleEnd=this.findIndexAtOrBefore(viewBottom);const overscan=normalizeOverscan(this.overscan);this.renderStart=Math.max(0,this.visibleStart-overscan),this.renderEnd=Math.min(n-1,this.visibleEnd+overscan),this.pruneIndexedMeasurements()&&this.computeRange()}attachContainerListeners(){const base=this.scrollContainer,ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!base||!this.isConnected||!ownerWindow)return;this.containerResizeObserver?.disconnect(),this.containerResizeObserver=void 0,this.detachContainerListeners();const external=this.externalScroller,scrollTarget=external??base,generation=this.ownerRealmGeneration,ResizeObserverCtor=ownerWindow.ResizeObserver;if(ResizeObserverCtor){const observer=new ResizeObserverCtor(entries=>{if(this.containerResizeObserver!==observer||this.scrollListenerTarget!==scrollTarget||!this.isCurrentOwnerWork(ownerDocument,generation))return;if(this.beginResizeDelivery(),external){this.syncExternalScrollMetrics();return}const entry=entries[0];entry&&(this.viewportHeight=entry.borderBoxSize?.[0]?.blockSize??entry.contentRect.height)});this.containerResizeObserver=observer,observer.observe(base),external&&!isWindowScroller(external)&&observer.observe(external)}scrollTarget.addEventListener("scroll",this.onScroll,{passive:!0}),scrollTarget.addEventListener("wheel",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("pointerdown",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("touchstart",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("keydown",this.onUserScrollIntent),this.scrollListenerTarget=scrollTarget,external&&isWindowScroller(external)&&(external.addEventListener("resize",this.onExternalViewportResize,{passive:!0}),this.viewportResizeTarget=external),ownerWindow.queueMicrotask(()=>{if(this.scrollListenerTarget!==scrollTarget||this.scrollContainer!==base||!this.isCurrentOwnerWork(ownerDocument,generation))return;const metrics=this.readScrollMetrics();metrics&&(this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight),this.containerScrollTop!==metrics.scrollTop&&(this.containerScrollTop=metrics.scrollTop))})}detachContainerListeners(){const viewportTarget=this.viewportResizeTarget;viewportTarget&&(viewportTarget.removeEventListener("resize",this.onExternalViewportResize),this.viewportResizeTarget=void 0);const target=this.scrollListenerTarget;target&&(target.removeEventListener("scroll",this.onScroll),target.removeEventListener("wheel",this.onUserScrollIntent),target.removeEventListener("pointerdown",this.onUserScrollIntent),target.removeEventListener("touchstart",this.onUserScrollIntent),target.removeEventListener("keydown",this.onUserScrollIntent))}applyPendingRowMeasurements(){if(this.pendingRowMeasurements.size===0)return;const observations=[...this.pendingRowMeasurements];if(this.pendingRowMeasurements.clear(),this.fixedRowHeight!=null)return;const base=this.scrollContainer,oldScrollTop=this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop;let scrollAdjustment=0,changed=!1;for(const[key,{index,height}]of observations){const prev=this.measuredHeights.get(key);if(prev===void 0||Math.abs(prev-height)>.5){const oldBottom=this.rowBottomAt(index);this.measuredHeights.set(key,height),this.measuredIndices.set(key,index);const oldHeight=prev??DEFAULT_ROW_ESTIMATE_PX;oldBottom<=oldScrollTop&&(scrollAdjustment+=height-oldHeight),changed=!0}}if(changed){if(this.indexedMeasurementIndexDirty=!0,base&&scrollAdjustment!==0){const nextScrollTop=oldScrollTop+scrollAdjustment;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}this.offsetsDirty=!0,this.measurementGeneration+=1,this.requestUpdate()}}applyPendingGroupMeasurements(){if(this.pendingGroupMeasurements.size===0)return;const observations=[...this.pendingGroupMeasurements];this.pendingGroupMeasurements.clear();const base=this.scrollContainer,oldScrollTop=this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop;let scrollAdjustment=0,changed=!1;for(const[index,height]of observations){if(!this.normalizedGroupByIndex.has(index))continue;const previous=this.measuredGroupHeights.get(index)??DEFAULT_GROUP_ESTIMATE_PX;if(Math.abs(previous-height)<=.5)continue;const oldRowTop=this.offsetAt(index);this.measuredGroupHeights.set(index,height),oldRowTop<=oldScrollTop&&(scrollAdjustment+=height-previous),changed=!0}if(changed){if(base&&scrollAdjustment!==0){const nextScrollTop=oldScrollTop+scrollAdjustment;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}this.offsetsDirty=!0,this.measurementGeneration+=1,this.requestUpdate()}}get defersMeasurementApplication(){return this.inResizeDelivery&&this.externalScroller!==void 0}beginResizeDelivery(){if(this.inResizeDelivery=!0,this.rowObserveRafId!==void 0)return;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected){this.inResizeDelivery=!1;return}const generation=this.ownerRealmGeneration,handle=ownerWindow.requestAnimationFrame(()=>{if(this.rowObserveRafId!==handle||this.rowObserveRafOwner!==ownerWindow||this.rowObserveRafDocument!==ownerDocument||!this.isCurrentOwnerWork(ownerDocument,generation))return;this.rowObserveRafId=void 0,this.rowObserveRafOwner=void 0,this.rowObserveRafDocument=void 0,this.inResizeDelivery=!1;const ro=this.rowResizeObserver;for(const[identity,el]of this.deferredRowObservations)ro&&this.observedRows.get(identity)===el&&ro.observe(el);this.deferredRowObservations.clear();const groupObserver=this.groupResizeObserver;for(const[index,el]of this.deferredGroupObservations)groupObserver&&this.observedGroups.get(index)===el&&groupObserver.observe(el);this.deferredGroupObservations.clear(),this.applyPendingRowMeasurements(),this.applyPendingGroupMeasurements()});this.rowObserveRafId=handle,this.rowObserveRafOwner=ownerWindow,this.rowObserveRafDocument=ownerDocument}syncRowObservers(){const ro=this.rowResizeObserver;if(!ro)return;if(this.fixedRowHeight!=null){for(const el of this.observedRows.values())ro.unobserve(el);this.observedRows.clear(),this.deferredRowObservations.clear();return}const current=new Map;this.renderRoot.querySelectorAll('[part="row"]').forEach(el=>{const index=Number(el.getAttribute("data-row-index"));if(!Number.isInteger(index)||index<0||index>=this.itemCount)return;const identity=this.identityAt(index);current.set(identity,el),this.observedRowKeys.set(el,identity),this.observedRowIndices.set(el,index)});for(const[identity,el]of this.observedRows)current.get(identity)!==el&&(ro.unobserve(el),this.observedRows.delete(identity),this.deferredRowObservations.delete(identity));for(const[identity,el]of current)this.observedRows.has(identity)||(this.observedRows.set(identity,el),this.inResizeDelivery?this.deferredRowObservations.set(identity,el):ro.observe(el))}syncGroupObservers(){const observer=this.groupResizeObserver;if(!observer)return;const current=new Map;this.renderRoot.querySelectorAll('[part="group"][data-group-index]').forEach(marker=>{const index=Number(marker.dataset.groupIndex);!Number.isInteger(index)||!this.normalizedGroupByIndex.has(index)||(current.set(index,marker),this.observedGroupIndices.set(marker,index))});for(const[index,marker]of this.observedGroups)current.get(index)!==marker&&(observer.unobserve(marker),this.observedGroups.delete(index),this.deferredGroupObservations.delete(index));for(const[index,marker]of current)this.observedGroups.has(index)||(this.observedGroups.set(index,marker),this.inResizeDelivery?this.deferredGroupObservations.set(index,marker):observer.observe(marker))}get stickyInset(){return this.renderStickyGroup?this.stickyHeight:0}scrollActiveIntoView(){const index=this.activeIndex;if(index<0)return;const behavior=prefersReducedMotion(this)?"auto":"smooth";this.performScrollTo(index,"auto",behavior)&&this.beginPendingScrollCorrection(index,"auto",behavior,this.activeItemId)}scrollToIndex(index,options){const n=this.itemCount;if(n===0)return;const clamped=finiteInteger(index,0,0,n-1),align=options?.align??"auto",behavior=prefersReducedMotion(this)?"auto":options?.behavior??"smooth";this.performScrollTo(clamped,align,behavior)?this.beginPendingScrollCorrection(clamped,align,behavior):this.pendingScrollCorrection=void 0}hasUnmeasuredGroupThrough(index){return this.normalizedGroups.some(group=>group.startIndex<=index&&group.label!==""&&!this.measuredGroupHeights.has(group.startIndex))}beginPendingScrollCorrection(index,align,behavior,activeItemId){if(this.fixedRowHeight!=null&&!this.hasUnmeasuredGroupThrough(index)){this.pendingScrollCorrection=void 0;return}this.pendingScrollCorrection={identity:this.identityAt(index),index,align,behavior,source:this.effectiveSource,keyFunction:this.keyFunction,activeItemId:activeItemId===""?void 0:activeItemId,lastMeasurementGeneration:this.measurementGeneration}}performScrollTo(index,align,behavior){const metrics=this.readScrollMetrics();if(!metrics)return!1;const inset=this.stickyInset,top=this.offsetAt(index),bottom=this.rowBottomAt(index),viewTop=metrics.rawScrollTop,viewBottom=viewTop+metrics.viewportHeight;let target=null;return align==="start"?target=top-inset:align==="end"?target=bottom-metrics.viewportHeight:top-inset<viewTop?target=top-inset:bottom>viewBottom&&(target=bottom-metrics.viewportHeight),target===null?!1:(this.applyScrollPosition(target,behavior),!0)}maybeCorrectPendingScroll(){const pending=this.pendingScrollCorrection;if(!pending||pending.lastMeasurementGeneration>=this.measurementGeneration)return;if(pending.source!==this.effectiveSource||pending.keyFunction!==this.keyFunction||pending.activeItemId!==void 0&&!Object.is(pending.activeItemId,this.activeItemId)){this.pendingScrollCorrection=void 0;return}const index=pending.activeItemId!==void 0?this.activeIndex:isIndexedSource(this.effectiveSource)?pending.index:this.rowIdentities.indexOf(pending.identity);if(index<0||index>=this.itemCount||this.identityAt(index)!==pending.identity){this.pendingScrollCorrection=void 0;return}this.performScrollTo(index,pending.align,pending.behavior),pending.index=index,pending.lastMeasurementGeneration=this.measurementGeneration,(this.fixedRowHeight!=null||this.measuredHeights.has(pending.identity))&&!this.hasUnmeasuredGroupThrough(index)&&(this.pendingScrollCorrection=void 0)}emitRangeChangeIfNeeded(){if(this.visibleEnd<this.visibleStart){this.lastEmittedStart=-1,this.lastEmittedEnd=-1;return}this.visibleStart===this.lastEmittedStart&&this.visibleEnd===this.lastEmittedEnd||(this.lastEmittedStart=this.visibleStart,this.lastEmittedEnd=this.visibleEnd,this.emit("lr-visible-range-change",{start:this.visibleStart,end:this.visibleEnd}))}maybeFireLoadMore(){const n=this.itemCount;if(!(n>0&&this.visibleEnd>=n-1)){this.loadMoreArmed=!0;return}!this.hasMore||this.loading||!this.loadMoreArmed||(this.loadMoreArmed=!1,this.emit("lr-load-more"))}get projectionActive(){return!this.projectionDeferred&&this.rowProjection==="light"}rowSlotName(identity){return`${tag("virtual-list")}-row-${identity}`}syncRowProjection(){if(!this.projectionActive||!this.isConnected){this.projectionAnchor!==void 0&&this.teardownRowProjection();return}const anchor=this.ensureProjectionAnchor();this.projectionPart=render(this.renderProjectedRows(),this,{renderBefore:anchor,host:this})}ensureProjectionAnchor(){const existing=this.projectionAnchor;if(existing!==void 0&&existing.parentNode===this&&existing.ownerDocument===this.ownerDocument)return existing;existing!==void 0&&this.teardownRowProjection();const anchor=this.ownerDocument.createComment(PROJECTION_ANCHOR_MARKER);return this.append(anchor),this.projectionAnchor=anchor,this.projectionPart=void 0,anchor}teardownRowProjection(){const anchor=this.projectionAnchor,part=this.projectionPart;if(this.projectionAnchor=void 0,this.projectionPart=void 0,anchor!==void 0){if(part!==void 0){const container=anchor.parentNode;container!==null&&render(nothing,container,{renderBefore:anchor,host:this});const start=part.startNode;start?.parentNode?.removeChild(start)}anchor.parentNode?.removeChild(anchor)}}renderProjectedRows(){return repeat(this.renderedWindow,w=>w.identity,w=>staticHtml`<div
+import{__decorate}from"tslib";import{devWarnOnce}from"../../../internal/dev-warning.js";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{VirtualListCompositionController}from"../../../internal/virtual-list-composition.js";import{html,nothing,render}from"lit";import{html as staticHtml,unsafeStatic}from"lit/static-html.js";import{property,state}from"lit/decorators.js";import{repeat}from"lit/directives/repeat.js";import{ref}from"lit/directives/ref.js";import{styleMap}from"lit/directives/style-map.js";import{LyraElement}from"../../../internal/lyra-element.js";import{literalSetConverter}from"../../../internal/converters.js";import{tag}from"../../../internal/prefix.js";import{VIRTUAL_LIST_ROW_ATTRIBUTE}from"./virtual-list-attributes.js";import{VIRTUAL_LIST_ROW_ATTRIBUTE as VIRTUAL_LIST_ROW_ATTRIBUTE2,VIRTUAL_LIST_STICKY_ATTRIBUTE}from"./virtual-list-attributes.js";import{MAX_OVERSCAN_ROWS}from"./virtual-list-limits.js";import{MAX_OVERSCAN_ROWS as MAX_OVERSCAN_ROWS2}from"./virtual-list-limits.js";import{prefersReducedMotion}from"../../../internal/motion.js";import{nativePopoverSupported}from"../../../internal/native-popover.js";import{finiteAdd,finiteCount,finiteInteger,finiteNumber}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{composedParentElement,deepActiveElementIn}from"../../../internal/active-element.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{styles}from"./virtual-list.styles.js";const DEFAULT_ROW_ESTIMATE_PX=48,MAX_SCROLL_EXTENT_PX=8e6,DEFAULT_GROUP_ESTIMATE_PX=32,DEFAULT_OVERSCAN_ROWS=6,MAX_VIRTUAL_LIST_GROUPS=1e4,EMPTY_VIRTUAL_LIST_GROUPS=Object.freeze([]);function normalizeOverscan(value){if(value===null)return DEFAULT_OVERSCAN_ROWS;const numeric=typeof value=="number"?value:Number(value);return Number.isFinite(numeric)?Math.min(MAX_OVERSCAN_ROWS,Math.max(0,Math.floor(numeric))):DEFAULT_OVERSCAN_ROWS}const overscanConverter={fromAttribute(value){return normalizeOverscan(value)}};function virtualListGroupsChanged(value,oldValue){if(value===oldValue)return!1;const next=value,previous=oldValue;if(next==null||previous==null)return next!==previous;if(next.length!==previous.length)return!0;for(let index=0;index<next.length;index+=1){const a=next[index],b=previous[index];if(a.key!==b.key||a.label!==b.label||a.startIndex!==b.startIndex)return!0}return!1}const ROW_PROJECTION=literalSetConverter(["shadow","light"],"shadow"),ROW_ATTRIBUTE_STATIC=unsafeStatic(VIRTUAL_LIST_ROW_ATTRIBUTE),PROJECTION_ANCHOR_MARKER=`${tag("virtual-list")}-projection`;function normalizeRowHeight(value){if(value==="auto")return"auto";const numeric=typeof value=="number"?value:Number(value);return Number.isFinite(numeric)&&numeric>0?numeric:"auto"}const rowHeightConverter={fromAttribute(value){return value===null?"auto":normalizeRowHeight(value)}};function isIndexedSource(source){return!Array.isArray(source)}function sameSequence(a,b){return Array.isArray(a)&&Array.isArray(b)&&a.length===b.length&&a.every((item,index)=>item===b[index])}const ELEMENT_NODE_TYPE=1;function isWindowScroller(target){return target.window===target}function domKeyToken(key){if(typeof key=="number"){if(Number.isNaN(key))return"number:NaN";if(Object.is(key,-0))return"number:-0"}return`${typeof key}:${String(key)}`}const SCROLL_KEYS=new Set(["ArrowUp","ArrowDown","PageUp","PageDown","Home","End"," "]);class LyraVirtualList extends LyraElement{constructor(){super(...arguments),this.items=[],this.renderItem=()=>nothing,this.rowHeight="auto",this.itemRole="listitem",this._rowProjection="shadow",this.rowIndexOffset=0,this.overscan=DEFAULT_OVERSCAN_ROWS,this.activeItemId="",this.loading=!1,this.hasMore=!1,this.partCache=new Map,this.invalidateExternalGeometry=()=>{this.externalGeometry=void 0,this.isConnected&&this.syncExternalScrollMetrics()},this.scrollMetricsRefreshPending=!1,this.containerScrollTop=0,this.viewportHeight=0,this.renderUnmeasuredWindow=!0,this.offsets=[0],this.offsetDirtyStart=0,this.appendIdentityStart=-1,this.identityIndices=new Map,this.keyIndices=new Map,this.keyOccurrences=new Map,this.groupPrefixDirty=!0,this.rowKeys=[],this.rowIdentities=[],this.fixedRowHeight=null,this.measuredHeights=new Map,this.measuredIndices=new Map,this.indexedMeasurementIndices=[],this.indexedMeasurementDeltaPrefix=[0],this.indexedMeasurementIndexDirty=!0,this.offsetsDirty=!0,this.identitiesDirty=!0,this.itemsChangedPendingPrune=!1,this.compositionVersion=0,this.composition=new VirtualListCompositionController(this,()=>{const previous=this.compositionVersion;this.compositionVersion++,this.composition.profile||(this.compositionScrollTarget=void 0),this.requestUpdate("compositionVersion",previous)}),this.renderStart=0,this.renderEnd=-1,this.pinnedRow=-1,this.renderedWindow=[],this.rowElements=new Map,this.groupElements=new Map,this.projectionDeferred=!0,this.releaseRowProjection=()=>{this.projectionDeferred=!1,super.requestUpdate()},this.visibleStart=0,this.visibleEnd=-1,this.lastEmittedStart=-1,this.lastEmittedEnd=-1,this.loadMoreArmed=!0,this.measurementGeneration=0,this.isFirstUpdate=!0,this.stickyHeight=0,this.noTopLayer=!1,this.observedRows=new Map,this.observedRowKeys=new WeakMap,this.observedRowIndices=new WeakMap,this.observedGroups=new Map,this.observedGroupIndices=new WeakMap,this.externalMetricsPending=!1,this.ownerRealmGeneration=0,this.inResizeDelivery=!1,this.pendingRowMeasurements=new Map,this.pendingGroupMeasurements=new Map,this.deferredRowObservations=new Map,this.deferredGroupObservations=new Map,this.activeIndexForLength=-1,this.activeIndexForId="",this.activeIndexCache=-1,this.pendingScrollTop=null,this.normalizedGroups=EMPTY_VIRTUAL_LIST_GROUPS,this.normalizedGroupByIndex=new Map,this.measuredGroupHeights=new Map,this.groupHeightPrefix=[0],this.contentRefreshPending=!1,this.onExternalViewportResize=()=>{this.externalGeometry=void 0,this.syncExternalScrollMetrics()},this.onUserScrollIntent=event=>{event instanceof KeyboardEvent&&!SCROLL_KEYS.has(event.key)||(this.pendingScrollCorrection=void 0,this.compositionScrollTarget=void 0,this.scrollRoundingAnchor=void 0)},this.onScroll=e=>{if(this.externalScroller?(this.pendingScrollTop=null,this.externalMetricsPending=!0):this.pendingScrollTop=this.logicalScroll(e.currentTarget.scrollTop),this.scrollRafId!==void 0)return;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected)return;const generation=this.ownerRealmGeneration,handle=ownerWindow.requestAnimationFrame(()=>{if(!(this.scrollRafId!==handle||this.scrollRafOwner!==ownerWindow||this.scrollRafDocument!==ownerDocument||!this.isCurrentOwnerWork(ownerDocument,generation))){if(this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,this.externalMetricsPending){this.externalMetricsPending=!1;const metrics=this.readScrollMetrics();metrics&&(this.pendingScrollTop=metrics.scrollTop,this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight))}if(this.pendingScrollTop!==null){const scrollTop=this.pendingScrollTop;this.pendingScrollTop=null;const moved=this.containerScrollTop!==scrollTop;this.containerScrollTop=scrollTop,moved&&this.emit("lr-virtual-scroll",{scrollTop,viewportHeight:this.viewportHeight})}}});this.scrollRafId=handle,this.scrollRafOwner=ownerWindow,this.scrollRafDocument=ownerDocument},this.onRowsResized=entries=>{if(this.beginResizeDelivery(),this.fixedRowHeight==null){for(const entry of entries){const row=entry.target,key=this.observedRowKeys.get(row),index=this.observedRowIndices.get(row);if(key===void 0||index===void 0)continue;const height=entry.borderBoxSize?.[0]?.blockSize??entry.target.getBoundingClientRect().height;this.pendingRowMeasurements.set(key,{index,height})}this.defersMeasurementApplication||this.applyPendingRowMeasurements()}},this.onGroupsResized=entries=>{this.beginResizeDelivery();for(const entry of entries){const marker=entry.target,index=this.observedGroupIndices.get(marker);if(index===void 0||!this.normalizedGroupByIndex.has(index))continue;const height=entry.borderBoxSize?.[0]?.blockSize??entry.target.getBoundingClientRect().height;!Number.isFinite(height)||height<0||this.pendingGroupMeasurements.set(index,height)}this.defersMeasurementApplication||this.applyPendingGroupMeasurements()},this.onFocusOut=event=>{const next=event.relatedTarget;this.pinnedRow>=0&&!(next&&(this.contains(next)||this.renderRoot.contains(next)))&&super.requestUpdate()},this.onStickyResized=entries=>{this.beginResizeDelivery();const entry=entries[0];if(!entry)return;const height=entry.borderBoxSize?.[0]?.blockSize??entry.contentRect.height;Math.abs(this.stickyHeight-height)>.5&&(this.stickyHeight=height)}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["items","source","groups"])}static{this.identityCollectionProperties=Object.freeze(["items","source"])}static{this.identityCollectionObjectProperties=Object.freeze(["source"])}static{this.styles=[LyraElement.styles,styles]}get rowProjection(){return this._rowProjection}set rowProjection(next){const normalized=ROW_PROJECTION.normalize(next),previous=this._rowProjection;previous!==normalized&&(this._rowProjection=normalized,this.requestUpdate("rowProjection",previous))}get scrollContainer(){return this.cachedPart("base")}cachedPart(name){let element=this.partCache.get(name);return element?.isConnected||(element=this.renderRoot?.querySelector(`[part="${name}"]`)??void 0,element?this.partCache.set(name,element):this.partCache.delete(name)),element}get renderedRows(){const root=this.renderRoot;return root?[...root.querySelectorAll('[part="row"]')]:[]}get projectedRows(){const rows=[];for(const child of this.children)child.hasAttribute(VIRTUAL_LIST_ROW_ATTRIBUTE)&&rows.push(child);return rows}get externalScroller(){const target=this.scrollElement;if(target!=null)return isWindowScroller(target)||target.nodeType===ELEMENT_NODE_TYPE?target:void 0}get spacerElement(){return this.cachedPart("spacer")}scrollScale(viewport=this.viewportHeight){const total=this.offsetAt(this.itemCount);return total<=MAX_SCROLL_EXTENT_PX?1:Math.max(1,(total-viewport)/Math.max(1,MAX_SCROLL_EXTENT_PX-viewport))}logicalScroll(physical,viewport=this.viewportHeight){if(this.scrollRoundingAnchor){if(Math.abs(physical-this.scrollRoundingAnchor.physical)<.01)return this.scrollRoundingAnchor.logical;this.scrollRoundingAnchor=void 0}return physical<0?physical:physical*this.scrollScale(viewport)}physicalScroll(logical,viewport=this.viewportHeight){return logical<0?logical:logical/this.scrollScale(viewport)}physicalRowOffset(logical){return this.scrollScale()===1?logical:(this.scrollRoundingAnchor?.logical===this.containerScrollTop?this.scrollRoundingAnchor.physical:this.physicalScroll(this.containerScrollTop))+logical-this.containerScrollTop}captureScrollRounding(logical){this.scrollRoundingAnchor=void 0;const metrics=this.readPhysicalScrollMetrics();if(!metrics||this.scrollScale(metrics.viewportHeight)===1)return;const physical=this.physicalScroll(logical,metrics.viewportHeight);Math.abs(physical-metrics.rawScrollTop)<=1.1&&(this.scrollRoundingAnchor={physical:metrics.rawScrollTop,logical})}readScrollMetrics(){const metrics=this.readPhysicalScrollMetrics();if(!metrics)return metrics;const rawScrollTop=this.logicalScroll(metrics.rawScrollTop,metrics.viewportHeight);return{...metrics,rawScrollTop,scrollTop:Math.max(0,rawScrollTop)}}readPhysicalScrollMetrics(){const base=this.scrollContainer;if(!base)return null;const external=this.externalScroller;if(!external)return{scrollTop:base.scrollTop,rawScrollTop:base.scrollTop,viewportHeight:base.clientHeight,scrollDeltaScale:1};const spacer=this.spacerElement??base,spacerRect=spacer.getBoundingClientRect(),extent=this.offsetAt(this.itemCount),cached=this.externalGeometry,valid=cached?.spacer===spacer&&cached.external===external&&cached.height===spacerRect.height&&cached.extent===extent,spacerScale=valid?cached.spacerScale:this.visualBlockScale(spacer,spacerRect),spacerTop=spacerRect.top;if(isWindowScroller(external)){this.externalGeometry={spacer,external,height:spacerRect.height,extent,spacerScale,scrollerScale:1,borderTop:0};const documentHeight=finiteNumber(external.document?.documentElement?.clientHeight??0,0),rawScrollTop2=finiteNumber(-spacerTop/spacerScale,0);return{scrollTop:Math.max(0,rawScrollTop2),rawScrollTop:rawScrollTop2,viewportHeight:(documentHeight>0?documentHeight:finiteNumber(external.innerHeight,0))/spacerScale,scrollDeltaScale:spacerScale}}const scrollerRect=external.getBoundingClientRect(),relativeScale=valid?null:this.relativeBlockScale(spacer,external),inferredScrollerScale=relativeScale===null?0:spacerScale/relativeScale,scrollerScale=valid?cached.scrollerScale:Number.isFinite(inferredScrollerScale)&&inferredScrollerScale>0?inferredScrollerScale:this.visualBlockScale(external,scrollerRect),scrollerStyle=valid?void 0:external.ownerDocument.defaultView?.getComputedStyle(external),borderTop=valid?cached.borderTop:Number.parseFloat(scrollerStyle?.borderTopWidth??"");this.externalGeometry={spacer,external,height:spacerRect.height,extent,spacerScale,scrollerScale,borderTop};const scrollerTop=scrollerRect.top+(Number.isFinite(borderTop)?borderTop:external.clientTop)*scrollerScale,rawScrollTop=finiteNumber((scrollerTop-spacerTop)/spacerScale,0);return{scrollTop:Math.max(0,rawScrollTop),rawScrollTop,viewportHeight:finiteNumber(external.clientHeight*scrollerScale/spacerScale,0),scrollDeltaScale:spacerScale/scrollerScale}}visualBlockScale(element,rect){const style=element.ownerDocument.defaultView?.getComputedStyle(element);if(!style)return 1;const borderBoxHeight=Number.parseFloat(style.height)+(style.boxSizing==="border-box"?0:Number.parseFloat(style.paddingTop)+Number.parseFloat(style.paddingBottom)+Number.parseFloat(style.borderTopWidth)+Number.parseFloat(style.borderBottomWidth)),layoutHeight=borderBoxHeight>0&&Number.isFinite(borderBoxHeight)?borderBoxHeight:"offsetHeight"in element&&typeof element.offsetHeight=="number"?element.offsetHeight:0,scale=rect.height/layoutHeight;return scale>0&&Number.isFinite(scale)?scale:1}relativeBlockScale(descendant,ancestor){let scale=1,current=descendant;for(;current&&current!==ancestor;){const style=current.ownerDocument.defaultView?.getComputedStyle(current);if(!style)return null;const zoom=style.zoom?style.zoom.endsWith("%")?Number.parseFloat(style.zoom)/100:Number.parseFloat(style.zoom):1;if(!Number.isFinite(zoom)||zoom<=0)return null;scale*=zoom;const transformable=style.display!=="contents"&&style.display!=="inline";if(transformable&&style.scale&&style.scale!=="none"){const values=style.scale.split(/\s+/).map(Number),blockScale=values[1]??values[0]??Number.NaN;if(!Number.isFinite(blockScale)||blockScale<=0)return null;scale*=blockScale}if(transformable&&style.rotate&&style.rotate!=="none"&&style.rotate!=="0deg")return null;if(transformable&&style.transform!=="none"){const Matrix=current.ownerDocument.defaultView?.DOMMatrixReadOnly;if(!Matrix)return null;const matrix=new Matrix(style.transform);if(matrix.m12!==0||matrix.m13!==0||matrix.m14!==0||matrix.m21!==0||matrix.m23!==0||matrix.m24!==0||matrix.m31!==0||matrix.m32!==0||matrix.m34!==0||matrix.m44!==1||matrix.m22<=0)return null;scale*=matrix.m22}const parent=current.assignedSlot??current.parentNode;current=parent?.nodeType===Node.ELEMENT_NODE?parent:parent?.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&"host"in parent?parent.host:null}return current===ancestor&&Number.isFinite(scale)&&scale>0?scale:null}applyScrollPosition(top,behavior){const external=this.externalScroller;if(!external){const base=this.scrollContainer;if(!base)return;const next2=Math.max(0,this.physicalScroll(finiteNumber(top,0),base.clientHeight));behavior===void 0?base.scrollTop=next2:base.scrollTo({top:next2,behavior}),behavior!=="smooth"&&(this.captureScrollRounding(top),this.scheduleScrollMetricsRefresh());return}const metrics=this.readPhysicalScrollMetrics();if(!metrics)return;const delta=(this.physicalScroll(finiteNumber(top,metrics.rawScrollTop),metrics.viewportHeight)-metrics.rawScrollTop)*metrics.scrollDeltaScale;if(isWindowScroller(external)){const options={top:Math.max(0,finiteNumber(external.scrollY+delta,0))};behavior!==void 0&&(options.behavior=behavior),external.scrollTo(options),behavior!=="smooth"&&(this.captureScrollRounding(top),this.scheduleScrollMetricsRefresh());return}const next=Math.max(0,finiteNumber(external.scrollTop+delta,0));behavior===void 0?external.scrollTop=next:external.scrollTo({top:next,behavior}),behavior!=="smooth"&&(this.captureScrollRounding(top),this.scheduleScrollMetricsRefresh())}scheduleScrollMetricsRefresh(){if(this.scrollMetricsRefreshPending)return;this.scrollMetricsRefreshPending=!0;const owner=this.ownerDocument.defaultView;queueMicrotask(()=>{this.scrollMetricsRefreshPending=!1,this.isConnected&&this.ownerDocument.defaultView===owner&&this.syncExternalScrollMetrics()})}syncExternalScrollMetrics(){const metrics=this.readScrollMetrics();metrics&&(this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight),this.containerScrollTop!==metrics.scrollTop&&(this.containerScrollTop=metrics.scrollTop))}get safeRowIndexOffset(){return finiteCount(this.rowIndexOffset)}computedAriaRowIndex(index){return finiteInteger(finiteAdd(index+1,this.safeRowIndexOffset),1,1,Number.MAX_SAFE_INTEGER)}get activeIndex(){if(this.activeItemId==="")return-1;const source=this.effectiveSource,count=this.itemCount;if(this.activeIndexFor===source&&this.activeIndexForLength===count&&Object.is(this.activeIndexForId,this.activeItemId)&&this.activeIndexForKeyFn===this.keyFunction)return this.activeIndexCache;if(this.activeIndexFor=source,this.activeIndexForLength=count,this.activeIndexForId=this.activeItemId,this.activeIndexForKeyFn=this.keyFunction,this.activeIndexCache=-1,isIndexedSource(source)){if(!this.keyFunction&&source.indexOfKey){const candidate=source.indexOfKey(this.activeItemId);Number.isInteger(candidate)&&candidate>=0&&candidate<count&&(this.activeIndexCache=candidate)}return this.activeIndexCache}return this.activeIndexCache=this.keyIndices.get(domKeyToken(this.activeItemId))??-1,this.activeIndexCache}connectedCallback(){super.connectedCallback(),this.ownerDocument.defaultView&&(this.seedFirstRenderState(()=>{this.renderUnmeasuredWindow=!1,super.requestUpdate()}),this.seedFirstRenderState(this.releaseRowProjection),this.hasUpdated&&(this.projectionDeferred=!1)),this.resetOwnerRealmWork();const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView,generation=this.ownerRealmGeneration,ResizeObserverCtor=ownerWindow?.ResizeObserver;if(ResizeObserverCtor){const rowObserver=new ResizeObserverCtor(entries=>{this.rowResizeObserver!==rowObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onRowsResized(entries)}),groupObserver=new ResizeObserverCtor(entries=>{this.groupResizeObserver!==groupObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onGroupsResized(entries)}),stickyObserver=new ResizeObserverCtor(entries=>{this.stickyResizeObserver!==stickyObserver||!this.isCurrentOwnerWork(ownerDocument,generation)||this.onStickyResized(entries)});this.rowResizeObserver=rowObserver,this.groupResizeObserver=groupObserver,this.stickyResizeObserver=stickyObserver}this.hasUpdated&&(this.syncRowProjection(),this.attachContainerListeners(),this.syncRowObservers(),this.syncGroupObservers(),this.syncStickyOverlay())}disconnectedCallback(){this.teardownRowProjection(),this.resetOwnerRealmWork(),super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.teardownRowProjection(),this.resetOwnerRealmWork()}isCurrentOwnerWork(ownerDocument,generation){return this.ownerRealmGeneration===generation&&this.isConnected&&this.ownerDocument===ownerDocument}resetOwnerRealmWork(){this.ownerRealmGeneration+=1,this.rowResizeObserver?.disconnect(),this.rowResizeObserver=void 0,this.groupResizeObserver?.disconnect(),this.groupResizeObserver=void 0,this.observedRows.clear(),this.observedGroups.clear(),this.deferredRowObservations.clear(),this.deferredGroupObservations.clear(),this.inResizeDelivery=!1,this.pendingRowMeasurements.clear(),this.pendingGroupMeasurements.clear(),this.rowObserveRafId!==void 0&&this.rowObserveRafOwner?.cancelAnimationFrame(this.rowObserveRafId),this.rowObserveRafId=void 0,this.rowObserveRafOwner=void 0,this.rowObserveRafDocument=void 0,this.containerResizeObserver?.disconnect(),this.containerResizeObserver=void 0,this.stickyResizeObserver?.disconnect(),this.stickyResizeObserver=void 0,this.observedSticky=void 0,this.scrollRafId!==void 0&&this.scrollRafOwner?.cancelAnimationFrame(this.scrollRafId),this.scrollRafId=void 0,this.scrollRafOwner=void 0,this.scrollRafDocument=void 0,this.pendingScrollTop=null,this.externalMetricsPending=!1,this.pendingScrollCorrection=void 0,this.detachContainerListeners(),this.scrollListenerTarget=void 0}firstUpdated(changed){super.firstUpdated(changed),this.attachContainerListeners(),queueMicrotask(()=>{this.isConnected&&(this.noTopLayer=!nativePopoverSupported())})}requestUpdate(...args){args[0]===void 0&&(this.contentRefreshPending=!0),super.requestUpdate(...args)}willUpdate(changed){super.willUpdate(changed),this.projectionDeferred&&!this.hasUpdated&&this.ownerDocument?.defaultView&&this.seedFirstRenderState(this.releaseRowProjection),this.isFirstUpdate=!this.hasUpdated,this.hasUpdated&&(this.noTopLayer=!nativePopoverSupported());const contentRefresh=this.contentRefreshPending;this.contentRefreshPending=!1,contentRefresh&&(this.activeIndexFor=void 0);const sequence=contentRefresh||changed.has("items")&&!sameSequence(changed.get("items"),this.items)||changed.has("source")&&!sameSequence(changed.get("source"),this.source);sequence||changed.has("keyFunction")||changed.has("rowHeight")||changed.has("groups")||changed.has("activeItemId")||changed.has("scrollElement")?this.pendingScrollCorrection=void 0:this.pendingScrollCorrection&&(this.pendingScrollCorrection.source=this.effectiveSource),this.appendIdentityStart=-1;const previous=changed.has("source")?changed.get("source"):changed.get("items"),current=this.effectiveSource;if(sequence&&Array.isArray(previous)&&Array.isArray(current)&&previous.length<current.length&&previous.length===this.rowIdentities.length&&!changed.has("keyFunction")&&!changed.has("groups")&&!changed.has("rowHeight")&&previous.every((item,index)=>Object.is(item,current[index]))&&(this.appendIdentityStart=previous.length),(sequence||changed.has("keyFunction"))&&(this.identitiesDirty=!0),(sequence||changed.has("rowHeight")||changed.has("keyFunction")||changed.has("groups"))&&(this.offsetsDirty=!0,this.offsetDirtyStart=Math.min(this.offsetDirtyStart,this.appendIdentityStart>=0?this.appendIdentityStart:0)),sequence&&(this.compositionScrollTarget=void 0,this.itemsChangedPendingPrune=!0),changed.has("keyFunction")||isIndexedSource(this.effectiveSource)&&sequence){this.measuredHeights.clear(),this.measuredIndices.clear(),this.pendingRowMeasurements.clear(),this.indexedMeasurementIndexDirty=!0;for(const row of this.observedRows.values())this.rowResizeObserver?.unobserve(row);this.observedRows.clear(),this.deferredRowObservations.clear()}if(changed.has("groups")){this.measuredGroupHeights.clear(),this.pendingGroupMeasurements.clear();for(const marker of this.observedGroups.values())this.groupResizeObserver?.unobserve(marker);this.observedGroups.clear(),this.deferredGroupObservations.clear()}if((sequence||changed.has("groups"))&&this.recomputeGroups(),changed.has("rowHeight")&&(this.fixedRowHeight=this.parseRowHeight(this.rowHeight),this.fixedRowHeight!=null&&(this.measuredHeights.clear(),this.measuredIndices.clear(),this.pendingRowMeasurements.clear(),this.indexedMeasurementIndexDirty=!0)),this.offsetsDirty&&(this.recomputeOffsets(),this.offsetsDirty=!1,this.offsetDirtyStart=1/0),changed.has("activeItemId")&&!this.isFirstUpdate&&this.composition.profile){const index=this.activeIndex;index>=0&&(this.compositionScrollTarget=index)}this.computeRange(),this.limitCompositionWindow()}updated(changed){super.updated(changed),this.syncRowProjection(),this.syncRowObservers(),this.syncGroupObservers(),this.syncStickyOverlay(),changed.has("scrollElement")&&!this.isFirstUpdate&&this.attachContainerListeners(),changed.has("activeItemId")&&!this.isFirstUpdate&&this.scrollActiveIntoView(),this.emitRangeChangeIfNeeded(),this.maybeFireLoadMore(),this.maybeCorrectPendingScroll()}parseRowHeight(value){const normalized=normalizeRowHeight(value);return normalized==="auto"?null:normalized}get effectiveSource(){return this.source??this.items}get itemCount(){const source=this.effectiveSource;return isIndexedSource(source)?finiteCount(source.count):source.length}itemAt(index){const source=this.effectiveSource;return isIndexedSource(source)?source.itemAt(index):source[index]}keyOf(item,index){const source=this.effectiveSource,key=this.keyFunction?this.keyFunction(item,index):isIndexedSource(source)?source.keyAt?.(index)??index:index;return typeof key=="string"||typeof key=="number"?key:index}rowIdentity(key,occurrence){const token=domKeyToken(key);return`${token.length}:${token}:${occurrence}`}identityAt(index,item){return arguments.length<2&&this.keyFunction&&(item=this.itemAt(index)),isIndexedSource(this.effectiveSource)?this.rowIdentity(this.keyOf(item,index),index):this.rowIdentities[index]??this.rowIdentity(this.keyOf(item,index),index)}groupHeightAt(index){const group=this.normalizedGroupByIndex.get(index);return!group||group.label===""?0:this.measuredGroupHeights.get(index)??DEFAULT_GROUP_ESTIMATE_PX}rowHeightAt(index){return this.fixedRowHeight!=null?this.fixedRowHeight:this.measuredHeights.get(this.identityAt(index))??DEFAULT_ROW_ESTIMATE_PX}groupContributionThrough(index){return this.groupHeightPrefix[this.groupCountThrough(index)]??0}groupCountThrough(index){let low=0,high=this.normalizedGroups.length;for(;low<high;){const middle=low+high>>1;this.normalizedGroups[middle].startIndex<=index?low=middle+1:high=middle}return low}recomputeGroupHeightPrefix(){const prefix=new Array(this.normalizedGroups.length+1);prefix[0]=0;for(let index=0;index<this.normalizedGroups.length;index++){const group=this.normalizedGroups[index],height=group.label===""?0:this.measuredGroupHeights.get(group.startIndex)??DEFAULT_GROUP_ESTIMATE_PX;prefix[index+1]=finiteAdd(prefix[index],height)}this.groupHeightPrefix=prefix}indexedOffsetForIndex(index){const baseHeight=this.fixedRowHeight??DEFAULT_ROW_ESTIMATE_PX;let offset=index>Number.MAX_VALUE/baseHeight?Number.MAX_VALUE:index*baseHeight;if(this.fixedRowHeight==null){this.rebuildIndexedMeasurementIndex();let low=0,high=this.indexedMeasurementIndices.length;for(;low<high;){const middle=low+high>>1;this.indexedMeasurementIndices[middle]<index?low=middle+1:high=middle}offset=finiteAdd(offset,this.indexedMeasurementDeltaPrefix[low]??0)}return Math.max(0,finiteAdd(offset,this.groupContributionThrough(index)))}rebuildIndexedMeasurementIndex(){if(!this.indexedMeasurementIndexDirty)return;const retained=[];for(const[identity,index]of this.measuredIndices){const height=this.measuredHeights.get(identity);height!==void 0&&retained.push({index,delta:height-DEFAULT_ROW_ESTIMATE_PX})}retained.sort((a,b)=>a.index-b.index);const indices=new Array(retained.length),prefix=new Array(retained.length+1);prefix[0]=0;for(let position=0;position<retained.length;position++){const measurement=retained[position];indices[position]=measurement.index,prefix[position+1]=finiteAdd(prefix[position],measurement.delta)}this.indexedMeasurementIndices=indices,this.indexedMeasurementDeltaPrefix=prefix,this.indexedMeasurementIndexDirty=!1}pruneIndexedMeasurements(){if(!isIndexedSource(this.effectiveSource)||this.fixedRowHeight!=null||this.renderEnd<this.renderStart)return!1;const renderedCount=this.renderEnd-this.renderStart+1,retentionRows=Math.max(renderedCount,normalizeOverscan(this.overscan)*4),firstRetained=Math.max(0,this.renderStart-retentionRows),lastRetained=Math.min(this.itemCount-1,this.renderEnd+retentionRows);let removedDeltaBeforeWindow=0,pruned=!1;for(const[identity,measuredIndex]of this.measuredIndices)if(measuredIndex<firstRetained||measuredIndex>lastRetained){const height=this.measuredHeights.get(identity);height!==void 0&&measuredIndex<firstRetained&&(removedDeltaBeforeWindow=finiteAdd(removedDeltaBeforeWindow,height-DEFAULT_ROW_ESTIMATE_PX)),this.measuredIndices.delete(identity),this.measuredHeights.delete(identity),pruned=!0}if(pruned&&(this.indexedMeasurementIndexDirty=!0,removedDeltaBeforeWindow!==0)){const nextScrollTop=(this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop)-removedDeltaBeforeWindow;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}return pruned}offsetAt(index){return isIndexedSource(this.effectiveSource)?this.indexedOffsetForIndex(index):this.offsets[index]??0}recomputeOffsets(){const n=this.itemCount;if(this.groupPrefixDirty&&(this.recomputeGroupHeightPrefix(),this.groupPrefixDirty=!1),isIndexedSource(this.effectiveSource)){this.offsets=[0],this.rowIdentities=[],this.rowKeys=[],this.identityIndices.clear(),this.keyIndices.clear(),this.keyOccurrences.clear(),this.itemsChangedPendingPrune=!1;return}const append=this.appendIdentityStart>=0,start=this.identitiesDirty&&!append?0:Math.min(n,this.offsetDirtyStart),offsets=start>0?this.offsets:new Array(n+1);let cursor=start>0?finiteAdd(this.offsets[start-1],this.rowHeightAt(start-1)):0;const liveKeys=this.itemsChangedPendingPrune&&!append&&this.fixedRowHeight==null?new Set:null,occurrences=append?this.keyOccurrences:new Map;this.identitiesDirty&&!append&&(this.identityIndices.clear(),this.keyIndices.clear(),this.rowKeys=[]);const reuse=!this.identitiesDirty&&this.rowIdentities.length===n,identities=reuse||append?this.rowIdentities:new Array(n);for(let i=start;i<n;i++){if(cursor=finiteAdd(cursor,this.groupHeightAt(i)),offsets[i]=cursor,!reuse){const key=this.keyOf(this.itemAt(i),i),token=domKeyToken(key),occurrence=occurrences.get(token)??0;occurrences.set(token,occurrence+1),identities[i]=this.rowIdentity(key,occurrence),this.rowKeys[i]=key,this.identityIndices.set(identities[i],i),this.keyIndices.has(token)||this.keyIndices.set(token,i)}const identity=identities[i];let h;this.fixedRowHeight!=null?h=this.fixedRowHeight:(liveKeys?.add(identity),h=this.measuredHeights.get(identity)??DEFAULT_ROW_ESTIMATE_PX),cursor=finiteAdd(cursor,h)}if(offsets[n]=cursor,this.offsets=offsets,this.rowIdentities=identities,reuse||(this.keyOccurrences=occurrences),this.identitiesDirty=!1,this.itemsChangedPendingPrune=!1,liveKeys){for(const key of this.measuredHeights.keys())liveKeys.has(key)||(this.measuredHeights.delete(key),this.measuredIndices.delete(key),this.indexedMeasurementIndexDirty=!0);for(const key of this.measuredIndices.keys())liveKeys.has(key)||(this.measuredIndices.delete(key),this.indexedMeasurementIndexDirty=!0)}}groupTopAt(index){return Math.max(0,this.offsetAt(index)-this.groupHeightAt(index))}rowBottomAt(index){return finiteAdd(this.offsetAt(index),this.rowHeightAt(index))}entryTopAt(index){return this.groupTopAt(index)}findIndexAtOrAfter(offset){let lo=0,hi=this.itemCount-1;for(;lo<hi;){const mid=lo+Math.floor((hi-lo)/2);this.rowBottomAt(mid)<=offset?lo=mid+1:hi=mid}return lo}findIndexAtOrBefore(offset){let lo=0,hi=this.itemCount-1;for(;lo<hi;){const mid=lo+Math.ceil((hi-lo)/2);this.entryTopAt(mid)<offset?lo=mid:hi=mid-1}return lo}offsetForIndex(index){const clamped=Math.min(this.itemCount,Math.max(0,Math.trunc(index)||0));return this.offsetAt(clamped)}indexAtOffset(px){const n=this.itemCount;return n===0?-1:Number.isFinite(px)?Math.min(n-1,Math.max(0,this.findIndexAtOrAfter(px))):px>0?n-1:0}computeRange(){const n=this.itemCount;if(n===0){this.visibleStart=0,this.visibleEnd=-1,this.renderStart=0,this.renderEnd=-1;return}if(this.viewportHeight<=0){if(!this.renderUnmeasuredWindow){this.visibleStart=0,this.visibleEnd=-1,this.renderStart=0,this.renderEnd=-1;return}this.visibleStart=0,this.visibleEnd=0,this.renderStart=0,this.renderEnd=Math.min(n-1,normalizeOverscan(this.overscan));return}const viewTop=this.containerScrollTop,viewBottom=viewTop+this.viewportHeight;this.visibleStart=this.findIndexAtOrAfter(viewTop),this.visibleEnd=this.findIndexAtOrBefore(viewBottom);const overscan=normalizeOverscan(this.overscan);this.renderStart=Math.max(0,this.visibleStart-overscan),this.renderEnd=Math.min(n-1,this.visibleEnd+overscan),this.pruneIndexedMeasurements()&&this.computeRange()}limitCompositionWindow(){const profile=this.composition.profile;if(!profile||this.renderEnd<this.renderStart)return;const start=this.renderStart,end=this.renderEnd,focused=this.focusedRowOutsideWindow(!0),requested=this.compositionScrollTarget,anchor=requested!==void 0&&requested>=start&&requested<=end?requested:Math.max(start,this.visibleStart),range=budget=>{this.renderStart=Math.max(start,Math.min(anchor-Math.min(normalizeOverscan(this.overscan),budget-1),end-budget+1)),this.renderEnd=Math.min(end,this.renderStart+budget-1)};range(profile.maxRows),focused>=0&&(focused<this.renderStart||focused>this.renderEnd)&&range(profile.maxRows-1)}setCompositionScrollTarget(index){if(!this.composition.profile||this.compositionScrollTarget===index)return;const previous=this.compositionScrollTarget;this.compositionScrollTarget=index,this.requestUpdate("compositionScrollTarget",previous)}attachContainerListeners(){const base=this.scrollContainer,ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!base||!this.isConnected||!ownerWindow)return;this.containerResizeObserver?.disconnect(),this.containerResizeObserver=void 0,this.detachContainerListeners();const external=this.externalScroller;if(external&&ownerWindow.MutationObserver){const observer=new ownerWindow.MutationObserver(this.invalidateExternalGeometry);for(let ancestor=this;ancestor;ancestor=composedParentElement(ancestor))observer.observe(ancestor,{attributes:!0,attributeFilter:["style","class"]});this.externalStyleObserver=observer}const scrollTarget=external??base,generation=this.ownerRealmGeneration,ResizeObserverCtor=ownerWindow.ResizeObserver;if(ResizeObserverCtor){const observer=new ResizeObserverCtor(entries=>{if(this.containerResizeObserver!==observer||this.scrollListenerTarget!==scrollTarget||!this.isCurrentOwnerWork(ownerDocument,generation))return;if(this.beginResizeDelivery(),external){this.externalGeometry=void 0,this.syncExternalScrollMetrics();return}const entry=entries[0];entry&&(this.viewportHeight=entry.borderBoxSize?.[0]?.blockSize??entry.contentRect.height)});this.containerResizeObserver=observer,observer.observe(base),external&&!isWindowScroller(external)&&observer.observe(external)}scrollTarget.addEventListener("scroll",this.onScroll,{passive:!0}),scrollTarget.addEventListener("wheel",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("pointerdown",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("touchstart",this.onUserScrollIntent,{passive:!0}),scrollTarget.addEventListener("keydown",this.onUserScrollIntent),this.scrollListenerTarget=scrollTarget,external&&isWindowScroller(external)&&(external.addEventListener("resize",this.onExternalViewportResize,{passive:!0}),this.viewportResizeTarget=external),ownerWindow.queueMicrotask(()=>{if(this.scrollListenerTarget!==scrollTarget||this.scrollContainer!==base||!this.isCurrentOwnerWork(ownerDocument,generation))return;const metrics=this.readScrollMetrics();metrics&&(this.viewportHeight!==metrics.viewportHeight&&(this.viewportHeight=metrics.viewportHeight),this.containerScrollTop!==metrics.scrollTop&&(this.containerScrollTop=metrics.scrollTop))})}detachContainerListeners(){this.scrollRoundingAnchor=void 0,this.externalStyleObserver?.disconnect(),this.externalStyleObserver=void 0,this.externalGeometry=void 0;const viewportTarget=this.viewportResizeTarget;viewportTarget&&(viewportTarget.removeEventListener("resize",this.onExternalViewportResize),this.viewportResizeTarget=void 0);const target=this.scrollListenerTarget;target&&(target.removeEventListener("scroll",this.onScroll),target.removeEventListener("wheel",this.onUserScrollIntent),target.removeEventListener("pointerdown",this.onUserScrollIntent),target.removeEventListener("touchstart",this.onUserScrollIntent),target.removeEventListener("keydown",this.onUserScrollIntent))}applyPendingRowMeasurements(){if(this.pendingRowMeasurements.size===0)return;const observations=[...this.pendingRowMeasurements];if(this.pendingRowMeasurements.clear(),this.fixedRowHeight!=null)return;const base=this.scrollContainer,oldScrollTop=this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop;let scrollAdjustment=0,changed=!1;const indexed=isIndexedSource(this.effectiveSource),measuredByIndex=indexed?new Map:void 0;if(measuredByIndex)for(const[identity,index]of this.measuredIndices)measuredByIndex.set(index,identity);for(const[key,{index,height}]of observations){if(indexed&&(index<0||index>=this.itemCount||this.identityAt(index)!==key))continue;const previousKey=measuredByIndex?.get(index)??key,prev=this.measuredHeights.get(previousKey),replaced=previousKey!==key;if(replaced||prev===void 0||Math.abs(prev-height)>.5){const oldHeight=prev??DEFAULT_ROW_ESTIMATE_PX,oldBottom=indexed?finiteAdd(this.offsetAt(index),oldHeight):this.rowBottomAt(index);this.offsetDirtyStart=Math.min(this.offsetDirtyStart,index),replaced&&(this.measuredHeights.delete(previousKey),this.measuredIndices.delete(previousKey)),this.measuredHeights.set(key,height),this.measuredIndices.set(key,index),measuredByIndex?.set(index,key),oldBottom<=oldScrollTop&&(scrollAdjustment+=height-oldHeight),changed=!0}}if(changed){if(this.indexedMeasurementIndexDirty=!0,base&&scrollAdjustment!==0){const nextScrollTop=oldScrollTop+scrollAdjustment;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}this.offsetsDirty=!0,this.measurementGeneration+=1,super.requestUpdate()}}applyPendingGroupMeasurements(){if(this.pendingGroupMeasurements.size===0)return;const observations=[...this.pendingGroupMeasurements];this.pendingGroupMeasurements.clear();const base=this.scrollContainer,oldScrollTop=this.readScrollMetrics()?.rawScrollTop??this.containerScrollTop;let scrollAdjustment=0,changed=!1;for(const[index,height]of observations){if(!this.normalizedGroupByIndex.has(index))continue;const previous=this.measuredGroupHeights.get(index)??DEFAULT_GROUP_ESTIMATE_PX;if(Math.abs(previous-height)<=.5)continue;const oldRowTop=this.offsetAt(index);this.offsetDirtyStart=Math.min(this.offsetDirtyStart,index),this.groupPrefixDirty=!0,this.measuredGroupHeights.set(index,height),oldRowTop<=oldScrollTop&&(scrollAdjustment+=height-previous),changed=!0}if(changed){if(base&&scrollAdjustment!==0){const nextScrollTop=oldScrollTop+scrollAdjustment;this.applyScrollPosition(nextScrollTop),this.containerScrollTop=Math.max(0,nextScrollTop),this.pendingScrollTop=null}this.offsetsDirty=!0,this.measurementGeneration+=1,super.requestUpdate()}}get defersMeasurementApplication(){return this.inResizeDelivery&&this.externalScroller!==void 0}beginResizeDelivery(){if(this.inResizeDelivery=!0,this.rowObserveRafId!==void 0)return;const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!ownerWindow||!this.isConnected){this.inResizeDelivery=!1;return}const generation=this.ownerRealmGeneration,handle=ownerWindow.requestAnimationFrame(()=>{if(this.rowObserveRafId!==handle||this.rowObserveRafOwner!==ownerWindow||this.rowObserveRafDocument!==ownerDocument||!this.isCurrentOwnerWork(ownerDocument,generation))return;this.rowObserveRafId=void 0,this.rowObserveRafOwner=void 0,this.rowObserveRafDocument=void 0,this.inResizeDelivery=!1;const ro=this.rowResizeObserver;for(const[identity,el]of this.deferredRowObservations)ro&&this.observedRows.get(identity)===el&&ro.observe(el);this.deferredRowObservations.clear();const groupObserver=this.groupResizeObserver;for(const[index,el]of this.deferredGroupObservations)groupObserver&&this.observedGroups.get(index)===el&&groupObserver.observe(el);this.deferredGroupObservations.clear(),this.applyPendingRowMeasurements(),this.applyPendingGroupMeasurements()});this.rowObserveRafId=handle,this.rowObserveRafOwner=ownerWindow,this.rowObserveRafDocument=ownerDocument}syncRowObservers(){const ro=this.rowResizeObserver;if(!ro)return;if(this.fixedRowHeight!=null){for(const el of this.observedRows.values())ro.unobserve(el);this.observedRows.clear(),this.deferredRowObservations.clear();return}const current=new Map;for(const{identity,index}of this.renderedWindow){const el=this.rowElements.get(identity);el&&(current.set(identity,el),this.observedRowKeys.set(el,identity),this.observedRowIndices.set(el,index))}for(const[identity,el]of this.observedRows)current.get(identity)!==el&&(ro.unobserve(el),this.observedRows.delete(identity),this.deferredRowObservations.delete(identity));for(const[identity,el]of current)this.observedRows.has(identity)||(this.observedRows.set(identity,el),this.inResizeDelivery?this.deferredRowObservations.set(identity,el):ro.observe(el))}syncGroupObservers(){const observer=this.groupResizeObserver;if(!observer)return;const current=new Map;for(const[index,marker]of this.groupElements)current.set(index,marker),this.observedGroupIndices.set(marker,index);for(const[index,marker]of this.observedGroups)current.get(index)!==marker&&(observer.unobserve(marker),this.observedGroups.delete(index),this.deferredGroupObservations.delete(index));for(const[index,marker]of current)this.observedGroups.has(index)||(this.observedGroups.set(index,marker),this.inResizeDelivery?this.deferredGroupObservations.set(index,marker):observer.observe(marker))}get stickyInset(){return this.renderStickyGroup?this.stickyHeight:0}scrollActiveIntoView(){const index=this.activeIndex;if(index<0)return;const behavior=prefersReducedMotion(this)?"auto":"smooth";this.performScrollTo(index,"auto",behavior)&&this.beginPendingScrollCorrection(index,"auto",behavior,this.activeItemId)}scrollToIndex(index,options){const n=this.itemCount;if(n===0)return;const clamped=finiteInteger(index,0,0,n-1);this.setCompositionScrollTarget(clamped);const align=options?.align??"auto",behavior=prefersReducedMotion(this)?"auto":options?.behavior??"smooth";this.performScrollTo(clamped,align,behavior)?this.beginPendingScrollCorrection(clamped,align,behavior):this.pendingScrollCorrection=void 0}hasUnmeasuredGroupThrough(index){return this.normalizedGroups.some(group=>group.startIndex<=index&&group.label!==""&&!this.measuredGroupHeights.has(group.startIndex))}beginPendingScrollCorrection(index,align,behavior,activeItemId){if(this.fixedRowHeight!=null&&!this.hasUnmeasuredGroupThrough(index)){this.pendingScrollCorrection=void 0;return}this.pendingScrollCorrection={identity:this.identityAt(index),index,align,behavior,source:this.effectiveSource,keyFunction:this.keyFunction,activeItemId:activeItemId===""?void 0:activeItemId,lastMeasurementGeneration:this.measurementGeneration}}performScrollTo(index,align,behavior){const metrics=this.readScrollMetrics();if(!metrics)return!1;const inset=this.stickyInset,top=this.offsetAt(index),bottom=this.rowBottomAt(index),viewTop=metrics.rawScrollTop,viewBottom=viewTop+metrics.viewportHeight;let target=null;return align==="start"?target=top-inset:align==="end"?target=bottom-metrics.viewportHeight:top-inset<viewTop?target=top-inset:bottom>viewBottom&&(target=bottom-metrics.viewportHeight),target===null?!1:(this.applyScrollPosition(target,behavior),!0)}maybeCorrectPendingScroll(){const pending=this.pendingScrollCorrection;if(!pending||pending.lastMeasurementGeneration>=this.measurementGeneration)return;if(pending.source!==this.effectiveSource||pending.keyFunction!==this.keyFunction||pending.activeItemId!==void 0&&!Object.is(pending.activeItemId,this.activeItemId)){this.pendingScrollCorrection=void 0;return}const index=pending.activeItemId!==void 0?this.activeIndex:isIndexedSource(this.effectiveSource)?pending.index:this.identityIndices.get(pending.identity)??-1;if(index<0||index>=this.itemCount||this.identityAt(index)!==pending.identity){this.pendingScrollCorrection=void 0;return}this.performScrollTo(index,pending.align,pending.behavior),pending.index=index,pending.lastMeasurementGeneration=this.measurementGeneration,(this.fixedRowHeight!=null||this.measuredHeights.has(pending.identity))&&!this.hasUnmeasuredGroupThrough(index)&&(this.pendingScrollCorrection=void 0)}emitRangeChangeIfNeeded(){if(this.visibleEnd<this.visibleStart){this.lastEmittedStart=-1,this.lastEmittedEnd=-1;return}this.visibleStart===this.lastEmittedStart&&this.visibleEnd===this.lastEmittedEnd||(this.lastEmittedStart=this.visibleStart,this.lastEmittedEnd=this.visibleEnd,this.emit("lr-visible-range-change",{start:this.visibleStart,end:this.visibleEnd}))}maybeFireLoadMore(){const n=this.itemCount;if(!(n>0&&this.visibleEnd>=n-1)){this.loadMoreArmed=!0;return}!this.hasMore||this.loading||!this.loadMoreArmed||(this.loadMoreArmed=!1,this.emit("lr-load-more"))}get projectionActive(){return!this.projectionDeferred&&this.rowProjection==="light"}rowSlotName(identity){return`${tag("virtual-list")}-row-${identity}`}syncRowProjection(){if(!this.projectionActive||!this.isConnected){this.projectionAnchor!==void 0&&this.teardownRowProjection();return}const anchor=this.ensureProjectionAnchor();this.projectionPart=render(this.renderProjectedRows(),this,{renderBefore:anchor,host:this})}ensureProjectionAnchor(){const existing=this.projectionAnchor;if(existing!==void 0&&existing.parentNode===this&&existing.ownerDocument===this.ownerDocument)return existing;existing!==void 0&&this.teardownRowProjection();const anchor=this.ownerDocument.createComment(PROJECTION_ANCHOR_MARKER);return this.append(anchor),this.projectionAnchor=anchor,this.projectionPart=void 0,anchor}teardownRowProjection(){const anchor=this.projectionAnchor,part=this.projectionPart;if(this.projectionAnchor=void 0,this.projectionPart=void 0,anchor!==void 0){if(part!==void 0){const container=anchor.parentNode;container!==null&&render(nothing,container,{renderBefore:anchor,host:this});const start=part.startNode;start?.parentNode?.removeChild(start)}anchor.parentNode?.removeChild(anchor)}}renderProjectedRows(){return repeat(this.renderedWindow,w=>w.identity,w=>staticHtml`<div
           ${ROW_ATTRIBUTE_STATIC}
           slot=${this.rowSlotName(w.identity)}
           data-row-index=${w.index}
-          data-row-key=${domKeyToken(this.keyOf(w.item,w.index))}
-        >${this.renderItem(w.item,w.index)}</div>`)}focusedRowOutsideWindow(){for(let node=deepActiveElementIn(this.ownerDocument);node&&node!==this;node=composedParentElement(node)){if(node.getAttribute("part")!=="row"||node.getRootNode()!==this.renderRoot)continue;const index=Number(node.getAttribute("data-row-index"));return Number.isInteger(index)&&index>=0&&index<this.itemCount&&(index<this.renderStart||index>this.renderEnd)&&node.getAttribute("data-row-key")===domKeyToken(this.keyOf(this.itemAt(index),index))?index:-1}return-1}renderRow(item,index,total,activeIndex,identity){const key=this.keyOf(item,index),top=this.offsetAt(index),isActive=index===activeIndex,isRowMode=this.itemRole==="row";return html`
+          data-row-key=${domKeyToken(w.key)}
+        >${this.renderItem(w.item,w.index)}</div>`)}focusedRowOutsideWindow(includeInside=!1){for(let node=deepActiveElementIn(this.ownerDocument);node&&node!==this;node=composedParentElement(node)){if(node.getAttribute("part")!=="row"||node.getRootNode()!==this.renderRoot)continue;const index=Number(node.getAttribute("data-row-index"));return Number.isInteger(index)&&index>=0&&index<this.itemCount&&(includeInside||index<this.renderStart||index>this.renderEnd)&&node.getAttribute("data-row-key")===domKeyToken(this.keyOf(this.itemAt(index),index))?index:-1}return-1}renderRow(item,index,total,activeIndex,identity,key){let top=this.physicalRowOffset(this.offsetAt(index));if(this.scrollScale()>1&&(index<this.renderStart||index>this.renderEnd)){const height=this.rowHeightAt(index);top=Math.max(-height,Math.min(MAX_SCROLL_EXTENT_PX-height,top))}const isActive=index===activeIndex,isRowMode=this.itemRole==="row",transparent=this.composition.profile!==void 0;return html`
       <div
         part="row"
-        role=${isRowMode?"row":"listitem"}
+        ${ref(element=>{element?this.rowElements.set(identity,element):this.rowElements.delete(identity)})}
+        role=${transparent?"presentation":isRowMode?"row":"listitem"}
         data-row-key=${domKeyToken(key)}
         data-row-index=${index}
-        aria-setsize=${isRowMode?nothing:total}
-        aria-posinset=${isRowMode?nothing:index+1}
-        aria-rowindex=${isRowMode?this.computedAriaRowIndex(index):nothing}
-        aria-current=${isActive?"true":"false"}
+        aria-setsize=${transparent||isRowMode?nothing:total}
+        aria-posinset=${transparent||isRowMode?nothing:index+1}
+        aria-rowindex=${!transparent&&isRowMode?this.computedAriaRowIndex(index):nothing}
+        aria-current=${transparent?nothing:isActive?"true":"false"}
         style=${styleMap({transform:`translateY(${top}px)`,"--_lr-virtual-list-row-offset":`${top}px`})}
       >
         ${this.projectionActive?html`<slot name=${this.rowSlotName(identity)}></slot>`:this.renderItem(item,index)}
       </div>
-    `}recomputeGroups(){const normalized=[],seen=new Set;try{const groups=this.groups;if(!Array.isArray(groups))throw new TypeError("groups must be an array");const length=getOwnDataDescriptor(groups,"length");if(length===MISSING_OWN_DATA_DESCRIPTOR||length===UNSAFE_OWN_DATA_DESCRIPTOR||typeof length.value!="number"||!Number.isSafeInteger(length.value)||length.value<0)throw new TypeError("groups must have a bounded length");for(let position=0;position<Math.min(length.value,MAX_VIRTUAL_LIST_GROUPS);position+=1){const entry=getOwnDataDescriptor(groups,String(position));if(entry===MISSING_OWN_DATA_DESCRIPTOR||entry===UNSAFE_OWN_DATA_DESCRIPTOR||entry.value===null||typeof entry.value!="object"||Array.isArray(entry.value))continue;const key=getOwnDataDescriptor(entry.value,"key"),label=getOwnDataDescriptor(entry.value,"label"),startIndex=getOwnDataDescriptor(entry.value,"startIndex");if(key===MISSING_OWN_DATA_DESCRIPTOR||key===UNSAFE_OWN_DATA_DESCRIPTOR||startIndex===MISSING_OWN_DATA_DESCRIPTOR||startIndex===UNSAFE_OWN_DATA_DESCRIPTOR||label===UNSAFE_OWN_DATA_DESCRIPTOR||typeof key.value!="string"&&typeof key.value!="number"||typeof startIndex.value!="number"||!Number.isInteger(startIndex.value)||startIndex.value<0||startIndex.value>=this.itemCount||seen.has(startIndex.value))continue;const labelValue=label===MISSING_OWN_DATA_DESCRIPTOR||typeof label.value!="string"?void 0:label.value;seen.add(startIndex.value),normalized.push(Object.freeze({key:key.value,startIndex:startIndex.value,...labelValue===void 0?{}:{label:labelValue}}))}}catch{}this.normalizedGroups=Object.freeze(normalized.sort((a,b)=>a.startIndex-b.startIndex)),this.normalizedGroupByIndex.clear();for(const group of this.normalizedGroups)this.normalizedGroupByIndex.set(group.startIndex,group)}renderGroups(){return this.normalizedGroups.slice(this.groupCountThrough(this.renderStart-1),this.groupCountThrough(this.renderEnd)).filter(group=>group.label!=="").map(group=>html`
+    `}recomputeGroups(){this.groupPrefixDirty=!0;const normalized=[],seen=new Set;try{const groups=this.groups;if(!Array.isArray(groups))throw new TypeError("groups must be an array");const length=getOwnDataDescriptor(groups,"length");if(length===MISSING_OWN_DATA_DESCRIPTOR||length===UNSAFE_OWN_DATA_DESCRIPTOR||typeof length.value!="number"||!Number.isSafeInteger(length.value)||length.value<0)throw new TypeError("groups must have a bounded length");for(let position=0;position<Math.min(length.value,MAX_VIRTUAL_LIST_GROUPS);position+=1){const entry=getOwnDataDescriptor(groups,String(position));if(entry===MISSING_OWN_DATA_DESCRIPTOR||entry===UNSAFE_OWN_DATA_DESCRIPTOR||entry.value===null||typeof entry.value!="object"||Array.isArray(entry.value))continue;const key=getOwnDataDescriptor(entry.value,"key"),label=getOwnDataDescriptor(entry.value,"label"),startIndex=getOwnDataDescriptor(entry.value,"startIndex");if(key===MISSING_OWN_DATA_DESCRIPTOR||key===UNSAFE_OWN_DATA_DESCRIPTOR||startIndex===MISSING_OWN_DATA_DESCRIPTOR||startIndex===UNSAFE_OWN_DATA_DESCRIPTOR||label===UNSAFE_OWN_DATA_DESCRIPTOR||typeof key.value!="string"&&typeof key.value!="number"||typeof startIndex.value!="number"||!Number.isInteger(startIndex.value)||startIndex.value<0||startIndex.value>=this.itemCount||seen.has(startIndex.value))continue;const labelValue=label===MISSING_OWN_DATA_DESCRIPTOR||typeof label.value!="string"?void 0:label.value;seen.add(startIndex.value),normalized.push(Object.freeze({key:key.value,startIndex:startIndex.value,...labelValue===void 0?{}:{label:labelValue}}))}}catch{}this.normalizedGroups=Object.freeze(normalized.sort((a,b)=>a.startIndex-b.startIndex)),this.normalizedGroupByIndex.clear();for(const group of this.normalizedGroups)this.normalizedGroupByIndex.set(group.startIndex,group)}renderGroups(){return this.normalizedGroups.slice(this.groupCountThrough(this.renderStart-1),this.groupCountThrough(this.renderEnd)).filter(group=>group.label!=="").map(group=>html`
             <div
               part="group"
+              ${ref(element=>{element?this.groupElements.set(group.startIndex,element):this.groupElements.delete(group.startIndex)})}
               data-group-index=${group.startIndex}
-              style=${styleMap({transform:`translateY(${this.groupTopAt(group.startIndex)}px)`})}
+              style=${styleMap({transform:`translateY(${this.physicalRowOffset(this.groupTopAt(group.startIndex))}px)`})}
             >
               ${group.label??(typeof group.key=="number"?getNumberFormat(this.effectiveLocale).format(group.key):group.key)}
             </div>
           `)}currentStickyGroup(){const groups=this.normalizedGroups;if(groups.length===0)return null;const scrollTop=this.containerScrollTop;let low=0,high=groups.length-1,current=-1;for(;low<=high;){const middle=low+high>>1;this.groupTopAt(groups[middle].startIndex)<=scrollTop?(current=middle,low=middle+1):high=middle-1}if(current<0)return{group:groups[0],shift:0,active:!1};const next=groups[current+1];let shift=0;if(next&&this.stickyHeight>0){const distance=this.groupTopAt(next.startIndex)-scrollTop;distance<this.stickyHeight&&(shift=Math.min(0,distance-this.stickyHeight))}return{group:groups[current],shift,active:!0}}renderStickyLayer(){const render2=this.renderStickyGroup;if(!render2)return nothing;const state2=this.currentStickyGroup();return state2?html`
       <div
         part="sticky-group"
+        ${ref(element=>{this.stickyElement=element})}
         aria-hidden="true"
         inert
         ?data-inactive=${!state2.active}
@@ -35,25 +38,26 @@ import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/co
       >
         ${render2(state2.group)}
       </div>
-    `:nothing}syncStickyOverlay(){const overlay=this.renderRoot.querySelector('[part="sticky-group"]');overlay!==this.observedSticky&&(this.observedSticky&&this.stickyResizeObserver?.unobserve(this.observedSticky),this.observedSticky=overlay??void 0,overlay&&this.stickyResizeObserver?.observe(overlay))}render(){const n=this.itemCount,totalHeight=this.offsetAt(n),windowed=[],add=i=>{const item=this.itemAt(i);windowed.push({item,index:i,identity:this.identityAt(i,item)})},pinned=this.pinnedRow=this.focusedRowOutsideWindow();pinned>=0&&pinned<this.renderStart&&add(pinned);for(let i=this.renderStart;i<=this.renderEnd;i++)add(i);pinned>this.renderEnd&&add(pinned),this.renderedWindow=windowed;const isRowMode=this.itemRole==="row",stickyInset=this.stickyInset,activeIndex=this.activeIndex,isExternallyScrolled=this.externalScroller!==void 0;return html`
+    `:nothing}syncStickyOverlay(){const overlay=this.stickyElement;overlay!==this.observedSticky&&(this.observedSticky&&this.stickyResizeObserver?.unobserve(this.observedSticky),this.observedSticky=overlay??void 0,overlay&&this.stickyResizeObserver?.observe(overlay))}render(){const n=this.itemCount,totalHeight=Math.min(MAX_SCROLL_EXTENT_PX,this.offsetAt(n));this.offsetAt(n)>MAX_SCROLL_EXTENT_PX&&devWarnOnce("virtual-list-scroll-scaling","Virtual list scroll travel is scaled to fit browser layout limits; row sizes and public offsets remain in logical pixels.");const windowed=[],add=i=>{const item=this.itemAt(i),key=isIndexedSource(this.effectiveSource)?this.keyOf(item,i):this.rowKeys[i]??this.keyOf(item,i),identity=isIndexedSource(this.effectiveSource)?this.rowIdentity(key,i):this.identityAt(i,item);windowed.push({item,index:i,identity,key})},pinned=this.pinnedRow=this.focusedRowOutsideWindow();this.composition.profile?.beforeRender?.(Object.freeze({start:this.renderStart,endExclusive:Math.max(this.renderStart,this.renderEnd+1),pinnedIndex:pinned>=0?pinned:null})),pinned>=0&&pinned<this.renderStart&&add(pinned);for(let i=this.renderStart;i<=this.renderEnd;i++)add(i);pinned>this.renderEnd&&add(pinned),this.renderedWindow=windowed;const isRowMode=this.itemRole==="row",transparent=this.composition.profile!==void 0,stickyInset=this.stickyInset,activeIndex=this.activeIndex,isExternallyScrolled=this.externalScroller!==void 0;return html`
       <div
         part="base"
-        role=${isRowMode?"rowgroup":"list"}
+        role=${transparent?"presentation":isRowMode?"rowgroup":"list"}
         ?data-external-scroll=${isExternallyScrolled}
         ?data-lr-no-top-layer=${this.noTopLayer}
-        tabindex=${isExternallyScrolled?nothing:"0"}
+        tabindex=${transparent||isExternallyScrolled?nothing:"0"}
         style=${stickyInset>0?`scroll-padding-block-start:${stickyInset}px`:nothing}
-        aria-label=${this.hasAttribute("aria-label")?this.getAttribute("aria-label"):nothing}
-        aria-busy=${this.loading?"true":"false"}
+        aria-label=${!transparent&&this.hasAttribute("aria-label")?this.getAttribute("aria-label"):nothing}
+        aria-busy=${transparent?nothing:this.loading?"true":"false"}
         @focusout=${this.onFocusOut}
       >
         <div
           part="spacer"
-          role=${isRowMode?"presentation":nothing}
+          data-item-count=${n}
+          role=${transparent||isRowMode?"presentation":nothing}
           style=${styleMap({height:`${totalHeight}px`})}
         >
           ${this.renderGroups()}
-          ${repeat(windowed,w=>w.identity,w=>this.renderRow(w.item,w.index,n,activeIndex,w.identity))}
+          ${repeat(windowed,w=>w.identity,w=>this.renderRow(w.item,w.index,n,activeIndex,w.identity,w.key))}
           ${this.renderStickyLayer()}
         </div>
       </div>

package/dist/components/media/av-player/av-cue-index.js

@@ -0,0 +1 @@
+import{finiteRange}from"../../../internal/numbers.js";class AvCueIndex{constructor(cues,duration){this.boundaries=[-1/0],this.winners=[-1],this.cursor=0;const max=duration>0?duration:1/0,starts=[...new Set(cues.map(cue=>cue.start))].sort((a,b)=>a-b),nextStarts=new Map(starts.map((start,index)=>[start,starts[index+1]??1/0])),events=[];cues.forEach((cue,index)=>{const start=finiteRange(cue.start,0,0,max),next=nextStarts.get(cue.start)??1/0,end=cue.end==null?start>=max||next===1/0?1/0:Math.min(next,max):finiteRange(cue.end,start,start,max);end>start&&(events.push({time:start,index,start,opening:!0}),events.push({time:end,index,start,opening:!1}))}),events.sort((a,b)=>a.time-b.time||Number(a.opening)-Number(b.opening));const live=new Set,heap=[],higher=(a,b)=>a.start>b.start||a.start===b.start&&a.index>b.index,push=event=>{let position=heap.length;for(heap.push(event);position>0;){const parent=Math.floor((position-1)/2);if(!higher(event,heap[parent]))break;heap[position]=heap[parent],position=parent}heap[position]=event},pop=()=>{const last=heap.pop();if(heap.length===0)return;let position=0;for(;position*2+1<heap.length;){let child=position*2+1;if(child+1<heap.length&&higher(heap[child+1],heap[child])&&(child+=1),!higher(heap[child],last))break;heap[position]=heap[child],position=child}heap[position]=last};for(let offset=0;offset<events.length;){const time=events[offset].time;do{const event=events[offset++];event.opening?(live.add(event.index),push(event)):live.delete(event.index)}while(offset<events.length&&events[offset].time===time);for(;heap.length>0&&!live.has(heap[0].index);)pop();const winner=heap[0]?.index??-1;winner!==this.winners[this.winners.length-1]&&(this.boundaries.push(time),this.winners.push(winner))}}at(time){if(!Number.isFinite(time))return-1;if(time>=this.boundaries[this.cursor]&&time<(this.boundaries[this.cursor+1]??1/0))return this.winners[this.cursor];let low=0,high=this.boundaries.length;for(;low<high;){const middle=low+Math.floor((high-low)/2);this.boundaries[middle]<=time?low=middle+1:high=middle}return this.cursor=low-1,this.winners[this.cursor]}}export{AvCueIndex};

package/dist/components/media/av-player/av-cue-source.d.ts

@@ -0,0 +1,13 @@
+import type{LyraSourceRevision}from'../../../data-sources.js';import type{LyraSourceRequest,LyraSourceValue}from'../../../utilities/data-preparation.js';import{type LyraAvCue}from'./av-metadata.js';
+/** Full transcript indexing is provider-owned. IDs are globally unique within a revision.
+* Methods and metadata must be own data properties. Replace/rebind after changing the source. */
+export interface LyraAvCueSource{readonly revision:LyraSourceRevision;readonly count:number;getCue(index:number,request:LyraSourceRequest):LyraSourceValue<LyraAvCue|null>;findCue(cueId:string,request:LyraSourceRequest):LyraSourceValue<{readonly index:number;readonly cue:LyraAvCue;}|null>;activeAt(time:number,request:LyraSourceRequest):LyraSourceValue<LyraAvActiveCue>;search(query:string,request:LyraSourceRequest&{readonly locale:string;}):LyraSourceValue<LyraAvCueSearch>;}
+/** Greatest start, then later original index, wins within [start,end). An omitted cue end is
+* resolved by the provider. Bounds describe one complete answer interval, including no-active. */
+export interface LyraAvActiveCue{readonly index:number|null;readonly cue:LyraAvCue|null;readonly validFrom:number;readonly validUntil:number;}
+/** Exact full-source matches in provider order; each original source index occurs at most once. */
+export interface LyraAvCueSearch{readonly count:number;getMatch(matchIndex:number,request:LyraSourceRequest):LyraSourceValue<{readonly index:number;readonly cue:LyraAvCue;}>;}export declare function captureCueSource(value:unknown):LyraAvCueSource;
+/** Strict provider admission never truncates text, coerces timestamps, or compacts positions. */
+export declare function captureSourceCue(value:unknown):LyraAvCue;export declare function captureCueLocation(value:unknown,count:number):{readonly index:number;readonly cue:LyraAvCue;};export declare function captureActiveCue(value:unknown,count:number,time:number):LyraAvActiveCue;export declare function sameSourceCue(left:LyraAvCue,right:LyraAvCue):boolean;
+/** Capture the exact-count handle without enumerating any matches or invoking field accessors. */
+export declare function captureCueSearch(value:unknown,sourceSize:number):LyraAvCueSearch;export declare function sourceCueMatches(cue:LyraAvCue,query:string,locale:string):boolean;

package/dist/components/media/av-player/av-cue-source.js

@@ -0,0 +1 @@
+import{resolveIntlLocale}from"../../../internal/intl-cache.js";import{sourceCount,sourceRevision}from"../../../internal/source-request-controller.js";import{MAX_CUE_ID_CHARS,MAX_CUE_TEXT_CHARS,MAX_CUE_SPEAKER_CHARS}from"./av-metadata.js";function cueField(value,name,optional=!1){if(!value||typeof value!="object")throw new TypeError("Invalid cue source record");const descriptor=Object.getOwnPropertyDescriptor(value,name);if(!(!descriptor&&optional)){if(!descriptor||!("value"in descriptor))throw new TypeError("Invalid cue source field");return descriptor.value}}function captureCueSource(value){const revision=sourceRevision(cueField(value,"revision")),count=sourceCount(cueField(value,"count")),getCue=cueField(value,"getCue"),findCue=cueField(value,"findCue"),activeAt=cueField(value,"activeAt"),search=cueField(value,"search");if(typeof getCue!="function"||typeof findCue!="function"||typeof activeAt!="function"||typeof search!="function")throw new TypeError("Invalid cue source methods");return Object.freeze({revision,count,getCue:getCue.bind(value),findCue:findCue.bind(value),activeAt:activeAt.bind(value),search:search.bind(value)})}const OWNED_SOURCE_CUES=new WeakSet;function captureSourceCue(value){if(typeof value=="object"&&value!==null&&OWNED_SOURCE_CUES.has(value))return value;const cueId=cueField(value,"cueId"),start=cueField(value,"start"),end=cueField(value,"end",!0),text=cueField(value,"text"),speaker=cueField(value,"speaker",!0);if(typeof cueId!="string"||!cueId||cueId!==cueId.trim()||cueId.length>MAX_CUE_ID_CHARS||typeof start!="number"||!Number.isFinite(start)||start<0||end!==void 0&&(typeof end!="number"||!Number.isFinite(end)||end<start)||typeof text!="string"||text.length>MAX_CUE_TEXT_CHARS||speaker!==void 0&&(typeof speaker!="string"||speaker.length>MAX_CUE_SPEAKER_CHARS))throw new TypeError("Invalid source cue");const cue=Object.freeze({cueId,start,text,...end!==void 0?{end}:{},...speaker!==void 0?{speaker}:{}});return OWNED_SOURCE_CUES.add(cue),cue}function captureCueLocation(value,count){const index=sourceCount(cueField(value,"index"));if(index>=count)throw new RangeError("Invalid cue index");return Object.freeze({index,cue:captureSourceCue(cueField(value,"cue"))})}function captureActiveCue(value,count,time){const validFrom=cueField(value,"validFrom"),validUntil=cueField(value,"validUntil");if(typeof validFrom!="number"||typeof validUntil!="number"||!(validFrom<validUntil)||!(time>=validFrom&&time<validUntil))throw new RangeError("Invalid cue validity interval");const index=cueField(value,"index"),cue=cueField(value,"cue");if(index===null&&cue===null)return Object.freeze({index,cue,validFrom,validUntil});const location=captureCueLocation({index,cue},count);if(time<location.cue.start||location.cue.end!==void 0&&time>=location.cue.end)throw new RangeError("Inactive source cue");return Object.freeze({...location,validFrom,validUntil})}function sameSourceCue(left,right){return left.cueId===right.cueId&&left.start===right.start&&left.end===right.end&&left.text===right.text&&left.speaker===right.speaker}function captureCueSearch(value,sourceSize){const count=sourceCount(cueField(value,"count")),getMatch=cueField(value,"getMatch");if(count>sourceSize||typeof getMatch!="function")throw new TypeError("Invalid cue search");return Object.freeze({count,getMatch:getMatch.bind(value)})}function sourceCueMatches(cue,query,locale){const effectiveIntlLocale=resolveIntlLocale(locale),folded=query.toLocaleLowerCase(effectiveIntlLocale);return folded.length>0&&(cue.text.toLocaleLowerCase(effectiveIntlLocale).includes(folded)||(cue.speaker??"").toLocaleLowerCase(effectiveIntlLocale).includes(folded))}export{captureActiveCue,captureCueLocation,captureCueSearch,captureCueSource,captureSourceCue,sameSourceCue,sourceCueMatches};

package/dist/components/media/av-player/av-metadata.d.ts

@@ -1,10 +1,10 @@
 /** One synced transcript entry. `end` is exclusive; an omitted `end` extends to the next strictly chronological
 * start (or forever, for the last one). Equal starts do not end one another; caller order is
-* retained. The player indexes starts on assignment so playback reconciliation stays linear. Cue collections require a trimmed nonempty `cueId` and retain the
+* retained. The player builds a bounded interval index so playback reconciliation uses logarithmic lookup. Cue collections require a trimmed nonempty `cueId` and retain the
 * first occurrence when IDs repeat. */
 export interface LyraAvCue{readonly cueId:string;readonly start:number;readonly end?:number;readonly text:string;readonly speaker?:string;}
 /** A native `<track>` source (subtitles/captions/descriptions). */
-export interface LyraAvTrack{readonly src:string;readonly kind:'subtitles'|'captions'|'descriptions';readonly srclang:string;readonly label:string;readonly default?:boolean;}export declare const EMPTY_LYRA_AV_CUES:readonly LyraAvCue[];export declare const EMPTY_LYRA_AV_TRACKS:readonly LyraAvTrack[];
+export interface LyraAvTrack{readonly src:string;readonly kind:'subtitles'|'captions'|'descriptions';readonly srclang:string;readonly label:string;readonly default?:boolean;}export declare const MAX_CUE_ID_CHARS=256;export declare const MAX_CUE_TEXT_CHARS=100000;export declare const MAX_CUE_SPEAKER_CHARS=4096;export declare const EMPTY_LYRA_AV_CUES:readonly LyraAvCue[];export declare const EMPTY_LYRA_AV_TRACKS:readonly LyraAvTrack[];
 /** Clones, validates, bounds, and freezes transcript cues. */
 export declare function snapshotLyraAvCues(value:unknown):readonly LyraAvCue[];
 /** Clones, validates, bounds, and freezes native text-track metadata. */

package/dist/components/media/av-player/av-metadata.js

@@ -1 +1 @@
-import{finiteNumber}from"../../../internal/numbers.js";const MAX_LYRA_AV_CUES=1e4,MAX_LYRA_AV_TRACKS=64,MAX_CUE_ID_CHARS=256,MAX_CUE_TEXT_CHARS=1e5,MAX_CUE_SPEAKER_CHARS=4096,MAX_TRACK_SRC_CHARS=16384,MAX_TRACK_LANGUAGE_CHARS=128,MAX_TRACK_LABEL_CHARS=4096,OWNED_AV_METADATA_COLLECTIONS=new WeakSet;function ownedSnapshot(values){const snapshot=Object.freeze(values);return OWNED_AV_METADATA_COLLECTIONS.add(snapshot),snapshot}const EMPTY_LYRA_AV_CUES=ownedSnapshot([]),EMPTY_LYRA_AV_TRACKS=ownedSnapshot([]);function normalizeArray(value,limit,normalize,fallback){try{if(!Array.isArray(value))return fallback;if(OWNED_AV_METADATA_COLLECTIONS.has(value))return value;const result=[],length=Math.min(value.length,limit);for(let index=0;index<length;index+=1)try{const normalized=normalize(value[index]);normalized!==void 0&&result.push(normalized)}catch{}return ownedSnapshot(result)}catch{return fallback}}function snapshotLyraAvCues(value){const seenIds=new Set;return normalizeArray(value,MAX_LYRA_AV_CUES,candidate=>{if(candidate===null||typeof candidate!="object")return;const record=candidate;if(typeof record.cueId!="string"||typeof record.text!="string")return;const cueId=record.cueId.trim();if(!cueId||cueId.length>MAX_CUE_ID_CHARS||seenIds.has(cueId))return;seenIds.add(cueId);const rawStart=record.start,start=Math.max(0,finiteNumber(typeof rawStart=="number"?rawStart:0,0)),rawEnd=record.end,end=typeof rawEnd=="number"&&Number.isFinite(rawEnd)?Math.max(start,rawEnd):void 0,rawSpeaker=record.speaker,speaker=typeof rawSpeaker=="string"?rawSpeaker.slice(0,MAX_CUE_SPEAKER_CHARS):void 0;return Object.freeze({cueId,start,text:record.text.slice(0,MAX_CUE_TEXT_CHARS),...end!==void 0?{end}:{},...speaker!==void 0?{speaker}:{}})},EMPTY_LYRA_AV_CUES)}function snapshotLyraAvTracks(value){return normalizeArray(value,MAX_LYRA_AV_TRACKS,candidate=>{if(candidate===null||typeof candidate!="object")return;const record=candidate;if(!(typeof record.src!="string"||record.kind!=="subtitles"&&record.kind!=="captions"&&record.kind!=="descriptions"||typeof record.srclang!="string"||typeof record.label!="string"))return Object.freeze({src:record.src.slice(0,MAX_TRACK_SRC_CHARS),kind:record.kind,srclang:record.srclang.slice(0,MAX_TRACK_LANGUAGE_CHARS),label:record.label.slice(0,MAX_TRACK_LABEL_CHARS),default:record.default===!0})},EMPTY_LYRA_AV_TRACKS)}function hasSearchableLyraAvCues(cues){return cues.some(cue=>!!(cue.text.trim()||cue.speaker?.trim()))}export{EMPTY_LYRA_AV_CUES,EMPTY_LYRA_AV_TRACKS,hasSearchableLyraAvCues,snapshotLyraAvCues,snapshotLyraAvTracks};
+import{finiteNumber}from"../../../internal/numbers.js";const MAX_LYRA_AV_CUES=1e4,MAX_LYRA_AV_TRACKS=64,MAX_CUE_ID_CHARS=256,MAX_CUE_TEXT_CHARS=1e5,MAX_CUE_SPEAKER_CHARS=4096,MAX_TRACK_SRC_CHARS=16384,MAX_TRACK_LANGUAGE_CHARS=128,MAX_TRACK_LABEL_CHARS=4096,OWNED_AV_METADATA_COLLECTIONS=new WeakSet;function ownedSnapshot(values){const snapshot=Object.freeze(values);return OWNED_AV_METADATA_COLLECTIONS.add(snapshot),snapshot}const EMPTY_LYRA_AV_CUES=ownedSnapshot([]),EMPTY_LYRA_AV_TRACKS=ownedSnapshot([]);function normalizeArray(value,limit,normalize,fallback){try{if(!Array.isArray(value))return fallback;if(OWNED_AV_METADATA_COLLECTIONS.has(value))return value;const result=[],length=Math.min(value.length,limit);for(let index=0;index<length;index+=1)try{const normalized=normalize(value[index]);normalized!==void 0&&result.push(normalized)}catch{}return ownedSnapshot(result)}catch{return fallback}}function snapshotLyraAvCues(value){const seenIds=new Set;return normalizeArray(value,MAX_LYRA_AV_CUES,candidate=>{if(candidate===null||typeof candidate!="object")return;const record=candidate;if(typeof record.cueId!="string"||typeof record.text!="string")return;const cueId=record.cueId.trim();if(!cueId||cueId.length>MAX_CUE_ID_CHARS||seenIds.has(cueId))return;seenIds.add(cueId);const rawStart=record.start,start=Math.max(0,finiteNumber(typeof rawStart=="number"?rawStart:0,0)),rawEnd=record.end,end=typeof rawEnd=="number"&&Number.isFinite(rawEnd)?Math.max(start,rawEnd):void 0,rawSpeaker=record.speaker,speaker=typeof rawSpeaker=="string"?rawSpeaker.slice(0,MAX_CUE_SPEAKER_CHARS):void 0;return Object.freeze({cueId,start,text:record.text.slice(0,MAX_CUE_TEXT_CHARS),...end!==void 0?{end}:{},...speaker!==void 0?{speaker}:{}})},EMPTY_LYRA_AV_CUES)}function snapshotLyraAvTracks(value){return normalizeArray(value,MAX_LYRA_AV_TRACKS,candidate=>{if(candidate===null||typeof candidate!="object")return;const record=candidate;if(!(typeof record.src!="string"||record.kind!=="subtitles"&&record.kind!=="captions"&&record.kind!=="descriptions"||typeof record.srclang!="string"||typeof record.label!="string"))return Object.freeze({src:record.src.slice(0,MAX_TRACK_SRC_CHARS),kind:record.kind,srclang:record.srclang.slice(0,MAX_TRACK_LANGUAGE_CHARS),label:record.label.slice(0,MAX_TRACK_LABEL_CHARS),default:record.default===!0})},EMPTY_LYRA_AV_TRACKS)}function hasSearchableLyraAvCues(cues){return cues.some(cue=>!!(cue.text.trim()||cue.speaker?.trim()))}export{EMPTY_LYRA_AV_CUES,EMPTY_LYRA_AV_TRACKS,MAX_CUE_ID_CHARS,MAX_CUE_SPEAKER_CHARS,MAX_CUE_TEXT_CHARS,hasSearchableLyraAvCues,snapshotLyraAvCues,snapshotLyraAvTracks};

package/dist/components/media/av-player/av-player-cue-source-controller.js

@@ -0,0 +1 @@
+import{SourceRequestController}from"../../../internal/source-request-controller.js";import{SourceWindowController}from"../../../internal/source-window-controller.js";import{captureActiveCue,captureCueLocation,captureCueSource,captureSourceCue,sameSourceCue,captureCueSearch,sourceCueMatches}from"./av-cue-source.js";class AvCueSourceController{constructor(host,options){this.host=host,this.options=options,this.version=0,this.scheduled=!1,this.unavailable=!1,this.searchVersion=0,this.matchVersion=0,this.searchScheduled=!1,this.matchScheduled=!1,this.completedQuery="",this.completedLocale="",this.completedCount=0,this.completedOrdinal=-1,this.searchLoading=!1,this.searchUnavailable=!1,this.requests=new SourceRequestController(host,{channels:["active","search","match"],onReset:()=>{this.desired=void 0,this.interval=void 0,this.active=void 0,this.resetSearch()}}),this.window=new SourceWindowController(host,{pageSize:32,maxRows:128,maxPages:4,maxConcurrent:2,keyOf:cue=>cue.cueId,normalize:(raw,index)=>{const cue=captureSourceCue(raw);return this.checkRecord(index,cue,!1),cue},onChange:options.changed})}get count(){return this.binding?.source.count??0}get epoch(){return this.version}isCurrent(epoch){return epoch===this.version&&!!this.binding&&this.current(this.binding)}revoke(){this.version++,this.binding=void 0,this.unavailable=!1,this.requests.refresh(),this.window.bind(void 0)}bind(input,authoritative){const version=this.version;try{const source=captureCueSource(input);if(version!==this.version||!authoritative())return;const binding={source,owner:this.host.ownerDocument};if(this.requests.setSource(binding,source.revision),version!==this.version||!authoritative())return;this.binding=binding;const current=signal=>!signal.aborted&&this.current(binding),view={count:source.count,read:async request=>{const values=[],ids=new Set;try{for(let offset=0;offset<request.limit;offset++){if(!current(request.signal))throw new Error("Cue read canceled");const raw=await source.getCue(request.offset+offset,request);if(!current(request.signal))throw new Error("Cue read canceled");const cue=captureSourceCue(raw);if(!current(request.signal))throw new Error("Cue read canceled");if(this.checkRecord(request.offset+offset,cue),ids.has(cue.cueId))throw new TypeError("Duplicate cue identity");ids.add(cue.cueId),values.push(cue)}return values}catch(error){throw current(request.signal)&&(this.unavailable=!0,this.options.changed()),error}},indexOfKey:async(key,request)=>{if(!current(request.signal))return null;const raw=await source.findCue(key,request);if(!current(request.signal)||raw===null)return null;const found=captureCueLocation(raw,source.count);if(!current(request.signal))return null;if(found.cue.cueId!==key)throw new TypeError("Cue lookup mismatch");return this.checkRecord(found.index,found.cue),current(request.signal)?found.index:null}};if(this.window.bind({owner:binding,revision:source.revision,epoch:version,locale:this.options.locale(),view}),version!==this.version||!authoritative())return;this.unavailable=!1}catch{if(version!==this.version||!authoritative())return;this.unavailable=!0,this.binding=void 0}}current(binding){return this.binding===binding&&this.host.isConnected&&this.host.ownerDocument===binding.owner}checkRecord(index,cue,cached=!0){if(this.active&&(this.active.index===index&&!sameSourceCue(this.active.cue,cue)||this.active.index!==index&&this.active.cue.cueId===cue.cueId))throw new TypeError("Contradictory cue reply");if(this.selected&&(this.selected.index===index&&!sameSourceCue(this.selected.cue,cue)||this.selected.index!==index&&this.selected.cue.cueId===cue.cueId))throw new TypeError("Contradictory selected cue");if(!cached)return;const key=this.window.source.keyAt(index);if(typeof key=="string"){if(key!==cue.cueId)throw new TypeError("Contradictory cue identity");const slot=this.window.source.itemAt(index);if(slot.state==="ready"&&!sameSourceCue(slot.value,cue))throw new TypeError("Contradictory cue reply")}const other=this.window.source.indexOfKey(cue.cueId);if(other>=0&&other!==index)throw new TypeError("Duplicate cue identity")}updateTime(time,discontinuity=!1){const binding=this.binding;if(!(!binding||!this.current(binding)||!Number.isFinite(time)||time<0)&&!(discontinuity&&(this.interval=void 0,this.desired=void 0,this.requests.invalidate("active"),!this.current(binding)))){if(this.interval&&time>=this.interval.validFrom&&time<this.interval.validUntil){this.desired&&(this.desired=void 0,this.requests.invalidate("active"));return}this.desired?.time===time&&this.desired.binding===binding||(this.desired={binding,time},this.schedule())}}schedule(){this.scheduled||(this.scheduled=!0,queueMicrotask(()=>{this.scheduled=!1,this.pump()}))}pump(){if(this.running)return;const request=this.desired;if(!request||!this.current(request.binding))return;this.running=request;const lease=this.requests.begin("active",this.options.locale()),current=()=>this.desired===request&&this.current(request.binding)&&!!lease?.isCurrent();Promise.resolve().then(()=>current()?request.binding.source.activeAt(request.time,lease.context):void 0).then(raw=>{if(!current())return;const answer=captureActiveCue(raw,request.binding.source.count,request.time);current()&&(answer.index!==null&&answer.cue!==null&&this.checkRecord(answer.index,answer.cue),current()&&(this.interval=answer,this.active=answer.index!==null&&answer.cue!==null?{index:answer.index,cue:answer.cue}:void 0,this.unavailable=!1,this.options.activeChanged(answer.cue?.cueId??null,answer.index??-1),current()&&this.options.changed()))}).catch(()=>{current()&&(this.interval=void 0,this.active=void 0,this.unavailable=!0,this.options.activeChanged(null,-1),current()&&this.options.changed())}).finally(()=>{this.desired===request&&(this.desired=void 0),this.running===request&&(this.running=void 0),this.schedule()})}resetSearch(){this.searchVersion++,this.matchVersion++;const search=this.desiredSearch,match=this.desiredMatch;this.desiredSearch=void 0,this.desiredMatch=void 0,this.searchHandle=void 0,this.selected=void 0,this.completedQuery="",this.completedLocale="",this.completedCount=0,this.completedOrdinal=-1,this.searchLoading=!1,this.searchUnavailable=!1,search?.settle(0),match?.settle(!1)}cancelSearch(){const version=++this.searchVersion;this.matchVersion++;const search=this.desiredSearch,match=this.desiredMatch;return this.desiredSearch=void 0,this.desiredMatch=void 0,this.searchHandle=void 0,this.selected=void 0,search?.settle(0),match?.settle(!1),this.requests.invalidate("match"),version===this.searchVersion&&this.requests.invalidate("search"),version}clearSearch(){const version=this.cancelSearch();version===this.searchVersion&&(this.completedQuery="",this.completedLocale="",this.completedCount=0,this.completedOrdinal=-1,this.searchLoading=!1,this.searchUnavailable=!1,this.options.changed(),version===this.searchVersion&&this.emitSearchChange())}search(query,locale){if(query=query.trim(),!query)return this.clearSearch(),Promise.resolve(0);const binding=this.binding;if(this.cancelSearch()!==this.searchVersion||!binding||!this.current(binding))return Promise.resolve(0);let settle;const result=new Promise(resolve=>{settle=resolve});return this.desiredSearch={binding,query,locale,settle},this.searchLoading=!0,this.searchUnavailable=!1,this.options.changed(),this.scheduleSearch(),result}scheduleSearch(){this.searchScheduled||(this.searchScheduled=!0,queueMicrotask(()=>{this.searchScheduled=!1,this.pumpSearch()}))}pumpSearch(){if(this.runningSearch)return;const request=this.desiredSearch;if(!request||!this.current(request.binding))return;this.runningSearch=request;const lease=this.requests.begin("search",request.locale),current=()=>this.desiredSearch===request&&this.current(request.binding)&&!!lease?.isCurrent();Promise.resolve().then(()=>current()?request.binding.source.search(request.query,lease.context):void 0).then(async raw=>{if(!current())return;const value=captureCueSearch(raw,request.binding.source.count);if(!current())return;const handle={binding:request.binding,query:request.query,locale:request.locale,value};if(this.searchHandle=handle,value.count===0)this.completedQuery=handle.query,this.completedLocale=handle.locale,this.completedCount=0,this.completedOrdinal=-1,this.searchLoading=!1,this.options.changed(),current()&&this.emitSearchChange(),current()&&(this.desiredSearch=void 0),request.settle(0);else{const moved=await this.requestMatch(handle,0);current()&&(this.desiredSearch=void 0,request.settle(moved?value.count:0))}}).catch(()=>{current()&&(this.searchHandle=void 0,this.searchLoading=!1,this.searchUnavailable=!0,this.options.changed(),current()&&request.settle(0))}).finally(()=>{this.desiredSearch===request&&(this.desiredSearch=void 0),this.runningSearch===request&&(this.runningSearch=void 0),this.scheduleSearch()})}navigate(delta){const handle=this.searchHandle;if(!handle||this.desiredSearch&&this.searchLoading||this.searchUnavailable||!this.current(handle.binding)||!handle.value.count)return Promise.resolve(!1);const ordinal=this.desiredMatch?.handle===handle?this.desiredMatch.ordinal:this.completedOrdinal,next=delta===1?ordinal>=handle.value.count-1?0:ordinal+1:ordinal<=0?handle.value.count-1:ordinal-1;return this.requestMatch(handle,next)}requestMatch(handle,ordinal){const version=++this.matchVersion,previous=this.desiredMatch;if(this.desiredMatch=void 0,this.selected=void 0,previous?.settle(!1),this.requests.invalidate("match"),version!==this.matchVersion||this.searchHandle!==handle||!this.current(handle.binding))return Promise.resolve(!1);let settle;const result=new Promise(resolve=>{settle=resolve});return this.desiredMatch={handle,ordinal,settle},this.searchLoading=!0,this.options.changed(),this.scheduleMatch(),result}scheduleMatch(){this.matchScheduled||(this.matchScheduled=!0,queueMicrotask(()=>{this.matchScheduled=!1,this.pumpMatch()}))}pumpMatch(){if(this.runningMatch)return;const request=this.desiredMatch;if(!request||!this.current(request.handle.binding))return;this.runningMatch=request;const lease=this.requests.begin("match",request.handle.locale),current=()=>this.desiredMatch===request&&this.searchHandle===request.handle&&this.current(request.handle.binding)&&!!lease?.isCurrent();Promise.resolve().then(()=>current()?request.handle.value.getMatch(request.ordinal,lease.context):void 0).then(async raw=>{if(!current())return;const found=captureCueLocation(raw,request.handle.binding.source.count);if(current()){if(!sourceCueMatches(found.cue,request.handle.query,request.handle.locale))throw new TypeError("Nonmatching source cue");if(this.checkRecord(found.index,found.cue),!!current()){if(!await this.window.ensure(found.index)){if(current())throw new Error("Source cue unavailable");return}if(current()&&(this.checkRecord(found.index,found.cue),!!current())){if(!await this.options.reveal(found.index,current)){if(current())throw new Error("Source cue unavailable");return}current()&&(this.checkRecord(found.index,found.cue),current()&&(this.selected=found,this.completedQuery=request.handle.query,this.completedLocale=request.handle.locale,this.completedCount=request.handle.value.count,this.completedOrdinal=request.ordinal,this.searchLoading=!1,this.searchUnavailable=!1,this.options.changed(),current()&&(this.emitSearchChange(),request.settle(current()))))}}}}).catch(()=>{current()&&(this.selected=void 0,this.searchLoading=!1,this.searchUnavailable=!0,this.options.changed(),current()&&request.settle(!1))}).finally(()=>{this.desiredMatch===request&&(this.desiredMatch=void 0),this.runningMatch===request&&(this.runningMatch=void 0),this.scheduleMatch()})}matches(cue){return sourceCueMatches(cue,this.completedQuery,this.completedLocale||this.options.locale())}emitSearchChange(){this.options.searchChanged({query:this.completedQuery,matchCount:this.completedCount,matchCountExact:!0,activeIndex:this.completedOrdinal})}adopted(){this.revoke(),this.requests.adopted(),this.window.adopted()}}export{AvCueSourceController};

package/dist/components/media/av-player/av-player.class.d.ts

@@ -1,4 +1,4 @@
-import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraAnchor,LyraAnchorKind,HighlightActivateDetail,AnchorResultDetail}from'../../viewers/document-viewer/anchors.js';import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import{type LyraAvCue,type LyraAvTrack}from'./av-metadata.js';export type{LyraAvCue,LyraAvTrack}from'./av-metadata.js';
+import type{LyraAvCueSource}from'./av-cue-source.js';export type{LyraAvCueSource,LyraAvActiveCue,LyraAvCueSearch}from'./av-cue-source.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraAnchor,LyraAnchorKind,HighlightActivateDetail,AnchorResultDetail}from'../../viewers/document-viewer/anchors.js';import type{LyraPreparedWaveform}from'../../../utilities/data-preparation.js';export type{LyraPreparedWaveform}from'../../../utilities/data-preparation.js';import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import{type LyraAvCue,type LyraAvTrack}from'./av-metadata.js';export type{LyraAvCue,LyraAvTrack}from'./av-metadata.js';
 /** Surface treatment for the player-owned playback-rate controls. */
 export type LyraAvControlsSurface='regular'|'clear';export type LyraAvKind='audio'|'video';export type LyraAvPreload='none'|'metadata'|'auto';export interface LyraAvCueChangeDetail{readonly cueId:string|null;readonly index:number;}export interface LyraAvPlayerEventMap{ended:Event;error:Event;loadedmetadata:Event;pause:Event;play:Event;timeupdate:Event;volumechange:Event;'lr-play':CustomEvent<null>;'lr-pause':CustomEvent<null>;'lr-load':CustomEvent<{duration:number;kind:LyraAvKind;}>;'lr-time-change':CustomEvent<{currentTime:number;}>;'lr-rate-change':CustomEvent<{rate:number;}>;'lr-cue-change':CustomEvent<LyraAvCueChangeDetail>;'lr-highlight-activate':CustomEvent<HighlightActivateDetail>;'lr-anchor-result':CustomEvent<AnchorResultDetail>;'lr-search-change':CustomEvent<LyraSearchChangeDetail>;'lr-render-error':CustomEvent<{error:unknown;}>;blur:FocusEvent;focus:FocusEvent;}declare class LyraAvPlayerBase extends LyraElement<LyraAvPlayerEventMap>{}declare const LyraAvPlayer_base:Omit<typeof LyraAvPlayerBase,'prototype'> &(new(...args:ConstructorParameters<typeof LyraAvPlayerBase>)=>InstanceType<typeof LyraAvPlayerBase> &import("../../../lyra.js").LyraAnchorTarget&import("../../../internal/anchor-target.js").DocumentAnchorTargetHooks&{renderAnchorLiveRegion():unknown;});
 /**
@@ -28,7 +28,9 @@ export type LyraAvControlsSurface='regular'|'clear';export type LyraAvKind='audi
 * advances in both text directions.
 *
 * Waveform canvas painting is visibility-gated: peak, theme, and resize changes while the player
-* is off-screen stay dirty and coalesce into one paint on re-entry. Environments without
+* is off-screen stay dirty and coalesce into one paint on re-entry. Prepared waveform intervals
+* cover the whole recording without raw-sample ingestion; legacy peaks must already represent
+* the complete recording and fit 65,536 entries. Environments without
 * `IntersectionObserver` retain eager painting.
 *
 * @customElement lr-av-player
@@ -54,8 +56,8 @@ export type LyraAvControlsSurface='regular'|'clear';export type LyraAvKind='audi
 *   `detail: { found }`.
 * @event lr-search-change - Fired from `search()`/`searchNext()`/`searchPrevious()`/
 *   `clearSearch()`. `detail: { query, matchCount, matchCountExact, activeIndex }`.
-*   `matchCountExact` is always `true`: `search()` matches over the already-loaded `cues` array
-*   with no additional ceiling.
+*   `matchCountExact` is always `true`: legacy search covers admitted cues; cueSource search
+*   uses the provider's exact full-source count. The active index is a match ordinal.
 * @event lr-render-error - Native media failure, unsafe-source rejection, or an internal playback
 *   rejection. `detail: { error }`; native `MediaError` identity is preserved.
 * @event {FocusEvent} focus - Relayed once from the native media element as a bubbling, composed
@@ -81,7 +83,7 @@ export type LyraAvControlsSurface='regular'|'clear';export type LyraAvKind='audi
 * @csspart cue-time - A cue's timestamp label.
 * @csspart cue-speaker - A cue's speaker label.
 * @csspart cue-text - A cue's text.
-* @csspart error - Ordinary visible failure text. Fresh post-mount media/source failures append
+* @csspart error - Visible media, transcript, search, or unavailable-waveform failure text. Fresh post-mount failures append
 *   the localized message to the shared light-DOM assertive announcement sink; an already-unsafe
 *   initial `src` renders visibly without interrupting on mount.
 * @cssprop [--lr-av-player-transcript-height=var(--lr-size-16rem)] - Block size of the
@@ -141,14 +143,32 @@ get volume():number;set volume(next:number);
 * Only the owned playback-rate toolbar is affected; native media controls stay browser-owned. */
 controlsSurface:LyraAvControlsSurface;private readonly inputs;private _rates;
 /** Selectable rates offered by `[part="rate-select"]`; snapshotted, deduplicated, bounded to 32. */
-get rates():readonly number[];set rates(value:readonly number[]);private _cues;private nextCueStarts;
+get rates():readonly number[];set rates(value:readonly number[]);private _cues;private cueIndex;private indexedCues;private indexedCueDuration;
 /** Transcript entries, rendered as a virtualized, `currentTime`-synced list. Valid nonempty
 * `cueId` values are unique; the first occurrence wins. Inputs are bounded, cloned, and frozen.
-* Omitted ends use indexed next chronological starts; seeks reconcile in linear work. */
-get cues():readonly LyraAvCue[];set cues(value:readonly LyraAvCue[]);private _peaks;
+* Omitted ends use next chronological starts; a bounded interval index reconciles seeks in logarithmic work. */
+get cues():readonly LyraAvCue[];set cues(value:readonly LyraAvCue[]);private _cueSource;private cueSourceDirty;private cueSourceGeneration;private cueSourceContinuationQueued;private transcriptFailureAnnounced;private searchFailureAnnounced;
+/** Property-only full transcript source. Non-null bypasses legacy cues. Providers own global
+* unique IDs, interval indexing and exact search. The player caches at most 128 rows, stages
+* at most 64, and retains at most two selected records; each cue permits 256 ID, 100,000 text,
+* and 4,096 speaker UTF-16 units. Reassign (including the same reference) or requestUpdate()
+* to rebind an immutable revision. Unavailable positions retain their original indices. */
+get cueSource():LyraAvCueSource|null;set cueSource(value:LyraAvCueSource|null);private readonly cueSourceController;private captureCueSource;private _peaks;private peaksInvalid;
 /** Normalized `0..1` waveform amplitude samples. Empty renders a plain seek rail instead of a
-*  canvas -- this component never decodes audio itself. */
-get peaks():readonly number[];set peaks(value:readonly number[]);private _tracks;
+*  canvas -- this component never decodes audio itself. At most 65,536 samples representing the
+*  whole recording; longer arrays are rejected before any entry is read. Inactive when waveform
+*  is supplied. Use prepareLyraWaveform for a bounded whole-source envelope. */
+get peaks():readonly number[];set peaks(value:readonly number[]);private _waveform;private waveformSnapshot?;private waveformInputDirty;private waveformInputGeneration;private waveformContinuationQueued;private waveformInputChanged;private waveformInvalid;private waveformFailureAnnounced;
+/**
+* Property-only whole-duration envelope, taking precedence over peaks. Own data fields and
+* contiguous source intervals are validated and copied into at most 65,536 immutable buckets;
+* painting combines overlapping interval maxima into at most 4,096 physical bars. No decoding
+* or source reads occur. Invalid data renders a localized error and plain seek rail.
+* Once media metadata loads, duration must match within 1ms plus representation epsilon.
+* Reassign (including the same reference) or requestUpdate() after changing an authored input.
+* The supplied descriptor remains caller-owned; the admitted bounded snapshot is clone-owned.
+*/
+get waveform():LyraPreparedWaveform|null;set waveform(value:LyraPreparedWaveform|null);requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private captureWaveform;private get waveformUnavailable();private get hasWaveform();private _tracks;
 /** Native `<track>` sources (subtitles/captions/descriptions), bounded and snapshotted. */
 get tracks():readonly LyraAvTrack[];set tracks(value:readonly LyraAvTrack[]);
 /** From `DocumentAnchorTarget` — only `time-range` anchors resolve here. */
@@ -174,7 +194,9 @@ toggle():void;
 /** Sets `currentTime` and forces an immediate `lr-time-change`, bypassing the playing-time throttle. */
 seek(seconds:number):void;protected applyAnchor(anchor:LyraAnchor):Promise<boolean>;private onLoadedMetadata;private onPlay;private onPause;private onMediaError;private onNativeMediaEvent;private onPlaybackFailure;private emitTimeChange;private onTimeUpdate;private reconcileActiveCue;private setActiveCue;private onSeeked;
 /** Case-insensitive substring match over cue text and speaker. Reveals the active matching
-*  transcript row without changing media playback, then resolves the match count. */
+*  transcript row without changing media playback, then resolves the match count. Source mode
+*  trims the query, passes the effective locale, and queries the complete provider index. A
+*  canceled or unavailable query resolves zero without emitting a false exact-zero result. */
 search(query:string):Promise<number>;private reconcileSearchMatches;
 /** Advances to the next match, wrapping to the first after the last and revealing it. Resolves
 *  `true` once the active match moved, `false` when there are no matches -- the shape the shared
@@ -185,4 +207,4 @@ searchNext():Promise<boolean>;
 *  `true` once the active match moved, `false` when there are no matches. */
 searchPrevious():Promise<boolean>;
 /** Clears the query, matches, and active index, and emits a zero-match `lr-search-change`. */
-clearSearch():void;private emitSearchChange;private revealActiveSearchMatch;private drawWaveform;private paintWaveform;private scheduleWaveformDraw;private cancelWaveformDrawFrame;private onHighlightActivate;private renderMarkers;private onTimelineClick;private onTimelineKeyDown;private rateOptions;private safeCueStart;private safeCueEnd;private rebuildCueKeys;private cueKey;private renderCue;private transcriptRenderItem;private refreshTranscriptRenderItem;private renderTracks;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-av-player':LyraAvPlayer;}}
+clearSearch():void;private emitSearchChange;private revealSourceCue;private revealActiveSearchMatch;private drawWaveform;private paintWaveform;private scheduleWaveformDraw;private cancelWaveformDrawFrame;private onHighlightActivate;private renderMarkers;private onTimelineClick;private onTimelineKeyDown;private rateOptions;private safeCueStart;private rebuildCueKeys;private cueKey;private renderCue;private transcriptRenderItem;private refreshTranscriptRenderItem;private renderTracks;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-av-player':LyraAvPlayer;}}