@primer/react 38.30.1-rc.bce2a87c7 → 38.31.0-rc.099285e6a

package/dist/utils/descendant-registry.js

@@ -1,222 +1,186 @@
-import { c } from 'react-compiler-runtime';
-import { useContext, useId, useEffect, useState, useRef, useReducer, createContext } from 'react';
-import useIsomorphicLayoutEffect from './useIsomorphicLayoutEffect.js';
-import { jsx } from 'react/jsx-runtime';
-
+import useIsomorphicLayoutEffect from "./useIsomorphicLayoutEffect.js";
+import { c } from "react-compiler-runtime";
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useId, useReducer, useRef, useState } from "react";
+//#region src/utils/descendant-registry.tsx
 /**
- * Create a "descendant registry" for a component. This allows a parent to store and track an ordered registry of
- * child components, even if they are deeply nested in the tree. For example, a menu component can use this to track
- * every menu item inside of it, including menu items inside of fragments and subcomponents. The order of the resulting
- * `Map` will match the render order in the React tree.
- *
- * Usage:
- * 1. Create a registry at the file level in a similar manner to creating a new React context. Set `T` to the data type
- *    of the registry - this can be anything **except** a function.
- * 2. In the parent component, instantiate the registry state via `useRegistryState`. Then wrap `children` in the
- *    registry context `Provider` with `setRegistry` set to the state setter function.
- * 3. Register child components via `useRegisterDescendant` or `useRegisterDescendantCallback`.
- * 4. Access the registered data using the value from `useRegistryState`. This will be a map of `string` to `T`, where
- *    the string key is a unique and stable identifier for each component which can be used as a `key` if necessary.
- *
- * @note Note that this pattern is not SSR compatible. It won't raise errors or hydration mismatches, but the
- * registry will not be available during SSR. The registry is built during the effect phase, so it will be populated
- * after hydration on the client. The initial `undefined` value can be used to safely show loading UI during SSR/initial
- * render if necessary.
- */
+* Create a "descendant registry" for a component. This allows a parent to store and track an ordered registry of
+* child components, even if they are deeply nested in the tree. For example, a menu component can use this to track
+* every menu item inside of it, including menu items inside of fragments and subcomponents. The order of the resulting
+* `Map` will match the render order in the React tree.
+*
+* Usage:
+* 1. Create a registry at the file level in a similar manner to creating a new React context. Set `T` to the data type
+*    of the registry - this can be anything **except** a function.
+* 2. In the parent component, instantiate the registry state via `useRegistryState`. Then wrap `children` in the
+*    registry context `Provider` with `setRegistry` set to the state setter function.
+* 3. Register child components via `useRegisterDescendant` or `useRegisterDescendantCallback`.
+* 4. Access the registered data using the value from `useRegistryState`. This will be a map of `string` to `T`, where
+*    the string key is a unique and stable identifier for each component which can be used as a `key` if necessary.
+*
+* @note Note that this pattern is not SSR compatible. It won't raise errors or hydration mismatches, but the
+* registry will not be available during SSR. The registry is built during the effect phase, so it will be populated
+* after hydration on the client. The initial `undefined` value can be used to safely show loading UI during SSR/initial
+* render if necessary.
+*/
 function createDescendantRegistry() {
-  const Context = /*#__PURE__*/createContext({
-    register: () => () => {},
-    updateValue: () => {},
-    key: -1
-  });
-
-  /**
-   * Instantiate descendant registry state. The initial value will be `undefined`, indicating that the registry hasn't
-   * been built yet.
-   */
-  function useRegistryState() {
-    return useState();
-  }
-
-  /** Register a descendant component with the registry. */
-  function useRegisterDescendant(value) {
-    const $ = c(16);
-    const {
-      register,
-      updateValue,
-      key
-    } = useContext(Context);
-    const id = useId();
-    let t0;
-    if ($[0] !== id || $[1] !== register) {
-      t0 = () => register(id);
-      $[0] = id;
-      $[1] = register;
-      $[2] = t0;
-    } else {
-      t0 = $[2];
-    }
-    let t1;
-    if ($[3] !== id || $[4] !== key || $[5] !== register) {
-      t1 = [register, id, key];
-      $[3] = id;
-      $[4] = key;
-      $[5] = register;
-      $[6] = t1;
-    } else {
-      t1 = $[6];
-    }
-    useEffect(t0, t1);
-    let t2;
-    if ($[7] !== id || $[8] !== updateValue || $[9] !== value) {
-      t2 = () => updateValue(id, value);
-      $[7] = id;
-      $[8] = updateValue;
-      $[9] = value;
-      $[10] = t2;
-    } else {
-      t2 = $[10];
-    }
-    let t3;
-    if ($[11] !== id || $[12] !== key || $[13] !== updateValue || $[14] !== value) {
-      t3 = [updateValue, id, value, key];
-      $[11] = id;
-      $[12] = key;
-      $[13] = updateValue;
-      $[14] = value;
-      $[15] = t3;
-    } else {
-      t3 = $[15];
-    }
-    useEffect(t2, t3);
-    return id;
-  }
-  const unsetValue = Symbol('unset');
-
-  /** Provide context for registering descendant components. This only needs to wrap `children`. */
-  function Provider(t0) {
-    const $ = c(14);
-    const {
-      children,
-      setRegistry
-    } = t0;
-    const workingRegistryRef = useRef("queued");
-    const [key, rebuildRegistry] = useReducer(_temp, 0);
-    let t1;
-    if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
-      t1 = function instantiateNewRegistry() {
-        if (workingRegistryRef.current === "queued") {
-          workingRegistryRef.current = new Map();
-        }
-      };
-      $[0] = t1;
-    } else {
-      t1 = $[0];
-    }
-    useIsomorphicLayoutEffect(t1);
-    let t2;
-    if ($[1] !== setRegistry) {
-      t2 = id => {
-        if (workingRegistryRef.current instanceof Map) {
-          workingRegistryRef.current.set(id, unsetValue);
-        } else {
-          if (workingRegistryRef.current === "idle") {
-            workingRegistryRef.current = "queued";
-            rebuildRegistry();
-          }
-        }
-        return function unregister() {
-          if (workingRegistryRef.current instanceof Map) {
-            workingRegistryRef.current.delete(id);
-          } else {
-            if (workingRegistryRef.current === "idle") {
-              setRegistry(prev_0 => {
-                const copy = new Map(prev_0);
-                copy.delete(id);
-                return copy;
-              });
-            }
-          }
-        };
-      };
-      $[1] = setRegistry;
-      $[2] = t2;
-    } else {
-      t2 = $[2];
-    }
-    const register = t2;
-    let t3;
-    if ($[3] !== setRegistry) {
-      t3 = (id_0, value) => {
-        if (workingRegistryRef.current instanceof Map) {
-          workingRegistryRef.current.set(id_0, value);
-        } else {
-          if (workingRegistryRef.current === "idle") {
-            setRegistry(prev_1 => new Map(prev_1).set(id_0, value));
-          }
-        }
-      };
-      $[3] = setRegistry;
-      $[4] = t3;
-    } else {
-      t3 = $[4];
-    }
-    const updateValue = t3;
-    let t4;
-    if ($[5] !== setRegistry) {
-      t4 = function commitWorkingRegistry() {
-        if (workingRegistryRef.current instanceof Map) {
-          const setEntries = Array.from(workingRegistryRef.current.entries()).filter(_temp2);
-          setRegistry(new Map(setEntries));
-          workingRegistryRef.current = "idle";
-        }
-      };
-      $[5] = setRegistry;
-      $[6] = t4;
-    } else {
-      t4 = $[6];
-    }
-    useEffect(t4);
-    let t5;
-    if ($[7] !== key || $[8] !== register || $[9] !== updateValue) {
-      t5 = {
-        register,
-        updateValue,
-        key
-      };
-      $[7] = key;
-      $[8] = register;
-      $[9] = updateValue;
-      $[10] = t5;
-    } else {
-      t5 = $[10];
-    }
-    const contextValue = t5;
-    let t6;
-    if ($[11] !== children || $[12] !== contextValue) {
-      t6 = /*#__PURE__*/jsx(Context.Provider, {
-        value: contextValue,
-        children: children
-      });
-      $[11] = children;
-      $[12] = contextValue;
-      $[13] = t6;
-    } else {
-      t6 = $[13];
-    }
-    return t6;
-  }
-  function _temp2(entry) {
-    return entry[1] !== unsetValue;
-  }
-  function _temp(prev) {
-    return prev + 1;
-  }
-  return {
-    Provider,
-    useRegistryState,
-    useRegisterDescendant
-  };
+	const Context = /*#__PURE__*/ createContext({
+		register: () => () => {},
+		updateValue: () => {},
+		key: -1
+	});
+	/**
+	* Instantiate descendant registry state. The initial value will be `undefined`, indicating that the registry hasn't
+	* been built yet.
+	*/
+	function useRegistryState() {
+		return useState();
+	}
+	/** Register a descendant component with the registry. */
+	function useRegisterDescendant(value) {
+		const $ = c(16);
+		const { register, updateValue, key } = useContext(Context);
+		const id = useId();
+		let t0;
+		if ($[0] !== id || $[1] !== register) {
+			t0 = () => register(id);
+			$[0] = id;
+			$[1] = register;
+			$[2] = t0;
+		} else t0 = $[2];
+		let t1;
+		if ($[3] !== id || $[4] !== key || $[5] !== register) {
+			t1 = [
+				register,
+				id,
+				key
+			];
+			$[3] = id;
+			$[4] = key;
+			$[5] = register;
+			$[6] = t1;
+		} else t1 = $[6];
+		useEffect(t0, t1);
+		let t2;
+		if ($[7] !== id || $[8] !== updateValue || $[9] !== value) {
+			t2 = () => updateValue(id, value);
+			$[7] = id;
+			$[8] = updateValue;
+			$[9] = value;
+			$[10] = t2;
+		} else t2 = $[10];
+		let t3;
+		if ($[11] !== id || $[12] !== key || $[13] !== updateValue || $[14] !== value) {
+			t3 = [
+				updateValue,
+				id,
+				value,
+				key
+			];
+			$[11] = id;
+			$[12] = key;
+			$[13] = updateValue;
+			$[14] = value;
+			$[15] = t3;
+		} else t3 = $[15];
+		useEffect(t2, t3);
+		return id;
+	}
+	const unsetValue = Symbol("unset");
+	/** Provide context for registering descendant components. This only needs to wrap `children`. */
+	function Provider(t0) {
+		const $ = c(14);
+		const { children, setRegistry } = t0;
+		const workingRegistryRef = useRef("queued");
+		const [key, rebuildRegistry] = useReducer(_temp, 0);
+		let t1;
+		if ($[0] === Symbol.for("react.memo_cache_sentinel")) {
+			t1 = function instantiateNewRegistry() {
+				if (workingRegistryRef.current === "queued") workingRegistryRef.current = /* @__PURE__ */ new Map();
+			};
+			$[0] = t1;
+		} else t1 = $[0];
+		useIsomorphicLayoutEffect(t1);
+		let t2;
+		if ($[1] !== setRegistry) {
+			t2 = (id) => {
+				if (workingRegistryRef.current instanceof Map) workingRegistryRef.current.set(id, unsetValue);
+				else if (workingRegistryRef.current === "idle") {
+					workingRegistryRef.current = "queued";
+					rebuildRegistry();
+				}
+				return function unregister() {
+					if (workingRegistryRef.current instanceof Map) workingRegistryRef.current.delete(id);
+					else if (workingRegistryRef.current === "idle") setRegistry((prev_0) => {
+						const copy = new Map(prev_0);
+						copy.delete(id);
+						return copy;
+					});
+				};
+			};
+			$[1] = setRegistry;
+			$[2] = t2;
+		} else t2 = $[2];
+		const register = t2;
+		let t3;
+		if ($[3] !== setRegistry) {
+			t3 = (id_0, value) => {
+				if (workingRegistryRef.current instanceof Map) workingRegistryRef.current.set(id_0, value);
+				else if (workingRegistryRef.current === "idle") setRegistry((prev_1) => new Map(prev_1).set(id_0, value));
+			};
+			$[3] = setRegistry;
+			$[4] = t3;
+		} else t3 = $[4];
+		const updateValue = t3;
+		let t4;
+		if ($[5] !== setRegistry) {
+			t4 = function commitWorkingRegistry() {
+				if (workingRegistryRef.current instanceof Map) {
+					const setEntries = Array.from(workingRegistryRef.current.entries()).filter(_temp2);
+					setRegistry(new Map(setEntries));
+					workingRegistryRef.current = "idle";
+				}
+			};
+			$[5] = setRegistry;
+			$[6] = t4;
+		} else t4 = $[6];
+		useEffect(t4);
+		let t5;
+		if ($[7] !== key || $[8] !== register || $[9] !== updateValue) {
+			t5 = {
+				register,
+				updateValue,
+				key
+			};
+			$[7] = key;
+			$[8] = register;
+			$[9] = updateValue;
+			$[10] = t5;
+		} else t5 = $[10];
+		const contextValue = t5;
+		let t6;
+		if ($[11] !== children || $[12] !== contextValue) {
+			t6 = /*#__PURE__*/ jsx(Context.Provider, {
+				value: contextValue,
+				children
+			});
+			$[11] = children;
+			$[12] = contextValue;
+			$[13] = t6;
+		} else t6 = $[13];
+		return t6;
+	}
+	function _temp2(entry) {
+		return entry[1] !== unsetValue;
+	}
+	function _temp(prev) {
+		return prev + 1;
+	}
+	return {
+		Provider,
+		useRegistryState,
+		useRegisterDescendant
+	};
 }
