jscrewit 2.37.0 → 2.38.0

package/lib/feature-all.d.ts

@@ -43,10 +43,19 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Safari 10+, Opera, and Node.js 4+.
+     * Available in Chrome, Edge, Firefox, Safari 10.0+, Opera, and Node.js 4+.
      */
     ARROW: ElementaryFeature;
 
+    /**
+     * Support for async functions, which return Promise object.
+     *
+     * @remarks
+     *
+     * Available in Chrome, Edge, Firefox, Safari 10.1+, Opera, and Node.js 7.6+.
+     */
+    ASYNC_FUNCTION: ElementaryFeature;
+
     /**
      * Existence of the native function Array.prototype.at.
      *
@@ -61,7 +70,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 10+, Safari, Opera, Android Browser, and Node.js 16.0+. This feature is not available inside web workers in Safari before 10.
+     * Available in Chrome, Edge, Firefox, Internet Explorer 10+, Safari, Opera, Android Browser, and Node.js 16.0+. This feature is not available inside web workers in Safari before 10.0.
      */
     ATOB: ElementaryFeature;
 
@@ -84,6 +93,15 @@ export interface FeatureAll
      */
     BROWSER: PredefinedFeature;
 
+    /**
+     * The ability to call a function on the global object when invoking Function.prototype.call without binding.
+     *
+     * @remarks
+     *
+     * Available in Android Browser before 4.1.
+     */
+    CALL_ON_GLOBAL: ElementaryFeature;
+
     /**
      * The property that the various string methods returning HTML code such as String.prototype.big or String.prototype.link have both the tag name and attributes written in capital letters.
      *
@@ -207,16 +225,29 @@ export interface FeatureAll
     /**
      * Features available in the current stable version of Firefox.
      *
-     * An alias for `FF_90`.
+     * An alias for `FF_131`.
      */
     FF: PredefinedFeature;
 
     /**
-     * Features available in Firefox 90 or later.
+     * Features available in Firefox 131 or later.
      *
      * @remarks
      *
-     * This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `FF`, `FF_ESR`, or `FF_PREV` instead of `FF_90` for long term support.
+     * This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `FF` instead of `FF_131` for long term support.
+     *
+     * @see
+     *
+     * [Engine Support Policy](https://github.com/fasttime/JScrewIt#engine-support-policy)
+     */
+    FF_131: PredefinedFeature;
+
+    /**
+     * Features available in Firefox 90 to 130.
+     *
+     * @remarks
+     *
+     * This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `FF_ESR` or `FF_PREV` instead of `FF_90` for long term support.
      *
      * @see
      *
@@ -341,15 +372,6 @@ export interface FeatureAll
      */
     HTMLAUDIOELEMENT: ElementaryFeature;
 
-    /**
-     * Existence of the global object document having the string representation "\[object HTMLDocument\]".
-     *
-     * @remarks
-     *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari, Opera, and Android Browser. This feature is not available inside web workers.
-     */
-    HTMLDOCUMENT: ElementaryFeature;
-
     /** Features available in Internet Explorer 10. */
     IE_10: PredefinedFeature;
 
@@ -387,16 +409,34 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari 10+, Opera, Android Browser 4.4, and Node.js 0.12+.
+     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari 10.0+, Opera, Android Browser 4.4, and Node.js 0.12+.
      */
     INTL: ElementaryFeature;
 
+    /**
+     * Availability of iterator helpers.
+     *
+     * @remarks
+     *
+     * Available in Chrome, Edge, Firefox 131+, Opera, and Node.js 22+.
+     */
+    ITERATOR_HELPER: ElementaryFeature;
+
+    /**
+     * Japanese string representation of Infinity ending with "∞".
+     *
+     * @remarks
+     *
+     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari 10.0+, Opera, Android Browser 4.4, and Node.js 0.12+.
+     */
+    JAPANESE_INFINITY: ElementaryFeature;
+
     /**
      * Language sensitive string representation of Infinity as "∞".
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 11 on Windows 10, Safari 10+, Opera, Android Browser 4.4, and Node.js 0.12+.
+     * Available in Chrome, Edge, Firefox, Internet Explorer 11 on Windows 10, Safari 10.0+, Opera, Android Browser 4.4, and Node.js 0.12+.
      */
     LOCALE_INFINITY: ElementaryFeature;
 
@@ -405,7 +445,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari 10+, Opera, Android Browser 4.4, and Node.js 13+.
+     * Available in Chrome, Edge, Firefox, Internet Explorer 11, Safari 10.0+, Opera, Android Browser 4.4, and Node.js 13+.
      */
     LOCALE_NUMERALS: ElementaryFeature;
 
