migrations for js_undefined

Author: zth

packages/@rescript/runtime/Js_undefined.resi

@@ -28,23 +28,41 @@
 type t<+'a> = Primitive_js_extern.undefined<'a>
 
 /** Constructs a value of `Js.undefined<'a>` containing a value of `'a`. */
+@deprecated({
+  reason: "Use `Nullable.make` or `option` directly instead.",
+  migrate: Nullable.make(),
+})
 external return: 'a => t<'a> = "%identity"
 
 /** Returns `true` if the given value is empty (undefined), `false` otherwise. */
-@deprecated("Use = Js.undefined directly")
+@deprecated
 let test: t<'a> => bool
 
 /**
 Returns `true` if the given value is empty (undefined).
 
 **since 1.6.1**
 */
+@deprecated
 let testAny: 'a => bool
 
 /** The empty value, `undefined` */
+@deprecated({
+  reason: "Use `Nullable.undefined` instead.",
+  migrate: Nullable.undefined,
+})
 external empty: t<'a> = "%undefined"
 
+@deprecated({
+  reason: "Use `Nullable.getUnsafe` instead.",
+  migrate: Nullable.getUnsafe(),
+})
 external getUnsafe: t<'a> => 'a = "%identity"
+
+@deprecated({
+  reason: "Use `Nullable.getOrThrow` instead.",
+  migrate: Nullable.getOrThrow(),
+})
 let getExn: t<'a> => 'a
 
 /**
@@ -60,6 +78,10 @@ let maybeGreetWorld = (maybeGreeting: Js.undefined<string>) =>
   Js.Undefined.bind(maybeGreeting, greeting => greeting ++ " world!")
 ```
 */
