@mui/x-internals 8.0.0-beta.2 → 8.0.0

package/esm/rafThrottle/index.d.ts

@@ -0,0 +1 @@
+export * from "./rafThrottle.js";

package/esm/rafThrottle/index.js

@@ -0,0 +1 @@
+export * from "./rafThrottle.js";

package/esm/rafThrottle/rafThrottle.d.ts

@@ -0,0 +1,16 @@
+export interface Cancelable {
+  clear(): void;
+}
+/**
+ *  Creates a throttled function that only invokes `fn` at most once per animation frame.
+ *
+ * @example
+ * ```ts
+ * const throttled = rafThrottle((value: number) => console.log(value));
+ * window.addEventListener('scroll', (e) => throttled(e.target.scrollTop));
+ * ```
+ *
+ * @param fn Callback function
+ * @return The `requestAnimationFrame` throttled function
+ */
+export declare function rafThrottle<T extends (...args: any[]) => any>(fn: T): T & Cancelable;

package/esm/rafThrottle/rafThrottle.js

@@ -0,0 +1,33 @@
+/**
+ *  Creates a throttled function that only invokes `fn` at most once per animation frame.
+ *
+ * @example
+ * ```ts
+ * const throttled = rafThrottle((value: number) => console.log(value));
+ * window.addEventListener('scroll', (e) => throttled(e.target.scrollTop));
+ * ```
+ *
+ * @param fn Callback function
+ * @return The `requestAnimationFrame` throttled function
+ */
+export function rafThrottle(fn) {
+  let lastArgs;
+  let rafRef;
+  const later = () => {
+    rafRef = null;
+    fn(...lastArgs);
+  };
+  function throttled(...args) {
+    lastArgs = args;
+    if (!rafRef) {
+      rafRef = requestAnimationFrame(later);
+    }
+  }
+  throttled.clear = () => {
+    if (rafRef) {
+      cancelAnimationFrame(rafRef);
+      rafRef = null;
+    }
+  };
+  return throttled;
+}

package/esm/types/MuiEvent.d.ts

@@ -0,0 +1,5 @@
+import * as React from 'react';
+export type MuiBaseEvent = React.SyntheticEvent<HTMLElement> | DocumentEventMap[keyof DocumentEventMap] | {};
+export type MuiEvent<E extends MuiBaseEvent = MuiBaseEvent> = E & {
+  defaultMuiPrevented?: boolean;
+};

package/esm/types/index.d.ts

@@ -2,6 +2,7 @@ export * from "./AppendKeys.js";
 export * from "./DefaultizedProps.js";
 export * from "./MakeOptional.js";
 export * from "./MakeRequired.js";
+export * from "./MuiEvent.js";
 export * from "./PrependKeys.js";
 export * from "./RefObject.js";
 export * from "./SlotComponentPropsFromProps.js";

package/esm/types/index.js

@@ -2,6 +2,7 @@ export * from "./AppendKeys.js";
 export * from "./DefaultizedProps.js";
 export * from "./MakeOptional.js";
 export * from "./MakeRequired.js";
+export * from "./MuiEvent.js";
 export * from "./PrependKeys.js";
 export * from "./RefObject.js";
 export * from "./SlotComponentPropsFromProps.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-internals",
-  "version": "8.0.0-beta.2",
+  "version": "8.0.0",
   "description": "Utility functions for the MUI X packages (internal use only).",
   "author": "MUI Team",
   "license": "MIT",
@@ -31,8 +31,8 @@
     "directory": "packages/x-internals"
   },
   "dependencies": {
-    "@babel/runtime": "^7.26.10",
-    "@mui/utils": "^7.0.0 || ^7.0.0-beta"
+    "@babel/runtime": "^7.27.0",
+    "@mui/utils": "^7.0.2"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
@@ -51,10 +51,6 @@
       "import": {
         "types": "./esm/index.d.ts",
         "default": "./esm/index.js"
-      },
-      "mui-modern": {
-        "types": "./modern/index.d.ts",
-        "default": "./modern/index.js"
       }
     },
     "./*": {
@@ -65,10 +61,6 @@
       "import": {
         "types": "./esm/*/index.d.ts",
         "default": "./esm/*/index.js"
-      },
-      "mui-modern": {
-        "types": "./modern/*/index.d.ts",
-        "default": "./modern/*/index.js"
       }
     },
     "./esm": null,

