util-helpers 4.19.4 → 4.20.0

package/esm/VERSION.js

@@ -1,4 +1,4 @@
-var VERSION = "4.19.4";
+var VERSION = "4.20.0";
 var VERSION$1 = VERSION;
 
 export { VERSION$1 as default };

package/esm/compressImage.js

@@ -0,0 +1,60 @@
+import { toNumber } from 'ut2';
+import loadImageWithBlob from './loadImageWithBlob.js';
+
+function canvasToBlob(canvas, type, quality) {
+    return new Promise(function (resolve) {
+        canvas.toBlob(function (blob) {
+            resolve(blob);
+        }, type, quality);
+    });
+}
+function compressImage(img, options) {
+    if (options === void 0) { options = {}; }
+    return new Promise(function (resolve, reject) {
+        var width = options.width, height = options.height, rotate = options.rotate, _a = options.offset, offset = _a === void 0 ? [0, 0] : _a, _b = options.cacheImage, cacheImage = _b === void 0 ? true : _b, _c = options.background, background = _c === void 0 ? '#fff' : _c, canvasWidth = options.canvasWidth, canvasHeight = options.canvasHeight, _d = options.format, format = _d === void 0 ? 'blob' : _d, _e = options.type, type = _e === void 0 ? 'image/jpeg' : _e, _f = options.quality, quality = _f === void 0 ? 0.8 : _f, beforeCompress = options.beforeCompress, beforeDraw = options.beforeDraw, afterDraw = options.afterDraw;
+        loadImageWithBlob(img, cacheImage)
+            .then(function (_a) {
+            var image = _a.image, blob = _a.blob;
+            var numWidth = toNumber(width);
+            var numHeight = toNumber(height);
+            var numQuality = toNumber(quality);
+            if (numWidth) {
+                image.width = numWidth;
+            }
+            if (numHeight) {
+                image.height = numHeight;
+            }
+            beforeCompress === null || beforeCompress === void 0 ? void 0 : beforeCompress({ image: image, blob: blob }, options);
+            var canvas = document.createElement('canvas');
+            var ctx = canvas.getContext('2d');
+            var info = { image: image, blob: blob, canvas: canvas, context: ctx };
+            var numCanvasWidth = toNumber(typeof canvasWidth === 'function' ? canvasWidth(info, options) : canvasWidth);
+            var numCanvasHeight = toNumber(typeof canvasHeight === 'function' ? canvasHeight(info, options) : canvasHeight);
+            canvas.width = numCanvasWidth || image.width;
+            canvas.height = numCanvasHeight || image.height;
+            if (background && background !== 'none') {
+                ctx.fillStyle = background;
+                ctx.fillRect(0, 0, canvas.width, canvas.height);
+            }
+            var internalOffset = [0, 0];
+            if (rotate !== undefined) {
+                ctx.translate(image.width / 2, image.height / 2);
+                internalOffset = [-image.width / 2, -image.height / 2];
+                ctx.rotate((rotate * Math.PI) / 180);
+            }
+            var outOffset = typeof offset === 'function' ? offset(info, options) : offset;
+            beforeDraw === null || beforeDraw === void 0 ? void 0 : beforeDraw(info, options);
+            ctx.drawImage(image, internalOffset[0] + toNumber(outOffset[0]), internalOffset[1] + toNumber(outOffset[1]), image.width, image.height);
+            afterDraw === null || afterDraw === void 0 ? void 0 : afterDraw(info, options);
+            if (format === 'blob') {
+                canvasToBlob(canvas, type, numQuality).then(resolve).catch(reject);
+            }
+            else {
+                resolve(canvas.toDataURL(type, numQuality));
+            }
+        })
+            .catch(reject);
+    });
+}
+
+export { compressImage as default };

package/esm/gcd.js

@@ -0,0 +1,42 @@
+import { round, isNaN, toNumber } from 'ut2';
+
+function gcd() {
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var num1 = nums[0];
+    var num2 = nums[1] === void 0 ? 0 : nums[1];
+    var rest = nums.slice(2);
+    if (rest.length > 0) {
+        return gcd.apply(void 0, [gcd(num1, num2)].concat(rest));
+    }
+    num1 = Math.abs(round(num1));
+    num2 = Math.abs(round(num2));
+    if (isNaN(num1) || isNaN(num2)) {
+        return Number.NaN;
+    }
+    if (num1 === 0 && num2 === 0) {
+        return 0;
+    }
+    if (num1 === 0) {
+        return num2;
+    }
+    if (num2 === 0) {
+        return num1;
+    }
+    var temp = num2;
+    if (num1 < num2) {
+        temp = num1;
+        num1 = num2;
+        num2 = temp;
+    }
+    while (temp) {
+        temp = num1 % num2;
+        num1 = num2;
+        num2 = temp;
+    }
+    return toNumber(num1);
+}
+
+export { gcd as default };

