v38: Deprecate PointerBox component

[pksjce]

Part of # https://github.com/github/primer/issues/5536

Changelog

New

Changed

Removed

Rollout strategy

• Patch release
• Minor release
• Major release; if selected, include a written rollout or migration plan
• None; if selected, include a brief description as to why

Testing & Reviewing

Merge checklist

• Added/updated tests
• Added/updated documentation
• Added/updated previews (Storybook)
• Changes are SSR compatible
• Tested in Chrome
• Tested in Firefox
• Tested in Safari
• Tested in Edge
• (GitHub staff only) Integration tests pass at github/github (Learn more about how to run integration tests)

[changeset-bot]

🦋 Changeset detected

Latest commit: cbbcfb0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@primer/react	Major
@primer/styled-react	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull Request Overview

This PR deprecates the PointerBox component as part of v38, moving it from the main component exports to the deprecated bundle. The component is being phased out in favor of more modern alternatives like Overlay or Position + Box with caret.

• Moves PointerBox exports from main index to deprecated bundle
• Adds deprecation JSDoc comments to component and type definitions
• Updates Storybook configuration to categorize under "Deprecated/Components"
• Changes component status from "alpha" to "deprecated" in documentation metadata

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/react/src/index.ts	Removes PointerBox exports from main bundle
packages/react/src/deprecated/index.ts	Adds PointerBox exports to deprecated bundle
packages/react/src/PointerBox/PointerBox.tsx	Adds JSDoc deprecation warnings to component and types
packages/react/src/PointerBox/PointerBox.stories.tsx	Updates Storybook category and adds deprecation notice
packages/react/src/PointerBox/PointerBox.docs.json	Changes status from "alpha" to "deprecated"

[Copilot]

The deprecation message is inconsistent with the JSDoc comments in the component file. The JSDoc suggests 'Overlay or Position + Box with a caret' while this only mentions 'Overlay'. Consider aligning the messaging to match the more detailed alternative provided in the JSDoc comments.

Suggested change

	component: 'PointerBox is deprecated and will be removed in a future major release. Consider using Overlay.',
	component: 'PointerBox is deprecated and will be removed in a future major release. Consider using Overlay or Position + Box with a caret.',

[github-actions]

👋 Hi, this pull request contains changes to the source code that github/github depends on. If you are GitHub staff, we recommend testing these changes with github/github using the integration workflow. Thanks!

[github-actions]

size-limit report 📦

Path	Size
packages/react/dist/browser.esm.js	89.25 KB (-0.77% 🔽)
packages/react/dist/browser.umd.js	89.33 KB (-0.86% 🔽)