@oracle/oraclejet-core-pack 17.1.3 → 18.0.0

package/oj-c/MenuButton.json

@@ -379,14 +379,35 @@
       ]
     }
   },
+  {
+    "memberof": "oj-c.MenuButton",
+    "id": "oj-c.MenuButton#focus",
+    "name": "focus",
+    "kind": "function",
+    "longname": "oj-c.MenuButton#focus",
+    "description": "",
+    "meta": {
+      "filename": "menu-button.tsx",
+      "path": "web/components/oj-c/menu-button"
+    },
+    "scope": "instance",
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "void"
+          ]
+        }
+      }
+    ]
+  },
   {
     "memberof": "oj-c.MenuButton",
     "id": "oj-c.MenuButton#blur",
     "name": "blur",
     "kind": "function",
     "longname": "oj-c.MenuButton#blur",
-    "description": "blurs the button",
-    "ojhidden": true,
+    "description": "",
     "meta": {
       "filename": "menu-button.tsx",
       "path": "web/components/oj-c/menu-button"
@@ -396,7 +417,7 @@
       {
         "type": {
           "names": [
-            "any"
+            "void"
           ]
         }
       }
@@ -404,12 +425,11 @@
   },
   {
     "memberof": "oj-c.MenuButton",
-    "id": "oj-c.MenuButton#focus",
-    "name": "focus",
+    "id": "oj-c.MenuButton#click",
+    "name": "click",
     "kind": "function",
-    "longname": "oj-c.MenuButton#focus",
-    "description": "focuses the button",
-    "ojhidden": true,
+    "longname": "oj-c.MenuButton#click",
+    "description": "",
     "meta": {
       "filename": "menu-button.tsx",
       "path": "web/components/oj-c/menu-button"
@@ -419,7 +439,7 @@
       {
         "type": {
           "names": [
-            "any"
+            "void"
           ]
         }
       }
@@ -541,6 +561,47 @@
       }
     ]
   },
