@fluentui/react-utilities 9.2.0 → 9.2.2

package/lib-amd/trigger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/trigger/types.ts"],"names":[],"mappings":"","sourcesContent":["import * as React from 'react';\n\n/**\n * @internal\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 * A trigger may have a children that could be either:\n * 1. A single element\n * 2. A render function that will receive properties and must return a valid element or null\n * 3. null or undefined\n */\nexport type TriggerProps<TriggerChildProps = unknown> = {\n  children?: React.ReactElement | ((props: TriggerChildProps) => React.ReactElement | null) | null;\n};\n"]}

package/lib-amd/utils/clamp.js

@@ -0,0 +1,16 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.clamp = void 0;
+    /**
+     * @internal
+     * Clamps `value` to a number between the min and max.
+     *
+     * @param value - the value to be clamped
+     * @param min - the lowest valid value
+     * @param max - the highest valid value
+     */
+    var clamp = function (value, min, max) { return Math.max(min, Math.min(max, value || 0)); };
+    exports.clamp = clamp;
+});
+//# sourceMappingURL=clamp.js.map

package/lib-amd/utils/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/clamp.ts"],"names":[],"mappings":";;;;IAAA;;;;;;;OAOG;IACI,IAAM,KAAK,GAAG,UAAC,KAAa,EAAE,GAAW,EAAE,GAAW,IAAa,OAAA,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAxC,CAAwC,CAAC;IAAtG,QAAA,KAAK,SAAiG","sourcesContent":["/**\n * @internal\n * Clamps `value` to a number between the min and max.\n *\n * @param value - the value to be clamped\n * @param min - the lowest valid value\n * @param max - the highest valid value\n */\nexport const clamp = (value: number, min: number, max: number): number => Math.max(min, Math.min(max, value || 0));\n"]}

package/lib-amd/utils/getNativeElementProps.js

@@ -0,0 +1,64 @@
+define(["require", "exports", "tslib", "./properties"], function (require, exports, tslib_1, properties_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getPartitionedNativeProps = exports.getNativeElementProps = void 0;
+    var nativeElementMap = {
+        label: properties_1.labelProperties,
+        audio: properties_1.audioProperties,
+        video: properties_1.videoProperties,
+        ol: properties_1.olProperties,
+        li: properties_1.liProperties,
+        a: properties_1.anchorProperties,
+        button: properties_1.buttonProperties,
+        input: properties_1.inputProperties,
+        textarea: properties_1.textAreaProperties,
+        select: properties_1.selectProperties,
+        option: properties_1.optionProperties,
+        table: properties_1.tableProperties,
+        tr: properties_1.trProperties,
+        th: properties_1.thProperties,
+        td: properties_1.tdProperties,
+        colGroup: properties_1.colGroupProperties,
+        col: properties_1.colProperties,
+        fieldset: properties_1.fieldsetProperties,
+        form: properties_1.formProperties,
+        iframe: properties_1.iframeProperties,
+        img: properties_1.imgProperties,
+        time: properties_1.timeProperties,
+        dialog: properties_1.dialogProperties,
+    };
+    /**
+     * Given an element tagname and user props, filters the props to only allowed props for the given
+     * element type.
+     * @param tagName - Tag name (e.g. "div")
+     * @param props - Props object
+     * @param excludedPropNames - List of props to disallow
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function getNativeElementProps(tagName, props, excludedPropNames) {
+        var allowedPropNames = (tagName && nativeElementMap[tagName]) || properties_1.htmlElementProperties;
+        allowedPropNames.as = 1;
+        return properties_1.getNativeProps(props, allowedPropNames, excludedPropNames);
+    }
+    exports.getNativeElementProps = getNativeElementProps;
+    /**
+     * Splits the native props into ones that go to the `root` slot, and ones that go to the primary slot.
+     *
+     * This function is only for use with components that have a primary slot other than `root`.
+     * Most components should use {@link getNativeElementProps} for their root slot if it is the primary slot.
+     *
+     * @returns An object containing the native props for the `root` and primary slots.
+     */
+    var getPartitionedNativeProps = function (_a) {
+        var primarySlotTagName = _a.primarySlotTagName, props = _a.props, excludedPropNames = _a.excludedPropNames;
+        return {
+            root: { style: props.style, className: props.className },
+            primary: getNativeElementProps(primarySlotTagName, props, tslib_1.__spreadArray(tslib_1.__spreadArray([], (excludedPropNames || [])), [
+                'style',
+                'className',
+            ])),
+        };
+    };
+    exports.getPartitionedNativeProps = getPartitionedNativeProps;
+});
+//# sourceMappingURL=getNativeElementProps.js.map

