@skdx/vue 0.26.0 → 0.28.0

package/dist/calendar/dateMath.js

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

package/dist/calendar/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./locale.cjs"),a=require("./dateMath.cjs"),r=require("./Calendar.vue.cjs"),t=require("./CalendarHeader.vue.cjs"),l=require("./CalendarHeading.vue.cjs"),d=require("./CalendarPreviousButton.vue.cjs"),n=require("./CalendarNextButton.vue.cjs"),i=require("./CalendarGrid.vue.cjs"),o=require("./CalendarRow.vue.cjs"),u=require("./CalendarWeekDay.vue.cjs"),s=require("./CalendarGridHead.vue.cjs"),c=require("./CalendarCell.vue.cjs"),q=require("./CalendarGridBody.vue.cjs");exports.SkdxCalendar=r.default;exports.SkdxCalendarCell=c.default;exports.SkdxCalendarGrid=i.default;exports.SkdxCalendarGridBody=q.default;exports.SkdxCalendarGridHead=s.default;exports.SkdxCalendarHeader=t.default;exports.SkdxCalendarHeading=l.default;exports.SkdxCalendarNextButton=n.default;exports.SkdxCalendarPreviousButton=d.default;exports.SkdxCalendarRow=o.default;exports.SkdxCalendarWeekDay=u.default;exports.clearLocaleNameCache=e.clearLocaleNameCache;exports.emptySelection=a.emptySelection;exports.formatDateLabel=e.formatDateLabel;exports.formatMonthLabel=e.formatMonthLabel;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("./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

@@ -1,17 +1,7 @@
 export { default as SkdxCalendar } from './Calendar.vue.cjs';
-export { default as SkdxCalendarHeader } from './CalendarHeader.vue.cjs';
-export { default as SkdxCalendarHeading } from './CalendarHeading.vue.cjs';
-export { default as SkdxCalendarPreviousButton } from './CalendarPreviousButton.vue.cjs';
-export { default as SkdxCalendarNextButton } from './CalendarNextButton.vue.cjs';
-export { default as SkdxCalendarGrid } from './CalendarGrid.vue.cjs';
-export { default as SkdxCalendarGridHead } from './CalendarGridHead.vue.cjs';
-export { default as SkdxCalendarWeekDay } from './CalendarWeekDay.vue.cjs';
-export { default as SkdxCalendarGridBody } from './CalendarGridBody.vue.cjs';
-export { default as SkdxCalendarRow } from './CalendarRow.vue.cjs';
-export { default as SkdxCalendarCell } from './CalendarCell.vue.cjs';
 export type { CalendarDay } from './context.cjs';
-export { getVisibleWeeks } from './dateMath.cjs';
-export { emptySelection, isDateRange, isDateSelected, nextSelection, rangePositionOf } from './dateMath.cjs';
-export type { CalendarSelectionMode, CalendarValue, DateRange, RangePosition } from './dateMath.cjs';
-export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from './locale.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';

package/dist/calendar/index.d.ts

@@ -1,17 +1,7 @@
 export { default as SkdxCalendar } from './Calendar.vue.js';
-export { default as SkdxCalendarHeader } from './CalendarHeader.vue.js';
-export { default as SkdxCalendarHeading } from './CalendarHeading.vue.js';
-export { default as SkdxCalendarPreviousButton } from './CalendarPreviousButton.vue.js';
-export { default as SkdxCalendarNextButton } from './CalendarNextButton.vue.js';
-export { default as SkdxCalendarGrid } from './CalendarGrid.vue.js';
-export { default as SkdxCalendarGridHead } from './CalendarGridHead.vue.js';
-export { default as SkdxCalendarWeekDay } from './CalendarWeekDay.vue.js';
-export { default as SkdxCalendarGridBody } from './CalendarGridBody.vue.js';
-export { default as SkdxCalendarRow } from './CalendarRow.vue.js';
-export { default as SkdxCalendarCell } from './CalendarCell.vue.js';
 export type { CalendarDay } from './context.js';