+  {
+    "memberof": "oj-c.MenuButton",
+    "id": "oj-c.MenuButton#event:ojMenuSelection",
+    "name": "ojMenuSelection",
+    "kind": "event",
+    "longname": "oj-c.MenuButton#event:ojMenuSelection",
+    "description": "Triggered when a menu selection group item is clicked, whether by keyboard, mouse, or touch events. Detail indicates new selection value for group.",
+    "meta": {
+      "filename": "menu-button.tsx",
+      "path": "web/components/oj-c/menu-button"
+    },
+    "scope": "instance",
+    "properties": [
+      {
+        "name": "value",
+        "optional": false,
+        "type": {
+          "names": [
+            "any"
+          ]
+        },
+        "tstype": [
+          {
+            "target": "Type",
+            "value": "T",
+            "jsdocOverride": true,
+            "for": "value"
+          }
+        ]
+      },
+      {
+        "name": "menuSelectionGroupKey",
+        "optional": false,
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      }
+    ]
+  },
   {
     "memberof": "oj-c.MenuButton",
     "id": "oj-c.MenuButton#startIcon",
@@ -774,6 +835,16 @@
       "path": "web/components/oj-c/menu-button"
     },
     "properties": [
+      {
+        "name": "key",
+        "description": "A unique key associated with the submenu menu item.",
+        "optional": true,
+        "type": {
+          "names": [
+            "string"
+          ]
+        }
+      },
       {
         "name": "type",
         "description": "Specifies a submenu menu item.",

package/oj-c/MessageBanner.json

@@ -335,7 +335,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [
@@ -411,7 +411,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [
@@ -591,7 +591,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [

package/oj-c/MessageToast.json

@@ -193,8 +193,8 @@
         "\"bottom\"",
         "\"top-start\"",
         "\"top-end\"",
-        "\"bottom-end\"",
         "\"bottom-start\"",
+        "\"bottom-end\"",
         "\"top-left\"",
         "\"top-right\"",
         "\"bottom-left\"",
@@ -331,7 +331,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [
@@ -407,7 +407,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [
@@ -605,7 +605,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [

package/oj-c/Popup.json

@@ -6,7 +6,7 @@
     "memberof": "oj-c",
     "longname": "oj-c.Popup",
     "kind": "class",
-    "classdesc": "<h3 id=\"popupOverview-section\">\n  JET Popup\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#popupOverview-section\"></a>\n</h3>\n<p>Description: A popup temporarily 'pops up' content in the foreground.</p>\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-popup>\n   Popup content\n&lt;/oj-c-popup>\n\n&lt;oj-c-popup edge=\"end\" opened=\"true\">\n   Opened Popup\n&lt;/oj-c-popup>\n\n&lt;oj-c-popup placement=\"bottom\">\n   Popup positioned at the bottom of the anchor\n&lt;/oj-c-popup>\n\nMain section content\n</code></pre>\n\n<p id=\"popup-section\">A popup temporarily 'pops up' content in the foreground.</p>\n\n<h3 id=\"keyboard-section\">\n  Keyboard End User Information\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#keyboard-section\"></a>\n</h3>\n<table class=\"keyboard-table\">\n <thead>\n   <tr>\n     <th>Target</th>\n     <th>Key</th>\n     <th>Action</th>\n   </tr>\n </thead>\n <tbody>\n   <tr>\n      <td rowspan = \"3\">Focus within Popup</td>\n      <td><kbd>Tab</kbd> or <kbd>Shift + Tab</kbd></td>\n      <td>Navigate the content of the popup.</td>\n   </tr>\n   <tr>\n     <td><kbd>F6</kbd></td>\n     <td>Move focus to the launcher for a popup with modeless modality.</td>\n   </tr>\n   <tr>\n     <td><kbd>Esc</kbd></td>\n     <td>Close the open popup.</td>\n   </tr>\n   <tr>\n     <td rowspan = \"1\">Popup Launcher</td>\n     <td><kbd>F6</kbd></td>\n     <td>Move focus to the first tab stop within the open popup. If there is not a tab stop\n         within the content, focus is established on the popup.</td>\n    </tr>\n </tbody>\n</table>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>For WAI-ARIA compliance, JET automatically adds\n<code class=\"prettyprint\">role=\"tooltip\"</code> to the non-modal popup root dom element, or\n<code class=\"prettyprint\">role=\"dialog\"</code> to the modal popup root dom element, if not\nalready specificed. This is not a component property but rather the standard html\n<a href=\"https://www.w3.org/WAI/PF/aria/roles\">role</a> attribute. Depending on how the\npopup is used in the page, the page developer should choose from the following when overriding\nthe default values:\n<ul>\n  <li>\"tooltip\" defines contextual popup that displays a description for an element.\n      Although this is the default role for non-modal popups, it should only be used\n      for popups that include simple textual content and no interactive elements.\n      The \"tooltip\" role should never be used with modal popups.</li>\n  <li>\"dialog\" defines an application window that is designed to interrupt the current\n      processing of an application in order to prompt the user to enter information or\n      require a response. It is the default role for modal popups, but can (and should) be used\n      for non-modal windows too, if the popup includes interactive content.</li>\n  <li>\"alertdialog\" defines type of popup that contains an alert message, where initial focus\n      goes to an element within the popup.</li>\n</ul>\n</p>\n<p>\n The page developer should consider adding the aria-haspopup=\"dialog\" to the launcher element.\n</p>\n<p>\nDepending on the aria role and popup content, the page developer may also need to\nset the <code class=\"prettyprint\">aria-labelledby</code> and (optionally)\n<code class=\"prettyprint\">aria-describedby</code> attributes on the oj-popup\nelement in order to make the popup and its content accessible.\n</p>\n\n<p>One point often overlooked is making the gestures that launch a popup accessible.\n  There are no constraints to what events a page developer might choose to trigger opening a\n  popup.  The choice should be accessible for screen reader users.  Page\n  developers should take care when using mouse events to trigger opening of a popup.\n  This is especially important if the content of the popup can't be derived from other\n  visible areas on the page. In cases that mouseover, mouseout, mouseenter, mouseleave and\n  hover events are used to launch popups, there needs to be a keyboard functional equivalency.\n</p>\n\n<h3 id=\"reparenting-section\">\n  Reparenting\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#reparenting-section\"></a>\n</h3>\n<p id=\"reparenting-strategy\">\n   When popups are open, they will be reparented in the document and reparented back when\n   closed. When open, the location of the popup within the document will be in context of\n   how it's used. Popups open from other popups will be relocated in the document into the\n   nearest parent popup's layer. The popups layer defines its z-index weight \"stacking\n   context\".  The ojPopup's layer is marked with the \"oj-popup-layer\" style.\n   The context of opening is defined by the launcher argument passed to the open method.  If\n   not open from another popup, the popup will be reparented to a container in the document\n   body. Popups of the same type are assigned the same z-index values.  The layering between\n   peer popups reflect the opening order.\n</p>\n<p>\n    There are known caveats with this design. However, these scenarios are considered \"bad use\"\n    based on our JET popup strategy.\n </p>\n <ol>\n   <li>Events raised within the popup will not bubble up to the popup's original ancestors.\n       Instead, listeners for popup events should be applied to either the popup's root\n       element, or the document.</li>\n   <li>Likewise, developers should not use CSS descendant selectors, or similar logic, that\n       assumes that the popup will remain a child of its original parent.</li>\n   <li>Popups containing iframes are problematic.  The iframe elements \"may\" fire a HTTP GET\n       request for its src attribute each time the iframe is reparented in the document.</li>\n   <li>If an iframe is added to the popup's content, it must not be the first or last tab stop\n       within the popup or keyboard and VoiceOver navigation will not remain within the popup.</li>\n   <li>In some browsers, reparenting a popup that contains elements having overflow, will cause\n       these overflow elements to reset their scrollTop.</li>\n </ol>\n\n<h3 id=\"eventHandling-section\">\n  Event Handling\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#eventHandling-section\"></a>\n</h3>\n<ul>\n <li>ojBeforeClose(event) - Triggered before a popup closes. Event can prevent closing the\n     popup; However, there are cases the framework must veto, such as when the popup is\n     destroyed.</li>\n <li>ojClose(event) - Triggered after the popup has closed.</li>\n <li>ojFocus(event) - Triggered when initial focus is established on opening, depending on\n     the value of the initalFocus property, or <kbd>F6</kbd> focus toggle from the associated\n     launcher.</li>\n <li>ojOpen(event) - Triggered after the popup has been made visible.</li>\n</ul>\n\n<h3 id=\"rtl-section\">\n  Reading direction\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#rtl-section\"></a>\n</h3>\n\n<p> Setting the reading direction (LTR or RTL) is supported by setting the <code class=\"prettyprint\">\"dir\"</code> attribute on the\n<code class=\"prettyprint\">&lt;html></code> element of the page. As with any JET component, in the unusual case that the reading direction\nis changed post-init, the page must be reloaded.",
+    "classdesc": "<h3 id=\"popupOverview-section\">\n  JET Popup\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#popupOverview-section\"></a>\n</h3>\n<p>Description: A popup temporarily 'pops up' content in the foreground.</p>\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-popup>\n   Popup content\n&lt;/oj-c-popup>\n\n&lt;oj-c-popup opened=\"true\">\n   Opened Popup\n&lt;/oj-c-popup>\n\n&lt;oj-c-popup placement=\"bottom\">\n   Popup positioned at the bottom of the anchor\n&lt;/oj-c-popup>\n\nMain section content\n</code></pre>\n\n<p id=\"popup-section\">A popup temporarily 'pops up' content in the foreground.</p>\n\n<h3 id=\"keyboard-section\">\n  Keyboard End User Information\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#keyboard-section\"></a>\n</h3>\n<table class=\"keyboard-table\">\n <thead>\n   <tr>\n     <th>Target</th>\n     <th>Key</th>\n     <th>Action</th>\n   </tr>\n </thead>\n <tbody>\n   <tr>\n      <td rowspan = \"3\">Focus within Popup</td>\n      <td><kbd>Tab</kbd> or <kbd>Shift + Tab</kbd></td>\n      <td>Navigate the content of the popup.</td>\n   </tr>\n   <tr>\n     <td><kbd>F6</kbd></td>\n     <td>Move focus to the launcher for a popup with modeless modality.</td>\n   </tr>\n   <tr>\n     <td><kbd>Esc</kbd></td>\n     <td>Close the open popup.</td>\n   </tr>\n   <tr>\n     <td rowspan = \"1\">Popup Launcher</td>\n     <td><kbd>F6</kbd></td>\n     <td>Move focus to the first tab stop within the open popup. If there is not a tab stop\n         within the content, focus is established on the popup.</td>\n    </tr>\n </tbody>\n</table>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>For WAI-ARIA compliance, JET automatically adds\n<code class=\"prettyprint\">role=\"tooltip\"</code> to the non-modal popup root dom element, or\n<code class=\"prettyprint\">role=\"dialog\"</code> to the modal popup root dom element, if not\nalready specificed. This is not a component property but rather the standard html\n<a href=\"https://www.w3.org/WAI/PF/aria/roles\">role</a> attribute. Depending on how the\npopup is used in the page, the page developer should choose from the following when overriding\nthe default values:\n<ul>\n  <li>\"tooltip\" defines contextual popup that displays a description for an element.\n      Although this is the default role for non-modal popups, it should only be used\n      for popups that include simple textual content and no interactive elements.\n      The \"tooltip\" role should never be used with modal popups.</li>\n  <li>\"dialog\" defines an application window that is designed to interrupt the current\n      processing of an application in order to prompt the user to enter information or\n      require a response. It is the default role for modal popups, but can (and should) be used\n      for non-modal windows too, if the popup includes interactive content.</li>\n  <li>\"alertdialog\" defines type of popup that contains an alert message, where initial focus\n      goes to an element within the popup.</li>\n</ul>\n</p>\n<p>\n The page developer should consider adding the aria-haspopup=\"dialog\" to the launcher element.\n</p>\n<p>\nDepending on the aria role and popup content, the page developer may also need to\nset the <code class=\"prettyprint\">aria-labelledby</code> and (optionally)\n<code class=\"prettyprint\">aria-describedby</code> attributes on the oj-popup\nelement in order to make the popup and its content accessible.\n</p>\n\n<p>One point often overlooked is making the gestures that launch a popup accessible.\n  There are no constraints to what events a page developer might choose to trigger opening a\n  popup.  The choice should be accessible for screen reader users.  Page\n  developers should take care when using mouse events to trigger opening of a popup.\n  This is especially important if the content of the popup can't be derived from other\n  visible areas on the page. In cases that mouseover, mouseout, mouseenter, mouseleave and\n  hover events are used to launch popups, there needs to be a keyboard functional equivalency.\n</p>\n\n<h3 id=\"reparenting-section\">\n  Reparenting\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#reparenting-section\"></a>\n</h3>\n<p id=\"reparenting-strategy\">\n   When popups are open, they will be reparented in the document and reparented back when\n   closed. When open, the location of the popup within the document will be in context of\n   how it's used. Popups open from other popups will be relocated in the document into the\n   nearest parent popup's layer. The popups layer defines its z-index weight \"stacking\n   context\".  The ojPopup's layer is marked with the \"oj-popup-layer\" style.\n   The context of opening is defined by the launcher argument passed to the open method.  If\n   not open from another popup, the popup will be reparented to a container in the document\n   body. Popups of the same type are assigned the same z-index values.  The layering between\n   peer popups reflect the opening order.\n</p>\n<p>\n    There are known caveats with this design. However, these scenarios are considered \"bad use\"\n    based on our JET popup strategy.\n </p>\n <ol>\n   <li>Events raised within the popup will not bubble up to the popup's original ancestors.\n       Instead, listeners for popup events should be applied to either the popup's root\n       element, or the document.</li>\n   <li>Likewise, developers should not use CSS descendant selectors, or similar logic, that\n       assumes that the popup will remain a child of its original parent.</li>\n   <li>Popups containing iframes are problematic.  The iframe elements \"may\" fire a HTTP GET\n       request for its src attribute each time the iframe is reparented in the document.</li>\n   <li>If an iframe is added to the popup's content, it must not be the first or last tab stop\n       within the popup or keyboard and VoiceOver navigation will not remain within the popup.</li>\n   <li>In some browsers, reparenting a popup that contains elements having overflow, will cause\n       these overflow elements to reset their scrollTop.</li>\n </ol>\n\n<h3 id=\"eventHandling-section\">\n  Event Handling\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#eventHandling-section\"></a>\n</h3>\n<ul>\n <li>ojBeforeClose(event) - Triggered before a popup closes. Event can prevent closing the\n     popup; However, there are cases the framework must veto, such as when the popup is\n     destroyed.</li>\n <li>ojClose(event) - Triggered after the popup has closed.</li>\n <li>ojFocus(event) - Triggered when initial focus is established on opening, depending on\n     the value of the initalFocus property, or <kbd>F6</kbd> focus toggle from the associated\n     launcher.</li>\n <li>ojOpen(event) - Triggered after the popup has been made visible.</li>\n</ul>\n\n<h3 id=\"rtl-section\">\n  Reading direction\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#rtl-section\"></a>\n</h3>\n\n<p> Setting the reading direction (LTR or RTL) is supported by setting the <code class=\"prettyprint\">\"dir\"</code> attribute on the\n<code class=\"prettyprint\">&lt;html></code> element of the page. As with any JET component, in the unusual case that the reading direction\nis changed post-init, the page must be reloaded.",
     "scope": "static",
     "tagWithoutBrackets": "oj-c-popup",
     "tagWithBrackets": "<oj-c-popup>",
@@ -95,7 +95,7 @@
     "longname": "oj-c.Popup#anchor",
     "optional": true,
     "scope": "instance",
-    "description": "Specifies Popup's anchor. Popup is placed relatively to its anchor.",
+    "description": "Specifies Popup's anchor. Popup is placed relative to its anchor.",
     "meta": {
       "filename": "popup.tsx",
       "path": "web/components/oj-c/popup"
@@ -121,7 +121,7 @@
     "longname": "oj-c.Popup#placement",
     "optional": true,
     "scope": "instance",
-    "description": "Specifies displacement of the Popup from the anchor element placement along the specified axes.\nThe offset object consists of mainAxis and crossAxis properties. The direction in which these properties\nare applied depends on the current value of the position property.\n\nThe <code>mainAxis</code> property represents the distance between the Popup and the anchor.\nThe <code>crossAxis</code> property represents the deviation in the opposite axis to the main axis - the skidding between the Popup and the anchor.",
+    "description": "<p>Specifies the location the popup will appear relative to another element.</p>\n\n<p>If not specified, the default popup position is \"center\" on desktop and \"bottom-start\" on phone.</p>",
     "meta": {
       "filename": "popup.tsx",
       "path": "web/components/oj-c/popup"
@@ -135,14 +135,14 @@
         "\"bottom\"",
         "\"top-start\"",
         "\"top-end\"",
-        "\"bottom-end\"",
-        "\"bottom-start\"",
         "\"top-start-corner\"",
         "\"top-end-corner\"",
         "\"start-top\"",
         "\"start-bottom\"",
         "\"start-top-corner\"",
         "\"start-bottom-corner\"",
+        "\"bottom-start\"",
+        "\"bottom-end\"",
         "\"bottom-start-corner\"",
         "\"bottom-end-corner\"",
         "\"end-top\"",
@@ -253,13 +253,13 @@
     },
     "type": {
       "names": [
-        "object"
+        "number|object"
       ]
     },
     "tstype": [
       {
         "target": "Type",
-        "value": "oj-c.Popup.PopupOffset",
+        "value": "number|{ mainAxis?: number; crossAxis?: number; }",
         "jsdocOverride": true
       }
     ]
@@ -641,43 +641,5 @@
         ]
       }
     ]
-  },
-  {
-    "memberof": "oj-c.Popup",
-    "id": "oj-c.Popup.PopupOffset",
-    "name": "PopupOffset",
-    "kind": "typedef",
-    "longname": "oj-c.Popup.PopupOffset",
-    "scope": "static",
-    "description": "",
-    "type": {
-      "names": [
-        "Object"
-      ]
-    },
-    "meta": {
-      "filename": "popup.tsx",
-      "path": "web/components/oj-c/popup"
-    },
-    "properties": [
-      {
-        "name": "x",
-        "optional": true,
-        "type": {
-          "names": [
-            "number"
-          ]
-        }
-      },
-      {
-        "name": "y",
-        "optional": true,
-        "type": {
-          "names": [
-            "number"
-          ]
-        }
-      }
-    ]
   }
 ]

package/oj-c/ProgressBar.json

@@ -6,7 +6,7 @@
     "memberof": "oj-c",
     "longname": "oj-c.ProgressBar",
     "kind": "class",
-    "classdesc": "<h3 id=\"progressBarOverview-section\">\n  JET Progress Bar\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#progressBarOverview-section\"></a>\n</h3>\nThe oj-c-progress-bar element allows a user to display progress of an operation in a rectangular horizontal meter.\nIf a developer does not wish to display the exact value, a value of '-1' can be passed in to display an indeterminate value.\n\n<pre class=\"prettyprint\"><code>&lt;oj-c-progress-bar value='{{progressValue}}'>&lt;/oj-c-progress-bar></code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>If this element is being used to describe the loading process of a particular region of a page, then the <code class=\"prettyprint\">aria-describedby</code>\n   attribute of the region must point to the id of the oj-c-progress-bar and <code class=\"prettyprint\">aria-busy = \"true\"</code> must be added to the region until the loading is complete.</p>",
+    "classdesc": "<h3 id=\"progressBarOverview-section\">\n  JET Progress Bar\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#progressBarOverview-section\"></a>\n</h3>\nThe oj-c-progress-bar element allows a user to display progress of an operation in a rectangular horizontal meter.\nIf a developer does not wish to display the exact value, a value of '-1' can be passed in to display an indeterminate value.\n\n<pre class=\"prettyprint\"><code>&lt;oj-c-progress-bar value='{{progressValue}}'>&lt;/oj-c-progress-bar></code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>\nThe application is required to populate the aria-label or aria-labelledby attribute on the element with meaningful descriptors as\nthe oj-c-progress-bar element does not provide a default descriptor.\n</p>\n\n<p>If this element is being used to describe the loading process of a particular region of a page, then the <code class=\"prettyprint\">aria-describedby</code>\n   attribute of the region must point to the id of the oj-c-progress-bar and <code class=\"prettyprint\">aria-busy = \"true\"</code> must be added to the region until the loading is complete.</p>",
     "scope": "static",
     "tagWithoutBrackets": "oj-c-progress-bar",
     "tagWithBrackets": "<oj-c-progress-bar>",

package/oj-c/ProgressCircle.json

@@ -6,7 +6,7 @@
     "memberof": "oj-c",
     "longname": "oj-c.ProgressCircle",
     "kind": "class",
-    "classdesc": "<h3 id=\"progressCircleOverview-section\">\n  JET Progress Circle\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#progressCircleOverview-section\"></a>\n</h3>\nThe oj-c-progress-circle element allows a user to display progress of an operation with a circular meter.\nIf a developer does not wish to display the exact value, a value of '-1' can be passed in to display an indeterminate value.\n\n<pre class=\"prettyprint\"><code>&lt;oj-c-progress-circle value='{{progressValue}}'>&lt;/oj-c-progress-circle></code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>If this element is being used to describe the loading process of a particular region of a page, then the <code class=\"prettyprint\">aria-describedby</code>\n   attribute of the region must point to the id of the oj-progress-circle and <code class=\"prettyprint\">aria-busy = \"true\"</code> must be added to the region until the loading is complete.</p>",
+    "classdesc": "<h3 id=\"progressCircleOverview-section\">\n  JET Progress Circle\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#progressCircleOverview-section\"></a>\n</h3>\nThe oj-c-progress-circle element allows a user to display progress of an operation with a circular meter.\nIf a developer does not wish to display the exact value, a value of '-1' can be passed in to display an indeterminate value.\n\n<pre class=\"prettyprint\"><code>&lt;oj-c-progress-circle value='{{progressValue}}'>&lt;/oj-c-progress-circle></code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>\nThe application is required to populate the aria-label or aria-labelledby attribute on the element with meaningful descriptors as\nthe oj-c-progress-bar element does not provide a default descriptor.\n</p>\n\n<p>If this element is being used to describe the loading process of a particular region of a page, then the <code class=\"prettyprint\">aria-describedby</code>\n   attribute of the region must point to the id of the oj-progress-circle and <code class=\"prettyprint\">aria-busy = \"true\"</code> must be added to the region until the loading is complete.</p>",
     "scope": "static",
     "tagWithoutBrackets": "oj-c-progress-circle",
     "tagWithBrackets": "<oj-c-progress-circle>",

package/oj-c/Radioset.json

@@ -316,6 +316,13 @@
       "filename": "radioset.tsx",
       "path": "web/components/oj-c/radioset"
     },
+    "tsdeprecated": [
+      {
+        "type": "deprecated",
+        "since": "18.0.0",
+        "description": "Label truncation for 'start' and 'top' aligned labels is no longer recommended by the Redwood Design System. The default for labelWrapping was 'wrap' and that is now the only suggested pattern by UX design for 'start' and 'top' aligned labels. 'inside' aligned labels are always truncated per UX design and are not affected by this property's value."
+      }
+    ],
     "ojvalues": [
       {
         "name": "truncate",
@@ -596,7 +603,7 @@
     "defaultvalue": null,
     "type": {
       "names": [
-        "any"
+        "string|number|null"
       ]
     },
     "tstype": [
@@ -1128,7 +1135,7 @@
         "optional": false,
         "type": {
           "names": [
-            "any"
+            "string|number"
           ]
         },
         "tstype": [

package/oj-c/SelectMultiple.json

@@ -354,6 +354,13 @@
       "filename": "select-multiple.tsx",
       "path": "web/components/oj-c/select-multiple"
     },
+    "tsdeprecated": [
+      {
+        "type": "deprecated",
+        "since": "18.0.0",
+        "description": "Label truncation for 'start' and 'top' aligned labels is no longer recommended by the Redwood Design System. The default for labelWrapping was 'wrap' and that is now the only suggested pattern by UX design for 'start' and 'top' aligned labels. 'inside' aligned labels are always truncated per UX design and are not affected by this property's value."
+      }
+    ],
     "ojvalues": [
       {
         "name": "truncate",
@@ -631,7 +638,7 @@
     "defaultvalue": null,
     "type": {
       "names": [
-        "object|null"
+        "Set<string|number>|null"
       ]
     },
     "tstype": [
@@ -659,7 +666,7 @@
     "defaultvalue": null,
     "type": {
       "names": [
-        "object|null"
+        "Map<string|number, object>|null"
       ]
     },
     "tstype": [
@@ -962,7 +969,7 @@
       {
         "name": "value",
         "description": "The value to be selected",
-        "type": "object|null"
+        "type": "Set<any>|null"
       }
     ],
     "meta": {
@@ -981,6 +988,29 @@
       }
     ]
   },
+  {
+    "memberof": "oj-c.SelectMultiple",
+    "id": "oj-c.SelectMultiple#UNSAFE_focusAndOpenDropdown",
+    "name": "UNSAFE_focusAndOpenDropdown",
+    "kind": "function",
+    "longname": "oj-c.SelectMultiple#UNSAFE_focusAndOpenDropdown",
+    "description": "This is an UNSAFE method that focuses the select component and opens the dropdown",
+    "ojhidden": true,
+    "meta": {
+      "filename": "select-multiple.tsx",
+      "path": "web/components/oj-c/select-multiple"
+    },
+    "scope": "instance",
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "void"
+          ]
+        }
+      }
+    ]
+  },
   {
     "memberof": "oj-c.SelectMultiple",
     "id": "oj-c.SelectMultiple#setProperty",

package/oj-c/SelectSingle.json

@@ -372,6 +372,13 @@
       "filename": "select-single.tsx",
       "path": "web/components/oj-c/select-single"
     },
+    "tsdeprecated": [
+      {
+        "type": "deprecated",
+        "since": "18.0.0",
+        "description": "Label truncation for 'start' and 'top' aligned labels is no longer recommended by the Redwood Design System. The default for labelWrapping was 'wrap' and that is now the only suggested pattern by UX design for 'start' and 'top' aligned labels. 'inside' aligned labels are always truncated per UX design and are not affected by this property's value."
+      }
+    ],
     "ojvalues": [
       {
         "name": "truncate",
@@ -649,7 +656,7 @@
     "defaultvalue": null,
     "type": {
       "names": [
-        "any"
+        "string|number|null"
       ]
     },
     "tstype": [
@@ -1029,6 +1036,29 @@
       }
     ]
   },
+  {
+    "memberof": "oj-c.SelectSingle",
+    "id": "oj-c.SelectSingle#UNSAFE_focusAndOpenDropdown",
+    "name": "UNSAFE_focusAndOpenDropdown",
+    "kind": "function",
+    "longname": "oj-c.SelectSingle#UNSAFE_focusAndOpenDropdown",
+    "description": "This is an UNSAFE method that focuses the select component and opens the dropdown",
+    "ojhidden": true,
+    "meta": {
+      "filename": "select-single.tsx",
+      "path": "web/components/oj-c/select-single"
+    },
+    "scope": "instance",
+    "returns": [
+      {
+        "type": {
+          "names": [
+            "void"
+          ]
+        }
+      }
+    ]
+  },
   {
     "memberof": "oj-c.SelectSingle",
     "id": "oj-c.SelectSingle#setProperty",

package/oj-c/SelectionCard.json

@@ -6,7 +6,7 @@
     "memberof": "oj-c",
     "longname": "oj-c.SelectionCard",
     "kind": "class",
-    "classdesc": "<h3 id=\"SelectionCardOverview-section\">\n  JET Selection\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#SelectionCardOverview-section\"></a>\n</h3>\n<p>Description: Themeable, WAI-ARIA-compliant element that represents a card.</p>\n<p>Selection Card provides a styled rectangular area for use in collections.\n\n\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-selection-card\" selected=\"[[isSelected]]\">\n  Sample Text\n&lt;/oj-c-selection-card>\n\n</code></pre>",
+    "classdesc": "<h3 id=\"SelectionCardOverview-section\">\n  JET Selection\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#SelectionCardOverview-section\"></a>\n</h3>\n<p>Description: Themeable, WAI-ARIA-compliant element that represents a card.</p>\n<p>Selection Card provides a styled rectangular area for use in collections.\n\n\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-selection-card\" selected=\"[[isSelected]]\">\n  Sample Text\n&lt;/oj-c-selection-card>\n\n</code></pre>\n\n<h3 id=\"diff-section\">\n  Differences between Cards in JET\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#diff-section\"></a>\n</h3>\n\n<p>\nThere are several different options for creating cards in JET applications.\n</p>\n<ul>\n<li><strong>oj-c-action-card:</strong> ActionCard fires action events and is supported for use stand alone or in oj-c-card-view. For accessibility reasons nothing interactive (for example links or buttons) can be put in an action card.</li>\n<li><strong>oj-c-selection-card:</strong> SelectionCard is supported for use in oj-c-card-view, with single or multiple selection.</li>\n<li><strong>oj-panel CSS class:</strong> For simple cases with no associated action or selection. Panel is supported for use in standalone or in oj-c-card-view.</li>\n</ul>",
     "scope": "static",
     "tagWithoutBrackets": "oj-c-selection-card",
     "tagWithBrackets": "<oj-c-selection-card>",

package/oj-c/Selector.json

@@ -6,7 +6,7 @@
     "memberof": "oj-c",
     "longname": "oj-c.Selector",
     "kind": "class",
-    "classdesc": "<h3 id=\"selectorOverview-section\">\n  JET Selector\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#selectorOverview-section\"></a>\n</h3>\n<p>Description: A checkbox to support selection in Collection Components</p>\n<p>The oj-c-selector is a component that may be placed within a template for Table, ListView.\nIt presents as a checkbox when the Collection Component is configured for multi-selection.\n\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-list-view\n   id=\"listview\"\n   data=\"[[dataProvider]]\"\n   selected=\"{{selectedItems}}\"\n   selection-mode=\"[[selectedSelectionMode]]\">\n &lt;template slot=\"itemTemplate\" data-oj-as=\"item\">\n   &lt;oj-c-list-item-layout>\n     &lt;oj-c-selector\n       selected-keys=\"{{selectedItems}}\"\n       selection-mode=\"[[selectedSelectionMode]]\"\n       row-key='[[item.key]]'\n       slot=\"selector\">\n     &lt;/oj-c-selector>\n     &lt;span>\n       &lt;oj-bind-text value=\"[[item.data.name]]\">&lt;/oj-bind-text>\n     &lt;/span>\n   &lt;/oj-c-list-item-layout>\n &lt;/template>\n&lt;/oj-c-list-view>\n</code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>Application must specify a value for the aria-label attribute with a meaningful description of the purpose of this selector in order for this to be accessible.</p>",
+    "classdesc": "<h3 id=\"selectorOverview-section\">\n  JET Selector\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#selectorOverview-section\"></a>\n</h3>\n<p>Description: A checkbox to support selection in Collection Components</p>\n<p>The oj-c-selector is a component that may be placed within a template for Table, ListView.\nIt presents as a checkbox when the Collection Component is configured for multi-selection.\n\n<pre class=\"prettyprint\">\n<code>\n&lt;oj-c-list-view\n   id=\"listview\"\n   data=\"[[dataProvider]]\"\n   selected=\"{{selectedItems}}\"\n   selection-mode=\"[[selectedSelectionMode]]\">\n &lt;template slot=\"itemTemplate\" data-oj-as=\"item\">\n   &lt;oj-c-list-item-layout>\n     &lt;oj-c-selector\n       slot=\"selector\">\n     &lt;/oj-c-selector>\n     &lt;span>\n       &lt;oj-bind-text value=\"[[item.data.name]]\">&lt;/oj-bind-text>\n     &lt;/span>\n   &lt;/oj-c-list-item-layout>\n &lt;/template>\n&lt;/oj-c-list-view>\n</code></pre>\n\n<h3 id=\"a11y-section\">\n  Accessibility\n  <a class=\"bookmarkable-link\" title=\"Bookmarkable Link\" href=\"#a11y-section\"></a>\n</h3>\n\n<p>Application must specify a value for the aria-label attribute with a meaningful description of the purpose of this selector in order for this to be accessible.</p>",
     "scope": "static",
     "tagWithoutBrackets": "oj-c-selector",
     "tagWithBrackets": "<oj-c-selector>",
@@ -61,16 +61,16 @@
     "name": "rowKey",
     "kind": "member",
     "longname": "oj-c.Selector#rowKey",
-    "optional": false,
+    "optional": true,
     "scope": "instance",
-    "description": "Specifies the row key of each selector.",
+    "description": "Specifies the row key of each selector.\nNote that if the selector is used inside one of these components:\n<ul>\n<li>oj-c-card-view</li>\n<li>oj-c-list-view</li>\n</ul>\nThen the selector will retrieve this directly from the above component and\ntherefore this attribute should not be set.",
     "meta": {
       "filename": "selector.tsx",
       "path": "web/components/oj-c/selector"
     },
     "type": {
       "names": [
-        "any"
+        "string|number"
       ]
     },
     "tstype": [
@@ -87,10 +87,10 @@
     "name": "selectedKeys",
     "kind": "member",
     "longname": "oj-c.Selector#selectedKeys",
-    "optional": false,
+    "optional": true,
     "scope": "instance",
     "ojwriteback": true,
-    "description": "Specifies the selectedKeys, should be hooked into the collection component.",
+    "description": "Specifies the selectedKeys.\nNote that if the selector is used inside one of these components:\n<ul>\n<li>oj-c-card-view</li>\n<li>oj-c-list-view</li>\n</ul>\nThen the selector will retrieve this directly from the above component and\ntherefore this attribute should not be set.",
     "meta": {
       "filename": "selector.tsx",
       "path": "web/components/oj-c/selector"
@@ -139,7 +139,7 @@
     "longname": "oj-c.Selector#selectionMode",
     "optional": true,
     "scope": "instance",
-    "description": "Specifies the selection mode ('single', 'multiple'). For selection mode 'all', please refer to oj-c-selector-all component.",
+    "description": "Specifies the selection mode ('single', 'multiple'). For selection mode 'all', please refer to oj-c-selector-all component.\nNote that if the selector is used inside one of these components:\n<ul>\n<li>oj-c-card-view</li>\n<li>oj-c-list-view</li>\n</ul>\nThen the selector will retrieve this directly from the above component and\ntherefore this attribute should not be set.",
     "meta": {
       "filename": "selector.tsx",
       "path": "web/components/oj-c/selector"
@@ -166,7 +166,6 @@
         }
       }
     ],
-    "defaultvalue": "\"multiple\"",
     "type": {
       "names": [
         "\"multiple\"",

package/oj-c/Sheet/Sheet.js

@@ -1,9 +1,8 @@
 define(["require", "exports", "preact/jsx-runtime", "@oracle/oraclejet-preact/UNSAFE_Sheet"], function (require, exports, jsx_runtime_1, UNSAFE_Sheet_1) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.Sheet = void 0;
+    exports.Sheet = Sheet;
     function Sheet({ isOpen, children, onClose, initialFocus }) {
         return ((0, jsx_runtime_1.jsx)(UNSAFE_Sheet_1.Sheet, { isOpen: isOpen, onClose: onClose, initialFocus: initialFocus, children: children }));
     }
-    exports.Sheet = Sheet;
 });