-
+//#endregion
 export { createDescendantRegistry };

package/dist/utils/environment.js

@@ -1,24 +1,13 @@
-import { version } from 'react';
-
+import { version } from "react";
+//#region src/utils/environment.ts
 /**
- * Indicate whether current execution environment can access the DOM.
- *
- * @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
- */
-// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition,ssr-friendly/no-dom-globals-in-module-scope
-const canUseDOM = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
-
-// Grab the major version from react. This could be formatted as any valid
-// semver version, e.g.:
-//
-// - 19.0.0
-// - 19.0.0-rc.1
-// - 0.0.0-{channel}-{commit}-{time}
-//
-// So we only pull the first part of the version and parse it.
-const reactVersion = version.split('.');
+* Indicate whether current execution environment can access the DOM.
+*
+* @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
+*/
+const canUseDOM = !!(typeof window !== "undefined" && window.document && window.document.createElement);
+const reactVersion = version.split(".");
 const reactMajorVersion = parseInt(reactVersion[0], 10);
-const EXPERIMENTAL_REACT_VERSION_REGEX = /^0\.0\.0-experimental-[a-f0-9]{8}-\d{8}$/;
-const isExperimentalReactVersion = EXPERIMENTAL_REACT_VERSION_REGEX.test(version);
-
+const isExperimentalReactVersion = /^0\.0\.0-experimental-[a-f0-9]{8}-\d{8}$/.test(version);
+//#endregion
 export { canUseDOM, isExperimentalReactVersion, reactMajorVersion };

