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/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>): Result<U, string> | Promise<Result<U, string>>;
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
- * Idempotent — safe to call any number of times, in any order; the last call wins.
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 heterogeneous values — raw values, `Option`s, and `Result`s
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` are usable, matching `option()` semantics.
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
- /** Terminal success value after resolving supported Slang wrappers. */
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 terminal success value or error text
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(Ok("Hello")));
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 lifecycle ergonomics. Promise-compatible. */
796
+ /** A single async operation with start, retry, timeout, and cancel controls. Promise-compatible. */
514
797
  type SuperPromise<T> = {
515
- /** Lifecycle signal: fires once when the task reaches a terminal state. */
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 lifecycle/execution ergonomics.
816
+ * Creates a SuperPromise — one async operation plus start, retry, timeout, and cancel controls.
534
817
  *
535
- * Lazy activation: the executor starts on first consumption (`await`/`.then()`,
536
- * or a runner's `start()`), not at creation. Defer chains activate recursively,
537
- * so awaiting a deferred task runs its dependency first.
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
- /** Orchestrates multiple already-created SuperPromises. */
841
+ /** Manages several already-created SuperPromise instances. */
559
842
  type SuperRunner<Value> = {
560
- /** Lifecycle signal: fires once when the runner reaches a terminal state. */
843
+ /** Fires once when the runner finishes. */
561
844
  done: AbortSignal;
562
- /** Starts execution. Idempotent: repeated calls return the same result without re-executing children. */
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
- * Abort-compatible: structurally an `AbortSignal` plus a `fire()` method,
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 semantics.
914
+ * (and vice-versa). Wraps `AbortController` behavior.
632
915
  *
633
- * Consumed by `defer`, `retryUntil`, `channel.when`, and `task.done`.
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:typeof e.error==`string`?e.error:String(e.error)}:r(e)?e.isSome?{ok:!0,value:e.value}:{ok:!1,error:`Option was None`}:{ok:!0,value:e}}let o=`development`,s=null;const c=e=>{typeof e==`object`&&e?s=e.printFn??null:o=e===`production`||e===`prod`?`production`:`development`},l=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)}}},u=(...e)=>{let t=e.map(l).join(` `).concat(`
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.1.0",
4
- "description": "Functional programming library for TypeScript: Option, Result, pattern matching, and async primitives",
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": false,
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": "bun run test && bun run typecheck && tsdown"
83
+ "build": "tsdown",
84
+ "export": "bun run test && bun run typecheck && bun run build"
73
85
  }
74
86
  }