@viasat/beam-react 2.47.1 → 2.48.0

package/lib/wip/DateField/DateField.utils.es.js

@@ -1,78 +1,86 @@
-import { SEGMENT_MAX_LENGTH as i } from "./DateField.validation.es.js";
-const s = 31, l = 12, h = {
-  day: s,
-  month: l,
-  year: 9999
-}, g = (e, t, n) => Math.min(n, Math.max(t, e)), d = (e, t) => ((e - 1) % t + t) % t + 1, m = 2024, N = (e, t) => t == null ? 31 : new Date(e ?? m, t, 0).getDate(), M = () => {
+import { SEGMENT_MAX_LENGTH as u } from "./DateField.validation.es.js";
+const c = 31, s = 12, d = 1, y = 9999, f = (e, t, n) => Math.min(n, Math.max(t, e)), S = (e, t) => ((e - 1) % t + t) % t + 1, h = 2024, T = (e, t) => t == null ? 31 : new Date(e ?? h, t, 0).getDate(), A = () => {
   const e = /* @__PURE__ */ new Date();
   return { day: e.getDate(), month: e.getMonth() + 1, year: e.getFullYear() };
-}, D = (e, t, n, r) => {
+}, o = (e) => e instanceof Date && !Number.isNaN(e.getTime()), Y = (e, t, n, r) => {
   if (n === "min") return e === "year" ? null : 1;
   if (n === "max")
-    return e === "year" ? null : e === "day" ? r.daysInMonth : l;
+    return e === "year" ? null : e === "day" ? r.daysInMonth : s;
   if (t == null) {
     if (e === "year") return r.today.year;
-    const c = e === "day" ? s : l;
-    return n > 0 ? 1 : c;
+    const g = e === "day" ? c : s;
+    return n > 0 ? 1 : g;
   }
-  if (e === "year") return g(t + n, 1, 9999);
-  const a = e === "day" ? s : l;
-  return d(t + n, a);
-}, y = { day: "", month: "", year: "" }, u = (e) => e instanceof Date && !Number.isNaN(e.getTime()), S = (e) => {
+  if (e === "year") return f(t + n, d, y);
+  const l = e === "day" ? c : s;
+  return S(t + n, l);
+}, M = { day: "", month: "", year: "" }, m = (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;
-}, T = (e, t) => e == null && t == null ? !0 : e == null || t == null ? !1 : e.getTime() === t.getTime(), p = (e) => {
-  if (!u(e)) return "";
+  const l = new Date(r, n - 1, t);
+  return l.setFullYear(r), Number.isNaN(l.getTime()) || l.getFullYear() !== r || l.getMonth() !== n - 1 || l.getDate() !== t ? null : l;
+}, F = (e, t) => e == null && t == null ? !0 : e == null || t == null ? !1 : e.getTime() === t.getTime(), a = (e) => e.getFullYear() * 1e4 + (e.getMonth() + 1) * 100 + e.getDate(), w = (e) => o(e) ? a(e) : null, E = (e, t, n) => {
+  const r = a(e);
+  return !(o(t) && r < a(t) || o(n) && r > a(n));
+}, N = (e, t) => o(e) && o(t) && a(e) > a(t), R = (e, t, n) => {
+  if (N(t, n)) return e;
+  const r = a(e);
+  return o(t) && r < a(t) ? new Date(t.getFullYear(), t.getMonth(), t.getDate()) : o(n) && r > a(n) ? new Date(n.getFullYear(), n.getMonth(), n.getDate()) : e;
+}, _ = (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}`;
-}, A = (e) => e.filter(
+}, D = (e) => e.filter(
   (t) => t.type !== "literal"
-).map((t) => t.type), E = (e) => u(e) ? {
+).map((t) => t.type), I = (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")
-} : y, o = (e, t) => {
-  if (t === "" || e === "year" && t.length < i.year) return null;
+} : M, i = (e, t) => {
+  if (t === "" || e === "year" && t.length < u.year) return null;
   const n = parseInt(t, 10);
   return Number.isNaN(n) || n === 0 ? null : n;
-}, _ = (e) => S({
-  day: o("day", e.day),
-  month: o("month", e.month),
-  year: o("year", e.year)
-}), w = (e, t) => t === "" ? "" : t.padStart(i[e], "0"), F = (e, t, n) => t === "" ? { displayValue: n, isPlaceholder: !0 } : {
-  displayValue: t.padStart(i[e], "0"),
+}, V = (e) => m({
+  day: i("day", e.day),
+  month: i("month", e.month),
+  year: i("year", e.year)
+}), P = (e, t) => t === "" ? "" : t.padStart(u[e], "0"), X = (e, t, n) => t === "" ? { displayValue: n, isPlaceholder: !0 } : {
+  displayValue: t.padStart(u[e], "0"),
   isPlaceholder: !1
-}, V = (e) => {
+}, C = (e) => {
   const t = window.getSelection();
   if (!t) return;
   const n = document.createRange();
   n.selectNodeContents(e), t.removeAllRanges(), t.addRange(n);
-}, Y = (e) => {
+}, L = (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();
 };
 export {
-  s as DAY_SPIN_MAX,
-  l as MONTH_MAX,
-  h as SEGMENT_ARIA_MAX,
-  D as adjustSegmentValue,
-  g as clamp,
-  Y as clearSelectionWithin,
-  S as deriveValue,
-  _ as deriveValueFromText,
-  N as getDaysInMonth,
-  F as getSegmentDisplay,
-  A as getSegmentOrder,
-  T as isSameDateValue,
-  w as normalizeSegmentText,
-  o as segmentNumber,
-  E as segmentTextFromValue,
-  V as selectElementContents,
-  p as toISODateString,
-  M as todayParts,
-  d as wrapInRange
+  c as DAY_SPIN_MAX,
+  s as MONTH_MAX,
+  y as YEAR_MAX,
+  d as YEAR_MIN,
+  Y as adjustSegmentValue,
+  f as clamp,
+  R as clampDateToRange,
+  L as clearSelectionWithin,
+  w as dateKeyOrNull,
+  m as deriveValue,
+  V as deriveValueFromText,
+  T as getDaysInMonth,
+  X as getSegmentDisplay,
+  D as getSegmentOrder,
+  E as isDateInRange,
+  N as isMinMaxMisconfigured,
+  F as isSameDateValue,
+  P as normalizeSegmentText,
+  i as segmentNumber,
+  I as segmentTextFromValue,
+  C as selectElementContents,
+  _ as toISODateString,
+  A as todayParts,
+  S as wrapInRange
 };

package/lib/wip/DateField/useDateFieldFocus.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),I=require("./DateField.utils.cjs.js");function M({disabled:n,fieldRef:a,segmentRefs:T,partsOrder:o,onSegmentFocusChange:b,onFieldBlur:D}){const[l,i]=e.useState(null),s=o[0],r=e.useRef(b),f=e.useRef(D);e.useEffect(()=>{r.current=b,f.current=D},[b,D]),e.useEffect(()=>{if(l===null||l==="all")return;const t=T.current.get(l);t&&document.activeElement!==t&&t.focus()},[l,T]);const _=e.useCallback(t=>{var u;n||(i(t),(u=r.current)==null||u.call(r,t))},[n]),v=e.useCallback(t=>{var u;n||t.target===a.current&&(i(s),(u=r.current)==null||u.call(r,s))},[n,a,s]),E=e.useCallback(t=>{var u,c;(u=a.current)!=null&&u.contains(t.relatedTarget)||(i(null),(c=f.current)==null||c.call(f),I.clearSelectionWithin(a.current))},[a]),d=e.useCallback(t=>{var c;if(n)return;t.target.closest("[data-segment]")||(t.preventDefault(),i(s),(c=r.current)==null||c.call(r,s))},[n,s]),k=e.useCallback((t,u)=>{var y;const c=o.indexOf(t);if(c===-1)return;const x=o[c+u];x!=null&&(i(x),(y=r.current)==null||y.call(r,x))},[o]),q=e.useCallback(t=>{k(t,1)},[k]),w=e.useCallback(t=>{k(t,-1)},[k]);return{focusedSegment:l,fieldTabIndex:n?-1:l===null?0:-1,handleSegmentFocus:_,handleFieldFocus:v,handleFieldBlur:E,handleFieldMouseDown:d,focusNext:q,focusPrevious:w}}exports.useDateFieldFocus=M;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),P=require("./DateField.utils.cjs.js");function j({disabled:l,fieldRef:i,segmentRefs:T,partsOrder:b,onSegmentFocusChange:d,onFieldBlur:x}){const[c,o]=r.useState(null),a=b[0],y=r.useRef(c);y.current=c;const e=r.useRef(d),k=r.useRef(x);r.useEffect(()=>{e.current=d,k.current=x},[d,x]),r.useEffect(()=>{if(c===null||c==="all")return;const t=T.current.get(c);t&&document.activeElement!==t&&t.focus()},[c,T]);const E=r.useCallback(t=>{var u;l||(o(t),(u=e.current)==null||u.call(e,t))},[l]),q=r.useCallback(t=>{var u;l||t.target===i.current&&(o(a),(u=e.current)==null||u.call(e,a))},[l,i,a]),v=r.useCallback(t=>{var n,s,f,_;if((n=i.current)!=null&&n.contains(t.relatedTarget))return;const u=(f=(s=t.target)==null?void 0:s.getAttribute)==null?void 0:f.call(s,"data-segment");u&&u!==y.current||(o(null),(_=k.current)==null||_.call(k),P.clearSelectionWithin(i.current))},[i]),w=r.useCallback(t=>{var n;if(l)return;t.target.closest("[data-segment]")||(t.preventDefault(),o(a),(n=e.current)==null||n.call(e,a))},[l,a]),D=r.useCallback((t,u)=>{var f;const n=b.indexOf(t);if(n===-1)return;const s=b[n+u];s!=null&&(o(s),(f=e.current)==null||f.call(e,s))},[b]),I=r.useCallback(t=>{D(t,1)},[D]),M=r.useCallback(t=>{D(t,-1)},[D]);return{focusedSegment:c,fieldTabIndex:l?-1:c===null?0:-1,handleSegmentFocus:E,handleFieldFocus:q,handleFieldBlur:v,handleFieldMouseDown:w,focusNext:I,focusPrevious:M}}exports.useDateFieldFocus=j;

package/lib/wip/DateField/useDateFieldFocus.es.js

@@ -1,71 +1,78 @@
-import { useState as j, useRef as E, useEffect as I, useCallback as e } from "react";
-import { clearSelectionWithin as m } from "./DateField.utils.es.js";
-function G({
-  disabled: n,
-  fieldRef: i,
-  segmentRefs: v,
-  partsOrder: f,
-  onSegmentFocusChange: T,
-  onFieldBlur: D
+import { useState as d, useRef as y, useEffect as v, useCallback as o } from "react";
+import { clearSelectionWithin as j } from "./DateField.utils.es.js";
+function H({
+  disabled: s,
+  fieldRef: l,
+  segmentRefs: E,
+  partsOrder: x,
+  onSegmentFocusChange: m,
+  onFieldBlur: p
 }) {
-  const [s, l] = j(null), o = f[0], r = E(T), a = E(D);
-  I(() => {
-    r.current = T, a.current = D;
-  }, [T, D]), I(() => {
-    if (s === null || s === "all") return;
-    const t = v.current.get(s);
+  const [u, f] = d(null), i = x[0], I = y(u);
+  I.current = u;
+  const r = y(m), T = y(p);
+  v(() => {
+    r.current = m, T.current = p;
+  }, [m, p]), v(() => {
+    if (u === null || u === "all") return;
+    const t = E.current.get(u);
     t && document.activeElement !== t && t.focus();
-  }, [s, v]);
-  const k = e(
+  }, [u, E]);
+  const w = o(
     (t) => {
       var c;
-      n || (l(t), (c = r.current) == null || c.call(r, t));
+      s || (f(t), (c = r.current) == null || c.call(r, t));
     },
-    [n]
-  ), w = e(
+    [s]
+  ), A = o(
     (t) => {
       var c;
-      n || t.target === i.current && (l(o), (c = r.current) == null || c.call(r, o));
+      s || t.target === l.current && (f(i), (c = r.current) == null || c.call(r, i));
     },
-    [n, i, o]
-  ), M = e(
+    [s, l, i]
+  ), M = o(
     (t) => {
-      var c, u;
-      (c = i.current) != null && c.contains(t.relatedTarget) || (l(null), (u = a.current) == null || u.call(a), m(i.current));
+      var n, e, a, k;
+      if ((n = l.current) != null && n.contains(t.relatedTarget)) return;
+      const c = (a = (e = t.target) == null ? void 0 : e.getAttribute) == null ? void 0 : a.call(
+        e,
+        "data-segment"
+      );
+      c && c !== I.current || (f(null), (k = T.current) == null || k.call(T), j(l.current));
     },
-    [i]
-  ), N = e(
+    [l]
+  ), N = o(
     (t) => {
-      var u;
-      if (n) return;
-      t.target.closest("[data-segment]") || (t.preventDefault(), l(o), (u = r.current) == null || u.call(r, o));
+      var n;
+      if (s) return;
+      t.target.closest("[data-segment]") || (t.preventDefault(), f(i), (n = r.current) == null || n.call(r, i));
     },
-    [n, o]
-  ), x = e(
+    [s, i]
+  ), D = o(
     (t, c) => {
-      var y;
-      const u = f.indexOf(t);
-      if (u === -1) return;
-      const p = f[u + c];
-      p != null && (l(p), (y = r.current) == null || y.call(r, p));
+      var a;
+      const n = x.indexOf(t);
+      if (n === -1) return;
+      const e = x[n + c];
+      e != null && (f(e), (a = r.current) == null || a.call(r, e));
     },
-    [f]
-  ), P = e(
+    [x]
+  ), P = o(
     (t) => {
-      x(t, 1);
+      D(t, 1);
     },
-    [x]
-  ), W = e(
+    [D]
+  ), W = o(
     (t) => {
-      x(t, -1);
+      D(t, -1);
     },
-    [x]
+    [D]
   );
   return {
-    focusedSegment: s,
-    fieldTabIndex: n ? -1 : s === null ? 0 : -1,
-    handleSegmentFocus: k,
-    handleFieldFocus: w,
+    focusedSegment: u,
+    fieldTabIndex: s ? -1 : u === null ? 0 : -1,
+    handleSegmentFocus: w,
+    handleFieldFocus: A,
     handleFieldBlur: M,
     handleFieldMouseDown: N,
     focusNext: P,
@@ -73,5 +80,5 @@ function G({
   };
 }
 export {
-  G as useDateFieldFocus
+  H as useDateFieldFocus
 };

package/lib/wip/DateField/useDateFieldValidity.d.ts

@@ -15,9 +15,11 @@ export interface UseDateFieldValidityReturn {
     allFilled: boolean;
     hasPartialValue: boolean;
     /** "Show error?" for value-driven invalidity. True when the user has
-     *  touched the field AND either:
-     *   - all segments are filled but combine to an invalid date (Feb 30), or
-     *   - some segments are filled, others empty, and focus has left the field. */
+     *  touched the field AND (all segments filled but combine to an invalid
+     *  date (Feb 30), OR some filled/some empty and focus has left).
+     *  `minDate`/`maxDate` out-of-range values aren't flagged here — the
+     *  built-in bound is a blur clamp (see `commitOnBlur`), not a validity
+     *  constraint; use a `validationRule` for range errors/submit-blocking. */
     isInvalid: boolean;
 }
 export declare function useDateFieldValidity({ segments, currentValue, wasTouched, isFocused, }: UseDateFieldValidityArgs): UseDateFieldValidityReturn;

package/lib/wip/DateField/useDateFieldValue.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),t=require("./DateField.utils.cjs.js"),E=require("./DateField.validation.cjs.js");function p({value:c,defaultValue:F,onChange:g}){const T=r.useRef(c!==void 0),b=T.current,[o,S]=r.useState(()=>t.segmentTextFromValue(b?c??null:F??null)),[_,y]=r.useState(!1),a=r.useRef(o),d=r.useRef(new Set),i=r.useRef(!1),h={day:t.segmentNumber("day",o.day),month:t.segmentNumber("month",o.month),year:t.segmentNumber("year",o.year)},R=t.deriveValue(h),x=r.useRef(R),V=r.useRef(b?c??null:null),m=r.useRef(g);r.useEffect(()=>{m.current=g},[g]),r.useEffect(()=>{if(!T.current||i.current||t.isSameDateValue(c??null,V.current))return;V.current=c??null;const e=t.segmentTextFromValue(c??null);a.current=e,S(e),x.current=t.deriveValueFromText(e)},[c]);const f=r.useCallback(e=>{var u;const n=t.deriveValueFromText(e);t.isSameDateValue(n,x.current)||(x.current=n,(u=m.current)==null||u.call(m,n))},[]),l=r.useCallback((e,n,{replace:u})=>{const s={...a.current,[e]:n};a.current=s,S(s),y(!0),f(s),u?d.current.add(e):d.current.delete(e)},[f]),N=r.useCallback((e,n)=>{const u=d.current.has(e)?"":a.current[e],s=E.tryAppendDigit(e,u,n);return s.rejected?{advanced:!1,rejected:!0}:(l(e,s.newBuffer,{replace:s.shouldAdvance}),{advanced:s.shouldAdvance,rejected:!1})},[l]),k=r.useCallback((e,n)=>{const u=a.current,s=t.segmentNumber(e,u[e]),v=t.getDaysInMonth(t.segmentNumber("year",u.year),t.segmentNumber("month",u.month)),D=t.adjustSegmentValue(e,s,n,{daysInMonth:v,today:t.todayParts()});return D==null?!1:(i.current=!0,l(e,String(D).padStart(E.SEGMENT_MAX_LENGTH[e],"0"),{replace:!0}),!0)},[l]),w=r.useCallback(e=>a.current[e]===""?{wasEmpty:!0}:(i.current=!0,l(e,"",{replace:!1}),{wasEmpty:!1}),[l]),C=r.useCallback(e=>{i.current=!0,d.current.add(e)},[]),j=r.useCallback(()=>{i.current=!1;const e=a.current,n={day:t.normalizeSegmentText("day",e.day),month:t.normalizeSegmentText("month",e.month),year:t.normalizeSegmentText("year",e.year)};a.current=n,S(n),y(!0),f(n)},[f]);return{segmentText:o,segmentValues:h,currentValue:R,isControlled:b,wasTouched:_,appendDigit:N,adjustSegment:k,clearSegment:w,beginSegmentEdit:C,commitOnBlur:j}}exports.useDateFieldValue=p;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),t=require("./DateField.utils.cjs.js"),j=require("./DateField.validation.cjs.js");function G({value:a,defaultValue:A,onChange:x,minDate:R,maxDate:y,getClampAnnouncement:V}){const N=r.useRef(a!==void 0),F=N.current,[m,h]=r.useState(()=>t.segmentTextFromValue(F?a??null:A??null)),[D,_]=r.useState(!1),[C,M]=r.useState(""),c=r.useRef(m),f=r.useRef(new Set),d=r.useRef(!1),l=r.useRef(null),v={day:t.segmentNumber("day",m.day),month:t.segmentNumber("month",m.month),year:t.segmentNumber("year",m.year)},k=t.deriveValue(v),E=r.useRef(k),p=r.useRef(F?a??null:null),g=r.useRef(x),S=r.useRef(V);r.useEffect(()=>{g.current=x,S.current=V},[x,V]),r.useEffect(()=>()=>{l.current!=null&&cancelAnimationFrame(l.current)},[]),r.useEffect(()=>{if(!N.current||d.current||t.isSameDateValue(a??null,p.current))return;p.current=a??null;const e=t.segmentTextFromValue(a??null);c.current=e,h(e),E.current=t.deriveValueFromText(e)},[a]);const b=r.useCallback(e=>{var n;const s=t.deriveValueFromText(e);t.isSameDateValue(s,E.current)||(E.current=s,(n=g.current)==null||n.call(g,s))},[]),o=r.useCallback((e,s,{replace:n})=>{const u={...c.current,[e]:s};c.current=u,h(u),_(!0),b(u),n?f.current.add(e):f.current.delete(e)},[b]),q=r.useCallback((e,s)=>{const n=f.current.has(e)?"":c.current[e],u=j.tryAppendDigit(e,n,s);return u.rejected?{advanced:!1,rejected:!0}:(o(e,u.newBuffer,{replace:u.shouldAdvance}),{advanced:u.shouldAdvance,rejected:!1})},[o]),z=r.useCallback((e,s)=>{const n=c.current,u=t.segmentNumber(e,n[e]),T=t.getDaysInMonth(t.segmentNumber("year",n.year),t.segmentNumber("month",n.month)),i=t.adjustSegmentValue(e,u,s,{daysInMonth:T,today:t.todayParts()});return i==null?!1:(d.current=!0,o(e,String(i).padStart(j.SEGMENT_MAX_LENGTH[e],"0"),{replace:!0}),!0)},[o]),I=r.useCallback(e=>c.current[e]===""?{wasEmpty:!0}:(d.current=!0,o(e,"",{replace:!1}),{wasEmpty:!1}),[o]),O=r.useCallback(e=>{d.current=!0,f.current.add(e)},[]),B=r.useCallback(()=>{var T;d.current=!1;const e=c.current,s={day:t.normalizeSegmentText("day",e.day),month:t.normalizeSegmentText("month",e.month),year:t.normalizeSegmentText("year",e.year)},n=t.deriveValueFromText(s);let u=s;if(n!=null&&D&&!t.isDateInRange(n,R,y)){const i=t.clampDateToRange(n,R,y);if(u=t.segmentTextFromValue(i),!t.isSameDateValue(i,n)){const w=((T=S.current)==null?void 0:T.call(S,i))??"";w&&(l.current!=null&&cancelAnimationFrame(l.current),l.current=requestAnimationFrame(()=>{l.current=null,M(w)}))}}c.current=u,h(u),_(!0),b(u)},[b,D,t.dateKeyOrNull(R),t.dateKeyOrNull(y)]);return{segmentText:m,segmentValues:v,currentValue:k,isControlled:F,wasTouched:D,appendDigit:q,adjustSegment:z,clearSegment:I,beginSegmentEdit:O,commitOnBlur:B,clampAnnouncement:C}}exports.useDateFieldValue=G;

package/lib/wip/DateField/useDateFieldValue.d.ts

@@ -5,6 +5,23 @@ export interface UseDateFieldValueArgs {
     defaultValue?: Nullable<Date>;
     /** Fires on user-driven value transitions only, never on controlled `value` changes. */
     onChange?: (value: Nullable<Date>) => void;
+    /**
+     * Earliest allowed date (inclusive, compared by calendar day). Springs a
+     * touched value to this bound on blur (see `commitOnBlur`) — does not bound
+     * the year segment's spin/Home/End, which is free (see `adjustSegment`).
+     */
+    minDate?: Nullable<Date>;
+    /**
+     * Latest allowed date (inclusive, compared by calendar day). Springs a
+     * touched value to this bound on blur (see `commitOnBlur`) — does not bound
+     * the year segment's spin/Home/End, which is free (see `adjustSegment`).
+     */
+    maxDate?: Nullable<Date>;
+    /**
+     * Called when a touched value springs to a bound on blur; returns a localized
+     * message set on the polite live region. Omit → no announcement.
+     */
+    getClampAnnouncement?: (clampedDate: Date) => string;
 }
 export interface UseDateFieldValueReturn {
     segmentText: SegmentText;
@@ -17,21 +34,21 @@ export interface UseDateFieldValueReturn {
      * Increments, decrements, or jumps a segment to its min/max boundary.
      *
      * - Numeric `amount` (e.g. ±1, ±5): day/month wrap modularly; year clamps
-     *   to [1, 9999]. An empty day/month segment seeds to a fixed first/last
-     *   valid value based on direction; an empty year seeds to the current
-     *   year.
-     * - `'min'` / `'max'`: jump to the lower/upper bound. No-op on year (no
-     *   meaningful bound until DF-10 adds minDate/maxDate).
+     *   to `[YEAR_MIN, YEAR_MAX]` (free-spinning, independent of `minDate`/
+     *   `maxDate` — see `DateField.utils.adjustSegmentValue`). An empty day/month
+     *   segment seeds to a direction-based first/last valid value; an empty year
+     *   seeds to the current year.
+     * - `'min'` / `'max'`: jump to the lower/upper bound. No-op on year (Home/End
+     *   don't bound the year to `minDate`/`maxDate`).
      *
      * Follows the `appendDigit` mutation pattern: writes zero-padded `segmentText`,
      * sets `wasTouched`, calls `emitIfChanged`, and marks the segment in
      * `replaceNextRef` so a digit typed immediately after replaces rather than
      * appends.
      *
-     * @returns `true` if the segment was adjusted, `false` on a no-op (currently
-     * only year `'min'`/`'max'`, until DF-10 adds year bounds). The keyboard
-     * dispatcher uses this to decide whether to `preventDefault` — a no-op leaves
-     * the key to native (e.g. page scroll).
+     * @returns `true` if the segment was adjusted, `false` on a no-op (year
+     * `'min'`/`'max'`). The keyboard dispatcher uses this to decide whether to
+     * `preventDefault` — a no-op leaves the key to native (e.g. page scroll).
      */
     adjustSegment: (type: SegmentType, amount: SegmentAdjustment) => boolean;
     /**
@@ -50,5 +67,7 @@ export interface UseDateFieldValueReturn {
     };
     beginSegmentEdit: (type: SegmentType) => void;
     commitOnBlur: () => void;
+    /** Polite live-region message set when the blur clamp springs a value to a bound. */
+    clampAnnouncement: string;
 }
-export declare function useDateFieldValue({ value, defaultValue, onChange, }: UseDateFieldValueArgs): UseDateFieldValueReturn;
+export declare function useDateFieldValue({ value, defaultValue, onChange, minDate, maxDate, getClampAnnouncement, }: UseDateFieldValueArgs): UseDateFieldValueReturn;

package/lib/wip/DateField/useDateFieldValue.es.js

@@ -1,83 +1,103 @@
-import { useRef as s, useState as w, useEffect as b, useCallback as o } from "react";
-import { segmentTextFromValue as A, segmentNumber as l, deriveValue as C, isSameDateValue as M, deriveValueFromText as N, getDaysInMonth as H, adjustSegmentValue as L, todayParts as O, normalizeSegmentText as T } from "./DateField.utils.es.js";
-import { tryAppendDigit as P, SEGMENT_MAX_LENGTH as W } from "./DateField.validation.es.js";
-function K({
-  value: u,
-  defaultValue: v,
-  onChange: x
+import { useRef as c, useState as w, useEffect as N, useCallback as a } from "react";
+import { segmentTextFromValue as b, segmentNumber as i, deriveValue as Q, isSameDateValue as v, deriveValueFromText as D, getDaysInMonth as U, adjustSegmentValue as Y, todayParts as Z, normalizeSegmentText as I, isDateInRange as $, clampDateToRange as C, dateKeyOrNull as k } from "./DateField.utils.es.js";
+import { tryAppendDigit as ee, SEGMENT_MAX_LENGTH as te } from "./DateField.validation.es.js";
+function ue({
+  value: s,
+  defaultValue: q,
+  onChange: T,
+  minDate: E,
+  maxDate: R,
+  getClampAnnouncement: V
 }) {
-  const E = s(u !== void 0), h = E.current, [d, S] = w(
-    () => A(h ? u ?? null : v ?? null)
-  ), [F, V] = w(!1), c = s(d), i = s(/* @__PURE__ */ new Set()), m = s(!1), p = {
-    day: l("day", d.day),
-    month: l("month", d.month),
-    year: l("year", d.year)
-  }, D = C(p), y = s(D), R = s(h ? u ?? null : null), f = s(x);
-  b(() => {
-    f.current = x;
-  }, [x]), b(() => {
-    if (!E.current || m.current || M(u ?? null, R.current)) return;
-    R.current = u ?? null;
-    const e = A(u ?? null);
-    c.current = e, S(e), y.current = N(e);
-  }, [u]);
-  const g = o((e) => {
-    var r;
-    const t = N(e);
-    M(t, y.current) || (y.current = t, (r = f.current) == null || r.call(f, t));
-  }, []), a = o(
-    (e, t, { replace: r }) => {
-      const n = { ...c.current, [e]: t };
-      c.current = n, S(n), V(!0), g(n), r ? i.current.add(e) : i.current.delete(e);
+  const M = c(s !== void 0), p = M.current, [m, A] = w(
+    () => b(p ? s ?? null : q ?? null)
+  ), [F, z] = w(!1), [H, K] = w(""), u = c(m), g = c(/* @__PURE__ */ new Set()), f = c(!1), o = c(null), B = {
+    day: i("day", m.day),
+    month: i("month", m.month),
+    year: i("year", m.year)
+  }, G = Q(B), j = c(G), O = c(p ? s ?? null : null), h = c(T), x = c(V);
+  N(() => {
+    h.current = T, x.current = V;
+  }, [T, V]), N(
+    () => () => {
+      o.current != null && cancelAnimationFrame(o.current);
     },
-    [g]
-  ), I = o(
-    (e, t) => {
-      const r = i.current.has(e) ? "" : c.current[e], n = P(e, r, t);
-      return n.rejected ? { advanced: !1, rejected: !0 } : (a(e, n.newBuffer, { replace: n.shouldAdvance }), { advanced: n.shouldAdvance, rejected: !1 });
+    []
+  ), N(() => {
+    if (!M.current || f.current || v(s ?? null, O.current)) return;
+    O.current = s ?? null;
+    const e = b(s ?? null);
+    u.current = e, A(e), j.current = D(e);
+  }, [s]);
+  const y = a((e) => {
+    var t;
+    const n = D(e);
+    v(n, j.current) || (j.current = n, (t = h.current) == null || t.call(h, n));
+  }, []), l = a(
+    (e, n, { replace: t }) => {
+      const r = { ...u.current, [e]: n };
+      u.current = r, A(r), z(!0), y(r), t ? g.current.add(e) : g.current.delete(e);
     },
-    [a]
-  ), B = o(
-    (e, t) => {
-      const r = c.current, n = l(e, r[e]), z = H(
-        l("year", r.year),
-        l("month", r.month)
-      ), j = L(e, n, t, {
-        daysInMonth: z,
-        today: O()
+    [y]
+  ), L = a(
+    (e, n) => {
+      const t = g.current.has(e) ? "" : u.current[e], r = ee(e, t, n);
+      return r.rejected ? { advanced: !1, rejected: !0 } : (l(e, r.newBuffer, { replace: r.shouldAdvance }), { advanced: r.shouldAdvance, rejected: !1 });
+    },
+    [l]
+  ), P = a(
+    (e, n) => {
+      const t = u.current, r = i(e, t[e]), S = U(
+        i("year", t.year),
+        i("month", t.month)
+      ), d = Y(e, r, n, {
+        daysInMonth: S,
+        today: Z()
       });
-      return j == null ? !1 : (m.current = !0, a(e, String(j).padStart(W[e], "0"), {
+      return d == null ? !1 : (f.current = !0, l(e, String(d).padStart(te[e], "0"), {
         replace: !0
       }), !0);
     },
-    [a]
-  ), G = o(
-    (e) => c.current[e] === "" ? { wasEmpty: !0 } : (m.current = !0, a(e, "", { replace: !1 }), { wasEmpty: !1 }),
-    [a]
-  ), _ = o((e) => {
-    m.current = !0, i.current.add(e);
-  }, []), k = o(() => {
-    m.current = !1;
-    const e = c.current, t = {
-      day: T("day", e.day),
-      month: T("month", e.month),
-      year: T("year", e.year)
-    };
-    c.current = t, S(t), V(!0), g(t);
-  }, [g]);
+    [l]
+  ), W = a(
+    (e) => u.current[e] === "" ? { wasEmpty: !0 } : (f.current = !0, l(e, "", { replace: !1 }), { wasEmpty: !1 }),
+    [l]
+  ), X = a((e) => {
+    f.current = !0, g.current.add(e);
+  }, []), J = a(() => {
+    var S;
+    f.current = !1;
+    const e = u.current, n = {
+      day: I("day", e.day),
+      month: I("month", e.month),
+      year: I("year", e.year)
+    }, t = D(n);
+    let r = n;
+    if (t != null && F && !$(t, E, R)) {
+      const d = C(t, E, R);
+      if (r = b(d), !v(d, t)) {
+        const _ = ((S = x.current) == null ? void 0 : S.call(x, d)) ?? "";
+        _ && (o.current != null && cancelAnimationFrame(o.current), o.current = requestAnimationFrame(() => {
+          o.current = null, K(_);
+        }));
+      }
+    }
+    u.current = r, A(r), z(!0), y(r);
+  }, [y, F, k(E), k(R)]);
   return {
-    segmentText: d,
-    segmentValues: p,
-    currentValue: D,
-    isControlled: h,
+    segmentText: m,
+    segmentValues: B,
+    currentValue: G,
+    isControlled: p,
     wasTouched: F,
-    appendDigit: I,
-    adjustSegment: B,
-    clearSegment: G,
-    beginSegmentEdit: _,
-    commitOnBlur: k
+    appendDigit: L,
+    adjustSegment: P,
+    clearSegment: W,
+    beginSegmentEdit: X,
+    commitOnBlur: J,
+    clampAnnouncement: H
   };
 }
 export {
-  K as useDateFieldValue
+  ue as useDateFieldValue
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viasat/beam-react",
-  "version": "2.47.1",
+  "version": "2.48.0",
   "description": "React component library for the Beam design system",
   "license": "MIT",
   "author": "Viasat",
@@ -60,12 +60,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@viasat/beam-fonts": "2.47.1",
-    "@viasat/beam-shared": "2.47.1",
-    "@viasat/beam-styles": "2.47.1",
-    "@viasat/beam-tokens": "2.47.1",
-    "@viasat/beam-icons": "2.47.1",
-    "@viasat/beam-react-claude-plugin": "2.47.1",
+    "@viasat/beam-fonts": "2.48.0",
+    "@viasat/beam-shared": "2.48.0",
+    "@viasat/beam-styles": "2.48.0",
+    "@viasat/beam-tokens": "2.48.0",
+    "@viasat/beam-icons": "2.48.0",
+    "@viasat/beam-react-claude-plugin": "2.48.0",
     "clsx": "^1.2.1",
     "@floating-ui/react": "^0.26.18",
     "@stepperize/react": "^5.1.5",

package/chunks/DateField.Segment.CY0jg03_.js

@@ -1 +0,0 @@
-var w=require("../assets/DateField.css");const N=require("react/jsx-runtime"),F=require("clsx"),d=require("react"),M=require("./classNames.DC8Ra4sw.js"),q=require("../lib/wip/DateField/DateField.utils.cjs.js"),P="date-field",{baseClassNamePrefix:R,classModifierPrefix:k,subElementClassPrefix:r}=M.getBEMClassNames(P),c={field:`${r}field`,segments:`${r}segments`,segment:`${r}segment`,separator:`${r}separator`},u={"bm-light":"bm-light","bm-dark":"bm-dark","bm-inverse":"bm-inverse","bm-enterprise":"bm-enterprise","bm-consumer":"bm-consumer","bm-date-field":"bm-date-field","bm-date-field--disabled":"bm-date-field--disabled","bm-date-field--error":"bm-date-field--error","bm-date-field__field":"bm-date-field__field","bm-date-field__segment":"bm-date-field__segment","bm-date-field--read-only":"bm-date-field--read-only","bm-date-field--fluid":"bm-date-field--fluid","bm-date-field__segments":"bm-date-field__segments","bm-date-field__separator":"bm-date-field__separator"},I={day:"day",month:"month",year:"year"},$=({type:n,value:_,valueMax:g,displayValue:t,isPlaceholder:C,isActive:a,disabled:l,readOnly:o,onFocus:p,onBlur:x,onInput:E,onKeyDown:h,segmentRef:m})=>{const s=!l&&!o,f=d.useRef(null),v=d.useCallback(e=>{f.current=e,m(e)},[m]),D=e=>{if(!s)return;const b=e.currentTarget,i=e.nativeEvent.data;i!=null&&i.length===1&&E(n,i),b.textContent!==t&&(b.textContent=t)};return d.useLayoutEffect(()=>{if(!a||!s)return;const e=f.current;e&&q.selectElementContents(e)},[t,a,s]),N.jsx("span",{ref:v,role:"spinbutton","aria-label":I[n],"aria-valuenow":_??void 0,"aria-valuemin":1,"aria-valuemax":g,"aria-valuetext":t,"aria-disabled":l||void 0,"aria-readonly":o||void 0,contentEditable:s&&a,suppressContentEditableWarning:!0,tabIndex:a?0:-1,inputMode:s?"numeric":void 0,spellCheck:!1,autoCorrect:"off",autoCapitalize:"off","data-segment":n,"data-active":a,"data-placeholder":C,onFocus:p,onBlur:x,onInput:D,onKeyDown:e=>h(n,e),onMouseUp:e=>e.preventDefault(),className:F(u[c.segment]),children:t})};exports.DateFieldSegment=$;exports.baseClassNamePrefix=R;exports.classModifierPrefix=k;exports.staticDateFieldClassNames=c;exports.styles=u;