scanbot-web-sdk 8.0.0-beta.3 → 8.0.0-beta.4

package/@types/core/compiled/BarcodeDocumentModel.d.ts

@@ -23,12 +23,13 @@ export declare const VCardSourceDocumentType = "Source";
 export declare const VCardKindDocumentType = "Kind";
 export declare const VCardXMLDocumentType = "XML";
 export declare const VCardNameDocumentType = "Name";
-export declare const VCardFirstNameDocumentType = "FirstName";
+export declare const VCardFormattedNameDocumentType = "FormattedName";
 export declare const VCardNicknameDocumentType = "Nickname";
 export declare const VCardBirthdayDocumentType = "Birthday";
 export declare const VCardAnniversaryDocumentType = "Anniversary";
 export declare const VCardGenderDocumentType = "Gender";
 export declare const VCardDeliveryAddressDocumentType = "DeliveryAddress";
+export declare const VCardLabelDocumentType = "Label";
 export declare const VCardPhotoDocumentType = "Photo";
 export declare const VCardTelephoneNumberDocumentType = "TelephoneNumber";
 export declare const VCardEmailDocumentType = "Email";
@@ -39,6 +40,7 @@ export declare const VCardGeoLocationDocumentType = "GeoLocation";
 export declare const VCardTitleDocumentType = "Title";
 export declare const VCardRoleDocumentType = "Role";
 export declare const VCardLogoDocumentType = "Logo";
+export declare const VCardAgentDocumentType = "Agent";
 export declare const VCardOrganisationDocumentType = "Organisation";
 export declare const VCardMemberDocumentType = "Member";
 export declare const VCardRelatedDocumentType = "Related";
@@ -54,6 +56,8 @@ export declare const VCardPublicKeyDocumentType = "PublicKey";
 export declare const VCardBusyTimeURLDocumentType = "BusyTimeURL";
 export declare const VCardCalendarURIForRequestsDocumentType = "CalendarURIForRequests";
 export declare const VCardCalendarURIDocumentType = "CalendarURI";
+export declare const VCardSortStringDocumentType = "SortString";
+export declare const VCardClassificationDocumentType = "Classification";
 export declare const VCardCustomDocumentType = "Custom";
 export declare const AAMVADocumentType = "AAMVA";
 export declare const AAMVATitleDataDocumentType = "TitleData";
