@pega/cosmos-react-core 4.0.0-dev.2.0 → 4.0.0-dev.21.0

package/lib/components/DateTime/DateTime.test-ids.js

@@ -0,0 +1,80 @@
+import { createTestIds } from '../../utils';
+import { elements } from '../FormField/FormField.test-ids';
+export const getDurationInputTestIds = createTestIds('duration-input', [
+    'control-hour',
+    'control-minute',
+    'control-second',
+    'control-number',
+    'control-unit',
+    ...elements
+]);
+export const getDateInputTestIds = createTestIds('date-input', [
+    'control-day',
+    'control-month',
+    'control-year',
+    'open-close-picker',
+    'clear-current-date',
+    'set-current-date',
+    ...elements
+]);
+export const getDateRangeInputTestIds = createTestIds('date-range-input', [
+    'from-date',
+    'to-date',
+    ...elements
+]);
+export const getDateTimeInputTestIds = createTestIds('date-time-input', [
+    'control-day',
+    'control-month',
+    'control-year',
+    'control-hour',
+    'control-minute',
+    'control-second',
+    'control-period',
+    'open-close-picker',
+    'clear-current-date-and-time',
+    'set-current-date-and-time',
+    ...elements
+]);
+export const getDayOfWeekInputTestIds = createTestIds('day-of-week-input', [
+    'control',
+    ...elements
+]);
+export const getMonthInputTestIds = createTestIds('month-input', [
+    'control-month',
+    'control-year',
+    ...elements
+]);
+export const getQuarterInputTestIds = createTestIds('quarter-input', [
+    'control-quarter',
+    'control-year',
+    ...elements
+]);
+export const getTimeInputTestIds = createTestIds('time-input', [
+    'control-hour',
+    'control-minute',
+    'control-second',
+    'control-period',
+    'open-close-picker',
+    ...elements
+]);
+export const getTimeRangeInputTestIds = createTestIds('time-range-input', [
+    'from-time',
+    'to-time',
+    'from-date-time',
+    'to-date-time',
+    ...elements
+]);
+export const getWeekInputTestIds = createTestIds('week-input', [
+    'control-week',
+    'control-year',
+    'open-close-picker',
+    ...elements
+]);
+export const getDatePickerTestIds = createTestIds('date-picker', [
+    'previous-month',
+    'month',
+    'next-month',
+    'calendar',
+    'time'
+]);
+//# sourceMappingURL=DateTime.test-ids.js.map

package/lib/components/DateTime/DateTime.test-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTime.test-ids.js","sourceRoot":"","sources":["../../../src/components/DateTime/DateTime.test-ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC,gBAAgB,EAAE;IACrE,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,EAAE;IAC7D,aAAa;IACb,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC,kBAAkB,EAAE;IACxE,WAAW;IACX,SAAS;IACT,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC,iBAAiB,EAAE;IACtE,aAAa;IACb,eAAe;IACf,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,6BAA6B;IAC7B,2BAA2B;IAC3B,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC,mBAAmB,EAAE;IACzE,SAAS;IACT,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,EAAE;IAC/D,eAAe;IACf,cAAc;IACd,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC,eAAe,EAAE;IACnE,iBAAiB;IACjB,cAAc;IACd,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,EAAE;IAC7D,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC,kBAAkB,EAAE;IACxE,WAAW;IACX,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,EAAE;IAC7D,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,GAAG,QAAQ;CACH,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,EAAE;IAC/D,gBAAgB;IAChB,OAAO;IACP,YAAY;IACZ,UAAU;IACV,MAAM;CACE,CAAC,CAAC","sourcesContent":["import { createTestIds } from '../../utils';\nimport { elements } from '../FormField/FormField.test-ids';\n\nexport const getDurationInputTestIds = createTestIds('duration-input', [\n  'control-hour',\n  'control-minute',\n  'control-second',\n  'control-number',\n  'control-unit',\n  ...elements\n] as const);\n\nexport const getDateInputTestIds = createTestIds('date-input', [\n  'control-day',\n  'control-month',\n  'control-year',\n  'open-close-picker',\n  'clear-current-date',\n  'set-current-date',\n  ...elements\n] as const);\n\nexport const getDateRangeInputTestIds = createTestIds('date-range-input', [\n  'from-date',\n  'to-date',\n  ...elements\n] as const);\n\nexport const getDateTimeInputTestIds = createTestIds('date-time-input', [\n  'control-day',\n  'control-month',\n  'control-year',\n  'control-hour',\n  'control-minute',\n  'control-second',\n  'control-period',\n  'open-close-picker',\n  'clear-current-date-and-time',\n  'set-current-date-and-time',\n  ...elements\n] as const);\n\nexport const getDayOfWeekInputTestIds = createTestIds('day-of-week-input', [\n  'control',\n  ...elements\n] as const);\n\nexport const getMonthInputTestIds = createTestIds('month-input', [\n  'control-month',\n  'control-year',\n  ...elements\n] as const);\n\nexport const getQuarterInputTestIds = createTestIds('quarter-input', [\n  'control-quarter',\n  'control-year',\n  ...elements\n] as const);\n\nexport const getTimeInputTestIds = createTestIds('time-input', [\n  'control-hour',\n  'control-minute',\n  'control-second',\n  'control-period',\n  'open-close-picker',\n  ...elements\n] as const);\n\nexport const getTimeRangeInputTestIds = createTestIds('time-range-input', [\n  'from-time',\n  'to-time',\n  'from-date-time',\n  'to-date-time',\n  ...elements\n] as const);\n\nexport const getWeekInputTestIds = createTestIds('week-input', [\n  'control-week',\n  'control-year',\n  'open-close-picker',\n  ...elements\n] as const);\n\nexport const getDatePickerTestIds = createTestIds('date-picker', [\n  'previous-month',\n  'month',\n  'next-month',\n  'calendar',\n  'time'\n] as const);\n"]}

package/lib/components/DateTime/DateTime.types.d.ts

