@fluentui/react-utilities 0.0.0-nightly-20220302-0405.1

package/lib-commonjs/utils/getReactCallbackName.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+interface ReactSyntheticEvent extends React.SyntheticEvent<unknown> {
+    _reactName?: string;
+    dispatchConfig?: {
+        registrationName: string;
+        phasedRegistrationNames: {
+            bubbled: string;
+            captured: string;
+        };
+    };
+}
+declare type NonUndefined<A> = A extends undefined ? never : A;
+declare type FunctionKeys<T extends object> = {
+    [K in keyof T]-?: NonUndefined<T[K]> extends Function ? K : never;
+}[keyof T];
+export declare type ReactCallbackName = FunctionKeys<React.DOMAttributes<unknown>>;
+/**
+ * React.SyntheticEvent contains name of a callback that should be fired, this function returns it.
+ *
+ * Ideally, it should also distinguish regular and "capture" callbacks, but it's possible only with React 17 as
+ * ".eventPhase" there has proper value, see https://github.com/facebook/react/pull/19244. In React 16 all events
+ * are handled in bubble phase.
+ */
+export declare function getReactCallbackName(event: ReactSyntheticEvent): ReactCallbackName | undefined;
+export {};

package/lib-commonjs/utils/getReactCallbackName.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getReactCallbackName = void 0;
+/**
+ * React.SyntheticEvent contains name of a callback that should be fired, this function returns it.
+ *
+ * Ideally, it should also distinguish regular and "capture" callbacks, but it's possible only with React 17 as
+ * ".eventPhase" there has proper value, see https://github.com/facebook/react/pull/19244. In React 16 all events
+ * are handled in bubble phase.
+ */
+
+function getReactCallbackName(event) {
+  if (event._reactName) {
+    return event._reactName;
+  }
+
+  if (event.dispatchConfig) {
+    if (event.dispatchConfig.registrationName) {
+      return event.dispatchConfig.registrationName;
+    }
+
+    return event.dispatchConfig.phasedRegistrationNames.bubbled;
+  }
+
+  if (process.env.NODE_ENV !== 'production') {
+    // eslint-disable-next-line no-console
+    console.error(['Passed React.SyntheticEvent does not contain ".dispatchConfig" or "._reactName".', 'This should not happen, please report it to https://github.com/microsoft/fluentui']);
+  }
+}
+
+exports.getReactCallbackName = getReactCallbackName;
+//# sourceMappingURL=getReactCallbackName.js.map

package/lib-commonjs/utils/getReactCallbackName.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["utils/getReactCallbackName.ts"],"names":[],"mappings":";;;;;;AAwBA;;;;;;AAMG;;AACH,SAAgB,oBAAhB,CAAqC,KAArC,EAA+D;AAC7D,MAAI,KAAK,CAAC,UAAV,EAAsB;AACpB,WAAO,KAAK,CAAC,UAAb;AACD;;AAED,MAAI,KAAK,CAAC,cAAV,EAA0B;AACxB,QAAI,KAAK,CAAC,cAAN,CAAqB,gBAAzB,EAA2C;AACzC,aAAO,KAAK,CAAC,cAAN,CAAqB,gBAA5B;AACD;;AAED,WAAO,KAAK,CAAC,cAAN,CAAqB,uBAArB,CAA6C,OAApD;AACD;;AAED,MAAI,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAA7B,EAA2C;AACzC;AACA,IAAA,OAAO,CAAC,KAAR,CAAc,CACZ,kFADY,EAEZ,mFAFY,CAAd;AAID;AACF;;AApBD,OAAA,CAAA,oBAAA,GAAA,oBAAA","sourcesContent":["import * as React from 'react';\n\ninterface ReactSyntheticEvent extends React.SyntheticEvent<unknown> {\n  // React 17/18\n  // See https://github.com/facebook/react/pull/19236\n  _reactName?: string;\n\n  // React 16\n  dispatchConfig?: {\n    registrationName: string;\n    phasedRegistrationNames: {\n      bubbled: string;\n      captured: string;\n    };\n  };\n}\n\ntype NonUndefined<A> = A extends undefined ? never : A;\ntype FunctionKeys<T extends object> = {\n  [K in keyof T]-?: NonUndefined<T[K]> extends Function ? K : never;\n}[keyof T];\n\nexport type ReactCallbackName = FunctionKeys<React.DOMAttributes<unknown>>;\n\n/**\n * React.SyntheticEvent contains name of a callback that should be fired, this function returns it.\n *\n * Ideally, it should also distinguish regular and \"capture\" callbacks, but it's possible only with React 17 as\n * \".eventPhase\" there has proper value, see https://github.com/facebook/react/pull/19244. In React 16 all events\n * are handled in bubble phase.\n */\nexport function getReactCallbackName(event: ReactSyntheticEvent): ReactCallbackName | undefined {\n  if (event._reactName) {\n    return event._reactName as ReactCallbackName;\n  }\n\n  if (event.dispatchConfig) {\n    if (event.dispatchConfig.registrationName) {\n      return event.dispatchConfig.registrationName as ReactCallbackName;\n    }\n\n    return event.dispatchConfig.phasedRegistrationNames.bubbled as ReactCallbackName;\n  }\n\n  if (process.env.NODE_ENV !== 'production') {\n    // eslint-disable-next-line no-console\n    console.error([\n      'Passed React.SyntheticEvent does not contain \".dispatchConfig\" or \"._reactName\".',\n      'This should not happen, please report it to https://github.com/microsoft/fluentui',\n    ]);\n  }\n}\n"],"sourceRoot":"../src/"}

