slang-ts 0.1.0 → 0.2.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/CHANGELOG.md +53 -0
- package/README.md +189 -602
- package/dist/index.d.ts +308 -25
- package/dist/index.js +2 -2
- package/package.json +17 -5
package/dist/index.d.ts
CHANGED
|
@@ -1,21 +1,87 @@
|
|
|
1
|
+
//#region src/fallible.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* Stable categories for fallible collection chains.
|
|
4
|
+
* Callers branch on the category; the message is for a human.
|
|
5
|
+
*/
|
|
6
|
+
type SlangErrorCategory = "INVALID_INPUT" | "INVALID_INDEX" | "OUT_OF_BOUNDS" | "INVALID_RANGE" | "INVALID_CHUNK_SIZE";
|
|
7
|
+
/**
|
|
8
|
+
* A collection outcome that must be resolved with `.else(...)` or `.panic(...)`.
|
|
9
|
+
* Operations short-circuit: once the chain fails, later steps do not run.
|
|
10
|
+
*/
|
|
11
|
+
type Fallible<T> = {
|
|
12
|
+
/** The underlying outcome, for composing chains. */
|
|
13
|
+
readonly outcome: Result<T, string>;
|
|
14
|
+
/** The failure category, or `undefined` when the outcome succeeded. */
|
|
15
|
+
readonly category: SlangErrorCategory | undefined;
|
|
16
|
+
/** Returns the value, or the fallback when the chain failed. */
|
|
17
|
+
else(fallback: T | ((error: string) => T)): T;
|
|
18
|
+
/** Returns the value, or throws when the chain failed. */
|
|
19
|
+
panic(message?: string): T;
|
|
20
|
+
};
|
|
21
|
+
//#endregion
|
|
22
|
+
//#region src/iterate.d.ts
|
|
23
|
+
/** The element produced when iterating `C`. */
|
|
24
|
+
type ElementOf<C> = C extends Iterable<infer E> ? E : never;
|
|
25
|
+
/**
|
|
26
|
+
* Lazily transforms a successful Result's collection. Finishing methods resolve with
|
|
27
|
+
* `.else`/`.panic`. The type parameter is the collection, so `Ok(users)` gives
|
|
28
|
+
* `IterateChain<User[]>` and its callbacks receive a `User`.
|
|
29
|
+
*/
|
|
30
|
+
type IterateChain<out C> = {
|
|
31
|
+
map<U>(fn: (value: ElementOf<C>, index: number) => U): IterateChain<U[]>;
|
|
32
|
+
filter(fn: (value: ElementOf<C>, index: number) => boolean): IterateChain<C>;
|
|
33
|
+
flatMap<U>(fn: (value: ElementOf<C>, index: number) => Iterable<U>): IterateChain<U[]>;
|
|
34
|
+
take(n: number): IterateChain<C>;
|
|
35
|
+
drop(n: number): IterateChain<C>;
|
|
36
|
+
chunk(size: number): IterateChain<ElementOf<C>[][]>;
|
|
37
|
+
reduce<U>(fn: (acc: U, value: ElementOf<C>, index: number) => U, seed: U): Fallible<U>;
|
|
38
|
+
count(): Fallible<number>;
|
|
39
|
+
toArray(): Fallible<readonly ElementOf<C>[]>;
|
|
40
|
+
};
|
|
41
|
+
//#endregion
|
|
1
42
|
//#region src/result.d.ts
|
|
2
43
|
declare const __result__: unique symbol;
|
|
3
44
|
export type Ok<T> = {
|
|
4
45
|
type: "Ok";
|
|
5
46
|
value: T;
|
|
47
|
+
/** Optional description of the success, such as a message to show the user. */
|
|
48
|
+
readonly message?: string;
|
|
49
|
+
/** Non-enumerable diagnostic payload, set by a collected or raw result. */
|
|
50
|
+
readonly raw?: unknown;
|
|
6
51
|
readonly isOk: true;
|
|
7
52
|
readonly isErr: false;
|
|
8
53
|
readonly [__result__]: true;
|
|
54
|
+
/**
|
|
55
|
+
* Lazily transforms the successful collection. Only a successful Result exposes this;
|
|
56
|
+
* a possible `Err` must be narrowed with `.isOk` first.
|
|
57
|
+
*/
|
|
58
|
+
iterate(): IterateChain<T>;
|
|
9
59
|
};
|
|
10
60
|
export type Err<E> = {
|
|
11
61
|
type: "Err";
|
|
12
62
|
error: E;
|
|
63
|
+
/** Non-enumerable diagnostic payload for the underlying cause. */
|
|
64
|
+
readonly raw?: unknown;
|
|
13
65
|
readonly isOk: false;
|
|
14
66
|
readonly isErr: true;
|
|
15
67
|
readonly [__result__]: true;
|
|
16
68
|
};
|
|
17
69
|
/** Discriminated union: mutually exclusive Ok or Err */
|
|
18
70
|
type Result<T, E> = (Ok<T> | Err<E>) & ResultMethods<T>;
|
|
71
|
+
/**
|
|
72
|
+
* Rest-parameter guard: a required element only when `T` is a Result, so wrapping a
|
|
73
|
+
* Result in another Result fails to compile while ordinary calls keep their inference.
|
|
74
|
+
*/
|
|
75
|
+
type NestedResultGuard<T> = [T] extends [never] ? [] : T extends {
|
|
76
|
+
readonly [__result__]: true;
|
|
77
|
+
} ? ["A Result cannot be nested inside another Result"] : [];
|
|
78
|
+
/**
|
|
79
|
+
* Rest-parameter guard for `safeTry`: a required element when the returned value is a
|
|
80
|
+
* Result whose own value is a Result. A Result may be returned; a Result inside it may not.
|
|
81
|
+
*/
|
|
82
|
+
type NestedValueGuard<T> = [T] extends [never] ? [] : T extends Result<infer Value, infer _Error> ? [Value] extends [never] ? [] : Value extends {
|
|
83
|
+
readonly [__result__]: true;
|
|
84
|
+
} ? ["A Result's value cannot be another Result"] : [] : [];
|
|
19
85
|
/** Methods available on a Result */
|
|
20
86
|
interface ResultMethods<T> {
|
|
21
87
|
/**
|
|
@@ -39,33 +105,39 @@ interface ResultMethods<T> {
|
|
|
39
105
|
};
|
|
40
106
|
/**
|
|
41
107
|
* Transforms the inner value if `Ok`, returns same `Err` if `Err`.
|
|
108
|
+
* - If fn returns a Result, it is returned as is; it is never wrapped again.
|
|
42
109
|
* - If fn returns `undefined`, returns original Result (no new allocation).
|
|
43
110
|
* - If fn throws, returns `Err(message)`.
|
|
44
111
|
* - Supports async functions, returning `Promise<Result<U, string>>`.
|
|
45
112
|
* @example
|
|
46
113
|
* Ok(5).andThen(x => x * 2); // Ok(10)
|
|
114
|
+
* Ok(5).andThen(x => Ok(x * 2)); // Ok(10) - a returned Result is flattened
|
|
47
115
|
* Err("fail").andThen(x => x * 2); // Err("fail")
|
|
48
116
|
* Ok(5).andThen(x => undefined); // Ok(5) - original
|
|
49
117
|
* await Ok(5).andThen(async x => x); // Ok(5)
|
|
50
118
|
*/
|
|
51
|
-
andThen<U>(fn: (value: T) => U | Promise<U
|
|
119
|
+
andThen<U>(fn: (value: T) => U | Result<U, string> | Promise<U | Result<U, string>>): Result<U, string> | Promise<Result<U, string>>;
|
|
52
120
|
}
|
|
53
121
|
/**
|
|
54
122
|
* Creates a new, successful result.
|
|
55
|
-
* @param value Value of the result
|
|
123
|
+
* @param value Value of the result. A Result is rejected; a Result never nests inside another Result.
|
|
124
|
+
* @param message Optional description of the success; omitted values leave no `message` property
|
|
56
125
|
* @example
|
|
57
126
|
* const a = Ok("hello");
|
|
58
127
|
* typeof a; // Ok<"hello">
|
|
128
|
+
* const b = Ok({ id: 1 }, "Project created");
|
|
129
|
+
* b.message; // "Project created"
|
|
59
130
|
*/
|
|
60
|
-
export declare function Ok<T>(value: T): Ok<T> & ResultMethods<T>;
|
|
131
|
+
export declare function Ok<T>(value: T, message?: string, ..._noNestedResult: NestedResultGuard<T>): Ok<T> & ResultMethods<T>;
|
|
61
132
|
/**
|
|
62
133
|
* Creates a new, failed result with a string error message.
|
|
63
134
|
* @param error Error message (must be a string)
|
|
135
|
+
* @param raw Optional underlying cause, kept as given and non-enumerable on `.raw`
|
|
64
136
|
* @example
|
|
65
137
|
* const a = Err("something went wrong");
|
|
66
138
|
* typeof a; // Err<string>
|
|
67
139
|
*/
|
|
68
|
-
export declare function Err(error: string): Err<string> & ResultMethods<never>;
|
|
140
|
+
export declare function Err(error: string, raw?: unknown): Err<string> & ResultMethods<never>;
|
|
69
141
|
//#endregion
|
|
70
142
|
//#region src/atom.d.ts
|
|
71
143
|
/** Unique symbol to brand atoms */
|
|
@@ -218,7 +290,7 @@ type EnvironmentOptions = {
|
|
|
218
290
|
};
|
|
219
291
|
/**
|
|
220
292
|
* Sets the runtime environment for dev-only utilities.
|
|
221
|
-
*
|
|
293
|
+
* Safe to call any number of times, in any order; the last call wins.
|
|
222
294
|
* Accepts a mode (full words or short forms: "development"/"dev", "production"/"prod")
|
|
223
295
|
* or options `{ printFn }` to route println through an existing logger instead of
|
|
224
296
|
* the console — useful in production, where logs go somewhere real.
|
|
@@ -267,11 +339,11 @@ type OptionsValue<T> = T extends {
|
|
|
267
339
|
* Returns the first usable value from a list as an `Ok`, or the fallback
|
|
268
340
|
* `Err` if none is usable.
|
|
269
341
|
*
|
|
270
|
-
* Normalizes
|
|
342
|
+
* Normalizes mixed values — raw values, `Option`s, and `Result`s
|
|
271
343
|
* from different sources — when all you care about is whether any of them
|
|
272
344
|
* is usable. A value is usable when its unwrapped inner value is truthy;
|
|
273
345
|
* `None`, `Err`, null, undefined, `""`, NaN, and Infinity are skipped.
|
|
274
|
-
* Note that `0` and `false`
|
|
346
|
+
* Note that `0` and `false` count as usable, just as they do in `option()`.
|
|
275
347
|
*
|
|
276
348
|
* @param values - Values to inspect in order; first usable one wins.
|
|
277
349
|
* @param fallback - `Err` returned when no value is usable (default `Err("No value!")`).
|
|
@@ -409,12 +481,18 @@ export declare function zipWith<T extends readonly any[], R>(inputs: { [K in key
|
|
|
409
481
|
export declare function unzip<T>(zipped: T[][]): T[][];
|
|
410
482
|
//#endregion
|
|
411
483
|
//#region src/safe-try.d.ts
|
|
412
|
-
/**
|
|
484
|
+
/** Final success value after resolving supported Slang wrappers. */
|
|
413
485
|
type SafeTryValue<T> = T extends Atom<infer Name> ? Name : T extends Ok<infer Value> ? SafeTryValue<Value> : T extends Some<infer Value> ? SafeTryValue<Value> : T extends Err<infer _Error> ? never : T extends None ? never : T;
|
|
414
486
|
/** Options for safeTry behavior */
|
|
415
487
|
type SafeTryOptions = {
|
|
416
488
|
/** If true, re-throws thrown errors instead of capturing them. */
|
|
417
489
|
throw?: boolean;
|
|
490
|
+
/**
|
|
491
|
+
* If true, collects every unwrapped layer and every failure on the returned
|
|
492
|
+
* Result's non-enumerable `raw`, shaped `{ errors, values }`. Entries are the
|
|
493
|
+
* raw values and raw failures, never a humanized message.
|
|
494
|
+
*/
|
|
495
|
+
collectValues?: boolean;
|
|
418
496
|
};
|
|
419
497
|
/**
|
|
420
498
|
* Captures failures and resolves nested Slang wrappers into one Result.
|
|
@@ -422,13 +500,16 @@ type SafeTryOptions = {
|
|
|
422
500
|
* - Returns the first Err or None as Err; cycles also return Err.
|
|
423
501
|
* - Leaves object properties, array elements, and wrapped Promise values intact.
|
|
424
502
|
* - `{ throw: true }` re-throws thrown errors; returned failures remain Err.
|
|
503
|
+
* - `{ collectValues: true }` records every unwrapped layer and failure on
|
|
504
|
+
* `result.raw` as `{ errors, values }`.
|
|
505
|
+
* - A caught throw reaches the caller as `Err(message)`, with the thrown value on `.raw`.
|
|
425
506
|
*
|
|
426
507
|
* @param fn - Function to execute (sync or async)
|
|
427
|
-
* @param options - `{ throw?: boolean }`
|
|
428
|
-
* @returns Promise of one Result containing the
|
|
508
|
+
* @param options - `{ throw?: boolean; collectValues?: boolean }`
|
|
509
|
+
* @returns Promise of one Result containing the final success value or error text
|
|
429
510
|
*
|
|
430
511
|
* @example
|
|
431
|
-
* const result = await safeTry(() => Ok(
|
|
512
|
+
* const result = await safeTry(() => Ok(option("Hello")));
|
|
432
513
|
* if (result.isOk) println(result.value); // "Hello"
|
|
433
514
|
*
|
|
434
515
|
* @example
|
|
@@ -437,7 +518,207 @@ type SafeTryOptions = {
|
|
|
437
518
|
* });
|
|
438
519
|
* if (result.isErr) println(result.error);
|
|
439
520
|
*/
|
|
440
|
-
export declare function safeTry<T>(fn: () => T | Promise<T>, options?: SafeTryOptions): Promise<Result<SafeTryValue<Awaited<T>>, string>>;
|
|
521
|
+
export declare function safeTry<T>(fn: () => T | Promise<T>, options?: SafeTryOptions, ..._noNestedResult: NestedValueGuard<Awaited<T>>): Promise<Result<SafeTryValue<Awaited<T>>, string>>;
|
|
522
|
+
//#endregion
|
|
523
|
+
//#region src/list.d.ts
|
|
524
|
+
/** Accepted list input: a raw array, or a narrowed successful `Ok` holding one. */
|
|
525
|
+
type ListInput<T> = readonly T[] | (Ok<readonly T[]> & {
|
|
526
|
+
readonly isOk: true;
|
|
527
|
+
});
|
|
528
|
+
/** Reads an index, optionally with a fallback of a different type. */
|
|
529
|
+
type ListGet<T> = {
|
|
530
|
+
(index: number): Fallible<T>;
|
|
531
|
+
<U>(index: number, fallback: U): Fallible<T | U>;
|
|
532
|
+
};
|
|
533
|
+
/** A successful list chain plus its finite indexed operations. */
|
|
534
|
+
type ListChain<T> = Fallible<readonly T[]> & {
|
|
535
|
+
get: ListGet<T>;
|
|
536
|
+
take(n: number): ListChain<T>;
|
|
537
|
+
skip(n: number): ListChain<T>;
|
|
538
|
+
range(start: number, end: number): ListChain<T>;
|
|
539
|
+
chunk(size: number): ListChain<readonly T[]>;
|
|
540
|
+
count(): Fallible<number>;
|
|
541
|
+
prune(predicate?: (value: T, index: number) => boolean): ListChain<T>;
|
|
542
|
+
};
|
|
543
|
+
/**
|
|
544
|
+
* Wraps a finite array (or a narrowed successful `Ok` holding one) in a list chain.
|
|
545
|
+
* Invalid bounds and counts fail the chain; resolve with `.else(...)` or `.panic(...)`.
|
|
546
|
+
*
|
|
547
|
+
* @example
|
|
548
|
+
* list([10, 20, 30]).take(2).else([]); // [10, 20]
|
|
549
|
+
* list([10, 20, 30]).range(1, 9).else([]); // []
|
|
550
|
+
* list([10, 20, 30]).take(2).panic(); // [10, 20]
|
|
551
|
+
*/
|
|
552
|
+
export declare function list<T>(input: ListInput<T>): ListChain<T>;
|
|
553
|
+
//#endregion
|
|
554
|
+
//#region src/struct.d.ts
|
|
555
|
+
/** The row type of a collection passed to `struct`. */
|
|
556
|
+
type StructRow<T> = T extends readonly (infer Row)[] ? Row : unknown;
|
|
557
|
+
/** Reads a property path; a known top-level key keeps its value type. */
|
|
558
|
+
type StructGet<T> = T extends readonly unknown[] ? {
|
|
559
|
+
(path: string | readonly string[]): Fallible<unknown>;
|
|
560
|
+
<U>(path: string | readonly string[], fallback: U): Fallible<unknown>;
|
|
561
|
+
} : {
|
|
562
|
+
<K extends keyof T & string>(path: K): Fallible<T[K]>;
|
|
563
|
+
<K extends keyof T & string, U>(path: K, fallback: U): Fallible<T[K] | U>;
|
|
564
|
+
(path: string | readonly string[]): Fallible<unknown>;
|
|
565
|
+
<U>(path: string | readonly string[], fallback: U): Fallible<unknown>;
|
|
566
|
+
};
|
|
567
|
+
/** A successful struct chain plus its record and aggregation operations. */
|
|
568
|
+
type StructChain<T> = Fallible<T> & {
|
|
569
|
+
get: StructGet<T>;
|
|
570
|
+
pick<K extends keyof T & string>(...keys: K[]): StructChain<Pick<T, K>>;
|
|
571
|
+
omit<K extends keyof T & string>(...keys: K[]): StructChain<Omit<T, K>>;
|
|
572
|
+
merge(source: Record<string, unknown>): StructChain<T>;
|
|
573
|
+
count(): Fallible<number>;
|
|
574
|
+
countBy(selector: (row: StructRow<T>) => PropertyKey): Fallible<Record<string, number>>;
|
|
575
|
+
keyBy(selector: (row: StructRow<T>) => PropertyKey): Fallible<Record<string, StructRow<T>>>;
|
|
576
|
+
prune(predicate?: (value: unknown, key: string) => boolean): StructChain<T>;
|
|
577
|
+
};
|
|
578
|
+
/**
|
|
579
|
+
* Wraps a record, or a collection of records, in a struct chain.
|
|
580
|
+
* A narrowed successful `Ok` is accepted; an `Err` is refused.
|
|
581
|
+
* Invalid input and missing paths fail the chain; resolve with `.else(...)` or `.panic(...)`.
|
|
582
|
+
*
|
|
583
|
+
* @example
|
|
584
|
+
* struct(user).get(["profile", "city"]).else("unknown");
|
|
585
|
+
* struct(user).pick("id", "name").else({});
|
|
586
|
+
* struct(rows).countBy((row) => row.role).else({});
|
|
587
|
+
*/
|
|
588
|
+
export declare function struct<T>(input: Ok<T> & {
|
|
589
|
+
readonly isOk: true;
|
|
590
|
+
}): StructChain<T>;
|
|
591
|
+
export declare function struct<T extends Record<string, unknown> | readonly unknown[]>(input: T): StructChain<T>;
|
|
592
|
+
//#endregion
|
|
593
|
+
//#region src/sets.d.ts
|
|
594
|
+
/** Accepted set input: any iterable, Set, Map (keys), plain object (keys), or a narrowed Ok. */
|
|
595
|
+
type SetsInput = Iterable<unknown> | Set<unknown> | ReadonlyMap<unknown, unknown> | Record<string, unknown> | (Ok<Iterable<unknown> | Set<unknown> | ReadonlyMap<unknown, unknown> | Record<string, unknown>> & {
|
|
596
|
+
readonly isOk: true;
|
|
597
|
+
});
|
|
598
|
+
/** The element type a supported set input contributes. */
|
|
599
|
+
type SetsElement<I> = I extends Ok<infer V> ? SetsElement<V> : I extends ReadonlyMap<infer K, unknown> ? K : I extends Set<infer V> ? V : I extends Iterable<infer V> ? V : I extends Record<string, unknown> ? string : never;
|
|
600
|
+
/** A successful set chain plus membership and algebra operations. */
|
|
601
|
+
type SetsChain<T = unknown> = Fallible<Set<T>> & {
|
|
602
|
+
has(value: T): Fallible<boolean>;
|
|
603
|
+
unique(): SetsChain<T>;
|
|
604
|
+
union<I extends SetsInput>(other: I): SetsChain<T | SetsElement<I>>;
|
|
605
|
+
intersection<I extends SetsInput>(other: I): SetsChain<T>;
|
|
606
|
+
difference<I extends SetsInput>(other: I): SetsChain<T>;
|
|
607
|
+
count(): Fallible<number>;
|
|
608
|
+
};
|
|
609
|
+
/**
|
|
610
|
+
* Wraps a collection in a set chain. Object input means its own enumerable keys.
|
|
611
|
+
* Resolve with `.else(...)` or `.panic(...)`.
|
|
612
|
+
*
|
|
613
|
+
* @example
|
|
614
|
+
* sets({ read: true, write: false }).has("write").else(false); // true
|
|
615
|
+
* sets([1, 2, 2, 3]).unique().else(new Set()); // Set(1, 2, 3)
|
|
616
|
+
*/
|
|
617
|
+
export declare function sets(input: Record<string, unknown>): SetsChain<string>;
|
|
618
|
+
export declare function sets<K>(input: ReadonlyMap<K, unknown>): SetsChain<K>;
|
|
619
|
+
export declare function sets<T>(input: Set<T> | Iterable<T>): SetsChain<T>;
|
|
620
|
+
export declare function sets(input: Ok<Record<string, unknown>> & {
|
|
621
|
+
readonly isOk: true;
|
|
622
|
+
}): SetsChain<string>;
|
|
623
|
+
export declare function sets<K>(input: Ok<ReadonlyMap<K, unknown>> & {
|
|
624
|
+
readonly isOk: true;
|
|
625
|
+
}): SetsChain<K>;
|
|
626
|
+
export declare function sets<T>(input: Ok<Set<T> | Iterable<T>> & {
|
|
627
|
+
readonly isOk: true;
|
|
628
|
+
}): SetsChain<T>;
|
|
629
|
+
//#endregion
|
|
630
|
+
//#region src/memoized.d.ts
|
|
631
|
+
/** A memoized function that also exposes `clear()`. */
|
|
632
|
+
type Memoized<Args extends unknown[], R> = ((...args: Args) => R) & {
|
|
633
|
+
clear(): void;
|
|
634
|
+
};
|
|
635
|
+
/**
|
|
636
|
+
* Caches a function's result by its arguments.
|
|
637
|
+
* Primitives compare by value (SameValueZero); objects compare by identity.
|
|
638
|
+
* `undefined` is a cacheable result; a thrown error is not cached; a rejected
|
|
639
|
+
* Promise is removed from the cache so a later call can retry.
|
|
640
|
+
*
|
|
641
|
+
* @example
|
|
642
|
+
* const add = memoized((a: number, b: number) => a + b);
|
|
643
|
+
* add(1, 2); // computes
|
|
644
|
+
* add(1, 2); // cache hit
|
|
645
|
+
* add.clear();
|
|
646
|
+
*/
|
|
647
|
+
export declare function memoized<Args extends unknown[], R>(fn: (...args: Args) => R): Memoized<Args, R>;
|
|
648
|
+
//#endregion
|
|
649
|
+
//#region src/task-group.d.ts
|
|
650
|
+
/** Options for a shared task group. */
|
|
651
|
+
type TaskGroupOptions = {
|
|
652
|
+
/** Maximum tasks active at once. Defaults to unlimited. */
|
|
653
|
+
concurrency?: number;
|
|
654
|
+
/** Minimum milliseconds between starts. Defaults to 0. */
|
|
655
|
+
throttle?: number;
|
|
656
|
+
};
|
|
657
|
+
/** A shared group that limits concurrency and spaces out starts for tasks and runners. */
|
|
658
|
+
type TaskGroup = {
|
|
659
|
+
readonly name: string;
|
|
660
|
+
/**
|
|
661
|
+
* Waits for a free slot, then returns a release callback.
|
|
662
|
+
* A retry needs a new slot and must call this again.
|
|
663
|
+
*/
|
|
664
|
+
acquire(): Promise<() => void>;
|
|
665
|
+
};
|
|
666
|
+
/**
|
|
667
|
+
* Creates a shared task group enforcing concurrency and start spacing.
|
|
668
|
+
* A group does not cancel running work and does not manage idempotency.
|
|
669
|
+
*
|
|
670
|
+
* @example
|
|
671
|
+
* const api = taskGroup("user-api", { concurrency: 3, throttle: 200 });
|
|
672
|
+
* superPromise(fetchUsers, { group: api });
|
|
673
|
+
*/
|
|
674
|
+
export declare function taskGroup(name: string, options?: TaskGroupOptions): TaskGroup;
|
|
675
|
+
//#endregion
|
|
676
|
+
//#region src/stepper.d.ts
|
|
677
|
+
/** A named step value. */
|
|
678
|
+
type Step<T> = {
|
|
679
|
+
key: string;
|
|
680
|
+
value: T;
|
|
681
|
+
};
|
|
682
|
+
/** Builds a candidate step from one named object. */
|
|
683
|
+
type StepFactory<T> = (step: Step<T>) => Step<T>;
|
|
684
|
+
/** Computes the next step from the current one. */
|
|
685
|
+
type StepFn<T> = (previous: Step<T> | undefined, make: StepFactory<T>) => Step<T> | Promise<Step<T>>;
|
|
686
|
+
/** Reconstructs a dropped step from its nearest stored neighbors. */
|
|
687
|
+
type PrevRecover<T> = (previous: Step<T> | undefined, make: StepFactory<T>, next: Step<T> | undefined) => Step<T>;
|
|
688
|
+
/** Stepper configuration. */
|
|
689
|
+
type StepperConfig = {
|
|
690
|
+
/** Retained step values. Defaults to 50. */
|
|
691
|
+
maxHistory?: number;
|
|
692
|
+
/** Successful forward commits over the Stepper's lifetime. `null` is unlimited. Defaults to `null`. */
|
|
693
|
+
maxSteps?: number | null;
|
|
694
|
+
/** Optional extra acceptance check for a step key. */
|
|
695
|
+
keyEvalFn?: (key: string) => boolean | Promise<boolean>;
|
|
696
|
+
};
|
|
697
|
+
/** Options for `next`. */
|
|
698
|
+
type NextOptions = {
|
|
699
|
+
fallback?: boolean;
|
|
700
|
+
};
|
|
701
|
+
/** A backward navigation that must be finished with `.else(...)` or `.panic(...)`. */
|
|
702
|
+
type PrevResolution<T> = {
|
|
703
|
+
else(recover: PrevRecover<T>): Step<T>;
|
|
704
|
+
panic(message?: string): Step<T>;
|
|
705
|
+
};
|
|
706
|
+
/** A small navigable history engine. */
|
|
707
|
+
type Stepper<T> = {
|
|
708
|
+
next(fn: StepFn<T>, options?: NextOptions): Promise<Result<Step<T>, string>>;
|
|
709
|
+
prev(offset?: number): PrevResolution<T>;
|
|
710
|
+
readonly current: Step<T> | undefined;
|
|
711
|
+
readonly size: number;
|
|
712
|
+
};
|
|
713
|
+
/**
|
|
714
|
+
* Creates a keyed step navigator with bounded retained history.
|
|
715
|
+
*
|
|
716
|
+
* @example
|
|
717
|
+
* const steps = createStepper({ maxHistory: 50 });
|
|
718
|
+
* const step = await steps.next((prev, make) => make({ key: "start", value: 1 }));
|
|
719
|
+
* const again = steps.prev().else((prev, make) => make({ key: "restored", value: 0 }));
|
|
720
|
+
*/
|
|
721
|
+
export declare function createStepper<T>(config?: StepperConfig): Stepper<T>;
|
|
441
722
|
//#endregion
|
|
442
723
|
//#region src/pipe.d.ts
|
|
443
724
|
/** Function that transforms one Result into another */
|
|
@@ -509,10 +790,12 @@ type SuperPromiseOptions = {
|
|
|
509
790
|
retry?: number;
|
|
510
791
|
/** Keep retrying until the stop signal fires. Overrides `retry` and `delay`. */
|
|
511
792
|
retryUntil?: RetryUntilOptions;
|
|
793
|
+
/** Shared task group this task runs through. A retry waits for a new slot. */
|
|
794
|
+
group?: TaskGroup;
|
|
512
795
|
};
|
|
513
|
-
/** A single async operation with
|
|
796
|
+
/** A single async operation with start, retry, timeout, and cancel controls. Promise-compatible. */
|
|
514
797
|
type SuperPromise<T> = {
|
|
515
|
-
/**
|
|
798
|
+
/** Fires once when the task finishes. */
|
|
516
799
|
done: AbortSignal;
|
|
517
800
|
/** Cancels the operation; settles with `Err("Aborted")` when not yet settled. */
|
|
518
801
|
abort(): void;
|
|
@@ -530,11 +813,11 @@ type SuperPromise<T> = {
|
|
|
530
813
|
finally(onfinally?: (() => void) | null): Promise<Result<T, string>>;
|
|
531
814
|
};
|
|
532
815
|
/**
|
|
533
|
-
* Creates a SuperPromise — one async operation plus
|
|
816
|
+
* Creates a SuperPromise — one async operation plus start, retry, timeout, and cancel controls.
|
|
534
817
|
*
|
|
535
|
-
* Lazy
|
|
536
|
-
*
|
|
537
|
-
*
|
|
818
|
+
* Lazy start: your function runs on first use (`await`/`.then()`, or a runner's `start()`),
|
|
819
|
+
* not at creation. Defer chains start recursively, so awaiting a deferred task runs its
|
|
820
|
+
* dependency first.
|
|
538
821
|
*
|
|
539
822
|
* @example
|
|
540
823
|
* const task = superPromise(async signal => {
|
|
@@ -555,11 +838,11 @@ type TupleValues<R extends readonly SuperPromise<unknown>[]> = { -readonly [K in
|
|
|
555
838
|
type NamedValues<R extends Record<string, SuperPromise<unknown>>> = { [K in keyof R]: R[K] extends SuperPromise<infer T> ? T : never; };
|
|
556
839
|
/** race(count: 1) result: union of single-winner objects. */
|
|
557
840
|
type RaceValues<C extends number, R extends Record<string, SuperPromise<unknown>>> = C extends 1 ? { [K in keyof R]: { [P in K]: R[K] extends SuperPromise<infer T> ? T : never; }; }[keyof R] : Partial<NamedValues<R>>;
|
|
558
|
-
/**
|
|
841
|
+
/** Manages several already-created SuperPromise instances. */
|
|
559
842
|
type SuperRunner<Value> = {
|
|
560
|
-
/**
|
|
843
|
+
/** Fires once when the runner finishes. */
|
|
561
844
|
done: AbortSignal;
|
|
562
|
-
/** Starts execution
|
|
845
|
+
/** Starts execution once; later calls return the same result without re-running children. */
|
|
563
846
|
start(): Promise<Result<Value, string>>;
|
|
564
847
|
/** Cancels the runner and all active children; settles with `Err("Aborted")`. */
|
|
565
848
|
abort(): void;
|
|
@@ -626,11 +909,11 @@ export declare function createChannel(): Channel;
|
|
|
626
909
|
/**
|
|
627
910
|
* A lifecycle Signal — a trigger that fires once and stays fired.
|
|
628
911
|
*
|
|
629
|
-
*
|
|
912
|
+
* ... structurally an `AbortSignal` plus a `fire()` method,
|
|
630
913
|
* so it can be passed anywhere a native `AbortSignal` is expected
|
|
631
|
-
* (and vice-versa). Wraps AbortController
|
|
914
|
+
* (and vice-versa). Wraps `AbortController` behavior.
|
|
632
915
|
*
|
|
633
|
-
*
|
|
916
|
+
* Used by `defer`, `retryUntil`, `channel.when`, and `task.done`.
|
|
634
917
|
*/
|
|
635
918
|
type Signal = AbortSignal & {
|
|
636
919
|
/** Fires the signal once. Subsequent calls are no-ops. */
|
|
@@ -655,4 +938,4 @@ type Signal = AbortSignal & {
|
|
|
655
938
|
*/
|
|
656
939
|
export declare function createSignal(): Signal;
|
|
657
940
|
//#endregion
|
|
658
|
-
export type { Atom, AtomMethods, Channel, ChannelEvent, ChannelSubscriber, EnvironmentMode, EnvironmentOptions, Err as ErrType, Executor, NonTruthy, None, Ok as OkType, Option, OptionMethods, OptionsValue, PipeEachContext, PipeFn, PipeRunOptions, Pipeline, PrintFn, Result, ResultMethods, RetryUntilOptions, Signal, Some, SuperPromise, SuperPromiseOptions, SuperRunner };
|
|
941
|
+
export type { Atom, AtomMethods, Channel, ChannelEvent, ChannelSubscriber, EnvironmentMode, EnvironmentOptions, Err as ErrType, Executor, Fallible, IterateChain, ListChain, ListGet, ListInput, Memoized, NextOptions, NonTruthy, None, Ok as OkType, Option, OptionMethods, OptionsValue, PipeEachContext, PipeFn, PipeRunOptions, Pipeline, PrevRecover, PrevResolution, PrintFn, Result, ResultMethods, RetryUntilOptions, SetsChain, SetsInput, Signal, SlangErrorCategory, Some, Step, StepFactory, StepFn, Stepper, StepperConfig, StructChain, StructGet, SuperPromise, SuperPromiseOptions, SuperRunner, TaskGroup, TaskGroupOptions };
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=e=>{let t=globalThis?.queueMicrotask;typeof t==`function`?t(e):Promise.resolve().then(e)},t=e=>typeof e==`object`&&!!e&&`type`in e&&(e.type===`Ok`||e.type===`Err`),n=Symbol(`slang.activate`),r=e=>typeof e==`object`&&!!e&&`isSome`in e&&`isNone`in e,i=e=>typeof e==`object`&&!!e&&typeof e.valueOf?.()==`symbol`;function a(e){return i(e)?{ok:!0,value:e.valueOf().description}:t(e)?e.isOk?{ok:!0,value:e.value}:{ok:!1,error:
|
|
2
|
-
`);s?s(t):o!==`production`&&globalThis.console?.log?.(t)};function d(e){throw Error(e)}function f(t){let n=Object.freeze({type:`Ok`,value:t,isOk:!0,isErr:!1}),r=e=>{try{let t=e(n.value);return t instanceof Promise?t.then(e=>e===void 0?i:f(e)).catch(e=>p(e instanceof Error?e.message:String(e))):t===void 0?i:f(t)}catch(e){return p(e instanceof Error?e.message:String(e))}},i={...n,expect:(e=>n.value),unwrap:(()=>(e(()=>{}),{else(e){return n.value}})),andThen:r};return i}function p(t){let n=Object.freeze({type:`Err`,error:t,isOk:!1,isErr:!0}),r=e=>i,i={...n,expect:(e=>{throw Error(e??t)}),unwrap:(()=>{let n=!1;return e(()=>{if(!n)throw Error(t)}),{else(e){return n=!0,typeof e==`function`?e(t):e}}}),andThen:r};return i}const m=e=>e==null||e===``||Number.isNaN(e)||e===1/0||e===-1/0;function h(e){if(m(e))throw Error(`Cannot wrap null, undefined, NaN, or empty string in Some`);return Object.freeze({type:`Some`,value:e,isSome:!0,isNone:!1})}const g=Object.freeze({type:`None`,isSome:!1,isNone:!0});let _=null;function v(e){_=e}function y(t){let n=m(t)?g:h(t),r=(e=>{if(!_)throw Error(`Converter not initialized`);return _(n,e)}),i=(e=>{if(n.isSome)return n.value;throw Error(e??`Expected Some, got None`)}),a=(()=>{let t=!1,r=n;return e(()=>{if(!t)throw Error(`Expected else`)}),{else(e){if(t=!0,r.isSome)return r.value;let n=typeof e==`function`?e(void 0):e;if(m(n))throw Error(`Fallback must be truthy`);return n}}}),o=(e=>{let t=n;if(t.isNone)return s;let r=t.value;try{let t=e(r);return t instanceof Promise?t.then(e=>e===void 0?s:y(e)).catch(()=>y(null)):t===void 0?s:y(t)}catch{return y(null)}}),s={...n,to:r,expect:i,unwrap:a,andThen:o};return s}const b=e=>{if(typeof e!=`object`||!e)return e;let t=e;return t.isSome===!0||t.isOk===!0?t.value:e},x=e=>{if(typeof e==`object`&&e){let t=e;if(t.isNone===!0||t.isErr===!0)return!0}return m(b(e))};function S(e,t=p(`No value!`)){for(let t of e)if(!x(t))return f(b(t));return t}let C=null;function w(e){C=e}function T(e){let t=Symbol(e),n=Object(t);return n.to=(e=>{if(!C)throw Error(`Converter not initialized`);return C(t,e)}),n.andThen=t=>{let r;try{r=t(e)}catch(e){d(`Atom.andThen: fn threw an error: ${e instanceof Error?e.message:String(e)}`)}return r===void 0?n:(typeof r!=`string`&&d(`Atom.andThen: fn must return a string, got ${typeof r}`),T(r))},n}const E=e=>typeof e==`object`&&!!e&&`isSome`in e&&`isNone`in e;function D(e,t){if(e&&(e.type===`Ok`||e.type===`Err`))throw Error(`Cannot convert a Result to any other type`);switch(t){case`option`:return E(e)?e:y(typeof e==`symbol`?e.description:e);case`atom`:if(E(e)){if(e.isNone)throw Error(`Cannot convert None to Atom`);if(typeof e.value!=`string`)throw Error(`Only string values can be converted to Atom`);return T(e.value)}if(typeof e==`symbol`)return e;throw Error(`Cannot convert type ${typeof e} to Atom`);case`result`:return E(e)?e.isSome?f(e.value):p(`Value is None`):f(typeof e==`symbol`?e.description:e);default:throw Error(`Invalid target: ${t}`)}}v(D),w(D);function O(e,t){let n=t[e.type];if(!n)throw Error(`Non-exhaustive match — missing handler for '${e.type}'`);return n(e)}const k=e=>typeof e==`string`||typeof e==`number`||typeof e==`boolean`||typeof e==`symbol`;function A(e,t){let n=e=>typeof e?.valueOf==`function`?e.valueOf():e,r=e=>typeof e==`symbol`?e.description:void 0,i=n(e);if(!k(i))throw Error(`Unsupported match all value type: ${typeof i}`);let a=r(i)??i,o=typeof a==`boolean`||typeof a==`number`?String(a):a;return o!=null&&o in t?t[o](e):t._()}function j(e,t=!1){if(!t&&!Array.isArray(e))throw Error(`Only arrays allowed when includeValues=false`);return Array.isArray(e)?e:e instanceof Set?Array.from(e):Object.values(e)}function M(e,t){let{fillValue:n,includeValues:r=!1}=t||{};if(e.length===0)return[];let i=e.map(e=>j(e,r)),a=Math.max(...i.map(e=>e.length)),o=Math.min(...i.map(e=>e.length)),s=n===void 0?o:a,c=[];for(let e=0;e<s;e++)c.push(i.map(t=>e<t.length?t[e]:n));return c}function N(e,t,n){return M(e,n).map(t)}function P(e){if(e.length===0)return[];let t=e[0]?.length??0,n=Array.from({length:t},()=>[]);for(let t of e)t.forEach((e,t)=>n[t]?.push(e));return n}async function F(e,n){let o=n?.throw??!1;try{let n=a(await e()),o=/* @__PURE__ */ new Set;for(;n.ok;){let e=n.value;if(!i(e)&&!t(e)&&!r(e))return f(e);if(typeof e==`object`&&e){if(o.has(e))return p(`Cannot resolve a circular value`);o.add(e)}n=a(e)}return p(n.error)}catch(e){let t=e instanceof Error?e.message:String(e);if(o)throw e instanceof Error?e:Error(t);return p(t)}}function I(e){return e.error??`Unknown error`}function L(e){let t=a(e);return t.ok?f(t.value):p(t.error)}async function R(e,n){try{let r=await e(n);return t(r)?r:p(`Pipeline function must return a Result`)}catch(e){return p(e instanceof Error?e.message:String(e))}}function z(e,...t){return{async run(n){let{onEach:r,onSuccess:i,onError:a,allowErrors:o=!1}=n??{},s=L(e);for(let e=0;e<t.length;e++){let n=t[e],i=t[e+1];if(s.isErr&&!o)return a?.(Error(I(s))),s;s=await R(n,s),r?.({prevResult:s,currentFn:n.name||`fn${e+1}`,nextFn:i?i.name||`fn${e+2}`:void 0})}return s.isOk?i?.(s.value):a?.(Error(I(s))),s}}}function B(){let e=new AbortController;return Object.assign(e.signal,{fire:()=>e.abort()})}const V=e=>e instanceof Error?e.message:String(e),H=(e,t)=>{if(e.aborted)return t.abort(),()=>{};let n=()=>t.abort();return e.addEventListener(`abort`,n,{once:!0}),()=>e.removeEventListener(`abort`,n)};function U(e,t={}){let r=new AbortController,i=B(),o=()=>{},s=new Promise(e=>{o=e}),c=!1,l=!1,u=e=>{l||(l=!0,o(e),i.fire())},d=async(e,n,i)=>{let o=!1,s,c=i===void 0?()=>{}:H(i,n),l=H(r.signal,n);t.timeout!==void 0&&(s=setTimeout(()=>{o=!0,n.abort()},t.timeout));let u=e=>(s!==void 0&&clearTimeout(s),c(),l(),e);try{let t=a(await e(n.signal));return n.signal.aborted?r.signal.aborted?u({kind:`aborted`}):i?.aborted?u({kind:`stopped`}):u(o?{kind:`timedOut`}:{kind:`aborted`}):t.ok?u({kind:`value`,value:t.value}):u({kind:`error`,error:t.error})}catch(e){return r.signal.aborted?u({kind:`aborted`}):i?.aborted?u({kind:`stopped`}):n.signal.aborted?u(o?{kind:`timedOut`}:{kind:`aborted`}):u({kind:`error`,error:V(e)})}},m=e=>new Promise(t=>{if(e.aborted){t();return}e[n]?.();let i=()=>{a(),t()},a=()=>{e.removeEventListener(`abort`,i),r.signal.removeEventListener(`abort`,i)};e.addEventListener(`abort`,i,{once:!0}),r.signal.addEventListener(`abort`,i,{once:!0})}),h=e=>new Promise(t=>{if(r.signal.aborted){t();return}let n=()=>{clearTimeout(a),i(),t()},i=()=>r.signal.removeEventListener(`abort`,n),a=setTimeout(n,e);r.signal.addEventListener(`abort`,n,{once:!0})}),g=async()=>{let{defer:n,delay:i,retry:a,retryUntil:o}=t,s=e;if(s===void 0)return;if(r.signal.aborted||n!==void 0&&(await m(n),r.signal.aborted))return u(p(`Aborted`));if(o!==void 0){let e=o.signal;for(;;){if(r.signal.aborted)return u(p(`Aborted`));if(e.aborted)return u(p(`Stopped`));let t=new AbortController,n=await d(s,t,e);switch(n.kind){case`value`:return u(f(n.value));case`aborted`:return u(p(`Aborted`));case`stopped`:return u(p(`Stopped`));case`timedOut`:case`error`:if(r.signal.aborted)return u(p(`Aborted`));if(e.aborted)return u(p(`Stopped`));o.delay!==void 0&&await h(o.delay)}}}if(a!==void 0&&a>0){let e=a;for(;;){if(r.signal.aborted||(i!==void 0&&await h(i),r.signal.aborted))return u(p(`Aborted`));let t=new AbortController,n=await d(s,t,void 0);switch(n.kind){case`value`:return u(f(n.value));case`aborted`:return u(p(`Aborted`));case`timedOut`:return u(p(`Timed out`));case`stopped`:return u(p(`Stopped`));case`error`:if(e>0){--e;continue}return u(p(n.error))}}}if(i!==void 0&&await h(i),r.signal.aborted)return u(p(`Aborted`));let c=new AbortController,l=await d(s,c,void 0);switch(l.kind){case`value`:return u(f(l.value));case`aborted`:return u(p(`Aborted`));case`timedOut`:return u(p(`Timed out`));case`stopped`:return u(p(`Stopped`));case`error`:return u(p(l.error))}},_=()=>{c||(c=!0,e!==void 0&&g())};i[n]=_;let v={done:i,abort:()=>{r.abort(),u(p(`Aborted`))},resolve:e=>u(f(e)),reject:e=>u(p(V(e))),tap:e=>U(async()=>{let t=await v;return t.isOk&&await e(t.value),t}),then:(e,t)=>(_(),s.then(e,t)),catch:e=>(_(),s.catch(e)),finally:e=>(_(),s.finally(e))};return v}function W(e){let{type:t}=e;if(t===`race`&&e.count<1)throw Error(`superRunner race count must be at least 1`);let r=new AbortController,i=B(),a=()=>{},o=new Promise(e=>{a=e}),s=!1,c=!1,l=e=>{c||(c=!0,a(e),i.fire())},u=t===`sequence`?e.runners:Object.values(e.runners),d=()=>{for(let e of u)e.abort()},m=async e=>{let t=[];for(let n of e){if(r.signal.aborted)return l(p(`Aborted`));let e=await n;if(r.signal.aborted)return l(p(`Aborted`));if(e.isErr)return l(p(e.error));t.push(e.value)}l(f(t))},h=async e=>{let t=Object.entries(e),n={},i=0;for(let[e,a]of t)a.then(a=>{if(i+=1,a.isOk)n[e]=a.value;else if(!r.signal.aborted&&!c){d(),l(p(a.error));return}i===t.length&&l(f(n))});t.length===0&&l(f(n))},g=async(e,t)=>{let n=Object.entries(e),r={},i=0,a=0;for(let[e,o]of n)o.then(o=>{a+=1,o.isOk&&(r[e]=o.value,i+=1,i>=t)?(d(),l(f(r))):a===n.length&&l(p(i===0?`All runners failed`:`Not enough runners succeeded`))});n.length===0&&l(p(`All runners failed`))},_=()=>(s||(s=!0,t===`sequence`?m(e.runners):t===`all`?h(e.runners):g(e.runners,e.count)),o);return i[n]=_,{done:i,start:_,abort:()=>{r.abort(),d(),l(p(`Aborted`))}}}function G(){let e=/* @__PURE__ */ new Map,t=t=>{let n=e.get(t.topic);if(n!==void 0)for(let e of n)try{e(t)}catch(e){u(`channel subscriber threw:`,e)}};return{send:t,subscribe:(t,n)=>{let r=e.get(t.topic);return r===void 0&&(r=/* @__PURE__ */ new Set,e.set(t.topic,r)),r.add(n),()=>{let r=e.get(t.topic);r!==void 0&&r.delete(n)}},when:e=>{e.signal.aborted?t({topic:e.topic,data:e.data}):e.signal.addEventListener(`abort`,()=>t({topic:e.topic,data:e.data}),{once:!0})}}}export{p as Err,f as Ok,S as Options,D as _to,T as atom,G as createChannel,B as createSignal,m as isFalsy,O as match,A as matchAll,y as option,d as panic,z as pipe,u as println,F as safeTry,e as scheduleMicrotask,c as setEnvironment,U as superPromise,W as superRunner,P as unzip,M as zip,N as zipWith};
|
|
1
|
+
const e=e=>{let t=globalThis?.queueMicrotask;typeof t==`function`?t(e):Promise.resolve().then(e)},t=e=>typeof e==`object`&&!!e&&`type`in e&&(e.type===`Ok`||e.type===`Err`),n=Symbol(`slang.activate`),r=e=>typeof e==`object`&&!!e&&`isSome`in e&&`isNone`in e,i=e=>typeof e==`object`&&!!e&&typeof e.valueOf?.()==`symbol`;function a(e){return i(e)?{ok:!0,value:e.valueOf().description}:t(e)?e.isOk?{ok:!0,value:e.value}:{ok:!1,error:l(e.error)}:r(e)?e.isSome?{ok:!0,value:e.value}:{ok:!1,error:`Option was None`}:{ok:!0,value:e}}function o(e){let t=e;for(let e of[`message`,`error`,`reason`]){let n=t[e];if(typeof n==`string`&&n.length>0)return n}}function s(e,t){return e.length>t?`${e.slice(0,t)}...`:e}function c(e){let t=/* @__PURE__ */ new WeakSet;try{let n=JSON.stringify(e,(e,n)=>{if(typeof n==`bigint`)return n.toString();if(typeof n!=`function`&&typeof n!=`symbol`){if(typeof n==`object`&&n){if(t.has(n))return`[Circular]`;t.add(n)}return n}});if(typeof n==`string`&&n.length>0&&n!==`{}`)return n}catch{}return Object.prototype.toString.call(e)}function l(e,t=512){if(e instanceof Error)return e.message;if(typeof e==`string`)return e;if(typeof e==`bigint`)return e.toString();if(e==null)return String(e);if(typeof e==`object`){let n=o(e);return s(n===void 0?c(e):n,t)}return String(e)}const u=`slang.nestedResultPanic`;function d(){let e=/* @__PURE__ */ Error(`A Result cannot be nested inside another Result`);throw Object.defineProperty(e,u,{value:!0}),e}function f(e){return e instanceof Error&&e[u]===!0}let p=`development`,m=null;const h=e=>{typeof e==`object`&&e?m=e.printFn??null:p=e===`production`||e===`prod`?`production`:`development`},g=e=>{if(typeof e==`string`)return e;if(typeof e==`symbol`)return String(e);if(typeof e==`function`)return`[Function ${e.name}]`;try{return String(e)}catch{try{return JSON.stringify(e)??`null`}catch{return Object.prototype.toString.call(e)}}},_=(...e)=>{let t=e.map(g).join(` `).concat(`
|
|
2
|
+
`);m?m(t):p!==`production`&&globalThis.console?.log?.(t)};function v(e){throw Error(e)}function y(e,t){return{outcome:e,category:t,else(t){return e.isOk?e.value:typeof t==`function`?t(e.error):t},panic(t){if(e.isOk)return e.value;throw Error(t??e.error)}}}function b(e){return y(T(e),void 0)}function x(e,t){return y(D(t),e)}function S(e,t){return e.outcome.isErr?y(D(e.outcome.error),e.category):t(e.outcome.value)}const C=e=>({[Symbol.iterator]:e}),ee=e=>y(D(e.message),e.category);function w(e,t=void 0,n=!1,r={consumed:!1}){let i=(e,i=t)=>w(e,i,n,r),a=i=>{if(t!==void 0)return ee(t);if(n&&r.consumed)return x(`INVALID_INPUT`,`This iterator has already been consumed`);r.consumed=!0;let a;try{return a=e(),b(i(a))}catch(e){return x(`INVALID_INPUT`,l(e))}finally{a?.return?.()}};return{map(t){return i(function*(){let n=0;for(let r of C(e))yield t(r,n++)})},filter(t){return i(function*(){let n=0;for(let r of C(e))t(r,n++)&&(yield r)})},flatMap(t){return i(function*(){let n=0;for(let r of C(e))yield*t(r,n++)})},take(t){return!Number.isSafeInteger(t)||t<0?i(function*(){},{category:`INVALID_INDEX`,message:`take needs a nonnegative integer`}):i(function*(){if(t===0)return;let n=C(e)[Symbol.iterator](),r=0;try{for(;r<t;){let e=n.next();if(e.done===!0)return;yield e.value,r+=1}}finally{n.return?.()}})},drop(t){return!Number.isSafeInteger(t)||t<0?i(function*(){},{category:`INVALID_INDEX`,message:`drop needs a nonnegative integer`}):i(function*(){let n=0;for(let r of C(e))n<t?n+=1:yield r})},chunk(t){return!Number.isSafeInteger(t)||t<=0?i(function*(){},{category:`INVALID_CHUNK_SIZE`,message:`chunk size must be a positive integer`}):i(function*(){let n=[];for(let r of C(e))n.push(r),n.length===t&&(yield n,n=[]);n.length>0&&(yield n)})},reduce(e,t){return a(n=>{let r=t,i=0;for(;;){let t=n.next();if(t.done===!0)return r;r=e(r,t.value,i++)}})},count(){return a(e=>{let t=0;for(;;){if(e.next().done===!0)return t;t+=1}})},toArray(){return a(e=>{let t=[];for(;;){let n=e.next();if(n.done===!0)return t;t.push(n.value)}})}}}function te(e){let t=typeof e==`string`||typeof e==`object`&&e&&Symbol.iterator in e?e:void 0;if(t!==void 0){let e=!1;try{e=t[Symbol.iterator]()===t}catch{}return w(()=>t[Symbol.iterator](),void 0,e)}return w(()=>{throw Error(`Cannot iterate a non-iterable value`)},{category:`INVALID_INPUT`,message:`Cannot iterate a non-iterable value`})}function T(n,r){t(n)&&d();let i=Object.freeze({type:`Ok`,value:n,...r===void 0?{}:{message:r},isOk:!0,isErr:!1}),a=e=>{let n=e=>e===void 0?o:t(e)?(t(e.value)&&d(),e):T(e);try{let t=e(i.value);return t instanceof Promise?t.then(e=>n(e)).catch(e=>D(l(e))):n(t)}catch(e){return D(l(e))}},o={...i,expect:(e=>i.value),unwrap:(()=>(e(()=>{}),{else(e){return i.value}})),andThen:a,iterate:()=>te(i.value)};return o}function E(e,t,...n){return T(e,t)}function D(t,n){let r=Object.freeze({type:`Err`,error:t,isOk:!1,isErr:!0}),i=e=>a,a={...r,expect:(e=>{throw Error(e??t)}),unwrap:(()=>{let n=!1;return e(()=>{if(!n)throw Error(t)}),{else(e){return n=!0,typeof e==`function`?e(t):e}}}),andThen:i};return O(a,n)}function O(e,t){return t===void 0||Object.defineProperty(e,"raw",{value:t,enumerable:!1,writable:!1,configurable:!1}),e}const k=e=>e==null||e===``||Number.isNaN(e)||e===1/0||e===-1/0;function ne(e){if(k(e))throw Error(`Cannot wrap null, undefined, NaN, or empty string in Some`);return Object.freeze({type:`Some`,value:e,isSome:!0,isNone:!1})}const re=Object.freeze({type:`None`,isSome:!1,isNone:!0});let A=null;function ie(e){A=e}function j(t){let n=k(t)?re:ne(t),r=(e=>{if(!A)throw Error(`Converter not initialized`);return A(n,e)}),i=(e=>{if(n.isSome)return n.value;throw Error(e??`Expected Some, got None`)}),a=(()=>{let t=!1,r=n;return e(()=>{if(!t)throw Error(`Expected else`)}),{else(e){if(t=!0,r.isSome)return r.value;let n=typeof e==`function`?e(void 0):e;if(k(n))throw Error(`Fallback must be truthy`);return n}}}),o=(e=>{let t=n;if(t.isNone)return s;let r=t.value;try{let t=e(r);return t instanceof Promise?t.then(e=>e===void 0?s:j(e)).catch(()=>j(null)):t===void 0?s:j(t)}catch{return j(null)}}),s={...n,to:r,expect:i,unwrap:a,andThen:o};return s}const M=e=>{if(typeof e!=`object`||!e)return e;let t=e;return t.isSome===!0||t.isOk===!0?t.value:e},ae=e=>{if(typeof e==`object`&&e){let t=e;if(t.isNone===!0||t.isErr===!0)return!0}return k(M(e))};function oe(e,t=D(`No value!`)){for(let t of e)if(!ae(t))return T(M(t));return t}let N=null;function se(e){N=e}function P(e){let t=Symbol(e),n=Object(t);return n.to=(e=>{if(!N)throw Error(`Converter not initialized`);return N(t,e)}),n.andThen=t=>{let r;try{r=t(e)}catch(e){v(`Atom.andThen: fn threw an error: ${l(e)}`)}return r===void 0?n:(typeof r!=`string`&&v(`Atom.andThen: fn must return a string, got ${typeof r}`),P(r))},n}const F=e=>typeof e==`object`&&!!e&&`isSome`in e&&`isNone`in e;function I(e,t){if(e&&(e.type===`Ok`||e.type===`Err`))throw Error(`Cannot convert a Result to any other type`);switch(t){case`option`:return F(e)?e:j(typeof e==`symbol`?e.description:e);case`atom`:if(F(e)){if(e.isNone)throw Error(`Cannot convert None to Atom`);if(typeof e.value!=`string`)throw Error(`Only string values can be converted to Atom`);return P(e.value)}if(typeof e==`symbol`)return e;throw Error(`Cannot convert type ${typeof e} to Atom`);case`result`:return F(e)?e.isSome?E(e.value):D(`Value is None`):E(typeof e==`symbol`?e.description:e);default:throw Error(`Invalid target: ${t}`)}}ie(I),se(I);function ce(e,t){let n=t[e.type];if(!n)throw Error(`Non-exhaustive match — missing handler for '${e.type}'`);return n(e)}const le=e=>typeof e==`string`||typeof e==`number`||typeof e==`boolean`||typeof e==`symbol`;function ue(e,t){let n=e=>typeof e?.valueOf==`function`?e.valueOf():e,r=e=>typeof e==`symbol`?e.description:void 0,i=n(e);if(!le(i))throw Error(`Unsupported match all value type: ${typeof i}`);let a=r(i)??i,o=typeof a==`boolean`||typeof a==`number`?String(a):a;return o!=null&&o in t?t[o](e):t._()}function de(e,t=!1){if(!t&&!Array.isArray(e))throw Error(`Only arrays allowed when includeValues=false`);return Array.isArray(e)?e:e instanceof Set?Array.from(e):Object.values(e)}function L(e,t){let{fillValue:n,includeValues:r=!1}=t||{};if(e.length===0)return[];let i=e.map(e=>de(e,r)),a=Math.max(...i.map(e=>e.length)),o=Math.min(...i.map(e=>e.length)),s=n===void 0?o:a,c=[];for(let e=0;e<s;e++)c.push(i.map(t=>e<t.length?t[e]:n));return c}function fe(e,t,n){return L(e,n).map(t)}function pe(e){if(e.length===0)return[];let t=e[0]?.length??0,n=Array.from({length:t},()=>[]);for(let t of e)t.forEach((e,t)=>n[t]?.push(e));return n}async function me(e,n,...o){let s=n?.throw??!1,c=n?.collectValues??!1,u=[],p=[],m=e=>c?O(e,{errors:p,values:u}):e;try{let n=await e(),o=a(n),s=/* @__PURE__ */ new Set,l=+!!t(n),f=t(n)?n.raw:void 0,h=o.ok?void 0:n;for(;o.ok;){let e=o.value;if(t(e)&&(l+=1,l>1&&d()),c&&u.push(e),!i(e)&&!t(e)&&!r(e))return m(T(e));if(typeof e==`object`&&e){if(s.has(e))return m(D(`Cannot resolve a circular value`));s.add(e)}o=a(e),o.ok||(h=e)}return c?(p.push(t(h)?h.error:o.error),m(D(o.error))):D(o.error,f)}catch(e){if(f(e))throw e;let t=l(e);if(s)throw e instanceof Error?e:Error(t);return c?(p.push(e),m(D(t))):D(t,e)}}const R=e=>Number.isSafeInteger(e),z=(e,t)=>e<0?t+e:e;function he(e){return Array.isArray(e)?{ok:!0,value:e}:t(e)?e.isOk===!0&&Array.isArray(e.value)?{ok:!0,value:e.value}:{ok:!1,message:`list expects a raw array or a successful Ok holding one`}:{ok:!1,message:`list expects an array or a successful Ok`}}function B(e,t){let n=y(e,t),r=e=>B(e.outcome,e.category),i=((e,...t)=>S(n,n=>{if(!R(e))return x(`INVALID_INDEX`,`Index must be an integer`);let r=z(e,n.length);return r<0||r>=n.length?t.length===0?x(`OUT_OF_BOUNDS`,`No item at index ${e}`):b(t[0]):b(n[r])}));return{...n,get:i,take(e){return r(S(n,t=>R(e)?e<0||e>t.length?x(`OUT_OF_BOUNDS`,`take(${e}) is outside 0..${t.length}`):b(t.slice(0,e)):x(`INVALID_INDEX`,`take needs an integer count`)))},skip(e){return r(S(n,t=>R(e)?Math.abs(e)>t.length?x(`OUT_OF_BOUNDS`,`skip(${e}) is outside -${t.length}..${t.length}`):b(e>=0?t.slice(e):t.slice(0,t.length+e)):x(`INVALID_INDEX`,`skip needs an integer count`)))},range(e,t){return r(S(n,n=>{if(!R(e)||!R(t))return x(`INVALID_INDEX`,`range needs integer bounds`);let r=z(e,n.length),i=z(t,n.length);return r<0||r>n.length||i<0||i>n.length?x(`OUT_OF_BOUNDS`,`range(${e}, ${t}) is outside 0..${n.length}`):r>i?x(`INVALID_RANGE`,`range start must not exceed end`):b(n.slice(r,i))}))},chunk(e){let t=S(n,t=>{if(!R(e)||e<=0)return x(`INVALID_CHUNK_SIZE`,`chunk size must be a positive integer`);let n=[];for(let r=0;r<t.length;r+=e)n.push(t.slice(r,r+e));return b(n)});return B(t.outcome,t.category)},count(){return S(n,e=>b(e.length))},prune(e){return r(S(n,t=>{let n=e??(e=>!k(e));return b(t.filter((e,t)=>n(e,t)))}))}}}function ge(e){let t=he(e);return t.ok?B(E(t.value),void 0):B(D(t.message),`INVALID_INPUT`)}const V=e=>Object.prototype.toString.call(e)===`[object Object]`,_e=/* @__PURE__ */ new Set([`__proto__`,`constructor`,`prototype`]);function H(e,t){let n={...e};for(let[e,r]of Object.entries(t)){if(_e.has(e))continue;let t=n[e];n[e]=V(r)&&V(t)?H(t,r):r}return n}function U(e,t){let n=y(e,t),r=e=>U(e.outcome,e.category),i=e=>V(e)?e:void 0,a=((e,...t)=>S(n,n=>{let r=i(n);if(r===void 0)return x(`INVALID_INPUT`,`get expects a plain object`);let a=typeof e==`string`?[e]:e,o=r;for(let e of a){if(!V(o)||!Object.hasOwn(o,e))return t.length===0?x(`OUT_OF_BOUNDS`,`No value at path ${a.join(`.`)}`):b(t[0]);o=o[e]}return b(o)}));return{...n,get:a,pick(...e){return r(S(n,t=>{let n=i(t);return n===void 0?x(`INVALID_INPUT`,`pick expects a plain object`):b(Object.fromEntries(e.filter(e=>Object.hasOwn(n,e)).map(e=>[e,n[e]])))}))},omit(...e){return r(S(n,t=>{let n=i(t);if(n===void 0)return x(`INVALID_INPUT`,`omit expects a plain object`);let r=new Set(e);return b(Object.fromEntries(Object.entries(n).filter(([e])=>!r.has(e))))}))},merge(e){return r(S(n,t=>{let n=i(t);return n===void 0?x(`INVALID_INPUT`,`merge expects a plain object`):V(e)?b(H(n,e)):x(`INVALID_INPUT`,`merge expects a plain object source`)}))},count(){return S(n,e=>{let t=i(e);return t===void 0?x(`INVALID_INPUT`,`count expects a plain object`):b(Object.keys(t).length)})},countBy(e){return S(n,t=>{if(!Array.isArray(t))return x(`INVALID_INPUT`,`countBy expects a collection`);let n=t,r=/* @__PURE__ */ new Map;for(let t of n){let n=String(e(t));r.set(n,(r.get(n)??0)+1)}return b(Object.fromEntries(r))})},keyBy(e){return S(n,t=>{if(!Array.isArray(t))return x(`INVALID_INPUT`,`keyBy expects a collection`);let n=t,r=/* @__PURE__ */ new Map;for(let t of n)r.set(String(e(t)),t);return b(Object.fromEntries(r))})},prune(e){return r(S(n,t=>{let n=i(t);if(n===void 0)return x(`INVALID_INPUT`,`prune expects a plain object`);let r=e??(e=>!k(e));return b(Object.fromEntries(Object.entries(n).filter(([e,t])=>r(t,e))))}))}}}function ve(e){return t(e)?e.isOk===!0?{ok:!0,value:e.value}:{ok:!1,message:`struct expects a raw value or a successful Ok`}:{ok:!0,value:e}}function ye(e){let t=ve(e);return t.ok?U(T(t.value),void 0):U(D(t.message),`INVALID_INPUT`)}function W(e){if(e instanceof Set)return new Set(e);if(e instanceof Map)return new Set(e.keys());if(typeof e==`string`)return new Set(e);if(typeof e==`object`&&e){if(Symbol.iterator in e)return new Set(e);if(Object.prototype.toString.call(e)===`[object Object]`)return new Set(Object.keys(e))}}function G(e){return t(e)?e.isOk===!0?{ok:!0,value:e.value}:{ok:!1,message:`sets expects a raw collection or a successful Ok`}:{ok:!0,value:e}}function K(e,t){let n=y(e,t),r=e=>K(e.outcome,e.category),i=(e,t)=>r(S(n,n=>{let r=G(e),i=r.ok?W(r.value):void 0;return i===void 0?x(`INVALID_INPUT`,`sets expects an iterable, set, map or object`):b(t(n,i))}));return{...n,has(e){return S(n,t=>b(t.has(e)))},unique(){return r(S(n,e=>b(new Set(e))))},union(e){return i(e,(e,t)=>/* @__PURE__ */ new Set([...e,...t]))},intersection(e){return i(e,(e,t)=>new Set([...e].filter(e=>t.has(e))))},difference(e){return i(e,(e,t)=>new Set([...e].filter(e=>!t.has(e))))},count(){return S(n,e=>b(e.size))}}}function be(e){let t=G(e);if(!t.ok)return K(D(t.message),`INVALID_INPUT`);let n=W(t.value);return n===void 0?K(D(`sets expects an iterable, set, map or object`),`INVALID_INPUT`):K(T(n),void 0)}const q=Symbol(`slang.memo.leaf`);function xe(e){let t=/* @__PURE__ */ new Map,n=e=>{let n=t;for(let t of e){let e=n.get(t);e===void 0&&(e=/* @__PURE__ */ new Map,n.set(t,e)),n=e}return n},r=((...t)=>{let r=n(t);if(r.has(q))return r.get(q);let i=e(...t);return r.set(q,i),i instanceof Promise&&i.catch(()=>{r.delete(q)}),i});return r.clear=()=>{t=/* @__PURE__ */ new Map},r}function Se(e,t={}){let n=t.concurrency??1/0,r=t.throttle??0;if(n!==1/0&&(!Number.isSafeInteger(n)||n<=0))throw Error(`concurrency must be a positive integer`);if(!Number.isSafeInteger(r)||r<0)throw Error(`throttle must be a nonnegative integer`);let i=0,a=0,o,s=[],c=e=>{o===void 0&&(o=setTimeout(()=>{o=void 0,l()},e))},l=()=>{for(;s.length>0&&i<n;){let e=r>0?Math.max(0,a+r-Date.now()):0;if(e>0){c(e);return}let t=s.shift();if(t===void 0)return;if(i+=1,a=Date.now(),t(),r>0){c(r);return}}},u=()=>{let e=!1;return()=>{e||(e=!0,i>0&&--i,l())}};return{name:e,acquire(){return new Promise(e=>{s.push(()=>e(u())),l()})}}}const J=e=>typeof e==`object`&&!!e&&typeof e.key==`string`&&e.key.length>0&&`value`in e,Y=(e,t)=>{for(let n of e.values())if(n.key===t)return!0;return!1},Ce=e=>e.size===0?1/0:Math.min(...e.keys()),we=e=>e.size===0?-1/0:Math.max(...e.keys()),Te=(e,t)=>{let n;for(let r of e.keys())r<t&&(n===void 0||r>n)&&(n=r);return n===void 0?void 0:e.get(n)},Ee=(e,t)=>{let n;for(let r of e.keys())r>t&&(n===void 0||r<n)&&(n=r);return n===void 0?void 0:e.get(n)};function De(e={}){let t=e.maxHistory??50,n=e.maxSteps??null,r=e.keyEvalFn;if(!Number.isSafeInteger(t)||t<=0)throw Error(`maxHistory must be a positive integer`);if(n!==null&&(!Number.isSafeInteger(n)||n<0))throw Error(`maxSteps must be a nonnegative integer or null`);let i=/* @__PURE__ */ new Map,a=-1,o=0,s=Promise.resolve(),c=e=>{let t=s.then(e,e);return s=t.then(()=>void 0,()=>void 0),t},u=e=>{for(let e of[...i.keys()])e>a&&i.delete(e);for(a+=1,i.set(a,e),o+=1;i.size>t;){let e=Ce(i);if(e===a)break;i.delete(e)}},d=async(e,t)=>{let s=t.fallback??!1,c=i.get(a),d=e=>s&&c!==void 0?T(c):D(e);if(n!==null&&o>=n)return D(`Step limit reached`);let f;try{f=await e(c,e=>e)}catch(e){return d(l(e))}if(!J(f))return d(`A step needs a nonempty string key and a value`);let p=f;if(Y(i,p.key))throw Error(`Duplicate step key: ${p.key}`);if(r!==void 0){let e;try{e=await r(p.key)}catch(e){return d(l(e))}if(!e)throw Error(`Step key rejected: ${p.key}`)}return u(p),T(p)};return{next:(e,t={})=>c(()=>d(e,t)),prev:(e=-1)=>{if(!Number.isSafeInteger(e)||e>=0)throw Error(`prev offset must be a negative integer`);let n=a+e,r=n<0,o=e=>(a=n,e),s=e=>{if(r)throw Error(`Cannot step before the first step`);let a=e(Te(i,n),e=>e,Ee(i,n));if(!J(a))throw Error(`Recovered step is invalid`);let s=a;if(Y(i,s.key))throw Error(`Duplicate step key: ${s.key}`);for(i.set(n,s);i.size>t;){let e=we(i);if(e===n)break;i.delete(e)}return o(s)};return{else(e){let t=i.get(n);return t===void 0?s(e):o(t)},panic(e){let t=i.get(n);if(t!==void 0)return o(t);throw Error(r?e??`Cannot step before the first step`:e??`History unavailable`)}}},get current(){return i.get(a)},get size(){return i.size}}}function X(e){return e.error??`Unknown error`}function Oe(e){let t=a(e);return t.ok?E(t.value):D(t.error)}async function ke(e,n){try{let r=await e(n);return t(r)?(t(r.value)&&d(),r):D(`Pipeline function must return a Result`)}catch(e){if(f(e))throw e;return D(l(e))}}function Ae(e,...t){return{async run(n){let{onEach:r,onSuccess:i,onError:a,allowErrors:o=!1}=n??{},s=Oe(e);for(let e=0;e<t.length;e++){let n=t[e],i=t[e+1];if(s.isErr&&!o)return a?.(Error(X(s))),s;s=await ke(n,s),r?.({prevResult:s,currentFn:n.name||`fn${e+1}`,nextFn:i?i.name||`fn${e+2}`:void 0})}return s.isOk?i?.(s.value):a?.(Error(X(s))),s}}}function Z(){let e=new AbortController;return Object.assign(e.signal,{fire:()=>e.abort()})}const Q=e=>l(e),$=(e,t)=>{if(e.aborted)return t.abort(),()=>{};let n=()=>t.abort();return e.addEventListener(`abort`,n,{once:!0}),()=>e.removeEventListener(`abort`,n)};function je(e,t={}){let r=new AbortController,i=Z(),o=()=>{},s=new Promise(e=>{o=e}),c=!1,l=!1,u=e=>{l||(l=!0,o(e),i.fire())},d=async(e,n,i)=>{let o=t.group===void 0?()=>{}:await t.group.acquire();if(r.signal.aborted)return o(),{kind:`aborted`};let s=!1,c,l=i===void 0?()=>{}:$(i,n),u=$(r.signal,n);t.timeout!==void 0&&(c=setTimeout(()=>{s=!0,n.abort()},t.timeout));let d=e=>(c!==void 0&&clearTimeout(c),l(),u(),o(),e);try{let t=a(await e(n.signal));return n.signal.aborted?r.signal.aborted?d({kind:`aborted`}):i?.aborted?d({kind:`stopped`}):d(s?{kind:`timedOut`}:{kind:`aborted`}):t.ok?d({kind:`value`,value:t.value}):d({kind:`error`,error:t.error})}catch(e){return r.signal.aborted?d({kind:`aborted`}):i?.aborted?d({kind:`stopped`}):n.signal.aborted?d(s?{kind:`timedOut`}:{kind:`aborted`}):d({kind:`error`,error:Q(e)})}},f=e=>new Promise(t=>{if(e.aborted){t();return}e[n]?.();let i=()=>{a(),t()},a=()=>{e.removeEventListener(`abort`,i),r.signal.removeEventListener(`abort`,i)};e.addEventListener(`abort`,i,{once:!0}),r.signal.addEventListener(`abort`,i,{once:!0})}),p=e=>new Promise(t=>{if(r.signal.aborted){t();return}let n=()=>{clearTimeout(a),i(),t()},i=()=>r.signal.removeEventListener(`abort`,n),a=setTimeout(n,e);r.signal.addEventListener(`abort`,n,{once:!0})}),m=async()=>{let{defer:n,delay:i,retry:a,retryUntil:o}=t,s=e;if(s===void 0)return;if(r.signal.aborted||n!==void 0&&(await f(n),r.signal.aborted))return u(D(`Aborted`));if(o!==void 0){let e=o.signal;for(;;){if(r.signal.aborted)return u(D(`Aborted`));if(e.aborted)return u(D(`Stopped`));let t=new AbortController,n=await d(s,t,e);switch(n.kind){case`value`:return u(T(n.value));case`aborted`:return u(D(`Aborted`));case`stopped`:return u(D(`Stopped`));case`timedOut`:case`error`:if(r.signal.aborted)return u(D(`Aborted`));if(e.aborted)return u(D(`Stopped`));o.delay!==void 0&&await p(o.delay)}}}if(a!==void 0&&a>0){let e=a;for(;;){if(r.signal.aborted||(i!==void 0&&await p(i),r.signal.aborted))return u(D(`Aborted`));let t=new AbortController,n=await d(s,t,void 0);switch(n.kind){case`value`:return u(T(n.value));case`aborted`:return u(D(`Aborted`));case`timedOut`:return u(D(`Timed out`));case`stopped`:return u(D(`Stopped`));case`error`:if(e>0){--e;continue}return u(D(n.error))}}}if(i!==void 0&&await p(i),r.signal.aborted)return u(D(`Aborted`));let c=new AbortController,l=await d(s,c,void 0);switch(l.kind){case`value`:return u(T(l.value));case`aborted`:return u(D(`Aborted`));case`timedOut`:return u(D(`Timed out`));case`stopped`:return u(D(`Stopped`));case`error`:return u(D(l.error))}},h=()=>{c||(c=!0,e!==void 0&&m())};i[n]=h;let g={done:i,abort:()=>{r.abort(),u(D(`Aborted`))},resolve:e=>u(T(e)),reject:e=>u(D(Q(e))),tap:e=>je(async()=>{let t=await g;return t.isOk&&await e(t.value),t}),then:(e,t)=>(h(),s.then(e,t)),catch:e=>(h(),s.catch(e)),finally:e=>(h(),s.finally(e))};return g}function Me(e){let{type:t}=e;if(t===`race`&&e.count<1)throw Error(`superRunner race count must be at least 1`);let r=new AbortController,i=Z(),a=()=>{},o=new Promise(e=>{a=e}),s=!1,c=!1,l=e=>{c||(c=!0,a(e),i.fire())},u=t===`sequence`?e.runners:Object.values(e.runners),d=()=>{for(let e of u)e.abort()},f=async e=>{let t=[];for(let n of e){if(r.signal.aborted)return l(D(`Aborted`));let e=await n;if(r.signal.aborted)return l(D(`Aborted`));if(e.isErr)return l(D(e.error));t.push(e.value)}l(E(t))},p=async e=>{let t=Object.entries(e),n={},i=0;for(let[e,a]of t)a.then(a=>{if(i+=1,a.isOk)n[e]=a.value;else if(!r.signal.aborted&&!c){d(),l(D(a.error));return}i===t.length&&l(E(n))});t.length===0&&l(E(n))},m=async(e,t)=>{let n=Object.entries(e),r={},i=0,a=0;for(let[e,o]of n)o.then(o=>{a+=1,o.isOk&&(r[e]=o.value,i+=1,i>=t)?(d(),l(E(r))):a===n.length&&l(D(i===0?`All runners failed`:`Not enough runners succeeded`))});n.length===0&&l(D(`All runners failed`))},h=()=>(s||(s=!0,t===`sequence`?f(e.runners):t===`all`?p(e.runners):m(e.runners,e.count)),o);return i[n]=h,{done:i,start:h,abort:()=>{r.abort(),d(),l(D(`Aborted`))}}}function Ne(){let e=/* @__PURE__ */ new Map,t=t=>{let n=e.get(t.topic);if(n!==void 0)for(let e of n)try{e(t)}catch(e){_(`channel subscriber threw:`,e)}};return{send:t,subscribe:(t,n)=>{let r=e.get(t.topic);return r===void 0&&(r=/* @__PURE__ */ new Set,e.set(t.topic,r)),r.add(n),()=>{let r=e.get(t.topic);r!==void 0&&r.delete(n)}},when:e=>{e.signal.aborted?t({topic:e.topic,data:e.data}):e.signal.addEventListener(`abort`,()=>t({topic:e.topic,data:e.data}),{once:!0})}}}export{D as Err,E as Ok,oe as Options,I as _to,P as atom,Ne as createChannel,Z as createSignal,De as createStepper,k as isFalsy,ge as list,ce as match,ue as matchAll,xe as memoized,j as option,v as panic,Ae as pipe,_ as println,me as safeTry,e as scheduleMicrotask,h as setEnvironment,be as sets,ye as struct,je as superPromise,Me as superRunner,Se as taskGroup,pe as unzip,L as zip,fe as zipWith};
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "slang-ts",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Functional programming
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Functional programming utilities for TypeScript: Option, Result, SafeTry, pattern matching, async control, and data helpers",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"module": "dist/index.js",
|
|
@@ -14,8 +14,12 @@
|
|
|
14
14
|
},
|
|
15
15
|
"types": "dist/index.d.ts",
|
|
16
16
|
"files": [
|
|
17
|
-
"dist"
|
|
17
|
+
"dist",
|
|
18
|
+
"CHANGELOG.md"
|
|
18
19
|
],
|
|
20
|
+
"engines": {
|
|
21
|
+
"node": ">=20"
|
|
22
|
+
},
|
|
19
23
|
"homepage": "https://github.com/Hussseinkizz/slang#readme",
|
|
20
24
|
"repository": {
|
|
21
25
|
"type": "git",
|
|
@@ -53,7 +57,9 @@
|
|
|
53
57
|
],
|
|
54
58
|
"author": "Hussein Kizz",
|
|
55
59
|
"license": "MIT",
|
|
56
|
-
"sideEffects":
|
|
60
|
+
"sideEffects": [
|
|
61
|
+
"./dist/index.js"
|
|
62
|
+
],
|
|
57
63
|
"devDependencies": {
|
|
58
64
|
"@types/bun": "latest",
|
|
59
65
|
"@vitest/ui": "^4.1.10",
|
|
@@ -64,11 +70,17 @@
|
|
|
64
70
|
"peerDependencies": {
|
|
65
71
|
"typescript": "^5.9.3 || ^7.0.2"
|
|
66
72
|
},
|
|
73
|
+
"peerDependenciesMeta": {
|
|
74
|
+
"typescript": {
|
|
75
|
+
"optional": true
|
|
76
|
+
}
|
|
77
|
+
},
|
|
67
78
|
"scripts": {
|
|
68
79
|
"test": "vitest run",
|
|
69
80
|
"test:watch": "vitest",
|
|
70
81
|
"test:ui": "vitest --ui",
|
|
71
82
|
"typecheck": "tsc --noEmit",
|
|
72
|
-
"build": "
|
|
83
|
+
"build": "tsdown",
|
|
84
|
+
"export": "bun run test && bun run typecheck && bun run build"
|
|
73
85
|
}
|
|
74
86
|
}
|