@fluentui/react-utilities 0.0.0-nightly050f89bf0020211102.1

package/lib-commonjs/hooks/useMergedRefs.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+/**
+ * A Ref function which can be treated like a ref object in that it has an attached
+ * current property, which will be updated as the ref is evaluated.
+ */
+export declare type RefObjectFunction<T> = React.RefObject<T> & ((value: T) => void);
+/**
+ * React hook to merge multiple React refs (either MutableRefObjects or ref callbacks) into a single ref callback that
+ * updates all provided refs
+ * @param refs - Refs to collectively update with one ref value.
+ * @returns A function with an attached "current" prop, so that it can be treated like a RefObject.
+ */
+export declare function useMergedRefs<T>(...refs: (React.Ref<T> | undefined)[]): RefObjectFunction<T>;

package/lib-commonjs/hooks/useMergedRefs.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useMergedRefs = void 0;
+
+var tslib_1 = /*#__PURE__*/require("tslib");
+
+var React = /*#__PURE__*/require("react");
+/**
+ * React hook to merge multiple React refs (either MutableRefObjects or ref callbacks) into a single ref callback that
+ * updates all provided refs
+ * @param refs - Refs to collectively update with one ref value.
+ * @returns A function with an attached "current" prop, so that it can be treated like a RefObject.
+ */
+
+
+function useMergedRefs() {
+  var refs = [];
+
+  for (var _i = 0; _i < arguments.length; _i++) {
+    refs[_i] = arguments[_i];
+  }
+
+  var mergedCallback = React.useCallback(function (value) {
+    // Update the "current" prop hanging on the function.
+    mergedCallback.current = value;
+
+    for (var _i = 0, refs_1 = refs; _i < refs_1.length; _i++) {
+      var ref = refs_1[_i];
+
+      if (typeof ref === 'function') {
+        ref(value);
+      } else if (ref) {
+        // work around the immutability of the React.Ref type
+        ref.current = value;
+      }
+    }
+  }, tslib_1.__spreadArrays(refs));
+  return mergedCallback;
+}
+
+exports.useMergedRefs = useMergedRefs;
+//# sourceMappingURL=useMergedRefs.js.map

package/lib-commonjs/hooks/useMergedRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useMergedRefs.ts"],"names":[],"mappings":";;;;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;AAQA;;;;;AAKG;;;AACH,SAAgB,aAAhB,GAA6B;AAAI,MAAA,IAAA,GAAA,EAAA;;OAAA,IAAA,EAAA,GAAA,C,EAAA,EAAA,GAAA,SAAA,CAAA,M,EAAA,EAAA,E,EAAqC;AAArC,IAAA,IAAA,CAAA,EAAA,CAAA,GAAA,SAAA,CAAA,EAAA,CAAA;;;AAC/B,MAAM,cAAc,GAA0B,KAAK,CAAC,WAAN,CAC5C,UAAC,KAAD,EAAS;AACP;AACE,IAAA,cAAwD,CAAC,OAAzD,GAAmE,KAAnE;;AAEF,SAAkB,IAAA,EAAA,GAAA,CAAA,EAAA,MAAA,GAAA,IAAlB,EAAkB,EAAA,GAAA,MAAA,CAAA,MAAlB,EAAkB,EAAA,EAAlB,EAAwB;AAAnB,UAAM,GAAG,GAAA,MAAA,CAAA,EAAA,CAAT;;AACH,UAAI,OAAO,GAAP,KAAe,UAAnB,EAA+B;AAC7B,QAAA,GAAG,CAAC,KAAD,CAAH;AACD,OAFD,MAEO,IAAI,GAAJ,EAAS;AACd;AACE,QAAA,GAA6C,CAAC,OAA9C,GAAwD,KAAxD;AACH;AACF;AACF,GAb2C,EAa3C,OAAA,CAAA,cAAA,CAEG,IAFH,CAb2C,CAA9C;AAkBA,SAAO,cAAP;AACD;;AApBD,OAAA,CAAA,aAAA,GAAA,aAAA","sourceRoot":""}

package/lib-commonjs/hooks/useMount.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hook which asynchronously executes a callback once the component has been mounted.
+ *
+ * @param callback - Function to call before mount.
+ */
+export declare const useMount: (callback: () => void) => void;

