📝 Update sound theme docs

Author: Schneegans

src/content/docs/config-files.mdx

@@ -79,7 +79,7 @@ Below are the default values of the configuration file.
 
 ```json title="config.json"
 {
-  "version": "2.1.0",
+  "version": "3.0.0",
   "locale": "auto",
   "showIntroductionDialog": true,
   "menuTheme": "default",
@@ -101,6 +101,7 @@ Below are the default values of the configuration file.
   "hideSettingsButton": false,
   "settingsButtonPosition": "bottom-right",
   "windowsInkWorkaround": true,
+  "maxSelectionRadius": 0,
   "centerDeadZone": 50,
   "minParentDistance": 150,
   "dragThreshold": 15,
@@ -112,6 +113,7 @@ Below are the default values of the configuration file.
   "enableMarkingMode": true,
   "enableTurboMode": true,
   "warpMouse": true,
+  "returnPointerToMenuOpeningPosition": false,
   "hoverModeNeedsConfirmation": false,
   "gestureMinStrokeLength": 150,
   "gestureMinStrokeAngle": 20,
@@ -278,12 +280,18 @@ If true, the settings button will be hidden if not hovered.
 The position of the settings button.
 Can be one of `'top-left'`, `'top-right'`, `'bottom-left'`, or `'bottom-right'`.
 
-#### windowsInkWorkaround <Badge text="new!" variant="tip" />
+#### windowsInkWorkaround
 
 <small>Default value: `"windowsInkWorkaround": true`</small>
 
 If true, the menu will introduce a delay of 100ms before opening on Windows to work around the issue where getting the stylus position is otherwise not possible.
 
+#### maxSelectionRadius <Badge text="new!" variant="tip" />
+
+<small>Default value: `"maxSelectionRadius": 0`</small>
+
+If set to a value greater than 0, the menu will be closed if the user clicks outside of the menu and the distance to the center of the menu is greater than this value (in pixels).
+
 #### centerDeadZone
 
 <small>Default value: `"centerDeadZone": 50`</small>
@@ -351,6 +359,12 @@ If enabled, items can be selected by hovering over them while holding down a key
 
 If true, the mouse pointer will be warped to the center of the menu when necessary.
 
+#### returnPointerToMenuOpeningPosition <Badge text="new!" variant="tip" />
+
+<small>Default value: `"returnPointerToMenuOpeningPosition": false`</small>
+
+If enabled, the mouse pointer will be returned to its original position when the menu is closed.
+
 #### hoverModeNeedsConfirmation
 
 <small>Default value: `"hoverModeNeedsConfirmation": false`</small>

src/content/docs/create-sound-themes.mdx

@@ -97,10 +97,10 @@ You can also name this file `theme.json`. But [JSON5](https://json5.org/) is a b
   license: 'CC0-1.0',
   themeVersion: '1.0',
 
-  // This theme was created for Kando's sound theme engine version 1.
+  // This theme was created for Kando's sound theme engine version 2.
   // Kando will use this to check if the theme is compatible with the
   // current version of Kando.
-  engineVersion: 1,
+  engineVersion: 2,
 
   // This is a list of sound files which are played when certain events
   // occur in the menu.
@@ -112,7 +112,7 @@ You can also name this file `theme.json`. But [JSON5](https://json5.org/) is a b
       file: "close.mp3",
       volume: 0.5,
     },
-    hoverItem: {
+    hoverButton: {
       file: "hover.mp3",
       minPitch: 0.9,
       maxPitch: 1.1,
@@ -127,6 +127,29 @@ The following events are available for sound themes.
 For each event, you can specify a sound file which is played when the event occurs.
 It is perfectly fine to reuse the same sound file for multiple events.
 
+<Aside type="note">
+With Kando 3.0, the set of available sound events has changed. Use the tabs below to see which events are available now.
+</Aside>
+
+<Tabs>
+  <TabItem label="Kando 3.0+ (Engine Version 2)">
+
+<div style="width:120px">Event</div>  | Description
+--- | ---
+`openMenu` | This event is triggered when a menu is opened.
+`openSubmenu` | This event is triggered when a submenu is opened.
+`closeMenu` | This event is triggered when a menu is closed. It will play when the close-menu action is executed, regardless of whether an item was selected or not.
+`closeSubmenu` | This event is triggered when a submenu is closed.
+`hoverParent` | This event is triggered when the parent of the current center item is hovered with the mouse.
+`hoverCenter` | This event is triggered when the current center item is hovered with the mouse.
+`hoverButton` | This event is triggered when a leaf item is hovered with the mouse.
+`hoverSubmenu` | This event is triggered when a submenu which could be opened is hovered with the mouse.
+`selectButton` | This event is triggered when an action is executed by selecting an item.
+`activateMenu` | This event is triggered when the center of a submenu is selected.
+
+  </TabItem>
+  <TabItem label="Kando 2.x (Engine Version 1)">
+
 <div style="width:120px">Event</div>  | Description
 --- | ---
 `openMenu` | This event is triggered when a menu is opened.
@@ -138,6 +161,9 @@ It is perfectly fine to reuse the same sound file for multiple events.
 `selectParent` | This event is triggered when the user navigates to the parent of the current center item.
 `selectSubmenu` | This event is triggered when a submenu is opened.
 
+  </TabItem>
+</Tabs>
+
 ### Advanced Configuration
 
 For each event, you can specify the volume of the sound file and the pitch of the sound file.
@@ -147,7 +173,7 @@ You can set them to the same value to play the sound file with a fixed pitch.
 
 ```json5 title="theme.json5" {4-6}
 // ...
-hoverItem: {
+openMenu: {
   file: "hover.mp3",
   volume: 0.5,
   minPitch: 0.9,