@aceshooting/lyra-ui 9.1.0 → 10.0.1

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.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}from"lit/decorators.js";import{styleMap}from"lit/directives/style-map.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{LyraElement}from"../../../internal/lyra-element.js";import{isNonBlankIdentity}from"../retrieval-identity.js";import{isRtl}from"../../../internal/rtl.js";import"../../media/file-icon/file-icon.class.js";import"../../forms/input/input.class.js";import"../../forms/checkbox/checkbox.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./source-picker.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{activeElementIn}from"../../../internal/active-element.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{LYRA_DEFAULT_collapse,LYRA_DEFAULT_date,LYRA_DEFAULT_details,LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_fileSizeUnitB,LYRA_DEFAULT_fileSizeUnitGb,LYRA_DEFAULT_fileSizeUnitKb,LYRA_DEFAULT_fileSizeUnitMb,LYRA_DEFAULT_fileSizeUnitTb,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_noData,LYRA_DEFAULT_noMatches,LYRA_DEFAULT_open,LYRA_DEFAULT_progress,LYRA_DEFAULT_restore,LYRA_DEFAULT_search,LYRA_DEFAULT_select,LYRA_DEFAULT_selectAllSources,LYRA_DEFAULT_sourceListDefaultLabel,LYRA_DEFAULT_sourcePickerSelection,LYRA_DEFAULT_valueInvalid}from"../../../internal/default-strings.generated.js";const MAX_SOURCE_NODES=2e3,MAX_SOURCE_DEPTH=64;class LyraSourcePicker extends LyraElement{constructor(){super(...arguments),this.sources=[],this.selectedSourceIds=[],this.showSelectAll=!0,this.searchable=!0,this.accessibleLabel=null,this.expandedIds=new Set,this.query="",this.activeId=null,this.keyboardFocusGeneration=0,this.isMounting=!0,this.lastFilterAnnouncement="",this.onTreeKeyDown=e=>{const rows=this.visibleRows();if(rows.length===0)return;const currentIndex=Math.max(0,rows.findIndex(r=>r.entry.id===this.activeId)),current=rows[currentIndex],rtl=isRtl(this),expandKey=rtl?"ArrowLeft":"ArrowRight",collapseKey=rtl?"ArrowRight":"ArrowLeft";switch(e.key){case"ArrowDown":e.preventDefault(),this.focusRowByIndex(Math.min(rows.length-1,currentIndex+1),rows);break;case"ArrowUp":e.preventDefault(),this.focusRowByIndex(Math.max(0,currentIndex-1),rows);break;case"Home":e.preventDefault(),this.focusRowByIndex(0,rows);break;case"End":e.preventDefault(),this.focusRowByIndex(rows.length-1,rows);break;case expandKey:if(e.preventDefault(),current.hasChildren&&!this.expandedIds.has(current.entry.id))this.expandedIds=new Set(this.expandedIds).add(current.entry.id);else if(current.hasChildren){const next=this.visibleRows()[currentIndex+1];next&&next.depth>current.depth&&this.focusRowByIndex(currentIndex+1,this.visibleRows())}break;case collapseKey:if(e.preventDefault(),current.hasChildren&&this.expandedIds.has(current.entry.id)){const set=new Set(this.expandedIds);set.delete(current.entry.id),this.expandedIds=set}else for(let i=currentIndex-1;i>=0;i--)if(rows[i].depth<current.depth){this.focusRowByIndex(i,rows);break}break;case"Enter":case" ":e.preventDefault(),this.toggleEntry(current.entry);break;default:return}}}static{this.defaultStrings={...super.defaultStrings,collapse:LYRA_DEFAULT_collapse,date:LYRA_DEFAULT_date,details:LYRA_DEFAULT_details,fieldRequired:LYRA_DEFAULT_fieldRequired,fileSizeUnitB:LYRA_DEFAULT_fileSizeUnitB,fileSizeUnitGb:LYRA_DEFAULT_fileSizeUnitGb,fileSizeUnitKb:LYRA_DEFAULT_fileSizeUnitKb,fileSizeUnitMb:LYRA_DEFAULT_fileSizeUnitMb,fileSizeUnitTb:LYRA_DEFAULT_fileSizeUnitTb,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,noData:LYRA_DEFAULT_noData,noMatches:LYRA_DEFAULT_noMatches,open:LYRA_DEFAULT_open,progress:LYRA_DEFAULT_progress,restore:LYRA_DEFAULT_restore,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select,selectAllSources:LYRA_DEFAULT_selectAllSources,sourceListDefaultLabel:LYRA_DEFAULT_sourceListDefaultLabel,sourcePickerSelection:LYRA_DEFAULT_sourcePickerSelection,valueInvalid:LYRA_DEFAULT_valueInvalid}}static{this.ownedCollectionProperties=Object.freeze(["sources","selectedSourceIds"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-sources-change"])}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this})}disconnectedCallback(){this.isMounting=!0,this.lastFilterAnnouncement="",this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}get sourceModel(){if(this.normalizedInput===this.sources&&this.normalizedModel)return this.normalizedModel;const roots=[],nodes=[],byEntry=new WeakMap,seenObjects=new WeakSet,seenIds=new Set;let limited=!1;const stack=[];stack.push({sources:this.sources,target:roots,depth:0,index:0});let inspected=0;for(;stack.length;){const frame=stack[stack.length-1];if(frame.index>=frame.sources.length){stack.pop();continue}if(inspected>=MAX_SOURCE_NODES){limited=!0;break}const source=frame.sources[frame.index++];if(inspected++,!source||typeof source!="object"||seenObjects.has(source)||!isNonBlankIdentity(source.id)||seenIds.has(source.id)){limited=!0;continue}if(nodes.length>=MAX_SOURCE_NODES||frame.depth>MAX_SOURCE_DEPTH){limited=!0;continue}seenObjects.add(source),seenIds.add(source.id);const declaredGroup=Array.isArray(source.children),entry={id:source.id,label:source.label,...source.mimeType!==void 0?{mimeType:source.mimeType}:{},...source.name!==void 0?{name:source.name}:{},...declaredGroup?{children:[]}:{}},node={entry,depth:frame.depth,children:[],leafIds:[]};declaredGroup&&(entry.children=node.children.map(child=>child.entry)),frame.target.push(node),nodes.push(node),byEntry.set(entry,node);const children=source.children??[];children.length&&frame.depth>=MAX_SOURCE_DEPTH&&(limited=!0),children.length&&frame.depth<MAX_SOURCE_DEPTH&&stack.push({sources:children,target:node.children,depth:frame.depth+1,index:0})}for(let index=nodes.length-1;index>=0;index--){const node=nodes[index];node.entry.children!==void 0&&(node.entry.children=node.children.map(child=>child.entry)),node.leafIds=node.entry.children===void 0?[node.entry.id]:[...new Set(node.children.flatMap(child=>child.leafIds))]}const leafIds=[...new Set(roots.flatMap(root=>root.leafIds))];return this.normalizedInput=this.sources,this.normalizedModel={roots,nodes,byEntry,leafIds,limited},this.normalizedModel}allLeafIds(){return this.sourceModel.leafIds}descendantLeafIds(entry){return this.sourceModel.byEntry.get(entry)?.leafIds??[]}normalizedSelectedSourceIds(){const valid=new Set(this.allLeafIds()),seen=new Set;return this.selectedSourceIds.filter(id=>!valid.has(id)||seen.has(id)?!1:(seen.add(id),!0))}checkedState(entry){const leaves=this.descendantLeafIds(entry),selected=leaves.filter(id=>this.selectedSourceIds.includes(id));return selected.length===0?"false":selected.length===leaves.length?"true":"mixed"}matchesQuery(entry){return entry.label.toLocaleLowerCase(this.effectiveLocale).includes(this.query.trim().toLocaleLowerCase(this.effectiveLocale))}isFiltering(){return this.searchable&&this.query.trim().length>0}visibleRows(){const rows=[],filtering=this.isFiltering(),matches=new Set;if(filtering)for(let index=this.sourceModel.nodes.length-1;index>=0;index--){const node=this.sourceModel.nodes[index];(this.matchesQuery(node.entry)||node.children.some(child=>matches.has(child)))&&matches.add(node)}const stack=[...this.sourceModel.roots].reverse();for(;stack.length;){const node=stack.pop();if(filtering&&!matches.has(node))continue;const hasChildren=node.entry.children!==void 0;if(rows.push({entry:node.entry,depth:node.depth,hasChildren}),hasChildren&&(filtering||this.expandedIds.has(node.entry.id)))for(let index=node.children.length-1;index>=0;index--)stack.push(node.children[index])}return rows}willUpdate(changed){if(super.willUpdate(changed),changed.has("sources")||changed.has("selectedSourceIds")){const normalized=this.normalizedSelectedSourceIds();(normalized.length!==this.selectedSourceIds.length||normalized.some((id,index)=>id!==this.selectedSourceIds[index]))&&(this.selectedSourceIds=normalized)}if(!changed.has("sources")&&!changed.has("query")&&!changed.has("expandedIds"))return;const focusedIndex=Array.from(this.renderRoot.querySelectorAll('[part~="item"]')).indexOf(activeElementIn(this.shadowRoot)),rows=this.visibleRows(),retainedIndex=rows.findIndex(row=>row.entry.id===this.activeId),nextIndex=retainedIndex>=0?retainedIndex:rows.length?Math.min(Math.max(focusedIndex,0),rows.length-1):-1;this.activeId=nextIndex>=0?rows[nextIndex].entry.id:null,focusedIndex>=0&&(this.pendingFocusIndex=nextIndex>=0?nextIndex:this.sources.length===0||!this.searchable?"base":"search")}updated(changed){super.updated(changed);const pending=this.pendingFocusIndex;pending!==void 0&&(this.pendingFocusIndex=void 0,pending==="search"?this.renderRoot.querySelector('[part~="search"]')?.focus():pending==="base"?this.renderRoot.querySelector('[part="base"]')?.focus():this.renderRoot.querySelectorAll('[part~="item"]')[pending]?.focus());const wasMounting=this.isMounting;if(this.isMounting=!1,wasMounting||!changed.has("query")&&!changed.has("sources"))return;if(!this.isFiltering()){this.lastFilterAnnouncement="";return}const count=this.visibleRows().length,signature=`${this.query.trim().toLocaleLowerCase(this.effectiveLocale)}\0${count}`;signature!==this.lastFilterAnnouncement&&(this.lastFilterAnnouncement=signature,count===0&&this.announcementSink?.announce(this.localize("noMatches")))}commitSelection(next){this.selectedSourceIds=next,this.emit("lr-sources-change",{selectedSourceIds:next})}toggleEntry(entry){const leaves=this.descendantLeafIds(entry),willSelect=this.checkedState(entry)!=="true",set=new Set(this.selectedSourceIds);for(const id of leaves)willSelect?set.add(id):set.delete(id);this.commitSelection([...set])}toggleSelectAll(){const all=this.allLeafIds(),allSelected=all.length>0&&all.every(id=>this.selectedSourceIds.includes(id));this.commitSelection(allSelected?[]:all)}focusRowByIndex(index,rows){const targetId=rows[index]?.entry.id;if(!targetId)return;this.activeId=targetId;const generation=++this.keyboardFocusGeneration;this.updateComplete.then(()=>{if(!this.isConnected||generation!==this.keyboardFocusGeneration)return;const currentIndex=this.visibleRows().findIndex(row=>row.entry.id===targetId);if(currentIndex<0)return;this.renderRoot.querySelectorAll('[part~="item"]')[currentIndex]?.focus()})}renderRow(row,active){const state2=this.checkedState(row.entry),expanded=row.hasChildren&&(this.expandedIds.has(row.entry.id)||this.isFiltering());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}from"lit/decorators.js";import{styleMap}from"lit/directives/style-map.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{LyraElement}from"../../../internal/lyra-element.js";import{isNonBlankIdentity}from"../retrieval-identity.js";import{isRtl}from"../../../internal/rtl.js";import"../../media/file-icon/file-icon.class.js";import"../../forms/input/input.class.js";import"../../forms/checkbox/checkbox.class.js";import"../../overlays/empty/empty.class.js";import{styles}from"./source-picker.styles.js";import{trueDefaultBooleanConverter}from"../../../internal/converters.js";import{getNumberFormat}from"../../../internal/intl-cache.js";import{activeElementIn}from"../../../internal/active-element.js";import{acquireAnnouncementSink}from"../../../internal/announcer.js";import{LYRA_DEFAULT_collapse,LYRA_DEFAULT_date,LYRA_DEFAULT_details,LYRA_DEFAULT_fieldRequired,LYRA_DEFAULT_fileSizeUnitB,LYRA_DEFAULT_fileSizeUnitGb,LYRA_DEFAULT_fileSizeUnitKb,LYRA_DEFAULT_fileSizeUnitMb,LYRA_DEFAULT_fileSizeUnitTb,LYRA_DEFAULT_map,LYRA_DEFAULT_navigation,LYRA_DEFAULT_noData,LYRA_DEFAULT_noMatches,LYRA_DEFAULT_open,LYRA_DEFAULT_popover,LYRA_DEFAULT_progress,LYRA_DEFAULT_restore,LYRA_DEFAULT_search,LYRA_DEFAULT_select,LYRA_DEFAULT_selectAllSources,LYRA_DEFAULT_sourceListDefaultLabel,LYRA_DEFAULT_sourcePickerSelection,LYRA_DEFAULT_valueInvalid}from"../../../internal/default-strings.generated.js";const MAX_SOURCE_NODES=2e3,MAX_SOURCE_DEPTH=64;class LyraSourcePicker extends LyraElement{constructor(){super(...arguments),this.sources=[],this.selectedSourceIds=[],this.showSelectAll=!0,this.searchable=!0,this.accessibleLabel=null,this.expandedIds=new Set,this.query="",this.activeId=null,this.keyboardFocusGeneration=0,this.isMounting=!0,this.lastFilterAnnouncement="",this.onTreeKeyDown=e=>{const rows=this.visibleRows();if(rows.length===0)return;const currentIndex=Math.max(0,rows.findIndex(r=>r.entry.id===this.activeId)),current=rows[currentIndex],rtl=isRtl(this),expandKey=rtl?"ArrowLeft":"ArrowRight",collapseKey=rtl?"ArrowRight":"ArrowLeft";switch(e.key){case"ArrowDown":e.preventDefault(),this.focusRowByIndex(Math.min(rows.length-1,currentIndex+1),rows);break;case"ArrowUp":e.preventDefault(),this.focusRowByIndex(Math.max(0,currentIndex-1),rows);break;case"Home":e.preventDefault(),this.focusRowByIndex(0,rows);break;case"End":e.preventDefault(),this.focusRowByIndex(rows.length-1,rows);break;case expandKey:if(e.preventDefault(),current.hasChildren&&!this.expandedIds.has(current.entry.id))this.expandedIds=new Set(this.expandedIds).add(current.entry.id);else if(current.hasChildren){const next=this.visibleRows()[currentIndex+1];next&&next.depth>current.depth&&this.focusRowByIndex(currentIndex+1,this.visibleRows())}break;case collapseKey:if(e.preventDefault(),current.hasChildren&&this.expandedIds.has(current.entry.id)){const set=new Set(this.expandedIds);set.delete(current.entry.id),this.expandedIds=set}else for(let i=currentIndex-1;i>=0;i--)if(rows[i].depth<current.depth){this.focusRowByIndex(i,rows);break}break;case"Enter":case" ":e.preventDefault(),this.toggleEntry(current.entry);break;default:return}}}static{this.defaultStrings={...super.defaultStrings,collapse:LYRA_DEFAULT_collapse,date:LYRA_DEFAULT_date,details:LYRA_DEFAULT_details,fieldRequired:LYRA_DEFAULT_fieldRequired,fileSizeUnitB:LYRA_DEFAULT_fileSizeUnitB,fileSizeUnitGb:LYRA_DEFAULT_fileSizeUnitGb,fileSizeUnitKb:LYRA_DEFAULT_fileSizeUnitKb,fileSizeUnitMb:LYRA_DEFAULT_fileSizeUnitMb,fileSizeUnitTb:LYRA_DEFAULT_fileSizeUnitTb,map:LYRA_DEFAULT_map,navigation:LYRA_DEFAULT_navigation,noData:LYRA_DEFAULT_noData,noMatches:LYRA_DEFAULT_noMatches,open:LYRA_DEFAULT_open,popover:LYRA_DEFAULT_popover,progress:LYRA_DEFAULT_progress,restore:LYRA_DEFAULT_restore,search:LYRA_DEFAULT_search,select:LYRA_DEFAULT_select,selectAllSources:LYRA_DEFAULT_selectAllSources,sourceListDefaultLabel:LYRA_DEFAULT_sourceListDefaultLabel,sourcePickerSelection:LYRA_DEFAULT_sourcePickerSelection,valueInvalid:LYRA_DEFAULT_valueInvalid}}static{this.ownedCollectionProperties=Object.freeze(["sources","selectedSourceIds"])}static{this.styles=[LyraElement.styles,styles]}static{this.immutableEventDetails=Object.freeze(["lr-sources-change"])}connectedCallback(){super.connectedCallback(),this.announcementSink??=acquireAnnouncementSink("polite",{document:this.ownerDocument,source:this})}disconnectedCallback(){this.isMounting=!0,this.lastFilterAnnouncement="",this.announcementSink?.release(),this.announcementSink=void 0,super.disconnectedCallback()}get sourceModel(){if(this.normalizedInput===this.sources&&this.normalizedModel)return this.normalizedModel;const roots=[],nodes=[],byEntry=new WeakMap,seenObjects=new WeakSet,seenIds=new Set;let limited=!1;const stack=[];stack.push({sources:this.sources,target:roots,depth:0,index:0});let inspected=0;for(;stack.length;){const frame=stack[stack.length-1];if(frame.index>=frame.sources.length){stack.pop();continue}if(inspected>=MAX_SOURCE_NODES){limited=!0;break}const source=frame.sources[frame.index++];if(inspected++,!source||typeof source!="object"||seenObjects.has(source)||!isNonBlankIdentity(source.id)||seenIds.has(source.id)){limited=!0;continue}if(nodes.length>=MAX_SOURCE_NODES||frame.depth>MAX_SOURCE_DEPTH){limited=!0;continue}seenObjects.add(source),seenIds.add(source.id);const declaredGroup=Array.isArray(source.children),entry={id:source.id,label:source.label,...source.mimeType!==void 0?{mimeType:source.mimeType}:{},...source.name!==void 0?{name:source.name}:{},...declaredGroup?{children:[]}:{}},node={entry,depth:frame.depth,children:[],leafIds:[]};declaredGroup&&(entry.children=node.children.map(child=>child.entry)),frame.target.push(node),nodes.push(node),byEntry.set(entry,node);const children=source.children??[];children.length&&frame.depth>=MAX_SOURCE_DEPTH&&(limited=!0),children.length&&frame.depth<MAX_SOURCE_DEPTH&&stack.push({sources:children,target:node.children,depth:frame.depth+1,index:0})}for(let index=nodes.length-1;index>=0;index--){const node=nodes[index];node.entry.children!==void 0&&(node.entry.children=node.children.map(child=>child.entry)),node.leafIds=node.entry.children===void 0?[node.entry.id]:[...new Set(node.children.flatMap(child=>child.leafIds))]}const leafIds=[...new Set(roots.flatMap(root=>root.leafIds))];return this.normalizedInput=this.sources,this.normalizedModel={roots,nodes,byEntry,leafIds,limited},this.normalizedModel}allLeafIds(){return this.sourceModel.leafIds}descendantLeafIds(entry){return this.sourceModel.byEntry.get(entry)?.leafIds??[]}normalizedSelectedSourceIds(){const valid=new Set(this.allLeafIds()),seen=new Set;return this.selectedSourceIds.filter(id=>!valid.has(id)||seen.has(id)?!1:(seen.add(id),!0))}checkedState(entry){const leaves=this.descendantLeafIds(entry),selected=leaves.filter(id=>this.selectedSourceIds.includes(id));return selected.length===0?"false":selected.length===leaves.length?"true":"mixed"}matchesQuery(entry){return entry.label.toLocaleLowerCase(this.effectiveLocale).includes(this.query.trim().toLocaleLowerCase(this.effectiveLocale))}isFiltering(){return this.searchable&&this.query.trim().length>0}visibleRows(){const rows=[],filtering=this.isFiltering(),matches=new Set;if(filtering)for(let index=this.sourceModel.nodes.length-1;index>=0;index--){const node=this.sourceModel.nodes[index];(this.matchesQuery(node.entry)||node.children.some(child=>matches.has(child)))&&matches.add(node)}const stack=[...this.sourceModel.roots].reverse();for(;stack.length;){const node=stack.pop();if(filtering&&!matches.has(node))continue;const hasChildren=node.entry.children!==void 0;if(rows.push({entry:node.entry,depth:node.depth,hasChildren}),hasChildren&&(filtering||this.expandedIds.has(node.entry.id)))for(let index=node.children.length-1;index>=0;index--)stack.push(node.children[index])}return rows}willUpdate(changed){if(super.willUpdate(changed),changed.has("sources")||changed.has("selectedSourceIds")){const normalized=this.normalizedSelectedSourceIds();(normalized.length!==this.selectedSourceIds.length||normalized.some((id,index)=>id!==this.selectedSourceIds[index]))&&(this.selectedSourceIds=normalized)}if(!changed.has("sources")&&!changed.has("query")&&!changed.has("expandedIds"))return;const focusedIndex=Array.from(this.renderRoot.querySelectorAll('[part~="item"]')).indexOf(activeElementIn(this.shadowRoot)),rows=this.visibleRows(),retainedIndex=rows.findIndex(row=>row.entry.id===this.activeId),nextIndex=retainedIndex>=0?retainedIndex:rows.length?Math.min(Math.max(focusedIndex,0),rows.length-1):-1;this.activeId=nextIndex>=0?rows[nextIndex].entry.id:null,focusedIndex>=0&&(this.pendingFocusIndex=nextIndex>=0?nextIndex:this.sources.length===0||!this.searchable?"base":"search")}updated(changed){super.updated(changed);const pending=this.pendingFocusIndex;pending!==void 0&&(this.pendingFocusIndex=void 0,pending==="search"?this.renderRoot.querySelector('[part~="search"]')?.focus():pending==="base"?this.renderRoot.querySelector('[part="base"]')?.focus():this.renderRoot.querySelectorAll('[part~="item"]')[pending]?.focus());const wasMounting=this.isMounting;if(this.isMounting=!1,wasMounting||!changed.has("query")&&!changed.has("sources"))return;if(!this.isFiltering()){this.lastFilterAnnouncement="";return}const count=this.visibleRows().length,signature=`${this.query.trim().toLocaleLowerCase(this.effectiveLocale)}\0${count}`;signature!==this.lastFilterAnnouncement&&(this.lastFilterAnnouncement=signature,count===0&&this.announcementSink?.announce(this.localize("noMatches")))}commitSelection(next){this.selectedSourceIds=next,this.emit("lr-sources-change",{selectedSourceIds:next})}toggleEntry(entry){const leaves=this.descendantLeafIds(entry),willSelect=this.checkedState(entry)!=="true",set=new Set(this.selectedSourceIds);for(const id of leaves)willSelect?set.add(id):set.delete(id);this.commitSelection([...set])}toggleSelectAll(){const all=this.allLeafIds(),allSelected=all.length>0&&all.every(id=>this.selectedSourceIds.includes(id));this.commitSelection(allSelected?[]:all)}focusRowByIndex(index,rows){const targetId=rows[index]?.entry.id;if(!targetId)return;this.activeId=targetId;const generation=++this.keyboardFocusGeneration;this.updateComplete.then(()=>{if(!this.isConnected||generation!==this.keyboardFocusGeneration)return;const currentIndex=this.visibleRows().findIndex(row=>row.entry.id===targetId);if(currentIndex<0)return;this.renderRoot.querySelectorAll('[part~="item"]')[currentIndex]?.focus()})}renderRow(row,active){const state2=this.checkedState(row.entry),expanded=row.hasChildren&&(this.expandedIds.has(row.entry.id)||this.isFiltering());return html`
       <div
         part="item"
         role="treeitem"

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);
   }