package/rafThrottle/index.d.ts

@@ -0,0 +1 @@
+export * from "./rafThrottle.js";

package/rafThrottle/index.js

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

package/rafThrottle/rafThrottle.d.ts

@@ -0,0 +1,16 @@
+export interface Cancelable {
+  clear(): void;
+}
+/**
+ *  Creates a throttled function that only invokes `fn` at most once per animation frame.
+ *
+ * @example
+ * ```ts
+ * const throttled = rafThrottle((value: number) => console.log(value));
+ * window.addEventListener('scroll', (e) => throttled(e.target.scrollTop));
+ * ```
+ *
+ * @param fn Callback function
+ * @return The `requestAnimationFrame` throttled function
+ */
+export declare function rafThrottle<T extends (...args: any[]) => any>(fn: T): T & Cancelable;

package/rafThrottle/rafThrottle.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.rafThrottle = rafThrottle;
+/**
+ *  Creates a throttled function that only invokes `fn` at most once per animation frame.
+ *
+ * @example
+ * ```ts
+ * const throttled = rafThrottle((value: number) => console.log(value));
+ * window.addEventListener('scroll', (e) => throttled(e.target.scrollTop));
+ * ```
+ *
+ * @param fn Callback function
+ * @return The `requestAnimationFrame` throttled function
+ */
+function rafThrottle(fn) {
+  let lastArgs;
+  let rafRef;
+  const later = () => {
+    rafRef = null;
+    fn(...lastArgs);
+  };
+  function throttled(...args) {
+    lastArgs = args;
+    if (!rafRef) {
+      rafRef = requestAnimationFrame(later);
+    }
+  }
+  throttled.clear = () => {
+    if (rafRef) {
+      cancelAnimationFrame(rafRef);
+      rafRef = null;
+    }
+  };
+  return throttled;
+}

package/types/MuiEvent.d.ts

@@ -0,0 +1,5 @@
+import * as React from 'react';
+export type MuiBaseEvent = React.SyntheticEvent<HTMLElement> | DocumentEventMap[keyof DocumentEventMap] | {};
+export type MuiEvent<E extends MuiBaseEvent = MuiBaseEvent> = E & {
+  defaultMuiPrevented?: boolean;
+};

package/types/MuiEvent.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/types/index.d.ts

@@ -2,6 +2,7 @@ export * from "./AppendKeys.js";
 export * from "./DefaultizedProps.js";
 export * from "./MakeOptional.js";
 export * from "./MakeRequired.js";
+export * from "./MuiEvent.js";
 export * from "./PrependKeys.js";
 export * from "./RefObject.js";
 export * from "./SlotComponentPropsFromProps.js";

package/types/index.js

@@ -47,6 +47,17 @@ Object.keys(_MakeRequired).forEach(function (key) {
     }
   });
 });
+var _MuiEvent = require("./MuiEvent");
+Object.keys(_MuiEvent).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _MuiEvent[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _MuiEvent[key];
+    }
+  });
+});
 var _PrependKeys = require("./PrependKeys");
 Object.keys(_PrependKeys).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/modern/EventManager/EventManager.d.ts

@@ -1,29 +0,0 @@
-export type EventListener = (...args: any[]) => void;
-export interface EventListenerOptions {
-  isFirst?: boolean;
-}
-interface EventListenerCollection {
-  /**
-   * List of listeners to run before the others
-   * They are run in the opposite order of the registration order
-   */
-  highPriority: Map<EventListener, true>;
-  /**
-   * List of events to run after the high priority listeners
-   * They are run in the registration order
-   */
-  regular: Map<EventListener, true>;
-}
-export declare class EventManager {
-  maxListeners: number;
-  warnOnce: boolean;
-  events: {
-    [eventName: string]: EventListenerCollection;
-  };
-  on(eventName: string, listener: EventListener, options?: EventListenerOptions): void;
-  removeListener(eventName: string, listener: EventListener): void;
-  removeAllListeners(): void;
-  emit(eventName: string, ...args: any[]): void;
-  once(eventName: string, listener: EventListener): void;
-}
-export {};

package/modern/EventManager/EventManager.js

