@skdx/react 0.27.0 → 0.29.0

package/dist/button/Button.d.ts

@@ -1,9 +1,7 @@
 import * as React from 'react';
 import type { ButtonProps } from './types.js';
 /**
- * Headless `<button>`. Defaults `type` to `"button"` (so it doesn't
- * accidentally submit a form), disables itself while `loading`, and sets
- * `aria-busy` plus `data-disabled` / `data-loading` hooks for theming.
+ * Headless `<button>` that defaults `type` to `"button"`, soft-disables while loading, and sets `aria-busy` plus `data-disabled` / `data-loading` for styling.
  *
  * @example
  * ```tsx
@@ -12,4 +10,7 @@ import type { ButtonProps } from './types.js';
  * </Button>
  * ```
  */
-export declare const Button: React.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const Button: {
+    ({ loading, loadingLabel, disabled, focusableWhenDisabled, type, as, onClick, ref: forwardedRef, iconOnly, size, status, variant, ...props }: ButtonProps): React.ReactNode;
+    displayName: string;
+};

package/dist/button/Button.js

@@ -1 +1,2 @@
-import*as r from"react";import{skdxPart as p}from"../utils/part.js";import{Primitive as m}from"../utils/primitive.js";import{jsx as f}from"react/jsx-runtime";var d=r.forwardRef(({loading:t,disabled:o,type:n="button",...e},a)=>f(m.button,{type:n,disabled:o||t,"aria-busy":t||void 0,"data-disabled":o?"":void 0,"data-loading":t?"":void 0,...e,...p("button","root",e.className),ref:a}));d.displayName="Button";export{d as Button};
+'use client';
+import*as p from"react";import{appearanceAttrs as k}from"../utils/appearance.js";import{skdxPart as E}from"../utils/part.js";import{Primitive as H}from"../utils/primitive.js";import{VisuallyHidden as I}from"../utils/visuallyHidden.js";import{Fragment as C,jsx as m,jsxs as M}from"react/jsx-runtime";function L(t,e,n,r){let o=e&&n||t&&!e,i=t&&!e,a=e&&!n,d=a&&!r;return{busy:i,nativelyDisabled:a,hardDisabledOffButton:d,inert:o||d}}function N(t,e,n,r){let o;return n&&r?o=0:t.hardDisabledOffButton&&(o=-1),{"aria-disabled":t.inert||void 0,"aria-busy":t.busy||void 0,tabIndex:o,"data-disabled":n||e?"":void 0,"data-loading":e?"":void 0}}var A=({loading:t=!1,loadingLabel:e="Loading",disabled:n=!1,focusableWhenDisabled:r=!1,type:o="button",as:i="button",onClick:a,ref:d,iconOnly:c,size:y,status:B,variant:v,...u})=>{let s=i==="button",f=L(t,n,r,s),P=f.inert,b=p.useId(),R=[u["aria-describedby"],t?b:void 0].filter(Boolean).join(" ")||void 0,x=l=>{if(P){l.preventDefault(),l.stopPropagation();return}a?.(l)},D=H[i];return M(C,{children:[m(D,{type:s?o:void 0,disabled:s?f.nativelyDisabled:void 0,...N(f,t,n,r),...u,"aria-describedby":R,onClick:x,...k({iconOnly:c,size:y,status:B,variant:v},u),...E("button","root",u.className),ref:d}),t?m(I,{id:b,children:e}):null]})};A.displayName="Button";export{A as Button};

package/dist/button/types.d.cts

@@ -1,9 +1,56 @@
-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, extending the native `<button>` attributes.
+ */
+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>`, taken from the library's tag allowlist.
+     * @default 'button'
+     */
+    as?: PolymorphicTag | undefined;
+    /**
+     * Marks the button busy, setting `aria-busy` and `data-loading`/`data-disabled` while suppressing activation without removing native `disabled`.
+     * @default false
+     */
+    loading?: boolean | undefined;
+    /**
+     * Describes what is in progress while `loading` is true, rendered as a visually-hidden node referenced by `aria-describedby`.
+     * @default 'Loading'
+     */
+    loadingLabel?: string | undefined;
+    /**
+     * Native disabled state, set as the native `disabled` attribute; outranks `loading` when both are set.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Keeps a `disabled` button in the tab order, emitting `aria-disabled` and `tabindex="0"` instead of the native attribute.
      * @default false
      */
-    loading?: boolean;
+    focusableWhenDisabled?: boolean | undefined;
+    /**
+     * Native button type, defaulting to `'button'` so it never accidentally submits an enclosing form.
+     * @default 'button'
+     */
+    type?: 'button' | 'submit' | 'reset' | undefined;
+    /**
+     * Renders the skin square icon-only button, mirrored as a bare `data-icon-only`.
+     * @default undefined — a normal label-and-padding button.
+     */
+    iconOnly?: boolean | undefined;
+    /**
+     * Size rung the skin scales the button by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
+    /**
+     * Severity rung the skin colours the button by, mirrored to `data-status`.
+     * @default undefined — the skin's own neutral styling.
+     */
+    status?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'danger' | (string & {}) | undefined;
+    /**
+     * Visual weight rung the skin gives the button, mirrored to `data-variant`.
+     * @default undefined — the skin's own default weight.
+     */
+    variant?: 'secondary' | 'primary' | 'danger' | 'outline' | 'ghost' | (string & {}) | undefined;
 }

package/dist/button/types.d.ts

@@ -1,9 +1,56 @@
-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, extending the native `<button>` attributes.
+ */
+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>`, taken from the library's tag allowlist.
+     * @default 'button'
+     */
+    as?: PolymorphicTag | undefined;
+    /**
+     * Marks the button busy, setting `aria-busy` and `data-loading`/`data-disabled` while suppressing activation without removing native `disabled`.
+     * @default false
+     */
+    loading?: boolean | undefined;
+    /**
+     * Describes what is in progress while `loading` is true, rendered as a visually-hidden node referenced by `aria-describedby`.
+     * @default 'Loading'
+     */
+    loadingLabel?: string | undefined;
+    /**
+     * Native disabled state, set as the native `disabled` attribute; outranks `loading` when both are set.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Keeps a `disabled` button in the tab order, emitting `aria-disabled` and `tabindex="0"` instead of the native attribute.
      * @default false
      */
