@viasat/beam-react 2.55.2 → 2.57.0

package/lib/wip/DataTable/DataTable.types.d.ts

@@ -1,5 +1,5 @@
 import { ComponentPropsWithoutRef, ComponentPropsWithRef, ReactNode } from 'react';
-import { ColumnDef, Table } from '@tanstack/react-table';
+import { ColumnDef, RowData, Table } from '@tanstack/react-table';
 import { DataTableDensity } from '@viasat/beam-shared/components/dataTable';
 /**
  * Column definition for a DataTable, aliased from TanStack Table's `ColumnDef`.
@@ -7,25 +7,22 @@ import { DataTableDensity } from '@viasat/beam-shared/components/dataTable';
  * @typeParam TValue - Type of the value held in the column's cell.
  */
 export type DataTableColumnDef<TData, TValue = unknown> = ColumnDef<TData, TValue>;
-export interface DataTableProps<TData = unknown> extends ComponentPropsWithoutRef<'div'> {
+interface DataTableBaseProps extends ComponentPropsWithRef<'div'> {
     /**
-     * Row data rendered by the table.
-     */
-    data?: TData[];
-    /**
-     * Column definitions describing how to render each column.
+     * Density of the table's rows.
+     * @default 'md'
      */
-    columns?: DataTableColumnDef<TData>[];
+    density?: DataTableDensity;
     /**
-     * A pre-built TanStack `Table` instance (e.g. from `useBeamTable`). When supplied,
-     * `DataTable` renders it directly instead of building its own from `data`/`columns`.
+     * Adds a border around the table container.
+     * @default true
      */
-    table?: Table<TData>;
+    bordered?: boolean;
     /**
-     * Density of the table's rows.
-     * @default 'md'
+     * Rounds the corners of the table container.
+     * @default true
      */
-    density?: DataTableDensity;
+    rounded?: boolean;
     /**
      * Props forwarded to the inner `<table>` element. The root props on `DataTable`
      * target the wrapper `<div>`, which contains both the toolbar and the table.
@@ -35,7 +32,51 @@ export interface DataTableProps<TData = unknown> extends ComponentPropsWithoutRe
      * DataTable sub-components (Header, Toolbar, Head, ColumnHeader, Body, Row, Cell, Footer).
      */
     children?: ReactNode;
+    /**
+     * Accessible name for the table. Applied directly to the `<table>` element, unless
+     * a `DataTable.Toolbar` is present — then it's applied to the container as a
+     * `region` landmark naming the whole widget instead.
+     */
+    'aria-label'?: string;
+    /**
+     * ID of the element that labels the table. Alternative to `aria-label` — see its
+     * description for how the label is routed depending on whether a toolbar is present.
+     */
+    'aria-labelledby'?: string;
+}
+/**
+ * Layer 1 (ADR-000): the opaque `data`/`columns` path. DataTable builds its TanStack
+ * instance internally via `useBeamTable`. Mutually exclusive with `table` — see
+ * {@link DataTableInstanceProps}.
+ */
+export interface DataTableDataProps<TData extends RowData = unknown> extends DataTableBaseProps {
+    /**
+     * Row data rendered by the table.
+     */
+    data?: TData[];
+    /**
+     * Column definitions describing how to render each column.
+     */
+    columns?: DataTableColumnDef<TData>[];
+    table?: never;
+}
+/**
+ * Layer 2/3 (ADR-000): renders a pre-built TanStack `table` instance — from
+ * `useBeamTable` or a raw `useReactTable` escape hatch — directly instead of
+ * building one internally. Mutually exclusive with `data`/`columns` — see
+ * {@link DataTableDataProps}.
+ */
+export interface DataTableInstanceProps<TData extends RowData = unknown> extends DataTableBaseProps {
+    data?: never;
+    columns?: never;
+    /**
+     * A pre-built TanStack `Table` instance (e.g. from `useBeamTable` or
+     * `useReactTable`). When supplied, DataTable renders it directly instead of
+     * building its own. Mutually exclusive with `data`/`columns`.
+     */
+    table: Table<TData>;
 }
+export type DataTableProps<TData extends RowData = unknown> = DataTableDataProps<TData> | DataTableInstanceProps<TData>;
 export interface DataTableHeaderProps extends ComponentPropsWithRef<'caption'> {
     children?: ReactNode;
 }
@@ -64,3 +105,4 @@ export interface DataTableCellProps extends ComponentPropsWithRef<'td'> {
 export interface DataTableFooterProps extends ComponentPropsWithRef<'tfoot'> {
     children?: ReactNode;
 }
+export {};

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("react/jsx-runtime");require("clsx");require("react");const e=require("../../../chunks/DateField.Segment.CqFLhMYA.js");require("./DateField.utils.cjs.js");exports.DateFieldSegment=e.DateFieldSegment;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("react/jsx-runtime");require("clsx");require("react");require("../../../chunks/use-isomorphic-layout-effect.browser.esm.CkGv31zs.js");const e=require("../../../chunks/DateField.Segment.BqMaeKLk.js");require("./DateField.utils.cjs.js");exports.DateFieldSegment=e.DateFieldSegment;

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

@@ -1,8 +1,9 @@
 import "react/jsx-runtime";
 import "clsx";
 import "react";
-import { D as p } from "../../../chunks/DateField.Segment.CwhRnhtq.js";
+import "../../../chunks/use-isomorphic-layout-effect.browser.esm.DERp5kr6.js";
+import { D as a } from "../../../chunks/DateField.Segment.BMXzpxgl.js";
 import "./DateField.utils.es.js";
 export {
-  p as DateFieldSegment
+  a as DateFieldSegment
 };

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("react/jsx-runtime"),n=require("../../../chunks/DateField.Segment.CqFLhMYA.js"),t=require("./DateField.utils.cjs.js"),Y={month:"MM",day:"DD",year:"YYYY"},j=({parts:o,segmentText:r,segmentValues:a,focusedSegment:m,disabled:c,readOnly:d,invalid:u,role:y,onSegmentFocus:D,onSegmentBlur:h,onSegmentInput:p,onSegmentKeyDown:M,registerSegmentRef:x})=>{const _={day:{min:1,max:t.getDaysInMonth(a.year,a.month)},month:{min:1,max:t.MONTH_MAX},year:{min:t.YEAR_MIN,max:t.YEAR_MAX}};return i.jsx("span",{className:n.styles[n.staticDateFieldClassNames.segments],children:o.map((s,g)=>{if(s.type==="literal")return i.jsx("span",{"aria-hidden":"true",className:n.styles[n.staticDateFieldClassNames.separator],children:s.value},`literal-${g}`);const e=s.type,F=Y[e],{displayValue:l,isPlaceholder:S}=t.getSegmentDisplay(e,r[e],F),{min:v,max:N}=_[e],A=e==="month"&&a.month!=null?t.getMonthName(a.month):l;return i.jsx(n.DateFieldSegment,{type:e,value:a[e],valueMin:v,valueMax:N,displayValue:l,isPlaceholder:S,valueText:A,invalid:u,role:y,isActive:m===e,disabled:c,readOnly:d,onFocus:()=>D(e),onBlur:h,onInput:p,onKeyDown:M,segmentRef:x(e)},e)})})};exports.DateFieldSegments=j;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("react/jsx-runtime"),n=require("../../../chunks/DateField.Segment.BqMaeKLk.js"),t=require("./DateField.utils.cjs.js"),Y={month:"MM",day:"DD",year:"YYYY"},j=({parts:o,segmentText:r,segmentValues:a,focusedSegment:m,disabled:c,readOnly:d,invalid:u,role:y,onSegmentFocus:D,onSegmentBlur:h,onSegmentInput:p,onSegmentKeyDown:M,registerSegmentRef:x})=>{const _={day:{min:1,max:t.getDaysInMonth(a.year,a.month)},month:{min:1,max:t.MONTH_MAX},year:{min:t.YEAR_MIN,max:t.YEAR_MAX}};return i.jsx("span",{className:n.styles[n.staticDateFieldClassNames.segments],children:o.map((s,g)=>{if(s.type==="literal")return i.jsx("span",{"aria-hidden":"true",className:n.styles[n.staticDateFieldClassNames.separator],children:s.value},`literal-${g}`);const e=s.type,F=Y[e],{displayValue:l,isPlaceholder:S}=t.getSegmentDisplay(e,r[e],F),{min:v,max:N}=_[e],A=e==="month"&&a.month!=null?t.getMonthName(a.month):l;return i.jsx(n.DateFieldSegment,{type:e,value:a[e],valueMin:v,valueMax:N,displayValue:l,isPlaceholder:S,valueText:A,invalid:u,role:y,isActive:m===e,disabled:c,readOnly:d,onFocus:()=>D(e),onBlur:h,onInput:p,onKeyDown:M,segmentRef:x(e)},e)})})};exports.DateFieldSegments=j;

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

@@ -1,5 +1,5 @@
 import { jsx as n } from "react/jsx-runtime";
-import { s, a as m, D as F } from "../../../chunks/DateField.Segment.CwhRnhtq.js";
+import { s, a as m, D as F } from "../../../chunks/DateField.Segment.BMXzpxgl.js";
 import { getDaysInMonth as R, getSegmentDisplay as S, YEAR_MAX as I, YEAR_MIN as T, MONTH_MAX as _, getMonthName as B } from "./DateField.utils.es.js";
 const C = {
   month: "MM",

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react/jsx-runtime"),qe=require("clsx"),r=require("react"),e=require("../../../chunks/DateField.Segment.CqFLhMYA.js"),we=require("../../../chunks/constants.CgMu0_1M.js"),Ie=require("../../../chunks/helpers.BIckGIbP.js"),Me=require("../../../chunks/form.context.CkC0TwMb.js"),Ne=require("../../Form/contexts/label.context.cjs.js"),Oe=require("../../Form/contexts/helperText.context.cjs.js"),Ve=require("../../Form/hooks/useUniversalRef.hook.cjs.js"),je=require("../../../utils/hooks/useIsMounted.cjs.js"),Pe=require("./DateField.Segments.cjs.js"),i=require("./DateField.utils.cjs.js"),Re=require("./useDateFieldFocus.cjs.js"),Ce=require("./useDateFieldForm.cjs.js"),Te=require("./useDateFieldKeyboard.cjs.js"),Be=require("./useDateFieldSegments.cjs.js"),Ee=require("./useDateFieldValidity.cjs.js"),Ke=require("./useDateFieldValue.cjs.js"),He=require("./useInvalidState.cjs.js"),Le=r.forwardRef(function({value:N,defaultValue:O,onChange:V,minDate:d,maxDate:n,getClampAnnouncement:j,locale:P,label:F=null,helperText:f=null,error:_,hideRequiredMarker:R=!1,validationRules:C,width:T,theme:m,fluid:B=!1,disabled:E=!1,readOnly:K=!1,required:H=!1,name:D,id:L,className:k,style:$,"aria-label":U,"aria-describedby":W,"aria-labelledby":A,...z},G){const{disabled:s,readOnly:o,required:p,invalid:J,errorMessageProvided:g,defaultValue:Q,errorId:x,helperTextId:X,validationErrorsId:Y,labelId:v,ariaDescribedBy:Z,ariaLabelledBy:ee,showErrors:se}=Ce.useDateFieldForm({name:D,disabled:E,readOnly:K,required:H,defaultValue:O,error:_,hasHelperText:!!f,hasLabel:!!F,validationRules:C,ariaDescribedBy:W,ariaLabelledBy:A});r.useEffect(()=>{process.env.NODE_ENV!=="production"&&i.isMinMaxMisconfigured(d,n)&&console.warn("DateField: `minDate` is after `maxDate` — no date satisfies both, so the blur clamp is disabled and values are left as typed.")},[i.dateKeyOrNull(d),i.dateKeyOrNull(n)]);const{refFn:ae,ref:y}=Ve.useUniversalRef(G),{segmentRefs:ie,registerSegmentRef:le}=Be.useDateFieldSegments(),te=P??"en-US",u=i.getDateParts(te),S=r.useMemo(()=>i.getSegmentOrder(u),[u]),{segmentText:re,segmentValues:h,currentValue:q,wasTouched:de,appendDigit:w,adjustSegment:ne,clearSegment:oe,beginSegmentEdit:ue,commitOnBlur:ce,clampAnnouncement:be}=Ke.useDateFieldValue({value:N,defaultValue:Q,onChange:V,minDate:d,maxDate:n,getClampAnnouncement:j}),{focusedSegment:I,fieldTabIndex:Fe,handleSegmentFocus:M,handleFieldFocus:fe,handleFieldBlur:_e,handleFieldMouseDown:me,focusNext:c,focusPrevious:De}=Re.useDateFieldFocus({disabled:s,fieldRef:y,segmentRefs:ie,partsOrder:S,onSegmentFocusChange:ue,onFieldBlur:ce}),pe=Te.useDateFieldKeyboard({disabled:s,readOnly:o,fieldRef:y,focusNext:c,focusPrevious:De,adjustSegment:ne,clearSegment:oe}),{isInvalid:ge}=Ee.useDateFieldValidity({segments:h,currentValue:q,wasTouched:de,isFocused:I!==null}),xe=r.useCallback((l,t)=>{const{advanced:he}=w(l,t);he&&c(l)},[w,c]),b=He.useInvalidState({formInvalid:J,valueInvalid:ge}),ve=je.useIsMounted()&&Ie.isIOS()?"textbox":"spinbutton",ye=l=>{if(s)return;const t=l.target.closest("label");!t||t.id!==v||(l.preventDefault(),M(S[0]))},Se=qe(e.styles[e.baseClassNamePrefix],m&&we.themeClassName(m),B&&e.styles[`${e.classModifierPrefix}fluid`],b&&e.styles[`${e.classModifierPrefix}error`],s&&e.styles[`${e.classModifierPrefix}disabled`],o&&e.styles[`${e.classModifierPrefix}read-only`],k);return a.jsxs("div",{className:Se,style:{...$,maxWidth:T},onMouseDownCapture:ye,children:[a.jsx(Ne.LabelProvider,{ctxId:v,ctxDisabled:s,ctxRequired:p&&!R,children:F}),a.jsx("div",{...z,ref:ae,id:L,role:"group","aria-label":U,"aria-labelledby":ee,"aria-disabled":s||void 0,"aria-required":p||void 0,"aria-invalid":b||void 0,"aria-describedby":Z,"aria-errormessage":g?x:void 0,tabIndex:Fe,className:e.styles[e.staticDateFieldClassNames.field],onMouseDown:me,onFocus:fe,children:a.jsx(Pe.DateFieldSegments,{parts:u,segmentText:re,segmentValues:h,focusedSegment:I,disabled:s,readOnly:o,invalid:b,role:ve,onSegmentFocus:M,onSegmentBlur:_e,onSegmentInput:xe,onSegmentKeyDown:pe,registerSegmentRef:le})}),a.jsx("span",{role:"status","aria-live":"polite","aria-atomic":"true",className:e.styles[e.staticDateFieldClassNames.srStatus],children:be}),a.jsx("input",{type:"hidden",name:D,value:i.toISODateString(q),disabled:s}),a.jsxs(Oe.HelperTextProvider,{ctxId:X,ctxDisabled:s,children:[f,g&&a.jsx(Me.HelperText,{id:x,appearance:"negative",children:_})]}),se(Y)]})});exports.DateField=Le;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react/jsx-runtime"),Ie=require("clsx"),u=require("react"),e=require("../../../chunks/DateField.Segment.BqMaeKLk.js"),Me=require("../../../chunks/constants.CgMu0_1M.js"),Ee=require("../../../chunks/helpers.BIckGIbP.js"),Ne=require("../../../chunks/form.context.CkC0TwMb.js"),Re=require("../../Form/contexts/label.context.cjs.js"),Ce=require("../../Form/contexts/helperText.context.cjs.js"),je=require("../../Form/hooks/useUniversalRef.hook.cjs.js"),Le=require("../../../utils/hooks/useIsMounted.cjs.js"),Oe=require("../ErrorBoundary/ErrorBoundary.cjs.js"),Be=require("./DateField.Segments.cjs.js"),C=require("./DateField.devWarnings.cjs.js"),l=require("./DateField.utils.cjs.js"),Te=require("./useDateFieldFocus.cjs.js"),Ve=require("./useDateFieldForm.cjs.js"),Pe=require("./useDateFieldKeyboard.cjs.js"),Ae=require("./useDateFieldSegments.cjs.js"),ke=require("./useDateFieldValidity.cjs.js"),Ke=require("./useDateFieldValue.cjs.js"),He=require("./useInvalidState.cjs.js"),We="MM/DD/YYYY",Ue=()=>{process.env.NODE_ENV!=="production"&&console.warn("DateField: segments failed to render; showing a static fallback.")},Ye=u.forwardRef(function({value:c,defaultValue:_,onChange:j,minDate:F,maxDate:b,getClampAnnouncement:L,locale:O,label:D=null,helperText:m=null,error:f,hideRequiredMarker:B=!1,validationRules:T,width:V,theme:g,fluid:P=!1,disabled:A=!1,readOnly:k=!1,required:K=!1,name:p,id:H,className:W,style:U,"aria-label":Y,"aria-describedby":$,"aria-labelledby":z,...G},J){const{disabled:a,readOnly:r,required:x,invalid:Q,errorMessageProvided:v,defaultValue:X,errorId:y,helperTextId:Z,validationErrorsId:ee,labelId:h,ariaDescribedBy:se,ariaLabelledBy:ae,showErrors:ie}=Ve.useDateFieldForm({name:p,disabled:A,readOnly:k,required:K,defaultValue:_,error:f,hasHelperText:!!m,hasLabel:!!D,validationRules:T,ariaDescribedBy:$,ariaLabelledBy:z});C.useDevMinMaxWarning(F,b),C.useDevInvalidValueWarning(c,_);const{refFn:le,ref:S}=je.useUniversalRef(J),{segmentRefs:te,registerSegmentRef:re}=Ae.useDateFieldSegments(),ne=O??l.DEFAULT_LOCALE,q=Le.useIsMounted(),n=l.getDateParts(q?ne:l.DEFAULT_LOCALE),w=u.useMemo(()=>l.getSegmentOrder(n),[n]),{segmentText:de,segmentValues:I,currentValue:M,wasTouched:oe,appendDigit:E,adjustSegment:ue,clearSegment:ce,beginSegmentEdit:_e,commitOnBlur:Fe,clampAnnouncement:be}=Ke.useDateFieldValue({value:c,defaultValue:X,onChange:j,minDate:F,maxDate:b,getClampAnnouncement:L}),{focusedSegment:N,fieldTabIndex:De,handleSegmentFocus:R,handleFieldFocus:me,handleFieldBlur:fe,handleFieldMouseDown:ge,focusNext:d,focusPrevious:pe}=Te.useDateFieldFocus({disabled:a,fieldRef:S,segmentRefs:te,partsOrder:w,onSegmentFocusChange:_e,onFieldBlur:Fe}),xe=Pe.useDateFieldKeyboard({disabled:a,readOnly:r,fieldRef:S,focusNext:d,focusPrevious:pe,adjustSegment:ue,clearSegment:ce}),{isInvalid:ve}=ke.useDateFieldValidity({segments:I,currentValue:M,wasTouched:oe,isFocused:N!==null}),ye=u.useCallback((i,t)=>{const{advanced:we}=E(i,t);we&&d(i)},[E,d]),o=He.useInvalidState({formInvalid:Q,valueInvalid:ve}),he=q&&Ee.isIOS()?"textbox":"spinbutton",Se=i=>{if(a)return;const t=i.target.closest("label");!t||t.id!==h||(i.preventDefault(),R(w[0]))},qe=Ie(e.styles[e.baseClassNamePrefix],g&&Me.themeClassName(g),P&&e.styles[`${e.classModifierPrefix}fluid`],o&&e.styles[`${e.classModifierPrefix}error`],a&&e.styles[`${e.classModifierPrefix}disabled`],r&&e.styles[`${e.classModifierPrefix}read-only`],W);return s.jsxs("div",{className:qe,style:{...U,maxWidth:V},onMouseDownCapture:Se,children:[s.jsx(Re.LabelProvider,{ctxId:h,ctxDisabled:a,ctxRequired:x&&!B,children:D}),s.jsx("div",{...G,ref:le,id:H,role:"group","aria-label":Y,"aria-labelledby":ae,"aria-disabled":a||void 0,"aria-required":x||void 0,"aria-invalid":o||void 0,"aria-describedby":se,"aria-errormessage":v?y:void 0,tabIndex:De,className:e.styles[e.staticDateFieldClassNames.field],onMouseDown:ge,onFocus:me,children:s.jsx(Oe.ErrorBoundary,{fallback:s.jsx("span",{className:e.styles[e.staticDateFieldClassNames.segments],children:We}),onError:Ue,children:s.jsx(Be.DateFieldSegments,{parts:n,segmentText:de,segmentValues:I,focusedSegment:N,disabled:a,readOnly:r,invalid:o,role:he,onSegmentFocus:R,onSegmentBlur:fe,onSegmentInput:ye,onSegmentKeyDown:xe,registerSegmentRef:re})})}),s.jsx("span",{role:"status","aria-live":"polite","aria-atomic":"true",className:e.styles[e.staticDateFieldClassNames.srStatus],children:be}),s.jsx("input",{type:"hidden",name:p,value:l.toISODateString(M),disabled:a}),s.jsxs(Ce.HelperTextProvider,{ctxId:Z,ctxDisabled:a,children:[m,v&&s.jsx(Ne.HelperText,{id:y,appearance:"negative",children:f})]}),ie(ee)]})});exports.DateField=Ye;

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react"),i=require("./DateField.utils.cjs.js"),l=(e,a)=>{s.useEffect(()=>{process.env.NODE_ENV!=="production"&&i.isMinMaxMisconfigured(e,a)&&console.warn("DateField: `minDate` is after `maxDate` — no date satisfies both, so the blur clamp is disabled and values are left as typed.")},[i.dateKeyOrNull(e),i.dateKeyOrNull(a)])},r=(e,a)=>{const n=e instanceof Date&&!i.isValidDate(e),t=a instanceof Date&&!i.isValidDate(a);s.useEffect(()=>{process.env.NODE_ENV!=="production"&&(n&&console.warn("DateField: `value` is an Invalid Date; rendering with no value."),t&&console.warn("DateField: `defaultValue` is an Invalid Date; rendering with no value."))},[n,t])};exports.useDevInvalidValueWarning=r;exports.useDevMinMaxWarning=l;

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

@@ -0,0 +1,15 @@
+/**
+ * Dev-only guard: `minDate` after `maxDate` is a caller misconfig where no date
+ * satisfies both, so the blur clamp is disabled (values are left as typed). Warns
+ * once per prop change (stripped in production). Deps key on the primitive
+ * calendar day, not the `Date` object — an inline `new Date()` bound would
+ * otherwise re-run this every render and spam the warning.
+ */
+export declare const useDevMinMaxWarning: (minDate: Date | null | undefined, maxDate: Date | null | undefined) => void;
+/**
+ * Dev-only guard: an Invalid Date prop renders with no value (segments show
+ * placeholders). Warns so the caller notices rather than debugging a silently
+ * empty field. Keyed on booleans, not the `Date` objects, so a fresh-but-valid
+ * `Date` each render doesn't churn.
+ */
+export declare const useDevInvalidValueWarning: (value: Date | null | undefined, defaultValue: Date | null | undefined) => void;

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

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

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

@@ -1,236 +1,245 @@
-import { jsxs as O, jsx as r } from "react/jsx-runtime";
-import Ne from "clsx";
-import { forwardRef as we, useEffect as Oe, useMemo as Ve, useCallback as Ce } from "react";
-import { s as a, b as Be, c as i, a as V } from "../../../chunks/DateField.Segment.CwhRnhtq.js";
-import { t as Re } from "../../../chunks/constants.Cruz2A1w.js";
-import { i as Pe } from "../../../chunks/helpers.CiQfGwdc.js";
-import { H as Ee } from "../../../chunks/form.context.BDYA2JQs.js";
-import { LabelProvider as Le } from "../../Form/contexts/label.context.es.js";
-import { HelperTextProvider as Te } from "../../Form/contexts/helperText.context.es.js";
+import { jsxs as B, jsx as a } from "react/jsx-runtime";
+import Re from "clsx";
+import { forwardRef as Ce, useMemo as Ee, useCallback as Oe } from "react";
+import { s as r, b as Be, c as i, a as m } from "../../../chunks/DateField.Segment.BMXzpxgl.js";
+import { t as Le } from "../../../chunks/constants.Cruz2A1w.js";
+import { i as Ve } from "../../../chunks/helpers.CiQfGwdc.js";
+import { H as Te } from "../../../chunks/form.context.BDYA2JQs.js";
+import { LabelProvider as Ae } from "../../Form/contexts/label.context.es.js";
+import { HelperTextProvider as Pe } from "../../Form/contexts/helperText.context.es.js";
 import { useUniversalRef as qe } from "../../Form/hooks/useUniversalRef.hook.es.js";
-import { useIsMounted as He } from "../../../utils/hooks/useIsMounted.es.js";
-import { DateFieldSegments as Ke } from "./DateField.Segments.es.js";
-import { isMinMaxMisconfigured as $e, dateKeyOrNull as C, getDateParts as je, getSegmentOrder as Ue, toISODateString as We } from "./DateField.utils.es.js";
-import { useDateFieldFocus as ke } from "./useDateFieldFocus.es.js";
-import { useDateFieldForm as Ae } from "./useDateFieldForm.es.js";
-import { useDateFieldKeyboard as _e } from "./useDateFieldKeyboard.es.js";
-import { useDateFieldSegments as ze } from "./useDateFieldSegments.es.js";
-import { useDateFieldValidity as Ge } from "./useDateFieldValidity.es.js";
-import { useDateFieldValue as Je } from "./useDateFieldValue.es.js";
-import { useInvalidState as Qe } from "./useInvalidState.es.js";
-const ha = we(
+import { useIsMounted as Ke } from "../../../utils/hooks/useIsMounted.es.js";
+import { ErrorBoundary as He } from "../ErrorBoundary/ErrorBoundary.es.js";
+import { DateFieldSegments as We } from "./DateField.Segments.es.js";
+import { useDevMinMaxWarning as Ye, useDevInvalidValueWarning as _e } from "./DateField.devWarnings.es.js";
+import { getDateParts as $e, getSegmentOrder as je, toISODateString as ke, DEFAULT_LOCALE as L } from "./DateField.utils.es.js";
+import { useDateFieldFocus as Ue } from "./useDateFieldFocus.es.js";
+import { useDateFieldForm as ze } from "./useDateFieldForm.es.js";
+import { useDateFieldKeyboard as Ge } from "./useDateFieldKeyboard.es.js";
+import { useDateFieldSegments as Je } from "./useDateFieldSegments.es.js";
+import { useDateFieldValidity as Qe } from "./useDateFieldValidity.es.js";
+import { useDateFieldValue as Xe } from "./useDateFieldValue.es.js";
+import { useInvalidState as Ze } from "./useInvalidState.es.js";
+const ea = "MM/DD/YYYY", aa = () => {
+  process.env.NODE_ENV !== "production" && console.warn(
+    "DateField: segments failed to render; showing a static fallback."
+  );
+}, Ma = Ce(
   function({
-    value: B,
-    defaultValue: R,
-    onChange: P,
-    minDate: l,
-    maxDate: o,
-    getClampAnnouncement: E,
-    locale: L,
-    label: c = null,
-    helperText: f = null,
-    error: p,
-    hideRequiredMarker: T = !1,
+    value: u,
+    defaultValue: c,
+    onChange: V,
+    minDate: f,
+    maxDate: p,
+    getClampAnnouncement: T,
+    locale: A,
+    label: g = null,
+    helperText: b = null,
+    error: v,
+    hideRequiredMarker: P = !1,
     validationRules: q,
-    width: H,
-    theme: b,
-    fluid: K = !1,
-    disabled: $ = !1,
-    readOnly: j = !1,
-    required: U = !1,
-    name: g,
-    id: W,
-    className: k,
-    style: A,
-    "aria-label": _,
+    width: K,
+    theme: D,
+    fluid: H = !1,
+    disabled: W = !1,
+    readOnly: Y = !1,
+    required: _ = !1,
+    name: F,
+    id: $,
+    className: j,
+    style: k,
+    "aria-label": U,
     "aria-describedby": z,
     "aria-labelledby": G,
     ...J
   }, Q) {
     const {
       disabled: e,
-      readOnly: d,
-      required: v,
+      readOnly: t,
+      required: h,
       invalid: X,
-      errorMessageProvided: F,
-      defaultValue: Y,
-      errorId: D,
-      helperTextId: Z,
-      validationErrorsId: ee,
-      labelId: h,
-      ariaDescribedBy: ae,
-      ariaLabelledBy: re,
-      showErrors: se
-    } = Ae({
-      name: g,
-      disabled: $,
-      readOnly: j,
-      required: U,
-      defaultValue: R,
-      error: p,
-      hasHelperText: !!f,
-      hasLabel: !!c,
+      errorMessageProvided: S,
+      defaultValue: Z,
+      errorId: x,
+      helperTextId: ee,
+      validationErrorsId: ae,
+      labelId: y,
+      ariaDescribedBy: re,
+      ariaLabelledBy: se,
+      showErrors: oe
+    } = ze({
+      name: F,
+      disabled: W,
+      readOnly: Y,
+      required: _,
+      defaultValue: c,
+      error: v,
+      hasHelperText: !!b,
+      hasLabel: !!g,
       validationRules: q,
       ariaDescribedBy: z,
       ariaLabelledBy: G
     });
-    Oe(() => {
-      process.env.NODE_ENV !== "production" && $e(l, o) && console.warn(
-        "DateField: `minDate` is after `maxDate` — no date satisfies both, so the blur clamp is disabled and values are left as typed."
-      );
-    }, [C(l), C(o)]);
-    const { refFn: te, ref: S } = qe(Q), { segmentRefs: ie, registerSegmentRef: le } = ze(), n = je(L ?? "en-US"), x = Ve(() => Ue(n), [n]), {
-      segmentText: oe,
-      segmentValues: y,
-      currentValue: I,
-      wasTouched: de,
-      appendDigit: M,
-      adjustSegment: ne,
-      clearSegment: ue,
-      beginSegmentEdit: me,
-      commitOnBlur: ce,
-      clampAnnouncement: fe
-    } = Je({
-      value: B,
-      defaultValue: Y,
-      onChange: P,
-      minDate: l,
-      maxDate: o,
-      getClampAnnouncement: E
+    Ye(f, p), _e(u, c);
+    const { refFn: ie, ref: I } = qe(Q), { segmentRefs: te, registerSegmentRef: le } = Je(), ne = A ?? L, M = Ke(), l = $e(M ? ne : L), N = Ee(() => je(l), [l]), {
+      segmentText: de,
+      segmentValues: w,
+      currentValue: R,
+      wasTouched: me,
+      appendDigit: C,
+      adjustSegment: ue,
+      clearSegment: ce,
+      beginSegmentEdit: fe,
+      commitOnBlur: pe,
+      clampAnnouncement: ge
+    } = Xe({
+      value: u,
+      defaultValue: Z,
+      onChange: V,
+      minDate: f,
+      maxDate: p,
+      getClampAnnouncement: T
     }), {
-      focusedSegment: N,
-      fieldTabIndex: pe,
-      handleSegmentFocus: w,
-      handleFieldFocus: be,
-      handleFieldBlur: ge,
-      handleFieldMouseDown: ve,
-      focusNext: u,
-      focusPrevious: Fe
-    } = ke({
+      focusedSegment: E,
+      fieldTabIndex: be,
+      handleSegmentFocus: O,
+      handleFieldFocus: ve,
+      handleFieldBlur: De,
+      handleFieldMouseDown: Fe,
+      focusNext: n,
+      focusPrevious: he
+    } = Ue({
       disabled: e,
-      fieldRef: S,
-      segmentRefs: ie,
-      partsOrder: x,
-      onSegmentFocusChange: me,
-      onFieldBlur: ce
-    }), De = _e({
+      fieldRef: I,
+      segmentRefs: te,
+      partsOrder: N,
+      onSegmentFocusChange: fe,
+      onFieldBlur: pe
+    }), Se = Ge({
       disabled: e,
-      readOnly: d,
-      fieldRef: S,
-      focusNext: u,
-      focusPrevious: Fe,
-      adjustSegment: ne,
-      clearSegment: ue
-    }), { isInvalid: he } = Ge({
-      segments: y,
-      currentValue: I,
-      wasTouched: de,
-      isFocused: N !== null
-    }), Se = Ce(
-      (s, t) => {
-        const { advanced: Me } = M(s, t);
-        Me && u(s);
+      readOnly: t,
+      fieldRef: I,
+      focusNext: n,
+      focusPrevious: he,
+      adjustSegment: ue,
+      clearSegment: ce
+    }), { isInvalid: xe } = Qe({
+      segments: w,
+      currentValue: R,
+      wasTouched: me,
+      isFocused: E !== null
+    }), ye = Oe(
+      (s, o) => {
+        const { advanced: we } = C(s, o);
+        we && n(s);
       },
-      [M, u]
-    ), m = Qe({
+      [C, n]
+    ), d = Ze({
       formInvalid: X,
-      valueInvalid: he
-    }), xe = He() && Pe() ? "textbox" : "spinbutton", ye = (s) => {
+      valueInvalid: xe
+    }), Ie = M && Ve() ? "textbox" : "spinbutton", Me = (s) => {
       if (e) return;
-      const t = s.target.closest("label");
-      !t || t.id !== h || (s.preventDefault(), w(x[0]));
-    }, Ie = Ne(
-      a[Be],
-      b && Re(b),
-      K && a[`${i}fluid`],
-      m && a[`${i}error`],
-      e && a[`${i}disabled`],
-      d && a[`${i}read-only`],
-      k
+      const o = s.target.closest("label");
+      !o || o.id !== y || (s.preventDefault(), O(N[0]));
+    }, Ne = Re(
+      r[Be],
+      D && Le(D),
+      H && r[`${i}fluid`],
+      d && r[`${i}error`],
+      e && r[`${i}disabled`],
+      t && r[`${i}read-only`],
+      j
     );
-    return /* @__PURE__ */ O(
+    return /* @__PURE__ */ B(
       "div",
       {
-        className: Ie,
-        style: { ...A, maxWidth: H },
-        onMouseDownCapture: ye,
+        className: Ne,
+        style: { ...k, maxWidth: K },
+        onMouseDownCapture: Me,
         children: [
-          /* @__PURE__ */ r(
-            Le,
+          /* @__PURE__ */ a(
+            Ae,
             {
-              ctxId: h,
+              ctxId: y,
               ctxDisabled: e,
-              ctxRequired: v && !T,
-              children: c
+              ctxRequired: h && !P,
+              children: g
             }
           ),
-          /* @__PURE__ */ r(
+          /* @__PURE__ */ a(
             "div",
             {
               ...J,
-              ref: te,
-              id: W,
+              ref: ie,
+              id: $,
               role: "group",
-              "aria-label": _,
-              "aria-labelledby": re,
+              "aria-label": U,
+              "aria-labelledby": se,
               "aria-disabled": e || void 0,
-              "aria-required": v || void 0,
-              "aria-invalid": m || void 0,
-              "aria-describedby": ae,
-              "aria-errormessage": F ? D : void 0,
-              tabIndex: pe,
-              className: a[V.field],
-              onMouseDown: ve,
-              onFocus: be,
-              children: /* @__PURE__ */ r(
-                Ke,
+              "aria-required": h || void 0,
+              "aria-invalid": d || void 0,
+              "aria-describedby": re,
+              "aria-errormessage": S ? x : void 0,
+              tabIndex: be,
+              className: r[m.field],
+              onMouseDown: Fe,
+              onFocus: ve,
+              children: /* @__PURE__ */ a(
+                He,
                 {
-                  parts: n,
-                  segmentText: oe,
-                  segmentValues: y,
-                  focusedSegment: N,
-                  disabled: e,
-                  readOnly: d,
-                  invalid: m,
-                  role: xe,
-                  onSegmentFocus: w,
-                  onSegmentBlur: ge,
-                  onSegmentInput: Se,
-                  onSegmentKeyDown: De,
-                  registerSegmentRef: le
+                  fallback: /* @__PURE__ */ a("span", { className: r[m.segments], children: ea }),
+                  onError: aa,
+                  children: /* @__PURE__ */ a(
+                    We,
+                    {
+                      parts: l,
+                      segmentText: de,
+                      segmentValues: w,
+                      focusedSegment: E,
+                      disabled: e,
+                      readOnly: t,
+                      invalid: d,
+                      role: Ie,
+                      onSegmentFocus: O,
+                      onSegmentBlur: De,
+                      onSegmentInput: ye,
+                      onSegmentKeyDown: Se,
+                      registerSegmentRef: le
+                    }
+                  )
                 }
               )
             }
           ),
-          /* @__PURE__ */ r(
+          /* @__PURE__ */ a(
             "span",
             {
               role: "status",
               "aria-live": "polite",
               "aria-atomic": "true",
-              className: a[V.srStatus],
-              children: fe
+              className: r[m.srStatus],
+              children: ge
             }
           ),
-          /* @__PURE__ */ r(
+          /* @__PURE__ */ a(
             "input",
             {
               type: "hidden",
-              name: g,
-              value: We(I),
+              name: F,
+              value: ke(R),
               disabled: e
             }
           ),
-          /* @__PURE__ */ O(Te, { ctxId: Z, ctxDisabled: e, children: [
-            f,
-            F && /* @__PURE__ */ r(Ee, { id: D, appearance: "negative", children: p })
+          /* @__PURE__ */ B(Pe, { ctxId: ee, ctxDisabled: e, children: [
+            b,
+            S && /* @__PURE__ */ a(Te, { id: x, appearance: "negative", children: v })
           ] }),
-          se(ee)
+          oe(ae)
         ]
       }
     );
   }
 );
 export {
-  ha as DateField
+  Ma as DateField
 };