package/lib-amd/utils/getNativeElementProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNativeElementProps.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/getNativeElementProps.ts"],"names":[],"mappings":";;;;IA6BA,IAAM,gBAAgB,GAA2C;QAC/D,KAAK,EAAE,4BAAe;QACtB,KAAK,EAAE,4BAAe;QACtB,KAAK,EAAE,4BAAe;QACtB,EAAE,EAAE,yBAAY;QAChB,EAAE,EAAE,yBAAY;QAChB,CAAC,EAAE,6BAAgB;QACnB,MAAM,EAAE,6BAAgB;QACxB,KAAK,EAAE,4BAAe;QACtB,QAAQ,EAAE,+BAAkB;QAC5B,MAAM,EAAE,6BAAgB;QACxB,MAAM,EAAE,6BAAgB;QACxB,KAAK,EAAE,4BAAe;QACtB,EAAE,EAAE,yBAAY;QAChB,EAAE,EAAE,yBAAY;QAChB,EAAE,EAAE,yBAAY;QAChB,QAAQ,EAAE,+BAAkB;QAC5B,GAAG,EAAE,0BAAa;QAClB,QAAQ,EAAE,+BAAkB;QAC5B,IAAI,EAAE,2BAAc;QACpB,MAAM,EAAE,6BAAgB;QACxB,GAAG,EAAE,0BAAa;QAClB,IAAI,EAAE,2BAAc;QACpB,MAAM,EAAE,6BAAgB;KACzB,CAAC;IAEF;;;;;;OAMG;IACH,8DAA8D;IAC9D,SAAgB,qBAAqB,CACnC,OAAe,EACf,KAAS,EACT,iBAA4B;QAE5B,IAAM,gBAAgB,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,kCAAqB,CAAC;QACzF,gBAAgB,CAAC,EAAE,GAAG,CAAC,CAAC;QAExB,OAAO,2BAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IACpE,CAAC;IATD,sDASC;IAED;;;;;;;OAOG;IACI,IAAM,yBAAyB,GAAG,UAGvC,EAaD;YAZC,kBAAkB,wBAAA,EAClB,KAAK,WAAA,EACL,iBAAiB,uBAAA;QAWjB,OAAO;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;YACxD,OAAO,EAAE,qBAAqB,CAAgC,kBAAkB,EAAE,KAAK,kDAClF,CAAC,iBAAiB,IAAI,EAAE,CAAC;gBAC5B,OAAO;gBACP,WAAW;eACX;SACH,CAAC;IACJ,CAAC,CAAC;IAzBW,QAAA,yBAAyB,6BAyBpC","sourcesContent":["import * as React from 'react';\nimport {\n  labelProperties,\n  audioProperties,\n  videoProperties,\n  olProperties,\n  liProperties,\n  anchorProperties,\n  buttonProperties,\n  inputProperties,\n  textAreaProperties,\n  selectProperties,\n  optionProperties,\n  tableProperties,\n  trProperties,\n  thProperties,\n  tdProperties,\n  colGroupProperties,\n  colProperties,\n  fieldsetProperties,\n  formProperties,\n  iframeProperties,\n  imgProperties,\n  htmlElementProperties,\n  getNativeProps,\n  timeProperties,\n  dialogProperties,\n} from './properties';\n\nconst nativeElementMap: Record<string, Record<string, number>> = {\n  label: labelProperties,\n  audio: audioProperties,\n  video: videoProperties,\n  ol: olProperties,\n  li: liProperties,\n  a: anchorProperties,\n  button: buttonProperties,\n  input: inputProperties,\n  textarea: textAreaProperties,\n  select: selectProperties,\n  option: optionProperties,\n  table: tableProperties,\n  tr: trProperties,\n  th: thProperties,\n  td: tdProperties,\n  colGroup: colGroupProperties,\n  col: colProperties,\n  fieldset: fieldsetProperties,\n  form: formProperties,\n  iframe: iframeProperties,\n  img: imgProperties,\n  time: timeProperties,\n  dialog: dialogProperties,\n};\n\n/**\n * Given an element tagname and user props, filters the props to only allowed props for the given\n * element type.\n * @param tagName - Tag name (e.g. \"div\")\n * @param props - Props object\n * @param excludedPropNames - List of props to disallow\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getNativeElementProps<TAttributes extends React.HTMLAttributes<any>>(\n  tagName: string,\n  props: {},\n  excludedPropNames?: string[],\n): TAttributes {\n  const allowedPropNames = (tagName && nativeElementMap[tagName]) || htmlElementProperties;\n  allowedPropNames.as = 1;\n\n  return getNativeProps(props, allowedPropNames, excludedPropNames);\n}\n\n/**\n * Splits the native props into ones that go to the `root` slot, and ones that go to the primary slot.\n *\n * This function is only for use with components that have a primary slot other than `root`.\n * Most components should use {@link getNativeElementProps} for their root slot if it is the primary slot.\n *\n * @returns An object containing the native props for the `root` and primary slots.\n */\nexport const getPartitionedNativeProps = <\n  Props extends Pick<React.HTMLAttributes<HTMLElement>, 'style' | 'className'>,\n  ExcludedPropKeys extends Extract<keyof Props, string> = never\n>({\n  primarySlotTagName,\n  props,\n  excludedPropNames,\n}: {\n  /** The primary slot's element type (e.g. 'div') */\n  primarySlotTagName: keyof JSX.IntrinsicElements;\n\n  /** The component's props object */\n  props: Props;\n\n  /** List of native props to exclude from the returned value */\n  excludedPropNames?: ExcludedPropKeys[];\n}) => {\n  return {\n    root: { style: props.style, className: props.className },\n    primary: getNativeElementProps<Omit<Props, ExcludedPropKeys>>(primarySlotTagName, props, [\n      ...(excludedPropNames || []),\n      'style',\n      'className',\n    ]),\n  };\n};\n"]}