-export { getVisibleWeeks } from './dateMath.js';
-export { emptySelection, isDateRange, isDateSelected, nextSelection, rangePositionOf } from './dateMath.js';
-export type { CalendarSelectionMode, CalendarValue, DateRange, RangePosition } from './dateMath.js';
-export { clearLocaleNameCache, formatDateLabel, formatMonthLabel, getLocaleWeekStartsOn, getMonthNames, getWeekDayNames, resolveLocale, } from './locale.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';

package/dist/calendar/index.js

@@ -1 +1 @@
-import{clearLocaleNameCache as a,formatDateLabel as e,formatMonthLabel as r,getLocaleWeekStartsOn as s,getMonthNames as t,getWeekDayNames as o,resolveLocale as d}from"./locale.js";import{emptySelection as l,getVisibleWeeks as n,isDateRange as i,isDateSelected as m,nextSelection as C,rangePositionOf as f}from"./dateMath.js";import k from"./Calendar.vue.js";import S from"./CalendarHeader.vue.js";import c from"./CalendarHeading.vue.js";import u from"./CalendarPreviousButton.vue.js";import p from"./CalendarNextButton.vue.js";import x from"./CalendarGrid.vue.js";import v from"./CalendarRow.vue.js";import g from"./CalendarWeekDay.vue.js";import j from"./CalendarGridHead.vue.js";import D from"./CalendarCell.vue.js";import L from"./CalendarGridBody.vue.js";export{k as SkdxCalendar,D as SkdxCalendarCell,x as SkdxCalendarGrid,L as SkdxCalendarGridBody,j as SkdxCalendarGridHead,S as SkdxCalendarHeader,c as SkdxCalendarHeading,p as SkdxCalendarNextButton,u as SkdxCalendarPreviousButton,v as SkdxCalendarRow,g as SkdxCalendarWeekDay,a as clearLocaleNameCache,l as emptySelection,e as formatDateLabel,r as formatMonthLabel,s as getLocaleWeekStartsOn,t as getMonthNames,n as getVisibleWeeks,o as getWeekDayNames,i as isDateRange,m as isDateSelected,C as nextSelection,f as rangePositionOf,d 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 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};

package/dist/calendar/locale.cjs

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

package/dist/calendar/locale.d.cts

@@ -1,14 +1,10 @@
 /**
- * Locale-derived month and weekday names for `SkdxCalendar`, built entirely
- * on `Intl` — no bundled name tables, no date library, no new dependency.
- *
- * Every framework package carries its own copy of these helpers (the same way
- * each carries its own `dateMath`), so a consumer never pays for a shared
- * runtime package just to render a month heading.
+ * Locale-derived month and weekday names using `Intl` only.
+ * No bundled tables, no date library.
  */
 /** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
 export type NameWidth = 'narrow' | 'short' | 'long';
-/** The runtime's own locale, used whenever `locale` is omitted — matches what `toLocaleDateString()` would pick. */
+/** Runtime's locale when locale omitted; matches toLocaleDateString default. */
 export declare function resolveLocale(locale?: string): string;
 /**
  * The twelve month names of `locale`, January first, at the requested width.
@@ -30,29 +26,24 @@ export declare function getMonthNames(locale?: string, width?: NameWidth): strin
  */
 export declare function getWeekDayNames(locale?: string, weekStartsOn?: number, width?: NameWidth): string[];
 /**
- * The first day of the week `locale` uses (`0` = Sunday … `6` = Saturday),
- * read from `Intl.Locale`'s week info where the engine exposes it.
- *
- * Falls back to `0` (Sunday) on engines without `getWeekInfo`/`weekInfo`
- * — Firefox still lacks it as of 2026.
+ * First day of week for locale (0 = Sunday … 6 = Saturday).
+ * Falls back to 0 on engines without Intl.Locale.getWeekInfo.
  */
 export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
 export declare function formatMonthLabel(month: Date, locale?: string): string;