+@deprecated({
+  reason: "Use `Nullable.map` instead.",
+  migrate: Nullable.map(),
+})
 let bind: (t<'a>, 'a => 'b) => t<'b>
 
 /**
@@ -74,22 +96,42 @@ let maybeSay = (maybeMessage: Js.undefined<string>) =>
   Js.Undefined.iter(maybeMessage, message => Js.log(message))
 ```
 */
+@deprecated({
+  reason: "Use `Nullable.forEach` instead.",
+  migrate: Nullable.forEach(),
+})
 let iter: (t<'a>, 'a => unit) => unit
 
 /**
 Maps `option<'a>` to `Js.undefined<'a>`.
 `Some(a)` => `a`
 `None` => `empty`
 */
+@deprecated({
+  reason: "Use `Nullable.fromOption` instead.",
+  migrate: Nullable.fromOption(),
+})
 let fromOption: option<'a> => t<'a>
 
-@deprecated("Use fromOption instead") let from_opt: option<'a> => t<'a>
+@deprecated({
+  reason: "Use `Nullable.fromOption` instead.",
+  migrate: Nullable.fromOption(),
+})
+let from_opt: option<'a> => t<'a>
 
 /**
 Maps `Js.undefined<'a>` to `option<'a>`
 `a` => `Some(a)`
 `empty` => `None`
 */
+@deprecated({
+  reason: "Use `Nullable.toOption` instead.",
+  migrate: Nullable.toOption(),
+})
 let toOption: t<'a> => option<'a>
 
-@deprecated("use toOption instead") let to_opt: t<'a> => option<'a>
+@deprecated({
+  reason: "Use `Nullable.toOption` instead.",
+  migrate: Nullable.toOption(),
+})
+let to_opt: t<'a> => option<'a>

tests/tools_tests/src/expected/StdlibMigration_Js_Undefined.res.expected

@@ -0,0 +1,36 @@
+let make1 = "hello"->Nullable.make
+let make2 = Nullable.make("hello")
+
+let empty1 = Nullable.undefined
+
+let getUnsafe1 = Nullable.make(1)->Nullable.getUnsafe
+let getUnsafe2 = Nullable.getUnsafe(Nullable.make(1))
+
+let getExn1 = Nullable.make(1)->Nullable.getOrThrow
+let getExn2 = Nullable.getOrThrow(Nullable.make(1))
+
+let map1 = Nullable.make(2)->Nullable.map(x => x + 1)
+let map2 = Nullable.map(Nullable.make(2), x => x + 1)
+
+let forEach1 = Nullable.make(2)->Nullable.forEach(x => ignore(x))
+let forEach2 = Nullable.forEach(Nullable.make(2), x => ignore(x))
+
+let fromOption1 = Some("x")->Nullable.fromOption
+let fromOption2 = Nullable.fromOption(None)
+
+let from_opt1 = Some("y")->Nullable.fromOption
+let from_opt2 = Nullable.fromOption(None)
+
+let toOption1 = Nullable.make(3)->Nullable.toOption
+let toOption2 = Nullable.toOption(Nullable.make(3))
+
+let to_opt1 = Nullable.make(4)->Nullable.toOption
+let to_opt2 = Nullable.toOption(Nullable.make(4))
+
+let test1 = Js.Undefined.empty->Js.Undefined.test
+let test2 = Js.Undefined.test(Js.Undefined.empty)
+let test3 = Js.Undefined.return(5)->Js.Undefined.bind(v => v)->Js.Undefined.test
+
+let testAny1 = Js.Undefined.testAny(Js.Undefined.empty)
+let testAny2 = Js.Undefined.empty->Js.Undefined.testAny
+

tests/tools_tests/src/migrate/StdlibMigration_Js_Undefined.res

@@ -0,0 +1,35 @@
+let make1 = "hello"->Js.Undefined.return
+let make2 = Js.Undefined.return("hello")
+
+let empty1 = Js.Undefined.empty
+
+let getUnsafe1 = Js.Undefined.return(1)->Js.Undefined.getUnsafe
+let getUnsafe2 = Js.Undefined.getUnsafe(Js.Undefined.return(1))
+
+let getExn1 = Js.Undefined.return(1)->Js.Undefined.getExn
+let getExn2 = Js.Undefined.getExn(Js.Undefined.return(1))
+
+let map1 = Js.Undefined.return(2)->Js.Undefined.bind(x => x + 1)
+let map2 = Js.Undefined.bind(Js.Undefined.return(2), x => x + 1)
+
+let forEach1 = Js.Undefined.return(2)->Js.Undefined.iter(x => ignore(x))
+let forEach2 = Js.Undefined.iter(Js.Undefined.return(2), x => ignore(x))
+
+let fromOption1 = Some("x")->Js.Undefined.fromOption
+let fromOption2 = Js.Undefined.fromOption(None)
+
+let from_opt1 = Some("y")->Js.Undefined.from_opt
+let from_opt2 = Js.Undefined.from_opt(None)
+
+let toOption1 = Js.Undefined.return(3)->Js.Undefined.toOption
+let toOption2 = Js.Undefined.toOption(Js.Undefined.return(3))
+
+let to_opt1 = Js.Undefined.return(4)->Js.Undefined.to_opt
+let to_opt2 = Js.Undefined.to_opt(Js.Undefined.return(4))
+
+let test1 = Js.Undefined.empty->Js.Undefined.test
+let test2 = Js.Undefined.test(Js.Undefined.empty)
+let test3 = Js.Undefined.return(5)->Js.Undefined.bind(v => v)->Js.Undefined.test
+
+let testAny1 = Js.Undefined.testAny(Js.Undefined.empty)
+let testAny2 = Js.Undefined.empty->Js.Undefined.testAny

tests/tools_tests/src/migrate/migrated/Migrated_StdlibMigration_Js_Undefined.res

@@ -0,0 +1,37 @@
+// This file is autogenerated so it can be type checked.
+// It's the migrated version of src/migrate/StdlibMigration_Js_Undefined.res.
+let make1 = "hello"->Nullable.make
+let make2 = Nullable.make("hello")
+
+let empty1 = Nullable.undefined
+
+let getUnsafe1 = Nullable.make(1)->Nullable.getUnsafe
+let getUnsafe2 = Nullable.getUnsafe(Nullable.make(1))
+
+let getExn1 = Nullable.make(1)->Nullable.getOrThrow
+let getExn2 = Nullable.getOrThrow(Nullable.make(1))
+
+let map1 = Nullable.make(2)->Nullable.map(x => x + 1)
+let map2 = Nullable.map(Nullable.make(2), x => x + 1)
+
+let forEach1 = Nullable.make(2)->Nullable.forEach(x => ignore(x))
+let forEach2 = Nullable.forEach(Nullable.make(2), x => ignore(x))
+
+let fromOption1 = Some("x")->Nullable.fromOption
+let fromOption2 = Nullable.fromOption(None)
+
+let from_opt1 = Some("y")->Nullable.fromOption
+let from_opt2 = Nullable.fromOption(None)
+
+let toOption1 = Nullable.make(3)->Nullable.toOption
+let toOption2 = Nullable.toOption(Nullable.make(3))
+
+let to_opt1 = Nullable.make(4)->Nullable.toOption
+let to_opt2 = Nullable.toOption(Nullable.make(4))
+
+let test1 = Js.Undefined.empty->Js.Undefined.test
+let test2 = Js.Undefined.test(Js.Undefined.empty)
+let test3 = Js.Undefined.return(5)->Js.Undefined.bind(v => v)->Js.Undefined.test
+
+let testAny1 = Js.Undefined.testAny(Js.Undefined.empty)
+let testAny2 = Js.Undefined.empty->Js.Undefined.testAny