package/lib-commonjs/hooks/useMount.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useMount = void 0;
+
+var React = /*#__PURE__*/require("react");
+/**
+ * Hook which asynchronously executes a callback once the component has been mounted.
+ *
+ * @param callback - Function to call before mount.
+ */
+
+
+var useMount = function (callback) {
+  var mountRef = React.useRef(callback);
+  mountRef.current = callback;
+  React.useEffect(function () {
+    var _a;
+
+    (_a = mountRef.current) === null || _a === void 0 ? void 0 : _a.call(mountRef);
+  }, []);
+};
+
+exports.useMount = useMount;
+//# sourceMappingURL=useMount.js.map

package/lib-commonjs/hooks/useMount.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useMount.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;AAEA;;;;AAIG;;;AACI,IAAM,QAAQ,GAAG,UAAC,QAAD,EAAqB;AAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAN,CAAa,QAAb,CAAjB;AACA,EAAA,QAAQ,CAAC,OAAT,GAAmB,QAAnB;AACA,EAAA,KAAK,CAAC,SAAN,CAAgB,YAAA;;;AACd,KAAA,EAAA,GAAA,QAAQ,CAAC,OAAT,MAAgB,IAAhB,IAAgB,EAAA,KAAA,KAAA,CAAhB,GAAgB,KAAA,CAAhB,GAAgB,EAAA,CAAA,IAAA,CAAhB,QAAgB,CAAhB;AACD,GAFD,EAEG,EAFH;AAGD,CANM;;AAAM,OAAA,CAAA,QAAA,GAAQ,QAAR","sourceRoot":""}

package/lib-commonjs/hooks/useOnClickOutside.d.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+export declare type UseOnClickOrScrollOutsideOptions = {
+    /**
+     * The element to listen for the click event
+     */
+    element: Document | undefined;
+    /**
+     * Refs to elements that check if the click is outside
+     */
+    refs: React.MutableRefObject<HTMLElement | undefined | null>[];
+    /**
+     * By default uses element.contains, but custom contain function can be provided
+     * @param parentRef - provided parent ref
+     * @param child - event target element
+     */
+    contains?(parent: HTMLElement | null, child: HTMLElement): boolean;
+    /**
+     * Disables event listeners
+     */
+    disabled?: boolean;
+    /**
+     * Called if the click is outside the element refs
+     */
+    callback: (ev: MouseEvent | TouchEvent) => void;
+};
+/**
+ * Utility to perform checks where a click/touch event was made outside a component
+ */
+export declare const useOnClickOutside: (options: UseOnClickOrScrollOutsideOptions) => void;

