From b33ff71582285996125d704f68e0c89da1a8e893 Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Sat, 23 Nov 2024 15:22:37 -0800
Subject: [PATCH] docs(component-api): required props are sorted first

---
 docs/src/components/ComponentApi.svelte | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/src/components/ComponentApi.svelte b/docs/src/components/ComponentApi.svelte
index a355a00c..bcee3ec6 100644
--- a/docs/src/components/ComponentApi.svelte
+++ b/docs/src/components/ComponentApi.svelte
@@ -61,7 +61,17 @@
       </StructuredListHead>
       <StructuredListBody>
         {#each component.props.sort((a, b) => {
-          if (a.reactive > b.reactive) return -1;
+          // Sort props so required props are listed first, then reactive props.
+
+          if (a.isRequired !== b.isRequired) {
+            return b.isRequired ? 1 : -1;
+          }
+
+          if (a.reactive !== b.reactive) {
+            return b.reactive ? 1 : -1;
+          }
+
+          return 0;
         }) as prop (prop.name)}
           <StructuredListRow>
             <StructuredListCell noWrap>