@silvermine/toolbox 0.2.0 → 0.3.0

package/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on: [ push, pull_request ]
+
+jobs:
+   build:
+      runs-on: ubuntu-latest
+      steps:
+         -
+            uses: actions/checkout@v4
+            with:
+               fetch-depth: 0 # Fetch all history
+         -
+            uses: actions/setup-node@v4
+            with:
+               node-version-file: '.nvmrc'
+         - run: npm i -g npm@10.5.0
+         - run: npm ci
+         - run: npm run check-node-version
+         - run: npm run standards
+   test:
+      needs: [ build ]
+      runs-on: ubuntu-latest
+      strategy:
+         fail-fast: false
+         matrix:
+            node-version: [ 16, 20, 'lts/*', 'latest' ]
+      steps:
+         - uses: actions/checkout@v4
+         -
+            name: Use Node.js ${{ matrix.node-version }}
+            uses: actions/setup-node@v4
+            with:
+               node-version: ${{ matrix.node-version }}
+         - run: npm ci # Reinstall the dependencies to ensure they install with the node's version of npm
+         - run: npm test
+         - name: Coveralls
+           uses: coverallsapp/github-action@v1
+           with:
+               parallel: true
+               flag-name: ${{ matrix.node-version }}
+   finish:
+      needs: [ test ]
+      runs-on: ubuntu-latest
+      steps:
+         - name: Close parallel build
+           uses: coverallsapp/github-action@v1
+           with:
+               parallel-finished: true

package/.markdownlint.json

@@ -0,0 +1,3 @@
+{
+   "extends": "./node_modules/@silvermine/standardization/.markdownlint.json"
+}

package/.nvmrc

