@viasat/beam-react 2.47.0 → 2.47.1

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 2.47.1 (2026-07-27)
+
+### 🩹 Fixes
+
+- **DateField:** predictable empty-seed + simpler Backspace/Delete (EPTOOLS-2766) ([#1377](https://git.viasat.com/vega/Beam/pull/1377))
+
+### ❤️ Thank You
+
+- Roman-Ionita, Alin
+
 ## 2.47.0 (2026-07-23)
 
 ### 🚀 Features

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),fe=require("clsx"),me=require("react"),e=require("../../../chunks/DateField.Segment.CY0jg03_.js"),ge=require("../../../chunks/constants.CgMu0_1M.js"),pe=require("../../../chunks/form.context.D5XrYvpI.js"),xe=require("../../Form/contexts/label.context.cjs.js"),ve=require("../../Form/contexts/helperText.context.cjs.js"),ye=require("../../Form/hooks/useUniversalRef.hook.cjs.js"),r=require("./DateField.Segments.cjs.js"),Se=require("./DateField.utils.cjs.js"),qe=require("./useDateFieldFocus.cjs.js"),he=require("./useDateFieldForm.cjs.js"),we=require("./useDateFieldKeyboard.cjs.js"),Ie=require("./useDateFieldSegments.cjs.js"),Re=require("./useDateFieldValidity.cjs.js"),Pe=require("./useDateFieldValue.cjs.js"),Te=require("./useInvalidState.cjs.js"),Ve=me.forwardRef(function({value:S,defaultValue:q,onChange:h,label:d=null,helperText:n=null,error:o,hideRequiredMarker:w=!1,validationRules:I,width:R,theme:u,fluid:P=!1,disabled:T=!1,readOnly:V=!1,required:j=!1,name:c,id:M,className:N,style:O,"aria-label":B,"aria-describedby":C,"aria-labelledby":E,...H},L){const{disabled:i,readOnly:t,required:F,invalid:K,errorMessageProvided:_,defaultValue:$,errorId:b,helperTextId:k,validationErrorsId:A,labelId:D,ariaDescribedBy:U,ariaLabelledBy:W,showErrors:z}=he.useDateFieldForm({name:c,disabled:T,readOnly:V,required:j,defaultValue:q,error:o,hasHelperText:!!n,hasLabel:!!d,validationRules:I,ariaDescribedBy:C,ariaLabelledBy:E}),{refFn:G,ref:f}=ye.useUniversalRef(L),{segmentRefs:J,registerSegmentRef:Q}=Ie.useDateFieldSegments(),{segmentText:X,segmentValues:m,currentValue:g,wasTouched:Y,appendDigit:Z,adjustSegment:ee,deleteLastDigit:ie,clearSegment:ae,beginSegmentEdit:le,commitOnBlur:se}=Pe.useDateFieldValue({value:S,defaultValue:$,onChange:h}),{focusedSegment:p,fieldTabIndex:te,handleSegmentFocus:x,handleFieldFocus:re,handleFieldBlur:de,handleFieldMouseDown:ne,focusNext:v,focusPrevious:oe}=qe.useDateFieldFocus({disabled:i,fieldRef:f,segmentRefs:J,partsOrder:r.PARTS_ORDER,onSegmentFocusChange:le,onFieldBlur:se}),ue=we.useDateFieldKeyboard({disabled:i,readOnly:t,fieldRef:f,focusNext:v,focusPrevious:oe,adjustSegment:ee,deleteLastDigit:ie,clearSegment:ae}),{isInvalid:ce}=Re.useDateFieldValidity({segments:m,currentValue:g,wasTouched:Y,isFocused:p!==null}),Fe=(l,s)=>{const{advanced:De}=Z(l,s);De&&v(l)},y=Te.useInvalidState({formInvalid:K,valueInvalid:ce}),_e=l=>{if(i)return;const s=l.target.closest("label");!s||s.id!==D||(l.preventDefault(),x(r.PARTS_ORDER[0]))},be=fe(e.styles[e.baseClassNamePrefix],u&&ge.themeClassName(u),P&&e.styles[`${e.classModifierPrefix}fluid`],y&&e.styles[`${e.classModifierPrefix}error`],i&&e.styles[`${e.classModifierPrefix}disabled`],t&&e.styles[`${e.classModifierPrefix}read-only`],N);return a.jsxs("div",{className:be,style:{...O,maxWidth:R},onMouseDownCapture:_e,children:[a.jsx(xe.LabelProvider,{ctxId:D,ctxDisabled:i,ctxRequired:F&&!w,children:d}),a.jsx("div",{...H,ref:G,id:M,role:"group","aria-label":B,"aria-labelledby":W,"aria-disabled":i||void 0,"aria-required":F||void 0,"aria-invalid":y||void 0,"aria-describedby":U,"aria-errormessage":_?b:void 0,tabIndex:te,className:e.styles[e.staticDateFieldClassNames.field],onMouseDown:ne,onFocus:re,children:a.jsx(r.DateFieldSegments,{segmentText:X,segmentValues:m,focusedSegment:p,disabled:i,readOnly:t,onSegmentFocus:x,onSegmentBlur:de,onSegmentInput:Fe,onSegmentKeyDown:ue,registerSegmentRef:Q})}),a.jsx("input",{type:"hidden",name:c,value:Se.toISODateString(g),disabled:i}),a.jsxs(ve.HelperTextProvider,{ctxId:k,ctxDisabled:i,children:[n,_&&a.jsx(pe.HelperText,{id:b,appearance:"negative",children:o})]}),z(A)]})});exports.DateField=Ve;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),De=require("clsx"),fe=require("react"),e=require("../../../chunks/DateField.Segment.CY0jg03_.js"),me=require("../../../chunks/constants.CgMu0_1M.js"),ge=require("../../../chunks/form.context.D5XrYvpI.js"),pe=require("../../Form/contexts/label.context.cjs.js"),xe=require("../../Form/contexts/helperText.context.cjs.js"),ve=require("../../Form/hooks/useUniversalRef.hook.cjs.js"),r=require("./DateField.Segments.cjs.js"),ye=require("./DateField.utils.cjs.js"),Se=require("./useDateFieldFocus.cjs.js"),qe=require("./useDateFieldForm.cjs.js"),he=require("./useDateFieldKeyboard.cjs.js"),we=require("./useDateFieldSegments.cjs.js"),Ie=require("./useDateFieldValidity.cjs.js"),Re=require("./useDateFieldValue.cjs.js"),Pe=require("./useInvalidState.cjs.js"),Te=fe.forwardRef(function({value:S,defaultValue:q,onChange:h,label:d=null,helperText:n=null,error:o,hideRequiredMarker:w=!1,validationRules:I,width:R,theme:u,fluid:P=!1,disabled:T=!1,readOnly:V=!1,required:j=!1,name:c,id:M,className:N,style:O,"aria-label":B,"aria-describedby":C,"aria-labelledby":E,...H},K){const{disabled:i,readOnly:t,required:F,invalid:L,errorMessageProvided:_,defaultValue:$,errorId:b,helperTextId:k,validationErrorsId:A,labelId:D,ariaDescribedBy:U,ariaLabelledBy:W,showErrors:z}=qe.useDateFieldForm({name:c,disabled:T,readOnly:V,required:j,defaultValue:q,error:o,hasHelperText:!!n,hasLabel:!!d,validationRules:I,ariaDescribedBy:C,ariaLabelledBy:E}),{refFn:G,ref:f}=ve.useUniversalRef(K),{segmentRefs:J,registerSegmentRef:Q}=we.useDateFieldSegments(),{segmentText:X,segmentValues:m,currentValue:g,wasTouched:Y,appendDigit:Z,adjustSegment:ee,clearSegment:ie,beginSegmentEdit:ae,commitOnBlur:le}=Re.useDateFieldValue({value:S,defaultValue:$,onChange:h}),{focusedSegment:p,fieldTabIndex:se,handleSegmentFocus:x,handleFieldFocus:te,handleFieldBlur:re,handleFieldMouseDown:de,focusNext:v,focusPrevious:ne}=Se.useDateFieldFocus({disabled:i,fieldRef:f,segmentRefs:J,partsOrder:r.PARTS_ORDER,onSegmentFocusChange:ae,onFieldBlur:le}),oe=he.useDateFieldKeyboard({disabled:i,readOnly:t,fieldRef:f,focusNext:v,focusPrevious:ne,adjustSegment:ee,clearSegment:ie}),{isInvalid:ue}=Ie.useDateFieldValidity({segments:m,currentValue:g,wasTouched:Y,isFocused:p!==null}),ce=(l,s)=>{const{advanced:be}=Z(l,s);be&&v(l)},y=Pe.useInvalidState({formInvalid:L,valueInvalid:ue}),Fe=l=>{if(i)return;const s=l.target.closest("label");!s||s.id!==D||(l.preventDefault(),x(r.PARTS_ORDER[0]))},_e=De(e.styles[e.baseClassNamePrefix],u&&me.themeClassName(u),P&&e.styles[`${e.classModifierPrefix}fluid`],y&&e.styles[`${e.classModifierPrefix}error`],i&&e.styles[`${e.classModifierPrefix}disabled`],t&&e.styles[`${e.classModifierPrefix}read-only`],N);return a.jsxs("div",{className:_e,style:{...O,maxWidth:R},onMouseDownCapture:Fe,children:[a.jsx(pe.LabelProvider,{ctxId:D,ctxDisabled:i,ctxRequired:F&&!w,children:d}),a.jsx("div",{...H,ref:G,id:M,role:"group","aria-label":B,"aria-labelledby":W,"aria-disabled":i||void 0,"aria-required":F||void 0,"aria-invalid":y||void 0,"aria-describedby":U,"aria-errormessage":_?b:void 0,tabIndex:se,className:e.styles[e.staticDateFieldClassNames.field],onMouseDown:de,onFocus:te,children:a.jsx(r.DateFieldSegments,{segmentText:X,segmentValues:m,focusedSegment:p,disabled:i,readOnly:t,onSegmentFocus:x,onSegmentBlur:re,onSegmentInput:ce,onSegmentKeyDown:oe,registerSegmentRef:Q})}),a.jsx("input",{type:"hidden",name:c,value:ye.toISODateString(g),disabled:i}),a.jsxs(xe.HelperTextProvider,{ctxId:k,ctxDisabled:i,children:[n,_&&a.jsx(ge.HelperText,{id:b,appearance:"negative",children:o})]}),z(A)]})});exports.DateField=Te;

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

