vectis-ui 0.1.0 → 0.8.0

package/dist/utils/date.d.ts

@@ -1,19 +1,14 @@
 /**
- * The date arithmetic behind VDatePicker and VDateInput, written as pure functions:
- * they read nothing outside their arguments and change nothing around them.
+ * The date arithmetic behind VDatePicker and VDateInput, as pure functions. One currency
+ * throughout: the ISO `YYYY-MM-DD` string, computed in LOCAL time.
  *
- * The whole module speaks one language, the ISO `YYYY-MM-DD` string, and computes
- * everything in the reader's LOCAL time. Two shortcuts are therefore banned
- * throughout: `new Date('YYYY-MM-DD')`, which the language interprets as UTC and
- * which consequently lands on the previous or the next day depending on the time
- * zone, and `toISOString()`, which formats in UTC for the same reason. `Date`
- * objects exist here only as an intermediate step, built with `new Date(y, m, d)` —
- * local midnight — and turned back into text by concatenation.
+ * Two shortcuts are banned as a result. `new Date('YYYY-MM-DD')` parses as UTC and lands a
+ * day out depending on the zone, and `toISOString()` formats in UTC for the same reason.
+ * `Date` exists here only as an intermediate, built with `new Date(y, m, d)` — local
+ * midnight — and turned back into text by concatenation.
  *
- * The names of months and days come from `Intl`, which is available on the server as
- * well as in the browser. They are formatted from REFERENCE dates pinned to
- * `timeZone: 'UTC'`, so that the resulting label never depends on the time zone of
- * the machine doing the rendering.
+ * Month and day names come from `Intl` on REFERENCE dates pinned to `timeZone: 'UTC'`, so a
+ * label never depends on the rendering machine's zone and the server agrees with the browser.
  */
 /**
  * Tells whether a value is a real `YYYY-MM-DD` date. The shape alone is not enough:
@@ -73,10 +68,18 @@ export declare const isSameISO: (a: string | null, b: string | null) => boolean;
 export declare function clampISO(iso: string, min?: string, max?: string): string;
 /** Whether a date falls inside the allowed interval, each bound being optional. */
 export declare function isWithin(iso: string, min?: string, max?: string): boolean;
+/**
+ * Whether a date may be chosen: inside the bounds, and not one the matcher excludes. It is
+ * the ONE rule behind both a struck-through day in VDatePicker and a typed date VDateInput
+ * refuses, so the two cannot come to disagree about what "unavailable" means.
+ */
+export declare function isDateAllowed(iso: string, min: string | undefined, max: string | undefined, excluded: (iso: string) => boolean): boolean;
 /** One square of a month grid. */
 export interface MonthCell {
     /** The day it stands for, as an ISO `YYYY-MM-DD` string. */
     iso: string;
+    /** The day of the month, carried so a caller does not parse back what was just formatted. */
+    day: number;
     /**
      * Which side of the displayed month this day belongs to when it is not part of it,
      * and `null` when it is.
@@ -90,14 +93,24 @@ export interface MonthCell {
  * by a row. `firstDayOfWeek` runs from 0 for Sunday to 6 for Saturday.
  */
 export declare function buildMonthGrid(year: number, month0: number, firstDayOfWeek: number): MonthCell[];
+/**
+ * The day the week starts on in a given locale, from 0 for Sunday to 6 for Saturday
+ * — Sunday in the United States, Monday in most of Europe, Saturday in much of the
+ * Middle East. It comes from `Intl.Locale`, whose own numbering runs from 1 for
+ * Monday to 7 for Sunday.
+ *
+ * That part of `Intl` is not everywhere (some Node builds lack it), so the answer
+ * falls back to Monday when it is missing. A component can always override the
+ * result with its `firstDayOfWeek` prop.
+ */
 export declare function firstDayOfWeekFor(locale: string): number;
 /**
  * The names of the seven days, starting from `firstDayOfWeek` so the list can be
  * dropped straight into a calendar header.
  */
-export declare function weekdayNames(locale: string, firstDayOfWeek: number, weekday?: 'narrow' | 'short' | 'long'): string[];
-/** The names of the twelve months, in January-to-December order. */
-export declare function monthNames(locale: string, month?: 'long' | 'short'): string[];
+export declare function weekdayNames(locale: string, firstDayOfWeek: number, weekday?: 'short' | 'long'): string[];
+/** The full names of the twelve months, in January-to-December order. */
+export declare function monthNames(locale: string): string[];
 /**
  * Month names shortened for the picker's narrow cells: a name of four characters or
  * fewer is kept whole ("May", "June", "July"), a longer one is cut to three
@@ -106,14 +119,14 @@ export declare function monthNames(locale: string, month?: 'long' | 'short'): st
  * one character and is never cut in half.
  */
 export declare function monthNamesCompact(locale: string): string[];
-/** The name of one month, 0 being January. */
-export declare function monthName(locale: string, month0: number, month?: 'long' | 'short'): string;
+/** The full name of one month, 0 being January. */
+export declare function monthName(locale: string, month0: number): string;
 /**
  * A date written out for the reader, in the conventions of their locale — this is
  * what VDateInput shows in its field. An unparsable date yields an empty string
  * rather than a broken one.
  */
-export declare function formatDisplay(iso: string, locale: string, options: Intl.DateTimeFormatOptions): string;
+export declare function formatDateDisplay(iso: string, locale: string, options: Intl.DateTimeFormatOptions): string;
 /**
  * A period written out for the reader. `Intl`'s own `formatRange` is what factors
  * out the parts the two dates share, giving "19–26 June 2026" rather than the two
@@ -135,6 +148,16 @@ export interface DateMask {
     /** How many digits the complete mask holds, which is always 8. */
     size: number;
 }
