feat: added segmented controls component

[giuliana-gladeye]

Add SegmentedControls component

Added SegmentedControls component, refactored from the single purpose ListOrGridViewToggle into a reusable control that supports a developer-defined set of options.

Features:

• Renders any number of segments via an options array, controlled by value / onValueChange.
• Each option supports a prefix icon, a required label, and an optional suffix slot.
• display prop mirroring Badge: both (default), text-only, and icon-only. icon-only falls back to both if any option lacks an icon, and uses the mandatory label as the accessible label/tooltip.
• Active segment is highlighted with the primary button colour via a sliding indicator that measures segment widths (so it aligns with variable-width text) and stays in sync on resize.
• Docs page and interactive demos under the demo package.

Linear ticket

[Shrinks99]

Will review style before merging!

[giuliana-gladeye]

@Shrinks99 updates:

• Added TypeScript (@deprecated JSDoc)
• Added deprecated schema fields to docs frontmatter
• Deprecated ListOrGridViewToggle component