@@ -1,22 +1,22 @@
 import { jsxs as S, jsx as l } from "react/jsx-runtime";
-import De from "clsx";
-import { forwardRef as Fe } from "react";
-import { s as a, b as he, c as s, a as xe } from "../../../chunks/DateField.Segment.C2qoaY0Z.js";
-import { t as ye } from "../../../chunks/constants.Cruz2A1w.js";
-import { H as Se } from "../../../chunks/form.context.cEuTL68U.js";
-import { LabelProvider as Ie } from "../../Form/contexts/label.context.es.js";
-import { HelperTextProvider as we } from "../../Form/contexts/helperText.context.es.js";
-import { useUniversalRef as Re } from "../../Form/hooks/useUniversalRef.hook.es.js";
-import { DateFieldSegments as Ne, PARTS_ORDER as I } from "./DateField.Segments.es.js";
-import { toISODateString as Ve } from "./DateField.utils.es.js";
-import { useDateFieldFocus as Be } from "./useDateFieldFocus.es.js";
-import { useDateFieldForm as Ce } from "./useDateFieldForm.es.js";
-import { useDateFieldKeyboard as Oe } from "./useDateFieldKeyboard.es.js";
-import { useDateFieldSegments as Pe } from "./useDateFieldSegments.es.js";
-import { useDateFieldValidity as Te } from "./useDateFieldValidity.es.js";
-import { useDateFieldValue as Me } from "./useDateFieldValue.es.js";
-import { useInvalidState as qe } from "./useInvalidState.es.js";
-const aa = Fe(
+import ve from "clsx";
+import { forwardRef as De } from "react";
+import { s as a, b as Fe, c as s, a as he } from "../../../chunks/DateField.Segment.C2qoaY0Z.js";
+import { t as xe } from "../../../chunks/constants.Cruz2A1w.js";
+import { H as ye } from "../../../chunks/form.context.cEuTL68U.js";
+import { LabelProvider as Se } from "../../Form/contexts/label.context.es.js";
+import { HelperTextProvider as Ie } from "../../Form/contexts/helperText.context.es.js";
+import { useUniversalRef as we } from "../../Form/hooks/useUniversalRef.hook.es.js";
+import { DateFieldSegments as Re, PARTS_ORDER as I } from "./DateField.Segments.es.js";
+import { toISODateString as Ne } from "./DateField.utils.es.js";
+import { useDateFieldFocus as Ve } from "./useDateFieldFocus.es.js";
+import { useDateFieldForm as Be } from "./useDateFieldForm.es.js";
+import { useDateFieldKeyboard as Ce } from "./useDateFieldKeyboard.es.js";
+import { useDateFieldSegments as Oe } from "./useDateFieldSegments.es.js";
+import { useDateFieldValidity as Pe } from "./useDateFieldValidity.es.js";
+import { useDateFieldValue as Te } from "./useDateFieldValue.es.js";
+import { useInvalidState as Me } from "./useInvalidState.es.js";
+const ea = De(
   function({
     value: w,
     defaultValue: R,
@@ -34,9 +34,9 @@ const aa = Fe(
     required: M = !1,
     name: u,
     id: q,
-    className: L,
-    style: E,
-    "aria-label": H,
+    className: E,
+    style: H,
+    "aria-label": L,
     "aria-describedby": $,
     "aria-labelledby": j,
     ...K
@@ -55,7 +55,7 @@ const aa = Fe(
       ariaDescribedBy: z,
       ariaLabelledBy: G,
       showErrors: J
-    } = Ce({
+    } = Be({
       name: u,
       disabled: P,
       readOnly: T,
@@ -67,79 +67,77 @@ const aa = Fe(
       validationRules: B,
       ariaDescribedBy: $,
       ariaLabelledBy: j
-    }), { refFn: Q, ref: g } = Re(W), { segmentRefs: X, registerSegmentRef: Y } = Pe(), {
+    }), { refFn: Q, ref: g } = we(W), { segmentRefs: X, registerSegmentRef: Y } = Oe(), {
       segmentText: Z,
       segmentValues: v,
       currentValue: D,
       wasTouched: ee,
       appendDigit: ae,
       adjustSegment: re,
-      deleteLastDigit: le,
-      clearSegment: ie,
-      beginSegmentEdit: se,
-      commitOnBlur: de
-    } = Me({
+      clearSegment: le,
+      beginSegmentEdit: ie,
+      commitOnBlur: se
+    } = Te({
       value: w,
       defaultValue: U,
       onChange: N
     }), {
       focusedSegment: F,
-      fieldTabIndex: te,
+      fieldTabIndex: de,
       handleSegmentFocus: h,
-      handleFieldFocus: oe,
-      handleFieldBlur: ne,
-      handleFieldMouseDown: me,
+      handleFieldFocus: te,
+      handleFieldBlur: oe,
+      handleFieldMouseDown: ne,
       focusNext: x,
-      focusPrevious: ue
-    } = Be({
+      focusPrevious: me
+    } = Ve({
       disabled: e,
       fieldRef: g,
       segmentRefs: X,
       partsOrder: I,
-      onSegmentFocusChange: se,
-      onFieldBlur: de
-    }), fe = Oe({
+      onSegmentFocusChange: ie,
+      onFieldBlur: se
+    }), ue = Ce({
       disabled: e,
       readOnly: d,
       fieldRef: g,
       focusNext: x,
-      focusPrevious: ue,
+      focusPrevious: me,
       adjustSegment: re,
-      deleteLastDigit: le,
-      clearSegment: ie
-    }), { isInvalid: ce } = Te({
+      clearSegment: le
+    }), { isInvalid: fe } = Pe({
       segments: v,
       currentValue: D,
       wasTouched: ee,
       isFocused: F !== null
-    }), pe = (r, i) => {
-      const { advanced: ve } = ae(r, i);
-      ve && x(r);
-    }, y = qe({
+    }), ce = (r, i) => {
+      const { advanced: ge } = ae(r, i);
+      ge && x(r);
+    }, y = Me({
       formInvalid: A,
-      valueInvalid: ce
-    }), be = (r) => {
+      valueInvalid: fe
+    }), pe = (r) => {
       if (e) return;
       const i = r.target.closest("label");
       !i || i.id !== b || (r.preventDefault(), h(I[0]));
-    }, ge = De(
-      a[he],
-      m && ye(m),
+    }, be = ve(
+      a[Fe],
+      m && xe(m),
       O && a[`${s}fluid`],
       y && a[`${s}error`],
       e && a[`${s}disabled`],
       d && a[`${s}read-only`],
-      L
+      E
     );
     return /* @__PURE__ */ S(
       "div",
       {
-        className: ge,
-        style: { ...E, maxWidth: C },
-        onMouseDownCapture: be,
+        className: be,
+        style: { ...H, maxWidth: C },
+        onMouseDownCapture: pe,
         children: [
           /* @__PURE__ */ l(
-            Ie,
+            Se,
             {
               ctxId: b,
               ctxDisabled: e,
@@ -154,19 +152,19 @@ const aa = Fe(
               ref: Q,
               id: q,
               role: "group",
-              "aria-label": H,
+              "aria-label": L,
               "aria-labelledby": G,
               "aria-disabled": e || void 0,
               "aria-required": f || void 0,
               "aria-invalid": y || void 0,
               "aria-describedby": z,
               "aria-errormessage": c ? p : void 0,
-              tabIndex: te,
-              className: a[xe.field],
-              onMouseDown: me,
-              onFocus: oe,
+              tabIndex: de,
+              className: a[he.field],
+              onMouseDown: ne,
+              onFocus: te,
               children: /* @__PURE__ */ l(
-                Ne,
+                Re,
                 {
                   segmentText: Z,
                   segmentValues: v,
@@ -174,9 +172,9 @@ const aa = Fe(
                   disabled: e,
                   readOnly: d,
                   onSegmentFocus: h,
-                  onSegmentBlur: ne,
-                  onSegmentInput: pe,
-                  onSegmentKeyDown: fe,
+                  onSegmentBlur: oe,
+                  onSegmentInput: ce,
+                  onSegmentKeyDown: ue,
                   registerSegmentRef: Y
                 }
               )
@@ -187,13 +185,13 @@ const aa = Fe(
             {
               type: "hidden",
               name: u,
-              value: Ve(D),
+              value: Ne(D),
               disabled: e
             }
           ),
-          /* @__PURE__ */ S(we, { ctxId: _, ctxDisabled: e, children: [
+          /* @__PURE__ */ S(Ie, { ctxId: _, ctxDisabled: e, children: [
             o,
-            c && /* @__PURE__ */ l(Se, { id: p, appearance: "negative", children: n })
+            c && /* @__PURE__ */ l(ye, { id: p, appearance: "negative", children: n })
           ] }),
           J(k)
         ]
@@ -202,5 +200,5 @@ const aa = Fe(
   }
 );
 export {
-  aa as DateField
+  ea as DateField
 };

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./DateField.validation.cjs.js"),s=31,o=12,m={day:s,month:o,year:9999},u=(e,t,n)=>Math.min(n,Math.max(t,e)),g=(e,t)=>((e-1)%t+t)%t+1,S=2024,y=(e,t)=>t==null?31:new Date(e??S,t,0).getDate(),M=()=>{const e=new Date;return{day:e.getDate(),month:e.getMonth()+1,year:e.getFullYear()}},N=(e,t,n,r)=>{if(n==="min")return e==="year"?null:1;if(n==="max")return e==="year"?null:e==="day"?r.daysInMonth:o;if(t==null)return r.today[e];if(e==="year")return u(t+n,1,9999);const a=e==="day"?s:o;return g(t+n,a)},T={day:"",month:"",year:""},c=e=>e instanceof Date&&!Number.isNaN(e.getTime()),d=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},f=(e,t)=>e==null&&t==null?!0:e==null||t==null?!1:e.getTime()===t.getTime(),_=e=>{if(!c(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}`},h=e=>e.filter(t=>t.type!=="literal").map(t=>t.type),D=e=>c(e)?{day:String(e.getDate()).padStart(2,"0"),month:String(e.getMonth()+1).padStart(2,"0"),year:String(e.getFullYear()).padStart(4,"0")}:T,l=(e,t)=>{if(t===""||e==="year"&&t.length<i.SEGMENT_MAX_LENGTH.year)return null;const n=parseInt(t,10);return Number.isNaN(n)||n===0?null:n},A=e=>d({day:l("day",e.day),month:l("month",e.month),year:l("year",e.year)}),E=(e,t)=>t===""?"":t.padStart(i.SEGMENT_MAX_LENGTH[e],"0"),p=(e,t,n)=>t===""?{displayValue:n,isPlaceholder:!0}:{displayValue:t.padStart(i.SEGMENT_MAX_LENGTH[e],"0"),isPlaceholder:!1},V=e=>{const t=window.getSelection();if(!t)return;const n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)},F=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=s;exports.MONTH_MAX=o;exports.SEGMENT_ARIA_MAX=m;exports.adjustSegmentValue=N;exports.clamp=u;exports.clearSelectionWithin=F;exports.deriveValue=d;exports.deriveValueFromText=A;exports.getDaysInMonth=y;exports.getSegmentDisplay=p;exports.getSegmentOrder=h;exports.isSameDateValue=f;exports.normalizeSegmentText=E;exports.segmentNumber=l;exports.segmentTextFromValue=D;exports.selectElementContents=V;exports.toISODateString=_;exports.todayParts=M;exports.wrapInRange=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./DateField.validation.cjs.js"),i=31,l=12,S={day:i,month:l,year:9999},u=(e,t,n)=>Math.min(n,Math.max(t,e)),g=(e,t)=>((e-1)%t+t)%t+1,y=2024,M=(e,t)=>t==null?31:new Date(e??y,t,0).getDate(),N=()=>{const e=new Date;return{day:e.getDate(),month:e.getMonth()+1,year:e.getFullYear()}},f=(e,t,n,r)=>{if(n==="min")return e==="year"?null:1;if(n==="max")return e==="year"?null:e==="day"?r.daysInMonth:l;if(t==null){if(e==="year")return r.today.year;const m=e==="day"?i:l;return n>0?1:m}if(e==="year")return u(t+n,1,9999);const a=e==="day"?i:l;return g(t+n,a)},T={day:"",month:"",year:""},c=e=>e instanceof Date&&!Number.isNaN(e.getTime()),d=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},_=(e,t)=>e==null&&t==null?!0:e==null||t==null?!1:e.getTime()===t.getTime(),h=e=>{if(!c(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),A=e=>c(e)?{day:String(e.getDate()).padStart(2,"0"),month:String(e.getMonth()+1).padStart(2,"0"),year:String(e.getFullYear()).padStart(4,"0")}:T,o=(e,t)=>{if(t===""||e==="year"&&t.length<s.SEGMENT_MAX_LENGTH.year)return null;const n=parseInt(t,10);return Number.isNaN(n)||n===0?null:n},E=e=>d({day:o("day",e.day),month:o("month",e.month),year:o("year",e.year)}),p=(e,t)=>t===""?"":t.padStart(s.SEGMENT_MAX_LENGTH[e],"0"),V=(e,t,n)=>t===""?{displayValue:n,isPlaceholder:!0}:{displayValue:t.padStart(s.SEGMENT_MAX_LENGTH[e],"0"),isPlaceholder:!1},F=e=>{const t=window.getSelection();if(!t)return;const n=document.createRange();n.selectNodeContents(e),t.removeAllRanges(),t.addRange(n)},I=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=i;exports.MONTH_MAX=l;exports.SEGMENT_ARIA_MAX=S;exports.adjustSegmentValue=f;exports.clamp=u;exports.clearSelectionWithin=I;exports.deriveValue=d;exports.deriveValueFromText=E;exports.getDaysInMonth=M;exports.getSegmentDisplay=V;exports.getSegmentOrder=D;exports.isSameDateValue=_;exports.normalizeSegmentText=p;exports.segmentNumber=o;exports.segmentTextFromValue=A;exports.selectElementContents=F;exports.toISODateString=h;exports.todayParts=N;exports.wrapInRange=g;

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

@@ -49,7 +49,11 @@ export declare const todayParts: () => {
 export interface AdjustSegmentContext {
     /** Days in the current month (use {@link getDaysInMonth} to compute). */
     daysInMonth: number;
-    /** Today's local-date values used to seed an empty segment on the first press. */
+    /**
+     * Today's local-date values. Only `year` is read now — it seeds an empty
+     * year segment on the first press. Day/month seed to a fixed first/last
+     * valid value instead, so `day`/`month` here go unused.
+     */
     today: {
         day: number;
         month: number;
@@ -71,8 +75,10 @@ export interface AdjustSegmentContext {
  *   currently selected month (month-aware).
  * - **month**: modular wrap within `[1, MONTH_MAX]`.
  * - **year**: clamp to `[1, 9999]`; no wrap.
- * - **Empty segment + numeric delta**: seeds to `ctx.today[type]` (first press
- *   sets today's value; subsequent presses step from there).
+ * - **Empty segment + numeric delta**: direction-based first/last valid value
+ *   for day/month — positive amount → `1`, negative amount → `DAY_SPIN_MAX`/
+ *   `MONTH_MAX`. Year has no natural bound, so it seeds to `ctx.today.year`
+ *   regardless of direction.
  * - **`'min'`**: returns 1 for day/month, null for year.
  * - **`'max'`**: returns `ctx.daysInMonth` for day (End → month-aware last
  *   valid day), MONTH_MAX for month, null for year.

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

@@ -1,74 +1,78 @@
-import { SEGMENT_MAX_LENGTH as s } from "./DateField.validation.es.js";
-const i = 31, o = 12, f = {
-  day: i,
-  month: o,
+import { SEGMENT_MAX_LENGTH as i } from "./DateField.validation.es.js";
+const s = 31, l = 12, h = {
+  day: s,
+  month: l,
   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;
+}, 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 = () => {
+  const e = /* @__PURE__ */ new Date();
+  return { day: e.getDate(), month: e.getMonth() + 1, year: e.getFullYear() };
+}, D = (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 : l;
+  if (t == null) {
+    if (e === "year") return r.today.year;
+    const c = e === "day" ? s : l;
+    return n > 0 ? 1 : c;
+  }
+  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) => {
+  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 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(
+  (t) => t.type !== "literal"
+).map((t) => t.type), E = (e) => u(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;
+  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"),
+}, _ = (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"),
   isPlaceholder: !1
-}, F = (t) => {
-  const e = window.getSelection();
-  if (!e) return;
+}, V = (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);
+}, Y = (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,
+  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,
-  N as todayParts,
-  g as wrapInRange
+  M as todayParts,
+  d as wrapInRange
 };

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/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"),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;

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

@@ -17,7 +17,9 @@ 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.
+     *   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).
      *
@@ -33,24 +35,19 @@ export interface UseDateFieldValueReturn {
      */
     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;
 }

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

@@ -1,75 +1,63 @@
-import { useRef as o, useState as w, useEffect as b, useCallback as s } from "react";
-import { segmentTextFromValue as v, segmentNumber as d, deriveValue as C, isSameDateValue as A, deriveValueFromText as M, getDaysInMonth as H, adjustSegmentValue as O, todayParts as P, normalizeSegmentText as T } from "./DateField.utils.es.js";
-import { tryAppendDigit as W, SEGMENT_MAX_LENGTH as X } from "./DateField.validation.es.js";
-function Q({
-  value: a,
-  defaultValue: N,
+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
 }) {
-  const E = o(a !== void 0), h = E.current, [i, S] = w(
-    () => v(h ? a ?? null : N ?? null)
-  ), [F, V] = w(!1), c = o(i), m = o(/* @__PURE__ */ new Set()), l = o(!1), p = {
-    day: d("day", i.day),
-    month: d("month", i.month),
-    year: d("year", i.year)
-  }, D = C(p), y = o(D), R = o(
-    h ? a ?? null : null
-  ), f = o(x);
+  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 || l.current || A(a ?? null, R.current)) return;
-    R.current = a ?? null;
-    const e = v(a ?? null);
-    c.current = e, S(e), y.current = M(e);
-  }, [a]);
-  const g = s((e) => {
+    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 = M(e);
-    A(t, y.current) || (y.current = t, (r = f.current) == null || r.call(f, t));
-  }, []), u = s(
+    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 ? m.current.add(e) : m.current.delete(e);
+      c.current = n, S(n), V(!0), g(n), r ? i.current.add(e) : i.current.delete(e);
     },
     [g]
-  ), I = s(
+  ), I = o(
     (e, t) => {
-      const r = m.current.has(e) ? "" : c.current[e], n = W(e, r, t);
-      return n.rejected ? { advanced: !1, rejected: !0 } : (u(e, n.newBuffer, { replace: n.shouldAdvance }), { advanced: n.shouldAdvance, rejected: !1 });
+      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 });
     },
-    [u]
-  ), B = s(
+    [a]
+  ), B = o(
     (e, t) => {
-      const r = c.current, n = d(e, r[e]), z = H(
-        d("year", r.year),
-        d("month", r.month)
-      ), j = O(e, n, 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: P()
+        today: O()
       });
-      return j == null ? !1 : (l.current = !0, u(
-        e,
-        String(j).padStart(X[e], "0"),
-        { replace: !0 }
-      ), !0);
+      return j == null ? !1 : (m.current = !0, a(e, String(j).padStart(W[e], "0"), {
+        replace: !0
+      }), !0);
     },
-    [u]
-  ), G = s(
-    (e) => {
-      const t = c.current[e];
-      return t === "" ? { wasEmpty: !0 } : (l.current = !0, u(e, t.slice(0, -1), { replace: !1 }), { wasEmpty: !1 });
-    },
-    [u]
-  ), L = s(
-    (e) => {
-      c.current[e] !== "" && (l.current = !0, u(e, "", { replace: !1 }));
-    },
-    [u]
-  ), _ = s((e) => {
-    l.current = !0, m.current.add(e);
-  }, []), k = s(() => {
-    l.current = !1;
+    [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),
@@ -78,19 +66,18 @@ function Q({
     c.current = t, S(t), V(!0), g(t);
   }, [g]);
   return {
-    segmentText: i,
+    segmentText: d,
     segmentValues: p,
     currentValue: D,
     isControlled: h,
     wasTouched: F,
     appendDigit: I,
     adjustSegment: B,
-    deleteLastDigit: G,
-    clearSegment: L,
+    clearSegment: G,
     beginSegmentEdit: _,
     commitOnBlur: k
   };
 }
 export {
-  Q as useDateFieldValue
+  K as useDateFieldValue
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viasat/beam-react",
-  "version": "2.47.0",
+  "version": "2.47.1",
   "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.0",
-    "@viasat/beam-shared": "2.47.0",
-    "@viasat/beam-styles": "2.47.0",
-    "@viasat/beam-tokens": "2.47.0",
-    "@viasat/beam-icons": "2.47.0",
-    "@viasat/beam-react-claude-plugin": "2.47.0",
+    "@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",
     "clsx": "^1.2.1",
     "@floating-ui/react": "^0.26.18",
     "@stepperize/react": "^5.1.5",