package/lib-commonjs/utils/getTriggerChild.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+/**
+ * Gets the trigger element of a FluentTriggerComponent (such as Tooltip or MenuTrigger).
+ *
+ * In the case where the immediate child is itself a FluentTriggerComponent and/or React Fragment,
+ * it returns the first descendant that is _not_ a FluentTriggerComponent or Fragment.
+ * This allows multiple triggers to be stacked, and still apply their props to the actual trigger element.
+ *
+ * For example, the following returns `<div id="child" />`:
+ * ```jsx
+ * getTriggerChild(
+ *   <Tooltip>
+ *     <MenuTrigger>
+ *       <div id="child" />
+ *     </MenuTrigger>
+ *   </Tooltip>
+ * );
+ * ```
+ */
+export declare const getTriggerChild: (children: React.ReactNode) => React.ReactElement & {
+    ref?: React.Ref<unknown>;
+};

package/lib-commonjs/utils/getTriggerChild.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getTriggerChild = void 0;
+
+const React = /*#__PURE__*/require("react");
+
+const isFluentTrigger_1 = /*#__PURE__*/require("./isFluentTrigger");
+/**
+ * Gets the trigger element of a FluentTriggerComponent (such as Tooltip or MenuTrigger).
+ *
+ * In the case where the immediate child is itself a FluentTriggerComponent and/or React Fragment,
+ * it returns the first descendant that is _not_ a FluentTriggerComponent or Fragment.
+ * This allows multiple triggers to be stacked, and still apply their props to the actual trigger element.
+ *
+ * For example, the following returns `<div id="child" />`:
+ * ```jsx
+ * getTriggerChild(
+ *   <Tooltip>
+ *     <MenuTrigger>
+ *       <div id="child" />
+ *     </MenuTrigger>
+ *   </Tooltip>
+ * );
+ * ```
+ */
+
+
+const getTriggerChild = children => {
+  const child = React.Children.only(children);
+  return isFluentTrigger_1.isFluentTrigger(child) ? exports.getTriggerChild(child.props.children) : child;
+};
+
+exports.getTriggerChild = getTriggerChild;
+//# sourceMappingURL=getTriggerChild.js.map

package/lib-commonjs/utils/getTriggerChild.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["utils/getTriggerChild.ts"],"names":[],"mappings":";;;;;;;AAAA,MAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,MAAA,iBAAA,gBAAA,OAAA,CAAA,mBAAA,CAAA;AAEA;;;;;;;;;;;;;;;;;AAiBG;;;AACI,MAAM,eAAe,GAAI,QAAD,IAAiF;AAC9G,QAAM,KAAK,GAAG,KAAK,CAAC,QAAN,CAAe,IAAf,CAAoB,QAApB,CAAd;AACA,SAAO,iBAAA,CAAA,eAAA,CAAgB,KAAhB,IAAyB,OAAA,CAAA,eAAA,CAAgB,KAAK,CAAC,KAAN,CAAY,QAA5B,CAAzB,GAAiE,KAAxE;AACD,CAHM;;AAAM,OAAA,CAAA,eAAA,GAAe,eAAf","sourcesContent":["import * as React from 'react';\nimport { isFluentTrigger } from './isFluentTrigger';\n\n/**\n * Gets the trigger element of a FluentTriggerComponent (such as Tooltip or MenuTrigger).\n *\n * In the case where the immediate child is itself a FluentTriggerComponent and/or React Fragment,\n * it returns the first descendant that is _not_ a FluentTriggerComponent or Fragment.\n * This allows multiple triggers to be stacked, and still apply their props to the actual trigger element.\n *\n * For example, the following returns `<div id=\"child\" />`:\n * ```jsx\n * getTriggerChild(\n *   <Tooltip>\n *     <MenuTrigger>\n *       <div id=\"child\" />\n *     </MenuTrigger>\n *   </Tooltip>\n * );\n * ```\n */\nexport const getTriggerChild = (children: React.ReactNode): React.ReactElement & { ref?: React.Ref<unknown> } => {\n  const child = React.Children.only(children) as React.ReactElement;\n  return isFluentTrigger(child) ? getTriggerChild(child.props.children) : child;\n};\n"],"sourceRoot":"../src/"}