package/lib-commonjs/hooks/useOnClickOutside.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useOnClickOutside = void 0;
+
+var React = /*#__PURE__*/require("react");
+
+var useEventCallback_1 = /*#__PURE__*/require("./useEventCallback");
+/**
+ * Utility to perform checks where a click/touch event was made outside a component
+ */
+
+
+var useOnClickOutside = function (options) {
+  var refs = options.refs,
+      callback = options.callback,
+      element = options.element,
+      disabled = options.disabled,
+      containsProp = options.contains;
+  var timeoutId = React.useRef(undefined);
+  useIFrameFocus(!disabled, element, callback);
+  var listener = useEventCallback_1.useEventCallback(function (ev) {
+    var contains = containsProp || function (parent, child) {
+      return !!(parent === null || parent === void 0 ? void 0 : parent.contains(child));
+    };
+
+    var isOutside = refs.every(function (ref) {
+      return !contains(ref.current || null, ev.target);
+    });
+
+    if (isOutside && !disabled) {
+      callback(ev);
+    }
+  });
+  React.useEffect(function () {
+    // Store the current event to avoid triggering handlers immediately
+    // Note this depends on a deprecated but extremely well supported quirk of the web platform
+    // https://github.com/facebook/react/issues/20074
+    var currentEvent = getWindowEvent(window);
+
+    var conditionalHandler = function (event) {
+      // Skip if this event is the same as the one running when we added the handlers
+      if (event === currentEvent) {
+        currentEvent = undefined;
+        return;
+      }
+
+      listener(event);
+    };
+
+    if (!disabled) {
+      // use capture phase because React can update DOM before the event bubbles to the document
+      element === null || element === void 0 ? void 0 : element.addEventListener('click', conditionalHandler, true);
+      element === null || element === void 0 ? void 0 : element.addEventListener('touchstart', conditionalHandler, true);
+      element === null || element === void 0 ? void 0 : element.addEventListener('contextmenu', conditionalHandler, true);
+    } // Garbage collect this event after it's no longer useful to avoid memory leaks
+
+
+    timeoutId.current = window.setTimeout(function () {
+      currentEvent = undefined;
+    }, 1);
+    return function () {
+      element === null || element === void 0 ? void 0 : element.removeEventListener('click', conditionalHandler, true);
+      element === null || element === void 0 ? void 0 : element.removeEventListener('touchstart', conditionalHandler, true);
+      element === null || element === void 0 ? void 0 : element.removeEventListener('contextmenu', conditionalHandler, true);
+      clearTimeout(timeoutId.current);
+      currentEvent = undefined;
+    };
+  }, [listener, element, disabled]);
+};
+
+exports.useOnClickOutside = useOnClickOutside;
+
+var getWindowEvent = function (target) {
+  var _a, _b, _c;
+
+  if (target) {
+    if (typeof target.window === 'object' && target.window === target) {
+      // eslint-disable-next-line deprecation/deprecation
+      return target.event;
+    } // eslint-disable-next-line deprecation/deprecation
+
+
+    return (_c = (_b = (_a = target.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) === null || _b === void 0 ? void 0 : _b.event) !== null && _c !== void 0 ? _c : undefined;
+  }
+
+  return undefined;
+};
+
+var FUI_FRAME_EVENT = 'fuiframefocus';
+/**
+ * Since click events do not propagate past iframes, we use focus to detect if a
+ * click has happened inside an iframe, since the only ways of focusing inside an
+ * iframe are:
+ *   - clicking inside
+ *   - tabbing inside
+ *
+ * Polls the value of `document.activeElement`. If it is an iframe, then dispatch
+ * a custom DOM event. When the custom event is received call the provided callback
+ *
+ * @param enableFrameFocusDispatch - boolean flag to start dispatching events
+ * @param targetDocument - the document to dispatch events and set timeouts
+ * @param pollDuration  - in milliseconds
+ */
+
+var useIFrameFocus = function (enableFrameFocusDispatch, targetDocument, callback, pollDuration) {
+  if (pollDuration === void 0) {
+    pollDuration = 1000;
+  }
+
+  var timeoutRef = React.useRef();
+  var listener = useEventCallback_1.useEventCallback(function (e) {
+    if (callback) {
+      callback(e);
+    }
+  }); // Adds listener to the custom iframe focus event
+
+  React.useEffect(function () {
+    if (enableFrameFocusDispatch) {
+      targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.addEventListener(FUI_FRAME_EVENT, listener, true);
+    }
+
+    return function () {
+      targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.removeEventListener(FUI_FRAME_EVENT, listener, true);
+    };
+  }, [targetDocument, enableFrameFocusDispatch, listener]); // Starts polling for the active element
+
+  React.useEffect(function () {
+    var _a;
+
+    if (enableFrameFocusDispatch) {
+      timeoutRef.current = (_a = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView) === null || _a === void 0 ? void 0 : _a.setInterval(function () {
+        var activeElement = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.activeElement;
+
+        if ((activeElement === null || activeElement === void 0 ? void 0 : activeElement.tagName) === 'IFRAME') {
+          var event_1 = new CustomEvent(FUI_FRAME_EVENT, {
+            bubbles: true
+          });
+          activeElement.dispatchEvent(event_1);
+        }
+      }, pollDuration);
+    }
+
+    return function () {
+      var _a;
+
+      (_a = targetDocument === null || targetDocument === void 0 ? void 0 : targetDocument.defaultView) === null || _a === void 0 ? void 0 : _a.clearTimeout(timeoutRef.current);
+    };
+  }, [targetDocument, enableFrameFocusDispatch, pollDuration]);
+};
+//# sourceMappingURL=useOnClickOutside.js.map

package/lib-commonjs/hooks/useOnClickOutside.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useOnClickOutside.ts"],"names":[],"mappings":"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","sourceRoot":""}

package/lib-commonjs/hooks/useOnScrollOutside.d.ts

@@ -0,0 +1,5 @@
+import type { UseOnClickOrScrollOutsideOptions } from './useOnClickOutside';
+/**
+ * Utility to perform checks where a click/touch event was made outside a component
+ */
+export declare const useOnScrollOutside: (options: UseOnClickOrScrollOutsideOptions) => void;

package/lib-commonjs/hooks/useOnScrollOutside.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useOnScrollOutside = void 0;
+
+var React = /*#__PURE__*/require("react");
+
+var useEventCallback_1 = /*#__PURE__*/require("./useEventCallback");
+/**
+ * Utility to perform checks where a click/touch event was made outside a component
+ */
+
+
+var useOnScrollOutside = function (options) {
+  var refs = options.refs,
+      callback = options.callback,
+      element = options.element,
+      disabled = options.disabled,
+      containsProp = options.contains;
+  var listener = useEventCallback_1.useEventCallback(function (ev) {
+    var contains = containsProp || function (parent, child) {
+      return !!(parent === null || parent === void 0 ? void 0 : parent.contains(child));
+    };
+
+    var isOutside = refs.every(function (ref) {
+      return !contains(ref.current || null, ev.target);
+    });
+
+    if (isOutside && !disabled) {
+      callback(ev);
+    }
+  });
+  React.useEffect(function () {
+    if (!disabled) {
+      element === null || element === void 0 ? void 0 : element.addEventListener('wheel', listener);
+      element === null || element === void 0 ? void 0 : element.addEventListener('touchmove', listener);
+    }
+
+    return function () {
+      element === null || element === void 0 ? void 0 : element.removeEventListener('wheel', listener);
+      element === null || element === void 0 ? void 0 : element.removeEventListener('touchmove', listener);
+    };
+  }, [listener, element, disabled]);
+};
+
+exports.useOnScrollOutside = useOnScrollOutside;
+//# sourceMappingURL=useOnScrollOutside.js.map

package/lib-commonjs/hooks/useOnScrollOutside.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useOnScrollOutside.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,IAAA,kBAAA,gBAAA,OAAA,CAAA,oBAAA,CAAA;AAGA;;AAEG;;;AACI,IAAM,kBAAkB,GAAG,UAAC,OAAD,EAA0C;AAClE,MAAA,IAAI,GAA0D,OAAO,CAAjE,IAAJ;AAAA,MAAM,QAAQ,GAAgD,OAAO,CAAvD,QAAd;AAAA,MAAgB,OAAO,GAAuC,OAAO,CAA9C,OAAvB;AAAA,MAAyB,QAAQ,GAA6B,OAAO,CAApC,QAAjC;AAAA,MAA6C,YAAY,GAAK,OAAO,CAAZ,QAAzD;AAER,MAAM,QAAQ,GAAG,kBAAA,CAAA,gBAAA,CAAiB,UAAC,EAAD,EAA4B;AAC5D,QAAM,QAAQ,GACZ,YAAY,IAAK,UAAC,MAAD,EAAS,KAAT,EAAc;AAAK,aAAA,CAAC,EAAC,MAAM,KAAA,IAAN,IAAA,MAAM,KAAA,KAAA,CAAN,GAAM,KAAA,CAAN,GAAA,MAAM,CAAE,QAAR,CAAF,KAAE,CAAD,CAAD;AAAyB,KAD/D;;AAGA,QAAM,SAAS,GAAG,IAAI,CAAC,KAAL,CAAW,UAAA,GAAA,EAAG;AAAI,aAAA,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAJ,IAAe,IAAhB,EAAsB,EAAE,CAAjC,MAAS,CAAT;AAAwD,KAA1E,CAAlB;;AACA,QAAI,SAAS,IAAI,CAAC,QAAlB,EAA4B;AAC1B,MAAA,QAAQ,CAAC,EAAD,CAAR;AACD;AACF,GARgB,CAAjB;AAUA,EAAA,KAAK,CAAC,SAAN,CAAgB,YAAA;AACd,QAAI,CAAC,QAAL,EAAe;AACb,MAAA,OAAO,KAAA,IAAP,IAAA,OAAO,KAAA,KAAA,CAAP,GAAO,KAAA,CAAP,GAAA,OAAO,CAAE,gBAAT,CAA0B,OAA1B,EAAmC,QAAnC,CAAA;AACA,MAAA,OAAO,KAAA,IAAP,IAAA,OAAO,KAAA,KAAA,CAAP,GAAO,KAAA,CAAP,GAAA,OAAO,CAAE,gBAAT,CAA0B,WAA1B,EAAuC,QAAvC,CAAA;AACD;;AAED,WAAO,YAAA;AACL,MAAA,OAAO,KAAA,IAAP,IAAA,OAAO,KAAA,KAAA,CAAP,GAAO,KAAA,CAAP,GAAA,OAAO,CAAE,mBAAT,CAA6B,OAA7B,EAAsC,QAAtC,CAAA;AACA,MAAA,OAAO,KAAA,IAAP,IAAA,OAAO,KAAA,KAAA,CAAP,GAAO,KAAA,CAAP,GAAA,OAAO,CAAE,mBAAT,CAA6B,WAA7B,EAA0C,QAA1C,CAAA;AACD,KAHD;AAID,GAVD,EAUG,CAAC,QAAD,EAAW,OAAX,EAAoB,QAApB,CAVH;AAWD,CAxBM;;AAAM,OAAA,CAAA,kBAAA,GAAkB,kBAAlB","sourceRoot":""}

package/lib-commonjs/hooks/usePrevious.d.ts

@@ -0,0 +1 @@
+export declare const usePrevious: <ValueType = unknown>(value: ValueType) => ValueType | null;

package/lib-commonjs/hooks/usePrevious.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePrevious = void 0;
+
+var React = /*#__PURE__*/require("react");
+
+var usePrevious = function (value) {
+  var ref = React.useRef(null);
+  React.useEffect(function () {
+    ref.current = value;
+  }, [value]);
+  return ref.current;
+};
+
+exports.usePrevious = usePrevious;
+//# sourceMappingURL=usePrevious.js.map

package/lib-commonjs/hooks/usePrevious.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePrevious.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AAEO,IAAM,WAAW,GAAG,UAAsB,KAAtB,EAAsC;AAC/D,MAAM,GAAG,GAAG,KAAK,CAAC,MAAN,CAA+B,IAA/B,CAAZ;AACA,EAAA,KAAK,CAAC,SAAN,CAAgB,YAAA;AACd,IAAA,GAAG,CAAC,OAAJ,GAAc,KAAd;AACD,GAFD,EAEG,CAAC,KAAD,CAFH;AAGA,SAAO,GAAG,CAAC,OAAX;AACD,CANM;;AAAM,OAAA,CAAA,WAAA,GAAW,WAAX","sourceRoot":""}

package/lib-commonjs/hooks/useTimeout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Helper to manage a browser timeout.
+ * Ensures that the timeout isn't set multiple times at once,
+ * and is cleaned up when the component is unloaded.
+ *
+ * @returns A pair of [setTimeout, clearTimeout] that are stable between renders.
+ */
+export declare function useTimeout(): readonly [(fn: () => void, delay: number) => void, () => void];

package/lib-commonjs/hooks/useTimeout.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useTimeout = void 0;
+
+var React = /*#__PURE__*/require("react");
+
+var useConst_1 = /*#__PURE__*/require("./useConst");
+/**
+ * Helper to manage a browser timeout.
+ * Ensures that the timeout isn't set multiple times at once,
+ * and is cleaned up when the component is unloaded.
+ *
+ * @returns A pair of [setTimeout, clearTimeout] that are stable between renders.
+ */
+
+
+function useTimeout() {
+  var timeout = useConst_1.useConst(function () {
+    return {
+      id: undefined,
+      set: function (fn, delay) {
+        timeout.clear();
+        timeout.id = setTimeout(fn, delay);
+      },
+      clear: function () {
+        if (timeout.id !== undefined) {
+          clearTimeout(timeout.id);
+          timeout.id = undefined;
+        }
+      }
+    };
+  }); // Clean up the timeout when the component is unloaded
+
+  React.useEffect(function () {
+    return timeout.clear;
+  }, [timeout]);
+  return [timeout.set, timeout.clear];
+}
+
+exports.useTimeout = useTimeout;
+//# sourceMappingURL=useTimeout.js.map

package/lib-commonjs/hooks/useTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useTimeout.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,IAAA,UAAA,gBAAA,OAAA,CAAA,YAAA,CAAA;AAEA;;;;;;AAMG;;;AACH,SAAgB,UAAhB,GAA0B;AACxB,MAAM,OAAO,GAAG,UAAA,CAAA,QAAA,CAAS,YAAA;AAAM,WAAC;AAC9B,MAAA,EAAE,EAAE,SAD0B;AAE9B,MAAA,GAAG,EAAE,UAAC,EAAD,EAAiB,KAAjB,EAA8B;AACjC,QAAA,OAAO,CAAC,KAAR;AACA,QAAA,OAAO,CAAC,EAAR,GAAa,UAAU,CAAC,EAAD,EAAK,KAAL,CAAvB;AACD,OAL6B;AAM9B,MAAA,KAAK,EAAE,YAAA;AACL,YAAI,OAAO,CAAC,EAAR,KAAe,SAAnB,EAA8B;AAC5B,UAAA,YAAY,CAAC,OAAO,CAAC,EAAT,CAAZ;AACA,UAAA,OAAO,CAAC,EAAR,GAAa,SAAb;AACD;AACF;AAX6B,KAAD;AAY7B,GAZc,CAAhB,CADwB,CAexB;;AACA,EAAA,KAAK,CAAC,SAAN,CAAgB,YAAA;AAAM,WAAA,OAAO,CAAP,KAAA;AAAa,GAAnC,EAAqC,CAAC,OAAD,CAArC;AAEA,SAAO,CAAC,OAAO,CAAC,GAAT,EAAc,OAAO,CAAC,KAAtB,CAAP;AACD;;AAnBD,OAAA,CAAA,UAAA,GAAA,UAAA","sourceRoot":""}

package/lib-commonjs/hooks/useUnmount.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hook which synchronously executes a callback when the component is about to unmount.
+ *
+ * @param callback - Function to call during unmount.
+ */
+export declare const useUnmount: (callback: () => void) => void;

package/lib-commonjs/hooks/useUnmount.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useUnmount = void 0;
+
+var React = /*#__PURE__*/require("react");
+/**
+ * Hook which synchronously executes a callback when the component is about to unmount.
+ *
+ * @param callback - Function to call during unmount.
+ */
+
+
+var useUnmount = function (callback) {
+  var unmountRef = React.useRef(callback);
+  unmountRef.current = callback;
+  React.useEffect(function () {
+    return function () {
+      var _a;
+
+      (_a = unmountRef.current) === null || _a === void 0 ? void 0 : _a.call(unmountRef);
+    };
+  }, []);
+};
+
+exports.useUnmount = useUnmount;
+//# sourceMappingURL=useUnmount.js.map

package/lib-commonjs/hooks/useUnmount.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useUnmount.ts"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;AAEA;;;;AAIG;;;AACI,IAAM,UAAU,GAAG,UAAC,QAAD,EAAqB;AAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAN,CAAa,QAAb,CAAnB;AACA,EAAA,UAAU,CAAC,OAAX,GAAqB,QAArB;AACA,EAAA,KAAK,CAAC,SAAN,CACE,YAAA;AAAM,WAAA,YAAA;;;AACJ,OAAA,EAAA,GAAA,UAAU,CAAC,OAAX,MAAkB,IAAlB,IAAkB,EAAA,KAAA,KAAA,CAAlB,GAAkB,KAAA,CAAlB,GAAkB,EAAA,CAAA,IAAA,CAAlB,UAAkB,CAAlB;AADI,KAAA;AAEL,GAHH,EAIE,EAJF;AAMD,CATM;;AAAM,OAAA,CAAA,UAAA,GAAU,UAAV","sourceRoot":""}

