functype 0.16.0 → 0.17.0

package/dist/do/index.d.ts

@@ -1,5 +1,5 @@
-import { O as Option, E as Either, L as List, T as Try, x as Reshapeable, b as Doable } from '../Either-C-P6QnvK.js';
-export { D as DoResult } from '../Either-C-P6QnvK.js';
+import { O as Option, E as Either, L as List, T as Try, x as Reshapeable, b as Doable } from '../Either-CM1xSzLl.js';
+export { D as DoResult } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';
 
 /**

package/dist/do/index.mjs

@@ -1,2 +1,2 @@
-export{X as $,T as Do,U as DoAsync,_ as EmptyListError,$ as FailureError,Z as LeftError,Y as NoneError,V as isDoCapable,W as unwrap}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{X as $,T as Do,U as DoAsync,_ as EmptyListError,$ as FailureError,Z as LeftError,Y as NoneError,V as isDoCapable,W as unwrap}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/either/index.d.ts

@@ -1,2 +1,2 @@
-export { E as Either, e as Left, R as Right, d as TestEither, h as TypeCheckLeft, g as TypeCheckRight, f as isLeft, i as isRight, t as tryCatch, j as tryCatchAsync } from '../Either-C-P6QnvK.js';
+export { E as Either, e as Left, R as Right, d as TestEither, h as TypeCheckLeft, g as TypeCheckRight, f as isLeft, i as isRight, t as tryCatch, j as tryCatchAsync } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';

package/dist/either/index.mjs

@@ -1,2 +1,2 @@
-export{t as Either,m as Left,l as Right,r as TypeCheckLeft,q as TypeCheckRight,o as isLeft,n as isRight,p as tryCatch,s as tryCatchAsync}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{t as Either,m as Left,l as Right,r as TypeCheckLeft,q as TypeCheckRight,o as isLeft,n as isRight,p as tryCatch,s as tryCatchAsync}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/fpromise/index.d.ts

@@ -1,4 +1,4 @@
-import { E as Either } from '../Either-C-P6QnvK.js';
+import { E as Either } from '../Either-CM1xSzLl.js';
 import { T as Type } from '../Typeable-DiGVtDnq.js';
 
 /**

package/dist/fpromise/index.mjs

@@ -1,2 +1,2 @@
-export{N as FPromise,M as FPromiseCompanion}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{N as FPromise,M as FPromiseCompanion}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Brand } from './branded/index.js';
 export { BrandedBoolean, BrandedBoolean as BrandedBooleanType, BrandedNumber, BrandedNumber as BrandedNumberType, BrandedString, BrandedString as BrandedStringType, ExtractBrand, Unwrap, createBrander, hasBrand, unwrap as unwrapBrand } from './branded/index.js';
-import { L as List, O as Option, E as Either, D as DoResult, F as FunctypeBase, a as Extractable, A as AsyncMonad, P as Promisable, b as Doable, T as Try, c as Traversable, M as Matchable } from './Either-C-P6QnvK.js';
-export { u as Applicative, C as Collection, r as CollectionOps, s as ContainerOps, v as Functor, l as Functype, m as FunctypeCollection, e as Left, n as MatchableUtils, w as Monad, N as None, o as OptionConstructor, R as Right, p as Set, S as Some, d as TestEither, h as TypeCheckLeft, g as TypeCheckRight, q as TypeNames, k as isExtractable, f as isLeft, i as isRight, t as tryCatch, j as tryCatchAsync } from './Either-C-P6QnvK.js';
+import { L as List, O as Option, E as Either, D as DoResult, F as FunctypeBase, a as Extractable, A as AsyncMonad, P as Promisable, b as Doable, T as Try, c as Traversable, M as Matchable } from './Either-CM1xSzLl.js';
+export { u as Applicative, C as Collection, r as CollectionOps, s as ContainerOps, v as Functor, l as Functype, m as FunctypeCollection, e as Left, n as MatchableUtils, w as Monad, N as None, o as OptionConstructor, R as Right, p as Set, S as Some, d as TestEither, h as TypeCheckLeft, g as TypeCheckRight, q as TypeNames, k as isExtractable, f as isLeft, i as isRight, t as tryCatch, j as tryCatchAsync } from './Either-CM1xSzLl.js';
 import { T as Type, F as Foldable, P as Pipe, S as Serializable, a as Typeable } from './Typeable-DiGVtDnq.js';
 export { E as ExtractTag, b as SerializationMethods, c as TypeableParams, i as isTypeable } from './Typeable-DiGVtDnq.js';
 import { FPromise } from './fpromise/index.js';
@@ -217,7 +217,7 @@ declare const NonEmptyString: ValidatedBrandCompanion<"NonEmptyString", string>;
  * const processEmail = (input: string) => {
  *   return EmailAddress.from(input)
  *     .map(email => sendWelcomeEmail(email))
- *     .getOrElse("Invalid email address")
+ *     .orElse("Invalid email address")
  * }
  */
 declare const EmailAddress: ValidatedBrandCompanion<"EmailAddress", string>;
