jscrewit 2.35.1 → 2.36.0

package/api-doc/interfaces/FeatureConstructor.md

@@ -17,12 +17,22 @@ Creates a new feature object from the union of the specified features.
 The constructor can be used with or without the `new` operator, e.g.
 `new JScrewIt.Feature(feature1, feature2)` or `JScrewIt.Feature(feature1, feature2)`.
 If no arguments are specified, the new feature object will be equivalent to
-[`DEFAULT`](FeatureConstructor.md#default).
+[`DEFAULT`](FeatureAll.md#default).
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
+
+#### Returns
+
+[`CustomFeature`](CustomFeature.md)
 
 **`Example`**
 
 The following statements are equivalent, and will all construct a new feature object
-including both [`ANY_DOCUMENT`](FeatureConstructor.md#any_document) and [`ANY_WINDOW`](FeatureConstructor.md#any_window).
+including both [`ANY_DOCUMENT`](FeatureAll.md#any_document) and [`ANY_WINDOW`](FeatureConstructor.md#any_window).
 
 ```js
 new JScrewIt.Feature("ANY_DOCUMENT", "ANY_WINDOW");
@@ -40,16 +50,6 @@ new JScrewIt.Feature([JScrewIt.Feature.ANY_DOCUMENT, JScrewIt.Feature.ANY_WINDOW
 
 An error is thrown if any of the specified features are not mutually compatible.
 
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
-
-#### Returns
-
-[`CustomFeature`](CustomFeature.md)
-
 ## Table of contents
 
 ### Constructors
@@ -73,7 +73,7 @@ An error is thrown if any of the specified features are not mutually compatible.
 - [BROWSER](FeatureConstructor.md#browser)
 - [CAPITAL\_HTML](FeatureConstructor.md#capital_html)
 - [CHROME](FeatureConstructor.md#chrome)
-- [CHROME\_92](FeatureConstructor.md#chrome_92)
+- [CHROME\_122](FeatureConstructor.md#chrome_122)
 - [CHROME\_PREV](FeatureConstructor.md#chrome_prev)
 - [COMPACT](FeatureConstructor.md#compact)
 - [CONSOLE](FeatureConstructor.md#console)
@@ -130,6 +130,7 @@ An error is thrown if any of the specified features are not mutually compatible.
 - [NO\_IE\_SRC](FeatureConstructor.md#no_ie_src)
 - [NO\_OLD\_SAFARI\_ARRAY\_ITERATOR](FeatureConstructor.md#no_old_safari_array_iterator)
 - [NO\_V8\_SRC](FeatureConstructor.md#no_v8_src)
+- [OBJECT\_ARRAY\_ENTRIES\_CTOR](FeatureConstructor.md#object_array_entries_ctor)
 - [OBJECT\_L\_LOCATION\_CTOR](FeatureConstructor.md#object_l_location_ctor)
 - [OBJECT\_UNDEFINED](FeatureConstructor.md#object_undefined)
 - [OBJECT\_W\_CTOR](FeatureConstructor.md#object_w_ctor)
@@ -143,6 +144,7 @@ An error is thrown if any of the specified features are not mutually compatible.
 - [SAFARI\_14\_0\_1](FeatureConstructor.md#safari_14_0_1)
 - [SAFARI\_14\_1](FeatureConstructor.md#safari_14_1)
 - [SAFARI\_15\_4](FeatureConstructor.md#safari_15_4)
+- [SAFARI\_17\_4](FeatureConstructor.md#safari_17_4)
 - [SAFARI\_7\_0](FeatureConstructor.md#safari_7_0)
 - [SAFARI\_7\_1](FeatureConstructor.md#safari_7_1)
 - [SAFARI\_9](FeatureConstructor.md#safari_9)
@@ -165,19 +167,29 @@ An error is thrown if any of the specified features are not mutually compatible.
 
 ### constructor
 
-• **new FeatureConstructor**(`...features`)
+• **new FeatureConstructor**(`...features`): [`CustomFeature`](CustomFeature.md)
 
 Creates a new feature object from the union of the specified features.
 
 The constructor can be used with or without the `new` operator, e.g.
 `new JScrewIt.Feature(feature1, feature2)` or `JScrewIt.Feature(feature1, feature2)`.
 If no arguments are specified, the new feature object will be equivalent to
-[`DEFAULT`](FeatureConstructor.md#default).
+[`DEFAULT`](FeatureAll.md#default).
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
+
+#### Returns
+
+[`CustomFeature`](CustomFeature.md)
 
 **`Example`**
 
 The following statements are equivalent, and will all construct a new feature object
-including both [`ANY_DOCUMENT`](FeatureConstructor.md#any_document) and [`ANY_WINDOW`](FeatureConstructor.md#any_window).
+including both [`ANY_DOCUMENT`](FeatureAll.md#any_document) and [`ANY_WINDOW`](FeatureConstructor.md#any_window).
 
 ```js
 JScrewIt.Feature("ANY_DOCUMENT", "ANY_WINDOW");
@@ -195,12 +207,6 @@ JScrewIt.Feature([JScrewIt.Feature.ANY_DOCUMENT, JScrewIt.Feature.ANY_WINDOW]);
 
 An error is thrown if any of the specified features are not mutually compatible.
 
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
-
 #### Inherited from
 
 FeatureAll.constructor
@@ -425,7 +431,7 @@ ___
 
 Features available in the current stable versions of Chrome, Edge and Opera.
 
-An alias for `CHROME_92`.
+An alias for `CHROME_122`.
 
 #### Inherited from
 
@@ -433,15 +439,15 @@ An alias for `CHROME_92`.
 
 ___
 
-### CHROME\_92
+### CHROME\_122
 
-• **CHROME\_92**: [`PredefinedFeature`](PredefinedFeature.md)
+• **CHROME\_122**: [`PredefinedFeature`](PredefinedFeature.md)
 
-Features available in Chrome 92, Edge 92 and Opera 78 or later.
+Features available in Chrome 122, Edge 122 and Opera 108 or later.
 
 **`Remarks`**
 
-This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `CHROME` or `CHROME_PREV` instead of `CHROME_92` for long term support.
+This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `CHROME` or `CHROME_PREV` instead of `CHROME_122` for long term support.
 
 **`See`**
 
@@ -449,7 +455,7 @@ This feature may be replaced or removed in the near future when current browser
 
 #### Inherited from
 
-[FeatureAll](FeatureAll.md).[CHROME_92](FeatureAll.md#chrome_92)
+[FeatureAll](FeatureAll.md).[CHROME_122](FeatureAll.md#chrome_122)
 
 ___
 
@@ -459,7 +465,7 @@ ___
 
 Features available in the previous to current versions of Chrome and Edge.
 
-An alias for `CHROME_92`.
+An alias for `CHROME_122`.
 
 #### Inherited from
 
@@ -767,7 +773,7 @@ A string representation of dynamically generated functions where the character a
 
 **`Remarks`**
 
-Available in Chrome, Edge, Firefox, Opera, and Node.js 10+.
+Available in Chrome, Edge, Firefox, Safari 17.4+, Opera, and Node.js 10+.
 
 #### Inherited from
 
@@ -783,7 +789,7 @@ A string representation of dynamically generated functions where the character a
 
 **`Remarks`**
 
-Available in Internet Explorer, Safari 9+, Android Browser, and Node.js before 10.
+Available in Internet Explorer, Safari 9+ before 17.4, Android Browser, and Node.js before 10.
 
 #### Inherited from
 
@@ -1255,7 +1261,7 @@ ___
 
 • **NO\_OLD\_SAFARI\_ARRAY\_ITERATOR**: [`ElementaryFeature`](ElementaryFeature.md)
 
-The property that the string representation of Array.prototype.entries\(\) evaluates to "\[object Array Iterator\]" and that Array.prototype.entries\(\).constructor is the global function Object.
+The property that the string representation of Array.prototype.entries\(\) evaluates to "\[object Array Iterator\]".
 
 **`Remarks`**
 
@@ -1285,11 +1291,27 @@ Available in Firefox, Internet Explorer, and Safari.
 
 ___
 
+### OBJECT\_ARRAY\_ENTRIES\_CTOR
+
+• **OBJECT\_ARRAY\_ENTRIES\_CTOR**: [`ElementaryFeature`](ElementaryFeature.md)
+
+The property that the Array.prototype.entries\(\).constructor is the Object constructor.
+
+**`Remarks`**
+
+Available in Firefox, Safari 9+, and Node.js 0.12+.
+
+#### Inherited from
+
+[FeatureAll](FeatureAll.md).[OBJECT_ARRAY_ENTRIES_CTOR](FeatureAll.md#object_array_entries_ctor)
+
+___
+
 ### OBJECT\_L\_LOCATION\_CTOR
 
 • **OBJECT\_L\_LOCATION\_CTOR**: [`ElementaryFeature`](ElementaryFeature.md)
 
-Existence of the global function location.constructor whose string representation starts with "\[object L"
+Existence of the global function location.constructor whose string representation starts with "\[object L".
 
 **`Remarks`**
 
@@ -1321,7 +1343,7 @@ ___
 
 • **OBJECT\_W\_CTOR**: [`ElementaryFeature`](ElementaryFeature.md)
 
-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 constructor starts with "\[object W".
 
 **`Remarks`**
 
@@ -1337,7 +1359,7 @@ ___
 
 • **OLD\_SAFARI\_LOCATION\_CTOR**: [`ElementaryFeature`](ElementaryFeature.md)
 
-Existence of the global object location.constructor whose string representation starts with "\[object " and ends with "LocationConstructor\]"
+Existence of the global object location.constructor whose string representation starts with "\[object " and ends with "LocationConstructor\]".
 
 **`Remarks`**
 
@@ -1353,7 +1375,7 @@ ___
 
 • **PLAIN\_INTL**: [`ElementaryFeature`](ElementaryFeature.md)
 
-Existence of the global object Intl having the string representation "\[object Object\]"
+Existence of the global object Intl having the string representation "\[object Object\]".
 
 **`Remarks`**
 
@@ -1387,7 +1409,7 @@ ___
 
 Features available in the current stable version of Safari.
 
-An alias for `SAFARI_15_4`.
+An alias for `SAFARI_17_4`.
 
 #### Inherited from
 
@@ -1459,7 +1481,7 @@ ___
 
 • **SAFARI\_15\_4**: [`PredefinedFeature`](PredefinedFeature.md)
 
-Features available in Safari 15.4 or later.
+Features available in Safari 15.4 to 17.3.
 
 #### Inherited from
 
@@ -1467,6 +1489,18 @@ Features available in Safari 15.4 or later.
 
 ___
 
+### SAFARI\_17\_4
+
+• **SAFARI\_17\_4**: [`PredefinedFeature`](PredefinedFeature.md)
+
+Features available in Safari 17.4 or later.
+
+#### Inherited from
+
+[FeatureAll](FeatureAll.md).[SAFARI_17_4](FeatureAll.md#safari_17_4)
+
+___
+
 ### SAFARI\_7\_0
 
 • **SAFARI\_7\_0**: [`PredefinedFeature`](PredefinedFeature.md)
@@ -1621,18 +1655,6 @@ Available in Chrome, Edge, Firefox, Internet Explorer, Safari, Opera, and Androi
 
 Determines whether the specified features are mutually compatible.
 
-**`Example`**
-
-```js
-// false: only one of "V8_SRC" or "IE_SRC" may be available.
-JScrewIt.Feature.areCompatible("V8_SRC", "IE_SRC")
-```
-
-```js
-// true
-JScrewIt.Feature.areCompatible(JScrewIt.Feature.DEFAULT, JScrewIt.Feature.FILL)
-```
-
 #### Parameters
 
 | Name | Type |
@@ -1646,6 +1668,18 @@ JScrewIt.Feature.areCompatible(JScrewIt.Feature.DEFAULT, JScrewIt.Feature.FILL)
 `true` if the specified features are mutually compatible; otherwise, `false`.
 If less than two features are specified, the return value is `true`.
 
+**`Example`**
+
+```js
+// false: only one of "V8_SRC" or "IE_SRC" may be available.
+JScrewIt.Feature.areCompatible("V8_SRC", "IE_SRC")
+```
+
+```js
+// true
+JScrewIt.Feature.areCompatible(JScrewIt.Feature.DEFAULT, JScrewIt.Feature.FILL)
+```
+
 ___
 
 ### areEqual
@@ -1657,6 +1691,19 @@ Determines whether all of the specified features are equivalent.
 Different features are considered equivalent if they include the same set of elementary
 features, regardless of any other difference.
 
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
+
+#### Returns
+
+`boolean`
+
+`true` if all of the specified features are equivalent; otherwise, `false`.
+If less than two arguments are specified, the return value is `true`.
+
 **`Example`**
 
 ```js
@@ -1669,6 +1716,14 @@ JScrewIt.Feature.areEqual(JScrewIt.Feature.CHROME, JScrewIt.Feature.FF)
 JScrewIt.Feature.areEqual("DEFAULT", [])
 ```
 
+___
+
+### commonOf
+
+▸ **commonOf**(`...features`): ``null`` \| [`CustomFeature`](CustomFeature.md)
+
+Creates a new feature object equivalent to the intersection of the specified features.
+
 #### Parameters
 
 | Name | Type |
@@ -1677,46 +1732,25 @@ JScrewIt.Feature.areEqual("DEFAULT", [])
 
 #### Returns
 
-`boolean`
-
-`true` if all of the specified features are equivalent; otherwise, `false`.
-If less than two arguments are specified, the return value is `true`.
-
-___
-
-### commonOf
-
-▸ **commonOf**(`...features`): ``null`` \| [`CustomFeature`](CustomFeature.md)
+``null`` \| [`CustomFeature`](CustomFeature.md)
 
-Creates a new feature object equivalent to the intersection of the specified features.
+A feature object, or `null` if no arguments are specified.
 
 **`Example`**
 
-This will create a new feature object equivalent to [`NAME`](FeatureConstructor.md#name).
+This will create a new feature object equivalent to [`NAME`](FeatureAll.md#name).
 
 ```js
 const newFeature = JScrewIt.Feature.commonOf(["ATOB", "NAME"], ["NAME", "SELF"]);
 ```
 
-This will create a new feature object equivalent to [`ANY_DOCUMENT`](FeatureConstructor.md#any_document).
-This is because both [`HTMLDOCUMENT`](FeatureConstructor.md#htmldocument) and [`DOCUMENT`](FeatureConstructor.md#document) imply [`ANY_DOCUMENT`](FeatureConstructor.md#any_document).
+This will create a new feature object equivalent to [FeatureConstructor.ANY_DOCUMENT | `ANY_DOCUMENT`](FeatureAll.md#any_document).
+This is because both [`HTMLDOCUMENT`](FeatureAll.md#htmldocument) and [`DOCUMENT`](FeatureConstructor.md#document) imply [FeatureConstructor.ANY_DOCUMENT | `ANY_DOCUMENT`](FeatureAll.md#any_document).
 
 ```js
 const newFeature = JScrewIt.Feature.commonOf("HTMLDOCUMENT", "DOCUMENT");
 ```
 
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `...features` | [`FeatureElementOrCompatibleArray`](../README.md#featureelementorcompatiblearray)[] |
-
-#### Returns
-
-``null`` \| [`CustomFeature`](CustomFeature.md)
-
-A feature object, or `null` if no arguments are specified.
-
 ___
 
 ### descriptionFor
@@ -1725,14 +1759,6 @@ ___
 
 Returns a short description of a predefined feature in plain English.
 
-**`Remarks`**
-
-Different names or aliases of the same feature may have different descriptions.
-
-**`Throws`**
-
-An error is thrown if the specified argument is not a name or alias of a predefined feature.
-
 #### Parameters
 
 | Name | Type | Description |
@@ -1742,3 +1768,11 @@ An error is thrown if the specified argument is not a name or alias of a predefi
 #### Returns
 
 `string`
+
+**`Remarks`**
+
+Different names or aliases of the same feature may have different descriptions.
+
+**`Throws`**
+
+An error is thrown if the specified argument is not a name or alias of a predefined feature.

package/api-doc/interfaces/PredefinedFeature.md

@@ -1,8 +1,31 @@
 # Interface: PredefinedFeature
 
+Objects of this type indicate which of the capabilities that JScrewIt can use to minimize the
+length of its output are available in a particular JavaScript engine.
+
+JScrewIt comes with a set of predefined feature objects exposed as property values of
+`JScrewIt.Feature` or [`JScrewIt.Feature.ALL`](FeatureConstructor.md#all), where the property
+name is the feature's name or alias.
+
+Besides these predefined features, it is possible to construct custom features from the union or
+intersection of other features.
+
+Among the predefined features, there are some special ones called *elementary* features.
+Elementary features either cannot be expressed as a union of any number of other features, or
+they are different from such a union in that they exclude some other feature not excluded by
+their elementary components.
+All other features, called *composite* features, can be constructed as a union of zero or more
+elementary features.
+Two of the predefined composite features are particularly important: [`DEFAULT`](FeatureConstructor.md#default) is the empty feature, indicating that no elementary
+feature is available at all; [`AUTO`](FeatureAll.md#auto) is the union of all
+elementary features available in the current environment.
+
+Not all features can be available at the same time: some features are necessarily incompatible,
+meaning that they mutually exclude each other, and thus their union cannot be constructed.
+
 ## Hierarchy
 
-- [`Feature`](../README.md#feature)
+- [`Feature`](Feature.md)
 
   ↳ **`PredefinedFeature`**
 
@@ -33,7 +56,7 @@ implied features.
 
 #### Inherited from
 
-Feature.canonicalNames
+[Feature](Feature.md).[canonicalNames](Feature.md#canonicalnames)
 
 ___
 
@@ -45,7 +68,7 @@ A boolean value indicating whether this is an elementary feature object.
 
 #### Inherited from
 
-Feature.elementary
+[Feature](Feature.md).[elementary](Feature.md#elementary)
 
 ___
 
@@ -57,7 +80,7 @@ An array of all elementary feature names included in this feature object, withou
 
 #### Inherited from
 
-Feature.elementaryNames
+[Feature](Feature.md).[elementaryNames](Feature.md#elementarynames)
 
 ___
 
@@ -65,9 +88,14 @@ ___
 
 • `Readonly` **name**: [`PredefinedFeatureName`](../README.md#predefinedfeaturename)
 
+The primary name of this feature object, useful for identification purpose.
+
+All predefined features have a name; custom features may be optionally assigned a name, too.
+If a name is assigned, it will be used when the feature is converted into a string.
+
 #### Overrides
 
-Feature.name
+[Feature](Feature.md).[name](Feature.md#name)
 
 ## Methods
 
@@ -92,7 +120,7 @@ If no arguments are specified, the return value is `true`.
 
 #### Inherited from
 
-Feature.includes
+[Feature](Feature.md).[includes](Feature.md#includes)
 
 ___
 
@@ -119,4 +147,4 @@ that require strict mode code, or inside web workers.
 
 #### Inherited from
 
-Feature.restrict
+[Feature](Feature.md).[restrict](Feature.md#restrict)

package/api-doc/interfaces/default.md

@@ -17,4 +17,4 @@ ___
 
 ### encode
 
-• **encode**: [`encode`](../README.md#encode)
+• **encode**: [`encode`](encode.md)

package/api-doc/interfaces/encode.md

@@ -8,16 +8,6 @@
 
 Encodes a given string into JSFuck.
 
-**`Throws`**
-
-An `Error` is thrown under the following circumstances.
- - The specified string cannot be encoded with the specified options.
- - Some unknown features were specified.
- - A combination of mutually incompatible features was specified.
- - The option `runAs` (or `wrapWith`) was specified with an invalid value.
-
-Also, an out of memory condition may occur when processing very large data.
-
 #### Parameters
 
 | Name | Type | Description |
@@ -31,6 +21,16 @@ Also, an out of memory condition may occur when processing very large data.
 
 The encoded string.
 
+**`Throws`**
+
+An `Error` is thrown under the following circumstances.
+ - The specified string cannot be encoded with the specified options.
+ - Some unknown features were specified.
+ - A combination of mutually incompatible features was specified.
+ - The option `runAs` (or `wrapWith`) was specified with an invalid value.
+
+Also, an out of memory condition may occur when processing very large data.
+
 ## Table of contents
 
 ### Properties