package/esm/getImageInfo.js

@@ -0,0 +1,45 @@
+import { round } from 'ut2';
+import divide from './divide.js';
+import gcd from './gcd.js';
+import loadImageWithBlob from './loadImageWithBlob.js';
+import bytesToSize from './bytesToSize.js';
+
+function calcContrast(w, h) {
+    var n = gcd(w, h);
+    return "".concat(divide(round(w), n), ":").concat(divide(round(h), n));
+}
+var cacheImage;
+var cacheResult;
+function getImageInfo(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            loadImageWithBlob(img, false)
+                .then(function (_a) {
+                var image = _a.image, blob = _a.blob;
+                var width = image.width, height = image.height;
+                var result = {
+                    width: width,
+                    height: height,
+                    contrast: calcContrast(width, height),
+                    measure: "".concat(width, " \u00D7 ").concat(height, " px"),
+                    size: bytesToSize(blob.size),
+                    bytes: blob.size,
+                    image: image,
+                    blob: blob
+                };
+                if (useCache) {
+                    cacheImage = img;
+                    cacheResult = result;
+                }
+                resolve(result);
+            })
+                .catch(reject);
+        }
+    });
+}
+
+export { getImageInfo as default };

package/esm/index.js

@@ -40,9 +40,15 @@ export { default as minus } from './minus.js';
 export { default as times } from './times.js';
 export { default as divide } from './divide.js';
 export { default as round } from './round.js';
+export { default as gcd } from './gcd.js';
+export { default as lcm } from './lcm.js';
 export { default as ajax } from './ajax.js';
 export { default as calculateCursorPosition } from './calculateCursorPosition.js';
+export { default as compressImage } from './compressImage.js';
 export { default as download } from './download.js';
+export { default as getImageInfo } from './getImageInfo.js';
+export { default as loadImage } from './loadImage.js';
+export { default as loadImageWithBlob } from './loadImageWithBlob.js';
 export { default as loadScript } from './loadScript.js';
 export { default as randomString } from './randomString.js';
 export { default as strlen } from './strlen.js';
@@ -57,6 +63,6 @@ export { default as findTreeSelect } from './findTreeSelect.js';
 export { setDisableWarning } from './utils/config.js';
 export { default as VERSION } from './VERSION.js';
 
-var version = "4.19.4";
+var version = "4.20.0";
 
 export { version };

package/esm/lcm.js

@@ -0,0 +1,20 @@
+import { __spreadArray, __read } from 'tslib';
+import divide from './divide.js';
+import times from './times.js';
+import gcd from './gcd.js';
+import { round } from 'ut2';
+
+function lcm() {
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var args = nums.map(function (item) { return Math.abs(round(item)); });
+    if (args.length === 1) {
+        args = args.concat([1]);
+    }
+    var product = args.indexOf(0) > -1 ? 0 : times.apply(void 0, __spreadArray([], __read(args), false));
+    return divide(product, gcd.apply(void 0, __spreadArray([], __read(args), false)));
+}
+
+export { lcm as default };

package/esm/loadImage.js

@@ -0,0 +1,40 @@
+import { isBlob } from 'ut2';
+
+var cacheImage;
+var cacheResult;
+function loadImage(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            var imgIsBlob_1 = isBlob(img);
+            var url_1 = imgIsBlob_1 ? URL.createObjectURL(img) : img;
+            var image_1 = new Image();
+            if (!imgIsBlob_1) {
+                image_1.crossOrigin = 'anonymous';
+            }
+            image_1.onload = function () {
+                if (imgIsBlob_1) {
+                    URL.revokeObjectURL(url_1);
+                }
+                if (useCache) {
+                    cacheImage = img;
+                    cacheResult = image_1;
+                }
+                resolve(image_1);
+            };
+            image_1.onerror = function (err) {
+                if (imgIsBlob_1) {
+                    URL.revokeObjectURL(url_1);
+                }
+                console.error("[loadImage] The image load failed, '".concat(img, "'."));
+                reject(err);
+            };
+            image_1.src = url_1;
+        }
+    });
+}
+
+export { loadImage as default };