@@ -416,7 +456,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer 11 on Windows 10, Safari 10+, Opera, Android Browser 4.4, and Node.js 13+.
+     * Available in Chrome, Edge, Firefox, Internet Explorer 11 on Windows 10, Safari 10.0+, Opera, Android Browser 4.4, and Node.js 13+.
      */
     LOCALE_NUMERALS_EXT: ElementaryFeature;
 
@@ -429,6 +469,15 @@ export interface FeatureAll
      */
     LOCATION: ElementaryFeature;
 
+    /**
+     * Existence of user agent string navigator.userAgent that starts with "Mozilla".
+     *
+     * @remarks
+     *
+     * Available in Chrome, Edge, Firefox, Internet Explorer, Safari, Opera, and Android Browser.
+     */
+    MOZILLA: ElementaryFeature;
+
     /**
      * Existence of the name property for functions.
      *
@@ -443,7 +492,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Safari before 10. This feature is not available inside web workers.
+     * Available in Safari before 10.0. This feature is not available inside web workers.
      */
     NODECONSTRUCTOR: ElementaryFeature;
 
@@ -480,9 +529,12 @@ export interface FeatureAll
     /** Features available in Node.js 4. */
     NODE_4: PredefinedFeature;
 
-    /** Features available in Node.js 5 to 9. */
+    /** Features available in Node.js 5 to 7.5. */
     NODE_5: PredefinedFeature;
 
+    /** Features available in Node.js 7.6 to 9. */
+    NODE_7_6: PredefinedFeature;
+
     /**
      * A string representation of native functions typical for V8 or for Internet Explorer but not for Firefox and Safari.
      *
@@ -528,7 +580,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Firefox, Safari 9+, and Node.js 0.12+ before 22.
+     * Available in Firefox before 131, Safari 9+, and Node.js 0.12+ before 22.
      */
     OBJECT_ARRAY_ENTRIES_CTOR: ElementaryFeature;
 
@@ -537,7 +589,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Internet Explorer and Safari before 10. This feature is not available inside web workers.
+     * Available in Internet Explorer and Safari before 10.0. This feature is not available inside web workers.
      */
     OBJECT_L_LOCATION_CTOR: ElementaryFeature;
 
@@ -551,20 +603,20 @@ export interface FeatureAll
     OBJECT_UNDEFINED: ElementaryFeature;
 
     /**
-     * The property that the string representation of the global object constructor starts with "\[object W".
+     * The property that the string representation of the global object self starts with "\[object W".
      *
      * @remarks
      *
-     * Available in Internet Explorer and Safari before 10. This feature is not available inside web workers in Safari before 10.
+     * Available in Chrome, Edge, Firefox, Internet Explorer, Safari, Opera, and Android Browser 4.4. This feature is not available inside web workers in Chrome, Edge, Firefox, Safari, Opera, and Android Browser 4.4.
      */
-    OBJECT_W_CTOR: ElementaryFeature;
+    OBJECT_W_SELF: ElementaryFeature;
 
     /**
      * Existence of the global object location.constructor whose string representation starts with "\[object " and ends with "LocationConstructor\]".
      *
      * @remarks
      *
-     * Available in Safari before 10.
+     * Available in Safari before 10.0.
      */
     OLD_SAFARI_LOCATION_CTOR: ElementaryFeature;
 
@@ -573,7 +625,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Internet Explorer 11, Safari 10+ before 14.0.1, Android Browser 4.4, and Node.js 0.12+ before 15.
+     * Available in Internet Explorer 11, Safari 10.0+ before 14.0.1, Android Browser 4.4, and Node.js 0.12+ before 15.
      */
     PLAIN_INTL: ElementaryFeature;
 
@@ -589,12 +641,15 @@ export interface FeatureAll
     /**
      * Features available in the current stable version of Safari.
      *
-     * An alias for `SAFARI_17_4`.
+     * An alias for `SAFARI_18`.
      */
     SAFARI: PredefinedFeature;
 
-    /** Features available in Safari 10 and Safari 11. */
-    SAFARI_10: PredefinedFeature;
+    /** Features available in Safari 10.0. */
+    SAFARI_10_0: PredefinedFeature;
+
+    /** Features available in Safari 10.1 and Safari 11. */
+    SAFARI_10_1: PredefinedFeature;
 
     /** Features available in Safari 12. */
     SAFARI_12: PredefinedFeature;
@@ -611,9 +666,12 @@ export interface FeatureAll
     /** Features available in Safari 15.4 to 17.3. */
     SAFARI_15_4: PredefinedFeature;
 
-    /** Features available in Safari 17.4 or later. */
+    /** Features available in Safari 17.4 to 17.6. */
     SAFARI_17_4: PredefinedFeature;
 
+    /** Features available in Safari 18 or later. */
+    SAFARI_18: PredefinedFeature;
+
     /** Features available in Safari 7.0. */
     SAFARI_7_0: PredefinedFeature;
 
