@oracle/oraclejet-core-pack 16.1.3 → 17.0.0

package/oj-c/hooks/UNSAFE_useEditableValue/utils.js

@@ -0,0 +1,35 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.treatNull = exports.normalizeValue = exports.isShallowEqual = exports.hasErrorMessages = exports.createMessageFromError = void 0;
+    const createMessageFromError = (error) => {
+        if (typeof error.getMessage === 'function') {
+            return {
+                severity: 'error',
+                detail: error.getMessage().detail
+            };
+        }
+        return { severity: 'error', detail: error.message };
+    };
+    exports.createMessageFromError = createMessageFromError;
+    const treatNull = (value, defaultValue) => {
+        if (value === null) {
+            return defaultValue;
+        }
+        return value;
+    };
+    exports.treatNull = treatNull;
+    const normalizeValue = (value) => {
+        if (typeof value === 'string' && value === '') {
+            return null;
+        }
+        return value;
+    };
+    exports.normalizeValue = normalizeValue;
+    const isShallowEqual = (a, b) => a === b || (a.length === b.length && a.every((v, i) => v === b[i]));
+    exports.isShallowEqual = isShallowEqual;
+    const hasErrorMessages = (messages) => {
+        return !!messages && messages.some((message) => message.severity === 'error');
+    };
+    exports.hasErrorMessages = hasErrorMessages;
+});

package/oj-c/hooks/UNSAFE_useEditableValue/validationUtils.js

@@ -0,0 +1,53 @@
+define(["require", "exports", "./utils"], function (require, exports, utils_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.validateSync = exports.validateAsync = void 0;
+    function validateSync({ validators, value }) {
+        const errors = [];
+        for (const validator of validators) {
+            try {
+                validator.validate(value);
+            }
+            catch (error) {
+                errors.push((0, utils_1.createMessageFromError)(error));
+            }
+        }
+        if (errors.length) {
+            return { result: 'failure', errors };
+        }
+        return { result: 'success' };
+    }
+    exports.validateSync = validateSync;
+    function validateAsync({ validators, value }) {
+        const doValidate = (validator, value) => {
+            try {
+                const validateResult = validator.validate(value);
+                if (validateResult instanceof Promise) {
+                    return validateResult.then(() => { }, (error) => (0, utils_1.createMessageFromError)(error));
+                }
+            }
+            catch (error) {
+                return (0, utils_1.createMessageFromError)(error);
+            }
+            return;
+        };
+        const errors = [];
+        const maybeErrorPromises = [];
+        for (const validator of validators) {
+            const maybeComponentMessageItem = doValidate(validator, value);
+            if (maybeComponentMessageItem !== undefined) {
+                if (maybeComponentMessageItem instanceof Promise) {
+                    maybeErrorPromises.push(maybeComponentMessageItem);
+                }
+                else {
+                    errors.push(maybeComponentMessageItem);
+                }
+            }
+        }
+        return {
+            errors,
+            maybeErrorPromises
+        };
+    }
+    exports.validateAsync = validateAsync;
+});

package/oj-c/hooks/UNSAFE_useListData/useListData.js

