@oracle/oraclejet-core-pack 17.1.4 → 18.0.1

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

@@ -1,9 +1,8 @@
 define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj-c/editable-value/UNSAFE_useStaleIdentity/useStaleIdentity", "./reducer", "./validationUtils"], function (require, exports, hooks_1, converterUtils_1, utils_1, useStaleIdentity_1, reducer_1, validationUtils_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.useEditableValue = void 0;
-    const ConverterErrorSymbol = Symbol('ConverterError');
-    function useEditableValue({ addBusyState, ariaDescribedBy, converter, defaultDisplayValue, deferredValidators, disabled, displayOptions, messagesCustom, onMessagesCustomChanged, onRawValueChanged, onValidChanged, onValueChanged, readonly, validators, value }) {
+    exports.useEditableValue = useEditableValue;
+    function useEditableValue({ addBusyState, ariaDescribedBy, converter, defaultDisplayValue, deferredValidators, disabled, displayOptions, messagesCustom, onDisplayValueChanged, onMessagesCustomChanged, onRawValueChanged, onTransientValueChanged, onValidChanged: propOnValidChanged, onValueChanged, translateConverterParseError, readonly, validators, value }) {
         const initialRender = (0, hooks_1.useRef)(true);
         const { setStaleIdentity } = (0, useStaleIdentity_1.useStaleIdentity)();
         const [state, dispatch] = (0, hooks_1.useReducer)((reducer_1.reducer), {
@@ -22,15 +21,30 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
                 displayValue: conversion.result === 'success' ? conversion.value : defaultDisplayValue
             };
         });
+        const currentValidRef = (0, hooks_1.useRef)();
+        const onValidChanged = (0, hooks_1.useCallback)((newValid) => {
+            if (newValid !== currentValidRef.current) {
+                currentValidRef.current = newValid;
+                propOnValidChanged?.(newValid);
+            }
+        }, [propOnValidChanged]);
         const _dispatch = (0, hooks_1.useCallback)((updateFn, payload) => {
             updateFn(dispatch, payload, {
                 onMessagesCustomChanged,
                 onRawValueChanged,
+                onTransientValueChanged,
                 onValidChanged,
                 onValueChanged
             });
             return true;
-        }, [dispatch, onMessagesCustomChanged, onRawValueChanged, onValidChanged, onValueChanged]);
+        }, [
+            dispatch,
+            onMessagesCustomChanged,
+            onRawValueChanged,
+            onTransientValueChanged,
+            onValidChanged,
+            onValueChanged
+        ]);
         const validateDeferredSync = (0, hooks_1.useCallback)((value) => {
             const valueToSendToDeferredValidation = typeof value === 'string' ? value.trim() : value;
             const deferredValidate = (0, validationUtils_1.validateSync)({
@@ -39,7 +53,16 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             });
             return deferredValidate;
         }, [deferredValidators]);
