@skdx/web-components 0.26.0 → 0.28.0

package/dist/calendar/CalendarViewGrid.js

@@ -0,0 +1,25 @@
+var F=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var m=(c,i,e,t)=>{for(var o=t>1?void 0:t?I(i,e):i,r=c.length-1,n;r>=0;r--)(n=c[r])&&(o=(t?n(i,e,o):n(o))||o);return t&&o&&F(i,e,o),o};import{html as g,LitElement as P,nothing as d}from"lit";import{property as R}from"lit/decorators.js";import{customElement as E}from"../internal/define.js";import{directionalKey as T}from"../internal/direction.js";import{installLightDomStyles as Y}from"../internal/styles.js";import{announce as K}from"../utils/live-announcer.js";import{addMonths as A,anchorOf as _,CALENDAR_YEAR_PAGE as H,clampToMonth as N,formatViewPageLabel as D,getDaysInMonth as V,hasAvailableDate as q,yearPageStart as O}from"./Calendar.js";import{formatMonthLabel as S,formatYear as x,getMonthNames as W}from"./locale.js";var u=4,h=class extends P{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.handleKeyDown=e=>{if(!this.root||!this.active)return;let t=this.cellCount,o=this.focusedIndex,r;switch(T(e.key,this)){case"ArrowLeft":r=-1;break;case"ArrowRight":r=1;break;case"ArrowUp":r=-u;break;case"ArrowDown":r=u;break;case"Home":r=-o;break;case"End":r=t-1-o;break;case"PageUp":r=-t*(e.shiftKey?10:1);break;case"PageDown":r=t*(e.shiftKey?10:1);break;default:return}e.preventDefault(),r!==0&&this.moveBy(r)}}createRenderRoot(){return this}get monthsPerUnit(){return this.unit==="month"?1:12}get cellCount(){return this.unit==="month"?12:H}get active(){return(this.root?.view??"day")===this.unit}get focusedIndex(){let e=this.root?.focusedDate;return e?this.unit==="month"?e.getMonth():e.getFullYear()-O(e.getFullYear()):0}get cells(){let e=this.root;if(!e)return[];let{locale:t,minDate:o,maxDate:r}=e,n=e.resolvedDisabled.isDateDisabled,l=_(e.value),p=e.todayDate,v=e.focusedDate,L=this.focusedIndex,C=W(t,"short"),w=v.getFullYear();return Array.from({length:this.cellCount},(j,s)=>{let k=this.unit==="month"?N(v,new Date(w,s,1)):A(v,(s-L)*this.monthsPerUnit),a=this.unit==="month"?w:k.getFullYear(),M=this.unit==="month"?new Date(a,s,1):new Date(a,0,1),U=this.unit==="month"?new Date(a,s,V(a,s)):new Date(a,11,31),$=y=>y!==null&&y.getFullYear()===a&&(this.unit==="year"||y.getMonth()===s);return{date:k,key:this.unit==="month"?`${a}-${s}`:String(a),text:this.unit==="month"?C[s]:x(a,t),label:this.unit==="month"?S(new Date(a,s,1),t):x(a,t),refused:!q(M,U,o,r,n),selected:$(l),today:$(p)}})}connectedCallback(){super.connectedCallback(),Y(),this.root=this.closest("skdx-calendar"),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 e=this.active;if(this.hidden=!e,!e){this.removeAttribute("role"),this.removeAttribute("aria-label");return}let t=this.root;this.setAttribute("role","grid"),this.setAttribute("aria-label",this.label??(t?D(t.focusedDate,this.unit,t.locale):""));for(let[o,r]of[["aria-readonly",t?.readOnly??!1],["aria-disabled",t?.resolvedDisabled.disabled??!1]])r?this.setAttribute(o,"true"):this.removeAttribute(o)}moveBy(e){let t=this.root;if(!t)return;let o=t.focusedDate,r=A(o,e*this.monthsPerUnit),n=D(o,this.unit,t.locale),l=D(r,this.unit,t.locale);t.setFocusedDate(r),l!==n&&K(l),requestAnimationFrame(()=>{let p=this.unit==="month"?`${r.getFullYear()}-${r.getMonth()}`:String(r.getFullYear());this.querySelector(`[data-skdx-calendar-view-cell="${p}"]`)?.focus()})}renderCell(e,t){return g`
+      <button
+        class="skdx-calendar__view-cell"
+        type="button"
+        role="gridcell"
+        aria-disabled=${e.refused?"true":d}
+        aria-selected=${e.selected}
+        aria-current=${e.today?"date":d}
+        aria-label=${e.label}
+        data-skdx-calendar-view-cell=${e.key}
+        data-state=${e.selected?"selected":d}
+        data-today=${e.today?"":d}
+        data-disabled=${e.refused?"":d}
+        tabindex=${t===this.focusedIndex?0:-1}
+        @click=${()=>{e.refused||this.root?.navigateToUnit(e.date)}}
+      >
+        ${e.text}
+      </button>
+    `}render(){if(!this.active)return d;let e=this.cells,t=[];for(let o=0;o<e.length;o+=u)t.push(e.slice(o,o+u));return g`
+      <div role="rowgroup">
+        ${t.map((o,r)=>g`<div role="row">
+              ${o.map((n,l)=>this.renderCell(n,r*u+l))}
+            </div>`)}
+      </div>
+    `}};m([R({type:String})],h.prototype,"label",2);var f=class extends h{constructor(){super(...arguments);this.unit="month"}};f=m([E("skdx-calendar-month-grid","calendar","month-grid")],f);var b=class extends h{constructor(){super(...arguments);this.unit="year"}};b=m([E("skdx-calendar-year-grid","calendar","year-grid")],b);export{f as SkdxCalendarMonthGrid,b as SkdxCalendarYearGrid};

package/dist/calendar/CalendarWeekNumber.cjs

