@aceshooting/lyra-ui 29.0.2 → 29.1.0

package/dist/components/data/calendar/calendar.class.d.ts

@@ -1,4 +1,4 @@
-import{type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraDatePickerFirstDayOfWeek}from'../../forms/date-picker/date-picker.class.js';export interface CalendarEvent{readonly id?:string;readonly date:string|number|Date;readonly title:string;readonly color?:string;readonly data?:unknown;}export interface LyraCalendarEventMap{'lr-date-select':CustomEvent<{date:string;}>;'lr-event-select':CustomEvent<{event:CalendarEvent;}>;'lr-view-change':CustomEvent<{viewDate:string;}>;}
+import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraDatePickerFirstDayOfWeek}from'../../forms/date-picker/date-picker.class.js';export interface CalendarEvent{readonly id?:string;readonly date:string|number|Date;readonly title:string;readonly color?:string;readonly data?:unknown;}export interface LyraCalendarEventMap{'lr-date-select':CustomEvent<{date:string;}>;'lr-event-select':CustomEvent<{event:CalendarEvent;}>;'lr-view-change':CustomEvent<{viewDate:string;}>;}
 /** The two display modes `view` accepts. */
 export type CalendarView='month'|'agenda';
 /** The shared closed weekday vocabulary `lr-date-picker`/`lr-date-input` already accept
@@ -16,6 +16,8 @@ export type LyraCalendarFirstDayOfWeek=LyraDatePickerFirstDayOfWeek;
 * foreground/background pairing during hover and press; callers remain responsible for choosing
 * accessible custom event colors.
 *
+* Events retain at most the first 10,000 entries as detached readonly sequences; records retain
+* caller identity without deep cloning. The limit notice discloses omitted input in either view.
 * Public collection properties take bounded, detached readonly sequences. Calendar-only fields
 * are projected from own data descriptors once per assignment; `lr-event-select` retains the
 * caller's original event identity. Create a new collection and reassign it after changes;
@@ -35,6 +37,7 @@ export type LyraCalendarFirstDayOfWeek=LyraDatePickerFirstDayOfWeek;
 * @event lr-date-select - A calendar date was selected.
 * @event lr-event-select - An event was selected.
 * @event lr-view-change - The visible month changed.
+* @csspart limit - Input admission limit notice.
 * @csspart header - Calendar header.
 * @csspart navigation - Wrapper around both month-navigation controls and the title.
 * @csspart nav - Either month-navigation button.
@@ -76,4 +79,4 @@ export declare class LyraCalendar extends LyraElement<LyraCalendarEventMap>{prot
 *  `id`/`data`, or matched by reference in an imperative callback) -- only the sequence itself
 *  is bounded/detached/frozen; the emitted `lr-event-select` detail must carry the exact object
 *  the caller passed in `events`, not a structural clone. */
-protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];events:readonly CalendarEvent[];value:string;viewDate:string;private _view;get view():CalendarView;set view(value:CalendarView);firstDayOfWeek:LyraCalendarFirstDayOfWeek;accessibleLabel:string;private focusedDate;private get viewStart();private get normalizedFirstDayOfWeek();private changeMonth;private selectDate;private get effectiveEvents();private buckets?;private cachedBuckets;private bucketEventsByDate;private weeks;private gridBounds;private onDayKeyDown;private weekdays;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-calendar':LyraCalendar;}}
+protected static readonly identityCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];events:readonly CalendarEvent[];value:string;viewDate:string;private _view;get view():CalendarView;set view(value:CalendarView);firstDayOfWeek:LyraCalendarFirstDayOfWeek;accessibleLabel:string;private focusedDate;private get viewStart();private get normalizedFirstDayOfWeek();private changeMonth;private selectDate;private get effectiveEvents();private buckets?;private cachedBuckets;private bucketEventsByDate;private agendaMemo?;private agendaEvents;private weeks;private gridBounds;private onDayKeyDown;private weekdays;private readonly announcements;private initialLimitUpdate;private lastLimitNotice;private inputLimitMessage;protected updated(changed:PropertyValues):void;adoptedCallback():void;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-calendar':LyraCalendar;}}

package/dist/components/data/calendar/calendar.class.js