package/dist/utils/getBreakpointDeclarations.js

@@ -1,15 +1,14 @@
+//#region src/utils/getBreakpointDeclarations.ts
 function areAllValuesTheSame(responsiveValue) {
-  if ('narrow' in responsiveValue && 'regular' in responsiveValue && 'wide' in responsiveValue) {
-    const values = Object.values(responsiveValue);
-    return values.every(value => value === values[0]);
-  }
-  return false;
+	if ("narrow" in responsiveValue && "regular" in responsiveValue && "wide" in responsiveValue) {
+		const values = Object.values(responsiveValue);
+		return values.every((value) => value === values[0]);
+	}
+	return false;
 }
 function haveRegularAndWideSameValue(responsiveValue) {
-  if ('regular' in responsiveValue && 'wide' in responsiveValue) {
-    return responsiveValue.regular === responsiveValue.wide;
-  }
-  return false;
+	if ("regular" in responsiveValue && "wide" in responsiveValue) return responsiveValue.regular === responsiveValue.wide;
+	return false;
 }
-
+//#endregion
 export { areAllValuesTheSame, haveRegularAndWideSameValue };

package/dist/utils/invariant.js

@@ -1,24 +1,18 @@
-function emptyFunction() {}
-
-// Inspired by invariant by fbjs
-// @see https://github.com/facebook/fbjs/blob/main/packages/fbjs/src/__forks__/invariant.js
-const invariant = process.env.NODE_ENV !== "production" ?
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function invariant(condition, format, ...args) {
-  if (!condition) {
-    let error;
-    if (format === undefined) {
-      error = new Error('Minified exception occurred; use the non-minified dev environment ' + 'for the full error message and additional helpful warnings.');
-    } else {
-      let index = 0;
-      const message = format.replace(/%s/g, () => {
-        return args[index++];
-      });
-      error = new Error(message);
-      error.name = 'Invariant Violation';
-    }
-    throw error;
-  }
-} : emptyFunction;
-
+//#region src/utils/invariant.ts
+const invariant = function invariant(condition, format, ...args) {
+	if (!condition) {
+		let error;
+		if (format === void 0) error = /* @__PURE__ */ new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");
+		else {
+			let index = 0;
+			const message = format.replace(/%s/g, () => {
+				return args[index++];
+			});
+			error = new Error(message);
+			error.name = "Invariant Violation";
+		}
+		throw error;
+	}
+};
+//#endregion
 export { invariant };

