@fluentui/react-alert 9.0.0-beta.13 → 9.0.0-beta.131

package/CHANGELOG.json

@@ -1,552 +0,0 @@
-{
-  "name": "@fluentui/react-alert",
-  "entries": [
-    {
-      "date": "Thu, 13 Oct 2022 12:55:52 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.13",
-      "version": "9.0.0-beta.13",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.2.2",
-            "commit": "e563f3daaea9b7cc62f50bc15edd44edf5045107"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 13 Oct 2022 11:02:42 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.12",
-      "version": "9.0.0-beta.12",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "olfedias@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "1a527d440e0497ef8046b3ce240492241e7a04ac",
-            "comment": "chore: Update Griffel to latest version"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.2.1",
-            "commit": "cd05c21e62ff37812d614330eb70f97fd978c97a"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.1.4",
-            "commit": "cd05c21e62ff37812d614330eb70f97fd978c97a"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.1.1",
-            "commit": "cd05c21e62ff37812d614330eb70f97fd978c97a"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.15",
-            "commit": "cd05c21e62ff37812d614330eb70f97fd978c97a"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Mon, 03 Oct 2022 22:24:42 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.11",
-      "version": "9.0.0-beta.11",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.2.0",
-            "commit": "67a8c98b8d53cd2fa14d668cf639b867b68ad18a"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.1.3",
-            "commit": "67a8c98b8d53cd2fa14d668cf639b867b68ad18a"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Tue, 20 Sep 2022 20:55:45 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.10",
-      "version": "9.0.0-beta.10",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.1.1",
-            "commit": "4ceba844c804a2f49b0465389100e7a3dabf116e"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.1.2",
-            "commit": "4ceba844c804a2f49b0465389100e7a3dabf116e"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.14",
-            "commit": "4ceba844c804a2f49b0465389100e7a3dabf116e"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 15 Sep 2022 09:49:47 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.9",
-      "version": "9.0.0-beta.9",
-      "comments": {
-        "none": [
-          {
-            "author": "martinhochel@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "e6cf183695d6d67a24e038c49a876224e5ed35e5",
-            "comment": "chore: update package scaffold"
-          },
-          {
-            "author": "rohitpag@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "045c66e2a2142e3d2380da05a9aa60b54de6888c",
-            "comment": "Adding appearance prop to the alert component"
-          }
-        ],
-        "prerelease": [
-          {
-            "author": "olfedias@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "e610024474cfe5d45f61501a8b6a21daf4c794a2",
-            "comment": "chore: Update Griffel to latest version"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.1.0",
-            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.1.1",
-            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.1.0",
-            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.1.0",
-            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.13",
-            "commit": "a33448fe4a0f4117686c378f80b893d1406d95a8"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Wed, 03 Aug 2022 16:03:36 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.8",
-      "version": "9.0.0-beta.8",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "miroslav.stastny@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "08563664778fd80284561d3c9d254307a0a32362",
-            "comment": "chore: Bump Griffel dependencies"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.0.4",
-            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.1.0",
-            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.12",
-            "commit": "ee4a8be0d0831a6615f878f98db6a97cc61a802d"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 14 Jul 2022 21:21:08 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.7",
-      "version": "9.0.0-beta.7",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "Humberto.Morimoto@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "802bc4e3730a88b0fc61b5bf42ef7fc6b6543fe2",
-            "comment": "fix: Fixing bad version bump of @fluentui/react-utilities."
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.0.3",
-            "commit": "79b513146194367544160f364b0a7dd749ed93e4"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.3",
-            "commit": "79b513146194367544160f364b0a7dd749ed93e4"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.2",
-            "commit": "79b513146194367544160f364b0a7dd749ed93e4"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 14 Jul 2022 17:06:12 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.6",
-      "version": "9.0.0-beta.6",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "ololubek@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "63ab03fa7a9b3d02204147ea5356b8f78751df42",
-            "comment": "chore: Update @fluentui/react-icons dependency to v2.0.175"
-          },
-          {
-            "author": "sarah.higley@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "18cb868b8978fc56b9dc2ded0aaf79d17e6deeee",
-            "comment": "update Alert with live region attributes"
-          },
-          {
-            "author": "rohitpag@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "b4a1586d84a3f1480327d288b128eb102b44ba5a",
-            "comment": "feat: Adding avatar slot support to Alert"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-avatar to v9.0.2",
-            "commit": "35237381e941c8935b1892c9217096cea3e5601f"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.2",
-            "commit": "35237381e941c8935b1892c9217096cea3e5601f"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.1-0",
-            "commit": "35237381e941c8935b1892c9217096cea3e5601f"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.11",
-            "commit": "35237381e941c8935b1892c9217096cea3e5601f"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Tue, 28 Jun 2022 17:39:46 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.5",
-      "version": "9.0.0-beta.5",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "lingfangao@hotmail.com",
-            "package": "@fluentui/react-alert",
-            "commit": "3deda1fbbfb6ac2b1ad150d4dc6343f1f7fda85b",
-            "comment": "fix: Use caret dependency range for Griffel"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.1",
-            "commit": "3deda1fbbfb6ac2b1ad150d4dc6343f1f7fda85b"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.10",
-            "commit": "3deda1fbbfb6ac2b1ad150d4dc6343f1f7fda85b"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Tue, 28 Jun 2022 15:14:12 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.4",
-      "version": "9.0.0-beta.4",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "lingfangao@hotmail.com",
-            "package": "@fluentui/react-alert",
-            "commit": "e0aabd850b15adf9c151ebd4e332f7c50ad6cfdf",
-            "comment": "Update 9.0.0-rc dependencies to use caret range"
-          },
-          {
-            "author": "lingfangao@hotmail.com",
-            "package": "@fluentui/react-alert",
-            "commit": "675acea49c97f10837ddee9b8c4350ca27750125",
-            "comment": "Bump Griffel dependencies"
-          },
-          {
-            "author": "olfedias@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "82bd30dd41ad58df1f325e9b721200ed15d674a2",
-            "comment": "chore: Update @fluentui/react-icons to latest version"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0",
-            "commit": "ba6c5d651559b91c815429c9a9357c4d5a390f3e"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0",
-            "commit": "ba6c5d651559b91c815429c9a9357c4d5a390f3e"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.0",
-            "commit": "ba6c5d651559b91c815429c9a9357c4d5a390f3e"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.9",
-            "commit": "ba6c5d651559b91c815429c9a9357c4d5a390f3e"
-          }
-        ],
-        "none": [
-          {
-            "author": "mgodbolt@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "262d148f068ea1d3354994dd659ac881b31dda28",
-            "comment": "chore: Move alert stories into folder and use index entry point."
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 23 Jun 2022 14:25:31 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.3",
-      "version": "9.0.0-beta.3",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0-rc.14",
-            "commit": "b00790b7a0ea1473d8c3cc49c7ca0088002957ed"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.10",
-            "commit": "b00790b7a0ea1473d8c3cc49c7ca0088002957ed"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Tue, 31 May 2022 21:28:35 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.2",
-      "version": "9.0.0-beta.2",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "olfedias@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "0a5e9fa77a72eecafdd07034ccdc0b95fd49877c",
-            "comment": "chore: Update Griffel to latest version"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0-rc.13",
-            "commit": "335ebfcfd47005003901b5e319782bfe9ccd89fd"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.0-rc.10",
-            "commit": "335ebfcfd47005003901b5e319782bfe9ccd89fd"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.8",
-            "commit": "335ebfcfd47005003901b5e319782bfe9ccd89fd"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 26 May 2022 21:01:22 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-beta.1",
-      "version": "9.0.0-beta.1",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "rohitpag@microsoft.com",
-            "package": "@fluentui/react-alert",
-            "commit": "303947a3e3687058c902a9a8bee1ecd1f19a92c8",
-            "comment": "Publish react-alert as unstable component"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0-rc.12",
-            "commit": "3cf55ce998048554bf6a550de44403843ea8ede0"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Mon, 23 May 2022 18:56:51 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-alpha.0",
-      "version": "9.0.0-alpha.0",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0-rc.11",
-            "commit": "d4f80b17690e962d6a24e68959608d1ffe84aef6"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.9",
-            "commit": "d4f80b17690e962d6a24e68959608d1ffe84aef6"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.7",
-            "commit": "d4f80b17690e962d6a24e68959608d1ffe84aef6"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Mon, 23 May 2022 12:14:24 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-alpha.0",
-      "version": "9.0.0-alpha.0",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-button to v9.0.0-rc.10",
-            "commit": "8d58f08997acf595e3eb7f628123e7fa7830c394"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.8",
-            "commit": "8d58f08997acf595e3eb7f628123e7fa7830c394"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.0-rc.9",
-            "commit": "8d58f08997acf595e3eb7f628123e7fa7830c394"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.6",
-            "commit": "8d58f08997acf595e3eb7f628123e7fa7830c394"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Thu, 05 May 2022 18:26:30 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-alpha.0",
-      "version": "9.0.0-alpha.0",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.7",
-            "commit": "c5abb9c480ac94d12aa644d68d30773d77f2a159"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.0-rc.8",
-            "commit": "c5abb9c480ac94d12aa644d68d30773d77f2a159"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.5",
-            "commit": "c5abb9c480ac94d12aa644d68d30773d77f2a159"
-          }
-        ]
-      }
-    },
-    {
-      "date": "Wed, 04 May 2022 13:26:54 GMT",
-      "tag": "@fluentui/react-alert_v9.0.0-alpha.0",
-      "version": "9.0.0-alpha.0",
-      "comments": {
-        "prerelease": [
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.6",
-            "commit": "65f94192ed3b2cde7e52b9c7e12d6f38b81965dd"
-          },
-          {
-            "author": "beachball",
-            "package": "@fluentui/react-alert",
-            "comment": "Bump @fluentui/react-utilities to v9.0.0-rc.7",
-            "commit": "65f94192ed3b2cde7e52b9c7e12d6f38b81965dd"
-          }
-        ]
-      }
-    }
-  ]
-}

