@viasat/beam-react 2.47.0 → 2.48.0

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

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react");function d({disabled:c,readOnly:u,fieldRef:a,focusNext:o,focusPrevious:n,adjustSegment:t,deleteLastDigit:y,clearSegment:p}){const w=b.useMemo(()=>{const i={ArrowRight:({segment:r,isRTL:e})=>((e?n:o)(r),!0),ArrowLeft:({segment:r,isRTL:e})=>((e?o:n)(r),!0)};return u?i:{...i,ArrowUp:({segment:r})=>t(r,1),ArrowDown:({segment:r})=>t(r,-1),PageUp:({segment:r})=>t(r,5),PageDown:({segment:r})=>t(r,-5),Home:({segment:r})=>t(r,"min"),End:({segment:r})=>t(r,"max"),Backspace:({segment:r})=>(y(r).wasEmpty&&n(r),!0),Delete:({segment:r})=>(p(r),!0)}},[t,p,y,o,n,u]);return b.useCallback((i,r)=>{if(c||r.altKey||r.ctrlKey||r.metaKey||r.shiftKey)return;const e=w[r.key];if(!e)return;const l=a.current,K=!!l&&(getComputedStyle(l).direction==="rtl"||!!l.closest('[dir="rtl"]'));e({segment:i,event:r,isRTL:K})&&r.preventDefault()},[c,w,a])}exports.useDateFieldKeyboard=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("react");function d({disabled:a,readOnly:c,fieldRef:y,focusNext:o,focusPrevious:e,adjustSegment:t,clearSegment:l}){const p=w.useMemo(()=>{const n={ArrowRight:({segment:r,isRTL:i})=>((i?e:o)(r),!0),ArrowLeft:({segment:r,isRTL:i})=>((i?o:e)(r),!0)};return c?n:{...n,ArrowUp:({segment:r})=>t(r,1),ArrowDown:({segment:r})=>t(r,-1),PageUp:({segment:r})=>t(r,5),PageDown:({segment:r})=>t(r,-5),Home:({segment:r})=>t(r,"min"),End:({segment:r})=>t(r,"max"),Backspace:({segment:r})=>(l(r).wasEmpty&&e(r),!0),Delete:({segment:r})=>(l(r),!0)}},[t,l,o,e,c]);return w.useCallback((n,r)=>{if(a||r.altKey||r.ctrlKey||r.metaKey||r.shiftKey)return;const i=p[r.key];if(!i)return;const u=y.current,b=!!u&&(getComputedStyle(u).direction==="rtl"||!!u.closest('[dir="rtl"]'));i({segment:n,event:r,isRTL:b})&&r.preventDefault()},[a,p,y])}exports.useDateFieldKeyboard=d;

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

