@nlozgachev/pipelined 0.6.4 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm/src/Core/Logged.js +111 -0
- package/esm/src/Core/Option.js +4 -1
- package/esm/src/Core/Predicate.js +133 -0
- package/esm/src/Core/Refinement.js +115 -0
- package/esm/src/Core/RemoteData.js +3 -0
- package/esm/src/Core/Result.js +4 -0
- package/esm/src/Core/State.js +181 -0
- package/esm/src/Core/Task.js +36 -0
- package/esm/src/Core/TaskOption.js +1 -0
- package/esm/src/Core/TaskResult.js +2 -0
- package/esm/src/Core/TaskValidation.js +5 -1
- package/esm/src/Core/These.js +4 -0
- package/esm/src/Core/Validation.js +4 -0
- package/esm/src/Core/index.js +4 -0
- package/package.json +1 -1
- package/script/src/Core/Logged.js +114 -0
- package/script/src/Core/Option.js +4 -1
- package/script/src/Core/Predicate.js +136 -0
- package/script/src/Core/Refinement.js +118 -0
- package/script/src/Core/RemoteData.js +3 -0
- package/script/src/Core/Result.js +4 -0
- package/script/src/Core/State.js +184 -0
- package/script/src/Core/Task.js +36 -0
- package/script/src/Core/TaskOption.js +1 -0
- package/script/src/Core/TaskResult.js +2 -0
- package/script/src/Core/TaskValidation.js +5 -1
- package/script/src/Core/These.js +4 -0
- package/script/src/Core/Validation.js +4 -0
- package/script/src/Core/index.js +4 -0
- package/types/src/Composition/on.d.ts.map +1 -1
- package/types/src/Core/InternalTypes.d.ts +3 -0
- package/types/src/Core/InternalTypes.d.ts.map +1 -1
- package/types/src/Core/Logged.d.ts +126 -0
- package/types/src/Core/Logged.d.ts.map +1 -0
- package/types/src/Core/Option.d.ts +6 -3
- package/types/src/Core/Option.d.ts.map +1 -1
- package/types/src/Core/Predicate.d.ts +161 -0
- package/types/src/Core/Predicate.d.ts.map +1 -0
- package/types/src/Core/Refinement.d.ts +138 -0
- package/types/src/Core/Refinement.d.ts.map +1 -0
- package/types/src/Core/RemoteData.d.ts +5 -2
- package/types/src/Core/RemoteData.d.ts.map +1 -1
- package/types/src/Core/Result.d.ts +7 -3
- package/types/src/Core/Result.d.ts.map +1 -1
- package/types/src/Core/State.d.ts +192 -0
- package/types/src/Core/State.d.ts.map +1 -0
- package/types/src/Core/Task.d.ts +30 -0
- package/types/src/Core/Task.d.ts.map +1 -1
- package/types/src/Core/TaskOption.d.ts +2 -1
- package/types/src/Core/TaskOption.d.ts.map +1 -1
- package/types/src/Core/TaskResult.d.ts +4 -2
- package/types/src/Core/TaskResult.d.ts.map +1 -1
- package/types/src/Core/TaskValidation.d.ts +4 -2
- package/types/src/Core/TaskValidation.d.ts.map +1 -1
- package/types/src/Core/These.d.ts +6 -2
- package/types/src/Core/These.d.ts.map +1 -1
- package/types/src/Core/Validation.d.ts +7 -3
- package/types/src/Core/Validation.d.ts.map +1 -1
- package/types/src/Core/index.d.ts +4 -0
- package/types/src/Core/index.d.ts.map +1 -1
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
import { Refinement } from "./Refinement.js";
|
|
2
|
+
/**
|
|
3
|
+
* A boolean-valued function over a type `A`.
|
|
4
|
+
*
|
|
5
|
+
* A `Predicate<A>` is the simpler sibling of `Refinement<A, B>`: it tests whether a
|
|
6
|
+
* value satisfies a condition at runtime but carries no compile-time narrowing guarantee.
|
|
7
|
+
* Use it when you need to combine, negate, or adapt boolean checks as first-class values
|
|
8
|
+
* and do not require the extra type information that a `Refinement` provides.
|
|
9
|
+
*
|
|
10
|
+
* Every `Refinement<A, B>` is a `Predicate<A>` — convert with `Predicate.fromRefinement`
|
|
11
|
+
* when you want to compose a narrowing check alongside plain predicates.
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* const isAdult: Predicate<number> = n => n >= 18;
|
|
16
|
+
* const isRetired: Predicate<number> = n => n >= 65;
|
|
17
|
+
*
|
|
18
|
+
* const isWorkingAge: Predicate<number> = pipe(
|
|
19
|
+
* isAdult,
|
|
20
|
+
* Predicate.and(Predicate.not(isRetired))
|
|
21
|
+
* );
|
|
22
|
+
*
|
|
23
|
+
* isWorkingAge(30); // true
|
|
24
|
+
* isWorkingAge(15); // false
|
|
25
|
+
* isWorkingAge(70); // false
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export type Predicate<A> = (a: A) => boolean;
|
|
29
|
+
export declare namespace Predicate {
|
|
30
|
+
/**
|
|
31
|
+
* Negates a predicate: the result passes exactly when the original fails.
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* ```ts
|
|
35
|
+
* const isBlank: Predicate<string> = s => s.trim().length === 0;
|
|
36
|
+
* const isNotBlank = Predicate.not(isBlank);
|
|
37
|
+
*
|
|
38
|
+
* isNotBlank("hello"); // true
|
|
39
|
+
* isNotBlank(" "); // false
|
|
40
|
+
* ```
|
|
41
|
+
*/
|
|
42
|
+
const not: <A>(p: Predicate<A>) => Predicate<A>;
|
|
43
|
+
/**
|
|
44
|
+
* Combines two predicates with logical AND: passes only when both hold.
|
|
45
|
+
*
|
|
46
|
+
* Data-last — the first predicate is the data being piped.
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* ```ts
|
|
50
|
+
* const isPositive: Predicate<number> = n => n > 0;
|
|
51
|
+
* const isEven: Predicate<number> = n => n % 2 === 0;
|
|
52
|
+
*
|
|
53
|
+
* const isPositiveEven: Predicate<number> = pipe(isPositive, Predicate.and(isEven));
|
|
54
|
+
*
|
|
55
|
+
* isPositiveEven(4); // true
|
|
56
|
+
* isPositiveEven(3); // false — positive but odd
|
|
57
|
+
* isPositiveEven(-2); // false — even but not positive
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
const and: <A>(second: Predicate<A>) => (first: Predicate<A>) => Predicate<A>;
|
|
61
|
+
/**
|
|
62
|
+
* Combines two predicates with logical OR: passes when either holds.
|
|
63
|
+
*
|
|
64
|
+
* Data-last — the first predicate is the data being piped.
|
|
65
|
+
*
|
|
66
|
+
* @example
|
|
67
|
+
* ```ts
|
|
68
|
+
* const isChild: Predicate<number> = n => n < 13;
|
|
69
|
+
* const isSenior: Predicate<number> = n => n >= 65;
|
|
70
|
+
*
|
|
71
|
+
* const getsDiscount: Predicate<number> = pipe(isChild, Predicate.or(isSenior));
|
|
72
|
+
*
|
|
73
|
+
* getsDiscount(8); // true
|
|
74
|
+
* getsDiscount(70); // true
|
|
75
|
+
* getsDiscount(30); // false
|
|
76
|
+
* ```
|
|
77
|
+
*/
|
|
78
|
+
const or: <A>(second: Predicate<A>) => (first: Predicate<A>) => Predicate<A>;
|
|
79
|
+
/**
|
|
80
|
+
* Adapts a `Predicate<A>` to work on a different input type `B` by applying `f`
|
|
81
|
+
* to extract the relevant `A` from a `B` before running the check.
|
|
82
|
+
*
|
|
83
|
+
* Data-last — the predicate is the data being piped; `f` is the extractor.
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* ```ts
|
|
87
|
+
* type User = { name: string; age: number };
|
|
88
|
+
*
|
|
89
|
+
* const isAdult: Predicate<number> = n => n >= 18;
|
|
90
|
+
*
|
|
91
|
+
* // Lift isAdult to work on Users by extracting the age field
|
|
92
|
+
* const isAdultUser: Predicate<User> = pipe(
|
|
93
|
+
* isAdult,
|
|
94
|
+
* Predicate.using((u: User) => u.age)
|
|
95
|
+
* );
|
|
96
|
+
*
|
|
97
|
+
* isAdultUser({ name: "Alice", age: 30 }); // true
|
|
98
|
+
* isAdultUser({ name: "Bob", age: 15 }); // false
|
|
99
|
+
* ```
|
|
100
|
+
*/
|
|
101
|
+
const using: <A, B>(f: (b: B) => A) => (p: Predicate<A>) => Predicate<B>;
|
|
102
|
+
/**
|
|
103
|
+
* Combines an array of predicates with AND: passes only when every predicate holds.
|
|
104
|
+
* Returns `true` for an empty array (vacuous truth).
|
|
105
|
+
*
|
|
106
|
+
* @example
|
|
107
|
+
* ```ts
|
|
108
|
+
* const checks: Predicate<string>[] = [
|
|
109
|
+
* s => s.length > 0,
|
|
110
|
+
* s => s.length <= 100,
|
|
111
|
+
* s => !s.includes("<"),
|
|
112
|
+
* ];
|
|
113
|
+
*
|
|
114
|
+
* Predicate.all(checks)("hello"); // true
|
|
115
|
+
* Predicate.all(checks)(""); // false — too short
|
|
116
|
+
* Predicate.all(checks)("<b>"); // false — contains "<"
|
|
117
|
+
* Predicate.all([])("anything"); // true
|
|
118
|
+
* ```
|
|
119
|
+
*/
|
|
120
|
+
const all: <A>(predicates: ReadonlyArray<Predicate<A>>) => Predicate<A>;
|
|
121
|
+
/**
|
|
122
|
+
* Combines an array of predicates with OR: passes when at least one holds.
|
|
123
|
+
* Returns `false` for an empty array.
|
|
124
|
+
*
|
|
125
|
+
* @example
|
|
126
|
+
* ```ts
|
|
127
|
+
* const acceptedFormats: Predicate<string>[] = [
|
|
128
|
+
* s => s.endsWith(".jpg"),
|
|
129
|
+
* s => s.endsWith(".png"),
|
|
130
|
+
* s => s.endsWith(".webp"),
|
|
131
|
+
* ];
|
|
132
|
+
*
|
|
133
|
+
* Predicate.any(acceptedFormats)("photo.jpg"); // true
|
|
134
|
+
* Predicate.any(acceptedFormats)("photo.gif"); // false
|
|
135
|
+
* Predicate.any([])("anything"); // false
|
|
136
|
+
* ```
|
|
137
|
+
*/
|
|
138
|
+
const any: <A>(predicates: ReadonlyArray<Predicate<A>>) => Predicate<A>;
|
|
139
|
+
/**
|
|
140
|
+
* Converts a `Refinement<A, B>` into a `Predicate<A>`, discarding the compile-time
|
|
141
|
+
* narrowing. Use this when you want to combine a type guard with plain predicates
|
|
142
|
+
* using `and`, `or`, or `all`.
|
|
143
|
+
*
|
|
144
|
+
* @example
|
|
145
|
+
* ```ts
|
|
146
|
+
* const isString: Refinement<unknown, string> =
|
|
147
|
+
* Refinement.make(x => typeof x === "string");
|
|
148
|
+
*
|
|
149
|
+
* const isShortString: Predicate<unknown> = pipe(
|
|
150
|
+
* Predicate.fromRefinement(isString),
|
|
151
|
+
* Predicate.and(x => (x as string).length < 10)
|
|
152
|
+
* );
|
|
153
|
+
*
|
|
154
|
+
* isShortString("hi"); // true
|
|
155
|
+
* isShortString("a very long string that exceeds ten characters"); // false
|
|
156
|
+
* isShortString(42); // false
|
|
157
|
+
* ```
|
|
158
|
+
*/
|
|
159
|
+
const fromRefinement: <A, B extends A>(r: Refinement<A, B>) => Predicate<A>;
|
|
160
|
+
}
|
|
161
|
+
//# sourceMappingURL=Predicate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Predicate.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Predicate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;AAE7C,yBAAiB,SAAS,CAAC;IACzB;;;;;;;;;;;OAWG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAAiB,CAAC;IAEtE;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAC3D,CAAC;IAExB;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,EAAE,GAAI,CAAC,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAC1D,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAAmB,CAAC;IAEjG;;;;;;;;;;;;;;;;;OAiBG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,YAAY,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAC7C,CAAC;IAEhC;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,YAAY,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAC9C,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,CAAM,CAAC;CACxF"}
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
import { Option } from "./Option.js";
|
|
2
|
+
import { Result } from "./Result.js";
|
|
3
|
+
/**
|
|
4
|
+
* A function from `A` to `A is B` — a type predicate paired with a runtime check.
|
|
5
|
+
*
|
|
6
|
+
* A `Refinement<A, B>` proves at compile time that a value of type `A` is actually
|
|
7
|
+
* the narrower type `B extends A`, backed by a runtime boolean test. Use it to
|
|
8
|
+
* express domain invariants (non-empty strings, positive numbers, valid emails) as
|
|
9
|
+
* first-class, composable values rather than one-off type guards scattered across
|
|
10
|
+
* the codebase.
|
|
11
|
+
*
|
|
12
|
+
* @example
|
|
13
|
+
* ```ts
|
|
14
|
+
* type NonEmptyString = string & { readonly _tag: "NonEmptyString" };
|
|
15
|
+
*
|
|
16
|
+
* const isNonEmpty: Refinement<string, NonEmptyString> =
|
|
17
|
+
* Refinement.make(s => s.length > 0);
|
|
18
|
+
*
|
|
19
|
+
* pipe(
|
|
20
|
+
* "hello",
|
|
21
|
+
* Refinement.toFilter(isNonEmpty)
|
|
22
|
+
* ); // Some("hello")
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
export type Refinement<A, B extends A> = (a: A) => a is B;
|
|
26
|
+
export declare namespace Refinement {
|
|
27
|
+
/**
|
|
28
|
+
* Creates a `Refinement<A, B>` from a plain boolean predicate.
|
|
29
|
+
*
|
|
30
|
+
* This is an unsafe cast — the caller is responsible for ensuring that the
|
|
31
|
+
* predicate truly characterises values of type `B`. Use this only when
|
|
32
|
+
* bootstrapping a new refinement; prefer `compose`, `and`, or `or` to build
|
|
33
|
+
* derived refinements from existing ones.
|
|
34
|
+
*
|
|
35
|
+
* @example
|
|
36
|
+
* ```ts
|
|
37
|
+
* type PositiveNumber = number & { readonly _tag: "PositiveNumber" };
|
|
38
|
+
*
|
|
39
|
+
* const isPositive: Refinement<number, PositiveNumber> =
|
|
40
|
+
* Refinement.make(n => n > 0);
|
|
41
|
+
* ```
|
|
42
|
+
*/
|
|
43
|
+
const make: <A, B extends A>(f: (a: A) => boolean) => Refinement<A, B>;
|
|
44
|
+
/**
|
|
45
|
+
* Chains two refinements: if `ab` narrows `A` to `B` and `bc` narrows `B` to `C`,
|
|
46
|
+
* the result narrows `A` directly to `C`.
|
|
47
|
+
*
|
|
48
|
+
* Data-last — the first refinement `ab` is the data being piped.
|
|
49
|
+
*
|
|
50
|
+
* @example
|
|
51
|
+
* ```ts
|
|
52
|
+
* type NonEmptyString = string & { readonly _tag: "NonEmpty" };
|
|
53
|
+
* type TrimmedString = NonEmptyString & { readonly _tag: "Trimmed" };
|
|
54
|
+
*
|
|
55
|
+
* const isNonEmpty: Refinement<string, NonEmptyString> =
|
|
56
|
+
* Refinement.make(s => s.length > 0);
|
|
57
|
+
* const isTrimmed: Refinement<NonEmptyString, TrimmedString> =
|
|
58
|
+
* Refinement.make(s => s === s.trim());
|
|
59
|
+
*
|
|
60
|
+
* const isNonEmptyTrimmed: Refinement<string, TrimmedString> = pipe(
|
|
61
|
+
* isNonEmpty,
|
|
62
|
+
* Refinement.compose(isTrimmed)
|
|
63
|
+
* );
|
|
64
|
+
* ```
|
|
65
|
+
*/
|
|
66
|
+
const compose: <A, B extends A, C extends B>(bc: Refinement<B, C>) => (ab: Refinement<A, B>) => Refinement<A, C>;
|
|
67
|
+
/**
|
|
68
|
+
* Intersects two refinements: the result narrows `A` to `B & C`, passing only
|
|
69
|
+
* when both refinements hold simultaneously.
|
|
70
|
+
*
|
|
71
|
+
* Data-last — the first refinement is the data being piped.
|
|
72
|
+
*
|
|
73
|
+
* @example
|
|
74
|
+
* ```ts
|
|
75
|
+
* const isString: Refinement<unknown, string> = Refinement.make(x => typeof x === "string");
|
|
76
|
+
* const isNonEmpty: Refinement<unknown, { length: number }> =
|
|
77
|
+
* Refinement.make(x => (x as any).length > 0);
|
|
78
|
+
*
|
|
79
|
+
* const isNonEmptyString = pipe(isString, Refinement.and(isNonEmpty));
|
|
80
|
+
* isNonEmptyString("hi"); // true
|
|
81
|
+
* isNonEmptyString(""); // false
|
|
82
|
+
* ```
|
|
83
|
+
*/
|
|
84
|
+
const and: <A, C extends A>(second: Refinement<A, C>) => <B extends A>(first: Refinement<A, B>) => Refinement<A, B & C>;
|
|
85
|
+
/**
|
|
86
|
+
* Unions two refinements: the result narrows `A` to `B | C`, passing when either
|
|
87
|
+
* refinement holds.
|
|
88
|
+
*
|
|
89
|
+
* Data-last — the first refinement is the data being piped.
|
|
90
|
+
*
|
|
91
|
+
* @example
|
|
92
|
+
* ```ts
|
|
93
|
+
* const isString: Refinement<unknown, string> = Refinement.make(x => typeof x === "string");
|
|
94
|
+
* const isNumber: Refinement<unknown, number> = Refinement.make(x => typeof x === "number");
|
|
95
|
+
*
|
|
96
|
+
* const isStringOrNumber = pipe(isString, Refinement.or(isNumber));
|
|
97
|
+
* isStringOrNumber("hi"); // true
|
|
98
|
+
* isStringOrNumber(42); // true
|
|
99
|
+
* isStringOrNumber(true); // false
|
|
100
|
+
* ```
|
|
101
|
+
*/
|
|
102
|
+
const or: <A, C extends A>(second: Refinement<A, C>) => <B extends A>(first: Refinement<A, B>) => Refinement<A, B | C>;
|
|
103
|
+
/**
|
|
104
|
+
* Converts a `Refinement<A, B>` into a function `(a: A) => Option<B>`.
|
|
105
|
+
*
|
|
106
|
+
* Returns `Some(a)` when the refinement holds, `None` otherwise. Useful for
|
|
107
|
+
* integrating runtime validation into an `Option`-based pipeline.
|
|
108
|
+
*
|
|
109
|
+
* @example
|
|
110
|
+
* ```ts
|
|
111
|
+
* type PositiveNumber = number & { readonly _tag: "Positive" };
|
|
112
|
+
* const isPositive: Refinement<number, PositiveNumber> =
|
|
113
|
+
* Refinement.make(n => n > 0);
|
|
114
|
+
*
|
|
115
|
+
* pipe(-1, Refinement.toFilter(isPositive)); // None
|
|
116
|
+
* pipe(42, Refinement.toFilter(isPositive)); // Some(42)
|
|
117
|
+
* ```
|
|
118
|
+
*/
|
|
119
|
+
const toFilter: <A, B extends A>(r: Refinement<A, B>) => (a: A) => Option<B>;
|
|
120
|
+
/**
|
|
121
|
+
* Converts a `Refinement<A, B>` into a function `(a: A) => Result<E, B>`.
|
|
122
|
+
*
|
|
123
|
+
* Returns `Ok(a)` when the refinement holds, `Err(onFail(a))` otherwise. Use
|
|
124
|
+
* this to surface validation failures as typed errors inside a `Result` pipeline.
|
|
125
|
+
*
|
|
126
|
+
* @example
|
|
127
|
+
* ```ts
|
|
128
|
+
* type NonEmptyString = string & { readonly _tag: "NonEmpty" };
|
|
129
|
+
* const isNonEmpty: Refinement<string, NonEmptyString> =
|
|
130
|
+
* Refinement.make(s => s.length > 0);
|
|
131
|
+
*
|
|
132
|
+
* pipe("", Refinement.toResult(isNonEmpty, () => "must not be empty")); // Err(...)
|
|
133
|
+
* pipe("hi", Refinement.toResult(isNonEmpty, () => "must not be empty")); // Ok("hi")
|
|
134
|
+
* ```
|
|
135
|
+
*/
|
|
136
|
+
const toResult: <A, B extends A, E>(r: Refinement<A, B>, onFail: (a: A) => E) => (a: A) => Result<E, B>;
|
|
137
|
+
}
|
|
138
|
+
//# sourceMappingURL=Refinement.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Refinement.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Refinement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAE1D,yBAAiB,UAAU,CAAC;IAC1B;;;;;;;;;;;;;;;OAeG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CACpD,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,MAAM,OAAO,GACjB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MACjD,IAAI,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CACV,CAAC;IAEhC;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,GAAG,GACb,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MACxC,CAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CACnB,CAAC;IAE3C;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,EAAE,GACZ,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MACxC,CAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CACnB,CAAC;IAE3C;;;;;;;;;;;;;;;OAeG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,KAAG,MAAM,CAAC,CAAC,CAC1C,CAAC;IAExC;;;;;;;;;;;;;;;OAeG;IACI,MAAM,QAAQ,GAClB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CACvC,CAAC;CACjD"}
|
|
@@ -144,14 +144,16 @@ export declare namespace RemoteData {
|
|
|
144
144
|
}) => (data: RemoteData<E, A>) => B;
|
|
145
145
|
/**
|
|
146
146
|
* Returns the success value or a default value if the RemoteData is not Success.
|
|
147
|
+
* The default can be a different type, widening the result to `A | B`.
|
|
147
148
|
*
|
|
148
149
|
* @example
|
|
149
150
|
* ```ts
|
|
150
151
|
* pipe(RemoteData.success(5), RemoteData.getOrElse(0)); // 5
|
|
151
152
|
* pipe(RemoteData.loading(), RemoteData.getOrElse(0)); // 0
|
|
153
|
+
* pipe(RemoteData.loading<string, number>(), RemoteData.getOrElse(null)); // null — typed as number | null
|
|
152
154
|
* ```
|
|
153
155
|
*/
|
|
154
|
-
const getOrElse: <E, A>(defaultValue:
|
|
156
|
+
const getOrElse: <E, A, B>(defaultValue: B) => (data: RemoteData<E, A>) => A | B;
|
|
155
157
|
/**
|
|
156
158
|
* Executes a side effect on the success value without changing the RemoteData.
|
|
157
159
|
*
|
|
@@ -167,8 +169,9 @@ export declare namespace RemoteData {
|
|
|
167
169
|
const tap: <E, A>(f: (a: A) => void) => (data: RemoteData<E, A>) => RemoteData<E, A>;
|
|
168
170
|
/**
|
|
169
171
|
* Recovers from a Failure state by providing a fallback RemoteData.
|
|
172
|
+
* The fallback can produce a different success type, widening the result to `RemoteData<E, A | B>`.
|
|
170
173
|
*/
|
|
171
|
-
const recover: <E, A>(fallback: (e: E) => RemoteData<E,
|
|
174
|
+
const recover: <E, A, B>(fallback: (e: E) => RemoteData<E, B>) => (data: RemoteData<E, A>) => RemoteData<E, A | B>;
|
|
172
175
|
/**
|
|
173
176
|
* Converts a RemoteData to an Option.
|
|
174
177
|
* Success becomes Some, all other states become None.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"RemoteData.d.ts","sourceRoot":"","sources":["../../../src/src/Core/RemoteData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5C,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC1C,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAC5D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAE5D,yBAAiB,UAAU,CAAC;IAC1B;;OAEG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,OAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAA2B,CAAC;IAE7E;;OAEG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,OAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAA0B,CAAC;IAE3E;;OAEG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAGtD,CAAC;IAEH;;OAEG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAGtD,CAAC;IAEH;;OAEG;IACI,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,QACxC,CAAC;IAE3B;;OAEG;IACI,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,OACxC,CAAC;IAE1B;;OAEG;IACI,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CACjD,CAAC;IAE1B;;OAEG;IACI,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CACjD,CAAC;IAE1B;;;;;;;;OAQG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAClB,CAAC;IAExE;;;;;;;OAOG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CACvB,CAAC;IAExE;;;;;;;;;;;OAWG;IACI,MAAM,KAAK,GACf,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CACvB,CAAC;IAEjE;;;;;;;;;;;;OAYG;IACI,MAAM,EAAE,GACZ,CAAC,EAAE,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAQtF,CAAC;IAEJ;;;;;;;;;;;;;;;OAeG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC1B,YAAY,MAAM,CAAC,EACnB,WAAW,MAAM,CAAC,EAClB,WAAW,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EACtB,WAAW,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAEvB,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAWzB,CAAC;IAEF;;;;;;;;;;;;;;;OAeG;IACI,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO;QACpC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC,CAAC;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;KACtB,MACA,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAWzB,CAAC;IAEF
|
|
1
|
+
{"version":3,"file":"RemoteData.d.ts","sourceRoot":"","sources":["../../../src/src/Core/RemoteData.ts"],"names":[],"mappings":"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"}
|
|
@@ -117,14 +117,16 @@ export declare namespace Result {
|
|
|
117
117
|
}) => (data: Result<E, A>) => B;
|
|
118
118
|
/**
|
|
119
119
|
* Returns the success value or a default value if the Result is an error.
|
|
120
|
+
* The default can be a different type, widening the result to `A | B`.
|
|
120
121
|
*
|
|
121
122
|
* @example
|
|
122
123
|
* ```ts
|
|
123
124
|
* pipe(Result.ok(5), Result.getOrElse(0)); // 5
|
|
124
125
|
* pipe(Result.err("error"), Result.getOrElse(0)); // 0
|
|
126
|
+
* pipe(Result.err("error"), Result.getOrElse(null)); // null — typed as number | null
|
|
125
127
|
* ```
|
|
126
128
|
*/
|
|
127
|
-
const getOrElse: <E, A>(defaultValue:
|
|
129
|
+
const getOrElse: <E, A, B>(defaultValue: B) => (data: Result<E, A>) => A | B;
|
|
128
130
|
/**
|
|
129
131
|
* Executes a side effect on the success value without changing the Result.
|
|
130
132
|
* Useful for logging or debugging.
|
|
@@ -141,12 +143,14 @@ export declare namespace Result {
|
|
|
141
143
|
const tap: <E, A>(f: (a: A) => void) => (data: Result<E, A>) => Result<E, A>;
|
|
142
144
|
/**
|
|
143
145
|
* Recovers from an error by providing a fallback Result.
|
|
146
|
+
* The fallback can produce a different success type, widening the result to `Result<E, A | B>`.
|
|
144
147
|
*/
|
|
145
|
-
const recover: <E, A>(fallback: () => Result<E,
|
|
148
|
+
const recover: <E, A, B>(fallback: () => Result<E, B>) => (data: Result<E, A>) => Result<E, A | B>;
|
|
146
149
|
/**
|
|
147
150
|
* Recovers from an error unless it matches the blocked error.
|
|
151
|
+
* The fallback can produce a different success type, widening the result to `Result<E, A | B>`.
|
|
148
152
|
*/
|
|
149
|
-
const recoverUnless: <E, A>(blockedErr: E, fallback: () => Result<E,
|
|
153
|
+
const recoverUnless: <E, A, B>(blockedErr: E, fallback: () => Result<E, B>) => (data: Result<E, A>) => Result<E, A | B>;
|
|
150
154
|
/**
|
|
151
155
|
* Converts a Result to an Option.
|
|
152
156
|
* Ok becomes Some, Err becomes None (the error is discarded).
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAClD,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAEtD,yBAAiB,MAAM,CAAC;IACtB;;OAEG;IACI,MAAM,EAAE,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,EAAE,CAAC,CAAC,CAA4B,CAAC;IAElE;;OAEG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,GAAG,CAAC,CAAC,CAA+B,CAAC;IAEvE;;OAEG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,EAAE,CAAC,CAAC,CAAuB,CAAC;IAEpF;;OAEG;IACI,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,IAAI,IAAI,GAAG,CAAC,CAAC,CAA0B,CAAC;IAEzF;;;;;;;;;;;;OAYG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAC3B,GAAG,MAAM,CAAC,EACV,SAAS,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,KACzB,MAAM,CAAC,CAAC,EAAE,CAAC,CAMb,CAAC;IAEF;;;;;;;;OAQG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAC1C,CAAC;IAExC;;;;;;;OAOG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAC7C,CAAC;IAE1C;;;;;;;;;;;;OAYG;IACI,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAC3D,CAAC;IAEpC;;;;;;;;;;;;;OAaG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAC3C,CAAC;IAEpD;;;;;;;;;;;;;OAaG;IACI,MAAM,KAAK,GACf,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO;QAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CACtB,CAAC;IAE9D
|
|
1
|
+
{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Result.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A synchronous computation that threads a piece of mutable state `S` through
|
|
3
|
+
* a pipeline without exposing mutation at call sites.
|
|
4
|
+
*
|
|
5
|
+
* At runtime a `State<S, A>` is just a function from an initial state to a pair
|
|
6
|
+
* `[value, nextState]`. Nothing runs until you supply the initial state with
|
|
7
|
+
* `State.run`, `State.evaluate`, or `State.execute`.
|
|
8
|
+
*
|
|
9
|
+
* @example
|
|
10
|
+
* ```ts
|
|
11
|
+
* type Counter = number;
|
|
12
|
+
*
|
|
13
|
+
* const increment: State<Counter, undefined> = State.modify(n => n + 1);
|
|
14
|
+
* const getCount: State<Counter, Counter> = State.get();
|
|
15
|
+
*
|
|
16
|
+
* const program = pipe(
|
|
17
|
+
* increment,
|
|
18
|
+
* State.chain(() => increment),
|
|
19
|
+
* State.chain(() => getCount),
|
|
20
|
+
* );
|
|
21
|
+
*
|
|
22
|
+
* State.run(0)(program); // [2, 2] — value is 2, final state is 2
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
export type State<S, A> = (s: S) => readonly [A, S];
|
|
26
|
+
export declare namespace State {
|
|
27
|
+
/**
|
|
28
|
+
* Lifts a pure value into a State computation. The state passes through unchanged.
|
|
29
|
+
*
|
|
30
|
+
* @example
|
|
31
|
+
* ```ts
|
|
32
|
+
* State.run(10)(State.resolve(42)); // [42, 10] — value 42, state unchanged
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
35
|
+
const resolve: <S, A>(value: A) => State<S, A>;
|
|
36
|
+
/**
|
|
37
|
+
* Produces the current state as the value, without modifying it.
|
|
38
|
+
*
|
|
39
|
+
* @example
|
|
40
|
+
* ```ts
|
|
41
|
+
* const readStack: State<string[], string[]> = State.get();
|
|
42
|
+
* State.run(["a", "b"])(readStack); // [["a", "b"], ["a", "b"]]
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
const get: <S>() => State<S, S>;
|
|
46
|
+
/**
|
|
47
|
+
* Reads a projection of the state without modifying it.
|
|
48
|
+
* Equivalent to `pipe(State.get(), State.map(f))` but more direct.
|
|
49
|
+
*
|
|
50
|
+
* @example
|
|
51
|
+
* ```ts
|
|
52
|
+
* type AppState = { count: number; label: string };
|
|
53
|
+
* const readCount: State<AppState, number> = State.gets(s => s.count);
|
|
54
|
+
* State.run({ count: 5, label: "x" })(readCount); // [5, { count: 5, label: "x" }]
|
|
55
|
+
* ```
|
|
56
|
+
*/
|
|
57
|
+
const gets: <S, A>(f: (s: S) => A) => State<S, A>;
|
|
58
|
+
/**
|
|
59
|
+
* Replaces the current state with a new value. Produces no meaningful value.
|
|
60
|
+
*
|
|
61
|
+
* @example
|
|
62
|
+
* ```ts
|
|
63
|
+
* const reset: State<number, undefined> = State.put(0);
|
|
64
|
+
* State.run(99)(reset); // [undefined, 0]
|
|
65
|
+
* ```
|
|
66
|
+
*/
|
|
67
|
+
const put: <S>(newState: S) => State<S, undefined>;
|
|
68
|
+
/**
|
|
69
|
+
* Applies a function to the current state to produce the next state.
|
|
70
|
+
* Produces no meaningful value.
|
|
71
|
+
*
|
|
72
|
+
* @example
|
|
73
|
+
* ```ts
|
|
74
|
+
* const push = (item: string): State<string[], undefined> =>
|
|
75
|
+
* State.modify(stack => [...stack, item]);
|
|
76
|
+
*
|
|
77
|
+
* State.run(["a"])(push("b")); // [undefined, ["a", "b"]]
|
|
78
|
+
* ```
|
|
79
|
+
*/
|
|
80
|
+
const modify: <S>(f: (s: S) => S) => State<S, undefined>;
|
|
81
|
+
/**
|
|
82
|
+
* Transforms the value produced by a State computation.
|
|
83
|
+
* The state transformation is unchanged.
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* ```ts
|
|
87
|
+
* const readLength: State<string[], number> = pipe(
|
|
88
|
+
* State.get<string[]>(),
|
|
89
|
+
* State.map(stack => stack.length),
|
|
90
|
+
* );
|
|
91
|
+
*
|
|
92
|
+
* State.run(["a", "b", "c"])(readLength); // [3, ["a", "b", "c"]]
|
|
93
|
+
* ```
|
|
94
|
+
*/
|
|
95
|
+
const map: <S, A, B>(f: (a: A) => B) => (st: State<S, A>) => State<S, B>;
|
|
96
|
+
/**
|
|
97
|
+
* Sequences two State computations. The state output of the first is passed
|
|
98
|
+
* as the state input to the second.
|
|
99
|
+
*
|
|
100
|
+
* Data-last — the first computation is the data being piped.
|
|
101
|
+
*
|
|
102
|
+
* @example
|
|
103
|
+
* ```ts
|
|
104
|
+
* const push = (item: string): State<string[], undefined> =>
|
|
105
|
+
* State.modify(stack => [...stack, item]);
|
|
106
|
+
*
|
|
107
|
+
* const program = pipe(
|
|
108
|
+
* push("a"),
|
|
109
|
+
* State.chain(() => push("b")),
|
|
110
|
+
* State.chain(() => State.get<string[]>()),
|
|
111
|
+
* );
|
|
112
|
+
*
|
|
113
|
+
* State.evaluate([])(program); // ["a", "b"]
|
|
114
|
+
* ```
|
|
115
|
+
*/
|
|
116
|
+
const chain: <S, A, B>(f: (a: A) => State<S, B>) => (st: State<S, A>) => State<S, B>;
|
|
117
|
+
/**
|
|
118
|
+
* Applies a function wrapped in a State to a value wrapped in a State.
|
|
119
|
+
* The function computation runs first; its output state is the input to the
|
|
120
|
+
* argument computation.
|
|
121
|
+
*
|
|
122
|
+
* @example
|
|
123
|
+
* ```ts
|
|
124
|
+
* const addCounted = (n: number) => (m: number) => n + m;
|
|
125
|
+
* const program = pipe(
|
|
126
|
+
* State.resolve<number, typeof addCounted>(addCounted),
|
|
127
|
+
* State.ap(State.gets((s: number) => s * 2)),
|
|
128
|
+
* State.ap(State.gets((s: number) => s)),
|
|
129
|
+
* );
|
|
130
|
+
*
|
|
131
|
+
* State.evaluate(3)(program); // 6 + 3 = 9
|
|
132
|
+
* ```
|
|
133
|
+
*/
|
|
134
|
+
const ap: <S, A>(arg: State<S, A>) => <B>(fn: State<S, (a: A) => B>) => State<S, B>;
|
|
135
|
+
/**
|
|
136
|
+
* Runs a side effect on the produced value without changing the State computation.
|
|
137
|
+
*
|
|
138
|
+
* @example
|
|
139
|
+
* ```ts
|
|
140
|
+
* pipe(
|
|
141
|
+
* State.get<number>(),
|
|
142
|
+
* State.tap(n => console.log("current:", n)),
|
|
143
|
+
* State.chain(() => State.modify(n => n + 1)),
|
|
144
|
+
* );
|
|
145
|
+
* ```
|
|
146
|
+
*/
|
|
147
|
+
const tap: <S, A>(f: (a: A) => void) => (st: State<S, A>) => State<S, A>;
|
|
148
|
+
/**
|
|
149
|
+
* Runs a State computation with an initial state, returning both the
|
|
150
|
+
* produced value and the final state as a pair.
|
|
151
|
+
*
|
|
152
|
+
* Data-last — the computation is the data being piped.
|
|
153
|
+
*
|
|
154
|
+
* @example
|
|
155
|
+
* ```ts
|
|
156
|
+
* const program = pipe(
|
|
157
|
+
* State.modify<number>(n => n + 1),
|
|
158
|
+
* State.chain(() => State.get<number>()),
|
|
159
|
+
* );
|
|
160
|
+
*
|
|
161
|
+
* State.run(0)(program); // [1, 1]
|
|
162
|
+
* ```
|
|
163
|
+
*/
|
|
164
|
+
const run: <S>(initialState: S) => <A>(st: State<S, A>) => readonly [A, S];
|
|
165
|
+
/**
|
|
166
|
+
* Runs a State computation with an initial state, returning only the
|
|
167
|
+
* produced value (discarding the final state).
|
|
168
|
+
*
|
|
169
|
+
* @example
|
|
170
|
+
* ```ts
|
|
171
|
+
* State.evaluate([])(pipe(
|
|
172
|
+
* State.modify<string[]>(s => [...s, "x"]),
|
|
173
|
+
* State.chain(() => State.get<string[]>()),
|
|
174
|
+
* )); // ["x"]
|
|
175
|
+
* ```
|
|
176
|
+
*/
|
|
177
|
+
const evaluate: <S>(initialState: S) => <A>(st: State<S, A>) => A;
|
|
178
|
+
/**
|
|
179
|
+
* Runs a State computation with an initial state, returning only the
|
|
180
|
+
* final state (discarding the produced value).
|
|
181
|
+
*
|
|
182
|
+
* @example
|
|
183
|
+
* ```ts
|
|
184
|
+
* State.execute(0)(pipe(
|
|
185
|
+
* State.modify<number>(n => n + 10),
|
|
186
|
+
* State.chain(() => State.modify<number>(n => n * 2)),
|
|
187
|
+
* )); // 20
|
|
188
|
+
* ```
|
|
189
|
+
*/
|
|
190
|
+
const execute: <S>(initialState: S) => <A>(st: State<S, A>) => S;
|
|
191
|
+
}
|
|
192
|
+
//# sourceMappingURL=State.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../../src/src/Core/State.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEpD,yBAAiB,KAAK,CAAC;IACrB;;;;;;;OAOG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAsB,CAAC;IAE1E;;;;;;;;OAQG;IACI,MAAM,GAAG,GAAI,CAAC,OAAK,KAAK,CAAC,CAAC,EAAE,CAAC,CAAkB,CAAC;IAEvD;;;;;;;;;;OAUG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAqB,CAAC;IAE5E;;;;;;;;OAQG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,UAAU,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,SAAS,CAAkC,CAAC;IAE1F;;;;;;;;;;;OAWG;IACI,MAAM,MAAM,GAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,SAAS,CAA6B,CAAC;IAE3F;;;;;;;;;;;;;OAaG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAG5E,CAAC;IAEF;;;;;;;;;;;;;;;;;;;OAmBG;IACI,MAAM,KAAK,GACf,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAGnE,CAAC;IAEJ;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,EAAE,GACZ,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAIrE,CAAC;IAEJ;;;;;;;;;;;OAWG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAI5E,CAAC;IAEF;;;;;;;;;;;;;;;OAeG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAC7D,CAAC;IAEnB;;;;;;;;;;;OAWG;IACI,MAAM,QAAQ,GAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAAwB,CAAC;IAE/F;;;;;;;;;;;OAWG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAAwB,CAAC;CAC/F"}
|
package/types/src/Core/Task.d.ts
CHANGED
|
@@ -171,6 +171,36 @@ export declare namespace Task {
|
|
|
171
171
|
when: (a: A) => boolean;
|
|
172
172
|
delay?: number;
|
|
173
173
|
}) => (task: Task<A>) => Task<A>;
|
|
174
|
+
/**
|
|
175
|
+
* Resolves with the value of the first Task to complete. All Tasks start
|
|
176
|
+
* immediately; the rest are abandoned once one resolves.
|
|
177
|
+
*
|
|
178
|
+
* @example
|
|
179
|
+
* ```ts
|
|
180
|
+
* const fast = Task.from(() => new Promise<string>(r => setTimeout(() => r("fast"), 10)));
|
|
181
|
+
* const slow = Task.from(() => new Promise<string>(r => setTimeout(() => r("slow"), 200)));
|
|
182
|
+
*
|
|
183
|
+
* await Task.race([fast, slow])(); // "fast"
|
|
184
|
+
* ```
|
|
185
|
+
*/
|
|
186
|
+
const race: <A>(tasks: ReadonlyArray<Task<A>>) => Task<A>;
|
|
187
|
+
/**
|
|
188
|
+
* Runs an array of Tasks one at a time in order, collecting all results.
|
|
189
|
+
* Each Task starts only after the previous one resolves.
|
|
190
|
+
*
|
|
191
|
+
* @example
|
|
192
|
+
* ```ts
|
|
193
|
+
* let log: number[] = [];
|
|
194
|
+
* const makeTask = (n: number) => Task.from(() => {
|
|
195
|
+
* log.push(n);
|
|
196
|
+
* return Promise.resolve(n);
|
|
197
|
+
* });
|
|
198
|
+
*
|
|
199
|
+
* await Task.sequential([makeTask(1), makeTask(2), makeTask(3)])();
|
|
200
|
+
* // log = [1, 2, 3] — tasks ran in order
|
|
201
|
+
* ```
|
|
202
|
+
*/
|
|
203
|
+
const sequential: <A>(tasks: ReadonlyArray<Task<A>>) => Task<ReadonlyArray<A>>;
|
|
174
204
|
/**
|
|
175
205
|
* Converts a `Task<A>` into a `Task<Result<E, A>>`, resolving to `Err` if the
|
|
176
206
|
* Task does not complete within the given time.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC;AAOxC,yBAAiB,IAAI,CAAC;IACpB;;;;;;;;OAQG;IACI,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,IAAI,CAAC,CAAC,CACE,CAAC;IAE/C;;;;;;;OAOG;IACI,MAAM,IAAI,GAAI,CAAC,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAAoC,CAAC;IAEzF;;;;;;;;;;OAUG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAC/B,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACI,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAClB,CAAC;IAE3D;;;;;;;;;;;;;OAaG;IACI,MAAM,EAAE,GAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAMxE,CAAC;IAEJ;;;;;;;;;;;;OAYG;IACI,MAAM,GAAG,GAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAMjE,CAAC;IAEJ;;;;;;;;OAQG;IACI,MAAM,GAAG,GAAI,CAAC,SAAS,SAAS,IAAI,CAAC,OAAO,CAAC,EAAE,EACpD,OAAO,CAAC,KACP,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAE,CAQ/D,CAAC;IAEJ;;;;;;;;;;;OAWG;IACI,MAAM,KAAK,GAAI,IAAI,MAAM,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAS5D,CAAC;IAEJ;;;;;;;;;;;OAWG;IACI,MAAM,MAAM,GAChB,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,EAAE,CAcxE,CAAC;IAEP;;;;;;;;;;;OAWG;IACI,MAAM,WAAW,GACrB,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAWhF,CAAC;IAEP;;;;;;;;;;;;OAYG;IACI,MAAM,OAAO,GACjB,CAAC,EAAE,IAAI,MAAM,EAAE,WAAW,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAYxE,CAAC;CACR"}
|
|
1
|
+
{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../../src/src/Core/Task.ts"],"names":[],"mappings":"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"}
|