@@ -1,69 +0,0 @@
-// Used https://gist.github.com/mudge/5830382 as a starting point.
-// See https://github.com/browserify/events/blob/master/events.js for
-// the Node.js (https://nodejs.org/api/events.html) polyfill used by webpack.
-export class EventManager {
-  constructor() {
-    this.maxListeners = 20;
-    this.warnOnce = false;
-    this.events = {};
-  }
-  on(eventName, listener, options = {}) {
-    let collection = this.events[eventName];
-    if (!collection) {
-      collection = {
-        highPriority: new Map(),
-        regular: new Map()
-      };
-      this.events[eventName] = collection;
-    }
-    if (options.isFirst) {
-      collection.highPriority.set(listener, true);
-    } else {
-      collection.regular.set(listener, true);
-    }
-    if (process.env.NODE_ENV !== 'production') {
-      const collectionSize = collection.highPriority.size + collection.regular.size;
-      if (collectionSize > this.maxListeners && !this.warnOnce) {
-        this.warnOnce = true;
-        console.warn([`Possible EventEmitter memory leak detected. ${collectionSize} ${eventName} listeners added.`].join('\n'));
-      }
-    }
-  }
-  removeListener(eventName, listener) {
-    if (this.events[eventName]) {
-      this.events[eventName].regular.delete(listener);
-      this.events[eventName].highPriority.delete(listener);
-    }
-  }
-  removeAllListeners() {
-    this.events = {};
-  }
-  emit(eventName, ...args) {
-    const collection = this.events[eventName];
-    if (!collection) {
-      return;
-    }
-    const highPriorityListeners = Array.from(collection.highPriority.keys());
-    const regularListeners = Array.from(collection.regular.keys());
-    for (let i = highPriorityListeners.length - 1; i >= 0; i -= 1) {
-      const listener = highPriorityListeners[i];
-      if (collection.highPriority.has(listener)) {
-        listener.apply(this, args);
-      }
-    }
-    for (let i = 0; i < regularListeners.length; i += 1) {
-      const listener = regularListeners[i];
-      if (collection.regular.has(listener)) {
-        listener.apply(this, args);
-      }
-    }
-  }
-  once(eventName, listener) {
-    // eslint-disable-next-line consistent-this
-    const that = this;
-    this.on(eventName, function oneTimeListener(...args) {
-      that.removeListener(eventName, oneTimeListener);
-      listener.apply(that, args);
-    });
-  }
-}

package/modern/EventManager/index.d.ts

@@ -1,2 +0,0 @@
-export { EventManager } from "./EventManager.js";
-export type { EventListenerOptions } from './EventManager';

package/modern/EventManager/index.js

@@ -1 +0,0 @@
-export { EventManager } from "./EventManager.js";

package/modern/fastArrayCompare/fastArrayCompare.d.ts

@@ -1,12 +0,0 @@
-/**
- * A fast array comparison function that compares two arrays for equality.
- *
- * Assumes that the arrays are ordered and contain only primitive values.
- *
- * It is faster than `fastObjectShallowCompare` for arrays.
- *
- * Returns true for instance equality, even if inputs are not arrays.
- *
- * @returns true if arrays contain the same elements in the same order, false otherwise.
- */
-export declare function fastArrayCompare<T extends any>(a: T, b: T): boolean;

package/modern/fastArrayCompare/fastArrayCompare.js

@@ -1,31 +0,0 @@
-/**
- * A fast array comparison function that compares two arrays for equality.
- *
- * Assumes that the arrays are ordered and contain only primitive values.
- *
- * It is faster than `fastObjectShallowCompare` for arrays.
- *
- * Returns true for instance equality, even if inputs are not arrays.
- *
- * @returns true if arrays contain the same elements in the same order, false otherwise.
- */
-export function fastArrayCompare(a, b) {
-  if (a === b) {
-    return true;
-  }
-  if (!Array.isArray(a) || !Array.isArray(b)) {
-    return false;
-  }
-  let i = a.length;
-  if (i !== b.length) {
-    return false;
-  }
-
-  // eslint-disable-next-line no-plusplus
-  while (i--) {
-    if (a[i] !== b[i]) {
-      return false;
-    }
-  }
-  return true;
-}

package/modern/fastArrayCompare/index.d.ts

@@ -1 +0,0 @@
-export { fastArrayCompare } from "./fastArrayCompare.js";

package/modern/fastArrayCompare/index.js

@@ -1 +0,0 @@
-export { fastArrayCompare } from "./fastArrayCompare.js";

