fix(pagination): update JSDoc descriptions for dispatched events

Author: metonym

COMPONENT_INDEX.md

@@ -2764,12 +2764,12 @@ None.
 
 ### Events
 
-| Event name             | Type       | Detail                                             | Description                            |
-| :--------------------- | :--------- | :------------------------------------------------- | :------------------------------------- |
-| change                 | dispatched | <code>{ page?: number; pageSize?: number; }</code> | Dispatched after any user interaction. |
-| click:button--previous | dispatched | <code>{ page: number; }</code>                     | Dispatched after any user interaction. |
-| click:button--next     | dispatched | <code>{ page: number; }</code>                     | Dispatched after any user interaction. |
-| update                 | dispatched | <code>{ pageSize: number; page: number; }</code>   | Dispatched after any user interaction. |
+| Event name             | Type       | Detail                                             | Description                                                                     |
+| :--------------------- | :--------- | :------------------------------------------------- | :------------------------------------------------------------------------------ |
+| change                 | dispatched | <code>{ page?: number; pageSize?: number; }</code> | Dispatched when the user changes the page or page size through any interaction. |
+| click:button--previous | dispatched | <code>{ page: number; }</code>                     | Dispatched when the user clicks the previous page button.                       |
+| click:button--next     | dispatched | <code>{ page: number; }</code>                     | Dispatched when the user clicks the next page button.                           |
+| update                 | dispatched | <code>{ pageSize: number; page: number; }</code>   | Dispatched reactively whenever the page or page size changes.                   |
 
 ## `PaginationNav`
 

docs/src/COMPONENT_API.json

@@ -11037,25 +11037,25 @@
           "type": "dispatched",
           "name": "change",
           "detail": "{\n  page?: number;\n  pageSize?: number;\n}",
-          "description": "Dispatched after any user interaction."
+          "description": "Dispatched when the user changes the page or page size through any interaction."
         },
         {
           "type": "dispatched",
           "name": "click:button--previous",
           "detail": "{ page: number }",
-          "description": "Dispatched after any user interaction."
+          "description": "Dispatched when the user clicks the previous page button."
         },
         {
           "type": "dispatched",
           "name": "click:button--next",
           "detail": "{ page: number }",
-          "description": "Dispatched after any user interaction."
+          "description": "Dispatched when the user clicks the next page button."
         },
         {
           "type": "dispatched",
           "name": "update",
           "detail": "{\n  pageSize: number;\n  page: number;\n}",
-          "description": "Dispatched after any user interaction."
+          "description": "Dispatched reactively whenever the page or page size changes."
         }
       ],
       "typedefs": [],

src/Pagination/Pagination.svelte

@@ -1,17 +1,20 @@
 <script>
   /**
-   * Dispatched after any user interaction.
+   * Dispatched when the user changes the page or page size through any interaction.
    * @event change
    * @type {object}
    * @property {number} [page]
    * @property {number} [pageSize]
    * @event click:button--previous
+   * Dispatched when the user clicks the previous page button.
    * @type {object}
    * @property {number} page
    * @event click:button--next
+   * Dispatched when the user clicks the next page button.
    * @type {object}
    * @property {number} page
    * @event update
+   * Dispatched reactively whenever the page or page size changes.
    * @type {object}
    * @property {number} pageSize
    * @property {number} page

types/Pagination/Pagination.svelte.d.ts

@@ -115,13 +115,13 @@ export type PaginationProps = Omit<$RestProps, keyof $Props> & $Props;
 export default class Pagination extends SvelteComponentTyped<
   PaginationProps,
   {
-    /** Dispatched after any user interaction. */
+    /** Dispatched when the user changes the page or page size through any interaction. */
     change: CustomEvent<{ page?: number; pageSize?: number }>;
-    /** Dispatched after any user interaction. */
+    /** Dispatched when the user clicks the previous page button. */
     "click:button--previous": CustomEvent<{ page: number }>;
-    /** Dispatched after any user interaction. */
+    /** Dispatched when the user clicks the next page button. */
     "click:button--next": CustomEvent<{ page: number }>;
-    /** Dispatched after any user interaction. */
+    /** Dispatched reactively whenever the page or page size changes. */
     update: CustomEvent<{ pageSize: number; page: number }>;
   },
   Record<string, never>