chore: generate documentation
[poolifier.git] / src / utils.ts
index 46ab5051f38ff77eb2fd06c41199bd360b306276..d85c5ba58b4988fad867a9b35f9dca5bb5bb2b45 100644 (file)
@@ -1,11 +1,24 @@
 /**
  * An intentional empty function.
  */
-export const EMPTY_FUNCTION: () => void = () => {
+export const EMPTY_FUNCTION: () => void = Object.freeze(() => {
   /* Intentionally empty */
-}
+})
 
 /**
- * An intentional empty object literal.
+ * Returns the median of the given data set.
+ *
+ * @param dataSet - Data set.
+ * @returns The median of the given data set.
  */
-export const EMPTY_LITERAL = {}
+export const median = (dataSet: number[]): number => {
+  if (Array.isArray(dataSet) && dataSet.length === 1) {
+    return dataSet[0]
+  }
+  const sortedDataSet = dataSet.slice().sort((a, b) => a - b)
+  const middleIndex = Math.floor(sortedDataSet.length / 2)
+  if (sortedDataSet.length % 2 === 0) {
+    return sortedDataSet[middleIndex / 2]
+  }
+  return (sortedDataSet[middleIndex - 1] + sortedDataSet[middleIndex]) / 2
+}