docs: add dispatched event details

Brought in part by sveld 0.18

docs/src/COMPONENT_API.json

@@ -8406,7 +8406,8 @@
         {
           "type": "dispatched",
           "name": "change",
-          "detail": "{ page?: number; pageSize?: number }"
+          "detail": "{ page?: number; pageSize?: number }",
+          "description": "Dispatched after any user interaction"
         },
         {
           "type": "dispatched",
@@ -10257,7 +10258,12 @@
         }
       ],
       "events": [
-        { "type": "dispatched", "name": "update", "detail": "string | number" },
+        {
+          "type": "dispatched",
+          "name": "update",
+          "detail": "string | number",
+          "description": "The selected value."
+        },
         { "type": "forwarded", "name": "change", "element": "select" },
         { "type": "forwarded", "name": "input", "element": "select" },
         { "type": "forwarded", "name": "focus", "element": "select" },

docs/src/components/ComponentApi.svelte

@@ -168,11 +168,33 @@
 <h2 id="dispatched-events">Dispatched events</h2>
 
 {#if dispatched_events.length > 0}
-  <UnorderedList class="my-layout-01-03">
+  {@const hasDescription = dispatched_events.find((el) => el.description)}
-    {#each dispatched_events as event (event.name)}
+  <StructuredList flush>
-      <ListItem>on:{event.name}</ListItem>
+    <StructuredListHead>
-    {/each}
+      <StructuredListRow>
-  </UnorderedList>
+        <StructuredListCell>Event name</StructuredListCell>
+        <StructuredListCell><code>event.details</code> type</StructuredListCell>
+        {#if hasDescription}
+          <StructuredListCell>Description</StructuredListCell>
+        {/if}
+      </StructuredListRow>
+    </StructuredListHead>
+    <StructuredListBody>
+      {#each dispatched_events as event (event.name)}
+        <StructuredListRow>
+          <StructuredListCell>
+            <strong>on:{event.name}</strong>
+          </StructuredListCell>
+          <StructuredListCell>
+            <code>{event.detail}</code>
+          </StructuredListCell>
+          <StructuredListCell>
+            {event.description ?? ""}
+          </StructuredListCell>
+        </StructuredListRow>
+      {/each}
+    </StructuredListBody>
+  </StructuredList>
 {:else}
   <p class="my-layout-01-03">No dispatched events.</p>
 {/if}

src/Select/Select.svelte

@@ -1,6 +1,6 @@
 <script>
   /**
-   * @event {string | number} update
+   * @event {string | number} update The selected value.
    */
 
   /**

types/Pagination/Pagination.svelte.d.ts

@@ -103,6 +103,7 @@ export interface PaginationProps
 export default class Pagination extends SvelteComponentTyped<
   PaginationProps,
   {
+    /** Dispatched after any user interaction */
     change: CustomEvent<{ page?: number; pageSize?: number }>;
     ["click:button--previous"]: CustomEvent<{ page: number }>;
     ["click:button--next"]: CustomEvent<{ page: number }>;

types/Select/Select.svelte.d.ts

@@ -109,7 +109,7 @@ export interface SelectProps
 export default class Select extends SvelteComponentTyped<
   SelectProps,
   {
-    update: CustomEvent<string | number>;
+    /** The selected value. */ update: CustomEvent<string | number>;
     change: WindowEventMap["change"];
     input: WindowEventMap["input"];
     focus: WindowEventMap["focus"];