@@ -0,0 +1,5 @@
+"use strict";var a=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var w=(i,e)=>{for(var t in e)a(i,t,{get:e[t],enumerable:!0})},b=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of v(e))!x.call(i,r)&&r!==t&&a(i,r,{get:()=>e[r],enumerable:!(n=h(e,r))||n.enumerable});return i};var k=i=>b(a({},"__esModule",{value:!0}),i),c=(i,e,t,n)=>{for(var r=n>1?void 0:n?h(e,t):e,s=i.length-1,l;s>=0;s--)(l=i[s])&&(r=(n?l(e,t,r):l(r))||r);return n&&r&&a(e,t,r),r};var T={};w(T,{SkdxCalendarWeekNumber:()=>o});module.exports=k(T);var d=require("lit"),p=require("lit/decorators.js"),u=require("../internal/date-value.cjs"),m=require("../internal/define.cjs"),f=require("./Calendar.cjs");var o=class extends d.LitElement{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.ownText=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-calendar"),this.root?.addEventListener("skdx-calendar-internal-update",this.onUpdate),this.setAttribute("role","rowheader")}disconnectedCallback(){this.root?.removeEventListener("skdx-calendar-internal-update",this.onUpdate),super.disconnectedCallback()}willUpdate(){if(!this.date)return;let t=(0,f.getISOWeek)(this.date);this.setAttribute("aria-label",`Week ${t}`),!(this.firstChild&&this.firstChild!==this.ownText)&&(this.ownText||(this.ownText=document.createTextNode(""),this.replaceChildren(this.ownText)),this.ownText.data=String(t))}render(){return d.html`<slot></slot>`}};o.styles=d.css`
+    :host {
+      display: block;
+    }
+  `,c([(0,p.property)({converter:{fromAttribute:t=>t==null?void 0:(0,u.toDate)(t,"date")??void 0,toAttribute:()=>{}}})],o.prototype,"date",2),o=c([(0,m.customElement)("skdx-calendar-week-number","calendar","week-number")],o);0&&(module.exports={SkdxCalendarWeekNumber});

package/dist/calendar/CalendarWeekNumber.d.cts

@@ -0,0 +1,33 @@
+import { LitElement } from 'lit';
+/**
+ * `<skdx-calendar-week-number>` — ISO-8601 week number as `role="rowheader"`
+ * at the start of a week row. ISO 8601 numbers weeks from Monday and is
+ * independent of `week-starts-on`.
+ *
+ * @example
+ * ```html
+ * <skdx-calendar-row>
+ *   <skdx-calendar-week-number date="2026-01-05"></skdx-calendar-week-number>
+ *   <skdx-calendar-cell date="2026-01-05"></skdx-calendar-cell>
+ * </skdx-calendar-row>
+ * ```
+ */
+export declare class SkdxCalendarWeekNumber extends LitElement {
+    static styles: import("lit").CSSResult;
+    /**
+     * Any day of the week to number; treated as local time.
+     */
+    date: Date;
+    private root;
+    private readonly onUpdate;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private ownText;
+    protected willUpdate(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-calendar-week-number': SkdxCalendarWeekNumber;
+    }
+}

package/dist/calendar/CalendarWeekNumber.d.ts

@@ -0,0 +1,33 @@
+import { LitElement } from 'lit';
+/**
+ * `<skdx-calendar-week-number>` — ISO-8601 week number as `role="rowheader"`
+ * at the start of a week row. ISO 8601 numbers weeks from Monday and is
+ * independent of `week-starts-on`.
+ *
+ * @example
+ * ```html
+ * <skdx-calendar-row>
+ *   <skdx-calendar-week-number date="2026-01-05"></skdx-calendar-week-number>
+ *   <skdx-calendar-cell date="2026-01-05"></skdx-calendar-cell>
+ * </skdx-calendar-row>
+ * ```
+ */
+export declare class SkdxCalendarWeekNumber extends LitElement {
+    static styles: import("lit").CSSResult;
+    /**
+     * Any day of the week to number; treated as local time.
+     */
+    date: Date;
+    private root;
+    private readonly onUpdate;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private ownText;
+    protected willUpdate(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-calendar-week-number': SkdxCalendarWeekNumber;
+    }
+}

package/dist/calendar/CalendarWeekNumber.js

@@ -0,0 +1,5 @@
+var l=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var s=(o,i,e,n)=>{for(var t=n>1?void 0:n?c(i,e):i,d=o.length-1,a;d>=0;d--)(a=o[d])&&(t=(n?a(i,e,t):a(t))||t);return n&&t&&l(i,e,t),t};import{css as h,html as p,LitElement as u}from"lit";import{property as m}from"lit/decorators.js";import{toDate as f}from"../internal/date-value.js";import{customElement as v}from"../internal/define.js";import{getISOWeek as x}from"./Calendar.js";var r=class extends u{constructor(){super(...arguments);this.root=null;this.onUpdate=()=>this.requestUpdate();this.ownText=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-calendar"),this.root?.addEventListener("skdx-calendar-internal-update",this.onUpdate),this.setAttribute("role","rowheader")}disconnectedCallback(){this.root?.removeEventListener("skdx-calendar-internal-update",this.onUpdate),super.disconnectedCallback()}willUpdate(){if(!this.date)return;let e=x(this.date);this.setAttribute("aria-label",`Week ${e}`),!(this.firstChild&&this.firstChild!==this.ownText)&&(this.ownText||(this.ownText=document.createTextNode(""),this.replaceChildren(this.ownText)),this.ownText.data=String(e))}render(){return p`<slot></slot>`}};r.styles=h`
+    :host {
+      display: block;
+    }
+  `,s([m({converter:{fromAttribute:e=>e==null?void 0:f(e,"date")??void 0,toAttribute:()=>{}}})],r.prototype,"date",2),r=s([v("skdx-calendar-week-number","calendar","week-number")],r);export{r as SkdxCalendarWeekNumber};

package/dist/calendar/CalendarWeekNumberHeader.cjs

@@ -0,0 +1,5 @@
+"use strict";var o=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var p=(r,e)=>{for(var l in e)o(r,l,{get:e[l],enumerable:!0})},f=(r,e,l,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!u.call(r,t)&&t!==l&&o(r,t,{get:()=>e[t],enumerable:!(s=m(e,t))||s.enumerable});return r};var v=r=>f(o({},"__esModule",{value:!0}),r),b=(r,e,l,s)=>{for(var t=s>1?void 0:s?m(e,l):e,c=r.length-1,n;c>=0;c--)(n=r[c])&&(t=(s?n(e,l,t):n(t))||t);return s&&t&&o(e,l,t),t};var k={};p(k,{SkdxCalendarWeekNumberHeader:()=>a});module.exports=v(k);var i=require("lit"),d=require("../internal/define.cjs");var a=class extends i.LitElement{connectedCallback(){super.connectedCallback(),this.setAttribute("role","columnheader"),this.hasAttribute("aria-label")||this.setAttribute("aria-label","Week number")}render(){return i.html`<slot></slot>`}};a.styles=i.css`
+    :host {
+      display: block;
+    }
+  `,a=b([(0,d.customElement)("skdx-calendar-week-number-header","calendar","week-number-header")],a);0&&(module.exports={SkdxCalendarWeekNumberHeader});

package/dist/calendar/CalendarWeekNumberHeader.d.cts

@@ -0,0 +1,23 @@
+import { LitElement } from 'lit';
+/**
+ * Columnheader above week-number column; visually blank, named via aria-label.
+ * Necessary for grid alignment: eight cells in body but seven columnheaders without it.
+ *
+ * @example
+ * ```html
+ * <skdx-calendar-row>
+ *   <skdx-calendar-week-number-header>Wk</skdx-calendar-week-number-header>
+ *   <skdx-calendar-week-day aria-label="Monday">Mo</skdx-calendar-week-day>
+ * </skdx-calendar-row>
+ * ```
+ */
+export declare class SkdxCalendarWeekNumberHeader extends LitElement {
+    static styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-calendar-week-number-header': SkdxCalendarWeekNumberHeader;
+    }
+}

package/dist/calendar/CalendarWeekNumberHeader.d.ts

@@ -0,0 +1,23 @@
+import { LitElement } from 'lit';
+/**
+ * Columnheader above week-number column; visually blank, named via aria-label.
+ * Necessary for grid alignment: eight cells in body but seven columnheaders without it.
+ *
+ * @example
+ * ```html
+ * <skdx-calendar-row>
+ *   <skdx-calendar-week-number-header>Wk</skdx-calendar-week-number-header>
+ *   <skdx-calendar-week-day aria-label="Monday">Mo</skdx-calendar-week-day>
+ * </skdx-calendar-row>
+ * ```
+ */
+export declare class SkdxCalendarWeekNumberHeader extends LitElement {
+    static styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'skdx-calendar-week-number-header': SkdxCalendarWeekNumberHeader;
+    }
+}

package/dist/calendar/CalendarWeekNumberHeader.js

@@ -0,0 +1,5 @@
+var n=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var c=(s,r,a,l)=>{for(var e=l>1?void 0:l?m(r,a):r,i=s.length-1,o;i>=0;i--)(o=s[i])&&(e=(l?o(r,a,e):o(e))||e);return l&&e&&n(r,a,e),e};import{css as b,html as d,LitElement as h}from"lit";import{customElement as u}from"../internal/define.js";var t=class extends h{connectedCallback(){super.connectedCallback(),this.setAttribute("role","columnheader"),this.hasAttribute("aria-label")||this.setAttribute("aria-label","Week number")}render(){return d`<slot></slot>`}};t.styles=b`
+    :host {
+      display: block;
+    }
+  `,t=c([u("skdx-calendar-week-number-header","calendar","week-number-header")],t);export{t as SkdxCalendarWeekNumberHeader};

package/dist/calendar/index.cjs

@@ -1 +1 @@
-"use strict";var d=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var M=(o,t)=>{for(var n in t)d(o,n,{get:t[n],enumerable:!0})},O=(o,t,n,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of g(t))!h.call(o,r)&&r!==n&&d(o,r,{get:()=>t[r],enumerable:!(l=D(t,r))||l.enumerable});return o};var W=o=>O(d({},"__esModule",{value:!0}),o);var u={};M(u,{SkdxCalendar:()=>x.SkdxCalendar,SkdxCalendarCell:()=>c.SkdxCalendarCell,SkdxCalendarGrid:()=>f.SkdxCalendarGrid,SkdxCalendarGridBody:()=>C.SkdxCalendarGridBody,SkdxCalendarGridHead:()=>S.SkdxCalendarGridHead,SkdxCalendarHeader:()=>i.SkdxCalendarHeader,SkdxCalendarHeading:()=>m.SkdxCalendarHeading,SkdxCalendarNextButton:()=>p.SkdxCalendarNextButton,SkdxCalendarPreviousButton:()=>s.SkdxCalendarPreviousButton,SkdxCalendarRow:()=>y.SkdxCalendarRow,SkdxCalendarWeekDay:()=>k.SkdxCalendarWeekDay,addDays:()=>e.addDays,addMonths:()=>e.addMonths,addYears:()=>e.addYears,anchorOf:()=>e.anchorOf,clampToMonth:()=>e.clampToMonth,clearLocaleNameCache:()=>a.clearLocaleNameCache,emptySelection:()=>e.emptySelection,endOfWeek:()=>e.endOfWeek,formatDateLabel:()=>a.formatDateLabel,formatMonthLabel:()=>a.formatMonthLabel,getDaysInMonth:()=>e.getDaysInMonth,getLocaleWeekStartsOn:()=>a.getLocaleWeekStartsOn,getMonthNames:()=>a.getMonthNames,getVisibleWeeks:()=>e.getVisibleWeeks,getWeekDayNames:()=>a.getWeekDayNames,isDateDisabled:()=>e.isDateDisabled,isDateRange:()=>e.isDateRange,isDateSelected:()=>e.isDateSelected,isSameDay:()=>e.isSameDay,isSameMonth:()=>e.isSameMonth,nextSelection:()=>e.nextSelection,rangePositionOf:()=>e.rangePositionOf,resolveLocale:()=>a.resolveLocale,selectionAnnouncement:()=>e.selectionAnnouncement,startOfMonth:()=>e.startOfMonth,startOfWeek:()=>e.startOfWeek,stripTime:()=>e.stripTime,toISODateString:()=>e.toISODateString});module.exports=W(u);var x=require("./Calendar.cjs"),i=require("./CalendarHeader.cjs"),m=require("./CalendarHeading.cjs"),s=require("./CalendarPreviousButton.cjs"),p=require("./CalendarNextButton.cjs"),f=require("./CalendarGrid.cjs"),S=require("./CalendarGridHead.cjs"),k=require("./CalendarWeekDay.cjs"),C=require("./CalendarGridBody.cjs"),y=require("./CalendarRow.cjs"),c=require("./CalendarCell.cjs"),e=require("./Calendar.cjs"),a=require("./locale.cjs");0&&(module.exports={SkdxCalendar,SkdxCalendarCell,SkdxCalendarGrid,SkdxCalendarGridBody,SkdxCalendarGridHead,SkdxCalendarHeader,SkdxCalendarHeading,SkdxCalendarNextButton,SkdxCalendarPreviousButton,SkdxCalendarRow,SkdxCalendarWeekDay,addDays,addMonths,addYears,anchorOf,clampToMonth,clearLocaleNameCache,emptySelection,endOfWeek,formatDateLabel,formatMonthLabel,getDaysInMonth,getLocaleWeekStartsOn,getMonthNames,getVisibleWeeks,getWeekDayNames,isDateDisabled,isDateRange,isDateSelected,isSameDay,isSameMonth,nextSelection,rangePositionOf,resolveLocale,selectionAnnouncement,startOfMonth,startOfWeek,stripTime,toISODateString});
+"use strict";var l=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var p=(o,t)=>{for(var r in t)l(o,r,{get:t[r],enumerable:!0})},y=(o,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of m(t))!D.call(o,n)&&n!==r&&l(o,n,{get:()=>t[n],enumerable:!(i=d(t,n))||i.enumerable});return o};var g=o=>y(l({},"__esModule",{value:!0}),o);var c={};p(c,{CALENDAR_VIEWS:()=>e.CALENDAR_VIEWS,CALENDAR_YEAR_PAGE:()=>e.CALENDAR_YEAR_PAGE,SkdxCalendar:()=>s.SkdxCalendar,addDays:()=>e.addDays,addMonths:()=>e.addMonths,addYears:()=>e.addYears,anchorOf:()=>e.anchorOf,clampToMonth:()=>e.clampToMonth,clampView:()=>e.clampView,clearLocaleNameCache:()=>a.clearLocaleNameCache,emptySelection:()=>e.emptySelection,endOfWeek:()=>e.endOfWeek,formatDateLabel:()=>a.formatDateLabel,formatMonthLabel:()=>a.formatMonthLabel,formatViewPageLabel:()=>e.formatViewPageLabel,formatYear:()=>a.formatYear,formatYearRange:()=>a.formatYearRange,getDaysInMonth:()=>e.getDaysInMonth,getISOWeek:()=>e.getISOWeek,getLocaleWeekStartsOn:()=>a.getLocaleWeekStartsOn,getMonthNames:()=>a.getMonthNames,getVisibleWeeks:()=>e.getVisibleWeeks,getWeekDayNames:()=>a.getWeekDayNames,hasAvailableDate:()=>e.hasAvailableDate,isDateDisabled:()=>e.isDateDisabled,isDateRange:()=>e.isDateRange,isDateSelected:()=>e.isDateSelected,isSameDay:()=>e.isSameDay,isSameMonth:()=>e.isSameMonth,nextSelection:()=>e.nextSelection,rangePositionOf:()=>e.rangePositionOf,resolveCalendarDisabled:()=>e.resolveCalendarDisabled,resolveLocale:()=>a.resolveLocale,selectionAnnouncement:()=>e.selectionAnnouncement,startOfMonth:()=>e.startOfMonth,startOfWeek:()=>e.startOfWeek,stripTime:()=>e.stripTime,toISODateString:()=>e.toISODateString,yearPageStart:()=>e.yearPageStart});module.exports=g(c);var s=require("./Calendar.cjs"),e=require("./Calendar.cjs"),a=require("./locale.cjs");0&&(module.exports={CALENDAR_VIEWS,CALENDAR_YEAR_PAGE,SkdxCalendar,addDays,addMonths,addYears,anchorOf,clampToMonth,clampView,clearLocaleNameCache,emptySelection,endOfWeek,formatDateLabel,formatMonthLabel,formatViewPageLabel,formatYear,formatYearRange,getDaysInMonth,getISOWeek,getLocaleWeekStartsOn,getMonthNames,getVisibleWeeks,getWeekDayNames,hasAvailableDate,isDateDisabled,isDateRange,isDateSelected,isSameDay,isSameMonth,nextSelection,rangePositionOf,resolveCalendarDisabled,resolveLocale,selectionAnnouncement,startOfMonth,startOfWeek,stripTime,toISODateString,yearPageStart});

package/dist/calendar/index.d.cts

@@ -1,13 +1,3 @@
 export { SkdxCalendar } from './Calendar.cjs';
-export { SkdxCalendarHeader } from './CalendarHeader.cjs';
-export { SkdxCalendarHeading } from './CalendarHeading.cjs';
-export { SkdxCalendarPreviousButton } from './CalendarPreviousButton.cjs';
-export { SkdxCalendarNextButton } from './CalendarNextButton.cjs';
-export { SkdxCalendarGrid } from './CalendarGrid.cjs';
-export { SkdxCalendarGridHead } from './CalendarGridHead.cjs';
-export { SkdxCalendarWeekDay } from './CalendarWeekDay.cjs';
-export { SkdxCalendarGridBody } from './CalendarGridBody.cjs';
-export { SkdxCalendarRow } from './CalendarRow.cjs';
-export { SkdxCalendarCell } from './CalendarCell.cjs';
-export { getDaysInMonth, startOfMonth, addMonths, addYears, addDays, isSameDay, isSameMonth, startOfWeek, endOfWeek, stripTime, isDateDisabled, toISODateString, clampToMonth, getVisibleWeeks, isDateRange, emptySelection, isDateSelected, rangePositionOf, nextSelection, selectionAnnouncement, anchorOf, type CalendarDay, type CalendarSelectionMode, type CalendarValue, type DateRange, type RangePosition, } from './Calendar.cjs';
-export { resolveLocale, getMonthNames, getWeekDayNames, getLocaleWeekStartsOn, formatMonthLabel, formatDateLabel, clearLocaleNameCache, type NameWidth, } from './locale.cjs';
+export { getDaysInMonth, startOfMonth, addMonths, addYears, addDays, isSameDay, isSameMonth, startOfWeek, endOfWeek, stripTime, isDateDisabled, resolveCalendarDisabled, toISODateString, clampToMonth, clampView, yearPageStart, hasAvailableDate, formatViewPageLabel, getISOWeek, CALENDAR_VIEWS, CALENDAR_YEAR_PAGE, getVisibleWeeks, isDateRange, emptySelection, isDateSelected, rangePositionOf, nextSelection, selectionAnnouncement, anchorOf, type CalendarDay, type ResolvedCalendarDisabled, type CalendarSelectionMode, type CalendarValue, type DateRange, type RangePosition, type CalendarPageBehavior, type CalendarView, } from './Calendar.cjs';
+export { resolveLocale, getMonthNames, getWeekDayNames, getLocaleWeekStartsOn, formatMonthLabel, formatDateLabel, formatYear, formatYearRange, clearLocaleNameCache, type NameWidth, } from './locale.cjs';

package/dist/calendar/index.d.ts

@@ -1,13 +1,3 @@
 export { SkdxCalendar } from './Calendar.js';
-export { SkdxCalendarHeader } from './CalendarHeader.js';
-export { SkdxCalendarHeading } from './CalendarHeading.js';
-export { SkdxCalendarPreviousButton } from './CalendarPreviousButton.js';
-export { SkdxCalendarNextButton } from './CalendarNextButton.js';
-export { SkdxCalendarGrid } from './CalendarGrid.js';
-export { SkdxCalendarGridHead } from './CalendarGridHead.js';
-export { SkdxCalendarWeekDay } from './CalendarWeekDay.js';
-export { SkdxCalendarGridBody } from './CalendarGridBody.js';
-export { SkdxCalendarRow } from './CalendarRow.js';
-export { SkdxCalendarCell } from './CalendarCell.js';
-export { getDaysInMonth, startOfMonth, addMonths, addYears, addDays, isSameDay, isSameMonth, startOfWeek, endOfWeek, stripTime, isDateDisabled, toISODateString, clampToMonth, getVisibleWeeks, isDateRange, emptySelection, isDateSelected, rangePositionOf, nextSelection, selectionAnnouncement, anchorOf, type CalendarDay, type CalendarSelectionMode, type CalendarValue, type DateRange, type RangePosition, } from './Calendar.js';
-export { resolveLocale, getMonthNames, getWeekDayNames, getLocaleWeekStartsOn, formatMonthLabel, formatDateLabel, clearLocaleNameCache, type NameWidth, } from './locale.js';
+export { getDaysInMonth, startOfMonth, addMonths, addYears, addDays, isSameDay, isSameMonth, startOfWeek, endOfWeek, stripTime, isDateDisabled, resolveCalendarDisabled, toISODateString, clampToMonth, clampView, yearPageStart, hasAvailableDate, formatViewPageLabel, getISOWeek, CALENDAR_VIEWS, CALENDAR_YEAR_PAGE, getVisibleWeeks, isDateRange, emptySelection, isDateSelected, rangePositionOf, nextSelection, selectionAnnouncement, anchorOf, type CalendarDay, type ResolvedCalendarDisabled, type CalendarSelectionMode, type CalendarValue, type DateRange, type RangePosition, type CalendarPageBehavior, type CalendarView, } from './Calendar.js';
+export { resolveLocale, getMonthNames, getWeekDayNames, getLocaleWeekStartsOn, formatMonthLabel, formatDateLabel, formatYear, formatYearRange, clearLocaleNameCache, type NameWidth, } from './locale.js';

package/dist/calendar/index.js

@@ -1 +1 @@
-import{SkdxCalendar as t}from"./Calendar.js";import{SkdxCalendarHeader as r}from"./CalendarHeader.js";import{SkdxCalendarHeading as d}from"./CalendarHeading.js";import{SkdxCalendarPreviousButton as x}from"./CalendarPreviousButton.js";import{SkdxCalendarNextButton as m}from"./CalendarNextButton.js";import{SkdxCalendarGrid as p}from"./CalendarGrid.js";import{SkdxCalendarGridHead as S}from"./CalendarGridHead.js";import{SkdxCalendarWeekDay as C}from"./CalendarWeekDay.js";import{SkdxCalendarGridBody as c}from"./CalendarGridBody.js";import{SkdxCalendarRow as g}from"./CalendarRow.js";import{SkdxCalendarCell as M}from"./CalendarCell.js";import{getDaysInMonth as W,startOfMonth as u,addMonths as L,addYears as N,addDays as b,isSameDay as R,isSameMonth as B,startOfWeek as G,endOfWeek as H,stripTime as P,isDateDisabled as v,toISODateString as I,clampToMonth as T,getVisibleWeeks as V,isDateRange as w,emptySelection as A,isDateSelected as Y,rangePositionOf as j,nextSelection as q,selectionAnnouncement as z,anchorOf as E}from"./Calendar.js";import{resolveLocale as J,getMonthNames as K,getWeekDayNames as Q,getLocaleWeekStartsOn as U,formatMonthLabel as X,formatDateLabel as Z,clearLocaleNameCache as _}from"./locale.js";export{t as SkdxCalendar,M as SkdxCalendarCell,p as SkdxCalendarGrid,c as SkdxCalendarGridBody,S as SkdxCalendarGridHead,r as SkdxCalendarHeader,d as SkdxCalendarHeading,m as SkdxCalendarNextButton,x as SkdxCalendarPreviousButton,g as SkdxCalendarRow,C as SkdxCalendarWeekDay,b as addDays,L as addMonths,N as addYears,E as anchorOf,T as clampToMonth,_ as clearLocaleNameCache,A as emptySelection,H as endOfWeek,Z as formatDateLabel,X as formatMonthLabel,W as getDaysInMonth,U as getLocaleWeekStartsOn,K as getMonthNames,V as getVisibleWeeks,Q as getWeekDayNames,v as isDateDisabled,w as isDateRange,Y as isDateSelected,R as isSameDay,B as isSameMonth,q as nextSelection,j as rangePositionOf,J as resolveLocale,z as selectionAnnouncement,u as startOfMonth,G as startOfWeek,P as stripTime,I as toISODateString};
+import{SkdxCalendar as t}from"./Calendar.js";import{getDaysInMonth as n,startOfMonth as r,addMonths as l,addYears as i,addDays as s,isSameDay as d,isSameMonth as m,startOfWeek as D,endOfWeek as p,stripTime as y,isDateDisabled as g,resolveCalendarDisabled as c,toISODateString as f,clampToMonth as S,clampView as h,yearPageStart as C,hasAvailableDate as b,formatViewPageLabel as A,getISOWeek as L,CALENDAR_VIEWS as M,CALENDAR_YEAR_PAGE as O,getVisibleWeeks as R,isDateRange as W,emptySelection as k,isDateSelected as N,rangePositionOf as P,nextSelection as V,selectionAnnouncement as v,anchorOf as x}from"./Calendar.js";import{resolveLocale as I,getMonthNames as Y,getWeekDayNames as w,getLocaleWeekStartsOn as _,formatMonthLabel as u,formatDateLabel as T,formatYear as B,formatYearRange as G,clearLocaleNameCache as j}from"./locale.js";export{M as CALENDAR_VIEWS,O as CALENDAR_YEAR_PAGE,t as SkdxCalendar,s as addDays,l as addMonths,i as addYears,x as anchorOf,S as clampToMonth,h as clampView,j as clearLocaleNameCache,k as emptySelection,p as endOfWeek,T as formatDateLabel,u as formatMonthLabel,A as formatViewPageLabel,B as formatYear,G as formatYearRange,n as getDaysInMonth,L as getISOWeek,_ as getLocaleWeekStartsOn,Y as getMonthNames,R as getVisibleWeeks,w as getWeekDayNames,b as hasAvailableDate,g as isDateDisabled,W as isDateRange,N as isDateSelected,d as isSameDay,m as isSameMonth,V as nextSelection,P as rangePositionOf,c as resolveCalendarDisabled,I as resolveLocale,v as selectionAnnouncement,r as startOfMonth,D as startOfWeek,y as stripTime,f as toISODateString,C as yearPageStart};

package/dist/calendar/locale.cjs

@@ -1 +1 @@
-"use strict";var i=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var h=Object.prototype.hasOwnProperty;var y=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},p=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of D(t))!h.call(e,o)&&o!==n&&i(e,o,{get:()=>t[o],enumerable:!(r=f(t,o))||r.enumerable});return e};var w=e=>p(i({},"__esModule",{value:!0}),e);var k={};y(k,{clearLocaleNameCache:()=>W,formatDateLabel:()=>N,formatMonthLabel:()=>x,getLocaleWeekStartsOn:()=>I,getMonthNames:()=>d,getWeekDayNames:()=>L,resolveLocale:()=>a});module.exports=w(k);var c=new Date(2024,0,7),l=new Map;function g(e,t){let n=l.get(e);if(n)return n;let r=t();return l.set(e,r),r}function a(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function d(e,t="long"){let n=a(e);return g(`m|${n}|${t}`,()=>{let r=new Intl.DateTimeFormat(n,{month:t,timeZone:"UTC"});return Array.from({length:12},(o,s)=>r.format(Date.UTC(2024,s,15)))})}function L(e,t=0,n="short"){let r=a(e),o=g(`w|${r}|${n}`,()=>{let m=new Intl.DateTimeFormat(r,{weekday:n});return Array.from({length:7},(b,u)=>m.format(new Date(c.getFullYear(),c.getMonth(),c.getDate()+u)))}),s=(t%7+7)%7;return o.slice(s).concat(o.slice(0,s))}function I(e){try{let t=new Intl.Locale(a(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function x(e,t){return e.toLocaleDateString(a(t),{month:"long",year:"numeric"})}function N(e,t){return e.toLocaleDateString(a(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function W(){l.clear()}0&&(module.exports={clearLocaleNameCache,formatDateLabel,formatMonthLabel,getLocaleWeekStartsOn,getMonthNames,getWeekDayNames,resolveLocale});
+"use strict";var i=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var y=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},w=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of h(t))!p.call(e,o)&&o!==n&&i(e,o,{get:()=>t[o],enumerable:!(r=D(t,o))||r.enumerable});return e};var b=e=>w(i({},"__esModule",{value:!0}),e);var F={};y(F,{clearLocaleNameCache:()=>k,formatDateLabel:()=>W,formatMonthLabel:()=>L,formatYear:()=>m,formatYearRange:()=>N,getLocaleWeekStartsOn:()=>I,getMonthNames:()=>d,getWeekDayNames:()=>x,resolveLocale:()=>a});module.exports=b(F);var c=new Date(2024,0,7),g=new Map;function u(e,t){let n=g.get(e);if(n)return n;let r=t();return g.set(e,r),r}function a(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function d(e,t="long"){let n=a(e);return u(`m|${n}|${t}`,()=>{let r=new Intl.DateTimeFormat(n,{month:t,timeZone:"UTC"});return Array.from({length:12},(o,s)=>r.format(Date.UTC(2024,s,15)))})}function x(e,t=0,n="short"){let r=a(e),o=u(`w|${r}|${n}`,()=>{let l=new Intl.DateTimeFormat(r,{weekday:n});return Array.from({length:7},($,f)=>l.format(new Date(c.getFullYear(),c.getMonth(),c.getDate()+f)))}),s=(t%7+7)%7;return o.slice(s).concat(o.slice(0,s))}function I(e){try{let t=new Intl.Locale(a(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function L(e,t){return e.toLocaleDateString(a(t),{month:"long",year:"numeric"})}function m(e,t){return new Intl.NumberFormat(a(t),{useGrouping:!1}).format(e)}function N(e,t,n){return`${m(e,n)} \u2013 ${m(t,n)}`}function W(e,t){return e.toLocaleDateString(a(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function k(){g.clear()}0&&(module.exports={clearLocaleNameCache,formatDateLabel,formatMonthLabel,formatYear,formatYearRange,getLocaleWeekStartsOn,getMonthNames,getWeekDayNames,resolveLocale});

package/dist/calendar/locale.d.cts

@@ -1,10 +1,6 @@
 /**
  * Locale-derived month and weekday names for `<skdx-calendar>`, built entirely
  * on `Intl` — no bundled name tables, no date library, no new dependency.
- *
- * Every framework package carries its own copy of these helpers (the same way
- * each carries its own date math), so a consumer never pays for a shared
- * runtime package just to render a month heading.
  */
 /** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
 export type NameWidth = 'narrow' | 'short' | 'long';
@@ -39,6 +35,16 @@ export declare function getWeekDayNames(locale?: string, weekStartsOn?: number,
 export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
 export declare function formatMonthLabel(month: Date, locale?: string): string;
+/**
+ * A bare year formatted for `locale` (e.g. `'2026'`, `'٢٠٢٦'` in `ar-EG`) —
+ * the month view's heading and grid name.
+ *
+ * `Intl.NumberFormat` with grouping off rather than `String(year)`: a locale
+ * with its own digits should show them, and a grouped `2,026` is not a year.
+ */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
 /** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
 export declare function formatDateLabel(date: Date, locale?: string): string;
 /** @internal Drops every memoized name list. Only needed by tests that switch locales in one process. */

package/dist/calendar/locale.d.ts

@@ -1,10 +1,6 @@
 /**
  * Locale-derived month and weekday names for `<skdx-calendar>`, built entirely
  * on `Intl` — no bundled name tables, no date library, no new dependency.
- *
- * Every framework package carries its own copy of these helpers (the same way
- * each carries its own date math), so a consumer never pays for a shared
- * runtime package just to render a month heading.
  */
 /** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
 export type NameWidth = 'narrow' | 'short' | 'long';
@@ -39,6 +35,16 @@ export declare function getWeekDayNames(locale?: string, weekStartsOn?: number,
 export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
 export declare function formatMonthLabel(month: Date, locale?: string): string;
+/**
+ * A bare year formatted for `locale` (e.g. `'2026'`, `'٢٠٢٦'` in `ar-EG`) —
+ * the month view's heading and grid name.
+ *
+ * `Intl.NumberFormat` with grouping off rather than `String(year)`: a locale
+ * with its own digits should show them, and a grouped `2,026` is not a year.
+ */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
 /** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
 export declare function formatDateLabel(date: Date, locale?: string): string;
 /** @internal Drops every memoized name list. Only needed by tests that switch locales in one process. */

package/dist/calendar/locale.js

@@ -1 +1 @@
-var i=new Date(2024,0,7),c=new Map;function l(t,e){let n=c.get(t);if(n)return n;let r=e();return c.set(t,r),r}function o(t){return t??new Intl.DateTimeFormat().resolvedOptions().locale}function f(t,e="long"){let n=o(t);return l(`m|${n}|${e}`,()=>{let r=new Intl.DateTimeFormat(n,{month:e,timeZone:"UTC"});return Array.from({length:12},(s,a)=>r.format(Date.UTC(2024,a,15)))})}function D(t,e=0,n="short"){let r=o(t),s=l(`w|${r}|${n}`,()=>{let g=new Intl.DateTimeFormat(r,{weekday:n});return Array.from({length:7},(u,m)=>g.format(new Date(i.getFullYear(),i.getMonth(),i.getDate()+m)))}),a=(e%7+7)%7;return s.slice(a).concat(s.slice(0,a))}function h(t){try{let e=new Intl.Locale(o(t)),n=(e.getWeekInfo?.()??e.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function y(t,e){return t.toLocaleDateString(o(e),{month:"long",year:"numeric"})}function p(t,e){return t.toLocaleDateString(o(e),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function w(){c.clear()}export{w as clearLocaleNameCache,p as formatDateLabel,y as formatMonthLabel,h as getLocaleWeekStartsOn,f as getMonthNames,D as getWeekDayNames,o as resolveLocale};
+var i=new Date(2024,0,7),c=new Map;function m(t,e){let n=c.get(t);if(n)return n;let r=e();return c.set(t,r),r}function o(t){return t??new Intl.DateTimeFormat().resolvedOptions().locale}function D(t,e="long"){let n=o(t);return m(`m|${n}|${e}`,()=>{let r=new Intl.DateTimeFormat(n,{month:e,timeZone:"UTC"});return Array.from({length:12},(s,a)=>r.format(Date.UTC(2024,a,15)))})}function h(t,e=0,n="short"){let r=o(t),s=m(`w|${r}|${n}`,()=>{let u=new Intl.DateTimeFormat(r,{weekday:n});return Array.from({length:7},(f,l)=>u.format(new Date(i.getFullYear(),i.getMonth(),i.getDate()+l)))}),a=(e%7+7)%7;return s.slice(a).concat(s.slice(0,a))}function p(t){try{let e=new Intl.Locale(o(t)),n=(e.getWeekInfo?.()??e.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function y(t,e){return t.toLocaleDateString(o(e),{month:"long",year:"numeric"})}function g(t,e){return new Intl.NumberFormat(o(e),{useGrouping:!1}).format(t)}function w(t,e,n){return`${g(t,n)} \u2013 ${g(e,n)}`}function b(t,e){return t.toLocaleDateString(o(e),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function d(){c.clear()}export{d as clearLocaleNameCache,b as formatDateLabel,y as formatMonthLabel,g as formatYear,w as formatYearRange,p as getLocaleWeekStartsOn,D as getMonthNames,h as getWeekDayNames,o as resolveLocale};

package/dist/calendar/primitives.cjs

@@ -0,0 +1 @@
+"use strict";var x=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var W=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var y=(e,r)=>{for(var a in r)x(e,a,{get:r[a],enumerable:!0})},g=(e,r,a,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let d of W(r))!b.call(e,d)&&d!==a&&x(e,d,{get:()=>r[d],enumerable:!(t=N(r,d))||t.enumerable});return e};var h=e=>g(x({},"__esModule",{value:!0}),e);var s={};y(s,{SkdxCalendar:()=>n.SkdxCalendar,SkdxCalendarCell:()=>G.SkdxCalendarCell,SkdxCalendarGrid:()=>S.SkdxCalendarGrid,SkdxCalendarGridBody:()=>i.SkdxCalendarGridBody,SkdxCalendarGridHead:()=>f.SkdxCalendarGridHead,SkdxCalendarHeader:()=>k.SkdxCalendarHeader,SkdxCalendarHeading:()=>l.SkdxCalendarHeading,SkdxCalendarMonthGrid:()=>o.SkdxCalendarMonthGrid,SkdxCalendarNextButton:()=>C.SkdxCalendarNextButton,SkdxCalendarPreviousButton:()=>m.SkdxCalendarPreviousButton,SkdxCalendarRow:()=>u.SkdxCalendarRow,SkdxCalendarWeekDay:()=>p.SkdxCalendarWeekDay,SkdxCalendarWeekNumber:()=>H.SkdxCalendarWeekNumber,SkdxCalendarWeekNumberHeader:()=>B.SkdxCalendarWeekNumberHeader,SkdxCalendarYearGrid:()=>o.SkdxCalendarYearGrid});module.exports=h(s);var n=require("./Calendar.cjs"),k=require("./CalendarHeader.cjs"),l=require("./CalendarHeading.cjs"),m=require("./CalendarPreviousButton.cjs"),C=require("./CalendarNextButton.cjs"),S=require("./CalendarGrid.cjs"),o=require("./CalendarViewGrid.cjs"),f=require("./CalendarGridHead.cjs"),p=require("./CalendarWeekDay.cjs"),i=require("./CalendarGridBody.cjs"),u=require("./CalendarRow.cjs"),G=require("./CalendarCell.cjs"),H=require("./CalendarWeekNumber.cjs"),B=require("./CalendarWeekNumberHeader.cjs");0&&(module.exports={SkdxCalendar,SkdxCalendarCell,SkdxCalendarGrid,SkdxCalendarGridBody,SkdxCalendarGridHead,SkdxCalendarHeader,SkdxCalendarHeading,SkdxCalendarMonthGrid,SkdxCalendarNextButton,SkdxCalendarPreviousButton,SkdxCalendarRow,SkdxCalendarWeekDay,SkdxCalendarWeekNumber,SkdxCalendarWeekNumberHeader,SkdxCalendarYearGrid});

package/dist/calendar/primitives.d.cts

@@ -0,0 +1,36 @@
+/**
+ * Primitives for calendar (built from these elements). Use when anatomy's structure doesn't fit.
+ * Imports from this path; tags are global.
+ *
+ * @example
+ * ```ts
+ * import * as Calendar from '@skdx/web-components/primitives/calendar';
+ * ```
+ * ```html
+ * <skdx-calendar>
+ *   <skdx-calendar-header>
+ *     <skdx-calendar-previous-button>‹</skdx-calendar-previous-button>
+ *     <skdx-calendar-heading></skdx-calendar-heading>
+ *     <skdx-calendar-next-button>›</skdx-calendar-next-button>
+ *   </skdx-calendar-header>
+ *   <skdx-calendar-grid>
+ *     <skdx-calendar-grid-head></skdx-calendar-grid-head>
+ *     <skdx-calendar-grid-body></skdx-calendar-grid-body>
+ *   </skdx-calendar-grid>
+ * </skdx-calendar>
+ * ```
+ */
+export { SkdxCalendar } from './Calendar.cjs';
+export { SkdxCalendarHeader } from './CalendarHeader.cjs';
+export { SkdxCalendarHeading } from './CalendarHeading.cjs';
+export { SkdxCalendarPreviousButton } from './CalendarPreviousButton.cjs';
+export { SkdxCalendarNextButton } from './CalendarNextButton.cjs';
+export { SkdxCalendarGrid } from './CalendarGrid.cjs';
+export { SkdxCalendarMonthGrid, SkdxCalendarYearGrid } from './CalendarViewGrid.cjs';
+export { SkdxCalendarGridHead } from './CalendarGridHead.cjs';
+export { SkdxCalendarWeekDay } from './CalendarWeekDay.cjs';
+export { SkdxCalendarGridBody } from './CalendarGridBody.cjs';
+export { SkdxCalendarRow } from './CalendarRow.cjs';
+export { SkdxCalendarCell } from './CalendarCell.cjs';
+export { SkdxCalendarWeekNumber } from './CalendarWeekNumber.cjs';
+export { SkdxCalendarWeekNumberHeader } from './CalendarWeekNumberHeader.cjs';

package/dist/calendar/primitives.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Primitives for calendar (built from these elements). Use when anatomy's structure doesn't fit.
+ * Imports from this path; tags are global.
+ *
+ * @example
+ * ```ts
+ * import * as Calendar from '@skdx/web-components/primitives/calendar';
+ * ```
+ * ```html
+ * <skdx-calendar>
+ *   <skdx-calendar-header>
+ *     <skdx-calendar-previous-button>‹</skdx-calendar-previous-button>
+ *     <skdx-calendar-heading></skdx-calendar-heading>
+ *     <skdx-calendar-next-button>›</skdx-calendar-next-button>
+ *   </skdx-calendar-header>
+ *   <skdx-calendar-grid>
+ *     <skdx-calendar-grid-head></skdx-calendar-grid-head>
+ *     <skdx-calendar-grid-body></skdx-calendar-grid-body>
+ *   </skdx-calendar-grid>
+ * </skdx-calendar>
+ * ```
+ */
+export { SkdxCalendar } from './Calendar.js';
+export { SkdxCalendarHeader } from './CalendarHeader.js';
+export { SkdxCalendarHeading } from './CalendarHeading.js';
+export { SkdxCalendarPreviousButton } from './CalendarPreviousButton.js';
+export { SkdxCalendarNextButton } from './CalendarNextButton.js';
+export { SkdxCalendarGrid } from './CalendarGrid.js';
+export { SkdxCalendarMonthGrid, SkdxCalendarYearGrid } from './CalendarViewGrid.js';
+export { SkdxCalendarGridHead } from './CalendarGridHead.js';
+export { SkdxCalendarWeekDay } from './CalendarWeekDay.js';
+export { SkdxCalendarGridBody } from './CalendarGridBody.js';
+export { SkdxCalendarRow } from './CalendarRow.js';
+export { SkdxCalendarCell } from './CalendarCell.js';
+export { SkdxCalendarWeekNumber } from './CalendarWeekNumber.js';
+export { SkdxCalendarWeekNumberHeader } from './CalendarWeekNumberHeader.js';

package/dist/calendar/primitives.js

@@ -0,0 +1 @@
+import{SkdxCalendar as d}from"./Calendar.js";import{SkdxCalendarHeader as o}from"./CalendarHeader.js";import{SkdxCalendarHeading as t}from"./CalendarHeading.js";import{SkdxCalendarPreviousButton as k}from"./CalendarPreviousButton.js";import{SkdxCalendarNextButton as m}from"./CalendarNextButton.js";import{SkdxCalendarGrid as S}from"./CalendarGrid.js";import{SkdxCalendarMonthGrid as p,SkdxCalendarYearGrid as i}from"./CalendarViewGrid.js";import{SkdxCalendarGridHead as G}from"./CalendarGridHead.js";import{SkdxCalendarWeekDay as B}from"./CalendarWeekDay.js";import{SkdxCalendarGridBody as W}from"./CalendarGridBody.js";import{SkdxCalendarRow as y}from"./CalendarRow.js";import{SkdxCalendarCell as h}from"./CalendarCell.js";import{SkdxCalendarWeekNumber as v}from"./CalendarWeekNumber.js";import{SkdxCalendarWeekNumberHeader as D}from"./CalendarWeekNumberHeader.js";export{d as SkdxCalendar,h as SkdxCalendarCell,S as SkdxCalendarGrid,W as SkdxCalendarGridBody,G as SkdxCalendarGridHead,o as SkdxCalendarHeader,t as SkdxCalendarHeading,p as SkdxCalendarMonthGrid,m as SkdxCalendarNextButton,k as SkdxCalendarPreviousButton,y as SkdxCalendarRow,B as SkdxCalendarWeekDay,v as SkdxCalendarWeekNumber,D as SkdxCalendarWeekNumberHeader,i as SkdxCalendarYearGrid};

package/dist/card/Card.cjs

@@ -1,9 +1,9 @@
-"use strict";var c=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var y=(r,e)=>{for(var o in e)c(r,o,{get:e[o],enumerable:!0})},E=(r,e,o,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!v.call(r,t)&&t!==o&&c(r,t,{get:()=>e[t],enumerable:!(i=d(e,t))||i.enumerable});return r};var b=r=>E(c({},"__esModule",{value:!0}),r),n=(r,e,o,i)=>{for(var t=i>1?void 0:i?d(e,o):e,m=r.length-1,a;m>=0;m--)(a=r[m])&&(t=(i?a(e,o,t):a(t))||t);return i&&t&&c(e,o,t),t};var g={};y(g,{SkdxCard:()=>s});module.exports=b(g);var l=require("lit"),p=require("../internal/define.cjs"),f=require("../internal/styles.cjs");var s=class extends l.LitElement{render(){return l.html`<div part="card"><slot></slot></div>`}};s.styles=[f.hiddenHostStyles,l.css`
+"use strict";var n=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var A=(i,t)=>{for(var e in t)n(i,e,{get:t[e],enumerable:!0})},T=(i,t,e,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of u(t))!b.call(i,r)&&r!==e&&n(i,r,{get:()=>t[r],enumerable:!(l=d(t,r))||l.enumerable});return i};var L=i=>T(n({},"__esModule",{value:!0}),i),a=(i,t,e,l)=>{for(var r=l>1?void 0:l?d(t,e):t,p=i.length-1,c;p>=0;p--)(c=i[p])&&(r=(l?c(t,e,r):c(r))||r);return l&&r&&n(t,e,r),r};var M={};A(M,{SkdxCard:()=>o});module.exports=L(M);var m=require("lit"),s=require("lit/decorators.js"),h=require("lit/static-html.js"),y=require("../internal/define.cjs"),f=require("../internal/styles.cjs"),v=require("../utils/polymorphic.cjs"),g=require("./CardAnatomy.cjs");var o=class extends m.LitElement{constructor(){super(...arguments);this.as="div";this.title="";this.headingLevel=3;this.fillAnatomy=()=>(0,g.fillCardAnatomy)(this)}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(e){(e.has("title")||e.has("description")||e.has("headingLevel"))&&this.fillAnatomy()}render(){let e=(0,v.resolveTag)(this.as,"div");return h.html`<${e} part="card"><slot @slotchange=${this.fillAnatomy}></slot></${e}>`}};o.styles=[f.hiddenHostStyles,m.css`
       :host {
         display: block;
       }
-      div {
+      [part='card'] {
         font: inherit;
         color: inherit;
       }
-    `],s=n([(0,p.customElement)("skdx-card","card","root")],s);0&&(module.exports={SkdxCard});
+    `],a([(0,s.property)({type:String,reflect:!0})],o.prototype,"as",2),a([(0,s.property)({type:String})],o.prototype,"title",2),a([(0,s.property)({type:String})],o.prototype,"description",2),a([(0,s.property)({type:Number,attribute:"heading-level"})],o.prototype,"headingLevel",2),o=a([(0,y.customElement)("skdx-card","card","root")],o);0&&(module.exports={SkdxCard});

package/dist/card/Card.d.cts

@@ -1,19 +1,15 @@
 import { LitElement } from 'lit';
+import { type PolymorphicTag } from '../utils/polymorphic.cjs';
 /**
- * `<skdx-card>` — the Web Components implementation of the shared Card
- * contract (see `@skdx/shared`'s `cardContract`). Renders a `<div>` in
- * shadow DOM: a purely structural container with no properties or shared
- * state — style it with `skdx-card::part(card)`.
+ * Root container for a card layout: renders a `<div>` and derives anatomy
+ * from `title`/`description`/`media`/`footer`. Consumer-authored parts override
+ * derived ones.
  *
  * @example
  * ```html
