index.d.ts

/// <reference types="google-apps-script" />

declare namespace GoogleAppsScript {
    namespace Menus {
        enum DocTypes {
            SPREADSHEET = "spreadsheet",
            PRESENTATION = "presentation",
            FORM = "form",
            DOCUMENT = "document",
        }

        enum ItemTypes {
            MENU = "menu",
            ITEM = "item",
            SEPARATOR = "separator",
        }

        interface ItemOptions {
            title: string;
            type?: ItemTypes;
            items?: ItemOptions[];
            action: string;
        }

        interface BuildMenuOptions {
            title: string;
            docType?: DocTypes;
            items?: (ItemOptions | { type: ItemTypes.SEPARATOR })[];
            append?: boolean;
            ui?: GoogleAppsScript.Base.Ui;
        }

        interface MenuApp {
            DocTypes: typeof DocTypes;
            ItemTypes: typeof ItemTypes;
            buildMenu: (
                options: BuildMenuOptions
            ) => GoogleAppsScript.Base.Menu | null;
            createSeparatorItem: () => { type: ItemTypes.SEPARATOR };
            createActionItem: (
                title: string,
                action: (...args: any[]) => any
            ) => {
                type: ItemTypes.ITEM;
                title: string;
                action: string;
            };
        }
    }
}

declare var MenuApp: GoogleAppsScript.Menus.MenuApp;