@progress/kendo-spreadsheet-common 1.1.3-develop.1 → 1.1.3-develop.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@progress/kendo-spreadsheet-common",
   "description": "Kendo UI platform-independent Spreadsheet library",
-  "version": "1.1.3-develop.1",
+  "version": "1.1.3-develop.2",
   "keywords": [
     "Kendo UI"
   ],

package/src/index.d.ts

@@ -745,8 +745,10 @@ export class SpreadsheetWidget {
      * Clears the Spreadsheet and populates it with data from the specified Excel (.xlsx) file.
      *
      * @param blob The file or blob that is usually obtained through a file input.
+     * 
+     * @returns A promise that will be resolved when the file is loaded and the data is populated.
      */
-    fromFile(file: File | Blob): void;
+    fromFile(file: File | Blob): Promise<void>;
 
     /**
      * Initiates the Excel export. Also fires the excelExport event.
@@ -1014,3 +1016,59 @@ export function defineFunction(name: string, func: Function): {
  * Defines alias of a formula.
  */
 export function defineAlias(alias: string, name: string): void;
+
+/**
+ * Deferred class similar to jQuery's Deferred.
+ */
+export class Deferred<T = any, N = any> {
+    /**
+     * Creates a new Deferred object.
+     */
+    constructor();
+
+    /**
+     * Resolves the Deferred object and calls any done callbacks with the given value.
+     * @param value The value to resolve the promise with.
+     * @returns The Deferred object.
+     */
+    resolve(value?: T): this;
+
+    /**
+     * Rejects the Deferred object and calls any fail callbacks with the given reason.
+     * @param reason The reason for rejecting the promise.
+     * @returns The Deferred object.
+     */
+    reject(reason?: any): this;
+
+    /**
+     * Notifies progress callbacks with the given value.
+     * @param value The value to pass to the progress callbacks.
+     */
+    notify(value?: N): void;
+
+    /**
+     * Adds a handler to be called when the Deferred object is notified of progress.
+     * @param callback A function to call when progress is notified.
+     * @returns The Deferred object.
+     */
+    progress(callback: (value?: N) => void): this;
+
+    /**
+     * Attaches callbacks for the resolution, rejection, and progress of the Promise.
+     * @param onFulfilled The callback to execute when the Promise is resolved.
+     * @param onRejected The callback to execute when the Promise is rejected.
+     * @param onProgress The callback to execute when the Promise reports progress.
+     * @returns A Promise for the completion of which ever callback is executed.
+     */
+    then<TResult1 = T, TResult2 = never>(
+        onFulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,
+        onRejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null,
+        onProgress?: (value?: N) => void
+    ): Promise<TResult1 | TResult2>;
+
+    /**
+     * Returns the underlying Promise object.
+     * @returns The Promise object.
+     */
+    promise(): Promise<T>;
+}