lucid-extension-sdk 0.0.13 → 0.0.19

package/package.json

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

package/sdk/commandtypes.d.ts

@@ -20,13 +20,16 @@ export declare const enum CommandName {
     AddLineTextArea = "alta",
     AddMenuItem = "ami",
     AddShapeData = "asd",
+    Alert = "a",
     AnimateViewport = "av",
     Bootstrap = "b",
+    Confirm = "c",
     CreateBlock = "cb",
     CreateCollection = "cc",
     CreateDataSource = "cds",
     CreateLine = "cl",
     CreatePage = "cp",
+    DataAction = "da",
     DeleteItem = "di",
     DeletePage = "dp",
     DeleteShapeData = "dsd",
@@ -78,10 +81,13 @@ export declare const enum CommandName {
     ShowModal = "sm",
     ShowPanel = "spn",
     SleepForTestCase = "sleep",
+    ThrowForTestCase = "throw",
     UnhookCreateItems = "uci",
     UnhookSelection = "us",
     UnhookTextEdit = "ute"
 }
+/** @ignore */
+export declare const commandTitles: Map<CommandName, string>;
 /**
  * This is a type declaration whose purpose is to allow TypeScript to enforce the correct parameter and
  * return types from [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand) based on
@@ -100,6 +106,10 @@ export declare type CommandArgs = {
         query: AddShapeDataQuery;
         result: AddShapeDataResult;
     };
+    [CommandName.Alert]: {
+        query: AlertQuery;
+        result: AlertResult;
+    };
     [CommandName.AnimateViewport]: {
         query: AnimateViewportQuery;
         result: AnimateViewportResult;
@@ -108,6 +118,10 @@ export declare type CommandArgs = {
         query: BootstrapQuery;
         result: BootstrapResult;
     };
+    [CommandName.Confirm]: {
+        query: ConfirmQuery;
+        result: ConfirmResult;
+    };
     [CommandName.CreateBlock]: {
         query: CreateBlockQuery;
         result: CreateBlockResult;
@@ -128,6 +142,10 @@ export declare type CommandArgs = {
         query: CreatePageQuery;
         result: CreatePageResult;
     };
+    [CommandName.DataAction]: {
+        query: DataActionQuery;
+        result: DataActionResult;
+    };
     [CommandName.DeleteItem]: {
         query: DeleteItemQuery;
         result: DeleteItemResult;
@@ -332,6 +350,10 @@ export declare type CommandArgs = {
         query: SleepForTestCaseQuery;
         result: SleepForTestCaseResult;
     };
+    [CommandName.ThrowForTestCase]: {
+        query: ThrowForTestCaseQuery;
+        result: ThrowForTestCaseResult;
+    };
     [CommandName.UnhookCreateItems]: {
         query: UnhookCreateItemsQuery;
         result: UnhookCreateItemsResult;
@@ -361,7 +383,7 @@ export declare type AddMenuItemQuery = {
     /** Label to display on the menu item */
     'l': string;
     /** Named action to run when the menu item is clicked */
-    'a': string;
+    'a'?: string;
     /** Named action that returns whether the menu item should be visible */
     'v'?: string;
     /** Named action that returns whether the menu item should be disabled */
@@ -370,6 +392,17 @@ export declare type AddMenuItemQuery = {
     't': MenuType;
     /** If specified, where to place the menu item; defaults to MenuLocation.Extension */
     'loc'?: MenuLocation;
+    /** If specified, this menu item should launch a file picker */
+    'f'?: {
+        /** Action to call when files are selected */
+        'a': string;
+        /** File types to accept */
+        'ac': string;
+        /** Single file only */
+        's'?: boolean;
+        /** Return content in a binary ArrayBuffer instead of as text */
+        'b'?: boolean;
+    };
 };
 export declare type AddMenuItemResult = undefined;
 export declare type AddShapeDataQuery = {
@@ -383,6 +416,16 @@ export declare type AddShapeDataQuery = {
     'v'?: SerializedFieldType;
 };
 export declare type AddShapeDataResult = undefined;
+export declare type AlertQuery = {
+    /** Title; defaults to extension title */
+    't'?: string;
+    /** Body text */
+    'b': string;
+    /** Button text; defaults to i18n'ed "OK" */
+    'bt'?: string;
+};
+/** True if they click OK, false otherwise */
+export declare type AlertResult = Promise<boolean>;
 export declare type BootstrapQuery = {
     /**
      * Named action that accepts the bootstrap data, and which may return a Promise or void. After awaiting\
@@ -391,6 +434,18 @@ export declare type BootstrapQuery = {
     'c': string;
 };
 export declare type BootstrapResult = Promise<void>;
+export declare type ConfirmQuery = {
+    /** Title; defaults to extension title */
+    't'?: string;
+    /** Body text */
+    'b': string;
+    /** OK button text; defaults to i18n'ed "OK" */
+    'o'?: string;
+    /** Cancel button text; defaults to i18n'ed "Cancel" */
+    'c'?: string;
+};
+/** True if they click OK, false otherwise */
+export declare type ConfirmResult = Promise<boolean>;
 export declare type CreateBlockQuery = {
     /**
      * By default, we add the block to the current page & currently active group. If specified, the
@@ -439,6 +494,29 @@ export declare type CreateLineQuery = {
 export declare type CreateLineResult = string;
 export declare type CreatePageQuery = void;
 export declare type CreatePageResult = string;
+export declare type DataActionQuery = {
+    /** Flow Name */
+    'fn': string;
+    /** Is Async */
+    'a': boolean;
+    /** Flow Data */
+    'fd'?: unknown;
+    /** Sync data source ID Nonce */
+    's'?: string;
+    /** Data Connector Name */
+    'n': string;
+};
+export declare type RawDataActionResult = {
+    /** The external service responded with this code */
+    'c': number;
+} & ({
+    /** And this text */
+    't': string;
+} | {
+    /** Or this JSON */
+    'j': unknown;
+});
+export declare type DataActionResult = Promise<RawDataActionResult>;
 export declare type DeleteItemQuery = string;
 export declare type DeleteItemResult = boolean;
 export declare type DeletePageQuery = string;
@@ -752,6 +830,8 @@ export declare type ShowPanelQuery = {
 export declare type ShowPanelResult = undefined;
 export declare type SleepForTestCaseQuery = number;
 export declare type SleepForTestCaseResult = Promise<void>;
+export declare type ThrowForTestCaseQuery = number;
+export declare type ThrowForTestCaseResult = undefined | Promise<void>;
 export declare type UnhookCreateItemsQuery = {
     /** Name of the action passed to HookCreateItems */
     'n': string;

package/sdk/commandtypes.js

@@ -1,7 +1,77 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRawSendXHRResponse = void 0;
+exports.isRawSendXHRResponse = exports.commandTitles = void 0;
 const checks_1 = require("./core/checks");
+/** @ignore */
+exports.commandTitles = new Map([
+    ["alta" /* AddLineTextArea */, 'AddLineTextArea'],
+    ["ami" /* AddMenuItem */, 'AddMenuItem'],
+    ["asd" /* AddShapeData */, 'AddShapeData'],
+    ["a" /* Alert */, 'Alert'],
+    ["av" /* AnimateViewport */, 'AnimateViewport'],
+    ["b" /* Bootstrap */, 'Bootstrap'],
+    ["c" /* Confirm */, 'Confirm'],
+    ["cb" /* CreateBlock */, 'CreateBlock'],
+    ["cc" /* CreateCollection */, 'CreateCollection'],
+    ["cds" /* CreateDataSource */, 'CreateDataSource'],
+    ["cl" /* CreateLine */, 'CreateLine'],
+    ["cp" /* CreatePage */, 'CreatePage'],
+    ["di" /* DeleteItem */, 'DeleteItem'],
+    ["dp" /* DeletePage */, 'DeletePage'],
+    ["dsd" /* DeleteShapeData */, 'DeleteShapeData'],
+    ["d" /* Download */, 'Download'],
+    ["ee" /* ElementExists */, 'ElementExists'],
+    ["ef" /* ExecuteFormula */, 'ExecuteFormula'],
+    ["gcl" /* GetConnectedLines */, 'GetConnectedLines'],
+    ["gcp" /* GetCurrentPage */, 'GetCurrentPage'],
+    ["gcs" /* GetCustomShape */, 'GetCustomShape'],
+    ["gdif" /* GetDataItemField */, 'GetDataItemField'],
+    ["get" /* GetElementType */, 'GetElementType'],
+    ["gip" /* GetItemPageId */, 'GetItemPageId'],
+    ["gp" /* GetProperty */, 'GetProperty'],
+    ["grk" /* GetReferenceKey */, 'GetReferenceKey'],
+    ["grlp" /* GetRelativeLinePosition */, 'GetRelativeLinePosition'],
+    ["gs" /* GetSelection */, 'GetSelection'],
+    ["gsd" /* GetShapeData */, 'GetShapeData'],
+    ["hm" /* HideModal */, 'HideModal'],
+    ["hp" /* HidePanel */, 'HidePanel'],
+    ["hci" /* HookCreateItems */, 'HookCreateItems'],
+    ["hs" /* HookSelection */, 'HookSelection'],
+    ["hte" /* HookTextEdit */, 'HookTextEdit'],
+    ["k" /* KillExtension */, 'KillExtension'],
+    ["lb" /* ListBlocks */, 'ListBlocks'],
+    ["lcf" /* ListCollectionFields */, 'ListCollectionFields'],
+    ["lc" /* ListCollections */, 'ListCollections'],
+    ["ldi" /* ListDataItems */, 'ListDataItems'],
+    ["lds" /* ListDataSources */, 'ListDataSources'],
+    ["lg" /* ListGroups */, 'ListGroups'],
+    ["ll" /* ListLines */, 'ListLines'],
+    ["lp" /* ListPages */, 'ListPages'],
+    ["lpr" /* ListProperties */, 'ListProperties'],
+    ["lrk" /* ListReferenceKeys */, 'ListReferenceKeys'],
+    ["lsd" /* ListShapeData */, 'ListShapeData'],
+    ["lta" /* ListTextAreas */, 'ListTextAreas'],
+    ["lbc" /* LoadBlockClasses */, 'LoadBlockClasses'],
+    ["log" /* LogForTestCase */, 'LogForTestCase'],
+    ["oi" /* OffsetItems */, 'OffsetItems'],
+    ["pdi" /* PatchDataItems */, 'PatchDataItems'],
+    ["rp" /* RegisterPanel */, 'RegisterPanel'],
+    ["r" /* ReloadExtension */, 'ReloadExtension'],
+    ["oauth" /* SendOAuthRequest */, 'SendOAuthRequest'],
+    ["suim" /* SendUIMessage */, 'SendUIMessage'],
+    ["xhr" /* SendXHR */, 'SendXHR'],
+    ["scp" /* SetCurrentPage */, 'SetCurrentPage'],
+    ["sp" /* SetProperty */, 'SetProperty'],
+    ["srk" /* SetReferenceKey */, 'SetReferenceKey'],
+    ["ssd" /* SetShapeData */, 'SetShapeData'],
+    ["sm" /* ShowModal */, 'ShowModal'],
+    ["spn" /* ShowPanel */, 'ShowPanel'],
+    ["sleep" /* SleepForTestCase */, 'SleepForTestCase'],
+    ["throw" /* ThrowForTestCase */, 'ThrowForTestCase'],
+    ["uci" /* UnhookCreateItems */, 'UnhookCreateItems'],
+    ["us" /* UnhookSelection */, 'UnhookSelection'],
+    ["ute" /* UnhookTextEdit */, 'UnhookTextEdit'],
+]);
 function isRawSendXHRResponse(val) {
     return (0, checks_1.isString)(val['url']) && (0, checks_1.isString)(val['t']) && (0, checks_1.isNumber)(val['s']) && (0, checks_1.isObject)(val['h']);
 }

package/sdk/core/base64.d.ts

@@ -0,0 +1 @@
+export declare function decodeBase64(base64String: string): Uint8Array;

package/sdk/core/base64.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeBase64 = void 0;
+const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+//This gives a ~8x speedup vs. using alphabet.indexOf() in the main decode loop.
+const charCodeToEncodedInt = [];
+for (let i = 0; i < alphabet.length; i++) {
+    charCodeToEncodedInt[alphabet.charCodeAt(i)] = i;
+}
+function decodeBase64(base64String) {
+    //Filter out whitespace, etc
+    base64String = base64String.replace(/[^A-Za-z0-9\+\/\=]/g, '');
+    if (base64String.length % 4 !== 0) {
+        throw new Error('Invalid base64 input; length must be a multiple of 4');
+    }
+    //4 characters of input turns into 3 bytes of output
+    let bytes = (base64String.length / 4) * 3;
+    //But each trailing = (up to 2) is one fewer byte of output
+    if (base64String.endsWith('==')) {
+        bytes -= 2;
+    }
+    else if (base64String.endsWith('=')) {
+        bytes -= 1;
+    }
+    const output = new Uint8Array(bytes);
+    let inputIndex = 0;
+    for (let outputIndex = 0; outputIndex < bytes; outputIndex += 3) {
+        //Get the 4 numbers 0-63 encoded in the next 4 characters
+        const enc1 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc2 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc3 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc4 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        //Read 8 total bits into each of the output values. Skip one byte
+        //for each padding = at the end of the string
+        output[outputIndex] = (enc1 << 2) | (enc2 >> 4);
+        if (enc3 != 64) {
+            output[outputIndex + 1] = ((enc2 & 15) << 4) | (enc3 >> 2);
+        }
+        if (enc4 != 64) {
+            output[outputIndex + 2] = ((enc3 & 3) << 6) | enc4;
+        }
+    }
+    return output;
+}
+exports.decodeBase64 = decodeBase64;

package/sdk/core/data/serializedfield/serializedfielddefinition.d.ts

@@ -11,7 +11,8 @@ export declare enum FieldConstraintType {
     LOCKED = "locked",
     MIN_VALUE = "minValue",
     MAX_VALUE = "maxValue",
-    SINGLE_LINE_ONLY = "singleLineOnly"
+    SINGLE_LINE_ONLY = "singleLineOnly",
+    NO_WHITESPACE = "noWhitespace"
 }
 export declare type SerializedFieldConstraint = {
     'Type': FieldConstraintType;

package/sdk/core/data/serializedfield/serializedfielddefinition.js

@@ -9,4 +9,5 @@ var FieldConstraintType;
     FieldConstraintType["MIN_VALUE"] = "minValue";
     FieldConstraintType["MAX_VALUE"] = "maxValue";
     FieldConstraintType["SINGLE_LINE_ONLY"] = "singleLineOnly";
+    FieldConstraintType["NO_WHITESPACE"] = "noWhitespace";
 })(FieldConstraintType = exports.FieldConstraintType || (exports.FieldConstraintType = {}));

package/sdk/data/datasourceproxy.js

@@ -35,7 +35,9 @@ class DataSourceProxy extends propertystoreproxy_1.PropertyStoreProxy {
         return new collectionproxy_1.CollectionProxy(this.client.sendCommand("cc" /* CreateCollection */, {
             's': this.id,
             'n': name,
-            'f': schema.fields.map((field) => ({ 'n': field.name, 't': (0, fieldtypedefinition_1.serializeFieldTypeDefinition)(field.type) })),
+            'f': schema.fields.map((field) => {
+                return { 'n': field.name, 't': (0, fieldtypedefinition_1.serializeFieldTypeDefinition)(field.type) };
+            }),
             'p': schema.primaryKey,
         }), this.client);
     }

package/sdk/data/schemadefinition.js

@@ -5,10 +5,12 @@ const fieldtypedefinition_1 = require("../core/data/fieldtypedefinition/fieldtyp
 /** @ignore */
 function serializeSchemaDefinition(def) {
     return {
-        'Fields': def.fields.map((field) => ({
-            'Name': field.name,
-            'Type': (0, fieldtypedefinition_1.serializeFieldTypeDefinition)(field.type),
-        })),
+        'Fields': def.fields.map((field) => {
+            return {
+                'Name': field.name,
+                'Type': (0, fieldtypedefinition_1.serializeFieldTypeDefinition)(field.type),
+            };
+        }),
         'PrimaryKey': def.primaryKey,
     };
 }
@@ -16,10 +18,12 @@ exports.serializeSchemaDefinition = serializeSchemaDefinition;
 /** @ignore */
 function parseSchemaDefinition(def) {
     return {
-        fields: def['Fields'].map((field) => ({
-            name: field['Name'],
-            type: (0, fieldtypedefinition_1.deserializeFieldTypeDefinition)(field['Type']),
-        })),
+        fields: def['Fields'].map((field) => {
+            return {
+                name: field['Name'],
+                type: (0, fieldtypedefinition_1.deserializeFieldTypeDefinition)(field['Type']),
+            };
+        }),
         primaryKey: def['PrimaryKey'],
     };
 }

package/sdk/editorclient.d.ts

@@ -6,6 +6,7 @@ import { ElementProxy } from './document/elementproxy';
 import { GroupProxy } from './document/groupproxy';
 import { LineProxy } from './document/lineproxy';
 import { PageProxy } from './document/pageproxy';
+import { FileUploadData } from './ui/menu';
 export interface XHRRequest {
     /** URL to request */
     url: string;
@@ -34,6 +35,16 @@ export interface XHRResponse {
     /** True if this request failed due to a timeout */
     timeout?: boolean;
 }
+export declare type DataActionResult = {
+    /** The HTTP Status Code from the Extension Data Sync endpoint */
+    'status': number;
+} & ({
+    /** The body of the HTTP Response (if Content-Type: application/json) */
+    'json': unknown;
+} | {
+    /** The body of the HTTP Response (otherwise) */
+    'text': string;
+});
 export declare class EditorClient {
     private nextId;
     private readonly callbacks;
@@ -54,6 +65,17 @@ export declare class EditorClient {
      * @param base64 If true, base64 decode the data before downloading it
      */
     download(filename: string, data: string, mime: string, base64: boolean): void;
+    /**
+     *
+     * @param flowName
+     * @param dataConnectorName
+     * @param syncDataSourceId
+     * @param flowData
+     * @param async
+     * @returns
+     * @throws A string with an error from the data sync server
+     */
+    performDataAction(flowName: string, dataConnectorName: string, syncDataSourceId?: undefined | string, flowData?: unknown, async?: boolean): Promise<DataActionResult>;
     /**
      * Make a network request
      * @param request Settings for the network request
@@ -77,6 +99,13 @@ export declare class EditorClient {
      * @param callback function to execute when this action is invoked
      */
     registerAction(name: string, callback: (value: any) => JsonSerializable | void | Promise<any>): void;
+    /**
+     * Register a named action that receives file upload data. These callbacks can be used in
+     * Menu.addMenuItem as the file action.
+     * @param name The name of the action
+     * @param callback Function to execute when this action is invoked
+     */
+    registerFileUploadAction(name: string, callback: (files: FileUploadData[]) => void): void;
     /**
      * Remove the callback for a given action. If the action is later invoked, nothing will happen.
      * @param name name of the action to unregister
@@ -179,5 +208,22 @@ export declare class EditorClient {
      * @hidden
      */
     protected listenToEditor(): void;
+    /**
+     * Display an alert modal to the user
+     * @param text Body text to display in the alert modal
+     * @param title Title of the alert modal; defaults to the extension title specified in manifest.json
+     * @param buttonText Text for the OK button; defaults to "OK" (or a translation)
+     * @returns a Promise that resolves true if the user clicks OK, false if they otherwise dismiss the modal
+     */
+    alert(text: string, title?: string, buttonText?: string): import("./commandtypes").AlertResult;
+    /**
+     * Display a confirm modal to the user
+     * @param text Body text to display in the alert modal
+     * @param title Title of the alert modal; defaults to the extension title specified in manifest.json
+     * @param okText Text for the OK button; defaults to "OK" (or a translation)
+     * @param cancelText Text for the Cancel button; defaults to "Cancel" (or a translation)
+     * @returns a Promise that resolves true if the user clicks OK, false if they click Cancel or otherwise dismiss the modal
+     */
+    confirm(text: string, title?: string, okText?: string, cancelText?: string): import("./commandtypes").ConfirmResult;
     constructor();
 }

package/sdk/editorclient.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EditorClient = void 0;
 const commandtypes_1 = require("./commandtypes");
+const base64_1 = require("./core/base64");
 const blockproxyregistry_1 = require("./document/blockclasses/blockproxyregistry");
 const blockproxy_1 = require("./document/blockproxy");
 const documentproxy_1 = require("./document/documentproxy");
@@ -48,6 +49,35 @@ class EditorClient {
             'b64': base64,
         });
     }
+    /**
+     *
+     * @param flowName
+     * @param dataConnectorName
+     * @param syncDataSourceId
+     * @param flowData
+     * @param async
+     * @returns
+     * @throws A string with an error from the data sync server
+     */
+    async performDataAction(flowName, dataConnectorName, syncDataSourceId = undefined, flowData = undefined, async = true) {
+        const result = await this.sendCommand("da" /* DataAction */, {
+            'fn': flowName,
+            'a': async,
+            's': syncDataSourceId,
+            'fd': flowData,
+            'n': dataConnectorName,
+        });
+        if ('t' in result) {
+            return {
+                'status': result['c'],
+                'text': result['t'],
+            };
+        }
+        return {
+            'status': result['c'],
+            'json': result['j'],
+        };
+    }
     /**
      * Make a network request
      * @param request Settings for the network request
@@ -131,6 +161,24 @@ class EditorClient {
         }
         this.callbacks.set(name, callback);
     }
+    /**
+     * Register a named action that receives file upload data. These callbacks can be used in
+     * Menu.addMenuItem as the file action.
+     * @param name The name of the action
+     * @param callback Function to execute when this action is invoked
+     */
+    registerFileUploadAction(name, callback) {
+        this.registerAction(name, (msg) => {
+            callback(msg['f'].map((rawFile) => {
+                if (rawFile['b']) {
+                    return { fileName: rawFile['n'], text: rawFile['t'], binary: (0, base64_1.decodeBase64)(rawFile['b']) };
+                }
+                else {
+                    return { fileName: rawFile['n'], text: rawFile['t'] };
+                }
+            }));
+        });
+    }
     /**
      * Remove the callback for a given action. If the action is later invoked, nothing will happen.
      * @param name name of the action to unregister
@@ -310,5 +358,26 @@ class EditorClient {
             return (_a = this.callbacks.get(msg['id'])) === null || _a === void 0 ? void 0 : _a(msg);
         });
     }
+    /**
+     * Display an alert modal to the user
+     * @param text Body text to display in the alert modal
+     * @param title Title of the alert modal; defaults to the extension title specified in manifest.json
+     * @param buttonText Text for the OK button; defaults to "OK" (or a translation)
+     * @returns a Promise that resolves true if the user clicks OK, false if they otherwise dismiss the modal
+     */
+    alert(text, title, buttonText) {
+        return this.sendCommand("a" /* Alert */, { 't': title, 'b': text, 'bt': buttonText });
+    }
+    /**
+     * Display a confirm modal to the user
+     * @param text Body text to display in the alert modal
+     * @param title Title of the alert modal; defaults to the extension title specified in manifest.json
+     * @param okText Text for the OK button; defaults to "OK" (or a translation)
+     * @param cancelText Text for the Cancel button; defaults to "Cancel" (or a translation)
+     * @returns a Promise that resolves true if the user clicks OK, false if they click Cancel or otherwise dismiss the modal
+     */
+    confirm(text, title, okText, cancelText) {
+        return this.sendCommand("c" /* Confirm */, { 't': title, 'b': text, 'o': okText, 'c': cancelText });
+    }
 }
 exports.EditorClient = EditorClient;

package/sdk/ui/menu.d.ts

@@ -20,7 +20,7 @@ export interface CustomMenuItem {
     /** The text to display on the menu item */
     label: string;
     /** The registered action to run when the menu item is clicked */
-    action: string;
+    action?: string;
     /** If specified, what action's return value should determine if this menu item is visible? */
     visibleAction?: string;
     /** If specified, what action's return value should determine if this menu item is disabled? */
@@ -29,13 +29,30 @@ export interface CustomMenuItem {
     menuType: MenuType;
     /** Where in that menu to display this item */
     location?: MenuLocation;
+    /** If specified, this menu item should launch a file picker */
+    file?: {
+        /** An action registered with EditorClient.registerFileUploadAction */
+        action: string;
+        /** An [accept string](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept) as specified for HTML file inputs */
+        accept: string;
+        /** If true, only allow a single file to be selected for upload */
+        singleFileOnly?: boolean;
+        /** If true, send the file contents to the callback action as a Uint8Array as well as a plain text string */
+        binary?: boolean;
+    };
+}
+export interface FileUploadData {
+    fileName: string;
+    text: string;
+    binary?: Uint8Array;
 }
 export declare class Menu {
     private readonly client;
     constructor(client: EditorClient);
     /**
      * Add a new menu item to execute custom code. The action must be registered with
-     * EditorClient.registerAction prior to using it in the menu.
+     * [EditorClient.registerAction](/extension-sdk/#classes_editorclient-EditorClient_registeraction)
+     * prior to using it in the menu.
      *
      * @param item The definition of the new menu item
      */

package/sdk/ui/menu.js

@@ -26,12 +26,13 @@ class Menu {
     }
     /**
      * Add a new menu item to execute custom code. The action must be registered with
-     * EditorClient.registerAction prior to using it in the menu.
+     * [EditorClient.registerAction](/extension-sdk/#classes_editorclient-EditorClient_registeraction)
+     * prior to using it in the menu.
      *
      * @param item The definition of the new menu item
      */
     addMenuItem(item) {
-        if (!this.client.actionExists(item.action)) {
+        if (item.action && !this.client.actionExists(item.action)) {
             throw new Error('Unregistered action: ' + item.action);
         }
         if (item.visibleAction && !this.client.actionExists(item.visibleAction)) {
@@ -47,6 +48,14 @@ class Menu {
             'd': item.disabledAction,
             't': item.menuType,
             'loc': item.location,
+            'f': item.file
+                ? {
+                    'a': item.file.action,
+                    'ac': item.file.accept,
+                    's': item.file.singleFileOnly,
+                    'b': item.file.binary,
+                }
+                : undefined,
         });
     }
 }