+/**
+ * Year formatted for locale (e.g. '2026', '٢٠٢٦' in ar-EG).
+ * Uses Intl.NumberFormat with grouping off to show locale digits.
+ */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
 /** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
 export declare function formatDateLabel(date: Date, locale?: string): string;
 /**
- * Empties the module-level memo of formatted month and weekday name
- * lists, so the next `getMonthNames`/`getWeekDayNames` rebuilds its
- * `Intl.DateTimeFormat` from scratch.
- *
- * An escape hatch for tests, not an application concern. The cache is keyed by
- * locale *and* width and locale name tables do not change under a running
- * process, so nothing in an app can stale it. What can is a test that stubs
- * `Intl` or the runtime's resolved default locale between cases: entries built
- * under the previous stub survive into the next one and the assertion reads
- * names from the wrong locale. Call this between such cases.
- *
+ * Clears name cache so next getMonthNames/getWeekDayNames rebuilds from Intl.
+ * Test escape hatch only; locale cache never stales in running apps.
  * @internal
  */
 export declare function clearLocaleNameCache(): void;

package/dist/calendar/locale.d.ts

@@ -1,14 +1,10 @@
 /**
- * Locale-derived month and weekday names for `SkdxCalendar`, built entirely
- * on `Intl` — no bundled name tables, no date library, no new dependency.
- *
- * Every framework package carries its own copy of these helpers (the same way
- * each carries its own `dateMath`), so a consumer never pays for a shared
- * runtime package just to render a month heading.
+ * Locale-derived month and weekday names using `Intl` only.
+ * No bundled tables, no date library.
  */
 /** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
 export type NameWidth = 'narrow' | 'short' | 'long';
-/** The runtime's own locale, used whenever `locale` is omitted — matches what `toLocaleDateString()` would pick. */
+/** Runtime's locale when locale omitted; matches toLocaleDateString default. */
 export declare function resolveLocale(locale?: string): string;
 /**
  * The twelve month names of `locale`, January first, at the requested width.
@@ -30,29 +26,24 @@ export declare function getMonthNames(locale?: string, width?: NameWidth): strin
  */
 export declare function getWeekDayNames(locale?: string, weekStartsOn?: number, width?: NameWidth): string[];
 /**
- * The first day of the week `locale` uses (`0` = Sunday … `6` = Saturday),
- * read from `Intl.Locale`'s week info where the engine exposes it.
- *
- * Falls back to `0` (Sunday) on engines without `getWeekInfo`/`weekInfo`
- * — Firefox still lacks it as of 2026.
+ * First day of week for locale (0 = Sunday … 6 = Saturday).
+ * Falls back to 0 on engines without Intl.Locale.getWeekInfo.
  */
 export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
 export declare function formatMonthLabel(month: Date, locale?: string): string;
+/**
+ * Year formatted for locale (e.g. '2026', '٢٠٢٦' in ar-EG).
+ * Uses Intl.NumberFormat with grouping off to show locale digits.
+ */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
 /** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
 export declare function formatDateLabel(date: Date, locale?: string): string;
 /**
- * Empties the module-level memo of formatted month and weekday name
- * lists, so the next `getMonthNames`/`getWeekDayNames` rebuilds its
- * `Intl.DateTimeFormat` from scratch.
- *
- * An escape hatch for tests, not an application concern. The cache is keyed by
- * locale *and* width and locale name tables do not change under a running
- * process, so nothing in an app can stale it. What can is a test that stubs
- * `Intl` or the runtime's resolved default locale between cases: entries built
- * under the previous stub survive into the next one and the assertion reads
- * names from the wrong locale. Call this between such cases.
- *
+ * Clears name cache so next getMonthNames/getWeekDayNames rebuilds from Intl.
+ * Test escape hatch only; locale cache never stales in running apps.
  * @internal
  */
 export declare function clearLocaleNameCache(): void;

package/dist/calendar/locale.js

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