@@ -0,0 +1 @@
+20.12.2

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+See [our coding standards][commit-messages] for commit guidelines.
+
+## [0.3.0](https://github.com/silvermine/toolbox/compare/v0.2.0...v0.3.0) (2024-05-06)
+
+
+### Features
+
+* add partial replacement of _.pick ([c7d143e](https://github.com/silvermine/toolbox/commit/c7d143e05867d2785de60ca4141aefb62361ac35))
+* add replacement of _.uniq ([#23](https://github.com/silvermine/toolbox/issues/23)) ([4ece381](https://github.com/silvermine/toolbox/commit/4ece3819757dd2dbb354ad42bb496844a9cda67a))
+* add StrictUnion ([22080e1](https://github.com/silvermine/toolbox/commit/22080e1b590b8c5ace25f544366a0807b355a27e))
+
+### Other
+
+* config: allow tslib 2.x as peer dep ([6320e11](https://github.com/silvermine/toolbox/commit/6320e11110deeb66008a58b0090e8dde6214cc11))
+
+
+[commit-messages]: https://github.com/silvermine/silvermine-info/blob/master/commit-history.md#commit-messages

package/README.md

@@ -1,9 +1,13 @@
+# Silvermine Toolbox - TypeScript Types and Utilities
+
 <p align="center">
-  <img width="300" height="300" src="https://raw.github.com/silvermine/toolbox/master/src/logo/toolbox.png" alt="Tools such as a protractor, calculator, pencil, and a pen inside a shirt pocket.">
+   <img width="300"
+    height="300"
+    src="https://raw.github.com/silvermine/toolbox/master/src/logo/toolbox.png"
+    alt="Tools such as a protractor, calculator, pencil, and a pen inside a shirt pocket."
+   >
 </p>
 
-# Silvermine Toolbox - TypeScript Types and Utilities
-
 [![NPM Version](https://img.shields.io/npm/v/@silvermine/toolbox.svg)](https://www.npmjs.com/package/@silvermine/toolbox)
 [![License](https://img.shields.io/github/license/silvermine/toolbox.svg)](./LICENSE)
 [![Build Status](https://travis-ci.com/silvermine/toolbox.svg?branch=master)](https://travis-ci.com/silvermine/toolbox)

package/dist/commonjs/index.js

@@ -7,6 +7,7 @@ tslib_1.__exportStar(require("./types/Optional"), exports);
 tslib_1.__exportStar(require("./types/PropsWithType"), exports);
 tslib_1.__exportStar(require("./types/RequireDefined"), exports);
 tslib_1.__exportStar(require("./types/RequireOptional"), exports);
+tslib_1.__exportStar(require("./types/StrictUnion"), exports);
 tslib_1.__exportStar(require("./types/StringArrayOfStringsMap"), exports);
 tslib_1.__exportStar(require("./types/StringMap"), exports);
 tslib_1.__exportStar(require("./types/StringUnknownMap"), exports);
@@ -28,9 +29,11 @@ tslib_1.__exportStar(require("./utils/is-null"), exports);
 tslib_1.__exportStar(require("./utils/is-not-null-or-undefined"), exports);
 tslib_1.__exportStar(require("./utils/chunk"), exports);
 tslib_1.__exportStar(require("./utils/flatten"), exports);
+tslib_1.__exportStar(require("./utils/pick"), exports);
 tslib_1.__exportStar(require("./utils/pluck"), exports);
 tslib_1.__exportStar(require("./utils/delay"), exports);
 tslib_1.__exportStar(require("./utils/get"), exports);
 tslib_1.__exportStar(require("./utils/escape-html"), exports);
 tslib_1.__exportStar(require("./utils/make-template"), exports);
+tslib_1.__exportStar(require("./utils/uniq"), exports);
 //# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,uDAA6B;AAC7B,2DAAiC;AACjC,gEAAsC;AACtC,iEAAuC;AACvC,kEAAwC;AACxC,0EAAgD;AAChD,4DAAkC;AAClC,mEAAyC;AACzC,2DAAiC;AAEjC,8DAAoC;AACpC,+DAAqC;AACrC,2DAAiC;AACjC,sEAA4C;AAC5C,2DAAiC;AACjC,gEAAsC;AACtC,6EAAmD;AACnD,4DAAkC;AAClC,4DAAkC;AAClC,6DAAmC;AACnC,kEAAwC;AACxC,4DAAkC;AAClC,+DAAqC;AACrC,0DAAgC;AAChC,2EAAiD;AAEjD,wDAA8B;AAC9B,0DAAgC;AAChC,wDAA8B;AAC9B,wDAA8B;AAC9B,sDAA4B;AAC5B,8DAAoC;AACpC,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,uDAA6B;AAC7B,2DAAiC;AACjC,gEAAsC;AACtC,iEAAuC;AACvC,kEAAwC;AACxC,8DAAoC;AACpC,0EAAgD;AAChD,4DAAkC;AAClC,mEAAyC;AACzC,2DAAiC;AAEjC,8DAAoC;AACpC,+DAAqC;AACrC,2DAAiC;AACjC,sEAA4C;AAC5C,2DAAiC;AACjC,gEAAsC;AACtC,6EAAmD;AACnD,4DAAkC;AAClC,4DAAkC;AAClC,6DAAmC;AACnC,kEAAwC;AACxC,4DAAkC;AAClC,+DAAqC;AACrC,0DAAgC;AAChC,2EAAiD;AAEjD,wDAA8B;AAC9B,0DAAgC;AAChC,uDAA6B;AAC7B,wDAA8B;AAC9B,wDAA8B;AAC9B,sDAA4B;AAC5B,8DAAoC;AACpC,gEAAsC;AACtC,uDAA6B"}

package/dist/commonjs/types/StrictUnion.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-type-alias */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=StrictUnion.js.map

package/dist/commonjs/types/StrictUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrictUnion.js","sourceRoot":"","sources":["../../../src/types/StrictUnion.ts"],"names":[],"mappings":";AAAA,qDAAqD"}

package/dist/commonjs/utils/pick.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pick = void 0;
+const is_array_1 = require("./is-array");
+function pick(obj, ...args) {
+    const props = ((args.length === 1 && is_array_1.isArray(args[0])) ? args[0] : args);
+    return props.reduce((memo, prop) => {
+        if (prop in obj) {
+            memo[prop] = obj[prop];
+        }
+        return memo;
+    }, {});
+}
+exports.pick = pick;
+//# sourceMappingURL=pick.js.map

package/dist/commonjs/utils/pick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.js","sourceRoot":"","sources":["../../../src/utils/pick.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AAcrC,SAAgB,IAAI,CAAsC,GAAM,EAAE,GAAG,IAAmB;IACrF,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAQ,CAAC;IAEhF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QAChC,IAAI,IAAI,IAAI,GAAG,EAAE;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;SACzB;QACD,OAAO,IAAI,CAAC;IACf,CAAC,EAAE,EAAgB,CAAC,CAAC;AACxB,CAAC;AATD,oBASC"}

package/dist/commonjs/utils/uniq.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniq = void 0;
+const iterateeUniq = (arr, iteratee) => {
+    const result = [], seen = [];
+    for (let i = 0, length = arr.length; i < length; i++) {
+        let value = arr[i], computed = iteratee(value, i, arr);
+        if (seen.indexOf(computed) === -1) {
+            seen.push(computed);
+            result.push(value);
+        }
+    }
+    return result;
+};
+const sortedUniq = (arr) => {
+    const result = [];
+    let lastSeen;
+    for (let i = 0, length = arr.length; i < length; i++) {
+        let value = arr[i];
+        if (i === 0 || lastSeen !== value) {
+            result.push(value);
+        }
+        lastSeen = value;
+    }
+    return result;
+};
+const standardUniq = (arr) => {
+    const result = arr.filter((value, index, _arr) => {
+        return _arr.indexOf(value) === index;
+    });
+    return result;
+};
+/**
+ * Produce a duplicate-free version of the array. If the array has already
+ * been sorted, you have the option of using a faster algorithm.
+ * The faster algorithm will not work with an iteratee if the iteratee
+ * is not a one-to-one function, so providing an iteratee will disable
+ * the faster algorithm.
+ */
+exports.uniq = (arr, isSorted, iteratee) => {
+    if (iteratee) {
+        return iterateeUniq(arr, iteratee);
+    }
+    if (isSorted) {
+        return sortedUniq(arr);
+    }
+    return standardUniq(arr);
+};
+//# sourceMappingURL=uniq.js.map

package/dist/commonjs/utils/uniq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.js","sourceRoot":"","sources":["../../../src/utils/uniq.ts"],"names":[],"mappings":";;;AAAA,MAAM,YAAY,GAAG,CAAO,GAAQ,EAAE,QAA8C,EAAO,EAAE;IAC1F,MAAM,MAAM,GAAQ,EAAE,EAChB,IAAI,GAAQ,EAAE,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EACd,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAEvC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;KACH;IACD,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF,MAAM,UAAU,GAAG,CAAO,GAAQ,EAAO,EAAE;IACxC,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,QAA2B,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,KAAK,EAAE;YAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;QACD,QAAQ,GAAG,KAAK,CAAC;KACnB;IACD,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF,MAAM,YAAY,GAAG,CAAI,GAAQ,EAAO,EAAE;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF;;;;;;GAMG;AACU,QAAA,IAAI,GAAG,CAAO,GAAQ,EAAE,QAAkB,EAAE,QAA+C,EAAO,EAAE;IAC9G,IAAI,QAAQ,EAAE;QACX,OAAO,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;KACrC;IACD,IAAI,QAAQ,EAAE;QACX,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;KACzB;IACD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC"}

package/dist/esm/index.js

@@ -4,6 +4,7 @@ export * from './types/Optional';
 export * from './types/PropsWithType';
 export * from './types/RequireDefined';
 export * from './types/RequireOptional';
+export * from './types/StrictUnion';
 export * from './types/StringArrayOfStringsMap';
 export * from './types/StringMap';
 export * from './types/StringUnknownMap';
@@ -25,9 +26,11 @@ export * from './utils/is-null';
 export * from './utils/is-not-null-or-undefined';
 export * from './utils/chunk';
 export * from './utils/flatten';
+export * from './utils/pick';
 export * from './utils/pluck';
 export * from './utils/delay';
 export * from './utils/get';
 export * from './utils/escape-html';
 export * from './utils/make-template';
+export * from './utils/uniq';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kCAAkC,CAAC;AAEjD,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kCAAkC,CAAC;AAEjD,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/dist/esm/types/StrictUnion.js

@@ -0,0 +1,2 @@
+/* eslint-disable @typescript-eslint/no-type-alias */
+//# sourceMappingURL=StrictUnion.js.map

package/dist/esm/types/StrictUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrictUnion.js","sourceRoot":"","sources":["../../../src/types/StrictUnion.ts"],"names":[],"mappings":"AAAA,qDAAqD"}

package/dist/esm/utils/pick.js

@@ -0,0 +1,11 @@
+import { isArray } from './is-array';
+export function pick(obj, ...args) {
+    const props = ((args.length === 1 && isArray(args[0])) ? args[0] : args);
+    return props.reduce((memo, prop) => {
+        if (prop in obj) {
+            memo[prop] = obj[prop];
+        }
+        return memo;
+    }, {});
+}
+//# sourceMappingURL=pick.js.map

package/dist/esm/utils/pick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.js","sourceRoot":"","sources":["../../../src/utils/pick.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAcrC,MAAM,UAAU,IAAI,CAAsC,GAAM,EAAE,GAAG,IAAmB;IACrF,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAQ,CAAC;IAEhF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QAChC,IAAI,IAAI,IAAI,GAAG,EAAE;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;SACzB;QACD,OAAO,IAAI,CAAC;IACf,CAAC,EAAE,EAAgB,CAAC,CAAC;AACxB,CAAC"}

package/dist/esm/utils/uniq.js

@@ -0,0 +1,46 @@
+const iterateeUniq = (arr, iteratee) => {
+    const result = [], seen = [];
+    for (let i = 0, length = arr.length; i < length; i++) {
+        let value = arr[i], computed = iteratee(value, i, arr);
+        if (seen.indexOf(computed) === -1) {
+            seen.push(computed);
+            result.push(value);
+        }
+    }
+    return result;
+};
+const sortedUniq = (arr) => {
+    const result = [];
+    let lastSeen;
+    for (let i = 0, length = arr.length; i < length; i++) {
+        let value = arr[i];
+        if (i === 0 || lastSeen !== value) {
+            result.push(value);
+        }
+        lastSeen = value;
+    }
+    return result;
+};
+const standardUniq = (arr) => {
+    const result = arr.filter((value, index, _arr) => {
+        return _arr.indexOf(value) === index;
+    });
+    return result;
+};
+/**
+ * Produce a duplicate-free version of the array. If the array has already
+ * been sorted, you have the option of using a faster algorithm.
+ * The faster algorithm will not work with an iteratee if the iteratee
+ * is not a one-to-one function, so providing an iteratee will disable
+ * the faster algorithm.
+ */
+export const uniq = (arr, isSorted, iteratee) => {
+    if (iteratee) {
+        return iterateeUniq(arr, iteratee);
+    }
+    if (isSorted) {
+        return sortedUniq(arr);
+    }
+    return standardUniq(arr);
+};
+//# sourceMappingURL=uniq.js.map

package/dist/esm/utils/uniq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq.js","sourceRoot":"","sources":["../../../src/utils/uniq.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAO,GAAQ,EAAE,QAA8C,EAAO,EAAE;IAC1F,MAAM,MAAM,GAAQ,EAAE,EAChB,IAAI,GAAQ,EAAE,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EACd,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAEvC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;KACH;IACD,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF,MAAM,UAAU,GAAG,CAAO,GAAQ,EAAO,EAAE;IACxC,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,QAA2B,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QACnD,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAEnB,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,KAAK,EAAE;YAChC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SACrB;QACD,QAAQ,GAAG,KAAK,CAAC;KACnB;IACD,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF,MAAM,YAAY,GAAG,CAAI,GAAQ,EAAO,EAAE;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACjB,CAAC,CAAC;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAO,GAAQ,EAAE,QAAkB,EAAE,QAA+C,EAAO,EAAE;IAC9G,IAAI,QAAQ,EAAE;QACX,OAAO,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;KACrC;IACD,IAAI,QAAQ,EAAE;QACX,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;KACzB;IACD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -4,6 +4,7 @@ export * from './types/Optional';
 export * from './types/PropsWithType';
 export * from './types/RequireDefined';
 export * from './types/RequireOptional';
+export * from './types/StrictUnion';
 export * from './types/StringArrayOfStringsMap';
 export * from './types/StringMap';
 export * from './types/StringUnknownMap';
@@ -25,8 +26,10 @@ export * from './utils/is-null';
 export * from './utils/is-not-null-or-undefined';
 export * from './utils/chunk';
 export * from './utils/flatten';
+export * from './utils/pick';
 export * from './utils/pluck';
 export * from './utils/delay';
 export * from './utils/get';
 export * from './utils/escape-html';
 export * from './utils/make-template';
+export * from './utils/uniq';

package/dist/types/types/StrictUnion.d.ts

@@ -0,0 +1,15 @@
+declare type UnionKeys<T> = T extends unknown ? keyof T : never;
+declare type InvalidKeys<K extends string | number | symbol> = {
+    [P in K]?: never;
+};
+declare type StrictUnionHelper<T, TAll> = T extends unknown ? (T & InvalidKeys<Exclude<UnionKeys<TAll>, keyof T>>) : never;
+/**
+ * A basic TypeScript union (e.g. A | B) results in a type containing the available
+ * properties from the provided types. When StrictUnion is used (e.g. StrictUnion<A | B>),
+ * the resulting type can only contain the properties from one of the types (e.g. all the
+ * properties from A, but none of the properties from B).
+ *
+ * See: https://github.com/microsoft/TypeScript/issues/20863#issuecomment-520551758
+ */
+export declare type StrictUnion<T> = StrictUnionHelper<T, T>;
+export {};

package/dist/types/utils/pick.d.ts

@@ -0,0 +1,2 @@
+export declare function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K>;
+export declare function pick<T extends object, K extends keyof T = never>(obj: T, ...props: K[]): Pick<T, K>;

package/dist/types/utils/uniq.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Produce a duplicate-free version of the array. If the array has already
+ * been sorted, you have the option of using a faster algorithm.
+ * The faster algorithm will not work with an iteratee if the iteratee
+ * is not a one-to-one function, so providing an iteratee will disable
+ * the faster algorithm.
+ */
+export declare const uniq: <T, U>(arr: T[], isSorted?: boolean | undefined, iteratee?: ((value: T, i: number, arr: T[]) => U) | undefined) => T[];

package/package.json

@@ -1,15 +1,21 @@
 {
    "name": "@silvermine/toolbox",
-   "version": "0.2.0",
+   "version": "0.3.0",
    "description": "A library of common TypeScript types, custom type guards, and utility functions.",
    "main": "./dist/commonjs/index",
    "types": "./dist/types/index.d.ts",
    "module": "./dist/esm/index",
    "scripts": {
       "prepare": "grunt build",
-      "test:node-version": "check-node-version --npm 6.14.12 --print",
-      "test": "npm run test:node-version && TS_NODE_PROJECT='tests/tsconfig.json' TS_NODE_FILES=true nyc mocha --opts ./.mocha.opts",
-      "commitlint": "commitlint --from 0b9d320"
+      "check-node-version": "check-node-version --npm 10.5.0 --print",
+      "test": "TS_NODE_PROJECT='tests/tsconfig.json' TS_NODE_FILES=true nyc mocha --opts ./.mocha.opts",
+      "eslint": "eslint '{,!(node_modules|dist)/**/}*.{js,ts}'",
+      "markdownlint": "markdownlint -c .markdownlint.json -i CHANGELOG.md '{,!(node_modules)/**/}*.md'",
+      "commitlint": "commitlint --from 0b9d320",
+      "standards": "npm run markdownlint && npm run eslint",
+      "release:preview": "node ./node_modules/@silvermine/standardization/scripts/release.js preview",
+      "release:prep-changelog": "node ./node_modules/@silvermine/standardization/scripts/release.js prep-changelog",
+      "release:finalize": "node ./node_modules/@silvermine/standardization/scripts/release.js finalize"
    },
    "author": "Matt Luedke",
    "license": "MIT",
@@ -27,13 +33,13 @@
       "type guards"
    ],
    "peerDependencies": {
-      "tslib": "1.9.x"
+      "tslib": "^1.9.0 || ^2"
    },
    "devDependencies": {
       "@silvermine/chai-strictly-equal": "1.1.0",
-      "@silvermine/eslint-config": "3.1.0-beta.0",
-      "@silvermine/standardization": "1.2.1",
-      "@silvermine/typescript-config": "git+https://github.com/silvermine/typescript-config.git#23213e33077089e723629dead5342abe6f3b3c8c",
+      "@silvermine/eslint-config": "github:silvermine/eslint-config-silvermine#39387feb42f5d78bf4947fbb7cb0727b5ea2bebe",
+      "@silvermine/standardization": "2.0.0",
+      "@silvermine/typescript-config": "git+https://github.com/silvermine/typescript-config#23213e33077089e723629dead5342abe6f3b3c8c",
       "@types/chai": "4.1.7",
       "@types/mocha": "5.2.5",
       "@types/node": "12.20.45",
@@ -41,28 +47,19 @@
       "chai": "4.2.0",
       "check-node-version": "4.0.2",
       "coveralls": "3.0.9",
-      "cz-conventional-changelog": "3.1.0",
-      "eslint": "6.8.0",
+      "eslint": "8.0.0",
       "grunt": "1.0.4",
       "grunt-cli": "1.3.2",
       "grunt-concurrent": "2.3.1",
       "grunt-contrib-clean": "2.0.0",
       "grunt-contrib-watch": "1.1.0",
-      "grunt-eslint": "24.0.0",
       "grunt-exec": "3.0.0",
       "mocha": "5.2.0",
       "nyc": "13.1.0",
       "sinon": "5.1.1",
       "source-map-support": "0.5.16",
-      "standard-version": "5.0.2",
       "ts-node": "7.0.1",
-      "tslib": "1.9.3",
+      "tslib": "2.6.2",
       "typescript": "3.9.5"
-   },
-   "dependencies": {},
-   "config": {
-      "commitizen": {
-         "path": "./node_modules/cz-conventional-changelog"
-      }
    }
 }

package/src/index.ts

@@ -4,6 +4,7 @@ export * from './types/Optional';
 export * from './types/PropsWithType';
 export * from './types/RequireDefined';
 export * from './types/RequireOptional';
+export * from './types/StrictUnion';
 export * from './types/StringArrayOfStringsMap';
 export * from './types/StringMap';
 export * from './types/StringUnknownMap';
@@ -27,8 +28,10 @@ export * from './utils/is-not-null-or-undefined';
 
 export * from './utils/chunk';
 export * from './utils/flatten';
+export * from './utils/pick';
 export * from './utils/pluck';
 export * from './utils/delay';
 export * from './utils/get';
 export * from './utils/escape-html';
 export * from './utils/make-template';
+export * from './utils/uniq';

package/src/types/StrictUnion.ts

@@ -0,0 +1,15 @@
+/* eslint-disable @typescript-eslint/no-type-alias */
+
+type UnionKeys<T> = T extends unknown ? keyof T : never;
+type InvalidKeys<K extends string | number | symbol> = { [P in K]?: never };
+type StrictUnionHelper<T, TAll> = T extends unknown ? (T & InvalidKeys<Exclude<UnionKeys<TAll>, keyof T>>) : never;
+
+/**
+ * A basic TypeScript union (e.g. A | B) results in a type containing the available
+ * properties from the provided types. When StrictUnion is used (e.g. StrictUnion<A | B>),
+ * the resulting type can only contain the properties from one of the types (e.g. all the
+ * properties from A, but none of the properties from B).
+ *
+ * See: https://github.com/microsoft/TypeScript/issues/20863#issuecomment-520551758
+ */
+export type StrictUnion<T> = StrictUnionHelper<T, T>;

package/src/utils/pick.ts

@@ -0,0 +1,24 @@
+import { isArray } from './is-array';
+
+// NOTE: If changing these types, ensure the following cases cause a type error:
+//
+// const noProps = pick({ a: 1 });
+//
+// noProps.a; // Property 'a' does not exist on type 'Pick<{ a: number; }, never>'.
+//
+// const emptyArr = pick({ a: 1 }, []);
+//
+// emptyArr.a; // Property 'a' does not exist on type 'Pick<{ a: number; }, never>'.
+
+export function pick<T extends object, K extends keyof T>(obj: T, props: K[]): Pick<T, K>;
+export function pick<T extends object, K extends keyof T = never>(obj: T, ...props: K[]): Pick<T, K>;
+export function pick<T extends object, K extends keyof T>(obj: T, ...args: K[] | [ K[] ]): Pick<T, K> {
+   const props = ((args.length === 1 && isArray(args[0])) ? args[0] : args) as K[];
+
+   return props.reduce((memo, prop) => {
+      if (prop in obj) {
+         memo[prop] = obj[prop];
+      }
+      return memo;
+   }, {} as Pick<T, K>);
+}

package/src/utils/uniq.ts

@@ -0,0 +1,59 @@
+const iterateeUniq = <T, U>(arr: T[], iteratee: (value: T, i: number, arr: T[]) => U): T[] => {
+   const result: T[] = [],
+         seen: U[] = [];
+
+   for (let i = 0, length = arr.length; i < length; i++) {
+      let value = arr[i],
+          computed = iteratee(value, i, arr);
+
+      if (seen.indexOf(computed) === -1) {
+         seen.push(computed);
+         result.push(value);
+      }
+   }
+   return result;
+};
+
+
+const sortedUniq = <T, U>(arr: T[]): T[] => {
+   const result: T[] = [];
+
+   let lastSeen: T | U | undefined;
+
+   for (let i = 0, length = arr.length; i < length; i++) {
+      let value = arr[i];
+
+      if (i === 0 || lastSeen !== value) {
+         result.push(value);
+      }
+      lastSeen = value;
+   }
+   return result;
+};
+
+
+const standardUniq = <T>(arr: T[]): T[] => {
+   const result = arr.filter((value, index, _arr) => {
+      return _arr.indexOf(value) === index;
+   });
+
+   return result;
+};
+
+
+/**
+ * Produce a duplicate-free version of the array. If the array has already
+ * been sorted, you have the option of using a faster algorithm.
+ * The faster algorithm will not work with an iteratee if the iteratee
+ * is not a one-to-one function, so providing an iteratee will disable
+ * the faster algorithm.
+ */
+export const uniq = <T, U>(arr: T[], isSorted?: boolean, iteratee?: (value: T, i: number, arr: T[]) => U): T[] => {
+   if (iteratee) {
+      return iterateeUniq(arr, iteratee);
+   }
+   if (isSorted) {
+      return sortedUniq(arr);
+   }
+   return standardUniq(arr);
+};