@@ -553,76 +557,84 @@ export declare class VCard {
     requiredDocumentType(): string;
     /** The child document of type "Version". */
     get version(): VCard.Version;
-    /** The child document of type "Source". */
-    get source(): VCard.Source | undefined;
+    /** An array of all children of type "Source". */
+    get sources(): VCard.Source[];
     /** The child document of type "Kind". */
     get kind(): VCard.Kind | undefined;
-    /** The child document of type "XML". */
-    get xml(): VCard.XML | undefined;
+    /** An array of all children of type "XML". */
+    get xmls(): VCard.XML[];
     /** The child document of type "Name". */
     get name(): VCard.Name | undefined;
-    /** The child document of type "FirstName". */
-    get firstName(): VCard.FirstName | undefined;
-    /** The child document of type "Nickname". */
-    get nickname(): VCard.Nickname | undefined;
+    /** The child document of type "FormattedName". */
+    get formattedName(): VCard.FormattedName | undefined;
+    /** An array of all children of type "Nickname". */
+    get nicknames(): VCard.Nickname[];
     /** The child document of type "Birthday". */
     get birthday(): VCard.Birthday | undefined;
     /** The child document of type "Anniversary". */
     get anniversary(): VCard.Anniversary | undefined;
     /** The child document of type "Gender". */
     get gender(): VCard.Gender | undefined;
-    /** The child document of type "DeliveryAddress". */
-    get deliveryAddress(): VCard.DeliveryAddress | undefined;
-    /** The child document of type "Photo". */
-    get photo(): VCard.Photo | undefined;
-    /** The child document of type "TelephoneNumber". */
-    get telephoneNumber(): VCard.TelephoneNumber | undefined;
-    /** The child document of type "Email". */
-    get email(): VCard.Email | undefined;
-    /** The child document of type "IMPP". */
-    get impp(): VCard.IMPP | undefined;
-    /** The child document of type "Languages". */
-    get languages(): VCard.Languages | undefined;
-    /** The child document of type "TimeZone". */
-    get timeZone(): VCard.TimeZone | undefined;
-    /** The child document of type "GeoLocation". */
-    get geoLocation(): VCard.GeoLocation | undefined;
-    /** The child document of type "Title". */
-    get title(): VCard.Title | undefined;
-    /** The child document of type "Role". */
-    get role(): VCard.Role | undefined;
-    /** The child document of type "Logo". */
-    get logo(): VCard.Logo | undefined;
-    /** The child document of type "Organisation". */
-    get organisation(): VCard.Organisation | undefined;
-    /** The child document of type "Member". */
-    get member(): VCard.Member | undefined;
-    /** The child document of type "Related". */
-    get related(): VCard.Related | undefined;
-    /** The child document of type "Categories". */
-    get categories(): VCard.Categories | undefined;
-    /** The child document of type "Note". */
-    get note(): VCard.Note | undefined;
+    /** An array of all children of type "DeliveryAddress". */
+    get deliveryAddresses(): VCard.DeliveryAddress[];
+    /** An array of all children of type "Label". */
+    get labels(): VCard.Label[];
+    /** An array of all children of type "Photo". */
+    get photos(): VCard.Photo[];
+    /** An array of all children of type "TelephoneNumber". */
+    get telephoneNumbers(): VCard.TelephoneNumber[];
+    /** An array of all children of type "Email". */
+    get emails(): VCard.Email[];
+    /** An array of all children of type "IMPP". */
+    get impps(): VCard.IMPP[];
+    /** An array of all children of type "Languages". */
+    get languageses(): VCard.Languages[];
+    /** An array of all children of type "TimeZone". */
+    get timeZones(): VCard.TimeZone[];
+    /** An array of all children of type "GeoLocation". */
+    get geoLocations(): VCard.GeoLocation[];
+    /** An array of all children of type "Title". */
+    get titles(): VCard.Title[];
+    /** An array of all children of type "Role". */
+    get roles(): VCard.Role[];
+    /** An array of all children of type "Logo". */
+    get logos(): VCard.Logo[];
+    /** An array of all children of type "Agent". */
+    get agents(): VCard.Agent[];
+    /** An array of all children of type "Organisation". */
+    get organisations(): VCard.Organisation[];
+    /** An array of all children of type "Member". */
+    get members(): VCard.Member[];
+    /** An array of all children of type "Related". */
+    get relateds(): VCard.Related[];
+    /** An array of all children of type "Categories". */
+    get categorieses(): VCard.Categories[];
+    /** An array of all children of type "Note". */
+    get notes(): VCard.Note[];
     /** The child document of type "ProductId". */
     get productId(): VCard.ProductId | undefined;
     /** The child document of type "Revision". */
     get revision(): VCard.Revision | undefined;
-    /** The child document of type "Sound". */
-    get sound(): VCard.Sound | undefined;
+    /** An array of all children of type "Sound". */
+    get sounds(): VCard.Sound[];
     /** The child document of type "UID". */
     get uid(): VCard.UID | undefined;
-    /** The child document of type "ClientPIDMap". */
-    get clientPIDMap(): VCard.ClientPIDMap | undefined;
-    /** The child document of type "URL". */
-    get url(): VCard.URL | undefined;
-    /** The child document of type "PublicKey". */
-    get publicKey(): VCard.PublicKey | undefined;
-    /** The child document of type "BusyTimeURL". */
-    get busyTimeURL(): VCard.BusyTimeURL | undefined;
-    /** The child document of type "CalendarURIForRequests". */
-    get calendarURIForRequests(): VCard.CalendarURIForRequests | undefined;
-    /** The child document of type "CalendarURI". */
-    get calendarURI(): VCard.CalendarURI | undefined;
+    /** An array of all children of type "ClientPIDMap". */
+    get clientPIDMaps(): VCard.ClientPIDMap[];
+    /** An array of all children of type "URL". */
+    get urls(): VCard.URL[];
+    /** An array of all children of type "PublicKey". */
+    get publicKeys(): VCard.PublicKey[];
+    /** An array of all children of type "BusyTimeURL". */
+    get busyTimeURLS(): VCard.BusyTimeURL[];
+    /** An array of all children of type "CalendarURIForRequests". */
+    get calendarURIForRequestss(): VCard.CalendarURIForRequests[];
+    /** An array of all children of type "CalendarURI". */
+    get calendarURwe(): VCard.CalendarURI[];
+    /** The child document of type "SortString". */
+    get sortString(): VCard.SortString | undefined;
+    /** The child document of type "Classification". */
+    get classification(): VCard.Classification | undefined;
     /** An array of all children of type "Custom". */
     get customs(): VCard.Custom[];
 }