@@ -82,6 +82,9 @@ define(["require", "exports", "ojs/ojdataproviderfactory", "preact/hooks"], func
             iteratorRef.current = iterator;
             try {
                 const result = await iterator.next();
+                if (iterator !== iteratorRef.current) {
+                    return;
+                }
                 const fetchParameters = result.value.fetchParameters;
                 if (fetchParameters.signal && fetchParameters.signal.aborted) {
                     return;
@@ -129,7 +132,7 @@ define(["require", "exports", "ojs/ojdataproviderfactory", "preact/hooks"], func
                                 isDoneRef.current = value.done;
                             }
                             const total = value.total;
-                            if (total > 0) {
+                            if (total > 0 || (total === 0 && isDoneRef.current)) {
                                 totalSizeRef.current = total;
                                 fetchRange({
                                     offset: range.offset,

package/oj-c/hooks/UNSAFE_useMergedFormContext/useMergedFormContext.js

@@ -0,0 +1,23 @@
+define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormContext"], function (require, exports, UNSAFE_useFormContext_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.useMergedFormContext = void 0;
+    function useMergedFormContext({ propContainerReadonly, propLabelWrapping, propReadonly, propUserAssistanceDensity }) {
+        const formContext = (0, UNSAFE_useFormContext_1.useFormContext)();
+        const uadValue = propUserAssistanceDensity ?? formContext.userAssistanceDensity;
+        const readonlyValue = propReadonly ?? formContext.isReadonly;
+        const { isFormLayout: formContextIsFormLayout, isReadonly: formContextIsReadonly, labelWrapping: formContextLabelWrapping, ...otherFormContextProps } = formContext;
+        const containerProps = {
+            ...otherFormContextProps,
+            isFormLayout: propContainerReadonly !== undefined || formContextIsFormLayout,
+            isReadonly: propContainerReadonly ?? formContextIsReadonly,
+            labelWrapping: propLabelWrapping ?? formContextLabelWrapping
+        };
+        return {
+            containerProps,
+            readonlyValue,
+            uadValue
+        };
+    }
+    exports.useMergedFormContext = useMergedFormContext;
+});

package/oj-c/hooks/UNSAFE_useVisBusyState/useVisBusyState.js

@@ -0,0 +1,16 @@
+define(["require", "exports", "preact/hooks", "ojs/ojcontext"], function (require, exports, hooks_1, Context) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.useVisBusyState = void 0;
+    function useVisBusyState(rootRef, baseDescription) {
+        const addBusyState = (0, hooks_1.useCallback)(() => {
+            if (rootRef.current) {
+                const busyContext = Context.getContext(rootRef.current).getBusyContext();
+                return busyContext.addBusyState({ description: baseDescription });
+            }
+            return () => { };
+        }, [baseDescription, rootRef]);
+        return addBusyState;
+    }
+    exports.useVisBusyState = useVisBusyState;
+});

package/oj-c/input-date-mask/component.json

@@ -1,7 +1,7 @@
 {
   "name": "input-date-mask",
-  "version": "16.1.3",
-  "jetVersion": "^16.1.3",
+  "version": "17.0.0",
+  "jetVersion": "^17.0.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",
@@ -13,6 +13,12 @@
   "description": "An input date mask field allows a user to individually edit, step, or spin the values of the month, day, and year fields of a calendar date.",
   "help": "oj-c.InputDateMask.html",
   "main": "oj-c/input-date-mask",
+  "status": [
+    {
+      "type": "candidate",
+      "since": "17.0.0"
+    }
+  ],
   "extension": {
     "catalog": {
       "category": "Forms"
@@ -23,7 +29,13 @@
       "minColumns": 2
     },
     "oracle": {
-      "icon": "oj-ux-ico-date"
+      "icon": "oj-ux-ico-date",
+      "uxSpecs": [
+        "input-date-mask"
+      ]
+    },
+    "webelement": {
+      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1700/cpwdtsdoc/classes/InputDateMaskWebElement.html"
     }
   },
   "propertyLayout": [
@@ -270,8 +282,7 @@
         "consume": {
           "name": "containerReadonly"
         }
-      },
-      "value": false
+      }
     },
     "required": {
       "type": "boolean",
@@ -340,8 +351,7 @@
         "consume": {
           "name": "containerUserAssistanceDensity"
         }
-      },
-      "value": "reflow"
+      }
     },
     "validators": {
       "type": "Array<object>|null",

package/oj-c/input-date-mask/input-date-mask.js

@@ -1,4 +1,4 @@
-define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/translationBundle', "@oracle/oraclejet-preact/hooks/UNSAFE_useFormContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormVariantContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useTabbableMode", "@oracle/oraclejet-preact/UNSAFE_InputDateMask", "oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText", "ojs/ojcontext", "ojs/ojvcomponent", "preact/compat", "preact/hooks", "./useInputDateMaskPreact", "@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout", "@oracle/oraclejet-preact/UNSAFE_IntlDateTime", "css!oj-c/input-date-mask/input-date-mask-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, UNSAFE_useFormContext_1, UNSAFE_useFormVariantContext_1, UNSAFE_useTabbableMode_1, UNSAFE_InputDateMask_1, useAssistiveText_1, Context, ojvcomponent_1, compat_1, hooks_1, useInputDateMaskPreact_1, Layout_1, UNSAFE_IntlDateTime_1) {
+define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/translationBundle', "@oracle/oraclejet-preact/hooks/UNSAFE_useFormContext", "oj-c/hooks/UNSAFE_useMergedFormContext/useMergedFormContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormVariantContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useTabbableMode", "@oracle/oraclejet-preact/UNSAFE_InputDateMask", "oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText", "ojs/ojcontext", "ojs/ojvcomponent", "preact/compat", "preact/hooks", "./useInputDateMaskPreact", "@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout", "@oracle/oraclejet-preact/UNSAFE_IntlDateTime", "css!oj-c/input-date-mask/input-date-mask-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, UNSAFE_useFormContext_1, useMergedFormContext_1, UNSAFE_useFormVariantContext_1, UNSAFE_useTabbableMode_1, UNSAFE_InputDateMask_1, useAssistiveText_1, Context, ojvcomponent_1, compat_1, hooks_1, useInputDateMaskPreact_1, Layout_1, UNSAFE_IntlDateTime_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.InputDateMask = void 0;
@@ -15,7 +15,7 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
     };
     const messagesCustomDefault = [];
     const validatorsDefault = [];
-    const InputDateMaskImpl = ({ columnSpan = 1, disabled = false, displayOptions = displayOptionsDefault, help = helpDefault, helpHints = helpHintsDefault, messagesCustom = messagesCustomDefault, readonly = false, required = false, userAssistanceDensity = 'reflow', validators = validatorsDefault, value = null, ...otherProps }, ref) => {
+    const InputDateMaskImpl = ({ columnSpan = 1, containerReadonly: propContainerReadonly, disabled = false, displayOptions = displayOptionsDefault, help = helpDefault, helpHints = helpHintsDefault, labelWrapping: propLabelWrapping, messagesCustom = messagesCustomDefault, readonly: propReadonly, required = false, userAssistanceDensity: propUserAssistanceDensity, validators = validatorsDefault, value = null, ...otherProps }, ref) => {
         const rootRef = (0, hooks_1.useRef)();
         const inputDateMaskRef = (0, hooks_1.useRef)();
         const addBusyState = (0, hooks_1.useCallback)((description = 'InputDateMask: busyState') => {
@@ -23,13 +23,19 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
                 ? Context.getContext(rootRef.current).getBusyContext().addBusyState({ description })
                 : () => { };
         }, []);
+        const { containerProps, uadValue, readonlyValue } = (0, useMergedFormContext_1.useMergedFormContext)({
+            propContainerReadonly,
+            propLabelWrapping,
+            propReadonly,
+            propUserAssistanceDensity
+        });
         const { inputDateMaskProps, methods } = (0, useInputDateMaskPreact_1.useInputDateMaskPreact)({
             disabled,
             displayOptions,
             messagesCustom,
-            readonly,
+            readonly: readonlyValue,
             required,
-            userAssistanceDensity,
+            userAssistanceDensity: uadValue,
             validators,
             value,
             ...otherProps
@@ -47,11 +53,6 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
             validators
         });
         const variant = (0, UNSAFE_useFormVariantContext_1.useFormVariantContext)();
-        const containerProps = {
-            isFormLayout: otherProps.containerReadonly !== undefined,
-            isReadonly: otherProps.containerReadonly,
-            labelWrapping: otherProps.labelWrapping
-        };
         if (!UNSAFE_IntlDateTime_1.DateTimeUtils.isDateOnlyIsoString(value)) {
             throw new Error('value must be a date-only ISO string');
         }
@@ -63,7 +64,7 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
         }
         return ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, { id: otherProps.id, ref: rootRef, class: Layout_1.layoutSpanStyles.layoutSpanColumn[columnSpan], children: (0, jsx_runtime_1.jsx)(UNSAFE_useFormContext_1.FormContext.Provider, { value: containerProps, children: (0, jsx_runtime_1.jsx)(UNSAFE_InputDateMask_1.InputDateMask, { ref: inputDateMaskRef, ...assistiveTextProps, ...inputDateMaskProps, variant: variant }) }) }));
     };
