type-plus 4.0.2 → 4.3.0

package/README.md

@@ -326,6 +326,7 @@ nominalMatch(b1, b2) // false
 ## Functional Types
 
 - `ChainFn<T>: T`: chain function that returns the input type.
+- `compose(...fns): F`: compose functions
 
 ## Type Utilities
 
@@ -345,7 +346,7 @@ type No = IsAny<1, 'yes', 'no'> // 'no'
 
 - `CommonPropKeys<A>`: gets common keys inside the records in the array `A` (deprecate `CommonKeys`).
 - `Concat<A, B>`: `[...A, ...B]`.
-- `CreateTuple<L, T>`: creates `Tuple<T>` with `L` number of elements.
+- `CreateTuple<L, T>`: Creates `Tuple<T>` with `L` number of elements.
 - `DropFirst<A>`: drops the first value type of `A`.
 - `DropLast<A>`: drops the last value type of `A`.
 - `Filter<A, Criteria>`: gets the array of types satisfying `Criteria` in `A`.
@@ -354,13 +355,14 @@ type No = IsAny<1, 'yes', 'no'> // 'no'
 - `Head<A>`: gets the first entry in the array.
 - `IntersectOfProps<A, K>`: gets the intersect of `A[K]` types (deprecate `MapToProp`)
 - `IsArray<T>`: `logical` predicate for `Array`.
+- `Last<A>`: gets the last type of an array or tuple.
 - `literalArray(...entries)`: return an array whose items are restricted to the provided literals.
 - `PadLeft<A, Total, PadWith>`: pads `A` with `PadWith` if the length of `A` is less than `L`.
 - `reduceWhile()`: `reduce()` with predicate for early termination. \
   A simple version of the same function in the `ramda` package.
 - `Reverse<A>`: reverses the order of `A`.
 - `Some<A, Criteria>`: true if some elements in `A` matches `Criteria`.
-- `Tail<A>`: gets the remaining entries in the array except the first.
+- `Tail<A>`: Gets the types of a tuple except the first entry.
 - `UnionOfProps<A, K>`: gets the union of `A[K]` types (deprecate `PropUnion`).
 - `UnionOfValues<A>`: gets the union of value types in `A` (deprecate `ArrayValue`).
 
@@ -397,7 +399,7 @@ JSONTypes.get<string>(someJson, 'a', 'b', 1, 'c') // miku
 - `IsRecord<T>`: `logical` predicate for `Record`.
 - `KeysWithDiffTypes<A, B>`: gets the keys common in `A` and `B` but with different value type.
 - `mapKey()`: type adjusted map by key.
-- `reduceKey()`: type adjusted reduce by key.
+- `reduceByKey()`: type adjusted reduce by key.
 - `someKey()`: type adjusted some by key.
 - `SpreadRecord<A, B>`: type for `{...a, ...b}` when both `a` and `b` are `Record`. \
   for array, just do `[...A, ...B]`.
@@ -489,10 +491,11 @@ So you may encounter some weird behavior if your logic is complex.
 - `hasProperty(value, prop)`: assert `value` has property `prop`. This will pick the correct union type.
 - `isConstructor(subject)`: type guard `subject` is a constructor.
 - `isSystemError(code, err)`: type guard `err` with Nodejs error code.
-- `pick(obj, ...props)`: pick properties from `obj`.
 - `omit(obj, ...props)`: omit properties from `obj`.
