@aceshooting/lyra-ui 19.0.1 → 20.0.1

package/dist/components/retrieval/citation-badge/citation-badge.class.d.ts

@@ -19,7 +19,9 @@ import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from
 * hover. When preview content exists, the button keeps a stable
 * `aria-describedby` relationship to the `role="tooltip"` panel while it is
 * both hidden and visible, so assistive technology can resolve the preview
-* as soon as focus causes it to open.
+* as soon as focus causes it to open. An open popover participates in shared
+* Escape ordering even while only hovered, deferring to a genuinely topmost
+* overlay opened on top of it.
 *
 * An authored host `aria-label` deliberately names only the custom-element boundary; it is not
 * copied onto the internal button. Host naming does not cross the shadow boundary, so the button
@@ -97,4 +99,4 @@ sourceId:string;
 href:string;
 /** Adds source context to the accessible name while retaining the visible citation index
 *  (`"Citation {index}, {label}"`). */
-label:string;private popoverOpen;private buttonEl?;private popoverEl?;private readonly popoverId;private readonly slotPresence;private cleanupPositioner?;private hideTimer?;private hideTimerOwner?;private hovering;private focused;private get hasPreviewSlot();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;private get accessibleLabel();private showPreview;private clearHideTimer;private scheduleHidePreview;private hidePreviewNow;private onPointerEnter;private onPointerLeave;private onFocusIn;private onFocusOut;private onKeyDown;private onClick;private onDblClick;private emitOpen;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-citation-badge':LyraCitationBadge;}}
+label:string;private popoverOpen;private buttonEl?;private popoverEl?;private readonly popoverId;private readonly slotPresence;private cleanupPositioner?;private overlayHandle?;private hideTimer?;private hideTimerOwner?;private hovering;private focused;private get hasPreviewSlot();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;private get accessibleLabel();private showPreview;private clearHideTimer;private scheduleHidePreview;private hidePreviewNow;private onPointerEnter;private onPointerLeave;private onFocusIn;private onFocusOut;private onKeyDown;private onClick;private onDblClick;private emitOpen;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-citation-badge':LyraCitationBadge;}}

package/dist/components/retrieval/citation-badge/citation-badge.class.js

@@ -1,4 +1,4 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{deferredPlace as place}from"../../../internal/anchored-overlay-runtime.js";import{resolveEffectivePositioningStrategy}from"../../../internal/positioning-strategy.js";import{nextId}from"../../../internal/a11y.js";import{SlotPresenceController}from"../../../internal/slot-presence-controller.js";import{finiteInteger}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{styles}from"./citation-badge.styles.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_citationHighConfidence,LYRA_DEFAULT_citationLowConfidence,LYRA_DEFAULT_citationMediumConfidence,LYRA_DEFAULT_citationUnverified,LYRA_DEFAULT_citationVerified,LYRA_DEFAULT_citationWithCustomLabel,LYRA_DEFAULT_citationWithStatus,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const STATUS_MESSAGE_KEY={default:null,high:"citationHighConfidence",medium:"citationMediumConfidence",low:"citationLowConfidence",verified:"citationVerified",unverified:"citationUnverified"},HIDE_DELAY_MS=200;class LyraCitationBadge extends LyraElement{constructor(){super(...arguments),this._index=1,this.status="default",this.sourceId="",this.href="",this.label="",this.popoverOpen=!1,this.popoverId=nextId("citation-badge-popover"),this.slotPresence=new SlotPresenceController(this),this.hovering=!1,this.focused=!1,this.onPointerEnter=()=>{this.hovering=!0,this.showPreview()},this.onPointerLeave=()=>{this.hovering=!1,this.scheduleHidePreview()},this.onFocusIn=()=>{this.focused=!0,this.showPreview()},this.onFocusOut=()=>{this.focused=!1,!this.hovering&&this.hidePreviewNow()},this.onKeyDown=e=>{if(e.key==="Escape"&&this.popoverOpen){e.stopPropagation(),this.hidePreviewNow();return}e.key===" "&&!e.repeat&&e.target===this.buttonEl&&(e.preventDefault(),this.emitOpen())},this.onClick=()=>{this.emit("lr-citation-activate",{sourceId:this.sourceId,index:this.index})},this.onDblClick=()=>{this.emitOpen()}}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,citationHighConfidence:LYRA_DEFAULT_citationHighConfidence,citationLowConfidence:LYRA_DEFAULT_citationLowConfidence,citationMediumConfidence:LYRA_DEFAULT_citationMediumConfidence,citationUnverified:LYRA_DEFAULT_citationUnverified,citationVerified:LYRA_DEFAULT_citationVerified,citationWithCustomLabel:LYRA_DEFAULT_citationWithCustomLabel,citationWithStatus:LYRA_DEFAULT_citationWithStatus,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.styles=[LyraElement.styles,styles]}get index(){return this._index}set index(value){const old=this._index;this._index=finiteInteger(value,1,1),this.requestUpdate("index",old)}get hasPreviewSlot(){return this.slotPresence.has()}willUpdate(changed){super.willUpdate(changed),this.popoverOpen&&!this.hasPreviewSlot&&this.hidePreviewNow()}updated(changed){super.updated(changed),changed.has("popoverOpen")&&(this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.popoverOpen&&this.buttonEl&&this.popoverEl&&(this.cleanupPositioner=place(this.buttonEl,this.popoverEl,{placement:"top-start",strategy:resolveEffectivePositioningStrategy(this,void 0,"fixed")})))}disconnectedCallback(){super.disconnectedCallback(),this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.clearHideTimer(),this.popoverOpen=!1,this.hovering=!1,this.focused=!1}get accessibleLabel(){const index=getNumberFormat(this.effectiveLocale).format(this.index);if(this.label)return this.localize("citationWithCustomLabel",void 0,{index,label:this.label});const key=STATUS_MESSAGE_KEY[this.status],statusText=key?this.localize(key):"",citationLabel=this.localize("citation",void 0,{index});return statusText?this.localize("citationWithStatus",void 0,{index,status:statusText}):citationLabel}showPreview(){this.hasPreviewSlot&&(this.clearHideTimer(),!this.popoverOpen&&(this.popoverOpen=!0))}clearHideTimer(){this.hideTimer!==void 0&&this.hideTimerOwner?.clearTimeout(this.hideTimer),this.hideTimer=void 0,this.hideTimerOwner=void 0}scheduleHidePreview(){if(!this.popoverOpen||this.hovering||this.focused)return;this.clearHideTimer();const ownerWindow=this.ownerDocument.defaultView;if(!ownerWindow)return;const handle=ownerWindow.setTimeout(()=>{this.hideTimer===handle&&(this.hideTimer=void 0,this.hideTimerOwner=void 0,this.popoverOpen=!1)},HIDE_DELAY_MS);this.hideTimer=handle,this.hideTimerOwner=ownerWindow}hidePreviewNow(){this.clearHideTimer(),this.popoverOpen&&(this.popoverOpen=!1)}emitOpen(){this.emit("lr-citation-open",{sourceId:this.sourceId,index:this.index,href:this.href||void 0})}render(){const formattedIndex=getNumberFormat(this.effectiveLocale).format(this.index);return html`
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{deferredPlace as place}from"../../../internal/anchored-overlay-runtime.js";import{activateNonmodalOverlay}from"../../../internal/nonmodal-overlay-manager.js";import{resolveEffectivePositioningStrategy}from"../../../internal/positioning-strategy.js";import{nextId}from"../../../internal/a11y.js";import{SlotPresenceController}from"../../../internal/slot-presence-controller.js";import{finiteInteger}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{styles}from"./citation-badge.styles.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_citationHighConfidence,LYRA_DEFAULT_citationLowConfidence,LYRA_DEFAULT_citationMediumConfidence,LYRA_DEFAULT_citationUnverified,LYRA_DEFAULT_citationVerified,LYRA_DEFAULT_citationWithCustomLabel,LYRA_DEFAULT_citationWithStatus,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const STATUS_MESSAGE_KEY={default:null,high:"citationHighConfidence",medium:"citationMediumConfidence",low:"citationLowConfidence",verified:"citationVerified",unverified:"citationUnverified"},HIDE_DELAY_MS=200;class LyraCitationBadge extends LyraElement{constructor(){super(...arguments),this._index=1,this.status="default",this.sourceId="",this.href="",this.label="",this.popoverOpen=!1,this.popoverId=nextId("citation-badge-popover"),this.slotPresence=new SlotPresenceController(this),this.hovering=!1,this.focused=!1,this.onPointerEnter=()=>{this.hovering=!0,this.showPreview()},this.onPointerLeave=()=>{this.hovering=!1,this.scheduleHidePreview()},this.onFocusIn=()=>{this.focused=!0,this.showPreview()},this.onFocusOut=()=>{this.focused=!1,!this.hovering&&this.hidePreviewNow()},this.onKeyDown=e=>{if(e.key==="Escape"&&this.popoverOpen&&this.overlayHandle?.isTopmost()){e.stopPropagation(),this.hidePreviewNow();return}e.key===" "&&!e.repeat&&e.target===this.buttonEl&&(e.preventDefault(),this.emitOpen())},this.onClick=()=>{this.emit("lr-citation-activate",{sourceId:this.sourceId,index:this.index})},this.onDblClick=()=>{this.emitOpen()}}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,citationHighConfidence:LYRA_DEFAULT_citationHighConfidence,citationLowConfidence:LYRA_DEFAULT_citationLowConfidence,citationMediumConfidence:LYRA_DEFAULT_citationMediumConfidence,citationUnverified:LYRA_DEFAULT_citationUnverified,citationVerified:LYRA_DEFAULT_citationVerified,citationWithCustomLabel:LYRA_DEFAULT_citationWithCustomLabel,citationWithStatus:LYRA_DEFAULT_citationWithStatus,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.styles=[LyraElement.styles,styles]}get index(){return this._index}set index(value){const old=this._index;this._index=finiteInteger(value,1,1),this.requestUpdate("index",old)}get hasPreviewSlot(){return this.slotPresence.has()}willUpdate(changed){super.willUpdate(changed),this.popoverOpen&&!this.hasPreviewSlot&&this.hidePreviewNow()}updated(changed){super.updated(changed),changed.has("popoverOpen")&&(this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.overlayHandle?.deactivate({restoreFocus:!1}),this.overlayHandle=void 0,this.popoverOpen&&this.buttonEl&&this.popoverEl&&(this.cleanupPositioner=place(this.buttonEl,this.popoverEl,{placement:"top-start",strategy:resolveEffectivePositioningStrategy(this,void 0,"fixed")}),this.overlayHandle=activateNonmodalOverlay({host:this,panel:()=>this.popoverEl??null,onEscape:()=>this.hidePreviewNow(),restoreFocusTo:null})))}disconnectedCallback(){super.disconnectedCallback(),this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.overlayHandle?.deactivate({restoreFocus:!1}),this.overlayHandle=void 0,this.clearHideTimer(),this.popoverOpen=!1,this.hovering=!1,this.focused=!1}get accessibleLabel(){const index=getNumberFormat(this.effectiveLocale).format(this.index);if(this.label)return this.localize("citationWithCustomLabel",void 0,{index,label:this.label});const key=STATUS_MESSAGE_KEY[this.status],statusText=key?this.localize(key):"",citationLabel=this.localize("citation",void 0,{index});return statusText?this.localize("citationWithStatus",void 0,{index,status:statusText}):citationLabel}showPreview(){this.hasPreviewSlot&&(this.clearHideTimer(),!this.popoverOpen&&(this.popoverOpen=!0))}clearHideTimer(){this.hideTimer!==void 0&&this.hideTimerOwner?.clearTimeout(this.hideTimer),this.hideTimer=void 0,this.hideTimerOwner=void 0}scheduleHidePreview(){if(!this.popoverOpen||this.hovering||this.focused)return;this.clearHideTimer();const ownerWindow=this.ownerDocument.defaultView;if(!ownerWindow)return;const handle=ownerWindow.setTimeout(()=>{this.hideTimer===handle&&(this.hideTimer=void 0,this.hideTimerOwner=void 0,this.popoverOpen=!1)},HIDE_DELAY_MS);this.hideTimer=handle,this.hideTimerOwner=ownerWindow}hidePreviewNow(){this.clearHideTimer(),this.popoverOpen&&(this.popoverOpen=!1)}emitOpen(){this.emit("lr-citation-open",{sourceId:this.sourceId,index:this.index,href:this.href||void 0})}render(){const formattedIndex=getNumberFormat(this.effectiveLocale).format(this.index);return html`
       <span
         class="wrapper"
         @pointerenter=${this.onPointerEnter}

package/dist/components/retrieval/claim-evidence/claim-evidence.class.d.ts

@@ -10,6 +10,9 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * and reassign it after changes; mutating the assigned array does not update the view. Blank
 * claim/citation ids and later duplicates are ignored before lookup, rendering, counts, or
 * activation. The first record for an id wins.
+*
+* At most 500 claims render as `[part="claim"]` rows; a `claims` array past that length renders a
+* localized `[part="limit"]` notice after the list rather than mounting an unbounded number of rows.
 * A nested badge's `lr-citation-activate` is contained and translated to `lr-citation-select` with
 * the complete citation record. Its distinct `lr-citation-open` signal intentionally remains a
 * composed child event and crosses this host unchanged, preserving its `{ sourceId, index, href }`
@@ -28,6 +31,7 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * @csspart confidence - The optional localized confidence.
 * @csspart explanation - Caller-supplied assessment explanation.
 * @csspart evidence - Resolved evidence citations for one claim.
+* @csspart limit - Localized notice shown when `claims` exceeds the 500-claim render ceiling.
 * @csspart empty - The empty state.
 * @cssprop [--lr-claim-evidence-compact-padding=var(--lr-space-xs)] - `[part="claim-trigger"]`
 * padding while `compact`.

package/dist/components/retrieval/claim-evidence/claim-evidence.class.js

