feat(ui): polish core component surfaces

apps/docs/src/components/combobox.stories.tsx

@@ -222,6 +222,12 @@ const meta = {
   title: "Components/Combobox",
   component: ControlledDemo,
   parameters: {
+    docs: {
+      description: {
+        component:
+          "Combobox is the searchable single-select surface for longer option sets, recent picks, and async lookup flows. The list should feel gently staged as results appear, with active rows gliding into place instead of snapping."
+      }
+    },
     layout: "centered"
   },
   tags: ["autodocs"]
@@ -240,6 +246,14 @@ export const RecentAndSuggested: Story = {
 };
 
 export const AsyncResults: Story = {
+  parameters: {
+    docs: {
+      description: {
+        story:
+          "Async comboboxes should crossfade between loading, empty, and result states. Keep the motion short and directional so the user understands the state change without losing the current context."
+      }
+    }
+  },
   render: () => <AsyncResultsDemo />
 };