package/dist/calendar/primitives.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./CalendarGrid.vue.cjs"),r=require("./CalendarCell.vue.cjs"),a=require("./CalendarRow.vue.cjs"),d=require("./CalendarWeekNumber.vue.cjs"),u=require("./CalendarGridBody.vue.cjs"),n=require("./CalendarWeekDay.vue.cjs"),l=require("./CalendarWeekNumberHeader.vue.cjs"),i=require("./CalendarGridHead.vue.cjs"),t=require("./CalendarHeader.vue.cjs"),C=require("./CalendarHeading.vue.cjs"),o=require("./CalendarMonthGrid.vue.cjs"),q=require("./CalendarNextButton.vue.cjs"),k=require("./CalendarPreviousButton.vue.cjs"),s=require("./CalendarYearGrid.vue.cjs"),x=require("./Calendar.vue.cjs");exports.SkdxCalendar=x.default;exports.SkdxCalendarCell=r.default;exports.SkdxCalendarGrid=e.default;exports.SkdxCalendarGridBody=u.default;exports.SkdxCalendarGridHead=i.default;exports.SkdxCalendarHeader=t.default;exports.SkdxCalendarHeading=C.default;exports.SkdxCalendarMonthGrid=o.default;exports.SkdxCalendarNextButton=q.default;exports.SkdxCalendarPreviousButton=k.default;exports.SkdxCalendarRow=a.default;exports.SkdxCalendarWeekDay=n.default;exports.SkdxCalendarWeekNumber=d.default;exports.SkdxCalendarWeekNumberHeader=l.default;exports.SkdxCalendarYearGrid=s.default;

package/dist/calendar/primitives.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Primitives for `SkdxCalendar` — composable building blocks.
+ * Use these when you need a custom layout beyond the derived recipe.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCalendar, SkdxCalendarGrid, SkdxCalendarGridBody, SkdxCalendarGridHead, SkdxCalendarHeader, SkdxCalendarHeading, SkdxCalendarNextButton, SkdxCalendarPreviousButton } from '@skdx/vue/primitives/calendar';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCalendar v-model="date">
+ *     <SkdxCalendarHeader>
+ *       <SkdxCalendarPreviousButton>‹</SkdxCalendarPreviousButton>
+ *       <SkdxCalendarHeading />
+ *       <SkdxCalendarNextButton>›</SkdxCalendarNextButton>
+ *     </SkdxCalendarHeader>
+ *     <SkdxCalendarGrid>
+ *       <SkdxCalendarGridHead />
+ *       <SkdxCalendarGridBody />
+ *     </SkdxCalendarGrid>
+ *   </SkdxCalendar>
+ * </template>
+ * ```
+ */
+export { default as SkdxCalendar } from './Calendar.vue.cjs';
+export { default as SkdxCalendarCell } from './CalendarCell.vue.cjs';
+export { default as SkdxCalendarGrid } from './CalendarGrid.vue.cjs';
+export { default as SkdxCalendarGridBody } from './CalendarGridBody.vue.cjs';
+export { default as SkdxCalendarGridHead } from './CalendarGridHead.vue.cjs';
+export { default as SkdxCalendarHeader } from './CalendarHeader.vue.cjs';
+export { default as SkdxCalendarHeading } from './CalendarHeading.vue.cjs';
+export { default as SkdxCalendarMonthGrid } from './CalendarMonthGrid.vue.cjs';
+export { default as SkdxCalendarNextButton } from './CalendarNextButton.vue.cjs';
+export { default as SkdxCalendarPreviousButton } from './CalendarPreviousButton.vue.cjs';
+export { default as SkdxCalendarRow } from './CalendarRow.vue.cjs';
+export { default as SkdxCalendarWeekDay } from './CalendarWeekDay.vue.cjs';
+export { default as SkdxCalendarWeekNumber } from './CalendarWeekNumber.vue.cjs';
+export { default as SkdxCalendarWeekNumberHeader } from './CalendarWeekNumberHeader.vue.cjs';
+export { default as SkdxCalendarYearGrid } from './CalendarYearGrid.vue.cjs';

package/dist/calendar/primitives.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Primitives for `SkdxCalendar` — composable building blocks.
+ * Use these when you need a custom layout beyond the derived recipe.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { SkdxCalendar, SkdxCalendarGrid, SkdxCalendarGridBody, SkdxCalendarGridHead, SkdxCalendarHeader, SkdxCalendarHeading, SkdxCalendarNextButton, SkdxCalendarPreviousButton } from '@skdx/vue/primitives/calendar';
+ * </script>
+ *
+ * <template>
+ *   <SkdxCalendar v-model="date">
+ *     <SkdxCalendarHeader>
+ *       <SkdxCalendarPreviousButton>‹</SkdxCalendarPreviousButton>
+ *       <SkdxCalendarHeading />
+ *       <SkdxCalendarNextButton>›</SkdxCalendarNextButton>
+ *     </SkdxCalendarHeader>
+ *     <SkdxCalendarGrid>
+ *       <SkdxCalendarGridHead />
+ *       <SkdxCalendarGridBody />
+ *     </SkdxCalendarGrid>
+ *   </SkdxCalendar>
+ * </template>
+ * ```
+ */
+export { default as SkdxCalendar } from './Calendar.vue.js';
+export { default as SkdxCalendarCell } from './CalendarCell.vue.js';
+export { default as SkdxCalendarGrid } from './CalendarGrid.vue.js';
+export { default as SkdxCalendarGridBody } from './CalendarGridBody.vue.js';
+export { default as SkdxCalendarGridHead } from './CalendarGridHead.vue.js';
+export { default as SkdxCalendarHeader } from './CalendarHeader.vue.js';
+export { default as SkdxCalendarHeading } from './CalendarHeading.vue.js';
+export { default as SkdxCalendarMonthGrid } from './CalendarMonthGrid.vue.js';
+export { default as SkdxCalendarNextButton } from './CalendarNextButton.vue.js';
+export { default as SkdxCalendarPreviousButton } from './CalendarPreviousButton.vue.js';
+export { default as SkdxCalendarRow } from './CalendarRow.vue.js';
+export { default as SkdxCalendarWeekDay } from './CalendarWeekDay.vue.js';
+export { default as SkdxCalendarWeekNumber } from './CalendarWeekNumber.vue.js';
+export { default as SkdxCalendarWeekNumberHeader } from './CalendarWeekNumberHeader.vue.js';
+export { default as SkdxCalendarYearGrid } from './CalendarYearGrid.vue.js';