package/lib-commonjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './compose/index';
+export * from './hooks/index';
+export * from './ssr/index';
+export * from './utils/index';

package/lib-commonjs/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+
+var tslib_1 = /*#__PURE__*/require("tslib");
+
+tslib_1.__exportStar(require("./compose/index"), exports);
+
+tslib_1.__exportStar(require("./hooks/index"), exports);
+
+tslib_1.__exportStar(require("./ssr/index"), exports);
+
+tslib_1.__exportStar(require("./utils/index"), exports);
+//# sourceMappingURL=index.js.map

package/lib-commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,iBAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,eAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,aAAA,CAAA,EAAA,OAAA;;AACA,OAAA,CAAA,YAAA,CAAA,OAAA,CAAA,eAAA,CAAA,EAAA,OAAA","sourceRoot":""}

package/lib-commonjs/ssr/SSRContext.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+/**
+ * To support SSR, the auto incrementing id counter is stored in a context. This allows it to be reset on every request
+ * to ensure the client and server are consistent.
+ *
+ * @internal
+ */
+export declare type SSRContextValue = {
+    current: number;
+};
+/**
+ * Default context value to use in case there is no SSRProvider. This is fine for client-only apps.
+ *
+ * @internal
+ */
+export declare const defaultSSRContextValue: SSRContextValue;
+export declare const SSRContext: React.Context<SSRContextValue>;
+/**
+ * @internal
+ */
+export declare function useSSRContext(): SSRContextValue;
+/**
+ * When using SSR with Fluent UI, applications must be wrapped in an SSRProvider. This ensures that auto generated ids
+ * are consistent between the client and server.
+ *
+ * @public
+ */
+export declare const SSRProvider: React.FC;
+/**
+ * Returns whether the component is currently being server side rendered or hydrated on the client. Can be used to delay
+ * browser-specific rendering until after hydration. May cause re-renders on a client when is used within SSRProvider.
+ */
+export declare function useIsSSR(): boolean;