package/modern/fastMemo/fastMemo.d.ts

@@ -1 +0,0 @@
-export declare function fastMemo<T>(component: T): T;

package/modern/fastMemo/fastMemo.js

@@ -1,5 +0,0 @@
-import * as React from 'react';
-import { fastObjectShallowCompare } from "../fastObjectShallowCompare/index.js";
-export function fastMemo(component) {
-  return /*#__PURE__*/React.memo(component, fastObjectShallowCompare);
-}

package/modern/fastMemo/index.d.ts

@@ -1 +0,0 @@
-export { fastMemo } from "./fastMemo.js";

package/modern/fastMemo/index.js

@@ -1 +0,0 @@
-export { fastMemo } from "./fastMemo.js";

package/modern/fastObjectShallowCompare/fastObjectShallowCompare.d.ts

@@ -1,5 +0,0 @@
-/**
- * Fast shallow compare for objects.
- * @returns true if objects are equal.
- */
-export declare function fastObjectShallowCompare<T extends Record<string, any> | null>(a: T, b: T): boolean;

package/modern/fastObjectShallowCompare/fastObjectShallowCompare.js

@@ -1,33 +0,0 @@
-const is = Object.is;
-
-/**
- * Fast shallow compare for objects.
- * @returns true if objects are equal.
- */
-export function fastObjectShallowCompare(a, b) {
-  if (a === b) {
-    return true;
-  }
-  if (!(a instanceof Object) || !(b instanceof Object)) {
-    return false;
-  }
-  let aLength = 0;
-  let bLength = 0;
-
-  /* eslint-disable guard-for-in */
-  for (const key in a) {
-    aLength += 1;
-    if (!is(a[key], b[key])) {
-      return false;
-    }
-    if (!(key in b)) {
-      return false;
-    }
-  }
-
-  /* eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unused-vars */
-  for (const _ in b) {
-    bLength += 1;
-  }
-  return aLength === bLength;
-}

package/modern/fastObjectShallowCompare/index.d.ts

@@ -1 +0,0 @@
-export { fastObjectShallowCompare } from "./fastObjectShallowCompare.js";

package/modern/fastObjectShallowCompare/index.js

@@ -1 +0,0 @@
-export { fastObjectShallowCompare } from "./fastObjectShallowCompare.js";

package/modern/forwardRef/forwardRef.d.ts

@@ -1,4 +0,0 @@
-import * as React from 'react';
-export declare const forwardRef: <T, P = {}>(render: React.ForwardRefRenderFunction<T, P & {
-  ref: React.Ref<T>;
-}>) => React.ForwardRefExoticComponent<P> | React.ForwardRefExoticComponent<React.PropsWithoutRef<P> & React.RefAttributes<T>>;

package/modern/forwardRef/forwardRef.js

@@ -1,15 +0,0 @@
-import * as React from 'react';
-import reactMajor from "../reactMajor/index.js";
-
-// Compatibility shim that ensures stable props object for forwardRef components
-// Fixes https://github.com/facebook/react/issues/31613
-// We ensure that the ref is always present in the props object (even if that's not the case for older versions of React) to avoid the footgun of spreading props over the ref in the newer versions of React.
-// Footgun: <Component ref={ref} {...props} /> will break past React 19, but the types will now warn us that we should use <Component {...props} ref={ref} /> instead.
-export const forwardRef = render => {
-  if (reactMajor >= 19) {
-    const Component = props => render(props, props.ref ?? null);
-    Component.displayName = render.displayName ?? render.name;
-    return Component;
-  }
-  return /*#__PURE__*/React.forwardRef(render);
-};

package/modern/forwardRef/index.d.ts

@@ -1 +0,0 @@
-export * from "./forwardRef.js";

package/modern/forwardRef/index.js

@@ -1 +0,0 @@
-export * from "./forwardRef.js";

package/modern/hash/hash.d.ts

@@ -1,6 +0,0 @@
-export declare const hash: typeof xxh;
-/**
- * Returns an xxh hash of `input` formatted as a decimal string.
- */
-declare function xxh(input: string): string;
-export {};

package/modern/hash/hash.js

