jscrewit 2.33.1 → 2.35.0

package/api-doc/interfaces/PredefinedFeature.md

@@ -73,7 +73,7 @@ Feature.name
 
 ### includes
 
-▸ **includes**(...`features`): `boolean`
+▸ **includes**(`...features`): `boolean`
 
 Determines whether this feature object includes all of the specified features.
 
@@ -110,7 +110,7 @@ that require strict mode code, or inside web workers.
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `environment` | ``"forced-strict-mode"`` \| ``"web-worker"`` | The environment to which this feature should be restricted. Two environments are currently supported.  <dl>  <dt><code>"forced-strict-mode"</code></dt> <dd> Removes features that are not available in environments that require strict mode code. </dd>  <dt><code>"web-worker"</code></dt> <dd>Removes features that are not available inside web workers.</dd>  </dl> |
+| `environment` | ``"forced-strict-mode"`` \| ``"web-worker"`` | The environment to which this feature should be restricted. Two environments are currently supported. <dl> <dt><code>"forced-strict-mode"</code></dt> <dd> Removes features that are not available in environments that require strict mode code. </dd> <dt><code>"web-worker"</code></dt> <dd>Removes features that are not available inside web workers.</dd> </dl> |
 | `engineFeatureObjs?` | readonly [`PredefinedFeature`](PredefinedFeature.md)[] | An array of predefined feature objects, each corresponding to a particular engine in which the restriction should be enacted. If this parameter is omitted, the restriction is enacted in all engines. |
 
 #### Returns

package/api-doc/interfaces/default.md

@@ -1,7 +1,5 @@
 # Interface: default
 
-JScrewIt object, available in Node.js.
-
 ## Table of contents
 
 ### Properties

package/api-doc/interfaces/encode.md

@@ -8,7 +8,7 @@
 
 Encodes a given string into JSFuck.
 
-**`throws`**
+**`Throws`**
 
 An `Error` is thrown under the following circumstances.
  - The specified string cannot be encoded with the specified options.

package/lib/encode.d.ts

@@ -1,15 +1,16 @@
-import { FeatureElementOrCompatibleArray } from './feature';
+import type { FeatureElementOrCompatibleArray } from './feature';
 
 export interface EncodeOptions
 {
     /**
      * Specifies the features available in the engines that evaluate the encoded output.
      *
-     * If this parameter is unspecified, [[DEFAULT|`JScrewIt.Feature.DEFAULT`]] is assumed: this
-     * ensures maximum compatibility but also generates the largest code.
+     * If this parameter is unspecified, {@link FeatureConstructor.DEFAULT |
+     * `JScrewIt.Feature.DEFAULT`} is assumed: this ensures maximum compatibility but also generates
+     * the largest code.
      * To generate shorter code, specify all features available in all target engines explicitly.
      */
-    features?: FeatureElementOrCompatibleArray;
+    features?: FeatureElementOrCompatibleArray | undefined;
 
     /**
      * This option controls the type of code generated from the given input.
@@ -59,7 +60,7 @@ export interface EncodeOptions
      *
      * </dl>
      */
-    runAs?: 'call' | 'eval' | 'express' | 'express-call' | 'express-eval' | 'none';
+    runAs?: RunAs | undefined;
 
     /**
      * If this parameter is truthy, lines in the beginning and in the end of the file containing
@@ -72,12 +73,18 @@ export interface EncodeOptions
      * Using this option may produce unexpected results if the input is not well-formed JavaScript
      * code.
      */
-    trimCode?: boolean;
+    trimCode?: boolean | undefined;
 
     /** An alias for `runAs`. */
-    wrapWith?: 'call' | 'eval' | 'express' | 'express-call' | 'express-eval' | 'none';
+    wrapWith?: RunAs | undefined;
 }
 