- * <skdx-card>
- *   <skdx-card-header>
- *     <skdx-card-title>Project Alpha</skdx-card-title>
- *     <skdx-card-description>Last updated 2 days ago</skdx-card-description>
- *   </skdx-card-header>
+ * <skdx-card title="Project Alpha" description="Last updated 2 days ago">
  *   <skdx-card-content>Details about the project go here.</skdx-card-content>
- *   <skdx-card-footer><skdx-button>View</skdx-button></skdx-card-footer>
+ *   <skdx-button slot="footer">View</skdx-button>
  * </skdx-card>
  * ```
  *
@@ -21,7 +17,28 @@ import { LitElement } from 'lit';
  */
 export declare class SkdxCard extends LitElement {
     static styles: import("lit").CSSResult[];
-    render(): import("lit").TemplateResult<1>;
+    /** Element name to render instead of `<div>`, from the library's tag allowlist.
+     * @default 'div'
+     */
+    as: PolymorphicTag;
+    /** The card's heading, rendered into a derived `<skdx-card-header>`. Shadows the native `HTMLElement.title` tooltip attribute.
+     * @default '' — no header is derived from a title.
+     */
+    title: string;
+    /**
+     * Supporting text below the title, rendered into the derived
+     * `<skdx-card-header>`.
+     * @default undefined — no description is derived.
+     */
+    description?: string;
+    /** Heading level of the derived `<skdx-card-title>`; match the document outline the card sits in.
+     * @default 3
+     */
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    connectedCallback(): void;
+    private readonly fillAnatomy;
+    protected updated(changed: Map<string, unknown>): void;
+    render(): import("lit").TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/card/Card.d.ts

@@ -1,19 +1,15 @@
 import { LitElement } from 'lit';
+import { type PolymorphicTag } from '../utils/polymorphic.js';
 /**
- * `<skdx-card>` — the Web Components implementation of the shared Card
- * contract (see `@skdx/shared`'s `cardContract`). Renders a `<div>` in
- * shadow DOM: a purely structural container with no properties or shared
- * state — style it with `skdx-card::part(card)`.
+ * Root container for a card layout: renders a `<div>` and derives anatomy
+ * from `title`/`description`/`media`/`footer`. Consumer-authored parts override
+ * derived ones.
  *
  * @example
  * ```html
