Dmytro Kirpa

This commit introduces the **`useFieldBase_unstable` hook** within the **`@fluentui-react-field` package**, providing a foundational, headless API for managing core field state without design-specific properties. This **new capability** refactors the existing `useField_unstable` hook to leverage this base logic, promoting better separation of concerns within the **`Field` component's** state management. It also adds `FieldBaseProps` and `FieldBaseState` types to support this new abstraction, along with comprehensive test cases. This change enables more flexible and **customizable field implementations** by exposing the underlying state management, though the `_unstable` suffix indicates its experimental nature.

This commit introduces a **new capability** and performs a **refactoring** within the **`react-label`** package by adding the `useLabelBase_unstable` hook. This new hook, along with `LabelBaseProps` and `LabelBaseState` types, encapsulates the core, design-agnostic logic for the Label component, promoting better separation of concerns. The existing `useLabel_unstable` hook is refactored to utilize `useLabelBase_unstable`, streamlining its implementation. This architectural improvement enhances maintainability and is fully reflected in the updated API documentation.

This commit **enhances the public documentation site (v9)** by adding comprehensive guidance on **building custom controls** using **Fluent UI's base state hooks** and associated authoring patterns. A new document, `BuildingCustomControls.mdx`, provides detailed explanations for developers. Existing conceptual documentation, including `AdvancedStylingTechniques.mdx`, `Slots.mdx`, and `StylingComponents.mdx`, has been updated with cross-references to ensure discoverability of this new content. This **documentation enhancement** significantly improves the developer experience for those creating custom components within the Fluent UI ecosystem.

This commit introduces the **`useSpinButtonBase_unstable` hook** within the **`@fluentui/react-spinbutton`** package, representing a **new feature** and **architectural refactoring**. It extracts the core logic for spin button functionality, allowing the existing `useSpinButton_unstable` hook to extend it specifically for handling appearance and size properties. This change also defines and exports new types, `SpinButtonBaseProps` and `SpinButtonBaseState`, and updates `renderSpinButton_unstable` to utilize the new base state. The primary impact is providing a more modular and reusable foundation for the `SpinButton` component, offering greater flexibility for advanced consumers to build custom spin button experiences.

This commit **fixes a regression** in the **`PresenceBadge` component** within the **`react-badge` package**, specifically addressing an issue where the `aria-label` was incorrectly applied or missing. It **corrects the handling of the `status` prop** within the `usePresenceBadge` hook to ensure proper `aria-label` generation for various presence states. Additionally, a **new parameterized test** has been added to validate the correct `aria-label` rendering, improving the component's **accessibility** and preventing future regressions. This ensures screen reader users receive accurate information about the badge's status.

This commit introduces **new base state hooks** for the **Fluent UI React Radio** and **RadioGroup** components, specifically `useRadioBase_unstable` and `useRadioGroupBase_unstable`. This **API enhancement** provides advanced consumers with direct access to the core state management logic, enabling more flexible and custom implementations of these components. It also involves an **internal refactoring** within the `react-radio` package to separate base state concerns from component-specific rendering, improving modularity. The new `RadioBaseProps`, `RadioBaseState`, `RadioGroupBaseProps`, and `RadioGroupBaseState` types are also exported and documented, allowing for greater control over component behavior.

This commit introduces **new capabilities** to the **`@fluentui-react-accordion`** package by exposing **base hooks and types** for `Accordion` and `AccordionHeader` components. It defines and exports new types like `AccordionHeaderBaseProps` and `AccordionHeaderBaseState`, and introduces `useAccordionHeaderBase_unstable`, `useAccordionBase_unstable`, and `useAccordionPanelBase_unstable` hooks. This **refactoring** separates core component logic from styling, allowing developers to leverage these unstyled, foundational primitives for building highly customized Accordion experiences. The public API and documentation have been updated to reflect these new exports, providing greater flexibility for component extension and state management.

This commit introduces a **new set of base hooks and associated types** for the **`react-card` package** and its sub-components, including `Card`, `CardFooter`, `CardHeader`, and `CardPreview`. It adds `useCardBase_unstable` and similar base hooks, along with `CardBaseProps` and `CardBaseState` types, which encapsulate core, design-agnostic logic and properties. This **refactoring** allows existing hooks like `useCard_unstable` to build upon these new base implementations, creating a more modular and maintainable component architecture. The change **enhances the internal structure** of the `react-card` components, providing a foundational layer for future development and consistency.

This commit performs a **maintenance chore** by updating the **code owners** for the **`react-radio` packages** within the `.github/CODEOWNERS` configuration file. This change ensures that the appropriate individuals or teams are automatically requested for review on pull requests affecting these specific components, thereby streamlining the **code review process**. Additionally, minor formatting adjustments were applied to the `Pivot` and `fluent2-theme` entries in the same file, without altering their ownership. The primary impact is on repository management and the efficiency of contributions to the `react-radio` component suite.

This commit **introduces new base hooks and types** for the **`react-rating`** package, specifically for the `Rating`, `RatingDisplay`, and `RatingItem` components. It adds `useRatingBase_unstable`, `useRatingDisplayBase_unstable`, and `useRatingItemBase_unstable` along with their corresponding `BaseProps` and `BaseState` types. This **refactoring** separates core component logic from design-specific properties, allowing existing hooks like `useRating_unstable` to build upon these new, lower-level primitives. The change **enhances the `react-rating` package's extensibility and maintainability**, providing a more granular and flexible foundation for component customization, with the new base hooks marked as unstable for future evolution.

