@skdx/react 0.26.0 → 0.28.0

package/dist/button/types.d.cts

@@ -1,9 +1,54 @@
-import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
-/** Props for the {@link Button} root. */
-export interface ButtonProps extends PrimitivePropsWithRef<'button'> {
+import type { PolymorphicTag, PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/**
+ * Props for the {@link Button} root.
+ *
+ * `disabled` and `type` come from `PrimitivePropsWithRef<'button'>`.
+ * Both are *contract* props with declared defaults; API-table generator reads this interface.
+ * Redeclaring them changes no runtime behaviour but makes documented surface same in all five frameworks.
+ */
+export interface ButtonProps extends Omit<PrimitivePropsWithRef<'button'>, 'type'> {
     /**
-     * Marks the button busy (e.g. while submitting). Sets `aria-busy` and `data-loading`.
+     * Element name to render instead of `<button>`, from the library's tag allowlist.
+     * Takes a tag name only, never a component. React elements needing their own attributes
+     * go through `asChild` instead (fully typed, outranks `as` when both set).
+     * @default 'button'
+     */
+    as?: PolymorphicTag;
+    /**
+     * Marks the button busy (e.g. while submitting). Sets `aria-busy`,
+     * `aria-disabled` and `data-loading`/`data-disabled`, suppresses activation
+     * but **not** native `disabled`, so button keeps focus and tab stop while work runs.
      * @default false
      */
     loading?: boolean;
+    /**
+     * Describes what is in progress while `loading` is true. Rendered into visually-hidden
+     * element inside button, referenced by `aria-describedby`, so busy state is accessibility
+     * tree node rather than `aria-busy` flag with nothing behind it.
+     * @default 'Loading'
+     */
+    loadingLabel?: string;
+    /**
+     * Native disabled state, set as native `disabled` attribute. Outranks `loading`:
+     * when both set, button is hard-disabled and emits no `aria-busy`.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Keep `disabled` button in tab order instead of removing it from page.
+     *
+     * With it set, `disabled` emits `aria-disabled="true"` plus `tabindex="0"` instead
+     * of native attribute; activation suppressed in click handler. For disabled actions
+     * inside Toolbar or menu bar: arrow-key navigation owns those, and control removed
+     * from tab order is unreachable — user can't find action exists.
+     *
+     * Opt-in because soft-disabled button is focus stop doing nothing, which in plain form is snag.
+     * @default false
+     */
+    focusableWhenDisabled?: boolean;
+    /**
+     * Native button type. Defaults to `'button'` so it never accidentally submits enclosing form.
+     * @default 'button'
+     */
+    type?: 'button' | 'submit' | 'reset';
 }

package/dist/button/types.d.ts

@@ -1,9 +1,54 @@
-import type { PrimitivePropsWithRef } from '../utils/primitive.js';
-/** Props for the {@link Button} root. */
-export interface ButtonProps extends PrimitivePropsWithRef<'button'> {
+import type { PolymorphicTag, PrimitivePropsWithRef } from '../utils/primitive.js';
+/**
+ * Props for the {@link Button} root.
+ *
+ * `disabled` and `type` come from `PrimitivePropsWithRef<'button'>`.
+ * Both are *contract* props with declared defaults; API-table generator reads this interface.
+ * Redeclaring them changes no runtime behaviour but makes documented surface same in all five frameworks.
+ */
+export interface ButtonProps extends Omit<PrimitivePropsWithRef<'button'>, 'type'> {
     /**
-     * Marks the button busy (e.g. while submitting). Sets `aria-busy` and `data-loading`.
+     * Element name to render instead of `<button>`, from the library's tag allowlist.
+     * Takes a tag name only, never a component. React elements needing their own attributes
+     * go through `asChild` instead (fully typed, outranks `as` when both set).
+     * @default 'button'
+     */
+    as?: PolymorphicTag;
+    /**
+     * Marks the button busy (e.g. while submitting). Sets `aria-busy`,
+     * `aria-disabled` and `data-loading`/`data-disabled`, suppresses activation
+     * but **not** native `disabled`, so button keeps focus and tab stop while work runs.
      * @default false
      */
     loading?: boolean;
+    /**
+     * Describes what is in progress while `loading` is true. Rendered into visually-hidden
+     * element inside button, referenced by `aria-describedby`, so busy state is accessibility
+     * tree node rather than `aria-busy` flag with nothing behind it.
+     * @default 'Loading'
+     */
+    loadingLabel?: string;
+    /**
+     * Native disabled state, set as native `disabled` attribute. Outranks `loading`:
+     * when both set, button is hard-disabled and emits no `aria-busy`.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Keep `disabled` button in tab order instead of removing it from page.
+     *
+     * With it set, `disabled` emits `aria-disabled="true"` plus `tabindex="0"` instead
+     * of native attribute; activation suppressed in click handler. For disabled actions
+     * inside Toolbar or menu bar: arrow-key navigation owns those, and control removed
+     * from tab order is unreachable — user can't find action exists.
+     *
+     * Opt-in because soft-disabled button is focus stop doing nothing, which in plain form is snag.
+     * @default false
+     */
+    focusableWhenDisabled?: boolean;
+    /**
+     * Native button type. Defaults to `'button'` so it never accidentally submits enclosing form.
+     * @default 'button'
+     */
+    type?: 'button' | 'submit' | 'reset';
 }

package/dist/calendar/Calendar.cjs

@@ -1 +1 @@
-"use strict";var kt=Object.create;var B=Object.defineProperty;var wt=Object.getOwnPropertyDescriptor;var Mt=Object.getOwnPropertyNames;var Rt=Object.getPrototypeOf,bt=Object.prototype.hasOwnProperty;var vt=(e,t)=>{for(var r in t)B(e,r,{get:t[r],enumerable:!0})},Me=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Mt(t))!bt.call(e,n)&&n!==r&&B(e,n,{get:()=>t[n],enumerable:!(a=wt(t,n))||a.enumerable});return e};var f=(e,t,r)=>(r=e!=null?kt(Rt(e)):{},Me(t||!e||!e.__esModule?B(r,"default",{value:e,enumerable:!0}):r,e)),Nt=e=>Me(B({},"__esModule",{value:!0}),e);var Ht={};vt(Ht,{Calendar:()=>We,CalendarCell:()=>G,CalendarGrid:()=>De,CalendarGridBody:()=>ye,CalendarGridContext:()=>$,CalendarGridHead:()=>ge,CalendarHeader:()=>ce,CalendarHeading:()=>ue,CalendarNextButton:()=>pe,CalendarPreviousButton:()=>fe,CalendarProvider:()=>Fe,CalendarRow:()=>k,CalendarWeekDay:()=>L,addDays:()=>g,addMonths:()=>p,addYears:()=>V,anchorOf:()=>ne,clampToMonth:()=>H,clearLocaleNameCache:()=>ve,emptySelection:()=>re,endOfWeek:()=>se,formatDateLabel:()=>M,formatMonthLabel:()=>E,getDaysInMonth:()=>ie,getLocaleWeekStartsOn:()=>A,getMonthNames:()=>be,getVisibleWeeks:()=>le,getWeekDayNames:()=>v,isDateDisabled:()=>de,isDateRange:()=>P,isDateSelected:()=>me,isSameDay:()=>h,isSameMonth:()=>x,nextSelection:()=>Le,rangePositionOf:()=>Y,resolveLocale:()=>y,selectionAnnouncement:()=>Ge,startOfMonth:()=>R,startOfWeek:()=>N,stripTime:()=>C,toISODateString:()=>S,useCalendarContext:()=>St,useCalendarContextInternal:()=>l,useCalendarGridMonth:()=>T});module.exports=Nt(Ht);var u=f(require("react"),1),Ne=require("../utils/createContext.cjs"),Se=require("../utils/liveAnnouncer.cjs"),He=require("../utils/part.cjs"),Te=require("../utils/primitive.cjs"),ae=require("../utils/useControllableState.cjs");var ee=new Date(2024,0,7),te=new Map;function Re(e,t){let r=te.get(e);if(r)return r;let a=t();return te.set(e,a),a}function y(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function be(e,t="long"){let r=y(e);return Re(`m|${r}|${t}`,()=>{let a=new Intl.DateTimeFormat(r,{month:t,timeZone:"UTC"});return Array.from({length:12},(n,o)=>a.format(Date.UTC(2024,o,15)))})}function v(e,t=0,r="short"){let a=y(e),n=Re(`w|${a}|${r}`,()=>{let s=new Intl.DateTimeFormat(a,{weekday:r});return Array.from({length:7},(d,m)=>s.format(new Date(ee.getFullYear(),ee.getMonth(),ee.getDate()+m)))}),o=(t%7+7)%7;return n.slice(o).concat(n.slice(0,o))}function A(e){try{let t=new Intl.Locale(y(e)),r=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof r=="number")return r%7}catch{}return 0}function E(e,t){return e.toLocaleDateString(y(t),{month:"long",year:"numeric"})}function M(e,t){return e.toLocaleDateString(y(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function ve(){te.clear()}var oe=require("react/jsx-runtime");function ie(e,t){return new Date(e,t+1,0).getDate()}function R(e){return new Date(e.getFullYear(),e.getMonth(),1)}function p(e,t){let r=e.getDate(),a=new Date(e.getFullYear(),e.getMonth(),1);a.setMonth(a.getMonth()+t);let n=ie(a.getFullYear(),a.getMonth());return a.setDate(Math.min(r,n)),a}function V(e,t){return p(e,t*12)}function g(e,t){let r=new Date(e);return r.setDate(r.getDate()+t),r}function h(e,t){return!e||!t?!1:e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate()}function x(e,t){return e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()}function N(e,t){let r=new Date(e.getFullYear(),e.getMonth(),e.getDate()),a=(r.getDay()-t+7)%7;return r.setDate(r.getDate()-a),r}function se(e,t){return g(N(e,t),6)}function C(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function de(e,t,r,a){let n=C(e).getTime();return!!(t&&n<C(t).getTime()||r&&n>C(r).getTime()||a?.(e))}function S(e){let t=e.getFullYear(),r=String(e.getMonth()+1).padStart(2,"0"),a=String(e.getDate()).padStart(2,"0");return`${t}-${r}-${a}`}function H(e,t){if(x(e,t))return e;let r=ie(t.getFullYear(),t.getMonth());return new Date(t.getFullYear(),t.getMonth(),Math.min(e.getDate(),r))}function le(e,t=0){let r=N(R(e),t),a=[],n=r;for(let o=0;o<6;o++){let s=[];for(let d=0;d<7;d++)s.push({date:n,outsideMonth:!x(n,e)}),n=g(n,1);a.push(s)}return a}function P(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function re(e){return e==="multiple"?[]:null}function me(e,t){return e===null?!1:Array.isArray(e)?e.some(r=>h(r,t)):P(e)?Y(e,t)!==void 0:h(e,t)}function Y(e,t){let r=C(t).getTime(),a=C(e.start).getTime();if(e.end===null)return r===a?"start":void 0;let n=C(e.end).getTime();if(!(r<a||r>n))return r===a?"start":r===n?"end":"middle"}function Le(e,t,r){if(e==="single")return r;if(e==="multiple"){let n=Array.isArray(t)?t:[],o=n.filter(s=>!h(s,r));return o.length!==n.length?o:[...n,r].sort((s,d)=>s.getTime()-d.getTime())}let a=P(t)&&t.end===null?t:void 0;return a?C(r).getTime()<C(a.start).getTime()?{start:r,end:a.start}:{start:a.start,end:r}:{start:r,end:null}}function Ge(e,t){return P(e)?e.end===null?`${M(e.start,t)} selected as the range start. Select an end date.`:`Range selected, ${M(e.start,t)} to ${M(e.end,t)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var[Fe,l]=(0,Ne.createSafeContext)("Calendar");function St(){return l("useCalendarContext")}var $=u.createContext(null);function T(e){return u.useContext($)?.gridMonth??e}function ne(e){return e===null?null:Array.isArray(e)?e[0]??null:P(e)?e.start:e}var We=u.forwardRef(({selectionMode:e="single",value:t,defaultValue:r,onValueChange:a,month:n,defaultMonth:o,onMonthChange:s,numberOfMonths:d=1,locale:m,minDate:c,maxDate:i,weekStartsOn:F,disabled:j,isDateUnavailable:ft,getSelectionAnnouncement:he,...xe},pt)=>{let[b=null,Pe]=(0,ae.useControllableState)({prop:t,defaultProp:r??re(e),onChange:D=>a?.(D??re(e))}),ke=R(o??ne(b)??new Date),[W=ke,we]=(0,ae.useControllableState)({prop:n,defaultProp:ke,onChange:s}),[Ct,Dt]=u.useState(()=>ne(b)??W),I=F??A(m),gt=u.useMemo(()=>{let D=v(m,I,"short"),w=v(m,I,"long");return D.map((O,Pt)=>({short:O,long:w[Pt]}))},[m,I]),yt=u.useMemo(()=>Array.from({length:Math.max(1,d)},(D,w)=>p(W,w)),[W,d]),ht=u.useCallback(D=>{let w=Le(e,b,D);Pe(w);let O=(he??Ge)(w,m);O&&(0,Se.announce)(O)},[e,b,Pe,m,he]),xt=u.useCallback(D=>we(R(D)),[we]);return(0,oe.jsx)(Fe,{value:b,selectionMode:e,month:W,months:yt,focusedDate:Ct,weekStartsOn:I,locale:m,weekDayNames:gt,minDate:c,maxDate:i,disabled:j,isDateUnavailable:ft,onValueChange:ht,onMonthChange:xt,setFocusedDate:Dt,children:(0,oe.jsx)(Te.Primitive.div,{...xe,...(0,He.skdxPart)("calendar","root",xe.className),ref:pt})})});We.displayName="Calendar";var Ie=f(require("react"),1),Oe=require("../utils/part.cjs"),Be=require("../utils/primitive.cjs"),Ae=require("react/jsx-runtime"),ce=Ie.forwardRef((e,t)=>(0,Ae.jsx)(Be.Primitive.div,{...e,...(0,Oe.skdxPart)("calendar","header",e.className),ref:t}));ce.displayName="CalendarHeader";var Ee=f(require("react"),1),Ve=require("../utils/part.cjs"),Ye=require("../utils/primitive.cjs");var $e=require("react/jsx-runtime"),ue=Ee.forwardRef(({monthOffset:e=0,children:t,...r},a)=>{let n=l("CalendarHeading"),o=n.months[e]??n.month;return(0,$e.jsx)(Ye.Primitive.div,{...r,...(0,Ve.skdxPart)("calendar","heading",r.className),ref:a,children:t??E(o,n.locale)})});ue.displayName="CalendarHeading";var Ke=f(require("react"),1),Ue=require("../utils/part.cjs"),K=require("../utils/primitive.cjs");var _e=require("react/jsx-runtime"),fe=Ke.forwardRef((e,t)=>{let r=l("CalendarPreviousButton");return(0,_e.jsx)(K.Primitive.button,{type:"button","aria-label":"Previous month",...e,...(0,Ue.skdxPart)("calendar","previous-button",e.className),ref:t,onClick:(0,K.composeEventHandlers)(e.onClick,()=>{let a=p(r.month,-1);r.onMonthChange(a),r.setFocusedDate(H(r.focusedDate,a))})})});fe.displayName="CalendarPreviousButton";var qe=f(require("react"),1),Ze=require("../utils/part.cjs"),U=require("../utils/primitive.cjs");var ze=require("react/jsx-runtime"),pe=qe.forwardRef((e,t)=>{let r=l("CalendarNextButton");return(0,ze.jsx)(U.Primitive.button,{type:"button","aria-label":"Next month",...e,...(0,Ze.skdxPart)("calendar","next-button",e.className),ref:t,onClick:(0,U.composeEventHandlers)(e.onClick,()=>{let a=p(r.month,1);r.onMonthChange(a),r.setFocusedDate(H(r.focusedDate,a))})})});pe.displayName="CalendarNextButton";var _=f(require("react"),1),q=require("../utils/direction.cjs"),Je=require("../utils/part.cjs"),Z=require("../utils/primitive.cjs");var Ce=require("react/jsx-runtime"),De=_.forwardRef(({monthOffset:e=0,...t},r)=>{let a=l("CalendarGrid"),n=(0,q.useDirection)(),o=a.months[e]??a.month,s=_.useMemo(()=>({gridMonth:o}),[o]),d=c=>{a.months.some(i=>x(c,i))||a.onMonthChange(R(c)),a.setFocusedDate(c),requestAnimationFrame(()=>{let i=S(c);document.querySelector(`[data-skdx-calendar-cell="${i}"]`)?.focus()})},m=c=>{let i;switch((0,q.directionalKey)(c.key,c.currentTarget,n)){case"ArrowLeft":i=g(a.focusedDate,-1);break;case"ArrowRight":i=g(a.focusedDate,1);break;case"ArrowUp":i=g(a.focusedDate,-7);break;case"ArrowDown":i=g(a.focusedDate,7);break;case"Home":i=N(a.focusedDate,a.weekStartsOn);break;case"End":i=se(a.focusedDate,a.weekStartsOn);break;case"PageUp":i=c.shiftKey?V(a.focusedDate,-1):p(a.focusedDate,-1);break;case"PageDown":i=c.shiftKey?V(a.focusedDate,1):p(a.focusedDate,1);break;default:return}c.preventDefault(),d(i)};return(0,Ce.jsx)($.Provider,{value:s,children:(0,Ce.jsx)(Z.Primitive.div,{role:"grid","aria-multiselectable":a.selectionMode!=="single",...t,...(0,Je.skdxPart)("calendar","grid",t.className),ref:r,onKeyDown:(0,Z.composeEventHandlers)(t.onKeyDown,m)})})});De.displayName="CalendarGrid";var ot=f(require("react"),1),it=require("../utils/part.cjs"),st=require("../utils/primitive.cjs");var Qe=f(require("react"),1),Xe=require("../utils/part.cjs"),je=require("../utils/primitive.cjs"),et=require("react/jsx-runtime"),k=Qe.forwardRef((e,t)=>(0,et.jsx)(je.Primitive.div,{role:"row",...e,...(0,Xe.skdxPart)("calendar","row",e.className),ref:t}));k.displayName="CalendarRow";var tt=f(require("react"),1),at=require("../utils/part.cjs"),rt=require("../utils/primitive.cjs"),nt=require("react/jsx-runtime"),L=tt.forwardRef((e,t)=>(0,nt.jsx)(rt.Primitive.div,{role:"columnheader",...e,...(0,at.skdxPart)("calendar","week-day",e.className),ref:t}));L.displayName="CalendarWeekDay";var z=require("react/jsx-runtime"),ge=ot.forwardRef(({children:e,...t},r)=>{let a=l("CalendarGridHead");return(0,z.jsx)(st.Primitive.div,{role:"rowgroup",...t,...(0,it.skdxPart)("calendar","grid-head",t.className),ref:r,children:e??(0,z.jsx)(k,{children:a.weekDayNames.map(n=>(0,z.jsx)(L,{"aria-label":n.long,children:n.short},n.long))})})});ge.displayName="CalendarGridHead";var X=f(require("react"),1),ct=require("../utils/part.cjs"),ut=require("../utils/primitive.cjs");var dt=f(require("react"),1),lt=require("../utils/part.cjs"),J=require("../utils/primitive.cjs");var mt=require("react/jsx-runtime"),G=dt.forwardRef(({date:e,...t},r)=>{let a=l("CalendarCell"),n=T(a.month),o=S(e),s=!x(e,n),d=s||de(e,a.minDate,a.maxDate,a.disabled),m=!d&&(a.isDateUnavailable?.(o)??!1),c=me(a.value,e),i=P(a.value)?Y(a.value,e):void 0,F=h(e,new Date),j=h(e,a.focusedDate);return(0,mt.jsx)(J.Primitive.button,{type:"button",role:"gridcell","aria-selected":c,"aria-disabled":m||void 0,"data-skdx-calendar-cell":o,"data-state":c?"selected":void 0,"data-today":F?"":void 0,"data-outside-month":s?"":void 0,"data-disabled":d?"":void 0,"data-unavailable":m?"":void 0,"data-range-start":i==="start"?"":void 0,"data-range-middle":i==="middle"?"":void 0,"data-range-end":i==="end"?"":void 0,tabIndex:j?0:-1,disabled:d,...t,...(0,lt.skdxPart)("calendar","cell",t.className),ref:r,onClick:(0,J.composeEventHandlers)(t.onClick,()=>{if(!d){if(m){a.setFocusedDate(e);return}a.onValueChange(e),a.setFocusedDate(e)}}),children:t.children??e.getDate()})});G.displayName="CalendarCell";var Q=require("react/jsx-runtime"),ye=X.forwardRef(({children:e,...t},r)=>{let a=l("CalendarGridBody"),n=T(a.month),o=X.useMemo(()=>le(n,a.weekStartsOn),[n,a.weekStartsOn]);return(0,Q.jsx)(ut.Primitive.div,{role:"rowgroup",...t,...(0,ct.skdxPart)("calendar","grid-body",t.className),ref:r,children:e??o.map(s=>(0,Q.jsx)(k,{children:s.map(({date:d})=>(0,Q.jsx)(G,{date:d},d.toISOString()))},s[0].date.toISOString()))})});ye.displayName="CalendarGridBody";0&&(module.exports={Calendar,CalendarCell,CalendarGrid,CalendarGridBody,CalendarGridContext,CalendarGridHead,CalendarHeader,CalendarHeading,CalendarNextButton,CalendarPreviousButton,CalendarProvider,CalendarRow,CalendarWeekDay,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,useCalendarContext,useCalendarContextInternal,useCalendarGridMonth});
+"use strict";var en=Object.create;var ve=Object.defineProperty;var tn=Object.getOwnPropertyDescriptor;var an=Object.getOwnPropertyNames;var nn=Object.getPrototypeOf,rn=Object.prototype.hasOwnProperty;var on=(e,t)=>{for(var n in t)ve(e,n,{get:t[n],enumerable:!0})},Vt=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of an(t))!rn.call(e,r)&&r!==n&&ve(e,r,{get:()=>t[r],enumerable:!(a=tn(t,r))||a.enumerable});return e};var w=(e,t,n)=>(n=e!=null?en(nn(e)):{},Vt(t||!e||!e.__esModule?ve(n,"default",{value:e,enumerable:!0}):n,e)),sn=e=>Vt(ve({},"__esModule",{value:!0}),e);var un={};on(un,{CALENDAR_VIEWS:()=>k,CALENDAR_YEAR_PAGE:()=>Z,Calendar:()=>Aa,CalendarCell:()=>Ae,CalendarGrid:()=>Se,CalendarGridBody:()=>Oe,CalendarGridContext:()=>He,CalendarGridHead:()=>Ue,CalendarHeader:()=>$e,CalendarHeading:()=>he,CalendarMonthGrid:()=>Qe,CalendarNextButton:()=>_e,CalendarPreviousButton:()=>ze,CalendarProvider:()=>Va,CalendarRootContext:()=>ne,CalendarRow:()=>re,CalendarWeekDay:()=>Ie,CalendarWeekNumber:()=>We,CalendarWeekNumberHeader:()=>Be,CalendarYearGrid:()=>Xe,addDays:()=>V,addMonths:()=>M,addYears:()=>Pe,anchorOf:()=>K,clampToDateRange:()=>Le,clampToMonth:()=>je,clampView:()=>wt,clearLocaleNameCache:()=>Yt,emptySelection:()=>xt,endOfWeek:()=>ct,formatDateLabel:()=>B,formatMonthLabel:()=>E,formatViewPageLabel:()=>Y,formatYear:()=>H,formatYearRange:()=>Me,getDaysInMonth:()=>pe,getISOWeek:()=>gt,getLocaleWeekStartsOn:()=>ke,getMonthNames:()=>Re,getVisibleWeeks:()=>ht,getWeekDayNames:()=>me,hasAvailableDate:()=>yt,isDateDisabled:()=>ut,isDateRange:()=>q,isDateSelected:()=>ft,isSameDay:()=>U,isSameMonth:()=>N,nextSelection:()=>Ha,rangePositionOf:()=>Ye,resetInstantDateWarning:()=>mn,resolveCalendarDisabled:()=>Sa,resolveLocale:()=>I,selectionAnnouncement:()=>Ea,startOfMonth:()=>A,startOfWeek:()=>ce,stripTime:()=>f,toISODateString:()=>ue,useCalendarContext:()=>cn,useCalendarContextInternal:()=>u,useCalendarGridMonth:()=>fe,warnInstantDate:()=>La,yearPageStart:()=>et});module.exports=sn(un);var d=w(require("react"),1),ka=require("../utils/composeRefs.cjs"),Ma=require("../utils/createContext.cjs"),P=require("../utils/dateValue.cjs"),Pa=require("../utils/is-dev-mode.cjs"),tt=require("../utils/liveAnnouncer.cjs"),Na=require("../utils/part.cjs"),Ta=require("../utils/primitive.cjs"),De=require("../utils/useControllableState.cjs");var va=w(require("react"),1);var ae=w(require("react"),1),Ne=require("../utils/direction.cjs"),Gt=require("../utils/part.cjs"),Te=require("../utils/primitive.cjs");var dt=new Date(2024,0,7),lt=new Map;function At(e,t){let n=lt.get(e);if(n)return n;let a=t();return lt.set(e,a),a}function I(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function Re(e,t="long"){let n=I(e);return At(`m|${n}|${t}`,()=>{let a=new Intl.DateTimeFormat(n,{month:t,timeZone:"UTC"});return Array.from({length:12},(r,o)=>a.format(Date.UTC(2024,o,15)))})}function me(e,t=0,n="short"){let a=I(e),r=At(`w|${a}|${n}`,()=>{let s=new Intl.DateTimeFormat(a,{weekday:n});return Array.from({length:7},(i,l)=>s.format(new Date(dt.getFullYear(),dt.getMonth(),dt.getDate()+l)))}),o=(t%7+7)%7;return r.slice(o).concat(r.slice(0,o))}function ke(e){try{let t=new Intl.Locale(I(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function E(e,t){return e.toLocaleDateString(I(t),{month:"long",year:"numeric"})}function H(e,t){return new Intl.NumberFormat(I(t),{useGrouping:!1}).format(e)}function Me(e,t,n){return`${H(e,n)} \u2013 ${H(t,n)}`}function B(e,t){return e.toLocaleDateString(I(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function Yt(){lt.clear()}var mt=require("react/jsx-runtime"),Se=ae.forwardRef(({monthOffset:e=0,...t},n)=>{let a=u("CalendarGrid"),r=(0,Ne.useDirection)(),o=a.months[e]??a.month,s=ae.useMemo(()=>({gridMonth:o}),[o]),i=ae.useContext(ne),l=h=>{let c=Le(h,a.minDate,a.maxDate);a.months.some(b=>N(c,b))||a.onMonthChange(A(c)),a.setFocusedDate(c),requestAnimationFrame(()=>{let b=ue(c);(i?.current??document).querySelector(`[data-skdx-calendar-cell="${b}"]:not([disabled])`)?.focus()})},C=h=>{let c;switch((0,Ne.directionalKey)(h.key,h.currentTarget,r)){case"ArrowLeft":c=V(a.focusedDate,-1);break;case"ArrowRight":c=V(a.focusedDate,1);break;case"ArrowUp":c=V(a.focusedDate,-7);break;case"ArrowDown":c=V(a.focusedDate,7);break;case"Home":c=ce(a.focusedDate,a.weekStartsOn);break;case"End":c=ct(a.focusedDate,a.weekStartsOn);break;case"PageUp":c=h.shiftKey?Pe(a.focusedDate,-1):M(a.focusedDate,-1);break;case"PageDown":c=h.shiftKey?Pe(a.focusedDate,1):M(a.focusedDate,1);break;default:return}h.preventDefault(),l(c)};return a.view!=="day"?null:(0,mt.jsx)(He.Provider,{value:s,children:(0,mt.jsx)(Te.Primitive.div,{role:"grid","aria-label":t["aria-label"]||t["aria-labelledby"]?void 0:E(o,a.locale),"aria-multiselectable":a.selectionMode!=="single","aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...t,...(0,Gt.skdxPart)("calendar","grid",t.className),ref:n,onKeyDown:(0,Te.composeEventHandlers)(t.onKeyDown,C)})})});Se.displayName="CalendarGrid";var Fe=w(require("react"),1),Zt=require("../utils/part.cjs"),Jt=require("../utils/primitive.cjs");var Ee=w(require("react"),1),Wt=require("../utils/dateValue.cjs"),Ft=require("../utils/part.cjs"),Ve=require("../utils/primitive.cjs");var Ot=require("react/jsx-runtime"),Ae=Ee.forwardRef(({date:e,...t},n)=>{let a=u("CalendarCell"),r=fe(a.month),o=Ee.useMemo(()=>(0,Wt.toDate)(e,"date")??r,[e,r]),s=ue(o),i=!N(o,r),l=a.disabled||i&&!a.outsideDaySelectable||ut(o,a.minDate,a.maxDate,a.isDateDisabled),C=!l&&(a.isDateUnavailable?.(o)??!1),h=ft(a.value,o),c=q(a.value)?Ye(a.value,o):void 0,b=U(o,a.today),T=U(o,a.focusedDate);return(0,Ot.jsx)(Ve.Primitive.button,{type:"button",role:"gridcell","aria-selected":h,"aria-disabled":C||void 0,"aria-current":b?"date":void 0,"aria-label":B(o,a.locale),"data-skdx-calendar-cell":s,"data-state":h?"selected":void 0,"data-today":b?"":void 0,"data-outside-month":i?"":void 0,"data-disabled":l?"":void 0,"data-unavailable":C?"":void 0,"data-range-start":c==="start"?"":void 0,"data-range-middle":c==="middle"?"":void 0,"data-range-end":c==="end"?"":void 0,tabIndex:T?0:-1,disabled:l,...t,...(0,Ft.skdxPart)("calendar","cell",t.className),ref:n,onClick:(0,Ve.composeEventHandlers)(t.onClick,()=>{if(!l){if(C){a.setFocusedDate(o);return}a.onValueChange(o),a.setFocusedDate(o),i&&!a.months.some(J=>N(o,J))&&a.onMonthChange(o)}}),children:t.children??o.getDate()})});Ae.displayName="CalendarCell";var It=w(require("react"),1),Bt=require("../utils/part.cjs"),Ut=require("../utils/primitive.cjs"),$t=require("react/jsx-runtime"),re=It.forwardRef((e,t)=>(0,$t.jsx)(Ut.Primitive.div,{role:"row",...e,...(0,Bt.skdxPart)("calendar","row",e.className),ref:t}));re.displayName="CalendarRow";var Ge=w(require("react"),1),Kt=require("../utils/dateValue.cjs"),_t=require("../utils/part.cjs"),qt=require("../utils/primitive.cjs");var zt=require("react/jsx-runtime"),We=Ge.forwardRef(({date:e,children:t,...n},a)=>{let r=u("CalendarWeekNumber"),o=Ge.useMemo(()=>(0,Kt.toDate)(e,"date")??r.month,[e,r.month]),s=gt(o);return(0,zt.jsx)(qt.Primitive.div,{role:"rowheader","aria-label":`Week ${s}`,...n,...(0,_t.skdxPart)("calendar","week-number",n.className),ref:a,children:t??s})});We.displayName="CalendarWeekNumber";var oe=require("react/jsx-runtime"),Oe=Fe.forwardRef(({children:e,...t},n)=>{let a=u("CalendarGridBody"),r=fe(a.month),o=Fe.useMemo(()=>ht(r,a.weekStartsOn),[r,a.weekStartsOn]);return(0,oe.jsx)(Jt.Primitive.div,{role:"rowgroup",...t,...(0,Zt.skdxPart)("calendar","grid-body",t.className),ref:n,children:e??o.map(s=>(0,oe.jsxs)(re,{children:[a.weekNumbers?(0,oe.jsx)(We,{date:s[0].date}):null,s.map(({date:i})=>(0,oe.jsx)(Ae,{date:i},i.toISOString()))]},s[0].date.toISOString()))})});Oe.displayName="CalendarGridBody";var oa=w(require("react"),1),ia=require("../utils/part.cjs"),sa=require("../utils/primitive.cjs");var Qt=w(require("react"),1),Xt=require("../utils/part.cjs"),jt=require("../utils/primitive.cjs"),ea=require("react/jsx-runtime"),Ie=Qt.forwardRef((e,t)=>(0,ea.jsx)(jt.Primitive.div,{role:"columnheader",...e,...(0,Xt.skdxPart)("calendar","week-day",e.className),ref:t}));Ie.displayName="CalendarWeekDay";var ta=w(require("react"),1),aa=require("../utils/part.cjs"),na=require("../utils/primitive.cjs"),ra=require("react/jsx-runtime"),Be=ta.forwardRef((e,t)=>(0,ra.jsx)(na.Primitive.div,{role:"columnheader","aria-label":"Week number",...e,...(0,aa.skdxPart)("calendar","week-number-header",e.className),ref:t}));Be.displayName="CalendarWeekNumberHeader";var ie=require("react/jsx-runtime"),Ue=oa.forwardRef(({children:e,...t},n)=>{let a=u("CalendarGridHead");return(0,ie.jsx)(sa.Primitive.div,{role:"rowgroup",...t,...(0,ia.skdxPart)("calendar","grid-head",t.className),ref:n,children:e??(0,ie.jsxs)(re,{children:[a.weekNumbers?(0,ie.jsx)(Be,{}):null,a.weekDayNames.map(r=>(0,ie.jsx)(Ie,{"aria-label":r.long,children:r.short},r.long))]})})});Ue.displayName="CalendarGridHead";var da=w(require("react"),1),la=require("../utils/part.cjs"),ma=require("../utils/primitive.cjs"),ca=require("react/jsx-runtime"),$e=da.forwardRef((e,t)=>(0,ca.jsx)(ma.Primitive.div,{...e,...(0,la.skdxPart)("calendar","header",e.className),ref:t}));$e.displayName="CalendarHeader";var ua=w(require("react"),1),pt=require("../utils/part.cjs"),ge=require("../utils/primitive.cjs");var Dt=require("react/jsx-runtime"),he=ua.forwardRef(({monthOffset:e=0,children:t,...n},a)=>{let r=u("CalendarHeading"),o=r.months[e]??r.month,s=r.view==="day"?o:r.focusedDate,i=Y(s,r.view,r.locale),l=k[k.indexOf(r.view)+1];return l!==void 0&&k.indexOf(r.view)<k.indexOf(r.maxView)?(0,Dt.jsx)(ge.Primitive.button,{type:"button",...n,...(0,pt.skdxPart)("calendar","heading",n.className),ref:a,onClick:(0,ge.composeEventHandlers)(n.onClick,()=>r.setView(l)),children:t??i}):(0,Dt.jsx)(ge.Primitive.div,{...n,...(0,pt.skdxPart)("calendar","heading",n.className),ref:a,children:t??i})});he.displayName="CalendarHeading";var fa=w(require("react"),1),ga=require("../utils/part.cjs"),Ke=require("../utils/primitive.cjs");var ha=require("react/jsx-runtime"),dn={day:"Next month",month:"Next year",year:"Next 20 years"},_e=fa.forwardRef((e,t)=>{let n=u("CalendarNextButton");return(0,ha.jsx)(Ke.Primitive.button,{type:"button","aria-label":dn[n.view],...e,...(0,ga.skdxPart)("calendar","next-button",e.className),ref:t,onClick:(0,Ke.composeEventHandlers)(e.onClick,()=>n.pageMonths(1))})});_e.displayName="CalendarNextButton";var pa=w(require("react"),1),Da=require("../utils/part.cjs"),qe=require("../utils/primitive.cjs");var Ca=require("react/jsx-runtime"),ln={day:"Previous month",month:"Previous year",year:"Previous 20 years"},ze=pa.forwardRef((e,t)=>{let n=u("CalendarPreviousButton");return(0,Ca.jsx)(qe.Primitive.button,{type:"button","aria-label":ln[n.view],...e,...(0,Da.skdxPart)("calendar","previous-button",e.className),ref:t,onClick:(0,qe.composeEventHandlers)(e.onClick,()=>n.pageMonths(-1))})});ze.displayName="CalendarPreviousButton";var z=w(require("react"),1),Ze=require("../utils/direction.cjs"),ya=require("../utils/liveAnnouncer.cjs"),Je=require("../utils/part.cjs"),G=require("../utils/primitive.cjs");var $=require("react/jsx-runtime");function Ct(){return 4}function ba(e,t){let n=u(t),a=z.useContext(ne),r=(0,Ze.useDirection)(),o=e,s=e==="month"?1:12,i=e==="month"?12:Z,l=n.focusedDate,C=e==="month"?l.getMonth():l.getFullYear()-et(l.getFullYear()),{locale:h,minDate:c,maxDate:b,isDateDisabled:T,today:J,value:Q}=n,x=K(Q),ye=z.useMemo(()=>{let R=Re(h,"short"),g=l.getFullYear();return Array.from({length:i},(se,y)=>{let X=e==="month"?je(l,new Date(g,y,1)):M(l,(y-C)*s),v=e==="month"?g:X.getFullYear(),at=e==="month"?new Date(v,y,1):new Date(v,0,1),nt=e==="month"?new Date(v,y,pe(v,y)):new Date(v,11,31),de=j=>j!==null&&j.getFullYear()===v&&(e==="year"||j.getMonth()===y);return{date:X,key:e==="month"?`${v}-${y}`:String(v),text:e==="month"?R[y]:H(v,h),label:e==="month"?E(new Date(v,y,1),h):H(v,h),refused:!yt(at,nt,c,b,T),selected:de(x),today:de(J)}})},[e,i,s,l,C,h,c,b,T,x,J]),be=R=>{let g=M(l,R*s),se=Y(l,o,h),y=Y(g,o,h);n.setFocusedDate(g),y!==se&&(0,ya.announce)(y),requestAnimationFrame(()=>{let X=e==="month"?`${g.getFullYear()}-${g.getMonth()}`:String(g.getFullYear());(a?.current??document).querySelector(`[data-skdx-calendar-view-cell="${X}"]`)?.focus({preventScroll:!0})})};return{context:n,cells:ye,focusedIndex:C,handleKeyDown:R=>{let g;switch((0,Ze.directionalKey)(R.key,R.currentTarget,r)){case"ArrowLeft":g=-1;break;case"ArrowRight":g=1;break;case"ArrowUp":g=-Ct();break;case"ArrowDown":g=Ct();break;case"Home":g=-C;break;case"End":g=i-1-C;break;case"PageUp":g=-i*(R.shiftKey?10:1);break;case"PageDown":g=i*(R.shiftKey?10:1);break;default:return}R.preventDefault(),g!==0&&be(g)}}}function wa({cells:e,focusedIndex:t,navigate:n}){let a=[],r=Ct();for(let o=0;o<e.length;o+=r)a.push(e.slice(o,o+r));return(0,$.jsx)(G.Primitive.div,{role:"rowgroup",children:a.map((o,s)=>(0,$.jsx)(G.Primitive.div,{role:"row",children:o.map((i,l)=>{let C=s*r+l;return(0,$.jsx)(G.Primitive.button,{type:"button",role:"gridcell","aria-disabled":i.refused||void 0,"aria-selected":i.selected,"aria-current":i.today?"date":void 0,"aria-label":i.label,"data-skdx-calendar-view-cell":i.key,"data-state":i.selected?"selected":void 0,"data-today":i.today?"":void 0,"data-disabled":i.refused?"":void 0,tabIndex:C===t?0:-1,...(0,Je.skdxPart)("calendar","view-cell"),onClick:()=>{i.refused||n(i.date)},children:i.text},i.key)})},o[0].key))})}var Qe=z.forwardRef(({children:e,...t},n)=>{let{context:a,cells:r,focusedIndex:o,handleKeyDown:s}=ba("month","CalendarMonthGrid");return a.view!=="month"?null:(0,$.jsx)(G.Primitive.div,{role:"grid","aria-label":t["aria-label"]||t["aria-labelledby"]?void 0:Y(a.focusedDate,"month",a.locale),"aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...t,...(0,Je.skdxPart)("calendar","month-grid",t.className),ref:n,onKeyDown:(0,G.composeEventHandlers)(t.onKeyDown,s),children:e??(0,$.jsx)(wa,{cells:r,focusedIndex:o,navigate:a.navigateToUnit})})});Qe.displayName="CalendarMonthGrid";var Xe=z.forwardRef(({children:e,...t},n)=>{let{context:a,cells:r,focusedIndex:o,handleKeyDown:s}=ba("year","CalendarYearGrid");return a.view!=="year"?null:(0,$.jsx)(G.Primitive.div,{role:"grid","aria-label":t["aria-label"]||t["aria-labelledby"]?void 0:Y(a.focusedDate,"year",a.locale),"aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...t,...(0,Je.skdxPart)("calendar","year-grid",t.className),ref:n,onKeyDown:(0,G.composeEventHandlers)(t.onKeyDown,s),children:e??(0,$.jsx)(wa,{cells:r,focusedIndex:o,navigate:a.navigateToUnit})})});Xe.displayName="CalendarYearGrid";var p=require("react/jsx-runtime"),xa=({dir:e})=>(0,p.jsx)("svg",{viewBox:"0 0 16 16",width:"1em",height:"1em",fill:"none","aria-hidden":"true",focusable:"false",children:(0,p.jsx)("path",{d:e==="left"?"M10 3 5 8l5 5":"M6 3l5 5-5 5",stroke:"currentColor",strokeWidth:"1.5",strokeLinecap:"round",strokeLinejoin:"round"})}),Ra=()=>{let{months:e}=u("CalendarAnatomy"),t=e.length>1;return(0,p.jsxs)(p.Fragment,{children:[(0,p.jsxs)($e,{children:[(0,p.jsx)(ze,{children:(0,p.jsx)(xa,{dir:"left"})}),t?null:(0,p.jsx)(he,{}),(0,p.jsx)(_e,{children:(0,p.jsx)(xa,{dir:"right"})})]}),e.map((n,a)=>(0,p.jsxs)(va.Fragment,{children:[t?(0,p.jsx)(he,{monthOffset:a}):null,(0,p.jsxs)(Se,{monthOffset:a,children:[(0,p.jsx)(Ue,{}),(0,p.jsx)(Oe,{})]})]},n.toISOString())),(0,p.jsx)(Qe,{}),(0,p.jsx)(Xe,{})]})};var Ce=require("react/jsx-runtime");function pe(e,t){return new Date(e,t+1,0).getDate()}function A(e){return new Date(e.getFullYear(),e.getMonth(),1)}function M(e,t){let n=e.getDate(),a=new Date(e.getFullYear(),e.getMonth(),1);a.setMonth(a.getMonth()+t);let r=pe(a.getFullYear(),a.getMonth());return a.setDate(Math.min(n,r)),a}function Pe(e,t){return M(e,t*12)}function V(e,t){let n=new Date(e);return n.setDate(n.getDate()+t),n}function U(e,t){return!e||!t?!1:e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate()}function N(e,t){return e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()}function ce(e,t){let n=new Date(e.getFullYear(),e.getMonth(),e.getDate()),a=(n.getDay()-t+7)%7;return n.setDate(n.getDate()-a),n}function ct(e,t){return V(ce(e,t),6)}function f(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function ut(e,t,n,a){let r=f(e).getTime();return!!(t&&r<f(t).getTime()||n&&r>f(n).getTime()||a?.(e))}function Le(e,t,n){return t&&f(e).getTime()<f(t).getTime()?t:n&&f(e).getTime()>f(n).getTime()?n:e}function Sa(e,t){return{disabled:e??!1,isDateDisabled:t}}var bt=!1;function mn(){bt=!1}function La(e,t){!e||bt||!(e.getUTCHours()===0&&e.getUTCMinutes()===0&&e.getUTCSeconds()===0&&e.getUTCMilliseconds()===0)||e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(bt=!0,(0,Pa.isDevMode)()&&console.warn(`[skdx] Calendar: \`${t}\` 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.`))}function gt(e){let t=new Date(e.getFullYear(),e.getMonth(),e.getDate());t.setDate(t.getDate()-(t.getDay()+6)%7+3);let n=new Date(t.getFullYear(),0,4);return n.setDate(n.getDate()-(n.getDay()+6)%7+3),1+Math.round((t.getTime()-n.getTime())/(10080*60*1e3))}function ue(e){let t=e.getFullYear(),n=String(e.getMonth()+1).padStart(2,"0"),a=String(e.getDate()).padStart(2,"0");return`${t}-${n}-${a}`}function je(e,t){if(N(e,t))return e;let n=pe(t.getFullYear(),t.getMonth());return new Date(t.getFullYear(),t.getMonth(),Math.min(e.getDate(),n))}var k=["day","month","year"],Z=20;function wt(e,t,n){let a=k.indexOf(t),r=Math.max(a,k.indexOf(n));return k[Math.min(Math.max(k.indexOf(e),a),r)]}function et(e){return Math.floor(e/Z)*Z}function yt(e,t,n,a,r){let o=n&&f(n)>f(e)?f(n):f(e),s=a&&f(a)<f(t)?f(a):f(t);if(o.getTime()>s.getTime())return!1;if(!r)return!0;for(let i=o;i.getTime()<=s.getTime();i=V(i,1))if(!r(i))return!0;return!1}function Y(e,t,n){if(t==="day")return E(e,n);if(t==="month")return H(e.getFullYear(),n);let a=et(e.getFullYear());return Me(a,a+Z-1,n)}function ht(e,t=0){let n=ce(A(e),t),a=[],r=n;for(let o=0;o<6;o++){let s=[];for(let i=0;i<7;i++)s.push({date:r,outsideMonth:!N(r,e)}),r=V(r,1);a.push(s)}return a}function q(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function xt(e){return e==="multiple"?[]:null}function ft(e,t){return e===null?!1:Array.isArray(e)?e.some(n=>U(n,t)):q(e)?Ye(e,t)!==void 0:U(e,t)}function Ye(e,t){let n=f(t).getTime(),a=f(e.start).getTime();if(e.end===null)return n===a?"start":void 0;let r=f(e.end).getTime();if(!(n<a||n>r))return n===a?"start":n===r?"end":"middle"}function Ha(e,t,n){if(e==="single")return n;if(e==="multiple"){let r=Array.isArray(t)?t:[],o=r.filter(s=>!U(s,n));return o.length!==r.length?o:[...r,n].sort((s,i)=>s.getTime()-i.getTime())}let a=q(t)&&t.end===null?t:void 0;return a?f(n).getTime()<f(a.start).getTime()?{start:n,end:a.start}:{start:a.start,end:n}:{start:n,end:null}}function Ea(e,t){return q(e)?e.end===null?`${B(e.start,t)} selected as the range start. Select an end date.`:`Range selected, ${B(e.start,t)} to ${B(e.end,t)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var[Va,u]=(0,Ma.createSafeContext)("Calendar");function cn(){return u("useCalendarContext")}var He=d.createContext(null);function fe(e){return d.useContext(He)?.gridMonth??e}var ne=d.createContext(null);function K(e){return e===null?null:Array.isArray(e)?e[0]??null:q(e)?e.start:e}var Aa=d.forwardRef(({selectionMode:e="single",value:t,defaultValue:n,onValueChange:a,month:r,defaultMonth:o,onMonthChange:s,focusedDate:i,defaultFocusedDate:l,onFocusChange:C,view:h,defaultView:c="day",minView:b="day",maxView:T="year",onViewChange:J,numberOfMonths:Q=1,locale:x,minDate:ye,maxDate:be,weekStartsOn:vt,pageBehavior:R="visible",weekNumbers:g=!1,today:se,readOnly:y=!1,disabled:X,outsideDaySelectable:v=!1,isDateDisabled:at,isDateUnavailable:nt,getSelectionAnnouncement:de,getMonthAnnouncement:j,children:Ya,...Rt},Ga)=>{let{disabled:rt,isDateDisabled:Wa}=Sa(X,at),kt=d.useRef(null),Fa=(0,ka.useComposedRefs)(Ga,kt),Oa=d.useMemo(()=>(0,P.toCalendarValue)(t,e,"value"),[t,e]),Ia=d.useMemo(()=>(0,P.toCalendarValue)(n,e,"defaultValue"),[n,e]),Ba=d.useMemo(()=>(0,P.toDate)(r,"month")??void 0,[r]),Ua=d.useMemo(()=>(0,P.toDate)(o,"defaultMonth")??void 0,[o]),ot=d.useMemo(()=>(0,P.toDate)(ye,"minDate")??void 0,[ye]),it=d.useMemo(()=>(0,P.toDate)(be,"maxDate")??void 0,[be]),$a=d.useMemo(()=>(0,P.toDate)(se,"today")??void 0,[se]),[S=null,Mt]=(0,De.useControllableState)({prop:Oa,defaultProp:Ia??xt(e),onChange:m=>a?.(m??xt(e))}),[Ka]=d.useState(()=>new Date),Pt=$a??Ka;La(K(S),"value");let Nt=A(Ua??K(S)??Pt),[_=Nt,W]=(0,De.useControllableState)({prop:Ba,defaultProp:Nt,onChange:s}),_a=d.useMemo(()=>(0,P.toDate)(i,"focusedDate")??void 0,[i]),Tt=d.useMemo(()=>(0,P.toDate)(l,"defaultFocusedDate")??void 0,[l]),[ee=Tt??K(S)??_,St]=(0,De.useControllableState)({prop:_a,defaultProp:Tt??K(S)??_,onChange:C}),F=d.useCallback(m=>{let D=Le(m,ot,it);U(D,ee)||St(D)},[ee,St,ot,it]),[qa=c,Lt]=(0,De.useControllableState)({prop:h,defaultProp:c,onChange:J}),L=wt(qa,b,T),st=d.useCallback(m=>{let D=wt(m,b,T);D!==L&&Lt(D)},[L,b,T,Lt]),we=vt??ke(x),za=d.useMemo(()=>{let m=me(x,we,"short"),D=me(x,we,"long");return m.map((O,xe)=>({short:O,long:D[xe]}))},[x,we]),le=d.useMemo(()=>Array.from({length:Math.max(1,Q)},(m,D)=>M(_,D)),[_,Q]),Za=d.useCallback(m=>{if(y||rt)return;let D=Ha(e,S,m);Mt(D);let O=(de??Ea)(D,x);O&&(0,tt.announce)(O)},[y,rt,e,S,Mt,x,de]),Ja=d.useCallback(m=>W(A(m)),[W]),Qa=d.useCallback(m=>{if(L!=="day"){let ja=L==="month"?12:12*Z,Et=M(ee,m*ja);F(Et),(0,tt.announce)(Y(Et,L,x));return}let D=R==="single"?1:Math.max(1,Q),O=M(_,m*D);W(A(O)),F(je(ee,O));let xe=(j??E)(O,x);xe&&(0,tt.announce)(xe)},[L,R,Q,_,W,ee,F,j,x]),Xa=d.useCallback(m=>{F(m),le.some(D=>N(m,D))||W(A(m)),st(k[k.indexOf(L)-1]??"day")},[F,le,W,st,L]),te=d.useMemo(()=>{let m=K(S);return m?f(m).getTime():null},[S]),Ht=d.useRef(te);return d.useEffect(()=>{if(te===null||te===Ht.current)return;Ht.current=te;let m=new Date(te);le.some(D=>N(m,D))||(F(m),W(A(m)))},[te,le,W,F]),(0,Ce.jsx)(Va,{value:S,selectionMode:e,month:_,months:le,focusedDate:ee,today:Pt,weekStartsOn:we,weekNumbers:g,locale:x,weekDayNames:za,minDate:ot,maxDate:it,readOnly:y,disabled:rt,outsideDaySelectable:v,isDateDisabled:Wa,isDateUnavailable:nt,onValueChange:Za,onMonthChange:Ja,pageMonths:Qa,setFocusedDate:F,view:L,minView:b,maxView:T,setView:st,navigateToUnit:Xa,children:(0,Ce.jsx)(Ta.Primitive.div,{...Rt,...(0,Na.skdxPart)("calendar","root",Rt.className),ref:Fa,children:(0,Ce.jsx)(ne.Provider,{value:kt,children:Ya??(0,Ce.jsx)(Ra,{})})})})});Aa.displayName="Calendar";0&&(module.exports={CALENDAR_VIEWS,CALENDAR_YEAR_PAGE,Calendar,CalendarCell,CalendarGrid,CalendarGridBody,CalendarGridContext,CalendarGridHead,CalendarHeader,CalendarHeading,CalendarMonthGrid,CalendarNextButton,CalendarPreviousButton,CalendarProvider,CalendarRootContext,CalendarRow,CalendarWeekDay,CalendarWeekNumber,CalendarWeekNumberHeader,CalendarYearGrid,addDays,addMonths,addYears,anchorOf,clampToDateRange,clampToMonth,clampView,clearLocaleNameCache,emptySelection,endOfWeek,formatDateLabel,formatMonthLabel,formatViewPageLabel,formatYear,formatYearRange,getDaysInMonth,getISOWeek,getLocaleWeekStartsOn,getMonthNames,getVisibleWeeks,getWeekDayNames,hasAvailableDate,isDateDisabled,isDateRange,isDateSelected,isSameDay,isSameMonth,nextSelection,rangePositionOf,resetInstantDateWarning,resolveCalendarDisabled,resolveLocale,selectionAnnouncement,startOfMonth,startOfWeek,stripTime,toISODateString,useCalendarContext,useCalendarContextInternal,useCalendarGridMonth,warnInstantDate,yearPageStart});

package/dist/calendar/Calendar.d.cts

@@ -1,18 +1,12 @@
 import * as React from 'react';
-import type { CalendarContextValue, CalendarDay, CalendarGridContextValue, CalendarProps, CalendarSelectionMode, CalendarValue, DateRange, RangePosition } from './types.cjs';
-/**
- * Month-grid date picker (WAI-ARIA `grid` pattern), built on plain native
- * `Date` math and `Intl` for names — no date-library dependency. Selects a
- * single date, an arbitrary set of dates, or a start/end range.
- */
+import type { CalendarContextValue, CalendarDay, CalendarGridContextValue, CalendarProps, CalendarSelectionMode, CalendarValue, CalendarView, DateRange, RangePosition } from './types.cjs';
 /** @internal Number of days in the given zero-based `month` of `year` (e.g. `getDaysInMonth(2024, 1)` → 29). */
 export declare function getDaysInMonth(year: number, month: number): number;
 /** @internal Midnight on the first day of `date`'s month, in local time. */
 export declare function startOfMonth(date: Date): Date;
 /**
- * Adds `amount` calendar months to `date` (negative to subtract), clamping the
- * day of month so it never overflows into the next month — e.g. Jan 31 + 1
- * month → Feb 28/29. Returns a new local-time `Date`.
+ * Adds `amount` calendar months to `date`, clamping the day so it never
+ * overflows into the next month — e.g. Jan 31 + 1 month → Feb 28/29.
  *
  * @param date - Base date; not mutated.
  * @param amount - Months to add; may be negative.
@@ -22,19 +16,14 @@ export declare function addMonths(date: Date, amount: number): Date;
 /** @internal Adds `amount` years to `date` via {@link addMonths} (so Feb 29 clamps to Feb 28 in non-leap years). */
 export declare function addYears(date: Date, amount: number): Date;
 /**
- * Adds `amount` days to `date` (negative to subtract), returning a new `Date`.
- * Rolls over month and year boundaries naturally.
+ * Adds `amount` days to `date`, rolling over month and year boundaries naturally.
  *
  * @param date - Base date; not mutated.
  * @param amount - Days to add; may be negative.
  * @returns A new {@link Date} `amount` days from `date`.
  */
 export declare function addDays(date: Date, amount: number): Date;
-/**
- * Whether `a` and `b` fall on the same calendar day (year, month and date),
- * ignoring the time of day. Returns `false` if either argument is `null` or
- * `undefined`.
- */
+/** Whether `a` and `b` fall on the same calendar day, ignoring time of day; `false` if either is nullish. */
 export declare function isSameDay(a: Date | null | undefined, b: Date | null | undefined): boolean;
 /** Whether `a` and `b` fall in the same calendar month of the same year. */
 export declare function isSameMonth(a: Date, b: Date): boolean;
@@ -46,27 +35,80 @@ export declare function endOfWeek(date: Date, weekStartsOn: number): Date;
 export declare function stripTime(date: Date): Date;
 /** @internal Whether `date` is out of range: before `minDate`, after `maxDate` (both compared date-only), or rejected by `disabledFn`. */
 export declare function isDateDisabled(date: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/**
+ * @internal Clamps `date` into `[minDate, maxDate]` (compared date-only), the
+ * same convention Slider and NumberField use for an out-of-bounds step —
+ * never a silent no-op, never a jump onto a natively `disabled` cell the
+ * roving tab stop could then get stuck on.
+ */
+export declare function clampToDateRange(date: Date, minDate: Date | undefined, maxDate: Date | undefined): Date;
+/** The two disabled-ness inputs a Calendar resolves. */
+export interface ResolvedCalendarDisabled {
+    /** Whether the *whole* calendar is disabled. */
+    disabled: boolean;
+    /** The per-date predicate to use. */
+    isDateDisabled?: (date: Date) => boolean;
+}
+/** @internal Resolves disabled and isDateDisabled props. */
+export declare function resolveCalendarDisabled(disabled: boolean | undefined, isDateDisabled: ((date: Date) => boolean) | undefined): ResolvedCalendarDisabled;
+/** @internal Puts {@link warnInstantDate} back to "not yet warned". Only needed by tests. */
+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.
+ *
+ * @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;
+/**
+ * ISO-8601 week number of `date` (1–53). ISO 8601 numbers from Monday and
+ * puts the first Thursday in week 1, so weeks belong to the year holding their
+ * Thursday: Jan 1 can be week 52/53 of previous year, Dec 30 can be week 1 of
+ * next. Independent of `weekStartsOn`. Uses local wall-clock time, never UTC.
+ *
+ * @param date - Any day of the week to number; not mutated
+ * @returns The ISO week number, 1–53
+ */
+export declare function getISOWeek(date: Date): number;
 /** @internal Formats `date` as a local-time `YYYY-MM-DD` string (no timezone conversion, unlike `Date.toISOString`). */
 export declare function toISODateString(date: Date): string;
 /** @internal Projects `date`'s day-of-month onto `targetMonth`, clamping to that month's last day; returns `date` unchanged if already in `targetMonth`. */
 export declare function clampToMonth(date: Date, targetMonth: Date): Date;
+/**
+ * The three views, most granular first. Every clamp, step up and step down is
+ * an index move along this one array, so `minView`/`maxView` cannot disagree
+ * with `CalendarHeading` about which direction "up" is.
+ */
+export declare const CALENDAR_VIEWS: readonly ["day", "month", "year"];
+/** How many years one page of {@link CalendarYearGrid} shows, and what its start is aligned to. */
+export declare const CALENDAR_YEAR_PAGE = 20;
+/** @internal Clamps `view` into the `[minView, maxView]` window, raising `maxView` to `minView` if a consumer inverted them. */
+export declare function clampView(view: CalendarView, minView: CalendarView, maxView: CalendarView): CalendarView;
+/** @internal First year of the twenty-year page containing `year` — 2026 falls on the 2020–2039 page. */
+export declare function yearPageStart(year: number): number;
+/**
+ * Whether any day from `from` to `to` inclusive is selectable — what makes a
+ * whole month or year cell refusable. `minDate`/`maxDate` narrow the window
+ * first, so the bounds-only case needs no predicate scan; when a predicate
+ * exists, the scan stops at the first available day.
+ */
+export declare function hasAvailableDate(from: Date, to: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/**
+ * The label for whatever page `view` shows around `date` — month, year, or
+ * year-page — so the heading, grid name, and paging announcement never disagree.
+ */
+export declare function formatViewPageLabel(date: Date, view: CalendarView, locale?: string): string;
 /** Always returns a 6x7 (weeks x weekdays) grid, including adjacent-month filler days. */
 export declare function getVisibleWeeks(month: Date, weekStartsOn?: number): CalendarDay[][];
 /** Whether `value` is a {@link DateRange} rather than a single date, a date array, or nothing. */
 export declare function isDateRange(value: CalendarValue): value is DateRange;
 /** The empty selection for `mode`: `[]` for `multiple`, `null` for `single` and `range`. */
 export declare function emptySelection(mode: CalendarSelectionMode): CalendarValue;
-/**
- * Whether `date` is part of `value` — the selected day in `single` mode, a
- * member of the array in `multiple`, or anywhere from `start` to `end`
- * inclusive in `range` (so every cell in a range carries `aria-selected`).
- */
+/** Whether `date` is part of `value` — the selected day, a member of the array, or within `start`–`end` for a range. */
 export declare function isDateSelected(value: CalendarValue, date: Date): boolean;
-/**
- * Where `date` sits in `range`: `'start'`, `'end'`, `'middle'`, or `undefined`
- * when it is outside the range. A range still being anchored (`end: null`)
- * only ever reports `'start'`.
- */
+/** Where `date` sits in `range`: `'start'`, `'end'`, `'middle'`, or `undefined` outside it; an unclosed range only reports `'start'`. */
 export declare function rangePositionOf(range: DateRange, date: Date): RangePosition | undefined;
 /**
  * The selection that results from choosing `date` while `current` is selected.
@@ -89,29 +131,24 @@ export declare const CalendarProvider: {
 }, useCalendarContextInternal: (consumerName: string) => CalendarContextValue;
 /** Read the Calendar's current selection/displayed-month state (e.g. to render a heading label). */
 export declare function useCalendarContext(): CalendarContextValue;
-/**
- * @internal Which month a given `CalendarGrid` renders. Absent for a
- * single-month calendar, where every part just reads the root's `month`.
- */
+/** @internal Which month a `CalendarGrid` renders; absent for a single-month calendar, where every part reads the root's `month`. */
 export declare const CalendarGridContext: React.Context<CalendarGridContextValue | null>;
 /** The month of the enclosing `CalendarGrid`, falling back to the root's displayed month. */
 export declare function useCalendarGridMonth(fallback: Date): Date;
+/**
+ * @internal This Calendar instance's own root element, so keyboard focus
+ * restoration can scope its cell lookup to it — a page can hold several
+ * Calendars, and a `document`-wide lookup by date would grab another one's
+ * cell for the same day.
+ */
+export declare const CalendarRootContext: React.Context<React.RefObject<HTMLElement | null> | null>;
 /** @internal The date a fresh calendar should focus and display, given whatever `value` holds. */
 export declare function anchorOf(value: CalendarValue): Date | null;
 /**
- * Root of a month-grid date picker: owns the selection, displayed month(s)
- * and roving-focus date, and hands them down to every other `Calendar*` part
- * via context. Renders a plain `<div>` — layout of the header vs. grid is
- * entirely up to your CSS.
- *
- * `selectionMode` decides what `value` holds: a `Date` (`'single'`, the
- * default), a `Date[]` (`'multiple'`), or a `{ start, end }` `DateRange`
- * (`'range'`, where `end` stays `null` until the second date closes it).
- * Month and weekday names come from `Intl` for `locale`, so nothing here
- * ships a hardcoded English name table.
- *
- * Works controlled (`value` + `onValueChange`, `month` + `onMonthChange`) or
- * uncontrolled (`defaultValue`, `defaultMonth`).
+ * Root of a month-grid date picker: owns selection, displayed month(s), and
+ * roving focus, handing them to every `Calendar*` part via context;
+ * `selectionMode` picks between a `Date`, `Date[]`, or `DateRange` for
+ * `value`, and it works controlled or uncontrolled, rendering a plain `<div>`.
  *
  * @example
  * ```tsx

package/dist/calendar/Calendar.d.ts

@@ -1,18 +1,12 @@
 import * as React from 'react';
-import type { CalendarContextValue, CalendarDay, CalendarGridContextValue, CalendarProps, CalendarSelectionMode, CalendarValue, DateRange, RangePosition } from './types.js';
-/**
- * Month-grid date picker (WAI-ARIA `grid` pattern), built on plain native
- * `Date` math and `Intl` for names — no date-library dependency. Selects a
- * single date, an arbitrary set of dates, or a start/end range.
- */
+import type { CalendarContextValue, CalendarDay, CalendarGridContextValue, CalendarProps, CalendarSelectionMode, CalendarValue, CalendarView, DateRange, RangePosition } from './types.js';
 /** @internal Number of days in the given zero-based `month` of `year` (e.g. `getDaysInMonth(2024, 1)` → 29). */
 export declare function getDaysInMonth(year: number, month: number): number;
 /** @internal Midnight on the first day of `date`'s month, in local time. */
 export declare function startOfMonth(date: Date): Date;
 /**
- * Adds `amount` calendar months to `date` (negative to subtract), clamping the
- * day of month so it never overflows into the next month — e.g. Jan 31 + 1
- * month → Feb 28/29. Returns a new local-time `Date`.
+ * Adds `amount` calendar months to `date`, clamping the day so it never
+ * overflows into the next month — e.g. Jan 31 + 1 month → Feb 28/29.
  *
  * @param date - Base date; not mutated.
  * @param amount - Months to add; may be negative.
@@ -22,19 +16,14 @@ export declare function addMonths(date: Date, amount: number): Date;
 /** @internal Adds `amount` years to `date` via {@link addMonths} (so Feb 29 clamps to Feb 28 in non-leap years). */
 export declare function addYears(date: Date, amount: number): Date;
 /**
- * Adds `amount` days to `date` (negative to subtract), returning a new `Date`.
- * Rolls over month and year boundaries naturally.
+ * Adds `amount` days to `date`, rolling over month and year boundaries naturally.
  *
  * @param date - Base date; not mutated.
  * @param amount - Days to add; may be negative.
  * @returns A new {@link Date} `amount` days from `date`.
  */
 export declare function addDays(date: Date, amount: number): Date;
-/**
- * Whether `a` and `b` fall on the same calendar day (year, month and date),
- * ignoring the time of day. Returns `false` if either argument is `null` or
- * `undefined`.
- */
+/** Whether `a` and `b` fall on the same calendar day, ignoring time of day; `false` if either is nullish. */
 export declare function isSameDay(a: Date | null | undefined, b: Date | null | undefined): boolean;
 /** Whether `a` and `b` fall in the same calendar month of the same year. */
 export declare function isSameMonth(a: Date, b: Date): boolean;
@@ -46,27 +35,80 @@ export declare function endOfWeek(date: Date, weekStartsOn: number): Date;
 export declare function stripTime(date: Date): Date;
 /** @internal Whether `date` is out of range: before `minDate`, after `maxDate` (both compared date-only), or rejected by `disabledFn`. */
 export declare function isDateDisabled(date: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/**
+ * @internal Clamps `date` into `[minDate, maxDate]` (compared date-only), the
+ * same convention Slider and NumberField use for an out-of-bounds step —
+ * never a silent no-op, never a jump onto a natively `disabled` cell the
+ * roving tab stop could then get stuck on.
+ */
+export declare function clampToDateRange(date: Date, minDate: Date | undefined, maxDate: Date | undefined): Date;
+/** The two disabled-ness inputs a Calendar resolves. */
+export interface ResolvedCalendarDisabled {
+    /** Whether the *whole* calendar is disabled. */
+    disabled: boolean;
+    /** The per-date predicate to use. */
+    isDateDisabled?: (date: Date) => boolean;
+}
+/** @internal Resolves disabled and isDateDisabled props. */
+export declare function resolveCalendarDisabled(disabled: boolean | undefined, isDateDisabled: ((date: Date) => boolean) | undefined): ResolvedCalendarDisabled;
+/** @internal Puts {@link warnInstantDate} back to "not yet warned". Only needed by tests. */
+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.
+ *
+ * @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;
+/**
+ * ISO-8601 week number of `date` (1–53). ISO 8601 numbers from Monday and
+ * puts the first Thursday in week 1, so weeks belong to the year holding their
+ * Thursday: Jan 1 can be week 52/53 of previous year, Dec 30 can be week 1 of
+ * next. Independent of `weekStartsOn`. Uses local wall-clock time, never UTC.
+ *
+ * @param date - Any day of the week to number; not mutated
+ * @returns The ISO week number, 1–53
+ */
+export declare function getISOWeek(date: Date): number;
 /** @internal Formats `date` as a local-time `YYYY-MM-DD` string (no timezone conversion, unlike `Date.toISOString`). */
 export declare function toISODateString(date: Date): string;
 /** @internal Projects `date`'s day-of-month onto `targetMonth`, clamping to that month's last day; returns `date` unchanged if already in `targetMonth`. */
 export declare function clampToMonth(date: Date, targetMonth: Date): Date;
+/**
+ * The three views, most granular first. Every clamp, step up and step down is
+ * an index move along this one array, so `minView`/`maxView` cannot disagree
+ * with `CalendarHeading` about which direction "up" is.
+ */
+export declare const CALENDAR_VIEWS: readonly ["day", "month", "year"];
+/** How many years one page of {@link CalendarYearGrid} shows, and what its start is aligned to. */
+export declare const CALENDAR_YEAR_PAGE = 20;
+/** @internal Clamps `view` into the `[minView, maxView]` window, raising `maxView` to `minView` if a consumer inverted them. */
+export declare function clampView(view: CalendarView, minView: CalendarView, maxView: CalendarView): CalendarView;
+/** @internal First year of the twenty-year page containing `year` — 2026 falls on the 2020–2039 page. */
+export declare function yearPageStart(year: number): number;
+/**
+ * Whether any day from `from` to `to` inclusive is selectable — what makes a
+ * whole month or year cell refusable. `minDate`/`maxDate` narrow the window
+ * first, so the bounds-only case needs no predicate scan; when a predicate
+ * exists, the scan stops at the first available day.
+ */
+export declare function hasAvailableDate(from: Date, to: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/**
+ * The label for whatever page `view` shows around `date` — month, year, or
+ * year-page — so the heading, grid name, and paging announcement never disagree.
+ */
+export declare function formatViewPageLabel(date: Date, view: CalendarView, locale?: string): string;
 /** Always returns a 6x7 (weeks x weekdays) grid, including adjacent-month filler days. */
 export declare function getVisibleWeeks(month: Date, weekStartsOn?: number): CalendarDay[][];
 /** Whether `value` is a {@link DateRange} rather than a single date, a date array, or nothing. */
 export declare function isDateRange(value: CalendarValue): value is DateRange;
 /** The empty selection for `mode`: `[]` for `multiple`, `null` for `single` and `range`. */
 export declare function emptySelection(mode: CalendarSelectionMode): CalendarValue;
-/**
- * Whether `date` is part of `value` — the selected day in `single` mode, a
- * member of the array in `multiple`, or anywhere from `start` to `end`
- * inclusive in `range` (so every cell in a range carries `aria-selected`).
- */
+/** Whether `date` is part of `value` — the selected day, a member of the array, or within `start`–`end` for a range. */
 export declare function isDateSelected(value: CalendarValue, date: Date): boolean;
-/**
- * Where `date` sits in `range`: `'start'`, `'end'`, `'middle'`, or `undefined`
- * when it is outside the range. A range still being anchored (`end: null`)
- * only ever reports `'start'`.
- */
+/** Where `date` sits in `range`: `'start'`, `'end'`, `'middle'`, or `undefined` outside it; an unclosed range only reports `'start'`. */
 export declare function rangePositionOf(range: DateRange, date: Date): RangePosition | undefined;
 /**
  * The selection that results from choosing `date` while `current` is selected.
@@ -89,29 +131,24 @@ export declare const CalendarProvider: {
 }, useCalendarContextInternal: (consumerName: string) => CalendarContextValue;
 /** Read the Calendar's current selection/displayed-month state (e.g. to render a heading label). */
 export declare function useCalendarContext(): CalendarContextValue;
-/**
- * @internal Which month a given `CalendarGrid` renders. Absent for a
- * single-month calendar, where every part just reads the root's `month`.
- */
+/** @internal Which month a `CalendarGrid` renders; absent for a single-month calendar, where every part reads the root's `month`. */
 export declare const CalendarGridContext: React.Context<CalendarGridContextValue | null>;
 /** The month of the enclosing `CalendarGrid`, falling back to the root's displayed month. */
 export declare function useCalendarGridMonth(fallback: Date): Date;
+/**
+ * @internal This Calendar instance's own root element, so keyboard focus
+ * restoration can scope its cell lookup to it — a page can hold several
+ * Calendars, and a `document`-wide lookup by date would grab another one's
+ * cell for the same day.
+ */
+export declare const CalendarRootContext: React.Context<React.RefObject<HTMLElement | null> | null>;
 /** @internal The date a fresh calendar should focus and display, given whatever `value` holds. */
 export declare function anchorOf(value: CalendarValue): Date | null;
 /**
- * Root of a month-grid date picker: owns the selection, displayed month(s)
- * and roving-focus date, and hands them down to every other `Calendar*` part
- * via context. Renders a plain `<div>` — layout of the header vs. grid is
- * entirely up to your CSS.
- *
- * `selectionMode` decides what `value` holds: a `Date` (`'single'`, the
- * default), a `Date[]` (`'multiple'`), or a `{ start, end }` `DateRange`
- * (`'range'`, where `end` stays `null` until the second date closes it).
- * Month and weekday names come from `Intl` for `locale`, so nothing here
- * ships a hardcoded English name table.
- *
- * Works controlled (`value` + `onValueChange`, `month` + `onMonthChange`) or
- * uncontrolled (`defaultValue`, `defaultMonth`).
+ * Root of a month-grid date picker: owns selection, displayed month(s), and
+ * roving focus, handing them to every `Calendar*` part via context;
+ * `selectionMode` picks between a `Date`, `Date[]`, or `DateRange` for
+ * `value`, and it works controlled or uncontrolled, rendering a plain `<div>`.
  *
  * @example
  * ```tsx