@viasat/beam-react 2.73.0 → 2.74.0

package/lib/DateField/DateField.devWarnings.es.js

@@ -1,14 +1,15 @@
-import { useEffect as o } from "react";
-import { isMinMaxMisconfigured as l, dateKeyOrNull as t, isValidDate as s } from "./DateField.utils.es.js";
-const c = (e, a) => {
-  o(() => {
-    process.env.NODE_ENV !== "production" && l(e, a) && console.warn(
+import { useEffect as s } from "react";
+import { isMinMaxMisconfigured as r, dateKeyOrNull as t } from "./DateField.utils.es.js";
+import { i as o } from "../../chunks/dates.NqdbQ2fR.js";
+const f = (e, a) => {
+  s(() => {
+    process.env.NODE_ENV !== "production" && r(e, a) && console.warn(
       "DateField: `minDate` is after `maxDate` — no date satisfies both, so the blur clamp is disabled and values are left as typed."
     );
   }, [t(e), t(a)]);
 }, u = (e, a) => {
-  const n = e instanceof Date && !s(e), i = a instanceof Date && !s(a);
-  o(() => {
+  const n = e instanceof Date && !o(e), i = a instanceof Date && !o(a);
+  s(() => {
     process.env.NODE_ENV !== "production" && (n && console.warn(
       "DateField: `value` is an Invalid Date; rendering with no value."
     ), i && console.warn(
@@ -18,5 +19,5 @@ const c = (e, a) => {
 };
 export {
   u as useDevInvalidValueWarning,
-  c as useDevMinMaxWarning
+  f as useDevMinMaxWarning
 };

package/lib/DateField/DateField.es.js

@@ -1,239 +1,241 @@
-import { jsxs as W, jsx as s } from "react/jsx-runtime";
-import $e from "clsx";
-import { forwardRef as He, useRef as u, useMemo as Ke, useCallback as o } from "react";
-import { s as t, b as je, c as i, a as g } from "../../chunks/DateField.Segment.CcTNVHpE.js";
-import { d as qe } from "../../chunks/input.Bh4COLFp.js";
-import { t as We } from "../../chunks/constants.XFX4nOSf.js";
-import { i as Ye } from "../../chunks/helpers.DWdxSU31.js";
-import { H as _e } from "../../chunks/form.context.DZSt9YJH.js";
-import { LabelProvider as ke } from "../Form/contexts/label.context.es.js";
-import { HelperTextProvider as ze } from "../Form/contexts/helperText.context.es.js";
-import { useIsMounted as Ue } from "../../utils/hooks/useIsMounted.es.js";
-import { mergeRefs as Ge } from "../../utils/functions.es.js";
-import { ErrorBoundary as Je } from "../_ErrorBoundary/ErrorBoundary.es.js";
-import { DateFieldSegments as Qe } from "./DateField.Segments.es.js";
-import { useDevMinMaxWarning as Xe, useDevInvalidValueWarning as Ze } from "./DateField.devWarnings.es.js";
-import { getDateParts as er, getSegmentOrder as rr, toISODateString as ar, DEFAULT_LOCALE as Y } from "./DateField.utils.es.js";
-import { useDateFieldFocus as tr } from "./useDateFieldFocus.es.js";
-import { useDateFieldForm as sr } from "./useDateFieldForm.es.js";
-import { useDateFieldKeyboard as nr } from "./useDateFieldKeyboard.es.js";
-import { useDateFieldSegments as lr } from "./useDateFieldSegments.es.js";
-import { useDateFieldValidity as or } from "./useDateFieldValidity.es.js";
-import { useDateFieldValue as ir } from "./useDateFieldValue.es.js";
-import { useInvalidState as dr } from "./useInvalidState.es.js";
-const cr = "MM/DD/YYYY", ur = () => {
+import { jsxs as Y, jsx as s } from "react/jsx-runtime";
+import He from "clsx";
+import { forwardRef as Ke, useRef as u, useMemo as je, useCallback as n } from "react";
+import { s as t, b as qe, c as i, a as g } from "../../chunks/DateField.Segment.CbBsfqKp.js";
+import { d as We } from "../../chunks/input.Bh4COLFp.js";
+import { t as Ye } from "../../chunks/constants.XFX4nOSf.js";
+import { i as _e } from "../../chunks/helpers.BUsAyYMh.js";
+import { D as _ } from "../../chunks/dates.NqdbQ2fR.js";
+import { H as ke } from "../../chunks/form.context.CW5SOzlz.js";
+import { LabelProvider as ze } from "../Form/contexts/label.context.es.js";
+import { HelperTextProvider as Ue } from "../Form/contexts/helperText.context.es.js";
+import { useIsMounted as Ge } from "../../utils/hooks/useIsMounted.es.js";
+import { mergeRefs as Je } from "../../utils/functions.es.js";
+import { ErrorBoundary as Qe } from "../_ErrorBoundary/ErrorBoundary.es.js";
+import { DateFieldSegments as Xe } from "./DateField.Segments.es.js";
+import { useDevMinMaxWarning as Ze, useDevInvalidValueWarning as er } from "./DateField.devWarnings.es.js";
+import { getDateParts as rr, getSegmentOrder as ar, toISODateString as tr } from "./DateField.utils.es.js";
+import { useDateFieldFocus as sr } from "./useDateFieldFocus.es.js";
+import { useDateFieldForm as or } from "./useDateFieldForm.es.js";
+import { useDateFieldKeyboard as lr } from "./useDateFieldKeyboard.es.js";
+import { useDateFieldSegments as nr } from "./useDateFieldSegments.es.js";
+import { useDateFieldValidity as ir } from "./useDateFieldValidity.es.js";
+import { useDateFieldValue as dr } from "./useDateFieldValue.es.js";
+import { useInvalidState as cr } from "./useInvalidState.es.js";
+const ur = "MM/DD/YYYY", mr = () => {
   process.env.NODE_ENV !== "production" && console.warn("DateField: segments failed to render; showing a static fallback.");
-}, Ar = He(
+}, $r = Ke(
   function({
     value: v,
     defaultValue: D,
-    onChange: _,
+    onChange: k,
     minDate: F,
     maxDate: h,
-    getClampAnnouncement: k,
-    locale: z,
+    getClampAnnouncement: z,
+    locale: U,
     label: S = null,
     helperText: x = null,
-    error: I,
-    hideRequiredMarker: U = !1,
-    validationRules: G,
-    width: J,
-    theme: y,
-    fluid: Q = !1,
-    size: X = qe,
-    disabled: Z = !1,
-    readOnly: ee = !1,
-    required: re = !1,
+    error: y,
+    hideRequiredMarker: G = !1,
+    validationRules: J,
+    width: Q,
+    theme: I,
+    fluid: X = !1,
+    size: Z = We,
+    disabled: ee = !1,
+    readOnly: re = !1,
+    required: ae = !1,
     name: M,
-    id: ae,
-    className: te,
-    style: se,
-    "aria-label": ne,
-    "aria-describedby": le,
-    "aria-labelledby": oe,
-    ...ie
+    id: te,
+    className: se,
+    style: oe,
+    "aria-label": le,
+    "aria-describedby": ne,
+    "aria-labelledby": ie,
+    ...de
   }, R) {
     const {
       disabled: e,
-      readOnly: n,
+      readOnly: o,
       required: E,
-      invalid: de,
+      invalid: ce,
       errorMessageProvided: N,
-      defaultValue: ce,
-      errorId: O,
-      helperTextId: ue,
-      validationErrorsId: me,
-      labelId: w,
-      ariaDescribedBy: fe,
-      ariaLabelledBy: pe,
-      showErrors: be
-    } = sr({
+      defaultValue: ue,
+      errorId: L,
+      helperTextId: me,
+      validationErrorsId: fe,
+      labelId: O,
+      ariaDescribedBy: pe,
+      ariaLabelledBy: be,
+      showErrors: ge
+    } = or({
       name: M,
-      disabled: Z,
-      readOnly: ee,
-      required: re,
+      disabled: ee,
+      readOnly: re,
+      required: ae,
       defaultValue: D,
-      error: I,
+      error: y,
       hasHelperText: !!x,
       hasLabel: !!S,
-      validationRules: G,
-      ariaDescribedBy: le,
-      ariaLabelledBy: oe
+      validationRules: J,
+      ariaDescribedBy: ne,
+      ariaLabelledBy: ie
     });
-    Xe(F, h), Ze(v, D);
-    const l = u(null), { segmentRefs: ge, registerSegmentRef: ve } = lr(), De = z ?? Y, C = Ue(), m = er(C ? De : Y), d = Ke(() => rr(m), [m]), {
-      segmentText: Fe,
-      segmentValues: L,
-      currentValue: B,
-      wasTouched: he,
-      appendDigit: V,
-      adjustSegment: Se,
-      clearSegment: xe,
-      clearAll: T,
+    Ze(F, h), er(v, D);
+    const l = u(null), { segmentRefs: ve, registerSegmentRef: De } = nr(), Fe = U ?? _, w = Ge(), C = w ? Fe : _, m = rr(C), d = je(() => ar(m), [m]), {
+      segmentText: he,
+      segmentValues: B,
+      currentValue: V,
+      wasTouched: Se,
+      appendDigit: T,
+      adjustSegment: xe,
+      clearSegment: ye,
+      clearAll: A,
       beginSegmentEdit: Ie,
-      commitOnBlur: ye,
-      clampAnnouncement: Me
-    } = ir({
+      commitOnBlur: Me,
+      clampAnnouncement: Re
+    } = dr({
       value: v,
-      defaultValue: ce,
-      onChange: _,
+      defaultValue: ue,
+      onChange: k,
       minDate: F,
       maxDate: h,
-      getClampAnnouncement: k
+      getClampAnnouncement: z
     }), {
-      focusedSegment: A,
-      fieldTabIndex: Re,
+      focusedSegment: P,
+      fieldTabIndex: Ee,
       handleSegmentFocus: c,
-      handleFieldFocus: Ee,
-      handleFieldBlur: Ne,
+      handleFieldFocus: Ne,
+      handleFieldBlur: Le,
       handleFieldMouseDown: Oe,
       focusNext: f,
       focusPrevious: we
-    } = tr({
+    } = sr({
       disabled: e,
       fieldRef: l,
-      segmentRefs: ge,
+      segmentRefs: ve,
       partsOrder: d,
       onSegmentFocusChange: Ie,
-      onFieldBlur: ye
-    }), Ce = nr({
+      onFieldBlur: Me
+    }), Ce = lr({
       disabled: e,
-      readOnly: n,
+      readOnly: o,
       fieldRef: l,
       focusNext: f,
       focusPrevious: we,
-      adjustSegment: Se,
-      clearSegment: xe
-    }), { isInvalid: Le } = or({
-      segments: L,
-      currentValue: B,
-      wasTouched: he,
-      isFocused: A !== null
-    }), Be = o(
+      adjustSegment: xe,
+      clearSegment: ye
+    }), { isInvalid: Be } = ir({
+      segments: B,
+      currentValue: V,
+      wasTouched: Se,
+      isFocused: P !== null
+    }), Ve = n(
       (r, a) => {
-        const { advanced: b } = V(r, a);
+        const { advanced: b } = T(r, a);
         b && f(r);
       },
-      [V, f]
-    ), p = dr({
-      formInvalid: de,
-      valueInvalid: Le
-    }), Ve = C && Ye() ? "textbox" : "spinbutton", P = o(
+      [T, f]
+    ), p = cr({
+      formInvalid: ce,
+      valueInvalid: Be
+    }), Te = w && _e() ? "textbox" : "spinbutton", $ = n(
       (r) => {
         e || c(d[0], r);
       },
       [e, c, d]
-    ), $ = o(() => {
+    ), H = n(() => {
       var a;
       if (e) return;
       const r = document.activeElement;
       r instanceof HTMLElement && r !== l.current && ((a = l.current) != null && a.contains(r)) && r.blur();
-    }, [e]), H = o(() => {
-      e || n || T();
-    }, [e, n, T]), K = u(P), j = u($), q = u(H);
-    K.current = P, j.current = $, q.current = H;
-    const Te = o(
+    }, [e]), K = n(() => {
+      e || o || A();
+    }, [e, o, A]), j = u($), q = u(H), W = u(K);
+    j.current = $, q.current = H, W.current = K;
+    const Ae = n(
       (r) => {
         const a = r ? Object.assign(r, {
-          focus: (b) => K.current(b),
-          blur: () => j.current(),
-          clear: () => q.current()
+          focus: (b) => j.current(b),
+          blur: () => q.current(),
+          clear: () => W.current()
         }) : null;
-        Ge(
+        Je(
           l,
           R
         )(a);
       },
       [R]
-    ), Ae = (r) => {
+    ), Pe = (r) => {
       if (e) return;
       const a = r.target.closest("label");
-      !a || a.id !== w || (r.preventDefault(), c(d[0]));
-    }, Pe = $e(
-      t[je],
-      y && We(y),
-      t[`${i}${X}`],
-      Q && t[`${i}fluid`],
+      !a || a.id !== O || (r.preventDefault(), c(d[0]));
+    }, $e = He(
+      t[qe],
+      I && Ye(I),
+      t[`${i}${Z}`],
+      X && t[`${i}fluid`],
       p && t[`${i}error`],
       e && t[`${i}disabled`],
-      n && t[`${i}read-only`],
-      te
+      o && t[`${i}read-only`],
+      se
     );
-    return /* @__PURE__ */ W(
+    return /* @__PURE__ */ Y(
       "div",
       {
-        className: Pe,
-        style: { ...se, maxWidth: J },
-        onMouseDownCapture: Ae,
+        className: $e,
+        style: { ...oe, maxWidth: Q },
+        onMouseDownCapture: Pe,
         children: [
           /* @__PURE__ */ s(
-            ke,
+            ze,
             {
-              ctxId: w,
+              ctxId: O,
               ctxDisabled: e,
-              ctxRequired: E && !U,
+              ctxRequired: E && !G,
               children: S
             }
           ),
           /* @__PURE__ */ s(
             "div",
             {
-              ...ie,
-              ref: Te,
-              id: ae,
+              ...de,
+              ref: Ae,
+              id: te,
               role: "group",
-              "aria-label": ne,
-              "aria-labelledby": pe,
+              "aria-label": le,
+              "aria-labelledby": be,
               "aria-disabled": e || void 0,
               "aria-invalid": p || void 0,
-              "aria-describedby": fe,
-              "aria-errormessage": N ? O : void 0,
-              tabIndex: Re,
+              "aria-describedby": pe,
+              "aria-errormessage": N ? L : void 0,
+              tabIndex: Ee,
               className: t[g.field],
               onMouseDown: Oe,
-              onFocus: Ee,
+              onFocus: Ne,
               children: /* @__PURE__ */ s(
-                Je,
+                Qe,
                 {
-                  fallback: /* @__PURE__ */ s("span", { className: t[g.segments], children: cr }),
-                  onError: ur,
+                  fallback: /* @__PURE__ */ s("span", { className: t[g.segments], children: ur }),
+                  onError: mr,
                   children: /* @__PURE__ */ s(
-                    Qe,
+                    Xe,
                     {
                       parts: m,
-                      segmentText: Fe,
-                      segmentValues: L,
-                      focusedSegment: A,
+                      locale: C,
+                      segmentText: he,
+                      segmentValues: B,
+                      focusedSegment: P,
                       disabled: e,
-                      readOnly: n,
+                      readOnly: o,
                       required: E,
                       invalid: p,
-                      role: Ve,
+                      role: Te,
                       onSegmentFocus: c,
-                      onSegmentBlur: Ne,
-                      onSegmentInput: Be,
+                      onSegmentBlur: Le,
+                      onSegmentInput: Ve,
                       onSegmentKeyDown: Ce,
-                      registerSegmentRef: ve
+                      registerSegmentRef: De
                     }
                   )
                 }
@@ -247,7 +249,7 @@ const cr = "MM/DD/YYYY", ur = () => {
               "aria-live": "polite",
               "aria-atomic": "true",
               className: t[g.srStatus],
-              children: Me
+              children: Re
             }
           ),
           /* @__PURE__ */ s(
@@ -255,20 +257,20 @@ const cr = "MM/DD/YYYY", ur = () => {
             {
               type: "hidden",
               name: M,
-              value: ar(B),
+              value: tr(V),
               disabled: e
             }
           ),
-          /* @__PURE__ */ W(ze, { ctxId: ue, ctxDisabled: e, children: [
+          /* @__PURE__ */ Y(Ue, { ctxId: me, ctxDisabled: e, children: [
             x,
-            N && /* @__PURE__ */ s(_e, { id: O, appearance: "negative", children: I })
+            N && /* @__PURE__ */ s(ke, { id: L, appearance: "negative", children: y })
           ] }),
-          be(me)
+          ge(fe)
         ]
       }
     );
   }
 );
 export {
-  Ar as DateField
+  $r as DateField
 };

package/lib/DateField/DateField.types.d.ts

@@ -126,7 +126,8 @@ export interface DateFieldProps extends DateFieldInputAttributes {
     getClampAnnouncement?: (clampedDate: Date) => string;
     /**
      * Specify the BCP-47 locale tag driving segment order and separators
-     * (e.g. `en-GB` → DD/MM/YYYY, `de-DE` → DD.MM.YYYY)
+     * (e.g. `en-GB` → DD/MM/YYYY, `de-DE` → DD.MM.YYYY), and the month name a
+     * screen reader announces for the month segment ("März" for `03` in de-DE).
      * @default 'en-US'
      */
     locale?: string;

package/lib/DateField/DateField.utils.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../chunks/constants.DLsDVPyH.js");const A=require("../../chunks/helpers.CugcWtbW.js"),d=require("./DateField.validation.cjs.js"),l="en-US",N=new Intl.DateTimeFormat("en-US",{month:"long"}),w=e=>N.format(new Date(2e3,e-1,1)),u=31,i=12,m=1,f=9999,M=(e,t,n)=>Math.min(n,Math.max(t,e)),T=(e,t)=>((e-1)%t+t)%t+1,F=2024,P=(e,t)=>t==null?31:new Date(e??F,t,0).getDate(),R=()=>{const e=new Date;return{day:e.getDate(),month:e.getMonth()+1,year:e.getFullYear()}},o=e=>e instanceof Date&&!Number.isNaN(e.getTime()),I=(e,t,n,r)=>{if(n==="min")return e==="year"?null:1;if(n==="max")return e==="year"?null:e==="day"?r.daysInMonth:i;if(t==null){if(e==="year")return r.today.year;const E=e==="day"?u:i;return n>0?1:E}if(e==="year")return M(t+n,m,f);const a=e==="day"?u:i;return T(t+n,a)},L={day:"",month:"",year:""},h=e=>{const{day:t,month:n,year:r}=e;if(t==null||n==null||r==null)return null;const a=new Date(r,n-1,t);return a.setFullYear(r),Number.isNaN(a.getTime())||a.getFullYear()!==r||a.getMonth()!==n-1||a.getDate()!==t?null:a},Y=(e,t)=>e==null&&t==null?!0:e==null||t==null?!1:e.getTime()===t.getTime(),s=A.dateToDayKey,O=e=>o(e)?s(e):null,V=(e,t,n)=>{const r=s(e);return!(o(t)&&r<s(t)||o(n)&&r>s(n))},_=(e,t)=>o(e)&&o(t)&&s(e)>s(t),C=(e,t,n)=>{if(_(t,n))return e;const r=s(e);return o(t)&&r<s(t)?new Date(t.getFullYear(),t.getMonth(),t.getDate()):o(n)&&r>s(n)?new Date(n.getFullYear(),n.getMonth(),n.getDate()):e},X=e=>{if(!o(e))return"";const t=String(e.getFullYear()).padStart(4,"0"),n=String(e.getMonth()+1).padStart(2,"0"),r=String(e.getDate()).padStart(2,"0");return`${t}-${n}-${r}`},p=e=>e.type==="literal",D=e=>e.filter(t=>!p(t)).map(t=>t.type),b=new Date(2020,0,2),G=new Set([8206,8207,8234,8235,8236,8237,8238,8294,8295,8296,8297]),H=e=>[...e].filter(t=>!G.has(t.codePointAt(0)??-1)).join(""),K=new Set(["day","month","year","literal"]),y=3,S=e=>{try{const t=new Intl.DateTimeFormat(e,{year:"numeric",month:"2-digit",day:"2-digit",calendar:"gregory"}).formatToParts(b).filter(r=>K.has(r.type)).map(r=>({type:r.type,value:r.type==="literal"?H(r.value):""})),n=D(t);return n.length===y&&new Set(n).size===y?t:null}catch{return null}},g=new Map,$=e=>{try{return new Intl.Locale(e).toString()}catch{return e.toLowerCase()}},k=e=>{try{return Intl.DateTimeFormat.supportedLocalesOf([e]).length>0}catch{return!1}},U=e=>{const t=$(e),n=g.get(t);if(n)return n;const r=k(e);!r&&process.env.NODE_ENV!=="production"&&console.warn(`DateField: locale "${e}" is not supported; falling back to ${l}.`);const a=(r?S(e):null)??S(l);if(!a)throw new Error(`DateField: Intl cannot resolve ${l} date parts`);return g.set(t,a),a},j=()=>g.clear(),q=e=>o(e)?{day:String(e.getDate()).padStart(2,"0"),month:String(e.getMonth()+1).padStart(2,"0"),year:String(e.getFullYear()).padStart(4,"0")}:L,c=(e,t)=>{if(t===""||e==="year"&&t.length<d.SEGMENT_MAX_LENGTH.year)return null;const n=parseInt(t,10);return Number.isNaN(n)||n===0?null:n},v=e=>h({day:c("day",e.day),month:c("month",e.month),year:c("year",e.year)}),z=(e,t)=>t===""?"":t.padStart(d.SEGMENT_MAX_LENGTH[e],"0"),B=(e,t,n)=>t===""?{displayValue:n,isPlaceholder:!0}:{displayValue:t.padStart(d.SEGMENT_MAX_LENGTH[e],"0"),isPlaceholder:!1},W=e=>{const t=window.getSelection();if(!t)return;const n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)},J=e=>{var n;if(!e)return;const t=(n=window.getSelection)==null?void 0:n.call(window);t&&t.rangeCount>0&&e.contains(t.anchorNode)&&t.removeAllRanges()};exports.DAY_SPIN_MAX=u;exports.DEFAULT_LOCALE=l;exports.MONTH_MAX=i;exports.YEAR_MAX=f;exports.YEAR_MIN=m;exports.__clearDatePartsCache=j;exports.adjustSegmentValue=I;exports.clamp=M;exports.clampDateToRange=C;exports.clearSelectionWithin=J;exports.dateKeyOrNull=O;exports.deriveValue=h;exports.deriveValueFromText=v;exports.getDateParts=U;exports.getDaysInMonth=P;exports.getMonthName=w;exports.getSegmentDisplay=B;exports.getSegmentOrder=D;exports.isDateInRange=V;exports.isLiteralPart=p;exports.isMinMaxMisconfigured=_;exports.isSameDateValue=Y;exports.isValidDate=o;exports.normalizeSegmentText=z;exports.segmentNumber=c;exports.segmentTextFromValue=q;exports.selectElementContents=W;exports.toISODateString=X;exports.todayParts=R;exports.wrapInRange=T;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../../chunks/constants.DLsDVPyH.js");const r=require("../../chunks/dates.CVW08OQ2.js"),u=require("./DateField.validation.cjs.js"),y=r.createBoundedMemo(r.canonicalLocaleKey,e=>new Intl.DateTimeFormat(r.resolveLocale(e),{month:"long",calendar:"gregory",timeZone:"UTC"})),p=(e,t=r.DEFAULT_LOCALE)=>y(t).format(Date.UTC(2e3,e-1,1)),c=31,s=12,m=1,D=9999,S=(e,t,n)=>Math.min(n,Math.max(t,e)),T=(e,t)=>((e-1)%t+t)%t+1,L=2024,N=(e,t)=>t==null?31:new Date(e??L,t,0).getDate(),F=()=>{const e=new Date;return{day:e.getDate(),month:e.getMonth()+1,year:e.getFullYear()}},V=(e,t,n,a)=>{if(n==="min")return e==="year"?null:1;if(n==="max")return e==="year"?null:e==="day"?a.daysInMonth:s;if(t==null){if(e==="year")return a.today.year;const h=e==="day"?c:s;return n>0?1:h}if(e==="year")return S(t+n,m,D);const o=e==="day"?c:s;return T(t+n,o)},P={day:"",month:"",year:""},M=e=>{const{day:t,month:n,year:a}=e;if(t==null||n==null||a==null)return null;const o=new Date(a,n-1,t);return o.setFullYear(a),Number.isNaN(o.getTime())||o.getFullYear()!==a||o.getMonth()!==n-1||o.getDate()!==t?null:o},w=(e,t)=>e==null&&t==null?!0:e==null||t==null?!1:e.getTime()===t.getTime(),l=r.dateToDayKey,I=e=>r.isValidDate(e)?l(e):null,R=(e,t,n)=>{const a=l(e);return!(r.isValidDate(t)&&a<l(t)||r.isValidDate(n)&&a>l(n))},_=(e,t)=>r.isValidDate(e)&&r.isValidDate(t)&&l(e)>l(t),C=(e,t,n)=>{if(_(t,n))return e;const a=l(e);return r.isValidDate(t)&&a<l(t)?new Date(t.getFullYear(),t.getMonth(),t.getDate()):r.isValidDate(n)&&a>l(n)?new Date(n.getFullYear(),n.getMonth(),n.getDate()):e},O=e=>{if(!r.isValidDate(e))return"";const t=String(e.getFullYear()).padStart(4,"0"),n=String(e.getMonth()+1).padStart(2,"0"),a=String(e.getDate()).padStart(2,"0");return`${t}-${n}-${a}`},E=e=>e.type==="literal",f=e=>e.filter(t=>!E(t)).map(t=>t.type),Y=new Date(2020,0,2),X=new Set([8206,8207,8234,8235,8236,8237,8238,8294,8295,8296,8297]),K=e=>[...e].filter(t=>!X.has(t.codePointAt(0)??-1)).join(""),U=new Set(["day","month","year","literal"]),d=3,g=e=>{try{const t=new Intl.DateTimeFormat(e,{year:"numeric",month:"2-digit",day:"2-digit",calendar:"gregory"}).formatToParts(Y).filter(a=>U.has(a.type)).map(a=>({type:a.type,value:a.type==="literal"?K(a.value):""})),n=f(t);return n.length===d&&new Set(n).size===d?t:null}catch{return null}},A=r.createBoundedMemo(r.canonicalLocaleKey,e=>{const t=r.isLocaleSupported(e);!t&&process.env.NODE_ENV!=="production"&&console.warn(`DateField: locale "${e}" is not supported; falling back to ${r.DEFAULT_LOCALE}.`);const n=(t?g(e):null)??g(r.DEFAULT_LOCALE);if(!n)throw new Error(`DateField: Intl cannot resolve ${r.DEFAULT_LOCALE} date parts`);return n}),b=e=>A(e),G=()=>{A.clear(),y.clear(),r.__clearLocaleKeyCache()},v=e=>r.isValidDate(e)?{day:String(e.getDate()).padStart(2,"0"),month:String(e.getMonth()+1).padStart(2,"0"),year:String(e.getFullYear()).padStart(4,"0")}:P,i=(e,t)=>{if(t===""||e==="year"&&t.length<u.SEGMENT_MAX_LENGTH.year)return null;const n=parseInt(t,10);return Number.isNaN(n)||n===0?null:n},$=e=>M({day:i("day",e.day),month:i("month",e.month),year:i("year",e.year)}),B=(e,t)=>t===""?"":t.padStart(u.SEGMENT_MAX_LENGTH[e],"0"),H=(e,t,n)=>t===""?{displayValue:n,isPlaceholder:!0}:{displayValue:t.padStart(u.SEGMENT_MAX_LENGTH[e],"0"),isPlaceholder:!1},j=e=>{const t=window.getSelection();if(!t)return;const n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)},k=e=>{var n;if(!e)return;const t=(n=window.getSelection)==null?void 0:n.call(window);t&&t.rangeCount>0&&e.contains(t.anchorNode)&&t.removeAllRanges()};exports.DEFAULT_LOCALE=r.DEFAULT_LOCALE;exports.isValidDate=r.isValidDate;exports.DAY_SPIN_MAX=c;exports.MONTH_MAX=s;exports.YEAR_MAX=D;exports.YEAR_MIN=m;exports.__clearDatePartsCache=G;exports.adjustSegmentValue=V;exports.clamp=S;exports.clampDateToRange=C;exports.clearSelectionWithin=k;exports.dateKeyOrNull=I;exports.deriveValue=M;exports.deriveValueFromText=$;exports.getDateParts=b;exports.getDaysInMonth=N;exports.getMonthName=p;exports.getSegmentDisplay=H;exports.getSegmentOrder=f;exports.isDateInRange=R;exports.isLiteralPart=E;exports.isMinMaxMisconfigured=_;exports.isSameDateValue=w;exports.normalizeSegmentText=B;exports.segmentNumber=i;exports.segmentTextFromValue=v;exports.selectElementContents=j;exports.toISODateString=O;exports.todayParts=F;exports.wrapInRange=T;

package/lib/DateField/DateField.utils.d.ts

@@ -1,8 +1,14 @@
 import { Nullable } from '@viasat/beam-shared/utils/types';
+import { DEFAULT_LOCALE, isValidDate } from '@viasat/beam-shared/utils';
 import { DateFieldPart, SegmentAdjustment, SegmentText, SegmentType, SegmentValues } from './DateField.types';
-export declare const DEFAULT_LOCALE = "en-US";
-/** Returns the locale month name for a 1-based month (1 = January). */
-export declare const getMonthName: (month: number) => string;
+export { DEFAULT_LOCALE, isValidDate };
+/**
+ * The month segment's spoken value — "March" for `03` in en-US, "März" in
+ * de-DE — for a 1-based month (1 = January). The month-only form is the
+ * stand-alone one where a language distinguishes it (`март`, not `марта`),
+ * which is what a value read on its own should be.
+ */
+export declare const getMonthName: (month: number, locale?: string) => string;
 /**
  * Absolute spin ceiling for day — independent of the current month.
  *
@@ -45,8 +51,6 @@ export declare const todayParts: () => {
     month: number;
     year: number;
 };
-/** True for a `Date` instance that isn't `Invalid Date`. */
-export declare const isValidDate: (value: unknown) => value is Date;
 /** Context passed into {@link adjustSegmentValue} — kept pure by the caller. */
 export interface AdjustSegmentContext {
     /** Days in the current month (use {@link getDaysInMonth} to compute). */
@@ -121,7 +125,10 @@ export declare const getSegmentOrder: (parts: ReadonlyArray<DateFieldPart>) => R
  * catchable by an error boundary, instead of crashing the bundle at import.
  */
 export declare const getDateParts: (locale: string) => ReadonlyArray<DateFieldPart>;
-/** @internal — test-only. Clears the per-locale parts cache for Intl isolation. */
+/**
+ * @internal — test-only. Clears DateField's per-locale caches — segment parts
+ * and month names — plus the shared canonical-key cache, for Intl isolation.
+ */
 export declare const __clearDatePartsCache: () => void;
 /** Per-segment zero-padded strings from a Date. All-empty for null/invalid. */
 export declare const segmentTextFromValue: (value: Nullable<Date>) => SegmentText;