@@ -1,2 +1,2 @@
-import{__decorate}from"tslib";import{collectionSupport}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{literalSetConverter}from"../../../internal/converters.js";import{styleMap}from"lit/directives/style-map.js";import{LyraElement}from"../../../internal/lyra-element.js";import{addMonthsClampingDay,formatISO,localDate,monthMatrix,parseISO,resolveFirstDayOfWeek,weekdayLabels}from"../../forms/date-picker/calendar-core.js";import{sanitizeCssColor}from"../../../internal/safe-css.js";import{styles}from"./calendar.styles.js";import{getDateTimeFormat,getNumberFormat}from"../../../internal/intl-cache.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR,getOwnDataDescriptor}from"../../../internal/data-descriptors.js";import{LYRA_DEFAULT_calendarEmpty,LYRA_DEFAULT_calendarEventsOverflow,LYRA_DEFAULT_calendarLabel,LYRA_DEFAULT_calendarNextMonth,LYRA_DEFAULT_calendarPreviousMonth}from"../../../internal/default-strings/data.generated.js";const monthStart=date=>localDate(date.getFullYear(),date.getMonth(),1),MAX_DAY_CELL_EVENTS=4,MAX_AGENDA_EVENTS=500,canonicalEventSnapshots=new WeakMap;function normalizeCalendarEventDate(value){if(typeof value=="string"){const date=parseISO(value);return date?formatISO(date):void 0}if(typeof value=="number"){if(!Number.isFinite(value))return;const date=new Date(value);return Number.isNaN(date.getTime())?void 0:formatISO(date)}if(!(value===null||typeof value!="object"))try{const epoch=Date.prototype.getTime.call(value);return Number.isFinite(epoch)?formatISO(new Date(epoch)):void 0}catch{return}}function isSafeNonArrayObject(value){if(value===null||typeof value!="object")return!1;try{return!Array.isArray(value)}catch{return!1}}function projectCalendarEvent(value){if(!isSafeNonArrayObject(value))return;const date=getOwnDataDescriptor(value,"date"),title=getOwnDataDescriptor(value,"title"),color=getOwnDataDescriptor(value,"color");if(date===MISSING_OWN_DATA_DESCRIPTOR||date===UNSAFE_OWN_DATA_DESCRIPTOR||title===MISSING_OWN_DATA_DESCRIPTOR||title===UNSAFE_OWN_DATA_DESCRIPTOR||typeof title.value!="string"||title.value.trim().length===0)return;const normalizedDate=normalizeCalendarEventDate(date.value);if(normalizedDate)return Object.freeze({source:value,date:normalizedDate,title:title.value,color:color===MISSING_OWN_DATA_DESCRIPTOR||color===UNSAFE_OWN_DATA_DESCRIPTOR||typeof color.value!="string"?void 0:color.value})}function canonicalCalendarEvents(values){const cached=canonicalEventSnapshots.get(values);if(cached)return cached;const projected=[];for(const value of values){const event=projectCalendarEvent(value);event&&projected.push(event)}const snapshot=Object.freeze(projected);return canonicalEventSnapshots.set(values,snapshot),snapshot}const CALENDAR_VIEW=literalSetConverter(["month","agenda"],"month");class LyraCalendar extends LyraElement{constructor(){super(...arguments),this.events=[],this.value="",this.viewDate=formatISO(new Date).slice(0,7)+"-01",this._view="month",this.firstDayOfWeek="auto",this.accessibleLabel="",this.focusedDate=""}static{this.defaultStrings={...super.defaultStrings,calendarEmpty:LYRA_DEFAULT_calendarEmpty,calendarEventsOverflow:LYRA_DEFAULT_calendarEventsOverflow,calendarLabel:LYRA_DEFAULT_calendarLabel,calendarNextMonth:LYRA_DEFAULT_calendarNextMonth,calendarPreviousMonth:LYRA_DEFAULT_calendarPreviousMonth}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["events"])}static{this.identityCollectionProperties=Object.freeze(["events"])}static{this.styles=[LyraElement.styles,styles]}get view(){return this._view}set view(value){const normalized=CALENDAR_VIEW.normalizeReflected(this,"view",value),previous=this._view;previous!==normalized&&(this._view=normalized,this.requestUpdate("view",previous))}get viewStart(){const parsed=parseISO(this.viewDate);return monthStart(parsed||new Date)}get normalizedFirstDayOfWeek(){return resolveFirstDayOfWeek(this.firstDayOfWeek,this.effectiveLocale)}changeMonth(delta){const next=localDate(this.viewStart.getFullYear(),this.viewStart.getMonth()+delta,1);this.viewDate=formatISO(next),this.emit("lr-view-change",{viewDate:this.viewDate})}selectDate(date){this.value=date,this.focusedDate=date,this.emit("lr-date-select",{date})}get effectiveEvents(){return canonicalCalendarEvents(this.events)}cachedBuckets(events){return this.buckets?.[0]!==events&&(this.buckets=[events,this.bucketEventsByDate(events)]),this.buckets[1]}bucketEventsByDate(events){const buckets=new Map;for(const event of events){const bucket=buckets.get(event.date);bucket?bucket.push(event):buckets.set(event.date,[event])}return buckets}weeks(){const start=this.viewStart;return monthMatrix(start.getFullYear(),start.getMonth(),this.normalizedFirstDayOfWeek)}gridBounds(weeks){return[weeks[0][0],weeks[weeks.length-1][6]]}onDayKeyDown(event,date){const rtl=this.effectiveDirection==="rtl",year=date.getFullYear(),month=date.getMonth(),day=date.getDate();let next;switch(event.key){case"ArrowLeft":next=localDate(year,month,day+(rtl?1:-1));break;case"ArrowRight":next=localDate(year,month,day+(rtl?-1:1));break;case"ArrowUp":next=localDate(year,month,day-7);break;case"ArrowDown":next=localDate(year,month,day+7);break;case"PageUp":next=addMonthsClampingDay(date,-1);break;case"PageDown":next=addMonthsClampingDay(date,1);break;case"Home":next=localDate(year,month,1);break;case"End":next=localDate(year,month+1,0);break;case"Enter":case" ":event.preventDefault(),this.selectDate(formatISO(date));return;default:return}event.preventDefault();const[gridFirst,gridLast]=this.gridBounds(this.weeks());(next<gridFirst||next>gridLast)&&(this.viewDate=formatISO(monthStart(next)),this.emit("lr-view-change",{viewDate:this.viewDate})),this.focusedDate=formatISO(next),queueMicrotask(()=>this.renderRoot.querySelector(`[data-date="${this.focusedDate}"]`)?.focus())}weekdays(){return weekdayLabels(this.normalizedFirstDayOfWeek,"short",this.effectiveLocale)}render(){const start=this.viewStart,weeks=this.weeks(),monthTitle=getDateTimeFormat(this.effectiveLocale,{month:"long",year:"numeric"}).format(start),today=formatISO(new Date),label=hostAriaLabel(this)??this.localize("calendarLabel"),dayLabelFmt=getDateTimeFormat(this.effectiveLocale,{dateStyle:"full"}),agendaDateFmt=getDateTimeFormat(this.effectiveLocale,{dateStyle:"medium"}),dayNumberFmt=getNumberFormat(this.effectiveLocale),events=this.effectiveEvents,monthPrefix=formatISO(start).slice(0,7),agenda=this.view==="agenda"?events.filter(event=>event.date.startsWith(monthPrefix)).sort((a,b)=>a.date<b.date?-1:a.date>b.date?1:0):[],agendaTruncated=agenda.length>MAX_AGENDA_EVENTS,renderedAgenda=agenda.slice(0,MAX_AGENDA_EVENTS),eventsByDate=this.view==="month"?this.cachedBuckets(events):void 0,[gridFirst,gridLast]=this.gridBounds(weeks),rawAnchor=this.focusedDate||this.value||today,rawAnchorDate=parseISO(rawAnchor),anchor=rawAnchorDate&&rawAnchorDate>=gridFirst&&rawAnchorDate<=gridLast?rawAnchor:formatISO(start);return html`<section aria-label=${label}><header part="header navigation"><button part="nav previous-button" type="button" aria-label=${this.localize("calendarPreviousMonth")} @click=${()=>this.changeMonth(-1)}><span part="nav-glyph" aria-hidden="true">‹</span></button><span part="title">${monthTitle}</span><button part="nav next-button" type="button" aria-label=${this.localize("calendarNextMonth")} @click=${()=>this.changeMonth(1)}><span part="nav-glyph" aria-hidden="true">›</span></button></header>
+import{__decorate}from"tslib";import{collectionSupport,publicCollectionTruncation}from"../../../internal/collection-snapshot.js";import{html,nothing}from"lit";import{property,state}from"lit/decorators.js";import{literalSetConverter}from"../../../internal/converters.js";import{styleMap}from"lit/directives/style-map.js";import{LyraElement}from"../../../internal/lyra-element.js";import{addMonthsClampingDay,formatISO,localDate,monthMatrix,parseISO,resolveFirstDayOfWeek,weekdayLabels}from"../../forms/date-picker/calendar-core.js";import{sanitizeCssColor}from"../../../internal/safe-css.js";import{styles}from"./calendar.styles.js";import{getDateTimeFormat,getNumberFormat}from"../../../internal/intl-cache.js";import{AnnouncementSinkController}from"../../../internal/announcer.js";import{hostAriaLabel}from"../../../internal/a11y.js";import{MISSING_OWN_DATA_DESCRIPTOR,UNSAFE_OWN_DATA_DESCRIPTOR,getOwnDataDescriptor}from"../../../internal/data-descriptors.js";import{LYRA_DEFAULT_calendarEmpty,LYRA_DEFAULT_calendarEventsOverflow,LYRA_DEFAULT_calendarInputLimit,LYRA_DEFAULT_calendarLabel,LYRA_DEFAULT_calendarNextMonth,LYRA_DEFAULT_calendarPreviousMonth}from"../../../internal/default-strings/data.generated.js";const monthStart=date=>localDate(date.getFullYear(),date.getMonth(),1),MAX_DAY_CELL_EVENTS=4,MAX_AGENDA_EVENTS=500,canonicalEventSnapshots=new WeakMap;function normalizeCalendarEventDate(value){if(typeof value=="string"){const date=parseISO(value);return date?formatISO(date):void 0}if(typeof value=="number"){if(!Number.isFinite(value))return;const date=new Date(value);return Number.isNaN(date.getTime())?void 0:formatISO(date)}if(!(value===null||typeof value!="object"))try{const epoch=Date.prototype.getTime.call(value);return Number.isFinite(epoch)?formatISO(new Date(epoch)):void 0}catch{return}}function isSafeNonArrayObject(value){if(value===null||typeof value!="object")return!1;try{return!Array.isArray(value)}catch{return!1}}function projectCalendarEvent(value){if(!isSafeNonArrayObject(value))return;const date=getOwnDataDescriptor(value,"date"),title=getOwnDataDescriptor(value,"title"),color=getOwnDataDescriptor(value,"color");if(date===MISSING_OWN_DATA_DESCRIPTOR||date===UNSAFE_OWN_DATA_DESCRIPTOR||title===MISSING_OWN_DATA_DESCRIPTOR||title===UNSAFE_OWN_DATA_DESCRIPTOR||typeof title.value!="string"||title.value.trim().length===0)return;const normalizedDate=normalizeCalendarEventDate(date.value);if(normalizedDate)return Object.freeze({source:value,date:normalizedDate,title:title.value,color:color===MISSING_OWN_DATA_DESCRIPTOR||color===UNSAFE_OWN_DATA_DESCRIPTOR||typeof color.value!="string"?void 0:color.value})}function canonicalCalendarEvents(values){const cached=canonicalEventSnapshots.get(values);if(cached)return cached;const projected=[];for(const value of values){const event=projectCalendarEvent(value);event&&projected.push(event)}const snapshot=Object.freeze(projected);return canonicalEventSnapshots.set(values,snapshot),snapshot}const CALENDAR_VIEW=literalSetConverter(["month","agenda"],"month");class LyraCalendar extends LyraElement{constructor(){super(...arguments),this.events=[],this.value="",this.viewDate=formatISO(new Date).slice(0,7)+"-01",this._view="month",this.firstDayOfWeek="auto",this.accessibleLabel="",this.focusedDate="",this.announcements=new AnnouncementSinkController(this),this.initialLimitUpdate=!0,this.lastLimitNotice=""}static{this.defaultStrings={...super.defaultStrings,calendarEmpty:LYRA_DEFAULT_calendarEmpty,calendarEventsOverflow:LYRA_DEFAULT_calendarEventsOverflow,calendarInputLimit:LYRA_DEFAULT_calendarInputLimit,calendarLabel:LYRA_DEFAULT_calendarLabel,calendarNextMonth:LYRA_DEFAULT_calendarNextMonth,calendarPreviousMonth:LYRA_DEFAULT_calendarPreviousMonth}}static{this.collectionSupport=collectionSupport}static{this.ownedCollectionProperties=Object.freeze(["events"])}static{this.identityCollectionProperties=Object.freeze(["events"])}static{this.styles=[LyraElement.styles,styles]}get view(){return this._view}set view(value){const normalized=CALENDAR_VIEW.normalizeReflected(this,"view",value),previous=this._view;previous!==normalized&&(this._view=normalized,this.requestUpdate("view",previous))}get viewStart(){const parsed=parseISO(this.viewDate);return monthStart(parsed||new Date)}get normalizedFirstDayOfWeek(){return resolveFirstDayOfWeek(this.firstDayOfWeek,this.effectiveLocale)}changeMonth(delta){const next=localDate(this.viewStart.getFullYear(),this.viewStart.getMonth()+delta,1);this.viewDate=formatISO(next),this.emit("lr-view-change",{viewDate:this.viewDate})}selectDate(date){this.value=date,this.focusedDate=date,this.emit("lr-date-select",{date})}get effectiveEvents(){return canonicalCalendarEvents(this.events)}cachedBuckets(events){return this.buckets?.[0]!==events&&(this.buckets=[events,this.bucketEventsByDate(events)]),this.buckets[1]}bucketEventsByDate(events){const buckets=new Map;for(const event of events){const bucket=buckets.get(event.date);bucket?bucket.push(event):buckets.set(event.date,[event])}return buckets}agendaEvents(events,month){return(this.agendaMemo?.events!==events||this.agendaMemo.month!==month)&&(this.agendaMemo={events,month,rows:events.filter(event=>event.date.startsWith(month)).sort((a,b)=>a.date<b.date?-1:a.date>b.date?1:0)}),this.agendaMemo.rows}weeks(){const start=this.viewStart;return monthMatrix(start.getFullYear(),start.getMonth(),this.normalizedFirstDayOfWeek)}gridBounds(weeks){return[weeks[0][0],weeks[weeks.length-1][6]]}onDayKeyDown(event,date){const rtl=this.effectiveDirection==="rtl",year=date.getFullYear(),month=date.getMonth(),day=date.getDate();let next;switch(event.key){case"ArrowLeft":next=localDate(year,month,day+(rtl?1:-1));break;case"ArrowRight":next=localDate(year,month,day+(rtl?-1:1));break;case"ArrowUp":next=localDate(year,month,day-7);break;case"ArrowDown":next=localDate(year,month,day+7);break;case"PageUp":next=addMonthsClampingDay(date,-1);break;case"PageDown":next=addMonthsClampingDay(date,1);break;case"Home":next=localDate(year,month,1);break;case"End":next=localDate(year,month+1,0);break;case"Enter":case" ":event.preventDefault(),this.selectDate(formatISO(date));return;default:return}event.preventDefault();const[gridFirst,gridLast]=this.gridBounds(this.weeks());(next<gridFirst||next>gridLast)&&(this.viewDate=formatISO(monthStart(next)),this.emit("lr-view-change",{viewDate:this.viewDate})),this.focusedDate=formatISO(next),queueMicrotask(()=>this.renderRoot.querySelector(`[data-date="${this.focusedDate}"]`)?.focus())}weekdays(){return weekdayLabels(this.normalizedFirstDayOfWeek,"short",this.effectiveLocale)}inputLimitMessage(){const limit=publicCollectionTruncation(this,"events");return limit?this.localize("calendarInputLimit",void 0,{count:getNumberFormat(this.effectiveLocale).format(limit.retained),total:getNumberFormat(this.effectiveLocale).format(limit.source)}):""}updated(changed){super.updated(changed);const notice=this.inputLimitMessage();!this.initialLimitUpdate&&notice&&notice!==this.lastLimitNotice&&this.announcements.announcePolite(notice),this.initialLimitUpdate=!1,this.lastLimitNotice=notice}adoptedCallback(){super.adoptedCallback(),this.announcements.adopted()}render(){const start=this.viewStart,weeks=this.weeks(),monthTitle=getDateTimeFormat(this.effectiveLocale,{month:"long",year:"numeric"}).format(start),today=formatISO(new Date),label=hostAriaLabel(this)??this.localize("calendarLabel"),dayLabelFmt=getDateTimeFormat(this.effectiveLocale,{dateStyle:"full"}),agendaDateFmt=getDateTimeFormat(this.effectiveLocale,{dateStyle:"medium"}),dayNumberFmt=getNumberFormat(this.effectiveLocale),events=this.effectiveEvents,monthPrefix=formatISO(start).slice(0,7),agenda=this.view==="agenda"?this.agendaEvents(events,monthPrefix):[],agendaTruncated=agenda.length>MAX_AGENDA_EVENTS,renderedAgenda=agenda.slice(0,MAX_AGENDA_EVENTS),eventsByDate=this.view==="month"?this.cachedBuckets(events):void 0,[gridFirst,gridLast]=this.gridBounds(weeks),rawAnchor=this.focusedDate||this.value||today,rawAnchorDate=parseISO(rawAnchor),anchor=rawAnchorDate&&rawAnchorDate>=gridFirst&&rawAnchorDate<=gridLast?rawAnchor:formatISO(start),inputLimit=this.inputLimitMessage();return html`<section aria-label=${label}>${inputLimit?html`<p part="limit">${inputLimit}</p>`:nothing}<header part="header navigation"><button part="nav previous-button" type="button" aria-label=${this.localize("calendarPreviousMonth")} @click=${()=>this.changeMonth(-1)}><span part="nav-glyph" aria-hidden="true">‹</span></button><span part="title">${monthTitle}</span><button part="nav next-button" type="button" aria-label=${this.localize("calendarNextMonth")} @click=${()=>this.changeMonth(1)}><span part="nav-glyph" aria-hidden="true">›</span></button></header>
       ${this.view==="agenda"?html`<div part="agenda">${agenda.length?html`${renderedAgenda.map(event=>{const date=parseISO(event.date),bg=event.color?sanitizeCssColor(event.color):void 0;return html`<button part="agenda-event" type="button" style=${styleMap(bg?{"--_lr-calendar-agenda-event-background":bg,"--_lr-calendar-agenda-event-foreground":"var(--lr-color-on-brand)"}:{})} @click=${()=>this.emit("lr-event-select",{event:event.source})}><strong>${date?agendaDateFmt.format(date):event.date}</strong> ${event.title}</button>`})}${agendaTruncated?html`<span part="agenda-limit">${this.localize("calendarEventsOverflow",void 0,{n:getNumberFormat(this.effectiveLocale).format(agenda.length-MAX_AGENDA_EVENTS)})}</span>`:nothing}`:html`<p part="empty">${this.localize("calendarEmpty")}</p>`}</div>`:html`<div part="weekdays">${this.weekdays().map(day=>html`<span part="weekday">${day}</span>`)}</div><div part="grid" role="grid" aria-label=${monthTitle}>${weeks.map(week=>html`<div part="week" role="row">${week.map(date=>{const dateIso=formatISO(date),dayEvents=eventsByDate?.get(dateIso)??[],dayTruncated=dayEvents.length>MAX_DAY_CELL_EVENTS;return html`<div part="day" role="gridcell" data-date=${dateIso} data-outside=${date.getMonth()!==start.getMonth()?"true":"false"} data-today=${dateIso===today?"true":"false"} data-selected=${dateIso===this.value?"true":"false"} aria-selected=${dateIso===this.value?"true":"false"} aria-current=${dateIso===today?"date":nothing} aria-label=${dayLabelFmt.format(date)} tabindex=${dateIso===anchor?"0":"-1"} @click=${event=>{(event.target===event.currentTarget||event.target.getAttribute("part")==="date")&&this.selectDate(dateIso)}} @keydown=${event=>{event.target===event.currentTarget&&this.onDayKeyDown(event,date)}}><span part="date">${dayNumberFmt.format(date.getDate())}</span>${dayEvents.slice(0,MAX_DAY_CELL_EVENTS).map(item=>{const bg=item.color?sanitizeCssColor(item.color):void 0;return html`<button part="event" type="button" style=${styleMap(bg?{backgroundColor:bg}:{})} @click=${event=>{event.stopPropagation(),this.emit("lr-event-select",{event:item.source})}}>${item.title}</button>`})}${dayTruncated?html`<span part="event-limit">${this.localize("calendarEventsOverflow",void 0,{n:getNumberFormat(this.effectiveLocale).format(dayEvents.length-MAX_DAY_CELL_EVENTS)})}</span>`:nothing}</div>`})}</div>`)}</div>`}</section>`}}__decorate([property({attribute:!1})],LyraCalendar.prototype,"events",void 0),__decorate([property()],LyraCalendar.prototype,"value",void 0),__decorate([property({attribute:"view-date"})],LyraCalendar.prototype,"viewDate",void 0),__decorate([property({reflect:!0,converter:CALENDAR_VIEW})],LyraCalendar.prototype,"view",null),__decorate([property({attribute:"first-day-of-week"})],LyraCalendar.prototype,"firstDayOfWeek",void 0),__decorate([property({attribute:"aria-label"})],LyraCalendar.prototype,"accessibleLabel",void 0),__decorate([state()],LyraCalendar.prototype,"focusedDate",void 0);export{LyraCalendar};