@@ -665,8 +677,8 @@ export declare namespace VCard {
         constructor(document: GenericDocument);
         requiredDocumentType(): string;
     }
-    /** First Name */
-    class FirstName extends Entry {
+    /** Formatted Name */
+    class FormattedName extends Entry {
         constructor(document: GenericDocument);
         requiredDocumentType(): string;
     }
@@ -695,6 +707,11 @@ export declare namespace VCard {
         constructor(document: GenericDocument);
         requiredDocumentType(): string;
     }
+    /** Label */
+    class Label extends Entry {
+        constructor(document: GenericDocument);
+        requiredDocumentType(): string;
+    }
     /** Photo */
     class Photo extends Entry {
         constructor(document: GenericDocument);
@@ -745,6 +762,11 @@ export declare namespace VCard {
         constructor(document: GenericDocument);
         requiredDocumentType(): string;
     }
+    /** Agent */
+    class Agent extends Entry {
+        constructor(document: GenericDocument);
+        requiredDocumentType(): string;
+    }
     /** Organisation */
     class Organisation extends Entry {
         constructor(document: GenericDocument);
@@ -820,6 +842,16 @@ export declare namespace VCard {
         constructor(document: GenericDocument);
         requiredDocumentType(): string;
     }
+    /** Sort String */
+    class SortString extends Entry {
+        constructor(document: GenericDocument);
+        requiredDocumentType(): string;
+    }
+    /** Classification */
+    class Classification extends Entry {
+        constructor(document: GenericDocument);
+        requiredDocumentType(): string;
+    }
     /** Custom */
     class Custom extends Entry {
         constructor(document: GenericDocument);

package/@types/core/compiled/BarcodeDocumentTypes.d.ts

@@ -1,5 +1,5 @@
 import { BarcodeFormat } from "./BarcodeTypes";
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 import { GenericDocument } from "./GenericDocument";
 /**
 Type of barcode document format used.
@@ -30,7 +30,7 @@ export declare const BarcodeDocumentFormatValues: BarcodeDocumentFormat[];
 /**
 Barcode document formats.
 */
-export declare class BarcodeDocumentFormats extends PartiallyConstructible {
+export declare class BarcodeDocumentFormats {
     /** @param source {@displayType `DeepPartial<BarcodeDocumentFormats>`} */
     constructor(source?: DeepPartial<BarcodeDocumentFormats>);
 }
@@ -62,7 +62,7 @@ export declare namespace BarcodeDocumentFormats {
 /**
 The result of barcode document parsing.
 */
-export declare class BarcodeDocumentParserResult extends PartiallyConstructible {
+export declare class BarcodeDocumentParserResult {
     /**
     True if any document was parsed
     */

package/@types/core/compiled/BarcodeScannerTypes.d.ts

@@ -1,7 +1,7 @@
 import { BarcodeDocumentFormat } from "./BarcodeDocumentTypes";
 import { BarcodeFormatConfigurationBase } from "./BarcodeConfigurationTypes";
 import { BarcodeFormat } from "./BarcodeTypes";
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 import { GenericDocument } from "./GenericDocument";
 import { Image } from "./bridge/image";
 import { Point } from "./utils";
@@ -11,7 +11,7 @@ import { StructuredAppendInfo } from "./BarcodeTypes";
 /**
 A single barcode found in the input image. Barcodes with the same content but different locations in the image are considered separate barcodes.
 */
-export declare class BarcodeItem extends PartiallyConstructible {
+export declare class BarcodeItem {
     /**
     Text contained in the barcode. Binary data is returned in the rawBytes field only.
     */
@@ -48,6 +48,14 @@ export declare class BarcodeItem extends PartiallyConstructible {
     */
     readonly quadNormalized: Point[];
     /**
+    As quad, but extended to appropriate height for oned barcodes.
+    */
+    readonly extendedQuad: Point[];
+    /**
+    As quadNormalized, but extended to appropriate height for oned barcodes.
+    */
+    readonly extendedQuadNormalized: Point[];
+    /**
     True if this is a 1D barcode that is printed upside-down, that is, the barcode was scanned right-to-left.
     @defaultValue false;
     */
@@ -127,18 +135,18 @@ export declare const BarcodeAccumulationMethodValues: BarcodeAccumulationMethod[
 /**
 Configuration for how to accumulate results.
 */
-export declare class BarcodeAccumulationConfiguration extends PartiallyConstructible {
+export declare class BarcodeAccumulationConfiguration {
     /**
     In case that ean/upc both with and without extensions are allowed,
     we require confirmations to consider a standalone EAN or UPC (i.e. without extension) as valid.
-    @defaultValue 2;
+    @defaultValue 1;
     */
     minConfirmationsStandaloneEAN: number;
     /**
-    Maximum number of accumulated frames to inspect to verify a scan result.
-    @defaultValue 5;
+    The time in milliseconds to accumulate barcodes across multiple frames.
+    @defaultValue 500;
     */
-    maximumNumberOfAccumulatedFrames: number;
+    accumulationTime: number;
     /**
     If true, the results from previous frames that are not connected to results on the current frame will be removed.
     This is should be enabled when large camera movements are expected.
@@ -157,7 +165,7 @@ export declare class BarcodeAccumulationConfiguration extends PartiallyConstruct
 /**
 Configuration for the barcode scanner.
 */
-export declare class BarcodeScannerConfiguration extends PartiallyConstructible {
+export declare class BarcodeScannerConfiguration {
     /**
     Options for barcode decoding.
     @defaultValue [new BarcodeFormatCommonConfiguration({})];
@@ -212,7 +220,7 @@ export declare class BarcodeScannerConfiguration extends PartiallyConstructible
 /**
 The result of barcode scanning.
 */
-export declare class BarcodeScannerResult extends PartiallyConstructible {
+export declare class BarcodeScannerResult {
     /**
     List of found barcodes
     */

package/@types/core/compiled/BarcodeTypes.d.ts

@@ -1,4 +1,4 @@
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 /**
 Enumerates character encodings.
 
@@ -76,7 +76,7 @@ export declare const CharacterEncodingValues: CharacterEncoding[];
 /**
 A character encoding for a given range of bytes.
 */
-export declare class RangeEncoding extends PartiallyConstructible {
+export declare class RangeEncoding {
     /**
     Start index of the range.
     */
@@ -95,7 +95,7 @@ export declare class RangeEncoding extends PartiallyConstructible {
 /**
 The structured append mode can be used to split a message across multiple barcodes.
 */
-export declare class StructuredAppendInfo extends PartiallyConstructible {
+export declare class StructuredAppendInfo {
     /**
     The number of barcodes in the structured append set.
     */
@@ -194,7 +194,7 @@ export declare const BarcodeFormatValues: BarcodeFormat[];
 /**
 Lists of barcode formats to decode.
 */
-export declare class BarcodeFormats extends PartiallyConstructible {
+export declare class BarcodeFormats {
     /** @param source {@displayType `DeepPartial<BarcodeFormats>`} */
     constructor(source?: DeepPartial<BarcodeFormats>);
 }

package/@types/core/compiled/CheckScannerTypes.d.ts

@@ -1,4 +1,4 @@
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 import { DocumentDetectionResult } from "./DocumentScannerTypes";
 import { GenericDocument } from "./GenericDocument";
 import { Image } from "./bridge/image";
@@ -30,7 +30,7 @@ export declare const CheckMagneticInkStripScanningStatusValues: CheckMagneticInk
 /**
 The result of check scanning.
 */
-export declare class CheckScanningResult extends PartiallyConstructible {
+export declare class CheckScanningResult {
     /**
     Magnetic ink strip scanning status.
     @defaultValue "ERROR_NOTHING_FOUND";
@@ -46,6 +46,7 @@ export declare class CheckScanningResult extends PartiallyConstructible {
     readonly documentDetectionResult: DocumentDetectionResult | null;
     /**
     Crop of the check if documentDetectionMode is set to DETECT_AND_CROP_DOCUMENT. Will be non-empty, only if check recognition succeeded.
+    @defaultValue null;
     */
     readonly croppedImage: Image | null;
     /** @param source {@displayType `DeepPartial<CheckScanningResult>`} */
@@ -54,12 +55,14 @@ export declare class CheckScanningResult extends PartiallyConstructible {
 /**
 Configuration of the check scanner.
 */
-export declare class CheckScannerConfiguration extends PartiallyConstructible {
+export declare class CheckScannerConfiguration {
     /**
     Document detection to be performed in addition to scanning the machine-readable data in the check.
     
     By default only the machine-readable data is extracted during check scanning. Optionally, the coordinates and a crop of the entire check document can be returned, in addition to the check data.
     A check scan result may still be successful even if the whole document is not visible in the input image and the complete document could not be located.
+    
+    If cropping is enabled, check recognition will be performed on the cropped image of the check, which may improve recognition results.
     @defaultValue "DISABLED";
     */
     documentDetectionMode: CheckDocumentDetectionMode;

package/@types/core/compiled/CreditCardTypes.d.ts

@@ -1,4 +1,4 @@
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 import { DocumentDetectionStatus } from "./DocumentScannerTypes";
 import { GenericDocument } from "./GenericDocument";
 import { Point } from "./utils";
@@ -19,7 +19,7 @@ export declare const CreditCardScanningStatusValues: CreditCardScanningStatus[];
 /**
 Contains the result of running the credit card scanner.
 */
-export declare class CreditCardScanningResult extends PartiallyConstructible {
+export declare class CreditCardScanningResult {
     /**
     The status of the credit card detection step
     */
@@ -46,7 +46,7 @@ export declare class CreditCardScanningResult extends PartiallyConstructible {
 /**
 Configuration for the credit card scanner.
 */
-export declare class CreditCardScannerConfiguration extends PartiallyConstructible {
+export declare class CreditCardScannerConfiguration {
     /**
     If true, the document detector will be used to find where the credit card is in the input image.
     If false, the scanner will assume that the credit card has been pre-cropped and takes the entirety of the input image.

package/@types/core/compiled/DocumentClassifierTypes.d.ts

@@ -0,0 +1,65 @@
+import { DeepPartial } from "./utils";
+import { DocumentScanningResult } from "./DocumentScannerTypes";
+/**
+Configuration for the document classifier.
+*/
+export declare class DocumentClassifierConfiguration {
+    /**
+    If true, image will be scanned for a valid document first.
+    @defaultValue true;
+    */
+    readonly crop: boolean;
+    /** @param source {@displayType `DeepPartial<DocumentClassifierConfiguration>`} */
+    constructor(source?: DeepPartial<DocumentClassifierConfiguration>);
+}
+/**
+The status of the classification result.
+
+- `SUCCESS`:
+   The document was classified successfully.
+- `FAILURE_SCANNING`:
+   No document was detected.
+*/
+export type DocumentClassifierStatus = "SUCCESS" | "FAILURE_SCANNING";
+export declare const DocumentClassifierStatusValues: DocumentClassifierStatus[];
+/**
+The type of the document.
+
+- `UNKNOWN`:
+   The document type is unknown.
+- `BILL_OF_LADING`:
+   Bill of lading.
+- `PAY_SHEET`:
+   Pay sheet.
+- `SCALE_TICKET`:
+   Scale ticket.
+- `TOLL_RECEIPT`:
+   Toll receipt.
+- `WASH_RECEIPT`:
+   Wash receipt.
+*/
+export type DocumentType = "UNKNOWN" | "BILL_OF_LADING" | "PAY_SHEET" | "SCALE_TICKET" | "TOLL_RECEIPT" | "WASH_RECEIPT";
+export declare const DocumentTypeValues: DocumentType[];
+/**
+Contains the result of running the document classifier.
+*/
+export declare class DocumentClassifierResult {
+    /**
+    The classification result.
+    */
+    readonly documentType: DocumentType;
+    /**
+    The confidence of the classification result.
+    */
+    readonly confidence: number;
+    /**
+    The status of the classification result.
+    */
+    readonly status: DocumentClassifierStatus;
+    /**
+    The result of the document scanning.
+    */
+    readonly documentScanningResult: DocumentScanningResult;
+    /** @param source {@displayType `DeepPartial<DocumentClassifierResult>`} */
+    constructor(source?: DeepPartial<DocumentClassifierResult>);
+}

package/@types/core/compiled/DocumentDataExtractorConfigurationTypes.d.ts

@@ -1,4 +1,4 @@
-import { DeepPartial, PartiallyConstructible } from "./utils";
+import { DeepPartial } from "./utils";
 import { MrzDocumentType } from "./MrzTypes";
 /**
 Base class for all generic document configuration elements.
@@ -16,7 +16,7 @@ Date validation configuration.
 This configuration element does not enable the scanning of any document types by itself.
 Add to recognizer configuration to require date validation checks for specific document types.
 */
-export declare class DateValidationConfiguration extends PartiallyConstructible {
+export declare class DateValidationConfiguration {
     readonly _type: "DateValidationConfiguration";
     /**
     Minimum year that is considered valid.
@@ -40,7 +40,7 @@ German Address Field validation configuration.
 This configuration does not enable the scanning of any document types by itself.
 Add to recognizer configuration to require German Address validation checks for specific document types.
 */
-export declare class DeAddressParserConfiguration extends PartiallyConstructible {
+export declare class DeAddressParserConfiguration {
     readonly _type: "DeAddressParserConfiguration";
     /**
     List of generic document formats for which German Address validation has to be applied.
@@ -120,7 +120,7 @@ export declare const EuropeanHealthInsuranceCardIssuingCountryValues: EuropeanHe
 /**
 European Health Insurance Card (EHIC) configuration element. Add to extractor configuration to scan EHICs.
 */
-export declare class EuropeanHealthInsuranceCardConfiguration extends PartiallyConstructible {
+export declare class EuropeanHealthInsuranceCardConfiguration {
     readonly _type: "EuropeanHealthInsuranceCardConfiguration";
     /**
     If an expected country is selected, validation rules for the given country are used,
@@ -138,7 +138,7 @@ This configuration element does not enable the scanning of any document types by
 Add to extractor configuration to enable recognizing the MRZ only, specifically for documents that are otherwise not supported.
 Note that this may enable scanning of documents that were not enabled through the accepted document types.
 */
-export declare class MrzFallbackConfiguration extends PartiallyConstructible {
+export declare class MrzFallbackConfiguration {
     readonly _type: "MRZFallbackConfiguration";
     /**
     List of ISO 3166-1 alpha-3 country codes for which the MRZ fallback is enabled. (e.g. "DEU" for Germany).
@@ -158,7 +158,7 @@ Auto-focus configuration.
 The recognizer will ignore frames that are not focused. This option is enabled by default.
 This configuration has no effect in SINGLE_SHOT mode.
 */
-export declare class AutoFocusConfiguration extends PartiallyConstructible {
+export declare class AutoFocusConfiguration {
     readonly _type: "AutoFocusConfiguration";
     /**
     Sensitivity threshold for detecting that autofocus is in progress.
@@ -177,7 +177,7 @@ Glare detection configuration.
 The recognizer will detect whether fields are obstructed by glare. This feature is enabled by default.
 This configuration has no effect in SINGLE_SHOT mode.
 */
-export declare class GlareDetectionConfiguration extends PartiallyConstructible {
+export declare class GlareDetectionConfiguration {
     readonly _type: "GlareDetectionConfiguration";
     /**
     Glare detection threshold.
@@ -194,7 +194,7 @@ export declare class GlareDetectionConfiguration extends PartiallyConstructible
 Convenience configuration element for enabling the scanning of multiple document types with a common configuration.
 Add to extractor configuration to enable the scanning of multiple document types.
 */
-export declare class DocumentDataExtractorCommonConfiguration extends PartiallyConstructible {
+export declare class DocumentDataExtractorCommonConfiguration {
     readonly _type: "DocumentDataExtractorCommonConfiguration";
     /**
     List of document types to scan. By default, the list is empty.