@@ -1,6 +1,7 @@
-import { NoChildrenProp } from '../../types';
-import { FormControlProps } from '../FormControl';
-export interface DateTimeProperties {
+import { Ref } from 'react';
+import { NoChildrenProp, TestIdProp } from '../../types';
+import { FormControlProps, HandleValue } from '../FormControl';
+export interface DateTimeProperties extends TestIdProp {
     /** Date as ISO8601 string, timestamp or native Date object. Defines minimum available value that can be set by the user. */
     min?: string | number | Date;
     /** Date as ISO8601 string, timestamp or native Date object. Defines maximum available value that can be set by the user. */
@@ -28,10 +29,12 @@ export interface DateTimeProperties {
     name?: FormControlProps['name'];
     /** Automatically focuses the input on render. */
     autoFocus?: boolean;
+    /** Imperative handle */
+    handle?: Ref<HandleValue>;
 }
-export declare type DateTimeValueErrorState = 'incomplete' | 'invalid';
-export declare type DateTimeCallbackParameter = {
-    valueAsISOString: string;
+export type DateTimeValueErrorState = 'incomplete' | 'invalid';
+export type DateTimeCallbackParameter = {
+    valueAsISOString: string | undefined;
     valueAsTimestamp: number | undefined;
     state?: DateTimeValueErrorState;
 };
@@ -51,16 +54,12 @@ export default interface DateTimeProps extends DateTimeProperties, DateTimeCallb
      * Requires onChange prop to update value for controlled inputs.
      */
     value?: string | number | Date;
-    /**
-     * Date as ISO8601 string, timestamp or native Date object. Sets the value for an uncontrolled input.
-     */
-    defaultValue?: string | number | Date;
 }
-export declare type DateRangeCallbackParameter = {
+export type DateRangeCallbackParameter = {
     start: DateTimeCallbackParameter;
     end: DateTimeCallbackParameter;
 };
-export declare type AbsoluteVariant = 'date' | 'datetime' | 'time' | 'week' | 'month' | 'year' | 'monthyear' | 'quarteryear';
-export declare type DateTimeVariant = AbsoluteVariant | 'relative';
-export declare type DateTimeFormat = 'short' | 'long' | 'numeric';
+export type AbsoluteVariant = 'date' | 'datetime' | 'time' | 'week' | 'month' | 'year' | 'monthyear' | 'quarteryear';
+export type DateTimeVariant = AbsoluteVariant | 'relative';
+export type DateTimeFormat = 'short' | 'long' | 'numeric';
 //# sourceMappingURL=DateTime.types.d.ts.map

package/lib/components/DateTime/DateTime.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateTime.types.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DateTime.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,4HAA4H;IAC5H,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,4HAA4H;IAC5H,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5B,oDAAoD;IACpD,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,uCAAuC;IACvC,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,6GAA6G;IAC7G,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,oBAAY,uBAAuB,GAAG,YAAY,GAAG,SAAS,CAAC;AAE/D,oBAAY,yBAAyB,GAAG;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACtD,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACrD,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACpD,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;CAC/D;AAED,MAAM,CAAC,OAAO,WAAW,aACvB,SAAQ,kBAAkB,EACxB,iBAAiB,EACjB,cAAc;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,oBAAY,0BAA0B,GAAG;IACvC,KAAK,EAAE,yBAAyB,CAAC;IACjC,GAAG,EAAE,yBAAyB,CAAC;CAChC,CAAC;AAEF,oBAAY,eAAe,GACvB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,GACX,aAAa,CAAC;AAClB,oBAAY,eAAe,GAAG,eAAe,GAAG,UAAU,CAAC;AAC3D,oBAAY,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC"}
+{"version":3,"file":"DateTime.types.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DateTime.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,4HAA4H;IAC5H,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,4HAA4H;IAC5H,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,EAAE,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5B,oDAAoD;IACpD,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,uCAAuC;IACvC,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,6GAA6G;IAC7G,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACxC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,MAAM,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,SAAS,CAAC;AAE/D,MAAM,MAAM,yBAAyB,GAAG;IACtC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACtD,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACrD,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACpD,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;CAC/D;AAED,MAAM,CAAC,OAAO,WAAW,aACvB,SAAQ,kBAAkB,EACxB,iBAAiB,EACjB,cAAc;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,yBAAyB,CAAC;IACjC,GAAG,EAAE,yBAAyB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,GACX,aAAa,CAAC;AAClB,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,UAAU,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/lib/components/DateTime/DateTime.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateTime.types.js","sourceRoot":"","sources":["../../../src/components/DateTime/DateTime.types.ts"],"names":[],"mappings":"","sourcesContent":["import { NoChildrenProp } from '../../types';\nimport { FormControlProps } from '../FormControl';\n\nexport interface DateTimeProperties {\n  /** Date as ISO8601 string, timestamp or native Date object. Defines minimum available value that can be set by the user. */\n  min?: string | number | Date;\n  /** Date as ISO8601 string, timestamp or native Date object. Defines maximum available value that can be set by the user. */\n  max?: string | number | Date;\n  /**\n   * Sets DOM id for the control and associates label element via 'for' attribute.\n   * If an id is not pass, a random id will be generated for any render.\n   */\n  id?: FormControlProps['id'];\n  /** Set visual state based on a validation state. */\n  status?: FormControlProps['status'];\n  /** Pass a string or a fragment with an Icon and string. */\n  label?: FormControlProps['label'];\n  /** Visually hides the label region. */\n  labelHidden?: FormControlProps['labelHidden'];\n  /** It is recommended to pass a simple string to offer guidance. Text will be styled based on status prop. */\n  info?: FormControlProps['info'];\n  /** Indicate if the field is required. The browser defaults to false. */\n  required?: FormControlProps['required'];\n  /** Disable the control. The browser defaults to false. */\n  disabled?: FormControlProps['disabled'];\n  /** Makes the input non editable and non clickable. The browser defaults to false. */\n  readOnly?: FormControlProps['readOnly'];\n  /** Sets html name attribute for the underlying control. Useful for mapping to a data field. */\n  name?: FormControlProps['name'];\n  /** Automatically focuses the input on render. */\n  autoFocus?: boolean;\n}\n\nexport type DateTimeValueErrorState = 'incomplete' | 'invalid';\n\nexport type DateTimeCallbackParameter = {\n  valueAsISOString: string;\n  valueAsTimestamp: number | undefined;\n  state?: DateTimeValueErrorState;\n};\n\nexport interface DateTimeCallbacks {\n  /** Callback fired when input value changes. */\n  onChange?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when the component gets focused. */\n  onFocus?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when the component loses focus. */\n  onBlur?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when AI suggestion is accepted/rejected */\n  onResolveSuggestion?: FormControlProps['onResolveSuggestion'];\n}\n\nexport default interface DateTimeProps\n  extends DateTimeProperties,\n    DateTimeCallbacks,\n    NoChildrenProp {\n  /**\n   * Date as ISO8601 string, timestamp or native Date object.\n   * Requires onChange prop to update value for controlled inputs.\n   */\n  value?: string | number | Date;\n  /**\n   * Date as ISO8601 string, timestamp or native Date object. Sets the value for an uncontrolled input.\n   */\n  defaultValue?: string | number | Date;\n}\n\nexport type DateRangeCallbackParameter = {\n  start: DateTimeCallbackParameter;\n  end: DateTimeCallbackParameter;\n};\n\nexport type AbsoluteVariant =\n  | 'date'\n  | 'datetime'\n  | 'time'\n  | 'week'\n  | 'month'\n  | 'year'\n  | 'monthyear'\n  | 'quarteryear';\nexport type DateTimeVariant = AbsoluteVariant | 'relative';\nexport type DateTimeFormat = 'short' | 'long' | 'numeric';\n"]}
+{"version":3,"file":"DateTime.types.js","sourceRoot":"","sources":["../../../src/components/DateTime/DateTime.types.ts"],"names":[],"mappings":"","sourcesContent":["import { Ref } from 'react';\n\nimport { NoChildrenProp, TestIdProp } from '../../types';\nimport { FormControlProps, HandleValue } from '../FormControl';\n\nexport interface DateTimeProperties extends TestIdProp {\n  /** Date as ISO8601 string, timestamp or native Date object. Defines minimum available value that can be set by the user. */\n  min?: string | number | Date;\n  /** Date as ISO8601 string, timestamp or native Date object. Defines maximum available value that can be set by the user. */\n  max?: string | number | Date;\n  /**\n   * Sets DOM id for the control and associates label element via 'for' attribute.\n   * If an id is not pass, a random id will be generated for any render.\n   */\n  id?: FormControlProps['id'];\n  /** Set visual state based on a validation state. */\n  status?: FormControlProps['status'];\n  /** Pass a string or a fragment with an Icon and string. */\n  label?: FormControlProps['label'];\n  /** Visually hides the label region. */\n  labelHidden?: FormControlProps['labelHidden'];\n  /** It is recommended to pass a simple string to offer guidance. Text will be styled based on status prop. */\n  info?: FormControlProps['info'];\n  /** Indicate if the field is required. The browser defaults to false. */\n  required?: FormControlProps['required'];\n  /** Disable the control. The browser defaults to false. */\n  disabled?: FormControlProps['disabled'];\n  /** Makes the input non editable and non clickable. The browser defaults to false. */\n  readOnly?: FormControlProps['readOnly'];\n  /** Sets html name attribute for the underlying control. Useful for mapping to a data field. */\n  name?: FormControlProps['name'];\n  /** Automatically focuses the input on render. */\n  autoFocus?: boolean;\n  /** Imperative handle */\n  handle?: Ref<HandleValue>;\n}\n\nexport type DateTimeValueErrorState = 'incomplete' | 'invalid';\n\nexport type DateTimeCallbackParameter = {\n  valueAsISOString: string | undefined;\n  valueAsTimestamp: number | undefined;\n  state?: DateTimeValueErrorState;\n};\n\nexport interface DateTimeCallbacks {\n  /** Callback fired when input value changes. */\n  onChange?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when the component gets focused. */\n  onFocus?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when the component loses focus. */\n  onBlur?: (value: DateTimeCallbackParameter) => void;\n  /** Callback fired when AI suggestion is accepted/rejected */\n  onResolveSuggestion?: FormControlProps['onResolveSuggestion'];\n}\n\nexport default interface DateTimeProps\n  extends DateTimeProperties,\n    DateTimeCallbacks,\n    NoChildrenProp {\n  /**\n   * Date as ISO8601 string, timestamp or native Date object.\n   * Requires onChange prop to update value for controlled inputs.\n   */\n  value?: string | number | Date;\n}\n\nexport type DateRangeCallbackParameter = {\n  start: DateTimeCallbackParameter;\n  end: DateTimeCallbackParameter;\n};\n\nexport type AbsoluteVariant =\n  | 'date'\n  | 'datetime'\n  | 'time'\n  | 'week'\n  | 'month'\n  | 'year'\n  | 'monthyear'\n  | 'quarteryear';\nexport type DateTimeVariant = AbsoluteVariant | 'relative';\nexport type DateTimeFormat = 'short' | 'long' | 'numeric';\n"]}

package/lib/components/DateTime/DateTimeDisplay.d.ts

@@ -3,22 +3,16 @@ import { BaseProps, ForwardProps } from '../../types';
 import { DateTimeFormat, DateTimeVariant } from './DateTime.types';
 import { ClockFormat } from './Input/utils';
 export interface DateTimeDisplayProps extends BaseProps {
-    /**
-     * Date as ISO8601 string, timestamp or native Date object.
-     */
+    /** Date as ISO8601 string, timestamp or native Date object. */
     value?: Date | string | number;
-    /**
-     * Controls date time variant.
-     */
+    /** Controls date time variant. */
     variant: DateTimeVariant;
     /**
      * Controls display format.
-     * @default "short"
+     * @default 'short'
      */
     format?: DateTimeFormat;
-    /**
-     * Defines clock format that overrides locale based format
-     */
+    /** Defines clock format that overrides locale based format */
     clockFormat?: ClockFormat;
     /** Ref for the wrapping element. */
     ref?: Ref<HTMLSpanElement>;

package/lib/components/DateTime/DateTimeDisplay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateTimeDisplay.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DateTimeDisplay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAmB,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAIzD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oCAAoC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,0GAAgB,CAAC;AAEnD,QAAA,MAAM,eAAe,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,YAAY,CA+B3E,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DateTimeDisplay.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DateTimeDisplay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAmB,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAIzD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,+DAA+D;IAC/D,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,kCAAkC;IAClC,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oCAAoC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,0GAAgB,CAAC;AAEnD,QAAA,MAAM,eAAe,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,YAAY,CA+B3E,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/lib/components/DateTime/DateTimeDisplay.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef } from 'react';
 import styled from 'styled-components';
 import { useConfiguration, useI18n } from '../../hooks';
+import NoValue from '../NoValue/NoValue';
 import { parseToDate } from './Input/utils';
 import { isValidDate } from './Picker/utils';
 import { formatDateTime } from './utils';
@@ -16,7 +17,7 @@ const DateTimeDisplay = forwardRef(({ value, variant, format = 'short', clockFor
             variant,
             clockFormat,
             timeZone: 'UTC'
-        })) : (_jsx("span", { "aria-hidden": 'true', children: "\u2013\u2013" })) }));
+        })) : (_jsx(NoValue, {})) }));
 });
 export default DateTimeDisplay;
 //# sourceMappingURL=DateTimeDisplay.js.map

