@mui/x-internals 9.0.0 → 9.0.4

package/domUtils/getTarget.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Returns the target element of an event, accounting for shadow DOM.
+ * @param event The event object.
+ * @returns The target element of the event.
+ */
+export declare function getTarget(event: Event): EventTarget | null;

package/domUtils/getTarget.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the target element of an event, accounting for shadow DOM.
+ * @param event The event object.
+ * @returns The target element of the event.
+ */
+export declare function getTarget(event: Event): EventTarget | null;

package/domUtils/getTarget.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTarget = getTarget;
+/**
+ * Returns the target element of an event, accounting for shadow DOM.
+ * @param event The event object.
+ * @returns The target element of the event.
+ */
+function getTarget(event) {
+  if ('composedPath' in event) {
+    return event.composedPath()[0] ?? event.target;
+  }
+
+  // Fallback for environments where `composedPath` is not available.
+  // TS narrows `event` to `never` here because it assumes `composedPath` always exists.
+  return event.target;
+}

package/domUtils/getTarget.mjs

@@ -0,0 +1,14 @@
+/**
+ * Returns the target element of an event, accounting for shadow DOM.
+ * @param event The event object.
+ * @returns The target element of the event.
+ */
+export function getTarget(event) {
+  if ('composedPath' in event) {
+    return event.composedPath()[0] ?? event.target;
+  }
+
+  // Fallback for environments where `composedPath` is not available.
+  // TS narrows `event` to `never` here because it assumes `composedPath` always exists.
+  return event.target;
+}

package/domUtils/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./getTarget.mjs";
+export * from "./isHTMLElement.mjs";

package/domUtils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./getTarget.js";
+export * from "./isHTMLElement.js";

package/domUtils/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _getTarget = require("./getTarget");
+Object.keys(_getTarget).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _getTarget[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _getTarget[key];
+    }
+  });
+});
+var _isHTMLElement = require("./isHTMLElement");
+Object.keys(_isHTMLElement).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isHTMLElement[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _isHTMLElement[key];
+    }
+  });
+});

package/domUtils/index.mjs

@@ -0,0 +1,2 @@
+export * from "./getTarget.mjs";
+export * from "./isHTMLElement.mjs";

package/domUtils/isHTMLElement.d.mts

@@ -0,0 +1,4 @@
+/**
+ * Checks if a value is an HTMLElement, including elements from other iframes/realms.
+ */
+export declare function isHTMLElement(value: unknown): value is HTMLElement;

package/domUtils/isHTMLElement.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Checks if a value is an HTMLElement, including elements from other iframes/realms.
+ */
+export declare function isHTMLElement(value: unknown): value is HTMLElement;

package/domUtils/isHTMLElement.js

@@ -0,0 +1,27 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isHTMLElement = isHTMLElement;
+var _ownerWindow = _interopRequireDefault(require("@mui/utils/ownerWindow"));
+/**
+ * Checks if a value is an HTMLElement, including elements from other iframes/realms.
+ */
+function isHTMLElement(value) {
+  if (typeof window === 'undefined' || value == null) {
+    return false;
+  }
+  if (value instanceof HTMLElement) {
+    return true;
+  }
+  // Cross-realm: must be an element node (nodeType 1) from another window.
+  // The try/catch guards against detached/destroyed windows where accessing
+  // `.HTMLElement` on the owner window may throw.
+  try {
+    return value.nodeType === 1 && value instanceof (0, _ownerWindow.default)(value).HTMLElement;
+  } catch {
+    return false;
+  }
+}

package/domUtils/isHTMLElement.mjs

@@ -0,0 +1,21 @@
+import ownerWindow from '@mui/utils/ownerWindow';
+
+/**
+ * Checks if a value is an HTMLElement, including elements from other iframes/realms.
+ */
+export function isHTMLElement(value) {
+  if (typeof window === 'undefined' || value == null) {
+    return false;
+  }
+  if (value instanceof HTMLElement) {
+    return true;
+  }
+  // Cross-realm: must be an element node (nodeType 1) from another window.
+  // The try/catch guards against detached/destroyed windows where accessing
+  // `.HTMLElement` on the owner window may throw.
+  try {
+    return value.nodeType === 1 && value instanceof ownerWindow(value).HTMLElement;
+  } catch {
+    return false;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-internals",
-  "version": "9.0.0",
+  "version": "9.0.4",
   "author": "MUI Team",
   "description": "Utility functions for the MUI X packages (internal use only).",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "directory": "packages/x-internals"
   },
   "dependencies": {
-    "@babel/runtime": "^7.28.6",
+    "@babel/runtime": "^7.29.2",
     "@mui/utils": "9.0.0",
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.6.0"
@@ -72,6 +72,20 @@
         "default": "./ToolbarContext/index.mjs"
       }
     },
+    "./domUtils": {
+      "import": {
+        "types": "./domUtils/index.d.mts",
+        "default": "./domUtils/index.mjs"
+      },
+      "require": {
+        "types": "./domUtils/index.d.ts",
+        "default": "./domUtils/index.js"
+      },
+      "default": {
+        "types": "./domUtils/index.d.mts",
+        "default": "./domUtils/index.mjs"
+      }
+    },
     "./export": {
       "import": {
         "types": "./export/index.d.mts",