refactor: port requiredIfGivenPropIsTruthy to typescript (#20392)

Author: adamalston

packages/react/src/components/ComposedModal/ComposedModal.tsx

@@ -29,7 +29,7 @@ import useIsomorphicEffect from '../../internal/useIsomorphicEffect';
 import mergeRefs from '../../tools/mergeRefs';
 import cx from 'classnames';
 import { toggleClass } from '../../tools/toggleClass';
-import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy';
+import { requiredIfGivenPropIsTruthy } from '../../prop-types/requiredIfGivenPropIsTruthy';
 import {
   elementOrParentIsFloatingMenu,
   wrapFocus,

packages/react/src/components/DataTable/TableExpandHeader.tsx

@@ -11,7 +11,7 @@ import PropTypes from 'prop-types';
 import React, { type HTMLAttributes } from 'react';
 import { usePrefix } from '../../internal/usePrefix';
 import { deprecate } from '../../prop-types/deprecate';
-import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy';
+import { requiredIfGivenPropIsTruthy } from '../../prop-types/requiredIfGivenPropIsTruthy';
 
 export type TableExpandHeaderPropsBase = {
   /**

packages/react/src/components/Modal/Modal.tsx

@@ -22,7 +22,7 @@ import Button from '../Button';
 import ButtonSet from '../ButtonSet';
 import InlineLoading from '../InlineLoading';
 import { Layer } from '../Layer';
-import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy';
+import { requiredIfGivenPropIsTruthy } from '../../prop-types/requiredIfGivenPropIsTruthy';
 import {
   elementOrParentIsFloatingMenu,
   wrapFocus,

packages/react/src/prop-types/requiredIfGivenPropIsTruthy.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright IBM Corp. 2016, 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import type { Validator } from 'prop-types';
+
+/**
+ * @param name The name of the prop that must exist to validate the current
+ * prop.
+ * @param propType The original prop type checker.
+ * @returns The new prop type checker for the current prop that becomes required
+ * if the prop corresponding to the provided prop name exists.
+ */
+export const requiredIfGivenPropIsTruthy = <T>(
+  name: string,
+  propType: Validator<T>
+): Validator<T> => {
+  return (props, propName, componentName, ...rest) => {
+    if (
+      process.env.NODE_ENV !== 'production' &&
+      props[name] === true &&
+      props[propName] === null
+    ) {
+      return new Error(
+        `You must provide a value for \`${propName}\` in \`${componentName}\` if \`${name}\` exists.`
+      );
+    }
+    return propType(props, propName, componentName, ...rest);
+  };
+};