[core] Deprecate Popover in favor of PopoverNext

[ggdouglas]

Summary

Marks the legacy Popover class component as deprecated, following the same pattern used for Overlay -> Overlay2. PopoverNext is the recommended replacement (see #7573).

Changes

Adds a @deprecated JSDoc tag and a @fileoverview frozen-code notice to popover.tsx. The re-export in components/index.ts gets the corresponding eslint-disable-next-line comment.

Shared types like PopoverProps, PopoverInteractionKind, and PopoverAnimation are not deprecated since PopoverNext also uses them.

[changelog-app]

Generate changelog in packages/core/changelog/@unreleased

Type (Select exactly one)

• Feature (Adding new functionality)
• Improvement (Improving existing functionality)
• Fix (Fixing an issue with existing functionality)
• Break (Creating a new major version by breaking public APIs)
• Deprecation (Removing functionality in a non-breaking way)
• Migration (Automatically moving data/functionality to a new system)

Description

[core] Deprecate Popover in favor of PopoverNext

Check the box to generate changelog(s)

• Generate changelog entry

[blueprint-previews]

Deprecate Popover component in favor of PopoverNext

Build artifact links for this commit: documentation | landing | table | demo | storybook

This is an automated comment from the deploy-preview CircleCI job.

[mm-wang]

🎉

[changelog-app]

✅ Successfully generated changelog entry!

Need to regenerate?

Simply interact with the changelog bot comment again to regenerate these entries.

---

📋Changelog Preview

💡 Improvements

• [core] Deprecate Popover in favor of PopoverNext (#8124)