@stll/ui 0.0.1-placeholder.0 → 0.2.0

package/dist/lib/week.d.ts

@@ -0,0 +1,25 @@
+//#region src/lib/week.d.ts
+/**
+ * Locale week data (first weekday, weekend) derived from CLDR via Intl.
+ * Shared so the app shell and the date picker resolve week starts identically.
+ */
+/**
+ * Read CLDR week info for a locale, tolerating the legacy `weekInfo` accessor
+ * on engines that predate `getWeekInfo()`. Returns undefined when unavailable
+ * so callers can apply their own fallback.
+ */
+declare const getLocaleWeekInfo: (locale: string) => Intl.WeekInfo | undefined;
+/**
+ * First weekday as a `Date.getDay()` value (0 = Sunday … 6 = Saturday): Monday
+ * across most of Europe, Sunday in the US, Saturday across much of the Gulf.
+ * Falls back to Monday when the runtime lacks week info.
+ */
+declare const getFirstWeekday: (locale: string) => number;
+/**
+ * Weekend weekdays as `Date.getDay()` values (0 = Sunday … 6 = Saturday):
+ * Saturday/Sunday across the West, Friday/Saturday across much of the Gulf.
+ * Falls back to Saturday/Sunday when the runtime lacks week info.
+ */
+declare const getWeekendDays: (locale: string) => ReadonlySet<number>;
+//#endregion
+export { getFirstWeekday, getLocaleWeekInfo, getWeekendDays };

package/dist/lib/week.js

@@ -0,0 +1,40 @@
+//#region src/lib/week.ts
+/**
+* Locale week data (first weekday, weekend) derived from CLDR via Intl.
+* Shared so the app shell and the date picker resolve week starts identically.
+*/
+/**
+* Read CLDR week info for a locale, tolerating the legacy `weekInfo` accessor
+* on engines that predate `getWeekInfo()`. Returns undefined when unavailable
+* so callers can apply their own fallback.
+*/
+const getLocaleWeekInfo = (locale) => {
+	try {
+		const loc = new Intl.Locale(locale);
+		const legacy = loc;
+		return typeof loc.getWeekInfo === "function" ? loc.getWeekInfo() : legacy.weekInfo;
+	} catch {
+		return;
+	}
+};
+/**
+* First weekday as a `Date.getDay()` value (0 = Sunday … 6 = Saturday): Monday
+* across most of Europe, Sunday in the US, Saturday across much of the Gulf.
+* Falls back to Monday when the runtime lacks week info.
+*/
+const getFirstWeekday = (locale) => {
+	const firstDay = getLocaleWeekInfo(locale)?.firstDay;
+	return typeof firstDay === "number" ? firstDay % 7 : 1;
+};
+/**
+* Weekend weekdays as `Date.getDay()` values (0 = Sunday … 6 = Saturday):
+* Saturday/Sunday across the West, Friday/Saturday across much of the Gulf.
+* Falls back to Saturday/Sunday when the runtime lacks week info.
+*/
+const getWeekendDays = (locale) => {
+	const weekend = getLocaleWeekInfo(locale)?.weekend;
+	if (weekend && weekend.length > 0) return new Set(weekend.map((day) => day % 7));
+	return /* @__PURE__ */ new Set([0, 6]);
+};
+//#endregion
+export { getFirstWeekday, getLocaleWeekInfo, getWeekendDays };