@oracle/oraclejet-core-pack 16.1.3 → 17.0.0

package/oj-c/select-multiple/useSelectMultiplePreact.js

@@ -1,13 +1,16 @@
-define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslationBundle", "oj-c/editable-value/UNSAFE_useEditableValue/useEditableValue", "oj-c/editable-value/UNSAFE_useValidators/useValidators", "oj-c/hooks/UNSAFE_useListData/useListData", "oj-c/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners", "oj-c/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider", "oj-c/select-common/UNSAFE_useWrapValueState/useWrapValueState", "oj-c/select-common/utils/utils", "oj-c/utils/UNSAFE_keyUtils/keySetUtils", "ojs/ojdataprovider", "preact/hooks", "./useSyncValueAndValueItems", "./useValueItems"], function (require, exports, UNSAFE_useTranslationBundle_1, useEditableValue_1, useValidators_1, useListData_1, useDataProviderListeners_1, useWrapDataProvider_1, useWrapValueState_1, utils_1, keySetUtils_1, ojdataprovider_1, hooks_1, useSyncValueAndValueItems_1, useValueItems_1) {
+define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslationBundle", "oj-c/editable-value/UNSAFE_useEditableValue/useEditableValue", "oj-c/editable-value/UNSAFE_useValidators/useValidators", "oj-c/hooks/UNSAFE_useListData/useListData", "oj-c/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners", "oj-c/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider", "oj-c/select-common/UNSAFE_useWrapValueState/useWrapValueState", "oj-c/select-common/utils/utils", "oj-c/utils/UNSAFE_keyUtils/keySetUtils", "preact/hooks", "./useSyncValueAndValueItems", "./useValueItems"], function (require, exports, UNSAFE_useTranslationBundle_1, useEditableValue_1, useValidators_1, useListData_1, useDataProviderListeners_1, useWrapDataProvider_1, useWrapValueState_1, utils_1, keySetUtils_1, hooks_1, useSyncValueAndValueItems_1, useValueItems_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.useSelectMultiplePreact = void 0;
-    function useSelectMultiplePreact({ data: propData, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, messagesCustom, placeholder, readonly, required, requiredMessageDetail: propRequiredMessageDetail, textAlign, userAssistanceDensity, value: propValue, valueItems: propValueItems, virtualKeyboard, onMessagesCustomChanged, onValidChanged, onValueChanged, onValueItemsChanged, ...otherProps }, addBusyState) {
+    function useSelectMultiplePreact({ data: propData, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, matchBy: propMatchBy, messagesCustom, placeholder, readonly, required, requiredMessageDetail: propRequiredMessageDetail, textAlign, userAssistanceDensity, value: propValue, valueItems: propValueItems, virtualKeyboard, onMessagesCustomChanged, onValidChanged, onValueChanged, onValueItemsChanged, ...otherProps }, addBusyState) {
         const [filterCriterion, setFilterCriterion] = (0, hooks_1.useState)(undefined);
         const [isLoading, setIsLoading] = (0, hooks_1.useState)(propData != null &&
             propValue != null &&
             propValue.size > 0 &&
             (propValueItems == null || propValueItems.size === 0));
+        const matchBy = (0, hooks_1.useMemo)(() => {
+            return propMatchBy && propMatchBy.length > 0 ? [...propMatchBy] : undefined;
+        }, [propMatchBy]);
         const { valueItems, setValueItems, preactValueItems: arItemContexts } = (0, useValueItems_1.useValueItems)(propValueItems, onValueItemsChanged);
         const [prevArItemContexts, setPrevArItemContexts] = (0, hooks_1.useState)(arItemContexts);
         const [preactValueItems, setPreactValueItems] = (0, hooks_1.useState)(arItemContexts);
@@ -22,7 +25,7 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslat
         });
         const translations = (0, UNSAFE_useTranslationBundle_1.useTranslationBundle)('@oracle/oraclejet-preact');
         const requiredMessageDetail = propRequiredMessageDetail || translations.select_requiredMessageDetail();