+- `pick(obj, ...props)`: pick properties from `obj`.
 - `required(...)`: merge options and removing `Partial<T>`. From [`unpartial`](https://github.com/unional/unpartial)
 - `requiredDeep(...)`: merge options deeply and removing `Partial<T>`. From [`unpartial`](https://github.com/unional/unpartial)
+- `split(target, ...splitters)`: split one object into multiple objects.
 - `typeOverrideIncompatible<T>()`: override only the incompatible portion between two types.
 
 ```ts

package/cjs/array/CreateTuple.d.ts

@@ -1,4 +1,7 @@
 import { IsPositive } from '../math';
+/**
+ * Creates `Tuple<T>` with `L` number of elements.
+ */
 export declare type CreateTuple<L extends number, T = any> = IsPositive<L> extends true ? Device<[], L, T> : never;
 declare type Device<R extends any[], L extends number, T> = R['length'] extends L ? R : Device<[T, ...R], L, T>;
 export {};

package/cjs/array/Last.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Get the last type of an array or tuple.
+ */
+export declare type Last<T extends any[]> = T extends [...any[], infer R] ? R : T[0];

package/cjs/array/Last.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Last.js.map

package/cjs/array/Last.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Last.js","sourceRoot":"","sources":["../../ts/array/Last.ts"],"names":[],"mappings":""}

package/cjs/array/Tail.d.ts

@@ -1,2 +1,5 @@
 import { UnionOfValues } from './UnionOfValues';
+/**
+ * Gets the types of a tuple except the first entry.
+ */
 export declare type Tail<T extends any[]> = T['length'] extends 0 ? never : (T extends [any, ...infer Tail] ? (Tail extends UnionOfValues<T>[] ? Tail : never) : T);

package/cjs/array/index.d.ts

@@ -9,6 +9,7 @@ export type { FindLast } from './FindLast';
 export type { Head } from './Head';
 export type { IntersectOfProps, MapToProp } from './IntersectOfProps';
 export type { IsArray } from './IsArray';
+export type { Last } from './Last';
 export * from './literalArray';
 export type { PadLeft } from './PadLeft';
 export * from './reduceWhile';

package/cjs/array/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,iDAA8B;AAE9B,gDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAYA,iDAA8B;AAE9B,gDAA6B"}

package/cjs/functional/compose.d.ts

@@ -0,0 +1,6 @@
+import { Head, Last } from '../array';
+import { AnyFunction } from '../function/AnyFunction';
+/**
+ * compose functions
+ */
+export declare function compose<FS extends AnyFunction[]>(...fns: FS): (...args: Parameters<Head<FS>>) => ReturnType<Last<FS>>;

package/cjs/functional/compose.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compose = void 0;
+/**
+ * compose functions
+ */
+function compose() {
+    var fns = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        fns[_i] = arguments[_i];
+    }
+    return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return fns.reduce(function (args, fn) { return [fn.apply(void 0, args)]; }, args)[0];
+    };
+}
+exports.compose = compose;
+//# sourceMappingURL=compose.js.map

package/cjs/functional/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../ts/functional/compose.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,SAAgB,OAAO;IAA2B,aAAU;SAAV,UAAU,EAAV,qBAAU,EAAV,IAAU;QAAV,wBAAU;;IAC1D,OAAO;QAAC,cAAc;aAAd,UAAc,EAAd,qBAAc,EAAd,IAAc;YAAd,yBAAc;;QAAK,OAAA,GAAG,CAAC,MAAM,CAAC,UAAC,IAAI,EAAE,EAAE,IAAK,OAAA,CAAC,EAAE,eAAI,IAAI,EAAE,EAAb,CAAa,EAAE,IAAI,CAAC,CAAC,CAAC,CAAQ;IAAvD,CAAuD,CAAA;AACpF,CAAC;AAFD,0BAEC"}

package/cjs/functional/index.d.ts

@@ -1 +1,2 @@
 export type { ChainFn, EndoFn } from './ChainFn';
+export * from './compose';

package/cjs/functional/index.js

@@ -1,3 +1,18 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./compose"), exports);
 //# sourceMappingURL=index.js.map

package/cjs/functional/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,4CAAyB"}

package/cjs/object/index.d.ts

@@ -19,7 +19,7 @@ export * from './mapKey';
 export * from './mapProperties';
 export * from './omit';
 export type { OptionalKeys } from './OptionalKeys';
-export type { PartialOmit, PartialPick, PartialExcept } from './Partial';
+export type { PartialExcept, PartialOmit, PartialPick } from './Partial';
 export * from './pick';
 export type { RecursiveIntersect } from './RecursiveIntersect';
 export type { RecursivePartial } from './RecursivePartial';
@@ -29,6 +29,7 @@ export * from './replaceProperty';
 export type { RequiredExcept, RequiredPick } from './Required';
 export type { RequiredKeys } from './RequiredKeys';
 export * from './someKey';
+export * from './split';
 export type { SpreadRecord } from './SpreadRecord';
 export * from './typeOverrideIncompatible';
 export type { ValueOf } from './ValueOf';

package/cjs/object/index.js

@@ -29,5 +29,6 @@ __exportStar(require("./pick"), exports);
 __exportStar(require("./reduceKey"), exports);
 __exportStar(require("./replaceProperty"), exports);
 __exportStar(require("./someKey"), exports);
+__exportStar(require("./split"), exports);
 __exportStar(require("./typeOverrideIncompatible"), exports);
 //# sourceMappingURL=index.js.map

package/cjs/object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/object/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,6CAA0B;AAE1B,2CAAwB;AACxB,8CAA2B;AAC3B,4CAAyB;AACzB,+CAA4B;AAC5B,6CAA0B;AAC1B,2CAAwB;AACxB,gDAA6B;AAO7B,2CAAwB;AACxB,kDAA+B;AAC/B,yCAAsB;AAGtB,yCAAsB;AAItB,8CAA2B;AAC3B,oDAAiC;AAGjC,4CAAyB;AAEzB,6DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/object/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,6CAA0B;AAE1B,2CAAwB;AACxB,8CAA2B;AAC3B,4CAAyB;AACzB,+CAA4B;AAC5B,6CAA0B;AAC1B,2CAAwB;AACxB,gDAA6B;AAO7B,2CAAwB;AACxB,kDAA+B;AAC/B,yCAAsB;AAGtB,yCAAsB;AAItB,8CAA2B;AAC3B,oDAAiC;AAGjC,4CAAyB;AACzB,0CAAuB;AAEvB,6DAA0C"}

package/cjs/object/split.d.ts

@@ -0,0 +1,84 @@
+import { AnyRecord, Omit } from '..';
+declare type Splitter<T extends AnyRecord> = Partial<{
+    [k in keyof T]: T[k] | undefined;
+}>;
+declare type Split<T extends AnyRecord, S extends AnyRecord> = {
+    [k in keyof S]: NonNullable<T[k]> | S[k];
+};
+/**
+ * Split an object into multiple objects.
+ * @returns [...entries, remaining]
+ */
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>>(target: T, split1: S1): [
+    Split<T, S1>,
+    Omit<T, keyof S1>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>>(target: T, split1: S1, split2: S2): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Omit<T, keyof S1 | keyof S2>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>, S5 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4, splitter5: S5): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>, S5 extends Splitter<T>, S6 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4, splitter5: S5, splitter6: S6): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>, S5 extends Splitter<T>, S6 extends Splitter<T>, S7 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4, splitter5: S5, splitter6: S6, splitter7: S7): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>, S5 extends Splitter<T>, S6 extends Splitter<T>, S7 extends Splitter<T>, S8 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4, splitter5: S5, splitter6: S6, splitter7: S7, splitter8: S8): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Split<T, S8>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7 | keyof S8>
+];
+export declare function split<T extends AnyRecord, S1 extends Splitter<T>, S2 extends Splitter<T>, S3 extends Splitter<T>, S4 extends Splitter<T>, S5 extends Splitter<T>, S6 extends Splitter<T>, S7 extends Splitter<T>, S8 extends Splitter<T>, S9 extends Splitter<T>>(target: T, splitter1: S1, splitter2: S2, splitter3: S3, splitter4: S4, splitter5: S5, splitter6: S6, splitter7: S7, splitter8: S8, splitter9: S9): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Split<T, S8>,
+    Split<T, S9>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7 | keyof S8 | keyof S9>
+];
+export {};

package/cjs/object/split.js

@@ -0,0 +1,25 @@
+"use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.split = void 0;
+var __1 = require("..");
+function split(target) {
+    var splitters = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        splitters[_i - 1] = arguments[_i];
+    }
+    var keyMap = {};
+    var s = splitters.map(function (s) { return (0, __1.reduceByKey)(s, function (p, k) { var _a; return (keyMap[k] = true, p[k] = (_a = target[k]) !== null && _a !== void 0 ? _a : s[k], p); }, {}); });
+    var r = (0, __1.reduceByKey)(target, function (p, k) { return keyMap[k] ? p : (p[k] = target[k], p); }, {});
+    return __spreadArray(__spreadArray([], s, true), [r], false);
+}
+exports.split = split;
+//# sourceMappingURL=split.js.map

package/cjs/object/split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.js","sourceRoot":"","sources":["../../ts/object/split.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wBAAiD;AA6LjD,SAAgB,KAAK,CAAC,MAAiB;IAAE,mBAAyB;SAAzB,UAAyB,EAAzB,qBAAyB,EAAzB,IAAyB;QAAzB,kCAAyB;;IAChE,IAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,IAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,UAAA,CAAC,IAAI,OAAA,IAAA,eAAW,EAAC,CAAC,EAAE,UAAC,CAAC,EAAE,CAAC,YAAK,OAAA,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA,EAAA,EAAE,EAAe,CAAC,EAA1F,CAA0F,CAAC,CAAA;IACxH,IAAM,CAAC,GAAG,IAAA,eAAW,EAAC,MAAM,EAAE,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAArC,CAAqC,EAAE,EAAe,CAAC,CAAA;IAC/F,uCAAW,CAAC,UAAE,CAAC,UAAC;AAClB,CAAC;AALD,sBAKC"}

package/esm/array/Last.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Last.js.map

package/esm/array/Last.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Last.js","sourceRoot":"","sources":["../../ts/array/Last.ts"],"names":[],"mappings":""}

package/esm/array/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/array/index.ts"],"names":[],"mappings":"AAWA,cAAc,gBAAgB,CAAA;AAE9B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/array/index.ts"],"names":[],"mappings":"AAYA,cAAc,gBAAgB,CAAA;AAE9B,cAAc,eAAe,CAAA"}

package/esm/functional/compose.js

@@ -0,0 +1,7 @@
+/**
+ * compose functions
+ */
+export function compose(...fns) {
+    return (...args) => fns.reduce((args, fn) => [fn(...args)], args)[0];
+}
+//# sourceMappingURL=compose.js.map

package/esm/functional/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../ts/functional/compose.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,OAAO,CAA2B,GAAG,GAAO;IAC1D,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAQ,CAAA;AACpF,CAAC"}

package/esm/functional/index.js

@@ -1,2 +1,2 @@
-export {};
+export * from './compose';
 //# sourceMappingURL=index.js.map

package/esm/functional/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AAEA,cAAc,WAAW,CAAA"}

package/esm/object/index.js

@@ -13,5 +13,6 @@ export * from './pick';
 export * from './reduceKey';
 export * from './replaceProperty';
 export * from './someKey';
+export * from './split';
 export * from './typeOverrideIncompatible';
 //# sourceMappingURL=index.js.map

package/esm/object/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/object/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAE1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAO7B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,QAAQ,CAAA;AAGtB,cAAc,QAAQ,CAAA;AAItB,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,WAAW,CAAA;AAEzB,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/object/index.ts"],"names":[],"mappings":"AAEA,cAAc,YAAY,CAAA;AAE1B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAO7B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,QAAQ,CAAA;AAGtB,cAAc,QAAQ,CAAA;AAItB,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AAEvB,cAAc,4BAA4B,CAAA"}

package/esm/object/split.js

@@ -0,0 +1,8 @@
+import { reduceByKey } from '..';
+export function split(target, ...splitters) {
+    const keyMap = {};
+    const s = splitters.map(s => reduceByKey(s, (p, k) => (keyMap[k] = true, p[k] = target[k] ?? s[k], p), {}));
+    const r = reduceByKey(target, (p, k) => keyMap[k] ? p : (p[k] = target[k], p), {});
+    return [...s, r];
+}
+//# sourceMappingURL=split.js.map

package/esm/object/split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.js","sourceRoot":"","sources":["../../ts/object/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,IAAI,CAAA;AA6LjD,MAAM,UAAU,KAAK,CAAC,MAAiB,EAAE,GAAG,SAAsB;IAChE,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAe,CAAC,CAAC,CAAA;IACxH,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAe,CAAC,CAAA;IAC/F,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "type-plus",
-  "version": "4.0.2",
+  "version": "4.3.0",
   "description": "Provides additional types for `typescript`.",
   "homepage": "https://github.com/unional/type-plus",
   "bugs": {

package/ts/array/CreateTuple.ts

@@ -1,7 +1,10 @@
-import { IsPositive } from '../math'
-
-export type CreateTuple<L extends number, T = any> =
-  IsPositive<L> extends true ? Device<[], L, T> : never
-
-type Device<R extends any[], L extends number, T> =
-  R['length'] extends L ? R : Device<[T, ...R], L, T>
+import { IsPositive } from '../math'
+
+/**
+ * Creates `Tuple<T>` with `L` number of elements.
+ */
+export type CreateTuple<L extends number, T = any> =
+  IsPositive<L> extends true ? Device<[], L, T> : never
+
+type Device<R extends any[], L extends number, T> =
+  R['length'] extends L ? R : Device<[T, ...R], L, T>

package/ts/array/Last.spec.ts

@@ -0,0 +1,32 @@
+import { AnyFunction, isType } from '..'
+import { Last } from './Last'
+
+test('any array', () => {
+  type A = Last<any[]>
+  isType.equal<true, any, A>()
+})
+
+test('never array', () => {
+  type A = Last<never[]>
+  isType.equal<true, never, A>()
+})
+
+test('typed array', () => {
+  type A = Last<string[]>
+  isType.equal<true, string, A>()
+})
+
+test('function array', () => {
+  type A = Last<AnyFunction[]>
+  isType.equal<true, AnyFunction, A>()
+})
+
+test('empty tuple gets undefined', () => {
+  type A = Last<[]>
+  isType.equal<true, undefined, A>()
+})
+
+test('tuple with function', () => {
+  type A = Last<[number, AnyFunction]>
+  isType.equal<true, AnyFunction, A>()
+})

package/ts/array/Last.ts

@@ -0,0 +1,4 @@
+/**
+ * Get the last type of an array or tuple.
+ */
+export type Last<T extends any[]> = T extends [...any[], infer R] ? R : T[0]

package/ts/array/Tail.spec.ts

@@ -1,32 +1,32 @@
-import { isType, Tail } from '..'
-
-test('get tail types', () => {
-  type S = [1, 'a', 'b']
-  type A = Tail<S>
-
-  isType.equal<true, ['a', 'b'], A>()
-})
-
-test('empty tuple gets never', () => {
-  type S = []
-  type A = Tail<S>
-
-  isType.equal<true, never, A>()
-})
-
-test('array gets same type', () => {
-  type A = Tail<string[]>
-
-  isType.equal<true, string[], A>()
-})
-
-test('union array', () => {
-  type A = Tail<Array<string | boolean>>
-
-  isType.equal<true, Array<string | boolean>, A>()
-})
-
-test('tuple with rest', () => {
-  type A = Tail<[number, ...string[]]>
-  isType.equal<true, string[], A>()
-})
+import { isType, Tail } from '..'
+
+test('get tail types', () => {
+  type S = [1, 'a', 'b']
+  type A = Tail<S>
+
+  isType.equal<true, ['a', 'b'], A>()
+})
+
+test('empty tuple gets never', () => {
+  type S = []
+  type A = Tail<S>
+
+  isType.equal<true, never, A>()
+})
+
+test('array gets same type', () => {
+  type A = Tail<string[]>
+
+  isType.equal<true, string[], A>()
+})
+
+test('union array', () => {
+  type A = Tail<Array<string | boolean>>
+
+  isType.equal<true, Array<string | boolean>, A>()
+})
+
+test('tuple with rest', () => {
+  type A = Tail<[number, ...string[]]>
+  isType.equal<true, string[], A>()
+})

package/ts/array/Tail.ts

@@ -1,7 +1,10 @@
-import { UnionOfValues } from './UnionOfValues'
-
-export type Tail<T extends any[]> = T['length'] extends 0
-  ? never
-  : (T extends [any, ...infer Tail]
-    ? (Tail extends UnionOfValues<T>[] ? Tail : never)
-    : T)
+import { UnionOfValues } from './UnionOfValues'
+
+/**
+ * Gets the types of a tuple except the first entry.
+ */
+export type Tail<T extends any[]> = T['length'] extends 0
+  ? never
+  : (T extends [any, ...infer Tail]
+    ? (Tail extends UnionOfValues<T>[] ? Tail : never)
+    : T)

package/ts/array/index.ts

@@ -9,6 +9,7 @@ export type { FindLast } from './FindLast'
 export type { Head } from './Head'
 export type { IntersectOfProps, MapToProp } from './IntersectOfProps'
 export type { IsArray } from './IsArray'
+export type { Last } from './Last'
 export * from './literalArray'
 export type { PadLeft } from './PadLeft'
 export * from './reduceWhile'

package/ts/functional/compose.spec.ts

@@ -0,0 +1,32 @@
+import { compose, isType } from '..'
+
+test('works with endofunctors: +2 *3', () => {
+  const plus2 = (x: number) => x + 2
+  const multiply3 = (x: number) => x * 3
+
+  const a = compose(plus2, multiply3)
+
+  isType.equal<true, (a: number) => number, typeof a>()
+  expect(a(2)).toBe(12)
+})
+
+test('cross types', () => {
+  const n2s = (n: number) => '' + n
+  const len1 = (s: string) => s.length === 1
+
+  const isSingleDigit = compose(n2s, len1)
+
+  isType.equal<true, (n: number) => boolean, typeof isSingleDigit>()
+  expect(isSingleDigit(1)).toBe(true)
+  expect(isSingleDigit(10)).toBe(false)
+})
+
+test('multiple params first function', () => {
+  const add = (a: number, b: number) => a + b
+  const multiply3 = (x: number) => x * 3
+
+  const a = compose(add, multiply3)
+
+  isType.equal<true, (a: number, b: number) => number, typeof a>()
+  expect(a(2, 2)).toBe(12)
+})

package/ts/functional/compose.ts

@@ -0,0 +1,9 @@
+import { Head, Last } from '../array'
+import { AnyFunction } from '../function/AnyFunction'
+
+/**
+ * compose functions
+ */
+export function compose<FS extends AnyFunction[]>(...fns: FS): (...args: Parameters<Head<FS>>) => ReturnType<Last<FS>> {
+  return (...args: any[]) => fns.reduce((args, fn) => [fn(...args)], args)[0] as any
+}

package/ts/functional/index.ts

@@ -1,2 +1,3 @@
 // export * from './Maybe'
 export type { ChainFn, EndoFn } from './ChainFn'
+export * from './compose'

package/ts/object/index.ts

@@ -19,7 +19,7 @@ export * from './mapKey'
 export * from './mapProperties'
 export * from './omit'
 export type { OptionalKeys } from './OptionalKeys'
-export type { PartialOmit, PartialPick, PartialExcept } from './Partial'
+export type { PartialExcept, PartialOmit, PartialPick } from './Partial'
 export * from './pick'
 export type { RecursiveIntersect } from './RecursiveIntersect'
 export type { RecursivePartial } from './RecursivePartial'
@@ -29,7 +29,7 @@ export * from './replaceProperty'
 export type { RequiredExcept, RequiredPick } from './Required'
 export type { RequiredKeys } from './RequiredKeys'
 export * from './someKey'
+export * from './split'
 export type { SpreadRecord } from './SpreadRecord'
 export * from './typeOverrideIncompatible'
 export type { ValueOf } from './ValueOf'
-

package/ts/object/split.spec.ts

@@ -0,0 +1,54 @@
+import { isType, split } from '..'
+
+const target = { a: 0, b: '', c: false }
+test('can use undefined as default', () => {
+  const [{ a }] = split(target, { a: undefined })
+
+  isType.equal<true, typeof a, number | undefined>()
+  expect(a).toBe(0)
+})
+
+test('can specify default with the same type', () => {
+  const [{ a }] = split(target, { a: 2 })
+
+  isType.equal<true, typeof a, number>()
+  expect(a).toBe(0)
+})
+
+test('can specify default as one of the intersect types', () => {
+  const [a] = split({ a: undefined as number | string | undefined }, { a: '2' })
+
+  isType.equal<true, typeof a, { a: number | string }>()
+  expect(a).toEqual({ a: '2' })
+})
+
+test('get remaining props in the last entry', () => {
+  const [, r] = split(target, { a: undefined })
+
+  isType.equal<true, typeof r, { b: string, c: boolean }>()
+  expect(r).toEqual({ b: '', c: false })
+})
+
+test('work with simple Record', () => {
+  const [a] = split({} as Record<string, string>, { a: 'a' })
+
+  isType.equal<true, typeof a, { a: string }>()
+  expect(a).toEqual({ a: 'a' })
+})
+
+test('can specify multiple splitters', () => {
+  const t = { r: 'r' } as { a?: string, b?: string, c?: string, r?: string }
+  const [a, b, c, r] = split(t,
+    { a: 'a' },
+    { b: 'b' },
+    { c: 'c' }
+  )
+  isType.equal<true, typeof a, { a: string }>()
+  isType.equal<true, typeof b, { b: string }>()
+  isType.equal<true, typeof c, { c: string }>()
+  isType.equal<true, typeof r, { r?: string | undefined }>()
+  expect(a).toEqual({ a: 'a' })
+  expect(b).toEqual({ b: 'b' })
+  expect(c).toEqual({ c: 'c' })
+  expect(r).toEqual({ r: 'r' })
+})

package/ts/object/split.ts

@@ -0,0 +1,195 @@
+import { AnyRecord, Omit, reduceByKey } from '..'
+
+type Splitter<T extends AnyRecord> = Partial<{ [k in keyof T]: T[k] | undefined }>
+type Split<T extends AnyRecord, S extends AnyRecord> = { [k in keyof S]: NonNullable<T[k]> | S[k] }
+
+/**
+ * Split an object into multiple objects.
+ * @returns [...entries, remaining]
+ */
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>
+>(target: T, split1: S1): [
+    Split<T, S1>,
+    Omit<T, keyof S1>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  >(target: T, split1: S1, split2: S2): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Omit<T, keyof S1 | keyof S2>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  >(target: T, splitter1: S1, splitter2: S2, splitter3: S3): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  S5 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+    splitter5: S5,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  S5 extends Splitter<T>,
+  S6 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+    splitter5: S5,
+    splitter6: S6,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  S5 extends Splitter<T>,
+  S6 extends Splitter<T>,
+  S7 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+    splitter5: S5,
+    splitter6: S6,
+    splitter7: S7,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  S5 extends Splitter<T>,
+  S6 extends Splitter<T>,
+  S7 extends Splitter<T>,
+  S8 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+    splitter5: S5,
+    splitter6: S6,
+    splitter7: S7,
+    splitter8: S8,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Split<T, S8>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7 | keyof S8>
+  ]
+export function split<
+  T extends AnyRecord,
+  S1 extends Splitter<T>,
+  S2 extends Splitter<T>,
+  S3 extends Splitter<T>,
+  S4 extends Splitter<T>,
+  S5 extends Splitter<T>,
+  S6 extends Splitter<T>,
+  S7 extends Splitter<T>,
+  S8 extends Splitter<T>,
+  S9 extends Splitter<T>,
+  >(target: T,
+    splitter1: S1,
+    splitter2: S2,
+    splitter3: S3,
+    splitter4: S4,
+    splitter5: S5,
+    splitter6: S6,
+    splitter7: S7,
+    splitter8: S8,
+    splitter9: S9,
+): [
+    Split<T, S1>,
+    Split<T, S2>,
+    Split<T, S3>,
+    Split<T, S4>,
+    Split<T, S5>,
+    Split<T, S6>,
+    Split<T, S7>,
+    Split<T, S8>,
+    Split<T, S9>,
+    Omit<T, keyof S1 | keyof S2 | keyof S3 | keyof S4 | keyof S5 | keyof S6 | keyof S7 | keyof S8 | keyof S9>
+  ]
+export function split(target: AnyRecord, ...splitters: AnyRecord[]): AnyRecord[] {
+  const keyMap: AnyRecord = {}
+  const s = splitters.map(s => reduceByKey(s, (p, k) => (keyMap[k] = true, p[k] = target[k] ?? s[k], p), {} as AnyRecord))
+  const r = reduceByKey(target, (p, k) => keyMap[k] ? p : (p[k] = target[k], p), {} as AnyRecord)
+  return [...s, r]
+}