@aceshooting/lyra-ui 9.1.1 → 10.0.1

package/dist/components/retrieval/knowledge-graph-explorer/knowledge-graph-explorer.styles.js

@@ -2,13 +2,6 @@ import{css}from"lit";const styles=css`
   :host {
     display: block;
   }
-  /* An explicit height on the host has to actually bound the rendered explorer. Without this chain
-     the column only ever sized itself from its content -- chiefly the composed graph's own
-     intrinsic svg/canvas aspect ratio -- so a host height either left a dead gap below the graph or
-     was overflowed by it. The same block-size: 100% propagation lr-multi-split and lr-widget use.
-     min-block-size: 0 lets the graph below shrink past its intrinsic size instead of forcing the
-     column taller than its allocation; with no height on the host both percentages resolve to auto
-     and the content-sized behaviour is unchanged. */
   [part='base'] {
     display: flex;
     flex-direction: column;
@@ -81,21 +74,12 @@ import{css}from"lit";const styles=css`
     color: var(--lr-color-text-quiet);
     font-size: var(--lr-font-size-sm);
   }
-  /* Type filters are a consumer-data-driven list (nodeTypes) with no library-imposed size limit --
-     without a cap it floors at its full content height (browser-default flex-item min-height:
-     auto) and starves 100% of the shrinkage onto [part='graph'] below, even though that part is
-     explicitly set up to be the one that shrinks. Same max-block-size + overflow-y pattern as
-     [part='search-results'] above. */
   [part='legend'] {
     flex: 0 1 auto;
     max-block-size: var(--lr-size-12rem);
     overflow-y: auto;
     overflow-x: clip;
   }
