@progress/kendo-charts 1.20.1 → 1.22.0

package/dist/es/barcode/barcode-validator.js

@@ -0,0 +1,50 @@
+import { Encodings } from './encodings/main';
+
+var validate = function (encoding, size, prefix) { return function (value) {
+    try {
+        encoding.encode(
+            prefix + value,
+            size.width,
+            size.height
+        );
+    } catch (error) {
+        return {
+            valid: false,
+            error: error
+        };
+    }
+
+    return {
+        valid: true
+    };
+}; };
+
+// A default size for encodings, so the validator can check only the value if no size is provided.
+var fallbackSize = { width: 500, height: 100 };
+
+function barcodeValidator(type, size) {
+    if ( size === void 0 ) size = fallbackSize;
+
+    if (!type) {
+        throw new Error("Please specify barcode type to validate.");
+    }
+
+    var resolvedType = type.toLowerCase();
+    var prefix = '';
+    if (resolvedType === 'upca') {
+        resolvedType = 'ean13';
+        prefix = '0';
+    } else if (resolvedType === 'upce') {
+        resolvedType = 'ean8';
+        prefix = '0';
+    }
+
+    if (!Encodings[resolvedType]) {
+        throw new Error(("Encoding '" + type + "' is not supported."));
+    }
+
+    var encoding = new Encodings[resolvedType]();
+    return validate(encoding, size, prefix);
+}
+
+export default barcodeValidator;

package/dist/es/barcode/barcode.js