This commit introduces a **new capability** to the **`@fluentui-react-link` package** by adding the `useLinkBase_unstable` hook. This **refactoring** separates the core logic of the `Link` component from its design-specific properties, improving modularity and reusability. The existing `useLink_unstable` hook is updated to leverage this new base hook, and new types like `LinkBaseProps` and `LinkBaseState` are defined and exported. This change provides a more granular control over link functionality and prepares for future design system evolutions, with updated API documentation reflecting these additions.

This commit introduces a **new capability** by **exposing core base components and types** within the **`@fluentui/react-persona` package**. It makes the `usePersonaBase_unstable` hook, `PersonaBaseProps`, and `PersonaBaseState` types publicly available, allowing developers to leverage the foundational logic of the `Persona` component. This **enhances the extensibility** of the `Persona` component, enabling consumers to build custom `Persona`-like experiences or integrate its core functionality more deeply. The API documentation has been updated to reflect these new exports, providing clearer guidance for consumers.

This commit introduces the **`useImageBase_unstable` hook** and associated types (`ImageBaseProps`, `ImageBaseState`) within the **`@fluentui/react-image` package**. This **new capability** provides a foundational, unstable hook that encapsulates the core logic for an image component, promoting better code reuse. It also **refactors** the existing `useImage_unstable` hook to build upon this new base, improving modularity within the **`Image` component's** implementation. This architectural enhancement offers a more granular control over image state management for advanced scenarios and is reflected in updated API documentation.

This commit introduces a **new feature** by **exposing foundational hooks and types** from the **`@fluentui-react-button` package**. Specifically, the `useButtonBase_unstable` and `useToggleButtonBase_unstable` hooks, along with their corresponding `ButtonBaseProps`, `ButtonBaseState`, `ToggleButtonBaseProps`, and `ToggleButtonBaseState` types, are now publicly exported. This enhancement allows developers to **build custom button components** leveraging the core logic and accessibility features of Fluent UI's `Button` and `ToggleButton` components, promoting greater extensibility and consistency across applications. The API documentation has been updated to reflect these new exports, marking a minor release for the package.

This commit **introduces a new capability** to the **`@fluentui-react-spinner`** package by adding the `useSpinnerBase_unstable` hook. This **refactors** the `Spinner` component's internal logic, extracting core state management and props into a reusable base hook. The existing `useSpinner_unstable` now composes `useSpinnerBase_unstable`, promoting a clearer separation between fundamental spinner behavior and design-specific properties. This provides a more modular foundation for developers to build custom spinner experiences and updates the API documentation to reflect these new types and hooks.

This commit introduces a **new capability** by **exposing the base hook and associated types** for the **`Divider` component** within the `@fluentui-react-divider` package. Developers can now leverage `useDividerBase_unstable`, `DividerBaseProps`, and `DividerBaseState` to build **custom `Divider` implementations** or extend its functionality. This change involves a minor **refactoring** of the internal `renderDivider_unstable` function to accept the new `DividerBaseState`, ensuring consistency. The API documentation has been updated to reflect these new exports, providing greater flexibility and reusability for consumers of the **Fluent UI React components**.

This commit delivers a **bug fix** for the **Fluent UI React Toolbar** package, specifically addressing an issue within the `ToolbarToggleButton` component. It modifies the `useToolbarToggleButton` hook to correctly preserve the user-defined `appearance` prop, ensuring that the component's styling respects explicit user input. Previously, the hook would inadvertently override this prop, but now it only defaults to `'subtle'` if no `appearance` is explicitly provided. This change prevents unexpected visual behavior and ensures **user-defined styling** for `ToolbarToggleButton` components is consistently applied.

This commit introduces **new unstable base hooks and types** across the **`@fluentui-react-breadcrumb`** package, including `useBreadcrumbBase_unstable`, `useBreadcrumbButtonBase_unstable`, `useBreadcrumbDividerBase_unstable`, and `useBreadcrumbItemBase_unstable`. This **feature enhancement** refactors the existing `useBreadcrumb_unstable` and related component hooks to leverage these new base implementations, providing a more modular and reusable foundation. The change affects the `Breadcrumb`, `BreadcrumbButton`, `BreadcrumbDivider`, and `BreadcrumbItem` components by defining new `BaseProps` and `BaseState` types and exporting the new hooks. This work improves the internal architecture and extensibility of the Breadcrumb components, with all new APIs clearly marked as unstable.

This commit introduces a **new capability** to the **`@fluentui-react-search` package** by adding the `useSearchBoxBase_unstable` hook, along with its associated `SearchBoxBaseProps` and `SearchBoxBaseState` types. This **refactoring** separates the core state management logic of the `SearchBox` component from its design-specific properties, enabling more flexible and unstyled implementations. The existing `useSearchBox_unstable` hook is updated to build upon this new base, providing a clearer separation of concerns within the **`SearchBox` component**. This change enhances the composability of the `SearchBox` by exposing a lower-level primitive for advanced customization, with all new APIs and types being properly exported and documented.

This commit introduces a **new capability** for the **`@fluentui-react-switch`** package by **exposing the `useSwitchBase_unstable` hook** along with its **`SwitchBaseProps`** and **`SwitchBaseState`** types. This allows developers to access the foundational logic of the **`Switch` component**, enabling more flexible custom implementations or advanced integration scenarios. The internal `renderSwitch_unstable` function was **refactored** to consume the new `SwitchBaseState`, ensuring consistency with the exposed base. API documentation has been updated to reflect these additions, providing an **unstable** base for advanced customization of the `Switch` component.