more migrations

Author: zth

packages/@rescript/runtime/Js_array.res

@@ -42,6 +42,10 @@ type t<'a> = array<'a>
 /**
 A type used to describe JavaScript objects that are like an array or are iterable.
 */
+@deprecated({
+  reason: "Use `Array.arrayLike` instead.",
+  migrate: %replace.type(: Array.arrayLike),
+})
 type array_like<'a> = Js_array2.array_like<'a>
 
 /* commented out until bs has a plan for iterators
@@ -59,6 +63,10 @@ Js.Array.from(strArr) == ["a", "b", "c", "d"]
 ```
 */
 @val
+@deprecated({
+  reason: "Use `Array.fromArrayLike` instead.",
+  migrate: Array.fromArrayLike(),
+})
 external from: array_like<'a> => array<'a> = "Array.from"
 
 /* ES2015 */
@@ -78,11 +86,20 @@ Js.Array.fromMap(strArr, code) == [97.0, 98.0, 99.0, 100.0]
 ```
 */
 @val
+@deprecated({
+  reason: "Use `Array.fromArrayLikeWithMap` instead.",
+  migrate: Array.fromArrayLikeWithMap(),
+})
 external fromMap: (array_like<'a>, 'a => 'b) => array<'b> = "Array.from"
 
 /* ES2015 */
 
-@val external isArray: 'a => bool = "Array.isArray"
+@deprecated({
+  reason: "Use `Array.isArray` instead.",
+  migrate: Array.isArray(),
+})
+@val
+external isArray: 'a => bool = "Array.isArray"
 /* ES2015 */
 /*
 Returns `true` if its argument is an array; `false` otherwise. This is a
@@ -101,6 +118,10 @@ Js.Array.isArray("abcd") == false
 /**
 Returns the number of elements in the array. See [`Array.length`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/length) on MDN.
 */
+@deprecated({
+  reason: "Use `Array.length` instead.",
+  migrate: Array.length(),
+})
 external length: array<'a> => int = "%array_length"
 
 /* Mutator functions */
@@ -222,6 +243,10 @@ let empty: array<int> = []
 Js.Array.pop(empty) == None
 ```
 */
+@deprecated({
+  reason: "Use `Array.pop` instead.",
+  migrate: Array.pop(),
+})
 @send
 external pop: t<'a> => option<'a> = "pop"
 
@@ -266,6 +291,10 @@ Js.Array.reverseInPlace(arr) == ["cat", "bee", "ant"]
 arr == ["cat", "bee", "ant"]
 ```
 */
+@deprecated({
+  reason: "Use `Array.reverse` instead.",
+  migrate: Array.reverse(),
+})
 @send
 external reverseInPlace: t<'a> => 'this = "reverse"
 
@@ -283,6 +312,10 @@ let empty: array<int> = []
 Js.Array.shift(empty) == None
 ```
 */
+@deprecated({
+  reason: "Use `Array.shift` instead.",
+  migrate: Array.shift(),
+})
 @send
 external shift: t<'a> => option<'a> = "shift"
 