-        const refreshDisplayValue = (0, hooks_1.useCallback)((value) => {
+        const setValue = (0, hooks_1.useCallback)((value) => {
+            _dispatch(reducer_1.updateValue, value);
+        }, [_dispatch]);
+        const setDisplayValue = (0, hooks_1.useCallback)((value) => {
+            _dispatch(reducer_1.updateDisplayValue, value);
+        }, [_dispatch]);
+        const setTransientValue = (0, hooks_1.useCallback)((transientValue) => {
+            _dispatch(reducer_1.updateTransientValue, transientValue);
+        }, [_dispatch]);
+        const formatValue = (0, hooks_1.useCallback)((value) => {
             let newDisplayValue;
             if (!converter) {
                 newDisplayValue = (0, utils_1.treatNull)(value, defaultDisplayValue);
@@ -55,38 +78,43 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
                     newDisplayValue = conversion.value;
                 }
             }
+            return newDisplayValue;
+        }, [converter, defaultDisplayValue, _dispatch]);
+        const refreshDisplayValue = (0, hooks_1.useCallback)((value) => {
+            const newDisplayValue = formatValue(value);
             _dispatch(reducer_1.updateDisplayValue, newDisplayValue);
+            onDisplayValueChanged?.();
             return true;
-        }, [converter, _dispatch, defaultDisplayValue]);
+        }, [_dispatch, formatValue, onDisplayValueChanged]);
         const getValueForValidation = (0, hooks_1.useCallback)(() => {
             if (state.valid !== 'invalidShown') {
-                return state.value;
+                return { result: 'success', value: state.value };
             }
             if (!converter) {
-                return (0, utils_1.normalizeValue)(state.displayValue);
+                return { result: 'success', value: (0, utils_1.normalizeValue)(state.displayValue) };
             }
-            const conversion = (0, converterUtils_1.parse)((0, utils_1.normalizeValue)(state.displayValue), converter);
-            if (conversion.result === 'failure') {
-                _dispatch(reducer_1.updateComponentMessages, [conversion.error]);
-                _dispatch(reducer_1.updateValidStatus, 'invalidShown');
-                return ConverterErrorSymbol;
-            }
-            return conversion.value;
-        }, [converter, _dispatch, state.displayValue, state.valid, state.value]);
+            return (0, converterUtils_1.parse)((0, utils_1.normalizeValue)(state.displayValue), converter, translateConverterParseError);
+        }, [converter, state.displayValue, state.valid, state.value, translateConverterParseError]);
         const normalizeAndParseValue = (0, hooks_1.useCallback)((value) => {
             if (!converter) {
-                return (0, utils_1.normalizeValue)(value);
+                return {
+                    result: 'success',
+                    value: (0, utils_1.normalizeValue)(value)
+                };
             }
-            const conversion = (0, converterUtils_1.parse)((0, utils_1.normalizeValue)(value), converter);
-            conversion.result === 'failure' &&
-                _dispatch(reducer_1.updateComponentMessages, [conversion.error]) &&
+            return (0, converterUtils_1.parse)((0, utils_1.normalizeValue)(value), converter, translateConverterParseError);
+        }, [converter, translateConverterParseError]);
+        const parseValue = (0, hooks_1.useCallback)((value) => {
+            const conversion = normalizeAndParseValue(value);
+            if (conversion.result === 'failure') {
+                _dispatch(reducer_1.updateComponentMessages, [conversion.error]);
                 _dispatch(reducer_1.updateValidStatus, 'invalidShown');
-            return conversion.result === 'success' ? conversion.value : ConverterErrorSymbol;
-        }, [converter, _dispatch]);
+            }
+            return conversion;
+        }, [_dispatch, normalizeAndParseValue]);
         const fullValidate = (0, hooks_1.useCallback)(async (value, options = {}) => {
             const { doNotClearMessagesCustom = false } = options;
             const hasCustomErrorMessages = doNotClearMessagesCustom && (0, utils_1.hasErrorMessages)(messagesCustom);
-            _dispatch(reducer_1.updateValidStatus, 'pending');
             if (doNotClearMessagesCustom) {
                 _dispatch(reducer_1.updateComponentMessages, []);
                 _dispatch(reducer_1.updateHiddenMessages, []);
@@ -119,6 +147,7 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             if (!maybeErrorPromises.length) {
                 return !hasSyncError;
             }
+            !hasSyncError && _dispatch(reducer_1.updateValidStatus, 'pending');
             const resolver = addBusyState?.('running asynchronous validation');
             const { isStale } = setStaleIdentity('useEditableValue-full-validate');
             let hasAsyncError = false;
@@ -151,15 +180,25 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
         const runFullValidationAndUpdateValue = async () => {
             if (disabled || readonly)
                 return;
-            const parsedValueOrSymbol = getValueForValidation();
-            if (parsedValueOrSymbol === ConverterErrorSymbol)
+            const conversion = getValueForValidation();
+            if (conversion.result === 'failure') {
+                _dispatch(reducer_1.updateComponentMessages, [conversion.error]);
+                _dispatch(reducer_1.updateValidStatus, 'invalidShown');
                 return;
-            const newValue = parsedValueOrSymbol;
+            }
+            const newValue = conversion.value;
             const validated = await validateValueOnInternalChange(newValue, {
                 doNotClearMessagesCustom: true
             });
             validated && _dispatch(reducer_1.updateValue, newValue) && refreshDisplayValue(newValue);
         };
+        const validateValueOnExternalChange = (0, hooks_1.useCallback)((value) => {
+            _dispatch(reducer_1.clearAllMessages);
+            const validated = validateDeferredSync(value);
+            validated.result === 'failure' && _dispatch(reducer_1.updateHiddenMessages, validated.errors);
+            _dispatch(reducer_1.updateValidStatus, validated.result === 'failure' ? 'invalidHidden' : 'valid');
+            return true;
+        }, [_dispatch, validateDeferredSync]);
         const validateValueOnInternalChange = (0, hooks_1.useCallback)(async (value, options = {}) => {
             const { isStale } = setStaleIdentity('useEditableValue-validateValueOnInternalChange');
             const resolver = addBusyState?.('Running validateValueOnInternalChange');
@@ -176,15 +215,15 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             return validated;
         }, [_dispatch, validateValueOnInternalChange]);
         const onCommit = (0, hooks_1.useCallback)(async ({ value }) => {
-            const parsedValueOrSymbol = normalizeAndParseValue(value);
-            if (parsedValueOrSymbol === ConverterErrorSymbol) {
+            const conversion = parseValue(value);
+            if (conversion.result === 'failure') {
                 return false;
             }
-            const parsedValue = parsedValueOrSymbol;
+            const parsedValue = conversion.value;
             const succeeded = await onCommitValue(parsedValue);
             succeeded && refreshDisplayValue(parsedValue);
             return succeeded;
-        }, [onCommitValue, normalizeAndParseValue, refreshDisplayValue]);
+        }, [onCommitValue, parseValue, refreshDisplayValue]);
         const onInput = (0, hooks_1.useCallback)(({ value }) => {
             _dispatch(reducer_1.updateDisplayValue, value ?? defaultDisplayValue);
         }, [_dispatch, defaultDisplayValue]);
@@ -192,11 +231,11 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             if (readonly || disabled) {
                 return 'valid';
             }
-            const newValueOrSymbol = normalizeAndParseValue(state.displayValue);
-            if (newValueOrSymbol === ConverterErrorSymbol) {
+            const conversion = parseValue(state.displayValue);
+            if (conversion.result === 'failure') {
                 return 'invalid';
             }
-            const newValue = newValueOrSymbol;
+            const newValue = conversion.value;
             const resolver = addBusyState?.('Running component method validate');
             const validated = await fullValidate(newValue);
             resolver?.();
@@ -213,20 +252,16 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             disabled,
             _dispatch,
             fullValidate,
-            normalizeAndParseValue,
+            parseValue,
             readonly,
             refreshDisplayValue,
             state.displayValue,
             state.value
         ]);
         const reset = (0, hooks_1.useCallback)(() => {
-            _dispatch(reducer_1.clearAllMessages);
-            const valueToValidate = state.value;
-            const validated = validateDeferredSync(valueToValidate);
-            validated.result === 'failure' && _dispatch(reducer_1.updateHiddenMessages, validated.errors);
-            _dispatch(reducer_1.updateValidStatus, validated.result === 'failure' ? 'invalidHidden' : 'valid');
+            validateValueOnExternalChange(state.value);
             refreshDisplayValue(state.value);
-        }, [_dispatch, refreshDisplayValue, state.value, validateDeferredSync]);
+        }, [refreshDisplayValue, state.value, validateValueOnExternalChange]);
         const showMessages = (0, hooks_1.useCallback)(() => {
             if (state.hiddenMessages && state.hiddenMessages.length > 0) {
                 _dispatch(reducer_1.showHiddenMessages);
@@ -236,12 +271,7 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
         if (!initialRender.current && state.previousValue !== value) {
             _dispatch(reducer_1.updatePreviousValue, value);
             if (value !== state.value) {
-                _dispatch(reducer_1.clearAllMessages);
-                const validated = validateDeferredSync(value);
-                validated.result === 'success' && _dispatch(reducer_1.updateValidStatus, 'valid');
-                validated.result === 'failure' &&
-                    _dispatch(reducer_1.updateValidStatus, 'invalidHidden') &&
-                    _dispatch(reducer_1.updateHiddenMessages, validated.errors);
+                validateValueOnExternalChange(value);
                 _dispatch(reducer_1.updateValue, value);
                 refreshDisplayValue(value);
             }
@@ -286,9 +316,13 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             if (isRequiredToggledToFalse || (!readonly && !disabled)) {
                 switch (state.valid) {
                     case 'valid':
-                        const newValue = getValueForValidation();
-                        if (newValue !== ConverterErrorSymbol) {
-                            const deferredValidate = validateDeferredSync(newValue);
+                        const conversion = getValueForValidation();
+                        if (conversion.result === 'failure') {
+                            _dispatch(reducer_1.updateComponentMessages, [conversion.error]);
+                            _dispatch(reducer_1.updateValidStatus, 'invalidShown');
+                        }
+                        else {
+                            const deferredValidate = validateDeferredSync(conversion.value);
                             deferredValidate.result === 'failure' &&
                                 _dispatch(reducer_1.updateHiddenMessages, deferredValidate.errors) &&
                                 _dispatch(reducer_1.updateValidStatus, 'invalidHidden');
@@ -317,6 +351,7 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
             _dispatch(reducer_1.updatePreviousDisabled, disabled);
             _dispatch(reducer_1.updatePreviousReadonly, readonly);
             _dispatch(reducer_1.updateCustomMessages, messagesCustom);
+            _dispatch(reducer_1.updateTransientValue, value);
             if (!disabled && !readonly) {
                 const validated = validateDeferredSync(value);
                 validated.result === 'failure' &&
@@ -334,21 +369,26 @@ define(["require", "exports", "preact/hooks", "./converterUtils", "./utils", "oj
         return {
             value: state.value,
             displayValue: state.displayValue,
+            formatValue,
             methods: {
                 reset,
                 showMessages,
                 validate
             },
             onCommitValue,
+            parseValue,
             refreshDisplayValue,
+            setDisplayValue,
+            setTransientValue,
+            setValue,
             textFieldProps: {
                 'aria-describedby': ariaDescribedBy,
                 messages: displayOptions?.messages !== 'none' ? state.shownMessages : undefined,
                 onCommit,
                 onInput,
                 value: state.displayValue
-            }
+            },
+            validateValueOnExternalChange
         };
     }
-    exports.useEditableValue = useEditableValue;
 });

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

@@ -1,7 +1,7 @@
 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;
+    exports.treatNull = exports.normalizeValue = exports.isShallowEqual = exports.hasErrorMessages = exports.getVirtualKeyboardHintFromConverter = exports.createMessageFromError = void 0;
     const createMessageFromError = (error) => {
         if (typeof error.getMessage === 'function') {
             return {
@@ -32,4 +32,16 @@ define(["require", "exports"], function (require, exports) {
         return !!messages && messages.some((message) => message.severity === 'error');
     };
     exports.hasErrorMessages = hasErrorMessages;
+    const getVirtualKeyboardHintFromConverter = (converter) => {
+        let virtualKeyboardHint;
+        if (converter && converter.resolvedOptions) {
+            const resOptions = converter.resolvedOptions();
+            virtualKeyboardHint = resOptions?.virtualKeyboardHint ?? 'text';
+        }
+        else {
+            virtualKeyboardHint = 'text';
+        }
+        return virtualKeyboardHint;
+    };
+    exports.getVirtualKeyboardHintFromConverter = getVirtualKeyboardHintFromConverter;
 });

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

@@ -1,7 +1,8 @@
 define(["require", "exports", "./utils"], function (require, exports, utils_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.validateSync = exports.validateAsync = void 0;
+    exports.validateAsync = validateAsync;
+    exports.validateSync = validateSync;
     function validateSync({ validators, value }) {
         const errors = [];
         for (const validator of validators) {
@@ -17,7 +18,6 @@ define(["require", "exports", "./utils"], function (require, exports, utils_1) {
         }
         return { result: 'success' };
     }
-    exports.validateSync = validateSync;
     function validateAsync({ validators, value }) {
         const doValidate = (validator, value) => {
             try {
@@ -49,5 +49,4 @@ define(["require", "exports", "./utils"], function (require, exports, utils_1) {
             maybeErrorPromises
         };
     }
-    exports.validateAsync = validateAsync;
 });

package/oj-c/hooks/UNSAFE_useLegendPosition/useLegendPosition.js

@@ -1,7 +1,7 @@
 define(["require", "exports", "preact/hooks"], function (require, exports, hooks_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.useLegendPosition = void 0;
+    exports.useLegendPosition = useLegendPosition;
     function useLegendPosition(rootRef, position) {
         const [legendPosition, setLegendPosition] = (0, hooks_1.useState)(position === 'auto' ? 'end' : position);
         (0, hooks_1.useLayoutEffect)(() => {
@@ -14,5 +14,4 @@ define(["require", "exports", "preact/hooks"], function (require, exports, hooks
         }, [position, rootRef]);
         return legendPosition;
     }
-    exports.useLegendPosition = useLegendPosition;
 });

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

@@ -17,13 +17,12 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
         const iteratorRef = (0, hooks_1.useRef)(null);
         const abortControllerRef = (0, hooks_1.useRef)(null);
         const fetchSize = options.fetchSize && options.fetchSize > 0 ? options.fetchSize : DEFAULT_FETCH_SIZE;
-        if (!data) {
-            const emptyListState = (0, exports.getEmptyState)('exact');
-            return [emptyListState, (_) => Promise.resolve()];
-        }
         const dataProvider = (0, hooks_1.useMemo)(() => wrapData(data), [data]);
         const [state, dispatch] = (0, hooks_1.useReducer)(reducer, options.initialRowsFetched === 0 ? (0, exports.getEmptyState)('atLeast') : initialState);
         const fetchRange = (0, hooks_1.useCallback)(async (range, resultsCallback) => {
+            if (dataProvider == null) {
+                return;
+            }
             const fetchOptions = {
                 attributes: options.attributes,
                 sortCriteria: options.sortCriteria,
@@ -68,6 +67,9 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
             }
         }, [dataProvider, options.attributes, options.filterCriterion, options.sortCriteria]);
         const loadInitial = (0, hooks_1.useCallback)(async () => {
+            if (dataProvider == null) {
+                return;
+            }
             if (state.status === 'loading') {
                 abortControllerRef.current?.abort((0, ojdatacollection_common_1.getAbortReason)());
             }
@@ -114,8 +116,10 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
         }, [
             dataProvider,
             fetchRange,
+            fetchSize,
             options.attributes,
             options.filterCriterion,
+            options.initialRowsFetched,
             options.sortCriteria,
             options.fetchSize
         ]);
@@ -157,7 +161,7 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
                     fetchRange(range);
                 }
             }
-        }, [state, loadInitial, fetchRange]);
+        }, [loadInitial, fetchRange]);
         const resetAndLoad = (0, hooks_1.useCallback)(() => {
             iteratorRef.current = null;
             fetchNextRef.current = null;
@@ -174,8 +178,10 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
             }
         }, [loadInitial, options.isInitialFetchDeferred, options.initialRowsFetched]);
         (0, hooks_1.useEffect)(() => {
-            resetAndLoad();
-        }, [resetAndLoad]);
+            if (dataProvider) {
+                resetAndLoad();
+            }
+        }, [dataProvider, resetAndLoad]);
         const handleMutation = (0, hooks_1.useCallback)((event) => {
             if (state.status === 'success' && state.data) {
                 const dataState = state.data;
@@ -236,19 +242,30 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
                 }
                 resetAndLoad();
             }
-        }, [state, resetAndLoad]);
+        }, [state, fetchSize, loadRange, resetAndLoad]);
         (0, hooks_1.useEffect)(() => {
-            dataProvider.addEventListener('refresh', handleRefresh);
-            dataProvider.addEventListener('mutate', handleMutation);
+            if (dataProvider) {
+                dataProvider.addEventListener('refresh', handleRefresh);
+                dataProvider.addEventListener('mutate', handleMutation);
+            }
             return () => {
-                dataProvider.removeEventListener('refresh', handleRefresh);
-                dataProvider.removeEventListener('mutate', handleMutation);
+                if (dataProvider) {
+                    dataProvider.removeEventListener('refresh', handleRefresh);
+                    dataProvider.removeEventListener('mutate', handleMutation);
+                }
             };
-        }, [dataProvider, resetAndLoad, handleMutation]);
+        }, [dataProvider, resetAndLoad, handleMutation, handleRefresh]);
+        if (!data) {
+            const emptyListState = (0, exports.getEmptyState)('exact');
+            return [emptyListState, (_) => Promise.resolve()];
+        }
         return [state, loadRange];
     };
     exports.useListData = useListData;
     const wrapData = (data) => {
+        if (data == null) {
+            return null;
+        }
         const configuration = {
             fetchFirst: { caching: 'visitedByCurrentIterator' }
         };
@@ -315,6 +332,16 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
             });
         }
         else {
+            if (isAdd) {
+            }
+            else {
+                const allKeys = dataState.data.map((d) => d.metadata.key);
+                detail.keys.forEach((key) => {
+                    if (allKeys.includes(key)) {
+                        itemCount += 1;
+                    }
+                });
+            }
         }
         return itemCount;
     };