package/esm/loadImageWithBlob.js

@@ -0,0 +1,59 @@
+import { isBlob } from 'ut2';
+import ajax from './ajax.js';
+
+var SuccessResponseStatus = [200, 304];
+function getBlob(img) {
+    return new Promise(function (resolve, reject) {
+        if (isBlob(img)) {
+            resolve(img);
+        }
+        else {
+            ajax(img, { responseType: 'blob' })
+                .then(function (ev) {
+                var responseStatus = ev.target.status;
+                if (SuccessResponseStatus.indexOf(responseStatus) !== -1) {
+                    resolve(ev.target.response);
+                }
+                else {
+                    reject(new Error("[loadImageWithBlob] The image does not support get requests, responseStatus ".concat(responseStatus, ", '").concat(img, "'.")));
+                }
+            })
+                .catch(reject);
+        }
+    });
+}
+var cacheImage;
+var cacheResult;
+function loadImageWithBlob(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            getBlob(img)
+                .then(function (blob) {
+                var url = URL.createObjectURL(blob);
+                var image = new Image();
+                image.onload = function () {
+                    URL.revokeObjectURL(url);
+                    var result = { blob: blob, image: image };
+                    if (useCache) {
+                        cacheImage = img;
+                        cacheResult = result;
+                    }
+                    resolve(result);
+                };
+                image.onerror = function (err) {
+                    URL.revokeObjectURL(url);
+                    console.error("[loadImageWithBlob] The image load failed, '".concat(img, "'."));
+                    reject(err);
+                };
+                image.src = url;
+            })
+                .catch(reject);
+        }
+    });
+}
+
+export { loadImageWithBlob as default };

package/lib/VERSION.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var VERSION = "4.19.4";
+var VERSION = "4.20.0";
 var VERSION$1 = VERSION;
 
 module.exports = VERSION$1;

package/lib/compressImage.js

@@ -0,0 +1,62 @@
+'use strict';
+
+var ut2 = require('ut2');
+var loadImageWithBlob = require('./loadImageWithBlob.js');
+
+function canvasToBlob(canvas, type, quality) {
+    return new Promise(function (resolve) {
+        canvas.toBlob(function (blob) {
+            resolve(blob);
+        }, type, quality);
+    });
+}
+function compressImage(img, options) {
+    if (options === void 0) { options = {}; }
+    return new Promise(function (resolve, reject) {
+        var width = options.width, height = options.height, rotate = options.rotate, _a = options.offset, offset = _a === void 0 ? [0, 0] : _a, _b = options.cacheImage, cacheImage = _b === void 0 ? true : _b, _c = options.background, background = _c === void 0 ? '#fff' : _c, canvasWidth = options.canvasWidth, canvasHeight = options.canvasHeight, _d = options.format, format = _d === void 0 ? 'blob' : _d, _e = options.type, type = _e === void 0 ? 'image/jpeg' : _e, _f = options.quality, quality = _f === void 0 ? 0.8 : _f, beforeCompress = options.beforeCompress, beforeDraw = options.beforeDraw, afterDraw = options.afterDraw;
+        loadImageWithBlob(img, cacheImage)
+            .then(function (_a) {
+            var image = _a.image, blob = _a.blob;
+            var numWidth = ut2.toNumber(width);
+            var numHeight = ut2.toNumber(height);
+            var numQuality = ut2.toNumber(quality);
+            if (numWidth) {
+                image.width = numWidth;
+            }
+            if (numHeight) {
+                image.height = numHeight;
+            }
+            beforeCompress === null || beforeCompress === void 0 ? void 0 : beforeCompress({ image: image, blob: blob }, options);
+            var canvas = document.createElement('canvas');
+            var ctx = canvas.getContext('2d');
+            var info = { image: image, blob: blob, canvas: canvas, context: ctx };
+            var numCanvasWidth = ut2.toNumber(typeof canvasWidth === 'function' ? canvasWidth(info, options) : canvasWidth);
+            var numCanvasHeight = ut2.toNumber(typeof canvasHeight === 'function' ? canvasHeight(info, options) : canvasHeight);
+            canvas.width = numCanvasWidth || image.width;
+            canvas.height = numCanvasHeight || image.height;
+            if (background && background !== 'none') {
+                ctx.fillStyle = background;
+                ctx.fillRect(0, 0, canvas.width, canvas.height);
+            }
+            var internalOffset = [0, 0];
+            if (rotate !== undefined) {
+                ctx.translate(image.width / 2, image.height / 2);
+                internalOffset = [-image.width / 2, -image.height / 2];
+                ctx.rotate((rotate * Math.PI) / 180);
+            }
+            var outOffset = typeof offset === 'function' ? offset(info, options) : offset;
+            beforeDraw === null || beforeDraw === void 0 ? void 0 : beforeDraw(info, options);
+            ctx.drawImage(image, internalOffset[0] + ut2.toNumber(outOffset[0]), internalOffset[1] + ut2.toNumber(outOffset[1]), image.width, image.height);
+            afterDraw === null || afterDraw === void 0 ? void 0 : afterDraw(info, options);
+            if (format === 'blob') {
+                canvasToBlob(canvas, type, numQuality).then(resolve).catch(reject);
+            }
+            else {
+                resolve(canvas.toDataURL(type, numQuality));
+            }
+        })
+            .catch(reject);
+    });
+}
+
+module.exports = compressImage;