@@ -301,6 +334,9 @@ Js.Array.sortInPlace(numbers) == [1, 10, 2, 20, 3, 30]
 numbers == [1, 10, 2, 20, 3, 30]
 ```
 */
+@deprecated(
+  "This has been deprecated and will be removed in v13. Use functions from the `Array` module instead."
+)
 @send
 external sortInPlace: t<'a> => 'this = "sort"
 
@@ -531,7 +567,7 @@ Js.Array.indexOfFrom("b", ~from=2, ["a", "b", "a", "c", "a"]) == -1
 external indexOfFrom: (t<'a>, 'a, ~from: int) => int = "indexOf"
 let indexOfFrom = (arg1, ~from, obj) => indexOfFrom(obj, arg1, ~from)
 
-@send @deprecated("please use joinWith instead")
+@send @deprecated({reason: "Use `Array.join` instead.", migrate: Array.join()})
 external join: t<'a> => string = "join"
 
 /**
@@ -615,6 +651,10 @@ Returns a copy of the entire array. Same as `Js.Array.Slice(~start=0,
 [`Array.slice`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice)
 on MDN.
 */
+@deprecated({
+  reason: "Use `Array.copy` instead.",
+  migrate: Array.copy(),
+})
 @send
 external copy: t<'a> => 'this = "slice"
 
@@ -646,6 +686,10 @@ Js.Array.toString([3.5, 4.6, 7.8]) == "3.5,4.6,7.8"
 Js.Array.toString(["a", "b", "c"]) == "a,b,c"
 ```
 */
+@deprecated({
+  reason: "Use `Array.toString` instead.",
+  migrate: Array.toString(),
+})
 @send
 external toString: t<'a> => string = "toString"
 
@@ -665,6 +709,10 @@ Js.Array.toLocaleString([Js.Date.make()])
 // returns "2020-3-19 10:52:11" for locale de_DE.utf8
 ```
 */
+@deprecated({
+  reason: "Use `Array.toLocaleString` instead.",
+  migrate: Array.toLocaleString(),
+})
 @send
 external toLocaleString: t<'a> => string = "toLocaleString"
 
@@ -1063,6 +1111,10 @@ Js.Array.unsafe_get(arr, 3) == 103
 Js.Array.unsafe_get(arr, 4) // returns undefined
 ```
 */
+@deprecated({
+  reason: "Use `Array.getUnsafe` instead.",
+  migrate: Array.getUnsafe(),
+})
 external unsafe_get: (array<'a>, int) => 'a = "%array_unsafe_get"
 
 /**
@@ -1087,4 +1139,8 @@ Js.Array.unsafe_set(arr, -1, 66)
 // you don't want to know.
 ```
 */
+@deprecated({
+  reason: "Use `Array.setUnsafe` instead.",
+  migrate: Array.setUnsafe(),
+})
 external unsafe_set: (array<'a>, int, 'a) => unit = "%array_unsafe_set"

packages/@rescript/runtime/Js_string.res

@@ -42,6 +42,10 @@ Js.String2.make(3.5) == "3.5"
 Js.String2.make([1, 2, 3]) == "1,2,3"
 ```
 */
+@deprecated({
+  reason: "Use `String.make` instead.",
+  migrate: String.make(),
+})
 @val
 external make: 'a => t = "String"
 
@@ -58,6 +62,10 @@ Js.String2.fromCharCode(0xd55c) == `한`
 Js.String2.fromCharCode(-64568) == `ψ`
 ```
 */
+@deprecated({
+  reason: "Use `String.fromCharCode` instead.",
+  migrate: String.fromCharCode(),
+})
 @val
 external fromCharCode: int => t = "String.fromCharCode"
 
@@ -67,7 +75,12 @@ corresponding to the given numbers, using the same rules as `fromCharCode`. See
 [`String.fromCharCode`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/fromCharCode)
 on MDN.
 */
-@val @variadic
+@deprecated({
+  reason: "Use `String.fromCharCodeMany` instead.",
+  migrate: String.fromCharCodeMany(),
+})
+@val
+@variadic
 external fromCharCodeMany: array<int> => t = "String.fromCharCode"
 
 /**
@@ -89,6 +102,10 @@ Js.String2.fromCodePoint(0xd55c) == `한`
 Js.String2.fromCodePoint(0x1f63a) == `😺`
 ```
 */
+@deprecated({
+  reason: "Use `String.fromCodePoint` instead.",
+  migrate: String.fromCodePoint(),
+})
 @val
 external fromCodePoint: int => t = "String.fromCodePoint"
 
@@ -106,7 +123,12 @@ on MDN.
 Js.String2.fromCodePointMany([0xd55c, 0xae00, 0x1f63a]) == `한글😺`
 ```
 */
-@val @variadic
+@deprecated({
+  reason: "Use `String.fromCodePointMany` instead.",
+  migrate: String.fromCodePointMany(),
+})
+@val
+@variadic
 external fromCodePointMany: array<int> => t = "String.fromCodePoint"
 
 /* String.raw: ES2015, meant to be used with template strings, not directly */
@@ -122,6 +144,10 @@ on MDN.
 Js.String2.length("abcd") == 4
 ```
 */
+@deprecated({
+  reason: "Use `String.length` instead.",
+  migrate: String.length(),
+})
 @get
 external length: t => int = "length"
 
@@ -138,6 +164,10 @@ Js.String2.get("Reason", 4) == "o"
 Js.String2.get(`Rẽasöń`, 5) == `ń`
 ```
 */
+@deprecated({
+  reason: "Use `String.get` instead.",
+  migrate: String.get(),
+})
 @get_index
 external get: (t, int) => t = ""
 
@@ -465,6 +495,10 @@ on MDN.
 See also [Unicode technical report #15](https://unicode.org/reports/tr15/) for
 details.
 */
+@deprecated({
+  reason: "Use `String.normalize` instead.",
+  migrate: String.normalize(),
+})
 @send
 external normalize: t => t = "normalize"
 
@@ -933,6 +967,10 @@ Js.String.toLowerCase(`ΣΠ`) == `σπ`
 Js.String.toLowerCase(`ΠΣ`) == `πς`
 ```
 */
+@deprecated({
+  reason: "Use `String.toLowerCase` instead.",
+  migrate: String.toLowerCase(),
+})
 @send
 external toLowerCase: t => t = "toLowerCase"
 
@@ -942,6 +980,10 @@ external toLowerCase: t => t = "toLowerCase"
 See [`String.toLocaleLowerCase`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLocaleLowerCase)
 on MDN.
 */
+@deprecated({
+  reason: "Use `String.toLocaleLowerCase` instead.",
+  migrate: String.toLocaleLowerCase(),
+})
 @send
 external toLocaleLowerCase: t => t = "toLocaleLowerCase"
 
@@ -962,6 +1004,10 @@ Js.String.toUpperCase(`Straße`) == `STRASSE`
 Js.String.toUpperCase(`πς`) == `ΠΣ`
 ```
 */
+@deprecated({
+  reason: "Use `String.toUpperCase` instead.",
+  migrate: String.toUpperCase(),
+})
 @send
 external toUpperCase: t => t = "toUpperCase"
 
@@ -971,6 +1017,10 @@ external toUpperCase: t => t = "toUpperCase"
 See [`String.to:LocaleUpperCase`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLocaleUpperCase)
 on MDN.
 */
+@deprecated({
+  reason: "Use `String.toLocaleUpperCase` instead.",
+  migrate: String.toLocaleUpperCase(),
+})
 @send
 external toLocaleUpperCase: t => t = "toLocaleUpperCase"
 
@@ -988,6 +1038,10 @@ Js.String.trim("   abc def   ") == "abc def"
 Js.String.trim("\n\r\t abc def \n\n\t\r ") == "abc def"
 ```
 */
+@deprecated({
+  reason: "Use `String.trim` instead.",
+  migrate: String.trim(),
+})
 @send
 external trim: t => t = "trim"
 
@@ -1041,4 +1095,7 @@ let arr = Js.Array2.fromMap(Js.String.castToArrayLike(s), x => x)
 arr == ["a", "b", "c", "d", "e"]
 ```
 */
+@deprecated(
+  "This has been deprecated and will be removed in v13. Use functions from the `String` module instead."
+)
 external castToArrayLike: t => Js_array2.array_like<t> = "%identity"

packages/@rescript/runtime/Js_typed_array.res

@@ -30,7 +30,15 @@ JavaScript Typed Array API
 
 @@warning("-103")
 
+@deprecated({
+  reason: "Use `ArrayBuffer.t` instead.",
+  migrate: %replace.type(: ArrayBuffer.t),
+})
 type array_buffer = Js_typed_array2.array_buffer
+
+@deprecated(
+  "This has been deprecated and will be removed in v13. Use functions and types from the `TypedArray` module instead."
+)
 type array_like<'a> = Js_typed_array2.array_like<'a>
 
 module type Type = {
@@ -1489,12 +1497,20 @@ module Float32Array = {
   // @bs.send.pipe(: t) external lastIndexOfFrom: (elt, ~from: int) => int = "lastIndexOf"
 
   // @bs.send.pipe(: t) /** `start` is inclusive, `end_` exclusive */
+  @deprecated({
+    reason: "Use `TypedArray.slice` instead.",
+    migrate: TypedArray.slice(~end=%insert.labelledArgument("end_")),
+  })
   external slice: (~start: int, ~end_: int) => t = "slice"
 
   // @bs.send.pipe(: t) external copy: t = "slice"
   // @bs.send.pipe(: t) external sliceFrom: int => t = "slice"
 
   // @bs.send.pipe(: t) /** `start` is inclusive, `end_` exclusive */
+  @deprecated({
+    reason: "Use `TypedArray.subarray` instead.",
+    migrate: TypedArray.subarray(~end=%insert.labelledArgument("end_")),
+  })
   external subarray: (~start: int, ~end_: int) => t = "subarray"
 
   // @bs.send.pipe(: t) external subarrayFrom: int => t = "subarray"