@skdx/vue 0.26.0

package/dist/calendar/CalendarNextButton.vue.d.ts

@@ -0,0 +1,14 @@
+/** Navigates the `SkdxCalendar` to the next month on click. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarNextButton.vue.js

@@ -0,0 +1 @@
+import t from"./CalendarNextButton.vue_vue_type_script_setup_true_lang.js";var e=t;export{e as default};

package/dist/calendar/CalendarNextButton.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const u=require("./context.cjs"),a=require("./dateMath.cjs");let e=require("vue");var l=(0,e.defineComponent)({__name:"CalendarNextButton",setup(c){const o=(0,e.inject)(u.CALENDAR_CONTEXT);if(!o)throw new Error("SkdxCalendarNextButton must be used within SkdxCalendar");const t=o;function r(){const n=a.addMonths(t.month.value,1);t.onMonthChange(n),t.setFocusedDate(a.clampToMonth(t.focusedDate.value,n))}return(n,d)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-calendar__next-button","data-part":"next-button",type:"button","aria-label":"Next month",onClick:r},[(0,e.renderSlot)(n.$slots,"default")]))}});exports.default=l;

package/dist/calendar/CalendarNextButton.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{CALENDAR_CONTEXT as t}from"./context.js";import{addMonths as e,clampToMonth as a}from"./dateMath.js";import{createElementBlock as n,defineComponent as o,inject as s,openBlock as r,renderSlot as d}from"vue";var l=/* @__PURE__ */o({__name:"CalendarNextButton",setup(o){const l=s(t);if(!l)throw new Error("SkdxCalendarNextButton must be used within SkdxCalendar");const u=l;function c(){const t=e(u.month.value,1);u.onMonthChange(t),u.setFocusedDate(a(u.focusedDate.value,t))}return(t,e)=>(r(),n("button",{class:"skdx-calendar__next-button","data-part":"next-button",type:"button","aria-label":"Next month",onClick:c},[d(t.$slots,"default")]))}});export{l as default};

package/dist/calendar/CalendarPreviousButton.vue.cjs

@@ -0,0 +1 @@
+const e=require("./CalendarPreviousButton.vue_vue_type_script_setup_true_lang.cjs");var u=e.default;exports.default=u;

package/dist/calendar/CalendarPreviousButton.vue.d.cts

@@ -0,0 +1,14 @@
+/** Navigates the `SkdxCalendar` to the previous month on click. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarPreviousButton.vue.d.ts

@@ -0,0 +1,14 @@
+/** Navigates the `SkdxCalendar` to the previous month on click. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarPreviousButton.vue.js

@@ -0,0 +1 @@
+import e from"./CalendarPreviousButton.vue_vue_type_script_setup_true_lang.js";var t=e;export{t as default};

package/dist/calendar/CalendarPreviousButton.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+const a=require("./context.cjs"),r=require("./dateMath.cjs");let e=require("vue");var s=(0,e.defineComponent)({__name:"CalendarPreviousButton",setup(l){const o=(0,e.inject)(a.CALENDAR_CONTEXT);if(!o)throw new Error("SkdxCalendarPreviousButton must be used within SkdxCalendar");const t=o;function u(){const n=r.addMonths(t.month.value,-1);t.onMonthChange(n),t.setFocusedDate(r.clampToMonth(t.focusedDate.value,n))}return(n,c)=>((0,e.openBlock)(),(0,e.createElementBlock)("button",{class:"skdx-calendar__previous-button","data-part":"previous-button",type:"button","aria-label":"Previous month",onClick:u},[(0,e.renderSlot)(n.$slots,"default")]))}});exports.default=s;

package/dist/calendar/CalendarPreviousButton.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{CALENDAR_CONTEXT as t}from"./context.js";import{addMonths as e,clampToMonth as o}from"./dateMath.js";import{createElementBlock as a,defineComponent as n,inject as s,openBlock as r,renderSlot as u}from"vue";var d=/* @__PURE__ */n({__name:"CalendarPreviousButton",setup(n){const d=s(t);if(!d)throw new Error("SkdxCalendarPreviousButton must be used within SkdxCalendar");const l=d;function i(){const t=e(l.month.value,-1);l.onMonthChange(t),l.setFocusedDate(o(l.focusedDate.value,t))}return(t,e)=>(r(),a("button",{class:"skdx-calendar__previous-button","data-part":"previous-button",type:"button","aria-label":"Previous month",onClick:i},[u(t.$slots,"default")]))}});export{d as default};