package/lib-commonjs/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from './applyTriggerPropsToChildren';
+export * from './clamp';
+export * from './getNativeElementProps';
+export * from './getRTLSafeKey';
+export * from './getTriggerChild';
+export * from './isFluentTrigger';
+export * from './omit';
+export * from './properties';
+export * from './shouldPreventDefaultOnKeyDown';

package/lib-commonjs/utils/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+const tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./applyTriggerPropsToChildren"), exports);
+
+tslib_1.__exportStar(require("./clamp"), exports);
+
+tslib_1.__exportStar(require("./getNativeElementProps"), exports);
+
+tslib_1.__exportStar(require("./getRTLSafeKey"), exports);
+
+tslib_1.__exportStar(require("./getTriggerChild"), exports);
+
+tslib_1.__exportStar(require("./isFluentTrigger"), exports);
+
+tslib_1.__exportStar(require("./omit"), exports);
+
+tslib_1.__exportStar(require("./properties"), exports);
+
+tslib_1.__exportStar(require("./shouldPreventDefaultOnKeyDown"), exports);
+//# sourceMappingURL=index.js.map

package/lib-commonjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["utils/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,+BAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,SAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,yBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,iBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,mBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,mBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,QAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,cAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,iCAAA,CAAA,EAAA,OAAA","sourcesContent":["export * from './applyTriggerPropsToChildren';\nexport * from './clamp';\nexport * from './getNativeElementProps';\nexport * from './getRTLSafeKey';\nexport * from './getTriggerChild';\nexport * from './isFluentTrigger';\nexport * from './omit';\nexport * from './properties';\nexport * from './shouldPreventDefaultOnKeyDown';\n"],"sourceRoot":"../src/"}

package/lib-commonjs/utils/isFluentTrigger.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+/**
+ * Allows a component to be tagged as a FluentUI trigger component.
+ *
+ * Triggers are special-case components: they attach event listeners and other props on their child,
+ * and use them to trigger another component to show. Examples include `MenuTrigger` and `Tooltip`.
+ *
+ * A component can be tagged as a trigger as follows:
+ * ```ts
+ * const MyComponent: React.FC<MyComponentProps> & FluentTriggerComponent = ...;
+ *
+ * MyComponent.isFluentTriggerComponent = true; // MUST also set this to true
+ * ```
+ */
+export declare type FluentTriggerComponent = {
+    isFluentTriggerComponent?: boolean;
+};
+/**
+ * Checks if a given element is a FluentUI trigger (e.g. `MenuTrigger` or `Tooltip`).
+ * See the {@link FluentTriggerComponent} type for more info.
+ */
+export declare const isFluentTrigger: (element: React.ReactElement) => boolean | undefined;

package/lib-commonjs/utils/isFluentTrigger.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isFluentTrigger = void 0;
+/**
+ * Checks if a given element is a FluentUI trigger (e.g. `MenuTrigger` or `Tooltip`).
+ * See the {@link FluentTriggerComponent} type for more info.
+ */
+
+const isFluentTrigger = element => {
+  return element.type.isFluentTriggerComponent;
+};
+
+exports.isFluentTrigger = isFluentTrigger;
+//# sourceMappingURL=isFluentTrigger.js.map

