@instructure/ui-popover 11.7.3 → 11.7.4-pr-snapshot-1781695314229

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [11.7.4-pr-snapshot-1781695314229](https://github.com/instructure/instructure-ui/compare/v11.7.3...v11.7.4-pr-snapshot-1781695314229) (2026-06-17)
+
+
+### Bug Fixes
+
+* **ui-date-input:** add scrollbar to dateinput v2 ([84f11c1](https://github.com/instructure/instructure-ui/commit/84f11c1c5638f9a91946b29125869115f66c5f0f))
+
+
+### Features
+
+* **ui-popover:** add shouldScrollContent prop ([288c43a](https://github.com/instructure/instructure-ui/commit/288c43ac739035424417e56dbd6a4659f938a492))
+
+
+
+
+
 ## [11.7.3](https://github.com/instructure/instructure-ui/compare/v11.7.2...v11.7.3) (2026-05-07)
 
 

package/LICENSE.md

@@ -2,6 +2,7 @@
 title: The MIT License (MIT)
 category: Getting Started
 order: 9
+isWIP: true
 ---
 
 # The MIT License (MIT)

package/{lib/Popover/v2/styles.js → babel.config.cjs}

@@ -1,9 +1,3 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
 /*
  * The MIT License (MIT)
  *
@@ -28,18 +22,15 @@ exports.default = void 0;
  * SOFTWARE.
  */
 
-/**
- * ---
- * private: true
- * ---
- * Generates the style object from the theme and provided additional information
- * @param  {Object} componentTheme The theme variable object.
- * @return {Object} The final style object, which will be used in the component
- */
-const generateStyle = componentTheme => {
-  return {
-    borderColor: componentTheme.borderColor,
-    borderRadius: componentTheme.borderRadius
-  };
-};
-var _default = exports.default = generateStyle;
+module.exports = {
+  presets: [
+    [
+      require('@instructure/ui-babel-preset'),
+      {
+        esModules: Boolean(process.env.ES_MODULES),
+        removeConsole: process.env.NODE_ENV === 'production',
+        transformImports: Boolean(process.env.TRANSFORM_IMPORTS)
+      }
+    ]
+  ]
+}

package/es/Popover/v1/index.js

@@ -35,9 +35,9 @@ import { createChainedFunction, shallowEqual, px, combineDataCid } from '@instru
 import { logError as error } from '@instructure/console';
 import { FocusRegion } from '@instructure/ui-a11y-utils';
 import { withStyle } from '@instructure/emotion';
-import generateStyle from "./styles.js";
-import generateComponentTheme from "./theme.js";
-import { allowedProps } from "../v1/props.js";
+import generateStyle from './styles.js';
+import generateComponentTheme from './theme.js';
+import { allowedProps } from '../v1/props.js';
 import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
 /**
 ---
@@ -46,7 +46,7 @@ tags: overlay, portal, dialog
 ---
 **/
 let Popover = (_dec = withDeterministicId(), _dec2 = textDirectionContextConsumer(), _dec3 = withStyle(generateStyle, generateComponentTheme), _dec(_class = _dec2(_class = _dec3(_class = class Popover extends Component {
-  static displayName = "Popover";
+  static displayName = 'Popover';
   static componentId = 'Popover';
   static allowedProps = allowedProps;
   static defaultProps = {

package/es/Popover/v2/index.js

@@ -35,8 +35,8 @@ import { createChainedFunction, shallowEqual, px, combineDataCid } from '@instru
 import { logError as error } from '@instructure/console';
 import { FocusRegion } from '@instructure/ui-a11y-utils';
 import { withStyleNew } from '@instructure/emotion';
-import generateStyle from "./styles.js";
-import { allowedProps } from "./props.js";
+import generateStyle from './styles.js';
+import { allowedProps } from './props.js';
 import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
 /**
 ---
@@ -45,7 +45,7 @@ tags: overlay, portal, dialog
 ---
 **/
 let Popover = (_dec = withDeterministicId(), _dec2 = textDirectionContextConsumer(), _dec3 = withStyleNew(generateStyle), _dec(_class = _dec2(_class = _dec3(_class = class Popover extends Component {
-  static displayName = "Popover";
+  static displayName = 'Popover';
   static componentId = 'Popover';
   static allowedProps = allowedProps;
   static defaultProps = {
@@ -408,6 +408,12 @@ let Popover = (_dec = withDeterministicId(), _dec2 = textDirectionContextConsume
   }
   renderContent() {
     let content = callRenderProp(this.props.children);
+    if (this.props.shouldScrollContent) {
+      content = _jsx("div", {
+        css: this.props.styles?.scrollContainer,
+        children: content
+      });
+    }
     if (this.shown && !this.isTooltip) {
       // if popover is NOT being used as a tooltip, create a Dialog
       // to manage the content FocusRegion, when showing

package/es/Popover/v2/props.js

@@ -22,5 +22,5 @@
  * SOFTWARE.
  */
 
-const allowedProps = ['isShowingContent', 'defaultIsShowingContent', 'on', 'withArrow', 'color', 'placement', 'shadow', 'stacking', 'contentRef', 'defaultFocusElement', 'screenReaderLabel', 'offsetX', 'offsetY', 'constrain', 'positionTarget', 'positionContainerDisplay', 'mountNode', 'insertAt', 'liveRegion', 'id', 'shouldAlignArrow', 'shouldTrackPosition', 'shouldRenderOffscreen', 'shouldContainFocus', 'shouldReturnFocus', 'shouldCloseOnDocumentClick', 'shouldCloseOnEscape', 'shouldFocusContentOnTriggerBlur', 'onShowContent', 'onHideContent', 'onPositioned', 'onPositionChanged', 'onClick', 'onFocus', 'onBlur', 'onKeyDown', 'onKeyUp', 'onMouseOver', 'onMouseOut', 'renderTrigger', 'children', 'elementRef', 'borderWidth', 'shouldSetAriaExpanded'];
+const allowedProps = ['isShowingContent', 'defaultIsShowingContent', 'on', 'withArrow', 'color', 'placement', 'shadow', 'stacking', 'contentRef', 'defaultFocusElement', 'screenReaderLabel', 'offsetX', 'offsetY', 'constrain', 'positionTarget', 'positionContainerDisplay', 'mountNode', 'insertAt', 'liveRegion', 'id', 'shouldAlignArrow', 'shouldTrackPosition', 'shouldRenderOffscreen', 'shouldContainFocus', 'shouldReturnFocus', 'shouldCloseOnDocumentClick', 'shouldCloseOnEscape', 'shouldFocusContentOnTriggerBlur', 'onShowContent', 'onHideContent', 'onPositioned', 'onPositionChanged', 'onClick', 'onFocus', 'onBlur', 'onKeyDown', 'onKeyUp', 'onMouseOver', 'onMouseOut', 'renderTrigger', 'children', 'elementRef', 'borderWidth', 'shouldSetAriaExpanded', 'shouldScrollContent'];
 export { allowedProps };

package/es/Popover/v2/styles.js

@@ -33,7 +33,14 @@
 const generateStyle = componentTheme => {
   return {
     borderColor: componentTheme.borderColor,
-    borderRadius: componentTheme.borderRadius
+    borderRadius: componentTheme.borderRadius,
+    scrollContainer: {
+      label: 'popover__scrollContainer',
+      maxHeight: 'var(--ui-position-available-height, 100vh)',
+      overflowY: 'auto',
+      overflowX: 'hidden',
+      borderRadius: componentTheme.borderRadius
+    }
   };
 };
 export default generateStyle;

package/es/exports/a.js

@@ -21,4 +21,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-export { Popover } from "../Popover/v1/index.js";
+export { Popover } from '../Popover/v1/index.js';

package/es/exports/b.js

@@ -21,4 +21,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-export { Popover } from "../Popover/v2/index.js";
+export { Popover } from '../Popover/v2/index.js';

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@instructure/ui-popover",
-  "version": "11.7.3",
+  "version": "11.7.4-pr-snapshot-1781695314229",
+  "type": "module",
   "description": "A component for hiding or showing content based on user interaction.",
   "author": "Instructure, Inc. Engineering and Product Design",
   "module": "./es/index.js",
-  "main": "./lib/index.js",
   "types": "./types/index.d.ts",
   "repository": {
     "type": "git",
@@ -16,28 +16,28 @@
   "dependencies": {
     "@babel/runtime": "^7.29.2",
     "keycode": "^2.2.1",
-    "@instructure/console": "11.7.3",
-    "@instructure/shared-types": "11.7.3",
-    "@instructure/ui-a11y-utils": "11.7.3",
-    "@instructure/ui-dialog": "11.7.3",
-    "@instructure/emotion": "11.7.3",
-    "@instructure/ui-dom-utils": "11.7.3",
-    "@instructure/ui-i18n": "11.7.3",
-    "@instructure/ui-position": "11.7.3",
-    "@instructure/ui-react-utils": "11.7.3",
-    "@instructure/ui-themes": "11.7.3",
-    "@instructure/ui-utils": "11.7.3",
-    "@instructure/ui-view": "11.7.3",
-    "@instructure/uid": "11.7.3"
+    "@instructure/console": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/emotion": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/shared-types": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-a11y-utils": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-dialog": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-i18n": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-dom-utils": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-position": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-react-utils": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-utils": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-view": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-themes": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/uid": "11.7.4-pr-snapshot-1781695314229"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "15.0.7",
     "@testing-library/user-event": "^14.6.1",
     "vitest": "^3.2.2",
-    "@instructure/ui-axe-check": "11.7.3",
-    "@instructure/ui-babel-preset": "11.7.3",
-    "@instructure/ui-color-utils": "11.7.3"
+    "@instructure/ui-axe-check": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-babel-preset": "11.7.4-pr-snapshot-1781695314229",
+    "@instructure/ui-color-utils": "11.7.4-pr-snapshot-1781695314229"
   },
   "peerDependencies": {
     "react": ">=18 <=19"
@@ -47,7 +47,6 @@
   },
   "sideEffects": false,
   "exports": {
-    "./lib/*": "./lib/*",
     "./es/*": "./es/*",
     "./types/*": "./types/*",
     "./package.json": "./package.json",
@@ -56,28 +55,24 @@
       "src": "./src/exports/a.ts",
       "types": "./types/exports/a.d.ts",
       "import": "./es/exports/a.js",
-      "require": "./lib/exports/a.js",
       "default": "./es/exports/a.js"
     },
     "./v11_6": {
       "src": "./src/exports/a.ts",
       "types": "./types/exports/a.d.ts",
       "import": "./es/exports/a.js",
-      "require": "./lib/exports/a.js",
       "default": "./es/exports/a.js"
     },
     "./v11_7": {
       "src": "./src/exports/b.ts",
       "types": "./types/exports/b.d.ts",
       "import": "./es/exports/b.js",
-      "require": "./lib/exports/b.js",
       "default": "./es/exports/b.js"
     },
     "./latest": {
       "src": "./src/exports/b.ts",
       "types": "./types/exports/b.d.ts",
       "import": "./es/exports/b.js",
-      "require": "./lib/exports/b.js",
       "default": "./es/exports/b.js"
     }
   },
@@ -85,7 +80,7 @@
     "lint": "ui-scripts lint",
     "lint:fix": "ui-scripts lint --fix",
     "clean": "ui-scripts clean",
-    "build": "ui-scripts build --modules es,cjs",
+    "build": "ui-scripts build",
     "build:watch": "pnpm run ts:check -- --watch & ui-scripts build --watch",
     "build:types": "tsc -p tsconfig.build.json",
     "ts:check": "tsc -p tsconfig.build.json --noEmit --emitDeclarationOnly false"

package/src/Popover/v1/index.tsx

@@ -61,11 +61,11 @@ import type { DialogProps } from '@instructure/ui-dialog'
 
 import { withStyle } from '@instructure/emotion'
 
-import generateStyle from './styles'
-import generateComponentTheme from './theme'
+import generateStyle from './styles.js'
+import generateComponentTheme from './theme.js'
 
 import type { PopoverProps, PopoverState } from '../v1/props'
-import { allowedProps } from '../v1/props'
+import { allowedProps } from '../v1/props.js'
 import type { Renderable } from '@instructure/shared-types'
 /**
 ---
@@ -77,6 +77,7 @@ tags: overlay, portal, dialog
 @textDirectionContextConsumer()
 @withStyle(generateStyle, generateComponentTheme)
 class Popover extends Component<PopoverProps, PopoverState> {
+  static displayName = 'Popover'
   static readonly componentId = 'Popover'
 
   static allowedProps = allowedProps

package/src/Popover/v2/README.md

@@ -425,6 +425,37 @@ const Example = () => {
 render(<Example />)
 ```
 
+#### Scrolling content (`shouldScrollContent`)
+
+When the popover content can grow taller than the available viewport space, set `shouldScrollContent` to wrap the content in a scroll container that fits to the room between the trigger element and the viewport edge. To try the example below, zoom in until the available space becomes small enough that a scrollbar is displayed in the Popover.
+
+```js
+---
+type: example
+---
+const fpo = lorem.paragraphs(8)
+class Example extends React.Component {
+  state = { isOpen: false }
+  render () {
+    return (
+      <Popover
+        on="click"
+        placement="bottom start"
+        isShowingContent={this.state.isOpen}
+        onShowContent={() => this.setState({ isOpen: true })}
+        onHideContent={() => this.setState({ isOpen: false })}
+        shouldScrollContent
+        screenReaderLabel="A long popover"
+        renderTrigger={<Button>Open scrollable popover</Button>}
+      >
+        <View as="div" padding="small" maxWidth="22rem">{fpo}</View>
+      </Popover>
+    )
+  }
+}
+render(<Example />)
+```
+
 ### Guidelines
 
 ```js

package/src/Popover/v2/index.tsx

@@ -61,10 +61,10 @@ import type { DialogProps } from '@instructure/ui-dialog'
 
 import { withStyleNew } from '@instructure/emotion'
 
-import generateStyle from './styles'
+import generateStyle from './styles.js'
 
 import type { PopoverProps, PopoverState } from './props'
-import { allowedProps } from './props'
+import { allowedProps } from './props.js'
 import type { Renderable } from '@instructure/shared-types'
 /**
 ---
@@ -76,6 +76,7 @@ tags: overlay, portal, dialog
 @textDirectionContextConsumer()
 @withStyleNew(generateStyle)
 class Popover extends Component<PopoverProps, PopoverState> {
+  static displayName = 'Popover'
   static readonly componentId = 'Popover'
 
   static allowedProps = allowedProps
@@ -519,6 +520,12 @@ class Popover extends Component<PopoverProps, PopoverState> {
   renderContent() {
     let content = callRenderProp(this.props.children)
 
+    if (this.props.shouldScrollContent) {
+      content = (
+        <div css={this.props.styles?.scrollContainer}>{content}</div>
+      )
+    }
+
     if (this.shown && !this.isTooltip) {
       // if popover is NOT being used as a tooltip, create a Dialog
       // to manage the content FocusRegion, when showing

package/src/Popover/v2/props.ts

@@ -25,7 +25,12 @@ import React from 'react'
 import { BorderWidth } from '@instructure/emotion'
 import type { NewComponentTypes } from '@instructure/ui-themes'
 
-import type { Shadow, Stacking, WithStyleProps } from '@instructure/emotion'
+import type {
+  Shadow,
+  Stacking,
+  StyleObject,
+  WithStyleProps
+} from '@instructure/emotion'
 
 import type {
   PlacementPropValues,
@@ -284,6 +289,12 @@ type PopoverOwnProps = {
    * otherwise its calculated automatically based on whether the content is shown.
    */
   shouldSetAriaExpanded?: boolean
+  /**
+   * When `true`, wraps the popover content in a container that caps its
+   * height to the available viewport space and scrolls when content
+   * overflows.
+   */
+  shouldScrollContent?: boolean
 }
 
 type PopoverProps = PopoverOwnProps &
@@ -302,7 +313,11 @@ type PropKeys = keyof PopoverOwnProps
 
 type AllowedPropKeys = Readonly<Array<PropKeys>>
 
-type PopoverStyle = { borderRadius: string; borderColor: string }
+type PopoverStyle = {
+  borderRadius: string
+  borderColor: string
+  scrollContainer: StyleObject
+}
 const allowedProps: AllowedPropKeys = [
   'isShowingContent',
   'defaultIsShowingContent',
@@ -347,7 +362,8 @@ const allowedProps: AllowedPropKeys = [
   'children',
   'elementRef',
   'borderWidth',
-  'shouldSetAriaExpanded'
+  'shouldSetAriaExpanded',
+  'shouldScrollContent'
 ]
 
 export type { PopoverOwnProps, PopoverProps, PopoverState, PopoverStyle }

package/src/Popover/v2/styles.ts

@@ -38,7 +38,14 @@ const generateStyle = (
 ): PopoverStyle => {
   return {
     borderColor: componentTheme.borderColor,
-    borderRadius: componentTheme.borderRadius
+    borderRadius: componentTheme.borderRadius,
+    scrollContainer: {
+      label: 'popover__scrollContainer',
+      maxHeight: 'var(--ui-position-available-height, 100vh)',
+      overflowY: 'auto',
+      overflowX: 'hidden',
+      borderRadius: componentTheme.borderRadius
+    }
   }
 }
 

package/src/exports/a.ts

@@ -21,5 +21,5 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-export { Popover } from '../Popover/v1'
+export { Popover } from '../Popover/v1/index.js'
 export type { PopoverOwnProps, PopoverProps } from '../Popover/v1/props'

package/src/exports/b.ts

@@ -21,5 +21,5 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-export { Popover } from '../Popover/v2'
+export { Popover } from '../Popover/v2/index.js'
 export type { PopoverOwnProps, PopoverProps } from '../Popover/v2/props'