+/**
+ * Values of this type control the type of code generated from a given input.
+ * See {@link EncodeOptions.runAs | `EncodeOptions.runAs`} for the meaning of each possible value.
+ */
+type RunAs = 'call' | 'eval' | 'express' | 'express-call' | 'express-eval' | 'none';
+
 interface encode
 {
     /**

package/lib/feature-all.d.ts

@@ -52,7 +52,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Chrome, Edge, Firefox 90+, Opera, and Node.js 16.6+.
+     * Available in Chrome, Edge, Firefox, Safari 15.4+, Opera, and Node.js 16.6+.
      */
     AT: ElementaryFeature;
 
@@ -211,38 +211,12 @@ export interface FeatureAll
      */
     FF: PredefinedFeature;
 
-    /**
-     * Features available in Firefox 78 to 82.
-     *
-     * @remarks
-     *
-     * This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `FF_ESR` instead of `FF_78` for long term support.
-     *
-     * @see
-     *
-     * [Engine Support Policy](https://github.com/fasttime/JScrewIt#engine-support-policy)
-     */
-    FF_78: PredefinedFeature;
-
-    /**
-     * Features available in Firefox 83 to 89.
-     *
-     * @remarks
-     *
-     * This feature may be replaced or removed in the near future when current browser versions become obsolete.
-     *
-     * @see
-     *
-     * [Engine Support Policy](https://github.com/fasttime/JScrewIt#engine-support-policy)
-     */
-    FF_83: PredefinedFeature;
-
     /**
      * Features available in Firefox 90 or later.
      *
      * @remarks
      *
-     * This feature may be replaced or removed in the near future when current browser versions become obsolete. Use `FF` 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`, `FF_ESR`, or `FF_PREV` instead of `FF_90` for long term support.
      *
      * @see
      *
@@ -253,7 +227,7 @@ export interface FeatureAll
     /**
      * Features available in the current version of Firefox ESR.
      *
-     * An alias for `FF_78`.
+     * An alias for `FF_90`.
      */
     FF_ESR: PredefinedFeature;
 
@@ -587,7 +561,7 @@ export interface FeatureAll
      *
      * @remarks
      *
-     * Available in Firefox before 83, 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+ before 14.0.1, Android Browser 4.4, and Node.js 0.12+ before 15.
      */
     PLAIN_INTL: ElementaryFeature;
 
@@ -603,7 +577,7 @@ export interface FeatureAll
     /**
      * Features available in the current stable version of Safari.
      *
-     * An alias for `SAFARI_14_1`.
+     * An alias for `SAFARI_15_4`.
      */
     SAFARI: PredefinedFeature;
 
@@ -619,9 +593,12 @@ export interface FeatureAll
     /** Features available in Safari 14.0.1 to 14.0.3. */
     SAFARI_14_0_1: PredefinedFeature;
 
-    /** Features available in Safari 14.1 or later. */
+    /** Features available in Safari 14.1 to 15.3. */
     SAFARI_14_1: PredefinedFeature;
 
+    /** Features available in Safari 15.4 or later. */
+    SAFARI_15_4: PredefinedFeature;
+
     /** Features available in Safari 7.0. */
     SAFARI_7_0: PredefinedFeature;
 
@@ -761,8 +738,6 @@ ElementaryFeatureName
 | 'CHROME_92'
 | 'COMPACT'
 | 'DEFAULT'
-| 'FF_78'
-| 'FF_83'
 | 'FF_90'
 | 'IE_10'
 | 'IE_11'
@@ -784,6 +759,7 @@ ElementaryFeatureName
 | 'SAFARI_13'
 | 'SAFARI_14_0_1'
 | 'SAFARI_14_1'
+| 'SAFARI_15_4'
 | 'SAFARI_7_0'
 | 'SAFARI_7_1'
 | 'SAFARI_9'

package/lib/feature.d.ts

@@ -1,4 +1,4 @@
-import { ElementaryFeatureName, FeatureAll, PredefinedFeatureName } from './feature-all';
+import type { ElementaryFeatureName, FeatureAll, PredefinedFeatureName } from './feature-all';
 
 export interface CustomFeature extends Feature
 {
@@ -16,8 +16,8 @@ export interface ElementaryFeature extends PredefinedFeature
  * 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 [[ALL|`JScrewIt.Feature.ALL`]], where the property name is the feature's
- * name or alias.
+ * `JScrewIt.Feature` or {@link FeatureConstructor.ALL | `JScrewIt.Feature.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.
@@ -28,10 +28,10 @@ export interface ElementaryFeature extends PredefinedFeature
  * 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: <code>[[DEFAULT]]</code> is
- * the empty feature, indicating that no elementary feature is available at all;
- * <code>[[AUTO]]</code> is the union of all elementary features available in the current
- * environment.
+ * Two of the predefined composite features are particularly important: {@link
+ * FeatureConstructor.DEFAULT | `DEFAULT`} is the empty feature, indicating that no elementary
+ * feature is available at all; {@link FeatureConstructor.AUTO | `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.
@@ -119,12 +119,13 @@ export interface FeatureConstructor extends FeatureAll
      * 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
-     * <code>[[DEFAULT]]</code>.
+     * {@link FeatureConstructor.DEFAULT | `DEFAULT`}.
      *
      * @example
      *
      * The following statements are equivalent, and will all construct a new feature object
-     * including both <code>[[ANY_DOCUMENT]]</code> and <code>[[ANY_WINDOW]]</code>.
+     * including both {@link FeatureConstructor.ANY_DOCUMENT | `ANY_DOCUMENT`} and {@link
+     * FeatureConstructor.ANY_WINDOW | `ANY_WINDOW`}.
      *
      * ```js
      * new JScrewIt.Feature("ANY_DOCUMENT", "ANY_WINDOW");
@@ -172,12 +173,13 @@ export interface FeatureConstructor extends FeatureAll
      * 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
-     * <code>[[DEFAULT]]</code>.
+     * {@link FeatureConstructor.DEFAULT | `DEFAULT`}.
      *
      * @example
      *
      * The following statements are equivalent, and will all construct a new feature object
-     * including both <code>[[ANY_DOCUMENT]]</code> and <code>[[ANY_WINDOW]]</code>.
+     * including both {@link FeatureConstructor.ANY_DOCUMENT | `ANY_DOCUMENT`} and {@link
+     * FeatureConstructor.ANY_WINDOW | `ANY_WINDOW`}.
      *
      * ```js
      * JScrewIt.Feature("ANY_DOCUMENT", "ANY_WINDOW");
@@ -253,15 +255,17 @@ export interface FeatureConstructor extends FeatureAll
      *
      * @example
      *
-     * This will create a new feature object equivalent to <code>[[NAME]]</code>.
+     * This will create a new feature object equivalent to {@link FeatureConstructor.NAME | `NAME`}.
      *
      * ```js
      * const newFeature = JScrewIt.Feature.commonOf(["ATOB", "NAME"], ["NAME", "SELF"]);
      * ```
      *
-     * This will create a new feature object equivalent to <code>[[ANY_DOCUMENT]]</code>.
-     * This is because both <code>[[HTMLDOCUMENT]]</code> and <code>[[DOCUMENT]]</code> imply
-     * <code>[[ANY_DOCUMENT]]</code>.
+     * 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`}.
      *
      * ```js
      * const newFeature = JScrewIt.Feature.commonOf("HTMLDOCUMENT", "DOCUMENT");

package/lib/jscrewit.d.ts

@@ -1,7 +1,7 @@
 // Type definitions for JScrewIt
 
-import { encode }   from './encode';
-import { Feature }  from './feature';
+import type { encode }  from './encode';
+import type { Feature } from './feature';
 
 export * from './encode';
 export * from './feature';