@lekoala/date-picker 0.1.1 → 0.3.0

package/src/intl.js

@@ -51,6 +51,41 @@ export function formatMonthYear(value, locale = "") {
   }).format(toIntlDate(`${value.slice(0, 7)}-15`));
 }
 
+/**
+ * Locale order of the visible month/year controls, derived from `Intl` so no
+ * `showMonthAfterYear`-style option is needed. Year-like parts cover the
+ * `relatedYear` / `yearName` variants some calendars expose; anything
+ * unrecognized falls back to month-then-year. This is independent of `dir`:
+ * the locale decides the linguistic order, direction only mirrors the layout.
+ * @param {string} [locale] @returns {["month", "year"] | ["year", "month"]}
+ */
+export function monthYearOrder(locale = "") {
+  const resolved = resolveLocale(locale);
+  try {
+    const parts = new Intl.DateTimeFormat(resolved, {
+      calendar: "gregory",
+      year: "numeric",
+      month: "long",
+      timeZone: "UTC",
+    }).formatToParts(toIntlDate("2026-09-15"));
+    let monthIndex = -1;
+    let yearIndex = -1;
+    parts.forEach((part, index) => {
+      const type = /** @type {string} */ (part.type);
+      if (type === "month") {
+        if (monthIndex < 0) monthIndex = index;
+      } else if (type === "year" || type === "relatedYear" || type === "yearName") {
+        if (yearIndex < 0) yearIndex = index;
+      }
+    });
+    if (monthIndex >= 0 && yearIndex >= 0)
+      return yearIndex < monthIndex ? ["year", "month"] : ["month", "year"];
+  } catch {
+    // Fall through to the default below.
+  }
+  return ["month", "year"];
+}
+
 /** @param {string} [locale] @param {"long"|"short"} [style] */
 export function monthNames(locale = "", style = "long") {
   const resolved = resolveLocale(locale);

package/src/time.js

@@ -0,0 +1,39 @@
+const TIME_RE = /^(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3}))?)?$/;
+
+/**
+ * Parse one canonical HTML time value (`HH:MM`, `HH:MM:SS`, `HH:MM:SS.fff`).
+ * @param {string} value
+ * @returns {{hour:number, minute:number, second:number, millisecond:number} | null}
+ */
+function parseTimeParts(value) {
+  const match = TIME_RE.exec(String(value || ""));
+  if (!match) return null;
+  const hour = Number(match[1]);
+  const minute = Number(match[2]);
+  const second = match[3] === undefined ? 0 : Number(match[3]);
+  const millisecond = match[4] === undefined ? 0 : Number(match[4].padEnd(3, "0"));
+  if (hour > 23 || minute > 59 || second > 59 || millisecond > 999) return null;
+  return { hour, minute, second, millisecond };
+}
+
+/** Civil time check for canonical `input[type=time]` values. @param {string} value */
+export function isTime(value) {
+  return parseTimeParts(value) !== null;
+}
+
+/** @param {{hour:number, minute:number, second:number, millisecond:number}} parts */
+function toMillis(parts) {
+  return ((parts.hour * 60 + parts.minute) * 60 + parts.second) * 1000 + parts.millisecond;
+}
+
+/**
+ * Compare two canonical time values. `09:30` equals `09:30:00`.
+ * @param {string} a @param {string} b
+ */
+export function compareTimes(a, b) {
+  const left = parseTimeParts(a);
+  const right = parseTimeParts(b);
+  if (!left || !right) throw new TypeError("compareTimes() expects HH:MM values");
+  const diff = toMillis(left) - toMillis(right);
+  return diff === 0 ? 0 : diff < 0 ? -1 : 1;
+}