@elliemae/ds-utilities 3.0.0-next.76 → 3.0.0-next.79

package/dist/cjs/hooks/index.js

@@ -21,6 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var hooks_exports = {};
 __export(hooks_exports, {
   UseFocusTrapWithSchema: () => import_useFocusTrap.UseFocusTrapWithSchema,
+  UseOnBlurOutWithSchema: () => import_useOnBlurOut.UseOnBlurOutWithSchema,
+  UseOnFirstFocusInWithSchema: () => import_useOnFirstFocusIn.UseOnFirstFocusInWithSchema,
+  UseOnSpecificFocusWithSchema: () => import_useOnSpecificFocus.UseOnSpecificFocusWithSchema,
   useCallbackAfterRender: () => import_useCallbackAfterRender.useCallbackAfterRender,
   useCancellableDelayedCallback: () => import_useCancellableDelayedCallback.useCancellableDelayedCallback,
   useDerivedStateFromProps: () => import_useDerivedStateFromProps.useDerivedStateFromProps,
@@ -33,8 +36,11 @@ __export(hooks_exports, {
   useIsMobile: () => import_useIsMobile.useIsMobile,
   useIsShowingEllipsis: () => import_useIsShowingEllipsis.useIsShowingEllipsis,
   useMeasure: () => import_use_measure.default,
+  useOnBlurOut: () => import_useOnBlurOut.useOnBlurOut,
   useOnClickOutside: () => import_use_onclickoutside.default,
   useOnElementResize: () => import_useOnElementResize.useOnElementResize,
+  useOnFirstFocusIn: () => import_useOnFirstFocusIn.useOnFirstFocusIn,
+  useOnSpecificFocus: () => import_useOnSpecificFocus.useOnSpecificFocus,
   usePrevious: () => import_usePrevious.usePrevious,
   useResizeObserver: () => import_useResizeObserver.useResizeObserver,
   useShouldRecalculate: () => import_useShouldRecalculate.useShouldRecalculate,
@@ -45,19 +51,22 @@ var React = __toESM(require("react"));
 var import_use_measure = __toESM(require("use-measure"));
 var import_use_force_update = __toESM(require("use-force-update"));
 var import_use_onclickoutside = __toESM(require("use-onclickoutside"));
+var import_useCallbackAfterRender = require("./useCallbackAfterRender");
+var import_useCancellableDelayedCallback = require("./useCancellableDelayedCallback");
+var import_useDerivedStateFromProps = require("./useDerivedStateFromProps");
 var import_useExecutionTimer = require("./useExecutionTimer");
 var import_useExpandState = require("./useExpandState");
+var import_useFocusTrap = require("./useFocusTrap");
 var import_useHotkeys = require("./useHotkeys");
 var import_useHoverHandlersDelay = require("./useHoverHandlersDelay");
+var import_useIsMobile = require("./useIsMobile");
+var import_useIsShowingEllipsis = require("./useIsShowingEllipsis");
+var import_useOnBlurOut = require("./useOnBlurOut");
+var import_useOnElementResize = require("./useOnElementResize");
+var import_useOnFirstFocusIn = require("./useOnFirstFocusIn");
+var import_useOnSpecificFocus = require("./useOnSpecificFocus");
+var import_usePrevious = require("./usePrevious");
 var import_useResizeObserver = require("./useResizeObserver");
 var import_useShouldRecalculate = require("./useShouldRecalculate");
 var import_useWindowScrollerList = require("./useWindowScrollerList");
-var import_usePrevious = require("./usePrevious");
-var import_useCancellableDelayedCallback = require("./useCancellableDelayedCallback");
-var import_useDerivedStateFromProps = require("./useDerivedStateFromProps");
-var import_useOnElementResize = require("./useOnElementResize");
-var import_useIsShowingEllipsis = require("./useIsShowingEllipsis");
-var import_useCallbackAfterRender = require("./useCallbackAfterRender");
-var import_useFocusTrap = require("./useFocusTrap");
-var import_useIsMobile = require("./useIsMobile");
 //# sourceMappingURL=index.js.map

package/dist/cjs/hooks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/hooks/index.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["export { default as useMeasure } from 'use-measure';\nexport { default as useForceUpdate } from 'use-force-update';\nexport { default as useOnClickOutside } from 'use-onclickoutside';\nexport { useExecutionTimer } from './useExecutionTimer';\nexport { useExpandState } from './useExpandState';\nexport { useHotkeys } from './useHotkeys';\nexport { useHoverHandlersDelay } from './useHoverHandlersDelay';\nexport { useResizeObserver } from './useResizeObserver';\nexport { useShouldRecalculate } from './useShouldRecalculate';\nexport { useWindowScrollerList } from './useWindowScrollerList';\nexport { usePrevious } from './usePrevious';\nexport { useCancellableDelayedCallback } from './useCancellableDelayedCallback';\nexport { useDerivedStateFromProps } from './useDerivedStateFromProps';\nexport { useOnElementResize } from './useOnElementResize';\nexport { useIsShowingEllipsis } from './useIsShowingEllipsis';\nexport { useCallbackAfterRender } from './useCallbackAfterRender';\nexport { useFocusTrap, UseFocusTrapWithSchema } from './useFocusTrap';\nexport { useIsMobile } from './useIsMobile';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,yBAAsC;AACtC,8BAA0C;AAC1C,gCAA6C;AAC7C,+BAAkC;AAClC,4BAA+B;AAC/B,wBAA2B;AAC3B,mCAAsC;AACtC,+BAAkC;AAClC,kCAAqC;AACrC,mCAAsC;AACtC,yBAA4B;AAC5B,2CAA8C;AAC9C,sCAAyC;AACzC,gCAAmC;AACnC,kCAAqC;AACrC,oCAAuC;AACvC,0BAAqD;AACrD,yBAA4B;",
+  "sourcesContent": ["export { default as useMeasure } from 'use-measure';\nexport { default as useForceUpdate } from 'use-force-update';\nexport { default as useOnClickOutside } from 'use-onclickoutside';\n\nexport { useCallbackAfterRender } from './useCallbackAfterRender';\nexport { useCancellableDelayedCallback } from './useCancellableDelayedCallback';\nexport { useDerivedStateFromProps } from './useDerivedStateFromProps';\nexport { useExecutionTimer } from './useExecutionTimer';\nexport { useExpandState } from './useExpandState';\nexport { useFocusTrap, UseFocusTrapWithSchema } from './useFocusTrap';\nexport { useHotkeys } from './useHotkeys';\nexport { useHoverHandlersDelay } from './useHoverHandlersDelay';\nexport { useIsMobile } from './useIsMobile';\nexport { useIsShowingEllipsis } from './useIsShowingEllipsis';\nexport { useOnBlurOut, UseOnBlurOutWithSchema } from './useOnBlurOut';\nexport { useOnElementResize } from './useOnElementResize';\nexport { useOnFirstFocusIn, UseOnFirstFocusInWithSchema } from './useOnFirstFocusIn';\nexport { useOnSpecificFocus, UseOnSpecificFocusWithSchema } from './useOnSpecificFocus';\nexport { usePrevious } from './usePrevious';\nexport { useResizeObserver } from './useResizeObserver';\nexport { useShouldRecalculate } from './useShouldRecalculate';\nexport { useWindowScrollerList } from './useWindowScrollerList';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,yBAAsC;AACtC,8BAA0C;AAC1C,gCAA6C;AAE7C,oCAAuC;AACvC,2CAA8C;AAC9C,sCAAyC;AACzC,+BAAkC;AAClC,4BAA+B;AAC/B,0BAAqD;AACrD,wBAA2B;AAC3B,mCAAsC;AACtC,yBAA4B;AAC5B,kCAAqC;AACrC,0BAAqD;AACrD,gCAAmC;AACnC,+BAA+D;AAC/D,gCAAiE;AACjE,yBAA4B;AAC5B,+BAAkC;AAClC,kCAAqC;AACrC,mCAAsC;",
   "names": []
 }

package/dist/cjs/hooks/useOnBlurOut.js

@@ -0,0 +1,43 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useOnBlurOut_exports = {};
+__export(useOnBlurOut_exports, {
+  UseOnBlurOutWithSchema: () => UseOnBlurOutWithSchema,
+  useOnBlurOut: () => useOnBlurOut
+});
+module.exports = __toCommonJS(useOnBlurOut_exports);
+var React = __toESM(require("react"));
+var import_react = require("react");
+var import_props_helpers = require("../props-helpers");
+const propTypes = {
+  onBlur: import_props_helpers.PropTypes.func.description("The function to be invoked when focus exits the wrapping container").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired
+};
+const useOnBlurOut = ({ onBlur }) => (0, import_react.useCallback)((e, ...args) => {
+  const { currentTarget } = e;
+  requestAnimationFrame(() => {
+    if (!currentTarget.contains(document.activeElement)) {
+      onBlur(e, ...args);
+    }
+  });
+}, [onBlur]);
+const UseOnBlurOutWithSchema = (0, import_props_helpers.describe)(useOnBlurOut);
+UseOnBlurOutWithSchema.propTypes = propTypes;
+//# sourceMappingURL=useOnBlurOut.js.map

package/dist/cjs/hooks/useOnBlurOut.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useOnBlurOut.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import React, { useCallback, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onBlur: PropTypes.func\n    .description('The function to be invoked when focus exits the wrapping container')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n} as WeakValidationMap<unknown>;\n\ntype OnBlurCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseOnBlurOut = ({ onBlur }: { onBlur: OnBlurCb }) => OnBlurCb;\nconst useOnBlurOut: UseOnBlurOut = ({ onBlur }) =>\n  useCallback<OnBlurCb>(\n    (e, ...args) => {\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        // Check if the new focused element is a child of the original container\n        if (!currentTarget.contains(document.activeElement)) {\n          onBlur(e, ...args);\n        }\n      });\n    },\n    [onBlur],\n  );\n\nconst UseOnBlurOutWithSchema = describe(useOnBlurOut);\nUseOnBlurOutWithSchema.propTypes = propTypes;\n\nexport { useOnBlurOut, UseOnBlurOutWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAsD;AACtD,2BAAoC;AAEpC,MAAM,YAAY;AAAA,EAChB,QAAQ,+BAAU,KACf,YAAY,oEAAoE,EAChF,UAAU,qDAAqD,EAAE;AACtE;AAIA,MAAM,eAA6B,CAAC,EAAE,aACpC,8BACE,CAAC,MAAM,SAAS;AACd,QAAM,EAAE,kBAAkB;AAE1B,wBAAsB,MAAM;AAE1B,QAAI,CAAC,cAAc,SAAS,SAAS,aAAa,GAAG;AACnD,aAAO,GAAG,GAAG,IAAI;AAAA,IACnB;AAAA,EACF,CAAC;AACH,GACA,CAAC,MAAM,CACT;AAEF,MAAM,yBAAyB,mCAAS,YAAY;AACpD,uBAAuB,YAAY;",
+  "names": []
+}

package/dist/cjs/hooks/useOnFirstFocusIn.js

@@ -0,0 +1,61 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useOnFirstFocusIn_exports = {};
+__export(useOnFirstFocusIn_exports, {
+  UseOnFirstFocusInWithSchema: () => UseOnFirstFocusInWithSchema,
+  useOnFirstFocusIn: () => useOnFirstFocusIn
+});
+module.exports = __toCommonJS(useOnFirstFocusIn_exports);
+var React = __toESM(require("react"));
+var import_react = require("react");
+var import_props_helpers = require("../props-helpers");
+const propTypes = {
+  onFirstFocusCb: import_props_helpers.PropTypes.func.description("The function to be invoked when focus enters the wrapping container for the first time").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired,
+  onBlurCb: import_props_helpers.PropTypes.func.description("Optional onBlur function to be invoked along the returned onBlur handler").signature("((e: React.FocusEvent, ...args: unknown[]) => void)")
+};
+const useOnFirstFocusIn = ({ onFirstFocus, onBlur }) => {
+  const mutableDidChildBlur = (0, import_react.useRef)(false);
+  const onFirstFocusHelper = (0, import_react.useCallback)((e, ...args) => {
+    const { currentTarget } = e;
+    requestAnimationFrame(() => {
+      const isChildFocus = currentTarget.contains(document.activeElement);
+      const isFirstFocus = isChildFocus && !mutableDidChildBlur.current;
+      if (isFirstFocus) {
+        onFirstFocus(e, ...args);
+      }
+    });
+  }, [onFirstFocus]);
+  const onBlurHelper = (0, import_react.useCallback)((e, ...args) => {
+    onBlur?.(e, ...args);
+    const { currentTarget } = e;
+    requestAnimationFrame(() => {
+      const isChildBlur = currentTarget.contains(document.activeElement);
+      mutableDidChildBlur.current = isChildBlur;
+    });
+  }, [onBlur]);
+  return (0, import_react.useMemo)(() => ({
+    onFirstFocus: onFirstFocusHelper,
+    onBlur: onBlurHelper
+  }), [onFirstFocusHelper, onBlurHelper]);
+};
+const UseOnFirstFocusInWithSchema = (0, import_props_helpers.describe)(useOnFirstFocusIn);
+UseOnFirstFocusInWithSchema.propTypes = propTypes;
+//# sourceMappingURL=useOnFirstFocusIn.js.map

package/dist/cjs/hooks/useOnFirstFocusIn.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useOnFirstFocusIn.ts", "../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import React, { useCallback, useMemo, useRef, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onFirstFocusCb: PropTypes.func\n    .description('The function to be invoked when focus enters the wrapping container for the first time')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n  onBlurCb: PropTypes.func\n    .description('Optional onBlur function to be invoked along the returned onBlur handler')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)'),\n} as WeakValidationMap<unknown>;\n\ntype OnBlurCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype OnFirstFocusCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseFirstFocusIn = ({ onFirstFocus, onBlur }: { onFirstFocus: OnFirstFocusCb; onBlur: OnBlurCb }) => {\n  onFirstFocus: OnFirstFocusCb;\n  onBlur: OnBlurCb;\n};\n\nconst useOnFirstFocusIn: UseFirstFocusIn = ({ onFirstFocus, onBlur }) => {\n  const mutableDidChildBlur = useRef(false);\n  const onFirstFocusHelper = useCallback<OnFirstFocusCb>(\n    (e, ...args) => {\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        const isChildFocus = currentTarget.contains(document.activeElement);\n        const isFirstFocus = isChildFocus && !mutableDidChildBlur.current;\n        if (isFirstFocus) {\n          onFirstFocus(e, ...args);\n        }\n      });\n    },\n    [onFirstFocus],\n  );\n  const onBlurHelper = useCallback<OnBlurCb>(\n    (e, ...args) => {\n      onBlur?.(e, ...args);\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        const isChildBlur = currentTarget.contains(document.activeElement);\n        mutableDidChildBlur.current = isChildBlur;\n      });\n    },\n    [onBlur],\n  );\n  return useMemo(\n    () => ({\n      onFirstFocus: onFirstFocusHelper,\n      onBlur: onBlurHelper,\n    }),\n    [onFirstFocusHelper, onBlurHelper],\n  );\n};\n\nconst UseOnFirstFocusInWithSchema = describe(useOnFirstFocusIn);\nUseOnFirstFocusInWithSchema.propTypes = propTypes;\n\nexport { useOnFirstFocusIn, UseOnFirstFocusInWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAuE;AACvE,2BAAoC;AAEpC,MAAM,YAAY;AAAA,EAChB,gBAAgB,+BAAU,KACvB,YAAY,wFAAwF,EACpG,UAAU,qDAAqD,EAAE;AAAA,EACpE,UAAU,+BAAU,KACjB,YAAY,0EAA0E,EACtF,UAAU,qDAAqD;AACpE;AASA,MAAM,oBAAqC,CAAC,EAAE,cAAc,aAAa;AACvE,QAAM,sBAAsB,yBAAO,KAAK;AACxC,QAAM,qBAAqB,8BACzB,CAAC,MAAM,SAAS;AACd,UAAM,EAAE,kBAAkB;AAE1B,0BAAsB,MAAM;AAC1B,YAAM,eAAe,cAAc,SAAS,SAAS,aAAa;AAClE,YAAM,eAAe,gBAAgB,CAAC,oBAAoB;AAC1D,UAAI,cAAc;AAChB,qBAAa,GAAG,GAAG,IAAI;AAAA,MACzB;AAAA,IACF,CAAC;AAAA,EACH,GACA,CAAC,YAAY,CACf;AACA,QAAM,eAAe,8BACnB,CAAC,MAAM,SAAS;AACd,aAAS,GAAG,GAAG,IAAI;AACnB,UAAM,EAAE,kBAAkB;AAE1B,0BAAsB,MAAM;AAC1B,YAAM,cAAc,cAAc,SAAS,SAAS,aAAa;AACjE,0BAAoB,UAAU;AAAA,IAChC,CAAC;AAAA,EACH,GACA,CAAC,MAAM,CACT;AACA,SAAO,0BACL,MAAO;AAAA,IACL,cAAc;AAAA,IACd,QAAQ;AAAA,EACV,IACA,CAAC,oBAAoB,YAAY,CACnC;AACF;AAEA,MAAM,8BAA8B,mCAAS,iBAAiB;AAC9D,4BAA4B,YAAY;",
+  "names": []
+}

package/dist/cjs/hooks/useOnSpecificFocus.js

@@ -0,0 +1,40 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useOnSpecificFocus_exports = {};
+__export(useOnSpecificFocus_exports, {
+  UseOnSpecificFocusWithSchema: () => UseOnSpecificFocusWithSchema,
+  useOnSpecificFocus: () => useOnSpecificFocus
+});
+module.exports = __toCommonJS(useOnSpecificFocus_exports);
+var React = __toESM(require("react"));
+var import_react = require("react");
+var import_props_helpers = require("../props-helpers");
+const propTypes = {
+  onFocus: import_props_helpers.PropTypes.func.description("The function to be invoked when focusing specifically the element attached to (ignoring child focus events)").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired
+};
+const useOnSpecificFocus = ({ onFocus }) => (0, import_react.useCallback)((e, ...args) => {
+  const { currentTarget, target } = e;
+  if (currentTarget === target && document.activeElement === currentTarget)
+    onFocus(e, ...args);
+}, [onFocus]);
+const UseOnSpecificFocusWithSchema = (0, import_props_helpers.describe)(useOnSpecificFocus);
+UseOnSpecificFocusWithSchema.propTypes = propTypes;
+//# sourceMappingURL=useOnSpecificFocus.js.map

package/dist/cjs/hooks/useOnSpecificFocus.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useOnSpecificFocus.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import React, { useCallback, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onFocus: PropTypes.func\n    .description(\n      'The function to be invoked when focusing specifically the element attached to (ignoring child focus events)',\n    )\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n} as WeakValidationMap<unknown>;\n\ntype OnFocusCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseOnBlurOut = ({ onFocus }: { onFocus: OnFocusCb }) => OnFocusCb;\nconst useOnSpecificFocus: UseOnBlurOut = ({ onFocus }) =>\n  useCallback<OnFocusCb>(\n    (e, ...args) => {\n      const { currentTarget, target } = e;\n      if (currentTarget === target && document.activeElement === currentTarget) onFocus(e, ...args);\n    },\n    [onFocus],\n  );\nconst UseOnSpecificFocusWithSchema = describe(useOnSpecificFocus);\nUseOnSpecificFocusWithSchema.propTypes = propTypes;\n\nexport { useOnSpecificFocus, UseOnSpecificFocusWithSchema };\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAsD;AACtD,2BAAoC;AAEpC,MAAM,YAAY;AAAA,EAChB,SAAS,+BAAU,KAChB,YACC,6GACF,EACC,UAAU,qDAAqD,EAAE;AACtE;AAIA,MAAM,qBAAmC,CAAC,EAAE,cAC1C,8BACE,CAAC,MAAM,SAAS;AACd,QAAM,EAAE,eAAe,WAAW;AAClC,MAAI,kBAAkB,UAAU,SAAS,kBAAkB;AAAe,YAAQ,GAAG,GAAG,IAAI;AAC9F,GACA,CAAC,OAAO,CACV;AACF,MAAM,+BAA+B,mCAAS,kBAAkB;AAChE,6BAA6B,YAAY;",
+  "names": []
+}

package/dist/cjs/index.js

@@ -23,6 +23,9 @@ var src_exports = {};
 __export(src_exports, {
   DOCUMENT: () => import_platform.DOCUMENT,
   UseFocusTrapWithSchema: () => import_hooks.UseFocusTrapWithSchema,
+  UseOnBlurOutWithSchema: () => import_hooks.UseOnBlurOutWithSchema,
+  UseOnFirstFocusInWithSchema: () => import_hooks.UseOnFirstFocusInWithSchema,
+  UseOnSpecificFocusWithSchema: () => import_hooks.UseOnSpecificFocusWithSchema,
   WINDOW: () => import_platform.WINDOW,
   addLeadingZeros: () => import_timeUtils.addLeadingZeros,
   addOrRemove: () => import_utils.addOrRemove,
@@ -109,8 +112,11 @@ __export(src_exports, {
   useIsMobile: () => import_hooks.useIsMobile,
   useIsShowingEllipsis: () => import_hooks.useIsShowingEllipsis,
   useMeasure: () => import_hooks.useMeasure,
+  useOnBlurOut: () => import_hooks.useOnBlurOut,
   useOnClickOutside: () => import_hooks.useOnClickOutside,
   useOnElementResize: () => import_hooks.useOnElementResize,
+  useOnFirstFocusIn: () => import_hooks.useOnFirstFocusIn,
+  useOnSpecificFocus: () => import_hooks.useOnSpecificFocus,
   usePrevious: () => import_hooks.usePrevious,
   useResizeObserver: () => import_hooks.useResizeObserver,
   useShouldRecalculate: () => import_hooks.useShouldRecalculate,

package/dist/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.tsx", "../../../../scripts/build/transpile/react-shim.js"],
-  "sourcesContent": ["export { default as getComponentFromProps } from './getComponentFromProps';\nexport { default as onClickHandlerForNonInteractiveElements } from './onClickHandlerForNonInteractiveElements';\nexport { capitalize } from './capitalize';\nexport { getObjectValuesToArray, getObjectKeysToArray } from './objectUtilities';\nexport {\n  checkNotEmpty,\n  checkEmpty,\n  greaterThan,\n  validDate,\n  equal,\n  notEqual,\n  isNull,\n  isNotNull,\n  isIn,\n  isNotIn,\n  greaterThanOrEquals,\n  lessThanOrEquals,\n  startsWith,\n  contains,\n} from './operators';\nexport {\n  cx,\n  runAll,\n  hashArray,\n  safeCall,\n  removeUndefinedProperties,\n  isObject,\n  curry,\n  arrayMove,\n  uniq,\n  filter,\n  uniqBy,\n  groupBy,\n  property,\n  get,\n  set,\n  cloneDeep,\n  debounce,\n  findIndex,\n  isEmpty,\n  isString,\n  isEqual,\n  maxBy,\n  meanBy,\n  noop,\n  omit,\n  orderBy,\n  pull,\n  sortBy,\n  sumBy,\n  transform,\n  isFunction,\n  range,\n  parseInt,\n  padStart,\n  isNaN,\n  values,\n  throttle,\n  toggleInObject,\n  toggleInArray,\n  pick,\n  pickBy,\n  differenceBy,\n  differenceWith,\n  addOrRemove,\n  isEqualWith,\n  isBoolean,\n} from './utils';\nexport { setRef, mergeRefs, logger } from './system';\nexport {\n  useMeasure,\n  useForceUpdate,\n  useOnClickOutside,\n  useExecutionTimer,\n  useExpandState,\n  useHotkeys,\n  useHoverHandlersDelay,\n  useResizeObserver,\n  useShouldRecalculate,\n  useWindowScrollerList,\n  usePrevious,\n  useCancellableDelayedCallback,\n  useDerivedStateFromProps,\n  useOnElementResize,\n  useIsShowingEllipsis,\n  useCallbackAfterRender,\n  useFocusTrap,\n  UseFocusTrapWithSchema,\n  useIsMobile,\n} from './hooks';\nexport { getVisibleTimeByFormat, addLeadingZeros } from './timeUtils';\nexport { compose } from './compose';\nexport { DOCUMENT, WINDOW } from './platform';\nexport { isDOMTypeElement } from './reactTypesUtility';\nexport { isRequired, isGreaterThan, isValidDate } from './validations';\n\n// TODO -- REMOVE WHEN READY\nexport * from './deprecated';\nexport * from './props-helpers';\n", "import * as React from 'react';\nexport { React };\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mCAAiD;AACjD,qDAAmE;AACnE,wBAA2B;AAC3B,6BAA6D;AAC7D,uBAeO;AACP,mBA+CO;AACP,oBAA0C;AAC1C,mBAoBO;AACP,uBAAwD;AACxD,qBAAwB;AACxB,sBAAiC;AACjC,+BAAiC;AACjC,yBAAuD;AAGvD,wBAAc,yBAjGd;AAkGA,wBAAc,4BAlGd;",
+  "sourcesContent": ["export { default as getComponentFromProps } from './getComponentFromProps';\nexport { default as onClickHandlerForNonInteractiveElements } from './onClickHandlerForNonInteractiveElements';\nexport { capitalize } from './capitalize';\nexport { getObjectValuesToArray, getObjectKeysToArray } from './objectUtilities';\nexport {\n  checkNotEmpty,\n  checkEmpty,\n  greaterThan,\n  validDate,\n  equal,\n  notEqual,\n  isNull,\n  isNotNull,\n  isIn,\n  isNotIn,\n  greaterThanOrEquals,\n  lessThanOrEquals,\n  startsWith,\n  contains,\n} from './operators';\nexport {\n  cx,\n  runAll,\n  hashArray,\n  safeCall,\n  removeUndefinedProperties,\n  isObject,\n  curry,\n  arrayMove,\n  uniq,\n  filter,\n  uniqBy,\n  groupBy,\n  property,\n  get,\n  set,\n  cloneDeep,\n  debounce,\n  findIndex,\n  isEmpty,\n  isString,\n  isEqual,\n  maxBy,\n  meanBy,\n  noop,\n  omit,\n  orderBy,\n  pull,\n  sortBy,\n  sumBy,\n  transform,\n  isFunction,\n  range,\n  parseInt,\n  padStart,\n  isNaN,\n  values,\n  throttle,\n  toggleInObject,\n  toggleInArray,\n  pick,\n  pickBy,\n  differenceBy,\n  differenceWith,\n  addOrRemove,\n  isEqualWith,\n  isBoolean,\n} from './utils';\nexport { setRef, mergeRefs, logger } from './system';\nexport {\n  useMeasure,\n  useForceUpdate,\n  useOnClickOutside,\n  useExecutionTimer,\n  useExpandState,\n  useHotkeys,\n  useHoverHandlersDelay,\n  useResizeObserver,\n  useShouldRecalculate,\n  useWindowScrollerList,\n  usePrevious,\n  useCancellableDelayedCallback,\n  useDerivedStateFromProps,\n  useOnElementResize,\n  useIsShowingEllipsis,\n  useCallbackAfterRender,\n  useFocusTrap,\n  UseFocusTrapWithSchema,\n  useIsMobile,\n  useOnBlurOut,\n  UseOnBlurOutWithSchema,\n  useOnFirstFocusIn,\n  UseOnFirstFocusInWithSchema,\n  useOnSpecificFocus,\n  UseOnSpecificFocusWithSchema,\n} from './hooks';\nexport { getVisibleTimeByFormat, addLeadingZeros } from './timeUtils';\nexport { compose } from './compose';\nexport { DOCUMENT, WINDOW } from './platform';\nexport { isDOMTypeElement } from './reactTypesUtility';\nexport { isRequired, isGreaterThan, isValidDate } from './validations';\n\n// TODO -- REMOVE WHEN READY\nexport * from './deprecated';\nexport * from './props-helpers';\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mCAAiD;AACjD,qDAAmE;AACnE,wBAA2B;AAC3B,6BAA6D;AAC7D,uBAeO;AACP,mBA+CO;AACP,oBAA0C;AAC1C,mBA0BO;AACP,uBAAwD;AACxD,qBAAwB;AACxB,sBAAiC;AACjC,+BAAiC;AACjC,yBAAuD;AAGvD,wBAAc,yBAvGd;AAwGA,wBAAc,4BAxGd;",
   "names": []
 }

package/dist/esm/hooks/index.js

@@ -2,23 +2,29 @@ import * as React from "react";
 import { default as default2 } from "use-measure";
 import { default as default3 } from "use-force-update";
 import { default as default4 } from "use-onclickoutside";
+import { useCallbackAfterRender } from "./useCallbackAfterRender";
+import { useCancellableDelayedCallback } from "./useCancellableDelayedCallback";
+import { useDerivedStateFromProps } from "./useDerivedStateFromProps";
 import { useExecutionTimer } from "./useExecutionTimer";
 import { useExpandState } from "./useExpandState";
+import { useFocusTrap, UseFocusTrapWithSchema } from "./useFocusTrap";
 import { useHotkeys } from "./useHotkeys";
 import { useHoverHandlersDelay } from "./useHoverHandlersDelay";
+import { useIsMobile } from "./useIsMobile";
+import { useIsShowingEllipsis } from "./useIsShowingEllipsis";
+import { useOnBlurOut, UseOnBlurOutWithSchema } from "./useOnBlurOut";
+import { useOnElementResize } from "./useOnElementResize";
+import { useOnFirstFocusIn, UseOnFirstFocusInWithSchema } from "./useOnFirstFocusIn";
+import { useOnSpecificFocus, UseOnSpecificFocusWithSchema } from "./useOnSpecificFocus";
+import { usePrevious } from "./usePrevious";
 import { useResizeObserver } from "./useResizeObserver";
 import { useShouldRecalculate } from "./useShouldRecalculate";
 import { useWindowScrollerList } from "./useWindowScrollerList";
-import { usePrevious } from "./usePrevious";
-import { useCancellableDelayedCallback } from "./useCancellableDelayedCallback";
-import { useDerivedStateFromProps } from "./useDerivedStateFromProps";
-import { useOnElementResize } from "./useOnElementResize";
-import { useIsShowingEllipsis } from "./useIsShowingEllipsis";
-import { useCallbackAfterRender } from "./useCallbackAfterRender";
-import { useFocusTrap, UseFocusTrapWithSchema } from "./useFocusTrap";
-import { useIsMobile } from "./useIsMobile";
 export {
   UseFocusTrapWithSchema,
+  UseOnBlurOutWithSchema,
+  UseOnFirstFocusInWithSchema,
+  UseOnSpecificFocusWithSchema,
   useCallbackAfterRender,
   useCancellableDelayedCallback,
   useDerivedStateFromProps,
@@ -31,8 +37,11 @@ export {
   useIsMobile,
   useIsShowingEllipsis,
   default2 as useMeasure,
+  useOnBlurOut,
   default4 as useOnClickOutside,
   useOnElementResize,
+  useOnFirstFocusIn,
+  useOnSpecificFocus,
   usePrevious,
   useResizeObserver,
   useShouldRecalculate,

package/dist/esm/hooks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { default as useMeasure } from 'use-measure';\nexport { default as useForceUpdate } from 'use-force-update';\nexport { default as useOnClickOutside } from 'use-onclickoutside';\nexport { useExecutionTimer } from './useExecutionTimer';\nexport { useExpandState } from './useExpandState';\nexport { useHotkeys } from './useHotkeys';\nexport { useHoverHandlersDelay } from './useHoverHandlersDelay';\nexport { useResizeObserver } from './useResizeObserver';\nexport { useShouldRecalculate } from './useShouldRecalculate';\nexport { useWindowScrollerList } from './useWindowScrollerList';\nexport { usePrevious } from './usePrevious';\nexport { useCancellableDelayedCallback } from './useCancellableDelayedCallback';\nexport { useDerivedStateFromProps } from './useDerivedStateFromProps';\nexport { useOnElementResize } from './useOnElementResize';\nexport { useIsShowingEllipsis } from './useIsShowingEllipsis';\nexport { useCallbackAfterRender } from './useCallbackAfterRender';\nexport { useFocusTrap, UseFocusTrapWithSchema } from './useFocusTrap';\nexport { useIsMobile } from './useIsMobile';\n"],
-  "mappings": "AAAA;ACAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { default as useMeasure } from 'use-measure';\nexport { default as useForceUpdate } from 'use-force-update';\nexport { default as useOnClickOutside } from 'use-onclickoutside';\n\nexport { useCallbackAfterRender } from './useCallbackAfterRender';\nexport { useCancellableDelayedCallback } from './useCancellableDelayedCallback';\nexport { useDerivedStateFromProps } from './useDerivedStateFromProps';\nexport { useExecutionTimer } from './useExecutionTimer';\nexport { useExpandState } from './useExpandState';\nexport { useFocusTrap, UseFocusTrapWithSchema } from './useFocusTrap';\nexport { useHotkeys } from './useHotkeys';\nexport { useHoverHandlersDelay } from './useHoverHandlersDelay';\nexport { useIsMobile } from './useIsMobile';\nexport { useIsShowingEllipsis } from './useIsShowingEllipsis';\nexport { useOnBlurOut, UseOnBlurOutWithSchema } from './useOnBlurOut';\nexport { useOnElementResize } from './useOnElementResize';\nexport { useOnFirstFocusIn, UseOnFirstFocusInWithSchema } from './useOnFirstFocusIn';\nexport { useOnSpecificFocus, UseOnSpecificFocusWithSchema } from './useOnSpecificFocus';\nexport { usePrevious } from './usePrevious';\nexport { useResizeObserver } from './useResizeObserver';\nexport { useShouldRecalculate } from './useShouldRecalculate';\nexport { useWindowScrollerList } from './useWindowScrollerList';\n"],
+  "mappings": "AAAA;ACAA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;",
   "names": []
 }

package/dist/esm/hooks/useOnBlurOut.js

@@ -0,0 +1,21 @@
+import * as React from "react";
+import { useCallback } from "react";
+import { describe, PropTypes } from "../props-helpers";
+const propTypes = {
+  onBlur: PropTypes.func.description("The function to be invoked when focus exits the wrapping container").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired
+};
+const useOnBlurOut = ({ onBlur }) => useCallback((e, ...args) => {
+  const { currentTarget } = e;
+  requestAnimationFrame(() => {
+    if (!currentTarget.contains(document.activeElement)) {
+      onBlur(e, ...args);
+    }
+  });
+}, [onBlur]);
+const UseOnBlurOutWithSchema = describe(useOnBlurOut);
+UseOnBlurOutWithSchema.propTypes = propTypes;
+export {
+  UseOnBlurOutWithSchema,
+  useOnBlurOut
+};
+//# sourceMappingURL=useOnBlurOut.js.map

package/dist/esm/hooks/useOnBlurOut.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useOnBlurOut.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useCallback, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onBlur: PropTypes.func\n    .description('The function to be invoked when focus exits the wrapping container')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n} as WeakValidationMap<unknown>;\n\ntype OnBlurCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseOnBlurOut = ({ onBlur }: { onBlur: OnBlurCb }) => OnBlurCb;\nconst useOnBlurOut: UseOnBlurOut = ({ onBlur }) =>\n  useCallback<OnBlurCb>(\n    (e, ...args) => {\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        // Check if the new focused element is a child of the original container\n        if (!currentTarget.contains(document.activeElement)) {\n          onBlur(e, ...args);\n        }\n      });\n    },\n    [onBlur],\n  );\n\nconst UseOnBlurOutWithSchema = describe(useOnBlurOut);\nUseOnBlurOutWithSchema.propTypes = propTypes;\n\nexport { useOnBlurOut, UseOnBlurOutWithSchema };\n"],
+  "mappings": "AAAA;ACAA;AACA;AAEA,MAAM,YAAY;AAAA,EAChB,QAAQ,UAAU,KACf,YAAY,oEAAoE,EAChF,UAAU,qDAAqD,EAAE;AACtE;AAIA,MAAM,eAA6B,CAAC,EAAE,aACpC,YACE,CAAC,MAAM,SAAS;AACd,QAAM,EAAE,kBAAkB;AAE1B,wBAAsB,MAAM;AAE1B,QAAI,CAAC,cAAc,SAAS,SAAS,aAAa,GAAG;AACnD,aAAO,GAAG,GAAG,IAAI;AAAA,IACnB;AAAA,EACF,CAAC;AACH,GACA,CAAC,MAAM,CACT;AAEF,MAAM,yBAAyB,SAAS,YAAY;AACpD,uBAAuB,YAAY;",
+  "names": []
+}

package/dist/esm/hooks/useOnFirstFocusIn.js

@@ -0,0 +1,39 @@
+import * as React from "react";
+import { useCallback, useMemo, useRef } from "react";
+import { describe, PropTypes } from "../props-helpers";
+const propTypes = {
+  onFirstFocusCb: PropTypes.func.description("The function to be invoked when focus enters the wrapping container for the first time").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired,
+  onBlurCb: PropTypes.func.description("Optional onBlur function to be invoked along the returned onBlur handler").signature("((e: React.FocusEvent, ...args: unknown[]) => void)")
+};
+const useOnFirstFocusIn = ({ onFirstFocus, onBlur }) => {
+  const mutableDidChildBlur = useRef(false);
+  const onFirstFocusHelper = useCallback((e, ...args) => {
+    const { currentTarget } = e;
+    requestAnimationFrame(() => {
+      const isChildFocus = currentTarget.contains(document.activeElement);
+      const isFirstFocus = isChildFocus && !mutableDidChildBlur.current;
+      if (isFirstFocus) {
+        onFirstFocus(e, ...args);
+      }
+    });
+  }, [onFirstFocus]);
+  const onBlurHelper = useCallback((e, ...args) => {
+    onBlur?.(e, ...args);
+    const { currentTarget } = e;
+    requestAnimationFrame(() => {
+      const isChildBlur = currentTarget.contains(document.activeElement);
+      mutableDidChildBlur.current = isChildBlur;
+    });
+  }, [onBlur]);
+  return useMemo(() => ({
+    onFirstFocus: onFirstFocusHelper,
+    onBlur: onBlurHelper
+  }), [onFirstFocusHelper, onBlurHelper]);
+};
+const UseOnFirstFocusInWithSchema = describe(useOnFirstFocusIn);
+UseOnFirstFocusInWithSchema.propTypes = propTypes;
+export {
+  UseOnFirstFocusInWithSchema,
+  useOnFirstFocusIn
+};
+//# sourceMappingURL=useOnFirstFocusIn.js.map

package/dist/esm/hooks/useOnFirstFocusIn.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useOnFirstFocusIn.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useCallback, useMemo, useRef, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onFirstFocusCb: PropTypes.func\n    .description('The function to be invoked when focus enters the wrapping container for the first time')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n  onBlurCb: PropTypes.func\n    .description('Optional onBlur function to be invoked along the returned onBlur handler')\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)'),\n} as WeakValidationMap<unknown>;\n\ntype OnBlurCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype OnFirstFocusCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseFirstFocusIn = ({ onFirstFocus, onBlur }: { onFirstFocus: OnFirstFocusCb; onBlur: OnBlurCb }) => {\n  onFirstFocus: OnFirstFocusCb;\n  onBlur: OnBlurCb;\n};\n\nconst useOnFirstFocusIn: UseFirstFocusIn = ({ onFirstFocus, onBlur }) => {\n  const mutableDidChildBlur = useRef(false);\n  const onFirstFocusHelper = useCallback<OnFirstFocusCb>(\n    (e, ...args) => {\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        const isChildFocus = currentTarget.contains(document.activeElement);\n        const isFirstFocus = isChildFocus && !mutableDidChildBlur.current;\n        if (isFirstFocus) {\n          onFirstFocus(e, ...args);\n        }\n      });\n    },\n    [onFirstFocus],\n  );\n  const onBlurHelper = useCallback<OnBlurCb>(\n    (e, ...args) => {\n      onBlur?.(e, ...args);\n      const { currentTarget } = e;\n      // Give browser time to focus the next element\n      requestAnimationFrame(() => {\n        const isChildBlur = currentTarget.contains(document.activeElement);\n        mutableDidChildBlur.current = isChildBlur;\n      });\n    },\n    [onBlur],\n  );\n  return useMemo(\n    () => ({\n      onFirstFocus: onFirstFocusHelper,\n      onBlur: onBlurHelper,\n    }),\n    [onFirstFocusHelper, onBlurHelper],\n  );\n};\n\nconst UseOnFirstFocusInWithSchema = describe(useOnFirstFocusIn);\nUseOnFirstFocusInWithSchema.propTypes = propTypes;\n\nexport { useOnFirstFocusIn, UseOnFirstFocusInWithSchema };\n"],
+  "mappings": "AAAA;ACAA;AACA;AAEA,MAAM,YAAY;AAAA,EAChB,gBAAgB,UAAU,KACvB,YAAY,wFAAwF,EACpG,UAAU,qDAAqD,EAAE;AAAA,EACpE,UAAU,UAAU,KACjB,YAAY,0EAA0E,EACtF,UAAU,qDAAqD;AACpE;AASA,MAAM,oBAAqC,CAAC,EAAE,cAAc,aAAa;AACvE,QAAM,sBAAsB,OAAO,KAAK;AACxC,QAAM,qBAAqB,YACzB,CAAC,MAAM,SAAS;AACd,UAAM,EAAE,kBAAkB;AAE1B,0BAAsB,MAAM;AAC1B,YAAM,eAAe,cAAc,SAAS,SAAS,aAAa;AAClE,YAAM,eAAe,gBAAgB,CAAC,oBAAoB;AAC1D,UAAI,cAAc;AAChB,qBAAa,GAAG,GAAG,IAAI;AAAA,MACzB;AAAA,IACF,CAAC;AAAA,EACH,GACA,CAAC,YAAY,CACf;AACA,QAAM,eAAe,YACnB,CAAC,MAAM,SAAS;AACd,aAAS,GAAG,GAAG,IAAI;AACnB,UAAM,EAAE,kBAAkB;AAE1B,0BAAsB,MAAM;AAC1B,YAAM,cAAc,cAAc,SAAS,SAAS,aAAa;AACjE,0BAAoB,UAAU;AAAA,IAChC,CAAC;AAAA,EACH,GACA,CAAC,MAAM,CACT;AACA,SAAO,QACL,MAAO;AAAA,IACL,cAAc;AAAA,IACd,QAAQ;AAAA,EACV,IACA,CAAC,oBAAoB,YAAY,CACnC;AACF;AAEA,MAAM,8BAA8B,SAAS,iBAAiB;AAC9D,4BAA4B,YAAY;",
+  "names": []
+}

package/dist/esm/hooks/useOnSpecificFocus.js

@@ -0,0 +1,18 @@
+import * as React from "react";
+import { useCallback } from "react";
+import { describe, PropTypes } from "../props-helpers";
+const propTypes = {
+  onFocus: PropTypes.func.description("The function to be invoked when focusing specifically the element attached to (ignoring child focus events)").signature("((e: React.FocusEvent, ...args: unknown[]) => void)").isRequired
+};
+const useOnSpecificFocus = ({ onFocus }) => useCallback((e, ...args) => {
+  const { currentTarget, target } = e;
+  if (currentTarget === target && document.activeElement === currentTarget)
+    onFocus(e, ...args);
+}, [onFocus]);
+const UseOnSpecificFocusWithSchema = describe(useOnSpecificFocus);
+UseOnSpecificFocusWithSchema.propTypes = propTypes;
+export {
+  UseOnSpecificFocusWithSchema,
+  useOnSpecificFocus
+};
+//# sourceMappingURL=useOnSpecificFocus.js.map

package/dist/esm/hooks/useOnSpecificFocus.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useOnSpecificFocus.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import React, { useCallback, WeakValidationMap } from 'react';\nimport { describe, PropTypes } from '../props-helpers';\n\nconst propTypes = {\n  onFocus: PropTypes.func\n    .description(\n      'The function to be invoked when focusing specifically the element attached to (ignoring child focus events)',\n    )\n    .signature('((e: React.FocusEvent, ...args: unknown[]) => void)').isRequired,\n} as WeakValidationMap<unknown>;\n\ntype OnFocusCb = (e: React.FocusEvent, ...args: unknown[]) => void;\ntype UseOnBlurOut = ({ onFocus }: { onFocus: OnFocusCb }) => OnFocusCb;\nconst useOnSpecificFocus: UseOnBlurOut = ({ onFocus }) =>\n  useCallback<OnFocusCb>(\n    (e, ...args) => {\n      const { currentTarget, target } = e;\n      if (currentTarget === target && document.activeElement === currentTarget) onFocus(e, ...args);\n    },\n    [onFocus],\n  );\nconst UseOnSpecificFocusWithSchema = describe(useOnSpecificFocus);\nUseOnSpecificFocusWithSchema.propTypes = propTypes;\n\nexport { useOnSpecificFocus, UseOnSpecificFocusWithSchema };\n"],
+  "mappings": "AAAA;ACAA;AACA;AAEA,MAAM,YAAY;AAAA,EAChB,SAAS,UAAU,KAChB,YACC,6GACF,EACC,UAAU,qDAAqD,EAAE;AACtE;AAIA,MAAM,qBAAmC,CAAC,EAAE,cAC1C,YACE,CAAC,MAAM,SAAS;AACd,QAAM,EAAE,eAAe,WAAW;AAClC,MAAI,kBAAkB,UAAU,SAAS,kBAAkB;AAAe,YAAQ,GAAG,GAAG,IAAI;AAC9F,GACA,CAAC,OAAO,CACV;AACF,MAAM,+BAA+B,SAAS,kBAAkB;AAChE,6BAA6B,YAAY;",
+  "names": []
+}

package/dist/esm/index.js

@@ -87,7 +87,13 @@ import {
   useCallbackAfterRender,
   useFocusTrap,
   UseFocusTrapWithSchema,
-  useIsMobile
+  useIsMobile,
+  useOnBlurOut,
+  UseOnBlurOutWithSchema,
+  useOnFirstFocusIn,
+  UseOnFirstFocusInWithSchema,
+  useOnSpecificFocus,
+  UseOnSpecificFocusWithSchema
 } from "./hooks";
 import { getVisibleTimeByFormat, addLeadingZeros } from "./timeUtils";
 import { compose } from "./compose";
@@ -99,6 +105,9 @@ export * from "./props-helpers";
 export {
   DOCUMENT,
   UseFocusTrapWithSchema,
+  UseOnBlurOutWithSchema,
+  UseOnFirstFocusInWithSchema,
+  UseOnSpecificFocusWithSchema,
   WINDOW,
   addLeadingZeros,
   addOrRemove,
@@ -185,8 +194,11 @@ export {
   useIsMobile,
   useIsShowingEllipsis,
   useMeasure,
+  useOnBlurOut,
   useOnClickOutside,
   useOnElementResize,
+  useOnFirstFocusIn,
+  useOnSpecificFocus,
   usePrevious,
   useResizeObserver,
   useShouldRecalculate,

package/dist/esm/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../scripts/build/transpile/react-shim.js", "../../src/index.tsx"],
-  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { default as getComponentFromProps } from './getComponentFromProps';\nexport { default as onClickHandlerForNonInteractiveElements } from './onClickHandlerForNonInteractiveElements';\nexport { capitalize } from './capitalize';\nexport { getObjectValuesToArray, getObjectKeysToArray } from './objectUtilities';\nexport {\n  checkNotEmpty,\n  checkEmpty,\n  greaterThan,\n  validDate,\n  equal,\n  notEqual,\n  isNull,\n  isNotNull,\n  isIn,\n  isNotIn,\n  greaterThanOrEquals,\n  lessThanOrEquals,\n  startsWith,\n  contains,\n} from './operators';\nexport {\n  cx,\n  runAll,\n  hashArray,\n  safeCall,\n  removeUndefinedProperties,\n  isObject,\n  curry,\n  arrayMove,\n  uniq,\n  filter,\n  uniqBy,\n  groupBy,\n  property,\n  get,\n  set,\n  cloneDeep,\n  debounce,\n  findIndex,\n  isEmpty,\n  isString,\n  isEqual,\n  maxBy,\n  meanBy,\n  noop,\n  omit,\n  orderBy,\n  pull,\n  sortBy,\n  sumBy,\n  transform,\n  isFunction,\n  range,\n  parseInt,\n  padStart,\n  isNaN,\n  values,\n  throttle,\n  toggleInObject,\n  toggleInArray,\n  pick,\n  pickBy,\n  differenceBy,\n  differenceWith,\n  addOrRemove,\n  isEqualWith,\n  isBoolean,\n} from './utils';\nexport { setRef, mergeRefs, logger } from './system';\nexport {\n  useMeasure,\n  useForceUpdate,\n  useOnClickOutside,\n  useExecutionTimer,\n  useExpandState,\n  useHotkeys,\n  useHoverHandlersDelay,\n  useResizeObserver,\n  useShouldRecalculate,\n  useWindowScrollerList,\n  usePrevious,\n  useCancellableDelayedCallback,\n  useDerivedStateFromProps,\n  useOnElementResize,\n  useIsShowingEllipsis,\n  useCallbackAfterRender,\n  useFocusTrap,\n  UseFocusTrapWithSchema,\n  useIsMobile,\n} from './hooks';\nexport { getVisibleTimeByFormat, addLeadingZeros } from './timeUtils';\nexport { compose } from './compose';\nexport { DOCUMENT, WINDOW } from './platform';\nexport { isDOMTypeElement } from './reactTypesUtility';\nexport { isRequired, isGreaterThan, isValidDate } from './validations';\n\n// TODO -- REMOVE WHEN READY\nexport * from './deprecated';\nexport * from './props-helpers';\n"],
-  "mappings": "AAAA;ACAA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgDA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBA;AACA;AACA;AACA;AACA;AAGA;AACA;",
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "export { default as getComponentFromProps } from './getComponentFromProps';\nexport { default as onClickHandlerForNonInteractiveElements } from './onClickHandlerForNonInteractiveElements';\nexport { capitalize } from './capitalize';\nexport { getObjectValuesToArray, getObjectKeysToArray } from './objectUtilities';\nexport {\n  checkNotEmpty,\n  checkEmpty,\n  greaterThan,\n  validDate,\n  equal,\n  notEqual,\n  isNull,\n  isNotNull,\n  isIn,\n  isNotIn,\n  greaterThanOrEquals,\n  lessThanOrEquals,\n  startsWith,\n  contains,\n} from './operators';\nexport {\n  cx,\n  runAll,\n  hashArray,\n  safeCall,\n  removeUndefinedProperties,\n  isObject,\n  curry,\n  arrayMove,\n  uniq,\n  filter,\n  uniqBy,\n  groupBy,\n  property,\n  get,\n  set,\n  cloneDeep,\n  debounce,\n  findIndex,\n  isEmpty,\n  isString,\n  isEqual,\n  maxBy,\n  meanBy,\n  noop,\n  omit,\n  orderBy,\n  pull,\n  sortBy,\n  sumBy,\n  transform,\n  isFunction,\n  range,\n  parseInt,\n  padStart,\n  isNaN,\n  values,\n  throttle,\n  toggleInObject,\n  toggleInArray,\n  pick,\n  pickBy,\n  differenceBy,\n  differenceWith,\n  addOrRemove,\n  isEqualWith,\n  isBoolean,\n} from './utils';\nexport { setRef, mergeRefs, logger } from './system';\nexport {\n  useMeasure,\n  useForceUpdate,\n  useOnClickOutside,\n  useExecutionTimer,\n  useExpandState,\n  useHotkeys,\n  useHoverHandlersDelay,\n  useResizeObserver,\n  useShouldRecalculate,\n  useWindowScrollerList,\n  usePrevious,\n  useCancellableDelayedCallback,\n  useDerivedStateFromProps,\n  useOnElementResize,\n  useIsShowingEllipsis,\n  useCallbackAfterRender,\n  useFocusTrap,\n  UseFocusTrapWithSchema,\n  useIsMobile,\n  useOnBlurOut,\n  UseOnBlurOutWithSchema,\n  useOnFirstFocusIn,\n  UseOnFirstFocusInWithSchema,\n  useOnSpecificFocus,\n  UseOnSpecificFocusWithSchema,\n} from './hooks';\nexport { getVisibleTimeByFormat, addLeadingZeros } from './timeUtils';\nexport { compose } from './compose';\nexport { DOCUMENT, WINDOW } from './platform';\nexport { isDOMTypeElement } from './reactTypesUtility';\nexport { isRequired, isGreaterThan, isValidDate } from './validations';\n\n// TODO -- REMOVE WHEN READY\nexport * from './deprecated';\nexport * from './props-helpers';\n"],
+  "mappings": "AAAA;ACAA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgDA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA;AACA;AACA;AACA;AACA;AAGA;AACA;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-utilities",
-  "version": "3.0.0-next.76",
+  "version": "3.0.0-next.79",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Utilities",
   "files": [