Add ToolbarSeparator component and split Toolbar documentation into focused pages

[Copilot]

Adds support for visual section dividers within a single Toolbar, as seen in canvas-based tools (Miro, Figma). The separator automatically renders perpendicular to the toolbar direction.

Added

• ToolbarSeparator component — horizontal rule in vertical toolbars, vertical rule in horizontal toolbars; includes correct role="separator" and aria-orientation
• WithSeparators Storybook story demonstrating a horizontal toolbar with grouped sections
• CSS classes toolbar-separator--in-vertical / toolbar-separator--in-horizontal with align-self: stretch for automatic cross-axis sizing

<Toolbar orientation='horizontal'>
    <ToolbarButton icon='pi pi-th-large' tooltip='Overview' tooltipPosition='bottom' />
    <ToolbarSeparator orientation='horizontal' />
    <ToolbarButton icon='pi pi-minus' tooltip='Zoom out' tooltipPosition='bottom' />
    <ToolbarButton icon='pi pi-plus' tooltip='Zoom in' tooltipPosition='bottom' />
    <ToolbarSeparator orientation='horizontal' />
    <ToolbarButton icon='pi pi-question-circle' tooltip='Help' tooltipPosition='bottom' />
</Toolbar>

Changed

• Documentation/Toolbar/index.md reduced to overview + components table; each topic split into its own page (basic-usage, orientation, active-state, context-switching, fan-out, multiple-groups, tooltip-position, sections)
• Documentation/Toolbar/toc.yml updated to list all new pages
• ToolbarSeparator and ToolbarSeparatorProps exported from Source/Toolbar/index.ts

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add support for sections in the toolbar</issue_title>
<issue_description>See the image:

It has different sections separated with a vertical line.
We want to support this. When toolbar is vertically, the line obviously need to be horizontally.

Fix the documentation by splitting out every topic in the Overview page for the toolbar as separate pages and add a page for this new capability.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Add support for sections in the toolbar #18

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.