@@ -631,7 +689,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox, Internet Explorer, Safari, Opera, and Android Browser. This feature is not available inside web workers in Safari 7.1+ before 10.
+     * Available in Chrome, Edge, Firefox, Internet Explorer, Safari, Opera, and Android Browser. This feature is not available inside web workers in Safari 7.1+ before 10.0.
      */
     SELF_OBJ: ElementaryFeature;
 
@@ -640,7 +698,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Firefox, Internet Explorer 11, Safari 10+, Android Browser 4.4, and Node.js 13+.
+     * Available in Firefox, Internet Explorer 11, Safari 10.0+ before 18, Android Browser 4.4, and Node.js 13+.
      */
     SHORT_LOCALES: ElementaryFeature;
 
@@ -691,9 +749,11 @@ type ElementaryFeatureName =
 | 'ANY_WINDOW'
 | 'ARRAY_ITERATOR'
 | 'ARROW'
+| 'ASYNC_FUNCTION'
 | 'AT'
 | 'ATOB'
 | 'BARPROP'
+| 'CALL_ON_GLOBAL'
 | 'CAPITAL_HTML'
 | 'CONSOLE'
 | 'DOCUMENT'
@@ -714,14 +774,16 @@ type ElementaryFeatureName =
 | 'GMT'
 | 'HISTORY'
 | 'HTMLAUDIOELEMENT'
-| 'HTMLDOCUMENT'
 | 'IE_SRC'
 | 'INCR_CHAR'
 | 'INTL'
+| 'ITERATOR_HELPER'
+| 'JAPANESE_INFINITY'
 | 'LOCALE_INFINITY'
 | 'LOCALE_NUMERALS'
 | 'LOCALE_NUMERALS_EXT'
 | 'LOCATION'
+| 'MOZILLA'
 | 'NAME'
 | 'NODECONSTRUCTOR'
 | 'NO_FF_SRC'
@@ -731,7 +793,7 @@ type ElementaryFeatureName =
 | 'OBJECT_ARRAY_ENTRIES_CTOR'
 | 'OBJECT_L_LOCATION_CTOR'
 | 'OBJECT_UNDEFINED'
-| 'OBJECT_W_CTOR'
+| 'OBJECT_W_SELF'
 | 'OLD_SAFARI_LOCATION_CTOR'
 | 'PLAIN_INTL'
 | 'REGEXP_STRING_ITERATOR'
@@ -754,6 +816,7 @@ ElementaryFeatureName
 | 'CHROME_122'
 | 'COMPACT'
 | 'DEFAULT'
+| 'FF_131'
 | 'FF_90'
 | 'IE_10'
 | 'IE_11'
@@ -771,13 +834,16 @@ ElementaryFeatureName
 | 'NODE_22'
 | 'NODE_4'
 | 'NODE_5'
-| 'SAFARI_10'
+| 'NODE_7_6'
+| 'SAFARI_10_0'
+| 'SAFARI_10_1'
 | 'SAFARI_12'
 | 'SAFARI_13'
 | 'SAFARI_14_0_1'
 | 'SAFARI_14_1'
 | 'SAFARI_15_4'
 | 'SAFARI_17_4'
+| 'SAFARI_18'
 | 'SAFARI_7_0'
 | 'SAFARI_7_1'
 | 'SAFARI_9'

package/lib/feature.d.ts

@@ -261,14 +261,14 @@ export interface FeatureConstructor extends FeatureAll
      * const newFeature = JScrewIt.Feature.commonOf(["ATOB", "NAME"], ["NAME", "SELF"]);
      * ```
      *
-     * This will create a new feature object equivalent to {@link FeatureConstructor.ANY_DOCUMENT |
-     * `ANY_DOCUMENT`}.
-     * This is because both {@link FeatureConstructor.HTMLDOCUMENT | `HTMLDOCUMENT`} and {@link
-     * FeatureConstructor.DOCUMENT | `DOCUMENT`} imply {@link FeatureConstructor.ANY_DOCUMENT |
-     * `ANY_DOCUMENT`}.
+     * This will create a new feature object equivalent to {@link FeatureConstructor.ANY_WINDOW |
+     * `ANY_WINDOW`}.
+     * This is because both {@link FeatureConstructor.DOMWINDOW | `DOMWINDOW`} and {@link
+     * FeatureConstructor.WINDOW | `WINDOW`} imply {@link FeatureConstructor.ANY_WINDOW |
+     * `ANY_WINDOW`}.
      *
      * ```js
-     * const newFeature = JScrewIt.Feature.commonOf("HTMLDOCUMENT", "DOCUMENT");
+     * const newFeature = JScrewIt.Feature.commonOf("DOMWINDOW", "WINDOW");
      * ```
      */
     commonOf(...features: FeatureElementOrCompatibleArray[]): CustomFeature | null;