package/dist/components/data/data-grid/data-grid-processing.js

@@ -1,2 +1,2 @@
-import{getCollator,resolveIntlLocale}from"../../../internal/intl-cache.js";import{UNSAFE_LEADING}from"../../utility/export-button/csv.js";function columnId(column,_index){return typeof column.id=="string"&&column.id.trim()!==""?column.id:typeof column.field=="string"&&column.field.trim()!==""?column.field:""}function pathValue(value,path){if(!path)return;let current=value;for(const segment of path.split(".")){if(typeof current!="object"||current===null)return;current=current[segment]}return current}function columnValue(column,row){return column.value?column.value(row):column.field?pathValue(row,column.field):void 0}function comparableText(value){if(value==null)return"";if(value instanceof Date)return Number.isFinite(value.getTime())?value.toISOString():"";if(Array.isArray(value))return value.map(comparableText).join(" ");if(typeof value=="object")try{return JSON.stringify(value,(_key,nested)=>typeof nested=="bigint"?nested.toString():nested)??""}catch{return""}return String(value)}function numericDate(value){if(value instanceof Date)return Number.isFinite(value.getTime())?value.getTime():void 0;if(typeof value=="number")return Number.isFinite(value)?value:void 0;if(typeof value=="string"){const parsed=Date.parse(value);return Number.isFinite(parsed)?parsed:void 0}}function finiteValue(value){if(typeof value=="string"&&value.trim()==="")return;const number=typeof value=="number"?value:Number(value);return Number.isFinite(number)?number:void 0}function valuesFromFilter(value){return Array.isArray(value)?value:value instanceof Set?[...value]:value==null||value===""?[]:[value]}function valuesFromCell(value){return Array.isArray(value)?value:value instanceof Set?[...value]:[value]}function sameValue(left,right,collator){return Object.is(left,right)?!0:collator().compare(comparableText(left),comparableText(right))===0}const DATE_ONLY=/^(\d{4})-(\d{2})-(\d{2})$/;function localCalendarDay(value){if(typeof value!="string")return;const match=DATE_ONLY.exec(value.trim());if(!match)return;const year=Number(match[1]),month=Number(match[2])-1,day=Number(match[3]),date=new Date(0);return date.setFullYear(year,month,day),date.setHours(0,0,0,0),date.getFullYear()===year&&date.getMonth()===month&&date.getDate()===day?date.getTime():void 0}function matchesRange(value,filter,date){if(!Array.isArray(filter))return!0;const[rawStart,rawEnd]=filter,read=date?candidate=>localCalendarDay(candidate)??numericDate(candidate):finiteValue,current=read(value);if(current===void 0)return!1;const start=read(rawStart),end=read(rawEnd);if(start!==void 0&&current<start)return!1;if(end!==void 0){if(date){const inclusiveEnd=new Date(end);if(inclusiveEnd.setHours(23,59,59,999),current>inclusiveEnd.getTime())return!1}else if(current>end)return!1}return!0}function matchesFilter(row,column,filter,locale){const intlLocale=resolveIntlLocale(locale),value=columnValue(column,row);if(column.filterFn)return!!column.filterFn(value,filter,row);const type=column.filterType??"text";if(type==="number-range")return matchesRange(value,filter,!1);if(type==="date-range")return matchesRange(value,filter,!0);let collator;const comparison=()=>collator??=getCollator(intlLocale,{sensitivity:"base",numeric:!0});if(type==="equals")return comparison().compare(comparableText(value),comparableText(filter))===0;const needles=valuesFromFilter(filter);if(needles.length===0)return!0;const values=valuesFromCell(value);return type==="set"||type==="includes-any"?needles.some(needle=>values.some(candidate=>sameValue(candidate,needle,comparison))):type==="includes-all"?needles.every(needle=>values.some(candidate=>sameValue(candidate,needle,comparison))):comparableText(value).toLocaleLowerCase(intlLocale).includes(comparableText(filter).toLocaleLowerCase(intlLocale))}function filterRows(rows,columns,filters,locale){if(filters.length===0)return[...rows];const byId=new Map(columns.map((column,index)=>[columnId(column,index),column]));return rows.filter(row=>filters.every(filter=>{const column=byId.get(filter.id);return!column||matchesFilter(row,column,filter.value,locale)}))}function searchRows(rows,columns,term,locale,searchFn){const intlLocale=resolveIntlLocale(locale),needle=term.trim();if(!needle)return[...rows];const searchable=columns.filter(column=>(column.field||column.value)&&column.searchable!==!1),normalizedNeedle=searchFn?"":needle.toLocaleLowerCase(intlLocale);return rows.filter(row=>searchable.some(column=>{const value=columnValue(column,row);return searchFn?!!searchFn(value,needle,row):comparableText(value).toLocaleLowerCase(intlLocale).includes(normalizedNeedle)}))}function undefinedRank(column,left,right){const leftMissing=left==null||typeof left=="number"&&!Number.isFinite(left),rightMissing=right==null||typeof right=="number"&&!Number.isFinite(right);if(leftMissing===rightMissing)return;const policy=column.sortUndefined??"last";return leftMissing===(policy==="first"||policy===-1)?-1:1}function cellText(cell){return cell.text??=comparableText(cell.value)}function cellTime(cell){return cell.time===void 0&&(cell.time=numericDate(cell.value)??null),cell.time??void 0}function cellComparator(column,locale){const comparator=column.comparator;if(comparator)return(left,right,leftRow,rightRow)=>comparator(left.value,right.value,leftRow,rightRow);const algorithm=column.sortFn??"alphanumeric",caseSensitive=algorithm==="alphanumericCaseSensitive"||algorithm==="textCaseSensitive",numeric=algorithm==="alphanumeric"||algorithm==="alphanumericCaseSensitive";let collator;return(left,right)=>{if(algorithm==="datetime"){const leftTime=cellTime(left),rightTime=cellTime(right);if(leftTime!==void 0&&rightTime!==void 0)return leftTime-rightTime}return algorithm==="basic"&&typeof left.value=="number"&&typeof right.value=="number"?left.value-right.value:(collator??=getCollator(locale,{sensitivity:caseSensitive?"variant":"base",numeric}),collator.compare(cellText(left),cellText(right)))}}function sortRows(rows,columns,sorting,locale){if(sorting.length===0)return[...rows];const byId=new Map(columns.map((column,index)=>[columnId(column,index),column])),active=[];for(const sort of sorting){const column=byId.get(sort.id);column&&active.push({desc:sort.desc,column,compare:cellComparator(column,locale)})}return rows.map((row,index)=>({row,index,cells:active.map(({column})=>({value:columnValue(column,row)}))})).sort((left,right)=>{for(let position=0;position<active.length;position+=1){const{desc,column,compare}=active[position],leftCell=left.cells[position],rightCell=right.cells[position],missing=undefinedRank(column,leftCell.value,rightCell.value);if(missing!==void 0)return typeof(column.sortUndefined??"last")=="string"?missing:desc?-missing:missing;const compared=compare(leftCell,rightCell,left.row,right.row);if(compared!==0)return desc?-compared:compared}return left.index-right.index}).map(({row})=>row)}function aggregateValues(aggregation,rows,values){if(typeof aggregation=="function")return aggregation(rows,values);if(aggregation==="count")return rows.length;const defined=values.filter(value=>value!=null);if(aggregation==="unique")return[...new Set(defined)];if(aggregation==="uniqueCount")return new Set(defined).size;const numeric=defined.map(finiteValue).filter(value=>value!==void 0);if(numeric.length===0)return aggregation==="extent"?[]:void 0;if(aggregation==="sum"||aggregation==="mean"){let scale=0;for(const value of numeric)scale=Math.max(scale,Math.abs(value));let scaledTotal=0;if(scale>0)for(const value of numeric)scaledTotal+=value/scale;const result=scale===0?0:aggregation==="sum"?scaledTotal*scale:scaledTotal/numeric.length*scale;return Number.isFinite(result)?result:void 0}if(aggregation==="median"){const sorted=[...numeric].sort((left2,right2)=>left2-right2),middle=Math.floor(sorted.length/2);if(sorted.length%2!==0)return sorted[middle];const left=sorted[middle-1]??0,right=sorted[middle]??0,median=Math.sign(left)===Math.sign(right)?left+(right-left)/2:left/2+right/2;return Number.isFinite(median)?median:void 0}let minimum=numeric[0],maximum=minimum;for(const value of numeric)value<minimum&&(minimum=value),value>=maximum&&(maximum=value);return aggregation==="min"?minimum:aggregation==="max"?maximum:[minimum,maximum]}function csvCell(value,delimiter,escapeFormulas){let text=comparableText(value);return escapeFormulas&&typeof value!="number"&&UNSAFE_LEADING.test(text)&&(text=`'${text}`),(text.includes(delimiter)||/[\x22\r\n]/u.test(text))&&(text=`"${text.replaceAll('"','""')}"`),text}function rowsAsDelimited(rows,columns,options={}){const delimiter=options.delimiter??",",includeHeaders=options.includeHeaders??!0,escapeFormulas=options.escapeFormulas??!0,requested=options.columnIds?new Set(options.columnIds):void 0,visible=columns.filter((column,index)=>column.hidden!==!0&&(!requested||requested.has(columnId(column,index)))),lines=[];includeHeaders&&lines.push(visible.map((column,index)=>csvCell(column.label??columnId(column,index),delimiter,!1)).join(delimiter));for(const row of rows)lines.push(visible.map(column=>csvCell(columnValue(column,row),delimiter,escapeFormulas)).join(delimiter));return lines.join(`\r
-`)}export{aggregateValues,columnId,columnValue,filterRows,matchesFilter,pathValue,rowsAsDelimited,searchRows,sortRows};
+import{getCollator,resolveIntlLocale}from"../../../internal/intl-cache.js";import{UNSAFE_LEADING}from"../../utility/export-button/csv.js";function columnId(column,_index){return typeof column.id=="string"&&column.id.trim()!==""?column.id:typeof column.field=="string"&&column.field.trim()!==""?column.field:""}function pathValue(value,path){if(!path)return;let current=value;for(const segment of path.split(".")){if(typeof current!="object"||current===null)return;current=current[segment]}return current}function columnValue(column,row){return column.value?column.value(row):column.field?pathValue(row,column.field):void 0}function comparableText(value){if(value==null)return"";if(value instanceof Date)return Number.isFinite(value.getTime())?value.toISOString():"";if(Array.isArray(value))return value.map(comparableText).join(" ");if(typeof value=="object")try{return JSON.stringify(value,(_key,nested)=>typeof nested=="bigint"?nested.toString():nested)??""}catch{return""}return String(value)}function numericDate(value){if(value instanceof Date)return Number.isFinite(value.getTime())?value.getTime():void 0;if(typeof value=="number")return Number.isFinite(value)?value:void 0;if(typeof value=="string"){const parsed=Date.parse(value);return Number.isFinite(parsed)?parsed:void 0}}function finiteValue(value){if(typeof value=="string"&&value.trim()==="")return;const number=typeof value=="number"?value:Number(value);return Number.isFinite(number)?number:void 0}function valuesFromFilter(value){return Array.isArray(value)?value:value instanceof Set?[...value]:value==null||value===""?[]:[value]}function valuesFromCell(value){return Array.isArray(value)?value:value instanceof Set?[...value]:[value]}function sameValue(left,right,collator){return Object.is(left,right)?!0:collator().compare(comparableText(left),comparableText(right))===0}const DATE_ONLY=/^(\d{4})-(\d{2})-(\d{2})$/;function localCalendarDay(value){if(typeof value!="string")return;const match=DATE_ONLY.exec(value.trim());if(!match)return;const year=Number(match[1]),month=Number(match[2])-1,day=Number(match[3]),date=new Date(0);return date.setFullYear(year,month,day),date.setHours(0,0,0,0),date.getFullYear()===year&&date.getMonth()===month&&date.getDate()===day?date.getTime():void 0}function matchesRange(value,filter,date){if(!Array.isArray(filter))return!0;const[rawStart,rawEnd]=filter,read=date?candidate=>localCalendarDay(candidate)??numericDate(candidate):finiteValue,current=read(value);if(current===void 0)return!1;const start=read(rawStart),end=read(rawEnd);if(start!==void 0&&current<start)return!1;if(end!==void 0){if(date){const inclusiveEnd=new Date(end);if(inclusiveEnd.setHours(23,59,59,999),current>inclusiveEnd.getTime())return!1}else if(current>end)return!1}return!0}function matchesFilter(row,column,filter,locale){const intlLocale=resolveIntlLocale(locale),value=columnValue(column,row);if(column.filterFn)return!!column.filterFn(value,filter,row);const type=column.filterType??"text";if(type==="number-range")return matchesRange(value,filter,!1);if(type==="date-range")return matchesRange(value,filter,!0);let collator;const comparison=()=>collator??=getCollator(intlLocale,{sensitivity:"base",numeric:!0});if(type==="equals")return comparison().compare(comparableText(value),comparableText(filter))===0;const needles=valuesFromFilter(filter);if(needles.length===0)return!0;const values=valuesFromCell(value);return type==="set"||type==="includes-any"?needles.some(needle=>values.some(candidate=>sameValue(candidate,needle,comparison))):type==="includes-all"?needles.every(needle=>values.some(candidate=>sameValue(candidate,needle,comparison))):comparableText(value).toLocaleLowerCase(intlLocale).includes(comparableText(filter).toLocaleLowerCase(intlLocale))}function textFilterCorpus(locale){const intlLocale=resolveIntlLocale(locale),columns=new Map;return(column,row)=>{let cells=columns.get(column);cells||(cells=new Map,columns.set(column,cells));let text=cells.get(row);return text===void 0&&(text=comparableText(columnValue(column,row)).toLocaleLowerCase(intlLocale),cells.set(row,text)),text}}function filterRows(rows,columns,filters,locale,textFor){if(filters.length===0)return[...rows];const byId=new Map(columns.map((column,index)=>[columnId(column,index),column])),predicates=filters.flatMap(filter=>{const column=byId.get(filter.id);if(!column)return[];if(!column.filterFn&&(column.filterType===void 0||column.filterType==="text")){if(valuesFromFilter(filter.value).length===0)return[_row=>!0];const intlLocale=resolveIntlLocale(locale),needle=comparableText(filter.value).toLocaleLowerCase(intlLocale);return[row=>(textFor?textFor(column,row):comparableText(columnValue(column,row)).toLocaleLowerCase(intlLocale)).includes(needle)]}if(!column.filterFn&&(column.filterType==="number-range"||column.filterType==="date-range")&&Array.isArray(filter.value)){const date=column.filterType==="date-range",read=date?value=>localCalendarDay(value)??numericDate(value):finiteValue,start=read(filter.value[0]);let end=read(filter.value[1]);if(date&&end!==void 0){const dayEnd=new Date(end);dayEnd.setHours(23,59,59,999),end=dayEnd.getTime()}return[row=>{const value=read(columnValue(column,row));return value!==void 0&&(start===void 0||value>=start)&&(end===void 0||value<=end)}]}return[row=>matchesFilter(row,column,filter.value,locale)]});return rows.filter(row=>predicates.every(predicate=>predicate(row)))}function searchHaystacks(rows,columns,locale){const intlLocale=resolveIntlLocale(locale),searchable=columns.filter(column=>(column.field||column.value)&&column.searchable!==!1);return new Map(rows.map(row=>[row,searchable.map(column=>comparableText(columnValue(column,row)).toLocaleLowerCase(intlLocale))]))}function searchRows(rows,columns,term,locale,searchFn,haystacks){const intlLocale=resolveIntlLocale(locale),needle=term.trim();if(!needle)return[...rows];const searchable=columns.filter(column=>(column.field||column.value)&&column.searchable!==!1),normalizedNeedle=searchFn?"":needle.toLocaleLowerCase(intlLocale);return!searchFn&&haystacks?rows.filter(row=>haystacks.get(row)?.some(value=>value.includes(normalizedNeedle))):rows.filter(row=>searchable.some(column=>{const value=columnValue(column,row);return searchFn?!!searchFn(value,needle,row):comparableText(value).toLocaleLowerCase(intlLocale).includes(normalizedNeedle)}))}function undefinedRank(column,left,right){const leftMissing=left==null||typeof left=="number"&&!Number.isFinite(left),rightMissing=right==null||typeof right=="number"&&!Number.isFinite(right);if(leftMissing===rightMissing)return;const policy=column.sortUndefined??"last";return leftMissing===(policy==="first"||policy===-1)?-1:1}function cellText(cell){return cell.text??=comparableText(cell.value)}function cellTime(cell){return cell.time===void 0&&(cell.time=numericDate(cell.value)??null),cell.time??void 0}function cellComparator(column,locale){const comparator=column.comparator;if(comparator)return(left,right,leftRow,rightRow)=>comparator(left.value,right.value,leftRow,rightRow);const algorithm=column.sortFn??"alphanumeric",caseSensitive=algorithm==="alphanumericCaseSensitive"||algorithm==="textCaseSensitive",numeric=algorithm==="alphanumeric"||algorithm==="alphanumericCaseSensitive";let collator;return(left,right)=>{if(algorithm==="datetime"){const leftTime=cellTime(left),rightTime=cellTime(right);if(leftTime!==void 0&&rightTime!==void 0)return leftTime-rightTime}return algorithm==="basic"&&typeof left.value=="number"&&typeof right.value=="number"?left.value-right.value:(collator??=getCollator(locale,{sensitivity:caseSensitive?"variant":"base",numeric}),collator.compare(cellText(left),cellText(right)))}}function sortRows(rows,columns,sorting,locale){if(sorting.length===0)return[...rows];const byId=new Map(columns.map((column,index)=>[columnId(column,index),column])),active=[];for(const sort of sorting){const column=byId.get(sort.id);column&&active.push({desc:sort.desc,column,compare:cellComparator(column,locale)})}return rows.map((row,index)=>({row,index,cells:active.map(({column})=>({value:columnValue(column,row)}))})).sort((left,right)=>{for(let position=0;position<active.length;position+=1){const{desc,column,compare}=active[position],leftCell=left.cells[position],rightCell=right.cells[position],missing=undefinedRank(column,leftCell.value,rightCell.value);if(missing!==void 0)return typeof(column.sortUndefined??"last")=="string"?missing:desc?-missing:missing;const compared=compare(leftCell,rightCell,left.row,right.row);if(compared!==0)return desc?-compared:compared}return left.index-right.index}).map(({row})=>row)}function aggregateValues(aggregation,rows,values){if(typeof aggregation=="function")return aggregation(rows,values);if(aggregation==="count")return rows.length;const defined=values.filter(value=>value!=null);if(aggregation==="unique")return[...new Set(defined)];if(aggregation==="uniqueCount")return new Set(defined).size;const numeric=defined.map(finiteValue).filter(value=>value!==void 0);if(numeric.length===0)return aggregation==="extent"?[]:void 0;if(aggregation==="sum"||aggregation==="mean"){let scale=0;for(const value of numeric)scale=Math.max(scale,Math.abs(value));let scaledTotal=0;if(scale>0)for(const value of numeric)scaledTotal+=value/scale;const result=scale===0?0:aggregation==="sum"?scaledTotal*scale:scaledTotal/numeric.length*scale;return Number.isFinite(result)?result:void 0}if(aggregation==="median"){const sorted=[...numeric].sort((left2,right2)=>left2-right2),middle=Math.floor(sorted.length/2);if(sorted.length%2!==0)return sorted[middle];const left=sorted[middle-1]??0,right=sorted[middle]??0,median=Math.sign(left)===Math.sign(right)?left+(right-left)/2:left/2+right/2;return Number.isFinite(median)?median:void 0}let minimum=numeric[0],maximum=minimum;for(const value of numeric)value<minimum&&(minimum=value),value>=maximum&&(maximum=value);return aggregation==="min"?minimum:aggregation==="max"?maximum:[minimum,maximum]}function csvCell(value,delimiter,escapeFormulas){let text=comparableText(value);return escapeFormulas&&typeof value!="number"&&UNSAFE_LEADING.test(text)&&(text=`'${text}`),(text.includes(delimiter)||/[\x22\r\n]/u.test(text))&&(text=`"${text.replaceAll('"','""')}"`),text}function rowsAsDelimited(rows,columns,options={}){const delimiter=options.delimiter??",",includeHeaders=options.includeHeaders??!0,escapeFormulas=options.escapeFormulas??!0,requested=options.columnIds?new Set(options.columnIds):void 0,visible=columns.filter((column,index)=>column.hidden!==!0&&(!requested||requested.has(columnId(column,index)))),lines=[];includeHeaders&&lines.push(visible.map((column,index)=>csvCell(column.label??columnId(column,index),delimiter,!1)).join(delimiter));for(const row of rows)lines.push(visible.map(column=>csvCell(columnValue(column,row),delimiter,escapeFormulas)).join(delimiter));return lines.join(`\r
+`)}export{aggregateValues,columnId,columnValue,filterRows,matchesFilter,pathValue,rowsAsDelimited,searchHaystacks,searchRows,sortRows,textFilterCorpus};

