DS-056: Add a reusable CommandMenu shell

[IbrahimIjai]

Context

SO4 will need fast keyboard navigation as product routes and actions grow. The
shell should be reusable without embedding a fixed command catalog.

Scope

• Build a modal command menu using the shared Dialog and Combobox primitives.
• Support groups, actions, navigation results, empty results, and shortcut hints.
• Expose a controlled API for query, open state, and result activation.
• Add a small example catalog in the design-system gallery only.

Acceptance criteria

• Opening the menu moves focus to search; closing restores trigger focus.
• Keyboard navigation and result activation work without a pointer.
• Results expose names, optional descriptions, icons, and shortcut hints.
• Empty and no-match states use shared feedback primitives.
• Tests cover opening, filtering, activation, Escape, and focus restoration.

Out of scope

• Adding a production global shortcut.
• Defining product analytics or a complete SO4 command catalog.

[Ameer-5-5]

@Ameer-5-5 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello sir maintainer....
I have a vast experience in solving github issues ...
Please do well to assign me this let me get it done for you ✅.
Thank you 😊

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Ameer-5-5 to this issue.

[Ssoleed]

@Ssoleed has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

please kindly assign to me, i can work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Ssoleed to this issue.

[samuelelijah585]

@samuelelijah585 has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello, I've reviewed the issue and its acceptance criteria, and I'm confident I can deliver a solution that meets the requirements. I'd appreciate it if you could assign this issue to me. Thank you!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @samuelelijah585 to this issue.

[Oluwatomilola]

@Oluwatomilola has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi Maintainer.
I can fix this issue. kindly assign.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwatomilola to this issue.

[Nwapu-TrustJah]

@Nwapu-TrustJah has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Good day Maintainer !
I’d love to take on this issue.
Having a modular command palette will be huge for SO4's keyboard navigation as the route list and actions expand.
Here’s my plan for the implementation:
Component Setup:
Build the modal command menu leveraging our existing Dialog and Combobox primitives.
Structure it to support groups, actions, navigation items, empty/no-match feedback states, and shortcut hints.
Expose a clean, controlled API for managing search query, open/closed states, and activation handlers.
Focus & Accessibility:
Ensure focus transfers directly to the search input on open and safely restores to the trigger element when closed/Escaped.
Verify complete pointer-free keyboard navigation and activation flow.
Gallery & Test Coverage:
Add a small example command catalog in the design-system gallery to showcase usage.
Write unit tests covering opening/closing mechanics, query filtering, action execution, Escape key handling, and focus restoration.
I’ll keep the PR tightly scoped to the reusable component and gallery example, leaving production global shortcuts and product-specific command catalogs out of scope.
Mind assigning this to me so I can get started?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Nwapu-TrustJah to this issue.

[emarkees]

@emarkees has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi, I can help you fix this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @emarkees to this issue.

[drips-wave]

Congratulations, @Oluwatomilola! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @Oluwatomilola: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@Oluwatomilola's PR #486 was approved and merged by @IbrahimIjai.

🏆 @Oluwatomilola: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (449 total points). Track your full progress on GrantFox.

👏 Great work, @Oluwatomilola! Keep contributing to SO4-Markets.

[drips-wave]

This issue has been completed by @Oluwatomilola as part of the Stellar Wave Program's 7th Wave 🥳

😎 @Oluwatomilola: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.