jscrewit 2.32.0 → 2.33.0

package/lib/jscrewit.js

@@ -1,4 +1,4 @@
-// JScrewIt 2.32.0 – https://jscrew.it
+// JScrewIt 2.33.0 – https://jscrew.it
 
 (function () {
     'use strict';
@@ -394,10 +394,12 @@
             _Object_defineProperty(target, name_1, descriptor);
         }
     }
-    function createFeatureClass(featureInfos) {
+    function createFeatureClass(featureInfos, formatEngineDescription) {
         var ALL = createMap();
         var DESCRIPTION_MAP = createMap();
         var ELEMENTARY = [];
+        var ENGINE = [];
+        var FAMILIES = createMap();
         var FEATURE_PROTOTYPE = Feature.prototype;
         var INCOMPATIBLE_MASK_LIST = [];
         var PRISTINE_ELEMENTARY;
@@ -487,14 +489,9 @@
                 featureObj = null;
             return featureObj;
         }
-        function createFeature(name, mask, check, engine, attributes, elementary) {
+        function createFeature(name, mask, check, attributes, elementary) {
             _Object_freeze(attributes);
-            var descriptors = {
-                attributes: { value: attributes },
-                check: { value: check },
-                engine: { value: engine },
-                name: { value: name },
-            };
+            var descriptors = { attributes: { value: attributes }, check: { value: check }, name: { value: name } };
             if (elementary)
                 descriptors.elementary = { value: true };
             var featureObj = _Object_create(FEATURE_PROTOTYPE, descriptors);
@@ -546,14 +543,9 @@
             if (this.check)
                 parts.push('(check)');
             {
-                var container = {};
-                var _c = this, attributes = _c.attributes, engine = _c.engine;
-                if (engine !== undefined)
-                    container.engine = engine;
-                if (attributes !== undefined)
-                    container.attributes = __assign({}, attributes);
-                if (_Object_keys(container).length) {
-                    var str_1 = utilInspect(container, opts);
+                var attributes = this.attributes;
+                if (typeof attributes === 'object') {
+                    var str_1 = utilInspect(__assign({}, attributes), opts);
                     parts.push(str_1);
                 }
             }
@@ -652,6 +644,9 @@
             assignNoEnum(FEATURE_PROTOTYPE, protoSource);
         }
         (function () {
+            var compareFeatureNames = function (feature1, feature2) {
+                return feature1.name < feature2.name ? -1 : 1;
+            };
             function completeExclusions() {
                 var incompatibleMaskSet = new MaskSet();
                 for (var _i = 0, featureNames_1 = featureNames; _i < featureNames_1.length; _i++) {
@@ -695,6 +690,7 @@
                         if (inherits != null)
                             completeFeature(inherits);
                         var wrappedCheck = void 0;
+                        var compatibilities = void 0;
                         var check = info_1.check;
                         if (check !== undefined) {
                             mask = maskNext(unionMask);
@@ -736,7 +732,37 @@
                                 mask = maskUnion(mask, includeMask);
                             }
                         }
-                        var engine = getInfoStringField('engine');
+                        if ('versions' in info_1) {
+                            var families = info_1.families;
+                            var versions_1 = info_1.versions;
+                            if (inherits != null)
+                                families !== null && families !== void 0 ? families : (families = familiesMap[inherits]);
+                            familiesMap[name] = families;
+                            var tag_1 = getInfoStringField('compatibilityTag');
+                            var shortTag_1 = getInfoStringField('compatibilityShortTag');
+                            compatibilities =
+                                families.map(function (family, index) {
+                                    var _a;
+                                    family = esToString(family);
+                                    var versionInfo = versions_1[index];
+                                    var version;
+                                    if (_Array_isArray(versionInfo)) {
+                                        var length_1 = versionInfo.length;
+                                        var from = esToString(versionInfo[0]);
+                                        var to = length_1 < 2 ? undefined : esToString(versionInfo[length_1 - 1]);
+                                        var dense = versionInfo.length === 2;
+                                        version = _Object_freeze({ from: from, to: to, dense: dense });
+                                    }
+                                    else
+                                        version = esToString(versionInfo);
+                                    var compatibility = _Object_freeze({ family: family, featureName: name, version: version, tag: tag_1, shortTag: shortTag_1 });
+                                    var familyCompatibilities = (_a = FAMILIES[family]) !== null && _a !== void 0 ? _a : (FAMILIES[family] = []);
+                                    familyCompatibilities.push(compatibility);
+                                    return compatibility;
+                                });
+                            if (description == null)
+                                description = formatEngineDescription === null || formatEngineDescription === void 0 ? void 0 : formatEngineDescription(compatibilities);
+                        }
                         var attributes = createMap();
                         if (inherits != null) {
                             var inheritedAttributes = ALL[inherits].attributes;
@@ -760,10 +786,11 @@
                             }
                         }
                         var elementary = wrappedCheck !== null && wrappedCheck !== void 0 ? wrappedCheck : info_1.excludes;
-                        featureObj =
-                            createFeature(name, mask, wrappedCheck, engine, attributes, elementary);
+                        featureObj = createFeature(name, mask, wrappedCheck, attributes, elementary);
                         if (elementary)
                             ELEMENTARY.push(featureObj);
+                        if (compatibilities)
+                            ENGINE.push(featureObj);
                     }
                     ALL[name] = featureObj;
                     DESCRIPTION_MAP[name] = description;
@@ -774,6 +801,8 @@
                 var constructorSource = {
                     ALL: ALL,
                     ELEMENTARY: ELEMENTARY,
+                    ENGINE: ENGINE,
+                    FAMILIES: FAMILIES,
                     _fromMask: _fromMask,
                     _getMask: _getMask,
                     areCompatible: areCompatible,
@@ -791,13 +820,19 @@
             }
             var featureNames = _Object_keys(featureInfos);
             var includeSetMap = createMap();
+            var familiesMap = createMap();
             var unionMask = maskNew();
             featureNames.forEach(completeFeature);
             completeExclusions();
             PRISTINE_ELEMENTARY = ELEMENTARY.slice();
-            ELEMENTARY.sort(function (feature1, feature2) { return feature1.name < feature2.name ? -1 : 1; });
+            ELEMENTARY.sort(compareFeatureNames);
             _Object_freeze(ELEMENTARY);
+            ENGINE.sort(compareFeatureNames);
+            _Object_freeze(ENGINE);
             _Object_freeze(ALL);
+            _Object_freeze(FAMILIES);
+            for (var family in FAMILIES)
+                _Object_freeze(FAMILIES[family]);
         })();
         return Feature;
     }
@@ -875,6 +910,12 @@
         return available;
     }
 