package/lib-commonjs/ssr/SSRContext.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIsSSR = exports.SSRProvider = exports.useSSRContext = exports.SSRContext = exports.defaultSSRContextValue = void 0;
+
+var React = /*#__PURE__*/require("react");
+
+var canUseDOM_1 = /*#__PURE__*/require("./canUseDOM");
+/**
+ * Default context value to use in case there is no SSRProvider. This is fine for client-only apps.
+ *
+ * @internal
+ */
+
+
+exports.defaultSSRContextValue = {
+  current: 0
+};
+exports.SSRContext = /*#__PURE__*/React.createContext(exports.defaultSSRContextValue);
+/**
+ * @internal
+ */
+
+function useSSRContext() {
+  return React.useContext(exports.SSRContext);
+}
+
+exports.useSSRContext = useSSRContext;
+/**
+ * When using SSR with Fluent UI, applications must be wrapped in an SSRProvider. This ensures that auto generated ids
+ * are consistent between the client and server.
+ *
+ * @public
+ */
+
+var SSRProvider = function (props) {
+  var value = React.useState(function () {
+    return {
+      current: 0
+    };
+  })[0];
+  return React.createElement(exports.SSRContext.Provider, {
+    value: value
+  }, props.children);
+};
+
+exports.SSRProvider = SSRProvider;
+/**
+ * Returns whether the component is currently being server side rendered or hydrated on the client. Can be used to delay
+ * browser-specific rendering until after hydration. May cause re-renders on a client when is used within SSRProvider.
+ */
+
+function useIsSSR() {
+  var isInSSRContext = useSSRContext() !== exports.defaultSSRContextValue;
+
+  var _a = React.useState(isInSSRContext),
+      isSSR = _a[0],
+      setIsSSR = _a[1]; // If we are rendering in a non-DOM environment, and there's no SSRProvider, provide a warning to hint to the
+  // developer to add one.
+
+
+  if (process.env.NODE_ENV !== 'production') {
+    if (!isInSSRContext && !canUseDOM_1.canUseDOM()) {
+      // eslint-disable-next-line no-console
+      console.error('When server rendering, you must wrap your application in an <SSRProvider> to ensure consistent ids are ' + 'generated between the client and server.');
+    }
+  } // If on the client, and the component was initially server rendered, then schedule a layout effect to update the
+  // component after hydration.
+
+
+  if (canUseDOM_1.canUseDOM() && isInSSRContext) {
+    // This if statement technically breaks the rules of hooks, but is safe because the condition never changes after
+    // mounting.
+    // eslint-disable-next-line
+    React.useLayoutEffect(function () {
+      setIsSSR(false);
+    }, []);
+  }
+
+  return isSSR;
+}
+
+exports.useIsSSR = useIsSSR;
+//# sourceMappingURL=SSRContext.js.map