-    loading?: boolean;
+    focusableWhenDisabled?: boolean | undefined;
+    /**
+     * Native button type, defaulting to `'button'` so it never accidentally submits an enclosing form.
+     * @default 'button'
+     */
+    type?: 'button' | 'submit' | 'reset' | undefined;
+    /**
+     * Renders the skin square icon-only button, mirrored as a bare `data-icon-only`.
+     * @default undefined — a normal label-and-padding button.
+     */
+    iconOnly?: boolean | undefined;
+    /**
+     * Size rung the skin scales the button by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'md' | 'sm' | 'lg' | (string & {}) | undefined;
+    /**
+     * Severity rung the skin colours the button by, mirrored to `data-status`.
+     * @default undefined — the skin's own neutral styling.
+     */
+    status?: 'neutral' | 'brand' | 'info' | 'success' | 'warning' | 'danger' | (string & {}) | undefined;
+    /**
+     * Visual weight rung the skin gives the button, mirrored to `data-variant`.
+     * @default undefined — the skin's own default weight.
+     */
+    variant?: 'secondary' | 'primary' | 'danger' | 'outline' | 'ghost' | (string & {}) | undefined;
 }

package/dist/calendar/Calendar.cjs

@@ -1 +1,2 @@
-"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 client';
+"use strict";var Ma=Object.create;var Re=Object.defineProperty;var Na=Object.getOwnPropertyDescriptor;var Sa=Object.getOwnPropertyNames;var Ta=Object.getPrototypeOf,Va=Object.prototype.hasOwnProperty;var Aa=(e,t)=>{for(var n in t)Re(e,n,{get:t[n],enumerable:!0})},bt=(e,t,n,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of Sa(t))!Va.call(e,r)&&r!==n&&Re(e,r,{get:()=>t[r],enumerable:!(a=Na(t,r))||a.enumerable});return e};var Pe=(e,t,n)=>(n=e!=null?Ma(Ta(e)):{},bt(t||!e||!e.__esModule?Re(n,"default",{value:e,enumerable:!0}):n,e)),Ga=e=>bt(Re({},"__esModule",{value:!0}),e);var La={};Aa(La,{CALENDAR_VIEWS:()=>M,CALENDAR_YEAR_PAGE:()=>Q,Calendar:()=>pa,CalendarCell:()=>Fe,CalendarGrid:()=>Te,CalendarGridBody:()=>He,CalendarGridContext:()=>Ae,CalendarGridHead:()=>Le,CalendarHeader:()=>Ie,CalendarHeading:()=>Ce,CalendarMonthGrid:()=>Je,CalendarNextButton:()=>Be,CalendarPreviousButton:()=>$e,CalendarProvider:()=>fa,CalendarRootContext:()=>ae,CalendarRow:()=>ne,CalendarWeekDay:()=>Ee,CalendarWeekNumber:()=>Ye,CalendarWeekNumberHeader:()=>We,CalendarYearGrid:()=>Xe,addDays:()=>F,addMonths:()=>N,addYears:()=>ke,anchorOf:()=>_,clampToDateRange:()=>Ve,clampToMonth:()=>Qe,clampView:()=>ft,clearLocaleNameCache:()=>y.clearLocaleNameCache,emptySelection:()=>pt,endOfWeek:()=>nt,formatDateLabel:()=>y.formatDateLabel,formatMonthLabel:()=>y.formatMonthLabel,formatViewPageLabel:()=>Y,formatYear:()=>y.formatYear,formatYearRange:()=>y.formatYearRange,getDaysInMonth:()=>he,getISOWeek:()=>it,getLocaleWeekStartsOn:()=>y.getLocaleWeekStartsOn,getMonthNames:()=>y.getMonthNames,getVisibleWeeks:()=>dt,getWeekDayNames:()=>y.getWeekDayNames,hasAvailableDate:()=>ut,isDateDisabled:()=>rt,isDateRange:()=>J,isDateSelected:()=>ot,isSameDay:()=>K,isSameMonth:()=>V,nextSelection:()=>ua,rangePositionOf:()=>Oe,resetInstantDateWarning:()=>Ha,resolveCalendarDisabled:()=>la,resolveLocale:()=>y.resolveLocale,selectionAnnouncement:()=>ma,startOfMonth:()=>O,startOfWeek:()=>ue,stripTime:()=>p,toISODateString:()=>me,useCalendarContext:()=>Ea,useCalendarContextInternal:()=>f,useCalendarGridMonth:()=>fe,warnInstantDate:()=>ca,yearPageStart:()=>Ze});module.exports=Ga(La);var s=Pe(require("react"),1),R=require("../utils/calendar-locale.cjs"),ra=require("../utils/composeRefs.cjs"),oa=require("../utils/createContext.cjs"),S=require("../utils/date-value.cjs"),ia=require("../utils/dev-mode.cjs"),je=require("../utils/liveAnnouncer.cjs"),da=require("../utils/part.cjs"),sa=require("../utils/primitive.cjs"),ge=require("../utils/useControllableState.cjs");var ta=Pe(require("react"),1),aa=require("../utils/Glyph.cjs");var Me=Pe(require("react"),1),xt=require("../utils/calendar-locale.cjs"),Ne=require("../utils/direction.cjs"),wt=require("../utils/part.cjs"),Se=require("../utils/primitive.cjs");var at=require("react/jsx-runtime"),Te=({monthOffset:e=0,ref:t,...n})=>{let a=f("CalendarGrid"),r=(0,Ne.useDirection)(),o=a.months[e]??a.month,d=Me.useMemo(()=>({gridMonth:o}),[o]),i=Me.useContext(ae),c=D=>{let l=Ve(D,a.minDate,a.maxDate);a.months.some(v=>V(l,v))||a.onMonthChange(O(l)),a.setFocusedDate(l),requestAnimationFrame(()=>{let v=me(l);(i?.current??document).querySelector(`[data-skdx-calendar-cell="${v}"]:not([disabled])`)?.focus()})},b=D=>{let l;switch((0,Ne.directionalKey)(D.key,D.currentTarget,r)){case"ArrowLeft":l=F(a.focusedDate,-1);break;case"ArrowRight":l=F(a.focusedDate,1);break;case"ArrowUp":l=F(a.focusedDate,-7);break;case"ArrowDown":l=F(a.focusedDate,7);break;case"Home":l=ue(a.focusedDate,a.weekStartsOn);break;case"End":l=nt(a.focusedDate,a.weekStartsOn);break;case"PageUp":l=D.shiftKey?ke(a.focusedDate,-1):N(a.focusedDate,-1);break;case"PageDown":l=D.shiftKey?ke(a.focusedDate,1):N(a.focusedDate,1);break;default:return}D.preventDefault(),c(l)},w=(0,Se.useComposedEventHandlers)(n.onKeyDown,b);return a.view!=="day"?null:(0,at.jsx)(Ae.Provider,{value:d,children:(0,at.jsx)(Se.Primitive.div,{role:"grid","aria-label":n["aria-label"]||n["aria-labelledby"]?void 0:(0,xt.formatMonthLabel)(o,a.locale),"aria-multiselectable":a.selectionMode!=="single","aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...n,...(0,wt.skdxPart)("calendar","grid",n.className),ref:t,onKeyDown:w})})};Te.displayName="CalendarGrid";var Ft=require("../utils/part.cjs"),Ot=require("../utils/primitive.cjs");var vt=require("../utils/calendar-locale.cjs"),Rt=require("../utils/date-value.cjs"),Pt=require("../utils/part.cjs"),Ge=require("../utils/primitive.cjs");var kt=require("react/jsx-runtime");function Fa(e){return{"aria-selected":e.isSelected,"aria-disabled":e.isUnavailable||void 0,"aria-current":e.isToday?"date":void 0,"data-state":e.isSelected?"selected":void 0,"data-today":e.isToday?"":void 0,"data-outside-month":e.isOutsideMonth?"":void 0,"data-disabled":e.isDisabled?"":void 0,"data-unavailable":e.isUnavailable?"":void 0,"data-range-start":e.rangePosition==="start"?"":void 0,"data-range-middle":e.rangePosition==="middle"?"":void 0,"data-range-end":e.rangePosition==="end"?"":void 0,tabIndex:e.isFocused?0:-1}}var Fe=({date:e,ref:t,...n})=>{let a=f("CalendarCell"),r=fe(a.month),o=(0,Rt.toDate)(e,"date")??r,d=me(o),i=!V(o,r),c=a.disabled||i&&!a.outsideDaySelectable||rt(o,a.minDate,a.maxDate,a.isDateDisabled),b=!c&&(a.isDateUnavailable?.(o)??!1),w=ot(a.value,o),D=J(a.value)?Oe(a.value,o):void 0,l=K(o,a.today),v=K(o,a.focusedDate);return(0,kt.jsx)(Ge.Primitive.button,{type:"button",role:"gridcell","aria-label":(0,vt.formatDateLabel)(o,a.locale),"data-skdx-calendar-cell":d,...Fa({isSelected:w,isToday:l,isOutsideMonth:i,isDisabled:c,isUnavailable:b,isFocused:v,rangePosition:D}),disabled:c,...n,...(0,Pt.skdxPart)("calendar","cell",n.className),ref:t,onClick:(0,Ge.composeEventHandlers)(n.onClick,()=>{if(!c){if(b){a.setFocusedDate(o);return}a.onValueChange(o),a.setFocusedDate(o),i&&!a.months.some(E=>V(o,E))&&a.onMonthChange(o)}}),children:n.children??o.getDate()})};Fe.displayName="CalendarCell";var Mt=require("../utils/part.cjs"),Nt=require("../utils/primitive.cjs"),St=require("react/jsx-runtime"),ne=({ref:e,...t})=>(0,St.jsx)(Nt.Primitive.div,{role:"row",...t,...(0,Mt.skdxPart)("calendar","row",t.className),ref:e});ne.displayName="CalendarRow";var Tt=require("../utils/date-value.cjs"),Vt=require("../utils/part.cjs"),At=require("../utils/primitive.cjs");var Gt=require("react/jsx-runtime"),Ye=({date:e,children:t,ref:n,...a})=>{let r=f("CalendarWeekNumber"),o=(0,Tt.toDate)(e,"date")??r.month,d=it(o);return(0,Gt.jsx)(At.Primitive.div,{role:"rowheader","aria-label":`Week ${d}`,...a,...(0,Vt.skdxPart)("calendar","week-number",a.className),ref:n,children:t??d})};Ye.displayName="CalendarWeekNumber";var re=require("react/jsx-runtime"),He=({children:e,ref:t,...n})=>{let a=f("CalendarGridBody"),r=fe(a.month),o=dt(r,a.weekStartsOn);return(0,re.jsx)(Ot.Primitive.div,{role:"rowgroup",...n,...(0,Ft.skdxPart)("calendar","grid-body",n.className),ref:t,children:e??o.map(d=>(0,re.jsxs)(ne,{children:[a.weekNumbers?(0,re.jsx)(Ye,{date:d[0].date}):null,d.map(({date:i})=>(0,re.jsx)(Fe,{date:i},i.toISOString()))]},d[0].date.toISOString()))})};He.displayName="CalendarGridBody";var Ut=require("../utils/part.cjs"),Bt=require("../utils/primitive.cjs");var Yt=require("../utils/part.cjs"),Ht=require("../utils/primitive.cjs"),Et=require("react/jsx-runtime"),Ee=({ref:e,...t})=>(0,Et.jsx)(Ht.Primitive.div,{role:"columnheader",...t,...(0,Yt.skdxPart)("calendar","week-day",t.className),ref:e});Ee.displayName="CalendarWeekDay";var Wt=require("../utils/part.cjs"),Lt=require("../utils/primitive.cjs"),It=require("react/jsx-runtime"),We=({ref:e,...t})=>(0,It.jsx)(Lt.Primitive.div,{role:"columnheader","aria-label":"Week number",...t,...(0,Wt.skdxPart)("calendar","week-number-header",t.className),ref:e});We.displayName="CalendarWeekNumberHeader";var oe=require("react/jsx-runtime"),Le=({children:e,ref:t,...n})=>{let a=f("CalendarGridHead");return(0,oe.jsx)(Bt.Primitive.div,{role:"rowgroup",...n,...(0,Ut.skdxPart)("calendar","grid-head",n.className),ref:t,children:e??(0,oe.jsxs)(ne,{children:[a.weekNumbers?(0,oe.jsx)(We,{}):null,a.weekDayNames.map(r=>(0,oe.jsx)(Ee,{"aria-label":r.long,children:r.short},r.long))]})})};Le.displayName="CalendarGridHead";var Kt=require("../utils/part.cjs"),$t=require("../utils/primitive.cjs"),_t=require("react/jsx-runtime"),Ie=({ref:e,...t})=>(0,_t.jsx)($t.Primitive.div,{...t,...(0,Kt.skdxPart)("calendar","header",t.className),ref:e});Ie.displayName="CalendarHeader";var st=require("../utils/part.cjs"),pe=require("../utils/primitive.cjs");var lt=require("react/jsx-runtime"),Ce=({monthOffset:e=0,children:t,ref:n,...a})=>{let r=f("CalendarHeading"),o=r.months[e]??r.month,d=r.view==="day"?o:r.focusedDate,i=Y(d,r.view,r.locale),c=M[M.indexOf(r.view)+1];return c!==void 0&&M.indexOf(r.view)<M.indexOf(r.maxView)?(0,lt.jsx)(pe.Primitive.button,{type:"button",...a,...(0,st.skdxPart)("calendar","heading",a.className),ref:n,onClick:(0,pe.composeEventHandlers)(a.onClick,()=>r.setView(c)),children:t??i}):(0,lt.jsx)(pe.Primitive.div,{...a,...(0,st.skdxPart)("calendar","heading",a.className),ref:n,children:t??i})};Ce.displayName="CalendarHeading";var qt=require("../utils/part.cjs"),Ue=require("../utils/primitive.cjs");var zt=require("react/jsx-runtime"),Oa={day:"Next month",month:"Next year",year:"Next 20 years"},Be=({ref:e,...t})=>{let n=f("CalendarNextButton");return(0,zt.jsx)(Ue.Primitive.button,{type:"button","aria-label":Oa[n.view],...t,...(0,qt.skdxPart)("calendar","next-button",t.className),ref:e,onClick:(0,Ue.composeEventHandlers)(t.onClick,()=>n.pageMonths(1))})};Be.displayName="CalendarNextButton";var Jt=require("../utils/part.cjs"),Ke=require("../utils/primitive.cjs");var Xt=require("react/jsx-runtime"),Ya={day:"Previous month",month:"Previous year",year:"Previous 20 years"},$e=({ref:e,...t})=>{let n=f("CalendarPreviousButton");return(0,Xt.jsx)(Ke.Primitive.button,{type:"button","aria-label":Ya[n.view],...t,...(0,Jt.skdxPart)("calendar","previous-button",t.className),ref:e,onClick:(0,Ke.composeEventHandlers)(t.onClick,()=>n.pageMonths(-1))})};$e.displayName="CalendarPreviousButton";var _e=Pe(require("react"),1),X=require("../utils/calendar-locale.cjs"),qe=require("../utils/direction.cjs"),Qt=require("../utils/liveAnnouncer.cjs"),ze=require("../utils/part.cjs"),H=require("../utils/primitive.cjs");var $=require("react/jsx-runtime");function ct(){return 4}function Zt(e,t){let n=f(t),a=_e.useContext(ae),r=(0,qe.useDirection)(),o=e,d=e==="month"?1:12,i=e==="month"?12:Q,c=n.focusedDate,b=e==="month"?c.getMonth():c.getFullYear()-Ze(c.getFullYear()),{locale:w,minDate:D,maxDate:l,isDateDisabled:v,today:E,value:W}=n,P=_(W),q=_e.useMemo(()=>{let g=(0,X.getMonthNames)(w,"short"),u=c.getFullYear();return Array.from({length:i},(Z,C)=>{let A=e==="month"?Qe(c,new Date(u,C,1)):N(c,(C-b)*d),x=e==="month"?u:A.getFullYear(),ie=e==="month"?new Date(x,C,1):new Date(x,0,1),de=e==="month"?new Date(x,C,he(x,C)):new Date(x,11,31),L=T=>T!==null&&T.getFullYear()===x&&(e==="year"||T.getMonth()===C);return{date:A,key:e==="month"?`${x}-${C}`:String(x),text:e==="month"?g[C]:(0,X.formatYear)(x,w),label:e==="month"?(0,X.formatMonthLabel)(new Date(x,C,1),w):(0,X.formatYear)(x,w),refused:!ut(ie,de,D,l,v),selected:L(P),today:L(E)}})},[e,i,d,c,b,w,D,l,v,P,E]),z=g=>{let u=N(c,g*d),Z=Y(c,o,w),C=Y(u,o,w);n.setFocusedDate(u),C!==Z&&(0,Qt.announce)(C),requestAnimationFrame(()=>{let A=e==="month"?`${u.getFullYear()}-${u.getMonth()}`:String(u.getFullYear());(a?.current??document).querySelector(`[data-skdx-calendar-view-cell="${A}"]`)?.focus({preventScroll:!0})})};return{context:n,cells:q,focusedIndex:b,handleKeyDown:g=>{let u;switch((0,qe.directionalKey)(g.key,g.currentTarget,r)){case"ArrowLeft":u=-1;break;case"ArrowRight":u=1;break;case"ArrowUp":u=-ct();break;case"ArrowDown":u=ct();break;case"Home":u=-b;break;case"End":u=i-1-b;break;case"PageUp":u=-i*(g.shiftKey?10:1);break;case"PageDown":u=i*(g.shiftKey?10:1);break;default:return}g.preventDefault(),u!==0&&z(u)}}}function jt({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)(H.Primitive.div,{role:"rowgroup",children:a.map((o,d)=>(0,$.jsx)(H.Primitive.div,{role:"row",children:o.map((i,c)=>{let b=d*r+c;return(0,$.jsx)(H.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:b===t?0:-1,...(0,ze.skdxPart)("calendar","view-cell"),onClick:()=>{i.refused||n(i.date)},children:i.text},i.key)})},o[0].key))})}var Je=({children:e,ref:t,...n})=>{let{context:a,cells:r,focusedIndex:o,handleKeyDown:d}=Zt("month","CalendarMonthGrid");return a.view!=="month"?null:(0,$.jsx)(H.Primitive.div,{role:"grid","aria-label":n["aria-label"]||n["aria-labelledby"]?void 0:Y(a.focusedDate,"month",a.locale),"aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...n,...(0,ze.skdxPart)("calendar","month-grid",n.className),ref:t,onKeyDown:(0,H.composeEventHandlers)(n.onKeyDown,d),children:e??(0,$.jsx)(jt,{cells:r,focusedIndex:o,navigate:a.navigateToUnit})})};Je.displayName="CalendarMonthGrid";var Xe=({children:e,ref:t,...n})=>{let{context:a,cells:r,focusedIndex:o,handleKeyDown:d}=Zt("year","CalendarYearGrid");return a.view!=="year"?null:(0,$.jsx)(H.Primitive.div,{role:"grid","aria-label":n["aria-label"]||n["aria-labelledby"]?void 0:Y(a.focusedDate,"year",a.locale),"aria-readonly":a.readOnly||void 0,"aria-disabled":a.disabled||void 0,...n,...(0,ze.skdxPart)("calendar","year-grid",n.className),ref:t,onKeyDown:(0,H.composeEventHandlers)(n.onKeyDown,d),children:e??(0,$.jsx)(jt,{cells:r,focusedIndex:o,navigate:a.navigateToUnit})})};Xe.displayName="CalendarYearGrid";var h=require("react/jsx-runtime"),ea=({dir:e})=>(0,h.jsx)(aa.Glyph,{name:e==="left"?"chevron-left":"chevron-right"}),na=()=>{let{months:e}=f("CalendarAnatomy"),t=e.length>1;return(0,h.jsxs)(h.Fragment,{children:[(0,h.jsxs)(Ie,{children:[(0,h.jsx)($e,{children:(0,h.jsx)(ea,{dir:"left"})}),t?null:(0,h.jsx)(Ce,{}),(0,h.jsx)(Be,{children:(0,h.jsx)(ea,{dir:"right"})})]}),e.map((n,a)=>(0,h.jsxs)(ta.Fragment,{children:[t?(0,h.jsx)(Ce,{monthOffset:a}):null,(0,h.jsxs)(Te,{monthOffset:a,children:[(0,h.jsx)(Le,{}),(0,h.jsx)(He,{})]})]},n.toISOString())),(0,h.jsx)(Je,{}),(0,h.jsx)(Xe,{})]})};var De=require("react/jsx-runtime");function he(e,t){return new Date(e,t+1,0).getDate()}function O(e){return new Date(e.getFullYear(),e.getMonth(),1)}function N(e,t){let n=e.getDate(),a=new Date(e.getFullYear(),e.getMonth(),1);a.setMonth(a.getMonth()+t);let r=he(a.getFullYear(),a.getMonth());return a.setDate(Math.min(n,r)),a}function ke(e,t){return N(e,t*12)}function F(e,t){let n=new Date(e);return n.setDate(n.getDate()+t),n}function K(e,t){return!e||!t?!1:e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()&&e.getDate()===t.getDate()}function V(e,t){return e.getFullYear()===t.getFullYear()&&e.getMonth()===t.getMonth()}function ue(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 nt(e,t){return F(ue(e,t),6)}function p(e){return new Date(e.getFullYear(),e.getMonth(),e.getDate())}function rt(e,t,n,a){let r=p(e).getTime();return!!(t&&r<p(t).getTime()||n&&r>p(n).getTime()||a?.(e))}function Ve(e,t,n){return t&&p(e).getTime()<p(t).getTime()?t:n&&p(e).getTime()>p(n).getTime()?n:e}function la(e,t){return{disabled:e??!1,isDateDisabled:t}}var mt=!1;function Ha(){mt=!1}function ca(e,t){!e||mt||!(e.getUTCHours()===0&&e.getUTCMinutes()===0&&e.getUTCSeconds()===0&&e.getUTCMilliseconds()===0)||e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(mt=!0,(0,ia.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 it(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 me(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 Qe(e,t){if(V(e,t))return e;let n=he(t.getFullYear(),t.getMonth());return new Date(t.getFullYear(),t.getMonth(),Math.min(e.getDate(),n))}var M=["day","month","year"],Q=20;function ft(e,t,n){let a=M.indexOf(t),r=Math.max(a,M.indexOf(n));return M[Math.min(Math.max(M.indexOf(e),a),r)]}function Ze(e){return Math.floor(e/Q)*Q}function ut(e,t,n,a,r){let o=n&&p(n)>p(e)?p(n):p(e),d=a&&p(a)<p(t)?p(a):p(t);if(o.getTime()>d.getTime())return!1;if(!r)return!0;for(let i=o;i.getTime()<=d.getTime();i=F(i,1))if(!r(i))return!0;return!1}function Y(e,t,n){if(t==="day")return(0,R.formatMonthLabel)(e,n);if(t==="month")return(0,R.formatYear)(e.getFullYear(),n);let a=Ze(e.getFullYear());return(0,R.formatYearRange)(a,a+Q-1,n)}function dt(e,t=0){let n=ue(O(e),t),a=[],r=n;for(let o=0;o<6;o++){let d=[];for(let i=0;i<7;i++)d.push({date:r,outsideMonth:!V(r,e)}),r=F(r,1);a.push(d)}return a}function J(e){return e!==null&&!Array.isArray(e)&&!(e instanceof Date)}function pt(e){return e==="multiple"?[]:null}function ot(e,t){return e===null?!1:Array.isArray(e)?e.some(n=>K(n,t)):J(e)?Oe(e,t)!==void 0:K(e,t)}function Oe(e,t){let n=p(t).getTime(),a=p(e.start).getTime();if(e.end===null)return n===a?"start":void 0;let r=p(e.end).getTime();if(!(n<a||n>r))return n===a?"start":n===r?"end":"middle"}function ua(e,t,n){if(e==="single")return n;if(e==="multiple"){let r=Array.isArray(t)?t:[],o=r.filter(d=>!K(d,n));return o.length!==r.length?o:[...r,n].sort((d,i)=>d.getTime()-i.getTime())}let a=J(t)&&t.end===null?t:void 0;return a?p(n).getTime()<p(a.start).getTime()?{start:n,end:a.start}:{start:a.start,end:n}:{start:n,end:null}}function ma(e,t){return J(e)?e.end===null?`${(0,R.formatDateLabel)(e.start,t)} selected as the range start. Select an end date.`:`Range selected, ${(0,R.formatDateLabel)(e.start,t)} to ${(0,R.formatDateLabel)(e.end,t)}.`:Array.isArray(e)?`${e.length} ${e.length===1?"date":"dates"} selected.`:""}var[fa,f]=(0,oa.createSafeContext)("Calendar");function Ea(){return f("useCalendarContext")}var Ae=s.createContext(null);function fe(e){return s.useContext(Ae)?.gridMonth??e}var ae=s.createContext(null);function _(e){return e===null?null:Array.isArray(e)?e[0]??null:J(e)?e.start:e}function Wa({selectionMode:e,value:t,defaultValue:n,onValueChange:a,month:r,defaultMonth:o,onMonthChange:d,focusedDate:i,defaultFocusedDate:c,onFocusChange:b,minDate:w,maxDate:D,today:l}){let v=s.useMemo(()=>(0,S.toCalendarValue)(t,e,"value"),[t,e]),E=s.useMemo(()=>(0,S.toCalendarValue)(n,e,"defaultValue"),[n,e]),W=s.useMemo(()=>(0,S.toDate)(r,"month")??void 0,[r]),P=s.useMemo(()=>(0,S.toDate)(o,"defaultMonth")??void 0,[o]),q=s.useMemo(()=>(0,S.toDate)(w,"minDate")??void 0,[w]),z=s.useMemo(()=>(0,S.toDate)(D,"maxDate")??void 0,[D]),ye=s.useMemo(()=>(0,S.toDate)(l,"today")??void 0,[l]),[g=null,u]=(0,ge.useControllableState)({prop:v,defaultProp:E??pt(e),onChange:j=>a?.(j??pt(e))}),[Z]=s.useState(()=>new Date),C=ye??Z;ca(_(g),"value");let A=O(P??_(g)??C),[x=A,ie]=(0,ge.useControllableState)({prop:W,defaultProp:A,onChange:d}),de=s.useMemo(()=>(0,S.toDate)(i,"focusedDate")??void 0,[i]),L=s.useMemo(()=>(0,S.toDate)(c,"defaultFocusedDate")??void 0,[c]),[T=L??_(g)??x,be]=(0,ge.useControllableState)({prop:de,defaultProp:L??_(g)??x,onChange:b}),et=s.useCallback(j=>{let ee=Ve(j,q,z);K(ee,T)||be(ee)},[T,be,q,z]);return{value:g,setValue:u,month:x,setMonth:ie,today:C,minDate:q,maxDate:z,focusedDate:T,moveFocus:et}}var pa=({selectionMode:e="single",value:t,defaultValue:n,onValueChange:a,month:r,defaultMonth:o,onMonthChange:d,focusedDate:i,defaultFocusedDate:c,onFocusChange:b,view:w,defaultView:D="day",minView:l="day",maxView:v="year",onViewChange:E,numberOfMonths:W=1,locale:P,minDate:q,maxDate:z,weekStartsOn:ye,pageBehavior:g="visible",weekNumbers:u=!1,today:Z,readOnly:C=!1,disabled:A,outsideDaySelectable:x=!1,isDateDisabled:ie,isDateUnavailable:de,getSelectionAnnouncement:L,getMonthAnnouncement:T,children:be,ref:et,...j})=>{let{disabled:ee,isDateDisabled:Ca}=la(A,ie),Ct=s.useRef(null),ha=(0,ra.useComposedRefs)(et,Ct),{value:se,setValue:ht,month:le,setMonth:I,today:Da,minDate:ga,maxDate:ya,focusedDate:xe,moveFocus:U}=Wa({selectionMode:e,value:t,defaultValue:n,onValueChange:a,month:r,defaultMonth:o,onMonthChange:d,focusedDate:i,defaultFocusedDate:c,onFocusChange:b,minDate:q,maxDate:z,today:Z}),[ba=D,Dt]=(0,ge.useControllableState)({prop:w,defaultProp:D,onChange:E}),G=ft(ba,l,v),tt=s.useCallback(m=>{let k=ft(m,l,v);k!==G&&Dt(k)},[G,l,v,Dt]),we=ye??(0,R.getLocaleWeekStartsOn)(P),xa=s.useMemo(()=>{let m=(0,R.getWeekDayNames)(P,we,"short"),k=(0,R.getWeekDayNames)(P,we,"long");return m.map((B,ve)=>({short:B,long:k[ve]}))},[P,we]),ce=s.useMemo(()=>Array.from({length:Math.max(1,W)},(m,k)=>N(le,k)),[le,W]),wa=s.useCallback(m=>{if(C||ee)return;let k=ua(e,se,m);ht(k);let B=(L??ma)(k,P);B&&(0,je.announce)(B)},[C,ee,e,se,ht,P,L]),va=s.useCallback(m=>I(O(m)),[I]),Ra=s.useCallback(m=>{if(G!=="day"){let ka=G==="month"?12:12*Q,yt=N(xe,m*ka);U(yt),(0,je.announce)(Y(yt,G,P));return}let k=g==="single"?1:Math.max(1,W),B=N(le,m*k);I(O(B)),U(Qe(xe,B));let ve=(T??R.formatMonthLabel)(B,P);ve&&(0,je.announce)(ve)},[G,g,W,le,I,xe,U,T,P]),Pa=s.useCallback(m=>{U(m),ce.some(k=>V(m,k))||I(O(m)),tt(M[M.indexOf(G)-1]??"day")},[U,ce,I,tt,G]),te=s.useMemo(()=>{let m=_(se);return m?p(m).getTime():null},[se]),gt=s.useRef(te);return s.useEffect(()=>{if(te===null||te===gt.current)return;gt.current=te;let m=new Date(te);ce.some(k=>V(m,k))||(U(m),I(O(m)))},[te,ce,I,U]),(0,De.jsx)(fa,{value:se,selectionMode:e,month:le,months:ce,focusedDate:xe,today:Da,weekStartsOn:we,weekNumbers:u,locale:P,weekDayNames:xa,minDate:ga,maxDate:ya,readOnly:C,disabled:ee,outsideDaySelectable:x,isDateDisabled:Ca,isDateUnavailable:de,onValueChange:wa,onMonthChange:va,pageMonths:Ra,setFocusedDate:U,view:G,minView:l,maxView:v,setView:tt,navigateToUnit:Pa,children:(0,De.jsx)(sa.Primitive.div,{...j,...(0,da.skdxPart)("calendar","root",j.className),ref:ha,children:(0,De.jsx)(ae.Provider,{value:Ct,children:be??(0,De.jsx)(na,{})})})})};pa.displayName="Calendar";var y=require("../utils/calendar-locale.cjs");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.
- */
-/** @internal Number of days in the given zero-based `month` of `year` (e.g. `getDaysInMonth(2024, 1)` → 29). */
+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`. */
 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,72 +35,86 @@ 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) | undefined;
+}
+/** @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". */
+export declare function resetInstantDateWarning(): void;
+/**
+ * Warns 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.
+ *
+ * @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 (1–53) of `date`, independent of `weekStartsOn` and using local wall-clock time.
+ *
+ * @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 calendar views, most granular first — every `minView`/`maxView` clamp is an index move along this array. */
+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. */
+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.
- *
- * - `single` — just `date`.
- * - `multiple` — `date` toggled into/out of the array, kept chronological.
- * - `range` — anchors a new range (`{ start: date, end: null }`) when nothing
- *   is anchored or the previous range was already complete, otherwise closes
- *   the anchored range, ordering `start`/`end` so a backwards drag still
- *   yields `start <= end`.
- */
+/** The selection that results from choosing `date` while `current` is selected: replaces for `single`, toggles for `multiple`, and anchors or closes a range for `range`. */
 export declare function nextSelection(mode: CalendarSelectionMode, current: CalendarValue, date: Date): CalendarValue;
 /** @internal The live-region message for a selection change, or `''` when there is nothing worth announcing. */
 export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
-export declare const CalendarProvider: {
-    (props: CalendarContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useCalendarContextInternal: (consumerName: string) => CalendarContextValue;
+export declare const CalendarProvider: React.FC<CalendarContextValue & {
+    children: React.ReactNode;
+}>, 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, scoping keyboard focus restoration's cell lookup to it. */
+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 that owns selection, displayed month(s), and roving focus, handing them to every `Calendar*` part via context.
  *
  * @example
  * ```tsx
@@ -136,4 +139,7 @@ export declare function anchorOf(value: CalendarValue): Date | null;
  * </Calendar>
  * ```
  */
-export declare const Calendar: React.ForwardRefExoticComponent<Omit<CalendarProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Calendar: {
+    ({ selectionMode, value: valueInput, defaultValue: defaultValueInput, onValueChange, month: monthInput, defaultMonth: defaultMonthInput, onMonthChange, focusedDate: focusedDateInput, defaultFocusedDate: defaultFocusedDateInput, onFocusChange, view: viewProp, defaultView, minView, maxView, onViewChange, numberOfMonths, locale, minDate: minDateInput, maxDate: maxDateInput, weekStartsOn: weekStartsOnProp, pageBehavior, weekNumbers, today: todayInput, readOnly, disabled, outsideDaySelectable, isDateDisabled: isDateDisabledProp, isDateUnavailable, getSelectionAnnouncement, getMonthAnnouncement, children, ref: forwardedRef, ...props }: CalendarProps): React.ReactNode;
+    displayName: string;
+};

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.
- */
-/** @internal Number of days in the given zero-based `month` of `year` (e.g. `getDaysInMonth(2024, 1)` → 29). */
+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`. */
 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,72 +35,86 @@ 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) | undefined;
+}
+/** @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". */
+export declare function resetInstantDateWarning(): void;
+/**
+ * Warns 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.
+ *
+ * @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 (1–53) of `date`, independent of `weekStartsOn` and using local wall-clock time.
+ *
+ * @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 calendar views, most granular first — every `minView`/`maxView` clamp is an index move along this array. */
+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. */
+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.
- *
- * - `single` — just `date`.
- * - `multiple` — `date` toggled into/out of the array, kept chronological.
- * - `range` — anchors a new range (`{ start: date, end: null }`) when nothing
- *   is anchored or the previous range was already complete, otherwise closes
- *   the anchored range, ordering `start`/`end` so a backwards drag still
- *   yields `start <= end`.
- */
+/** The selection that results from choosing `date` while `current` is selected: replaces for `single`, toggles for `multiple`, and anchors or closes a range for `range`. */
 export declare function nextSelection(mode: CalendarSelectionMode, current: CalendarValue, date: Date): CalendarValue;
 /** @internal The live-region message for a selection change, or `''` when there is nothing worth announcing. */
 export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
-export declare const CalendarProvider: {
-    (props: CalendarContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useCalendarContextInternal: (consumerName: string) => CalendarContextValue;
+export declare const CalendarProvider: React.FC<CalendarContextValue & {
+    children: React.ReactNode;
+}>, 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, scoping keyboard focus restoration's cell lookup to it. */
+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 that owns selection, displayed month(s), and roving focus, handing them to every `Calendar*` part via context.
  *
  * @example
  * ```tsx
@@ -136,4 +139,7 @@ export declare function anchorOf(value: CalendarValue): Date | null;
  * </Calendar>
  * ```
  */
-export declare const Calendar: React.ForwardRefExoticComponent<Omit<CalendarProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const Calendar: {
+    ({ selectionMode, value: valueInput, defaultValue: defaultValueInput, onValueChange, month: monthInput, defaultMonth: defaultMonthInput, onMonthChange, focusedDate: focusedDateInput, defaultFocusedDate: defaultFocusedDateInput, onFocusChange, view: viewProp, defaultView, minView, maxView, onViewChange, numberOfMonths, locale, minDate: minDateInput, maxDate: maxDateInput, weekStartsOn: weekStartsOnProp, pageBehavior, weekNumbers, today: todayInput, readOnly, disabled, outsideDaySelectable, isDateDisabled: isDateDisabledProp, isDateUnavailable, getSelectionAnnouncement, getMonthAnnouncement, children, ref: forwardedRef, ...props }: CalendarProps): React.ReactNode;
+    displayName: string;
+};