package/lib-commonjs/utils/isFluentTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["utils/isFluentTrigger.ts"],"names":[],"mappings":";;;;;;AAmBA;;;AAGG;;AACI,MAAM,eAAe,GAAI,OAAD,IAAgC;AAC7D,SAAQ,OAAO,CAAC,IAAR,CAAwC,wBAAhD;AACD,CAFM;;AAAM,OAAA,CAAA,eAAA,GAAe,eAAf","sourcesContent":["import * as React from 'react';\n\n/**\n * Allows a component to be tagged as a FluentUI trigger component.\n *\n * Triggers are special-case components: they attach event listeners and other props on their child,\n * and use them to trigger another component to show. Examples include `MenuTrigger` and `Tooltip`.\n *\n * A component can be tagged as a trigger as follows:\n * ```ts\n * const MyComponent: React.FC<MyComponentProps> & FluentTriggerComponent = ...;\n *\n * MyComponent.isFluentTriggerComponent = true; // MUST also set this to true\n * ```\n */\nexport type FluentTriggerComponent = {\n  isFluentTriggerComponent?: boolean;\n};\n\n/**\n * Checks if a given element is a FluentUI trigger (e.g. `MenuTrigger` or `Tooltip`).\n * See the {@link FluentTriggerComponent} type for more info.\n */\nexport const isFluentTrigger = (element: React.ReactElement) => {\n  return (element.type as FluentTriggerComponent).isFluentTriggerComponent;\n};\n"],"sourceRoot":"../src/"}

package/lib-commonjs/utils/omit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tiny helper to do the minimal amount of work in duplicating an object but omitting some
+ * props. This ends up faster than using object ...rest or reduce to filter.
+ *
+ * This behaves very much like filteredAssign, but does not merge many objects together,
+ * uses an exclusion object map, and avoids spreads all for optimal performance.
+ *
+ * See perf test for background:
+ * https://jsperf.com/omit-vs-rest-vs-reduce/1
+ *
+ * @param obj - The object to clone
+ * @param exclusions - The array of keys to exclude
+ */
+export declare function omit<TObj extends Record<string, any>, Exclusions extends (keyof TObj)[]>(obj: TObj, exclusions: Exclusions): Omit<TObj, Exclusions[number]>;

