@skdx/vue 0.28.0 → 0.30.0

package/dist/calendar/dateMath.d.cts

@@ -1,10 +1,7 @@
-import type { DateInput } from '../utils/dateValue.cjs';
+import type { DateInput } from '../utils/date-value.cjs';
 import type { CalendarDay } from './context.cjs';
 /** Pure date-math helpers for `SkdxCalendar`, built on plain native `Date` — no date-library dependency. */
-/**
- * Selection count: 'single' (Date | null), 'multiple' (Date[]), or 'range'
- * ({ start: Date; end: Date | null } | null). Determines the shape of `value`.
- */
+/** Selection mode: 'single' (Date | null), 'multiple' (Date[]), or 'range' ({start,end}|null) — determines value's shape. */
 export type CalendarSelectionMode = 'single' | 'multiple' | 'range';
 /** A selected date range. `end` is `null` while the range is anchored, awaiting a second pick. */
 export interface DateRange {
@@ -13,18 +10,9 @@ export interface DateRange {
     /** Last date of the range, or `null` while only the anchor has been picked. */
     end: Date | null;
 }
-/**
- * Calendar's selection shape following {@link CalendarSelectionMode}. Union
- * type (not discriminated props) for semantic parity across frameworks.
- */
+/** Calendar's selection shape following {@link CalendarSelectionMode}. */
 export type CalendarValue = Date | Date[] | DateRange | null;
-/**
- * Lenient input form of {@link CalendarValue}. Each Date position accepts ISO
- * strings; the whole selection accepts wire strings ('2026-08-10' single,
- * '2026-08-10,2026-08-14' set, '2026-08-10/2026-08-14' range, trailing / for
- * anchored range). Strings read as local-time calendar dates, never UTC.
- * Component emits the strict `Date` shape.
- */
+/** Lenient input form of {@link CalendarValue}; accepts ISO date strings, read as local-time calendar dates. */
 export type CalendarValueInput = DateInput | ReadonlyArray<DateInput> | {
     start: DateInput;
     end?: DateInput | null;
@@ -52,19 +40,9 @@ export declare function addYears(date: Date, amount: number): Date;
  * @internal
  */
 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`.
- * @internal
- */
+/** @internal Whether a and b fall on the same calendar day, ignoring time; false if either is null/undefined. */
 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, ignoring
- * day-of-month. Marks a cell `outsideMonth` in `getVisibleWeeks`. Unlike
- * {@link isSameDay} it takes no nulls — a grid always has a month.
- *
- * @internal
- */
+/** @internal Whether a and b fall in the same month of the same year, ignoring day-of-month. */
 export declare function isSameMonth(a: Date, b: Date): boolean;
 /** The first day of the date's week for the given `weekStartsOn` offset. @internal */
 export declare function startOfWeek(date: Date, weekStartsOn: number): Date;
@@ -81,53 +59,26 @@ export interface ResolvedCalendarDisabled {
     /** Whether the *whole* calendar is disabled. */
     disabled: boolean;
     /** The per-date predicate actually in effect. */
-    isDateDisabled?: (date: Date) => boolean;
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
 }
 /** @internal Resolves disabled and isDateDisabled props. */
 export declare function resolveCalendarDisabled(disabled: boolean | undefined, isDateDisabled: ((date: Date) => boolean) | undefined): ResolvedCalendarDisabled;
-/** @internal Puts {@link warnInstantDate} back to "not yet warned". Only needed by tests. */
+/** @internal Resets {@link warnInstantDate}'s once-per-process flag. */
 export declare function resetInstantDateWarning(): void;
 /**
- * Warns once per process when `date` looks like a UTC instant rather than a
- * local wall-clock day.
- *
- * `new Date('2024-01-05')` is the trap: the platform reads a bare
- * `YYYY-MM-DD` as UTC midnight, which is the 4th of January anywhere west of
- * Greenwich, and the calendar silently renders the wrong day. `new Date(2024,
- * 0, 5)` — local midnight — is the spelling that means what it says.
- *
- * Fires only for a `Date` sitting exactly on UTC midnight whose local day
- * differs — the signature of `new Date('YYYY-MM-DD')` — so a local midnight
- * in a positive-offset zone, which is correct, stays silent.
+ * Warns once per process when `date` looks like a UTC instant rather than a local wall-clock day.
  *
  * @param date the `Date` a consumer supplied, or `null`/`undefined` for no value
  * @param source the prop it arrived on, for the message
  */
 export declare function warnInstantDate(date: Date | null | undefined, source: string): void;
-/**
- * Formats the date as a local `YYYY-MM-DD` string.
- *
- * @internal
- */
+/** @internal Formats the date as a local YYYY-MM-DD string. */
 export declare function toISODateString(date: Date): string;
-/**
- * Returns the same day-of-month within targetMonth, clamping to that month's length.
- *
- * @internal
- */
+/** @internal Returns the same day-of-month within targetMonth, clamping to that month's length. */
 export declare function clampToMonth(date: Date, targetMonth: Date): Date;
 /**
  * The ISO-8601 week number of `date` (1–53).
  *
- * ISO 8601 numbers weeks from Monday and puts the year's first Thursday in
- * week 1, so a week belongs to whichever year holds its Thursday — not
- * `ceil(dayOfYear / 7)` — and it is independent of the calendar's
- * `weekStartsOn`.
- *
- * Transcribed into each framework package rather than imported, since
- * `@skdx/shared` is dev-only; `assertCalendarISOWeekContract` in
- * `@skdx/shared/testing` keeps the five copies in agreement.
- *
  * @param date - Any day of the week to number; not mutated.
  * @returns The ISO week number, `1`–`53`.
  */
@@ -142,18 +93,9 @@ export declare const CALENDAR_YEAR_PAGE = 20;
 export declare function clampView(view: CalendarView, minView: CalendarView, maxView: CalendarView): CalendarView;
 /** @internal First year of the twenty-year page containing `year` — 2026 falls on the 2020–2039 page. */
 export declare function yearPageStart(year: number): number;
-/**
- * Whether any day from `from` to `to` inclusive is selectable — what makes a
- * whole month or year cell refusable. `minDate`/`maxDate` narrow the window
- * first, so the bounds-only case is two comparisons with no loop; the scan
- * only runs when a predicate exists, and stops at the first available day.
- */
+/** 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` is showing around `date`. One function
- * so the heading, grid accessible name, and paging announcement never
- * disagree about what is on screen.
- */
+/** The label for whatever page view is showing around date. */
 export declare function formatViewPageLabel(date: Date, view: CalendarView, locale?: string): string;
 /** 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;
@@ -170,30 +112,9 @@ export declare function rangePositionOf(range: DateRange, date: Date): RangePosi
  * 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 `''` when
- * the selection already speaks for itself. The default behind
- * `SkdxCalendar`'s `getSelectionAnnouncement`.
- *
- * Silent in `single` mode: the focused cell already carries `aria-selected`,
- * so a screen reader has read that date already. `multiple` announces a
- * running count, not the dates. `range` names the start while `end` is
- * `null`, then reads both endpoints once closed.
- *
- * @internal
- */
+/** @internal Words the polite live-region message for a selection change, or '' when the selection already speaks for itself. */
 export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
-/**
- * Reduces any {@link CalendarValue} shape to the one date a calendar should
- * open on — displayed month and roving-tab-stop cell — or `null` when nothing
- * is selected. `single` is the date itself; `multiple` is the earliest
- * (`value[0]`, kept chronological by `nextSelection`); `range` is `start`.
- *
- * Read once at setup, not on every change: re-anchoring as the selection
- * moves would yank the month out from under a user browsing away from it.
- *
- * @internal
- */
+/** @internal Reduces any {@link CalendarValue} shape to the one date a calendar should open on, or null when nothing is selected. */
 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[][];

package/dist/calendar/dateMath.d.ts

@@ -1,10 +1,7 @@
-import type { DateInput } from '../utils/dateValue.js';
+import type { DateInput } from '../utils/date-value.js';
 import type { CalendarDay } from './context.js';
 /** Pure date-math helpers for `SkdxCalendar`, built on plain native `Date` — no date-library dependency. */
-/**
- * Selection count: 'single' (Date | null), 'multiple' (Date[]), or 'range'
- * ({ start: Date; end: Date | null } | null). Determines the shape of `value`.
- */
+/** Selection mode: 'single' (Date | null), 'multiple' (Date[]), or 'range' ({start,end}|null) — determines value's shape. */
 export type CalendarSelectionMode = 'single' | 'multiple' | 'range';
 /** A selected date range. `end` is `null` while the range is anchored, awaiting a second pick. */
 export interface DateRange {
@@ -13,18 +10,9 @@ export interface DateRange {
     /** Last date of the range, or `null` while only the anchor has been picked. */
     end: Date | null;
 }
-/**
- * Calendar's selection shape following {@link CalendarSelectionMode}. Union
- * type (not discriminated props) for semantic parity across frameworks.
- */
+/** Calendar's selection shape following {@link CalendarSelectionMode}. */
 export type CalendarValue = Date | Date[] | DateRange | null;
-/**
- * Lenient input form of {@link CalendarValue}. Each Date position accepts ISO
- * strings; the whole selection accepts wire strings ('2026-08-10' single,
- * '2026-08-10,2026-08-14' set, '2026-08-10/2026-08-14' range, trailing / for
- * anchored range). Strings read as local-time calendar dates, never UTC.
- * Component emits the strict `Date` shape.
- */
+/** Lenient input form of {@link CalendarValue}; accepts ISO date strings, read as local-time calendar dates. */
 export type CalendarValueInput = DateInput | ReadonlyArray<DateInput> | {
     start: DateInput;
     end?: DateInput | null;
@@ -52,19 +40,9 @@ export declare function addYears(date: Date, amount: number): Date;
  * @internal
  */
 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`.
- * @internal
- */
+/** @internal Whether a and b fall on the same calendar day, ignoring time; false if either is null/undefined. */
 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, ignoring
- * day-of-month. Marks a cell `outsideMonth` in `getVisibleWeeks`. Unlike
- * {@link isSameDay} it takes no nulls — a grid always has a month.
- *
- * @internal
- */
+/** @internal Whether a and b fall in the same month of the same year, ignoring day-of-month. */
 export declare function isSameMonth(a: Date, b: Date): boolean;
 /** The first day of the date's week for the given `weekStartsOn` offset. @internal */
 export declare function startOfWeek(date: Date, weekStartsOn: number): Date;
@@ -81,53 +59,26 @@ export interface ResolvedCalendarDisabled {
     /** Whether the *whole* calendar is disabled. */
     disabled: boolean;
     /** The per-date predicate actually in effect. */
-    isDateDisabled?: (date: Date) => boolean;
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
 }
 /** @internal Resolves disabled and isDateDisabled props. */
 export declare function resolveCalendarDisabled(disabled: boolean | undefined, isDateDisabled: ((date: Date) => boolean) | undefined): ResolvedCalendarDisabled;
-/** @internal Puts {@link warnInstantDate} back to "not yet warned". Only needed by tests. */
+/** @internal Resets {@link warnInstantDate}'s once-per-process flag. */
 export declare function resetInstantDateWarning(): void;
 /**
- * Warns once per process when `date` looks like a UTC instant rather than a
- * local wall-clock day.
- *
- * `new Date('2024-01-05')` is the trap: the platform reads a bare
- * `YYYY-MM-DD` as UTC midnight, which is the 4th of January anywhere west of
- * Greenwich, and the calendar silently renders the wrong day. `new Date(2024,
- * 0, 5)` — local midnight — is the spelling that means what it says.
- *
- * Fires only for a `Date` sitting exactly on UTC midnight whose local day
- * differs — the signature of `new Date('YYYY-MM-DD')` — so a local midnight
- * in a positive-offset zone, which is correct, stays silent.
+ * Warns once per process when `date` looks like a UTC instant rather than a local wall-clock day.
  *
  * @param date the `Date` a consumer supplied, or `null`/`undefined` for no value
  * @param source the prop it arrived on, for the message
  */
 export declare function warnInstantDate(date: Date | null | undefined, source: string): void;
-/**
- * Formats the date as a local `YYYY-MM-DD` string.
- *
- * @internal
- */
+/** @internal Formats the date as a local YYYY-MM-DD string. */
 export declare function toISODateString(date: Date): string;
-/**
- * Returns the same day-of-month within targetMonth, clamping to that month's length.
- *
- * @internal
- */
+/** @internal Returns the same day-of-month within targetMonth, clamping to that month's length. */
 export declare function clampToMonth(date: Date, targetMonth: Date): Date;
 /**
  * The ISO-8601 week number of `date` (1–53).
  *
- * ISO 8601 numbers weeks from Monday and puts the year's first Thursday in
- * week 1, so a week belongs to whichever year holds its Thursday — not
- * `ceil(dayOfYear / 7)` — and it is independent of the calendar's
- * `weekStartsOn`.
- *
- * Transcribed into each framework package rather than imported, since
- * `@skdx/shared` is dev-only; `assertCalendarISOWeekContract` in
- * `@skdx/shared/testing` keeps the five copies in agreement.
- *
  * @param date - Any day of the week to number; not mutated.
  * @returns The ISO week number, `1`–`53`.
  */
@@ -142,18 +93,9 @@ export declare const CALENDAR_YEAR_PAGE = 20;
 export declare function clampView(view: CalendarView, minView: CalendarView, maxView: CalendarView): CalendarView;
 /** @internal First year of the twenty-year page containing `year` — 2026 falls on the 2020–2039 page. */
 export declare function yearPageStart(year: number): number;
-/**
- * Whether any day from `from` to `to` inclusive is selectable — what makes a
- * whole month or year cell refusable. `minDate`/`maxDate` narrow the window
- * first, so the bounds-only case is two comparisons with no loop; the scan
- * only runs when a predicate exists, and stops at the first available day.
- */
+/** 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` is showing around `date`. One function
- * so the heading, grid accessible name, and paging announcement never
- * disagree about what is on screen.
- */
+/** The label for whatever page view is showing around date. */
 export declare function formatViewPageLabel(date: Date, view: CalendarView, locale?: string): string;
 /** 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;
@@ -170,30 +112,9 @@ export declare function rangePositionOf(range: DateRange, date: Date): RangePosi
  * 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 `''` when
- * the selection already speaks for itself. The default behind
- * `SkdxCalendar`'s `getSelectionAnnouncement`.
- *
- * Silent in `single` mode: the focused cell already carries `aria-selected`,
- * so a screen reader has read that date already. `multiple` announces a
- * running count, not the dates. `range` names the start while `end` is
- * `null`, then reads both endpoints once closed.
- *
- * @internal
- */
+/** @internal Words the polite live-region message for a selection change, or '' when the selection already speaks for itself. */
 export declare function selectionAnnouncement(value: CalendarValue, locale: string | undefined): string;
-/**
- * Reduces any {@link CalendarValue} shape to the one date a calendar should
- * open on — displayed month and roving-tab-stop cell — or `null` when nothing
- * is selected. `single` is the date itself; `multiple` is the earliest
- * (`value[0]`, kept chronological by `nextSelection`); `range` is `start`.
- *
- * Read once at setup, not on every change: re-anchoring as the selection
- * moves would yank the month out from under a user browsing away from it.
- *
- * @internal
- */
+/** @internal Reduces any {@link CalendarValue} shape to the one date a calendar should open on, or null when nothing is selected. */
 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[][];

package/dist/calendar/dateMath.js

@@ -1 +1 @@
-import{isDevMode as t}from"../utils/is-dev-mode.js";import{formatDateLabel as e,formatMonthLabel as n,formatYear as a,formatYearRange as r}from"./locale.js";function s(t,e){return new Date(t,e+1,0).getDate()}function i(t){return new Date(t.getFullYear(),t.getMonth(),1)}function o(t,e){const n=t.getDate(),a=new Date(t.getFullYear(),t.getMonth(),1);a.setMonth(a.getMonth()+e);const r=s(a.getFullYear(),a.getMonth());return a.setDate(Math.min(n,r)),a}function l(t,e){return o(t,12*e)}function u(t,e){const n=new Date(t);return n.setDate(n.getDate()+e),n}function g(t,e){return!(!t||!e)&&t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()&&t.getDate()===e.getDate()}function c(t,e){return t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()}function d(t,e){const n=new Date(t.getFullYear(),t.getMonth(),t.getDate()),a=(n.getDay()-e+7)%7;return n.setDate(n.getDate()-a),n}function f(t,e){return u(d(t,e),6)}function h(t){return new Date(t.getFullYear(),t.getMonth(),t.getDate())}function D(t,e,n){return e&&h(t).getTime()<h(e).getTime()?e:n&&h(t).getTime()>h(n).getTime()?n:t}function m(t,e,n,a){const r=h(t).getTime();return!!(e&&r<h(e).getTime()||n&&r>h(n).getTime()||a?.(t))}function M(t,e){return{disabled:t??!1,isDateDisabled:e}}var T=!1;function y(e,n){!e||T||0===e.getUTCHours()&&0===e.getUTCMinutes()&&0===e.getUTCSeconds()&&0===e.getUTCMilliseconds()&&(e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(T=!0,t()&&console.warn(`[skdx] Calendar: \`${n}\` 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 — 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 Y(t){return`${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")}`}function S(t,e){if(c(t,e))return t;const n=s(e.getFullYear(),e.getMonth());return new Date(e.getFullYear(),e.getMonth(),Math.min(t.getDate(),n))}function w(t){const e=new Date(t.getFullYear(),t.getMonth(),t.getDate());e.setDate(e.getDate()-(e.getDay()+6)%7+3);const n=new Date(e.getFullYear(),0,4);return n.setDate(n.getDate()-(n.getDay()+6)%7+3),1+Math.round((e.getTime()-n.getTime())/6048e5)}var A=["day","month","year"],p=20;function F(t,e,n){const a=A.indexOf(e),r=Math.max(a,A.indexOf(n));return A[Math.min(Math.max(A.indexOf(t),a),r)]}function $(t){return 20*Math.floor(t/20)}function v(t,e,n,a,r){const s=n&&h(n)>h(t)?h(n):h(t),i=a&&h(a)<h(e)?h(a):h(e);if(s.getTime()>i.getTime())return!1;if(!r)return!0;for(let t=s;t.getTime()<=i.getTime();t=u(t,1))if(!r(t))return!0;return!1}function C(t,e,s){if("day"===e)return n(t,s);if("month"===e)return a(t.getFullYear(),s);const i=$(t.getFullYear());return r(i,i+20-1,s)}function O(t){return!(null===t||Array.isArray(t)||t instanceof Date)}function b(t){return"multiple"===t?[]:null}function x(t,e){return null!==t&&(Array.isArray(t)?t.some(t=>g(t,e)):O(t)?void 0!==U(t,e):g(t,e))}function U(t,e){const n=h(e).getTime(),a=h(t.start).getTime();if(null===t.end)return n===a?"start":void 0;const r=h(t.end).getTime();return n<a||n>r?void 0:n===a?"start":n===r?"end":"middle"}function I(t,e,n){if("single"===t)return n;if("multiple"===t){const t=Array.isArray(e)?e:[],a=t.filter(t=>!g(t,n));return a.length!==t.length?a:[...t,n].sort((t,e)=>t.getTime()-e.getTime())}const a=O(e)&&null===e.end?e:void 0;return a?h(n).getTime()<h(a.start).getTime()?{start:n,end:a.start}:{start:a.start,end:n}:{start:n,end:null}}function R(t,n){return O(t)?null===t.end?`${e(t.start,n)} selected as the range start. Select an end date.`:`Range selected, ${e(t.start,n)} to ${e(t.end,n)}.`:Array.isArray(t)?`${t.length} ${1===t.length?"date":"dates"} selected.`:""}function k(t){return null===t?null:Array.isArray(t)?t[0]??null:O(t)?t.start:t}function E(t,e=0){const n=[];let a=d(i(t),e);for(let e=0;e<6;e++){const e=[];for(let n=0;n<7;n++)e.push({date:a,outsideMonth:!c(a,t)}),a=u(a,1);n.push(e)}return n}export{A as CALENDAR_VIEWS,p as CALENDAR_YEAR_PAGE,u as addDays,o as addMonths,l as addYears,k as anchorOf,D as clampToDateRange,S as clampToMonth,F as clampView,b as emptySelection,f as endOfWeek,C as formatViewPageLabel,s as getDaysInMonth,w as getISOWeek,E as getVisibleWeeks,v as hasAvailableDate,m as isDateDisabled,O as isDateRange,x as isDateSelected,g as isSameDay,c as isSameMonth,I as nextSelection,U as rangePositionOf,M as resolveCalendarDisabled,R as selectionAnnouncement,i as startOfMonth,d as startOfWeek,h as stripTime,Y as toISODateString,y as warnInstantDate,$ as yearPageStart};
+import{isDevMode as t}from"../utils/dev-mode.js";import{formatDateLabel as e,formatMonthLabel as n,formatYear as a,formatYearRange as r}from"../utils/calendar-locale.js";function s(t,e){return new Date(t,e+1,0).getDate()}function i(t){return new Date(t.getFullYear(),t.getMonth(),1)}function o(t,e){const n=t.getDate(),a=new Date(t.getFullYear(),t.getMonth(),1);a.setMonth(a.getMonth()+e);const r=s(a.getFullYear(),a.getMonth());return a.setDate(Math.min(n,r)),a}function l(t,e){return o(t,12*e)}function u(t,e){const n=new Date(t);return n.setDate(n.getDate()+e),n}function g(t,e){return!(!t||!e)&&t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()&&t.getDate()===e.getDate()}function c(t,e){return t.getFullYear()===e.getFullYear()&&t.getMonth()===e.getMonth()}function d(t,e){const n=new Date(t.getFullYear(),t.getMonth(),t.getDate()),a=(n.getDay()-e+7)%7;return n.setDate(n.getDate()-a),n}function f(t,e){return u(d(t,e),6)}function h(t){return new Date(t.getFullYear(),t.getMonth(),t.getDate())}function D(t,e,n){return e&&h(t).getTime()<h(e).getTime()?e:n&&h(t).getTime()>h(n).getTime()?n:t}function m(t,e,n,a){const r=h(t).getTime();return!!(e&&r<h(e).getTime()||n&&r>h(n).getTime()||a?.(t))}function M(t,e){return{disabled:t??!1,isDateDisabled:e}}var T=!1;function y(e,n){!e||T||0===e.getUTCHours()&&0===e.getUTCMinutes()&&0===e.getUTCSeconds()&&0===e.getUTCMilliseconds()&&(e.getDate()===e.getUTCDate()&&e.getMonth()===e.getUTCMonth()||(T=!0,t()&&console.warn(`[skdx] Calendar: \`${n}\` 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 — 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 Y(t){return`${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")}`}function S(t,e){if(c(t,e))return t;const n=s(e.getFullYear(),e.getMonth());return new Date(e.getFullYear(),e.getMonth(),Math.min(t.getDate(),n))}function w(t){const e=new Date(t.getFullYear(),t.getMonth(),t.getDate());e.setDate(e.getDate()-(e.getDay()+6)%7+3);const n=new Date(e.getFullYear(),0,4);return n.setDate(n.getDate()-(n.getDay()+6)%7+3),1+Math.round((e.getTime()-n.getTime())/6048e5)}var A=["day","month","year"],p=20;function F(t,e,n){const a=A.indexOf(e),r=Math.max(a,A.indexOf(n));return A[Math.min(Math.max(A.indexOf(t),a),r)]}function $(t){return 20*Math.floor(t/20)}function v(t,e,n,a,r){const s=n&&h(n)>h(t)?h(n):h(t),i=a&&h(a)<h(e)?h(a):h(e);if(s.getTime()>i.getTime())return!1;if(!r)return!0;for(let t=s;t.getTime()<=i.getTime();t=u(t,1))if(!r(t))return!0;return!1}function C(t,e,s){if("day"===e)return n(t,s);if("month"===e)return a(t.getFullYear(),s);const i=$(t.getFullYear());return r(i,i+20-1,s)}function O(t){return!(null===t||Array.isArray(t)||t instanceof Date)}function b(t){return"multiple"===t?[]:null}function x(t,e){return null!==t&&(Array.isArray(t)?t.some(t=>g(t,e)):O(t)?void 0!==U(t,e):g(t,e))}function U(t,e){const n=h(e).getTime(),a=h(t.start).getTime();if(null===t.end)return n===a?"start":void 0;const r=h(t.end).getTime();return n<a||n>r?void 0:n===a?"start":n===r?"end":"middle"}function I(t,e,n){if("single"===t)return n;if("multiple"===t){const t=Array.isArray(e)?e:[],a=t.filter(t=>!g(t,n));return a.length!==t.length?a:[...t,n].sort((t,e)=>t.getTime()-e.getTime())}const a=O(e)&&null===e.end?e:void 0;return a?h(n).getTime()<h(a.start).getTime()?{start:n,end:a.start}:{start:a.start,end:n}:{start:n,end:null}}function R(t,n){return O(t)?null===t.end?`${e(t.start,n)} selected as the range start. Select an end date.`:`Range selected, ${e(t.start,n)} to ${e(t.end,n)}.`:Array.isArray(t)?`${t.length} ${1===t.length?"date":"dates"} selected.`:""}function k(t){return null===t?null:Array.isArray(t)?t[0]??null:O(t)?t.start:t}function E(t,e=0){const n=[];let a=d(i(t),e);for(let e=0;e<6;e++){const e=[];for(let n=0;n<7;n++)e.push({date:a,outsideMonth:!c(a,t)}),a=u(a,1);n.push(e)}return n}export{A as CALENDAR_VIEWS,p as CALENDAR_YEAR_PAGE,u as addDays,o as addMonths,l as addYears,k as anchorOf,D as clampToDateRange,S as clampToMonth,F as clampView,b as emptySelection,f as endOfWeek,C as formatViewPageLabel,s as getDaysInMonth,w as getISOWeek,E as getVisibleWeeks,v as hasAvailableDate,m as isDateDisabled,O as isDateRange,x as isDateSelected,g as isSameDay,c as isSameMonth,I as nextSelection,U as rangePositionOf,M as resolveCalendarDisabled,R as selectionAnnouncement,i as startOfMonth,d as startOfWeek,h as stripTime,Y as toISODateString,y as warnInstantDate,$ as yearPageStart};

package/dist/calendar/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./locale.cjs"),a=require("./dateMath.cjs"),t=require("./Calendar.vue.cjs");exports.CALENDAR_VIEWS=a.CALENDAR_VIEWS;exports.CALENDAR_YEAR_PAGE=a.CALENDAR_YEAR_PAGE;exports.SkdxCalendar=t.default;exports.clearLocaleNameCache=e.clearLocaleNameCache;exports.emptySelection=a.emptySelection;exports.formatDateLabel=e.formatDateLabel;exports.formatMonthLabel=e.formatMonthLabel;exports.formatYear=e.formatYear;exports.formatYearRange=e.formatYearRange;exports.getISOWeek=a.getISOWeek;exports.getLocaleWeekStartsOn=e.getLocaleWeekStartsOn;exports.getMonthNames=e.getMonthNames;exports.getVisibleWeeks=a.getVisibleWeeks;exports.getWeekDayNames=e.getWeekDayNames;exports.isDateRange=a.isDateRange;exports.isDateSelected=a.isDateSelected;exports.nextSelection=a.nextSelection;exports.rangePositionOf=a.rangePositionOf;exports.resolveLocale=e.resolveLocale;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../utils/calendar-locale.cjs"),a=require("./dateMath.cjs"),t=require("./Calendar.vue.cjs");exports.CALENDAR_VIEWS=a.CALENDAR_VIEWS;exports.CALENDAR_YEAR_PAGE=a.CALENDAR_YEAR_PAGE;exports.SkdxCalendar=t.default;exports.clearLocaleNameCache=e.clearLocaleNameCache;exports.emptySelection=a.emptySelection;exports.formatDateLabel=e.formatDateLabel;exports.formatMonthLabel=e.formatMonthLabel;exports.formatYear=e.formatYear;exports.formatYearRange=e.formatYearRange;exports.getISOWeek=a.getISOWeek;exports.getLocaleWeekStartsOn=e.getLocaleWeekStartsOn;exports.getMonthNames=e.getMonthNames;exports.getVisibleWeeks=a.getVisibleWeeks;exports.getWeekDayNames=e.getWeekDayNames;exports.isDateRange=a.isDateRange;exports.isDateSelected=a.isDateSelected;exports.nextSelection=a.nextSelection;exports.rangePositionOf=a.rangePositionOf;exports.resolveLocale=e.resolveLocale;

package/dist/calendar/index.d.cts

@@ -3,5 +3,5 @@ export type { CalendarDay } from './context.cjs';
 export { CALENDAR_VIEWS, CALENDAR_YEAR_PAGE, getISOWeek, getVisibleWeeks } from './dateMath.cjs';
 export { emptySelection, isDateRange, isDateSelected, nextSelection, rangePositionOf, } from './dateMath.cjs';
 export type { CalendarSelectionMode, CalendarValue, CalendarValueInput, DateRange, RangePosition, CalendarPageBehavior, CalendarView, } from './dateMath.cjs';
-export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, formatYear, formatYearRange, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from './locale.cjs';
-export type { NameWidth } from './locale.cjs';
+export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, formatYear, formatYearRange, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from '../utils/calendar-locale.cjs';
+export type { NameWidth } from '../utils/calendar-locale.cjs';

package/dist/calendar/index.d.ts

@@ -3,5 +3,5 @@ export type { CalendarDay } from './context.js';
 export { CALENDAR_VIEWS, CALENDAR_YEAR_PAGE, getISOWeek, getVisibleWeeks } from './dateMath.js';
 export { emptySelection, isDateRange, isDateSelected, nextSelection, rangePositionOf, } from './dateMath.js';
 export type { CalendarSelectionMode, CalendarValue, CalendarValueInput, DateRange, RangePosition, CalendarPageBehavior, CalendarView, } from './dateMath.js';
-export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, formatYear, formatYearRange, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from './locale.js';
-export type { NameWidth } from './locale.js';
+export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, formatYear, formatYearRange, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from '../utils/calendar-locale.js';
+export type { NameWidth } from '../utils/calendar-locale.js';

package/dist/calendar/index.js

@@ -1 +1 @@
-import{clearLocaleNameCache as a,formatDateLabel as e,formatMonthLabel as s,formatYear as t,formatYearRange as o,getLocaleWeekStartsOn as r,getMonthNames as l,getWeekDayNames as m,resolveLocale as n}from"./locale.js";import{CALENDAR_VIEWS as i,CALENDAR_YEAR_PAGE as c,emptySelection as g,getISOWeek as L,getVisibleWeeks as f,isDateRange as S,isDateSelected as A,nextSelection as D,rangePositionOf as E}from"./dateMath.js";import N from"./Calendar.vue.js";export{i as CALENDAR_VIEWS,c as CALENDAR_YEAR_PAGE,N as SkdxCalendar,a as clearLocaleNameCache,g as emptySelection,e as formatDateLabel,s as formatMonthLabel,t as formatYear,o as formatYearRange,L as getISOWeek,r as getLocaleWeekStartsOn,l as getMonthNames,f as getVisibleWeeks,m as getWeekDayNames,S as isDateRange,A as isDateSelected,D as nextSelection,E as rangePositionOf,n as resolveLocale};
+import{clearLocaleNameCache as a,formatDateLabel as e,formatMonthLabel as s,formatYear as t,formatYearRange as o,getLocaleWeekStartsOn as r,getMonthNames as l,getWeekDayNames as n,resolveLocale as m}from"../utils/calendar-locale.js";import{CALENDAR_VIEWS as i,CALENDAR_YEAR_PAGE as c,emptySelection as g,getISOWeek as L,getVisibleWeeks as f,isDateRange as S,isDateSelected as A,nextSelection as D,rangePositionOf as E}from"./dateMath.js";import N from"./Calendar.vue.js";export{i as CALENDAR_VIEWS,c as CALENDAR_YEAR_PAGE,N as SkdxCalendar,a as clearLocaleNameCache,g as emptySelection,e as formatDateLabel,s as formatMonthLabel,t as formatYear,o as formatYearRange,L as getISOWeek,r as getLocaleWeekStartsOn,l as getMonthNames,f as getVisibleWeeks,n as getWeekDayNames,S as isDateRange,A as isDateSelected,D as nextSelection,E as rangePositionOf,m as resolveLocale};

package/dist/calendar/primitives.d.cts

@@ -1,6 +1,5 @@
 /**
  * Primitives for `SkdxCalendar` — composable building blocks.
- * Use these when you need a custom layout beyond the derived recipe.
  *
  * @example
  * ```vue

package/dist/calendar/primitives.d.ts

@@ -1,6 +1,5 @@
 /**
  * Primitives for `SkdxCalendar` — composable building blocks.
- * Use these when you need a custom layout beyond the derived recipe.
  *
  * @example
  * ```vue

package/dist/calendar/useViewGrid.cjs

@@ -1 +1 @@
-const q=require("../utils/direction.cjs"),S=require("../utils/liveAnnouncer.cjs"),V=require("./context.cjs"),f=require("./locale.cjs"),n=require("./dateMath.cjs");let l=require("vue");var g=4;function $(a,M){const w=(0,l.inject)(V.CALENDAR_CONTEXT);if(!w)throw new Error(`${M} must be used within SkdxCalendar`);const e=w,p=q.useDirection(),D=a==="month"?1:12,u=a==="month"?12:20,h=(0,l.computed)(()=>{const t=e.focusedDate.value;return a==="month"?t.getMonth():t.getFullYear()-n.yearPageStart(t.getFullYear())}),A=(0,l.computed)(()=>n.formatViewPageLabel(e.focusedDate.value,a,e.locale)),b=(0,l.computed)(()=>{const t=e.focusedDate.value,o=f.getMonthNames(e.locale,"short"),r=t.getFullYear(),m=n.anchorOf(e.value.value),d=e.today.value;return Array.from({length:u},(y,s)=>{const v=a==="month"?n.clampToMonth(t,new Date(r,s,1)):n.addMonths(t,(s-h.value)*D),c=a==="month"?r:v.getFullYear(),L=a==="month"?new Date(c,s,1):new Date(c,0,1),P=a==="month"?new Date(c,s,n.getDaysInMonth(c,s)):new Date(c,11,31),k=i=>i!==null&&i.getFullYear()===c&&(a==="year"||i.getMonth()===s);return{date:v,key:a==="month"?`${c}-${s}`:String(c),text:a==="month"?o[s]:f.formatYear(c,e.locale),label:a==="month"?f.formatMonthLabel(new Date(c,s,1),e.locale):f.formatYear(c,e.locale),refused:!n.hasAvailableDate(L,P,e.minDate,e.maxDate,e.isDateDisabled),selected:k(m),today:k(d)}})}),Y=(0,l.computed)(()=>{const t=b.value,o=[];for(let r=0;r<t.length;r+=g)o.push(t.slice(r,r+g));return o});function F(t){const o=e.focusedDate.value,r=n.addMonths(o,t*D),m=n.formatViewPageLabel(o,a,e.locale),d=n.formatViewPageLabel(r,a,e.locale);e.setFocusedDate(r),d!==m&&S.announce(d),requestAnimationFrame(()=>{const y=a==="month"?`${r.getFullYear()}-${r.getMonth()}`:String(r.getFullYear());(e.rootRef.value??document).querySelector(`[data-skdx-calendar-view-cell="${y}"]`)?.focus()})}function _(t){let o;switch(q.directionalKey(t.key,t.currentTarget,p())){case"ArrowLeft":o=-1;break;case"ArrowRight":o=1;break;case"ArrowUp":o=-4;break;case"ArrowDown":o=g;break;case"Home":o=-h.value;break;case"End":o=u-1-h.value;break;case"PageUp":o=-u*(t.shiftKey?10:1);break;case"PageDown":o=u*(t.shiftKey?10:1);break;default:return}t.preventDefault(),o!==0&&F(o)}return{context:e,cells:b,focusedIndex:h,gridLabel:A,rows:Y,handleKeydown:_}}exports.useViewGrid=$;
+const P=require("../utils/liveAnnouncer.cjs"),R=require("../utils/injectRequired.cjs"),v=require("../utils/direction.cjs"),d=require("../utils/calendar-locale.cjs"),S=require("./context.cjs"),n=require("./dateMath.cjs");let i=require("vue");var g=4;function V(a,k){const e=R.injectRequired(S.CALENDAR_CONTEXT,`${k} must be used within SkdxCalendar`),M=v.useDirection(),D=a==="month"?1:12,s=a==="month"?12:20,u=(0,i.computed)(()=>{const t=e.focusedDate.value;return a==="month"?t.getMonth():t.getFullYear()-n.yearPageStart(t.getFullYear())}),p=(0,i.computed)(()=>n.formatViewPageLabel(e.focusedDate.value,a,e.locale)),w=(0,i.computed)(()=>{const t=e.focusedDate.value,o=d.getMonthNames(e.locale,"short"),r=t.getFullYear(),m=n.anchorOf(e.value.value),h=e.today.value;return Array.from({length:s},(b,l)=>{const q=a==="month"?n.clampToMonth(t,new Date(r,l,1)):n.addMonths(t,(l-u.value)*D),c=a==="month"?r:q.getFullYear(),F=a==="month"?new Date(c,l,1):new Date(c,0,1),L=a==="month"?new Date(c,l,n.getDaysInMonth(c,l)):new Date(c,11,31),y=f=>f!==null&&f.getFullYear()===c&&(a==="year"||f.getMonth()===l);return{date:q,key:a==="month"?`${c}-${l}`:String(c),text:a==="month"?o[l]:d.formatYear(c,e.locale),label:a==="month"?d.formatMonthLabel(new Date(c,l,1),e.locale):d.formatYear(c,e.locale),refused:!n.hasAvailableDate(F,L,e.minDate,e.maxDate,e.isDateDisabled),selected:y(m),today:y(h)}})}),_=(0,i.computed)(()=>{const t=w.value,o=[];for(let r=0;r<t.length;r+=g)o.push(t.slice(r,r+g));return o});function A(t){const o=e.focusedDate.value,r=n.addMonths(o,t*D),m=n.formatViewPageLabel(o,a,e.locale),h=n.formatViewPageLabel(r,a,e.locale);e.setFocusedDate(r),h!==m&&P.announce(h),requestAnimationFrame(()=>{const b=a==="month"?`${r.getFullYear()}-${r.getMonth()}`:String(r.getFullYear());(e.rootRef.value??document).querySelector(`[data-skdx-calendar-view-cell="${b}"]`)?.focus()})}function Y(t){let o;switch(v.directionalKey(t.key,t.currentTarget,M())){case"ArrowLeft":o=-1;break;case"ArrowRight":o=1;break;case"ArrowUp":o=-4;break;case"ArrowDown":o=g;break;case"Home":o=-u.value;break;case"End":o=s-1-u.value;break;case"PageUp":o=-s*(t.shiftKey?10:1);break;case"PageDown":o=s*(t.shiftKey?10:1);break;default:return}t.preventDefault(),o!==0&&A(o)}return{context:e,cells:w,focusedIndex:u,gridLabel:p,rows:_,handleKeydown:Y}}exports.useViewGrid=V;

package/dist/calendar/useViewGrid.d.cts

@@ -28,7 +28,7 @@ export interface ViewGridModel {
     gridLabel: ComputedRef<string>;
     /** Rows of four for template iteration. */
     rows: ComputedRef<ViewCell[][]>;
-    handleKeydown(event: KeyboardEvent): void;
+    handleKeydown: (event: KeyboardEvent) => void;
 }
 /**
  * @internal Shared grid model for month and year views (unit-agnostic).

package/dist/calendar/useViewGrid.d.ts

@@ -28,7 +28,7 @@ export interface ViewGridModel {
     gridLabel: ComputedRef<string>;
     /** Rows of four for template iteration. */
     rows: ComputedRef<ViewCell[][]>;
-    handleKeydown(event: KeyboardEvent): void;
+    handleKeydown: (event: KeyboardEvent) => void;
 }
 /**
  * @internal Shared grid model for month and year views (unit-agnostic).

package/dist/calendar/useViewGrid.js

@@ -1 +1 @@
-import{directionalKey as e,useDirection as t}from"../utils/direction.js";import{announce as a}from"../utils/liveAnnouncer.js";import{CALENDAR_CONTEXT as o}from"./context.js";import{formatMonthLabel as r,formatYear as n,getMonthNames as l}from"./locale.js";import{addMonths as s,anchorOf as c,clampToMonth as u,formatViewPageLabel as i,getDaysInMonth as m,hasAvailableDate as h,yearPageStart as d}from"./dateMath.js";import{computed as f,inject as g}from"vue";function D(D,w){const v=g(o);if(!v)throw new Error(`${w} must be used within SkdxCalendar`);const b=v,p=t(),y="month"===D?1:12,k="month"===D?12:20,A=f(()=>{const e=b.focusedDate.value;return"month"===D?e.getMonth():e.getFullYear()-d(e.getFullYear())}),F=f(()=>i(b.focusedDate.value,D,b.locale)),M=f(()=>{const e=b.focusedDate.value,t=l(b.locale,"short"),a=e.getFullYear(),o=c(b.value.value),i=b.today.value;return Array.from({length:k},(l,c)=>{const d="month"===D?u(e,new Date(a,c,1)):s(e,(c-A.value)*y),f="month"===D?a:d.getFullYear(),g="month"===D?new Date(f,c,1):new Date(f,0,1),w="month"===D?new Date(f,c,m(f,c)):new Date(f,11,31),v=e=>null!==e&&e.getFullYear()===f&&("year"===D||e.getMonth()===c);return{date:d,key:"month"===D?`${f}-${c}`:String(f),text:"month"===D?t[c]:n(f,b.locale),label:"month"===D?r(new Date(f,c,1),b.locale):n(f,b.locale),refused:!h(g,w,b.minDate,b.maxDate,b.isDateDisabled),selected:v(o),today:v(i)}})}),x=f(()=>{const e=M.value,t=[];for(let a=0;a<e.length;a+=4)t.push(e.slice(a,a+4));return t});return{context:b,cells:M,focusedIndex:A,gridLabel:F,rows:x,handleKeydown:function(t){let o;switch(e(t.key,t.currentTarget,p())){case"ArrowLeft":o=-1;break;case"ArrowRight":o=1;break;case"ArrowUp":o=-4;break;case"ArrowDown":o=4;break;case"Home":o=-A.value;break;case"End":o=k-1-A.value;break;case"PageUp":o=-k*(t.shiftKey?10:1);break;case"PageDown":o=k*(t.shiftKey?10:1);break;default:return}t.preventDefault(),0!==o&&function(e){const t=b.focusedDate.value,o=s(t,e*y),r=i(t,D,b.locale),n=i(o,D,b.locale);b.setFocusedDate(o),n!==r&&a(n),requestAnimationFrame(()=>{const e="month"===D?`${o.getFullYear()}-${o.getMonth()}`:String(o.getFullYear());(b.rootRef.value??document).querySelector(`[data-skdx-calendar-view-cell="${e}"]`)?.focus()})}(o)}}}export{D as useViewGrid};
+import{announce as e}from"../utils/liveAnnouncer.js";import{injectRequired as t}from"../utils/injectRequired.js";import{directionalKey as a,useDirection as o}from"../utils/direction.js";import{formatMonthLabel as r,formatYear as n,getMonthNames as l}from"../utils/calendar-locale.js";import{CALENDAR_CONTEXT as s}from"./context.js";import{addMonths as u,anchorOf as c,clampToMonth as i,formatViewPageLabel as m,getDaysInMonth as d,hasAvailableDate as h,yearPageStart as f}from"./dateMath.js";import{computed as g}from"vue";function D(D,w){const v=t(s,`${w} must be used within SkdxCalendar`),b=o(),p="month"===D?1:12,y="month"===D?12:20,k=g(()=>{const e=v.focusedDate.value;return"month"===D?e.getMonth():e.getFullYear()-f(e.getFullYear())}),A=g(()=>m(v.focusedDate.value,D,v.locale)),F=g(()=>{const e=v.focusedDate.value,t=l(v.locale,"short"),a=e.getFullYear(),o=c(v.value.value),s=v.today.value;return Array.from({length:y},(l,c)=>{const m="month"===D?i(e,new Date(a,c,1)):u(e,(c-k.value)*p),f="month"===D?a:m.getFullYear(),g="month"===D?new Date(f,c,1):new Date(f,0,1),w="month"===D?new Date(f,c,d(f,c)):new Date(f,11,31),b=e=>null!==e&&e.getFullYear()===f&&("year"===D||e.getMonth()===c);return{date:m,key:"month"===D?`${f}-${c}`:String(f),text:"month"===D?t[c]:n(f,v.locale),label:"month"===D?r(new Date(f,c,1),v.locale):n(f,v.locale),refused:!h(g,w,v.minDate,v.maxDate,v.isDateDisabled),selected:b(o),today:b(s)}})}),M=g(()=>{const e=F.value,t=[];for(let a=0;a<e.length;a+=4)t.push(e.slice(a,a+4));return t});return{context:v,cells:F,focusedIndex:k,gridLabel:A,rows:M,handleKeydown:function(t){let o;switch(a(t.key,t.currentTarget,b())){case"ArrowLeft":o=-1;break;case"ArrowRight":o=1;break;case"ArrowUp":o=-4;break;case"ArrowDown":o=4;break;case"Home":o=-k.value;break;case"End":o=y-1-k.value;break;case"PageUp":o=-y*(t.shiftKey?10:1);break;case"PageDown":o=y*(t.shiftKey?10:1);break;default:return}t.preventDefault(),0!==o&&function(t){const a=v.focusedDate.value,o=u(a,t*p),r=m(a,D,v.locale),n=m(o,D,v.locale);v.setFocusedDate(o),n!==r&&e(n),requestAnimationFrame(()=>{const e="month"===D?`${o.getFullYear()}-${o.getMonth()}`:String(o.getFullYear());(v.rootRef.value??document).querySelector(`[data-skdx-calendar-view-cell="${e}"]`)?.focus()})}(o)}}}export{D as useViewGrid};

package/dist/card/Card.vue.d.cts

@@ -1,14 +1,12 @@
 import type { PolymorphicTag } from '../utils/polymorphic.cjs';
 /**
- * Root container for a card layout: renders a `<div>` or custom element with
- * no shared state. Accepts `title`, `description`, `media`, and `footer` props
- * for auto-derived entries, or use slots for manual composition with
- * `CardHeader`, `CardContent`, and `CardFooter`.
+ * Root container for a card layout, rendering a `<div>` or custom element
+ * with header, media, and footer derived from props or slots.
  */
 type __VLS_Props = {
     /**
-     * Element name to render instead of the default `<div>`, from the
-     * library's tag allowlist. Takes a tag name only, never a component.
+     * Element name to render instead of the default `<div>`, taking a tag
+     * name from the library's allowlist rather than a component.
      * @default 'div'
      */
     as?: PolymorphicTag;
@@ -17,12 +15,10 @@ type __VLS_Props = {
      * derived `SkdxCardHeader`.
      * @default undefined — no derived header from this half.
      */
-    title?: string;
+    title?: string | undefined;
     /**
-     * Which heading element the derived title renders, h1 through h6. A card
-     * is placed by its consumer, not by this library, so the level that fits
-     * every document outline does not exist: the default assumes an `<h2>`
-     * above it, and under an `<h4>` the correct value is `5`.
+     * Which heading element the derived title renders, h1 through h6, to
+     * match the surrounding document outline.
      * @default 3
      */
     headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
@@ -31,7 +27,22 @@ type __VLS_Props = {
      * `SkdxCardDescription` inside the same derived header.
      * @default undefined — no derived description.
      */
-    description?: string;
+    description?: string | undefined;
+    /**
+     * How far the skin lifts the card off the page, reflected as `data-elevation`.
+     * @default undefined — falls back to a `data-elevation` attribute.
+     */
+    elevation?: 'raised' | (string & {}) | undefined;
+    /**
+     * Whether the skin gives the card hover and focus affordances, as `data-interactive`.
+     * @default undefined — falls back to a `data-interactive` attribute.
+     */
+    interactive?: boolean | undefined;
+    /**
+     * Marks the card as the chosen one of a set, as a bare `data-selected`.
+     * @default undefined — falls back to a `data-selected` attribute.
+     */
+    selected?: boolean | undefined;
 };
 declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
@@ -50,10 +61,13 @@ type __VLS_Slots = {} & {
     footer?: (props: typeof __VLS_21) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    title: string;
+    title: string | undefined;
     as: PolymorphicTag;
-    description: string;
+    selected: boolean | undefined;
+    description: string | undefined;
     headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    elevation: "raised" | (string & {}) | undefined;
+    interactive: boolean | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/card/Card.vue.d.ts

@@ -1,14 +1,12 @@
 import type { PolymorphicTag } from '../utils/polymorphic.js';
 /**
- * Root container for a card layout: renders a `<div>` or custom element with
- * no shared state. Accepts `title`, `description`, `media`, and `footer` props
- * for auto-derived entries, or use slots for manual composition with
- * `CardHeader`, `CardContent`, and `CardFooter`.
+ * Root container for a card layout, rendering a `<div>` or custom element
+ * with header, media, and footer derived from props or slots.
  */
 type __VLS_Props = {
     /**
-     * Element name to render instead of the default `<div>`, from the
-     * library's tag allowlist. Takes a tag name only, never a component.
+     * Element name to render instead of the default `<div>`, taking a tag
+     * name from the library's allowlist rather than a component.
      * @default 'div'
      */
     as?: PolymorphicTag;
@@ -17,12 +15,10 @@ type __VLS_Props = {
      * derived `SkdxCardHeader`.
      * @default undefined — no derived header from this half.
      */
-    title?: string;
+    title?: string | undefined;
     /**
-     * Which heading element the derived title renders, h1 through h6. A card
-     * is placed by its consumer, not by this library, so the level that fits
-     * every document outline does not exist: the default assumes an `<h2>`
-     * above it, and under an `<h4>` the correct value is `5`.
+     * Which heading element the derived title renders, h1 through h6, to
+     * match the surrounding document outline.
      * @default 3
      */
     headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
@@ -31,7 +27,22 @@ type __VLS_Props = {
      * `SkdxCardDescription` inside the same derived header.
      * @default undefined — no derived description.
      */
-    description?: string;
+    description?: string | undefined;
+    /**
+     * How far the skin lifts the card off the page, reflected as `data-elevation`.
+     * @default undefined — falls back to a `data-elevation` attribute.
+     */
+    elevation?: 'raised' | (string & {}) | undefined;
+    /**
+     * Whether the skin gives the card hover and focus affordances, as `data-interactive`.
+     * @default undefined — falls back to a `data-interactive` attribute.
+     */
+    interactive?: boolean | undefined;
+    /**
+     * Marks the card as the chosen one of a set, as a bare `data-selected`.
+     * @default undefined — falls back to a `data-selected` attribute.
+     */
+    selected?: boolean | undefined;
 };
 declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
@@ -50,10 +61,13 @@ type __VLS_Slots = {} & {
     footer?: (props: typeof __VLS_21) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    title: string;
+    title: string | undefined;
     as: PolymorphicTag;
-    description: string;
+    selected: boolean | undefined;
+    description: string | undefined;
     headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+    elevation: "raised" | (string & {}) | undefined;
+    interactive: boolean | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/card/Card.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const d=require("./CardAnatomy.vue.cjs");let e=require("vue");var i=(0,e.defineComponent)({__name:"Card",props:{as:{default:"div"},title:{default:void 0},headingLevel:{default:3},description:{default:void 0}},setup(o){return(t,n)=>((0,e.openBlock)(),(0,e.createBlock)((0,e.resolveDynamicComponent)(o.as),{class:"skdx-card","data-part":"root","data-skdx-component":"card"},{default:(0,e.withCtx)(()=>[(0,e.createVNode)(d.default,{title:o.title,description:o.description,"heading-level":o.headingLevel},(0,e.createSlots)({default:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"default")]),_:2},[t.$slots.media?{name:"media",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"media")]),key:"0"}:void 0,t.$slots.header?{name:"header",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"header")]),key:"1"}:void 0,t.$slots.title?{name:"title",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"title")]),key:"2"}:void 0,t.$slots.description?{name:"description",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"description")]),key:"3"}:void 0,t.$slots.content?{name:"content",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"content")]),key:"4"}:void 0,t.$slots.footer?{name:"footer",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"footer")]),key:"5"}:void 0]),1032,["title","description","heading-level"])]),_:3}))}});exports.default=i;
+const i=require("../utils/appearance.cjs"),o=require("./CardAnatomy.vue.cjs");let e=require("vue");var n=(0,e.defineComponent)({inheritAttrs:!1,__name:"Card",props:{as:{default:"div"},title:{default:void 0},headingLevel:{default:3},description:{default:void 0},elevation:{default:void 0},interactive:{type:Boolean,default:void 0},selected:{type:Boolean,default:void 0}},setup(a){return(t,d)=>((0,e.openBlock)(),(0,e.createBlock)((0,e.resolveDynamicComponent)(a.as),(0,e.mergeProps)({class:"skdx-card","data-part":"root","data-skdx-component":"card"},{...t.$attrs,...(0,e.unref)(i.appearanceAttrs)({elevation:a.elevation,interactive:a.interactive,selected:a.selected},t.$attrs)}),{default:(0,e.withCtx)(()=>[(0,e.createVNode)(o.default,{title:a.title,description:a.description,"heading-level":a.headingLevel},(0,e.createSlots)({default:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"default")]),_:2},[t.$slots.media?{name:"media",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"media")]),key:"0"}:void 0,t.$slots.header?{name:"header",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"header")]),key:"1"}:void 0,t.$slots.title?{name:"title",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"title")]),key:"2"}:void 0,t.$slots.description?{name:"description",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"description")]),key:"3"}:void 0,t.$slots.content?{name:"content",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"content")]),key:"4"}:void 0,t.$slots.footer?{name:"footer",fn:(0,e.withCtx)(()=>[(0,e.renderSlot)(t.$slots,"footer")]),key:"5"}:void 0]),1032,["title","description","heading-level"])]),_:3},16))}});exports.default=n;