package/lib/gcd.js

@@ -0,0 +1,44 @@
+'use strict';
+
+var ut2 = require('ut2');
+
+function gcd() {
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var num1 = nums[0];
+    var num2 = nums[1] === void 0 ? 0 : nums[1];
+    var rest = nums.slice(2);
+    if (rest.length > 0) {
+        return gcd.apply(void 0, [gcd(num1, num2)].concat(rest));
+    }
+    num1 = Math.abs(ut2.round(num1));
+    num2 = Math.abs(ut2.round(num2));
+    if (ut2.isNaN(num1) || ut2.isNaN(num2)) {
+        return Number.NaN;
+    }
+    if (num1 === 0 && num2 === 0) {
+        return 0;
+    }
+    if (num1 === 0) {
+        return num2;
+    }
+    if (num2 === 0) {
+        return num1;
+    }
+    var temp = num2;
+    if (num1 < num2) {
+        temp = num1;
+        num1 = num2;
+        num2 = temp;
+    }
+    while (temp) {
+        temp = num1 % num2;
+        num1 = num2;
+        num2 = temp;
+    }
+    return ut2.toNumber(num1);
+}
+
+module.exports = gcd;

package/lib/getImageInfo.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var ut2 = require('ut2');
+var divide = require('./divide.js');
+var gcd = require('./gcd.js');
+var loadImageWithBlob = require('./loadImageWithBlob.js');
+var bytesToSize = require('./bytesToSize.js');
+
+function calcContrast(w, h) {
+    var n = gcd(w, h);
+    return "".concat(divide(ut2.round(w), n), ":").concat(divide(ut2.round(h), n));
+}
+var cacheImage;
+var cacheResult;
+function getImageInfo(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            loadImageWithBlob(img, false)
+                .then(function (_a) {
+                var image = _a.image, blob = _a.blob;
+                var width = image.width, height = image.height;
+                var result = {
+                    width: width,
+                    height: height,
+                    contrast: calcContrast(width, height),
+                    measure: "".concat(width, " \u00D7 ").concat(height, " px"),
+                    size: bytesToSize(blob.size),
+                    bytes: blob.size,
+                    image: image,
+                    blob: blob
+                };
+                if (useCache) {
+                    cacheImage = img;
+                    cacheResult = result;
+                }
+                resolve(result);
+            })
+                .catch(reject);
+        }
+    });
+}
+
+module.exports = getImageInfo;

package/lib/index.js

@@ -42,9 +42,15 @@ var minus = require('./minus.js');
 var times = require('./times.js');
 var divide = require('./divide.js');
 var round = require('./round.js');
+var gcd = require('./gcd.js');
+var lcm = require('./lcm.js');
 var ajax = require('./ajax.js');
 var calculateCursorPosition = require('./calculateCursorPosition.js');
+var compressImage = require('./compressImage.js');
 var download = require('./download.js');
+var getImageInfo = require('./getImageInfo.js');
+var loadImage = require('./loadImage.js');
+var loadImageWithBlob = require('./loadImageWithBlob.js');
 var loadScript = require('./loadScript.js');
 var randomString = require('./randomString.js');
 var strlen = require('./strlen.js');
@@ -59,7 +65,7 @@ var findTreeSelect = require('./findTreeSelect.js');
 var config = require('./utils/config.js');
 var VERSION = require('./VERSION.js');
 