package/lib/components/DateTime/DateTimeDisplay.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateTimeDisplay.js","sourceRoot":"","sources":["../../../src/components/DateTime/DateTimeDisplay.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,OAAO,CAAC;AAC5E,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAe,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAwBzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAA,EAAE,CAAC;AAEnD,MAAM,eAAe,GAA2D,UAAU,CACxF,CACE,EACE,KAAK,EACL,OAAO,EACP,MAAM,GAAG,OAAO,EAChB,WAAW,EACX,GAAG,SAAS,EAC0B,EACxC,GAAgC,EAChC,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IAEpB,OAAO,CACL,KAAC,qBAAqB,IAAC,GAAG,EAAE,GAAG,KAAM,SAAS,YAC3C,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3D,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YACjC,CAAC;YACD,MAAM;YACN,MAAM;YACN,OAAO;YACP,WAAW;YACX,QAAQ,EAAE,KAAK;SAChB,CAAC,CACH,CAAC,CAAC,CAAC,CACF,8BAAkB,MAAM,6BAAsB,CAC/C,GACqB,CACzB,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import { forwardRef, FunctionComponent, PropsWithoutRef, Ref } from 'react';\nimport styled from 'styled-components';\n\nimport { BaseProps, ForwardProps } from '../../types';\nimport { useConfiguration, useI18n } from '../../hooks';\n\nimport { DateTimeFormat, DateTimeVariant } from './DateTime.types';\nimport { ClockFormat, parseToDate } from './Input/utils';\nimport { isValidDate } from './Picker/utils';\nimport { formatDateTime } from './utils';\n\nexport interface DateTimeDisplayProps extends BaseProps {\n  /**\n   * Date as ISO8601 string, timestamp or native Date object.\n   */\n  value?: Date | string | number;\n  /**\n   * Controls date time variant.\n   */\n  variant: DateTimeVariant;\n  /**\n   * Controls display format.\n   * @default \"short\"\n   */\n  format?: DateTimeFormat;\n  /**\n   * Defines clock format that overrides locale based format\n   */\n  clockFormat?: ClockFormat;\n  /** Ref for the wrapping element. */\n  ref?: Ref<HTMLSpanElement>;\n}\n\nexport const StyledDateTimeDisplay = styled.span``;\n\nconst DateTimeDisplay: FunctionComponent<DateTimeDisplayProps & ForwardProps> = forwardRef(\n  (\n    {\n      value,\n      variant,\n      format = 'short',\n      clockFormat,\n      ...restProps\n    }: PropsWithoutRef<DateTimeDisplayProps>,\n    ref: DateTimeDisplayProps['ref']\n  ) => {\n    const { locale } = useConfiguration();\n    const t = useI18n();\n\n    return (\n      <StyledDateTimeDisplay ref={ref} {...restProps}>\n        {(value || value === 0) && isValidDate(parseToDate(value)) ? (\n          formatDateTime(parseToDate(value), {\n            t,\n            locale,\n            format,\n            variant,\n            clockFormat,\n            timeZone: 'UTC'\n          })\n        ) : (\n          <span aria-hidden='true'>&ndash;&ndash;</span>\n        )}\n      </StyledDateTimeDisplay>\n    );\n  }\n);\n\nexport default DateTimeDisplay;\n"]}
+{"version":3,"file":"DateTimeDisplay.js","sourceRoot":"","sources":["../../../src/components/DateTime/DateTimeDisplay.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,OAAO,CAAC;AAC5E,OAAO,MAAM,MAAM,mBAAmB,CAAC;AAGvC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,OAAO,MAAM,oBAAoB,CAAC;AAGzC,OAAO,EAAe,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAkBzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAA,EAAE,CAAC;AAEnD,MAAM,eAAe,GAA2D,UAAU,CACxF,CACE,EACE,KAAK,EACL,OAAO,EACP,MAAM,GAAG,OAAO,EAChB,WAAW,EACX,GAAG,SAAS,EAC0B,EACxC,GAAgC,EAChC,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IAEpB,OAAO,CACL,KAAC,qBAAqB,IAAC,GAAG,EAAE,GAAG,KAAM,SAAS,YAC3C,CAAC,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3D,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;YACjC,CAAC;YACD,MAAM;YACN,MAAM;YACN,OAAO;YACP,WAAW;YACX,QAAQ,EAAE,KAAK;SAChB,CAAC,CACH,CAAC,CAAC,CAAC,CACF,KAAC,OAAO,KAAG,CACZ,GACqB,CACzB,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import { forwardRef, FunctionComponent, PropsWithoutRef, Ref } from 'react';\nimport styled from 'styled-components';\n\nimport { BaseProps, ForwardProps } from '../../types';\nimport { useConfiguration, useI18n } from '../../hooks';\nimport NoValue from '../NoValue/NoValue';\n\nimport { DateTimeFormat, DateTimeVariant } from './DateTime.types';\nimport { ClockFormat, parseToDate } from './Input/utils';\nimport { isValidDate } from './Picker/utils';\nimport { formatDateTime } from './utils';\n\nexport interface DateTimeDisplayProps extends BaseProps {\n  /** Date as ISO8601 string, timestamp or native Date object. */\n  value?: Date | string | number;\n  /** Controls date time variant. */\n  variant: DateTimeVariant;\n  /**\n   * Controls display format.\n   * @default 'short'\n   */\n  format?: DateTimeFormat;\n  /** Defines clock format that overrides locale based format */\n  clockFormat?: ClockFormat;\n  /** Ref for the wrapping element. */\n  ref?: Ref<HTMLSpanElement>;\n}\n\nexport const StyledDateTimeDisplay = styled.span``;\n\nconst DateTimeDisplay: FunctionComponent<DateTimeDisplayProps & ForwardProps> = forwardRef(\n  (\n    {\n      value,\n      variant,\n      format = 'short',\n      clockFormat,\n      ...restProps\n    }: PropsWithoutRef<DateTimeDisplayProps>,\n    ref: DateTimeDisplayProps['ref']\n  ) => {\n    const { locale } = useConfiguration();\n    const t = useI18n();\n\n    return (\n      <StyledDateTimeDisplay ref={ref} {...restProps}>\n        {(value || value === 0) && isValidDate(parseToDate(value)) ? (\n          formatDateTime(parseToDate(value), {\n            t,\n            locale,\n            format,\n            variant,\n            clockFormat,\n            timeZone: 'UTC'\n          })\n        ) : (\n          <NoValue />\n        )}\n      </StyledDateTimeDisplay>\n    );\n  }\n);\n\nexport default DateTimeDisplay;\n"]}

