feat(react-popover): expose base hooks and types for Popover and PopoverSurface

change/@fluentui-react-popover-a3c1e72b-5d8f-4901-bc34-7f2e9d0a1b4c.json

@@ -0,0 +1,7 @@
+{
+  "type": "minor",
+  "comment": "feat: expose base hooks for Popover and PopoverSurface",
+  "packageName": "@fluentui/react-popover",
+  "email": "dmytrokirpa@microsoft.com",
+  "dependentChangeType": "patch"
+}

packages/react-components/react-popover/library/etc/react-popover.api.md

@@ -38,6 +38,12 @@ export type OpenPopoverEvents = MouseEvent | TouchEvent | React_2.FocusEvent<HTM
 // @public
 export const Popover: React_2.FC<PopoverProps>;
 
+// @public (undocumented)
+export type PopoverBaseProps = Omit<PopoverProps, 'appearance' | 'size'>;
+
+// @public (undocumented)
+export type PopoverBaseState = Omit<PopoverState, 'appearance' | 'components' | 'size' | 'surfaceMotion'>;
+
 // @public
 export type PopoverContextValue = Pick<PopoverState, 'open' | 'toggleOpen' | 'setOpen' | 'triggerRef' | 'contentRef' | 'openOnHover' | 'openOnContext' | 'mountNode' | 'withArrow' | 'arrowRef' | 'size' | 'appearance' | 'trapFocus' | 'inertTrapFocus' | 'inline'>;
 
@@ -86,6 +92,12 @@ export type PopoverState = ComponentState<InternalPopoverSlots> & Pick<PopoverPr
 // @public
 export const PopoverSurface: ForwardRefComponent<PopoverSurfaceProps>;
 
+// @public (undocumented)
+export type PopoverSurfaceBaseProps = PopoverSurfaceProps;
+
+// @public (undocumented)
+export type PopoverSurfaceBaseState = Omit<PopoverSurfaceState, 'appearance' | 'size'>;
+
 // @public (undocumented)
 export const popoverSurfaceClassNames: SlotClassNames<PopoverSurfaceSlots>;
 
@@ -128,20 +140,26 @@ export type PopoverTriggerState = {
 export const renderPopover_unstable: (state: PopoverState) => JSXElement;
 
 // @public
-export const renderPopoverSurface_unstable: (state: PopoverSurfaceState) => JSXElement;
+export const renderPopoverSurface_unstable: (state: PopoverSurfaceBaseState) => JSXElement;
 
 // @public
 export const renderPopoverTrigger_unstable: (state: PopoverTriggerState) => JSXElement | null;
 
 // @public
 export const usePopover_unstable: (props: PopoverProps) => PopoverState;
 
+// @internal
+export const usePopoverBase_unstable: (props: PopoverBaseProps) => PopoverBaseState;
+
 // @public (undocumented)
 export const usePopoverContext_unstable: <T>(selector: ContextSelector<PopoverContextValue, T>) => T;
 
 // @public
 export const usePopoverSurface_unstable: (props: PopoverSurfaceProps, ref: React_2.Ref<HTMLDivElement>) => PopoverSurfaceState;
 
+// @internal
+export const usePopoverSurfaceBase_unstable: (props: PopoverSurfaceBaseProps, ref: React_2.Ref<HTMLDivElement>) => PopoverSurfaceBaseState;
+
 // @public
 export const usePopoverSurfaceStyles_unstable: (state: PopoverSurfaceState) => PopoverSurfaceState;
 

packages/react-components/react-popover/library/src/components/PopoverSurface/renderPopoverSurface.tsx

@@ -3,12 +3,12 @@
 import { assertSlots } from '@fluentui/react-utilities';
 import type { JSXElement } from '@fluentui/react-utilities';
 import { Portal } from '@fluentui/react-portal';
-import type { PopoverSurfaceSlots, PopoverSurfaceState } from './PopoverSurface.types';
+import type { PopoverSurfaceBaseState, PopoverSurfaceSlots } from './PopoverSurface.types';
 
 /**
  * Render the final JSX of PopoverSurface
  */
-export const renderPopoverSurface_unstable = (state: PopoverSurfaceState): JSXElement => {
+export const renderPopoverSurface_unstable = (state: PopoverSurfaceBaseState): JSXElement => {
   assertSlots<PopoverSurfaceSlots>(state);
 
   const surface = (

packages/react-components/react-popover/library/src/index.ts

@@ -1,21 +1,30 @@
-export { Popover, renderPopover_unstable, usePopover_unstable } from './Popover';
-export type { OnOpenChangeData, OpenPopoverEvents, PopoverProps, PopoverSize, PopoverState } from './Popover';
+export { Popover, renderPopover_unstable, usePopover_unstable, usePopoverBase_unstable } from './Popover';
+export type {
+  OnOpenChangeData,
+  OpenPopoverEvents,
+  PopoverProps,
+  PopoverSize,
+  PopoverState,
+  PopoverBaseProps,
+  PopoverBaseState,
+} from './Popover';
 export {
   PopoverSurface,
   arrowHeights,
   popoverSurfaceClassNames,
   renderPopoverSurface_unstable,
   usePopoverSurfaceStyles_unstable,
   usePopoverSurface_unstable,
+  usePopoverSurfaceBase_unstable,
+} from './PopoverSurface';
+export type {
+  PopoverSurfaceProps,
+  PopoverSurfaceSlots,
+  PopoverSurfaceState,
+  PopoverSurfaceBaseProps,
+  PopoverSurfaceBaseState,
 } from './PopoverSurface';
-export type { PopoverSurfaceProps, PopoverSurfaceSlots, PopoverSurfaceState } from './PopoverSurface';
 export { PopoverProvider, usePopoverContext_unstable } from './popoverContext';
 export type { PopoverContextValue } from './popoverContext';
 export { PopoverTrigger, renderPopoverTrigger_unstable, usePopoverTrigger_unstable } from './PopoverTrigger';
 export type { PopoverTriggerChildProps, PopoverTriggerProps, PopoverTriggerState } from './PopoverTrigger';
-
-// Experimental APIs
-// export type { PopoverBaseProps, PopoverBaseState } from './Popover';
-// export { usePopoverBase_unstable } from './Popover';
-// export type { PopoverSurfaceBaseProps, PopoverSurfaceBaseState } from './PopoverSurface';
-// export { usePopoverSurfaceBase_unstable } from './PopoverSurface';