+/**
+ * Works out how a date is typed in a given locale, by formatting a known date and
+ * looking at what came out.
+ *
+ * The calendar and the numbering system are FORCED to Gregorian and Latin digits.
+ * Without that, `fa-IR` answers with a Persian year (1400 rather than 2021) and
+ * `ar-EG` with Arabic-Indic digits — two things a numeric field could neither
+ * display nor read back. An invalid locale throws, and the answer then falls back to
+ * day/month/year separated by "/".
+ */
 export declare function dateMaskFor(locale: string): DateMask;
 /**
  * Lays a run of digits out as masked text. The separator appears AS SOON AS the field

package/dist/utils/date.js

@@ -1,113 +1,114 @@
 import { digitsOf as e, pad2 as t } from "./text.js";
+import { memo as n } from "./memo.js";
 //#region src/utils/date.ts
-var n = /^\d{4}-\d{2}-\d{2}$/;
-function r(e) {
-	if (typeof e != "string" || !n.test(e)) return !1;
-	let t = i(e);
-	return t !== null && a(t) === e;
-}
+var r = /^\d{4}-\d{2}-\d{2}$/;
 function i(e) {
-	if (typeof e != "string" || !n.test(e)) return null;
-	let t = e.split("-"), r = new Date(Number(t[0]), Number(t[1]) - 1, Number(t[2]));
-	return Number.isNaN(r.getTime()) ? null : r;
+	if (typeof e != "string" || !r.test(e)) return !1;
+	let t = a(e);
+	return t !== null && o(t) === e;
 }
 function a(e) {
-	return `${e.getFullYear()}-${t(e.getMonth() + 1)}-${t(e.getDate())}`;
+	if (typeof e != "string" || !r.test(e)) return null;
+	let t = e.split("-"), n = new Date(Number(t[0]), Number(t[1]) - 1, Number(t[2]));
+	return Number.isNaN(n.getTime()) ? null : n;
 }
-function o(e, t, n) {
-	return a(new Date(e, t, n));
+function o(e) {
+	return `${e.getFullYear()}-${t(e.getMonth() + 1)}-${t(e.getDate())}`;
 }
-function s(e, t) {
-	let n = i(e);
-	return n ? (n.setDate(n.getDate() + t), a(n)) : e;
+function s(e, t, n) {
+	return o(new Date(e, t, n));
 }
 function c(e, t) {
-	let n = i(e);
+	let n = a(e);
+	return n ? (n.setDate(n.getDate() + t), o(n)) : e;
+}
+function l(e, t) {
+	let n = a(e);
 	if (!n) return e;
 	let r = n.getDate();
-	return n.setDate(1), n.setMonth(n.getMonth() + t), n.setDate(Math.min(r, l(n.getFullYear(), n.getMonth()))), a(n);
+	return n.setDate(1), n.setMonth(n.getMonth() + t), n.setDate(Math.min(r, u(n.getFullYear(), n.getMonth()))), o(n);
 }
-function l(e, t) {
+function u(e, t) {
 	return new Date(e, t + 1, 0).getDate();
 }
-function u(e, t) {
+function d(e, t) {
 	return e < t ? -1 : +(e > t);
 }
-var d = (e, t) => !!e && e === t;
-function f(e, t, n) {
-	return t && u(e, t) < 0 ? t : n && u(e, n) > 0 ? n : e;
-}
+var f = (e, t) => !!e && e === t;
 function p(e, t, n) {
-	return !(t && u(e, t) < 0 || n && u(e, n) > 0);
+	return t && d(e, t) < 0 ? t : n && d(e, n) > 0 ? n : e;
 }
 function m(e, t, n) {
-	let r = new Date(e, t, 1), i = (r.getDay() - n + 7) % 7, o = [], s = new Date(e, t, 1 - i);
+	return !(t && d(e, t) < 0 || n && d(e, n) > 0);
+}
+function h(e, t, n, r) {
+	return m(e, t, n) && !r(e);
+}
+function g(e, t, n) {
+	let r = new Date(e, t, 1), i = (r.getDay() - n + 7) % 7, a = [];
 	for (let n = 0; n < 42; n++) {
-		let i = new Date(s.getFullYear(), s.getMonth(), s.getDate() + n), c = i.getMonth() === t && i.getFullYear() === e ? null : u(a(i), a(r)) < 0 ? "prev" : "next";
-		o.push({
-			iso: a(i),
+		let s = new Date(e, t, 1 - i + n), c = s.getMonth() === t && s.getFullYear() === e ? null : s < r ? "prev" : "next";
+		a.push({
+			iso: o(s),
+			day: s.getDate(),
 			adjacent: c
 		});
 	}
-	return o;
+	return a;
 }
-var h = /* @__PURE__ */ new Map();
-function g(e) {
-	let t = h.get(e);
-	if (t !== void 0) return t;
-	let n = _(e);
-	return h.set(e, n), n;
+var _ = /* @__PURE__ */ new Map();
+function v(e) {
+	return n(_, e, () => y(e));
 }
-function _(e) {
+function y(e) {
 	try {
 		let t = new Intl.Locale(e), n = t.getWeekInfo?.() ?? t.weekInfo;
 		if (n?.firstDay) return n.firstDay % 7;
 	} catch {}
 	return 1;
 }
-var v = Date.UTC(2021, 7, 1), y = 864e5;
-function b(e, t, n = "short") {
+var b = Date.UTC(2021, 7, 1), x = 864e5;
+function S(e, t, n = "short") {
 	let r = new Intl.DateTimeFormat(e, {
 		weekday: n,
 		timeZone: "UTC"
 	});
-	return Array.from({ length: 7 }, (e, n) => r.format(v + (t + n) % 7 * y));
+	return Array.from({ length: 7 }, (e, n) => r.format(b + (t + n) % 7 * x));
 }
-function x(e, t = "long") {
-	let n = new Intl.DateTimeFormat(e, {
-		month: t,
+function C(e) {
+	let t = new Intl.DateTimeFormat(e, {
+		month: "long",
 		timeZone: "UTC"
 	});
-	return Array.from({ length: 12 }, (e, t) => n.format(Date.UTC(2021, t, 1)));
+	return Array.from({ length: 12 }, (e, n) => t.format(Date.UTC(2021, n, 1)));
 }
-function S(e) {
-	return x(e, "long").map((e) => {
+function w(e) {
+	return C(e).map((e) => {
 		let t = [...e];
 		return t.length <= 4 ? e : t.slice(0, 3).join("") + ".";
 	});
 }
-var C = /* @__PURE__ */ new Map();
-function w(e, t) {
-	let n = `${e}|${JSON.stringify(t)}`, r = C.get(n);
-	return r || (r = new Intl.DateTimeFormat(e, t), C.set(n, r)), r;
+var T = /* @__PURE__ */ new Map();
+function E(e, t) {
+	return n(T, `${e}|${JSON.stringify(t)}`, () => new Intl.DateTimeFormat(e, t));
 }
-function T(e, t, n = "long") {
-	return w(e, {
-		month: n,
+function D(e, t) {
+	return E(e, {
+		month: "long",
 		timeZone: "UTC"
 	}).format(Date.UTC(2021, t, 1));
 }
-function E(e, t, n) {
-	let r = i(e);
-	return r ? w(t, n).format(r) : "";
+function O(e, t, n) {
+	let r = a(e);
+	return r ? E(t, n).format(r) : "";
 }
-function D(e, t, n, r) {
-	let a = i(e), o = i(t);
-	if (!a || !o) return "";
-	let s = w(n, r);
-	return u(e, t) === 0 ? s.format(a) : s.formatRange(a, o);
+function k(e, t, n, r) {
+	let i = a(e), o = a(t);
+	if (!i || !o) return "";
+	let s = E(n, r);
+	return d(e, t) === 0 ? s.format(i) : s.formatRange(i, o);
 }
-var O = {
+var A = {
 	order: [
 		"day",
 		"month",
@@ -120,14 +121,11 @@ var O = {
 		4
 	],
 	size: 8
-}, k = Date.UTC(2021, 10, 22), A = /[‎‏؜]/g, j = /* @__PURE__ */ new Map();
-function M(e) {
-	let t = j.get(e);
-	if (t) return t;
-	let n = N(e);
-	return j.set(e, n), n;
-}
-function N(e) {
+}, j = Date.UTC(2021, 10, 22), M = /[‎‏؜]/g, N = /* @__PURE__ */ new Map();
+function P(e) {
+	return n(N, e, () => F(e));
+}
+function F(e) {
 	try {
 		let t = new Intl.DateTimeFormat(e, {
 			day: "2-digit",
@@ -136,7 +134,7 @@ function N(e) {
 			timeZone: "UTC",
 			calendar: "gregory",
 			numberingSystem: "latn"
-		}).formatToParts(k), n = t.map((e) => e.type).filter((e) => e === "day" || e === "month" || e === "year"), r = t.findIndex((e) => e.type !== "literal"), i = t.slice(r).find((e) => e.type === "literal")?.value.replace(A, "").trim();
+		}).formatToParts(j), n = t.map((e) => e.type).filter((e) => e === "day" || e === "month" || e === "year"), r = t.findIndex((e) => e.type !== "literal"), i = t.slice(r).find((e) => e.type === "literal")?.value.replace(M, "").trim();
 		if (n.length === 3 && i) return {
 			order: n,
 			separator: i,
@@ -144,9 +142,9 @@ function N(e) {
 			size: 8
 		};
 	} catch {}
-	return O;
+	return A;
 }
-function P(t, n) {
+function I(t, n) {
 	let r = e(t).slice(0, n.size), i = "", a = 0;
 	for (let e = 0; e < n.lengths.length; e++) {
 		let t = n.lengths[e], o = r.slice(a, a + t);
@@ -155,29 +153,29 @@ function P(t, n) {
 	}
 	return i;
 }
-function F(e, t) {
-	if (!r(e)) return "";
-	let [n, i, a] = e.split("-"), o = {
+function L(e, t) {
+	if (!i(e)) return "";
+	let [n, r, a] = e.split("-"), o = {
 		year: n,
-		month: i,
+		month: r,
 		day: a
 	};
-	return P(t.order.map((e) => o[e]).join(""), t);
+	return I(t.order.map((e) => o[e]).join(""), t);
 }
-function I(t, n, i = {}) {
+function R(t, n, r = {}) {
 	let a = e(t), o = {}, s = 0;
 	for (let e = 0; e < n.order.length; e++) {
-		let t = n.order[e], r = n.lengths[e], c = a.slice(s, s + r);
-		if (c.length === r) s += r;
-		else if (t === "year" && i.yearPivot !== void 0 && e === n.order.length - 1 && c.length === 2) s += 2;
+		let t = n.order[e], i = n.lengths[e], c = a.slice(s, s + i);
+		if (c.length === i) s += i;
+		else if (t === "year" && r.yearPivot !== void 0 && e === n.order.length - 1 && c.length === 2) s += 2;
 		else return null;
 		o[t] = c;
 	}
 	if (s !== a.length) return null;
-	let c = `${o.year.length === 2 ? String(i.yearPivot + Number(o.year)) : o.year}-${o.month}-${o.day}`;
-	return r(c) ? c : null;
+	let c = `${o.year.length === 2 ? String(r.yearPivot + Number(o.year)) : o.year}-${o.month}-${o.day}`;
+	return i(c) ? c : null;
 }
-function L(e, t, n) {
+function z(e, t, n) {
 	let r = 0;
 	if (t > 0) {
 		r = e.length;
@@ -192,34 +190,35 @@ function L(e, t, n) {
 	}
 	return n && e.startsWith(n, r) && (r += n.length), r;
 }
-var R = {
+var B = {
 	day: "d",
 	month: "m",
 	year: "y"
-}, z = /[\p{sc=Han}\p{sc=Hangul}\p{sc=Hiragana}\p{sc=Katakana}]/u;
-function B(e, t) {
-	let n = H(e);
+}, V = /[\p{sc=Han}\p{sc=Hangul}\p{sc=Hiragana}\p{sc=Katakana}]/u;
+function H(e, t) {
+	let n = W(e);
 	return t.order.map((e, r) => n[e].repeat(t.lengths[r])).join(t.separator);
 }
-var V = /* @__PURE__ */ new Map();
-function H(e) {
-	let t = V.get(e);
-	if (t) return t;
-	let n = { ...R };
+var U = /* @__PURE__ */ new Map();
+function W(e) {
+	return n(U, e, () => G(e));
+}
+function G(e) {
+	let t = { ...B };
 	try {
-		let t = new Intl.DisplayNames(e, { type: "dateTimeField" });
+		let n = new Intl.DisplayNames(e, { type: "dateTimeField" });
 		for (let r of [
 			"day",
 			"month",
 			"year"
 		]) {
-			let i = [...t.of(r) ?? ""][0];
-			i && /\p{L}/u.test(i) && !z.test(i) && (n[r] = i.toLocaleLowerCase(e));
+			let i = [...n.of(r) ?? ""][0];
+			i && /\p{L}/u.test(i) && !V.test(i) && (t[r] = i.toLocaleLowerCase(e));
 		}
 	} catch {}
-	return V.set(e, n), n;
+	return t;
 }
 //#endregion
-export { s as addDays, c as addMonths, m as buildMonthGrid, L as caretAfterDigits, f as clampISO, u as compareISO, M as dateMaskFor, l as daysInMonth, g as firstDayOfWeekFor, P as formatDateMask, E as formatDisplay, D as formatDisplayRange, a as formatISO, d as isSameISO, r as isValidISO, p as isWithin, o as isoOf, F as isoToMask, B as maskPlaceholder, T as monthName, x as monthNames, S as monthNamesCompact, I as parseDateMask, i as parseISO, b as weekdayNames };
+export { c as addDays, l as addMonths, g as buildMonthGrid, z as caretAfterDigits, p as clampISO, d as compareISO, P as dateMaskFor, u as daysInMonth, v as firstDayOfWeekFor, O as formatDateDisplay, I as formatDateMask, k as formatDisplayRange, o as formatISO, h as isDateAllowed, f as isSameISO, i as isValidISO, m as isWithin, s as isoOf, L as isoToMask, H as maskPlaceholder, D as monthName, C as monthNames, w as monthNamesCompact, R as parseDateMask, a as parseISO, S as weekdayNames };
 
 //# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","names":[],"sources":["../../src/utils/date.ts"],"sourcesContent":["// @ssr @core — module-wide: every export below is @core unless tagged otherwise.\n/**\n * The date arithmetic behind VDatePicker and VDateInput, written as pure functions:\n * they read nothing outside their arguments and change nothing around them.\n *\n * The whole module speaks one language, the ISO `YYYY-MM-DD` string, and computes\n * everything in the reader's LOCAL time. Two shortcuts are therefore banned\n * throughout: `new Date('YYYY-MM-DD')`, which the language interprets as UTC and\n * which consequently lands on the previous or the next day depending on the time\n * zone, and `toISOString()`, which formats in UTC for the same reason. `Date`\n * objects exist here only as an intermediate step, built with `new Date(y, m, d)` —\n * local midnight — and turned back into text by concatenation.\n *\n * The names of months and days come from `Intl`, which is available on the server as\n * well as in the browser. They are formatted from REFERENCE dates pinned to\n * `timeZone: 'UTC'`, so that the resulting label never depends on the time zone of\n * the machine doing the rendering.\n */\n\nimport { digitsOf, pad2 } from './text'\n\nconst ISO_RE = /^\\d{4}-\\d{2}-\\d{2}$/\n\n/**\n * Tells whether a value is a real `YYYY-MM-DD` date. The shape alone is not enough:\n * `2026-02-31` matches the pattern, so the check goes through a parse and a\n * reformat, and only a value that survives the round trip unchanged is accepted.\n */\nexport function isValidISO(iso: unknown): iso is string {\n  if (typeof iso !== 'string' || !ISO_RE.test(iso)) return false\n  const d = parseISO(iso)\n  return d !== null && formatISO(d) === iso\n}\n\n/**\n * Turns an ISO string into a `Date` set at local midnight, or returns `null` when\n * the string is not one. Every caller here has to handle that `null`: the bounds a\n * consumer passes are raw strings and may be anything.\n */\nexport function parseISO(iso: string | null | undefined): Date | null {\n  if (typeof iso !== 'string' || !ISO_RE.test(iso)) return null\n  const parts = iso.split('-')\n  const date = new Date(Number(parts[0]), Number(parts[1]) - 1, Number(parts[2]))\n  return Number.isNaN(date.getTime()) ? null : date\n}\n\n/**\n * Writes a `Date` as an ISO string, reading its LOCAL components. This manual\n * concatenation is what `toISOString()` cannot do, since that one formats in UTC.\n */\nexport function formatISO(date: Date): string {\n  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`\n}\n\n/**\n * Builds an ISO string from separate values. The month is 0-indexed, as everywhere\n * in the language: 0 is January.\n */\nexport function isoOf(year: number, month0: number, day: number): string {\n  return formatISO(new Date(year, month0, day))\n}\n\n/**\n * Moves a date by a number of days, forwards or backwards. Crossing into another\n * month or year is handled by `Date` itself.\n */\nexport function addDays(iso: string, n: number): string {\n  const d = parseISO(iso)\n  if (!d) return iso\n  d.setDate(d.getDate() + n)\n  return formatISO(d)\n}\n\n/**\n * Moves a date by a number of months, keeping the day of the month where possible.\n * When the target month is too short the day is brought back to its last one: 31\n * January plus one month gives 28 or 29 February, and never spills over into March\n * the way a naive addition would.\n */\nexport function addMonths(iso: string, n: number): string {\n  const d = parseISO(iso)\n  if (!d) return iso\n  const day = d.getDate()\n  d.setDate(1)\n  d.setMonth(d.getMonth() + n)\n  d.setDate(Math.min(day, daysInMonth(d.getFullYear(), d.getMonth())))\n  return formatISO(d)\n}\n\n/**\n * How many days the given month holds, leap years included. Day 0 of the following\n * month is the last day of this one, which is what makes the leap year rule the\n * language's problem rather than ours.\n */\nexport function daysInMonth(year: number, month0: number): number {\n  return new Date(year, month0 + 1, 0).getDate()\n}\n\n/**\n * Compares two dates chronologically, returning the usual -1, 0 or 1. Because the\n * `YYYY-MM-DD` format puts its most significant part first, comparing the strings as\n * text already gives the chronological order: no parsing is needed.\n */\nexport function compareISO(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0\n}\n\n/**\n * Whether two dates are the same day, with a null on either side counting as no\n * date at all rather than as a match.\n */\nexport const isSameISO = (a: string | null, b: string | null) => !!a && a === b\n\n/**\n * Brings a date back inside the allowed interval, returning the bound it exceeded.\n * Both bounds are optional, and an absent one means unbounded on that side.\n */\nexport function clampISO(iso: string, min?: string, max?: string): string {\n  if (min && compareISO(iso, min) < 0) return min\n  if (max && compareISO(iso, max) > 0) return max\n  return iso\n}\n\n/** Whether a date falls inside the allowed interval, each bound being optional. */\nexport function isWithin(iso: string, min?: string, max?: string): boolean {\n  if (min && compareISO(iso, min) < 0) return false\n  if (max && compareISO(iso, max) > 0) return false\n  return true\n}\n\n/** One square of a month grid. */\nexport interface MonthCell {\n  /** The day it stands for, as an ISO `YYYY-MM-DD` string. */\n  iso: string\n  /**\n   * Which side of the displayed month this day belongs to when it is not part of it,\n   * and `null` when it is.\n   */\n  adjacent: 'prev' | 'next' | null\n}\n\n/**\n * Builds the grid of a month: 42 cells, six rows of seven, filled out at both ends\n * with the days of the neighbouring months. The count is fixed on purpose, so that\n * the calendar keeps the same height from one month to the next instead of jumping\n * by a row. `firstDayOfWeek` runs from 0 for Sunday to 6 for Saturday.\n */\nexport function buildMonthGrid(year: number, month0: number, firstDayOfWeek: number): MonthCell[] {\n  const first = new Date(year, month0, 1)\n  // How many cells the 1st of the month sits after the start of its row, which is\n  // exactly how many days of the previous month the grid has to open with.\n  const offset = (first.getDay() - firstDayOfWeek + 7) % 7\n  const cells: MonthCell[] = []\n  const start = new Date(year, month0, 1 - offset)\n  for (let i = 0; i < 42; i++) {\n    const d = new Date(start.getFullYear(), start.getMonth(), start.getDate() + i)\n    const adjacent =\n      d.getMonth() === month0 && d.getFullYear() === year\n        ? null\n        : compareISO(formatISO(d), formatISO(first)) < 0\n          ? 'prev'\n          : 'next'\n    cells.push({ iso: formatISO(d), adjacent })\n  }\n  return cells\n}\n\n// @fallback @ssr\n/**\n * The day the week starts on in a given locale, from 0 for Sunday to 6 for Saturday\n * — Sunday in the United States, Monday in most of Europe, Saturday in much of the\n * Middle East. It comes from `Intl.Locale`, whose own numbering runs from 1 for\n * Monday to 7 for Sunday.\n *\n * That part of `Intl` is not everywhere (some Node builds lack it), so the answer\n * falls back to Monday when it is missing. A component can always override the\n * result with its `firstDayOfWeek` prop.\n */\nconst firstDayCache = new Map<string, number>()\n\nexport function firstDayOfWeekFor(locale: string): number {\n  const cached = firstDayCache.get(locale)\n  if (cached !== undefined) return cached\n  const first = resolveFirstDayOfWeek(locale)\n  firstDayCache.set(locale, first)\n  return first\n}\n\nfunction resolveFirstDayOfWeek(locale: string): number {\n  try {\n    // Implementations disagree on the shape: Chrome and Safari expose `weekInfo` as\n    // a getter, others a `getWeekInfo()` method. Both are tried.\n    const loc = new Intl.Locale(locale) as Intl.Locale & {\n      weekInfo?: { firstDay: number }\n      getWeekInfo?: () => { firstDay: number }\n    }\n    const info = loc.getWeekInfo?.() ?? loc.weekInfo\n    if (info?.firstDay) return info.firstDay % 7 // brings Sunday, their 7, back to 0\n  } catch {\n    /* an invalid locale throws a RangeError: fall through to the fallback */\n  }\n  return 1 // Monday\n}\n\n// The reference instants the names are formatted from. Any Sunday will do for the\n// weekdays, and any year for the months; combined with `timeZone: 'UTC'` at every\n// call site, they pin the output whatever zone the machine is in.\nconst REF_SUNDAY = Date.UTC(2021, 7, 1) // 1 August 2021 fell on a Sunday\nconst MS_DAY = 86_400_000\n\n/**\n * The names of the seven days, starting from `firstDayOfWeek` so the list can be\n * dropped straight into a calendar header.\n */\nexport function weekdayNames(\n  locale: string,\n  firstDayOfWeek: number,\n  weekday: 'narrow' | 'short' | 'long' = 'short',\n): string[] {\n  const fmt = new Intl.DateTimeFormat(locale, { weekday, timeZone: 'UTC' })\n  return Array.from({ length: 7 }, (_, i) =>\n    fmt.format(REF_SUNDAY + ((firstDayOfWeek + i) % 7) * MS_DAY),\n  )\n}\n\n/** The names of the twelve months, in January-to-December order. */\nexport function monthNames(locale: string, month: 'long' | 'short' = 'long'): string[] {\n  const fmt = new Intl.DateTimeFormat(locale, { month, timeZone: 'UTC' })\n  return Array.from({ length: 12 }, (_, i) => fmt.format(Date.UTC(2021, i, 1)))\n}\n\n/**\n * Month names shortened for the picker's narrow cells: a name of four characters or\n * fewer is kept whole (\"May\", \"June\", \"July\"), a longer one is cut to three\n * characters followed by a dot (\"January\" becomes \"Jan.\"). The name is spread with\n * `[...n]` rather than indexed, so that an accented or non-Latin character counts as\n * one character and is never cut in half.\n */\nexport function monthNamesCompact(locale: string): string[] {\n  return monthNames(locale, 'long').map((n) => {\n    const chars = [...n]\n    return chars.length <= 4 ? n : chars.slice(0, 3).join('') + '.'\n  })\n}\n\n/**\n * One formatter kept per locale and set of options, for the lifetime of the module —\n * the same `formatterFor` idiom as in `utils/file.ts` and `utils/time.ts`.\n *\n * Building an `Intl.DateTimeFormat` costs one to two orders of magnitude more than\n * using one, and the three functions below are called ONE VALUE AT A TIME: VDateInput\n * formats a multiple selection inside a `.map`, so a fresh formatter would be built\n * for every date. `weekdayNames` and `monthNames` already hoist theirs out of their\n * loop; this cache gives the per-call functions the same property.\n *\n * The options object is part of the cache key. `JSON.stringify` is stable enough\n * here — these objects are literals written by the components, not data coming from\n * a user — and costs a fraction of a construction.\n */\nconst formatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction formatterFor(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n  const key = `${locale}|${JSON.stringify(options)}`\n  let formatter = formatters.get(key)\n  if (!formatter) {\n    formatter = new Intl.DateTimeFormat(locale, options)\n    formatters.set(key, formatter)\n  }\n  return formatter\n}\n\n/** The name of one month, 0 being January. */\nexport function monthName(\n  locale: string,\n  month0: number,\n  month: 'long' | 'short' = 'long',\n): string {\n  return formatterFor(locale, { month, timeZone: 'UTC' }).format(Date.UTC(2021, month0, 1))\n}\n\n/**\n * A date written out for the reader, in the conventions of their locale — this is\n * what VDateInput shows in its field. An unparsable date yields an empty string\n * rather than a broken one.\n */\nexport function formatDisplay(\n  iso: string,\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): string {\n  const d = parseISO(iso)\n  return d ? formatterFor(locale, options).format(d) : ''\n}\n\n/**\n * A period written out for the reader. `Intl`'s own `formatRange` is what factors\n * out the parts the two dates share, giving \"19–26 June 2026\" rather than the two\n * full dates side by side. A period of a single day is formatted as that one date.\n */\nexport function formatDisplayRange(\n  start: string,\n  end: string,\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): string {\n  const a = parseISO(start)\n  const b = parseISO(end)\n  if (!a || !b) return ''\n  const fmt = formatterFor(locale, options)\n  return compareISO(start, end) === 0 ? fmt.format(a) : fmt.formatRange(a, b)\n}\n\n/*\n * The numeric input mask, used by VDateInput when its field can be typed into.\n *\n * A field being typed into never shows the long display format — \"10 June 2026\" is\n * not something one can type — but a purely numeric mask instead. The order of the\n * three fields and the separator between them are DERIVED from the locale rather\n * than hardcoded, which is what makes the same field work for a reader in Tokyo and\n * one in Chicago.\n */\n\nexport type DateMaskField = 'day' | 'month' | 'year'\n\n/** Everything a locale decides about how a date is typed. */\nexport interface DateMask {\n  /**\n   * The order the three fields appear in: day, month, year in the United Kingdom,\n   * month, day, year in the United States, year, month, day in Japan.\n   */\n  order: readonly DateMaskField[]\n  /** The single character between two fields, stripped of bidi marks and spaces. */\n  separator: string\n  /** How many digits each field takes, in the same order: 4 for the year, 2 otherwise. */\n  lengths: readonly number[]\n  /** How many digits the complete mask holds, which is always 8. */\n  size: number\n}\n\nconst MASK_FALLBACK: DateMask = {\n  order: ['day', 'month', 'year'],\n  separator: '/',\n  lengths: [2, 2, 4],\n  size: 8,\n}\n\n/**\n * The date the mask is read from: 22 November 2021. Its three numbers all differ, so\n * whichever order the locale prints them in, each one can be told apart.\n */\nconst REF_MASK_DATE = Date.UTC(2021, 10, 22)\n\n/** The invisible direction marks some locales insert, such as U+200F before \"/\" in ar-EG. */\nconst BIDI_MARKS = /[‎‏؜]/g\n\n/**\n * Works out how a date is typed in a given locale, by formatting a known date and\n * looking at what came out.\n *\n * The calendar and the numbering system are FORCED to Gregorian and Latin digits.\n * Without that, `fa-IR` answers with a Persian year (1400 rather than 2021) and\n * `ar-EG` with Arabic-Indic digits — two things a numeric field could neither\n * display nor read back. An invalid locale throws, and the answer then falls back to\n * day/month/year separated by \"/\".\n */\nconst maskCache = new Map<string, DateMask>()\n\nexport function dateMaskFor(locale: string): DateMask {\n  const cached = maskCache.get(locale)\n  if (cached) return cached\n  const mask = buildDateMask(locale)\n  maskCache.set(locale, mask)\n  return mask\n}\n\n/*\n * TRAP — the returned `DateMask` is SHARED between every caller for a locale, so it must be\n * treated as read-only. Nothing mutates it today (it is read field by field in\n * `formatDateMask`, `parseDateMask` and `maskPlaceholder`), and it is the same contract the\n * memoized `Intl` formatters in this file already have.\n */\nfunction buildDateMask(locale: string): DateMask {\n  try {\n    const parts = new Intl.DateTimeFormat(locale, {\n      day: '2-digit',\n      month: '2-digit',\n      year: 'numeric',\n      timeZone: 'UTC',\n      calendar: 'gregory',\n      numberingSystem: 'latn',\n    }).formatToParts(REF_MASK_DATE)\n\n    const order = parts\n      .map((p) => p.type)\n      .filter((t): t is DateMaskField => t === 'day' || t === 'month' || t === 'year')\n\n    // The separator is the first literal appearing AFTER the first field, and not\n    // simply the first literal: Hungarian and Korean end the whole format with a dot\n    // (\"2021. 11. 22.\"), which must not be mistaken for it.\n    const firstField = parts.findIndex((p) => p.type !== 'literal')\n    const separator = parts\n      .slice(firstField)\n      .find((p) => p.type === 'literal')\n      ?.value.replace(BIDI_MARKS, '')\n      .trim()\n\n    if (order.length === 3 && separator) {\n      const lengths = order.map((f) => (f === 'year' ? 4 : 2))\n      return { order, separator, lengths, size: 8 }\n    }\n  } catch {\n    /* an invalid locale throws a RangeError: fall through to the fallback */\n  }\n  return MASK_FALLBACK\n}\n\n/**\n * Lays a run of digits out as masked text. The separator appears AS SOON AS the field\n * before it is full — typing \"22\" already gives \"22/\" — so the reader sees their\n * progress without ever having to type a separator themselves.\n *\n * This has a consequence the component must honour: pressing Backspace on such a\n * separator has to delete the DIGIT before it. Deleting the separator alone would\n * see the mask write it straight back, and the key would look dead.\n */\nexport function formatDateMask(digits: string, mask: DateMask): string {\n  const all = digitsOf(digits).slice(0, mask.size)\n  let out = ''\n  let i = 0\n  for (let f = 0; f < mask.lengths.length; f++) {\n    const len = mask.lengths[f] as number\n    const chunk = all.slice(i, i + len)\n    if (!chunk) break\n    out += chunk\n    i += len\n    if (chunk.length < len) break // this field is still being typed: no separator yet\n    if (f < mask.lengths.length - 1) out += mask.separator\n  }\n  return out\n}\n\n/**\n * Writes an ISO date in the mask of the locale, ready to be put in the field: the\n * same day reads \"10/06/2026\" in London and \"06/10/2026\" in Chicago.\n */\nexport function isoToMask(iso: string, mask: DateMask): string {\n  if (!isValidISO(iso)) return ''\n  const [year, month, day] = iso.split('-') as [string, string, string]\n  const by: Record<DateMaskField, string> = { year, month, day }\n  return formatDateMask(mask.order.map((f) => by[f]).join(''), mask)\n}\n\nexport interface ParseMaskOptions {\n  /**\n   * The century a two-digit year is expanded into: with 2000, \"10/06/26\" is read as\n   * 2026. It is only accepted when the year is the LAST field of the mask, since\n   * elsewhere the following separator already tells the two apart.\n   *\n   * Leaving it out refuses any year shorter than four digits, and that is the mode\n   * used while the reader types — so that \"26\", passed through on the way to \"2026\",\n   * is never committed as a year of its own.\n   */\n  yearPivot?: number\n}\n\n/**\n * Reads masked text back into an ISO date, or returns `null` when the text is\n * incomplete, holds too many digits, or names a day that does not exist — 31\n * February passes every length check and is caught by the round trip `isValidISO`\n * performs.\n *\n * Whether the resulting date is allowed is a different question: the `min`/`max`\n * bounds and the disabled dates belong to the component, and this function knows\n * nothing about props.\n */\nexport function parseDateMask(\n  text: string,\n  mask: DateMask,\n  options: ParseMaskOptions = {},\n): string | null {\n  const digits = digitsOf(text)\n  const by: Partial<Record<DateMaskField, string>> = {}\n  let i = 0\n  for (let k = 0; k < mask.order.length; k++) {\n    const field = mask.order[k] as DateMaskField\n    const len = mask.lengths[k] as number\n    const chunk = digits.slice(i, i + len)\n    if (chunk.length === len) i += len\n    else if (\n      field === 'year' &&\n      options.yearPivot !== undefined &&\n      k === mask.order.length - 1 &&\n      chunk.length === 2\n    )\n      i += 2\n    else return null\n    by[field] = chunk\n  }\n  if (i !== digits.length) return null // digits are left over: the entry is too long\n  const year =\n    (by.year as string).length === 2\n      ? String((options.yearPivot as number) + Number(by.year))\n      : (by.year as string)\n  const iso = `${year}-${by.month}-${by.day}`\n  return isValidISO(iso) ? iso : null\n}\n\n/**\n * Where the caret has to go to sit just after the nth digit. Counting digits is the\n * only landmark that survives a reformat: an absolute position jumps by one the\n * moment a separator appears or disappears, so restoring it would leave the caret in\n * the wrong place on exactly the keystrokes that matter.\n *\n * When a separator is passed and it directly follows that position, the caret steps\n * over it: while typing, it must land in the NEXT field rather than in front of a\n * separator that has just been written. On deletion the argument is omitted, so the\n * caret stays before it and the next Backspace reaches the digit.\n */\nexport function caretAfterDigits(text: string, n: number, separator?: string): number {\n  let pos = 0\n  if (n > 0) {\n    pos = text.length\n    let seen = 0\n    for (let i = 0; i < text.length; i++) {\n      const code = text.charCodeAt(i)\n      if (code >= 48 && code <= 57 && ++seen === n) {\n        pos = i + 1\n        break\n      }\n    }\n  }\n  if (separator && text.startsWith(separator, pos)) pos += separator.length\n  return pos\n}\n\nconst PLACEHOLDER_FALLBACK: Record<DateMaskField, string> = { day: 'd', month: 'm', year: 'y' }\n\n/**\n * Ideographic scripts, which are excluded from the placeholder: a repeated \"日\" does\n * not read as a template the way a repeated letter does.\n */\nconst IDEOGRAPHIC = /[\\p{sc=Han}\\p{sc=Hangul}\\p{sc=Hiragana}\\p{sc=Katakana}]/u\n\n// @fallback\n/**\n * The empty template shown in the field: \"dd/mm/yyyy\" in English, \"jj/mm/aaaa\" in\n * French, \"tt.mm.jjjj\" in German, \"дд/мм/гггг\" in Russian.\n *\n * Each letter is the first letter of the field's own name in that language, taken\n * from `Intl.DisplayNames` — which lands on the attested convention of every\n * alphabetic script without a table to maintain. It falls back to the Latin letters\n * when that part of `Intl` is missing, or when the script is ideographic and the\n * repetition would mean nothing.\n */\nexport function maskPlaceholder(locale: string, mask: DateMask): string {\n  const letters = placeholderLetters(locale)\n  return mask.order.map((f, k) => letters[f].repeat(mask.lengths[k] as number)).join(mask.separator)\n}\n\n/**\n * The three letters a locale writes its date fields with, worked out once per locale.\n *\n * It is the LETTERS that are cached and not the finished placeholder, because the result\n * also depends on the mask handed in — caching the string would be wrong the moment a\n * caller passes a mask that is not `dateMaskFor(locale)`. All of the cost is here anyway:\n * `Intl.DisplayNames` is the most expensive constructor in this file by an order of\n * magnitude (measured at ~0.22 ms a call, against ~0.07 for `dateMaskFor`), and the string\n * assembly below it is a handful of `repeat` calls.\n */\nconst placeholderLetterCache = new Map<string, typeof PLACEHOLDER_FALLBACK>()\n\nfunction placeholderLetters(locale: string): typeof PLACEHOLDER_FALLBACK {\n  const cached = placeholderLetterCache.get(locale)\n  if (cached) return cached\n\n  const letters = { ...PLACEHOLDER_FALLBACK }\n  try {\n    const names = new Intl.DisplayNames(locale, { type: 'dateTimeField' })\n    for (const field of ['day', 'month', 'year'] as const) {\n      const first = [...(names.of(field) ?? '')][0]\n      if (first && /\\p{L}/u.test(first) && !IDEOGRAPHIC.test(first))\n        letters[field] = first.toLocaleLowerCase(locale)\n    }\n  } catch {\n    /* Intl.DisplayNames is unavailable here: keep the Latin letters */\n  }\n  placeholderLetterCache.set(locale, letters)\n  return letters\n}\n"],"mappings":"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"}
+{"version":3,"file":"date.js","names":[],"sources":["../../src/utils/date.ts"],"sourcesContent":["// @ssr @core — module-wide: every export below is @core unless tagged otherwise.\n/**\n * The date arithmetic behind VDatePicker and VDateInput, as pure functions. One currency\n * throughout: the ISO `YYYY-MM-DD` string, computed in LOCAL time.\n *\n * Two shortcuts are banned as a result. `new Date('YYYY-MM-DD')` parses as UTC and lands a\n * day out depending on the zone, and `toISOString()` formats in UTC for the same reason.\n * `Date` exists here only as an intermediate, built with `new Date(y, m, d)` — local\n * midnight — and turned back into text by concatenation.\n *\n * Month and day names come from `Intl` on REFERENCE dates pinned to `timeZone: 'UTC'`, so a\n * label never depends on the rendering machine's zone and the server agrees with the browser.\n */\n\nimport { memo } from './memo'\nimport { digitsOf, pad2 } from './text'\n\nconst ISO_RE = /^\\d{4}-\\d{2}-\\d{2}$/\n\n/**\n * Tells whether a value is a real `YYYY-MM-DD` date. The shape alone is not enough:\n * `2026-02-31` matches the pattern, so the check goes through a parse and a\n * reformat, and only a value that survives the round trip unchanged is accepted.\n */\nexport function isValidISO(iso: unknown): iso is string {\n  if (typeof iso !== 'string' || !ISO_RE.test(iso)) return false\n  const d = parseISO(iso)\n  return d !== null && formatISO(d) === iso\n}\n\n/**\n * Turns an ISO string into a `Date` set at local midnight, or returns `null` when\n * the string is not one. Every caller here has to handle that `null`: the bounds a\n * consumer passes are raw strings and may be anything.\n */\nexport function parseISO(iso: string | null | undefined): Date | null {\n  if (typeof iso !== 'string' || !ISO_RE.test(iso)) return null\n  const parts = iso.split('-')\n  const date = new Date(Number(parts[0]), Number(parts[1]) - 1, Number(parts[2]))\n  return Number.isNaN(date.getTime()) ? null : date\n}\n\n/**\n * Writes a `Date` as an ISO string, reading its LOCAL components. This manual\n * concatenation is what `toISOString()` cannot do, since that one formats in UTC.\n */\nexport function formatISO(date: Date): string {\n  return `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`\n}\n\n/**\n * Builds an ISO string from separate values. The month is 0-indexed, as everywhere\n * in the language: 0 is January.\n */\nexport function isoOf(year: number, month0: number, day: number): string {\n  return formatISO(new Date(year, month0, day))\n}\n\n/**\n * Moves a date by a number of days, forwards or backwards. Crossing into another\n * month or year is handled by `Date` itself.\n */\nexport function addDays(iso: string, n: number): string {\n  const d = parseISO(iso)\n  if (!d) return iso\n  d.setDate(d.getDate() + n)\n  return formatISO(d)\n}\n\n/**\n * Moves a date by a number of months, keeping the day of the month where possible.\n * When the target month is too short the day is brought back to its last one: 31\n * January plus one month gives 28 or 29 February, and never spills over into March\n * the way a naive addition would.\n */\nexport function addMonths(iso: string, n: number): string {\n  const d = parseISO(iso)\n  if (!d) return iso\n  const day = d.getDate()\n  d.setDate(1)\n  d.setMonth(d.getMonth() + n)\n  d.setDate(Math.min(day, daysInMonth(d.getFullYear(), d.getMonth())))\n  return formatISO(d)\n}\n\n/**\n * How many days the given month holds, leap years included. Day 0 of the following\n * month is the last day of this one, which is what makes the leap year rule the\n * language's problem rather than ours.\n */\nexport function daysInMonth(year: number, month0: number): number {\n  return new Date(year, month0 + 1, 0).getDate()\n}\n\n/**\n * Compares two dates chronologically, returning the usual -1, 0 or 1. Because the\n * `YYYY-MM-DD` format puts its most significant part first, comparing the strings as\n * text already gives the chronological order: no parsing is needed.\n */\nexport function compareISO(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0\n}\n\n/**\n * Whether two dates are the same day, with a null on either side counting as no\n * date at all rather than as a match.\n */\nexport const isSameISO = (a: string | null, b: string | null) => !!a && a === b\n\n/**\n * Brings a date back inside the allowed interval, returning the bound it exceeded.\n * Both bounds are optional, and an absent one means unbounded on that side.\n */\nexport function clampISO(iso: string, min?: string, max?: string): string {\n  if (min && compareISO(iso, min) < 0) return min\n  if (max && compareISO(iso, max) > 0) return max\n  return iso\n}\n\n/** Whether a date falls inside the allowed interval, each bound being optional. */\nexport function isWithin(iso: string, min?: string, max?: string): boolean {\n  if (min && compareISO(iso, min) < 0) return false\n  if (max && compareISO(iso, max) > 0) return false\n  return true\n}\n\n/**\n * Whether a date may be chosen: inside the bounds, and not one the matcher excludes. It is\n * the ONE rule behind both a struck-through day in VDatePicker and a typed date VDateInput\n * refuses, so the two cannot come to disagree about what \"unavailable\" means.\n */\nexport function isDateAllowed(\n  iso: string,\n  min: string | undefined,\n  max: string | undefined,\n  excluded: (iso: string) => boolean,\n): boolean {\n  return isWithin(iso, min, max) && !excluded(iso)\n}\n\n/** One square of a month grid. */\nexport interface MonthCell {\n  /** The day it stands for, as an ISO `YYYY-MM-DD` string. */\n  iso: string\n  /** The day of the month, carried so a caller does not parse back what was just formatted. */\n  day: number\n  /**\n   * Which side of the displayed month this day belongs to when it is not part of it,\n   * and `null` when it is.\n   */\n  adjacent: 'prev' | 'next' | null\n}\n\n/**\n * Builds the grid of a month: 42 cells, six rows of seven, filled out at both ends\n * with the days of the neighbouring months. The count is fixed on purpose, so that\n * the calendar keeps the same height from one month to the next instead of jumping\n * by a row. `firstDayOfWeek` runs from 0 for Sunday to 6 for Saturday.\n */\nexport function buildMonthGrid(year: number, month0: number, firstDayOfWeek: number): MonthCell[] {\n  const first = new Date(year, month0, 1)\n  // How many cells the 1st of the month sits after the start of its row, which is\n  // exactly how many days of the previous month the grid has to open with.\n  const offset = (first.getDay() - firstDayOfWeek + 7) % 7\n  const cells: MonthCell[] = []\n  for (let i = 0; i < 42; i++) {\n    // Built from the 1st rather than stepped from a start date, so the month and year\n    // rolling over at either end is `Date`'s arithmetic and not ours.\n    const d = new Date(year, month0, 1 - offset + i)\n    const adjacent =\n      d.getMonth() === month0 && d.getFullYear() === year ? null : d < first ? 'prev' : 'next'\n    cells.push({ iso: formatISO(d), day: d.getDate(), adjacent })\n  }\n  return cells\n}\n\nconst firstDayCache = new Map<string, number>()\n\n// @fallback @ssr\n/**\n * The day the week starts on in a given locale, from 0 for Sunday to 6 for Saturday\n * — Sunday in the United States, Monday in most of Europe, Saturday in much of the\n * Middle East. It comes from `Intl.Locale`, whose own numbering runs from 1 for\n * Monday to 7 for Sunday.\n *\n * That part of `Intl` is not everywhere (some Node builds lack it), so the answer\n * falls back to Monday when it is missing. A component can always override the\n * result with its `firstDayOfWeek` prop.\n */\nexport function firstDayOfWeekFor(locale: string): number {\n  return memo(firstDayCache, locale, () => resolveFirstDayOfWeek(locale))\n}\n\nfunction resolveFirstDayOfWeek(locale: string): number {\n  try {\n    // Implementations disagree on the shape: Chrome and Safari expose `weekInfo` as\n    // a getter, others a `getWeekInfo()` method. Both are tried.\n    const loc = new Intl.Locale(locale) as Intl.Locale & {\n      weekInfo?: { firstDay: number }\n      getWeekInfo?: () => { firstDay: number }\n    }\n    const info = loc.getWeekInfo?.() ?? loc.weekInfo\n    if (info?.firstDay) return info.firstDay % 7 // brings Sunday, their 7, back to 0\n  } catch {\n    /* an invalid locale throws a RangeError: fall through to the fallback */\n  }\n  return 1 // Monday\n}\n\n// The reference instants the names are formatted from. Any Sunday will do for the\n// weekdays, and any year for the months; combined with `timeZone: 'UTC'` at every\n// call site, they pin the output whatever zone the machine is in.\nconst REF_SUNDAY = Date.UTC(2021, 7, 1) // 1 August 2021 fell on a Sunday\nconst MS_DAY = 86_400_000\n\n/**\n * The names of the seven days, starting from `firstDayOfWeek` so the list can be\n * dropped straight into a calendar header.\n */\nexport function weekdayNames(\n  locale: string,\n  firstDayOfWeek: number,\n  weekday: 'short' | 'long' = 'short',\n): string[] {\n  const fmt = new Intl.DateTimeFormat(locale, { weekday, timeZone: 'UTC' })\n  return Array.from({ length: 7 }, (_, i) =>\n    fmt.format(REF_SUNDAY + ((firstDayOfWeek + i) % 7) * MS_DAY),\n  )\n}\n\n/** The full names of the twelve months, in January-to-December order. */\nexport function monthNames(locale: string): string[] {\n  const fmt = new Intl.DateTimeFormat(locale, { month: 'long', timeZone: 'UTC' })\n  return Array.from({ length: 12 }, (_, i) => fmt.format(Date.UTC(2021, i, 1)))\n}\n\n/**\n * Month names shortened for the picker's narrow cells: a name of four characters or\n * fewer is kept whole (\"May\", \"June\", \"July\"), a longer one is cut to three\n * characters followed by a dot (\"January\" becomes \"Jan.\"). The name is spread with\n * `[...n]` rather than indexed, so that an accented or non-Latin character counts as\n * one character and is never cut in half.\n */\nexport function monthNamesCompact(locale: string): string[] {\n  return monthNames(locale).map((n) => {\n    const chars = [...n]\n    return chars.length <= 4 ? n : chars.slice(0, 3).join('') + '.'\n  })\n}\n\n/**\n * One formatter kept per locale and set of options, for the lifetime of the module —\n * the same `formatterFor` idiom as in `utils/file.ts` and `utils/time.ts`.\n *\n * Building an `Intl.DateTimeFormat` costs one to two orders of magnitude more than\n * using one, and the three functions below are called ONE VALUE AT A TIME: VDateInput\n * formats a multiple selection inside a `.map`, so a fresh formatter would be built\n * for every date. `weekdayNames` and `monthNames` already hoist theirs out of their\n * loop; this cache gives the per-call functions the same property.\n *\n * The options object is part of the cache key. `JSON.stringify` is stable enough\n * here — these objects are literals written by the components, not data coming from\n * a user — and costs a fraction of a construction.\n */\nconst formatters = new Map<string, Intl.DateTimeFormat>()\n\nfunction formatterFor(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n  return memo(\n    formatters,\n    `${locale}|${JSON.stringify(options)}`,\n    () => new Intl.DateTimeFormat(locale, options),\n  )\n}\n\n/** The full name of one month, 0 being January. */\nexport function monthName(locale: string, month0: number): string {\n  return formatterFor(locale, { month: 'long', timeZone: 'UTC' }).format(Date.UTC(2021, month0, 1))\n}\n\n/**\n * A date written out for the reader, in the conventions of their locale — this is\n * what VDateInput shows in its field. An unparsable date yields an empty string\n * rather than a broken one.\n */\nexport function formatDateDisplay(\n  iso: string,\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): string {\n  const d = parseISO(iso)\n  return d ? formatterFor(locale, options).format(d) : ''\n}\n\n/**\n * A period written out for the reader. `Intl`'s own `formatRange` is what factors\n * out the parts the two dates share, giving \"19–26 June 2026\" rather than the two\n * full dates side by side. A period of a single day is formatted as that one date.\n */\nexport function formatDisplayRange(\n  start: string,\n  end: string,\n  locale: string,\n  options: Intl.DateTimeFormatOptions,\n): string {\n  const a = parseISO(start)\n  const b = parseISO(end)\n  if (!a || !b) return ''\n  const fmt = formatterFor(locale, options)\n  return compareISO(start, end) === 0 ? fmt.format(a) : fmt.formatRange(a, b)\n}\n\n/*\n * The numeric input mask, used by VDateInput when its field can be typed into.\n *\n * A field being typed into never shows the long display format — \"10 June 2026\" is\n * not something one can type — but a purely numeric mask instead. The order of the\n * three fields and the separator between them are DERIVED from the locale rather\n * than hardcoded, which is what makes the same field work for a reader in Tokyo and\n * one in Chicago.\n */\n\nexport type DateMaskField = 'day' | 'month' | 'year'\n\n/** Everything a locale decides about how a date is typed. */\nexport interface DateMask {\n  /**\n   * The order the three fields appear in: day, month, year in the United Kingdom,\n   * month, day, year in the United States, year, month, day in Japan.\n   */\n  order: readonly DateMaskField[]\n  /** The single character between two fields, stripped of bidi marks and spaces. */\n  separator: string\n  /** How many digits each field takes, in the same order: 4 for the year, 2 otherwise. */\n  lengths: readonly number[]\n  /** How many digits the complete mask holds, which is always 8. */\n  size: number\n}\n\nconst MASK_FALLBACK: DateMask = {\n  order: ['day', 'month', 'year'],\n  separator: '/',\n  lengths: [2, 2, 4],\n  size: 8,\n}\n\n/**\n * The date the mask is read from: 22 November 2021. Its three numbers all differ, so\n * whichever order the locale prints them in, each one can be told apart.\n */\nconst REF_MASK_DATE = Date.UTC(2021, 10, 22)\n\n/** The invisible direction marks some locales insert, such as U+200F before \"/\" in ar-EG. */\nconst BIDI_MARKS = /[‎‏؜]/g\n\nconst maskCache = new Map<string, DateMask>()\n\n/**\n * Works out how a date is typed in a given locale, by formatting a known date and\n * looking at what came out.\n *\n * The calendar and the numbering system are FORCED to Gregorian and Latin digits.\n * Without that, `fa-IR` answers with a Persian year (1400 rather than 2021) and\n * `ar-EG` with Arabic-Indic digits — two things a numeric field could neither\n * display nor read back. An invalid locale throws, and the answer then falls back to\n * day/month/year separated by \"/\".\n */\nexport function dateMaskFor(locale: string): DateMask {\n  return memo(maskCache, locale, () => buildDateMask(locale))\n}\n\n/*\n * TRAP — the returned `DateMask` is SHARED between every caller for a locale, so it must be\n * treated as read-only. Nothing mutates it today (it is read field by field in\n * `formatDateMask`, `parseDateMask` and `maskPlaceholder`), and it is the same contract the\n * memoized `Intl` formatters in this file already have.\n */\nfunction buildDateMask(locale: string): DateMask {\n  try {\n    const parts = new Intl.DateTimeFormat(locale, {\n      day: '2-digit',\n      month: '2-digit',\n      year: 'numeric',\n      timeZone: 'UTC',\n      calendar: 'gregory',\n      numberingSystem: 'latn',\n    }).formatToParts(REF_MASK_DATE)\n\n    const order = parts\n      .map((p) => p.type)\n      .filter((t): t is DateMaskField => t === 'day' || t === 'month' || t === 'year')\n\n    // The separator is the first literal appearing AFTER the first field, and not\n    // simply the first literal: Hungarian and Korean end the whole format with a dot\n    // (\"2021. 11. 22.\"), which must not be mistaken for it.\n    const firstField = parts.findIndex((p) => p.type !== 'literal')\n    const separator = parts\n      .slice(firstField)\n      .find((p) => p.type === 'literal')\n      ?.value.replace(BIDI_MARKS, '')\n      .trim()\n\n    if (order.length === 3 && separator) {\n      const lengths = order.map((f) => (f === 'year' ? 4 : 2))\n      return { order, separator, lengths, size: 8 }\n    }\n  } catch {\n    /* an invalid locale throws a RangeError: fall through to the fallback */\n  }\n  return MASK_FALLBACK\n}\n\n/**\n * Lays a run of digits out as masked text. The separator appears AS SOON AS the field\n * before it is full — typing \"22\" already gives \"22/\" — so the reader sees their\n * progress without ever having to type a separator themselves.\n *\n * This has a consequence the component must honour: pressing Backspace on such a\n * separator has to delete the DIGIT before it. Deleting the separator alone would\n * see the mask write it straight back, and the key would look dead.\n */\nexport function formatDateMask(digits: string, mask: DateMask): string {\n  const all = digitsOf(digits).slice(0, mask.size)\n  let out = ''\n  let i = 0\n  for (let f = 0; f < mask.lengths.length; f++) {\n    const len = mask.lengths[f] as number\n    const chunk = all.slice(i, i + len)\n    if (!chunk) break\n    out += chunk\n    i += len\n    if (chunk.length < len) break // this field is still being typed: no separator yet\n    if (f < mask.lengths.length - 1) out += mask.separator\n  }\n  return out\n}\n\n/**\n * Writes an ISO date in the mask of the locale, ready to be put in the field: the\n * same day reads \"10/06/2026\" in London and \"06/10/2026\" in Chicago.\n */\nexport function isoToMask(iso: string, mask: DateMask): string {\n  if (!isValidISO(iso)) return ''\n  const [year, month, day] = iso.split('-') as [string, string, string]\n  const by: Record<DateMaskField, string> = { year, month, day }\n  return formatDateMask(mask.order.map((f) => by[f]).join(''), mask)\n}\n\nexport interface ParseMaskOptions {\n  /**\n   * The century a two-digit year is expanded into: with 2000, \"10/06/26\" is read as\n   * 2026. It is only accepted when the year is the LAST field of the mask, since\n   * elsewhere the following separator already tells the two apart.\n   *\n   * Leaving it out refuses any year shorter than four digits, and that is the mode\n   * used while the reader types — so that \"26\", passed through on the way to \"2026\",\n   * is never committed as a year of its own.\n   */\n  yearPivot?: number\n}\n\n/**\n * Reads masked text back into an ISO date, or returns `null` when the text is\n * incomplete, holds too many digits, or names a day that does not exist — 31\n * February passes every length check and is caught by the round trip `isValidISO`\n * performs.\n *\n * Whether the resulting date is allowed is a different question: the `min`/`max`\n * bounds and the disabled dates belong to the component, and this function knows\n * nothing about props.\n */\nexport function parseDateMask(\n  text: string,\n  mask: DateMask,\n  options: ParseMaskOptions = {},\n): string | null {\n  const digits = digitsOf(text)\n  const by: Partial<Record<DateMaskField, string>> = {}\n  let i = 0\n  for (let k = 0; k < mask.order.length; k++) {\n    const field = mask.order[k] as DateMaskField\n    const len = mask.lengths[k] as number\n    const chunk = digits.slice(i, i + len)\n    if (chunk.length === len) i += len\n    else if (\n      field === 'year' &&\n      options.yearPivot !== undefined &&\n      k === mask.order.length - 1 &&\n      chunk.length === 2\n    )\n      i += 2\n    else return null\n    by[field] = chunk\n  }\n  if (i !== digits.length) return null // digits are left over: the entry is too long\n  const year =\n    (by.year as string).length === 2\n      ? String((options.yearPivot as number) + Number(by.year))\n      : (by.year as string)\n  const iso = `${year}-${by.month}-${by.day}`\n  return isValidISO(iso) ? iso : null\n}\n\n/**\n * Where the caret has to go to sit just after the nth digit. Counting digits is the\n * only landmark that survives a reformat: an absolute position jumps by one the\n * moment a separator appears or disappears, so restoring it would leave the caret in\n * the wrong place on exactly the keystrokes that matter.\n *\n * When a separator is passed and it directly follows that position, the caret steps\n * over it: while typing, it must land in the NEXT field rather than in front of a\n * separator that has just been written. On deletion the argument is omitted, so the\n * caret stays before it and the next Backspace reaches the digit.\n */\nexport function caretAfterDigits(text: string, n: number, separator?: string): number {\n  let pos = 0\n  if (n > 0) {\n    pos = text.length\n    let seen = 0\n    for (let i = 0; i < text.length; i++) {\n      const code = text.charCodeAt(i)\n      if (code >= 48 && code <= 57 && ++seen === n) {\n        pos = i + 1\n        break\n      }\n    }\n  }\n  if (separator && text.startsWith(separator, pos)) pos += separator.length\n  return pos\n}\n\nconst PLACEHOLDER_FALLBACK: Record<DateMaskField, string> = { day: 'd', month: 'm', year: 'y' }\n\n/**\n * Ideographic scripts, which are excluded from the placeholder: a repeated \"日\" does\n * not read as a template the way a repeated letter does.\n */\nconst IDEOGRAPHIC = /[\\p{sc=Han}\\p{sc=Hangul}\\p{sc=Hiragana}\\p{sc=Katakana}]/u\n\n// @fallback\n/**\n * The empty template shown in the field: \"dd/mm/yyyy\" in English, \"jj/mm/aaaa\" in\n * French, \"tt.mm.jjjj\" in German, \"дд/мм/гггг\" in Russian.\n *\n * Each letter is the first letter of the field's own name in that language, taken\n * from `Intl.DisplayNames` — which lands on the attested convention of every\n * alphabetic script without a table to maintain. It falls back to the Latin letters\n * when that part of `Intl` is missing, or when the script is ideographic and the\n * repetition would mean nothing.\n */\nexport function maskPlaceholder(locale: string, mask: DateMask): string {\n  const letters = placeholderLetters(locale)\n  return mask.order.map((f, k) => letters[f].repeat(mask.lengths[k] as number)).join(mask.separator)\n}\n\nconst placeholderLetterCache = new Map<string, typeof PLACEHOLDER_FALLBACK>()\n\n/**\n * The three letters a locale writes its date fields with, worked out once per locale.\n *\n * The LETTERS are cached, not the finished placeholder: that also depends on the mask handed\n * in, and would be wrong the moment a caller passes one that is not `dateMaskFor(locale)`.\n * All the cost is here anyway — `Intl.DisplayNames` is this file's most expensive\n * constructor by an order of magnitude (~0.22 ms against ~0.07 for `dateMaskFor`).\n */\nfunction placeholderLetters(locale: string): typeof PLACEHOLDER_FALLBACK {\n  return memo(placeholderLetterCache, locale, () => buildPlaceholderLetters(locale))\n}\n\nfunction buildPlaceholderLetters(locale: string): typeof PLACEHOLDER_FALLBACK {\n  const letters = { ...PLACEHOLDER_FALLBACK }\n  try {\n    const names = new Intl.DisplayNames(locale, { type: 'dateTimeField' })\n    for (const field of ['day', 'month', 'year'] as const) {\n      const first = [...(names.of(field) ?? '')][0]\n      if (first && /\\p{L}/u.test(first) && !IDEOGRAPHIC.test(first))\n        letters[field] = first.toLocaleLowerCase(locale)\n    }\n  } catch {\n    /* Intl.DisplayNames is unavailable here: keep the Latin letters */\n  }\n  return letters\n}\n"],"mappings":"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"}

package/dist/utils/direction.d.ts

@@ -1,18 +1,12 @@
 /**
  * Whether an element is laid out right to left.
  *
- * The design system does almost everything in LOGICAL properties, which mirror themselves
- * and need no help. This exists for the handful of places that cannot: a key name
- * (`ArrowRight`), a pointer coordinate and a scroll delta are all PHYSICAL, so the code
- * reading them has to know which way the inline axis runs before it can decide what
- * "forward" means.
+ * Logical properties mirror themselves, so this exists only for what cannot: key names
+ * (`ArrowRight`), pointer coordinates and scroll deltas are physical, and the code reading
+ * them has to know which way the inline axis runs before "forward" means anything.
  *
- * It reads the COMPUTED direction rather than the `dir` attribute on purpose: `dir` may sit
- * on any ancestor, or come from a stylesheet, and only the computed value accounts for both.
- * That read forces a style recalculation, so callers ask at event time — never in a render
- * or a loop.
- *
- * A null element answers `false`: a component whose ref is not set yet has nothing laid out,
- * and left to right is the assumption the rest of the code already makes.
+ * The COMPUTED direction, not the `dir` attribute, which may sit on any ancestor or come
+ * from a stylesheet. That read forces a style recalculation — ask at event time, never in a
+ * render or a loop. A null element answers `false`, the assumption the rest of the code makes.
  */
 export declare function isRtl(el: Element | null | undefined): boolean;

package/dist/utils/direction.js.map

@@ -1 +1 @@
-{"version":3,"file":"direction.js","names":[],"sources":["../../src/utils/direction.ts"],"sourcesContent":["// @core\n/**\n * Whether an element is laid out right to left.\n *\n * The design system does almost everything in LOGICAL properties, which mirror themselves\n * and need no help. This exists for the handful of places that cannot: a key name\n * (`ArrowRight`), a pointer coordinate and a scroll delta are all PHYSICAL, so the code\n * reading them has to know which way the inline axis runs before it can decide what\n * \"forward\" means.\n *\n * It reads the COMPUTED direction rather than the `dir` attribute on purpose: `dir` may sit\n * on any ancestor, or come from a stylesheet, and only the computed value accounts for both.\n * That read forces a style recalculation, so callers ask at event time — never in a render\n * or a loop.\n *\n * A null element answers `false`: a component whose ref is not set yet has nothing laid out,\n * and left to right is the assumption the rest of the code already makes.\n */\nexport function isRtl(el: Element | null | undefined): boolean {\n  return el != null && getComputedStyle(el).direction === 'rtl'\n}\n"],"mappings":";AAkBA,SAAgB,EAAM,GAAyC;CAC7D,OAAO,KAAM,QAAQ,iBAAiB,CAAE,CAAC,CAAC,cAAc;AAC1D"}
+{"version":3,"file":"direction.js","names":[],"sources":["../../src/utils/direction.ts"],"sourcesContent":["// @core\n/**\n * Whether an element is laid out right to left.\n *\n * Logical properties mirror themselves, so this exists only for what cannot: key names\n * (`ArrowRight`), pointer coordinates and scroll deltas are physical, and the code reading\n * them has to know which way the inline axis runs before \"forward\" means anything.\n *\n * The COMPUTED direction, not the `dir` attribute, which may sit on any ancestor or come\n * from a stylesheet. That read forces a style recalculation — ask at event time, never in a\n * render or a loop. A null element answers `false`, the assumption the rest of the code makes.\n */\nexport function isRtl(el: Element | null | undefined): boolean {\n  return el != null && getComputedStyle(el).direction === 'rtl'\n}\n"],"mappings":";AAYA,SAAgB,EAAM,GAAyC;CAC7D,OAAO,KAAM,QAAQ,iBAAiB,CAAE,CAAC,CAAC,cAAc;AAC1D"}

package/dist/utils/env.d.ts

@@ -1,10 +1,9 @@
 /**
- * Whether the library is running in a development build. It is what the design system's
- * warnings are gated on — an icon-only button with no name, two options that contradict
- * each other — so that none of them reaches a finished application.
+ * Whether the library is running in a development build. Every integrator-facing warning
+ * is gated on it, so none reaches a finished application.
  *
- * The flag comes from the build tool the library is developed with, and it is looked up
- * cautiously: an application built with a different tool may not provide it at all, and
- * every warning then simply stays silent rather than failing.
+ * Looked up cautiously: the flag comes from the build tool the library is developed with,
+ * and an application built with another may not provide it — the warnings then stay silent
+ * rather than failing.
  */
 export declare const isDev: boolean;