package/dist/components/utility/icon/icon.styles.js

@@ -24,9 +24,6 @@ import{css}from"lit";const styles=css`
     justify-content: center;
   }
 
-  /* The custom-content slot is an assignment target only: syncCustomNodes() clones its trusted SVG
-     nodes into the component-owned svg above, where they have a real SVG parent and actually
-     paint. Rendering the slot itself would place the originals a second time, outside that svg. */
   slot {
     display: none;
   }
@@ -46,8 +43,6 @@ import{css}from"lit";const styles=css`
     block-size: var(--lr-icon-size, var(--lr-size-1-5em));
   }
 
-  /* Rotate and flip are deliberately physical, not direction-relative. Directional glyphs are
-     mirrored by the wrapping part of the component that owns their reading-order semantics. */
   :host(:where([rotate], [flip])) {
     transform: rotate(var(--lr-icon-rotate, 0deg))
       scale(
@@ -69,7 +64,6 @@ import{css}from"lit";const styles=css`
     --_lr-icon-flip-y: -1;
   }
 
-  /* Legacy Lyra alignment knob retained alongside the mirrored canvas vocabulary. */
   :host(:where([fixed-width])) {
     inline-size: var(--lr-icon-fixed-width, var(--lr-size-1-5em));
     block-size: var(--lr-icon-size, var(--lr-size-1em));

package/dist/components/utility/json-viewer/json-viewer.styles.js

@@ -1,15 +1,7 @@
 import{css}from"lit";const styles=css`
   :host {
     display: block;
-    /* Consumer-tunable scroll cap -- 'none' means the viewer grows with its
-       content, matching every other block-level component in this library
-       until a caller opts into an internal scrollbar via the max-height
-       attribute. */
     --_lr-json-viewer-max-height: none;
-    /* Contained here (rather than left as a bare font-family literal) so a
-       host page can retheme it, same rationale as --lr-widget-overlay-color
-       in widget.styles.ts -- no shared --lr-* monospace token exists
-       to resolve through. */
     --_lr-json-viewer-font: var(--lr-font-mono);
     --_lr-json-viewer-active-outline: var(--lr-focus-ring-color);
     --_lr-json-viewer-string-color: var(--lr-color-success);
@@ -43,13 +35,6 @@ import{css}from"lit";const styles=css`
   }
   [part="tree"] {
     padding: var(--lr-space-s);
-    /* A JSON tree's structure -- key, colon, value, brackets, indentation -- reads
-       left-to-right regardless of the surrounding document direction, exactly like
-       code and like every JSON view (devtools, VS Code). Without this, an ancestor
-       dir="rtl" reverses each row to value-colon-key order, right-aligns the tree, and
-       flips the disclosure chevrons, so the data reads backwards. A key/value that
-       itself contains RTL text still renders that run correctly via the bidi algorithm;
-       only the LTR scaffolding is pinned. Matches code-block's [part='pre'] lock. */
     direction: ltr;
   }
   .row {
@@ -62,17 +47,11 @@ import{css}from"lit";const styles=css`
   .row:hover {
     background: var(--lr-json-viewer-row-hover-bg, var(--lr-color-brand-quiet));
   }
-  /* :where() zeroes the wrapped selectors' specificity contribution, leaving only :hover/
-     :focus-within themselves -- (0,1,0) total, so a consumer's own ::part(copy-button):hover
-     override ((0,1,1)) wins without needing !important -- same fix shape as
-     lr-attachment-trigger's/lr-copy-button's own :where()-wrapped hover rule. */
-  :where(.row):hover :where([part="copy-button"]),
-  :where(.row):focus-within :where([part="copy-button"]) {
+  .row:hover [part="copy-button"],
+  .row:focus-within [part="copy-button"] {
     opacity: 1;
   }
   [part="toggle"] {
-    /* Keep the glyph compact while giving the interactive box the shared
-       minimum target size, even for deeply nested rows. */
     inline-size: var(--lr-size-1-25rem);
     block-size: var(--lr-size-1-25rem);
     min-inline-size: var(--lr-icon-button-size);
@@ -89,12 +68,6 @@ import{css}from"lit";const styles=css`
     border-radius: var(--lr-radius);
     cursor: pointer;
   }
-  /* The UA '[hidden] { display: none }' rule is author-overridable by any
-     same-origin declaration for that element regardless of specificity --
-     author rules always win over user-agent rules unless !important is
-     involved -- so this only needs to add visibility, not re-declare
-     display. Keeping the box (rather than display:none) preserves this
-     leaf/empty row's alignment with sibling rows that do have a chevron. */
   [part="toggle"][hidden] {
     visibility: hidden;
   }
@@ -106,13 +79,6 @@ import{css}from"lit";const styles=css`
   [part="toggle"][aria-expanded="true"] .chevron {
     transform: rotate(90deg);
   }
-  /* No RTL chevron override: [part='tree'] above is pinned direction:ltr, so a collapsed
-     row's disclosure chevron always points at the LTR-positioned children (to the right),
-     the same as it does in an LTR document. */
-  /* :where() zeroes the wrapped selectors' specificity contribution, leaving only :hover itself
-     -- (0,1,0) total, so a consumer's own ::part(toggle):hover override ((0,1,1)) wins without
-     needing !important -- same fix shape as lr-attachment-trigger's/lr-copy-button's own
-     :where()-wrapped hover rule. */
   :where([part="toggle"]):hover:where(:not([hidden])) {
     background: var(--lr-color-brand-quiet);
     color: var(--lr-color-brand);
@@ -130,9 +96,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);
   }
-  /* Stands in for [part='toggle'] on the closing-bracket row, so it must match the toggle's
-     actual used inline-size -- min-inline-size wins over the toggle's own smaller inline-size,
-     so the real box is --lr-icon-button-size, not --lr-size-1-25rem. */
   .toggle-space {
     inline-size: var(--lr-icon-button-size);
     flex: 0 0 auto;
@@ -153,9 +116,6 @@ import{css}from"lit";const styles=css`
     flex: 0 0 auto;
     color: var(--lr-color-text-quiet);
   }
-  /* --lr-json-viewer-match-bg indirection (rather than the bare --lr-color-warning-quiet token)
-     lets a consumer retheme just this component's search-match highlight without repainting
-     every other warning-toned surface on the page that reads the same shared token. */
   [part="key"][data-match],
   [part="value"][data-match] {
     background: var(--lr-json-viewer-match-bg, var(--lr-color-warning-quiet));
@@ -227,9 +187,6 @@ import{css}from"lit";const styles=css`
     background: var(--lr-color-brand-quiet);
     color: var(--lr-color-brand);
   }
-  /* This is also the pressed state for the row-hover reveal rule further up: that rule only fades
-     the button in when its row is hovered, it is not itself a hover treatment on the button, and the
-     button's own held state belongs here next to its hover. */
   [part="copy-button"]:active {
     background: color-mix(
       in oklab,
@@ -238,9 +195,6 @@ import{css}from"lit";const styles=css`
     );
     color: var(--lr-color-brand);
   }
-  /* Per-node copy buttons stay out of the way until the row is actually
-     being interacted with -- the toolbar's own top-level copy button is
-     exempt (it has no ancestor .row, so this rule never matches it). */
   .row [part="copy-button"] {
     opacity: 0;
   }

package/dist/components/utility/known-date/known-date.class.d.ts

@@ -99,8 +99,9 @@ declare const LyraKnownDate_base: typeof LyraKnownDateBase & (new (...args: any[
  * @csspart fieldset - The `<fieldset>` grouping the three fields.
  * @csspart legend - The `<legend>` element.
  * @csspart form-control-label - The visible label wrapper inside the legend.
- * @csspart label - Deprecated in 8.0.0; compatibility alias for `form-control-label`, retained
- *   until at least 10.0.0.
+ * @csspart label - Deprecated in 8.0.0; compatibility alias for `form-control-label`. Web Awesome
+ *   still publishes its own deprecated `label` part on `<wa-known-date>`, so this alias stays on
+ *   the same node until upstream drops it.
  * @csspart fields - The row wrapping the three field blocks.
  * @csspart form-control-input - Alias on the fields row matching other form controls.
  * @csspart field - Each field block (label + input), repeated three times; distinguished by
@@ -233,7 +234,10 @@ export declare class LyraKnownDate extends LyraKnownDate_base {
     private readonly dayId;
     private readonly monthId;
     private readonly yearId;
-    /** Hidden native date mirror used by integrations that inspect native constraints directly. */
+    /** Hidden native date mirror used by integrations that inspect native constraints directly.
+     *  Stays a writable `@query` field rather than a readonly `get`: `wa-known-date` declares it
+     *  writable, and check-pinned-upstream-manifests treats a readonly-vs-writable difference on a
+     *  mirrored member as an `unsupported` surface drift -- a release blocker. */
     valueInput: HTMLInputElement;
     private validationTargetOverride?;
     constructor();

package/dist/components/utility/known-date/known-date.styles.js

@@ -1,52 +1,33 @@
 import{css}from"lit";const styles=css`
   :host {
     display: block;
-    /* Every per-tier value below comes from the library's one shared size ladder
-       (internal/sizes.styles.ts), which re-points --lr-form-control-* per :host([size='...']) and
-       matches BOTH spellings of every tier in the same selector list -- so small/medium/large work
-       here for free. This component's own --lr-known-date-field-* surface is unchanged and still
-       the documented override point; only the values behind it moved, which is what keeps a
-       birthdate field the same height as the <lr-input>/<lr-date-input> beside it in a form row at
-       every tier instead of drifting from a hand-kept copy of that scale. */
     --_lr-known-date-field-padding-block: var(--lr-form-control-padding-block);
     --_lr-known-date-field-padding-inline: var(
       --lr-form-control-padding-inline
     );
     --_lr-known-date-field-font-size: var(--lr-form-control-font-size);
-    /* Not --lr-form-control-gap: that knob is the rhythm between one control's own inline
-       affordances, an order of magnitude tighter than the gap between three separate field
-       blocks. Constant across tiers by design. */
     --_lr-known-date-field-gap: var(--lr-space-s);
+    --_lr-known-date-field-fill: var(--lr-color-surface);
+    --_lr-known-date-field-border-color: var(--lr-color-border);
     --_lr-known-date-year-field-width: var(--lr-size-5em);
     --_lr-known-date-day-field-width: var(--lr-size-3-5em);
     --_lr-known-date-month-field-width: var(--lr-size-3-5em);
-    /* max() rather than the bare ladder height: the ladder's 2xs tier resolves to 1.25rem/20px,
-       and a field a pointer has to hit floors at WCAG 2.2 SC 2.5.8's 24px minimum. Above that the
-       floor tracks the ladder exactly. At the small tiers the floor exceeds the field's own
-       padding/font-driven content height and actively pins the rendered box; at l/xl the content
-       height stays under it, so the floor is inert there. */
     --_lr-known-date-field-min-height: max(
       var(--lr-form-control-height),
       var(--lr-size-24px)
     );
-    /* --lr-known-date-field-height is intentionally NOT declared here. It is a consumer-facing
-       exact-height escape hatch consumed only through the var() fallbacks on [part='field-input']
-       below; declaring any value for it (even 'auto') would make those fallback arms unreachable
-       and turn --lr-known-date-field-min-height into dead code (the lr-select trap). Left
-       undeclared, both arms stay live: the per-tier floor falls out of the fallback, and setting
-       the property pins an exact height. */
   }
 
   [part~="form-control"] {
     min-inline-size: 0;
   }
 
-  :host([appearance="filled"]) [part="field-input"] {
-    border-color: transparent;
-    background: var(--lr-color-surface-raised);
+  :host([appearance="filled"]) {
+    --_lr-known-date-field-border-color: transparent;
+    --_lr-known-date-field-fill: var(--lr-color-surface-raised);
   }
-  :host([appearance="filled-outlined"]) [part="field-input"] {
-    background: var(--lr-color-surface-raised);
+  :host([appearance="filled-outlined"]) {
+    --_lr-known-date-field-fill: var(--lr-color-surface-raised);
   }
   :host([pill]) [part="field-input"] {
     border-radius: var(--lr-radius-pill);
@@ -68,22 +49,9 @@ import{css}from"lit";const styles=css`
     font-weight: var(--lr-font-weight-semibold);
     overflow-wrap: anywhere;
   }
-  /* [part] always contains a literal <slot> child regardless of assigned
-     content, so :empty never matches -- real emptiness is tracked in JS
-     (hasLabelSlot) and reflected via [hidden] instead (same fix as every
-     other lyra form control's label/hint/error chrome). Without this the
-     required marker below (attached to this box) would render a stray glyph
-     with nothing before it whenever no label is set. */
   [part="legend"][hidden] {
     display: none;
   }
-  /* The one component that does NOT take its marker rule from
-     internal/form-control.styles.ts, only its custom properties. That sheet
-     attaches the marker to [part~="form-control-label"], which here is a span
-     INSIDE this legend; the marker belongs to the legend box itself, after the
-     whole label, so the selector is local while the glyph, colour and offset
-     stay the same three consumer-settable properties every other control
-     resolves. Keep these declarations identical to that sheet's. */
   :host([required]) [part="legend"]::after {
     content: var(--lr-form-control-required-content, ' *');
     color: var(--lr-form-control-required-color, var(--lr-color-danger));
@@ -117,8 +85,6 @@ import{css}from"lit";const styles=css`
         var(--_lr-known-date-field-min-height)
       )
     );
-    /* Pinned only when --lr-known-date-field-height is set; 'auto' otherwise, so the field keeps
-       growing to fit its own padding/font content. */
     block-size: var(--lr-known-date-field-height, auto);
     padding-block: var(
       --lr-known-date-field-padding-block,
@@ -128,9 +94,10 @@ import{css}from"lit";const styles=css`
       --lr-known-date-field-padding-inline,
       var(--_lr-known-date-field-padding-inline)
     );
-    border: var(--lr-border-width-thin) solid var(--lr-color-border);
+    border: var(--lr-border-width-thin) solid
+      var(--_lr-known-date-field-border-color);
     border-radius: var(--lr-form-control-radius);
-    background: var(--lr-color-surface);
+    background: var(--_lr-known-date-field-fill);
     color: var(--lr-color-text);
     font-family: inherit;
     font-size: var(
@@ -157,11 +124,6 @@ import{css}from"lit";const styles=css`
       var(--_lr-known-date-year-field-width)
     );
   }
-  /* Mouse-hover parity with the keyboard :focus-visible ring below -- same border-retint
-     treatment as lr-color-picker's own bordered [part='input']:hover.
-     no-pressed-state: a press on a number 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 below, which is the state that actually persists and communicates. */
   [part="field-input"]:hover {
     border-color: var(--lr-color-brand);
   }
@@ -169,9 +131,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);
   }
-  /* --lr-known-date-invalid-border-color indirection (rather than the bare --lr-color-danger
-     token) lets a consumer retheme just this component's invalid-field border without
-     repainting every other component in the app that reads the same shared danger token. */
   :host([data-invalid]) [part="field-input"] {
     border-color: var(
       --lr-known-date-invalid-border-color,

package/dist/components/utility/live-region/live-region.styles.js

@@ -1,8 +1,4 @@
 import{css}from"lit";const styles=css`
-  /* The host contributes no box of its own -- \`.sr-only\` (composed in via
-     internal/a11y.ts's shared \`srOnly\`) already takes the single child out
-     of flow via absolute positioning, so a wrapping host box would just be
-     an empty, purposeless inline element sitting in the document. */
   :host {
     display: contents;
   }

package/dist/components/utility/mention-popover/mention-popover.styles.js

@@ -3,17 +3,10 @@ import{css}from"lit";const styles=css`
     display: contents;
   }
 
-  /* Positioned by internal/positioner.js's place() -- same fixed/z-index
-     shape as lr-combobox's/lr-select's own [part='listbox']. Closed
-     state: invisible + slightly raised, transitioning in on :host([open]),
-     same as those two. */
   [part='listbox'] {
     position: fixed;
     z-index: var(--lr-layer-dropdown);
     box-sizing: border-box;
-    /* Clamped against internal/positioner.js's place()-published available-space custom
-       properties (see menu.styles.ts's/combobox.styles.ts's identical [part='listbox']
-       treatment) so this popup can't overflow off-screen on a short/keyboard-shrunk viewport. */
     max-block-size: min(var(--lr-size-16rem), var(--lr-positioner-available-block-size, var(--lr-size-16rem)));
     overflow-y: auto;
     overflow-x: clip;
@@ -24,7 +17,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 listbox floating over page content, not a modal layer. */
     box-shadow: var(--lr-shadow-m);
     visibility: hidden;
     opacity: 0;
@@ -56,19 +48,10 @@ import{css}from"lit";const styles=css`
     border-radius: var(--lr-radius);
     cursor: pointer;
   }
-  /* --lr-mention-popover-option-active-bg indirection (rather than the bare --lr-color-brand-quiet
-     token) lets a consumer retheme just this component's highlighted/active suggestion row
-     without repainting every other component that reuses the same shared brand-quiet token --
-     same indirection lr-select's/lr-combobox's identical-looking [part='option'][data-active]
-     background is missing (checklist's own named example for this check). */
   [part='option']:hover,
   [part='option'][data-active] {
     background: var(--lr-mention-popover-option-active-bg, var(--lr-color-brand-quiet));
   }
-  /* Mixed from the same overridable highlight the hover/active-row rule uses, so a consumer who
-     retints --lr-mention-popover-option-active-bg gets a matching pressed state for free. This also
-     serves the [part='option-description'] hover rule below, which is a descendant treatment of this
-     same row rather than a hover state of its own. */
   [part='option']:active {
     background: color-mix(
       in oklab,
@@ -104,14 +87,6 @@ import{css}from"lit";const styles=css`
     text-overflow: ellipsis;
     white-space: nowrap;
   }
-  /* --lr-color-text-quiet-on-brand-quiet fails WCAG AA (~4.24:1, needs
-     4.5:1) -- unlike lr-combobox's/lr-select's identical-looking
-     [part='option'][data-active] background (which never has this problem
-     in practice, since those default their active index to -1/none until a
-     user actually arrows through the list), this component always opens
-     with row 0 pre-highlighted (see the activeIndex field's own doc), so the
-     active/quiet-text combination is the default state, not an edge case --
-     it must pass contrast on its own. */
   [part='option']:hover [part='option-description'],
   [part='option'][data-active] [part='option-description'] {
     color: var(--lr-color-text);

package/dist/components/utility/poll-status/poll-status.styles.js

@@ -15,10 +15,6 @@ import{css}from"lit";const styles=css`
     block-size: var(--lr-size-0-375rem);
     border-radius: var(--lr-radius-pill);
     background: var(--lr-color-brand);
-    /* Same token/rationale as lr-stream-status's and lr-typing-indicator's
-       own looping pulse: --lr-transition-ambient is the length the library
-       reserves for ambient "still alive" motion, so every looping indicator
-       shares one calm rhythm instead of hand-rolling its own duration. */
     animation: lr-poll-status-pulse var(--lr-transition-ambient) infinite;
   }
   [part='indicator'][data-due] {