@@ -330,6 +357,14 @@ define(["require", "exports", "ojs/ojdatacollection-common", "ojs/ojdataprovider
             }
         }
         else {
+            const detailKeys = Array.from(detail.keys);
+            const allKeys = dataState.data.map((d) => d.metadata.key);
+            for (let i = 0; i < detailKeys.length; i++) {
+                const key = detailKeys[i];
+                if (allKeys.includes(key)) {
+                    return true;
+                }
+            }
         }
         return false;
     };

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

@@ -1,7 +1,7 @@
 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;
+    exports.useMergedFormContext = useMergedFormContext;
     function useMergedFormContext({ propContainerReadonly, propLabelWrapping, propReadonly, propUserAssistanceDensity }) {
         const formContext = (0, UNSAFE_useFormContext_1.useFormContext)();
         const uadValue = propUserAssistanceDensity ?? formContext.userAssistanceDensity;
@@ -19,5 +19,4 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormCont
             uadValue
         };
     }
-    exports.useMergedFormContext = useMergedFormContext;
 });

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

@@ -1,16 +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)(() => {
+    exports.useVisBusyState = useVisBusyState;
+    function useVisBusyState(rootRef, baseDescription = '') {
+        const addBusyState = (0, hooks_1.useCallback)((description) => {
             if (rootRef.current) {
                 const busyContext = Context.getContext(rootRef.current).getBusyContext();
-                return busyContext.addBusyState({ description: baseDescription });
+                return busyContext.addBusyState({ description: `${baseDescription}${description}` });
             }
             return () => { };
         }, [baseDescription, rootRef]);
-        return addBusyState;
+        const busyStateContext = (0, hooks_1.useMemo)(() => ({ addBusyState }), [addBusyState]);
+        return busyStateContext;
     }
-    exports.useVisBusyState = useVisBusyState;
 });

