more migrations

Author: zth

packages/@rescript/runtime/Js.res

@@ -156,50 +156,105 @@ module Map = Js_map
 module WeakMap = Js_weakmap
 
 /** JS object type */
+@deprecated(
+  "This has been deprecated and will be removed in v13. Use the `{..}` type directly instead."
+)
 type t<'a> = {..} as 'a
 
 /** JS global object reference */
 @val
+@deprecated({
+  reason: "Use `globalThis` directly instead.",
+  migrate: globalThis(),
+})
 external globalThis: t<'a> = "globalThis"
 
+@deprecated({
+  reason: "Use `Null.t` directly instead.",
+  migrate: %replace.type(: Null.t),
+})
 @unboxed
 type null<+'a> = Js_null.t<'a> = Value('a) | @as(null) Null
 
+@deprecated("This has been deprecated and will be removed in v13.")
 type undefined<+'a> = Js_undefined.t<'a>
 
 @unboxed
+@deprecated({
+  reason: "Use `Nullable.t` directly instead.",
+  migrate: %replace.type(: Nullable.t),
+})
 type nullable<+'a> = Js_null_undefined.t<'a> = Value('a) | @as(null) Null | @as(undefined) Undefined
 
+@deprecated({
+  reason: "Use `Nullable.t` directly instead.",
+  migrate: %replace.type(: Nullable.t),
+})
 type null_undefined<+'a> = nullable<'a>
 
 external toOption: nullable<'a> => option<'a> = "%nullable_to_opt"
+@deprecated({
+  reason: "Use `fromUndefined` instead.",
+  migrate: fromUndefined(),
+})
 let undefinedToOption: undefined<'a> => option<'a> = Primitive_option.fromUndefined
+@deprecated({
+  reason: "Use `Null.toOption` instead.",
+  migrate: Null.toOption(),
+})
 external nullToOption: null<'a> => option<'a> = "%null_to_opt"
+@deprecated({
+  reason: "Use `isNullable` directly instead.",
+  migrate: isNullable(),
+})
 external isNullable: nullable<'a> => bool = "%is_nullable"
+@deprecated({
+  reason: "Use `import` directly instead.",
+  migrate: import(),
+})
 external import: 'a => promise<'a> = "%import"
 
 /** The same as {!test} except that it is more permissive on the types of input */
+@deprecated({
+  reason: "Use `testAny` directly instead.",
+  migrate: testAny(),
+})
 external testAny: 'a => bool = "%is_nullable"
 
 /**
   The promise type, defined here for interoperation across packages.
 */
+@deprecated(
+  "This is deprecated and will be removed in v13. Use the `promise` type directly instead."
+)
 type promise<+'a, +'e>
 
 /**
   The same as empty in `Js.Null`. Compiles to `null`.
 */
+@deprecated({
+  reason: "Use `null` instead.",
+  migrate: null(),
+})
 external null: null<'a> = "%null"
 
 /**
   The same as empty `Js.Undefined`. Compiles to `undefined`.
 */
+@deprecated({
+  reason: "Use `undefined` instead.",
+  migrate: undefined(),
+})
 external undefined: undefined<'a> = "%undefined"
 
 /**
 `typeof x` will be compiled as `typeof x` in JS. Please consider functions in
 `Js.Types` for a type safe way of reflection.
 */
+@deprecated({
+  reason: "Use `typeof` instead.",
+  migrate: typeof(),
+})
 external typeof: 'a => string = "%typeof"
 
 /** Equivalent to console.log any value. */
@@ -245,8 +300,20 @@ external log4: ('a, 'b, 'c, 'd) => unit = "log"
 @variadic
 external logMany: array<'a> => unit = "log"
 
+@deprecated({
+  reason: "Use `eqNull` directly instead.",
+  migrate: eqNull(),
+})
 external eqNull: ('a, null<'a>) => bool = "%equal_null"
+@deprecated({
+  reason: "Use `eqUndefined` directly instead.",
+  migrate: eqUndefined(),
+})
 external eqUndefined: ('a, undefined<'a>) => bool = "%equal_undefined"
+@deprecated({
+  reason: "Use `eqNullable` directly instead.",
+  migrate: eqNullable(),
+})
 external eqNullable: ('a, nullable<'a>) => bool = "%equal_nullable"
 
 /* ## Operators */
@@ -256,22 +323,38 @@ external eqNullable: ('a, nullable<'a>) => bool = "%equal_nullable"
     It is marked as unsafe, since it is impossible
     to give a proper semantics for comparision which applies to any type
 */
+@deprecated({
+  reason: "Use `lt` instead.",
+  migrate: lt(),
+})
 external unsafe_lt: ('a, 'a) => bool = "%unsafe_lt"
 
 /**
    `unsafe_le(a, b)` will be compiled as `a <= b`.
    See also `Js.unsafe_lt`.
 */
+@deprecated({
+  reason: "Use `le` instead.",
+  migrate: le(),
+})
 external unsafe_le: ('a, 'a) => bool = "%unsafe_le"
 
 /**
    `unsafe_gt(a, b)` will be compiled as `a > b`.
     See also `Js.unsafe_lt`.
 */
+@deprecated({
+  reason: "Use `gt` instead.",
+  migrate: gt(),
+})
 external unsafe_gt: ('a, 'a) => bool = "%unsafe_gt"
 
 /**
    `unsafe_ge(a, b)` will be compiled as `a >= b`.
    See also `Js.unsafe_lt`.
 */
+@deprecated({
+  reason: "Use `ge` instead.",
+  migrate: ge(),
+})
 external unsafe_ge: ('a, 'a) => bool = "%unsafe_ge"

packages/@rescript/runtime/Js_OO.res

@@ -24,52 +24,52 @@
 
 @@config({flags: ["-unboxed-types"]})
 
-@deprecated
+@deprecated("This has been deprecated and will be removed in v13.")
 external unsafe_to_method: 'a => 'a = "%unsafe_to_method"
 
 module Callback = {
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity1<'a> = {@internal i1: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity2<'a> = {@internal i2: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity3<'a> = {@internal i3: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity4<'a> = {@internal i4: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity5<'a> = {@internal i5: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity6<'a> = {@internal i6: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity7<'a> = {@internal i7: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity8<'a> = {@internal i8: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity9<'a> = {@internal i9: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity10<'a> = {@internal i10: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity11<'a> = {@internal i11: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity12<'a> = {@internal i12: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity13<'a> = {@internal i13: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity14<'a> = {@internal i14: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity15<'a> = {@internal i15: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity16<'a> = {@internal i16: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity17<'a> = {@internal i17: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity18<'a> = {@internal i18: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity19<'a> = {@internal i19: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity20<'a> = {@internal i20: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity21<'a> = {@internal i21: 'a}
-  @deprecated
+  @deprecated("This has been deprecated and will be removed in v13.")
   type arity22<'a> = {@internal i22: 'a}
 }

packages/@rescript/runtime/Stdlib_Array.res

@@ -13,11 +13,24 @@ external unsafe_get: (array<'a>, int) => 'a = "%array_unsafe_get"
 @val
 external fromArrayLikeWithMap: (arrayLike<'a>, 'a => 'b) => array<'b> = "Array.from"
 
-@deprecated("Use `fill` instead") @send external fillAll: (array<'a>, 'a) => unit = "fill"
+@deprecated({
+  reason: "Use `fill` instead",
+  migrate: Array.fill(),
+})
+@send
+external fillAll: (array<'a>, 'a) => unit = "fill"
 
 @val external fromString: string => array<string> = "Array.from"
 
-@deprecated("Use `fill` instead") @send
+@deprecated({
+  reason: "Use `fill` instead",
+  migrate: Array.fill(
+    %insert.unlabelledArgument(0),
+    %insert.unlabelledArgument(1),
+    ~start=%insert.labelledArgument("start"),
+  ),
+})
+@send
 external fillToEnd: (array<'a>, 'a, ~start: int) => unit = "fill"
 
 @send external fill: (array<'a>, 'a, ~start: int=?, ~end: int=?) => unit = "fill"
@@ -86,10 +99,15 @@ let compare = (a, b, cmp) => {
     : compareFromIndex(a, b, 0, cmp, lenA)
 }
 
-@deprecated("Use `copyWithin` instead") @send
+@deprecated("Use `copyWithin` instead")
+@send
 external copyAllWithin: (array<'a>, ~target: int) => array<'a> = "copyWithin"
 
-@deprecated("Use `copyWithin` instead") @send
+@deprecated({
+  reason: "Use `copyWithin` instead",
+  migrate: Array.copyWithin(),
+})
+@send
 external copyWithinToEnd: (array<'a>, ~target: int, ~start: int) => array<'a> = "copyWithin"
 
 @send
@@ -134,17 +152,29 @@ let indexOfOpt = (arr, item) =>
   | -1 => None
   | index => Some(index)
   }
-@deprecated("Use `indexOf` instead") @send
+@deprecated({
+  reason: "Use `indexOf` instead",
+  migrate: Array.indexOf(~from=%insert.unlabelledArgument(2)),
+})
+@send
 external indexOfFrom: (array<'a>, 'a, int) => int = "indexOf"
 
 @send external join: (array<string>, string) => string = "join"
 
-@deprecated("Use `join` instead") @send
+@deprecated({
+  reason: "Use `join` instead",
+  migrate: Array.join(),
+})
+@send
 external joinWith: (array<string>, string) => string = "join"
 
 @send external joinUnsafe: (array<'a>, string) => string = "join"
 
-@deprecated("Use `joinUnsafe` instead") @send
+@deprecated({
+  reason: "Use `joinUnsafe` instead",
+  migrate: Array.joinUnsafe(),
+})
+@send
 external joinWithUnsafe: (array<'a>, string) => string = "join"
 
 @send external lastIndexOf: (array<'a>, 'a, ~from: int=?) => int = "lastIndexOf"
@@ -153,11 +183,19 @@ let lastIndexOfOpt = (arr, item) =>
   | -1 => None
   | index => Some(index)
   }
-@deprecated("Use `lastIndexOf` instead") @send
+@deprecated({
+  reason: "Use `lastIndexOf` instead",
+  migrate: Array.lastIndexOf(~from=%insert.unlabelledArgument(2)),
+})
+@send
 external lastIndexOfFrom: (array<'a>, 'a, int) => int = "lastIndexOf"
 
 @send external slice: (array<'a>, ~start: int=?, ~end: int=?) => array<'a> = "slice"
-@deprecated("Use `slice` instead") @send
+@deprecated({
+  reason: "Use `slice` instead",
+  migrate: Array.slice(),
+})
+@send
 external sliceToEnd: (array<'a>, ~start: int) => array<'a> = "slice"
 
 @send external copy: array<'a> => array<'a> = "slice"