feat(std/results): added else type and changed or type

Author: giveerr

package.json

@@ -2,7 +2,7 @@
   "name": "sirutils",
   "private": "true",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "workspaces": ["{packages,plugins,apps,tools,experiments}/**"],
   "devDependencies": {
     "@biomejs/biome": "1.9.4",

packages/std/src/results/definition.ts

@@ -61,7 +61,12 @@ declare global {
        *
        * @param value the default value to return if there is an `Err`
        */
-      or<A>(value: A): T | A
+      else<A>(value: A): T | A
+
+      /**
+       * Returns the first `Ok`, if `Ok` doesnt exists returns the last error
+       */
+      or<A extends Std.Result<BlobType, BlobType, BlobType>>(value: A): Std.Result<T, N, C> | A
 
       unwrap(): T
     }

packages/std/src/results/utils/err.ts

@@ -33,7 +33,11 @@ export class Err<
     return this.throw()
   }
 
-  or<A>(value: A): T | A {
+  else<A>(value: A): T | A {
+    return value
+  }
+
+  or<A extends Std.Result<BlobType, BlobType, BlobType>>(value: A) {
     return value
   }
 

packages/std/src/results/utils/ok.ts

@@ -19,10 +19,14 @@ export class Ok<T, const N extends Std.ErrorValues = never, const C extends Std.
     return this.value
   }
 
-  or<A>(_value: A): T | A {
+  else<A>(_value: A): T | A {
     return this.value
   }
 
+  or<A extends Std.Result<BlobType, BlobType, BlobType>>(_value: A) {
+    return this
+  }
+
   // biome-ignore lint/correctness/useYield: Redundant
   *[Symbol.iterator](): Generator<Err<never, N, C>, T> {
     return this.value