@@ -257,7 +257,7 @@ declare function BoundedString(brand: string, minLength: number, maxLength: numb
  * const PhoneNumber = PatternString("PhoneNumber", /^\+?[1-9]\d{1,14}$/)
  * const phone = PhoneNumber.from("+1234567890")
  *   .map(p => formatPhoneNumber(p))
- *   .getOrElse("Invalid phone number")
+ *   .orElse("Invalid phone number")
  */
 declare function PatternString(brand: string, pattern: RegExp): ValidatedBrandCompanion<string, string>;
 
@@ -325,7 +325,7 @@ type Cond<T extends Type> = {
     /**
      * Get the result if a condition was met, throws if no condition met
      */
-    getOrThrow: () => T;
+    orThrow: () => T;
 };
 /**
  * Conditional expression builder for functional if/else chains
@@ -499,7 +499,7 @@ type Match<T extends Type, R extends Type> = {
     /**
      * Get result if matched, throws if no match
      */
-    getOrThrow: (errorMessage?: string) => R;
+    orThrow: (errorMessage?: string) => R;
     /**
      * Get result wrapped in Option
      */
@@ -1387,19 +1387,25 @@ interface Lazy<T extends Type> extends FunctypeBase<T, "Lazy">, Extractable<T>,
      * @param defaultValue - The value to return if computation fails
      * @returns The computed value or defaultValue
      */
-    getOrElse(defaultValue: T): T;
+    orElse(defaultValue: T): T;
     /**
      * Returns the computed value or null if computation fails
      * @returns The computed value or null
      */
-    getOrNull(): T | null;
+    orNull(): T | null;
     /**
      * Returns the computed value or throws an error if computation fails
      * @param error - Optional custom error to throw. If not provided, throws the computation error or a default error
      * @returns The computed value
      * @throws The specified error, computation error, or a default error
      */
-    getOrThrow(error?: Error): T;
+    orThrow(error?: Error): T;
+    /**
+     * Returns this Lazy if computation succeeds, otherwise returns the alternative Lazy
+     * @param alternative - The alternative Lazy to use if computation fails
+     * @returns This Lazy or the alternative
+     */
+    or(alternative: Lazy<T>): Lazy<T>;
     /**
      * Maps the value inside the Lazy using the provided function
      * @param f - The mapping function
@@ -1540,8 +1546,8 @@ interface Lazy<T extends Type> extends FunctypeBase<T, "Lazy">, Extractable<T>,
  *   return 42
  * })
  * // Nothing printed yet
- * const result = expensive.getOrThrow() // Prints "Computing..." and returns 42
- * const cached = expensive.getOrThrow() // Returns 42 without printing
+ * const result = expensive.orThrow() // Prints "Computing..." and returns 42
+ * const cached = expensive.orThrow() // Returns 42 without printing
  *
  * @example
  * // Error handling
@@ -1549,7 +1555,7 @@ interface Lazy<T extends Type> extends FunctypeBase<T, "Lazy">, Extractable<T>,
  *   if (Math.random() > 0.5) throw new Error("Failed")
  *   return "Success"
  * })
- * const safe = risky.getOrElse("Default") // Returns "Success" or "Default"
+ * const safe = risky.orElse("Default") // Returns "Success" or "Default"
  * const option = risky.toOption() // Some("Success") or None
  * const either = risky.toEither() // Right("Success") or Left(Error)
  *
@@ -1559,14 +1565,14 @@ interface Lazy<T extends Type> extends FunctypeBase<T, "Lazy">, Extractable<T>,
  *   .map(x => x * 2)
  *   .flatMap(x => Lazy(() => x + 5))
  *   .recover(err => 0)
- *   .getOrThrow() // 25
+ *   .orThrow() // 25
  *
  * @example
  * // Integration with functype
  * const userOption = Option({ id: 1, name: "Alice" })
  * const userName = Lazy.fromOption(userOption, () => ({ id: 0, name: "Anonymous" }))
  *   .map(user => user.name)
- *   .getOrThrow() // "Alice"
+ *   .orThrow() // "Alice"
  */
 declare const Lazy: (<T extends Type>(thunk: () => T) => Lazy<T>) & {
     /**

package/dist/index.mjs

@@ -1,2 +1,2 @@
-export{X as $,J as Base,E as BoundedNumber,F as BoundedString,H as Cond,T as Do,U as DoAsync,ma as ESMap,t as Either,A as EmailAddress,_ as EmptyListError,P as Err,N as FPromise,M as FPromiseCompanion,$ as FailureError,ia as FoldableUtils,ja as HKT,D as ISO8601Date,ka as Identity,x as IntegerNumber,la as Lazy,g as LazyList,m as Left,Z as LeftError,k as List,na as Map,I as Match,oa as MatchableUtils,K as NAME,z as NonEmptyString,w as NonNegativeNumber,b as None,Y as NoneError,Q as Ok,d as Option,c as OptionConstructor,ea as ParseError,G as PatternString,y as PositiveInteger,v as PositiveNumber,f as Ref,l as Right,e as Set,a as Some,pa as Stack,S as Task,L as Throwable,h as Try,r as TypeCheckLeft,q as TypeCheckRight,i as Typeable,fa as TypedError,C as UUID,B as UrlString,u as ValidatedBrand,ga as Validation,qa as Valuable,R as createCancellationTokenSource,da as createErrorSerializer,ca as formatError,ba as formatStackTrace,V as isDoCapable,ha as isExtractable,o as isLeft,n as isRight,O as isTaggedThrowable,j as isTypeable,aa as safeStringify,p as tryCatch,s as tryCatchAsync,W as unwrap}from'./chunk-ZRLVS2S5.mjs';export{a as Companion,b as Tuple}from'./chunk-BQJB6CCW.mjs';export{a as Brand,g as BrandedBoolean,f as BrandedNumber,e as BrandedString,d as createBrander,c as hasBrand,b as unwrapBrand}from'./chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{X as $,J as Base,E as BoundedNumber,F as BoundedString,H as Cond,T as Do,U as DoAsync,ma as ESMap,t as Either,A as EmailAddress,_ as EmptyListError,P as Err,N as FPromise,M as FPromiseCompanion,$ as FailureError,ia as FoldableUtils,ja as HKT,D as ISO8601Date,ka as Identity,x as IntegerNumber,la as Lazy,g as LazyList,m as Left,Z as LeftError,k as List,na as Map,I as Match,oa as MatchableUtils,K as NAME,z as NonEmptyString,w as NonNegativeNumber,b as None,Y as NoneError,Q as Ok,d as Option,c as OptionConstructor,ea as ParseError,G as PatternString,y as PositiveInteger,v as PositiveNumber,f as Ref,l as Right,e as Set,a as Some,pa as Stack,S as Task,L as Throwable,h as Try,r as TypeCheckLeft,q as TypeCheckRight,i as Typeable,fa as TypedError,C as UUID,B as UrlString,u as ValidatedBrand,ga as Validation,qa as Valuable,R as createCancellationTokenSource,da as createErrorSerializer,ca as formatError,ba as formatStackTrace,V as isDoCapable,ha as isExtractable,o as isLeft,n as isRight,O as isTaggedThrowable,j as isTypeable,aa as safeStringify,p as tryCatch,s as tryCatchAsync,W as unwrap}from'./chunk-LW2YTB56.mjs';export{a as Companion,b as Tuple}from'./chunk-BQJB6CCW.mjs';export{a as Brand,g as BrandedBoolean,f as BrandedNumber,e as BrandedString,d as createBrander,c as hasBrand,b as unwrapBrand}from'./chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/list/index.d.ts

@@ -1,2 +1,2 @@
-export { L as List } from '../Either-C-P6QnvK.js';
+export { L as List } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';

package/dist/list/index.mjs

@@ -1,2 +1,2 @@
-export{k as List}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{k as List}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/map/index.d.ts

@@ -1,4 +1,4 @@
-import { c as Traversable, C as Collection, O as Option } from '../Either-C-P6QnvK.js';
+import { c as Traversable, C as Collection, O as Option } from '../Either-CM1xSzLl.js';
 import { a as Typeable, S as Serializable, P as Pipe, F as Foldable, T as Type } from '../Typeable-DiGVtDnq.js';
 import { Tuple } from '../tuple/index.js';
 

package/dist/map/index.mjs

@@ -1,2 +1,2 @@
-export{na as Map}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{na as Map}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/option/index.d.ts

@@ -1,2 +1,2 @@
-export { N as None, O as Option, o as OptionConstructor, S as Some } from '../Either-C-P6QnvK.js';
+export { N as None, O as Option, o as OptionConstructor, S as Some } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';

package/dist/option/index.mjs

@@ -1,2 +1,2 @@
-export{b as None,d as Option,c as OptionConstructor,a as Some}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{b as None,d as Option,c as OptionConstructor,a as Some}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/set/index.d.ts

@@ -1,2 +1,2 @@
-export { p as Set } from '../Either-C-P6QnvK.js';
+export { p as Set } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';

package/dist/set/index.mjs

@@ -1,2 +1,2 @@
-export{e as Set}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{e as Set}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/try/index.d.ts

@@ -1,2 +1,2 @@
-export { T as Try, q as TypeNames } from '../Either-C-P6QnvK.js';
+export { T as Try, q as TypeNames } from '../Either-CM1xSzLl.js';
 import '../Typeable-DiGVtDnq.js';

package/dist/try/index.mjs

@@ -1,2 +1,2 @@
-export{h as Try}from'../chunk-ZRLVS2S5.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
+export{h as Try}from'../chunk-LW2YTB56.mjs';import'../chunk-BQJB6CCW.mjs';import'../chunk-OR6V4TCO.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "functype",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "type": "module",
   "description": "A functional programming library for TypeScript, using immutable data structures and type classes",
   "author": "jordan.burke@gmail.com",
@@ -9,23 +9,23 @@
     "type": "git",
     "url": "git+https://github.com/jordanburke/functype.git"
   },
-  "homepage": "https://github.com/jordanburke/functype#readme",
+  "homepage": "https://functype.org/",
   "url": "https://github.com/jordanburke/functype",
   "devDependencies": {
     "@eslint/compat": "^1.4.0",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.37.0",
+    "@eslint/js": "^9.38.0",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/github": "^11.0.6",
     "@semantic-release/npm": "^12.0.2",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^22.18.8",
-    "@typescript-eslint/eslint-plugin": "^8.46.0",
-    "@typescript-eslint/parser": "^8.46.0",
+    "@types/node": "^22.18.11",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
     "cross-env": "^10.1.0",
-    "eslint": "^9.37.0",
+    "eslint": "^9.38.0",
     "eslint-config-functype": "1.3.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-functional": "^9.0.2",
@@ -39,7 +39,7 @@
     "ts-node": "^10.9.2",
     "tsup": "^8.5.0",
     "tsx": "^4.20.6",
-    "typedoc": "^0.28.13",
+    "typedoc": "^0.28.14",
     "typescript": "5.9.2",
     "vitest": "^3.2.4"
   },
@@ -151,7 +151,9 @@
   },
   "sideEffects": false,
   "scripts": {
-    "validate": "pnpm format && pnpm lint && pnpm test && pnpm build",
+    "validate": "pnpm validate:core && pnpm validate:landing",
+    "validate:core": "pnpm format && pnpm lint && pnpm test && pnpm build",
+    "validate:landing": "cd landing && pnpm validate",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint ./src --fix",
@@ -172,6 +174,9 @@
     "docs:watch": "typedoc --watch",
     "docs:validate": "tsx scripts/validate-docs.ts",
     "postdocs": "node -e \"console.log('Documentation generated in ./typedocs')\"",
-    "analyze:size": "pnpm build && node ./scripts/analyze-bundle-size.js"
+    "analyze:size": "pnpm build && node ./scripts/analyze-bundle-size.js",
+    "landing:dev": "cd landing && pnpm dev",
+    "landing:build": "cd landing && pnpm build",
+    "landing:preview": "cd landing && pnpm preview"
   }
 }

package/readme/BRAND_MIGRATION_GUIDE.md

@@ -127,14 +127,14 @@ When extracting branded values from Option or Either, you may need to adjust def
 
 ```typescript
 const email = EmailAddress.of(input)
-const value = email.map((e) => e.unbrand()).getOrElse("")
+const value = email.map((e) => e.unbrand()).orElse("")
 ```
 
 **After (Option 1 - Keep branded type):**
 
 ```typescript
 const email = EmailAddress.of(input)
-const value = email.getOrElse("" as Brand<"EmailAddress", string>)
+const value = email.orElse("" as Brand<"EmailAddress", string>)
 ```
 
 **After (Option 2 - Use fold for clean extraction):**

package/readme/ai-guide.md

@@ -11,9 +11,9 @@ This document provides a concise reference for AI models to understand the patte
 const some = Option(42) // Some(42)
 const none = Option(null) // None
 
-// Access: .get() or .getOrElse(default)
+// Access: .get() or .orElse(default)
 some.get() // 42
-none.getOrElse("default") // "default"
+none.orElse("default") // "default"
 
 // Transform: .map(), .flatMap(), .filter()
 some.map((x) => x * 2) // Some(84)
@@ -98,9 +98,9 @@ list.foldLeft(0)((acc, x) => acc + x) // 15
 // Create: Map({key: value})
 const map = Map({ a: 1, b: 2, c: 3 })
 
-// Access: .get(key), .getOrElse(key, default)
+// Access: .get(key), .orElse(key, default)
 map.get("a") // Some(1)
-map.getOrElse("d", 0) // 0
+map.orElse("d", 0) // 0
 
 // Transform: .map(), .filter()
 map.map((v) => v * 2) // Map({a: 2, b: 4, c: 6})
@@ -233,7 +233,7 @@ parseResult.fold(
 const userCity = Option(user)
   .flatMap((u) => Option(u.address))
   .flatMap((a) => Option(a.city))
-  .getOrElse("Unknown")
+  .orElse("Unknown")
 
 // Either chain
 parseInput(input)
@@ -295,7 +295,7 @@ const result = pipe(
   (opt) => opt.filter((s) => s.length > 0),
   (opt) => opt.map((s) => parseInt(s, 10)),
   (opt) => opt.filter((n) => !isNaN(n)),
-  (opt) => opt.getOrElse(0),
+  (opt) => opt.orElse(0),
 )
 
 // Converting between types
@@ -378,13 +378,13 @@ import { right, left } from "functype/either"
    // Bad
    const a = option.map((x) => x + 1)
    const b = a.filter((x) => x > 10)
-   const c = b.getOrElse(0)
+   const c = b.orElse(0)
 
    // Good
    const result = option
      .map((x) => x + 1)
      .filter((x) => x > 10)
-     .getOrElse(0)
+     .orElse(0)
    ```
 
 4. ❌ **Mixing Imperative and Functional Styles**:
@@ -402,5 +402,5 @@ import { right, left } from "functype/either"
    )
 
    // Good
-   const result = option.getOrElse(42)
+   const result = option.orElse(42)
    ```

package/readme/examples.md

@@ -47,8 +47,8 @@ console.log(withValue.get()) // 42
 // console.log(withoutValue.get())     // Would throw error - use getOrElse instead
 
 // Default values
-console.log(withValue.getOrElse(0)) // 42
-console.log(withoutValue.getOrElse(0)) // 0
+console.log(withValue.orElse(0)) // 42
+console.log(withoutValue.orElse(0)) // 0
 
 // Optional chaining alternative
 const user = Option({ name: "John", address: { city: "New York" } })
@@ -58,11 +58,11 @@ const noUser = Option(null)
 const city1 = user
   .flatMap((u) => Option(u.address))
   .flatMap((a) => Option(a.city))
-  .getOrElse("Unknown")
+  .orElse("Unknown")
 const city2 = noUser
   .flatMap((u) => Option(u.address))
   .flatMap((a) => Option(a.city))
-  .getOrElse("Unknown")
+  .orElse("Unknown")
 
 console.log(city1) // "New York"
 console.log(city2) // "Unknown"
@@ -169,8 +169,8 @@ console.log(success.get()) // 42
 // console.log(failure.get())  // Would throw error - use getOrElse instead
 
 // Default values
-console.log(success.getOrElse(0)) // 42
-console.log(failure.getOrElse(0)) // 0
+console.log(success.orElse(0)) // 42
+console.log(failure.orElse(0)) // 0
 
 // Get the left value
 console.log(failure.getLeft()) // "error"
@@ -328,8 +328,8 @@ console.log(success.get()) // 42
 // console.log(failure.get())  // Would throw the original error
 
 // Default values
-console.log(success.getOrElse(0)) // 42
-console.log(failure.getOrElse(0)) // 0
+console.log(success.orElse(0)) // 42
+console.log(failure.orElse(0)) // 0
 
 // Access the error
 console.log(failure.error.message) // "Something went wrong"
@@ -567,7 +567,7 @@ const scores = Map({
 // Access elements
 console.log(scores.get("alice")) // Some(95)
 console.log(scores.get("dave")) // None
-console.log(scores.getOrElse("dave", 0)) // 0
+console.log(scores.orElse("dave", 0)) // 0
 
 // Check properties
 console.log(scores.isEmpty()) // false
@@ -1328,7 +1328,7 @@ const processedName = userInput
   .map((s) => s.trim())
   .filter((s) => s.length > 0)
   .map((s) => s.toUpperCase())
-  .getOrElse("ANONYMOUS")
+  .orElse("ANONYMOUS")
 console.log(processedName) // "JOHN DOE"
 
 // Either chaining
@@ -1348,8 +1348,8 @@ const processAge = (input: string): Either<string, string> => {
     .map((age) => `Valid age: ${age}`)
 }
 
-console.log(processAge("35").getOrElse("Invalid age")) // "Valid age: 35"
-console.log(processAge("abc").getOrElse("Invalid age")) // "Invalid age"
+console.log(processAge("35").orElse("Invalid age")) // "Valid age: 35"
+console.log(processAge("abc").orElse("Invalid age")) // "Invalid age"
 
 // List chaining
 const numbers = List([1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
@@ -1372,7 +1372,7 @@ const result1 = pipe(
   Option(5),
   (opt) => opt.map((n) => n * 2),
   (opt) => opt.filter((n) => n > 5),
-  (opt) => opt.getOrElse(0),
+  (opt) => opt.orElse(0),
 )
 console.log(result1) // 10
 
@@ -1381,7 +1381,7 @@ const result2 = pipe(
   Either.right<string, number>(42),
   (either) => either.map((n) => n.toString()),
   (either) => either.mapLeft((e) => new Error(e)),
-  (either) => either.getOrElse("error"),
+  (either) => either.orElse("error"),
 )
 console.log(result2) // "42"
 
@@ -1389,9 +1389,9 @@ console.log(result2) // "42"
 const result3 = pipe(
   List([1, 2, 3, 4]),
   (list) => list.map((n) => n * 2),
-  (list) => Option(list.head().getOrElse(0)),
+  (list) => Option(list.head().orElse(0)),
   (opt) => opt.filter((n) => n > 5),
-  (opt) => Either.fromNullable(opt.getOrElse(null), "No valid value"),
+  (opt) => Either.fromNullable(opt.orElse(null), "No valid value"),
   (either) =>
     either.fold(
       (err) => `Error: ${err}`,
@@ -1419,13 +1419,13 @@ const userId = "user123"
 const user = findUserById(userId)
 
 // No need for null checks
-const greet = user.map((u) => `Hello, ${u.name}!`).getOrElse("User not found")
+const greet = user.map((u) => `Hello, ${u.name}!`).orElse("User not found")
 
 // Method chaining without worrying about null
 const userCity = user
   .flatMap((u) => Option(u.address))
   .flatMap((a) => Option(a.city))
-  .getOrElse("Unknown location")
+  .orElse("Unknown location")
 ```
 
 ### Either for Error Handling
@@ -2085,7 +2085,7 @@ userState.fold(
     console.log("User:", user.name, user.email)
     console.log("Cart items:", user.cart.size())
     console.log("Checkout history:", user.checkoutHistory.size(), "orders")
-    console.log("Latest order total:", user.checkoutHistory.head().getOrElse({ total: 0 }).total)
+    console.log("Latest order total:", user.checkoutHistory.head().orElse({ total: 0 }).total)
   },
 )
 ```

package/readme/quick-reference.md

@@ -20,8 +20,8 @@ option.isEmpty() // true if None, false if Some
 
 // Accessing
 option.get() // Gets value or throws if None
-option.getOrElse(defaultValue) // Gets value or returns default
-option.getOrElseThrow(new Error("No value")) // Gets value or throws custom error
+option.orElse(defaultValue) // Gets value or returns default
+option.orThrow(new Error("No value")) // Gets value or throws custom error
 
 // Transforming
 option.map((x) => x * 2) // Transforms inner value
@@ -58,7 +58,7 @@ either.isLeft() // true if Left, false if Right
 
 // Accessing
 either.get() // Gets Right value or throws if Left
-either.getOrElse(defaultValue) // Gets Right value or returns default
+either.orElse(defaultValue) // Gets Right value or returns default
 either.getLeft() // Gets Left value or throws if Right
 
 // Transforming
@@ -104,7 +104,7 @@ tryVal.isFailure() // true if Failure, false if Success
 
 // Accessing
 tryVal.get() // Gets value or throws original error
-tryVal.getOrElse(defaultValue) // Gets value or returns default
+tryVal.orElse(defaultValue) // Gets value or returns default
 tryVal.error // Gets error for Failure
 
 // Error handling
@@ -200,7 +200,7 @@ map.has("a") // true if key exists
 
 // Accessing
 map.get("a") // Option.Some with value or None
-map.getOrElse("a", 0) // Value or default
+map.orElse("a", 0) // Value or default
 map.keys() // List of keys
 map.values() // List of values
 map.entries() // List of [key, value] tuples
@@ -496,7 +496,7 @@ const result = pipe(
   (opt) => opt.map((s) => parseInt(s, 10)),
   (opt) => opt.filter((n) => !isNaN(n)),
   (opt) => opt.map((n) => n * 2),
-  (opt) => opt.getOrElse(0),
+  (opt) => opt.orElse(0),
 ) // 84
 
 // Cross-type transformations