Revert "v38: Deprecate PointerBox component (#6704)" (#6738)

Author: joshblack

.changeset/big-lizards-study.md

@@ -1,10 +1,14 @@
 {
   "id": "pointer_box",
   "name": "PointerBox",
-  "status": "deprecated",
+  "status": "alpha",
   "a11yReviewed": "2025-01-08",
-  "stories": [],
-  "importPath": "@primer/react/deprecated",
+  "stories": [
+    {
+      "id": "components-pointerbox--default"
+    }
+  ],
+  "importPath": "@primer/react",
   "props": [
     {
       "name": "bg",

packages/react/src/PointerBox/PointerBox.docs.json

@@ -3,14 +3,7 @@ import PointerBox from './PointerBox'
 import type {ComponentProps} from '../utils/types'
 
 export default {
-  title: 'Deprecated/Components/PointerBox',
-  parameters: {
-    docs: {
-      description: {
-        component: 'PointerBox is deprecated and will be removed in a future major release. Consider using Overlay.',
-      },
-    },
-  },
+  title: 'Components/PointerBox',
 } as Meta<typeof PointerBox>
 
 export const Default = () => <PointerBox>Pointer box content</PointerBox>

packages/react/src/PointerBox/PointerBox.stories.tsx

@@ -1,7 +1,6 @@
 import {describe, expect, it} from 'vitest'
 import {render} from '@testing-library/react'
-import {ThemeProvider} from '..'
-import PointerBox from './PointerBox'
+import {PointerBox, ThemeProvider} from '..'
 import theme from '../theme'
 
 describe('PointerBox', () => {

packages/react/src/PointerBox/PointerBox.test.tsx

@@ -16,10 +16,6 @@ type MutatedSxProps = {
   }
 } & SxProp
 
-/**
- * @deprecated PointerBox is deprecated and will be removed in a future major release.
- * Consider using Overlay or Position + Box with a caret instead.
- */
 export type PointerBoxProps = {
   caret?: CaretProps['location']
   bg?: CaretProps['bg']
@@ -28,10 +24,6 @@ export type PointerBoxProps = {
 } & BoxProps &
   MutatedSxProps
 
-/**
- * @deprecated PointerBox is deprecated and will be removed in a future major release.
- * Consider using Overlay or Position + Box with a caret instead.
- */
 function PointerBox(props: PointerBoxProps) {
   // don't destructure these, just grab them
   const themeContext = React.useContext(ThemeContext)

packages/react/src/PointerBox/PointerBox.tsx

@@ -112,6 +112,8 @@ exports[`@primer/react > should not update exports without a semver change 1`] =
   "type PageLayoutProps",
   "Pagination",
   "type PaginationProps",
+  "PointerBox",
+  "type PointerBoxProps",
   "Popover",
   "type PopoverContentProps",
   "type PopoverProps",
@@ -234,8 +236,6 @@ exports[`@primer/react/deprecated > should not update exports without a semver c
   "type OcticonProps",
   "Pagehead",
   "type PageheadProps",
-  "PointerBox",
-  "type PointerBoxProps",
   "TabNav",
   "type TabNavLinkProps",
   "type TabNavProps",

packages/react/src/__tests__/__snapshots__/exports.test.ts.snap

@@ -42,7 +42,3 @@ export type {TabNavProps, TabNavLinkProps} from '../TabNav'
 export {default as Tooltip} from '../Tooltip/Tooltip'
 export type {TooltipProps} from '../Tooltip/Tooltip'
 // end of v37.0.0
-
-// Deprecated in vNext
-export {default as PointerBox} from '../PointerBox'
-export type {PointerBoxProps} from '../PointerBox'

packages/react/src/deprecated/index.ts

@@ -122,7 +122,8 @@ export {default as Overlay} from './Overlay'
 export type {OverlayProps} from './Overlay'
 export {default as Pagination} from './Pagination'
 export type {PaginationProps} from './Pagination'
-// Deprecated: moved to deprecated bundle
+export {default as PointerBox} from './PointerBox'
+export type {PointerBoxProps} from './PointerBox'
 export {default as Popover} from './Popover'
 export type {PopoverProps, PopoverContentProps} from './Popover'
 export {default as Portal, registerPortalRoot} from './Portal'