[tmccoy14]

Summary

Ports Studio's switcher Retry (eqtylab/guardian#533) into NavSwitcher and releases @eqtylab/equality 5.0.2, so eqtylab/guardian#536 can swap Studio's copy for this one without losing it.

<NavSwitcher
  {...props}
  error={projectsQuery.isError}
  retrying={projectsQuery.isFetching}
  onRetry={() => projectsQuery.refetch()}
/>

• Error row: with error, the list shows "Couldn't load {collection}." and a Retry row above any options it already has. A search that matches nothing still says "No {collection} found".
• Retry: picking Retry calls onRetry and keeps the list open. With retrying the row reads "Retrying..." and is aria-disabled. The types require onRetry with error.
• Screen readers: the search box is described by the error when the list opens. A live region announces "Retrying...", a repeat failure, and "Loaded {collection}." or "No {collection} found.". A background refetch of a list that never failed announces nothing.
• Retry that finds nothing: the open list stays until it closes, then becomes the plain heading, so focus isn't dropped under the user.
• Closed-list guard: before the trigger mounts, or inside a <form>, Radix's hidden native select can pick Retry; that's ignored while closed, which stops a refetch loop.
• One option stays a switcher (Changed): it was a plain heading. This matches Studio since #533; apps showing one item will see a dropdown appear.
• Spinner renders spans, so it is valid inside an option. It looks the same.
• Docs: a "When the List Fails to Load" section with a live demo (the first Retry fails, the second loads, and Reset starts it over), and the new props.

Testing

• pnpm format:check, pnpm lint, pnpm test (162 passed) and pnpm build pass.
• The form guard, Escape after Retry, the background-refetch announcement and the retry that finds nothing each fail without their fix.
• In Studio, with this build in place of Studio's own NavSwitcher, the switcher specs give the same result as on 5.0.1: 154 passed. The five that fail on both are styling differences between Studio's switcher and Equality's, and Studio's loading row. #536 deals with them.

🤖 Generated with Claude Code