package/dist/calendar/CalendarRow.vue.cjs

@@ -0,0 +1 @@
+const e=require("./CalendarRow.vue_vue_type_script_setup_true_lang.cjs");var a=e.default;exports.default=a;

package/dist/calendar/CalendarRow.vue.d.cts

@@ -0,0 +1,14 @@
+/** `role="row"` wrapper for one week of `SkdxCalendarWeekDay` or `SkdxCalendarCell` children. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarRow.vue.d.ts

@@ -0,0 +1,14 @@
+/** `role="row"` wrapper for one week of `SkdxCalendarWeekDay` or `SkdxCalendarCell` children. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarRow.vue.js

@@ -0,0 +1 @@
+import e from"./CalendarRow.vue_vue_type_script_setup_true_lang.js";var r=e;export{r as default};

package/dist/calendar/CalendarRow.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+let e=require("vue");var a={class:"skdx-calendar__row","data-part":"row",role:"row"},t=(0,e.defineComponent)({__name:"CalendarRow",setup(_){return(r,l)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",a,[(0,e.renderSlot)(r.$slots,"default")]))}});exports.default=t;

package/dist/calendar/CalendarRow.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{createElementBlock as e,defineComponent as a,openBlock as o,renderSlot as r}from"vue";var t={class:"skdx-calendar__row","data-part":"row",role:"row"},l=/* @__PURE__ */a({__name:"CalendarRow",setup:a=>(a,l)=>(o(),e("div",t,[r(a.$slots,"default")]))});export{l as default};

package/dist/calendar/CalendarWeekDay.vue.cjs

@@ -0,0 +1 @@
+const e=require("./CalendarWeekDay.vue_vue_type_script_setup_true_lang.cjs");var a=e.default;exports.default=a;

package/dist/calendar/CalendarWeekDay.vue.d.cts

@@ -0,0 +1,14 @@
+/** Single `role="columnheader"` cell labeling a weekday in a `SkdxCalendar`'s grid header. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarWeekDay.vue.d.ts

@@ -0,0 +1,14 @@
+/** Single `role="columnheader"` cell labeling a weekday in a `SkdxCalendar`'s grid header. */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/calendar/CalendarWeekDay.vue.js

@@ -0,0 +1 @@
+import e from"./CalendarWeekDay.vue_vue_type_script_setup_true_lang.js";var a=e;export{a as default};