- * <skdx-card>
- *   <skdx-card-header>
- *     <skdx-card-title>Project Alpha</skdx-card-title>
- *     <skdx-card-description>Last updated 2 days ago</skdx-card-description>
- *   </skdx-card-header>
+ * <skdx-card title="Project Alpha" description="Last updated 2 days ago">
  *   <skdx-card-content>Details about the project go here.</skdx-card-content>
- *   <skdx-card-footer><skdx-button>View</skdx-button></skdx-card-footer>
+ *   <skdx-button slot="footer">View</skdx-button>
  * </skdx-card>
  * ```
  *
@@ -21,7 +17,28 @@ import { LitElement } from 'lit';
  */
 export declare class SkdxCard extends LitElement {
     static styles: import("lit").CSSResult[];
-    render(): import("lit").TemplateResult<1>;
+    /** Element name to render instead of `<div>`, from the library's tag allowlist.
+     * @default 'div'
+     */
+    as: PolymorphicTag;
+    /** The card's heading, rendered into a derived `<skdx-card-header>`. Shadows the native `HTMLElement.title` tooltip attribute.
+     * @default '' — no header is derived from a title.
+     */
+    title: string;
+    /**
+     * Supporting text below the title, rendered into the derived
+     * `<skdx-card-header>`.
+     * @default undefined — no description is derived.
+     */
+    description?: string;
+    /** Heading level of the derived `<skdx-card-title>`; match the document outline the card sits in.
+     * @default 3
+     */
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    connectedCallback(): void;
+    private readonly fillAnatomy;
+    protected updated(changed: Map<string, unknown>): void;
+    render(): import("lit").TemplateResult;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/card/Card.js

@@ -1,9 +1,9 @@
-var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var m=(i,r,s,o)=>{for(var e=o>1?void 0:o?d(r,s):r,l=i.length-1,c;l>=0;l--)(c=i[l])&&(e=(o?c(r,s,e):c(e))||e);return o&&e&&a(r,s,e),e};import{css as n,html as p,LitElement as f}from"lit";import{customElement as h}from"../internal/define.js";import{hiddenHostStyles as v}from"../internal/styles.js";var t=class extends f{render(){return p`<div part="card"><slot></slot></div>`}};t.styles=[v,n`
+var p=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var i=(s,o,t,l)=>{for(var r=l>1?void 0:l?c(o,t):o,n=s.length-1,m;n>=0;n--)(m=s[n])&&(r=(l?m(o,t,r):m(r))||r);return l&&r&&p(o,t,r),r};import{css as d,LitElement as h}from"lit";import{property as a}from"lit/decorators.js";import{html as y}from"lit/static-html.js";import{customElement as f}from"../internal/define.js";import{hiddenHostStyles as v}from"../internal/styles.js";import{resolveTag as g}from"../utils/polymorphic.js";import{fillCardAnatomy as u}from"./CardAnatomy.js";var e=class extends h{constructor(){super(...arguments);this.as="div";this.title="";this.headingLevel=3;this.fillAnatomy=()=>u(this)}connectedCallback(){super.connectedCallback(),queueMicrotask(this.fillAnatomy)}updated(t){(t.has("title")||t.has("description")||t.has("headingLevel"))&&this.fillAnatomy()}render(){let t=g(this.as,"div");return y`<${t} part="card"><slot @slotchange=${this.fillAnatomy}></slot></${t}>`}};e.styles=[v,d`
       :host {
         display: block;
       }
-      div {
+      [part='card'] {
         font: inherit;
         color: inherit;
       }
-    `],t=m([h("skdx-card","card","root")],t);export{t as SkdxCard};
+    `],i([a({type:String,reflect:!0})],e.prototype,"as",2),i([a({type:String})],e.prototype,"title",2),i([a({type:String})],e.prototype,"description",2),i([a({type:Number,attribute:"heading-level"})],e.prototype,"headingLevel",2),e=i([f("skdx-card","card","root")],e);export{e as SkdxCard};

package/dist/card/CardAnatomy.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var f=(e,t)=>{for(var r in t)s(e,r,{get:t[r],enumerable:!0})},h=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of p(t))!u.call(e,a)&&a!==r&&s(e,a,{get:()=>t[a],enumerable:!(n=m(t,a))||n.enumerable});return e};var x=e=>h(s({},"__esModule",{value:!0}),e);var A={};f(A,{CARD_ANATOMY_GENERATED:()=>c,fillCardAnatomy:()=>E});module.exports=x(A);var d=require("../internal/derive.cjs"),N=require("./CardMedia.cjs"),y=require("./CardHeader.cjs"),S=require("./CardTitle.cjs"),g=require("./CardDescription.cjs"),b=require("./CardFooter.cjs"),v=require("./CardContent.cjs"),c="data-skdx-card-generated";function k(e){let t=c;if((0,d.hasAuthoredPart)(e,"skdx-card-header",t))return null;let r=(0,d.generatedPart)(e,"skdx-card-header",t)??document.createElement("skdx-card-header");r.setAttribute(t,"");let n=(0,d.textPart)(r,"skdx-card-title",e.title,t);n?.setAttribute("level",String(e.headingLevel));let a=[n,(0,d.textPart)(r,"skdx-card-description",e.description,t)].filter(l=>l!==null);return a.length===0?null:((0,d.applyChildren)(r,a),r)}function E(e){let t=c,r=(0,d.claimSlot)(e,"media","skdx-card-media",t),n=(0,d.claimSlot)(e,"footer","skdx-card-footer",t),a=k(e),l=new Set([r,a,n].filter(i=>i!==null)),o=Array.from(e.childNodes).filter(i=>!l.has(i)&&!(i.nodeType===Node.ELEMENT_NODE&&i.hasAttribute(t)));(0,d.applyChildren)(e,[...r?[r]:[],...a?[a]:[],...o,...n?[n]:[]])}0&&(module.exports={CARD_ANATOMY_GENERATED,fillCardAnatomy});

package/dist/card/CardAnatomy.d.cts

@@ -0,0 +1,16 @@
+import type { SkdxCard } from './Card.cjs';
+import './CardMedia.cjs';
+import './CardHeader.cjs';
+import './CardTitle.cjs';
+import './CardDescription.cjs';
+import './CardFooter.cjs';
+import './CardContent.cjs';
+/** @internal Marks a direct child of `<skdx-card>` this module generated. */
+export declare const CARD_ANATOMY_GENERATED = "data-skdx-card-generated";
+/**
+ * Draws the parts the card describes: Media, Header, the consumer's children,
+ * and Footer. When a consumer places a Header, the derived one stands down —
+ * both paths ship together.
+ * @internal
+ */
+export declare function fillCardAnatomy(root: SkdxCard): void;