-    exports.InputDateMask = (0, ojvcomponent_1.registerCustomElement)('oj-c-input-date-mask', (0, compat_1.forwardRef)(InputDateMaskImpl), "InputDateMask", { "properties": { "columnSpan": { "type": "number" }, "containerReadonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "dateRangeOverflowMessageDetail": { "type": "string" }, "dateRangeUnderflowMessageDetail": { "type": "string" }, "disabled": { "type": "boolean" }, "displayOptions": { "type": "object", "properties": { "messages": { "type": "string", "enumValues": ["none", "display"] }, "validatorHint": { "type": "string", "enumValues": ["none", "display"] } } }, "help": { "type": "object", "properties": { "instruction": { "type": "string" } } }, "helpHints": { "type": "object", "properties": { "definition": { "type": "string" }, "source": { "type": "string" }, "sourceText": { "type": "string" } } }, "labelEdge": { "type": "string", "enumValues": ["none", "start", "top", "inside"], "binding": { "consume": { "name": "containerLabelEdge" } } }, "labelHint": { "type": "string" }, "labelStartWidth": { "type": "number|string", "binding": { "consume": { "name": "labelWidth" } } }, "labelWrapping": { "type": "string", "enumValues": ["truncate", "wrap"], "binding": { "consume": { "name": "labelWrapping" } } }, "max": { "type": "string|null" }, "messagesCustom": { "type": "Array<object>", "writeback": true }, "min": { "type": "string|null" }, "readonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "required": { "type": "boolean" }, "requiredMessageDetail": { "type": "string" }, "textAlign": { "type": "string", "enumValues": ["end", "start", "right"] }, "userAssistanceDensity": { "type": "string", "enumValues": ["compact", "reflow", "efficient"], "binding": { "consume": { "name": "containerUserAssistanceDensity" } } }, "validators": { "type": "Array<object>|null" }, "value": { "type": "string|null", "writeback": true }, "rawValue": { "type": "object", "properties": { "year": { "type": "number" }, "month": { "type": "number" }, "day": { "type": "number" } }, "readOnly": true, "writeback": true }, "valid": { "type": "string", "enumValues": ["pending", "valid", "invalidHidden", "invalidShown"], "readOnly": true, "writeback": true } }, "extension": { "_WRITEBACK_PROPS": ["messagesCustom", "rawValue", "valid", "value"], "_READ_ONLY_PROPS": ["rawValue", "valid"], "_OBSERVED_GLOBAL_PROPS": ["aria-describedby", "id"] }, "methods": { "blur": {}, "focus": {}, "showMessages": {}, "reset": {}, "validate": {} } }, { "columnSpan": 1, "disabled": false, "displayOptions": { "messages": "display", "validatorHint": "display" }, "help": { "instruction": "" }, "helpHints": { "definition": "", "source": "" }, "messagesCustom": [], "readonly": false, "required": false, "userAssistanceDensity": "reflow", "validators": [], "value": null }, {
+    exports.InputDateMask = (0, ojvcomponent_1.registerCustomElement)('oj-c-input-date-mask', (0, compat_1.forwardRef)(InputDateMaskImpl), "InputDateMask", { "properties": { "columnSpan": { "type": "number" }, "containerReadonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "dateRangeOverflowMessageDetail": { "type": "string" }, "dateRangeUnderflowMessageDetail": { "type": "string" }, "disabled": { "type": "boolean" }, "displayOptions": { "type": "object", "properties": { "messages": { "type": "string", "enumValues": ["none", "display"] }, "validatorHint": { "type": "string", "enumValues": ["none", "display"] } } }, "help": { "type": "object", "properties": { "instruction": { "type": "string" } } }, "helpHints": { "type": "object", "properties": { "definition": { "type": "string" }, "source": { "type": "string" }, "sourceText": { "type": "string" } } }, "labelEdge": { "type": "string", "enumValues": ["none", "start", "top", "inside"], "binding": { "consume": { "name": "containerLabelEdge" } } }, "labelHint": { "type": "string" }, "labelStartWidth": { "type": "number|string", "binding": { "consume": { "name": "labelWidth" } } }, "labelWrapping": { "type": "string", "enumValues": ["truncate", "wrap"], "binding": { "consume": { "name": "labelWrapping" } } }, "max": { "type": "string|null" }, "messagesCustom": { "type": "Array<object>", "writeback": true }, "min": { "type": "string|null" }, "readonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "required": { "type": "boolean" }, "requiredMessageDetail": { "type": "string" }, "textAlign": { "type": "string", "enumValues": ["end", "start", "right"] }, "userAssistanceDensity": { "type": "string", "enumValues": ["compact", "reflow", "efficient"], "binding": { "consume": { "name": "containerUserAssistanceDensity" } } }, "validators": { "type": "Array<object>|null" }, "value": { "type": "string|null", "writeback": true }, "rawValue": { "type": "object", "properties": { "year": { "type": "number" }, "month": { "type": "number" }, "day": { "type": "number" } }, "readOnly": true, "writeback": true }, "valid": { "type": "string", "enumValues": ["pending", "valid", "invalidHidden", "invalidShown"], "readOnly": true, "writeback": true } }, "extension": { "_WRITEBACK_PROPS": ["messagesCustom", "rawValue", "valid", "value"], "_READ_ONLY_PROPS": ["rawValue", "valid"], "_OBSERVED_GLOBAL_PROPS": ["aria-describedby", "id"] }, "methods": { "blur": {}, "focus": {}, "showMessages": {}, "reset": {}, "validate": {} } }, { "columnSpan": 1, "disabled": false, "displayOptions": { "messages": "display", "validatorHint": "display" }, "help": { "instruction": "" }, "helpHints": { "definition": "", "source": "" }, "messagesCustom": [], "required": false, "validators": [], "value": null }, {
         '@oracle/oraclejet-preact': translationBundle_1.default
     }, { consume: [UNSAFE_useFormVariantContext_1.FormVariantContext, UNSAFE_useTabbableMode_1.TabbableModeContext] });
 });

