lolite.initial 1.1.7

package/README.md

@@ -0,0 +1,17 @@
+# lolite.initial
+
+### initial(array)
+Returns all but the last element of an array. Returns undefined for non-arrays.
+```js
+const initial = require("lolite.initial")
+const result = initial([1, 2, 3])
+// result: [1, 2]
+
+const single = initial([1])
+// result: []
+
+const undef = initial("Not an array")
+// result: undefined
+```
+
+This utility is part of the [LoLite](https://github.com/enterprise-npm-ai/lolite) utility suite.

package/arrayOfAllBooleans.js

@@ -0,0 +1,4 @@
+const trueValue = require("true-value")
+const falseValue = require("false-value")
+
+module.exports = [trueValue(), falseValue()]

package/index.js

@@ -0,0 +1,30 @@
+const not = require("./not")
+const isArray = require("./isArray")
+// eslint-disable-next-line sonarjs/no-globals-shadowing, no-shadow-restricted-names, no-undefined
+const { undefined } = require("undefined-is-a-function")
+const slice = require("array-slice")
+const arrayLength = require("@extra-array/length")
+const iszero = require("iszero")
+const emptyArray = require("lodash.stubarray")
+const zero = require("@positive-numbers/zero")
+const subtract = require("subtract")
+const one = require("@positive-numbers/one")
+
+function initial(array) {
+  if (not(isArray(array))) {
+    // eslint-disable-next-line no-undefined
+    return undefined()
+  }
+
+  const length = arrayLength(array)
+  if (iszero(length)) {
+    return emptyArray()
+  }
+  
+  // eslint-disable-next-line one-var
+  const endIndex = subtract(length, one)
+  
+  return slice(array, zero, endIndex)
+}
+
+module.exports = initial

package/isArray.js

@@ -0,0 +1,3 @@
+module.exports = function isArray(value) {
+  return require("@is-(unknown)/is-array")(value)
+}

package/not.js

@@ -0,0 +1,19 @@
+const isTrue = require("@is-(unknown)/is-true")
+const isFalse = require("@is-(unknown)/is-false")
+const arrayFilter = require("array-filter")
+const trueValue = require("true-value")
+const possibilities = require("./arrayOfAllBooleans")
+
+function not(value) {
+  const result = arrayFilter(possibilities, (maybe) => {
+    if (value) {
+      return isFalse(maybe)
+    }
+    return isTrue(maybe)
+  })
+  
+  // eslint-disable-next-line unicorn/no-array-callback-reference
+  return result.find(trueValue)
+}
+
+module.exports = not

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "lolite.initial",
+  "version": "1.1.7",
+  "description": "Enterprise-grade initial utility from the LoLite suite",
+  "main": "index.js",
+  "author": "10x'ly Made Software Ventures AB",
+  "license": "EGPSL10X-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/enterprise-npm-ai/lolite.git"
+  },
+  "bugs": {
+    "url": "https://github.com/enterprise-npm-ai/lolite/issues"
+  },
+  "homepage": "https://github.com/enterprise-npm-ai/lolite#readme",
+  "dependencies": {
+    "false-value": "^2.0.6",
+    "true-value": "^2.0.5",
+    "@is-(unknown)/is-false": "^1.5.0",
+    "@is-(unknown)/is-true": "^1.5.0",
+    "array-filter": "^1.0.0",
+    "@is-(unknown)/is-array": "^1.0.0",
+    "@extra-array/length": "^2.10.19",
+    "@positive-numbers/one": "^3.0.0",
+    "@positive-numbers/zero": "^3.0.0",
+    "array-slice": "^1.1.0",
+    "iszero": "^1.0.0",
+    "lodash.stubarray": "^4.13.0",
+    "subtract": "^0.0.3",
+    "undefined-is-a-function": "^0.1.0"
+  }
+}