Merge branch 'main' into add-din-info

Author: bgravenorst

docs/whats-new.md

@@ -12,7 +12,7 @@ of the [MetaMask developer page](https://metamask.io/developer/).
 ## December 2024
 
 - Documented [Swellchain](/services/reference/swellchain) support. ([#1776](https://github.com/MetaMask/metamask-docs/pull/1776))
-- Documented [Snap Notifications Expanded View](/snaps/features/notifications/#expanded-view). 
+- Documented [Snaps notifications expanded view](/snaps/features/notifications/#expanded-view). 
   ([#1774](https://github.com/MetaMask/metamask-docs/pull/1774))
 - Documented [`snap_getInterfaceContext`](/snaps/reference/snaps-api/#snap_getinterfacecontext).
   ([#1772](https://github.com/MetaMask/metamask-docs/pull/1772))

package-lock.json

@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "^11.7.2",
-    "@docusaurus/core": "^3.5.2",
-    "@docusaurus/plugin-content-docs": "^3.5.2",
-    "@docusaurus/plugin-content-pages": "^3.5.2",
-    "@docusaurus/preset-classic": "^3.5.2",
-    "@docusaurus/theme-common": "^3.5.2",
-    "@docusaurus/theme-mermaid": "^3.5.2",
+    "@docusaurus/core": "^3.7.0",
+    "@docusaurus/plugin-content-docs": "^3.7.0",
+    "@docusaurus/plugin-content-pages": "^3.7.0",
+    "@docusaurus/preset-classic": "^3.7.0",
+    "@docusaurus/theme-common": "^3.7.0",
+    "@docusaurus/theme-mermaid": "^3.7.0",
     "@intercom/messenger-js-sdk": "^0.0.14",
     "@mdx-js/react": "^3.1.0",
     "@metamask/design-tokens": "^1.11.1",
@@ -72,11 +72,11 @@
     "sass": "^1.80.4"
   },
   "devDependencies": {
-    "@docusaurus/eslint-plugin": "^3.5.2",
-    "@docusaurus/module-type-aliases": "^3.5.2",
-    "@docusaurus/plugin-client-redirects": "^3.5.2",
-    "@docusaurus/tsconfig": "^3.5.2",
-    "@docusaurus/types": "^3.5.2",
+    "@docusaurus/eslint-plugin": "^3.7.0",
+    "@docusaurus/module-type-aliases": "^3.7.0",
+    "@docusaurus/plugin-client-redirects": "^3.7.0",
+    "@docusaurus/tsconfig": "^3.7.0",
+    "@docusaurus/types": "^3.7.0",
     "@eslint/js": "^8.57.1",
     "@tsconfig/docusaurus": "^1.0.5",
     "@types/react-alert": "^7.0.6",

package.json

@@ -16,7 +16,7 @@ implementing the following features:
 - [Home pages](home-pages.md)
 - [Transaction insights](../transaction-insights.md)
 - [Signature insights](../signature-insights.md)
-- [Notifications (Expanded View)](../notifications.md#expanded-view)
+- [Notifications (expanded view)](../notifications.md#expanded-view)
 
 :::note
 JSX is supported in the MetaMask extension and Flask version 12 and later. 

snaps/features/custom-ui/index.md

@@ -65,9 +65,11 @@ Each Snap can trigger up to:
 
 ## Expanded view
 
-In-app notifications can include an optional expanded view that will be displayed when the user clicks on the notification. The expanded view includes a title, content, and an optional footer link. 
+In-app notifications can include an optional expanded view that displays when selected.
+The expanded view includes a title, content, and an optional footer link. 
 
-The following example displays a notification in MetaMask, with the message "Hello, world!" When the user clicks on the notification, the expanded view displays a page with a title, a paragraph, and a link to the MetaMask Snaps directory:
+The following example displays a notification in MetaMask, with the message "Hello, world!"
+When the user selects the notification, the expanded view displays a page with a title, a paragraph, and a link to the MetaMask Snaps directory:
 
 ```javascript title="index.js"
 await snap.request({

snaps/features/notifications.md

@@ -32,6 +32,11 @@ Always do your own research before installing a Snap.
   - Is [published](publish-a-snap.md) to npm.
   - Does not impair MetaMask's compliance with laws or regulations.
 
+- Remove any `console` logs, "to-do" comments, and unused permissions or methods.
+
+- Scan your Snap for security vulnerabilities using [Snapper](https://github.com/sayfer-io/Snapper) and 
+  resolve any reported issues.
+
 - If your Snap uses any of the following API methods related to key management, you must provide
   evidence of a third-party audit from an approved auditor:
 

snaps/how-to/get-allowlisted.md

@@ -69,13 +69,15 @@ For each Snap, the user can:
 A Snap can also display a [home page](../../features/custom-ui/home-pages.md) within MetaMask that
 the user can access using the Snaps menu.
 
-Other than the settings page and home page, a Snap can
-[modify the MetaMask UI](../../features/custom-ui/index.md) only
-by displaying [dialogs](../../features/custom-ui/dialogs.md),
-[transaction insights](../../reference/entry-points.md#ontransaction), or
-[signature insights](../../features/signature-insights.md).
-
-This means that many Snaps must use companion dapps and custom JSON-RPC API methods to
+Other than the settings page and home page, a Snap can modify the MetaMask UI by displaying
+[custom UI](../../features/custom-ui/index.md) in
+[dialogs](../../features/custom-ui/dialogs.md),
+[transaction insights](../../features/transaction-insights.md),
+[signature insights](../../features/signature-insights.md), and
+[notifications (expanded view)](../../features/notifications.md#expanded-view).
+An [account management Snap](../../features/custom-evm-accounts/index.md) can also modify the MetaMask UI by leveraging native account UX.
+
+Many Snaps must use companion dapps and custom JSON-RPC API methods to
 present data to the user.
 
 :::note

snaps/learn/about-snaps/index.md

@@ -55,6 +55,8 @@ View the following Snaps resources in addition to this documentation site.
 - [Snaps Simulator](https://metamask.github.io/snaps/snaps-simulator/latest) - A tool for simulating
   Snaps in the browser, streamlining the development process. It doesn't support all Snaps features 
   but can be useful for testing certain features.
+- [Snapper](https://github.com/sayfer-io/Snapper) - A tool for detecting security vulnerabilities,
+  identifying potential issues, and ensuring best coding practices in your Snap.
 - [MetaMask Testing Tools](https://hugomrdias.github.io/metamask/) - A collection of tools for 
   testing MetaMask, MetaMask Flask, and MetaMask Snaps with [Playwright](https://playwright.dev/), 
   delivered as an npm package that provides a `createFixture` function that returns a `test` and