chore: announce search results in side navigation

[ToMESSKa]

INSTUI-4243

ISSUE:

• search results in documentation's side navigation are not announced

TEST PLAN:

• navigate to the "Find…" search bar in the side navigation using different screen readers
• type a search term (e.g., "color" or "select")
• the screen reader should:
  • announce the number of results available
  • clearly indicate when no results are available

[Copilot]

Pull Request Overview

This PR addresses screen reader accessibility for the documentation side navigation by announcing search results.

• Introduces a new state property "announcement" to hold the result message.
• Implements new methods (announceResults and countSearchResults) to update and calculate announcements.
• Inserts an Alert component for screen reader announcements.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
packages/docs/src/Nav/props.ts	Adds a new "announcement" property to the NavState interface.
packages/docs/src/Nav/index.tsx	Implements announcement logic in search handling and renders an Alert for screen reader feedback.

Comments suppressed due to low confidence (2)

packages/docs/src/Nav/props.ts:62

• Consider adding inline documentation for the 'announcement' property to clarify its intended usage in accessibility announcements.

announcement: string | null

packages/docs/src/Nav/index.tsx:113

• Consider verifying that the component is still mounted before calling setState within the delayed callback to prevent potential state updates on an unmounted component.

this.setState({ announcement: message })

[github-actions]

PR Preview Action v1.6.1
Preview removed because the pull request was closed.
2025-06-13 10:11 UTC

[matyasf]

looks good, I've tested with VoiceOver on OSX, JAWS and NVDA on Windows 11

[joyenjoyer]

gj