package/lib-commonjs/ssr/SSRContext.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ssr/SSRContext.tsx"],"names":[],"mappings":";;;;;;;AAAA,IAAA,KAAA,gBAAA,OAAA,CAAA,OAAA,CAAA;;AACA,IAAA,WAAA,gBAAA,OAAA,CAAA,aAAA,CAAA;AAYA;;;;AAIG;;;AACU,OAAA,CAAA,sBAAA,GAA0C;AACrD,EAAA,OAAO,EAAE;AAD4C,CAA1C;AAIA,OAAA,CAAA,UAAA,gBAAa,KAAK,CAAC,aAAN,CAAqC,OAAA,CAAA,sBAArC,CAAb;AAEb;;AAEG;;AACH,SAAgB,aAAhB,GAA6B;AAC3B,SAAO,KAAK,CAAC,UAAN,CAAiB,OAAA,CAAA,UAAjB,CAAP;AACD;;AAFD,OAAA,CAAA,aAAA,GAAA,aAAA;AAIA;;;;;AAKG;;AACI,IAAM,WAAW,GAAa,UAAA,KAAA,EAAK;AACjC,MAAA,KAAK,GAAI,KAAK,CAAC,QAAN,CAAgC,YAAA;AAAM,WAAC;AAAE,MAAA,OAAO,EAAV;AAAC,KAAD;AAAgB,GAAtD,EAAJ,CAAI,CAAT;AAEP,SAAO,KAAA,CAAA,aAAA,CAAC,OAAA,CAAA,UAAA,CAAW,QAAZ,EAAoB;AAAC,IAAA,KAAK,EAAE;AAAR,GAApB,EAAoC,KAAK,CAAC,QAA1C,CAAP;AACD,CAJM;;AAAM,OAAA,CAAA,WAAA,GAAW,WAAX;AAMb;;;AAGG;;AACH,SAAgB,QAAhB,GAAwB;AACtB,MAAM,cAAc,GAAG,aAAa,OAAO,OAAA,CAAA,sBAA3C;;AACM,MAAA,EAAA,GAAoB,KAAK,CAAC,QAAN,CAAe,cAAf,CAApB;AAAA,MAAC,KAAK,GAAA,EAAA,CAAA,CAAA,CAAN;AAAA,MAAQ,QAAQ,GAAA,EAAA,CAAA,CAAA,CAAhB,CAFgB,CAItB;AACA;;;AACA,MAAI,OAAO,CAAC,GAAR,CAAY,QAAZ,KAAyB,YAA7B,EAA2C;AACzC,QAAI,CAAC,cAAD,IAAmB,CAAC,WAAA,CAAA,SAAA,EAAxB,EAAqC;AACnC;AACA,MAAA,OAAO,CAAC,KAAR,CACE,4GACE,0CAFJ;AAID;AACF,GAdqB,CAgBtB;AACA;;;AACA,MAAI,WAAA,CAAA,SAAA,MAAe,cAAnB,EAAmC;AACjC;AACA;AACA;AACA,IAAA,KAAK,CAAC,eAAN,CAAsB,YAAA;AACpB,MAAA,QAAQ,CAAC,KAAD,CAAR;AACD,KAFD,EAEG,EAFH;AAGD;;AAED,SAAO,KAAP;AACD;;AA5BD,OAAA,CAAA,QAAA,GAAA,QAAA","sourceRoot":""}

package/lib-commonjs/ssr/canUseDOM.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Verifies if an application can use DOM.
+ */
+export declare function canUseDOM(): boolean;