type-plus 5.3.0 → 5.4.1

package/README.md

@@ -564,6 +564,20 @@ nominalMatch(b1, b2) // false
 - `ChainFn<T>: T`: chain function that returns the input type.
 - `compose(...fns): F`: compose functions
 
+## Context Builder
+
+- `context()`: a context builder. This is useful to build context for functional programming.\
+  It is a sync version of the `AsyncContext` from [async-fp](https://unional/async-fp).
+
+```ts
+import { context } from 'type-plus'
+
+// { a: 1, b: 2 }
+const ctx = context({ a: 1 })
+  .extend(c => ({ b: c.a + 1 }))
+  .build()
+```
+
 ## Attribution
 
 Some code in this library is created by other people in the TypeScript community.

package/cjs/assertion/assertType.d.ts

@@ -22,9 +22,9 @@ export declare namespace assertType {
     var noFalse: <S>(subject: Exclude<S, false>) => void;
     var isString: (subject: string) => asserts subject is string;
     var noString: <S>(subject: Exclude<S, string>) => void;
-    var isFunction: (subject: AnyFunction) => asserts subject is AnyFunction;
-    var noFunction: <S>(subject: Exclude<S, AnyFunction>) => void;
-    var isConstructor: (subject: AnyConstructor) => asserts subject is AnyConstructor;
+    var isFunction: (subject: AnyFunction<any[], any>) => asserts subject is AnyFunction<any[], any>;
+    var noFunction: <S>(subject: Exclude<S, AnyFunction<any[], any>>) => void;
+    var isConstructor: (subject: AnyConstructor<any[]>) => asserts subject is AnyConstructor<any[]>;
     var isError: (subject: Error) => asserts subject is Error;
     var noError: <S>(subject: Exclude<S, Error>) => void;
     var isNever: (subject: never) => asserts subject is never;

package/cjs/functional/context.d.ts

@@ -0,0 +1,36 @@
+import type { LeftJoin } from '../object/index.js';
+export type ContextBaseShape = Record<string | symbol, any>;
+/**
+ * Extends the context with new props.
+ * @param context the current context.
+ * @return an additional context with new properties.
+ */
+export type ContextExtender<Current, Additional> = (context: Current) => Additional;
+export type ContextBuilder<Init extends ContextBaseShape, Ctx extends ContextBaseShape> = {
+    /**
+     * Extends the context using an extender.
+     * @param extender function that add new props to the context.
+     *
+     * The extender only need to return a new object with new properties.
+     *
+     * Do not need to merge the existing context with the new props.
+     * The builder will do that for you.
+     */
+    extend<Current extends ContextBaseShape = Ctx, Additional extends ContextBaseShape = ContextBaseShape>(extender: ContextExtender<Current, Additional>): ContextBuilder<Init, LeftJoin<Ctx, Additional>>;
+    /**
+     * Build and return the context.
+     */
+    build(): Ctx;
+};
+/**
+ * A fluent context builder.
+ *
+ * The initializer and transformer
+ *
+ * @param init The initial context or an context initializer.
+ * @return the context builder where you can
+ * use `extend()` to add context, and
+ * use `build()` to build the context.
+ */
+export declare function context<Init extends ContextBaseShape, Ctx extends ContextBaseShape = Init>(init?: Init | (() => Init)): ContextBuilder<Init, Ctx>;
+//# sourceMappingURL=context.d.ts.map

package/cjs/functional/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../ts/functional/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,OAAO,EACP,UAAU,IACR,CAAC,OAAO,EAAE,OAAO,KAAK,UAAU,CAAA;AAEpC,MAAM,MAAM,cAAc,CACxB,IAAI,SAAS,gBAAgB,EAC7B,GAAG,SAAS,gBAAgB,IAC1B;IACF;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAO,SAAS,gBAAgB,GAAG,GAAG,EACtC,UAAU,SAAS,gBAAgB,GAAG,gBAAgB,EACtD,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,GAC5C,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACpD;;OAEG;IACH,KAAK,IAAI,GAAG,CAAA;CACb,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,IAAI,SAAS,gBAAgB,EAC7B,GAAG,SAAS,gBAAgB,GAAG,IAAI,EACnC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAKvD"}

package/cjs/functional/context.js

@@ -0,0 +1,43 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.context = void 0;
+/**
+ * A fluent context builder.
+ *
+ * The initializer and transformer
+ *
+ * @param init The initial context or an context initializer.
+ * @return the context builder where you can
+ * use `extend()` to add context, and
+ * use `build()` to build the context.
+ */
+function context(init) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return typeof init === 'function'
+        ? contextBuilder({}, [init])
+        : contextBuilder(init !== null && init !== void 0 ? init : {}, []);
+}
+exports.context = context;
+function contextBuilder(init, transformers) {
+    return {
+        extend: function (transformer) {
+            return contextBuilder(init, transformers.concat(transformer));
+        },
+        build: function () {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return transformers.reduce(function (p, t) { return (__assign(__assign({}, p), t(p))); }, init);
+        }
+    };
+}
+//# sourceMappingURL=context.js.map

package/cjs/functional/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../ts/functional/context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAsCA;;;;;;;;;GASG;AACH,SAAgB,OAAO,CAGrB,IAA0B;IAC1B,+DAA+D;IAC/D,OAAO,OAAO,IAAI,KAAK,UAAU;QAC/B,CAAC,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,cAAc,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,EAAE,EAAE,EAAE,CAAQ,CAAA;AAC3C,CAAC;AARD,0BAQC;AAED,SAAS,cAAc,CAAC,IAAsB,EAAE,YAAyC;IACvF,OAAO;QACL,MAAM,YAAC,WAAsC;YAC3C,OAAO,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;QAC/D,CAAC;QACD,KAAK;YACH,+DAA+D;YAC/D,OAAO,YAAY,CAAC,MAAM,CAAC,UAAC,CAAC,EAAE,CAAC,IAAK,OAAA,uBAAM,CAAC,GAAK,CAAC,CAAC,CAAC,CAAC,EAAG,EAAnB,CAAmB,EAAE,IAAI,CAAC,CAAA;QACjE,CAAC;KACF,CAAA;AACH,CAAC"}

package/cjs/functional/context.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.spec.d.ts.map

package/cjs/functional/context.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.spec.d.ts","sourceRoot":"","sources":["../../ts/functional/context.spec.ts"],"names":[],"mappings":""}

package/cjs/functional/context.spec.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var index_js_1 = require("../index.js");
+describe("".concat(index_js_1.context.name, "()"), function () {
+    it('allows no param', function () {
+        var r = (0, index_js_1.context)().build();
+        expect(r).toEqual({});
+    });
+    it('accepts an initial context value', function () {
+        var r = (0, index_js_1.context)({ a: 1 }).build();
+        index_js_1.isType.equal();
+        expect(r).toEqual({ a: 1 });
+    });
+    it('accepts an initializer', function () {
+        var r = (0, index_js_1.context)(function () { return ({ a: 1 }); }).build();
+        index_js_1.isType.equal();
+        expect(r).toEqual({ a: 1 });
+    });
+    it('accepts transformer expecting Init', function () {
+        var r = (0, index_js_1.context)({ a: 1 })
+            .extend(function (ctx) {
+            index_js_1.isType.equal();
+            expect(ctx).toEqual({ a: 1 });
+            return { b: ctx.a + 1 };
+        })
+            .build();
+        index_js_1.isType.equal();
+        expect(r).toEqual({ a: 1, b: 2 });
+    });
+    it('provides the combined context to the next transformer', function () {
+        var r = (0, index_js_1.context)({ a: 1 })
+            .extend(function (ctx) { return ({ b: ctx.a + 1 }); })
+            .extend(function (ctx) { return ({ c: ctx.a + ctx.b }); })
+            .build();
+        index_js_1.isType.equal();
+        expect(r).toEqual({ a: 1, b: 2, c: 3 });
+    });
+    it('accepts extenders needing partial of current context', function () {
+        function foo(ctx) {
+            return { c: ctx.a + 2 };
+        }
+        var r = (0, index_js_1.context)({ a: 1, b: 2 }).extend(foo).build();
+        index_js_1.isType.equal();
+        expect(r).toEqual({ a: 1, b: 2, c: 3 });
+    });
+});
+//# sourceMappingURL=context.spec.js.map

package/cjs/functional/context.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.spec.js","sourceRoot":"","sources":["../../ts/functional/context.spec.ts"],"names":[],"mappings":"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"}

package/cjs/functional/index.d.ts

@@ -1,3 +1,4 @@
 export type { ChainFn, EndoFn } from './ChainFn.js';
 export * from './compose.js';
+export * from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/cjs/functional/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/cjs/functional/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./compose.js"), exports);
+__exportStar(require("./context.js"), 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":";;;;;;;;;;;;;;;;AAEA,+CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,+CAA4B;AAC5B,+CAA4B"}

package/cjs/predicates/isType.d.ts

@@ -10,6 +10,6 @@ export declare function isType<T>(subject: unknown, validator: (s: T) => unknown
 export declare namespace isType {
     var t: <T extends true>(subject?: T | undefined) => boolean;
     var f: <T extends false>(subject?: T | undefined) => boolean;
-    var equal: <C extends Equal<A, B>, A, B>() => void;
+    var equal: <C extends Equal<A, B, true, false>, A, B>() => void;
 }
 //# sourceMappingURL=isType.d.ts.map

package/esm/assertion/assertType.d.ts

@@ -22,9 +22,9 @@ export declare namespace assertType {
     var noFalse: <S>(subject: Exclude<S, false>) => void;
     var isString: (subject: string) => asserts subject is string;
     var noString: <S>(subject: Exclude<S, string>) => void;
-    var isFunction: (subject: AnyFunction) => asserts subject is AnyFunction;
-    var noFunction: <S>(subject: Exclude<S, AnyFunction>) => void;
-    var isConstructor: (subject: AnyConstructor) => asserts subject is AnyConstructor;
+    var isFunction: (subject: AnyFunction<any[], any>) => asserts subject is AnyFunction<any[], any>;
+    var noFunction: <S>(subject: Exclude<S, AnyFunction<any[], any>>) => void;
+    var isConstructor: (subject: AnyConstructor<any[]>) => asserts subject is AnyConstructor<any[]>;
     var isError: (subject: Error) => asserts subject is Error;
     var noError: <S>(subject: Exclude<S, Error>) => void;
     var isNever: (subject: never) => asserts subject is never;

package/esm/functional/context.d.ts

@@ -0,0 +1,36 @@
+import type { LeftJoin } from '../object/index.js';
+export type ContextBaseShape = Record<string | symbol, any>;
+/**
+ * Extends the context with new props.
+ * @param context the current context.
+ * @return an additional context with new properties.
+ */
+export type ContextExtender<Current, Additional> = (context: Current) => Additional;
+export type ContextBuilder<Init extends ContextBaseShape, Ctx extends ContextBaseShape> = {
+    /**
+     * Extends the context using an extender.
+     * @param extender function that add new props to the context.
+     *
+     * The extender only need to return a new object with new properties.
+     *
+     * Do not need to merge the existing context with the new props.
+     * The builder will do that for you.
+     */
+    extend<Current extends ContextBaseShape = Ctx, Additional extends ContextBaseShape = ContextBaseShape>(extender: ContextExtender<Current, Additional>): ContextBuilder<Init, LeftJoin<Ctx, Additional>>;
+    /**
+     * Build and return the context.
+     */
+    build(): Ctx;
+};
+/**
+ * A fluent context builder.
+ *
+ * The initializer and transformer
+ *
+ * @param init The initial context or an context initializer.
+ * @return the context builder where you can
+ * use `extend()` to add context, and
+ * use `build()` to build the context.
+ */
+export declare function context<Init extends ContextBaseShape, Ctx extends ContextBaseShape = Init>(init?: Init | (() => Init)): ContextBuilder<Init, Ctx>;
+//# sourceMappingURL=context.d.ts.map

package/esm/functional/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../ts/functional/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,OAAO,EACP,UAAU,IACR,CAAC,OAAO,EAAE,OAAO,KAAK,UAAU,CAAA;AAEpC,MAAM,MAAM,cAAc,CACxB,IAAI,SAAS,gBAAgB,EAC7B,GAAG,SAAS,gBAAgB,IAC1B;IACF;;;;;;;;OAQG;IACH,MAAM,CACJ,OAAO,SAAS,gBAAgB,GAAG,GAAG,EACtC,UAAU,SAAS,gBAAgB,GAAG,gBAAgB,EACtD,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,GAC5C,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IACpD;;OAEG;IACH,KAAK,IAAI,GAAG,CAAA;CACb,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,IAAI,SAAS,gBAAgB,EAC7B,GAAG,SAAS,gBAAgB,GAAG,IAAI,EACnC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAKvD"}

package/esm/functional/context.js

@@ -0,0 +1,28 @@
+/**
+ * A fluent context builder.
+ *
+ * The initializer and transformer
+ *
+ * @param init The initial context or an context initializer.
+ * @return the context builder where you can
+ * use `extend()` to add context, and
+ * use `build()` to build the context.
+ */
+export function context(init) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return typeof init === 'function'
+        ? contextBuilder({}, [init])
+        : contextBuilder(init ?? {}, []);
+}
+function contextBuilder(init, transformers) {
+    return {
+        extend(transformer) {
+            return contextBuilder(init, transformers.concat(transformer));
+        },
+        build() {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+            return transformers.reduce((p, t) => ({ ...p, ...t(p) }), init);
+        }
+    };
+}
+//# sourceMappingURL=context.js.map

package/esm/functional/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../ts/functional/context.ts"],"names":[],"mappings":"AAsCA;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAGrB,IAA0B;IAC1B,+DAA+D;IAC/D,OAAO,OAAO,IAAI,KAAK,UAAU;QAC/B,CAAC,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,cAAc,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAQ,CAAA;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,IAAsB,EAAE,YAAyC;IACvF,OAAO;QACL,MAAM,CAAC,WAAsC;YAC3C,OAAO,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAA;QAC/D,CAAC;QACD,KAAK;YACH,+DAA+D;YAC/D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;QACjE,CAAC;KACF,CAAA;AACH,CAAC"}

package/esm/functional/context.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.spec.d.ts.map

package/esm/functional/context.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.spec.d.ts","sourceRoot":"","sources":["../../ts/functional/context.spec.ts"],"names":[],"mappings":""}

package/esm/functional/context.spec.js

@@ -0,0 +1,45 @@
+import { context, isType } from '../index.js';
+describe(`${context.name}()`, () => {
+    it('allows no param', () => {
+        const r = context().build();
+        expect(r).toEqual({});
+    });
+    it('accepts an initial context value', () => {
+        const r = context({ a: 1 }).build();
+        isType.equal();
+        expect(r).toEqual({ a: 1 });
+    });
+    it('accepts an initializer', () => {
+        const r = context(() => ({ a: 1 })).build();
+        isType.equal();
+        expect(r).toEqual({ a: 1 });
+    });
+    it('accepts transformer expecting Init', () => {
+        const r = context({ a: 1 })
+            .extend(ctx => {
+            isType.equal();
+            expect(ctx).toEqual({ a: 1 });
+            return { b: ctx.a + 1 };
+        })
+            .build();
+        isType.equal();
+        expect(r).toEqual({ a: 1, b: 2 });
+    });
+    it('provides the combined context to the next transformer', () => {
+        const r = context({ a: 1 })
+            .extend(ctx => ({ b: ctx.a + 1 }))
+            .extend(ctx => ({ c: ctx.a + ctx.b }))
+            .build();
+        isType.equal();
+        expect(r).toEqual({ a: 1, b: 2, c: 3 });
+    });
+    it('accepts extenders needing partial of current context', () => {
+        function foo(ctx) {
+            return { c: ctx.a + 2 };
+        }
+        const r = context({ a: 1, b: 2 }).extend(foo).build();
+        isType.equal();
+        expect(r).toEqual({ a: 1, b: 2, c: 3 });
+    });
+});
+//# sourceMappingURL=context.spec.js.map

package/esm/functional/context.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.spec.js","sourceRoot":"","sources":["../../ts/functional/context.spec.ts"],"names":[],"mappings":"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"}

package/esm/functional/index.d.ts

@@ -1,3 +1,4 @@
 export type { ChainFn, EndoFn } from './ChainFn.js';
 export * from './compose.js';
+export * from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/functional/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/esm/functional/index.js

@@ -1,2 +1,3 @@
 export * from './compose.js';
+export * from './context.js';
 //# 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":"AAEA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/functional/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/esm/predicates/isType.d.ts

@@ -10,6 +10,6 @@ export declare function isType<T>(subject: unknown, validator: (s: T) => unknown
 export declare namespace isType {
     var t: <T extends true>(subject?: T | undefined) => boolean;
     var f: <T extends false>(subject?: T | undefined) => boolean;
-    var equal: <C extends Equal<A, B>, A, B>() => void;
+    var equal: <C extends Equal<A, B, true, false>, A, B>() => void;
 }
 //# sourceMappingURL=isType.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "type-plus",
-  "version": "5.3.0",
+  "version": "5.4.1",
   "description": "Provides additional types for TypeScript.",
   "homepage": "https://github.com/unional/type-plus",
   "bugs": {
@@ -67,7 +67,7 @@
     "tslib": "^2.4.0",
     "typedoc": "^0.23.0",
     "typedoc-plugin-extras": "^2.2.3",
-    "typescript": "5.0.0-dev.20230116"
+    "typescript": "^4.9.4"
   },
   "packageManager": "pnpm@7.25.0",
   "size-limit": [

package/ts/functional/context.ts

@@ -0,0 +1,69 @@
+import type { LeftJoin } from '../object/index.js'
+
+export type ContextBaseShape = Record<string | symbol, any>
+
+/**
+ * Extends the context with new props.
+ * @param context the current context.
+ * @return an additional context with new properties.
+ */
+export type ContextExtender<
+  Current,
+  Additional
+> = (context: Current) => Additional
+
+export type ContextBuilder<
+  Init extends ContextBaseShape,
+  Ctx extends ContextBaseShape
+> = {
+  /**
+   * Extends the context using an extender.
+   * @param extender function that add new props to the context.
+   *
+   * The extender only need to return a new object with new properties.
+   *
+   * Do not need to merge the existing context with the new props.
+   * The builder will do that for you.
+   */
+  extend<
+    Current extends ContextBaseShape = Ctx,
+    Additional extends ContextBaseShape = ContextBaseShape
+  >(extender: ContextExtender<Current, Additional>)
+    : ContextBuilder<Init, LeftJoin<Ctx, Additional>>,
+  /**
+   * Build and return the context.
+   */
+  build(): Ctx
+}
+
+/**
+ * A fluent context builder.
+ *
+ * The initializer and transformer
+ *
+ * @param init The initial context or an context initializer.
+ * @return the context builder where you can
+ * use `extend()` to add context, and
+ * use `build()` to build the context.
+ */
+export function context<
+  Init extends ContextBaseShape,
+  Ctx extends ContextBaseShape = Init
+>(init?: Init | (() => Init)): ContextBuilder<Init, Ctx> {
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+  return typeof init === 'function'
+    ? contextBuilder({}, [init])
+    : contextBuilder(init ?? {}, []) as any
+}
+
+function contextBuilder(init: ContextBaseShape, transformers: ContextExtender<any, any>[]) {
+  return {
+    extend(transformer: ContextExtender<any, any>) {
+      return contextBuilder(init, transformers.concat(transformer))
+    },
+    build() {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+      return transformers.reduce((p, t) => ({ ...p, ...t(p) }), init)
+    }
+  }
+}

package/ts/functional/index.ts

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