package/dist/calendar/primitives.js

@@ -0,0 +1 @@
+import a from"./CalendarGrid.vue.js";import r from"./CalendarCell.vue.js";import e from"./CalendarRow.vue.js";import d from"./CalendarWeekNumber.vue.js";import o from"./CalendarGridBody.vue.js";import n from"./CalendarWeekDay.vue.js";import l from"./CalendarWeekNumberHeader.vue.js";import m from"./CalendarGridHead.vue.js";import s from"./CalendarHeader.vue.js";import C from"./CalendarHeading.vue.js";import i from"./CalendarMonthGrid.vue.js";import t from"./CalendarNextButton.vue.js";import u from"./CalendarPreviousButton.vue.js";import k from"./CalendarYearGrid.vue.js";import x from"./Calendar.vue.js";export{x as SkdxCalendar,r as SkdxCalendarCell,a as SkdxCalendarGrid,o as SkdxCalendarGridBody,m as SkdxCalendarGridHead,s as SkdxCalendarHeader,C as SkdxCalendarHeading,i as SkdxCalendarMonthGrid,t as SkdxCalendarNextButton,u as SkdxCalendarPreviousButton,e as SkdxCalendarRow,n as SkdxCalendarWeekDay,d as SkdxCalendarWeekNumber,l as SkdxCalendarWeekNumberHeader,k as SkdxCalendarYearGrid};

package/dist/calendar/useViewGrid.cjs

@@ -0,0 +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=$;

package/dist/calendar/useViewGrid.d.cts