@@ -41,18 +41,14 @@ export interface UseDateFieldKeyboardArgs {
      */
     adjustSegment: (type: SegmentType, amount: SegmentAdjustment) => boolean;
     /**
-     * Removes the last raw digit from the segment buffer (Backspace).
-     * Returns `{ wasEmpty: true }` when the buffer was already empty, signalling
-     * the keyboard handler to move focus to the previous segment.
+     * Clears the entire segment buffer to `''` — shared by Backspace and Delete.
+     * Returns `{ wasEmpty: true }` when the buffer was already
+     * empty, signalling Backspace to move focus to the previous segment instead;
+     * Delete ignores the result and leaves focus on the current segment.
      * Provided by `useDateFieldValue`.
      */
-    deleteLastDigit: (type: SegmentType) => {
+    clearSegment: (type: SegmentType) => {
         wasEmpty: boolean;
     };
-    /**
-     * Clears the entire segment buffer to `''` (Delete). Focus stays on the
-     * current segment. Provided by `useDateFieldValue`.
-     */
-    clearSegment: (type: SegmentType) => void;
 }
-export declare function useDateFieldKeyboard({ disabled, readOnly, fieldRef, focusNext, focusPrevious, adjustSegment, deleteLastDigit, clearSegment, }: UseDateFieldKeyboardArgs): (segment: SegmentType, event: KeyboardEvent<HTMLSpanElement>) => void;
+export declare function useDateFieldKeyboard({ disabled, readOnly, fieldRef, focusNext, focusPrevious, adjustSegment, clearSegment, }: UseDateFieldKeyboardArgs): (segment: SegmentType, event: KeyboardEvent<HTMLSpanElement>) => void;

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

@@ -1,49 +1,47 @@
-import { useMemo as f, useCallback as h } from "react";
-function b({
-  disabled: p,
-  readOnly: e,
-  fieldRef: u,
+import { useMemo as D, useCallback as K } from "react";
+function A({
+  disabled: e,
+  readOnly: u,
+  fieldRef: w,
   focusNext: l,
-  focusPrevious: i,
-  adjustSegment: n,
-  deleteLastDigit: w,
-  clearSegment: y
+  focusPrevious: n,
+  adjustSegment: t,
+  clearSegment: p
 }) {
-  const a = f(
-    () => {
-      const o = {
-        // Nav keys always own the event (arrows are contentEditable caret keys we
-        // suppress even at the first/last segment), so they always report handled.
-        ArrowRight: ({ segment: r, isRTL: t }) => ((t ? i : l)(r), !0),
-        ArrowLeft: ({ segment: r, isRTL: t }) => ((t ? l : i)(r), !0)
-      };
-      return e ? o : {
-        ...o,
-        ArrowUp: ({ segment: r }) => n(r, 1),
-        ArrowDown: ({ segment: r }) => n(r, -1),
-        PageUp: ({ segment: r }) => n(r, 5),
-        PageDown: ({ segment: r }) => n(r, -5),
-        Home: ({ segment: r }) => n(r, "min"),
-        End: ({ segment: r }) => n(r, "max"),
-        // DF-5: Backspace removes the last digit (empty → focus previous); Delete clears the segment.
-        // Both always own the key (delete or focus-hop), so they report handled.
-        Backspace: ({ segment: r }) => (w(r).wasEmpty && i(r), !0),
-        Delete: ({ segment: r }) => (y(r), !0)
-      };
-    },
-    [n, y, w, l, i, e]
-  );
-  return h(
+  const y = D(() => {
+    const o = {
+      // Nav keys always own the event (arrows are contentEditable caret keys we
+      // suppress even at the first/last segment), so they always report handled.
+      ArrowRight: ({ segment: r, isRTL: i }) => ((i ? n : l)(r), !0),
+      ArrowLeft: ({ segment: r, isRTL: i }) => ((i ? l : n)(r), !0)
+    };
+    return u ? o : {
+      ...o,
+      ArrowUp: ({ segment: r }) => t(r, 1),
+      ArrowDown: ({ segment: r }) => t(r, -1),
+      PageUp: ({ segment: r }) => t(r, 5),
+      PageDown: ({ segment: r }) => t(r, -5),
+      Home: ({ segment: r }) => t(r, "min"),
+      End: ({ segment: r }) => t(r, "max"),
+      // Backspace and Delete both clear the whole segment to
+      // placeholder. Backspace on an already-empty segment moves focus to the
+      // previous segment instead (MUI parity); Delete just clears.
+      // Both always own the key (clear or focus-hop), so they report handled.
+      Backspace: ({ segment: r }) => (p(r).wasEmpty && n(r), !0),
+      Delete: ({ segment: r }) => (p(r), !0)
+    };
+  }, [t, p, l, n, u]);
+  return K(
     (o, r) => {
-      if (p || r.altKey || r.ctrlKey || r.metaKey || r.shiftKey) return;
-      const t = a[r.key];
-      if (!t) return;
-      const c = u.current, K = !!c && (getComputedStyle(c).direction === "rtl" || !!c.closest('[dir="rtl"]'));
-      t({ segment: o, event: r, isRTL: K }) && r.preventDefault();
+      if (e || r.altKey || r.ctrlKey || r.metaKey || r.shiftKey) return;
+      const i = y[r.key];
+      if (!i) return;
+      const c = w.current, a = !!c && (getComputedStyle(c).direction === "rtl" || !!c.closest('[dir="rtl"]'));
+      i({ segment: o, event: r, isRTL: a }) && r.preventDefault();
     },
-    [p, a, u]
+    [e, y, w]
   );
 }
 export {
-  b as useDateFieldKeyboard
+  A as useDateFieldKeyboard
 };

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 t=require("react"),r=require("./DateField.utils.cjs.js"),E=require("./DateField.validation.cjs.js");function M({value:l,defaultValue:F,onChange:g}){const T=t.useRef(l!==void 0),b=T.current,[i,S]=t.useState(()=>r.segmentTextFromValue(b?l??null:F??null)),[_,h]=t.useState(!1),c=t.useRef(i),d=t.useRef(new Set),o=t.useRef(!1),y={day:r.segmentNumber("day",i.day),month:r.segmentNumber("month",i.month),year:r.segmentNumber("year",i.year)},D=r.deriveValue(y),x=t.useRef(D),R=t.useRef(b?l??null:null),m=t.useRef(g);t.useEffect(()=>{m.current=g},[g]),t.useEffect(()=>{if(!T.current||o.current||r.isSameDateValue(l??null,R.current))return;R.current=l??null;const e=r.segmentTextFromValue(l??null);c.current=e,S(e),x.current=r.deriveValueFromText(e)},[l]);const f=t.useCallback(e=>{var u;const n=r.deriveValueFromText(e);r.isSameDateValue(n,x.current)||(x.current=n,(u=m.current)==null||u.call(m,n))},[]),a=t.useCallback((e,n,{replace:u})=>{const s={...c.current,[e]:n};c.current=s,S(s),h(!0),f(s),u?d.current.add(e):d.current.delete(e)},[f]),N=t.useCallback((e,n)=>{const u=d.current.has(e)?"":c.current[e],s=E.tryAppendDigit(e,u,n);return s.rejected?{advanced:!1,rejected:!0}:(a(e,s.newBuffer,{replace:s.shouldAdvance}),{advanced:s.shouldAdvance,rejected:!1})},[a]),k=t.useCallback((e,n)=>{const u=c.current,s=r.segmentNumber(e,u[e]),p=r.getDaysInMonth(r.segmentNumber("year",u.year),r.segmentNumber("month",u.month)),V=r.adjustSegmentValue(e,s,n,{daysInMonth:p,today:r.todayParts()});return V==null?!1:(o.current=!0,a(e,String(V).padStart(E.SEGMENT_MAX_LENGTH[e],"0"),{replace:!0}),!0)},[a]),C=t.useCallback(e=>{const n=c.current[e];return n===""?{wasEmpty:!0}:(o.current=!0,a(e,n.slice(0,-1),{replace:!1}),{wasEmpty:!1})},[a]),v=t.useCallback(e=>{c.current[e]!==""&&(o.current=!0,a(e,"",{replace:!1}))},[a]),w=t.useCallback(e=>{o.current=!0,d.current.add(e)},[]),j=t.useCallback(()=>{o.current=!1;const e=c.current,n={day:r.normalizeSegmentText("day",e.day),month:r.normalizeSegmentText("month",e.month),year:r.normalizeSegmentText("year",e.year)};c.current=n,S(n),h(!0),f(n)},[f]);return{segmentText:i,segmentValues:y,currentValue:D,isControlled:b,wasTouched:_,appendDigit:N,adjustSegment:k,deleteLastDigit:C,clearSegment:v,beginSegmentEdit:w,commitOnBlur:j}}exports.useDateFieldValue=M;
+"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,41 +34,40 @@ 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 segment seeds to today's value on the first press.
-     * - `'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;
     /**
-     * Removes the last raw digit from the segment buffer (Backspace behaviour).
+     * Clears the entire segment buffer to `''` — the shared Backspace and
+     * Delete behaviour.
      *
-     * Returns `{ wasEmpty: true }` when the buffer was already empty so the
-     * caller (keyboard handler) knows to move focus to the previous segment.
-     * Clears `replaceNextRef` for the segment so a digit typed immediately after
-     * appends rather than replaces.
+     * Returns `{ wasEmpty: true }` when the buffer was already empty, without
+     * mutating, so the caller (keyboard handler) knows Backspace should move
+     * focus to the previous segment instead of clearing. Otherwise focus stays
+     * on the current segment. Fires `onChange(null)` via `emitIfChanged` when
+     * the cleared segment was part of a complete date. Clears `replaceNextRef`
+     * for the segment so the next digit appends.
      */
-    deleteLastDigit: (type: SegmentType) => {
+    clearSegment: (type: SegmentType) => {
         wasEmpty: boolean;
     };
-    /**
-     * Clears the entire segment buffer to `''` (Delete behaviour).
-     *
-     * Focus stays on the current segment. Fires `onChange(null)` via
-     * `emitIfChanged` when the cleared segment was part of a complete date.
-     * Clears `replaceNextRef` for the segment so the next digit appends.
-     */
-    clearSegment: (type: SegmentType) => void;
     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;