typings: improve primordials typings

PR-URL: #46970
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>

Author: aduh95

lib/internal/per_context/primordials.js

@@ -307,9 +307,21 @@ const {
  WeakSet,
 }=primordials;
 
-// Because these functions are used by `makeSafe`, which is exposed
-// on the `primordials` object, it's important to use const references
-// to the primordials that they use:
+
+/**
+ * Creates a class that can be safely iterated over.
+ *
+ * Because these functions are used by `makeSafe`, which is exposed on the
+ * `primordials` object, it's important to use const references to the
+ * primordials that they use.
+ *
+ * @template {Iterable} T
+ * @template {*} TReturn
+ * @template {*} TNext
+ * @param {(self: T) => IterableIterator<T>} factory
+ * @param {(...args: [] | [TNext]) => IteratorResult<T, TReturn>} next
+ * @returns {Iterator<T, TReturn, TNext>}
+ */
 constcreateSafeIterator=(factory,next)=>{
 classSafeIterator{
 constructor(iterable){
@@ -617,6 +629,10 @@ class RegExpLikeForStringSplitting {
 }
 ObjectSetPrototypeOf(RegExpLikeForStringSplitting.prototype,null);
 
+/**
+ * @param {RegExp} pattern
+ * @returns {RegExp}
+ */
 primordials.hardenRegExp=functionhardenRegExp(pattern){
 ObjectDefineProperties(pattern,{
 [SymbolMatch]: {
@@ -706,6 +722,11 @@ primordials.hardenRegExp = function hardenRegExp(pattern) {
 };
 
 
+/**
+ * @param {string} str
+ * @param {RegExp} regexp
+ * @returns {number}
+ */
 primordials.SafeStringPrototypeSearch=(str,regexp)=>{
 regexp.lastIndex=0;
 constmatch=RegExpPrototypeExec(regexp,str);

typings/primordials.d.ts

@@ -597,4 +597,7 @@ declare namespace primordials {
 exportconstPromisePrototypeThen: UncurryThis<typeofPromise.prototype.then>
 exportconstPromisePrototypeCatch: UncurryThis<typeofPromise.prototype.catch>
 exportconstPromisePrototypeFinally: UncurryThis<typeofPromise.prototype.finally>
+exportimportProxy=globalThis.Proxy
+import_globalThis=globalThis
+export{_globalThisasglobalThis}
 }