package/lib/components/DateTime/DurationDisplay.d.ts

@@ -7,6 +7,10 @@ export interface DurationDisplayProps extends BaseProps {
      * @default 4
      */
     significantUnits?: 4 | 3 | 2 | 1;
+    /** Unit formatting style
+     * @default "narrow"
+     */
+    unitDisplay?: Intl.NumberFormatOptions['unitDisplay'];
     /** Ref for the wrapping element. */
     ref?: Ref<HTMLSpanElement>;
 }

package/lib/components/DateTime/DurationDisplay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DurationDisplay.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DurationDisplay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAmB,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKtD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,oCAAoC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;CAC5B;AAED,QAAA,MAAM,eAAe,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,YAAY,CAiB3E,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DurationDisplay.d.ts","sourceRoot":"","sources":["../../../src/components/DateTime/DurationDisplay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAmB,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMtD,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACtD,oCAAoC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;CAC5B;AAED,QAAA,MAAM,eAAe,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,YAAY,CAsB3E,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/lib/components/DateTime/DurationDisplay.js

@@ -2,10 +2,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef } from 'react';
 import { useConfiguration } from '../../hooks';
 import Text from '../Text';
+import NoValue from '../NoValue/NoValue';
 import { formatDuration } from './utils';
-const DurationDisplay = forwardRef(({ value, significantUnits = 4, ...restProps }, ref) => {
+const DurationDisplay = forwardRef(({ value, significantUnits = 4, unitDisplay = 'narrow', ...restProps }, ref) => {
     const { locale } = useConfiguration();
-    return (_jsx(Text, { ref: ref, ...restProps, children: typeof value === 'number' ? (formatDuration(value, { locale, significantUnits })) : (_jsx("span", { "aria-hidden": 'true', children: "\u2013\u2013" })) }));
+    return (_jsx(Text, { ref: ref, ...restProps, children: typeof value === 'number' ? (formatDuration(value, { locale, significantUnits, unitDisplay })) : (_jsx(NoValue, {})) }));
 });
 export default DurationDisplay;
 //# sourceMappingURL=DurationDisplay.js.map

package/lib/components/DateTime/DurationDisplay.js.map

@@ -1 +1 @@
-{"version":3,"file":"DurationDisplay.js","sourceRoot":"","sources":["../../../src/components/DateTime/DurationDisplay.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAazC,MAAM,eAAe,GAA2D,UAAU,CACxF,CACE,EAAE,KAAK,EAAE,gBAAgB,GAAG,CAAC,EAAE,GAAG,SAAS,EAAyC,EACpF,GAAgC,EAChC,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAEtC,OAAO,CACL,KAAC,IAAI,IAAC,GAAG,EAAE,GAAG,KAAM,SAAS,YAC1B,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC3B,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CACpD,CAAC,CAAC,CAAC,CACF,8BAAkB,MAAM,6BAAsB,CAC/C,GACI,CACR,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import { forwardRef, FunctionComponent, PropsWithoutRef, Ref } from 'react';\n\nimport { useConfiguration } from '../../hooks';\nimport { BaseProps, ForwardProps } from '../../types';\nimport Text from '../Text';\n\nimport { formatDuration } from './utils';\n\nexport interface DurationDisplayProps extends BaseProps {\n  /** Number of milliseconds value for controlled input. */\n  value?: number;\n  /** Determines number of units to be displayed.\n   * @default 4\n   */\n  significantUnits?: 4 | 3 | 2 | 1;\n  /** Ref for the wrapping element. */\n  ref?: Ref<HTMLSpanElement>;\n}\n\nconst DurationDisplay: FunctionComponent<DurationDisplayProps & ForwardProps> = forwardRef(\n  (\n    { value, significantUnits = 4, ...restProps }: PropsWithoutRef<DurationDisplayProps>,\n    ref: DurationDisplayProps['ref']\n  ) => {\n    const { locale } = useConfiguration();\n\n    return (\n      <Text ref={ref} {...restProps}>\n        {typeof value === 'number' ? (\n          formatDuration(value, { locale, significantUnits })\n        ) : (\n          <span aria-hidden='true'>&ndash;&ndash;</span>\n        )}\n      </Text>\n    );\n  }\n);\n\nexport default DurationDisplay;\n"]}
+{"version":3,"file":"DurationDisplay.js","sourceRoot":"","sources":["../../../src/components/DateTime/DurationDisplay.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,OAAO,MAAM,oBAAoB,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiBzC,MAAM,eAAe,GAA2D,UAAU,CACxF,CACE,EACE,KAAK,EACL,gBAAgB,GAAG,CAAC,EACpB,WAAW,GAAG,QAAQ,EACtB,GAAG,SAAS,EAC0B,EACxC,GAAgC,EAChC,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAEtC,OAAO,CACL,KAAC,IAAI,IAAC,GAAG,EAAE,GAAG,KAAM,SAAS,YAC1B,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC3B,cAAc,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CACjE,CAAC,CAAC,CAAC,CACF,KAAC,OAAO,KAAG,CACZ,GACI,CACR,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,eAAe,eAAe,CAAC","sourcesContent":["import { forwardRef, FunctionComponent, PropsWithoutRef, Ref } from 'react';\n\nimport { useConfiguration } from '../../hooks';\nimport { BaseProps, ForwardProps } from '../../types';\nimport Text from '../Text';\nimport NoValue from '../NoValue/NoValue';\n\nimport { formatDuration } from './utils';\n\nexport interface DurationDisplayProps extends BaseProps {\n  /** Number of milliseconds value for controlled input. */\n  value?: number;\n  /** Determines number of units to be displayed.\n   * @default 4\n   */\n  significantUnits?: 4 | 3 | 2 | 1;\n  /** Unit formatting style\n   * @default \"narrow\"\n   */\n  unitDisplay?: Intl.NumberFormatOptions['unitDisplay'];\n  /** Ref for the wrapping element. */\n  ref?: Ref<HTMLSpanElement>;\n}\n\nconst DurationDisplay: FunctionComponent<DurationDisplayProps & ForwardProps> = forwardRef(\n  (\n    {\n      value,\n      significantUnits = 4,\n      unitDisplay = 'narrow',\n      ...restProps\n    }: PropsWithoutRef<DurationDisplayProps>,\n    ref: DurationDisplayProps['ref']\n  ) => {\n    const { locale } = useConfiguration();\n\n    return (\n      <Text ref={ref} {...restProps}>\n        {typeof value === 'number' ? (\n          formatDuration(value, { locale, significantUnits, unitDisplay })\n        ) : (\n          <NoValue />\n        )}\n      </Text>\n    );\n  }\n);\n\nexport default DurationDisplay;\n"]}

package/lib/components/DateTime/Input/DateInput.d.ts

@@ -1,8 +1,13 @@
-import { FunctionComponent, Dispatch, SetStateAction, ComponentType } from 'react';
+import { FunctionComponent, Ref, Dispatch, SetStateAction, ComponentType } from 'react';
 import { ForwardProps } from '../../../types';
 import type DatePickerProps from '../Picker/DatePicker.types';
-import { FormControlProps } from '../../FormControl';
+import { FormControlProps, HandleValue } from '../../FormControl';
 import DateTimeProps from '../DateTime.types';
+export interface DateInputHandleValue extends HandleValue {
+    readonly value: Date | undefined;
+    setOpen: Dispatch<SetStateAction<boolean>>;
+    buttonEl: HTMLElement | null;
+}
 export interface DateInputProps extends DateTimeProps {
     /**
      * Display additional column with week number in date picker popover.
@@ -16,13 +21,12 @@ export interface DateInputProps extends DateTimeProps {
     };
     /** Pass a heading and content to show additional information on the field. */
     additionalInfo?: FormControlProps['additionalInfo'];
-}
-export interface DateInputRefObject {
-    readonly value: Date | undefined;
-    setOpen: Dispatch<SetStateAction<boolean>>;
-    buttonEl: HTMLElement | null;
+    /** Additional properties for imperative control. */
+    handle?: Ref<DateInputHandleValue | HandleValue>;
 }
 export declare const StyledDateInput: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, DateInputProps, never>;
-declare const DateInput: FunctionComponent<DateInputProps & ForwardProps>;
-export default DateInput;
+declare const _default: FunctionComponent<DateInputProps & ForwardProps> & {
+    getTestIds: (testIdProp?: string | undefined) => import("../../../types").TestIdsRecord<readonly ["control-day", "control-month", "control-year", "open-close-picker", "clear-current-date", "set-current-date", "label", "info", "additional-info", "suggestion-accept", "suggestion-reject"]>;
+};
+export default _default;
 //# sourceMappingURL=DateInput.d.ts.map

package/lib/components/DateTime/Input/DateInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateInput.d.ts","sourceRoot":"","sources":["../../../../src/components/DateTime/Input/DateInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EAMjB,QAAQ,EACR,cAAc,EAGd,aAAa,EACd,MAAM,OAAO,CAAC;AAKf,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAqB,MAAM,mBAAmB,CAAC;AACxE,OAAO,aAA4C,MAAM,mBAAmB,CAAC;AAgB7E,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,aAAa,CAAC;QACxB,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;KACzD,CAAC;IACF,8EAA8E;IAC9E,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,qHAE3B,CAAC;AAsCF,QAAA,MAAM,SAAS,EAAE,iBAAiB,CAAC,cAAc,GAAG,YAAY,CA+R/D,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"DateInput.d.ts","sourceRoot":"","sources":["../../../../src/components/DateTime/Input/DateInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EAGjB,GAAG,EAGH,QAAQ,EACR,cAAc,EAGd,aAAa,EACd,MAAM,OAAO,CAAC;AAWf,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,KAAK,eAAe,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AACrF,OAAO,aAA4C,MAAM,mBAAmB,CAAC;AAwB7E,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,aAAa,CAAC;QACxB,aAAa,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;KACzD,CAAC;IACF,8EAA8E;IAC9E,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IACpD,oDAAoD;IACpD,MAAM,CAAC,EAAE,GAAG,CAAC,oBAAoB,GAAG,WAAW,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,eAAe,qHAE3B,CAAC;;;;AAyXF,wBAA2D"}

package/lib/components/DateTime/Input/DateInput.js

@@ -1,46 +1,46 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { forwardRef, useRef, useImperativeHandle, useEffect } from 'react';
 import styled from 'styled-components';
 import { defaultThemeProp } from '../../../theme';
-import { useConfiguration, useFocusWithin, useI18n } from '../../../hooks';
+import { useConfiguration, useFocusWithin, useI18n, useOuterEvent, useTestIds } from '../../../hooks';
 import FormField from '../../FormField';
 import Flex from '../../Flex';
 import Button from '../../Button';
 import Icon, { registerIcon } from '../../Icon';
-import * as timesIcon from '../../Icon/icons/times.icon';
 import * as calendarIcon from '../../Icon/icons/calendar.icon';
 import DatePicker from '../Picker/DatePicker';
-import Popover from '../../Popover';
 import { StyledFormControl } from '../../FormControl';
+import { cap, withTestIds } from '../../../utils';
+import Dialog from '../../Dialog/Dialog';
+import { getDateInputTestIds } from '../DateTime.test-ids';
 import { getDateFormat, parsePastedTextToDate, parseToDate, validateDate, generatePickerButtonAriaLabel } from './utils';
-import StyledDateTime, { StyledInputContainer } from './DateTime.styles';
+import StyledDateTime, { StyledClearNowButtonsContainer, StyledDialogContent, StyledInputContainer } from './DateTime.styles';
 import useAutoFocusNextInput from './useAutoFocusNextInput';
 import PartInput from './PartInput';
 import usePickerButton from './usePickerButton';
-registerIcon(timesIcon, calendarIcon);
+registerIcon(calendarIcon);
 export const StyledDateInput = styled(StyledDateTime) `
   padding-inline-end: 0;
 `;
 StyledDateInput.defaultProps = defaultThemeProp;
-const convertToCallbackParameter = (date, parts) => {
-    if (parts.every(Boolean)) {
-        const [year, monthIndex, day] = parts.map(Number);
-        if (!validateDate(parts[0] ?? '', monthIndex + 1, day)) {
+const convertToCallbackParameter = (date, { year, month: monthIndex, day }) => {
+    if ([year, monthIndex, day].every(Boolean)) {
+        if (!validateDate(Number(year), Number(monthIndex) + 1, Number(day))) {
             return {
                 valueAsISOString: '',
                 valueAsTimestamp: NaN,
                 state: 'invalid'
             };
         }
-        date.setUTCFullYear(year, monthIndex, day);
+        date.setUTCFullYear(Number(year), Number(monthIndex), Number(day));
         return {
             valueAsISOString: date.toISOString(),
             valueAsTimestamp: date.getTime()
         };
     }
-    if (parts.every(p => !p)) {
+    if ([year, monthIndex, day].every(p => !p)) {
         return {
-            valueAsISOString: '',
+            valueAsISOString: undefined,
             valueAsTimestamp: undefined
         };
     }
@@ -52,8 +52,10 @@ const convertToCallbackParameter = (date, parts) => {
 };
 const DateInput = forwardRef((props, ref) => {
     const { locale } = useConfiguration();
-    const { defaultValue, value = defaultValue, min, max, id, label, labelHidden, info = getDateFormat(locale).join(''), status, required, readOnly, disabled, onChange, onFocus, onBlur, onResolveSuggestion, showWeekNumber, picker: { renderer: PickerComp = DatePicker, rendererProps = {} } = {}, autoFocus, additionalInfo, ...restProps } = props;
+    const { testId, value, min, max, id, label, labelHidden, info = getDateFormat(locale).join(''), status, required, readOnly, disabled, onChange, onFocus, onBlur, onResolveSuggestion, showWeekNumber, picker: { renderer: PickerComp = DatePicker, rendererProps = {} } = {}, autoFocus, additionalInfo, handle, ...restProps } = props;
+    const testIds = useTestIds(testId, getDateInputTestIds);
     const t = useI18n();
+    const containerRef = useRef(null);
     const date = value !== undefined ? parseToDate(value) : undefined;
     const [yearInputRef, monthInputRef, dayInputRef] = [
         useRef(null),
@@ -61,20 +63,21 @@ const DateInput = forwardRef((props, ref) => {
         useRef(null)
     ];
     const pickParts = () => {
-        const month = monthInputRef.current?.value
-            ? (Number(monthInputRef.current.value) - 1).toString()
-            : undefined;
-        return [
-            yearInputRef.current?.value || undefined,
-            month,
-            dayInputRef.current?.value || undefined
-        ];
+        return {
+            day: dayInputRef.current?.value || undefined,
+            month: monthInputRef.current?.value
+                ? (Number(monthInputRef.current.value) - 1).toString()
+                : undefined,
+            year: yearInputRef.current?.value || undefined
+        };
     };
     const currentlySelectedDate = () => {
         const parts = pickParts();
-        if (parts.every(Boolean)) {
-            const [year, monthIndex, day] = parts.map(Number);
-            return validateDate(parts[0] ?? '', monthIndex + 1, day)
+        if (Object.values(parts).every(Boolean)) {
+            const year = Number(parts.year);
+            const monthIndex = Number(parts.month);
+            const day = Number(parts.day);
+            return validateDate(year, monthIndex + 1, day)
                 ? new Date(Date.UTC(year, monthIndex, day))
                 : undefined;
         }
@@ -89,7 +92,6 @@ const DateInput = forwardRef((props, ref) => {
             if (inputContainerRef.current)
                 inputContainerRef.current.scrollTop = 0;
             onBlur?.(callbackParam);
-            setOpen(false);
         }
     };
     const onInputChange = () => {
@@ -97,9 +99,12 @@ const DateInput = forwardRef((props, ref) => {
         buttonEl?.setAttribute('aria-label', generatePickerButtonAriaLabel(currentlySelectedDate(), 'date', locale, t, open));
     };
     const setInputValue = (newValue) => {
-        dayInputRef.current.value = newValue.getUTCDate().toString().padStart(2, '0');
-        monthInputRef.current.value = (newValue.getUTCMonth() + 1).toString().padStart(2, '0');
-        yearInputRef.current.value = newValue.getUTCFullYear().toString();
+        if (dayInputRef.current && monthInputRef.current && yearInputRef.current) {
+            dayInputRef.current.value = newValue?.getUTCDate().toString().padStart(2, '0') ?? '';
+            monthInputRef.current.value =
+                (newValue && (newValue.getUTCMonth() + 1).toString().padStart(2, '0')) ?? '';
+            yearInputRef.current.value = newValue?.getUTCFullYear().toString() ?? '';
+        }
     };
     const onPaste = (e) => {
         const text = e.clipboardData.getData('text');
@@ -110,35 +115,55 @@ const DateInput = forwardRef((props, ref) => {
             onInputChange();
         }
     };
+    // autoclose picker on focusing out
+    useOuterEvent('focusin', [containerRef], e => {
+        if (containerRef.current?.contains(e.relatedTarget))
+            setOpen(false);
+    });
     const displayNames = new Intl.DisplayNames(locale, { style: 'long', type: 'dateTimeField' });
-    const DayInput = (_jsx(PartInput, { placeholder: t('day_placeholder'), "aria-label": displayNames.of('day'), value: date?.getUTCDate(), onChange: onInputChange, size: 2, maxLength: 2, readOnly: readOnly, min: 1, max: 31, ref: dayInputRef }, 'day'));
-    const MonthInput = (_jsx(PartInput, { placeholder: t('month_placeholder'), "aria-label": displayNames.of('month'), value: date ? date?.getUTCMonth() + 1 : undefined, onChange: onInputChange, size: 2, maxLength: 2, readOnly: readOnly, min: 1, max: 12, ref: monthInputRef }, 'month'));
-    const YearInput = (_jsx(PartInput, { placeholder: t('year_placeholder'), "aria-label": displayNames.of('year'), value: date?.getUTCFullYear(), onChange: onInputChange, size: 4, maxLength: 4, padWithZeros: false, readOnly: readOnly, min: 1, ref: yearInputRef }, 'year'));
-    const containerRef = useRef(null);
+    const DayInput = (_jsx(PartInput, { "data-testid": testIds.controlDay, placeholder: t('day_placeholder'), "aria-label": displayNames.of('day'), value: date?.getUTCDate(), onChange: onInputChange, size: 2, maxLength: 2, readOnly: readOnly, min: 1, max: 31, ref: dayInputRef }, 'day'));
+    const MonthInput = (_jsx(PartInput, { "data-testid": testIds.controlMonth, placeholder: t('month_placeholder'), "aria-label": displayNames.of('month'), value: date ? date.getUTCMonth() + 1 : undefined, onChange: onInputChange, size: 2, maxLength: 2, readOnly: readOnly, min: 1, max: 12, ref: monthInputRef }, 'month'));
+    const YearInput = (_jsx(PartInput, { "data-testid": testIds.controlYear, placeholder: t('year_placeholder'), "aria-label": displayNames.of('year'), value: date?.getUTCFullYear(), onChange: onInputChange, size: 4, maxLength: 4, padWithZeros: false, readOnly: readOnly, min: 1, ref: yearInputRef }, 'year'));
     useFocusWithin([containerRef], onFocusChange);
-    useImperativeHandle(ref, () => ({
+    useImperativeHandle(handle, () => ({
         setOpen,
         buttonEl,
         get value() {
             return currentlySelectedDate();
+        },
+        clear: () => {
+            if (dayInputRef.current)
+                dayInputRef.current.value = '';
+            if (monthInputRef.current)
+                monthInputRef.current.value = '';
+            if (yearInputRef.current)
+                yearInputRef.current.value = '';
+            onInputChange();
         }
-    }));
-    const PickerButton = (_jsxs(_Fragment, { children: [_jsx(Button, { variant: 'simple', icon: true, ref: setButtonEl, onClick: () => setOpen(cur => !cur), "aria-label": generatePickerButtonAriaLabel(currentlySelectedDate(), 'date', locale, t, open), readOnly: readOnly, disabled: disabled, children: _jsx(Icon, { name: open ? 'times' : 'calendar' }) }), open && (_jsx(Popover, { ref: setPopoverRef, target: buttonEl, placement: 'bottom-end', strategy: 'fixed', modifiers: [
-                    {
-                        name: 'flip',
-                        options: {
-                            fallbackPlacements: ['top-end', 'right', 'left']
-                        }
-                    }
-                ], children: _jsx(PickerComp, { selected: currentlySelectedDate(), min: min, max: max, showWeekNumber: showWeekNumber, ...rendererProps, onChange: selected => {
-                        setInputValue(selected);
-                        setOpen(false);
-                        setTimeout(() => buttonEl?.focus());
-                        onInputChange();
-                        rendererProps?.onChange?.(selected);
-                    } }) }))] }));
+    }), [onInputChange]);
+    const PickerButton = (_jsxs(_Fragment, { children: [_jsx(Button, { "data-testid": testIds.openClosePicker, variant: 'simple', icon: true, ref: setButtonEl, onClick: () => setOpen(cur => !cur), "aria-label": generatePickerButtonAriaLabel(currentlySelectedDate(), 'date', locale, t, open), readOnly: readOnly, disabled: disabled, children: _jsx(Icon, { name: 'calendar' }) }), open && buttonEl && (_jsx(Dialog, { ref: setPopoverRef, target: buttonEl, placement: 'bottom-end', ariaLabel: t('choose_date'), children: _jsxs(Flex, { container: { direction: 'column' }, as: StyledDialogContent, children: [_jsx(PickerComp, { testId: testIds.root, selected: currentlySelectedDate(), min: min, max: max, showWeekNumber: showWeekNumber, ...rendererProps, onChange: selected => {
+                                setInputValue(selected);
+                                setOpen(false);
+                                setTimeout(() => buttonEl?.focus());
+                                onInputChange();
+                                rendererProps?.onChange?.(selected);
+                            } }), _jsxs(Flex, { as: StyledClearNowButtonsContainer, container: { justify: 'between' }, children: [_jsx(Button, { "data-testid": testIds.clearCurrentDate, "aria-label": t('clear_current_date'), onClick: () => {
+                                        setInputValue(undefined);
+                                        setOpen(false);
+                                        setTimeout(() => buttonEl?.focus());
+                                        onInputChange();
+                                    }, children: t('clear') }), _jsx(Button, { "data-testid": testIds.setCurrentDate, "aria-label": t('set_current_date_a11y'), onClick: () => {
+                                        const now = new Date();
+                                        now.setUTCMinutes(now.getMinutes());
+                                        now.setUTCHours(now.getHours());
+                                        now.setUTCSeconds(now.getSeconds());
+                                        setInputValue(now);
+                                        setOpen(false);
+                                        setTimeout(() => buttonEl?.focus());
+                                        onInputChange();
+                                    }, children: cap(new Intl.RelativeTimeFormat(locale, { numeric: 'auto' }).format(0, 'day')) })] })] }) }))] }));
     const orderedRefs = [];
-    const Comp = (_jsxs(Flex, { as: StyledDateInput, forwardedAs: StyledFormControl, hasSuggestion: status === 'pending' && !!onResolveSuggestion, container: { alignItems: 'center', wrap: 'nowrap' }, status: status, readOnly: readOnly, disabled: disabled, ref: containerRef, onClick: (e) => {
+    const Comp = (_jsxs(Flex, { "data-testid": testIds.root, as: StyledDateInput, forwardedAs: StyledFormControl, hasSuggestion: status === 'pending' && !!onResolveSuggestion, container: { alignItems: 'center', wrap: 'nowrap' }, status: status, readOnly: readOnly, disabled: disabled, ref: containerRef, onClick: (e) => {
             if (e.target === containerRef.current)
                 orderedRefs[0].current?.focus();
         }, ...restProps, children: [_jsx(Flex, { ref: inputContainerRef, as: StyledInputContainer, container: { alignItems: 'center', wrap: 'wrap' }, onPaste: onPaste, children: getDateFormat(locale).map(part => {
@@ -162,6 +187,7 @@ const DateInput = forwardRef((props, ref) => {
     }, [autoFocus]);
     useAutoFocusNextInput(orderedRefs);
     return label ? (_jsx(FormField, { as: 'fieldset', "aria-labelledby": id, labelAs: 'legend', ...{
+            testId: testIds,
             label,
             labelHidden,
             id,
@@ -173,5 +199,5 @@ const DateInput = forwardRef((props, ref) => {
             additionalInfo
         }, ref: ref, children: Comp })) : (Comp);
 });
-export default DateInput;
+export default withTestIds(DateInput, getDateInputTestIds);
 //# sourceMappingURL=DateInput.js.map