Merge branch 'MetaMask:main' into main

Author: lannathompson65-arch

.cursor/rules/content-types.mdc

@@ -1,6 +1,6 @@
 ---
 description: Maps folder conventions to Diataxis content types so AI tools produce the right structure for each doc category.
-globs: ["**/*.md", "**/*.mdx"]
+globs: **/*.md,**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/contributor-workflow.mdc

@@ -69,6 +69,12 @@ Pull requests run **`npm run format:check`** (Prettier against `.prettierrc` and
 **`npm run format`** locally to fix style before pushing. Generated Snaps API pages under
 `snaps/reference/snaps-api/` are excluded from formatting in git (see `.prettierignore`).
 
+After **`npm install`**, [Husky](https://typicode.github.io/husky/) installs a Git **`pre-commit`** hook
+that runs [**`lint-staged`**](https://github.com/lint-staged/lint-staged) using the rules in
+`package.json`. Staged files matching those patterns are auto-formatted with Prettier (and other
+commands in `lint-staged`, such as ESLint on `src/`). Restage if the hook edits files. Hooks are
+local only and are not required for CI to pass.
+
 Pull requests are checked by a Vale-based linter
 ([docs-spelling-check](https://github.com/Consensys/github-actions/tree/main/docs-spelling-check))
 that enforces Microsoft style, Consensys terminology, and spelling. Fix any linter warnings before

.cursor/rules/editorial-voice.mdc

@@ -1,6 +1,6 @@
 ---
 description: Editorial voice and tone rules aligned with the Microsoft Writing Style Guide and Consensys documentation standards.
-globs: ["**/*.md", "**/*.mdx"]
+globs: **/*.md,**/*.mdx
 alwaysApply: false
 ---
 
@@ -44,12 +44,14 @@ The rules below are the most actionable subset for AI-assisted editing.
 
 ## Punctuation and formatting
 
-- Do not use em dashes or en dashes. Use commas, parentheses, semicolons, or rephrase the sentence.
+- Do not use em dashes (—) to set off extra information. Use commas, parentheses, semicolons, or rephrase the sentence.
 - Use only one space after periods, question marks, and colons.
 - Use sentence case for all headings and titles. Never use title case.
 - Do not end headings, subheadings, or UI titles with periods.
 - Use backticks for inline code, file names, and URLs referenced in prose.
-- Use bold for UI element names (buttons, menu items, field labels).
+- In general, do not use bold to emphasize words in a paragraph. Use bold sparingly:
+  - For UI element names (buttons, menu items, field labels).
+  - For emphasis in exceptional cases such as critical security warnings when an admonition is not enough.
 
 ## Developer content
 

.cursor/rules/markdown-formatting.mdc

@@ -1,6 +1,6 @@
 ---
 description: Markdown formatting conventions for the MetaMask documentation site (Docusaurus).
-globs: ["**/*.md", "**/*.mdx"]
+globs: **/*.md,**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/product-embedded-wallets.mdc

@@ -1,6 +1,6 @@
 ---
 description: Product-specific guidance for Embedded Wallets documentation, including naming, content organization, and SDK conventions.
-globs: ["embedded-wallets/**/*.md", "embedded-wallets/**/*.mdx"]
+globs: embedded-wallets/**/*.md,embedded-wallets/**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/product-metamask-connect.mdc

@@ -1,6 +1,6 @@
 ---
 description: Product-specific guidance for MetaMask Connect documentation, including terminology, CAIP standards, and content organization.
-globs: ["metamask-connect/**/*.md", "metamask-connect/**/*.mdx"]
+globs: metamask-connect/**/*.md,metamask-connect/**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/product-services.mdc

@@ -1,6 +1,6 @@
 ---
 description: Product-specific guidance for Services (Infura) documentation, including naming, reference conventions, and partial reuse.
-globs: ["services/**/*.md", "services/**/*.mdx"]
+globs: services/**/*.md,services/**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/product-smart-accounts-kit.mdc

@@ -1,12 +1,6 @@
 ---
 description: Product-specific guidance for Smart Accounts Kit documentation, including terminology, delegation concepts, glossary/tooltips, and versioning.
-globs:
-  [
-    'smart-accounts-kit/**/*.md',
-    'smart-accounts-kit/**/*.mdx',
-    'src/lib/glossary.json',
-    'scripts/generate-smart-accounts-glossary.js',
-  ]
+globs: smart-accounts-kit/**/*.md,smart-accounts-kit/**/*.mdx,src/lib/glossary.json
 alwaysApply: false
 ---
 

.cursor/rules/product-snaps.mdc

@@ -1,6 +1,6 @@
 ---
 description: Product-specific guidance for Snaps documentation, including naming, content areas, and generated-content constraints.
-globs: ["snaps/**/*.md", "snaps/**/*.mdx"]
+globs: snaps/**/*.md,snaps/**/*.mdx
 alwaysApply: false
 ---
 

.cursor/rules/terminology.mdc

@@ -1,6 +1,6 @@
 ---
 description: Required spelling and casing for product names, industry terms, and standards referenced across MetaMask documentation.
-globs: ["**/*.md", "**/*.mdx"]
+globs: **/*.md,**/*.mdx
 alwaysApply: false
 ---
 
@@ -9,18 +9,19 @@ alwaysApply: false
 Use the terms below consistently. The left column is the required form. Do not use the variants
 listed on the right unless they appear in code, URLs, or direct quotations from a specification.
 
-| Required term                          | Do not use                                              |
-|----------------------------------------|---------------------------------------------------------|
-| dapp                                   | DApp, Dapp, dApp, decentralized application             |
-| MetaMask                               | Metamask, metamask (except in code/URLs)                |
-| smart account                          | smart contract account, SCA (unless quoting an ERC)     |
-| externally owned account (EOA)         | externally-owned account                                |
-| Snaps (platform)                       | snaps, SNAPS                                            |
-| a Snap (singular)                      | a snap, a SNAP                                          |
-| web3                                   | Web3, WEB3 (capitalize only at sentence start)          |
-| sign in / sign out (verb)              | log in, log out, login, logout (as verbs)               |
-| sign-in / sign-out (noun or adjective) | log-in, log-out, login, logout (as nouns/adj)           |
-| onchain / offchain                     | on-chain, off-chain                                     |
+| Required term                          | Do not use                                                                      |
+| -------------------------------------- | ------------------------------------------------------------------------------- |
+| dapp                                   | DApp, dApp, decentralized application, Dapp (capitalize only at sentence start) |
+| MetaMask                               | Metamask, metamask (except in code/URLs)                                        |
+| smart account                          | smart contract account, SCA (unless quoting an ERC)                             |
+| externally owned account (EOA)         | externally-owned account                                                        |
+| Snaps (platform)                       | snaps, SNAPS                                                                    |
+| a Snap (singular)                      | a snap, a SNAP                                                                  |
+| web3                                   | Web3, WEB3 (capitalize only at sentence start)                                  |
+| sign in / sign out (verb)              | log in, log out, login, logout (as verbs)                                       |
+| sign-in / sign-out (noun or adjective) | log-in, log-out, login, logout (as nouns/adj)                                   |
+| onchain / offchain                     | on-chain, off-chain                                                             |
+| Wallet Standard, Wallet Adapter        | wallet-standard, wallet-adapter (except in URLs)                                |
 
 ## Standards and specifications