@@ -1,4 +1,4 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{LyraElement}from"../../../internal/lyra-element.js";import{finiteRange}from"../../../internal/numbers.js";import"../../overlays/badge/badge.class.js";import"../../overlays/empty/empty.class.js";import"../citation-badge/citation-badge.class.js";import{styles}from"./claim-evidence.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_claimEvidenceConfidence,LYRA_DEFAULT_claimEvidenceContradicted,LYRA_DEFAULT_claimEvidenceEmpty,LYRA_DEFAULT_claimEvidenceLabel,LYRA_DEFAULT_claimEvidencePartiallySupported,LYRA_DEFAULT_claimEvidenceSupported,LYRA_DEFAULT_claimEvidenceUnsupported,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const STATUS_VARIANT={supported:"success","partially-supported":"warning",unsupported:"danger",contradicted:"danger"},MAX_PROJECTED_CLAIM_EVIDENCE_ROWS=1e4,EMPTY_CANONICAL_CLAIMS=Object.freeze([]),EMPTY_CANONICAL_CITATIONS=Object.freeze([]);function descriptorValue(value,property2){return getOwnDataDescriptor(value,property2)}function valueOfDescriptor(descriptor){return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function hasUnsafeDescriptor(descriptors){return descriptors.some(descriptor=>descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)}function projectCitationIds(value){try{if(!Array.isArray(value))return;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return;const ids=[],length=Math.min(lengthDescriptor.value,MAX_PROJECTED_CLAIM_EVIDENCE_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)return;descriptor!==MISSING_OWN_DATA_DESCRIPTOR&&typeof descriptor.value=="string"&&ids.push(descriptor.value)}return Object.freeze(ids)}catch{return}}function projectClaim(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),textDescriptor=descriptorValue(value,"text"),statusDescriptor=descriptorValue(value,"status"),citationIdsDescriptor=descriptorValue(value,"citationIds"),confidenceDescriptor=descriptorValue(value,"confidence"),explanationDescriptor=descriptorValue(value,"explanation");if(hasUnsafeDescriptor([idDescriptor,textDescriptor,statusDescriptor,citationIdsDescriptor,confidenceDescriptor,explanationDescriptor]))return;const id=valueOfDescriptor(idDescriptor),text=valueOfDescriptor(textDescriptor),citationIds=projectCitationIds(valueOfDescriptor(citationIdsDescriptor));if(typeof id!="string"||id.trim().length===0||typeof text!="string"||citationIds===void 0)return;const status=valueOfDescriptor(statusDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),explanation=valueOfDescriptor(explanationDescriptor);return Object.freeze({source:value,id,text,status:typeof status=="string"?status:"unsupported",citationIds,...typeof confidence=="number"&&Number.isFinite(confidence)?{confidence}:{},...typeof explanation=="string"?{explanation}:{}})}catch{return}}function projectCitation(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),sourceIdDescriptor=descriptorValue(value,"sourceId"),labelDescriptor=descriptorValue(value,"label"),quoteDescriptor=descriptorValue(value,"quote");if(hasUnsafeDescriptor([idDescriptor,sourceIdDescriptor,labelDescriptor,quoteDescriptor]))return;const id=valueOfDescriptor(idDescriptor);if(typeof id!="string"||id.trim().length===0)return;const sourceId=valueOfDescriptor(sourceIdDescriptor),label=valueOfDescriptor(labelDescriptor),quote=valueOfDescriptor(quoteDescriptor);return Object.freeze({source:value,id,...typeof sourceId=="string"?{sourceId}:{},...typeof label=="string"?{label}:{},...typeof quote=="string"?{quote}:{}})}catch{return}}function projectRows(value,project,empty){try{if(!Array.isArray(value))return empty;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return empty;const rows=[],seen=new Set,length=Math.min(lengthDescriptor.value,MAX_PROJECTED_CLAIM_EVIDENCE_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)continue;const row=project(descriptor.value);!row||seen.has(row.id)||(seen.add(row.id),rows.push(row))}return Object.freeze(rows)}catch{return empty}}function normalizedClaimStatus(status){switch(status){case"supported":case"partially-supported":case"unsupported":case"contradicted":return status;default:return"unsupported"}}class LyraClaimEvidence extends LyraElement{constructor(){super(...arguments),this.claims=[],this.citations=[],this.selectedClaimId="",this.label="",this.compact=!1,this.frame="card",this.canonicalClaimsBySource=new WeakMap,this.canonicalCitationsBySource=new WeakMap}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,claimEvidenceConfidence:LYRA_DEFAULT_claimEvidenceConfidence,claimEvidenceContradicted:LYRA_DEFAULT_claimEvidenceContradicted,claimEvidenceEmpty:LYRA_DEFAULT_claimEvidenceEmpty,claimEvidenceLabel:LYRA_DEFAULT_claimEvidenceLabel,claimEvidencePartiallySupported:LYRA_DEFAULT_claimEvidencePartiallySupported,claimEvidenceSupported:LYRA_DEFAULT_claimEvidenceSupported,claimEvidenceUnsupported:LYRA_DEFAULT_claimEvidenceUnsupported,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["claims","citations"])}static{this.identityCollectionProperties=Object.freeze(["claims","citations"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-claim-select","lr-citation-select"])}static{this.identityEventDetailProperties=Object.freeze({"lr-claim-select":Object.freeze(["claim"]),"lr-citation-select":Object.freeze(["citation"])})}canonicalRowsFor(source,cache,project,empty){if(source===null||typeof source!="object")return empty;const cached=cache.get(source);if(cached)return cached;const rows=projectRows(source,project,empty);return cache.set(source,rows),rows}get normalizedClaims(){return this.canonicalRowsFor(this.claims,this.canonicalClaimsBySource,projectClaim,EMPTY_CANONICAL_CLAIMS)}get normalizedCitations(){return this.canonicalRowsFor(this.citations,this.canonicalCitationsBySource,projectCitation,EMPTY_CANONICAL_CITATIONS)}statusLabel(status){switch(status){case"supported":return this.localize("claimEvidenceSupported");case"partially-supported":return this.localize("claimEvidencePartiallySupported");case"unsupported":return this.localize("claimEvidenceUnsupported");case"contradicted":return this.localize("claimEvidenceContradicted")}}confidenceLabel(value){const percent=getNumberFormat(this.effectiveLocale,{style:"percent"}).format(finiteRange(value,0,0,1));return this.localize("claimEvidenceConfidence",void 0,{percent})}resolvedCitations(claim,citations){const ids=new Set(claim.citationIds);return citations.filter(citation=>ids.has(citation.id))}renderClaim(claim,allCitations){const selected=claim.id===this.selectedClaimId,citations=this.resolvedCitations(claim,allCitations),status=normalizedClaimStatus(claim.status);return html`
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{LyraElement}from"../../../internal/lyra-element.js";import{finiteRange}from"../../../internal/numbers.js";import"../../overlays/badge/badge.class.js";import"../../overlays/empty/empty.class.js";import"../citation-badge/citation-badge.class.js";import{styles}from"./claim-evidence.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_claimEvidenceClaimsLimit,LYRA_DEFAULT_claimEvidenceConfidence,LYRA_DEFAULT_claimEvidenceContradicted,LYRA_DEFAULT_claimEvidenceEmpty,LYRA_DEFAULT_claimEvidenceLabel,LYRA_DEFAULT_claimEvidencePartiallySupported,LYRA_DEFAULT_claimEvidenceSupported,LYRA_DEFAULT_claimEvidenceUnsupported,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const STATUS_VARIANT={supported:"success","partially-supported":"warning",unsupported:"danger",contradicted:"danger"},MAX_PROJECTED_CLAIM_EVIDENCE_ROWS=1e4,MAX_RENDERED_CLAIM_EVIDENCE_CLAIMS=500,EMPTY_CANONICAL_CLAIMS=Object.freeze([]),EMPTY_CANONICAL_CITATIONS=Object.freeze([]);function descriptorValue(value,property2){return getOwnDataDescriptor(value,property2)}function valueOfDescriptor(descriptor){return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function hasUnsafeDescriptor(descriptors){return descriptors.some(descriptor=>descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)}function projectCitationIds(value){try{if(!Array.isArray(value))return;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return;const ids=[],length=Math.min(lengthDescriptor.value,MAX_PROJECTED_CLAIM_EVIDENCE_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)return;descriptor!==MISSING_OWN_DATA_DESCRIPTOR&&typeof descriptor.value=="string"&&ids.push(descriptor.value)}return Object.freeze(ids)}catch{return}}function projectClaim(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),textDescriptor=descriptorValue(value,"text"),statusDescriptor=descriptorValue(value,"status"),citationIdsDescriptor=descriptorValue(value,"citationIds"),confidenceDescriptor=descriptorValue(value,"confidence"),explanationDescriptor=descriptorValue(value,"explanation");if(hasUnsafeDescriptor([idDescriptor,textDescriptor,statusDescriptor,citationIdsDescriptor,confidenceDescriptor,explanationDescriptor]))return;const id=valueOfDescriptor(idDescriptor),text=valueOfDescriptor(textDescriptor),citationIds=projectCitationIds(valueOfDescriptor(citationIdsDescriptor));if(typeof id!="string"||id.trim().length===0||typeof text!="string"||citationIds===void 0)return;const status=valueOfDescriptor(statusDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),explanation=valueOfDescriptor(explanationDescriptor);return Object.freeze({source:value,id,text,status:typeof status=="string"?status:"unsupported",citationIds,...typeof confidence=="number"&&Number.isFinite(confidence)?{confidence}:{},...typeof explanation=="string"?{explanation}:{}})}catch{return}}function projectCitation(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),sourceIdDescriptor=descriptorValue(value,"sourceId"),labelDescriptor=descriptorValue(value,"label"),quoteDescriptor=descriptorValue(value,"quote");if(hasUnsafeDescriptor([idDescriptor,sourceIdDescriptor,labelDescriptor,quoteDescriptor]))return;const id=valueOfDescriptor(idDescriptor);if(typeof id!="string"||id.trim().length===0)return;const sourceId=valueOfDescriptor(sourceIdDescriptor),label=valueOfDescriptor(labelDescriptor),quote=valueOfDescriptor(quoteDescriptor);return Object.freeze({source:value,id,...typeof sourceId=="string"?{sourceId}:{},...typeof label=="string"?{label}:{},...typeof quote=="string"?{quote}:{}})}catch{return}}function projectRows(value,project,empty){try{if(!Array.isArray(value))return empty;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return empty;const rows=[],seen=new Set,length=Math.min(lengthDescriptor.value,MAX_PROJECTED_CLAIM_EVIDENCE_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)continue;const row=project(descriptor.value);!row||seen.has(row.id)||(seen.add(row.id),rows.push(row))}return Object.freeze(rows)}catch{return empty}}function normalizedClaimStatus(status){switch(status){case"supported":case"partially-supported":case"unsupported":case"contradicted":return status;default:return"unsupported"}}class LyraClaimEvidence extends LyraElement{constructor(){super(...arguments),this.claims=[],this.citations=[],this.selectedClaimId="",this.label="",this.compact=!1,this.frame="card",this.canonicalClaimsBySource=new WeakMap,this.canonicalCitationsBySource=new WeakMap}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,claimEvidenceClaimsLimit:LYRA_DEFAULT_claimEvidenceClaimsLimit,claimEvidenceConfidence:LYRA_DEFAULT_claimEvidenceConfidence,claimEvidenceContradicted:LYRA_DEFAULT_claimEvidenceContradicted,claimEvidenceEmpty:LYRA_DEFAULT_claimEvidenceEmpty,claimEvidenceLabel:LYRA_DEFAULT_claimEvidenceLabel,claimEvidencePartiallySupported:LYRA_DEFAULT_claimEvidencePartiallySupported,claimEvidenceSupported:LYRA_DEFAULT_claimEvidenceSupported,claimEvidenceUnsupported:LYRA_DEFAULT_claimEvidenceUnsupported,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["claims","citations"])}static{this.identityCollectionProperties=Object.freeze(["claims","citations"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-claim-select","lr-citation-select"])}static{this.identityEventDetailProperties=Object.freeze({"lr-claim-select":Object.freeze(["claim"]),"lr-citation-select":Object.freeze(["citation"])})}canonicalRowsFor(source,cache,project,empty){if(source===null||typeof source!="object")return empty;const cached=cache.get(source);if(cached)return cached;const rows=projectRows(source,project,empty);return cache.set(source,rows),rows}get normalizedClaims(){return this.canonicalRowsFor(this.claims,this.canonicalClaimsBySource,projectClaim,EMPTY_CANONICAL_CLAIMS)}get normalizedCitations(){return this.canonicalRowsFor(this.citations,this.canonicalCitationsBySource,projectCitation,EMPTY_CANONICAL_CITATIONS)}statusLabel(status){switch(status){case"supported":return this.localize("claimEvidenceSupported");case"partially-supported":return this.localize("claimEvidencePartiallySupported");case"unsupported":return this.localize("claimEvidenceUnsupported");case"contradicted":return this.localize("claimEvidenceContradicted")}}confidenceLabel(value){const percent=getNumberFormat(this.effectiveLocale,{style:"percent"}).format(finiteRange(value,0,0,1));return this.localize("claimEvidenceConfidence",void 0,{percent})}resolvedCitations(claim,citations){const ids=new Set(claim.citationIds);return citations.filter(citation=>ids.has(citation.id))}renderClaim(claim,allCitations){const selected=claim.id===this.selectedClaimId,citations=this.resolvedCitations(claim,allCitations),status=normalizedClaimStatus(claim.status);return html`
       <li part=${selected?"claim claim-selected":"claim"} aria-current=${selected?"true":"false"}>
         <button
           part="claim-trigger"
@@ -36,8 +36,9 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
         aria-label=${label??nothing}
       >
         ${claims.length?html`<ol part="list">
-              ${claims.map(claim=>this.renderClaim(claim,citations))}
-            </ol>`:html`<lr-empty
+              ${claims.slice(0,MAX_RENDERED_CLAIM_EVIDENCE_CLAIMS).map(claim=>this.renderClaim(claim,citations))}
+            </ol>
+            ${claims.length>MAX_RENDERED_CLAIM_EVIDENCE_CLAIMS?html`<p part="limit" role="note">${this.localize("claimEvidenceClaimsLimit",void 0,{count:getNumberFormat(this.effectiveLocale).format(MAX_RENDERED_CLAIM_EVIDENCE_CLAIMS)})}</p>`:nothing}`:html`<lr-empty
               part="empty"
               heading=${this.localize("claimEvidenceEmpty")}
             ></lr-empty>`}

package/dist/components/retrieval/claim-evidence/claim-evidence.styles.js

@@ -1 +1 @@
-import{css}from"lit";const styles=css`:host{contain-intrinsic-inline-size:var(--lr-size-20rem);display:block;container-type:inline-size}[part=list]{gap:var(--lr-space-s);flex-direction:column;margin:0;padding:0;list-style:none;display:flex}[part~=claim]{border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-color-surface);min-inline-size:0;overflow:hidden}[part~=claim-selected]{border-color:var(--lr-color-brand)}:host([compact]) [part=claim-trigger]{padding:var(--lr-claim-evidence-compact-padding,var(--lr-space-xs));gap:var(--lr-claim-evidence-compact-gap,var(--lr-space-xs))}:host([frame=plain]) [part~=claim]{background:0 0;border:0;border-radius:0}[part=claim-trigger]{gap:var(--lr-space-s);box-sizing:border-box;inline-size:100%;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);padding:var(--lr-space-s);color:var(--lr-color-text);font:inherit;text-align:start;cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:0;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;display:grid}[part=claim-trigger]:hover{background:var(--lr-color-surface-raised)}[part=claim-trigger]:active{background:color-mix(in oklab, var(--lr-color-surface-raised), var(--lr-color-mix-partner) var(--lr-color-mix-active))}[part=claim-trigger]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:calc(var(--lr-focus-ring-offset) * -1)}[part=claim-text]{overflow-wrap:anywhere;min-inline-size:0}[part=confidence]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);white-space:nowrap}[part=explanation]{padding:0 var(--lr-space-s) var(--lr-space-s);color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);margin:0}[part=evidence]{gap:var(--lr-space-xs);padding:var(--lr-space-s);border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border);flex-wrap:wrap;align-items:center;display:flex}[part=evidence] q{min-inline-size:0;color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere}@container (inline-size<=319.98px){[part=claim-trigger]{grid-template-columns:1fr}}`;export{styles};
+import{css}from"lit";const styles=css`:host{contain-intrinsic-inline-size:var(--lr-size-20rem);display:block;container-type:inline-size}[part=list]{gap:var(--lr-space-s);flex-direction:column;margin:0;padding:0;list-style:none;display:flex}[part~=claim]{border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-color-surface);min-inline-size:0;overflow:hidden}[part~=claim-selected]{border-color:var(--lr-color-brand)}:host([compact]) [part=claim-trigger]{padding:var(--lr-claim-evidence-compact-padding,var(--lr-space-xs));gap:var(--lr-claim-evidence-compact-gap,var(--lr-space-xs))}:host([frame=plain]) [part~=claim]{background:0 0;border:0;border-radius:0}[part=claim-trigger]{gap:var(--lr-space-s);box-sizing:border-box;inline-size:100%;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);padding:var(--lr-space-s);color:var(--lr-color-text);font:inherit;text-align:start;cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:0;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;display:grid}[part=claim-trigger]:hover{background:var(--lr-color-surface-raised)}[part=claim-trigger]:active{background:color-mix(in oklab, var(--lr-color-surface-raised), var(--lr-color-mix-partner) var(--lr-color-mix-active))}[part=claim-trigger]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:calc(var(--lr-focus-ring-offset) * -1)}[part=claim-text]{overflow-wrap:anywhere;min-inline-size:0}[part=confidence]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);white-space:nowrap}[part=explanation]{padding:0 var(--lr-space-s) var(--lr-space-s);color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);margin:0}[part=evidence]{gap:var(--lr-space-xs);padding:var(--lr-space-s);border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border);flex-wrap:wrap;align-items:center;display:flex}[part=evidence] q{min-inline-size:0;color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere}@container (inline-size<=319.98px){[part=claim-trigger]{grid-template-columns:1fr}}[part=limit]{margin:var(--lr-space-s);color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-xs)}`;export{styles};

package/dist/components/retrieval/community-card/community-card.class.d.ts

@@ -33,6 +33,10 @@ export type CommunityCardAppearance=LyraFrame;export interface LyraCommunityCard
 * @csspart empty - The empty state shown when `community` is `null`.
 * @cssprop [--lr-community-card-bg=var(--lr-color-surface)] - Resting background of `[part="base"]`.
 *   `frame="plain"` still paints transparent.
+* @cssprop [--lr-community-card-compact-padding=var(--lr-space-s)] - `[part="base"]` padding while
+*   `compact`.
+* @cssprop [--lr-community-card-compact-gap=var(--lr-space-xs)] - `[part="base"]` gap while
+*   `compact`.
 * @status stable
 * @since 4.0.0
 */
@@ -43,7 +47,8 @@ community:LyraCommunity|null;
 members:readonly LyraEntity[];
 /** Visible member chips before the "+N" overflow chip. */
 maxMembers:number;
-/** Single-row layout (title + member count + drill button, no summary/chips). */
+/** Single-row layout (title + member count + drill button, no summary/chips), and tighter
+*  `[part="base"]` padding/gap — same convention as the sibling `lr-entity-card`'s `compact`. */
 compact:boolean;
 /** Container treatment, in the shared `LyraFrame` vocabulary — the same property this
 *  component's sibling `lr-entity-card` carries. `'card'` (the default) keeps the bordered,

package/dist/components/retrieval/community-card/community-card.styles.js

@@ -1 +1 @@
-import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-s);padding:var(--lr-space-m);border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-community-card-bg,var(--lr-color-surface));color:var(--lr-color-text);flex-direction:column;display:flex}:host([frame=plain]) [part=base]{background:0 0;border:0;border-radius:0;padding:0}[part=header]{align-items:center;gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=title]{flex:auto;min-inline-size:0}[part=title] button{box-sizing:border-box;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);max-inline-size:100%;color:var(--lr-color-text);font:inherit;font-size:var(--lr-font-size-m);font-weight:var(--lr-font-weight-semibold);text-align:start;cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:none;padding:0;display:block}[part=title] button:hover{text-decoration:underline}[part=title] button:active{background:color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active));text-decoration:underline}[part=title] button:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}:host([compact]) [part=title] button{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}[part=member-count]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);flex:none}[part=actions]{align-items:center;gap:var(--lr-space-xs);flex:none;display:flex}[part=summary]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere;margin:0}[part=members]{gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=member],[part=overflow]{box-sizing:border-box;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:none;padding:0}[part=member]:hover,[part=overflow]:hover{background:var(--lr-color-brand-quiet)}[part=member]:active,[part=overflow]:active{background:color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active))}[part=member]:focus-visible,[part=overflow]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}`;export{styles};
+import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-s);padding:var(--lr-space-m);border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-community-card-bg,var(--lr-color-surface));color:var(--lr-color-text);flex-direction:column;display:flex}:host([compact]) [part=base]{padding:var(--lr-community-card-compact-padding,var(--lr-space-s));gap:var(--lr-community-card-compact-gap,var(--lr-space-xs))}:host([frame=plain]) [part=base]{background:0 0;border:0;border-radius:0;padding:0}[part=header]{align-items:center;gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=title]{flex:auto;min-inline-size:0}[part=title] button{box-sizing:border-box;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);max-inline-size:100%;color:var(--lr-color-text);font:inherit;font-size:var(--lr-font-size-m);font-weight:var(--lr-font-weight-semibold);text-align:start;cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:none;padding:0;display:block}[part=title] button:hover{text-decoration:underline}[part=title] button:active{background:color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active));text-decoration:underline}[part=title] button:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}:host([compact]) [part=title] button{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}[part=member-count]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);flex:none}[part=actions]{align-items:center;gap:var(--lr-space-xs);flex:none;display:flex}[part=summary]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere;margin:0}[part=members]{gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=member],[part=overflow]{box-sizing:border-box;min-inline-size:var(--lr-icon-button-size);min-block-size:var(--lr-icon-button-size);cursor:pointer;transition:background-color var(--lr-transition-fast);background:0 0;border:none;padding:0}[part=member]:hover,[part=overflow]:hover{background:var(--lr-color-brand-quiet)}[part=member]:active,[part=overflow]:active{background:color-mix(in oklab, var(--lr-color-brand-quiet), var(--lr-color-mix-partner) var(--lr-color-mix-active))}[part=member]:focus-visible,[part=overflow]:focus-visible{outline:var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);outline-offset:var(--lr-focus-ring-offset)}`;export{styles};

package/dist/components/retrieval/embedding-explorer/embedding-explorer.class.d.ts

@@ -23,6 +23,9 @@ export interface EmbeddingPoint{id:string;x:number;y:number;label?:string;source
 * @csspart legend-item - One cluster's legend entry.
 * @csspart legend-swatch - One cluster's decorative color swatch.
 * @csspart legend-label - One cluster's visible name.
+* @csspart limit - The "showing N of M" notice, present only once `points` exceeds the render
+*   cap. The rendered subset is a deterministic, evenly spaced sample of the full array (not the
+*   leading run), so the plotted distribution stays representative above the cap.
 * @csspart empty - The empty state.
 * @cssprop [--lr-embedding-explorer-selected-stroke=var(--lr-color-brand)] - Stroke color of the selected point.
 * @cssprop [--lr-embedding-explorer-height=360px] - The plot's `block-size`. Set on the host from
@@ -57,7 +60,12 @@ height:string;
 /** JS-only accessible name for the plot while no host `aria-label` is authored. An authored host
 *  label governs the plot's name too (including an explicitly empty value), avoiding a competing
 *  generic plot label while still naming the shadow-internal `listbox` itself. */
-accessibleLabel:string|null;private activeIndex;private refocusAfterUpdate;private get validPoints();protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;
+accessibleLabel:string|null;private activeIndex;private refocusAfterUpdate;private get validPoints();
+/** `validPoints`, decimated to `MAX_RENDERED_POINTS` -- the set actually rendered, focusable,
+*  and reachable by roving-tabindex arrow navigation. `bounds` and the cluster legend still
+*  derive from the full `validPoints`, so a decimated view keeps the same scale and the same
+*  complete legend as the full plot. */
+private get renderedPoints();protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;
 /**
 * Publishes `height` as `--lr-embedding-explorer-height`, which `[part='plot']`'s `block-size`
 * reads. It has to land on the host: custom properties cascade downward into the shadow tree,

package/dist/components/retrieval/embedding-explorer/embedding-explorer.class.js

@@ -1,4 +1,4 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{nativeSvgTitle}from"../../../internal/svg-title.js";import{html,nothing,svg}from"lit";import{property,state}from"lit/decorators.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity}from"../retrieval-identity.js";import{finiteRange}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{sanitizeCssLength}from"../../../internal/safe-css.js";import{specialistTokens}from"../../../internal/specialist-tokens.styles.js";import{styles}from"./embedding-explorer.styles.js";import{activeElementIn}from"../../../internal/active-element.js";import{LYRA_DEFAULT_embeddingExplorerEmpty,LYRA_DEFAULT_embeddingExplorerLabel,LYRA_DEFAULT_embeddingExplorerPoint}from"../../../internal/default-strings.generated.js";const WIDTH=640,HEIGHT=360,PAD=24,PALETTE=["var(--lr-color-chart-1)","var(--lr-color-chart-2)","var(--lr-color-chart-3)","var(--lr-color-chart-4)","var(--lr-color-chart-5)","var(--lr-color-chart-6)","var(--lr-color-chart-7)","var(--lr-color-chart-8)"];class LyraEmbeddingExplorer extends LyraElement{constructor(){super(...arguments),this.points=[],this.selectedPointId="",this.height="360px",this.accessibleLabel=null,this.activeIndex=0,this.refocusAfterUpdate=!1}static{this.defaultStrings={...super.defaultStrings,embeddingExplorerEmpty:LYRA_DEFAULT_embeddingExplorerEmpty,embeddingExplorerLabel:LYRA_DEFAULT_embeddingExplorerLabel,embeddingExplorerPoint:LYRA_DEFAULT_embeddingExplorerPoint}}static{this.ownedCollectionProperties=Object.freeze(["points"])}static{this.styles=[LyraElement.styles,specialistTokens,styles]}get validPoints(){return firstByRetrievalIdentity(Array.isArray(this.points)?this.points:[],point=>Number.isFinite(point.x)&&Number.isFinite(point.y)?point.id:void 0)}willUpdate(changed){if(super.willUpdate(changed),!changed.has("points"))return;const active=activeElementIn(this.shadowRoot)??null,focusedId=active?.getAttribute("data-id"),points=this.validPoints,matchingIndex=focusedId?points.findIndex(point=>point.id===focusedId):-1;this.activeIndex=matchingIndex>=0?matchingIndex:Math.min(this.activeIndex,Math.max(0,points.length-1)),this.refocusAfterUpdate=active?.getAttribute("part")==="point"}updated(changed){super.updated(changed),changed.has("height")&&this.applyHeight(),this.refocusAfterUpdate&&(this.refocusAfterUpdate=!1,this.renderRoot.querySelector(`[data-index="${this.activeIndex}"]`)?.focus())}applyHeight(){const height=sanitizeCssLength(this.height,"height");height?this.style.setProperty("--lr-embedding-explorer-height",height):this.style.removeProperty("--lr-embedding-explorer-height")}position(point,bounds){const{minX,maxX,minY,maxY}=bounds,x=PAD+finiteRange((point.x-minX)/(maxX-minX||1),.5,0,1)*(WIDTH-PAD*2),y=HEIGHT-PAD-finiteRange((point.y-minY)/(maxY-minY||1),.5,0,1)*(HEIGHT-PAD*2);return{x,y}}announceLabel(point,index){return this.localize("embeddingExplorerPoint",void 0,{label:point.label||point.id,index:getNumberFormat(this.effectiveLocale).format(index+1)})}select(point){this.emit("lr-point-select",{point})}activatePoint(point,index){this.activeIndex=index,this.select(point)}onPointKeyDown(event,point,index){const points=this.validPoints;if(event.key==="Enter"||event.key===" "){event.preventDefault(),this.select(point);return}const rtl=this.effectiveDirection==="rtl",forward=rtl?"ArrowLeft":"ArrowRight",backward=rtl?"ArrowRight":"ArrowLeft";let next=index;if(event.key===forward||event.key==="ArrowDown")next=Math.min(points.length-1,index+1);else if(event.key===backward||event.key==="ArrowUp")next=Math.max(0,index-1);else if(event.key==="Home")next=0;else if(event.key==="End")next=points.length-1;else return;event.preventDefault(),this.activeIndex=next,this.updateComplete.then(()=>{this.renderRoot.querySelector(`[data-index="${next}"]`)?.focus()})}renderPoint(point,index,bounds,clusterIndices){const{x,y}=this.position(point,bounds),label=this.announceLabel(point,index),cluster=String(point.cluster??"").trim(),selected=point.id===this.selectedPointId;return svg`<g
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{nativeSvgTitle}from"../../../internal/svg-title.js";import{html,nothing,svg}from"lit";import{property,state}from"lit/decorators.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity}from"../retrieval-identity.js";import{finiteRange}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{sanitizeCssLength}from"../../../internal/safe-css.js";import{specialistTokens}from"../../../internal/specialist-tokens.styles.js";import{styles}from"./embedding-explorer.styles.js";import{activeElementIn}from"../../../internal/active-element.js";import{LYRA_DEFAULT_embeddingExplorerEmpty,LYRA_DEFAULT_embeddingExplorerLabel,LYRA_DEFAULT_embeddingExplorerPoint,LYRA_DEFAULT_embeddingExplorerPointLimit}from"../../../internal/default-strings.generated.js";const WIDTH=640,HEIGHT=360,PAD=24,MAX_RENDERED_POINTS=1e3,PALETTE=["var(--lr-color-chart-1)","var(--lr-color-chart-2)","var(--lr-color-chart-3)","var(--lr-color-chart-4)","var(--lr-color-chart-5)","var(--lr-color-chart-6)","var(--lr-color-chart-7)","var(--lr-color-chart-8)"];function decimatePoints(items,max){if(items.length<=max||max<=0)return[...items];if(max===1)return[items[0]];const step=(items.length-1)/(max-1),result=[],seen=new Set;for(let i=0;i<max;i++){const index=Math.min(items.length-1,Math.round(i*step));seen.has(index)||(seen.add(index),result.push(items[index]))}return result}class LyraEmbeddingExplorer extends LyraElement{constructor(){super(...arguments),this.points=[],this.selectedPointId="",this.height="360px",this.accessibleLabel=null,this.activeIndex=0,this.refocusAfterUpdate=!1}static{this.defaultStrings={...super.defaultStrings,embeddingExplorerEmpty:LYRA_DEFAULT_embeddingExplorerEmpty,embeddingExplorerLabel:LYRA_DEFAULT_embeddingExplorerLabel,embeddingExplorerPoint:LYRA_DEFAULT_embeddingExplorerPoint,embeddingExplorerPointLimit:LYRA_DEFAULT_embeddingExplorerPointLimit}}static{this.ownedCollectionProperties=Object.freeze(["points"])}static{this.styles=[LyraElement.styles,specialistTokens,styles]}get validPoints(){return firstByRetrievalIdentity(Array.isArray(this.points)?this.points:[],point=>Number.isFinite(point.x)&&Number.isFinite(point.y)?point.id:void 0)}get renderedPoints(){return decimatePoints(this.validPoints,MAX_RENDERED_POINTS)}willUpdate(changed){if(super.willUpdate(changed),!changed.has("points"))return;const active=activeElementIn(this.shadowRoot)??null,focusedId=active?.getAttribute("data-id"),points=this.renderedPoints,matchingIndex=focusedId?points.findIndex(point=>point.id===focusedId):-1;this.activeIndex=matchingIndex>=0?matchingIndex:Math.min(this.activeIndex,Math.max(0,points.length-1)),this.refocusAfterUpdate=active?.getAttribute("part")==="point"}updated(changed){super.updated(changed),changed.has("height")&&this.applyHeight(),this.refocusAfterUpdate&&(this.refocusAfterUpdate=!1,this.renderRoot.querySelector(`[data-index="${this.activeIndex}"]`)?.focus())}applyHeight(){const height=sanitizeCssLength(this.height,"height");height?this.style.setProperty("--lr-embedding-explorer-height",height):this.style.removeProperty("--lr-embedding-explorer-height")}position(point,bounds){const{minX,maxX,minY,maxY}=bounds,x=PAD+finiteRange((point.x-minX)/(maxX-minX||1),.5,0,1)*(WIDTH-PAD*2),y=HEIGHT-PAD-finiteRange((point.y-minY)/(maxY-minY||1),.5,0,1)*(HEIGHT-PAD*2);return{x,y}}announceLabel(point,index){return this.localize("embeddingExplorerPoint",void 0,{label:point.label||point.id,index:getNumberFormat(this.effectiveLocale).format(index+1)})}select(point){this.emit("lr-point-select",{point})}activatePoint(point,index){this.activeIndex=index,this.select(point)}onPointKeyDown(event,point,index){const points=this.renderedPoints;if(event.key==="Enter"||event.key===" "){event.preventDefault(),this.select(point);return}const rtl=this.effectiveDirection==="rtl",forward=rtl?"ArrowLeft":"ArrowRight",backward=rtl?"ArrowRight":"ArrowLeft";let next=index;if(event.key===forward||event.key==="ArrowDown")next=Math.min(points.length-1,index+1);else if(event.key===backward||event.key==="ArrowUp")next=Math.max(0,index-1);else if(event.key==="Home")next=0;else if(event.key==="End")next=points.length-1;else return;event.preventDefault(),this.activeIndex=next,this.updateComplete.then(()=>{this.renderRoot.querySelector(`[data-index="${next}"]`)?.focus()})}renderPoint(point,index,bounds,clusterIndices){const{x,y}=this.position(point,bounds),label=this.announceLabel(point,index),cluster=String(point.cluster??"").trim(),selected=point.id===this.selectedPointId;return svg`<g
       part="point"
       data-index=${index}
       data-id=${point.id}
@@ -27,15 +27,16 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
       ${nativeSvgTitle(label)}
     </g>`}render(){const points=this.validPoints,hostLabel=hostAriaLabel(this),label=hostLabel===null?this.accessibleLabel??this.localize("embeddingExplorerLabel"):hostLabel;if(points.length===0)return html`<div part="base" role="region" aria-label=${label}>
         <p part="empty">${this.localize("embeddingExplorerEmpty")}</p>
-      </div>`;const bounds=points.reduce((result,point)=>({minX:Math.min(result.minX,point.x),maxX:Math.max(result.maxX,point.x),minY:Math.min(result.minY,point.y),maxY:Math.max(result.maxY,point.y)}),{minX:1/0,maxX:-1/0,minY:1/0,maxY:-1/0}),clusters=[...new Set(points.map(point=>String(point.cluster??"").trim()))].sort(),clusterIndices=new Map(clusters.map((cluster,index)=>[cluster,index])),visibleClusters=clusters.filter(cluster=>cluster.trim()!=="");return html`<div part="base">
+      </div>`;const renderedPoints=this.renderedPoints,bounds=points.reduce((result,point)=>({minX:Math.min(result.minX,point.x),maxX:Math.max(result.maxX,point.x),minY:Math.min(result.minY,point.y),maxY:Math.max(result.maxY,point.y)}),{minX:1/0,maxX:-1/0,minY:1/0,maxY:-1/0}),clusters=[...new Set(points.map(point=>String(point.cluster??"").trim()))].sort(),clusterIndices=new Map(clusters.map((cluster,index)=>[cluster,index])),visibleClusters=clusters.filter(cluster=>cluster.trim()!==""),numberFormat=getNumberFormat(this.effectiveLocale);return html`<div part="base">
       <svg
         part="plot"
         viewBox="0 0 ${WIDTH} ${HEIGHT}"
         role="listbox"
         aria-label=${label}
       >
-        ${points.map((point,index)=>this.renderPoint(point,index,bounds,clusterIndices))}
+        ${renderedPoints.map((point,index)=>this.renderPoint(point,index,bounds,clusterIndices))}
       </svg>
+      ${renderedPoints.length<points.length?html`<p part="limit" role="note">${this.localize("embeddingExplorerPointLimit",void 0,{shown:numberFormat.format(renderedPoints.length),total:numberFormat.format(points.length)})}</p>`:nothing}
       ${visibleClusters.length>0?html`<div part="legend" role="list">
             ${visibleClusters.map(cluster=>html`<span
                 part="legend-item"

package/dist/components/retrieval/entity-card/entity-card.styles.js

@@ -1 +1 @@
-import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-s);padding:var(--lr-space-m);border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-entity-card-bg,var(--lr-color-surface));color:var(--lr-color-text);flex-direction:column;min-inline-size:0;display:flex}:host([compact]) [part=base]{padding:var(--lr-entity-card-compact-padding,var(--lr-space-s));gap:var(--lr-entity-card-compact-gap,var(--lr-space-xs))}:host([frame=plain]) [part=base]{background:0 0;border:0;border-radius:0;padding:0}[part=header]{align-items:center;gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=title]{min-inline-size:0;font-size:var(--lr-font-size-m);font-weight:var(--lr-font-weight-semibold);overflow-wrap:anywhere;flex:auto}[part=description]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere;margin:0}[part=properties]{gap:var(--lr-space-xs);flex-direction:column;display:flex}[part=actions]{align-items:center;gap:var(--lr-space-xs);flex:none;display:flex}@media (forced-colors:active){[part=type-badge]{--lr-badge-color:var(--lr-color-text)!important;--lr-badge-background:var(--lr-color-surface)!important;--lr-badge-border:var(--lr-color-border-strong)!important}}`;export{styles};
+import{css}from"lit";const styles=css`:host{display:block}[part=base]{gap:var(--lr-space-s);padding:var(--lr-space-m);border:var(--lr-border-width-thin) solid var(--lr-color-border);border-radius:var(--lr-radius);background:var(--lr-entity-card-bg,var(--lr-color-surface));color:var(--lr-color-text);box-sizing:border-box;flex-direction:column;block-size:100%;min-inline-size:0;display:flex}:host([compact]) [part=base]{padding:var(--lr-entity-card-compact-padding,var(--lr-space-s));gap:var(--lr-entity-card-compact-gap,var(--lr-space-xs))}:host([frame=plain]) [part=base]{background:0 0;border:0;border-radius:0;padding:0}[part=header]{align-items:center;gap:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=title]{min-inline-size:0;font-size:var(--lr-font-size-m);font-weight:var(--lr-font-weight-semibold);overflow-wrap:anywhere;flex:auto}[part=description]{color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-sm);overflow-wrap:anywhere;margin:0}[part=properties]{gap:var(--lr-space-xs);flex-direction:column;display:flex}[part=actions]{align-items:center;gap:var(--lr-space-xs);flex:none;display:flex}@media (forced-colors:active){[part=type-badge]{--lr-badge-color:var(--lr-color-text)!important;--lr-badge-background:var(--lr-color-surface)!important;--lr-badge-border:var(--lr-color-border-strong)!important}}`;export{styles};

package/dist/components/retrieval/entity-chip/entity-chip.class.d.ts

@@ -13,7 +13,9 @@ import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from
 *
 * @customElement lr-entity-chip
 * @slot - Rich preview content (typically a compact `lr-entity-card`), shown in a floating
-* popover on hover/focus. No content -> no popover and no hover affordance at all.
+* popover on hover/focus. No content -> no popover and no hover affordance at all. An open
+* popover participates in shared Escape ordering even while only hovered, deferring to a
+* genuinely topmost overlay opened on top of it.
 * @event lr-entity-select - Click, or Enter while focused. `detail: { entityId }`.
 * @event lr-entity-open - Dblclick, or Space while focused. `detail: { entityId }`.
 * @csspart base - The clickable chip (`<button>`).
@@ -54,4 +56,4 @@ typeLabel?:string;private popoverOpen;private buttonEl?;private popoverEl?;priva
 *  regardless of assignment, so `:empty` never matches either. The shared controller answers the
 *  same "does this slot carry real consumer content" question every other presence-driven
 *  component asks, seeded before the first render and kept live afterwards. */
-private readonly slotPresence;private cleanupPositioner?;private hideTimer?;private hideTimerOwner?;private hovering;private focused;private get hasPreviewSlot();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;private get accessibleLabel();private showPreview;private clearHideTimer;private scheduleHidePreview;private hidePreviewNow;private onPointerEnter;private onPointerLeave;private onFocusIn;private onFocusOut;private onKeyDown;private onClick;private onDblClick;private emitOpen;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-entity-chip':LyraEntityChip;}}
+private readonly slotPresence;private cleanupPositioner?;private overlayHandle?;private hideTimer?;private hideTimerOwner?;private hovering;private focused;private get hasPreviewSlot();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;private get accessibleLabel();private showPreview;private clearHideTimer;private scheduleHidePreview;private hidePreviewNow;private onPointerEnter;private onPointerLeave;private onFocusIn;private onFocusOut;private onKeyDown;private onClick;private onDblClick;private emitOpen;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-entity-chip':LyraEntityChip;}}

package/dist/components/retrieval/entity-chip/entity-chip.class.js

@@ -1,4 +1,4 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{isNonBlankIdentity}from"../retrieval-identity.js";import{deferredPlace as place}from"../../../internal/anchored-overlay-runtime.js";import{resolveEffectivePositioningStrategy}from"../../../internal/positioning-strategy.js";import{nextId}from"../../../internal/a11y.js";import{SlotPresenceController}from"../../../internal/slot-presence-controller.js";import{styles}from"./entity-chip.styles.js";import{LYRA_DEFAULT_entityChipWithType,LYRA_DEFAULT_untitledEntity}from"../../../internal/default-strings.generated.js";const HIDE_DELAY_MS=200;class LyraEntityChip extends LyraElement{constructor(){super(...arguments),this.entityId="",this.text="",this.type="",this.popoverOpen=!1,this.popoverId=nextId("entity-chip-popover"),this.slotPresence=new SlotPresenceController(this),this.hovering=!1,this.focused=!1,this.onPointerEnter=()=>{this.hovering=!0,this.showPreview()},this.onPointerLeave=()=>{this.hovering=!1,this.scheduleHidePreview()},this.onFocusIn=()=>{this.focused=!0,this.showPreview()},this.onFocusOut=()=>{this.focused=!1,!this.hovering&&this.hidePreviewNow()},this.onKeyDown=e=>{if(e.key==="Escape"&&this.popoverOpen){e.stopPropagation(),this.hidePreviewNow();return}e.key===" "&&!e.repeat&&e.target===this.buttonEl&&(e.preventDefault(),this.emitOpen())},this.onClick=()=>{isNonBlankIdentity(this.entityId)&&this.emit("lr-entity-select",{entityId:this.entityId})},this.onDblClick=()=>{this.emitOpen()}}static{this.defaultStrings={...super.defaultStrings,entityChipWithType:LYRA_DEFAULT_entityChipWithType,untitledEntity:LYRA_DEFAULT_untitledEntity}}static{this.styles=[LyraElement.styles,styles]}get hasPreviewSlot(){return this.slotPresence.has()}willUpdate(changed){super.willUpdate(changed),this.popoverOpen&&!this.hasPreviewSlot&&this.hidePreviewNow()}updated(changed){super.updated(changed),changed.has("popoverOpen")&&(this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.popoverOpen&&this.buttonEl&&this.popoverEl&&(this.cleanupPositioner=place(this.buttonEl,this.popoverEl,{placement:"top-start",strategy:resolveEffectivePositioningStrategy(this,void 0,"fixed")})))}disconnectedCallback(){super.disconnectedCallback(),this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.clearHideTimer(),this.popoverOpen=!1,this.hovering=!1,this.focused=!1}get accessibleLabel(){const label=(this.text??"").trim()===""?this.localize("untitledEntity"):this.text,typeText=this.typeLabel?.trim()||(this.type??"").trim();return typeText?this.localize("entityChipWithType",void 0,{label,type:typeText}):label}showPreview(){this.hasPreviewSlot&&(this.clearHideTimer(),!this.popoverOpen&&(this.popoverOpen=!0))}clearHideTimer(){this.hideTimer!==void 0&&this.hideTimerOwner?.clearTimeout(this.hideTimer),this.hideTimer=void 0,this.hideTimerOwner=void 0}scheduleHidePreview(){if(!this.popoverOpen||this.hovering||this.focused)return;this.clearHideTimer();const ownerWindow=this.ownerDocument.defaultView;if(!ownerWindow)return;const handle=ownerWindow.setTimeout(()=>{this.hideTimer===handle&&(this.hideTimer=void 0,this.hideTimerOwner=void 0,this.popoverOpen=!1)},HIDE_DELAY_MS);this.hideTimer=handle,this.hideTimerOwner=ownerWindow}hidePreviewNow(){this.clearHideTimer(),this.popoverOpen&&(this.popoverOpen=!1)}emitOpen(){isNonBlankIdentity(this.entityId)&&this.emit("lr-entity-open",{entityId:this.entityId})}render(){return html`
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{isNonBlankIdentity}from"../retrieval-identity.js";import{deferredPlace as place}from"../../../internal/anchored-overlay-runtime.js";import{activateNonmodalOverlay}from"../../../internal/nonmodal-overlay-manager.js";import{resolveEffectivePositioningStrategy}from"../../../internal/positioning-strategy.js";import{nextId}from"../../../internal/a11y.js";import{SlotPresenceController}from"../../../internal/slot-presence-controller.js";import{styles}from"./entity-chip.styles.js";import{LYRA_DEFAULT_entityChipWithType,LYRA_DEFAULT_untitledEntity}from"../../../internal/default-strings.generated.js";const HIDE_DELAY_MS=200;class LyraEntityChip extends LyraElement{constructor(){super(...arguments),this.entityId="",this.text="",this.type="",this.popoverOpen=!1,this.popoverId=nextId("entity-chip-popover"),this.slotPresence=new SlotPresenceController(this),this.hovering=!1,this.focused=!1,this.onPointerEnter=()=>{this.hovering=!0,this.showPreview()},this.onPointerLeave=()=>{this.hovering=!1,this.scheduleHidePreview()},this.onFocusIn=()=>{this.focused=!0,this.showPreview()},this.onFocusOut=()=>{this.focused=!1,!this.hovering&&this.hidePreviewNow()},this.onKeyDown=e=>{if(e.key==="Escape"&&this.popoverOpen&&this.overlayHandle?.isTopmost()){e.stopPropagation(),this.hidePreviewNow();return}e.key===" "&&!e.repeat&&e.target===this.buttonEl&&(e.preventDefault(),this.emitOpen())},this.onClick=()=>{isNonBlankIdentity(this.entityId)&&this.emit("lr-entity-select",{entityId:this.entityId})},this.onDblClick=()=>{this.emitOpen()}}static{this.defaultStrings={...super.defaultStrings,entityChipWithType:LYRA_DEFAULT_entityChipWithType,untitledEntity:LYRA_DEFAULT_untitledEntity}}static{this.styles=[LyraElement.styles,styles]}get hasPreviewSlot(){return this.slotPresence.has()}willUpdate(changed){super.willUpdate(changed),this.popoverOpen&&!this.hasPreviewSlot&&this.hidePreviewNow()}updated(changed){super.updated(changed),changed.has("popoverOpen")&&(this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.overlayHandle?.deactivate({restoreFocus:!1}),this.overlayHandle=void 0,this.popoverOpen&&this.buttonEl&&this.popoverEl&&(this.cleanupPositioner=place(this.buttonEl,this.popoverEl,{placement:"top-start",strategy:resolveEffectivePositioningStrategy(this,void 0,"fixed")}),this.overlayHandle=activateNonmodalOverlay({host:this,panel:()=>this.popoverEl??null,onEscape:()=>this.hidePreviewNow(),restoreFocusTo:null})))}disconnectedCallback(){super.disconnectedCallback(),this.cleanupPositioner?.(),this.cleanupPositioner=void 0,this.overlayHandle?.deactivate({restoreFocus:!1}),this.overlayHandle=void 0,this.clearHideTimer(),this.popoverOpen=!1,this.hovering=!1,this.focused=!1}get accessibleLabel(){const label=(this.text??"").trim()===""?this.localize("untitledEntity"):this.text,typeText=this.typeLabel?.trim()||(this.type??"").trim();return typeText?this.localize("entityChipWithType",void 0,{label,type:typeText}):label}showPreview(){this.hasPreviewSlot&&(this.clearHideTimer(),!this.popoverOpen&&(this.popoverOpen=!0))}clearHideTimer(){this.hideTimer!==void 0&&this.hideTimerOwner?.clearTimeout(this.hideTimer),this.hideTimer=void 0,this.hideTimerOwner=void 0}scheduleHidePreview(){if(!this.popoverOpen||this.hovering||this.focused)return;this.clearHideTimer();const ownerWindow=this.ownerDocument.defaultView;if(!ownerWindow)return;const handle=ownerWindow.setTimeout(()=>{this.hideTimer===handle&&(this.hideTimer=void 0,this.hideTimerOwner=void 0,this.popoverOpen=!1)},HIDE_DELAY_MS);this.hideTimer=handle,this.hideTimerOwner=ownerWindow}hidePreviewNow(){this.clearHideTimer(),this.popoverOpen&&(this.popoverOpen=!1)}emitOpen(){isNonBlankIdentity(this.entityId)&&this.emit("lr-entity-open",{entityId:this.entityId})}render(){return html`
       <span
         class="wrapper"
         @pointerenter=${this.onPointerEnter}

package/dist/components/retrieval/entity-dossier/entity-dossier.class.js

@@ -1,6 +1,6 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{LyraElement}from"../../../internal/lyra-element.js";import"../entity-card/entity-card.class.js";import"../neighbor-list/neighbor-list.class.js";import"../chunk-inspector/chunk-inspector.class.js";import"../provenance-panel/provenance-panel.class.js";import"../../data/stat/stat.class.js";import"../../layout/tab-group/tab-group.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./entity-dossier.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{LYRA_DEFAULT_chunkInspectorLabel,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_neighborListLabel,LYRA_DEFAULT_noData,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_progress,LYRA_DEFAULT_provenancePanelLabel,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";class LyraEntityDossier extends LyraElement{constructor(){super(...arguments),this.entity=null,this.types=[],this.communityLabel="",this.showFocusButton=!0,this.confidence=null,this.neighbors=[],this.groupByRelation=!1,this.expandable=!1,this.chunks=[],this.thresholds={high:.75,medium:.5},this.provenance=null,this.accessibleLabel=null,this.activeTab="relationships",this.onTabsChange=e=>{e.stopPropagation();const tabId=e.detail.name;this.activeTab=tabId,this.emit("lr-tab-show",{tabId})},this.containTabsEvent=e=>{e.stopPropagation()}}static{this.defaultStrings={...super.defaultStrings,chunkInspectorLabel:LYRA_DEFAULT_chunkInspectorLabel,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,neighborListLabel:LYRA_DEFAULT_neighborListLabel,noData:LYRA_DEFAULT_noData,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,progress:LYRA_DEFAULT_progress,provenancePanelLabel:LYRA_DEFAULT_provenancePanelLabel,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["entity","confidence","types","neighbors","chunks","provenance"])}static{this.styles=[LyraElement.styles,styles]}render(){if(!this.entity)return html`<div part="base">
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import"../entity-card/entity-card.class.js";import"../neighbor-list/neighbor-list.class.js";import"../chunk-inspector/chunk-inspector.class.js";import"../provenance-panel/provenance-panel.class.js";import"../../data/stat/stat.class.js";import"../../layout/tab-group/tab-group.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./entity-dossier.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{LYRA_DEFAULT_chunkInspectorLabel,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_neighborListLabel,LYRA_DEFAULT_noData,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_progress,LYRA_DEFAULT_provenancePanelLabel,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";class LyraEntityDossier extends LyraElement{constructor(){super(...arguments),this.entity=null,this.types=[],this.communityLabel="",this.showFocusButton=!0,this.confidence=null,this.neighbors=[],this.groupByRelation=!1,this.expandable=!1,this.chunks=[],this.thresholds={high:.75,medium:.5},this.provenance=null,this.accessibleLabel=null,this.activeTab="relationships",this.onTabsChange=e=>{e.stopPropagation();const tabId=e.detail.name;this.activeTab=tabId,this.emit("lr-tab-show",{tabId})},this.containTabsEvent=e=>{e.stopPropagation()}}static{this.defaultStrings={...super.defaultStrings,chunkInspectorLabel:LYRA_DEFAULT_chunkInspectorLabel,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,neighborListLabel:LYRA_DEFAULT_neighborListLabel,noData:LYRA_DEFAULT_noData,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,progress:LYRA_DEFAULT_progress,provenancePanelLabel:LYRA_DEFAULT_provenancePanelLabel,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["entity","confidence","types","neighbors","chunks","provenance"])}static{this.styles=[LyraElement.styles,styles]}render(){if(!this.entity)return html`<div part="base">
         <lr-empty part="empty" heading=${this.localize("noData")}></lr-empty>
-      </div>`;const entity=this.entity,c=this.confidence,tabsLabel=hostAriaLabel(this)===null?this.accessibleLabel??nothing:nothing;return html`
+      </div>`;const entity=this.entity,c=this.confidence,tabsLabel=this.hasAttribute("aria-label")?nothing:this.accessibleLabel??nothing;return html`
       <div part="base">
         <div part="header">
           <lr-entity-card

package/dist/components/retrieval/graph-legend/graph-legend.class.d.ts

@@ -1,4 +1,9 @@
-import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export interface LyraGraphLegendVisibilityDetail{hiddenTypes:string[];}export interface LyraGraphLegendEventMap{'lr-before-visibility-change':CustomEvent<LyraEventDetailSnapshot<LyraGraphLegendVisibilityDetail>>;'lr-visibility-change':CustomEvent<LyraEventDetailSnapshot<LyraGraphLegendVisibilityDetail>>;}
+import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export type{LyraNodeTypeStyle}from'../../../internal/node-type-style.js';export interface LyraGraphLegendVisibilityDetail{hiddenTypes:string[];}export interface LyraGraphLegendEventMap{
+/** Canonical name for the visibility-change veto point. */
+'lr-visibility-change-request':CustomEvent<LyraEventDetailSnapshot<LyraGraphLegendVisibilityDetail>>;
+/** Deprecated alias of `lr-visibility-change-request`, kept firing unchanged for back-compat;
+*  slated for removal in 21.0.0. */
+'lr-before-visibility-change':CustomEvent<LyraEventDetailSnapshot<LyraGraphLegendVisibilityDetail>>;'lr-visibility-change':CustomEvent<LyraEventDetailSnapshot<LyraGraphLegendVisibilityDetail>>;}
 /**
 * `<lr-graph-legend>` — a node-type legend for a paired `lr-graph`: one swatch + label + count
 * row per `lr-graph` node type, doubling as visibility filters. Never reads or writes a graph directly —
@@ -12,8 +17,12 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * untyped payload cannot create an unnamed interactive filter.
 *
 * @customElement lr-graph-legend
-* @event lr-before-visibility-change - Cancelable proposed visibility change. `detail: { hiddenTypes }`
-*   is a frozen complete next array; canceling leaves state, announcements, and the post event unchanged.
+* @event lr-visibility-change-request - Cancelable proposed visibility change. `detail: { hiddenTypes }`
+*   is a frozen complete next array; canceling leaves state, announcements, and the post event
+*   unchanged. Fires before `lr-before-visibility-change`, from the same gesture; either event may
+*   veto.
+* @event lr-before-visibility-change - Deprecated cancelable alias of `lr-visibility-change-request`, kept
+*   firing unchanged for back-compat; slated for removal in 21.0.0. Same frozen detail.
 * @event lr-visibility-change - `detail: { hiddenTypes }` — the complete updated array, fired
 *   after an accepted toggle has assigned and announced it.
 * @csspart base - The legend wrapper. It owns `role="group"` and the fallback name unless a
@@ -46,4 +55,9 @@ interactive:boolean;
 label:string;private liveText;
 /** The documented part remains a shadow-DOM text mirror only; announcements use this shared
 * light-DOM sink because shadow live regions are not reliable across AT/browser pairs. */
-private announcementSink?;connectedCallback():void;disconnectedCallback():void;private paletteColor;private swatchColor;private isVisible;private toggle;private renderSwatchShape;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-graph-legend':LyraGraphLegend;}}
+private announcementSink?;connectedCallback():void;disconnectedCallback():void;private paletteColor;
+/** Builds a `paletteColor()` resolver that reads `getComputedStyle(this)` at most once per
+*  distinct `index % PALETTE_SIZE` slot, reused across the rest of one `render()` pass, instead
+*  of once per legend entry -- the underlying `--lr-graph-cat-N` value cannot change between two
+*  entries in the same synchronous render. */
+private paletteColorResolver;private isVisible;private toggle;private renderSwatchShape;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-graph-legend':LyraGraphLegend;}}

package/dist/components/retrieval/graph-legend/graph-legend.class.js

@@ -1,10 +1,10 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing,svg}from"lit";import{property,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{canonicalIdentityList,firstByRetrievalIdentity}from"../retrieval-identity.js";import{specialistTokens}from"../../../internal/specialist-tokens.styles.js";import{srOnly}from"../../../internal/a11y.js";import{styles}from"./graph-legend.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{finiteCount}from"../../../internal/numbers.js";import{sanitizeCssColor}from"../../../internal/safe-css.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{LYRA_DEFAULT_graphLegendLabel,LYRA_DEFAULT_legendTypeHidden,LYRA_DEFAULT_legendTypeShown}from"../../../internal/default-strings.generated.js";const PALETTE_SIZE=8,FALLBACK_PALETTE=["#0969da","#1a7f37","#9a6700","#cf222e","#8250df","#bf3989","#0a7d91","#57606a"];class LyraGraphLegend extends LyraElement{constructor(){super(...arguments),this.types=[],this.hiddenTypes=[],this.interactive=!0,this.label="",this.liveText=""}static{this.defaultStrings={...super.defaultStrings,graphLegendLabel:LYRA_DEFAULT_graphLegendLabel,legendTypeHidden:LYRA_DEFAULT_legendTypeHidden,legendTypeShown:LYRA_DEFAULT_legendTypeShown}}static{this.ownedCollectionProperties=Object.freeze(["types","hiddenTypes","counts"])}static{this.styles=[LyraElement.styles,specialistTokens,styles,srOnly]}static{this.immutableEventDetails=Object.freeze(["lr-before-visibility-change","lr-visibility-change"])}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this})}disconnectedCallback(){this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}paletteColor(index){return getComputedStyle(this).getPropertyValue(`--lr-graph-cat-${index%PALETTE_SIZE+1}`).trim()||FALLBACK_PALETTE[index%PALETTE_SIZE]}swatchColor(type,index){return sanitizeCssColor(type.color)??this.paletteColor(index)}isVisible(id){return!canonicalIdentityList(this.hiddenTypes).includes(id)}toggle(type){if(!this.interactive)return;const hiddenTypes=canonicalIdentityList(this.hiddenTypes),wasVisible=this.isVisible(type.id),next=wasVisible?[...hiddenTypes,type.id]:hiddenTypes.filter(id=>id!==type.id);this.emit("lr-before-visibility-change",{hiddenTypes:next},{cancelable:!0}).defaultPrevented||(this.hiddenTypes=next,this.liveText=this.localize(wasVisible?"legendTypeHidden":"legendTypeShown",void 0,{label:type.label}),this.announcementSink?.announce(this.liveText),this.emit("lr-visibility-change",{hiddenTypes:next}))}renderSwatchShape(shape,color){return shape==="square"?svg`<rect x="1" y="1" width="10" height="10" fill=${color}></rect>`:shape==="diamond"?svg`<polygon points="6,0 12,6 6,12 0,6" fill=${color}></polygon>`:svg`<circle cx="6" cy="6" r="5" fill=${color}></circle>`}render(){const types=firstByRetrievalIdentity(this.types,type=>type?.id).filter(type=>typeof type?.label=="string"&&type.label.trim().length>0),groupLabel=retrievalSemanticLabel(this,this.label||this.localize("graphLegendLabel")),groupRole=retrievalSemanticRole(this,"group");return html`
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing,svg}from"lit";import{property,state}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{canonicalIdentityList,firstByRetrievalIdentity}from"../retrieval-identity.js";import{specialistTokens}from"../../../internal/specialist-tokens.styles.js";import{srOnly}from"../../../internal/a11y.js";import{styles}from"./graph-legend.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{finiteCount}from"../../../internal/numbers.js";import{sanitizeCssColor}from"../../../internal/safe-css.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{LYRA_DEFAULT_graphLegendLabel,LYRA_DEFAULT_legendTypeHidden,LYRA_DEFAULT_legendTypeShown}from"../../../internal/default-strings.generated.js";const PALETTE_SIZE=8,FALLBACK_PALETTE=["#0969da","#1a7f37","#9a6700","#cf222e","#8250df","#bf3989","#0a7d91","#57606a"];class LyraGraphLegend extends LyraElement{constructor(){super(...arguments),this.types=[],this.hiddenTypes=[],this.interactive=!0,this.label="",this.liveText=""}static{this.defaultStrings={...super.defaultStrings,graphLegendLabel:LYRA_DEFAULT_graphLegendLabel,legendTypeHidden:LYRA_DEFAULT_legendTypeHidden,legendTypeShown:LYRA_DEFAULT_legendTypeShown}}static{this.ownedCollectionProperties=Object.freeze(["types","hiddenTypes","counts"])}static{this.styles=[LyraElement.styles,specialistTokens,styles,srOnly]}static{this.immutableEventDetails=Object.freeze(["lr-visibility-change-request","lr-before-visibility-change","lr-visibility-change"])}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this})}disconnectedCallback(){this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}paletteColor(index){return getComputedStyle(this).getPropertyValue(`--lr-graph-cat-${index%PALETTE_SIZE+1}`).trim()||FALLBACK_PALETTE[index%PALETTE_SIZE]}paletteColorResolver(){const cache=new Map;return index=>{const slot=index%PALETTE_SIZE;let color=cache.get(slot);return color===void 0&&(color=this.paletteColor(index),cache.set(slot,color)),color}}isVisible(id){return!canonicalIdentityList(this.hiddenTypes).includes(id)}toggle(type){if(!this.interactive)return;const hiddenTypes=canonicalIdentityList(this.hiddenTypes),wasVisible=this.isVisible(type.id),next=wasVisible?[...hiddenTypes,type.id]:hiddenTypes.filter(id=>id!==type.id),proposal=this.emit("lr-visibility-change-request",{hiddenTypes:next},{cancelable:!0}),deprecatedAlias=this.emit("lr-before-visibility-change",{hiddenTypes:next},{cancelable:!0});proposal.defaultPrevented||deprecatedAlias.defaultPrevented||(this.hiddenTypes=next,this.liveText=this.localize(wasVisible?"legendTypeHidden":"legendTypeShown",void 0,{label:type.label}),this.announcementSink?.announce(this.liveText),this.emit("lr-visibility-change",{hiddenTypes:next}))}renderSwatchShape(shape,color){return shape==="square"?svg`<rect x="1" y="1" width="10" height="10" fill=${color}></rect>`:shape==="diamond"?svg`<polygon points="6,0 12,6 6,12 0,6" fill=${color}></polygon>`:svg`<circle cx="6" cy="6" r="5" fill=${color}></circle>`}render(){const types=firstByRetrievalIdentity(this.types,type=>type?.id).filter(type=>typeof type?.label=="string"&&type.label.trim().length>0),groupLabel=retrievalSemanticLabel(this,this.label||this.localize("graphLegendLabel")),groupRole=retrievalSemanticRole(this,"group"),resolvePaletteColor=this.paletteColorResolver();return html`
       <div
         part="base"
         role=${groupRole??nothing}
         aria-label=${groupLabel??nothing}
       >
-        ${types.map((type,index)=>{const visible=this.isVisible(type.id),color=this.swatchColor(type,index),count=this.counts?.[type.id],content=html`
+        ${types.map((type,index)=>{const visible=this.isVisible(type.id),color=sanitizeCssColor(type.color)??resolvePaletteColor(index),count=this.counts?.[type.id],content=html`
             <svg
               part="swatch"
               viewBox="0 0 12 12"

package/dist/components/retrieval/grounding-summary/grounding-summary.class.d.ts

@@ -22,6 +22,12 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * array does not update the view. Blank claim/citation ids and later duplicates are ignored before
 * counts, lookup, rendering, or activation. The first record for an id wins.
 *
+* At most 500 citations render as `[part="evidence-item"]` rows; a `citations` array past that
+* length still reports its true count in `[part="evidence-count"]` but renders a localized
+* `[part="limit"]` notice after the list rather than mounting an unbounded number of rows. The
+* full citation set is still forwarded to a composed `<lr-claim-evidence>` for claim-to-citation
+* lookup, which applies its own render cap on the claims it lists.
+*
 * @customElement lr-grounding-summary
 * @event lr-citation-select - An evidence citation badge was activated. `detail: { citation }`.
 * @event lr-claim-select - A composed claim-evidence row was activated. `detail: { claim }`.
@@ -41,6 +47,7 @@ import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';impo
 * @csspart evidence-span - A citation's formatted `span` range, shown next to its badge (omitted
 *   when `span` is unset).
 * @csspart evidence-list - The semantic list containing the evidence citations.
+* @csspart limit - Localized notice shown when `citations` exceeds the 500-citation render ceiling.
 * @csspart claims - Claim-level evidence, when present and enabled.
 * @csspart empty - The empty-state message, shown when `assessment` is `null`.
 * @status stable

package/dist/components/retrieval/grounding-summary/grounding-summary.class.js

@@ -1,4 +1,4 @@
-var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{finiteCount,finiteRange}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import"../../data/stat/stat.class.js";import"../citation-badge/citation-badge.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./grounding-summary.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import"../claim-evidence/claim-evidence.class.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_groundingSummaryConfidenceLabel,LYRA_DEFAULT_groundingSummaryCoverageLabel,LYRA_DEFAULT_groundingSummaryEmpty,LYRA_DEFAULT_groundingSummaryEvidenceHeading,LYRA_DEFAULT_groundingSummaryEvidenceSpan,LYRA_DEFAULT_groundingSummaryLabel,LYRA_DEFAULT_groundingSummarySupportedLabel,LYRA_DEFAULT_groundingSummaryUnsupportedLabel,LYRA_DEFAULT_groundingSummaryWarningsHeading,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const MAX_PROJECTED_GROUNDING_ROWS=1e4,EMPTY_CANONICAL_CLAIMS=Object.freeze([]),EMPTY_CANONICAL_CITATIONS=Object.freeze([]),EMPTY_WARNINGS=Object.freeze([]);function descriptorValue(value,property2){return getOwnDataDescriptor(value,property2)}function valueOfDescriptor(descriptor){return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function hasUnsafeDescriptor(descriptors){return descriptors.some(descriptor=>descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)}function nestedEventDetailValue(event,property2){const detail=event.detail;if(detail===null||typeof detail!="object")return;const descriptor=descriptorValue(detail,property2);return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function projectStringList(value){try{if(!Array.isArray(value))return;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return;const values=[],length=Math.min(lengthDescriptor.value,MAX_PROJECTED_GROUNDING_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)return;descriptor!==MISSING_OWN_DATA_DESCRIPTOR&&typeof descriptor.value=="string"&&values.push(descriptor.value)}return Object.freeze(values)}catch{return}}function projectRange(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const startDescriptor=descriptorValue(value,"start"),endDescriptor=descriptorValue(value,"end");if(hasUnsafeDescriptor([startDescriptor,endDescriptor]))return;const start=valueOfDescriptor(startDescriptor),end=valueOfDescriptor(endDescriptor);return typeof start!="number"||typeof end!="number"?void 0:Object.freeze({start,end})}catch{return}}function projectClaim(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),textDescriptor=descriptorValue(value,"text"),statusDescriptor=descriptorValue(value,"status"),citationIdsDescriptor=descriptorValue(value,"citationIds"),confidenceDescriptor=descriptorValue(value,"confidence"),explanationDescriptor=descriptorValue(value,"explanation");if(hasUnsafeDescriptor([idDescriptor,textDescriptor,statusDescriptor,citationIdsDescriptor,confidenceDescriptor,explanationDescriptor]))return;const id=valueOfDescriptor(idDescriptor),text=valueOfDescriptor(textDescriptor),citationIds=projectStringList(valueOfDescriptor(citationIdsDescriptor));if(typeof id!="string"||id.trim().length===0||typeof text!="string"||citationIds===void 0)return;const status=valueOfDescriptor(statusDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),explanation=valueOfDescriptor(explanationDescriptor),input=Object.freeze({id,text,status:typeof status=="string"?status:"unsupported",citationIds,...typeof confidence=="number"&&Number.isFinite(confidence)?{confidence}:{},...typeof explanation=="string"?{explanation}:{}});return Object.freeze({source:value,input,id})}catch{return}}function projectCitation(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),chunkIdDescriptor=descriptorValue(value,"chunkId"),sourceIdDescriptor=descriptorValue(value,"sourceId"),spanDescriptor=descriptorValue(value,"span"),labelDescriptor=descriptorValue(value,"label"),quoteDescriptor=descriptorValue(value,"quote");if(hasUnsafeDescriptor([idDescriptor,chunkIdDescriptor,sourceIdDescriptor,spanDescriptor,labelDescriptor,quoteDescriptor]))return;const id=valueOfDescriptor(idDescriptor);if(typeof id!="string"||id.trim().length===0)return;const chunkId=valueOfDescriptor(chunkIdDescriptor),sourceId=valueOfDescriptor(sourceIdDescriptor),spanValue=valueOfDescriptor(spanDescriptor),label=valueOfDescriptor(labelDescriptor),quote=valueOfDescriptor(quoteDescriptor),span=spanDescriptor===MISSING_OWN_DATA_DESCRIPTOR||spanValue===void 0?void 0:projectRange(spanValue);if(spanValue!==void 0&&span===void 0)return;const input=Object.freeze({id,...typeof chunkId=="string"?{chunkId}:{},...typeof sourceId=="string"?{sourceId}:{},...span===void 0?{}:{span},...typeof label=="string"?{label}:{},...typeof quote=="string"?{quote}:{}});return Object.freeze({source:value,input,id,...typeof sourceId=="string"?{sourceId}:{},...typeof label=="string"?{label}:{},...span===void 0?{}:{span}})}catch{return}}function projectRows(value,project,empty){try{if(!Array.isArray(value))return empty;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return empty;const rows=[],seen=new Set,length=Math.min(lengthDescriptor.value,MAX_PROJECTED_GROUNDING_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)continue;const row=project(descriptor.value);!row||seen.has(row.id)||(seen.add(row.id),rows.push(row))}return Object.freeze(rows)}catch{return empty}}function projectAssessment(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const supportedClaimsDescriptor=descriptorValue(value,"supportedClaims"),unsupportedClaimsDescriptor=descriptorValue(value,"unsupportedClaims"),coverageDescriptor=descriptorValue(value,"coverage"),confidenceDescriptor=descriptorValue(value,"confidence"),warningsDescriptor=descriptorValue(value,"warnings"),claimsDescriptor=descriptorValue(value,"claims");if(hasUnsafeDescriptor([supportedClaimsDescriptor,unsupportedClaimsDescriptor,coverageDescriptor,confidenceDescriptor,warningsDescriptor,claimsDescriptor]))return;const supportedClaims=valueOfDescriptor(supportedClaimsDescriptor),unsupportedClaims=valueOfDescriptor(unsupportedClaimsDescriptor),coverage=valueOfDescriptor(coverageDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),warningsValue=valueOfDescriptor(warningsDescriptor),claimsValue=valueOfDescriptor(claimsDescriptor),warnings=warningsDescriptor===MISSING_OWN_DATA_DESCRIPTOR||warningsValue===void 0?EMPTY_WARNINGS:projectStringList(warningsValue)??EMPTY_WARNINGS,claims=claimsDescriptor===MISSING_OWN_DATA_DESCRIPTOR||claimsValue===void 0?EMPTY_CANONICAL_CLAIMS:projectRows(claimsValue,projectClaim,EMPTY_CANONICAL_CLAIMS);return Object.freeze({supportedClaims:typeof supportedClaims=="number"?supportedClaims:0,unsupportedClaims:typeof unsupportedClaims=="number"?unsupportedClaims:0,coverage:typeof coverage=="number"?coverage:0,...typeof confidence=="number"?{confidence}:{},warnings,claims})}catch{return}}class LyraGroundingSummary extends LyraElement{constructor(){super(...arguments),this.assessment=null,this.citations=[],this.thresholds={high:.8,medium:.5},this.showClaims=!0,this.headingLevel="3",this.canonicalAssessmentBySource=new WeakMap,this.canonicalCitationsBySource=new WeakMap,this.renderEvidenceItem=(citation,index)=>{const numberFormat=getNumberFormat(this.effectiveLocale),spanText=citation.span?this.localize("groundingSummaryEvidenceSpan",void 0,{start:numberFormat.format(finiteCount(citation.span.start)),end:numberFormat.format(finiteCount(citation.span.end))}):"";return html`
+var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect=="object"&&typeof Reflect.decorate=="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)(d=decorators[i])&&(r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r);return c>3&&r&&Object.defineProperty(target,key,r),r};import{html,nothing}from"lit";import{property}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{getOwnDataDescriptor,MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR}from"../../../internal/data-descriptors.js";import{finiteCount,finiteRange}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{resolveHeadingLevel}from"../../../internal/heading-level.js";import"../../data/stat/stat.class.js";import"../citation-badge/citation-badge.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./grounding-summary.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import"../claim-evidence/claim-evidence.class.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_citation,LYRA_DEFAULT_collapse,LYRA_DEFAULT_details,LYRA_DEFAULT_groundingSummaryCitationsLimit,LYRA_DEFAULT_groundingSummaryConfidenceLabel,LYRA_DEFAULT_groundingSummaryCoverageLabel,LYRA_DEFAULT_groundingSummaryEmpty,LYRA_DEFAULT_groundingSummaryEvidenceHeading,LYRA_DEFAULT_groundingSummaryEvidenceSpan,LYRA_DEFAULT_groundingSummaryLabel,LYRA_DEFAULT_groundingSummarySupportedLabel,LYRA_DEFAULT_groundingSummaryUnsupportedLabel,LYRA_DEFAULT_groundingSummaryWarningsHeading,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_search,LYRA_DEFAULT_select}from"../../../internal/default-strings.generated.js";const MAX_PROJECTED_GROUNDING_ROWS=1e4,MAX_RENDERED_GROUNDING_CITATIONS=500,EMPTY_CANONICAL_CLAIMS=Object.freeze([]),EMPTY_CANONICAL_CITATIONS=Object.freeze([]),EMPTY_WARNINGS=Object.freeze([]);function descriptorValue(value,property2){return getOwnDataDescriptor(value,property2)}function valueOfDescriptor(descriptor){return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function hasUnsafeDescriptor(descriptors){return descriptors.some(descriptor=>descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)}function nestedEventDetailValue(event,property2){const detail=event.detail;if(detail===null||typeof detail!="object")return;const descriptor=descriptorValue(detail,property2);return descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR?void 0:descriptor.value}function projectStringList(value){try{if(!Array.isArray(value))return;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return;const values=[],length=Math.min(lengthDescriptor.value,MAX_PROJECTED_GROUNDING_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)return;descriptor!==MISSING_OWN_DATA_DESCRIPTOR&&typeof descriptor.value=="string"&&values.push(descriptor.value)}return Object.freeze(values)}catch{return}}function projectRange(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const startDescriptor=descriptorValue(value,"start"),endDescriptor=descriptorValue(value,"end");if(hasUnsafeDescriptor([startDescriptor,endDescriptor]))return;const start=valueOfDescriptor(startDescriptor),end=valueOfDescriptor(endDescriptor);return typeof start!="number"||typeof end!="number"?void 0:Object.freeze({start,end})}catch{return}}function projectClaim(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),textDescriptor=descriptorValue(value,"text"),statusDescriptor=descriptorValue(value,"status"),citationIdsDescriptor=descriptorValue(value,"citationIds"),confidenceDescriptor=descriptorValue(value,"confidence"),explanationDescriptor=descriptorValue(value,"explanation");if(hasUnsafeDescriptor([idDescriptor,textDescriptor,statusDescriptor,citationIdsDescriptor,confidenceDescriptor,explanationDescriptor]))return;const id=valueOfDescriptor(idDescriptor),text=valueOfDescriptor(textDescriptor),citationIds=projectStringList(valueOfDescriptor(citationIdsDescriptor));if(typeof id!="string"||id.trim().length===0||typeof text!="string"||citationIds===void 0)return;const status=valueOfDescriptor(statusDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),explanation=valueOfDescriptor(explanationDescriptor),input=Object.freeze({id,text,status:typeof status=="string"?status:"unsupported",citationIds,...typeof confidence=="number"&&Number.isFinite(confidence)?{confidence}:{},...typeof explanation=="string"?{explanation}:{}});return Object.freeze({source:value,input,id})}catch{return}}function projectCitation(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const idDescriptor=descriptorValue(value,"id"),chunkIdDescriptor=descriptorValue(value,"chunkId"),sourceIdDescriptor=descriptorValue(value,"sourceId"),spanDescriptor=descriptorValue(value,"span"),labelDescriptor=descriptorValue(value,"label"),quoteDescriptor=descriptorValue(value,"quote");if(hasUnsafeDescriptor([idDescriptor,chunkIdDescriptor,sourceIdDescriptor,spanDescriptor,labelDescriptor,quoteDescriptor]))return;const id=valueOfDescriptor(idDescriptor);if(typeof id!="string"||id.trim().length===0)return;const chunkId=valueOfDescriptor(chunkIdDescriptor),sourceId=valueOfDescriptor(sourceIdDescriptor),spanValue=valueOfDescriptor(spanDescriptor),label=valueOfDescriptor(labelDescriptor),quote=valueOfDescriptor(quoteDescriptor),span=spanDescriptor===MISSING_OWN_DATA_DESCRIPTOR||spanValue===void 0?void 0:projectRange(spanValue);if(spanValue!==void 0&&span===void 0)return;const input=Object.freeze({id,...typeof chunkId=="string"?{chunkId}:{},...typeof sourceId=="string"?{sourceId}:{},...span===void 0?{}:{span},...typeof label=="string"?{label}:{},...typeof quote=="string"?{quote}:{}});return Object.freeze({source:value,input,id,...typeof sourceId=="string"?{sourceId}:{},...typeof label=="string"?{label}:{},...span===void 0?{}:{span}})}catch{return}}function projectRows(value,project,empty){try{if(!Array.isArray(value))return empty;const lengthDescriptor=descriptorValue(value,"length");if(lengthDescriptor===MISSING_OWN_DATA_DESCRIPTOR||lengthDescriptor===UNSAFE_OWN_DATA_DESCRIPTOR||typeof lengthDescriptor.value!="number"||!Number.isSafeInteger(lengthDescriptor.value)||lengthDescriptor.value<0)return empty;const rows=[],seen=new Set,length=Math.min(lengthDescriptor.value,MAX_PROJECTED_GROUNDING_ROWS);for(let index=0;index<length;index+=1){const descriptor=descriptorValue(value,String(index));if(descriptor===MISSING_OWN_DATA_DESCRIPTOR||descriptor===UNSAFE_OWN_DATA_DESCRIPTOR)continue;const row=project(descriptor.value);!row||seen.has(row.id)||(seen.add(row.id),rows.push(row))}return Object.freeze(rows)}catch{return empty}}function projectAssessment(value){try{if(value===null||typeof value!="object"||Array.isArray(value))return;const supportedClaimsDescriptor=descriptorValue(value,"supportedClaims"),unsupportedClaimsDescriptor=descriptorValue(value,"unsupportedClaims"),coverageDescriptor=descriptorValue(value,"coverage"),confidenceDescriptor=descriptorValue(value,"confidence"),warningsDescriptor=descriptorValue(value,"warnings"),claimsDescriptor=descriptorValue(value,"claims");if(hasUnsafeDescriptor([supportedClaimsDescriptor,unsupportedClaimsDescriptor,coverageDescriptor,confidenceDescriptor,warningsDescriptor,claimsDescriptor]))return;const supportedClaims=valueOfDescriptor(supportedClaimsDescriptor),unsupportedClaims=valueOfDescriptor(unsupportedClaimsDescriptor),coverage=valueOfDescriptor(coverageDescriptor),confidence=valueOfDescriptor(confidenceDescriptor),warningsValue=valueOfDescriptor(warningsDescriptor),claimsValue=valueOfDescriptor(claimsDescriptor),warnings=warningsDescriptor===MISSING_OWN_DATA_DESCRIPTOR||warningsValue===void 0?EMPTY_WARNINGS:projectStringList(warningsValue)??EMPTY_WARNINGS,claims=claimsDescriptor===MISSING_OWN_DATA_DESCRIPTOR||claimsValue===void 0?EMPTY_CANONICAL_CLAIMS:projectRows(claimsValue,projectClaim,EMPTY_CANONICAL_CLAIMS);return Object.freeze({supportedClaims:typeof supportedClaims=="number"?supportedClaims:0,unsupportedClaims:typeof unsupportedClaims=="number"?unsupportedClaims:0,coverage:typeof coverage=="number"?coverage:0,...typeof confidence=="number"?{confidence}:{},warnings,claims})}catch{return}}class LyraGroundingSummary extends LyraElement{constructor(){super(...arguments),this.assessment=null,this.citations=[],this.thresholds={high:.8,medium:.5},this.showClaims=!0,this.headingLevel="3",this.canonicalAssessmentBySource=new WeakMap,this.canonicalCitationsBySource=new WeakMap,this.renderEvidenceItem=(citation,index)=>{const numberFormat=getNumberFormat(this.effectiveLocale),spanText=citation.span?this.localize("groundingSummaryEvidenceSpan",void 0,{start:numberFormat.format(finiteCount(citation.span.start)),end:numberFormat.format(finiteCount(citation.span.end))}):"";return html`
       <li part="evidence-item">
         <lr-citation-badge
           index=${index+1}
@@ -11,7 +11,7 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
         ${citation.label?html`<span part="evidence-label">${citation.label}</span>`:nothing}
         ${spanText?html`<span part="evidence-span">${spanText}</span>`:nothing}
       </li>
-    `}}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,groundingSummaryConfidenceLabel:LYRA_DEFAULT_groundingSummaryConfidenceLabel,groundingSummaryCoverageLabel:LYRA_DEFAULT_groundingSummaryCoverageLabel,groundingSummaryEmpty:LYRA_DEFAULT_groundingSummaryEmpty,groundingSummaryEvidenceHeading:LYRA_DEFAULT_groundingSummaryEvidenceHeading,groundingSummaryEvidenceSpan:LYRA_DEFAULT_groundingSummaryEvidenceSpan,groundingSummaryLabel:LYRA_DEFAULT_groundingSummaryLabel,groundingSummarySupportedLabel:LYRA_DEFAULT_groundingSummarySupportedLabel,groundingSummaryUnsupportedLabel:LYRA_DEFAULT_groundingSummaryUnsupportedLabel,groundingSummaryWarningsHeading:LYRA_DEFAULT_groundingSummaryWarningsHeading,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["assessment","citations"])}static{this.identityCollectionObjectProperties=Object.freeze(["assessment"])}static{this.identityCollectionProperties=Object.freeze(["citations"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-citation-select","lr-claim-select"])}static{this.identityEventDetailProperties=Object.freeze({"lr-citation-select":Object.freeze(["citation"]),"lr-claim-select":Object.freeze(["claim"])})}get normalizedAssessment(){const source=this.assessment;if(source===null||typeof source!="object")return;const cached=this.canonicalAssessmentBySource.get(source);if(cached!==void 0)return cached??void 0;const assessment=projectAssessment(source);return this.canonicalAssessmentBySource.set(source,assessment??null),assessment}get normalizedCitations(){const source=this.citations;if(source===null||typeof source!="object")return EMPTY_CANONICAL_CITATIONS;const cached=this.canonicalCitationsBySource.get(source);if(cached)return cached;const citations=projectRows(source,projectCitation,EMPTY_CANONICAL_CITATIONS);return this.canonicalCitationsBySource.set(source,citations),citations}sectionHeading(part,text){switch(resolveHeadingLevel(this.headingLevel)){case"1":return html`<h1 part=${part}>${text}</h1>`;case"2":return html`<h2 part=${part}>${text}</h2>`;case"4":return html`<h4 part=${part}>${text}</h4>`;case"5":return html`<h5 part=${part}>${text}</h5>`;case"6":return html`<h6 part=${part}>${text}</h6>`;case"3":return html`<h3 part=${part}>${text}</h3>`;default:return html`<span part=${part}>${text}</span>`}}tone(value){return value>=this.thresholds.high?"success":value>=this.thresholds.medium?"warning":"danger"}formatPercent(value){return getNumberFormat(this.effectiveLocale,{style:"percent"}).format(finiteRange(value,0,0,1))}onCitationSelect(citation,event){event.stopPropagation(),this.emit("lr-citation-select",{citation:citation.source})}onNestedCitationSelect(citations,event){event.stopPropagation();const selected=nestedEventDetailValue(event,"citation"),citation=citations.find(candidate=>candidate.input===selected);citation&&this.emit("lr-citation-select",{citation:citation.source})}onNestedClaimSelect(claims,event){event.stopPropagation();const selected=nestedEventDetailValue(event,"claim"),claim=claims.find(candidate=>candidate.input===selected);claim&&this.emit("lr-claim-select",{claim:claim.source})}render(){const groupLabel=retrievalSemanticLabel(this,this.label==null?this.localize("groundingSummaryLabel"):this.label),groupRole=retrievalSemanticRole(this,"group"),a=this.normalizedAssessment;if(!a)return html`<div
+    `}}static{this.defaultStrings={...super.defaultStrings,citation:LYRA_DEFAULT_citation,collapse:LYRA_DEFAULT_collapse,details:LYRA_DEFAULT_details,groundingSummaryCitationsLimit:LYRA_DEFAULT_groundingSummaryCitationsLimit,groundingSummaryConfidenceLabel:LYRA_DEFAULT_groundingSummaryConfidenceLabel,groundingSummaryCoverageLabel:LYRA_DEFAULT_groundingSummaryCoverageLabel,groundingSummaryEmpty:LYRA_DEFAULT_groundingSummaryEmpty,groundingSummaryEvidenceHeading:LYRA_DEFAULT_groundingSummaryEvidenceHeading,groundingSummaryEvidenceSpan:LYRA_DEFAULT_groundingSummaryEvidenceSpan,groundingSummaryLabel:LYRA_DEFAULT_groundingSummaryLabel,groundingSummarySupportedLabel:LYRA_DEFAULT_groundingSummarySupportedLabel,groundingSummaryUnsupportedLabel:LYRA_DEFAULT_groundingSummaryUnsupportedLabel,groundingSummaryWarningsHeading:LYRA_DEFAULT_groundingSummaryWarningsHeading,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select}}static{this.ownedCollectionProperties=Object.freeze(["assessment","citations"])}static{this.identityCollectionObjectProperties=Object.freeze(["assessment"])}static{this.identityCollectionProperties=Object.freeze(["citations"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-citation-select","lr-claim-select"])}static{this.identityEventDetailProperties=Object.freeze({"lr-citation-select":Object.freeze(["citation"]),"lr-claim-select":Object.freeze(["claim"])})}get normalizedAssessment(){const source=this.assessment;if(source===null||typeof source!="object")return;const cached=this.canonicalAssessmentBySource.get(source);if(cached!==void 0)return cached??void 0;const assessment=projectAssessment(source);return this.canonicalAssessmentBySource.set(source,assessment??null),assessment}get normalizedCitations(){const source=this.citations;if(source===null||typeof source!="object")return EMPTY_CANONICAL_CITATIONS;const cached=this.canonicalCitationsBySource.get(source);if(cached)return cached;const citations=projectRows(source,projectCitation,EMPTY_CANONICAL_CITATIONS);return this.canonicalCitationsBySource.set(source,citations),citations}sectionHeading(part,text){switch(resolveHeadingLevel(this.headingLevel)){case"1":return html`<h1 part=${part}>${text}</h1>`;case"2":return html`<h2 part=${part}>${text}</h2>`;case"4":return html`<h4 part=${part}>${text}</h4>`;case"5":return html`<h5 part=${part}>${text}</h5>`;case"6":return html`<h6 part=${part}>${text}</h6>`;case"3":return html`<h3 part=${part}>${text}</h3>`;default:return html`<span part=${part}>${text}</span>`}}tone(value){return value>=this.thresholds.high?"success":value>=this.thresholds.medium?"warning":"danger"}formatPercent(value){return getNumberFormat(this.effectiveLocale,{style:"percent"}).format(finiteRange(value,0,0,1))}onCitationSelect(citation,event){event.stopPropagation(),this.emit("lr-citation-select",{citation:citation.source})}onNestedCitationSelect(citations,event){event.stopPropagation();const selected=nestedEventDetailValue(event,"citation"),citation=citations.find(candidate=>candidate.input===selected);citation&&this.emit("lr-citation-select",{citation:citation.source})}onNestedClaimSelect(claims,event){event.stopPropagation();const selected=nestedEventDetailValue(event,"claim"),claim=claims.find(candidate=>candidate.input===selected);claim&&this.emit("lr-claim-select",{claim:claim.source})}render(){const groupLabel=retrievalSemanticLabel(this,this.label==null?this.localize("groundingSummaryLabel"):this.label),groupRole=retrievalSemanticRole(this,"group"),a=this.normalizedAssessment;if(!a)return html`<div
         part="base"
         role=${groupRole??nothing}
         aria-label=${groupLabel??nothing}
@@ -75,8 +75,9 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
                   >${numberFormat.format(citations.length)}</span
                 >
                 <ul part="evidence-list" role="list">
-                  ${citations.map((citation,index)=>this.renderEvidenceItem(citation,index))}
+                  ${citations.slice(0,MAX_RENDERED_GROUNDING_CITATIONS).map((citation,index)=>this.renderEvidenceItem(citation,index))}
                 </ul>
+                ${citations.length>MAX_RENDERED_GROUNDING_CITATIONS?html`<p part="limit" role="note">${this.localize("groundingSummaryCitationsLimit",void 0,{count:numberFormat.format(MAX_RENDERED_GROUNDING_CITATIONS)})}</p>`:nothing}
               </div>
             `:nothing}
       </div>

package/dist/components/retrieval/grounding-summary/grounding-summary.styles.js

@@ -1 +1 @@
-import{css}from"lit";const styles=css`:host{inline-size:100%;min-inline-size:0;display:block}[part=base]{gap:var(--lr-space-m);flex-direction:column;display:flex}[part=stats]{gap:var(--lr-space-m);flex-wrap:wrap;display:flex}[part=stats]>lr-stat{flex:1 1 var(--lr-size-10rem);min-inline-size:0}[part=warnings]{gap:var(--lr-space-xs);padding:var(--lr-space-s) var(--lr-space-m);border-inline-start:var(--lr-border-width-thick) solid var(--lr-color-warning);border-radius:var(--lr-radius);background:var(--lr-color-warning-quiet);flex-direction:column;display:flex}[part=warnings-heading]{font-weight:var(--lr-font-weight-semibold);color:var(--lr-color-text);margin:0}[part=warnings-count]{color:var(--lr-color-text-quiet);font-weight:var(--lr-font-weight-medium);margin-inline-start:var(--lr-space-xs)}[part=warnings-list]{gap:var(--lr-space-xs);flex-direction:column;margin:0;padding-inline-start:var(--lr-space-l);display:flex}[part=warning]{font-size:var(--lr-font-size-sm);color:var(--lr-color-text)}[part=evidence]{gap:var(--lr-space-s);flex-direction:column;display:flex}[part=evidence-heading]{font-size:var(--lr-font-size-xs);font-weight:var(--lr-font-weight-semibold);text-transform:uppercase;letter-spacing:var(--lr-size-0-04em);color:var(--lr-color-text-quiet);margin:0}[part=evidence-count]{font-size:var(--lr-font-size-xs);color:var(--lr-color-text-quiet);margin-inline-start:var(--lr-space-xs)}[part=evidence-list]{margin:0;padding:0;list-style:none;display:block}[part=evidence-item]{align-items:baseline;gap:var(--lr-space-xs);padding-block:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=evidence-item]+[part=evidence-item]{border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border)}[part=evidence-label]{font-size:var(--lr-font-size-sm);color:var(--lr-color-text)}[part=evidence-span]{font-size:var(--lr-font-size-sm);font-family:var(--lr-font-mono);color:var(--lr-color-text-quiet)}`;export{styles};
+import{css}from"lit";const styles=css`:host{inline-size:100%;min-inline-size:0;display:block}[part=base]{gap:var(--lr-space-m);flex-direction:column;display:flex}[part=stats]{gap:var(--lr-space-m);flex-wrap:wrap;display:flex}[part=stats]>lr-stat{flex:1 1 var(--lr-size-10rem);min-inline-size:0}[part=warnings]{gap:var(--lr-space-xs);padding:var(--lr-space-s) var(--lr-space-m);border-inline-start:var(--lr-border-width-thick) solid var(--lr-color-warning);border-radius:var(--lr-radius);background:var(--lr-color-warning-quiet);flex-direction:column;display:flex}[part=warnings-heading]{font-weight:var(--lr-font-weight-semibold);color:var(--lr-color-text);margin:0}[part=warnings-count]{color:var(--lr-color-text-quiet);font-weight:var(--lr-font-weight-medium);margin-inline-start:var(--lr-space-xs)}[part=warnings-list]{gap:var(--lr-space-xs);flex-direction:column;margin:0;padding-inline-start:var(--lr-space-l);display:flex}[part=warning]{font-size:var(--lr-font-size-sm);color:var(--lr-color-text)}[part=evidence]{gap:var(--lr-space-s);flex-direction:column;display:flex}[part=evidence-heading]{font-size:var(--lr-font-size-xs);font-weight:var(--lr-font-weight-semibold);text-transform:uppercase;letter-spacing:var(--lr-size-0-04em);color:var(--lr-color-text-quiet);margin:0}[part=evidence-count]{font-size:var(--lr-font-size-xs);color:var(--lr-color-text-quiet);margin-inline-start:var(--lr-space-xs)}[part=evidence-list]{margin:0;padding:0;list-style:none;display:block}[part=evidence-item]{align-items:baseline;gap:var(--lr-space-xs);padding-block:var(--lr-space-xs);flex-wrap:wrap;display:flex}[part=evidence-item]+[part=evidence-item]{border-block-start:var(--lr-border-width-thin) solid var(--lr-color-border)}[part=evidence-label]{font-size:var(--lr-font-size-sm);color:var(--lr-color-text)}[part=evidence-span]{font-size:var(--lr-font-size-sm);font-family:var(--lr-font-mono);color:var(--lr-color-text-quiet)}[part=limit]{margin:var(--lr-space-s);color:var(--lr-color-text-quiet);font-size:var(--lr-font-size-xs)}`;export{styles};

package/dist/components/retrieval/memory-panel/memory-panel.class.d.ts

@@ -59,6 +59,10 @@ provenance?:LyraProvenance;}type MemoryScope='short-term'|'long-term';export int
 * rendering, counts, focus recovery, confirmation state, or actions. The first item for an id
 * wins in that scope.
 *
+* At most 500 items per section render as `[part="item"]` rows; a section's list past that length
+* renders a localized `[part="limit"]` notice after that section's list rather than mounting an
+* unbounded number of rows.
+*
 * @customElement lr-memory-panel
 * @event lr-add - A pending "add to long-term memory" action was approved. `detail: { memory }` --
 * the short-term item as-is; the host decides how/whether to persist it.
@@ -73,6 +77,8 @@ provenance?:LyraProvenance;}type MemoryScope='short-term'|'long-term';export int
 * @csspart heading - A section's visible heading text.
 * @csspart section-empty - A section's "no items" text, shown when that section's own list is empty.
 * @csspart list - A section's `role="list"` wrapper, omitted while that section is empty.
+* @csspart limit - Localized notice shown when a section's items exceed the 500-item render
+* ceiling.
 * @csspart item - One memory item row (`role="listitem"`); carries `data-id`/`data-scope` and a
 * stable `tabindex="-1"` so focus has somewhere to land after a pending confirmation on this row
 * resolves.