@oracle/oraclejet-core-pack 17.0.4 → 17.1.0

package/oj-c/table/index.js

@@ -0,0 +1,6 @@
+define(["require", "exports", "./table"], function (require, exports, table_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.Table = void 0;
+    Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return table_1.Table; } });
+});

package/oj-c/table/table-styles.css

@@ -0,0 +1,39 @@
+/* This file is where css selectors for the component go.
+   There will be hard coded properties and properties controlled by variables, for example
+
+   oj-c-table .oj-c-table-value-text {
+     color: var(--oj-c-table-value-text-color);
+     display: inline-block;
+	 }
+*/
+
+oj-c-table:not(.oj-complete) {
+  visibility: hidden;
+}
+
+oj-c-table {
+  align-items: stretch;
+  box-sizing: border-box;
+  clear: both;
+  display: inline-flex;
+  min-height: 24px;
+  min-width: 240px;
+  position: relative;
+}
+
+oj-c-table[hidden] {
+  display: none;
+}
+
+.oj-c-table-header-div {
+  min-width: 1.5rem;
+}
+
+.oj-c-table-header-span {
+  display: -webkit-box;
+  overflow: hidden;
+  overflow-wrap: normal;
+  vertical-align: middle;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}

package/oj-c/table/table.js

@@ -0,0 +1,353 @@
+define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/translationBundle', "ojs/ojcustomelement-registry", "ojs/ojcontext", "ojs/ojvcomponent", "preact/hooks", "../hooks/UNSAFE_useListData/useListData", "@oracle/oraclejet-preact/UNSAFE_TableView", "ojs/ojkeyset", "../utils/UNSAFE_keyUtils/keySetUtils", "@oracle/oraclejet-preact/hooks/UNSAFE_useCollectionInteractionContext", "@oracle/oraclejet-preact/hooks/UNSAFE_useFormVariantContext", "css!oj-c/table/table-styles.css"], function (require, exports, jsx_runtime_1, translationBundle_1, ojcustomelement_registry_1, Context, ojvcomponent_1, hooks_1, useListData_1, UNSAFE_TableView_1, ojkeyset_1, keySetUtils_1, UNSAFE_useCollectionInteractionContext_1, UNSAFE_useFormVariantContext_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.Table = void 0;
+    const _SELECTION_COLUMN_KEY = 'oj-c-table_selection';
+    const _selectedDefault = {};
+    const _selectionModeDefault = { row: 'none', column: 'none' };
+    const _scrollPolicyOptionsDefault = { fetchSize: 25 };
+    const _defaultHeaderRenderer = (headerText) => {
+        return headerText != null ? ((0, jsx_runtime_1.jsx)("div", { class: "oj-c-table-header-div", children: (0, jsx_runtime_1.jsx)("span", { class: "oj-c-table-header-span", children: headerText }) })) : undefined;
+    };
+    const _isClickthroughDisabled = function (element) {
+        return element.dataset['ojClickthrough'] === 'disabled';
+    };
+    const _isEventClickthroughDisabled = function (event, rootElement) {
+        let node = event.target;
+        while (node != null && node !== rootElement) {
+            if (_isClickthroughDisabled(node)) {
+                return true;
+            }
+            node = node.parentNode;
+        }
+        return false;
+    };
+    function TableImpl({ 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, id, data, columns, row, horizontalGridVisible = 'enabled', verticalGridVisible = 'disabled', layout = 'contents', currentCellOverride, onCurrentCellChanged, selected = _selectedDefault, selectionMode = _selectionModeDefault, onSelectedChanged, selectAllControl = 'visible', columnOrder, cellTemplate, headerTemplate, footerTemplate, templates, onOjRowAction, noData, columnWidths, scrollPolicyOptions = _scrollPolicyOptionsDefault }) {
+        const rootRef = (0, hooks_1.useRef)(null);
+        const tableViewRef = (0, hooks_1.useRef)(null);
+        const isClickthroughDisabled = (0, hooks_1.useCallback)((target) => {
+            if (target == null || rootRef.current == null) {
+                return false;
+            }
+            return _isEventClickthroughDisabled({ target }, rootRef.current);
+        }, []);
+        const [listDataState, onLoadRange] = (0, useListData_1.useListData)(data, {
+            fetchSize: scrollPolicyOptions?.fetchSize
+        });
+        const onLoadMore = (0, hooks_1.useCallback)(() => {
+            if (listDataState.status === 'success' && listDataState.data && onLoadRange) {
+                const fetchSize = scrollPolicyOptions && scrollPolicyOptions.fetchSize != null
+                    ? scrollPolicyOptions.fetchSize
+                    : 25;
+                onLoadRange({ offset: 0, count: listDataState.data.data.length + fetchSize });
+            }
+        }, [listDataState, onLoadRange, scrollPolicyOptions]);
+        const hasMore = listDataState.status === 'loading' ||
+            (listDataState.status === 'success' && listDataState.data.sizePrecision === 'atLeast');
+        const realizedColumnWidths = (0, hooks_1.useMemo)(() => {
+            const preactColumnWidths = { ...columnWidths };
+            if (selectionMode?.row === 'multiple') {
+                preactColumnWidths[_SELECTION_COLUMN_KEY] = 36;
+            }
+            return preactColumnWidths;
+        }, [selectionMode?.row, columnWidths]);
+        function getRowContext(context) {
+            const { data } = context;
+            return {
+                item: data
+            };
+        }
+        const tableCellSelectorRenderer = (context) => {
+            return context.selector != null ? context.selector() : undefined;
+        };
+        const tableHeaderSelectorRenderer = (context) => {
+            return context.selector != null ? ((0, jsx_runtime_1.jsx)("div", { "data-oj-table-selector": 'all', children: context.selector() })) : undefined;
+        };
+        function getPreactHeaderRenderer(headerTemplate) {
+            return (context) => {
+                const templateContext = {
+                    key: context.key,
+                    headerText: context.headerText,
+                    isTabbable: context.isTabbable
+                };
+                return headerTemplate
+                    ? headerTemplate(templateContext)
+                    : _defaultHeaderRenderer(templateContext.headerText);
+            };
+        }
+        function getPreactFooterRenderer(footerTemplate, footerText) {
+            if (footerTemplate || footerText != null) {
+                return (context) => {
+                    const templateContext = {
+                        key: context.key,
+                        footerText: context.footerText,
+                        isTabbable: context.isTabbable
+                    };
+                    return footerTemplate ? footerTemplate(templateContext) : footerText;
+                };
+            }
+            return undefined;
+        }
+        function getPreactNoDataRenderer(noData) {
+            if (noData) {
+                return (context) => {
+                    return noData({ isTabbable: context.isTabbable });
+                };
+            }
+            return undefined;
+        }
+        function getPreactCellRenderer(cellTemplate, field) {
+            return (context) => {
+                const templateContext = {
+                    item: context.rowData,
+                    columnKey: context.columnKey,
+                    data: field != null ? context.rowData.data[field] : undefined,
+                    isTabbable: context.isTabbable
+                };
+                return cellTemplate
+                    ? cellTemplate(templateContext)
+                    : templateContext.data != null
+                        ? String(templateContext.data)
+                        : undefined;
+            };
+        }
+        function getPreactColumns(cols, globalCellTemplate, globalHeaderTemplate, globalFooterTemplate, templates) {
+            const preactColumns = {};
+            if (selectionMode?.row === 'multiple') {
+                preactColumns[_SELECTION_COLUMN_KEY] = {
+                    stickyEdge: 'start',
+                    selectable: 'disabled',
+                    renderer: tableCellSelectorRenderer,
+                    headerRenderer: selectAllControl !== 'hidden' ? tableHeaderSelectorRenderer : undefined,
+                    padding: 'disabled',
+                    headerPadding: 'disabled'
+                };
+            }
+            Object.keys(cols).forEach((key) => {
+                const colKey = key;
+                const column = cols[colKey];
+                const cellRenderer = column.template && templates && templates[column.template]
+                    ? getPreactCellRenderer(templates[column.template], column.field)
+                    : getPreactCellRenderer(globalCellTemplate, column.field);
+                const headerCellRenderer = column.headerTemplate && templates && templates[column.headerTemplate]
+                    ? getPreactHeaderRenderer(templates[column.headerTemplate])
+                    : getPreactHeaderRenderer(globalHeaderTemplate);
+                const footerCellRenderer = column.footerTemplate && templates && templates[column.footerTemplate]
+                    ? getPreactFooterRenderer(templates[column.footerTemplate], column.footerText)
+                    : getPreactFooterRenderer(globalFooterTemplate, column.footerText);
+                const headerText = column.headerText ?? undefined;
+                const footerText = column.footerText ?? undefined;
+                const maxWidth = column.maxWidth ?? undefined;
+                const minWidth = column.minWidth ?? undefined;
+                const weight = column.weight ?? undefined;
+                let padding;
+                const columnPadding = column.padding;
+                if (typeof columnPadding === 'function') {
+                    padding = (context) => {
+                        const internalContext = getRowContext(context);
+                        return columnPadding(internalContext);
+                    };
+                }
+                else {
+                    padding = columnPadding ?? 'enabled';
+                }
+                const headerPadding = column.headerPadding ?? 'enabled';
+                const footerPadding = column.footerPadding ?? 'enabled';
+                preactColumns[colKey] = {
+                    headerText: headerText,
+                    footerText: footerText,
+                    renderer: cellRenderer,
+                    headerRenderer: headerCellRenderer,
+                    footerRenderer: footerCellRenderer,
+                    maxWidth,
+                    minWidth,
+                    weight,
+                    padding,
+                    headerPadding,
+                    footerPadding
+                };
+            });
+            return preactColumns;
+        }
+        const handleKeyDown = (0, hooks_1.useCallback)((event) => {
+            if (event.key === ' ') {
+                const targetElement = event.target;
+                if (targetElement.children.length > 0 &&
+                    targetElement.children[0].dataset['ojTableSelector'] === 'all') {
+                    let newRowSelection;
+                    if (selected.row?.isAddAll() && selected.row.keys.deletedKeys?.size === 0) {
+                        newRowSelection = new ojkeyset_1.KeySetImpl();
+                    }
+                    else {
+                        newRowSelection = new ojkeyset_1.AllKeySetImpl();
+                    }
+                    onSelectedChanged({
+                        row: newRowSelection,
+                        column: new ojkeyset_1.KeySetImpl()
+                    });
+                }
+            }
+        }, [onSelectedChanged, selected]);
+        const selectAllHandlerProps = selectionMode?.row === 'multiple' && selectAllControl !== 'hidden'
+            ? { onKeyDown: handleKeyDown }
+            : {};
+        const preactColumns = (0, hooks_1.useMemo)(() => {
+            return columns
+                ? getPreactColumns(columns, cellTemplate, headerTemplate, footerTemplate, templates)
+                : {};
+        }, [columns, cellTemplate, headerTemplate, footerTemplate, templates, selectionMode?.row]);
+        const preactColumnOrder = (0, hooks_1.useMemo)(() => {
+            const newColumnOrder = [];
+            let hasSelectorColumn = false;
+            if (selectionMode?.row === 'multiple') {
+                newColumnOrder.push(_SELECTION_COLUMN_KEY);
+                hasSelectorColumn = true;
+            }
+            if (columnOrder != null) {
+                for (const key of columnOrder) {
+                    if (preactColumns[key] != null && !newColumnOrder.includes(key)) {
+                        newColumnOrder.push(key);
+                    }
+                }
+            }
+            else {
+                for (const [key] of Object.entries(preactColumns)) {
+                    if (key !== _SELECTION_COLUMN_KEY) {
+                        newColumnOrder.push(key);
+                    }
+                }
+            }
+            return newColumnOrder.length === 1 && hasSelectorColumn ? [] : newColumnOrder;
+        }, [columnOrder, selectionMode?.row, preactColumns]);
+        const preactData = listDataState.status === 'success' ? listDataState?.data?.data || [] : [];
+        const preactGetRowKey = (data) => {
+            return data.metadata.key;
+        };
+        const preactGetAccessibleRowHeaders = (preactContext) => {
+            const internalContext = getRowContext(preactContext);
+            const rowHeaders = new Set();
+            if (row != null && row.accessibleRowHeader != null) {
+                if (typeof row.accessibleRowHeader === 'string') {
+                    rowHeaders.add(row.accessibleRowHeader);
+                }
+                else if (Array.isArray(row.accessibleRowHeader)) {
+                    row.accessibleRowHeader.forEach((header) => rowHeaders.add(header));
+                }
+                else if (typeof row.accessibleRowHeader === 'function') {
+                    const result = row.accessibleRowHeader(internalContext);
+                    if (typeof result === 'string') {
+                        rowHeaders.add(result);
+                    }
+                    else if (Array.isArray(result)) {
+                        result.forEach((header) => rowHeaders.add(header));
+                    }
+                }
+            }
+            else if (preactColumnOrder.length > 0) {
+                if (selectionMode?.row === 'multiple') {
+                    rowHeaders.add(preactColumnOrder[1]);
+                }
+                else {
+                    rowHeaders.add(preactColumnOrder[0]);
+                }
+            }
+            return rowHeaders;
+        };
+        const preactOnRowAction = (0, hooks_1.useCallback)((eventDetail) => {
+            if (onOjRowAction && eventDetail != null && !isClickthroughDisabled(eventDetail.target)) {
+                onOjRowAction({ context: getRowContext(eventDetail.context) });
+            }
+        }, [onOjRowAction, isClickthroughDisabled, getRowContext]);
+        const gridlines = (0, hooks_1.useMemo)(() => ({
+            horizontal: horizontalGridVisible === 'enabled' ? 'visible' : 'hidden',
+            vertical: verticalGridVisible === 'enabled' ? 'visible' : 'hidden'
+        }), [horizontalGridVisible, verticalGridVisible]);
+        const noDataRenderer = (0, hooks_1.useMemo)(() => {
+            return getPreactNoDataRenderer(noData);
+        }, [noData]);
+        const preactSelected = (0, hooks_1.useMemo)(() => {
+            return selected
+                ? {
+                    row: selected.row ? (0, keySetUtils_1.keySetToKeys)(selected.row) : undefined,
+                    column: selected.column ? (0, keySetUtils_1.keySetToKeys)(selected.column) : undefined
+                }
+                : undefined;
+        }, [selected?.row, selected?.column]);
+        const preactOnSelectionChange = (0, hooks_1.useCallback)((detail) => {
+            if (!isClickthroughDisabled(detail.target)) {
+                const value = detail.value;
+                const rowKeySet = value.row
+                    ? (0, keySetUtils_1.keysToKeySet)(value.row)
+                    : undefined;
+                const columnKeySet = value.column
+                    ? (0, keySetUtils_1.keysToKeySet)(value.column)
+                    : undefined;
+                onSelectedChanged({
+                    row: rowKeySet,
+                    column: columnKeySet
+                });
+            }
+        }, [onSelectedChanged, isClickthroughDisabled]);
+        const onPersistCurrentCell = (0, hooks_1.useCallback)((detail) => {
+            if (onCurrentCellChanged) {
+                onCurrentCellChanged(detail.value);
+            }
+        }, [onCurrentCellChanged]);
+        const busyContextRef = (0, hooks_1.useRef)();
+        const childBusyContextRef = (0, hooks_1.useRef)();
+        const resolveDataBusyStateRef = (0, hooks_1.useRef)();
+        const resolveContentBusyStateRef = (0, hooks_1.useRef)();
+        const [isInitialLoading, setIsInitialLoading] = (0, hooks_1.useState)(layout === 'contents');
+        const isInitialLoadingRef = (0, hooks_1.useRef)(isInitialLoading);
+        (0, hooks_1.useEffect)(() => {
+            busyContextRef.current = Context.getContext(rootRef.current).getBusyContext();
+            childBusyContextRef.current = Context.getContext(tableViewRef.current).getBusyContext();
+        }, []);
+        const addBusyState = (0, hooks_1.useCallback)((desc) => {
+            return busyContextRef.current?.addBusyState({
+                description: `oj-c-table: ${desc}`
+            });
+        }, []);
+        (0, hooks_1.useEffect)(() => {
+            if (listDataState.status === 'loading') {
+                resolveDataBusyStateRef.current = addBusyState('Table is loading data');
+            }
+            else {
+                if (isInitialLoadingRef.current) {
+                    resolveContentBusyStateRef.current = addBusyState('Table content is initializing');
+                    childBusyContextRef.current.whenReady().then(function () {
+                        if (resolveContentBusyStateRef.current) {
+                            resolveContentBusyStateRef.current();
+                            resolveContentBusyStateRef.current = undefined;
+                        }
+                        setIsInitialLoading(false);
+                        isInitialLoadingRef.current = false;
+                    });
+                }
+            }
+            return () => {
+                if (resolveDataBusyStateRef.current) {
+                    resolveDataBusyStateRef.current();
+                    resolveDataBusyStateRef.current = undefined;
+                }
+                if (resolveContentBusyStateRef.current) {
+                    resolveContentBusyStateRef.current();
+                    resolveContentBusyStateRef.current = undefined;
+                }
+            };
+        }, [listDataState.status, addBusyState]);
+        return ((0, jsx_runtime_1.jsx)(ojvcomponent_1.Root, { id: id, ref: rootRef, children: (0, jsx_runtime_1.jsx)("div", { ref: tableViewRef, "data-oj-context": true, ...selectAllHandlerProps, ...(cellTemplate ? { 'data-oj-ct': true } : {}), ...(headerTemplate ? { 'data-oj-ht': true } : {}), ...(footerTemplate ? { 'data-oj-ft': true } : {}), ...(noData ? { 'data-oj-ndt': true } : {}), style: "display: contents;", children: (0, jsx_runtime_1.jsx)(UNSAFE_useFormVariantContext_1.FormVariantContext.Provider, { value: 'embedded', children: (0, jsx_runtime_1.jsx)(UNSAFE_TableView_1.TableView, { "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, columns: preactColumns, data: preactData, getRowKey: preactGetRowKey, getAccessibleRowHeaders: preactGetAccessibleRowHeaders, gridlines: gridlines, layout: isInitialLoading ? 'pending' : layout, selected: preactSelected, selectionMode: selectionMode, onSelectionChange: preactOnSelectionChange, columnOrder: preactColumnOrder, onRowAction: preactOnRowAction, noDataRenderer: noDataRenderer, columnWidths: realizedColumnWidths, onLoadMore: onLoadMore, hasMore: hasMore, currentCellOverride: currentCellOverride, onPersistCurrentCell: onPersistCurrentCell, width: '100%' }) }) }) }));
+    }
+    exports.Table = (0, ojvcomponent_1.registerCustomElement)('oj-c-table', TableImpl, "Table", { "properties": { "layout": { "type": "string", "enumValues": ["fixed", "contents"] }, "data": { "type": "DataProvider" }, "columns": { "type": "object" }, "row": { "type": "object", "properties": { "accessibleRowHeader": { "type": "any" } } }, "horizontalGridVisible": { "type": "string", "enumValues": ["disabled", "enabled"] }, "verticalGridVisible": { "type": "string", "enumValues": ["disabled", "enabled"] }, "selected": { "type": "object", "properties": { "column": { "type": "object" }, "row": { "type": "object" } }, "writeback": true }, "selectionMode": { "type": "object", "properties": { "column": { "type": "string", "enumValues": ["none", "multiple", "single"] }, "row": { "type": "string", "enumValues": ["none", "multiple", "single"] } } }, "selectAllControl": { "type": "string", "enumValues": ["hidden", "visible"] }, "columnOrder": { "type": "Array<string>", "writeback": true }, "currentCellOverride": { "type": "object" }, "currentCell": { "type": "object", "readOnly": true, "writeback": true }, "columnWidths": { "type": "object", "writeback": true }, "scrollPolicyOptions": { "type": "object", "properties": { "fetchSize": { "type": "number" } } } }, "slots": { "cellTemplate": { "data": {} }, "headerTemplate": { "data": {} }, "footerTemplate": { "data": {} }, "noData": { "data": {} } }, "extension": { "_DYNAMIC_SLOT": { "prop": "templates", "isTemplate": 1 }, "_WRITEBACK_PROPS": ["selected", "columnOrder", "currentCell", "columnWidths"], "_READ_ONLY_PROPS": ["currentCell"], "_OBSERVED_GLOBAL_PROPS": ["aria-label", "aria-labelledby", "id"] }, "events": { "ojRowAction": { "bubbles": true } } }, { "horizontalGridVisible": "enabled", "verticalGridVisible": "disabled", "layout": "contents", "selected": {}, "selectionMode": { "row": "none", "column": "none" }, "selectAllControl": "visible", "scrollPolicyOptions": { "fetchSize": 25 } }, {
+        '@oracle/oraclejet-preact': translationBundle_1.default
+    }, { consume: [UNSAFE_useCollectionInteractionContext_1.CollectionInteractionContext] });
+    const metadata = (0, ojcustomelement_registry_1.getMetadata)('oj-c-table');
+    metadata.properties.__oj_private_do_not_use_userAssistanceDensity = {
+        binding: {
+            provide: [
+                { name: 'containerUserAssistanceDensity', default: 'compact' },
+                { name: 'userAssistanceDensity', default: 'compact' }
+            ]
+        }
+    };
+});

package/oj-c/table.js

@@ -0,0 +1,6 @@
+define(["require", "exports", "oj-c/table/table"], function (require, exports, table_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.Table = void 0;
+    Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return table_1.Table; } });
+});

package/oj-c/tag-cloud/__webdriver__/TagCloudWebElementBase.d.ts

@@ -10,7 +10,7 @@ export declare class TagCloudWebElementBase extends OjWebElement {
      * Gets the value of <code>data</code> property.
      * Specifies the DataProvider for the sections and items of the tag-cloud
      * @return The value of <code>data</code> property.
-     *
+     * @deprecated Since 17.1.0. Data sets from a DataProvider cannot be sent to WebDriverJS; use ViewModels or page variables instead.
      */
     getData(): Promise<null>;
     /**

package/oj-c/tag-cloud/__webdriver__/TagCloudWebElementBase.js

@@ -13,7 +13,7 @@ class TagCloudWebElementBase extends elements_1.OjWebElement {
      * Gets the value of <code>data</code> property.
      * Specifies the DataProvider for the sections and items of the tag-cloud
      * @return The value of <code>data</code> property.
-     *
+     * @deprecated Since 17.1.0. Data sets from a DataProvider cannot be sent to WebDriverJS; use ViewModels or page variables instead.
      */
     getData() {
         return this.getProperty('data');

package/oj-c/tag-cloud/__webdriver__/TagCloudWebElementBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"TagCloudWebElementBase.js","sourceRoot":"","sources":["TagCloudWebElementBase.ts"],"names":[],"mappings":";;;AAAA,iEAAoE;AAEpE;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,uBAAY;IACtD;;;;;OAKG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,WAAW,CAAO,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,UAAU;QACf,OAAO,IAAI,CAAC,WAAW,CAAO,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,sBAAsB,CAAC,gBAA+B;QAC3D,OAAO,IAAI,CAAC,WAAW,CAAgB,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;OAKG;IACI,mBAAmB;QACxB,OAAO,IAAI,CAAC,WAAW,CAAgB,kBAAkB,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,WAAW,CAAS,gBAAgB,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACI,2BAA2B,CAAC,qBAAoC;QACrE,OAAO,IAAI,CAAC,WAAW,CAAgB,uBAAuB,EAAE,qBAAqB,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACI,wBAAwB;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAgB,uBAAuB,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAS,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,SAAqB;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAa,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,WAAW,CAAa,WAAW,CAAC,CAAC;IACnD,CAAC;CACF;AAlID,wDAkIC","sourcesContent":["import { OjWebElement } from '@oracle/oraclejet-webdriver/elements';\n\n/**\n * This is the base class for oj-c-tag-cloud 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, TagCloudWebElement.ts.\n */\nexport class TagCloudWebElementBase extends OjWebElement {\n  /**\n   * Gets the value of <code>data</code> property.\n   * Specifies the DataProvider for the sections and items of the tag-cloud\n   * @return The value of <code>data</code> property.\n   *\n   */\n  public getData(): Promise<null> {\n    return this.getProperty<null>('data');\n  }\n\n  /**\n   * Gets the value of <code>datatip</code> property.\n   *\n   * @return The value of <code>datatip</code> property.\n   *\n   */\n  public getDatatip(): Promise<null> {\n    return this.getProperty<null>('datatip');\n  }\n\n  /**\n   * Sets the value of <code>hiddenCategories</code> property.\n   * An array of categories that will be hidden.\n   * @param hiddenCategories The value to set for <code>hiddenCategories</code>\n   *\n   */\n  public changeHiddenCategories(hiddenCategories: Array<string>): Promise<void> {\n    return this.setProperty<Array<string>>('hiddenCategories', hiddenCategories);\n  }\n\n  /**\n   * Gets the value of <code>hiddenCategories</code> property.\n   * An array of categories that will be hidden.\n   * @return The value of <code>hiddenCategories</code> property.\n   *\n   */\n  public getHiddenCategories(): Promise<Array<string>> {\n    return this.getProperty<Array<string>>('hiddenCategories');\n  }\n\n  /**\n   * Gets the value of <code>touchResponse</code> property.\n   * Data visualizations require a press and hold delay before triggering tooltips and rollover effects on mobile devices to avoid interfering with page panning, but these hold delays can make applications seem slower and less responsive. For a better user experience, the application can remove the touch and hold delay when data visualizations are used within a non scrolling container or if there is sufficient space outside of the visualization for panning. If touchResponse is touchStart the element will instantly trigger the touch gesture and consume the page pan events. If touchResponse is auto, the element will behave like touchStart if it determines that it is not rendered within scrolling content and if element panning is not available for those elements that support the feature.\n   * @return The value of <code>touchResponse</code> property.\n   *\n   */\n  public getTouchResponse(): Promise<string> {\n    return this.getProperty<string>('touchResponse');\n  }\n\n  /**\n   * Gets the value of <code>highlightMatch</code> property.\n   * The matching condition for the highlightedCategories option. By default, highlightMatch is 'all' and only items whose categories match all of the values specified in the highlightedCategories array will be highlighted. If highlightMatch is 'any', then items that match at least one of the highlightedCategories values will be highlighted.\n   * @return The value of <code>highlightMatch</code> property.\n   *\n   */\n  public getHighlightMatch(): Promise<string> {\n    return this.getProperty<string>('highlightMatch');\n  }\n\n  /**\n   * Sets the value of <code>highlightedCategories</code> property.\n   * An array of categories that will be highlighted.\n   * @param highlightedCategories The value to set for <code>highlightedCategories</code>\n   *\n   */\n  public changeHighlightedCategories(highlightedCategories: Array<string>): Promise<void> {\n    return this.setProperty<Array<string>>('highlightedCategories', highlightedCategories);\n  }\n\n  /**\n   * Gets the value of <code>highlightedCategories</code> property.\n   * An array of categories that will be highlighted.\n   * @return The value of <code>highlightedCategories</code> property.\n   *\n   */\n  public getHighlightedCategories(): Promise<Array<string>> {\n    return this.getProperty<Array<string>>('highlightedCategories');\n  }\n\n  /**\n   * Gets the value of <code>hoverBehavior</code> property.\n   * Defines the behavior applied when hovering over data items.\n   * @return The value of <code>hoverBehavior</code> property.\n   *\n   */\n  public getHoverBehavior(): Promise<string> {\n    return this.getProperty<string>('hoverBehavior');\n  }\n\n  /**\n   * Gets the value of <code>layout</code> property.\n   * The layout to use for tag display.\n   * @return The value of <code>layout</code> property.\n   *\n   */\n  public getLayout(): Promise<string> {\n    return this.getProperty<string>('layout');\n  }\n\n  /**\n   * Gets the value of <code>selectionMode</code> property.\n   * Specifies the selection mode.\n   * @return The value of <code>selectionMode</code> property.\n   *\n   */\n  public getSelectionMode(): Promise<string> {\n    return this.getProperty<string>('selectionMode');\n  }\n\n  /**\n   * Sets the value of <code>selection</code> property.\n   * An array containing the ids of the initially selected data items.\n   * @param selection The value to set for <code>selection</code>\n   *\n   */\n  public changeSelection(selection: Array<any>): Promise<void> {\n    return this.setProperty<Array<any>>('selection', selection);\n  }\n\n  /**\n   * Gets the value of <code>selection</code> property.\n   * An array containing the ids of the initially selected data items.\n   * @return The value of <code>selection</code> property.\n   *\n   */\n  public getSelection(): Promise<Array<any>> {\n    return this.getProperty<Array<any>>('selection');\n  }\n}\n"]}
+{"version":3,"file":"TagCloudWebElementBase.js","sourceRoot":"","sources":["TagCloudWebElementBase.ts"],"names":[],"mappings":";;;AAAA,iEAAoE;AAEpE;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,uBAAY;IACtD;;;;;OAKG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,WAAW,CAAO,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,UAAU;QACf,OAAO,IAAI,CAAC,WAAW,CAAO,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACI,sBAAsB,CAAC,gBAA+B;QAC3D,OAAO,IAAI,CAAC,WAAW,CAAgB,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;OAKG;IACI,mBAAmB;QACxB,OAAO,IAAI,CAAC,WAAW,CAAgB,kBAAkB,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,WAAW,CAAS,gBAAgB,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACI,2BAA2B,CAAC,qBAAoC;QACrE,OAAO,IAAI,CAAC,WAAW,CAAgB,uBAAuB,EAAE,qBAAqB,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACI,wBAAwB;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAgB,uBAAuB,CAAC,CAAC;IAClE,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,CAAS,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,WAAW,CAAS,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,SAAqB;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAa,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,WAAW,CAAa,WAAW,CAAC,CAAC;IACnD,CAAC;CACF;AAlID,wDAkIC","sourcesContent":["import { OjWebElement } from '@oracle/oraclejet-webdriver/elements';\n\n/**\n * This is the base class for oj-c-tag-cloud 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, TagCloudWebElement.ts.\n */\nexport class TagCloudWebElementBase extends OjWebElement {\n  /**\n   * Gets the value of <code>data</code> property.\n   * Specifies the DataProvider for the sections and items of the tag-cloud\n   * @return The value of <code>data</code> property.\n   * @deprecated Since 17.1.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>datatip</code> property.\n   *\n   * @return The value of <code>datatip</code> property.\n   *\n   */\n  public getDatatip(): Promise<null> {\n    return this.getProperty<null>('datatip');\n  }\n\n  /**\n   * Sets the value of <code>hiddenCategories</code> property.\n   * An array of categories that will be hidden.\n   * @param hiddenCategories The value to set for <code>hiddenCategories</code>\n   *\n   */\n  public changeHiddenCategories(hiddenCategories: Array<string>): Promise<void> {\n    return this.setProperty<Array<string>>('hiddenCategories', hiddenCategories);\n  }\n\n  /**\n   * Gets the value of <code>hiddenCategories</code> property.\n   * An array of categories that will be hidden.\n   * @return The value of <code>hiddenCategories</code> property.\n   *\n   */\n  public getHiddenCategories(): Promise<Array<string>> {\n    return this.getProperty<Array<string>>('hiddenCategories');\n  }\n\n  /**\n   * Gets the value of <code>touchResponse</code> property.\n   * Data visualizations require a press and hold delay before triggering tooltips and rollover effects on mobile devices to avoid interfering with page panning, but these hold delays can make applications seem slower and less responsive. For a better user experience, the application can remove the touch and hold delay when data visualizations are used within a non scrolling container or if there is sufficient space outside of the visualization for panning. If touchResponse is touchStart the element will instantly trigger the touch gesture and consume the page pan events. If touchResponse is auto, the element will behave like touchStart if it determines that it is not rendered within scrolling content and if element panning is not available for those elements that support the feature.\n   * @return The value of <code>touchResponse</code> property.\n   *\n   */\n  public getTouchResponse(): Promise<string> {\n    return this.getProperty<string>('touchResponse');\n  }\n\n  /**\n   * Gets the value of <code>highlightMatch</code> property.\n   * The matching condition for the highlightedCategories option. By default, highlightMatch is 'all' and only items whose categories match all of the values specified in the highlightedCategories array will be highlighted. If highlightMatch is 'any', then items that match at least one of the highlightedCategories values will be highlighted.\n   * @return The value of <code>highlightMatch</code> property.\n   *\n   */\n  public getHighlightMatch(): Promise<string> {\n    return this.getProperty<string>('highlightMatch');\n  }\n\n  /**\n   * Sets the value of <code>highlightedCategories</code> property.\n   * An array of categories that will be highlighted.\n   * @param highlightedCategories The value to set for <code>highlightedCategories</code>\n   *\n   */\n  public changeHighlightedCategories(highlightedCategories: Array<string>): Promise<void> {\n    return this.setProperty<Array<string>>('highlightedCategories', highlightedCategories);\n  }\n\n  /**\n   * Gets the value of <code>highlightedCategories</code> property.\n   * An array of categories that will be highlighted.\n   * @return The value of <code>highlightedCategories</code> property.\n   *\n   */\n  public getHighlightedCategories(): Promise<Array<string>> {\n    return this.getProperty<Array<string>>('highlightedCategories');\n  }\n\n  /**\n   * Gets the value of <code>hoverBehavior</code> property.\n   * Defines the behavior applied when hovering over data items.\n   * @return The value of <code>hoverBehavior</code> property.\n   *\n   */\n  public getHoverBehavior(): Promise<string> {\n    return this.getProperty<string>('hoverBehavior');\n  }\n\n  /**\n   * Gets the value of <code>layout</code> property.\n   * The layout to use for tag display.\n   * @return The value of <code>layout</code> property.\n   *\n   */\n  public getLayout(): Promise<string> {\n    return this.getProperty<string>('layout');\n  }\n\n  /**\n   * Gets the value of <code>selectionMode</code> property.\n   * Specifies the selection mode.\n   * @return The value of <code>selectionMode</code> property.\n   *\n   */\n  public getSelectionMode(): Promise<string> {\n    return this.getProperty<string>('selectionMode');\n  }\n\n  /**\n   * Sets the value of <code>selection</code> property.\n   * An array containing the ids of the initially selected data items.\n   * @param selection The value to set for <code>selection</code>\n   *\n   */\n  public changeSelection(selection: Array<any>): Promise<void> {\n    return this.setProperty<Array<any>>('selection', selection);\n  }\n\n  /**\n   * Gets the value of <code>selection</code> property.\n   * An array containing the ids of the initially selected data items.\n   * @return The value of <code>selection</code> property.\n   *\n   */\n  public getSelection(): Promise<Array<any>> {\n    return this.getProperty<Array<any>>('selection');\n  }\n}\n"]}

package/oj-c/tag-cloud/component.json

@@ -1,7 +1,7 @@
 {
   "name": "tag-cloud",
-  "version": "17.0.4",
-  "jetVersion": "^17.0.4",
+  "version": "17.1.0",
+  "jetVersion": "^17.1.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",
@@ -35,7 +35,7 @@
       ]
     },
     "webelement": {
-      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1700/cpwdtsdoc/classes/TagCloudWebElement.html"
+      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1710/cpwdtsdoc/classes/TagCloudWebElement.html"
     }
   },
   "propertyLayout": [
@@ -61,6 +61,17 @@
       "description": "Specifies the DataProvider for the sections and items of the tag-cloud",
       "displayName": "Data",
       "help": "#data",
+      "extension": {
+        "webelement": {
+          "exceptionStatus": [
+            {
+              "type": "deprecated",
+              "since": "17.1.0",
+              "description": "Data sets from a DataProvider cannot be sent to WebDriverJS; use ViewModels or page variables instead."
+            }
+          ]
+        }
+      },
       "value": null
     },
     "datatip": {

package/oj-c/tag-cloud/tag-cloud.js

@@ -2,7 +2,10 @@ define(["require", "exports", "preact/jsx-runtime", '@oracle/oraclejet-preact/tr
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.TagCloud = void 0;
-    function TagCloudComp({ hiddenCategories = [], data = null, highlightedCategories = [], hoverBehavior = 'none', layout = 'rectangular', selection = [], selectionMode = 'none', highlightMatch = 'all', ...props }) {
+    const HIGHLIGHTED_DEFAULT = [];
+    const SELECTION_DEFAULT = [];
+    const HIDDEN_DEFAULT = [];
+    function TagCloudComp({ hiddenCategories = HIDDEN_DEFAULT, data = null, highlightedCategories = HIGHLIGHTED_DEFAULT, hoverBehavior = 'none', layout = 'rectangular', selection = SELECTION_DEFAULT, selectionMode = 'none', highlightMatch = 'all', ...props }) {
         const rootRef = (0, hooks_1.useRef)(null);
         const addBusyState = (0, useVisBusyState_1.useVisBusyState)(rootRef, 'oj-c-tag-cloud');
         const { data: compData } = (0, useDataProvider_1.useDataProvider)({

package/oj-c/tag-cloud-item/component.json

@@ -1,7 +1,7 @@
 {
   "name": "tag-cloud-item",
-  "version": "17.0.4",
-  "jetVersion": "^17.0.4",
+  "version": "17.1.0",
+  "jetVersion": "^17.1.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",

package/oj-c/text-area/component.json

@@ -1,7 +1,7 @@
 {
   "name": "text-area",
-  "version": "17.0.4",
-  "jetVersion": "^17.0.4",
+  "version": "17.1.0",
+  "jetVersion": "^17.1.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",
@@ -26,7 +26,7 @@
       "icon": "oj-ux-ico-text-input-area"
     },
     "webelement": {
-      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1700/cpwdtsdoc/classes/TextAreaWebElement.html"
+      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1710/cpwdtsdoc/classes/TextAreaWebElement.html"
     }
   },
   "since": "13.0.0",

package/oj-c/text-area/useTextAreaAutosizePreact.js

@@ -1,4 +1,4 @@
-define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators"], function (require, exports, index_1, useDeferredValidators_1) {
+define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/editable-value/utils/utils", "oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators"], function (require, exports, index_1, utils_1, useDeferredValidators_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.useTextAreaAutosizePreact = void 0;
@@ -18,7 +18,7 @@ define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/
             displayOptions,
             messagesCustom,
             readonly,
-            validators: validators === null ? undefined : validators,
+            validators: (0, utils_1.treatNull)(validators, undefined),
             value: propValue,
             onMessagesCustomChanged,
             onRawValueChanged,

package/oj-c/text-area/useTextAreaPreact.js

@@ -1,4 +1,4 @@
-define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators"], function (require, exports, index_1, useDeferredValidators_1) {
+define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/editable-value/utils/utils", "oj-c/editable-value/UNSAFE_useDeferredValidators/useDeferredValidators"], function (require, exports, index_1, utils_1, useDeferredValidators_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.useTextAreaPreact = void 0;
@@ -18,7 +18,7 @@ define(["require", "exports", "oj-c/hooks/UNSAFE_useEditableValue/index", "oj-c/
             displayOptions,
             messagesCustom,
             readonly,
-            validators: validators === null ? undefined : validators,
+            validators: (0, utils_1.treatNull)(validators, undefined),
             value: propValue,
             onMessagesCustomChanged,
             onRawValueChanged,

package/oj-c/toggle-button/component.json

@@ -1,7 +1,7 @@
 {
   "name": "toggle-button",
-  "version": "17.0.4",
-  "jetVersion": "^17.0.4",
+  "version": "17.1.0",
+  "jetVersion": "^17.1.0",
   "pack": "oj-c",
   "type": "composite",
   "dependencyScope": "runtime",
@@ -27,7 +27,7 @@
       ]
     },
     "webelement": {
-      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1700/cpwdtsdoc/classes/ToggleButtonWebElement.html"
+      "docUrl": "https://www.oracle.com/webfolder/technetwork/jet-1710/cpwdtsdoc/classes/ToggleButtonWebElement.html"
     }
   },
   "propertyLayout": [

package/oj-c/types/FormControlWrapper/FormControlWrapper.d.ts

@@ -0,0 +1,36 @@
+import { ComponentChildren } from 'preact';
+import { ComponentMessageItem } from '@oracle/oraclejet-preact/UNSAFE_ComponentMessage';
+import type { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
+import { type ValidState } from 'oj-c/hooks/UNSAFE_useEditableValue/index';
+import type { ValueUpdateDetail } from '@oracle/oraclejet-preact/utils/UNSAFE_valueUpdateDetail';
+import Validator = require('ojs/ojvalidator');
+type ContentRendererContext<V> = {
+    isReadonly: boolean;
+    labelId: string;
+    userAssistanceId: string;
+    onCommit: (detail: ValueUpdateDetail<V | undefined>) => Promise<boolean>;
+    showMessages: () => void;
+    validate: () => Promise<'valid' | 'invalid'>;
+};
+type FormControlWrapperProps<V> = {
+    children: (rendererContext: ContentRendererContext<V>) => ComponentChildren;
+    containerReadonly?: boolean;
+    deferredValidators?: Validator<V>[];
+    disabled?: boolean;
+    labelHint: string;
+    labelEdge?: 'start' | 'top' | 'inside';
+    labelStartWidth?: Size;
+    labelWrapping?: 'truncate' | 'wrap';
+    messagesCustom?: ComponentMessageItem[];
+    readonly?: boolean;
+    required?: boolean;
+    userAssistanceDensity?: 'reflow' | 'efficient' | 'compact';
+    value?: V;
+    onLabelClick?: (e: MouseEvent) => void;
+    onMessagesCustomChanged?: (messagesCustom: ComponentMessageItem[] | undefined) => void;
+    onValidChanged?: (valid: ValidState) => void;
+    onValueChanged?: (value: V | undefined) => void;
+};
+declare function FormControlWrapper<V>({ children, containerReadonly: propContainerReadonly, deferredValidators, disabled, labelHint, labelEdge: propLabelEdge, labelStartWidth: propLabelStartWidth, labelWrapping: propLabelWrapping, messagesCustom, onLabelClick, onMessagesCustomChanged, onValidChanged, onValueChanged, readonly: propReadonly, required, userAssistanceDensity: propUserAssistanceDensity, value: propValue }: FormControlWrapperProps<V>): import("preact").JSX.Element;
+export type { ContentRendererContext, FormControlWrapperProps, ValidState };
+export { FormControlWrapper };

package/oj-c/types/FormControlWrapper/index.d.ts

@@ -0,0 +1,2 @@
+export { FormControlWrapper } from './FormControlWrapper';
+export type { ContentRendererContext, FormControlWrapperProps, ValidState } from './FormControlWrapper';