chore(overflow-menu): include @example for slot usage

Author: metonym

COMPONENT_INDEX.md

@@ -2708,17 +2708,17 @@ None.
 
 ### Props
 
-| Prop name    | Required | Kind             | Reactive | Type                                                                | Default value                                    | Description                                                       |
-| :----------- | :------- | :--------------- | :------- | ------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------- |
-| ref          | No       | <code>let</code> | Yes      | <code>null &#124; HTMLAnchorElement &#124; HTMLButtonElement</code> | <code>null</code>                                | Obtain a reference to the HTML element                            |
-| primaryFocus | No       | <code>let</code> | Yes      | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` if the item should be focused when opening the menu |
-| text         | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>"Provide text"</code>                      | Specify the item text.<br />Alternatively, use the default slot.  |
-| href         | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>""</code>                                  | Specify the `href` attribute if the item is a link                |
-| disabled     | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to disable the item                                 |
-| hasDivider   | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to include a divider                                |
-| danger       | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to use the danger variant                           |
-| requireTitle | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>true</code>                                | Set to `false` to omit the button `title` attribute               |
-| id           | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>"ccs-" + Math.random().toString(36)</code> | Set an id for the top-level element                               |
+| Prop name    | Required | Kind             | Reactive | Type                                                                | Default value                                    | Description                                                                                                                                                                                                  |
+| :----------- | :------- | :--------------- | :------- | ------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| ref          | No       | <code>let</code> | Yes      | <code>null &#124; HTMLAnchorElement &#124; HTMLButtonElement</code> | <code>null</code>                                | Obtain a reference to the HTML element                                                                                                                                                                       |
+| primaryFocus | No       | <code>let</code> | Yes      | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` if the item should be focused when opening the menu                                                                                                                                            |
+| text         | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>"Provide text"</code>                      | Specify the item text.<br />Alternatively, use the default slot.<br />@example <br />`svelte<br />&lt;OverflowMenuItem&gt;<br />  &lt;span&gt;Custom Text&lt;/span&gt;<br />&lt;/OverflowMenuItem&gt;<br />` |
+| href         | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>""</code>                                  | Specify the `href` attribute if the item is a link                                                                                                                                                           |
+| disabled     | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to disable the item                                                                                                                                                                            |
+| hasDivider   | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to include a divider                                                                                                                                                                           |
+| danger       | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>false</code>                               | Set to `true` to use the danger variant                                                                                                                                                                      |
+| requireTitle | No       | <code>let</code> | No       | <code>boolean</code>                                                | <code>true</code>                                | Set to `false` to omit the button `title` attribute                                                                                                                                                          |
+| id           | No       | <code>let</code> | No       | <code>string</code>                                                 | <code>"ccs-" + Math.random().toString(36)</code> | Set an id for the top-level element                                                                                                                                                                          |
 
 ### Slots
 

docs/src/COMPONENT_API.json

@@ -10678,7 +10678,7 @@
         {
           "name": "text",
           "kind": "let",
-          "description": "Specify the item text.\nAlternatively, use the default slot.",
+          "description": "Specify the item text.\nAlternatively, use the default slot.\n@example \n```svelte\n<OverflowMenuItem>\n  <span>Custom Text</span>\n</OverflowMenuItem>\n```",
           "type": "string",
           "value": "\"Provide text\"",
           "isFunction": false,

src/OverflowMenu/OverflowMenuItem.svelte

@@ -6,6 +6,12 @@
   /**
    * Specify the item text.
    * Alternatively, use the default slot.
+   * @example
+   * ```svelte
+   * <OverflowMenuItem>
+   *   <span>Custom Text</span>
+   * </OverflowMenuItem>
+   * ```
    */
   export let text = "Provide text";
 

types/OverflowMenu/OverflowMenuItem.svelte.d.ts

@@ -7,6 +7,12 @@ type $Props = {
   /**
    * Specify the item text.
    * Alternatively, use the default slot.
+   * @example
+   * ```svelte
+   * <OverflowMenuItem>
+   *   <span>Custom Text</span>
+   * </OverflowMenuItem>
+   * ```
    * @default "Provide text"
    */
   text?: string;