package/dist/utils/is-slot.d.ts

@@ -1,6 +1,9 @@
-import type { WithSlotMarker } from './types';
+import { WithSlotMarker } from "./types/Slots.js";
+
+//#region src/utils/is-slot.d.ts
 /**
  * Determines whether a given element is a valid slot for the supplied slot component
  */
-export declare function isSlot(element: unknown, slot: WithSlotMarker<unknown>): boolean;
-//# sourceMappingURL=is-slot.d.ts.map
+declare function isSlot(element: unknown, slot: WithSlotMarker<unknown>): boolean;
+//#endregion
+export { isSlot };

package/dist/utils/is-slot.js

@@ -1,15 +1,14 @@
+//#region src/utils/is-slot.ts
 /**
- * Determines whether a given element is a valid slot for the supplied slot component
- */
+* Determines whether a given element is a valid slot for the supplied slot component
+*/
 function isSlot(element, slot) {
-  var _reactElement$__SLOT_, _reactElement$type;
-  const elementType = typeof element;
-  if (elementType !== 'object' && elementType !== 'function' && element != null) {
-    return false;
-  }
-  const reactElement = element;
-  const elementSlot = (_reactElement$__SLOT_ = reactElement.__SLOT__) !== null && _reactElement$__SLOT_ !== void 0 ? _reactElement$__SLOT_ : (_reactElement$type = reactElement.type) === null || _reactElement$type === void 0 ? void 0 : _reactElement$type.__SLOT__;
-  return slot.__SLOT__ ? elementSlot === slot.__SLOT__ : false;
+	var _reactElement$__SLOT_, _reactElement$type;
+	const elementType = typeof element;
+	if (elementType !== "object" && elementType !== "function" && element != null) return false;
+	const reactElement = element;
+	const elementSlot = (_reactElement$__SLOT_ = reactElement.__SLOT__) !== null && _reactElement$__SLOT_ !== void 0 ? _reactElement$__SLOT_ : (_reactElement$type = reactElement.type) === null || _reactElement$type === void 0 ? void 0 : _reactElement$type.__SLOT__;
+	return slot.__SLOT__ ? elementSlot === slot.__SLOT__ : false;
 }
