@opndev/util 0.0.9 → 0.0.10

package/README.md

@@ -0,0 +1,55 @@
+<!--
+SPDX-FileCopyrightText: 2020-2024 Wesley Schwengle <wesley@opndev.io>
+
+SPDX-License-Identifier: MIT
+-->
+
+# Welcome to @opndev/util
+
+This is a utility function package that tries to solve issues by keeping things
+DRY. It is an ESM package.
+
+[If you want to know more, have a look at our documenation](https://opndev.gitlab.io/javascript/opndev-js-util/)
+
+## Development
+
+Try to keep functions small and try not to depend on any outside functions. We
+aim to keep the dependency graph as small as possible. The use of `esm` is
+welcomed and writing tests is encouraged.
+
+### jsdoc
+
+You can build the documentation by running `npm run jsdoc`.
+
+### eslint
+
+The ES Linting profile is flexible and does not try to enforce much. There is
+more than one way to do it ([TIMTOWTDI](https://en.wikipedia.org/wiki/There%27s_more_than_one_way_to_do_it)).
+
+Try to stay constistent, but forcing a programming style upon others is bad.
+
+### gitignore
+
+Please educate yourself and use a global gitignore file. Somes files will
+always be there. I'm looking at you `node_modules`.
+
+### The lockfiles
+You'll also see that `package-lock.json` and/or `yarn.lock` are ignored. I
+strongly believe that pinning packages lead to bit rot, as you never update
+packages. When a downstream module breaks its API you should know and update
+your code accordingly. The same goes for possible upstream modules. If you want
+a specific version, pin it to that version, otherwise use the latest and
+greatest when possible.
+
+### Code of conduct
+
+There is none, stay human, communicate and accept that some people have
+different opinions.
+
+### Pull requests
+
+I'm happy to accept pull requests, just make sure your change has tests.
+Add a good commit message and commit with a sign-off `git commit -s`.
+
+A good commit message isn't just `issue(feat): added foo to bar` but also
+explain the why in the commit.

package/lib/asArray.mjs

@@ -0,0 +1,19 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesley@opndev.io>
+//
+// SPDX-License-Identifier: MIT
+
+/**
+ * Return an array if something is a scalar. This array-i-fies everything to an
+ * array. Perl ref $a ne 'ARRAY' ? [ $a ] : $a
+ *
+ * @function uniq
+ * @param {Anything} needle Anything
+ * @returns {Array} An array
+ */
+
+export default function asArray(v) {
+  if (v == null) return [];
+  return Array.isArray(v) ? v : [v];
+}
+
+export { asArray }

package/lib/index.mjs

@@ -2,7 +2,7 @@
 //
 // SPDX-License-Identifier: MIT
 
-const VERSION = "0.0.9";
+const VERSION = "0.0.10";
 
 /**
  *
@@ -13,6 +13,10 @@ const VERSION = "0.0.9";
  * @exports defined
  * @exports pow_of_two
  * @exports is_pow_of_two
+ * @exports uniq
+ * @exports ucFirst
+ * @exports lcFirst
+ * @exports range
  *
  * Export all the useful functions. Unfortunatly, without webpack's
  * require.context we cannot automaticly load everything. So we just keep
@@ -26,3 +30,5 @@ export { is_pow_of_two } from './ispowtwo.mjs'
 export { range } from './range.mjs'
 export { ucFirst } from './ucFirst.mjs'
 export { lcFirst } from './lcFirst.mjs'
+export { uniq } from './uniq.mjs'
+export { asArray } from './asArray.mjs'

package/lib/uniq.mjs

@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2026 Wesley Schwengle <wesley@opndev.io>
+//
+// SPDX-License-Identifier: MIT
+
+/**
+ * Return an array with uniq values
+ *
+ * @function uniq
+ * @param {Array} needle Anything
+ * @returns {Array} An array with unique values
+ */
+export default function uniq(arr) {
+  return [...new Set(arr.filter((x) => x != null && x !== ""))];
+}
+
+export { uniq }

package/package.json

@@ -39,5 +39,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.0.9"
+  "version": "0.0.10"
 }