package/dist/calendar/CalendarWeekDay.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+let e=require("vue");var r={class:"skdx-calendar__week-day","data-part":"week-day",role:"columnheader"},t=(0,e.defineComponent)({__name:"CalendarWeekDay",setup(_){return(a,l)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",r,[(0,e.renderSlot)(a.$slots,"default")]))}});exports.default=t;

package/dist/calendar/CalendarWeekDay.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1 @@
+import{createElementBlock as e,defineComponent as a,openBlock as d,renderSlot as l}from"vue";var o={class:"skdx-calendar__week-day","data-part":"week-day",role:"columnheader"},r=/* @__PURE__ */a({__name:"CalendarWeekDay",setup:a=>(a,r)=>(d(),e("div",o,[l(a.$slots,"default")]))});export{r as default};

package/dist/calendar/context.cjs

@@ -0,0 +1 @@
+var A=Symbol("skdx-calendar-context"),C=Symbol("skdx-calendar-grid-context");exports.CALENDAR_CONTEXT=A;exports.CALENDAR_GRID_CONTEXT=C;

package/dist/calendar/context.d.cts

@@ -0,0 +1,39 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { CalendarSelectionMode, CalendarValue } from './dateMath.cjs';
+/** One cell in a `SkdxCalendar` grid week, as produced by `getVisibleWeeks`. */
+export interface CalendarDay {
+    date: Date;
+    /** Whether this date falls outside the grid's displayed month (leading/trailing filler day). */
+    outsideMonth: boolean;
+}
+/** @internal Injection key a Calendar provides so its parts can read/drive shared date state. */
+export interface CalendarContext {
+    value: Readonly<Ref<CalendarValue>>;
+    selectionMode: CalendarSelectionMode;
+    month: Readonly<Ref<Date>>;
+    /** Every displayed month, `numberOfMonths` long, starting at `month`. */
+    months: Readonly<Ref<Date[]>>;
+    focusedDate: Readonly<Ref<Date>>;
+    weekStartsOn: number;
+    locale?: string;
+    /** Weekday names for `locale`, rotated to start at `weekStartsOn`, as `{ short, long }` pairs. */
+    weekDayNames: Readonly<Ref<Array<{
+        short: string;
+        long: string;
+    }>>>;
+    minDate?: Date;
+    maxDate?: Date;
+    disabled?: (date: Date) => boolean;
+    isDateUnavailable?: (isoDate: string) => boolean;
+    onValueChange(date: Date): void;
+    onMonthChange(month: Date): void;
+    setFocusedDate(date: Date): void;
+}
+/** @internal Injection key a Calendar provides so its grid/cells can read selected/focused-date state and drive selection and navigation. */
+export declare const CALENDAR_CONTEXT: InjectionKey<CalendarContext>;
+/** @internal Which month one `SkdxCalendarGrid` renders, so a multi-month calendar's cells know which month they belong to. */
+export interface CalendarGridContext {
+    gridMonth: Readonly<Ref<Date>>;
+}
+/** @internal Injection key a CalendarGrid provides so its cells resolve "outside month" against their own grid, not the root. */
+export declare const CALENDAR_GRID_CONTEXT: InjectionKey<CalendarGridContext>;

package/dist/calendar/context.d.ts

@@ -0,0 +1,39 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { CalendarSelectionMode, CalendarValue } from './dateMath.js';
+/** One cell in a `SkdxCalendar` grid week, as produced by `getVisibleWeeks`. */
+export interface CalendarDay {
+    date: Date;
+    /** Whether this date falls outside the grid's displayed month (leading/trailing filler day). */
+    outsideMonth: boolean;
+}
+/** @internal Injection key a Calendar provides so its parts can read/drive shared date state. */
+export interface CalendarContext {
+    value: Readonly<Ref<CalendarValue>>;
+    selectionMode: CalendarSelectionMode;
+    month: Readonly<Ref<Date>>;
+    /** Every displayed month, `numberOfMonths` long, starting at `month`. */
+    months: Readonly<Ref<Date[]>>;
+    focusedDate: Readonly<Ref<Date>>;
+    weekStartsOn: number;
+    locale?: string;
+    /** Weekday names for `locale`, rotated to start at `weekStartsOn`, as `{ short, long }` pairs. */
+    weekDayNames: Readonly<Ref<Array<{
+        short: string;
+        long: string;
+    }>>>;
+    minDate?: Date;
+    maxDate?: Date;
+    disabled?: (date: Date) => boolean;
+    isDateUnavailable?: (isoDate: string) => boolean;
+    onValueChange(date: Date): void;
+    onMonthChange(month: Date): void;
+    setFocusedDate(date: Date): void;
+}
+/** @internal Injection key a Calendar provides so its grid/cells can read selected/focused-date state and drive selection and navigation. */
+export declare const CALENDAR_CONTEXT: InjectionKey<CalendarContext>;
+/** @internal Which month one `SkdxCalendarGrid` renders, so a multi-month calendar's cells know which month they belong to. */
+export interface CalendarGridContext {
+    gridMonth: Readonly<Ref<Date>>;
+}
+/** @internal Injection key a CalendarGrid provides so its cells resolve "outside month" against their own grid, not the root. */
+export declare const CALENDAR_GRID_CONTEXT: InjectionKey<CalendarGridContext>;

package/dist/calendar/context.js

@@ -0,0 +1 @@
+var a=/* @__PURE__ */Symbol("skdx-calendar-context"),d=/* @__PURE__ */Symbol("skdx-calendar-grid-context");export{a as CALENDAR_CONTEXT,d as CALENDAR_GRID_CONTEXT};

package/dist/calendar/dateMath.cjs

@@ -0,0 +1 @@
+const g=require("./locale.cjs");function c(t,e){return new Date(t,e+1,0).getDate()}function m(t){return new Date(t.getFullYear(),t.getMonth(),1)}function M(t,e){const n=t.getDate(),r=new Date(t.getFullYear(),t.getMonth(),1);r.setMonth(r.getMonth()+e);const i=c(r.getFullYear(),r.getMonth());return r.setDate(Math.min(n,i)),r}function S(t,e){return M(t,e*12)}function D(t,e){const n=new Date(t);return n.setDate(n.getDate()+e),n}function l(t,e){return!t||!e?!1:t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()&&t.getDate()===e.getDate()}function d(t,e){return t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()}function h(t,e){const n=new Date(t.getFullYear(),t.getMonth(),t.getDate()),r=(n.getDay()-e+7)%7;return n.setDate(n.getDate()-r),n}function T(t,e){return D(h(t,e),6)}function s(t){return new Date(t.getFullYear(),t.getMonth(),t.getDate())}function Y(t,e,n,r){const i=s(t).getTime();return!!(e&&i<s(e).getTime()||n&&i>s(n).getTime()||r?.(t))}function p(t){return`${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")}`}function A(t,e){if(d(t,e))return t;const n=c(e.getFullYear(),e.getMonth());return new Date(e.getFullYear(),e.getMonth(),Math.min(t.getDate(),n))}function u(t){return t!==null&&!Array.isArray(t)&&!(t instanceof Date)}function F(t){return t==="multiple"?[]:null}function O(t,e){return t===null?!1:Array.isArray(t)?t.some(n=>l(n,e)):u(t)?y(t,e)!==void 0:l(t,e)}function y(t,e){const n=s(e).getTime(),r=s(t.start).getTime();if(t.end===null)return n===r?"start":void 0;const i=s(t.end).getTime();if(!(n<r||n>i))return n===r?"start":n===i?"end":"middle"}function w(t,e,n){if(t==="single")return n;if(t==="multiple"){const i=Array.isArray(e)?e:[],a=i.filter(o=>!l(o,n));return a.length!==i.length?a:[...i,n].sort((o,f)=>o.getTime()-f.getTime())}const r=u(e)&&e.end===null?e:void 0;return r?s(n).getTime()<s(r.start).getTime()?{start:n,end:r.start}:{start:r.start,end:n}:{start:n,end:null}}function k(t,e){return u(t)?t.end===null?`${g.formatDateLabel(t.start,e)} selected as the range start. Select an end date.`:`Range selected, ${g.formatDateLabel(t.start,e)} to ${g.formatDateLabel(t.end,e)}.`:Array.isArray(t)?`${t.length} ${t.length===1?"date":"dates"} selected.`:""}function $(t){return t===null?null:Array.isArray(t)?t[0]??null:u(t)?t.start:t}function I(t,e=0){const n=h(m(t),e),r=[];let i=n;for(let a=0;a<6;a++){const o=[];for(let f=0;f<7;f++)o.push({date:i,outsideMonth:!d(i,t)}),i=D(i,1);r.push(o)}return r}exports.addDays=D;exports.addMonths=M;exports.addYears=S;exports.anchorOf=$;exports.clampToMonth=A;exports.emptySelection=F;exports.endOfWeek=T;exports.getDaysInMonth=c;exports.getVisibleWeeks=I;exports.isDateDisabled=Y;exports.isDateRange=u;exports.isDateSelected=O;exports.isSameDay=l;exports.isSameMonth=d;exports.nextSelection=w;exports.rangePositionOf=y;exports.selectionAnnouncement=k;exports.startOfMonth=m;exports.startOfWeek=h;exports.stripTime=s;exports.toISODateString=p;

package/dist/calendar/dateMath.d.cts

@@ -0,0 +1,200 @@
+import type { CalendarDay } from './context.cjs';
+/** Pure date-math helpers for `SkdxCalendar`, built on plain native `Date` — no date-library dependency. */
+/**
+ * How many dates a `SkdxCalendar` selects at once, and therefore what shape
+ * its `value` takes:
+ *
+ * | `selectionMode` | `value` type          | empty selection |
+ * | --------------- | --------------------- | --------------- |
+ * | `'single'`      | `Date \| null`        | `null`          |
+ * | `'multiple'`    | `Date[]`              | `[]`            |
+ * | `'range'`       | `DateRange \| null`   | `null`          |
+ */
+export type CalendarSelectionMode = 'single' | 'multiple' | 'range';
+/**
+ * A selected date range. `end` is `null` while the range is *anchored* — the
+ * user has picked a start date and the next selection will close the range.
+ */
+export interface DateRange {
+    /** First date of the range (always the earlier of the two once `end` is set). */
+    start: Date;
+    /** Last date of the range, or `null` while only the anchor has been picked. */
+    end: Date | null;
+}
+/**
+ * A `SkdxCalendar`'s selection, whose concrete shape follows
+ * {@link CalendarSelectionMode}. One union rather than a discriminated
+ * props type, because Angular `@Input`s, Vue props and Web Component
+ * properties cannot discriminate on a sibling prop — semantic parity across
+ * the five frameworks beats a type trick only two of them could express.
+ */
+export type CalendarValue = Date | Date[] | DateRange | null;
+/** Where a date sits inside a selected range, for the `data-range-*` styling hooks. */
+export type RangePosition = 'start' | 'middle' | 'end';
+export declare function getDaysInMonth(year: number, month: number): number;
+/**
+ * Returns local midnight on the first day of the given date's month.
+ *
+ * @internal
+ */
+export declare function startOfMonth(date: Date): Date;
+/**
+ * Moves `date` by `amount` calendar months (negative goes back),
+ * clamping the day-of-month to the target month's length: Jan 31 + 1 month is
+ * Feb 28 — or Feb 29 in a leap year — not the Mar 2/3 a bare `setMonth` on the
+ * 31st would roll into. The shift is applied on the 1st of the source month for
+ * exactly that reason, then the day is put back.
+ *
+ * Returns a fresh `Date` at **local midnight**: unlike {@link addDays} it is
+ * built from year/month/day, so any time-of-day on the input is dropped. Never
+ * mutates the argument, and `setMonth` carries the year across December.
+ *
+ * @internal
+ */
+export declare function addMonths(date: Date, amount: number): Date;
+/**
+ * Adds `amount` years by delegating to addMonths (amount × 12).
+ *
+ * @internal
+ */
+export declare function addYears(date: Date, amount: number): Date;
+/**
+ * Moves `date` by `amount` calendar days (negative goes back), rolling
+ * across month and year boundaries — Dec 31 + 1 is Jan 1.
+ *
+ * Calendar arithmetic, not 24-hour arithmetic: `setDate` re-anchors the same
+ * wall-clock time on the new local day, so a step across a DST boundary still
+ * lands on the next day at the same hour, where adding `86400000` ms would
+ * arrive an hour early or late. Copies the input — including its time-of-day,
+ * unlike {@link addMonths} — and never mutates it.
+ *
+ * @internal
+ */
+export declare function addDays(date: Date, amount: number): Date;
+/**
+ * Whether `a` and `b` land on the same **local** calendar day,
+ * comparing year, month and day-of-month rather than timestamps — so two dates
+ * an hour apart across midnight are different days, and two dates twelve hours
+ * apart within one day are the same. The comparison never converts to UTC: the
+ * question a calendar grid asks is always "which cell", and cells are local.
+ *
+ * Both arguments are nullable and a missing one yields `false`, never a throw,
+ * so callers can pass an unset selection straight in. That also makes it
+ * *not* reflexive over nothing: `isSameDay(null, null)` is `false`.
+ *
+ * @internal
+ */
+export declare function isSameDay(a: Date | null | undefined, b: Date | null | undefined): boolean;
+/**
+ * Whether `a` and `b` fall in the same month **of the same year** —
+ * January 2025 and January 2026 are not the same month. Local months, like
+ * {@link isSameDay}, and the day-of-month is ignored entirely.
+ *
+ * This is what marks a cell `outsideMonth` in `getVisibleWeeks`: the 6×7 grid
+ * always spills into the neighbouring months, and those filler days are the
+ * ones this returns `false` for. Unlike {@link isSameDay} it takes no nulls —
+ * a grid always has a month.
+ *
+ * @internal
+ */
+export declare function isSameMonth(a: Date, b: Date): boolean;
+/**
+ * Returns the first day of the date's week for the given `weekStartsOn` offset.
+ *
+ * @internal
+ */
+export declare function startOfWeek(date: Date, weekStartsOn: number): Date;
+/**
+ * Returns the last day of the date's week (6 days after its start).
+ *
+ * @internal
+ */
+export declare function endOfWeek(date: Date, weekStartsOn: number): Date;
+/**
+ * Returns the date at local midnight, discarding the time component.
+ *
+ * @internal
+ */
+export declare function stripTime(date: Date): Date;
+/**
+ * True when the date is before minDate, after maxDate, or rejected by disabledFn (compared date-only).
+ *
+ * @internal
+ */
+export declare function isDateDisabled(date: Date, minDate: Date | undefined, maxDate: Date | undefined, disabledFn: ((date: Date) => boolean) | undefined): boolean;
+/**
+ * Formats the date as a local `YYYY-MM-DD` string.
+ *
+ * @internal
+ */
+export declare function toISODateString(date: Date): string;
+/**
+ * Returns the same day-of-month within targetMonth, clamping to that month's length.
+ *
+ * @internal
+ */
+export declare function clampToMonth(date: Date, targetMonth: Date): Date;
+/** 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`).
+ */
+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'`.
+ */
+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`.
+ */
+export declare function nextSelection(mode: CalendarSelectionMode, current: CalendarValue, date: Date): CalendarValue;
+/**
+ * Words the polite live-region message for a selection change, or
+ * returns `''` — announce nothing — when the selection already speaks for
+ * itself. The default behind `SkdxCalendar`'s `getSelectionAnnouncement`.
+ *
+ * Silent in `single` mode, deliberately: the pressed cell is focused and
+ * carries `aria-selected`, so the screen reader has already read that date and
+ * repeating it doubles the date up. `multiple` announces the running count and
+ * not the dates, because re-reading a growing list on every click is unusable.
+ * `range` is the case that needs prose in both halves — while `end` is `null`
+ * it names the start *and* prompts for an end, so the user knows the range is
+ * still open; once closed it reads both endpoints. Dates go through
+ * `formatDateLabel`, so `locale` decides the wording of each one.
+ *
+ * @internal
+ */
+export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
+/**
+ * Reduces any {@link CalendarValue} shape to the one date a calendar
+ * should open on — the month it displays and the cell that holds the roving
+ * tab stop — or `null` when nothing is selected.
+ *
+ * Per mode: `single` is the date itself; `multiple` is `value[0]`, the earliest,
+ * since `nextSelection` keeps that array chronological; `range` is `start`,
+ * including a range still anchored with `end: null`. An empty array and an
+ * empty selection both give `null`.
+ *
+ * Read once, at setup, not on every change — a calendar that re-anchored as the
+ * selection moved would yank the month out from under a user browsing away from
+ * their own selection. `null` is the caller's cue to fall back: `SkdxCalendar`
+ * displays `defaultMonth` or today, and focuses the displayed month.
+ *
+ * @internal
+ */
+export declare function anchorOf(value: CalendarValue): Date | null;
+/** Always returns a 6x7 (weeks x weekdays) grid, including adjacent-month filler days. */
+export declare function getVisibleWeeks(month: Date, weekStartsOn?: number): CalendarDay[][];