@skdx/vue 0.26.0

package/dist/calendar/dateMath.d.ts

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

package/dist/calendar/dateMath.js

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

package/dist/calendar/index.cjs

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

package/dist/calendar/index.d.cts

@@ -0,0 +1,17 @@
+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 type { NameWidth } from './locale.cjs';

package/dist/calendar/index.d.ts

@@ -0,0 +1,17 @@
+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 type { NameWidth } from './locale.js';

package/dist/calendar/index.js

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

package/dist/calendar/locale.cjs

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

package/dist/calendar/locale.d.cts

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+/** 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. */
+export declare function resolveLocale(locale?: string): string;
+/**
+ * The twelve month names of `locale`, January first, at the requested width.
+ *
+ * @example
+ * ```ts
+ * getMonthNames('fr-FR')[0]; // 'janvier'
+ * ```
+ */
+export declare function getMonthNames(locale?: string, width?: NameWidth): string[];
+/**
+ * The seven weekday names of `locale` at the requested width, rotated so index
+ * `0` is `weekStartsOn` (`0` = Sunday … `6` = Saturday).
+ *
+ * @example
+ * ```ts
+ * getWeekDayNames('en-GB', 1, 'short'); // ['Mon', 'Tue', … 'Sun']
+ * ```
+ */
+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.
+ */
+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;
+/** 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.
+ *
+ * @internal
+ */
+export declare function clearLocaleNameCache(): void;

package/dist/calendar/locale.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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.
+ */
+/** 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. */
+export declare function resolveLocale(locale?: string): string;
+/**
+ * The twelve month names of `locale`, January first, at the requested width.
+ *
+ * @example
+ * ```ts
+ * getMonthNames('fr-FR')[0]; // 'janvier'
+ * ```
+ */
+export declare function getMonthNames(locale?: string, width?: NameWidth): string[];
+/**
+ * The seven weekday names of `locale` at the requested width, rotated so index
+ * `0` is `weekStartsOn` (`0` = Sunday … `6` = Saturday).
+ *
+ * @example
+ * ```ts
+ * getWeekDayNames('en-GB', 1, 'short'); // ['Mon', 'Tue', … 'Sun']
+ * ```
+ */
+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.
+ */
+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;
+/** 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.
+ *
+ * @internal
+ */
+export declare function clearLocaleNameCache(): void;

package/dist/calendar/locale.js

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

package/dist/card/Card.vue.cjs

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

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

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/card/Card.vue.js

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

package/dist/card/Card.vue_vue_type_script_setup_true_lang.cjs

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

package/dist/card/Card.vue_vue_type_script_setup_true_lang.js

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

package/dist/card/CardContent.vue.cjs

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

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

@@ -0,0 +1,17 @@
+/**
+ * A `<SkdxCard>`'s main body. Renders a plain `<div>`, typically placed
+ * between `<SkdxCardHeader>` and `<SkdxCardFooter>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,17 @@
+/**
+ * A `<SkdxCard>`'s main body. Renders a plain `<div>`, typically placed
+ * between `<SkdxCardHeader>` and `<SkdxCardFooter>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/card/CardContent.vue.js

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

package/dist/card/CardContent.vue_vue_type_script_setup_true_lang.cjs

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

package/dist/card/CardContent.vue_vue_type_script_setup_true_lang.js

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

package/dist/card/CardDescription.vue.cjs

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

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

@@ -0,0 +1,17 @@
+/**
+ * Supporting text below a `<SkdxCard>`'s title. Renders a `<p>`, typically
+ * inside `<SkdxCardHeader>` after `<SkdxCardTitle>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,17 @@
+/**
+ * Supporting text below a `<SkdxCard>`'s title. Renders a `<p>`, typically
+ * inside `<SkdxCardHeader>` after `<SkdxCardTitle>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/card/CardDescription.vue.js

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

package/dist/card/CardDescription.vue_vue_type_script_setup_true_lang.cjs

@@ -0,0 +1 @@
+let e=require("vue");var r={class:"skdx-card__description","data-part":"description"},_=(0,e.defineComponent)({__name:"CardDescription",setup(a){return(t,n)=>((0,e.openBlock)(),(0,e.createElementBlock)("p",r,[(0,e.renderSlot)(t.$slots,"default")]))}});exports.default=_;

package/dist/card/CardDescription.vue_vue_type_script_setup_true_lang.js

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

package/dist/card/CardFooter.vue.cjs

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

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

@@ -0,0 +1,17 @@
+/**
+ * Container for actions at the bottom of a `<SkdxCard>`. Renders a plain
+ * `<div>`, typically placed as the last child of `<SkdxCard>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,17 @@
+/**
+ * Container for actions at the bottom of a `<SkdxCard>`. Renders a plain
+ * `<div>`, typically placed as the last child of `<SkdxCard>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/card/CardFooter.vue.js

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

package/dist/card/CardFooter.vue_vue_type_script_setup_true_lang.cjs

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

package/dist/card/CardFooter.vue_vue_type_script_setup_true_lang.js

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

package/dist/card/CardHeader.vue.cjs

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

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

@@ -0,0 +1,17 @@
+/**
+ * Container for a `<SkdxCard>`'s title and description. Renders a plain
+ * `<div>`, typically placed as the first child of `<SkdxCard>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,17 @@
+/**
+ * Container for a `<SkdxCard>`'s title and description. Renders a plain
+ * `<div>`, typically placed as the first child of `<SkdxCard>`.
+ */
+type __VLS_Props = {};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};