-exports.version = "4.19.4";
+exports.version = "4.20.0";
 
 exports.isMobile = isMobile;
 exports.isTelephone = isTelephone;
@@ -103,9 +109,15 @@ exports.minus = minus;
 exports.times = times;
 exports.divide = divide;
 exports.round = round;
+exports.gcd = gcd;
+exports.lcm = lcm;
 exports.ajax = ajax;
 exports.calculateCursorPosition = calculateCursorPosition;
+exports.compressImage = compressImage;
 exports.download = download;
+exports.getImageInfo = getImageInfo;
+exports.loadImage = loadImage;
+exports.loadImageWithBlob = loadImageWithBlob;
 exports.loadScript = loadScript;
 exports.randomString = randomString;
 exports.strlen = strlen;

package/lib/lcm.js

@@ -0,0 +1,22 @@
+'use strict';
+
+var tslib = require('tslib');
+var divide = require('./divide.js');
+var times = require('./times.js');
+var gcd = require('./gcd.js');
+var ut2 = require('ut2');
+
+function lcm() {
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var args = nums.map(function (item) { return Math.abs(ut2.round(item)); });
+    if (args.length === 1) {
+        args = args.concat([1]);
+    }
+    var product = args.indexOf(0) > -1 ? 0 : times.apply(void 0, tslib.__spreadArray([], tslib.__read(args), false));
+    return divide(product, gcd.apply(void 0, tslib.__spreadArray([], tslib.__read(args), false)));
+}
+
+module.exports = lcm;

package/lib/loadImage.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var ut2 = require('ut2');
+
+var cacheImage;
+var cacheResult;
+function loadImage(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            var imgIsBlob_1 = ut2.isBlob(img);
+            var url_1 = imgIsBlob_1 ? URL.createObjectURL(img) : img;
+            var image_1 = new Image();
+            if (!imgIsBlob_1) {
+                image_1.crossOrigin = 'anonymous';
+            }
+            image_1.onload = function () {
+                if (imgIsBlob_1) {
+                    URL.revokeObjectURL(url_1);
+                }
+                if (useCache) {
+                    cacheImage = img;
+                    cacheResult = image_1;
+                }
+                resolve(image_1);
+            };
+            image_1.onerror = function (err) {
+                if (imgIsBlob_1) {
+                    URL.revokeObjectURL(url_1);
+                }
+                console.error("[loadImage] The image load failed, '".concat(img, "'."));
+                reject(err);
+            };
+            image_1.src = url_1;
+        }
+    });
+}
+
+module.exports = loadImage;

package/lib/loadImageWithBlob.js

@@ -0,0 +1,61 @@
+'use strict';
+
+var ut2 = require('ut2');
+var ajax = require('./ajax.js');
+
+var SuccessResponseStatus = [200, 304];
+function getBlob(img) {
+    return new Promise(function (resolve, reject) {
+        if (ut2.isBlob(img)) {
+            resolve(img);
+        }
+        else {
+            ajax(img, { responseType: 'blob' })
+                .then(function (ev) {
+                var responseStatus = ev.target.status;
+                if (SuccessResponseStatus.indexOf(responseStatus) !== -1) {
+                    resolve(ev.target.response);
+                }
+                else {
+                    reject(new Error("[loadImageWithBlob] The image does not support get requests, responseStatus ".concat(responseStatus, ", '").concat(img, "'.")));
+                }
+            })
+                .catch(reject);
+        }
+    });
+}
+var cacheImage;
+var cacheResult;
+function loadImageWithBlob(img, useCache) {
+    if (useCache === void 0) { useCache = true; }
+    return new Promise(function (resolve, reject) {
+        if (useCache && cacheImage === img && cacheResult) {
+            resolve(cacheResult);
+        }
+        else {
+            getBlob(img)
+                .then(function (blob) {
+                var url = URL.createObjectURL(blob);
+                var image = new Image();
+                image.onload = function () {
+                    URL.revokeObjectURL(url);
+                    var result = { blob: blob, image: image };
+                    if (useCache) {
+                        cacheImage = img;
+                        cacheResult = result;
+                    }
+                    resolve(result);
+                };
+                image.onerror = function (err) {
+                    URL.revokeObjectURL(url);
+                    console.error("[loadImageWithBlob] The image load failed, '".concat(img, "'."));
+                    reject(err);
+                };
+                image.src = url;
+            })
+                .catch(reject);
+        }
+    });
+}
+
+module.exports = loadImageWithBlob;