@synerise/ds-popover 1.5.0 → 1.5.2

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.5.2](https://github.com/Synerise/synerise-design/compare/@synerise/ds-popover@1.5.1...@synerise/ds-popover@1.5.2) (2026-03-20)
+
+**Note:** Version bump only for package @synerise/ds-popover
+
+## [1.5.1](https://github.com/Synerise/synerise-design/compare/@synerise/ds-popover@1.5.0...@synerise/ds-popover@1.5.1) (2026-02-23)
+
+### Bug Fixes
+
+- **date-range-picker:** limitshift for large popover content ([42135c1](https://github.com/Synerise/synerise-design/commit/42135c1f715a3ba0c8c72bb797e4039d047d77c3))
+
 # [1.5.0](https://github.com/Synerise/synerise-design/compare/@synerise/ds-popover@1.4.0...@synerise/ds-popover@1.5.0) (2026-02-19)
 
 ### Features

package/README.md

@@ -9,15 +9,19 @@ Popover UI Component
 ```
 npm i @synerise/ds-popover
 or
+pnpm add @synerise/ds-popover
+or
 yarn add @synerise/ds-popover
 ```
 
 ## Usage
-```
-import Popover from '@synerise/ds-popover'
-
-<Popover />
+```jsx
+import Popover, { PopoverTrigger, PopoverContent } from '@synerise/ds-popover'
 
+<Popover>
+  <PopoverTrigger><button>Open</button></PopoverTrigger>
+  <PopoverContent>Content</PopoverContent>
+</Popover>
 ```
 
 ## Demo
@@ -28,3 +32,25 @@ import Popover from '@synerise/ds-popover'
 
 | Property | Description | Type | Default |
 | --- | --- | --- | --- |
+| placement | Floating-ui placement | `Placement` | `'bottom'` |
+| trigger | Interaction type to open popover | `'click' \| 'hover' \| ('click' \| 'hover')[]` | `'click'` |
+| open | Controlled open state | `boolean` | - |
+| onOpenChange | Controlled open/close handler | `(open: boolean, event?: Event, reason?: OpenChangeReason) => void` | - |
+| onDismiss | Called on escape-key or outside-press dismiss | `(event?: Event, reason?: OpenChangeReason) => void` | - |
+| modal | Trap focus inside popover | `boolean` | `false` |
+| initialOpen | Uncontrolled initial open state | `boolean` | `false` |
+| returnFocus | Return focus to trigger on close | `boolean` | `true` |
+| testId | Sets data-testid on trigger and content | `string` | `'noTestId'` |
+| componentId | Sets data-popover-{id} attribute on content | `string` | - |
+| zIndex | CSS z-index of floating panel | `number` | `theme.variables['zindex-dropdown']` |
+| autoUpdate | Reposition while both elements are mounted | `boolean \| AutoUpdateOptions` | - |
+| offsetConfig | floating-ui offset middleware options (add `enabled: false` to disable) | `OffsetConfig` | `{ enabled: true }` |
+| flipConfig | floating-ui flip middleware options | `FlipConfig` | `{ enabled: true }` |
+| shiftConfig | floating-ui shift middleware options | `ShiftConfig` | `{ enabled: true }` |
+| arrowConfig | floating-ui arrow middleware options (element managed by PopoverArrow) | `Omit<ArrowOptions, 'element'>` | `{}` |
+| hoverConfig | Extra options for useHover (e.g. restMs, move) | `HoverConfig` | `{}` |
+| dismissConfig | Extra options for useDismiss | `UseDismissProps` | `{}` |
+| listNavigationConfig | Keyboard list navigation config | `UseListNavigationProps` | `{ enabled: false }` |
+| transitionDuration | Transition duration in ms (enables CSS transitions) | `number` | - |
+| getTransitionConfig | Custom transition styles factory | `({ placement }) => Partial<UseTransitionStylesProps>` | opacity fade |
+| getPopupContainer | Custom portal root container | `(element: HTMLElement) => HTMLElement` | - |

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from './Popover';
 export * from './components';
 export { Popover as default } from './Popover';
-export { FloatingDelayGroup } from '@floating-ui/react';
+export { limitShift, FloatingDelayGroup } from '@floating-ui/react';
 export * from './Popover.types';
 export { getPlacement } from './utils/getPlacement';
 export { HOVER_CLOSE_DELAY, HOVER_OPEN_DELAY, PLACEMENT_MAP, } from './Popover.const';

package/dist/index.js

@@ -1,7 +1,7 @@
 export * from './Popover';
 export * from './components';
 export { Popover as default } from './Popover';
-export { FloatingDelayGroup } from '@floating-ui/react';
+export { limitShift, FloatingDelayGroup } from '@floating-ui/react';
 export * from './Popover.types';
 export { getPlacement } from './utils/getPlacement';
 export { HOVER_CLOSE_DELAY, HOVER_OPEN_DELAY, PLACEMENT_MAP } from './Popover.const';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synerise/ds-popover",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Popover UI Component for the Synerise Design System",
   "license": "ISC",
   "repository": "Synerise/synerise-design",
@@ -45,5 +45,5 @@
     "react": ">=16.9.0 <= 18.3.1",
     "styled-components": "^5.3.3"
   },
-  "gitHead": "b3d1312cbfbe69aba1cb5667b54be7f76938156c"
+  "gitHead": "8efc031fa688c0b87c7b3915bae93546bb63bcac"
 }