-
+//#endregion
 export { isSlot };

package/dist/utils/isNumeric.js

@@ -1,6 +1,6 @@
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+//#region src/utils/isNumeric.tsx
 function isNumeric(n) {
-  return !isNaN(parseFloat(n)) && isFinite(n);
+	return !isNaN(parseFloat(n)) && isFinite(n);
 }
-
+//#endregion
 export { isNumeric as default };

package/dist/utils/modern-polymorphic.d.ts

@@ -1,22 +1,16 @@
-import type { ComponentPropsWithRef, ElementType } from 'react';
+import { ComponentPropsWithRef, ElementType } from "react";
+
+//#region src/utils/modern-polymorphic.d.ts
 /**
  * Distributive Omit utility type that works correctly with union types
  */
-export type DistributiveOmit<T, TOmitted extends PropertyKey> = T extends unknown ? Omit<T, TOmitted> : never;
-/**
- * Fixed version of forwardRef that provides better type inference for polymorphic components
- */
-type FixedForwardRef = <T, P = object>(render: (props: P, ref: React.Ref<T>) => React.ReactNode) => (props: P & React.RefAttributes<T>) => React.ReactNode;
-/**
- * Cast forwardRef to the fixed version with better type inference
- */
-export declare const fixedForwardRef: FixedForwardRef;
+type DistributiveOmit<T, TOmitted extends PropertyKey> = T extends unknown ? Omit<T, TOmitted> : never;
 /**
  * Simplified polymorphic props type that handles the common pattern of
  * `DistributiveOmit<ComponentPropsWithRef<ElementType extends As ? DefaultElement : As>, 'as'>`
  */