-        const { methods, onCommitValue, setValue, textFieldProps, value } = (0, useEditableValue_1.useEditableValue)({
+        const { methods, onCommitValue, setDisplayValue, setValue, textFieldProps, value, validateValueOnExternalChange } = (0, useEditableValue_1.useEditableValue)({
             ariaDescribedBy: otherProps['aria-describedby'],
             disabled,
             displayOptions,
@@ -61,18 +64,22 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslat
         (0, useSyncValueAndValueItems_1.useSyncValueAndValueItems)({
             addBusyState,
             dataProvider: dataProvider,
+            setDisplayValue: setDisplayValue,
             setIsLoading,
             setValue: setValue,
             setValueItems,
             value: valueToSync,
-            valueItems: valueItemsToSync
+            valueItems: valueItemsToSync,
+            validateValueOnExternalChange
         });
         const [listDataState, onLoadRange] = (0, useListData_1.useListData)(dataProvider, {
             filterCriterion,
             initialRowsFetched: 0
         });
         const onCommit = (0, hooks_1.useCallback)(async ({ value }) => {
-            const validationResult = await onCommitValue((value && value.size > 0 ? value : utils_1.DEFAULT_VALUE));
+            const valueToCommit = (value && value.size > 0 ? value : utils_1.DEFAULT_VALUE);
+            setDisplayValue(valueToCommit);
+            const validationResult = await onCommitValue(valueToCommit);
             if (validationResult === useValidators_1.ValidationResult.INVALID) {
                 setPreactValueItems(undefined);
             }
@@ -87,13 +94,11 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslat
                     }
                 }
             }
-        }, [arItemContexts, preactValueItems, onCommitValue]);
+        }, [arItemContexts, preactValueItems, onCommitValue, setDisplayValue]);
         const onFilter = (0, hooks_1.useCallback)(({ searchText }) => {
-            const fc = searchText && searchText.length > 0
-                ? ojdataprovider_1.FilterFactory.getFilter({ filterDef: { text: searchText } })
-                : undefined;
+            const fc = (0, utils_1.getFilterCriterion)(dataProvider, searchText, matchBy);
             setFilterCriterion(fc);
-        }, []);
+        }, [dataProvider, matchBy]);
         const prevSelectedKeysRef = (0, hooks_1.useRef)((0, keySetUtils_1.keysToKeySet)({ all: false, keys: new Set() }));
         const itemRenderer = (0, hooks_1.useCallback)(({ data, metadata, searchText, selectedKeys: preactSelectedKeys, onSelectionChange: preactOnSelectionChange }) => {
             const newPreactSelectedKeys = preactSelectedKeys ?? new Set();
@@ -115,8 +120,8 @@ define(["require", "exports", "@oracle/oraclejet-preact/hooks/UNSAFE_useTranslat
                     selectedKeys,
                     onSelectedKeysChanged,
                     item: {
-                        data,
-                        metadata
+                        data: data,
+                        metadata: metadata
                     },
                     searchText
                 })

package/oj-c/select-multiple/useSyncValueAndValueItems.js

@@ -1,8 +1,8 @@
-define(["require", "exports", "@oracle/oraclejet-preact/utils/UNSAFE_logger", "oj-c/select-common/utils/utils", "preact/hooks"], function (require, exports, UNSAFE_logger_1, utils_1, hooks_1) {
+define(["require", "exports", "@oracle/oraclejet-preact/utils/UNSAFE_logger", "oj-c/editable-value/UNSAFE_useValidators/useValidators", "oj-c/select-common/utils/utils", "preact/hooks"], function (require, exports, UNSAFE_logger_1, useValidators_1, utils_1, hooks_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.useSyncValueAndValueItems = void 0;
-    function useSyncValueAndValueItems({ addBusyState, dataProvider, setIsLoading, setValue, setValueItems, value, valueItems }) {
+    function useSyncValueAndValueItems({ addBusyState, dataProvider, setDisplayValue, setIsLoading, setValue, setValueItems, value, valueItems, validateValueOnExternalChange }) {
         const prevValueRef = (0, hooks_1.useRef)(value);
         const prevValueItemsRef = (0, hooks_1.useRef)(valueItems);
         const hasValue = value && value instanceof Set && value.size > 0;
@@ -58,26 +58,50 @@ define(["require", "exports", "@oracle/oraclejet-preact/utils/UNSAFE_logger", "o
                 }
                 afterFetch();
             });
-        }, [dataProvider, hasValue, hasValueItems, value, valueItems]);
+        }, [
+            addBusyState,
+            dataProvider,
+            hasValue,
+            hasValueItems,
+            setIsLoading,
+            setValueItems,
+            value,
+            valueItems
+        ]);
         const syncValueToValueItems = (0, hooks_1.useCallback)(() => {
+            const updateValue = (nextValue) => {
+                const validationResult = validateValueOnExternalChange(nextValue);
+                if (validationResult === useValidators_1.ValidationResult.VALID) {
+                    setValue(nextValue);
+                    setDisplayValue(nextValue);
+                }
+            };
             if (!hasValueItems) {
                 if (hasValue) {
-                    setValue(utils_1.DEFAULT_VALUE);
+                    updateValue(utils_1.DEFAULT_VALUE);
                 }
                 return;
             }
             const arValueItemsKeys = Array.from(valueItems.keys());
             const valueItemsKeys = new Set(arValueItemsKeys);
             if (!value || !(value instanceof Set) || value.size !== valueItemsKeys.size) {
-                setValue(valueItemsKeys);
+                updateValue(valueItemsKeys);
                 return;
             }
             const arValueKeys = Array.from(value.keys());
             const isDifferent = arValueItemsKeys.some((key, index) => key !== arValueKeys[index]);
             if (isDifferent) {
-                setValue(valueItemsKeys);
+                updateValue(valueItemsKeys);
             }
-        }, [hasValue, hasValueItems, value, valueItems]);
+        }, [
+            hasValue,
+            hasValueItems,
+            setDisplayValue,
+            setValue,
+            validateValueOnExternalChange,
+            value,
+            valueItems
+        ]);
         (0, hooks_1.useEffect)(() => {
             if (hasValue) {
                 syncValueItemsToValue();
@@ -105,7 +129,7 @@ define(["require", "exports", "@oracle/oraclejet-preact/utils/UNSAFE_logger", "o
                 prevValueItemsRef.current = valueItems;
                 syncValueToValueItems();
             }
-        }, [value, valueItems]);
+        }, [syncValueItemsToValue, syncValueToValueItems, value, valueItems]);
     }
     exports.useSyncValueAndValueItems = useSyncValueAndValueItems;
     function handleFetchByKeysResults(value, valueItems, fetchByKeysResults) {

package/oj-c/select-multiple.js

@@ -1,4 +1,4 @@
-define(["require", "exports", "./select-multiple/select-multiple"], function (require, exports, select_multiple_1) {
+define(["require", "exports", "oj-c/select-multiple/select-multiple"], function (require, exports, select_multiple_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.SelectMultiple = void 0;

package/oj-c/select-single/__webdriver__/SelectSingleWebElementBase.d.ts

@@ -97,6 +97,13 @@ export declare class SelectSingleWebElementBase extends OjWebElement {
      *
      */
     getLabelWrapping(): Promise<string>;
+    /**
+     * Gets the value of <code>matchBy</code> property.
+     * List of text filter matching behaviors to use when filtering.
+     * @return The value of <code>matchBy</code> property.
+     *
+     */
+    getMatchBy(): Promise<Array<string> | null>;
     /**
      * Sets the value of <code>messagesCustom</code> property.
      * List of custom component messages
@@ -146,13 +153,6 @@ export declare class SelectSingleWebElementBase extends OjWebElement {
      *
      */
     getTextAlign(): Promise<string>;
-    /**
-     * Gets the value of <code>unsafe_labelledBy</code> property.
-     *
-     * @return The value of <code>unsafe_labelledBy</code> property.
-     *
-     */
-    getUnsafeLabelledBy(): Promise<string>;
     /**
      * Gets the value of <code>userAssistanceDensity</code> property.
      * Specifies the density of the form component's user assistance presentation.

package/oj-c/select-single/__webdriver__/SelectSingleWebElementBase.js

@@ -126,6 +126,15 @@ class SelectSingleWebElementBase extends elements_1.OjWebElement {
     getLabelWrapping() {
         return this.getProperty('labelWrapping');
     }
+    /**
+     * Gets the value of <code>matchBy</code> property.
+     * List of text filter matching behaviors to use when filtering.
+     * @return The value of <code>matchBy</code> property.
+     *
+     */
+    getMatchBy() {
+        return this.getProperty('matchBy');
+    }
     /**
      * Sets the value of <code>messagesCustom</code> property.
      * List of custom component messages
@@ -189,15 +198,6 @@ class SelectSingleWebElementBase extends elements_1.OjWebElement {
     getTextAlign() {
         return this.getProperty('textAlign');
     }
-    /**
-     * Gets the value of <code>unsafe_labelledBy</code> property.
-     *
-     * @return The value of <code>unsafe_labelledBy</code> property.
-     *
-     */
-    getUnsafeLabelledBy() {
-        return this.getProperty('unsafe_labelledBy');
-    }
     /**
      * Gets the value of <code>userAssistanceDensity</code> property.
      * Specifies the density of the form component's user assistance presentation.

package/oj-c/select-single/__webdriver__/SelectSingleWebElementBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectSingleWebElementBase.js","sourceRoot":"","sources":["SelectSingleWebElementBase.ts"],"names":[],"mappings":"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","sourcesContent":["import { OjWebElement } from '@oracle/oraclejet-webdriver/elements';\n\n/**\n * This is the base class for oj-c-select-single WebElement, and is generated from the\n * component's metadata. Do not modify these contents since they'll be replaced\n * during the next generation.\n * Put overrides into the WebElements's subclass, SelectSingleWebElement.ts.\n */\nexport class SelectSingleWebElementBase extends OjWebElement {\n  /**\n   * Gets the value of <code>advancedSearch</code> property.\n   * Specifies whether the advanced search link is shown in the dropdown when the user filters.\n   * @return The value of <code>advancedSearch</code> property.\n   *\n   */\n  public getAdvancedSearch(): Promise<string> {\n    return this.getProperty<string>('advancedSearch');\n  }\n\n  /**\n   * Gets the value of <code>columnSpan</code> property.\n   * Specifies how many columns this component should span.\n   * @return The value of <code>columnSpan</code> property.\n   *\n   */\n  public getColumnSpan(): Promise<number> {\n    return this.getProperty<number>('columnSpan');\n  }\n\n  /**\n   * Gets the value of <code>containerReadonly</code> property.\n   * Specifies whether an ancestor container, like oj-c-form-layout, is readonly.\n   * @return The value of <code>containerReadonly</code> property.\n   *\n   */\n  public getContainerReadonly(): Promise<boolean> {\n    return this.getProperty<boolean>('containerReadonly');\n  }\n\n  /**\n   * Gets the value of <code>data</code> property.\n   * The data source for SelectSingle.\n   * @return The value of <code>data</code> property.\n   * @deprecated Since 15.0.0. Data sets from a DataProvider cannot be sent to WebDriverJS; use ViewModels or page variables instead.\n   */\n  public getData(): Promise<null> {\n    return this.getProperty<null>('data');\n  }\n\n  /**\n   * Gets the value of <code>disabled</code> property.\n   * Specifies whether the component is disabled.\n   * @return The value of <code>disabled</code> property.\n   *\n   */\n  public getDisabled(): Promise<boolean> {\n    return this.getProperty<boolean>('disabled');\n  }\n\n  /**\n   * Gets the value of <code>displayOptions</code> property.\n   * Display options for auxiliary content that determines whether or not it should be displayed.\n   * @return The value of <code>displayOptions</code> property.\n   *\n   */\n  public getDisplayOptions(): Promise<DisplayOptions> {\n    return this.getProperty<DisplayOptions>('displayOptions');\n  }\n\n  /**\n   * Gets the value of <code>help</code> property.\n   * Form component help information.\n   * @return The value of <code>help</code> property.\n   *\n   */\n  public getHelp(): Promise<Help> {\n    return this.getProperty<Help>('help');\n  }\n\n  /**\n   * Gets the value of <code>helpHints</code> property.\n   * The helpHints object contains a definition property and a source property.\n   * @return The value of <code>helpHints</code> property.\n   *\n   */\n  public getHelpHints(): Promise<HelpHints> {\n    return this.getProperty<HelpHints>('helpHints');\n  }\n\n  /**\n   * Gets the value of <code>itemText</code> property.\n   * Specifies how to get the text string to render for a data item.\n   * @return The value of <code>itemText</code> property.\n   *\n   */\n  public getItemText(): Promise<string | number | null> {\n    return this.getProperty<string | number | null>('itemText');\n  }\n\n  /**\n   * Gets the value of <code>labelEdge</code> property.\n   * Specifies how the label is positioned for the component\n   * @return The value of <code>labelEdge</code> property.\n   *\n   */\n  public getLabelEdge(): Promise<string> {\n    return this.getProperty<string>('labelEdge');\n  }\n\n  /**\n   * Gets the value of <code>labelHint</code> property.\n   * Represents a hint for rendering a label on the component.\n   * @return The value of <code>labelHint</code> property.\n   *\n   */\n  public getLabelHint(): Promise<string> {\n    return this.getProperty<string>('labelHint');\n  }\n\n  /**\n   * Gets the value of <code>labelStartWidth</code> property.\n   * The width of the label when labelEdge is 'start'\n   * @return The value of <code>labelStartWidth</code> property.\n   *\n   */\n  public getLabelStartWidth(): Promise<number | string> {\n    return this.getProperty<number | string>('labelStartWidth');\n  }\n\n  /**\n   * Gets the value of <code>labelWrapping</code> property.\n   * Should the labels wrap or truncate when there is not enough available space.\n   * @return The value of <code>labelWrapping</code> property.\n   *\n   */\n  public getLabelWrapping(): Promise<string> {\n    return this.getProperty<string>('labelWrapping');\n  }\n\n  /**\n   * Sets the value of <code>messagesCustom</code> property.\n   * List of custom component messages\n   * @param messagesCustom The value to set for <code>messagesCustom</code>\n   *\n   */\n  public changeMessagesCustom(messagesCustom: Array<MessagesCustom>): Promise<void> {\n    return this.setProperty<Array<MessagesCustom>>('messagesCustom', messagesCustom);\n  }\n\n  /**\n   * Gets the value of <code>messagesCustom</code> property.\n   * List of custom component messages\n   * @return The value of <code>messagesCustom</code> property.\n   *\n   */\n  public getMessagesCustom(): Promise<Array<MessagesCustom>> {\n    return this.getProperty<Array<MessagesCustom>>('messagesCustom');\n  }\n\n  /**\n   * Gets the value of <code>placeholder</code> property.\n   * The placeholder text to set on the element.\n   * @return The value of <code>placeholder</code> property.\n   *\n   */\n  public getPlaceholder(): Promise<string> {\n    return this.getProperty<string>('placeholder');\n  }\n\n  /**\n   * Gets the value of <code>readonly</code> property.\n   * Whether the component is readonly\n   * @return The value of <code>readonly</code> property.\n   *\n   */\n  public getReadonly(): Promise<boolean> {\n    return this.getProperty<boolean>('readonly');\n  }\n\n  /**\n   * Gets the value of <code>required</code> property.\n   * Specifies whether or not the component is required.\n   * @return The value of <code>required</code> property.\n   *\n   */\n  public getRequired(): Promise<boolean> {\n    return this.getProperty<boolean>('required');\n  }\n\n  /**\n   * Gets the value of <code>requiredMessageDetail</code> property.\n   * Overrides the default Required error message.\n   * @return The value of <code>requiredMessageDetail</code> property.\n   *\n   */\n  public getRequiredMessageDetail(): Promise<string> {\n    return this.getProperty<string>('requiredMessageDetail');\n  }\n\n  /**\n   * Gets the value of <code>textAlign</code> property.\n   * Specifies how the text is aligned within the text field\n   * @return The value of <code>textAlign</code> property.\n   *\n   */\n  public getTextAlign(): Promise<string> {\n    return this.getProperty<string>('textAlign');\n  }\n\n  /**\n   * Gets the value of <code>unsafe_labelledBy</code> property.\n   *\n   * @return The value of <code>unsafe_labelledBy</code> property.\n   *\n   */\n  public getUnsafeLabelledBy(): Promise<string> {\n    return this.getProperty<string>('unsafe_labelledBy');\n  }\n\n  /**\n   * Gets the value of <code>userAssistanceDensity</code> property.\n   * Specifies the density of the form component's user assistance presentation.\n   * @return The value of <code>userAssistanceDensity</code> property.\n   *\n   */\n  public getUserAssistanceDensity(): Promise<string> {\n    return this.getProperty<string>('userAssistanceDensity');\n  }\n\n  /**\n   * Sets the value of <code>value</code> property.\n   * The value of the component.\n   * @param value The value to set for <code>value</code>\n   *\n   */\n  public changeValue(value: any): Promise<void> {\n    return this.setProperty<any>('value', value);\n  }\n\n  /**\n   * Gets the value of <code>value</code> property.\n   * The value of the component.\n   * @return The value of <code>value</code> property.\n   *\n   */\n  public getValue(): Promise<any> {\n    return this.getProperty<any>('value');\n  }\n\n  /**\n   * Sets the value of <code>valueItem</code> property.\n   * The current value of the element and its associated data.\n   * @param valueItem The value to set for <code>valueItem</code>\n   *\n   */\n  public changeValueItem(valueItem: ValueItem | null): Promise<void> {\n    return this.setProperty<ValueItem | null>('valueItem', valueItem);\n  }\n\n  /**\n   * Gets the value of <code>valueItem</code> property.\n   * The current value of the element and its associated data.\n   * @return The value of <code>valueItem</code> property.\n   *\n   */\n  public getValueItem(): Promise<ValueItem | null> {\n    return this.getProperty<ValueItem | null>('valueItem');\n  }\n\n  /**\n   * Gets the value of <code>virtualKeyboard</code> property.\n   * The type of virtual keyboard to display for entering a value on mobile browsers\n   * @return The value of <code>virtualKeyboard</code> property.\n   *\n   */\n  public getVirtualKeyboard(): Promise<string> {\n    return this.getProperty<string>('virtualKeyboard');\n  }\n\n  /**\n   * Gets the value of <code>valid</code> property.\n   * Specifies how the valid state of the component\n   * @return The value of <code>valid</code> property.\n   *\n   */\n  public getValid(): Promise<string> {\n    return this.getProperty<string>('valid');\n  }\n}\nexport interface DisplayOptions {\n  /**\n   *\n   */\n  messages: string;\n}\nexport interface Help {\n  /**\n   *\n   */\n  instruction: string;\n}\nexport interface HelpHints {\n  /**\n   *\n   */\n  definition: string;\n  /**\n   *\n   */\n  source: string;\n  /**\n   *\n   */\n  sourceText: string;\n}\nexport interface MessagesCustom {\n  /**\n   *\n   */\n  summary: string;\n  /**\n   *\n   */\n  detail: string;\n  /**\n   *\n   */\n  severity: string;\n}\nexport interface ValueItem {\n  /**\n   *\n   */\n  data: any;\n  /**\n   *\n   */\n  key: any;\n  /**\n   *\n   */\n  metadata: ValueItemMetadata;\n}\nexport interface ValueItemMetadata {\n  /**\n   *\n   */\n  indexFromParent: number;\n  /**\n   *\n   */\n  isLeaf: boolean;\n  /**\n   *\n   */\n  key: any;\n  /**\n   *\n   */\n  message: ValueItemMetadataMessage;\n  /**\n   *\n   */\n  parentKey: any;\n  /**\n   *\n   */\n  suggestion: object;\n  /**\n   *\n   */\n  treeDepth: number;\n}\nexport interface ValueItemMetadataMessage {\n  /**\n   *\n   */\n  detail: string;\n  /**\n   *\n   */\n  severity: string | number;\n  /**\n   *\n   */\n  summary: string;\n}\n"]}
+{"version":3,"file":"SelectSingleWebElementBase.js","sourceRoot":"","sources":["SelectSingleWebElementBase.ts"],"names":[],"mappings":"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","sourcesContent":["import { OjWebElement } from '@oracle/oraclejet-webdriver/elements';\n\n/**\n * This is the base class for oj-c-select-single WebElement, and is generated from the\n * component's metadata. Do not modify these contents since they'll be replaced\n * during the next generation.\n * Put overrides into the WebElements's subclass, SelectSingleWebElement.ts.\n */\nexport class SelectSingleWebElementBase extends OjWebElement {\n  /**\n   * Gets the value of <code>advancedSearch</code> property.\n   * Specifies whether the advanced search link is shown in the dropdown when the user filters.\n   * @return The value of <code>advancedSearch</code> property.\n   *\n   */\n  public getAdvancedSearch(): Promise<string> {\n    return this.getProperty<string>('advancedSearch');\n  }\n\n  /**\n   * Gets the value of <code>columnSpan</code> property.\n   * Specifies how many columns this component should span.\n   * @return The value of <code>columnSpan</code> property.\n   *\n   */\n  public getColumnSpan(): Promise<number> {\n    return this.getProperty<number>('columnSpan');\n  }\n\n  /**\n   * Gets the value of <code>containerReadonly</code> property.\n   * Specifies whether an ancestor container, like oj-c-form-layout, is readonly.\n   * @return The value of <code>containerReadonly</code> property.\n   *\n   */\n  public getContainerReadonly(): Promise<boolean> {\n    return this.getProperty<boolean>('containerReadonly');\n  }\n\n  /**\n   * Gets the value of <code>data</code> property.\n   * The data source for SelectSingle.\n   * @return The value of <code>data</code> property.\n   * @deprecated Since 15.0.0. Data sets from a DataProvider cannot be sent to WebDriverJS; use ViewModels or page variables instead.\n   */\n  public getData(): Promise<null> {\n    return this.getProperty<null>('data');\n  }\n\n  /**\n   * Gets the value of <code>disabled</code> property.\n   * Specifies whether the component is disabled.\n   * @return The value of <code>disabled</code> property.\n   *\n   */\n  public getDisabled(): Promise<boolean> {\n    return this.getProperty<boolean>('disabled');\n  }\n\n  /**\n   * Gets the value of <code>displayOptions</code> property.\n   * Display options for auxiliary content that determines whether or not it should be displayed.\n   * @return The value of <code>displayOptions</code> property.\n   *\n   */\n  public getDisplayOptions(): Promise<DisplayOptions> {\n    return this.getProperty<DisplayOptions>('displayOptions');\n  }\n\n  /**\n   * Gets the value of <code>help</code> property.\n   * Form component help information.\n   * @return The value of <code>help</code> property.\n   *\n   */\n  public getHelp(): Promise<Help> {\n    return this.getProperty<Help>('help');\n  }\n\n  /**\n   * Gets the value of <code>helpHints</code> property.\n   * The helpHints object contains a definition property and a source property.\n   * @return The value of <code>helpHints</code> property.\n   *\n   */\n  public getHelpHints(): Promise<HelpHints> {\n    return this.getProperty<HelpHints>('helpHints');\n  }\n\n  /**\n   * Gets the value of <code>itemText</code> property.\n   * Specifies how to get the text string to render for a data item.\n   * @return The value of <code>itemText</code> property.\n   *\n   */\n  public getItemText(): Promise<string | number | null> {\n    return this.getProperty<string | number | null>('itemText');\n  }\n\n  /**\n   * Gets the value of <code>labelEdge</code> property.\n   * Specifies how the label is positioned for the component\n   * @return The value of <code>labelEdge</code> property.\n   *\n   */\n  public getLabelEdge(): Promise<string> {\n    return this.getProperty<string>('labelEdge');\n  }\n\n  /**\n   * Gets the value of <code>labelHint</code> property.\n   * Represents a hint for rendering a label on the component.\n   * @return The value of <code>labelHint</code> property.\n   *\n   */\n  public getLabelHint(): Promise<string> {\n    return this.getProperty<string>('labelHint');\n  }\n\n  /**\n   * Gets the value of <code>labelStartWidth</code> property.\n   * The width of the label when labelEdge is 'start'\n   * @return The value of <code>labelStartWidth</code> property.\n   *\n   */\n  public getLabelStartWidth(): Promise<number | string> {\n    return this.getProperty<number | string>('labelStartWidth');\n  }\n\n  /**\n   * Gets the value of <code>labelWrapping</code> property.\n   * Should the labels wrap or truncate when there is not enough available space.\n   * @return The value of <code>labelWrapping</code> property.\n   *\n   */\n  public getLabelWrapping(): Promise<string> {\n    return this.getProperty<string>('labelWrapping');\n  }\n\n  /**\n   * Gets the value of <code>matchBy</code> property.\n   * List of text filter matching behaviors to use when filtering.\n   * @return The value of <code>matchBy</code> property.\n   *\n   */\n  public getMatchBy(): Promise<Array<string> | null> {\n    return this.getProperty<Array<string> | null>('matchBy');\n  }\n\n  /**\n   * Sets the value of <code>messagesCustom</code> property.\n   * List of custom component messages\n   * @param messagesCustom The value to set for <code>messagesCustom</code>\n   *\n   */\n  public changeMessagesCustom(messagesCustom: Array<MessagesCustom>): Promise<void> {\n    return this.setProperty<Array<MessagesCustom>>('messagesCustom', messagesCustom);\n  }\n\n  /**\n   * Gets the value of <code>messagesCustom</code> property.\n   * List of custom component messages\n   * @return The value of <code>messagesCustom</code> property.\n   *\n   */\n  public getMessagesCustom(): Promise<Array<MessagesCustom>> {\n    return this.getProperty<Array<MessagesCustom>>('messagesCustom');\n  }\n\n  /**\n   * Gets the value of <code>placeholder</code> property.\n   * The placeholder text to set on the element.\n   * @return The value of <code>placeholder</code> property.\n   *\n   */\n  public getPlaceholder(): Promise<string> {\n    return this.getProperty<string>('placeholder');\n  }\n\n  /**\n   * Gets the value of <code>readonly</code> property.\n   * Whether the component is readonly\n   * @return The value of <code>readonly</code> property.\n   *\n   */\n  public getReadonly(): Promise<boolean> {\n    return this.getProperty<boolean>('readonly');\n  }\n\n  /**\n   * Gets the value of <code>required</code> property.\n   * Specifies whether or not the component is required.\n   * @return The value of <code>required</code> property.\n   *\n   */\n  public getRequired(): Promise<boolean> {\n    return this.getProperty<boolean>('required');\n  }\n\n  /**\n   * Gets the value of <code>requiredMessageDetail</code> property.\n   * Overrides the default Required error message.\n   * @return The value of <code>requiredMessageDetail</code> property.\n   *\n   */\n  public getRequiredMessageDetail(): Promise<string> {\n    return this.getProperty<string>('requiredMessageDetail');\n  }\n\n  /**\n   * Gets the value of <code>textAlign</code> property.\n   * Specifies how the text is aligned within the text field\n   * @return The value of <code>textAlign</code> property.\n   *\n   */\n  public getTextAlign(): Promise<string> {\n    return this.getProperty<string>('textAlign');\n  }\n\n  /**\n   * Gets the value of <code>userAssistanceDensity</code> property.\n   * Specifies the density of the form component's user assistance presentation.\n   * @return The value of <code>userAssistanceDensity</code> property.\n   *\n   */\n  public getUserAssistanceDensity(): Promise<string> {\n    return this.getProperty<string>('userAssistanceDensity');\n  }\n\n  /**\n   * Sets the value of <code>value</code> property.\n   * The value of the component.\n   * @param value The value to set for <code>value</code>\n   *\n   */\n  public changeValue(value: any): Promise<void> {\n    return this.setProperty<any>('value', value);\n  }\n\n  /**\n   * Gets the value of <code>value</code> property.\n   * The value of the component.\n   * @return The value of <code>value</code> property.\n   *\n   */\n  public getValue(): Promise<any> {\n    return this.getProperty<any>('value');\n  }\n\n  /**\n   * Sets the value of <code>valueItem</code> property.\n   * The current value of the element and its associated data.\n   * @param valueItem The value to set for <code>valueItem</code>\n   *\n   */\n  public changeValueItem(valueItem: ValueItem | null): Promise<void> {\n    return this.setProperty<ValueItem | null>('valueItem', valueItem);\n  }\n\n  /**\n   * Gets the value of <code>valueItem</code> property.\n   * The current value of the element and its associated data.\n   * @return The value of <code>valueItem</code> property.\n   *\n   */\n  public getValueItem(): Promise<ValueItem | null> {\n    return this.getProperty<ValueItem | null>('valueItem');\n  }\n\n  /**\n   * Gets the value of <code>virtualKeyboard</code> property.\n   * The type of virtual keyboard to display for entering a value on mobile browsers\n   * @return The value of <code>virtualKeyboard</code> property.\n   *\n   */\n  public getVirtualKeyboard(): Promise<string> {\n    return this.getProperty<string>('virtualKeyboard');\n  }\n\n  /**\n   * Gets the value of <code>valid</code> property.\n   * Specifies how the valid state of the component\n   * @return The value of <code>valid</code> property.\n   *\n   */\n  public getValid(): Promise<string> {\n    return this.getProperty<string>('valid');\n  }\n}\nexport interface DisplayOptions {\n  /**\n   *\n   */\n  messages: string;\n}\nexport interface Help {\n  /**\n   *\n   */\n  instruction: string;\n}\nexport interface HelpHints {\n  /**\n   *\n   */\n  definition: string;\n  /**\n   *\n   */\n  source: string;\n  /**\n   *\n   */\n  sourceText: string;\n}\nexport interface MessagesCustom {\n  /**\n   *\n   */\n  summary: string;\n  /**\n   *\n   */\n  detail: string;\n  /**\n   *\n   */\n  severity: string;\n}\nexport interface ValueItem {\n  /**\n   *\n   */\n  data: any;\n  /**\n   *\n   */\n  key: any;\n  /**\n   *\n   */\n  metadata: ValueItemMetadata;\n}\nexport interface ValueItemMetadata {\n  /**\n   *\n   */\n  indexFromParent: number;\n  /**\n   *\n   */\n  isLeaf: boolean;\n  /**\n   *\n   */\n  key: any;\n  /**\n   *\n   */\n  message: ValueItemMetadataMessage;\n  /**\n   *\n   */\n  parentKey: any;\n  /**\n   *\n   */\n  suggestion: object;\n  /**\n   *\n   */\n  treeDepth: number;\n}\nexport interface ValueItemMetadataMessage {\n  /**\n   *\n   */\n  detail: string;\n  /**\n   *\n   */\n  severity: string | number;\n  /**\n   *\n   */\n  summary: string;\n}\n"]}

package/oj-c/select-single/component.json

@@ -1,7 +1,7 @@
 {
   "name": "select-single",
-  "version": "16.1.3",
-  "jetVersion": "^16.1.3",
+  "version": "17.0.0",
+  "jetVersion": "^17.0.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",
@@ -10,9 +10,15 @@
     "CSelectSingleElement"
   ],
   "displayName": "SelectSingle",
-  "description": "A select single provides support for single-select and search filtering",
+  "description": "A select single is a dropdown list that supports single selection and search filtering.",
   "help": "oj-c.SelectSingle.html",
   "main": "oj-c/select-single",
+  "status": [
+    {
+      "type": "candidate",
+      "since": "17.0.0"
+    }
+  ],
   "extension": {
     "catalog": {
       "category": "Forms"
@@ -27,6 +33,9 @@
       "uxSpecs": [
         "select-single-items"
       ]
+    },
+    "webelement": {
+      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1700/cpwdtsdoc/classes/SelectSingleWebElement.html"
     }
   },
   "propertyLayout": [
@@ -240,6 +249,13 @@
         }
       }
     },
+    "matchBy": {
+      "type": "Array<string>|null",
+      "description": "List of text filter matching behaviors to use when filtering.",
+      "displayName": "Match By",
+      "help": "#matchBy",
+      "value": null
+    },
     "messagesCustom": {
       "type": "Array<object>",
       "description": "List of custom component messages",
@@ -285,8 +301,7 @@
         "consume": {
           "name": "containerReadonly"
         }
-      },
-      "value": false
+      }
     },
     "required": {
       "type": "boolean",
@@ -327,9 +342,6 @@
         "right"
       ]
     },
-    "unsafe_labelledBy": {
-      "type": "string"
-    },
     "userAssistanceDensity": {
       "type": "string",
       "description": "Specifies the density of the form component's user assistance presentation.",
@@ -358,8 +370,7 @@
         "consume": {
           "name": "containerUserAssistanceDensity"
         }
-      },
-      "value": "reflow"
+      }
     },
     "value": {
       "type": "any",
@@ -640,22 +651,28 @@
     }
   },
   "methods": {
-    "reset": {
-      "return": "any"
+    "blur": {
+      "description": "Blurs the input field.",
+      "return": "void"
+    },
+    "focus": {
+      "description": "Focuses the input field.",
+      "return": "void"
     },
     "showMessages": {
-      "return": "any"
+      "description": "Takes all deferred messages and shows them.",
+      "return": "void"
+    },
+    "reset": {
+      "description": "Resets the component by clearing all messages and updating the component's display value using the attribute value.",
+      "return": "void"
     },
     "validate": {
+      "description": "If enabled, validates the component's display value using the converter and all validators registered on the component. The Promise resolves to 'valid' if there were no converter parse errors and the component passed all validations, or if the component is disabled or readonly.",
       "return": "Promise"
     },
-    "blur": {
-      "return": "any"
-    },
-    "focus": {
-      "return": "any"
-    },
     "_doAdvancedSearchAction": {
+      "description": "This method imitates triggering the advanced search link in the dropdown. This is used by the WebElement implementation of oj-c-select-single.",
       "params": [
         {
           "name": "searchText",
@@ -663,9 +680,10 @@
           "type": "string"
         }
       ],
-      "return": "any"
+      "return": "void"
     },
     "_selectItemByValue": {
+      "description": "This method imitates an option selection from the dropdown by using the key of an item. This is used by the WebElement implementation of oj-c-select-single.",
       "params": [
         {
           "name": "value",
@@ -673,7 +691,7 @@
           "type": "any"
         }
       ],
-      "return": "any"
+      "return": "Promise"
     },
     "setProperty": {
       "description": "Sets a property or a single subproperty for complex properties and notifies the component of the change, triggering a corresponding event.",

package/oj-c/select-single/select-single.js

@@ -1,22 +1,49 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/translationBundle', "@oracle/oraclejet-preact/hooks/UNSAFE_useAccessibleContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormVariantContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useTabbableMode", "@oracle/oraclejet-preact/UNSAFE_SelectSingle", "oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText", "ojs/ojcontext", "ojs/ojvcomponent", "ojs/ojvcomponent-binding", "preact", "preact/compat", "preact/hooks", "./useSelectSinglePreact", "@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout", "css!oj-c/select-single/select-single-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, UNSAFE_useAccessibleContext_1, UNSAFE_useFormContext_1, UNSAFE_useFormVariantContext_1, UNSAFE_useTabbableMode_1, UNSAFE_SelectSingle_1, useAssistiveText_1, Context, ojvcomponent_1, ojvcomponent_binding_1, preact_1, compat_1, hooks_1, useSelectSinglePreact_1, Layout_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_SelectSingle", "oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText", "ojs/ojcontext", "ojs/ojvcomponent", "preact/compat", "preact/hooks", "./useSelectSinglePreact", "@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout", "css!oj-c/select-single/select-single-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, UNSAFE_useFormContext_1, useMergedFormContext_1, UNSAFE_useFormVariantContext_1, UNSAFE_useTabbableMode_1, UNSAFE_SelectSingle_1, useAssistiveText_1, Context, ojvcomponent_1, compat_1, hooks_1, useSelectSinglePreact_1, Layout_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.SelectSingle = void 0;
-    const FunctionalSelectSingle = (0, compat_1.forwardRef)((props, ref) => {
-        const { busyContextRef, displayOptions, help, helpHints } = props;
+    const displayOptionsDefault = {
+        messages: 'display'
+    };
+    const helpDefault = {
+        instruction: ''
+    };
+    const helpHintsDefault = {
+        definition: '',
+        source: ''
+    };
+    const messagesCustomDefault = [];
+    function SelectSingleImpl({ advancedSearch = 'off', columnSpan = 1, containerReadonly: propContainerReadonly, data = null, disabled = false, displayOptions = displayOptionsDefault, help = helpDefault, helpHints = helpHintsDefault, id, labelWrapping: propLabelWrapping, matchBy = null, messagesCustom = messagesCustomDefault, readonly: propReadonly, required = false, userAssistanceDensity: propUserAssistanceDensity, value = null, valueItem = null, virtualKeyboard = 'auto', ...otherProps }, ref) {
+        const rootRef = (0, hooks_1.useRef)();
         const selectSingleRef = (0, hooks_1.useRef)();
         const addBusyState = (0, hooks_1.useCallback)((desc) => {
-            return busyContextRef.current?.addBusyState({
-                description: `oj-c-select-single id=${props.id}: ${desc}`
-            });
-        }, [busyContextRef, props.id]);
-        const { selectSingleProps, methods, _doAdvancedSearchAction, _selectItemByValue } = (0, useSelectSinglePreact_1.useSelectSinglePreact)(props, addBusyState);
+            return rootRef.current
+                ? Context.getContext(rootRef.current)
+                    .getBusyContext()
+                    .addBusyState({ description: `oj-c-select-single id=${id}: ${desc}` })
+                : () => { };
+        }, [id]);
+        const { containerProps, uadValue, readonlyValue } = (0, useMergedFormContext_1.useMergedFormContext)({
+            propContainerReadonly,
+            propLabelWrapping,
+            propReadonly,
+            propUserAssistanceDensity
+        });
+        const { selectSingleProps, methods, _doAdvancedSearchAction, _selectItemByValue } = (0, useSelectSinglePreact_1.useSelectSinglePreact)({
+            advancedSearch,
+            data,
+            disabled,
+            displayOptions,
+            matchBy,
+            messagesCustom,
+            readonly: readonlyValue,
+            required,
+            userAssistanceDensity: uadValue,
+            value,
+            valueItem,
+            virtualKeyboard,
+            ...otherProps
+        }, addBusyState);
         (0, hooks_1.useImperativeHandle)(ref, () => ({
             blur: () => selectSingleRef.current?.blur(),
             focus: () => selectSingleRef.current?.focus(),
@@ -31,85 +58,9 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
             userAssistanceDensity: selectSingleProps.userAssistanceDensity
         });
         const variant = (0, UNSAFE_useFormVariantContext_1.useFormVariantContext)();
-        return ((0, jsx_runtime_1.jsx)(UNSAFE_SelectSingle_1.SelectSingle, { ref: selectSingleRef, ...assistiveTextProps, ...selectSingleProps, variant: variant }));
-    });
-    let SelectSingle = class SelectSingle extends preact_1.Component {
-        constructor() {
-            super(...arguments);
-            this.busyContextRef = (0, preact_1.createRef)();
-            this.selectSingleRef = (0, preact_1.createRef)();
-            this.rootRef = (0, preact_1.createRef)();
-        }
-        componentDidMount() {
-            this.busyContextRef.current = Context.getContext(this.rootRef.current).getBusyContext();
-        }
-        render({ columnSpan, ...props }) {
-            const containerProps = {
-                isFormLayout: props.containerReadonly !== undefined,
-                isReadonly: props.containerReadonly,
-                labelWrapping: props.labelWrapping
-            };
-            const accessibleProps = {
-                UNSAFE_ariaLabelledBy: props.unsafe_labelledBy
-            };
-            return ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, { id: props.id, ref: this.rootRef, class: columnSpan ? 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_useAccessibleContext_1.AccessibleContext.Provider, { value: accessibleProps, children: (0, jsx_runtime_1.jsx)(FunctionalSelectSingle, { busyContextRef: this.busyContextRef, ref: this.selectSingleRef, ...props }) }) }) }));
-        }
-        componentWillUnmount() {
-            this.busyContextRef.current = null;
-        }
-        reset() {
-            this.selectSingleRef.current?.reset();
-        }
-        showMessages() {
-            this.selectSingleRef.current?.showMessages();
-        }
-        validate() {
-            return this.selectSingleRef.current?.validate();
-        }
-        blur() {
-            this.selectSingleRef.current?.blur();
-        }
-        focus() {
-            this.selectSingleRef.current?.focus();
-        }
-        _doAdvancedSearchAction(searchText) {
-            return this.selectSingleRef.current?._doAdvancedSearchAction(searchText);
-        }
-        _selectItemByValue(value) {
-            return this.selectSingleRef.current?._selectItemByValue(value);
-        }
-    };
-    exports.SelectSingle = SelectSingle;
-    SelectSingle.defaultProps = {
-        advancedSearch: 'off',
-        columnSpan: 1,
-        data: null,
-        disabled: false,
-        displayOptions: {
-            messages: 'display'
-        },
-        help: {
-            instruction: ''
-        },
-        helpHints: {
-            definition: '',
-            source: '',
-            sourceText: undefined
-        },
-        messagesCustom: [],
-        readonly: false,
-        required: false,
-        userAssistanceDensity: 'reflow',
-        value: null,
-        valueItem: null,
-        virtualKeyboard: 'auto'
-    };
-    SelectSingle._metadata = { "properties": { "advancedSearch": { "type": "string", "enumValues": ["off", "on"] }, "columnSpan": { "type": "number" }, "containerReadonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "data": { "type": "DataProvider|null" }, "disabled": { "type": "boolean" }, "displayOptions": { "type": "object", "properties": { "messages": { "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" } } }, "itemText": { "type": "string|number|function" }, "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" } } }, "messagesCustom": { "type": "Array<object>", "writeback": true }, "placeholder": { "type": "string" }, "readonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "required": { "type": "boolean" }, "requiredMessageDetail": { "type": "string" }, "textAlign": { "type": "string", "enumValues": ["end", "start", "right"] }, "unsafe_labelledBy": { "type": "string" }, "userAssistanceDensity": { "type": "string", "enumValues": ["compact", "reflow", "efficient"], "binding": { "consume": { "name": "containerUserAssistanceDensity" } } }, "value": { "type": "any", "writeback": true }, "valueItem": { "type": "object|null", "properties": { "data": { "type": "any" }, "key": { "type": "any" }, "metadata": { "type": "object", "properties": { "indexFromParent": { "type": "number" }, "isLeaf": { "type": "boolean" }, "key": { "type": "any" }, "message": { "type": "object", "properties": { "detail": { "type": "string" }, "severity": { "type": "string|number" }, "summary": { "type": "string" } } }, "parentKey": { "type": "any" }, "suggestion": { "type": "object" }, "treeDepth": { "type": "number" } } } }, "writeback": true }, "virtualKeyboard": { "type": "string", "enumValues": ["number", "search", "auto", "url", "text", "email", "tel"] }, "valid": { "type": "string", "enumValues": ["pending", "valid", "invalidHidden", "invalidShown"], "readOnly": true, "writeback": true } }, "slots": { "itemTemplate": { "data": {} } }, "events": { "ojAdvancedSearchAction": {}, "ojValueAction": {} }, "extension": { "_WRITEBACK_PROPS": ["messagesCustom", "valid", "value", "valueItem"], "_READ_ONLY_PROPS": ["valid"], "_OBSERVED_GLOBAL_PROPS": ["aria-describedby", "id"] }, "methods": { "reset": {}, "showMessages": {}, "validate": {}, "blur": {}, "focus": {}, "_doAdvancedSearchAction": {}, "_selectItemByValue": {} } };
-    SelectSingle._translationBundleMap = {
+        return ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, { id: 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_SelectSingle_1.SelectSingle, { ref: selectSingleRef, ...assistiveTextProps, ...selectSingleProps, variant: variant }) }) }));
+    }
+    exports.SelectSingle = (0, ojvcomponent_1.registerCustomElement)('oj-c-select-single', (0, compat_1.forwardRef)(SelectSingleImpl), "SelectSingle", { "properties": { "advancedSearch": { "type": "string", "enumValues": ["off", "on"] }, "columnSpan": { "type": "number" }, "containerReadonly": { "type": "boolean", "binding": { "consume": { "name": "containerReadonly" } } }, "data": { "type": "DataProvider|null" }, "disabled": { "type": "boolean" }, "displayOptions": { "type": "object", "properties": { "messages": { "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" } } }, "itemText": { "type": "string|number|function" }, "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" } } }, "matchBy": { "type": "Array<string>|null" }, "messagesCustom": { "type": "Array<object>", "writeback": true }, "placeholder": { "type": "string" }, "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" } } }, "value": { "type": "any", "writeback": true }, "valueItem": { "type": "object|null", "properties": { "data": { "type": "any" }, "key": { "type": "any" }, "metadata": { "type": "object", "properties": { "indexFromParent": { "type": "number" }, "isLeaf": { "type": "boolean" }, "key": { "type": "any" }, "message": { "type": "object", "properties": { "detail": { "type": "string" }, "severity": { "type": "string|number" }, "summary": { "type": "string" } } }, "parentKey": { "type": "any" }, "suggestion": { "type": "object" }, "treeDepth": { "type": "number" } } } }, "writeback": true }, "virtualKeyboard": { "type": "string", "enumValues": ["number", "search", "auto", "url", "text", "email", "tel"] }, "valid": { "type": "string", "enumValues": ["pending", "valid", "invalidHidden", "invalidShown"], "readOnly": true, "writeback": true } }, "slots": { "itemTemplate": { "data": {} } }, "events": { "ojAdvancedSearchAction": {}, "ojValueAction": {} }, "extension": { "_WRITEBACK_PROPS": ["messagesCustom", "valid", "value", "valueItem"], "_READ_ONLY_PROPS": ["valid"], "_OBSERVED_GLOBAL_PROPS": ["aria-describedby", "id"] }, "methods": { "blur": {}, "focus": {}, "showMessages": {}, "reset": {}, "validate": {}, "_doAdvancedSearchAction": {}, "_selectItemByValue": {} } }, { "advancedSearch": "off", "columnSpan": 1, "data": null, "disabled": false, "displayOptions": { "messages": "display" }, "help": { "instruction": "" }, "helpHints": { "definition": "", "source": "" }, "matchBy": null, "messagesCustom": [], "required": false, "value": null, "valueItem": null, "virtualKeyboard": "auto" }, {
         '@oracle/oraclejet-preact': translationBundle_1.default
-    };
-    SelectSingle._consumedContexts = [UNSAFE_useFormVariantContext_1.FormVariantContext, UNSAFE_useTabbableMode_1.TabbableModeContext];
-    exports.SelectSingle = SelectSingle = __decorate([
-        (0, ojvcomponent_1.customElement)('oj-c-select-single')
-    ], SelectSingle);
+    }, { consume: [UNSAFE_useFormVariantContext_1.FormVariantContext, UNSAFE_useTabbableMode_1.TabbableModeContext] });
 });