package/Spec.md

@@ -1,97 +0,0 @@
-# Alert
-
-## Background
-
-An Alert displays a brief, important message to attract a user's attention without interrupting their current task.
-
-## Prior Art
-
-- [Alert - Open UI](https://open-ui.org/components/toast.research)
-- [Convergence epic issue #22579](https://github.com/microsoft/fluentui/issues/22579)
-
-## Sample Code
-
-Default Alert
-
-```
-import { Alert } from '@fluentui/react-alert'
-
-const AlertExample = () => <Alert>This is a default alert</Alert>
-```
-
-Success Alert
-
-```
-import { Alert } from '@fluentui/react-alert'
-
-const AlertExample = () =><Alert intent="success">This is a success alert</Alert>
-```
-
-## API
-
-See [Alert.types.ts](./src/components/Alert/Alert.types.ts)
-
-## Structure
-
-### Slots
-
-- `root`: The outermost `<div>` that contains the rest of the slots
-- `icon`: (optional) A `<span>` that renders an icon and is inferred by the `intent` prop or passed in via the `icon` prop
-- `action`: (optional) A `<button>` that prompts users to act on it
-- `avatar`: (optional) A slot that renders an `Avatar` component passed in via the `avatar` prop
-
-### **Public**
-
-```jsx
-<Alert>This is a default alert</Alert>
-```
-
-### **Internal**
-
-```tsx
-<slots.root {...slotProps.root}>
-  {slots.icon && <slots.icon {...slotProps.icon} />}
-  {slots.avatar && <slots.avatar {...slotProps.avatar} />}
-  {slotProps.root.children}
-  {slots.action && <slots.action {...slotProps.action} />}
-</slots.root>
-```
-
-### **DOM**
-
-```html
-<div class="fui-Alert">
-  <span class="fui-Alert__icon">DeletedFilled</span>
-  Chat deleted
-  <button type="button" class="fui-Button fui-Alert__action">Undo</button>
-</div>
-```
-
-## Migration
-
-See [Migration.md](./Migration.md)
-
-## Behaviors
-
-_Explain how the component will behave in use, including:_
-
-- _Component States_
-- _Interaction_
-  - _Keyboard_
-  - _Cursor_
-  - _Touch_
-  - _Screen readers_
-
-## Accessibility
-
-Base accessibility information is included in the design document. After the spec is filled and review, outcomes from it need to be communicated to design and incorporated in the design document.
-
-- Decide whether to use **native element** or folow **ARIA** and provide reasons
-- Identify the **[ARIA](https://www.w3.org/TR/wai-aria-practices-1.2/) pattern** and, if the component is listed there, follow its specification as possible.
-- Identify accessibility **variants**, the `role` ([ARIA roles](https://www.w3.org/TR/wai-aria-1.1/#role_definitions)) of the component, its `slots` and `aria-*` props.
-- Describe the **keyboard navigation**: Tab Oder and Arrow Key Navigation. Describe any other keyboard **shortcuts** used
-- Specify texts for **state change announcements** - [ARIA live regions
-  ](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Live_Regions) (number of available items in dropdown, error messages, confirmations, ...)
-- Identify UI parts that appear on **hover or focus** and specify keyboard and screen reader interaction with them
-- List cases when **focus** needs to be **trapped** in sections of the UI (for dialogs and popups or for hierarchical navigation)
-- List cases when **focus** needs to be **moved programatically** (if parts of the UI are appearing/disappearing or other cases)