+    function describeEngine(engine)
+    {
+        var description = 'Features available in ' + engine + '.';
+        return description;
+    }
+
     function isExcludingAttribute(restrictionCache, restrictionName, featureObjs)
     {
         var returnValue = restrictionCache[restrictionName];
@@ -1710,7 +1751,8 @@
         },
         ANDRO_4_0:
         {
-            engine: 'Android Browser 4.0',
+            families: ['Android Browser'],
+            versions: ['4.0'],
             includes:
             [
                 'ATOB',
@@ -1730,14 +1772,14 @@
         },
         ANDRO_4_1:
         {
-            engine: 'Android Browser 4.1 to 4.3',
             inherits: 'ANDRO_4_0',
+            versions: [['4.1',, '4.3']],
             includes: { GENERIC_ARRAY_TO_STRING: true, OBJECT_UNDEFINED: true },
         },
         ANDRO_4_4:
         {
-            engine: 'Android Browser 4.4',
             inherits: 'ANDRO_4_1',
+            versions: ['4.4'],
             includes:
             {
                 BARPROP:                true,
@@ -1753,17 +1795,18 @@
         },
         CHROME_PREV:
         {
-            engine: 'the previous to current versions of Chrome and Edge',
+            description: describeEngine('the previous to current versions of Chrome and Edge'),
             aliasFor: 'CHROME_92',
         },
         CHROME:
         {
-            engine: 'the current stable versions of Chrome, Edge and Opera',
+            description: describeEngine('the current stable versions of Chrome, Edge and Opera'),
             aliasFor: 'CHROME_92',
         },
         CHROME_92:
         {
-            engine: 'Chrome 92, Edge 92 and Opera 78 or later',
+            families: ['Chrome', 'Edge', 'Opera'],
+            versions: [['92'], ['92'], ['78']],
             includes:
             [
                 'ARROW',
@@ -1799,12 +1842,13 @@
         },
         FF_ESR:
         {
-            engine: 'the current version of Firefox ESR',
+            description: describeEngine('the current version of Firefox ESR'),
             aliasFor: 'FF_78',
         },
         FF_78:
         {
-            engine: 'Firefox 78 to 82',
+            families: ['Firefox'],
+            versions: [['78',, '82']],
             includes:
             [
                 'ARROW',
@@ -1838,31 +1882,32 @@
             attributes:
             { 'char-increment-restriction': null, 'unstable': null, 'web-worker-restriction': null },
         },
-        FF_PREV:
-        {
-            engine: 'the previous to current version of Firefox',
-            aliasFor: 'FF_83',
-        },
         FF_83:
         {
-            engine: 'Firefox 83 to 89',
             inherits: 'FF_78',
+            versions: [['83',, '89']],
             includes: { INTL: true, PLAIN_INTL: false },
         },
+        FF_PREV:
+        {
+            description: describeEngine('the previous to current version of Firefox'),
+            aliasFor: 'FF_90',
+        },
         FF:
         {
-            engine: 'the current stable version of Firefox',
+            description: describeEngine('the current stable version of Firefox'),
             aliasFor: 'FF_90',
         },
         FF_90:
         {
-            engine: 'Firefox 90 or later',
             inherits: 'FF_83',
+            versions: [['90']],
             includes: { AT: true },
         },
         IE_9:
         {
-            engine: 'Internet Explorer 9',
+            families: ['Internet Explorer'],
+            versions: ['9'],
             includes:
             [
                 'CAPITAL_HTML',
@@ -1883,15 +1928,15 @@
         },
         IE_10:
         {
-            engine: 'Internet Explorer 10',
             inherits: 'IE_9',
+            versions: ['10'],
             includes: { ATOB: true, CONSOLE: true, OBJECT_UNDEFINED: true, UNDEFINED: false },
             attributes: { 'char-increment-restriction': null, 'web-worker-restriction': null },
         },
         IE_11:
         {
-            engine: 'Internet Explorer 11',
             inherits: 'IE_10',
+            versions: ['11'],
             includes:
             {
                 DOCUMENT:           false,
@@ -1904,13 +1949,16 @@
         },
         IE_11_WIN_10:
         {
-            engine: 'Internet Explorer 11 on Windows 10',
             inherits: 'IE_11',
+            versions: ['11'],
+            compatibilityTag: 'on Windows 10',
+            compatibilityShortTag: 'W10',
             includes: { LOCALE_INFINITY: true, LOCALE_NUMERALS: false, LOCALE_NUMERALS_EXT: true },
         },
         NODE_0_10:
         {
-            engine: 'Node.js 0.10',
+            families: ['Node.js'],
+            versions: ['0.10'],
             includes:
             [
                 'ESC_HTML_ALL',
@@ -1925,8 +1973,8 @@
         },
         NODE_0_12:
         {
-            engine: 'Node.js 0.12',
             inherits: 'NODE_0_10',
+            versions: ['0.12'],
             includes:
             {
                 ESC_HTML_ALL:                   false,
@@ -1938,61 +1986,62 @@
         },
         NODE_4:
         {
-            engine: 'Node.js 4',
             inherits: 'NODE_0_12',
+            versions: ['4'],
             includes: { ARROW: true, ESC_REGEXP_SLASH: true, FILL: true, FROM_CODE_POINT: true },
         },
         NODE_5:
         {
-            engine: 'Node.js 5 to 9',
             inherits: 'NODE_4',
+            versions: [['5',, '9']],
             attributes: { 'char-increment-restriction': null },
         },
         NODE_10:
         {
-            engine: 'Node.js 10',
             inherits: 'NODE_5',
+            versions: ['10'],
             includes: { FUNCTION_19_LF: true, FUNCTION_22_LF: false },
         },
         NODE_11:
         {
-            engine: 'Node.js 11',
             inherits: 'NODE_10',
+            versions: ['11'],
             includes: { FLAT: true },
         },
         NODE_12:
         {
-            engine: 'Node.js 12',
             inherits: 'NODE_11',
+            versions: ['12'],
             includes: { ESC_REGEXP_LF: true, REGEXP_STRING_ITERATOR: true },
         },
         NODE_13:
         {
-            engine: 'Node.js 13 and Node.js 14',
             inherits: 'NODE_12',
+            versions: [['13', '14']],
             includes: { LOCALE_NUMERALS_EXT: true, SHORT_LOCALES: true },
         },
         NODE_15:
         {
-            engine: 'Node.js 15',
             inherits: 'NODE_13',
+            versions: ['15'],
             includes: { INTL: true, PLAIN_INTL: false },
         },
         NODE_16_0:
         {
-            engine: 'Node.js 16.0 to 16.5',
             inherits: 'NODE_15',
+            versions: [['16.0',, '16.5']],
             includes: { ATOB: true },
         },
         NODE_16_6:
         {
-            engine: 'Node.js 16.6 or later',
             inherits: 'NODE_16_0',
+            versions: [['16.6']],
             includes: { AT: true },
         },
         SAFARI_7_0:
         {
-            engine: 'Safari 7.0',
+            families: ['Safari'],
+            versions: ['7.0'],
             includes:
             [
                 'ATOB',
@@ -2027,16 +2076,15 @@
         },
         SAFARI_7_1:
         {
-            engine: 'Safari 7.1 and Safari 8',
             inherits: 'SAFARI_7_0',
+            versions: [['7.1', '8']],
             includes: { ARRAY_ITERATOR: true, FILL: true },
             attributes: { 'no-console-in-web-worker': undefined, 'safari-bug-21820506': null },
         },
-        SAFARI_8: { aliasFor: 'SAFARI_7_1' },
         SAFARI_9:
         {
-            engine: 'Safari 9',
             inherits: 'SAFARI_7_1',
+            versions: ['9'],
             includes:
             {
                 ARRAY_ITERATOR:                 false,
@@ -2047,8 +2095,8 @@
         },
         SAFARI_10:
         {
-            engine: 'Safari 10 and Safari 11',
             inherits: 'SAFARI_9',
+            versions: [['10', '11']],
             includes:
             {
                 ARROW:                      true,
@@ -2065,36 +2113,70 @@
         },
         SAFARI_12:
         {
-            engine: 'Safari 12',
             inherits: 'SAFARI_10',
+            versions: ['12'],
             includes: { FLAT: true },
         },
         SAFARI_13:
         {
-            engine: 'Safari 13 and Safari 14.0.0',
             inherits: 'SAFARI_12',
+            versions: [['13', '14.0.0']],
             includes: { REGEXP_STRING_ITERATOR: true },
         },
         SAFARI_14_0_1:
         {
-            engine: 'Safari 14.0.1 to 14.0.3',
             inherits: 'SAFARI_13',
+            versions: [['14.0.1',, '14.0.3']],
             includes: { INTL: true, PLAIN_INTL: false },
         },
         SAFARI:
         {
-            engine: 'the current stable version of Safari',
+            description: describeEngine('the current stable version of Safari'),
             aliasFor: 'SAFARI_14_1',
         },
         SAFARI_14_1:
         {
-            engine: 'Safari 14.1 or later',
             inherits: 'SAFARI_14_0_1',
+            versions: [['14.1']],
             includes: { CONSOLE: false },
         },
     };
     (function ()
     {
+        function formatEngineDescription(compatibilities)
+        {
+            var appendix = '';
+            var parts =
+            compatibilities.map
+            (
+                function (compatibility)
+                {
+                    var family = compatibility.family;
+                    var version = compatibility.version;
+                    var part = family;
+                    if (typeof version === 'string')
+                        part += ' ' + version;
+                    else
+                    {
+                        part += ' ' + version.from;
+                        var to = version.to;
+                        if (to != null)
+                            part += (version.dense ? ' and ' + family + ' ' : ' to ') + to;
+                        else
+                            appendix = ' or later';
+                    }
+                    var tag = compatibility.tag;
+                    if (tag != null)
+                        part += ' ' + tag;
+                    return part;
+                }
+            );
+            var lastPart = parts.pop();
+            var engine = (parts.length ? parts.join(', ') + ' and ' + lastPart : lastPart) + appendix;
+            var description = describeEngine(engine);
+            return description;
+        }
+
         var autoIncludes =
         _Object_keys$1(featureInfos).filter
         (
@@ -2108,23 +2190,10 @@
         );
         featureInfos.AUTO =
         {
-            engine: 'the current environment',
+            description: describeEngine('the current environment'),
             includes: autoIncludes,
         };
-        _Object_keys$1(featureInfos).forEach
-        (
-            function (featureName)
-            {
-                var featureInfo = featureInfos[featureName];
-                var engine = featureInfo.engine;
-                if (engine != null)
-                {
-                    var description = 'Features available in ' + engine + '.';
-                    featureInfo.description = description;
-                }
-            }
-        );
-        Feature = createFeatureClass(featureInfos);
+        Feature = createFeatureClass(featureInfos, formatEngineDescription);
         ELEMENTARY = Feature.ELEMENTARY;
         featureInfos = null;
         assignNoEnum$1(Feature.prototype, { restrict: restrict });