package/dist/components/data/data-grid/data-grid.class.d.ts

@@ -9,7 +9,7 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * loading stays silent; each later transition into loading appends the localized loading text to
 * the document's shared light-DOM polite sink while the visible overlay remains non-live. Public
 * collections are clone-owned readonly snapshots. Nested rows are projected iteratively with a
-* 10,000-node/64-descendant-level budget and a localized limit notice. Column identities use a
+* maxRows-node/64-descendant-level budget (10,000 nodes by default) and a localized limit notice. Column identities use a
 * nonblank `id`, then a nonblank `field`, then stable definition-object occurrence; blank and
 * later-duplicate identities are omitted first-wins. With `rowKey`, malformed, blank, and later
 * duplicate row identities are omitted first-wins; without it, row object occurrence is stable
@@ -33,6 +33,13 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * failure to replace the row content instead sets `error = true` from its own `lr-data-error`
 * listener.
 *
+* Wide grids mount only the inline viewport plus overscan, pinned columns, and the focused column.
+* Above 50 columns, CSS-resolved widths stay stable while scrolling; newly mounted content fits
+* those widths. Column definitions/widths, row projection, allocation, font changes and explicit
+* refresh recalculate them. Header, body and footer share these tracks.
+* Expanded detail blocks remain part of their virtual row. `--max-height: none` explicitly opts
+* out of row virtualization. Columns retain at most 10,000 definitions.
+*
 * @customElement lr-data-grid
 * @slot empty - Content rendered when the source has no rows.
 * @slot loading - Content rendered over the grid while data is loading.