package/oj-c/hooks/UNSAFE_useVizCategories/useVizCategories.js

@@ -1,10 +1,24 @@
 define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useCategories"], function (require, exports, UNSAFE_useCategories_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.useVizCategories = void 0;
+    exports.useVizCategories = useVizCategories;
     function useVizCategories(categoriesItem, getCategories, hiddenCategories, highlightedCategories, hiddenMatch = 'any', highlightMatch = 'all', onHiddenCategoriesChanged, onHighlightedCategoriesChanged) {
-        const { ids: hiddenIds, updateCategories: updateHidden } = (0, UNSAFE_useCategories_1.useCategories)(categoriesItem, getCategories, hiddenCategories, hiddenMatch, false, onHiddenCategoriesChanged);
-        const { ids: highlightedIds, updateCategories: updateHighlighted } = (0, UNSAFE_useCategories_1.useCategories)(categoriesItem, getCategories, highlightedCategories, highlightMatch, true, onHighlightedCategoriesChanged);
+        const { ids: hiddenIds, updateCategories: updateHidden } = (0, UNSAFE_useCategories_1.useCategories)({
+            items: categoriesItem,
+            getCategoriesFromItem: getCategories,
+            initialCategories: hiddenCategories,
+            matchCriteria: hiddenMatch,
+            replace: false,
+            onCategoriesChange: onHiddenCategoriesChanged
+        });
+        const { ids: highlightedIds, updateCategories: updateHighlighted } = (0, UNSAFE_useCategories_1.useCategories)({
+            items: categoriesItem,
+            getCategoriesFromItem: getCategories,
+            initialCategories: highlightedCategories,
+            matchCriteria: highlightMatch,
+            replace: true,
+            onCategoriesChange: onHighlightedCategoriesChanged
+        });
         return {
             hiddenIds,
             updateHidden,
@@ -12,5 +26,4 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useCategori
             updateHighlighted
         };
     }