@@ -10,7 +10,8 @@ import {
     setDefaultOptions,
     deepExtend,
     getSpacing,
-    isObject
+    isObject,
+    defaultErrorHandler
 } from '../common';
 
 import {
@@ -24,11 +25,14 @@ var DEFAULT_BARCODE_WIDTH = 300;
 var DEFAULT_BARCODE_HEIGHT = 100;
 
 var Barcode = (function (Class) {
-    function Barcode(element, options) {
+    function Barcode(element, options, errorHandler) {
+        if ( errorHandler === void 0 ) errorHandler = defaultErrorHandler;
+
         Class.call(this);
 
         this.options = deepExtend({}, this.options, options);
         this.element = element;
+        this.onError = errorHandler;
 
         this._initElement();
         this._initSurface();
@@ -150,7 +154,12 @@ var Barcode = (function (Class) {
             barHeight -= textHeight + textMargin.top + textMargin.bottom;
         }
 
-        encodedValue = encoding.encode(value, contentBox.width(), barHeight);
+        try {
+            encodedValue = encoding.encode(value, contentBox.width(), barHeight);
+        } catch (error) {
+            this.onError(error);
+            return visual;
+        }
 
         if (textOptions.visible) {
             textToDisplay = value;
@@ -295,7 +304,7 @@ var Barcode = (function (Class) {
         }
 
         if (!Encodings[this.type]) {
-            throw new Error("Encoding " + this.type + " is not supported.");
+            throw new Error(("Encoding '" + (this.type) + "' is not supported."));
         }
 
         this.encoding = new Encodings[this.type]();

package/dist/es/barcode/encodings/code39.js

@@ -142,12 +142,12 @@ export var Code39 = (function (Code39Base) {
 
         var minBaseUnit = this.minBaseUnitLength;
         var minRatio = this.minRatio;
-        var minHeight = Math.max(0.15 * this.width, 24);
+        var minHeight = Math.ceil(Math.max(0.15 * this.width, 24));
         var baseUnit;
         var ratio = this.maxRatio;
 
         if (this.height < minHeight) {
-            throw new Error("Insufficient Height. The minimum height for value: " + this.value + " is: " + minHeight);
+            throw new Error(("Insufficient height for Code39 encoding: the current height is " + (this.height) + "px and the minimum height is " + minHeight + "px."));
         }
 
         baseUnit = this.getBaseUnit(ratio);
@@ -159,7 +159,7 @@ export var Code39 = (function (Code39Base) {
 
         if (baseUnit < minBaseUnit) {
             var minWidth = Math.ceil(this.getBaseWidth(minRatio) * minBaseUnit);
-            throw new Error("Insufficient width. The minimum width for value: " + this.value + " is: " + minWidth);
+            throw new Error(("Insufficient width for Code39 encoding: the current width is " + (this.width) + "px and the minimum width for value \"" + (this.value) + "\" is " + minWidth + "px."));
         }
 
         this.ratio = ratio;

package/dist/es/barcode/encodings/code93.js

@@ -83,16 +83,17 @@ export var Code93 = (function (Code39Base) {
     };
 
     Code93.prototype.prepareValues = function prepareValues () {
-        var minHeight = Math.max(0.15 * this.width, 24);
+        var minHeight = Math.ceil(Math.max(0.15 * this.width, 24));
 
         if (this.height < minHeight) {
-            throw new Error("Insufficient Height");
+            throw new Error(("Insufficient height for Code93 encoding: the current height is " + (this.height) + "px, the minimum required height is " + minHeight + "px."));
         }
 
         this.setBaseUnit();
 
         if (this.baseUnit < this.minBaseUnitLength) {
-            throw new Error("Insufficient Width");
+            var minWidth = Math.ceil(this.minBaseUnitLength * (this.width / this.baseUnit));
+            throw new Error(("Insufficient width for Code93 encoding: the current width is " + (this.width) + "px and the minimum required width for value \"" + (this.value) + "\" is " + minWidth + "px."));
         }
     };
 

package/dist/es/barcode/encodings/encoding.js

@@ -54,7 +54,7 @@ export var Encoding = (function (Class) {
     Encoding.prototype.addData = function addData () { };
 
     Encoding.prototype.invalidCharacterError = function invalidCharacterError (character) {
-        throw new Error("Character '" + character + "' is not valid for symbology " + this.name);
+        throw new Error(("Character \"" + character + "\" is not valid for symbology " + (this.name) + "."));
     };
 
     return Encoding;

package/dist/es/barcode/encodings/postnet.js

@@ -78,7 +78,7 @@ export var Postnet = (function (Encoding) {
         }
 
         if (!inArray(value.length, this.VALID_CODE_LENGTHS)) {
-            throw new Error("Invalid value length. Valid lengths for the Postnet symbology are " + this.VALID_CODE_LENGTHS.join(","));
+            throw new Error("Invalid value length. Valid lengths for the Postnet symbology are " + this.VALID_CODE_LENGTHS.join(",") + ".");
         }
     };
 

package/dist/es/barcode.js

@@ -1 +1,2 @@
 export { default as Barcode } from './barcode/barcode';
+export { default as barcodeValidator } from './barcode/barcode-validator';

package/dist/es/common/default-error-handler.js

@@ -0,0 +1,3 @@
+export default function defaultErrorHandler(error) {
+    throw error;
+}

package/dist/es/common/get-template.js

@@ -1,4 +1,4 @@
-import { TemplateService } from '../services';
+import TemplateService from '../services/template-service';
 import isFunction from './is-function';
 
 export default function getTemplate(options) {
@@ -12,4 +12,4 @@ export default function getTemplate(options) {
     }
 
     return template;
-}
+}

package/dist/es/common.js

@@ -29,5 +29,6 @@ export { default as find } from './common/find';
 export { default as elementScale } from './common/element-scale';
 export { default as autoTextColor } from './common/auto-text-color';
 export { default as createHashSet } from './common/create-hash-set';
+export { default as defaultErrorHandler } from './common/default-error-handler';
 
 export * from './drawing-utils';

package/dist/es/qrcode/encodings/data-modes/byte-data-mode.js

@@ -29,7 +29,7 @@ export var ByteQRDataMode = (function (QRDataMode) {
             return code;
         }
 
-        throw new Error("Unsupported character: " + character);
+        throw new Error(("Unsupported character in QR Code: \"" + character + "\"."));
     };
 
     ByteQRDataMode.prototype.encode = function encode (str, version) {

package/dist/es/qrcode/qrcode-validator.js

@@ -0,0 +1,24 @@
+import { encodeData } from './encodings/encoding';
+
+var ISO = 'ISO_8859_1';
+
+function qrcodeValidator(encoding) {
+    if ( encoding === void 0 ) encoding = ISO;
+
+    return function(value) {
+        try {
+            encodeData(value, 'L', encoding);
+        } catch (error) {
+            return {
+                valid: false,
+                error: error
+            };
+        }
+
+        return {
+            valid: true
+        };
+    };
+}
+
+export default qrcodeValidator;

package/dist/es/qrcode/qrcode.js

@@ -7,7 +7,8 @@ import {
     Class,
     addClass,
     setDefaultOptions,
-    deepExtend
+    deepExtend,
+    defaultErrorHandler
 } from '../common';
 
 import { Box } from '../core';
@@ -29,12 +30,15 @@ var QRCodeDefaults = {
 };
 
 var QRCode = (function (Class) {
-    function QRCode(element, options) {
+    function QRCode(element, options, errorHandler) {
+        if ( errorHandler === void 0 ) errorHandler = defaultErrorHandler;
+
         Class.call(this);
 
         this.options = deepExtend({}, this.options, options);
         this.element = element;
         this.wrapper = this.element;
+        this.onError = errorHandler;
 
         this._initElement();
         this._initSurface();
@@ -155,22 +159,26 @@ var QRCode = (function (Class) {
 
         var visual = new draw.Group();
 
-        if (value) {
-            matrix = encodeData(value, this.options.errorCorrection, this.options.encoding);
-            size = this._getSize();
-            contentSize = size - 2 * (borderWidth + padding);
-            baseUnit = this._calculateBaseUnit(contentSize, matrix.length);
-            dataSize = matrix.length * baseUnit;
-            quietZoneSize = borderWidth + padding + (contentSize - dataSize) / 2;
-
-            visual.append(this._renderBackground(size, border));
-            visual.append(this._renderMatrix(matrix, baseUnit, quietZoneSize));
-
-            if (this._hasCustomLogo()) {
-                visual.append(this._renderLogo(size, baseUnit));
-            } else if (this._isSwiss()) {
-                visual.append(this._renderSwissCode(size, baseUnit));
+        try {
+            if (value) {
+                matrix = encodeData(value, this.options.errorCorrection, this.options.encoding);
+                size = this._getSize();
+                contentSize = size - 2 * (borderWidth + padding);
+                baseUnit = this._calculateBaseUnit(contentSize, matrix.length);
+                dataSize = matrix.length * baseUnit;
+                quietZoneSize = borderWidth + padding + (contentSize - dataSize) / 2;
+
+                visual.append(this._renderBackground(size, border));
+                visual.append(this._renderMatrix(matrix, baseUnit, quietZoneSize));
+
+                if (this._hasCustomLogo()) {
+                    visual.append(this._renderLogo(size, baseUnit));
+                } else if (this._isSwiss()) {
+                    visual.append(this._renderSwissCode(size, baseUnit));
+                }
             }
+        } catch (error) {
+            this.onError(error);
         }
 
         return visual;
@@ -261,10 +269,11 @@ var QRCode = (function (Class) {
         var baseUnit = Math.floor(size / matrixSize);
 
         if (baseUnit < QRCodeDefaults.MIN_BASE_UNIT_SIZE) {
-            throw new Error("Insufficient size.");
-        }
-
-        if (baseUnit * matrixSize >= size &&
+            var minSize = Math.ceil(matrixSize * QRCodeDefaults.MIN_BASE_UNIT_SIZE);
+            this.onError(new Error(
+                ("Insufficient size for QR Code: the current size is " + size + "px and the minimum size is " + minSize + "px.")
+            ));
+        } else if (baseUnit * matrixSize >= size &&
             baseUnit - 1 >= QRCodeDefaults.MIN_BASE_UNIT_SIZE) {
             baseUnit--;
         }

package/dist/es/qrcode.js

@@ -1 +1,2 @@
 export { default as QRCode } from './qrcode/qrcode';
+export { default as qrcodeValidator } from './qrcode/qrcode-validator';

package/dist/es2015/barcode/barcode-validator.js

@@ -0,0 +1,48 @@
+import { Encodings } from './encodings/main';
+
+const validate = (encoding, size, prefix) => (value) => {
+    try {
+        encoding.encode(
+            prefix + value,
+            size.width,
+            size.height
+        );
+    } catch (error) {
+        return {
+            valid: false,
+            error
+        };
+    }
+
+    return {
+        valid: true
+    };
+};
+
+// A default size for encodings, so the validator can check only the value if no size is provided.
+const fallbackSize = { width: 500, height: 100 };
+
+function barcodeValidator(type, size = fallbackSize) {
+    if (!type) {
+        throw new Error(`Please specify barcode type to validate.`);
+    }
+
+    let resolvedType = type.toLowerCase();
+    let prefix = '';
+    if (resolvedType === 'upca') {
+        resolvedType = 'ean13';
+        prefix = '0';
+    } else if (resolvedType === 'upce') {
+        resolvedType = 'ean8';
+        prefix = '0';
+    }
+
+    if (!Encodings[resolvedType]) {
+        throw new Error(`Encoding '${type}' is not supported.`);
+    }
+
+    const encoding = new Encodings[resolvedType]();
+    return validate(encoding, size, prefix);
+}
+
+export default barcodeValidator;

package/dist/es2015/barcode/barcode.js

@@ -10,7 +10,8 @@ import {
     setDefaultOptions,
     deepExtend,
     getSpacing,
-    isObject
+    isObject,
+    defaultErrorHandler
 } from '../common';
 
 import {
@@ -24,11 +25,12 @@ const DEFAULT_BARCODE_WIDTH = 300;
 const DEFAULT_BARCODE_HEIGHT = 100;
 
 class Barcode extends Class {
-    constructor(element, options) {
+    constructor(element, options, errorHandler = defaultErrorHandler) {
         super();
 
         this.options = deepExtend({}, this.options, options);
         this.element = element;
+        this.onError = errorHandler;
 
         this._initElement();
         this._initSurface();
@@ -144,7 +146,12 @@ class Barcode extends Class {
             barHeight -= textHeight + textMargin.top + textMargin.bottom;
         }
 
-        encodedValue = encoding.encode(value, contentBox.width(), barHeight);
+        try {
+            encodedValue = encoding.encode(value, contentBox.width(), barHeight);
+        } catch (error) {
+            this.onError(error);
+            return visual;
+        }
 
         if (textOptions.visible) {
             textToDisplay = value;
@@ -287,7 +294,7 @@ class Barcode extends Class {
         }
 
         if (!Encodings[this.type]) {
-            throw new Error("Encoding " + this.type + " is not supported.");
+            throw new Error(`Encoding '${this.type}' is not supported.`);
         }
 
         this.encoding = new Encodings[this.type]();

package/dist/es2015/barcode/encodings/code39.js

@@ -120,12 +120,12 @@ export class Code39 extends Code39Base {
     prepareValues() {
         const minBaseUnit = this.minBaseUnitLength;
         const minRatio = this.minRatio;
-        const minHeight = Math.max(0.15 * this.width, 24);
+        const minHeight = Math.ceil(Math.max(0.15 * this.width, 24));
         let baseUnit;
         let ratio = this.maxRatio;
 
         if (this.height < minHeight) {
-            throw new Error("Insufficient Height. The minimum height for value: " + this.value + " is: " + minHeight);
+            throw new Error(`Insufficient height for Code39 encoding: the current height is ${this.height}px and the minimum height is ${minHeight}px.`);
         }
 
         baseUnit = this.getBaseUnit(ratio);
@@ -137,7 +137,7 @@ export class Code39 extends Code39Base {
 
         if (baseUnit < minBaseUnit) {
             let minWidth = Math.ceil(this.getBaseWidth(minRatio) * minBaseUnit);
-            throw new Error("Insufficient width. The minimum width for value: " + this.value + " is: " + minWidth);
+            throw new Error(`Insufficient width for Code39 encoding: the current width is ${this.width}px and the minimum width for value "${this.value}" is ${minWidth}px.`);
         }
 
         this.ratio = ratio;

package/dist/es2015/barcode/encodings/code93.js

@@ -75,16 +75,17 @@ export class Code93 extends Code39Base {
     }
 
     prepareValues() {
-        let minHeight = Math.max(0.15 * this.width, 24);
+        let minHeight = Math.ceil(Math.max(0.15 * this.width, 24));
 
         if (this.height < minHeight) {
-            throw new Error("Insufficient Height");
+            throw new Error(`Insufficient height for Code93 encoding: the current height is ${this.height}px, the minimum required height is ${minHeight}px.`);
         }
 
         this.setBaseUnit();
 
         if (this.baseUnit < this.minBaseUnitLength) {
-            throw new Error("Insufficient Width");
+            const minWidth = Math.ceil(this.minBaseUnitLength * (this.width / this.baseUnit));
+            throw new Error(`Insufficient width for Code93 encoding: the current width is ${this.width}px and the minimum required width for value "${this.value}" is ${minWidth}px.`);
         }
     }
 

package/dist/es2015/barcode/encodings/encoding.js

@@ -50,7 +50,7 @@ export class Encoding extends Class {
     addData() { }
 
     invalidCharacterError(character) {
-        throw new Error("Character '" + character + "' is not valid for symbology " + this.name);
+        throw new Error(`Character "${character}" is not valid for symbology ${this.name}.`);
     }
 }
 

package/dist/es2015/barcode/encodings/postnet.js

@@ -68,7 +68,7 @@ export class Postnet extends Encoding {
         }
 
         if (!inArray(value.length, this.VALID_CODE_LENGTHS)) {
-            throw new Error("Invalid value length. Valid lengths for the Postnet symbology are " + this.VALID_CODE_LENGTHS.join(","));
+            throw new Error("Invalid value length. Valid lengths for the Postnet symbology are " + this.VALID_CODE_LENGTHS.join(",") + ".");
         }
     }
 

package/dist/es2015/barcode.js

@@ -1 +1,2 @@
 export { default as Barcode } from './barcode/barcode';
+export { default as barcodeValidator } from './barcode/barcode-validator';

package/dist/es2015/common/default-error-handler.js

@@ -0,0 +1,3 @@
+export default function defaultErrorHandler(error) {
+    throw error;
+}

package/dist/es2015/common/get-template.js

@@ -1,4 +1,4 @@
-import { TemplateService } from '../services';
+import TemplateService from '../services/template-service';
 import isFunction from './is-function';
 
 export default function getTemplate(options = {}) {
@@ -10,4 +10,4 @@ export default function getTemplate(options = {}) {
     }
 
     return template;
-}
+}

package/dist/es2015/common.js

@@ -29,5 +29,6 @@ export { default as find } from './common/find';
 export { default as elementScale } from './common/element-scale';
 export { default as autoTextColor } from './common/auto-text-color';
 export { default as createHashSet } from './common/create-hash-set';
+export { default as defaultErrorHandler } from './common/default-error-handler';
 
 export * from './drawing-utils';

package/dist/es2015/qrcode/encodings/data-modes/byte-data-mode.js

@@ -21,7 +21,7 @@ export class ByteQRDataMode extends QRDataMode {
             return code;
         }
 
-        throw new Error("Unsupported character: " + character);
+        throw new Error(`Unsupported character in QR Code: "${character}".`);
     }
 
     encode(str, version) {

package/dist/es2015/qrcode/qrcode-validator.js

@@ -0,0 +1,22 @@
+import { encodeData } from './encodings/encoding';
+
+const ISO = 'ISO_8859_1';
+
+function qrcodeValidator(encoding = ISO) {
+    return function(value) {
+        try {
+            encodeData(value, 'L', encoding);
+        } catch (error) {
+            return {
+                valid: false,
+                error
+            };
+        }
+
+        return {
+            valid: true
+        };
+    };
+}
+
+export default qrcodeValidator;

package/dist/es2015/qrcode/qrcode.js

@@ -7,7 +7,8 @@ import {
     Class,
     addClass,
     setDefaultOptions,
-    deepExtend
+    deepExtend,
+    defaultErrorHandler
 } from '../common';
 
 import { Box } from '../core';
@@ -29,12 +30,13 @@ const QRCodeDefaults = {
 };
 
 class QRCode extends Class {
-    constructor(element, options) {
+    constructor(element, options, errorHandler = defaultErrorHandler) {
         super();
 
         this.options = deepExtend({}, this.options, options);
         this.element = element;
         this.wrapper = this.element;
+        this.onError = errorHandler;
 
         this._initElement();
         this._initSurface();
@@ -149,22 +151,26 @@ class QRCode extends Class {
 
         let visual = new draw.Group();
 
-        if (value) {
-            matrix = encodeData(value, this.options.errorCorrection, this.options.encoding);
-            size = this._getSize();
-            contentSize = size - 2 * (borderWidth + padding);
-            baseUnit = this._calculateBaseUnit(contentSize, matrix.length);
-            dataSize = matrix.length * baseUnit;
-            quietZoneSize = borderWidth + padding + (contentSize - dataSize) / 2;
-
-            visual.append(this._renderBackground(size, border));
-            visual.append(this._renderMatrix(matrix, baseUnit, quietZoneSize));
-
-            if (this._hasCustomLogo()) {
-                visual.append(this._renderLogo(size, baseUnit));
-            } else if (this._isSwiss()) {
-                visual.append(this._renderSwissCode(size, baseUnit));
+        try {
+            if (value) {
+                matrix = encodeData(value, this.options.errorCorrection, this.options.encoding);
+                size = this._getSize();
+                contentSize = size - 2 * (borderWidth + padding);
+                baseUnit = this._calculateBaseUnit(contentSize, matrix.length);
+                dataSize = matrix.length * baseUnit;
+                quietZoneSize = borderWidth + padding + (contentSize - dataSize) / 2;
+
+                visual.append(this._renderBackground(size, border));
+                visual.append(this._renderMatrix(matrix, baseUnit, quietZoneSize));
+
+                if (this._hasCustomLogo()) {
+                    visual.append(this._renderLogo(size, baseUnit));
+                } else if (this._isSwiss()) {
+                    visual.append(this._renderSwissCode(size, baseUnit));
+                }
             }
+        } catch (error) {
+            this.onError(error);
         }
 
         return visual;
@@ -255,10 +261,11 @@ class QRCode extends Class {
         let baseUnit = Math.floor(size / matrixSize);
 
         if (baseUnit < QRCodeDefaults.MIN_BASE_UNIT_SIZE) {
-            throw new Error("Insufficient size.");
-        }
-
-        if (baseUnit * matrixSize >= size &&
+            const minSize = Math.ceil(matrixSize * QRCodeDefaults.MIN_BASE_UNIT_SIZE);
+            this.onError(new Error(
+                `Insufficient size for QR Code: the current size is ${size}px and the minimum size is ${minSize}px.`
+            ));
+        } else if (baseUnit * matrixSize >= size &&
             baseUnit - 1 >= QRCodeDefaults.MIN_BASE_UNIT_SIZE) {
             baseUnit--;
         }

package/dist/es2015/qrcode.js

@@ -1 +1,2 @@
 export { default as QRCode } from './qrcode/qrcode';
+export { default as qrcodeValidator } from './qrcode/qrcode-validator';

package/dist/npm/barcode.d.ts

@@ -1,5 +1,6 @@
-import { Group } from '@progress/kendo-drawing';
+import { Group, geometry } from '@progress/kendo-drawing';
 import { Border, Margin, Padding, RenderMode } from './field-types';
+import { ValidationResult } from './validation';
 
 /**
  * Supported symbologies (encodings) for the Barcode component.
@@ -124,9 +125,11 @@ export interface BarcodeOptions {
 }
 
 export class Barcode {
-    constructor(element: Element, options: BarcodeOptions);
+    constructor(element: Element, options: BarcodeOptions, errorHandler?: (error: Error) => void);
 
     public redraw(): void;
     public setOptions(options: BarcodeOptions): void;
     public exportVisual(): Group;
 }
+
+export function barcodeValidator(type: BarcodeType, size: geometry.Size): (value: number | string) => ValidationResult;