package/lib-amd/utils/getRTLSafeKey.js

@@ -0,0 +1,24 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.getRTLSafeKey = void 0;
+    /**
+     * @internal
+     * Finds and swaps a provided key for it's right to left format.
+     */
+    var getRTLSafeKey = function (key, dir) {
+        if (dir === 'rtl') {
+            switch (key) {
+                case 'ArrowLeft': {
+                    return 'ArrowRight';
+                }
+                case 'ArrowRight': {
+                    return 'ArrowLeft';
+                }
+            }
+        }
+        return key;
+    };
+    exports.getRTLSafeKey = getRTLSafeKey;
+});
+//# sourceMappingURL=getRTLSafeKey.js.map

package/lib-amd/utils/getRTLSafeKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRTLSafeKey.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/getRTLSafeKey.ts"],"names":[],"mappings":";;;;IAAA;;;OAGG;IACI,IAAM,aAAa,GAAG,UAAC,GAAW,EAAE,GAAkB;QAC3D,IAAI,GAAG,KAAK,KAAK,EAAE;YACjB,QAAQ,GAAG,EAAE;gBACX,KAAK,WAAW,CAAC,CAAC;oBAChB,OAAO,YAAY,CAAC;iBACrB;gBAED,KAAK,YAAY,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC;iBACpB;aACF;SACF;QAED,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAdW,QAAA,aAAa,iBAcxB","sourcesContent":["/**\n * @internal\n * Finds and swaps a provided key for it's right to left format.\n */\nexport const getRTLSafeKey = (key: string, dir: 'ltr' | 'rtl') => {\n  if (dir === 'rtl') {\n    switch (key) {\n      case 'ArrowLeft': {\n        return 'ArrowRight';\n      }\n\n      case 'ArrowRight': {\n        return 'ArrowLeft';\n      }\n    }\n  }\n\n  return key;\n};\n"]}

package/lib-amd/utils/index.js

