@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/retrieval/retrieval-compare/retrieval-compare.class.js

@@ -1,14 +1,15 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{nextId}from"../../../internal/a11y.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{isRovingTargetAvailable,resolveListMove}from"../../../internal/list-navigation.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity,isValidRetrievalChunk}from"../retrieval-identity.js";import{finiteCount,finiteRange}from"../../../internal/numbers.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import"../../overlays/empty/empty.class.js";import{styles}from"./retrieval-compare.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_retrievalCompareDenseScore,LYRA_DEFAULT_retrievalCompareEmpty,LYRA_DEFAULT_retrievalCompareFinalScore,LYRA_DEFAULT_retrievalCompareLabel,LYRA_DEFAULT_retrievalCompareOverlap,LYRA_DEFAULT_retrievalCompareRank,LYRA_DEFAULT_retrievalCompareRerankScore,LYRA_DEFAULT_retrievalCompareSparseScore,LYRA_DEFAULT_untitledSource}from"../../../internal/default-strings/retrieval.generated.js";class LyraRetrievalCompare extends LyraElement{constructor(){super(...arguments),this.rovingChunkBySet=new Map,this.sets=[],this.topK=10,this.selectedChunkId="",this.headingLevel="3",this.size="m",this.frame="card",this.headingIdPrefix=nextId("retrieval-compare"),this.renderSet=(set,setIndex,chunks)=>{const headingId=`${this.headingIdPrefix}-set-${setIndex}`,level=resolveHeadingLevel(this.headingLevel),remembered=this.rovingChunkBySet.get(set.id),rovingChunkId=chunks.some(chunk=>chunk.id===remembered)?remembered:chunks[0]?.id;return html`
-      <section part="set" aria-labelledby=${headingId}>
+import{__decorate}from"tslib";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{activeElementIn,shadowFocusTarget}from"../../../internal/active-element.js";import{repeat}from"lit/directives/repeat.js";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{nextId}from"../../../internal/a11y.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{isRovingTargetAvailable,resolveListMove}from"../../../internal/list-navigation.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity,isValidRetrievalChunk}from"../retrieval-identity.js";import{finiteCount,finiteRange}from"../../../internal/numbers.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import"../../overlays/empty/empty.class.js";import{styles}from"./retrieval-compare.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_retrievalCompareDenseScore,LYRA_DEFAULT_retrievalCompareEmpty,LYRA_DEFAULT_retrievalCompareFinalScore,LYRA_DEFAULT_retrievalCompareInputLimit,LYRA_DEFAULT_retrievalCompareLabel,LYRA_DEFAULT_retrievalCompareOverlap,LYRA_DEFAULT_retrievalCompareRank,LYRA_DEFAULT_retrievalCompareRerankScore,LYRA_DEFAULT_retrievalCompareResultLimit,LYRA_DEFAULT_retrievalCompareSparseScore,LYRA_DEFAULT_untitledSource}from"../../../internal/default-strings/retrieval.generated.js";import{LYRA_DEFAULT_next,LYRA_DEFAULT_paginationApplied,LYRA_DEFAULT_paginationFirstPage,LYRA_DEFAULT_paginationLabel,LYRA_DEFAULT_paginationLastPage,LYRA_DEFAULT_previous}from"../../../internal/default-strings/shared.generated.js";const COMPARISON_PAGE_SIZE=8,MAX_COMPARISON_RESULTS=100;class LyraRetrievalCompare extends LyraElement{constructor(){super(...arguments),this.page=0,this.announcements=new AnnouncementSinkController(this,{eager:["polite"]}),this.canonicalSets=[],this.rankedBySet=new WeakMap,this.visibleSets=[],this.visibleOrdered=new Map,this.visibleOverlaps=[],this.rovingChunkBySet=new Map,this.sets=[],this.topK=10,this.selectedChunkId="",this.headingLevel="3",this.size="m",this.frame="card",this.headingIdPrefix=nextId("retrieval-compare"),this.renderSet=(set,setIndex,chunks)=>{const headingId=`${this.headingIdPrefix}-set-${setIndex}`,level=resolveHeadingLevel(this.headingLevel),remembered=this.rovingChunkBySet.get(set.id),rovingChunkId=chunks.some(chunk=>chunk.id===remembered)?remembered:chunks[0]?.id;return html`
+      <section part="set" data-set-id=${set.id} aria-labelledby=${headingId}>
         <div part="set-heading" id=${headingId} role=${level?"heading":nothing} aria-level=${level??nothing}>${set.label}</div>
         <ol part="chunks">
-          ${chunks.map((chunk,index)=>{const selected=chunk.id===this.selectedChunkId,rank=this.rank(chunk,index),chunkPart=selected?"chunk chunk-selected":"chunk",id=`${headingId}-chunk-${index}`;return html`
+          ${repeat(chunks,chunk=>chunk.id,(chunk,index)=>{const selected=chunk.id===this.selectedChunkId,rank=this.rankedBySet.get(set)?.ranks.get(chunk)??this.rank(chunk,index),chunkPart=selected?"chunk chunk-selected":"chunk",id=`${headingId}-chunk-${index}`;return html`
               <li>
                 <button
                   part=${chunkPart}
+                  data-chunk-id=${chunk.id}
                   type="button"
                   tabindex=${chunk.id===rovingChunkId?"0":"-1"}
-                  @focus=${()=>{this.rovingChunkBySet.set(set.id,chunk.id),this.requestUpdate()}}
+                  @focus=${()=>{this.rovingChunkBySet.set(set.id,chunk.id),chunk.id!==rovingChunkId&&this.requestUpdate()}}
                   @keydown=${event=>this.onChunkKeyDown(event,index,chunks.length)}
                   aria-pressed=${selected?"true":"false"}
                   aria-labelledby="${id}-rank ${id}-title"
@@ -34,25 +35,37 @@ import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/co
               </li>
             `})}
         </ol>
+        ${(this.rankedBySet.get(set)?.total??0)>chunks.length?html`<p part="result-limit" role="note">${this.localize("retrievalCompareResultLimit",void 0,{shown:getNumberFormat(this.effectiveLocale).format(chunks.length),total:getNumberFormat(this.effectiveLocale).format(this.rankedBySet.get(set).total)})}</p>`:nothing}
       </section>
-    `}}static{this.defaultStrings={...super.defaultStrings,retrievalCompareDenseScore:LYRA_DEFAULT_retrievalCompareDenseScore,retrievalCompareEmpty:LYRA_DEFAULT_retrievalCompareEmpty,retrievalCompareFinalScore:LYRA_DEFAULT_retrievalCompareFinalScore,retrievalCompareLabel:LYRA_DEFAULT_retrievalCompareLabel,retrievalCompareOverlap:LYRA_DEFAULT_retrievalCompareOverlap,retrievalCompareRank:LYRA_DEFAULT_retrievalCompareRank,retrievalCompareRerankScore:LYRA_DEFAULT_retrievalCompareRerankScore,retrievalCompareSparseScore:LYRA_DEFAULT_retrievalCompareSparseScore,untitledSource:LYRA_DEFAULT_untitledSource}}onChunkKeyDown(event,index,count){const buttons=event.currentTarget.closest('[part="chunks"]')?.querySelectorAll('[part~="chunk"]'),next=resolveListMove(event,{count,current:index,orientation:"vertical",isAvailable:candidate=>!!(buttons?.[candidate]&&isRovingTargetAvailable(buttons[candidate]))});next!==null&&(event.preventDefault(),buttons?.[next]?.focus())}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["sets"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-chunk-select"])}get effectiveTopK(){return Math.max(1,finiteCount(this.topK,10))}get normalizedSets(){return firstByRetrievalIdentity(Array.isArray(this.sets)?this.sets:[],set=>set.id)}orderedChunks(set){return firstByRetrievalIdentity(Array.isArray(set.chunks)?set.chunks.filter(isValidRetrievalChunk):[],chunk=>chunk.id).map((chunk,index)=>({chunk,index,rank:this.rank(chunk,index)})).sort((a,b)=>a.rank-b.rank||b.chunk.score-a.chunk.score||a.index-b.index).slice(0,this.effectiveTopK).map(({chunk})=>chunk)}rank(chunk,index){return Math.max(1,finiteCount(typeof chunk.rank=="number"?chunk.rank:index+1,index+1))}formatScore(value){return getNumberFormat(this.effectiveLocale,{style:"percent",maximumFractionDigits:1}).format(finiteRange(value,0,0,1))}overlaps(sets,ordered){const summaries=[];for(let leftIndex=0;leftIndex<sets.length;leftIndex+=1){const leftSet=sets[leftIndex],left=new Set((ordered.get(leftSet.id)??[]).map(chunk=>chunk.id));for(let rightIndex=leftIndex+1;rightIndex<sets.length;rightIndex+=1){const rightSet=sets[rightIndex],right=new Set((ordered.get(rightSet.id)??[]).map(chunk=>chunk.id)),intersection=[...left].filter(id=>right.has(id)).length,union=new Set([...left,...right]).size,percent=this.formatScore(union?intersection/union:0);summaries.push(this.localize("retrievalCompareOverlap",void 0,{left:leftSet.label,right:rightSet.label,percent}))}}return summaries}scoreEntries(chunk){const scores=chunk.scores??{final:chunk.score};return[[this.localize("retrievalCompareDenseScore"),scores.dense],[this.localize("retrievalCompareSparseScore"),scores.sparse],[this.localize("retrievalCompareRerankScore"),scores.rerank],[this.localize("retrievalCompareFinalScore"),scores.final]].filter(entry=>typeof entry[1]=="number")}render(){const sets=this.normalizedSets,label=retrievalSemanticLabel(this,this.label==null?this.localize("retrievalCompareLabel"):this.label),role=retrievalSemanticRole(this,"region");if(!sets.length)return html`<section
-        part="base"
-        role=${role??nothing}
-        aria-label=${label??nothing}
-      >
-        <lr-empty
-          part="empty"
-          heading=${this.localize("retrievalCompareEmpty")}
-        ></lr-empty>
-      </section>`;const ordered=new Map(sets.map(set=>[set.id,this.orderedChunks(set)])),overlaps=this.overlaps(sets,ordered);return html`
+    `}}static{this.defaultStrings={...super.defaultStrings,next:LYRA_DEFAULT_next,paginationApplied:LYRA_DEFAULT_paginationApplied,paginationFirstPage:LYRA_DEFAULT_paginationFirstPage,paginationLabel:LYRA_DEFAULT_paginationLabel,paginationLastPage:LYRA_DEFAULT_paginationLastPage,previous:LYRA_DEFAULT_previous,retrievalCompareDenseScore:LYRA_DEFAULT_retrievalCompareDenseScore,retrievalCompareEmpty:LYRA_DEFAULT_retrievalCompareEmpty,retrievalCompareFinalScore:LYRA_DEFAULT_retrievalCompareFinalScore,retrievalCompareInputLimit:LYRA_DEFAULT_retrievalCompareInputLimit,retrievalCompareLabel:LYRA_DEFAULT_retrievalCompareLabel,retrievalCompareOverlap:LYRA_DEFAULT_retrievalCompareOverlap,retrievalCompareRank:LYRA_DEFAULT_retrievalCompareRank,retrievalCompareRerankScore:LYRA_DEFAULT_retrievalCompareRerankScore,retrievalCompareResultLimit:LYRA_DEFAULT_retrievalCompareResultLimit,retrievalCompareSparseScore:LYRA_DEFAULT_retrievalCompareSparseScore,untitledSource:LYRA_DEFAULT_untitledSource}}onChunkKeyDown(event,index,count){const buttons=event.currentTarget.closest('[part="chunks"]')?.querySelectorAll('[part~="chunk"]'),next=resolveListMove(event,{count,current:index,orientation:"vertical",isAvailable:candidate=>!!(buttons?.[candidate]&&isRovingTargetAvailable(buttons[candidate]))});next!==null&&(event.preventDefault(),buttons?.[next]?.focus())}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["sets"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-chunk-select"])}get effectiveTopK(){return Math.min(MAX_COMPARISON_RESULTS,Math.max(1,finiteCount(this.topK,10)))}get normalizedSets(){if(this.canonicalSource!==this.sets){this.canonicalSource=this.sets,this.canonicalSets=firstByRetrievalIdentity(Array.isArray(this.sets)?this.sets:[],set=>set.id);const ids=new Set(this.canonicalSets.map(set=>set.id));for(const id of this.rovingChunkBySet.keys())ids.has(id)||this.rovingChunkBySet.delete(id)}return this.canonicalSets}orderedChunks(set){const cached=this.rankedBySet.get(set);if(cached?.topK===this.effectiveTopK)return cached.chunks;const ranked=firstByRetrievalIdentity(Array.isArray(set.chunks)?set.chunks.filter(isValidRetrievalChunk):[],chunk=>chunk.id).map((chunk,index)=>({chunk,index,rank:this.rank(chunk,index)})).sort((a,b)=>a.rank-b.rank||b.chunk.score-a.chunk.score||a.index-b.index),visible=ranked.slice(0,this.effectiveTopK),chunks=visible.map(({chunk})=>chunk);return this.rankedBySet.set(set,{topK:this.effectiveTopK,chunks,total:ranked.length,ranks:new Map(visible.map(entry=>[entry.chunk,entry.rank]))}),chunks}updateComparison(){const sets=this.normalizedSets;this.page=Math.min(this.page,Math.max(0,Math.ceil(sets.length/COMPARISON_PAGE_SIZE)-1));const deps=[sets,this.effectiveTopK,this.page];this.comparisonDeps&&deps.every((value,index)=>value===this.comparisonDeps[index])||(this.comparisonDeps=deps,this.visibleSets=sets.slice(this.page*COMPARISON_PAGE_SIZE,(this.page+1)*COMPARISON_PAGE_SIZE),this.visibleOrdered=new Map(this.visibleSets.map(set=>[set.id,this.orderedChunks(set)])),this.visibleOverlaps=this.overlaps(this.visibleSets,this.visibleOrdered))}willUpdate(changed){if(super.willUpdate(changed),changed.has("sets")||changed.has("topK")||changed.has("page")){const focused=shadowFocusTarget(this),setId=focused?.closest("[data-set-id]")?.dataset.setId,chunkId=focused?.dataset.chunkId,pageAction=focused?.dataset.pageAction;if(focused&&pageAction&&(this.pendingFocus={pageAction,origin:focused}),focused&&setId&&chunkId&&(changed.has("sets")||changed.has("topK"))){const index=this.normalizedSets.findIndex(set=>set.id===setId);index>=0&&(this.page=Math.floor(index/COMPARISON_PAGE_SIZE)),this.pendingFocus={setId,chunkId,origin:focused}}this.hasUpdated&&changed.has("sets")&&publicCollectionTruncation(this,"sets")&&this.announcements.announcePolite(this.localize("retrievalCompareInputLimit"))}this.updateComparison()}updated(changed){super.updated(changed);const pending=this.pendingFocus;if(this.pendingFocus=void 0,!pending)return;const current=shadowFocusTarget(this),outer=activeElementIn(this.ownerDocument);if(current&&current!==pending.origin||outer&&outer!==this&&outer!==this.ownerDocument.body)return;if(pending.pageAction){const pages=[...this.shadowRoot?.querySelectorAll("[data-page-action]:not(:disabled)")??[]],page=pages.find(button=>button.dataset.pageAction===pending.pageAction)??pages[0];if(page){current!==page&&page.focus();return}}const buttons=[...this.shadowRoot?.querySelectorAll("[data-chunk-id]")??[]],target=buttons.find(button=>button.dataset.chunkId===pending.chunkId&&button.closest("[data-set-id]")?.dataset.setId===pending.setId)??buttons[0]??this.shadowRoot?.querySelector('[part="base"]');current!==target&&target?.focus()}adoptedCallback(){super.adoptedCallback(),this.announcements.adopted()}disconnectedCallback(){this.pendingFocus=void 0,super.disconnectedCallback()}changePage(page){this.page=Math.max(0,Math.min(page,Math.ceil(this.normalizedSets.length/COMPARISON_PAGE_SIZE)-1)),this.announcements.announcePolite(this.pageText())}pageText(){const format=getNumberFormat(this.effectiveLocale);return this.localize("paginationApplied",void 0,{page:format.format(this.page+1),totalPages:format.format(Math.ceil(this.normalizedSets.length/COMPARISON_PAGE_SIZE))})}renderPagination(){const pages=Math.ceil(this.normalizedSets.length/COMPARISON_PAGE_SIZE);return pages>1?html`<div part="pagination" role="group" aria-label=${this.localize("paginationLabel")}>
+      <button part="page-button" data-page-action="first" type="button" ?disabled=${this.page===0} @click=${()=>this.changePage(0)}>${this.localize("paginationFirstPage")}</button>
+      <button part="page-button" data-page-action="previous" type="button" ?disabled=${this.page===0} @click=${()=>this.changePage(this.page-1)}>${this.localize("previous")}</button>
+      <span part="page-status">${this.pageText()}</span>
+      <button part="page-button" data-page-action="next" type="button" ?disabled=${this.page>=pages-1} @click=${()=>this.changePage(this.page+1)}>${this.localize("next")}</button>
+      <button part="page-button" data-page-action="last" type="button" ?disabled=${this.page>=pages-1} @click=${()=>this.changePage(pages-1)}>${this.localize("paginationLastPage")}</button>
+    </div>`:nothing}rank(chunk,index){return Math.max(1,finiteCount(typeof chunk.rank=="number"?chunk.rank:index+1,index+1))}formatScore(value){return getNumberFormat(this.effectiveLocale,{style:"percent",maximumFractionDigits:1}).format(finiteRange(value,0,0,1))}overlaps(sets,ordered){const summaries=[],identities=sets.map(set=>new Set((ordered.get(set.id)??[]).map(chunk=>chunk.id)));for(let leftIndex=0;leftIndex<sets.length;leftIndex++){const left=identities[leftIndex];for(let rightIndex=leftIndex+1;rightIndex<sets.length;rightIndex++){const right=identities[rightIndex];let intersection=0;for(const id of left)right.has(id)&&intersection++;const union=left.size+right.size-intersection;summaries.push({left:sets[leftIndex].label,right:sets[rightIndex].label,ratio:union?intersection/union:0})}}return summaries}scoreEntries(chunk){const scores=chunk.scores??{final:chunk.score};return[[this.localize("retrievalCompareDenseScore"),scores.dense],[this.localize("retrievalCompareSparseScore"),scores.sparse],[this.localize("retrievalCompareRerankScore"),scores.rerank],[this.localize("retrievalCompareFinalScore"),scores.final]].filter(entry=>typeof entry[1]=="number")}render(){this.updateComparison();const sets=this.visibleSets,inputLimit=publicCollectionTruncation(this,"sets")?html`<p part="input-limit" role="note">${this.localize("retrievalCompareInputLimit")}</p>`:nothing,label=retrievalSemanticLabel(this,this.label==null?this.localize("retrievalCompareLabel"):this.label),role=retrievalSemanticRole(this,"region");return sets.length?html`
       <section
         part="base"
+        tabindex="-1"
         role=${role??nothing}
         aria-label=${label??nothing}
       >
-        ${overlaps.map(summary=>html`<p part="overlap">${summary}</p>`)}
+        ${inputLimit}
+        ${this.renderPagination()}
+        ${this.visibleOverlaps.map(summary=>html`<p part="overlap">${this.localize("retrievalCompareOverlap",void 0,{left:summary.left,right:summary.right,percent:this.formatScore(summary.ratio)})}</p>`)}
         <div part="sets">
-          ${sets.map((set,index)=>this.renderSet(set,index,ordered.get(set.id)??[]))}
+          ${repeat(sets,set=>set.id,(set,index)=>this.renderSet(set,this.page*COMPARISON_PAGE_SIZE+index,this.visibleOrdered.get(set.id)??[]))}
         </div>
       </section>
-    `}}__decorate([property({attribute:!1})],LyraRetrievalCompare.prototype,"sets",void 0),__decorate([property({type:Number,attribute:"top-k"})],LyraRetrievalCompare.prototype,"topK",void 0),__decorate([property({attribute:"selected-chunk-id"})],LyraRetrievalCompare.prototype,"selectedChunkId",void 0),__decorate([property({attribute:"heading-level"})],LyraRetrievalCompare.prototype,"headingLevel",void 0),__decorate([property()],LyraRetrievalCompare.prototype,"label",void 0),__decorate([property({reflect:!0})],LyraRetrievalCompare.prototype,"size",void 0),__decorate([property({reflect:!0})],LyraRetrievalCompare.prototype,"frame",void 0);export{LyraRetrievalCompare};
+    `:html`<section
+        part="base"
+        tabindex="-1"
+        role=${role??nothing}
+        aria-label=${label??nothing}
+      >
+        ${inputLimit}
+        <lr-empty
+          part="empty"
+          heading=${this.localize("retrievalCompareEmpty")}
+        ></lr-empty>
+      </section>`}}__decorate([state()],LyraRetrievalCompare.prototype,"page",void 0),__decorate([property({attribute:!1})],LyraRetrievalCompare.prototype,"sets",void 0),__decorate([property({type:Number,attribute:"top-k"})],LyraRetrievalCompare.prototype,"topK",void 0),__decorate([property({attribute:"selected-chunk-id"})],LyraRetrievalCompare.prototype,"selectedChunkId",void 0),__decorate([property({attribute:"heading-level"})],LyraRetrievalCompare.prototype,"headingLevel",void 0),__decorate([property()],LyraRetrievalCompare.prototype,"label",void 0),__decorate([property({reflect:!0})],LyraRetrievalCompare.prototype,"size",void 0),__decorate([property({reflect:!0})],LyraRetrievalCompare.prototype,"frame",void 0);export{LyraRetrievalCompare};

package/dist/components/retrieval/retrieval-compare/retrieval-compare.styles.js

@@ -1 +1 @@
-import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";import{compactContainerQuery}from"../../../internal/container-breakpoints.styles.js";const styles=css` :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { min-inline-size: 0; } [part='overlap'] { margin: 0 0 var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='sets'] { display: grid; grid-auto-columns: minmax(var(--lr-size-16rem), 1fr); grid-auto-flow: column; gap: var(--lr-space-m); overflow-x: auto; overflow-y: hidden; overscroll-behavior-inline: contain; } [part='set'] { min-inline-size: 0; } [part='set-heading'] { margin: 0 0 var(--lr-space-s); font-size: var(--lr-font-size-m); } [part='chunks'] { display: flex; flex-direction: column; gap: var(--lr-space-s); margin: 0; padding: 0; list-style: none; } [part~='chunk'] { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: var(--lr-space-xs) var(--lr-space-s); inline-size: 100%; box-sizing: border-box; ${iconHitTarget} padding: var(--lr-space-s); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); color: var(--lr-color-text); font: inherit; text-align: start; cursor: pointer; transition: background-color var(--lr-transition-fast); } [part~='chunk']:hover { background: var(--lr-color-surface-raised); } [part~='chunk']:active { background: color-mix(in oklab, var(--lr-color-surface-raised), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part~='chunk']:focus-visible { ${focusRing} } [part~='chunk-selected'] { border-color: var(--lr-retrieval-compare-selected-border, var(--lr-color-brand)); } @media (forced-colors: active) { [part~='chunk-selected'] { outline: var(--lr-border-width-medium) solid Highlight; outline-offset: calc(-1 * var(--lr-border-width-medium)); } } [part='chunk-rank'] { color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-xs); } [part='chunk-title'], [part='chunk-text'], [part='scores'] { min-inline-size: 0; overflow-wrap: anywhere; } [part='chunk-text'], [part='scores'] { grid-column: 1 / -1; } [part='chunk-text'] { font-size: var(--lr-font-size-sm); } [part='scores'] { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--lr-space-2xs) var(--lr-space-s); } [part='score'] { display: flex; justify-content: space-between; gap: var(--lr-space-xs); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-xs); } @container ${compactContainerQuery} { [part='sets'] { grid-auto-columns: minmax(var(--lr-size-14rem), 100%); } [part='scores'] { grid-template-columns: 1fr; } } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part~='chunk'] { padding: var(--lr-space-xs); } :host([frame='plain']) [part~='chunk'] { border: 0; border-radius: 0; background: transparent; } `;export{styles};
+import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";import{compactContainerQuery}from"../../../internal/container-breakpoints.styles.js";const styles=css` :host { display: block; container-type: inline-size; contain-intrinsic-inline-size: var(--lr-size-20rem); } [part='base'] { min-inline-size: 0; } [part='overlap'] { margin: 0 0 var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); } [part='sets'] { display: grid; grid-auto-columns: minmax(var(--lr-size-16rem), 1fr); grid-auto-flow: column; gap: var(--lr-space-m); overflow-x: auto; overflow-y: hidden; overscroll-behavior-inline: contain; } [part='set'] { min-inline-size: 0; } [part='set-heading'] { margin: 0 0 var(--lr-space-s); font-size: var(--lr-font-size-m); } [part='chunks'] { display: flex; flex-direction: column; gap: var(--lr-space-s); margin: 0; padding: 0; list-style: none; } [part~='chunk'] { display: grid; grid-template-columns: auto minmax(0, 1fr); gap: var(--lr-space-xs) var(--lr-space-s); inline-size: 100%; box-sizing: border-box; ${iconHitTarget} padding: var(--lr-space-s); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); color: var(--lr-color-text); font: inherit; text-align: start; cursor: pointer; transition: background-color var(--lr-transition-fast); } [part~='chunk']:hover { background: var(--lr-color-surface-raised); } [part~='chunk']:active { background: color-mix(in oklab, var(--lr-color-surface-raised), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part~='chunk']:focus-visible { ${focusRing} } [part~='chunk-selected'] { border-color: var(--lr-retrieval-compare-selected-border, var(--lr-color-brand)); } @media (forced-colors: active) { [part~='chunk-selected'] { outline: var(--lr-border-width-medium) solid Highlight; outline-offset: calc(-1 * var(--lr-border-width-medium)); } } [part='chunk-rank'] { color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-xs); } [part='chunk-title'], [part='chunk-text'], [part='scores'] { min-inline-size: 0; overflow-wrap: anywhere; } [part='chunk-text'], [part='scores'] { grid-column: 1 / -1; } [part='chunk-text'] { font-size: var(--lr-font-size-sm); } [part='scores'] { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--lr-space-2xs) var(--lr-space-s); } [part='score'] { display: flex; justify-content: space-between; gap: var(--lr-space-xs); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-xs); } @container ${compactContainerQuery} { [part='sets'] { grid-auto-columns: minmax(var(--lr-size-14rem), 100%); } [part='scores'] { grid-template-columns: 1fr; } } :host(:is([size='2xs'], [size='xs'], [size='s'], [size='small'])) [part~='chunk'] { padding: var(--lr-space-xs); } :host([frame='plain']) [part~='chunk'] { border: 0; border-radius: 0; background: transparent; } [part='pagination'] { display: flex; flex-wrap: wrap; align-items: center; gap: var(--lr-space-xs); margin-block: var(--lr-space-s); } [part='page-button'] { ${iconHitTarget} padding: var(--lr-space-2xs) var(--lr-space-xs); border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: var(--lr-color-surface); color: var(--lr-color-text); font: inherit; cursor: pointer; } [part='page-button']:hover:where(:not(:disabled)) { background: var(--lr-color-surface-raised); } [part='page-button']:active:where(:not(:disabled)) { background: color-mix(in oklab, var(--lr-color-surface-raised), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='page-button']:focus-visible { ${focusRing} } [part='page-button']:disabled { opacity: var(--lr-opacity-disabled); cursor: default; } [part='page-status'], [part='input-limit'], [part='result-limit'] { color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); margin-block: var(--lr-space-xs); } `;export{styles};

package/dist/components/retrieval/retrieval-results/retrieval-results-model.js

@@ -0,0 +1 @@
+import{readOwnDataValue}from"../../../internal/data-descriptors.js";import{snapshotPublicCollection}from"../../../internal/collection-snapshot.js";import{isValidRetrievalChunk}from"../retrieval-identity.js";function fields(value,keys){const result={};for(const key of keys){const field=readOwnDataValue(value,key);field!==void 0&&(result[key]=field)}return result}function projectRetrievalChunk(value){try{if(!value||typeof value!="object"||Array.isArray(value))return;const sourceValue=readOwnDataValue(value,"source");if(!sourceValue||typeof sourceValue!="object"||Array.isArray(sourceValue))return;const source=fields(sourceValue,["id","name","mimeType","uri","version"]),row=fields(value,["id","text","score","metadata","rank","queryId","stage","traceId"]);if(row.source=Object.freeze(source),!isValidRetrievalChunk(row))return;const locator=readOwnDataValue(value,"locator");locator!==void 0&&(row.locator=snapshotPublicCollection(locator));const scores=readOwnDataValue(value,"scores");return scores&&typeof scores=="object"&&!Array.isArray(scores)&&(row.scores=Object.freeze(fields(scores,["dense","sparse","rerank","final"]))),Object.freeze(row)}catch{return}}export{projectRetrievalChunk};

package/dist/components/retrieval/retrieval-results/retrieval-results.class.d.ts

@@ -1,4 +1,4 @@
-import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{DocumentLocator,RetrievalChunk}from'../../../ai/types.js';import type{LyraScoreThresholds}from'../../../internal/score-tiers.js';export type{LyraScoreThresholds}from'../../../internal/score-tiers.js';
+import type{LyraPageSource}from'../../../data-sources.js';import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{DocumentLocator,RetrievalChunk}from'../../../ai/types.js';import type{LyraScoreThresholds}from'../../../internal/score-tiers.js';export type{LyraScoreThresholds}from'../../../internal/score-tiers.js';
 /** The deprecated `lr-select`'s detail: the complete updated selection, both as bare ids and as one
 *  deterministic canonical `RetrievalChunk` record per id (`lr-selection-change` carries the same as
 *  `selectedChunkIds`). This contract is independent of the visible `without-dedupe` projection:
@@ -6,6 +6,8 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 export interface RetrievalResultsSelectDetail{chunkIds:string[];chunks:RetrievalChunk[];}export interface LyraRetrievalResultsEventMap{'lr-selection-change':CustomEvent<LyraEventDetailSnapshot<{selectedChunkIds:string[];chunks:RetrievalChunk[];}>>;
 /** @deprecated Use `lr-selection-change`. */
 'lr-select':CustomEvent<LyraEventDetailSnapshot<RetrievalResultsSelectDetail>>;'lr-load-more':CustomEvent<null>;'lr-chunk-open':CustomEvent<LyraEventDetailSnapshot<{chunkId:string;sourceId:string;anchor?:DocumentLocator;}>>;}export type RetrievalResultsGrouping='source'|'custom'|'none';export type RetrievalResultsPresentation='compact'|'expanded';
+/** Query semantics apply to the complete provider collection before paging. */
+export interface RetrievalResultsSourceQuery{readonly sort:'score'|'none';readonly withoutDedupe:boolean;readonly grouping:RetrievalResultsGrouping;readonly groupBy:LyraRetrievalResults['groupBy'];readonly groupLabel:LyraRetrievalResults['groupLabel'];readonly groupOrder:LyraRetrievalResults['groupOrder'];}export type RetrievalResultsSource=LyraPageSource<RetrievalChunk,RetrievalResultsSourceQuery>;
 /**
 * `<lr-retrieval-results>` — the orchestration-level ranked-chunk-list surface: takes raw
 * `RetrievalChunk[]` (the shared retrieval-and-grounding type from `src/ai/types.ts`) and adds
@@ -27,7 +29,7 @@ export interface RetrievalResultsSelectDetail{chunkIds:string[];chunks:Retrieval
 *
 * **Controlled component.** `chunks`/`selectedChunkIds`/`loading`/`errorText`/`hasMore` are all
 * host-owned;
-* this component never fetches, retries, or mutates its own copy of `chunks`. Selecting a row
+* without a dataSource, this component never fetches, retries, or mutates its own copy of `chunks`. Selecting a row
 * updates `selectedChunkIds` locally *then* emits `lr-selection-change` (the same "update own copy, then
 * emit; reassign to control" convention `<lr-source-picker>` already uses) so a host can either
 * accept the update as-is or override it before the next render.
@@ -49,6 +51,31 @@ export interface RetrievalResultsSelectDetail{chunkIds:string[];chunks:Retrieval
 * Public collection properties take bounded, clone-owned readonly snapshots. Create a new
 * collection and reassign it after changes; mutating the assigned array does not update the view.
 *
+* Input retains the first 10,000 results; the limit note reports the assigned source count.
+* Closed display fields are copied after identity admission, so nested records do not consume the
+* shared 50,000-value deep-copy budget. Replace the collection to publish source-record changes.
+*
+* With dataSource, the provider owns global sorting, deduplication, grouping and page totals.
+* Each page retains at most 500 records; required rendered text is bounded to 65,536 UTF-16 units
+* per record and locator paths to 500 segments. Oversized records fail visibly without truncating
+* their full text. Group labels come from globally computed provider metadata, never partial-page
+* callbacks. sourceTotal is unknown until an accepted response; legacy hasMore is inactive.
+* withoutDedupe permits distinct occurrence keys while row selection and events retain canonical
+* value.id. Canonical lookup must return key===value.id and complete records in global order.
+* Up to 10,000 explicit selected IDs resolve in sequential batches of at most 500; page/query/retry
+* changes retain their independent cache. Failed selection remains pending user intent until
+* retried, without partial events. External assignments and reconnect reconciliation are silent.
+* Active IDs locate once; manual page navigation does not reapply an unchanged active ID.
+* Same-source assignment or requestUpdate() refreshes; named paints retain pages and selection.
+* Source selection events freeze the complete record sequence and projected record fields while
+* retaining opaque metadata identity. Legacy events retain their complete-detail deep snapshot
+* and its existing failure budget. Removing dataSource restores the legacy chunks route.
+*
+* @csspart source-status - Provider loading or failure text.
+* @csspart source-retry - Failed provider page retry button.
+* @csspart source-pagination - Provider page navigation.
+* @csspart source-selection-status - Canonical selected-record loading or failure text.
+* @csspart source-selection-retry - Failed canonical selection lookup retry button.
 * @customElement lr-retrieval-results
 * @event lr-selection-change - The selected-chunk set changed. `detail: { selectedChunkIds, chunks }` —
 * `selectedChunkIds` is the complete updated selection (not just the toggled id), `chunks` the
@@ -88,6 +115,7 @@ export interface RetrievalResultsSelectDetail{chunkIds:string[];chunks:Retrieval
 * `::part(row-body)[data-selected]` is invalid CSS, and while virtualized `::part()` is the only
 * way in. A state part is a second token in the same `part` attribute, so a `[part~="…"]` (not
 * `[part="…"]`) selector is the one that matches inside a tree.
+* @csspart limit - Notice that only the first 10,000 input results were retained.
 * @csspart metadata - The `<dl>` of a chunk's `metadata` entries — omitted entirely when a chunk
 * has no `metadata`, or while `presentation="compact"`.
 * @csspart metadata-entry - One metadata key/value pair's wrapper.
@@ -116,7 +144,19 @@ export interface RetrievalResultsSelectDetail{chunkIds:string[];chunks:Retrieval
 * @status stable
 * @since 4.1.0
 */
-export declare class LyraRetrievalResults extends LyraElement<LyraRetrievalResultsEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
+export declare class LyraRetrievalResults extends LyraElement<LyraRetrievalResultsEventMap>{protected static collectionSupport:import("../../../internal/lyra-element.js").LyraCollectionSupport;protected static readonly identityCollectionProperties:readonly string[];protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
+/** Canonical source records are frozen projections with opaque metadata. Legacy details are
+* detached as one complete snapshot before entering this identity-preserving envelope. */
+protected static readonly identityEventDetailCollectionItems:Readonly<{'lr-selection-change':readonly string[];'lr-select':readonly string[];}>;private _dataSource?;private sourceEpoch;private sourceVersion;private sourceLifecycle;private sourceSyncing;private sourceInputs?;private sourceQueryInputs?;private sourceResult?;private sourceRows;private sourceGroups;private sourceSelectionInputs?;private sourceSelectionEvent?;private sourceSelectionFailed;private sourceActiveInputs?;private sourceReveal?;private sourceAdapter?;private readonly sourceRowKeys;private sourceStateVersion;private readonly sourcePages;
+/** Full-source provider; a present invalid source fails visibly instead of using chunks.
+* Reassign the same provider or call requestUpdate() to refresh its revision/cache. */
+get dataSource():RetrievalResultsSource|undefined;set dataSource(value:RetrievalResultsSource|undefined);
+/** Zero-based provider page. */
+sourcePage:number;
+/** Provider records per page, normalized to 1..500; changing size resets page 0. */
+sourcePageSize:number;
+/** Current query total, or null before success/without a source. */
+get sourceTotal():number|null;private get sourceMode();private get sourceBlocked();private get sourceSelectionBlocked();private projectSourceChunk;private validateSourcePage;private canonicalSourceAdapter;private syncSource;private syncSourceSelection;private acceptSourcePage;private syncSourceActive;private revealSourceActive;private currentSourceRow;private invalidateSourceLifecycle;adoptedCallback():void;
 /** The raw (not deduplicated/sorted/grouped) result set. Host-owned. */
 chunks:readonly RetrievalChunk[];
 /** Controlled selection, by chunk `id`. The component updates its own copy on toggle *then*
@@ -125,7 +165,8 @@ chunks:readonly RetrievalChunk[];
 selectedChunkIds:readonly string[];
 /** Omits the per-row `<lr-checkbox>`. */
 withoutSelection:boolean;
-/** Retained for compatibility. Identity is always nonblank and first-wins even when set. */
+/** Legacy chunks remain first-wins. In source mode, permits distinct occurrence keys for rows
+* sharing a canonical value.id; selection and active IDs still use the canonical ID. */
 withoutDedupe:boolean;
 /** `'score'` (default) sorts the canonical list descending by `score`; `'none'` preserves
 *  `chunks`' own given order. */
@@ -186,4 +227,4 @@ announce:boolean;
 *  says exactly what this region is. An explicit empty string clears the fallback. A non-empty
 *  host `aria-label` makes the host the sole overall owner; an explicitly empty host label stays
 *  empty on the region. */
-label?:string;private expandedChunkIds;private pendingFocusTarget;private previousProcessedChunkIds;private focusRestoreGeneration;private isMounting;private initialStateAnnounced;private connectionGeneration;private errorAnnouncementSink?;private emptyAnnouncementSink?;private readonly retrievalChunkKey;private wasEmptyPresented;private processedChunksCache?;private processedGroupingLocaleSignature;connectedCallback():void;disconnectedCallback():void;private deepActiveElement;private chunkAnchor;private renderedChunkIds;protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;private announcePresentedState;private restoreControlledFocus;private get effectiveVirtualizeAt();private canonicalChunks;private normalizedSelectedChunkIds;private get processedChunks();private computeProcessedChunks;private orderedGroupKeys;private bucketed;private stopOwnedEvent;private reportSelection;private toggleSelect;private stopRowToggle;private onChunkToggle;private readonly rowChunks;private rowChunksFor;private renderMetadata;private selectedMembership?;private isChunkSelected;private renderRow;private renderLoadMoreFooter;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-retrieval-results':LyraRetrievalResults;}}
+label?:string;private expandedChunkIds;private pendingFocusTarget;private previousProcessedChunkIds;private focusRestoreGeneration;private isMounting;private initialStateAnnounced;private connectionGeneration;private errorAnnouncementSink?;private emptyAnnouncementSink?;private readonly retrievalChunkKey;private wasEmptyPresented;private processedChunksCache?;private processedGroupingLocaleSignature;private explicitRefresh;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;private canonicalSource?;private canonicalCache;private canonicalById;private canonicalOrder;private ordinalSource?;private ordinalById;private limitInitialized;private previouslyInputTruncated;private inputLimitText;private renderInputLimit;connectedCallback():void;disconnectedCallback():void;private deepActiveElement;private chunkAnchor;private renderedChunkIds;protected willUpdate(changed:PropertyValues<this>):void;private sourceStatusInitialized;private sourceStatus;protected updated(changed:PropertyValues<this>):void;private announcePresentedState;private restoreControlledFocus;private get effectiveVirtualizeAt();private canonicalChunks;private normalizedSelectedChunkIds;private get processedChunks();private computeProcessedChunks;private orderedGroupKeys;private bucketed;private stopOwnedEvent;private reportSelection;private toggleSelect;private stopRowToggle;private onChunkToggle;private readonly rowChunks;private rowChunksFor;private renderMetadata;private selectedMembership?;private isChunkSelected;private renderRow;private legacyLoadMoreHandler;private renderLoadMoreFooter;private renderSource;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-retrieval-results':LyraRetrievalResults;}}

package/dist/components/retrieval/retrieval-results/retrieval-results.class.js

@@ -1,8 +1,9 @@
-import{__decorate}from"tslib";import{collectionSupport,writeNormalizedOwnedCollection}from"../../../internal/collection-snapshot.js";import{tag}from"../../../internal/prefix.js";import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity,canonicalIdentityList,isValidRetrievalChunk}from"../retrieval-identity.js";import{finiteCount,finiteRange}from"../../../internal/numbers.js";import{styles}from"./retrieval-results.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{renderRetrievalMetadata}from"../retrieval-metadata.js";import{deepActiveElementIn}from"../../../internal/active-element.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{announceAfterFirstPaint}from"../retrieval-announcements.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{LYRA_DEFAULT_chunkInspectorEmpty,LYRA_DEFAULT_chunkInspectorLabel,LYRA_DEFAULT_retrievalResultsSelectRowOrdinal,LYRA_DEFAULT_untitledSource,LYRA_DEFAULT_valueTruncated}from"../../../internal/default-strings/retrieval.generated.js";import{LYRA_DEFAULT_loadMore,LYRA_DEFAULT_valueInvalid}from"../../../internal/default-strings/shared.generated.js";function toLyraChunk(chunk){return{id:chunk.id,text:chunk.text,score:chunk.score,sourceId:chunk.source.id,title:chunk.source.name,anchor:chunk.locator,page:chunk.locator?.kind==="page"?chunk.locator.page:void 0}}function safeScore(score){return finiteRange(score,0,0,1)}class LyraRetrievalResults extends LyraElement{constructor(){super(...arguments),this.chunks=[],this.selectedChunkIds=[],this.withoutSelection=!1,this.withoutDedupe=!1,this.sort="score",this.grouping="none",this.presentation="expanded",this.thresholds={high:.75,medium:.5},this.virtualizeAt=50,this.activeChunkId="",this.loading=!1,this.hasMore=!1,this.errorText="",this.announce=!1,this.expandedChunkIds=[],this.previousProcessedChunkIds=[],this.focusRestoreGeneration=0,this.isMounting=!0,this.initialStateAnnounced=!1,this.connectionGeneration=0,this.retrievalChunkKey=item=>item.id,this.wasEmptyPresented=!1,this.processedGroupingLocaleSignature="",this.stopOwnedEvent=event=>{event.stopPropagation()},this.stopRowToggle=event=>{event.stopPropagation()},this.onChunkToggle=event=>{event.stopPropagation();const{chunkId,expanded}=event.detail,rest=this.expandedChunkIds.filter(id=>id!==chunkId);this.expandedChunkIds=expanded?[...rest,chunkId]:rest},this.rowChunks=new WeakMap,this.renderRow=(item,index,total)=>{const chunk=item,selected=this.isChunkSelected(chunk.id),rowLabel=chunk.source.name||this.localize("untitledSource");return html`
+import{__decorate}from"tslib";import{SourcePageController}from"../../../internal/source-page-controller.js";import{readOwnDataValue}from"../../../internal/data-descriptors.js";import{collectionSupport,publicCollectionTruncation,writeNormalizedOwnedCollection,snapshotEventDetail}from"../../../internal/collection-snapshot.js";import{projectRetrievalChunk}from"./retrieval-results-model.js";import{tag}from"../../../internal/prefix.js";import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{guard}from"lit/directives/guard.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity,canonicalIdentityList}from"../retrieval-identity.js";import{finiteCount,finiteRange,finiteInteger}from"../../../internal/numbers.js";import{styles}from"./retrieval-results.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{renderRetrievalMetadata}from"../retrieval-metadata.js";import{deepActiveElementIn}from"../../../internal/active-element.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{announceAfterFirstPaint}from"../retrieval-announcements.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{LYRA_DEFAULT_chunkInspectorEmpty,LYRA_DEFAULT_chunkInspectorLabel,LYRA_DEFAULT_retrievalResultsInputLimit,LYRA_DEFAULT_retrievalResultsSelectRowOrdinal,LYRA_DEFAULT_untitledSource,LYRA_DEFAULT_valueTruncated}from"../../../internal/default-strings/retrieval.generated.js";import{LYRA_DEFAULT_loadMore,LYRA_DEFAULT_loading,LYRA_DEFAULT_retry,LYRA_DEFAULT_sourceSelectionFailed,LYRA_DEFAULT_sourceSelectionLoading,LYRA_DEFAULT_tableLoadFailed,LYRA_DEFAULT_valueInvalid}from"../../../internal/default-strings/shared.generated.js";function toLyraChunk(chunk){return{id:chunk.id,text:chunk.text,score:chunk.score,sourceId:chunk.source.id,title:chunk.source.name,anchor:chunk.locator,page:chunk.locator?.kind==="page"?chunk.locator.page:void 0}}function safeScore(score){return finiteRange(score,0,0,1)}class LyraRetrievalResults extends LyraElement{constructor(){super(...arguments),this.sourceEpoch=0,this.sourceVersion=0,this.sourceLifecycle=0,this.sourceSyncing=!1,this.sourceRows=[],this.sourceGroups=[],this.sourceSelectionFailed=!1,this.sourceRowKeys=new WeakMap,this.sourceStateVersion=0,this.sourcePages=new SourcePageController(this,{normalizeRecord:(record,isCurrent)=>this.projectSourceChunk(record,isCurrent),validateMetadata:(result,query)=>this.validateSourcePage(result,query),onChange:()=>{this.sourceStateVersion++}}),this.sourcePage=0,this.sourcePageSize=100,this.chunks=[],this.selectedChunkIds=[],this.withoutSelection=!1,this.withoutDedupe=!1,this.sort="score",this.grouping="none",this.presentation="expanded",this.thresholds={high:.75,medium:.5},this.virtualizeAt=50,this.activeChunkId="",this.loading=!1,this.hasMore=!1,this.errorText="",this.announce=!1,this.expandedChunkIds=[],this.previousProcessedChunkIds=[],this.focusRestoreGeneration=0,this.isMounting=!0,this.initialStateAnnounced=!1,this.connectionGeneration=0,this.retrievalChunkKey=item=>this.sourceRowKeys.get(item)??item.id,this.wasEmptyPresented=!1,this.processedGroupingLocaleSignature="",this.explicitRefresh=!1,this.canonicalCache=[],this.canonicalById=new Map,this.canonicalOrder=new Map,this.ordinalById=new Map,this.limitInitialized=!1,this.previouslyInputTruncated=!1,this.sourceStatusInitialized=!1,this.sourceStatus="",this.stopOwnedEvent=event=>{event.stopPropagation()},this.stopRowToggle=event=>{event.stopPropagation()},this.onChunkToggle=event=>{event.stopPropagation();const{chunkId,expanded}=event.detail,rest=this.expandedChunkIds.filter(id=>id!==chunkId);this.expandedChunkIds=expanded?[...rest,chunkId]:rest},this.rowChunks=new WeakMap,this.renderRow=(item,index,total)=>{const chunk=item,selected=this.isChunkSelected(chunk.id),rowLabel=chunk.source.name||this.localize("untitledSource");return html`
       ${this.withoutSelection?nothing:html`<lr-checkbox
             part="select"
             data-chunk-id=${chunk.id}
             .checked=${selected}
+            .disabled=${this.sourceSelectionBlocked}
             aria-label=${this.localize("retrievalResultsSelectRowOrdinal",void 0,{index:getNumberFormat(this.effectiveLocale).format(index+1),total:getNumberFormat(this.effectiveLocale).format(total),label:rowLabel})}
             @lr-checkbox-toggle-request=${this.stopOwnedEvent}
             @input=${this.stopOwnedEvent}
@@ -25,38 +26,59 @@ import{__decorate}from"tslib";import{collectionSupport,writeNormalizedOwnedColle
           .ordinalIndex=${index+1}
           .ordinalTotal=${total}
           label=${rowLabel}
-          @lr-chunk-open=${e=>{e.stopPropagation(),this.emit("lr-chunk-open",e.detail)}}
-          @lr-chunk-toggle=${this.onChunkToggle}
+          @lr-chunk-open=${e=>{e.stopPropagation(),this.currentSourceRow(chunk)&&this.emit("lr-chunk-open",e.detail)}}
+          @lr-chunk-toggle=${event=>{event.stopPropagation(),this.currentSourceRow(chunk)&&this.onChunkToggle(event)}}
           @lr-toggle=${this.stopRowToggle}
         ></lr-chunk-inspector>
         ${this.presentation==="expanded"?this.renderMetadata(chunk.metadata):nothing}
       </div>
-    `}}static{this.defaultStrings={...super.defaultStrings,chunkInspectorEmpty:LYRA_DEFAULT_chunkInspectorEmpty,chunkInspectorLabel:LYRA_DEFAULT_chunkInspectorLabel,loadMore:LYRA_DEFAULT_loadMore,retrievalResultsSelectRowOrdinal:LYRA_DEFAULT_retrievalResultsSelectRowOrdinal,untitledSource:LYRA_DEFAULT_untitledSource,valueInvalid:LYRA_DEFAULT_valueInvalid,valueTruncated:LYRA_DEFAULT_valueTruncated}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["chunks","selectedChunkIds","groupOrder"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-selection-change","lr-select","lr-chunk-open"])}connectedCallback(){super.connectedCallback(),this.errorAnnouncementSink??=acquireAnnouncementSink("assertive",{document:this.ownerDocument,source:this}),this.emptyAnnouncementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this});const generation=++this.connectionGeneration;announceAfterFirstPaint(this,()=>generation===this.connectionGeneration,()=>{!this.announce||this.initialStateAnnounced||(this.initialStateAnnounced=!0,this.announcePresentedState())})}disconnectedCallback(){this.isMounting=!0,this.connectionGeneration+=1,this.errorAnnouncementSink?.release(),this.errorAnnouncementSink=void 0,this.emptyAnnouncementSink?.release(),this.emptyAnnouncementSink=void 0,this.wasEmptyPresented=!1,super.disconnectedCallback()}deepActiveElement(){return deepActiveElementIn(this.isConnected?this.shadowRoot:null)}chunkAnchor(start){let current=start;for(;current&&current!==this;){if(current.hasAttribute("data-chunk-id"))return current;if(current.parentElement){current=current.parentElement;continue}const root=current.getRootNode();current=root.nodeType===11&&"host"in root?root.host:null}return null}renderedChunkIds(){const roots=[this.renderRoot],virtualList=this.renderRoot.querySelector(tag("virtual-list"));return virtualList?.shadowRoot&&roots.push(virtualList.shadowRoot),roots.flatMap(root=>[...root.querySelectorAll(`${tag("chunk-inspector")}[data-chunk-id]`)].map(element=>element.getAttribute("data-chunk-id")).filter(id=>id!==null))}willUpdate(changed){super.willUpdate(changed);const groupingLocaleSignature=this.grouping==="source"?`${this.effectiveLocale}\0${this.localize("untitledSource")}`:"";if((this.processedChunksCache===void 0||changed.has("chunks")||changed.has("withoutDedupe")||changed.has("sort")||changed.has("grouping")||changed.has("groupBy")||changed.has("groupLabel")||changed.has("groupOrder")||groupingLocaleSignature!==this.processedGroupingLocaleSignature)&&(this.processedGroupingLocaleSignature=groupingLocaleSignature,this.processedChunksCache=this.computeProcessedChunks()),changed.has("chunks")){const present=new Set(this.processedChunks.chunks.map(chunk=>chunk.id)),kept=this.expandedChunkIds.filter(id=>present.has(id));kept.length!==this.expandedChunkIds.length&&(this.expandedChunkIds=kept)}if(changed.has("chunks")||changed.has("selectedChunkIds")){const normalized=this.normalizedSelectedChunkIds();if(normalized.length!==this.selectedChunkIds.length||normalized.some((id,index)=>id!==this.selectedChunkIds[index])){const shouldAnnounce=this.hasUpdated&&changed.has("chunks");writeNormalizedOwnedCollection(this,"selectedChunkIds",()=>{this.selectedChunkIds=normalized}),shouldAnnounce&&this.reportSelection(normalized)}}if(!changed.has("chunks")&&!changed.has("withoutDedupe")&&!changed.has("sort")&&!changed.has("grouping")&&!changed.has("groupBy")&&!changed.has("groupLabel")&&!changed.has("groupOrder")&&!changed.has("presentation")&&!changed.has("withoutSelection")&&!changed.has("virtualizeAt")&&!changed.has("loading")&&!changed.has("errorText"))return;const focusedId=this.chunkAnchor(this.deepActiveElement())?.getAttribute("data-chunk-id");if(!focusedId)return;const previousIds=this.previousProcessedChunkIds.length?this.previousProcessedChunkIds:this.renderedChunkIds(),focusedIndex=Math.max(0,previousIds.indexOf(focusedId)),nextChunks=this.errorText?[]:this.processedChunks.chunks;if(nextChunks.length===0){this.pendingFocusTarget="base";return}const survivingIndex=nextChunks.findIndex(chunk=>chunk.id===focusedId),nextIndex=survivingIndex>=0?survivingIndex:Math.min(focusedIndex,nextChunks.length-1);this.pendingFocusTarget=nextChunks[nextIndex].id}updated(changed){super.updated(changed);const wasMounting=this.isMounting;this.isMounting=!1,!wasMounting&&changed.has("errorText")&&this.errorText!==""&&this.isConnected&&(this.initialStateAnnounced=!0,this.errorAnnouncementSink?.announce(this.errorText));const emptyPresented=!this.loading&&this.errorText===""&&this.processedChunks.chunks.length===0;!wasMounting&&!this.wasEmptyPresented&&emptyPresented&&this.isConnected&&(this.initialStateAnnounced=!0,this.emptyAnnouncementSink?.announce(this.localize("chunkInspectorEmpty"))),this.wasEmptyPresented=emptyPresented,this.previousProcessedChunkIds=this.errorText?[]:this.processedChunks.chunks.map(chunk=>chunk.id);const generation=++this.focusRestoreGeneration,target=this.pendingFocusTarget;target!==void 0&&(this.pendingFocusTarget=void 0,this.restoreControlledFocus(target,generation))}announcePresentedState(){if(this.errorText!==""){this.errorAnnouncementSink?.announce(this.errorText);return}!this.loading&&this.processedChunks.chunks.length===0&&this.emptyAnnouncementSink?.announce(this.localize("chunkInspectorEmpty"))}async restoreControlledFocus(target,generation){if(await this.updateComplete,generation!==this.focusRestoreGeneration||!this.isConnected)return;if(target==="base"){this.renderRoot.querySelector('[part="base"]')?.focus();return}const virtualList=this.renderRoot.querySelector(tag("virtual-list"));if(await virtualList?.updateComplete,generation!==this.focusRestoreGeneration||!this.isConnected)return;const roots=[this.renderRoot];virtualList?.shadowRoot&&roots.push(virtualList.shadowRoot);const candidates=roots.flatMap(root=>[...root.querySelectorAll("[data-chunk-id]")]),checkbox=candidates.find(element=>element.localName===tag("checkbox")&&element.getAttribute("data-chunk-id")===target);if(checkbox){checkbox.focus();return}const inspector=candidates.find(element=>element.localName===tag("chunk-inspector")&&element.getAttribute("data-chunk-id")===target);await inspector?.updateComplete,!(generation!==this.focusRestoreGeneration||!this.isConnected)&&inspector?.shadowRoot?.querySelector('[part="open-button"]')?.focus()}get effectiveVirtualizeAt(){return finiteCount(this.virtualizeAt,50)}canonicalChunks(){return firstByRetrievalIdentity(Array.isArray(this.chunks)?this.chunks.filter(isValidRetrievalChunk):[],chunk=>chunk.id)}normalizedSelectedChunkIds(){const validIds=new Set(this.canonicalChunks().map(chunk=>chunk.id));return canonicalIdentityList(this.selectedChunkIds).filter(id=>validIds.has(id))}get processedChunks(){return this.processedChunksCache??=this.computeProcessedChunks()}computeProcessedChunks(){const canonical=this.canonicalChunks(),sorted=this.sort==="score"?canonical.sort((a,b)=>safeScore(b.score)-safeScore(a.score)):canonical;if(this.grouping==="source")return this.bucketed(sorted,chunk=>chunk.source.id,(_id,groupChunks)=>groupChunks[0].source.name||this.localize("untitledSource"));if(this.grouping==="custom"&&this.groupBy){const groupBy=this.groupBy;return this.bucketed(sorted,groupBy,(id,groupChunks)=>this.groupLabel?.(id,groupChunks)??id)}return{chunks:sorted,groups:[]}}orderedGroupKeys(grouped){const firstSeen=[...grouped.keys()];if(this.grouping!=="custom"||!this.groupOrder)return firstSeen;if(typeof this.groupOrder=="function")return firstSeen.sort(this.groupOrder);const ordered=[...new Set(this.groupOrder)].filter(id=>grouped.has(id)),listed=new Set(ordered);return[...ordered,...firstSeen.filter(id=>!listed.has(id))]}bucketed(sorted,keyOf,labelOf){const grouped=new Map;for(const chunk of sorted){const key=keyOf(chunk),existing=grouped.get(key);existing?existing.push(chunk):grouped.set(key,[chunk])}const rows=[],groups=[];for(const key of this.orderedGroupKeys(grouped)){const groupChunks=grouped.get(key);!groupChunks||groupChunks.length===0||(groups.push({key,label:labelOf(key,groupChunks),startIndex:rows.length}),rows.push(...groupChunks))}return{chunks:rows,groups}}reportSelection(chunkIds){const selected=new Set(chunkIds),chunks=this.canonicalChunks().filter(chunk=>selected.has(chunk.id));this.emit("lr-selection-change",{selectedChunkIds:chunkIds,chunks}),this.emit("lr-select",{chunkIds,chunks})}toggleSelect(chunk){const next=new Set(this.normalizedSelectedChunkIds());next.has(chunk.id)?next.delete(chunk.id):next.add(chunk.id),this.selectedChunkIds=[...next],this.reportSelection(this.selectedChunkIds)}rowChunksFor(chunk){let row=this.rowChunks.get(chunk);return row||this.rowChunks.set(chunk,row=[toLyraChunk(chunk)]),row}renderMetadata(metadata){return renderRetrievalMetadata(metadata,this.effectiveLocale,this.localize("valueInvalid"),this.localize("valueTruncated"))}isChunkSelected(id){const source=this.selectedChunkIds;return source.length===0||this.processedChunks.chunks.length<=1?(this.selectedMembership=void 0,source.includes(id)):(this.selectedMembership?.source!==source&&(this.selectedMembership={source,ids:new Set(source)}),this.selectedMembership.ids.has(id))}renderLoadMoreFooter(){return this.hasMore?html`
+    `}}static{this.defaultStrings={...super.defaultStrings,chunkInspectorEmpty:LYRA_DEFAULT_chunkInspectorEmpty,chunkInspectorLabel:LYRA_DEFAULT_chunkInspectorLabel,loadMore:LYRA_DEFAULT_loadMore,loading:LYRA_DEFAULT_loading,retrievalResultsInputLimit:LYRA_DEFAULT_retrievalResultsInputLimit,retrievalResultsSelectRowOrdinal:LYRA_DEFAULT_retrievalResultsSelectRowOrdinal,retry:LYRA_DEFAULT_retry,sourceSelectionFailed:LYRA_DEFAULT_sourceSelectionFailed,sourceSelectionLoading:LYRA_DEFAULT_sourceSelectionLoading,tableLoadFailed:LYRA_DEFAULT_tableLoadFailed,untitledSource:LYRA_DEFAULT_untitledSource,valueInvalid:LYRA_DEFAULT_valueInvalid,valueTruncated:LYRA_DEFAULT_valueTruncated}}static{this.collectionSupport=collectionSupport}static{this.identityCollectionProperties=Object.freeze(["chunks"])}static{this.ownedCollectionProperties=Object.freeze(["chunks","selectedChunkIds","groupOrder"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-selection-change","lr-select","lr-chunk-open"])}static{this.identityEventDetailCollectionItems=Object.freeze({"lr-selection-change":Object.freeze(["chunks"]),"lr-select":Object.freeze(["chunks"])})}get dataSource(){return this._dataSource}set dataSource(value){const old=this._dataSource;this._dataSource=value,this.sourceEpoch++,this.requestUpdate("dataSource",old)}get sourceTotal(){return this.sourceMode?this.sourcePages.state.result?.total??null:null}get sourceMode(){return this.dataSource!==void 0}get sourceBlocked(){return this.sourceMode&&(!this.isConnected||!!this.errorText||this.sourcePages.state.pending||!this.sourcePages.state.result)}get sourceSelectionBlocked(){return this.sourceBlocked||this.sourceMode&&(this.sourcePages.state.selectionPending||this.sourceSelectionFailed)}projectSourceChunk(record,isCurrent){let units=0;const read=(input,key)=>{if(!isCurrent())throw new Error("Obsolete source chunk");const value2=readOwnDataValue(input,key);if(!isCurrent())throw new Error("Obsolete source chunk");return value2},fields=(input,keys)=>{if(!input||typeof input!="object"||Array.isArray(input))throw new TypeError("Invalid source chunk");const copy={};for(const key of keys){const value2=read(input,key);if(typeof value2=="string"&&(units+=value2.length,value2.length>65536||units>65536))throw new RangeError("Source chunk text too large");value2!==void 0&&(copy[key]=value2)}return copy},raw=fields(record.value,["id","text","score","metadata","rank","queryId","stage","traceId","scores"]);raw.source=fields(read(record.value,"source"),["id","name","mimeType","uri","version"]);const locator=read(record.value,"locator");if(locator!==void 0){const projected=fields(locator,["kind","page","quote","prefix","suffix","id","start","end","sheet","range","cfi"]);for(const key of["kind","quote","prefix","suffix","id","sheet","range","cfi"])if(projected[key]!==void 0&&typeof projected[key]!="string")throw new TypeError("Invalid source locator text");for(const key of["page","start","end"])if(projected[key]!==void 0&&(typeof projected[key]!="number"||!Number.isFinite(projected[key])))throw new TypeError("Invalid source locator number");const rect=read(locator,"rect");if(rect!==void 0){const coordinates=fields(rect,["x","y","width","height"]);for(const key of["x","y","width","height"])if(typeof coordinates[key]!="number"||!Number.isFinite(coordinates[key]))throw new TypeError("Invalid source locator rectangle");projected.rect=coordinates}const path=read(locator,"path");if(path!==void 0){if(!Array.isArray(path))throw new TypeError("Invalid source locator path");const length=read(path,"length");if(typeof length!="number"||!Number.isSafeInteger(length)||length<0||length>500)throw new RangeError("Source locator path too large");projected.path=Array.from({length},(_,index)=>{const value2=read(path,String(index));if(typeof value2!="string"&&typeof value2!="number")throw new TypeError("Invalid source locator path");if(typeof value2=="string"&&(units+=value2.length,units>65536))throw new RangeError("Source chunk text too large");return value2})}raw.locator=projected}const scores=raw.scores;scores&&typeof scores=="object"&&!Array.isArray(scores)&&(raw.scores=fields(scores,["dense","sparse","rerank","final"]));const value=projectRetrievalChunk(raw);if(!isCurrent())throw new Error("Obsolete source chunk");if(!value)throw new TypeError("Invalid source chunk");return this.sourceRowKeys.set(value,record.key),{key:record.key,order:record.order,value}}validateSourcePage(result,query){if(!query.withoutDedupe&&result.rows.some(record=>record.key!==record.value.id))throw new TypeError("Invalid canonical source identity");if(query.grouping==="none"){if(result.groups?.length)throw new TypeError("Unexpected source groups");return}if(!result.groups)throw new TypeError("Missing source groups");if(!result.rows.length)return;const size=this.sourcePages.state.pageSize,start=Math.min(this.sourcePages.state.page,Math.floor((result.total-1)/size))*size,end=start+result.rows.length;let covered=start,previousEnd=-1;for(const group of result.groups){if(group.startIndex<previousEnd||Math.max(start,group.startIndex)!==covered)throw new TypeError("Invalid source group coverage");previousEnd=group.startIndex+group.itemCount,covered=Math.min(end,previousEnd)}if(covered!==end)throw new TypeError("Incomplete source groups")}canonicalSourceAdapter(source){if(this.sourceAdapter?.original===source)return this.sourceAdapter.adapter;if(!source||typeof source.query!="function"||typeof source.lookup!="function"||typeof source.locate!="function")throw new TypeError("Invalid source");const adapter={revision:source.revision,query:request=>source.query(request),locate:(key,query,context)=>source.locate(key,query,context),lookup:async(keys,context)=>{const records=await source.lookup(keys,context);if(!Array.isArray(records)||records.length>500)throw new TypeError("Invalid canonical lookup");for(let index=0;index<records.length;index++){const record=readOwnDataValue(records,String(index)),key=readOwnDataValue(record,"key"),value=readOwnDataValue(record,"value");if(key!==readOwnDataValue(value,"id"))throw new TypeError("Invalid canonical lookup identity")}return records}};return this.sourceAdapter={original:source,adapter},adapter}syncSource(force=!1){if(!(!this.sourcePages||this.sourceSyncing)){this.sourceSyncing=!0;try{if(!this.sourceMode){this.sourceInputs&&(this.sourceVersion++,this.focusRestoreGeneration++,this.sourcePages.bind(void 0),this.processedChunksCache=void 0),this.sourceInputs=void 0,this.sourceQueryInputs=void 0,this.sourceResult=void 0,this.sourceRows=[],this.sourceGroups=[],this.sourceSelectionInputs=void 0,this.sourceSelectionEvent=void 0,this.sourceActiveInputs=void 0,this.sourceReveal=void 0;return}const source=this.dataSource,size=finiteInteger(this.sourcePageSize,100,1,500);let page=finiteInteger(this.sourcePage,0,0,Math.floor(Number.MAX_SAFE_INTEGER/size));const queryInputs=[this.sort,this.withoutDedupe,this.grouping,this.groupBy,this.groupLabel,this.groupOrder,size];this.hasUpdated&&this.sourceQueryInputs&&queryInputs.some((value,index)=>value!==this.sourceQueryInputs[index])&&(page=0,this.sourcePage=0),this.sourceQueryInputs=queryInputs;const inputs=[source,source.revision,this.sourceEpoch,this.effectiveLocale,...queryInputs,page];if(!force&&this.sourceInputs&&inputs.every((value,index)=>value===this.sourceInputs[index]))return;(!this.sourceInputs||inputs.slice(0,3).some((value,index)=>value!==this.sourceInputs[index]))&&(this.sourceSelectionInputs=void 0,this.sourceSelectionEvent=void 0),this.sourceInputs=inputs,this.sourceVersion++,this.focusRestoreGeneration++,this.sourceRows=[],this.sourceGroups=[],this.sourceResult=void 0,this.sourceReveal=void 0,this.expandedChunkIds=[],this.sourcePages.bind({source:this.canonicalSourceAdapter(source),revision:source.revision,epoch:this.sourceEpoch,locale:this.effectiveLocale});const query=Object.freeze({sort:this.sort,withoutDedupe:this.withoutDedupe,grouping:this.grouping,groupBy:this.groupBy,groupLabel:this.groupLabel,groupOrder:this.groupOrder});this.sourcePages.request(query,page,size)}catch{this.sourcePages.bind(void 0),this.sourceRows=[],this.sourceGroups=[],this.sourceResult=void 0}finally{this.sourceSyncing=!1}}}syncSourceSelection(){if(!this.sourceMode||!this.isConnected||!this.sourceAdapter||!this.sourceInputs)return;const ids=this.selectedChunkIds,source=this.dataSource,epoch=this.sourceEpoch,revision=source.revision,inputs=[source,revision,epoch,ids];if(this.sourceSelectionInputs&&inputs.every((value,index)=>value===this.sourceSelectionInputs[index]))return;this.sourceSelectionInputs=inputs,this.sourceSelectionFailed=!1;const owner=this.ownerDocument,lifecycle=this.sourceLifecycle,canonicalIds=canonicalIdentityList(ids);this.sourcePages.resolveSelection(canonicalIds).then(records=>{if(source.revision!==revision||lifecycle!==this.sourceLifecycle||!this.isConnected||this.ownerDocument!==owner||this.dataSource!==source||this.sourceEpoch!==epoch||this.selectedChunkIds!==ids)return;if(!records){this.sourceSelectionFailed=!0,this.sourceStateVersion++;return}const retained=new Set(records.map(record=>record.key)),accepted=canonicalIds.filter(id=>retained.has(id)),report=this.sourceSelectionEvent===ids;this.sourceSelectionEvent=void 0,accepted.length!==ids.length&&(this.selectedChunkIds=accepted);const committed=this.selectedChunkIds;if(report){const chunks=records.map(record=>record.value);this.emit("lr-selection-change",{selectedChunkIds:[...committed],chunks}),source.revision===revision&&lifecycle===this.sourceLifecycle&&this.isConnected&&this.ownerDocument===owner&&this.dataSource===source&&this.sourceEpoch===epoch&&this.selectedChunkIds===committed&&this.emit("lr-select",{chunkIds:[...committed],chunks})}this.sourceStateVersion++})}acceptSourcePage(){const result=this.sourcePages.state.result;if(!result||result===this.sourceResult)return;this.sourceResult=result,this.sourceRows=result.rows.map(record=>record.value);const start=this.sourcePages.state.page*this.sourcePages.state.pageSize;this.sourceGroups=(result.groups??[]).map(group=>({key:group.key,label:group.label,startIndex:Math.max(0,group.startIndex-start)})),this.sourcePage!==this.sourcePages.state.page&&(this.sourceSyncing=!0,this.sourcePage=this.sourcePages.state.page,this.sourceSyncing=!1,this.sourceInputs=this.sourceInputs?[...this.sourceInputs.slice(0,-1),this.sourcePages.state.page]:void 0);const reveal=this.sourceReveal;this.sourceReveal=void 0,reveal?.version===this.sourceVersion&&this.revealSourceActive(reveal.id,reveal.version)}syncSourceActive(){if(!this.activeChunkId){this.sourceActiveInputs=void 0;return}if(this.sourceBlocked)return;const source=this.dataSource,id=this.activeChunkId,inputs=[source,source.revision,this.sourceEpoch,this.effectiveLocale,...this.sourceQueryInputs??[],id];if(this.sourceActiveInputs&&inputs.every((value,index)=>value===this.sourceActiveInputs[index]))return;this.sourceActiveInputs=inputs;const version=this.sourceVersion,owner=this.ownerDocument;this.sourcePages.locate(id).then(index=>{if(index===null||!this.isConnected||this.ownerDocument!==owner||!this.sourceMode||this.dataSource!==source||this.sourceVersion!==version||this.activeChunkId!==id)return;const page=Math.floor(index/finiteInteger(this.sourcePageSize,100,1,500));if(page===this.sourcePage){this.revealSourceActive(id,version);return}this.sourcePage=page,this.sourceReveal={id,version:this.sourceVersion}})}revealSourceActive(id,version){const owner=this.ownerDocument;this.updateComplete.then(async()=>{const list=this.renderRoot.querySelector(tag("virtual-list"));if(!list||(await list.updateComplete,!this.isConnected||this.ownerDocument!==owner||!this.sourceMode||this.sourceBlocked||this.sourceVersion!==version||this.activeChunkId!==id||list!==this.renderRoot.querySelector(tag("virtual-list"))))return;const index=this.sourceRows.findIndex(chunk=>chunk.id===id);index>=0&&list.scrollToIndex(index,{align:"auto",behavior:"auto"})})}currentSourceRow(chunk){return!(this.sourceMode||this.sourceRowKeys.has(chunk))||this.sourceMode&&!this.sourceBlocked&&this.sourceRows.includes(chunk)}invalidateSourceLifecycle(){this.sourceLifecycle++,this.sourceVersion++,this.focusRestoreGeneration++,this.sourceSelectionInputs=void 0,this.sourceSelectionEvent=void 0,this.sourceActiveInputs=void 0,this.sourceReveal=void 0,this.sourceStatusInitialized=!1,this.sourceStatus=""}adoptedCallback(){this.invalidateSourceLifecycle(),this.sourcePages.adopted(),super.adoptedCallback()}requestUpdate(...args){args[0]===void 0&&(this.explicitRefresh=!0,this.sourceEpoch=(this.sourceEpoch??0)+1),args[0]==="selectedChunkIds"&&(this.sourceSelectionEvent=void 0),(args[0]===void 0||["dataSource","sourcePage","sourcePageSize","sort","withoutDedupe","grouping","groupBy","groupLabel","groupOrder"].includes(String(args[0])))&&this.syncSource(),super.requestUpdate(...args)}inputLimitText(){if(this.sourceMode)return"";const truncation=publicCollectionTruncation(this,"chunks"),number=getNumberFormat(this.effectiveLocale);return truncation?this.localize("retrievalResultsInputLimit",void 0,{count:number.format(truncation.retained),total:number.format(truncation.source)}):""}renderInputLimit(){const text=this.inputLimitText();return text?html`<p part="limit" role="note">${text}</p>`:nothing}connectedCallback(){super.connectedCallback(),this.errorAnnouncementSink??=acquireAnnouncementSink("assertive",{document:this.ownerDocument,source:this}),this.emptyAnnouncementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this});const generation=++this.connectionGeneration;announceAfterFirstPaint(this,()=>generation===this.connectionGeneration,()=>{!this.announce||this.initialStateAnnounced||(this.initialStateAnnounced=!0,this.announcePresentedState())})}disconnectedCallback(){this.invalidateSourceLifecycle(),this.isMounting=!0,this.connectionGeneration+=1,this.errorAnnouncementSink?.release(),this.errorAnnouncementSink=void 0,this.emptyAnnouncementSink?.release(),this.emptyAnnouncementSink=void 0,this.wasEmptyPresented=!1,super.disconnectedCallback()}deepActiveElement(){return deepActiveElementIn(this.isConnected?this.shadowRoot:null)}chunkAnchor(start){let current=start;for(;current&&current!==this;){if(current.hasAttribute("data-chunk-id"))return current;if(current.parentElement){current=current.parentElement;continue}const root=current.getRootNode();current=root.nodeType===11&&"host"in root?root.host:null}return null}renderedChunkIds(){const roots=[this.renderRoot],virtualList=this.renderRoot.querySelector(tag("virtual-list"));return virtualList?.shadowRoot&&roots.push(virtualList.shadowRoot),roots.flatMap(root=>[...root.querySelectorAll(`${tag("chunk-inspector")}[data-chunk-id]`)].map(element=>element.getAttribute("data-chunk-id")).filter(id=>id!==null))}willUpdate(changed){if(super.willUpdate(changed),this.syncSource(),this.sourceMode){this.acceptSourcePage(),this.syncSourceSelection(),this.syncSourceActive();return}const refresh=this.explicitRefresh;this.explicitRefresh=!1;const groupingLocaleSignature=this.grouping==="source"?`${this.effectiveLocale}\0${this.localize("untitledSource")}`:"";if((this.processedChunksCache===void 0||refresh||changed.has("chunks")||changed.has("withoutDedupe")||changed.has("sort")||changed.has("grouping")||changed.has("groupBy")||changed.has("groupLabel")||changed.has("groupOrder")||groupingLocaleSignature!==this.processedGroupingLocaleSignature)&&(this.processedGroupingLocaleSignature=groupingLocaleSignature,this.processedChunksCache=this.computeProcessedChunks()),changed.has("chunks")){const present=new Set(this.processedChunks.chunks.map(chunk=>chunk.id)),kept=this.expandedChunkIds.filter(id=>present.has(id));kept.length!==this.expandedChunkIds.length&&(this.expandedChunkIds=kept)}if(changed.has("chunks")||changed.has("selectedChunkIds")){const normalized=this.normalizedSelectedChunkIds();if(normalized.length!==this.selectedChunkIds.length||normalized.some((id,index)=>id!==this.selectedChunkIds[index])){const shouldAnnounce=this.hasUpdated&&changed.has("chunks");writeNormalizedOwnedCollection(this,"selectedChunkIds",()=>{this.selectedChunkIds=normalized}),shouldAnnounce&&this.reportSelection(normalized)}}if(!changed.has("chunks")&&!changed.has("withoutDedupe")&&!changed.has("sort")&&!changed.has("grouping")&&!changed.has("groupBy")&&!changed.has("groupLabel")&&!changed.has("groupOrder")&&!changed.has("presentation")&&!changed.has("withoutSelection")&&!changed.has("virtualizeAt")&&!changed.has("loading")&&!changed.has("errorText"))return;const focusedId=this.chunkAnchor(this.deepActiveElement())?.getAttribute("data-chunk-id");if(!focusedId)return;const previousIds=this.previousProcessedChunkIds.length?this.previousProcessedChunkIds:this.renderedChunkIds(),focusedIndex=Math.max(0,previousIds.indexOf(focusedId)),nextChunks=this.errorText?[]:this.processedChunks.chunks;if(nextChunks.length===0){this.pendingFocusTarget="base";return}const survivingIndex=nextChunks.findIndex(chunk=>chunk.id===focusedId),nextIndex=survivingIndex>=0?survivingIndex:Math.min(focusedIndex,nextChunks.length-1);this.pendingFocusTarget=nextChunks[nextIndex].id}updated(changed){if(super.updated(changed),this.sourceMode){const status=this.sourcePages.state.pending?this.localize("loading"):this.sourcePages.state.result?this.sourcePages.state.selectionPending?this.localize("sourceSelectionLoading"):this.sourceSelectionFailed?this.localize("sourceSelectionFailed"):"":this.localize("tableLoadFailed");this.sourceStatusInitialized&&status&&status!==this.sourceStatus&&this.emptyAnnouncementSink?.announce(status),this.sourceStatusInitialized=!0,this.sourceStatus=status;return}const inputTruncated=publicCollectionTruncation(this,"chunks")!==void 0;this.limitInitialized&&inputTruncated&&!this.previouslyInputTruncated&&this.emptyAnnouncementSink?.announce(this.inputLimitText()),this.limitInitialized=!0,this.previouslyInputTruncated=inputTruncated;const wasMounting=this.isMounting;this.isMounting=!1,!wasMounting&&changed.has("errorText")&&this.errorText!==""&&this.isConnected&&(this.initialStateAnnounced=!0,this.errorAnnouncementSink?.announce(this.errorText));const emptyPresented=!this.loading&&this.errorText===""&&this.processedChunks.chunks.length===0;!wasMounting&&!this.wasEmptyPresented&&emptyPresented&&this.isConnected&&(this.initialStateAnnounced=!0,this.emptyAnnouncementSink?.announce(this.localize("chunkInspectorEmpty"))),this.wasEmptyPresented=emptyPresented,this.previousProcessedChunkIds=this.errorText?[]:this.processedChunks.chunks.map(chunk=>chunk.id);const generation=++this.focusRestoreGeneration,target=this.pendingFocusTarget;target!==void 0&&(this.pendingFocusTarget=void 0,this.restoreControlledFocus(target,generation))}announcePresentedState(){if(!this.sourceMode){if(this.errorText!==""){this.errorAnnouncementSink?.announce(this.errorText);return}!this.loading&&this.processedChunks.chunks.length===0&&this.emptyAnnouncementSink?.announce(this.localize("chunkInspectorEmpty"))}}async restoreControlledFocus(target,generation){if(await this.updateComplete,generation!==this.focusRestoreGeneration||!this.isConnected)return;if(target==="base"){this.renderRoot.querySelector('[part="base"]')?.focus();return}const virtualList=this.renderRoot.querySelector(tag("virtual-list"));if(await virtualList?.updateComplete,generation!==this.focusRestoreGeneration||!this.isConnected)return;const roots=[this.renderRoot];virtualList?.shadowRoot&&roots.push(virtualList.shadowRoot);const candidates=roots.flatMap(root=>[...root.querySelectorAll("[data-chunk-id]")]),checkbox=candidates.find(element=>element.localName===tag("checkbox")&&element.getAttribute("data-chunk-id")===target);if(checkbox){checkbox.focus();return}const inspector=candidates.find(element=>element.localName===tag("chunk-inspector")&&element.getAttribute("data-chunk-id")===target);await inspector?.updateComplete,!(generation!==this.focusRestoreGeneration||!this.isConnected)&&inspector?.shadowRoot?.querySelector('[part="open-button"]')?.focus()}get effectiveVirtualizeAt(){return finiteCount(this.virtualizeAt,50)}canonicalChunks(){return this.canonicalSource!==this.chunks&&(this.canonicalSource=this.chunks,this.canonicalCache=firstByRetrievalIdentity(this.chunks.flatMap(value=>projectRetrievalChunk(value)??[]),chunk=>chunk.id),this.canonicalById=new Map(this.canonicalCache.map(chunk=>[chunk.id,chunk])),this.canonicalOrder=new Map(this.canonicalCache.map((chunk,index)=>[chunk.id,index]))),this.canonicalCache}normalizedSelectedChunkIds(){return this.canonicalSource!==this.chunks&&this.canonicalChunks(),canonicalIdentityList(this.selectedChunkIds).filter(id=>this.canonicalById.has(id))}get processedChunks(){return this.sourceMode?{chunks:this.sourceRows,groups:this.sourceGroups}:this.processedChunksCache??=this.computeProcessedChunks()}computeProcessedChunks(){const canonical=this.canonicalChunks(),sorted=this.sort==="score"?[...canonical].sort((a,b)=>safeScore(b.score)-safeScore(a.score)):canonical;if(this.grouping==="source")return this.bucketed(sorted,chunk=>chunk.source.id,(_id,groupChunks)=>groupChunks[0].source.name||this.localize("untitledSource"));if(this.grouping==="custom"&&this.groupBy){const groupBy=this.groupBy;return this.bucketed(sorted,groupBy,(id,groupChunks)=>this.groupLabel?.(id,groupChunks)??id)}return{chunks:sorted,groups:[]}}orderedGroupKeys(grouped){const firstSeen=[...grouped.keys()];if(this.grouping!=="custom"||!this.groupOrder)return firstSeen;if(typeof this.groupOrder=="function")return firstSeen.sort(this.groupOrder);const ordered=[...new Set(this.groupOrder)].filter(id=>grouped.has(id)),listed=new Set(ordered);return[...ordered,...firstSeen.filter(id=>!listed.has(id))]}bucketed(sorted,keyOf,labelOf){const grouped=new Map;for(const chunk of sorted){const key=keyOf(chunk),existing=grouped.get(key);existing?existing.push(chunk):grouped.set(key,[chunk])}const rows=[],groups=[];for(const key of this.orderedGroupKeys(grouped)){const groupChunks=grouped.get(key);!groupChunks||groupChunks.length===0||(groups.push({key,label:labelOf(key,groupChunks),startIndex:rows.length}),rows.push(...groupChunks))}return{chunks:rows,groups}}reportSelection(chunkIds){this.canonicalSource!==this.chunks&&this.canonicalChunks();const chunks=[...new Set(chunkIds)].flatMap(id=>this.canonicalById.get(id)??[]).sort((a,b)=>this.canonicalOrder.get(a.id)-this.canonicalOrder.get(b.id));this.emit("lr-selection-change",snapshotEventDetail({selectedChunkIds:chunkIds,chunks},this.ownerDocument.defaultView)),this.emit("lr-select",snapshotEventDetail({chunkIds,chunks},this.ownerDocument.defaultView))}toggleSelect(chunk){if(!this.currentSourceRow(chunk)||this.sourceSelectionBlocked)return;if(this.sourceMode){const next2=new Set(this.selectedChunkIds);next2.has(chunk.id)?next2.delete(chunk.id):next2.size<1e4&&next2.add(chunk.id),this.selectedChunkIds=[...next2],this.sourceSelectionEvent=this.selectedChunkIds;return}const next=new Set(this.normalizedSelectedChunkIds());next.has(chunk.id)?next.delete(chunk.id):next.add(chunk.id),this.selectedChunkIds=[...next],this.reportSelection(this.selectedChunkIds)}rowChunksFor(chunk){let row=this.rowChunks.get(chunk);return row||this.rowChunks.set(chunk,row=[toLyraChunk(chunk)]),row}renderMetadata(metadata){return renderRetrievalMetadata(metadata,this.effectiveLocale,this.localize("valueInvalid"),this.localize("valueTruncated"))}isChunkSelected(id){const source=this.selectedChunkIds;return source.length===0||this.processedChunks.chunks.length<=1?(this.selectedMembership=void 0,source.includes(id)):(this.selectedMembership?.source!==source&&(this.selectedMembership={source,ids:new Set(source)}),this.selectedMembership.ids.has(id))}legacyLoadMoreHandler(){const chunks=this.chunks,version=this.sourceVersion;return event=>{event.stopPropagation(),!(!this.isConnected||this.sourceMode||this.sourceVersion!==version||this.chunks!==chunks||!this.hasMore||this.loading||this.errorText||event.currentTarget?.getRootNode()!==this.renderRoot)&&this.emit("lr-load-more")}}renderLoadMoreFooter(){return this.hasMore?html`
       <div part="load-more-row">
         ${this.loading?html`<lr-spinner part="spinner"></lr-spinner>`:html`<button
               type="button"
               part="load-more"
-              @click=${()=>this.emit("lr-load-more")}
+              @click=${this.legacyLoadMoreHandler()}
             >
               ${this.localize("loadMore")}
             </button>`}
       </div>
-    `:nothing}render(){(this.selectedMembership?.source!==this.selectedChunkIds||this.errorText||this.chunks.length<=1)&&(this.selectedMembership=void 0);const label=retrievalSemanticLabel(this,this.label==null?this.localize("chunkInspectorLabel"):this.label),groupRole=retrievalSemanticRole(this,"group");if(this.errorText)return html`<div part="base" tabindex="-1">
+    `:nothing}renderSource(){const state2=this.sourcePages.state,source=this.dataSource,version=this.sourceVersion,current=()=>this.isConnected&&this.sourceMode&&this.dataSource===source&&this.sourcePages.state===state2&&this.sourceVersion===version,rows=this.sourceRows;return html`<div part="base" tabindex="-1" role=${retrievalSemanticRole(this,"group")??nothing}
+      aria-label=${retrievalSemanticLabel(this,this.label??this.localize("chunkInspectorLabel"))??nothing}>
+      ${this.errorText?html`<div part="error">${this.errorText}</div>`:state2.pending?html`<p part="source-status">${this.localize("loading")}</p>`:state2.result?rows.length?html`<lr-virtual-list
+          exportparts="row:row, group:group-header, select:select, row-body:row-body, row-body-selected:row-body-selected, metadata:metadata, metadata-entry:metadata-entry, metadata-term:metadata-term, metadata-value:metadata-value, chunk:chunk, chunk-current:chunk-current, chunk-score:chunk-score, chunk-score-current:chunk-score-current, chunk-score-bar:chunk-score-bar, chunk-score-fill:chunk-score-fill, chunk-score-fill-success:chunk-score-fill-success, chunk-score-fill-warning:chunk-score-fill-warning, chunk-score-fill-danger:chunk-score-fill-danger, chunk-open-button:chunk-open-button, chunk-title:chunk-title, chunk-text:chunk-text, chunk-text-clamped:chunk-text-clamped, chunk-toggle:chunk-toggle"
+          .items=${guard([rows],()=>rows)} .groups=${this.sourceGroups}
+          .keyFunction=${this.retrievalChunkKey}
+          .renderItem=${(item,index)=>this.renderRow(item,state2.page*state2.pageSize+index,state2.result.total)}
+          @lr-load-more=${this.stopOwnedEvent} @lr-virtual-scroll=${this.stopOwnedEvent} @lr-visible-range-change=${this.stopOwnedEvent}
+        ></lr-virtual-list>`:html`<lr-empty part="empty" heading=${this.localize("chunkInspectorEmpty")}></lr-empty>`:html`<p part="source-status">${this.localize("tableLoadFailed")} <button type="button" part="source-retry" @click=${()=>{current()&&(this.syncSource(!0),this.sourceStateVersion++)}}>${this.localize("retry")}</button></p>`}
+      ${state2.selectionPending||this.sourceSelectionFailed?html`<p part="source-selection-status">${this.localize(state2.selectionPending?"sourceSelectionLoading":"sourceSelectionFailed")}
+        ${this.sourceSelectionFailed?html`<button type="button" part="source-selection-retry" @click=${()=>{current()&&(this.sourceSelectionInputs=void 0,this.syncSourceSelection())}}>${this.localize("retry")}</button>`:nothing}</p>`:nothing}
+      <lr-pagination part="source-pagination" format="compact" .strings=${this.strings}
+        .page=${finiteInteger(this.sourcePage,0,0,Number.MAX_SAFE_INTEGER-1)+1} .pageSize=${finiteInteger(this.sourcePageSize,100,1,500)}
+        .total=${this.sourceTotal??-1} .disabled=${this.sourceBlocked||this.sourceTotal===null}
+        @lr-page-change=${event=>{event.stopPropagation(),this.sourceBlocked||(this.sourcePage=event.detail.page-1)}}
+        @lr-before-page-change=${this.stopOwnedEvent} @lr-activate=${this.stopOwnedEvent} @focus=${this.stopOwnedEvent} @blur=${this.stopOwnedEvent}
+      ></lr-pagination>
+    </div>`}render(){if((this.selectedMembership?.source!==this.selectedChunkIds||this.errorText||this.chunks.length<=1)&&(this.selectedMembership=void 0),this.sourceMode)return this.renderSource();const label=retrievalSemanticLabel(this,this.label==null?this.localize("chunkInspectorLabel"):this.label),groupRole=retrievalSemanticRole(this,"group");if(this.errorText)return html`<div part="base" tabindex="-1">
+        ${this.renderInputLimit()}
         <div part="error">${this.errorText}</div>
       </div>`;const processed=this.processedChunks;if(processed.chunks.length<=1&&(this.selectedMembership=void 0),processed.chunks.length===0)return this.loading?html`<div part="base" tabindex="-1">
+          ${this.renderInputLimit()}
           <lr-spinner part="spinner"></lr-spinner>
         </div>`:html`<div part="base" tabindex="-1">
+        ${this.renderInputLimit()}
         <lr-empty
           part="empty"
           heading=${this.localize("chunkInspectorEmpty")}
         ></lr-empty>
-      </div>`;const useVirtualList=processed.groups.length>0||processed.chunks.length>this.effectiveVirtualizeAt,ordinalById=new Map(processed.chunks.map((chunk,index)=>[chunk.id,index])),renderVirtualRow=item=>this.renderRow(item,ordinalById.get(item.id)??0,processed.chunks.length);return html`
+      </div>`;const useVirtualList=processed.groups.length>0||processed.chunks.length>this.effectiveVirtualizeAt;this.ordinalSource!==processed.chunks&&(this.ordinalSource=processed.chunks,this.ordinalById=new Map(processed.chunks.map((chunk,index)=>[chunk.id,index])));const ordinalById=this.ordinalById,renderVirtualRow=item=>this.renderRow(item,ordinalById.get(item.id)??0,processed.chunks.length);return html`
       <div
         part="base"
         role=${groupRole??nothing}
         tabindex="-1"
         aria-label=${label??nothing}
       >
+        ${this.renderInputLimit()}
         ${useVirtualList?html`<lr-virtual-list
               exportparts="row:row, group:group-header, select:select, row-body:row-body, row-body-selected:row-body-selected, metadata:metadata, metadata-entry:metadata-entry, metadata-term:metadata-term, metadata-value:metadata-value, chunk:chunk, chunk-current:chunk-current, chunk-score:chunk-score, chunk-score-current:chunk-score-current, chunk-score-bar:chunk-score-bar, chunk-score-fill:chunk-score-fill, chunk-score-fill-success:chunk-score-fill-success, chunk-score-fill-warning:chunk-score-fill-warning, chunk-score-fill-danger:chunk-score-fill-danger, chunk-open-button:chunk-open-button, chunk-title:chunk-title, chunk-text:chunk-text, chunk-text-clamped:chunk-text-clamped, chunk-toggle:chunk-toggle"
               .items=${guard([processed.chunks],()=>processed.chunks)}
@@ -66,7 +88,7 @@ import{__decorate}from"tslib";import{collectionSupport,writeNormalizedOwnedColle
               .activeItemId=${this.activeChunkId||""}
               ?loading=${this.loading}
               ?has-more=${this.hasMore}
-              @lr-load-more=${e=>{e.stopPropagation(),this.emit("lr-load-more")}}
+              @lr-load-more=${this.legacyLoadMoreHandler()}
               @lr-virtual-scroll=${this.stopOwnedEvent}
               @lr-visible-range-change=${this.stopOwnedEvent}
             ></lr-virtual-list>`:html`<div role="list">
@@ -76,4 +98,4 @@ import{__decorate}from"tslib";import{collectionSupport,writeNormalizedOwnedColle
               </div>
               ${this.renderLoadMoreFooter()}`}
       </div>
-    `}}__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"chunks",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"selectedChunkIds",void 0),__decorate([property({type:Boolean,attribute:"without-selection",reflect:!0})],LyraRetrievalResults.prototype,"withoutSelection",void 0),__decorate([property({type:Boolean,attribute:"without-dedupe",reflect:!0})],LyraRetrievalResults.prototype,"withoutDedupe",void 0),__decorate([property()],LyraRetrievalResults.prototype,"sort",void 0),__decorate([property()],LyraRetrievalResults.prototype,"grouping",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupBy",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupLabel",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupOrder",void 0),__decorate([property()],LyraRetrievalResults.prototype,"presentation",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"thresholds",void 0),__decorate([property({type:Number,attribute:"virtualize-at"})],LyraRetrievalResults.prototype,"virtualizeAt",void 0),__decorate([property({attribute:"active-chunk-id"})],LyraRetrievalResults.prototype,"activeChunkId",void 0),__decorate([property({type:Boolean,reflect:!0})],LyraRetrievalResults.prototype,"loading",void 0),__decorate([property({type:Boolean,attribute:"has-more",reflect:!0})],LyraRetrievalResults.prototype,"hasMore",void 0),__decorate([property({attribute:"error-text"})],LyraRetrievalResults.prototype,"errorText",void 0),__decorate([property({type:Boolean,reflect:!0})],LyraRetrievalResults.prototype,"announce",void 0),__decorate([property()],LyraRetrievalResults.prototype,"label",void 0),__decorate([state()],LyraRetrievalResults.prototype,"expandedChunkIds",void 0);export{LyraRetrievalResults};
+    `}}__decorate([state()],LyraRetrievalResults.prototype,"sourceStateVersion",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"dataSource",null),__decorate([property({type:Number,attribute:"source-page"})],LyraRetrievalResults.prototype,"sourcePage",void 0),__decorate([property({type:Number,attribute:"source-page-size"})],LyraRetrievalResults.prototype,"sourcePageSize",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"chunks",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"selectedChunkIds",void 0),__decorate([property({type:Boolean,attribute:"without-selection",reflect:!0})],LyraRetrievalResults.prototype,"withoutSelection",void 0),__decorate([property({type:Boolean,attribute:"without-dedupe",reflect:!0})],LyraRetrievalResults.prototype,"withoutDedupe",void 0),__decorate([property()],LyraRetrievalResults.prototype,"sort",void 0),__decorate([property()],LyraRetrievalResults.prototype,"grouping",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupBy",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupLabel",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"groupOrder",void 0),__decorate([property()],LyraRetrievalResults.prototype,"presentation",void 0),__decorate([property({attribute:!1})],LyraRetrievalResults.prototype,"thresholds",void 0),__decorate([property({type:Number,attribute:"virtualize-at"})],LyraRetrievalResults.prototype,"virtualizeAt",void 0),__decorate([property({attribute:"active-chunk-id"})],LyraRetrievalResults.prototype,"activeChunkId",void 0),__decorate([property({type:Boolean,reflect:!0})],LyraRetrievalResults.prototype,"loading",void 0),__decorate([property({type:Boolean,attribute:"has-more",reflect:!0})],LyraRetrievalResults.prototype,"hasMore",void 0),__decorate([property({attribute:"error-text"})],LyraRetrievalResults.prototype,"errorText",void 0),__decorate([property({type:Boolean,reflect:!0})],LyraRetrievalResults.prototype,"announce",void 0),__decorate([property()],LyraRetrievalResults.prototype,"label",void 0),__decorate([state()],LyraRetrievalResults.prototype,"expandedChunkIds",void 0);export{LyraRetrievalResults};

package/dist/components/retrieval/retrieval-results/retrieval-results.d.ts

@@ -1,2 +1,2 @@
 /** @deprecated Import @aceshooting/lyra-ui/components/lr-retrieval-results.js to register this component. */
-export*from'./retrieval-results.class.js';import'../../layout/virtual-list/virtual-list.js';import'../chunk-inspector/chunk-inspector.js';import'../../forms/checkbox/checkbox.js';import'../../overlays/spinner/spinner.js';import'../../overlays/empty/empty.js';
+export*from'./retrieval-results.class.js';import'../../layout/virtual-list/virtual-list.js';import'../../data/pagination/pagination.js';import'../chunk-inspector/chunk-inspector.js';import'../../forms/checkbox/checkbox.js';import'../../overlays/spinner/spinner.js';import'../../overlays/empty/empty.js';

package/dist/components/retrieval/retrieval-results/retrieval-results.js

@@ -1 +1 @@
-export*from"./retrieval-results.class.js";import{LyraRetrievalResults}from"./retrieval-results.class.js";import{defineElement}from"../../../internal/prefix.js";import"../../layout/virtual-list/virtual-list.js";import"../chunk-inspector/chunk-inspector.js";import"../../forms/checkbox/checkbox.js";import"../../overlays/spinner/spinner.js";import"../../overlays/empty/empty.js";defineElement("retrieval-results",LyraRetrievalResults);
+export*from"./retrieval-results.class.js";import{LyraRetrievalResults}from"./retrieval-results.class.js";import{defineElement}from"../../../internal/prefix.js";import"../../layout/virtual-list/virtual-list.js";import"../../data/pagination/pagination.js";import"../chunk-inspector/chunk-inspector.js";import"../../forms/checkbox/checkbox.js";import"../../overlays/spinner/spinner.js";import"../../overlays/empty/empty.js";defineElement("retrieval-results",LyraRetrievalResults);

package/dist/components/retrieval/retrieval-results/retrieval-results.styles.js

@@ -1 +1 @@
-import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; } [part='error'] { padding: var(--lr-space-m); color: var(--lr-color-danger); font-size: var(--lr-font-size-sm); } [part='row'] { display: flex; align-items: flex-start; gap: var(--lr-space-xs); padding-inline: var(--lr-space-s); padding-block: var(--lr-space-s); border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } lr-virtual-list::part(row) { display: flex; align-items: flex-start; gap: var(--lr-space-xs); padding-inline: var(--lr-space-s); padding-block: var(--lr-space-s); } lr-virtual-list::part(group) { box-sizing: border-box; border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } [part~='select'], lr-virtual-list::part(select) { flex: 0 0 auto; margin-block-start: var(--lr-space-2xs); } [part~='row-body'], lr-virtual-list::part(row-body) { flex: 1 1 auto; min-inline-size: 0; border-inline-start: var(--lr-space-2xs) solid transparent; padding-inline-start: var(--lr-space-xs); } [part~='row-body-selected'], lr-virtual-list::part(row-body-selected) { border-inline-start-color: var(--lr-retrieval-results-selected-border, var(--lr-color-brand)); } [part~='metadata'], lr-virtual-list::part(metadata) { display: flex; flex-wrap: wrap; gap: var(--lr-space-2xs) var(--lr-space-s); margin: var(--lr-space-2xs) 0 0; padding: 0; font-size: var(--lr-font-size-2xs); color: var(--lr-color-text-quiet); } [part~='metadata-entry'], lr-virtual-list::part(metadata-entry) { display: flex; gap: var(--lr-space-2xs); } [part~='metadata-term'], lr-virtual-list::part(metadata-term) { font-weight: var(--lr-font-weight-medium); } [part~='metadata-value'], lr-virtual-list::part(metadata-value) { margin: 0; overflow-wrap: anywhere; } [part='load-more-row'] { display: flex; justify-content: center; padding: var(--lr-space-s); } [part='load-more'] { box-sizing: border-box; ${iconHitTarget} border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: transparent; color: var(--lr-color-brand); font: inherit; font-size: var(--lr-font-size-sm); padding: var(--lr-space-2xs) var(--lr-space-m); cursor: pointer; transition: background-color var(--lr-transition-fast); } [part='load-more']:hover { background: var(--lr-color-brand-quiet); } [part='load-more']:active { background: color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='load-more']:focus-visible { ${focusRing} } [part='empty'], [part='spinner'] { padding: var(--lr-space-l); } `;export{styles};
+import{iconHitTarget,focusRing}from"../../../internal/interactive-control.styles.js";import{css}from"lit";const styles=css` :host { display: block; } [part='error'] { padding: var(--lr-space-m); color: var(--lr-color-danger); font-size: var(--lr-font-size-sm); } [part='row'] { display: flex; align-items: flex-start; gap: var(--lr-space-xs); padding-inline: var(--lr-space-s); padding-block: var(--lr-space-s); border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } lr-virtual-list::part(row) { display: flex; align-items: flex-start; gap: var(--lr-space-xs); padding-inline: var(--lr-space-s); padding-block: var(--lr-space-s); } lr-virtual-list::part(group) { box-sizing: border-box; border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border-subtle); } [part~='select'], lr-virtual-list::part(select) { flex: 0 0 auto; margin-block-start: var(--lr-space-2xs); } [part~='row-body'], lr-virtual-list::part(row-body) { flex: 1 1 auto; min-inline-size: 0; border-inline-start: var(--lr-space-2xs) solid transparent; padding-inline-start: var(--lr-space-xs); } [part~='row-body-selected'], lr-virtual-list::part(row-body-selected) { border-inline-start-color: var(--lr-retrieval-results-selected-border, var(--lr-color-brand)); } [part~='metadata'], lr-virtual-list::part(metadata) { display: flex; flex-wrap: wrap; gap: var(--lr-space-2xs) var(--lr-space-s); margin: var(--lr-space-2xs) 0 0; padding: 0; font-size: var(--lr-font-size-2xs); color: var(--lr-color-text-quiet); } [part~='metadata-entry'], lr-virtual-list::part(metadata-entry) { display: flex; gap: var(--lr-space-2xs); } [part~='metadata-term'], lr-virtual-list::part(metadata-term) { font-weight: var(--lr-font-weight-medium); } [part~='metadata-value'], lr-virtual-list::part(metadata-value) { margin: 0; overflow-wrap: anywhere; } [part='load-more-row'] { display: flex; justify-content: center; padding: var(--lr-space-s); } [part='load-more'] { box-sizing: border-box; ${iconHitTarget} border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); background: transparent; color: var(--lr-color-brand); font: inherit; font-size: var(--lr-font-size-sm); padding: var(--lr-space-2xs) var(--lr-space-m); cursor: pointer; transition: background-color var(--lr-transition-fast); } [part='load-more']:hover { background: var(--lr-color-brand-quiet); } [part='load-more']:active { background: color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='load-more']:focus-visible { ${focusRing} } [part='empty'], [part='spinner'] { padding: var(--lr-space-l); } [part='limit'] { margin: 0; padding: var(--lr-space-s); color: var(--lr-color-text-quiet); font-size: var(--lr-font-size-sm); overflow-wrap: anywhere; } [part='source-status'], [part='source-selection-status'] { margin: 0; padding: var(--lr-space-s); overflow-wrap: anywhere; } [part='source-pagination'] { display: block; min-inline-size: 0; padding: var(--lr-space-s); } [part='source-retry'], [part='source-selection-retry'] { ${iconHitTarget} border: var(--lr-border-width-thin) solid var(--lr-color-border); border-radius: var(--lr-radius); padding: var(--lr-space-xs) var(--lr-space-s); background: var(--lr-color-surface); color: var(--lr-color-text); font: inherit; cursor: pointer; transition: var(--lr-transition-interactive); } [part='source-retry']:hover, [part='source-selection-retry']:hover { background: color-mix(in oklab, var(--lr-color-surface), var(--lr-color-mix-partner) var(--lr-color-mix-hover)); } [part='source-retry']:active, [part='source-selection-retry']:active { background: color-mix(in oklab, var(--lr-color-surface), var(--lr-color-mix-partner) var(--lr-color-mix-active)); } [part='source-retry']:focus-visible, [part='source-selection-retry']:focus-visible { ${focusRing} } `;export{styles};

package/dist/components/utility/diff-view/diff-view.class.d.ts

@@ -1,4 +1,4 @@
-import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import{type LyraClipboardWriteFailure,type LyraClipboardWriteSuccess}from'../../../internal/clipboard.js';import type{AnchorResultDetail,HighlightActivateDetail,LyraAnchor,LyraAnchorKind}from'../../viewers/document-viewer/anchors.js';import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import{type ShikiLanguageInput}from'../../conversation/code-block/code-loader.js';export interface LyraDiffViewEventMap{'lr-copy':CustomEvent<LyraClipboardWriteSuccess>;'lr-error':CustomEvent<null>;'lr-copy-error':CustomEvent<LyraClipboardWriteFailure>;
+import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import{type LyraClipboardWriteFailure,type LyraClipboardWriteSuccess}from'../../../internal/clipboard.js';import type{AnchorResultDetail,HighlightActivateDetail,LyraAnchor,LyraAnchorKind}from'../../viewers/document-viewer/anchors.js';import type{LyraSearchChangeDetail}from'../../../internal/text-viewer-target.js';import{type ShikiLanguageInput,type ShikiLanguageLoader}from'../../conversation/code-block/shiki-types.js';export interface LyraDiffViewEventMap{'lr-copy':CustomEvent<LyraClipboardWriteSuccess>;'lr-error':CustomEvent<null>;'lr-copy-error':CustomEvent<LyraClipboardWriteFailure>;
 /** Fired whenever the search query, match count, or active match index changes, from
 *  `search()`/`searchNext()`/`searchPrevious()`/`clearSearch()`. */
 'lr-search-change':CustomEvent<LyraSearchChangeDetail>;
@@ -54,7 +54,7 @@ export type LyraDiffViewLayout='unified'|'split';declare class LyraDiffViewBase
 *   line it first covers; emits `lr-highlight-activate`.
 * @csspart copy-button - The copy affordance, only rendered while `copyable`; pinned to the top
 *   while the view scrolls.
-* @csspart limit - The localized fallback rendered when either input exceeds `maxLines`.
+* @csspart limit - The localized render-limit fallback or syntax-highlighting limit notice.
 * @csspart side - One column in `layout="split"` (`data-side="old"|"new"`).
 * @cssprop [--lr-diff-view-max-height=none] - Cap on `[part="base"]`'s block size, past which the
 *   view scrolls internally. The `maxHeight` property sets this token inline on `[part="base"]`.
@@ -96,12 +96,17 @@ copyable:boolean;
 *  instead of growing the page. Invalid values are ignored. */
 maxHeight:string;private _layout;get layout():LyraDiffViewLayout;set layout(next:LyraDiffViewLayout);
 /** A shiki-recognized language id. Highlighting activates only when this has a matching entry in
-*  `languages` -- there is deliberately no default full-table `lr-code-block`-style fallback, so
-*  this component never reaches shiki's ~200-language dynamic-import table. */
+*  `languages` or `languageLoaders` -- there is deliberately no default full-table
+*  `lr-code-block`-style fallback, so this component never reaches shiki's dynamic-import table. */
 language:string;
-/** Grammar definitions this instance can highlight, same shape as `lr-code-block-core`'s own
-*  `languages`. */
+/** Resolved grammar definitions this instance can highlight. If either input exceeds 8,192
+*  UTF-16 code units, both sides retain their full
+*  plain source and a localized `limit` notice replaces syntax highlighting. */
 languages?:Readonly<Record<string,ShikiLanguageInput>>;
+/** Optional lazy grammar loaders. Concrete `languages` entries take priority on duplicate keys;
+* only a requested loader runs. Unset preserves concrete-grammar highlighting.
+* Assign a new map object after changing entries. */
+languageLoaders?:Readonly<Record<string,ShikiLanguageLoader>>;
 /** How many unchanged lines to keep visible immediately before/after each change. Default
 *  `undefined` renders every line unconditionally, exactly like before this property existed. Set
 *  to a finite number `>= 0` to collapse a longer run of unchanged lines behind a single fold
@@ -110,12 +115,15 @@ languages?:Readonly<Record<string,ShikiLanguageInput>>;
 contextLines?:number;
 /** Maximum lines accepted on either input side before rendering a bounded fallback. Defaults
 *  to `5000`. `Infinity` relaxes this line-count limit; aggregate text and comparison work
-*  remain bounded. */
+*  remain bounded. All values also enforce a hard ceiling of 10,000 diff operations before
+*  rendering (at most 10,000 unified lines or 20,000 split cells, including empty cells).
+*  Above the ceiling a localized `limit` fallback replaces the diff. Rows use
+*  `content-visibility: auto` to defer offscreen paint. */
 maxLines:number;
 /** Anchor kinds this component resolves via `scrollToAnchor()`. Feature-detectable capability
 *  mirror -- the same pattern every other `DocumentAnchorTarget`-adopting viewer uses for this
 *  field. */
-readonly anchorKinds:readonly LyraAnchorKind[];private copyStatus;private diffTooLarge;private copyAnnouncementSink?;private searchMatches;private searchMatchCountExact;private searchActiveIndex;private searchQuery;private lastSearchLocale;private pendingSearchResetEvent;private forcedVisibleOps;private readonly searchAnnouncements;private readonly searchAnnouncer;private highlightedOldLines;private highlightedNewLines;private highlightToken;private loadHighlighterCore;private copyTimer?;private copyGeneration;private oldTextSnapshot;private newTextSnapshot;private languageSnapshot;private languagesSnapshot?;private diffOps;private opIndexMap;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private hasSearchState;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private cancelCopyTimer;private resetCopyFeedback;private syncHighlight;private tokenizeLines;private computeFolds;private foldMarker;private revealOp;private lineElementForOpIndex;private scrollOpIndexIntoView;
+readonly anchorKinds:readonly LyraAnchorKind[];private copyStatus;private diffTooLarge;private copyAnnouncementSink?;private searchMatches;private searchMatchCountExact;private searchActiveIndex;private searchQuery;private lastSearchLocale;private pendingSearchResetEvent;private forcedVisibleOps;private readonly searchAnnouncements;private readonly searchAnnouncer;private highlightedOldLines;private highlightedNewLines;private highlightToken;private loadHighlighterCore;private copyTimer?;private copyGeneration;private oldTextSnapshot;private newTextSnapshot;private languageSnapshot;private languagesSnapshot?;private diffOps;private opIndexMap;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;private hasSearchState;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;private cancelCopyTimer;private resetCopyFeedback;private get highlightLimited();private syncHighlight;private tokenizeLines;private computeFolds;private foldMarker;private revealOp;private lineElementForOpIndex;private scrollOpIndexIntoView;
 /** Resolves a `line-range` anchor by scrolling the line at its 0-based `start` op index into
 *  view, first expanding any `contextLines` fold currently hiding it. `end` is not consulted
 *  here -- it only widens what a covering `highlights` entry paints; the scroll target is