-export type PolymorphicProps<TAs extends ElementType, TDefaultElement extends ElementType = 'div', Props = object> = DistributiveOmit<ComponentPropsWithRef<ElementType extends TAs ? TDefaultElement : TAs> & Props, 'as'> & {
-    as?: TAs;
+type PolymorphicProps<TAs extends ElementType, TDefaultElement extends ElementType = 'div', Props = object> = DistributiveOmit<ComponentPropsWithRef<ElementType extends TAs ? TDefaultElement : TAs> & Props, 'as'> & {
+  as?: TAs;
 };
-export {};
-//# sourceMappingURL=modern-polymorphic.d.ts.map
+//#endregion
+export { DistributiveOmit, PolymorphicProps };

package/dist/utils/modern-polymorphic.js

@@ -1,26 +1,18 @@
-import { forwardRef } from 'react';
-
-// Mostly taken from https://github.com/total-typescript/react-typescript-tutorial/blob/main/src/08-advanced-patterns/72-as-prop-with-forward-ref.solution.tsx
-
-
+import { forwardRef } from "react";
+//#region src/utils/modern-polymorphic.ts
 /**
- * Distributive Omit utility type that works correctly with union types
- */
-
+* Distributive Omit utility type that works correctly with union types
+*/
 /**
- * Fixed version of forwardRef that provides better type inference for polymorphic components
- */
-// TODO: figure out how to change this type so we can set displayName
-// like this: `ComponentName.displayName = 'DisplayName' instead of using workarounds
-
+* Fixed version of forwardRef that provides better type inference for polymorphic components
+*/
 /**
- * Cast forwardRef to the fixed version with better type inference
- */
+* Cast forwardRef to the fixed version with better type inference
+*/
 const fixedForwardRef = forwardRef;
-
 /**
- * Simplified polymorphic props type that handles the common pattern of
- * `DistributiveOmit<ComponentPropsWithRef<ElementType extends As ? DefaultElement : As>, 'as'>`
- */
-
+* Simplified polymorphic props type that handles the common pattern of
+* `DistributiveOmit<ComponentPropsWithRef<ElementType extends As ? DefaultElement : As>, 'as'>`
+*/
+//#endregion
 export { fixedForwardRef };