@@ -0,0 +1,12 @@
+define(["require", "exports", "tslib", "./clamp", "./getNativeElementProps", "./getRTLSafeKey", "./mergeCallbacks", "./omit", "./properties", "./shouldPreventDefaultOnKeyDown"], function (require, exports, tslib_1, clamp_1, getNativeElementProps_1, getRTLSafeKey_1, mergeCallbacks_1, omit_1, properties_1, shouldPreventDefaultOnKeyDown_1) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    tslib_1.__exportStar(clamp_1, exports);
+    tslib_1.__exportStar(getNativeElementProps_1, exports);
+    tslib_1.__exportStar(getRTLSafeKey_1, exports);
+    tslib_1.__exportStar(mergeCallbacks_1, exports);
+    tslib_1.__exportStar(omit_1, exports);
+    tslib_1.__exportStar(properties_1, exports);
+    tslib_1.__exportStar(shouldPreventDefaultOnKeyDown_1, exports);
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/index.ts"],"names":[],"mappings":";;;IAAA,uCAAwB;IACxB,uDAAwC;IACxC,+CAAgC;IAChC,gDAAiC;IACjC,sCAAuB;IACvB,4CAA6B;IAC7B,+DAAgD","sourcesContent":["export * from './clamp';\nexport * from './getNativeElementProps';\nexport * from './getRTLSafeKey';\nexport * from './mergeCallbacks';\nexport * from './omit';\nexport * from './properties';\nexport * from './shouldPreventDefaultOnKeyDown';\n"]}

package/lib-amd/utils/mergeCallbacks.js

@@ -0,0 +1,40 @@
+define(["require", "exports"], function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.mergeCallbacks = void 0;
+    /**
+     * @internal
+     * Combine two event callbacks into a single callback function that calls each one in order.
+     *
+     * Usage example:
+     * ```ts
+     * state.slot.onChange = mergeCallbacks(state.slot.onChange, ev => {
+     *   // Handle onChange
+     * });
+     * ```
+     *
+     * The primary use is to avoid the need to capture an existing callback (`state.slot.onChange` in the example) to a
+     * local variable before replacing with a new listener that calls the existing one. This helps avoid bugs like:
+     * * Infinite recursion by calling the re-assigned state.slot.onChange if it's not captured to a local variable.
+     * * Missing a call to the original onChange due to an early return or other conditional.
+     *
+     * If you need a callback that is stable between renders, wrap the result in {@link useEventCallback}.
+     *
+     * @param callback1 - The first callback to be called, or undefined
+     * @param callback2 - The second callback to be called, or undefined
+     *
+     * @returns A function that that calls the provided functions in order
+     */
+    function mergeCallbacks(callback1, callback2) {
+        return function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            callback1 === null || callback1 === void 0 ? void 0 : callback1.apply(void 0, args);
+            callback2 === null || callback2 === void 0 ? void 0 : callback2.apply(void 0, args);
+        };
+    }
+    exports.mergeCallbacks = mergeCallbacks;
+});
+//# sourceMappingURL=mergeCallbacks.js.map

package/lib-amd/utils/mergeCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeCallbacks.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/mergeCallbacks.ts"],"names":[],"mappings":";;;;IAAA;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAgB,cAAc,CAC5B,SAAgD,EAChD,SAAgD;QAEhD,OAAO;YAAC,cAAa;iBAAb,UAAa,EAAb,qBAAa,EAAb,IAAa;gBAAb,yBAAa;;YACnB,SAAS,aAAT,SAAS,uBAAT,SAAS,eAAM,IAAI,CAAC,CAAC;YACrB,SAAS,aAAT,SAAS,uBAAT,SAAS,eAAM,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC;IARD,wCAQC","sourcesContent":["/**\n * @internal\n * Combine two event callbacks into a single callback function that calls each one in order.\n *\n * Usage example:\n * ```ts\n * state.slot.onChange = mergeCallbacks(state.slot.onChange, ev => {\n *   // Handle onChange\n * });\n * ```\n *\n * The primary use is to avoid the need to capture an existing callback (`state.slot.onChange` in the example) to a\n * local variable before replacing with a new listener that calls the existing one. This helps avoid bugs like:\n * * Infinite recursion by calling the re-assigned state.slot.onChange if it's not captured to a local variable.\n * * Missing a call to the original onChange due to an early return or other conditional.\n *\n * If you need a callback that is stable between renders, wrap the result in {@link useEventCallback}.\n *\n * @param callback1 - The first callback to be called, or undefined\n * @param callback2 - The second callback to be called, or undefined\n *\n * @returns A function that that calls the provided functions in order\n */\nexport function mergeCallbacks<Args extends unknown[]>(\n  callback1: ((...args: Args) => void) | undefined,\n  callback2: ((...args: Args) => void) | undefined,\n) {\n  return (...args: Args) => {\n    callback1?.(...args);\n    callback2?.(...args);\n  };\n}\n"]}

package/lib-amd/utils/omit.js

@@ -0,0 +1,31 @@
+define(["require", "exports"], function (require, exports) {
+    "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
+        var result = {};
+        for (var 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-amd/utils/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../../../../../../../../packages/react-components/react-utilities/src/utils/omit.ts"],"names":[],"mappings":";;;;IAAA;;;;;;;;;;;;OAYG;IACH,8DAA8D;IAC9D,SAAgB,IAAI,CAClB,GAAS,EACT,UAAsB;QAEtB,8DAA8D;QAC9D,IAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,KAAK,IAAM,GAAG,IAAI,GAAG,EAAE;YACrB,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;gBAC7D,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;aACxB;SACF;QAED,OAAO,MAAc,CAAC;IACxB,CAAC;IAdD,oBAcC","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"]}