@@ -1,61 +0,0 @@
-const encoder = new TextEncoder();
-
-// bufferLength must be a multiple of 4 to satisfy Int32Array constraints
-let bufferLength = 2 * 1024;
-let buffer = new ArrayBuffer(bufferLength);
-let uint8View = new Uint8Array(buffer);
-let int32View = new Int32Array(buffer);
-export const hash = xxh;
-
-/**
- * Returns an xxh hash of `input` formatted as a decimal string.
- */
-// prettier-ignore
-function xxh(input) {
-  /* eslint-disable no-bitwise */
-
-  // Worst-case scenario: full string of 2-byte characters
-  const requiredLength = input.length * 2;
-  if (requiredLength > bufferLength) {
-    // buffer.resize() is only available in recent browsers, so we re-allocate
-    // a new and views
-    bufferLength = requiredLength + (4 - requiredLength % 4);
-    buffer = new ArrayBuffer(bufferLength);
-    uint8View = new Uint8Array(buffer);
-    int32View = new Int32Array(buffer);
-  }
-  const length8 = encoder.encodeInto(input, uint8View).written;
-  const seed = 0;
-  const len = length8 | 0;
-  let i = 0;
-  let h = (seed + len | 0) + 0x165667B1 | 0;
-  if (len < 16) {
-    for (; (i + 3 | 0) < len; i = i + 4 | 0) {
-      h = Math.imul(rotl32(h + Math.imul(int32View[i] | 0, 0xC2B2AE3D) | 0, 17) | 0, 0x27D4EB2F);
-    }
-  } else {
-    let v0 = seed + 0x24234428 | 0;
-    let v1 = seed + 0x85EBCA77 | 0;
-    let v2 = seed;
-    let v3 = seed - 0x9E3779B1 | 0;
-    for (; (i + 15 | 0) < len; i = i + 16 | 0) {
-      v0 = Math.imul(rotl32(v0 + Math.imul(int32View[i + 0 | 0] | 0, 0x85EBCA77) | 0, 13) | 0, 0x9E3779B1);
-      v1 = Math.imul(rotl32(v1 + Math.imul(int32View[i + 4 | 0] | 0, 0x85EBCA77) | 0, 13) | 0, 0x9E3779B1);
-      v2 = Math.imul(rotl32(v2 + Math.imul(int32View[i + 8 | 0] | 0, 0x85EBCA77) | 0, 13) | 0, 0x9E3779B1);
-      v3 = Math.imul(rotl32(v3 + Math.imul(int32View[i + 12 | 0] | 0, 0x85EBCA77) | 0, 13) | 0, 0x9E3779B1);
-    }
-    h = (((rotl32(v0, 1) | 0 + rotl32(v1, 7) | 0) + rotl32(v2, 12) | 0) + rotl32(v3, 18) | 0) + len | 0;
-    for (; (i + 3 | 0) < len; i = i + 4 | 0) {
-      h = Math.imul(rotl32(h + Math.imul(int32View[i] | 0, 0xC2B2AE3D) | 0, 17) | 0, 0x27D4EB2F);
-    }
-  }
-  for (; i < len; i = i + 1 | 0) {
-    h = Math.imul(rotl32(h + Math.imul(uint8View[i] | 0, 0x165667B1) | 0, 11) | 0, 0x9E3779B1);
-  }
-  h = Math.imul(h ^ h >>> 15, 0x85EBCA77);
-  h = Math.imul(h ^ h >>> 13, 0xC2B2AE3D);
-  return ((h ^ h >>> 16) >>> 0).toString();
-}
-function rotl32(x, r) {
-  return x << r | x >>> 32 - r;
-}

package/modern/hash/index.d.ts

@@ -1 +0,0 @@
-export * from "./hash.js";

package/modern/hash/index.js

@@ -1 +0,0 @@
-export * from "./hash.js";

package/modern/isDeepEqual/index.d.ts

@@ -1 +0,0 @@
-export * from "./isDeepEqual.js";

package/modern/isDeepEqual/index.js

@@ -1 +0,0 @@
-export * from "./isDeepEqual.js";

package/modern/isDeepEqual/isDeepEqual.d.ts

@@ -1,29 +0,0 @@
-/**
- * Based on `fast-deep-equal`
- *
- * MIT License
- *
- * Copyright (c) 2017 Evgeny Poberezkin
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-/**
- * Check if two values are deeply equal.
- */
-export declare function isDeepEqual<T>(actual: any, expected: T): actual is T;