-    exports.useVizCategories = useVizCategories;
 });

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputDateMaskWebElement = void 0;
-var InputDateMaskWebElementBase_1 = require("./InputDateMaskWebElementBase");
+const InputDateMaskWebElementBase_1 = require("./InputDateMaskWebElementBase");
 /**
  * The component WebElement for [oj-c-input-date-mask](../../../oj-c/docs/oj.InputDateMask.html).
  * Do not instantiate this class directly, instead, use

package/oj-c/input-date-mask/__webdriver__/InputDateMaskWebElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"InputDateMaskWebElement.js","sourceRoot":"","sources":["InputDateMaskWebElement.ts"],"names":[],"mappings":";;;AAAA,6EAA4E;AAE5E;;;;GAIG;AACH,MAAa,uBAAwB,SAAQ,yDAA2B;CAEvE;AAFD,0DAEC","sourcesContent":["import { InputDateMaskWebElementBase } from './InputDateMaskWebElementBase';\n\n/**\n * The component WebElement for [oj-c-input-date-mask](../../../oj-c/docs/oj.InputDateMask.html).\n * Do not instantiate this class directly, instead, use\n * [findInputDateMask](../functions/findInputDateMask.html).\n */\nexport class InputDateMaskWebElement extends InputDateMaskWebElementBase {\n  // Put overrides here\n}\n"]}
+{"version":3,"file":"InputDateMaskWebElement.js","sourceRoot":"","sources":["InputDateMaskWebElement.ts"],"names":[],"mappings":";;;AAAA,+EAA4E;AAE5E;;;;GAIG;AACH,MAAa,uBAAwB,SAAQ,yDAA2B;CAEvE;AAFD,0DAEC","sourcesContent":["import { InputDateMaskWebElementBase } from './InputDateMaskWebElementBase';\n\n/**\n * The component WebElement for [oj-c-input-date-mask](../../../oj-c/docs/oj.InputDateMask.html).\n * Do not instantiate this class directly, instead, use\n * [findInputDateMask](../functions/findInputDateMask.html).\n */\nexport class InputDateMaskWebElement extends InputDateMaskWebElementBase {\n  // Put overrides here\n}\n"]}

package/oj-c/input-date-mask/__webdriver__/InputDateMaskWebElementBase.d.ts

@@ -87,7 +87,7 @@ export declare class InputDateMaskWebElementBase extends OjWebElement {
      * Gets the value of <code>labelWrapping</code> property.
      * Should the labels wrap or truncate when there is not enough available space.
      * @return The value of <code>labelWrapping</code> property.
-     *
+     * @deprecated Since 18.0.0. Label truncation for 'start' and 'top' aligned labels is no longer recommended by the Redwood Design System. The default for labelWrapping was 'wrap' and that is now the only suggested pattern by UX design for 'start' and 'top' aligned labels. 'inside' aligned labels are always truncated per UX design and are not affected by this property's value.
      */
     getLabelWrapping(): Promise<string>;
     /**

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InputDateMaskWebElementBase = void 0;
-var elements_1 = require("@oracle/oraclejet-webdriver/elements");
+const elements_1 = require("@oracle/oraclejet-webdriver/elements");
 /**
  * This is the base class for oj-c-input-date-mask WebElement, and is generated from the
  * component's metadata. Do not modify these contents since they'll be replaced
@@ -112,7 +112,7 @@ class InputDateMaskWebElementBase extends elements_1.OjWebElement {
      * Gets the value of <code>labelWrapping</code> property.
      * Should the labels wrap or truncate when there is not enough available space.
      * @return The value of <code>labelWrapping</code> property.
-     *
+     * @deprecated Since 18.0.0. Label truncation for 'start' and 'top' aligned labels is no longer recommended by the Redwood Design System. The default for labelWrapping was 'wrap' and that is now the only suggested pattern by UX design for 'start' and 'top' aligned labels. 'inside' aligned labels are always truncated per UX design and are not affected by this property's value.
      */
     getLabelWrapping() {
         return this.getProperty('labelWrapping');