@progress/kendo-angular-barcodes 19.1.2-develop.2 → 19.1.2-develop.3

package/fesm2022/progress-kendo-angular-barcodes.mjs

@@ -17,8 +17,8 @@ const packageMetadata = {
     productName: 'Kendo UI for Angular',
     productCode: 'KENDOUIANGULAR',
     productCodes: ['KENDOUIANGULAR'],
-    publishDate: 1749820734,
-    version: '19.1.2-develop.2',
+    publishDate: 1750152804,
+    version: '19.1.2-develop.3',
     licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
 };
 
@@ -126,13 +126,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Represents the Kendo UI Barcode component for Angular.
+ * Represents the [Kendo UI Barcode component for Angular](slug:overview_barcode_barcodes).
+ *
+ * Use this component to display a barcode in your Angular application.
  *
  * @example
- * ```ts
+ * ```typescript
  * import { Component } from '@angular/core';
  *
- * _@Component({
+ * @Component({
  *    selector: 'my-app',
  *    template: `
  *        <kendo-barcode type="EAN8" value="1234567">
@@ -148,280 +150,72 @@ class BarcodeComponent extends BaseComponent {
     renderer;
     ngZone;
     /**
-     * The background color of the Barcode. Accepts a valid CSS color string, including hex and rgb.
+     * Sets the background color of the Barcode. Accepts any valid CSS color string, such as hex or rgb.
      *
      * @default "white"
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       background="#fc0">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     background;
     /**
-     * The border of the Barcode.
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     * import { Border } from '@progress/kendo-angular-barcodes';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [border]="barcodeBorder" [padding]="5">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     *     barcodeBorder: Border = {
-     *         color: '#fc0',
-     *         width: 2
-     *     };
-     * }
-     * ```
+     * Configures the border of the Barcode.
      */
     border;
     /**
-     * If set to `true`, the Barcode will display the checksum digit next to the value in the text area.
+     * Shows the checksum digit next to the value in the text area when set to `true`.
      *
      * @default false
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [checksum]="true">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     checksum;
     /**
-     * The color of the Barcode. Accepts a valid CSS color string, including hex and rgb.
+     * Sets the color of the Barcode. Accepts any valid CSS color string, such as hex or rgb.
      *
      * @default "black"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       color="#fc0">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     color;
     /**
-     * The height of the Barcode in pixels.
-     *
-     * The Barcode dimensions can also be set through regular CSS styling.
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                        [width]="200" [height]="100">
-     *        </kendo-barcode>
+     * Sets the height of the Barcode in pixels.
      *
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [style.width.px]="200" [style.height.px]="100">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * You can also set the Barcode dimensions using CSS.
      */
     height;
     /**
-     * The padding of the Barcode. A numeric value sets all paddings.
+     * Sets the padding of the Barcode. Use a number to set all paddings, or a `Padding` object for the individual sides.
      *
      * @default 0
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     * import { Padding } from '@progress/kendo-angular-barcodes';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [padding]="5" background="#fc0">
-     *        </kendo-barcode>
-     *
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [padding]="barcodePadding" background="#cf0">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     *     barcodePadding: Padding = {
-     *         top: 20,
-     *         bottom: 10,
-     *         left: 5,
-     *         right: 5
-     *     };
-     * }
-     * ```
      */
     padding;
     /**
-     * Sets the preferred rendering mode of the Barcode.
+     * Sets the rendering mode of the Barcode.
      *
-     * The supported values are:
-     * * `"canvas"`&mdash;Renders the component as a Canvas element.
-     * * `"svg"`&mdash;Renders the component as an inline SVG document.
+     * Use `"canvas"` to render as a Canvas element or `"svg"` to render as an inline SVG.
      *
      * @default "svg"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       renderAs="canvas">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     renderAs;
     /**
-     * The Barcode text label configuration.
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     * import { BarcodeText } from '@progress/kendo-angular-barcodes';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [text]="barcodeText">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     *     barcodeText: BarcodeText = {
-     *         color: '#fc0',
-     *         font: '20px monospace'
-     *     };
-     * }
-     * ```
+     * Configures the Barcode text label.
      */
     text;
     /**
-     * The symbology (encoding) the Barcode will use.
+     * Sets the symbology (encoding) for the Barcode.
      *
      * @default "Code39"
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN13" value="123456789987">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     type;
     /**
-     * The value of the Barcode.
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN13" value="123456789987">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * Sets the value of the Barcode.
      */
     value;
     /**
-     * The width of the Barcode in pixels.
-     *
-     * The Barcode dimensions can also be set through regular CSS styling.
+     * Sets the width of the Barcode in pixels.
      *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                        [width]="200" [height]="100">
-     *        </kendo-barcode>
-     *
-     *        <kendo-barcode type="EAN8" value="1234567"
-     *                       [style.width.px]="200" [style.height.px]="100">
-     *        </kendo-barcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * You can also set the Barcode dimensions using CSS.
      */
     width;
     /**
-     * Limits the automatic resizing of the Barcode. Sets the maximum number of times per second
-     * that the component redraws its content when the size of its container changes.
-     * Defaults to `10`. To disable the automatic resizing, set it to `0`.
+     * Limits how often the Barcode resizes automatically. Sets the maximum number of redraws per second when the container size changes.
+     * Set to `0` to disable automatic resizing.
      *
-     * @example
-     * ```ts
-     * _@Component({
-     *     selector: 'my-app',
-     *     template: `
-     *         <kendo-barcode type="EAN8" [value]="1234567"
-     *                        [resizeRateLimit]="2">
-     *         </kendo-barcode>
-     *   `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * @default 10
      */
     resizeRateLimit = 10;
     get options() {
@@ -504,13 +298,15 @@ const DEFAULT_COLOR = '#000';
 const DEFAULT_BACKGROUND = '#fff';
 const DEFAULT_ERROR_CORRECTION = 'L';
 /**
- * Represents the Kendo UI QR Code component for Angular.
+ * Represents the [Kendo UI QR Code component for Angular](slug:overview_qrcode_barcodes).
+ *
+ * Shows a QR Code for the provided value.
  *
  * @example
  * ```ts
  * import { Component } from '@angular/core';
  *
- * _@Component({
+ * @Component({
  *    selector: 'my-app',
  *    template: `
  *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui">
@@ -526,257 +322,72 @@ class QRCodeComponent extends BaseComponent {
     renderer;
     ngZone;
     /**
-     * The background color of the QR Code. Accepts a valid CSS color string, including hex and rgb.
+     * Sets the background color of the QR Code. Accepts any valid CSS color string, such as hex or rgb.
      *
      * @default "white"
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      background="#fc0">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     background;
     /**
-     * The border of the QR Code.
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     * import { Border } from '@progress/kendo-angular-barcodes';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      [border]="qrcodeBorder" [padding]="5">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     *     qrcodeBorder: Border = {
-     *         color: '#fc0',
-     *         width: 2
-     *     };
-     * }
-     * ```
+     * Sets the border of the QR Code.
      */
     border;
     /**
-     * The color of the QR Code. Accepts a valid CSS color string, including hex and rgb.
+     * Sets the color of the QR Code. Accepts any valid CSS color string, such as hex or rgb.
      *
      * @default "black"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      color="#fc0">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     color;
     /**
-     * The encoding mode used to encode the value.
-     *
-     * > **Important** The UTF-8 encoding is not included in the specifications and is not supported by all readers.
+     * Sets the encoding mode for the value.
      *
-     * The possible values are:
-     * * `"ISO_8859_1"`&mdash;Supports all characters from the [ISO/IEC 8859-1](https://en.wikipedia.org/wiki/ISO/IEC_8859-1) character set.
-     * * `"UTF_8"`&mdash;Supports all [Unicode](https://en.wikipedia.org/wiki/List_of_Unicode_characters) characters.
+     * > **Important** The UTF-8 encoding is not part of the specifications and some readers may not support it.
      *
      * @default "ISO_8859_1"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="АБВ" encoding="UTF_8">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     encoding;
     /**
-     * The error correction level to use.
-     *
-     * The possible values are:
-     * * `"L"`&mdash;Approximately 7% of the codewords can be restored.
-     * * `"M"`&mdash;Approximately 15% of the codewords can be restored.
-     * * `"Q"`&mdash;Approximately 25% of the codewords can be restored.
-     * * `"H"`&mdash;Approximately 30% of the codewords can be restored.
+     * Sets the error correction level.
      *
      * @default "L"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      errorCorrection="Q">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     errorCorrection;
     /**
-     * An optional image overlay that will placed over the QR Code.
-     *
-     * > **Note** Always test if the code reads correctly with the applied overlay.
-     * > Depending on the length of the value and the size of the overlay, you might need to raise the `errorCorrection` level to `"M"` or `"H"`.
+     * Sets an optional image overlay to display over the QR Code.
      *
-     * @example
-     * ```ts-preview
-     * import { QRCodeOverlay } from '@progress/kendo-angular-barcodes';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      [overlay]="qrcodeOverlay">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     *     qrcodeOverlay: QRCodeOverlay = {
-     *         type: 'swiss'
-     *     };
-     * }
-     * ```
+     * > **Note** Always test if the code scans correctly with the overlay. If needed, increase the `errorCorrection` level to `"M"` or `"H"`.
      */
     overlay;
     /**
-     * The padding of the QR Code. The value sets all paddings in pixels.
+     * Sets the padding for the QR Code in pixels.
      *
      * @default 0
-     *
-     * @example
-     * ```ts-preview
-     * import { Component } from '@angular/core';
-     *
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      [padding]="10" background="#fc0">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     padding;
     /**
-     * Sets the preferred rendering mode of the QR Code.
-     *
-     * The supported values are:
-     * * `"canvas"`&mdash;Renders the component as a Canvas element.
-     * * `"svg"`&mdash;Renders the component as an inline SVG document.
+     * Sets the rendering mode for the QR Code.
      *
      * @default "svg"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      renderAs="canvas">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
      * ```
      */
     renderAs;
     /**
-     * Specifies the size of a QR Code. Numeric values are treated as pixels.
+     * Sets the size of the QR Code. Numeric values are in pixels.
      *
      * If no size is specified, the size will be determined from the element width and height.
      * If the element has width or height of zero, a default value of 200 pixels will be used.
      *
      * @default "200px"
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      [size]="200">
-     *        </kendo-qrcode>
-     *
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                      [style.width.px]="200" [style.height.px]="200">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
      */
     size;
     /**
-     * The value of the QR Code.
-     *
-     * @example
-     * ```ts-preview
-     * _@Component({
-     *    selector: 'my-app',
-     *    template: `
-     *        <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui">
-     *        </kendo-qrcode>
-     *    `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * Sets the value to encode in the QR Code.
      */
     value;
     /**
-     * Limits the automatic resizing of the QR Code. Sets the maximum number of times per second
-     * that the component redraws its content when the size of its container changes.
-     * Defaults to `10`. To disable the automatic resizing, set it to `0`.
+     * Limits how often the QR Code resizes automatically. Sets the maximum redraws per second when the container size changes.
+     * Set to `0` to disable automatic resizing.
      *
-     * @example
-     * ```ts
-     * _@Component({
-     *     selector: 'my-app',
-     *     template: `
-     *         <kendo-qrcode value="https://www.telerik.com/kendo-angular-ui"
-     *                       [resizeRateLimit]="2">
-     *         </kendo-qrcode>
-     *   `
-     * })
-     * export class AppComponent {
-     * }
-     * ```
+     * @default 10
      */
     resizeRateLimit = 10;
     get options() {
@@ -853,19 +464,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
             }] } });
 
 /**
- * Utility array that contains all `Barcode` related components and directives
+ * Use this utility array to access all Barcode related components and directives in a standalone Angular component.
  */
 const KENDO_BARCODE = [
     BarcodeComponent
 ];
 /**
- * Utility array that contains all `QRCode` related components and directives
+ * Use this utility array to access all QRCode related components and directives in a standalone Angular component.
  */
 const KENDO_QRCODE = [
     QRCodeComponent
 ];
 /**
- * Utility array that contains all `@progress/kendo-angular-barcodes` related components and directives
+ * Use this utility array to access all `@progress/kendo-angular-barcodes` related components and directives in a standalone Angular component.
  */
 const KENDO_BARCODES = [
     ...KENDO_BARCODE,
@@ -874,34 +485,26 @@ const KENDO_BARCODES = [
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Barcode component.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Barcode component.
+ *
+ * Use this module to add Barcode support to your application.
  *
  * @example
  *
- * ```ts-no-run
- * // Import the Barcode module
+ * ```ts
+ * // Import the BarcodeModule.
  * import { BarcodeModule } from '@progress/kendo-angular-barcodes';
  *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from '@angular/platform-browser';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, BarcodeModule], // import Barcode module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports: [BrowserModule, BarcodeModule],
+ *     bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 class BarcodeModule {
@@ -920,34 +523,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the QR Code component.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the QR Code component.
  *
- * @example
+ * Use this module to add QR Code support to your application.
  *
- * ```ts-no-run
- * // Import the QR Code module
+ * @example
+ * ```ts
+ * // Import the QRCodeModule
  * import { QRCodeModule } from '@progress/kendo-angular-barcodes';
  *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from '@angular/platform-browser';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, QRCodeModule], // import QRCodeModule module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports: [BrowserModule, QRCodeModule],
+ *     bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 class QRCodeModule {
@@ -966,34 +560,26 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
 
 //IMPORTANT: NgModule export kept for backwards compatibility
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the Barcode and QR Code components.
+ * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi']) definition for the Barcode and QR Code components.
+ *
+ * Use this module to add Barcode and QR Code features to your application.
  *
  * @example
  *
- * ```ts-no-run
- * // Import the Barcodes module
+ * ```ts
+ * // Import the Barcodes module.
  * import { BarcodesModule } from '@progress/kendo-angular-barcodes';
  *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from '@angular/platform-browser';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, BarcodesModule], // import Barcodes module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports: [BrowserModule, BarcodesModule],
+ *     bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 class BarcodesModule {
@@ -1015,17 +601,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
  */
 const isPresent = (value) => value !== null && value !== undefined;
 /**
- * Creates a value validator for a particular Barcode type.
+ * Creates a validator for a specific Barcode type.
+ *
+ * Use this function to validate a Barcode value for a given `BarcodeType`.
  *
- * @param {BarcodeType} type The type of the Barcode.
- * @param {Size} size The size of the barcode, excluding the text label, padding and border. Optional.
- * @returns {ValidatorFn}  A validator function that returns an error map with the `barcode` property if the validation check fails, otherwise `null`.
+ * @param type Specifies the type of the Barcode.
+ * @param size Specifies the size of the barcode, excluding the text label, padding, and border. This parameter is optional.
+ * @returns Returns a validator function. The function returns an error map with the `barcode` property if validation fails. Otherwise, it returns `null` if valid.
  *
  * @example
- * ```ts-no-run
+ * ```typescript
  * const control = new FormControl('1234', createBarcodeValidator('EAN8'));
  * console.log(control.errors);
- *
  * // {
  * //   barcode: {
  * //     message: 'The value of the "EAN13" encoding should be 12 symbols',
@@ -1056,10 +643,10 @@ const createBarcodeValidator = (type, size) => {
 };
 
 /**
- * Creates a value validator for a particular Barcode type.
+ * Creates a value validator for a specific QR Code encoding.
  *
- * @param {QRCodeEncoding} encoding The QR Code encoding. Defaults to 'ISO_8859_1'.
- * @returns {ValidatorFn}  A validator function that returns an error map with the `qrcode` property if the validation check fails, otherwise `null`.
+ * @param {QRCodeEncoding} encoding Sets the QR Code encoding. Defaults to `ISO_8859_1`.
+ * @returns {ValidatorFn} Returns a validator function. The function returns an error map with the `qrcode` property if the value is invalid. Otherwise, it returns `null`.
  *
  * @example
  * ```ts-no-run