deprecate core stuff

Author: mydea

packages/core/src/browser-exports.ts

@@ -3,7 +3,12 @@
  *
  * @module
  */
-export { getComponentName, getLocationHref, htmlTreeAsString } from './utils/browser';
+export {
+  getComponentName,
+  getLocationHref,
+  // eslint-disable-next-line deprecation/deprecation
+  htmlTreeAsString,
+} from './utils/browser';
 export { supportsDOMError, supportsHistory, supportsNativeFetch, supportsReportingObserver } from './utils/supports';
 export type { XhrBreadcrumbData, XhrBreadcrumbHint } from './types/breadcrumb';
 export type {

packages/core/src/shared-exports.ts

@@ -221,6 +221,7 @@ export { addHandler, maybeInstrument, resetInstrumentationHandlers, triggerHandl
 export {
   isDOMError,
   isDOMException,
+  // eslint-disable-next-line deprecation/deprecation
   isElement,
   isError,
   isErrorEvent,
@@ -231,8 +232,10 @@ export {
   isPrimitive,
   isRegExp,
   isString,
+  // eslint-disable-next-line deprecation/deprecation
   isSyntheticEvent,
   isThenable,
+  // eslint-disable-next-line deprecation/deprecation
   isVueViewModel,
 } from './utils/is';
 export { isBrowser } from './utils/isBrowser';

packages/core/src/utils/browser.ts

@@ -14,6 +14,8 @@ type SimpleNode = {
  * and its ancestors
  * e.g. [HTMLElement] => body > div > input#foo.btn[name=baz]
  * @returns generated DOM path
+ * @deprecated This is browser-specific and will be removed from `@sentry/core` in a future major version.
+ * Import `htmlTreeAsString` from `@sentry-internal/browser-utils` instead.
  */
 export function htmlTreeAsString(
   elem: unknown,

packages/core/src/utils/is.ts

@@ -136,6 +136,8 @@ export function isEvent(wat: unknown): wat is PolymorphicEvent {
  *
  * @param wat A value to be checked.
  * @returns A boolean representing the result.
+ * @deprecated This is browser-specific and will be removed from `@sentry/core` in a future major version.
+ * Import `isElement` from `@sentry-internal/browser-utils` instead.
  */
 export function isElement(wat: unknown): boolean {
   return typeof Element !== 'undefined' && isInstanceOf(wat, Element);
@@ -162,11 +164,13 @@ export function isThenable(wat: any): wat is PromiseLike<any> {
 }
 
 /**
- * Checks whether given value's type is a SyntheticEvent
+ * Checks whether given value's type is a React SyntheticEvent
  * {@link isSyntheticEvent}.
  *
  * @param wat A value to be checked.
  * @returns A boolean representing the result.
+ * @deprecated This is React-specific and will be removed from `@sentry/core` in a future major version.
+ * Use the equivalent helper that ships with `@sentry/react` instead.
  */
 export function isSyntheticEvent(wat: unknown): boolean {
   return isPlainObject(wat) && 'nativeEvent' in wat && 'preventDefault' in wat && 'stopPropagation' in wat;
@@ -195,6 +199,8 @@ export function isInstanceOf<T>(wat: any, base: any): wat is T {
  *
  * @param wat A value to be checked.
  * @returns A boolean representing the result.
+ * @deprecated This is Vue-specific and will be removed from `@sentry/core` in a future major version.
+ * Use the equivalent helper that ships with `@sentry/vue` instead.
  */
 export function isVueViewModel(wat: unknown): wat is VueViewModel | VNode {
   // Not using Object.prototype.toString because in Vue 3 it would read the instance's Symbol(Symbol.toStringTag) property.