@@ -166,9 +173,9 @@ import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from
 * @csspart sort-number - Multi-sort priority number.
 * @csspart table - Grid table wrapper.
 * @csspart toolbar - Search and column controls.
-* @csspart tree-limit - Localized notice rendered when nested input exceeds the 10,000-node or
+* @csspart tree-limit - Localized notice rendered when nested input exceeds the maxRows node or
 *   64-descendant-level projection budget.
-* @csspart row-limit - Localized notice rendered when flat input exceeds 10,000 rows.
+* @csspart row-limit - Localized notice rendered when flat input exceeds maxRows rows.
 * @cssprop [--accent-color=var(--lr-color-brand)] - Accent used by focus and active states.
 * @cssprop [--background-color=var(--lr-color-surface)] - Grid background.
 * @cssprop [--border-color=var(--lr-color-border)] - Border color of the grid's controls (search,
@@ -223,11 +230,18 @@ childRows:string|((row:Row)=>readonly Row[]|undefined)|null;private readonly ass
 get columnOrder():readonly string[];set columnOrder(value:readonly string[]);private readonly columnOccurrenceIds;private nextColumnOccurrenceId;private readonly rowOccurrenceIds;private nextRowOccurrenceId;private _columns;
 /** Clone-owned readonly column-definition sequence. Reassign to update.
 * @default [] */