package/lib-commonjs/utils/omit.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.omit = void 0;
+/**
+ * Tiny helper to do the minimal amount of work in duplicating an object but omitting some
+ * props. This ends up faster than using object ...rest or reduce to filter.
+ *
+ * This behaves very much like filteredAssign, but does not merge many objects together,
+ * uses an exclusion object map, and avoids spreads all for optimal performance.
+ *
+ * See perf test for background:
+ * https://jsperf.com/omit-vs-rest-vs-reduce/1
+ *
+ * @param obj - The object to clone
+ * @param exclusions - The array of keys to exclude
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+function omit(obj, exclusions) {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const result = {};
+
+  for (const key in obj) {
+    if (exclusions.indexOf(key) === -1 && obj.hasOwnProperty(key)) {
+      result[key] = obj[key];
+    }
+  }
+
+  return result;
+}
+
+exports.omit = omit;
+//# sourceMappingURL=omit.js.map

package/lib-commonjs/utils/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["utils/omit.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;AAYG;AACH;;AACA,SAAgB,IAAhB,CACE,GADF,EAEE,UAFF,EAEwB;AAEtB;AACA,QAAM,MAAM,GAAwB,EAApC;;AAEA,OAAK,MAAM,GAAX,IAAkB,GAAlB,EAAuB;AACrB,QAAI,UAAU,CAAC,OAAX,CAAmB,GAAnB,MAA4B,CAAC,CAA7B,IAAkC,GAAG,CAAC,cAAJ,CAAmB,GAAnB,CAAtC,EAA+D;AAC7D,MAAA,MAAM,CAAC,GAAD,CAAN,GAAc,GAAG,CAAC,GAAD,CAAjB;AACD;AACF;;AAED,SAAO,MAAP;AACD;;AAdD,OAAA,CAAA,IAAA,GAAA,IAAA","sourcesContent":["/**\n * Tiny helper to do the minimal amount of work in duplicating an object but omitting some\n * props. This ends up faster than using object ...rest or reduce to filter.\n *\n * This behaves very much like filteredAssign, but does not merge many objects together,\n * uses an exclusion object map, and avoids spreads all for optimal performance.\n *\n * See perf test for background:\n * https://jsperf.com/omit-vs-rest-vs-reduce/1\n *\n * @param obj - The object to clone\n * @param exclusions - The array of keys to exclude\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function omit<TObj extends Record<string, any>, Exclusions extends (keyof TObj)[]>(\n  obj: TObj,\n  exclusions: Exclusions,\n): Omit<TObj, Exclusions[number]> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const result: Record<string, any> = {};\n\n  for (const key in obj) {\n    if (exclusions.indexOf(key) === -1 && obj.hasOwnProperty(key)) {\n      result[key] = obj[key];\n    }\n  }\n\n  return result as TObj;\n}\n"],"sourceRoot":"../src/"}

package/lib-commonjs/utils/properties.d.ts

@@ -0,0 +1,154 @@
+/**
+ * An array of events that are allowed on every html element type.
+ *
+ * @public
+ */
+export declare const baseElementEvents: Record<string, number>;
+/**
+ * An array of element attributes which are allowed on every html element type.
+ *
+ * @public
+ */
+export declare const baseElementProperties: Record<string, number>;
+/**
+ * An array of HTML element properties and events.
+ *
+ * @public
+ */
+export declare const htmlElementProperties: Record<string, number>;
+/**
+ * An array of LABEL tag properties and events.
+ *
+ * @public
+ */
+export declare const labelProperties: Record<string, number>;
+/**
+ * An array of AUDIO tag properties and events.
+
+ * @public
+ */
+export declare const audioProperties: Record<string, number>;
+/**
+ * An array of VIDEO tag properties and events.
+ *
+ * @public
+ */
+export declare const videoProperties: Record<string, number>;
+/**
+ * An array of OL tag properties and events.
+ *
+ * @public
+ */
+export declare const olProperties: Record<string, number>;
+/**
+ * An array of LI tag properties and events.
+ *
+ * @public
+ */
+export declare const liProperties: Record<string, number>;
+/**
+ * An array of A tag properties and events.
+ *
+ * @public
+ */
+export declare const anchorProperties: Record<string, number>;
+/**
+ * An array of BUTTON tag properties and events.
+ *
+ * @public
+ */
+export declare const buttonProperties: Record<string, number>;
+/**
+ * An array of INPUT tag properties and events.
+ *
+ * @public
+ */
+export declare const inputProperties: Record<string, number>;
+/**
+ * An array of TEXTAREA tag properties and events.
+ *
+ * @public
+ */
+export declare const textAreaProperties: Record<string, number>;
+/**
+ * An array of SELECT tag properties and events.
+ *
+ * @public
+ */
+export declare const selectProperties: Record<string, number>;
+export declare const optionProperties: Record<string, number>;
+/**
+ * An array of TABLE tag properties and events.
+ *
+ * @public
+ */
+export declare const tableProperties: Record<string, number>;
+/**
+ * An array of TR tag properties and events.
+ *
+ * @public
+ */
+export declare const trProperties: Record<string, number>;
+/**
+ * An array of TH tag properties and events.
+ *
+ * @public
+ */
+export declare const thProperties: Record<string, number>;
+/**
+ * An array of TD tag properties and events.
+ *
+ * @public
+ */
+export declare const tdProperties: Record<string, number>;
+export declare const colGroupProperties: Record<string, number>;
+export declare const colProperties: Record<string, number>;
+/**
+ * An array of FIELDSET tag properties and events.
+ *
+ * @public
+ */
+export declare const fieldsetProperties: Record<string, number>;
+/**
+ * An array of FORM tag properties and events.
+ *
+ * @public
+ */
+export declare const formProperties: Record<string, number>;
+/**
+ * An array of IFRAME tag properties and events.
+ *
+ * @public
+ */
+export declare const iframeProperties: Record<string, number>;
+/**
+ * An array of IMAGE tag properties and events.
+ *
+ * @public
+ */
+export declare const imgProperties: Record<string, number>;
+/**
+ * @deprecated Use imgProperties for img elements.
+ */
+export declare const imageProperties: Record<string, number>;
+/**
+ * An array of DIV tag properties and events.
+ *
+ * @public
+ */
+export declare const divProperties: Record<string, number>;
+/**
+ * Gets native supported props for an html element provided the allowance set. Use one of the property
+ * sets defined (divProperties, buttonPropertes, etc) to filter out supported properties from a given
+ * props set. Note that all data- and aria- prefixed attributes will be allowed.
+ * NOTE: getNativeProps should always be applied first when adding props to a react component. The
+ * non-native props should be applied second. This will prevent getNativeProps from overriding your custom props.
+ * For example, if props passed to getNativeProps has an onClick function and getNativeProps is added to
+ * the component after an onClick function is added, then the getNativeProps onClick will override it.
+ *
+ * @public
+ * @param props - The unfiltered input props
+ * @param allowedPropsNames - The array or record of allowed prop names.
+ * @returns The filtered props
+ */
+export declare function getNativeProps<T extends Record<string, any>>(props: Record<string, any>, allowedPropNames: string[] | Record<string, number>, excludedPropNames?: string[]): T;