Oleksandr Fediashov

This commit introduces the new `MotionRefForwarderReset` component within the **`@fluentui/react-motion`** package to **fix a critical context leaking issue** affecting motion references. This component ensures that the `MotionRefForwarder` context is properly isolated and reset for its children, preventing unintended motion effects from propagating to unrelated components. The fix is immediately applied to the **`@fluentui/react-dialog`** package, where `DialogSurfaceProvider` is now wrapped with `MotionRefForwarderReset` in `renderDialogSurface.tsx` to prevent motion ref context from leaking to dialog children. This **enhancement** improves the stability and predictability of motion animations, with new tests and documentation added for the new component.

This commit delivers a **bug fix** for the **`Tab` component** within the **`@fluentui/react-tabs` package**, addressing an issue where `tabster` attributes could not be properly overridden. The core change adjusts the attribute merging logic within the `useTab_unstable` hook to ensure that custom `tabster` properties provided by consumers are correctly applied. This **fix** enhances the flexibility and control developers have over the `Tab` component's accessibility and focus management, preventing unintended attribute conflicts. A new test case has been added to validate this override functionality and prevent future regressions.

This commit introduces a **new capability** to define **pinned items** within the **`@fluentui/react-overflow`** and **`@fluentui/priority-overflow`** components. It modifies the `OverflowItem` component and `useOverflowItem` hook to accept a `pinned` property, ensuring that these items are always visible and never hidden by overflow calculations. The `overflowManager` is updated to prioritize pinned items, preventing them from being hidden. API documentation for `OverflowItemEntry` and `OverflowItemProps` is extended to reflect this change, providing developers with a new way to control item visibility. Comprehensive Cypress tests and storybook examples have been added to validate and demonstrate this enhancement.

This commit delivers a **bug fix** for the **`ToolbarRadioButton` component** within the **`react-toolbar` package**, addressing an issue where the component did not correctly respect its `size` prop. The `useToolbarRadioButton_unstable` hook has been modified to prioritize the `size` prop passed directly to the component over any size derived from its context. This ensures that developers can reliably control the button's size via props, and new tests have been added to validate this correct behavior and prioritization.

This commit introduces a crucial **bug fix** to prevent **memory leaks** within the **`@fluentui/react-motion`** package. It addresses an issue where animation handles were not properly disposed of when a component unmounted, leading to resource accumulation. The change involves **refactoring** the animation handle creation in `useAnimateAtoms` to include a `dispose` method, which is then called via a `useEffect` hook in `createPresenceComponent` upon component unmount. This ensures that animation resources are correctly released, improving the stability and performance of applications utilizing Fluent UI's motion capabilities.

This commit **fixes** a styling issue within the **Fluent UI React Toolbar** package, specifically for the `ToolbarGroup` component. It introduces a new `vertical` property to the `ToolbarGroupState` interface and updates the `useToolbarGroup` hook to retrieve this orientation from the toolbar context. Consequently, the `useToolbarGroupStyles` hook now applies **conditional styling** based on this `vertical` state, ensuring that `ToolbarGroup` elements render correctly when arranged vertically. This **bug fix** enhances the visual consistency and layout flexibility of the **Toolbar** component by enabling proper styling for its vertical configurations.

This commit performs a **maintenance chore** to synchronize the repository with an upcoming or recent **NPM release** of the **Fluent UI React components** and related packages. It involves adding numerous new change files (e.g., `change/@fluentui-react-accordion-...json`) for release tracking across a wide array of `@fluentui` packages. Concurrently, the `CHANGELOG.json` files for these packages, such as `@fluentui/react-button`, `@fluentui/react-charts`, and `@fluentui/tokens`, are updated to reflect new version entries. This ensures proper versioning and release documentation for a significant portion of the Fluent UI library, impacting nearly all **Fluent UI React components** and foundational utilities.

This commit introduces a **new capability** to the **MenuTrigger** component, enhancing its keyboard event handling. Specifically, the `onKeyDown` event listener in `packages/react-components/react-menu/library/src/components/MenuTrigger/useMenuTrigger.ts` is updated to check `event.isDefaultPrevented()`. This allows external event handlers to explicitly prevent the default browser action for a key press, which the **MenuTrigger** will now respect. This change provides greater control and flexibility over **Menu** component interactions, ensuring consistent behavior when default actions are already prevented by other handlers.

This commit **enhances the test suite** for the **`Portal` component** within the `react-18-tests-v9` application. It introduces **new Cypress tests** to specifically verify the component's critical behavior of correctly creating and removing elements directly from the document `body`. This **test enhancement** improves the **reliability and robustness** of the `Portal` component by ensuring its fundamental DOM manipulation capabilities are thoroughly validated.

This commit delivers a **bug fix** for the **`react-toolbar`** package, resolving an issue where **style overrides were not properly applied** to the `ToolbarButton`, `ToolbarRadioButton`, and `ToolbarToggleButton` components. The fix involves reordering the class merging and base style hook calls within the `useToolbarButtonStyles_unstable`, `useToolbarRadioButtonStyles_unstable`, and `useToolbarToggleButtonStyles_unstable` style hooks. This ensures that custom styles provided by consumers are now correctly rendered, significantly improving the visual customization and consistency of these core toolbar elements.