-  /* The one flexible row: it takes whatever the toolbar, search results, pinned row and path strip
-     leave over. flex-basis stays auto so an unsized host still gets the graph's intrinsic height,
-     while min-block-size: 0 removes the automatic content-based flex minimum that would otherwise
-     stop it shrinking into a shorter allocation. */
   [part='graph'] {
     display: block;
     inline-size: 100%;

package/dist/components/retrieval/mind-map/mind-map.class.d.ts

@@ -89,9 +89,11 @@ export declare class LyraMindMap extends LyraElement<LyraMindMapEventMap> {
     private get effectiveExpandDepth();
     private isExpanded;
     /** Resolves `--lr-mind-map-ring-gap` to a real used pixel value for whatever unit it carries --
-     *  a live root/host font-size read for rem/em, matching `lr-table`'s own `minimumResizeWidth()`
-     *  fix for the identical problem (a hardcoded `* 16` gets ring spacing wrong on any page whose
-     *  root font-size isn't the browser default 16px). */
+     *  a live root/host font-size read for rem/em (a hardcoded `* 16` gets ring spacing wrong on any
+     *  page whose root font-size isn't the browser default 16px), delegated to the shared
+     *  `resolveCssLength()` so every unit-resolving component agrees on what a length means. A value
+     *  in a unit that cannot be resolved to a used pixel length here (`ch`, `pt`, `calc()`, a bare
+     *  `%` with no base) falls back to the default gap rather than being read as raw pixels. */
     private ringGapPx;
     private relayout;
     protected willUpdate(changed: PropertyValues): void;

package/dist/components/retrieval/mind-map/mind-map.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,svg}from"lit";import{property,state,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{srOnly}from"../../../internal/a11y.js";import{isRtl}from"../../../internal/rtl.js";import{finiteCount}from"../../../internal/numbers.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{layoutMindMap}from"./mind-map-layout.js";import{styles}from"./mind-map.styles.js";import{LYRA_DEFAULT_mindMapCollapsed,LYRA_DEFAULT_mindMapExpanded,LYRA_DEFAULT_mindMapLabel,LYRA_DEFAULT_mindMapLeafStatus,LYRA_DEFAULT_mindMapTopicStatus,LYRA_DEFAULT_noData}from"../../../internal/default-strings.generated.js";const DEFAULT_RING_GAP_PX=96,NAV_KEYS=new Set(["ArrowUp","ArrowDown","ArrowLeft","ArrowRight","Home","End","Enter"," "]);class LyraMindMap extends LyraElement{constructor(){super(...arguments),this.topics=[],this.expandDepth=1,this.expandedOverrides=new Map,this.focusedId=null,this.liveText="",this.cachedLayout={placed:[],links:[],width:0,height:0,centerX:0,centerY:0},this.ownerRealmGeneration=0,this.observedSize="",this.layoutInvalidated=!0,this.layoutContext="",this.onKeyDown=e=>{const placed=this.cachedLayout.placed;if(placed.length===0||!NAV_KEYS.has(e.key))return;if(e.preventDefault(),this.focusedId===null){this.focusNodeById(placed[0].id);return}const current=placed.find(p=>p.id===this.focusedId);if(!current)return;if(e.key==="Enter"||e.key===" "){this.activate(current);return}if(e.key==="ArrowUp"){current.parentId&&this.focusNodeById(current.parentId);return}if(e.key==="ArrowDown"){if(!current.hasChildren)return;this.isExpanded(current.id,current.depth)||this.toggle(current,!1);const child=this.childrenOf(current.id)[0];child&&this.focusNodeById(child.id);return}const rtl=isRtl(this),forwardKey=rtl?"ArrowLeft":"ArrowRight",backwardKey=rtl?"ArrowRight":"ArrowLeft";if(e.key===forwardKey||e.key===backwardKey||e.key==="Home"||e.key==="End"){const siblings=this.siblingsOf(current),index=siblings.findIndex(s=>s.id===current.id);let next=index;e.key===forwardKey?next=Math.min(siblings.length-1,index+1):e.key===backwardKey?next=Math.max(0,index-1):e.key==="Home"?next=0:next=siblings.length-1;const target=siblings[next];target&&this.focusNodeById(target.id)}},this.onFocusIn=()=>{if(this.focusedId!==null)return;const first=this.cachedLayout.placed[0];first&&(this.focusedId=first.id)}}static{this.defaultStrings={...super.defaultStrings,mindMapCollapsed:LYRA_DEFAULT_mindMapCollapsed,mindMapExpanded:LYRA_DEFAULT_mindMapExpanded,mindMapLabel:LYRA_DEFAULT_mindMapLabel,mindMapLeafStatus:LYRA_DEFAULT_mindMapLeafStatus,mindMapTopicStatus:LYRA_DEFAULT_mindMapTopicStatus,noData:LYRA_DEFAULT_noData}}static{this.ownedCollectionProperties=Object.freeze(["topics"])}static{this.styles=[LyraElement.styles,styles,srOnly]}static get observedAttributes(){return[...new Set([...super.observedAttributes,"dir","lang"])]}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this}),this.layoutInvalidated=!0,this.armResizeObserver()}armResizeObserver(){const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!this.isConnected||!ownerWindow?.ResizeObserver||this.resizeObserver&&this.resizeObserverDocument===ownerDocument)return;this.resetResizeWork();const generation=this.ownerRealmGeneration,observer=new ownerWindow.ResizeObserver(entries=>{if(this.resizeObserver!==observer||this.resizeObserverDocument!==ownerDocument||this.ownerRealmGeneration!==generation||!this.isConnected||this.ownerDocument!==ownerDocument)return;const rect=entries[0]?.contentRect,size=rect?`${rect.width}:${rect.height}`:"";if(size&&size===this.observedSize)return;this.observedSize=size,this.resizeRafId!=null&&this.resizeRafOwner?.cancelAnimationFrame(this.resizeRafId);const handle=ownerWindow.requestAnimationFrame(()=>{this.resizeRafId!==handle||this.resizeRafOwner!==ownerWindow||this.resizeRafDocument!==ownerDocument||this.ownerRealmGeneration!==generation||!this.isConnected||this.ownerDocument!==ownerDocument||(this.resizeRafId=void 0,this.resizeRafOwner=void 0,this.resizeRafDocument=void 0,this.layoutInvalidated=!0,this.requestUpdate())});this.resizeRafId=handle,this.resizeRafOwner=ownerWindow,this.resizeRafDocument=ownerDocument});this.resizeObserver=observer,this.resizeObserverDocument=ownerDocument,observer.observe(this)}disconnectedCallback(){this.resetResizeWork(),this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.resetResizeWork(),this.announcementSink?.release(),this.announcementSink=void 0}resetResizeWork(){this.ownerRealmGeneration+=1,this.resizeRafId!=null&&this.resizeRafOwner?.cancelAnimationFrame(this.resizeRafId),this.resizeRafId=void 0,this.resizeRafOwner=void 0,this.resizeRafDocument=void 0,this.resizeObserver?.disconnect(),this.resizeObserver=void 0,this.resizeObserverDocument=void 0,this.observedSize=""}attributeChangedCallback(name,oldValue,value){super.attributeChangedCallback(name,oldValue,value),(name==="dir"||name==="lang")&&oldValue!==value&&(this.layoutInvalidated=!0,this.requestUpdate())}get effectiveExpandDepth(){return finiteCount(this.expandDepth,1)}isExpanded(id,depth){return this.expandedOverrides.get(id)??depth<this.effectiveExpandDepth}ringGapPx(){const ownerWindow=this.ownerDocument.defaultView,hostStyle=ownerWindow?.getComputedStyle(this)??this.style,raw=hostStyle.getPropertyValue("--lr-mind-map-ring-gap").trim()||hostStyle.getPropertyValue("--_lr-mind-map-ring-gap").trim();if(!raw)return DEFAULT_RING_GAP_PX;const value=parseFloat(raw);if(!Number.isFinite(value))return DEFAULT_RING_GAP_PX;if(raw.endsWith("rem")){const rootStyle=ownerWindow?.getComputedStyle(this.ownerDocument.documentElement)??this.ownerDocument.documentElement.style,rootFontSize=Number.parseFloat(rootStyle.fontSize);return Number.isFinite(rootFontSize)?value*rootFontSize:DEFAULT_RING_GAP_PX}if(raw.endsWith("em")){const hostFontSize=Number.parseFloat(hostStyle.fontSize);return Number.isFinite(hostFontSize)?value*hostFontSize:DEFAULT_RING_GAP_PX}return value}relayout(){const hubLabel=this.label==null?this.localize("mindMapLabel"):this.label;this.cachedLayout=layoutMindMap(this.topics,hubLabel,{ringGap:this.ringGapPx(),rtl:isRtl(this),isExpanded:(id,depth)=>this.isExpanded(id,depth)})}willUpdate(changed){super.willUpdate(changed);const context=`${this.label==null?this.localize("mindMapLabel"):this.label}\0${isRtl(this)?"rtl":"ltr"}\0${this.ringGapPx()}`,structuralChange=changed.has("topics")||changed.has("expandDepth")||changed.has("expandedOverrides")||changed.has("label")||changed.has("strings")||changed.has("locale");(this.layoutInvalidated||structuralChange||context!==this.layoutContext)&&(this.relayout(),this.layoutContext=context,this.layoutInvalidated=!1,this.focusedId&&!this.cachedLayout.placed.some(topic=>topic.id===this.focusedId)&&(this.focusedId=this.cachedLayout.placed[0]?.id??null))}setAnnouncement(text){this.liveText=text,this.announcementSink?.announce(text)}toggle(node,announce=!0){const expanded=!this.isExpanded(node.id,node.depth),next=new Map(this.expandedOverrides);next.set(node.id,expanded),this.expandedOverrides=next,this.emit("lr-topic-toggle",{topicId:node.id,expanded}),announce&&this.setAnnouncement(this.localize(expanded?"mindMapExpanded":"mindMapCollapsed",void 0,{label:node.label}))}activate(node){node.hasChildren?this.toggle(node):this.emit("lr-topic-select",{topicId:node.id})}siblingsOf(node){return this.cachedLayout.placed.filter(p=>p.parentId===node.parentId)}childrenOf(id){return this.cachedLayout.placed.filter(p=>p.parentId===id)}announce(node){const numberFormat=getNumberFormat(this.effectiveLocale);this.setAnnouncement(node.hasChildren?this.localize("mindMapTopicStatus",void 0,{label:node.label,level:numberFormat.format(node.depth+1),count:numberFormat.format(this.childrenOf(node.id).length)}):this.localize("mindMapLeafStatus",void 0,{label:node.label,level:numberFormat.format(node.depth+1)}))}focusNodeById(id){this.focusedId=id;const node=this.cachedLayout.placed.find(p=>p.id===id);node&&this.announce(node)}onNodeClick(node){this.focusedId=node.id,this.svgEl?.focus(),node.hasChildren||this.announce(node),this.activate(node)}connectorControlPoint(from,to){const layout=this.cachedLayout,parentR=Math.hypot(from.x-layout.centerX,from.y-layout.centerY),dir=isRtl(this)?-1:1;return{x:layout.centerX+dir*parentR*Math.sin(to.angle),y:layout.centerY-parentR*Math.cos(to.angle)}}renderSemanticNode(node,childrenByParent){const children=childrenByParent.get(node.id)??[];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,query}from"lit/decorators.js";import{LyraElement}from"../../../internal/lyra-element.js";import{srOnly}from"../../../internal/a11y.js";import{isRtl}from"../../../internal/rtl.js";import{finiteCount}from"../../../internal/numbers.js";import{resolveCssLength}from"../../../internal/css-length.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{layoutMindMap}from"./mind-map-layout.js";import{styles}from"./mind-map.styles.js";import{LYRA_DEFAULT_mindMapCollapsed,LYRA_DEFAULT_mindMapExpanded,LYRA_DEFAULT_mindMapLabel,LYRA_DEFAULT_mindMapLeafStatus,LYRA_DEFAULT_mindMapTopicStatus,LYRA_DEFAULT_noData}from"../../../internal/default-strings.generated.js";const DEFAULT_RING_GAP_PX=96,NAV_KEYS=new Set(["ArrowUp","ArrowDown","ArrowLeft","ArrowRight","Home","End","Enter"," "]);class LyraMindMap extends LyraElement{constructor(){super(...arguments),this.topics=[],this.expandDepth=1,this.expandedOverrides=new Map,this.focusedId=null,this.liveText="",this.cachedLayout={placed:[],links:[],width:0,height:0,centerX:0,centerY:0},this.ownerRealmGeneration=0,this.observedSize="",this.layoutInvalidated=!0,this.layoutContext="",this.onKeyDown=e=>{const placed=this.cachedLayout.placed;if(placed.length===0||!NAV_KEYS.has(e.key))return;if(e.preventDefault(),this.focusedId===null){this.focusNodeById(placed[0].id);return}const current=placed.find(p=>p.id===this.focusedId);if(!current)return;if(e.key==="Enter"||e.key===" "){this.activate(current);return}if(e.key==="ArrowUp"){current.parentId&&this.focusNodeById(current.parentId);return}if(e.key==="ArrowDown"){if(!current.hasChildren)return;this.isExpanded(current.id,current.depth)||this.toggle(current,!1);const child=this.childrenOf(current.id)[0];child&&this.focusNodeById(child.id);return}const rtl=isRtl(this),forwardKey=rtl?"ArrowLeft":"ArrowRight",backwardKey=rtl?"ArrowRight":"ArrowLeft";if(e.key===forwardKey||e.key===backwardKey||e.key==="Home"||e.key==="End"){const siblings=this.siblingsOf(current),index=siblings.findIndex(s=>s.id===current.id);let next=index;e.key===forwardKey?next=Math.min(siblings.length-1,index+1):e.key===backwardKey?next=Math.max(0,index-1):e.key==="Home"?next=0:next=siblings.length-1;const target=siblings[next];target&&this.focusNodeById(target.id)}},this.onFocusIn=()=>{if(this.focusedId!==null)return;const first=this.cachedLayout.placed[0];first&&(this.focusedId=first.id)}}static{this.defaultStrings={...super.defaultStrings,mindMapCollapsed:LYRA_DEFAULT_mindMapCollapsed,mindMapExpanded:LYRA_DEFAULT_mindMapExpanded,mindMapLabel:LYRA_DEFAULT_mindMapLabel,mindMapLeafStatus:LYRA_DEFAULT_mindMapLeafStatus,mindMapTopicStatus:LYRA_DEFAULT_mindMapTopicStatus,noData:LYRA_DEFAULT_noData}}static{this.ownedCollectionProperties=Object.freeze(["topics"])}static{this.styles=[LyraElement.styles,styles,srOnly]}static get observedAttributes(){return[...new Set([...super.observedAttributes,"dir","lang"])]}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this}),this.layoutInvalidated=!0,this.armResizeObserver()}armResizeObserver(){const ownerDocument=this.ownerDocument,ownerWindow=ownerDocument.defaultView;if(!this.isConnected||!ownerWindow?.ResizeObserver||this.resizeObserver&&this.resizeObserverDocument===ownerDocument)return;this.resetResizeWork();const generation=this.ownerRealmGeneration,observer=new ownerWindow.ResizeObserver(entries=>{if(this.resizeObserver!==observer||this.resizeObserverDocument!==ownerDocument||this.ownerRealmGeneration!==generation||!this.isConnected||this.ownerDocument!==ownerDocument)return;const rect=entries[0]?.contentRect,size=rect?`${rect.width}:${rect.height}`:"";if(size&&size===this.observedSize)return;this.observedSize=size,this.resizeRafId!=null&&this.resizeRafOwner?.cancelAnimationFrame(this.resizeRafId);const handle=ownerWindow.requestAnimationFrame(()=>{this.resizeRafId!==handle||this.resizeRafOwner!==ownerWindow||this.resizeRafDocument!==ownerDocument||this.ownerRealmGeneration!==generation||!this.isConnected||this.ownerDocument!==ownerDocument||(this.resizeRafId=void 0,this.resizeRafOwner=void 0,this.resizeRafDocument=void 0,this.layoutInvalidated=!0,this.requestUpdate())});this.resizeRafId=handle,this.resizeRafOwner=ownerWindow,this.resizeRafDocument=ownerDocument});this.resizeObserver=observer,this.resizeObserverDocument=ownerDocument,observer.observe(this)}disconnectedCallback(){this.resetResizeWork(),this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}adoptedCallback(){super.adoptedCallback(),this.resetResizeWork(),this.announcementSink?.release(),this.announcementSink=void 0}resetResizeWork(){this.ownerRealmGeneration+=1,this.resizeRafId!=null&&this.resizeRafOwner?.cancelAnimationFrame(this.resizeRafId),this.resizeRafId=void 0,this.resizeRafOwner=void 0,this.resizeRafDocument=void 0,this.resizeObserver?.disconnect(),this.resizeObserver=void 0,this.resizeObserverDocument=void 0,this.observedSize=""}attributeChangedCallback(name,oldValue,value){super.attributeChangedCallback(name,oldValue,value),(name==="dir"||name==="lang")&&oldValue!==value&&(this.layoutInvalidated=!0,this.requestUpdate())}get effectiveExpandDepth(){return finiteCount(this.expandDepth,1)}isExpanded(id,depth){return this.expandedOverrides.get(id)??depth<this.effectiveExpandDepth}ringGapPx(){const hostStyle=this.ownerDocument.defaultView?.getComputedStyle(this)??this.style,raw=hostStyle.getPropertyValue("--lr-mind-map-ring-gap").trim()||hostStyle.getPropertyValue("--_lr-mind-map-ring-gap").trim();return resolveCssLength(raw,{host:this})??DEFAULT_RING_GAP_PX}relayout(){const hubLabel=this.label==null?this.localize("mindMapLabel"):this.label;this.cachedLayout=layoutMindMap(this.topics,hubLabel,{ringGap:this.ringGapPx(),rtl:isRtl(this),isExpanded:(id,depth)=>this.isExpanded(id,depth)})}willUpdate(changed){super.willUpdate(changed);const context=`${this.label==null?this.localize("mindMapLabel"):this.label}\0${isRtl(this)?"rtl":"ltr"}\0${this.ringGapPx()}`,structuralChange=changed.has("topics")||changed.has("expandDepth")||changed.has("expandedOverrides")||changed.has("label")||changed.has("strings")||changed.has("locale");(this.layoutInvalidated||structuralChange||context!==this.layoutContext)&&(this.relayout(),this.layoutContext=context,this.layoutInvalidated=!1,this.focusedId&&!this.cachedLayout.placed.some(topic=>topic.id===this.focusedId)&&(this.focusedId=this.cachedLayout.placed[0]?.id??null))}setAnnouncement(text){this.liveText=text,this.announcementSink?.announce(text)}toggle(node,announce=!0){const expanded=!this.isExpanded(node.id,node.depth),next=new Map(this.expandedOverrides);next.set(node.id,expanded),this.expandedOverrides=next,this.emit("lr-topic-toggle",{topicId:node.id,expanded}),announce&&this.setAnnouncement(this.localize(expanded?"mindMapExpanded":"mindMapCollapsed",void 0,{label:node.label}))}activate(node){node.hasChildren?this.toggle(node):this.emit("lr-topic-select",{topicId:node.id})}siblingsOf(node){return this.cachedLayout.placed.filter(p=>p.parentId===node.parentId)}childrenOf(id){return this.cachedLayout.placed.filter(p=>p.parentId===id)}announce(node){const numberFormat=getNumberFormat(this.effectiveLocale);this.setAnnouncement(node.hasChildren?this.localize("mindMapTopicStatus",void 0,{label:node.label,level:numberFormat.format(node.depth+1),count:numberFormat.format(this.childrenOf(node.id).length)}):this.localize("mindMapLeafStatus",void 0,{label:node.label,level:numberFormat.format(node.depth+1)}))}focusNodeById(id){this.focusedId=id;const node=this.cachedLayout.placed.find(p=>p.id===id);node&&this.announce(node)}onNodeClick(node){this.focusedId=node.id,this.svgEl?.focus(),node.hasChildren||this.announce(node),this.activate(node)}connectorControlPoint(from,to){const layout=this.cachedLayout,parentR=Math.hypot(from.x-layout.centerX,from.y-layout.centerY),dir=isRtl(this)?-1:1;return{x:layout.centerX+dir*parentR*Math.sin(to.angle),y:layout.centerY-parentR*Math.cos(to.angle)}}renderSemanticNode(node,childrenByParent){const children=childrenByParent.get(node.id)??[];return html`
       <div
         role="treeitem"
         aria-level=${node.depth+1}

package/dist/components/retrieval/mind-map/mind-map.styles.js

@@ -39,8 +39,6 @@ import{css}from"lit";const styles=css`
   [part="node"]:hover circle {
     stroke: var(--lr-mind-map-node-hover-halo, var(--lr-color-brand-quiet));
   }
-  /* Pressed is the same halo pushed one step toward --lr-color-mix-partner, so it stays whatever
-     hue a consumer set --lr-mind-map-node-hover-halo to while reading as visibly held. */
   [part="node"]:active circle {
     stroke: color-mix(
       in oklab,

package/dist/components/retrieval/neighbor-list/neighbor-list.class.d.ts

@@ -10,7 +10,8 @@ export interface LyraNeighborRow {
     node: LyraEntity;
 }
 export interface LyraNeighborListEventMap {
-    'lr-entity-activate': CustomEvent<{
+    /** Canonical name for the "user picked this entity" gesture. */
+    'lr-entity-select': CustomEvent<{
         entityId: string;
     }>;
     /** Deliberately the *same name and detail* as the `lr-graph` event, so one host handler
@@ -28,7 +29,7 @@ export interface LyraNeighborListEventMap {
  * collection and reassign it after changes; mutating the assigned array does not update the view.
  *
  * @customElement lr-neighbor-list
- * @event lr-entity-activate - A row's node button was activated. `detail: { entityId }`.
+ * @event lr-entity-select - A row's node button was activated. `detail: { entityId }`.
  * @event lr-node-expand - A row's expand button was activated (only rendered when `expandable`).
  * `detail: { nodeId }`.
  * @csspart base - The stable root wrapper across empty, populated and virtualized states. It owns

package/dist/components/retrieval/neighbor-list/neighbor-list.class.js

@@ -4,7 +4,7 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
         type="button"
         aria-label=${accessibleName}
         aria-description=${metaText||nothing}
-        @click=${()=>this.emit("lr-entity-activate",{entityId:row.node.id})}
+        @click=${()=>{this.emit("lr-entity-select",{entityId:row.node.id})}}
       >
         <span part="direction" aria-hidden="true"
           >${this.directionGlyph(row.direction)}</span

package/dist/components/retrieval/neighbor-list/neighbor-list.styles.js

@@ -2,18 +2,6 @@ import{css}from"lit";const styles=css`
   :host {
     display: block;
   }
-  /* Every row rule below is paired with an lr-virtual-list::part(x) twin because this component
-     renders rows through two paths. At or below virtualize-at, renderNeighborRow()'s result is
-     committed into this component's own shadow root and the plain [part=] selector matches. Above
-     it, the exact same content becomes <lr-virtual-list>'s .renderItem, and Lit commits it wherever
-     virtual-list's own render() is updating -- i.e. inside *its* shadow root, a different shadow
-     tree that a [part=] selector scoped to this one can never reach. ::part() crosses that single
-     boundary. Both selectors are load-bearing; dropping either silently unstyles one path.
-
-     [part='row'] is the one name shared with lr-virtual-list's own per-row wrapper, which is
-     exactly why renderItem returns only the row's *content*: a nested second part="row" would be
-     matched by ::part(row) too (::part uses part~= semantics and reaches any depth of the target
-     shadow tree), doubling this rule's padding and divider border on every virtualized row. */
   [part='row'],
   lr-virtual-list::part(row) {
     display: flex;
@@ -65,15 +53,6 @@ import{css}from"lit";const styles=css`
   }
   [part='node-meta'],
   lr-virtual-list::part(node-meta) {
-    /* A flex item's default min-inline-size is auto (a content-based automatic minimum). When
-       lr-neighbor-list's own host is placed where its width is resolved intrinsically (e.g. as a
-       flex/grid item itself, a common real layout for a sidebar/detail-panel row) rather than
-       against an already-definite available width, that content-based minimum -- driven by
-       node-meta's un-wrapped (white-space: nowrap) text -- propagates up through the row and
-       host, growing the whole layout past its container instead of eliding. Pinning it to 0
-       keeps node-meta (and everything containing it) out of that intrinsic-size contribution, so
-       overflow/text-overflow above can actually clip it once real (constrained) space is
-       available. */
     min-inline-size: 0;
     color: var(--lr-color-text-quiet);
     font-size: var(--lr-font-size-xs);
@@ -87,8 +66,6 @@ import{css}from"lit";const styles=css`
     display: inline-flex;
     align-items: center;
     justify-content: center;
-    /* Keep the glyph compact while giving the interactive box the shared minimum target size --
-       same split as lr-code-block's own [part='toggle']. */
     inline-size: var(--lr-size-1-25rem);
     block-size: var(--lr-size-1-25rem);
     min-inline-size: var(--lr-icon-button-size);
@@ -112,13 +89,6 @@ import{css}from"lit";const styles=css`
     outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);
     outline-offset: var(--lr-focus-ring-offset);
   }
-  /* Virtualized mode renders the relation headers from the groups property through
-     lr-virtual-list's own "group" part (re-exported from here as "group-header"), not through this
-     component's
-     [part='group-header'] element -- so the same presentation has to be stated for both, or the
-     headers change appearance the moment the list crosses virtualize-at. Only the typographic
-     treatment is shared: virtual-list positions and inline-pads its own group labels, which is
-     layout this rule deliberately leaves alone. */
   [part='group-header'],
   lr-virtual-list::part(group) {
     padding-block: var(--lr-space-xs);

package/dist/components/retrieval/node-palette/node-palette.styles.js

@@ -25,9 +25,6 @@ import{css}from"lit";const styles=css`
     outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);
     outline-offset: var(--lr-focus-ring-offset);
   }
-  /* no-pressed-state: a press on a text field lands the caret rather than activating a control, so
-     a pressed tint would show only for the length of the mousedown and then be replaced by the
-     :focus-visible ring above, which is the state that actually persists and communicates. */
   [part='search']:hover {
     border-color: var(--lr-color-border-strong);
   }
@@ -68,18 +65,10 @@ import{css}from"lit";const styles=css`
     cursor: not-allowed;
     opacity: var(--lr-opacity-disabled);
   }
-  /* :where() zeroes the wrapped attribute-selector/pseudo-class contribution, leaving only
-     :hover/:focus-visible itself -- (0,1,0) total, functionally identical selection to
-     [part='item']:not([aria-disabled='true']):hover ((0,3,0)) but now losing (on the
-     pseudo-element tiebreak) to a consumer's own ::part(item):hover override ((0,1,1)) without
-     that consumer needing !important. Matches attachment-trigger.styles.ts's low-specificity pattern. */
   :where([part='item']):hover:where(:not([aria-disabled='true'])),
   :where([part='item']):focus-visible:where(:not([aria-disabled='true'])) {
     background: var(--lr-color-surface-hover, var(--lr-color-border));
   }
-  /* These items are drag sources (cursor: grab above), so the pressed state is the moment the drag
-     starts -- the deeper fill and the grabbing cursor together. Kept in the same :where() shape as
-     the hover rule so a consumer's ::part(item):active still outranks it. */
   :where([part='item']):active:where(:not([aria-disabled='true'])) {
     background: color-mix(in oklab, var(--lr-color-surface-hover, var(--lr-color-border)), var(--lr-color-mix-partner) var(--lr-color-mix-active));
     cursor: grabbing;

package/dist/components/retrieval/path-strip/path-strip.styles.js

@@ -11,16 +11,6 @@ import{css}from"lit";const styles=css`
   }
   [part='node'],
   [part='relation'] {
-    /* Both pill kinds share this rule, so both get the same shared minimum
-       hit-area floor -- a short label (either a terse relation like "is-a" or
-       a short node label) would otherwise stay well under the 40px floor.
-       The strip scrolls horizontally (see <lr-scroller> in the render
-       template), so the extra inline space this can add just scrolls rather
-       than forcing a wrap or squeezing a neighboring element -- the same
-       "direct floor" treatment lr-code-block's/lr-json-viewer's own
-       text-bearing [part='copy-button']/[part='toggle'] already use, not the
-       narrower split visible-label/hit-target pattern reserved for pills
-       genuinely out of horizontal room. */
     display: inline-flex;
     align-items: center;
     justify-content: center;

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

@@ -28,7 +28,14 @@ type Section = 'entities' | 'relationships' | 'communities' | 'chunks';
  *  events, all of which are `composed` and therefore reach a host listener on
  *  `<lr-provenance-panel>` itself. Declaring only `lr-toggle` typed those controls out of existence
  *  for anyone building handlers off this type. */
-export interface LyraProvenancePanelEventMap extends Omit<LyraCommunityCardEventMap, 'lr-entity-activate'>, Omit<LyraEntityChipEventMap, 'lr-entity-activate'>, Omit<LyraPathStripEventMap, 'lr-entity-activate'>, LyraChunkInspectorEventMap {
+export interface LyraProvenancePanelEventMap extends Omit<LyraCommunityCardEventMap, 'lr-entity-activate'>, Omit<LyraEntityChipEventMap, 'lr-entity-select'>, Omit<LyraPathStripEventMap, 'lr-entity-activate'>, LyraChunkInspectorEventMap {
+    /** Canonical name for the "user picked this entity" gesture, surfaced unchanged from an
+     *  embedded entity chip. No composed child emits this with an `occurrenceIndex` (only the
+     *  community card and the relationship path strip's own `lr-entity-activate` do), so unlike
+     *  those this stays the plain shape. */
+    'lr-entity-select': CustomEvent<{
+        entityId: string;
+    }>;
     'lr-entity-activate': CustomEvent<{
         entityId: string;
         occurrenceIndex?: number;
@@ -49,8 +56,10 @@ export interface LyraProvenancePanelEventMap extends Omit<LyraCommunityCardEvent
  *
  * @customElement lr-provenance-panel
  * @event lr-toggle - A section header was toggled. `detail: { section, expanded }`.
- * @event lr-entity-activate - Surfaced unchanged from an embedded entity chip, community card, or
- *   relationship path strip. `detail: { entityId, occurrenceIndex? }`.
+ * @event lr-entity-select - Surfaced unchanged from an embedded entity chip.
+ *   `detail: { entityId }`.
+ * @event lr-entity-activate - Surfaced unchanged from an embedded community card or relationship
+ *   path strip. `detail: { entityId, occurrenceIndex? }`.
  * @event lr-entity-open - Surfaced unchanged from an embedded entity chip (double-click, or Space
  *   while focused). `detail: { entityId }`.
  * @event lr-drill - Surfaced unchanged from an embedded community card's title, drill button, or

package/dist/components/retrieval/provenance-panel/provenance-panel.styles.js

@@ -48,8 +48,6 @@ import{css}from"lit";const styles=css`
   [part='body'][hidden] {
     display: none;
   }
-  /* Line packing is consumer-tunable because it is unreachable otherwise: the row fills [part='body']'s
-     inline size, so justifying the body cannot move the wrapped chip lines. */
   .entity-row {
     display: flex;
     flex-wrap: wrap;

package/dist/components/retrieval/rag-eval-dashboard/rag-eval-dashboard.class.d.ts

@@ -26,7 +26,7 @@ export interface LyraRagEvalDashboardEventMap {
     'lr-slice-change': CustomEvent<{
         slice: string;
     }>;
-    'lr-run-select': CustomEvent<{
+    'lr-run-change': CustomEvent<{
         run: LyraRagEvaluationRun;
     }>;
 }
@@ -45,7 +45,7 @@ export interface LyraRagEvalDashboardEventMap {
  * @customElement lr-rag-eval-dashboard
  * @event lr-metric-change - A metric was activated. `detail: { metricId }`.
  * @event lr-slice-change - An evaluation slice was activated. `detail: { slice }`.
- * @event lr-run-select - An evaluation run was activated. `detail: { run }`.
+ * @event lr-run-change - An evaluation run was activated. `detail: { run }`.
  * @csspart base - The named dashboard region.
  * @csspart heading - The visible dashboard heading.
  * @csspart slices - Slice filter controls.
@@ -89,6 +89,7 @@ export declare class LyraRagEvalDashboard extends LyraElement<LyraRagEvalDashboa
     private filteredRuns;
     private formatMetric;
     private latestValue;
+    private emitRunChange;
     private renderSlices;
     render(): TemplateResult;
 }

package/dist/components/retrieval/rag-eval-dashboard/rag-eval-dashboard.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{getNumberFormat}from"../../../internal/intl-cache.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity}from"../retrieval-identity.js";import{finiteRange}from"../../../internal/numbers.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import"../../charts/chart/lite-chart.class.js";import"../../data/stat/stat.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./rag-eval-dashboard.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_ragEvalDashboardAllSlices,LYRA_DEFAULT_ragEvalDashboardEmpty,LYRA_DEFAULT_ragEvalDashboardLabel,LYRA_DEFAULT_ragEvalDashboardRuns,LYRA_DEFAULT_ragEvalDashboardSliceUnavailable,LYRA_DEFAULT_ragEvalDashboardSlices}from"../../../internal/default-strings.generated.js";class LyraRagEvalDashboard extends LyraElement{constructor(){super(...arguments),this.metrics=[],this.runs=[],this.metricId="",this.slice="",this.showChart=!0,this.chartHeight="220px"}static{this.defaultStrings={...super.defaultStrings,ragEvalDashboardAllSlices:LYRA_DEFAULT_ragEvalDashboardAllSlices,ragEvalDashboardEmpty:LYRA_DEFAULT_ragEvalDashboardEmpty,ragEvalDashboardLabel:LYRA_DEFAULT_ragEvalDashboardLabel,ragEvalDashboardRuns:LYRA_DEFAULT_ragEvalDashboardRuns,ragEvalDashboardSliceUnavailable:LYRA_DEFAULT_ragEvalDashboardSliceUnavailable,ragEvalDashboardSlices:LYRA_DEFAULT_ragEvalDashboardSlices}}static{this.ownedCollectionProperties=Object.freeze(["metrics","runs"])}static{this.styles=[LyraElement.styles,styles]}get normalizedMetrics(){return firstByRetrievalIdentity(Array.isArray(this.metrics)?this.metrics:[],metric=>metric.id)}get normalizedRuns(){return firstByRetrievalIdentity(Array.isArray(this.runs)?this.runs:[],run=>run.id)}activeMetric(metrics){return metrics.find(metric=>metric.id===this.metricId)??metrics[0]}slices(runs){return[...new Set(runs.map(run=>run.slice).filter(slice=>!!slice))]}filteredRuns(runs){return this.slice?runs.filter(run=>run.slice===this.slice):runs}formatMetric(metric,raw){const value=Number.isFinite(raw)?raw:0;return metric.format==="percent"?getNumberFormat(this.effectiveLocale,{style:"percent",maximumFractionDigits:1}).format(finiteRange(value,0,0,1)):getNumberFormat(this.effectiveLocale,{maximumFractionDigits:3}).format(value)}latestValue(metric,runs){return[...runs].reverse().find(run=>Number.isFinite(run.metrics[metric.id]))?.metrics[metric.id]}renderSlices(slices){if(!slices.length)return nothing;const allSlicesPart=this.slice?"slice":"slice slice-selected";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{getNumberFormat}from"../../../internal/intl-cache.js";import{LyraElement}from"../../../internal/lyra-element.js";import{firstByRetrievalIdentity}from"../retrieval-identity.js";import{finiteRange}from"../../../internal/numbers.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import"../../charts/chart/lite-chart.class.js";import"../../data/stat/stat.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./rag-eval-dashboard.styles.js";import{retrievalSemanticLabel,retrievalSemanticRole}from"../retrieval-semantic-owner.js";import{LYRA_DEFAULT_ragEvalDashboardAllSlices,LYRA_DEFAULT_ragEvalDashboardEmpty,LYRA_DEFAULT_ragEvalDashboardLabel,LYRA_DEFAULT_ragEvalDashboardRuns,LYRA_DEFAULT_ragEvalDashboardSliceUnavailable,LYRA_DEFAULT_ragEvalDashboardSlices}from"../../../internal/default-strings.generated.js";class LyraRagEvalDashboard extends LyraElement{constructor(){super(...arguments),this.metrics=[],this.runs=[],this.metricId="",this.slice="",this.showChart=!0,this.chartHeight="220px"}static{this.defaultStrings={...super.defaultStrings,ragEvalDashboardAllSlices:LYRA_DEFAULT_ragEvalDashboardAllSlices,ragEvalDashboardEmpty:LYRA_DEFAULT_ragEvalDashboardEmpty,ragEvalDashboardLabel:LYRA_DEFAULT_ragEvalDashboardLabel,ragEvalDashboardRuns:LYRA_DEFAULT_ragEvalDashboardRuns,ragEvalDashboardSliceUnavailable:LYRA_DEFAULT_ragEvalDashboardSliceUnavailable,ragEvalDashboardSlices:LYRA_DEFAULT_ragEvalDashboardSlices}}static{this.ownedCollectionProperties=Object.freeze(["metrics","runs"])}static{this.styles=[LyraElement.styles,styles]}get normalizedMetrics(){return firstByRetrievalIdentity(Array.isArray(this.metrics)?this.metrics:[],metric=>metric.id)}get normalizedRuns(){return firstByRetrievalIdentity(Array.isArray(this.runs)?this.runs:[],run=>run.id)}activeMetric(metrics){return metrics.find(metric=>metric.id===this.metricId)??metrics[0]}slices(runs){return[...new Set(runs.map(run=>run.slice).filter(slice=>!!slice))]}filteredRuns(runs){return this.slice?runs.filter(run=>run.slice===this.slice):runs}formatMetric(metric,raw){const value=Number.isFinite(raw)?raw:0;return metric.format==="percent"?getNumberFormat(this.effectiveLocale,{style:"percent",maximumFractionDigits:1}).format(finiteRange(value,0,0,1)):getNumberFormat(this.effectiveLocale,{maximumFractionDigits:3}).format(value)}latestValue(metric,runs){return[...runs].reverse().find(run=>Number.isFinite(run.metrics[metric.id]))?.metrics[metric.id]}emitRunChange(run){this.emit("lr-run-change",{run})}renderSlices(slices){if(!slices.length)return nothing;const allSlicesPart=this.slice?"slice":"slice slice-selected";return html`
       <nav part="slices" aria-label=${this.localize("ragEvalDashboardSlices")}>
         <button
           part=${allSlicesPart}
@@ -88,7 +88,7 @@ var __decorate=function(decorators,target,key,desc){var c=arguments.length,r=c<3
               <button
                 part="run"
                 type="button"
-                @click=${()=>this.emit("lr-run-select",{run})}
+                @click=${()=>this.emitRunChange(run)}
               >
                 <span>${run.label}</span>
                 ${active&&Number.isFinite(run.metrics[active.id])?html`<span

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

@@ -7,19 +7,6 @@ import{css}from"lit";const styles=css`
     color: var(--lr-color-danger);
     font-size: var(--lr-font-size-sm);
   }
-  /* Two rendering paths, one presentation. Below \`virtualize-at\` (and only while ungrouped) rows
-     are committed into this component's own shadow root, where a plain [part~='x'] selector matches
-     them. Grouped mode always virtualizes, and so does any list past the threshold; then the
-     identical row template becomes <lr-virtual-list>'s .renderItem and Lit commits it inside *that*
-     component's shadow root -- a different tree, unreachable from a selector scoped to this one.
-     lr-virtual-list::part(x) crosses exactly that one boundary, so both selectors are needed for
-     every row-level part; the pairing follows <lr-ingestion-queue>'s own dual-path rows.
-
-     [part='row'] is the one asymmetric case: in the virtualized path the row wrapper is
-     <lr-virtual-list>'s own "row" part (re-exported here under the same name), not an element this
-     component renders, so the two arms carry different declarations. The virtualized arm omits the
-     row separator: those wrappers are absolutely positioned and measured by <lr-virtual-list>
-     itself, and the nested chunk row already draws its own block-end border there. */
   [part='row'] {
     display: flex;
     align-items: flex-start;
@@ -35,11 +22,6 @@ import{css}from"lit";const styles=css`
     padding-inline: var(--lr-space-s);
     padding-block: var(--lr-space-s);
   }
-  /* The group header comes from <lr-virtual-list>'s own "group" part (this component passes
-     .groups rather than a renderGroup callback), re-exported here as "group-header". The list's
-     own default already gives it the surface/quiet/semibold treatment; what it has no opinion on
-     is the boundary between the header and the first row beneath it, which this component draws
-     with the same separator its rows use. */
   lr-virtual-list::part(group) {
     box-sizing: border-box;
     border-block-end: var(--lr-border-width-thin) solid var(--lr-color-border);
@@ -53,17 +35,9 @@ import{css}from"lit";const styles=css`
   lr-virtual-list::part(row-body) {
     flex: 1 1 auto;
     min-inline-size: 0;
-    /* A border rather than a background-color change: this row's own text (the nested
-       lr-chunk-inspector's quiet-toned score text in particular) is sized/colored for the
-       page's default surface, and a tinted background can drop that text below the required
-       contrast ratio against it -- a border-only indicator carries no such risk. */
     border-inline-start: var(--lr-space-2xs) solid transparent;
     padding-inline-start: var(--lr-space-xs);
   }
-  /* The selected state is a second part token rather than the row's data-selected attribute:
-     Shadow Parts forbids an attribute selector after ::part(), so ::part(row-body)[data-selected]
-     is invalid CSS and the rule would be dropped entirely while virtualized. data-selected stays
-     on the element for consumers selecting within their own tree. */
   [part~='row-body-selected'],
   lr-virtual-list::part(row-body-selected) {
     border-inline-start-color: var(--lr-retrieval-results-selected-border, var(--lr-color-brand));
@@ -83,8 +57,6 @@ import{css}from"lit";const styles=css`
     display: flex;
     gap: var(--lr-space-2xs);
   }
-  /* The <dt>/<dd> carry their own part names because ::part() matches a single element and cannot
-     be followed by a descendant combinator -- ::part(metadata-entry) dt reaches nothing. */
   [part~='metadata-term'],
   lr-virtual-list::part(metadata-term) {
     font-weight: var(--lr-font-weight-medium);

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

@@ -44,10 +44,6 @@ import{css}from"lit";const styles=css`
       background-color var(--lr-transition-fast),
       border-color var(--lr-transition-fast);
   }
-  /* A background mix, not filter: brightness(): a filter multiplies every channel of the subtree,
-     so it dragged the button's own --lr-color-on-brand label along with the fill and moved neither
-     at all once the brand token was themed to pure white or pure black. Mixing the fill toward
-     --lr-color-mix-partner (which tracks the text color) always moves, and only the fill moves. */
   [part='submit']:hover {
     background: color-mix(in oklab, var(--lr-color-brand), var(--lr-color-mix-partner) var(--lr-color-mix-hover));
   }

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

@@ -67,8 +67,6 @@ import{css}from"lit";const styles=css`
   [part='evidence-toggle'][aria-expanded='true'] [part='evidence-toggle-icon'] svg {
     transform: rotate(90deg);
   }
-  /* Mirrors this family's own chevron-mirroring convention (see lr-trace-tree): rotation is
-     physical, so a collapsed chevron under RTL points the opposite way from LTR. */
   :host(:dir(rtl)) [part='evidence-toggle']:not([aria-expanded='true']) [part='evidence-toggle-icon'] svg {
     transform: rotate(180deg);
   }

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

@@ -12,20 +12,10 @@ import{css}from"lit";const styles=css`
     border-radius: var(--lr-radius);
     background: var(--lr-color-surface);
   }
-  /* Density escape -- same convention as lr-empty's compact. Source cards render in lists, so the
-     tuned values sit behind inline var() fallbacks (rather than a :host declaration, which every
-     instance re-declares and so shadows any ancestor value) letting a list retune every card at
-     once from the outside; the fallbacks are the pre-existing values scaled down one step, so an
-     unset card renders unchanged. */
   :host([compact]) [part='base'] {
     padding: var(--lr-source-card-compact-padding, var(--lr-space-xs));
     gap: var(--lr-source-card-compact-gap, var(--lr-space-2xs));
   }
-  /* MUST stay after :host([compact]): both selectors are :host([x]) [part='base'], i.e. equal
-     specificity, so source order alone decides which padding/gap wins when a card is both compact
-     and plain. plain is the stronger statement ("no chrome at all"), so it goes last. The title and
-     toggle affordances are brand-colored text with a hover underline, never a border, so they stay
-     legible with no chrome behind them. */
   :host([frame='plain']) [part='base'] {
     padding: 0;
     border: 0;
@@ -53,9 +43,6 @@ import{css}from"lit";const styles=css`
   [part='title']:hover {
     text-decoration: underline;
   }
-  /* Both affordances here are transparent-backed brand-colored text (see the frame='plain' note
-     above), so the pressed signal is a wash mixed from that transparent base -- the label itself has
-     to keep its brand color to stay readable as a link. */
   [part='title']:active {
     text-decoration: underline;
     background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active));

package/dist/components/retrieval/source-list/source-list.styles.js

@@ -47,13 +47,6 @@ import{css}from"lit";const styles=css`
   :host([expanded]) [part='toggle'] {
     transform: rotate(90deg);
   }
-  /* RTL: the resting (collapsed) chevron mirrors to point left, the
-     conventional mirrored disclosure-triangle direction for RTL. Scoped to
-     the collapsed state specifically (rather than a plain :dir(rtl) rule) so
-     it never has to compete with the rule above for the expanded state, which
-     needs no mirroring: rotating this left-right-asymmetric glyph 90deg
-     already produces a left-right-symmetric down chevron. Mirrors
-     lr-code-block's identical toggle chevron. */
   :host(:not([expanded]):dir(rtl)) [part='toggle'] {
     transform: scaleX(-1);
   }

package/dist/components/retrieval/source-picker/source-picker.styles.js

@@ -43,10 +43,6 @@ import{css}from"lit";const styles=css`
     min-inline-size: var(--lr-icon-button-size);
     min-block-size: var(--lr-icon-button-size);
     padding: var(--lr-size-4px) var(--lr-space-xs);
-    /* Per-level indent computed in CSS from the plain depth number the component writes inline,
-       rather than a pre-formatted dimension: that keeps the step a retheme-able token and lets the
-       indent be capped, so a deeply nested tree cannot push its labels off-screen with no way back.
-       Same shape lr-tree-item already uses. */
     padding-inline-start: calc(
       var(--lr-space-xs) +
         min(
@@ -85,9 +81,6 @@ import{css}from"lit";const styles=css`
   [part="item"]:hover {
     background: color-mix(in srgb, var(--lr-color-text) 6%, transparent);
   }
-  /* The row itself is the control here -- clicking anywhere in it toggles the source (the
-     [part='checkbox'] box inside is a painted div, not a focusable target), so the row earns a
-     pressed state of its own rather than deferring to something nested. */
   [part="item"]:active {
     background: color-mix(
       in oklab,

package/dist/components/utility/copy-button/copy-button.styles.js

@@ -8,8 +8,6 @@ import{css}from"lit";const styles=css`
   slot:not([name]) {
     display: contents;
   }
-  /* Every selector below matches with ~= rather than =, because the button's part list gains a
-     state token ('base base-error') while the feedback state is showing. */
   [part~='base'] {
     display: inline-flex;
     align-items: center;
@@ -27,9 +25,6 @@ import{css}from"lit";const styles=css`
     -webkit-tap-highlight-color: transparent;
     transition: background-color var(--lr-transition-fast);
   }
-  /* :where() keeps this rule's specificity low ((0,1,0)) so a consumer's own
-     ::part(base):hover override ((0,1,1)) wins without needing !important --
-     see lr-attachment-trigger's identical fix for the same reasoning. */
   :where([part~='base']:not(:disabled)):hover {
     background: color-mix(in srgb, var(--lr-color-text) 8%, transparent);
     color: var(--lr-color-text);
@@ -38,9 +33,6 @@ import{css}from"lit";const styles=css`
     background: color-mix(in oklab, transparent, var(--lr-color-mix-partner) var(--lr-color-mix-active));
     color: var(--lr-color-text);
   }
-  /* After the hover and pressed rules, at equal specificity, so hovering or holding the failed
-     button still changes its background (the interactive affordance) without repainting the failure
-     color away. */
   [part~='base-success'] {
     color: var(--success-color, var(--lr-color-success));
   }
@@ -63,8 +55,6 @@ import{css}from"lit";const styles=css`
   [part~='base'] svg {
     display: block;
   }
-  /* The outcome is announced, not shown: the button is icon-only, so the status text exists for
-     assistive technology alone. Same clipped-1px pattern lr-pagination's live region uses. */
   [part='feedback'] {
     position: absolute;
     inline-size: var(--lr-size-1px);

package/dist/components/utility/diff-view/diff-view.styles.js

@@ -38,29 +38,15 @@ import{css}from"lit";const styles=css`
     min-inline-size: 0;
   }
   [part="line"] {
-    /* Lives here (rather than on the ancestor pre element) so layout="split" -- whose lines sit
-       inside [part='side'], not a pre -- inherits the same monospace typography as the default
-       unified pre. font-family/font-size/line-height are all inheritable, so moving them here
-       from pre is visually identical for the unified layout (same computed values, just set
-       directly instead of inherited). */
     font-family: var(--lr-diff-view-font, var(--_lr-diff-view-font));
     font-size: var(--lr-font-size-sm);
     line-height: var(--lr-line-height-snug);
     white-space: pre-wrap;
-    /* The base/side owns horizontal scrolling while each line owns its change-state background.
-       Grow that painted box with an unbroken line, but keep short lines filling the scrollport. */
     box-sizing: border-box;
     inline-size: max-content;
     min-inline-size: 100%;
   }
   [part="line"]:not([data-type="fold"]) {
-    /* Diffed source code is read left-to-right regardless of the surrounding document direction --
-       same rationale (and matching fix shape) as code-block.styles.ts's [part='pre']: without this,
-       an ancestor dir="rtl" bidi-reorders each line and right-aligns the block, making valid code
-       look syntactically broken. isolate keeps any RTL run inside a string/comment from leaking out
-       and reordering the surrounding code. Excludes [data-type='fold'] -- that line renders a
-       localized message ("N unchanged lines"), not code, and must keep following the ambient
-       (possibly RTL) direction like ordinary UI text. */
     direction: ltr;
     unicode-bidi: isolate;
   }

package/dist/components/utility/export-button/export-button.styles.js

@@ -17,15 +17,9 @@ import{css}from"lit";const styles=css`
     min-block-size: var(--lr-icon-button-size);
     cursor: pointer;
   }
-  /* :where() zeroes the wrapped selectors' specificity contribution, leaving only :hover itself
-     -- (0,1,0) total, functionally identical selection to \`[part='trigger']:hover:not(:disabled)\`
-     ((0,3,0)) but now losing (on the pseudo-element tiebreak) to a consumer's own
-     \`::part(trigger):hover\` override ((0,1,1)) without that consumer needing !important. */
   :where([part='trigger']):hover:where(:not(:disabled)) {
     border-color: var(--lr-color-brand);
   }
-  /* Same :where() shape as the hover rule above, for the same reason -- a consumer's own
-     ::part(trigger):active must still win without !important. */
   :where([part='trigger']):active:where(:not(:disabled)) {
     border-color: var(--lr-color-brand);
     background: color-mix(in oklab, var(--lr-color-surface), var(--lr-color-mix-partner) var(--lr-color-mix-active));
@@ -39,18 +33,6 @@ import{css}from"lit";const styles=css`
     outline-offset: var(--lr-focus-ring-offset);
   }
   [part='menu'] {
-    /* Closed state: invisible + slightly raised. visibility (not
-       display:none) so opacity/transform can actually transition; hit-testing
-       and a11y exposure stay off since this part is already position:fixed.
-       visibility deliberately isn't in the transition list below: a
-       transitioned property's computed value only settles to its new
-       target after the UA has run an actual style-change/rendering pass,
-       which lags behind a same-tick attribute write (e.g. updated()
-       synchronously focusing the first menu item right after flipping
-       open) -- that item would still resolve as visibility: hidden (and
-       so silently fail to focus) at the moment .focus() is called. Leaving
-       visibility untransitioned makes it apply immediately, in the same
-       synchronous style pass as the open attribute write. */
     visibility: hidden;
     position: fixed;
     z-index: var(--lr-layer-dropdown);
@@ -71,7 +53,6 @@ import{css}from"lit";const styles=css`
     background: var(--lr-color-surface);
     border: var(--lr-border-width-thin) solid var(--lr-color-border);
     border-radius: var(--lr-radius);
-    /* Anchored overlay: a positioner-placed menu floating over page content, not a modal layer. */
     box-shadow: var(--lr-shadow-m);
     opacity: 0;
     transform: translateY(var(--lr-size-neg-4px));
@@ -95,7 +76,6 @@ import{css}from"lit";const styles=css`
     align-items: start;
     gap: var(--lr-size-1px);
     box-sizing: border-box;
-    min-inline-size: 0;
     inline-size: 100%;
     min-inline-size: var(--lr-icon-button-size);
     min-block-size: var(--lr-icon-button-size);
@@ -108,8 +88,6 @@ import{css}from"lit";const styles=css`
     cursor: pointer;
     border-radius: var(--lr-radius);
   }
-  /* :where() zeroes the wrapped selectors' specificity contribution -- see the [part='trigger']
-     hover rule above for the full rationale. */
   :where([part='menu-item']):hover:where(:not(:disabled)) {
     background: var(--lr-color-brand-quiet);
   }