@skdx/web-components 0.28.0 → 0.30.0

package/dist/calendar/Calendar.d.ts

@@ -1,4 +1,4 @@
-import { LitElement, type PropertyValues } from 'lit';
+import { LitElement, type PropertyValues, type TemplateResult } from 'lit';
 import { type DateInput } from '../internal/date-value.js';
 /** @internal */
 export declare function getDaysInMonth(year: number, month: number): number;
@@ -27,25 +27,20 @@ export declare function isDateDisabled(date: Date, minDate: Date | undefined, ma
 /** The whole-calendar and per-date disabled states. */
 export interface ResolvedCalendarDisabled {
     disabled: boolean;
-    isDateDisabled?: (date: Date) => boolean;
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
 }
 /** @internal Resolves disabled and isDateDisabled props. */
 export declare function resolveCalendarDisabled(disabled: boolean | undefined, isDateDisabled: ((date: Date) => boolean) | undefined): ResolvedCalendarDisabled;
 /** @internal */
 export declare function resetInstantDateWarning(): void;
 /**
- * Warn once per process when a bare `YYYY-MM-DD` string was handed to `new Date()`,
- * which reads it as UTC midnight (a different day west of Greenwich). Fires only
- * when `date` is at UTC midnight with a different local date.
+ * Warns once per process when a bare `YYYY-MM-DD` string was read by `new Date()` as UTC midnight, a different local day.
  *
  * @param date - Date supplied or null/undefined
  * @param source - Prop name for the message
  */
 export declare function warnInstantDate(date: Date | null | undefined, source: string): void;
-/**
- * Which grid is showing: day, month, or year view. Ordered coarsest-last —
- * heading steps *up* this list, activating a cell steps *down* it.
- */
+/** Which grid is showing: day, month, or year. */
 export type CalendarView = 'day' | 'month' | 'year';
 /** The three views, most granular first. */
 export declare const CALENDAR_VIEWS: readonly ["day", "month", "year"];
@@ -60,8 +55,7 @@ export declare function hasAvailableDate(from: Date, to: Date, minDate: Date | u
 /** @internal */
 export declare function formatViewPageLabel(date: Date, view: CalendarView, locale?: string): string;
 /**
- * ISO-8601 week number (1-53). Week 1 contains the year's first Thursday.
- * Independent of `week-starts-on`. Uses local time, not UTC.
+ * ISO-8601 week number (1-53), where week 1 contains the year's first Thursday.
  *
  * @param date - Any day of the week to number; not mutated
  * @returns The ISO week number, 1-53
@@ -91,10 +85,7 @@ export interface DateRange {
 /** Calendar selection: `Date`, `Date[]`, `DateRange`, or `null`. Not discriminated (framework parity). */
 export type CalendarValue = Date | Date[] | DateRange | null;
 /**
- * Lenient input form of {@link CalendarValue}. Each Date position accepts ISO
- * strings; the whole selection accepts wire strings ('2026-08-10' single,
- * '2026-08-10,2026-08-14' set, '2026-08-10/2026-08-14' range, trailing / for
- * anchored range). Strings read as local-time calendar dates, never UTC.
+ * Lenient input form of {@link CalendarValue}, accepting ISO date strings and wire-format single/set/range strings, read as local calendar dates.
  */
 export type CalendarValueInput = DateInput | ReadonlyArray<DateInput> | {
     start: DateInput;
@@ -112,21 +103,14 @@ export declare function emptySelection(mode: CalendarSelectionMode): CalendarVal
 export declare function rangePositionOf(range: DateRange, date: Date): RangePosition | undefined;
 /** @internal */
 export declare function isDateSelected(value: CalendarValue, date: Date): boolean;
-/**
- * @internal New selection after choosing `date`: single returns `date`; multiple
- * toggles it in/out, sorted; range anchors a new range or closes the anchored
- * one, always ensuring `start <= end`.
- */
+/** @internal New selection after choosing `date`, per `mode` (single/multiple/range). */
 export declare function nextSelection(mode: CalendarSelectionMode, current: CalendarValue, date: Date): CalendarValue;
 /** @internal */
 export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
 /** @internal */
 export declare function anchorOf(value: CalendarValue): Date | null;
 /**
- * Month-grid date picker (WAI-ARIA grid) built on native `Date` math and
- * `Intl` for names. Selects single date, multiple dates, or start/end range
- * over consecutive months. Renders no box; manages state and exposes it to
- * descendant parts via `closest('skdx-calendar')`. Properties are source of truth.
+ * Month-grid date picker (WAI-ARIA grid) that selects a single date, multiple dates, or a date range over consecutive months.
  *
  * @example
  * ```html
@@ -146,8 +130,7 @@ export declare class SkdxCalendar extends LitElement {
      */
     selectionMode: CalendarSelectionMode;
     /**
-     * Current selection shaped by `selectionMode`. Property carries `Date`s;
-     * attribute carries local ISO-8601 wire form. Listen for `value-change`.
+     * Current selection shaped by `selectionMode`; the property carries `Date`s, the attribute a local ISO-8601 wire form.
      * @default null
      */
     get value(): CalendarValue;
@@ -199,60 +182,47 @@ export declare class SkdxCalendar extends LitElement {
     set defaultValue(next: CalendarValueInput | undefined);
     private _defaultValue?;
     /**
-     * Non-editable: cells stay focusable, `value-change` never fires,
-     * grid carries `aria-readonly="true"`. Distinct from `disabled`.
+     * Non-editable: cells stay focusable and `aria-readonly` is set, but `value-change` never fires.
      * @default false
      */
     readOnly: boolean;
     /**
-     * Allow selecting adjacent-month days. Enabled cells stay focusable
-     * and page the calendar on selection.
+     * Allows selecting adjacent-month days, which stay focusable and page the calendar on selection.
      * @default false
      */
     outsideDaySelectable: boolean;
     /**
-     * Disables the whole calendar: cells carry the native `disabled`
-     * attribute, grid leaves the tab order, carries `aria-disabled="true"`.
-     * Use `isDateDisabled` for per-date disabling.
+     * Disables the whole calendar: cells get the native `disabled` attribute, and the grid leaves the tab order.
      * @default false
      */
     disabled: boolean;
     /**
-     * Mark dates as disabled beyond `min-date`/`max-date`. Disabled cells
-     * are not focusable or clickable. Property only (is a function).
+     * Marks dates as disabled beyond `min-date`/`max-date`; disabled cells are not focusable or clickable.
      */
     isDateDisabled?: (date: Date) => boolean;
     /**
-     * Mark dates as unavailable. Unlike `isDateDisabled`, unavailable cells
-     * stay keyboard-reachable and are announced via `aria-disabled`. Property only.
+     * Marks dates as unavailable; unlike `isDateDisabled`, these cells stay keyboard-reachable and announce via `aria-disabled`.
      */
     isDateUnavailable?: (date: Date) => boolean;
     /** @internal */
     get resolvedDisabled(): ResolvedCalendarDisabled;
     /**
-     * Announce selection changes in `multiple` and `range` mode. Return empty
-     * string to announce nothing. This is the one string a `locale` cannot
-     * translate on its own. Property only (is a function).
+     * Announces selection changes in `multiple` and `range` mode; return an empty string to announce nothing.
      * @default undefined — built-in English wording
      */
     getSelectionAnnouncement?: (value: CalendarValue, locale: string | undefined) => string;
     /**
-     * Announce navigation button paging. Return empty string to announce
-     * nothing. Paging replaces all cells and moves no focus a screen reader reports.
-     * Property only (is a function).
+     * Announces navigation button paging; return an empty string to announce nothing.
      * @default undefined — `formatMonthLabel`
      */
     getMonthAnnouncement?: (month: Date, locale: string | undefined) => string;
     /**
-     * Navigation step size: 'visible' pages by the whole displayed span,
-     * 'single' always moves one month. Only observable with `number-of-months` > 1.
+     * Navigation step size: `'visible'` pages by the whole displayed span, `'single'` always moves one month.
      * @default 'visible'
      */
     pageBehavior: CalendarPageBehavior;
     /**
-     * Date treated as today: carries `data-today` and `aria-current="date"`.
-     * Read once at construction. Pass it explicitly to prevent SSR/client
-     * time-zone disagreements.
+     * Date treated as today, carrying `data-today` and `aria-current="date"`.
      * @default undefined — `new Date()` read once at construction
      */
     today?: Date;
@@ -260,8 +230,7 @@ export declare class SkdxCalendar extends LitElement {
     get todayDate(): Date;
     private readonly _constructedToday;
     /**
-     * Roving tab stop date. Listen for `focus-change` to observe or override.
-     * Moves with arrow keys and selects nothing, distinct from {@link value}.
+     * Roving tab stop date that moves with arrow keys and selects nothing, distinct from {@link value}.
      * @default selection's anchor or displayed month
      */
     get focusedDate(): Date;
@@ -277,9 +246,7 @@ export declare class SkdxCalendar extends LitElement {
     defaultFocusedDate?: Date;
     private _focusSeeded;
     /**
-     * Grid showing: day, month, or year view. Non-day grids navigate only;
-     * activating a cell steps the view down, leaving `value` untouched.
-     * Clamped into `min-view`/`max-view`.
+     * Grid showing (day, month, or year), clamped into `min-view`/`max-view`; activating a cell in a non-day view steps it down.
      * @default 'day'
      */
     get view(): CalendarView;
@@ -289,15 +256,13 @@ export declare class SkdxCalendar extends LitElement {
     /** @internal */
     private moveView;
     /**
-     * Grid shown first for uncontrolled usage, seeds {@link view}.
-     * Clamped to `min-view`/`max-view`.
+     * Grid shown first for uncontrolled usage, seeds {@link view}, clamped to `min-view`/`max-view`.
      * @default undefined — day grid
      */
     defaultView?: CalendarView;
     private _viewSeeded;
     /**
-     * Most granular view the calendar can step to. Raising it restricts
-     * navigation.
+     * Most granular view the calendar can step to; raising it restricts navigation.
      * @default 'day'
      */
     minView: CalendarView;
@@ -307,15 +272,11 @@ export declare class SkdxCalendar extends LitElement {
      */
     maxView: CalendarView;
     /**
-     * Label each week with its ISO-8601 number. ISO numbering runs from Monday
-     * independently of `week-starts-on`.
+     * Labels each week with its ISO-8601 number, which runs from Monday independently of `week-starts-on`.
      * @default false
      */
     weekNumbers: boolean;
-    /**
-     * Current selection in wire form (same as `value` attribute). Read half of
-     * the attribute for persisting; kept off event detail for framework parity.
-     */
+    /** Current selection in wire form, the same as the `value` attribute. */
     get valueAsString(): string | null;
     /** @internal */
     get resolvedWeekStartsOn(): 0 | 1 | 2 | 3 | 4 | 5 | 6;
@@ -331,8 +292,7 @@ export declare class SkdxCalendar extends LitElement {
     /** @internal Draws auto anatomy when no consumer children present. */
     private readonly fillAnatomy;
     /**
-     * Folds `date` into current selection per `selectionMode`, moves focus to it,
-     * and dispatches `value-change`. Range/multi changes go through LiveAnnouncer.
+     * Folds `date` into the current selection per `selectionMode`, moves focus to it, and dispatches `value-change`.
      */
     setValue(date: Date): void;
     /** @internal */
@@ -350,9 +310,13 @@ export declare class SkdxCalendar extends LitElement {
     /** @internal */
     private notify;
     protected willUpdate(changed: PropertyValues): void;
+    private seedView;
+    private seedFocusedDate;
+    private seedValue;
+    private seedMonth;
     protected update(changed: PropertyValues): void;
     protected updated(changed: Map<string, unknown>): void;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/calendar/Calendar.js

@@ -1,5 +1,5 @@
-var R=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var s=(e,a,t,n)=>{for(var i=n>1?void 0:n?E(a,t):a,u=e.length-1,d;u>=0;u--)(d=e[u])&&(i=(n?d(a,t,i):d(i))||i);return n&&i&&R(a,t,i),i};import{css as U,html as $,LitElement as N}from"lit";import{property as o}from"lit/decorators.js";import{hasAuthoredContent as P,removeGeneratedContent as W}from"../internal/authored.js";import{toCalendarString as L,toCalendarValue as M,toDate as B}from"../internal/date-value.js";import{customElement as q}from"../internal/define.js";import{isDevMode as G}from"../utils/is-dev-mode.js";import{announce as w}from"../utils/live-announcer.js";import{CALENDAR_ANATOMY_GENERATED as F,fillCalendarAnatomy as z}from"./CalendarAnatomy.js";import{formatDateLabel as V,formatMonthLabel as Y,formatYear as H,formatYearRange as j,getLocaleWeekStartsOn as J,getWeekDayNames as T}from"./locale.js";function O(e,a){return new Date(e,a+1,0).getDate()}function D(e){return new Date(e.getFullYear(),e.getMonth(),1)}function g(e,a){let t=e.getDate(),n=new Date(e.getFullYear(),e.getMonth(),1);n.setMonth(n.getMonth()+a);let i=O(n.getFullYear(),n.getMonth());return n.setDate(Math.min(t,i)),n}function De(e,a){return g(e,a*12)}function A(e,a){let t=new Date(e);return t.setDate(t.getDate()+a),t}function p(e,a){return!e||!a?!1:e.getFullYear()===a.getFullYear()&&e.getMonth()===a.getMonth()&&e.getDate()===a.getDate()}function v(e,a){return e.getFullYear()===a.getFullYear()&&e.getMonth()===a.getMonth()}function I(e,a){let t=new Date(e.getFullYear(),e.getMonth(),e.getDate()),n=(t.getDay()-a+7)%7;return t.setDate(t.getDate()-n),t}function me(e,a){return A(I(e,a),6)}function l(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function K(e,a,t){return a&&l(e).getTime()<l(a).getTime()?a:t&&l(e).getTime()>l(t).getTime()?t:e}function ge(e,a,t,n){let i=l(e).getTime();return!!(a&&i<l(a).getTime()||t&&i>l(t).getTime()||n?.(e))}function Q(e,a){return{disabled:e??!1,isDateDisabled:a}}var _=!1;function pe(){_=!1}function X(e,a){!e||_||!(e.getUTCHours()===0&&e.getUTCMinutes()===0&&e.getUTCSeconds()===0&&e.getUTCMilliseconds()===0)||e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(_=!0,G()&&console.warn(`[skdx] Calendar: \`${a}\` was given ${e.toISOString()}, which is midnight UTC and therefore ${e.getFullYear()}-${String(e.getMonth()+1).padStart(2,"0")}-${String(e.getDate()).padStart(2,"0")} in this time zone \u2014 a different day from the one the string says. A selection here is a local wall-clock date, never an instant: build it as \`new Date(year, monthIndex, day)\` rather than \`new Date('YYYY-MM-DD')\`, which the platform reads as UTC.`))}var m=["day","month","year"],y=20;function x(e,a,t){let n=m.indexOf(a),i=Math.max(n,m.indexOf(t));return m[Math.min(Math.max(m.indexOf(e),n),i)]}function Z(e){return Math.floor(e/y)*y}function ve(e,a,t,n,i){let u=t&&l(t)>l(e)?l(t):l(e),d=n&&l(n)<l(a)?l(n):l(a);if(u.getTime()>d.getTime())return!1;if(!i)return!0;for(let h=u;h.getTime()<=d.getTime();h=A(h,1))if(!i(h))return!0;return!1}function k(e,a,t){if(a==="day")return Y(e,t);if(a==="month")return H(e.getFullYear(),t);let n=Z(e.getFullYear());return j(n,n+y-1,t)}function ye(e){let a=new Date(e.getFullYear(),e.getMonth(),e.getDate());a.setDate(a.getDate()-(a.getDay()+6)%7+3);let t=new Date(a.getFullYear(),0,4);return t.setDate(t.getDate()-(t.getDay()+6)%7+3),1+Math.round((a.getTime()-t.getTime())/(10080*60*1e3))}function be(e){let a=e.getFullYear(),t=String(e.getMonth()+1).padStart(2,"0"),n=String(e.getDate()).padStart(2,"0");return`${a}-${t}-${n}`}function ee(e,a){if(v(e,a))return e;let t=O(a.getFullYear(),a.getMonth());return new Date(a.getFullYear(),a.getMonth(),Math.min(e.getDate(),t))}function we(e,a=0){let t=I(D(e),a),n=[],i=t;for(let u=0;u<6;u++){let d=[];for(let h=0;h<7;h++)d.push({date:i,outsideMonth:!v(i,e)}),i=A(i,1);n.push(d)}return n}function b(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function Ve(e){return e==="multiple"?[]:null}function te(e,a){let t=l(a).getTime(),n=l(e.start).getTime();if(e.end===null)return t===n?"start":void 0;let i=l(e.end).getTime();if(!(t<n||t>i))return t===n?"start":t===i?"end":"middle"}function Me(e,a){return e===null?!1:Array.isArray(e)?e.some(t=>p(t,a)):b(e)?te(e,a)!==void 0:p(e,a)}function ne(e,a,t){if(e==="single")return t;if(e==="multiple"){let i=Array.isArray(a)?a:[],u=i.filter(d=>!p(d,t));return u.length!==i.length?u:[...i,t].sort((d,h)=>d.getTime()-h.getTime())}let n=b(a)&&a.end===null?a:void 0;return n?l(t).getTime()<l(n.start).getTime()?{start:t,end:n.start}:{start:n.start,end:t}:{start:t,end:null}}function ae(e,a){return b(e)?e.end===null?`${V(e.start,a)} selected as the range start. Select an end date.`:`Range selected, ${V(e.start,a)} to ${V(e.end,a)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var f={fromAttribute(e){if(e!=null)return B(e,"a date attribute")??void 0},toAttribute(){}},S={fromAttribute(e){return e==null?null:M(e,"single","value")??null},toAttribute(){}};function c(e){return e===null?null:Array.isArray(e)?e[0]??null:b(e)?e.start:e}var r=class extends N{constructor(){super(...arguments);this.selectionMode="single";this._value=null;this.month=D(new Date);this._constructedMonth=this.month;this._monthSeeded=!1;this._valueSeeded=!1;this.numberOfMonths=1;this.readOnly=!1;this.outsideDaySelectable=!1;this.disabled=!1;this.pageBehavior="visible";this._constructedToday=new Date;this._focusedDate=c(this.value)??this.month;this._focusAuto=!0;this._focusSeeded=!1;this._view="day";this._viewAuto=!0;this._viewSeeded=!1;this.minView="day";this.maxView="year";this.weekNumbers=!1;this._anatomyFilledFor="";this.fillAnatomy=()=>{if(P(this,F)){W(this,F),this._anatomyFilledFor="";return}let t=String(this.numberOfMonths);t===this._anatomyFilledFor&&this.children.length>0||(this._anatomyFilledFor=t,z(this))}}get value(){return this._value}set value(t){let n=this._value;this._value=M(t,"single","value")??null,this.requestUpdate("value",n)}get defaultValue(){return this._defaultValue}set defaultValue(t){let n=this._defaultValue;this._defaultValue=M(t,"single","defaultValue"),this.requestUpdate("defaultValue",n)}get resolvedDisabled(){return Q(this.disabled,this.isDateDisabled)}get todayDate(){return this.today??this._constructedToday}get focusedDate(){return this._focusedDate}set focusedDate(t){this._focusAuto=!1,this.moveFocusedDate(t)}moveFocusedDate(t){let n=this._focusedDate;this._focusedDate=t,this.requestUpdate("focusedDate",n)}get view(){return x(this._view,this.minView,this.maxView)}set view(t){this._viewAuto=!1,this.moveView(t)}moveView(t){let n=this._view;this._view=t,this.requestUpdate("view",n)}get valueAsString(){return L(this.value)}get resolvedWeekStartsOn(){return this.weekStartsOn??J(this.locale)}get months(){return Array.from({length:Math.max(1,this.numberOfMonths)},(t,n)=>g(this.month,n))}get weekDayNames(){let t=this.resolvedWeekStartsOn,n=T(this.locale,t,"short"),i=T(this.locale,t,"long");return n.map((u,d)=>({short:u,long:i[d]}))}connectedCallback(){super.connectedCallback(),this._focusAuto&&this.moveFocusedDate(c(this.value)??this.month),queueMicrotask(this.fillAnatomy)}setValue(t){if(this.readOnly||this.resolvedDisabled.disabled)return;let n=ne(this.selectionMode,this.value,t);this.value=n,this.setFocusedDate(t),this.emit("value-change",n);let i=(this.getSelectionAnnouncement??ae)(n,this.locale);i&&w(i)}setMonth(t){let n=D(t);n.getTime()!==D(this.month).getTime()&&(this.month=n,this.emit("month-change",this.month))}pageMonths(t){let n=this.view;if(n!=="day"){let h=n==="month"?12:12*y,C=g(this.focusedDate,t*h);this.setFocusedDate(C),w(k(C,n,this.locale));return}let i=this.pageBehavior==="single"?1:Math.max(1,this.numberOfMonths),u=g(this.month,t*i);this.setMonth(u),this.setFocusedDate(ee(this.focusedDate,u));let d=(this.getMonthAnnouncement??Y)(D(u),this.locale);d&&w(d)}setFocusedDate(t){let n=K(t,this.minDate,this.maxDate);p(n,this._focusedDate)||(this.moveFocusedDate(n),this.emit("focus-change",n))}setView(t){let n=x(t,this.minView,this.maxView);n!==this.view&&(this.moveView(n),this.emit("view-change",n))}navigateToUnit(t){this.setFocusedDate(t),this.months.some(n=>v(t,n))||this.setMonth(t),this.setView(m[m.indexOf(this.view)-1]??"day")}emit(t,n){this.dispatchEvent(new CustomEvent(t,{detail:n,bubbles:!0,composed:!0})),this.notify()}notify(){this.dispatchEvent(new CustomEvent("skdx-calendar-internal-update",{bubbles:!0,composed:!0})),this.requestUpdate()}willUpdate(t){if(this.selectionMode==="multiple"&&(this.value instanceof Date&&(this.value=[this.value]),this.defaultValue instanceof Date&&(this.defaultValue=[this.defaultValue])),!this._viewSeeded&&t.has("defaultView")&&(this._viewSeeded=!0,this.defaultView&&this._viewAuto&&this.moveView(this.defaultView)),!this._focusSeeded&&t.has("defaultFocusedDate")&&(this._focusSeeded=!0,this.defaultFocusedDate&&this._focusAuto&&this.moveFocusedDate(this.defaultFocusedDate)),!this._valueSeeded&&t.has("defaultValue")){this._valueSeeded=!0;let i=this.defaultValue??null,u=this.value===null||Array.isArray(this.value)&&this.value.length===0;i!==null&&u&&(this.value=i,this.moveFocusedDate(c(i)??this._focusedDate))}if(this._monthSeeded||!(t.has("defaultMonth")||t.has("value")))return;if(this.month!==this._constructedMonth){this._monthSeeded=!0;return}let n=this.defaultMonth??c(this.value);n&&(this._monthSeeded=!0,this.month=D(n),this._focusAuto&&this.moveFocusedDate(c(this.value)??this.month))}update(t){if(super.update(t),t.has("value")&&X(c(this.value),"value"),!t.has("value")||!this._monthSeeded)return;let n=c(this.value);n&&(this.months.some(i=>v(n,i))||(this.setFocusedDate(n),this.setMonth(n)))}updated(t){this.fillAnatomy(),t.size>0&&this.dispatchEvent(new CustomEvent("skdx-calendar-internal-update",{bubbles:!0,composed:!0}))}render(){return $`<slot @slotchange=${this.fillAnatomy}></slot>`}};r.styles=U`
+var U=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var s=(e,a,t,n)=>{for(var i=n>1?void 0:n?P(a,t):a,l=e.length-1,d;l>=0;l--)(d=e[l])&&(i=(n?d(a,t,i):d(i))||i);return n&&i&&U(a,t,i),i};import{css as $,html as E,LitElement as N}from"lit";import{property as o}from"lit/decorators.js";import{hasAuthoredContent as L,removeGeneratedContent as W}from"../internal/authored.js";import{formatDateLabel as b,formatMonthLabel as O,formatYear as B,formatYearRange as q,getLocaleWeekStartsOn as G,getWeekDayNames as T}from"../internal/calendar-locale.js";import{toCalendarString as z,toCalendarValue as M,toDate as H}from"../internal/date-value.js";import{customElement as j}from"../internal/define.js";import{isDevMode as J}from"../internal/dev-mode.js";import{emit as K}from"../internal/events.js";import{announce as V}from"../utils/live-announcer.js";import{CALENDAR_ANATOMY_GENERATED as C,fillCalendarAnatomy as Q}from"./CalendarAnatomy.js";import{CALENDAR_FAMILY as x}from"./family.js";function R(e,a){return new Date(e,a+1,0).getDate()}function D(e){return new Date(e.getFullYear(),e.getMonth(),1)}function g(e,a){let t=e.getDate(),n=new Date(e.getFullYear(),e.getMonth(),1);n.setMonth(n.getMonth()+a);let i=R(n.getFullYear(),n.getMonth());return n.setDate(Math.min(t,i)),n}function ve(e,a){return g(e,a*12)}function _(e,a){let t=new Date(e);return t.setDate(t.getDate()+a),t}function p(e,a){return!e||!a?!1:e.getFullYear()===a.getFullYear()&&e.getMonth()===a.getMonth()&&e.getDate()===a.getDate()}function v(e,a){return e.getFullYear()===a.getFullYear()&&e.getMonth()===a.getMonth()}function I(e,a){let t=new Date(e.getFullYear(),e.getMonth(),e.getDate()),n=(t.getDay()-a+7)%7;return t.setDate(t.getDate()-n),t}function ye(e,a){return _(I(e,a),6)}function u(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function X(e,a,t){return a&&u(e).getTime()<u(a).getTime()?a:t&&u(e).getTime()>u(t).getTime()?t:e}function we(e,a,t,n){let i=u(e).getTime();return!!(a&&i<u(a).getTime()||t&&i>u(t).getTime()||n?.(e))}function Z(e,a){return{disabled:e??!1,isDateDisabled:a}}var A=!1;function be(){A=!1}function k(e,a){!e||A||!(e.getUTCHours()===0&&e.getUTCMinutes()===0&&e.getUTCSeconds()===0&&e.getUTCMilliseconds()===0)||e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(A=!0,J()&&console.warn(`[skdx] Calendar: \`${a}\` was given ${e.toISOString()}, which is midnight UTC and therefore ${e.getFullYear()}-${String(e.getMonth()+1).padStart(2,"0")}-${String(e.getDate()).padStart(2,"0")} in this time zone \u2014 a different day from the one the string says. A selection here is a local wall-clock date, never an instant: build it as \`new Date(year, monthIndex, day)\` rather than \`new Date('YYYY-MM-DD')\`, which the platform reads as UTC.`))}var m=["day","month","year"],y=20;function S(e,a,t){let n=m.indexOf(a),i=Math.max(n,m.indexOf(t));return m[Math.min(Math.max(m.indexOf(e),n),i)]}function ee(e){return Math.floor(e/y)*y}function Ve(e,a,t,n,i){let l=t&&u(t)>u(e)?u(t):u(e),d=n&&u(n)<u(a)?u(n):u(a);if(l.getTime()>d.getTime())return!1;if(!i)return!0;for(let h=l;h.getTime()<=d.getTime();h=_(h,1))if(!i(h))return!0;return!1}function te(e,a,t){if(a==="day")return O(e,t);if(a==="month")return B(e.getFullYear(),t);let n=ee(e.getFullYear());return q(n,n+y-1,t)}function Me(e){let a=new Date(e.getFullYear(),e.getMonth(),e.getDate());a.setDate(a.getDate()-(a.getDay()+6)%7+3);let t=new Date(a.getFullYear(),0,4);return t.setDate(t.getDate()-(t.getDay()+6)%7+3),1+Math.round((a.getTime()-t.getTime())/(10080*60*1e3))}function Ae(e){let a=e.getFullYear(),t=String(e.getMonth()+1).padStart(2,"0"),n=String(e.getDate()).padStart(2,"0");return`${a}-${t}-${n}`}function ne(e,a){if(v(e,a))return e;let t=R(a.getFullYear(),a.getMonth());return new Date(a.getFullYear(),a.getMonth(),Math.min(e.getDate(),t))}function _e(e,a=0){let t=I(D(e),a),n=[],i=t;for(let l=0;l<6;l++){let d=[];for(let h=0;h<7;h++)d.push({date:i,outsideMonth:!v(i,e)}),i=_(i,1);n.push(d)}return n}function w(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function Fe(e){return e==="multiple"?[]:null}function ae(e,a){let t=u(a).getTime(),n=u(e.start).getTime();if(e.end===null)return t===n?"start":void 0;let i=u(e.end).getTime();if(!(t<n||t>i))return t===n?"start":t===i?"end":"middle"}function Te(e,a){return e===null?!1:Array.isArray(e)?e.some(t=>p(t,a)):w(e)?ae(e,a)!==void 0:p(e,a)}function ie(e,a,t){if(e==="single")return t;if(e==="multiple"){let i=Array.isArray(a)?a:[],l=i.filter(d=>!p(d,t));return l.length!==i.length?l:[...i,t].sort((d,h)=>d.getTime()-h.getTime())}let n=w(a)&&a.end===null?a:void 0;return n?u(t).getTime()<u(n.start).getTime()?{start:t,end:n.start}:{start:n.start,end:t}:{start:t,end:null}}function re(e,a){return w(e)?e.end===null?`${b(e.start,a)} selected as the range start. Select an end date.`:`Range selected, ${b(e.start,a)} to ${b(e.end,a)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var f={fromAttribute(e){if(e!=null)return H(e,"a date attribute")??void 0},toAttribute(){}},Y={fromAttribute(e){return e==null?null:M(e,"single","value")??null},toAttribute(){}};function c(e){return e===null?null:Array.isArray(e)?e[0]??null:w(e)?e.start:e}var r=class extends N{constructor(){super(...arguments);this.selectionMode="single";this._value=null;this.month=D(new Date);this._constructedMonth=this.month;this._monthSeeded=!1;this._valueSeeded=!1;this.numberOfMonths=1;this.readOnly=!1;this.outsideDaySelectable=!1;this.disabled=!1;this.pageBehavior="visible";this._constructedToday=new Date;this._focusedDate=c(this.value)??this.month;this._focusAuto=!0;this._focusSeeded=!1;this._view="day";this._viewAuto=!0;this._viewSeeded=!1;this.minView="day";this.maxView="year";this.weekNumbers=!1;this._anatomyFilledFor="";this.fillAnatomy=()=>{if(L(this,C)){W(this,C),this._anatomyFilledFor="";return}let t=String(this.numberOfMonths);t===this._anatomyFilledFor&&this.children.length>0||(this._anatomyFilledFor=t,Q(this))}}get value(){return this._value}set value(t){let n=this._value;this._value=M(t,"single","value")??null,this.requestUpdate("value",n)}get defaultValue(){return this._defaultValue}set defaultValue(t){let n=this._defaultValue;this._defaultValue=M(t,"single","defaultValue"),this.requestUpdate("defaultValue",n)}get resolvedDisabled(){return Z(this.disabled,this.isDateDisabled)}get todayDate(){return this.today??this._constructedToday}get focusedDate(){return this._focusedDate}set focusedDate(t){this._focusAuto=!1,this.moveFocusedDate(t)}moveFocusedDate(t){let n=this._focusedDate;this._focusedDate=t,this.requestUpdate("focusedDate",n)}get view(){return S(this._view,this.minView,this.maxView)}set view(t){this._viewAuto=!1,this.moveView(t)}moveView(t){let n=this._view;this._view=t,this.requestUpdate("view",n)}get valueAsString(){return z(this.value)}get resolvedWeekStartsOn(){return this.weekStartsOn??G(this.locale)}get months(){return Array.from({length:Math.max(1,this.numberOfMonths)},(t,n)=>g(this.month,n))}get weekDayNames(){let t=this.resolvedWeekStartsOn,n=T(this.locale,t,"short"),i=T(this.locale,t,"long");return n.map((l,d)=>({short:l,long:i[d]}))}connectedCallback(){super.connectedCallback(),this._focusAuto&&this.moveFocusedDate(c(this.value)??this.month),queueMicrotask(this.fillAnatomy)}setValue(t){if(this.readOnly||this.resolvedDisabled.disabled)return;let n=ie(this.selectionMode,this.value,t);this.value=n,this.setFocusedDate(t),this.emit("value-change",n);let i=(this.getSelectionAnnouncement??re)(n,this.locale);i&&V(i)}setMonth(t){let n=D(t);n.getTime()!==D(this.month).getTime()&&(this.month=n,this.emit("month-change",this.month))}pageMonths(t){let n=this.view;if(n!=="day"){let h=n==="month"?12:12*y,F=g(this.focusedDate,t*h);this.setFocusedDate(F),V(te(F,n,this.locale));return}let i=this.pageBehavior==="single"?1:Math.max(1,this.numberOfMonths),l=g(this.month,t*i);this.setMonth(l),this.setFocusedDate(ne(this.focusedDate,l));let d=(this.getMonthAnnouncement??O)(D(l),this.locale);d&&V(d)}setFocusedDate(t){let n=X(t,this.minDate,this.maxDate);p(n,this._focusedDate)||(this.moveFocusedDate(n),this.emit("focus-change",n))}setView(t){let n=S(t,this.minView,this.maxView);n!==this.view&&(this.moveView(n),this.emit("view-change",n))}navigateToUnit(t){this.setFocusedDate(t),this.months.some(n=>v(t,n))||this.setMonth(t),this.setView(m[m.indexOf(this.view)-1]??"day")}emit(t,n){K(this,t,n),this.notify()}notify(){x.notify(this),this.requestUpdate()}willUpdate(t){this.selectionMode==="multiple"&&(this.value instanceof Date&&(this.value=[this.value]),this.defaultValue instanceof Date&&(this.defaultValue=[this.defaultValue])),this.seedView(t),this.seedFocusedDate(t),this.seedValue(t),this.seedMonth(t)}seedView(t){this._viewSeeded||!t.has("defaultView")||(this._viewSeeded=!0,this.defaultView&&this._viewAuto&&this.moveView(this.defaultView))}seedFocusedDate(t){this._focusSeeded||!t.has("defaultFocusedDate")||(this._focusSeeded=!0,this.defaultFocusedDate&&this._focusAuto&&this.moveFocusedDate(this.defaultFocusedDate))}seedValue(t){if(this._valueSeeded||!t.has("defaultValue"))return;this._valueSeeded=!0;let n=this.defaultValue??null,i=this.value===null||Array.isArray(this.value)&&this.value.length===0;n!==null&&i&&(this.value=n,this.moveFocusedDate(c(n)??this._focusedDate))}seedMonth(t){if(this._monthSeeded||!(t.has("defaultMonth")||t.has("value")))return;if(this.month!==this._constructedMonth){this._monthSeeded=!0;return}let n=this.defaultMonth??c(this.value);n&&(this._monthSeeded=!0,this.month=D(n),this._focusAuto&&this.moveFocusedDate(c(this.value)??this.month))}update(t){if(super.update(t),t.has("value")&&k(c(this.value),"value"),!t.has("value")||!this._monthSeeded)return;let n=c(this.value);n&&(this.months.some(i=>v(n,i))||(this.setFocusedDate(n),this.setMonth(n)))}updated(t){this.fillAnatomy(),t.size>0&&x.notify(this)}render(){return E`<slot @slotchange=${this.fillAnatomy}></slot>`}};r.styles=$`
     :host {
       display: block;
     }
-  `,s([o({type:String,reflect:!0,attribute:"selection-mode"})],r.prototype,"selectionMode",2),s([o({converter:S})],r.prototype,"value",1),s([o({converter:f})],r.prototype,"month",2),s([o({converter:f,attribute:"default-month"})],r.prototype,"defaultMonth",2),s([o({type:Number,attribute:"number-of-months"})],r.prototype,"numberOfMonths",2),s([o({type:String})],r.prototype,"locale",2),s([o({type:Number,attribute:"week-starts-on"})],r.prototype,"weekStartsOn",2),s([o({converter:f,attribute:"min-date"})],r.prototype,"minDate",2),s([o({converter:f,attribute:"max-date"})],r.prototype,"maxDate",2),s([o({converter:S,attribute:"default-value"})],r.prototype,"defaultValue",1),s([o({type:Boolean,reflect:!0,attribute:"read-only"})],r.prototype,"readOnly",2),s([o({type:Boolean,reflect:!0,attribute:"outside-day-selectable"})],r.prototype,"outsideDaySelectable",2),s([o({type:Boolean})],r.prototype,"disabled",2),s([o({attribute:!1})],r.prototype,"isDateDisabled",2),s([o({attribute:!1})],r.prototype,"isDateUnavailable",2),s([o({attribute:!1})],r.prototype,"getSelectionAnnouncement",2),s([o({attribute:!1})],r.prototype,"getMonthAnnouncement",2),s([o({type:String,attribute:"page-behavior"})],r.prototype,"pageBehavior",2),s([o({converter:f})],r.prototype,"today",2),s([o({converter:f,attribute:"focused-date"})],r.prototype,"focusedDate",1),s([o({converter:f,attribute:"default-focused-date"})],r.prototype,"defaultFocusedDate",2),s([o({type:String,reflect:!0})],r.prototype,"view",1),s([o({type:String,attribute:"default-view"})],r.prototype,"defaultView",2),s([o({type:String,attribute:"min-view"})],r.prototype,"minView",2),s([o({type:String,attribute:"max-view"})],r.prototype,"maxView",2),s([o({type:Boolean,reflect:!0,attribute:"week-numbers"})],r.prototype,"weekNumbers",2),r=s([q("skdx-calendar","calendar","root")],r);export{m as CALENDAR_VIEWS,y as CALENDAR_YEAR_PAGE,r as SkdxCalendar,A as addDays,g as addMonths,De as addYears,c as anchorOf,K as clampToDateRange,ee as clampToMonth,x as clampView,Ve as emptySelection,me as endOfWeek,k as formatViewPageLabel,O as getDaysInMonth,ye as getISOWeek,we as getVisibleWeeks,ve as hasAvailableDate,ge as isDateDisabled,b as isDateRange,Me as isDateSelected,p as isSameDay,v as isSameMonth,ne as nextSelection,te as rangePositionOf,pe as resetInstantDateWarning,Q as resolveCalendarDisabled,ae as selectionAnnouncement,D as startOfMonth,I as startOfWeek,l as stripTime,be as toISODateString,X as warnInstantDate,Z as yearPageStart};
+  `,s([o({type:String,reflect:!0,attribute:"selection-mode"})],r.prototype,"selectionMode",2),s([o({converter:Y})],r.prototype,"value",1),s([o({converter:f})],r.prototype,"month",2),s([o({converter:f,attribute:"default-month"})],r.prototype,"defaultMonth",2),s([o({type:Number,attribute:"number-of-months"})],r.prototype,"numberOfMonths",2),s([o({type:String})],r.prototype,"locale",2),s([o({type:Number,attribute:"week-starts-on"})],r.prototype,"weekStartsOn",2),s([o({converter:f,attribute:"min-date"})],r.prototype,"minDate",2),s([o({converter:f,attribute:"max-date"})],r.prototype,"maxDate",2),s([o({converter:Y,attribute:"default-value"})],r.prototype,"defaultValue",1),s([o({type:Boolean,reflect:!0,attribute:"read-only"})],r.prototype,"readOnly",2),s([o({type:Boolean,reflect:!0,attribute:"outside-day-selectable"})],r.prototype,"outsideDaySelectable",2),s([o({type:Boolean})],r.prototype,"disabled",2),s([o({attribute:!1})],r.prototype,"isDateDisabled",2),s([o({attribute:!1})],r.prototype,"isDateUnavailable",2),s([o({attribute:!1})],r.prototype,"getSelectionAnnouncement",2),s([o({attribute:!1})],r.prototype,"getMonthAnnouncement",2),s([o({type:String,attribute:"page-behavior"})],r.prototype,"pageBehavior",2),s([o({converter:f})],r.prototype,"today",2),s([o({converter:f,attribute:"focused-date"})],r.prototype,"focusedDate",1),s([o({converter:f,attribute:"default-focused-date"})],r.prototype,"defaultFocusedDate",2),s([o({type:String,reflect:!0})],r.prototype,"view",1),s([o({type:String,attribute:"default-view"})],r.prototype,"defaultView",2),s([o({type:String,attribute:"min-view"})],r.prototype,"minView",2),s([o({type:String,attribute:"max-view"})],r.prototype,"maxView",2),s([o({type:Boolean,reflect:!0,attribute:"week-numbers"})],r.prototype,"weekNumbers",2),r=s([j("skdx-calendar","calendar","root")],r);export{m as CALENDAR_VIEWS,y as CALENDAR_YEAR_PAGE,r as SkdxCalendar,_ as addDays,g as addMonths,ve as addYears,c as anchorOf,X as clampToDateRange,ne as clampToMonth,S as clampView,Fe as emptySelection,ye as endOfWeek,te as formatViewPageLabel,R as getDaysInMonth,Me as getISOWeek,_e as getVisibleWeeks,Ve as hasAvailableDate,we as isDateDisabled,w as isDateRange,Te as isDateSelected,p as isSameDay,v as isSameMonth,ie as nextSelection,ae as rangePositionOf,be as resetInstantDateWarning,Z as resolveCalendarDisabled,re as selectionAnnouncement,D as startOfMonth,I as startOfWeek,u as stripTime,Ae as toISODateString,k as warnInstantDate,ee as yearPageStart};

package/dist/calendar/CalendarAnatomy.d.cts

@@ -10,7 +10,6 @@ import './CalendarViewGrid.cjs';
 /** @internal Marks generated direct children of `<skdx-calendar>`. */
 export declare const CALENDAR_ANATOMY_GENERATED = "data-skdx-calendar-generated";
 /**
- * Builds canonical anatomy: paging header, day grids, month/year view grids in light DOM (not shadow DOM). Light DOM needed because `closest()` can't cross boundaries and stylesheets can't reach shadow cells. Not exported; consumers get it from empty `<skdx-calendar></skdx-calendar>` or compose.
- * @internal
+ * @internal Builds canonical anatomy: paging header, day grids, and month/year view grids, in light DOM.
  */
 export declare function fillCalendarAnatomy(root: SkdxCalendar): void;

package/dist/calendar/CalendarAnatomy.d.ts

@@ -10,7 +10,6 @@ import './CalendarViewGrid.js';
 /** @internal Marks generated direct children of `<skdx-calendar>`. */
 export declare const CALENDAR_ANATOMY_GENERATED = "data-skdx-calendar-generated";
 /**
- * Builds canonical anatomy: paging header, day grids, month/year view grids in light DOM (not shadow DOM). Light DOM needed because `closest()` can't cross boundaries and stylesheets can't reach shadow cells. Not exported; consumers get it from empty `<skdx-calendar></skdx-calendar>` or compose.
- * @internal
+ * @internal Builds canonical anatomy: paging header, day grids, and month/year view grids, in light DOM.
  */
 export declare function fillCalendarAnatomy(root: SkdxCalendar): void;

package/dist/calendar/CalendarCell.cjs

@@ -1,29 +1,29 @@
-"use strict";var h=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var U=(n,s)=>{for(var t in s)h(n,t,{get:s[t],enumerable:!0})},S=(n,s,t,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let a of y(s))!x.call(n,a)&&a!==t&&h(n,a,{get:()=>s[a],enumerable:!(i=p(s,a))||i.enumerable});return n};var E=n=>S(h({},"__esModule",{value:!0}),n),b=(n,s,t,i)=>{for(var a=i>1?void 0:i?p(s,t):s,o=n.length-1,r;o>=0;o--)(r=n[o])&&(a=(i?r(s,t,a):r(a))||a);return i&&a&&h(s,t,a),a};var L={};U(L,{SkdxCalendarCell:()=>l});module.exports=E(L);var d=require("lit"),v=require("lit/decorators.js"),g=require("../internal/date-value.cjs"),D=require("../internal/define.cjs"),$=require("../internal/part.cjs"),c=require("../internal/styles.cjs"),e=require("./Calendar.cjs"),k=require("./locale.cjs");var l=class extends d.LitElement{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleClick=()=>{let t=this.root;if(!t||this.isDisabled)return;if(this.isUnavailable){t.setFocusedDate(this.date);return}t.setValue(this.date);let i=this.gridMonth;i&&!(0,e.isSameMonth)(this.date,i)&&!t.months.some(a=>(0,e.isSameMonth)(this.date,a))&&t.setMonth(this.date)}}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-calendar"),this.root?.addEventListener("skdx-calendar-internal-update",this.onUpdate),this.date&&this.setAttribute("data-skdx-calendar-cell",(0,e.toISODateString)(this.date))}disconnectedCallback(){this.root?.removeEventListener("skdx-calendar-internal-update",this.onUpdate),super.disconnectedCallback()}willUpdate(){this.date&&this.setAttribute("data-skdx-calendar-cell",(0,e.toISODateString)(this.date))}updated(){let t=this.root,i=this.gridMonth,a=t?(0,e.isDateSelected)(t.value,this.date):!1,o=t&&(0,e.isDateRange)(t.value)?(0,e.rangePositionOf)(t.value,this.date):void 0;(0,$.reflectHostState)(this,{"data-state":a?"selected":null,"data-today":t&&(0,e.isSameDay)(this.date,t.todayDate)?"":null,"data-outside-month":i&&!(0,e.isSameMonth)(this.date,i)?"":null,"data-disabled":this.isDisabled?"":null,"data-unavailable":this.isUnavailable?"":null,"data-range-start":o==="start"?"":null,"data-range-middle":o==="middle"?"":null,"data-range-end":o==="end"?"":null})}get gridMonth(){return this.closest("skdx-calendar-grid")?.gridMonth??this.root?.month}get isDisabled(){let t=this.root;if(!t)return!1;let i=this.gridMonth,a=i?!(0,e.isSameMonth)(this.date,i):!1,{disabled:o,isDateDisabled:r}=t.resolvedDisabled;return o||a&&!t.outsideDaySelectable||(0,e.isDateDisabled)(this.date,t.minDate,t.maxDate,r)}get isUnavailable(){return this.isDisabled?!1:this.root?.isDateUnavailable?.(this.date)??!1}render(){let t=this.root,i=this.gridMonth,a=i?!(0,e.isSameMonth)(this.date,i):!1,o=this.isDisabled,r=this.isUnavailable,f=t?(0,e.isDateSelected)(t.value,this.date):!1,u=t&&(0,e.isDateRange)(t.value)?(0,e.rangePositionOf)(t.value,this.date):void 0,m=t?(0,e.isSameDay)(this.date,t.todayDate):!1,M=t?(0,e.isSameDay)(this.date,t.focusedDate):!1;return d.html`
+"use strict";var h=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var P=(n,s)=>{for(var t in s)h(n,t,{get:s[t],enumerable:!0})},R=(n,s,t,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let a of x(s))!U.call(n,a)&&a!==t&&h(n,a,{get:()=>s[a],enumerable:!(i=g(s,a))||i.enumerable});return n};var L=n=>R(h({},"__esModule",{value:!0}),n),m=(n,s,t,i)=>{for(var a=i>1?void 0:i?g(s,t):s,d=n.length-1,r;d>=0;d--)(r=n[d])&&(a=(i?r(s,t,a):r(a))||a);return i&&a&&h(s,t,a),a};var S={};P(S,{SkdxCalendarCell:()=>l});module.exports=L(S);var o=require("lit"),v=require("lit/decorators.js"),D=require("../internal/calendar-locale.cjs"),y=require("../internal/date-value.cjs"),M=require("../internal/define.cjs"),$=require("../internal/part.cjs"),c=require("../internal/styles.cjs"),e=require("./Calendar.cjs"),u=require("./family.cjs");var l=class extends o.LitElement{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleClick=()=>{let t=this.root;if(!t||this.isDisabled)return;if(this.isUnavailable){t.setFocusedDate(this.date);return}t.setValue(this.date),t.setFocusedDate(this.date);let i=this.gridMonth;i&&!(0,e.isSameMonth)(this.date,i)&&!t.months.some(a=>(0,e.isSameMonth)(this.date,a))&&t.setMonth(this.date)}}connectedCallback(){super.connectedCallback(),this.root=u.CALENDAR_FAMILY.root(this),this.root?.addEventListener(u.CALENDAR_FAMILY.event,this.onUpdate),this.date&&this.setAttribute("data-skdx-calendar-cell",(0,e.toISODateString)(this.date))}disconnectedCallback(){this.root?.removeEventListener(u.CALENDAR_FAMILY.event,this.onUpdate),super.disconnectedCallback()}willUpdate(){this.date&&this.setAttribute("data-skdx-calendar-cell",(0,e.toISODateString)(this.date))}updated(){let t=this.root,i=this.gridMonth,a=t?(0,e.isDateSelected)(t.value,this.date):!1,d=t&&(0,e.isDateRange)(t.value)?(0,e.rangePositionOf)(t.value,this.date):void 0;(0,$.reflectHostState)(this,{"data-state":a?"selected":null,"data-today":t&&(0,e.isSameDay)(this.date,t.todayDate)?"":null,"data-outside-month":i&&!(0,e.isSameMonth)(this.date,i)?"":null,"data-disabled":this.isDisabled?"":null,"data-unavailable":this.isUnavailable?"":null,"data-range-start":d==="start"?"":null,"data-range-middle":d==="middle"?"":null,"data-range-end":d==="end"?"":null})}get gridMonth(){return this.closest("skdx-calendar-grid")?.gridMonth??this.root?.month}get isDisabled(){let t=this.root;if(!t)return!1;let i=this.gridMonth,a=i?!(0,e.isSameMonth)(this.date,i):!1,{disabled:d,isDateDisabled:r}=t.resolvedDisabled;return d||a&&!t.outsideDaySelectable||(0,e.isDateDisabled)(this.date,t.minDate,t.maxDate,r)}get isUnavailable(){return this.isDisabled?!1:this.root?.isDateUnavailable?.(this.date)??!1}rootFlags(){let t=this.root;return t?{selected:(0,e.isDateSelected)(t.value,this.date),rangePosition:(0,e.isDateRange)(t.value)?(0,e.rangePositionOf)(t.value,this.date):void 0,today:(0,e.isSameDay)(this.date,t.todayDate),focused:(0,e.isSameDay)(this.date,t.focusedDate)}:{selected:!1,rangePosition:void 0,today:!1,focused:!1}}render(){if(!this.date)return o.nothing;let t=this.root,i=this.gridMonth,a=i?!(0,e.isSameMonth)(this.date,i):!1,d=this.isDisabled,r=this.isUnavailable,{selected:p,rangePosition:f,today:b,focused:k}=this.rootFlags();return o.html`
       <button
         part="cell"
         type="button"
         role="gridcell"
-        aria-selected=${f}
-        aria-disabled=${r?"true":d.nothing}
-        aria-current=${m?"date":d.nothing}
-        aria-label=${(0,k.formatDateLabel)(this.date,t?.locale)}
+        aria-selected=${p}
+        aria-disabled=${r?"true":o.nothing}
+        aria-current=${b?"date":o.nothing}
+        aria-label=${(0,D.formatDateLabel)(this.date,t?.locale)}
         data-skdx-calendar-cell=${(0,e.toISODateString)(this.date)}
-        data-state=${f?"selected":d.nothing}
-        data-today=${m?"":d.nothing}
-        data-outside-month=${a?"":d.nothing}
-        data-disabled=${o?"":d.nothing}
-        data-unavailable=${r?"":d.nothing}
-        data-range-start=${u==="start"?"":d.nothing}
-        data-range-middle=${u==="middle"?"":d.nothing}
-        data-range-end=${u==="end"?"":d.nothing}
-        tabindex=${M?0:-1}
-        ?disabled=${o}
+        data-state=${p?"selected":o.nothing}
+        data-today=${b?"":o.nothing}
+        data-outside-month=${a?"":o.nothing}
+        data-disabled=${d?"":o.nothing}
+        data-unavailable=${r?"":o.nothing}
+        data-range-start=${f==="start"?"":o.nothing}
+        data-range-middle=${f==="middle"?"":o.nothing}
+        data-range-end=${f==="end"?"":o.nothing}
+        tabindex=${k?0:-1}
+        ?disabled=${d}
         @click=${this.handleClick}
       >
         <slot>${this.date.getDate()}</slot>
       </button>
-    `}};l.shadowRootOptions=c.delegatesFocusShadowRootOptions,l.styles=[c.resetNativeControl,d.css`
+    `}};l.shadowRootOptions=c.delegatesFocusShadowRootOptions,l.styles=[c.resetNativeControl,o.css`
       :host {
         display: inline-block;
       }
-    `,c.controlBoxOnHost],b([(0,v.property)({converter:{fromAttribute:t=>t==null?void 0:(0,g.toDate)(t,"date")??void 0,toAttribute:()=>{}}})],l.prototype,"date",2),l=b([(0,D.customElement)("skdx-calendar-cell","calendar","cell")],l);0&&(module.exports={SkdxCalendarCell});
+    `,c.controlBoxOnHost],m([(0,v.property)({converter:{fromAttribute:t=>t==null?void 0:(0,y.toDate)(t,"date")??void 0}})],l.prototype,"date",2),l=m([(0,M.customElement)("skdx-calendar-cell","calendar","cell")],l);0&&(module.exports={SkdxCalendarCell});

package/dist/calendar/CalendarCell.d.cts

@@ -1,20 +1,13 @@
-import { LitElement } from 'lit';
+import { LitElement, nothing, type TemplateResult } from 'lit';
 /**
- * Single selectable date in a `<skdx-calendar>`. Renders a native `<button>` with
- * roving `tabindex`. `aria-selected`, `data-today`, `data-outside-month`, and range
- * state (`data-range-start` / `-middle` / `-end`). In range mode, all cells from start to end
- * are selected. Two refusal modes: **disabled** (not focusable, no clicks); **unavailable**
- * (focusable, `aria-disabled="true"`, click moves focus only).
+ * Single selectable date in a `<skdx-calendar>`, rendered as a native `<button>` with roving `tabindex`.
  *
  * @csspart cell - Native `<button>` element inside shadow root.
  */
 export declare class SkdxCalendarCell extends LitElement {
     static shadowRootOptions: ShadowRootInit;
     static styles: import("lit").CSSResult[];
-    /**
-     * Date value this cell represents. Attribute reads as local time (not UTC).
-     * Required. Takes both attribute (static HTML) and property.
-     */
+    /** Date value this cell represents, reading its attribute as local time rather than UTC. */
     date: Date;
     private root;
     private readonly onUpdate;
@@ -27,7 +20,8 @@ export declare class SkdxCalendarCell extends LitElement {
     private get gridMonth();
     private get isDisabled();
     private get isUnavailable();
-    render(): import("lit").TemplateResult<1>;
+    private rootFlags;
+    render(): TemplateResult | typeof nothing;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/calendar/CalendarCell.d.ts

@@ -1,20 +1,13 @@
-import { LitElement } from 'lit';
+import { LitElement, nothing, type TemplateResult } from 'lit';
 /**
- * Single selectable date in a `<skdx-calendar>`. Renders a native `<button>` with
- * roving `tabindex`. `aria-selected`, `data-today`, `data-outside-month`, and range
- * state (`data-range-start` / `-middle` / `-end`). In range mode, all cells from start to end
- * are selected. Two refusal modes: **disabled** (not focusable, no clicks); **unavailable**
- * (focusable, `aria-disabled="true"`, click moves focus only).
+ * Single selectable date in a `<skdx-calendar>`, rendered as a native `<button>` with roving `tabindex`.
  *
  * @csspart cell - Native `<button>` element inside shadow root.
  */
 export declare class SkdxCalendarCell extends LitElement {
     static shadowRootOptions: ShadowRootInit;
     static styles: import("lit").CSSResult[];
-    /**
-     * Date value this cell represents. Attribute reads as local time (not UTC).
-     * Required. Takes both attribute (static HTML) and property.
-     */
+    /** Date value this cell represents, reading its attribute as local time rather than UTC. */
     date: Date;
     private root;
     private readonly onUpdate;
@@ -27,7 +20,8 @@ export declare class SkdxCalendarCell extends LitElement {
     private get gridMonth();
     private get isDisabled();
     private get isUnavailable();
-    render(): import("lit").TemplateResult<1>;
+    private rootFlags;
+    render(): TemplateResult | typeof nothing;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/calendar/CalendarCell.js

@@ -1,29 +1,29 @@
-var $=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var h=(l,n,t,e)=>{for(var a=e>1?void 0:e?k(n,t):n,i=l.length-1,s;i>=0;i--)(s=l[i])&&(a=(e?s(n,t,a):s(a))||a);return e&&a&&$(n,t,a),a};import{css as M,html as y,LitElement as x,nothing as d}from"lit";import{property as U}from"lit/decorators.js";import{toDate as S}from"../internal/date-value.js";import{customElement as E}from"../internal/define.js";import{reflectHostState as L}from"../internal/part.js";import{controlBoxOnHost as O,delegatesFocusShadowRootOptions as A,resetNativeControl as w}from"../internal/styles.js";import{isDateDisabled as G,isDateRange as p,isDateSelected as v,isSameDay as u,isSameMonth as r,rangePositionOf as g,toISODateString as b}from"./Calendar.js";import{formatDateLabel as H}from"./locale.js";var o=class extends x{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleClick=()=>{let t=this.root;if(!t||this.isDisabled)return;if(this.isUnavailable){t.setFocusedDate(this.date);return}t.setValue(this.date);let e=this.gridMonth;e&&!r(this.date,e)&&!t.months.some(a=>r(this.date,a))&&t.setMonth(this.date)}}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-calendar"),this.root?.addEventListener("skdx-calendar-internal-update",this.onUpdate),this.date&&this.setAttribute("data-skdx-calendar-cell",b(this.date))}disconnectedCallback(){this.root?.removeEventListener("skdx-calendar-internal-update",this.onUpdate),super.disconnectedCallback()}willUpdate(){this.date&&this.setAttribute("data-skdx-calendar-cell",b(this.date))}updated(){let t=this.root,e=this.gridMonth,a=t?v(t.value,this.date):!1,i=t&&p(t.value)?g(t.value,this.date):void 0;L(this,{"data-state":a?"selected":null,"data-today":t&&u(this.date,t.todayDate)?"":null,"data-outside-month":e&&!r(this.date,e)?"":null,"data-disabled":this.isDisabled?"":null,"data-unavailable":this.isUnavailable?"":null,"data-range-start":i==="start"?"":null,"data-range-middle":i==="middle"?"":null,"data-range-end":i==="end"?"":null})}get gridMonth(){return this.closest("skdx-calendar-grid")?.gridMonth??this.root?.month}get isDisabled(){let t=this.root;if(!t)return!1;let e=this.gridMonth,a=e?!r(this.date,e):!1,{disabled:i,isDateDisabled:s}=t.resolvedDisabled;return i||a&&!t.outsideDaySelectable||G(this.date,t.minDate,t.maxDate,s)}get isUnavailable(){return this.isDisabled?!1:this.root?.isDateUnavailable?.(this.date)??!1}render(){let t=this.root,e=this.gridMonth,a=e?!r(this.date,e):!1,i=this.isDisabled,s=this.isUnavailable,f=t?v(t.value,this.date):!1,c=t&&p(t.value)?g(t.value,this.date):void 0,m=t?u(this.date,t.todayDate):!1,D=t?u(this.date,t.focusedDate):!1;return y`
+var M=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var h=(l,n,t,e)=>{for(var a=e>1?void 0:e?$(n,t):n,i=l.length-1,s;i>=0;i--)(s=l[i])&&(a=(e?s(n,t,a):s(a))||a);return e&&a&&M(n,t,a),a};import{css as k,html as x,LitElement as U,nothing as o}from"lit";import{property as P}from"lit/decorators.js";import{formatDateLabel as R}from"../internal/calendar-locale.js";import{toDate as L}from"../internal/date-value.js";import{customElement as S}from"../internal/define.js";import{reflectHostState as A}from"../internal/part.js";import{controlBoxOnHost as E,delegatesFocusShadowRootOptions as F,resetNativeControl as O}from"../internal/styles.js";import{isDateDisabled as T,isDateRange as g,isDateSelected as v,isSameDay as u,isSameMonth as r,rangePositionOf as D,toISODateString as f}from"./Calendar.js";import{CALENDAR_FAMILY as m}from"./family.js";var d=class extends U{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleClick=()=>{let t=this.root;if(!t||this.isDisabled)return;if(this.isUnavailable){t.setFocusedDate(this.date);return}t.setValue(this.date),t.setFocusedDate(this.date);let e=this.gridMonth;e&&!r(this.date,e)&&!t.months.some(a=>r(this.date,a))&&t.setMonth(this.date)}}connectedCallback(){super.connectedCallback(),this.root=m.root(this),this.root?.addEventListener(m.event,this.onUpdate),this.date&&this.setAttribute("data-skdx-calendar-cell",f(this.date))}disconnectedCallback(){this.root?.removeEventListener(m.event,this.onUpdate),super.disconnectedCallback()}willUpdate(){this.date&&this.setAttribute("data-skdx-calendar-cell",f(this.date))}updated(){let t=this.root,e=this.gridMonth,a=t?v(t.value,this.date):!1,i=t&&g(t.value)?D(t.value,this.date):void 0;A(this,{"data-state":a?"selected":null,"data-today":t&&u(this.date,t.todayDate)?"":null,"data-outside-month":e&&!r(this.date,e)?"":null,"data-disabled":this.isDisabled?"":null,"data-unavailable":this.isUnavailable?"":null,"data-range-start":i==="start"?"":null,"data-range-middle":i==="middle"?"":null,"data-range-end":i==="end"?"":null})}get gridMonth(){return this.closest("skdx-calendar-grid")?.gridMonth??this.root?.month}get isDisabled(){let t=this.root;if(!t)return!1;let e=this.gridMonth,a=e?!r(this.date,e):!1,{disabled:i,isDateDisabled:s}=t.resolvedDisabled;return i||a&&!t.outsideDaySelectable||T(this.date,t.minDate,t.maxDate,s)}get isUnavailable(){return this.isDisabled?!1:this.root?.isDateUnavailable?.(this.date)??!1}rootFlags(){let t=this.root;return t?{selected:v(t.value,this.date),rangePosition:g(t.value)?D(t.value,this.date):void 0,today:u(this.date,t.todayDate),focused:u(this.date,t.focusedDate)}:{selected:!1,rangePosition:void 0,today:!1,focused:!1}}render(){if(!this.date)return o;let t=this.root,e=this.gridMonth,a=e?!r(this.date,e):!1,i=this.isDisabled,s=this.isUnavailable,{selected:p,rangePosition:c,today:b,focused:y}=this.rootFlags();return x`
       <button
         part="cell"
         type="button"
         role="gridcell"
-        aria-selected=${f}
-        aria-disabled=${s?"true":d}
-        aria-current=${m?"date":d}
-        aria-label=${H(this.date,t?.locale)}
-        data-skdx-calendar-cell=${b(this.date)}
-        data-state=${f?"selected":d}
-        data-today=${m?"":d}
-        data-outside-month=${a?"":d}
-        data-disabled=${i?"":d}
-        data-unavailable=${s?"":d}
-        data-range-start=${c==="start"?"":d}
-        data-range-middle=${c==="middle"?"":d}
-        data-range-end=${c==="end"?"":d}
-        tabindex=${D?0:-1}
+        aria-selected=${p}
+        aria-disabled=${s?"true":o}
+        aria-current=${b?"date":o}
+        aria-label=${R(this.date,t?.locale)}
+        data-skdx-calendar-cell=${f(this.date)}
+        data-state=${p?"selected":o}
+        data-today=${b?"":o}
+        data-outside-month=${a?"":o}
+        data-disabled=${i?"":o}
+        data-unavailable=${s?"":o}
+        data-range-start=${c==="start"?"":o}
+        data-range-middle=${c==="middle"?"":o}
+        data-range-end=${c==="end"?"":o}
+        tabindex=${y?0:-1}
         ?disabled=${i}
         @click=${this.handleClick}
       >
         <slot>${this.date.getDate()}</slot>
       </button>
-    `}};o.shadowRootOptions=A,o.styles=[w,M`
+    `}};d.shadowRootOptions=F,d.styles=[O,k`
       :host {
         display: inline-block;
       }
-    `,O],h([U({converter:{fromAttribute:t=>t==null?void 0:S(t,"date")??void 0,toAttribute:()=>{}}})],o.prototype,"date",2),o=h([E("skdx-calendar-cell","calendar","cell")],o);export{o as SkdxCalendarCell};
+    `,E],h([P({converter:{fromAttribute:t=>t==null?void 0:L(t,"date")??void 0}})],d.prototype,"date",2),d=h([S("skdx-calendar-cell","calendar","cell")],d);export{d as SkdxCalendarCell};

package/dist/calendar/CalendarGrid.cjs

@@ -1,11 +1,10 @@
-"use strict";var l=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var D=(a,s)=>{for(var r in s)l(a,r,{get:s[r],enumerable:!0})},k=(a,s,r,e)=>{if(s&&typeof s=="object"||typeof s=="function")for(let t of v(s))!y.call(a,t)&&t!==r&&l(a,t,{get:()=>s[t],enumerable:!(e=m(s,t))||e.enumerable});return a};var g=a=>k(l({},"__esModule",{value:!0}),a),c=(a,s,r,e)=>{for(var t=e>1?void 0:e?m(s,r):s,i=a.length-1,h;i>=0;i--)(h=a[i])&&(t=(e?h(s,r,t):h(t))||t);return e&&t&&l(s,r,t),t};var w={};D(w,{SkdxCalendarGrid:()=>n});module.exports=g(w);var d=require("lit"),u=require("lit/decorators.js"),f=require("../internal/define.cjs"),b=require("../internal/direction.cjs"),o=require("./Calendar.cjs"),p=require("./locale.cjs");var n=class extends d.LitElement{constructor(){super(...arguments);this.monthOffset=0;this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleKeyDown=r=>{let e=this.root;if(!e)return;let t;switch((0,b.directionalKey)(r.key,this)){case"ArrowLeft":t=(0,o.addDays)(e.focusedDate,-1);break;case"ArrowRight":t=(0,o.addDays)(e.focusedDate,1);break;case"ArrowUp":t=(0,o.addDays)(e.focusedDate,-7);break;case"ArrowDown":t=(0,o.addDays)(e.focusedDate,7);break;case"Home":t=(0,o.startOfWeek)(e.focusedDate,e.resolvedWeekStartsOn);break;case"End":t=(0,o.endOfWeek)(e.focusedDate,e.resolvedWeekStartsOn);break;case"PageUp":t=r.shiftKey?(0,o.addYears)(e.focusedDate,-1):(0,o.addMonths)(e.focusedDate,-1);break;case"PageDown":t=r.shiftKey?(0,o.addYears)(e.focusedDate,1):(0,o.addMonths)(e.focusedDate,1);break;default:return}r.preventDefault(),this.moveFocus(t)}}get gridMonth(){let r=this.root;if(r)return r.months[this.monthOffset]??r.month}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-calendar"),this.setAttribute("role","grid"),this.root?.addEventListener("skdx-calendar-internal-update",this.onUpdate),this.addEventListener("keydown",this.handleKeyDown)}disconnectedCallback(){this.root?.removeEventListener("skdx-calendar-internal-update",this.onUpdate),this.removeEventListener("keydown",this.handleKeyDown),super.disconnectedCallback()}willUpdate(){let r=(this.root?.view??"day")==="day";if(this.hidden=!r,!r){this.removeAttribute("role"),this.removeAttribute("aria-label"),this.removeAttribute("aria-multiselectable");return}this.setAttribute("role","grid"),this.setAttribute("aria-multiselectable",String((this.root?.selectionMode??"single")!=="single"));let e=this.gridMonth;this.setAttribute("aria-label",this.label??(e?(0,p.formatMonthLabel)(e,this.root?.locale):""));for(let[t,i]of[["aria-readonly",this.root?.readOnly??!1],["aria-disabled",this.root?.resolvedDisabled.disabled??!1]])i?this.setAttribute(t,"true"):this.removeAttribute(t)}moveFocus(r){let e=this.root;if(!e)return;let t=(0,o.clampToDateRange)(r,e.minDate,e.maxDate);e.months.some(i=>(0,o.isSameMonth)(t,i))||e.setMonth((0,o.startOfMonth)(t)),e.setFocusedDate(t),requestAnimationFrame(()=>{let i=(0,o.toISODateString)(t);e.querySelector(`[data-skdx-calendar-cell="${i}"]:not([disabled])`)?.focus()})}render(){return d.html`<slot></slot>`}};n.styles=d.css`
+"use strict";var l=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var A=(a,s)=>{for(var o in s)l(a,o,{get:s[o],enumerable:!0})},k=(a,s,o,e)=>{if(s&&typeof s=="object"||typeof s=="function")for(let t of y(s))!D.call(a,t)&&t!==o&&l(a,t,{get:()=>s[t],enumerable:!(e=f(s,t))||e.enumerable});return a};var g=a=>k(l({},"__esModule",{value:!0}),a),h=(a,s,o,e)=>{for(var t=e>1?void 0:e?f(s,o):s,i=a.length-1,u;i>=0;i--)(u=a[i])&&(t=(e?u(s,o,t):u(t))||t);return e&&t&&l(s,o,t),t};var w={};A(w,{SkdxCalendarGrid:()=>n});module.exports=g(w);var d=require("lit"),m=require("lit/decorators.js"),b=require("../internal/calendar-locale.cjs"),p=require("../internal/define.cjs"),v=require("../internal/direction.cjs"),r=require("./Calendar.cjs"),c=require("./family.cjs");var n=class extends d.LitElement{constructor(){super(...arguments);this.monthOffset=0;this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleKeyDown=o=>{let e=this.root;if(!e)return;let t;switch((0,v.directionalKey)(o.key,this)){case"ArrowLeft":t=(0,r.addDays)(e.focusedDate,-1);break;case"ArrowRight":t=(0,r.addDays)(e.focusedDate,1);break;case"ArrowUp":t=(0,r.addDays)(e.focusedDate,-7);break;case"ArrowDown":t=(0,r.addDays)(e.focusedDate,7);break;case"Home":t=(0,r.startOfWeek)(e.focusedDate,e.resolvedWeekStartsOn);break;case"End":t=(0,r.endOfWeek)(e.focusedDate,e.resolvedWeekStartsOn);break;case"PageUp":t=o.shiftKey?(0,r.addYears)(e.focusedDate,-1):(0,r.addMonths)(e.focusedDate,-1);break;case"PageDown":t=o.shiftKey?(0,r.addYears)(e.focusedDate,1):(0,r.addMonths)(e.focusedDate,1);break;default:return}o.preventDefault(),this.moveFocus(t)}}get gridMonth(){let o=this.root;if(o)return o.months[this.monthOffset]??o.month}connectedCallback(){super.connectedCallback(),this.root=c.CALENDAR_FAMILY.root(this),this.setAttribute("role","grid"),this.root?.addEventListener(c.CALENDAR_FAMILY.event,this.onUpdate),this.addEventListener("keydown",this.handleKeyDown)}disconnectedCallback(){this.root?.removeEventListener(c.CALENDAR_FAMILY.event,this.onUpdate),this.removeEventListener("keydown",this.handleKeyDown),super.disconnectedCallback()}willUpdate(){let o=(this.root?.view??"day")==="day";if(this.hidden=!o,!o){this.removeAttribute("role"),this.removeAttribute("aria-label"),this.removeAttribute("aria-multiselectable");return}this.setAttribute("role","grid"),this.setAttribute("aria-multiselectable",String((this.root?.selectionMode??"single")!=="single")),this.syncAriaLabel();for(let[e,t]of[["aria-readonly",this.root?.readOnly??!1],["aria-disabled",this.root?.resolvedDisabled.disabled??!1]])t?this.setAttribute(e,"true"):this.removeAttribute(e)}syncAriaLabel(){if(this.label!==void 0){this.setAttribute("aria-label",this.label);return}if(this.hasAttribute("aria-labelledby")){this.removeAttribute("aria-label");return}let o=this.gridMonth;this.setAttribute("aria-label",o?(0,b.formatMonthLabel)(o,this.root?.locale):"")}moveFocus(o){let e=this.root;if(!e)return;let t=(0,r.clampToDateRange)(o,e.minDate,e.maxDate);e.months.some(i=>(0,r.isSameMonth)(t,i))||e.setMonth((0,r.startOfMonth)(t)),e.setFocusedDate(t),requestAnimationFrame(()=>{let i=(0,r.toISODateString)(t);e.querySelector(`[data-skdx-calendar-cell="${i}"]:not([disabled])`)?.focus()})}render(){return d.html`<slot></slot>`}};n.styles=d.css`
     :host {
       display: block;
     }
 
-    /* Shadow styles override UA [hidden], so :host rule prevents
-       a role-less empty grid. */
+    /* :host rule needed since shadow styles would otherwise beat the UA's [hidden]. */
     :host([hidden]) {
       display: none;
     }
-  `,c([(0,u.property)({type:Number,attribute:"month-offset"})],n.prototype,"monthOffset",2),c([(0,u.property)({type:String})],n.prototype,"label",2),n=c([(0,f.customElement)("skdx-calendar-grid","calendar","grid")],n);0&&(module.exports={SkdxCalendarGrid});
+  `,h([(0,m.property)({type:Number,attribute:"month-offset"})],n.prototype,"monthOffset",2),h([(0,m.property)({type:String})],n.prototype,"label",2),n=h([(0,p.customElement)("skdx-calendar-grid","calendar","grid")],n);0&&(module.exports={SkdxCalendarGrid});

package/dist/calendar/CalendarGrid.d.cts

@@ -1,12 +1,6 @@
-import { LitElement } from 'lit';
+import { LitElement, type TemplateResult } from 'lit';
 /**
- * Grid container for `<skdx-calendar>` dates with roving-focus navigation:
- * arrows move by day/week, Home/End jump week bounds, PageUp/PageDown move by
- * month (Shift+PageUp/Down by year). Navigating outside displayed months
- * updates the calendar's month.
- *
- * For multi-month calendars, create one grid per month with `month-offset` to
- * mark outside dates.
+ * Grid container for `<skdx-calendar>` dates with roving-focus navigation via arrows, Home/End, and PageUp/PageDown.
  */
 export declare class SkdxCalendarGrid extends LitElement {
     static styles: import("lit").CSSResult;
@@ -17,28 +11,21 @@ export declare class SkdxCalendarGrid extends LitElement {
      */
     monthOffset: number;
     /**
-     * Overrides the grid's accessible name, which defaults to the locale-formatted
-     * month. Grids have no implicit name, so unnamed ones announce bare "grid";
-     * with `number-of-months > 1`, several identical-sounding grids confuse
-     * screen readers. Defaults to the same month label as
-     * `<skdx-calendar-heading>` for consistency. Since the host is the grid,
-     * markup `aria-label` is overwritten; set this property instead.
+     * Overrides the grid's accessible name, which otherwise defaults to the locale-formatted month.
      * @default undefined — the locale-formatted month.
      */
     label?: string;
     private root;
     private readonly onUpdate;
-    /**
-     * The month this grid renders — read by cells instead of the root's month,
-     * so they know which month they belong to in multi-month calendars.
-     */
+    /** The month this grid renders, since cells read it instead of the root's month. */
     get gridMonth(): Date | undefined;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected willUpdate(): void;
+    private syncAriaLabel;
     private moveFocus;
     private readonly handleKeyDown;
-    render(): import("lit").TemplateResult<1>;
+    render(): TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {