@elliemae/ds-utilities 3.11.0 → 3.11.1-rc.1

package/dist/cjs/algorithms/crossTypeSort.js

@@ -0,0 +1,85 @@
+"use strict";
+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 crossTypeSort_exports = {};
+__export(crossTypeSort_exports, {
+  crossTypeSort: () => crossTypeSort
+});
+module.exports = __toCommonJS(crossTypeSort_exports);
+var React = __toESM(require("react"));
+const canBeParsedAsNumber = (val) => !Number.isNaN(parseFloat(val));
+const numberSort = (a, b, direction = "ASC") => {
+  if (canBeParsedAsNumber(a) && canBeParsedAsNumber(b)) {
+    const aAsNum = parseFloat(a);
+    const bAsNum = parseFloat(b);
+    if (direction === "ASC")
+      return aAsNum - bAsNum;
+    else
+      return bAsNum - aAsNum;
+  }
+  if (canBeParsedAsNumber(a))
+    return direction === "ASC" ? -1 : 1;
+  if (canBeParsedAsNumber(b))
+    return direction === "ASC" ? 1 : -1;
+  return false;
+};
+const voidishSort = (a, b) => {
+  if (a === void 0)
+    return 1;
+  if (b === void 0)
+    return -1;
+  if (a === null)
+    return 1;
+  if (b === null)
+    return -1;
+  if (a === "")
+    return 1;
+  if (b === "")
+    return -1;
+  if (a === "-")
+    return 1;
+  if (b === "-")
+    return -1;
+  return false;
+};
+const stringSort = (a, b, direction = "ASC") => {
+  if (typeof a === "string" && typeof b === "string")
+    return direction === "ASC" ? a.localeCompare(b, void 0, { numeric: true }) : b.localeCompare(a, void 0, { numeric: true });
+  return false;
+};
+const crossTypeSort = (a, b, direction = "ASC") => {
+  if (a === b)
+    return 0;
+  const voidishSorted = voidishSort(a, b, direction);
+  if (voidishSorted !== false)
+    return voidishSorted;
+  const numberSorted = numberSort(a, b, direction);
+  if (numberSorted !== false)
+    return numberSorted;
+  const stringSorted = stringSort(a, b, direction);
+  if (stringSorted !== false)
+    return stringSorted;
+  return -1;
+};
+//# sourceMappingURL=crossTypeSort.js.map

package/dist/cjs/algorithms/crossTypeSort.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/algorithms/crossTypeSort.ts", "../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["type ComparisonTerm = string | number | null | undefined;\ntype Direction = 'ASC' | 'DESC';\ntype SortCB = Required<Parameters<typeof Array.prototype['sort']>>[0];\ntype SortingHelper = (a: ComparisonTerm, b: ComparisonTerm, direction?: Direction) => ReturnType<SortCB> | false;\n\nconst canBeParsedAsNumber = (val: ComparisonTerm): val is string => !Number.isNaN(parseFloat(val as string));\n\nconst numberSort: SortingHelper = (a, b, direction = 'ASC') => {\n  if (canBeParsedAsNumber(a) && canBeParsedAsNumber(b)) {\n    const aAsNum = parseFloat(a);\n    const bAsNum = parseFloat(b);\n    if (direction === 'ASC') return aAsNum - bAsNum;\n    else return bAsNum - aAsNum;\n  }\n  if (canBeParsedAsNumber(a)) return direction === 'ASC' ? -1 : 1;\n  if (canBeParsedAsNumber(b)) return direction === 'ASC' ? 1 : -1;\n  return false;\n};\nconst voidishSort: SortingHelper = (a, b) => {\n  // voids are always sorted the same way no matter the direction since it's more ux intuitive\n  // order of execution matters, this ensure the order '-' , '', null, undefined\n  if (a === undefined) return 1;\n  if (b === undefined) return -1;\n  if (a === null) return 1;\n  if (b === null) return -1;\n  if (a === '') return 1;\n  if (b === '') return -1;\n  if (a === '-') return 1;\n  if (b === '-') return -1;\n  return false;\n};\nconst stringSort: SortingHelper = (a, b, direction = 'ASC') => {\n  if (typeof a === 'string' && typeof b === 'string')\n    return direction === 'ASC'\n      ? a.localeCompare(b, undefined, { numeric: true })\n      : b.localeCompare(a, undefined, { numeric: true });\n  return false;\n};\n\nexport const crossTypeSort = (\n  a: ComparisonTerm,\n  b: ComparisonTerm,\n  direction: Direction = 'ASC',\n): ReturnType<SortCB> => {\n  if (a === b) return 0;\n  const voidishSorted = voidishSort(a, b, direction);\n  if (voidishSorted !== false) return voidishSorted;\n\n  const numberSorted = numberSort(a, b, direction);\n  if (numberSorted !== false) return numberSorted;\n\n  const stringSorted = stringSort(a, b, direction);\n  if (stringSorted !== false) return stringSorted;\n  return -1;\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADKvB,MAAM,sBAAsB,CAAC,QAAuC,CAAC,OAAO,MAAM,WAAW,GAAa,CAAC;AAE3G,MAAM,aAA4B,CAAC,GAAG,GAAG,YAAY,UAAU;AAC7D,MAAI,oBAAoB,CAAC,KAAK,oBAAoB,CAAC,GAAG;AACpD,UAAM,SAAS,WAAW,CAAC;AAC3B,UAAM,SAAS,WAAW,CAAC;AAC3B,QAAI,cAAc;AAAO,aAAO,SAAS;AAAA;AACpC,aAAO,SAAS;AAAA,EACvB;AACA,MAAI,oBAAoB,CAAC;AAAG,WAAO,cAAc,QAAQ,KAAK;AAC9D,MAAI,oBAAoB,CAAC;AAAG,WAAO,cAAc,QAAQ,IAAI;AAC7D,SAAO;AACT;AACA,MAAM,cAA6B,CAAC,GAAG,MAAM;AAG3C,MAAI,MAAM;AAAW,WAAO;AAC5B,MAAI,MAAM;AAAW,WAAO;AAC5B,MAAI,MAAM;AAAM,WAAO;AACvB,MAAI,MAAM;AAAM,WAAO;AACvB,MAAI,MAAM;AAAI,WAAO;AACrB,MAAI,MAAM;AAAI,WAAO;AACrB,MAAI,MAAM;AAAK,WAAO;AACtB,MAAI,MAAM;AAAK,WAAO;AACtB,SAAO;AACT;AACA,MAAM,aAA4B,CAAC,GAAG,GAAG,YAAY,UAAU;AAC7D,MAAI,OAAO,MAAM,YAAY,OAAO,MAAM;AACxC,WAAO,cAAc,QACjB,EAAE,cAAc,GAAG,QAAW,EAAE,SAAS,KAAK,CAAC,IAC/C,EAAE,cAAc,GAAG,QAAW,EAAE,SAAS,KAAK,CAAC;AACrD,SAAO;AACT;AAEO,MAAM,gBAAgB,CAC3B,GACA,GACA,YAAuB,UACA;AACvB,MAAI,MAAM;AAAG,WAAO;AACpB,QAAM,gBAAgB,YAAY,GAAG,GAAG,SAAS;AACjD,MAAI,kBAAkB;AAAO,WAAO;AAEpC,QAAM,eAAe,WAAW,GAAG,GAAG,SAAS;AAC/C,MAAI,iBAAiB;AAAO,WAAO;AAEnC,QAAM,eAAe,WAAW,GAAG,GAAG,SAAS;AAC/C,MAAI,iBAAiB;AAAO,WAAO;AACnC,SAAO;AACT;",
+  "names": []
+}

package/dist/cjs/hooks/useDimensions.js

@@ -0,0 +1,45 @@
+"use strict";
+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 useDimensions_exports = {};
+__export(useDimensions_exports, {
+  useDimensions: () => useDimensions
+});
+module.exports = __toCommonJS(useDimensions_exports);
+var React = __toESM(require("react"));
+var import_react = require("react");
+var import_resize_observer_polyfill = __toESM(require("resize-observer-polyfill"));
+const useDimensions = (domNode) => {
+  const [dimensions, setDimensions] = (0, import_react.useState)();
+  (0, import_react.useEffect)(() => {
+    const resizeObserver = new import_resize_observer_polyfill.default(([entry]) => setDimensions(entry.contentRect));
+    if (domNode) {
+      resizeObserver.observe(domNode);
+      return () => resizeObserver.unobserve(domNode);
+    }
+    return void 0;
+  }, [domNode]);
+  return dimensions;
+};
+//# sourceMappingURL=useDimensions.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/hooks/useDimensions.tsx", "../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { useEffect, useState } from 'react';\nimport ResizeObserver from 'resize-observer-polyfill';\n\nexport const useDimensions = (domNode: HTMLElement) => {\n  const [dimensions, setDimensions] = useState<DOMRectReadOnly>();\n\n  useEffect(() => {\n    const resizeObserver = new ResizeObserver(([entry]) => setDimensions(entry.contentRect));\n    if (domNode) {\n      resizeObserver.observe(domNode);\n      return () => resizeObserver.unobserve(domNode);\n    }\n\n    return undefined;\n  }, [domNode]);\n\n  return dimensions;\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAAoC;AACpC,sCAA2B;AAEpB,MAAM,gBAAgB,CAAC,YAAyB;AACrD,QAAM,CAAC,YAAY,aAAa,QAAI,uBAA0B;AAE9D,8BAAU,MAAM;AACd,UAAM,iBAAiB,IAAI,gCAAAA,QAAe,CAAC,CAAC,KAAK,MAAM,cAAc,MAAM,WAAW,CAAC;AACvF,QAAI,SAAS;AACX,qBAAe,QAAQ,OAAO;AAC9B,aAAO,MAAM,eAAe,UAAU,OAAO;AAAA,IAC/C;AAEA,WAAO;AAAA,EACT,GAAG,CAAC,OAAO,CAAC;AAEZ,SAAO;AACT;",
+  "names": ["ResizeObserver"]
+}

package/dist/cjs/index.js

@@ -40,6 +40,7 @@ __export(src_exports, {
   cloneDeep: () => import_utils.cloneDeep,
   compose: () => import_compose.compose,
   contains: () => import_operators.contains,
+  crossTypeSort: () => import_crossTypeSort.crossTypeSort,
   curry: () => import_utils.curry,
   cx: () => import_utils.cx,
   debounce: () => import_utils.debounce,
@@ -145,6 +146,7 @@ var import_compose = require("./compose");
 var import_platform = require("./platform");
 var import_reactTypesUtility = require("./reactTypesUtility");
 var import_validations = require("./validations");
+var import_crossTypeSort = require("./algorithms/crossTypeSort");
 __reExport(src_exports, require("./deprecated"), module.exports);
 __reExport(src_exports, require("./props-helpers"), module.exports);
 //# sourceMappingURL=index.js.map

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, setMultipleRefs, 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  useMakeMutable,\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;AAAA;AAAA;ACAA,YAAuB;ADAvB,mCAAiD;AACjD,qDAAmE;AACnE,wBAA2B;AAC3B,6BAA6D;AAC7D,uBAeO;AACP,mBA+CO;AACP,oBAA2D;AAC3D,mBA2BO;AACP,uBAAwD;AACxD,qBAAwB;AACxB,sBAAiC;AACjC,+BAAiC;AACjC,yBAAuD;AAGvD,wBAAc,yBAxGd;AAyGA,wBAAc,4BAzGd;",
+  "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, setMultipleRefs, 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  useMakeMutable,\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\nexport { crossTypeSort } from './algorithms/crossTypeSort';\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;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mCAAiD;AACjD,qDAAmE;AACnE,wBAA2B;AAC3B,6BAA6D;AAC7D,uBAeO;AACP,mBA+CO;AACP,oBAA2D;AAC3D,mBA2BO;AACP,uBAAwD;AACxD,qBAAwB;AACxB,sBAAiC;AACjC,+BAAiC;AACjC,yBAAuD;AAEvD,2BAA8B;AAG9B,wBAAc,yBA1Gd;AA2GA,wBAAc,4BA3Gd;",
   "names": []
 }

package/dist/esm/algorithms/crossTypeSort.js

@@ -0,0 +1,59 @@
+import * as React from "react";
+const canBeParsedAsNumber = (val) => !Number.isNaN(parseFloat(val));
+const numberSort = (a, b, direction = "ASC") => {
+  if (canBeParsedAsNumber(a) && canBeParsedAsNumber(b)) {
+    const aAsNum = parseFloat(a);
+    const bAsNum = parseFloat(b);
+    if (direction === "ASC")
+      return aAsNum - bAsNum;
+    else
+      return bAsNum - aAsNum;
+  }
+  if (canBeParsedAsNumber(a))
+    return direction === "ASC" ? -1 : 1;
+  if (canBeParsedAsNumber(b))
+    return direction === "ASC" ? 1 : -1;
+  return false;
+};
+const voidishSort = (a, b) => {
+  if (a === void 0)
+    return 1;
+  if (b === void 0)
+    return -1;
+  if (a === null)
+    return 1;
+  if (b === null)
+    return -1;
+  if (a === "")
+    return 1;
+  if (b === "")
+    return -1;
+  if (a === "-")
+    return 1;
+  if (b === "-")
+    return -1;
+  return false;
+};
+const stringSort = (a, b, direction = "ASC") => {
+  if (typeof a === "string" && typeof b === "string")
+    return direction === "ASC" ? a.localeCompare(b, void 0, { numeric: true }) : b.localeCompare(a, void 0, { numeric: true });
+  return false;
+};
+const crossTypeSort = (a, b, direction = "ASC") => {
+  if (a === b)
+    return 0;
+  const voidishSorted = voidishSort(a, b, direction);
+  if (voidishSorted !== false)
+    return voidishSorted;
+  const numberSorted = numberSort(a, b, direction);
+  if (numberSorted !== false)
+    return numberSorted;
+  const stringSorted = stringSort(a, b, direction);
+  if (stringSorted !== false)
+    return stringSorted;
+  return -1;
+};
+export {
+  crossTypeSort
+};
+//# sourceMappingURL=crossTypeSort.js.map

package/dist/esm/algorithms/crossTypeSort.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/algorithms/crossTypeSort.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "type ComparisonTerm = string | number | null | undefined;\ntype Direction = 'ASC' | 'DESC';\ntype SortCB = Required<Parameters<typeof Array.prototype['sort']>>[0];\ntype SortingHelper = (a: ComparisonTerm, b: ComparisonTerm, direction?: Direction) => ReturnType<SortCB> | false;\n\nconst canBeParsedAsNumber = (val: ComparisonTerm): val is string => !Number.isNaN(parseFloat(val as string));\n\nconst numberSort: SortingHelper = (a, b, direction = 'ASC') => {\n  if (canBeParsedAsNumber(a) && canBeParsedAsNumber(b)) {\n    const aAsNum = parseFloat(a);\n    const bAsNum = parseFloat(b);\n    if (direction === 'ASC') return aAsNum - bAsNum;\n    else return bAsNum - aAsNum;\n  }\n  if (canBeParsedAsNumber(a)) return direction === 'ASC' ? -1 : 1;\n  if (canBeParsedAsNumber(b)) return direction === 'ASC' ? 1 : -1;\n  return false;\n};\nconst voidishSort: SortingHelper = (a, b) => {\n  // voids are always sorted the same way no matter the direction since it's more ux intuitive\n  // order of execution matters, this ensure the order '-' , '', null, undefined\n  if (a === undefined) return 1;\n  if (b === undefined) return -1;\n  if (a === null) return 1;\n  if (b === null) return -1;\n  if (a === '') return 1;\n  if (b === '') return -1;\n  if (a === '-') return 1;\n  if (b === '-') return -1;\n  return false;\n};\nconst stringSort: SortingHelper = (a, b, direction = 'ASC') => {\n  if (typeof a === 'string' && typeof b === 'string')\n    return direction === 'ASC'\n      ? a.localeCompare(b, undefined, { numeric: true })\n      : b.localeCompare(a, undefined, { numeric: true });\n  return false;\n};\n\nexport const crossTypeSort = (\n  a: ComparisonTerm,\n  b: ComparisonTerm,\n  direction: Direction = 'ASC',\n): ReturnType<SortCB> => {\n  if (a === b) return 0;\n  const voidishSorted = voidishSort(a, b, direction);\n  if (voidishSorted !== false) return voidishSorted;\n\n  const numberSorted = numberSort(a, b, direction);\n  if (numberSorted !== false) return numberSorted;\n\n  const stringSorted = stringSort(a, b, direction);\n  if (stringSorted !== false) return stringSorted;\n  return -1;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACKvB,MAAM,sBAAsB,CAAC,QAAuC,CAAC,OAAO,MAAM,WAAW,GAAa,CAAC;AAE3G,MAAM,aAA4B,CAAC,GAAG,GAAG,YAAY,UAAU;AAC7D,MAAI,oBAAoB,CAAC,KAAK,oBAAoB,CAAC,GAAG;AACpD,UAAM,SAAS,WAAW,CAAC;AAC3B,UAAM,SAAS,WAAW,CAAC;AAC3B,QAAI,cAAc;AAAO,aAAO,SAAS;AAAA;AACpC,aAAO,SAAS;AAAA,EACvB;AACA,MAAI,oBAAoB,CAAC;AAAG,WAAO,cAAc,QAAQ,KAAK;AAC9D,MAAI,oBAAoB,CAAC;AAAG,WAAO,cAAc,QAAQ,IAAI;AAC7D,SAAO;AACT;AACA,MAAM,cAA6B,CAAC,GAAG,MAAM;AAG3C,MAAI,MAAM;AAAW,WAAO;AAC5B,MAAI,MAAM;AAAW,WAAO;AAC5B,MAAI,MAAM;AAAM,WAAO;AACvB,MAAI,MAAM;AAAM,WAAO;AACvB,MAAI,MAAM;AAAI,WAAO;AACrB,MAAI,MAAM;AAAI,WAAO;AACrB,MAAI,MAAM;AAAK,WAAO;AACtB,MAAI,MAAM;AAAK,WAAO;AACtB,SAAO;AACT;AACA,MAAM,aAA4B,CAAC,GAAG,GAAG,YAAY,UAAU;AAC7D,MAAI,OAAO,MAAM,YAAY,OAAO,MAAM;AACxC,WAAO,cAAc,QACjB,EAAE,cAAc,GAAG,QAAW,EAAE,SAAS,KAAK,CAAC,IAC/C,EAAE,cAAc,GAAG,QAAW,EAAE,SAAS,KAAK,CAAC;AACrD,SAAO;AACT;AAEO,MAAM,gBAAgB,CAC3B,GACA,GACA,YAAuB,UACA;AACvB,MAAI,MAAM;AAAG,WAAO;AACpB,QAAM,gBAAgB,YAAY,GAAG,GAAG,SAAS;AACjD,MAAI,kBAAkB;AAAO,WAAO;AAEpC,QAAM,eAAe,WAAW,GAAG,GAAG,SAAS;AAC/C,MAAI,iBAAiB;AAAO,WAAO;AAEnC,QAAM,eAAe,WAAW,GAAG,GAAG,SAAS;AAC/C,MAAI,iBAAiB;AAAO,WAAO;AACnC,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/hooks/useDimensions.js

@@ -0,0 +1,19 @@
+import * as React from "react";
+import { useEffect, useState } from "react";
+import ResizeObserver from "resize-observer-polyfill";
+const useDimensions = (domNode) => {
+  const [dimensions, setDimensions] = useState();
+  useEffect(() => {
+    const resizeObserver = new ResizeObserver(([entry]) => setDimensions(entry.contentRect));
+    if (domNode) {
+      resizeObserver.observe(domNode);
+      return () => resizeObserver.unobserve(domNode);
+    }
+    return void 0;
+  }, [domNode]);
+  return dimensions;
+};
+export {
+  useDimensions
+};
+//# sourceMappingURL=useDimensions.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../scripts/build/transpile/react-shim.js", "../../../src/hooks/useDimensions.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useEffect, useState } from 'react';\nimport ResizeObserver from 'resize-observer-polyfill';\n\nexport const useDimensions = (domNode: HTMLElement) => {\n  const [dimensions, setDimensions] = useState<DOMRectReadOnly>();\n\n  useEffect(() => {\n    const resizeObserver = new ResizeObserver(([entry]) => setDimensions(entry.contentRect));\n    if (domNode) {\n      resizeObserver.observe(domNode);\n      return () => resizeObserver.unobserve(domNode);\n    }\n\n    return undefined;\n  }, [domNode]);\n\n  return dimensions;\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAS,WAAW,gBAAgB;AACpC,OAAO,oBAAoB;AAEpB,MAAM,gBAAgB,CAAC,YAAyB;AACrD,QAAM,CAAC,YAAY,aAAa,IAAI,SAA0B;AAE9D,YAAU,MAAM;AACd,UAAM,iBAAiB,IAAI,eAAe,CAAC,CAAC,KAAK,MAAM,cAAc,MAAM,WAAW,CAAC;AACvF,QAAI,SAAS;AACX,qBAAe,QAAQ,OAAO;AAC9B,aAAO,MAAM,eAAe,UAAU,OAAO;AAAA,IAC/C;AAEA,WAAO;AAAA,EACT,GAAG,CAAC,OAAO,CAAC;AAEZ,SAAO;AACT;",
+  "names": []
+}

package/dist/esm/index.js

@@ -101,6 +101,7 @@ import { compose } from "./compose";
 import { DOCUMENT, WINDOW } from "./platform";
 import { isDOMTypeElement } from "./reactTypesUtility";
 import { isRequired, isGreaterThan, isValidDate } from "./validations";
+import { crossTypeSort } from "./algorithms/crossTypeSort";
 export * from "./deprecated";
 export * from "./props-helpers";
 export {
@@ -119,6 +120,7 @@ export {
   cloneDeep,
   compose,
   contains,
+  crossTypeSort,
   curry,
   cx,
   debounce,

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, setMultipleRefs, 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  useMakeMutable,\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,YAAY,WAAW;ACAvB,SAAoB,WAAXA,gBAAwC;AACjD,SAAoB,WAAXA,gBAA0D;AACnE,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB,4BAA4B;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,QAAQ,WAAW,iBAAiB,cAAc;AAC3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,wBAAwB,uBAAuB;AACxD,SAAS,eAAe;AACxB,SAAS,UAAU,cAAc;AACjC,SAAS,wBAAwB;AACjC,SAAS,YAAY,eAAe,mBAAmB;AAGvD,cAAc;AACd,cAAc;",
+  "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, setMultipleRefs, 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  useMakeMutable,\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\nexport { crossTypeSort } from './algorithms/crossTypeSort';\n\n// TODO -- REMOVE WHEN READY\nexport * from './deprecated';\nexport * from './props-helpers';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACAvB,SAAoB,WAAXA,gBAAwC;AACjD,SAAoB,WAAXA,gBAA0D;AACnE,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB,4BAA4B;AAC7D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,QAAQ,WAAW,iBAAiB,cAAc;AAC3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,wBAAwB,uBAAuB;AACxD,SAAS,eAAe;AACxB,SAAS,UAAU,cAAc;AACjC,SAAS,wBAAwB;AACjC,SAAS,YAAY,eAAe,mBAAmB;AAEvD,SAAS,qBAAqB;AAG9B,cAAc;AACd,cAAc;",
   "names": ["default"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliemae/ds-utilities",
-  "version": "3.11.0",
+  "version": "3.11.1-rc.1",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Utilities",
   "files": [
@@ -151,7 +151,7 @@
     "typeSafety": true
   },
   "dependencies": {
-    "@elliemae/ds-system": "3.11.0",
+    "@elliemae/ds-system": "3.11.1-rc.1",
     "@elliemae/pui-theme": "~2.6.0",
     "fast-deep-equal": "~3.1.3",
     "hotkeys-js": "~3.9.3",
@@ -173,11 +173,14 @@
     "react-dom": "^17.0.2"
   },
   "scripts": {
+    "dev": "cross-env NODE_ENV=development node ../../scripts/build/build.mjs --watch",
     "test": "node ../../scripts/testing/test.mjs",
     "lint": "node ../../scripts/lint.mjs",
     "dts": "node ../../scripts/dts.mjs",
+    "dts:withdeps": "pnpm --filter {.}... dts",
     "build": "cross-env NODE_ENV=production node ../../scripts/build/build.mjs",
-    "checkDeps": "npx -yes ../ds-codemods check-missing-packages --projectFolderPath=\"./\" --ignorePackagesGlobPattern=\"\" --ignoreFilesGlobPattern=\"**/test-ables/*,**/tests/*\"",
-    "dev": "cross-env NODE_ENV=development node ../../scripts/build/build.mjs --watch"
+    "dev:build": "pnpm --filter {.}... build && pnpm --filter {.}... dts",
+    "dev:install": "pnpm --filter {.}... i --no-lockfile && pnpm run dev:build",
+    "checkDeps": "npx -yes ../ds-codemods check-missing-packages --projectFolderPath=\"./\" --ignorePackagesGlobPattern=\"\" --ignoreFilesGlobPattern=\"**/test-ables/*,**/tests/*\""
   }
 }