lucid-extension-sdk 0.0.205 → 0.0.207

package/core/defer.d.ts

@@ -0,0 +1,6 @@
+export interface DeferredPromise<T> extends Promise<T> {
+    resolve: (p1: T) => any;
+    reject: (p1?: any) => any;
+    promise: Promise<T>;
+}
+export declare function defer<T = void>(): DeferredPromise<T>;

package/core/defer.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defer = void 0;
+function checkPromiseExists() {
+    if (typeof Promise !== 'function') {
+        throw new Error('No promise library available');
+    }
+}
+function defer() {
+    checkPromiseExists();
+    let resolve = undefined;
+    let reject = undefined;
+    const promise = new Promise((resolveLocal, rejectLocal) => {
+        resolve = resolveLocal;
+        reject = rejectLocal;
+    });
+    if (!resolve || !reject) {
+        throw new Error('Promise constructor does not provide proper arguments to callback');
+    }
+    return {
+        resolve: resolve,
+        reject: reject,
+        promise: promise,
+        then: promise.then.bind(promise),
+        catch: promise.catch.bind(promise),
+        finally: promise.finally.bind(promise),
+        [Symbol.toStringTag]: promise[Symbol.toStringTag],
+    };
+}
+exports.defer = defer;

package/document/imagedefinition.d.ts

@@ -1,4 +1,5 @@
 import { SimpleImageFill } from '../core/properties/fillcolor';
+import { StrokeStyle } from '../core/properties/strokestyle';
 import { Box } from '../math';
 /**
  * The information required to create a new image block on the current document
@@ -12,4 +13,28 @@ export interface ImageDefinition {
      * Settings for using an image as the fill style of a block.
      */
     fillStyle: SimpleImageFill;
+    /**
+     * The opacity (0 - 1) for this image (default is 1).
+     */
+    opacity?: number;
+    /**
+     * the border color for this image (default is black, #000000).
+     */
+    lineColor?: string;
+    /**
+     * The border width in pixels for this image (default is 1).
+     */
+    lineWidth?: number;
+    /**
+     * The stroke style for the border of this image (default is Solid).
+     */
+    strokeStyle?: StrokeStyle;
+    /**
+     * The rounding for this image (default is 0).
+     */
+    rounding?: number;
+    /**
+     * The rotation for this image (deafult is 0).
+     */
+    rotation?: number;
 }

package/document/pageproxy.d.ts

@@ -69,15 +69,15 @@ export declare class PageProxy extends ElementProxy {
      */
     addBlock(def: BlockDefinition): BlockProxy;
     /**
-     * Add a new line to this page
+     * Add a new line to this page.
      * @param def The definition of the new line to add
      * @returns The added line
      */
     addLine(def: LineDefinition): LineProxy;
     /**
-     * Add a new image to this page
+     * Add a new image to this page.
      * @param def The definition of the new image to add
-     * @returns The added image block
+     * @returns The added image
      */
     addImage(def: ImageDefinition): Promise<BlockProxy>;
     /**

package/document/pageproxy.js

@@ -100,7 +100,7 @@ class PageProxy extends elementproxy_1.ElementProxy {
         return block;
     }
     /**
-     * Add a new line to this page
+     * Add a new line to this page.
      * @param def The definition of the new line to add
      * @returns The added line
      */
@@ -114,13 +114,25 @@ class PageProxy extends elementproxy_1.ElementProxy {
         return line;
     }
     /**
-     * Add a new image to this page
+     * Add a new image to this page.
      * @param def The definition of the new image to add
-     * @returns The added image block
+     * @returns The added image
      */
     async addImage(def) {
         await this.client.loadBlockClasses(['UserImage2Block']);
-        return this.addBlock(Object.assign({ className: 'UserImage2Block' }, def));
+        return this.addBlock({
+            className: 'UserImage2Block',
+            boundingBox: def.boundingBox,
+            fillStyle: def.fillStyle,
+            properties: {
+                opactiy: def.opacity,
+                lineColor: def.lineColor,
+                lineWidth: def.lineWidth,
+                strokeStyle: def.strokeStyle,
+                rounding: def.rounding,
+                rotation: def.rotation,
+            },
+        });
     }
     /**
      * Updates the page of this page

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lucid-extension-sdk",
-    "version": "0.0.205",
+    "version": "0.0.207",
     "description": "Utility classes for writing Lucid Software editor extensions",
     "main": "index.js",
     "types": "index.d.ts",

package/ui/iframeui.d.ts

@@ -25,6 +25,7 @@ export declare abstract class IframeUI {
     protected messageActionName: string;
     /** True after the iframe has fired an onload event (not all scripts are necessarily finished executing) */
     protected loaded: boolean;
+    private frameLoadedPromise;
     /**
      * The location of this frame within the top-level browser window. This is always updated immediately before
      * `messageFromFrame` is called.
@@ -52,7 +53,7 @@ export declare abstract class IframeUI {
      * Send a message to this UI component's iframe via window.postMessage.
      * @param data Data to send to the iframe
      */
-    sendMessage(data: JsonSerializable): void;
+    sendMessage(data: JsonSerializable): Promise<void>;
     /**
      * Receives messages sent from the iframe via parent.postMessage(<data>, '*')
      * @param message data sent from the iframe

package/ui/iframeui.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IframeUI = exports.IncomingUIMessageType = void 0;
+const defer_1 = require("../core/defer");
 /** @ignore */
 var IncomingUIMessageType;
 (function (IncomingUIMessageType) {
@@ -20,6 +21,7 @@ class IframeUI {
         this.messageActionName = IframeUI.uiMessageActionNamePrefix + this.id;
         /** True after the iframe has fired an onload event (not all scripts are necessarily finished executing) */
         this.loaded = false;
+        this.frameLoadedPromise = (0, defer_1.defer)();
         /**
          * The location of this frame within the top-level browser window. This is always updated immediately before
          * `messageFromFrame` is called.
@@ -50,6 +52,7 @@ class IframeUI {
                     break;
                 case IncomingUIMessageType.FrameLoaded:
                     this.loaded = true;
+                    this.frameLoadedPromise.resolve();
                     this.frameLoaded();
                     break;
             }
@@ -65,13 +68,12 @@ class IframeUI {
      * Send a message to this UI component's iframe via window.postMessage.
      * @param data Data to send to the iframe
      */
-    sendMessage(data) {
-        if (this.loaded) {
-            this.client.sendCommand("suim" /* CommandName.SendUIMessage */, {
-                'n': this.messageActionName,
-                'd': data,
-            });
-        }
+    async sendMessage(data) {
+        await this.frameLoadedPromise;
+        this.client.sendCommand("suim" /* CommandName.SendUIMessage */, {
+            'n': this.messageActionName,
+            'd': data,
+        });
     }
     /**
      * Receives messages sent from the iframe via parent.postMessage(<data>, '*')