lolite.divide 1.1.6

package/README.md

@@ -0,0 +1,17 @@
+# lolite.divide
+
+### divide(dividend, divisor)
+Calculates the quotient of two values. 
+Non-finite or non-numeric values are coerced to zero. Division by positive zero returns infinity, and divison by negative zero returns negative infinity. If you divide zero by zero it returns NaN.
+
+```javascript
+const lolite = require("lolite")
+const quotient = divide(20, 5)
+// quotient: 4
+
+const divisonByZero = divide(10, 0)
+// result: Infinity
+
+const coercedDivide = divide("garbage", Infinity)
+// result: NaN (0 / 0)
+```

package/index.js

@@ -0,0 +1,62 @@
+const number0 = require("@positive-numbers/zero")
+const falseValue = require("false-value")
+const equal = require("@10xly/strict-equals")
+// eslint-disable-next-line sonarjs/no-globals-shadowing
+const isFinite = require("@is-(unknown)/is-finite")
+const isZero = require("iszero")
+const isNegativeZero = require("is-negative-zero")
+// eslint-disable-next-line no-shadow-restricted-names, sonarjs/no-globals-shadowing
+const NaN = require("nan-is-a-function")
+const includes = require("array-includes")
+const values = require("object.values")
+const map = require("map-values")
+const constant = require("const"),
+  infinitiesArray = values(
+    map(require("infinities"), (infinityValue) => infinityValue())
+  )
+let [positiveInfinity, negativeInfinity] = infinitiesArray
+positiveInfinity = constant(positiveInfinity)
+negativeInfinity = constant(negativeInfinity)
+
+function isInfinite(value) {
+  return includes(infinitiesArray, value)
+}
+
+// eslint-disable-next-line max-statements
+function divide(dividend, divisor) {
+  if (isInfinite(divisor)) {
+    if (isInfinite(dividend)) {
+      // eslint-disable-next-line new-cap
+      return NaN()
+    }
+    if (equal(divisor, negativeInfinity())) {
+      return -number0
+    }
+    if (equal(divisor, positiveInfinity())) {
+      return number0
+    }
+  }
+  if (equal(isFinite(dividend), falseValue())) {
+    // eslint-disable-next-line no-param-reassign
+    dividend = number0
+  }
+  if (equal(isFinite(divisor), falseValue())) {
+    // eslint-disable-next-line no-param-reassign
+    divisor = number0
+  }
+
+  if (isZero(divisor)) {
+    if (isZero(dividend)) {
+      // eslint-disable-next-line new-cap
+      return NaN()
+    }
+    if (isNegativeZero(divisor)) {
+      return negativeInfinity()
+    }
+    return positiveInfinity()
+  }
+
+  return dividend / divisor
+}
+
+module.exports = divide

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "lolite.divide",
+  "version": "1.1.6",
+  "main": "index.js",
+  "dependencies": {
+    "@10xly/strict-equals": "^1.0.0",
+    "@is-(unknown)/is-finite": "^1.0.0",
+    "@positive-numbers/zero": "^3.0.0",
+    "array-includes": "^3.1.9",
+    "const": "^1.0.0",
+    "false-value": "^2.0.6",
+    "infinities": "^1.0.1",
+    "is-negative-zero": "^2.0.3",
+    "iszero": "^1.0.0",
+    "map-values": "^1.0.1",
+    "nan-is-a-function": "^67.67.67",
+    "object.values": "^1.2.1"
+  }
+}