@@ -0,0 +1,38 @@
+import { type ComputedRef } from 'vue';
+import { type CalendarContext } from './context.cjs';
+/** @internal Month or year cell: navigation target, display text, and state. */
+export interface ViewCell {
+    /** Projection of focusedDate onto this unit; navigation target. */
+    date: Date;
+    /** data-skdx-calendar-view-cell hook value for roving focus. */
+    key: string;
+    /** Display text: abbreviated month name or year. */
+    text: string;
+    /** Spoken label: full month-and-year or year. */
+    label: string;
+    /** No selectable date in this month/year (min/max/disabled filters all). */
+    refused: boolean;
+    /** Selection anchor falls in this unit. */
+    selected: boolean;
+    /** Calendar's today falls in this unit. */
+    today: boolean;
+}
+/** @internal Shared grid model for view SFCs. */
+export interface ViewGridModel {
+    context: CalendarContext;
+    /** Page cells, four per row, projected and labeled. */
+    cells: ComputedRef<ViewCell[]>;
+    /** Index of focused cell (focusedDate projected onto unit). */
+    focusedIndex: ComputedRef<number>;
+    /** Grid accessible name: focused year or twenty-year page. */
+    gridLabel: ComputedRef<string>;
+    /** Rows of four for template iteration. */
+    rows: ComputedRef<ViewCell[][]>;
+    handleKeydown(event: KeyboardEvent): void;
+}
+/**
+ * @internal Shared grid model for month and year views (unit-agnostic).
+ * @param unit 'month' for 12-month grid or 'year' for 20-year grid.
+ * @param component Calling SFC name for error message.
+ */
+export declare function useViewGrid(unit: 'month' | 'year', component: string): ViewGridModel;

package/dist/calendar/useViewGrid.d.ts

@@ -0,0 +1,38 @@
+import { type ComputedRef } from 'vue';
+import { type CalendarContext } from './context.js';
+/** @internal Month or year cell: navigation target, display text, and state. */
+export interface ViewCell {
+    /** Projection of focusedDate onto this unit; navigation target. */
+    date: Date;
+    /** data-skdx-calendar-view-cell hook value for roving focus. */
+    key: string;
+    /** Display text: abbreviated month name or year. */
+    text: string;
+    /** Spoken label: full month-and-year or year. */
+    label: string;
+    /** No selectable date in this month/year (min/max/disabled filters all). */
+    refused: boolean;
+    /** Selection anchor falls in this unit. */
+    selected: boolean;
+    /** Calendar's today falls in this unit. */
+    today: boolean;
+}
+/** @internal Shared grid model for view SFCs. */
+export interface ViewGridModel {
+    context: CalendarContext;
+    /** Page cells, four per row, projected and labeled. */
+    cells: ComputedRef<ViewCell[]>;
+    /** Index of focused cell (focusedDate projected onto unit). */
+    focusedIndex: ComputedRef<number>;
+    /** Grid accessible name: focused year or twenty-year page. */
+    gridLabel: ComputedRef<string>;
+    /** Rows of four for template iteration. */
+    rows: ComputedRef<ViewCell[][]>;
+    handleKeydown(event: KeyboardEvent): void;
+}
+/**
+ * @internal Shared grid model for month and year views (unit-agnostic).
+ * @param unit 'month' for 12-month grid or 'year' for 20-year grid.
+ * @param component Calling SFC name for error message.
+ */
+export declare function useViewGrid(unit: 'month' | 'year', component: string): ViewGridModel;

package/dist/calendar/useViewGrid.js

@@ -0,0 +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};

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

@@ -1,14 +1,60 @@
+import type { PolymorphicTag } from '../utils/polymorphic.cjs';
 /**
- * The Vue implementation of the shared Card contract (see `@skdx/shared`'s
- * `cardContract`). Root container for a card layout: renders a plain
- * `<div>` with no shared state or context — purely structural.
+ * 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`.
  */