package/oj-c/input-date-mask/useInputDateMaskPreact.js

@@ -1,14 +1,14 @@
-define(["require", "exports", "oj-c/editable-value/UNSAFE_useEditableValueRawValueObject/useEditableValueRawValueObject", "./CalendarDateConverter", "preact/hooks", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslationBundle", "ojs/ojconverter-preferences", "@oracle/oraclejet-preact/utils/UNSAFE_calendarDateUtils", "oj-c/input-date-text/useImplicitDateRangeValidator", "ojs/ojconfig", "oj-c/editable-value/utils/utils"], function (require, exports, useEditableValueRawValueObject_1, CalendarDateConverter_1, hooks_1, UNSAFE_useTranslationBundle_1, ojconverter_preferences_1, UNSAFE_calendarDateUtils_1, useImplicitDateRangeValidator_1, ojconfig_1, utils_1) {
+define(["require", "exports", "./CalendarDateConverter", "preact/hooks", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslationBundle", "ojs/ojconverter-preferences", "@oracle/oraclejet-preact/utils/UNSAFE_calendarDateUtils", "oj-c/input-date-text/useImplicitDateRangeValidator", "ojs/ojconfig", "oj-c/editable-value/utils/utils", "oj-c/hooks/UNSAFE_useEditableValue/useEditableValue", "oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators"], function (require, exports, CalendarDateConverter_1, hooks_1, UNSAFE_useTranslationBundle_1, ojconverter_preferences_1, UNSAFE_calendarDateUtils_1, useImplicitDateRangeValidator_1, ojconfig_1, utils_1, useEditableValue_1, useDeferredValidators_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.useInputDateMaskPreact = void 0;
+    exports.getMasksFromDatePatternPreferences = exports.useInputDateMaskPreact = void 0;
     function useInputDateMaskPreact({ dateRangeOverflowMessageDetail, dateRangeUnderflowMessageDetail, disabled, displayOptions, labelEdge, labelHint, labelStartWidth, max, messagesCustom, min, readonly, required, requiredMessageDetail, textAlign, userAssistanceDensity, validators, value: propValue, onMessagesCustomChanged, onRawValueChanged, onValidChanged, onValueChanged, ...otherProps }, addBusyState) {
         const minTreatNull = (0, utils_1.treatNull)(min);
         const maxTreatNull = (0, utils_1.treatNull)(max);
         const translations = (0, UNSAFE_useTranslationBundle_1.useTranslationBundle)('@oracle/oraclejet-preact');
         const calendarDateConverter_parseErrorFn = translations.calendarDateConverter_parseError;
         const masksFromUserPref = (0, hooks_1.useMemo)(() => {
-            return getMasksFromDatePatternPreferences();
+            return (0, exports.getMasksFromDatePatternPreferences)();
         }, []);
         const implicitConverter = (0, hooks_1.useMemo)(() => {
             return new CalendarDateConverter_1.CalendarDateConverter({
@@ -30,29 +30,35 @@ define(["require", "exports", "oj-c/editable-value/UNSAFE_useEditableValueRawVal
             max: maxTreatNull,
             min: minTreatNull
         });
-        const { methods, textFieldProps, value, setValue } = (0, useEditableValueRawValueObject_1.useEditableValueRawValueObject)({
+        const combinedValidators = (0, hooks_1.useMemo)(() => {
+            const v1 = implicitComponentValidator ? [implicitComponentValidator] : [];
+            const v2 = validators ? validators : [];
+            return [...v1, ...v2];
+        }, [implicitComponentValidator, validators]);
+        const deferredValidators = (0, useDeferredValidators_1.useDeferredValidators)({
+            labelHint,
+            required,
+            requiredMessageDetail
+        });
+        const { methods, textFieldProps, value } = (0, useEditableValue_1.useEditableValue)({
+            addBusyState,
             ariaDescribedBy: otherProps['aria-describedby'],
             converter: implicitConverter,
+            defaultDisplayValue: undefined,
+            deferredValidators,
             disabled,
             displayOptions,
-            implicitComponentValidator,
-            labelHint,
             messagesCustom,
-            readonly,
-            required,
-            requiredMessageDetail,
-            validators,
-            value: propValue,
-            addBusyState,
             onMessagesCustomChanged,
             onRawValueChanged,
             onValidChanged,
-            onValueChanged
+            onValueChanged,
+            readonly,
+            validators: combinedValidators,
+            value: propValue
         });
         const hasNoValue = value === undefined || !isPartialDate(textFieldProps.value);
         return {
-            value,
-            setValue,
             methods,
             inputDateMaskProps: {
                 isDisabled: disabled,
@@ -83,4 +89,5 @@ define(["require", "exports", "oj-c/editable-value/UNSAFE_useEditableValueRawVal
         }
         return (0, UNSAFE_calendarDateUtils_1.getDatePlaceholdersFromPattern)(pattern);
     };
+    exports.getMasksFromDatePatternPreferences = getMasksFromDatePatternPreferences;
 });

package/oj-c/input-date-mask.js

@@ -1,4 +1,4 @@
-define(["require", "exports", "./input-date-mask/input-date-mask"], function (require, exports, input_date_mask_1) {
+define(["require", "exports", "oj-c/input-date-mask/input-date-mask"], function (require, exports, input_date_mask_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.InputDateMask = void 0;

package/oj-c/input-date-picker/DateRangeValidator.js

@@ -0,0 +1,53 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+define(["require", "exports", "./utils"], function (require, exports, utils_1) {
+    "use strict";
+    var _DateRangeValidator_instances, _DateRangeValidator_getOverflowErrorDetail, _DateRangeValidator_getUnderflowErrorDetail;
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.DateRangeValidator = void 0;
+    class DateRangeValidator {
+        constructor(options) {
+            _DateRangeValidator_instances.add(this);
+            if (options.min && options.max && (0, utils_1.compareCalendarDates)(options.min, options.max) > 0) {
+                throw new Error('min must be less than max');
+            }
+            this.options = options;
+        }
+        validate(value) {
+            if (value === null)
+                return;
+            const { converter, max, min } = this.options;
+            const valueCalendarDate = converter.format(value);
+            (0, utils_1.assertCompleteDate)(valueCalendarDate);
+            if (max && (0, utils_1.compareCalendarDates)(valueCalendarDate, max) > 0) {
+                throw new Error(__classPrivateFieldGet(this, _DateRangeValidator_instances, "m", _DateRangeValidator_getOverflowErrorDetail).call(this, value, max));
+            }
+            if (min && (0, utils_1.compareCalendarDates)(valueCalendarDate, min) < 0) {
+                throw new Error(__classPrivateFieldGet(this, _DateRangeValidator_instances, "m", _DateRangeValidator_getUnderflowErrorDetail).call(this, value, min));
+            }
+        }
+    }
+    exports.DateRangeValidator = DateRangeValidator;
+    _DateRangeValidator_instances = new WeakSet(), _DateRangeValidator_getOverflowErrorDetail = function _DateRangeValidator_getOverflowErrorDetail(value, max) {
+        const { converter, dateRangeOverflowMessageDetail, defaultRangeOverflowMessageDetailFn, formatObj } = this.options;
+        const isoMax = converter.parse(max);
+        const maxString = formatObj.format(isoMax);
+        if (dateRangeOverflowMessageDetail) {
+            const valueString = formatObj.format(value);
+            return dateRangeOverflowMessageDetail({ value: valueString, max: maxString });
+        }
+        return defaultRangeOverflowMessageDetailFn({ max: maxString });
+    }, _DateRangeValidator_getUnderflowErrorDetail = function _DateRangeValidator_getUnderflowErrorDetail(value, min) {
+        const { converter, dateRangeUnderflowMessageDetail, defaultRangeUnderflowMessageDetailFn, formatObj } = this.options;
+        const isoMin = converter.parse(min);
+        const minString = formatObj.format(isoMin);
+        if (dateRangeUnderflowMessageDetail) {
+            const valueString = formatObj.format(value);
+            return dateRangeUnderflowMessageDetail({ value: valueString, min: minString });
+        }
+        return defaultRangeUnderflowMessageDetailFn({ min: minString });
+    };
+});

package/oj-c/input-date-picker/DateRestrictionValidator.js

@@ -0,0 +1,35 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+define(["require", "exports", "./utils"], function (require, exports, utils_1) {
+    "use strict";
+    var _DateRestrictionValidator_instances, _DateRestrictionValidator_getErrorDetail, _DateRestrictionValidator_getDayState;
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.DateRestrictionValidator = void 0;
+    class DateRestrictionValidator {
+        constructor(options) {
+            _DateRestrictionValidator_instances.add(this);
+            this.options = options;
+        }
+        validate(value) {
+            if (value == null)
+                return;
+            const valueCalendarDate = this.options.converter.format(value);
+            const { state } = __classPrivateFieldGet(this, _DateRestrictionValidator_instances, "m", _DateRestrictionValidator_getDayState).call(this, valueCalendarDate);
+            if (state === 'enabled')
+                return;
+            throw new Error(__classPrivateFieldGet(this, _DateRestrictionValidator_instances, "m", _DateRestrictionValidator_getErrorDetail).call(this, value, state));
+        }
+    }
+    exports.DateRestrictionValidator = DateRestrictionValidator;
+    _DateRestrictionValidator_instances = new WeakSet(), _DateRestrictionValidator_getErrorDetail = function _DateRestrictionValidator_getErrorDetail(value, state) {
+        if (this.options.dateRestrictionMessageDetail)
+            return this.options.dateRestrictionMessageDetail({ state, value });
+        return this.options.defaultRestrictionMessageDetail();
+    }, _DateRestrictionValidator_getDayState = function _DateRestrictionValidator_getDayState(date) {
+        (0, utils_1.assertCompleteDate)(date);
+        return this.options.dayFormatter(date);
+    };
+});

package/oj-c/input-date-picker/__webdriver__/InputDatePickerWebElement.d.ts

@@ -0,0 +1,17 @@
+import { InputDatePickerWebElementBase } from './InputDatePickerWebElementBase';
+/**
+ * The component WebElement for [oj-c-input-date-picker](../../../oj-c/docs/oj.InputDatePicker.html).
+ * Do not instantiate this class directly, instead, use
+ * [findInputDatePicker](../functions/findInputDatePicker.html).
+ */
+export declare class InputDatePickerWebElement extends InputDatePickerWebElementBase {
+    /**
+     * Sets the value of the "value" property of the input component.
+     * @param value The value to set for the <code>value</code>
+     */
+    changeValue(value: string | null): Promise<void>;
+    /**
+     * Clears the value of the component.
+     */
+    clear(): Promise<void>;
+}

package/oj-c/input-date-picker/__webdriver__/InputDatePickerWebElement.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputDatePickerWebElement = void 0;
+var InputDatePickerWebElementBase_1 = require("./InputDatePickerWebElementBase");
+var selenium_webdriver_1 = require("selenium-webdriver");
+var UNSAFE_IntlDateTime_1 = require("@oracle/oraclejet-preact/UNSAFE_IntlDateTime");
+/**
+ * The component WebElement for [oj-c-input-date-picker](../../../oj-c/docs/oj.InputDatePicker.html).
+ * Do not instantiate this class directly, instead, use
+ * [findInputDatePicker](../functions/findInputDatePicker.html).
+ */
+class InputDatePickerWebElement extends InputDatePickerWebElementBase_1.InputDatePickerWebElementBase {
+    /**
+     * Sets the value of the "value" property of the input component.
+     * @param value The value to set for the <code>value</code>
+     */
+    async changeValue(value) {
+        if (!UNSAFE_IntlDateTime_1.DateTimeUtils.isDateOnlyIsoString(value)) {
+            throw new Error(`InputDatePickerWebElement - value must be a date-only ISO string: ${value}`);
+        }
+        await this.getDriver().executeScript('arguments[0].focus()', this);
+        const readonly = await this.getReadonly();
+        const disabled = await this.getDisabled();
+        if (!(disabled || readonly)) {
+            await this.whenBusyContextReady();
+            const segments = await this.findElements(selenium_webdriver_1.By.css('[role="spinbutton"]'));
+            if (!value) {
+                // Delete the text in each of the mask segments.
+                for (const segment of segments) {
+                    await segment.click();
+                    await segment.sendKeys(selenium_webdriver_1.Key.BACK_SPACE);
+                    await this.whenBusyContextReady();
+                }
+            }
+            else {
+                // Enter text in each of the mask segments.
+                const tokenizedValue = value.split('-');
+                if (segments.length === 3 && tokenizedValue.length === 3) {
+                    for (const segment of segments) {
+                        await segment.click();
+                        const dataSegment = await segment.getAttribute('data-segment');
+                        const segmentValue = dataSegment === 'month'
+                            ? tokenizedValue[1]
+                            : dataSegment === 'year'
+                                ? tokenizedValue[0]
+                                : tokenizedValue[2];
+                        await segment.sendKeys(selenium_webdriver_1.Key.BACK_SPACE);
+                        await this.whenBusyContextReady();
+                        // send the keys one at a time, because otherwise the year segment only seems to
+                        // end up with the last two digits of the year
+                        for (let i = 0; i < segmentValue.length; i++) {
+                            await segment.sendKeys(segmentValue.charAt(i));
+                            await this.whenBusyContextReady();
+                        }
+                    }
+                }
+            }
+            // Commit the new value.
+            if (segments.length > 0) {
+                await segments[segments.length - 1].sendKeys(selenium_webdriver_1.Key.ENTER);
+            }
+        }
+        return this.whenBusyContextReady();
+    }
+    /**
+     * Clears the value of the component.
+     */
+    clear() {
+        return this.changeValue(null);
+    }
+}
+exports.InputDatePickerWebElement = InputDatePickerWebElement;
+//# sourceMappingURL=InputDatePickerWebElement.js.map

package/oj-c/input-date-picker/__webdriver__/InputDatePickerWebElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputDatePickerWebElement.js","sourceRoot":"","sources":["InputDatePickerWebElement.ts"],"names":[],"mappings":"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","sourcesContent":["import { InputDatePickerWebElementBase } from './InputDatePickerWebElementBase';\nimport { By, Key } from 'selenium-webdriver';\nimport { DateTimeUtils } from '@oracle/oraclejet-preact/UNSAFE_IntlDateTime';\n\n/**\n * The component WebElement for [oj-c-input-date-picker](../../../oj-c/docs/oj.InputDatePicker.html).\n * Do not instantiate this class directly, instead, use\n * [findInputDatePicker](../functions/findInputDatePicker.html).\n */\nexport class InputDatePickerWebElement extends InputDatePickerWebElementBase {\n  /**\n   * Sets the value of the \"value\" property of the input component.\n   * @param value The value to set for the <code>value</code>\n   */\n  public async changeValue(value: string | null): Promise<void> {\n    if (!DateTimeUtils.isDateOnlyIsoString(value)) {\n      throw new Error(`InputDatePickerWebElement - value must be a date-only ISO string: ${value}`);\n    }\n\n    await this.getDriver().executeScript('arguments[0].focus()', this);\n    const readonly = await this.getReadonly();\n    const disabled = await this.getDisabled();\n    if (!(disabled || readonly)) {\n      await this.whenBusyContextReady();\n\n      const segments = await this.findElements(By.css('[role=\"spinbutton\"]'));\n\n      if (!value) {\n        // Delete the text in each of the mask segments.\n        for (const segment of segments) {\n          await segment.click();\n          await segment.sendKeys(Key.BACK_SPACE);\n          await this.whenBusyContextReady();\n        }\n      } else {\n        // Enter text in each of the mask segments.\n        const tokenizedValue = value.split('-');\n        if (segments.length === 3 && tokenizedValue.length === 3) {\n          for (const segment of segments) {\n            await segment.click();\n            const dataSegment = await segment.getAttribute('data-segment');\n            const segmentValue =\n              dataSegment === 'month'\n                ? tokenizedValue[1]\n                : dataSegment === 'year'\n                ? tokenizedValue[0]\n                : tokenizedValue[2];\n            await segment.sendKeys(Key.BACK_SPACE);\n            await this.whenBusyContextReady();\n            // send the keys one at a time, because otherwise the year segment only seems to\n            // end up with the last two digits of the year\n            for (let i = 0; i < segmentValue.length; i++) {\n              await segment.sendKeys(segmentValue.charAt(i));\n              await this.whenBusyContextReady();\n            }\n          }\n        }\n      }\n      // Commit the new value.\n      if (segments.length > 0) {\n        await segments[segments.length - 1].sendKeys(Key.ENTER);\n      }\n    }\n\n    return this.whenBusyContextReady();\n  }\n\n  /**\n   * Clears the value of the component.\n   */\n  clear(): Promise<void> {\n    return this.changeValue(null);\n  }\n}\n"]}