Add DOM utilities to primitive package (#3625)

Author: chaance

.changeset/slick-ravens-eat.md

@@ -0,0 +1,5 @@
+---
+'@radix-ui/primitive': patch
+---
+
+Added DOM utilities

packages/core/primitive/eslint.config.mjs

@@ -1,4 +1,10 @@
 // @ts-check
 import { configs } from '@repo/eslint-config/react-package';
 
-export default configs;
+/** @type {import("eslint").Linter.Config[]} */
+export default [
+  ...configs,
+  {
+    linterOptions: { reportUnusedDisableDirectives: false },
+  },
+];

packages/core/primitive/src/index.ts

@@ -1 +1 @@
-export { composeEventHandlers } from './primitive';
+export * from './primitive';

packages/core/primitive/src/primitive.tsx

@@ -1,4 +1,12 @@
-function composeEventHandlers<E extends { defaultPrevented: boolean }>(
+/* eslint-disable no-restricted-globals */
+export const canUseDOM = !!(
+  typeof window !== 'undefined' &&
+  window.document &&
+  window.document.createElement
+);
+/* eslint-enable no-restricted-globals */
+
+export function composeEventHandlers<E extends { defaultPrevented: boolean }>(
   originalEventHandler?: (event: E) => void,
   ourEventHandler?: (event: E) => void,
   { checkForDefaultPrevented = true } = {}
@@ -12,4 +20,18 @@ function composeEventHandlers<E extends { defaultPrevented: boolean }>(
   };
 }
 
-export { composeEventHandlers };
+export function getOwnerWindow(element: Element | null | undefined) {
+  if (!canUseDOM) {
+    throw new Error('Cannot access window outside of the DOM');
+  }
+  // eslint-disable-next-line no-restricted-globals
+  return element?.ownerDocument?.defaultView ?? window;
+}
+
+export function getOwnerDocument(element: Element | null | undefined) {
+  if (!canUseDOM) {
+    throw new Error('Cannot access document outside of the DOM');
+  }
+  // eslint-disable-next-line no-restricted-globals
+  return element?.ownerDocument ?? document;
+}