-get columns():readonly DataGridColumn<Row>[];set columns(value:readonly DataGridColumn<Row>[]);private _data;
+get columns():readonly DataGridColumn<Row>[];set columns(value:readonly DataGridColumn<Row>[]);
+/** Maximum admitted rows, including tree descendants; bounded from 1 to 100,000.
+* Set before data, then reassign data to restore previously excluded rows. */
+maxRows:number;private get rowLimit();private dataAdmissionTruncated;private dataAdmissionLimit;private _data;
 /** Clone-owned readonly client rows or current server page. Row identities are preserved.
+* Admission inspects at most maxRows source positions, retaining own data properties only.
+* Set maxRows before assigning data; reassign the source to restore excluded rows.
 * @default [] */
 get data():readonly Row[];set data(value:readonly Row[]);
-/** Async server loader. Providing one enables server behavior. */
+/** Async server loader. Providing one enables server behavior. A changed query aborts and
+* invalidates the previous request before waiting for `filterDebounce`; stale results cannot
+* replace the current query's rows, even when a loader ignores its abort signal. */
 dataSource:((request:DataGridRequest)=>Promise<DataGridResponse<Row>>)|null;private _expandedRowKeys;
 /** Clone-owned controlled expanded tree/detail/group row keys. */
 get expandedRowKeys():readonly DataGridKey[];set expandedRowKeys(value:readonly DataGridKey[]);