This commit **fixes a regression** in the **`react-menu` component** that caused incorrect handling of **hover delays**, particularly affecting nested menus and safe zone interactions. The **bug fix** involves **refactoring the core logic** within `useMenu_unstable` and `useMenuTrigger_unstable` to correctly manage mouse movement tracking, safe zone timeouts, and the application of hover delays. A new `ignoreHoverDelay` parameter is also introduced to the `setOpen` function, providing more granular control over menu opening behavior. This ensures users of the **`react-menu` component** experience consistent and predictable hover delay functionality, preventing unintended menu state changes, and is validated with updated API documentation and new test cases.

This commit **integrates the `useSafeZoneArea()` hook** into the **`react-menu` package**, introducing a **new capability** to enhance menu interaction. It implements a "safe zone" feature that prevents menus from closing prematurely when the mouse briefly exits the menu or its trigger, significantly improving user experience. This involves **extending the API** for `Menu`, `MenuPopover`, and `MenuTrigger` components with new `safeZone` properties and event types, and implementing the core logic within `useMenu_unstable` and `useMenuPopover_unstable`. The change also includes a new utility hook `useOnMenuSafeZoneTimeout` and comprehensive Cypress tests to validate the new functionality.

This commit **reverts the previous addition of React 19 support** for the **`@fluentui-react-portal` package**, effectively removing the experimental compatibility. Concurrently, it introduces a **bug fix** within the `usePortal_unstable` hook by correctly including `virtualParentRootRef` in its dependency array, addressing potential rendering issues. Furthermore, the `usePortalMountNode` hook undergoes a **refactoring** to simplify its implementation by removing separate element factories and utilizing `useDisposable`. This ensures the `react-portal` component remains stable on current React versions while its internal structure is improved.

This commit introduces a **bug fix** and **refactoring** within the **`react-positioning` package**, specifically addressing the **`useSafeZoneArea` hook**. It **stops unnecessary `requestAnimationFrame` calls** when there is no mouse movement, preventing continuous resource usage and improving performance. The `useSafeZoneArea` hook was refactored to leverage `useTimeout` and `useAnimationFrame` for more precise control, ensuring the safe zone correctly hides after a timeout. This change guarantees the intended behavior of safe zone elements in UI components and includes updated tests to verify the fix.

This commit significantly **enhances the `useSafeZoneArea` hook** within the **`@fluentui-react-positioning`** package, enabling more robust calculation and rendering of safe zones for various rectangle shapes. It involves a substantial **refactoring** of the hook's internal logic, introducing new utility functions for geometric calculations and SVG path generation, and replacing the old `SafeZoneArea` component with an improved implementation. As part of this **feature improvement**, both `usePositioning` and the updated `useSafeZoneArea` hooks, along with `UseSafeZoneOptions`, are now **exported from the main `@fluentui-react-components` package**. This provides developers with a more powerful and flexible tool for managing UI element positioning, supported by **updated API documentation and new Storybook examples**.

This commit **sets up Storybook** for the **`@fluentui/react-positioning`** package, significantly enhancing its development and documentation capabilities. It involves a **major refactoring** of the package's internal structure, introducing dedicated `library` and `stories` subdirectories to separate core code from Storybook configurations and examples. This **maintenance chore** updates numerous build and development tool configurations, including Babel, Jest, API Extractor, TypeScript, ESLint, and Nx, to reflect the new file organization. The primary impact is enabling visual development and testing of the positioning hooks and components within Storybook, streamlining future feature development and bug fixes for this module.

This commit delivers a **bug fix** and **optimization** for the `**@fluentui/react-positioning**` package, specifically enhancing its update logic. It refactors the `useSafeZoneArea` hook to employ a `requestAnimationFrame` loop for continuous and efficient SVG updates when the safe zone is active, alongside refined mouse move handling. Additionally, the `SafeZoneArea` component's `toggleActive` function now prevents redundant state updates, improving performance. This work ensures smoother and more stable positioning behavior by reducing unnecessary re-renders and optimizing the update mechanism for components utilizing safe zones.

This commit **introduces a new `useSafeZoneArea()` hook and `SafeZoneArea` component** to the **`@fluentui-react-positioning` package**, providing a **new capability** for managing and visualizing "safe zones" in UI positioning. The `useSafeZoneArea()` hook handles the logic for safe zone visibility and interactions, while the `SafeZoneArea` component renders a visual SVG representation, aiding in debugging and ensuring proper element placement. This enhancement allows developers to define areas where positioned elements should not overlap, improving control over UI layout and preventing undesirable collisions. Comprehensive **unit, Cypress, and visual regression tests** have been added to validate its behavior across various scenarios, ensuring reliable integration and functionality. The API documentation has also been updated to reflect these new additions.

This commit delivers **React 19 compatibility** and **improved concurrent mode support** for the **`@fluentui/react-portal`** package. It primarily involves a **refactoring** of the `usePortalMountNode` hook to conditionally use legacy or modern element factories, adapting to React 19's rendering mechanisms. Additionally, a **bug fix** in `usePortal_unstable` removes `virtualParentRootRef` from a `useEffect` dependency array, preventing unnecessary re-renders and enhancing performance. These **maintenance updates** ensure the **Fluent UI Portal component** functions correctly and efficiently in newer React environments, particularly when leveraging concurrent features.

This commit **introduces a shared positioning configuration system** for Fluent UI components, providing a **new capability** to manage layout options centrally. A new `PositioningConfigurationProvider` and context are added to the **`@fluentui/react-positioning`** package, allowing developers to define and apply common positioning settings across their application. This involves **refactoring** existing positioning hooks, such as `usePositioning`, to integrate with the new context, and includes new Storybook examples in `apps/vr-tests-react-components` to demonstrate its usage. The change significantly improves the consistency, flexibility, and maintainability of positioning logic by offering a unified configuration mechanism.