-type __VLS_Props = {};
-declare var __VLS_1: {};
+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.
+     * @default 'div'
+     */
+    as?: PolymorphicTag;
+    /**
+     * The card's heading, rendered as a derived `SkdxCardTitle` inside a
+     * derived `SkdxCardHeader`.
+     * @default undefined — no derived header from this half.
+     */
+    title?: string;
+    /**
+     * 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`.
+     * @default 3
+     */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Supporting text below the title, rendered as a derived
+     * `SkdxCardDescription` inside the same derived header.
+     * @default undefined — no derived description.
+     */
+    description?: string;
+};
+declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    default?: (props: typeof __VLS_9) => any;
+} & {
+    media?: (props: typeof __VLS_11) => any;
+} & {
+    header?: (props: typeof __VLS_13) => any;
+} & {
+    title?: (props: typeof __VLS_15) => any;
+} & {
+    description?: (props: typeof __VLS_17) => any;
+} & {
+    content?: (props: typeof __VLS_19) => any;
+} & {
+    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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, 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;
+    as: PolymorphicTag;
+    description: string;
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+}, {}, {}, {}, 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 & {

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

@@ -1,14 +1,60 @@
+import type { PolymorphicTag } from '../utils/polymorphic.js';
 /**
- * The Vue implementation of the shared Card contract (see `@skdx/shared`'s
- * `cardContract`). Root container for a card layout: renders a plain
- * `<div>` with no shared state or context — purely structural.
+ * 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`.
  */
-type __VLS_Props = {};
-declare var __VLS_1: {};
+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.
+     * @default 'div'
+     */
+    as?: PolymorphicTag;
+    /**
+     * The card's heading, rendered as a derived `SkdxCardTitle` inside a
+     * derived `SkdxCardHeader`.
+     * @default undefined — no derived header from this half.
+     */
+    title?: string;
+    /**
+     * 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`.
+     * @default 3
+     */
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Supporting text below the title, rendered as a derived
+     * `SkdxCardDescription` inside the same derived header.
+     * @default undefined — no derived description.
+     */
+    description?: string;
+};
+declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    default?: (props: typeof __VLS_9) => any;
+} & {
+    media?: (props: typeof __VLS_11) => any;
+} & {
+    header?: (props: typeof __VLS_13) => any;
+} & {
+    title?: (props: typeof __VLS_15) => any;
+} & {
+    description?: (props: typeof __VLS_17) => any;
+} & {
+    content?: (props: typeof __VLS_19) => any;
+} & {
+    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<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, 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;
+    as: PolymorphicTag;
+    description: string;
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+}, {}, {}, {}, 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 & {

package/dist/card/Card.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-let e=require("vue");var r={class:"skdx-card","data-part":"root","data-skdx-component":"card"},a=(0,e.defineComponent)({__name:"Card",setup(d){return(t,_)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",r,[(0,e.renderSlot)(t.$slots,"default")]))}});exports.default=a;
+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;

package/dist/card/Card.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{createElementBlock as a,defineComponent as e,openBlock as t,renderSlot as o}from"vue";var d={class:"skdx-card","data-part":"root","data-skdx-component":"card"},r=/* @__PURE__ */e({__name:"Card",setup:e=>(e,r)=>(t(),a("div",d,[o(e.$slots,"default")]))});export{r as default};
+import e from"./CardAnatomy.vue.js";import{createBlock as t,createSlots as o,createVNode as s,defineComponent as a,openBlock as d,renderSlot as i,resolveDynamicComponent as n,withCtx as l}from"vue";var r=/* @__PURE__ */a({__name:"Card",props:{as:{default:"div"},title:{default:void 0},headingLevel:{default:3},description:{default:void 0}},setup:a=>(r,c)=>(d(),t(n(a.as),{class:"skdx-card","data-part":"root","data-skdx-component":"card"},{default:l(()=>[s(e,{title:a.title,description:a.description,"heading-level":a.headingLevel},o({default:l(()=>[i(r.$slots,"default")]),_:2},[r.$slots.media?{name:"media",fn:l(()=>[i(r.$slots,"media")]),key:"0"}:void 0,r.$slots.header?{name:"header",fn:l(()=>[i(r.$slots,"header")]),key:"1"}:void 0,r.$slots.title?{name:"title",fn:l(()=>[i(r.$slots,"title")]),key:"2"}:void 0,r.$slots.description?{name:"description",fn:l(()=>[i(r.$slots,"description")]),key:"3"}:void 0,r.$slots.content?{name:"content",fn:l(()=>[i(r.$slots,"content")]),key:"4"}:void 0,r.$slots.footer?{name:"footer",fn:l(()=>[i(r.$slots,"footer")]),key:"5"}:void 0]),1032,["title","description","heading-level"])]),_:3}))});export{r as default};

package/dist/card/CardAnatomy.vue.cjs

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