@@ -235,7 +249,7 @@ get expandedRowKeys():readonly DataGridKey[];set expandedRowKeys(value:readonly
 get expandedKeys():readonly DataGridKey[];set expandedKeys(value:readonly DataGridKey[]);
 /** Delay before server search/filter requests. */
 filterDebounce:number;
-/** Whether the client row projection omitted rows: more than 10,000 total rows (roots plus
+/** Whether the client row projection omitted rows: more than maxRows total rows (roots plus
 *  nested children) or nesting deeper than 64 levels. The `tree-limit` notice renders then. */
 get dataTruncated():boolean;
 /** Number of rows after client search and filters, before paging. */
@@ -338,7 +352,7 @@ withColumnsMenu:boolean;
 /** Keeps a sorted column in ascending/descending states instead of removing its sort. */
 withoutSortRemoval:boolean;
 /** Shows the global search field. */
-withSearch:boolean;private columnWidths;private columnVisibility;private columnPinning;private activeFilterColumn;private columnsMenuOpen;private activeColumnMenu;private liveText;private bodyScrollTop;private bodyScrollInlineOffset;private viewportHeight;private focusedRow;private focusedColumn;private dragGhost;private activeResizeColumn;private bodyElement?;private requestGeneration;private requestController?;private readonly requestDebounce;private ownsLoadingState;private resizeSession?;private readonly resizePointer;private columnDragSession?;private columnDragSequence;private managedOverlay?;private managedOverlayOwner;private lastSelectedIndex;private isMounting;private pipelineEpoch;private contentRefreshPending;private readonly pipelineMemo;private memoize;private readonly measuredItemHeights;private measuredItemOffsets;private measuredItemOffsetSignature;private measuredItemOffsetEstimate;private measuredItemOffsetsDirty;private measurementLocale;private measurementDisplaySignature;private measurementRowHeight;private measurementFontSignature;private lastMeasurementAnchor?;private measuredBodyWidth;private bodyScrollbarInlineEndGutter;private rowMeasurementObserver?;private rowMeasurementObserverOwner?;private rowMeasurementObserverBody?;private readonly observedMeasurementElements;private readonly observedMeasurementBlockSizes;private measurementUpdateQueued;private measurementScrollSyncQueued;private bodyScrollStateSyncQueued;private measurementFrame?;private expectedBodyScroll?;private pendingVirtualScroll?;private sink?;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;protected willUpdate(changed:PropertyValues<this>):void;private renderedDisplayItems?;private renderedColumns?;private restoreCellFocus;private followRovingCell;protected firstUpdated(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;private get currentManagedOverlayOwner();private managedOverlayElements;private dismissManagedOverlay;private syncManagedOverlay;private closeComposedColumnsMenu;private openColumnsPanel;private toggleFilterPanel;private toggleColumnPanel;private announce;private get usesServerData();private get safePage();private get safePageSize();private get safeTotal();private sourceProjection;private computeSourceProjection;private get allSourceRows();private get canonicalRootRows();private sourceIndexMap;private sourceIndexFor;private canonicalRowIndex;private canonicalMembers;private get orderedColumns();private computeOrderedColumns;private get visibleColumns();private get processedClientRows();private computeProcessedClientRows;private childrenFor;private rowIdentity;private keyForRow;private renderedColumnElements;private computedToken;
+withSearch:boolean;private columnWidths;private columnVisibility;private columnPinning;private activeFilterColumn;private columnsMenuOpen;private activeColumnMenu;private liveText;private bodyScrollTop;private bodyScrollInlineOffset;private viewportHeight;private focusedRow;private focusedColumn;private dragGhost;private activeResizeColumn;private bodyElement?;private requestGeneration;private requestController?;private serverRequestInputs?;private readonly requestDebounce;private ownsLoadingState;private resizeSession?;private readonly resizePointer;private columnDragSession?;private columnDragSequence;private managedOverlay?;private managedOverlayOwner;private lastSelectedIndex;private isMounting;private pipelineEpoch;private contentRefreshPending;private readonly pipelineMemo;private memoize;private readonly measuredItemHeights;private measuredOffsetTree;private measuredOffsetHeights;private measuredItemOffsetSignature;private measuredItemOffsetEstimate;private measuredItemOffsetsDirty;private measurementLocale;private measurementDisplaySignature;private measurementRowHeight;private measurementFontSignature;private measurementFontHasRendered;private lastMeasurementAnchor?;private measuredBodyWidth;private bodyScrollbarInlineEndGutter;private rowMeasurementObserver?;private rowMeasurementObserverOwner?;private rowMeasurementObserverBody?;private readonly observedMeasurementElements;private readonly observedMeasurementBlockSizes;private measurementUpdateQueued;private measurementScrollSyncQueued;private bodyScrollStateSyncQueued;private measurementFrame?;private expectedBodyScroll?;private pendingVirtualScroll?;private sink?;connectedCallback():void;disconnectedCallback():void;adoptedCallback():void;requestUpdate(...args:Parameters<LyraElement['requestUpdate']>):void;protected willUpdate(changed:PropertyValues<this>):void;private renderedDisplayItems?;private renderedColumns?;private restoreCellFocus;private followRovingCell;protected firstUpdated(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;private get currentManagedOverlayOwner();private managedOverlayElements;private dismissManagedOverlay;private syncManagedOverlay;private closeComposedColumnsMenu;private openColumnsPanel;private toggleFilterPanel;private toggleColumnPanel;private announce;private get usesServerData();private get safePage();private get safePageSize();private get safeTotal();private sourceProjection;private computeSourceProjection;private get allSourceRows();private get canonicalRootRows();private sourceIndexMap;private sourceIndexFor;private canonicalRowIndex;private canonicalMembers;private get orderedColumns();private computeOrderedColumns;private get columnIndex();private get visibleColumns();private get processedClientRows();private get filterText();private computeProcessedClientRows;private childrenFor;private readChildren;private rowIdentity;private keyForRow;private renderedColumnElements;private computedToken;
 /** Sizes one column to its rendered header and cell contents. */
 autoSizeColumn(columnId:string):void;
 /** Sizes every visible column to its rendered contents. */
@@ -394,4 +408,4 @@ setState(state:DataGridState):void;
 * proportionally across flexible columns, preserving each column's min/max bounds. */
 sizeColumnsToFit():void;
 /** Shows or hides one column without emitting the user-only visibility event. */
-toggleColumn(columnId:string,visible:boolean):void;private validColumnMap;private delimitedRows;private copyAndReport;private writeClipboard;private setColumnWidth;private cancelRequestTimer;private scheduleServerRequest;private loadServerData;private get selectionEnabled();private get ariaColumnCount();private rowIsSelectable;private rowMatches;private processedChildrenFor;private hasMatchingDescendant;private get pageRows();private get currentPageSelectableRows();private computeCurrentPageSelectableRows;private groupMemberKey;private groupKey;private topLevelGroupBuckets;private computeTopLevelGroupBuckets;private groupItems;private get displayItems();private computeDisplayItems;private groupedDisplayItems;private signatureItems?;private signatureValue;private measurementSignature;private invalidateRowMeasurements;private reconcileRowMeasurementCache;private recordMeasurementRowHeight;private currentMeasurementFontSignature;private recordMeasuredBodyWidth;private syncMeasuredBodyWidth;private syncBodyScrollbarInlineEndGutter;private queueMeasurementUpdate;private queueMeasuredScrollTop;private queueBodyScrollStateSync;private scheduleMeasurementSync;private cancelMeasurementFrame;private resetRowMeasurementObserver;private syncRowMeasurementObserver;private displayItemOffsets;private displayItemOffset;private displayItemHeight;private displayItemIndexAtOffset;private captureMeasurementAnchor;private measurementAnchorAtOffset;private pendingMeasurementAnchor?;private correctMeasurementAnchor;private measureRenderedItems;private layoutBorderBoxHeight;private renderedRowAlignmentDelta;private renderedStartPrecisionDelta;private alignPendingVirtualScroll;private get resolvedRowHeight();private detailRowOffsets;private get virtualWindow();private get gridTemplate();private get bodyScrollTranslation();private columnStyle;private estimatedColumnWidth;private columnBounds;private pinOffset;private columnLabel;private columnIsSortable;private sortFor;private activateSort;private onHeaderClick;private onFilterInput;private commitFilterValue;private onClearFilterInput;private syncBodyScrollState;private onBodyScroll;private onCellClick;private emitCellContextMenu;private descendantRows;private setRowSelected;private selectCurrentPage;private emitSelection;private rowSelectionState;private toggleRowExpanded;private toggleGroupExpanded;private moveColumn;private columnCanMove;private columnCanResize;private onDragStart;private onDrop;private onResizeStart;private onResizeMove;private takeResizeSession;private restoreResizeSession;private onResizeEnd;private onResizeCancel;private onResizeKey;private renderedColumnWidth;private syncResizeHandleValues;private onPageSizeChange;private focusCell;private handleDisclosureKey;private onGridKeyDown;private setGroupSelected;private userPinColumn;private userToggleColumn;private relayEditorFocus;private relayEditorBlur;private renderToolbar;private renderColumnsMenu;private renderSelectAllHeader;private renderColumnMenu;private renderHeader;private renderCellValue;private renderExpandButton;private renderDataRow;private renderGroupRow;private onErrorRetry;private renderBodyContent;private renderFooter;private visiblePageNumbers;private renderPager;protected render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-data-grid':LyraDataGrid;}}
+toggleColumn(columnId:string,visible:boolean):void;private validColumnMap;private delimitedRows;private copyAndReport;private writeClipboard;private setColumnWidth;private cancelRequestTimer;private currentServerRequestInputs;private matchesCurrentServerRequest;private scheduleServerRequest;private loadServerData;private get selectionEnabled();private get ariaColumnCount();private rowIsSelectable;private rowMatches;private processedChildrenFor;private hasMatchingDescendant;private get pageRows();private get currentPageSelectableRows();private computeCurrentPageSelectableRows;private groupMemberKey;private groupKey;private topLevelGroupBuckets;private computeTopLevelGroupBuckets;private groupItems;private get displayItems();private get displayIndexes();private computeDisplayItems;private groupedDisplayItems;private signatureItems?;private signatureValue;private measurementSignature;private invalidateRowMeasurements;private reconcileRowMeasurementCache;private recordMeasurementRowHeight;private currentMeasurementFontSignature;private recordMeasuredBodyWidth;private syncMeasuredBodyWidth;private syncBodyScrollbarInlineEndGutter;private queueMeasurementUpdate;private queueMeasuredScrollTop;private queueBodyScrollStateSync;private scheduleMeasurementSync;private cancelMeasurementFrame;private resetRowMeasurementObserver;private syncRowMeasurementObserver;private syncDisplayOffsets;private offsetPrefix;private updateOffsetHeight;private displayItemOffset;private displayItemHeight;private displayItemIndexAtOffset;private captureMeasurementAnchor;private measurementAnchorAtOffset;private pendingMeasurementAnchor?;private correctMeasurementAnchor;private measureRenderedItems;private measureCurrentItems;private layoutBorderBoxHeight;private renderedRowAlignmentDelta;private renderedStartPrecisionDelta;private alignPendingVirtualScroll;private geometryCycle;private resetGeometryCycle;private cycleRowHeight?;private cycleColumnEstimate?;private cycleFontSignature?;private get resolvedRowHeight();private detailRowOffsets;private get virtualWindow();private naturalColumnInputs?;private columnGeometryInputs;private sameColumnGeometry;private get gridTemplate();private computeGridTemplate;private resolvedColumnWidths?;private resolvedColumnInputs?;private syncResolvedColumnWidths;private get columnLayout();private get windowColumns();private get bodyScrollTranslation();private columnStyle;private estimatedColumnWidth;private columnBounds;private pinOffset;private columnLabel;private columnIsSortable;private sortFor;private activateSort;private onHeaderClick;private onFilterInput;private commitFilterValue;private onClearFilterInput;private syncBodyScrollState;private onBodyScroll;private onBodyCellEvent;private onCellClick;private emitCellContextMenu;private descendantRows;private setRowSelected;private selectCurrentPage;private emitSelection;private rowSelectionState;private computeRowSelectionState;private toggleRowExpanded;private toggleGroupExpanded;private moveColumn;private columnCanMove;private columnCanResize;private onDragStart;private onDrop;private onResizeStart;private onResizeMove;private takeResizeSession;private restoreResizeSession;private onResizeEnd;private onResizeCancel;private onResizeKey;private renderedColumnWidth;private syncResizeHandleValues;private onPageSizeChange;private focusCell;private handleDisclosureKey;private onGridKeyDown;private setGroupSelected;private userPinColumn;private userToggleColumn;private relayEditorFocus;private relayEditorBlur;private renderToolbar;private renderColumnsMenu;private renderSelectAllHeader;private renderColumnMenu;private renderHeader;private renderCellValue;private renderExpandButton;private renderDataRow;private renderGroupRow;private onErrorRetry;private renderBodyContent;private renderFooter;private visiblePageNumbers;private renderPager;protected render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-data-grid':LyraDataGrid;}}