From e5545e729bb7b6c76816800e9d39ccdd21b147fa Mon Sep 17 00:00:00 2001
From: "Andrew Stiegmann (stieg)" <andrew.stiegmann@gmail.com>
Date: Thu, 18 Jan 2018 15:56:13 -1000
Subject: [PATCH 001/180] Add `usePushEach` flag to Mongoose Schema Options

In order for devs to be able to work around the issues described in
https://github.com/Automattic/mongoose/issues/5574 we need to be able
to supply the `usePushEach` flag to the Mongoose SchemaOptions. This
options functionality is described in
https://github.com/Automattic/mongoose/issues/4455 and is required for
anyone who modifies arrays inline who is using Mongoose 4 and MongoDB
3.6+

Testing:
  Copied changes to local project and verified compilation worked.
---
 types/mongoose/index.d.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/types/mongoose/index.d.ts b/types/mongoose/index.d.ts
index 3e676b499f..ee703de783 100644
--- a/types/mongoose/index.d.ts
+++ b/types/mongoose/index.d.ts
@@ -815,6 +815,8 @@ declare module "mongoose" {
     typeKey?: string;
     /** defaults to false */
     useNestedStrict?: boolean;
+    /** defaults to false */
+    usePushEach?: boolean;
     /** defaults to true */
     validateBeforeSave?: boolean;
     /** defaults to "__v" */

From deec9e9fe81adc0f2becb83c103cc17efacdd357 Mon Sep 17 00:00:00 2001
From: JounQin <admin@1stg.me>
Date: Sun, 3 Jun 2018 13:55:20 +0800
Subject: [PATCH 002/180] [zen-observable] add `readonly` modifier

https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/node/index.d.ts#L167
---
 types/zen-observable/index.d.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/types/zen-observable/index.d.ts b/types/zen-observable/index.d.ts
index f73964d026..bcf02e8f8a 100644
--- a/types/zen-observable/index.d.ts
+++ b/types/zen-observable/index.d.ts
@@ -1,11 +1,12 @@
 // Type definitions for zen-observable 0.5
 // Project: https://github.com/zenparsing/zen-observable
 // Definitions by: Kombu <https://github.com/aicest>
+//                 JounQin <https://github.com/JounQin>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 declare global {
     interface SymbolConstructor {
-        observable: symbol;
+        readonly observable: symbol;
     }
 
     namespace ZenObservable {

From 770fb31e5672d5961c30f637cdf9e4b839c3a19f Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Sun, 3 Jun 2018 09:07:41 -0400
Subject: [PATCH 003/180] Updated ShopifyBuy Types to match v1, removed classes
 that seemed less required now and changed it to reflect only interfaces, and
 one namespace

---
 types/shopify-buy/index.d.ts | 758 +++++++++++++++--------------------
 1 file changed, 331 insertions(+), 427 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index d055cd671f..664b5a38a8 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -1,8 +1,9 @@
-// Type definitions for shopify-buy 0.4.2
+// Type definitions for shopify-buy v1.0.0
 // Project: http://shopify.github.io/js-buy-sdk/api/
-// Definitions by: Martin Köhn <https://github.com/openminder>
+// Definitions for 0.4.2 by: Martin Köhn <https://github.com/openminder>
+// Definitions update by: Stephen Traiforos <https://github.com/straiforos>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.3
+// TypeScript Version: 2.7.*
 
 /**
  * The JS Buy SDK is a lightweight library that allows you to build ecommerce into any website.
@@ -12,441 +13,344 @@
  * website or javascript application. This is helpful if you already have a website and need to add ecommerce
  * or only need a simple buy button on your site.
  */
+
 declare namespace ShopifyBuy {
-    /**
-     * Create a ShopClient. This is the main entry point to the SDK.
-     */
-    export function buildClient(configAttrs: Shopify.Config): Shopify.ShopClient
+    export function buildClient(config: ShopifyBuy.Config): Client;
+
+    export interface Client {
+        product: ShopifyBuy.ProductAPI;
+        collection: ShopifyBuy.CollectionAPI;
+        checkout: ShopifyBuy.CheckoutAPI;
+    }
+    export interface Config {
+        domain: string;
+        storefrontAccessToken: string;
+    }
+
+    export interface ProductAPI {
+        fetch(id: string): Promise<Product[]>;
+        fetchQuery(id: Query): Promise<Product[]>;
+        fetchAll(): Promise<Product[]>;
+    }
+
+    export interface CollectionAPI {
+        fetch(id: string): Promise<Product[]>;
+        fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type
+    }
+
+    export interface CheckoutAPI {
+        /**
+         * Remove all line items from cart
+         */
+        clearLineItems(): Promise<Cart>;
+
+        /**
+         * Add items to cart. Updates cart's lineItems
+         */
+        addVariants(item: Item, nextItem?: Array<Item>): Promise<Cart>;
+
+        /**
+         * Add items to the cart. Updates cart's lineItems based on variants passed in.
+         */
+        createLineItemsFromVariants(...items: Item[]): Promise<Cart>;
+
+        /**
+         * Remove a line item from cart based on line item id
+         */
+        removeLineItem(id: string): Promise<Cart>;
+
+        /**
+         * Update a line item quantity based on line item id
+         */
+        updateLineItem(id: string, quantitiy: number): Promise<Cart>;
+
+        /**
+         * Force update of cart model on server. This function will only be used in advanced
+         * situations and does not need to be called explicitly to update line items.
+         * It is automatically called after createLineItemsFromVariants, updateLineItem,
+         * removeLineItem, and removeLineItem
+         */
+        updateModel(): Promise<Cart>;
+    }
+
+    export interface Query {
+        query: string;
+        sortBy: string;
+        after?: string;
+        before?: string;
+        first?: string;
+        last?: string;
+        reverse?: boolean;
+    }
+
+    export interface Product {
+        /**
+         * A product description.
+         */
+        description: string;
+
+        /**
+         * Product unique ID
+         */
+        id: string | number;
+
+        /**
+         * An Array of Objects that contain meta data about an image including src of the images.
+         */
+        images: Array<Image>;
+
+        /**
+         * All variants of a product.
+         */
+        variants: Array<ProductVariant>;
+
+        /**
+         * Get an array of Product Options. Product Options can be used to define
+         * the currently selectedVariant from which you can get a checkout url (ProductVariant.checkoutUrl)
+         * or can be added to a cart (Cart.createLineItemsFromVariants).
+         */
+        options: Array<Option>;
+
+        /**
+         * Retrieve variant for currently selected options. By default the first value in each option is selected
+         * which means selectedVariant will never be null. With a selectedVariant you can
+         * create checkout url (ProductVariant.checkoutUrl) or
+         * it can be added to a cart (Cart.createLineItemsFromVariants).
+         */
+        selectedVariant: ProductVariant;
+
+        /**
+         * Retrieve image for currently selected variantImage.
+         */
+        selectedVariantImage: Image;
+
+        /**
+         * A read only Array of Strings represented currently selected option values. eg. ["Large", "Red"]
+         */
+        selections: Array<string>;
+
+        /**
+         * The product title
+         */
+        title: string;
+    }
+
+    export interface ProductVariant {
+        /**
+         * Variant in stock. Always true if inventory tracking is disabled.
+         */
+        available: boolean;
+
+        /**
+         * Compare at price for variant. The compareAtPrice would be the price of the
+         * product previously before the product went on sale.
+         */
+        compareAtPrice: string;
+
+        /**
+         * Price of variant, formatted according to shop currency format string. For instance "$10.00"
+         */
+        formattedPrice: string;
+
+        /**
+         * Variant weight in grams. If no weight is defined grams will be 0.
+         */
+        grams: number;
+
+        /**
+         * Variant unique ID
+         */
+        id: string | number;
+
+        /**
+         * Image for variant
+         */
+
+        image: Image;
+
+        /**
+         * Image variants available for a variant.
+         */
+        imageVariant: Array<ImageVariant>;
+
+        /**
+         * Option values associated with this variant, ex {name: "color", value: "Blue"}
+         */
+        optionValues: Array<OptionValue>;
+
+        /**
+         * Price of the variant. The price will be in the following form: "10.00"
+         */
+        price: string;
+
+        /**
+         * ID of product variant belongs to
+         */
+        productId: string | number;
+
+        /**
+         * Title of product variant belongs to
+         */
+        productTitle: string;
+
+        /**
+         * Title of variant
+         */
+        title: string;
+
+        /*
+        * Get a checkout url for a specific product variant.
+        * You can optionally pass a quantity.
+        * If no quantity is passed then quantity will default to 1.
+        */
+        checkoutUrl(quantitiy: number): string;
+    }
+
+    export interface Option {
+        /**
+         * name of option (ex. "Size", "Color")
+         */
+        name: string;
+
+        /**
+         * get/set the currently selected option value with one of the values from the Product Options/values array.
+         * For instance if the option values array had the following ["Large", "Medium", "Small"] setting selected to be
+         * "Large", "Medium", or "Small" would be valid any other value would throw an Error.
+         */
+        selected: string;
+
+        /**
+         * an Array possible values for option. For instance if this option
+         * is a "Size" option an example value for values could be: ["Large", "Medium", "Small"]
+         */
+        values: Array<any>;
+    }
+
+    /* 
+    *   TODO this should be solved during TDD
+    *   export interface Collection {} 
+    */
+
+    export interface Cart {
+        /**
+         * Get checkout URL for current cart
+         */
+        checkoutUrl: string;
+
+        /**
+         * get ID for current cart
+         */
+        id: string | number;
+
+        /**
+         * Gets the total quantity of all line items. Example: you've added two variants
+         * with quantities 3 and 2. lineItemCount will be 5.
+         */
+        lineItemCount: number;
+
+        /**
+         * Get an Array of CartLineItemModel's
+         */
+        lineItems: LineItem;
+
+        /**
+         * Get current subtotal price for all line items.
+         * Example: two items have been added to the cart that cost $1.25 then the subtotal will be 2.50
+         */
+        subtotal: string;
+    }
+
+    export interface LineItem {
+        /**
+         * Compare at price for variant. The compareAtPrice would be the price of the product
+         * previously before the product went on sale.
+         * If no compareAtPrice is set then this value will be null. An example value: "5.00".
+         */
+        compare_at_price: string;
+
+        /**
+         * Variant's weight in grams. If no weight is set then 0 is returned.
+         */
+        grams: number;
+
+        /**
+         * A line item ID.
+         */
+        id: string | number;
+
+        /**
+         * Variant's image.
+         */
+        image: Image;
+
+        /**
+         * The total price for this line item. For instance if the variant costs 1.50 and you have a
+         * quantity of 2 then line_price will be 3.00.
+         */
+        line_price: string;
+
+        /**
+         * Price of the variant. For example: "5.00".
+         */
+        price: string;
+
+        /**
+         * ID of variant's product.
+         */
+        product_id: string | number;
+
+        /**
+         * Count of variants to order.
+         */
+        quantity: number;
+
+        /**
+         * Product title of variant's parent product.
+         */
+        title: string;
+
+        /**
+         * ID of line item variant.
+         */
+        variant_id: string | number;
+
+        /**
+         * Title of variant.
+         */
+        variant_title: string;
+    }
+
+    export interface Item {
+        variant: ProductVariant;
+        quantity: number;
+    }
 
     /**
      * Internal Image description
      */
-    interface Image {
-        id: string | number
-        created_at: string
-        position: number
-        updated_at: string
-        product_id: string
-        src: string
-        variant_ids: Array<string>
+    export interface Image {
+        id: string | number;
+        created_at: string;
+        position: number;
+        updated_at: string;
+        product_id: string;
+        src: string;
+        variant_ids: Array<string>;
     }
 
-    interface ImageVariant {
-        name: string,
-        dimensions: string,
-        src: string
+    export interface ImageVariant {
+        name: string;
+        dimensions: string;
+        src: string;
     }
 
-    interface OptionValue {
-        name: string,
-        option_id: string | number,
-        value: any
+    export interface OptionValue {
+        name: string;
+        option_id: string;
+        value: any;
     }
-
-    /**
-     * Internal BaseModel class
-     */
-    class BaseModel {
-        constructor(attrs: any, metaAttrs: any)
-
-        attrs: any
-        serializer: any
-        adapter: any
-        shopClient: any
-    }
-
-    var NO_IMAGE_URI: string;
-
-    /**
-     * This namespace contains all globally accessible classes
-     */
-    export namespace Shopify {
-
-        /**
-         * Base Shopify Client config object
-         */
-        interface Config {
-            /**
-             * An API Key for your store. Documentation how to get an API Key:
-             * https://help.shopify.com/api/sdks/js-buy-sdk/getting-started#api-key
-             */
-            apiKey: string
-
-            /**
-             * Typically will be 6 which is the Buy Button App Id. For more info on App Id see:
-             * https://help.shopify.com/api/sdks/js-buy-sdk/getting-started#app-id
-             */
-            appId: string
-
-            /**
-             * Your shop's full myshopify.com domain. For example: embeds.myshopify.com
-             */
-            domain: string
-        }
-
-        /**
-         * Cart item, that should be added to the card
-         */
-        interface CartModelItem {
-            variant: Shopify.ProductVariantModel
-            quantity: number
-        }
-
-        /**
-         * Shopify-Buy-SDK Client to handle products and cart
-         */
-        class ShopClient {
-
-            /**
-             * Config data to be used throughout all API interaction
-             */
-            constructor(config?: Config)
-            /**
-             * Creates a CartModel instance.
-             */
-            createCart(): Promise<CartModel>
-
-            /**
-             * This function will return an Array of collections from your store
-             */
-            fetchAllCollections(): Promise<Array<any>>
-
-            /**
-             * This function will return an Array of products from your store
-             */
-            fetchAllProducts(): Promise<Array<ProductModel>>
-
-            /**
-             * Retrieve a previously created cart by its key.
-             */
-            fetchCart(id: string): Promise<CartModel>
-
-            /**
-             * Fetch one collection by its ID.
-             */
-            fetchCollection(id: string | number): Promise<any>
-
-            /**
-             * Fetch one product by its ID.
-             */
-            fetchProduct(id: string | number): Promise<ProductModel>
-
-            /**
-             * Fetches a list of collections matching a specified query.
-             */
-            fetchQueryCollections(query?: any): Promise<Array<any>>
-
-            /**
-             * Fetches a list of products matching a specified query.
-             */
-            fetchQueryProducts(query?: any): Promise<Array<ProductModel>>
-
-            /**
-             * This method looks up a reference in localStorage to the most recent cart.
-             * If one is not found, creates one. If the cart the reference points to doesn't exist,
-             * create one and store the new reference.
-             */
-            fetchRecentCart(): Promise<CartModel>
-
-        }
-
-        /**
-         * Class for products returned by fetch('product')
-         */
-        class ProductModel extends BaseModel {
-
-            constructor()
-
-            /**
-             * A product description.
-             */
-            description: string
-
-            /**
-             * Product unique ID
-             */
-            id: string | number
-
-            /**
-             * An Array of Objects that contain meta data about an image including src of the images.
-             */
-            images: Array<Image>
-
-            /**
-             * All variants of a product.
-             */
-            variants: Array<ProductVariantModel>
-
-            /**
-             * Get an array of ProductOptionModels. ProductOptionModels can be used to define
-             * the currently selectedVariant from which you can get a checkout url (ProductVariantModel.checkoutUrl)
-             * or can be added to a cart (CartModel.createLineItemsFromVariants).
-             */
-            options: Array<ProductOptionModel>
-
-            /**
-             * Retrieve variant for currently selected options. By default the first value in each option is selected
-             * which means selectedVariant will never be null. With a selectedVariant you can
-             * create checkout url (ProductVariantModel.checkoutUrl) or
-             * it can be added to a cart (CartModel.createLineItemsFromVariants).
-             */
-            selectedVariant: ProductVariantModel
-
-            /**
-             * Retrieve image for currently selected variantImage.
-             */
-            selectedVariantImage: Image
-
-            /**
-             * A read only Array of Strings represented currently selected option values. eg. ["Large", "Red"]
-             */
-            selections: Array<string>
-
-            /**
-             * The product title
-             */
-            title: string
-        }
-
-        /**
-         * Model for product variant
-         */
-        class ProductVariantModel extends BaseModel {
-
-            constructor()
-
-            /*
-             * Get a checkout url for a specific product variant.
-             * You can optionally pass a quantity.
-             * If no quantity is passed then quantity will default to 1.
-             */
-            checkoutUrl(quantitiy: number): string
-
-            /**
-             * Variant in stock. Always true if inventory tracking is disabled.
-             */
-            available: boolean
-
-            /**
-             * Compare at price for variant. The compareAtPrice would be the price of the
-             * product previously before the product went on sale.
-             */
-            compareAtPrice: string
-
-            /**
-             * Price of variant, formatted according to shop currency format string. For instance "$10.00"
-             */
-            formattedPrice: string
-
-            /**
-             * Variant weight in grams. If no weight is defined grams will be 0.
-             */
-            grams: number
-
-            /**
-             * Variant unique ID
-             */
-            id: string | number
-
-            /**
-             * Image for variant
-             */
-            image: Image
-
-            /**
-             * Image variants available for a variant.
-             */
-            imageVariant: Array<ImageVariant>
-
-            /**
-             * Option values associated with this variant, ex {name: "color", value: "Blue"}
-            */
-            optionValues: Array<OptionValue>
-
-            /**
-             * Price of the variant. The price will be in the following form: "10.00"
-             */
-            price: string
-
-            /**
-             * ID of product variant belongs to
-             */
-            productId: string | number
-
-            /**
-             * Title of product variant belongs to
-             */
-            productTitle: string
-
-            /**
-             * Title of variant
-             */
-            title: string
-        }
-
-        /**
-         * Class for product option
-         */
-        class ProductOptionModel extends BaseModel {
-
-            constructor()
-
-            /**
-             * name of option (ex. "Size", "Color")
-             */
-            name: string
-
-            /**
-             * get/set the currently selected option value with one of the values from the ProductOptionModel/values array.
-             * For instance if the option values array had the following ["Large", "Medium", "Small"] setting selected to be
-             * "Large", "Medium", or "Small" would be valid any other value would throw an Error.
-             */
-            selected: string
-
-            /**
-             * an Array possible values for option. For instance if this option
-             * is a "Size" option an example value for values could be: ["Large", "Medium", "Small"]
-             */
-            values: Array<any>
-
-        }
-
-        /**
-         * Class for cart model
-         */
-        class CartModel extends BaseModel {
-
-            constructor()
-
-            /**
-             * Remove all line items from cart
-             */
-            clearLineItems(): Promise<CartModel>
-
-            /**
-             * Add items to cart. Updates cart's lineItems
-             */
-            addVariants(item: CartModelItem, nextItem?: Array<CartModelItem>): Promise<CartModel>
-
-            /**
-             * Add items to the cart. Updates cart's lineItems based on variants passed in.
-             */
-            createLineItemsFromVariants(...items: CartModelItem[] ): Promise<CartModel>
-
-            /**
-             * Remove a line item from cart based on line item id
-             */
-            removeLineItem(id: string | number): Promise<CartModel>
-
-            /**
-             * Update a line item quantity based on line item id
-             */
-            updateLineItem(id: string | number, quantitiy: number): Promise<CartModel>
-
-            /**
-             * Force update of cart model on server. This function will only be used in advanced
-             * situations and does not need to be called explicitly to update line items.
-             * It is automatically called after createLineItemsFromVariants, updateLineItem,
-             * removeLineItem, and removeLineItem
-             */
-            updateModel(): Promise<CartModel>
-
-            /**
-             * Get checkout URL for current cart
-             */
-            checkoutUrl: string
-
-            /**
-             * get ID for current cart
-             */
-            id: string | number
-
-            /**
-             * Gets the total quantity of all line items. Example: you've added two variants
-             * with quantities 3 and 2. lineItemCount will be 5.
-             */
-            lineItemCount: number
-
-            /**
-             * Get an Array of CartLineItemModel's
-             */
-            lineItems: Array<CartLineItemModel>
-
-            /**
-             * Get current subtotal price for all line items.
-             * Example: two items have been added to the cart that cost $1.25 then the subtotal will be 2.50
-             */
-            subtotal: string
-
-        }
-
-        class CartLineItemModel extends BaseModel {
-            constructor()
-
-            /**
-             * Compare at price for variant. The compareAtPrice would be the price of the product
-             * previously before the product went on sale.
-             * If no compareAtPrice is set then this value will be null. An example value: "5.00".
-             */
-            compare_at_price: string
-
-            /**
-             * Variant's weight in grams. If no weight is set then 0 is returned.
-             */
-            grams: number
-
-            /**
-             * A line item ID.
-             */
-            id: string | number
-
-            /**
-             * Variant's image.
-             */
-            image: Image
-
-            /**
-             * The total price for this line item. For instance if the variant costs 1.50 and you have a
-             * quantity of 2 then line_price will be 3.00.
-             */
-            line_price: string
-
-            /**
-             * Price of the variant. For example: "5.00".
-             */
-            price: string
-
-            /**
-             * ID of variant's product.
-             */
-            product_id: string | number
-
-            /**
-             * Count of variants to order.
-             */
-            quantity: number
-
-            /**
-             * Product title of variant's parent product.
-             */
-            title: string
-
-            /**
-             * ID of line item variant.
-             */
-            variant_id: string | number
-
-            /**
-             * Title of variant.
-             */
-            variant_title: string
-
-        }
-
-    }
-
 }
 
 declare module "shopify-buy" {
-    export = ShopifyBuy
+    export = ShopifyBuy;
 }

From 4df3c049d18f989db17c97316d939370cec82913 Mon Sep 17 00:00:00 2001
From: Simon <demwizzy@gmail.com>
Date: Sun, 3 Jun 2018 21:33:12 +0200
Subject: [PATCH 004/180] fix(joi): remove incorrect usage of generic

---
 types/joi/index.d.ts   | 2 +-
 types/joi/joi-tests.ts | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/types/joi/index.d.ts b/types/joi/index.d.ts
index 48e2a0327c..34e740b27c 100644
--- a/types/joi/index.d.ts
+++ b/types/joi/index.d.ts
@@ -966,7 +966,7 @@ export interface Rules<P extends object = any> {
     name: string;
     params?: ObjectSchema | {[key in keyof P]: SchemaLike; };
     setup?(this: ExtensionBoundSchema, params: P): Schema | void;
-    validate?<R = any>(this: ExtensionBoundSchema, params: P, value: any, state: State, options: ValidationOptions): Err | R;
+    validate?(this: ExtensionBoundSchema, params: P, value: any, state: State, options: ValidationOptions): Err | any;
     description?: string | ((params: P) => string);
 }
 
diff --git a/types/joi/joi-tests.ts b/types/joi/joi-tests.ts
index 5ea9088a74..240dea89d4 100644
--- a/types/joi/joi-tests.ts
+++ b/types/joi/joi-tests.ts
@@ -988,13 +988,13 @@ const Joi3 = Joi.extend({
         {
             name: 'asd',
             params: {
-                allowF: Joi.boolean().default(false),
+                allowFalse: Joi.boolean().default(false),
             },
             setup(params) {
-                const fIsAllowed = params.allowF;
+                const fIsAllowed = params.allowFalse;
             },
-            validate(params, value, state, options) {
-                if (value === 'asd' || params.allowF && value === 'asdf') {
+            validate(params, value: boolean, state, options) {
+                if (value || params.allowFalse && !value) {
                     return value;
                 }
                 return this.createError('asd', { v: value }, state, options);

From 24b31d85632ea164dbc870ba378da38ddbce427e Mon Sep 17 00:00:00 2001
From: Peter Thorson <git@zaphoyd.com>
Date: Sun, 3 Jun 2018 15:43:51 -0500
Subject: [PATCH 005/180] [joi] Update joi definitions to match current version
 (13.0.1 -> 13.3.0)

* Add optional options package for string.hex
* Add number.port option
* Add object.append method
* Add Joi.reach overloads with path argument having an array of strings
* Update documentation strings for reach, keys
---
 types/joi/index.d.ts   | 29 +++++++++++++++++++++++++----
 types/joi/joi-tests.ts | 12 ++++++++++++
 2 files changed, 37 insertions(+), 4 deletions(-)

diff --git a/types/joi/index.d.ts b/types/joi/index.d.ts
index 48e2a0327c..4fe6d1a431 100644
--- a/types/joi/index.d.ts
+++ b/types/joi/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for joi v13.0.1
+// Type definitions for joi v13.3.0
 // Project: https://github.com/hapijs/joi
 // Definitions by: Bart van der Schoor <https://github.com/Bartvds>
 //                 Laurence Dougal Myers <https://github.com/laurence-myers>
@@ -12,6 +12,7 @@
 //                 Anjun Wang <https://github.com/wanganjun>
 //                 Rafael Kallis <https://github.com/rafaelkallis>
 //                 Conan Lai <https://github.com/aconanlai>
+//                 Peter Thorson <https://github.com/zaphoyd>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.4
 
@@ -106,6 +107,13 @@ export interface EmailOptions {
     minDomainAtoms?: number;
 }
 
+export interface HexOptions {
+    /**
+     * hex decoded representation must be byte aligned
+     */
+    byteAligned: boolean;
+}
+
 export interface IpOptions {
     /**
      * One or more IP address versions to validate against. Valid values: ipv4, ipv6, ipvfuture
@@ -512,6 +520,11 @@ export interface NumberSchema extends AnySchema {
      * Requires the number to be negative.
      */
     negative(): this;
+
+    /**
+     * Requires the number to be a TCP port, so between 0 and 65535.
+     */
+    port(): this;
 }
 
 export interface StringSchema extends AnySchema {
@@ -624,7 +637,7 @@ export interface StringSchema extends AnySchema {
     /**
      * Requires the string value to be a valid hexadecimal string.
      */
-    hex(): this;
+    hex(options?: HexOptions): this;
 
     /**
      * Requires the string value to be a valid hostname as per RFC1123.
@@ -714,10 +727,15 @@ export interface ArraySchema extends AnySchema {
 export interface ObjectSchema extends AnySchema {
 
     /**
-     * Sets the allowed object keys.
+     * Sets or extends the allowed object keys.
      */
     keys(schema?: SchemaMap): this;
 
+    /**
+     * Appends the allowed object keys. If schema is null, undefined, or {}, no changes will be applied.
+     */
+    append(schema?: SchemaMap): this;
+
     /**
      * Specifies the minimum number of keys in the object.
      */
@@ -1101,10 +1119,13 @@ export function ref(key: string, options?: ReferenceOptions): Reference;
 export function isRef(ref: any): ref is Reference;
 
 /**
- * Get a sub-schema of an existing schema based on a path. Path separator is a dot (.).
+ * Get a sub-schema of an existing schema based on a `path` that can be either a string or an array 
+ * of strings For string values path separator is a dot (`.`)
  */
 export function reach(schema: ObjectSchema, path: string): Schema;
 export function reach<T extends Schema>(schema: ObjectSchema, path: string): T;
+export function reach(schema: ObjectSchema, path: string[]): Schema;
+export function reach<T extends Schema>(schema: ObjectSchema, path: string[]): T;
 
 /**
  * Creates a new Joi instance customized with the extension(s) you provide included.
diff --git a/types/joi/joi-tests.ts b/types/joi/joi-tests.ts
index 5ea9088a74..01147761d7 100644
--- a/types/joi/joi-tests.ts
+++ b/types/joi/joi-tests.ts
@@ -96,6 +96,12 @@ emailOpts = { minDomainAtoms: num };
 
 // --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
 
+let hexOpts: Joi.HexOptions = null;
+
+hexOpts = { byteAligned: bool };
+
+// --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
+
 let ipOpts: Joi.IpOptions = null;
 
 ipOpts = { version: str };
@@ -602,6 +608,7 @@ numSchema = numSchema.precision(num);
 numSchema = numSchema.multiple(num);
 numSchema = numSchema.positive();
 numSchema = numSchema.negative();
+numSchema = numSchema.port();
 
 namespace common {
     numSchema = numSchema.allow(x);
@@ -659,6 +666,9 @@ objSchema = Joi.object(schemaMap);
 objSchema = objSchema.keys();
 objSchema = objSchema.keys(schemaMap);
 
+objSchema = objSchema.append();
+objSchema = objSchema.append(schemaMap);
+
 objSchema = objSchema.min(num);
 objSchema = objSchema.max(num);
 objSchema = objSchema.length(num);
@@ -801,6 +811,7 @@ strSchema = strSchema.guid();
 strSchema = strSchema.guid({ version: ['uuidv1', 'uuidv2', 'uuidv3', 'uuidv4', 'uuidv5'] } as Joi.GuidOptions);
 strSchema = strSchema.guid({ version: 'uuidv4' });
 strSchema = strSchema.hex();
+strSchema = strSchema.hex(hexOpts);
 strSchema = strSchema.hostname();
 strSchema = strSchema.isoDate();
 strSchema = strSchema.lowercase();
@@ -969,6 +980,7 @@ description = Joi.describe(schema);
 description = schema.describe();
 
 schema = Joi.reach(objSchema, '');
+schema = Joi.reach(objSchema, []);
 
 const Joi2 = Joi.extend({ name: '', base: schema });
 

From 005b3ec5b73dc73fcdc9c98534f77269c17f9f09 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Sun, 3 Jun 2018 19:12:59 -0400
Subject: [PATCH 006/180] Added to the modified interface scheme. CheckoutAPI
 Doc walk through update, starting points and comments for next steps for lack
 of interfaced types, graphQL base model being considered.

---
 types/shopify-buy/index.d.ts | 90 +++++++++++++++++++++++++++---------
 1 file changed, 67 insertions(+), 23 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 664b5a38a8..e967e0622d 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -21,6 +21,9 @@ declare namespace ShopifyBuy {
         product: ShopifyBuy.ProductAPI;
         collection: ShopifyBuy.CollectionAPI;
         checkout: ShopifyBuy.CheckoutAPI;
+        shop: any;
+        image: Image;
+        fetchNextPage(T: GraphModel[]): GraphModel[];
     }
     export interface Config {
         domain: string;
@@ -38,39 +41,55 @@ declare namespace ShopifyBuy {
         fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type
     }
 
+    /*
+    *   https://shopify.github.io/js-buy-sdk/CheckoutResource.html
+    */
     export interface CheckoutAPI {
+        create(
+            email: string,
+            lineItems: LineItem[],
+            shippingAddress: Address,
+            note: string,
+            customAttributes: AttributeInput[]
+        ): Promise<Cart>;
+
+        fetch(id: string): Promise<Cart>;
+
+
+
+        addLineItems(
+            checkoutId: string,
+            lineItems: LineItem[]
+        ): Promise<Cart>;
+
         /**
          * Remove all line items from cart
          */
-        clearLineItems(): Promise<Cart>;
+        clearLineItems(
+            checkoutId: string,
+            lineItems: LineItem[]
+        ): Promise<Cart>;
 
         /**
          * Add items to cart. Updates cart's lineItems
          */
         addVariants(item: Item, nextItem?: Array<Item>): Promise<Cart>;
 
-        /**
-         * Add items to the cart. Updates cart's lineItems based on variants passed in.
-         */
-        createLineItemsFromVariants(...items: Item[]): Promise<Cart>;
-
         /**
          * Remove a line item from cart based on line item id
          */
-        removeLineItem(id: string): Promise<Cart>;
+        removeLineItem(
+            checkoutId: string,
+            lineItems: LineItem[]
+        ): Promise<Cart>;
 
         /**
          * Update a line item quantity based on line item id
          */
-        updateLineItem(id: string, quantitiy: number): Promise<Cart>;
-
-        /**
-         * Force update of cart model on server. This function will only be used in advanced
-         * situations and does not need to be called explicitly to update line items.
-         * It is automatically called after createLineItemsFromVariants, updateLineItem,
-         * removeLineItem, and removeLineItem
-         */
-        updateModel(): Promise<Cart>;
+        updateLineItem(
+            checkoutId: string,
+            lineItems: LineItem[]
+        ): Promise<Cart>;
     }
 
     export interface Query {
@@ -83,7 +102,7 @@ declare namespace ShopifyBuy {
         reverse?: boolean;
     }
 
-    export interface Product {
+    export interface Product extends GraphModel {
         /**
          * A product description.
          */
@@ -135,7 +154,7 @@ declare namespace ShopifyBuy {
         title: string;
     }
 
-    export interface ProductVariant {
+    export interface ProductVariant extends GraphModel {
         /**
          * Variant in stock. Always true if inventory tracking is disabled.
          */
@@ -231,7 +250,7 @@ declare namespace ShopifyBuy {
     *   export interface Collection {} 
     */
 
-    export interface Cart {
+    export interface Cart extends GraphModel {
         /**
          * Get checkout URL for current cart
          */
@@ -251,7 +270,7 @@ declare namespace ShopifyBuy {
         /**
          * Get an Array of CartLineItemModel's
          */
-        lineItems: LineItem;
+        lineItems: LineItem[];
 
         /**
          * Get current subtotal price for all line items.
@@ -260,7 +279,7 @@ declare namespace ShopifyBuy {
         subtotal: string;
     }
 
-    export interface LineItem {
+    export interface LineItem extends GraphModel {
         /**
          * Compare at price for variant. The compareAtPrice would be the price of the product
          * previously before the product went on sale.
@@ -328,7 +347,7 @@ declare namespace ShopifyBuy {
     /**
      * Internal Image description
      */
-    export interface Image {
+    export interface Image extends GraphModel {
         id: string | number;
         created_at: string;
         position: number;
@@ -338,7 +357,7 @@ declare namespace ShopifyBuy {
         variant_ids: Array<string>;
     }
 
-    export interface ImageVariant {
+    export interface ImageVariant extends Image {
         name: string;
         dimensions: string;
         src: string;
@@ -349,6 +368,31 @@ declare namespace ShopifyBuy {
         option_id: string;
         value: any;
     }
+
+    export interface Address {
+        address1: String;
+        address2: String;
+        city: String;
+        company: String;
+        country: String;
+        firstName: String;
+        lastName: String;
+        phone: String;
+        province: String;
+        zip: String;
+    }
+
+    /* 
+    *   https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
+    */
+    export interface AttributeInput {
+        key: string;
+        value: string;
+    }
+
+    export interface GraphModel {
+
+    }
 }
 
 declare module "shopify-buy" {

From bdc53a6a430b2d072984404d0ba70e3c10e76666 Mon Sep 17 00:00:00 2001
From: Joshua Goldberg <josh@fullscreenmario.com>
Date: Sun, 3 Jun 2018 16:29:30 -0700
Subject: [PATCH 007/180] Fixed up selenium-webdriver getting and setting
 Options and Service for Builders

Fixes https://github.com/DefinitelyTyped/DefinitelyTyped/issues/26249
---
 types/selenium-webdriver/index.d.ts    | 47 +++++++++++++++++++++++++-
 types/selenium-webdriver/test/index.ts | 11 ++++++
 2 files changed, 57 insertions(+), 1 deletion(-)

diff --git a/types/selenium-webdriver/index.d.ts b/types/selenium-webdriver/index.d.ts
index 4e8ce55986..4721033bfd 100644
--- a/types/selenium-webdriver/index.d.ts
+++ b/types/selenium-webdriver/index.d.ts
@@ -2160,6 +2160,21 @@ export class Builder {
    */
   setChromeOptions(options: chrome.Options): Builder;
 
+  /**
+   * @return {chrome.Options} the Chrome specific options currently configured
+   *     for this builder.
+   */
+  getChromeOptions(): chrome.Options;
+
+  /**
+   * Sets the service builder to use for managing the chromedriver child process
+   * when creating new Chrome sessions.
+   *
+   * @param {chrome.ServiceBuilder} service the service to use.
+   * @return {!Builder} A self reference.
+   */
+  setChromeService(service: chrome.ServiceBuilder): Builder;
+
   /**
    * Sets the control flow that created drivers should execute actions in. If
    * the flow is never set, or is set to {@code null}, it will use the active
@@ -2181,6 +2196,15 @@ export class Builder {
    */
   setEdgeOptions(options: edge.Options): Builder;
 
+  /**
+   * Sets the {@link edge.ServiceBuilder} to use to manage the
+   * MicrosoftEdgeDriver child process when creating sessions locally.
+   *
+   * @param {edge.ServiceBuilder} service the service to use.
+   * @return {!Builder} a self reference.
+   */
+  setEdgeService(service: edge.ServiceBuilder): Builder;
+
   /**
    * Sets whether native events should be used.
    * @param {boolean} enabled Whether to enable native events.
@@ -2199,6 +2223,21 @@ export class Builder {
    */
   setFirefoxOptions(options: firefox.Options): Builder;
 
+  /**
+   * @return {firefox.Options} the Firefox specific options currently configured
+   *     for this instance.
+   */
+  getFirefoxOptions(): firefox.Options;
+
+  /**
+   * Sets the {@link firefox.ServiceBuilder} to use to manage the geckodriver
+   * child process when creating Firefox sessions locally.
+   *
+   * @param {firefox.ServiceBuilder} service the service to use.
+   * @return {!Builder} a self reference.
+   */
+  setFirefoxService(service: firefox.ServiceBuilder): Builder;
+
   /**
    * Set Internet Explorer specific {@linkplain ie.Options options} for drivers
    * created by this builder. Any proxy settings defined on the given options
@@ -2246,7 +2285,13 @@ export class Builder {
    * @param {!safari.Options} options The Safari options to use.
    * @return {!Builder} A self reference.
    */
-  setSafari(options: safari.Options): Builder;
+  setSafariOptions(options: safari.Options): Builder;
+
+  /**
+   * @return {safari.Options} the Safari specific options currently configured
+   *     for this instance.
+   */
+  getSafariOptions(): safari.Options;
 
   /**
    * Sets how elements should be scrolled into view for interaction.
diff --git a/types/selenium-webdriver/test/index.ts b/types/selenium-webdriver/test/index.ts
index 2dd80918ae..f8decdace1 100644
--- a/types/selenium-webdriver/test/index.ts
+++ b/types/selenium-webdriver/test/index.ts
@@ -1,8 +1,10 @@
 import * as webdriver from 'selenium-webdriver';
 import * as chrome from 'selenium-webdriver/chrome';
+import * as edge from 'selenium-webdriver/edge';
 import * as firefox from 'selenium-webdriver/firefox';
 import * as http from 'selenium-webdriver/http';
 import * as remote from 'selenium-webdriver/remote';
+import * as safari from 'selenium-webdriver/safari';
 import * as testing from 'selenium-webdriver/testing';
 
 function TestBuilder() {
@@ -18,16 +20,25 @@ function TestBuilder() {
 
     builder = builder.setAlertBehavior('behavior');
     builder = builder.setChromeOptions(new chrome.Options());
+    builder = builder.setChromeService(new chrome.ServiceBuilder());
     builder = builder.setControlFlow(new webdriver.promise.ControlFlow());
+    builder = builder.setEdgeOptions(new edge.Options());
+    builder = builder.setEdgeService(new edge.ServiceBuilder());
     builder = builder.setEnableNativeEvents(true);
     builder = builder.setFirefoxOptions(new firefox.Options());
+    builder = builder.setFirefoxService(new firefox.ServiceBuilder());
     builder = builder.setLoggingPrefs(new webdriver.logging.Preferences());
     builder = builder.setLoggingPrefs({ key: 'value' });
     builder = builder.setProxy({ proxyType: 'type' });
+    builder = builder.setSafariOptions(new safari.Options());
     builder = builder.setScrollBehavior(1);
     builder = builder.usingServer('http://someserver');
     builder = builder.withCapabilities(new webdriver.Capabilities());
     builder = builder.withCapabilities({ something: true });
+
+    const chromeOptions: chrome.Options = builder.getChromeOptions();
+    const firefoxOptions: firefox.Options = builder.getFirefoxOptions();
+    const safariOptions: safari.Options = builder.getSafariOptions();
 }
 
 declare const promise: webdriver.promise.Promise<string>;

From 9a4a3caac8b899d69e296f172a758a912f08b55e Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Sun, 3 Jun 2018 20:01:07 -0400
Subject: [PATCH 008/180] Walked through Collection Documentation adding
 missing methods, and added TODOs for other missing type interfaces

---
 types/shopify-buy/index.d.ts | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index e967e0622d..c2fd12962b 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -38,7 +38,12 @@ declare namespace ShopifyBuy {
 
     export interface CollectionAPI {
         fetch(id: string): Promise<Product[]>;
-        fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type
+        fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type: Docs: Fetches a single collection by ID on the shop, not including products.
+        fetchAll(): Promise<any[]>; // TODO fix to be a type: Docs: Fetches all collections on the shop, not including products.
+        fetchAllWithProducts(): Promise<any[]>; // TODO fix to be a type: DOC: Fetches all collections on the shop, including products.
+        fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type: DOC: Fetches all collections on the shop, including products.
+        fetchByHandle(handle: string): Promise<any[]>; // TODO fix to be a type: DOC: Fetches a collection by handle on the shop. Assuming it does not give products
+        fetchQuery(query: Query): Promise<any[]>; // TODO fix to be a type: DOC: Fetches a collection by handle on the shop. Assuming it does not give products
     }
 
     /*
@@ -55,12 +60,7 @@ declare namespace ShopifyBuy {
 
         fetch(id: string): Promise<Cart>;
 
-
-
-        addLineItems(
-            checkoutId: string,
-            lineItems: LineItem[]
-        ): Promise<Cart>;
+        addLineItems(checkoutId: string, lineItems: LineItem[]): Promise<Cart>;
 
         /**
          * Remove all line items from cart
@@ -93,6 +93,11 @@ declare namespace ShopifyBuy {
     }
 
     export interface Query {
+      /*
+      * query: title, collection_type, updated_at
+      * TODO probably will remove before Defintely Typed PR, 
+      * as their  community guidelines
+      */
         query: string;
         sortBy: string;
         after?: string;
@@ -390,9 +395,7 @@ declare namespace ShopifyBuy {
         value: string;
     }
 
-    export interface GraphModel {
-
-    }
+    export interface GraphModel {}
 }
 
 declare module "shopify-buy" {

From 0f79908f2fea658205fe262788fd16170a7514c4 Mon Sep 17 00:00:00 2001
From: Joshua Goldberg <josh@fullscreenmario.com>
Date: Sun, 3 Jun 2018 17:08:40 -0700
Subject: [PATCH 009/180] Added selenium-webdriver missing fields to Firefox
 Options

---
 types/selenium-webdriver/firefox.d.ts    | 36 ++++++++++++++++++++++++
 types/selenium-webdriver/test/firefox.ts |  6 ++++
 2 files changed, 42 insertions(+)

diff --git a/types/selenium-webdriver/firefox.d.ts b/types/selenium-webdriver/firefox.d.ts
index ce8a14216e..fcb8e74520 100644
--- a/types/selenium-webdriver/firefox.d.ts
+++ b/types/selenium-webdriver/firefox.d.ts
@@ -149,6 +149,15 @@ export class Profile {
  * Configuration options for the FirefoxDriver.
  */
 export class Options {
+    /**
+     * Specify additional command line arguments that should be used when starting
+     * the Firefox browser.
+     *
+     * @param {...(string|!Array<string>)} args The arguments to include.
+     * @return {!Options} A self reference.
+     */
+    addArguments(...args: string[]): Options;
+
     /**
      * Sets the browser to be in headless mode.
      *
@@ -156,6 +165,33 @@ export class Options {
      */
     headless(): Options;
 
+    /**
+    * Sets the initial window size when running in
+    * {@linkplain #headless headless} mode.
+    *
+    * @param {{width: number, height: number}} size The desired window size.
+    * @return {!Options} A self reference.
+    * @throws {TypeError} if width or height is unspecified, not a number, or
+    *     less than or equal to 0.
+    */
+    windowSize(size: { width: number, height: number }): Options;
+
+    /**
+     * Add extensions that should be installed when starting Firefox.
+     *
+     * @param {...string} paths The paths to the extension XPI files to install.
+     * @return {!Options} A self reference.
+     */
+    addExtensions(...paths: string[]): Options;
+
+    /**
+     * @param {string} key the preference key.
+     * @param {(string|number|boolean)} value the preference value.
+     * @return {!Options} A self reference.
+     * @throws {TypeError} if either the key or value has an invalid type.
+     */
+    setPreference(key: string, value: string | number | boolean): Options;
+
     /**
      * Sets the profile to use. The profile may be specified as a
      * {@link Profile} object or as the path to an existing Firefox profile to use
diff --git a/types/selenium-webdriver/test/firefox.ts b/types/selenium-webdriver/test/firefox.ts
index 0a8cabda41..ee5b55bbaa 100644
--- a/types/selenium-webdriver/test/firefox.ts
+++ b/types/selenium-webdriver/test/firefox.ts
@@ -25,6 +25,12 @@ function TestFirefoxDriver() {
 function TestFirefoxOptions() {
     let options: firefox.Options = new firefox.Options();
 
+    options = options.addArguments('foo', 'bar');
+    options = options.windowSize({ width: 320, height: 480 });
+    options = options.addExtensions('foo', 'bar');
+    options = options.setPreference('a', 1);
+    options = options.setPreference('a', true);
+    options = options.setPreference('a', '1');
     options = options.setBinary('binary');
     options = options.setBinary(new firefox.Binary());
     options = options.setLoggingPreferences(new webdriver.logging.Preferences());

From 3f5db30997130d862b734776228d0c49e7ae241c Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 00:26:08 -0400
Subject: [PATCH 010/180] updated the clients pagination to be generic for all
 graphql models

---
 types/shopify-buy/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index c2fd12962b..cb2fd741fe 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -23,7 +23,7 @@ declare namespace ShopifyBuy {
         checkout: ShopifyBuy.CheckoutAPI;
         shop: any;
         image: Image;
-        fetchNextPage(T: GraphModel[]): GraphModel[];
+        fetchNextPage<T extends GraphModel>(nextArray: T[]): T[];
     }
     export interface Config {
         domain: string;

From 9754a4695b229b4a96beefd28c1b49951f045179 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 00:26:59 -0400
Subject: [PATCH 011/180] Fixed obvious verbose type delcaration that was not
 tidy

---
 types/shopify-buy/index.d.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index cb2fd741fe..527b666fbd 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -15,7 +15,7 @@
  */
 
 declare namespace ShopifyBuy {
-    export function buildClient(config: ShopifyBuy.Config): Client;
+    export function buildClient(config: Config): Client;
 
     export interface Client {
         product: ShopifyBuy.ProductAPI;
@@ -25,6 +25,7 @@ declare namespace ShopifyBuy {
         image: Image;
         fetchNextPage<T extends GraphModel>(nextArray: T[]): T[];
     }
+
     export interface Config {
         domain: string;
         storefrontAccessToken: string;

From 10ae9c568f1528a2c8adbe6fd5bd1d39370e7985 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 00:28:03 -0400
Subject: [PATCH 012/180] Changed the naming scheme to fall inline with the
 documentation

---
 types/shopify-buy/index.d.ts | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 527b666fbd..55ce3fa9c2 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -18,9 +18,9 @@ declare namespace ShopifyBuy {
     export function buildClient(config: Config): Client;
 
     export interface Client {
-        product: ShopifyBuy.ProductAPI;
-        collection: ShopifyBuy.CollectionAPI;
-        checkout: ShopifyBuy.CheckoutAPI;
+        product: ShopifyBuy.ProductResource;
+        collection: ShopifyBuy.CollectionResource;
+        checkout: ShopifyBuy.CheckoutResource;
         shop: any;
         image: Image;
         fetchNextPage<T extends GraphModel>(nextArray: T[]): T[];
@@ -31,13 +31,13 @@ declare namespace ShopifyBuy {
         storefrontAccessToken: string;
     }
 
-    export interface ProductAPI {
+    export interface ProductResource {
         fetch(id: string): Promise<Product[]>;
         fetchQuery(id: Query): Promise<Product[]>;
         fetchAll(): Promise<Product[]>;
     }
 
-    export interface CollectionAPI {
+    export interface CollectionResource {
         fetch(id: string): Promise<Product[]>;
         fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type: Docs: Fetches a single collection by ID on the shop, not including products.
         fetchAll(): Promise<any[]>; // TODO fix to be a type: Docs: Fetches all collections on the shop, not including products.
@@ -50,7 +50,7 @@ declare namespace ShopifyBuy {
     /*
     *   https://shopify.github.io/js-buy-sdk/CheckoutResource.html
     */
-    export interface CheckoutAPI {
+    export interface CheckoutResource {
         create(
             email: string,
             lineItems: LineItem[],

From 2885a7b263ff269bc4a0e328d7f51fd6d65deb6a Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 00:42:41 -0400
Subject: [PATCH 013/180] Walked Through the Product Resource documentation to
 add all methods and types asscoiated, as well as rearanged the interfaces in
 logical order with related concepts , ei Address with cart instance etc

---
 types/shopify-buy/index.d.ts | 57 +++++++++++++++++++++---------------
 1 file changed, 34 insertions(+), 23 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 55ce3fa9c2..d922263fd9 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -21,7 +21,7 @@ declare namespace ShopifyBuy {
         product: ShopifyBuy.ProductResource;
         collection: ShopifyBuy.CollectionResource;
         checkout: ShopifyBuy.CheckoutResource;
-        shop: any;
+        shop: ShopResource;
         image: Image;
         fetchNextPage<T extends GraphModel>(nextArray: T[]): T[];
     }
@@ -32,9 +32,11 @@ declare namespace ShopifyBuy {
     }
 
     export interface ProductResource {
-        fetch(id: string): Promise<Product[]>;
-        fetchQuery(id: Query): Promise<Product[]>;
-        fetchAll(): Promise<Product[]>;
+        fetch(id: string): Promise<Product>;
+        fetchAll(pageSizeopt: number): Promise<Product[]>;
+        fetchByHandle(handle: string): Promise<Product>;
+        fetchMultiple(ids: string[]): Promise<Product[]>;
+        fetchQuery(query: Query): Promise<Product[]>;
     }
 
     export interface CollectionResource {
@@ -93,6 +95,11 @@ declare namespace ShopifyBuy {
         ): Promise<Cart>;
     }
 
+    export interface ShopResource {
+        fetchInfo():Promise<Shop>;
+        fetchPolicies(): Promise<Shop>;
+    }
+
     export interface Query {
       /*
       * query: title, collection_type, updated_at
@@ -251,6 +258,12 @@ declare namespace ShopifyBuy {
         values: Array<any>;
     }
 
+    export interface OptionValue {
+        name: string;
+        option_id: string;
+        value: any;
+    }
+
     /* 
     *   TODO this should be solved during TDD
     *   export interface Collection {} 
@@ -350,6 +363,23 @@ declare namespace ShopifyBuy {
         quantity: number;
     }
 
+    export interface Address {
+        address1: String;
+        address2: String;
+        city: String;
+        company: String;
+        country: String;
+        firstName: String;
+        lastName: String;
+        phone: String;
+        province: String;
+        zip: String;
+    }
+
+    export interface Shop {
+
+    }
+
     /**
      * Internal Image description
      */
@@ -369,25 +399,6 @@ declare namespace ShopifyBuy {
         src: string;
     }
 
-    export interface OptionValue {
-        name: string;
-        option_id: string;
-        value: any;
-    }
-
-    export interface Address {
-        address1: String;
-        address2: String;
-        city: String;
-        company: String;
-        country: String;
-        firstName: String;
-        lastName: String;
-        phone: String;
-        province: String;
-        zip: String;
-    }
-
     /* 
     *   https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
     */

From 5e444e43136d6a791b77500332e6adc9f72f1e4a Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 00:55:12 -0400
Subject: [PATCH 014/180] Added ImageVariant helper namespace

---
 types/shopify-buy/index.d.ts | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index d922263fd9..a62378e437 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -397,6 +397,18 @@ declare namespace ShopifyBuy {
         name: string;
         dimensions: string;
         src: string;
+        /*
+        * Returns src URL for new image size/variant
+        * @param image The image you would like a different size for.
+        * @param options Image Max width and height configuration.
+        */
+        imageForSize(image: Image, options: ImageOptions): string;
+
+    }
+
+    export interface ImageOptions {
+        maxWidth: number;
+        maxHeight: number;
     }
 
     /* 

From 85d3e66bf0ad6b269bab74d554cf6203395c7678 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:01:20 -0400
Subject: [PATCH 015/180] Added ProductVariant helper namespace

---
 types/shopify-buy/index.d.ts | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index a62378e437..975b58e233 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -37,6 +37,12 @@ declare namespace ShopifyBuy {
         fetchByHandle(handle: string): Promise<Product>;
         fetchMultiple(ids: string[]): Promise<Product[]>;
         fetchQuery(query: Query): Promise<Product[]>;
+
+        /*
+        *   Product Helper Namespace
+        *   @see {@link https://shopify.github.io/js-buy-sdk/ProductResource.html}
+        */
+        variantForOptions(product: Product, options: Option): ProductVariant;
     }
 
     export interface CollectionResource {
@@ -255,7 +261,7 @@ declare namespace ShopifyBuy {
          * an Array possible values for option. For instance if this option
          * is a "Size" option an example value for values could be: ["Large", "Medium", "Small"]
          */
-        values: Array<any>;
+        values: Array<OptionValue>;
     }
 
     export interface OptionValue {

From 7d0d56bcbb9ba3ca9e2b5728b69d6b62b76e6ab5 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:09:34 -0400
Subject: [PATCH 016/180] Completed type declarations using interfaces,
 Collection interface was derived from the rest api doc

---
 types/shopify-buy/index.d.ts | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 975b58e233..083a951e33 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -270,10 +270,20 @@ declare namespace ShopifyBuy {
         value: any;
     }
 
-    /* 
-    *   TODO this should be solved during TDD
-    *   export interface Collection {} 
-    */
+    export interface Collection {
+        handle: string;
+        body_html: string;
+        image: Image;
+        id: string;
+        metafields: any[];
+        published: boolean;
+        published_at: string;
+        published_scope: string;
+        sort_order:  string;
+        template_suffix: string;
+        title: string;
+        updated_at: string;
+    }
 
     export interface Cart extends GraphModel {
         /**

From 69b2cf04df1fd12e23af3b95235ad0cb5da565e2 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:17:22 -0400
Subject: [PATCH 017/180] Cleaning declaration file code for PR, unit test is
 to be completed before PR can be placed

---
 types/shopify-buy/index.d.ts | 24 +++++++++---------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 083a951e33..fe7da1f8f9 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -38,9 +38,9 @@ declare namespace ShopifyBuy {
         fetchMultiple(ids: string[]): Promise<Product[]>;
         fetchQuery(query: Query): Promise<Product[]>;
 
-        /*
+        /**
         *   Product Helper Namespace
-        *   @see {@link https://shopify.github.io/js-buy-sdk/ProductResource.html}
+        *   @link https://shopify.github.io/js-buy-sdk/ProductResource.html
         */
         variantForOptions(product: Product, options: Option): ProductVariant;
     }
@@ -55,9 +55,6 @@ declare namespace ShopifyBuy {
         fetchQuery(query: Query): Promise<any[]>; // TODO fix to be a type: DOC: Fetches a collection by handle on the shop. Assuming it does not give products
     }
 
-    /*
-    *   https://shopify.github.io/js-buy-sdk/CheckoutResource.html
-    */
     export interface CheckoutResource {
         create(
             email: string,
@@ -102,12 +99,12 @@ declare namespace ShopifyBuy {
     }
 
     export interface ShopResource {
-        fetchInfo():Promise<Shop>;
+        fetchInfo(): Promise<Shop>;
         fetchPolicies(): Promise<Shop>;
     }
 
     export interface Query {
-      /*
+     /**
       * query: title, collection_type, updated_at
       * TODO probably will remove before Defintely Typed PR, 
       * as their  community guidelines
@@ -279,7 +276,7 @@ declare namespace ShopifyBuy {
         published: boolean;
         published_at: string;
         published_scope: string;
-        sort_order:  string;
+        sort_order: string;
         template_suffix: string;
         title: string;
         updated_at: string;
@@ -392,9 +389,7 @@ declare namespace ShopifyBuy {
         zip: String;
     }
 
-    export interface Shop {
-
-    }
+    export interface Shop {}
 
     /**
      * Internal Image description
@@ -413,13 +408,12 @@ declare namespace ShopifyBuy {
         name: string;
         dimensions: string;
         src: string;
-        /*
+        /**
         * Returns src URL for new image size/variant
         * @param image The image you would like a different size for.
         * @param options Image Max width and height configuration.
         */
         imageForSize(image: Image, options: ImageOptions): string;
-
     }
 
     export interface ImageOptions {
@@ -427,8 +421,8 @@ declare namespace ShopifyBuy {
         maxHeight: number;
     }
 
-    /* 
-    *   https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
+    /**
+    *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
     */
     export interface AttributeInput {
         key: string;

From 382d259140acbb4c2f115b10396b7bde44416c6a Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:34:38 -0400
Subject: [PATCH 018/180] Updated interfaces to match unit test, as well as
 identified missing properties etc

---
 types/shopify-buy/index.d.ts | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index fe7da1f8f9..66a90d691c 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -57,11 +57,11 @@ declare namespace ShopifyBuy {
 
     export interface CheckoutResource {
         create(
-            email: string,
-            lineItems: LineItem[],
-            shippingAddress: Address,
-            note: string,
-            customAttributes: AttributeInput[]
+            email?: string,
+            lineItems?: LineItem[],
+            shippingAddress?: Address,
+            note?: string,
+            customAttributes?: AttributeInput[]
         ): Promise<Cart>;
 
         fetch(id: string): Promise<Cart>;
@@ -86,15 +86,15 @@ declare namespace ShopifyBuy {
          */
         removeLineItem(
             checkoutId: string,
-            lineItems: LineItem[]
+            lineItemIds: string[]
         ): Promise<Cart>;
 
         /**
          * Update a line item quantity based on line item id
          */
         updateLineItem(
-            checkoutId: string,
-            lineItems: LineItem[]
+            checkoutId:  string | number,
+            lineItems: AttributeInput[]
         ): Promise<Cart>;
     }
 
@@ -422,14 +422,21 @@ declare namespace ShopifyBuy {
     }
 
     /**
-    *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
-    */
+     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
+     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/checkoutlineitemupdateinput
+     */
     export interface AttributeInput {
         key: string;
         value: string;
+        id?: string;
+        quantity?: number;
+        variantId?: string;
     }
 
     export interface GraphModel {}
+
+    // still have not figured this one out.
+    //export interface NO_IMAGE_URI extends string;
 }
 
 declare module "shopify-buy" {

From 5d4312fe069cd8c1bc9a11a399ec43c57fc03353 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:45:05 -0400
Subject: [PATCH 019/180] Updated types used in shgopify buy tests, updated the
 flaws noticed in the type declaration. Still figuring out the not image url
 export that is required.

---
 types/shopify-buy/index.d.ts           | 12 ++---
 types/shopify-buy/shopify-buy-tests.ts | 65 ++++++++++++++------------
 2 files changed, 40 insertions(+), 37 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 66a90d691c..04e786e28b 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -66,13 +66,13 @@ declare namespace ShopifyBuy {
 
         fetch(id: string): Promise<Cart>;
 
-        addLineItems(checkoutId: string, lineItems: LineItem[]): Promise<Cart>;
+        addLineItems(checkoutId: string | number, lineItems: LineItem[]): Promise<Cart>;
 
         /**
          * Remove all line items from cart
          */
         clearLineItems(
-            checkoutId: string,
+            checkoutId: string | number,
             lineItems: LineItem[]
         ): Promise<Cart>;
 
@@ -85,7 +85,7 @@ declare namespace ShopifyBuy {
          * Remove a line item from cart based on line item id
          */
         removeLineItem(
-            checkoutId: string,
+            checkoutId: string | number,
             lineItemIds: string[]
         ): Promise<Cart>;
 
@@ -426,9 +426,9 @@ declare namespace ShopifyBuy {
      *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/checkoutlineitemupdateinput
      */
     export interface AttributeInput {
-        key: string;
-        value: string;
-        id?: string;
+        key?: string;
+        value?: string;
+        id?: string | number;
         quantity?: number;
         variantId?: string;
     }
diff --git a/types/shopify-buy/shopify-buy-tests.ts b/types/shopify-buy/shopify-buy-tests.ts
index aeacacd216..57071b43b5 100644
--- a/types/shopify-buy/shopify-buy-tests.ts
+++ b/types/shopify-buy/shopify-buy-tests.ts
@@ -3,22 +3,21 @@
 /* Build new ShopifyBuy client
 ============================================================ */
 let client = ShopifyBuy.buildClient({
-    apiKey: 'bf081e860bc9dc1ce0654fdfbc20892d',
     domain: 'embeds',
-    appId: '6'
+    storefrontAccessToken: ''
 });
 
-var product : ShopifyBuy.Shopify.ProductModel;
-var cart : ShopifyBuy.Shopify.CartModel;
+var product : ShopifyBuy.Product;
+var cart : ShopifyBuy.Cart;
 var cartLineItemCount : number;
 if(localStorage.getItem('lastCartId')) {
-    client.fetchCart(localStorage.getItem('lastCartId')).then(function(remoteCart : ShopifyBuy.Shopify.CartModel) {
+    client.checkout.fetch(localStorage.getItem('lastCartId')).then(function(remoteCart : ShopifyBuy.Cart) {
         cart = remoteCart;
         cartLineItemCount = cart.lineItems.length;
         renderCartItems();
     });
 } else {
-    client.createCart().then(function (newCart : ShopifyBuy.Shopify.CartModel) {
+    client.checkout.create().then(function (newCart : ShopifyBuy.Cart) {
         cart = newCart;
         localStorage.setItem('lastCartId', ""+cart.id);
         cartLineItemCount = 0;
@@ -29,11 +28,11 @@ var previousFocusItem : any;
 
 /* Fetch product and init
 ============================================================ */
-client.fetchProduct('3614436099').then(function (fetchedProduct : ShopifyBuy.Shopify.ProductModel) {
+client.product.fetch('3614436099').then(function (fetchedProduct : ShopifyBuy.Product) {
     product = fetchedProduct;
-    var selectedVariant : ShopifyBuy.Shopify.ProductVariantModel = product.selectedVariant;
+    var selectedVariant : ShopifyBuy.ProductVariant = product.selectedVariant;
     var selectedVariantImage : any = product.selectedVariantImage;
-    var currentOptions : ShopifyBuy.Shopify.ProductOptionModel[] = product.options;
+    var currentOptions : ShopifyBuy.Option[] = product.options;
 
     var variantSelectors = generateSelectors(product);
     $('.variant-selectors').html(""+variantSelectors);
@@ -49,8 +48,8 @@ client.fetchProduct('3614436099').then(function (fetchedProduct : ShopifyBuy.Sho
 
 /* Generate DOM elements for variant selectors
 ============================================================ */
-function generateSelectors(product : ShopifyBuy.Shopify.ProductModel) {
-    var elements = product.options.map(function(option : ShopifyBuy.Shopify.ProductOptionModel) {
+function generateSelectors(product : ShopifyBuy.Product) {
+    var elements = product.options.map(function(option : ShopifyBuy.Option) {
         var optionsHtml = option.values.map(function(value : any) {
             return '<option value="' + value + '">' + value + '</option>';
         });
@@ -121,16 +120,16 @@ function bindEventListeners() {
 
 /* Variant option change handler
 ============================================================ */
-function attachOnVariantSelectListeners(product : ShopifyBuy.Shopify.ProductModel) {
+function attachOnVariantSelectListeners(product : ShopifyBuy.Product) {
     $('.variant-selectors').on('change', 'select', function(event) {
         var $element : any = $(event.target);
         var name : string = $element.attr('name');
         var value : string = $element.val();
-        product.options.filter(function(option : ShopifyBuy.Shopify.ProductOptionModel) {
+        product.options.filter(function(option : ShopifyBuy.Option) {
             return option.name === name;
         })[0].selected = value;
 
-        var selectedVariant : ShopifyBuy.Shopify.ProductVariantModel = product.selectedVariant;
+        var selectedVariant : ShopifyBuy.ProductVariant = product.selectedVariant;
         var selectedVariantImage : any = product.selectedVariantImage;
         updateProductTitle(product.title);
         updateVariantImage(selectedVariantImage);
@@ -148,20 +147,20 @@ function updateProductTitle(title : string) {
 /* Update product image based on selected variant
 ============================================================ */
 function updateVariantImage(image : any) {
-    var src = (image) ? image.src : ShopifyBuy.NO_IMAGE_URI;
+    var src = (image) ? image.src : ShopifyBuy.NO_IMAGE_URI; // TODO
 
     $('#buy-button-1 .variant-image').attr('src', src);
 }
 
 /* Update product variant title based on selected variant
 ============================================================ */
-function updateVariantTitle(variant : ShopifyBuy.Shopify.ProductVariantModel) {
+function updateVariantTitle(variant : ShopifyBuy.ProductVariant) {
     $('#buy-button-1 .variant-title').text(variant.title);
 }
 
 /* Update product variant price based on selected variant
 ============================================================ */
-function updateVariantPrice(variant : ShopifyBuy.Shopify.ProductVariantModel) {
+function updateVariantPrice(variant : ShopifyBuy.ProductVariant) {
     $('#buy-button-1 .variant-price').text('$' + variant.price);
 }
 
@@ -171,7 +170,7 @@ function buyButtonClickHandler(evt : any) {
     evt.preventDefault();
     var id : string | number = product.selectedVariant.id;
     var quantity : number;
-    var cartLineItem : ShopifyBuy.Shopify.CartLineItemModel = findCartItemByVariantId(id);
+    var cartLineItem : ShopifyBuy.LineItem = findCartItemByVariantId(id);
 
     quantity = cartLineItem ? cartLineItem.quantity + 1 : 1;
 
@@ -183,11 +182,11 @@ function buyButtonClickHandler(evt : any) {
 /* Update product variant quantity in cart
 ============================================================ */
 function updateQuantity(fn : Function, variantId : string | number) {
-    var variant : ShopifyBuy.Shopify.ProductVariantModel = product.variants.filter(function (variant : ShopifyBuy.Shopify.ProductVariantModel) {
+    var variant : ShopifyBuy.ProductVariant = product.variants.filter(function (variant : ShopifyBuy.ProductVariant) {
         return (variant.id === variantId);
     })[0];
     var quantity : number;
-    var cartLineItem : ShopifyBuy.Shopify.CartLineItemModel = findCartItemByVariantId(variant.id);
+    var cartLineItem : ShopifyBuy.LineItem = findCartItemByVariantId(variant.id);
     if (cartLineItem) {
         quantity = fn(cartLineItem.quantity);
         updateVariantInCart(cartLineItem, quantity);
@@ -214,10 +213,10 @@ function incrementQuantity(variantId : string | number) {
 ============================================================ */
 function fieldQuantityHandler(evt : any) {
     var variantId : string | number = parseInt($(this).closest('.cart-item').attr('data-variant-id'), 10);
-    var variant : ShopifyBuy.Shopify.ProductVariantModel = product.variants.filter(function (variant : ShopifyBuy.Shopify.ProductVariantModel) {
+    var variant : ShopifyBuy.ProductVariant = product.variants.filter(function (variant : ShopifyBuy.ProductVariant) {
         return (variant.id === variantId);
     })[0];
-    var cartLineItem : ShopifyBuy.Shopify.CartLineItemModel = findCartItemByVariantId(variant.id);
+    var cartLineItem : ShopifyBuy.LineItem = findCartItemByVariantId(variant.id);
     var quantity : number = evt.target.value;
     if (cartLineItem) {
         updateVariantInCart(cartLineItem, quantity);
@@ -264,9 +263,9 @@ function findCartItemByVariantId(variantId : string | number) {
 
 /* Determine action for variant adding/updating/removing
 ============================================================ */
-function addOrUpdateVariant(variant : ShopifyBuy.Shopify.ProductVariantModel, quantity : number) {
+function addOrUpdateVariant(variant : ShopifyBuy.ProductVariant, quantity : number) {
     openCart();
-    var cartLineItem : ShopifyBuy.Shopify.CartLineItemModel = findCartItemByVariantId(variant.id);
+    var cartLineItem : ShopifyBuy.LineItem = findCartItemByVariantId(variant.id);
 
     if (cartLineItem) {
         updateVariantInCart(cartLineItem, quantity);
@@ -279,10 +278,14 @@ function addOrUpdateVariant(variant : ShopifyBuy.Shopify.ProductVariantModel, qu
 
 /* Update details for item already in cart. Remove if necessary
 ============================================================ */
-function updateVariantInCart(cartLineItem : ShopifyBuy.Shopify.CartLineItemModel, quantity : number) {
+function updateVariantInCart(cartLineItem : ShopifyBuy.LineItem, quantity : number) {
     var variantId : string | number = cartLineItem.variant_id;
     var cartLength : number = cart.lineItems.length;
-    cart.updateLineItem(cartLineItem.id, quantity).then(function(updatedCart : ShopifyBuy.Shopify.CartModel) {
+    let lineItemVariant: ShopifyBuy.AttributeInput = {
+        id: cartLineItem.id,
+        quantity
+    };
+    client.checkout.updateLineItem(cartLineItem.id, [lineItemVariant]).then(function(updatedCart : ShopifyBuy.Cart) {
         var $cartItem = $('.cart').find('.cart-item[data-variant-id="' + variantId + '"]');
         if (updatedCart.lineItems.length >= cartLength) {
             $cartItem.find('.cart-item__quantity').val(cartLineItem.quantity);
@@ -306,11 +309,11 @@ function updateVariantInCart(cartLineItem : ShopifyBuy.Shopify.CartLineItemModel
 
 /* Add 'quantity' amount of product 'variant' to cart
 ============================================================ */
-function addVariantToCart(variant : ShopifyBuy.Shopify.ProductVariantModel, quantity : number) {
+function addVariantToCart(variant : ShopifyBuy.ProductVariant, quantity : number) {
     openCart();
 
-    cart.addVariants({ variant: variant, quantity: quantity }).then(function() {
-        var cartItem : ShopifyBuy.Shopify.CartLineItemModel = cart.lineItems.filter(function (item : ShopifyBuy.Shopify.CartLineItemModel ) {
+    client.checkout.addVariants({ variant: variant, quantity: quantity }).then(function() {
+        var cartItem : ShopifyBuy.LineItem = cart.lineItems.filter(function (item : ShopifyBuy.LineItem ) {
             return (item.variant_id === variant.id);
         })[0];
         var $cartItem = renderCartItem(cartItem);
@@ -331,7 +334,7 @@ function addVariantToCart(variant : ShopifyBuy.Shopify.ProductVariantModel, quan
 
 /* Return required markup for single item rendering
 ============================================================ */
-function renderCartItem(lineItem : ShopifyBuy.Shopify.CartLineItemModel) {
+function renderCartItem(lineItem : ShopifyBuy.LineItem) {
     var lineItemEmptyTemplate = $('#CartItemTemplate').html();
     var $lineItemTemplate = $(lineItemEmptyTemplate);
     var itemImage = lineItem.image.src;
@@ -400,6 +403,6 @@ function updateCartTabButton() {
 
 /* Set previously focused item for escape handler
 ============================================================ */
-function setPreviousFocusItem(item : ShopifyBuy.Shopify.CartLineItemModel) {
+function setPreviousFocusItem(item : ShopifyBuy.LineItem) {
     previousFocusItem = item;
 }

From cdb51ba3d3e45d8f7fb1cfce56ea8a4e3126b7f8 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 01:50:25 -0400
Subject: [PATCH 020/180] Updated location of attributeInput to be closer to
 the cart and its childrens definition. no image uri was a var in the master
 branch so I updated that as well.

---
 types/shopify-buy/index.d.ts | 27 +++++++++++++--------------
 1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 04e786e28b..ea8d9b958d 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -389,6 +389,18 @@ declare namespace ShopifyBuy {
         zip: String;
     }
 
+     /**
+     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
+     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/checkoutlineitemupdateinput
+     */
+    export interface AttributeInput {
+        key?: string;
+        value?: string;
+        id?: string | number;
+        quantity?: number;
+        variantId?: string;
+    }
+
     export interface Shop {}
 
     /**
@@ -421,22 +433,9 @@ declare namespace ShopifyBuy {
         maxHeight: number;
     }
 
-    /**
-     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/attributeinput
-     *  https://help.shopify.com/api/custom-storefronts/storefront-api/reference/input_object/checkoutlineitemupdateinput
-     */
-    export interface AttributeInput {
-        key?: string;
-        value?: string;
-        id?: string | number;
-        quantity?: number;
-        variantId?: string;
-    }
+    let NO_IMAGE_URI: string;
 
     export interface GraphModel {}
-
-    // still have not figured this one out.
-    //export interface NO_IMAGE_URI extends string;
 }
 
 declare module "shopify-buy" {

From 462d760cd26dc418cbefec061b4f32aef2d5e300 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 02:03:56 -0400
Subject: [PATCH 021/180] Added test store private app for dedicated testing to
 be able to function

---
 types/shopify-buy/shopify-buy-tests.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/shopify-buy/shopify-buy-tests.ts b/types/shopify-buy/shopify-buy-tests.ts
index 57071b43b5..54152adee4 100644
--- a/types/shopify-buy/shopify-buy-tests.ts
+++ b/types/shopify-buy/shopify-buy-tests.ts
@@ -3,8 +3,8 @@
 /* Build new ShopifyBuy client
 ============================================================ */
 let client = ShopifyBuy.buildClient({
-    domain: 'embeds',
-    storefrontAccessToken: ''
+    domain: 'buyapitypestest.myshopify.com',
+    storefrontAccessToken: '9f30a6806b613e0cb551b7db59c5ca02'
 });
 
 var product : ShopifyBuy.Product;

From 17ffd807e3bca21f24432c9f50ff22a8266c7483 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 02:23:10 -0400
Subject: [PATCH 022/180] Updated the graphQL base model to have accurate
 properties I could prove through my NG6 wrapper service unit test. Updated
 the Store interface to not be blank

---
 types/shopify-buy/index.d.ts | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index ea8d9b958d..3a46e735f2 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -401,7 +401,25 @@ declare namespace ShopifyBuy {
         variantId?: string;
     }
 
-    export interface Shop {}
+    /**
+     * TODO Validate schema matches js-buy
+     * Derived from REST API Docs: https://help.shopify.com/api/custom-storefronts/storefront-api/reference/object/shop#fields
+     */
+    export interface Shop {
+
+        description: string;
+        moneyFormat: string;
+        name: string;
+        /**
+         * TODO Add types for the Shop properties below
+         * PaymentSettings, ShopPolicy etc
+         */
+        paymentSettings: any;
+        primaryDomain: any;
+        privacyPolicy: any;
+        refundPolicy: any;
+        termsOfService: any;
+    }
 
     /**
      * Internal Image description
@@ -435,7 +453,13 @@ declare namespace ShopifyBuy {
 
     let NO_IMAGE_URI: string;
 
-    export interface GraphModel {}
+    /*
+    *   Base Model for the higher level returned objects from the API using GraphQL
+    */
+    export interface GraphModel {
+        attrs?: any
+        onlineStoreUrl?: string
+    }
 }
 
 declare module "shopify-buy" {

From 15b7af0242ffb60bb351db1c7cd2c55743fe4e81 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 02:29:58 -0400
Subject: [PATCH 023/180] Updated type delcaration file to conform to the unit
 tests requirements and community requirements. As well as accurately update
 the versions to the lastest that the update was based and tested on.

---
 types/shopify-buy/index.d.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index 3a46e735f2..f1af570a06 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -1,9 +1,9 @@
-// Type definitions for shopify-buy v1.0.0
+// Type definitions for shopify-buy 1.4.0
 // Project: http://shopify.github.io/js-buy-sdk/api/
-// Definitions for 0.4.2 by: Martin Köhn <https://github.com/openminder>
-// Definitions update by: Stephen Traiforos <https://github.com/straiforos>
+// Definitions by: Martin Köhn <https://github.com/openminder>
+//                 Stephen Traiforos <https://github.com/straiforos>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.7.*
+// TypeScript Version: 2.7
 
 /**
  * The JS Buy SDK is a lightweight library that allows you to build ecommerce into any website.

From 995470d3a58fccb85e22b331a61e66b6dcae40f2 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 03:08:31 -0400
Subject: [PATCH 024/180] Making file more Prod ready, removing a comment
 noticed in self code review

---
 types/shopify-buy/shopify-buy-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/shopify-buy/shopify-buy-tests.ts b/types/shopify-buy/shopify-buy-tests.ts
index 54152adee4..0e65990121 100644
--- a/types/shopify-buy/shopify-buy-tests.ts
+++ b/types/shopify-buy/shopify-buy-tests.ts
@@ -147,7 +147,7 @@ function updateProductTitle(title : string) {
 /* Update product image based on selected variant
 ============================================================ */
 function updateVariantImage(image : any) {
-    var src = (image) ? image.src : ShopifyBuy.NO_IMAGE_URI; // TODO
+    var src = (image) ? image.src : ShopifyBuy.NO_IMAGE_URI;
 
     $('#buy-button-1 .variant-image').attr('src', src);
 }

From f3cff60d3c89b43ed0f119acdbf682ea2ec7d422 Mon Sep 17 00:00:00 2001
From: Triforce <stephen@traiforos.com>
Date: Mon, 4 Jun 2018 03:21:55 -0400
Subject: [PATCH 025/180] Self Code review noticed error for optional field and
 missing option

---
 types/shopify-buy/index.d.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/shopify-buy/index.d.ts b/types/shopify-buy/index.d.ts
index f1af570a06..413b9614f8 100644
--- a/types/shopify-buy/index.d.ts
+++ b/types/shopify-buy/index.d.ts
@@ -33,7 +33,7 @@ declare namespace ShopifyBuy {
 
     export interface ProductResource {
         fetch(id: string): Promise<Product>;
-        fetchAll(pageSizeopt: number): Promise<Product[]>;
+        fetchAll(pageSizeopt?: number): Promise<Product[]>;
         fetchByHandle(handle: string): Promise<Product>;
         fetchMultiple(ids: string[]): Promise<Product[]>;
         fetchQuery(query: Query): Promise<Product[]>;
@@ -48,7 +48,7 @@ declare namespace ShopifyBuy {
     export interface CollectionResource {
         fetch(id: string): Promise<Product[]>;
         fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type: Docs: Fetches a single collection by ID on the shop, not including products.
-        fetchAll(): Promise<any[]>; // TODO fix to be a type: Docs: Fetches all collections on the shop, not including products.
+        fetchAll(pageSizeopt?: number): Promise<any[]>; // TODO fix to be a type: Docs: Fetches all collections on the shop, not including products.
         fetchAllWithProducts(): Promise<any[]>; // TODO fix to be a type: DOC: Fetches all collections on the shop, including products.
         fetchWithProducts(id: string): Promise<any[]>; // TODO fix to be a type: DOC: Fetches all collections on the shop, including products.
         fetchByHandle(handle: string): Promise<any[]>; // TODO fix to be a type: DOC: Fetches a collection by handle on the shop. Assuming it does not give products

From 10ce8c472f1ad5e2aa8ecae56f1da5ba0e81eed7 Mon Sep 17 00:00:00 2001
From: Fabian Trampusch <fabian.trampusch@freenet.de>
Date: Mon, 4 Jun 2018 14:53:34 +0200
Subject: [PATCH 026/180] [@types/ltx] declare xmlns parameter for
 Element.getChildText optional

---
 types/ltx/lib/Element.d.ts | 2 +-
 types/ltx/ltx-tests.ts     | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/types/ltx/lib/Element.d.ts b/types/ltx/lib/Element.d.ts
index d0f50ae783..203eaa93b6 100644
--- a/types/ltx/lib/Element.d.ts
+++ b/types/ltx/lib/Element.d.ts
@@ -67,7 +67,7 @@ export declare class Element {
 
     getText(): string;
 
-    getChildText(name: string, xmlns: any): string;
+    getChildText(name: string, xmlns?: any): string;
 
     /**
      * Return all direct descendents that are Elements.
diff --git a/types/ltx/ltx-tests.ts b/types/ltx/ltx-tests.ts
index 1e617ad27d..522b7673c8 100644
--- a/types/ltx/ltx-tests.ts
+++ b/types/ltx/ltx-tests.ts
@@ -2,6 +2,11 @@ import * as ltx from 'ltx';
 
 ltx.parse('<document/>');
 
+const getChildTextElement = ltx.parse('<test><child>body text</child></test>') as ltx.Element;
+if (getChildTextElement.getChildText('child') !== 'body text') {
+    throw new Error("body does not match");
+}
+
 const p = new ltx.Parser();
 
 p.on('tree', (ignored: any) => {});

From 669052a0ae8755c48d38be5dc7b4fcef8bab7671 Mon Sep 17 00:00:00 2001
From: Quentin <QuentinFchx@users.noreply.github.com>
Date: Mon, 4 Jun 2018 15:07:31 +0200
Subject: [PATCH 027/180] Update moment-duration-format LocaleSpecification
 type

Properties should be optional. The original moment object [has](https://github.com/moment/moment/blob/2e2a5b35439665d4b0200143d808a7c26d6cd30f/moment.d.ts#L118) optional properties.
The moment-duration-format library [doest not](https://github.com/jsmreese/moment-duration-format/blob/19e55fe703fb725d5914cd3fb61cf4b378009fc1/lib/moment-duration-format.js#L48) require them.
---
 types/moment-duration-format/index.d.ts | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/types/moment-duration-format/index.d.ts b/types/moment-duration-format/index.d.ts
index 4506311ab6..1716d55d83 100644
--- a/types/moment-duration-format/index.d.ts
+++ b/types/moment-duration-format/index.d.ts
@@ -80,12 +80,12 @@ declare module "moment" {
     }
 
     interface LocaleSpecification {
-        durationLabelsLong: DurationLabelDef;
-        durationLabelsStandard: DurationLabelDef;
-        durationLabelsShort: DurationLabelDef;
-        durationTimeTemplates: DurationTimeDef;
-        durationLabelTypes: DurationLabelTypeDef[];
-        durationPluralKey: (token: string, integerValue: number, decimalValue: number) => string;
+        durationLabelsLong?: DurationLabelDef;
+        durationLabelsStandard?: DurationLabelDef;
+        durationLabelsShort?: DurationLabelDef;
+        durationTimeTemplates?: DurationTimeDef;
+        durationLabelTypes?: DurationLabelTypeDef[];
+        durationPluralKey?: (token: string, integerValue: number, decimalValue: number) => string;
     }
 
     type TemplateFunction = ((this: DurationFormatSettings) => string);

From c77275b10cdf02ce276bbdf16b83127d6d70d81e Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Fri, 11 May 2018 18:03:30 +0200
Subject: [PATCH 028/180] [reactstrap] Add Typings for CustomInput

---
 types/reactstrap/index.d.ts           |  3 +
 types/reactstrap/lib/CustomInput.d.ts | 22 +++++++
 types/reactstrap/reactstrap-tests.tsx | 89 +++++++++++++++++++++++++++
 3 files changed, 114 insertions(+)
 create mode 100644 types/reactstrap/lib/CustomInput.d.ts

diff --git a/types/reactstrap/index.d.ts b/types/reactstrap/index.d.ts
index b7c408183b..a42e7b6723 100644
--- a/types/reactstrap/index.d.ts
+++ b/types/reactstrap/index.d.ts
@@ -101,6 +101,9 @@ export { CollapseProps } from './lib/Collapse';
 import { default as Container_ } from './lib/Container';
 export class Container<T = {}> extends Container_<T> {}
 export { ContainerProps } from './lib/Container';
+export { default as CustomInput_ } from './lib/CustomInput';
+export class CustomerInput<T = {}> extends CustomInput_<T> {};
+export { CustomInputProps } from './lib/CustomInput';
 import { default as Dropdown_ } from './lib/Dropdown';
 export class Dropdown<T = {}> extends Dropdown_<T> {}
 export { DropdownProps } from './lib/Dropdown';
diff --git a/types/reactstrap/lib/CustomInput.d.ts b/types/reactstrap/lib/CustomInput.d.ts
new file mode 100644
index 0000000000..ff1d196667
--- /dev/null
+++ b/types/reactstrap/lib/CustomInput.d.ts
@@ -0,0 +1,22 @@
+import * as React from 'react';
+import { CSSModule } from '../index';
+
+export type CustomInputType =
+  | 'select'
+  | 'file'
+  | 'radio'
+  | 'checkbox';
+
+export type CustomInputProps<T = {}> = React.InputHTMLAttributes<HTMLInputElement> & {
+  type: CustomInputType;
+  label?: string;
+  inline?: boolean;
+  bsSize?: 'lg' | 'sm';
+  valid?: boolean;
+  invalid?: boolean;
+  className?: string;
+  cssModule?: CSSModule;
+} & T;
+
+declare class CustomInput<T> extends React.Component<CustomInputProps<T>> {}
+export default CustomInput;
diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index 550a1242a8..290e2657e1 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -35,6 +35,7 @@ import {
   Col,
   Container,
   Collapse,
+  CustomInput,
   Fade,
   Form,
   FormFeedback,
@@ -4051,3 +4052,91 @@ function GenericPropExample() {
     </React.Fragment >
   );
 }
+
+class Example118 extends React.Component {
+  render() {
+    return (
+      <Form>
+        <FormGroup>
+          <Label for="exampleCheckbox">Checkboxes</Label>
+          <div>
+            <CustomInput type="checkbox" id="exampleCustomCheckbox" label="Check this custom checkbox" />
+            <CustomInput type="checkbox" id="exampleCustomCheckbox2" label="Or this one" />
+            <CustomInput type="checkbox" id="exampleCustomCheckbox3" label="But not this disabled one" disabled />
+          </div>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCheckbox">Radios</Label>
+          <div>
+            <CustomInput type="radio" id="exampleCustomRadio" name="customRadio" label="Select this custom radio" />
+            <CustomInput type="radio" id="exampleCustomRadio2" name="customRadio" label="Or this one" />
+            <CustomInput type="radio" id="exampleCustomRadio3" label="But not this disabled one" disabled />
+          </div>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCheckbox">Inline</Label>
+          <div>
+            <CustomInput type="checkbox" id="exampleCustomInline" label="An inline custom input" inline />
+            <CustomInput type="checkbox" id="exampleCustomInline2" label="and another one" inline />
+          </div>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomSelect">Custom Select</Label>
+          <CustomInput type="select" id="exampleCustomSelect" name="customSelect">
+            <option value="">Select</option>
+            <option>Value 1</option>
+            <option>Value 2</option>
+            <option>Value 3</option>
+            <option>Value 4</option>
+            <option>Value 5</option>
+          </CustomInput>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomMutlipleSelect">Custom Multiple Select</Label>
+          <CustomInput type="select" id="exampleCustomMutlipleSelect" name="customSelect" multiple>
+            <option value="">Select</option>
+            <option>Value 1</option>
+            <option>Value 2</option>
+            <option>Value 3</option>
+            <option>Value 4</option>
+            <option>Value 5</option>
+          </CustomInput>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomSelectDisabled">Custom Select Disabled</Label>
+          <CustomInput type="select" id="exampleCustomSelectDisabled" name="customSelect" disabled>
+            <option value="">Select</option>
+            <option>Value 1</option>
+            <option>Value 2</option>
+            <option>Value 3</option>
+            <option>Value 4</option>
+            <option>Value 5</option>
+          </CustomInput>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomMutlipleSelectDisabled">Custom Multiple Select Disabled</Label>
+          <CustomInput type="select" id="exampleCustomMutlipleSelectDisabled" name="customSelect" multiple disabled>
+            <option value="">Select</option>
+            <option>Value 1</option>
+            <option>Value 2</option>
+            <option>Value 3</option>
+            <option>Value 4</option>
+            <option>Value 5</option>
+          </CustomInput>
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomFileBrowser">File Browser</Label>
+          <CustomInput type="file" id="exampleCustomFileBrowser" name="customFile" />
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomFileBrowser">File Browser with Custom Label</Label>
+          <CustomInput type="file" id="exampleCustomFileBrowser" name="customFile" label="Yo, pick a file!" />
+        </FormGroup>
+        <FormGroup>
+          <Label for="exampleCustomFileBrowser">File Browser Disabled</Label>
+          <CustomInput type="file" id="exampleCustomFileBrowser" name="customFile" disabled />
+        </FormGroup>
+      </Form>
+    );
+  }
+}

From ccbd12e286f14d5e55d37b3bfcd5cc4270a1ed40 Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Fri, 11 May 2018 18:08:10 +0200
Subject: [PATCH 029/180] [reactstrap] Add borderless type to Table

---
 types/reactstrap/lib/Table.d.ts       |  1 +
 types/reactstrap/reactstrap-tests.tsx | 39 ++++++++++++++++++++++++++-
 2 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/types/reactstrap/lib/Table.d.ts b/types/reactstrap/lib/Table.d.ts
index 394a1f3f40..8e59b6a13e 100644
--- a/types/reactstrap/lib/Table.d.ts
+++ b/types/reactstrap/lib/Table.d.ts
@@ -6,6 +6,7 @@ export type TableProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   cssModule?: CSSModule;
   size?: string;
   bordered?: boolean;
+  borderless?: boolean;
   striped?: boolean;
   inverse?: boolean;
   hover?: boolean;
diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index 290e2657e1..61bee46edc 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -4053,7 +4053,7 @@ function GenericPropExample() {
   );
 }
 
-class Example118 extends React.Component {
+class Example119 extends React.Component<any, any> {
   render() {
     return (
       <Form>
@@ -4140,3 +4140,40 @@ class Example118 extends React.Component {
     );
   }
 }
+
+class Example120 extends React.Component<any, any> {
+  render() {
+    return (
+      <Table borderless>
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>First Name</th>
+            <th>Last Name</th>
+            <th>Username</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <th scope="row">1</th>
+            <td>Mark</td>
+            <td>Otto</td>
+            <td>@mdo</td>
+          </tr>
+          <tr>
+            <th scope="row">2</th>
+            <td>Jacob</td>
+            <td>Thornton</td>
+            <td>@fat</td>
+          </tr>
+          <tr>
+            <th scope="row">3</th>
+            <td>Larry</td>
+            <td>the Bird</td>
+            <td>@twitter</td>
+          </tr>
+        </tbody>
+      </Table>
+    );
+  }
+}

From 7ea7631815deea1f94f9517364a4efc8a8bae2b9 Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Fri, 11 May 2018 18:43:48 +0200
Subject: [PATCH 030/180] [reactstrap] Add setActiveFromChild prop

---
 types/reactstrap/lib/Dropdown.d.ts    |  3 +++
 types/reactstrap/reactstrap-tests.tsx | 19 +++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/types/reactstrap/lib/Dropdown.d.ts b/types/reactstrap/lib/Dropdown.d.ts
index 59f827744e..12d001accd 100644
--- a/types/reactstrap/lib/Dropdown.d.ts
+++ b/types/reactstrap/lib/Dropdown.d.ts
@@ -14,7 +14,9 @@ export type UncontrolledProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   cssModule?: CSSModule;
   nav?: boolean;
   inNavbar?: boolean;
+  setActiveFromChild?: boolean;
 } & T;
+
 export type UncontrolledDropdownProps<T = {}> = UncontrolledProps<T>;
 
 export type Props<T = {}> = UncontrolledProps<T> & {
@@ -25,6 +27,7 @@ export type Props<T = {}> = UncontrolledProps<T> & {
   tag?: React.ReactType;
   addonType?: boolean | 'prepend' | 'append';
 };
+
 export type DropdownProps<T = {}> = Props<T>;
 
 declare class Dropdown<T = {[key: string]: any}> extends React.Component<DropdownProps<T>> {}
diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index 61bee46edc..b59ffa377d 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -4177,3 +4177,22 @@ class Example120 extends React.Component<any, any> {
     );
   }
 }
+
+class Example120 extends React.Component<any, any> {
+  render() {
+    return (
+      <UncontrolledDropdown className="some-class" setActiveFromChild>
+        <DropdownToggle caret>
+          Dropdown
+        </DropdownToggle>
+        <DropdownMenu>
+          <DropdownItem header>Header</DropdownItem>
+          <DropdownItem disabled>Action</DropdownItem>
+          <DropdownItem>Another Action</DropdownItem>
+          <DropdownItem divider />
+          <DropdownItem>Another Action</DropdownItem>
+        </DropdownMenu>
+      </UncontrolledDropdown>
+    );
+  }
+}

From 98ba0b7e2e9000246dab8abb9e04328a14ad1a6e Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Fri, 11 May 2018 18:44:47 +0200
Subject: [PATCH 031/180] [reactstrap] Add DropdownMenu persist and modifiers
 props

---
 types/reactstrap/lib/DropdownMenu.d.ts |  3 +++
 types/reactstrap/reactstrap-tests.tsx  | 34 ++++++++++++++++++++++++++
 2 files changed, 37 insertions(+)

diff --git a/types/reactstrap/lib/DropdownMenu.d.ts b/types/reactstrap/lib/DropdownMenu.d.ts
index e485fad076..814771e87f 100644
--- a/types/reactstrap/lib/DropdownMenu.d.ts
+++ b/types/reactstrap/lib/DropdownMenu.d.ts
@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { CSSModule } from '../index';
+import { Popper } from './Popper';
 
 export type DropdownMenuProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   tag?: React.ReactType;
@@ -7,6 +8,8 @@ export type DropdownMenuProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   className?: string;
   cssModule?: CSSModule;
   flip?: boolean;
+  modifiers?: Popper.Modifiers;
+  persist?: boolean;
 } & T;
 
 declare class DropdownMenu<T = {[key: string]: any}> extends React.Component<DropdownMenuProps<T>> {}
diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index b59ffa377d..05974e77d6 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -4196,3 +4196,37 @@ class Example120 extends React.Component<any, any> {
     );
   }
 }
+
+class Example121 extends React.Component<any, any> {
+  constructor(props: any) {
+    super(props);
+
+    this.toggle = this.toggle.bind(this);
+    this.state = {
+      dropdownOpen: false
+    };
+  }
+
+  toggle() {
+    this.setState({
+      dropdownOpen: !this.state.dropdownOpen
+    });
+  }
+
+  render() {
+    return (
+      <Dropdown isOpen={this.state.dropdownOpen} toggle={this.toggle}>
+        <DropdownToggle caret>
+          Dropdown
+        </DropdownToggle>
+        <DropdownMenu persist>
+          <DropdownItem header>Header</DropdownItem>
+          <DropdownItem disabled>Action</DropdownItem>
+          <DropdownItem>Another Action</DropdownItem>
+          <DropdownItem divider />
+          <DropdownItem>Another Action</DropdownItem>
+        </DropdownMenu>
+      </Dropdown>
+    );
+  }
+}

From 14dc64eac5270e797e1bbb5eb7223a3cf568375c Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Sat, 12 May 2018 18:00:01 +0200
Subject: [PATCH 032/180] [reactstrap] Bump to 6.0

---
 types/reactstrap/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/reactstrap/index.d.ts b/types/reactstrap/index.d.ts
index a42e7b6723..355ed59841 100644
--- a/types/reactstrap/index.d.ts
+++ b/types/reactstrap/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for reactstrap 5.0
+// Type definitions for reactstrap 6.0
 // Project: https://github.com/reactstrap/reactstrap#readme
 // Definitions by: Ali Hammad Baig <https://github.com/alihammad>
 //                 Marco Falkenberg <https://github.com/mfal>

From 9afbbb00fb842f7f8cc54eacac9cf4b9e50b9ce9 Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Wed, 6 Jun 2018 16:26:42 +0200
Subject: [PATCH 033/180] Correct tests

---
 types/reactstrap/reactstrap-tests.tsx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index 05974e77d6..2167922704 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -4178,7 +4178,7 @@ class Example120 extends React.Component<any, any> {
   }
 }
 
-class Example120 extends React.Component<any, any> {
+class Example121 extends React.Component<any, any> {
   render() {
     return (
       <UncontrolledDropdown className="some-class" setActiveFromChild>
@@ -4197,7 +4197,7 @@ class Example120 extends React.Component<any, any> {
   }
 }
 
-class Example121 extends React.Component<any, any> {
+class Example122 extends React.Component<any, any> {
   constructor(props: any) {
     super(props);
 

From 83315b7319034ff1a5a3ae9d4e50c327e5718e9d Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Wed, 6 Jun 2018 16:33:31 +0200
Subject: [PATCH 034/180] Fix CustomInput export typo

---
 types/reactstrap/index.d.ts           | 4 ++--
 types/reactstrap/lib/CustomInput.d.ts | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/types/reactstrap/index.d.ts b/types/reactstrap/index.d.ts
index 355ed59841..45f885b172 100644
--- a/types/reactstrap/index.d.ts
+++ b/types/reactstrap/index.d.ts
@@ -101,8 +101,8 @@ export { CollapseProps } from './lib/Collapse';
 import { default as Container_ } from './lib/Container';
 export class Container<T = {}> extends Container_<T> {}
 export { ContainerProps } from './lib/Container';
-export { default as CustomInput_ } from './lib/CustomInput';
-export class CustomerInput<T = {}> extends CustomInput_<T> {};
+import { default as CustomInput_ } from './lib/CustomInput';
+export class CustomInput<T = {}> extends CustomInput_<T> {}
 export { CustomInputProps } from './lib/CustomInput';
 import { default as Dropdown_ } from './lib/Dropdown';
 export class Dropdown<T = {}> extends Dropdown_<T> {}
diff --git a/types/reactstrap/lib/CustomInput.d.ts b/types/reactstrap/lib/CustomInput.d.ts
index ff1d196667..f2629a8da3 100644
--- a/types/reactstrap/lib/CustomInput.d.ts
+++ b/types/reactstrap/lib/CustomInput.d.ts
@@ -18,5 +18,5 @@ export type CustomInputProps<T = {}> = React.InputHTMLAttributes<HTMLInputElemen
   cssModule?: CSSModule;
 } & T;
 
-declare class CustomInput<T> extends React.Component<CustomInputProps<T>> {}
+declare class CustomInput<T = {[key: string]: any}> extends React.Component<CustomInputProps<T>> {}
 export default CustomInput;

From 3d26b490c53a41596cb2bcf86d6d752c7b3cb97d Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Wed, 6 Jun 2018 16:57:10 -0700
Subject: [PATCH 035/180] Event class documentation

---
 types/office-js/index.d.ts | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 5af6916816..4d06e7b764 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -523,7 +523,7 @@ declare namespace Office {
          */
         name: string;
     }
-    export namespace AddinCommands {
+    namespace AddinCommands {
         /**
          * The event object is passed as a parameter to add-in functions invoked by UI-less command buttons. The object allows the add-in to identify which button was clicked and to signal the host that it has completed its processing.
          * 
@@ -539,8 +539,13 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Compose or Read
          */
-        export interface Event {
+        interface Event {
             
+            /**
+             * Information about the control that triggered calling this function
+             */
+            source:Source;
+
             /**
              * Indicates that the add-in has completed processing that was triggered by an add-in command button or event handler.
              * 
@@ -561,6 +566,17 @@ declare namespace Office {
              */
             completed(options?: any): void;
         }
+
+        /**
+         * Encapsulates source data for add-in events.
+         */
+        interface Source {
+
+            /**
+             * The id of the control that triggered calling this function. The id comes from the manifest and is the unique ID of your Office Add-in as a GUID.
+             */
+            id: string;
+        }
     }
     /**
      * Provides objects and methods that you can use to create and manipulate UI components, such as dialog boxes, in your Office Add-ins.

From 405abf22d4e3f3d05e487144717154f9f8c236cb Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Thu, 7 Jun 2018 19:04:58 +0200
Subject: [PATCH 036/180] Add CustomInput to AnyPropsExample and
 GenericPropsExample tests

---
 types/reactstrap/reactstrap-tests.tsx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/types/reactstrap/reactstrap-tests.tsx b/types/reactstrap/reactstrap-tests.tsx
index 2167922704..4516db6329 100644
--- a/types/reactstrap/reactstrap-tests.tsx
+++ b/types/reactstrap/reactstrap-tests.tsx
@@ -3753,6 +3753,7 @@ import { default as CarouselCaption_ } from './lib/CarouselCaption'; /* tslint:d
 import { default as Col_ } from './lib/Col'; /* tslint:disable-line: no-relative-import-in-test */
 import { default as Collapse_ } from './lib/Collapse'; /* tslint:disable-line: no-relative-import-in-test */
 import { default as Container_ } from './lib/Container'; /* tslint:disable-line: no-relative-import-in-test */
+import { default as CustomInput_ } from './lib/CustomInput'; /* tslint:disable-line: no-relative-import-in-test */
 import { default as Dropdown_ } from './lib/Dropdown'; /* tslint:disable-line: no-relative-import-in-test */
 import { default as DropdownItem_ } from './lib/DropdownItem'; /* tslint:disable-line: no-relative-import-in-test */
 import { default as DropdownMenu_ } from './lib/DropdownMenu'; /* tslint:disable-line: no-relative-import-in-test */
@@ -3834,6 +3835,7 @@ function AnyPropExample() {
       <Col_ foo={1} bar={false} foobar="example" />
       <Collapse_ foo={1} bar={false} foobar="example" />
       <Container_ foo={1} bar={false} foobar="example" />
+      <CustomInput_ foo={1} bar={false} foobar="example" type="file" />
       <Dropdown_ foo={1} bar={false} foobar="example" />
       <DropdownItem_ foo={1} bar={false} foobar="example" />
       <DropdownMenu_ foo={1} bar={false} foobar="example" />
@@ -3920,6 +3922,7 @@ class CarouselCaptionGeneric extends CarouselCaption<GenericInterface> {}
 class ColGeneric extends Col<GenericInterface> {}
 class CollapseGeneric extends Collapse<GenericInterface> {}
 class ContainerGeneric extends Container<GenericInterface> {}
+class CustomInputGeneric extends CustomInput<GenericInterface> {}
 class DropdownGeneric extends Dropdown<GenericInterface> {}
 class DropdownItemGeneric extends DropdownItem<GenericInterface> {}
 class DropdownMenuGeneric extends DropdownMenu<GenericInterface> {}
@@ -4001,6 +4004,7 @@ function GenericPropExample() {
       <ColGeneric foo={1} bar={false} foobar="example" />
       <CollapseGeneric foo={1} bar={false} foobar="example" />
       <ContainerGeneric foo={1} bar={false} foobar="example" />
+      <CustomInputGeneric foo={1} bar={false} foobar="example" type="file" />
       <DropdownGeneric foo={1} bar={false} foobar="example" />
       <DropdownItemGeneric foo={1} bar={false} foobar="example" />
       <DropdownMenuGeneric foo={1} bar={false} foobar="example" />

From 03041459989ac55f3031e9bef0492482a5575f91 Mon Sep 17 00:00:00 2001
From: Flosch <florent.schildknecht@humblebee.se>
Date: Thu, 7 Jun 2018 22:49:21 +0200
Subject: [PATCH 037/180] Replace local Popper typings by popper.js dependency

---
 types/reactstrap/lib/DropdownMenu.d.ts |   2 +-
 types/reactstrap/lib/Popover.d.ts      |   2 +-
 types/reactstrap/lib/Popper.d.ts       | 134 -------------------------
 types/reactstrap/lib/Tooltip.d.ts      |   2 +-
 types/reactstrap/package.json          |   6 ++
 5 files changed, 9 insertions(+), 137 deletions(-)
 delete mode 100644 types/reactstrap/lib/Popper.d.ts
 create mode 100644 types/reactstrap/package.json

diff --git a/types/reactstrap/lib/DropdownMenu.d.ts b/types/reactstrap/lib/DropdownMenu.d.ts
index 814771e87f..fedb12f4c3 100644
--- a/types/reactstrap/lib/DropdownMenu.d.ts
+++ b/types/reactstrap/lib/DropdownMenu.d.ts
@@ -1,6 +1,6 @@
 import * as React from 'react';
+import * as Popper from 'popper.js';
 import { CSSModule } from '../index';
-import { Popper } from './Popper';
 
 export type DropdownMenuProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   tag?: React.ReactType;
diff --git a/types/reactstrap/lib/Popover.d.ts b/types/reactstrap/lib/Popover.d.ts
index d1a0d56127..2af1a3bed9 100644
--- a/types/reactstrap/lib/Popover.d.ts
+++ b/types/reactstrap/lib/Popover.d.ts
@@ -1,6 +1,6 @@
 import * as React from 'react';
+import * as Popper from 'popper.js';
 import { CSSModule } from '../index';
-import { Popper } from './Popper';
 
 export type PopoverProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   isOpen?: boolean;
diff --git a/types/reactstrap/lib/Popper.d.ts b/types/reactstrap/lib/Popper.d.ts
deleted file mode 100644
index b28c61bd30..0000000000
--- a/types/reactstrap/lib/Popper.d.ts
+++ /dev/null
@@ -1,134 +0,0 @@
-// Type definitions for popper.js 1.10
-// Project: https://github.com/FezVrasta/popper.js/
-// Definitions by: edcarroll <https://github.com/edcarroll>, ggray <https://github.com/giladgray>, rhysd <https://rhysd.github.io>, joscha <https://github.com/joscha>, seckardt <https://github.com/seckardt>, marcfallows <https://github.com/marcfallows>
-
-// This file only declares the public portions of the API.
-// It should not define internal pieces such as utils or modifier details.
-// It has been copied from: https://raw.githubusercontent.com/FezVrasta/popper.js/master/packages/popper/index.d.ts
-
-export as namespace Popper;
-
-export type Position = "top" | "right" | "bottom" | "left";
-
-export type Placement =
-    | "auto-start"
-    | "auto"
-    | "auto-end"
-    | "top-start"
-    | "top"
-    | "top-end"
-    | "right-start"
-    | "right"
-    | "right-end"
-    | "bottom-end"
-    | "bottom"
-    | "bottom-start"
-    | "left-end"
-    | "left"
-    | "left-start";
-
-export type Boundary = "scrollParent" | "viewport" | "window";
-
-export type ModifierFn = (data: Data, options: Object) => Data;
-
-export interface BaseModifier {
-    order?: number;
-    enabled?: boolean;
-    fn?: ModifierFn;
-}
-
-export interface Modifiers {
-    shift?: BaseModifier;
-    offset?: BaseModifier & {
-        offset?: number | string;
-    };
-    preventOverflow?: BaseModifier & {
-        priority?: Position[];
-        padding?: number;
-        boundariesElement?: Boundary | Element;
-        escapeWithReference?: boolean;
-    };
-    keepTogether?: BaseModifier;
-    arrow?: BaseModifier & {
-        element?: string | Element;
-    };
-    flip?: BaseModifier & {
-        behavior?: "flip" | "clockwise" | "counterclockwise" | Position[];
-        padding?: number;
-        boundariesElement?: Boundary | Element;
-    };
-    inner?: BaseModifier;
-    hide?: BaseModifier;
-    applyStyle?: BaseModifier & {
-        onLoad?: Function;
-        gpuAcceleration?: boolean;
-    };
-    computeStyle?: BaseModifier & {
-        gpuAcceleration?: boolean;
-        x?: "bottom" | "top";
-        y?: "left" | "right";
-    };
-    [name: string]: (BaseModifier & Record<string, any>) | undefined;
-}
-
-export interface Offset {
-    top: number;
-    left: number;
-    width: number;
-    height: number;
-}
-
-export interface Data {
-    instance: Popper;
-    placement: Placement;
-    originalPlacement: Placement;
-    flipped: boolean;
-    hide: boolean;
-    arrowElement: Element;
-    styles: CSSStyleDeclaration;
-    boundaries: Object;
-    offsets: {
-        popper: Offset;
-        reference: Offset;
-        arrow: {
-            top: number;
-            left: number;
-        };
-    };
-}
-
-export interface PopperOptions {
-    placement?: Placement;
-    positionFixed: boolean;
-    eventsEnabled?: boolean;
-    modifiers?: Modifiers;
-    removeOnDestroy?: boolean;
-    onCreate?(data: Data): void;
-    onUpdate?(data: Data): void;
-}
-
-export interface ReferenceObject {
-    clientHeight: number;
-    clientWidth: number;
-    getBoundingClientRect(): ClientRect;
-}
-
-export class Popper {
-    static modifiers: (Popper.BaseModifier & { name: string })[];
-    static placements: Popper.Placement[];
-    static Defaults: Popper.PopperOptions;
-
-    options: Popper.PopperOptions;
-
-    constructor(
-        reference: Element | Popper.ReferenceObject,
-        popper: Element,
-        options?: Popper.PopperOptions
-    );
-
-    destroy(): void;
-    update(): void;
-    scheduleUpdate(): void;
-    enableEventListeners(): void;
-    disableEventListeners(): void;
-}
diff --git a/types/reactstrap/lib/Tooltip.d.ts b/types/reactstrap/lib/Tooltip.d.ts
index 5cfcfcab1e..5ec05fa72f 100644
--- a/types/reactstrap/lib/Tooltip.d.ts
+++ b/types/reactstrap/lib/Tooltip.d.ts
@@ -1,6 +1,6 @@
 import * as React from 'react';
+import * as Popper from 'popper.js';
 import { CSSModule } from '../index';
-import {Popper} from './Popper';
 
 export type UncontrolledProps<T = {}> = React.HTMLAttributes<HTMLElement> & {
   target: string | HTMLElement;
diff --git a/types/reactstrap/package.json b/types/reactstrap/package.json
new file mode 100644
index 0000000000..245f69cd2c
--- /dev/null
+++ b/types/reactstrap/package.json
@@ -0,0 +1,6 @@
+{
+    "private": true,
+    "dependencies": {
+        "popper.js": "^1.14.1"
+    }
+}

From f5e38c52427e1faca4d0d741c35d35233323cdfe Mon Sep 17 00:00:00 2001
From: lostfictions <lostfictions@users.noreply.github.com>
Date: Thu, 7 Jun 2018 19:43:49 -0400
Subject: [PATCH 038/180] add Pointer Events support to React

---
 types/react/global.d.ts |  1 +
 types/react/index.d.ts  | 38 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/types/react/global.d.ts b/types/react/global.d.ts
index 8d6062b4bc..5afef3a17c 100644
--- a/types/react/global.d.ts
+++ b/types/react/global.d.ts
@@ -13,6 +13,7 @@ interface FocusEvent extends Event { }
 interface KeyboardEvent extends Event { }
 interface MouseEvent extends Event { }
 interface TouchEvent extends Event { }
+interface PointerEvent extends Event { }
 interface TransitionEvent extends Event { }
 interface UIEvent extends Event { }
 interface WheelEvent extends Event { }
diff --git a/types/react/index.d.ts b/types/react/index.d.ts
index 27a76a9a08..6c96a3ac0d 100644
--- a/types/react/index.d.ts
+++ b/types/react/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for React 16.3
+// Type definitions for React 16.4
 // Project: http://facebook.github.io/react/
 // Definitions by: Asana <https://asana.com>
 //                 AssureSign <http://www.assuresign.com>
@@ -31,6 +31,7 @@ type NativeFocusEvent = FocusEvent;
 type NativeKeyboardEvent = KeyboardEvent;
 type NativeMouseEvent = MouseEvent;
 type NativeTouchEvent = TouchEvent;
+type NativePointerEvent = PointerEvent;
 type NativeTransitionEvent = TransitionEvent;
 type NativeUIEvent = UIEvent;
 type NativeWheelEvent = WheelEvent;
@@ -590,6 +591,18 @@ declare namespace React {
         nativeEvent: NativeDragEvent;
     }
 
+    interface PointerEvent<T = Element> extends MouseEvent<T> {
+        pointerId: number;
+        pressure: number;
+        tiltX: number;
+        tiltY: number;
+        width: number;
+        height: number;
+        pointerType: 'mouse' | 'pen' | 'touch';
+        isPrimary: boolean;
+        nativeEvent: NativePointerEvent;
+    }
+
     interface FocusEvent<T = Element> extends SyntheticEvent<T> {
         nativeEvent: NativeFocusEvent;
         relatedTarget: EventTarget;
@@ -711,6 +724,7 @@ declare namespace React {
     type KeyboardEventHandler<T = Element> = EventHandler<KeyboardEvent<T>>;
     type MouseEventHandler<T = Element> = EventHandler<MouseEvent<T>>;
     type TouchEventHandler<T = Element> = EventHandler<TouchEvent<T>>;
+    type PointerEventHandler<T = Element> = EventHandler<PointerEvent<T>>;
     type UIEventHandler<T = Element> = EventHandler<UIEvent<T>>;
     type WheelEventHandler<T = Element> = EventHandler<WheelEvent<T>>;
     type AnimationEventHandler<T = Element> = EventHandler<AnimationEvent<T>>;
@@ -898,6 +912,28 @@ declare namespace React {
         onTouchStart?: TouchEventHandler<T>;
         onTouchStartCapture?: TouchEventHandler<T>;
 
+        // Pointer Events
+        onPointerDown?: PointerEventHandler<T>;
+        onPointerDownCapture?: PointerEventHandler<T>;
+        onPointerMove?: PointerEventHandler<T>;
+        onPointerMoveCapture?: PointerEventHandler<T>;
+        onPointerUp?: PointerEventHandler<T>;
+        onPointerUpCapture?: PointerEventHandler<T>;
+        onPointerCancel?: PointerEventHandler<T>;
+        onPointerCancelCapture?: PointerEventHandler<T>;
+        onPointerEnter?: PointerEventHandler<T>;
+        onPointerEnterCapture?: PointerEventHandler<T>;
+        onPointerLeave?: PointerEventHandler<T>;
+        onPointerLeaveCapture?: PointerEventHandler<T>;
+        onPointerOver?: PointerEventHandler<T>;
+        onPointerOverCapture?: PointerEventHandler<T>;
+        onPointerOut?: PointerEventHandler<T>;
+        onPointerOutCapture?: PointerEventHandler<T>;
+        onGotPointerCapture?: PointerEventHandler<T>;
+        onGotPointerCaptureCapture?: PointerEventHandler<T>;
+        onLostPointerCapture?: PointerEventHandler<T>;
+        onLostPointerCaptureCapture?: PointerEventHandler<T>;
+
         // UI Events
         onScroll?: UIEventHandler<T>;
         onScrollCapture?: UIEventHandler<T>;

From d633b71a9bf4f8a2f4b602133eb9b1abeb3babb0 Mon Sep 17 00:00:00 2001
From: lostfictions <lostfictions@users.noreply.github.com>
Date: Fri, 8 Jun 2018 01:59:02 -0400
Subject: [PATCH 039/180] fix react-pointable typings

---
 types/react-pointable/index.d.ts                | 10 +---------
 types/react-pointable/react-pointable-tests.tsx |  2 +-
 2 files changed, 2 insertions(+), 10 deletions(-)

diff --git a/types/react-pointable/index.d.ts b/types/react-pointable/index.d.ts
index c69d537d55..1a12822643 100644
--- a/types/react-pointable/index.d.ts
+++ b/types/react-pointable/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for react-pointable 1.1
+// Type definitions for react-pointable 1.1.2
 // Project: https://github.com/MilllerTime/react-pointable
 // Definitions by: Stefan Fochler <https://github.com/istefo>
 //                 Dibyo Majumdar <https://github.com/mdibyo>
@@ -13,14 +13,6 @@ export interface PointableProps extends React.HTMLAttributes<Element>, React.SVG
     tagName?: keyof ElementTagNameMap;
     touchAction?: TouchAction;
     elementRef?(el: HTMLElement|SVGElement): void;
-    onPointerMove?(evt: PointerEvent): void;
-    onPointerDown?(evt: PointerEvent): void;
-    onPointerUp?(evt: PointerEvent): void;
-    onPointerOver?(evt: PointerEvent): void;
-    onPointerOut?(evt: PointerEvent): void;
-    onPointerEnter?(evt: PointerEvent): void;
-    onPointerLeave?(evt: PointerEvent): void;
-    onPointerCancel?(evt: PointerEvent): void;
 }
 
 export default class Pointable extends React.Component<PointableProps> {
diff --git a/types/react-pointable/react-pointable-tests.tsx b/types/react-pointable/react-pointable-tests.tsx
index 6331b88386..f905b8faa8 100644
--- a/types/react-pointable/react-pointable-tests.tsx
+++ b/types/react-pointable/react-pointable-tests.tsx
@@ -3,7 +3,7 @@ import Pointable from 'react-pointable';
 
 class Test extends React.Component<object, object> {
     elementRef(el: HTMLElement) {}
-    somePointerEvent(evt: PointerEvent) {}
+    somePointerEvent(evt: React.PointerEvent) {}
 
     render() {
         return (

From 52ee72c24ca35d99bd876d20de674aef840b2b0b Mon Sep 17 00:00:00 2001
From: Danny Cochran <daniel@cochrans.org>
Date: Fri, 8 Jun 2018 09:58:35 -0700
Subject: [PATCH 040/180] plugin function expects SuperAgentRequest

the plugin function actually takes a SuperAgentRequest, which includes properties like url, method, cookies, and agent.
---
 types/superagent/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/superagent/index.d.ts b/types/superagent/index.d.ts
index 7daf5f47dc..e5a52ce3cd 100644
--- a/types/superagent/index.d.ts
+++ b/types/superagent/index.d.ts
@@ -150,7 +150,7 @@ declare namespace request {
         write(data: string | Buffer, encoding?: string): this;
     }
 
-    type Plugin = (req: Request) => void;
+    type Plugin = (req: SuperAgentRequest) => void;
 
     interface ProgressEvent {
         direction: 'download' | 'upload';

From 37d365a61e6b8468e523c4c2b64c9835099592fa Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 10:04:01 -0700
Subject: [PATCH 041/180] Appointment and Mailbox changes

---
 types/office-js/index.d.ts | 40 ++++++++++++++++++++++++++++++++------
 1 file changed, 34 insertions(+), 6 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 5af6916816..4272154c87 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -5723,9 +5723,6 @@ declare namespace Office {
             Last = "last"
         }
     }
-    interface AsyncContextOptions {
-        asyncContext?: any;
-    }
     interface CoercionTypeOptions {
         coercionType?: CoercionType;
     }
@@ -6439,7 +6436,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentCompose extends Appointment, ItemCompose {
+    interface AppointmentOrganizer extends Appointment, ItemCompose {
         /**
          * Gets or sets the date and time that the appointment is to end.
          *
@@ -6532,7 +6529,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentRead extends Appointment, ItemRead {
+    interface AppointmentAttendee extends Appointment, ItemRead {
         /**
          * Gets the date and time that the appointment is to end.
          *
@@ -8235,6 +8232,31 @@ declare namespace Office {
      * Applicable Outlook mode: Compose or read
      */
     interface Mailbox {
+        /**
+         * Provides diagnostic information to an Outlook add-in.
+         * 
+         * Contains the following members:
+         * 
+         *  - hostName (string): A string that represents the name of the host application. It be one of the following values: Outlook, Mac Outlook, OutlookIOS, or OutlookWebApp.
+         * 
+         *  - hostVersion (string): A string that represents the version of either the host application or the Exchange Server. If the mail add-in is running on the Outlook desktop client or Outlook for iOS, the hostVersion property returns the version of the host application, Outlook. In Outlook Web App, the property returns the version of the Exchange Server. An example is the string 15.0.468.0.
+         * 
+         *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (represent by the following string values) that correspond to the width of the screen and the window, and the number of columns that can be displayed:
+         *
+         *      - OneColumn, which is displayed when the screen is narrow. Outlook Web App uses this single-column layout on the entire screen of a smartphone.
+         *
+         *      - TwoColumns, which is displayed when the screen is wider. Outlook Web App uses this view on most tablets.
+         *
+         *      - ThreeColumns, which is displayed when the screen is wide. For example, Outlook Web App uses this view in a full screen window on a desktop computer.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Compose or read
+         */
+        diagnostics: Diagnostics;
         /**
          * Gets the URL of the Exchange Web Services (EWS) endpoint for this email account. Read mode only.
          *
@@ -8260,7 +8282,7 @@ declare namespace Office {
          * If you want to see IntelliSense for only a specific type, you should cast this item to one of the following:
          * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentCompose`, `AppointmentRead`
          */
-        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentRead & AppointmentCompose;
+        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentAttendee & AppointmentOrganizer;
         /**
          * Gets the URL of the REST endpoint for this email account.
          *
@@ -8279,6 +8301,10 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          */
         restUrl: string;
+        /**
+         * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
+         */
+        userProfile: UserProfile;
         /**
          * Adds an event handler for a supported event.
          *
@@ -9971,6 +9997,8 @@ declare namespace Office {
 
     }
     /**
+     * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
+     * 
      * [Api set: Mailbox 1.0]
      *
      * @remarks

From 2a7c55a1009f8528343da447d15d69c37d366475 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 10:10:55 -0700
Subject: [PATCH 042/180] Appointment and Mailbox changes

---
 types/office-js/index.d.ts | 86 +++++++++++++-------------------------
 1 file changed, 29 insertions(+), 57 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 95090b3a92..5af6916816 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -376,14 +376,14 @@ declare namespace Office {
         */
         asyncContext: any;
         /**
-        * Gets the {@link Office.AsyncResultStatus} of the asynchronous operation.
+        * Gets the [AsyncResultStatus](office.asyncresultstatus.md) of the asynchronous operation.
         *
         * @remarks
         * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
         */
         status: AsyncResultStatus;
         /**
-        * Gets an {@link Office.Error} object that provides a description of the error, if any error occurred.
+        * Gets an [Error](office.error.md) object that provides a description of the error, if any error occurred.
         *
         * @remarks
         * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
@@ -661,7 +661,7 @@ declare namespace Office {
      */
     interface Auth {
         /**
-        * Calls the Azure Active Directory V 2.0 endpoint to get an access token to your add-in's web application. Allows add-ins to identify users. Server side code can use this token to access Microsoft Graph for the add-in's web application by using the {@link https://docs.microsoft.com/azure/active-directory/develop/active-directory-v2-protocols-oauth-on-behalf-of | "on behalf of" OAuth flow}.
+        * Calls the Azure Active Directory V 2.0 endpoint to get an access token to your add-in's web application. Allows add-ins to identify users. Server side code can use this token to access Microsoft Graph for the add-in's web application by using the ["on behalf of" OAuth flow](https://docs.microsoft.com/azure/active-directory/develop/active-directory-v2-protocols-oauth-on-behalf-of).
         *
         * @remarks
         * Hosts: Excel, OneNote, Outlook, PowerPoint, Word
@@ -1459,7 +1459,7 @@ declare namespace Office {
          *
          *        array of arrays: Excel and Word only
          *
-         *        {@link Office.TableData}: Access, Excel, and Word only
+         *        [TableData](office.tabledata.md): Access, Excel, and Word only
          *
          *        HTML: Word and Word Online only
          *
@@ -2600,7 +2600,7 @@ declare namespace Office {
          *
          * Available in Requirement set: Not in a set
          *
-         * See {@link https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table | Format tables in add-ins for Excel} for more information.
+         * See [Format tables in add-ins for Excel](https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table) for more information.
          *
          * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
@@ -2692,7 +2692,7 @@ declare namespace Office {
         rows: any[][];
     }
     /**
-     * Specifies enumerated values for the cells: property in the cellFormat parameter of {@link https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table | table formatting methods}.
+     * Specifies enumerated values for the cells: property in the cellFormat parameter of [table formatting methods](https://dev.office.com/reference/docs/excel/format-tables-in-add-ins-for-excel.htm).
      *
      * @remarks
      * Hosts: Excel
@@ -2787,7 +2787,7 @@ declare namespace Office {
      * @remarks
      * A ProjectResourceFields constant can be used as a parameter of the getResourceFieldAsync method.
      *
-     * For more information about working with fields in Project, see {@link https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460 | Available fields} reference. In Project Help, search for Available fields.
+     * For more information about working with fields in Project, see [Available fields](https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460) reference. In Project Help, search for Available fields.
      */
     enum ProjectResourceFields {
         /**
@@ -3597,7 +3597,7 @@ declare namespace Office {
      * @remarks
      * A ProjectTaskFields constant can be used as a parameter of the getTaskFieldAsync method.
      *
-     * For more information about working with fields in Project, see the {@link https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460 | Available fields} reference. In Project Help, search for Available fields.
+     * For more information about working with fields in Project, see the [Available fields](https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460) reference. In Project Help, search for Available fields.
      *
      * Hosts: Project
      */
@@ -5723,6 +5723,9 @@ declare namespace Office {
             Last = "last"
         }
     }
+    interface AsyncContextOptions {
+        asyncContext?: any;
+    }
     interface CoercionTypeOptions {
         coercionType?: CoercionType;
     }
@@ -6436,7 +6439,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentOrganizer extends Appointment, ItemCompose {
+    interface AppointmentCompose extends Appointment, ItemCompose {
         /**
          * Gets or sets the date and time that the appointment is to end.
          *
@@ -6529,7 +6532,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentAttendee extends Appointment, ItemRead {
+    interface AppointmentRead extends Appointment, ItemRead {
         /**
          * Gets the date and time that the appointment is to end.
          *
@@ -6865,7 +6868,7 @@ declare namespace Office {
          * 
          * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
          * 
-         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see [Use the Outlook REST APIs from an Outlook add-in](https://docs.microsoft.com/outlook/add-ins/use-rest-api).
          * 
          * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
          * 
@@ -7242,7 +7245,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
+         * More information on [actionable messages](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
          *
          * Minimum permission level: ReadItem
          *
@@ -7584,7 +7587,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
+         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see [Blocked attachments in Outlook](https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519).
          *
          * Minimum permission level: ReadItem
          *
@@ -7707,7 +7710,7 @@ declare namespace Office {
          */
         displayReplyForm(formData: string | ReplyFormData): void;
         /**
-         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * Gets initialization data passed when the add-in is [activated by an actionable message](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
          * 
          * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
          *
@@ -7725,7 +7728,7 @@ declare namespace Office {
          */
         getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
         /**
-         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * Gets initialization data passed when the add-in is [activated by an actionable message](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
          * 
          * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
          *
@@ -8232,31 +8235,6 @@ declare namespace Office {
      * Applicable Outlook mode: Compose or read
      */
     interface Mailbox {
-        /**
-         * Provides diagnostic information to an Outlook add-in.
-         * 
-         * Contains the following members:
-         * 
-         *  - hostName (string): A string that represents the name of the host application. It be one of the following values: Outlook, Mac Outlook, OutlookIOS, or OutlookWebApp.
-         * 
-         *  - hostVersion (string): A string that represents the version of either the host application or the Exchange Server. If the mail add-in is running on the Outlook desktop client or Outlook for iOS, the hostVersion property returns the version of the host application, Outlook. In Outlook Web App, the property returns the version of the Exchange Server. An example is the string 15.0.468.0.
-         * 
-         *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (represent by the following string values) that correspond to the width of the screen and the window, and the number of columns that can be displayed:
-         *
-         *      - OneColumn, which is displayed when the screen is narrow. Outlook Web App uses this single-column layout on the entire screen of a smartphone.
-         *
-         *      - TwoColumns, which is displayed when the screen is wider. Outlook Web App uses this view on most tablets.
-         *
-         *      - ThreeColumns, which is displayed when the screen is wide. For example, Outlook Web App uses this view in a full screen window on a desktop computer.
-         *
-         * [Api set: Mailbox 1.0]
-         *
-         * @remarks
-         * Minimum permission level: ReadItem
-         *
-         * Applicable Outlook mode: Compose or read
-         */
-        diagnostics: Diagnostics;
         /**
          * Gets the URL of the Exchange Web Services (EWS) endpoint for this email account. Read mode only.
          *
@@ -8270,7 +8248,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to {@link https://msdn.microsoft.com/library/office/dn148008.aspx | get attachments from the selected item}.
+         * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to [get attachments from the selected item](https://msdn.microsoft.com/library/office/dn148008.aspx).
          *
          * Minimum permission level: ReadItem
          *
@@ -8282,7 +8260,7 @@ declare namespace Office {
          * If you want to see IntelliSense for only a specific type, you should cast this item to one of the following:
          * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentCompose`, `AppointmentRead`
          */
-        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentAttendee & AppointmentOrganizer;
+        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentRead & AppointmentCompose;
         /**
          * Gets the URL of the REST endpoint for this email account.
          *
@@ -8294,17 +8272,13 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The restUrl value can be used to make {@link https://docs.microsoft.com/outlook/rest/ | REST API} calls to the user's mailbox.
+         * The restUrl value can be used to make [REST API](https://docs.microsoft.com/outlook/rest/) calls to the user's mailbox.
          *
          * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
         restUrl: string;
-        /**
-         * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
-         */
-        userProfile: UserProfile;
         /**
          * Adds an event handler for a supported event.
          *
@@ -8370,7 +8344,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the {@link https://msdn.microsoft.com/office/office365/APi/mail-rest-operations | Outlook Mail API} or the {@link http://graph.microsoft.io/ | Microsoft Graph}. The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
+         * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the [Outlook Mail API](https://msdn.microsoft.com/office/office365/APi/mail-rest-operations) or the [Microsoft Graph](http://graph.microsoft.io/)). The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
          *
          * Minimum permission level: Restricted
          *
@@ -8585,7 +8559,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The getUserIdentityTokenAsync method returns a token that you can use to identify and {@link https://msdn.microsoft.com/library/office/fp179828.aspx | authenticate the add-in and user with a third-party system}.
+         * The getUserIdentityTokenAsync method returns a token that you can use to identify and [authenticate the add-in and user with a third-party system](https://msdn.microsoft.com/library/office/fp179828.aspx).
          *
          * Minimum permission level: ReadItem
          *
@@ -9566,7 +9540,7 @@ declare namespace Office {
         getDuration(): number;
 
         /**
-         * Gets the end date of a recurrence pattern in the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD"
+         * Gets the end date of a recurrence pattern in the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9578,7 +9552,7 @@ declare namespace Office {
         getEndDate(): string;
 
         /**
-         * Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} format: "THH:mm:ss:mmm"
+         * Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format: "THH:mm:ss:mmm"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9590,7 +9564,7 @@ declare namespace Office {
         getEndTime(): string;
 
         /**
-         * Gets the start date of a recurrence pattern in the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD"
+         * Gets the start date of a recurrence pattern in the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9602,7 +9576,7 @@ declare namespace Office {
         getStartDate(): string;
 
         /**
-         * Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} format: "THH:mm:ss:mmm"
+         * Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format: "THH:mm:ss:mmm"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9657,7 +9631,7 @@ declare namespace Office {
          * 
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
-         * @param date End date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
+         * @param date End date of the recurring appointment series represented in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD".
          */
         setEndDate(date: string): void;
 
@@ -9691,7 +9665,7 @@ declare namespace Office {
          * 
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
-         * @param date Start date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
+         * @param date Start date of the recurring appointment series represented in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD".
          */
         setStartDate(date:string): void;
 
@@ -9997,8 +9971,6 @@ declare namespace Office {
 
     }
     /**
-     * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
-     * 
      * [Api set: Mailbox 1.0]
      *
      * @remarks

From 042eb4582d5f03c6db3343912ab7af14c85fc4a2 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 10:26:02 -0700
Subject: [PATCH 043/180] Revert "Appointment and Mailbox changes"

This reverts commit 2a7c55a1009f8528343da447d15d69c37d366475.
---
 types/office-js/index.d.ts | 86 +++++++++++++++++++++++++-------------
 1 file changed, 57 insertions(+), 29 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 5af6916816..95090b3a92 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -376,14 +376,14 @@ declare namespace Office {
         */
         asyncContext: any;
         /**
-        * Gets the [AsyncResultStatus](office.asyncresultstatus.md) of the asynchronous operation.
+        * Gets the {@link Office.AsyncResultStatus} of the asynchronous operation.
         *
         * @remarks
         * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
         */
         status: AsyncResultStatus;
         /**
-        * Gets an [Error](office.error.md) object that provides a description of the error, if any error occurred.
+        * Gets an {@link Office.Error} object that provides a description of the error, if any error occurred.
         *
         * @remarks
         * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
@@ -661,7 +661,7 @@ declare namespace Office {
      */
     interface Auth {
         /**
-        * Calls the Azure Active Directory V 2.0 endpoint to get an access token to your add-in's web application. Allows add-ins to identify users. Server side code can use this token to access Microsoft Graph for the add-in's web application by using the ["on behalf of" OAuth flow](https://docs.microsoft.com/azure/active-directory/develop/active-directory-v2-protocols-oauth-on-behalf-of).
+        * Calls the Azure Active Directory V 2.0 endpoint to get an access token to your add-in's web application. Allows add-ins to identify users. Server side code can use this token to access Microsoft Graph for the add-in's web application by using the {@link https://docs.microsoft.com/azure/active-directory/develop/active-directory-v2-protocols-oauth-on-behalf-of | "on behalf of" OAuth flow}.
         *
         * @remarks
         * Hosts: Excel, OneNote, Outlook, PowerPoint, Word
@@ -1459,7 +1459,7 @@ declare namespace Office {
          *
          *        array of arrays: Excel and Word only
          *
-         *        [TableData](office.tabledata.md): Access, Excel, and Word only
+         *        {@link Office.TableData}: Access, Excel, and Word only
          *
          *        HTML: Word and Word Online only
          *
@@ -2600,7 +2600,7 @@ declare namespace Office {
          *
          * Available in Requirement set: Not in a set
          *
-         * See [Format tables in add-ins for Excel](https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table) for more information.
+         * See {@link https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table | Format tables in add-ins for Excel} for more information.
          *
          * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
@@ -2692,7 +2692,7 @@ declare namespace Office {
         rows: any[][];
     }
     /**
-     * Specifies enumerated values for the cells: property in the cellFormat parameter of [table formatting methods](https://dev.office.com/reference/docs/excel/format-tables-in-add-ins-for-excel.htm).
+     * Specifies enumerated values for the cells: property in the cellFormat parameter of {@link https://docs.microsoft.com/en-us/office/dev/add-ins/excel/excel-add-ins-tables#format-a-table | table formatting methods}.
      *
      * @remarks
      * Hosts: Excel
@@ -2787,7 +2787,7 @@ declare namespace Office {
      * @remarks
      * A ProjectResourceFields constant can be used as a parameter of the getResourceFieldAsync method.
      *
-     * For more information about working with fields in Project, see [Available fields](https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460) reference. In Project Help, search for Available fields.
+     * For more information about working with fields in Project, see {@link https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460 | Available fields} reference. In Project Help, search for Available fields.
      */
     enum ProjectResourceFields {
         /**
@@ -3597,7 +3597,7 @@ declare namespace Office {
      * @remarks
      * A ProjectTaskFields constant can be used as a parameter of the getTaskFieldAsync method.
      *
-     * For more information about working with fields in Project, see the [Available fields](https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460) reference. In Project Help, search for Available fields.
+     * For more information about working with fields in Project, see the {@link https://support.office.com/article/Available-fields-reference-615a4563-1cc3-40f4-b66f-1b17e793a460 | Available fields} reference. In Project Help, search for Available fields.
      *
      * Hosts: Project
      */
@@ -5723,9 +5723,6 @@ declare namespace Office {
             Last = "last"
         }
     }
-    interface AsyncContextOptions {
-        asyncContext?: any;
-    }
     interface CoercionTypeOptions {
         coercionType?: CoercionType;
     }
@@ -6439,7 +6436,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentCompose extends Appointment, ItemCompose {
+    interface AppointmentOrganizer extends Appointment, ItemCompose {
         /**
          * Gets or sets the date and time that the appointment is to end.
          *
@@ -6532,7 +6529,7 @@ declare namespace Office {
     /**
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
-    interface AppointmentRead extends Appointment, ItemRead {
+    interface AppointmentAttendee extends Appointment, ItemRead {
         /**
          * Gets the date and time that the appointment is to end.
          *
@@ -6868,7 +6865,7 @@ declare namespace Office {
          * 
          * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
          * 
-         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see [Use the Outlook REST APIs from an Outlook add-in](https://docs.microsoft.com/outlook/add-ins/use-rest-api).
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
          * 
          * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
          * 
@@ -7245,7 +7242,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * More information on [actionable messages](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
+         * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
          *
          * Minimum permission level: ReadItem
          *
@@ -7587,7 +7584,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see [Blocked attachments in Outlook](https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519).
+         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
          *
          * Minimum permission level: ReadItem
          *
@@ -7710,7 +7707,7 @@ declare namespace Office {
          */
         displayReplyForm(formData: string | ReplyFormData): void;
         /**
-         * Gets initialization data passed when the add-in is [activated by an actionable message](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
          * 
          * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
          *
@@ -7728,7 +7725,7 @@ declare namespace Office {
          */
         getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
         /**
-         * Gets initialization data passed when the add-in is [activated by an actionable message](https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message).
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
          * 
          * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
          *
@@ -8235,6 +8232,31 @@ declare namespace Office {
      * Applicable Outlook mode: Compose or read
      */
     interface Mailbox {
+        /**
+         * Provides diagnostic information to an Outlook add-in.
+         * 
+         * Contains the following members:
+         * 
+         *  - hostName (string): A string that represents the name of the host application. It be one of the following values: Outlook, Mac Outlook, OutlookIOS, or OutlookWebApp.
+         * 
+         *  - hostVersion (string): A string that represents the version of either the host application or the Exchange Server. If the mail add-in is running on the Outlook desktop client or Outlook for iOS, the hostVersion property returns the version of the host application, Outlook. In Outlook Web App, the property returns the version of the Exchange Server. An example is the string 15.0.468.0.
+         * 
+         *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (represent by the following string values) that correspond to the width of the screen and the window, and the number of columns that can be displayed:
+         *
+         *      - OneColumn, which is displayed when the screen is narrow. Outlook Web App uses this single-column layout on the entire screen of a smartphone.
+         *
+         *      - TwoColumns, which is displayed when the screen is wider. Outlook Web App uses this view on most tablets.
+         *
+         *      - ThreeColumns, which is displayed when the screen is wide. For example, Outlook Web App uses this view in a full screen window on a desktop computer.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Compose or read
+         */
+        diagnostics: Diagnostics;
         /**
          * Gets the URL of the Exchange Web Services (EWS) endpoint for this email account. Read mode only.
          *
@@ -8248,7 +8270,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to [get attachments from the selected item](https://msdn.microsoft.com/library/office/dn148008.aspx).
+         * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to {@link https://msdn.microsoft.com/library/office/dn148008.aspx | get attachments from the selected item}.
          *
          * Minimum permission level: ReadItem
          *
@@ -8260,7 +8282,7 @@ declare namespace Office {
          * If you want to see IntelliSense for only a specific type, you should cast this item to one of the following:
          * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentCompose`, `AppointmentRead`
          */
-        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentRead & AppointmentCompose;
+        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentAttendee & AppointmentOrganizer;
         /**
          * Gets the URL of the REST endpoint for this email account.
          *
@@ -8272,13 +8294,17 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The restUrl value can be used to make [REST API](https://docs.microsoft.com/outlook/rest/) calls to the user's mailbox.
+         * The restUrl value can be used to make {@link https://docs.microsoft.com/outlook/rest/ | REST API} calls to the user's mailbox.
          *
          * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
         restUrl: string;
+        /**
+         * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
+         */
+        userProfile: UserProfile;
         /**
          * Adds an event handler for a supported event.
          *
@@ -8344,7 +8370,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the [Outlook Mail API](https://msdn.microsoft.com/office/office365/APi/mail-rest-operations) or the [Microsoft Graph](http://graph.microsoft.io/)). The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
+         * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the {@link https://msdn.microsoft.com/office/office365/APi/mail-rest-operations | Outlook Mail API} or the {@link http://graph.microsoft.io/ | Microsoft Graph}. The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
          *
          * Minimum permission level: Restricted
          *
@@ -8559,7 +8585,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * The getUserIdentityTokenAsync method returns a token that you can use to identify and [authenticate the add-in and user with a third-party system](https://msdn.microsoft.com/library/office/fp179828.aspx).
+         * The getUserIdentityTokenAsync method returns a token that you can use to identify and {@link https://msdn.microsoft.com/library/office/fp179828.aspx | authenticate the add-in and user with a third-party system}.
          *
          * Minimum permission level: ReadItem
          *
@@ -9540,7 +9566,7 @@ declare namespace Office {
         getDuration(): number;
 
         /**
-         * Gets the end date of a recurrence pattern in the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD"
+         * Gets the end date of a recurrence pattern in the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9552,7 +9578,7 @@ declare namespace Office {
         getEndDate(): string;
 
         /**
-         * Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format: "THH:mm:ss:mmm"
+         * Gets the end time of a usual appointment or meeting request instance of a recurrence pattern in whichever time zone that the user or add-in set the recurrence pattern using the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} format: "THH:mm:ss:mmm"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9564,7 +9590,7 @@ declare namespace Office {
         getEndTime(): string;
 
         /**
-         * Gets the start date of a recurrence pattern in the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD"
+         * Gets the start date of a recurrence pattern in the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9576,7 +9602,7 @@ declare namespace Office {
         getStartDate(): string;
 
         /**
-         * Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format: "THH:mm:ss:mmm"
+         * Gets the start time of a usual appointment instance of a recurrence pattern in whichever time zone that the user/add-in set the recurrence pattern using the following {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} format: "THH:mm:ss:mmm"
          * 
          * [Api set: Mailbox Preview]
          *
@@ -9631,7 +9657,7 @@ declare namespace Office {
          * 
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
-         * @param date End date of the recurring appointment series represented in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD".
+         * @param date End date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
          */
         setEndDate(date: string): void;
 
@@ -9665,7 +9691,7 @@ declare namespace Office {
          * 
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
-         * @param date Start date of the recurring appointment series represented in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) date format: "YYYY-MM-DD".
+         * @param date Start date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
          */
         setStartDate(date:string): void;
 
@@ -9971,6 +9997,8 @@ declare namespace Office {
 
     }
     /**
+     * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
+     * 
      * [Api set: Mailbox 1.0]
      *
      * @remarks

From 02c4fad71bf1da8a747404cfb8be9ac1d8560e27 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 10:40:03 -0700
Subject: [PATCH 044/180] Appointment and Mailbox changes

---
 types/office-js/index.d.ts | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 95090b3a92..36ba1fa875 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -8243,11 +8243,7 @@ declare namespace Office {
          * 
          *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (represent by the following string values) that correspond to the width of the screen and the window, and the number of columns that can be displayed:
          *
-         *      - OneColumn, which is displayed when the screen is narrow. Outlook Web App uses this single-column layout on the entire screen of a smartphone.
-         *
-         *      - TwoColumns, which is displayed when the screen is wider. Outlook Web App uses this view on most tablets.
-         *
-         *      - ThreeColumns, which is displayed when the screen is wide. For example, Outlook Web App uses this view in a full screen window on a desktop computer.
+         *  More information is under {@link Office.Diagnostics}
          *
          * [Api set: Mailbox 1.0]
          *
@@ -8303,6 +8299,8 @@ declare namespace Office {
         restUrl: string;
         /**
          * Information about the user associated with the mailbox. This includes their account type, display name, email adddress, and time zone.
+         * 
+         * More information is under {@link Office.UserProfile}
          */
         userProfile: UserProfile;
         /**

From 4c5030321e7c086418436b406a8b5fb414eae317 Mon Sep 17 00:00:00 2001
From: lostfictions <lostfictions@users.noreply.github.com>
Date: Fri, 8 Jun 2018 13:44:47 -0400
Subject: [PATCH 045/180] increment version for react-pointable to satisfy CI
 (even though this version doesn't exist)

---
 types/react-pointable/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/react-pointable/index.d.ts b/types/react-pointable/index.d.ts
index 1a12822643..0b83bdeb1d 100644
--- a/types/react-pointable/index.d.ts
+++ b/types/react-pointable/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for react-pointable 1.1.2
+// Type definitions for react-pointable 1.2
 // Project: https://github.com/MilllerTime/react-pointable
 // Definitions by: Stefan Fochler <https://github.com/istefo>
 //                 Dibyo Majumdar <https://github.com/mdibyo>

From 82403929105f8af2fd2784f9a3199b81e9b0c02c Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 12:13:22 -0700
Subject: [PATCH 046/180] Better descriptions in Outlook and links to types
 that'll be hidden in the ToC

---
 types/office-js/index.d.ts | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 36ba1fa875..991e6fbc75 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -6434,6 +6434,8 @@ declare namespace Office {
     interface Appointment extends Item {
     }
     /**
+     * The compose mode of {@link Office.Appointment}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface AppointmentOrganizer extends Appointment, ItemCompose {
@@ -6527,6 +6529,8 @@ declare namespace Office {
         start: Time;
     }
     /**
+     * The read mode of {@link Office.Appointment}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface AppointmentAttendee extends Appointment, ItemRead {
@@ -6980,6 +6984,8 @@ declare namespace Office {
        removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
     }
     /**
+     * The compose mode of {@link Office.Item}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface ItemCompose extends Item {
@@ -7574,6 +7580,8 @@ declare namespace Office {
         setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
     }
     /**
+     * The read mode of {@link Office.Appointment}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface ItemRead extends Item {
@@ -7679,7 +7687,7 @@ declare namespace Office {
          *
          * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
          *  OR
-         * A ReplyFormData object that contains body or attachment data and a callback function
+         * A {@link Office.ReplyFormData} object that contains body or attachment data and a callback function
          */
         displayReplyAllForm(formData: string | ReplyFormData): void;
         /**
@@ -7703,7 +7711,7 @@ declare namespace Office {
          *
          * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB.
          * OR
-         * A ReplyFormData object that contains body or attachment data and a callback function.
+         * A {@link Office.ReplyFormData} object that contains body or attachment data and a callback function.
          */
         displayReplyForm(formData: string | ReplyFormData): void;
         /**
@@ -7885,6 +7893,8 @@ declare namespace Office {
         getSelectedRegExMatches(): any;
     }
     /**
+     * A subclass of {@link Office.Item} for messages.
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface Message extends Item {
@@ -7907,6 +7917,8 @@ declare namespace Office {
     }
 
      /**
+     * The compose mode of {@link Office.Message}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface MessageCompose extends Message, ItemCompose {
@@ -7970,6 +7982,8 @@ declare namespace Office {
         to: Recipients;
     }
     /**
+     * The read mode of {@link Office.Message}
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface MessageRead extends Message, ItemRead {
@@ -9281,7 +9295,7 @@ declare namespace Office {
         recurrenceType: MailboxEnums.RecurrenceType;
 
         /**
-         * This object enables you to manage the start and end dates of the recurring appointment series and the usual start and end times of instances. **This object is not in UTC time.** Instead, it is set in the time zone specified by the recurrenceTimeZone value or defaulted to the item's time zone.
+         * The {@link Office.SeriesTime} object enables you to manage the start and end dates of the recurring appointment series and the usual start and end times of instances. **This object is not in UTC time.** Instead, it is set in the time zone specified by the recurrenceTimeZone value or defaulted to the item's time zone.
          * 
          * [Api set: Mailbox Preview]
          * 
@@ -9449,7 +9463,7 @@ declare namespace Office {
          */
         htmlBody?: string;
         /**
-         * An array of ReplyFormAttachments that are either file or item attachments.
+         * An array of {@link Office.ReplyFormAttachments} that are either file or item attachments.
          */
         attachments?: ReplyFormAttachment[];
         /**

From 3f4925b3e9ad9ee28ee54ad344524bdd526e619c Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 13:52:36 -0700
Subject: [PATCH 047/180] Fixing spacing and diagnostics description

---
 types/office-js/index.d.ts | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 991e6fbc75..ce69f9ae20 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -6429,12 +6429,14 @@ declare namespace Office {
     }
 
     /**
+     * The subclass of {@link Office.Item} dealing with apppointments.
+     * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
     interface Appointment extends Item {
     }
     /**
-     * The compose mode of {@link Office.Appointment}
+     * The compose mode of {@link Office.Appointment}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -6529,7 +6531,7 @@ declare namespace Office {
         start: Time;
     }
     /**
-     * The read mode of {@link Office.Appointment}
+     * The read mode of {@link Office.Appointment}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -6984,7 +6986,7 @@ declare namespace Office {
        removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
     }
     /**
-     * The compose mode of {@link Office.Item}
+     * The compose mode of {@link Office.Item}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -7580,7 +7582,7 @@ declare namespace Office {
         setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
     }
     /**
-     * The read mode of {@link Office.Appointment}
+     * The read mode of {@link Office.Appointment}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -7917,7 +7919,7 @@ declare namespace Office {
     }
 
      /**
-     * The compose mode of {@link Office.Message}
+     * The compose mode of {@link Office.Message}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -7982,7 +7984,7 @@ declare namespace Office {
         to: Recipients;
     }
     /**
-     * The read mode of {@link Office.Message}
+     * The read mode of {@link Office.Message}. 
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -8255,9 +8257,9 @@ declare namespace Office {
          * 
          *  - hostVersion (string): A string that represents the version of either the host application or the Exchange Server. If the mail add-in is running on the Outlook desktop client or Outlook for iOS, the hostVersion property returns the version of the host application, Outlook. In Outlook Web App, the property returns the version of the Exchange Server. An example is the string 15.0.468.0.
          * 
-         *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (represent by the following string values) that correspond to the width of the screen and the window, and the number of columns that can be displayed:
+         *  - OWAView (string): A string that represents the current view of Outlook Web App. If the host application is not Outlook Web App, then accessing this property results in undefined. Outlook Web App has three views (OneColumn - displayed when the screen is narrow, TwoColumns - displayed when the screen is wider, and ThreeColumns - displayed when the screen is wide.) that correspond to the width of the screen and the window, and the number of columns that can be displayed.
          *
-         *  More information is under {@link Office.Diagnostics}
+         *  More information is under {@link Office.Diagnostics}. 
          *
          * [Api set: Mailbox 1.0]
          *
@@ -9463,7 +9465,7 @@ declare namespace Office {
          */
         htmlBody?: string;
         /**
-         * An array of {@link Office.ReplyFormAttachments} that are either file or item attachments.
+         * An array of {@link Office.ReplyFormAttachment} that are either file or item attachments.
          */
         attachments?: ReplyFormAttachment[];
         /**

From 5d63868538a1760e1891dea751966b39a739af1d Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 14:53:39 -0700
Subject: [PATCH 048/180] Adding permission level links

---
 types/office-js/index.d.ts | 444 ++++++++++++++++++-------------------
 1 file changed, 222 insertions(+), 222 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index ce69f9ae20..464260f617 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -459,7 +459,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -484,7 +484,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -535,7 +535,7 @@ declare namespace Office {
          * 
          * Add-in type: Content, task pane, Outlook
          * 
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or Read
          */
@@ -552,7 +552,7 @@ declare namespace Office {
              *
              * @remarks
              * 
-             * Minimum permission level: Restricted
+             * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
              *
              * Applicable Outlook mode: Compose or read
              * 
@@ -5744,7 +5744,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -5780,7 +5780,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -5795,7 +5795,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5815,7 +5815,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5830,7 +5830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5849,7 +5849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5870,7 +5870,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5890,7 +5890,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5908,7 +5908,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5925,7 +5925,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5950,7 +5950,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5974,7 +5974,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5996,7 +5996,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6018,7 +6018,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6043,7 +6043,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6067,7 +6067,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6089,7 +6089,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6109,7 +6109,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: Restricted
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Read
      */
@@ -6147,7 +6147,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6160,7 +6160,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6175,7 +6175,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -6192,7 +6192,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6210,7 +6210,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6222,7 +6222,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6235,7 +6235,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6248,7 +6248,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6271,7 +6271,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6283,7 +6283,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6311,7 +6311,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6343,7 +6343,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6384,7 +6384,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      * 
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose
      */
@@ -6399,7 +6399,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          * 
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6419,7 +6419,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6456,7 +6456,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6472,7 +6472,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6488,7 +6488,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6504,7 +6504,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6524,7 +6524,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6549,7 +6549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6563,7 +6563,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6577,7 +6577,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6589,7 +6589,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6603,7 +6603,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6619,7 +6619,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6634,7 +6634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6658,7 +6658,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6678,7 +6678,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * Minimum permission level: ReadItem
+        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         * Applicable Outlook mode: Compose or read
         */
         location: string;
@@ -6697,7 +6697,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * Minimum permission level: ReadItem
+        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         */
@@ -6718,7 +6718,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6742,7 +6742,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6764,7 +6764,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6777,7 +6777,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: Restricted
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6789,7 +6789,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6801,7 +6801,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6815,7 +6815,7 @@ declare namespace Office {
          *
          * Note: This member is not supported in Outlook for iOS or Outlook for Android.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6829,7 +6829,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6841,7 +6841,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6860,7 +6860,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6879,7 +6879,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6894,7 +6894,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6915,7 +6915,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6936,7 +6936,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * Minimum permission level: ReadItem
+        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         *
@@ -6954,7 +6954,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6975,7 +6975,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -7002,7 +7002,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7017,7 +7017,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7047,7 +7047,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7073,7 +7073,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7102,7 +7102,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7132,7 +7132,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7159,7 +7159,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7183,7 +7183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7209,7 +7209,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7236,7 +7236,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose
          */
@@ -7252,7 +7252,7 @@ declare namespace Office {
          *
          * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7275,7 +7275,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7297,7 +7297,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7316,7 +7316,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7337,7 +7337,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7355,7 +7355,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7375,7 +7375,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7405,7 +7405,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7435,7 +7435,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7462,7 +7462,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7491,7 +7491,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7509,7 +7509,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7531,7 +7531,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7549,7 +7549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7570,7 +7570,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7596,7 +7596,7 @@ declare namespace Office {
          *
          * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7618,7 +7618,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7634,7 +7634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7648,7 +7648,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7664,7 +7664,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7683,7 +7683,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7707,7 +7707,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7725,7 +7725,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7743,7 +7743,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7759,7 +7759,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7786,7 +7786,7 @@ declare namespace Office {
          * |URL|String|Restricted|
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Read
          *
@@ -7804,7 +7804,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7828,7 +7828,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7849,7 +7849,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7865,7 +7865,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7888,7 +7888,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7911,7 +7911,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7931,7 +7931,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -7947,7 +7947,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7963,7 +7963,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7977,7 +7977,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7998,7 +7998,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8016,7 +8016,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8028,7 +8028,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8044,7 +8044,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8058,7 +8058,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8072,7 +8072,7 @@ declare namespace Office {
      *
      * @remarks
      *
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8116,7 +8116,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -8133,7 +8133,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8148,7 +8148,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8166,7 +8166,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8183,7 +8183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8202,7 +8202,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8220,7 +8220,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8243,7 +8243,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: Restricted
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8264,7 +8264,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8284,7 +8284,7 @@ declare namespace Office {
          *
          * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to {@link https://msdn.microsoft.com/library/office/dn148008.aspx | get attachments from the selected item}.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8308,7 +8308,7 @@ declare namespace Office {
          *
          * The restUrl value can be used to make {@link https://docs.microsoft.com/outlook/rest/ | REST API} calls to the user's mailbox.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8328,7 +8328,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8349,7 +8349,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8368,7 +8368,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8386,7 +8386,7 @@ declare namespace Office {
          *
          * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the {@link https://msdn.microsoft.com/office/office365/APi/mail-rest-operations | Outlook Mail API} or the {@link http://graph.microsoft.io/ | Microsoft Graph}. The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
          *
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8403,7 +8403,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8428,7 +8428,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8452,7 +8452,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8476,7 +8476,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8494,7 +8494,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8535,7 +8535,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8560,7 +8560,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8582,7 +8582,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8601,7 +8601,7 @@ declare namespace Office {
          *
          * The getUserIdentityTokenAsync method returns a token that you can use to identify and {@link https://msdn.microsoft.com/library/office/fp179828.aspx | authenticate the add-in and user with a third-party system}.
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8640,7 +8640,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * Minimum permission level: ReadWriteMailbox
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteMailbox
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8661,7 +8661,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8697,7 +8697,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8729,7 +8729,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8748,7 +8748,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8764,7 +8764,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8782,7 +8782,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8799,7 +8799,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8810,7 +8810,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8825,7 +8825,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8838,7 +8838,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8854,7 +8854,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8867,7 +8867,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8882,7 +8882,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8898,7 +8898,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8917,7 +8917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8933,7 +8933,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8951,7 +8951,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8969,7 +8969,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8991,7 +8991,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9010,7 +9010,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9036,7 +9036,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9059,7 +9059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9084,7 +9084,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9103,7 +9103,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9118,7 +9118,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9143,7 +9143,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9171,7 +9171,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9196,7 +9196,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9223,7 +9223,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9253,7 +9253,7 @@ declare namespace Office {
      * |Meeting Request - Read Series|No (setAsync not available)|Yes (item.recurrence)|
      * |Meeting Request - Read Instance|No (setAsync not available)|Yes (item.recurrence)|
      * 
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9265,7 +9265,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9277,7 +9277,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9290,7 +9290,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9303,7 +9303,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9318,7 +9318,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9337,7 +9337,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9354,7 +9354,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9376,7 +9376,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9395,7 +9395,7 @@ declare namespace Office {
      * 
      * @remarks
      * 
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9487,7 +9487,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: Restricted
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9498,7 +9498,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9512,7 +9512,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9527,7 +9527,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9546,7 +9546,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: Restricted
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9562,7 +9562,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9573,7 +9573,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9585,7 +9585,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9597,7 +9597,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9609,7 +9609,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9621,7 +9621,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9633,7 +9633,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9647,7 +9647,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9665,7 +9665,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9681,7 +9681,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9699,7 +9699,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9715,7 +9715,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9732,7 +9732,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9749,7 +9749,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9761,7 +9761,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9776,7 +9776,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9793,7 +9793,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9813,7 +9813,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9830,7 +9830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9849,7 +9849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9869,7 +9869,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -9889,7 +9889,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9902,7 +9902,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9917,7 +9917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9936,7 +9936,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9958,7 +9958,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9977,7 +9977,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9998,7 +9998,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * Minimum permission level: ReadWriteItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -10016,7 +10016,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * Minimum permission level: ReadItem
+     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -10037,7 +10037,7 @@ declare namespace Office {
          * |office365 |The mailbox is associated with an Office 365 work or school account.|
          * |outlookCom |The mailbox is associated with a personal Outlook.com account.|
          *
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10048,7 +10048,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10059,7 +10059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10070,7 +10070,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * Minimum permission level: ReadItem
+         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */

From 195e2da1e5205bd8726ad74dc612a97128703f81 Mon Sep 17 00:00:00 2001
From: CrossR <sc13rjc@leeds.ac.uk>
Date: Fri, 8 Jun 2018 22:59:47 +0100
Subject: [PATCH 049/180] Update MarkedOptions for 0.4.

Alphabetised options to bring in line with package docs.
Also updated tests to pass, and be a bit clearer.
---
 types/marked/index.d.ts      | 87 ++++++++++++++++++++----------------
 types/marked/marked-tests.ts | 24 +++++-----
 2 files changed, 62 insertions(+), 49 deletions(-)

diff --git a/types/marked/index.d.ts b/types/marked/index.d.ts
index a4dc048cc8..034c0cca18 100644
--- a/types/marked/index.d.ts
+++ b/types/marked/index.d.ts
@@ -1,7 +1,8 @@
-// Type definitions for Marked 0.3
+// Type definitions for Marked 0.4
 // Project: https://github.com/chjj/marked
 // Definitions by: William Orr <https://github.com/worr>
 //                 BendingBender <https://github.com/BendingBender>
+//                 CrossR <https://github.com/CrossR>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 export as namespace marked;
@@ -202,21 +203,9 @@ declare namespace marked {
 
     interface MarkedOptions {
         /**
-         * Type: object Default: new Renderer()
-         *
-         * An object containing functions to render tokens to HTML.
+         * A prefix URL for any relative link.
          */
-        renderer?: Renderer;
-
-        /**
-         * Enable GitHub flavored markdown.
-         */
-        gfm?: boolean;
-
-        /**
-         * Enable GFM tables. This option requires the gfm option to be true.
-         */
-        tables?: boolean;
+        baseUrl?: string;
 
         /**
          * Enable GFM line breaks. This option requires the gfm option to be true.
@@ -224,34 +213,19 @@ declare namespace marked {
         breaks?: boolean;
 
         /**
-         * Conform to obscure parts of markdown.pl as much as possible. Don't fix any of the original markdown bugs or poor behavior.
+         * Enable GitHub flavored markdown.
          */
-        pedantic?: boolean;
+        gfm?: boolean;
 
         /**
-         * Sanitize the output. Ignore any HTML that has been input.
+         * Include an id attribute when emitting headings.
          */
-        sanitize?: boolean;
+        headerIds?: boolean;
 
         /**
-         * Optionally sanitize found HTML with a sanitizer function.
+         * Set the prefix for header tag ids.
          */
-        sanitizer?(html: string): string;
-
-        /**
-         * Mangle autolinks (<email@domain.com>).
-         */
-        mangle?: boolean;
-
-        /**
-         * Use smarter list behavior than the original markdown. May eventually be default with the old behavior moved into pedantic.
-         */
-        smartLists?: boolean;
-
-        /**
-         * Shows an HTML error message when rendering fails.
-         */
-        silent?: boolean;
+        headerPrefix?: string;
 
         /**
          * A function to highlight code blocks. The function takes three arguments: code, lang, and callback.
@@ -263,15 +237,52 @@ declare namespace marked {
          */
         langPrefix?: string;
 
+        /**
+         * Mangle autolinks (<email@domain.com>).
+         */
+        mangle?: boolean;
+
+        /**
+         * Conform to obscure parts of markdown.pl as much as possible. Don't fix any of the original markdown bugs or poor behavior.
+         */
+        pedantic?: boolean;
+
+        /**
+         * Type: object Default: new Renderer()
+         *
+         * An object containing functions to render tokens to HTML.
+         */
+        renderer?: Renderer;
+
+        /**
+         * Sanitize the output. Ignore any HTML that has been input.
+         */
+        sanitize?: boolean;
+
+        /**
+         * Optionally sanitize found HTML with a sanitizer function.
+         */
+        sanitizer?(html: string): string;
+
+        /**
+         * Shows an HTML error message when rendering fails.
+         */
+        silent?: boolean;
+
+        /**
+         * Use smarter list behavior than the original markdown. May eventually be default with the old behavior moved into pedantic.
+         */
+        smartLists?: boolean;
+
         /**
          * Use "smart" typograhic punctuation for things like quotes and dashes.
          */
         smartypants?: boolean;
 
         /**
-         * Set the prefix for header tag ids.
+         * Enable GFM tables. This option requires the gfm option to be true.
          */
-        headerPrefix?: string;
+        tables?: boolean;
 
         /**
          * Generate closing slash for self-closing tags (<br/> instead of <br>)
diff --git a/types/marked/marked-tests.ts b/types/marked/marked-tests.ts
index 9499de3a56..8a80f2966c 100644
--- a/types/marked/marked-tests.ts
+++ b/types/marked/marked-tests.ts
@@ -1,6 +1,7 @@
 import * as marked from 'marked';
 
 const options: marked.MarkedOptions = {
+    baseUrl: '',
     gfm: true,
     tables: true,
     breaks: false,
@@ -16,23 +17,24 @@ const options: marked.MarkedOptions = {
     renderer: new marked.Renderer()
 };
 
-function callback() {
-    console.log('callback called');
+function callback(err: string, markdown: string) {
+    console.log("Callback called!");
+    return markdown
 }
 
 const myOldMarked: typeof marked = marked.setOptions(options);
 
-console.log(marked('i am using __markdown__.'));
-console.log(marked('i am using __markdown__.', options));
-console.log(marked('i am using __markdown__.', callback));
-console.log(marked('i am using __markdown__.', options, callback));
+console.log(marked('1) I am using __markdown__.'));
+console.log(marked('2) I am using __markdown__.', options));
+console.log(marked('3) I am using __markdown__.', callback));
+console.log(marked('4) I am using __markdown__.', options, callback));
 
-console.log(marked.parse('i am using __markdown__.'));
-console.log(marked.parse('i am using __markdown__.', options));
-console.log(marked.parse('i am using __markdown__.', callback));
-console.log(marked.parse('i am using __markdown__.', options, callback));
+console.log(marked.parse('5) I am using __markdown__.'));
+console.log(marked.parse('6) I am using __markdown__.', options));
+console.log(marked.parse('7) I am using __markdown__.', callback));
+console.log(marked.parse('8) I am using __markdown__.', options, callback));
 
-const text = 'something';
+const text = 'Something';
 const tokens: marked.TokensList = marked.lexer(text, options);
 console.log(marked.parser(tokens));
 

From 3354cf5661f2a1066db181157a7e4ffd23771823 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 8 Jun 2018 15:43:34 -0700
Subject: [PATCH 050/180] Outlook permission level links

---
 types/office-js/index.d.ts | 444 ++++++++++++++++++-------------------
 1 file changed, 222 insertions(+), 222 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 464260f617..cd0efc7f23 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -459,7 +459,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -484,7 +484,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -535,7 +535,7 @@ declare namespace Office {
          * 
          * Add-in type: Content, task pane, Outlook
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or Read
          */
@@ -552,7 +552,7 @@ declare namespace Office {
              *
              * @remarks
              * 
-             * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+             * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
              *
              * Applicable Outlook mode: Compose or read
              * 
@@ -5744,7 +5744,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -5780,7 +5780,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -5795,7 +5795,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5815,7 +5815,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5830,7 +5830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5849,7 +5849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5870,7 +5870,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5890,7 +5890,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5908,7 +5908,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5925,7 +5925,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5950,7 +5950,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5974,7 +5974,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5996,7 +5996,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6018,7 +6018,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6043,7 +6043,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6067,7 +6067,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6089,7 +6089,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6109,7 +6109,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Read
      */
@@ -6147,7 +6147,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6160,7 +6160,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6175,7 +6175,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -6192,7 +6192,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6210,7 +6210,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6222,7 +6222,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6235,7 +6235,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6248,7 +6248,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6271,7 +6271,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6283,7 +6283,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6311,7 +6311,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6343,7 +6343,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6384,7 +6384,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      * 
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose
      */
@@ -6399,7 +6399,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          * 
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6419,7 +6419,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6456,7 +6456,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6472,7 +6472,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6488,7 +6488,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6504,7 +6504,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6524,7 +6524,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6549,7 +6549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6563,7 +6563,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6577,7 +6577,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6589,7 +6589,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6603,7 +6603,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6619,7 +6619,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6634,7 +6634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6658,7 +6658,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6678,7 +6678,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         * Applicable Outlook mode: Compose or read
         */
         location: string;
@@ -6697,7 +6697,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         */
@@ -6718,7 +6718,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6742,7 +6742,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6764,7 +6764,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6777,7 +6777,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6789,7 +6789,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6801,7 +6801,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6815,7 +6815,7 @@ declare namespace Office {
          *
          * Note: This member is not supported in Outlook for iOS or Outlook for Android.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6829,7 +6829,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6841,7 +6841,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6860,7 +6860,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6879,7 +6879,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6894,7 +6894,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6915,7 +6915,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6936,7 +6936,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         *
@@ -6954,7 +6954,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6975,7 +6975,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -7002,7 +7002,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7017,7 +7017,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7047,7 +7047,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7073,7 +7073,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7102,7 +7102,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7132,7 +7132,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7159,7 +7159,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7183,7 +7183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7209,7 +7209,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7236,7 +7236,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose
          */
@@ -7252,7 +7252,7 @@ declare namespace Office {
          *
          * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7275,7 +7275,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7297,7 +7297,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7316,7 +7316,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7337,7 +7337,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7355,7 +7355,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7375,7 +7375,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7405,7 +7405,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7435,7 +7435,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7462,7 +7462,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7491,7 +7491,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7509,7 +7509,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7531,7 +7531,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7549,7 +7549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7570,7 +7570,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7596,7 +7596,7 @@ declare namespace Office {
          *
          * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7618,7 +7618,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7634,7 +7634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7648,7 +7648,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7664,7 +7664,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7683,7 +7683,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7707,7 +7707,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7725,7 +7725,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7743,7 +7743,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7759,7 +7759,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7786,7 +7786,7 @@ declare namespace Office {
          * |URL|String|Restricted|
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Read
          *
@@ -7804,7 +7804,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7828,7 +7828,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7849,7 +7849,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7865,7 +7865,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7888,7 +7888,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7911,7 +7911,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7931,7 +7931,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -7947,7 +7947,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7963,7 +7963,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7977,7 +7977,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7998,7 +7998,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8016,7 +8016,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8028,7 +8028,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8044,7 +8044,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8058,7 +8058,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8072,7 +8072,7 @@ declare namespace Office {
      *
      * @remarks
      *
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8116,7 +8116,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -8133,7 +8133,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8148,7 +8148,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8166,7 +8166,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8183,7 +8183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8202,7 +8202,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8220,7 +8220,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8243,7 +8243,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8264,7 +8264,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8284,7 +8284,7 @@ declare namespace Office {
          *
          * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to {@link https://msdn.microsoft.com/library/office/dn148008.aspx | get attachments from the selected item}.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8308,7 +8308,7 @@ declare namespace Office {
          *
          * The restUrl value can be used to make {@link https://docs.microsoft.com/outlook/rest/ | REST API} calls to the user's mailbox.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8328,7 +8328,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8349,7 +8349,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8368,7 +8368,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8386,7 +8386,7 @@ declare namespace Office {
          *
          * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the {@link https://msdn.microsoft.com/office/office365/APi/mail-rest-operations | Outlook Mail API} or the {@link http://graph.microsoft.io/ | Microsoft Graph}. The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8403,7 +8403,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8428,7 +8428,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8452,7 +8452,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8476,7 +8476,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8494,7 +8494,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8535,7 +8535,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8560,7 +8560,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8582,7 +8582,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8601,7 +8601,7 @@ declare namespace Office {
          *
          * The getUserIdentityTokenAsync method returns a token that you can use to identify and {@link https://msdn.microsoft.com/library/office/fp179828.aspx | authenticate the add-in and user with a third-party system}.
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8640,7 +8640,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteMailbox
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteMailbox
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8661,7 +8661,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8697,7 +8697,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8729,7 +8729,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8748,7 +8748,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8764,7 +8764,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8782,7 +8782,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8799,7 +8799,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8810,7 +8810,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8825,7 +8825,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8838,7 +8838,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8854,7 +8854,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8867,7 +8867,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8882,7 +8882,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8898,7 +8898,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8917,7 +8917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8933,7 +8933,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8951,7 +8951,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8969,7 +8969,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8991,7 +8991,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9010,7 +9010,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9036,7 +9036,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9059,7 +9059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9084,7 +9084,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9103,7 +9103,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9118,7 +9118,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9143,7 +9143,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9171,7 +9171,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9196,7 +9196,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9223,7 +9223,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9253,7 +9253,7 @@ declare namespace Office {
      * |Meeting Request - Read Series|No (setAsync not available)|Yes (item.recurrence)|
      * |Meeting Request - Read Instance|No (setAsync not available)|Yes (item.recurrence)|
      * 
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9265,7 +9265,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9277,7 +9277,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9290,7 +9290,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9303,7 +9303,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9318,7 +9318,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9337,7 +9337,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9354,7 +9354,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9376,7 +9376,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9395,7 +9395,7 @@ declare namespace Office {
      * 
      * @remarks
      * 
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9487,7 +9487,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9498,7 +9498,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9512,7 +9512,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9527,7 +9527,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9546,7 +9546,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9562,7 +9562,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9573,7 +9573,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9585,7 +9585,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9597,7 +9597,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9609,7 +9609,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9621,7 +9621,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9633,7 +9633,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9647,7 +9647,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9665,7 +9665,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9681,7 +9681,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9699,7 +9699,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9715,7 +9715,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9732,7 +9732,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9749,7 +9749,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9761,7 +9761,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9776,7 +9776,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9793,7 +9793,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9813,7 +9813,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9830,7 +9830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9849,7 +9849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9869,7 +9869,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -9889,7 +9889,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9902,7 +9902,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9917,7 +9917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9936,7 +9936,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9958,7 +9958,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9977,7 +9977,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9998,7 +9998,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -10016,7 +10016,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -10037,7 +10037,7 @@ declare namespace Office {
          * |office365 |The mailbox is associated with an Office 365 work or school account.|
          * |outlookCom |The mailbox is associated with a personal Outlook.com account.|
          *
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10048,7 +10048,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10059,7 +10059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10070,7 +10070,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link /outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */

From 10dc3c49b11574f13962b1a1f2604b3e943c9190 Mon Sep 17 00:00:00 2001
From: CrossR <sc13rjc@leeds.ac.uk>
Date: Sat, 9 Jun 2018 09:40:59 +0100
Subject: [PATCH 051/180] Fix lint error.

---
 types/marked/marked-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/marked/marked-tests.ts b/types/marked/marked-tests.ts
index 8a80f2966c..e1cb63042c 100644
--- a/types/marked/marked-tests.ts
+++ b/types/marked/marked-tests.ts
@@ -19,7 +19,7 @@ const options: marked.MarkedOptions = {
 
 function callback(err: string, markdown: string) {
     console.log("Callback called!");
-    return markdown
+    return markdown;
 }
 
 const myOldMarked: typeof marked = marked.setOptions(options);

From d5c2d6a0e3ffb17b59ce9787907e97003739d213 Mon Sep 17 00:00:00 2001
From: Christopher Deutsch <cd@cdeutsch.com>
Date: Sat, 9 Jun 2018 13:03:58 -0500
Subject: [PATCH 052/180] Add `type` property for `<ol>`
 https://developer.mozilla.org/en-US/docs/Web/API/HTMLOListElement

---
 types/react/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/react/index.d.ts b/types/react/index.d.ts
index 27a76a9a08..b4fb9415d3 100644
--- a/types/react/index.d.ts
+++ b/types/react/index.d.ts
@@ -1545,6 +1545,7 @@ declare namespace React {
     interface OlHTMLAttributes<T> extends HTMLAttributes<T> {
         reversed?: boolean;
         start?: number;
+        type?: '1' | 'a' | 'A' | 'i' | 'I';
     }
 
     interface OptgroupHTMLAttributes<T> extends HTMLAttributes<T> {

From 28c7670bba135e67e244d63e03c6ef2128677c5e Mon Sep 17 00:00:00 2001
From: Yevgen Muntyan <muntyan@fastmail.fm>
Date: Sun, 3 Jun 2018 22:17:03 -0700
Subject: [PATCH 053/180] Add definitions for Gpio.glitchFilter() and
 pigpio.configureSocketPort()

---
 types/pigpio/index.d.ts      | 18 ++++++++++++++++--
 types/pigpio/pigpio-tests.ts | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+), 2 deletions(-)

diff --git a/types/pigpio/index.d.ts b/types/pigpio/index.d.ts
index ea9a312286..79d0ebe0f9 100644
--- a/types/pigpio/index.d.ts
+++ b/types/pigpio/index.d.ts
@@ -160,15 +160,21 @@ export class Gpio extends NodeJS.EventEmitter {
     disableInterrupt(): Gpio;
 
     /**
-     * Enables alerts for the GPIO.
+     * Enables alerts for the GPIO. Returns this.
      */
     enableAlert(): Gpio;
 
     /**
-     * Disables aterts for the GPIO.
+     * Disables aterts for the GPIO. Returns this.
      */
     disableAlert(): Gpio;
 
+    /**
+     * Sets a glitch filter on a GPIO. Returns this.
+     * @param steady    Time, in microseconds, during which the level must be stable. Maximum value: 300000
+     */
+    glitchFilter(steady: number): Gpio;
+
     /*----------------------*
      * mode
      *----------------------*/
@@ -410,3 +416,11 @@ export function terminate(): void;
  * @param peripheral    an unsigned integer specifying the peripheral for timing (CLOCK_PWM or CLOCK_PCM)
  */
 export function configureClock(microseconds: number, peripheral: number): void;
+
+/**
+ * Configures pigpio to use the specified socket port.
+ * The default setting is to use port 8888.
+ * If configureSocketPort is called, it must be called before creating Gpio objects.
+ * @param port          an unsigned integer specifying the pigpio socket port number
+ */
+export function configureSocketPort(port: number): void;
diff --git a/types/pigpio/pigpio-tests.ts b/types/pigpio/pigpio-tests.ts
index a4679e57f9..90e7d4485d 100644
--- a/types/pigpio/pigpio-tests.ts
+++ b/types/pigpio/pigpio-tests.ts
@@ -5,6 +5,7 @@ import * as assert from 'assert';
     const Gpio = pigpio.Gpio;
 
     pigpio.configureClock(1, pigpio.CLOCK_PWM);
+    pigpio.configureSocketPort(23456);
 
     const led = new Gpio(18, {
         mode: Gpio.OUTPUT,
@@ -878,3 +879,37 @@ import * as assert from 'assert';
         clearInterval(iv);
     }, 2000);
 })();
+
+(function gpio_glitch_filter(): void {
+    const Gpio = pigpio.Gpio;
+    const input = new Gpio(7, {
+        mode: Gpio.INPUT,
+        pullUpDown: Gpio.PUD_OFF,
+        alert: true
+    });
+    const output = new Gpio(8, {
+      mode: Gpio.OUTPUT
+    });
+    let count = 0;
+
+    output.digitalWrite(0);
+    input.glitchFilter(50);
+    input.on('alert', (level, tick) => {
+        if (level === 1) {
+            count++;
+            console.log('  rising edge, count=' + count);
+        }
+    });
+
+    output.trigger(30, 1); // alert function should not be executed (blocked by glitchFilter)
+
+    setTimeout(() => {
+        output.trigger(70, 1); // alert function should be executed
+    }, 500);
+
+    setTimeout(() => {
+        assert.strictEqual(count, 1, 'expected 1 alert function call instead of ' + count);
+        console.log("  success...");
+        process.exit(0);
+    }, 1000);
+})();

From 84cb163ba99cd0d694d12f68eeec7960b2c7df08 Mon Sep 17 00:00:00 2001
From: Trygve Wastvedt <twastvedt@azahner.com>
Date: Sat, 9 Jun 2018 22:02:23 -0500
Subject: [PATCH 054/180] Update UniformsLibs, fix typos.

---
 types/three/three-core.d.ts | 39 +++++++++++++++++++++++++++++--------
 1 file changed, 31 insertions(+), 8 deletions(-)

diff --git a/types/three/three-core.d.ts b/types/three/three-core.d.ts
index 3ad1568409..3c787698c8 100644
--- a/types/three/three-core.d.ts
+++ b/types/three/three-core.d.ts
@@ -5865,13 +5865,18 @@ export let UniformsLib: {
         diffuse: IUniform;
         opacity: IUniform;
         map: IUniform;
-        offsetRepeat: IUniform;
-        specularMap: IUniform;
+        uvTransform: IUniform;
         alphaMap: IUniform;
+    };
+    specularmap: {
+        specularMap: IUniform;
+    };
+    envmap: {
         envMap: IUniform;
         flipEnvMap: IUniform;
         reflectivity: IUniform;
-        refractionRation: IUniform;
+        refractionRatio: IUniform;
+        maxMipLevel: IUniform;
     };
     aomap: {
         aoMap: IUniform;
@@ -5881,7 +5886,9 @@ export let UniformsLib: {
         lightMap: IUniform;
         lightMapIntensity: IUniform;
     };
-    emissivemap: { emissiveMap: IUniform };
+    emissivemap: {
+        emissiveMap: IUniform
+    };
     bumpmap: {
         bumpMap: IUniform;
         bumpScale: IUniform;
@@ -5895,8 +5902,15 @@ export let UniformsLib: {
         displacementScale: IUniform;
         displacementBias: IUniform;
     };
-    roughnessmap: { roughnessMap: IUniform };
-    metalnessmap: { metalnessMap: IUniform };
+    roughnessmap: {
+        roughnessMap: IUniform
+    };
+    metalnessmap: {
+        metalnessMap: IUniform
+    };
+    gradientmap: {
+        gradientMap: IUniform
+    };
     fog: {
         fogDensity: IUniform;
         fogNear: IUniform;
@@ -5951,7 +5965,7 @@ export let UniformsLib: {
         };
         pointShadowMap: IUniform;
         pointShadowMatrix: IUniform;
-        hemisphereLigtts: {
+        hemisphereLights: {
             value: any[];
             properties: {
                 direction: {};
@@ -5959,6 +5973,15 @@ export let UniformsLib: {
                 groundColor: {};
             };
         };
+        rectAreaLights: {
+            value: any[];
+            properties: {
+                color: {};
+                position: {};
+                width: {};
+                height: {};
+            }
+        }
     };
     points: {
         diffuse: IUniform;
@@ -5966,7 +5989,7 @@ export let UniformsLib: {
         size: IUniform;
         scale: IUniform;
         map: IUniform;
-        offsetRepeat: IUniform;
+        uvTransform: IUniform;
     };
 };
 

From edb300f2589f3873b7cf7cc96ee04c4804876ab3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20=C5=81aziuk?= <tlaziuk@gmail.com>
Date: Sun, 10 Jun 2018 11:23:53 +0200
Subject: [PATCH 055/180] v6

---
 types/universal-router/index.d.ts             | 123 +++++++++-----
 types/universal-router/tslint.json            |   3 -
 .../universal-router-tests.ts                 | 154 +++++++-----------
 3 files changed, 148 insertions(+), 132 deletions(-)

diff --git a/types/universal-router/index.d.ts b/types/universal-router/index.d.ts
index 47a7384872..fdfd97ed1c 100644
--- a/types/universal-router/index.d.ts
+++ b/types/universal-router/index.d.ts
@@ -1,32 +1,62 @@
-// Type definitions for universal-router 1.2
+// Type definitions for universal-router 6.0
 // Project: https://github.com/kriasoft/universal-router
 // Definitions by: Jack Moore <https://github.com/jtmthf>
+//                 Tomek Łaziuk <https://github.com/tlaziuk>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.3
 
 /**
- * Params is a key/value object that represents extracted URL paramters. Each
- * URL parameter resolves to a string.
+ * Params is a key/value object that represents extracted URL paramters.
+ * Each URL parameter resolves to a string.
  */
 export interface Params {
-  [key: string]: string;
+    [_: string]: string;
 }
 
 /**
- * Context represents the context that is passed as the second argument
- * passed to resolve. By default, it only is require to contain a path, but
- * can be extended by the way of generics.
+ * In addition to a URL path string, any arbitrary data can be passed to the `router.resolve()` method, that becomes available inside action functions.
  */
 export interface Context {
-  path: string;
+    [_: string]: any;
 }
 
-/**
- * ActionContext is similar to Context, with the exception of an added params
- * object. ActionContext is passed as the first argument to the action
- * function.
- */
-export interface ActionContext extends Context {
-  params: Params;
+export interface PathnameContext extends Context {
+    /**
+     * URL which was transmitted to `router.resolve()`.
+     */
+    pathname: string;
+}
+
+export interface ActionContext<C extends Context, R = any> extends PathnameContext {
+    /**
+     * Current router instance.
+     */
+    router: UniversalRouter<C, R>;
+    /**
+     * Matched route object.
+     */
+    route: Route<any, any>;
+    /**
+     * Middleware style function which can continue resolving.
+     */
+    next: (resume?: boolean, parent?: Route<any, any>, prevResult?: any) => Promise<R>;
+    /**
+     * Base URL path relative to the path of the current route.
+     */
+    baseUrl: string;
+    /**
+     * Matched path.
+     */
+    path: string;
+    /**
+     * Matched path params.
+     */
+    params: Params;
+    /**
+     * An array of keys found in the path, see `path-to-regexp` documentation for details.
+     * @see https://github.com/pillarjs/path-to-regexp
+     */
+    keys: any;
 }
 
 /**
@@ -34,35 +64,54 @@ export interface ActionContext extends Context {
  * action function, and optional children which are an array of Route.
  *
  * @template C User context that is made union with ActionContext.
- * @template R Result that every action function resolves to. If the action
- *  returns a Promise, R can be the type the Promise resolves to.
+ * @template R Result that every action function resolves to. If the action returns a Promise, R can be the type the Promise resolves to.
  */
-export interface Route<C, R> {
-  path: string;
-  action(ctx: ActionContext & C, params: Params): R | Promise<R> | void;
-  children?: Routes<C, R>;
+export interface Route<C extends Context = any, R = any> {
+    path?: string | RegExp | Array<string | RegExp>;
+    /**
+     * unique string
+     */
+    name?: string;
+    /**
+     * automatically filled by the router
+     */
+    parent?: Route<any, any> | null;
+    /**
+     * array of route objects
+     */
+    children?: Routes<C, R> | null;
+    /**
+     * action method should return anything except `null` or `undefined` to be resolved by router
+     * otherwise router will throw `Page not found` error if all matched routes returned nothing
+     */
+    action?: (context: ActionContext<C, R> & C, params: Params) => R | Promise<R> | void;
 }
 
 /**
  * Routes in an array of type Route.
  * @template C User context that is made union with ActionContext.
- * @template R Result that every action function resolves to. If the action
- *  returns a Promise, R can be the type the Promise resolves to.
+ * @template R Result that every action function resolves to. If the action returns a Promise, R can be the type the Promise resolves to.
  */
-export type Routes<C, R> = Array<Route<C, R>>;
+export type Routes<C extends Context = Context, R = any> = Array<Route<C, R>>;
+
+export interface Options<C extends Context = Context, R = any> {
+    context?: C;
+    baseUrl?: string;
+    resolveRoute?: (context: ActionContext<C, R> & C, params: Params) => any;
+    errorHandler?: (error: Error & { context: C, code: number }) => any;
+}
 
 /**
- * Resolve function that is given routes and a path or context object.
- * Returns a Promise that resolves to result of the action function of the
- * matched route.
- *
- * @template C User context that is made union with Context.
- * @template R Result that every action function resolves to. If the action
- *  returns a Promise, R can be the type the Promise resolves to.
- *
- * @param routes - Single route or array of routes.
- * @param pathOrContext - path to resolve or
- *  context object that contains the path along with other data.
- * @return - Result of matched action function wrapped in a Promsie.
+ * @see https://github.com/kriasoft/universal-router/blob/v6.0.0/docs/api.md
  */
-export function resolve<C, R>(routes: Routes<C, R> | Route<C, R>, pathOrContext: string | String | Context & C): Promise<R>;
+export default class UniversalRouter<C extends Context = Context, R = any> {
+    constructor(routes: Routes<C, R> | Route<C, R>, options?: Options<C>)
+    /**
+     * Traverses the list of routes in the order they are defined until it finds the first route that matches provided URL path string and whose action function returns anything other than null or undefined.
+     */
+    resolve(pathnameOrContext: string | PathnameContext): Promise<R>;
+    /**
+     * `path-to-regexp` function
+     */
+    static pathToRegexp: any;
+}
diff --git a/types/universal-router/tslint.json b/types/universal-router/tslint.json
index a62d0d4e68..e595b70d63 100644
--- a/types/universal-router/tslint.json
+++ b/types/universal-router/tslint.json
@@ -1,6 +1,3 @@
 {
     "extends": "dtslint/dt.json",
-    "rules": {
-        "ban-types": false
-    }
 }
diff --git a/types/universal-router/universal-router-tests.ts b/types/universal-router/universal-router-tests.ts
index ea6853e2cf..26fd8a21d1 100644
--- a/types/universal-router/universal-router-tests.ts
+++ b/types/universal-router/universal-router-tests.ts
@@ -1,95 +1,65 @@
-import { ActionContext, Params, resolve } from "universal-router";
+import UniversalRouter from "universal-router";
 
-// Test 1
-const routes1 = [
-  {
-    path: "/one",
-    action: () => "Page One"
-  },
-  {
-    path: "/two",
-    action: () => "Page Two"
-  }
-];
+new UniversalRouter(
+    {
+        path: '',
+        name: 'root',
+        action: (context) => context.path,
+    },
+    {
+        context: {
+            user: 'name',
+        },
+        baseUrl: '/base',
+        errorHandler: (error) => {
+            console.error(error)
+            console.dir(error.context)
+            return error.code === 404
+                ? '<h1>Page Not Found</h1>'
+                : '<h1>Oops! Something went wrong</h1>'
+        },
+    },
+).resolve('/').then(console.log);
 
-resolve(routes1, { path: "/one" })
-  .then(result => console.log(result));
+new UniversalRouter({
+    path: '/admin',
+    children: [
+        {
+            path: '',
+            action: () => 'Admin Page',
+        },
+        {
+            path: '/users',
+            children: [
+                {
+                    path: '',
+                    action: () => 'User List',
+                },
+                {
+                    path: '/:username',
+                    action: () => 'User Profile',
+                },
+            ],
+        },
+    ],
+}).resolve({ pathname: '/admin/users/john' })
+    .then(result => console.log(result));
 
-// Test 2
-const routes2 = [
-  {
-    path: "/hello/:username",
-    action: (context: ActionContext) => `Welcome, ${context.params["username"]}!`
-  }
-];
-
-resolve(routes2, { path: "/hello/john" })
-  .then(result => console.log(result));
-
-// Test 3
-const routes3 = [
-  {
-    path: "/hello/:username",
-    action: (ctx: ActionContext, { username }: Params) => `Welcome, ${username}!`
-  }
-];
-
-resolve(routes3, { path: "/hello/john" })
-  .then(result => console.log(result));
-
-// Test 4
-const routes4 = [
-  {
-    path: "/hello",
-    action: () => new Promise(resolve => {
-      setTimeout(() => resolve("Welcome!"), 1000);
-    })
-  }
-];
-
-resolve(routes4, { path: "/hello" })
-  .then(result => console.log(result));
-
-// Test 5
-const routes5 = [
-  {
-    path: "/hello/:username",
-    async action(ctx: ActionContext, { username }: Params) {
-      const waitable = async (name: string) => {
-        console.log(`Welcome ${name}`);
-      };
-      await waitable(username);
-    }
-  }
-];
-
-resolve(routes5, { path: "/hello/john" })
-  .then(result => console.log(result));
-
-// Test 6
-const routes6 = [
-  { path: "/one", action: () => "<h1>Page One</h1>" },
-  { path: "/two", action: () => "<h1>Page Two</h1>" }
-];
-
-resolve(routes6, { path: "/one" }).then(result => {
-  document.body.innerHTML = result || "<h1>Not Found</h1>";
-});
-
-// Test 7
-interface Render {
-  render: typeof render;
-}
-
-const routes7 = [
-  { path: "/one", action: ({ render: func }: ActionContext & Render) => func("<h1>Page One</h1>") },
-  { path: "/two", action: ({ render: func }: ActionContext & Render) => func("<h1>Page Two</h1>") }
-];
-
-function render(component: string) {
-  return new Promise(resolve => {
-    console.log(`Rendering... ${component}`);
-  });
-}
-
-resolve<Render, Promise<{}>>(routes7, { path: "/one", render });
+new UniversalRouter({
+    path: '', // optional
+    async action({ next }) {
+        console.log('middleware: start')
+        const child = await next()
+        console.log('middleware: end')
+        return child
+    },
+    children: [
+        {
+            path: '/hello',
+            action() {
+                console.log('route: return a result')
+                return 'Hello, world!'
+            },
+        },
+    ],
+})

From d8150f8d2fb804020e4f9f315ba1d22eaf450ec8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20=C5=81aziuk?= <tlaziuk@gmail.com>
Date: Sun, 10 Jun 2018 12:20:57 +0200
Subject: [PATCH 056/180] lint

---
 types/universal-router/index.d.ts             |  9 +++++----
 types/universal-router/tslint.json            |  2 +-
 .../universal-router-tests.ts                 | 20 +++++++++----------
 3 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/types/universal-router/index.d.ts b/types/universal-router/index.d.ts
index fdfd97ed1c..66c424d5f0 100644
--- a/types/universal-router/index.d.ts
+++ b/types/universal-router/index.d.ts
@@ -35,11 +35,11 @@ export interface ActionContext<C extends Context, R = any> extends PathnameConte
     /**
      * Matched route object.
      */
-    route: Route<any, any>;
+    route: Route;
     /**
      * Middleware style function which can continue resolving.
      */
-    next: (resume?: boolean, parent?: Route<any, any>, prevResult?: any) => Promise<R>;
+    next: (resume?: boolean, parent?: Route, prevResult?: any) => Promise<R>;
     /**
      * Base URL path relative to the path of the current route.
      */
@@ -75,7 +75,7 @@ export interface Route<C extends Context = any, R = any> {
     /**
      * automatically filled by the router
      */
-    parent?: Route<any, any> | null;
+    parent?: Route | null;
     /**
      * array of route objects
      */
@@ -107,7 +107,8 @@ export interface Options<C extends Context = Context, R = any> {
 export default class UniversalRouter<C extends Context = Context, R = any> {
     constructor(routes: Routes<C, R> | Route<C, R>, options?: Options<C>)
     /**
-     * Traverses the list of routes in the order they are defined until it finds the first route that matches provided URL path string and whose action function returns anything other than null or undefined.
+     * Traverses the list of routes in the order they are defined until it finds the first route that matches provided URL path string
+     * and whose action function returns anything other than null or undefined.
      */
     resolve(pathnameOrContext: string | PathnameContext): Promise<R>;
     /**
diff --git a/types/universal-router/tslint.json b/types/universal-router/tslint.json
index e595b70d63..f93cf8562a 100644
--- a/types/universal-router/tslint.json
+++ b/types/universal-router/tslint.json
@@ -1,3 +1,3 @@
 {
-    "extends": "dtslint/dt.json",
+    "extends": "dtslint/dt.json"
 }
diff --git a/types/universal-router/universal-router-tests.ts b/types/universal-router/universal-router-tests.ts
index 26fd8a21d1..0c92dad102 100644
--- a/types/universal-router/universal-router-tests.ts
+++ b/types/universal-router/universal-router-tests.ts
@@ -12,11 +12,11 @@ new UniversalRouter(
         },
         baseUrl: '/base',
         errorHandler: (error) => {
-            console.error(error)
-            console.dir(error.context)
+            console.error(error);
+            console.dir(error.context);
             return error.code === 404
                 ? '<h1>Page Not Found</h1>'
-                : '<h1>Oops! Something went wrong</h1>'
+                : '<h1>Oops! Something went wrong</h1>';
         },
     },
 ).resolve('/').then(console.log);
@@ -48,18 +48,18 @@ new UniversalRouter({
 new UniversalRouter({
     path: '', // optional
     async action({ next }) {
-        console.log('middleware: start')
-        const child = await next()
-        console.log('middleware: end')
-        return child
+        console.log('middleware: start');
+        const child = await next();
+        console.log('middleware: end');
+        return child;
     },
     children: [
         {
             path: '/hello',
             action() {
-                console.log('route: return a result')
-                return 'Hello, world!'
+                console.log('route: return a result');
+                return 'Hello, world!';
             },
         },
     ],
-})
+});

From 83311151c9595c1c77394f615d0f5d0543e55cc0 Mon Sep 17 00:00:00 2001
From: Leonard Thieu <leonard.thieu@gmail.com>
Date: Sun, 10 Jun 2018 12:21:09 -0400
Subject: [PATCH 057/180] [jquery] Fix compatibility issue with
 `@types/bluebird-global`.

`@types/jquery` used the global Promise interface to indicate compatibility with other Promise implementations. `@types/bluebird-global` modifies the global Promise interface making it unsafe to use.

To remedy this, a private copy of the global Promise interface is introduced.
---
 types/jquery/index.d.ts                    | 26 +++++++++++++++++++---
 types/jquery/jquery-tests.ts               |  8 +++----
 types/jquery/test/bluebird-global-tests.ts |  4 ++++
 types/jquery/tsconfig.json                 |  3 ++-
 types/jquery/tslint.json                   |  1 +
 5 files changed, 34 insertions(+), 8 deletions(-)
 create mode 100644 types/jquery/test/bluebird-global-tests.ts

diff --git a/types/jquery/index.d.ts b/types/jquery/index.d.ts
index b0838f9a8d..72dff2b418 100644
--- a/types/jquery/index.d.ts
+++ b/types/jquery/index.d.ts
@@ -37,8 +37,6 @@ declare const $: JQueryStatic;
 
 // Used by JQuery.Event
 type _Event = Event;
-// Used by JQuery.Promise3 and JQuery.Promise
-type _Promise<T> = Promise<T>;
 
 interface JQueryStatic<TElement extends Node = HTMLElement> {
     /**
@@ -6525,6 +6523,28 @@ declare namespace JQuery {
      */
     interface Thenable<T> extends PromiseLike<T> { }
 
+    // NOTE: This is a private copy of the global Promise interface. It is used by JQuery.PromiseBase to indicate compatibility with other Promise implementations.
+    //       The global Promise interface cannot be used directly as it may be modified, as in the case of @types/bluebird-global.
+    /**
+     * Represents the completion of an asynchronous operation
+     */
+    interface _Promise<T> {
+        /**
+         * Attaches callbacks for the resolution and/or rejection 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.
+         * @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): JQuery._Promise<TResult1 | TResult2>;
+        /**
+         * Attaches a callback for only the rejection of the Promise.
+         * @param onrejected The callback to execute when the Promise is rejected.
+         * @returns A Promise for the completion of the callback.
+         */
+        catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): JQuery._Promise<T | TResult>;
+    }
+
     // Type parameter guide
     // --------------------
     // Each type parameter represents a parameter in one of the three possible callbacks.
@@ -6550,7 +6570,7 @@ declare namespace JQuery {
     interface PromiseBase<TR, TJ, TN,
         UR, UJ, UN,
         VR, VJ, VN,
-        SR, SJ, SN> extends _Promise<TR>, PromiseLike<TR> {
+        SR, SJ, SN> extends JQuery._Promise<TR>, PromiseLike<TR> {
         /**
          * Add handlers to be called when the Deferred object is either resolved or rejected.
          *
diff --git a/types/jquery/jquery-tests.ts b/types/jquery/jquery-tests.ts
index 47a85b80d2..2d0707bbe6 100644
--- a/types/jquery/jquery-tests.ts
+++ b/types/jquery/jquery-tests.ts
@@ -6857,7 +6857,7 @@ function JQuery_jqXHR() {
         }
     }
 
-    function compatibleWithPromise(): Promise<any> {
+    function compatibleWithPromise(): JQuery._Promise<any> {
         return p;
     }
 
@@ -7279,7 +7279,7 @@ function JQuery_Promise3() {
         return s;
     }
 
-    function compatibleWithPromise(): Promise<any> {
+    function compatibleWithPromise(): JQuery._Promise<any> {
         return p;
     }
 
@@ -7423,7 +7423,7 @@ function JQuery_Promise2(p: JQuery.Promise2<string, Error, number, JQuery, strin
         return s;
     }
 
-    function compatibleWithPromise(): Promise<any> {
+    function compatibleWithPromise(): JQuery._Promise<any> {
         return p;
     }
 
@@ -7544,7 +7544,7 @@ function JQuery_Promise(p: JQuery.Promise<string, Error, number>) {
         return s;
     }
 
-    function compatibleWithPromise(): Promise<any> {
+    function compatibleWithPromise(): JQuery._Promise<any> {
         return p;
     }
 }
diff --git a/types/jquery/test/bluebird-global-tests.ts b/types/jquery/test/bluebird-global-tests.ts
new file mode 100644
index 0000000000..3b7f58e9cd
--- /dev/null
+++ b/types/jquery/test/bluebird-global-tests.ts
@@ -0,0 +1,4 @@
+/// <reference types="bluebird-global" />
+
+// Pulls in bluebird-global to test compatibility.
+// Fixes https://github.com/DefinitelyTyped/DefinitelyTyped/issues/26328.
diff --git a/types/jquery/tsconfig.json b/types/jquery/tsconfig.json
index e481dc63c6..40a0bc76d4 100644
--- a/types/jquery/tsconfig.json
+++ b/types/jquery/tsconfig.json
@@ -21,6 +21,7 @@
     "files": [
         "index.d.ts",
         "jquery-tests.ts",
+        "test/bluebird-global-tests.ts",
         "test/example-tests.ts",
         "test/longdesc-tests.ts",
         "test/learn-tests.ts",
@@ -29,4 +30,4 @@
         "test/jquery-slim-no-window-module-tests.ts",
         "test/jquery-slim-window-module-tests.ts"
     ]
-}
\ No newline at end of file
+}
diff --git a/types/jquery/tslint.json b/types/jquery/tslint.json
index deae83dc66..d1d7bd0a0a 100644
--- a/types/jquery/tslint.json
+++ b/types/jquery/tslint.json
@@ -14,6 +14,7 @@
         "no-empty-interface": false,
         "no-misused-new": false,
         "no-object-literal-type-assertion": false,
+        "no-redundant-jsdoc-2": false,
         "no-unnecessary-generics": false,
         "no-unnecessary-qualifier": false,
         "no-unnecessary-type-assertion": false,

From ecf8cf915c33151b769d7b3ada256252127cf741 Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 15:39:09 -0400
Subject: [PATCH 058/180] Update mathjs type definitions to 4.4.2 release (from
 3.2.1)

---
 types/mathjs/index.d.ts      | 6655 +++++++++++++++++++++++-----------
 types/mathjs/mathjs-tests.ts |   27 +-
 2 files changed, 4496 insertions(+), 2186 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index cdecc3e1b4..3fa5455fe5 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -1,2252 +1,4561 @@
-// Type definitions for mathjs 3.21
-// Project: http://mathjs.org/
-// Definitions by: Ilya Shestakov <https://github.com/siavol>,
-// 				   Andy Patterson <https://github.com/andnp>
-// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.1
+// Type definitions for mathjs 4.4.2 Project: http://mathjs.org/ Definitions by:
+// Ilya Shestakov <https://github.com/siavol>, Andy Patterson
+// <https://github.com/andnp>, Brad Besserman <https://github.com/bradbesserman>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped TypeScript
+// Version: 2.8.1
 
-import { Decimal } from 'decimal.js';
+import { Decimal } from "decimal.js";
 
 declare const math: math.MathJsStatic; // tslint:disable-line strict-export-declare-modifiers
 export as namespace math; // tslint:disable-line strict-export-declare-modifiers
 export = math; // tslint:disable-line strict-export-declare-modifiers
 
-declare namespace math { // tslint:disable-line strict-export-declare-modifiers
-	type MathArray = number[]|number[][];
-	type MathType = number|BigNumber|Fraction|Complex|Unit|MathArray|Matrix;
-	type MathExpression = string|string[]|MathArray|Matrix;
+declare namespace math {
+    // tslint:disable-line strict-export-declare-modifiers
+    type MathArray = number[] | number[][];
+    type MathType =
+        | number
+        | BigNumber
+        | Fraction
+        | Complex
+        | Unit
+        | MathArray
+        | Matrix;
+    type MathExpression = string | string[] | MathArray | Matrix;
 
-	interface MathJsStatic {
-		e: number;
-		pi: number;
-		i: number;
-		Infinity: number;
-		LN2: number;
-		LN10: number;
-		LOG2E: number;
-		LOG10E: number;
-		NaN: number;
-		null: number;
-		phi: number;
-		SQRT1_2: number;
-		SQRT2: number;
-		tau: number;
+    interface MathJsStatic {
+        e: number;
+        pi: number;
+        i: number;
+        Infinity: number;
+        LN2: number;
+        LN10: number;
+        LOG2E: number;
+        LOG10E: number;
+        NaN: number;
+        null: number;
+        phi: number;
+        SQRT1_2: number;
+        SQRT2: number;
+        tau: number;
 
-		uninitialized: any;
-		version: string;
+        uninitialized: any;
+        version: string;
 
-		expression: MathNode;
+        expression: MathNode;
 
-		config: (options: any) => void;
+        /*************************************************************************
+         * Core functions
+         ************************************************************************/
 
-		/**
-		 * Solves the linear equation system by forwards substitution. Matrix must be a lower triangular matrix.
-		 * @param L A N x N matrix or array (L)
-		 * @param b A column vector with the b values
-		 * @returns A column vector with the linear system solution (x)
-		 */
-		lsolve(L: Matrix|MathArray, b: Matrix|MathArray): Matrix|MathArray;
+        /**
+         * Set configuration options for math.js, and get current options. Will
+         * emit a ‘config’ event, with arguments (curr, prev, changes).
+         * @param options Available options: {number} epsilon Minimum relative
+         * difference between two compared values, used by all comparison
+         * functions. {string} matrix A string ‘Matrix’ (default) or ‘Array’.
+         * {string} number A string ‘number’ (default), ‘BigNumber’, or
+         * ‘Fraction’ {number} precision The number of significant digits for
+         * BigNumbers. Not applicable for Numbers. {string} parenthesis How to
+         * display parentheses in LaTeX and string output. {string} randomSeed
+         * Random seed for seeded pseudo random number generator. Set to null to
+         * randomly seed.
+         * @returns Returns the current configuration
+         */
+        config: (options: object) => object;
+        /**
+         * Create a typed-function which checks the types of the arguments and
+         * can match them against multiple provided signatures. The
+         * typed-function automatically converts inputs in order to find a
+         * matching signature. Typed functions throw informative errors in case
+         * of wrong input arguments.
+         * @param name Optional name for the typed-function
+         * @param signatures Object with one or multiple function signatures
+         * @returns The created typed-function.
+         */
+        typed: (name: string, signatures: object) => any;
 
-		/**
-		 * Calculate the Matrix LU decomposition with partial pivoting. Matrix A is decomposed in two matrices (L, U)
-		 * and a row permutation vector p where A[p,:] = L * U
-		 * @param A A two dimensional matrix or array for which to get the LUP decomposition.
-		 * @returns The lower triangular matrix, the upper triangular matrix and the permutation matrix.
-		 */
-		lup(A?: Matrix|MathArray): MathArray;
+        /*************************************************************************
+         * Construction functions
+         ************************************************************************/
 
-		/**
-		 * Solves the linear system A * x = b where A is an [n x n] matrix and b is a [n] column vector.
-		 * @param A Invertible Matrix or the Matrix LU decomposition
-		 * @param b Column Vector
-		 * @returns Column vector with the solution to the linear system A * x = b
-		 */
-		lusolve(A: Matrix|MathArray|number, b: Matrix|MathArray): Matrix|MathArray;
+        /**
+         * Create a BigNumber, which can store numbers with arbitrary precision.
+         * When a matrix is provided, all elements will be converted to
+         * BigNumber.
+         * @param x Value for the big number, 0 by default.
+         * @returns The created bignumber
+         */
+        bignumber(
+            x?:
+                | number
+                | string
+                | Fraction
+                | BigNumber
+                | MathArray
+                | Matrix
+                | boolean
+                | null
+        ): BigNumber;
 
-		/**
-		 * Calculate the Sparse Matrix LU decomposition with full pivoting. Sparse Matrix A is decomposed in
-		 * two matrices (L, U) and two permutation vectors (pinv, q) where P * A * Q = L * U
-		 * @param A A two dimensional sparse matrix for which to get the LU decomposition.
-		 * @param order The Symbolic Ordering and Analysis order: 0 - Natural ordering, no permutation vector q is
-		 * returned 1 - Matrix must be square, symbolic ordering and analisis is performed on M = A + A' 2 - Symbolic
-		 * ordering and analysis is performed on M = A' * A. Dense columns from A' are dropped, A recreated from A'.
-		 * This is appropriate for LU factorization of non-symmetric matrices. 3 - Symbolic ordering and analysis is performed
-		 * on M = A' * A. This is best used for LU factorization is matrix M has no dense rows. A dense row is a row with
-		 * more than 10*sqr(columns) entries.
-		 * @param threshold Partial pivoting threshold (1 for partial pivoting)
-		 * @returns The lower triangular matrix, the upper triangular matrix and the permutation vectors.
-		 */
-		slu(A: Matrix, order: number, threshold: number): any;
+        /**
+         * Create a boolean or convert a string or number to a boolean. In case
+         * of a number, true is returned for non-zero numbers, and false in case
+         * of zero. Strings can be 'true' or 'false', or can contain a number.
+         * When value is a matrix, all elements will be converted to boolean.
+         * @param x A value of any type
+         * @returns The boolean value
+         */
+        boolean(
+            x: string | number | boolean | MathArray | Matrix | null
+        ): boolean | MathArray | Matrix;
 
-		/**
-		 * Solves the linear equation system by backward substitution. Matrix must be an upper triangular matrix. U * x = b
-		 * @param U A N x N matrix or array (U)
-		 * @param b A column vector with the b values
-		 * @returns A column vector with the linear system solution (x)
-		 */
-		usolve(U: Matrix|MathArray, b: Matrix|MathArray): Matrix|MathArray;
+        /**
+         * Wrap any value in a chain, allowing to perform chained operations on
+         * the value. All methods available in the math.js library can be called
+         * upon the chain, and then will be evaluated with the value itself as
+         * first argument. The chain can be closed by executing chain.done(),
+         * which returns the final value. The chain has a number of special
+         * functions: done() Finalize the chain and return the chain's value.
+         * valueOf() The same as done() toString() Executes math.format() onto
+         * the chain's value, returning a string representation of the value.
+         * @param value A value of any type on which to start a chained
+         * operation.
+         * @returns The created chain
+         */
+        chain(value?: any): MathJsChain;
 
-		/**
-		 * Calculate the absolute value of a number. For matrices, the function is evaluated element wise.
-		 * @param x A number or matrix for which to get the absolute value
-		 * @returns Absolute value of x
-		 */
-		abs(x: number): number;
-		abs(x: BigNumber): BigNumber;
-		abs(x: Fraction): Fraction;
-		abs(x: Complex): Complex;
-		abs(x: MathArray): MathArray;
-		abs(x: Matrix): Matrix;
-		abs(x: Unit): Unit;
+        /**
+         * Create a complex value or convert a value to a complex value.
+         * @param args Arguments specifying the real and imaginary part of the
+         * complex number
+         * @returns Returns a complex value
+         */
+        complex(arg?: Complex | string | PolarCoordinates): Complex;
+        complex(arg?: MathArray | Matrix): MathArray | Matrix;
+        /**
+         * @param re Argument specifying the real part of the complex number
+         * @param im Argument specifying the imaginary part of the complex
+         * number
+         * @returns Returns a complex value
+         */
+        complex(re: number, im: number): Complex;
 
-		/**
-		 * Add two values, x + y. For matrices, the function is evaluated element wise.
-		 * @param x First value to add
-		 * @param y Second value to add
-		 * @returns Sum of x and y
-		 */
-		add(x: MathType, y: MathType): MathType;
+        /**
+         * Create a user-defined unit and register it with the Unit type.
+         * @param name The name of the new unit. Must be unique. Example: ‘knot’
+         * @param definition Definition of the unit in terms of existing units.
+         * For example, ‘0.514444444 m / s’.
+         * @param options (optional) An object containing any of the following
+         * properties:</br>- prefixes {string} “none”, “short”, “long”,
+         * “binary_short”, or “binary_long”. The default is “none”.</br>-
+         * aliases {Array} Array of strings. Example: [‘knots’, ‘kt’,
+         * ‘kts’]</br>- offset {Numeric} An offset to apply when converting from
+         * the unit. For example, the offset for celsius is 273.15. Default is
+         * 0.
+         * @returns The new unit
+         */
+        createUnit(
+            name: string,
+            definition?: string | UnitDefinition,
+            options?: CreateUnitOptions
+        ): Unit;
+        /**
+         * Create a user-defined unit and register it with the Unit type.
+         * @param units Definition of the unit
+         * @param options (optional) An object containing any of the following
+         * properties:</br>- prefixes {string} “none”, “short”, “long”,
+         * “binary_short”, or “binary_long”. The default is “none”.</br>-
+         * aliases {Array} Array of strings. Example: [‘knots’, ‘kt’,
+         * ‘kts’]</br>- offset {Numeric} An offset to apply when converting from
+         * the unit. For example, the offset for celsius is 273.15. Default is
+         * 0.
+         * @returns The new unit
+         */
+        createUnit(
+            units: Record<string, string | UnitDefinition>,
+            options?: CreateUnitOptions
+        ): Unit;
 
-		/**
-		 * Calculate the cubic root of a value. For matrices, the function is evaluated element wise.
-		 * @param x Value for which to calculate the cubic root.
-		 * @param allRoots Optional, false by default. Only applicable when x is a number or complex number. If true, all complex roots are returned, if false (default) the principal root is returned.
-		 * @returns Returns the cubic root of x
-		 */
-		cbrt(x: number, allRoots?: boolean): number;
-		cbrt(x: BigNumber, allRoots?: boolean): BigNumber;
-		cbrt(x: Fraction, allRoots?: boolean): Fraction;
-		cbrt(x: Complex, allRoots?: boolean): Complex;
-		cbrt(x: MathArray, allRoots?: boolean): MathArray;
-		cbrt(x: Matrix, allRoots?: boolean): Matrix;
-		cbrt(x: Unit, allRoots?: boolean): Unit;
+        /**
+         * Create a fraction convert a value to a fraction.
+         * @param args Arguments specifying the numerator and denominator of the
+         * fraction
+         * @returns Returns a fraction
+         */
+        fraction(
+            args: Fraction | MathArray | Matrix
+        ): Fraction | MathArray | Matrix;
+        /**
+         * @param numerator Argument specifying the numerator of the fraction
+         * @param denominator Argument specifying the denominator of the
+         * fraction
+         * @returns Returns a fraction
+         */
+        fraction(
+            numerator: number | string | MathArray | Matrix,
+            denominator?: number | string | MathArray | Matrix
+        ): Fraction | MathArray | Matrix;
 
-		/**
-		 * Round a value towards plus infinity If x is complex, both real and imaginary part are rounded towards plus infinity. For matrices, the function is evaluated element wise.
-		 * @param x Number to be rounded
-		 * @returns Rounded value
-		 */
-		ceil(x: number): number;
-		ceil(x: BigNumber): BigNumber;
-		ceil(x: Fraction): Fraction;
-		ceil(x: Complex): Complex;
-		ceil(x: MathArray): MathArray;
-		ceil(x: Matrix): Matrix;
-		ceil(x: Unit): Unit;
+        /**
+         * Create an index. An Index can store ranges having start, step, and
+         * end for multiple dimensions. Matrix.get, Matrix.set, and math.subset
+         * accept an Index as input.
+         * @param ranges Zero or more ranges or numbers.
+         * @returns Returns the created index
+         */
+        index(...ranges: any[]): Index;
 
-		/**
-		 * Compute the cube of a value, x * x * x. For matrices, the function is evaluated element wise.
-		 * @param x Number for which to calculate the cube
-		 * @returns Cube of x
-		 */
-		cube(x: number): number;
-		cube(x: BigNumber): BigNumber;
-		cube(x: Fraction): Fraction;
-		cube(x: Complex): Complex;
-		cube(x: MathArray): MathArray;
-		cube(x: Matrix): Matrix;
-		cube(x: Unit): Unit;
+        /**
+         * Create a Matrix. The function creates a new math.type.Matrix object
+         * from an Array. A Matrix has utility functions to manipulate the data
+         * in the matrix, like getting the size and getting or setting values in
+         * the matrix. Supported storage formats are 'dense' and 'sparse'.
+         * @param format The Matrix storage format
+         * @returns The created Matrix
+         */
+        matrix(format?: "sparse" | "dense"): Matrix;
+        /**
+         * @param data A multi dimensional array
+         * @param format The Matrix storage format
+         * @param dataType The Matrix data type
+         * @returns The created Matrix
+         */
+        matrix(
+            data: MathArray | Matrix,
+            format?: "sparse" | "dense",
+            dataType?: string
+        ): Matrix;
 
-		/**
-		 * Divide two values, x / y. To divide matrices, x is multiplied with the inverse of y: x * inv(y).
-		 * @param x Numerator
-		 * @param y Denominator
-		 * @returns Quotient, x / y
-		 */
-		divide(x: Unit, y: Unit): Unit;
-		divide(x: number, y: number): number;
-		divide(x: MathType, y: MathType): MathType;
+        /**
+         * Create a number or convert a string, boolean, or unit to a number.
+         * When value is a matrix, all elements will be converted to number.
+         * @param value Value to be converted
+         * @returns The created number
+         */
+        number(
+            value?:
+                | string
+                | number
+                | BigNumber
+                | Fraction
+                | boolean
+                | MathArray
+                | Matrix
+                | Unit
+                | null
+        ): number | MathArray | Matrix;
+        /**
+         * @param value Value to be converted
+         * @param valuelessUnit A valueless unit, used to convert a unit to a
+         * number
+         * @returns The created number
+         */
+        number(unit: Unit, valuelessUnit: Unit | string): number;
 
-		/**
-		 * Divide two matrices element wise. The function accepts both matrices and scalar values.
-		 * @param x Numerator
-		 * @param y Denominator
-		 * @returns Quotient, x ./ y
-		 */
-		dotDivide(x: MathType, y: MathType): MathType;
+        /**
+         * Create a Sparse Matrix. The function creates a new math.type.Matrix
+         * object from an Array. A Matrix has utility functions to manipulate
+         * the data in the matrix, like getting the size and getting or setting
+         * values in the matrix.
+         * @param data A two dimensional array
+         * @param dataType Sparse Matrix data type
+         * @returns The created matrix
+         */
+        sparse(data?: MathArray | Matrix, dataType?: string): Matrix;
 
-		/**
-		 * Multiply two matrices element wise. The function accepts both matrices and scalar values.
-		 * @param x Left hand value
-		 * @param y Right hand value
-		 * @returns Multiplication of x and y
-		 */
-		dotMultiply(x: MathType, y: MathType): MathType;
+        /**
+         * Split a unit in an array of units whose sum is equal to the original
+         * unit.
+         * @param unit A unit to be split
+         * @param parts An array of strings or valueless units
+         * @returns An array of units
+         */
+        splitUnit(unit: Unit, parts: Unit[]): Unit[];
 
-		/**
-		 * Calculates the power of x to y element wise.
-		 * @param x The base
-		 * @param y The exponent
-		 * @returns The value of x to the power y
-		 */
-		dotPow(x: MathType, y: MathType): MathType;
+        /**
+         * Create a string or convert any object into a string. Elements of
+         * Arrays and Matrices are processed element wise.
+         * @param value A value to convert to a string
+         * @returns The created string
+         */
+        string(
+            value: any | MathArray | Matrix | null
+        ): string | MathArray | Matrix;
 
-		/**
-		 * Calculate the exponent of a value. For matrices, the function is evaluated element wise.
-		 * @param x A number or matrix to exponentiate
-		 * #returns Exponent of x
-		 */
-		exp(x: number): number;
-		exp(x: BigNumber): BigNumber ;
-		exp(x: Complex): Complex ;
-		exp(x: MathArray): MathArray ;
-		exp(x: Matrix): Matrix;
+        /**
+         * Create a unit. Depending on the passed arguments, the function will
+         * create and return a new math.type.Unit object. When a matrix is
+         * provided, all elements will be converted to units.
+         * @param unit The unit to be created
+         * @returns The created unit
+         */
+        unit(unit: string): Unit;
+        /**
+         * @param value The value of the unit to be created
+         * @param unit The unit to be created
+         * @returns The created unit
+         */
+        unit(value: number | MathArray | Matrix, unit: string): Unit;
 
-		/**
-		 * Round a value towards zero. For matrices, the function is evaluated element wise.
-		 * @param x Number to be rounded
-		 * @returns Rounded value
-		 */
-		fix(x: number): number;
-		fix(x: BigNumber): BigNumber ;
-		fix(x: Fraction): Fraction ;
-		fix(x: Complex): Complex ;
-		fix(x: MathArray): MathArray ;
-		fix(x: Matrix): Matrix;
+        /*************************************************************************
+         * Expression functions
+         ************************************************************************/
 
-		/**
-		 * Round a value towards minus infinity. For matrices, the function is evaluated element wise.
-		 * @param Number to be rounded
-		 * @returns Rounded value
-		 */
-		floor(x: number): number;
-		floor(x: BigNumber): BigNumber ;
-		floor(x: Fraction): Fraction ;
-		floor(x: Complex): Complex ;
-		floor(x: MathArray): MathArray ;
-		floor(x: Matrix): Matrix;
+        /**
+         * Parse and compile an expression. Returns a an object with a function
+         * eval([scope]) to evaluate the compiled expression.
+         * @param expr The expression to be compiled
+         * @returns An object with the compiled expression
+         */
+        compile(expr: MathExpression): EvalFunction;
+        /**
+         * @param exprs The expressions to be compiled
+         * @returns An array of objects with the compiled expressions
+         */
+        compile(exprs: MathExpression[]): EvalFunction[];
 
-		/**
-		 * Calculate the greatest common divisor for two or more values or arrays. For matrices, the function is evaluated element wise.
-		 */
-		gcd(...args: number[]): number;
-		gcd(...args: BigNumber[]): BigNumber ;
-		gcd(...args: Fraction[]): Fraction ;
-		gcd(...args: MathArray[]): MathArray ;
-		gcd(...args: Matrix[]): Matrix;
+        /**
+         * Evaluate an expression.
+         * @param expr The expression to be evaluated
+         * @param scope Scope to read/write variables
+         * @returns The result of the expression
+         */
+        eval(
+            expr: MathExpression | MathExpression[] | Matrix,
+            scope?: object
+        ): any;
 
-		/**
-		 * Calculate the hypotenusa of a list with values. The hypotenusa is defined as:
-		 * hypot(a, b, c, ...) = sqrt(a^2 + b^2 + c^2 + ...)
-		 * For matrix input, the hypotenusa is calculated for all values in the matrix.
-		 */
-		hypot(...args: number[]): number;
-		hypot(...args: BigNumber[]): BigNumber;
+        /**
+         * Retrieve help on a function or data type. Help files are retrieved
+         * from the documentation in math.expression.docs.
+         * @param search A function or function name for which to get help
+         * @returns A help object
+         */
+        help(search: Function | string | object): Help;
+
+        /**
+         * Parse an expression. Returns a node tree, which can be evaluated by
+         * invoking node.eval();
+         * @param expr Expression to be parsed
+         * @param options Available options: nodes - a set of custome nodes
+         * @returns A node
+         */
+        parse(expr: MathExpression, options?: any): MathNode;
+        /**
+         * @param exprs Expressions to be parsed
+         * @param options Available options: nodes - a set of custome nodes
+         * @returns An arry of nodes
+         */
+        parse(exprs: MathExpression[], options?: any): MathNode[];
+
+        /**
+         * Create a parser. The function creates a new math.expression.Parser
+         * object.
+         * @returns A Parser object
+         */
+        parser(): Parser;
+
+        /*************************************************************************
+         * Algebra functions
+         ************************************************************************/
+        /**
+         * @param expr The expression to differentiate
+         * @param variable The variable over which to differentiate
+         * @param options There is one option available, simplify, which is true
+         * by default. When false, output will not be simplified.
+         * @returns The derivative of expr
+         */
+        derivative(
+            expr: MathNode | string,
+            variable: MathNode | string,
+            options?: object
+        ): MathNode;
+
+        /**
+         * Solves the linear equation system by forwards substitution. Matrix
+         * must be a lower triangular matrix.
+         * @param L A N x N matrix or array (L)
+         * @param b A column vector with the b values
+         * @returns A column vector with the linear system solution (x)
+         */
+        lsolve(
+            L: Matrix | MathArray,
+            b: Matrix | MathArray
+        ): Matrix | MathArray;
+
+        /**
+         * Calculate the Matrix LU decomposition with partial pivoting. Matrix A
+         * is decomposed in two matrices (L, U) and a row permutation vector p
+         * where A[p,:] = L * U
+         * @param A A two dimensional matrix or array for which to get the LUP
+         * decomposition.
+         * @returns The lower triangular matrix, the upper triangular matrix and
+         * the permutation matrix.
+         */
+        lup(
+            A?: Matrix | MathArray
+        ): { L: MathArray | Matrix; U: MathArray | Matrix; P: number[] };
+
+        /**
+         * Solves the linear system A * x = b where A is an [n x n] matrix and b
+         * is a [n] column vector.
+         * @param A Invertible Matrix or the Matrix LU decomposition
+         * @param b Column Vector
+         * @param order The Symbolic Ordering and Analysis order, see slu for
+         * details. Matrix must be a SparseMatrix
+         * @param threshold Partial pivoting threshold (1 for partial pivoting),
+         * see slu for details. Matrix must be a SparseMatrix.
+         * @returns Column vector with the solution to the linear system A * x =
+         * b
+         */
+        lusolve(
+            A: Matrix | MathArray | number,
+            b: Matrix | MathArray,
+            order?: number,
+            threshold?: number
+        ): Matrix | MathArray;
+
+        /**
+         * Calculate the Matrix QR decomposition. Matrix A is decomposed in two
+         * matrices (Q, R) where Q is an orthogonal matrix and R is an upper
+         * triangular matrix.
+         * @param A A two dimensional matrix or array for which to get the QR
+         * decomposition.
+         * @returns Q: the orthogonal matrix and R: the upper triangular matrix
+         */
+        qr(
+            A: Matrix | MathArray
+        ): { Q: MathArray | Matrix; R: MathArray | Matrix };
+
+        /**
+         * Transform a rationalizable expression in a rational fraction. If
+         * rational fraction is one variable polynomial then converts the
+         * numerator and denominator in canonical form, with decreasing
+         * exponents, returning the coefficients of numerator.
+         * @param expr The expression to check if is a polynomial expression
+         * @param optional scope of expression or true for already evaluated
+         * rational expression at input
+         * @param detailed  optional True if return an object, false if return
+         * expression node (default)
+         * @returns The rational polynomial of expr
+         */
+        rationalize(
+            expr: MathNode | string,
+            optional: object | boolean,
+            detailed: boolean
+        ): object | MathNode;
+
+        /**
+         * Simplify an expression tree.
+         * @param expr The expression to be simplified
+         * @param rules A list of rules are applied to an expression, repeating
+         * over the list until no further changes are made. It’s possible to
+         * pass a custom set of rules to the function as second argument. A rule
+         * can be specified as an object, string, or function.
+         * @param scope Scope to variables
+         * @returns Returns the simplified form of expr
+         */
+        simplify(
+            expr: MathNode | string,
+            rules?: ({ l: string; r: string } | string | ((node: MathNode) => MathNode))[],
+            scope?: object
+        ): MathNode;
+
+        /**
+         * Calculate the Sparse Matrix LU decomposition with full pivoting.
+         * Sparse Matrix A is decomposed in two matrices (L, U) and two
+         * permutation vectors (pinv, q) where P * A * Q = L * U
+         * @param A A two dimensional sparse matrix for which to get the LU
+         * decomposition.
+         * @param order The Symbolic Ordering and Analysis order: 0 - Natural
+         * ordering, no permutation vector q is returned 1 - Matrix must be
+         * square, symbolic ordering and analisis is performed on M = A + A' 2 -
+         * Symbolic ordering and analysis is performed on M = A' * A. Dense
+         * columns from A' are dropped, A recreated from A'. This is appropriate
+         * for LU factorization of non-symmetric matrices. 3 - Symbolic ordering
+         * and analysis is performed on M = A' * A. This is best used for LU
+         * factorization is matrix M has no dense rows. A dense row is a row
+         * with more than 10*sqr(columns) entries.
+         * @param threshold Partial pivoting threshold (1 for partial pivoting)
+         * @returns The lower triangular matrix, the upper triangular matrix and
+         * the permutation vectors.
+         */
+        slu(A: Matrix, order: number, threshold: number): object;
+
+        /**
+         * Solves the linear equation system by backward substitution. Matrix
+         * must be an upper triangular matrix. U * x = b
+         * @param U A N x N matrix or array (U)
+         * @param b A column vector with the b values
+         * @returns A column vector with the linear system solution (x)
+         */
+        usolve(
+            U: Matrix | MathArray,
+            b: Matrix | MathArray
+        ): Matrix | MathArray;
+
+        /*************************************************************************
+         * Arithmetic functions
+         ************************************************************************/
+
+        /**
+         * Calculate the absolute value of a number. For matrices, the function
+         * is evaluated element wise.
+         * @param x A number or matrix for which to get the absolute value
+         * @returns Absolute value of x
+         */
+        abs(x: number): number;
+        abs(x: BigNumber): BigNumber;
+        abs(x: Fraction): Fraction;
+        abs(x: Complex): Complex;
+        abs(x: MathArray): MathArray;
+        abs(x: Matrix): Matrix;
+        abs(x: Unit): Unit;
+
+        /**
+         * Add two values, x + y. For matrices, the function is evaluated
+         * element wise.
+         * @param x First value to add
+         * @param y Second value to add
+         * @returns Sum of x and y
+         */
+        add(x: MathType, y: MathType): MathType;
+
+        /**
+         * Calculate the cubic root of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Value for which to calculate the cubic root.
+         * @param allRoots Optional, false by default. Only applicable when x is
+         * a number or complex number. If true, all complex roots are returned,
+         * if false (default) the principal root is returned.
+         * @returns Returns the cubic root of x
+         */
+        cbrt(x: number, allRoots?: boolean): number;
+        cbrt(x: BigNumber, allRoots?: boolean): BigNumber;
+        cbrt(x: Fraction, allRoots?: boolean): Fraction;
+        cbrt(x: Complex, allRoots?: boolean): Complex;
+        cbrt(x: MathArray, allRoots?: boolean): MathArray;
+        cbrt(x: Matrix, allRoots?: boolean): Matrix;
+        cbrt(x: Unit, allRoots?: boolean): Unit;
+
+        /**
+         * Round a value towards plus infinity If x is complex, both real and
+         * imaginary part are rounded towards plus infinity. For matrices, the
+         * function is evaluated element wise.
+         * @param x Number to be rounded
+         * @returns Rounded value
+         */
+        ceil(x: number): number;
+        ceil(x: BigNumber): BigNumber;
+        ceil(x: Fraction): Fraction;
+        ceil(x: Complex): Complex;
+        ceil(x: MathArray): MathArray;
+        ceil(x: Matrix): Matrix;
+        ceil(x: Unit): Unit;
+
+        /**
+         * Compute the cube of a value, x * x * x. For matrices, the function is
+         * evaluated element wise.
+         * @param x Number for which to calculate the cube
+         * @returns Cube of x
+         */
+        cube(x: number): number;
+        cube(x: BigNumber): BigNumber;
+        cube(x: Fraction): Fraction;
+        cube(x: Complex): Complex;
+        cube(x: MathArray): MathArray;
+        cube(x: Matrix): Matrix;
+        cube(x: Unit): Unit;
+
+        /**
+         * Divide two values, x / y. To divide matrices, x is multiplied with
+         * the inverse of y: x * inv(y).
+         * @param x Numerator
+         * @param y Denominator
+         * @returns Quotient, x / y
+         */
+        divide(x: Unit, y: Unit): Unit;
+        divide(x: number, y: number): number;
+        divide(x: MathType, y: MathType): MathType;
+
+        /**
+         * Divide two matrices element wise. The function accepts both matrices
+         * and scalar values.
+         * @param x Numerator
+         * @param y Denominator
+         * @returns Quotient, x ./ y
+         */
+        dotDivide(x: MathType, y: MathType): MathType;
+
+        /**
+         * Multiply two matrices element wise. The function accepts both
+         * matrices and scalar values.
+         * @param x Left hand value
+         * @param y Right hand value
+         * @returns Multiplication of x and y
+         */
+        dotMultiply(x: MathType, y: MathType): MathType;
+
+        /**
+         * Calculates the power of x to y element wise.
+         * @param x The base
+         * @param y The exponent
+         * @returns The value of x to the power y
+         */
+        dotPow(x: MathType, y: MathType): MathType;
+
+        /**
+         * Calculate the exponent of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x A number or matrix to exponentiate
+         * @returns Exponent of x
+         */
+        exp(x: number): number;
+        exp(x: BigNumber): BigNumber;
+        exp(x: Complex): Complex;
+        exp(x: MathArray): MathArray;
+        exp(x: Matrix): Matrix;
+
+        /**
+         * Calculate the value of subtracting 1 from the exponential value. For
+         * matrices, the function is evaluated element wise.
+         * @param x A number or matrix to apply expm1
+         * @returns Exponent of x
+         */
+        expm1(x: number): number;
+        expm1(x: BigNumber): BigNumber;
+        expm1(x: Complex): Complex;
+        expm1(x: MathArray): MathArray;
+        expm1(x: Matrix): Matrix;
+
+        /**
+         * Round a value towards zero. For matrices, the function is evaluated
+         * element wise.
+         * @param x Number to be rounded
+         * @returns Rounded value
+         */
+        fix(x: number): number;
+        fix(x: BigNumber): BigNumber;
+        fix(x: Fraction): Fraction;
+        fix(x: Complex): Complex;
+        fix(x: MathArray): MathArray;
+        fix(x: Matrix): Matrix;
+
+        /**
+         * Round a value towards minus infinity. For matrices, the function is
+         * evaluated element wise.
+         * @param Number to be rounded
+         * @returns Rounded value
+         */
+        floor(x: number): number;
+        floor(x: BigNumber): BigNumber;
+        floor(x: Fraction): Fraction;
+        floor(x: Complex): Complex;
+        floor(x: MathArray): MathArray;
+        floor(x: Matrix): Matrix;
+
+        /**
+         * Calculate the greatest common divisor for two or more values or
+         * arrays. For matrices, the function is evaluated element wise.
+         * @param args Two or more integer numbers
+         * @returns The greatest common divisor
+         */
+        gcd(...args: number[]): number;
+        gcd(...args: BigNumber[]): BigNumber;
+        gcd(...args: Fraction[]): Fraction;
+        gcd(...args: MathArray[]): MathArray;
+        gcd(...args: Matrix[]): Matrix;
+
+        /**
+         * Calculate the hypotenusa of a list with values. The hypotenusa is
+         * defined as: hypot(a, b, c, ...) = sqrt(a^2 + b^2 + c^2 + ...) For
+         * matrix input, the hypotenusa is calculated for all values in the
+         * matrix.
+         * @param args A list with numeric values or an Array or Matrix. Matrix
+         * and Array input is flattened and returns a single number for the
+         * whole matrix.
+         * @returns Returns the hypothenuse of the input values.
+         */
+        hypot(...args: number[]): number;
+        hypot(...args: BigNumber[]): BigNumber;
+
+        /**
+         * Calculate the least common multiple for two or more values or arrays.
+         * lcm is defined as: lcm(a, b) = abs(a * b) / gcd(a, b) For matrices,
+         * the function is evaluated element wise.
+         * @param a An integer number
+         * @param b An integer number
+         * @returns The least common multiple
+         */
+        lcm(a: number, b: number): number;
+        lcm(a: BigNumber, b: BigNumber): BigNumber;
+        lcm(a: MathArray, b: MathArray): MathArray;
+        lcm(a: Matrix, b: Matrix): Matrix;
+
+        /**
+         * Calculate the logarithm of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Value for which to calculate the logarithm.
+         * @param base Optional base for the logarithm. If not provided, the
+         * natural logarithm of x is calculated. Default value: e.
+         * @returns Returns the logarithm of x
+         */
+        log(
+            x: number | BigNumber | Complex | MathArray | Matrix,
+            base?: number | BigNumber | Complex
+        ): number | BigNumber | Complex | MathArray | Matrix;
+
+        /**
+         * Calculate the 10-base of a value. This is the same as calculating
+         * log(x, 10). For matrices, the function is evaluated element wise.
+         * @param x Value for which to calculate the logarithm.
+         * @returns Returns the 10-base logarithm of x
+         */
+        log10(x: number): number;
+        log10(x: BigNumber): BigNumber;
+        log10(x: Complex): Complex;
+        log10(x: MathArray): MathArray;
+        log10(x: Matrix): Matrix;
+
+        /**
+         * Calculate the logarithm of a value+1. For matrices, the function is
+         * evaluated element wise.
+         * @param x Value for which to calculate the logarithm.
+         * @returns Returns the logarithm of x+1
+         */
+        log1p(x: number, base?: number | BigNumber | Complex): number;
+        log1p(x: BigNumber, base?: number | BigNumber | Complex): BigNumber;
+        log1p(x: Complex, base?: number | BigNumber | Complex): Complex;
+        log1p(x: MathArray, base?: number | BigNumber | Complex): MathArray;
+        log1p(x: Matrix, base?: number | BigNumber | Complex): Matrix;
+
+        /**
+         * Calculate the 2-base of a value. This is the same as calculating
+         * log(x, 2). For matrices, the function is evaluated element wise.
+         * @param x Value for which to calculate the logarithm.
+         * @returns Returns the 2-base logarithm of x
+         */
+        log2(x: number): number;
+        log2(x: BigNumber): BigNumber;
+        log2(x: Complex): Complex;
+        log2(x: MathArray): MathArray;
+        log2(x: Matrix): Matrix;
+
+        /**
+         * Calculates the modulus, the remainder of an integer division. For
+         * matrices, the function is evaluated element wise. The modulus is
+         * defined as: x - y * floor(x / y)
+         * @see http://en.wikipedia.org/wiki/Modulo_operation.
+         * @param x Dividend
+         * @param y Divisor
+         * @returns Returns the remainder of x divided by y
+         */
+        mod(
+            x: number | BigNumber | Fraction | MathArray | Matrix,
+            y: number | BigNumber | Fraction | MathArray | Matrix
+        ): number | BigNumber | Fraction | MathArray | Matrix;
+
+        /**
+         * Multiply two values, x * y. The result is squeezed. For matrices, the
+         * matrix product is calculated.
+         * @param x The first value to multiply
+         * @param y The second value to multiply
+         * @returns Multiplication of x and y
+         */
+        multiply(x: Matrix | MathArray, y: MathType): Matrix | MathArray;
+        multiply(x: Unit, y: Unit): Unit;
+        multiply(x: number, y: number): number;
+        multiply(x: MathType, y: MathType): MathType;
+
+        /**
+         * Calculate the norm of a number, vector or matrix. The second
+         * parameter p is optional. If not provided, it defaults to 2.
+         * @param x Value for which to calculate the norm
+         * @param p Vector space. Supported numbers include Infinity and
+         * -Infinity. Supported strings are: 'inf', '-inf', and 'fro' (The
+         * Frobenius norm) Default value: 2.
+         * @returns the p-norm
+         */
+        norm(
+            x: number | BigNumber | Complex | MathArray | Matrix,
+            p?: number | BigNumber | string
+        ): number | BigNumber;
+
+        /**
+         * Calculate the nth root of a value. The principal nth root of a
+         * positive real number A, is the positive real solution of the equation
+         * x^root = A For matrices, the function is evaluated element wise.
+         * @param a Value for which to calculate the nth root
+         * @param root The root. Default value: 2.
+         * @return The nth root of a
+         */
+        nthRoot(
+            a: number | BigNumber | MathArray | Matrix | Complex,
+            root?: number | BigNumber
+        ): number | Complex | MathArray | Matrix;
+
+        /**
+         * Calculates the power of x to y, x ^ y. Matrix exponentiation is
+         * supported for square matrices x, and positive integer exponents y.
+         * @param x The base
+         * @param y The exponent
+         * @returns x to the power y
+         */
+        pow(x: MathType, y: number | BigNumber | Complex): MathType;
+
+        /**
+         * Round a value towards the nearest integer. For matrices, the function
+         * is evaluated element wise.
+         * @param x Number to be rounded
+         * @param n Number of decimals Default value: 0.
+         * @returns Rounded value of x
+         */
+        round(
+            x: number | BigNumber | Fraction | Complex | MathArray | Matrix,
+            n?: number | BigNumber | MathArray
+        ): number | BigNumber | Fraction | Complex | MathArray | Matrix;
+
+        /**
+         * Compute the sign of a value. The sign of a value x is: 1 when x > 1
+         * -1 when x < 0 0 when x == 0 For matrices, the function is evaluated
+         * element wise.
+         * @param x The number for which to determine the sign
+         * @returns The sign of x
+         */
+        sign(x: number): number;
+        sign(x: BigNumber): BigNumber;
+        sign(x: Fraction): Fraction;
+        sign(x: Complex): Complex;
+        sign(x: MathArray): MathArray;
+        sign(x: Matrix): Matrix;
+        sign(x: Unit): Unit;
+
+        /**
+         * Calculate the square root of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Value for which to calculate the square root
+         * @returns Returns the square root of x
+         */
+        sqrt(x: number): number;
+        sqrt(x: BigNumber): BigNumber;
+        sqrt(x: Complex): Complex;
+        sqrt(x: MathArray): MathArray;
+        sqrt(x: Matrix): Matrix;
+        sqrt(x: Unit): Unit;
+
+        /**
+         * Compute the square of a value, x * x. For matrices, the function is
+         * evaluated element wise.
+         * @param x Number for which to calculate the square
+         * @returns Squared value
+         */
+        square(x: number): number;
+        square(x: BigNumber): BigNumber;
+        square(x: Fraction): Fraction;
+        square(x: Complex): Complex;
+        square(x: MathArray): MathArray;
+        square(x: Matrix): Matrix;
+        square(x: Unit): Unit;
+
+        /**
+         * Subtract two values, x - y. For matrices, the function is evaluated
+         * element wise.
+         * @param x Initial value
+         * @param y Value to subtract from x
+         * @returns Subtraction of x and y
+         */
+        subtract(x: MathType, y: MathType): MathType;
+
+        /**
+         * Inverse the sign of a value, apply a unary minus operation. For
+         * matrices, the function is evaluated element wise. Boolean values and
+         * strings will be converted to a number. For complex numbers, both real
+         * and complex value are inverted.
+         * @param x Number to be inverted
+         * @returns Retursn the value with inverted sign
+         */
+        unaryMinus(x: number): number;
+        unaryMinus(x: BigNumber): BigNumber;
+        unaryMinus(x: Fraction): Fraction;
+        unaryMinus(x: Complex): Complex;
+        unaryMinus(x: MathArray): MathArray;
+        unaryMinus(x: Matrix): Matrix;
+        unaryMinus(x: Unit): Unit;
+
+        /**
+         * Unary plus operation. Boolean values and strings will be converted to
+         * a number, numeric values will be returned as is. For matrices, the
+         * function is evaluated element wise.
+         * @param x Input value
+         * @returns Returns the input value when numeric, converts to a number
+         * when input is non-numeric.
+         */
+        unaryPlus(x: number): number;
+        unaryPlus(x: BigNumber): BigNumber;
+        unaryPlus(x: Fraction): Fraction;
+        unaryPlus(x: string): string;
+        unaryPlus(x: Complex): Complex;
+        unaryPlus(x: MathArray): MathArray;
+        unaryPlus(x: Matrix): Matrix;
+        unaryPlus(x: Unit): Unit;
+
+        /**
+         * Calculate the extended greatest common divisor for two values. See
+         * http://en.wikipedia.org/wiki/Extended_Euclidean_algorithm.
+         * @param a An integer number
+         * @param b An integer number
+         * @returns Returns an array containing 3 integers [div, m, n] where div
+         * = gcd(a, b) and a*m + b*n = div
+         */
+        xgcd(a: number | BigNumber, b: number | BigNumber): MathArray;
+
+        /*************************************************************************
+         * Bitwise functions
+         ************************************************************************/
+
+        /**
+         * Bitwise AND two values, x & y. For matrices, the function is
+         * evaluated element wise.
+         * @param x First value to and
+         * @param y Second value to and
+         * @returns AND of x and y
+         */
+        bitAnd(
+            x: number | BigNumber | MathArray | Matrix,
+            y: number | BigNumber | MathArray | Matrix
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Bitwise NOT value, ~x. For matrices, the function is evaluated
+         * element wise. For units, the function is evaluated on the best prefix
+         * base.
+         * @param x Value to not
+         * @returns NOT of x
+         */
+        bitNot(x: number): number;
+        bitNot(x: BigNumber): BigNumber;
+        bitNot(x: MathArray): MathArray;
+        bitNot(x: Matrix): Matrix;
+
+        /**
+         * Bitwise OR two values, x | y. For matrices, the function is evaluated
+         * element wise. For units, the function is evaluated on the lowest
+         * print base.
+         * @param x First value to or
+         * @param y Second value to or
+         * @returns OR of x and y
+         */
+        bitOr(x: number, y: number): number;
+        bitOr(x: BigNumber, y: BigNumber): BigNumber;
+        bitOr(x: MathArray, y: MathArray): MathArray;
+        bitOr(x: Matrix, y: Matrix): Matrix;
+
+        /**
+         * Bitwise XOR two values, x ^ y. For matrices, the function is
+         * evaluated element wise.
+         * @param x First value to xor
+         * @param y Second value to xor
+         * @returns XOR of x and y
+         */
+        bitXor(
+            x: number | BigNumber | MathArray | Matrix,
+            y: number | BigNumber | MathArray | Matrix
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Bitwise left logical shift of a value x by y number of bits, x << y.
+         * For matrices, the function is evaluated element wise. For units, the
+         * function is evaluated on the best prefix base.
+         * @param x Value to be shifted
+         * @param y Amount of shifts
+         * @returns x shifted left y times
+         */
+        leftShift(
+            x: number | BigNumber | MathArray | Matrix,
+            y: number | BigNumber
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Bitwise right arithmetic shift of a value x by y number of bits, x >>
+         * y. For matrices, the function is evaluated element wise. For units,
+         * the function is evaluated on the best prefix base.
+         * @param x Value to be shifted
+         * @param y Amount of shifts
+         * @returns x sign-filled shifted right y times
+         */
+        rightArithShift(
+            x: number | BigNumber | MathArray | Matrix,
+            y: number | BigNumber
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Bitwise right logical shift of value x by y number of bits, x >>> y.
+         * For matrices, the function is evaluated element wise. For units, the
+         * function is evaluated on the best prefix base.
+         * @param x Value to be shifted
+         * @param y Amount of shifts
+         * @returns x zero-filled shifted right y times
+         */
+        rightLogShift(
+            x: number | MathArray | Matrix,
+            y: number
+        ): number | MathArray | Matrix;
+
+        /*************************************************************************
+         * Combinatorics functions
+         ************************************************************************/
+
+        /**
+         * The Bell Numbers count the number of partitions of a set. A partition
+         * is a pairwise disjoint subset of S whose union is S. bellNumbers only
+         * takes integer arguments. The following condition must be enforced: n
+         * >= 0
+         * @param n Total number of objects in the set
+         * @returns B(n)
+         */
+        bellNumbers(n: number): number;
+        bellNumbers(n: BigNumber): BigNumber;
+
+        /**
+         * The Catalan Numbers enumerate combinatorial structures of many
+         * different types. catalan only takes integer arguments. The following
+         * condition must be enforced: n >= 0
+         * @param n nth Catalan number
+         * @returns Cn(n)
+         */
+        catalan(n: number): number;
+        catalan(n: BigNumber): BigNumber;
+
+        /**
+         * The composition counts of n into k parts. Composition only takes
+         * integer arguments. The following condition must be enforced: k <= n.
+         * @param n Total number of objects in the set
+         * @param k Number of objects in the subset
+         * @returns Returns the composition counts of n into k parts.
+         */
+        composition(
+            n: number | BigNumber,
+            k: number | BigNumber
+        ): number | BigNumber;
+
+        /**
+         * The Stirling numbers of the second kind, counts the number of ways to
+         * partition a set of n labelled objects into k nonempty unlabelled
+         * subsets. stirlingS2 only takes integer arguments. The following
+         * condition must be enforced: k <= n. If n = k or k = 1, then s(n,k) =
+         * 1
+         * @param n Total number of objects in the set
+         * @param k Number of objects in the subset
+         * @returns S(n,k)
+         */
+        stirlingS2(
+            n: number | BigNumber,
+            k: number | BigNumber
+        ): number | BigNumber;
+
+        /*************************************************************************
+         * Complex functions
+         ************************************************************************/
+
+        /**
+         * Compute the argument of a complex value. For a complex number a + bi,
+         * the argument is computed as atan2(b, a). For matrices, the function
+         * is evaluated element wise.
+         * @param x A complex number or array with complex numbers
+         * @returns The argument of x
+         */
+        arg(x: number | Complex): number;
+        arg(x: BigNumber | Complex): BigNumber;
+        arg(x: MathArray): MathArray;
+        arg(x: Matrix): Matrix;
+
+        /**
+         * Compute the complex conjugate of a complex value. If x = a+bi, the
+         * complex conjugate of x is a - bi. For matrices, the function is
+         * evaluated element wise.
+         * @param x A complex number or array with complex numbers
+         * @returns The complex conjugate of x
+         */
+        conj(
+            x: number | BigNumber | Complex | MathArray | Matrix
+        ): number | BigNumber | Complex | MathArray | Matrix;
+
+        /**
+         * Get the imaginary part of a complex number. For a complex number a +
+         * bi, the function returns b. For matrices, the function is evaluated
+         * element wise.
+         * @param x A complex number or array with complex numbers
+         * @returns The imaginary part of x
+         */
+        im(
+            x: number | BigNumber | Complex | MathArray | Matrix
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Get the real part of a complex number. For a complex number a + bi,
+         * the function returns a. For matrices, the function is evaluated
+         * element wise.
+         * @param x A complex number or array of complex numbers
+         * @returns The real part of x
+         */
+        re(
+            x: number | BigNumber | Complex | MathArray | Matrix
+        ): number | BigNumber | MathArray | Matrix;
+
+        /*************************************************************************
+         * Geometry functions
+         ************************************************************************/
+
+        /**
+         * Calculates: The eucledian distance between two points in 2 and 3
+         * dimensional spaces. Distance between point and a line in 2 and 3
+         * dimensional spaces. Pairwise distance between a set of 2D or 3D
+         * points NOTE: When substituting coefficients of a line(a, b and c),
+         * use ax + by + c = 0 instead of ax + by = c For parametric equation of
+         * a 3D line, x0, y0, z0, a, b, c are from: (x−x0, y−y0, z−z0) = t(a, b,
+         * c)
+         * @param x Coordinates of the first point
+         * @param y Coordinates of the second point
+         * @returns Returns the distance from two/three points
+         */
+        distance(
+            x: MathArray | Matrix | Object,
+            y: MathArray | Matrix | Object
+        ): number | BigNumber;
+
+        /**
+         * Calculates the point of intersection of two lines in two or three
+         * dimensions and of a line and a plane in three dimensions. The inputs
+         * are in the form of arrays or 1 dimensional matrices. The line
+         * intersection functions return null if the lines do not meet. Note:
+         * Fill the plane coefficients as x + y + z = c and not as x + y + z + c
+         * = 0.
+         * @param w Co-ordinates of first end-point of first line
+         * @param x Co-ordinates of second end-point of first line
+         * @param y Co-ordinates of first end-point of second line OR
+         * Coefficients of the plane's equation
+         * @param z Co-ordinates of second end-point of second line OR null if
+         * the calculation is for line and plane
+         * @returns Returns the point of intersection of lines/lines-planes
+         */
+        intersect(
+            w: MathArray | Matrix,
+            x: MathArray | Matrix,
+            y: MathArray | Matrix,
+            z: MathArray | Matrix
+        ): MathArray;
+
+        /*************************************************************************
+         * Logical functions
+         ************************************************************************/
+
+        /**
+         * Logical and. Test whether two values are both defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param x First value to and
+         * @param y Second value to and
+         * @returns Returns true when both inputs are defined with a
+         * nonzero/nonempty value.
+         */
+        and(
+            x: number | BigNumber | Complex | Unit | MathArray | Matrix,
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Logical not. Flips boolean value of a given parameter. For matrices,
+         * the function is evaluated element wise.
+         * @param x First value to not
+         * @returns Returns true when input is a zero or empty value.
+         */
+        not(
+            x: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Logical or. Test if at least one value is defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param x First value to or
+         * @param y Second value to or
+         * @returns Returns true when one of the inputs is defined with a
+         * nonzero/nonempty value.
+         */
+        or(
+            x: number | BigNumber | Complex | Unit | MathArray | Matrix,
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Logical xor. Test whether one and only one value is defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param x First value to xor
+         * @param y Second value to xor
+         * @returns Returns true when one and only one input is defined with a
+         * nonzero/nonempty value.
+         */
+        xor(
+            x: number | BigNumber | Complex | Unit | MathArray | Matrix,
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): boolean | MathArray | Matrix;
+
+        /*************************************************************************
+         * Matrix functions
+         ************************************************************************/
+
+        /**
+         * Concatenate two or more matrices. dim: number is a zero-based
+         * dimension over which to concatenate the matrices. By default the last
+         * dimension of the matrices.
+         * @param args Two or more matrices
+         * @returns Concatenated matrix
+         */
+        concat(...args: Array<MathArray | Matrix>): MathArray | Matrix;
+
+        /**
+         * Calculate the cross product for two vectors in three dimensional
+         * space. The cross product of A = [a1, a2, a3] and B =[b1, b2, b3] is
+         * defined as: cross(A, B) = [ a2 * b3 - a3 * b2, a3 * b1 - a1 * b3, a1
+         * * b2 - a2 * b1 ]
+         * @param x First vector
+         * @param y Second vector
+         * @returns Returns the cross product of x and y
+         */
+        cross(x: MathArray | Matrix, y: MathArray | Matrix): Matrix | MathArray;
+
+        /**
+         * Calculate the determinant of a matrix.
+         * @param x A Matrix
+         * @returns the determinant of x
+         */
+        det(x: MathArray | Matrix): number;
+
+        /**
+         * Create a diagonal matrix or retrieve the diagonal of a matrix. When x
+         * is a vector, a matrix with vector x on the diagonal will be returned.
+         * When x is a two dimensional matrix, the matrixes kth diagonal will be
+         * returned as vector. When k is positive, the values are placed on the
+         * super diagonal. When k is negative, the values are placed on the sub
+         * diagonal.
+         * @param X A two dimensional matrix or a vector
+         * @param k The diagonal where the vector will be filled in or
+         * retrieved. Default value: 0.
+         * @param format The matrix storage format. Default value: 'dense'.
+         * @returns Diagonal matrix from input vector, or diagonal from input
+         * matrix
+         */
+        diag(X: MathArray | Matrix, format?: string): Matrix;
+        diag(
+            X: MathArray | Matrix,
+            k: number | BigNumber,
+            format?: string
+        ): Matrix | MathArray;
+
+        /**
+         * Calculate the dot product of two vectors. The dot product of A = [a1,
+         * a2, a3, ..., an] and B = [b1, b2, b3, ..., bn] is defined as: dot(A,
+         * B) = a1 * b1 + a2 * b2 + a3 * b3 + ... + an * bn
+         * @param x First vector
+         * @param y Second vector
+         * @returns Returns the dot product of x and y
+         */
+        dot(x: MathArray | Matrix, y: MathArray | Matrix): number;
+
+        /**
+         * Compute the matrix exponential, expm(A) = e^A. The matrix must be
+         * square. Not to be confused with exp(a), which performs element-wise
+         * exponentiation. The exponential is calculated using the Padé
+         * approximant with scaling and squaring; see “Nineteen Dubious Ways to
+         * Compute the Exponential of a Matrix,” by Moler and Van Loan.
+         * @param x A square matrix
+         * @returns The exponential of x
+         */
+        expm(x: Matrix): Matrix;
+
+        /**
+         * Create a 2-dimensional identity matrix with size m x n or n x n. The
+         * matrix has ones on the diagonal and zeros elsewhere.
+         * @param size The size for the matrix
+         * @param format The Matrix storage format
+         * @returns A matrix with ones on the diagonal
+         */
+        eye(
+            size: number | number[] | Matrix | MathArray,
+            format?: string
+        ): Matrix | MathArray | number;
+        /**
+         * @param m The x dimension for the matrix
+         * @param n The y dimension for the matrix
+         * @param format The Matrix storage format
+         * @returns A matrix with ones on the diagonal
+         */
+        eye(m: number, n: number, format?: string): Matrix | MathArray | number;
+
+        /**
+         * Filter the items in an array or one dimensional matrix.
+         * @param x A one dimensional matrix or array to filter
+         * @param test A function or regular expression to test items. All
+         * entries for which test returns true are returned. When test is a
+         * function, it is invoked with three parameters: the value of the
+         * element, the index of the element, and the matrix/array being
+         * traversed. The function must return a boolean.
+         */
+        filter(
+            x: Matrix | MathArray,
+            test: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray) | RegExp
+        ): Matrix | MathArray;
+
+        /**
+         * Flatten a multi dimensional matrix into a single dimensional matrix.
+         * @param x Matrix to be flattened
+         * @returns Returns the flattened matrix
+         */
+        flatten(x: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Iterate over all elements of a matrix/array, and executes the given
+         * callback function.
+         * @param x The matrix to iterate on.
+         * @param callback The callback function is invoked with three
+         * parameters: the value of the element, the index of the element, and
+         * the Matrix/array being traversed.
+         */
+        forEach(x: Matrix | MathArray, callback: ((value:any, index: any, matrix: Matrix | MathArray)=>void)): void;
+
+        /**
+         * Calculate the inverse of a square matrix.
+         * @param x Matrix to be inversed
+         * @returns The inverse of x
+         */
+        inv(
+            x: number | Complex | MathArray | Matrix
+        ): number | Complex | MathArray | Matrix;
 
         /**
          * Calculate the kronecker product of two matrices or vectors
-         * @param x First Matrix
-         * @param y Second Matrix
+         * @param x First vector
+         * @param y Second vector
+         * @returns Returns the kronecker product of x and y
          */
-        kron(x: Matrix|MathArray, y: Matrix|MathArray): Matrix;
-
-		/**
-		 * Calculate the least common multiple for two or more values or arrays. lcm is defined as:
-		 * lcm(a, b) = abs(a * b) / gcd(a, b)
-		 * For matrices, the function is evaluated element wise.
-		 */
-		lcm(a: number, b: number): number;
-		lcm(a: BigNumber , b: BigNumber): BigNumber ;
-		lcm(a: MathArray, b: MathArray): MathArray;
-		lcm(a: Matrix, b: Matrix): Matrix;
-
-		/**
-		 * Calculate the logarithm of a value. For matrices, the function is evaluated element wise.
-		 * @param x Value for which to calculate the logarithm.
-		 * @param base Optional base for the logarithm. If not provided, the natural logarithm of x is calculated. Default value: e.
-		 */
-		log(x: number|BigNumber|Complex|MathArray|Matrix, base?: number|BigNumber|Complex): number|BigNumber|Complex|MathArray|Matrix;
-
-		/**
-		 * Calculate the 10-base of a value. This is the same as calculating log(x, 10). For matrices, the function is evaluated element wise.
-		 * @param x Value for which to calculate the logarithm.
-		 */
-		log10(x: number): number;
-		log10(x: BigNumber): BigNumber;
-		log10(x: Complex): Complex;
-		log10(x: MathArray): MathArray;
-		log10(x: Matrix): Matrix;
-
-		/**
-		 * Calculates the modulus, the remainder of an integer division. For matrices, the function is evaluated element wise.
-		 * The modulus is defined as:
-		 * x - y * floor(x / y)
-		 * @see http://en.wikipedia.org/wiki/Modulo_operation.
-		 * @param x Dividend
-		 * @param y Divisor
-		 */
-		mod(x: number|BigNumber|Fraction|MathArray|Matrix, y: number|BigNumber|Fraction|MathArray|Matrix): number|BigNumber|Fraction|MathArray|Matrix;
-
-		/**
-		 * Multiply two values, x * y. The result is squeezed. For matrices, the matrix product is calculated.
-		 */
-		multiply(x: MathArray|Matrix, y: MathType): Matrix;
-		multiply(x: Unit, y: Unit): Unit;
-		multiply(x: number, y: number): number;
-		multiply(x: MathType, y: MathType): MathType;
-
-		/**
-		 * Calculate the norm of a number, vector or matrix. The second parameter p is optional. If not provided, it defaults to 2.
-		 * @param x Value for which to calculate the norm
-		 * @param p Vector space. Supported numbers include Infinity and -Infinity. Supported strings are: 'inf', '-inf', and 'fro' (The Frobenius norm) Default value: 2.
-		 * @returns the p-norm
-		 */
-		norm(x: number|BigNumber|Complex|MathArray|Matrix, p?: number|BigNumber|string): number|BigNumber;
-
-		/**
-		 * Calculate the nth root of a value. The principal nth root of a positive real number A, is the positive real solution of the equation
-		 * x^root = A
-		 * For matrices, the function is evaluated element wise.
-		 * @param a Value for which to calculate the nth root
-		 * @param root The root. Default value: 2.
-		 */
-		nthRoot(a: number|BigNumber|MathArray|Matrix|Complex, root?: number|BigNumber): number|Complex|MathArray|Matrix;
-
-		/**
-		 * Calculates the power of x to y, x ^ y. Matrix exponentiation is supported for square matrices x, and positive integer exponents y.
-		 * @param x The base
-		 * @param y The exponent
-		 */
-		pow(x: MathType, y: number|BigNumber|Complex): MathType;
-
-		/**
-		 * Round a value towards the nearest integer. For matrices, the function is evaluated element wise.
-		 * @param x Number to be rounded
-		 * @param n Number of decimals Default value: 0.
-		 */
-		round(x: number|BigNumber|Fraction|Complex|MathArray|Matrix, n?: number|BigNumber|MathArray): number|BigNumber|Fraction|Complex|MathArray|Matrix;
-
-		/**
-		 * Compute the sign of a value. The sign of a value x is:
-		 * 1 when x > 1
-		 * -1 when x < 0
-		 * 0 when x == 0
-		 * For matrices, the function is evaluated element wise.
-		 */
-		sign(x: number): number;
-		sign(x: BigNumber): BigNumber;
-		sign(x: Fraction): Fraction ;
-		sign(x: Complex): Complex ;
-		sign(x: MathArray): MathArray;
-		sign(x: Matrix): Matrix;
-		sign(x: Unit): Unit;
-
-		/**
-		 * Calculate the square root of a value. For matrices, the function is evaluated element wise.
-		 */
-		sqrt(x: number): number;
-		sqrt(x: BigNumber): BigNumber;
-		sqrt(x: Complex): Complex ;
-		sqrt(x: MathArray): MathArray;
-		sqrt(x: Matrix): Matrix;
-		sqrt(x: Unit): Unit;
-
-		/**
-		 * Compute the square of a value, x * x. For matrices, the function is evaluated element wise.
-		 */
-		square(x: number): number;
-		square(x: BigNumber): BigNumber;
-		square(x: Fraction): Fraction ;
-		square(x: Complex): Complex ;
-		square(x: MathArray): MathArray;
-		square(x: Matrix): Matrix;
-		square(x: Unit): Unit;
-
-		/**
-		 * Subtract two values, x - y. For matrices, the function is evaluated element wise.
-		 */
-		subtract(x: MathType, y: MathType): MathType;
-
-		/**
-		 * Inverse the sign of a value, apply a unary minus operation.
-		 * For matrices, the function is evaluated element wise. Boolean values and strings will be converted to a number. For complex numbers, both real and complex value are inverted.
-		 */
-		unaryMinus(x: number): number;
-		unaryMinus(x: BigNumber): BigNumber;
-		unaryMinus(x: Fraction): Fraction ;
-		unaryMinus(x: Complex): Complex ;
-		unaryMinus(x: MathArray): MathArray;
-		unaryMinus(x: Matrix): Matrix;
-		unaryMinus(x: Unit): Unit;
-
-		/**
-		 * Unary plus operation. Boolean values and strings will be converted to a number, numeric values will be returned as is.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		unaryPlus(x: number): number;
-		unaryPlus(x: BigNumber): BigNumber;
-		unaryPlus(x: Fraction): Fraction ;
-		unaryPlus(x: string): string;
-		unaryPlus(x: Complex): Complex ;
-		unaryPlus(x: MathArray): MathArray;
-		unaryPlus(x: Matrix): Matrix;
-		unaryPlus(x: Unit): Unit;
-
-		/**
-		 * Calculate the extended greatest common divisor for two values. See http://en.wikipedia.org/wiki/Extended_Euclidean_algorithm.
-		 */
-		xgcd(a: number|BigNumber, b: number|BigNumber): MathArray;
-
-		/**
-		 * Bitwise AND two values, x & y. For matrices, the function is evaluated element wise.
-		 */
-		bitAnd(x: number|BigNumber|MathArray|Matrix, y: number|BigNumber|MathArray|Matrix): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Bitwise NOT value, ~x. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 */
-		bitNot(x: number): number;
-		bitNot(x: BigNumber): BigNumber ;
-		bitNot(x: MathArray): MathArray;
-		bitNot(x: Matrix): Matrix;
-
-		/**
-		 * Bitwise OR two values, x | y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the lowest print base.
-		 */
-		bitOr(x: number): number;
-		bitOr(x: BigNumber): BigNumber ;
-		bitOr(x: MathArray): MathArray;
-		bitOr(x: Matrix): Matrix;
-
-		/**
-		 * Bitwise XOR two values, x ^ y. For matrices, the function is evaluated element wise.
-		 */
-		bitXor(x: number|BigNumber|MathArray|Matrix, y: number|BigNumber|MathArray|Matrix): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Bitwise left logical shift of a value x by y number of bits, x << y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		leftShift(x: number|BigNumber|MathArray|Matrix, y: number|BigNumber): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Bitwise right arithmetic shift of a value x by y number of bits, x >> y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		rightArithShift(x: number|BigNumber|MathArray|Matrix, y: number|BigNumber): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Bitwise right logical shift of value x by y number of bits, x >>> y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		rightLogShift(x: number|MathArray|Matrix, y: number): number|MathArray|Matrix;
-
-		/**
-		 * The Bell Numbers count the number of partitions of a set.
-		 * A partition is a pairwise disjoint subset of S whose union is S. bellNumbers only takes integer arguments.
-		 * The following condition must be enforced: n >= 0
-		 * @param n Total number of objects in the set
-		 */
-		bellNumbers(n: number): number;
-		bellNumbers(n: BigNumber): BigNumber;
-
-		/**
-		 * The Catalan Numbers enumerate combinatorial structures of many different types. catalan only takes integer arguments. The following condition must be enforced: n >= 0
-		 * @param n nth Catalan number
-		 */
-		catalan(n: number): number;
-		catalan(n: BigNumber): BigNumber;
-
-		/**
-		 * The composition counts of n into k parts. Composition only takes integer arguments. The following condition must be enforced: k <= n.
-		 * @param n Total number of objects in the set
-		 * @param k Number of objects in the subset
-		 * @returns Returns the composition counts of n into k parts.
-		 */
-		composition(n: number|BigNumber, k: number|BigNumber): number|BigNumber;
-
-		/**
-		 * The Stirling numbers of the second kind, counts the number of ways to partition a set of n labelled objects into k nonempty unlabelled subsets.
-		 * stirlingS2 only takes integer arguments. The following condition must be enforced: k <= n.
-		 * If n = k or k = 1, then s(n,k) = 1
-		 * @param n Total number of objects in the set
-		 * @param k Number of objects in the subset
-		 */
-		stirlingS2(n: number|BigNumber, k: number|BigNumber): number|BigNumber;
-
-		/**
-		 * Compute the argument of a complex value. For a complex number a + bi, the argument is computed as atan2(b, a). For matrices, the function is evaluated element wise.
-		 * @param x A complex number or array with complex numbers
-		 */
-		arg(x: number|Complex): number;
-		arg(x: MathArray): MathArray;
-		arg(x: Matrix): Matrix;
-
-		/**
-		 * Compute the complex conjugate of a complex value. If x = a+bi, the complex conjugate of x is a - bi. For matrices, the function is evaluated element wise.
-		 * @param x A complex number or array with complex numbers
-		 */
-		conj(x: number|BigNumber|Complex|MathArray|Matrix): number|BigNumber|Complex|MathArray|Matrix;
-
-		/**
-		 * Get the imaginary part of a complex number. For a complex number a + bi, the function returns b.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		im(x: number|BigNumber|Complex|MathArray|Matrix): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Get the real part of a complex number. For a complex number a + bi, the function returns a.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		re(x: number|BigNumber|Complex|MathArray|Matrix): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Create a BigNumber, which can store numbers with arbitrary precision. When a matrix is provided, all elements will be converted to BigNumber.
-		 */
-		bignumber(x?: number|string|MathArray|Matrix|boolean): BigNumber;
-
-		/**
-		 * Create a boolean or convert a string or number to a boolean.
-		 * In case of a number, true is returned for non-zero numbers, and false in case of zero.
-		 * Strings can be 'true' or 'false', or can contain a number. When value is a matrix, all elements will be converted to boolean.
-		 */
-		boolean(x: string|number|boolean|MathArray|Matrix): boolean|MathArray|Matrix;
-
-		/**
-		 * Wrap any value in a chain, allowing to perform chained operations on the value.
-		 * All methods available in the math.js library can be called upon the chain, and then will be evaluated with the value itself as first argument.
-		 * The chain can be closed by executing chain.done(), which returns the final value.
-		 * The chain has a number of special functions:
-		 * done() Finalize the chain and return the chain's value.
-		 * valueOf() The same as done()
-		 * toString() Executes math.format() onto the chain's value, returning a string representation of the value.
-		 */
-		chain(value?: any): MathJsChain;
-
-		/**
-		 * Create a complex value or convert a value to a complex value.
-		 */
-		complex(arg?: Complex|string|MathArray| PolarCoordinates): Complex;
-		complex(re: number, im: number): Complex;
-
-		/**
-		 * Create a fraction convert a value to a fraction.
-		 */
-		fraction(numerator: number|string|MathArray|Matrix, denominator?: number|string|MathArray|Matrix): Fraction|MathArray|Matrix;
-
-		/**
-		 * Create an index. An Index can store ranges having start, step, and end for multiple dimensions. Matrix.get, Matrix.set, and math.subset accept an Index as input.
-		 */
-		index(...ranges: any[]): Index;
-
-		/**
-		 * Create a Matrix. The function creates a new math.type.Matrix object from an Array. A Matrix has utility functions
-		 * to manipulate the data in the matrix, like getting the size and getting or setting values in the matrix. Supported
-		 * storage formats are 'dense' and 'sparse'.
-		 */
-		matrix(format?: 'sparse'|'dense'): Matrix;
-		matrix(data: MathArray|Matrix, format?: 'sparse'|'dense', dataType?: string): Matrix;
-
-		/**
-		 * Create a number or convert a string, boolean, or unit to a number. When value is a matrix, all elements will be converted to number.
-		 */
-		number(value?: string|number|boolean|MathArray|Matrix|Unit|BigNumber): number|MathArray|Matrix;
-		number(unit: Unit, valuelessUnit: Unit|string): number|MathArray|Matrix;
-
-		/**
-		 * Create a Sparse Matrix. The function creates a new math.type.Matrix object from an Array. A Matrix has utility
-		 * functions to manipulate the data in the matrix, like getting the size and getting or setting values in the matrix.
-		 * @param data A two dimensional array
-		 */
-		sparse(data?: MathArray|Matrix, dataType?: string): Matrix;
-
-		/**
-		 * Create a string or convert any object into a string. Elements of Arrays and Matrices are processed element wise.
-		 * @param value A value to convert to a string
-		 */
-		string(value: any): string|MathArray|Matrix;
-
-		/**
-		 * Create a unit. Depending on the passed arguments, the function will create and return a new math.type.Unit object.
-		 * When a matrix is provided, all elements will be converted to units.
-		 */
-		unit(unit: string): Unit;
-		unit(value: number, unit: string): Unit;
-
-		/**
-		 * Create a user-defined unit and register it with the Unit type.
-		 */
-		createUnit(name: string, definition?: string|UnitDefinition, options?: CreateUnitOptions): Unit;
-		createUnit(units: Record<string, string|UnitDefinition>, options?: CreateUnitOptions): Unit;
-
-		/**
-		 * Parse and compile an expression. Returns a an object with a function eval([scope]) to evaluate the compiled expression.
-		 */
-		compile(expr: MathExpression): EvalFunction;
-		compile(exprs: MathExpression[]): EvalFunction[];
-
-		/**
-		 * Evaluate an expression.
-		 */
-		eval(expr: MathExpression|MathExpression[], scope?: any): any;
-
-		/**
-		 * Retrieve help on a function or data type. Help files are retrieved from the documentation in math.expression.docs.
-		 */
-		help(search: any): Help;
-
-		/**
-		 * Parse an expression. Returns a node tree, which can be evaluated by invoking node.eval();
-		 */
-		parse(expr: MathExpression, options?: any): MathNode;
-		parse(exprs: MathExpression[], options?: any): MathNode[];
-
-		/**
-		 * Create a parser. The function creates a new math.expression.Parser object.
-		 */
-		parser(): Parser;
-
-		/**
-		 * Calculates: The eucledian distance between two points in 2 and 3 dimensional spaces. Distance between point
-		 * and a line in 2 and 3 dimensional spaces. Pairwise distance between a set of 2D or 3D points NOTE: When
-		 * substituting coefficients of a line(a, b and c), use ax + by + c = 0 instead of ax + by = c For parametric
-		 * equation of a 3D line, x0, y0, z0, a, b, c are from: (x−x0, y−y0, z−z0) = t(a, b, c)
-		 */
-		distance(x: MathType, y: MathType): number | BigNumber;
-
-		/**
-		 * Calculates the point of intersection of two lines in two or three dimensions and of a line and a plane in
-		 * three dimensions. The inputs are in the form of arrays or 1 dimensional matrices. The line intersection functions
-		 * return null if the lines do not meet.
-		 * Note: Fill the plane coefficients as x + y + z = c and not as x + y + z + c = 0.
-		 * @param w Co-ordinates of first end-point of first line
-		 * @param x Co-ordinates of second end-point of first line
-		 * @param y Co-ordinates of first end-point of second line OR Coefficients of the plane's equation
-		 * @param z Co-ordinates of second end-point of second line OR null if the calculation is for line and plane
-		 * @returns Returns the point of intersection of lines/lines-planes
-		 */
-		intersect(w: MathArray|Matrix, x: MathArray|Matrix, y: MathArray|Matrix, z: MathArray|Matrix): MathArray;
-
-		/**
-		 * Logical and. Test whether two values are both defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		and(x: number|BigNumber|Complex|Unit|MathArray|Matrix, y: number|BigNumber|Complex|Unit|MathArray|Matrix): boolean|MathArray|Matrix;
-
-		/**
-		 * Logical not. Flips boolean value of a given parameter. For matrices, the function is evaluated element wise.
-		 */
-		not(x: number|BigNumber|Complex|Unit|MathArray|Matrix): boolean|MathArray|Matrix;
-
-		/**
-		 * Logical or. Test if at least one value is defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		or(x: number|BigNumber|Complex|Unit|MathArray|Matrix, y: number|BigNumber|Complex|Unit|MathArray|Matrix): boolean|MathArray|Matrix;
-
-		/**
-		 * Logical xor. Test whether one and only one value is defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		xor(x: number|BigNumber|Complex|Unit|MathArray|Matrix, y: number|BigNumber|Complex|Unit|MathArray|Matrix): boolean|MathArray|Matrix;
-
-		/**
-		 * Concatenate two or more matrices.
-		 * dim: number is a zero-based dimension over which to concatenate the matrices. By default the last dimension of the matrices.
-		 */
-		concat(...args: Array<MathArray|Matrix|number>): MathArray|Matrix;
-
-		/**
-		 * Calculate the cross product for two vectors in three dimensional space. The cross product of A = [a1, a2, a3]
-		 * and B =[b1, b2, b3] is defined as:
-		 * cross(A, B) = [ a2 * b3 - a3 * b2, a3 * b1 - a1 * b3, a1 * b2 - a2 * b1 ]
-		 */
-		cross(x: MathArray|Matrix, y: MathArray|Matrix): Matrix;
-
-		/**
-		 * Calculate the determinant of a matrix.
-		 */
-		det(x: MathArray|Matrix): number;
-
-		/**
-		 * Create a diagonal matrix or retrieve the diagonal of a matrix.
-		 * When x is a vector, a matrix with vector x on the diagonal will be returned. When x is a two dimensional matrix,
-		 * the matrixes kth diagonal will be returned
-		 * as vector. When k is positive, the values are placed on the super diagonal. When k is negative, the values are
-		 * placed on the sub diagonal.
-		 * @param X A two dimensional matrix or a vector
-		 * @param k The diagonal where the vector will be filled in or retrieved. Default value: 0.
-		 * @param format The matrix storage format. Default value: 'dense'.
-		 */
-		diag(X: MathArray|Matrix, format?: string): Matrix;
-		diag(X: MathArray|Matrix, k: number|BigNumber, format?: string): Matrix;
-
-		/**
-		 * Calculate the dot product of two vectors.
-		 * The dot product of A = [a1, a2, a3, ..., an] and B = [b1, b2, b3, ..., bn]
-		 * is defined as:
-		 * dot(A, B) = a1 * b1 + a2 * b2 + a3 * b3 + ... + an * bn
-		 */
-		dot(x: MathArray|Matrix, y: MathArray|Matrix): number;
-
-		/**
-		 * Create a 2-dimensional identity matrix with size m x n or n x n. The matrix has ones on the diagonal and zeros elsewhere.
-		 */
-		eye(n: number|number[], format?: string): Matrix;
-		eye(m: number, n: number, format?: string): Matrix;
-
-		/**
-		 * Flatten a multi dimensional matrix into a single dimensional matrix.
-		 */
-        flatten(x: MathArray|Matrix): MathArray|Matrix;
-
-		/**
-		 * Calculate the inverse of a square matrix.
-		 */
-		inv(x: number|Complex|MathArray|Matrix): number|Complex|MathArray|Matrix;
-
-		/**
-		 * Create a matrix filled with ones. The created matrix can have one or multiple dimensions.
-		 */
-		ones(n: number|number[], format?: string): MathArray|Matrix;
-		ones(m: number, n: number, format?: string): MathArray|Matrix;
-
-		/**
-		 * Create an array from a range. By default, the range end is excluded. This can be customized by providing an extra parameter includeEnd.
-		 * @param str A string 'start:end' or 'start:step:end'
-		 * @param start Start of the range
-		 * @param end End of the range, excluded by default, included when parameter includeEnd=true
-		 * @param step Step size. Default value is 1.
-		 * @returns Parameters describing the ranges start, end, and optional step.
-		 */
-		range(str: string, includeEnd?: boolean): Matrix;
-		range(start: number|BigNumber, end: number|BigNumber, includeEnd?: boolean): Matrix;
-		range(start: number|BigNumber, end: number|BigNumber, step: number|BigNumber, includeEnd?: boolean): Matrix;
-
-		/**
-		 * Resize a matrix
-		 * @param x Matrix to be resized
-		 * @param size One dimensional array with numbers
-		 * @param defaultValue Zero by default, except in case of a string, in that case defaultValue = ' ' Default value: 0.
-		 */
-		resize(x: MathArray|Matrix, size: MathArray|Matrix, defaultValue?: number|string): MathArray|Matrix;
-
-		/**
-		 * Calculate the size of a matrix or scalar.
-		 */
-		size(x: boolean|number|Complex|Unit|string|MathArray|Matrix): MathArray|Matrix;
-
-		/**
-		 * Squeeze a matrix, remove inner and outer singleton dimensions from a matrix.
-		 */
-		squeeze(x: MathArray|Matrix): Matrix|MathArray;
-
-		/**
-		 * Get or set a subset of a matrix or string.
-		 * @param value An array, matrix, or string
-		 * @param index An index containing ranges for each dimension
-		 * @param replacement An array, matrix, or scalar. If provided, the subset is replaced with replacement. If not provided, the subset is returned
-		 * @param defaultValue Default value, filled in on new entries when the matrix is resized. If not provided, math.matrix elements will be left undefined. Default value: undefined.
-		 */
-		subset(value: MathArray|Matrix|string, index: Index, replacement?: any, defaultValue?: any): MathArray|Matrix|string;
-
-		/**
-		 * Calculate the trace of a matrix: the sum of the elements on the main diagonal of a square matrix.
-		 */
-		trace(x: MathArray|Matrix): number;
-
-		/**
-		 * Transpose a matrix. All values of the matrix are reflected over its main diagonal. Only two dimensional matrices are supported.
-		 */
-		transpose(x: MathArray|Matrix): MathArray|Matrix;
-
-		/**
-		 * Create a matrix filled with zeros. The created matrix can have one or multiple dimensions.
-		 */
-		zeros(n: number|number[], format?: string): MathArray|Matrix;
-		zeros(m: number, n: number, format?: string): MathArray|Matrix;
-
-		/**
-		 * Compute the number of ways of picking k unordered outcomes from n possibilities.
-		 * Combinations only takes integer arguments. The following condition must be enforced: k <= n.
-		 */
-		combinations(n: number|BigNumber, k: number|BigNumber): number|BigNumber;
-
-		/**
-		 * Create a distribution object with a set of random functions for given random distribution.
-		 * @param name Name of a distribution. Choose from 'uniform', 'normal'.
-		 */
-		distribution(name: string): Distribution;
-
-		/**
-		 * Compute the factorial of a value
-		 * Factorial only supports an integer value as argument. For matrices, the function is evaluated element wise.
-		 */
-		factorial(n: number|BigNumber|MathArray|Matrix): number|BigNumber|MathArray|Matrix;
-
-		/**
-		 * Compute the gamma function of a value using Lanczos approximation for small values, and an extended
-		 * Stirling approximation for large values.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		gamma(n: number|MathArray|Matrix): number|MathArray|Matrix;
-
-		/**
-		 * Calculate the Kullback-Leibler (KL) divergence between two distributions
-		 */
-		kldivergence(x: MathArray|Matrix, y: MathArray|Matrix): number;
-
-		/**
-		 * Multinomial Coefficients compute the number of ways of picking a1, a2, ..., ai unordered outcomes from n possibilities.
-		 * multinomial takes one array of integers as an argument. The following condition must be enforced: every ai <= 0
-		 */
-		multinomial(a: number[]|BigNumber[]): number|BigNumber;
-
-		/**
-		 * Compute the number of ways of obtaining an ordered subset of k elements from a set of n elements.
-		 * Permutations only takes integer arguments. The following condition must be enforced: k <= n.
-		 * @param n The number of objects in total
-		 * @param k The number of objects in the subset
-		 */
-		permutations(n: number|BigNumber, k?: number|BigNumber): number|BigNumber;
-
-		/**
-		 * Random pick a value from a one dimensional array. Array element is picked using a random function with uniform distribution.
-		 */
-		pickRandom(array: number[]): number;
-
-		/**
-		 * Return a random number larger or equal to min and smaller than max using a uniform distribution.
-		 */
-		random(min?: number, max?: number): number;
-		random(size: MathArray|Matrix, min?: number, max?: number): MathArray|Matrix;
-
-		/**
-		 * Return a random integer number larger or equal to min and smaller than max using a uniform distribution.
-		 */
-		randomInt(min: number, max?: number): number;
-		randomInt(size: MathArray|Matrix, min?: number, max?: number): MathArray|Matrix;
-
-		/**
-		 * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x == y.
-		 * x and y are considered equal when the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		compare(x: MathType, y: MathType): number|BigNumber|Fraction|MathArray|Matrix;
-
-		/**
-		 * Test element wise whether two matrices are equal. The function accepts both matrices and scalar values.
-		 */
-		deepEqual(x: MathType, y: MathType): number|BigNumber|Fraction|Complex|Unit|MathArray|Matrix;
-
-		/**
-		 * Test whether two values are equal.
-		 *
-		 * The function tests whether the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise. In case of complex numbers, x.re must equal y.re, and x.im must equal y.im.
-		 * Values null and undefined are compared strictly, thus null is only equal to null and nothing else, and undefined is only equal to undefined and nothing else.
-		 */
-		equal(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Test whether value x is larger than y.
-		 * The function returns true when x is larger than y and the relative difference between x and y is larger than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		larger(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Test whether value x is larger or equal to y.
-		 * The function returns true when x is larger than y or the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		largerEq(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Test whether value x is smaller than y.
-		 * The function returns true when x is smaller than y and the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		smaller(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Test whether value x is smaller or equal to y.
-		 * The function returns true when x is smaller than y or the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16. For matrices, the function is evaluated element wise.
-		 */
-		smallerEq(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Test whether two values are unequal.
-		 * The function tests whether the relative difference between x and y is larger than the configured epsilon. The function cannot
-		 * be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise. In case of complex numbers, x.re must unequal y.re, or x.im must unequal y.im.
-		 * Values null and undefined are compared strictly, thus null is unequal with everything except null, and undefined is unequal with
-		 * everything except undefined.
-		 */
-		unequal(x: MathType, y: MathType): boolean|MathArray|Matrix;
-
-		/**
-		 * Compute the maximum value of a matrix or a list with values. In case of a multi dimensional array, the maximum of the flattened
-		 * array will be calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		max(...args: MathType[]): any;
-		max(A: MathArray|Matrix, dim?: number): any;
-
-		/**
-		 * Compute the mean value of matrix or a list with values. In case of a multi dimensional array, the mean of the flattened array will be
-		 * calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		mean(...args: MathType[]): any;
-		mean(A: MathArray|Matrix, dim?: number): any;
-
-		/**
-		 * Compute the median of a matrix or a list with values. The values are sorted and the middle value is returned. In case of an
-		 * even number of values, the average of the two middle values is returned. Supported types of values are: Number, BigNumber, Unit
-		 * In case of a (multi dimensional) array or matrix, the median of all elements will be calculated.
-		 */
-		median(...args: MathType[]): any;
-
-		/**
-		 * Compute the maximum value of a matrix or a list of values. In case of a multi dimensional array, the maximum of the flattened
-		 * array will be calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		min(...args: MathType[]): any;
-		min(A: MathArray|Matrix, dim?: number): any;
-
-		/**
-		 * Computes the mode of a set of numbers or a list with values(numbers or characters). If there are more than one modes, it returns a list of those values.
-		 */
-		mode(...args: MathType[]): any;
-
-		/**
-		 * Compute the product of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the sum of all elements will be calculated.
-		 */
-		prod(...args: MathType[]): any;
-
-		/**
-		 * Compute the prob order quantile of a matrix or a list with values. The sequence is sorted and the middle value is returned.
-		 * Supported types of sequence values are: Number, BigNumber, Unit Supported types of probability are: Number, BigNumber
-		 * In case of a (multi dimensional) array or matrix, the prob order quantile of all elements will be calculated.
-		 */
-		quantileSeq(A: MathArray|Matrix, prob: number|BigNumber|MathArray, sorted?: boolean): number|BigNumber|Unit|MathArray;
-
-		/**
-		 * Compute the standard deviation of a matrix or a list with values. The standard deviations is defined as the square root of the
-		 * variance: std(A) = sqrt(var(A)). In case of a (multi dimensional) array or matrix, the standard deviation over all elements will
-		 * be calculated.
-		 * Optionally, the type of normalization can be specified as second parameter. The parameter normalization can be one of the following
-		 * values:
-		 * 'unbiased' (default) The sum of squared errors is divided by (n - 1)
-		 * 'uncorrected' The sum of squared errors is divided by n
-		 * 'biased' The sum of squared errors is divided by (n + 1)
-		 */
-		std(array: MathArray|Matrix, normalization?: string): number;
-
-		/**
-		 * Compute the sum of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the sum of all elements will be calculated.
-		 */
-		sum(...args: Array<number|BigNumber|Fraction>): any;
-		sum(array: MathArray|Matrix): any;
-
-		/**
-		 * Compute the variance of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the variance over all
-		 * elements will be calculated.
-		 * Optionally, the type of normalization can be specified as second parameter. The parameter normalization can be one of the
-		 * following values:
-		 * 'unbiased' (default) The sum of squared errors is divided by (n - 1)
-		 * 'uncorrected' The sum of squared errors is divided by n
-		 * 'biased' The sum of squared errors is divided by (n + 1)
-		 * Note that older browser may not like the variable name var. In that case, the function can be called as math['var'](...)
-		 * instead of math.var(...).
-		 */
-		var(...args: Array<number|BigNumber|Fraction>): any;
-		var(array: MathArray|Matrix, normalization?: string): any;
-
-		/**
-		 * Calculate the inverse cosine of a value. For matrices, the function is evaluated element wise.
-		 */
-		acos(x: number): number;
-		acos(x: BigNumber): BigNumber;
-		acos(x: Complex): Complex;
-		acos(x: MathArray): MathArray;
-		acos(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic arccos of a value, defined as acosh(x) = ln(sqrt(x^2 - 1) + x).
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acosh(x: number): number;
-		acosh(x: BigNumber): BigNumber;
-		acosh(x: Complex): Complex;
-		acosh(x: MathArray): MathArray;
-		acosh(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse cotangent of a value. For matrices, the function is evaluated element wise.
-		 */
-		acot(x: number): number;
-		acot(x: BigNumber): BigNumber;
-		acot(x: MathArray): MathArray;
-		acot(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic arccotangent of a value, defined as acoth(x) = (ln((x+1)/x) + ln(x/(x-1))) / 2.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acoth(x: number): number;
-		acoth(x: BigNumber): BigNumber;
-		acoth(x: MathArray): MathArray;
-		acoth(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse cosecant of a value. For matrices, the function is evaluated element wise.
-		 */
-		acsc(x: number): number;
-		acsc(x: BigNumber): BigNumber;
-		acsc(x: MathArray): MathArray;
-		acsc(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic arccosecant of a value, defined as acsch(x) = ln(1/x + sqrt(1/x^2 + 1)).
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acsch(x: number): number;
-		acsch(x: BigNumber): BigNumber;
-		acsch(x: MathArray): MathArray;
-		acsch(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse secant of a value. For matrices, the function is evaluated element wise.
-		 */
-		asec(x: number): number;
-		asec(x: BigNumber): BigNumber;
-		asec(x: MathArray): MathArray;
-		asec(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic arcsecant of a value, defined as asech(x) = ln(sqrt(1/x^2 - 1) + 1/x). For matrices, the function is evaluated element wise.
-		 */
-		asech(x: number): number;
-		asech(x: BigNumber): BigNumber;
-		asech(x: MathArray): MathArray;
-		asech(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse sine of a value. For matrices, the function is evaluated element wise.
-		 */
-		asin(x: number): number;
-		asin(x: BigNumber): BigNumber;
-		asin(x: Complex): Complex;
-		asin(x: MathArray): MathArray;
-		asin(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic arcsine of a value, defined as asinh(x) = ln(x + sqrt(x^2 + 1)). For matrices, the function is evaluated element wise.
-		 */
-		asinh(x: number): number;
-		asinh(x: BigNumber): BigNumber;
-		asinh(x: MathArray): MathArray;
-		asinh(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse tangent of a value. For matrices, the function is evaluated element wise.
-		 */
-		atan(x: number): number;
-		atan(x: BigNumber): BigNumber;
-		atan(x: MathArray): MathArray;
-		atan(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the inverse tangent function with two arguments, y/x. By providing two arguments, the right quadrant of the
-		 * computed angle can be determined.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		atan2(y: number, x: number): number;
-		atan2(y: MathArray|Matrix, x: MathArray|Matrix): MathArray|Matrix;
-
-		/**
-		 * Calculate the hyperbolic arctangent of a value, defined as atanh(x) = ln((1 + x)/(1 - x)) / 2.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		atanh(x: number): number;
-		atanh(x: BigNumber): BigNumber;
-		atanh(x: MathArray): MathArray;
-		atanh(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic cosine of a value, defined as cosh(x) = 1/2 * (exp(x) + exp(-x)). For matrices, the function is evaluated element wise.
-		 */
-		cosh(x: number|Unit): number;
-		cosh(x: BigNumber): BigNumber;
-		cosh(x: Complex): Complex;
-		cosh(x: MathArray): MathArray;
-		cosh(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the cotangent of a value. cot(x) is defined as 1 / tan(x). For matrices, the function is evaluated element wise.
-		 */
-		cot(x: number|Unit): number;
-		cot(x: Complex): Complex;
-		cot(x: MathArray): MathArray;
-		cot(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic cotangent of a value, defined as coth(x) = 1 / tanh(x). For matrices, the function is evaluated element wise.
-		 */
-		coth(x: number|Unit): number;
-		coth(x: Complex): Complex;
-		coth(x: MathArray): MathArray;
-		coth(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the cosecant of a value, defined as csc(x) = 1/sin(x). For matrices, the function is evaluated element wise.
-		 */
-		csc(x: number|Unit): number;
-		csc(x: Complex): Complex;
-		csc(x: MathArray): MathArray;
-		csc(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic cosecant of a value, defined as csch(x) = 1 / sinh(x). For matrices, the function is evaluated element wise.
-		 */
-		csch(x: number|Unit): number;
-		csch(x: Complex): Complex;
-		csch(x: MathArray): MathArray;
-		csch(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the secant of a value, defined as sec(x) = 1/cos(x). For matrices, the function is evaluated element wise.
-		 */
-		sec(x: number|Unit): number;
-		sec(x: Complex): Complex;
-		sec(x: MathArray): MathArray;
-		sec(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic secant of a value, defined as sech(x) = 1 / cosh(x). For matrices, the function is evaluated element wise.
-		 */
-		sech(x: number|Unit): number;
-		sech(x: Complex): Complex;
-		sech(x: MathArray): MathArray;
-		sech(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the sine of a value. For matrices, the function is evaluated element wise.
-		 */
-		sin(x: number|Unit): number;
-		sin(x: BigNumber): BigNumber;
-		sin(x: Complex): Complex;
-		sin(x: MathArray): MathArray;
-		sin(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the cosine of a value. For matrices, the function is evaluated element wise.
-		 */
-		cos(x: number|Unit): number;
-		cos(x: BigNumber): BigNumber;
-		cos(x: Complex): Complex;
-		cos(x: MathArray): MathArray;
-		cos(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic sine of a value, defined as sinh(x) = 1/2 * (exp(x) - exp(-x)). For matrices, the function is evaluated element wise.
-		 */
-		sinh(x: number|Unit): number;
-		sinh(x: BigNumber): BigNumber;
-		sinh(x: Complex): Complex;
-		sinh(x: MathArray): MathArray;
-		sinh(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the tangent of a value. tan(x) is equal to sin(x) / cos(x). For matrices, the function is evaluated element wise.
-		 */
-		tan(x: number|Unit): number;
-		tan(x: BigNumber): BigNumber;
-		tan(x: Complex): Complex;
-		tan(x: MathArray): MathArray;
-		tan(x: Matrix): Matrix;
-
-		/**
-		 * Calculate the hyperbolic tangent of a value, defined as tanh(x) = (exp(2 * x) - 1) / (exp(2 * x) + 1). For matrices, the function is evaluated element wise.
-		 */
-		tanh(x: number|Unit): number;
-		tanh(x: BigNumber): BigNumber;
-		tanh(x: Complex): Complex;
-		tanh(x: MathArray): MathArray;
-		tanh(x: Matrix): Matrix;
-
-		/**
-		 * Change the unit of a value. For matrices, the function is evaluated element wise.
-		 * @param x The unit to be converted.
-		 * @param unit New unit. Can be a string like "cm" or a unit without value.
-		 */
-		to(x: Unit|MathArray|Matrix, unit: Unit|string): Unit|MathArray|Matrix;
-
-		/**
-		 * Clone an object.
-		 */
-		clone(x: any): any;
-
-		/**
-		 * Filter the items in an array or one dimensional matrix.
-		 * @param x A one dimensional matrix or array to filter
-		 * @param test
-		 */
-		filter(x: MathArray|Matrix, test: RegExp|((item: any) => boolean)): MathArray|Matrix;
-
-		/**
-		 * Iterate over all elements of a matrix/array, and executes the given callback function.
-		 * @param x The matrix to iterate on.
-		 * @param callback The callback function is invoked with three parameters: the value of the element, the index of the element, and the Matrix/array being traversed.
-		 */
-		forEach: (x: MathArray|Matrix, callback: (item: any) => any) => void;
-
-		/**
-		 * Format a value of any type into a string.
-		 * @param value The value to be formatted
-		 */
-		format(value: any, options?: FormatOptions|number|((item: any) => string)): string;
-
-		/**
-		 * Test whether a value is an integer number. The function supports number, BigNumber, and Fraction.
-		 * The function is evaluated element-wise in case of Array or Matrix input.
-		 */
-		isInteger(x: any): boolean;
-
-		/**
-		 * Test whether a value is negative: smaller than zero. The function supports types number, BigNumber, Fraction, and Unit.
-		 * The function is evaluated element-wise in case of Array or Matrix input.
-		 */
-		isNegative(x: any): boolean;
-
-		/**
-		 * Test whether a value is an numeric value. The function is evaluated element-wise in case of Array or Matrix input.
-		 */
-		isNumeric(x: any): boolean;
-
-		/**
-		 * Test whether a value is positive: larger than zero. The function supports types number, BigNumber, Fraction, and Unit.
-		 * The function is evaluated element-wise in case of Array or Matrix input.
-		 */
-		isPositive(x: any): boolean;
-
-		/**
-		 * Test whether a value is zero. The function can check for zero for types number, BigNumber, Fraction, Complex, and Unit.
-		 * The function is evaluated element-wise in case of Array or Matrix input.
-		 */
-		isZero(x: any): boolean;
-
-		/**
-		 * Create a new matrix or array with the results of the callback function executed on each entry of the matrix/array.
-		 * @param x The matrix to iterate on.
-		 * @param callback The callback method is invoked with three parameters: the value of the element, the index of the element, and the matrix being traversed.
-		 */
-		map(x: MathArray|Matrix, callback: (item: any) => any): MathArray|Matrix;
-
-		/**
-		 * Partition-based selection of an array or 1D matrix. Will find the kth smallest value, and mutates the input array. Uses Quickselect.
-		 * @param x A one dimensional matrix or array to sort
-		 * @param k The kth smallest value to be retrieved; zero-based index
-		 * @param compare  An optional comparator function. The function is called as compare(a, b), and must return 1 when a > b, -1 when a < b, and 0 when a == b. Default value: 'asc'.
-		 * @returns Returns the kth lowest value.
-		 */
-		partitionSelect(x: MathArray|Matrix, k: number, compare?: string|((a: any, b: any) => number)): any;
-
-		/**
-		 * Interpolate values into a string template.
-		 * @param template A string containing variable placeholders.
-		 * @param values An object containing variables which will be filled in in the template.
-		 * @param precision Number of digits to format numbers. If not provided, the value will not be rounded.
-		 */
-		print: (template: string, values: any, precision?: number) => void;
-
-		/**
-		 * Sort the items in a matrix.
-		 * @param x A one dimensional matrix or array to sort
-		 * @param compare  An optional comparator function. The function is called as compare(a, b), and must return 1 when a > b, -1 when a < b, and 0 when a == b. Default value: 'asc'.
-		 */
-		sort(x: MathArray|Matrix, compare?: string|((a: any, b: any) => number)): MathArray|Matrix;
-
-		/**
-		 * Determine the type of a variable.
-		 */
-		typeof(x: any): string;
-	}
-
-	interface Matrix {
-		type: string;
-		storage(): string;
-		datatype(): string;
-		density(): number;
-		subset(index: Index, replacement?: any, defaultValue?: any): Matrix;
-		get(index: number[]): any;
-		set(index: number[], value: any, defaultValue?: number|string): Matrix;
-		resize(size: MathArray|Matrix, defaultValue?: number|string): Matrix;
-		clone(): Matrix;
-		size(): number[];
-		map(callback: (a: any, b: number, c: Matrix) => any, skipZeros?: boolean): Matrix;
-		forEach: (callback: (a: any, b: number, c: Matrix) => void, skipZeros?: boolean) => void;
-		toJSON(): any;
-		diagonal(k?: number|BigNumber): any[];
-		swapRows(i: number, j: number): Matrix;
-	}
-
-	interface BigNumber extends Decimal {} // tslint:disable-line no-empty-interface
-
-	interface Fraction {
-		s: number;
-		n: number;
-		d: number;
-	}
-
-	interface Complex {
-		re: number;
-		im: number;
-		toPolar(): PolarCoordinates;
-		clone(): Complex;
-	}
-
-	interface PolarCoordinates {
-        r: number;
-		phi: number;
+        kron(x: Matrix | MathArray, y: Matrix | MathArray): Matrix;
+
+        /**
+         * Iterate over all elements of a matrix/array, and executes the given
+         * callback function.
+         * @param x The matrix to iterate on.
+         * @param callback The callback function is invoked with three
+         * parameters: the value of the element, the index of the element, and
+         * the Matrix/array being traversed.
+         * @returns Transformed map of x
+         */
+        map(x: Matrix | MathArray, callback: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray)): Matrix | MathArray;
+
+        /**
+         * Create a matrix filled with ones. The created matrix can have one or
+         * multiple dimensions.
+         * @param size The size of each dimension of the matrix
+         * @param format The matrix storage format
+         * @returns A matrix filled with ones
+         */
+        ones(size: number | number[], format?: string): MathArray | Matrix;
+        /**
+         * @param m The x dimension of the matrix
+         * @param n The y dimension of the amtrix
+         * @param format The matrix storage format
+         * @returns A matrix filled with ones
+         */
+        ones(m: number, n: number, format?: string): MathArray | Matrix;
+
+        /**
+         * Partition-based selection of an array or 1D matrix. Will find the kth
+         * smallest value, and mutates the input array. Uses Quickselect.
+         * @param x A one dimensional matrix or array to sort
+         * @param k The kth smallest value to be retrieved; zero-based index
+         * @param compare  An optional comparator function. The function is
+         * called as compare(a, b), and must return 1 when a > b, -1 when a < b,
+         * and 0 when a == b. Default value: 'asc'.
+         * @returns Returns the kth lowest value.
+         */
+        partitionSelect(
+            x: MathArray | Matrix,
+            k: number,
+            compare?: "asc" | "desc" | ((a: any, b: any) => number)
+        ): any;
+
+        /**
+         * Create an array from a range. By default, the range end is excluded.
+         * This can be customized by providing an extra parameter includeEnd.
+         * @param str A string 'start:end' or 'start:step:end'
+         * @param start Start of the range
+         * @param end End of the range, excluded by default, included when
+         * parameter includeEnd=true
+         * @param step Step size. Default value is 1.
+         * @param includeEnd: Option to specify whether to include the end or
+         * not. False by default
+         * @returns Parameters describing the ranges start, end, and optional
+         * step.
+         */
+        range(str: string, includeEnd?: boolean): Matrix;
+        range(
+            start: number | BigNumber,
+            end: number | BigNumber,
+            includeEnd?: boolean
+        ): Matrix;
+        range(
+            start: number | BigNumber,
+            end: number | BigNumber,
+            step: number | BigNumber,
+            includeEnd?: boolean
+        ): Matrix;
+
+        /**
+         * Reshape a multi dimensional array to fit the specified dimensions
+         * @param x Matrix to be reshaped
+         * @param sizes One dimensional array with integral sizes for each
+         * dimension
+         * @returns A reshaped clone of matrix x
+         */
+        reshape(
+            x: MathArray | Matrix | any,
+            sizes: number[]
+        ): any | MathArray | Matrix;
+
+        /**
+         * Resize a matrix
+         * @param x Matrix to be resized
+         * @param size One dimensional array with numbers
+         * @param defaultValue Zero by default, except in case of a string, in
+         * that case defaultValue = ' ' Default value: 0.
+         * @returns A resized clone of matrix x
+         */
+        resize(
+            x: MathArray | Matrix,
+            size: MathArray | Matrix,
+            defaultValue?: number | string
+        ): MathArray | Matrix;
+
+        /**
+         * Calculate the size of a matrix or scalar.
+         * @param A matrix
+         * @returns A vector with the size of x
+         */
+        size(
+            x: boolean | number | Complex | Unit | string | MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /**
+         * Sort the items in a matrix
+         * @param x A one dimensional matrix or array to sort
+         * @param compare An optional _comparator function or name. The function
+         * is called as compare(a, b), and must return 1 when a > b, -1 when a <
+         * b, and 0 when a == b. Default value: ‘asc’
+         * @returns Returns the sorted matrix
+         */
+        sort(
+            x: Matrix | MathArray,
+            compare: ((a:any, b:any)=>number) | "asc" | "desc" | "natural"
+        ): Matrix | MathArray;
+
+        /**
+         * Calculate the principal square root of a square matrix. The principal
+         * square root matrix X of another matrix A is such that X * X = A.
+         * @param A The square matrix A
+         * @returns The principal square root of matrix A
+         */
+        sqrtm(A: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Squeeze a matrix, remove inner and outer singleton dimensions from a
+         * matrix.
+         * @param x Matrix to be squeezed
+         * @returns Squeezed matrix
+         */
+        squeeze(x: MathArray | Matrix): Matrix | MathArray;
+
+        /**
+         * Get or set a subset of a matrix or string.
+         * @param value An array, matrix, or string
+         * @param index An index containing ranges for each dimension
+         * @param replacement An array, matrix, or scalar. If provided, the
+         * subset is replaced with replacement. If not provided, the subset is
+         * returned
+         * @param defaultValue Default value, filled in on new entries when the
+         * matrix is resized. If not provided, math.matrix elements will be left
+         * undefined. Default value: undefined.
+         * @returns Either the retrieved subset or the updated matrix
+         */
+        subset(
+            value: MathArray | Matrix | string,
+            index: Index,
+            replacement?: any,
+            defaultValue?: any
+        ): MathArray | Matrix | string;
+
+        /**
+         * Calculate the trace of a matrix: the sum of the elements on the main
+         * diagonal of a square matrix.
+         * @param x A matrix
+         * @returns The trace of x
+         */
+        trace(x: MathArray | Matrix): number;
+
+        /**
+         * Transpose a matrix. All values of the matrix are reflected over its
+         * main diagonal. Only two dimensional matrices are supported.
+         * @param x Matrix to be transposed
+         * @returns The transposed matrix
+         */
+        transpose(x: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Create a matrix filled with zeros. The created matrix can have one or
+         * multiple dimensions.
+         * @param size The size of each dimension of the matrix
+         * @param format The matrix storage format
+         * @returns A matrix filled with zeros
+         */
+        zeros(size: number | number[], format?: string): MathArray | Matrix;
+        /**
+         * @param m The x dimension of the matrix
+         * @param n The y dimension of the matrix
+         * @param format The matrix storage format
+         * @returns A matrix filled with zeros
+         */
+        zeros(m: number, n: number, format?: string): MathArray | Matrix;
+
+        /*************************************************************************
+         * Probability functions
+         ************************************************************************/
+
+        /**
+         * Compute the number of ways of picking k unordered outcomes from n
+         * possibilities. Combinations only takes integer arguments. The
+         * following condition must be enforced: k <= n.
+         * @param n Total number of objects in the set
+         * @param k Number of objects in the subset
+         * @returns Number of possible combinations
+         */
+        combinations(
+            n: number | BigNumber,
+            k: number | BigNumber
+        ): number | BigNumber;
+
+        /**
+         * Compute the factorial of a value Factorial only supports an integer
+         * value as argument. For matrices, the function is evaluated element
+         * wise.
+         * @param n An integer number
+         * @returns The factorial of n
+         */
+        factorial(
+            n: number | BigNumber | MathArray | Matrix
+        ): number | BigNumber | MathArray | Matrix;
+
+        /**
+         * Compute the gamma function of a value using Lanczos approximation for
+         * small values, and an extended Stirling approximation for large
+         * values. For matrices, the function is evaluated element wise.
+         * @param n A real or complex number
+         * @returns The gamma of n
+         */
+        gamma(n: number | MathArray | Matrix): number | MathArray | Matrix;
+
+        /**
+         * Calculate the Kullback-Leibler (KL) divergence between two
+         * distributions
+         * @param q First vector
+         * @param p Second vector
+         * @returns Returns disance between q and p
+         */
+        kldivergence(q: MathArray | Matrix, p: MathArray | Matrix): number;
+
+        /**
+         * Multinomial Coefficients compute the number of ways of picking a1,
+         * a2, ..., ai unordered outcomes from n possibilities. multinomial
+         * takes one array of integers as an argument. The following condition
+         * must be enforced: every ai <= 0
+         * @param a Integer number of objects in the subset
+         * @returns multinomial coefficent
+         */
+        multinomial(a: number[] | BigNumber[]): number | BigNumber;
+
+        /**
+         * Compute the number of ways of obtaining an ordered subset of k
+         * elements from a set of n elements. Permutations only takes integer
+         * arguments. The following condition must be enforced: k <= n.
+         * @param n The number of objects in total
+         * @param k The number of objects in the subset
+         * @returns The number of permutations
+         */
+        permutations(
+            n: number | BigNumber,
+            k?: number | BigNumber
+        ): number | BigNumber;
+
+        /**
+         * Random pick a value from a one dimensional array. Array element is
+         * picked using a random function with uniform distribution.
+         * @param array A one dimensional array
+         * @param number An int or float
+         * @param weights An array of ints or floats
+         * @returns Returns a single random value from array when number is 1 or
+         * undefined. Returns an array with the configured number of elements
+         * when number is > 1.
+         */
+        pickRandom(
+            array: number[],
+            number?: number,
+            weights?: number[]
+        ): number;
+
+        /**
+         * Return a random number larger or equal to min and smaller than max
+         * using a uniform distribution.
+         * @param size If provided, an array or matrix with given size and
+         * filled with random values is returned
+         * @param min Minimum boundary for the random value, included
+         * @param max Maximum boundary for the random value, excluded
+         * @returns A random number
+         */
+        random(min?: number, max?: number): number;
+        random(
+            size: MathArray | Matrix,
+            min?: number,
+            max?: number
+        ): MathArray | Matrix;
+
+        /**
+         * Return a random integer number larger or equal to min and smaller
+         * than max using a uniform distribution.
+         * @param size If provided, an array or matrix with given size and
+         * filled with random values is returned
+         * @param min Minimum boundary for the random value, included
+         * @param max Maximum boundary for the random value, excluded
+         * @returns A random number
+         */
+        randomInt(min: number, max?: number): number;
+        randomInt(
+            size: MathArray | Matrix,
+            min?: number,
+            max?: number
+        ): MathArray | Matrix;
+
+        /*************************************************************************
+         * Relational functions
+         ************************************************************************/
+
+        /**
+         * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x
+         * == y. x and y are considered equal when the relative difference
+         * between x and y is smaller than the configured epsilon. The function
+         * cannot be used to compare values smaller than approximately 2.22e-16.
+         * For matrices, the function is evaluated element wise.
+         * @param x First value to compare
+         * @param y Second value to compare
+         * @returns Returns the result of the comparison: 1 when x > y, -1 when
+         * x < y, and 0 when x == y.
+         */
+        compare(
+            x: MathType | string,
+            y: MathType | string
+        ): number | BigNumber | Fraction | MathArray | Matrix;
+
+        /**
+         * Compare two values of any type in a deterministic, natural way. For
+         * numeric values, the function works the same as math.compare. For
+         * types of values that can’t be compared mathematically, the function
+         * compares in a natural way.
+         * @param x First value to compare
+         * @param y Second value to compare
+         * @returns Returns the result of the comparison: 1 when x > y, -1 when
+         * x < y, and 0 when x == y.
+         */
+        compareNatural(x: any, y: any): number;
+
+        /**
+         * Compare two strings lexically. Comparison is case sensitive. Returns
+         * 1 when x > y, -1 when x < y, and 0 when x == y. For matrices, the
+         * function is evaluated element wise.
+         * @param x First string to compare
+         * @param y Second string to compare
+         * @returns Returns the result of the comparison: 1 when x > y, -1 when
+         * x < y, and 0 when x == y.
+         */
+        compareText(
+            x: string | MathArray | Matrix,
+            y: string | MathArray | Matrix
+        ): number | MathArray | Matrix;
+
+        /**
+         * Test element wise whether two matrices are equal. The function
+         * accepts both matrices and scalar values.
+         * @param x First matrix to compare
+         * @param y Second amtrix to compare
+         * @returns Returns true when the input matrices have the same size and
+         * each of their elements is equal.
+         */
+        deepEqual(
+            x: MathType,
+            y: MathType
+        ): number | BigNumber | Fraction | Complex | Unit | MathArray | Matrix;
+
+        /**
+         * Test whether two values are equal.
+         *
+         * The function tests whether the relative difference between x and y is
+         * smaller than the configured epsilon. The function cannot be used to
+         * compare values smaller than approximately 2.22e-16. For matrices, the
+         * function is evaluated element wise. In case of complex numbers, x.re
+         * must equal y.re, and x.im must equal y.im. Values null and undefined
+         * are compared strictly, thus null is only equal to null and nothing
+         * else, and undefined is only equal to undefined and nothing else.
+         * @param x First value to compare
+         * @param y Second value to compare
+         * @returns Returns true when the compared values are equal, else
+         * returns false
+         */
+        equal(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Check equality of two strings. Comparison is case sensitive. For
+         * matrices, the function is evaluated element wise.
+         * @param x First string to compare
+         * @param y Second string to compare
+         * @returns Returns true if the values are equal, and false if not.
+         */
+        equalText(
+            x: string | MathArray | Matrix,
+            y: string | MathArray | Matrix
+        ): number | MathArray | Matrix;
+
+        /**
+         * Test whether value x is larger than y. The function returns true when
+         * x is larger than y and the relative difference between x and y is
+         * larger than the configured epsilon. The function cannot be used to
+         * compare values smaller than approximately 2.22e-16. For matrices, the
+         * function is evaluated element wise.
+         * @param x First value to compare
+         * @param y Second value to vcompare
+         * @returns Returns true when x is larger than y, else returns false
+         */
+        larger(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Test whether value x is larger or equal to y. The function returns
+         * true when x is larger than y or the relative difference between x and
+         * y is smaller than the configured epsilon. The function cannot be used
+         * to compare values smaller than approximately 2.22e-16. For matrices,
+         * the function is evaluated element wise.
+         * @param x First value to compare
+         * @param y Second value to vcompare
+         * @returns Returns true when x is larger than or equal to y, else
+         * returns false
+         */
+        largerEq(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Test whether value x is smaller than y. The function returns true
+         * when x is smaller than y and the relative difference between x and y
+         * is smaller than the configured epsilon. The function cannot be used
+         * to compare values smaller than approximately 2.22e-16. For matrices,
+         * the function is evaluated element wise.
+         * @param x First value to compare
+         * @param y Second value to vcompare
+         * @returns Returns true when x is smaller than y, else returns false
+         */
+        smaller(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Test whether value x is smaller or equal to y. The function returns
+         * true when x is smaller than y or the relative difference between x
+         * and y is smaller than the configured epsilon. The function cannot be
+         * used to compare values smaller than approximately 2.22e-16. For
+         * matrices, the function is evaluated element wise.
+         * @param x First value to compare
+         * @param y Second value to vcompare
+         * @returns Returns true when x is smaller than or equal to y, else
+         * returns false
+         */
+        smallerEq(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /**
+         * Test whether two values are unequal. The function tests whether the
+         * relative difference between x and y is larger than the configured
+         * epsilon. The function cannot be used to compare values smaller than
+         * approximately 2.22e-16. For matrices, the function is evaluated
+         * element wise. In case of complex numbers, x.re must unequal y.re, or
+         * x.im must unequal y.im. Values null and undefined are compared
+         * strictly, thus null is unequal with everything except null, and
+         * undefined is unequal with everything except undefined.
+         * @param x First value to compare
+         * @param y Second value to vcompare
+         * @returns Returns true when the compared values are unequal, else
+         * returns false
+         */
+        unequal(
+            x: MathType | string,
+            y: MathType | string
+        ): boolean | MathArray | Matrix;
+
+        /*************************************************************************
+         * Set functions
+         ************************************************************************/
+
+        /**
+         * Create the cartesian product of two (multi)sets. Multi-dimension
+         * arrays will be converted to single-dimension arrays before the
+         * operation.
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns The cartesian product of two (multi)sets
+         */
+        setCartesian(
+            a1: MathArray | Matrix,
+            a2: MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /**
+         * Create the difference of two (multi)sets: every element of set1, that
+         * is not the element of set2. Multi-dimension arrays will be converted
+         * to single-dimension arrays before the operation
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns The difference of two (multi)sets
+         */
+        setDifference(
+            a1: MathArray | Matrix,
+            a2: MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /**
+         * Collect the distinct elements of a multiset. A multi-dimension array
+         * will be converted to a single-dimension array before the operation.
+         * @param a A multiset
+         * @returns A set containing the distinct elements of the multiset
+         */
+        setDistinct(a: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Create the intersection of two (multi)sets. Multi-dimension arrays
+         * will be converted to single-dimension arrays before the operation.
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns The intersection of two (multi)sets
+         */
+        setIntersect(
+            a1: MathArray | Matrix,
+            a2: MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /**
+         * Check whether a (multi)set is a subset of another (multi)set. (Every
+         * element of set1 is the element of set2.) Multi-dimension arrays will
+         * be converted to single-dimension arrays before the operation.
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns True if a1 is subset of a2, else false
+         */
+        setIsSubset(a1: MathArray | Matrix, a2: MathArray | Matrix): boolean;
+
+        /**
+         * Count the multiplicity of an element in a multiset. A multi-dimension
+         * array will be converted to a single-dimension array before the
+         * operation.
+         * @param e An element in the multiset
+         * @param a A multiset
+         * @returns The number of how many times the multiset contains the
+         * element
+         */
+        setMultiplicity(
+            e: number | BigNumber | Fraction | Complex,
+            a: MathArray | Matrix
+        ): number;
+
+        /**
+         * Create the powerset of a (multi)set. (The powerset contains very
+         * possible subsets of a (multi)set.) A multi-dimension array will be
+         * converted to a single-dimension array before the operation.
+         * @param a A multiset
+         * @returns The powerset of the (multi)set
+         */
+        setPowerset(a: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Count the number of elements of a (multi)set. When a second parameter
+         * is ‘true’, count only the unique values. A multi-dimension array will
+         * be converted to a single-dimension array before the operation.
+         * @param a A multiset
+         * @returns The number of elements of the (multi)set
+         */
+        setSize(a: MathArray | Matrix): number;
+
+        /**
+         * Create the symmetric difference of two (multi)sets. Multi-dimension
+         * arrays will be converted to single-dimension arrays before the
+         * operation.
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns The symmetric difference of two (multi)sets
+         */
+        setSymDifference(
+            a1: MathArray | Matrix,
+            a2: MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /**
+         * Create the union of two (multi)sets. Multi-dimension arrays will be
+         * converted to single-dimension arrays before the operation.
+         * @param a1 A (multi)set
+         * @param a2 A (multi)set
+         * @returns The union of two (multi)sets
+         */
+        setUnion(
+            a1: MathArray | Matrix,
+            a2: MathArray | Matrix
+        ): MathArray | Matrix;
+
+        /*************************************************************************
+         * Special functions
+         ************************************************************************/
+
+        /**
+         * Compute the erf function of a value using a rational Chebyshev
+         * approximations for different intervals of x.
+         * @param x A real number
+         * @returns The erf of x
+         */
+        erf(x: number | MathArray | Matrix): number | MathArray | Matrix;
+
+        /*************************************************************************
+         * Statistics functions
+         ************************************************************************/
+
+        /**
+         * Compute the median absolute deviation of a matrix or a list with
+         * values. The median absolute deviation is defined as the median of the
+         * absolute deviations from the median.
+         * @param array A single matrix or multiple scalar values.
+         * @returns The median absolute deviation
+         */
+        mad(array: MathArray | Matrix): any;
+
+        /**
+         * Compute the maximum value of a matrix or a list with values. In case
+         * of a multi dimensional array, the maximum of the flattened array will
+         * be calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         * @param args A single matrix or multiple scalar values
+         * @returns The maximum value
+         */
+        max(...args: MathType[]): any;
+        /**
+         * @param A A single matrix
+         * @param dim The maximum over the selected dimension
+         * @returns The maximum value
+         */
+        max(A: MathArray | Matrix, dim?: number): any;
+
+        /**
+         * Compute the mean value of matrix or a list with values. In case of a
+         * multi dimensional array, the mean of the flattened array will be
+         * calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         * @param args A single matrix or multiple scalar values
+         * @returns The mean of all values
+         */
+        mean(...args: MathType[]): any;
+        /**
+         * @param A A single matrix
+         * @param dim The mean over the selected dimension
+         * @returns The mean of all values
+         */
+        mean(A: MathArray | Matrix, dim?: number): any;
+
+        /**
+         * Compute the median of a matrix or a list with values. The values are
+         * sorted and the middle value is returned. In case of an even number of
+         * values, the average of the two middle values is returned. Supported
+         * types of values are: Number, BigNumber, Unit In case of a (multi
+         * dimensional) array or matrix, the median of all elements will be
+         * calculated.
+         * @param args A single matrix or or multiple scalar values
+         * @returns The median
+         */
+        median(...args: MathType[]): any;
+
+        /**
+         * Compute the maximum value of a matrix or a list of values. In case of
+         * a multi dimensional array, the maximum of the flattened array will be
+         * calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         * @param args A single matrix or or multiple scalar values
+         * @returns The minimum value
+         */
+        min(...args: MathType[]): any;
+        /**
+         * @param A A single matrix
+         * @param dim The minimum over the selected dimension
+         * @returns The minimum value
+         */
+        min(A: MathArray | Matrix, dim?: number): any;
+
+        /**
+         * Computes the mode of a set of numbers or a list with values(numbers
+         * or characters). If there are more than one modes, it returns a list
+         * of those values.
+         * @param args A single matrix
+         * @returns The mode of all values
+         */
+        mode(...args: MathType[]): any;
+
+        /**
+         * Compute the product of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the sum of all elements will be
+         * calculated.
+         * @param args A single matrix or multiple scalar values
+         * @returns The product of all values
+         */
+        prod(...args: MathType[]): any;
+
+        /**
+         * Compute the prob order quantile of a matrix or a list with values.
+         * The sequence is sorted and the middle value is returned. Supported
+         * types of sequence values are: Number, BigNumber, Unit Supported types
+         * of probability are: Number, BigNumber In case of a (multi
+         * dimensional) array or matrix, the prob order quantile of all elements
+         * will be calculated.
+         * @param A A single matrix or array
+         * @param probOrN prob is the order of the quantile, while N is the
+         * amount of evenly distributed steps of probabilities; only one of
+         * these options can be provided
+         * @param sorted =false is data sorted in ascending order
+         * @returns Quantile(s)
+         */
+        quantileSeq(
+            A: MathArray | Matrix,
+            prob: number | BigNumber | MathArray,
+            sorted?: boolean
+        ): number | BigNumber | Unit | MathArray;
+
+        /**
+         * Compute the standard deviation of a matrix or a list with values. The
+         * standard deviations is defined as the square root of the variance:
+         * std(A) = sqrt(var(A)). In case of a (multi dimensional) array or
+         * matrix, the standard deviation over all elements will be calculated.
+         * Optionally, the type of normalization can be specified as second
+         * parameter. The parameter normalization can be one of the following
+         * values: 'unbiased' (default) The sum of squared errors is divided by
+         * (n - 1) 'uncorrected' The sum of squared errors is divided by n
+         * 'biased' The sum of squared errors is divided by (n + 1)
+         * @param array A single matrix or multiple scalar values
+         * @param normalization Determines how to normalize the variance. Choose
+         * ‘unbiased’ (default), ‘uncorrected’, or ‘biased’. Default value:
+         * ‘unbiased’.
+         * @returns The standard deviation
+         */
+        std(
+            array: MathArray | Matrix,
+            normalization?: "unbiased" | "uncorrected" | "biased" | "unbiased"
+        ): number;
+
+        /**
+         * Compute the sum of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the sum of all elements will be
+         * calculated.
+         * @param args A single matrix or multiple scalar values
+         * @returns The sum of all values
+         */
+        sum(...args: Array<number | BigNumber | Fraction>): any;
+        /**
+         * @param array A single matrix
+         * @returns The sum of all values
+         */
+        sum(array: MathArray | Matrix): any;
+
+        /**
+         * Compute the variance of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the variance over all elements
+         * will be calculated. Optionally, the type of normalization can be
+         * specified as second parameter. The parameter normalization can be one
+         * of the following values: 'unbiased' (default) The sum of squared
+         * errors is divided by (n - 1) 'uncorrected' The sum of squared errors
+         * is divided by n 'biased' The sum of squared errors is divided by (n +
+         * 1) Note that older browser may not like the variable name var. In
+         * that case, the function can be called as math['var'](...) instead of
+         * math.var(...).
+         * @param args A single matrix or multiple scalar values
+         * @returns The variance
+         */
+        var(...args: Array<number | BigNumber | Fraction>): any;
+        /**
+         * @param array A single matrix
+         * @param normalization normalization Determines how to normalize the
+         * variance. Choose ‘unbiased’ (default), ‘uncorrected’, or ‘biased’.
+         * Default value: ‘unbiased’.
+         * @returns The variance
+         */
+        var(
+            array: MathArray | Matrix,
+            normalization?: "unbiased" | "uncorrected" | "biased" | "unbiased"
+        ): any;
+
+        /*************************************************************************
+         * String functions
+         ************************************************************************/
+
+        /**
+         * Format a value of any type into a string.
+         * @param value The value to be formatted
+         * @param options An object with formatting options.
+         * @param callback A custom formatting function, invoked for all numeric
+         * elements in value, for example all elements of a matrix, or the real
+         * and imaginary parts of a complex number. This callback can be used to
+         * override the built-in numeric notation with any type of formatting.
+         * Function callback is called with value as parameter and must return a
+         * string.
+         * @see http://mathjs.org/docs/reference/functions/format.html
+         * @returns The formatted value
+         */
+        format(
+            value: any,
+            options?: FormatOptions | number | ((item: any) => string),
+            callback?: ((value:any)=>string)
+        ): string;
+
+        /**
+         * Interpolate values into a string template.
+         * @param template A string containing variable placeholders.
+         * @param values An object containing variables which will be filled in
+         * in the template.
+         * @param precision Number of digits to format numbers. If not provided,
+         * the value will not be rounded.
+         * @param options Formatting options, or the number of digits to format
+         * numbers. See function math.format for a description of all options.
+         * @returns Interpolated string
+         */
+        print(
+            template: string,
+            values: any,
+            precision?: number,
+            options?: number | object
+        ): void;
+
+        /*************************************************************************
+         * Trigonometry functions
+         ************************************************************************/
+
+        /**
+         * Calculate the inverse cosine of a value. For matrices, the function
+         * is evaluated element wise.
+         * @param x Function input
+         * @returns The arc cosine of x
+         */
+        acos(x: number): number;
+        acos(x: BigNumber): BigNumber;
+        acos(x: Complex): Complex;
+        acos(x: MathArray): MathArray;
+        acos(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic arccos of a value, defined as acosh(x) =
+         * ln(sqrt(x^2 - 1) + x). For matrices, the function is evaluated
+         * element wise.
+         * @param x Function input
+         * @returns The hyperbolic arccosine of x
+         */
+        acosh(x: number): number;
+        acosh(x: BigNumber): BigNumber;
+        acosh(x: Complex): Complex;
+        acosh(x: MathArray): MathArray;
+        acosh(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse cotangent of a value. For matrices, the
+         * function is evaluated element wise.
+         * @param x Function input
+         * @returns The arc cotangent of x
+         */
+        acot(x: number): number;
+        acot(x: BigNumber): BigNumber;
+        acot(x: MathArray): MathArray;
+        acot(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic arccotangent of a value, defined as acoth(x)
+         * = (ln((x+1)/x) + ln(x/(x-1))) / 2. For matrices, the function is
+         * evaluated element wise.
+         * @param x Function input
+         * @returns The hyperbolic arccotangent of x
+         */
+        acoth(x: number): number;
+        acoth(x: BigNumber): BigNumber;
+        acoth(x: MathArray): MathArray;
+        acoth(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse cosecant of a value. For matrices, the function
+         * is evaluated element wise.
+         * @param x Function input
+         * @returns The arc cosecant of x
+         */
+        acsc(x: number): number;
+        acsc(x: BigNumber): BigNumber;
+        acsc(x: MathArray): MathArray;
+        acsc(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic arccosecant of a value, defined as acsch(x)
+         * = ln(1/x + sqrt(1/x^2 + 1)). For matrices, the function is evaluated
+         * element wise.
+         * @param x Function input
+         * @returns The hyperbolic arccosecant of x
+         */
+        acsch(x: number): number;
+        acsch(x: BigNumber): BigNumber;
+        acsch(x: MathArray): MathArray;
+        acsch(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse secant of a value. For matrices, the function
+         * is evaluated element wise.
+         * @param x Function input
+         * @returns The arc secant of x
+         */
+        asec(x: number): number;
+        asec(x: BigNumber): BigNumber;
+        asec(x: MathArray): MathArray;
+        asec(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic arcsecant of a value, defined as asech(x) =
+         * ln(sqrt(1/x^2 - 1) + 1/x). For matrices, the function is evaluated
+         * element wise.
+         * @param x Function input
+         * @returns The hyperbolic arcsecant of x
+         */
+        asech(x: number): number;
+        asech(x: BigNumber): BigNumber;
+        asech(x: MathArray): MathArray;
+        asech(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse sine of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Function input
+         * @returns The arc sine of x
+         */
+        asin(x: number): number;
+        asin(x: BigNumber): BigNumber;
+        asin(x: Complex): Complex;
+        asin(x: MathArray): MathArray;
+        asin(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic arcsine of a value, defined as asinh(x) =
+         * ln(x + sqrt(x^2 + 1)). For matrices, the function is evaluated
+         * element wise.
+         * @param x Function input
+         * @returns The hyperbolic arcsine of x
+         */
+        asinh(x: number): number;
+        asinh(x: BigNumber): BigNumber;
+        asinh(x: MathArray): MathArray;
+        asinh(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse tangent of a value. For matrices, the function
+         * is evaluated element wise.
+         * @param x Function input
+         * @returns The arc tangent of x
+         */
+        atan(x: number): number;
+        atan(x: BigNumber): BigNumber;
+        atan(x: MathArray): MathArray;
+        atan(x: Matrix): Matrix;
+
+        /**
+         * Calculate the inverse tangent function with two arguments, y/x. By
+         * providing two arguments, the right quadrant of the computed angle can
+         * be determined. For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns Four quadrant inverse tangent
+         */
+        atan2(y: number, x: number): number;
+        atan2(y: MathArray | Matrix, x: MathArray | Matrix): MathArray | Matrix;
+
+        /**
+         * Calculate the hyperbolic arctangent of a value, defined as atanh(x) =
+         * ln((1 + x)/(1 - x)) / 2. For matrices, the function is evaluated
+         * element wise.
+         * @param x Function input
+         * @returns The hyperbolic arctangent of x
+         */
+        atanh(x: number): number;
+        atanh(x: BigNumber): BigNumber;
+        atanh(x: MathArray): MathArray;
+        atanh(x: Matrix): Matrix;
+
+        /**
+         * Calculate the cosine of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Function input
+         * @returns The cosine of x
+         */
+        cos(x: number | Unit): number;
+        cos(x: BigNumber): BigNumber;
+        cos(x: Complex): Complex;
+        cos(x: MathArray): MathArray;
+        cos(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic cosine of a value, defined as cosh(x) = 1/2
+         * * (exp(x) + exp(-x)). For matrices, the function is evaluated element
+         * wise.
+         * @param x Function input
+         * @returns The hyperbolic cosine of x
+         */
+        cosh(x: number | Unit): number;
+        cosh(x: BigNumber): BigNumber;
+        cosh(x: Complex): Complex;
+        cosh(x: MathArray): MathArray;
+        cosh(x: Matrix): Matrix;
+
+        /**
+         * Calculate the cotangent of a value. cot(x) is defined as 1 / tan(x).
+         * For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The cotangent of x
+         */
+        cot(x: number | Unit): number;
+        cot(x: Complex): Complex;
+        cot(x: MathArray): MathArray;
+        cot(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic cotangent of a value, defined as coth(x) = 1
+         * / tanh(x). For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The hyperbolic cotangent of x
+         */
+        coth(x: number | Unit): number;
+        coth(x: Complex): Complex;
+        coth(x: MathArray): MathArray;
+        coth(x: Matrix): Matrix;
+
+        /**
+         * Calculate the cosecant of a value, defined as csc(x) = 1/sin(x). For
+         * matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The cosecant hof x
+         */
+        csc(x: number | Unit): number;
+        csc(x: Complex): Complex;
+        csc(x: MathArray): MathArray;
+        csc(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic cosecant of a value, defined as csch(x) = 1
+         * / sinh(x). For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The hyperbolic cosecant of x
+         */
+        csch(x: number | Unit): number;
+        csch(x: Complex): Complex;
+        csch(x: MathArray): MathArray;
+        csch(x: Matrix): Matrix;
+
+        /**
+         * Calculate the secant of a value, defined as sec(x) = 1/cos(x). For
+         * matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The secant of x
+         */
+        sec(x: number | Unit): number;
+        sec(x: Complex): Complex;
+        sec(x: MathArray): MathArray;
+        sec(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic secant of a value, defined as sech(x) = 1 /
+         * cosh(x). For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The hyperbolic secant of x
+         */
+        sech(x: number | Unit): number;
+        sech(x: Complex): Complex;
+        sech(x: MathArray): MathArray;
+        sech(x: Matrix): Matrix;
+
+        /**
+         * Calculate the sine of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param x Function input
+         * @returns The sine of x
+         */
+        sin(x: number | Unit): number;
+        sin(x: BigNumber): BigNumber;
+        sin(x: Complex): Complex;
+        sin(x: MathArray): MathArray;
+        sin(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic sine of a value, defined as sinh(x) = 1/2 *
+         * (exp(x) - exp(-x)). For matrices, the function is evaluated element
+         * wise.
+         * @param x Function input
+         * @returns The hyperbolic sine of x
+         */
+        sinh(x: number | Unit): number;
+        sinh(x: BigNumber): BigNumber;
+        sinh(x: Complex): Complex;
+        sinh(x: MathArray): MathArray;
+        sinh(x: Matrix): Matrix;
+
+        /**
+         * Calculate the tangent of a value. tan(x) is equal to sin(x) / cos(x).
+         * For matrices, the function is evaluated element wise.
+         * @param x Function input
+         * @returns The tangent of x
+         */
+        tan(x: number | Unit): number;
+        tan(x: BigNumber): BigNumber;
+        tan(x: Complex): Complex;
+        tan(x: MathArray): MathArray;
+        tan(x: Matrix): Matrix;
+
+        /**
+         * Calculate the hyperbolic tangent of a value, defined as tanh(x) =
+         * (exp(2 * x) - 1) / (exp(2 * x) + 1). For matrices, the function is
+         * evaluated element wise.
+         * @param x Function input
+         * @returns The hyperbolic tangent of x
+         */
+        tanh(x: number | Unit): number;
+        tanh(x: BigNumber): BigNumber;
+        tanh(x: Complex): Complex;
+        tanh(x: MathArray): MathArray;
+        tanh(x: Matrix): Matrix;
+
+        /*************************************************************************
+         * Unit functions
+         ************************************************************************/
+
+        /**
+         * Change the unit of a value. For matrices, the function is evaluated
+         * element wise.
+         * @param x The unit to be converted.
+         * @param unit New unit. Can be a string like "cm" or a unit without
+         * value.
+         * @returns Value with changed, fixed unit
+         */
+        to(
+            x: Unit | MathArray | Matrix,
+            unit: Unit | string
+        ): Unit | MathArray | Matrix;
+
+        /*************************************************************************
+         * Utils functions
+         ************************************************************************/
+
+        /**
+         * Clone an object.
+         * @param x Object to be cloned
+         * @returns A clone of object x
+         */
+        clone(x: any): any;
+
+        /**
+         * Test whether a value is an integer number. The function supports
+         * number, BigNumber, and Fraction. The function is evaluated
+         * element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x contains a numeric, integer value.
+         * Throws an error in case of an unknown data type.
+         */
+        isInteger(
+            x: number | BigNumber | Fraction | MathArray | Matrix
+        ): boolean;
+
+        /**
+         * Test whether a value is NaN (not a number). The function supports
+         * types number, BigNumber, Fraction, Unit and Complex. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is NaN. Throws an error in case of an
+         * unknown data type.
+         */
+        isNaN(
+            x: number | BigNumber | Fraction | MathArray | Matrix | Unit
+        ): boolean;
+
+        /**
+         * Test whether a value is negative: smaller than zero. The function
+         * supports types number, BigNumber, Fraction, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is larger than zero. Throws an error in
+         * case of an unknown data type.
+         */
+        isNegative(
+            x: number | BigNumber | Fraction | MathArray | Matrix | Unit
+        ): boolean;
+
+        /**
+         * Test whether a value is an numeric value. The function is evaluated
+         * element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is a number, BigNumber, Fraction, or
+         * boolean. Returns false for other types. Throws an error in case of
+         * unknown types.
+         */
+        isNumeric(x: any): boolean;
+
+        /**
+         * Test whether a value is positive: larger than zero. The function
+         * supports types number, BigNumber, Fraction, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is larger than zero. Throws an error in
+         * case of an unknown data type.
+         */
+        isPositive(
+            x: number | BigNumber | Fraction | MathArray | Matrix | Unit
+        ): boolean;
+
+        /**
+         * Test whether a value is prime: has no divisors other than itself and
+         * one. The function supports type number, bignumber. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is larger than zero. Throws an error in
+         * case of an unknown data type.
+         */
+        isPrime(x: number | BigNumber | MathArray | Matrix): boolean;
+
+        /**
+         * Test whether a value is zero. The function can check for zero for
+         * types number, BigNumber, Fraction, Complex, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         * @param x Value to be tested
+         * @returns Returns true when x is zero. Throws an error in case of an
+         * unknown data type.
+         */
+        isZero(
+            x:
+                | number
+                | BigNumber
+                | Fraction
+                | MathArray
+                | Matrix
+                | Unit
+                | Complex
+        ): boolean;
+
+        /**
+         * Determine the type of a variable.
+         * @param x The variable for which to test the type
+         * @returns Returns the name of the type. Primitive types are lower
+         * case, non-primitive types are upper-camel-case. For example ‘number’,
+         * ‘string’, ‘Array’, ‘Date’.
+         */
+        typeof(x: any): string;
     }
 
-	interface MathJSON {
-		mathjs?: string;
-		value: number;
-		unit: string;
-		fixPrefix?: boolean;
-	}
+    interface Matrix {
+        type: string;
+        storage(): string;
+        datatype(): string;
+        create(data: MathArray, datatype?: string): void;
+        density(): number;
+        subset(index: Index, replacement?: any, defaultValue?: any): Matrix;
+        get(index: number[]): any;
+        set(
+            index: number[],
+            value: any,
+            defaultValue?: number | string
+        ): Matrix;
+        resize(
+            size: MathArray | Matrix,
+            defaultValue?: number | string
+        ): Matrix;
+        clone(): Matrix;
+        size(): number[];
+        map(
+            callback: (a: any, b: number, c: Matrix) => any,
+            skipZeros?: boolean
+        ): Matrix;
+        forEach(
+            callback: (a: any, b: number, c: Matrix) => void,
+            skipZeros?: boolean
+        ): void;
+        toArray(): MathArray | Matrix;
+        valueOff(): MathArray | Matrix;
+        format(options?: FormatOptions | number | ((value:any)=>string)): string;
+        toString(): string;
+        toJSON(): any;
+        diagonal(k?: number | BigNumber): any[];
+        swapRows(i: number, j: number): Matrix;
+    }
 
-	interface Unit {
-		to(unit: string): Unit;
-		toNumber(unit: string): number;
-    	clone(): Unit;
-		equalBase(unit: Unit): boolean;
-		equals(unit: Unit): boolean;
-		format(options: FormatOptions): string;
-		fromJSON(json: MathJSON): Unit;
-		toJSON(): MathJSON;
-		splitUnit(parts: ReadonlyArray<string>): Unit[];
-		toNumeric(unit: string): number | Fraction | BigNumber;
-		toSI(): Unit;
-		toString(): string;
-	}
+    interface BigNumber extends Decimal {} // tslint:disable-line no-empty-interface
 
-	interface CreateUnitOptions {
-		override?: boolean;
-	}
+    interface Fraction {
+        s: number;
+        n: number;
+        d: number;
+    }
 
-	interface UnitDefinition {
-		definition?: string|Unit;
-		prefixes?: string;
-		offset?: number;
-		aliases?: string[];
-	}
+    interface Complex {
+        re: number;
+        im: number;
+        clone(): Complex;
+        equals(other: Complex): boolean;
+        format(precision?: number): string;
+        fromJSON(json: object): Complex;
+        fromPolar(polar: object): Complex;
+        fromPolar(r: number, phi: number): Complex;
+        toJSON(): object;
+        toPolar(): PolarCoordinates;
+        toString(): string;
+        compare(a: Complex, b: Complex): number;
+    }
 
-	interface Index {} // tslint:disable-line no-empty-interface
+    interface PolarCoordinates {
+        r: number;
+        phi: number;
+    }
 
-	interface EvalFunction {
-		eval(scope?: any): any;
-	}
+    interface MathJSON {
+        mathjs?: string;
+        value: number;
+        unit: string;
+        fixPrefix?: boolean;
+    }
 
-	interface MathNode {
-		isNode: boolean;
-		isSymbolNode?: boolean;
-		isConstantNode?: boolean;
-		isOperatorNode?: boolean;
-		op?: string;
-		fn?: string;
-		args?: MathNode[];
-		type: string;
-		name?: string;
-		value?: any;
+    interface Unit {
+        valueOf(): string;
+        clone(): Unit;
+        isDerived(): boolean;
+        hasBase(base: any): boolean;
+        equalBase(unit: Unit): boolean;
+        equals(unit: Unit): boolean;
+        multiply(unit: Unit): Unit;
+        divide(unit: Unit): Unit;
+        pow(unit: Unit): Unit;
+        abs(unit: Unit): Unit;
+        to(unit: string): Unit;
+        toNumber(unit: string): number;
+        toNumeric(unit: string): number | Fraction | BigNumber;
+        toString(): string;
+        toJSON(): MathJSON;
+        formatUnits(): string;
+        format(options: FormatOptions): string;
+        parse(str: DOMStringList): Unit;
+        isValuelessUnit(name: string): boolean;
+        fromJSON(json: MathJSON): Unit;
+    }
 
-		compile(): EvalFunction;
-		eval(expr?: string): any;
-		/**
-		 *
-		 * Filter nodes in an expression tree. The callback function is called as callback(node: Node, path: string, parent: Node) : boolean for every node in the tree,
-		 * and must return a boolean. The function filter returns an array with nodes for which the test returned true.
-		 * Parameter path is a string containing a relative JSON Path.
-		 *
-		 * Example:
-		 *
-		 * ```
-		 * var node = math.parse('x^2 + x/4 + 3*y');
-		 * var filtered = node.filter(function (node) {
-		 * return node.isSymbolNode && node.name == 'x';
-		 * });
-		 * // returns an array with two entries: two SymbolNodes 'x'
-		 * ```
-		 *
-		 * The callback function is called as callback(node: Node, path: string, parent: Node) : boolean for every node in the tree, and must return a boolean.
-		 * The function filter returns an array with nodes for which the test returned true. Parameter path is a string containing a relative JSON Path.
-		 * @return Returns an array with nodes for which test returned true
-		 */
-		filter(callback: (node: MathNode, path: string, parent: MathNode) => any): MathNode[];
+    interface CreateUnitOptions {
+        override?: boolean;
+    }
 
-		/**
-		 * [forEach description]
-		 */
-		forEach(callback: (node: MathNode, path: string, parent: MathNode) => any): MathNode[];
+    interface UnitDefinition {
+        definition?: string | Unit;
+        prefixes?: string;
+        offset?: number;
+        aliases?: string[];
+    }
 
-		/**
-		 * `traverse(callback)`
-		 *
-		 * Recursively traverse all nodes in a node tree.
-		 * Executes given callback for this node and each of its child nodes.
-		 * Similar to Array.forEach, except recursive.
-		 * The callback function is a mapping function accepting a node, and returning a replacement for the node or the original node.
-		 * Function callback is called as callback(node: Node, path: string, parent: Node) for every node in the tree.
-		 * Parameter path is a string containing a relative JSON Path. Example:
-		 *
-		 * ```
-		 * var node = math.parse('3 * x + 2');
-		 * node.traverse(function (node, path, parent) {
-		 * switch (node.type) {
-		 * case 'OperatorNode': console.log(node.type, node.op);    break;
-		 * case 'ConstantNode': console.log(node.type, node.value); break;
-		 * case 'SymbolNode':   console.log(node.type, node.name);  break;
-		 * default:             console.log(node.type);
-		 * }
-		 * });
-		 * // outputs:
-		 * //   OperatorNode +
-		 * //   OperatorNode *
-		 * //   ConstantNode 3
-		 * //   SymbolNode x
-		 * //   ConstantNode 2
-		 * ```
-		 */
-		traverse(callback: (node: MathNode, path: string, parent: MathNode) => void): any;
-		/**
-		 * Recursively transform an expression tree via a transform function. Similar to Array.map,
-		 * but recursively executed on all nodes in the expression tree. The callback function is a
-		 * mapping function accepting a node, and returning a replacement for the node or the original node.
-		 * Function callback is called as callback(node: Node, path: string, parent: Node) for every node in
-		 * the tree, and must return a Node. Parameter path is a string containing a relative JSON Path.
-		 *
-		 * For example, to replace all nodes of type SymbolNode having name ‘x’ with a ConstantNode with value 3:
-		 * ```js
-		 * var node = math.parse('x^2 + 5*x');
-		 * var transformed = node.transform(function (node, path, parent) {
-		 *   if (node.SymbolNode && node.name == 'x') {
-		 *     return new math.expression.node.ConstantNode(3);
-		 *   }
-		 *   else {
-		 *     return node;
-		 *   }
-		 * });
-		 * transformed.toString(); // returns '(3 ^ 2) + (5 * 3)'
-		 * ```
-		 */
-		transform(callback: (node: MathNode, path: string, parent: MathNode) => MathNode): MathNode;
+    interface Index {} // tslint:disable-line no-empty-interface
 
-		/**
-		 * Transform a node. Creates a new Node having it’s child's be the results of calling the provided
-		 * callback function for each of the child's of the original node. The callback function is called
-		 * as `callback(child: Node, path: string, parent: Node)` and must return a Node.
-		 * Parameter path is a string containing a relative JSON Path.
-		 *
-		 *
-		 * See also transform, which is a recursive version of map.
-		 */
-		map(callback: (node: MathNode, path: string, parent: MathNode) => MathNode): MathNode;
-	}
+    interface EvalFunction {
+        eval(scope?: any): any;
+    }
 
-	interface Parser {
-		eval(expr: string): any;
-		get(variable: string): any;
-		set: (variable: string, value: any) => void;
-		clear: () => void;
-	}
+    interface MathNode {
+        isNode: boolean;
+        isAccessorNode?: boolean;
+        isArrayNode?: boolean;
+        isAssignmentNode?: boolean;
+        isBlockNode?: boolean;
+        isConditionalnode?: boolean;
+        isConstantNode?: boolean;
+        isFunctionAssignmentNode?: boolean;
+        isFunctionNode?: boolean;
+        isIndexNode?: boolean;
+        isObjectNode?: boolean;
+        isOperatorNode?: boolean;
+        isParenthesisNode?: boolean;
+        isRangeNode?: boolean;
+        isSymbolNode?: boolean;
+        isUpdateNode?: boolean;
+        comment?: string;
+        op?: string;
+        fn?: string;
+        args?: MathNode[];
+        type: string;
+        name?: string;
+        value?: any;
 
-	interface Distribution {
-		random(size: any, min?: any, max?: any): any;
-		randomInt(min: any, max?: any): any;
-		pickRandom(array: any): any;
-	}
+        /**
+         * Create a shallow clone of the node. The node itself is cloned, its
+         * childs are not cloned.
+         */
+        clone(): MathNode;
+        /**
+         * Create a deep clone of the node. Both the node as well as all its
+         * childs are cloned recursively.
+         */
+        cloneDeep(): MathNode;
+        /**
+         * Compile an expression into optimized JavaScript code. compile returns
+         * an object with a function eval([scope]) to evaluate. Example:
+         */
+        compile(): EvalFunction;
+        /**
+         * Compile and eval an expression, this is the equivalent of doing
+         * node.compile().eval(scope). Example:
+         */
+        eval(expr?: any): any;
+        /**
+         * Test whether this node equals an other node. Does a deep comparison
+         * of the values of both nodes.
+         */
+        equals(other: MathNode): boolean;
+        /**
+         *
+         * Filter nodes in an expression tree. The callback function is called
+         * as callback(node: MathNode, path: string, parent: MathNode) : boolean
+         * for every node in the tree, and must return a boolean. The function
+         * filter returns an array with nodes for which the test returned true.
+         * Parameter path is a string containing a relative JSON Path.
+         *
+         * Example:
+         *
+         * ```
+         * var node = math.parse('x^2 + x/4 + 3*y');
+         * var filtered = node.filter(function (node) {
+         * return node.isSymbolMathNode && node.name == 'x';
+         * });
+         * // returns an array with two entries: two SymbolMathNodes 'x'
+         * ```
+         *
+         * The callback function is called as callback(node: MathNode, path:
+         * string, parent: MathNode) : boolean for every node in the tree, and
+         * must return a boolean. The function filter returns an array with
+         * nodes for which the test returned true. Parameter path is a string
+         * containing a relative JSON Path.
+         * @return Returns an array with nodes for which test returned true
+         */
+        filter(
+            callback: (node: MathNode, path: string, parent: MathNode) => any
+        ): MathNode[];
 
-	interface FormatOptions {
-		/**
-		 * Number notation. Choose from:
-		 * 'fixed' Always use regular number notation. For example '123.40' and '14000000'
-		 * 'exponential' Always use exponential notation. For example '1.234e+2' and '1.4e+7'
-		 * 'auto' (default) Regular number notation for numbers having an absolute value between lower and upper bounds, and
-		 * uses exponential notation elsewhere. Lower bound is included, upper bound is excluded. For example '123.4' and '1.4e7'.
-		 */
-		notation?: string;
+        /**
+         * [forEach description]
+         */
+        forEach(
+            callback: (node: MathNode, path: string, parent: MathNode) => any
+        ): MathNode[];
 
-		/**
-		 * A number between 0 and 16 to round the digits of the number. In case of notations 'exponential' and 'auto',
-		 * precision defines the total number of significant digits returned and is undefined by default. In case of notation 'fixed',
-		 * precision defines the number of significant digits after the decimal point, and is 0 by default.
-		 */
-		precision?: number;
+        /**
+         * Transform a node. Creates a new MathNode having it’s child's be the
+         * results of calling the provided callback function for each of the
+         * child's of the original node. The callback function is called as
+         * `callback(child: MathNode, path: string, parent: MathNode)` and must
+         * return a MathNode. Parameter path is a string containing a relative
+         * JSON Path.
+         *
+         *
+         * See also transform, which is a recursive version of map.
+         */
+        map(
+            callback: (
+                node: MathNode,
+                path: string,
+                parent: MathNode
+            ) => MathNode
+        ): MathNode;
 
-		/**
-		 * An object containing two parameters, {number} lower and {number} upper, used by notation 'auto' to determine
-		 * when to return exponential notation. Default values are lower=1e-3 and upper=1e5. Only applicable for notation auto.
-		 */
-		exponential?: {lower: number; upper: number};
+        /**
+         * Get a HTML representation of the parsed expression.
+         */
+        toHtml(options?: object): string;
 
-		/**
-		 * Available values: 'ratio' (default) or 'decimal'. For example format(fraction(1, 3)) will output '1/3' when 'ratio'
-		 * is configured, and will output 0.(3) when 'decimal' is configured.
-		 */
-		fraction?: string;
+        /**
+         * Get a string representation of the parsed expression. This is not
+         * exactly the same as the original input.
+         */
+        toString(options?: object): string;
 
-		/**
-		 * A custom formatting function. Can be used to override the built-in notations. Function fn is called with
-		 * value as parameter and must return a string. Is useful for example to format all values inside a matrix in a particular way.
-		 */
-		fn?: (item: any) => string;
-	}
+        /**
+         * Get a LaTeX representation of the expression.
+         */
+        toTex(options?: object): string;
 
-	interface Help {
-		toString(): string;
-		toJSON(): string;
+        /**
+         * Recursively transform an expression tree via a transform function.
+         * Similar to Array.map, but recursively executed on all nodes in the
+         * expression tree. The callback function is a mapping function
+         * accepting a node, and returning a replacement for the node or the
+         * original node. Function callback is called as callback(node:
+         * MathNode, path: string, parent: MathNode) for every node in the tree,
+         * and must return a MathNode. Parameter path is a string containing a
+         * relative JSON Path.
+         *
+         * For example, to replace all nodes of type SymbolMathNode having name
+         * ‘x’ with a ConstantMathNode with value 3:
+         * ```js
+         * var node = math.parse('x^2 + 5*x');
+         * var transformed = node.transform(function (node, path, parent) {
+         *   if (node.SymbolMathNode && node.name == 'x') {
+         *     return new math.expression.node.ConstantMathNode(3);
+         *   }
+         *   else {
+         *     return node;
+         *   }
+         * });
+         * transformed.toString(); // returns '(3 ^ 2) + (5 * 3)'
+         * ```
+         */
+        transform(
+            callback: (
+                node: MathNode,
+                path: string,
+                parent: MathNode
+            ) => MathNode
+        ): MathNode;
+
+        /**
+         * `traverse(callback)`
+         *
+         * Recursively traverse all nodes in a node tree. Executes given
+         * callback for this node and each of its child nodes. Similar to
+         * Array.forEach, except recursive. The callback function is a mapping
+         * function accepting a node, and returning a replacement for the node
+         * or the original node. Function callback is called as callback(node:
+         * MathNode, path: string, parent: MathNode) for every node in the tree.
+         * Parameter path is a string containing a relative JSON Path. Example:
+         *
+         * ```
+         * var node = math.parse('3 * x + 2');
+         * node.traverse(function (node, path, parent) {
+         * switch (node.type) {
+         * case 'OperatorMathNode': console.log(node.type, node.op);    break;
+         * case 'ConstantMathNode': console.log(node.type, node.value); break;
+         * case 'SymbolMathNode':   console.log(node.type, node.name);  break;
+         * default:             console.log(node.type);
+         * }
+         * });
+         * // outputs:
+         * //   OperatorMathNode +
+         * //   OperatorMathNode *
+         * //   ConstantMathNode 3
+         * //   SymbolMathNode x
+         * //   ConstantMathNode 2
+         * ```
+         */
+        traverse(
+            callback: (node: MathNode, path: string, parent: MathNode) => void
+        ): any;
+    }
+
+    interface Parser {
+        eval(expr: string): any;
+        get(variable: string): any;
+        set: (variable: string, value: any) => void;
+        clear: () => void;
+    }
+
+    interface Distribution {
+        random(size: any, min?: any, max?: any): any;
+        randomInt(min: any, max?: any): any;
+        pickRandom(array: any): any;
+    }
+
+    interface FormatOptions {
+        /**
+         * Number notation. Choose from: 'fixed' Always use regular number
+         * notation. For example '123.40' and '14000000' 'exponential' Always
+         * use exponential notation. For example '1.234e+2' and '1.4e+7' 'auto'
+         * (default) Regular number notation for numbers having an absolute
+         * value between lower and upper bounds, and uses exponential notation
+         * elsewhere. Lower bound is included, upper bound is excluded. For
+         * example '123.4' and '1.4e7'.
+         */
+        notation?: "fixed" | "exponential" | "engineering" | "auto";
+
+        /**
+         * A number between 0 and 16 to round the digits of the number. In case
+         * of notations 'exponential' and 'auto', precision defines the total
+         * number of significant digits returned and is undefined by default. In
+         * case of notation 'fixed', precision defines the number of significant
+         * digits after the decimal point, and is 0 by default.
+         */
+        precision?: number;
+
+        /**
+         * Exponent determining the lower boundary for formatting a value with
+         * an exponent when notation='auto. Default value is -3.
+         */
+        lowerExp?: number;
+
+        /**
+         * Exponent determining the upper boundary for formatting a value with
+         * an exponent when notation='auto. Default value is 5.
+         */
+        upperExp?: number;
+
+        /**
+         * Available values: 'ratio' (default) or 'decimal'. For example
+         * format(fraction(1, 3)) will output '1/3' when 'ratio' is configured,
+         * and will output 0.(3) when 'decimal' is configured.
+         */
+        fraction?: string;
+    }
+
+    interface Help {
+        toString(): string;
+        toJSON(): string;
     }
 
     interface MathJsChain {
-		/**
-		 * Solves the linear equation system by forwards substitution. Matrix must be a lower triangular matrix.
-		 * @param b A column vector with the b values
-		 */
-		lsolve(b: Matrix|MathArray): MathJsChain;
+        done(): any;
 
-		/**
-		 * Calculate the Matrix LU decomposition with partial pivoting. Matrix A is decomposed in two matrices (L, U)
-		 * and a row permutation vector p where A[p,:] = L * U
-		 */
-		lup(): MathJsChain;
+        /*************************************************************************
+         * Construction functions
+         ************************************************************************/
 
-		/**
-		 * Solves the linear system A * x = b where A is an [n x n] matrix and b is a [n] column vector.
-		 * @param b Column Vector
-		 */
-		lusolve(b: Matrix|MathArray): MathJsChain;
+        /**
+         * Create a BigNumber, which can store numbers with arbitrary precision.
+         * When a matrix is provided, all elements will be converted to
+         * BigNumber.
+         */
+        bignumber(): MathJsChain;
 
-		/**
-		 * Calculate the Sparse Matrix LU decomposition with full pivoting. Sparse Matrix A is decomposed in
-		 * two matrices (L, U) and two permutation vectors (pinv, q) where P * A * Q = L * U
-		 * @param order The Symbolic Ordering and Analysis order: 0 - Natural ordering, no permutation vector q is
-		 * returned 1 - Matrix must be square, symbolic ordering and analysis is performed on M = A + A' 2 - Symbolic
-		 * ordering and analysis is performed on M = A' * A. Dense columns from A' are dropped, A recreated from A'.
-		 * This is appropriate for LU factorization of non-symmetric matrices. 3 - Symbolic ordering and analysis is performed
-		 * on M = A' * A. This is best used for LU factorization is matrix M has no dense rows. A dense row is a row with
-		 * more than 10*sqr(columns) entries.
-		 * @param threshold Partial pivoting threshold (1 for partial pivoting)
-		 * @returns The lower triangular matrix, the upper triangular matrix and the permutation vectors.
-		 */
-		slu(order: number, threshold: number): MathJsChain;
+        /**
+         * Create a boolean or convert a string or number to a boolean. In case
+         * of a number, true is returned for non-zero numbers, and false in case
+         * of zero. Strings can be 'true' or 'false', or can contain a number.
+         * When value is a matrix, all elements will be converted to boolean.
+         */
+        boolean(): MathJsChain;
 
-		/**
-		 * Solves the linear equation system by backward substitution. Matrix must be an upper triangular matrix. U * x = b
-		 * @param b A column vector with the b values
-		 * @returns A column vector with the linear system solution (x)
-		 */
-		usolve(b: Matrix|MathArray): MathJsChain;
+        /**
+         * Create a complex value or convert a value to a complex value.
+         */
+        complex(): MathJsChain;
+        /**
+         * @param im Argument specifying the imaginary part of the complex
+         * number
+         */
+        complex(im: number): MathJsChain;
 
-		/**
-		 * Calculate the absolute value of a number. For matrices, the function is evaluated element wise.
-		 */
-		abs(): MathJsChain;
+        /**
+         * Create a user-defined unit and register it with the Unit type.
+         * @param definition Definition of the unit in terms of existing units.
+         * For example, ‘0.514444444 m / s’.
+         * @param options (optional) An object containing any of the following
+         * properties:</br>- prefixes {string} “none”, “short”, “long”,
+         * “binary_short”, or “binary_long”. The default is “none”.</br>-
+         * aliases {Array} Array of strings. Example: [‘knots’, ‘kt’,
+         * ‘kts’]</br>- offset {Numeric} An offset to apply when converting from
+         * the unit. For example, the offset for celsius is 273.15. Default is
+         * 0.
+         */
+        createUnit(
+            definition?: string | UnitDefinition,
+            options?: CreateUnitOptions
+        ): MathJsChain;
+        /**
+         * Create a user-defined unit and register it with the Unit type.
+         * @param options (optional) An object containing any of the following
+         * properties:</br>- prefixes {string} “none”, “short”, “long”,
+         * “binary_short”, or “binary_long”. The default is “none”.</br>-
+         * aliases {Array} Array of strings. Example: [‘knots’, ‘kt’,
+         * ‘kts’]</br>- offset {Numeric} An offset to apply when converting from
+         * the unit. For example, the offset for celsius is 273.15. Default is
+         * 0.
+         */
+        createUnit(options?: CreateUnitOptions): MathJsChain;
 
-		/**
-		 * Add two values, x + y. For matrices, the function is evaluated element wise.
-		 * @param y Second value to add
-		 */
-		add(y: MathType): MathJsChain;
+        /**
+         * Create a fraction convert a value to a fraction.
+         * @param denominator Argument specifying the denominator of the
+         * fraction
+         */
+        fraction(
+            denominator?: number | string | MathArray | Matrix
+        ): MathJsChain;
 
-		/**
-		 * Calculate the cubic root of a value. For matrices, the function is evaluated element wise.
-		 * @param allRoots Optional, false by default. Only applicable when x is a number or complex number. If true, all complex roots are returned, if false (default) the principal root is returned.
-		 */
-		cbrt(allRoots?: boolean): MathJsChain;
+        /**
+         * Create an index. An Index can store ranges having start, step, and
+         * end for multiple dimensions. Matrix.get, Matrix.set, and math.subset
+         * accept an Index as input.
+         */
+        index(): MathJsChain;
 
-		/**
-		 * Round a value towards plus infinity If x is complex, both real and imaginary part are rounded towards plus infinity. For matrices, the function is evaluated element wise.
-		 */
-		ceil(): MathJsChain;
+        /**
+         * Create a Matrix. The function creates a new math.type.Matrix object
+         * from an Array. A Matrix has utility functions to manipulate the data
+         * in the matrix, like getting the size and getting or setting values in
+         * the matrix. Supported storage formats are 'dense' and 'sparse'.
+         */
+        matrix(format?: "sparse" | "dense", dataType?: string): MathJsChain;
 
-		/**
-		 * Compute the cube of a value, x * x * x. For matrices, the function is evaluated element wise.
-		 */
-		cube(): MathJsChain;
+        /**
+         * Create a number or convert a string, boolean, or unit to a number.
+         * When value is a matrix, all elements will be converted to number.
+         * @param valuelessUnit A valueless unit, used to convert a unit to a
+         * number
+         */
+        number(valuelessUnit?: Unit | string): MathJsChain;
 
-		/**
-		 * Divide two values, x / y. To divide matrices, x is multiplied with the inverse of y: x * inv(y).
-		 * @param y Denominator
-		 */
-		divide(y: MathType): MathJsChain;
+        /**
+         * Create a Sparse Matrix. The function creates a new math.type.Matrix
+         * object from an Array. A Matrix has utility functions to manipulate
+         * the data in the matrix, like getting the size and getting or setting
+         * values in the matrix.
+         * @param dataType Sparse Matrix data type
+         */
+        sparse(dataType?: string): MathJsChain;
 
-		/**
-		 * Divide two matrices element wise. The function accepts both matrices and scalar values.
-		 * @param y Denominator
-		 */
-		dotDivide(y: MathType): MathJsChain;
+        /**
+         * Split a unit in an array of units whose sum is equal to the original
+         * unit.
+         * @param parts An array of strings or valueless units
+         */
+        splitUnit(parts: Unit[]): MathJsChain;
 
-		/**
-		 * Multiply two matrices element wise. The function accepts both matrices and scalar values.
-		 * @param y Right hand value
-		 */
-		dotMultiply(y: MathType): MathJsChain;
+        /**
+         * Create a string or convert any object into a string. Elements of
+         * Arrays and Matrices are processed element wise.
+         */
+        string(): MathJsChain;
 
-		/**
-		 * Calculates the power of x to y element wise.
-		 * @param y The exponent
-		 */
-		dotPow(y: MathType): MathJsChain;
+        /**
+         * Create a unit. Depending on the passed arguments, the function will
+         * create and return a new math.type.Unit object. When a matrix is
+         * provided, all elements will be converted to units.
+         * @param unit The unit to be created
+         */
+        unit(unit?: string): MathJsChain;
 
-		/**
-		 * Calculate the exponent of a value. For matrices, the function is evaluated element wise.
-		 */
-		exp(): MathJsChain;
+        /*************************************************************************
+         * Expression functions
+         ************************************************************************/
 
-		/**
-		 * Round a value towards zero. For matrices, the function is evaluated element wise.
-		 */
-		fix(): MathJsChain;
+        /**
+         * Parse and compile an expression. Returns a an object with a function
+         * eval([scope]) to evaluate the compiled expression.
+         */
+        compile(): MathJsChain;
 
-		/**
-		 * Round a value towards minus infinity. For matrices, the function is evaluated element wise.
-		 */
-		floor(): MathJsChain;
+        /**
+         * Evaluate an expression.
+         * @param scope Scope to read/write variables
+         */
+        eval(scope?: object): MathJsChain;
 
-		/**
-		 * Calculate the greatest common divisor for two or more values or arrays. For matrices, the function is evaluated element wise.
-		 */
-		gcd(...args: number[]): MathJsChain;
-		gcd(...args: BigNumber[]): MathJsChain ;
-		gcd(...args: Fraction[]): MathJsChain ;
-		gcd(...args: MathArray[]): MathJsChain ;
-		gcd(...args: Matrix[]): MathJsChain;
+        /**
+         * Retrieve help on a function or data type. Help files are retrieved
+         * from the documentation in math.expression.docs.
+         */
+        help(): MathJsChain;
 
-		/**
-		 * Calculate the hypotenuse of a list with values. The hypotenuse is defined as:
-		 * hypot(a, b, c, ...) = sqrt(a^2 + b^2 + c^2 + ...)
-		 * For matrix input, the hypotenuse is calculated for all values in the matrix.
-		 */
-		hypot(...args: number[]): MathJsChain;
-		hypot(...args: BigNumber[]): MathJsChain;
+        /**
+         * Parse an expression. Returns a node tree, which can be evaluated by
+         * invoking node.eval();
+         * @param options Available options: nodes - a set of custome nodes
+         */
+        parse(options?: any): MathJsChain;
+        /**
+         * @param options Available options: nodes - a set of custome nodes
+         */
+        parse(options?: any): MathJsChain;
+
+        /**
+         * Create a parser. The function creates a new math.expression.Parser
+         * object.
+         */
+        parser(): MathJsChain;
+
+        /*************************************************************************
+         * Algebra functions
+         ************************************************************************/
+        /**
+         * @param variable The variable over which to differentiate
+         * @param options There is one option available, simplify, which is true
+         * by default. When false, output will not be simplified.
+         */
+        derivative(variable: MathNode | string, options?: object): MathJsChain;
+
+        /**
+         * Solves the linear equation system by forwards substitution. Matrix
+         * must be a lower triangular matrix.
+         * @param b A column vector with the b values
+         */
+        lsolve(b: Matrix | MathArray): MathJsChain;
+
+        /**
+         * Calculate the Matrix LU decomposition with partial pivoting. Matrix A
+         * is decomposed in two matrices (L, U) and a row permutation vector p
+         * where A[p,:] = L * U
+         */
+        lup(): MathJsChain;
+
+        /**
+         * Solves the linear system A * x = b where A is an [n x n] matrix and b
+         * is a [n] column vector.
+         * @param b Column Vector
+         * @param order The Symbolic Ordering and Analysis order, see slu for
+         * details. Matrix must be a SparseMatrix
+         * @param threshold Partial pivoting threshold (1 for partial pivoting),
+         * see slu for details. Matrix must be a SparseMatrix.
+         */
+        lusolve(
+            b: Matrix | MathArray,
+            order?: number,
+            threshold?: number
+        ): MathJsChain;
+
+        /**
+         * Calculate the Matrix QR decomposition. Matrix A is decomposed in two
+         * matrices (Q, R) where Q is an orthogonal matrix and R is an upper
+         * triangular matrix.
+         */
+        qr(): MathJsChain;
+
+        /**
+         * Transform a rationalizable expression in a rational fraction. If
+         * rational fraction is one variable polynomial then converts the
+         * numerator and denominator in canonical form, with decreasing
+         * exponents, returning the coefficients of numerator.
+         * @param optional scope of expression or true for already evaluated
+         * rational expression at input
+         * @param detailed  optional True if return an object, false if return
+         * expression node (default)
+         */
+        rationalize(optional: object | boolean, detailed: boolean): MathJsChain;
+
+        /**
+         * Simplify an expression tree.
+         * @param rules A list of rules are applied to an expression, repeating
+         * over the list until no further changes are made. It’s possible to
+         * pass a custom set of rules to the function as second argument. A rule
+         * can be specified as an object, string, or function.
+         * @param scope Scope to variables
+         */
+        simplify(
+            rules?: ({ l: string; r: string } | string | ((node: MathNode) => MathNode))[],
+            scope?: object
+        ): MathJsChain;
+
+        /**
+         * Calculate the Sparse Matrix LU decomposition with full pivoting.
+         * Sparse Matrix A is decomposed in two matrices (L, U) and two
+         * permutation vectors (pinv, q) where P * A * Q = L * U
+         * @param order The Symbolic Ordering and Analysis order: 0 - Natural
+         * ordering, no permutation vector q is returned 1 - Matrix must be
+         * square, symbolic ordering and analisis is performed on M = A + A' 2 -
+         * Symbolic ordering and analysis is performed on M = A' * A. Dense
+         * columns from A' are dropped, A recreated from A'. This is appropriate
+         * for LU factorization of non-symmetric matrices. 3 - Symbolic ordering
+         * and analysis is performed on M = A' * A. This is best used for LU
+         * factorization is matrix M has no dense rows. A dense row is a row
+         * with more than 10*sqr(columns) entries.
+         * @param threshold Partial pivoting threshold (1 for partial pivoting)
+         */
+        slu(order: number, threshold: number): MathJsChain;
+
+        /**
+         * Solves the linear equation system by backward substitution. Matrix
+         * must be an upper triangular matrix. U * x = b
+         * @param b A column vector with the b values
+         */
+        usolve(b: Matrix | MathArray): MathJsChain;
+
+        /*************************************************************************
+         * Arithmetic functions
+         ************************************************************************/
+
+        /**
+         * Calculate the absolute value of a number. For matrices, the function
+         * is evaluated element wise.
+         */
+        abs(): MathJsChain;
+
+        /**
+         * Add two values, x + y. For matrices, the function is evaluated
+         * element wise.
+         * @param y Second value to add
+         */
+        add(y: MathType): MathJsChain;
+
+        /**
+         * Calculate the cubic root of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param allRoots Optional, false by default. Only applicable when x is
+         * a number or complex number. If true, all complex roots are returned,
+         * if false (default) the principal root is returned.
+         */
+        cbrt(allRoots?: boolean): MathJsChain;
+
+        /**
+         * Round a value towards plus infinity If x is complex, both real and
+         * imaginary part are rounded towards plus infinity. For matrices, the
+         * function is evaluated element wise.
+         */
+        ceil(): MathJsChain;
+
+        /**
+         * Compute the cube of a value, x * x * x. For matrices, the function is
+         * evaluated element wise.
+         */
+        cube(): MathJsChain;
+
+        /**
+         * Divide two values, x / y. To divide matrices, x is multiplied with
+         * the inverse of y: x * inv(y).
+         * @param y Denominator
+         */
+        divide(y: Unit): MathJsChain;
+        divide(y: number): MathJsChain;
+        divide(y: MathType): MathJsChain;
+
+        /**
+         * Divide two matrices element wise. The function accepts both matrices
+         * and scalar values.
+         * @param y Denominator
+         */
+        dotDivide(y: MathType): MathJsChain;
+
+        /**
+         * Multiply two matrices element wise. The function accepts both
+         * matrices and scalar values.
+         * @param y Right hand value
+         */
+        dotMultiply(y: MathType): MathJsChain;
+
+        /**
+         * Calculates the power of x to y element wise.
+         * @param y The exponent
+         */
+        dotPow(y: MathType): MathJsChain;
+
+        /**
+         * Calculate the exponent of a value. For matrices, the function is
+         * evaluated element wise.
+         */
+        exp(): MathJsChain;
+
+        /**
+         * Calculate the value of subtracting 1 from the exponential value. For
+         * matrices, the function is evaluated element wise.
+         */
+        expm1(): MathJsChain;
+
+        /**
+         * Round a value towards zero. For matrices, the function is evaluated
+         * element wise.
+         */
+        fix(): MathJsChain;
+
+        /**
+         * Round a value towards minus infinity. For matrices, the function is
+         * evaluated element wise.
+         */
+        floor(): MathJsChain;
+
+        /**
+         * Calculate the greatest common divisor for two or more values or
+         * arrays. For matrices, the function is evaluated element wise.
+         */
+        gcd(): MathJsChain;
+
+        /**
+         * Calculate the hypotenusa of a list with values. The hypotenusa is
+         * defined as: hypot(a, b, c, ...) = sqrt(a^2 + b^2 + c^2 + ...) For
+         * matrix input, the hypotenusa is calculated for all values in the
+         * matrix.
+         */
+        hypot(): MathJsChain;
+
+        /**
+         * Calculate the least common multiple for two or more values or arrays.
+         * lcm is defined as: lcm(a, b) = abs(a * b) / gcd(a, b) For matrices,
+         * the function is evaluated element wise.
+         * @param b An integer number
+         */
+        lcm(b: number): MathJsChain;
+        lcm(b: BigNumber): MathJsChain;
+        lcm(b: MathArray): MathJsChain;
+        lcm(b: Matrix): MathJsChain;
+
+        /**
+         * Calculate the logarithm of a value. For matrices, the function is
+         * evaluated element wise.
+         * @param base Optional base for the logarithm. If not provided, the
+         * natural logarithm of x is calculated. Default value: e.
+         */
+        log(base?: number | BigNumber | Complex): MathJsChain;
+
+        /**
+         * Calculate the 10-base of a value. This is the same as calculating
+         * log(x, 10). For matrices, the function is evaluated element wise.
+         */
+        log10(): MathJsChain;
+
+        /**
+         * Calculate the logarithm of a value+1. For matrices, the function is
+         * evaluated element wise.
+         */
+        log1p(base?: number | BigNumber | Complex): MathJsChain;
+        log1p(base?: number | BigNumber | Complex): MathJsChain;
+        log1p(base?: number | BigNumber | Complex): MathJsChain;
+        log1p(base?: number | BigNumber | Complex): MathJsChain;
+        log1p(base?: number | BigNumber | Complex): MathJsChain;
+
+        /**
+         * Calculate the 2-base of a value. This is the same as calculating
+         * log(x, 2). For matrices, the function is evaluated element wise.
+         */
+        log2(): MathJsChain;
+        /**
+         * Calculates the modulus, the remainder of an integer division. For
+         * matrices, the function is evaluated element wise. The modulus is
+         * defined as: x - y * floor(x / y)
+         * @see http://en.wikipedia.org/wiki/Modulo_operation.
+         * @param y Divisor
+         */
+        mod(y: number | BigNumber | Fraction | MathArray | Matrix): MathJsChain;
+
+        /**
+         * Multiply two values, x * y. The result is squeezed. For matrices, the
+         * matrix product is calculated.
+         * @param y The second value to multiply
+         */
+        multiply(y: MathType): MathJsChain;
+        multiply(y: Unit): MathJsChain;
+        multiply(y: number): MathJsChain;
+        multiply(y: MathType): MathJsChain;
+
+        /**
+         * Calculate the norm of a number, vector or matrix. The second
+         * parameter p is optional. If not provided, it defaults to 2.
+         * @param p Vector space. Supported numbers include Infinity and
+         * -Infinity. Supported strings are: 'inf', '-inf', and 'fro' (The
+         * Frobenius norm) Default value: 2.
+         */
+        norm(p?: number | BigNumber | string): MathJsChain;
+
+        /**
+         * Calculate the nth root of a value. The principal nth root of a
+         * positive real number A, is the positive real solution of the equation
+         * x^root = A For matrices, the function is evaluated element wise.
+         * @param root The root. Default value: 2.
+         */
+        nthRoot(root?: number | BigNumber): MathJsChain;
+
+        /**
+         * Calculates the power of x to y, x ^ y. Matrix exponentiation is
+         * supported for square matrices x, and positive integer exponents y.
+         * @param y The exponent
+         */
+        pow(): MathJsChain;
+
+        /**
+         * Round a value towards the nearest integer. For matrices, the function
+         * is evaluated element wise.
+         * @param n Number of decimals Default value: 0.
+         */
+        round(n?: number | BigNumber | MathArray): MathJsChain;
+
+        /**
+         * Compute the sign of a value. The sign of a value x is: 1 when x > 1
+         * -1 when x < 0 0 when x == 0 For matrices, the function is evaluated
+         * element wise.
+         * @param x The number for which to determine the sign
+         * @returns The sign of x
+         */
+        sign(): MathJsChain;
+
+        /**
+         * Calculate the square root of a value. For matrices, the function is
+         * evaluated element wise.
+         */
+        sqrt(): MathJsChain;
+
+        /**
+         * Compute the square of a value, x * x. For matrices, the function is
+         * evaluated element wise.
+         */
+        square(): MathJsChain;
+
+        /**
+         * Subtract two values, x - y. For matrices, the function is evaluated
+         * element wise.
+         * @param y Value to subtract from x
+         */
+        subtract(y: MathType): MathJsChain;
+
+        /**
+         * Inverse the sign of a value, apply a unary minus operation. For
+         * matrices, the function is evaluated element wise. Boolean values and
+         * strings will be converted to a number. For complex numbers, both real
+         * and complex value are inverted.
+         */
+        unaryMinus(): MathJsChain;
+
+        /**
+         * Unary plus operation. Boolean values and strings will be converted to
+         * a number, numeric values will be returned as is. For matrices, the
+         * function is evaluated element wise.
+         */
+        unaryPlus(): MathJsChain;
+
+        /**
+         * Calculate the extended greatest common divisor for two values. See
+         * http://en.wikipedia.org/wiki/Extended_Euclidean_algorithm.
+         * @param b An integer number
+         */
+        xgcd(b: number | BigNumber): MathJsChain;
+
+        /*************************************************************************
+         * Bitwise functions
+         ************************************************************************/
+
+        /**
+         * Bitwise AND two values, x & y. For matrices, the function is
+         * evaluated element wise.
+         * @param y Second value to and
+         */
+        bitAnd(y: number | BigNumber | MathArray | Matrix): MathJsChain;
+
+        /**
+         * Bitwise NOT value, ~x. For matrices, the function is evaluated
+         * element wise. For units, the function is evaluated on the best prefix
+         * base.
+         */
+        bitNot(): MathJsChain;
+
+        /**
+         * Bitwise OR two values, x | y. For matrices, the function is evaluated
+         * element wise. For units, the function is evaluated on the lowest
+         * print base.
+         * @param y Second value to or
+         */
+        bitOr(y: number): MathJsChain;
+        bitOr(y: BigNumber): MathJsChain;
+        bitOr(y: MathArray): MathJsChain;
+        bitOr(y: Matrix): MathJsChain;
+
+        /**
+         * Bitwise XOR two values, x ^ y. For matrices, the function is
+         * evaluated element wise.
+         * @param y Second value to xor
+         */
+        bitXor(y: number | BigNumber | MathArray | Matrix): MathJsChain;
+
+        /**
+         * Bitwise left logical shift of a value x by y number of bits, x << y.
+         * For matrices, the function is evaluated element wise. For units, the
+         * function is evaluated on the best prefix base.
+         * @param y Amount of shifts
+         */
+        leftShift(y: number | BigNumber): MathJsChain;
+
+        /**
+         * Bitwise right arithmetic shift of a value x by y number of bits, x >>
+         * y. For matrices, the function is evaluated element wise. For units,
+         * the function is evaluated on the best prefix base.
+         * @param y Amount of shifts
+         */
+        rightArithShift(y: number | BigNumber): MathJsChain;
+
+        /**
+         * Bitwise right logical shift of value x by y number of bits, x >>> y.
+         * For matrices, the function is evaluated element wise. For units, the
+         * function is evaluated on the best prefix base.
+         * @param y Amount of shifts
+         */
+        rightLogShift(y: number): MathJsChain;
+
+        /*************************************************************************
+         * Combinatorics functions
+         ************************************************************************/
+
+        /**
+         * The Bell Numbers count the number of partitions of a set. A partition
+         * is a pairwise disjoint subset of S whose union is S. bellNumbers only
+         * takes integer arguments. The following condition must be enforced: n
+         * >= 0
+         */
+        bellNumbers(): MathJsChain;
+
+        /**
+         * The Catalan Numbers enumerate combinatorial structures of many
+         * different types. catalan only takes integer arguments. The following
+         * condition must be enforced: n >= 0
+         */
+        catalan(): MathJsChain;
+
+        /**
+         * The composition counts of n into k parts. Composition only takes
+         * integer arguments. The following condition must be enforced: k <= n.
+         * @param k Number of objects in the subset
+         */
+        composition(k: number | BigNumber): MathJsChain;
+
+        /**
+         * The Stirling numbers of the second kind, counts the number of ways to
+         * partition a set of n labelled objects into k nonempty unlabelled
+         * subsets. stirlingS2 only takes integer arguments. The following
+         * condition must be enforced: k <= n. If n = k or k = 1, then s(n,k) =
+         * 1
+         * @param k Number of objects in the subset
+         */
+        stirlingS2(k: number | BigNumber): MathJsChain;
+
+        /*************************************************************************
+         * Complex functions
+         ************************************************************************/
+
+        /**
+         * Compute the argument of a complex value. For a complex number a + bi,
+         * the argument is computed as atan2(b, a). For matrices, the function
+         * is evaluated element wise.
+         */
+        arg(): MathJsChain;
+
+        /**
+         * Compute the complex conjugate of a complex value. If x = a+bi, the
+         * complex conjugate of x is a - bi. For matrices, the function is
+         * evaluated element wise.
+         */
+        conj(): MathJsChain;
+
+        /**
+         * Get the imaginary part of a complex number. For a complex number a +
+         * bi, the function returns b. For matrices, the function is evaluated
+         * element wise.
+         */
+        im(): MathJsChain;
+
+        /**
+         * Get the real part of a complex number. For a complex number a + bi,
+         * the function returns a. For matrices, the function is evaluated
+         * element wise.
+         */
+        re(): MathJsChain;
+
+        /*************************************************************************
+         * Geometry functions
+         ************************************************************************/
+
+        /**
+         * Calculates: The eucledian distance between two points in 2 and 3
+         * dimensional spaces. Distance between point and a line in 2 and 3
+         * dimensional spaces. Pairwise distance between a set of 2D or 3D
+         * points NOTE: When substituting coefficients of a line(a, b and c),
+         * use ax + by + c = 0 instead of ax + by = c For parametric equation of
+         * a 3D line, x0, y0, z0, a, b, c are from: (x−x0, y−y0, z−z0) = t(a, b,
+         * c)
+         * @param y Coordinates of the second point
+         */
+        distance(y: MathArray | Matrix | Object): MathJsChain;
+
+        /**
+         * Calculates the point of intersection of two lines in two or three
+         * dimensions and of a line and a plane in three dimensions. The inputs
+         * are in the form of arrays or 1 dimensional matrices. The line
+         * intersection functions return null if the lines do not meet. Note:
+         * Fill the plane coefficients as x + y + z = c and not as x + y + z + c
+         * = 0.
+         * @param x Co-ordinates of second end-point of first line
+         * @param y Co-ordinates of first end-point of second line OR
+         * Coefficients of the plane's equation
+         * @param z Co-ordinates of second end-point of second line OR null if
+         * the calculation is for line and plane
+         */
+        intersect(
+            x: MathArray | Matrix,
+            y: MathArray | Matrix,
+            z: MathArray | Matrix
+        ): MathJsChain;
+
+        /*************************************************************************
+         * Logical functions
+         ************************************************************************/
+
+        /**
+         * Logical and. Test whether two values are both defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param y Second value to and
+         */
+        and(
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): MathJsChain;
+
+        /**
+         * Logical not. Flips boolean value of a given parameter. For matrices,
+         * the function is evaluated element wise.
+         */
+        not(): MathJsChain;
+
+        /**
+         * Logical or. Test if at least one value is defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param y Second value to or
+         */
+        or(
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): MathJsChain;
+
+        /**
+         * Logical xor. Test whether one and only one value is defined with a
+         * nonzero/nonempty value. For matrices, the function is evaluated
+         * element wise.
+         * @param y Second value to xor
+         */
+        xor(
+            y: number | BigNumber | Complex | Unit | MathArray | Matrix
+        ): MathJsChain;
+
+        /*************************************************************************
+         * Matrix functions
+         ************************************************************************/
+
+        /**
+         * Concatenate two or more matrices. dim: number is a zero-based
+         * dimension over which to concatenate the matrices. By default the last
+         * dimension of the matrices.
+         */
+        concat(): MathJsChain;
+
+        /**
+         * Calculate the cross product for two vectors in three dimensional
+         * space. The cross product of A = [a1, a2, a3] and B =[b1, b2, b3] is
+         * defined as: cross(A, B) = [ a2 * b3 - a3 * b2, a3 * b1 - a1 * b3, a1
+         * * b2 - a2 * b1 ]
+         * @param y Second vector
+         */
+        cross(y: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Calculate the determinant of a matrix.
+         */
+        det(): MathJsChain;
+
+        /**
+         * Create a diagonal matrix or retrieve the diagonal of a matrix. When x
+         * is a vector, a matrix with vector x on the diagonal will be returned.
+         * When x is a two dimensional matrix, the matrixes kth diagonal will be
+         * returned as vector. When k is positive, the values are placed on the
+         * super diagonal. When k is negative, the values are placed on the sub
+         * diagonal.
+         * @param k The diagonal where the vector will be filled in or
+         * retrieved. Default value: 0.
+         * @param format The matrix storage format. Default value: 'dense'.
+         */
+        diag(format?: string): MathJsChain;
+        diag(k: number | BigNumber, format?: string): MathJsChain;
+
+        /**
+         * Calculate the dot product of two vectors. The dot product of A = [a1,
+         * a2, a3, ..., an] and B = [b1, b2, b3, ..., bn] is defined as: dot(A,
+         * B) = a1 * b1 + a2 * b2 + a3 * b3 + ... + an * bn
+         * @param y Second vector
+         */
+        dot(y: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Compute the matrix exponential, expm(A) = e^A. The matrix must be
+         * square. Not to be confused with exp(a), which performs element-wise
+         * exponentiation. The exponential is calculated using the Padé
+         * approximant with scaling and squaring; see “Nineteen Dubious Ways to
+         * Compute the Exponential of a Matrix,” by Moler and Van Loan.
+         */
+        expm(): MathJsChain;
+
+        /**
+         * Create a 2-dimensional identity matrix with size m x n or n x n. The
+         * matrix has ones on the diagonal and zeros elsewhere.
+         * @param format The Matrix storage format
+         */
+        eye(format?: string): MathJsChain;
+        /**
+         * @param n The y dimension for the matrix
+         * @param format The Matrix storage format
+         */
+        eye(n: number, format?: string): MathJsChain;
+
+        /**
+         * Filter the items in an array or one dimensional matrix.
+         */
+        filter(test: ((value:any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray)| RegExp): MathJsChain;
+
+        /**
+         * Flatten a multi dimensional matrix into a single dimensional matrix.
+         */
+        flatten(): MathJsChain;
+
+        /**
+         * Iterate over all elements of a matrix/array, and executes the given
+         * callback function.
+         */
+        forEach(callback: ((value:any, index: any, matrix: Matrix | MathArray)=>void)): MathJsChain;
+
+        /**
+         * Calculate the inverse of a square matrix.
+         */
+        inv(): MathJsChain;
 
         /**
          * Calculate the kronecker product of two matrices or vectors
-         * @param x First Matrix
-         * @param y Second Matrix
+         * @param y Second vector
          */
-        kron(x: Matrix|MathArray, y: Matrix|MathArray): MathJsChain;
-
-		/**
-		 * Calculate the least common multiple for two or more values or arrays. lcm is defined as:
-		 * lcm(a, b) = abs(a * b) / gcd(a, b)
-		 * For matrices, the function is evaluated element wise.
-		 */
-		lcm(b: number|BigNumber|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Calculate the logarithm of a value. For matrices, the function is evaluated element wise.
-		 * @param base Optional base for the logarithm. If not provided, the natural logarithm of x is calculated. Default value: e.
-		 */
-		log(base?: number|BigNumber|Complex): MathJsChain;
-
-		/**
-		 * Calculate the 10-base of a value. This is the same as calculating log(x, 10). For matrices, the function is evaluated element wise.
-		 */
-		log10(): MathJsChain;
-
-		/**
-		 * Calculates the modulus, the remainder of an integer division. For matrices, the function is evaluated element wise.
-		 * The modulus is defined as:
-		 * x - y * floor(x / y)
-		 * @see http://en.wikipedia.org/wiki/Modulo_operation.
-		 * @param y Divisor
-		 */
-		mod(y: number|BigNumber|Fraction|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Multiply two values, x * y. The result is squeezed. For matrices, the matrix product is calculated.
-		 */
-		multiply(y: MathType): MathJsChain;
-
-		/**
-		 * Calculate the norm of a number, vector or matrix. The second parameter p is optional. If not provided, it defaults to 2.
-		 * @param p Vector space. Supported numbers include Infinity and -Infinity. Supported strings are: 'inf', '-inf', and 'fro' (The Frobenius norm) Default value: 2.
-		 */
-		norm(p?: number|BigNumber|string): MathJsChain;
-
-		/**
-		 * Calculate the nth root of a value. The principal nth root of a positive real number A, is the positive real solution of the equation
-		 * x^root = A
-		 * For matrices, the function is evaluated element wise.
-		 * @param root The root. Default value: 2.
-		 */
-		nthRoot(root?: number|BigNumber): MathJsChain;
-
-		/**
-		 * Calculates the power of x to y, x ^ y. Matrix exponentiation is supported for square matrices x, and positive integer exponents y.
-		 * @param y The exponent
-		 */
-		pow(y: number|BigNumber|Complex): MathJsChain;
-
-		/**
-		 * Round a value towards the nearest integer. For matrices, the function is evaluated element wise.
-		 * @param n Number of decimals Default value: 0.
-		 */
-		round(n?: number|BigNumber|MathArray): MathJsChain;
-
-		/**
-		 * Compute the sign of a value. The sign of a value x is:
-		 * 1 when x > 1
-		 * -1 when x < 0
-		 * 0 when x == 0
-		 * For matrices, the function is evaluated element wise.
-		 */
-		sign(): MathJsChain;
-
-		/**
-		 * Calculate the square root of a value. For matrices, the function is evaluated element wise.
-		 */
-		sqrt(): MathJsChain;
-
-		/**
-		 * Compute the square of a value, x * x. For matrices, the function is evaluated element wise.
-		 */
-		square(): MathJsChain;
-
-		/**
-		 * Subtract two values, x - y. For matrices, the function is evaluated element wise.
-		 */
-		subtract(y: MathType): MathJsChain;
-
-		/**
-		 * Inverse the sign of a value, apply a unary minus operation.
-		 * For matrices, the function is evaluated element wise. Boolean values and strings will be converted to a number. For complex numbers, both real and complex value are inverted.
-		 */
-		unaryMinus(): MathJsChain;
-
-		/**
-		 * Unary plus operation. Boolean values and strings will be converted to a number, numeric values will be returned as is.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		unaryPlus(): MathJsChain;
-
-		/**
-		 * Calculate the extended greatest common divisor for two values. See http://en.wikipedia.org/wiki/Extended_Euclidean_algorithm.
-		 */
-		xgcd(b: number|BigNumber): MathJsChain;
-
-		/**
-		 * Bitwise AND two values, x & y. For matrices, the function is evaluated element wise.
-		 */
-		bitAnd(y: number|BigNumber|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Bitwise NOT value, ~x. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 */
-		bitNot(): MathJsChain;
-
-		/**
-		 * Bitwise OR two values, x | y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the lowest print base.
-		 */
-		bitOr(): MathJsChain;
-
-		/**
-		 * Bitwise XOR two values, x ^ y. For matrices, the function is evaluated element wise.
-		 */
-		bitXor(y: number|BigNumber|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Bitwise left logical shift of a value x by y number of bits, x << y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		leftShift(y: number|BigNumber): MathJsChain;
-
-		/**
-		 * Bitwise right arithmetic shift of a value x by y number of bits, x >> y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		rightArithShift(y: number|BigNumber): MathJsChain;
-
-		/**
-		 * Bitwise right logical shift of value x by y number of bits, x >>> y. For matrices, the function is evaluated element wise. For units, the function is evaluated on the best prefix base.
-		 * @param x Value to be shifted
-		 * @param y Amount of shifts
-		 */
-		rightLogShift(y: number): MathJsChain;
-
-		/**
-		 * The Bell Numbers count the number of partitions of a set.
-		 * A partition is a pairwise disjoint subset of S whose union is S.
-		 * bellNumbers only takes integer arguments. The following condition must be enforced: n >= 0
-		 * @param n Total number of objects in the set
-		 */
-		bellNumbers(): MathJsChain;
-
-		/**
-		 * The Catalan Numbers enumerate combinatorial structures of many different types. catalan only takes integer arguments. The following condition must be enforced: n >= 0
-		 * @param n nth Catalan number
-		 */
-		catalan(): MathJsChain;
-
-		/**
-		 * The composition counts of n into k parts. Composition only takes integer arguments. The following condition must be enforced: k <= n.
-		 * @param n Total number of objects in the set
-		 * @param k Number of objects in the subset
-		 * @returns Returns the composition counts of n into k parts.
-		 */
-		composition(k: number|BigNumber): MathJsChain;
-
-		/**
-		 * The Stirling numbers of the second kind, counts the number of ways to partition a set of n labelled objects into k nonempty unlabelled subsets.
-		 * stirlingS2 only takes integer arguments. The following condition must be enforced: k <= n.
-		 * If n = k or k = 1, then s(n,k) = 1
-		 * @param n Total number of objects in the set
-		 * @param k Number of objects in the subset
-		 */
-		stirlingS2(k: number|BigNumber): MathJsChain;
-
-		/**
-		 * Compute the argument of a complex value. For a complex number a + bi, the argument is computed as atan2(b, a). For matrices, the function is evaluated element wise.
-		 * @param x A complex number or array with complex numbers
-		 */
-		arg(): MathJsChain;
-
-		/**
-		 * Compute the complex conjugate of a complex value. If x = a+bi, the complex conjugate of x is a - bi. For matrices, the function is evaluated element wise.
-		 * @param x A complex number or array with complex numbers
-		 */
-		conj(): MathJsChain;
-
-		/**
-		 * Get the imaginary part of a complex number. For a complex number a + bi, the function returns b.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		im(): MathJsChain;
-
-		/**
-		 * Get the real part of a complex number. For a complex number a + bi, the function returns a.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		re(): MathJsChain;
-
-		/**
-		 * Calculates: The eucledian distance between two points in 2 and 3 dimensional spaces. Distance between point
-		 * and a line in 2 and 3 dimensional spaces. Pairwise distance between a set of 2D or 3D points NOTE: When
-		 * substituting coefficients of a line(a, b and c), use ax + by + c = 0 instead of ax + by = c For parametric
-		 * equation of a 3D line, x0, y0, z0, a, b, c are from: (x−x0, y−y0, z−z0) = t(a, b, c)
-		 */
-		distance(y: MathType): MathJsChain;
-
-		/**
-		 * Calculates the point of intersection of two lines in two or three dimensions and of a line and a plane in
-		 * three dimensions. The inputs are in the form of arrays or 1 dimensional matrices. The line intersection functions
-		 * return null if the lines do not meet.
-		 * Note: Fill the plane coefficients as x + y + z = c and not as x + y + z + c = 0.
-		 * @param w Co-ordinates of first end-point of first line
-		 * @param x Co-ordinates of second end-point of first line
-		 * @param y Co-ordinates of first end-point of second line OR Co-efficients of the plane's equation
-		 * @param z Co-ordinates of second end-point of second line OR null if the calculation is for line and plane
-		 * @returns Returns the point of intersection of lines/lines-planes
-		 */
-		intersect(x: MathArray|Matrix, y: MathArray|Matrix, z: MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Logical and. Test whether two values are both defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		and(y: number|BigNumber|Complex|Unit|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Logical not. Flips boolean value of a given parameter. For matrices, the function is evaluated element wise.
-		 */
-		not(): MathJsChain;
-
-		/**
-		 * Logical or. Test if at least one value is defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		or(y: number|BigNumber|Complex|Unit|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Logical xor. Test whether one and only one value is defined with a nonzero/nonempty value. For matrices, the function is evaluated element wise.
-		 */
-		xor(y: number|BigNumber|Complex|Unit|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Calculate the cross product for two vectors in three dimensional space. The cross product of A = [a1, a2, a3]
-		 * and B =[b1, b2, b3] is defined as:
-		 * cross(A, B) = [ a2 * b3 - a3 * b2, a3 * b1 - a1 * b3, a1 * b2 - a2 * b1 ]
-		 */
-		cross(y: MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Calculate the determinant of a matrix.
-		 */
-		det(): MathJsChain;
-
-		/**
-		 * Resize a matrix
-		 * @param x Matrix to be resized
-		 * @param size One dimensional array with numbers
-		 * @param defaultValue Zero by default, except in case of a string, in that case defaultValue = ' ' Default value: 0.
-		 */
-		resize(size: MathArray|Matrix, defaultValue?: number|string): MathJsChain;
-
-		/**
-		 * Calculate the size of a matrix or scalar.
-		 */
-		size(): MathJsChain;
-
-		/**
-		 * Squeeze a matrix, remove inner and outer singleton dimensions from a matrix.
-		 */
-		squeeze(): MathJsChain;
-
-		/**
-		 * Get or set a subset of a matrix or string.
-		 * @param value An array, matrix, or string
-		 * @param index An index containing ranges for each dimension
-		 * @param replacement An array, matrix, or scalar. If provided, the subset is replaced with replacement. If not provided, the subset is returned
-		 * @param defaultValue Default value, filled in on new entries when the matrix is resized. If not provided, math.matrix elements will be left undefined. Default value: undefined.
-		 */
-		subset(index: Index, replacement?: any, defaultValue?: any): MathJsChain;
-
-		/**
-		 * Calculate the trace of a matrix: the sum of the elements on the main diagonal of a square matrix.
-		 */
-		trace(): MathJsChain;
-
-		/**
-		 * Transpose a matrix. All values of the matrix are reflected over its main diagonal. Only two dimensional matrices are supported.
-		 */
-		transpose(): MathJsChain;
-
-		/**
-		 * Random pick a value from a one dimensional array. Array element is picked using a random function with uniform distribution.
-		 */
-		pickRandom(): MathJsChain;
-
-		/**
-		 * Return a random number larger or equal to min and smaller than max using a uniform distribution.
-		 */
-		random(min?: number, max?: number): MathJsChain;
-
-		/**
-		 * Return a random integer number larger or equal to min and smaller than max using a uniform distribution.
-		 */
-		randomInt(min?: number, max?: number): MathJsChain;
-
-		/**
-		 * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x == y.
-		 * x and y are considered equal when the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		compare(y: MathType): MathJsChain;
-
-		/**
-		 * Test element wise whether two matrices are equal. The function accepts both matrices and scalar values.
-		 */
-		deepEqual(y: MathType): MathJsChain;
-
-		/**
-		 * Test whether two values are equal.
-		 * The function tests whether the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise. In case of complex numbers, x.re must equal y.re, and x.im must equal y.im.
-		 * Values null and undefined are compared strictly, thus null is only equal to null and nothing else, and undefined is only equal to undefined and nothing else.
-		 */
-		equal(y: MathType): MathJsChain;
-
-		/**
-		 * Test whether value x is larger than y.
-		 * The function returns true when x is larger than y and the relative difference between x and y is larger than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		larger(y: MathType): MathJsChain;
-
-		/**
-		 * Test whether value x is larger or equal to y.
-		 * The function returns true when x is larger than y or the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		largerEq(y: MathType): MathJsChain;
-
-		/**
-		 * Test whether value x is smaller than y.
-		 * The function returns true when x is smaller than y and the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		smaller(MathJsChainy: MathType): MathJsChain;
-
-		/**
-		 * Test whether value x is smaller or equal to y.
-		 * The function returns true when x is smaller than y or the relative difference between x and y is smaller than the configured epsilon.
-		 * The function cannot be used to compare values smaller than approximately 2.22e-16. For matrices, the function is evaluated element wise.
-		 */
-		smallerEq(MathJsChainy: MathType): MathJsChain;
-
-		/**
-		 * Test whether two values are unequal.
-		 * The function tests whether the relative difference between x and y is larger than the configured epsilon. The function cannot
-		 * be used to compare values smaller than approximately 2.22e-16.
-		 * For matrices, the function is evaluated element wise. In case of complex numbers, x.re must unequal y.re, or x.im must unequal y.im.
-		 * Values null and undefined are compared strictly, thus null is unequal with everything except null, and undefined is unequal with
-		 * everything except undefined.
-		 */
-		unequal(MathJsChainy: MathType): MathJsChain;
-
-		/**
-		 * Compute the maximum value of a matrix or a list with values. In case of a multi dimensional array, the maximum of the flattened
-		 * array will be calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		max(dim?: number): MathJsChain;
-
-		/**
-		 * Compute the mean value of matrix or a list with values. In case of a multi dimensional array, the mean of the flattened array will be
-		 * calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		mean(dim?: number): MathJsChain;
-
-		/**
-		 * Compute the median of a matrix or a list with values. The values are sorted and the middle value is returned. In case of an
-		 * even number of values, the average of the two middle values is returned. Supported types of values are: Number, BigNumber, Unit
-		 * In case of a (multi dimensional) array or matrix, the median of all elements will be calculated.
-		 */
-		median(): MathJsChain;
-
-		/**
-		 * Compute the maximum value of a matrix or a list of values. In case of a multi dimensional array, the maximum of the flattened
-		 * array will be calculated. When dim is provided, the maximum over the selected dimension will be calculated. Parameter dim is zero-based.
-		 */
-		min(dim?: number): MathJsChain;
-
-		/**
-		 * Computes the mode of a set of numbers or a list with values(numbers or characters). If there are more than one modes, it returns a list of those values.
-		 */
-		mode(): MathJsChain;
-
-		/**
-		 * Compute the product of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the sum of all elements will be calculated.
-		 */
-		prod(): MathJsChain;
-
-		/**
-		 * Compute the prob order quantile of a matrix or a list with values. The sequence is sorted and the middle value is returned.
-		 * Supported types of sequence values are: Number, BigNumber, Unit Supported types of probability are: Number, BigNumber
-		 * In case of a (multi dimensional) array or matrix, the prob order quantile of all elements will be calculated.
-		 */
-		quantileSeq(prob: number|BigNumber|MathArray, sorted?: boolean): MathJsChain;
-
-		/**
-		 * Compute the standard deviation of a matrix or a list with values. The standard deviations is defined as the square root of the
-		 * variance: std(A) = sqrt(var(A)). In case of a (multi dimensional) array or matrix, the standard deviation over all elements will
-		 * be calculated.
-		 * Optionally, the type of normalization can be specified as second parameter. The parameter normalization can be one of the following
-		 * values:
-		 * 'unbiased' (default) The sum of squared errors is divided by (n - 1)
-		 * 'uncorrected' The sum of squared errors is divided by n
-		 * 'biased' The sum of squared errors is divided by (n + 1)
-		 */
-		std(normalization?: string): MathJsChain;
-
-		/**
-		 * Compute the sum of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the sum of all elements will be calculated.
-		 */
-		sum(): MathJsChain;
-
-		/**
-		 * Compute the variance of a matrix or a list with values. In case of a (multi dimensional) array or matrix, the variance over all
-		 * elements will be calculated.
-		 * Optionally, the type of normalization can be specified as second parameter. The parameter normalization can be one of the
-		 * following values:
-		 * 'unbiased' (default) The sum of squared errors is divided by (n - 1)
-		 * 'uncorrected' The sum of squared errors is divided by n
-		 * 'biased' The sum of squared errors is divided by (n + 1)
-		 * Note that older browser may not like the variable name var. In that case, the function can be called as math['var'](...)
-		 * instead of math.var(...).
-		 */
-		var(normalization?: string): MathJsChain;
-
-		/**
-		 * Calculate the inverse cosine of a value. For matrices, the function is evaluated element wise.
-		 */
-		acos(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arccos of a value, defined as acosh(x) = ln(sqrt(x^2 - 1) + x).
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acosh(): MathJsChain;
-
-		/**
-		 * Calculate the inverse cotangent of a value. For matrices, the function is evaluated element wise.
-		 */
-		acot(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arccotangent of a value, defined as acoth(x) = (ln((x+1)/x) + ln(x/(x-1))) / 2.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acoth(): MathJsChain;
-
-		/**
-		 * Calculate the inverse cosecant of a value. For matrices, the function is evaluated element wise.
-		 */
-		acsc(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arccosecant of a value, defined as acsch(x) = ln(1/x + sqrt(1/x^2 + 1)).
-		 * For matrices, the function is evaluated element wise.
-		 */
-		acsch(): MathJsChain;
-
-		/**
-		 * Calculate the inverse secant of a value. For matrices, the function is evaluated element wise.
-		 */
-		asec(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arcsecant of a value, defined as asech(x) = ln(sqrt(1/x^2 - 1) + 1/x). For matrices, the function is evaluated element wise.
-		 */
-		asech(): MathJsChain;
-
-		/**
-		 * Calculate the inverse sine of a value. For matrices, the function is evaluated element wise.
-		 */
-		asin(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arcsine of a value, defined as asinh(x) = ln(x + sqrt(x^2 + 1)). For matrices, the function is evaluated element wise.
-		 */
-		asinh(): MathJsChain;
-
-		/**
-		 * Calculate the inverse tangent of a value. For matrices, the function is evaluated element wise.
-		 */
-		atan(): MathJsChain;
-
-		/**
-		 * Calculate the inverse tangent function with two arguments, y/x. By providing two arguments, the right quadrant of the
-		 * computed angle can be determined.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		atan2(x: number|MathArray|Matrix): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic arctangent of a value, defined as atanh(x) = ln((1 + x)/(1 - x)) / 2.
-		 * For matrices, the function is evaluated element wise.
-		 */
-		atanh(): MathJsChain;
-
-		/**
-		 * Calculate the cosine of a value. For matrices, the function is evaluated element wise.
-		 */
-		asin(): MathJsChain; // tslint:disable-line adjacent-overload-signatures
-
-		/**
-		 * Calculate the hyperbolic cosine of a value, defined as cosh(x) = 1/2 * (exp(x) + exp(-x)). For matrices, the function is evaluated element wise.
-		 */
-		cosh(): MathJsChain;
-
-		/**
-		 * Calculate the cotangent of a value. cot(x) is defined as 1 / tan(x). For matrices, the function is evaluated element wise.
-		 */
-		cot(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic cotangent of a value, defined as coth(x) = 1 / tanh(x). For matrices, the function is evaluated element wise.
-		 */
-		coth(): MathJsChain;
-
-		/**
-		 * Calculate the cosecant of a value, defined as csc(x) = 1/sin(x). For matrices, the function is evaluated element wise.
-		 */
-		csc(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic cosecant of a value, defined as csch(x) = 1 / sinh(x). For matrices, the function is evaluated element wise.
-		 */
-		csch(): MathJsChain;
-
-		/**
-		 * Calculate the secant of a value, defined as sec(x) = 1/cos(x). For matrices, the function is evaluated element wise.
-		 */
-		sec(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic secant of a value, defined as sech(x) = 1 / cosh(x). For matrices, the function is evaluated element wise.
-		 */
-		sech(): MathJsChain;
-
-		/**
-		 * Calculate the sine of a value. For matrices, the function is evaluated element wise.
-		 */
-		sin(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic sine of a value, defined as sinh(x) = 1/2 * (exp(x) - exp(-x)). For matrices, the function is evaluated element wise.
-		 */
-		sinh(): MathJsChain;
-
-		/**
-		 * Calculate the tangent of a value. tan(x) is equal to sin(x) / cos(x). For matrices, the function is evaluated element wise.
-		 */
-		tan(): MathJsChain;
-
-		/**
-		 * Calculate the hyperbolic tangent of a value, defined as tanh(x) = (exp(2 * x) - 1) / (exp(2 * x) + 1). For matrices, the function is evaluated element wise.
-		 */
-		tanh(): MathJsChain;
-
-		/**
-		 * Change the unit of a value. For matrices, the function is evaluated element wise.
-		 * @param x The unit to be converted.
-		 * @param unit New unit. Can be a string like "cm" or a unit without value.
-		 */
-		to(unit: Unit|string): MathJsChain;
-
-		/**
-		 * Clone an object.
-		 */
-		clone(): MathJsChain;
-
-		/**
-		 * Filter the items in an array or one dimensional matrix.
-		 * @param x A one dimensional matrix or array to filter
-		 * @param test
-		 */
-		filter(test: RegExp|((item: any) => boolean)): MathJsChain;
-
-		/**
-		 * Format a value of any type into a string.
-		 */
-		format(options?: FormatOptions|number|((item: any) => string)): MathJsChain;
-
-		/**
-		 * Create a new matrix or array with the results of the callback function executed on each entry of the matrix/array.
-		 * @param callback The callback method is invoked with three parameters: the value of the element, the index of the element, and the matrix being traversed.
-		 */
-		map(callback: (item: any) => any): MathJsChain;
-
-		/**
-		 * Partition-based selection of an array or 1D matrix. Will find the kth smallest value, and mutates the input array. Uses Quickselect.
-		 * @param k The kth smallest value to be retrieved; zero-based index
-		 * @param compare  An optional comparator function. The function is called as compare(a, b), and must return 1 when a > b, -1 when a < b, and 0 when a == b. Default value: 'asc'.
-		 * @returns Returns the kth lowest value.
-		 */
-		partitionSelect(k: number, compare?: string|((a: any, b: any) => number)): MathJsChain;
-
-		/**
-		 * Sort the items in a matrix.
-		 * @param compare  An optional comparator function. The function is called as compare(a, b), and must return 1 when a > b, -1 when a < b, and 0 when a == b. Default value: 'asc'.
-		 */
-		sort(compare?: string|((a: any, b: any) => number)): MathJsChain;
-
-		done(): any;
-		valueOf(): any;
-		toString(): string;
-	}
+        kron(y: Matrix | MathArray): MathJsChain;
+
+        /**
+         * Iterate over all elements of a matrix/array, and executes the given
+         * callback function.
+         * @param callback The callback function is invoked with three
+         * parameters: the value of the element, the index of the element, and
+         * the Matrix/array being traversed.
+         */
+        map(callback: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray)): MathJsChain;
+
+        /**
+         * Create a matrix filled with ones. The created matrix can have one or
+         * multiple dimensions.
+         * @param format The matrix storage format
+         */
+        ones(format?: string): MathJsChain;
+        /**
+         * @param format The matrix storage format
+         */
+        ones(n: number, format?: string): MathJsChain;
+        /**
+         * Partition-based selection of an array or 1D matrix. Will find the kth
+         * smallest value, and mutates the input array. Uses Quickselect.
+         * @param k The kth smallest value to be retrieved; zero-based index
+         * @param compare  An optional comparator function. The function is
+         * called as compare(a, b), and must return 1 when a > b, -1 when a < b,
+         * and 0 when a == b. Default value: 'asc'.
+         */
+        partitionSelect(
+            k: number,
+            compare?: "asc" | "desc" | ((a: any, b: any) => number)
+        ): MathJsChain;
+
+        /**
+         * Create an array from a range. By default, the range end is excluded.
+         * This can be customized by providing an extra parameter includeEnd.
+         * @param end End of the range, excluded by default, included when
+         * parameter includeEnd=true
+         * @param step Step size. Default value is 1.
+         * @param includeEnd: Option to specify whether to include the end or
+         * not. False by default
+         */
+        range(includeEnd?: boolean): Matrix;
+        range(end: number | BigNumber, includeEnd?: boolean): MathJsChain;
+        range(
+            end: number | BigNumber,
+            step: number | BigNumber,
+            includeEnd?: boolean
+        ): MathJsChain;
+
+        /**
+         * Reshape a multi dimensional array to fit the specified dimensions
+         * @param sizes One dimensional array with integral sizes for each
+         * dimension
+         */
+        reshape(sizes: number[]): MathJsChain;
+
+        /**
+         * Resize a matrix
+         * @param size One dimensional array with numbers
+         * @param defaultValue Zero by default, except in case of a string, in
+         * that case defaultValue = ' ' Default value: 0.
+         */
+        resize(
+            size: MathArray | Matrix,
+            defaultValue?: number | string
+        ): MathJsChain;
+
+        /**
+         * Calculate the size of a matrix or scalar.
+         */
+        size(): MathJsChain;
+
+        /**
+         * Sort the items in a matrix
+         * @param compare An optional _comparator function or name. The function
+         * is called as compare(a, b), and must return 1 when a > b, -1 when a <
+         * b, and 0 when a == b. Default value: ‘asc’
+         */
+        sort(compare: ((a:any, b:any)=>number) | "asc" | "desc" | "natural"): MathJsChain;
+
+        /**
+         * Calculate the principal square root of a square matrix. The principal
+         * square root matrix X of another matrix A is such that X * X = A.
+         */
+        sqrtm(): MathJsChain;
+
+        /**
+         * Squeeze a matrix, remove inner and outer singleton dimensions from a
+         * matrix.
+         */
+        squeeze(): MathJsChain;
+
+        /**
+         * Get or set a subset of a matrix or string.
+         * @param index An index containing ranges for each dimension
+         * @param replacement An array, matrix, or scalar. If provided, the
+         * subset is replaced with replacement. If not provided, the subset is
+         * returned
+         * @param defaultValue Default value, filled in on new entries when the
+         * matrix is resized. If not provided, math.matrix elements will be left
+         * undefined. Default value: undefined.
+         */
+        subset(
+            index: Index,
+            replacement?: any,
+            defaultValue?: any
+        ): MathJsChain;
+
+        /**
+         * Calculate the trace of a matrix: the sum of the elements on the main
+         * diagonal of a square matrix.
+         */
+        trace(): MathJsChain;
+
+        /**
+         * Transpose a matrix. All values of the matrix are reflected over its
+         * main diagonal. Only two dimensional matrices are supported.
+         */
+        transpose(): MathJsChain;
+
+        /**
+         * Create a matrix filled with zeros. The created matrix can have one or
+         * multiple dimensions.
+         * @param format The matrix storage format
+         * @returns A matrix filled with zeros
+         */
+        zeros(format?: string): MathJsChain;
+        /**
+         * @param n The y dimension of the matrix
+         * @param format The matrix storage format
+         */
+        zeros(n: number, format?: string): MathJsChain;
+
+        /*************************************************************************
+         * Probability functions
+         ************************************************************************/
+
+        /**
+         * Compute the number of ways of picking k unordered outcomes from n
+         * possibilities. Combinations only takes integer arguments. The
+         * following condition must be enforced: k <= n.
+         * @param k Number of objects in the subset
+         */
+        combinations(k: number | BigNumber): MathJsChain;
+
+        /**
+         * Compute the factorial of a value Factorial only supports an integer
+         * value as argument. For matrices, the function is evaluated element
+         * wise.
+         */
+        factorial(): MathJsChain;
+
+        /**
+         * Compute the gamma function of a value using Lanczos approximation for
+         * small values, and an extended Stirling approximation for large
+         * values. For matrices, the function is evaluated element wise.
+         */
+        gamma(): MathJsChain;
+
+        /**
+         * Calculate the Kullback-Leibler (KL) divergence between two
+         * distributions
+         * @param p Second vector
+         */
+        kldivergence(p: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Multinomial Coefficients compute the number of ways of picking a1,
+         * a2, ..., ai unordered outcomes from n possibilities. multinomial
+         * takes one array of integers as an argument. The following condition
+         * must be enforced: every ai <= 0
+         */
+        multinomial(): MathJsChain;
+
+        /**
+         * Compute the number of ways of obtaining an ordered subset of k
+         * elements from a set of n elements. Permutations only takes integer
+         * arguments. The following condition must be enforced: k <= n.
+         * @param k The number of objects in the subset
+         */
+        permutations(k?: number | BigNumber): MathJsChain;
+
+        /**
+         * Random pick a value from a one dimensional array. Array element is
+         * picked using a random function with uniform distribution.
+         * @param number An int or float
+         * @param weights An array of ints or floats
+         */
+        pickRandom(number?: number, weights?: number[]): MathJsChain;
+
+        /**
+         * Return a random number larger or equal to min and smaller than max
+         * using a uniform distribution.
+         * @param min Minimum boundary for the random value, included
+         * @param max Maximum boundary for the random value, excluded
+         */
+        random(max?: number): number;
+        random(min?: number, max?: number): MathJsChain;
+
+        /**
+         * Return a random integer number larger or equal to min and smaller
+         * than max using a uniform distribution.
+         * @param min Minimum boundary for the random value, included
+         * @param max Maximum boundary for the random value, excluded
+         */
+        randomInt(max?: number): MathJsChain;
+        randomInt(min?: number, max?: number): MathJsChain;
+
+        /*************************************************************************
+         * Relational functions
+         ************************************************************************/
+
+        /**
+         * Compare two values. Returns 1 when x > y, -1 when x < y, and 0 when x
+         * == y. x and y are considered equal when the relative difference
+         * between x and y is smaller than the configured epsilon. The function
+         * cannot be used to compare values smaller than approximately 2.22e-16.
+         * For matrices, the function is evaluated element wise.
+         * @param y Second value to compare
+         */
+        compare(y: MathType | string): MathJsChain;
+
+        /**
+         * Compare two values of any type in a deterministic, natural way. For
+         * numeric values, the function works the same as math.compare. For
+         * types of values that can’t be compared mathematically, the function
+         * compares in a natural way.
+         * @param y Second value to compare
+         */
+        compareNatural(y: any): MathJsChain;
+
+        /**
+         * Compare two strings lexically. Comparison is case sensitive. Returns
+         * 1 when x > y, -1 when x < y, and 0 when x == y. For matrices, the
+         * function is evaluated element wise.
+         * @param y Second string to compare
+         */
+        compareText(y: string | MathArray | Matrix): MathJsChain;
+
+        /**
+         * Test element wise whether two matrices are equal. The function
+         * accepts both matrices and scalar values.
+         * @param y Second amtrix to compare
+         */
+        deepEqual(y: MathType): MathJsChain;
+
+        /**
+         * Test whether two values are equal.
+         *
+         * The function tests whether the relative difference between x and y is
+         * smaller than the configured epsilon. The function cannot be used to
+         * compare values smaller than approximately 2.22e-16. For matrices, the
+         * function is evaluated element wise. In case of complex numbers, x.re
+         * must equal y.re, and x.im must equal y.im. Values null and undefined
+         * are compared strictly, thus null is only equal to null and nothing
+         * else, and undefined is only equal to undefined and nothing else.
+         * @param y Second value to compare
+         */
+        equal(y: MathType | string): MathJsChain;
+
+        /**
+         * Check equality of two strings. Comparison is case sensitive. For
+         * matrices, the function is evaluated element wise.
+         * @param y Second string to compare
+         */
+        equalText(y: string | MathArray | Matrix): MathJsChain;
+
+        /**
+         * Test whether value x is larger than y. The function returns true when
+         * x is larger than y and the relative difference between x and y is
+         * larger than the configured epsilon. The function cannot be used to
+         * compare values smaller than approximately 2.22e-16. For matrices, the
+         * function is evaluated element wise.
+         * @param y Second value to compare
+         */
+        larger(y: MathType | string): MathJsChain;
+
+        /**
+         * Test whether value x is larger or equal to y. The function returns
+         * true when x is larger than y or the relative difference between x and
+         * y is smaller than the configured epsilon. The function cannot be used
+         * to compare values smaller than approximately 2.22e-16. For matrices,
+         * the function is evaluated element wise.
+         * @param y Second value to vcompare
+         */
+        largerEq(y: MathType | string): MathJsChain;
+
+        /**
+         * Test whether value x is smaller than y. The function returns true
+         * when x is smaller than y and the relative difference between x and y
+         * is smaller than the configured epsilon. The function cannot be used
+         * to compare values smaller than approximately 2.22e-16. For matrices,
+         * the function is evaluated element wise.
+         * @param y Second value to vcompare
+         */
+        smaller(y: MathType | string): MathJsChain;
+
+        /**
+         * Test whether value x is smaller or equal to y. The function returns
+         * true when x is smaller than y or the relative difference between x
+         * and y is smaller than the configured epsilon. The function cannot be
+         * used to compare values smaller than approximately 2.22e-16. For
+         * matrices, the function is evaluated element wise.
+         * @param y Second value to compare
+         */
+        smallerEq(y: MathType | string): MathJsChain;
+
+        /**
+         * Test whether two values are unequal. The function tests whether the
+         * relative difference between x and y is larger than the configured
+         * epsilon. The function cannot be used to compare values smaller than
+         * approximately 2.22e-16. For matrices, the function is evaluated
+         * element wise. In case of complex numbers, x.re must unequal y.re, or
+         * x.im must unequal y.im. Values null and undefined are compared
+         * strictly, thus null is unequal with everything except null, and
+         * undefined is unequal with everything except undefined.
+         * @param y Second value to vcompare
+         */
+        unequal(y: MathType | string): MathJsChain;
+
+        /*************************************************************************
+         * Set functions
+         ************************************************************************/
+
+        /**
+         * Create the cartesian product of two (multi)sets. Multi-dimension
+         * arrays will be converted to single-dimension arrays before the
+         * operation.
+         * @param a2 A (multi)set
+         */
+        setCartesian(a2: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Create the difference of two (multi)sets: every element of set1, that
+         * is not the element of set2. Multi-dimension arrays will be converted
+         * to single-dimension arrays before the operation
+         * @param a2 A (multi)set
+         */
+        setDifference(a2: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Collect the distinct elements of a multiset. A multi-dimension array
+         * will be converted to a single-dimension array before the operation.
+         */
+        setDistinct(): MathJsChain;
+
+        /**
+         * Create the intersection of two (multi)sets. Multi-dimension arrays
+         * will be converted to single-dimension arrays before the operation.
+         * @param a2 A (multi)set
+         */
+        setIntersect(a2: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Check whether a (multi)set is a subset of another (multi)set. (Every
+         * element of set1 is the element of set2.) Multi-dimension arrays will
+         * be converted to single-dimension arrays before the operation.
+         * @param a2 A (multi)set
+         */
+        setIsSubset(a2: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Count the multiplicity of an element in a multiset. A multi-dimension
+         * array will be converted to a single-dimension array before the
+         * operation.
+         * @param a A multiset
+         */
+        setMultiplicity(a: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Create the powerset of a (multi)set. (The powerset contains very
+         * possible subsets of a (multi)set.) A multi-dimension array will be
+         * converted to a single-dimension array before the operation.
+         */
+        setPowerset(): MathJsChain;
+
+        /**
+         * Count the number of elements of a (multi)set. When a second parameter
+         * is ‘true’, count only the unique values. A multi-dimension array will
+         * be converted to a single-dimension array before the operation.
+         */
+        setSize(): MathJsChain;
+
+        /**
+         * Create the symmetric difference of two (multi)sets. Multi-dimension
+         * arrays will be converted to single-dimension arrays before the
+         * operation.
+         * @param a2 A (multi)set
+         */
+        setSymDifference(a2: MathArray | Matrix): MathJsChain;
+
+        /**
+         * Create the union of two (multi)sets. Multi-dimension arrays will be
+         * converted to single-dimension arrays before the operation.
+         * @param a2 A (multi)set
+         */
+        setUnion(a2: MathArray | Matrix): MathJsChain;
+
+        /*************************************************************************
+         * Special functions
+         ************************************************************************/
+
+        /**
+         * Compute the erf function of a value using a rational Chebyshev
+         * approximations for different intervals of x.
+         */
+        erf(): MathJsChain;
+
+        /*************************************************************************
+         * Statistics functions
+         ************************************************************************/
+
+        /**
+         * Compute the median absolute deviation of a matrix or a list with
+         * values. The median absolute deviation is defined as the median of the
+         * absolute deviations from the median.
+         */
+        mad(): MathJsChain;
+
+        /**
+         * Compute the maximum value of a matrix or a list with values. In case
+         * of a multi dimensional array, the maximum of the flattened array will
+         * be calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         */
+        max(): MathJsChain;
+        /**
+         * @param dim The maximum over the selected dimension
+         */
+        max(dim?: number): MathJsChain;
+
+        /**
+         * Compute the mean value of matrix or a list with values. In case of a
+         * multi dimensional array, the mean of the flattened array will be
+         * calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         */
+        mean(): MathJsChain;
+        /**
+         * @param dim The mean over the selected dimension
+         */
+        mean(dim?: number): MathJsChain;
+
+        /**
+         * Compute the median of a matrix or a list with values. The values are
+         * sorted and the middle value is returned. In case of an even number of
+         * values, the average of the two middle values is returned. Supported
+         * types of values are: Number, BigNumber, Unit In case of a (multi
+         * dimensional) array or matrix, the median of all elements will be
+         * calculated.
+         */
+        median(): MathJsChain;
+
+        /**
+         * Compute the maximum value of a matrix or a list of values. In case of
+         * a multi dimensional array, the maximum of the flattened array will be
+         * calculated. When dim is provided, the maximum over the selected
+         * dimension will be calculated. Parameter dim is zero-based.
+         */
+        min(): MathJsChain;
+        /**
+         * @param dim The minimum over the selected dimension
+         * @returns The minimum value
+         */
+        min(dim?: number): MathJsChain;
+
+        /**
+         * Computes the mode of a set of numbers or a list with values(numbers
+         * or characters). If there are more than one modes, it returns a list
+         * of those values.
+         */
+        mode(): MathJsChain;
+
+        /**
+         * Compute the product of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the sum of all elements will be
+         * calculated.
+         */
+        prod(): MathJsChain;
+
+        /**
+         * Compute the prob order quantile of a matrix or a list with values.
+         * The sequence is sorted and the middle value is returned. Supported
+         * types of sequence values are: Number, BigNumber, Unit Supported types
+         * of probability are: Number, BigNumber In case of a (multi
+         * dimensional) array or matrix, the prob order quantile of all elements
+         * will be calculated.
+         * @param probOrN prob is the order of the quantile, while N is the
+         * amount of evenly distributed steps of probabilities; only one of
+         * these options can be provided
+         * @param sorted =false is data sorted in ascending order
+         */
+        quantileSeq(
+            prob: number | BigNumber | MathArray,
+            sorted?: boolean
+        ): MathJsChain;
+
+        /**
+         * Compute the standard deviation of a matrix or a list with values. The
+         * standard deviations is defined as the square root of the variance:
+         * std(A) = sqrt(var(A)). In case of a (multi dimensional) array or
+         * matrix, the standard deviation over all elements will be calculated.
+         * Optionally, the type of normalization can be specified as second
+         * parameter. The parameter normalization can be one of the following
+         * values: 'unbiased' (default) The sum of squared errors is divided by
+         * (n - 1) 'uncorrected' The sum of squared errors is divided by n
+         * 'biased' The sum of squared errors is divided by (n + 1)
+         * @param array A single matrix or multiple scalar values
+         * @param normalization Determines how to normalize the variance. Choose
+         * ‘unbiased’ (default), ‘uncorrected’, or ‘biased’. Default value:
+         * ‘unbiased’.
+         * @returns The standard deviation
+         */
+        std(
+            normalization?: "unbiased" | "uncorrected" | "biased" | "unbiased"
+        ): MathJsChain;
+
+        /**
+         * Compute the sum of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the sum of all elements will be
+         * calculated.
+         */
+        sum(): MathJsChain;
+
+        /**
+         * Compute the variance of a matrix or a list with values. In case of a
+         * (multi dimensional) array or matrix, the variance over all elements
+         * will be calculated. Optionally, the type of normalization can be
+         * specified as second parameter. The parameter normalization can be one
+         * of the following values: 'unbiased' (default) The sum of squared
+         * errors is divided by (n - 1) 'uncorrected' The sum of squared errors
+         * is divided by n 'biased' The sum of squared errors is divided by (n +
+         * 1) Note that older browser may not like the variable name var. In
+         * that case, the function can be called as math['var'](...) instead of
+         * math.var(...).
+         * @returns The variance
+         */
+        var(): MathJsChain;
+        /**
+         * @param normalization normalization Determines how to normalize the
+         * variance. Choose ‘unbiased’ (default), ‘uncorrected’, or ‘biased’.
+         * Default value: ‘unbiased’.
+         */
+        var(
+            normalization?: "unbiased" | "uncorrected" | "biased" | "unbiased"
+        ): MathJsChain;
+
+        /*************************************************************************
+         * String functions
+         ************************************************************************/
+
+        /**
+         * Format a value of any type into a string.
+         * @param options An object with formatting options.
+         * @param callback A custom formatting function, invoked for all numeric
+         * elements in value, for example all elements of a matrix, or the real
+         * and imaginary parts of a complex number. This callback can be used to
+         * override the built-in numeric notation with any type of formatting.
+         * Function callback is called with value as parameter and must return a
+         * string.
+         * @see http://mathjs.org/docs/reference/functions/format.html
+         */
+        format(
+            value: any,
+            options?: FormatOptions | number | ((item: any) => string),
+            callback?: ((value:any)=>string)
+        ): MathJsChain;
+
+        /**
+         * Interpolate values into a string template.
+         * @param values An object containing variables which will be filled in
+         * in the template.
+         * @param precision Number of digits to format numbers. If not provided,
+         * the value will not be rounded.
+         * @param options Formatting options, or the number of digits to format
+         * numbers. See function math.format for a description of all options.
+         */
+        print(
+            values: any,
+            precision?: number,
+            options?: number | object
+        ): MathJsChain;
+
+        /*************************************************************************
+         * Trigonometry functions
+         ************************************************************************/
+
+        /**
+         * Calculate the inverse cosine of a value. For matrices, the function
+         * is evaluated element wise.
+         */
+        acos(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arccos of a value, defined as acosh(x) =
+         * ln(sqrt(x^2 - 1) + x). For matrices, the function is evaluated
+         * element wise.
+         */
+        acosh(): MathJsChain;
+
+        /**
+         * Calculate the inverse cotangent of a value. For matrices, the
+         * function is evaluated element wise.
+         */
+        acot(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arccotangent of a value, defined as acoth(x)
+         * = (ln((x+1)/x) + ln(x/(x-1))) / 2. For matrices, the function is
+         * evaluated element wise.
+         */
+        acoth(): MathJsChain;
+
+        /**
+         * Calculate the inverse cosecant of a value. For matrices, the function
+         * is evaluated element wise.
+         */
+        acsc(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arccosecant of a value, defined as acsch(x)
+         * = ln(1/x + sqrt(1/x^2 + 1)). For matrices, the function is evaluated
+         * element wise.
+         */
+        acsch(): MathJsChain;
+
+        /**
+         * Calculate the inverse secant of a value. For matrices, the function
+         * is evaluated element wise.
+         */
+        asec(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arcsecant of a value, defined as asech(x) =
+         * ln(sqrt(1/x^2 - 1) + 1/x). For matrices, the function is evaluated
+         * element wise.
+         */
+        asech(): MathJsChain;
+
+        /**
+         * Calculate the inverse sine of a value. For matrices, the function is
+         * evaluated element wise.
+         */
+        asin(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arcsine of a value, defined as asinh(x) =
+         * ln(x + sqrt(x^2 + 1)). For matrices, the function is evaluated
+         * element wise.
+         */
+        asinh(): MathJsChain;
+
+        /**
+         * Calculate the inverse tangent of a value. For matrices, the function
+         * is evaluated element wise.
+         */
+        atan(): MathJsChain;
+
+        /**
+         * Calculate the inverse tangent function with two arguments, y/x. By
+         * providing two arguments, the right quadrant of the computed angle can
+         * be determined. For matrices, the function is evaluated element wise.
+         */
+        atan2(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic arctangent of a value, defined as atanh(x) =
+         * ln((1 + x)/(1 - x)) / 2. For matrices, the function is evaluated
+         * element wise.
+         */
+        atanh(): MathJsChain;
+
+        /**
+         * Calculate the cosine of a value. For matrices, the function is
+         * evaluated element wise.
+         */
+        cos(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic cosine of a value, defined as cosh(x) = 1/2
+         * * (exp(x) + exp(-x)). For matrices, the function is evaluated element
+         * wise.
+         */
+        cosh(): MathJsChain;
+
+        /**
+         * Calculate the cotangent of a value. cot(x) is defined as 1 / tan(x).
+         * For matrices, the function is evaluated element wise.
+         */
+        cot(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic cotangent of a value, defined as coth(x) = 1
+         * / tanh(x). For matrices, the function is evaluated element wise.
+         */
+        coth(): MathJsChain;
+
+        /**
+         * Calculate the cosecant of a value, defined as csc(x) = 1/sin(x). For
+         * matrices, the function is evaluated element wise.
+         */
+        csc(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic cosecant of a value, defined as csch(x) = 1
+         * / sinh(x). For matrices, the function is evaluated element wise.
+         */
+        csch(): MathJsChain;
+
+        /**
+         * Calculate the secant of a value, defined as sec(x) = 1/cos(x). For
+         * matrices, the function is evaluated element wise.
+         */
+        sec(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic secant of a value, defined as sech(x) = 1 /
+         * cosh(x). For matrices, the function is evaluated element wise.
+         */
+        sech(): MathJsChain;
+
+        /**
+         * Calculate the sine of a value. For matrices, the function is
+         * evaluated element wise.
+         */
+        sin(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic sine of a value, defined as sinh(x) = 1/2 *
+         * (exp(x) - exp(-x)). For matrices, the function is evaluated element
+         * wise.
+         */
+        sinh(): MathJsChain;
+
+        /**
+         * Calculate the tangent of a value. tan(x) is equal to sin(x) / cos(x).
+         * For matrices, the function is evaluated element wise.
+         */
+        tan(): MathJsChain;
+
+        /**
+         * Calculate the hyperbolic tangent of a value, defined as tanh(x) =
+         * (exp(2 * x) - 1) / (exp(2 * x) + 1). For matrices, the function is
+         * evaluated element wise.
+         */
+        tanh(): MathJsChain;
+
+        /*************************************************************************
+         * Unit functions
+         ************************************************************************/
+
+        /**
+         * Change the unit of a value. For matrices, the function is evaluated
+         * element wise.
+         * @param unit New unit. Can be a string like "cm" or a unit without
+         * value.
+         */
+        to(unit: Unit | string): MathJsChain;
+
+        /*************************************************************************
+         * Utils functions
+         ************************************************************************/
+
+        /**
+         * Clone an object.
+         */
+        clone(): MathJsChain;
+
+        /**
+         * Test whether a value is an integer number. The function supports
+         * number, BigNumber, and Fraction. The function is evaluated
+         * element-wise in case of Array or Matrix input.
+         */
+        isInteger(): MathJsChain;
+
+        /**
+         * Test whether a value is NaN (not a number). The function supports
+         * types number, BigNumber, Fraction, Unit and Complex. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         */
+        isNaN(): MathJsChain;
+
+        /**
+         * Test whether a value is negative: smaller than zero. The function
+         * supports types number, BigNumber, Fraction, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         */
+        isNegative(): MathJsChain;
+
+        /**
+         * Test whether a value is an numeric value. The function is evaluated
+         * element-wise in case of Array or Matrix input.
+         */
+        isNumeric(): MathJsChain;
+
+        /**
+         * Test whether a value is positive: larger than zero. The function
+         * supports types number, BigNumber, Fraction, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         */
+        isPositive(): MathJsChain;
+
+        /**
+         * Test whether a value is prime: has no divisors other than itself and
+         * one. The function supports type number, bignumber. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         */
+        isPrime(): MathJsChain;
+
+        /**
+         * Test whether a value is zero. The function can check for zero for
+         * types number, BigNumber, Fraction, Complex, and Unit. The function is
+         * evaluated element-wise in case of Array or Matrix input.
+         */
+        isZero(): MathJsChain;
+
+        /**
+         * Determine the type of a variable.
+         */
+        typeof(): MathJsChain;
+    }
 }
diff --git a/types/mathjs/mathjs-tests.ts b/types/mathjs/mathjs-tests.ts
index 6cf43dc698..221365e1df 100644
--- a/types/mathjs/mathjs-tests.ts
+++ b/types/mathjs/mathjs-tests.ts
@@ -33,7 +33,7 @@ Bignumbers examples
 {
 	// configure the default type of numbers as BigNumbers
 	math.config({
-		number: 'bignumber',
+		number: 'BigNumber',
 		precision: 20,
 	});
 
@@ -108,9 +108,8 @@ Complex numbers examples
 
 	// create a complex number from polar coordinates
 	{
-		const p: math.PolarCoordinates = { r: math.sqrt(2), phi: math.pi / 4 };
-		const c: math.Complex = math
-			.complex(p);
+        const p: math.PolarCoordinates = { r: math.sqrt(2), phi: math.pi / 4 };
+		const c: math.Complex = math.complex(p);
 	}
 
 	// get polar coordinates of a complex number
@@ -175,6 +174,11 @@ Expressions examples
 
 	// get and set variables and functions
 	{
+        parser.eval('x = 7 / 2');               // 3.5
+        parser.eval('x + 3');                   // 6.5
+        parser.eval('f(x, y) = x^y');           // f(x, y)
+        parser.eval('f(2, 3)');                 // 8
+
 		const x = parser.get('x');
 		const f = parser.get('f');
 		const g = f(3, 3);
@@ -193,7 +197,7 @@ Fractions examples
 {
 	// configure the default type of numbers as Fractions
 	math.config({
-		number: 'fraction',
+		number: 'Fraction',
 	});
 
 	const x = math.fraction(0.125);
@@ -205,9 +209,6 @@ Fractions examples
 
 	// output formatting
 	const a = math.fraction('2/3');
-	console.log(math.format(a));
-	console.log(math.format(a, {fraction: 'ratio'}));
-	console.log(math.format(a, {fraction: 'decimal'}));
 }
 
 /*
@@ -237,7 +238,7 @@ Matrices examples
 
 		b.subset(math.index(1, [0, 1]), [[7, 8]]);
 		const c = math.multiply(a, b);
-		const d: math.Matrix = c.subset(math.index(1, 0));
+		const d: math.Matrix = (<math.Matrix>c).subset(math.index(1, 0));
 	}
 
 	// get a sub matrix
@@ -282,7 +283,7 @@ Sparse matrices examples
 	// do operations with a sparse matrix
 	const b = math.multiply(a, a);
 	const c = math.multiply(b, math.complex(2, 2));
-	const d = math.transpose(c);
+	const d = math.transpose((<math.Matrix>c));
 	const e = math.multiply(d, a);
 }
 
@@ -296,11 +297,11 @@ Units examples
 	const b = math.unit('0.1m'); // 100 mm
 
 	// creating units
-	math.createUnit('foo');
+	math.createUnit('foo', '12 meters');
 	math.createUnit('furlong', '220 yards');
 	math.createUnit('furlong', '220 yards', {override: true});
-	math.createUnit('fahrenheit', {definition: '0.555556 kelvin', offset: 459.67});
-	math.createUnit('fahrenheit', {definition: '0.555556 kelvin', offset: 459.67}, {override: true});
+	math.createUnit('testunit', {definition: '0.555556 kelvin', offset: 459.67});
+	math.createUnit('testunit', {definition: '0.555556 kelvin', offset: 459.67}, {override: true});
 	math.createUnit('knot', {definition: '0.514444 m/s', aliases: ['knots', 'kt', 'kts']});
 	math.createUnit('knot', {definition: '0.514444 m/s', aliases: ['knots', 'kt', 'kts']}, {override: true});
 	math.createUnit('knot', {

From fb1af8608b3db6abed222846c29b2bad4691d14e Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 18:03:10 -0400
Subject: [PATCH 059/180] Fixes based on PR comments

---
 types/mathjs/index.d.ts      | 43 +++++++++++++++++++++---------------
 types/mathjs/mathjs-tests.ts | 13 +++++------
 2 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index 3fa5455fe5..a2e2cb8b6b 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -1,17 +1,18 @@
-// Type definitions for mathjs 4.4.2 Project: http://mathjs.org/ Definitions by:
-// Ilya Shestakov <https://github.com/siavol>, Andy Patterson
-// <https://github.com/andnp>, Brad Besserman <https://github.com/bradbesserman>
-// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped TypeScript
-// Version: 2.8.1
+// Type definitions for mathjs 4.4.2
+// Project: http://mathjs.org/ Definitions by:
+//                  Ilya Shestakov <https://github.com/siavol>,
+//                  Andy Patterson <https://github.com/andnp>,
+//                  Brad Besserman <https://github.com/bradbesserman>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.8.1
 
 import { Decimal } from "decimal.js";
 
-declare const math: math.MathJsStatic; // tslint:disable-line strict-export-declare-modifiers
-export as namespace math; // tslint:disable-line strict-export-declare-modifiers
-export = math; // tslint:disable-line strict-export-declare-modifiers
+declare const math: math.MathJsStatic;
+export as namespace math;
+export = math;
 
 declare namespace math {
-    // tslint:disable-line strict-export-declare-modifiers
     type MathArray = number[] | number[][];
     type MathType =
         | number
@@ -62,7 +63,7 @@ declare namespace math {
          * randomly seed.
          * @returns Returns the current configuration
          */
-        config: (options: object) => object;
+        config: (options: ConfigOptions) => ConfigOptions;
         /**
          * Create a typed-function which checks the types of the arguments and
          * can match them against multiple provided signatures. The
@@ -73,7 +74,7 @@ declare namespace math {
          * @param signatures Object with one or multiple function signatures
          * @returns The created typed-function.
          */
-        typed: (name: string, signatures: object) => any;
+        typed: (name: string, signatures: Record<string, Function>) => Function;
 
         /*************************************************************************
          * Construction functions
@@ -163,13 +164,7 @@ declare namespace math {
         /**
          * Create a user-defined unit and register it with the Unit type.
          * @param units Definition of the unit
-         * @param options (optional) An object containing any of the following
-         * properties:</br>- prefixes {string} “none”, “short”, “long”,
-         * “binary_short”, or “binary_long”. The default is “none”.</br>-
-         * aliases {Array} Array of strings. Example: [‘knots’, ‘kt’,
-         * ‘kts’]</br>- offset {Numeric} An offset to apply when converting from
-         * the unit. For example, the offset for celsius is 273.15. Default is
-         * 0.
+         * @param options
          * @returns The new unit
          */
         createUnit(
@@ -2674,6 +2669,9 @@ declare namespace math {
     }
 
     interface CreateUnitOptions {
+        prefixes?: "none" | "short" | "long" | "binary_short" | "binary_long";
+        aliases?: string[];
+        offset?: number;
         override?: boolean;
     }
 
@@ -2937,6 +2935,15 @@ declare namespace math {
         toJSON(): string;
     }
 
+    interface ConfigOptions {
+        epsilon?: number;
+        matrix?: string;
+        number?: string;
+        precision?: number;
+        parenthesis?: string;
+        randomSeed?: string;
+    }
+
     interface MathJsChain {
         done(): any;
 
diff --git a/types/mathjs/mathjs-tests.ts b/types/mathjs/mathjs-tests.ts
index 221365e1df..455b1fdaee 100644
--- a/types/mathjs/mathjs-tests.ts
+++ b/types/mathjs/mathjs-tests.ts
@@ -114,9 +114,7 @@ Complex numbers examples
 
 	// get polar coordinates of a complex number
 	{
-		const p: math.PolarCoordinates = math
-			.complex(3, 4)
-			.toPolar();
+		const p: math.PolarCoordinates = math.complex(3, 4).toPolar();
 	}
 }
 
@@ -175,7 +173,7 @@ Expressions examples
 	// get and set variables and functions
 	{
         parser.eval('x = 7 / 2');               // 3.5
-        parser.eval('x + 3');                   // 6.5
+     	parser.eval('x + 3');                   // 6.5
         parser.eval('f(x, y) = x^y');           // f(x, y)
         parser.eval('f(2, 3)');                 // 8
 
@@ -238,7 +236,8 @@ Matrices examples
 
 		b.subset(math.index(1, [0, 1]), [[7, 8]]);
 		const c = math.multiply(a, b);
-		const d: math.Matrix = (<math.Matrix>c).subset(math.index(1, 0));
+		let f: math.Matrix;
+		const d: math.Matrix = f.subset(math.index(1, 0));
 	}
 
 	// get a sub matrix
@@ -297,7 +296,7 @@ Units examples
 	const b = math.unit('0.1m'); // 100 mm
 
 	// creating units
-	math.createUnit('foo', '12 meters');
+	math.createUnit('foo');
 	math.createUnit('furlong', '220 yards');
 	math.createUnit('furlong', '220 yards', {override: true});
 	math.createUnit('testunit', {definition: '0.555556 kelvin', offset: 459.67});
@@ -310,7 +309,7 @@ Units examples
 		prefixes: 'long'
 	}, {override: true});
 	math.createUnit({
-		foo: {
+		foo_2: {
 			prefixes: 'long'
 		},
 		bar: '40 foo',

From 230bb5bec8137d9cd85c404fdddba87e1c29bb16 Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 18:08:38 -0400
Subject: [PATCH 060/180] Fix header

---
 types/mathjs/index.d.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index a2e2cb8b6b..9e3d14d372 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -1,6 +1,6 @@
 // Type definitions for mathjs 4.4.2
-// Project: http://mathjs.org/ Definitions by:
-//                  Ilya Shestakov <https://github.com/siavol>,
+// Project: http://mathjs.org/
+// Definitions by: Ilya Shestakov <https://github.com/siavol>,
 //                  Andy Patterson <https://github.com/andnp>,
 //                  Brad Besserman <https://github.com/bradbesserman>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

From 42dd2665ea9f281f10d8161e95319cacde2f4287 Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 18:15:36 -0400
Subject: [PATCH 061/180] Update Typescript version in header

---
 types/mathjs/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index 9e3d14d372..28bc0cc65a 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -4,7 +4,7 @@
 //                  Andy Patterson <https://github.com/andnp>,
 //                  Brad Besserman <https://github.com/bradbesserman>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.8.1
+// TypeScript Version: 2.2
 
 import { Decimal } from "decimal.js";
 

From bbd338282523ada426469735e890a04cef906d0c Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 18:19:21 -0400
Subject: [PATCH 062/180] Update rationalize definition

---
 types/mathjs/index.d.ts | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index 28bc0cc65a..fd9c92b686 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -435,11 +435,8 @@ declare namespace math {
          * expression node (default)
          * @returns The rational polynomial of expr
          */
-        rationalize(
-            expr: MathNode | string,
-            optional: object | boolean,
-            detailed: boolean
-        ): object | MathNode;
+        rationalize(expr: MathNode | string, optional?: object | boolean, detailed?: true): { expression: MathNode | string, variables: string[], coefficients: MathType[] };
+        rationalize(expr: MathNode | string, optional?: object | boolean, detailed?: false): MathNode;
 
         /**
          * Simplify an expression tree.

From 21d6b26b9aefa23b3c43dd1a9da7e44239061b5c Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 18:38:37 -0400
Subject: [PATCH 063/180] Fix Travis CI Build Failures

---
 types/mathjs/index.d.ts | 43 ++++++++++++-----------------------------
 1 file changed, 12 insertions(+), 31 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index fd9c92b686..8a4e9c628b 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -275,7 +275,7 @@ declare namespace math {
          * @returns The created string
          */
         string(
-            value: any | MathArray | Matrix | null
+            value: MathType | null
         ): string | MathArray | Matrix;
 
         /**
@@ -450,7 +450,7 @@ declare namespace math {
          */
         simplify(
             expr: MathNode | string,
-            rules?: ({ l: string; r: string } | string | ((node: MathNode) => MathNode))[],
+            rules?: Array<({ l: string; r: string } | string | ((node: MathNode) => MathNode))>,
             scope?: object
         ): MathNode;
 
@@ -1112,8 +1112,8 @@ declare namespace math {
          * @returns Returns the distance from two/three points
          */
         distance(
-            x: MathArray | Matrix | Object,
-            y: MathArray | Matrix | Object
+            x: MathArray | Matrix | object,
+            y: MathArray | Matrix | object
         ): number | BigNumber;
 
         /**
@@ -1411,9 +1411,9 @@ declare namespace math {
          * @returns A reshaped clone of matrix x
          */
         reshape(
-            x: MathArray | Matrix | any,
+            x: MathArray | Matrix,
             sizes: number[]
-        ): any | MathArray | Matrix;
+        ): MathArray | Matrix;
 
         /**
          * Resize a matrix
@@ -2965,13 +2965,10 @@ declare namespace math {
 
         /**
          * Create a complex value or convert a value to a complex value.
-         */
-        complex(): MathJsChain;
-        /**
          * @param im Argument specifying the imaginary part of the complex
          * number
          */
-        complex(im: number): MathJsChain;
+        complex(im?: number): MathJsChain;
 
         /**
          * Create a user-defined unit and register it with the Unit type.
@@ -3169,7 +3166,7 @@ declare namespace math {
          * @param scope Scope to variables
          */
         simplify(
-            rules?: ({ l: string; r: string } | string | ((node: MathNode) => MathNode))[],
+            rules?: Array<({ l: string; r: string } | string | ((node: MathNode) => MathNode))>,
             scope?: object
         ): MathJsChain;
 
@@ -3241,9 +3238,7 @@ declare namespace math {
          * the inverse of y: x * inv(y).
          * @param y Denominator
          */
-        divide(y: Unit): MathJsChain;
-        divide(y: number): MathJsChain;
-        divide(y: MathType): MathJsChain;
+        divide(y: Unit | Number | MathType): MathJsChain;
 
         /**
          * Divide two matrices element wise. The function accepts both matrices
@@ -3309,10 +3304,7 @@ declare namespace math {
          * the function is evaluated element wise.
          * @param b An integer number
          */
-        lcm(b: number): MathJsChain;
-        lcm(b: BigNumber): MathJsChain;
-        lcm(b: MathArray): MathJsChain;
-        lcm(b: Matrix): MathJsChain;
+        lcm(b: number | BigNumber | MathArray | Matrix): MathJsChain;
 
         /**
          * Calculate the logarithm of a value. For matrices, the function is
@@ -3333,11 +3325,6 @@ declare namespace math {
          * evaluated element wise.
          */
         log1p(base?: number | BigNumber | Complex): MathJsChain;
-        log1p(base?: number | BigNumber | Complex): MathJsChain;
-        log1p(base?: number | BigNumber | Complex): MathJsChain;
-        log1p(base?: number | BigNumber | Complex): MathJsChain;
-        log1p(base?: number | BigNumber | Complex): MathJsChain;
-
         /**
          * Calculate the 2-base of a value. This is the same as calculating
          * log(x, 2). For matrices, the function is evaluated element wise.
@@ -3358,9 +3345,6 @@ declare namespace math {
          * @param y The second value to multiply
          */
         multiply(y: MathType): MathJsChain;
-        multiply(y: Unit): MathJsChain;
-        multiply(y: number): MathJsChain;
-        multiply(y: MathType): MathJsChain;
 
         /**
          * Calculate the norm of a number, vector or matrix. The second
@@ -3467,10 +3451,7 @@ declare namespace math {
          * print base.
          * @param y Second value to or
          */
-        bitOr(y: number): MathJsChain;
-        bitOr(y: BigNumber): MathJsChain;
-        bitOr(y: MathArray): MathJsChain;
-        bitOr(y: Matrix): MathJsChain;
+        bitOr(y: number | BigNumber | MathArray | Matrix): MathJsChain;
 
         /**
          * Bitwise XOR two values, x ^ y. For matrices, the function is
@@ -3585,7 +3566,7 @@ declare namespace math {
          * c)
          * @param y Coordinates of the second point
          */
-        distance(y: MathArray | Matrix | Object): MathJsChain;
+        distance(y: MathArray | Matrix | object): MathJsChain;
 
         /**
          * Calculates the point of intersection of two lines in two or three

From 4d4c9a47d755466172d791f40b32ad7d5fd12e26 Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Sun, 10 Jun 2018 19:32:09 -0400
Subject: [PATCH 064/180] Fix Travis CI Build Failure Pt. 2

---
 types/mathjs/index.d.ts      | 63 ++++++++++++++++--------------------
 types/mathjs/mathjs-tests.ts |  7 ++--
 2 files changed, 31 insertions(+), 39 deletions(-)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index 8a4e9c628b..a09b23bae9 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for mathjs 4.4.2
+// Type definitions for mathjs 4.4
 // Project: http://mathjs.org/
 // Definitions by: Ilya Shestakov <https://github.com/siavol>,
 //                  Andy Patterson <https://github.com/andnp>,
@@ -74,7 +74,7 @@ declare namespace math {
          * @param signatures Object with one or multiple function signatures
          * @returns The created typed-function.
          */
-        typed: (name: string, signatures: Record<string, Function>) => Function;
+        typed: (name: string, signatures: Record<string, (...args: any[]) => any>) => ((...args: any[]) => any);
 
         /*************************************************************************
          * Construction functions
@@ -327,7 +327,7 @@ declare namespace math {
          * @param search A function or function name for which to get help
          * @returns A help object
          */
-        help(search: Function | string | object): Help;
+        help(search: () => any): Help;
 
         /**
          * Parse an expression. Returns a node tree, which can be evaluated by
@@ -364,7 +364,7 @@ declare namespace math {
         derivative(
             expr: MathNode | string,
             variable: MathNode | string,
-            options?: object
+            options?: {simplify: boolean}
         ): MathNode;
 
         /**
@@ -1297,7 +1297,7 @@ declare namespace math {
          */
         filter(
             x: Matrix | MathArray,
-            test: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray) | RegExp
+            test: ((value: any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray) | RegExp
         ): Matrix | MathArray;
 
         /**
@@ -1315,7 +1315,7 @@ declare namespace math {
          * parameters: the value of the element, the index of the element, and
          * the Matrix/array being traversed.
          */
-        forEach(x: Matrix | MathArray, callback: ((value:any, index: any, matrix: Matrix | MathArray)=>void)): void;
+        forEach(x: Matrix | MathArray, callback: ((value: any, index: any, matrix: Matrix | MathArray) => void)): void;
 
         /**
          * Calculate the inverse of a square matrix.
@@ -1343,7 +1343,7 @@ declare namespace math {
          * the Matrix/array being traversed.
          * @returns Transformed map of x
          */
-        map(x: Matrix | MathArray, callback: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray)): Matrix | MathArray;
+        map(x: Matrix | MathArray, callback: ((value: any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray)): Matrix | MathArray;
 
         /**
          * Create a matrix filled with ones. The created matrix can have one or
@@ -1448,7 +1448,7 @@ declare namespace math {
          */
         sort(
             x: Matrix | MathArray,
-            compare: ((a:any, b:any)=>number) | "asc" | "desc" | "natural"
+            compare: ((a: any, b: any) => number) | "asc" | "desc" | "natural"
         ): Matrix | MathArray;
 
         /**
@@ -2129,7 +2129,7 @@ declare namespace math {
         format(
             value: any,
             options?: FormatOptions | number | ((item: any) => string),
-            callback?: ((value:any)=>string)
+            callback?: ((value: any) => string)
         ): string;
 
         /**
@@ -2518,7 +2518,7 @@ declare namespace math {
          * boolean. Returns false for other types. Throws an error in case of
          * unknown types.
          */
-        isNumeric(x: any): boolean;
+        isNumeric(x: any): x is number | BigNumber | Fraction | boolean;
 
         /**
          * Test whether a value is positive: larger than zero. The function
@@ -2600,7 +2600,7 @@ declare namespace math {
         ): void;
         toArray(): MathArray | Matrix;
         valueOff(): MathArray | Matrix;
-        format(options?: FormatOptions | number | ((value:any)=>string)): string;
+        format(options?: FormatOptions | number | ((value: any) => string)): string;
         toString(): string;
         toJSON(): any;
         diagonal(k?: number | BigNumber): any[];
@@ -3107,7 +3107,7 @@ declare namespace math {
          * @param options There is one option available, simplify, which is true
          * by default. When false, output will not be simplified.
          */
-        derivative(variable: MathNode | string, options?: object): MathJsChain;
+        derivative(variable: MathNode | string, options?: {simplify: boolean}): MathJsChain;
 
         /**
          * Solves the linear equation system by forwards substitution. Matrix
@@ -3155,7 +3155,7 @@ declare namespace math {
          * @param detailed  optional True if return an object, false if return
          * expression node (default)
          */
-        rationalize(optional: object | boolean, detailed: boolean): MathJsChain;
+        rationalize(optional?: object | boolean, detailed?: boolean): MathJsChain;
 
         /**
          * Simplify an expression tree.
@@ -3238,7 +3238,7 @@ declare namespace math {
          * the inverse of y: x * inv(y).
          * @param y Denominator
          */
-        divide(y: Unit | Number | MathType): MathJsChain;
+        divide(y: MathType): MathJsChain;
 
         /**
          * Divide two matrices element wise. The function accepts both matrices
@@ -3698,7 +3698,7 @@ declare namespace math {
         /**
          * Filter the items in an array or one dimensional matrix.
          */
-        filter(test: ((value:any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray)| RegExp): MathJsChain;
+        filter(test: ((value: any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray)| RegExp): MathJsChain;
 
         /**
          * Flatten a multi dimensional matrix into a single dimensional matrix.
@@ -3709,7 +3709,7 @@ declare namespace math {
          * Iterate over all elements of a matrix/array, and executes the given
          * callback function.
          */
-        forEach(callback: ((value:any, index: any, matrix: Matrix | MathArray)=>void)): MathJsChain;
+        forEach(callback: ((value: any, index: any, matrix: Matrix | MathArray) => void)): MathJsChain;
 
         /**
          * Calculate the inverse of a square matrix.
@@ -3729,7 +3729,7 @@ declare namespace math {
          * parameters: the value of the element, the index of the element, and
          * the Matrix/array being traversed.
          */
-        map(callback: ((value:any, index: any, matrix: Matrix | MathArray)=>Matrix | MathArray)): MathJsChain;
+        map(callback: ((value: any, index: any, matrix: Matrix | MathArray) => Matrix | MathArray)): MathJsChain;
 
         /**
          * Create a matrix filled with ones. The created matrix can have one or
@@ -3800,7 +3800,7 @@ declare namespace math {
          * is called as compare(a, b), and must return 1 when a > b, -1 when a <
          * b, and 0 when a == b. Default value: ‘asc’
          */
-        sort(compare: ((a:any, b:any)=>number) | "asc" | "desc" | "natural"): MathJsChain;
+        sort(compare: ((a: any, b: any) => number) | "asc" | "desc" | "natural"): MathJsChain;
 
         /**
          * Calculate the principal square root of a square matrix. The principal
@@ -3918,8 +3918,10 @@ declare namespace math {
          * @param min Minimum boundary for the random value, included
          * @param max Maximum boundary for the random value, excluded
          */
-        random(max?: number): number;
-        random(min?: number, max?: number): MathJsChain;
+        // tslint:disable-next-line unified-signatures
+        random(max?: number): MathJsChain;
+        // tslint:disable-next-line unified-signatures
+        random(min: number, max: number): MathJsChain;
 
         /**
          * Return a random integer number larger or equal to min and smaller
@@ -3927,8 +3929,10 @@ declare namespace math {
          * @param min Minimum boundary for the random value, included
          * @param max Maximum boundary for the random value, excluded
          */
+        // tslint:disable-next-line unified-signatures
         randomInt(max?: number): MathJsChain;
-        randomInt(min?: number, max?: number): MathJsChain;
+        // tslint:disable-next-line unified-signatures
+        randomInt(min: number, max: number): MathJsChain;
 
         /*************************************************************************
          * Relational functions
@@ -4146,9 +4150,6 @@ declare namespace math {
          * of a multi dimensional array, the maximum of the flattened array will
          * be calculated. When dim is provided, the maximum over the selected
          * dimension will be calculated. Parameter dim is zero-based.
-         */
-        max(): MathJsChain;
-        /**
          * @param dim The maximum over the selected dimension
          */
         max(dim?: number): MathJsChain;
@@ -4158,9 +4159,6 @@ declare namespace math {
          * multi dimensional array, the mean of the flattened array will be
          * calculated. When dim is provided, the maximum over the selected
          * dimension will be calculated. Parameter dim is zero-based.
-         */
-        mean(): MathJsChain;
-        /**
          * @param dim The mean over the selected dimension
          */
         mean(dim?: number): MathJsChain;
@@ -4180,11 +4178,7 @@ declare namespace math {
          * a multi dimensional array, the maximum of the flattened array will be
          * calculated. When dim is provided, the maximum over the selected
          * dimension will be calculated. Parameter dim is zero-based.
-         */
-        min(): MathJsChain;
-        /**
          * @param dim The minimum over the selected dimension
-         * @returns The minimum value
          */
         min(dim?: number): MathJsChain;
 
@@ -4257,13 +4251,10 @@ declare namespace math {
          * 1) Note that older browser may not like the variable name var. In
          * that case, the function can be called as math['var'](...) instead of
          * math.var(...).
-         * @returns The variance
-         */
-        var(): MathJsChain;
-        /**
          * @param normalization normalization Determines how to normalize the
          * variance. Choose ‘unbiased’ (default), ‘uncorrected’, or ‘biased’.
          * Default value: ‘unbiased’.
+         * @returns The variance
          */
         var(
             normalization?: "unbiased" | "uncorrected" | "biased" | "unbiased"
@@ -4287,7 +4278,7 @@ declare namespace math {
         format(
             value: any,
             options?: FormatOptions | number | ((item: any) => string),
-            callback?: ((value:any)=>string)
+            callback?: ((value: any) => string)
         ): MathJsChain;
 
         /**
diff --git a/types/mathjs/mathjs-tests.ts b/types/mathjs/mathjs-tests.ts
index 455b1fdaee..4db5261f9f 100644
--- a/types/mathjs/mathjs-tests.ts
+++ b/types/mathjs/mathjs-tests.ts
@@ -236,7 +236,7 @@ Matrices examples
 
 		b.subset(math.index(1, [0, 1]), [[7, 8]]);
 		const c = math.multiply(a, b);
-		let f: math.Matrix;
+		const f: math.Matrix = math.matrix([1, 0]);
 		const d: math.Matrix = f.subset(math.index(1, 0));
 	}
 
@@ -282,8 +282,9 @@ Sparse matrices examples
 	// do operations with a sparse matrix
 	const b = math.multiply(a, a);
 	const c = math.multiply(b, math.complex(2, 2));
-	const d = math.transpose((<math.Matrix>c));
-	const e = math.multiply(d, a);
+	const d = math.matrix([0, 1]);
+	const e = math.transpose(d);
+	const f = math.multiply(e, a);
 }
 
 /*

From e92cbae330f310b6af88a42d4ef2b93112f605a3 Mon Sep 17 00:00:00 2001
From: Harm van der Werf <harmvdwerf@gmail.com>
Date: Mon, 11 Jun 2018 10:06:14 +0200
Subject: [PATCH 065/180] Made "on" function compatible with current plugin
 version

---
 types/chai-spies/chai-spies-tests.ts |  7 ++++++-
 types/chai-spies/index.d.ts          | 16 +++++++++-------
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/types/chai-spies/chai-spies-tests.ts b/types/chai-spies/chai-spies-tests.ts
index 1d99f0add2..dcff5a9cdd 100644
--- a/types/chai-spies/chai-spies-tests.ts
+++ b/types/chai-spies/chai-spies-tests.ts
@@ -24,7 +24,12 @@ let array = [ 1, 2, 3 ];
 chai.spy.on(array, 'push');
 
 // or you can track multiple object's methods
-chai.spy.on(array, 'push', 'pop');
+chai.spy.on(array, ['push', 'pop']);
+
+// or you can track multiple object's methods
+chai.spy.on(array, 'push', function(item) {
+    array.push(item);
+});
 
 array.push(5);
 
diff --git a/types/chai-spies/index.d.ts b/types/chai-spies/index.d.ts
index ffed6e594b..1ad4a5c76a 100644
--- a/types/chai-spies/index.d.ts
+++ b/types/chai-spies/index.d.ts
@@ -1,6 +1,7 @@
 // Type definitions for chai-spies
 // Project: https://github.com/chaijs/chai-spies
 // Definitions by: Ilya Kuznetsov <https://github.com/kuzn-ilya>
+//                 Harm van der Werf <https://github.com/harm-less>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /// <reference types="chai" />
@@ -81,10 +82,11 @@ declare namespace ChaiSpies {
          * var spy = chai.spy.on(Array, 'isArray');
          * ```
          * @param {Object} object
-         * @param {String} method name to spy on
+         * @param {String} methodNames name to spy on
+         * @param {function} fn replacement function
          * @returns function to actually call
-         */ 
-        on(object: Object, ...methodNames: string[]): any;
+         */
+        on(object: Object, methodNames: string | string[], fn?: (parameters: any) => any): any;
 
         /**
          * #### chai.spy.object (function)
@@ -97,10 +99,10 @@ declare namespace ChaiSpies {
          * @param {String[]|Object} method names or method definitions
          * @returns object with spied methods
          */
-        object(name: string, methods: string[]): any;           
-        object(methods: string[]): any;           
-        object<T>(name: string, methods: T): T;           
-        object<T>(methods: T): T;           
+        object(name: string, methods: string[]): any;
+        object(methods: string[]): any;
+        object<T>(name: string, methods: T): T;
+        object<T>(methods: T): T;
 
         /**
          * #### chai.spy.returns (function)

From e58013cfe54bc6b55ceb57171d50345987c40a6e Mon Sep 17 00:00:00 2001
From: Harm van der Werf <harmvdwerf@gmail.com>
Date: Mon, 11 Jun 2018 10:42:59 +0200
Subject: [PATCH 066/180] Fixed an error

---
 types/chai-spies/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/chai-spies/index.d.ts b/types/chai-spies/index.d.ts
index 1ad4a5c76a..ba7798b714 100644
--- a/types/chai-spies/index.d.ts
+++ b/types/chai-spies/index.d.ts
@@ -86,7 +86,7 @@ declare namespace ChaiSpies {
          * @param {function} fn replacement function
          * @returns function to actually call
          */
-        on(object: Object, methodNames: string | string[], fn?: (parameters: any) => any): any;
+        on(object: Object, methodNames: string | string[], fn?: (parameters: any[]) => any): any;
 
         /**
          * #### chai.spy.object (function)

From b2048c187befc9d4822960218e0a9d092bcfa240 Mon Sep 17 00:00:00 2001
From: Georgii Dolzhykov <thorn.mailbox@gmail.com>
Date: Mon, 4 Jun 2018 00:32:48 +0300
Subject: [PATCH 067/180] angular-mocks: add browserTrigger, expectRoute,
 whenRoute; refactoring

---
 types/angular-mocks/angular-mocks-tests.ts | 1549 ++++++++++++++++----
 types/angular-mocks/index.d.ts             |  634 +++++---
 types/angular-mocks/mocks.d.ts             |    8 +-
 types/angular-mocks/tslint.json            |   85 +-
 types/bardjs/index.d.ts                    |    2 +-
 5 files changed, 1730 insertions(+), 548 deletions(-)

diff --git a/types/angular-mocks/angular-mocks-tests.ts b/types/angular-mocks/angular-mocks-tests.ts
index cabbf7c578..f04c9a2a30 100644
--- a/types/angular-mocks/angular-mocks-tests.ts
+++ b/types/angular-mocks/angular-mocks-tests.ts
@@ -1,70 +1,91 @@
-
 ///////////////////////////////////////
 // IAngularStatic
 ///////////////////////////////////////
-var angular: ng.IAngularStatic;
-var mock: ng.IMockStatic;
+let angular: ng.IAngularStatic;
+let mock: ng.IMockStatic;
 
 mock = angular.mock;
 
-
 ///////////////////////////////////////
 // IMockStatic
 ///////////////////////////////////////
-var date: Date;
+let date: Date;
 
 mock.dump({ key: 'value' });
 
 mock.inject(
-    function () { return 1; },
-    function () { return 2; }
-    );
+  function() {
+    return 1;
+  },
+  function() {
+    return 2;
+  }
+);
 
-mock.inject(
-    ['$rootScope', function ($rootScope: ng.IRootScopeService) { return 1; }]);
+mock.inject([
+  '$rootScope',
+  function($rootScope: ng.IRootScopeService) {
+    return 1;
+  }
+]);
 
 // This overload is not documented on the website, but flows from
 // how the injector works.
 mock.inject(
-    ['$rootScope', function ($rootScope: ng.IRootScopeService) { return 1; }],
-    ['$rootScope', function ($rootScope: ng.IRootScopeService) { return 2; }]);
+  [
+    '$rootScope',
+    function($rootScope: ng.IRootScopeService) {
+      return 1;
+    }
+  ],
+  [
+    '$rootScope',
+    function($rootScope: ng.IRootScopeService) {
+      return 2;
+    }
+  ]
+);
 
 mock.module('module1', 'module2');
 mock.module(
-    function () { return 1; },
-    function () { return 2; }
-    );
-mock.module({ module1: function () { return 1; } });
+  function() {
+    return 1;
+  },
+  function() {
+    return 2;
+  }
+);
+mock.module({
+  module1: () => {
+    return 1;
+  }
+});
 mock.module.sharedInjector();
 
 date = mock.TzDate(-7, '2013-1-1T15:00:00Z');
 date = mock.TzDate(-8, 12345678);
 
-
 ///////////////////////////////////////
 // IExceptionHandlerProvider
 ///////////////////////////////////////
-var exceptionHandlerProvider: ng.IExceptionHandlerProvider;
+let exceptionHandlerProvider: ng.IExceptionHandlerProvider;
 
 exceptionHandlerProvider.mode('log');
 
-
 ///////////////////////////////////////
 // ITimeoutService
 ///////////////////////////////////////
-var timeoutService: ng.ITimeoutService;
+let timeoutService: ng.ITimeoutService;
 
 timeoutService.flush();
 timeoutService.flush(1234);
-timeoutService.flushNext();
-timeoutService.flushNext(1234);
 timeoutService.verifyNoPendingTasks();
 
 ////////////////////////////////////////
 // IIntervalService
 ////////////////////////////////////////
-var intervalService: ng.IIntervalService;
-var intervalServiceTimeActuallyAdvanced: number;
+let intervalService: ng.IIntervalService;
+let intervalServiceTimeActuallyAdvanced: number;
 
 intervalServiceTimeActuallyAdvanced = intervalService.flush();
 intervalServiceTimeActuallyAdvanced = intervalService.flush(1234);
@@ -72,9 +93,9 @@ intervalServiceTimeActuallyAdvanced = intervalService.flush(1234);
 ///////////////////////////////////////
 // ILogService, ILogCall
 ///////////////////////////////////////
-var logService: ng.ILogService;
-var logCall: ng.ILogCall;
-var logs: string[];
+let logService: ng.ILogService;
+let logCall: ng.ILogCall;
+let logs: string[];
 
 logService.assertEmpty();
 logService.reset();
@@ -90,29 +111,31 @@ logs = logCall.logs;
 ///////////////////////////////////////
 // ControllerService mock
 ///////////////////////////////////////
-var $controller: ng.IControllerService;
-$controller(class TestController {}, {}, {myBinding: 'works!'});
-$controller(function TestController() {}, {someLocal: 42}, {myBinding: 'works!'});
-$controller('TestController', {}, {myBinding: 'works!'});
-
+let $controller: ng.IControllerService;
+$controller(class TestController {}, {}, { myBinding: 'works!' });
+$controller(function TestController() {}, { someLocal: 42 }, { myBinding: 'works!' });
+$controller('TestController', {}, { myBinding: 'works!' });
 
 ///////////////////////////////////////
 // IComponentControllerService
 ///////////////////////////////////////
-var $componentController: ng.IComponentControllerService;
-$componentController<{}, {}>('Test controller', { $scope: <ng.IScope>{} });
-$componentController<{}, {}>('Test controller', { $scope: <ng.IScope>{}, test: true });
-$componentController<{}, { test: boolean }>('Test controller', { $scope: <ng.IScope>{} }, { test: true});
-$componentController<{}, { test?: boolean }>('Test controller', { $scope: <ng.IScope>{} }, {});
-$componentController<{}, {}>('Test controller', { $scope: <ng.IScope>{} }, {}, 'identity');
-$componentController<{ cb: () => void }, {}>('Test controller', { $scope: <ng.IScope>{} });
-$componentController<{}, { test: {name: string} }>('Test controller', { test: {name: 'Test Local'} });
+let $componentController: ng.IComponentControllerService;
+let $scope: ng.IScope;
+$componentController<{}, {}>('Test controller', { $scope });
+$componentController<{}, {}>('Test controller', { $scope, test: true });
+$componentController<{}, { test: boolean }>('Test controller', { $scope }, { test: true });
+$componentController<{}, { test?: boolean }>('Test controller', { $scope }, {});
+$componentController<{}, {}>('Test controller', { $scope }, {}, 'identity');
+$componentController<{ cb: () => void }, {}>('Test controller', { $scope });
+$componentController<{}, { test: { name: string } }>('Test controller', {
+  test: { name: 'Test Local' }
+});
 
 ///////////////////////////////////////
 // IHttpBackendService
 ///////////////////////////////////////
-var httpBackendService: ng.IHttpBackendService;
-var requestHandler: ng.mock.IRequestHandler;
+let httpBackendService: ng.IHttpBackendService;
+let requestHandler: ng.mock.IRequestHandler;
 
 httpBackendService.flush();
 httpBackendService.flush(1234);
@@ -123,342 +146,1362 @@ httpBackendService.verifyNoOutstandingRequest();
 
 requestHandler = httpBackendService.expect('GET', 'http://test.local');
 requestHandler = httpBackendService.expect('GET', 'http://test.local', 'response data');
-requestHandler = httpBackendService.expect('GET', 'http://test.local', 'response data', { header: 'value' });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', 'response data', function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.expect('GET', 'http://test.local', 'response data', {
+  header: 'value'
+});
+requestHandler = httpBackendService.expect('GET', 'http://test.local', 'response data', function(
+  headers: object
+): boolean {
+  return true;
+});
 requestHandler = httpBackendService.expect('GET', 'http://test.local', /response data/);
-requestHandler = httpBackendService.expect('GET', 'http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.expect('GET', 'http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.expect('GET', 'http://test.local', /response data/, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect('GET', 'http://test.local', function(
+  data: string
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
 requestHandler = httpBackendService.expect('GET', 'http://test.local', { key: 'value' });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', 'http://test.local', { key: 'value' }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.expect(
+  'GET',
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect('GET', 'http://test.local', { key: 'value' }, function(
+  headers: object
+): boolean {
+  return true;
+});
 requestHandler = httpBackendService.expect('GET', /test.local/);
 requestHandler = httpBackendService.expect('GET', /test.local/, 'response data');
-requestHandler = httpBackendService.expect('GET', /test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expect('GET', /test.local/, 'response data', function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', /test.local\/(\d+)/, 'response data', function (headers: Object): boolean { return true; }, ['id']);
+requestHandler = httpBackendService.expect('GET', /test.local/, 'response data', {
+  header: 'value'
+});
+requestHandler = httpBackendService.expect('GET', /test.local/, 'response data', function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local\/(\d+)/,
+  'response data',
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
 requestHandler = httpBackendService.expect('GET', /test.local/, /response data/);
-requestHandler = httpBackendService.expect('GET', /test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', /test.local/, /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', /test.local\/(\d+)/, /response data/, function (headers: Object): boolean { return true; }, ['id']);
-requestHandler = httpBackendService.expect('GET', /test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', /test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', /test.local/, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', /test.local\/(\d+)/, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; }, ['id']);
+requestHandler = httpBackendService.expect('GET', /test.local/, /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.expect('GET', /test.local/, /response data/, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local\/(\d+)/,
+  /response data/,
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
+requestHandler = httpBackendService.expect('GET', /test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
 requestHandler = httpBackendService.expect('GET', /test.local/, { key: 'value' });
-requestHandler = httpBackendService.expect('GET', /test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', /test.local/, { key: 'value' }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', /test.local\/(\d+)/, { key: 'value' }, function (headers: Object): boolean { return true; }, ['id']);
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, 'response data', function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expect('GET', (url: string) => { return true; }, { key: 'value' }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local/,
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect('GET', /test.local/, { key: 'value' }, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
+requestHandler = httpBackendService.expect('GET', (url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data'
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expect(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  function(headers: object): boolean {
+    return true;
+  }
+);
 
 requestHandler = httpBackendService.expectDELETE('http://test.local');
 requestHandler = httpBackendService.expectDELETE('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.expectDELETE(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.expectDELETE(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectDELETE((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectDELETE(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectGET('http://test.local');
 requestHandler = httpBackendService.expectGET('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.expectGET(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.expectGET(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectGET((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectGET(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectHEAD('http://test.local');
 requestHandler = httpBackendService.expectHEAD('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.expectHEAD(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.expectHEAD(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectHEAD((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectHEAD(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectJSONP('http://test.local');
 requestHandler = httpBackendService.expectJSONP(/test.local/);
 requestHandler = httpBackendService.expectJSONP(/test.local\/(\d+)/, ['id']);
-requestHandler = httpBackendService.expectJSONP((url: string) => { return true; });
+requestHandler = httpBackendService.expectJSONP((url: string) => {
+  return true;
+});
 
 requestHandler = httpBackendService.expectPATCH('http://test.local');
 requestHandler = httpBackendService.expectPATCH('http://test.local', 'response data');
-requestHandler = httpBackendService.expectPATCH('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.expectPATCH('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.expectPATCH('http://test.local', /response data/);
-requestHandler = httpBackendService.expectPATCH('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPATCH('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectPATCH('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.expectPATCH('http://test.local', function(
+  data: string
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPATCH(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPATCH('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.expectPATCH('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPATCH(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPATCH(/test.local/);
 requestHandler = httpBackendService.expectPATCH(/test.local/, 'response data');
 requestHandler = httpBackendService.expectPATCH(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPATCH(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.expectPATCH(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.expectPATCH(/test.local/, /response data/);
 requestHandler = httpBackendService.expectPATCH(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPATCH(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH(/test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
+requestHandler = httpBackendService.expectPATCH(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPATCH(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH(
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.expectPATCH(/test.local/, { key: 'value' });
-requestHandler = httpBackendService.expectPATCH(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.expectPATCH((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPATCH(
+  /test.local/,
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.expectPATCH((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.expectPATCH((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.expectPATCH(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 requestHandler = httpBackendService.expectPOST('http://test.local');
 requestHandler = httpBackendService.expectPOST('http://test.local', 'response data');
-requestHandler = httpBackendService.expectPOST('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.expectPOST('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.expectPOST('http://test.local', /response data/);
-requestHandler = httpBackendService.expectPOST('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPOST('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPOST('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectPOST('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.expectPOST('http://test.local', function(
+  data: string
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPOST(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPOST('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.expectPOST('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPOST(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPOST(/test.local/);
 requestHandler = httpBackendService.expectPOST(/test.local/, 'response data');
 requestHandler = httpBackendService.expectPOST(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPOST(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.expectPOST(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.expectPOST(/test.local/, /response data/);
 requestHandler = httpBackendService.expectPOST(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPOST(/test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectPOST(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPOST(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectPOST(
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.expectPOST(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPOST(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPOST(/test.local/, { key: 'value' });
 requestHandler = httpBackendService.expectPOST(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expectPOST(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.expectPOST((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPOST(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.expectPOST((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.expectPOST((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPOST((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.expectPOST(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 requestHandler = httpBackendService.expectPUT('http://test.local');
 requestHandler = httpBackendService.expectPUT('http://test.local', 'response data');
-requestHandler = httpBackendService.expectPUT('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.expectPUT('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.expectPUT('http://test.local', /response data/);
-requestHandler = httpBackendService.expectPUT('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPUT('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPUT('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.expectPUT('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.expectPUT('http://test.local', function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPUT(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPUT('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.expectPUT('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPUT(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.expectPUT(/test.local/);
 requestHandler = httpBackendService.expectPUT(/test.local/, 'response data');
 requestHandler = httpBackendService.expectPUT(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPUT(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.expectPUT(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.expectPUT(/test.local/, /response data/);
 requestHandler = httpBackendService.expectPUT(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPUT(/test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectPUT(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPUT(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expectPUT(/test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
+requestHandler = httpBackendService.expectPUT(
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.expectPUT(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.expectPUT(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPUT(
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.expectPUT(/test.local/, { key: 'value' });
 requestHandler = httpBackendService.expectPUT(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.expectPUT(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.expectPUT((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.expectPUT(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.expectPUT((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.expectPUT((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPUT((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.expectPUT(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 requestHandler = httpBackendService.when('GET', 'http://test.local');
 requestHandler = httpBackendService.when('GET', 'http://test.local', 'response data');
-requestHandler = httpBackendService.when('GET', 'http://test.local', 'response data', { header: 'value' });
-requestHandler = httpBackendService.when('GET', 'http://test.local', 'response data', function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.when('GET', 'http://test.local', 'response data', {
+  header: 'value'
+});
+requestHandler = httpBackendService.when('GET', 'http://test.local', 'response data', function(
+  headers: object
+): boolean {
+  return true;
+});
 requestHandler = httpBackendService.when('GET', 'http://test.local', /response data/);
-requestHandler = httpBackendService.when('GET', 'http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.when('GET', 'http://test.local', /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', 'http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.when('GET', 'http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', 'http://test.local', function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.when('GET', 'http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.when('GET', 'http://test.local', /response data/, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when('GET', 'http://test.local', function(
+  data: string
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
 requestHandler = httpBackendService.when('GET', 'http://test.local', { key: 'value' });
-requestHandler = httpBackendService.when('GET', 'http://test.local', { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', 'http://test.local', { key: 'value' }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.when(
+  'GET',
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when('GET', 'http://test.local', { key: 'value' }, function(
+  headers: object
+): boolean {
+  return true;
+});
 requestHandler = httpBackendService.when('GET', /test.local/);
 requestHandler = httpBackendService.when('GET', /test.local/, 'response data');
 requestHandler = httpBackendService.when('GET', /test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
-requestHandler = httpBackendService.when('GET', /test.local/, 'response data', function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, 'response data', function (headers: Object): boolean { return true; }, ['id']);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.when('GET', /test.local/, 'response data', function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  'response data',
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
 requestHandler = httpBackendService.when('GET', /test.local/, /response data/);
 requestHandler = httpBackendService.when('GET', /test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.when('GET', /test.local/, /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, /response data/, function (headers: Object): boolean { return true; }, ['id']);
-requestHandler = httpBackendService.when('GET', /test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.when('GET', /test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.when('GET', /test.local/, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; }, ['id']);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.when('GET', /test.local/, /response data/, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  /response data/,
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
+requestHandler = httpBackendService.when('GET', /test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
 requestHandler = httpBackendService.when('GET', /test.local/, { key: 'value' });
-requestHandler = httpBackendService.when('GET', /test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.when('GET', /test.local/, { key: 'value' }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', /test.local\/(\d+)/, { key: 'value' }, function (headers: Object): boolean { return true; }, ['id']);
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, 'response data', function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, /response data/, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, function (data: string): boolean { return true; }, function (headers: Object): boolean { return true; });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.when('GET', (url: string) => { return true; }, { key: 'value' }, function (headers: Object): boolean { return true; });
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local/,
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.when('GET', /test.local/, { key: 'value' }, function(
+  headers: object
+): boolean {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  function(headers: object): boolean {
+    return true;
+  },
+  ['id']
+);
+requestHandler = httpBackendService.when('GET', (url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data'
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  function(headers: object): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.when(
+  'GET',
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  function(headers: object): boolean {
+    return true;
+  }
+);
 
 requestHandler = httpBackendService.whenDELETE('http://test.local');
 requestHandler = httpBackendService.whenDELETE('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.whenDELETE(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.whenDELETE(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenDELETE((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenDELETE(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenGET('http://test.local');
 requestHandler = httpBackendService.whenGET('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.whenGET(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.whenGET(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenGET((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenGET(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenHEAD('http://test.local');
 requestHandler = httpBackendService.whenHEAD('http://test.local', { header: 'value' });
 requestHandler = httpBackendService.whenHEAD(/test.local/, { header: 'value' });
 requestHandler = httpBackendService.whenHEAD(/test.local\/(\d+)/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenHEAD((url: string) => { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenHEAD(
+  (url: string) => {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenJSONP('http://test.local');
 requestHandler = httpBackendService.whenJSONP(/test.local/);
 requestHandler = httpBackendService.whenJSONP(/test.local\/(\d+)/, ['id']);
-requestHandler = httpBackendService.whenJSONP((url: string) => { return true; });
+requestHandler = httpBackendService.whenJSONP((url: string) => {
+  return true;
+});
 
 requestHandler = httpBackendService.whenPATCH('http://test.local');
 requestHandler = httpBackendService.whenPATCH('http://test.local', 'response data');
-requestHandler = httpBackendService.whenPATCH('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.whenPATCH('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.whenPATCH('http://test.local', /response data/);
-requestHandler = httpBackendService.whenPATCH('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPATCH('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenPATCH('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.whenPATCH('http://test.local', function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPATCH(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPATCH('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.whenPATCH('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.whenPATCH(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPATCH(/test.local/);
 requestHandler = httpBackendService.whenPATCH(/test.local/, 'response data');
 requestHandler = httpBackendService.whenPATCH(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPATCH(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPATCH(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPATCH(/test.local/, /response data/);
 requestHandler = httpBackendService.whenPATCH(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH(/test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPATCH(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPATCH(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH(/test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPATCH(
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPATCH(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPATCH(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPATCH(
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPATCH(/test.local/, { key: 'value' });
 requestHandler = httpBackendService.whenPATCH(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.whenPATCH((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.whenPATCH(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPATCH((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.whenPATCH((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPATCH((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.whenPATCH(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 requestHandler = httpBackendService.whenPOST('http://test.local');
 requestHandler = httpBackendService.whenPOST('http://test.local', 'response data');
-requestHandler = httpBackendService.whenPOST('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.whenPOST('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.whenPOST('http://test.local', /response data/);
-requestHandler = httpBackendService.whenPOST('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPOST('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPOST('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenPOST('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.whenPOST('http://test.local', function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPOST(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPOST('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.whenPOST('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.whenPOST(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPOST(/test.local/);
 requestHandler = httpBackendService.whenPOST(/test.local/, 'response data');
 requestHandler = httpBackendService.whenPOST(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPOST(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPOST(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPOST(/test.local/, /response data/);
 requestHandler = httpBackendService.whenPOST(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPOST(/test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPOST(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPOST(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPOST(/test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPOST(
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPOST(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPOST(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPOST(
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPOST(/test.local/, { key: 'value' });
 requestHandler = httpBackendService.whenPOST(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.whenPOST(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.whenPOST((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.whenPOST(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPOST((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.whenPOST((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPOST((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.whenPOST(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 requestHandler = httpBackendService.whenPUT('http://test.local');
 requestHandler = httpBackendService.whenPUT('http://test.local', 'response data');
-requestHandler = httpBackendService.whenPUT('http://test.local', 'response data', { header: 'value' });
+requestHandler = httpBackendService.whenPUT('http://test.local', 'response data', {
+  header: 'value'
+});
 requestHandler = httpBackendService.whenPUT('http://test.local', /response data/);
-requestHandler = httpBackendService.whenPUT('http://test.local', /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPUT('http://test.local', function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPUT('http://test.local', function (data: string): boolean { return true; }, { header: 'value' });
+requestHandler = httpBackendService.whenPUT('http://test.local', /response data/, {
+  header: 'value'
+});
+requestHandler = httpBackendService.whenPUT('http://test.local', function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPUT(
+  'http://test.local',
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPUT('http://test.local', { key: 'value' });
-requestHandler = httpBackendService.whenPUT('http://test.local', { key: 'value' }, { header: 'value' });
+requestHandler = httpBackendService.whenPUT(
+  'http://test.local',
+  { key: 'value' },
+  { header: 'value' }
+);
 requestHandler = httpBackendService.whenPUT(/test.local/);
 requestHandler = httpBackendService.whenPUT(/test.local/, 'response data');
 requestHandler = httpBackendService.whenPUT(/test.local/, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPUT(/test.local\/(\d+)/, 'response data', { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPUT(
+  /test.local\/(\d+)/,
+  'response data',
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPUT(/test.local/, /response data/);
 requestHandler = httpBackendService.whenPUT(/test.local/, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPUT(/test.local\/(\d+)/, /response data/, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPUT(/test.local/, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPUT(/test.local/, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPUT(/test.local\/(\d+)/, function (data: string): boolean { return true; }, { header: 'value' }, ['id']);
+requestHandler = httpBackendService.whenPUT(
+  /test.local\/(\d+)/,
+  /response data/,
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPUT(/test.local/, function(data: string): boolean {
+  return true;
+});
+requestHandler = httpBackendService.whenPUT(
+  /test.local/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPUT(
+  /test.local\/(\d+)/,
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' },
+  ['id']
+);
 requestHandler = httpBackendService.whenPUT(/test.local/, { key: 'value' });
 requestHandler = httpBackendService.whenPUT(/test.local/, { key: 'value' }, { header: 'value' });
-requestHandler = httpBackendService.whenPUT(/test.local\/(\d+)/, { key: 'value' }, { header: 'value' }, ['id']);
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, 'response data');
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, 'response data', { header: 'value' });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, /response data/);
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, /response data/, { header: 'value' });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, function (data: string): boolean { return true; });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, function (data: string): boolean { return true; }, { header: 'value' });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, { key: 'value' });
-requestHandler = httpBackendService.whenPUT((url: string) => { return true; }, { key: 'value' }, { header: 'value' });
-
+requestHandler = httpBackendService.whenPUT(
+  /test.local\/(\d+)/,
+  { key: 'value' },
+  { header: 'value' },
+  ['id']
+);
+requestHandler = httpBackendService.whenPUT((url: string) => {
+  return true;
+});
+requestHandler = httpBackendService.whenPUT((url: string) => {
+  return true;
+}, 'response data');
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  'response data',
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPUT((url: string) => {
+  return true;
+}, /response data/);
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  /response data/,
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  }
+);
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  function(data: string): boolean {
+    return true;
+  },
+  { header: 'value' }
+);
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' }
+);
+requestHandler = httpBackendService.whenPUT(
+  (url: string) => {
+    return true;
+  },
+  { key: 'value' },
+  { header: 'value' }
+);
 
 ///////////////////////////////////////
 // IRequestHandler
 ///////////////////////////////////////
-var expectedData = { key: 'value'};
+let expectedData = { key: 'value' };
 requestHandler.passThrough();
 requestHandler.passThrough().passThrough();
-requestHandler.respond((method, url, data, headers) => [404, 'data', { header: 'value' }, 'responseText']);
-requestHandler.respond((method, url, data, headers) => [404, 'data', { header: 'value' }, 'responseText']).respond({});
-requestHandler.respond((method, url, data, headers) => { return [404, { key: 'value' }, { header: 'value' }, 'responseText']; });
+requestHandler.respond((method, url, data, headers) => [
+  404,
+  'data',
+  { header: 'value' },
+  'responseText'
+]);
+requestHandler
+  .respond((method, url, data, headers) => [404, 'data', { header: 'value' }, 'responseText'])
+  .respond({});
+requestHandler.respond((method, url, data, headers) => {
+  return [404, { key: 'value' }, { header: 'value' }, 'responseText'];
+});
 requestHandler.respond((method, url, data, headers, params) => {
-    if(params.id === 1) {
-        return [200, { key: 'value'}, { header: 'value'}, 'responseText'];
-    } else {
-        return [404, { key: 'value' }, { header: 'value' }, 'responseText'];
-    }
+  if (params.id === '1') {
+    return [200, { key: 'value' }, { header: 'value' }, 'responseText'];
+  } else {
+    return [404, { key: 'value' }, { header: 'value' }, 'responseText'];
+  }
 });
 requestHandler.respond('data');
 requestHandler.respond('data').respond({});
@@ -471,3 +1514,7 @@ requestHandler.respond(404, 'data').respond({});
 requestHandler.respond(404, { key: 'value' });
 requestHandler.respond(404, { key: 'value' }, { header: 'value' });
 requestHandler.respond(404, { key: 'value' }, { header: 'value' }, 'responseText');
+
+browserTrigger(document.body, 'click');
+browserTrigger(angular.element(document.body), 'click');
+browserTrigger(angular.element(document.body), 'click', { which: 1, keys: ['ctrl'] });
diff --git a/types/angular-mocks/index.d.ts b/types/angular-mocks/index.d.ts
index ac9e6cece3..c652443eac 100644
--- a/types/angular-mocks/index.d.ts
+++ b/types/angular-mocks/index.d.ts
@@ -1,10 +1,9 @@
-// Type definitions for Angular JS (ngMock, ngMockE2E module) 1.5
+// Type definitions for Angular JS (ngMock, ngMockE2E module) 1.6
 // Project: http://angularjs.org
 // Definitions by: Diego Vilar <https://github.com/diegovilar>, Tony Curtis <https://github.com/daltin>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.3
+// TypeScript Version: 2.4
 
-/// <reference types="angular" />
 /// <reference path="mocks.d.ts" />
 
 import * as angular from 'angular';
@@ -13,7 +12,6 @@ import * as angular from 'angular';
 // ngMock module (angular-mocks.js)
 ///////////////////////////////////////////////////////////////////////////////
 declare module 'angular' {
-
   ///////////////////////////////////////////////////////////////////////////
   // AngularStatic
   // We reopen it to add the MockStatic definition
@@ -23,27 +21,27 @@ declare module 'angular' {
   }
 
   // see https://docs.angularjs.org/api/ngMock/function/angular.mock.inject
+  // Depending on context, it might return a function, however having `void | (() => void)`
+  // as a return type seems to be not useful. E.g. it requires type assertions in `beforeEach(inject(...))`.
   interface IInjectStatic {
-    (...fns: Function[]): any;
-    (...inlineAnnotatedConstructor: any[]): any; // this overload is undocumented, but works
-    strictDi(val?: boolean): void;
+    (...fns: Array<Injectable<(...args: any[]) => void>>): any; // void | (() => void);
+    strictDi(val?: boolean): any; // void | (() => void);
   }
 
   interface IMockStatic {
     // see https://docs.angularjs.org/api/ngMock/function/angular.mock.dump
     dump(obj: any): string;
 
-    inject: IInjectStatic
+    inject: IInjectStatic;
 
     // see https://docs.angularjs.org/api/ngMock/function/angular.mock.module
     module: {
       (...modules: any[]): any;
       sharedInjector(): void;
-    }
+    };
 
     // see https://docs.angularjs.org/api/ngMock/type/angular.mock.TzDate
-    TzDate(offset: number, timestamp: number): Date;
-    TzDate(offset: number, timestamp: string): Date;
+    TzDate(offset: number, timestamp: number | string): Date;
   }
 
   ///////////////////////////////////////////////////////////////////////////
@@ -62,7 +60,6 @@ declare module 'angular' {
   ///////////////////////////////////////////////////////////////////////////
   interface ITimeoutService {
     flush(delay?: number): void;
-    flushNext(expectedDelay?: number): void;
     verifyNoPendingTasks(): void;
   }
 
@@ -96,9 +93,11 @@ declare module 'angular' {
   ///////////////////////////////////////////////////////////////////////////
   interface IControllerService {
     // Although the documentation doesn't state this, locals are optional
-    <T>(controllerConstructor: new (...args: any[]) => T, locals?: any, bindings?: any): T;
-    <T>(controllerConstructor: Function, locals?: any, bindings?: any): T;
-    <T>(controllerName: string, locals?: any, bindings?: any): T;
+    <T>(
+      controllerConstructor: (new (...args: any[]) => T) | ((...args: any[]) => T) | string,
+      locals?: any,
+      bindings?: any
+    ): T;
   }
 
   ///////////////////////////////////////////////////////////////////////////
@@ -108,268 +107,473 @@ declare module 'angular' {
   interface IComponentControllerService {
     // TBinding is an interface exposed by a component as per John Papa's style guide
     // https://github.com/johnpapa/angular-styleguide/blob/master/a1/README.md#accessible-members-up-top
-    <T, TBinding>(componentName: string, locals: { $scope?: IScope, [key: string]: any }, bindings?: TBinding, ident?: string): T;
+    <T, TBinding>(
+      componentName: string,
+      locals: { $scope?: IScope; [key: string]: any },
+      bindings?: TBinding,
+      ident?: string
+    ): T;
   }
 
-
   ///////////////////////////////////////////////////////////////////////////
   // HttpBackendService
   // see https://docs.angularjs.org/api/ngMock/service/$httpBackend
   ///////////////////////////////////////////////////////////////////////////
   interface IHttpBackendService {
     /**
-      * Flushes pending requests using the trained responses. Requests are flushed in the order they were made, but it is also possible to skip one or more requests (for example to have them flushed later). This is useful for simulating scenarios where responses arrive from the server in any order.
-      *
-      * If there are no pending requests to flush when the method is called, an exception is thrown (as this is typically a sign of programming error).
-      * @param count Number of responses to flush. If undefined/null, all pending requests (starting after `skip`) will be flushed.
-      * @param skip Number of pending requests to skip. For example, a value of 5 would skip the first 5 pending requests and start flushing from the 6th onwards. _(default: 0)_
-      */
+     * Flushes pending requests using the trained responses. Requests are flushed in the order they
+     * were made, but it is also possible to skip one or more requests (for example to have them
+     * flushed later). This is useful for simulating scenarios where responses arrive from the server
+     * in any order.
+     *
+     * If there are no pending requests to flush when the method is called, an exception is thrown (as
+     * this is typically a sign of programming error).
+     *
+     * @param count Number of responses to flush. If undefined/null, all pending requests (starting
+     * after `skip`) will be flushed.
+     * @param skip Number of pending requests to skip. For example, a value of 5 would skip the first 5 pending requests and start flushing from the 6th onwards. _(default: 0)_
+     */
     flush(count?: number, skip?: number): void;
 
     /**
-      * Resets all request expectations, but preserves all backend definitions.
-      */
+     * Resets all request expectations, but preserves all backend definitions.
+     */
     resetExpectations(): void;
 
     /**
-      * Verifies that all of the requests defined via the expect api were made. If any of the requests were not made, verifyNoOutstandingExpectation throws an exception.
-      * @param digest Do digest before checking expectation. Pass anything except false to trigger digest. NOTE this flag is purposely undocumented by Angular, which means it's not to be used in normal client code.
-      */
+     * Verifies that all of the requests defined via the `expect` api were made. If any of the
+     * requests were not made, verifyNoOutstandingExpectation throws an exception.
+     * @param digest Do digest before checking expectation. Pass anything except false to trigger digest.
+     * NOTE: this flag is purposely undocumented by Angular, which means it's not to be used in normal client code.
+     */
     verifyNoOutstandingExpectation(digest?: boolean): void;
 
     /**
-      * Verifies that there are no outstanding requests that need to be flushed.
-      */
+     * Verifies that there are no outstanding requests that need to be flushed.
+     */
     verifyNoOutstandingRequest(): void;
 
-        /**
-          * Creates a new request expectation.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param method HTTP method.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expect(method: string, url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param method HTTP method.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expect(
+      method: string,
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for DELETE requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url is as expected.
-          * @param headers HTTP headers object to be compared with the HTTP headers in the request.
-          * @param keys Array of keys to assign to regex matches in the request url.
-        */
-    expectDELETE(url: string | RegExp | ((url: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for DELETE requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url is as expected.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectDELETE(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for GET requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object to be compared with the HTTP headers in the request.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expectGET(url: string | RegExp | ((url: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for GET requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectGET(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for HEAD requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object to be compared with the HTTP headers in the request.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
+    /**
+     * Creates a new request expectation for HEAD requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
 
-    expectHEAD(url: string | RegExp | ((url: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    expectHEAD(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for JSONP requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expectJSONP(url: string | RegExp | ((url: string) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for JSONP requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectJSONP(
+      url: string | RegExp | ((url: string) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for PATCH requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expectPATCH(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for PATCH requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectPATCH(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for POST requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expectPOST(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for POST requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectPOST(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new request expectation for PUT requests.
-          * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    expectPUT(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object, keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation for PUT requests.
+     * Throws a preformatted error if expectation(s) don't match supplied string, regular expression, object, or if function returns false.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    expectPUT(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param method HTTP method.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    when(method: string, url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new request expectation that compares only with the requested route.
+     * This method offers colon delimited matching of the url path, ignoring the query string.
+     * This allows declarations similar to how application routes are configured with `$routeProvider`.
+     * As this method converts the definition url to regex, declaration order is important.
+     * @param method HTTP method
+     * @param url HTTP url string that supports colon param matching
+     */
+    expectRoute(method: string, url: string): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for DELETE requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenDELETE(url: string | RegExp | ((url: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param method HTTP method.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    when(
+      method: string,
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for GET requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in request url described above
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenGET(url: string | RegExp | ((url: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for DELETE requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenDELETE(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for HEAD requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenHEAD(url: string | RegExp | ((url: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for GET requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in request url described above
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenGET(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for JSONP requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenJSONP(url: string | RegExp | ((url: string) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for HEAD requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenHEAD(
+      url: string | RegExp | ((url: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for PATCH requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenPATCH(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for JSONP requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenJSONP(
+      url: string | RegExp | ((url: string) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for POST requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenPOST(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for PATCH requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenPATCH(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
 
-        /**
-          * Creates a new backend definition for PUT requests.
-          * Returns an object with respond method that controls how a matched request is handled.
-          * @param url HTTP url string, regular expression or function that receives a url and returns true if the url matches the current expctation.
-          * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
-          * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
-          * @param keys Array of keys to assign to regex matches in the request url.
-          */
-    whenPUT(url: string | RegExp | ((url: string) => boolean), data?: string | RegExp | Object | ((data: string) => boolean), headers?: Object | ((object: Object) => boolean), keys?: Object[]): mock.IRequestHandler;
+    /**
+     * Creates a new backend definition for POST requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true
+     * if the url matches the current definition.
+     * @param data HTTP request body string, json object, regular expression or function that receives the data and returns true if the data matches the current expectation.
+     * @param headers HTTP headers object or function that receives the headers and returns true if the headers match the current expectation.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenPOST(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
+
+    /**
+     * Creates a new backend definition for PUT requests.
+     * Returns an object with respond method that controls how a matched request is handled.
+     * @param url HTTP url string, regular expression or function that receives a url and returns true
+     * if the url matches the current definition.
+     * @param data HTTP request body or function that receives data string and returns true if the data
+     * is as expected.
+     * @param headers HTTP headers or function that receives http header object and returns true if the
+     * headers match the current definition.
+     * @param keys Array of keys to assign to regex matches in the request url.
+     */
+    whenPUT(
+      url: string | RegExp | ((url: string) => boolean),
+      data?: string | RegExp | object | ((data: string) => boolean),
+      headers?: mock.IHttpHeaders | ((headers: mock.IHttpHeaders) => boolean),
+      keys?: string[]
+    ): mock.IRequestHandler;
+
+    /**
+     * Creates a new backend definition that compares only with the requested route.
+     * This method offers colon delimited matching of the url path, ignoring the query string.
+     * This allows declarations similar to how application routes are configured with `$routeProvider`.
+     * As this method converts the definition url to regex, declaration order is important.
+     * @param method HTTP method.
+     * @param url HTTP url string that supports colon param matching.
+     */
+    whenRoute(method: string, url: string): mock.IRequestHandler;
   }
 
   ///////////////////////////////////////////////////////////////////////////
   // AnimateService
   // see https://docs.angularjs.org/api/ngMock/service/$animate
   ///////////////////////////////////////////////////////////////////////////
-  module animate {
+  namespace animate {
     interface IAnimateService {
-
       /**
-       * This method will close all pending animations (both Javascript and CSS) and it will also flush any remaining animation frames and/or callbacks.
+       * This method will close all pending animations (both Javascript and CSS) and it will also flush any remaining
+       * animation frames and/or callbacks.
        */
       closeAndFlush(): void;
 
       /**
-       * This method is used to flush the pending callbacks and animation frames to either start an animation or conclude an animation. Note that this will not actually close an actively running animation (see `closeAndFlush()` for that).
+       * This method is used to flush the pending callbacks and animation frames to either start
+       * an animation or conclude an animation. Note that this will not actually close an
+       * actively running animation (see `closeAndFlush()`} for that).
        */
       flush(): void;
     }
   }
 
-  export module mock {
-    // returned interface by the the mocked HttpBackendService expect/when methods
+  namespace mock {
+    /** Object returned by the the mocked HttpBackendService expect/when methods */
     interface IRequestHandler {
-
-            /**
-              * Controls the response for a matched request using a function to construct the response.
-              * Returns the RequestHandler object for possible overrides.
-              * @param func Function that receives the request HTTP method, url, data, headers, and an array of keys to regex matches in the request url and returns an array containing response status (number), data, headers, and status text.
-              */
-      respond(func: ((method: string, url: string, data: string | Object, headers: Object, params?: any) => [number, string | Object, Object, string])): IRequestHandler;
-
-            /**
-              * Controls the response for a matched request using supplied static data to construct the response.
-              * Returns the RequestHandler object for possible overrides.
-              * @param status HTTP status code to add to the response.
-              * @param data Data to add to the response.
-              * @param headers Headers object to add to the response.
-              * @param responseText Response text to add to the response.
-              */
-      respond(status: number, data: string | Object, headers?: Object, responseText?: string): IRequestHandler;
-
-            /**
-              * Controls the response for a matched request using the HTTP status code 200 and supplied static data to construct the response.
-              * Returns the RequestHandler object for possible overrides.
-              * @param data Data to add to the response.
-              * @param headers Headers object to add to the response.
-              * @param responseText Response text to add to the response.
-              */
-      respond(data: string | Object, headers?: Object, responseText?: string): IRequestHandler;
-
-      // Available when ngMockE2E is loaded
       /**
-        * Any request matching a backend definition or expectation with passThrough handler will be passed through to the real backend (an XHR request will be made to the server.)
-        */
+       * Controls the response for a matched request using a function to construct the response.
+       * Returns the RequestHandler object for possible overrides.
+       * @param func Function that receives the request HTTP method, url, data, headers, and an array of keys
+       * to regex matches in the request url and returns an array containing response status (number), data,
+       * headers, and status text.
+       */
+      respond(
+        func: ((
+          method: string,
+          url: string,
+          data: string | object,
+          headers: IHttpHeaders,
+          params: { [key: string]: string }
+        ) => [number, string | object, IHttpHeaders, string])
+      ): IRequestHandler;
+
+      /**
+       * Controls the response for a matched request using supplied static data to construct the response.
+       * Returns the RequestHandler object for possible overrides.
+       * @param status HTTP status code to add to the response.
+       * @param data Data to add to the response.
+       * @param headers Headers object to add to the response.
+       * @param responseText Response text to add to the response.
+       */
+      respond(
+        status: number,
+        data: string | object,
+        headers?: IHttpHeaders,
+        responseText?: string
+      ): IRequestHandler;
+
+      /**
+       * Controls the response for a matched request using the HTTP status code 200 and supplied static data to construct the response.
+       * Returns the RequestHandler object for possible overrides.
+       * @param data Data to add to the response.
+       * @param headers Headers object to add to the response.
+       * @param responseText Response text to add to the response.
+       */
+      respond(
+        data: string | object,
+        headers?: IHttpHeaders,
+        responseText?: string
+      ): IRequestHandler;
+
+      /**
+       * Any request matching a backend definition or expectation with passThrough handler will be
+       * passed through to the real backend (an XHR request will be made to the server.)
+       * Available when ngMockE2E is loaded
+       */
       passThrough(): IRequestHandler;
     }
 
+    interface IHttpHeaders {
+      [headerName: string]: any;
+    }
+
+    /**
+     * Contains additional event data used by the `browserTrigger` function when creating an event.
+     */
+    interface IBrowserTriggerEventData {
+      /**
+       * [Event.bubbles](https://developer.mozilla.org/docs/Web/API/Event/bubbles).
+       * Not applicable to all events.
+       */
+      bubbles?: boolean;
+      /**
+       * [Event.cancelable](https://developer.mozilla.org/docs/Web/API/Event/cancelable).
+       * Not applicable to all events.
+       */
+      cancelable?: boolean;
+      /**
+       * [charCode](https://developer.mozilla.org/docs/Web/API/KeyboardEvent/charcode)
+       * for keyboard events (keydown, keypress, and keyup).
+       */
+      charcode?: number;
+      /**
+       * The elapsedTime for
+       * [TransitionEvent](https://developer.mozilla.org/docs/Web/API/TransitionEvent)
+       * and [AnimationEvent](https://developer.mozilla.org/docs/Web/API/AnimationEvent).
+       */
+      elapsedTime?: number;
+      /**
+       * [keyCode](https://developer.mozilla.org/docs/Web/API/KeyboardEvent/keycode)
+       * for keyboard events (keydown, keypress, and keyup).
+       */
+      keycode?: number;
+      /**
+       * An array of possible modifier keys (ctrl, alt, shift, meta) for
+       * [MouseEvent](https://developer.mozilla.org/docs/Web/API/MouseEvent) and
+       * keyboard events (keydown, keypress, and keyup).
+       */
+      keys?: Array<'ctrl' | 'alt' | 'shift' | 'meta'>;
+      /**
+       * The [relatedTarget](https://developer.mozilla.org/docs/Web/API/MouseEvent/relatedTarget)
+       * for [MouseEvent](https://developer.mozilla.org/docs/Web/API/MouseEvent).
+       */
+      relatedTarget?: Node;
+      /**
+       * [which](https://developer.mozilla.org/docs/Web/API/KeyboardEvent/which)
+       * for keyboard events (keydown, keypress, and keyup).
+       */
+      which?: number;
+      /**
+       * x-coordinates for [MouseEvent](https://developer.mozilla.org/docs/Web/API/MouseEvent)
+       * and [TouchEvent](https://developer.mozilla.org/docs/Web/API/TouchEvent).
+       */
+      x?: number;
+      /**
+       * y-coordinates for [MouseEvent](https://developer.mozilla.org/docs/Web/API/MouseEvent)
+       * and [TouchEvent](https://developer.mozilla.org/docs/Web/API/TouchEvent).
+       */
+      y?: number;
+    }
   }
 }
 
 ///////////////////////////////////////////////////////////////////////////////
 // functions attached to global object (window)
 ///////////////////////////////////////////////////////////////////////////////
-//Use `angular.mock.module` instead of `module`, as `module` conflicts with commonjs.
-//declare var module: (...modules: any[]) => any;
+// Use `angular.mock.module` instead of `module`, as `module` conflicts with commonjs.
+// declare var module: (...modules: any[]) => any;
 declare global {
-  export var inject: angular.IInjectStatic;
+  const inject: angular.IInjectStatic;
+
+  /**
+   * This is a global (window) function that is only available when the `ngMock` module is included.
+   * It can be used to trigger a native browser event on an element, which is useful for unit testing.
+   *
+   * @param element Either a wrapped jQuery/jqLite node or a DOM element
+   * @param eventType Optional event type. If none is specified, the function tries to determine
+   * the right event type for the element, e.g. `change` for `input[text]`.
+   * @param eventData An optional object which contains additional event data used when creating the event.
+   */
+  function browserTrigger(
+    element: JQuery | Element,
+    eventType?: string,
+    eventData?: angular.mock.IBrowserTriggerEventData
+  ): void;
 }
diff --git a/types/angular-mocks/mocks.d.ts b/types/angular-mocks/mocks.d.ts
index 17c077008c..e8cc13c0a8 100644
--- a/types/angular-mocks/mocks.d.ts
+++ b/types/angular-mocks/mocks.d.ts
@@ -1,14 +1,14 @@
 declare module "angular-mocks/ngMock" {
-    var _: string;
+    const _: string;
     export = _;
 }
 
 declare module "angular-mocks/ngMockE2E" {
-    var _: string;
+    const _: string;
     export = _;
 }
 
 declare module "angular-mocks/ngAnimateMock" {
-    var _: string;
+    const _: string;
     export = _;
-}
\ No newline at end of file
+}
diff --git a/types/angular-mocks/tslint.json b/types/angular-mocks/tslint.json
index a41bf5d19a..e91317558b 100644
--- a/types/angular-mocks/tslint.json
+++ b/types/angular-mocks/tslint.json
@@ -1,79 +1,10 @@
 {
-    "extends": "dtslint/dt.json",
-    "rules": {
-        "adjacent-overload-signatures": false,
-        "array-type": false,
-        "arrow-return-shorthand": false,
-        "ban-types": false,
-        "callable-types": false,
-        "comment-format": false,
-        "dt-header": false,
-        "eofline": false,
-        "export-just-namespace": false,
-        "import-spacing": false,
-        "interface-name": false,
-        "interface-over-type-literal": false,
-        "jsdoc-format": false,
-        "max-line-length": false,
-        "member-access": false,
-        "new-parens": false,
-        "no-any-union": false,
-        "no-boolean-literal-compare": false,
-        "no-conditional-assignment": false,
-        "no-consecutive-blank-lines": false,
-        "no-construct": false,
-        "no-declare-current-package": false,
-        "no-duplicate-imports": false,
-        "no-duplicate-variable": false,
-        "no-empty-interface": false,
-        "no-for-in-array": false,
-        "no-inferrable-types": false,
-        "no-internal-module": false,
-        "no-irregular-whitespace": false,
-        "no-mergeable-namespace": false,
-        "no-misused-new": false,
-        "no-namespace": false,
-        "no-object-literal-type-assertion": false,
-        "no-padding": false,
-        "no-redundant-jsdoc": false,
-        "no-redundant-jsdoc-2": false,
-        "no-redundant-undefined": false,
-        "no-reference-import": false,
-        "no-relative-import-in-test": false,
-        "no-self-import": false,
-        "no-single-declare-module": false,
-        "no-string-throw": false,
-        "no-unnecessary-callback-wrapper": false,
-        "no-unnecessary-class": false,
-        "no-unnecessary-generics": false,
-        "no-unnecessary-qualifier": false,
-        "no-unnecessary-type-assertion": false,
-        "no-useless-files": false,
-        "no-var-keyword": false,
-        "no-var-requires": false,
-        "no-void-expression": false,
-        "no-trailing-whitespace": false,
-        "object-literal-key-quotes": false,
-        "object-literal-shorthand": false,
-        "one-line": false,
-        "one-variable-per-declaration": false,
-        "only-arrow-functions": false,
-        "prefer-conditional-expression": false,
-        "prefer-const": false,
-        "prefer-declare-function": false,
-        "prefer-for-of": false,
-        "prefer-method-signature": false,
-        "prefer-template": false,
-        "radix": false,
-        "semicolon": false,
-        "space-before-function-paren": false,
-        "space-within-parens": false,
-        "strict-export-declare-modifiers": false,
-        "trim-file": false,
-        "triple-equals": false,
-        "typedef-whitespace": false,
-        "unified-signatures": false,
-        "void-return": false,
-        "whitespace": false
-    }
+  "extends": "dtslint/dt.json",
+  "rules": {
+    "callable-types": false,
+    "interface-name": false,
+    "no-declare-current-package": false,
+    "no-unnecessary-generics": false,
+    "only-arrow-functions": false
+  }
 }
diff --git a/types/bardjs/index.d.ts b/types/bardjs/index.d.ts
index 5f2a5a1863..f701d4c368 100644
--- a/types/bardjs/index.d.ts
+++ b/types/bardjs/index.d.ts
@@ -2,7 +2,7 @@
 // Project: https://github.com/wardbell/bardjs
 // Definitions by: Andrew Archibald <https://github.com/TepigMC>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.3
+// TypeScript Version: 2.4
 
 /// <reference types="angular" />
 /// <reference types="chai" />

From 4911f261ccebf7444d8dec54f6f3737dbd49d03e Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 09:47:29 -0700
Subject: [PATCH 068/180] Correcting comment

---
 types/office-js/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index cd0efc7f23..899e8dc8ed 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -8292,7 +8292,7 @@ declare namespace Office {
         /**
          * The mailbox item.  Depending on the context in which the add-in opened, the item may be of any number of types.
          * If you want to see IntelliSense for only a specific type, you should cast this item to one of the following:
-         * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentCompose`, `AppointmentRead`
+         * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentOrganizer`, `AppointmentAttendee`
          */
         item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentAttendee & AppointmentOrganizer;
         /**

From 6dcd6de34c97aef7f8c8621bdbc40f84c92a439f Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 09:49:25 -0700
Subject: [PATCH 069/180] Undoing permission link changes for this set

---
 types/office-js/index.d.ts | 444 ++++++++++++++++++-------------------
 1 file changed, 222 insertions(+), 222 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 899e8dc8ed..c7b7f59d5e 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -459,7 +459,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -484,7 +484,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -535,7 +535,7 @@ declare namespace Office {
          * 
          * Add-in type: Content, task pane, Outlook
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or Read
          */
@@ -552,7 +552,7 @@ declare namespace Office {
              *
              * @remarks
              * 
-             * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+             * Minimum permission level: Restricted
              *
              * Applicable Outlook mode: Compose or read
              * 
@@ -5744,7 +5744,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -5780,7 +5780,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -5795,7 +5795,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5815,7 +5815,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -5830,7 +5830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5849,7 +5849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5870,7 +5870,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5890,7 +5890,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5908,7 +5908,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * Applicable Outlook mode: Compose
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
@@ -5925,7 +5925,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5950,7 +5950,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5974,7 +5974,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -5996,7 +5996,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6018,7 +6018,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6043,7 +6043,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6067,7 +6067,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6089,7 +6089,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -6109,7 +6109,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * Minimum permission level: Restricted
      *
      * Applicable Outlook mode: Read
      */
@@ -6147,7 +6147,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6160,7 +6160,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6175,7 +6175,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -6192,7 +6192,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6210,7 +6210,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6222,7 +6222,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6235,7 +6235,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6248,7 +6248,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6271,7 +6271,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6283,7 +6283,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6311,7 +6311,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6343,7 +6343,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -6384,7 +6384,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      * 
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      * 
      * Applicable Outlook mode: Compose
      */
@@ -6399,7 +6399,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          * 
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6419,7 +6419,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -6456,7 +6456,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6472,7 +6472,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6488,7 +6488,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6504,7 +6504,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6524,7 +6524,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6549,7 +6549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6563,7 +6563,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6577,7 +6577,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6589,7 +6589,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6603,7 +6603,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6619,7 +6619,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6634,7 +6634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6658,7 +6658,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6678,7 +6678,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * Minimum permission level: ReadItem
         * Applicable Outlook mode: Compose or read
         */
         location: string;
@@ -6697,7 +6697,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * Minimum permission level: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         */
@@ -6718,7 +6718,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6742,7 +6742,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6764,7 +6764,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6777,7 +6777,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * Minimum permission level: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -6789,7 +6789,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6801,7 +6801,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6815,7 +6815,7 @@ declare namespace Office {
          *
          * Note: This member is not supported in Outlook for iOS or Outlook for Android.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -6829,7 +6829,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6841,7 +6841,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -6860,7 +6860,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6879,7 +6879,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -6894,7 +6894,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6915,7 +6915,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6936,7 +6936,7 @@ declare namespace Office {
         *
         * @remarks
         *
-        * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+        * Minimum permission level: ReadItem
         *
         * Applicable Outlook mode: Compose or read
         *
@@ -6954,7 +6954,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -6975,7 +6975,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          * 
@@ -7002,7 +7002,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7017,7 +7017,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7047,7 +7047,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7073,7 +7073,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7102,7 +7102,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7132,7 +7132,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7159,7 +7159,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7183,7 +7183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7209,7 +7209,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7236,7 +7236,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose
          */
@@ -7252,7 +7252,7 @@ declare namespace Office {
          *
          * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7275,7 +7275,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7297,7 +7297,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7316,7 +7316,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7337,7 +7337,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7355,7 +7355,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7375,7 +7375,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7405,7 +7405,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7435,7 +7435,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7462,7 +7462,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7491,7 +7491,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7509,7 +7509,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7531,7 +7531,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7549,7 +7549,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7570,7 +7570,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -7596,7 +7596,7 @@ declare namespace Office {
          *
          * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7618,7 +7618,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7634,7 +7634,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7648,7 +7648,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7664,7 +7664,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7683,7 +7683,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7707,7 +7707,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7725,7 +7725,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7743,7 +7743,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          * 
@@ -7759,7 +7759,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7786,7 +7786,7 @@ declare namespace Office {
          * |URL|String|Restricted|
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Read
          *
@@ -7804,7 +7804,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7828,7 +7828,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7849,7 +7849,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7865,7 +7865,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -7888,7 +7888,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7911,7 +7911,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7931,7 +7931,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -7947,7 +7947,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7963,7 +7963,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -7977,7 +7977,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -7998,7 +7998,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8016,7 +8016,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8028,7 +8028,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8044,7 +8044,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          */
@@ -8058,7 +8058,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8072,7 +8072,7 @@ declare namespace Office {
      *
      * @remarks
      *
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8116,7 +8116,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -8133,7 +8133,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8148,7 +8148,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          */
@@ -8166,7 +8166,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8183,7 +8183,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8202,7 +8202,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8220,7 +8220,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -8243,7 +8243,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * Minimum permission level: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8264,7 +8264,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8284,7 +8284,7 @@ declare namespace Office {
          *
          * The ewsUrl value can be used by a remote service to make EWS calls to the user's mailbox. For example, you can create a remote service to {@link https://msdn.microsoft.com/library/office/dn148008.aspx | get attachments from the selected item}.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8308,7 +8308,7 @@ declare namespace Office {
          *
          * The restUrl value can be used to make {@link https://docs.microsoft.com/outlook/rest/ | REST API} calls to the user's mailbox.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8328,7 +8328,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8349,7 +8349,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8368,7 +8368,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8386,7 +8386,7 @@ declare namespace Office {
          *
          * Item IDs retrieved via EWS or via the itemId property use a different format than the format used by REST APIs (such as the {@link https://msdn.microsoft.com/office/office365/APi/mail-rest-operations | Outlook Mail API} or the {@link http://graph.microsoft.io/ | Microsoft Graph}. The convertToRestId method converts an EWS-formatted ID into the proper format for REST.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8403,7 +8403,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8428,7 +8428,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8452,7 +8452,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8476,7 +8476,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8494,7 +8494,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Read
          *
@@ -8535,7 +8535,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8560,7 +8560,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8582,7 +8582,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8601,7 +8601,7 @@ declare namespace Office {
          *
          * The getUserIdentityTokenAsync method returns a token that you can use to identify and {@link https://msdn.microsoft.com/library/office/fp179828.aspx | authenticate the add-in and user with a third-party system}.
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8640,7 +8640,7 @@ declare namespace Office {
          *
          * @remarks
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteMailbox
+         * Minimum permission level: ReadWriteMailbox
          *
          * Applicable Outlook mode: Compose and read
          *
@@ -8661,7 +8661,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8697,7 +8697,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8729,7 +8729,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.3]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -8748,7 +8748,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8764,7 +8764,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8782,7 +8782,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8799,7 +8799,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -8810,7 +8810,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8825,7 +8825,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8838,7 +8838,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8854,7 +8854,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8867,7 +8867,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8882,7 +8882,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8898,7 +8898,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8917,7 +8917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8933,7 +8933,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8951,7 +8951,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.3]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -8969,7 +8969,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -8991,7 +8991,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9010,7 +9010,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9036,7 +9036,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9059,7 +9059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9084,7 +9084,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9103,7 +9103,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9118,7 +9118,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9143,7 +9143,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9171,7 +9171,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9196,7 +9196,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9223,7 +9223,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9253,7 +9253,7 @@ declare namespace Office {
      * |Meeting Request - Read Series|No (setAsync not available)|Yes (item.recurrence)|
      * |Meeting Request - Read Instance|No (setAsync not available)|Yes (item.recurrence)|
      * 
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9265,7 +9265,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9277,7 +9277,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9290,7 +9290,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9303,7 +9303,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          */
@@ -9318,7 +9318,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9337,7 +9337,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          * 
          * Applicable Outlook mode: Compose or read
          * 
@@ -9354,7 +9354,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9376,7 +9376,7 @@ declare namespace Office {
          * 
          * @remarks
          * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          * 
          * Applicable Outlook mode: Compose
          * 
@@ -9395,7 +9395,7 @@ declare namespace Office {
      * 
      * @remarks
      * 
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      * 
      * Applicable Outlook mode: Compose or read
      */
@@ -9487,7 +9487,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+     * Minimum permission level: Restricted
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9498,7 +9498,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9512,7 +9512,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9527,7 +9527,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9546,7 +9546,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         * Minimum permission level: Restricted
          *
          * Applicable Outlook mode: Compose or read
          *
@@ -9562,7 +9562,7 @@ declare namespace Office {
      * [Api set: Mailbox Preview]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -9573,7 +9573,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9585,7 +9585,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9597,7 +9597,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9609,7 +9609,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9621,7 +9621,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -9633,7 +9633,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9647,7 +9647,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9665,7 +9665,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9681,7 +9681,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9699,7 +9699,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9715,7 +9715,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9732,7 +9732,7 @@ declare namespace Office {
          * [Api set: Mailbox Preview]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          * 
@@ -9749,7 +9749,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9761,7 +9761,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9776,7 +9776,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9793,7 +9793,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9813,7 +9813,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9830,7 +9830,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9849,7 +9849,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9869,7 +9869,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Read
      */
@@ -9889,7 +9889,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.1]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose
      */
@@ -9902,7 +9902,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9917,7 +9917,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9936,7 +9936,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9958,7 +9958,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9977,7 +9977,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -9998,7 +9998,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.1]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * Minimum permission level: ReadWriteItem
          *
          * Applicable Outlook mode: Compose
          *
@@ -10016,7 +10016,7 @@ declare namespace Office {
      * [Api set: Mailbox 1.0]
      *
      * @remarks
-     * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+     * Minimum permission level: ReadItem
      *
      * Applicable Outlook mode: Compose or read
      */
@@ -10037,7 +10037,7 @@ declare namespace Office {
          * |office365 |The mailbox is associated with an Office 365 work or school account.|
          * |outlookCom |The mailbox is associated with a personal Outlook.com account.|
          *
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10048,7 +10048,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10059,7 +10059,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */
@@ -10070,7 +10070,7 @@ declare namespace Office {
          * [Api set: Mailbox 1.0]
          *
          * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         * Minimum permission level: ReadItem
          *
          * Applicable Outlook mode: Compose or read
          */

From 6f3dda7450954a4a0e96efaccebde39d04c744c7 Mon Sep 17 00:00:00 2001
From: Leonard Thieu <leonard.thieu@gmail.com>
Date: Mon, 11 Jun 2018 14:05:02 -0400
Subject: [PATCH 070/180] [jquery] Fix documentation links for Visual Studio
 Code.

---
 types/jquery/index.d.ts  | 1156 +++++++++++++++++++-------------------
 types/jquery/tslint.json |    1 +
 2 files changed, 579 insertions(+), 578 deletions(-)

diff --git a/types/jquery/index.d.ts b/types/jquery/index.d.ts
index b0838f9a8d..a857f74f4a 100644
--- a/types/jquery/index.d.ts
+++ b/types/jquery/index.d.ts
@@ -42,7 +42,7 @@ type _Promise<T> = Promise<T>;
 
 interface JQueryStatic<TElement extends Node = HTMLElement> {
     /**
-     * @see {@link http://api.jquery.com/jquery.ajax/#jQuery-ajax1}
+     * @see \`{@link http://api.jquery.com/jquery.ajax/#jQuery-ajax1 }\`
      * @deprecated Use jQuery.ajaxSetup(options)
      */
     ajaxSettings: JQuery.AjaxSettings;
@@ -52,7 +52,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * any synchronous or asynchronous function.
      *
      * @param beforeStart A function that is called just before the constructor returns.
-     * @see {@link https://api.jquery.com/jQuery.Deferred/}
+     * @see \`{@link https://api.jquery.com/jQuery.Deferred/ }\`
      * @since 1.5
      */
     Deferred: JQuery.DeferredStatic;
@@ -61,7 +61,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Hook directly into jQuery to override how particular CSS properties are retrieved or set, normalize
      * CSS property naming, or create custom properties.
      *
-     * @see {@link https://api.jquery.com/jQuery.cssHooks/}
+     * @see \`{@link https://api.jquery.com/jQuery.cssHooks/ }\`
      * @since 1.4.3
      */
     cssHooks: JQuery.PlainObject<JQuery.CSSHook<TElement>>;
@@ -69,7 +69,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * An object containing all CSS properties that may be used without a unit. The .css() method uses this
      * object to see if it may append px to unitless values.
      *
-     * @see {@link https://api.jquery.com/jQuery.cssNumber/}
+     * @see \`{@link https://api.jquery.com/jQuery.cssNumber/ }\`
      * @since 1.4.3
      */
     cssNumber: JQuery.PlainObject<boolean>;
@@ -78,7 +78,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
         /**
          * The rate (in milliseconds) at which animations fire.
          *
-         * @see {@link https://api.jquery.com/jQuery.fx.interval/}
+         * @see \`{@link https://api.jquery.com/jQuery.fx.interval/ }\`
          * @since 1.4.3
          * @deprecated 3.0
          */
@@ -86,7 +86,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
         /**
          * Globally disable all animations.
          *
-         * @see {@link https://api.jquery.com/jQuery.fx.off/}
+         * @see \`{@link https://api.jquery.com/jQuery.fx.off/ }\`
          * @since 1.3
          */
         off: boolean;
@@ -95,7 +95,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
     /**
      * A Promise-like object (or "thenable") that resolves when the document is ready.
      *
-     * @see {@link https://api.jquery.com/jQuery.ready/}
+     * @see \`{@link https://api.jquery.com/jQuery.ready/ }\`
      * @since 1.8
      */
     ready: JQuery.Thenable<JQueryStatic<TElement>>;
@@ -106,7 +106,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * needs, we strongly recommend the use of an external library such as Modernizr instead of dependency
      * on properties in jQuery.support.
      *
-     * @see {@link https://api.jquery.com/jQuery.support/}
+     * @see \`{@link https://api.jquery.com/jQuery.support/ }\`
      * @since 1.3
      * @deprecated 1.9
      */
@@ -119,7 +119,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *             A string defining a single, standalone, HTML element (e.g. <div/> or <div></div>).
      * @param ownerDocument_attributes A document in which the new elements will be created.
      *                                 An object of attributes, events, and methods to call on the newly-created element.
-     * @see {@link https://api.jquery.com/jQuery/}
+     * @see \`{@link https://api.jquery.com/jQuery/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -129,7 +129,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param selector A string containing a selector expression
      * @param context A DOM Element, Document, or jQuery to use as context
-     * @see {@link https://api.jquery.com/jQuery/}
+     * @see \`{@link https://api.jquery.com/jQuery/ }\`
      * @since 1.0
      */
     (selector: JQuery.Selector, context: Element | Document | JQuery | undefined): JQuery<TElement>;
@@ -147,7 +147,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *                                 A plain object to wrap in a jQuery object.
      *                                 An existing jQuery object to clone.
      *                                 The function to execute when the DOM is ready.
-     * @see {@link https://api.jquery.com/jQuery/}
+     * @see \`{@link https://api.jquery.com/jQuery/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -158,7 +158,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * A multi-purpose callbacks list object that provides a powerful way to manage callback lists.
      *
      * @param flags An optional list of space-separated flags that change how the callback list behaves.
-     * @see {@link https://api.jquery.com/jQuery.Callbacks/}
+     * @see \`{@link https://api.jquery.com/jQuery.Callbacks/ }\`
      * @since 1.7
      */
     Callbacks<T extends Function>(flags?: string): JQuery.Callbacks<T>;
@@ -168,7 +168,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param url A string containing the URL to which the request is sent.
      * @param settings A set of key/value pairs that configure the Ajax request. All settings are optional. A default can
      *                 be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) below for a complete list of all settings.
-     * @see {@link https://api.jquery.com/jQuery.ajax/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajax/ }\`
      * @since 1.5
      */
     ajax(url: string, settings?: JQuery.AjaxSettings): JQuery.jqXHR;
@@ -177,7 +177,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param settings A set of key/value pairs that configure the Ajax request. All settings are optional. A default can
      *                 be set for any option with $.ajaxSetup().
-     * @see {@link https://api.jquery.com/jQuery.ajax/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajax/ }\`
      * @since 1.0
      */
     ajax(settings?: JQuery.AjaxSettings): JQuery.jqXHR;
@@ -187,7 +187,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param dataTypes An optional string containing one or more space-separated dataTypes
      * @param handler A handler to set default values for future Ajax requests.
-     * @see {@link https://api.jquery.com/jQuery.ajaxPrefilter/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajaxPrefilter/ }\`
      * @since 1.5
      */
     ajaxPrefilter(dataTypes: string,
@@ -197,7 +197,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * are processed by $.ajax().
      *
      * @param handler A handler to set default values for future Ajax requests.
-     * @see {@link https://api.jquery.com/jQuery.ajaxPrefilter/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajaxPrefilter/ }\`
      * @since 1.5
      */
     ajaxPrefilter(handler: (options: JQuery.AjaxSettings, originalOptions: JQuery.AjaxSettings, jqXHR: JQuery.jqXHR) => string | void): void;
@@ -205,7 +205,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Set default values for future Ajax requests. Its use is not recommended.
      *
      * @param options A set of key/value pairs that configure the default Ajax request. All options are optional.
-     * @see {@link https://api.jquery.com/jQuery.ajaxSetup/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajaxSetup/ }\`
      * @since 1.1
      */
     ajaxSetup(options: JQuery.AjaxSettings): JQuery.AjaxSettings;
@@ -214,7 +214,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param dataType A string identifying the data type to use
      * @param handler A handler to return the new transport object to use with the data type provided in the first argument.
-     * @see {@link https://api.jquery.com/jQuery.ajaxTransport/}
+     * @see \`{@link https://api.jquery.com/jQuery.ajaxTransport/ }\`
      * @since 1.5
      */
     ajaxTransport(dataType: string,
@@ -228,7 +228,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param container The DOM element that may contain the other element.
      * @param contained The DOM element that may be contained by (a descendant of) the other element.
-     * @see {@link https://api.jquery.com/jQuery.contains/}
+     * @see \`{@link https://api.jquery.com/jQuery.contains/ }\`
      * @since 1.4
      */
     contains(container: Element, contained: Element): boolean;
@@ -239,7 +239,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param element The DOM element to query for the data.
      * @param key Name of the data stored.
-     * @see {@link https://api.jquery.com/jQuery.data/}
+     * @see \`{@link https://api.jquery.com/jQuery.data/ }\`
      * @since 1.2.3
      */
     data(element: Element, key: string, undefined: undefined): any; // tslint:disable-line:unified-signatures
@@ -249,7 +249,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param element The DOM element to associate with the data.
      * @param key A string naming the piece of data to set.
      * @param value The new data value; this can be any Javascript type except undefined.
-     * @see {@link https://api.jquery.com/jQuery.data/}
+     * @see \`{@link https://api.jquery.com/jQuery.data/ }\`
      * @since 1.2.3
      */
     data<T>(element: Element, key: string, value: T): T;
@@ -259,7 +259,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param element The DOM element to query for the data.
      * @param key Name of the data stored.
-     * @see {@link https://api.jquery.com/jQuery.data/}
+     * @see \`{@link https://api.jquery.com/jQuery.data/ }\`
      * @since 1.2.3
      * @since 1.4
      */
@@ -269,7 +269,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param element A DOM element from which to remove and execute a queued function.
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
-     * @see {@link https://api.jquery.com/jQuery.dequeue/}
+     * @see \`{@link https://api.jquery.com/jQuery.dequeue/ }\`
      * @since 1.3
      */
     dequeue(element: Element, queueName?: string): void;
@@ -280,7 +280,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param array The array to iterate over.
      * @param callback The function that will be executed on every object.
-     * @see {@link https://api.jquery.com/jQuery.each/}
+     * @see \`{@link https://api.jquery.com/jQuery.each/ }\`
      * @since 1.0
      */
     each<T>(array: ArrayLike<T>, callback: (this: T, indexInArray: number, value: T) => false | any): ArrayLike<T>;
@@ -291,7 +291,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param obj The object to iterate over.
      * @param callback The function that will be executed on every object.
-     * @see {@link https://api.jquery.com/jQuery.each/}
+     * @see \`{@link https://api.jquery.com/jQuery.each/ }\`
      * @since 1.0
      */
     each<T, K extends keyof T>(obj: T, callback: (this: T[K], propertyName: K, valueOfProperty: T[K]) => false | any): T;
@@ -299,7 +299,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Takes a string and throws an exception containing it.
      *
      * @param message The message to send out.
-     * @see {@link https://api.jquery.com/jQuery.error/}
+     * @see \`{@link https://api.jquery.com/jQuery.error/ }\`
      * @since 1.4.1
      */
     error(message: string): any;
@@ -307,7 +307,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Escapes any character that has a special meaning in a CSS selector.
      *
      * @param selector A string containing a selector expression to escape.
-     * @see {@link https://api.jquery.com/jQuery.escapeSelector/}
+     * @see \`{@link https://api.jquery.com/jQuery.escapeSelector/ }\`
      * @since 3.0
      */
     escapeSelector(selector: JQuery.Selector): JQuery.Selector;
@@ -316,7 +316,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U, V, W, X, Y, Z>(deep: true, target: T, object1: U, object2: V, object3: W, object4: X, object5: Y, object6: Z): T & U & V & W & X & Y & Z;
@@ -325,7 +325,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U, V, W, X, Y>(deep: true, target: T, object1: U, object2: V, object3: W, object4: X, object5: Y): T & U & V & W & X & Y;
@@ -334,7 +334,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U, V, W, X>(deep: true, target: T, object1: U, object2: V, object3: W, object4: X): T & U & V & W & X;
@@ -343,7 +343,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U, V, W>(deep: true, target: T, object1: U, object2: V, object3: W): T & U & V & W;
@@ -352,7 +352,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U, V>(deep: true, target: T, object1: U, object2: V): T & U & V;
@@ -361,7 +361,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend<T, U>(deep: true, target: T, object1: U): T & U;
@@ -370,7 +370,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param deep If true, the merge becomes recursive (aka. deep copy). Passing false for this argument is not supported.
      * @param target The object to extend. It will receive the new properties.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.1.4
      */
     extend(deep: true, target: any, object1: any, ...objects: any[]): any;
@@ -379,7 +379,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U, V, W, X, Y, Z>(target: T, object1: U, object2: V, object3: W, object4: X, object5: Y, object6: Z): T & U & V & W & X & Y & Z;
@@ -388,7 +388,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U, V, W, X, Y>(target: T, object1: U, object2: V, object3: W, object4: X, object5: Y): T & U & V & W & X & Y;
@@ -397,7 +397,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U, V, W, X>(target: T, object1: U, object2: V, object3: W, object4: X): T & U & V & W & X;
@@ -406,7 +406,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U, V, W>(target: T, object1: U, object2: V, object3: W): T & U & V & W;
@@ -415,7 +415,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U, V>(target: T, object1: U, object2: V): T & U & V;
@@ -424,7 +424,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend<T, U>(target: T, object1: U): T & U;
@@ -433,7 +433,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param target An object that will receive the new properties if additional objects are passed in or that will
      *               extend the jQuery namespace if it is the sole argument.
-     * @see {@link https://api.jquery.com/jQuery.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.extend/ }\`
      * @since 1.0
      */
     extend(target: any, object1: any, ...objects: any[]): any;
@@ -445,7 +445,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                you can use null or jQuery.noop as a placeholder.
      * @param dataType The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
-     * @see {@link https://api.jquery.com/jQuery.get/}
+     * @see \`{@link https://api.jquery.com/jQuery.get/ }\`
      * @since 1.0
      */
     get(url: string,
@@ -459,7 +459,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                you can use null or jQuery.noop as a placeholder.
      * @param dataType The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
-     * @see {@link https://api.jquery.com/jQuery.get/}
+     * @see \`{@link https://api.jquery.com/jQuery.get/ }\`
      * @since 1.0
      */
     get(url: string,
@@ -472,7 +472,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success_data A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                     you can use null or jQuery.noop as a placeholder.
      *                     A plain object or string that is sent to the server with the request.
-     * @see {@link https://api.jquery.com/jQuery.get/}
+     * @see \`{@link https://api.jquery.com/jQuery.get/ }\`
      * @since 1.0
      */
     get(url: string,
@@ -484,7 +484,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *                     A set of key/value pairs that configure the Ajax request. All properties except for url are
      *                     optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a
      *                     complete list of all settings. The type option will automatically be set to GET.
-     * @see {@link https://api.jquery.com/jQuery.get/}
+     * @see \`{@link https://api.jquery.com/jQuery.get/ }\`
      * @since 1.0
      * @since 1.12
      * @since 2.2
@@ -496,7 +496,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param url A string containing the URL to which the request is sent.
      * @param data A plain object or string that is sent to the server with the request.
      * @param success A callback function that is executed if the request succeeds.
-     * @see {@link https://api.jquery.com/jQuery.getJSON/}
+     * @see \`{@link https://api.jquery.com/jQuery.getJSON/ }\`
      * @since 1.0
      */
     getJSON(url: string,
@@ -508,7 +508,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param url A string containing the URL to which the request is sent.
      * @param success_data A callback function that is executed if the request succeeds.
      *                     A plain object or string that is sent to the server with the request.
-     * @see {@link https://api.jquery.com/jQuery.getJSON/}
+     * @see \`{@link https://api.jquery.com/jQuery.getJSON/ }\`
      * @since 1.0
      */
     getJSON(url: string,
@@ -518,7 +518,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param url A string containing the URL to which the request is sent.
      * @param success A callback function that is executed if the request succeeds.
-     * @see {@link https://api.jquery.com/jQuery.getScript/}
+     * @see \`{@link https://api.jquery.com/jQuery.getScript/ }\`
      * @since 1.0
      */
     getScript(url: string,
@@ -527,7 +527,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Execute some JavaScript code globally.
      *
      * @param code The JavaScript code to execute.
-     * @see {@link https://api.jquery.com/jQuery.globalEval/}
+     * @see \`{@link https://api.jquery.com/jQuery.globalEval/ }\`
      * @since 1.0.4
      */
     globalEval(code: string): void;
@@ -540,7 +540,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param invert If "invert" is false, or not provided, then the function returns an array consisting of all elements
      *               for which "callback" returns true. If "invert" is true, then the function returns an array
      *               consisting of all elements for which "callback" returns false.
-     * @see {@link https://api.jquery.com/jQuery.grep/}
+     * @see \`{@link https://api.jquery.com/jQuery.grep/ }\`
      * @since 1.0
      */
     grep<T>(array: ArrayLike<T>,
@@ -550,7 +550,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determine whether an element has any jQuery data associated with it.
      *
      * @param element A DOM element to be checked for data.
-     * @see {@link https://api.jquery.com/jQuery.hasData/}
+     * @see \`{@link https://api.jquery.com/jQuery.hasData/ }\`
      * @since 1.5
      */
     hasData(element: Element): boolean;
@@ -558,7 +558,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Holds or releases the execution of jQuery's ready event.
      *
      * @param hold Indicates whether the ready hold is being requested or released
-     * @see {@link https://api.jquery.com/jQuery.holdReady/}
+     * @see \`{@link https://api.jquery.com/jQuery.holdReady/ }\`
      * @since 1.6
      * @deprecated 3.2
      */
@@ -567,7 +567,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Modify and filter HTML strings passed through jQuery manipulation methods.
      *
      * @param html The HTML string on which to operate.
-     * @see {@link https://api.jquery.com/jQuery.htmlPrefilter/}
+     * @see \`{@link https://api.jquery.com/jQuery.htmlPrefilter/ }\`
      * @since 1.12/2.2
      */
     htmlPrefilter(html: JQuery.htmlString): JQuery.htmlString;
@@ -577,7 +577,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param value The value to search for.
      * @param array An array through which to search.
      * @param fromIndex The index of the array at which to begin the search. The default is 0, which will search the whole array.
-     * @see {@link https://api.jquery.com/jQuery.inArray/}
+     * @see \`{@link https://api.jquery.com/jQuery.inArray/ }\`
      * @since 1.2
      */
     inArray<T>(value: T, array: T[], fromIndex?: number): number;
@@ -585,7 +585,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determine whether the argument is an array.
      *
      * @param obj Object to test whether or not it is an array.
-     * @see {@link https://api.jquery.com/jQuery.isArray/}
+     * @see \`{@link https://api.jquery.com/jQuery.isArray/ }\`
      * @since 1.3
      * @deprecated 3.2
      */
@@ -594,7 +594,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Check to see if an object is empty (contains no enumerable properties).
      *
      * @param obj The object that will be checked to see if it's empty.
-     * @see {@link https://api.jquery.com/jQuery.isEmptyObject/}
+     * @see \`{@link https://api.jquery.com/jQuery.isEmptyObject/ }\`
      * @since 1.4
      */
     isEmptyObject(obj: any): boolean;
@@ -602,7 +602,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determine if the argument passed is a JavaScript function object.
      *
      * @param obj Object to test whether or not it is a function.
-     * @see {@link https://api.jquery.com/jQuery.isFunction/}
+     * @see \`{@link https://api.jquery.com/jQuery.isFunction/ }\`
      * @since 1.2
      * @deprecated 3.3
      */
@@ -611,7 +611,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determines whether its argument represents a JavaScript number.
      *
      * @param value The value to be tested.
-     * @see {@link https://api.jquery.com/jQuery.isNumeric/}
+     * @see \`{@link https://api.jquery.com/jQuery.isNumeric/ }\`
      * @since 1.7
      * @deprecated 3.3
      */
@@ -620,7 +620,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Check to see if an object is a plain object (created using "{}" or "new Object").
      *
      * @param obj The object that will be checked to see if it's a plain object.
-     * @see {@link https://api.jquery.com/jQuery.isPlainObject/}
+     * @see \`{@link https://api.jquery.com/jQuery.isPlainObject/ }\`
      * @since 1.4
      */
     isPlainObject(obj: any): obj is JQuery.PlainObject;
@@ -628,7 +628,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determine whether the argument is a window.
      *
      * @param obj Object to test whether or not it is a window.
-     * @see {@link https://api.jquery.com/jQuery.isWindow/}
+     * @see \`{@link https://api.jquery.com/jQuery.isWindow/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -637,7 +637,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Check to see if a DOM node is within an XML document (or is an XML document).
      *
      * @param node The DOM node that will be checked to see if it's in an XML document.
-     * @see {@link https://api.jquery.com/jQuery.isXMLDoc/}
+     * @see \`{@link https://api.jquery.com/jQuery.isXMLDoc/ }\`
      * @since 1.1.4
      */
     isXMLDoc(node: Node): boolean;
@@ -645,7 +645,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Convert an array-like object into a true JavaScript array.
      *
      * @param obj Any object to turn into a native Array.
-     * @see {@link https://api.jquery.com/jQuery.makeArray/}
+     * @see \`{@link https://api.jquery.com/jQuery.makeArray/ }\`
      * @since 1.2
      */
     makeArray<T>(obj: ArrayLike<T>): T[];
@@ -656,7 +656,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param callback The function to process each item against. The first argument to the function is the array item, the
      *                 second argument is the index in array The function can return any value. A returned array will be
      *                 flattened into the resulting array. Within the function, this refers to the global (window) object.
-     * @see {@link https://api.jquery.com/jQuery.map/}
+     * @see \`{@link https://api.jquery.com/jQuery.map/ }\`
      * @since 1.0
      */
     map<T, R>(array: T[], callback: (elementOfArray: T, indexInArray: number) => R): R[];
@@ -668,7 +668,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *                 second argument is the key of the object property. The function can return any value to add to the
      *                 array. A returned array will be flattened into the resulting array. Within the function, this refers
      *                 to the global (window) object.
-     * @see {@link https://api.jquery.com/jQuery.map/}
+     * @see \`{@link https://api.jquery.com/jQuery.map/ }\`
      * @since 1.6
      */
     map<T, K extends keyof T, R>(obj: T, callback: (propertyOfObject: T[K], key: K) => R): R[];
@@ -677,7 +677,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param first The first array-like object to merge, the elements of second added.
      * @param second The second array-like object to merge into the first, unaltered.
-     * @see {@link https://api.jquery.com/jQuery.merge/}
+     * @see \`{@link https://api.jquery.com/jQuery.merge/ }\`
      * @since 1.0
      */
     merge<T, U>(first: ArrayLike<T>, second: ArrayLike<U>): Array<T | U>;
@@ -685,21 +685,21 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Relinquish jQuery's control of the $ variable.
      *
      * @param removeAll A Boolean indicating whether to remove all jQuery variables from the global scope (including jQuery itself).
-     * @see {@link https://api.jquery.com/jQuery.noConflict/}
+     * @see \`{@link https://api.jquery.com/jQuery.noConflict/ }\`
      * @since 1.0
      */
     noConflict(removeAll?: boolean): this;
     /**
      * An empty function.
      *
-     * @see {@link https://api.jquery.com/jQuery.noop/}
+     * @see \`{@link https://api.jquery.com/jQuery.noop/ }\`
      * @since 1.4
      */
     noop(): undefined;
     /**
      * Return a number representing the current time.
      *
-     * @see {@link https://api.jquery.com/jQuery.now/}
+     * @see \`{@link https://api.jquery.com/jQuery.now/ }\`
      * @since 1.4.3
      * @deprecated 3.3 Use Date.now().
      */
@@ -711,7 +711,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param obj An array, a plain object, or a jQuery object to serialize.
      * @param traditional A Boolean indicating whether to perform a traditional "shallow" serialization.
-     * @see {@link https://api.jquery.com/jQuery.param/}
+     * @see \`{@link https://api.jquery.com/jQuery.param/ }\`
      * @since 1.2
      * @since 1.4
      */
@@ -722,7 +722,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param data HTML string to be parsed
      * @param context Document element to serve as the context in which the HTML fragment will be created
      * @param keepScripts A Boolean indicating whether to include scripts passed in the HTML string
-     * @see {@link https://api.jquery.com/jQuery.parseHTML/}
+     * @see \`{@link https://api.jquery.com/jQuery.parseHTML/ }\`
      * @since 1.8
      */
     parseHTML(data: string, context: Document | null | undefined, keepScripts: boolean): JQuery.Node[];
@@ -732,7 +732,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param data HTML string to be parsed
      * @param context_keepScripts Document element to serve as the context in which the HTML fragment will be created
      *                            A Boolean indicating whether to include scripts passed in the HTML string
-     * @see {@link https://api.jquery.com/jQuery.parseHTML/}
+     * @see \`{@link https://api.jquery.com/jQuery.parseHTML/ }\`
      * @since 1.8
      */
     parseHTML(data: string, context_keepScripts?: Document | null | boolean): JQuery.Node[];
@@ -740,7 +740,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Takes a well-formed JSON string and returns the resulting JavaScript value.
      *
      * @param json The JSON string to parse.
-     * @see {@link https://api.jquery.com/jQuery.parseJSON/}
+     * @see \`{@link https://api.jquery.com/jQuery.parseJSON/ }\`
      * @since 1.4.1
      * @deprecated 3.0
      */
@@ -749,7 +749,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Parses a string into an XML document.
      *
      * @param data a well-formed XML string to be parsed
-     * @see {@link https://api.jquery.com/jQuery.parseXML/}
+     * @see \`{@link https://api.jquery.com/jQuery.parseXML/ }\`
      * @since 1.5
      */
     parseXML(data: string): XMLDocument;
@@ -761,7 +761,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                can be null in that case.
      * @param dataType The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
-     * @see {@link https://api.jquery.com/jQuery.post/}
+     * @see \`{@link https://api.jquery.com/jQuery.post/ }\`
      * @since 1.0
      */
     post(url: string,
@@ -775,7 +775,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                can be null in that case.
      * @param dataType The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).
-     * @see {@link https://api.jquery.com/jQuery.post/}
+     * @see \`{@link https://api.jquery.com/jQuery.post/ }\`
      * @since 1.0
      */
     post(url: string,
@@ -788,7 +788,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param success_data A callback function that is executed if the request succeeds. Required if dataType is provided, but
      *                     can be null in that case.
      *                     A plain object or string that is sent to the server with the request.
-     * @see {@link https://api.jquery.com/jQuery.post/}
+     * @see \`{@link https://api.jquery.com/jQuery.post/ }\`
      * @since 1.0
      */
     post(url: string,
@@ -800,7 +800,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *                     A set of key/value pairs that configure the Ajax request. All properties except for url are
      *                     optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a
      *                     complete list of all settings. Type will automatically be set to POST.
-     * @see {@link https://api.jquery.com/jQuery.post/}
+     * @see \`{@link https://api.jquery.com/jQuery.post/ }\`
      * @since 1.0
      * @since 1.12
      * @since 2.2
@@ -820,7 +820,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -833,7 +833,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -846,7 +846,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -859,7 +859,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -872,7 +872,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -885,7 +885,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -898,7 +898,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4`
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -912,7 +912,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -928,7 +928,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -943,7 +943,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -958,7 +958,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -973,7 +973,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -988,7 +988,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1003,7 +1003,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1018,7 +1018,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1033,7 +1033,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1050,7 +1050,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1065,7 +1065,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1080,7 +1080,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1095,7 +1095,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1110,7 +1110,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1125,7 +1125,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1140,7 +1140,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1155,7 +1155,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1172,7 +1172,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1187,7 +1187,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1202,7 +1202,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1217,7 +1217,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1232,7 +1232,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1247,7 +1247,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1262,7 +1262,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1277,7 +1277,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1294,7 +1294,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1309,7 +1309,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1324,7 +1324,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1339,7 +1339,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1354,7 +1354,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1369,7 +1369,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1384,7 +1384,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1399,7 +1399,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1416,7 +1416,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1431,7 +1431,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1446,7 +1446,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1461,7 +1461,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1476,7 +1476,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1491,7 +1491,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1506,7 +1506,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1521,7 +1521,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1538,7 +1538,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1553,7 +1553,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1568,7 +1568,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1583,7 +1583,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1598,7 +1598,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1613,7 +1613,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1628,7 +1628,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1643,7 +1643,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1660,7 +1660,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1675,7 +1675,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1690,7 +1690,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1705,7 +1705,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1720,7 +1720,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1735,7 +1735,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1750,7 +1750,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1765,7 +1765,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1785,7 +1785,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
      * @param additionalArguments Any number of arguments to be passed to the function referenced in the function argument.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.9
      * @deprecated 3.3 Use Function#bind.
      */
@@ -1808,7 +1808,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1823,7 +1823,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1838,7 +1838,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1853,7 +1853,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1868,7 +1868,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1883,7 +1883,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1898,7 +1898,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4`
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1913,7 +1913,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1931,7 +1931,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1948,7 +1948,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1965,7 +1965,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1982,7 +1982,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -1999,7 +1999,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2016,7 +2016,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2033,7 +2033,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2050,7 +2050,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2069,7 +2069,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2086,7 +2086,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2103,7 +2103,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2120,7 +2120,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2137,7 +2137,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2154,7 +2154,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2171,7 +2171,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2188,7 +2188,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2207,7 +2207,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2224,7 +2224,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2241,7 +2241,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2258,7 +2258,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2275,7 +2275,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2292,7 +2292,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2309,7 +2309,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2326,7 +2326,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2345,7 +2345,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2362,7 +2362,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2379,7 +2379,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2396,7 +2396,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2413,7 +2413,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2430,7 +2430,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2447,7 +2447,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2464,7 +2464,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2483,7 +2483,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2500,7 +2500,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2517,7 +2517,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2534,7 +2534,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2551,7 +2551,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2568,7 +2568,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2585,7 +2585,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2602,7 +2602,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2621,7 +2621,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2638,7 +2638,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2655,7 +2655,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2672,7 +2672,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2689,7 +2689,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2706,7 +2706,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2723,7 +2723,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2740,7 +2740,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2759,7 +2759,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2776,7 +2776,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2793,7 +2793,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2810,7 +2810,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2827,7 +2827,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2844,7 +2844,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2861,7 +2861,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2878,7 +2878,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2900,7 +2900,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param fn The function whose context will be changed.
      * @param context The object to which the context (this) of the function should be set.
      * @param additionalArguments Any number of arguments to be passed to the function referenced in the function argument.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2922,7 +2922,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param context The object to which the context of the function should be set.
      * @param name The name of the function whose context will be changed (should be a property of the context object).
      * @param additionalArguments Any number of arguments to be passed to the function named in the name argument.
-     * @see {@link https://api.jquery.com/jQuery.proxy/}
+     * @see \`{@link https://api.jquery.com/jQuery.proxy/ }\`
      * @since 1.4
      * @since 1.6
      * @deprecated 3.3 Use Function#bind.
@@ -2942,7 +2942,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
      * @param newQueue The new function to add to the queue.
      *                 An array of functions to replace the current queue contents.
-     * @see {@link https://api.jquery.com/jQuery.queue/}
+     * @see \`{@link https://api.jquery.com/jQuery.queue/ }\`
      * @since 1.3
      */
     queue<T extends Element>(element: T, queueName?: string, newQueue?: JQuery.TypeOrArray<JQuery.QueueFunction<T>>): JQuery.Queue<T>;
@@ -2950,7 +2950,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Handles errors thrown synchronously in functions wrapped in jQuery().
      *
      * @param error An error thrown in the function wrapped in jQuery().
-     * @see {@link https://api.jquery.com/jQuery.readyException/}
+     * @see \`{@link https://api.jquery.com/jQuery.readyException/ }\`
      * @since 3.1
      */
     readyException(error: Error): any;
@@ -2959,7 +2959,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param element A DOM element from which to remove data.
      * @param name A string naming the piece of data to remove.
-     * @see {@link https://api.jquery.com/jQuery.removeData/}
+     * @see \`{@link https://api.jquery.com/jQuery.removeData/ }\`
      * @since 1.2.3
      */
     removeData(element: Element, name?: string): void;
@@ -2969,7 +2969,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/jQuery.speed/}
+     * @see \`{@link https://api.jquery.com/jQuery.speed/ }\`
      * @since 1.1
      */
     speed(duration: JQuery.Duration, easing: string, complete: (this: TElement) => void): JQuery.EffectsOptions<TElement>;
@@ -2979,7 +2979,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @param duration A string or number determining how long the animation will run.
      * @param easing_complete A string indicating which easing function to use for the transition.
      *                        A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/jQuery.speed/}
+     * @see \`{@link https://api.jquery.com/jQuery.speed/ }\`
      * @since 1.0
      * @since 1.1
      */
@@ -2990,7 +2990,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      *
      * @param duration_complete_settings A string or number determining how long the animation will run.
      *                                   A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/jQuery.speed/}
+     * @see \`{@link https://api.jquery.com/jQuery.speed/ }\`
      * @since 1.0
      * @since 1.1
      */
@@ -2999,7 +2999,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Remove the whitespace from the beginning and end of a string.
      *
      * @param str The string to trim.
-     * @see {@link https://api.jquery.com/jQuery.trim/}
+     * @see \`{@link https://api.jquery.com/jQuery.trim/ }\`
      * @since 1.0
      */
     trim(str: string): string;
@@ -3007,7 +3007,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Determine the internal JavaScript [[Class]] of an object.
      *
      * @param obj Object to get the internal JavaScript [[Class]] of.
-     * @see {@link https://api.jquery.com/jQuery.type/}
+     * @see \`{@link https://api.jquery.com/jQuery.type/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3017,7 +3017,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * arrays of DOM elements, not strings or numbers.
      *
      * @param array The Array of DOM elements.
-     * @see {@link https://api.jquery.com/jQuery.unique/}
+     * @see \`{@link https://api.jquery.com/jQuery.unique/ }\`
      * @since 1.1.3
      * @deprecated 3.0
      */
@@ -3027,7 +3027,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * arrays of DOM elements, not strings or numbers.
      *
      * @param array The Array of DOM elements.
-     * @see {@link https://api.jquery.com/jQuery.uniqueSort/}
+     * @see \`{@link https://api.jquery.com/jQuery.uniqueSort/ }\`
      * @since 1.12
      * @since 2.2
      */
@@ -3036,7 +3036,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Provides a way to execute callback functions based on zero or more Thenable objects, usually
      * Deferred objects that represent asynchronous events.
      *
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when<TR1, UR1, VR1,
@@ -3050,7 +3050,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Provides a way to execute callback functions based on zero or more Thenable objects, usually
      * Deferred objects that represent asynchronous events.
      *
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when<TR1, UR1,
@@ -3062,7 +3062,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Provides a way to execute callback functions based on zero or more Thenable objects, usually
      * Deferred objects that represent asynchronous events.
      *
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when<TR1, TJ1,
@@ -3074,7 +3074,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Provides a way to execute callback functions based on zero or more Thenable objects, usually
      * Deferred objects that represent asynchronous events.
      *
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when<TR1, TJ1 = any>(deferred: JQuery.Promise<TR1, TJ1, any> | JQuery.Thenable<TR1> | TR1): JQuery.Promise<TR1, TJ1, never>;
@@ -3083,7 +3083,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Deferred objects that represent asynchronous events.
      *
      * @param deferreds Zero or more Thenable objects.
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when<TR1 = never, TJ1 = never>(...deferreds: Array<JQuery.Promise<TR1, TJ1, any> | JQuery.Thenable<TR1> | TR1>): JQuery.Promise<TR1, TJ1, never>;
@@ -3092,7 +3092,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * Deferred objects that represent asynchronous events.
      *
      * @param deferreds Zero or more Thenable objects.
-     * @see {@link https://api.jquery.com/jQuery.when/}
+     * @see \`{@link https://api.jquery.com/jQuery.when/ }\`
      * @since 1.5
      */
     when(...deferreds: any[]): JQuery.Promise<any, any, never>;
@@ -3102,14 +3102,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * A string containing the jQuery version number.
      *
-     * @see {@link https://api.jquery.com/jquery/}
+     * @see \`{@link https://api.jquery.com/jquery/ }\`
      * @since 1.0
      */
     jquery: string;
     /**
      * The number of elements in the jQuery object.
      *
-     * @see {@link https://api.jquery.com/length/}
+     * @see \`{@link https://api.jquery.com/length/ }\`
      * @since 1.0
      */
     length: number;
@@ -3119,7 +3119,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A string representing a selector expression to find additional elements to add to the set of matched elements.
      * @param context The point in the document at which the selector should begin matching; similar to the context
      *                argument of the $(selector, context) method.
-     * @see {@link https://api.jquery.com/add/}
+     * @see \`{@link https://api.jquery.com/add/ }\`
      * @since 1.4
      */
     add(selector: JQuery.Selector, context: Element): this;
@@ -3130,7 +3130,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 One or more elements to add to the set of matched elements.
      *                 An HTML fragment to add to the set of matched elements.
      *                 An existing jQuery object to add to the set of matched elements.
-     * @see {@link https://api.jquery.com/add/}
+     * @see \`{@link https://api.jquery.com/add/ }\`
      * @since 1.0
      * @since 1.3.2
      */
@@ -3139,7 +3139,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Add the previous set of elements on the stack to the current set, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match the current set of elements against.
-     * @see {@link https://api.jquery.com/addBack/}
+     * @see \`{@link https://api.jquery.com/addBack/ }\`
      * @since 1.8
      */
     addBack(selector?: JQuery.Selector): this;
@@ -3151,7 +3151,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                  A function returning one or more space-separated class names to be added to the existing class
      *                  name(s). Receives the index position of the element in the set and the existing class name(s) as
      *                  arguments. Within the function, this refers to the current element in the set.
-     * @see {@link https://api.jquery.com/addClass/}
+     * @see \`{@link https://api.jquery.com/addClass/ }\`
      * @since 1.0
      * @since 1.4
      * @since 3.3
@@ -3162,7 +3162,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param contents One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or
      *                 jQuery objects to insert after each element in the set of matched elements.
-     * @see {@link https://api.jquery.com/after/}
+     * @see \`{@link https://api.jquery.com/after/ }\`
      * @since 1.0
      */
     after(...contents: Array<JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>>): this;
@@ -3173,7 +3173,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *           after each element in the set of matched elements. Receives the index position of the element in the
      *           set and the old HTML value of the element as arguments. Within the function, this refers to the
      *           current element in the set.
-     * @see {@link https://api.jquery.com/after/}
+     * @see \`{@link https://api.jquery.com/after/ }\`
      * @since 1.4
      * @since 1.10
      */
@@ -3182,7 +3182,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Register a handler to be called when Ajax requests complete. This is an AjaxEvent.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxComplete/}
+     * @see \`{@link https://api.jquery.com/ajaxComplete/ }\`
      * @since 1.0
      */
     ajaxComplete(handler: (this: Document, event: JQuery.Event<Document>, jqXHR: JQuery.jqXHR, ajaxOptions: JQuery.AjaxSettings) => void | false): this;
@@ -3190,7 +3190,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Register a handler to be called when Ajax requests complete with an error. This is an Ajax Event.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxError/}
+     * @see \`{@link https://api.jquery.com/ajaxError/ }\`
      * @since 1.0
      */
     ajaxError(handler: (this: Document, event: JQuery.Event<Document>, jqXHR: JQuery.jqXHR, ajaxSettings: JQuery.AjaxSettings, thrownError: string) => void | false): this;
@@ -3198,7 +3198,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Attach a function to be executed before an Ajax request is sent. This is an Ajax Event.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxSend/}
+     * @see \`{@link https://api.jquery.com/ajaxSend/ }\`
      * @since 1.0
      */
     ajaxSend(handler: (this: Document, event: JQuery.Event<Document>, jqXHR: JQuery.jqXHR, ajaxOptions: JQuery.AjaxSettings) => void | false): this;
@@ -3206,7 +3206,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Register a handler to be called when the first Ajax request begins. This is an Ajax Event.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxStart/}
+     * @see \`{@link https://api.jquery.com/ajaxStart/ }\`
      * @since 1.0
      */
     ajaxStart(handler: (this: Document) => void | false): this;
@@ -3214,7 +3214,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Register a handler to be called when all Ajax requests have completed. This is an Ajax Event.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxStop/}
+     * @see \`{@link https://api.jquery.com/ajaxStop/ }\`
      * @since 1.0
      */
     ajaxStop(handler: (this: Document) => void | false): this;
@@ -3222,7 +3222,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Attach a function to be executed whenever an Ajax request completes successfully. This is an Ajax Event.
      *
      * @param handler The function to be invoked.
-     * @see {@link https://api.jquery.com/ajaxSuccess/}
+     * @see \`{@link https://api.jquery.com/ajaxSuccess/ }\`
      * @since 1.0
      */
     ajaxSuccess(handler: (this: Document, event: JQuery.Event<Document>, jqXHR: JQuery.jqXHR, ajaxOptions: JQuery.AjaxSettings, data: JQuery.PlainObject) => void | false): this;
@@ -3233,7 +3233,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/animate/}
+     * @see \`{@link https://api.jquery.com/animate/ }\`
      * @since 1.0
      */
     animate(properties: JQuery.PlainObject,
@@ -3247,7 +3247,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/animate/}
+     * @see \`{@link https://api.jquery.com/animate/ }\`
      * @since 1.0
      */
     animate(properties: JQuery.PlainObject,
@@ -3258,7 +3258,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param properties An object of CSS properties and values that the animation will move toward.
      * @param options A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/animate/}
+     * @see \`{@link https://api.jquery.com/animate/ }\`
      * @since 1.0
      */
     animate(properties: JQuery.PlainObject,
@@ -3268,7 +3268,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param properties An object of CSS properties and values that the animation will move toward.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/animate/}
+     * @see \`{@link https://api.jquery.com/animate/ }\`
      * @since 1.0
      */
     animate(properties: JQuery.PlainObject,
@@ -3278,7 +3278,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param contents One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or
      *                 jQuery objects to insert at the end of each element in the set of matched elements.
-     * @see {@link https://api.jquery.com/append/}
+     * @see \`{@link https://api.jquery.com/append/ }\`
      * @since 1.0
      */
     append(...contents: Array<JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>>): this;
@@ -3289,7 +3289,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *           the end of each element in the set of matched elements. Receives the index position of the element
      *           in the set and the old HTML value of the element as arguments. Within the function, this refers to
      *           the current element in the set.
-     * @see {@link https://api.jquery.com/append/}
+     * @see \`{@link https://api.jquery.com/append/ }\`
      * @since 1.4
      */
     append(fn: (this: TElement, index: number, html: string) => JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>): this;
@@ -3298,7 +3298,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param target A selector, element, HTML string, array of elements, or jQuery object; the matched set of elements
      *               will be inserted at the end of the element(s) specified by this parameter.
-     * @see {@link https://api.jquery.com/appendTo/}
+     * @see \`{@link https://api.jquery.com/appendTo/ }\`
      * @since 1.0
      */
     appendTo(target: JQuery.Selector | JQuery.htmlString | JQuery.TypeOrArray<Element> | JQuery): this;
@@ -3309,7 +3309,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param value A value to set for the attribute. If null, the specified attribute will be removed (as in .removeAttr()).
      *              A function returning the value to set. this is the current element. Receives the index position of
      *              the element in the set and the old attribute value as arguments.
-     * @see {@link https://api.jquery.com/attr/}
+     * @see \`{@link https://api.jquery.com/attr/ }\`
      * @since 1.0
      * @since 1.1
      */
@@ -3319,7 +3319,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Set one or more attributes for the set of matched elements.
      *
      * @param attributes An object of attribute-value pairs to set.
-     * @see {@link https://api.jquery.com/attr/}
+     * @see \`{@link https://api.jquery.com/attr/ }\`
      * @since 1.0
      */
     attr(attributes: JQuery.PlainObject): this;
@@ -3327,7 +3327,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the value of an attribute for the first element in the set of matched elements.
      *
      * @param attributeName The name of the attribute to get.
-     * @see {@link https://api.jquery.com/attr/}
+     * @see \`{@link https://api.jquery.com/attr/ }\`
      * @since 1.0
      */
     attr(attributeName: string): string | undefined;
@@ -3336,7 +3336,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param contents One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or
      *                 jQuery objects to insert before each element in the set of matched elements.
-     * @see {@link https://api.jquery.com/before/}
+     * @see \`{@link https://api.jquery.com/before/ }\`
      * @since 1.0
      */
     before(...contents: Array<JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>>): this;
@@ -3347,7 +3347,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *           before each element in the set of matched elements. Receives the index position of the element in
      *           the set and the old HTML value of the element as arguments. Within the function, this refers to the
      *           current element in the set.
-     * @see {@link https://api.jquery.com/before/}
+     * @see \`{@link https://api.jquery.com/before/ }\`
      * @since 1.4
      * @since 1.10
      */
@@ -3359,7 +3359,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param eventType A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/bind/}
+     * @see \`{@link https://api.jquery.com/bind/ }\`
      * @since 1.0
      * @since 1.4.3
      * @deprecated 3.0
@@ -3374,7 +3374,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param handler A function to execute each time the event is triggered.
      *                Setting the second argument to false will attach a function that prevents the default action from
      *                occurring and stops the event from bubbling.
-     * @see {@link https://api.jquery.com/bind/}
+     * @see \`{@link https://api.jquery.com/bind/ }\`
      * @since 1.0
      * @since 1.4.3
      * @deprecated 3.0
@@ -3385,7 +3385,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Attach a handler to an event for the elements.
      *
      * @param events An object containing one or more DOM event types and functions to execute for them.
-     * @see {@link https://api.jquery.com/bind/}
+     * @see \`{@link https://api.jquery.com/bind/ }\`
      * @since 1.4
      * @deprecated 3.0
      */
@@ -3395,7 +3395,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/blur/}
+     * @see \`{@link https://api.jquery.com/blur/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3405,7 +3405,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "blur" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/blur/}
+     * @see \`{@link https://api.jquery.com/blur/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3415,7 +3415,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/change/}
+     * @see \`{@link https://api.jquery.com/change/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3425,7 +3425,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "change" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/change/}
+     * @see \`{@link https://api.jquery.com/change/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3434,7 +3434,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the children of each element in the set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/children/}
+     * @see \`{@link https://api.jquery.com/children/ }\`
      * @since 1.0
      */
     children(selector?: JQuery.Selector): this;
@@ -3442,7 +3442,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove from the queue all items that have not yet been run.
      *
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
-     * @see {@link https://api.jquery.com/clearQueue/}
+     * @see \`{@link https://api.jquery.com/clearQueue/ }\`
      * @since 1.4
      */
     clearQueue(queueName?: string): this;
@@ -3451,7 +3451,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/click/}
+     * @see \`{@link https://api.jquery.com/click/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3461,7 +3461,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "click" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/click/}
+     * @see \`{@link https://api.jquery.com/click/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3474,7 +3474,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                          to false in 1.5.1 and up.
      * @param deepWithDataAndEvents A Boolean indicating whether event handlers and data for all children of the cloned element should
      *                              be copied. By default its value matches the first argument's value (which defaults to false).
-     * @see {@link https://api.jquery.com/clone/}
+     * @see \`{@link https://api.jquery.com/clone/ }\`
      * @since 1.0
      * @since 1.5
      */
@@ -3485,7 +3485,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param selector A string containing a selector expression to match elements against.
      * @param context A DOM element within which a matching element may be found.
-     * @see {@link https://api.jquery.com/closest/}
+     * @see \`{@link https://api.jquery.com/closest/ }\`
      * @since 1.4
      */
     closest(selector: JQuery.Selector, context: Element): this;
@@ -3496,7 +3496,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A string containing a selector expression to match elements against.
      *                 A jQuery object to match elements against.
      *                 An element to match elements against.
-     * @see {@link https://api.jquery.com/closest/}
+     * @see \`{@link https://api.jquery.com/closest/ }\`
      * @since 1.3
      * @since 1.6
      */
@@ -3504,7 +3504,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the children of each element in the set of matched elements, including text and comment nodes.
      *
-     * @see {@link https://api.jquery.com/contents/}
+     * @see \`{@link https://api.jquery.com/contents/ }\`
      * @since 1.2
      */
     contents(): JQuery<TElement | Text | Comment>;
@@ -3513,7 +3513,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/contextmenu/}
+     * @see \`{@link https://api.jquery.com/contextmenu/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3523,7 +3523,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "contextmenu" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/contextmenu/}
+     * @see \`{@link https://api.jquery.com/contextmenu/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3535,7 +3535,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param value A value to set for the property.
      *              A function returning the value to set. this is the current element. Receives the index position of
      *              the element in the set and the old value as arguments.
-     * @see {@link https://api.jquery.com/css/}
+     * @see \`{@link https://api.jquery.com/css/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -3545,7 +3545,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Set one or more CSS properties for the set of matched elements.
      *
      * @param properties An object of property-value pairs to set.
-     * @see {@link https://api.jquery.com/css/}
+     * @see \`{@link https://api.jquery.com/css/ }\`
      * @since 1.0
      */
     css(properties: JQuery.PlainObject<string | number | ((this: TElement, index: number, value: string) => string | number | void | undefined)>): this;
@@ -3554,7 +3554,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param propertyName A CSS property.
      *                     An array of one or more CSS properties.
-     * @see {@link https://api.jquery.com/css/}
+     * @see \`{@link https://api.jquery.com/css/ }\`
      * @since 1.0
      */
     css(propertyName: string): string;
@@ -3562,7 +3562,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the computed style properties for the first element in the set of matched elements.
      *
      * @param propertyNames An array of one or more CSS properties.
-     * @see {@link https://api.jquery.com/css/}
+     * @see \`{@link https://api.jquery.com/css/ }\`
      * @since 1.9
      */
     css(propertyNames: string[]): JQuery.PlainObject<string>;
@@ -3571,7 +3571,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * data(name, value) or by an HTML5 data-* attribute.
      *
      * @param key Name of the data stored.
-     * @see {@link https://api.jquery.com/data/}
+     * @see \`{@link https://api.jquery.com/data/ }\`
      * @since 1.2.3
      */
     data(key: string, undefined: undefined): any; // tslint:disable-line:unified-signatures
@@ -3580,7 +3580,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param key A string naming the piece of data to set.
      * @param value The new data value; this can be any Javascript type except undefined.
-     * @see {@link https://api.jquery.com/data/}
+     * @see \`{@link https://api.jquery.com/data/ }\`
      * @since 1.2.3
      */
     data(key: string, value: any): this;
@@ -3588,7 +3588,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Store arbitrary data associated with the matched elements.
      *
      * @param obj An object of key-value pairs of data to update.
-     * @see {@link https://api.jquery.com/data/}
+     * @see \`{@link https://api.jquery.com/data/ }\`
      * @since 1.4.3
      */
     data(obj: JQuery.PlainObject): this;
@@ -3597,7 +3597,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * data(name, value) or by an HTML5 data-* attribute.
      *
      * @param key Name of the data stored.
-     * @see {@link https://api.jquery.com/data/}
+     * @see \`{@link https://api.jquery.com/data/ }\`
      * @since 1.2.3
      */
     data(key: string): any;
@@ -3605,7 +3605,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Return the value at the named data store for the first element in the jQuery collection, as set by
      * data(name, value) or by an HTML5 data-* attribute.
      *
-     * @see {@link https://api.jquery.com/data/}
+     * @see \`{@link https://api.jquery.com/data/ }\`
      * @since 1.4
      */
     data(): JQuery.PlainObject;
@@ -3614,7 +3614,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/dblclick/}
+     * @see \`{@link https://api.jquery.com/dblclick/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3624,7 +3624,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/dblclick/}
+     * @see \`{@link https://api.jquery.com/dblclick/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3634,7 +3634,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param duration An integer indicating the number of milliseconds to delay execution of the next item in the queue.
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
-     * @see {@link https://api.jquery.com/delay/}
+     * @see \`{@link https://api.jquery.com/delay/ }\`
      * @since 1.4
      */
     delay(duration: JQuery.Duration, queueName?: string): this;
@@ -3647,7 +3647,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                  "keydown," or custom event names.
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/delegate/}
+     * @see \`{@link https://api.jquery.com/delegate/ }\`
      * @since 1.4.2
      * @deprecated 3.0
      */
@@ -3663,7 +3663,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param eventType A string containing one or more space-separated JavaScript event types, such as "click" or
      *                  "keydown," or custom event names.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/delegate/}
+     * @see \`{@link https://api.jquery.com/delegate/ }\`
      * @since 1.4.2
      * @deprecated 3.0
      */
@@ -3676,7 +3676,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param selector A selector to filter the elements that trigger the event.
      * @param events A plain object of one or more event types and functions to execute for them.
-     * @see {@link https://api.jquery.com/delegate/}
+     * @see \`{@link https://api.jquery.com/delegate/ }\`
      * @since 1.4.3
      * @deprecated 3.0
      */
@@ -3686,7 +3686,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Execute the next function on the queue for the matched elements.
      *
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
-     * @see {@link https://api.jquery.com/dequeue/}
+     * @see \`{@link https://api.jquery.com/dequeue/ }\`
      * @since 1.2
      */
     dequeue(queueName?: string): this;
@@ -3694,7 +3694,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove the set of matched elements from the DOM.
      *
      * @param selector A selector expression that filters the set of matched elements to be removed.
-     * @see {@link https://api.jquery.com/detach/}
+     * @see \`{@link https://api.jquery.com/detach/ }\`
      * @since 1.4
      */
     detach(selector?: JQuery.Selector): this;
@@ -3702,14 +3702,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Iterate over a jQuery object, executing a function for each matched element.
      *
      * @param fn A function to execute for each matched element.
-     * @see {@link https://api.jquery.com/each/}
+     * @see \`{@link https://api.jquery.com/each/ }\`
      * @since 1.0
      */
     each(fn: (this: TElement, index: number, element: TElement) => void | false): this;
     /**
      * Remove all child nodes of the set of matched elements from the DOM.
      *
-     * @see {@link https://api.jquery.com/empty/}
+     * @see \`{@link https://api.jquery.com/empty/ }\`
      * @since 1.0
      */
     empty(): this;
@@ -3717,7 +3717,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * End the most recent filtering operation in the current chain and return the set of matched elements
      * to its previous state.
      *
-     * @see {@link https://api.jquery.com/end/}
+     * @see \`{@link https://api.jquery.com/end/ }\`
      * @since 1.0
      */
     end(): this;
@@ -3726,7 +3726,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param index An integer indicating the 0-based position of the element.
      *              An integer indicating the position of the element, counting backwards from the last element in the set.
-     * @see {@link https://api.jquery.com/eq/}
+     * @see \`{@link https://api.jquery.com/eq/ }\`
      * @since 1.1.2
      * @since 1.4
      */
@@ -3735,7 +3735,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Merge the contents of an object onto the jQuery prototype to provide new jQuery instance methods.
      *
      * @param obj An object to merge onto the jQuery prototype.
-     * @see {@link https://api.jquery.com/jQuery.fn.extend/}
+     * @see \`{@link https://api.jquery.com/jQuery.fn.extend/ }\`
      * @since 1.0
      */
     extend(obj: object): this;
@@ -3745,7 +3745,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeIn/}
+     * @see \`{@link https://api.jquery.com/fadeIn/ }\`
      * @since 1.4.3
      */
     fadeIn(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -3755,7 +3755,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeIn/}
+     * @see \`{@link https://api.jquery.com/fadeIn/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3767,7 +3767,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/fadeIn/}
+     * @see \`{@link https://api.jquery.com/fadeIn/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3778,7 +3778,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeOut/}
+     * @see \`{@link https://api.jquery.com/fadeOut/ }\`
      * @since 1.4.3
      */
     fadeOut(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -3788,7 +3788,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeOut/}
+     * @see \`{@link https://api.jquery.com/fadeOut/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3800,7 +3800,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/fadeOut/}
+     * @see \`{@link https://api.jquery.com/fadeOut/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3812,7 +3812,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param opacity A number between 0 and 1 denoting the target opacity.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeTo/}
+     * @see \`{@link https://api.jquery.com/fadeTo/ }\`
      * @since 1.4.3
      */
     fadeTo(duration: JQuery.Duration, opacity: number, easing: string, complete?: (this: TElement) => void): this;
@@ -3822,7 +3822,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param opacity A number between 0 and 1 denoting the target opacity.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeTo/}
+     * @see \`{@link https://api.jquery.com/fadeTo/ }\`
      * @since 1.0
      */
     fadeTo(duration: JQuery.Duration, opacity: number, complete?: (this: TElement) => void): this;
@@ -3832,7 +3832,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeToggle/}
+     * @see \`{@link https://api.jquery.com/fadeToggle/ }\`
      * @since 1.4.4
      */
     fadeToggle(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -3842,7 +3842,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/fadeToggle/}
+     * @see \`{@link https://api.jquery.com/fadeToggle/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3854,7 +3854,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/fadeToggle/}
+     * @see \`{@link https://api.jquery.com/fadeToggle/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -3866,7 +3866,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 One or more DOM elements to match the current set of elements against.
      *                 An existing jQuery object to match the current set of elements against.
      *                 A function used as a test for each element in the set. this is the current DOM element.
-     * @see {@link https://api.jquery.com/filter/}
+     * @see \`{@link https://api.jquery.com/filter/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -3877,7 +3877,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param selector A string containing a selector expression to match elements against.
      *                 An element or a jQuery object to match elements against.
-     * @see {@link https://api.jquery.com/find/}
+     * @see \`{@link https://api.jquery.com/find/ }\`
      * @since 1.0
      * @since 1.6
      */
@@ -3887,14 +3887,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * the matched elements.
      *
      * @param queue The name of the queue in which to stop animations.
-     * @see {@link https://api.jquery.com/finish/}
+     * @see \`{@link https://api.jquery.com/finish/ }\`
      * @since 1.9
      */
     finish(queue?: string): this;
     /**
      * Reduce the set of matched elements to the first in the set.
      *
-     * @see {@link https://api.jquery.com/first/}
+     * @see \`{@link https://api.jquery.com/first/ }\`
      * @since 1.4
      */
     first(): this;
@@ -3903,7 +3903,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focus/}
+     * @see \`{@link https://api.jquery.com/focus/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3913,7 +3913,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "focus" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focus/}
+     * @see \`{@link https://api.jquery.com/focus/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -3923,7 +3923,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focusin/}
+     * @see \`{@link https://api.jquery.com/focusin/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3933,7 +3933,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "focusin" event.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focusin/}
+     * @see \`{@link https://api.jquery.com/focusin/ }\`
      * @since 1.4
      * @deprecated 3.3
      */
@@ -3943,7 +3943,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focusout/}
+     * @see \`{@link https://api.jquery.com/focusout/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -3953,7 +3953,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "focusout" JavaScript event.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/focusout/}
+     * @see \`{@link https://api.jquery.com/focusout/ }\`
      * @since 1.4
      * @deprecated 3.3
      */
@@ -3962,14 +3962,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Retrieve one of the elements matched by the jQuery object.
      *
      * @param index A zero-based integer indicating which element to retrieve.
-     * @see {@link https://api.jquery.com/get/}
+     * @see \`{@link https://api.jquery.com/get/ }\`
      * @since 1.0
      */
     get(index: number): TElement;
     /**
      * Retrieve the elements matched by the jQuery object.
      *
-     * @see {@link https://api.jquery.com/get/}
+     * @see \`{@link https://api.jquery.com/get/ }\`
      * @since 1.0
      */
     get(): TElement[];
@@ -3978,7 +3978,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param selector A string containing a selector expression to match elements against.
      *                 A DOM element to match elements against.
-     * @see {@link https://api.jquery.com/has/}
+     * @see \`{@link https://api.jquery.com/has/ }\`
      * @since 1.4
      */
     has(selector: string | Element): this;
@@ -3986,7 +3986,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Determine whether any of the matched elements are assigned the given class.
      *
      * @param className The class name to search for.
-     * @see {@link https://api.jquery.com/hasClass/}
+     * @see \`{@link https://api.jquery.com/hasClass/ }\`
      * @since 1.2
      */
     hasClass(className: string): boolean;
@@ -3997,7 +3997,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              appended (as a string).
      *              A function returning the height to set. Receives the index position of the element in the set and
      *              the old height as arguments. Within the function, this refers to the current element in the set.
-     * @see {@link https://api.jquery.com/height/}
+     * @see \`{@link https://api.jquery.com/height/ }\`
      * @since 1.0
      * @since 1.4.1
      */
@@ -4005,7 +4005,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the current computed height for the first element in the set of matched elements.
      *
-     * @see {@link https://api.jquery.com/height/}
+     * @see \`{@link https://api.jquery.com/height/ }\`
      * @since 1.0
      */
     height(): number | undefined;
@@ -4015,7 +4015,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/hide/}
+     * @see \`{@link https://api.jquery.com/hide/ }\`
      * @since 1.4.3
      */
     hide(duration: JQuery.Duration, easing: string, complete: (this: TElement) => void): this;
@@ -4025,7 +4025,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing_complete A string indicating which easing function to use for the transition.
      *                        A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/hide/}
+     * @see \`{@link https://api.jquery.com/hide/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -4036,7 +4036,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_complete_options A string or number determining how long the animation will run.
      *                                  A function to call once the animation is complete, called once per matched element.
      *                                  A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/hide/}
+     * @see \`{@link https://api.jquery.com/hide/ }\`
      * @since 1.0
      */
     hide(duration_complete_options?: JQuery.Duration | ((this: TElement) => void) | JQuery.EffectsOptions<TElement>): this;
@@ -4046,7 +4046,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param handlerInOut A function to execute when the mouse pointer enters or leaves the element.
      * @param handlerOut A function to execute when the mouse pointer leaves the element.
-     * @see {@link https://api.jquery.com/hover/}
+     * @see \`{@link https://api.jquery.com/hover/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -4060,7 +4060,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                   A function returning the HTML content to set. Receives the index position of the element in the set
      *                   and the old HTML value as arguments. jQuery empties the element before calling the function; use the
      *                   oldhtml argument to reference the previous content. Within the function, this refers to the current element in the set.
-     * @see {@link https://api.jquery.com/html/}
+     * @see \`{@link https://api.jquery.com/html/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -4068,7 +4068,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the HTML contents of the first element in the set of matched elements.
      *
-     * @see {@link https://api.jquery.com/html/}
+     * @see \`{@link https://api.jquery.com/html/ }\`
      * @since 1.0
      */
     html(): string;
@@ -4077,7 +4077,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param element The DOM element or first element within the jQuery object to look for.
      *                A selector representing a jQuery collection in which to look for an element.
-     * @see {@link https://api.jquery.com/index/}
+     * @see \`{@link https://api.jquery.com/index/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -4090,7 +4090,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              A function returning the inner height (including padding but not border) to set. Receives the index
      *              position of the element in the set and the old inner height as arguments. Within the function, this
      *              refers to the current element in the set.
-     * @see {@link https://api.jquery.com/innerHeight/}
+     * @see \`{@link https://api.jquery.com/innerHeight/ }\`
      * @since 1.8.0
      */
     innerHeight(value: string | number | ((this: TElement, index: number, height: number) => string | number)): this;
@@ -4098,7 +4098,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the current computed height for the first element in the set of matched elements, including
      * padding but not border.
      *
-     * @see {@link https://api.jquery.com/innerHeight/}
+     * @see \`{@link https://api.jquery.com/innerHeight/ }\`
      * @since 1.2.6
      */
     innerHeight(): number | undefined;
@@ -4110,7 +4110,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              A function returning the inner width (including padding but not border) to set. Receives the index
      *              position of the element in the set and the old inner width as arguments. Within the function, this
      *              refers to the current element in the set.
-     * @see {@link https://api.jquery.com/innerWidth/}
+     * @see \`{@link https://api.jquery.com/innerWidth/ }\`
      * @since 1.8.0
      */
     innerWidth(value: string | number | ((this: TElement, index: number, width: number) => string | number)): this;
@@ -4118,7 +4118,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the current computed inner width for the first element in the set of matched elements, including
      * padding but not border.
      *
-     * @see {@link https://api.jquery.com/innerWidth/}
+     * @see \`{@link https://api.jquery.com/innerWidth/ }\`
      * @since 1.2.6
      */
     innerWidth(): number | undefined;
@@ -4127,7 +4127,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param target A selector, element, array of elements, HTML string, or jQuery object; the matched set of elements
      *               will be inserted after the element(s) specified by this parameter.
-     * @see {@link https://api.jquery.com/insertAfter/}
+     * @see \`{@link https://api.jquery.com/insertAfter/ }\`
      * @since 1.0
      */
     insertAfter(target: JQuery.Selector | JQuery.htmlString | JQuery.TypeOrArray<Element> | JQuery): this;
@@ -4136,7 +4136,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param target A selector, element, array of elements, HTML string, or jQuery object; the matched set of elements
      *               will be inserted before the element(s) specified by this parameter.
-     * @see {@link https://api.jquery.com/insertBefore/}
+     * @see \`{@link https://api.jquery.com/insertBefore/ }\`
      * @since 1.0
      */
     insertBefore(target: JQuery.Selector | JQuery.htmlString | JQuery.TypeOrArray<Element> | JQuery): this;
@@ -4150,7 +4150,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 function, this refers to the current DOM element.
      *                 An existing jQuery object to match the current set of elements against.
      *                 One or more elements to match the current set of elements against.
-     * @see {@link https://api.jquery.com/is/}
+     * @see \`{@link https://api.jquery.com/is/ }\`
      * @since 1.0
      * @since 1.6
      */
@@ -4160,7 +4160,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keydown/}
+     * @see \`{@link https://api.jquery.com/keydown/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4170,7 +4170,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keydown/}
+     * @see \`{@link https://api.jquery.com/keydown/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4180,7 +4180,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keypress/}
+     * @see \`{@link https://api.jquery.com/keypress/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4190,7 +4190,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keypress/}
+     * @see \`{@link https://api.jquery.com/keypress/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4200,7 +4200,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keyup/}
+     * @see \`{@link https://api.jquery.com/keyup/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4210,7 +4210,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "keyup" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/keyup/}
+     * @see \`{@link https://api.jquery.com/keyup/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4218,7 +4218,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Reduce the set of matched elements to the final one in the set.
      *
-     * @see {@link https://api.jquery.com/last/}
+     * @see \`{@link https://api.jquery.com/last/ }\`
      * @since 1.4
      */
     last(): this;
@@ -4228,7 +4228,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param url A string containing the URL to which the request is sent.
      * @param data A plain object or string that is sent to the server with the request.
      * @param complete A callback function that is executed when the request completes.
-     * @see {@link https://api.jquery.com/load/}
+     * @see \`{@link https://api.jquery.com/load/ }\`
      * @since 1.0
      */
     load(url: string,
@@ -4240,7 +4240,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param url A string containing the URL to which the request is sent.
      * @param complete_data A callback function that is executed when the request completes.
      *                      A plain object or string that is sent to the server with the request.
-     * @see {@link https://api.jquery.com/load/}
+     * @see \`{@link https://api.jquery.com/load/ }\`
      * @since 1.0
      */
     load(url: string,
@@ -4250,7 +4250,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * containing the return values.
      *
      * @param callback A function object that will be invoked for each element in the current set.
-     * @see {@link https://api.jquery.com/map/}
+     * @see \`{@link https://api.jquery.com/map/ }\`
      * @since 1.2
      */
     map(callback: (this: TElement, index: number, domElement: TElement) => any | any[] | null | undefined): this;
@@ -4259,7 +4259,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mousedown/}
+     * @see \`{@link https://api.jquery.com/mousedown/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4269,7 +4269,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mousedown/}
+     * @see \`{@link https://api.jquery.com/mousedown/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4279,7 +4279,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseenter/}
+     * @see \`{@link https://api.jquery.com/mouseenter/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4289,7 +4289,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseenter/}
+     * @see \`{@link https://api.jquery.com/mouseenter/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4299,7 +4299,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseleave/}
+     * @see \`{@link https://api.jquery.com/mouseleave/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4309,7 +4309,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseleave/}
+     * @see \`{@link https://api.jquery.com/mouseleave/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4319,7 +4319,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mousemove/}
+     * @see \`{@link https://api.jquery.com/mousemove/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4329,7 +4329,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mousemove/}
+     * @see \`{@link https://api.jquery.com/mousemove/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4339,7 +4339,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseout/}
+     * @see \`{@link https://api.jquery.com/mouseout/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4349,7 +4349,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseout/}
+     * @see \`{@link https://api.jquery.com/mouseout/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4359,7 +4359,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseover/}
+     * @see \`{@link https://api.jquery.com/mouseover/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4369,7 +4369,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseover/}
+     * @see \`{@link https://api.jquery.com/mouseover/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4379,7 +4379,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseup/}
+     * @see \`{@link https://api.jquery.com/mouseup/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -4389,7 +4389,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/mouseup/}
+     * @see \`{@link https://api.jquery.com/mouseup/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -4399,7 +4399,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * is provided, it retrieves the next sibling only if it matches that selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/next/}
+     * @see \`{@link https://api.jquery.com/next/ }\`
      * @since 1.0
      */
     next(selector?: JQuery.Selector): this;
@@ -4407,7 +4407,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get all following siblings of each element in the set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/nextAll/}
+     * @see \`{@link https://api.jquery.com/nextAll/ }\`
      * @since 1.2
      */
     nextAll(selector?: string): this;
@@ -4418,7 +4418,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A string containing a selector expression to indicate where to stop matching following sibling elements.
      *                 A DOM node or jQuery object indicating where to stop matching following sibling elements.
      * @param filter A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/nextUntil/}
+     * @see \`{@link https://api.jquery.com/nextUntil/ }\`
      * @since 1.4
      * @since 1.6
      */
@@ -4431,7 +4431,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 element's index in the jQuery collection, and element, which is the DOM element. Within the
      *                 function, this refers to the current DOM element.
      *                 An existing jQuery object to match the current set of elements against.
-     * @see {@link https://api.jquery.com/not/}
+     * @see \`{@link https://api.jquery.com/not/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -4443,7 +4443,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *               "click", "keydown.myPlugin", or ".myPlugin".
      * @param selector A selector which should match the one originally passed to .on() when attaching event handlers.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/off/}
+     * @see \`{@link https://api.jquery.com/off/ }\`
      * @since 1.7
      */
     off(events: string, selector: JQuery.Selector, handler: JQuery.EventHandlerBase<any, JQuery.Event<TElement, any>> | false): this;
@@ -4454,7 +4454,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *               "click", "keydown.myPlugin", or ".myPlugin".
      * @param selector_handler A selector which should match the one originally passed to .on() when attaching event handlers.
      *                         A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/off/}
+     * @see \`{@link https://api.jquery.com/off/ }\`
      * @since 1.7
      */
     off(events: string, selector_handler?: JQuery.Selector | JQuery.EventHandlerBase<any, JQuery.Event<TElement, any>> | false): this;
@@ -4464,7 +4464,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events An object where the string keys represent one or more space-separated event types and optional
      *               namespaces, and the values represent handler functions previously attached for the event(s).
      * @param selector A selector which should match the one originally passed to .on() when attaching event handlers.
-     * @see {@link https://api.jquery.com/off/}
+     * @see \`{@link https://api.jquery.com/off/ }\`
      * @since 1.7
      */
     off(events: JQuery.PlainObject<JQuery.EventHandlerBase<any, JQuery.Event<TElement, any>> | false>, selector?: JQuery.Selector): this;
@@ -4472,7 +4472,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove an event handler.
      *
      * @param event A jQuery.Event object.
-     * @see {@link https://api.jquery.com/off/}
+     * @see \`{@link https://api.jquery.com/off/ }\`
      * @since 1.7
      */
     off(event?: JQuery.Event<TElement>): this;
@@ -4484,21 +4484,21 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                    A function to return the coordinates to set. Receives the index of the element in the collection as
      *                    the first argument and the current coordinates as the second argument. The function should return an
      *                    object with the new top and left properties.
-     * @see {@link https://api.jquery.com/offset/}
+     * @see \`{@link https://api.jquery.com/offset/ }\`
      * @since 1.4
      */
     offset(coordinates: JQuery.Coordinates | ((this: TElement, index: number, coords: JQuery.Coordinates) => JQuery.Coordinates)): this;
     /**
      * Get the current coordinates of the first element in the set of matched elements, relative to the document.
      *
-     * @see {@link https://api.jquery.com/offset/}
+     * @see \`{@link https://api.jquery.com/offset/ }\`
      * @since 1.2
      */
     offset(): JQuery.Coordinates | undefined;
     /**
      * Get the closest ancestor element that is positioned.
      *
-     * @see {@link https://api.jquery.com/offsetParent/}
+     * @see \`{@link https://api.jquery.com/offsetParent/ }\`
      * @since 1.2.6
      */
     offsetParent(): this;
@@ -4510,7 +4510,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: string,
@@ -4525,7 +4525,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: string,
@@ -4540,7 +4540,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param handler A function to execute when the event is triggered. The value false is also allowed as a shorthand
      *                for a function that simply does return false.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: string,
@@ -4553,7 +4553,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A selector string to filter the descendants of the selected elements that trigger the event. If the
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: string,
@@ -4565,7 +4565,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: string,
@@ -4577,7 +4577,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: string,
@@ -4589,7 +4589,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param handler A function to execute when the event is triggered. The value false is also allowed as a shorthand
      *                for a function that simply does return false.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: string,
@@ -4599,7 +4599,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: string,
@@ -4612,7 +4612,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A selector string to filter the descendants of the selected elements that will call the handler. If
      *                 the selector is null or omitted, the handler is always called when it reaches the selected element.
      * @param data Data to be passed to the handler in event.data when an event occurs.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: JQuery.PlainObject<JQuery.EventHandler<TElement, TData> | JQuery.EventHandlerBase<any, JQuery.Event<TElement, TData>> | false>,
@@ -4625,7 +4625,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *               namespaces, and the values represent a handler function to be called for the event(s).
      * @param selector A selector string to filter the descendants of the selected elements that will call the handler. If
      *                 the selector is null or omitted, the handler is always called when it reaches the selected element.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: JQuery.PlainObject<JQuery.EventHandler<TElement> | JQuery.EventHandlerBase<any, JQuery.Event<TElement>> | false>,
@@ -4636,7 +4636,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events An object in which the string keys represent one or more space-separated event types and optional
      *               namespaces, and the values represent a handler function to be called for the event(s).
      * @param data Data to be passed to the handler in event.data when an event occurs.
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on<TData>(events: JQuery.PlainObject<JQuery.EventHandler<TElement, TData> | JQuery.EventHandlerBase<any, JQuery.Event<TElement, TData>> | false>,
@@ -4646,7 +4646,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param events An object in which the string keys represent one or more space-separated event types and optional
      *               namespaces, and the values represent a handler function to be called for the event(s).
-     * @see {@link https://api.jquery.com/on/}
+     * @see \`{@link https://api.jquery.com/on/ }\`
      * @since 1.7
      */
     on(events: JQuery.PlainObject<JQuery.EventHandler<TElement> | JQuery.EventHandlerBase<any, JQuery.Event<TElement>> | false>): this;
@@ -4658,7 +4658,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one<TData>(events: string,
@@ -4673,7 +4673,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                 selector is null or omitted, the event is always triggered when it reaches the selected element.
      * @param handler A function to execute when the event is triggered. The value false is also allowed as a shorthand
      *                for a function that simply does return false.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one(events: string,
@@ -4685,7 +4685,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param data Data to be passed to the handler in event.data when an event is triggered.
      * @param handler A function to execute when the event is triggered.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one<TData>(events: string,
@@ -4697,7 +4697,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
      * @param handler A function to execute when the event is triggered. The value false is also allowed as a shorthand
      *                for a function that simply does return false.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one(events: string,
@@ -4710,7 +4710,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A selector string to filter the descendants of the selected elements that will call the handler. If
      *                 the selector is null or omitted, the handler is always called when it reaches the selected element.
      * @param data Data to be passed to the handler in event.data when an event occurs.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one<TData>(events: JQuery.PlainObject<JQuery.EventHandler<TElement, TData> | JQuery.EventHandlerBase<any, JQuery.Event<TElement, TData>> | false>,
@@ -4723,7 +4723,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *               namespaces, and the values represent a handler function to be called for the event(s).
      * @param selector A selector string to filter the descendants of the selected elements that will call the handler. If
      *                 the selector is null or omitted, the handler is always called when it reaches the selected element.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one(events: JQuery.PlainObject<JQuery.EventHandler<TElement> | JQuery.EventHandlerBase<any, JQuery.Event<TElement>> | false>,
@@ -4734,7 +4734,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param events An object in which the string keys represent one or more space-separated event types and optional
      *               namespaces, and the values represent a handler function to be called for the event(s).
      * @param data Data to be passed to the handler in event.data when an event occurs.
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one<TData>(events: JQuery.PlainObject<JQuery.EventHandler<TElement, TData> | JQuery.EventHandlerBase<any, JQuery.Event<TElement, TData>> | false>,
@@ -4744,7 +4744,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param events An object in which the string keys represent one or more space-separated event types and optional
      *               namespaces, and the values represent a handler function to be called for the event(s).
-     * @see {@link https://api.jquery.com/one/}
+     * @see \`{@link https://api.jquery.com/one/ }\`
      * @since 1.7
      */
     one(events: JQuery.PlainObject<JQuery.EventHandler<TElement> | JQuery.EventHandlerBase<any, JQuery.Event<TElement>> | false>): this;
@@ -4753,7 +4753,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param value A number representing the number of pixels, or a number along with an optional unit of measure
      *              appended (as a string).
-     * @see {@link https://api.jquery.com/outerHeight/}
+     * @see \`{@link https://api.jquery.com/outerHeight/ }\`
      * @since 1.8.0
      */
     outerHeight(value: string | number | ((this: TElement, index: number, height: number) => string | number)): this;
@@ -4762,7 +4762,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * first element in the set of matched elements.
      *
      * @param includeMargin A Boolean indicating whether to include the element's margin in the calculation.
-     * @see {@link https://api.jquery.com/outerHeight/}
+     * @see \`{@link https://api.jquery.com/outerHeight/ }\`
      * @since 1.2.6
      */
     outerHeight(includeMargin?: boolean): number | undefined;
@@ -4773,7 +4773,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              appended (as a string).
      *              A function returning the outer width to set. Receives the index position of the element in the set
      *              and the old outer width as arguments. Within the function, this refers to the current element in the set.
-     * @see {@link https://api.jquery.com/outerWidth/}
+     * @see \`{@link https://api.jquery.com/outerWidth/ }\`
      * @since 1.8.0
      */
     outerWidth(value: string | number | ((this: TElement, index: number, width: number) => string | number)): this;
@@ -4782,7 +4782,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * first element in the set of matched elements.
      *
      * @param includeMargin A Boolean indicating whether to include the element's margin in the calculation.
-     * @see {@link https://api.jquery.com/outerWidth/}
+     * @see \`{@link https://api.jquery.com/outerWidth/ }\`
      * @since 1.2.6
      */
     outerWidth(includeMargin?: boolean): number | undefined;
@@ -4790,7 +4790,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the parent of each element in the current set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/parent/}
+     * @see \`{@link https://api.jquery.com/parent/ }\`
      * @since 1.0
      */
     parent(selector?: JQuery.Selector): this;
@@ -4798,7 +4798,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the ancestors of each element in the current set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/parents/}
+     * @see \`{@link https://api.jquery.com/parents/ }\`
      * @since 1.0
      */
     parents(selector?: JQuery.Selector): this;
@@ -4809,7 +4809,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A string containing a selector expression to indicate where to stop matching ancestor elements.
      *                 A DOM node or jQuery object indicating where to stop matching ancestor elements.
      * @param filter A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/parentsUntil/}
+     * @see \`{@link https://api.jquery.com/parentsUntil/ }\`
      * @since 1.4
      * @since 1.6
      */
@@ -4817,7 +4817,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the current coordinates of the first element in the set of matched elements, relative to the offset parent.
      *
-     * @see {@link https://api.jquery.com/position/}
+     * @see \`{@link https://api.jquery.com/position/ }\`
      * @since 1.2
      */
     position(): JQuery.Coordinates;
@@ -4826,7 +4826,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param contents One or more additional DOM elements, text nodes, arrays of elements and text nodes, HTML strings, or
      *                 jQuery objects to insert at the beginning of each element in the set of matched elements.
-     * @see {@link https://api.jquery.com/prepend/}
+     * @see \`{@link https://api.jquery.com/prepend/ }\`
      * @since 1.0
      */
     prepend(...contents: Array<JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>>): this;
@@ -4837,7 +4837,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *           the beginning of each element in the set of matched elements. Receives the index position of the
      *           element in the set and the old HTML value of the element as arguments. Within the function, this
      *           refers to the current element in the set.
-     * @see {@link https://api.jquery.com/prepend/}
+     * @see \`{@link https://api.jquery.com/prepend/ }\`
      * @since 1.4
      */
     prepend(fn: (this: TElement, index: number, html: string) => JQuery.htmlString | JQuery.TypeOrArray<JQuery.Node | JQuery<JQuery.Node>>): this;
@@ -4846,7 +4846,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param target A selector, element, HTML string, array of elements, or jQuery object; the matched set of elements
      *               will be inserted at the beginning of the element(s) specified by this parameter.
-     * @see {@link https://api.jquery.com/prependTo/}
+     * @see \`{@link https://api.jquery.com/prependTo/ }\`
      * @since 1.0
      */
     prependTo(target: JQuery.Selector | JQuery.htmlString | JQuery.TypeOrArray<Element> | JQuery): this;
@@ -4855,7 +4855,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * is provided, it retrieves the previous sibling only if it matches that selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/prev/}
+     * @see \`{@link https://api.jquery.com/prev/ }\`
      * @since 1.0
      */
     prev(selector?: JQuery.Selector): this;
@@ -4863,7 +4863,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/prevAll/}
+     * @see \`{@link https://api.jquery.com/prevAll/ }\`
      * @since 1.2
      */
     prevAll(selector?: JQuery.Selector): this;
@@ -4874,7 +4874,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A string containing a selector expression to indicate where to stop matching preceding sibling elements.
      *                 A DOM node or jQuery object indicating where to stop matching preceding sibling elements.
      * @param filter A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/prevUntil/}
+     * @see \`{@link https://api.jquery.com/prevUntil/ }\`
      * @since 1.4
      * @since 1.6
      */
@@ -4885,7 +4885,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param type The type of queue that needs to be observed.
      * @param target Object onto which the promise methods have to be attached
-     * @see {@link https://api.jquery.com/promise/}
+     * @see \`{@link https://api.jquery.com/promise/ }\`
      * @since 1.6
      */
     promise<T extends object>(type: string, target: T): T & JQuery.Promise<this>;
@@ -4894,7 +4894,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * queued or not, have finished.
      *
      * @param target Object onto which the promise methods have to be attached
-     * @see {@link https://api.jquery.com/promise/}
+     * @see \`{@link https://api.jquery.com/promise/ }\`
      * @since 1.6
      */
     promise<T extends object>(target: T): T & JQuery.Promise<this>;
@@ -4903,7 +4903,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * queued or not, have finished.
      *
      * @param type The type of queue that needs to be observed.
-     * @see {@link https://api.jquery.com/promise/}
+     * @see \`{@link https://api.jquery.com/promise/ }\`
      * @since 1.6
      */
     promise(type?: string): JQuery.Promise<this>;
@@ -4913,7 +4913,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param propertyName The name of the property to set.
      * @param value A function returning the value to set. Receives the index position of the element in the set and the
      *              old property value as arguments. Within the function, the keyword this refers to the current element.
-     * @see {@link https://api.jquery.com/prop/}
+     * @see \`{@link https://api.jquery.com/prop/ }\`
      * @since 1.6
      */
     prop(propertyName: string, value: (this: TElement, index: number, oldPropertyValue: any) => any): this;
@@ -4922,7 +4922,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param propertyName The name of the property to set.
      * @param value A value to set for the property.
-     * @see {@link https://api.jquery.com/prop/}
+     * @see \`{@link https://api.jquery.com/prop/ }\`
      * @since 1.6
      */
     prop(propertyName: string, value: any): this; // tslint:disable-line:unified-signatures
@@ -4930,7 +4930,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Set one or more properties for the set of matched elements.
      *
      * @param properties An object of property-value pairs to set.
-     * @see {@link https://api.jquery.com/prop/}
+     * @see \`{@link https://api.jquery.com/prop/ }\`
      * @since 1.6
      */
     prop(properties: JQuery.PlainObject): this;
@@ -4938,7 +4938,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the value of a property for the first element in the set of matched elements.
      *
      * @param propertyName The name of the property to get.
-     * @see {@link https://api.jquery.com/prop/}
+     * @see \`{@link https://api.jquery.com/prop/ }\`
      * @since 1.6
      */
     prop(propertyName: string): any | undefined;
@@ -4948,7 +4948,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param elements An array of elements to push onto the stack and make into a new jQuery object.
      * @param name The name of a jQuery method that generated the array of elements.
      * @param args The arguments that were passed in to the jQuery method (for serialization).
-     * @see {@link https://api.jquery.com/pushStack/}
+     * @see \`{@link https://api.jquery.com/pushStack/ }\`
      * @since 1.3
      */
     pushStack(elements: ArrayLike<Element>, name: string, args: any[]): this;
@@ -4956,7 +4956,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Add a collection of DOM elements onto the jQuery stack.
      *
      * @param elements An array of elements to push onto the stack and make into a new jQuery object.
-     * @see {@link https://api.jquery.com/pushStack/}
+     * @see \`{@link https://api.jquery.com/pushStack/ }\`
      * @since 1.0
      */
     pushStack(elements: ArrayLike<Element>): this;
@@ -4966,7 +4966,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
      * @param newQueue The new function to add to the queue, with a function to call that will dequeue the next item.
      *                 An array of functions to replace the current queue contents.
-     * @see {@link https://api.jquery.com/queue/}
+     * @see \`{@link https://api.jquery.com/queue/ }\`
      * @since 1.2
      */
     queue(queueName: string, newQueue: JQuery.TypeOrArray<JQuery.QueueFunction<TElement>>): this;
@@ -4975,7 +4975,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param newQueue The new function to add to the queue, with a function to call that will dequeue the next item.
      *                 An array of functions to replace the current queue contents.
-     * @see {@link https://api.jquery.com/queue/}
+     * @see \`{@link https://api.jquery.com/queue/ }\`
      * @since 1.2
      */
     queue(newQueue: JQuery.TypeOrArray<JQuery.QueueFunction<TElement>>): this;
@@ -4983,7 +4983,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Show the queue of functions to be executed on the matched elements.
      *
      * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
-     * @see {@link https://api.jquery.com/queue/}
+     * @see \`{@link https://api.jquery.com/queue/ }\`
      * @since 1.2
      */
     queue(queueName?: string): JQuery.Queue<Node>;
@@ -4991,7 +4991,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Specify a function to execute when the DOM is fully loaded.
      *
      * @param handler A function to execute after the DOM is ready.
-     * @see {@link https://api.jquery.com/ready/}
+     * @see \`{@link https://api.jquery.com/ready/ }\`
      * @since 1.0
      * @deprecated 3.0
      */
@@ -5000,7 +5000,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove the set of matched elements from the DOM.
      *
      * @param selector A selector expression that filters the set of matched elements to be removed.
-     * @see {@link https://api.jquery.com/remove/}
+     * @see \`{@link https://api.jquery.com/remove/ }\`
      * @since 1.0
      */
     remove(selector?: string): this;
@@ -5008,7 +5008,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove an attribute from each element in the set of matched elements.
      *
      * @param attributeName An attribute to remove; as of version 1.7, it can be a space-separated list of attributes.
-     * @see {@link https://api.jquery.com/removeAttr/}
+     * @see \`{@link https://api.jquery.com/removeAttr/ }\`
      * @since 1.0
      */
     removeAttr(attributeName: string): this;
@@ -5019,7 +5019,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                  An array of classes to be removed from the class attribute of each matched element.
      *                  A function returning one or more space-separated class names to be removed. Receives the index
      *                  position of the element in the set and the old class value as arguments.
-     * @see {@link https://api.jquery.com/removeClass/}
+     * @see \`{@link https://api.jquery.com/removeClass/ }\`
      * @since 1.0
      * @since 1.4
      * @since 3.3
@@ -5030,7 +5030,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param name A string naming the piece of data to delete.
      *             An array or space-separated string naming the pieces of data to delete.
-     * @see {@link https://api.jquery.com/removeData/}
+     * @see \`{@link https://api.jquery.com/removeData/ }\`
      * @since 1.2.3
      * @since 1.7
      */
@@ -5039,7 +5039,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Remove a property for the set of matched elements.
      *
      * @param propertyName The name of the property to remove.
-     * @see {@link https://api.jquery.com/removeProp/}
+     * @see \`{@link https://api.jquery.com/removeProp/ }\`
      * @since 1.6
      */
     removeProp(propertyName: string): this;
@@ -5047,7 +5047,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Replace each target element with the set of matched elements.
      *
      * @param target A selector string, jQuery object, DOM element, or array of elements indicating which element(s) to replace.
-     * @see {@link https://api.jquery.com/replaceAll/}
+     * @see \`{@link https://api.jquery.com/replaceAll/ }\`
      * @since 1.2
      */
     replaceAll(target: JQuery.Selector | JQuery | JQuery.TypeOrArray<Element>): this;
@@ -5057,7 +5057,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param newContent The content to insert. May be an HTML string, DOM element, array of DOM elements, or jQuery object.
      *                   A function that returns content with which to replace the set of matched elements.
-     * @see {@link https://api.jquery.com/replaceWith/}
+     * @see \`{@link https://api.jquery.com/replaceWith/ }\`
      * @since 1.2
      * @since 1.4
      */
@@ -5067,7 +5067,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/resize/}
+     * @see \`{@link https://api.jquery.com/resize/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -5077,7 +5077,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/resize/}
+     * @see \`{@link https://api.jquery.com/resize/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -5087,7 +5087,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/scroll/}
+     * @see \`{@link https://api.jquery.com/scroll/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -5097,7 +5097,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/scroll/}
+     * @see \`{@link https://api.jquery.com/scroll/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -5106,14 +5106,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Set the current horizontal position of the scroll bar for each of the set of matched elements.
      *
      * @param value An integer indicating the new position to set the scroll bar to.
-     * @see {@link https://api.jquery.com/scrollLeft/}
+     * @see \`{@link https://api.jquery.com/scrollLeft/ }\`
      * @since 1.2.6
      */
     scrollLeft(value: number): this;
     /**
      * Get the current horizontal position of the scroll bar for the first element in the set of matched elements.
      *
-     * @see {@link https://api.jquery.com/scrollLeft/}
+     * @see \`{@link https://api.jquery.com/scrollLeft/ }\`
      * @since 1.2.6
      */
     scrollLeft(): number | undefined;
@@ -5121,7 +5121,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Set the current vertical position of the scroll bar for each of the set of matched elements.
      *
      * @param value A number indicating the new position to set the scroll bar to.
-     * @see {@link https://api.jquery.com/scrollTop/}
+     * @see \`{@link https://api.jquery.com/scrollTop/ }\`
      * @since 1.2.6
      */
     scrollTop(value: number): this;
@@ -5129,7 +5129,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the current vertical position of the scroll bar for the first element in the set of matched
      * elements or set the vertical position of the scroll bar for every matched element.
      *
-     * @see {@link https://api.jquery.com/scrollTop/}
+     * @see \`{@link https://api.jquery.com/scrollTop/ }\`
      * @since 1.2.6
      */
     scrollTop(): number | undefined;
@@ -5138,7 +5138,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/select/}
+     * @see \`{@link https://api.jquery.com/select/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -5148,7 +5148,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "select" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/select/}
+     * @see \`{@link https://api.jquery.com/select/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -5156,14 +5156,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Encode a set of form elements as a string for submission.
      *
-     * @see {@link https://api.jquery.com/serialize/}
+     * @see \`{@link https://api.jquery.com/serialize/ }\`
      * @since 1.0
      */
     serialize(): string;
     /**
      * Encode a set of form elements as an array of names and values.
      *
-     * @see {@link https://api.jquery.com/serializeArray/}
+     * @see \`{@link https://api.jquery.com/serializeArray/ }\`
      * @since 1.2
      */
     serializeArray(): JQuery.NameValuePair[];
@@ -5173,7 +5173,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/show/}
+     * @see \`{@link https://api.jquery.com/show/ }\`
      * @since 1.4.3
      */
     show(duration: JQuery.Duration, easing: string, complete: (this: TElement) => void): this;
@@ -5183,7 +5183,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing_complete A string indicating which easing function to use for the transition.
      *                        A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/show/}
+     * @see \`{@link https://api.jquery.com/show/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5194,7 +5194,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_complete_options A string or number determining how long the animation will run.
      *                                  A function to call once the animation is complete, called once per matched element.
      *                                  A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/show/}
+     * @see \`{@link https://api.jquery.com/show/ }\`
      * @since 1.0
      */
     show(duration_complete_options?: JQuery.Duration | ((this: TElement) => void) | JQuery.EffectsOptions<TElement>): this;
@@ -5202,7 +5202,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Get the siblings of each element in the set of matched elements, optionally filtered by a selector.
      *
      * @param selector A string containing a selector expression to match elements against.
-     * @see {@link https://api.jquery.com/siblings/}
+     * @see \`{@link https://api.jquery.com/siblings/ }\`
      * @since 1.0
      */
     siblings(selector?: JQuery.Selector): this;
@@ -5213,7 +5213,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              it indicates an offset from the end of the set.
      * @param end An integer indicating the 0-based position at which the elements stop being selected. If negative,
      *            it indicates an offset from the end of the set. If omitted, the range continues until the end of the set.
-     * @see {@link https://api.jquery.com/slice/}
+     * @see \`{@link https://api.jquery.com/slice/ }\`
      * @since 1.1.4
      */
     slice(start: number, end?: number): this;
@@ -5223,7 +5223,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideDown/}
+     * @see \`{@link https://api.jquery.com/slideDown/ }\`
      * @since 1.4.3
      */
     slideDown(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -5233,7 +5233,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideDown/}
+     * @see \`{@link https://api.jquery.com/slideDown/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5245,7 +5245,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/slideDown/}
+     * @see \`{@link https://api.jquery.com/slideDown/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5256,7 +5256,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideToggle/}
+     * @see \`{@link https://api.jquery.com/slideToggle/ }\`
      * @since 1.4.3
      */
     slideToggle(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -5266,7 +5266,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideToggle/}
+     * @see \`{@link https://api.jquery.com/slideToggle/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5278,7 +5278,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/slideToggle/}
+     * @see \`{@link https://api.jquery.com/slideToggle/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5289,7 +5289,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideUp/}
+     * @see \`{@link https://api.jquery.com/slideUp/ }\`
      * @since 1.4.3
      */
     slideUp(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -5299,7 +5299,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration_easing A string or number determining how long the animation will run.
      *                        A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/slideUp/}
+     * @see \`{@link https://api.jquery.com/slideUp/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5311,7 +5311,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                         A string indicating which easing function to use for the transition.
      *                                         A function to call once the animation is complete, called once per matched element.
      *                                         A map of additional options to pass to the method.
-     * @see {@link https://api.jquery.com/slideUp/}
+     * @see \`{@link https://api.jquery.com/slideUp/ }\`
      * @since 1.0
      * @since 1.4.3
      */
@@ -5322,7 +5322,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param queue The name of the queue in which to stop animations.
      * @param clearQueue A Boolean indicating whether to remove queued animation as well. Defaults to false.
      * @param jumpToEnd A Boolean indicating whether to complete the current animation immediately. Defaults to false.
-     * @see {@link https://api.jquery.com/stop/}
+     * @see \`{@link https://api.jquery.com/stop/ }\`
      * @since 1.7
      */
     stop(queue: string, clearQueue?: boolean, jumpToEnd?: boolean): this;
@@ -5331,7 +5331,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param clearQueue A Boolean indicating whether to remove queued animation as well. Defaults to false.
      * @param jumpToEnd A Boolean indicating whether to complete the current animation immediately. Defaults to false.
-     * @see {@link https://api.jquery.com/stop/}
+     * @see \`{@link https://api.jquery.com/stop/ }\`
      * @since 1.2
      */
     stop(clearQueue?: boolean, jumpToEnd?: boolean): this;
@@ -5340,7 +5340,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param eventData An object containing data that will be passed to the event handler.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/submit/}
+     * @see \`{@link https://api.jquery.com/submit/ }\`
      * @since 1.4.3
      * @deprecated 3.3
      */
@@ -5350,7 +5350,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * Bind an event handler to the "submit" JavaScript event, or trigger that event on an element.
      *
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/submit/}
+     * @see \`{@link https://api.jquery.com/submit/ }\`
      * @since 1.0
      * @deprecated 3.3
      */
@@ -5362,7 +5362,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *             be converted to a String representation.
      *             A function returning the text content to set. Receives the index position of the element in the set
      *             and the old text value as arguments.
-     * @see {@link https://api.jquery.com/text/}
+     * @see \`{@link https://api.jquery.com/text/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -5370,14 +5370,14 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the combined text contents of each element in the set of matched elements, including their descendants.
      *
-     * @see {@link https://api.jquery.com/text/}
+     * @see \`{@link https://api.jquery.com/text/ }\`
      * @since 1.0
      */
     text(): string;
     /**
      * Retrieve all the elements contained in the jQuery set, as an array.
      *
-     * @see {@link https://api.jquery.com/toArray/}
+     * @see \`{@link https://api.jquery.com/toArray/ }\`
      * @since 1.4
      */
     toArray(): TElement[];
@@ -5387,7 +5387,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param duration A string or number determining how long the animation will run.
      * @param easing A string indicating which easing function to use for the transition.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/toggle/}
+     * @see \`{@link https://api.jquery.com/toggle/ }\`
      * @since 1.4.3
      */
     toggle(duration: JQuery.Duration, easing: string, complete?: (this: TElement) => void): this;
@@ -5396,7 +5396,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param duration A string or number determining how long the animation will run.
      * @param complete A function to call once the animation is complete, called once per matched element.
-     * @see {@link https://api.jquery.com/toggle/}
+     * @see \`{@link https://api.jquery.com/toggle/ }\`
      * @since 1.0
      */
     toggle(duration: JQuery.Duration, complete: (this: TElement) => void): this;
@@ -5407,7 +5407,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                                          A function to call once the animation is complete, called once per matched element.
      *                                          A map of additional options to pass to the method.
      *                                          Use true to show the element or false to hide it.
-     * @see {@link https://api.jquery.com/toggle/}
+     * @see \`{@link https://api.jquery.com/toggle/ }\`
      * @since 1.0
      * @since 1.3
      */
@@ -5421,7 +5421,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                  A function that returns class names to be toggled in the class attribute of each element in the
      *                  matched set. Receives the index position of the element in the set, the old class value, and the state as arguments.
      * @param state A Boolean (not just truthy/falsy) value to determine whether the class should be added or removed.
-     * @see {@link https://api.jquery.com/toggleClass/}
+     * @see \`{@link https://api.jquery.com/toggleClass/ }\`
      * @since 1.0
      * @since 1.3
      * @since 1.4
@@ -5434,7 +5434,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * either the class's presence or the value of the state argument.
      *
      * @param state A boolean value to determine whether the class should be added or removed.
-     * @see {@link https://api.jquery.com/toggleClass/}
+     * @see \`{@link https://api.jquery.com/toggleClass/ }\`
      * @since 1.4
      * @deprecated 3.0
      */
@@ -5445,7 +5445,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param eventType A string containing a JavaScript event type, such as click or submit.
      *                  A jQuery.Event object.
      * @param extraParameters Additional parameters to pass along to the event handler.
-     * @see {@link https://api.jquery.com/trigger/}
+     * @see \`{@link https://api.jquery.com/trigger/ }\`
      * @since 1.0
      * @since 1.3
      */
@@ -5456,7 +5456,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param eventType A string containing a JavaScript event type, such as click or submit.
      *                  A jQuery.Event object.
      * @param extraParameters Additional parameters to pass along to the event handler.
-     * @see {@link https://api.jquery.com/triggerHandler/}
+     * @see \`{@link https://api.jquery.com/triggerHandler/ }\`
      * @since 1.2
      * @since 1.3
      */
@@ -5466,7 +5466,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param event A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/unbind/}
+     * @see \`{@link https://api.jquery.com/unbind/ }\`
      * @since 1.0
      * @since 1.4.3
      * @deprecated 3.0
@@ -5477,7 +5477,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param event A string containing one or more DOM event types, such as "click" or "submit," or custom event names.
      *              A jQuery.Event object.
-     * @see {@link https://api.jquery.com/unbind/}
+     * @see \`{@link https://api.jquery.com/unbind/ }\`
      * @since 1.0
      * @deprecated 3.0
      */
@@ -5489,7 +5489,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A selector which will be used to filter the event results.
      * @param eventType A string containing a JavaScript event type, such as "click" or "keydown"
      * @param handler A function to execute each time the event is triggered.
-     * @see {@link https://api.jquery.com/undelegate/}
+     * @see \`{@link https://api.jquery.com/undelegate/ }\`
      * @since 1.4.2
      * @deprecated 3.0
      */
@@ -5501,7 +5501,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @param selector A selector which will be used to filter the event results.
      * @param eventTypes A string containing a JavaScript event type, such as "click" or "keydown"
      *                   An object of one or more event types and previously bound functions to unbind from them.
-     * @see {@link https://api.jquery.com/undelegate/}
+     * @see \`{@link https://api.jquery.com/undelegate/ }\`
      * @since 1.4.2
      * @since 1.4.3
      * @deprecated 3.0
@@ -5512,7 +5512,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * specific set of root elements.
      *
      * @param namespace A selector which will be used to filter the event results.
-     * @see {@link https://api.jquery.com/undelegate/}
+     * @see \`{@link https://api.jquery.com/undelegate/ }\`
      * @since 1.4.2
      * @since 1.6
      * @deprecated 3.0
@@ -5523,7 +5523,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *
      * @param selector A selector to check the parent element against. If an element's parent does not match the selector,
      *                 the element won't be unwrapped.
-     * @see {@link https://api.jquery.com/unwrap/}
+     * @see \`{@link https://api.jquery.com/unwrap/ }\`
      * @since 1.4
      * @since 3.0
      */
@@ -5535,7 +5535,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              element to set as selected/checked.
      *              A function returning the value to set. this is the current element. Receives the index position of
      *              the element in the set and the old value as arguments.
-     * @see {@link https://api.jquery.com/val/}
+     * @see \`{@link https://api.jquery.com/val/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -5543,7 +5543,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the current value of the first element in the set of matched elements.
      *
-     * @see {@link https://api.jquery.com/val/}
+     * @see \`{@link https://api.jquery.com/val/ }\`
      * @since 1.0
      */
     val(): string | number | string[] | undefined;
@@ -5554,7 +5554,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *              appended (as a string).
      *              A function returning the width to set. Receives the index position of the element in the set and the
      *              old width as arguments. Within the function, this refers to the current element in the set.
-     * @see {@link https://api.jquery.com/width/}
+     * @see \`{@link https://api.jquery.com/width/ }\`
      * @since 1.0
      * @since 1.4.1
      */
@@ -5562,7 +5562,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
     /**
      * Get the current computed width for the first element in the set of matched elements.
      *
-     * @see {@link https://api.jquery.com/width/}
+     * @see \`{@link https://api.jquery.com/width/ }\`
      * @since 1.0
      */
     width(): number | undefined;
@@ -5575,7 +5575,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                        A callback function returning the HTML content or jQuery object to wrap around the matched elements.
      *                        Receives the index position of the element in the set as an argument. Within the function, this
      *                        refers to the current element in the set.
-     * @see {@link https://api.jquery.com/wrap/}
+     * @see \`{@link https://api.jquery.com/wrap/ }\`
      * @since 1.0
      * @since 1.4
      */
@@ -5588,7 +5588,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                        elements. Within the function, this refers to the first element in the set. Prior to jQuery 3.0, the
      *                        callback was incorrectly called for every element in the set and received the index position of the
      *                        element in the set as an argument.
-     * @see {@link https://api.jquery.com/wrapAll/}
+     * @see \`{@link https://api.jquery.com/wrapAll/ }\`
      * @since 1.2
      * @since 1.4
      */
@@ -5601,7 +5601,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      *                        A callback function which generates a structure to wrap around the content of the matched elements.
      *                        Receives the index position of the element in the set as an argument. Within the function, this
      *                        refers to the current element in the set.
-     * @see {@link https://api.jquery.com/wrapInner/}
+     * @see \`{@link https://api.jquery.com/wrapInner/ }\`
      * @since 1.2
      * @since 1.4
      */
@@ -5691,7 +5691,7 @@ declare namespace JQuery {
         }
 
         /**
-         * @see {@link http://api.jquery.com/jquery.ajax/#jQuery-ajax-settings}
+         * @see \`{@link http://api.jquery.com/jquery.ajax/#jQuery-ajax-settings }\`
          */
         interface AjaxSettingsBase<TContext> {
             /**
@@ -6378,7 +6378,7 @@ declare namespace JQuery {
     }
 
     /**
-     * @see {@link http://api.jquery.com/jquery.ajax/#jqXHR}
+     * @see \`{@link http://api.jquery.com/jquery.ajax/#jqXHR }\`
      */
     interface jqXHR<TResolve = any> extends Promise3<TResolve, jqXHR<TResolve>, never,
         Ajax.SuccessTextStatus, Ajax.ErrorTextStatus, never,
@@ -6391,7 +6391,7 @@ declare namespace JQuery {
         /**
          * Determine the current state of a Deferred object.
          *
-         * @see {@link https://api.jquery.com/deferred.state/}
+         * @see \`{@link https://api.jquery.com/deferred.state/ }\`
          * @since 1.7
          */
         state(): 'pending' | 'resolved' | 'rejected';
@@ -6425,28 +6425,28 @@ declare namespace JQuery {
          *
          * @param callback A function, or array of functions, that are to be added to the callback list.
          * @param callbacks A function, or array of functions, that are to be added to the callback list.
-         * @see {@link https://api.jquery.com/callbacks.add/}
+         * @see \`{@link https://api.jquery.com/callbacks.add/ }\`
          * @since 1.7
          */
         add(callback: TypeOrArray<T>, ...callbacks: Array<TypeOrArray<T>>): this;
         /**
          * Disable a callback list from doing anything more.
          *
-         * @see {@link https://api.jquery.com/callbacks.disable/}
+         * @see \`{@link https://api.jquery.com/callbacks.disable/ }\`
          * @since 1.7
          */
         disable(): this;
         /**
          * Determine if the callbacks list has been disabled.
          *
-         * @see {@link https://api.jquery.com/callbacks.disabled/}
+         * @see \`{@link https://api.jquery.com/callbacks.disabled/ }\`
          * @since 1.7
          */
         disabled(): boolean;
         /**
          * Remove all of the callbacks from a list.
          *
-         * @see {@link https://api.jquery.com/callbacks.empty/}
+         * @see \`{@link https://api.jquery.com/callbacks.empty/ }\`
          * @since 1.7
          */
         empty(): this;
@@ -6454,7 +6454,7 @@ declare namespace JQuery {
          * Call all of the callbacks with the given arguments.
          *
          * @param args The argument or list of arguments to pass back to the callback list.
-         * @see {@link https://api.jquery.com/callbacks.fire/}
+         * @see \`{@link https://api.jquery.com/callbacks.fire/ }\`
          * @since 1.7
          */
         fire(...args: any[]): this;
@@ -6463,14 +6463,14 @@ declare namespace JQuery {
          *
          * @param context A reference to the context in which the callbacks in the list should be fired.
          * @param args An argument, or array of arguments, to pass to the callbacks in the list.
-         * @see {@link https://api.jquery.com/callbacks.fireWith/}
+         * @see \`{@link https://api.jquery.com/callbacks.fireWith/ }\`
          * @since 1.7
          */
         fireWith(context: object, args?: ArrayLike<any>): this;
         /**
          * Determine if the callbacks have already been called at least once.
          *
-         * @see {@link https://api.jquery.com/callbacks.fired/}
+         * @see \`{@link https://api.jquery.com/callbacks.fired/ }\`
          * @since 1.7
          */
         fired(): boolean;
@@ -6479,21 +6479,21 @@ declare namespace JQuery {
          * argument, determine whether it is in a list.
          *
          * @param callback The callback to search for.
-         * @see {@link https://api.jquery.com/callbacks.has/}
+         * @see \`{@link https://api.jquery.com/callbacks.has/ }\`
          * @since 1.7
          */
         has(callback?: T): boolean;
         /**
          * Lock a callback list in its current state.
          *
-         * @see {@link https://api.jquery.com/callbacks.lock/}
+         * @see \`{@link https://api.jquery.com/callbacks.lock/ }\`
          * @since 1.7
          */
         lock(): this;
         /**
          * Determine if the callbacks list has been locked.
          *
-         * @see {@link https://api.jquery.com/callbacks.locked/}
+         * @see \`{@link https://api.jquery.com/callbacks.locked/ }\`
          * @since 1.7
          */
         locked(): boolean;
@@ -6501,7 +6501,7 @@ declare namespace JQuery {
          * Remove a callback or a collection of callbacks from a callback list.
          *
          * @param callbacks A function, or array of functions, that are to be removed from the callback list.
-         * @see {@link https://api.jquery.com/callbacks.remove/}
+         * @see \`{@link https://api.jquery.com/callbacks.remove/ }\`
          * @since 1.7
          */
         remove(...callbacks: T[]): this;
@@ -6544,7 +6544,7 @@ declare namespace JQuery {
      * This object provides a subset of the methods of the Deferred object (then, done, fail, always,
      * pipe, progress, state and promise) to prevent users from changing the state of the Deferred.
      *
-     * @see {@link http://api.jquery.com/Types/#Promise}
+     * @see \`{@link http://api.jquery.com/Types/#Promise }\`
      * @deprecated Experimental. Avoid referncing this type directly in your code.
      */
     interface PromiseBase<TR, TJ, TN,
@@ -6556,7 +6556,7 @@ declare namespace JQuery {
          *
          * @param alwaysCallback A function, or array of functions, that is called when the Deferred is resolved or rejected.
          * @param alwaysCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is resolved or rejected.
-         * @see {@link https://api.jquery.com/deferred.always/}
+         * @see \`{@link https://api.jquery.com/deferred.always/ }\`
          * @since 1.6
          */
         always(alwaysCallback: TypeOrArray<Deferred.CallbackBase<TR | TJ, UR | UJ, VR | VJ, SR | SJ>>,
@@ -6566,7 +6566,7 @@ declare namespace JQuery {
          *
          * @param doneCallback A function, or array of functions, that are called when the Deferred is resolved.
          * @param doneCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is resolved.
-         * @see {@link https://api.jquery.com/deferred.done/}
+         * @see \`{@link https://api.jquery.com/deferred.done/ }\`
          * @since 1.5
          */
         done(doneCallback: TypeOrArray<Deferred.CallbackBase<TR, UR, VR, SR>>,
@@ -6576,7 +6576,7 @@ declare namespace JQuery {
          *
          * @param failCallback A function, or array of functions, that are called when the Deferred is rejected.
          * @param failCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is rejected.
-         * @see {@link https://api.jquery.com/deferred.fail/}
+         * @see \`{@link https://api.jquery.com/deferred.fail/ }\`
          * @since 1.5
          */
         fail(failCallback: TypeOrArray<Deferred.CallbackBase<TJ, UJ, VJ, SJ>>,
@@ -6587,7 +6587,7 @@ declare namespace JQuery {
          * @param progressCallback A function, or array of functions, to be called when the Deferred generates progress notifications.
          * @param progressCallbacks Optional additional functions, or arrays of functions, to be called when the Deferred generates
          *                          progress notifications.
-         * @see {@link https://api.jquery.com/deferred.progress/}
+         * @see \`{@link https://api.jquery.com/deferred.progress/ }\`
          * @since 1.7
          */
         progress(progressCallback: TypeOrArray<Deferred.CallbackBase<TN, UN, VN, SN>>,
@@ -6596,21 +6596,21 @@ declare namespace JQuery {
          * Return a Deferred's Promise object.
          *
          * @param target Object onto which the promise methods have to be attached
-         * @see {@link https://api.jquery.com/deferred.promise/}
+         * @see \`{@link https://api.jquery.com/deferred.promise/ }\`
          * @since 1.5
          */
         promise<TTarget extends object>(target: TTarget): this & TTarget;
         /**
          * Return a Deferred's Promise object.
          *
-         * @see {@link https://api.jquery.com/deferred.promise/}
+         * @see \`{@link https://api.jquery.com/deferred.promise/ }\`
          * @since 1.5
          */
         promise(): this;
         /**
          * Determine the current state of a Deferred object.
          *
-         * @see {@link https://api.jquery.com/deferred.state/}
+         * @see \`{@link https://api.jquery.com/deferred.state/ }\`
          * @since 1.7
          */
         state(): 'pending' | 'resolved' | 'rejected';
@@ -6623,7 +6623,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6661,7 +6661,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6692,7 +6692,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6723,7 +6723,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6747,7 +6747,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6778,7 +6778,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6802,7 +6802,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -6831,7 +6831,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -6867,7 +6867,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARF = never, AJF = never, ANF = never,
@@ -6896,7 +6896,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -6925,7 +6925,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARP = never, AJP = never, ANP = never,
@@ -6947,7 +6947,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -6976,7 +6976,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARF = never, AJF = never, ANF = never,
@@ -6998,7 +6998,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -7021,7 +7021,7 @@ declare namespace JQuery {
          * Add handlers to be called when the Deferred object is rejected.
          *
          * @param failFilter A function that is called when the Deferred is rejected.
-         * @see {@link https://api.jquery.com/deferred.catch/}
+         * @see \`{@link https://api.jquery.com/deferred.catch/ }\`
          * @since 3.0
          */
         catch<ARF = never, AJF = never, ANF = never,
@@ -7041,7 +7041,7 @@ declare namespace JQuery {
      * This object provides a subset of the methods of the Deferred object (then, done, fail, always,
      * pipe, progress, state and promise) to prevent users from changing the state of the Deferred.
      *
-     * @see {@link http://api.jquery.com/Types/#Promise}
+     * @see \`{@link http://api.jquery.com/Types/#Promise }\`
      */
     interface Promise3<TR, TJ, TN,
         UR, UJ, UN,
@@ -7054,7 +7054,7 @@ declare namespace JQuery {
      * This object provides a subset of the methods of the Deferred object (then, done, fail, always,
      * pipe, progress, state and promise) to prevent users from changing the state of the Deferred.
      *
-     * @see {@link http://api.jquery.com/Types/#Promise}
+     * @see \`{@link http://api.jquery.com/Types/#Promise }\`
      */
     interface Promise2<TR, TJ, TN,
         UR, UJ, UN> extends PromiseBase<TR, TJ, TN,
@@ -7066,7 +7066,7 @@ declare namespace JQuery {
      * This object provides a subset of the methods of the Deferred object (then, done, fail, always,
      * pipe, progress, state and promise) to prevent users from changing the state of the Deferred.
      *
-     * @see {@link http://api.jquery.com/Types/#Promise}
+     * @see \`{@link http://api.jquery.com/Types/#Promise }\`
      */
     interface Promise<TR, TJ = any, TN = any> extends PromiseBase<TR, TJ, TN,
         TR, TJ, TN,
@@ -7084,7 +7084,7 @@ declare namespace JQuery {
          * Call the progressCallbacks on a Deferred object with the given args.
          *
          * @param args Optional arguments that are passed to the progressCallbacks.
-         * @see {@link https://api.jquery.com/deferred.notify/}
+         * @see \`{@link https://api.jquery.com/deferred.notify/ }\`
          * @since 1.7
          */
         notify(...args: TN[]): this;
@@ -7093,7 +7093,7 @@ declare namespace JQuery {
          *
          * @param context Context passed to the progressCallbacks as the this object.
          * @param args An optional array of arguments that are passed to the progressCallbacks.
-         * @see {@link https://api.jquery.com/deferred.notifyWith/}
+         * @see \`{@link https://api.jquery.com/deferred.notifyWith/ }\`
          * @since 1.7
          */
         notifyWith(context: object, args?: ArrayLike<TN>): this;
@@ -7101,7 +7101,7 @@ declare namespace JQuery {
          * Reject a Deferred object and call any failCallbacks with the given args.
          *
          * @param args Optional arguments that are passed to the failCallbacks.
-         * @see {@link https://api.jquery.com/deferred.reject/}
+         * @see \`{@link https://api.jquery.com/deferred.reject/ }\`
          * @since 1.5
          */
         reject(...args: TJ[]): this;
@@ -7110,7 +7110,7 @@ declare namespace JQuery {
          *
          * @param context Context passed to the failCallbacks as the this object.
          * @param args An optional array of arguments that are passed to the failCallbacks.
-         * @see {@link https://api.jquery.com/deferred.rejectWith/}
+         * @see \`{@link https://api.jquery.com/deferred.rejectWith/ }\`
          * @since 1.5
          */
         rejectWith(context: object, args?: ArrayLike<TJ>): this;
@@ -7118,7 +7118,7 @@ declare namespace JQuery {
          * Resolve a Deferred object and call any doneCallbacks with the given args.
          *
          * @param args Optional arguments that are passed to the doneCallbacks.
-         * @see {@link https://api.jquery.com/deferred.resolve/}
+         * @see \`{@link https://api.jquery.com/deferred.resolve/ }\`
          * @since 1.5
          */
         resolve(...args: TR[]): this;
@@ -7127,7 +7127,7 @@ declare namespace JQuery {
          *
          * @param context Context passed to the doneCallbacks as the this object.
          * @param args An optional array of arguments that are passed to the doneCallbacks.
-         * @see {@link https://api.jquery.com/deferred.resolveWith/}
+         * @see \`{@link https://api.jquery.com/deferred.resolveWith/ }\`
          * @since 1.5
          */
         resolveWith(context: object, args?: ArrayLike<TR>): this;
@@ -7137,7 +7137,7 @@ declare namespace JQuery {
          *
          * @param alwaysCallback A function, or array of functions, that is called when the Deferred is resolved or rejected.
          * @param alwaysCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is resolved or rejected.
-         * @see {@link https://api.jquery.com/deferred.always/}
+         * @see \`{@link https://api.jquery.com/deferred.always/ }\`
          * @since 1.6
          */
         always(alwaysCallback: TypeOrArray<Deferred.Callback<TR | TJ>>,
@@ -7147,7 +7147,7 @@ declare namespace JQuery {
          *
          * @param doneCallback A function, or array of functions, that are called when the Deferred is resolved.
          * @param doneCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is resolved.
-         * @see {@link https://api.jquery.com/deferred.done/}
+         * @see \`{@link https://api.jquery.com/deferred.done/ }\`
          * @since 1.5
          */
         done(doneCallback: TypeOrArray<Deferred.Callback<TR>>,
@@ -7157,7 +7157,7 @@ declare namespace JQuery {
          *
          * @param failCallback A function, or array of functions, that are called when the Deferred is rejected.
          * @param failCallbacks Optional additional functions, or arrays of functions, that are called when the Deferred is rejected.
-         * @see {@link https://api.jquery.com/deferred.fail/}
+         * @see \`{@link https://api.jquery.com/deferred.fail/ }\`
          * @since 1.5
          */
         fail(failCallback: TypeOrArray<Deferred.Callback<TJ>>,
@@ -7168,7 +7168,7 @@ declare namespace JQuery {
          * @param progressCallback A function, or array of functions, to be called when the Deferred generates progress notifications.
          * @param progressCallbacks Optional additional functions, or arrays of functions, to be called when the Deferred generates
          *                          progress notifications.
-         * @see {@link https://api.jquery.com/deferred.progress/}
+         * @see \`{@link https://api.jquery.com/deferred.progress/ }\`
          * @since 1.7
          */
         progress(progressCallback: TypeOrArray<Deferred.Callback<TN>>,
@@ -7177,21 +7177,21 @@ declare namespace JQuery {
          * Return a Deferred's Promise object.
          *
          * @param target Object onto which the promise methods have to be attached
-         * @see {@link https://api.jquery.com/deferred.promise/}
+         * @see \`{@link https://api.jquery.com/deferred.promise/ }\`
          * @since 1.5
          */
         promise<TTarget extends object>(target: TTarget): JQuery.Promise<TR, TJ, TN> & TTarget;
         /**
          * Return a Deferred's Promise object.
          *
-         * @see {@link https://api.jquery.com/deferred.promise/}
+         * @see \`{@link https://api.jquery.com/deferred.promise/ }\`
          * @since 1.5
          */
         promise(): JQuery.Promise<TR, TJ, TN>;
         /**
          * Determine the current state of a Deferred object.
          *
-         * @see {@link https://api.jquery.com/deferred.state/}
+         * @see \`{@link https://api.jquery.com/deferred.state/ }\`
          * @since 1.7
          */
         state(): 'pending' | 'resolved' | 'rejected';
@@ -7204,7 +7204,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7242,7 +7242,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7273,7 +7273,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7304,7 +7304,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7328,7 +7328,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7359,7 +7359,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7383,7 +7383,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.pipe/}
+         * @see \`{@link https://api.jquery.com/deferred.pipe/ }\`
          * @since 1.6
          * @since 1.7
          * @deprecated 1.8
@@ -7412,7 +7412,7 @@ declare namespace JQuery {
          * @param doneFilter A function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -7448,7 +7448,7 @@ declare namespace JQuery {
          * @param doneFilter A function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARF = never, AJF = never, ANF = never,
@@ -7477,7 +7477,7 @@ declare namespace JQuery {
          * @param doneFilter A function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -7506,7 +7506,7 @@ declare namespace JQuery {
          * @param doneFilter A function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARP = never, AJP = never, ANP = never,
@@ -7528,7 +7528,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -7557,7 +7557,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARF = never, AJF = never, ANF = never,
@@ -7579,7 +7579,7 @@ declare namespace JQuery {
          * @param doneFilter An optional function that is called when the Deferred is resolved.
          * @param failFilter An optional function that is called when the Deferred is rejected.
          * @param progressFilter An optional function that is called when progress notifications are sent to the Deferred.
-         * @see {@link https://api.jquery.com/deferred.then/}
+         * @see \`{@link https://api.jquery.com/deferred.then/ }\`
          * @since 1.8
          */
         then<ARD = never, AJD = never, AND = never,
@@ -7602,7 +7602,7 @@ declare namespace JQuery {
          * Add handlers to be called when the Deferred object is rejected.
          *
          * @param failFilter A function that is called when the Deferred is rejected.
-         * @see {@link https://api.jquery.com/deferred.catch/}
+         * @see \`{@link https://api.jquery.com/deferred.catch/ }\`
          * @since 3.0
          */
         catch<ARF = never, AJF = never, ANF = never,
@@ -7663,7 +7663,7 @@ declare namespace JQuery {
     }
 
     /**
-     * @see {@link https://api.jquery.com/animate/#animate-properties-options}
+     * @see \`{@link https://api.jquery.com/animate/#animate-properties-options }\`
      */
     interface EffectsOptions<TElement> {
         /**
@@ -7775,98 +7775,98 @@ declare namespace JQuery {
         /**
          * Indicates whether the META key was pressed when the event fired.
          *
-         * @see {@link https://api.jquery.com/event.metaKey/}
+         * @see \`{@link https://api.jquery.com/event.metaKey/ }\`
          * @since 1.0.4
          */
         metaKey: boolean;
         /**
          * The namespace specified when the event was triggered.
          *
-         * @see {@link https://api.jquery.com/event.namespace/}
+         * @see \`{@link https://api.jquery.com/event.namespace/ }\`
          * @since 1.4.3
          */
         namespace: string;
         /**
          * The mouse position relative to the left edge of the document.
          *
-         * @see {@link https://api.jquery.com/event.pageX/}
+         * @see \`{@link https://api.jquery.com/event.pageX/ }\`
          * @since 1.0.4
          */
         pageX: number;
         /**
          * The mouse position relative to the top edge of the document.
          *
-         * @see {@link https://api.jquery.com/event.pageY/}
+         * @see \`{@link https://api.jquery.com/event.pageY/ }\`
          * @since 1.0.4
          */
         pageY: number;
         /**
          * The last value returned by an event handler that was triggered by this event, unless the value was undefined.
          *
-         * @see {@link https://api.jquery.com/event.result/}
+         * @see \`{@link https://api.jquery.com/event.result/ }\`
          * @since 1.3
          */
         result: any;
         /**
          * The difference in milliseconds between the time the browser created the event and January 1, 1970.
          *
-         * @see {@link https://api.jquery.com/event.timeStamp/}
+         * @see \`{@link https://api.jquery.com/event.timeStamp/ }\`
          * @since 1.2.6
          */
         timeStamp: number;
         /**
          * Describes the nature of the event.
          *
-         * @see {@link https://api.jquery.com/event.type/}
+         * @see \`{@link https://api.jquery.com/event.type/ }\`
          * @since 1.0
          */
         type: string;
         /**
          * For key or mouse events, this property indicates the specific key or button that was pressed.
          *
-         * @see {@link https://api.jquery.com/event.which/}
+         * @see \`{@link https://api.jquery.com/event.which/ }\`
          * @since 1.1.3
          */
         which: number;
         /**
          * Returns whether event.preventDefault() was ever called on this event object.
          *
-         * @see {@link https://api.jquery.com/event.isDefaultPrevented/}
+         * @see \`{@link https://api.jquery.com/event.isDefaultPrevented/ }\`
          * @since 1.3
          */
         isDefaultPrevented(): boolean;
         /**
          * Returns whether event.stopImmediatePropagation() was ever called on this event object.
          *
-         * @see {@link https://api.jquery.com/event.isImmediatePropagationStopped/}
+         * @see \`{@link https://api.jquery.com/event.isImmediatePropagationStopped/ }\`
          * @since 1.3
          */
         isImmediatePropagationStopped(): boolean;
         /**
          * Returns whether event.stopPropagation() was ever called on this event object.
          *
-         * @see {@link https://api.jquery.com/event.isPropagationStopped/}
+         * @see \`{@link https://api.jquery.com/event.isPropagationStopped/ }\`
          * @since 1.3
          */
         isPropagationStopped(): boolean;
         /**
          * If this method is called, the default action of the event will not be triggered.
          *
-         * @see {@link https://api.jquery.com/event.preventDefault/}
+         * @see \`{@link https://api.jquery.com/event.preventDefault/ }\`
          * @since 1.0
          */
         preventDefault(): void;
         /**
          * Keeps the rest of the handlers from being executed and prevents the event from bubbling up the DOM tree.
          *
-         * @see {@link https://api.jquery.com/event.stopImmediatePropagation/}
+         * @see \`{@link https://api.jquery.com/event.stopImmediatePropagation/ }\`
          * @since 1.3
          */
         stopImmediatePropagation(): void;
         /**
          * Prevents the event from bubbling up the DOM tree, preventing any parent handlers from being notified of the event.
          *
-         * @see {@link https://api.jquery.com/event.stopPropagation/}
+         * @see \`{@link https://api.jquery.com/event.stopPropagation/ }\`
          * @since 1.0
          */
         stopPropagation(): void;
@@ -7881,21 +7881,21 @@ declare namespace JQuery {
         /**
          * The current DOM element within the event bubbling phase.
          *
-         * @see {@link https://api.jquery.com/event.currentTarget/}
+         * @see \`{@link https://api.jquery.com/event.currentTarget/ }\`
          * @since 1.3
          */
         currentTarget: TTarget;
         /**
          * An optional object of data passed to an event method when the current executing handler is bound.
          *
-         * @see {@link https://api.jquery.com/event.data/}
+         * @see \`{@link https://api.jquery.com/event.data/ }\`
          * @since 1.1
          */
         data: TData;
         /**
          * The element where the currently-called jQuery event handler was attached.
          *
-         * @see {@link https://api.jquery.com/event.delegateTarget/}
+         * @see \`{@link https://api.jquery.com/event.delegateTarget/ }\`
          * @since 1.7
          */
         delegateTarget: TTarget;
@@ -7903,14 +7903,14 @@ declare namespace JQuery {
         /**
          * The other DOM element involved in the event, if any.
          *
-         * @see {@link https://api.jquery.com/event.relatedTarget/}
+         * @see \`{@link https://api.jquery.com/event.relatedTarget/ }\`
          * @since 1.1.4
          */
         relatedTarget: TTarget | null;
         /**
          * The DOM element that initiated the event.
          *
-         * @see {@link https://api.jquery.com/event.target/}
+         * @see \`{@link https://api.jquery.com/event.target/ }\`
          * @since 1.0
          */
         target: TTarget;
@@ -8117,92 +8117,92 @@ interface JQueryParam {
 interface BaseJQueryEventObject extends Event {
     /**
      * The current DOM element within the event bubbling phase.
-     * @see {@link https://api.jquery.com/event.currentTarget/}
+     * @see \`{@link https://api.jquery.com/event.currentTarget/ }\`
      */
     currentTarget: Element;
     /**
      * An optional object of data passed to an event method when the current executing handler is bound.
-     * @see {@link https://api.jquery.com/event.data/}
+     * @see \`{@link https://api.jquery.com/event.data/ }\`
      */
     data: any;
     /**
      * The element where the currently-called jQuery event handler was attached.
-     * @see {@link https://api.jquery.com/event.delegateTarget/}
+     * @see \`{@link https://api.jquery.com/event.delegateTarget/ }\`
      */
     delegateTarget: Element;
     /**
      * Returns whether event.preventDefault() was ever called on this event object.
-     * @see {@link https://api.jquery.com/event.isDefaultPrevented/}
+     * @see \`{@link https://api.jquery.com/event.isDefaultPrevented/ }\`
      */
     isDefaultPrevented(): boolean;
     /**
      * Returns whether event.stopImmediatePropagation() was ever called on this event object.
-     * @see {@link https://api.jquery.com/event.isImmediatePropagationStopped/}
+     * @see \`{@link https://api.jquery.com/event.isImmediatePropagationStopped/ }\`
      */
     isImmediatePropagationStopped(): boolean;
     /**
      * Returns whether event.stopPropagation() was ever called on this event object.
-     * @see {@link https://api.jquery.com/event.isPropagationStopped/}
+     * @see \`{@link https://api.jquery.com/event.isPropagationStopped/ }\`
      */
     isPropagationStopped(): boolean;
     /**
      * The namespace specified when the event was triggered.
-     * @see {@link https://api.jquery.com/event.namespace/}
+     * @see \`{@link https://api.jquery.com/event.namespace/ }\`
      */
     namespace: string;
     /**
      * The browser's original Event object.
-     * @see {@link https://api.jquery.com/category/events/event-object/}
+     * @see \`{@link https://api.jquery.com/category/events/event-object/ }\`
      */
     originalEvent: Event;
     /**
      * If this method is called, the default action of the event will not be triggered.
-     * @see {@link https://api.jquery.com/event.preventDefault/}
+     * @see \`{@link https://api.jquery.com/event.preventDefault/ }\`
      */
     preventDefault(): any;
     /**
      * The other DOM element involved in the event, if any.
-     * @see {@link https://api.jquery.com/event.relatedTarget/}
+     * @see \`{@link https://api.jquery.com/event.relatedTarget/ }\`
      */
     relatedTarget: Element;
     /**
      * The last value returned by an event handler that was triggered by this event, unless the value was undefined.
-     * @see {@link https://api.jquery.com/event.result/}
+     * @see \`{@link https://api.jquery.com/event.result/ }\`
      */
     result: any;
     /**
      * Keeps the rest of the handlers from being executed and prevents the event from bubbling up the DOM tree.
-     * @see {@link https://api.jquery.com/event.stopImmediatePropagation/}
+     * @see \`{@link https://api.jquery.com/event.stopImmediatePropagation/ }\`
      */
     stopImmediatePropagation(): void;
     /**
      * Prevents the event from bubbling up the DOM tree, preventing any parent handlers from being notified of the event.
-     * @see {@link https://api.jquery.com/event.stopPropagation/}
+     * @see \`{@link https://api.jquery.com/event.stopPropagation/ }\`
      */
     stopPropagation(): void;
     /**
      * The DOM element that initiated the event.
-     * @see {@link https://api.jquery.com/event.target/}
+     * @see \`{@link https://api.jquery.com/event.target/ }\`
      */
     target: Element;
     /**
      * The mouse position relative to the left edge of the document.
-     * @see {@link https://api.jquery.com/event.pageX/}
+     * @see \`{@link https://api.jquery.com/event.pageX/ }\`
      */
     pageX: number;
     /**
      * The mouse position relative to the top edge of the document.
-     * @see {@link https://api.jquery.com/event.pageY/}
+     * @see \`{@link https://api.jquery.com/event.pageY/ }\`
      */
     pageY: number;
     /**
      * For key or mouse events, this property indicates the specific key or button that was pressed.
-     * @see {@link https://api.jquery.com/event.which/}
+     * @see \`{@link https://api.jquery.com/event.which/ }\`
      */
     which: number;
     /**
      * Indicates whether the META key was pressed when the event fired.
-     * @see {@link https://api.jquery.com/event.metaKey/}
+     * @see \`{@link https://api.jquery.com/event.metaKey/ }\`
      */
     metaKey: boolean;
 }
diff --git a/types/jquery/tslint.json b/types/jquery/tslint.json
index deae83dc66..d1d7bd0a0a 100644
--- a/types/jquery/tslint.json
+++ b/types/jquery/tslint.json
@@ -14,6 +14,7 @@
         "no-empty-interface": false,
         "no-misused-new": false,
         "no-object-literal-type-assertion": false,
+        "no-redundant-jsdoc-2": false,
         "no-unnecessary-generics": false,
         "no-unnecessary-qualifier": false,
         "no-unnecessary-type-assertion": false,

From c82573119ec7d527ea1494d4c4a6e3ceabc9c687 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 12:38:39 -0700
Subject: [PATCH 071/180] Reverting type names and adding descriptions

---
 types/office-js/index.d.ts | 78 +++++++++++++-------------------------
 1 file changed, 26 insertions(+), 52 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index c7b7f59d5e..dfa8960afc 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -6436,19 +6436,15 @@ declare namespace Office {
     interface Appointment extends Item {
     }
     /**
-     * The compose mode of {@link Office.Appointment}.
+     * The appointment organizer mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
-    interface AppointmentOrganizer extends Appointment, ItemCompose {
+    interface AppointmentCompose extends Appointment, ItemCompose {
         /**
          * Gets or sets the date and time that the appointment is to end.
          *
-         * The end property is expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the end property value to the client's local date and time.
-         *
-         * *Compose mode*
-         *
-         * The end property returns a Time object.
+         * The end property is an {@link Office.Time} object expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the end property value to the client's local date and time.
          *
          * When you use the Time.setAsync method to set the end time, you should use the convertToUtcClientTime method to convert the local time on the client to UTC for the server.
          *
@@ -6462,11 +6458,7 @@ declare namespace Office {
          */
         end: Time;
         /**
-         * Gets or sets the location of an appointment.
-         *
-         * *Compose mode*
-         *
-         * The location property returns a Location object that provides methods that are used to get and set the location of the appointment.
+         * Gets or sets the {@link Office.Location} of an appointment. The location property returns a Location object that provides methods that are used to get and set the location of the appointment.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6478,11 +6470,7 @@ declare namespace Office {
          */
         location: Location;
         /**
-         * Provides access to the optional attendees of an event. The type of object and level of access depends on the mode of the current item.
-         *
-         * *Compose mode*
-         *
-         * The optionalAttendees property returns a Recipients object that provides methods to get or update the optional attendees for a meeting.
+         * Provides access to the optional attendees of an event. The type of object and level of access depends on the mode of the current item. The optionalAttendees property returns an {@link Office.Recipients} object that provides methods to get or update the optional attendees for a meeting.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6494,11 +6482,7 @@ declare namespace Office {
          */
         optionalAttendees: Recipients;
         /**
-         * Provides access to the required attendees of an event. The type of object and level of access depends on the mode of the current item.
-         *
-         * *Compose mode*
-         *
-         * The requiredAttendees property returns a Recipients object that provides methods to get or update the required attendees for a meeting.
+         * Provides access to the required attendees of an event. The type of object and level of access depends on the mode of the current item. The requiredAttendees property returns an {@link Office.Recipients} object that provides methods to get or update the required attendees for a meeting.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6512,11 +6496,7 @@ declare namespace Office {
         /**
          * Gets or sets the date and time that the appointment is to begin.
          *
-         * The start property is expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the value to the client's local date and time.
-         *
-         * *Compose mode*
-         *
-         * The start property returns a Time object.
+         * The start property is an {@link Office.Time} object expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the value to the client's local date and time.
          *
          * When you use the Time.setAsync method to set the start time, you should use the convertToUtcClientTime method to convert the local time on the client to UTC for the server.
          *
@@ -6531,17 +6511,15 @@ declare namespace Office {
         start: Time;
     }
     /**
-     * The read mode of {@link Office.Appointment}.
+     * The appointment attendee mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
-    interface AppointmentAttendee extends Appointment, ItemRead {
+    interface AppointmentRead extends Appointment, ItemRead {
         /**
          * Gets the date and time that the appointment is to end.
          *
-         * The end property is expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the end property value to the client's local date and time.
-         *
-         * The end property returns a Date object.
+         * The end property is a Date object expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the end property value to the client's local date and time.
          *
          * When you use the Time.setAsync method to set the end time, you should use the convertToUtcClientTime method to convert the local time on the client to UTC for the server.
          *
@@ -6571,7 +6549,7 @@ declare namespace Office {
         /**
          * Provides access to the optional attendees of an event. The type of object and level of access depends on the mode of the current item.
          *
-         * The optionalAttendees property returns an array that contains an EmailAddressDetails object for each optional attendee to the meeting.
+         * The optionalAttendees property returns an array that contains an {@link Office.EmailAddressDetails} object for each optional attendee to the meeting.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6597,7 +6575,7 @@ declare namespace Office {
         /**
          * Provides access to the required attendees of an event. The type of object and level of access depends on the mode of the current item.
          *
-         * The requiredAttendees property returns an array that contains an EmailAddressDetails object for each required attendee to the meeting.
+         * The requiredAttendees property returns an array that contains an {@link Office.EmailAddressDetails} object for each required attendee to the meeting.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6611,9 +6589,7 @@ declare namespace Office {
         /**
          * Gets the date and time that the appointment is to begin.
          *
-         * The start property is expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the value to the client's local date and time.
-         *
-         * The start property returns a Date object.
+         * The start property is a Date object expressed as a Coordinated Universal Time (UTC) date and time value. You can use the convertToLocalClientTime method to convert the value to the client's local date and time.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -6772,7 +6748,7 @@ declare namespace Office {
     }
 
     /**
-     * The item namespace is used to access the currently selected message, meeting request, or appointment. You can determine the type of the item by using the itemType property.
+     * The item namespace is used to access the currently selected message, meeting request, or appointment. You can determine the type of the item by using the `itemType` property.
      *
      * [Api set: Mailbox 1.0]
      *
@@ -6986,9 +6962,9 @@ declare namespace Office {
        removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
     }
     /**
-     * The compose mode of {@link Office.Item}.
+     * The compose mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
     interface ItemCompose extends Item {
         /**
@@ -7582,9 +7558,9 @@ declare namespace Office {
         setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
     }
     /**
-     * The read mode of {@link Office.Appointment}.
+     * The read mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
     interface ItemRead extends Item {
         /**
@@ -7919,9 +7895,9 @@ declare namespace Office {
     }
 
      /**
-     * The compose mode of {@link Office.Message}.
+     * The message compose mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
     interface MessageCompose extends Message, ItemCompose {
         /**
@@ -7939,9 +7915,7 @@ declare namespace Office {
         /**
          * Provides access to the Cc (carbon copy) recipients of a message. The type of object and level of access depends on the mode of the current item.
          *
-         * *Compose mode*
-         *
-         * The cc property returns a Recipients object that provides methods to get or update the recipients on the Cc line of the message.
+         * The cc property returns a {@link Office.Recipients} object that provides methods to get or update the recipients on the Cc line of the message.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -7984,7 +7958,7 @@ declare namespace Office {
         to: Recipients;
     }
     /**
-     * The read mode of {@link Office.Message}. 
+     * The message read mode of {@link Office.Item | Office.context.mailbox.item}.
      * 
      * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
      */
@@ -8292,9 +8266,9 @@ declare namespace Office {
         /**
          * The mailbox item.  Depending on the context in which the add-in opened, the item may be of any number of types.
          * If you want to see IntelliSense for only a specific type, you should cast this item to one of the following:
-         * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentOrganizer`, `AppointmentAttendee`
+         * `ItemCompose`, `ItemRead`, `MessageCompose`, `MessageRead`, `AppointmentCompose`, `AppointmentRead`
          */
-        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentAttendee & AppointmentOrganizer;
+        item: Item & ItemCompose & ItemRead & MessageRead & MessageCompose & AppointmentRead & AppointmentCompose;
         /**
          * Gets the URL of the REST endpoint for this email account.
          *

From 9affff8f0f323e5ad925aef86ffa94fbcb5c3eda Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 13:32:02 -0700
Subject: [PATCH 072/180] Appointment doc changes

---
 types/office-js/index.d.ts | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index dfa8960afc..1c0b9a714c 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -7564,7 +7564,7 @@ declare namespace Office {
      */
     interface ItemRead extends Item {
         /**
-         * Gets an array of attachments for the item. Read mode only.
+         * Gets an array of attachments for the item.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -7579,7 +7579,7 @@ declare namespace Office {
          */
         attachments: AttachmentDetails[];
         /**
-         * Gets the Exchange Web Services item class of the selected item. Read mode only.
+         * Gets the Exchange Web Services item class of the selected item.
          *
          * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
          *
@@ -7600,7 +7600,7 @@ declare namespace Office {
          */
         itemClass: string;
         /**
-         * Gets the Exchange Web Services item identifier for the current item. Read mode only.
+         * Gets the Exchange Web Services item identifier for the current item.
          *
          * The itemId property is not available in compose mode. If an item identifier is required, the saveAsync method can be used to save the item to the store, which will return the item identifier in the AsyncResult.value parameter in the callback function.
          *
@@ -7616,7 +7616,7 @@ declare namespace Office {
          */
         itemId: string;
         /**
-         * Gets the subject of an item, with all prefixes removed (including RE: and FWD:). Read mode only.
+         * Gets the subject of an item, with all prefixes removed (including RE: and FWD:).
          *
          * The normalizedSubject property gets the subject of the item, with any standard prefixes (such as RE: and FW:) that are added by email programs. To get the subject of the item with the prefixes intact, use the subject property.
          *
@@ -7665,7 +7665,7 @@ declare namespace Office {
          *
          * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
          *  OR
-         * A {@link Office.ReplyFormData} object that contains body or attachment data and a callback function
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function
          */
         displayReplyAllForm(formData: string | ReplyFormData): void;
         /**
@@ -7689,7 +7689,7 @@ declare namespace Office {
          *
          * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB.
          * OR
-         * A {@link Office.ReplyFormData} object that contains body or attachment data and a callback function.
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function.
          */
         displayReplyForm(formData: string | ReplyFormData): void;
         /**
@@ -7873,7 +7873,7 @@ declare namespace Office {
     /**
      * A subclass of {@link Office.Item} for messages.
      * 
-     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. Refer to the Object Model pages for more information.
+     * Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of **Office.context.mailbox.item**. Refer to the Object Model pages for more information.
      */
     interface Message extends Item {
         /**
@@ -7901,7 +7901,7 @@ declare namespace Office {
      */
     interface MessageCompose extends Message, ItemCompose {
         /**
-         * Gets an object that provides methods to get or update the recipients on the Bcc (blind carbon copy) line of a message. Compose mode only.
+         * Gets an object that provides methods to get or update the recipients on the Bcc (blind carbon copy) line of a message.
          *
          * [Api set: Mailbox 1.1]
          *
@@ -7996,7 +7996,7 @@ declare namespace Office {
          */
         from: EmailAddressDetails;
         /**
-         * Gets the Internet message identifier for an email message. Read mode only.
+         * Gets the Internet message identifier for an email message.
          *
          * [Api set: Mailbox 1.0]
          *
@@ -8008,7 +8008,7 @@ declare namespace Office {
          */
         internetMessageId: string;
         /**
-         * Gets the email address of the sender of an email message. Read mode only.
+         * Gets the email address of the sender of an email message.
          *
          * The from and sender properties represent the same person unless the message is sent by a delegate. In that case, the from property represents the delegator, and the sender property represents the delegate.
          *

From e8e1e9536bef611d5d0f8078ac10ada86fe6770f Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 14:34:10 -0700
Subject: [PATCH 073/180] Adjusting Outlook mode descriptions

---
 types/office-js/index.d.ts | 2654 +++++++++++++++++++++++++++++++++++-
 1 file changed, 2634 insertions(+), 20 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 1c0b9a714c..6867a8956d 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -6454,7 +6454,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Organizer
          */
         end: Time;
         /**
@@ -6466,7 +6466,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Organizer
          */
         location: Location;
         /**
@@ -6478,7 +6478,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Organizer
          */
         optionalAttendees: Recipients;
         /**
@@ -6490,7 +6490,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Organizer
          */
         requiredAttendees: Recipients;
         /**
@@ -6506,9 +6506,804 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Organizer
          */
         start: Time;
+
+        // Repeated Item fields //
+
+         /**
+         * Gets an object that provides methods for manipulating the body of an item.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        body: Body;
+        /**
+         * Gets the date and time that an item was created.  Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        dateTimeCreated: Date;
+        /**
+         * Gets the date and time that an item was last modified. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: This member is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        dateTimeModifed: Date;
+        /**
+         * Gets the type of item that an instance represents.
+         *
+         * The itemType property returns one of the ItemType enumeration values, indicating whether the item object instance is a message or an appointment.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        itemType: Office.MailboxEnums.ItemType;
+        /**
+         * Gets the notification messages for an item.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        notificationMessages: NotificationMessages;
+
+        /**
+         * Gets or sets the recurrence pattern of an appointment.
+         * 
+         * The recurrence property returns a recurrence object for recurring appointments or meetings requests if an item is a series or an instance in a series. null is returned for single appointments and meeting requests of single appointments.
+         * 
+         * Note: Meeting requests have an itemClass value of IPM.Schedule.Meeting.Request.
+         * 
+         * Note: If the recurrence object is null, this indicates that the object is a single appointment or a meeting request of a single appointment and NOT a part of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        recurrence: Recurrence;
+
+        /**
+         * Gets the id of the series that an instance belongs to.
+         * 
+         * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
+         * 
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
+         * 
+         * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        seriesId: string;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Asynchronously loads custom properties for this add-in on the selected item.
+        *
+        * Custom properties are stored as key/value pairs on a per-app, per-item basis. This method returns a CustomProperties object in the callback, which provides methods to access the custom properties specific to the current item and the current add-in. Custom properties are not encrypted on the item, so this should not be used as secure storage.
+        *
+        * The custom properties are provided as a CustomProperties object in the asyncResult.value property. This object can be used to get, set, and remove custom properties from the item and save changes to the custom property set back to the server.
+        *
+        * [Api set: Mailbox 1.0]
+        *
+        * @remarks
+        *
+        * Minimum permission level: ReadItem
+        *
+        * Applicable Outlook mode: Appointment Organizer
+        *
+        * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+        * @param userContext Optional. Developers can provide any object they wish to access in the callback function. This object can be accessed by the asyncResult.asyncContext property in the callback function.
+        */
+       loadCustomPropertiesAsync(callback: (result: AsyncResult) => void, userContext?: any): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+         * Gets or sets the description that appears in the subject field of an item.
+         *
+         * The subject property gets or sets the entire subject of the item, as sent by the email server.
+         *
+         * The subject property returns a Subject object that provides methods to get and set the subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        subject: Subject;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        inInline: If true, indicates that the attachment will be shown inline in the message body, and should not be displayed in the attachment list.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type asyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If uploading the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        inInline: If true, indicates that the attachment will be shown inline in the message body, and should not be displayed in the attachment list.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, options: AsyncContextOptions): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type asyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If uploading the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If adding the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, options: AsyncContextOptions): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If adding the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Closes the current item that is being composed
+         *
+         * The behaviors of the close method depends on the current state of the item being composed. If the item has unsaved changes, the client prompts the user to save, discard, or close the action.
+         *
+         * In the Outlook desktop client, if the message is an inline reply, the close method has no effect.
+         *
+         * Note: In Outlook on the web, if the item is an appointment and it has previously been saved using saveAsync, the user is prompted to save, discard, or cancel even if no changes have occurred since the item was last saved.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: Restricted
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         */
+        close(): void;
+        /**
+         * Gets initialization data passed when the add-in is activated by an actionable message.
+         *
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously returns selected data from the subject or body of a message.
+         *
+         * If there is no selection but the cursor is in the body or subject, the method returns null for the selected data. If a field other than the body or subject is selected, the method returns the InvalidSelection error.
+         *
+         * To access the selected data from the callback method, call asyncResult.value.data. To access the source property that the selection comes from, call asyncResult.value.sourceProperty, which will be either body or subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * The selected data as a string with format determined by coercionType.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * @param coercionType Requests a format for the data. If Text, the method returns the plain text as a string , removing any HTML tags present. If HTML, the method returns the selected text, whether it is plaintext or HTML.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+         */
+        getSelectedDataAsync(coercionType: CoercionType, callback: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously returns selected data from the subject or body of a message.
+         *
+         * If there is no selection but the cursor is in the body or subject, the method returns null for the selected data. If a field other than the body or subject is selected, the method returns the InvalidSelection error.
+         *
+         * To access the selected data from the callback method, call asyncResult.value.data. To access the source property that the selection comes from, call asyncResult.value.sourceProperty, which will be either body or subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * The selected data as a string with format determined by coercionType.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * @param coercionType Requests a format for the data. If Text, the method returns the plain text as a string , removing any HTML tags present. If HTML, the method returns the selected text, whether it is plaintext or HTML.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+         */
+        getSelectedDataAsync(coercionType: CoercionType, options: AsyncContextOptions, callback: (result: AsyncResult) => void): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        removeAttachmentAsync(attachmentIndex: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         */
+        removeAttachmentAsync(attachmentIndex: string): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        removeAttachmentAsync(attachmentIndex: string, options: AsyncContextOptions): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        removeAttachmentAsync(attachmentIndex: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        saveAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         */
+        saveAsync(): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        saveAsync(options: AsyncContextOptions): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        saveAsync(callback: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        coercionType: If text, the current style is applied in Outlook Web App and Outlook. If the field is an HTML editor, only the text data is inserted, even if the data is HTML. If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook Web App and the default style is applied in Outlook. If the field is a text field, an InvalidDataFormat error is returned. If coercionType is not set, the result depends on the field: if the field is HTML then HTML is used; if the field is text, then plain text is used.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        setSelectedDataAsync(data: string, options?: AsyncContextOptions & CoercionTypeOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         */
+        setSelectedDataAsync(data: string): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        coercionType: If text, the current style is applied in Outlook Web App and Outlook. If the field is an HTML editor, only the text data is inserted, even if the data is HTML. If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook Web App and the default style is applied in Outlook. If the field is a text field, an InvalidDataFormat error is returned. If coercionType is not set, the result depends on the field: if the field is HTML then HTML is used; if the field is text, then plain text is used.
+         */
+        setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Appointment Organizer
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
     }
     /**
      * The appointment attendee mode of {@link Office.Item | Office.context.mailbox.item}.
@@ -6529,7 +7324,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Attendee
          */
         end: Date;
         /**
@@ -6543,7 +7338,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Attendee
          */
         location: string;
         /**
@@ -6557,7 +7352,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Attendee
          */
         optionalAttendees: EmailAddressDetails[];
         /**
@@ -6569,7 +7364,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Read
+         * Applicable Outlook mode: Appointment Attendee
          */
         organizer: EmailAddressDetails;
         /**
@@ -6583,7 +7378,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Attendee
          */
         requiredAttendees: EmailAddressDetails[];
         /**
@@ -6597,9 +7392,521 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Appointment Attendee
          */
         start: Date;
+
+        // Repeated Item Fields //
+
+         /**
+         * Gets an object that provides methods for manipulating the body of an item.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        body: Body;
+        /**
+         * Gets the date and time that an item was created. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        dateTimeCreated: Date;
+        /**
+         * Gets the date and time that an item was last modified. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: This member is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        dateTimeModifed: Date;
+        /**
+         * Gets the type of item that an instance represents.
+         *
+         * The itemType property returns one of the ItemType enumeration values, indicating whether the item object instance is a message or an appointment.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        itemType: Office.MailboxEnums.ItemType;
+        /**
+         * Gets the notification messages for an item.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        notificationMessages: NotificationMessages;
+
+        /**
+         * Gets the recurrence pattern of an appointment. Gets the recurrence pattern of a meeting request.
+         * 
+         * The recurrence property returns a recurrence object for recurring appointments or meetings requests if an item is a series or an instance in a series. null is returned for single appointments and meeting requests of single appointments.
+         * 
+         * Note: Meeting requests have an itemClass value of IPM.Schedule.Meeting.Request.
+         * 
+         * Note: If the recurrence object is null, this indicates that the object is a single appointment or a meeting request of a single appointment and NOT a part of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        recurrence: Recurrence;
+
+        /**
+         * Gets the id of the series that an instance belongs to.
+         * 
+         * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
+         * 
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
+         * 
+         * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        seriesId: string;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Asynchronously loads custom properties for this add-in on the selected item.
+        *
+        * Custom properties are stored as key/value pairs on a per-app, per-item basis. This method returns a CustomProperties object in the callback, which provides methods to access the custom properties specific to the current item and the current add-in. Custom properties are not encrypted on the item, so this should not be used as secure storage.
+        *
+        * The custom properties are provided as a CustomProperties object in the asyncResult.value property. This object can be used to get, set, and remove custom properties from the item and save changes to the custom property set back to the server.
+        *
+        * [Api set: Mailbox 1.0]
+        *
+        * @remarks
+        *
+        * Minimum permission level: ReadItem
+        *
+        * Applicable Outlook mode: Appointment Attendee
+        *
+        * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+        * @param userContext Optional. Developers can provide any object they wish to access in the callback function. This object can be accessed by the asyncResult.asyncContext property in the callback function.
+        */
+       loadCustomPropertiesAsync(callback: (result: AsyncResult) => void, userContext?: any): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Gets an array of attachments for the item.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         */
+        attachments: AttachmentDetails[];
+        /**
+         * Gets the Exchange Web Services item class of the selected item.
+         *
+         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
+         *
+         * [div class="mx-tdBreakAll"|Type|Description|item class|
+         * |-----------|------------|------------|
+         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
+         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
+         *
+         * You can create custom message classes that extends a default message class, for example, a custom appointment message class IPM.Appointment.Contoso.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        itemClass: string;
+        /**
+         * Gets the Exchange Web Services item identifier for the current item.
+         *
+         * The itemId property is not available in compose mode. If an item identifier is required, the saveAsync method can be used to save the item to the store, which will return the item identifier in the AsyncResult.value parameter in the callback function.
+         *
+         * Note: The identifier returned by the itemId property is the same as the Exchange Web Services item identifier. The itemId property is not identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see Use the Outlook REST APIs from an Outlook add-in.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        itemId: string;
+        /**
+         * Gets the subject of an item, with all prefixes removed (including RE: and FWD:).
+         *
+         * The normalizedSubject property gets the subject of the item, with any standard prefixes (such as RE: and FW:) that are added by email programs. To get the subject of the item with the prefixes intact, use the subject property.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        normalizedSubject: string;
+        /**
+         * Gets the description that appears in the subject field of an item.
+         *
+         * The subject property gets or sets the entire subject of the item, as sent by the email server.
+         *
+         * The subject property returns a string. Use the normalizedSubject property to get the subject minus any leading prefixes such as RE: and FW:.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        subject: string;
+        /**
+         * Displays a reply form that includes the sender and all recipients of the selected message or the organizer and all attendees of the selected appointment.
+         *
+         * In Outlook Web App, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2- or 1-column view.
+         *
+         * If any of the string parameters exceed their limits, displayReplyAllForm throws an exception.
+         *
+         * When attachments are specified in the formData.attachments parameter, Outlook and Outlook Web App attempt to download all attachments and attach them to the reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
+         *  OR
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function
+         */
+        displayReplyAllForm(formData: string | ReplyFormData): void;
+        /**
+         * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
+         *
+         * In Outlook Web App, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2- or 1-column view.
+         *
+         * If any of the string parameters exceed their limits, displayReplyForm throws an exception.
+         *
+         * When attachments are specified in the formData.attachments parameter, Outlook and Outlook Web App attempt to download all attachments and attach them to the reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB.
+         * OR
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function.
+         */
+        displayReplyForm(formData: string | ReplyFormData): void;
+        /**
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * 
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * 
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(callback?: (result: AsyncResult) => void): void;
+        /**
+         * Gets the entities found in the selected item.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        getEntities(): Entities;
+        /**
+         * Gets an array of all the entities of the specified entity type found in the selected item.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * If the value passed in entityType is not a valid member of the EntityType enumeration, the method returns null. If no entities of the specified type are present on the item, the method returns an empty array. Otherwise, the type of the objects in the returned array depends on the type of entity requested in the entityType parameter.
+         *
+         * While the minimum permission level to use this method is Restricted, some entity types require ReadItem to access, as specified in the following table.
+         * |Value of entityType|Type of objects in returned array|Required Permission Level|
+         * |-------|-----------|----------|
+         * |Address|String|Restricted|
+         * |Contact|Contact|ReadItem|
+         * |EmailAddress|String|ReadItem|
+         * |MeetingSuggestion|MeetingSuggestion|ReadItem|
+         * |PhoneNumber|PhoneNumber|Restricted|
+         * |TaskSuggestion|TaskSuggestion|ReadItem|
+         * |URL|String|Restricted|
+         *
+         * @remarks
+         * Minimum permission level: Restricted
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param entityType One of the EntityType enumeration values.
+         */
+        getEntitiesByType(entityType: Office.MailboxEnums.EntityType): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
+        /**
+         * Returns well-known entities in the selected item that pass the named filter defined in the manifest XML file.
+         *
+         * The getFilteredEntitiesByName method returns the entities that match the regular expression defined in the ItemHasKnownEntity rule element in the manifest XML file with the specified FilterName element value.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param name The name of the ItemHasKnownEntity rule element that defines the filter to match.
+         * @returns If there is no ItemHasKnownEntity element in the manifest with a FilterName element value that matches the name parameter, the method returns null. If the name parameter does match an ItemHasKnownEntity element in the manifest, but there are no entities in the current item that match, the method return an empty array.
+         */
+        getFilteredEntitiesByName(name: string): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
+        /**
+         * Returns string values in the selected item that match the regular expressions defined in the manifest XML file.
+         *
+         * The getRegExMatches method returns the strings that match the regular expression defined in each ItemHasRegularExpressionMatch or ItemHasKnownEntity rule element in the manifest XML file. For an ItemHasRegularExpressionMatch rule, a matching string has to occur in the property of the item that is specified by that rule. The PropertyName simple type defines the supported properties.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results. Instead, use the Body.getAsync method to retrieve the entire body.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file. The name of each array is equal to the corresponding value of the RegExName attribute of the matching ItemHasRegularExpressionMatch rule or the FilterName attribute of the matching ItemHasKnownEntity rule.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        getRegExMatches(): any;
+        /**
+         * Returns string values in the selected item that match the named regular expression defined in the manifest XML file.
+         *
+         * The getRegExMatchesByName method returns the strings that match the regular expression defined in the ItemHasRegularExpressionMatch rule element in the manifest XML file with the specified RegExName element value.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * An array that contains the strings that match the regular expression defined in the manifest XML file.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param name The name of the ItemHasRegularExpressionMatch rule element that defines the filter to match.
+         */
+        getRegExMatchesByName(name: string): string[];
+        /**
+         * Gets the entities found in a highlighted match a user has selected. Highlighted matches apply to contextual add-ins.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.6]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         *
+         * @param name The name of the ItemHasRegularExpressionMatch rule element that defines the filter to match.
+         */
+        getSelectedEntities(): Entities;
+        /**
+         * Returns string values in a highlighted match that match the regular expressions defined in the manifest XML file. Highlighted matches apply to contextual add-ins.
+         *
+         * The getSelectedRegExMatches method returns the strings that match the regular expression defined in each ItemHasRegularExpressionMatch or ItemHasKnownEntity rule element in the manifest XML file. For an ItemHasRegularExpressionMatch rule, a matching string has to occur in the property of the item that is specified by that rule. The PropertyName simple type defines the supported properties.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results. Instead, use the Body.getAsync method to retrieve the entire body.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.6]
+         *
+         * @returns
+         * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file. The name of each array is equal to the corresponding value of the RegExName attribute of the matching ItemHasRegularExpressionMatch rule or the FilterName attribute of the matching ItemHasKnownEntity rule.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         */
+        getSelectedRegExMatches(): any;
     }
 
     interface AppointmentForm {
@@ -7909,7 +9216,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose
+         * Applicable Outlook mode: Message Compose
          */
         bcc: Recipients;
         /**
@@ -7923,7 +9230,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Message Compose
          */
         cc: Recipients;
         /**
@@ -7939,7 +9246,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Read
+         * Applicable Outlook mode: Message Compose
          */
         from: From;
         /**
@@ -7953,9 +9260,804 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Message Compose
          */
         to: Recipients;
+
+        // Repeated Item Fields //
+
+        /**
+         * Gets an object that provides methods for manipulating the body of an item.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        body: Body;
+        /**
+         * Gets the date and time that an item was created. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        dateTimeCreated: Date;
+        /**
+         * Gets the date and time that an item was last modified. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: This member is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        dateTimeModifed: Date;
+        /**
+         * Gets the type of item that an instance represents.
+         *
+         * The itemType property returns one of the ItemType enumeration values, indicating whether the item object instance is a message or an appointment.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        itemType: Office.MailboxEnums.ItemType;
+        /**
+         * Gets the notification messages for an item.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        notificationMessages: NotificationMessages;
+
+        /**
+         * Gets or sets the recurrence pattern of an appointment. Gets the recurrence pattern of a meeting request. Read and compose modes for appointment items. Read mode for meeting request items.
+         * 
+         * The recurrence property returns a recurrence object for recurring appointments or meetings requests if an item is a series or an instance in a series. null is returned for single appointments and meeting requests of single appointments. undefined is returned for messages that are not meeting requests.
+         * 
+         * Note: Meeting requests have an itemClass value of IPM.Schedule.Meeting.Request.
+         * 
+         * Note: If the recurrence object is null, this indicates that the object is a single appointment or a meeting request of a single appointment and NOT a part of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Message Compose
+         */
+        recurrence: Recurrence;
+
+        /**
+         * Gets the id of the series that an instance belongs to.
+         * 
+         * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
+         * 
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
+         * 
+         * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Message Compose
+         */
+        seriesId: string;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Asynchronously loads custom properties for this add-in on the selected item.
+        *
+        * Custom properties are stored as key/value pairs on a per-app, per-item basis. This method returns a CustomProperties object in the callback, which provides methods to access the custom properties specific to the current item and the current add-in. Custom properties are not encrypted on the item, so this should not be used as secure storage.
+        *
+        * The custom properties are provided as a CustomProperties object in the asyncResult.value property. This object can be used to get, set, and remove custom properties from the item and save changes to the custom property set back to the server.
+        *
+        * [Api set: Mailbox 1.0]
+        *
+        * @remarks
+        *
+        * Minimum permission level: ReadItem
+        *
+        * Applicable Outlook mode: Message Compose
+        *
+        * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+        * @param userContext Optional. Developers can provide any object they wish to access in the callback function. This object can be accessed by the asyncResult.asyncContext property in the callback function.
+        */
+       loadCustomPropertiesAsync(callback: (result: AsyncResult) => void, userContext?: any): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+         * Gets or sets the description that appears in the subject field of an item.
+         *
+         * The subject property gets or sets the entire subject of the item, as sent by the email server.
+         *
+         * The subject property returns a Subject object that provides methods to get and set the subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        subject: Subject;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        inInline: If true, indicates that the attachment will be shown inline in the message body, and should not be displayed in the attachment list.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type asyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If uploading the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        inInline: If true, indicates that the attachment will be shown inline in the message body, and should not be displayed in the attachment list.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, options: AsyncContextOptions): void;
+        /**
+         * Adds a file to a message or appointment as an attachment.
+         *
+         * The addFileAttachmentAsync method uploads the file at the specified URI and attaches it to the item in the compose form.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * AttachmentSizeExceeded - The attachment is larger than allowed.
+         *
+         * FileTypeNotSupported - The attachment has an extension that is not allowed.
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type asyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If uploading the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addFileAttachmentAsync(uri: string, attachmentName: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If adding the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, options: AsyncContextOptions): void;
+        /**
+         * Adds an Exchange item, such as a message, as an attachment to the message or appointment.
+         *
+         * The addItemAttachmentAsync method attaches the item with the specified Exchange identifier to the item in the compose form. If you specify a callback method, the method is called with one parameter, asyncResult, which contains either the attachment identifier or a code that indicates any error that occurred while attaching the item. You can use the options parameter to pass state information to the callback method, if needed.
+         *
+         * You can subsequently use the identifier with the removeAttachmentAsync method to remove the attachment in the same session.
+         *
+         * If your Office add-in is running in Outlook Web App, the addItemAttachmentAsync method can attach items to items other than the item that you are editing; however, this is not supported and is not recommended.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors:
+         *
+         * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         *
+         * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
+         * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the attachment identifier will be provided in the asyncResult.value property. If adding the attachment fails, the asyncResult object will contain an Error object that provides a description of the error.
+         */
+        addItemAttachmentAsync(itemId: any, attachmentName: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Closes the current item that is being composed
+         *
+         * The behaviors of the close method depends on the current state of the item being composed. If the item has unsaved changes, the client prompts the user to save, discard, or close the action.
+         *
+         * In the Outlook desktop client, if the message is an inline reply, the close method has no effect.
+         *
+         * Note: In Outlook on the web, if the item is an appointment and it has previously been saved using saveAsync, the user is prompted to save, discard, or cancel even if no changes have occurred since the item was last saved.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: Restricted
+         *
+         * Applicable Outlook mode: Message Compose
+         */
+        close(): void;
+        /**
+         * Gets initialization data passed when the add-in is activated by an actionable message.
+         *
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * More information on {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | actionable messages}.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously returns selected data from the subject or body of a message.
+         *
+         * If there is no selection but the cursor is in the body or subject, the method returns null for the selected data. If a field other than the body or subject is selected, the method returns the InvalidSelection error.
+         *
+         * To access the selected data from the callback method, call asyncResult.value.data. To access the source property that the selection comes from, call asyncResult.value.sourceProperty, which will be either body or subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * The selected data as a string with format determined by coercionType.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * @param coercionType Requests a format for the data. If Text, the method returns the plain text as a string , removing any HTML tags present. If HTML, the method returns the selected text, whether it is plaintext or HTML.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+         */
+        getSelectedDataAsync(coercionType: CoercionType, callback: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously returns selected data from the subject or body of a message.
+         *
+         * If there is no selection but the cursor is in the body or subject, the method returns null for the selected data. If a field other than the body or subject is selected, the method returns the InvalidSelection error.
+         *
+         * To access the selected data from the callback method, call asyncResult.value.data. To access the source property that the selection comes from, call asyncResult.value.sourceProperty, which will be either body or subject.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * The selected data as a string with format determined by coercionType.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * @param coercionType Requests a format for the data. If Text, the method returns the plain text as a string , removing any HTML tags present. If HTML, the method returns the selected text, whether it is plaintext or HTML.
+         * @param options An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+         */
+        getSelectedDataAsync(coercionType: CoercionType, options: AsyncContextOptions, callback: (result: AsyncResult) => void): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        removeAttachmentAsync(attachmentIndex: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         */
+        removeAttachmentAsync(attachmentIndex: string): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        removeAttachmentAsync(attachmentIndex: string, options: AsyncContextOptions): void;
+        /**
+         * Removes an attachment from a message or appointment.
+         *
+         * The removeAttachmentAsync method removes the attachment with the specified identifier from the item. As a best practice, you should use the attachment identifier to remove an attachment only if the same mail app has added that attachment in the same session. In Outlook Web App and OWA for Devices, the attachment identifier is valid only within the same session. A session is over when the user closes the app, or if the user starts composing in an inline form and subsequently pops out the inline form to continue in a separate window.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        removeAttachmentAsync(attachmentIndex: string, callback: (result: AsyncResult) => void): void;
+
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        saveAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         */
+        saveAsync(): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         */
+        saveAsync(options: AsyncContextOptions): void;
+        /**
+         * Asynchronously saves an item.
+         *
+         * When invoked, this method saves the current message as a draft and returns the item id via the callback method. In Outlook Web App or Outlook in online mode, the item is saved to the server. In Outlook in cached mode, the item is saved to the local cache.
+         *
+         * Since appointments have no draft state, if saveAsync is called on an appointment in compose mode, the item will be saved as a normal appointment on the user's calendar. For new appointments that have not been saved before, no invitation will be sent. Saving an existing appointment will send an update to added or removed attendees.
+         *
+         * Note: If your add-in calls saveAsync on an item in compose mode in order to get an itemId to use with EWS or the REST API, be aware that when Outlook is in cached mode, it may take some time before the item is actually synced to the server. Until the item is synced, using the itemId will return an error.
+         *
+         * Note: The following clients have different behavior for saveAsync on appointments in compose mode:
+         *
+         * - Mac Outlook does not support saveAsync on a meeting in compose mode. Calling saveAsync on a meeting in Mac Outlook will return an error.
+         *
+         * - Outlook on the web always sends an invitation or update when saveAsync is called on an appointment in compose mode.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        saveAsync(callback: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        coercionType: If text, the current style is applied in Outlook Web App and Outlook. If the field is an HTML editor, only the text data is inserted, even if the data is HTML. If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook Web App and the default style is applied in Outlook. If the field is a text field, an InvalidDataFormat error is returned. If coercionType is not set, the result depends on the field: if the field is HTML then HTML is used; if the field is text, then plain text is used.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        setSelectedDataAsync(data: string, options?: AsyncContextOptions & CoercionTypeOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         */
+        setSelectedDataAsync(data: string): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         *        coercionType: If text, the current style is applied in Outlook Web App and Outlook. If the field is an HTML editor, only the text data is inserted, even if the data is HTML. If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook Web App and the default style is applied in Outlook. If the field is a text field, an InvalidDataFormat error is returned. If coercionType is not set, the result depends on the field: if the field is HTML then HTML is used; if the field is text, then plain text is used.
+         */
+        setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+        /**
+         * Asynchronously inserts data into the body or subject of a message.
+         *
+         * The setSelectedDataAsync method inserts the specified string at the cursor location in the subject or body of the item, or, if text is selected in the editor, it replaces the selected text. If the cursor is not in the body or subject field, an error is returned. After insertion, the cursor is placed at the end of the inserted content.
+         *
+         * [Api set: Mailbox 1.2]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadWriteItem
+         *
+         * Applicable Outlook mode: Message Compose
+         *
+         * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         *
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult. If removing the attachment fails, the asyncResult.error property will contain an error code with the reason for the failure.
+         */
+        setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
     }
     /**
      * The message read mode of {@link Office.Item | Office.context.mailbox.item}.
@@ -7974,7 +10076,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Message Read
          */
         cc: EmailAddressDetails[];
         /**
@@ -7992,7 +10094,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Read
+         * Applicable Outlook mode: Message Read
          */
         from: EmailAddressDetails;
         /**
@@ -8004,7 +10106,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Read
+         * Applicable Outlook mode: Message Read
          */
         internetMessageId: string;
         /**
@@ -8020,7 +10122,7 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Read
+         * Applicable Outlook mode: Message Read
          */
         sender: EmailAddressDetails;
         /**
@@ -8034,9 +10136,521 @@ declare namespace Office {
          *
          * Minimum permission level: ReadItem
          *
-         * Applicable Outlook mode: Compose or read
+         * Applicable Outlook mode: Message Read
          */
         to: EmailAddressDetails[];
+
+        // Repeated Item Fields //
+
+        /**
+         * Gets an object that provides methods for manipulating the body of an item.
+         *
+         * [Api set: Mailbox 1.1]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        body: Body;
+        /**
+         * Gets the date and time that an item was created. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        dateTimeCreated: Date;
+        /**
+         * Gets the date and time that an item was last modified. Read mode only.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: This member is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        dateTimeModifed: Date;
+        /**
+         * Gets the type of item that an instance represents.
+         *
+         * The itemType property returns one of the ItemType enumeration values, indicating whether the item object instance is a message or an appointment.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        itemType: Office.MailboxEnums.ItemType;
+        /**
+         * Gets the notification messages for an item.
+         *
+         * [Api set: Mailbox 1.3]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Compose or read
+         */
+        notificationMessages: NotificationMessages;
+
+        /**
+         * Gets the recurrence pattern of an appointment. Gets the recurrence pattern of a meeting request. Read and compose modes for appointment items. Read mode for meeting request items.
+         * 
+         * The recurrence property returns a recurrence object for recurring appointments or meetings requests if an item is a series or an instance in a series. null is returned for single appointments and meeting requests of single appointments. undefined is returned for messages that are not meeting requests.
+         * 
+         * Note: Meeting requests have an itemClass value of IPM.Schedule.Meeting.Request.
+         * 
+         * Note: If the recurrence object is null, this indicates that the object is a single appointment or a meeting request of a single appointment and NOT a part of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Message Read
+         */
+        recurrence: Recurrence;
+
+        /**
+         * Gets the id of the series that an instance belongs to.
+         * 
+         * In OWA and Outlook, the seriesId returns the Exchange Web Services (EWS) ID of the parent (series) item that this item belongs to. However, in iOS and Android, the seriesId returns the REST ID of the parent item.
+         * 
+         * Note: The identifier returned by the seriesId property is the same as the Exchange Web Services item identifier. The seriesId property is not identical to the Outlook IDs used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see {@link https://docs.microsoft.com/outlook/add-ins/use-rest-api | Use the Outlook REST APIs from an Outlook add-in}.
+         * 
+         * The seriesId property returns null for items that do not have parent items such as single appointments, series items, or meeting requests and returns undefined for any other items that are not meeting requests.
+         * 
+         * [Api set: Mailbox Preview]
+         * 
+         * @remarks
+         * 
+         * Minimum permission level: ReadItem
+         * 
+         * Applicable Outlook mode: Message Read
+         */
+        seriesId: string;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Adds an event handler for a supported event.
+         * 
+         * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+         * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to addHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+         */
+        addHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Asynchronously loads custom properties for this add-in on the selected item.
+        *
+        * Custom properties are stored as key/value pairs on a per-app, per-item basis. This method returns a CustomProperties object in the callback, which provides methods to access the custom properties specific to the current item and the current add-in. Custom properties are not encrypted on the item, so this should not be used as secure storage.
+        *
+        * The custom properties are provided as a CustomProperties object in the asyncResult.value property. This object can be used to get, set, and remove custom properties from the item and save changes to the custom property set back to the server.
+        *
+        * [Api set: Mailbox 1.0]
+        *
+        * @remarks
+        *
+        * Minimum permission level: ReadItem
+        *
+        * Applicable Outlook mode: Message Read
+        *
+        * @param callback When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
+        * @param userContext Optional. Developers can provide any object they wish to access in the callback function. This object can be accessed by the asyncResult.asyncContext property in the callback function.
+        */
+       loadCustomPropertiesAsync(callback: (result: AsyncResult) => void, userContext?: any): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, options?: any, callback?: (result: AsyncResult) => void): void;
+
+       /**
+        * Removes an event handler for a supported event.
+        * 
+        * Currently the only supported event type is Office.EventType.RecurrencePatternChanged, which is invoked when the user changes the recurrence pattern of a series.
+        * 
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param eventType The event that should invoke the handler.
+         * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
+        */
+       removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+
+        /**
+         * Gets an array of attachments for the item.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Note: Certain types of files are blocked by Outlook due to potential security issues and are therefore not returned. For more information, see {@link https://support.office.com/article/Blocked-attachments-in-Outlook-434752E1-02D3-4E90-9124-8B81E49A8519 | Blocked attachments in Outlook}.
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         */
+        attachments: AttachmentDetails[];
+        /**
+         * Gets the Exchange Web Services item class of the selected item.
+         *
+         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
+         *
+         * [div class="mx-tdBreakAll"|Type|Description|item class|
+         * |-----------|------------|------------|
+         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
+         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
+         *
+         * You can create custom message classes that extends a default message class, for example, a custom appointment message class IPM.Appointment.Contoso.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        itemClass: string;
+        /**
+         * Gets the Exchange Web Services item identifier for the current item.
+         *
+         * The itemId property is not available in compose mode. If an item identifier is required, the saveAsync method can be used to save the item to the store, which will return the item identifier in the AsyncResult.value parameter in the callback function.
+         *
+         * Note: The identifier returned by the itemId property is the same as the Exchange Web Services item identifier. The itemId property is not identical to the Outlook Entry ID or the ID used by the Outlook REST API. Before making REST API calls using this value, it should be converted using Office.context.mailbox.convertToRestId. For more details, see Use the Outlook REST APIs from an Outlook add-in.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        itemId: string;
+        /**
+         * Gets the subject of an item, with all prefixes removed (including RE: and FWD:).
+         *
+         * The normalizedSubject property gets the subject of the item, with any standard prefixes (such as RE: and FW:) that are added by email programs. To get the subject of the item with the prefixes intact, use the subject property.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        normalizedSubject: string;
+        /**
+         * Gets the description that appears in the subject field of an item.
+         *
+         * The subject property gets or sets the entire subject of the item, as sent by the email server.
+         *
+         * The subject property returns a string. Use the normalizedSubject property to get the subject minus any leading prefixes such as RE: and FW:.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        subject: string;
+        /**
+         * Displays a reply form that includes the sender and all recipients of the selected message or the organizer and all attendees of the selected appointment.
+         *
+         * In Outlook Web App, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2- or 1-column view.
+         *
+         * If any of the string parameters exceed their limits, displayReplyAllForm throws an exception.
+         *
+         * When attachments are specified in the formData.attachments parameter, Outlook and Outlook Web App attempt to download all attachments and attach them to the reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB
+         *  OR
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function
+         */
+        displayReplyAllForm(formData: string | ReplyFormData): void;
+        /**
+         * Displays a reply form that includes only the sender of the selected message or the organizer of the selected appointment.
+         *
+         * In Outlook Web App, the reply form is displayed as a pop-out form in the 3-column view and a pop-up form in the 2- or 1-column view.
+         *
+         * If any of the string parameters exceed their limits, displayReplyForm throws an exception.
+         *
+         * When attachments are specified in the formData.attachments parameter, Outlook and Outlook Web App attempt to download all attachments and attach them to the reply form. If any attachments fail to be added, an error is shown in the form UI. If this isn't possible, then no error message is thrown.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param formData A string that contains text and HTML and that represents the body of the reply form. The string is limited to 32 KB.
+         * OR
+         * An {@link Office.ReplyFormData} object that contains body or attachment data and a callback function.
+         */
+        displayReplyForm(formData: string | ReplyFormData): void;
+        /**
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * 
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param options Optional. An object literal that contains one or more of the following properties.
+         *        asyncContext: Developers can provide any object they wish to access in the callback method.
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        /**
+         * Gets initialization data passed when the add-in is {@link https://docs.microsoft.com/outlook/actionable-messages/invoke-add-in-from-actionable-message | activated by an actionable message}.
+         * 
+         * Note: This method is only supported by Outlook 2016 for Windows (Click-to-Run versions greater than 16.0.8413.1000) and Outlook on the web for Office 365.
+         *
+         * [Api set: Mailbox Preview]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object. On success, the initialization data is provided in the asyncResult.value property as a string. If there is no initialization context, the asyncResult object will contain an Error object with its code property set to 9020 and its name property set to GenericResponseError.
+         */
+        getInitializationContextAsync(callback?: (result: AsyncResult) => void): void;
+        /**
+         * Gets the entities found in the selected item.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        getEntities(): Entities;
+        /**
+         * Gets an array of all the entities of the specified entity type found in the selected item.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * If the value passed in entityType is not a valid member of the EntityType enumeration, the method returns null. If no entities of the specified type are present on the item, the method returns an empty array. Otherwise, the type of the objects in the returned array depends on the type of entity requested in the entityType parameter.
+         *
+         * While the minimum permission level to use this method is Restricted, some entity types require ReadItem to access, as specified in the following table.
+         * |Value of entityType|Type of objects in returned array|Required Permission Level|
+         * |-------|-----------|----------|
+         * |Address|String|Restricted|
+         * |Contact|Contact|ReadItem|
+         * |EmailAddress|String|ReadItem|
+         * |MeetingSuggestion|MeetingSuggestion|ReadItem|
+         * |PhoneNumber|PhoneNumber|Restricted|
+         * |TaskSuggestion|TaskSuggestion|ReadItem|
+         * |URL|String|Restricted|
+         *
+         * @remarks
+         * Minimum permission level: Restricted
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param entityType One of the EntityType enumeration values.
+         */
+        getEntitiesByType(entityType: Office.MailboxEnums.EntityType): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
+        /**
+         * Returns well-known entities in the selected item that pass the named filter defined in the manifest XML file.
+         *
+         * The getFilteredEntitiesByName method returns the entities that match the regular expression defined in the ItemHasKnownEntity rule element in the manifest XML file with the specified FilterName element value.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param name The name of the ItemHasKnownEntity rule element that defines the filter to match.
+         * @returns If there is no ItemHasKnownEntity element in the manifest with a FilterName element value that matches the name parameter, the method returns null. If the name parameter does match an ItemHasKnownEntity element in the manifest, but there are no entities in the current item that match, the method return an empty array.
+         */
+        getFilteredEntitiesByName(name: string): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
+        /**
+         * Returns string values in the selected item that match the regular expressions defined in the manifest XML file.
+         *
+         * The getRegExMatches method returns the strings that match the regular expression defined in each ItemHasRegularExpressionMatch or ItemHasKnownEntity rule element in the manifest XML file. For an ItemHasRegularExpressionMatch rule, a matching string has to occur in the property of the item that is specified by that rule. The PropertyName simple type defines the supported properties.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results. Instead, use the Body.getAsync method to retrieve the entire body.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file. The name of each array is equal to the corresponding value of the RegExName attribute of the matching ItemHasRegularExpressionMatch rule or the FilterName attribute of the matching ItemHasKnownEntity rule.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        getRegExMatches(): any;
+        /**
+         * Returns string values in the selected item that match the named regular expression defined in the manifest XML file.
+         *
+         * The getRegExMatchesByName method returns the strings that match the regular expression defined in the ItemHasRegularExpressionMatch rule element in the manifest XML file with the specified RegExName element value.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.0]
+         *
+         * @returns
+         * An array that contains the strings that match the regular expression defined in the manifest XML file.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param name The name of the ItemHasRegularExpressionMatch rule element that defines the filter to match.
+         */
+        getRegExMatchesByName(name: string): string[];
+        /**
+         * Gets the entities found in a highlighted match a user has selected. Highlighted matches apply to contextual add-ins.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.6]
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         *
+         * @param name The name of the ItemHasRegularExpressionMatch rule element that defines the filter to match.
+         */
+        getSelectedEntities(): Entities;
+        /**
+         * Returns string values in a highlighted match that match the regular expressions defined in the manifest XML file. Highlighted matches apply to contextual add-ins.
+         *
+         * The getSelectedRegExMatches method returns the strings that match the regular expression defined in each ItemHasRegularExpressionMatch or ItemHasKnownEntity rule element in the manifest XML file. For an ItemHasRegularExpressionMatch rule, a matching string has to occur in the property of the item that is specified by that rule. The PropertyName simple type defines the supported properties.
+         *
+         * If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results. Instead, use the Body.getAsync method to retrieve the entire body.
+         *
+         * Note: This method is not supported in Outlook for iOS or Outlook for Android.
+         *
+         * [Api set: Mailbox 1.6]
+         *
+         * @returns
+         * An object that contains arrays of strings that match the regular expressions defined in the manifest XML file. The name of each array is equal to the corresponding value of the RegExName attribute of the matching ItemHasRegularExpressionMatch rule or the FilterName attribute of the matching ItemHasKnownEntity rule.
+         *
+         * @remarks
+         *
+         * Minimum permission level: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         */
+        getSelectedRegExMatches(): any;
     }
 
     /**

From d419bddbce227a24126bce0581728d1f70643479 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 15:57:22 -0700
Subject: [PATCH 074/180] Office function descriptions

---
 types/office-js/index.d.ts | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 4d06e7b764..d9a54c2331 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -240,8 +240,20 @@ declare namespace Office {
      */
     var context: Context;
     /**
-     * This method is called after the Office API was loaded.
-     * @param reason Indicates how the app was initialized
+     * Occurs when the runtime environment is loaded and the add-in is ready to start interacting with the application and hosted document. 
+     * 
+     * The reason parameter of the initialize event listener function returns an `InitializationReason` enumeration value that specifies how initialization occurred. A task pane or content add-in can be initialized in two ways:
+     * 
+     *  - The user just inserted it from Recently Used Add-ins section of the Add-in drop-down list on the Insert tab of the ribbon in the Office host application, or from Insert add-in dialog box.
+     * 
+     *  - The user opened a document that already contains the add-in.
+     * 
+     * *Note*: The reason parameter of the initialize event listener function only returns an `InitializationReason` enumeration value for task pane and content add-ins. It does not return a value for Outlook add-ins.
+     * 
+     * @remarks
+     * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
+     * 
+     * @param reason Indicates how the app was initialized.
      */
     function initialize(reason: InitializationReason): void;
     /**
@@ -252,8 +264,9 @@ declare namespace Office {
     */
     function onReady(callback?: (info: { host: HostType, platform: PlatformType }) => any): Promise<{ host: HostType, platform: PlatformType }>;
     /**
-     * Indicates if the large namespace for objects will be used or not.
-     * @param useShortNamespace Indicates if 'true' that the short namespace will be used
+     * Toggles on and off the `Office` alias for the full `Microsoft.Office.WebExtension` namespace.
+     * 
+     * @param useShortNamespace True to use the shortcut alias; otherwise false to disable it. The default is true.
      */
     function useShortNamespace(useShortNamespace: boolean): void;
     // Enumerations

From caf2c31222ccc68c405b0a5f566d7b5cdbb875c9 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 15:59:34 -0700
Subject: [PATCH 075/180] Office function descriptions

---
 types/office-js/index.d.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index d9a54c2331..17bb3dcb55 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -266,6 +266,9 @@ declare namespace Office {
     /**
      * Toggles on and off the `Office` alias for the full `Microsoft.Office.WebExtension` namespace.
      * 
+     * @remarks
+     * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
+     * 
      * @param useShortNamespace True to use the shortcut alias; otherwise false to disable it. The default is true.
      */
     function useShortNamespace(useShortNamespace: boolean): void;

From cdf9084e9a1278b23a490fa76008fbace96ee389 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 11 Jun 2018 16:36:14 -0700
Subject: [PATCH 076/180] Adding Dialog oject

---
 types/office-js/index.d.ts | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index e4cb2bb0cc..926b344a88 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -624,6 +624,7 @@ declare namespace Office {
          */
         closeContainer(): void;
     }
+
     /**
      * Provides information about what Requirement Sets are supported in current environment.
      */
@@ -634,7 +635,26 @@ declare namespace Office {
         * @param minVersion - The minimum required version; e.g., "1.4".
         */
        isSetSupported(name: string, minVersion?: number): boolean;
-}
+    }
+
+    /**
+     * The object that is returned when `UI.displayDialogAsync` is called.
+     */
+    interface Dialog {
+        /**
+         * Called from a parent page to close the corresponding dialog box. 
+         */
+        close(): void;
+        /**
+         * Registers an event handler. The two supported events are:
+         *
+         * - DialogMessageReceived. Triggered when the dialog box sends a message to its parent.
+         *
+         * - DialogEventReceived. Triggered when the dialog box has been closed or otherwise unloaded.
+         */
+        addEventHandler(eventType: Office.EventType, handler: Function): void;
+    }
+
     /**
      * Provides options for how a dialog is displayed.
      */

From 051929e8397ff96cc904d00d3423f00968d21fb4 Mon Sep 17 00:00:00 2001
From: Jouni Suorsa <jouni.suorsa@sysart.fi>
Date: Tue, 12 Jun 2018 10:04:58 +0300
Subject: [PATCH 077/180] Added possibility to create sandboxes and restore
 original methods.

---
 types/chai-spies/chai-spies-tests.ts |  18 +++-
 types/chai-spies/index.d.ts          | 150 ++++++++++++++++++---------
 2 files changed, 118 insertions(+), 50 deletions(-)

diff --git a/types/chai-spies/chai-spies-tests.ts b/types/chai-spies/chai-spies-tests.ts
index 6a11872633..7bc9530164 100644
--- a/types/chai-spies/chai-spies-tests.ts
+++ b/types/chai-spies/chai-spies-tests.ts
@@ -154,4 +154,20 @@ spy.should.not.have.been.called.above(3);
 expect(spy).to.have.been.called.below(3);
 expect(spy).to.not.have.been.called.lt(3);
 spy.should.have.been.called.lt(3);
-spy.should.not.have.been.called.below(3);
\ No newline at end of file
+spy.should.not.have.been.called.below(3);
+
+// You can also create sandbox
+let sb = chai.spy.sandbox();
+
+sb.on(array, 'pop', () => {
+    return 1;
+})
+
+let one = array.pop();
+expect(one).to.equal(1);
+
+// Can restore methods in sandbox
+sb.restore();
+array.push(2);
+let two = array.pop();
+expect(two).to.equal(2);
diff --git a/types/chai-spies/index.d.ts b/types/chai-spies/index.d.ts
index e7dc599228..bb37fa8cd4 100644
--- a/types/chai-spies/index.d.ts
+++ b/types/chai-spies/index.d.ts
@@ -1,7 +1,8 @@
-// Type definitions for chai-spies
+// Type definitions for chai-spies 1.0.0
 // Project: https://github.com/chaijs/chai-spies
 // Definitions by: Ilya Kuznetsov <https://github.com/kuzn-ilya>
 //                 Harm van der Werf <https://github.com/harm-less>
+//                 Jouni Suorsa <https://github.com/jounisuo>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /// <reference types="chai" />
@@ -22,7 +23,7 @@ declare namespace Chai {
          * ```ts
          * expect(spy).to.be.spy;
          * spy.should.be.spy;
-         * ``` 
+         * ```
          */
         spy: Assertion;
 
@@ -33,7 +34,7 @@ declare namespace Chai {
          * expect(spy).to.have.been.called();
          * spy.should.have.been.called();
          * ```
-         * Note that ```called``` can be used as a chainable method.  
+         * Note that ```called``` can be used as a chainable method.
          */
         called: ChaiSpies.Called;
 
@@ -62,7 +63,32 @@ declare namespace Chai {
 }
 
 declare namespace ChaiSpies {
+    interface Sandbox {
+      /**
+       * #### chai.spy.on (function)
+       *
+       * Wraps an object method into spy. All calls will pass through to the original function.
+       *
+       * @param {Object} object
+       * @param {String} methodNames names to spy on
+       * @param {function} fn replacement function
+       * @returns function to actually call
+       */
+      on(object: Object, methodNames: string | string[], fn?: (parameters: any[]|any) => any): any;
 
+      /**
+       * #### chai.spy.restore (function)
+       *
+       * Restores previously wrapped object's method.
+       * Restores all spied objects of a sandbox if called without parameters.
+       *
+       * @function
+       * @param {Object} [object]
+       * @param {String|String[]} [methods] name or names
+       * @return {Sandbox} Sandbox instance
+       */
+      restore(object?: Object, methodNames?: string | string[]): void;
+    }
     interface Spy {
         /**
          * #### chai.spy (function)
@@ -73,9 +99,9 @@ declare namespace ChaiSpies {
          * var spy = chai.spy(original)
          *   , e_spy = chai.spy();
          * ```
-         * @param fn function to spy on. @default ```function () {}``` 
+         * @param fn function to spy on. @default ```function () {}```
          * @returns function to actually call
-         */ 
+         */
         (): SpyFunc0Proxy<void>;
         <R>(fn: SpyFunc0<R>): SpyFunc0Proxy<R>;
         <A1, R>(fn: SpyFunc1<A1, R>): SpyFunc1Proxy<A1, R>;
@@ -108,11 +134,11 @@ declare namespace ChaiSpies {
          * var spy = chai.spy.on(Array, 'isArray');
          * ```
          * @param {Object} object
-         * @param {String} methodNames name to spy on
+         * @param {String} method names to spy on
          * @param {function} fn replacement function
          * @returns function to actually call
          */
-        on(object: Object, methodNames: string | string[], fn?: (parameters: any[]) => any): any;
+        on(object: Object, methodNames: string | string[], fn?: (parameters: any[]|any) => any): any;
 
         /**
          * #### chai.spy.object (function)
@@ -130,6 +156,20 @@ declare namespace ChaiSpies {
         object<T>(name: string, methods: T): T;
         object<T>(methods: T): T;
 
+      /**
+       * #### chai.spy.restore (function)
+       *
+       * Restores spy assigned to DEFAULT sandbox
+       *
+       * Restores previously wrapped object's method.
+       * Restores all spied objects of a sandbox if called without parameters.
+       *
+       * @param {Object} [object]
+       * @param {String|String[]} [methods] name or names
+       * @return {Sandbox} Sandbox instance
+       */
+        restore(object?: Object, methodNames?: string | string[]): void;
+
         /**
          * #### chai.spy.returns (function)
          *
@@ -143,6 +183,18 @@ declare namespace ChaiSpies {
          */
 
         returns<T>(value: T): SpyFunc0Proxy<T>;
+
+        /**
+         * ### chai.spy.sandbox
+         *
+         * Creates a sandbox.
+         *
+         * Sandbox is a set of spies.
+         * Sandbox allows to track methods on objects and restore original methods with on restore call.
+         *
+         * @returns {Sandbox}
+         */
+        sandbox(): Sandbox;
     }
 
     interface Called {
@@ -160,12 +212,12 @@ declare namespace ChaiSpies {
          * spy.should.not.have.been.called.once;
          * ```
          */
-        once: Chai.Assertion; 
+        once: Chai.Assertion;
 
         /**
          * ####.twice
          * Assert that a spy has been called exactly twice.
-         * ```ts 
+         * ```ts
          * expect(spy).to.have.been.called.twice;
          * expect(spy).to.not.have.been.called.twice;
          * spy.should.have.been.called.twice;
@@ -217,7 +269,7 @@ declare namespace ChaiSpies {
          * ```ts
          * expect(spy).to.have.been.called.above(3);
          * spy.should.not.have.been.called.above(3);
-         * ``` 
+         * ```
          */
         above(n: number): Chai.Assertion;
 
@@ -227,7 +279,7 @@ declare namespace ChaiSpies {
          * ```ts
          * expect(spy).to.have.been.called.gt(3);
          * spy.should.not.have.been.called.gt(3);
-         * ``` 
+         * ```
          */
         gt(n: number): Chai.Assertion;
 
@@ -237,7 +289,7 @@ declare namespace ChaiSpies {
          * ```ts
          * expect(spy).to.have.been.called.below(3);
          * spy.should.not.have.been.called.below(3);
-         * ```   
+         * ```
          */
         below(n: number): Chai.Assertion;
 
@@ -247,7 +299,7 @@ declare namespace ChaiSpies {
          * ```ts
          * expect(spy).to.have.been.called.lt(3);
          * spy.should.not.have.been.called.lt(3);
-         * ```   
+         * ```
          */
         lt(n: number): Chai.Assertion;
     }
@@ -303,7 +355,7 @@ declare namespace ChaiSpies {
          * spy.should.have.been.called.with('foo');
          * ```
          * Will also pass for ```spy('foo', 'bar')``` and ```spy(); spy('foo')```.
-         * If used with multiple arguments, assert that a spy has been called with all the given arguments at least once.  
+         * If used with multiple arguments, assert that a spy has been called with all the given arguments at least once.
          * ```ts
          * spy('foo', 'bar', 1);
          * expect(spy).to.have.been.called.with('bar', 'foo');
@@ -391,7 +443,7 @@ declare namespace ChaiSpies {
          *
          * Resets __spy object parameters for instantiation and reuse
          * @returns proxy spy object
-         */ 
+         */
         reset(): this;
     }
 
@@ -399,77 +451,77 @@ declare namespace ChaiSpies {
         (): R;
     }
 
-    interface SpyFunc1<A1, R> { 
-        (a: A1): R; 
+    interface SpyFunc1<A1, R> {
+        (a: A1): R;
     }
 
-    interface SpyFunc2<A1, A2, R> { 
-        (a: A1, b: A2): R; 
+    interface SpyFunc2<A1, A2, R> {
+        (a: A1, b: A2): R;
     }
 
-    interface SpyFunc3<A1, A2, A3, R> { 
-        (a: A1, b: A2, c: A3): R; 
+    interface SpyFunc3<A1, A2, A3, R> {
+        (a: A1, b: A2, c: A3): R;
     }
 
-    interface SpyFunc4<A1, A2, A3, A4, R> { 
-        (a: A1, b: A2, c: A3, d: A4): R; 
+    interface SpyFunc4<A1, A2, A3, A4, R> {
+        (a: A1, b: A2, c: A3, d: A4): R;
     }
 
-    interface SpyFunc5<A1, A2, A3, A4, A5, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5): R; 
+    interface SpyFunc5<A1, A2, A3, A4, A5, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5): R;
     }
 
-    interface SpyFunc6<A1, A2, A3, A4, A5, A6, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6): R; 
+    interface SpyFunc6<A1, A2, A3, A4, A5, A6, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6): R;
     }
 
-    interface SpyFunc7<A1, A2, A3, A4, A5, A6, A7, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7): R; 
+    interface SpyFunc7<A1, A2, A3, A4, A5, A6, A7, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7): R;
     }
 
-    interface SpyFunc8<A1, A2, A3, A4, A5, A6, A7, A8, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8): R; 
+    interface SpyFunc8<A1, A2, A3, A4, A5, A6, A7, A8, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8): R;
     }
-    
-    interface SpyFunc9<A1, A2, A3, A4, A5, A6, A7, A8, A9, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8, i: A9): R; 
+
+    interface SpyFunc9<A1, A2, A3, A4, A5, A6, A7, A8, A9, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8, i: A9): R;
     }
-    
-    interface SpyFunc10<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R> { 
-        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8, i: A9, j: A10): R; 
+
+    interface SpyFunc10<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R> {
+        (a: A1, b: A2, c: A3, d: A4, e: A5, f: A6, g: A7, h: A8, i: A9, j: A10): R;
     }
 
     interface SpyFunc0Proxy<R> extends SpyFunc0<R>, Resetable {
     }
 
-    interface SpyFunc1Proxy<A1, R> extends SpyFunc1<A1, R>, Resetable { 
+    interface SpyFunc1Proxy<A1, R> extends SpyFunc1<A1, R>, Resetable {
     }
 
-    interface SpyFunc2Proxy<A1, A2, R> extends SpyFunc2<A1, A2, R>, Resetable { 
+    interface SpyFunc2Proxy<A1, A2, R> extends SpyFunc2<A1, A2, R>, Resetable {
     }
 
-    interface SpyFunc3Proxy<A1, A2, A3, R> extends SpyFunc3<A1, A2, A3, R>, Resetable { 
+    interface SpyFunc3Proxy<A1, A2, A3, R> extends SpyFunc3<A1, A2, A3, R>, Resetable {
     }
 
-    interface SpyFunc4Proxy<A1, A2, A3, A4, R> extends SpyFunc4<A1, A2, A3, A4, R>, Resetable { 
+    interface SpyFunc4Proxy<A1, A2, A3, A4, R> extends SpyFunc4<A1, A2, A3, A4, R>, Resetable {
     }
 
-    interface SpyFunc5Proxy<A1, A2, A3, A4, A5, R> extends SpyFunc5<A1, A2, A3, A4, A5, R>, Resetable { 
+    interface SpyFunc5Proxy<A1, A2, A3, A4, A5, R> extends SpyFunc5<A1, A2, A3, A4, A5, R>, Resetable {
     }
 
-    interface SpyFunc6Proxy<A1, A2, A3, A4, A5, A6, R> extends SpyFunc6<A1, A2, A3, A4, A5, A6, R>, Resetable { 
+    interface SpyFunc6Proxy<A1, A2, A3, A4, A5, A6, R> extends SpyFunc6<A1, A2, A3, A4, A5, A6, R>, Resetable {
     }
 
-    interface SpyFunc7Proxy<A1, A2, A3, A4, A5, A6, A7, R> extends SpyFunc7<A1, A2, A3, A4, A5, A6, A7, R>, Resetable { 
+    interface SpyFunc7Proxy<A1, A2, A3, A4, A5, A6, A7, R> extends SpyFunc7<A1, A2, A3, A4, A5, A6, A7, R>, Resetable {
     }
 
-    interface SpyFunc8Proxy<A1, A2, A3, A4, A5, A6, A7, A8, R> extends SpyFunc8<A1, A2, A3, A4, A5, A6, A7, A8, R>, Resetable { 
+    interface SpyFunc8Proxy<A1, A2, A3, A4, A5, A6, A7, A8, R> extends SpyFunc8<A1, A2, A3, A4, A5, A6, A7, A8, R>, Resetable {
     }
-    
-    interface SpyFunc9Proxy<A1, A2, A3, A4, A5, A6, A7, A8, A9, R> extends SpyFunc9<A1, A2, A3, A4, A5, A6, A7, A8, A9, R>, Resetable { 
+
+    interface SpyFunc9Proxy<A1, A2, A3, A4, A5, A6, A7, A8, A9, R> extends SpyFunc9<A1, A2, A3, A4, A5, A6, A7, A8, A9, R>, Resetable {
     }
-    
-    interface SpyFunc10Proxy<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R> extends SpyFunc10<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R>, Resetable { 
+
+    interface SpyFunc10Proxy<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R> extends SpyFunc10<A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, R>, Resetable {
     }
 }
 

From ba196342a208dfbae5e04ec4d24db0b2205ffc9d Mon Sep 17 00:00:00 2001
From: Joshua Goldberg <josh@fullscreenmario.com>
Date: Tue, 12 Jun 2018 01:43:42 -0700
Subject: [PATCH 078/180] Cleaned up & partially expanded Jest's jest-tests.ts

The old file was a mix of pure types tests and copied real-world behavior examples. It was quite confusing. This organizes the contents into what is mostly a superset of the existing tests.
---
 types/jest/jest-tests.ts | 1623 +++++++++++++++++++++-----------------
 1 file changed, 898 insertions(+), 725 deletions(-)

diff --git a/types/jest/jest-tests.ts b/types/jest/jest-tests.ts
index e154561c86..bfaaec6259 100644
--- a/types/jest/jest-tests.ts
+++ b/types/jest/jest-tests.ts
@@ -1,762 +1,935 @@
-// TODO: Avoid requiring things that don't exist.
-declare var require: {
-    (s: string): any;
-    requireActual(s: string): any;
-    requireMock(s: string): any;
+/* Lifecycle events */
+
+beforeAll(() => {});
+beforeAll((done: jest.DoneCallback) => {});
+beforeAll((done: jest.DoneCallback) => done.fail(), 9001);
+
+beforeEach(() => {});
+beforeEach((done: jest.DoneCallback) => {});
+beforeEach((done: jest.DoneCallback) => done.fail(), 9001);
+
+afterAll(() => {});
+afterAll((done: jest.DoneCallback) => {});
+afterAll((done: jest.DoneCallback) => done.fail(), 9001);
+
+afterEach(() => {});
+afterEach((done: jest.DoneCallback) => {});
+afterEach((done: jest.DoneCallback) => done.fail(), 9001);
+
+/* describe */
+
+describe(0, () => {});
+describe("name", () => {});
+describe(() => {}, () => {});
+describe({ name: "name" }, () => {});
+
+describe.only(0, () => {});
+describe.only("name", () => {});
+describe.only(() => {}, () => {});
+describe.only({ name: "name" }, () => {});
+
+describe.skip(0, () => {});
+describe.skip("name", () => {});
+describe.skip(() => {}, () => {});
+describe.skip({ name: "name" }, () => {});
+
+fdescribe(0, () => {});
+fdescribe("name", () => {});
+fdescribe(() => {}, () => {});
+fdescribe({ name: "name" }, () => {});
+
+fdescribe.only(0, () => {});
+fdescribe.only("name", () => {});
+fdescribe.only(() => {}, () => {});
+fdescribe.only({ name: "name" }, () => {});
+
+fdescribe.skip(0, () => {});
+fdescribe.skip("name", () => {});
+fdescribe.skip(() => {}, () => {});
+fdescribe.skip({ name: "name" }, () => {});
+
+xdescribe(0, () => {});
+xdescribe("name", () => {});
+xdescribe(() => {}, () => {});
+xdescribe({ name: "name" }, () => {});
+
+xdescribe.only(0, () => {});
+xdescribe.only("name", () => {});
+xdescribe.only(() => {}, () => {});
+xdescribe.only({ name: "name" }, () => {});
+
+xdescribe.skip(0, () => {});
+xdescribe.skip("name", () => {});
+xdescribe.skip(() => {}, () => {});
+xdescribe.skip({ name: "name" }, () => {});
+
+/* it */
+
+it("name", () => {});
+it("name", async () => {});
+it("name", () => {}, 9001);
+it("name", async () => {}, 9001);
+it("name", (callback: jest.DoneCallback) => {}, 9001);
+
+it.only("name", () => {});
+it.only("name", async () => {});
+it.only("name", () => {}, 9001);
+it.only("name", async () => {}, 9001);
+it.only("name", (callback: jest.DoneCallback) => {}, 9001);
+
+it.skip("name", () => {});
+it.skip("name", async () => {});
+it.skip("name", () => {}, 9001);
+it.skip("name", async () => {}, 9001);
+it.skip("name", (callback: jest.DoneCallback) => {}, 9001);
+
+it.concurrent("name", () => {});
+it.concurrent("name", async () => {});
+it.concurrent("name", () => {}, 9001);
+it.concurrent("name", async () => {}, 9001);
+it.concurrent("name", (callback: jest.DoneCallback) => {}, 9001);
+
+fit("name", () => {});
+fit("name", async () => {});
+fit("name", () => {}, 9001);
+fit("name", async () => {}, 9001);
+fit("name", (callback: jest.DoneCallback) => {}, 9001);
+
+fit.only("name", () => {});
+fit.only("name", async () => {});
+fit.only("name", () => {}, 9001);
+fit.only("name", async () => {}, 9001);
+fit.only("name", (callback: jest.DoneCallback) => {}, 9001);
+
+fit.skip("name", () => {});
+fit.skip("name", async () => {});
+fit.skip("name", () => {}, 9001);
+fit.skip("name", async () => {}, 9001);
+fit.skip("name", (callback: jest.DoneCallback) => {}, 9001);
+
+fit.concurrent("name", () => {});
+fit.concurrent("name", async () => {});
+fit.concurrent("name", () => {}, 9001);
+fit.concurrent("name", async () => {}, 9001);
+fit.concurrent("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xit("name", () => {});
+xit("name", async () => {});
+xit("name", () => {}, 9001);
+xit("name", async () => {}, 9001);
+xit("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xit.only("name", () => {});
+xit.only("name", async () => {});
+xit.only("name", () => {}, 9001);
+xit.only("name", async () => {}, 9001);
+xit.only("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xit.skip("name", () => {});
+xit.skip("name", async () => {});
+xit.skip("name", () => {}, 9001);
+xit.skip("name", async () => {}, 9001);
+xit.skip("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xit.concurrent("name", () => {});
+xit.concurrent("name", async () => {});
+xit.concurrent("name", () => {}, 9001);
+xit.concurrent("name", async () => {}, 9001);
+xit.concurrent("name", (callback: jest.DoneCallback) => {}, 9001);
+
+test("name", () => {});
+test("name", async () => {});
+test("name", () => {}, 9001);
+test("name", async () => {}, 9001);
+test("name", (callback: jest.DoneCallback) => {}, 9001);
+
+test.only("name", () => {});
+test.only("name", async () => {});
+test.only("name", () => {}, 9001);
+test.only("name", async () => {}, 9001);
+test.only("name", (callback: jest.DoneCallback) => {}, 9001);
+
+test.skip("name", () => {});
+test.skip("name", async () => {});
+test.skip("name", () => {}, 9001);
+test.skip("name", async () => {}, 9001);
+test.skip("name", (callback: jest.DoneCallback) => {}, 9001);
+
+test.concurrent("name", () => {});
+test.concurrent("name", async () => {});
+test.concurrent("name", () => {}, 9001);
+test.concurrent("name", async () => {}, 9001);
+test.concurrent("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xtest("name", () => {});
+xtest("name", async () => {});
+xtest("name", () => {}, 9001);
+xtest("name", async () => {}, 9001);
+xtest("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xtest.only("name", () => {});
+xtest.only("name", async () => {});
+xtest.only("name", () => {}, 9001);
+xtest.only("name", async () => {}, 9001);
+xtest.only("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xtest.skip("name", () => {});
+xtest.skip("name", async () => {});
+xtest.skip("name", () => {}, 9001);
+xtest.skip("name", async () => {}, 9001);
+xtest.skip("name", (callback: jest.DoneCallback) => {}, 9001);
+
+xtest.concurrent("name", () => {});
+xtest.concurrent("name", async () => {});
+xtest.concurrent("name", () => {}, 9001);
+xtest.concurrent("name", async () => {}, 9001);
+xtest.concurrent("name", (callback: jest.DoneCallback) => {}, 9001);
+
+/* Done callbacks */
+
+describe("", () => {
+    it("", (callback: jest.DoneCallback): void => {
+        callback();
+        callback("");
+        callback("", 3);
+        callback.fail();
+        callback.fail("error");
+        callback.fail({ message: "message" });
+    });
+});
+
+/* NodeRequire interface (require extensions) */
+
+declare const nodeRequire: NodeRequire;
+
+// $ExpectType any
+nodeRequire.requireActual("moduleName");
+
+// $ExpectType any
+nodeRequire.requireMock("moduleName");
+
+/* Top-level jest namespace functions */
+
+const customMatcherFactories: jasmine.CustomMatcherFactories = {};
+
+jest
+    .addMatchers(customMatcherFactories)
+    .addMatchers({})
+    .addMatchers(customMatcherFactories)
+    .autoMockOff()
+    .autoMockOn()
+    .clearAllMocks()
+    .clearAllTimers()
+    .resetAllMocks()
+    .restoreAllMocks()
+    .clearAllTimers()
+    .deepUnmock("moduleName")
+    .disableAutomock()
+    .doMock("moduleName")
+    .doMock("moduleName", jest.fn())
+    .doMock("moduleName", jest.fn(), {})
+    .doMock("moduleName", jest.fn(), { virtual: true })
+    .dontMock("moduleName")
+    .enableAutomock()
+    .mock("moduleName")
+    .mock("moduleName", jest.fn())
+    .mock("moduleName", jest.fn(), {})
+    .mock("moduleName", jest.fn(), { virtual: true })
+    .resetModuleRegistry()
+    .resetModules()
+    .runAllImmediates()
+    .runAllTicks()
+    .runAllTimers()
+    .runOnlyPendingTimers()
+    .runTimersToTime(9001)
+    .advanceTimersByTime(9001)
+    .setMock("moduleName", {})
+    .setMock<{}>("moduleName", {})
+    .setMock<{ a: "b" }>("moduleName", { a: "b" })
+    .setTimeout(9001)
+    .unmock("moduleName")
+    .useFakeTimers()
+    .useRealTimers();
+
+/* Mocks and spies */
+
+const mock1: jest.Mock = jest.fn();
+const mock2: jest.Mock<undefined> = jest.fn<undefined>(() => undefined);
+const mock3: jest.Mock<string> = jest.fn(() => "abc");
+const mock4: jest.Mock<"abc"> = jest.fn((): "abc" => "abc");
+const mock5: jest.Mock<string> = jest.fn((...args: string[]) => args.join(""));
+const mock6: jest.Mock = jest.fn((arg: {}) => arg);
+
+const genMockModule1: {} = jest.genMockFromModule("moduleName");
+const genMockModule2: { a: "b" } = jest.genMockFromModule<{ a: "b" }>("moduleName");
+
+const isStringMock: boolean = jest.isMockFunction("foo");
+const isMockMock: boolean = jest.isMockFunction(mock1);
+
+const maybeMock = () => {};
+if (jest.isMockFunction(maybeMock)) {
+    maybeMock.getMockName();
+}
+
+const mockName: string = jest.fn().getMockName();
+const mockContextVoid: jest.MockContext<void> = jest.fn<void>().mock;
+const mockContextString: jest.MockContext<string> = jest.fn(() => "").mock;
+
+jest.fn().mockClear();
+
+jest.fn().mockReset();
+
+const spiedTarget = {
+    returnsVoid(): void { },
+    returnsString(): string {
+        return "";
+    }
 };
-// TODO: use real jquery types?
-declare const $: any;
 
-// Tests based on the Jest website
-jest.unmock('../sum');
+const spy1 = jest.spyOn(spiedTarget, "returnsVoid");
+const spy2 = jest.spyOn(spiedTarget, "returnsVoid", "get");
+const spy3 = jest.spyOn(spiedTarget, "returnsString", "set");
 
-class TestClass { }
+const spy1Name: string = spy1.getMockName();
 
-describe(TestClass, () => { });
+const spy2Calls: any[][] = spy2.mock.calls;
 
-describe('sum', () => {
-    it('adds 1 + 2 to equal 3', () => {
-        const sum: (a: number, b: number) => number = require('../sum');
-        expect(sum(1, 2)).toBe(3);
-    });
+spy2.mockClear();
+spy2.mockReset();
+
+const spy3Mock: jest.Mock<() => string> = spy3
+    .mockImplementation(() => "")
+    .mockImplementation((arg: {}) => arg)
+    .mockImplementation((...args: string[]) => args.join(""))
+    .mockName("name")
+    .mockReturnThis()
+    .mockReturnValue("value")
+    .mockReturnValueOnce("value")
+    .mockResolvedValue("value")
+    .mockResolvedValueOnce("value")
+    .mockRejectedValue("value")
+    .mockRejectedValueOnce("value");
+
+/* Snapshot serialization */
+
+const snapshotSerializerPlugin: jest.SnapshotSerializerPlugin = {
+    print: () => "",
+    test: () => true,
+};
+
+expect.addSnapshotSerializer(snapshotSerializerPlugin);
+
+expect.addSnapshotSerializer({
+    print: (value: {}) => "",
+    test: (value: {}) => value === value,
 });
 
-describe('restoreAllMocks', () => {
-    afterEach(() => {
-        jest.restoreAllMocks();
-    });
+expect.addSnapshotSerializer({
+    print: (
+        value: {},
+        serialize: ((val: {}) => string),
+        indent: ((str: string) => string),
+        opts: {},
+    ) => "",
+    test: (value: {}) => value === value,
 });
 
-describe('fetchCurrentUser', () => {
-    it('calls the callback when $.ajax requests are finished', () => {
-        const fetchCurrentUser = require('../fetchCurrentUser');
+expect.addSnapshotSerializer({
+    print(value, serialize, indent, opts, colors) {
+        let result = "";
 
-        // Create a mock function for our callback
-        const callback = jest.fn();
-        fetchCurrentUser(callback);
+        if (opts.callToJSON !== undefined && opts.callToJSON) {
+            result += " ";
+        }
 
-        // Now we emulate the process by which `$.ajax` would execute its own
-        // callback
-        $.ajax.mock.calls[0 /*first call*/][0 /*first argument*/].success({
-            firstName: 'Bobby',
-            lastName: '");DROP TABLE Users;--'
-        });
+        result += opts.edgeSpacing;
+        result += opts.spacing;
 
-        // And finally we assert that this emulated call by `$.ajax` incurred a
-        // call back into the mock function we provided as a callback
-        expect(callback.mock.calls[0/*first call*/][0/*first arg*/]).toEqual({
-            loggedIn: true,
-            fullName: 'Bobby ");DROP TABLE Users;--'
-        });
-    });
+        if (opts.escapeRegex !== undefined && opts.escapeRegex) {
+            result += " ";
+        }
+
+        if (opts.indent !== undefined) {
+            for (let i = 0; i < opts.indent; i += 1) {
+                result += "\t";
+            }
+        }
+
+        if (opts.maxDepth !== undefined) {
+            result = result.substring(0, opts.maxDepth);
+        }
+
+        if (opts.min !== undefined && opts.min) {
+            result += " ";
+        }
+
+        if (opts.plugins !== undefined) {
+            for (const plugin of opts.plugins) {
+                expect.addSnapshotSerializer(plugin);
+            }
+        }
+
+        if (opts.printFunctionName !== undefined && opts.printFunctionName) {
+            result += " ";
+        }
+
+        if (opts.theme) {
+            if (opts.theme.comment !== undefined) {
+                result += opts.theme.comment;
+            }
+
+            if (opts.theme.content !== undefined) {
+                result += opts.theme.content;
+            }
+
+            if (opts.theme.prop !== undefined) {
+                result += opts.theme.prop;
+            }
+
+            if (opts.theme.tag !== undefined) {
+                result += opts.theme.tag;
+            }
+
+            if (opts.theme.value !== undefined) {
+                result += opts.theme.value;
+            }
+        }
+
+        for (const color of [
+            colors.comment,
+            colors.content,
+            colors.prop,
+            colors.tag,
+            colors.value,
+        ]) {
+            result += color.open;
+            result += color.close;
+        }
+
+        return result;
+    },
+    test: (value: {}) => value === value,
 });
 
-// unmock is the recommended approach for unmocking...
-jest.unmock('../displayUser.js');
+/* expect extensions */
 
-describe('displayUser', () => {
-    it('displays a user after a click', () => {
-        // Set up our document body
-        document.body.innerHTML =
-            '<div>' +
-            '  <span id="username" />' +
-            '  <button id="button" />' +
-            '</div>';
+const expectExtendMap: jest.ExpectExtendMap = {};
 
-        const displayUser = require.requireActual('../displayUser');
-        const $ = require('jquery');
-        const fetchCurrentUser = require('../fetchCurrentUser');
-
-        // Tell the fetchCurrentUser mock function to automatically invoke
-        // its callback with some data
-        fetchCurrentUser.mockImplementation((cb: (...args: any[]) => any) => {
-            cb({
-                loggedIn: true,
-                fullName: 'Johnny Cash'
-            });
-        });
-
-        // Use jquery to emulate a click on our button
-        $('#button').click();
-
-        // Assert that the fetchCurrentUser function was called, and that the
-        // #username span's innter text was updated as we'd it expect.
-        expect(fetchCurrentUser).toBeCalled();
-        expect($('#username').text()).toEqual('Johnny Cash - Logged In');
-    });
-});
-
-jest.unmock('../CheckboxWithLabel.js');
-describe('CheckboxWithLabel', () => {
-    it('changes the text after click', () => {
-        const React = require('react/addons');
-        const CheckboxWithLabel = require('../CheckboxWithLabel.js');
-        const TestUtils = React.addons.TestUtils;
-
-        // Render a checkbox with label in the document
-        const checkbox = TestUtils.renderIntoDocument(
-            CheckboxWithLabel({
-                    labelOn: "On",
-                    labelOff: "Off"
-                })
-        );
-
-        // Verify that it's Off by default
-        const label = TestUtils.findRenderedDOMComponentWithTag(
-            checkbox, 'label');
-        expect(label.getDOMNode().textContent).toEqual('Off');
-
-        // Simulate a click and verify that it is now On
-        const input = TestUtils.findRenderedDOMComponentWithTag(
-            checkbox, 'input');
-        TestUtils.Simulate.change(input);
-        expect(label.getDOMNode().textContent).toEqual('On');
-    });
-});
-
-jest.runAllTicks();
-xdescribe('Hooks and Suits', () => {
-    let tested: boolean;
-
-    beforeEach(() => {
-        tested = false;
-    });
-
-    afterEach(() => {
-       tested = true;
-    });
-
-    test('tested', () => {
-       expect(tested).toBeTruthy();
-       expect(tested).not.toBeFalsy();
-    });
-
-    fit('tested', () => {
-       expect(tested).toBeDefined();
-       expect(tested).not.toBeUndefined();
-    });
-
-    xit('expect null to be null', () => {
-       expect(null).toBeNull();
-    });
-
-    xit('expect NaN to be NaN', () => {
-       expect(NaN).toBeNaN();
-    });
-});
-
-describe('compartion', () => {
-    const sum: (a: number, b: number) => number = require.requireMock('../sum');
-
-    it('compares is 7 + 2 greater than 3', () => {
-       expect(sum(7, 2)).toBeGreaterThan(3);
-    });
-
-    it('compares is 2 + 7 greater than or equal to 3', () => {
-       expect(sum(2, 7)).toBeGreaterThanOrEqual(3);
-    });
-
-    it('compares is 3 less than 3 + 4', () => {
-       expect(3).toBeLessThan(sum(3, 4));
-    });
-
-    it('compares is 3 less than or equal to 4 + 3', () => {
-       expect(3).toBeLessThanOrEqual(sum(4, 3));
-    });
-
-    it('works sanely with simple decimals', () => {
-        expect(0.2 + 0.1).toBeCloseTo(0.3, 5);
-    });
-
-    it('works sanely with simple decimals and the default delta', () => {
-        expect(0.2 + 0.1).toBeCloseTo(0.3);
-    });
-});
-
-describe('toThrow API', () => {
-   function throwTypeError(): void {
-       throw new TypeError('toThrow Definition was out of date');
-   }
-
-   it('throws', () => {
-      expect(throwTypeError()).toThrow();
-      expect(throwTypeError()).toThrowError();
-   });
-
-   it('throws TypeError', () => {
-       expect(throwTypeError()).toThrow(TypeError);
-       expect(throwTypeError()).toThrowError(TypeError);
-   });
-
-   it('throws \'Definition was out of date\'', () => {
-       expect(throwTypeError()).toThrow(/Definition was out of date/);
-       expect(throwTypeError()).toThrowError(/Definition was out of date/);
-   });
-
-   it('throws \'toThorow Definition was out of date\'', () => {
-       expect(throwTypeError()).toThrow('toThrow Definition was out of date');
-       expect(throwTypeError()).toThrowError('toThrow Definition was out of date');
-   });
-});
-
-describe('Assymetric matchers', () => {
-    it('works', () => {
-        expect({
-            timestamp: 1480807810388,
-            text: 'Some text content, but we care only about *this part*',
-            color: '#bada55',
-            greeting: 'hello, world!',
-        }).toEqual({
-            timestamp: expect.any(Number),
-            text: expect.stringMatching('*this part*'),
-            color: expect.stringMatching(/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i),
-            greeting: expect.stringContaining('hello'),
-        });
-
-        expect("foo").toStrictEqual("foo");
-        expect({ a: "foo" }).toStrictEqual({ a: "foo" });
-
-        const callback = jest.fn();
-        expect(callback).toEqual(expect.any(Function));
-        callback(5, "test");
-        expect(callback).toBeCalledWith(expect.any(Number), expect.any(String));
-        const obj = {
-            items: [1]
+expect.extend(expectExtendMap);
+expect.extend({});
+expect.extend({
+    foo(this: jest.MatcherUtils, received: {}, ...actual: Array<{}>) {
+        return {
+            message: () => JSON.stringify(received),
+            pass: false,
         };
-        expect(obj).toEqual(expect.objectContaining({
-            items: expect.arrayContaining([
-                expect.any(Number)
-            ])
+    }
+});
+
+/* Basic matchers */
+
+describe("", () => {
+    it("", () => {
+        expect(jest.fn()).lastCalledWith();
+        expect(jest.fn()).lastCalledWith("jest");
+        expect(jest.fn()).lastCalledWith({}, {});
+
+        expect(jest.fn()).lastReturnedWith("jest");
+        expect(jest.fn()).lastReturnedWith({});
+
+        expect(jest.fn()).nthReturnedWith(0, "jest");
+        expect(jest.fn()).nthReturnedWith(1, {});
+
+        expect({}).toBe({});
+        expect([]).toBe([]);
+        expect(10).toBe(10);
+
+        expect(jest.fn()).toBeCalled();
+
+        expect(jest.fn()).toBeCalledWith();
+        expect(jest.fn()).toBeCalledWith("jest");
+        expect(jest.fn()).toBeCalledWith({}, {});
+
+        expect(0).toBeCloseTo(1);
+        expect(0).toBeCloseTo(1, 2);
+
+        expect(undefined).toBeDefined();
+        expect({}).toBeDefined();
+
+        expect(true).toBeFalsy();
+        expect(false).toBeFalsy();
+        expect(0).toBeFalsy();
+
+        expect(0).toBeGreaterThan(1);
+
+        expect(0).toBeGreaterThanOrEqual(1);
+
+        expect(3).toBeInstanceOf(Number);
+
+        expect(0).toBeLessThan(1);
+
+        expect(0).toBeLessThanOrEqual(1);
+
+        expect(null).toBeNull();
+        expect(undefined).toBeNull();
+
+        expect(true).toBeTruthy();
+        expect(false).toBeFalsy();
+        expect(1).toBeTruthy();
+
+        expect(undefined).toBeUndefined();
+        expect({}).toBeUndefined();
+
+        expect(NaN).toBeNaN();
+        expect(Infinity).toBeNaN();
+
+        expect([]).toContain({});
+        expect(["abc"]).toContain("abc");
+        expect(["abc"]).toContain("def");
+
+        expect([]).toContainEqual({});
+        expect(["abc"]).toContainEqual("def");
+
+        expect([]).toEqual([]);
+        expect({}).toEqual({});
+
+        expect(jest.fn()).toHaveBeenCalled();
+
+        expect(jest.fn()).toHaveBeenCalledTimes(0);
+        expect(jest.fn()).toHaveBeenCalledTimes(1);
+
+        expect(jest.fn()).toHaveBeenCalledWith();
+        expect(jest.fn()).toHaveBeenCalledWith("jest");
+        expect(jest.fn()).toHaveBeenCalledWith({}, {});
+
+        expect(jest.fn()).toHaveBeenCalledWith(0);
+        expect(jest.fn()).toHaveBeenCalledWith(1, "jest");
+        expect(jest.fn()).toHaveBeenCalledWith(2, {}, {});
+
+        expect(jest.fn()).toHaveBeenLastCalledWith();
+        expect(jest.fn()).toHaveBeenLastCalledWith("jest");
+        expect(jest.fn()).toHaveBeenLastCalledWith({}, {});
+
+        expect(jest.fn()).toHaveLastReturnedWith("jest");
+        expect(jest.fn()).toHaveLastReturnedWith({});
+
+        expect([]).toHaveLength(0);
+        expect("").toHaveLength(1);
+
+        expect(jest.fn()).toHaveNthReturnedWith(0, "jest");
+        expect(jest.fn()).toHaveNthReturnedWith(1, {});
+
+        expect({}).toHaveProperty("property");
+        expect({}).toHaveProperty("property", {});
+        expect({}).toHaveProperty(["property"]);
+        expect({}).toHaveProperty(["property"], {});
+        expect({}).toHaveProperty(["property", "deep"]);
+        expect({}).toHaveProperty(["property", "deep"], {});
+
+        expect(jest.fn()).toHaveReturned();
+
+        expect(jest.fn()).toHaveReturnedTimes(0);
+        expect(jest.fn()).toHaveReturnedTimes(1);
+
+        expect(jest.fn()).toHaveReturnedWith("jest");
+        expect(jest.fn()).toHaveReturnedWith({});
+
+        expect("").toMatch("");
+        expect("").toMatch(/foo/);
+
+        expect({}).toMatchObject({});
+        expect({ abc: "def" }).toMatchObject({ abc: "def" });
+        expect({}).toMatchObject([{}, {}]);
+        expect({ abc: "def" }).toMatchObject([{ abc: "def" }, { invalid: "property" }]);
+
+        expect({}).toMatchSnapshot();
+        expect({}).toMatchSnapshot("snapshotName");
+
+        expect(jest.fn()).toReturn();
+
+        expect(jest.fn()).toReturnTimes(0);
+        expect(jest.fn()).toReturnTimes(1);
+
+        expect(jest.fn()).toReturnWith("jest");
+        expect(jest.fn()).toReturnWith({});
+
+        expect(true).toStrictEqual(false);
+        expect({}).toStrictEqual({});
+
+        expect(() => {}).toThrow();
+        expect(() => { throw new Error(); }).toThrow("");
+        expect(jest.fn()).toThrow(Error);
+        expect(jest.fn(() => { throw new Error(); })).toThrow(/foo/);
+
+        expect(() => {}).toThrowErrorMatchingSnapshot();
+        expect(() => { throw new Error(); }).toThrowErrorMatchingSnapshot();
+        expect(jest.fn()).toThrowErrorMatchingSnapshot();
+        expect(jest.fn(() => { throw new Error(); })).toThrowErrorMatchingSnapshot();
+
+        /* not */
+
+        expect({}).not.toEqual({});
+        expect([]).not.toStrictEqual([]);
+
+        /* Promise matchers */
+
+        expect(Promise.reject("jest")).rejects.toEqual("jest");
+        expect(Promise.reject({})).rejects.toEqual({});
+        expect(Promise.resolve("jest")).rejects.toEqual("jest");
+        expect(Promise.resolve({})).rejects.toEqual({});
+
+        expect(Promise.reject("jest")).resolves.toEqual("jest");
+        expect(Promise.reject({})).resolves.toEqual({});
+        expect(Promise.resolve("jest")).resolves.toEqual("jest");
+        expect(Promise.resolve({})).resolves.toEqual({});
+
+        /* type matchers */
+
+        expect({}).toBe(expect.anything());
+
+        expect({}).toBe(expect.any(class Foo { }));
+        expect(new Error()).toBe(expect.any(Error));
+        expect(7).toBe(expect.any(Number));
+
+        expect({}).toBe(expect.arrayContaining(["a", "b"]));
+        expect(["abc"]).toBe(expect.arrayContaining(["a", "b"]));
+
+        expect.objectContaining({});
+        expect.stringMatching("foo");
+        expect.stringMatching(/foo/);
+        expect.stringContaining("foo");
+
+        expect({ abc: "def" }).toBe(expect.objectContaining({
+            abc: expect.arrayContaining([expect.any(Date), {}]),
+            def: expect.objectContaining({
+                foo: "bar",
+            }),
+            ghi: expect.stringMatching("foo"),
         }));
 
-        expect.assertions(4);
+        /* Miscellaneous */
 
-        interface Test {
-            a: number;
-            b: string;
+        expect.hasAssertions();
+        expect.assertions(0);
+        expect.assertions(9001);
+    });
+});
+
+/* Test framework and config */
+
+const workTestFramework = async (testFramework: jest.TestFramework): Promise<jest.TestResult> => {
+    return testFramework(
+        {
+            bail: true,
+            collectCoverage: false,
+            collectCoverageFrom: ["glob"],
+            collectCoverageOnlyFrom: {
+                abc: true,
+                def: false,
+            },
+            coverageDirectory: "",
+            coverageReporters: [""],
+            coverageThreshold: {
+                global: {
+                    abc: 90,
+                    def: 100,
+                },
+            },
+            expand: true,
+            forceExit: false,
+            logHeapUsage: true,
+            mapCoverage: false,
+            noStackTrace: true,
+            notify: false,
+            projects: ["projects"],
+            replname: "",
+            reporters: [
+                ["abc", {}],
+                ["def", {}],
+            ],
+            rootDir: "path",
+            silent: true,
+            testNamePattern: "",
+            testPathPattern: "",
+            testResultsProcessor: "",
+            updateSnapshot: "all" as "all" | "new" | "none",
+            useStderr: true,
+            verbose: false,
+            watch: true,
+            watchman: false,
+        },
+        {
+            automock: true,
+            browser: false,
+            cache: true,
+            cacheDirectory: "",
+            clearMocks: true,
+            coveragePathIgnorePatterns: [""],
+            cwd: "",
+            detectLeaks: true,
+            displayName: "",
+            forceCoverageMatch: ["abc", "def"],
+            globals: {
+                "ts-jest": {},
+            },
+            haste: {
+                defaultPlatform: "",
+                hasteImplModulePath: "",
+                platforms: ["win95", "win2000", "clippy"],
+                providesModuleNodeModules: ["abc", "def"],
+            },
+            moduleDirectories: ["", ""],
+            moduleFileExtensions: [".ts", ".json"],
+            moduleLoader: "laoder",
+            moduleNameMapper: [
+                ["abc", "def"],
+                ["ghi", "jkl"],
+            ],
+            modulePathIgnorePatterns: ["abc", "def"],
+            modulePaths: ["abc", "def"],
+            name: "",
+            resetMocks: true,
+            resetModules: false,
+            resolver: "",
+            rootDir: "",
+            roots: ["", ""],
+            runner: "",
+            setupFiles: ["abc", "def"],
+            setupTestFrameworkScriptFile: "",
+            skipNodeResolution: true,
+            snapshotSerializers: ["abc", "def"],
+            testEnvironment: "",
+            testEnvironmentOptions: {},
+            testLocationInResults: true,
+            testMatch: [".test.ts"],
+            testPathIgnorePatterns: ["*.spec.*"],
+            testRegex: "abc",
+            testRunner: "m",
+            testURL: "localhost:3000",
+            timers: "real",
+            transform: [
+                ["abc", "def"],
+            ],
+            transformIgnorePatterns: ["", ""],
+            unmockedModulePathPatterns: ["abc"],
+            watchPathIgnorePatterns: ["def"],
+        },
+        {
+            global: {},
+            fakeTimers: {
+                clearAllTimers() { },
+                runAllImmediates() { },
+                runAllTicks() { },
+                runAllTimers() { },
+                runTimersToTime(time: number) { },
+                advanceTimersByTime(time: number) { },
+                runOnlyPendingTimers() { },
+                runWithRealTimers(callback: () => void) {
+                    callback();
+                },
+                useFakeTimers() { },
+                useRealTimers() { },
+            },
+            testFilePath: "",
+            moduleMocker: {},
+            dispose() {},
+            runScript(script: "") {
+                return {};
+            },
+        },
+        {},
+        "testPath"
+    );
+};
+
+/* Jasmine status changers */
+
+describe("", () => {
+    it("", () => {
+        pending();
+        pending("reason");
+
+        fail();
+        fail("error");
+        fail(new Error("reason"));
+        fail({});
+    });
+});
+
+/* Jasmine clocks and timing */
+
+jasmine.DEFAULT_TIMEOUT_INTERVAL = 9001;
+
+const clock = jasmine.clock();
+
+clock.install();
+
+clock.mockDate();
+clock.mockDate(undefined);
+clock.mockDate(new Date());
+
+clock.tick(0);
+clock.tick(9001);
+
+/* Jasmine matchers */
+
+expect({}).toBe(jasmine.anything());
+
+expect({}).toBe(jasmine.any(class Foo { }));
+expect(new Error()).toBe(jasmine.any(Error));
+expect(7).toBe(jasmine.any(Number));
+
+expect({}).toBe(jasmine.arrayContaining(["a", "b"]));
+expect(["abc"]).toBe(jasmine.arrayContaining(["a", "b"]));
+
+jasmine.arrayContaining([]);
+new (jasmine.arrayContaining([]))([]);
+const arrayContained: boolean = jasmine
+    .arrayContaining([])
+    .asymmetricMatch([]);
+const arrayContainedName: string = jasmine
+    .arrayContaining([])
+    .jasmineToString();
+
+jasmine.objectContaining({});
+new (jasmine.objectContaining({}))({});
+const objectContained: boolean = jasmine
+    .objectContaining({})
+    .jasmineMatches({}, ["abc"], ["def"]);
+const objectContainedName: string = jasmine
+    .objectContaining({})
+    .jasmineToString();
+
+jasmine.stringMatching("foo");
+jasmine.stringMatching(/foo/);
+new (jasmine.stringMatching("foo"))({});
+const stringContained: boolean = jasmine
+    .stringMatching(/foo/)
+    .jasmineMatches({});
+const stringContainedName: string = jasmine
+    .stringMatching("foo")
+    .jasmineToString();
+
+expect({ abc: "def" }).toBe(jasmine.objectContaining({
+    abc: jasmine.arrayContaining([jasmine.any(Date), {}]),
+    def: jasmine.objectContaining({
+        foo: "bar",
+    }),
+    ghi: jasmine.stringMatching("foo"),
+}));
+
+/* Jasmine spies */
+
+describe("", () => {
+    it("", () => {
+        let spy = jasmine.createSpy();
+        jasmine.createSpy("name");
+        jasmine.createSpy("name", () => {});
+        jasmine.createSpy("name", (arg: {}) => arg);
+        jasmine.createSpy("name", (...args: string[]) => args.join(""));
+
+        spy = jasmine.createSpy()
+            .and.callFake(() => {})
+            .and.callFake((arg: {}) => arg)
+            .and.callFake((...args: string[]) => args.join(""))
+            .and.callThrough()
+            .and.returnValue("jasmine")
+            .and.returnValue({})
+            .and.returnValues()
+            .and.returnValues("jasmine")
+            .and.returnValues({}, {})
+            .and.stub()
+            .and.throwError("message");
+
+        const identity: string = spy.identity;
+
+        let args: any[];
+        args = spy.mostRecentCall.args;
+        args = spy.argsForCall[0];
+        args = spy.calls.allArgs();
+        args = spy.calls.argsFor(0);
+
+        const spyCalled: boolean = spy.calls.any();
+
+        const wasCalled: boolean = spy.wasCalled;
+
+        for (const call of [
+            ...spy.calls.all(),
+            spy.calls.first(),
+            spy.calls.mostRecent(),
+        ]) {
+            const callType: jasmine.CallInfo = call;
+            const callArgs: any[] = call.args;
+            const { object, returnValue } = call;
         }
 
-        // It's useful to create expected objects before the test call for refactoring purposes
-        // Assymetric matchers must return any in this case to constrain the required type
-        const test: Test = {
-            a: expect.any(Number),
-            b: expect.anything()
+        spy.calls.reset();
+
+        const spyReturn = spy();
+
+        /* Jasmine spy objects */
+
+        let spyObject = {
+            abc() {
+                return "";
+            },
+            def: 7,
         };
-        expect(callback).toHaveBeenCalledWith(test);
+
+        spyObject = jasmine.createSpyObj("baseName", ["abc"]);
+        spyObject = jasmine.createSpyObj<typeof spyObject>("baseName", ["abc"]);
+
+        const newSpyObject: typeof spyObject = jasmine.createSpyObj<typeof spyObject>("baseName", ["abc"]);
     });
 });
 
-describe('setTimeout', () => {
-    it('works as expected', done => {
-        jest.setTimeout(1000);
+/* Jasmine pp */
 
-        setTimeout(() => {
-            expect(true).toBeTruthy();
-            done();
-        }, 900);
-    });
-});
+const pp: string = jasmine.pp({});
 
-describe("spy call matchers", () => {
-    const spy = jest.fn();
+/* Jasmine equality testers */
 
-    expect(spy).lastReturnedWith("foo");
-    expect(spy).nthReturnedWith(3, "foo");
-    expect(spy).toHaveBeenCalled();
-    expect(spy).toHaveBeenCalledTimes(7);
-    expect(spy).toHaveBeenCalledWith("foo");
-    expect(spy).toHaveBeenLastCalledWith("foo");
-    expect(spy).toHaveBeenNthCalledWith(3, "foo");
-    expect(spy).toHaveReturned();
-    expect(spy).toHaveReturnedTimes(7);
-    expect(spy).toHaveReturnedWith("foo");
-    expect(spy).toHaveLastReturnedWith("foo");
-    expect(spy).toHaveNthReturnedWith(3, "foo");
-    expect(spy).toReturn();
-    expect(spy).toReturnTimes(3);
-    expect(spy).toReturnWith("foo");
-});
+const equalityTesterObject = (first: {}, second: {}) => false;
+const equalityTesterString: jasmine.CustomEqualityTester = (first: string, second: string) => first === second;
 
-describe('Extending extend', () => {
-    it('works', () => {
-        expect.extend({
-            toBeNumber(received: any, actual: any) {
-                const pass = received === actual;
-                const message =
-                    () => `expected ${received} ${pass ? 'not ' : ''} to be ${actual}`;
-                return { message, pass };
-            },
-            toBeVariadicMatcher(received: any, floor: number, ceiling: number) {
-                const pass = received >= floor && received <= ceiling;
-                const message =
-                    () => `expected ${received} ${pass ? 'not ' : ''} to be within range ${floor}-${ceiling}`;
-                return { message, pass };
-            },
-            toBeTest(received: any, actual: any) {
-                this.utils.ensureNoExpected(received);
-                this.utils.ensureActualIsNumber(received);
-                this.utils.ensureExpectedIsNumber(actual);
-                this.utils.ensureNumbers(received, actual);
+jasmine.addCustomEqualityTester(equalityTesterObject);
+jasmine.addCustomEqualityTester(equalityTesterObject);
 
-                return {
-                    message: () => `
-                    ${this.utils.getType(received).toLowerCase()} \n\n
-                    ${this.utils.matcherHint(".not.toBe")} ${this.utils.printExpected(actual)} ${this.utils.printReceived(received)}\n\n
-                    `,
-                    pass: true
-                };
-            }
-        });
-    });
-});
-
-describe('missing tests', () => {
-    it('creates closures', () => {
-       class Closure<T> {
-           private arg: T;
-
-           constructor(private readonly fn: (arg: T) => void) {
-               this.fn = fn;
-           }
-
-           bind(arg: T): void {
-               this.arg = arg;
-           }
-
-           call(): void {
-               this.fn(this.arg);
-           }
-       }
-
-       type StringClosure = (arg: string) => void;
-       const spy: jest.Mock<StringClosure> = jest.fn<StringClosure>();
-       const closure: Closure<string> = new Closure<string>(spy);
-       closure.bind('jest');
-       closure.call();
-       expect(spy).lastCalledWith('jest');
-       expect(spy).toBeCalledWith('jest');
-       expect(jest.isMockFunction(spy)).toBeTruthy();
-    });
-
-    it('tests all missing Mocks functionality', () => {
-       type FruitsGetter = () => string[];
-       const mock: jest.Mock<FruitsGetter> = jest.fn<FruitsGetter>();
-       mock.mockImplementationOnce(() => ['Orange', 'Apple', 'Plum']);
-       jest.setMock('./../tesks/getFruits', mock);
-       const getFruits: FruitsGetter = require('./../tesks/getFruits');
-       expect(getFruits()).toContain('Orange');
-       mock.mockReturnValueOnce(['Apple', 'Plum']);
-       expect(mock()).not.toContain('Orange');
-       const myBeverage: any = {delicious: true, sour: false};
-       expect(myBeverage).toContainEqual({delicious: true, sour: false});
-       mock.mockReturnValue([]); // Deprecated: Use jest.fn(() => value) instead.
-       mock.mockClear();
-       const thisMock: jest.Mock<any> = jest.fn<any>().mockReturnThis();
-       expect(thisMock()).toBe(this);
-   });
-
-    it('async test with mockResolvedValue and mockResolvedValueOnce', async () => {
-      const asyncMock = jest
-        .fn()
-        .mockResolvedValue('default')
-        .mockResolvedValueOnce('first call')
-        .mockResolvedValueOnce('second call');
-
-      await asyncMock(); // first call
-      await asyncMock(); // second call
-      await asyncMock(); // default
-      await asyncMock(); // default
-    });
-
-    it('async test with mockRejectedValue', async () => {
-      const asyncMock = jest.fn().mockRejectedValue(new Error('Async error'));
-
-      await asyncMock(); // throws "Async error"
-    });
-
-    it('async test with mockResolvedValueOnce and mockRejectedValueOnce', async () => {
-      const asyncMock = jest
-        .fn()
-        .mockResolvedValueOnce('first call')
-        .mockRejectedValueOnce(new Error('Async error'));
-
-      await asyncMock(); // first call
-      await asyncMock(); // throws "Async error"
-    });
-
-    it('tests mock name functionality', () => {
-        const mock: jest.Mock = jest.fn();
-        mock.mockName('Carrot');
-        expect(mock.getMockName()).toBe('Carrot');
-    });
-
-    it('tests mock name functionality', () => {
-        const mock = spyOn(console, 'warn');
-        expect(mock).toHaveBeenCalled();
-    });
-
-    it('creates snapshoter', () => {
-       jest.disableAutomock().mock('./render', () => jest.fn((): string => "{Link to: \"facebook\"}"), { virtual: true });
-       const render: () => string = require('./render');
-       expect(render()).toMatch(/Link/);
-       jest.enableAutomock();
-    });
-
-    it('runs only pending timers', () => {
-        jest.useRealTimers();
-        setTimeout(() => expect(1).not.toEqual(0), 3000);
-        jest.runOnlyPendingTimers().runTimersToTime(300);
-    });
-
-    it('runs all timers', () => {
-        jest.clearAllTimers();
-        jest.useFakeTimers();
-        setTimeout(() => expect(0).not.toEqual(1), 3000);
-        jest.runAllTimers();
-    });
-
-    it('cleares cache', () => {
-       const sum1 = require('../sum');
-       jest.resetModules();
-       const sum2 = require('../sum');
-       expect(sum1).not.toBe(sum2);
-    });
-});
-
-describe('toMatchSnapshot', () => {
-   it('compares snapshots', () => {
-        expect({ type: 'a', props: { href: 'https://www.facebook.com/' }, children: [ 'Facebook' ] }).toMatchSnapshot();
-    });
-
-   it('can give name to snapshot', () => {
-        expect({ type: 'a', props: { href: 'https://www.facebook.com/' }, children: [ 'Facebook' ] }).toMatchSnapshot('given name');
-   });
-});
-
-describe('toThrowErrorMatchingSnapshot', () => {
-   it('compares snapshots', () => {
-        expect(() => { throw new Error('descriptiton'); }).toThrowErrorMatchingSnapshot();
-    });
-});
-
-const testSerializerPluginString = "set by testSerializerPlugin";
-let testSerializerPluginCallCount = 0;
-expect.addSnapshotSerializer({
-  print(val, serialize, indent, opts, colors) {
-    val.willOverwrite = testSerializerPluginString;
-    testSerializerPluginCallCount += 1;
-    return 'plugin called: ' + serialize(val.willOverwrite);
-  },
-  test(val) {
-    return val && val.willOverwrite && val.willOverwrite !== testSerializerPluginString;
-  },
-});
-describe('addSnapshotSerializer', () => {
-    it('the plugin does its work', () => {
-        testSerializerPluginCallCount = 0;
-        expect({ willOverwrite: { x: 1, y: 2, } }).toMatchSnapshot();
-        expect({ willOverwrite: "this will get overwritten by testSerializerPlugin" }).toMatchSnapshot();
-        expect({ willOverwrite: "so will this" }).toMatchSnapshot();
-        expect({ foo: "this will not" }).toMatchSnapshot();
-        expect(testSerializerPluginCallCount).toBe(3);
-    });
-});
-
-function testInstances() {
-    const mockFn = jest.fn<(...args: any[]) => any>();
-    const a = new mockFn();
-    const b = new mockFn();
-
-    mockFn.mock.instances[0] === a; // true
-    mockFn.mock.instances[1] === b; // true
-}
-
-function testMockImplementation() {
-    const mockFn = jest.fn<(...args: any[]) => any>().mockImplementation((scalar: number): number => {
-        return 42 + scalar;
-    });
-
-    const a = mockFn(0);
-    const b = mockFn(1);
-
-    a === 42; // true
-    b === 43; // true
-
-    mockFn.mock.calls[0][0] === 0; // true
-    mockFn.mock.calls[1][0] === 1; // true
-}
-
-// Test from jest Docs: <http://facebook.github.io/jest/docs/manual-mocks.html#content>
-describe('genMockFromModule', () => {
-   // Interfaces:
-    interface MockFiles {
-        [index: string]: string;
-    }
-
-    interface MockedFS {
-        readdirSync(dir: string): string[];
-        __setMockFiles(newMockFiles: MockFiles): void ;
-    }
-
-    // ------------------------------------------------------------------------------------
-    // FileSummarizer.ts
-
-    const fs = require('fs');
-
-    function summarizeFilesInDirectorySync(directory: string): string[] {
-      return fs.readdirSync(directory).map((fileName: string) => ({
-        fileName,
-        directory,
-      }));
-    }
-
-    // export default summarizeFilesInDirectorySync; // For sake of compilation
-
-    // ------------------------------------------------------------------------------------
-    // __mocks__/fs.js
-
-    const path = require('path');
-
-    const mockedFS: MockedFS = jest.genMockFromModule<MockedFS>('fs');
-
-    let mockFiles: any = Object.create(null);
-    function __setMockFiles(newMockFiles: MockFiles): void {
-      mockFiles = Object.create(null);
-      for (const file in newMockFiles) {
-        const dir: string = path.dirname(file);
-
-        if (!mockFiles[dir]) {
-          mockFiles[dir] = [];
-        }
-        mockFiles[dir].push(path.basename(file));
-      }
-    }
-
-    function readdirSync(directoryPath: string): string[] {
-      return mockFiles[directoryPath] || [];
-    }
-
-    mockedFS.readdirSync = readdirSync;
-    mockedFS.__setMockFiles = __setMockFiles;
-
-    // export = mockedFS; // For sake of compilation
-    // ------------------------------------------------------------------------------------
-    // __tests__/FileSummarizer-test.js
-
-    jest.mock('fs');
-
-    describe('listFilesInDirectorySync', () => {
-      const MOCK_FILE_INFO: MockFiles = {
-        '/path/to/file1.js': 'console.log("file1 contents");',
-        '/path/to/file2.txt': 'file2 contents',
-      };
-
-      beforeEach(() => {
-        // Set up some mocked out file info before each test
-        (require('fs') as MockedFS).__setMockFiles(MOCK_FILE_INFO);
-      });
-
-      it('includes all files in the directory in the summary', () => {
-        const FileSummarizer: (dir: string) => string[] = require('../FileSummarizer');
-        const fileSummary = FileSummarizer('/path/to');
-
-        expect(fileSummary.length).toBe(2);
-      });
-    });
-});
-
-/**
- * Pass strictNullChecks
- */
-describe('strictNullChecks', () => {
-    it('does not complain when using done callback', (done) => {
-        done();
-    });
-});
-
-describe('beforeEach with timeout', () => {
-    beforeEach(() => {
-        // this shouldn't take more than a second
-    }, 1000);
-});
-
-class TestApi {
-    constructor() { }
-    testProp: boolean;
-    private readonly anotherProp: string;
-    testMethod(a: number): string { return ""; }
-}
-
-declare function mockedFunc(a: number): string;
-
-declare function mockedFuncWithApi(api: TestApi): void;
-
-describe('Mocked type', () => {
-    it('Works', () => {
-        const mock: jest.Mocked<TestApi> = new TestApi() as any;
-        mock.testProp;
-        mock.testMethod.mockImplementation(() => 'test');
-        mock.testMethod(5).toUpperCase();
-
-        mockedFuncWithApi(mock);
-    });
-});
-
-describe('Mocks', () => {
-    it('jest.fn() without args is a function type', () => {
-        const test = jest.fn();
-        test();
-        new test();
-        test.mock.instances[0];
-        test.mockImplementation(() => { });
-    });
-
-    it('jest.fn() with returned object infers type', () => {
-        const testMock = jest.fn(() => ({ a: 5, test: jest.fn() }));
-
-        testMock(5, 5, 'a');
-        testMock.mockImplementation(() => { });
-        testMock.caller;
-
-        const ins = new testMock();
-        ins.a;
-        ins.test();
-        ins.test.mockImplementation(() => 5);
-        ins.test.mock.calls;
-
-        const anotherMock = jest.fn(() => {
-            const api: Partial<TestApi> = {
-                testMethod: jest.fn()
-            };
-            return api;
-        });
-        const anotherIns: jest.Mocked<TestApi> = new anotherMock() as any;
-        anotherIns.testMethod.mockImplementation(() => 1);
-    });
-
-    it('jest.fn() accepts constructor arguments', () => {
-        interface TestLog {
-            log(...msg: any[]): void;
-        }
-
-        class LogMock extends jest.fn<TestLog>((verbose?: boolean) => {
-            const mockLog = () => {
-                if (verbose) {
-                    return jest.fn((...args) => {
-                        const subj = args.shift() || "";
-                        console.log(subj, ...args);
-                    });
-                }
-                return jest.fn();
-            };
+/* Jasmine matchers */
 
+const customMatcherFactoriesNone = {};
+const customMatcherFactoriesIndex: { [i: string]: jasmine.CustomMatcherFactory } = {};
+const customMatcherFactoriesManual = {
+    abc: () => ({
+        compare: (actual: "", expected: "", ...args: Array<{}>) => ({
+            pass: true,
+            message: "",
+        }),
+    }),
+    def: (util: jasmine.MatchersUtil, customEqualityTestesr: jasmine.CustomEqualityTester): jasmine.CustomMatcher => ({
+        compare<T extends string>(actual: T, expected: T): jasmine.CustomMatcherResult {
             return {
-                log: mockLog()
+                pass: actual === expected,
+                message: () => "foo",
             };
-        }) {
-        }
+        },
+    }),
+};
 
-        const nonVerboseLog = new LogMock();
-        nonVerboseLog.log("this is completely catched by jest");
-        expect(nonVerboseLog.log).toBeCalledWith("this is completely catched by jest");
-        const verboseLog = new LogMock(true);
-        verboseLog.log("this should also be printed to the console");
-        expect(verboseLog.log).toBeCalledWith("this should also be printed to the console");
-    });
-});
+const matchersUtil1 = {
+    buildFailureMessage: () => "",
+    contains: (haystack: string, needle: string) => haystack.indexOf(needle) !== -1,
+    equals: (a: {}, b: {}) => false,
+};
 
-// https://facebook.github.io/jest/docs/en/expect.html#resolves
-describe('resolves', () => {
-    it('unwraps the expected Promise', () => {
-        const expectation = expect(Promise.resolve('test')).resolves.toEqual('test');
-        expect(expectation instanceof Promise).toBeTruthy();
-        return expectation;
-    });
+let matchersUtil2: jasmine.MatchersUtil = {
+    buildFailureMessage(matcherName: string, isNot: boolean, actual: any, ...expected: any[]): string {
+        return `${matcherName}${isNot ? "1" : "0"}${actual}${expected.join("")}`;
+    },
+    contains<T>(haystack: T[], needle: T, customTesters?: jasmine.CustomEqualityTester[]) {
+        return true;
+    },
+    equals: (a: {}, b: {}, customTesters?: jasmine.CustomEqualityTester[]) => false,
+};
 
-    it('unwraps a .toHaveBeenCalledX', done => {
-        expect.assertions(2);
-
-        const fn = jest.fn();
-        return expect(Promise.resolve(fn)).resolves.toHaveBeenCalledTimes(0).then(val => {
-            expect(val).toEqual(true);
-            done();
-        });
-    });
-
-    it('unwraps a not.toHaveBeenCalledX', done => {
-        expect.assertions(2);
-
-        const fn = jest.fn();
-        return expect(Promise.resolve(fn)).resolves.not.toHaveBeenCalledTimes(1).then(val => {
-            expect(val).toEqual(true);
-            done();
-        });
-    });
-});
-
-// https://facebook.github.io/jest/docs/en/expect.html#rejects
-describe('rejects', () => {
-    it('unwraps the expected Promise', () => {
-        const expectation = expect(Promise.reject(new Error('error'))).rejects.toMatch('error');
-        expect(expectation instanceof Promise).toBeTruthy();
-        return expectation;
-    });
-});
-
-// https://facebook.github.io/jest/docs/en/expect.html#tohavepropertykeypath-value
-describe('toHaveProperty', () => {
-    it('it accepts a keyPath as string', () => {
-        expect({ a: { b: {}}}).toHaveProperty('a');
-    });
-    it('it accepts a keyPath as string with dot notation', () => {
-        expect({ a: { b: {}}}).toHaveProperty('a.b');
-    });
-    it('it accepts a keyPath as an array', () => {
-      expect({ a: { b: {}}}).toHaveProperty(['a', 'b']);
-    });
-    it('it accepts a keyPath as an array containing non-string values', () => {
-      expect({ a: ['b']}).toHaveProperty(['a', 0]);
-    });
-});
-
-class MyTransformer implements jest.Transformer {
-    process(text: string, path: string) {
-        return `
-            // some comments
-            ${text}
-        `;
-    }
-}
-
-class MyReporter implements jest.Reporter {
-    onRunStart() {
-        console.log('hello world');
-    }
-}
-
-declare const testResult: jest.TestResult;
-const myTestRunner: jest.TestFramework = () => Promise.resolve(testResult);
-
-const testResultsProcessor: jest.TestResultsProcessor = result => ({...result, numFailedTests: 1});
-
-// https://github.com/DefinitelyTyped/DefinitelyTyped/issues/18826
-test('moduleName 1', () => {
-    jest.doMock('../moduleName', () => {
-        return jest.fn(() => 1);
-    });
-    const moduleName = require('../moduleName');
-    expect(moduleName()).toEqual(1);
-});
-test('moduleName 2', () => {
-    jest.doMock('../moduleName', () => {
-        return jest.fn(() => 2);
-    });
-    const moduleName = require('../moduleName');
-    expect(moduleName()).toEqual(2);
-});
-
-describe('toHaveBeenNthCalledWith', () => {
-    const fn = jest.fn();
-
-    expect(fn).toHaveBeenNthCalledWith(3, "foo");
-});
+matchersUtil2 = matchersUtil1;

From f15a541f719409e5a49242845885b7876617c8c6 Mon Sep 17 00:00:00 2001
From: Alex <protyagov@gmail.com>
Date: Tue, 12 Jun 2018 14:18:39 -0500
Subject: [PATCH 079/180] Add plotter function per series. It was absent from
 mapping.

---
 types/dygraphs/index.d.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/types/dygraphs/index.d.ts b/types/dygraphs/index.d.ts
index 4a4a9f0492..1e075d7ba9 100644
--- a/types/dygraphs/index.d.ts
+++ b/types/dygraphs/index.d.ts
@@ -21,6 +21,11 @@ declare namespace dygraphs {
          * A per-series color definition. Used in conjunction with, and overrides, the colors option.
          */
         color?: string;
+                
+        /**
+         * A function which plot data for this series on the chart.         
+         */
+        plotter?: any;
 
         /**
          * Draw a small dot at each point, in addition to a line going through the point. This makes

From e628172bc5d322666e6f0837ba1adf7849bb6594 Mon Sep 17 00:00:00 2001
From: Daniel <dcochran@netflix.com>
Date: Tue, 12 Jun 2018 12:34:24 -0700
Subject: [PATCH 080/180] add tests for SuperAgent request

---
 types/superagent/superagent-tests.ts | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/types/superagent/superagent-tests.ts b/types/superagent/superagent-tests.ts
index 66046759f1..46766f8d9e 100644
--- a/types/superagent/superagent-tests.ts
+++ b/types/superagent/superagent-tests.ts
@@ -390,3 +390,18 @@ request
     .then(response => {
         // reads 404 page as a successful response
     });
+
+// Test that the "Plugin" type from "use" provides a SuperAgentRequest rather than a Request,
+// which has additional properties.
+const echoPlugin = (request: request.SuperAgentRequest) => {
+  req.url = '' + req.url;
+  req.cookies = '' + req.cookies;
+  if (req.method) {
+    req.url = '/echo'
+  }
+};
+
+request
+    .get('/echo')
+    .use(echoPlugin)
+    .end();
\ No newline at end of file

From 7bf6b02b0e9a1139967ecb5079eacbe25465a4db Mon Sep 17 00:00:00 2001
From: Daniel <dcochran@netflix.com>
Date: Tue, 12 Jun 2018 12:38:22 -0700
Subject: [PATCH 081/180] add trailing newline

---
 types/superagent/superagent-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/superagent/superagent-tests.ts b/types/superagent/superagent-tests.ts
index 46766f8d9e..b2e00c6698 100644
--- a/types/superagent/superagent-tests.ts
+++ b/types/superagent/superagent-tests.ts
@@ -404,4 +404,4 @@ const echoPlugin = (request: request.SuperAgentRequest) => {
 request
     .get('/echo')
     .use(echoPlugin)
-    .end();
\ No newline at end of file
+    .end();

From da4df7b29d9c47843caa474065c4c9f360c6a295 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20=C5=81aziuk?= <tlaziuk@gmail.com>
Date: Tue, 12 Jun 2018 23:50:05 +0200
Subject: [PATCH 082/180] generateUrls

---
 types/universal-router/generateUrls.d.ts         | 14 ++++++++++++++
 types/universal-router/index.d.ts                |  2 +-
 types/universal-router/tsconfig.json             |  3 ++-
 types/universal-router/universal-router-tests.ts |  9 +++++++++
 4 files changed, 26 insertions(+), 2 deletions(-)
 create mode 100644 types/universal-router/generateUrls.d.ts

diff --git a/types/universal-router/generateUrls.d.ts b/types/universal-router/generateUrls.d.ts
new file mode 100644
index 0000000000..0a31b3d3c6
--- /dev/null
+++ b/types/universal-router/generateUrls.d.ts
@@ -0,0 +1,14 @@
+import UniversalRouter, { Params } from ".";
+
+export interface generateUrlsOptions {
+    /**
+     * Provide a function to stringifyQueryParams option to generate URL with query string from unknown route params.
+     */
+    stringifyQueryParams?: (params: Params) => string;
+    [_: string]: any;
+}
+
+/**
+ * In most web applications it's much simpler to just use a string for hyperlinks.
+ */
+export default function generateUrls(router: UniversalRouter, options?: generateUrlsOptions): (routeName: string, params?: Params) => string;
diff --git a/types/universal-router/index.d.ts b/types/universal-router/index.d.ts
index 66c424d5f0..38f4cec8bd 100644
--- a/types/universal-router/index.d.ts
+++ b/types/universal-router/index.d.ts
@@ -10,7 +10,7 @@
  * Each URL parameter resolves to a string.
  */
 export interface Params {
-    [_: string]: string;
+    [_: string]: any;
 }
 
 /**
diff --git a/types/universal-router/tsconfig.json b/types/universal-router/tsconfig.json
index c83170c372..8ad0ee94ef 100644
--- a/types/universal-router/tsconfig.json
+++ b/types/universal-router/tsconfig.json
@@ -20,6 +20,7 @@
     },
     "files": [
         "index.d.ts",
+        "generateUrls.d.ts",
         "universal-router-tests.ts"
     ]
-}
\ No newline at end of file
+}
diff --git a/types/universal-router/universal-router-tests.ts b/types/universal-router/universal-router-tests.ts
index 0c92dad102..02c79fb062 100644
--- a/types/universal-router/universal-router-tests.ts
+++ b/types/universal-router/universal-router-tests.ts
@@ -1,4 +1,5 @@
 import UniversalRouter from "universal-router";
+import generateUrls from "universal-router/generateUrls";
 
 new UniversalRouter(
     {
@@ -63,3 +64,11 @@ new UniversalRouter({
         },
     ],
 });
+
+const url = generateUrls(new UniversalRouter([
+    { name: 'users', path: '/users' },
+    { name: 'user', path: '/user/:username' },
+], { baseUrl: '/base' }));
+
+url('users'); // => '/base/users'
+url('user', { username: 'john' }); // => '/base/user/john'

From 79c3a025a30bc24824a22d9175f05eb550c25a3f Mon Sep 17 00:00:00 2001
From: Dobes Vandermeer <dobesv@gmail.com>
Date: Tue, 12 Jun 2018 17:14:34 -0700
Subject: [PATCH 083/180] Update generic type of map to reflect variable output
 type

The output type of the contents of the Cursor should match the return type of the mapping function.

See also https://github.com/DefinitelyTyped/DefinitelyTyped/issues/15991
---
 types/mongodb/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/mongodb/index.d.ts b/types/mongodb/index.d.ts
index 98aa2daca8..1ca0c2a8b8 100644
--- a/types/mongodb/index.d.ts
+++ b/types/mongodb/index.d.ts
@@ -1252,7 +1252,7 @@ export class Cursor<T = Default> extends Readable {
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#limit */
     limit(value: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#map */
-    map(transform: Function): Cursor<T>;
+    map<U>(transform: (T) => U ): Cursor<U>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#max */
     max(max: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#maxAwaitTimeMS */

From ee72b6f183410d4bc6850350a1f465c1a9a52213 Mon Sep 17 00:00:00 2001
From: Tim Kendrick <timkendrick@gmail.com>
Date: Wed, 13 Jun 2018 15:31:28 +0100
Subject: [PATCH 084/180] [babel-types] Allow implicit boolean JSXAttribute
 values

---
 types/babel-types/index.d.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/babel-types/index.d.ts b/types/babel-types/index.d.ts
index 47068c3481..c464c4bc3f 100644
--- a/types/babel-types/index.d.ts
+++ b/types/babel-types/index.d.ts
@@ -772,7 +772,7 @@ export interface VoidTypeAnnotation extends Node {
 export interface JSXAttribute extends Node {
     type: "JSXAttribute";
     name: JSXIdentifier | JSXNamespacedName;
-    value: JSXElement | StringLiteral | JSXExpressionContainer;
+    value: JSXElement | StringLiteral | JSXExpressionContainer | null;
 }
 
 export interface JSXClosingElement extends Node {
@@ -1424,7 +1424,7 @@ export function objectTypeProperty(key?: Expression, value?: FlowTypeAnnotation)
 export function qualifiedTypeIdentifier(id?: Identifier, qualification?: Identifier | QualifiedTypeIdentifier): QualifiedTypeIdentifier;
 export function unionTypeAnnotation(types?: FlowTypeAnnotation[]): UnionTypeAnnotation;
 export function voidTypeAnnotation(): VoidTypeAnnotation;
-export function jSXAttribute(name?: JSXIdentifier | JSXNamespacedName, value?: JSXElement | StringLiteral | JSXExpressionContainer): JSXAttribute;
+export function jSXAttribute(name?: JSXIdentifier | JSXNamespacedName, value?: JSXElement | StringLiteral | JSXExpressionContainer | null): JSXAttribute;
 export function jSXClosingElement(name?: JSXIdentifier | JSXMemberExpression): JSXClosingElement;
 export function jSXElement(openingElement?: JSXOpeningElement, closingElement?: JSXClosingElement, children?: Array<JSXElement | JSXExpressionContainer | JSXText>, selfClosing?: boolean): JSXElement;
 export function jSXEmptyExpression(): JSXEmptyExpression;

From cc01b622739263f8871de60503be4a5c83a941ae Mon Sep 17 00:00:00 2001
From: Jose Colella <Jose.Colella@dynatrace.com>
Date: Wed, 13 Jun 2018 10:58:35 -0400
Subject: [PATCH 085/180] Add optional family type to CoreOptions. References
 issue https://github.com/request/request-promise-native/issues/6

---
 types/request/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/request/index.d.ts b/types/request/index.d.ts
index 71f41ff794..f9ee41842b 100644
--- a/types/request/index.d.ts
+++ b/types/request/index.d.ts
@@ -139,6 +139,7 @@ declare namespace request {
         method?: string;
         headers?: Headers;
         body?: any;
+        family?: number;
         followRedirect?: boolean | ((response: http.IncomingMessage) => boolean);
         followAllRedirects?: boolean;
         followOriginalHttpMethod?: boolean;

From 6ee3480792a0df733e2e4bc28a1729c7738a6140 Mon Sep 17 00:00:00 2001
From: Jose Colella <Jose.Colella@dynatrace.com>
Date: Wed, 13 Jun 2018 11:22:18 -0400
Subject: [PATCH 086/180] Add name and github link to definitionsby

---
 types/request/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/request/index.d.ts b/types/request/index.d.ts
index f9ee41842b..51cb7919a7 100644
--- a/types/request/index.d.ts
+++ b/types/request/index.d.ts
@@ -7,6 +7,7 @@
 //                 Christopher Currens <https://github.com/ccurrens>,
 //                 Jon Stevens <https://github.com/lookfirst>,
 //                 Matt R. Wilson <https://github.com/mastermatt>
+//                 Jose Colella <https://github.com/josecolella>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.3
 

From fbc13e7029c8217353ae1b03754bb7b3c2de9022 Mon Sep 17 00:00:00 2001
From: Rafael Tavares <rafael@tavares.email>
Date: Wed, 6 Jun 2018 18:03:05 -0300
Subject: [PATCH 087/180] Updates reCAPTCHA v2 definitions according to the
 docs

---
 types/grecaptcha/grecaptcha-tests.ts |  3 +++
 types/grecaptcha/index.d.ts          | 37 +++++++++++++++++++++-------
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/types/grecaptcha/grecaptcha-tests.ts b/types/grecaptcha/grecaptcha-tests.ts
index f1da1b35b4..288836d6b3 100644
--- a/types/grecaptcha/grecaptcha-tests.ts
+++ b/types/grecaptcha/grecaptcha-tests.ts
@@ -4,8 +4,10 @@ const params: ReCaptchaV2.Parameters = {
   type: "image",
   size: "normal",
   tabindex: 5,
+  isolated: false,
   callback: (response: string) => { },
   "expired-callback": () => { },
+  "error-callback": () => { },
 };
 
 const size1: ReCaptchaV2.Size = "compact";
@@ -25,6 +27,7 @@ const id1: number = grecaptcha.render("foo");
 const id2: number = grecaptcha.render("foo", params);
 const id3: number = grecaptcha.render(document.getElementById("foo"));
 const id4: number = grecaptcha.render(document.getElementById("foo"), params);
+const id5: number = grecaptcha.render(document.getElementById("foo"), params, true);
 
 // response takes a number and returns a string
 const response1: string = grecaptcha.getResponse(id1);
diff --git a/types/grecaptcha/index.d.ts b/types/grecaptcha/index.d.ts
index 067139e6c9..c9dedbfb74 100644
--- a/types/grecaptcha/index.d.ts
+++ b/types/grecaptcha/index.d.ts
@@ -1,19 +1,24 @@
 // Type definitions for Google Recaptcha 2.0
 // Project: https://www.google.com/recaptcha
-// Definitions by: Kristof Mattei <http://kristofmattei.be>, Martin Costello <https://martincostello.com/>, Ruslan Arkhipau <https://github.com/DethAriel>
+// Definitions by: Kristof Mattei <http://kristofmattei.be>
+//                 Martin Costello <https://martincostello.com/>
+//                 Ruslan Arkhipau <https://github.com/DethAriel>
+//                 Rafael Tavares <https://github.com/rafaeltavares>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 declare var grecaptcha: ReCaptchaV2.ReCaptcha;
 
 declare namespace ReCaptchaV2 {
-  class ReCaptcha {
+  interface ReCaptcha {
     /**
      * Renders the container as a reCAPTCHA widget and returns the ID of the newly created widget.
      * @param container The HTML element to render the reCAPTCHA widget. Specify either the ID of the container (string) or the DOM element itself.
      * @param parameters An object containing parameters as key=value pairs, for example, {"sitekey": "your_site_key", "theme": "light"}. See @see render parameters.
+     * @param inherit Invisible reCAPTCHA only. Use existing data-* attributes on the element if the corresponding parameter is not specified.
+     * The values in parameters will take precedence over the attributes.
      * @return the ID of the newly created widget.
      */
-    render(container: (string | HTMLElement), parameters?: Parameters): number;
+    render(container: (string | HTMLElement), parameters?: Parameters, inherit?: boolean): number;
     /**
      * Resets the reCAPTCHA widget.
      * @param opt_widget_id Optional widget ID, defaults to the first widget created if unspecified.
@@ -65,11 +70,6 @@ declare namespace ReCaptchaV2 {
      * If other elements in your page use tabindex, it should be set to make user navigation easier.
      */
     tabindex?: number;
-    /**
-     * Optional. Your callback function that's executed when the user submits a successful CAPTCHA response.
-     * The user's response, g-recaptcha-response, will be the input for your callback function.
-     */
-    callback?(response: string): void;
     /**
      * Optional. The badge location for g-recaptcha with size of "invisible".
      *
@@ -77,10 +77,29 @@ declare namespace ReCaptchaV2 {
      */
     badge?: Badge;
     /**
-     * Optional. Your callback function that's executed when the recaptcha response expires and the user needs to solve a new CAPTCHA.
+     * Optional. Invisible reCAPTCHA only. For plugin owners to not interfere with existing reCAPTCHA installations on a page.
+     * If true, this reCAPTCHA instance will be part of a separate ID space.
+     *
+     * @default false
+     */
+    isolated?: boolean;
+    /**
+     * Optional. Your callback function that's executed when the user submits a successful CAPTCHA response.
+     * The user's response, g-recaptcha-response, will be the input for your callback function.
+     */
+    callback?(response: string): void;
+    /**
+     * Optional. Your callback function that's executed when the reCAPTCHA response expires and the user needs to solve a new CAPTCHA.
      */
     // Notice to the reader
     // I need to surround this object with quotes, this will however break intellisense in VS 2013.
     "expired-callback"?(): void;
+    /**
+     * Optional. Your callback function that's executed when reCAPTCHA encounters an error (usually network connectivity) and cannot continue until connectivity is restored.
+     * If you specify this function, you are responsible for informing the user that they should retry.
+     */
+    // Notice to the reader
+    // I need to surround this object with quotes, this will however break intellisense in VS 2013.
+    "error-callback"?(): void;
   }
 }

From c0bd5b820b81ae7418f8cb3f65297d80ce7c53f2 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Wed, 13 Jun 2018 11:21:16 -0700
Subject: [PATCH 088/180] Adding overload comments

---
 types/office-js/index.d.ts | 179 +++++++++++++++++++++++++++++++++++--
 1 file changed, 171 insertions(+), 8 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index e175d3eb96..b799adcf5f 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -5854,12 +5854,17 @@ declare namespace Office {
          *
          * @remarks
          * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * 
          * Applicable Outlook mode: Compose
+         * 
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * prependAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
          * prependAsync(data: string, callback: (result: AsyncResult) => void): void;
+         * 
          * prependAsync(data: string): void;
          *
          * @param data The string to be inserted at the beginning of the body. The string is limited to 1,000,000 characters.
@@ -5880,7 +5885,9 @@ declare namespace Office {
          *
          * @remarks
          * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadWriteItem
+         * 
          * Applicable Outlook mode: Compose
+         * 
          * Errors: DataExceedsMaximumSize - The data parameter is longer than 1,000,000 characters.
          *
          * @param data The string to be inserted at the beginning of the body. The string is limited to 1,000,000 characters.
@@ -5943,9 +5950,12 @@ declare namespace Office {
          * InvalidFormatError - The options.coercionType parameter is set to Office.CoercionType.Html and the message body is in plain text.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
          * setAsync(data: string, callback: (result: AsyncResult) => void): void;
-         * setAsync(data: string): void;         *
+         * 
+         * setAsync(data: string): void;
          *
          * @param data The string that will replace the existing body. The string is limited to 1,000,000 characters.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -6041,10 +6051,13 @@ declare namespace Office {
          * InvalidFormatError - The options.coercionType parameter is set to Office.CoercionType.Html and the message body is in plain text.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
          * setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
-         * setSelectedDataAsync(data: string): void;         *
-         *         *
+         * 
+         * setSelectedDataAsync(data: string): void;         
+         *         
          * @param data The string that will replace the existing body. The string is limited to 1,000,000 characters.
          * @param options Optional. An object literal that contains one or more of the following properties.
          *        asyncContext: Developers can provide any object they wish to access in the callback method.
@@ -6423,6 +6436,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * getAsync(callback?: (result: AsyncResult) => void): void;
          * 
          * @param options An object literal that contains one or more of the following properties.
@@ -6710,6 +6724,10 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Appointment Organizer
          * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -6731,9 +6749,6 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Appointment Organizer
          * 
-         * In addition to this signature, the method also has the following signatures:
-         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
-         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter, asyncResult, which is an AsyncResult object.
@@ -6779,8 +6794,11 @@ declare namespace Office {
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * addFileAttachmentAsync(uri: string, attachmentName: string): void;
+         * 
          * addFileAttachmentAsync(uri: string, attachmentName: string, options: AsyncContextOptions): void;
+         * 
          * addFileAttachmentAsync(uri: string, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
@@ -6895,8 +6913,11 @@ declare namespace Office {
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * addItemAttachmentAsync(itemId: any, attachmentName: string): void;
+         * 
          * addItemAttachmentAsync(itemId: any, attachmentName: string, options: AsyncContextOptions): void;
+         * 
          * addItemAttachmentAsync(itemId: any, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
@@ -7082,8 +7103,11 @@ declare namespace Office {
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * removeAttachmentAsync(attachmentIndex: string): void;
+         * 
          * removeAttachmentAsync(attachmentIndex: string, options: AsyncContextOptions): void;
+         * 
          * removeAttachmentAsync(attachmentIndex: string, callback: (result: AsyncResult) => void): void;
          *
          * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
@@ -7176,8 +7200,11 @@ declare namespace Office {
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * saveAsync(): void;
+         * 
          * saveAsync(options: AsyncContextOptions): void;
+         * 
          * saveAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -7285,11 +7312,14 @@ declare namespace Office {
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * setSelectedDataAsync(data: string): void;
+         * 
          * setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
          * setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
          *
-        * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
+         * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
          * @param options Optional. An object literal that contains one or more of the following properties.
          *        asyncContext: Developers can provide any object they wish to access in the callback method.
          *        coercionType: If text, the current style is applied in Outlook Web App and Outlook. If the field is an HTML editor, only the text data is inserted, even if the data is HTML. If html and the field supports HTML (the subject doesn't), the current style is applied in Outlook Web App and the default style is applied in Outlook. If the field is a text field, an InvalidDataFormat error is returned. If coercionType is not set, the result depends on the field: if the field is HTML then HTML is used; if the field is text, then plain text is used.
@@ -7624,6 +7654,10 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Appointment Attendee
          * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -8291,6 +8325,10 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Compose or read
          * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -8361,6 +8399,14 @@ declare namespace Office {
          * FileTypeNotSupported - The attachment has an extension that is not allowed.
          *
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string): void;
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string, options: AsyncContextOptions): void;
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
          * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
@@ -8472,6 +8518,14 @@ declare namespace Office {
          * Errors:
          *
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         * 
+         * In addition to the main signature, this method also has these signatures:
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string): void;
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string, options: AsyncContextOptions): void;
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
          * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
@@ -8654,6 +8708,14 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeAttachmentAsync(attachmentIndex: string): void;
+         * 
+         * removeAttachmentAsync(attachmentIndex: string, options: AsyncContextOptions): void;
+         * 
+         * removeAttachmentAsync(attachmentIndex: string, callback: (result: AsyncResult) => void): void;
          *
          * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -8743,6 +8805,14 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * saveAsync(): void;
+         * 
+         * saveAsync(options: AsyncContextOptions): void;
+         * 
+         * saveAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options Optional. An object literal that contains one or more of the following properties.
          *        asyncContext: Developers can provide any object they wish to access in the callback method.
@@ -8847,6 +8917,14 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * setSelectedDataAsync(data: string): void;
+         * 
+         * setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
+         * setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
          *
          * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -9492,6 +9570,10 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Message Compose
          * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -9556,6 +9638,14 @@ declare namespace Office {
          * FileTypeNotSupported - The attachment has an extension that is not allowed.
          *
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string): void;
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string, options: AsyncContextOptions): void;
+         * 
+         * addFileAttachmentAsync(uri: string, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param uri The URI that provides the location of the file to attach to the message or appointment. The maximum length is 2048 characters.
          * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
@@ -9667,6 +9757,14 @@ declare namespace Office {
          * Errors:
          *
          * NumberOfAttachmentsExceeded - The message or appointment has too many attachments.
+         * 
+         * In addition to the main signature, this method also has these signatures:
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string): void;
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string, options: AsyncContextOptions): void;
+         * 
+         * addItemAttachmentAsync(itemId: any, attachmentName: string, callback: (result: AsyncResult) => void): void;
          *
          * @param itemId The Exchange identifier of the item to attach. The maximum length is 100 characters.
          * @param attachmentName The name of the attachment that is shown while the attachment is uploading. The maximum length is 255 characters.
@@ -9849,6 +9947,14 @@ declare namespace Office {
          * Applicable Outlook mode: Message Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeAttachmentAsync(attachmentIndex: string): void;
+         * 
+         * removeAttachmentAsync(attachmentIndex: string, options: AsyncContextOptions): void;
+         * 
+         * removeAttachmentAsync(attachmentIndex: string, callback: (result: AsyncResult) => void): void;
          *
          * @param attachmentIndex The identifier of the attachment to remove. The maximum length of the string is 100 characters.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -9938,6 +10044,14 @@ declare namespace Office {
          * Applicable Outlook mode: Message Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * saveAsync(): void;
+         * 
+         * saveAsync(options: AsyncContextOptions): void;
+         * 
+         * saveAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options Optional. An object literal that contains one or more of the following properties.
          *        asyncContext: Developers can provide any object they wish to access in the callback method.
@@ -10042,6 +10156,14 @@ declare namespace Office {
          * Applicable Outlook mode: Message Compose
          *
          * Errors: InvalidAttachmentId - The attachment identifier does not exist.
+         * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * setSelectedDataAsync(data: string): void;
+         * 
+         * setSelectedDataAsync(data: string, options: AsyncContextOptions & CoercionTypeOptions): void;
+         * 
+         * setSelectedDataAsync(data: string, callback: (result: AsyncResult) => void): void;
          *
          * @param data The data to be inserted. Data is not to exceed 1,000,000 characters. If more than 1,000,000 characters are passed in, an ArgumentOutOfRange exception is thrown.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -10368,6 +10490,10 @@ declare namespace Office {
          *
          * Applicable Outlook mode: Message Read
          * 
+         * In addition to this signature, the method also has the following signatures:
+         * 
+         * removeHandlerAsync(eventType:EventType, handler: any, callback?: (result: AsyncResult) => void): void;
+         * 
          * @param eventType The event that should invoke the handler.
          * @param handler The function to handle the event. The function must accept a single parameter, which is an object literal. The type property on the parameter will match the eventType parameter passed to removeHandlerAsync.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -10538,6 +10664,7 @@ declare namespace Office {
          * Applicable Outlook mode: Message Read
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * getInitializationContextAsync(callback?: (result: AsyncResult) => void): void;
          * 
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -10781,6 +10908,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * getAsync(callback: (result: AsyncResult) => void): void;
          * 
          */
@@ -10820,8 +10948,11 @@ declare namespace Office {
          * Errors: DataExceedsMaximumSize - The location parameter is longer than 255 characters.
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * setAsync(location: string): void;
+         * 
          * setAsync(location: string, options: AsyncContextOptions): void;
+         * 
          * setAsync(location: string, callback: (result: AsyncResult) => void): void;
          */
         setAsync(location: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
@@ -11191,7 +11322,9 @@ declare namespace Office {
          * Applicable Outlook mode: Compose and read
          * 
          * In addition to this signature, the method has the following signature:
+         * 
          * getCallbackTokenAsync(callback: (result: AsyncResult) => void): void;
+         * 
          * getCallbackTokenAsync(callback: (result: AsyncResult) => void, userContext?: any): void;
          *
          * @param options An object literal that contains one or more of the following properties.
@@ -11408,8 +11541,11 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails): void;
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails, options: AsyncContextOptions): void;
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails, callback: (result: AsyncResult) => void): void;
          * 
          */
@@ -11476,6 +11612,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * getAllAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -11507,9 +11644,12 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * removeAsync(key: string): void;
+         * 
          * removeAsync(key: string, options: AsyncContextOptions): void;
-         * removeAsync(key: string, callback: (result: AsyncResult) => void): void;         * 
+         * 
+         * removeAsync(key: string, callback: (result: AsyncResult) => void): void;
          *
          * @param key The key for the notification message to remove.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -11572,8 +11712,11 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * replaceAsync(key: string, JSONmessage: NotificationMessageDetails): void;
+         * 
          * replaceAsync(key: string, JSONmessage: NotificationMessageDetails, options: AsyncContextOptions): void;
+         * 
          * replaceAsync(key: string, JSONmessage: NotificationMessageDetails, callback: (result: AsyncResult) => void): void;
          *
          * @param key The key for the notification message to replace. It can't be longer than 32 characters.
@@ -11691,8 +11834,11 @@ declare namespace Office {
          * Errors: NumberOfRecipientsExceeded - The number of recipients exceeded 100 entries.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * addAsync(recipients: (string | EmailUser | EmailAddressDetails)[]): void;
+         * 
          * addAsync(recipients: (string | EmailUser | EmailAddressDetails)[], options: AsyncContextOptions): void;
+         * 
          * addAsync(recipients: (string | EmailUser | EmailAddressDetails)[], callback: (result: AsyncResult) => void): void;
          *
          * @param recipients The recipients to add to the recipients list.
@@ -11786,6 +11932,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * getAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options An object literal that contains one or more of the following properties.
@@ -11831,8 +11978,11 @@ declare namespace Office {
          * Errors: NumberOfRecipientsExceeded - The number of recipients exceeded 100 entries.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setAsync(recipients: (string | EmailUser | EmailAddressDetails)[]): void;
+         * 
          * setAsync(recipients: (string | EmailUser | EmailAddressDetails)[], options: AsyncContextOptions): void;
+         * 
          * setAsync(recipients: (string | EmailUser | EmailAddressDetails)[], callback: (result: AsyncResult) => void): void;
          *
          * @param recipients The recipients to add to the recipients list.
@@ -12009,6 +12159,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * getAsync(callback?: (result: AsyncResult) => void): void;
          * 
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -12050,6 +12201,7 @@ declare namespace Office {
          * Errors: InvalidEndTime - The appointment end time is before its start time.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setAsync(recurrencePattern: Recurrence, callback?: (result: AsyncResult) => void): void;
          * 
          * @param recurrencePattern A recurrence object.
@@ -12346,6 +12498,7 @@ declare namespace Office {
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setEndDate(date: string): void;
          * Where date is the end date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
          * 
@@ -12382,6 +12535,7 @@ declare namespace Office {
          * Errors: Invalid date format - The date is not in an acceptable format.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setStartDate(date: string): void;
          * Where date is the start date of the recurring appointment series represented in the {@link https://www.iso.org/iso-8601-date-and-time-format.html | ISO 8601} date format: "YYYY-MM-DD".
          *  
@@ -12420,6 +12574,7 @@ declare namespace Office {
          * Errors: Invalid time format - The time is not in an acceptable format.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setStartTime(time: string): void;
          * Where time is the start time of all instances represented by standard datetime string format: "THH:mm:ss:mmm". 
          * 
@@ -12469,6 +12624,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * getAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options An object literal that contains one or more of the following properties.
@@ -12505,8 +12661,11 @@ declare namespace Office {
          * Errors: DataExceedsMaximumSize - The subject parameter is longer than 255 characters.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setAsync(subject: string): void;
+         * 
          * setAsync(subject: string, options: AsyncContextOptions): void;
+         * 
          * setAsync(subject: string, callback: (result: AsyncResult) => void): void;
          *
          * @param subject The subject of the appointment or message. The string is limited to 255 characters.
@@ -12617,6 +12776,7 @@ declare namespace Office {
          * Applicable Outlook mode: Compose
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * getAsync(callback: (result: AsyncResult) => void): void;
          *
          * @param options An object literal that contains one or more of the following properties.
@@ -12656,8 +12816,11 @@ declare namespace Office {
          * Errors: InvalidEndTime - The appointment end time is before the appointment start time.
          * 
          * In addition to the main signature, this method also has these signatures:
+         * 
          * setAsync(dateTime: Date): void;
+         * 
          * setAsync(dateTime: Date, options: AsyncContextOptions): void;
+         * 
          * setAsync(dateTime: Date, callback: (result: AsyncResult) => void): void;
          *
          * @param dateTime A date-time object in Coordinated Universal Time (UTC).

From 4ec0869aef9d3f62b9637bde2ea9f508cac98373 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20=C5=81aziuk?= <tlaziuk@gmail.com>
Date: Wed, 13 Jun 2018 20:24:46 +0200
Subject: [PATCH 089/180] apply requested changes

---
 types/universal-router/generateUrls.d.ts | 5 +++--
 types/universal-router/index.d.ts        | 7 +++++--
 types/universal-router/package.json      | 6 ++++++
 3 files changed, 14 insertions(+), 4 deletions(-)
 create mode 100644 types/universal-router/package.json

diff --git a/types/universal-router/generateUrls.d.ts b/types/universal-router/generateUrls.d.ts
index 0a31b3d3c6..9900a9adca 100644
--- a/types/universal-router/generateUrls.d.ts
+++ b/types/universal-router/generateUrls.d.ts
@@ -1,6 +1,7 @@
 import UniversalRouter, { Params } from ".";
+import { PathFunctionOptions } from 'path-to-regexp';
 
-export interface generateUrlsOptions {
+export interface GenerateUrlsOptions extends PathFunctionOptions {
     /**
      * Provide a function to stringifyQueryParams option to generate URL with query string from unknown route params.
      */
@@ -11,4 +12,4 @@ export interface generateUrlsOptions {
 /**
  * In most web applications it's much simpler to just use a string for hyperlinks.
  */
-export default function generateUrls(router: UniversalRouter, options?: generateUrlsOptions): (routeName: string, params?: Params) => string;
+export default function generateUrls(router: UniversalRouter, options?: GenerateUrlsOptions): (routeName: string, params?: Params) => string;
diff --git a/types/universal-router/index.d.ts b/types/universal-router/index.d.ts
index 38f4cec8bd..c510352338 100644
--- a/types/universal-router/index.d.ts
+++ b/types/universal-router/index.d.ts
@@ -2,9 +2,12 @@
 // Project: https://github.com/kriasoft/universal-router
 // Definitions by: Jack Moore <https://github.com/jtmthf>
 //                 Tomek Łaziuk <https://github.com/tlaziuk>
+//                 Lodin <https://github.com/Lodin>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.3
 
+import pathToRegexp = require('path-to-regexp');
+
 /**
  * Params is a key/value object that represents extracted URL paramters.
  * Each URL parameter resolves to a string.
@@ -56,7 +59,7 @@ export interface ActionContext<C extends Context, R = any> extends PathnameConte
      * An array of keys found in the path, see `path-to-regexp` documentation for details.
      * @see https://github.com/pillarjs/path-to-regexp
      */
-    keys: any;
+    keys: pathToRegexp.Key[];
 }
 
 /**
@@ -114,5 +117,5 @@ export default class UniversalRouter<C extends Context = Context, R = any> {
     /**
      * `path-to-regexp` function
      */
-    static pathToRegexp: any;
+    static pathToRegexp: typeof pathToRegexp;
 }
diff --git a/types/universal-router/package.json b/types/universal-router/package.json
new file mode 100644
index 0000000000..0ab257c45a
--- /dev/null
+++ b/types/universal-router/package.json
@@ -0,0 +1,6 @@
+{
+  "private": true,
+  "dependencies": {
+    "path-to-regexp": "^2.2.0"
+  }
+}

From 1503f0f34dee7e5ac0c6c890f12d1ee07d5f03b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomek=20=C5=81aziuk?= <tlaziuk@gmail.com>
Date: Wed, 13 Jun 2018 20:27:02 +0200
Subject: [PATCH 090/180] remove index prop

---
 types/universal-router/generateUrls.d.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/types/universal-router/generateUrls.d.ts b/types/universal-router/generateUrls.d.ts
index 9900a9adca..620cef3344 100644
--- a/types/universal-router/generateUrls.d.ts
+++ b/types/universal-router/generateUrls.d.ts
@@ -6,7 +6,6 @@ export interface GenerateUrlsOptions extends PathFunctionOptions {
      * Provide a function to stringifyQueryParams option to generate URL with query string from unknown route params.
      */
     stringifyQueryParams?: (params: Params) => string;
-    [_: string]: any;
 }
 
 /**

From 9831f24f344177a787b2fc42ba8e46d5ff59c466 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Wed, 13 Jun 2018 13:24:01 -0700
Subject: [PATCH 091/180] Switching to type rename

---
 types/office-js/index.d.ts | 24 +++---------------------
 1 file changed, 3 insertions(+), 21 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 926b344a88..fc1e5fd974 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -637,24 +637,6 @@ declare namespace Office {
        isSetSupported(name: string, minVersion?: number): boolean;
     }
 
-    /**
-     * The object that is returned when `UI.displayDialogAsync` is called.
-     */
-    interface Dialog {
-        /**
-         * Called from a parent page to close the corresponding dialog box. 
-         */
-        close(): void;
-        /**
-         * Registers an event handler. The two supported events are:
-         *
-         * - DialogMessageReceived. Triggered when the dialog box sends a message to its parent.
-         *
-         * - DialogEventReceived. Triggered when the dialog box has been closed or otherwise unloaded.
-         */
-        addEventHandler(eventType: Office.EventType, handler: Function): void;
-    }
-
     /**
      * Provides options for how a dialog is displayed.
      */
@@ -1048,11 +1030,11 @@ declare namespace Office {
         controlForegroundColor: string;
     }
     /**
-     * Dialog object returned as part of the displayDialogAsync callback. The object exposes methods for registering event handlers and closing the dialog
+     * The object that is returned when `UI.displayDialogAsync` is called.
      */
-    interface DialogHandler {
+    interface Dialog {
         /**
-         * When called from an active add-in dialog, asynchronously closes the dialog.
+         * Called from a parent page to close the corresponding dialog box. 
          */
         close(): void;
         /**

From f3ac309bad9b6df22f5b4f92deb57319b088d0f7 Mon Sep 17 00:00:00 2001
From: jafaircl <jafaircl@me.com>
Date: Wed, 13 Jun 2018 16:29:52 -0400
Subject: [PATCH 092/180] Fix getStatsFor type

getStatsFor is not a DayOfWeek string it is a DateRange string
---
 types/google-adwords-scripts/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/google-adwords-scripts/index.d.ts b/types/google-adwords-scripts/index.d.ts
index 3e64730056..adf58cb4a4 100644
--- a/types/google-adwords-scripts/index.d.ts
+++ b/types/google-adwords-scripts/index.d.ts
@@ -1387,7 +1387,7 @@ interface hasStartAndEndDateBuilder<B> {
 }
 
 interface hasStats {
-    getStatsFor(dateRange: DayOfWeekString): AdWordsStats;
+    getStatsFor(dateRange: DateRange): AdWordsStats;
     getStatsFor(dateFrom: AdWordsDate | string, dateTo: AdWordsDate | string): AdWordsStats;
 }
 

From 5431383a5123bda1b00130b0baf45e47a397032a Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Wed, 13 Jun 2018 13:42:39 -0700
Subject: [PATCH 093/180] Embellishing comment

---
 types/office-js/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index a54b1fdff0..daedd2040d 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -1030,7 +1030,7 @@ declare namespace Office {
         controlForegroundColor: string;
     }
     /**
-     * The object that is returned when `UI.displayDialogAsync` is called.
+     * The object that is returned when `UI.displayDialogAsync` is called. It exposes methods for registering event handlers and closing the dialog.
      */
     interface Dialog {
         /**

From 0fe7605dcf3277c14634d4a97da9a6982109ba1d Mon Sep 17 00:00:00 2001
From: "DESKTOP-1F3J099\\Brad" <bradley.besserman@gmail.com>
Date: Wed, 13 Jun 2018 17:11:07 -0400
Subject: [PATCH 094/180] Fix merge conflicts

---
 types/mathjs/index.d.ts      |  9 +++++++++
 types/mathjs/mathjs-tests.ts | 12 ++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/types/mathjs/index.d.ts b/types/mathjs/index.d.ts
index a09b23bae9..eda68ade10 100644
--- a/types/mathjs/index.d.ts
+++ b/types/mathjs/index.d.ts
@@ -44,6 +44,7 @@ declare namespace math {
         version: string;
 
         expression: MathNode;
+        json: MathJsJson;
 
         /*************************************************************************
          * Core functions
@@ -96,6 +97,7 @@ declare namespace math {
                 | MathArray
                 | Matrix
                 | boolean
+                | Fraction
                 | null
         ): BigNumber;
 
@@ -2941,6 +2943,13 @@ declare namespace math {
         randomSeed?: string;
     }
 
+    interface MathJsJson {
+        /**
+         * Returns reviver function that can be used as reviver in JSON.parse function.
+         */
+        reviver(): (key: any, value: any) => any;
+    }
+
     interface MathJsChain {
         done(): any;
 
diff --git a/types/mathjs/mathjs-tests.ts b/types/mathjs/mathjs-tests.ts
index 4db5261f9f..c1e32a7d9a 100644
--- a/types/mathjs/mathjs-tests.ts
+++ b/types/mathjs/mathjs-tests.ts
@@ -366,3 +366,15 @@ Expression tree examples
 		}
 	});
 }
+
+/*
+JSON serialization/deserialization
+*/
+{
+	const data = {
+		bigNumber: math.bignumber('1.5')
+	};
+	const stringified = JSON.stringify(data);
+	const parsed = JSON.parse(stringified, math.json.reviver);
+	parsed.bigNumber === math.bignumber('1.5'); // true
+}

From 45c696a0df2c1559e828311473f1c8ff4981031a Mon Sep 17 00:00:00 2001
From: Derek Rada <drada@markettrack.com>
Date: Wed, 13 Jun 2018 17:13:16 -0400
Subject: [PATCH 095/180] namespace changes

---
 types/postmark/index.d.ts | 423 +++++++++++++++++++-------------------
 1 file changed, 213 insertions(+), 210 deletions(-)

diff --git a/types/postmark/index.d.ts b/types/postmark/index.d.ts
index 8a054e17e0..2f77040930 100644
--- a/types/postmark/index.d.ts
+++ b/types/postmark/index.d.ts
@@ -2,215 +2,218 @@
 // Project: http://wildbit.github.io/postmark.js
 // Definitions by: Ben Bayard <https://github.com/benbayard>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.3
+// TypeScript Version: 2.4
 
-interface PostmarkError {
-    status: number;
-    message: string;
-    code: number;
+export = Postmark;
+
+declare function Postmark(apiKey: string, options: Partial<Postmark.Options>): Postmark.Client;
+declare namespace Postmark {
+    const defaults: Options;
+
+    interface PostmarkError {
+        status: number;
+        message: string;
+        code: number;
+    }
+
+    interface PostmarkMessageHeader {
+        Name: string;
+        Value: string;
+    }
+
+    interface PostmarkAttachment {
+        Content: string;
+        Name: string;
+        ContentType: string;
+    }
+
+    interface Filter {
+        count: number;
+        offset: number;
+    }
+
+    interface PostmarkMessageWithTemplate {
+        To: string;
+        From: string;
+        Cc?: string;
+        Bcc?: string;
+        ReplyTo?: string;
+        TemplateId?: string;
+        TemplateModel?: any;
+        Tag?: string;
+        Subject?: string;
+        TrackOpens?: boolean;
+        TrackLinks?: string;
+        Headers?: PostmarkMessageHeader[];
+    }
+
+    interface PostmarkMessage {
+        To: string;
+        From: string;
+        Cc?: string;
+        Bcc?: string;
+        ReplyTo?: string;
+        Tag?: string;
+        Subject?: string;
+        HTMLBody?: string;
+        TextBody?: string;
+        TrackOpens?: boolean;
+        TrackLinks?: string;
+        Headers?: PostmarkMessageHeader[];
+        Attachments?: PostmarkAttachment[];
+    }
+
+    interface Sender {
+        Color: string;
+        RawEmailEnabled: boolean;
+        SmtpApiActivated: boolean;
+        DeliveryHookUrl: string;
+        InboundHookUrl: string;
+        BounceHookUrl: boolean;
+        IncludeBounceContentInHook: boolean;
+        OpenHookUrl: boolean;
+        PostFirstOpenOnly: boolean;
+        TrackOpens: boolean;
+        TrackLinks: string;
+        InboundDomain: string;
+        InboundSpamThreshold: number;
+    }
+
+    interface TemplateValidator<T extends object> {
+        Subject: string;
+        HtmlBody: string;
+        TextBody: string;
+        TestRenderModel?: T;
+        InlineCssForHtmlTestRender?: boolean;
+    }
+
+    type PostmarkCallback<T extends object = any> = ((e: PostmarkError, ret: T) => void) | undefined;
+
+    interface SimpleOptions {
+        ssl: boolean;
+        requestHost: string;
+    }
+
+    interface Options extends SimpleOptions {
+        requestFactory(
+            options: SimpleOptions
+        ): (
+            path?: string,
+            type?: string,
+            content?: PostmarkMessage,
+            callback?: PostmarkCallback
+        ) => any;
+    }
+
+    class Client {
+        constructor(serverKey: string, options?: Partial<Options>);
+        send(message: PostmarkMessage, callback: PostmarkCallback): void;
+        sendEmailWithTemplate(
+            message: PostmarkMessageWithTemplate,
+            callback: PostmarkCallback
+        ): void;
+        batch(message: PostmarkMessage[], callback: PostmarkCallback): void;
+        sendEmail(message: PostmarkMessage, callback: PostmarkCallback): void;
+        sendEmailBatch(message: PostmarkMessage[], callback: PostmarkCallback): void;
+        getDeliveryStatistics(callback: PostmarkCallback): void;
+        getBounces(filter: Partial<Filter>, callback: PostmarkCallback): void;
+        getBounce(id: number, callback: PostmarkCallback): void;
+        getBounceDump(id: number, callback: PostmarkCallback): void;
+        activateBounce(id: number, callback: PostmarkCallback): void;
+        getBounceTags(callback: PostmarkCallback): void;
+        getServer(callback: PostmarkCallback): void;
+        editServer<T extends keyof Sender>(options: Pick<Sender, T>, callback: PostmarkCallback): void;
+        getOutboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
+        getOutboundMessageDetails(id: number, callback: PostmarkCallback): void;
+        getMessageOpens(filter: Partial<Filter>, callback: PostmarkCallback): void;
+        getMessageOpensForSingleMessage(id: number, filter: Partial<Filter>, callback: PostmarkCallback): void;
+        getInboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
+        getInboundMessageDetails(id: number, callback: PostmarkCallback): void;
+        bypassBlockedInboundMessage(id: number, callback: PostmarkCallback): void;
+        retryInboundHookForMessage(id: number, callback: PostmarkCallback): void;
+        getOuboundOverview(filter: Partial<Filter>, callback: PostmarkCallback): void;
+        validateTemplate<T extends object>(templateObject: TemplateValidator<T>, callback: PostmarkCallback): void;
+    }
+
+    interface CreateSignature {
+        FromEmail: string;
+        Name: string;
+        ReplyToEmail?: string;
+        ReturnPathDomain?: string;
+    }
+
+    interface CreateServer {
+        Name: string;
+        Color?: string;
+        RawEmailEnabled?: boolean;
+        SmtpApiActivated?: boolean;
+        DeliveryHookUrl?: string;
+        InboundHookUrl?: string;
+        BounceHookUrl?: string;
+        IncludeBounceContentInHook?: boolean;
+        OpenHookUrl?: string;
+        PostFirstOpenOnly?: boolean;
+        TrackOpens?: boolean;
+        TrackLinks?: string;
+        InboundDomain?: string;
+        InboundSpamThreshold?: number;
+    }
+
+    interface CreateDomain {
+        Name: string;
+        ReturnPathDomain?: string;
+    }
+
+    class AdminClient {
+        constructor(apiKey: string, options: Partial<Options>);
+        listSenderSignatures(query: Partial<Filter>, callback: PostmarkCallback): void;
+        createSenderSignature(options: CreateSignature, callback: PostmarkCallback): void;
+        editSenderSignature<T extends keyof CreateSignature>(
+            id: number,
+            options: Partial<Pick<CreateSignature, T>>,
+            callback: PostmarkCallback
+        ): void;
+        deleteSenderSignature(id: number, callback: PostmarkCallback): void;
+        resendSenderSignatureConfirmation(id: number, callback: PostmarkCallback): void;
+        verifySenderSignatureSPF(id: number, callback: PostmarkCallback): void;
+        requestNewDKIMForSenderSignature(id: number, callback: PostmarkCallback): void;
+        getServer(id: number, callback: PostmarkCallback): void;
+        createServer(options: CreateServer, callback: PostmarkCallback): void;
+        editServer<T extends keyof CreateServer>(
+            id: number,
+            options: Pick<CreateServer, T>,
+            callback: PostmarkCallback
+        ): void;
+        deleteServer(id: number, callback: PostmarkCallback): void;
+        listServers(query: Partial<Filter>, callback: PostmarkCallback): void;
+        listDomains(query: Partial<Filter>, callback: PostmarkCallback): void;
+        getDomain(id: number, callback: PostmarkCallback): void;
+        createDomain(
+            options: CreateDomain,
+            callback: PostmarkCallback
+        ): void;
+        editDomain<T extends keyof CreateDomain>(
+            id: number,
+            options: Pick<CreateDomain, T>,
+            callback: PostmarkCallback
+        ): void;
+        deleteDomain(id: number, callback: PostmarkCallback): void;
+        verifyDomainSPF(id: number, callback: PostmarkCallback): void;
+        rotateDKIMForDomain(id: number, callback: PostmarkCallback): void;
+    }
+
+    interface ClientClass {
+        new(serverKey: string, options: Partial<Options>): Client;
+    }
+
+    interface AdminClientClass {
+        new(apiKey: string, options: Partial<Options>): AdminClient;
+    }
+
+    interface Postmark {
+        (apiKey: string, options: Partial<Options>): void;
+        defaults: Options;
+        Client: ClientClass;
+        AdminClient: AdminClientClass;
+    }
 }
-
-interface PostmarkMessageHeader {
-    Name: string;
-    Value: string;
-}
-
-interface PostmarkAttachment {
-    Content: string;
-    Name: string;
-    ContentType: string;
-}
-
-interface Filter {
-    count: number;
-    offset: number;
-}
-
-interface PostmarkMessageWithTemplate {
-    To: string;
-    From: string;
-    Cc?: string;
-    Bcc?: string;
-    ReplyTo?: string;
-    TemplateId?: string;
-    TemplateModel?: any;
-    Tag?: string;
-    Subject?: string;
-    TrackOpens?: boolean;
-    TrackLinks?: string;
-    Headers?: PostmarkMessageHeader[];
-}
-
-interface PostmarkMessage {
-    To: string;
-    From: string;
-    Cc?: string;
-    Bcc?: string;
-    ReplyTo?: string;
-    Tag?: string;
-    Subject?: string;
-    HTMLBody?: string;
-    TextBody?: string;
-    TrackOpens?: boolean;
-    TrackLinks?: string;
-    Headers?: PostmarkMessageHeader[];
-    Attachments?: PostmarkAttachment[];
-}
-
-interface Sender {
-    Color: string;
-    RawEmailEnabled: boolean;
-    SmtpApiActivated: boolean;
-    DeliveryHookUrl: string;
-    InboundHookUrl: string;
-    BounceHookUrl: boolean;
-    IncludeBounceContentInHook: boolean;
-    OpenHookUrl: boolean;
-    PostFirstOpenOnly: boolean;
-    TrackOpens: boolean;
-    TrackLinks: string;
-    InboundDomain: string;
-    InboundSpamThreshold: number;
-}
-
-interface TemplateValidator<T extends object> {
-    Subject: string;
-    HtmlBody: string;
-    TextBody: string;
-    TestRenderModel?: T;
-    InlineCssForHtmlTestRender?: boolean;
-}
-
-type PostmarkCallback<T extends object = any> = ((e: PostmarkError, ret: T) => void) | undefined;
-
-interface SimpleOptions {
-    ssl: boolean;
-    requestHost: string;
-}
-
-interface Options extends SimpleOptions {
-    requestFactory(
-        options: SimpleOptions
-    ): (
-        path?: string,
-        type?: string,
-        content?: PostmarkMessage,
-        callback?: PostmarkCallback
-    ) => any;
-}
-
-declare class Client {
-    constructor(serverKey: string, options?: Partial<Options>);
-    send(message: PostmarkMessage, callback: PostmarkCallback): void;
-    sendEmailWithTemplate(
-        message: PostmarkMessageWithTemplate,
-        callback: PostmarkCallback
-    ): void;
-    batch(message: PostmarkMessage[], callback: PostmarkCallback): void;
-    sendEmail(message: PostmarkMessage, callback: PostmarkCallback): void;
-    sendEmailBatch(message: PostmarkMessage[], callback: PostmarkCallback): void;
-    getDeliveryStatistics(callback: PostmarkCallback): void;
-    getBounces(filter: Partial<Filter>, callback: PostmarkCallback): void;
-    getBounce(id: number, callback: PostmarkCallback): void;
-    getBounceDump(id: number, callback: PostmarkCallback): void;
-    activateBounce(id: number, callback: PostmarkCallback): void;
-    getBounceTags(callback: PostmarkCallback): void;
-    getServer(callback: PostmarkCallback): void;
-    editServer<T extends keyof Sender>(options: Pick<Sender, T>, callback: PostmarkCallback): void;
-    getOutboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
-    getOutboundMessageDetails(id: number, callback: PostmarkCallback): void;
-    getMessageOpens(filter: Partial<Filter>, callback: PostmarkCallback): void;
-    getMessageOpensForSingleMessage(id: number, filter: Partial<Filter>, callback: PostmarkCallback): void;
-    getInboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
-    getInboundMessageDetails(id: number, callback: PostmarkCallback): void;
-    bypassBlockedInboundMessage(id: number, callback: PostmarkCallback): void;
-    retryInboundHookForMessage(id: number, callback: PostmarkCallback): void;
-    getOuboundOverview(filter: Partial<Filter>, callback: PostmarkCallback): void;
-    validateTemplate<T extends object>(templateObject: TemplateValidator<T>, callback: PostmarkCallback): void;
-}
-
-interface CreateSignature {
-    FromEmail: string;
-    Name: string;
-    ReplyToEmail?: string;
-    ReturnPathDomain?: string;
-}
-
-interface CreateServer {
-    Name: string;
-    Color?: string;
-    RawEmailEnabled?: boolean;
-    SmtpApiActivated?: boolean;
-    DeliveryHookUrl?: string;
-    InboundHookUrl?: string;
-    BounceHookUrl?: string;
-    IncludeBounceContentInHook?: boolean;
-    OpenHookUrl?: string;
-    PostFirstOpenOnly?: boolean;
-    TrackOpens?: boolean;
-    TrackLinks?: string;
-    InboundDomain?: string;
-    InboundSpamThreshold?: number;
-}
-
-interface CreateDomain {
-    Name: string;
-    ReturnPathDomain?: string;
-}
-
-declare class AdminClient {
-    constructor(apiKey: string, options: Partial<Options>);
-    listSenderSignatures(query: Partial<Filter>, callback: PostmarkCallback): void;
-    createSenderSignature(options: CreateSignature, callback: PostmarkCallback): void;
-    editSenderSignature<T extends keyof CreateSignature>(
-        id: number,
-        options: Partial<Pick<CreateSignature, T>>,
-        callback: PostmarkCallback
-    ): void;
-    deleteSenderSignature(id: number, callback: PostmarkCallback): void;
-    resendSenderSignatureConfirmation(id: number, callback: PostmarkCallback): void;
-    verifySenderSignatureSPF(id: number, callback: PostmarkCallback): void;
-    requestNewDKIMForSenderSignature(id: number, callback: PostmarkCallback): void;
-    getServer(id: number, callback: PostmarkCallback): void;
-    createServer(options: CreateServer, callback: PostmarkCallback): void;
-    editServer<T extends keyof CreateServer>(
-        id: number,
-        options: Pick<CreateServer, T>,
-        callback: PostmarkCallback
-    ): void;
-    deleteServer(id: number, callback: PostmarkCallback): void;
-    listServers(query: Partial<Filter>, callback: PostmarkCallback): void;
-    listDomains(query: Partial<Filter>, callback: PostmarkCallback): void;
-    getDomain(id: number, callback: PostmarkCallback): void;
-    createDomain(
-        options: CreateDomain,
-        callback: PostmarkCallback
-    ): void;
-    editDomain<T extends keyof CreateDomain>(
-        id: number,
-        options: Pick<CreateDomain, T>,
-        callback: PostmarkCallback
-    ): void;
-    deleteDomain(id: number, callback: PostmarkCallback): void;
-    verifyDomainSPF(id: number, callback: PostmarkCallback): void;
-    rotateDKIMForDomain(id: number, callback: PostmarkCallback): void;
-}
-
-interface ClientClass {
-    new(serverKey: string, options: Partial<Options>): Client;
-}
-
-interface AdminClientClass {
-    new(apiKey: string, options: Partial<Options>): AdminClient;
-}
-
-interface Postmark {
-    (apiKey: string, options: Partial<Options>): void;
-    defaults: Options;
-    Client: ClientClass;
-    AdminClient: AdminClientClass;
-}
-
-declare var postmark: Postmark;
-
-export = postmark;

From 5c62309e20701f3f33321921c69255dd79cce37b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Piotr=20=C5=81uczak?= <lukasz.luczak@onet.pl>
Date: Wed, 13 Jun 2018 23:33:08 +0200
Subject: [PATCH 096/180] [express-socket.io-session] Added "session" and
 "sessionID" to SocketIO.Socket.handshake

---
 .../express-socket.io-session-tests.ts        | 16 ++++
 types/express-socket.io-session/index.d.ts    |  7 ++
 types/socket.io/index.d.ts                    | 89 ++++++++++---------
 3 files changed, 68 insertions(+), 44 deletions(-)

diff --git a/types/express-socket.io-session/express-socket.io-session-tests.ts b/types/express-socket.io-session/express-socket.io-session-tests.ts
index 46dd000882..6937952dd6 100644
--- a/types/express-socket.io-session/express-socket.io-session-tests.ts
+++ b/types/express-socket.io-session/express-socket.io-session-tests.ts
@@ -26,3 +26,19 @@ io.use(sharedsession(session));
 io.use(sharedsession(session, { autoSave: true, saveUninitialized: true }));
 io.use(sharedsession(session, cookieParser));
 io.use(sharedsession(session, cookieParser, { autoSave: true, saveUninitialized: true }));
+
+io.on('connection', (socket) => {
+    const sessionID = [
+        socket.handshake.sessionID,
+        socket.handshake.session!.id
+    ];
+    const sessionData = [
+        socket.handshake.session!['sessionEntry'],
+        socket.handshake.session!.anotherSessionEntry
+    ];
+    socket.handshake.session!.touch(() => {});
+    socket.handshake.session!.regenerate(() => {});
+    socket.handshake.session!.save(() => {});
+    socket.handshake.session!.reload(() => {});
+    socket.handshake.session!.destroy(() => {});
+});
diff --git a/types/express-socket.io-session/index.d.ts b/types/express-socket.io-session/index.d.ts
index 39a1fb4ff6..07acac556a 100644
--- a/types/express-socket.io-session/index.d.ts
+++ b/types/express-socket.io-session/index.d.ts
@@ -7,6 +7,13 @@
 import socketio = require('socket.io');
 import express = require('express');
 
+declare module "socket.io" {
+    interface Handshake {
+        session?: Express.Session;
+        sessionID?: string;
+    }
+}
+
 declare function sharedsession(
     expressSessionMiddleware: express.RequestHandler,
     cookieParserMiddleware: express.RequestHandler,
diff --git a/types/socket.io/index.d.ts b/types/socket.io/index.d.ts
index 6f7c0ef321..4d6adc529c 100644
--- a/types/socket.io/index.d.ts
+++ b/types/socket.io/index.d.ts
@@ -553,49 +553,7 @@ declare namespace SocketIO {
 		/**
 		 * The object used when negociating the handshake
 		 */
-		handshake: {
-			/**
-			 * The headers passed along with the request. e.g. 'host',
-			 * 'connection', 'accept', 'referer', 'cookie'
-			 */
-			headers: any;
-
-			/**
-			 * The current time, as a string
-			 */
-			time: string;
-
-			/**
-			 * The remote address of the connection request
-			 */
-			address: string;
-
-			/**
-			 * Is this a cross-domain request?
-			 */
-			xdomain: boolean;
-
-			/**
-			 * Is this a secure request?
-			 */
-			secure: boolean;
-
-			/**
-			 * The timestamp for when this was issued
-			 */
-			issued: number;
-
-			/**
-			 * The request url
-			 */
-			url: string;
-
-			/**
-			 * Any query string parameters in the request url
-			 */
-			query: any;
-		};
-
+		handshake: Handshake;
 		/**
 		 * Sets the 'json' flag when emitting an event
 		 */
@@ -629,7 +587,7 @@ declare namespace SocketIO {
 
 		/**
 		 * Registers a middleware, which is a function that gets executed for every incoming Packet and receives as parameter the packet and a function to optionally defer execution to the next registered middleware.
-		 * 
+		 *
 		 * Errors passed to middleware callbacks are sent as special error packets to clients.
 		 */
 		use( fn: ( packet: Packet, next: (err?: any) => void ) => void ): Socket;
@@ -690,6 +648,49 @@ declare namespace SocketIO {
 		compress( compress: boolean ): Socket;
 	}
 
+	interface Handshake {
+		/**
+		 * The headers passed along with the request. e.g. 'host',
+		 * 'connection', 'accept', 'referer', 'cookie'
+		 */
+		headers: any;
+
+		/**
+		 * The current time, as a string
+		 */
+		time: string;
+
+		/**
+		 * The remote address of the connection request
+		 */
+		address: string;
+
+		/**
+		 * Is this a cross-domain request?
+		 */
+		xdomain: boolean;
+
+		/**
+		 * Is this a secure request?
+		 */
+		secure: boolean;
+
+		/**
+		 * The timestamp for when this was issued
+		 */
+		issued: number;
+
+		/**
+		 * The request url
+		 */
+		url: string;
+
+		/**
+		 * Any query string parameters in the request url
+		 */
+		query: any;
+	}
+
 	/**
 	 * The interface used when dealing with rooms etc
 	 */

From bdc48075dce41a2bf857068430a6f5885f431bca Mon Sep 17 00:00:00 2001
From: Joshua Goldberg <josh@fullscreenmario.com>
Date: Wed, 13 Jun 2018 14:42:30 -0700
Subject: [PATCH 097/180] Added tests for YouTube typings

---
 types/youtube/tsconfig.json    |   3 +-
 types/youtube/youtube-tests.ts | 282 +++++++++++++++++++++++++++++++++
 2 files changed, 284 insertions(+), 1 deletion(-)
 create mode 100644 types/youtube/youtube-tests.ts

diff --git a/types/youtube/tsconfig.json b/types/youtube/tsconfig.json
index 82e6284376..e263b7845c 100644
--- a/types/youtube/tsconfig.json
+++ b/types/youtube/tsconfig.json
@@ -18,6 +18,7 @@
         "forceConsistentCasingInFileNames": true
     },
     "files": [
-        "index.d.ts"
+        "index.d.ts",
+        "youtube-tests.ts"
     ]
 }
\ No newline at end of file
diff --git a/types/youtube/youtube-tests.ts b/types/youtube/youtube-tests.ts
new file mode 100644
index 0000000000..6452d720db
--- /dev/null
+++ b/types/youtube/youtube-tests.ts
@@ -0,0 +1,282 @@
+const players: YT.Player[] = [
+    new YT.Player(document.body, {}),
+    new YT.Player(document.body, {
+        width: 100,
+        height: 100,
+    }),
+    new YT.Player("id", {
+        width: "100%",
+        height: "100%",
+        videoId: "videoId",
+        playerVars: {},
+        events: {},
+    }),
+    new YT.Player("id", {
+        playerVars: {
+            autohide: YT.AutoHide.AlwaysVisible,
+            autoplay: YT.AutoPlay.AutoPlay,
+            cc_load_policy: YT.ClosedCaptionsLoadPolicy.ForceOn,
+            color: "red",
+            controls: YT.Controls.Hide,
+            disablekb: YT.KeyboardControls.Disable,
+            enablejsapi: YT.JsApi.Disable,
+            end: 9001,
+            fs: YT.FullscreenButton.Hide,
+            hl: "en-us",
+            iv_load_policy: YT.IvLoadPolicy.Hide,
+            list: "my query",
+            listType: "search",
+            loop: YT.Loop.Loop,
+            modestbranding: YT.ModestBranding.Full,
+            origin: "localhost",
+            playlist: "1,2",
+            playsinline: YT.PlaysInline.Fullscreen,
+            rel: YT.RelatedVideos.Hide,
+            showinfo: YT.ShowInfo.Hide,
+            start: 0,
+        },
+    }),
+    new YT.Player("id", {
+        events: {
+            onReady(event: YT.PlayerEvent) {
+                const targetPlayer: YT.Player = event.target;
+            },
+            onStateChange(event: YT.OnStateChangeEvent) {
+                const targetPlayer: YT.Player = event.target;
+                const playerData: YT.PlayerState = event.data;
+            },
+            onPlaybackQualityChange(event: YT.OnPlaybackQualityChangeEvent) {
+                const targetPlayer: YT.Player = event.target;
+                const newQuality: string = event.data;
+            },
+            onPlaybackRateChange(event: YT.OnPlaybackRateChangeEvent) {
+                const targetPlayer: YT.Player = event.target;
+                const newRate: number = event.data;
+            },
+            onError(event: YT.OnErrorEvent) {
+                const targetPlayer: YT.Player = event.target;
+                const error: YT.PlayerError = event.data;
+            },
+            onApiChange(event: YT.PlayerEvent) {
+                const targetPlayer: YT.Player = event.target;
+            },
+        }
+    }),
+];
+
+const ensureNumeric = <TValue extends number>() => {};
+
+ensureNumeric<YT.PlayerState>();
+ensureNumeric<YT.PlayerError>();
+ensureNumeric<YT.AutoHide>();
+ensureNumeric<YT.AutoPlay>();
+ensureNumeric<YT.ClosedCaptionsLoadPolicy>();
+ensureNumeric<YT.Controls>();
+ensureNumeric<YT.KeyboardControls>();
+ensureNumeric<YT.JsApi>();
+ensureNumeric<YT.FullscreenButton>();
+ensureNumeric<YT.IvLoadPolicy>();
+ensureNumeric<YT.Loop>();
+ensureNumeric<YT.ModestBranding>();
+ensureNumeric<YT.PlaysInline>();
+ensureNumeric<YT.RelatedVideos>();
+ensureNumeric<YT.ShowInfo>();
+
+const ensureString = <TValue extends string>() => {}
+
+ensureString<YT.ProgressBarColor>();
+ensureString<YT.ListType>();
+ensureString<YT.ListTypePlayer>();
+ensureString<YT.ListTypeSearch>();
+ensureString<YT.ListTypeUserUploads>();
+ensureString<YT.SuggestedVideoQuality>();
+
+const player = new YT.Player("", {});
+
+player.cueVideoById("id");
+player.cueVideoById("id", 0);
+player.cueVideoById("id", 9001, "default");
+player.cueVideoById("id", 9001, "small");
+
+player.cueVideoById({
+    videoId: "id",
+});
+
+player.cueVideoById({
+    startSeconds: 0,
+    endSeconds: 9001,
+    suggestedQuality: "highres",
+    videoId: "id",
+});
+
+player.loadVideoById("id");
+player.loadVideoById("id", 0);
+player.loadVideoById("id", 0, "medium");
+player.loadVideoById("id", 0, "large");
+
+player.loadVideoById({
+    videoId: "id",
+});
+
+player.loadVideoById({
+    endSeconds: 9001,
+    startSeconds: 0,
+    suggestedQuality: "hd720",
+    videoId: "id",
+});
+
+player.cueVideoByUrl("url");
+player.cueVideoByUrl("url", 0);
+player.cueVideoByUrl("url", 0, "hd1080");
+player.cueVideoByUrl("url", 0, "highres");
+
+player.cueVideoByUrl({
+    mediaContentUrl: "url",
+});
+
+player.cueVideoByUrl({
+    endSeconds: 9001,
+    mediaContentUrl: "url",
+    startSeconds: 0,
+    suggestedQuality: "hd720",
+});
+
+player.loadVideoByUrl("url");
+player.loadVideoByUrl("url", 0);
+player.loadVideoByUrl("url", 0, "hd1080");
+player.loadVideoByUrl("url", 0, "highres");
+
+player.loadVideoByUrl({
+    mediaContentUrl: "url",
+});
+
+player.loadVideoByUrl({
+    endSeconds: 9001,
+    mediaContentUrl: "url",
+    startSeconds: 0,
+    suggestedQuality: "hd720",
+});
+
+player.cuePlaylist(["play", "list"]);
+player.cuePlaylist(["play", "list"], 7);
+player.cuePlaylist(["play", "list"], 7, 0);
+player.cuePlaylist(["play", "list"], 7, 0, "default");
+
+player.cuePlaylist({
+    list: "playlist",
+    listType: "player",
+});
+
+player.cuePlaylist({
+    index: 7,
+    list: "playlist",
+    listType: "search",
+});
+
+player.cuePlaylist({
+    endSeconds: 9001,
+    index: 7,
+    list: "playlist",
+    listType: "search",
+    startSeconds: 0,
+    suggestedQuality: "hd720",
+});
+
+player.loadPlaylist(["play", "list"]);
+player.loadPlaylist(["play", "list"], 7);
+player.loadPlaylist(["play", "list"], 7, 0);
+player.loadPlaylist(["play", "list"], 7, 0, "default");
+
+player.loadPlaylist({
+    list: "playlist",
+    listType: "player",
+});
+
+player.loadPlaylist({
+    index: 7,
+    listType: "search",
+    list: "playlist",
+});
+
+player.loadPlaylist({
+    endSeconds: 9001,
+    index: 7,
+    listType: "search",
+    list: "playlist",
+    startSeconds: 0,
+    suggestedQuality: "hd720",
+});
+
+player.playVideo();
+
+player.pauseVideo();
+
+player.stopVideo();
+
+player.seekTo(9001, true);
+
+player.nextVideo();
+
+player.previousVideo();
+
+player.playVideoAt(0);
+
+player.mute();
+
+player.unMute();
+
+const muted: boolean = player.isMuted();
+
+player.setVolume(49);
+
+const volume: number = player.getVolume();
+
+player.setSize(350, 490);
+
+const playbackRate: number = player.getPlaybackRate();
+
+player.setPlaybackRate(2);
+
+const playbackRates: number[] = player.getAvailablePlaybackRates();
+
+player.setLoop(true);
+
+player.setShuffle(false);
+
+const fraction: number = player.getVideoLoadedFraction();
+
+const state: YT.PlayerState = player.getPlayerState();
+
+const time: number = player.getCurrentTime();
+
+const quality: YT.SuggestedVideoQuality = player.getPlaybackQuality();
+
+player.setPlaybackQuality(quality);
+player.setPlaybackQuality("medium");
+
+const qualities: YT.SuggestedVideoQuality[] = player.getAvailableQualityLevels();
+
+for (const quality of player.getAvailableQualityLevels()) {
+    player.setPlaybackQuality(quality)
+}
+
+const duration: number = player.getDuration();
+
+const videoUrl: string = player.getVideoUrl();
+
+const videoEmbed: string = player.getVideoEmbedCode();
+
+const playlist: string[] = player.getPlaylist();
+
+const playlistIndex: number = player.getPlaylistIndex();
+
+player.addEventListener("onReady", (event: YT.PlayerEvent) => {});
+player.addEventListener("onStateChange", (event: YT.OnStateChangeEvent) => {});
+player.addEventListener("onPlaybackQualityChange", (event: YT.OnPlaybackQualityChangeEvent) => {});
+player.addEventListener("onPlaybackRateChange", (event: YT.OnPlaybackRateChangeEvent) => {});
+player.addEventListener("onError", (event: YT.OnErrorEvent) => {});
+player.addEventListener("onApiChange", (event: YT.PlayerEvent) => {});
+
+const frame: HTMLIFrameElement = player.getIframe();
+
+player.destroy();

From 42b5630be7becf7239d85cde8d594875d49f5894 Mon Sep 17 00:00:00 2001
From: Dobes Vandermeer <dobesv@gmail.com>
Date: Wed, 13 Jun 2018 16:10:19 -0700
Subject: [PATCH 098/180] Remove extra whitespace

---
 types/mongodb/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/mongodb/index.d.ts b/types/mongodb/index.d.ts
index 1ca0c2a8b8..273a0716b2 100644
--- a/types/mongodb/index.d.ts
+++ b/types/mongodb/index.d.ts
@@ -1252,7 +1252,7 @@ export class Cursor<T = Default> extends Readable {
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#limit */
     limit(value: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#map */
-    map<U>(transform: (T) => U ): Cursor<U>;
+    map<U>(transform: (T) => U): Cursor<U>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#max */
     max(max: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#maxAwaitTimeMS */

From 4c9107b6880e9511d1b56240bf3b7e48b504d433 Mon Sep 17 00:00:00 2001
From: Jinwoo Lee <jinwoo@google.com>
Date: Wed, 13 Jun 2018 17:12:02 -0700
Subject: [PATCH 099/180] [cosmiconfig] fix wrong "export default"

cosmiconfig is not a ES6 module and doesn't have an "export
default". Having "export default" in the type definition breaks when a
client project doesn't use --esModuleInterop.

See https://github.com/davidtheclark/cosmiconfig/blob/master/src/index.js#L8

Client code must use "import cosmiconfig = require('cosmiconfig')" form.
---
 types/cosmiconfig/cosmiconfig-tests.ts |  3 +-
 types/cosmiconfig/index.d.ts           | 98 ++++++++++++++------------
 2 files changed, 53 insertions(+), 48 deletions(-)

diff --git a/types/cosmiconfig/cosmiconfig-tests.ts b/types/cosmiconfig/cosmiconfig-tests.ts
index c477eedb3e..f25337f3d3 100644
--- a/types/cosmiconfig/cosmiconfig-tests.ts
+++ b/types/cosmiconfig/cosmiconfig-tests.ts
@@ -1,4 +1,5 @@
-import cosmiconfig, { CosmiconfigResult } from "cosmiconfig";
+import cosmiconfig = require("cosmiconfig");
+import { CosmiconfigResult } from "cosmiconfig";
 import * as path from "path";
 
 const explorer = cosmiconfig("yourModuleName", {
diff --git a/types/cosmiconfig/index.d.ts b/types/cosmiconfig/index.d.ts
index 16ba1967f3..3a70e98511 100644
--- a/types/cosmiconfig/index.d.ts
+++ b/types/cosmiconfig/index.d.ts
@@ -8,52 +8,56 @@
 
 /// <reference types="node" />
 
-export interface Config {
-  [key: string]: any;
+declare function cosmiconfig(moduleName: string, options?: cosmiconfig.ExplorerOptions): cosmiconfig.Explorer;
+
+declare namespace cosmiconfig {
+  interface Config {
+    [key: string]: any;
+  }
+
+  type CosmiconfigResult = {
+    config: Config;
+    filepath: string;
+    isEmpty?: boolean;
+  } | null;
+
+  interface LoaderResult {
+    config: Config | null;
+    filepath: string;
+  }
+
+  type SyncLoader = (filepath: string, content: string) => Config | null;
+  type AsyncLoader = (filepath: string, content: string) => Config | null | Promise<object | null>;
+
+  interface LoaderEntry {
+    sync?: SyncLoader;
+    async?: AsyncLoader;
+  }
+
+  interface Loaders {
+    [key: string]: LoaderEntry;
+  }
+
+  interface Explorer {
+    search(searchFrom?: string): Promise<null | CosmiconfigResult>;
+    searchSync(searchFrom?: string): null | CosmiconfigResult;
+    load(loadPath: string): Promise<CosmiconfigResult>;
+    loadSync(loadPath: string): CosmiconfigResult;
+    clearLoadCache(): void;
+    clearSearchCache(): void;
+    clearCaches(): void;
+  }
+
+  // These are the user options with defaults applied.
+  interface ExplorerOptions {
+    stopDir?: string;
+    cache?: boolean;
+    transform?: (result: CosmiconfigResult) => Promise<CosmiconfigResult> | CosmiconfigResult;
+    packageProp?: string;
+    loaders?: Loaders;
+    searchPlaces?: string[];
+    ignoreEmptySearchPlaces?: boolean;
+  }
 }
 
-export type CosmiconfigResult = {
-  config: Config;
-  filepath: string;
-  isEmpty?: boolean;
-} | null;
-
-export interface LoaderResult {
-  config: Config | null;
-  filepath: string;
-}
-
-export type SyncLoader = (filepath: string, content: string) => Config | null;
-export type AsyncLoader = (filepath: string, content: string) => Config | null | Promise<object | null>;
-
-export interface LoaderEntry {
-  sync?: SyncLoader;
-  async?: AsyncLoader;
-}
-
-export interface Loaders {
-  [key: string]: LoaderEntry;
-}
-
-export interface Explorer {
-  search(searchFrom?: string): Promise<null | CosmiconfigResult>;
-  searchSync(searchFrom?: string): null | CosmiconfigResult;
-  load(loadPath: string): Promise<CosmiconfigResult>;
-  loadSync(loadPath: string): CosmiconfigResult;
-  clearLoadCache(): void;
-  clearSearchCache(): void;
-  clearCaches(): void;
-}
-
-// These are the user options with defaults applied.
-export interface ExplorerOptions {
-  stopDir?: string;
-  cache?: boolean;
-  transform?: (result: CosmiconfigResult) => Promise<CosmiconfigResult> | CosmiconfigResult;
-  packageProp?: string;
-  loaders?: Loaders;
-  searchPlaces?: string[];
-  ignoreEmptySearchPlaces?: boolean;
-}
-
-export default function cosmiconfig(moduleName: string, options?: ExplorerOptions): Explorer;
+export = cosmiconfig;

From ba5a3703e808997d4ed9d3e5379aa4b8fda6d666 Mon Sep 17 00:00:00 2001
From: Tina Roh <tinaroh@gmail.com>
Date: Wed, 13 Jun 2018 17:53:55 -0700
Subject: [PATCH 100/180] Fix Expo v27 Constants

---
 types/expo/index.d.ts | 31 ++++++++++++++++++++++++++-----
 1 file changed, 26 insertions(+), 5 deletions(-)

diff --git a/types/expo/index.d.ts b/types/expo/index.d.ts
index 048d7b884d..d20b5ec87b 100644
--- a/types/expo/index.d.ts
+++ b/types/expo/index.d.ts
@@ -8,6 +8,7 @@
 //                 Umidbek Karimov <https://github.com/umidbekkarimov>
 //                 Moshe Feuchtwanger <https://github.com/moshfeu>
 //                 Michael Prokopchuk <https://github.com/prokopcm>
+//                 Tina Roh <https://github.com/tinaroh>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.6
 
@@ -789,11 +790,31 @@ export interface CameraProps extends ViewProps {
 }
 
 export interface CameraConstants {
-    readonly Type: string;
-    readonly FlashMode: string;
-    readonly AutoFocus: string;
-    readonly WhiteBalance: string;
-    readonly VideoQuality: string;
+    readonly Type: {
+        back: string;
+        front: string;
+    };
+    readonly FlashMode: {
+        on: string;
+        off: string;
+        auto: string;
+        torch: string;
+    };
+    readonly AutoFocus: {
+        on: string;
+        off: string;
+    };
+    readonly WhiteBalance: {
+        auto: string;
+        sunny: string;
+        cloudy: string;
+        shadow: string;
+        fluorescent: string;
+        incandescent: string;
+    };
+    readonly VideoQuality: {
+        [videoQuality: string]: number;
+    };
     readonly BarCodeType: {
         aztec: string;
         codabar: string;

From a6c21fe750011de5bc2cdd96a36fd69e9e07b991 Mon Sep 17 00:00:00 2001
From: Tina Roh <tinaroh@gmail.com>
Date: Wed, 13 Jun 2018 17:55:07 -0700
Subject: [PATCH 101/180] Fix Expo v26 Constants

---
 types/expo/v26/index.d.ts | 31 ++++++++++++++++++++++++++-----
 1 file changed, 26 insertions(+), 5 deletions(-)

diff --git a/types/expo/v26/index.d.ts b/types/expo/v26/index.d.ts
index 4e7a0ebdb3..b436d5987a 100644
--- a/types/expo/v26/index.d.ts
+++ b/types/expo/v26/index.d.ts
@@ -6,6 +6,7 @@
 //                 Sergio Sánchez <https://github.com/ssanchezmarc>
 //                 Fernando Helwanger <https://github.com/fhelwanger>
 //                 Umidbek Karimov <https://github.com/umidbekkarimov>
+//                 Tina Roh <https://github.com/tinaroh>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.6
 
@@ -787,11 +788,31 @@ export interface CameraProps extends ViewProps {
 }
 
 export interface CameraConstants {
-    readonly Type: string;
-    readonly FlashMode: string;
-    readonly AutoFocus: string;
-    readonly WhiteBalance: string;
-    readonly VideoQuality: string;
+    readonly Type: {
+        back: string;
+        front: string;
+    };
+    readonly FlashMode: {
+        on: string;
+        off: string;
+        auto: string;
+        torch: string;
+    };
+    readonly AutoFocus: {
+        on: string;
+        off: string;
+    };
+    readonly WhiteBalance: {
+        auto: string;
+        sunny: string;
+        cloudy: string;
+        shadow: string;
+        fluorescent: string;
+        incandescent: string;
+    };
+    readonly VideoQuality: {
+        [videoQuality: string]: number;
+    };
     readonly BarCodeType: {
         aztec: string;
         codabar: string;

From c18f3fb50055c71dfd3af01e91648af5b8d441d6 Mon Sep 17 00:00:00 2001
From: Tina Roh <tinaroh@gmail.com>
Date: Wed, 13 Jun 2018 18:01:12 -0700
Subject: [PATCH 102/180] Fix typo lignt -> light

---
 types/expo/index.d.ts     | 2 +-
 types/expo/v26/index.d.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/expo/index.d.ts b/types/expo/index.d.ts
index d20b5ec87b..952cd4a086 100644
--- a/types/expo/index.d.ts
+++ b/types/expo/index.d.ts
@@ -900,7 +900,7 @@ export namespace Constants {
         };
         appKey?: string;
         androidStatusBar?: {
-            barStyle?: 'lignt-content' | 'dark-content',
+            barStyle?: 'light-content' | 'dark-content',
             backgroundColor?: string
         };
         androidShowExponentNotificationInShellApp?: boolean;
diff --git a/types/expo/v26/index.d.ts b/types/expo/v26/index.d.ts
index b436d5987a..f1641ea643 100644
--- a/types/expo/v26/index.d.ts
+++ b/types/expo/v26/index.d.ts
@@ -898,7 +898,7 @@ export namespace Constants {
         };
         appKey?: string;
         androidStatusBar?: {
-            barStyle?: 'lignt-content' | 'dark-content',
+            barStyle?: 'light-content' | 'dark-content',
             backgroundColor?: string
         };
         androidShowExponentNotificationInShellApp?: boolean;

From 9b7dbac1da30e5de416798c9f691d082c215171c Mon Sep 17 00:00:00 2001
From: Austaras <austaras@outlook.com>
Date: Thu, 14 Jun 2018 14:52:06 +0800
Subject: [PATCH 103/180] fix blockies

---
 types/blockies/index.d.ts | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/types/blockies/index.d.ts b/types/blockies/index.d.ts
index f2de8b2c53..2a8cc526ad 100644
--- a/types/blockies/index.d.ts
+++ b/types/blockies/index.d.ts
@@ -3,12 +3,16 @@
 // Definitions by: Leonid Logvinov <https://github.com/LogvinovLeon>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-interface BlockiesIcon {
-    toDataURL(): string;
-}
-interface BlockiesConfig {
-    seed: string;
-}
-declare function blockies(config: BlockiesConfig): BlockiesIcon;
-
+declare function blockies(config?: blockies.BlockiesConfig): HTMLCanvasElement;
 export = blockies;
+
+declare namespace blockies {
+    interface BlockiesConfig {
+        size?: number;
+        scale?: number;
+        seed?: string;
+        color?: string;
+        bgcolor?: string;
+        spotcolor?: string;
+    }
+}

From 1b6abc23c1aa1b92411c9338f2a0fdce10d06e28 Mon Sep 17 00:00:00 2001
From: Austaras <austaras@outlook.com>
Date: Thu, 14 Jun 2018 14:55:36 +0800
Subject: [PATCH 104/180] Update tsconfig.json

---
 types/blockies/tsconfig.json | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/types/blockies/tsconfig.json b/types/blockies/tsconfig.json
index f190f0b0c9..db5851dcbb 100644
--- a/types/blockies/tsconfig.json
+++ b/types/blockies/tsconfig.json
@@ -1,7 +1,10 @@
 {
     "compilerOptions": {
         "module": "commonjs",
-        "lib": ["es6"],
+        "lib": [
+            "es6",
+            "dom"
+        ],
         "noImplicitAny": true,
         "noImplicitThis": true,
         "strictFunctionTypes": true,

From bd1a51cec4c2709b6871c77fcd47d56f834f69e8 Mon Sep 17 00:00:00 2001
From: Ryan Staniforth <rtstaniforth@gmail.com>
Date: Thu, 14 Jun 2018 10:25:43 +0100
Subject: [PATCH 105/180] Fix Error type to be "Error | null" in crypto methods

---
 types/node/index.d.ts | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 5d6b9e9d79..8625e5f0f9 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -5807,19 +5807,19 @@ declare module "crypto" {
         verifyError: number;
     }
     export function getDiffieHellman(group_name: string): DiffieHellman;
-    export function pbkdf2(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string, callback: (err: Error, derivedKey: Buffer) => any): void;
+    export function pbkdf2(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string, callback: (err: Error | null, derivedKey: Buffer) => any): void;
     export function pbkdf2Sync(password: string | Buffer, salt: string | Buffer, iterations: number, keylen: number, digest: string): Buffer;
     export function randomBytes(size: number): Buffer;
-    export function randomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void;
+    export function randomBytes(size: number, callback: (err: Error | null, buf: Buffer) => void): void;
     export function pseudoRandomBytes(size: number): Buffer;
-    export function pseudoRandomBytes(size: number, callback: (err: Error, buf: Buffer) => void): void;
+    export function pseudoRandomBytes(size: number, callback: (err: Error | null, buf: Buffer) => void): void;
     export function randomFillSync(buffer: Buffer | Uint8Array, offset?: number, size?: number): Buffer;
-    export function randomFill(buffer: Buffer, callback: (err: Error, buf: Buffer) => void): void;
-    export function randomFill(buffer: Uint8Array, callback: (err: Error, buf: Uint8Array) => void): void;
-    export function randomFill(buffer: Buffer, offset: number, callback: (err: Error, buf: Buffer) => void): void;
-    export function randomFill(buffer: Uint8Array, offset: number, callback: (err: Error, buf: Uint8Array) => void): void;
-    export function randomFill(buffer: Buffer, offset: number, size: number, callback: (err: Error, buf: Buffer) => void): void;
-    export function randomFill(buffer: Uint8Array, offset: number, size: number, callback: (err: Error, buf: Uint8Array) => void): void;
+    export function randomFill(buffer: Buffer, callback: (err: Error | null, buf: Buffer) => void): void;
+    export function randomFill(buffer: Uint8Array, callback: (err: Error | null, buf: Uint8Array) => void): void;
+    export function randomFill(buffer: Buffer, offset: number, callback: (err: Error | null, buf: Buffer) => void): void;
+    export function randomFill(buffer: Uint8Array, offset: number, callback: (err: Error | null, buf: Uint8Array) => void): void;
+    export function randomFill(buffer: Buffer, offset: number, size: number, callback: (err: Error | null, buf: Buffer) => void): void;
+    export function randomFill(buffer: Uint8Array, offset: number, size: number, callback: (err: Error | null, buf: Uint8Array) => void): void;
     export interface RsaPublicKey {
         key: string;
         padding?: number;

From 3653895fcd3e2bda1ab63eeac4833d744ad1e88e Mon Sep 17 00:00:00 2001
From: Alexaner T <alexander.v.tarasyuk@gmail.com>
Date: Wed, 13 Jun 2018 14:31:33 +0300
Subject: [PATCH 106/180] Add onScroll event to TextInput

---
 types/react-native/index.d.ts     | 24 +++++++++++++++++++-----
 types/react-native/test/index.tsx | 16 +++++++++++++---
 2 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/types/react-native/index.d.ts b/types/react-native/index.d.ts
index b06d877c4c..b469a5bdf2 100644
--- a/types/react-native/index.d.ts
+++ b/types/react-native/index.d.ts
@@ -1075,17 +1075,23 @@ export type KeyboardTypeIOS =
     | "twitter"
     | "web-search";
 export type KeyboardTypeAndroid = "visible-password";
-export type KeyboardTypeOptions = KeyboardType | KeyboardTypeAndroid | KeyboardTypeIOS
+export type KeyboardTypeOptions = KeyboardType | KeyboardTypeAndroid | KeyboardTypeIOS;
 
 export type ReturnKeyType = "done" | "go" | "next" | "search" | "send";
 export type ReturnKeyTypeAndroid = "none" | "previous";
 export type ReturnKeyTypeIOS = "default" | "google" | "join" | "route" | "yahoo" | "emergency-call";
-export type ReturnKeyTypeOptions = ReturnKeyType | ReturnKeyTypeAndroid | ReturnKeyTypeIOS
+export type ReturnKeyTypeOptions = ReturnKeyType | ReturnKeyTypeAndroid | ReturnKeyTypeIOS;
 
 export interface TextInputFocusEventData {
-    target: number,
-    text: string,
-    eventCount: number
+    target: number;
+    text: string;
+    eventCount: number;
+}
+
+export interface TextInputScrollEvent {
+    nativeEvent: {
+        contentOffset: { x: number; y: number; }
+    }
 }
 
 /**
@@ -1220,6 +1226,14 @@ export interface TextInputProps
      */
     onSubmitEditing?: (event: { nativeEvent: { text: string } }) => void;
 
+    /**
+     * Invoked on content scroll with
+     *  `{ nativeEvent: { contentOffset: { x, y } } }`.
+     *
+     * May also contain other properties from ScrollEvent but on Android contentSize is not provided for performance reasons.
+     */
+    onScroll?: (event: TextInputScrollEvent) => void;
+
     /**
      * The string that will be rendered before text input has been entered
      */
diff --git a/types/react-native/test/index.tsx b/types/react-native/test/index.tsx
index 9fbad8a870..2f753eee64 100644
--- a/types/react-native/test/index.tsx
+++ b/types/react-native/test/index.tsx
@@ -54,7 +54,8 @@ import {
     InputAccessoryView,
     StatusBar,
     NativeSyntheticEvent,
-    GestureResponderEvent
+    GestureResponderEvent,
+    TextInputScrollEvent,
 } from "react-native";
 
 declare module "react-native" {
@@ -197,14 +198,19 @@ class Welcome extends React.Component {
 
 export default Welcome;
 
-// SyntheticEventsTest
-export class SyntheticEventsTest extends React.Component {
+// EventsTest
+export class EventsTest extends React.Component {
     onPressButton(e: GestureResponderEvent) {
         e.persist();
         e.isPropagationStopped();
         e.isDefaultPrevented();
     }
 
+    onScroll(e: TextInputScrollEvent) {
+        console.log(`x: ${ e.nativeEvent.contentOffset.x }`);
+        console.log(`y: ${ e.nativeEvent.contentOffset.y }`);
+    }
+
     render() {
         return (
             <TouchableNativeFeedback
@@ -212,6 +218,10 @@ export class SyntheticEventsTest extends React.Component {
             >
                 <View style={{width: 150, height: 100, backgroundColor: 'red'}}>
                     <Text style={{margin: 30}}>Button</Text>
+                    <TextInput
+                        multiline
+                        onScroll={this.onScroll}
+                    />
                 </View>
             </TouchableNativeFeedback>
         )

From a51018316fabe2535d860584cbabf0b2ad97c2bd Mon Sep 17 00:00:00 2001
From: Jose Colella <Jose.Colella@dynatrace.com>
Date: Thu, 14 Jun 2018 08:22:34 -0400
Subject: [PATCH 107/180] Restrict optional family value to 4 or 6. References
 IPv4 and IPv6

---
 types/request/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/request/index.d.ts b/types/request/index.d.ts
index 51cb7919a7..60e24b7692 100644
--- a/types/request/index.d.ts
+++ b/types/request/index.d.ts
@@ -140,7 +140,7 @@ declare namespace request {
         method?: string;
         headers?: Headers;
         body?: any;
-        family?: number;
+        family?: 4 | 6;
         followRedirect?: boolean | ((response: http.IncomingMessage) => boolean);
         followAllRedirects?: boolean;
         followOriginalHttpMethod?: boolean;

From e4c62c323b36298298b8460136073062adec4e9c Mon Sep 17 00:00:00 2001
From: Derek Rada <drada@markettrack.com>
Date: Wed, 13 Jun 2018 18:51:31 -0400
Subject: [PATCH 108/180] add promises/functions/interfaces

---
 types/postmark/index.d.ts        | 591 +++++++++++++++++++++++++++----
 types/postmark/postmark-tests.ts |  50 ++-
 2 files changed, 567 insertions(+), 74 deletions(-)

diff --git a/types/postmark/index.d.ts b/types/postmark/index.d.ts
index 2f77040930..24810299a7 100644
--- a/types/postmark/index.d.ts
+++ b/types/postmark/index.d.ts
@@ -1,12 +1,12 @@
-// Type definitions for postmark 1.3
+// Type definitions for postmark 1.4
 // Project: http://wildbit.github.io/postmark.js
 // Definitions by: Ben Bayard <https://github.com/benbayard>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.4
 
-export = Postmark;
+export = postmark;
 
-declare function Postmark(apiKey: string, options: Partial<Postmark.Options>): Postmark.Client;
+declare const postmark: Postmark.Postmark;
 declare namespace Postmark {
     const defaults: Options;
 
@@ -28,8 +28,8 @@ declare namespace Postmark {
     }
 
     interface Filter {
-        count: number;
-        offset: number;
+        count?: number;
+        offset?: number;
     }
 
     interface PostmarkMessageWithTemplate {
@@ -87,7 +87,7 @@ declare namespace Postmark {
         InlineCssForHtmlTestRender?: boolean;
     }
 
-    type PostmarkCallback<T extends object = any> = ((e: PostmarkError, ret: T) => void) | undefined;
+    type PostmarkCallback<T extends object = any> = ((e: PostmarkError, ret: T) => undefined) | undefined;
 
     interface SimpleOptions {
         ssl: boolean;
@@ -107,39 +107,99 @@ declare namespace Postmark {
 
     class Client {
         constructor(serverKey: string, options?: Partial<Options>);
-        send(message: PostmarkMessage, callback: PostmarkCallback): void;
-        sendEmailWithTemplate(
-            message: PostmarkMessageWithTemplate,
-            callback: PostmarkCallback
-        ): void;
-        batch(message: PostmarkMessage[], callback: PostmarkCallback): void;
-        sendEmail(message: PostmarkMessage, callback: PostmarkCallback): void;
-        sendEmailBatch(message: PostmarkMessage[], callback: PostmarkCallback): void;
-        getDeliveryStatistics(callback: PostmarkCallback): void;
-        getBounces(filter: Partial<Filter>, callback: PostmarkCallback): void;
-        getBounce(id: number, callback: PostmarkCallback): void;
-        getBounceDump(id: number, callback: PostmarkCallback): void;
-        activateBounce(id: number, callback: PostmarkCallback): void;
-        getBounceTags(callback: PostmarkCallback): void;
-        getServer(callback: PostmarkCallback): void;
-        editServer<T extends keyof Sender>(options: Pick<Sender, T>, callback: PostmarkCallback): void;
-        getOutboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
-        getOutboundMessageDetails(id: number, callback: PostmarkCallback): void;
-        getMessageOpens(filter: Partial<Filter>, callback: PostmarkCallback): void;
-        getMessageOpensForSingleMessage(id: number, filter: Partial<Filter>, callback: PostmarkCallback): void;
-        getInboundMessages(filter: Partial<Filter>, callback: PostmarkCallback): void;
-        getInboundMessageDetails(id: number, callback: PostmarkCallback): void;
-        bypassBlockedInboundMessage(id: number, callback: PostmarkCallback): void;
-        retryInboundHookForMessage(id: number, callback: PostmarkCallback): void;
-        getOuboundOverview(filter: Partial<Filter>, callback: PostmarkCallback): void;
-        validateTemplate<T extends object>(templateObject: TemplateValidator<T>, callback: PostmarkCallback): void;
+
+        send(message: PostmarkMessage): Promise<SendStatus>;
+        send(message: PostmarkMessage, callback: PostmarkCallback<SendStatus>): undefined;
+
+        sendEmailWithTemplate(message: PostmarkMessageWithTemplate): Promise<SendStatus>;
+        sendEmailWithTemplate(message: PostmarkMessageWithTemplate, callback: PostmarkCallback<SendStatus>): undefined;
+
+        batch(message: PostmarkMessage[]): Promise<SendStatus[]>;
+        batch(message: PostmarkMessage[], callback: PostmarkCallback<SendStatus[]>): undefined;
+
+        sendEmail(message: PostmarkMessage): Promise<SendStatus>;
+        sendEmail(message: PostmarkMessage, callback: PostmarkCallback<SendStatus>): undefined;
+
+        sendEmailBatch(message: PostmarkMessage[]): Promise<SendStatus[]>;
+        sendEmailBatch(message: PostmarkMessage[], callback: PostmarkCallback<SendStatus[]>): undefined;
+
+        // stats
+        getDeliveryStatistics(): Promise<DeliveryStats>;
+        getDeliveryStatistics(callback: PostmarkCallback<DeliveryStats>): undefined;
+
+        // bounces
+        getBounces(filter: BounceFilter): Promise<BouncesResult>;
+        getBounces(filter: BounceFilter, callback?: PostmarkCallback<BouncesResult>): undefined;
+
+        getBounce(id: number): Promise<Bounce>;
+        getBounce(id: number, callback?: PostmarkCallback<Bounce>): undefined;
+
+        getBounceDump(id: number): Promise<BounceDump>;
+        getBounceDump(id: number, callback?: PostmarkCallback<BounceDump>): undefined;
+
+        activateBounce(id: number): Promise<ActivatedBounceResult>;
+        activateBounce(id: number, callback?: PostmarkCallback<ActivatedBounceResult>): undefined;
+
+        getBounceTags(): Promise<string[]>;
+        getBounceTags(callback?: PostmarkCallback<string[]>): undefined;
+
+        // server
+        getServer(): Promise<Server>;
+        getServer(callback?: PostmarkCallback<Server>): undefined;
+
+        editServer(server: Partial<Server>): Promise<Server>;
+        editServer(server: Partial<Server>, callback?: PostmarkCallback<Server>): undefined;
+
+        // message info
+        getOutboundMessages(filter: OutboundMessageFilter): Promise<OutboundMessagesResult>;
+        getOutboundMessages(filter: OutboundMessageFilter, callback?: PostmarkCallback<OutboundMessagesResult>): undefined;
+
+        getOutboundMessageDetails(id: number): Promise<OutboundMessage>;
+        getOutboundMessageDetails(id: number, callback?: PostmarkCallback<OutboundMessage>): undefined;
+
+        getMessageOpens(filter: OpenMessageFilter): Promise<MessageOpensResult>;
+        getMessageOpens(filter: OpenMessageFilter, callback?: PostmarkCallback<MessageOpensResult>): undefined;
+
+        getMessageOpensForSingleMessage(id: number, filter: Filter): Promise<MessageOpensResult>;
+        getMessageOpensForSingleMessage(id: number, filter: Filter, callback?: PostmarkCallback<MessageOpensResult>): undefined;
+
+        getInboundMessages(filter: InboundMessageFilter): Promise<InboundMessagesResult>;
+        getInboundMessages(filter: InboundMessageFilter, callback?: PostmarkCallback<InboundMessagesResult>): undefined;
+
+        getInboundMessageDetails(id: number): Promise<InboundMessage>;
+        getInboundMessageDetails(id: number, callback?: PostmarkCallback<InboundMessage>): undefined;
+
+        bypassBlockedInboundMessage(id: number): Promise<GenericResult>;
+        bypassBlockedInboundMessage(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        getOuboundOverview(filter: BaseFilter): Promise<OutboundOverview>;
+        getOuboundOverview(filter: BaseFilter, callback?: PostmarkCallback<OutboundOverview>): undefined;
+
+        retryInboundHookForMessage(id: number): Promise<GenericResult>;
+        retryInboundHookForMessage(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        // templates
+        getTemplate(id: number): Promise<Template>;
+        getTemplate(id: number, callback?: PostmarkCallback<Template>): undefined;
+
+        createTemplate(template: Partial<Template>): Promise<TemplateBase>;
+        createTemplate(template: Partial<Template>, callback?: PostmarkCallback<TemplateBase>): undefined;
+
+        editTemplate(template: Partial<Template>): Promise<TemplateBase>;
+        editTemplate(template: Partial<Template>, callback?: PostmarkCallback<TemplateBase>): undefined;
+
+        getTemplates(filter: Filter): Promise<TemplatesResult>;
+        getTemplates(filter: Filter, callback?: PostmarkCallback<TemplatesResult>): undefined;
+
+        deleteTemplate(id: number): Promise<GenericResult>;
+        deleteTemplate(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        validateTemplate<T extends object>(templateObject: TemplateValidator<T>): Promise<TemplateValidationResult<T>>;
+        validateTemplate<T extends object>(templateObject: TemplateValidator<T>, callback?: PostmarkCallback<TemplateValidationResult<T>>): undefined;
     }
 
-    interface CreateSignature {
+    interface CreateSignature extends UpdateSignature {
         FromEmail: string;
-        Name: string;
-        ReplyToEmail?: string;
-        ReturnPathDomain?: string;
     }
 
     interface CreateServer {
@@ -166,40 +226,64 @@ declare namespace Postmark {
 
     class AdminClient {
         constructor(apiKey: string, options: Partial<Options>);
-        listSenderSignatures(query: Partial<Filter>, callback: PostmarkCallback): void;
-        createSenderSignature(options: CreateSignature, callback: PostmarkCallback): void;
-        editSenderSignature<T extends keyof CreateSignature>(
-            id: number,
-            options: Partial<Pick<CreateSignature, T>>,
-            callback: PostmarkCallback
-        ): void;
-        deleteSenderSignature(id: number, callback: PostmarkCallback): void;
-        resendSenderSignatureConfirmation(id: number, callback: PostmarkCallback): void;
-        verifySenderSignatureSPF(id: number, callback: PostmarkCallback): void;
-        requestNewDKIMForSenderSignature(id: number, callback: PostmarkCallback): void;
-        getServer(id: number, callback: PostmarkCallback): void;
-        createServer(options: CreateServer, callback: PostmarkCallback): void;
-        editServer<T extends keyof CreateServer>(
-            id: number,
-            options: Pick<CreateServer, T>,
-            callback: PostmarkCallback
-        ): void;
-        deleteServer(id: number, callback: PostmarkCallback): void;
-        listServers(query: Partial<Filter>, callback: PostmarkCallback): void;
-        listDomains(query: Partial<Filter>, callback: PostmarkCallback): void;
-        getDomain(id: number, callback: PostmarkCallback): void;
-        createDomain(
-            options: CreateDomain,
-            callback: PostmarkCallback
-        ): void;
-        editDomain<T extends keyof CreateDomain>(
-            id: number,
-            options: Pick<CreateDomain, T>,
-            callback: PostmarkCallback
-        ): void;
-        deleteDomain(id: number, callback: PostmarkCallback): void;
-        verifyDomainSPF(id: number, callback: PostmarkCallback): void;
-        rotateDKIMForDomain(id: number, callback: PostmarkCallback): void;
+        listSenderSignatures(query: Filter): Promise<SenderSignaturesResults>;
+        listSenderSignatures(query: Filter, callback?: PostmarkCallback<SenderSignaturesResults>): undefined;
+
+        createSenderSignature(options: CreateSignature): Promise<SenderSignature>;
+        createSenderSignature(options: CreateSignature, callback?: PostmarkCallback<SenderSignature>): undefined;
+
+        editSenderSignature(id: number, options: UpdateSignature): Promise<SenderSignature>;
+        editSenderSignature(id: number, options: UpdateSignature, callback?: PostmarkCallback<SenderSignature>): undefined;
+
+        deleteSenderSignature(id: number): Promise<GenericResult>;
+        deleteSenderSignature(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        resendSenderSignatureConfirmation(id: number): Promise<GenericResult>;
+        resendSenderSignatureConfirmation(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        verifySenderSignatureSPF(id: number): Promise<SenderSignature>;
+        verifySenderSignatureSPF(id: number, callback?: PostmarkCallback<SenderSignature>): undefined;
+
+        requestNewDKIMForSenderSignature(id: number): Promise<GenericResult>;
+        requestNewDKIMForSenderSignature(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        // servers
+        getServer(id: number): Promise<Server>;
+        getServer(id: number, callback?: PostmarkCallback<Server>): undefined;
+
+        createServer(options: CreateServer): Promise<Server>;
+        createServer(options: CreateServer, callback?: PostmarkCallback<Server>): undefined;
+
+        editServer(id: number, options: Partial<CreateServer>): Promise<Server>;
+        editServer(id: number, options: Partial<CreateServer>, callback?: PostmarkCallback<Server>): undefined;
+
+        deleteServer(id: number): Promise<GenericResult>;
+        deleteServer(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        listServers(query: ServerFilter): Promise<ServersResult>;
+        listServers(query: ServerFilter, callback?: PostmarkCallback<ServersResult>): undefined;
+
+        // domains
+        listDomains(query: Filter): Promise<DomainsResult>;
+        listDomains(query: Filter, callback?: PostmarkCallback<DomainsResult>): undefined;
+
+        getDomain(id: number): Promise<Domain>;
+        getDomain(id: number, callback?: PostmarkCallback<Domain>): undefined;
+
+        createDomain(options: CreateDomain): Promise<Domain>;
+        createDomain(options: CreateDomain, callback?: PostmarkCallback<Domain>): undefined;
+
+        editDomain(id: number, options: Partial<CreateDomain>): Promise<Domain>;
+        editDomain(id: number, options: Partial<CreateDomain>, callback?: PostmarkCallback<Domain>): undefined;
+
+        deleteDomain(id: number): Promise<GenericResult>;
+        deleteDomain(id: number, callback?: PostmarkCallback<GenericResult>): undefined;
+
+        verifyDomainSPF(id: number): Promise<SenderSignature>;
+        verifyDomainSPF(id: number, callback?: PostmarkCallback<SenderSignature>): undefined;
+
+        rotateDKIMForDomain(id: number): Promise<RotateDKIMResult>;
+        rotateDKIMForDomain(id: number, callback?: PostmarkCallback<RotateDKIMResult>): undefined;
     }
 
     interface ClientClass {
@@ -211,9 +295,374 @@ declare namespace Postmark {
     }
 
     interface Postmark {
-        (apiKey: string, options: Partial<Options>): void;
+        (apiKey: string, options: Partial<Options>): Client;
         defaults: Options;
         Client: ClientClass;
         AdminClient: AdminClientClass;
     }
+
+    // server
+    interface Server extends Sender {
+        ID: number;
+        ApiTokens: string[];
+        ServerLink: string;
+        Name: string;
+    }
+
+    interface SendStatus {
+        To: string;
+        SubmittedAt: string;
+        MessageID: string;
+        ErrorCode: number;
+        Message: string;
+    }
+
+    // validation
+    interface ValidationError {
+        Message: string;
+        Line: number;
+        CharacterPosition: number;
+    }
+
+    interface ValidationSet {
+        ContentIsValid: boolean;
+        ValidationErrors: ValidationError[];
+        RenderedContent: string;
+    }
+
+    interface TemplateValidator<T extends object> {
+        Subject: string;
+        HtmlBody: string;
+        TextBody: string;
+        TestRenderModel?: T;
+        InlineCssForHtmlTestRender?: boolean;
+    }
+
+    // templates
+    interface TemplateBase {
+        Name: string;
+        TemplateId: number;
+        Active: boolean;
+    }
+
+    interface Template extends TemplateBase {
+        Subject: string;
+        HtmlBody: string;
+        TextBody: string;
+        AssociatedServerId: number;
+    }
+
+    // filters
+    interface BaseFilter extends Filter {
+        tag?: string;
+        todate?: string;
+        fromdate?: string;
+    }
+    interface BounceFilter extends BaseFilter {
+        type?: string;
+        inactive?: boolean;
+        emailFilter?: string;
+        messageID?: string;
+    }
+
+    interface OutboundMessageFilter extends BaseFilter {
+        recipient?: string;
+        fromemail?: string;
+        status?: string;
+    }
+
+    interface InboundMessageFilter extends OutboundMessageFilter {
+        mailboxhash?: string;
+        subject?: string;
+    }
+
+    interface OpenMessageFilter extends BaseFilter {
+        client_name?: string;
+        client_company?: string;
+        client_family?: string;
+        os_name?: string;
+        os_family?: string;
+        os_company?: string;
+        platform?: string;
+        region?: string;
+        city?: string;
+    }
+
+    interface ServerFilter extends Filter {
+        name?: string;
+    }
+
+    // bounces
+    interface Bounce {
+        ID: number;
+        Type: string;
+        TypeCode: number;
+        Name: string;
+        Tag: string;
+        MessageID: string;
+        ServerID: number;
+        Description: string;
+        Details: string;
+        Email: string;
+        From: string;
+        Subject: string;
+        BouncedAt: string;
+        DumpAvailable: boolean;
+        Inactive: boolean;
+        CanActivate: boolean;
+        Content: string;
+    }
+
+    interface BounceDump {
+        Body: string;
+    }
+
+    // tracking info
+    interface VendorTrackingInfo {
+        Name: string;
+        Company: string;
+        Family: string;
+    }
+
+    interface GeoTrackingInfo {
+        CountryISOCode: string;
+        Country: string;
+        RegionISOCode: string;
+        Region: string;
+        City: string;
+        Zip: string;
+        Coords: string;
+        IP: string;
+    }
+
+    interface BounceStats {
+        Name: string;
+        Count: number;
+        Type: string | undefined;
+    }
+
+    interface DeliveryStats {
+        InactiveMails: number;
+        Bounces: BounceStats[];
+    }
+
+    interface MessageOpens {
+        FirstOpen: boolean;
+        Client: VendorTrackingInfo;
+        OS: VendorTrackingInfo;
+        Platform: string;
+        UserAgent: string;
+        ReadSeconds: number;
+        Geo: GeoTrackingInfo;
+        MessageID: string;
+        ReceivedAt: string;
+        Tag: string;
+        Recipient: string;
+    }
+
+    interface ExpandedEmail {
+        Email: string;
+        Name: string;
+    }
+
+    // message events
+    interface MessageEvents {
+        Recipient: string;
+        Type: string;
+        ReceivedAt: string;
+        Details: MessageEventDetails;
+    }
+
+    interface MessageEventDetails {
+        Summary?: string;
+        BounceID?: string;
+        Link?: string;
+        ClickLocation?: string;
+        DeliveryMessage?: string;
+        DestinationServer?: string;
+        DestinationIP?: string;
+    }
+
+    // messages
+    interface MessageBase {
+        Tag: string;
+        MessageID: string;
+        From: string;
+        Cc: string;
+        Subject: string;
+        Status: string;
+        Attachments: PostmarkAttachment[];
+    }
+
+    interface OutboundMessageBase extends MessageBase {
+        To: ExpandedEmail[];
+        Recipients: string[];
+        ReceivedAt: string;
+        TrackOpens: boolean;
+        TrackLinks: string;
+    }
+
+    interface OutboundMessage extends OutboundMessageBase {
+        TextBody: string;
+        HtmlBody: string;
+        Body: string;
+        MessageEvents: MessageEvents[];
+    }
+
+    interface InboundMessageBase extends MessageBase {
+        FromName: string;
+        FromFull: ExpandedEmail;
+        To: string;
+        ToFull: ExpandedEmail[];
+        CcFull: ExpandedEmail[];
+        ReplyTo: string;
+        OriginalRecipient: string;
+        Date: string;
+        MailboxHash: string;
+    }
+
+    interface InboundMessage extends InboundMessageBase {
+        TextBody: string;
+        HtmlBody: string;
+        Headers: PostmarkMessageHeader[];
+        BlockedReason?: string;
+        MessageEvents: MessageEvents[];
+    }
+
+    // Results
+    interface GenericResult {
+        Message: string;
+        ErrorCode?: number;
+    }
+
+    interface PaginatedResult {
+        TotalCount: number;
+    }
+
+    interface ActivatedBounceResult extends GenericResult {
+        Bounce: Bounce;
+    }
+
+    interface BouncesResult extends PaginatedResult {
+        Bounces: Bounce[];
+    }
+
+    interface TemplatesResult extends PaginatedResult {
+        Templates: TemplateBase[];
+    }
+
+    interface MessageOpensResult extends PaginatedResult {
+        Opens: MessageOpens[];
+    }
+
+    interface OutboundMessagesResult extends PaginatedResult {
+        Messages: OutboundMessageBase[];
+    }
+
+    interface InboundMessagesResult extends PaginatedResult {
+        InboundMessages: InboundMessageBase[];
+    }
+
+    interface TemplateValidationResult<T extends object = any> {
+        AllContentIsValid: boolean;
+        HtmlBody: ValidationSet;
+        TextBody: ValidationSet;
+        Subject: ValidationSet;
+        SuggestedTemplateModel: T;
+    }
+
+    interface SenderSignaturesResults extends PaginatedResult {
+        SenderSignatures: SenderSignatureBase[];
+    }
+
+    interface ServersResult extends PaginatedResult {
+        Servers: Server[];
+    }
+
+    interface DomainsResult extends PaginatedResult {
+        Domains: DomainBase[];
+    }
+
+    // sender signature
+    interface SenderSignatureBase {
+        Domain: string;
+        EmailAddress: string;
+        Name: string;
+        ReplyToEmailAddress: string;
+        Confirmed: boolean;
+        ID: number;
+    }
+
+    interface SPFRecord {
+        SPFHost: string;
+        SPFTextValue: string;
+        SPFVerified: boolean;
+    }
+
+    interface DKIMKey {
+        WeakDKIM: boolean;
+        DKIMHost: string;
+        DKIMVerified: boolean;
+        DKIMTextValue: string;
+        DKIMPendingHost: string;
+        DKIMPendingTextValue: string;
+        DKIMRevokedHost: string;
+        DKIMRevokedTextValue: string;
+        SafeToRemoveRevokedKeyFromDNS: boolean;
+        DKIMUpdateStatus: string;
+    }
+
+    interface VerificationDetails extends SPFRecord, DKIMKey {
+        ReturnPathDomain: string;
+        ReturnPathDomainCNAMEValue: string;
+    }
+
+    interface SenderSignature extends SenderSignatureBase, VerificationDetails {
+        ReturnPathDomainVerified: boolean;
+    }
+
+    interface UpdateSignature {
+        Name: string;
+        ReplyToEmail?: string;
+        ReturnPathDomain?: string;
+    }
+
+    // domain
+    interface DomainBase {
+        ID: number;
+        Name: string;
+        SPFVerified: boolean;
+        DKIMVerified: boolean;
+        WeakDKIM: boolean;
+        ReturnPathDomainVerified: boolean;
+    }
+
+    interface Domain extends DomainBase, VerificationDetails {
+    }
+
+    interface RotateDKIMResult extends DKIMKey {
+        Name: string;
+        ID: string;
+    }
+
+    // outbound overview
+    interface OutboundOverview {
+        Sent: number;
+        Bounced: number;
+        SMTPApiErrors: number;
+        BounceRate: number;
+        SpamComplaints: number;
+        SpamComplaintsRate: number;
+        Opens: number;
+        UniqueOpens: number;
+        Tracked: number;
+        WithLinkTracking: number;
+        WithOpenTracking: number;
+        TotalTrackedLinksSent: number;
+        UniqueLinksClicked: number;
+        TotalClicks: number;
+        WithClientRecorded: number;
+        WithPlatformRecorded: number;
+        WithReadTimeRecorded: number;
+    }
 }
diff --git a/types/postmark/postmark-tests.ts b/types/postmark/postmark-tests.ts
index 451b0051f4..f18bff2ef6 100644
--- a/types/postmark/postmark-tests.ts
+++ b/types/postmark/postmark-tests.ts
@@ -11,7 +11,7 @@ const templateValidator = {
   TextBody: '123535',
 };
 
-declare function callback(err: any, data: any): void;
+declare function callback(err: any, data: any): undefined;
 
 const client = new postmark.Client('124345', options);
 const adminClient = new postmark.AdminClient('1123235', options);
@@ -40,16 +40,40 @@ client.retryInboundHookForMessage(1, callback);
 client.getOuboundOverview(filter, callback);
 client.validateTemplate(templateValidator, callback);
 
+client.send(message).then(() => { });
+client.sendEmailWithTemplate(templateMessage).then(() => { });
+client.batch([message, message]).then(() => { });
+client.sendEmail(message).then(() => { });
+client.sendEmailBatch([message, message]).then(() => { });
+client.getDeliveryStatistics().then(() => { });
+client.getBounces(filter).then(() => { });
+client.getBounce(1).then(() => { });
+client.getBounceDump(1).then(() => { });
+client.activateBounce(1).then(() => { });
+client.getBounceTags().then(() => { });
+client.getServer().then(() => { });
+client.editServer(editSender).then(() => { });
+client.getOutboundMessages(filter).then(() => { });
+client.getOutboundMessageDetails(1).then(() => { });
+client.getMessageOpens(filter).then(() => { });
+client.getMessageOpensForSingleMessage(1, filter).then(() => { });
+client.getInboundMessages(filter).then(() => { });
+client.getInboundMessageDetails(1).then(() => { });
+client.bypassBlockedInboundMessage(1).then(() => { });
+client.retryInboundHookForMessage(1).then(() => { });
+client.getOuboundOverview(filter).then(() => { });
+client.validateTemplate(templateValidator).then(() => { });
+
 adminClient.listSenderSignatures(filter, callback);
 adminClient.createSenderSignature({FromEmail: '', Name: ''}, callback);
-adminClient.editSenderSignature(0, {ReplyToEmail: '123'}, callback);
+adminClient.editSenderSignature(0, {Name: '123'}, callback);
 adminClient.deleteSenderSignature(0, callback);
 adminClient.resendSenderSignatureConfirmation(0, callback);
 adminClient.verifySenderSignatureSPF(0, callback);
 adminClient.requestNewDKIMForSenderSignature(0, callback);
 adminClient.getServer(0, callback);
 adminClient.createServer({Name: '123'}, callback);
-adminClient.editServer(0, {Color: 'black'}, callback);
+adminClient.editServer(0, {Name: 'black'}, callback);
 adminClient.deleteServer(0, callback);
 adminClient.listServers(filter, callback);
 adminClient.listDomains(filter, callback);
@@ -59,3 +83,23 @@ adminClient.editDomain(0, {ReturnPathDomain: '/'}, callback);
 adminClient.deleteDomain(0, callback);
 adminClient.verifyDomainSPF(0, callback);
 adminClient.rotateDKIMForDomain(0, callback);
+
+adminClient.listSenderSignatures(filter).then(() => { });
+adminClient.createSenderSignature({ FromEmail: '', Name: '' }).then(() => { });
+adminClient.editSenderSignature(0, { Name: 'somename', ReplyToEmail: '123' }).then(() => { });
+adminClient.deleteSenderSignature(0).then(() => { });
+adminClient.resendSenderSignatureConfirmation(0).then(() => { });
+adminClient.verifySenderSignatureSPF(0).then(() => { });
+adminClient.requestNewDKIMForSenderSignature(0).then(() => { });
+adminClient.getServer(0).then(() => { });
+adminClient.createServer({ Name: '123' }).then(() => { });
+adminClient.editServer(0, { Name: 'black' }).then(() => { });
+adminClient.deleteServer(0).then(() => { });
+adminClient.listServers(filter).then(() => { });
+adminClient.listDomains(filter).then(() => { });
+adminClient.getDomain(0).then(() => { });
+adminClient.createDomain({ Name: '1234' }).then(() => { });
+adminClient.editDomain(0, { ReturnPathDomain: '/' }).then(() => { });
+adminClient.deleteDomain(0).then(() => { });
+adminClient.verifyDomainSPF(0).then(() => { });
+adminClient.rotateDKIMForDomain(0).then(() => { });

From 4220af6d67a0363145b22dd88c07b7b05e07efd7 Mon Sep 17 00:00:00 2001
From: denkpark <26546651+denkpark@users.noreply.github.com>
Date: Thu, 14 Jun 2018 17:00:53 +0200
Subject: [PATCH 109/180] Middleware properties optional; req.brute

- properties in `ExpressBrute.Middleware` are optional
- added`req.brute.reset()` to express.Request
---
 types/express-brute/index.d.ts | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/types/express-brute/index.d.ts b/types/express-brute/index.d.ts
index b7961ea597..8f1b6fbf11 100644
--- a/types/express-brute/index.d.ts
+++ b/types/express-brute/index.d.ts
@@ -67,19 +67,19 @@ declare namespace ExpressBrute {
          * @summary Allows you to override the value of failCallback for this middleware.
          * @type {Function}
          */
-        failCallback: Function;
+        failCallback?: Function;
 
         /**
          * @summary Disregard IP address when matching requests if set to true. Defaults to false.
          * @type {boolean}
          */
-        ignoreIP: boolean;
+        ignoreIP?: boolean;
 
         /**
          * @summary Key.
          * @type {any}
          */
-        key: any;
+        key?: any;
     }
 
     /**
@@ -156,5 +156,13 @@ declare namespace ExpressBrute {
         reset(key: string, callback: (error: any) => void): void;
     }
 }
+    
+declare module "express-serve-static-core" {
+    export interface Request {
+        brute?: {
+            reset?: (callback?: () => void) => void
+        };
+    }
+}
 
 export = ExpressBrute;

From a25b54646ec610bef7f26c21324dd15707a62c11 Mon Sep 17 00:00:00 2001
From: alvarogtx300 <alvarogtx300@gmail.com>
Date: Thu, 14 Jun 2018 18:25:50 +0200
Subject: [PATCH 110/180] Added optional "padding" argument to panToBounds
 method

---
 types/googlemaps/googlemaps-tests.ts | 27 +++++++++++++++++++++++++++
 types/googlemaps/index.d.ts          |  2 +-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/types/googlemaps/googlemaps-tests.ts b/types/googlemaps/googlemaps-tests.ts
index 561e53f91a..99d5902a88 100644
--- a/types/googlemaps/googlemaps-tests.ts
+++ b/types/googlemaps/googlemaps-tests.ts
@@ -60,6 +60,33 @@ map.fitBounds({
     top: 50
 });
 
+/***** Pan map to bounds *****/
+map.panToBounds({
+    north: 10,
+    east: 10,
+    west: 10,
+    south: 10
+})
+
+map.panToBounds({
+    north: 10,
+    east: 10,
+    west: 10,
+    south: 10
+}, 50)
+
+map.panToBounds({
+    east: 10,
+    north: 10,
+    south: 10,
+    west: 10
+}, {
+    bottom: 100,
+    left: 150,
+    right: 150,
+    top: 50
+});
+
 
 /***** Data *****/
 
diff --git a/types/googlemaps/index.d.ts b/types/googlemaps/index.d.ts
index 9430698fe6..a8de5810ec 100644
--- a/types/googlemaps/index.d.ts
+++ b/types/googlemaps/index.d.ts
@@ -51,7 +51,7 @@ declare namespace google.maps {
         getZoom(): number;
         panBy(x: number, y: number): void;
         panTo(latLng: LatLng|LatLngLiteral): void;
-        panToBounds(latLngBounds: LatLngBounds|LatLngBoundsLiteral): void;
+        panToBounds(latLngBounds: LatLngBounds|LatLngBoundsLiteral, padding?: number|Padding): void;
         setCenter(latlng: LatLng|LatLngLiteral): void;
         setHeading(heading: number): void;
         setMapTypeId(mapTypeId: MapTypeId|string): void;

From c56a215377caac363cf6e05a2f59a1a73f8db577 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Thu, 14 Jun 2018 10:42:04 -0700
Subject: [PATCH 111/180] Add links to known types and some formatting

---
 types/office-js/index.d.ts | 224 +++++++++++++++++++------------------
 1 file changed, 117 insertions(+), 107 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 9a2f8981a5..230a8336fb 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -576,7 +576,7 @@ declare namespace Office {
         *
         * The initial page must be on the same domain as the parent page (the startAddress parameter). After the initial page loads, you can go to other domains.
         *
-        * Any page calling office.context.ui.messageParent must also be on the same domain as the parent page.
+        * Any page calling `office.context.ui.messageParent` must also be on the same domain as the parent page.
         *
         * The following design considerations apply to dialog boxes:
         *
@@ -731,7 +731,7 @@ declare namespace Office {
      */
     interface GetBindingDataOptions {
         /**
-         * The expected shape of the selection. Use Office.CoercionType or text value. Default: The original, uncoerced type of the binding.
+         * The expected shape of the selection. Use {@link Office.CoercionType} or text value. Default: The original, uncoerced type of the binding.
          */
         coercionType?: Office.CoercionType | string
         /**
@@ -775,8 +775,9 @@ declare namespace Office {
      */
     interface SetBindingDataOptions {
         /**
-         * Use only with binding type table and when a TableData object is passed for the data parameter. An array of objects that specify a range of columns, rows, or cells and specify, as key-value pairs, the cell formatting to apply to that range. Example: [{cells: Office.Table.Data, format: {fontColor: "yellow"}},
-        {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]
+         * Use only with binding type table and when a TableData object is passed for the data parameter. An array of objects that specify a range of columns, rows, or cells and specify, as key-value pairs, the cell formatting to apply to that range. 
+         * 
+         * Example: `[{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]`
          */
         cellFormat?: Array<RangeFormatConfiguration>
         /**
@@ -800,7 +801,7 @@ declare namespace Office {
         */
         startColumn?: number
         /**
-        * For an inserted table, a list of key-value pairs that specify table formatting options, such as header row, total row, and banded rows. Example: {bandedRows: true,  filterButton: false}
+        * For an inserted table, a list of key-value pairs that specify table formatting options, such as header row, total row, and banded rows. Example: `{bandedRows: true,  filterButton: false}`
         */
         tableOptions?: object
         /**
@@ -920,7 +921,7 @@ declare namespace Office {
          */
         valueFormat?: Office.ValueFormat | string
         /**
-         * Specify whether to get only the visible (that is, filtered-in) data or all the data. Useful when filtering data. Use Office.FilterType or string equivalent. This parameter is ignored in Word documents.
+         * Specify whether to get only the visible (that is, filtered-in) data or all the data. Useful when filtering data. Use {@link Office.FilterType} or string equivalent. This parameter is ignored in Word documents.
          */
         filterType?: Office.FilterType | string
         /**
@@ -932,7 +933,7 @@ declare namespace Office {
      * Provides options for whether to select the location that is navigated to.
      *
      * @remarks
-     * The behavior caused by the options.selectionMode option varies by host:
+     * The behavior caused by the {@link Office.SelectionMode | options.selectionMode} option varies by host:
      *
      * In Excel: Office.SelectionMode.Selected selects all content in the binding, or named item. Office.SelectionMode.None for text bindings, selects the cell; for matrix bindings, table bindings, and named items, selects the first data cell (not first cell in header row for tables).
      *
@@ -942,7 +943,7 @@ declare namespace Office {
      */
     interface GoToByIdOptions {
         /**
-         * Specifies whether the location specified by the id parameter is selected (highlighted). Use Office.SelectionMode or string equivalent. See the Remarks for more information.
+         * Specifies whether the location specified by the id parameter is selected (highlighted). Use {@link Office.SelectionMode} or string equivalent. See the Remarks for more information.
          */
         selectionMode?: Office.SelectionMode | string
         /**
@@ -955,8 +956,9 @@ declare namespace Office {
      */
     interface SetSelectedDataOptions {
         /**
-         * Use only with binding type table and when a TableData object is passed for the data parameter. An array of objects that specify a range of columns, rows, or cells and specify, as key-value pairs, the cell formatting to apply to that range. Example: [{cells: Office.Table.Data, format: {fontColor: "yellow"}},
-        {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]
+         * Use only with binding type table and when a TableData object is passed for the data parameter. An array of objects that specify a range of columns, rows, or cells and specify, as key-value pairs, the cell formatting to apply to that range. 
+         * 
+         * Example: `[{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]`
          */
         cellFormat?: Array<RangeFormatConfiguration>
         /**
@@ -964,7 +966,7 @@ declare namespace Office {
          */
         coercionType?: Office.CoercionType | string
         /**
-         * For an inserted table, a list of key-value pairs that specify table formatting options, such as header row, total row, and banded rows. Example: {bandedRows: true,  filterButton: false}
+         * For an inserted table, a list of key-value pairs that specify table formatting options, such as header row, total row, and banded rows. Example: `{bandedRows: true,  filterButton: false}`
          */
         tableOptions?: object
         /**
@@ -1092,7 +1094,7 @@ declare namespace Office {
      * Specifies how to coerce data returned or set by the invoked method.
      *
      * @remarks
-     * PowerPoint supports only Office.CoercionType.Text, Office.CoercionType.Image, and Office.CoercionType.SlideRange. Project supports only Office.CoercionType.Text.
+     * PowerPoint supports only `Office.CoercionType.Text`, `Office.CoercionType.Image`, and `Office.CoercionType.SlideRange`. Project supports only `Office.CoercionType.Text`.
      *
      * Hosts: Access, Excel, Outlook, PowerPoint, Project, Word
      */
@@ -1126,7 +1128,7 @@ declare namespace Office {
          */
         Ooxml,
         /**
-         * Return a JSON object that contains an array of the ids, titles, and indexes of the selected slides.For example,  {"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]} for a selection of two slides.
+         * Return a JSON object that contains an array of the ids, titles, and indexes of the selected slides.For example,  `{"slides":[{"id":257,"title":"Slide 2","index":2},{"id":256,"title":"Slide 1","index":1}]}` for a selection of two slides.
          * @remarks
          * Only applies to data in PowerPoint when calling the Document.getSelectedData method to get the current slide or selected range of slides.
          */
@@ -1194,10 +1196,10 @@ declare namespace Office {
         Text,
     }
     /**
-     * Specifies the kind of event that was raised. Returned by the type property of an EventNameEventArgs object.
+     * Specifies the kind of event that was raised. Returned by the `type` property of an *EventName*EventArgs object.
      *
      * @remarks
-     * Add-ins for Project support the Office.EventType.ResourceSelectionChanged, Office.EventType.TaskSelectionChanged, and Office.EventType.ViewSelectionChanged event types.
+     * Add-ins for Project support the `Office.EventType.ResourceSelectionChanged`, `Office.EventType.TaskSelectionChanged`, and `Office.EventType.ViewSelectionChanged` event types.
      *
      * Hosts: Access, Excel, PowerPoint, Project, Word
      */
@@ -1385,6 +1387,8 @@ declare namespace Office {
     * The Binding object is never called directly. It is the abstract parent class of the objects that represent each type of binding: MatrixBinding, TableBinding, or TextBinding. All three of these objects inherit the getDataAsync and setDataAsync methods from the Binding object that enable to you interact with the data in the binding. They also inherit the id and type properties for querying those property values. Additionally, the MatrixBinding and TableBinding objects expose additional methods for matrix- and table-specific features, such as counting the number of rows and columns.
     */
     interface Binding {
+
+
         /**
         * Get the Document object associated with the binding.
         *
@@ -1479,9 +1483,9 @@ declare namespace Office {
     */
     interface Bindings {
         /**
-        * Gets a Document object that represents the document associated with this set of bindings.
+        * Gets an {@link Office.Document} object that represents the document associated with this set of bindings.
         *
-        *remarks
+        * @remarks
         * Hosts: Access, Excel, Word
         */
         document: Document;
@@ -1499,14 +1503,14 @@ declare namespace Office {
          *
          *     Note: In Excel, when specifying a table as a named item, you must fully qualify the name to include the worksheet name in the name of the table in this format: "Sheet1!Table1"
          *
-         * For Word, the itemName parameter refers to the Title property of a Rich Text content control. (You can't bind to content controls other than the Rich Text content control.)
+         * For Word, the itemName parameter refers to the Title property of a Rich Text content control. (You can't bind to content controls other than the Rich Text content control).
          *
          * By default, a content control has no Title value assigned. To assign a meaningful name in the Word UI, after inserting a Rich Text content control from the Controls group on the Developer tab of the ribbon, use the Properties command in the Controls group to display the Content Control Properties dialog box. Then set the Title property of the content control to the name you want to reference from your code.
          *
          *     Note: In Word, if there are multiple Rich Text content controls with the same Title property value (name), and you try to bind to one these content controls with this method (by specifying its name as the itemName parameter), the operation will fail.
          *
          * @param itemName Name of the bindable object in the document. For Example 'MyExpenses' table in Excel."
-         * @param bindingType The Office BindingType for the data. The method returns null if the selected object cannot be coerced into the specified type.
+         * @param bindingType The {@link Office.BindingType} for the data. The method returns null if the selected object cannot be coerced into the specified type.
          * @param options Provides options for configuring the binding that is created.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
@@ -1712,7 +1716,7 @@ declare namespace Office {
         setXmlAsync(xml: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
     }
     /**
-     * Represents a single CustomXMLPart in a CustomXMLParts collection.
+     * Represents a single CustomXMLPart in an {@link Office.CustomXmlParts} collection.
      *
      * @remarks
      * Hosts: Word
@@ -1739,7 +1743,7 @@ declare namespace Office {
          */
         id: string;
         /**
-         * Gets the set of namespace prefix mappings (CustomXMLPrefixMappings) used against the current CustomXMLPart.
+         * Gets the set of namespace prefix mappings ({@link Office.CustomXmlPrefixMappings}) used against the current CustomXMLPart.
          *
          * @remarks
          * Hosts: Word
@@ -1755,9 +1759,9 @@ declare namespace Office {
          *
          * You can add multiple event handlers for the specified eventType as long as the name of each event handler function is unique.
          *
-         * @param eventType Specifies the type of event to add. Required. For a CustomXmlPart object event, the eventType parameter can be specified as Office.EventType.DataNodeDeleted, Office.EventType.DataNodeInserted, Office.EventType.DataNodeReplaced, or the corresponding text values of these enumerations.
+         * @param eventType Specifies the type of event to add. Required. For a CustomXmlPart object event, the eventType parameter can be specified as `Office.EventType.DataNodeDeleted`, `Office.EventType.DataNodeInserted`, `Office.EventType.DataNodeReplaced`, or the corresponding text values of these enumerations.
          * @param handler The event handler function to add, whose only parameter is of type NodeDeletedEventArgs, NodeInsertedEventArgs, or NodeReplaceEventArgs. Required.
-         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback..
+         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
         addHandlerAsync(eventType: EventType, handler: (result: any) => void, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
@@ -1806,7 +1810,7 @@ declare namespace Office {
          *
          * Available in Requirement set: CustomXmlParts
          *
-         * @param eventType Specifies the type of event to remove. Required.For a CustomXmlPart object event, the eventType parameter can be specified as Office.EventType.DataNodeDeleted, Office.EventType.DataNodeInserted, Office.EventType.DataNodeReplaced, or the corresponding text values of these enumerations.
+         * @param eventType Specifies the type of event to remove. Required.For a CustomXmlPart object event, the eventType parameter can be specified as `Office.EventType.DataNodeDeleted`, `Office.EventType.DataNodeInserted`, `Office.EventType.DataNodeReplaced`, or the corresponding text values of these enumerations.
          * @param options Provides options to determine which event handler or handlers are removed.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
@@ -1843,7 +1847,7 @@ declare namespace Office {
          * Available in Requirement set: CustomXmlParts
          *
          * @param id The GUID of the custom XML part, including opening and closing braces.
-         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback..
+         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
         getByIdAsync(id: string, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
@@ -1928,7 +1932,7 @@ declare namespace Office {
          * @remarks
          * Hosts: Access, Excel, Word
          *
-         * You don't instantiate the Document object directly in your script. To call members of the Document object to interact with the current document or worksheet, use Office.context.document in your script.
+         * You don't instantiate the Document object directly in your script. To call members of the Document object to interact with the current document or worksheet, use `Office.context.document` in your script.
          */
         bindings: Bindings;
         /**
@@ -1969,8 +1973,8 @@ declare namespace Office {
          *
          * You can add multiple event handlers for the specified eventType as long as the name of each event handler function is unique.
          *
-         * @param eventType For a Document object event, the eventType parameter can be specified as Office.EventType.Document.SelectionChanged or Office.EventType.Document.ActiveViewChanged, or the corresponding text value of this enumeration.
-         * @param handler The event handler function to add, whose only parameter is of type DocumentSelectionChangedEventArgs. Required.
+         * @param eventType For a Document object event, the eventType parameter can be specified as `Office.EventType.Document.SelectionChanged` or `Office.EventType.Document.ActiveViewChanged`, or the corresponding text value of this enumeration.
+         * @param handler The event handler function to add, whose only parameter is of type {@link Office.DocumentSelectionChangedEventArgs}. Required.
          * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
@@ -1985,7 +1989,7 @@ declare namespace Office {
          *
          * Can trigger an event when the view changes.
          *
-         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback..
+         * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
         */
         getActiveViewAsync(options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
@@ -1999,15 +2003,15 @@ declare namespace Office {
          *
          * For add-ins running in Office host applications other than Office for iOS, the getFileAsync method supports getting files in slices of up to 4194304 bytes (4 MB). For add-ins running in Office for iOS apps, the getFileAsync method supports getting files in slices of up to 65536 (64 KB).
          *
-         * The fileType parameter can be specified by using the FileType enumeration or text values. But the possible values vary with the host:
+         * The fileType parameter can be specified by using the {@link Office.FileType} enumeration or text values. But the possible values vary with the host:
          *
-         * Excel Online, Win32, Mac, and iOS: Office.FileType.Compressed
+         * Excel Online, Win32, Mac, and iOS: `Office.FileType.Compressed`
          *
-         * PowerPoint on Windows desktop, Mac, and iPad, and PowerPoint Online: Office.FileType.Compressed, Office.FileType.Pdf
+         * PowerPoint on Windows desktop, Mac, and iPad, and PowerPoint Online: `Office.FileType.Compressed`, `Office.FileType.Pdf`
          *
-         * Word on Windows desktop, Word on Mac, and Word Online: Office.FileType.Compressed, Office.FileType.Pdf, Office.FileType.Text
+         * Word on Windows desktop, Word on Mac, and Word Online: `Office.FileType.Compressed`, `Office.FileType.Pdf`, `Office.FileType.Text`
          *
-         * Word on iPad: Office.FileType.Compressed, Office.FileType.Text
+         * Word on iPad: `Office.FileType.Compressed`, `Office.FileType.Text`
          *
          * @param fileType The format in which the file will be returned
          * @param options Provides options for setting the size of slices that the document will be divided into.
@@ -2022,7 +2026,7 @@ declare namespace Office {
          *
          * Available in Requirement set: not in a set
          *
-         * You get the file's URL with the url property ( asyncResult.value.url).
+         * You get the file's URL with the url property (`asyncResult.value.url`).
          *
          * @param options Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
@@ -2038,17 +2042,17 @@ declare namespace Office {
          *
          * The possible values for the coercionType parameter vary by the host:
          *
-         * Excel, Excel Online, PowerPoint, PowerPoint Online, Word, and Word Online only: Office.CoercionType.Text (string)
+         * Excel, Excel Online, PowerPoint, PowerPoint Online, Word, and Word Online only: `Office.CoercionType.Text` (string)
          *
-         * Excel, Word, and Word Online only: Office.CoercionType.Matrix (array of arrays)
+         * Excel, Word, and Word Online only: `Office.CoercionType.Matrix` (array of arrays)
          *
-         * Access, Excel, Word, and Word Online only: Office.CoercionType.Table (TableData object)
+         * Access, Excel, Word, and Word Online only: `Office.CoercionType.Table` (TableData object)
          *
-         * Word only: Office.CoercionType.Html
+         * Word only: `Office.CoercionType.Html`
          *
-         * Word and Word Online only: Office.CoercionType.Ooxml (Office Open XML)
+         * Word and Word Online only: `Office.CoercionType.Ooxml` (Office Open XML)
          *
-         * PowerPoint and PowerPoint Online only: Office.CoercionType.SlideRange
+         * PowerPoint and PowerPoint Online only: `Office.CoercionType.SlideRange`
          *
          * @param coercionType The type of data structure to return.
          * @param options Provides options for customizing what data is returned and how it is formatted.
@@ -2088,7 +2092,7 @@ declare namespace Office {
          * Available in Requirement set: DocumentEvents
          *
          * @param eventType The event type. For document can be 'Document.SelectionChanged' or 'Document.ActiveViewChanged'.
-         * @param options Provides options to determine which event handler or handlers are removed.         *
+         * @param options Provides options to determine which event handler or handlers are removed.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
         removeHandlerAsync(eventType: EventType, options?: RemoveHandlerOptions, callback?: (result: AsyncResult) => void): void;
@@ -2114,7 +2118,7 @@ declare namespace Office {
          *
          * Office.CoercionType.Image: Excel, Word, PowerPoint
          *
-         * @param data The data to be set. Either a string or CoercionType value, 2d array or TableData object.
+         * @param data The data to be set. Either a string or {@link Office.CoercionType} value, 2d array or TableData object.
          * @param options Provides options for how to insert data to the selection.
          * @param callback Optional. A function that is invoked when the callback returns, whose only parameter is of type AsyncResult.
          */
@@ -2179,11 +2183,11 @@ declare namespace Office {
      */
     interface DocumentSelectionChangedEventArgs {
         /**
-         * Gets a Document object that represents the document that raised the SelectionChanged event.
+         * Gets an {@link Office.Document} object that represents the document that raised the SelectionChanged event.
          */
         document: Document;
         /**
-         * Get an EventType enumeration value that identifies the kind of event that was raised.
+         * Get an {@link Office.EventType} enumeration value that identifies the kind of event that was raised.
          */
         type: EventType;
     }
@@ -2262,15 +2266,15 @@ declare namespace Office {
         url: string
     }
     /**
-    * Represents a binding in two dimensions of rows and columns.
-    *
-    * @remarks
-         * Hosts: Excel, Word
-    *
-    * Available in Requirement set: MatrixBindings
-    *
-    * The MatrixBinding object inherits the id property, type property, getDataAsync method, and setDataAsync method from the Binding object.
-    */
+     * Represents a binding in two dimensions of rows and columns.
+     *
+     * @remarks
+     * Hosts: Excel, Word
+     *
+     * Available in Requirement set: MatrixBindings
+     *
+     * The MatrixBinding object inherits the id property, type property, getDataAsync method, and setDataAsync method from the Binding object.
+     */
     interface MatrixBinding extends Binding {
         /**
         * Gets the number of columns in the matrix data structure, as an integer value.
@@ -2453,7 +2457,7 @@ declare namespace Office {
      */
     interface Slice {
         /**
-         * Gets the raw data of the file slice in Office.FileType.Text ("text") or Office.FileType.Compressed ("compressed") format as specified by the fileType parameter of the call to the Document.getFileAsync method.
+         * Gets the raw data of the file slice in `Office.FileType.Text` ("text") or `Office.FileType.Compressed` ("compressed") format as specified by the fileType parameter of the call to the Document.getFileAsync method.
          *
          * @remarks
          * Files in the "compressed" format will return a byte array that can be transformed to a base64-encoded string if required.
@@ -2652,7 +2656,7 @@ declare namespace Office {
         setTableOptionsAsync(tableOptions: any, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
     }
     /**
-     * Represents the data in a table or a TableBinding.
+     * Represents the data in a table or a {@link Office.TableBinding}.
      *
      * @remarks
      * Hosts: Excel, Word
@@ -2664,6 +2668,7 @@ declare namespace Office {
         constructor();
         /**
          * Gets or sets the headers of the table.
+         * 
          * @remarks
          * To specify headers, you must specify an array of arrays that corresponds to the structure of the table. For example, to specify headers for a two-column table you would set the header property to [['header1', 'header2']].
          *
@@ -2680,6 +2685,7 @@ declare namespace Office {
         headers: any[];
         /**
          * Gets or sets the rows in the table. Returns an array of arrays that contains the data in the table. Returns an empty array ``, if there are no rows.
+         * 
          * @remarks
          * To specify rows, you must specify an array of arrays that corresponds to the structure of the table. For example, to specify two rows of string values in a two-column table you would set the rows property to [['a', 'b'], ['c', 'd']].
          *
@@ -2723,7 +2729,7 @@ declare namespace Office {
     *
     * Available in Requirement set: TextBindings
     *
-    * The TextBinding object inherits the id property, type property, getDataAsync method, and setDataAsync method from the Binding object. It does not implement any additional properties or methods of its own.
+    * The TextBinding object inherits the id property, type property, getDataAsync method, and setDataAsync method from the {@link Office.Binding} object. It does not implement any additional properties or methods of its own.
     */
     interface TextBinding extends Binding { }
     /**
@@ -6126,7 +6132,7 @@ declare namespace Office {
     /**
      * Represents a contact stored on the server. Read mode only.
      *
-     * The list of contacts associated with an email message or appointment is returned in the contacts property of the Entities object that is returned by the getEntities or getEntitiesByType method of the active item.
+     * The list of contacts associated with an email message or appointment is returned in the contacts property of the {@link Office.Entities} object that is returned by the getEntities or getEntitiesByType method of the active item.
      *
      * [Api set: Mailbox 1.0]
      *
@@ -6416,7 +6422,7 @@ declare namespace Office {
          * 
          * The getAsync method starts an asynchronous call to the Exchange server to get the from value of a message.
          * 
-         * The from value of the item is provided as an EmailAddressDetails in the asyncResult.value property.
+         * The from value of the item is provided as an {@link Office.EmailAddressDetails} in the asyncResult.value property.
          * 
          * [Api set: Mailbox Preview]
          * 
@@ -8528,9 +8534,9 @@ declare namespace Office {
          * Applicable Outlook mode: Read
          *
          * @param parameters A dictionary containing all values to be filled in for the user in the new form. All parameters are optional.
-         *        toRecipients: An array of strings containing the email addresses or an array containing an EmailAddressDetails object for each of the recipients on the To line. The array is limited to a maximum of 100 entries.
-         *        ccRecipients: An array of strings containing the email addresses or an array containing an EmailAddressDetails object for each of the recipients on the Cc line. The array is limited to a maximum of 100 entries.
-         *        bccRecipients: An array of strings containing the email addresses or an array containing an EmailAddressDetails object for each of the recipients on the Bcc line. The array is limited to a maximum of 100 entries.
+         *        toRecipients: An array of strings containing the email addresses or an array containing an {@link Office.EmailAddressDetails} object for each of the recipients on the To line. The array is limited to a maximum of 100 entries.
+         *        ccRecipients: An array of strings containing the email addresses or an array containing an {@link Office.EmailAddressDetails} object for each of the recipients on the Cc line. The array is limited to a maximum of 100 entries.
+         *        bccRecipients: An array of strings containing the email addresses or an array containing an {@link Office.EmailAddressDetails} object for each of the recipients on the Bcc line. The array is limited to a maximum of 100 entries.
          *        subject: A string containing the subject of the message. The string is limited to a maximum of 255 characters.
          *        htmlBody: The HTML body of the message. The body content is limited to a maximum size of 32 KB.
          *        attachments: An array of JSON objects that are either file or item attachments.
@@ -8665,7 +8671,7 @@ declare namespace Office {
          *
          * When you use the makeEwsRequestAsync method in mail apps running in Outlook versions earlier than version 15.0.4535.1004, you should set the encoding value to ISO-8859-1.
          *
-         * <?xml version="1.0" encoding="iso-8859-1"?>
+         * `<?xml version="1.0" encoding="iso-8859-1"?>`
          *
          * You do not need to set the encoding value when your mail app is running in Outlook on the web. You can determine whether your mail app is running in Outlook or Outlook on the web by using the mailbox.diagnostics.hostName property. You can determine what version of Outlook is running by using the mailbox.diagnostics.hostVersion property.
          *
@@ -8740,7 +8746,7 @@ declare namespace Office {
          */
         key?: string;
         /**
-         * Specifies the Office.MailboxEnums.ItemNotificationMessageType of message. If type is ProgressIndicator or ErrorMessage, an icon is automatically supplied and the message is not persistent. Therefore the icon and persistent properties are not valid for these types of messages. Including them will result in an ArgumentException. If type is ProgressIndicator, the developer should remove or replace the progress indicator when the action is complete.
+         * Specifies the {@link Office.MailboxEnums.ItemNotificationMessageType} of message. If type is ProgressIndicator or ErrorMessage, an icon is automatically supplied and the message is not persistent. Therefore the icon and persistent properties are not valid for these types of messages. Including them will result in an ArgumentException. If type is ProgressIndicator, the developer should remove or replace the progress indicator when the action is complete.
          */
         type: Office.MailboxEnums.ItemNotificationMessageType;
         /**
@@ -8786,8 +8792,11 @@ declare namespace Office {
          * Applicable Outlook mode: Compose or read
          * 
          * In addition to this signature, the method also has the following signatures:
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails): void;
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails, options: AsyncContextOptions): void;
+         * 
          * addAsync(key: string, JSONmessage: NotificationMessageDetails, callback: (result: AsyncResult) => void): void;
          * 
          */
@@ -8887,7 +8896,7 @@ declare namespace Office {
          * In addition to the main signature, this method also has these signatures:
          * removeAsync(key: string): void;
          * removeAsync(key: string, options: AsyncContextOptions): void;
-         * removeAsync(key: string, callback: (result: AsyncResult) => void): void;         * 
+         * removeAsync(key: string, callback: (result: AsyncResult) => void): void;
          *
          * @param key The key for the notification message to remove.
          * @param options Optional. An object literal that contains one or more of the following properties.
@@ -9109,9 +9118,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9134,9 +9143,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9154,7 +9163,7 @@ declare namespace Office {
         /**
          * Gets a recipient list for an appointment or message.
          *
-         * When the call completes, the asyncResult.value property will contain an array of EmailAddressDetails objects.
+         * When the call completes, the asyncResult.value property will contain an array of{@link Office. EmailAddressDetails} objects.
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9174,7 +9183,7 @@ declare namespace Office {
         /**
          * Gets a recipient list for an appointment or message.
          *
-         * When the call completes, the asyncResult.value property will contain an array of EmailAddressDetails objects.
+         * When the call completes, the asyncResult.value property will contain an array of {@link Office.EmailAddressDetails} objects.
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9195,9 +9204,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9228,9 +9237,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9253,9 +9262,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -9280,9 +9289,9 @@ declare namespace Office {
          *
          * - Strings containing SMTP email addresses
          *
-         * - EmailUser objects
+         * - {@link Office.EmailUser} objects
          *
-         * - EmailAddressDetails objects
+         * - {@link Office.EmailAddressDetails} objects
          *
          * [Api set: Mailbox 1.1]
          *
@@ -10188,11 +10197,11 @@ declare namespace Office {
 ////////////////////////////////////////////////////////////////
 
 declare namespace OfficeExtension {
-    /** An abstract proxy object that represents an object in an Office document. You create proxy objects from the context (or from other proxy objects), add commands to a queue to act on the object, and then synchronize the proxy object state with the document by calling "context.sync()". */
+    /** An abstract proxy object that represents an object in an Office document. You create proxy objects from the context (or from other proxy objects), add commands to a queue to act on the object, and then synchronize the proxy object state with the document by calling `context.sync()`. */
     class ClientObject {
         /** The request context associated with the object */
         context: ClientRequestContext;
-        /** Returns a boolean value for whether the corresponding object is a null object. You must call "context.sync()" before reading the isNullObject property. */
+        /** Returns a boolean value for whether the corresponding object is a null object. You must call `context.sync()` before reading the isNullObject property. */
         isNullObject: boolean;
     }
 }
@@ -10221,7 +10230,7 @@ declare namespace OfficeExtension {
         pendingStatements: string[];
     }
 
-    /** An abstract RequestContext object that facilitates requests to the host Office application. The "Excel.run" and "Word.run" methods provide a request context. */
+    /** An abstract {@link Office.RequestContext} object that facilitates requests to the host Office application. The `Excel.run and `Word.run` methods provide a request context. */
     class ClientRequestContext {
         constructor(url?: string);
 
@@ -10231,23 +10240,24 @@ declare namespace OfficeExtension {
         /** Request headers */
         requestHeaders: { [name: string]: string };
 
-        /** Queues up a command to load the specified properties of the object. You must call "context.sync()" before reading the properties. */
+        /** Queues up a command to load the specified properties of the object. You must call `context.sync()` before reading the properties. */
         load(object: ClientObject, option?: string | string[] | LoadOption): void;
 
         /**
         * Queues up a command to recursively load the specified properties of the object and its navigation properties.
-        * You must call "context.sync()" before reading the properties.
+        * 
+        * You must call `context.sync()` before reading the properties.
         *
         * @param object The object to be loaded.
-        * @param options The key-value pairing of load options for the types, such as { "Workbook": "worksheets,tables",  "Worksheet": "tables",  "Tables": "name" }
+        * @param options The key-value pairing of load options for the types, such as `{ "Workbook": "worksheets,tables",  "Worksheet": "tables",  "Tables": "name" }`
         * @param maxDepth The maximum recursive depth.
         */
         loadRecursive(object: ClientObject, options: { [typeName: string]: string | string[] | LoadOption }, maxDepth?: number): void;
 
-        /** Adds a trace message to the queue. If the promise returned by "context.sync()" is rejected due to an error, this adds a ".traceMessages" array to the OfficeExtension.Error object, containing all trace messages that were executed. These messages can help you monitor the program execution sequence and detect the cause of the error. */
+        /** Adds a trace message to the queue. If the promise returned by `context.sync()` is rejected due to an error, this adds a ".traceMessages" array to the OfficeExtension.Error object, containing all trace messages that were executed. These messages can help you monitor the program execution sequence and detect the cause of the error. */
         trace(message: string): void;
 
-        /** Synchronizes the state between JavaScript proxy objects and the Office document, by executing instructions queued on the request context and retrieving properties of loaded Office objects for use in your code.�This method returns a promise, which is resolved when the synchronization is complete. */
+        /** Synchronizes the state between JavaScript proxy objects and the Office document, by executing instructions queued on the request context and retrieving properties of loaded Office objects for use in your code. This method returns a promise, which is resolved when the synchronization is complete. */
         sync<T>(passThroughValue?: T): Promise<T>;
 
         /** Debug information */
@@ -10270,9 +10280,9 @@ declare namespace OfficeExtension {
 }
 
 declare namespace OfficeExtension {
-    /** Contains the result for methods that return primitive types. The object's value property is retrieved from the document after "context.sync()" is invoked. */
+    /** Contains the result for methods that return primitive types. The object's value property is retrieved from the document after `context.sync()` is invoked. */
     class ClientResult<T> {
-        /** The value of the result that is retrieved from the document after "context.sync()" is invoked. */
+        /** The value of the result that is retrieved from the document after `context.sync()` is invoked. */
         value: T;
     }
 }
@@ -10324,7 +10334,7 @@ declare namespace OfficeExtension {
         fullStatements?: string[];
     }
 
-    /** The error object returned by "context.sync()", if a promise is rejected due to an error while processing the request. */
+    /** The error object returned by `context.sync()`, if a promise is rejected due to an error while processing the request. */
     class Error {
         /** Error name: "OfficeExtension.Error".*/
         name: string;
@@ -10334,9 +10344,9 @@ declare namespace OfficeExtension {
         stack: string;
         /** Error code string, such as "InvalidArgument". */
         code: string;
-        /** Trace messages (if any) that were added via a "context.trace()" invocation before calling "context.sync()". If there was an error, this contains all trace messages that were executed before the error occurred. These messages can help you monitor the program execution sequence and detect the case of the error. */
+        /** Trace messages (if any) that were added via a `context.trace()` invocation before calling `context.sync()`. If there was an error, this contains all trace messages that were executed before the error occurred. These messages can help you monitor the program execution sequence and detect the case of the error. */
         traceMessages: Array<string>;
-        /** Debug info (useful for detailed logging of the error, i.e., via JSON.stringify(...)). */
+        /** Debug info (useful for detailed logging of the error, i.e., via `JSON.stringify(...)`). */
         debugInfo: DebugInfo;
         /** Inner error, if applicable. */
         innerError: Error;
@@ -10361,7 +10371,7 @@ declare namespace OfficeExtension {
 }
 
 declare namespace OfficeExtension {
-    /** A Promise object that represents a deferred interaction with the host Office application. The publicly-consumable OfficeExtension.Promise is available starting in ExcelApi 1.2 and WordApi 1.2. Promises can be chained via ".then", and errors can be caught via ".catch". Remember to always use a ".catch" on the outer promise, and to return intermediary promises so as not to break the promise chain. When a browser-provided native Promise implementation is available, OfficeExtension.Promise will switch to use the native Promise instead. */
+    /** A Promise object that represents a deferred interaction with the host Office application. The publicly-consumable {@link Office.OfficeExtension.Promise} is available starting in ExcelApi 1.2 and WordApi 1.2. Promises can be chained via ".then", and errors can be caught via ".catch". Remember to always use a ".catch" on the outer promise, and to return intermediary promises so as not to break the promise chain. When a browser-provided native Promise implementation is available, OfficeExtension.Promise will switch to use the native Promise instead. */
     const Promise: Office.IPromiseConstructor;
     type IPromise<T> = Promise<T>;
 }
@@ -10373,9 +10383,9 @@ declare namespace OfficeExtension {
         add(object: ClientObject): void;
         /** Track a new object for automatic adjustment based on surrounding changes in the document. Only some object types require this. If you are using an object across ".sync" calls and outside the sequential execution of a ".run" batch, and get an "InvalidObjectPath" error when setting a property or invoking a method on the object, you needed to have added the object to the tracked object collection when the object was first created. */
         add(objects: ClientObject[]): void;
-        /** Release the memory associated with an object that was previously added to this collection. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call "context.sync()" before the memory release takes effect. */
+        /** Release the memory associated with an object that was previously added to this collection. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect. */
         remove(object: ClientObject): void;
-        /** Release the memory associated with an object that was previously added to this collection. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call "context.sync()" before the memory release takes effect. */
+        /** Release the memory associated with an object that was previously added to this collection. Having many tracked objects slows down the host application, so please remember to free any objects you add, once you're done using them. You will need to call `context.sync()` before the memory release takes effect. */
         remove(objects: ClientObject[]): void;
     }
 }
@@ -10633,45 +10643,45 @@ declare namespace Excel {
     }
     /**
      * Executes a batch script that performs actions on the Excel object model, using a new RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using a new remote RequestContext. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
      * @param requestInfo - The URL of the remote workbook and the request headers to be sent.
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(requestInfo: OfficeExtension.RequestUrlAndHeaderInfo | Session, batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using the RequestContext of a previously-created object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
-     * @param contextObject - A previously-created object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by "context.sync()".
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param contextObject - A previously-created object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by `context.sync()`.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(contextObject: OfficeExtension.ClientRequestContext, batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using the RequestContext of a previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
-     * @param object - A previously-created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by "context.sync()".
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param object - A previously-created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by `context.sync()`.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(object: OfficeExtension.ClientObject, batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using the remote RequestContext of a previously-created API object. When the promise is resolved, any tracked objects that were automatically allocated during execution will be released.
      * @param requestInfo - The URL of the remote workbook and the request headers to be sent.
-     * @param object - A previously-created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by "context.sync()".
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param object - A previously-created API object. The batch will use the same RequestContext as the passed-in object, which means that any changes applied to the object will be picked up by `context.sync()`.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(requestInfo: OfficeExtension.RequestUrlAndHeaderInfo | Session, object: OfficeExtension.ClientObject, batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using the RequestContext of previously-created API objects.
-     * @param objects - An array of previously-created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by "context.sync()".
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param objects - An array of previously-created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by `context.sync()`.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**
      * Executes a batch script that performs actions on the Excel object model, using the remote RequestContext of previously-created API objects.
      * @param requestInfo - The URL of the remote workbook and the request headers to be sent.
-     * @param objects - An array of previously-created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by "context.sync()".
-     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of "context.sync()"). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
+     * @param objects - An array of previously-created API objects. The array will be validated to make sure that all of the objects share the same context. The batch will use this shared RequestContext, which means that any changes applied to these objects will be picked up by `context.sync()`.
+     * @param batch - A function that takes in a RequestContext and returns a promise (typically, just the result of `context.sync()`). The context parameter facilitates requests to the Excel application. Since the Office add-in and the Excel application run in two different processes, the RequestContext is required to get access to the Excel object model from the add-in.
      */
     function run<T>(requestInfo: OfficeExtension.RequestUrlAndHeaderInfo | Session, objects: OfficeExtension.ClientObject[], batch: (context: Excel.RequestContext) => Promise<T>): Promise<T>;
     /**

From 50e74c675aa0f11ca9daee07f3a98b0b419c066c Mon Sep 17 00:00:00 2001
From: Jinwoo Lee <jinwoo@google.com>
Date: Thu, 14 Jun 2018 11:17:55 -0700
Subject: [PATCH 112/180] add myself to "Definitions by"

---
 types/cosmiconfig/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/cosmiconfig/index.d.ts b/types/cosmiconfig/index.d.ts
index 3a70e98511..94e28e9dab 100644
--- a/types/cosmiconfig/index.d.ts
+++ b/types/cosmiconfig/index.d.ts
@@ -3,6 +3,7 @@
 // Definitions by: ozum <https://github.com/ozum>
 //                 szeck87 <https://github.com/szeck87>
 //                 saadq <https://github.com/saadq>
+//                 jinwoo <https://github.com/jinwoo>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.2
 

From 65696432b095adac0ab507376559b0b629cf51d3 Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Thu, 14 Jun 2018 14:27:53 -0700
Subject: [PATCH 113/180] Moving tables to remarks

---
 types/office-js/index.d.ts | 84 ++++++++++++++++++++------------------
 1 file changed, 45 insertions(+), 39 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index b799adcf5f..4775a67478 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -7703,12 +7703,7 @@ declare namespace Office {
         /**
          * Gets the Exchange Web Services item class of the selected item.
          *
-         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
-         *
-         * [div class="mx-tdBreakAll"|Type|Description|item class|
-         * |-----------|------------|------------|
-         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
-         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
+
          *
          * You can create custom message classes that extends a default message class, for example, a custom appointment message class IPM.Appointment.Contoso.
          *
@@ -7719,6 +7714,13 @@ declare namespace Office {
          * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Appointment Attendee
+         * 
+         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
+         * 
+         * |Type|Description|item class|
+         * |-----------|------------|------------|
+         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
+         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
          */
         itemClass: string;
         /**
@@ -7868,11 +7870,19 @@ declare namespace Office {
          * Note: This method is not supported in Outlook for iOS or Outlook for Android.
          *
          * [Api set: Mailbox 1.0]
+         * 
+         * @param entityType One of the EntityType enumeration values.
          *
          * @returns
          * If the value passed in entityType is not a valid member of the EntityType enumeration, the method returns null. If no entities of the specified type are present on the item, the method returns an empty array. Otherwise, the type of the objects in the returned array depends on the type of entity requested in the entityType parameter.
          *
+         * @remarks
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         *
+         * Applicable Outlook mode: Appointment Attendee
+         * 
          * While the minimum permission level to use this method is Restricted, some entity types require ReadItem to access, as specified in the following table.
+         * 
          * |Value of entityType|Type of objects in returned array|Required Permission Level|
          * |-------|-----------|----------|
          * |Address|String|Restricted|
@@ -7882,13 +7892,6 @@ declare namespace Office {
          * |PhoneNumber|PhoneNumber|Restricted|
          * |TaskSuggestion|TaskSuggestion|ReadItem|
          * |URL|String|Restricted|
-         *
-         * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
-         *
-         * Applicable Outlook mode: Appointment Attendee
-         *
-         * @param entityType One of the EntityType enumeration values.
          */
         getEntitiesByType(entityType: Office.MailboxEnums.EntityType): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
         /**
@@ -9016,12 +9019,6 @@ declare namespace Office {
         /**
          * Gets the Exchange Web Services item class of the selected item.
          *
-         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
-         *
-         * [div class="mx-tdBreakAll"|Type|Description|item class|
-         * |-----------|------------|------------|
-         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
-         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
          *
          * You can create custom message classes that extends a default message class, for example, a custom appointment message class IPM.Appointment.Contoso.
          *
@@ -9032,6 +9029,13 @@ declare namespace Office {
          * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
          *
          * Applicable Outlook mode: Read
+         * 
+         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
+         * 
+         * |Type|Description|item class|
+         * |-----------|------------|------------|
+         * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
+         * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
          */
         itemClass: string;
         /**
@@ -9181,11 +9185,19 @@ declare namespace Office {
          * Note: This method is not supported in Outlook for iOS or Outlook for Android.
          *
          * [Api set: Mailbox 1.0]
+         * 
+         * @param entityType One of the EntityType enumeration values.
          *
          * @returns
          * If the value passed in entityType is not a valid member of the EntityType enumeration, the method returns null. If no entities of the specified type are present on the item, the method returns an empty array. Otherwise, the type of the objects in the returned array depends on the type of entity requested in the entityType parameter.
          *
+         * @remarks
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         *
+         * Applicable Outlook mode: Read
+         * 
          * While the minimum permission level to use this method is Restricted, some entity types require ReadItem to access, as specified in the following table.
+         * 
          * |Value of entityType|Type of objects in returned array|Required Permission Level|
          * |-------|-----------|----------|
          * |Address|String|Restricted|
@@ -9195,13 +9207,6 @@ declare namespace Office {
          * |PhoneNumber|PhoneNumber|Restricted|
          * |TaskSuggestion|TaskSuggestion|ReadItem|
          * |URL|String|Restricted|
-         *
-         * @remarks
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
-         *
-         * Applicable Outlook mode: Read
-         *
-         * @param entityType One of the EntityType enumeration values.
          */
         getEntitiesByType(entityType: Office.MailboxEnums.EntityType): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
         /**
@@ -10538,23 +10543,24 @@ declare namespace Office {
         attachments: AttachmentDetails[];
         /**
          * Gets the Exchange Web Services item class of the selected item.
-         *
-         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
-         *
+         * 
          * You can create custom message classes that extends a default message class, for example, a custom appointment message class IPM.Appointment.Contoso.
          *
          * [Api set: Mailbox 1.0]
          *
          * @remarks
          *
+
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
+         *
+         * Applicable Outlook mode: Message Read
+         * 
+         * The itemClass property specifies the message class of the selected item. The following are the default message classes for the message or appointment item.
+         * 
          * |Type|Description|Item Class|
          * |-----------|------------|------------|
          * |Appointment items|These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.|IPM.Appointment,IPM.Appointment.Occurence|
          * |Message items|These include email messages that have the default message class IPM.Note, and meeting requests, responses, and cancellations, that use IPM.Schedule.Meeting as the base message class.|IPM.Note,IPM.Schedule.Meeting.Request,IPM.Schedule.Meeting.Neg,IPM.Schedule.Meeting.Pos,IPM.Schedule.Meeting.Tent,IPM.Schedule.Meeting.Canceled|
-         * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: ReadItem
-         *
-         * Applicable Outlook mode: Message Read
          */
         itemClass: string;
         /**
@@ -10709,11 +10715,17 @@ declare namespace Office {
          *
          * [Api set: Mailbox 1.0]
          *
+         * @param entityType One of the EntityType enumeration values.
+         * 
          * @returns
          * If the value passed in entityType is not a valid member of the EntityType enumeration, the method returns null. If no entities of the specified type are present on the item, the method returns an empty array. Otherwise, the type of the objects in the returned array depends on the type of entity requested in the entityType parameter.
          *
          * @remarks
          * 
+         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
+         *
+         * Applicable Outlook mode: Message Read
+         * 
          * While the minimum permission level to use this method is Restricted, some entity types require ReadItem to access, as specified in the following table.
          * 
          * |Value of entityType|Type of objects in returned array|Required Permission Level|
@@ -10725,12 +10737,6 @@ declare namespace Office {
          * |PhoneNumber|PhoneNumber|Restricted|
          * |TaskSuggestion|TaskSuggestion|ReadItem|
          * |URL|String|Restricted|
-         * 
-         * {@link https://docs.microsoft.com/outlook/add-ins/understanding-outlook-add-in-permissions | Minimum permission level}: Restricted
-         *
-         * Applicable Outlook mode: Message Read
-         *
-         * @param entityType One of the EntityType enumeration values.
          */
         getEntitiesByType(entityType: Office.MailboxEnums.EntityType): (string | Contact | MeetingSuggestion | PhoneNumber | TaskSuggestion)[];
         /**

From bdf4fc0819986e414891851aa8b707ccd659ce1b Mon Sep 17 00:00:00 2001
From: Dobes Vandermeer <dobesv@gmail.com>
Date: Thu, 14 Jun 2018 14:57:05 -0700
Subject: [PATCH 114/180] Fix generate() return type

`ObjectID().generate()` returns a `Buffer`, not a `string`

@horiuchi @CaselIT

See https://github.com/mongodb/js-bson/blob/master/lib/bson/objectid.js#L149 for the source code of bson, excerpted here:

```
/**
 * Generate a 12 byte id buffer used in ObjectID's
 *
 * @method
 * @param {number} [time] optional parameter allowing to pass in a second based timestamp.
 * @return {Buffer} return the 12 byte id buffer string.
 */
ObjectID.prototype.generate = function(time) {
  if ('number' !== typeof time) {
    time = ~~(Date.now() / 1000);
  }

  // Use pid
  var pid =
    (typeof process === 'undefined' || process.pid === 1
      ? Math.floor(Math.random() * 100000)
      : process.pid) % 0xffff;
  var inc = this.get_inc();
  // Buffer used
  var buffer = new Buffer(12);
  // Encode time
  buffer[3] = time & 0xff;
  buffer[2] = (time >> 8) & 0xff;
  buffer[1] = (time >> 16) & 0xff;
  buffer[0] = (time >> 24) & 0xff;
  // Encode machine
  buffer[6] = MACHINE_ID & 0xff;
  buffer[5] = (MACHINE_ID >> 8) & 0xff;
  buffer[4] = (MACHINE_ID >> 16) & 0xff;
  // Encode pid
  buffer[8] = pid & 0xff;
  buffer[7] = (pid >> 8) & 0xff;
  // Encode index
  buffer[11] = inc & 0xff;
  buffer[10] = (inc >> 8) & 0xff;
  buffer[9] = (inc >> 16) & 0xff;
  // Return the buffer
  return buffer;
};
```
---
 types/bson/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/bson/index.d.ts b/types/bson/index.d.ts
index 3b0feb0113..4d30097478 100644
--- a/types/bson/index.d.ts
+++ b/types/bson/index.d.ts
@@ -182,7 +182,7 @@ export class ObjectID {
      * @param {number} time optional parameter allowing to pass in a second based timestamp.
      * @return {string} return the 12 byte id binary string.
      */
-    generate(time?: number): string;
+    generate(time?: number): Buffer;
     /**
      * Returns the generation date (accurate up to the second) that this ID was generated.
      * @return {date} the generation date

From 8223535354c4d92ae7b384e9d463b301da55dfc8 Mon Sep 17 00:00:00 2001
From: Hunter Tunnicliff <hunter.tunnicliff@pdxmission.org>
Date: Thu, 14 Jun 2018 14:59:50 -0700
Subject: [PATCH 115/180] Added union type for Subscription to
 IInvoice.subscription

---
 types/stripe/index.d.ts      | 13 +++++++------
 types/stripe/stripe-tests.ts |  4 ++++
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/types/stripe/index.d.ts b/types/stripe/index.d.ts
index 9cf60439c8..41bc3cd48b 100644
--- a/types/stripe/index.d.ts
+++ b/types/stripe/index.d.ts
@@ -9,6 +9,7 @@
 //                 Kensuke Hoshikawa <https://github.com/starhoshi>
 //                 Thomas Bruun <https://github.com/bruun>
 //                 Gal Talmor <https://github.com/galtalmor>
+//                 Hunter Tunnicliff <https://github.com/htunnicliff>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.2
 
@@ -738,7 +739,7 @@ declare namespace Stripe {
              * charge if a partial refund was issued), positive integer or zero.
              */
             amount_refunded: number;
-            
+
             /**
              * ID of the Connect application that created the charge. [Expandable]
              */
@@ -1994,7 +1995,7 @@ declare namespace Stripe {
             /**
              * The subscription that this invoice was prepared for, if any.
              */
-            subscription: string;
+            subscription: string | subscriptions.ISubscription;
 
             /**
              * Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
@@ -2302,7 +2303,7 @@ declare namespace Stripe {
             /**
              * The subscription that this invoice item has been created for, if any.
              */
-            subscription: string;
+            subscription: string | subscriptions.ISubscription;
         }
 
         interface InvoiceItemCreationOptions extends IDataOptionsWithMetadata {
@@ -2389,7 +2390,7 @@ declare namespace Stripe {
              * currency) representing the total amount for the order.
              */
             amount: number;
-            
+
             /**
              * A positive integer in the smallest currency unit (that is, 100 cents for $1.00, or 1 for ¥1, Japanese Yen being a 0-decimal
              * currency) representing the total amount returned for the order thus far.
@@ -5033,7 +5034,7 @@ declare namespace Stripe {
              * String representing the object’s type. Objects of the same type share the same value.
              */
             object: "review";
-            
+
             /**
              * The charge associated with this review. [Expandable]
              */
@@ -5073,7 +5074,7 @@ declare namespace Stripe {
              */
             name: string;
         }
-    } 
+    }
 
     class StripeResource {
         constructor(stripe: Stripe, urlData: any);
diff --git a/types/stripe/stripe-tests.ts b/types/stripe/stripe-tests.ts
index 306ab0442a..ad5f1750fb 100644
--- a/types/stripe/stripe-tests.ts
+++ b/types/stripe/stripe-tests.ts
@@ -1018,6 +1018,10 @@ stripe.invoices.list({ customer: "cus_5rfJKDJkuxzh5Q", limit: 3 }).then(function
     // asynchronously called
 });
 
+stripe.invoices.retrieve("in_15fvyXEe31JkLCeQH7QbgZZb", { expand: ["subscription"] }).then(function (invoice) {
+  invoice.subscription
+})
+
 //#endregion
 
 //#region Invoice Items tests

From d67617c5bb9bdc6981904e1bbef545730c4aa6ea Mon Sep 17 00:00:00 2001
From: Alexaner T <alexander.v.tarasyuk@gmail.com>
Date: Thu, 14 Jun 2018 15:11:49 +0300
Subject: [PATCH 116/180] Change Image onLoad event data

---
 types/react-native/index.d.ts     | 26 +++++++++-
 types/react-native/test/index.tsx | 85 ++++++++++++++++++-------------
 2 files changed, 73 insertions(+), 38 deletions(-)

diff --git a/types/react-native/index.d.ts b/types/react-native/index.d.ts
index b469a5bdf2..e09e3674c1 100644
--- a/types/react-native/index.d.ts
+++ b/types/react-native/index.d.ts
@@ -3412,9 +3412,30 @@ interface ImagePropsAndroid {
     fadeDuration?: number;
 }
 
-// See https://facebook.github.io/react-native/docs/image.html#source
+/**
+ * @see https://facebook.github.io/react-native/docs/image.html#source
+ */
 export type ImageSourcePropType = ImageURISource | ImageURISource[] | ImageRequireSource;
 
+/**
+ * @see ImagePropsBase.onLoad
+ */
+interface ImageLoadEventDataAndroid {
+    uri?: string;
+}
+
+interface ImageLoadEventData extends ImageLoadEventDataAndroid {
+    source: {
+        height: number;
+        width: number;
+        url: string;
+    }
+}
+
+export interface ImageLoadEvent {
+    nativeEvent: ImageLoadEventData;
+}
+
 /**
  * @see https://facebook.github.io/react-native/docs/image.html
  */
@@ -3435,8 +3456,9 @@ export interface ImagePropsBase extends ImagePropsIOS, ImagePropsAndroid, Access
 
     /**
      * Invoked when load completes successfully
+     * { source: { url, height, width } }.
      */
-    onLoad?: () => void;
+    onLoad?: (event: ImageLoadEvent) => void;
 
     /**
      * Invoked when load either succeeds or fails
diff --git a/types/react-native/test/index.tsx b/types/react-native/test/index.tsx
index 2f753eee64..d48fdedce4 100644
--- a/types/react-native/test/index.tsx
+++ b/types/react-native/test/index.tsx
@@ -24,6 +24,7 @@ import {
     Dimensions,
     Image,
     ImageStyle,
+    ImageLoadEvent,
     InteractionManager,
     ListView,
     ListViewDataSource,
@@ -198,19 +199,14 @@ class Welcome extends React.Component {
 
 export default Welcome;
 
-// EventsTest
-export class EventsTest extends React.Component {
-    onPressButton(e: GestureResponderEvent) {
+// TouchableNativeFeedbackTest
+export class TouchableNativeFeedbackTest extends React.Component {
+    onPressButton = (e: GestureResponderEvent) => {
         e.persist();
         e.isPropagationStopped();
         e.isDefaultPrevented();
     }
 
-    onScroll(e: TextInputScrollEvent) {
-        console.log(`x: ${ e.nativeEvent.contentOffset.x }`);
-        console.log(`y: ${ e.nativeEvent.contentOffset.y }`);
-    }
-
     render() {
         return (
             <TouchableNativeFeedback
@@ -218,10 +214,6 @@ export class EventsTest extends React.Component {
             >
                 <View style={{width: 150, height: 100, backgroundColor: 'red'}}>
                     <Text style={{margin: 30}}>Button</Text>
-                    <TextInput
-                        multiline
-                        onScroll={this.onScroll}
-                    />
                 </View>
             </TouchableNativeFeedback>
         )
@@ -229,7 +221,6 @@ export class EventsTest extends React.Component {
 }
 
 // App State
-
 function appStateListener(state: string) {
     console.log("New state: " + state);
 }
@@ -245,7 +236,6 @@ function appStateIOSTest() {
 }
 
 // ViewPagerAndroid
-
 export class ViewPagerAndroidTest {
     render() {
         return (
@@ -462,45 +452,49 @@ deviceEventEmitterStatic.addListener("keyboardWillShow", data => true);
 deviceEventEmitterStatic.addListener("keyboardWillShow", data => true, {});
 
 
-class TextInputRefTest extends React.Component<{}, {username: string}> {
+class TextInputTest extends React.Component<{}, {username: string}> {
     username: TextInput | null = null;
 
-    handleUsernameChange(text: string) {
+    handleUsernameChange = (text: string) => {
+        console.log(`text: ${ text }`);
+    }
+
+    onScroll = (e: TextInputScrollEvent) => {
+        console.log(`x: ${ e.nativeEvent.contentOffset.x }`);
+        console.log(`y: ${ e.nativeEvent.contentOffset.y }`);
+    }
+
+    handleOnBlur = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
+    }
+
+    handleOnFocus = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
     }
 
     render() {
         return (
             <View>
                 <Text onPress={() => this.username.focus()}>Username</Text>
+
                 <TextInput
                     ref={input => this.username = input}
                     value={this.state.username}
-                    onChangeText={this.handleUsernameChange.bind(this)}
+                    onChangeText={this.handleUsernameChange}
+                />
+
+                 <TextInput
+                    multiline
+                    onScroll={this.onScroll}
+                />
+
+                <TextInput
+                    onBlur={this.handleOnBlur}
+                    onFocus={this.handleOnFocus}
                 />
             </View>
         );
     }
 }
 
-class TextInputFocusBlurEventTest extends React.Component {
-    handleOnBlur(e: NativeSyntheticEvent<TextInputFocusEventData>) {
-    }
-
-    handleOnFocus(e: NativeSyntheticEvent<TextInputFocusEventData>) {
-    }
-
-    render() {
-        return (
-            <View>
-                <TextInput
-                    onBlur={(e: NativeSyntheticEvent<TextInputFocusEventData>) => this.handleOnBlur(e)}
-                    onFocus={(e: NativeSyntheticEvent<TextInputFocusEventData>) => this.handleOnFocus(e)}
-                />
-            </View>
-        )
-    }
-}
-
 class StatusBarTest extends React.Component {
     render() {
         StatusBar.setBarStyle("dark-content", true);
@@ -517,6 +511,25 @@ class StatusBarTest extends React.Component {
     }
 }
 
+export class ImageTest extends React.Component {
+    onLoad(event: ImageLoadEvent) {
+        console.log('height:', event.nativeEvent.source.height);
+        console.log('width:', event.nativeEvent.source.width);
+        console.log('url:', event.nativeEvent.source.url);
+    }
+
+    render() {
+        return (
+            <View>
+                <Image
+                    source={{ uri: 'https://seeklogo.com/images/T/typescript-logo-B29A3F462D-seeklogo.com.png' }}
+                    onLoad={this.onLoad}
+                />
+            </View>
+        );
+    }
+}
+
 class StylePropsTest extends React.PureComponent {
     render() {
         const uri = 'https://seeklogo.com/images/T/typescript-logo-B29A3F462D-seeklogo.com.png'

From 8bff26444867ee31d25e3589e56927f0dcc67055 Mon Sep 17 00:00:00 2001
From: Jamie Saunders <jamie.saunders@samsara.com>
Date: Fri, 15 Jun 2018 00:55:37 -0700
Subject: [PATCH 117/180] recharts: add optional angle to LabelProps

Labels support optional angle types, so let's add them to LabelProps
---
 types/recharts/index.d.ts         | 2 ++
 types/recharts/recharts-tests.tsx | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/types/recharts/index.d.ts b/types/recharts/index.d.ts
index 738c04bb02..5159fd827b 100644
--- a/types/recharts/index.d.ts
+++ b/types/recharts/index.d.ts
@@ -7,6 +7,7 @@
 //                 Rich Baird <https://github.com/richbai90>
 //                 Dan Torberg <https://github.com/caspeco-dan>
 //                 Peter Keuter <https://github.com/pkeuter>
+//                 Jamie Saunders <https://github.com/jrsaunde>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.6
 
@@ -832,6 +833,7 @@ export class Treemap extends React.Component<TreemapProps> { }
 export class Label extends React.Component<LabelProps> { }
 
 export interface LabelProps {
+    angle?: number;
     viewBox?: ViewBox | PolarViewBox;
     formatter?: LabelFormatter;
     value?: number | string;
diff --git a/types/recharts/recharts-tests.tsx b/types/recharts/recharts-tests.tsx
index 17d49bbd11..79fe85b0ee 100644
--- a/types/recharts/recharts-tests.tsx
+++ b/types/recharts/recharts-tests.tsx
@@ -192,7 +192,9 @@ class Component extends React.Component<{}, ComponentState> {
                     <XAxis dataKey="name">
                         <Label value="Pages of my website" offset={0} position="insideBottom" />
                     </XAxis>
-                    <YAxis label='pv of page' />
+                    <YAxis>
+                        <Label value="pv of page" angle={90} />
+                    </YAxis>
                     <Bar dataKey="pv" fill="#8884d8">
                         <LabelList dataKey="name" position="insideTop" angle={45}  />
                     </Bar>

From 5a39b90d7413521dfb914d488606af1d55153c40 Mon Sep 17 00:00:00 2001
From: Simon Schick <demwizzy@gmail.com>
Date: Fri, 15 Jun 2018 11:14:58 +0200
Subject: [PATCH 118/180] fixup! fix(joi): remove incorrect usage of generic

---
 types/joi/index.d.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/types/joi/index.d.ts b/types/joi/index.d.ts
index 34e740b27c..0a9962ee6d 100644
--- a/types/joi/index.d.ts
+++ b/types/joi/index.d.ts
@@ -966,7 +966,7 @@ export interface Rules<P extends object = any> {
     name: string;
     params?: ObjectSchema | {[key in keyof P]: SchemaLike; };
     setup?(this: ExtensionBoundSchema, params: P): Schema | void;
-    validate?(this: ExtensionBoundSchema, params: P, value: any, state: State, options: ValidationOptions): Err | any;
+    validate?(this: ExtensionBoundSchema, params: P, value: any, state: State, options: ValidationOptions): any;
     description?: string | ((params: P) => string);
 }
 
@@ -974,8 +974,8 @@ export interface Extension {
     name: string;
     base?: Schema;
     language?: LanguageOptions;
-    coerce?<R = any>(this: ExtensionBoundSchema, value: any, state: State, options: ValidationOptions): Err | R;
-    pre?<R = any>(this: ExtensionBoundSchema, value: any, state: State, options: ValidationOptions): Err | R;
+    coerce?(this: ExtensionBoundSchema, value: any, state: State, options: ValidationOptions): any;
+    pre?(this: ExtensionBoundSchema, value: any, state: State, options: ValidationOptions): any;
     describe?(this: Schema, description: Description): Description;
     rules?: Rules[];
 }

From 41cf3ae8e205d3b03ce581678699da6dac415e8c Mon Sep 17 00:00:00 2001
From: Ezinwa Okpoechi <brainmaestro@outlook.com>
Date: Fri, 15 Jun 2018 11:42:16 +0200
Subject: [PATCH 119/180] Fix socket origins type

---
 types/socket.io/index.d.ts | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/types/socket.io/index.d.ts b/types/socket.io/index.d.ts
index 6f7c0ef321..51a1bd7d9a 100644
--- a/types/socket.io/index.d.ts
+++ b/types/socket.io/index.d.ts
@@ -1,6 +1,11 @@
-// Type definitions for socket.io 1.4.4
+// Type definitions for socket.io 1.4.5
 // Project: http://socket.io/
-// Definitions by: PROGRE <https://github.com/progre>, Damian Connolly <https://github.com/divillysausages>, Florent Poujol <https://github.com/florentpoujol>, KentarouTakeda <https://github.com/KentarouTakeda>, Alexey Snigirev <https://github.com/gigi>
+// Definitions by: PROGRE <https://github.com/progre>
+//                 Damian Connolly <https://github.com/divillysausages>
+//                 Florent Poujol <https://github.com/florentpoujol>
+//                 KentarouTakeda <https://github.com/KentarouTakeda>
+//                 Alexey Snigirev <https://github.com/gigi>
+//                 Ezinwa Okpoechi <https://github.com/BrainMaestro>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 ///<reference types="node" />
@@ -127,7 +132,7 @@ declare namespace SocketIO {
 		 * Gets the allowed origins for requests
 		 * @default "*:*"
 		 */
-		origins(): string;
+		origins(): string|string[];
 
 		/**
 		 * Sets the allowed origins for requests
@@ -135,7 +140,7 @@ declare namespace SocketIO {
 		 * @default "*:*"
 		 * return This Server
 		 */
-		origins( v: string ): Server;
+		origins( v: string|string[] ): Server;
 
 		/**
 		 * Attaches socket.io to a server
@@ -299,7 +304,7 @@ declare namespace SocketIO {
 		 * Accepted origins
 		 * @default '*:*'
 		 */
-		origins?: string;
+		origins?: string|string[];
 
 		/**
 		 * How many milliseconds without a pong packed to consider the connection closed (engine.io)

From 713f7bec516c16f5bd94b1092cd0d92790be8fc6 Mon Sep 17 00:00:00 2001
From: Daniel Compton <desk@danielcompton.net>
Date: Fri, 15 Jun 2018 22:39:01 +1200
Subject: [PATCH 120/180] Add onUnreadCountChange command to intercom-web

---
 types/intercom-web/index.d.ts            | 24 +++++++++++++-----------
 types/intercom-web/intercom-web-tests.ts |  1 +
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/types/intercom-web/index.d.ts b/types/intercom-web/index.d.ts
index 563d241c31..eb2157d7c7 100755
--- a/types/intercom-web/index.d.ts
+++ b/types/intercom-web/index.d.ts
@@ -21,7 +21,7 @@ declare namespace Intercom_ {
       activator?: string;
     };
     company?: {
-      id: string|number,
+      id: string | number,
       name: string,
       created_at: number,
       plan?: string,
@@ -33,16 +33,17 @@ declare namespace Intercom_ {
   }
 
   type IntercomCommand = 'boot'
-    |'shutdown'
-    |'update'
-    |'hide'
-    |'show'
-    |'showMessages'
-    |'showNewMessage'
-    |'onHide'
-    |'onShow'
-    |'onActivatorClick'
-    |'trackEvent';
+    | 'shutdown'
+    | 'update'
+    | 'hide'
+    | 'show'
+    | 'showMessages'
+    | 'showNewMessage'
+    | 'onHide'
+    | 'onShow'
+    | 'onUnreadCountChange'
+    | 'onActivatorClick'
+    | 'trackEvent';
 
   interface IntercomStatic {
     (command: 'boot', param: IntercomSettings): void;
@@ -51,6 +52,7 @@ declare namespace Intercom_ {
     (command: 'showNewMessage', param?: string): void;
     (command: 'onHide' | 'onShow' | 'onActivatorClick', param?: () => void): void;
     (command: 'trackEvent', tag?: string, metadata?: any): void;
+    (command: 'onUnreadCountChange', cb: (unreadCount: number) => void): void;
     (command: IntercomCommand, param1?: any, param2?: any): void;
   }
 }
diff --git a/types/intercom-web/intercom-web-tests.ts b/types/intercom-web/intercom-web-tests.ts
index b07013322d..425aa74be4 100755
--- a/types/intercom-web/intercom-web-tests.ts
+++ b/types/intercom-web/intercom-web-tests.ts
@@ -23,6 +23,7 @@ Intercom('showMessages');
 Intercom('showNewMessage');
 Intercom('showNewMessage', 'pre-populated content');
 Intercom('onHide', () => { /* Do stuff */ });
+Intercom('onUnreadCountChange', (unreadCount: number) => { /* Do stuff */ });
 Intercom('onActivatorClick', () => { /* Do stuff */ });
 Intercom('trackEvent', 'invited-friend');
 

From 9a3d7345fb68e69bec0c570df24d7e92a1559dde Mon Sep 17 00:00:00 2001
From: Robin Bellini Olsson <rbo@hopper.dk>
Date: Fri, 15 Jun 2018 13:20:16 +0200
Subject: [PATCH 121/180] add withNamespace function

---
 types/microrouter/index.d.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/types/microrouter/index.d.ts b/types/microrouter/index.d.ts
index 934affd630..81643c9c42 100644
--- a/types/microrouter/index.d.ts
+++ b/types/microrouter/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for microrouter 2.2
+// Type definitions for microrouter 3.1.3
 // Project: https://github.com/pedronauck/micro-router#readme
 // Definitions by: Mathieu Dutour <https://github.com/mathieudutour>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
@@ -21,6 +21,7 @@ export type AugmentedRequestHandler = (
 export type RouteHandler = (path: string, handler: AugmentedRequestHandler) => RequestHandler;
 
 export function router(...routes: RequestHandler[]): RequestHandler;
+export function withNamespace(namespace: string): (...routes: RequestHandler[]) => RequestHandler;
 
 export const get: RouteHandler;
 export const post: RouteHandler;

From f61d99d5b05b53881726546d1a654169cf045d82 Mon Sep 17 00:00:00 2001
From: Robin Bellini Olsson <rbo@hopper.dk>
Date: Fri, 15 Jun 2018 13:35:53 +0200
Subject: [PATCH 122/180] fix version header

---
 types/microrouter/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/microrouter/index.d.ts b/types/microrouter/index.d.ts
index 81643c9c42..c4927ecf9b 100644
--- a/types/microrouter/index.d.ts
+++ b/types/microrouter/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for microrouter 3.1.3
+// Type definitions for microrouter 3.1
 // Project: https://github.com/pedronauck/micro-router#readme
 // Definitions by: Mathieu Dutour <https://github.com/mathieudutour>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

From b079af2730dddb50953570641cc2df9280ba041f Mon Sep 17 00:00:00 2001
From: Andrew Goodale <andrewgoodale@upserve.com>
Date: Fri, 15 Jun 2018 12:51:09 -0400
Subject: [PATCH 123/180] TextInput.State is a static value

---
 types/react-native/index.d.ts | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/types/react-native/index.d.ts b/types/react-native/index.d.ts
index b469a5bdf2..314d9320a3 100644
--- a/types/react-native/index.d.ts
+++ b/types/react-native/index.d.ts
@@ -1332,7 +1332,10 @@ interface TextInputState {
 declare class TextInputComponent extends React.Component<TextInputProps> {}
 declare const TextInputBase: Constructor<NativeMethodsMixin> & Constructor<TimerMixin> & typeof TextInputComponent;
 export class TextInput extends TextInputBase {
-    State: TextInputState;
+    /**
+     * Access the current focus state.
+     */
+    static State: TextInputState;
 
     /**
      * Returns if the input is currently focused.

From 05d33b6d77df6a8c78bd51ac20ed71353411f503 Mon Sep 17 00:00:00 2001
From: Andrew Goodale <andrewgoodale@upserve.com>
Date: Fri, 15 Jun 2018 13:04:24 -0400
Subject: [PATCH 124/180] SectionList missing `onScrollToIndexFailed` prop

---
 types/react-native/index.d.ts | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/types/react-native/index.d.ts b/types/react-native/index.d.ts
index 314d9320a3..ce7519d0c7 100644
--- a/types/react-native/index.d.ts
+++ b/types/react-native/index.d.ts
@@ -3890,6 +3890,13 @@ export interface SectionListProps<ItemT> extends ScrollViewProps {
      */
     initialNumToRender?: number;
 
+    /**
+     * Used to extract a unique key for a given item at the specified index. Key is used for caching
+     * and as the react key to track item re-ordering. The default extractor checks `item.key`, then
+     * falls back to using the index, like React does.
+     */
+    keyExtractor?: (item: ItemT, index: number) => string;
+
     /**
      * Called once when the scroll position gets within onEndReachedThreshold of the rendered content.
      */
@@ -3903,19 +3910,23 @@ export interface SectionListProps<ItemT> extends ScrollViewProps {
      */
     onEndReachedThreshold?: number | null;
 
-    /**
-     * Used to extract a unique key for a given item at the specified index. Key is used for caching
-     * and as the react key to track item re-ordering. The default extractor checks `item.key`, then
-     * falls back to using the index, like React does.
-     */
-    keyExtractor?: (item: ItemT, index: number) => string;
-
     /**
      * If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality.
      * Make sure to also set the refreshing prop correctly.
      */
     onRefresh?: (() => void) | null;
 
+    /**
+     * Used to handle failures when scrolling to an index that has not been measured yet.
+     * Recommended action is to either compute your own offset and `scrollTo` it, or scroll as far
+     * as possible and then try again after more items have been rendered.
+     */
+    onScrollToIndexFailed?: (info: {
+        index: number,
+        highestMeasuredFrameIndex: number,
+        averageItemLength: number
+    }) => void;
+
     /**
      * Set this true while waiting for new data from a refresh.
      */

From 5de627c19f1d5f40cb98e7d91640cc418b733c2d Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Fri, 15 Jun 2018 10:13:35 -0700
Subject: [PATCH 125/180] Adding explicit string values to enums

---
 types/office-js/index.d.ts | 54 +++++++++++++++++++-------------------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 9a2f8981a5..e395b7d572 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -4836,15 +4836,15 @@ declare namespace Office {
             /**
              * The attachment is a file
              */
-            File,
+            File = "file",
             /**
              * The attachment is an Exchange item
              */
-            Item,
+            Item = "item",
             /**
              * The attachment is stored in a cloud location, such as OneDrive. The id property of the attachment contains a URL to the file.
              */
-            Cloud
+            Cloud = "cloud"
         }
         /**
          * Specifies the day of week or type of day.
@@ -4908,31 +4908,31 @@ declare namespace Office {
             /**
              * Specifies that the entity is a meeting suggestion.
              */
-            MeetingSuggestion,
+            MeetingSuggestion = "meetingSuggestion",
             /**
              * Specifies that the entity is a task suggestion.
              */
-            TaskSuggestion,
+            TaskSuggestion = "taskSuggestion",
             /**
              * Specifies that the entity is a postal address.
              */
-            Address,
+            Address = "address",
             /**
              * Specifies that the entity is an SMTP email address.
              */
-            EmailAddress,
+            EmailAddress = "emailAddress",
             /**
              * Specifies that the entity is an Internet URL.
              */
-            Url,
+            Url = "url",
             /**
              * Specifies that the entity is a US phone number.
              */
-            PhoneNumber,
+            PhoneNumber = "phoneNumber",
             /**
              * Specifies that the entity is a contact.
              */
-            Contact
+            Contact = "contact"
         }
         /**
          * Specifies the notification message type for an appointment or message.
@@ -4946,15 +4946,15 @@ declare namespace Office {
             /**
              * The notificationMessage is a progress indicator.
              */
-            ProgressIndicator,
+            ProgressIndicator = "progressIndicator",
             /**
              * The notificationMessage is an informational message.
              */
-            InformationalMessage,
+            InformationalMessage = "informationalMessage",
             /**
              * The notificationMessage is an error message.
              */
-            ErrorMessage
+            ErrorMessage = "errorMessage"
         }
         /**
          * Specifies an item's type.
@@ -4968,11 +4968,11 @@ declare namespace Office {
             /**
              * An email, meeting request, meeting response, or meeting cancellation.
              */
-            Message,
+            Message = "message",
             /**
              * An appointment item.
              */
-            Appointment
+            Appointment = "appointment"
         }
         /**
          * Specifies the month.
@@ -5044,19 +5044,19 @@ declare namespace Office {
             /**
              * Specifies that the recipient is a distribution list containing a list of email addresses.
              */
-            DistributionList,
+            DistributionList = "distributionList",
             /**
              * Specifies that the recipient is an SMTP email address that is on the Exchange server.
              */
-            User,
+            User = "user",
             /**
              * Specifies that the recipient is an SMTP email address that is not on the Exchange server.
              */
-            ExternalUser,
+            ExternalUser = "externalUser",
             /**
              * Specifies that the recipient is not one of the other recipient types.
              */
-            Other
+            Other = "other"
         }
         /**
          * Specifies the time zone applied to the recurrence.
@@ -5656,23 +5656,23 @@ declare namespace Office {
             /**
              * There has been no response from the attendee.
              */
-            None,
+            None = "none",
             /**
              * The attendee is the meeting organizer.
              */
-            Organizer,
+            Organizer = "organizer",
             /**
              * The meeting request was tentatively accepted by the attendee.
              */
-            Tentative,
+            Tentative = "tentative",
             /**
              * The meeting request was accepted by the attendee.
              */
-            Accepted,
+            Accepted = "accepted",
             /**
              * The meeting request was declined by the attendee.
              */
-            Declined
+            Declined = "declined"
         }
         /**
          * Specifies the version of the REST API that corresponds to a REST-formatted item ID.
@@ -5686,15 +5686,15 @@ declare namespace Office {
             /**
              * Version 1.0.
              */
-            v1_0,
+            v1_0 = "v1.0",
             /**
              * Version 2.0.
              */
-            v2_0,
+            v2_0 = "v2.0",
             /**
              * Beta.
              */
-            Beta
+            Beta = "beta"
         }
         /**
          * Specifies the week of the month.

From c2b40c18c15a14e7b190dd5caf96705f06a703d2 Mon Sep 17 00:00:00 2001
From: Ben Saufley <bensaufley+git@gmail.com>
Date: Fri, 15 Jun 2018 13:36:18 -0400
Subject: [PATCH 126/180] [next] Update router types

---
 types/next/router.d.ts                | 40 +++++++++------
 types/next/test/next-router-tests.tsx | 72 ++++++++++++++++++---------
 2 files changed, 74 insertions(+), 38 deletions(-)

diff --git a/types/next/router.d.ts b/types/next/router.d.ts
index 544c29bc7e..4eb24dc3ff 100644
--- a/types/next/router.d.ts
+++ b/types/next/router.d.ts
@@ -8,12 +8,11 @@ export interface EventChangeOptions {
     [key: string]: any;
 }
 
+export type PopStateCallback = (state: any) => boolean | undefined;
+
 export type RouterCallback = () => void;
 export interface RouterProps {
-    // router properties
-    readonly components: {
-        [key: string]: { Component: React.ComponentType<any>; err: any };
-    };
+    // url property fields
     readonly pathname: string;
     readonly route: string;
     readonly asPath?: string;
@@ -27,39 +26,50 @@ export interface RouterProps {
             | string[];
     };
 
-    // router methods
-    reload(route: string): Promise<void>;
+    // property fields
+    readonly components: {
+        [key: string]: { Component: React.ComponentType<any>; err: any };
+    };
+
+    // core method fields
     back(): void;
+    beforePopState(cb: PopStateCallback): boolean;
+    prefetch(url: string): Promise<React.ComponentType<any>>;
     push(
         url: string | UrlLike,
         as?: string | UrlLike,
         options?: EventChangeOptions,
     ): Promise<boolean>;
+    reload(route: string): Promise<void>;
     replace(
         url: string | UrlLike,
         as?: string | UrlLike,
         options?: EventChangeOptions,
     ): Promise<boolean>;
-    prefetch(url: string): Promise<React.ComponentType<any>>;
 
-    // router events
+    // events
     onAppUpdated?(nextRoute: string): void;
-    onRouteChangeStart?(url: string): void;
     onBeforeHistoryChange?(as: string): void;
+    onHashChangeStart?(url: string): void;
+    onHashChangeComplete?(url: string): void;
     onRouteChangeComplete?(url: string): void;
     onRouteChangeError?(error: any, url: string): void;
+    onRouteChangeStart?(url: string): void;
 }
 
-export interface SingletonRouter {
-    router: RouterProps;
+export interface SingletonRouter extends RouterProps {
+    router: RouterProps | null;
     readyCallbacks: RouterCallback[];
     ready(cb: RouterCallback): void;
 }
 
+export interface WithRouterProps {
+    router: SingletonRouter;
+}
+
 export function withRouter<T extends {}>(
-    Component: React.ComponentType<T & SingletonRouter>,
+    Component: React.ComponentType<T & WithRouterProps>,
 ): React.ComponentType<T>;
 
-export const Singleton: SingletonRouter;
-export type ImperativeRouter = RouterProps;
-export default Singleton;
+declare const Router: SingletonRouter;
+export default Router;
diff --git a/types/next/test/next-router-tests.tsx b/types/next/test/next-router-tests.tsx
index 822b9b8e6f..70c41081bd 100644
--- a/types/next/test/next-router-tests.tsx
+++ b/types/next/test/next-router-tests.tsx
@@ -1,4 +1,4 @@
-import Router, * as r from "next/router";
+import Router, { withRouter, WithRouterProps } from "next/router";
 import * as React from "react";
 import * as qs from "querystring";
 
@@ -13,8 +13,8 @@ Router.ready(() => {
 
 // Access readonly properties of the router.
 
-Object.keys(Router.router.components).forEach(key => {
-    const c = Router.router.components[key];
+Object.keys(Router.components).forEach(key => {
+    const c = Router.components[key];
     c.err.isAnAny;
 
     return <c.Component />;
@@ -26,52 +26,78 @@ function split(routeLike: string) {
     });
 }
 
-if (Router.router.asPath) {
-    split(Router.router.asPath);
-    split(Router.router.asPath);
+if (Router.asPath) {
+    split(Router.asPath);
+    split(Router.asPath);
 }
 
-split(Router.router.pathname);
+split(Router.pathname);
 
-const query = `?${qs.stringify(Router.router.query)}`;
+const query = `?${qs.stringify(Router.query)}`;
 
 // Assign some callback methods.
-Router.router.onAppUpdated = (nextRoute: string) => console.log(nextRoute);
-Router.router.onRouteChangeStart = (url: string) =>
+Router.onAppUpdated = (nextRoute: string) => console.log(nextRoute);
+Router.onRouteChangeStart = (url: string) =>
     console.log("Route is starting to change.", url);
-Router.router.onBeforeHistoryChange = (as: string) =>
+Router.onBeforeHistoryChange = (as: string) =>
     console.log("History hasn't changed yet.", as);
-Router.router.onRouteChangeComplete = (url: string) =>
+Router.onRouteChangeComplete = (url: string) =>
     console.log("Route chaneg is complete.", url);
-Router.router.onRouteChangeError = (err: any, url: string) =>
+Router.onRouteChangeError = (err: any, url: string) =>
     console.log("Route is starting to change.", url, err);
 
 // Call methods on the router itself.
-Router.router.reload("/route").then(() => console.log("route was reloaded"));
-Router.router.back();
+Router.reload("/route").then(() => console.log("route was reloaded"));
+Router.back();
+Router.beforePopState(({ url }) => !!url);
 
-Router.router.push("/route").then((success: boolean) =>
+Router.push("/route").then((success: boolean) =>
     console.log("route push success: ", success),
 );
-Router.router.push("/route", "/asRoute").then((success: boolean) =>
+Router.push("/route", "/asRoute").then((success: boolean) =>
     console.log("route push success: ", success),
 );
-Router.router.push("/route", "/asRoute", { shallow: false }).then((success: boolean) =>
+Router.push("/route", "/asRoute", { shallow: false }).then((success: boolean) =>
     console.log("route push success: ", success),
 );
 
-Router.router.replace("/route").then((success: boolean) =>
+Router.replace("/route").then((success: boolean) =>
     console.log("route replace success: ", success),
 );
-Router.router.replace("/route", "/asRoute").then((success: boolean) =>
+Router.replace("/route", "/asRoute").then((success: boolean) =>
     console.log("route replace success: ", success),
 );
-Router.router.replace("/route", "/asRoute", {
+Router.replace("/route", "/asRoute", {
     shallow: false,
 }).then((success: boolean) => console.log("route replace success: ", success));
 
-Router.router.prefetch("/route").then(Component => {
+Router.prefetch("/route").then(Component => {
     const element = <Component />;
 });
 
-r.withRouter(props => <div />);
+interface TestComponentProps {
+    testValue: string;
+}
+
+class TestComponent extends React.Component<TestComponentProps & WithRouterProps> {
+    state = { ready: false };
+
+    constructor(props: TestComponentProps & WithRouterProps) {
+        super(props);
+        props.router.ready(() => {
+            this.setState({ ready: true });
+        });
+    }
+
+    render() {
+        return (
+            <div>
+                <h1>{this.state.ready ? 'Ready' : 'Not Ready'}</h1>
+                <h2>Route: {this.props.router.route}</h2>
+                <p>Another prop: {this.props.testValue}</p>
+            </div>
+        );
+    }
+}
+
+withRouter(TestComponent);

From 15fd47e35fd1b7659ffb00e0767d7ceb6fbcf11d Mon Sep 17 00:00:00 2001
From: Andrew Makarov <me@r3nya.ru>
Date: Sat, 9 Jun 2018 12:34:41 +0300
Subject: [PATCH 127/180] [react-bootstrap] Add bsSize property for
 ToggleButton and ToggleButtonGroup

---
 types/react-bootstrap/index.d.ts              |   1 +
 types/react-bootstrap/lib/ToggleButton.d.ts   |   4 +-
 .../lib/ToggleButtonGroup.d.ts                |   2 +
 .../test/react-bootstrap-tests.tsx            | 105 ++++++++++++++----
 4 files changed, 91 insertions(+), 21 deletions(-)

diff --git a/types/react-bootstrap/index.d.ts b/types/react-bootstrap/index.d.ts
index 6a78dcbb1a..d015ce6402 100644
--- a/types/react-bootstrap/index.d.ts
+++ b/types/react-bootstrap/index.d.ts
@@ -12,6 +12,7 @@
 //                 Karol Janyst <https://github.com/LKay>
 //                 Aaron Beall <https://github.com/aaronbeall>
 //                 Johann Rakotoharisoa <https://github.com/jrakotoharisoa>
+//                 Andrew Makarov <https://github.com/r3nya>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.6
 
diff --git a/types/react-bootstrap/lib/ToggleButton.d.ts b/types/react-bootstrap/lib/ToggleButton.d.ts
index ef231bf288..3566ad2a4a 100644
--- a/types/react-bootstrap/lib/ToggleButton.d.ts
+++ b/types/react-bootstrap/lib/ToggleButton.d.ts
@@ -1,10 +1,12 @@
 import * as React from 'react';
+import { Sizes } from 'react-bootstrap';
 
 declare namespace ToggleButton {
     export interface ToggleButtonProps extends React.HTMLProps<ToggleButton> {
         checked?: boolean;
         name?: string;
-        value: number|string;
+        value: number | string;
+        bsSize?: Sizes;
     }
 }
 declare class ToggleButton extends React.Component<ToggleButton.ToggleButtonProps> { }
diff --git a/types/react-bootstrap/lib/ToggleButtonGroup.d.ts b/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
index 27be6b95a9..a3ea325192 100644
--- a/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
+++ b/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { Sizes } from 'react-bootstrap';
 import { Omit } from "../index";
 
 declare namespace ToggleButtonGroup {
@@ -13,6 +14,7 @@ declare namespace ToggleButtonGroup {
          * but you can technically use any|any[].
          */
         value?: any;
+        bsSize?: Sizes;
     }
 
     interface RadioProps {
diff --git a/types/react-bootstrap/test/react-bootstrap-tests.tsx b/types/react-bootstrap/test/react-bootstrap-tests.tsx
index ccebe35add..bfe8f9f6ea 100644
--- a/types/react-bootstrap/test/react-bootstrap-tests.tsx
+++ b/types/react-bootstrap/test/react-bootstrap-tests.tsx
@@ -1,18 +1,56 @@
 import * as React from 'react';
 import { Component, CSSProperties } from 'react';
 import {
-    Button, ButtonToolbar, Modal, Well, ButtonGroup,
-    DropdownButton, MenuItem, Panel, PanelGroup, ListGroup,
-    ListGroupItem, Accordion, Tooltip,
-    OverlayTrigger, Popover, ProgressBar,
-    Nav, NavItem, Navbar, NavDropdown,
-    Tabs, Tab, Pager, PageItem,
-    Pagination, Alert, Carousel, SafeAnchor,
-    Grid, Row, Col, Thumbnail, Image, ResponsiveEmbed,
-    Label, Badge, Jumbotron, PageHeader,
-    Glyphicon, Table, Form, FormGroup,
-    ControlLabel, FormControl, HelpBlock,
-    Radio, Checkbox, Media, InputGroup, ToggleButtonGroup,
+    Button,
+    ButtonToolbar,
+    Modal,
+    Well,
+    ButtonGroup,
+    DropdownButton,
+    MenuItem,
+    Panel,
+    PanelGroup,
+    ListGroup,
+    ListGroupItem,
+    Accordion,
+    Tooltip,
+    OverlayTrigger,
+    Popover,
+    ProgressBar,
+    Nav,
+    NavItem,
+    Navbar,
+    NavDropdown,
+    Tabs,
+    Tab,
+    Pager,
+    PageItem,
+    Pagination,
+    Alert,
+    Carousel,
+    SafeAnchor,
+    Grid,
+    Row,
+    Col,
+    Thumbnail,
+    Image,
+    ResponsiveEmbed,
+    Label,
+    Badge,
+    Jumbotron,
+    PageHeader,
+    Glyphicon,
+    Table,
+    Form,
+    FormGroup,
+    ControlLabel,
+    FormControl,
+    HelpBlock,
+    Radio,
+    Checkbox,
+    Media,
+    InputGroup,
+    ToggleButtonGroup,
     ToggleButton
 } from 'react-bootstrap';
 
@@ -1418,20 +1456,47 @@ export class ReactBootstrapTest extends Component {
 
               <div>
                 <ButtonToolbar>
-                  <ToggleButtonGroup type="checkbox" defaultValue={[1, 3]}>
-                    <ToggleButton value={1}>Checkbox 1 (pre-checked)</ToggleButton>
-                    <ToggleButton value={2}>Checkbox 2</ToggleButton>
-                    <ToggleButton value={3}>Checkbox 3 (pre-checked)</ToggleButton>
+                  <ToggleButtonGroup
+                    type="checkbox"
+                    defaultValue={[1, 3]}
+                    bsSize='small'
+                  >
+                    <ToggleButton value={1}>
+                      Checkbox 1 (pre-checked)
+                    </ToggleButton>
+                    <ToggleButton value={2}>
+                      Checkbox 2
+                    </ToggleButton>
+                    <ToggleButton value={3}>
+                      Checkbox 3 (pre-checked)
+                    </ToggleButton>
                   </ToggleButtonGroup>
                 </ButtonToolbar>
 
                 <ButtonToolbar>
-                  <ToggleButtonGroup type="radio" name="options" defaultValue={1}>
-                    <ToggleButton value={1}>
+                  <ToggleButtonGroup
+                    type="radio"
+                    name="options"
+                    defaultValue={1}
+                  >
+                    <ToggleButton
+                      value={1}
+                      bsSize='large'
+                    >
                       Radio 1 (pre-checked)
                     </ToggleButton>
-                    <ToggleButton value={2}>Radio 2</ToggleButton>
-                    <ToggleButton value={3}>Radio 3</ToggleButton>
+                    <ToggleButton
+                      value={2}
+                      bsSize='small'
+                    >
+                      Radio 2
+                    </ToggleButton>
+                    <ToggleButton
+                      value={3}
+                      bsSize='xsmall'
+                    >
+                      Radio 3
+                    </ToggleButton>
                   </ToggleButtonGroup>
                 </ButtonToolbar>
               </div>

From b11356877c7111c790af16f6efd00e17918dac1a Mon Sep 17 00:00:00 2001
From: Andrew Makarov <me@r3nya.ru>
Date: Fri, 15 Jun 2018 22:43:27 +0300
Subject: [PATCH 128/180] [react-bootstrap] refactoring

---
 types/react-bootstrap/lib/ToggleButton.d.ts            |  5 ++---
 types/react-bootstrap/lib/ToggleButtonGroup.d.ts       |  5 ++---
 .../react-bootstrap-individual-components-tests.tsx    |  4 ++--
 types/react-bootstrap/test/react-bootstrap-tests.tsx   | 10 +++++-----
 4 files changed, 11 insertions(+), 13 deletions(-)

diff --git a/types/react-bootstrap/lib/ToggleButton.d.ts b/types/react-bootstrap/lib/ToggleButton.d.ts
index 3566ad2a4a..b199ea8119 100644
--- a/types/react-bootstrap/lib/ToggleButton.d.ts
+++ b/types/react-bootstrap/lib/ToggleButton.d.ts
@@ -1,13 +1,12 @@
 import * as React from 'react';
-import { Sizes } from 'react-bootstrap';
+import { Button } from 'react-bootstrap';
 
 declare namespace ToggleButton {
     export interface ToggleButtonProps extends React.HTMLProps<ToggleButton> {
         checked?: boolean;
         name?: string;
         value: number | string;
-        bsSize?: Sizes;
     }
 }
-declare class ToggleButton extends React.Component<ToggleButton.ToggleButtonProps> { }
+declare class ToggleButton extends React.Component<ToggleButton.ToggleButtonProps & Button.ButtonProps> { }
 export = ToggleButton;
diff --git a/types/react-bootstrap/lib/ToggleButtonGroup.d.ts b/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
index a3ea325192..1c3f6f4020 100644
--- a/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
+++ b/types/react-bootstrap/lib/ToggleButtonGroup.d.ts
@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { Sizes } from 'react-bootstrap';
+import { ButtonGroup } from 'react-bootstrap';
 import { Omit } from "../index";
 
 declare namespace ToggleButtonGroup {
@@ -14,7 +14,6 @@ declare namespace ToggleButtonGroup {
          * but you can technically use any|any[].
          */
         value?: any;
-        bsSize?: Sizes;
     }
 
     interface RadioProps {
@@ -36,5 +35,5 @@ declare namespace ToggleButtonGroup {
                                        & Omit<React.HTMLProps<ToggleButtonGroup>, "defaultValue" | "type" | "value" | "onChange">;
 
 }
-declare class ToggleButtonGroup extends React.Component<ToggleButtonGroup.ToggleButtonGroupProps> { }
+declare class ToggleButtonGroup extends React.Component<ToggleButtonGroup.ToggleButtonGroupProps & ButtonGroup.ButtonGroupProps> { }
 export = ToggleButtonGroup;
diff --git a/types/react-bootstrap/test/react-bootstrap-individual-components-tests.tsx b/types/react-bootstrap/test/react-bootstrap-individual-components-tests.tsx
index 07d6a8a442..8c4237d22b 100644
--- a/types/react-bootstrap/test/react-bootstrap-individual-components-tests.tsx
+++ b/types/react-bootstrap/test/react-bootstrap-individual-components-tests.tsx
@@ -209,8 +209,8 @@ export class ReactBootstrapIndividualComponentsTest extends React.Component {
         <Table />
         <Tabs />
         <Thumbnail />
-        <ToggleButton value="foo" />
-        <ToggleButtonGroup type="checkbox" />
+        <ToggleButton value="foo" bsSize="small" />
+        <ToggleButtonGroup type="checkbox" bsSize="small" />
         <ToggleButtonGroup type="radio" name="foo" />
         <Tooltip />
         <Well />
diff --git a/types/react-bootstrap/test/react-bootstrap-tests.tsx b/types/react-bootstrap/test/react-bootstrap-tests.tsx
index bfe8f9f6ea..34692ce248 100644
--- a/types/react-bootstrap/test/react-bootstrap-tests.tsx
+++ b/types/react-bootstrap/test/react-bootstrap-tests.tsx
@@ -1459,9 +1459,9 @@ export class ReactBootstrapTest extends Component {
                   <ToggleButtonGroup
                     type="checkbox"
                     defaultValue={[1, 3]}
-                    bsSize='small'
+                    bsSize="small"
                   >
-                    <ToggleButton value={1}>
+                    <ToggleButton value={1} bsSize="small" active>
                       Checkbox 1 (pre-checked)
                     </ToggleButton>
                     <ToggleButton value={2}>
@@ -1481,19 +1481,19 @@ export class ReactBootstrapTest extends Component {
                   >
                     <ToggleButton
                       value={1}
-                      bsSize='large'
+                      bsSize="large"
                     >
                       Radio 1 (pre-checked)
                     </ToggleButton>
                     <ToggleButton
                       value={2}
-                      bsSize='small'
+                      bsSize="small"
                     >
                       Radio 2
                     </ToggleButton>
                     <ToggleButton
                       value={3}
-                      bsSize='xsmall'
+                      bsSize="xsmall"
                     >
                       Radio 3
                     </ToggleButton>

From 76e35a7427b364dee7dc822b21da415337dcc1d0 Mon Sep 17 00:00:00 2001
From: Shahar Mor <shaharmor1@gmail.com>
Date: Sat, 16 Jun 2018 00:33:30 +0300
Subject: [PATCH 129/180] Add ISP & Connection databases info

---
 types/maxmind/index.d.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/types/maxmind/index.d.ts b/types/maxmind/index.d.ts
index da45eb907b..c93c59a72a 100644
--- a/types/maxmind/index.d.ts
+++ b/types/maxmind/index.d.ts
@@ -68,6 +68,11 @@ export declare interface Response {
         readonly names: Translations;
     };
     readonly postal?: { code: string };
+    readonly isp?: {
+        readonly isp: string;
+        readonly autonomous_system_number: number;
+    };
+    readonly connection?: { connection_type: string };
 }
 
 export declare interface Translations {

From 2bed7374015c31852b48593c909a7d0f0460f433 Mon Sep 17 00:00:00 2001
From: Kelvin Jin <kelvinjin@google.com>
Date: Fri, 15 Jun 2018 16:49:40 -0700
Subject: [PATCH 130/180] [mongodb] use T as type rather than value

---
 types/mongodb/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/mongodb/index.d.ts b/types/mongodb/index.d.ts
index 273a0716b2..3048da4dd4 100644
--- a/types/mongodb/index.d.ts
+++ b/types/mongodb/index.d.ts
@@ -1252,7 +1252,7 @@ export class Cursor<T = Default> extends Readable {
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#limit */
     limit(value: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#map */
-    map<U>(transform: (T) => U): Cursor<U>;
+    map<U>(transform: (document: T) => U): Cursor<U>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#max */
     max(max: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#maxAwaitTimeMS */

From c37b9bf467d1d1302382ea74b35940b29e6394d0 Mon Sep 17 00:00:00 2001
From: Jonathan Ingram <jonathan.b.ingram@gmail.com>
Date: Sat, 16 Jun 2018 13:06:41 +1000
Subject: [PATCH 131/180] Fix StripeProvider stripe prop

---
 types/react-stripe-elements/index.d.ts         |  2 +-
 .../react-stripe-elements-tests.tsx            | 18 +++++++++++++++---
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/types/react-stripe-elements/index.d.ts b/types/react-stripe-elements/index.d.ts
index e8e88757b2..6afd58d143 100644
--- a/types/react-stripe-elements/index.d.ts
+++ b/types/react-stripe-elements/index.d.ts
@@ -30,7 +30,7 @@ export namespace ReactStripeElements {
 	interface StripeProviderOptions {
 		stripeAccount?: string;
 	}
-	type StripeProviderProps = { apiKey: string; stripe?: never; } & StripeProviderOptions | { apiKey?: never; stripe: StripeProps | null; } & StripeProviderOptions;
+	type StripeProviderProps = { apiKey: string; stripe?: never; } & StripeProviderOptions | { apiKey?: never; stripe: stripe.Stripe | null | null; } & StripeProviderOptions;
 
 	interface StripeProps {
 		createSource(sourceData?: SourceOptions): Promise<SourceResponse>;
diff --git a/types/react-stripe-elements/react-stripe-elements-tests.tsx b/types/react-stripe-elements/react-stripe-elements-tests.tsx
index ef1af5fa86..88b703b141 100644
--- a/types/react-stripe-elements/react-stripe-elements-tests.tsx
+++ b/types/react-stripe-elements/react-stripe-elements-tests.tsx
@@ -16,7 +16,6 @@ import ElementChangeResponse = stripe.elements.ElementChangeResponse;
 import ElementsOptions = stripe.elements.ElementsOptions;
 import ElementsCreateOptions = stripe.elements.ElementsCreateOptions;
 import PatchedTokenResponse = ReactStripeElements.PatchedTokenResponse;
-import StripeProps = ReactStripeElements.StripeProps;
 
 const cardElementProps: ElementsOptions = {
     iconStyle: 'solid',
@@ -185,7 +184,7 @@ const ElementsDefaultPropsTest: React.SFC = () => (
 const TestStripeProviderProps1: React.SFC = () => <StripeProvider apiKey="" />;
 
 const TestStripeProviderProps2: React.SFC<{
-    stripe: StripeProps;
+    stripe: stripe.Stripe;
 }> = props => <StripeProvider stripe={props.stripe} />;
 
 /**
@@ -193,9 +192,22 @@ const TestStripeProviderProps2: React.SFC<{
  * See: https://github.com/stripe/react-stripe-elements#props-shape
  */
 const TestStripeProviderProps3: React.SFC<{
-    stripe: StripeProps;
+    stripe: stripe.Stripe;
 }> = props => <StripeProvider stripe={null} />;
 
+/**
+ * End-to-end usage of loading stripe.js asynchronously.
+ * See: https://github.com/stripe/react-stripe-elements#loading-stripejs-asynchronously
+ */
+const TestStripeProviderProps4: React.SFC<{
+    stripe: null | stripe.Stripe
+}> = props =>
+    <StripeProvider stripe={props.stripe}>
+        <Elements>
+            <div />
+        </Elements>
+    </StripeProvider>;
+
 /**
  * StripeProvider should be able to accept options.
  * See: https://stripe.com/docs/stripe-js/reference#stripe-function for options.

From 648d5ae0a6423695519387cdb4b1d2990e0ce884 Mon Sep 17 00:00:00 2001
From: Jonathan Ingram <jonathan.b.ingram@gmail.com>
Date: Sat, 16 Jun 2018 22:14:07 +1000
Subject: [PATCH 132/180] Fix duplicate `| null` typo

---
 types/react-stripe-elements/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/react-stripe-elements/index.d.ts b/types/react-stripe-elements/index.d.ts
index 6afd58d143..abc08cc3e1 100644
--- a/types/react-stripe-elements/index.d.ts
+++ b/types/react-stripe-elements/index.d.ts
@@ -30,7 +30,7 @@ export namespace ReactStripeElements {
 	interface StripeProviderOptions {
 		stripeAccount?: string;
 	}
-	type StripeProviderProps = { apiKey: string; stripe?: never; } & StripeProviderOptions | { apiKey?: never; stripe: stripe.Stripe | null | null; } & StripeProviderOptions;
+	type StripeProviderProps = { apiKey: string; stripe?: never; } & StripeProviderOptions | { apiKey?: never; stripe: stripe.Stripe | null; } & StripeProviderOptions;
 
 	interface StripeProps {
 		createSource(sourceData?: SourceOptions): Promise<SourceResponse>;

From dba82e8e0ebe8d65d5feaffbc18d597578c728c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Miko=C5=82ajczyk?=
 <mikolajczyk.pawel1@gmail.com>
Date: Sat, 16 Jun 2018 14:49:15 +0200
Subject: [PATCH 133/180] Definitions for jest's each function

---
 types/jest/index.d.ts    |  11 +++++
 types/jest/jest-tests.ts | 100 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+)

diff --git a/types/jest/index.d.ts b/types/jest/index.d.ts
index 2afe0eb750..ce0ff1439a 100644
--- a/types/jest/index.d.ts
+++ b/types/jest/index.d.ts
@@ -15,6 +15,7 @@
 //                 Bradley Ayers <https://github.com/bradleyayers>
 //                 Jeff Lau <https://github.com/UselessPickles>
 //                 Andrew Makarov <https://github.com/r3nya>
+//                 Paweł Mikołajczyk <https://github.com/Miklet>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.3
 
@@ -209,6 +210,14 @@ declare namespace jest {
         readonly name: string;
     }
 
+    interface Each {
+        (cases: any[]): (name: string, fn: (...args: any[]) => any) => void;
+        (strings: TemplateStringsArray, ...placeholders: any[]): (
+            name: string,
+            fn: (arg: any) => any
+        ) => void;
+    }
+
     /**
      * Creates a test closure
      */
@@ -227,6 +236,7 @@ declare namespace jest {
         only: It;
         skip: It;
         concurrent: It;
+        each: Each;
     }
 
     interface Describe {
@@ -234,6 +244,7 @@ declare namespace jest {
         (name: number | string | Function | FunctionLike, fn: EmptyFunction): void;
         only: Describe;
         skip: Describe;
+        each: Each;
     }
 
     interface MatcherUtils {
diff --git a/types/jest/jest-tests.ts b/types/jest/jest-tests.ts
index e154561c86..393890025b 100644
--- a/types/jest/jest-tests.ts
+++ b/types/jest/jest-tests.ts
@@ -760,3 +760,103 @@ describe('toHaveBeenNthCalledWith', () => {
 
     expect(fn).toHaveBeenNthCalledWith(3, "foo");
 });
+
+// https://github.com/DefinitelyTyped/DefinitelyTyped/issues/26368
+
+describe.each([[1, 1, 2], [1, 2, 3], [2, 1, 3]])(
+    ".add(%i, %i)",
+    (a: number, b: number, expected: number) => {
+        test(`returns ${expected}`, () => {
+            expect(a + b).toBe(expected);
+        });
+    }
+);
+
+interface Case {
+    a: number;
+    b: number;
+    expected: number;
+}
+
+describe.each`
+    a    | b    | expected
+    ${1} | ${1} | ${2}
+    ${1} | ${2} | ${3}
+    ${2} | ${1} | ${3}
+`("$a + $b", ({ a, b, expected }: Case) => {
+    test(`returns ${expected}`, () => {
+        expect(a + b).toBe(expected);
+    });
+});
+
+describe.only.each([[1, 1, 2], [1, 2, 3], [2, 1, 3]])(
+    ".add(%i, %i)",
+    (a, b, expected) => {
+        test(`returns ${expected}`, () => {
+            expect(a + b).toBe(expected);
+        });
+    }
+);
+
+describe.only.each`
+    a    | b    | expected
+    ${1} | ${1} | ${2}
+    ${1} | ${2} | ${3}
+    ${2} | ${1} | ${3}
+`("$a + $b", ({ a, b, expected }: Case) => {
+    test(`returns ${expected}`, () => {
+        expect(a + b).toBe(expected);
+    });
+});
+
+describe.skip.each([[1, 1, 2], [1, 2, 3], [2, 1, 3]])(
+    ".add(%i, %i)",
+    (a, b, expected) => {
+        test(`returns ${expected}`, () => {
+            expect(a + b).toBe(expected);
+        });
+    }
+);
+
+describe.skip.each`
+    a    | b    | expected
+    ${1} | ${1} | ${2}
+    ${1} | ${2} | ${3}
+    ${2} | ${1} | ${3}
+`("$a + $b", ({ a, b, expected }: Case) => {
+    test(`returns ${expected}`, () => {
+        expect(a + b).toBe(expected);
+    });
+});
+
+test.each([[1, 1, 2], [1, 2, 3], [2, 1, 3]])(
+    ".add(%i, %i)",
+    (a, b, expected) => {
+        expect(a + b).toBe(expected);
+    }
+);
+
+test.each`
+    a    | b    | expected
+    ${1} | ${1} | ${2}
+    ${1} | ${2} | ${3}
+    ${2} | ${1} | ${3}
+`("returns $expected when $a is added $b", ({ a, b, expected }: Case) => {
+    expect(a + b).toBe(expected);
+});
+
+test.only.each([[1, 1, 2], [1, 2, 3], [2, 1, 3]])(
+    ".add(%i, %i)",
+    (a, b, expected) => {
+        expect(a + b).toBe(expected);
+    }
+);
+
+test.only.each`
+    a    | b    | expected
+    ${1} | ${1} | ${2}
+    ${1} | ${2} | ${3}
+    ${2} | ${1} | ${3}
+`("returns $expected when $a is added $b", ({ a, b, expected }: Case) => {
+    expect(a + b).toBe(expected);
+});

From 898ed0479ceda021e9200a275379da0e28e19b69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Miko=C5=82ajczyk?=
 <mikolajczyk.pawel1@gmail.com>
Date: Sat, 16 Jun 2018 15:38:14 +0200
Subject: [PATCH 134/180] Removed unnecessary line from merge

---
 types/jest/jest-tests.ts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/types/jest/jest-tests.ts b/types/jest/jest-tests.ts
index a03c49330b..7d10075262 100644
--- a/types/jest/jest-tests.ts
+++ b/types/jest/jest-tests.ts
@@ -1056,4 +1056,3 @@ test.only.each`
 `("returns $expected when $a is added $b", ({ a, b, expected }: Case) => {
     expect(a + b).toBe(expected);
 });
-

From 00d12824b243269ca07f099f6154b879a2b95b7b Mon Sep 17 00:00:00 2001
From: Ricardo Devis Agullo <mkredz@gmail.com>
Date: Sat, 16 Jun 2018 19:27:43 +0200
Subject: [PATCH 135/180] use tls.ConnectOptions for tls parameter

---
 types/ioredis/index.d.ts       | 5 ++---
 types/ioredis/ioredis-tests.ts | 5 ++++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/types/ioredis/index.d.ts b/types/ioredis/index.d.ts
index 84ca51982a..3ad2f6aeb2 100644
--- a/types/ioredis/index.d.ts
+++ b/types/ioredis/index.d.ts
@@ -16,6 +16,7 @@
 /// <reference types="node" />
 
 import Promise = require('bluebird');
+import tls = require('tls');
 
 interface RedisStatic {
     new(port?: number, host?: string, options?: IORedis.RedisOptions): IORedis.Redis;
@@ -827,9 +828,7 @@ declare namespace IORedis {
          */
         autoResendUnfulfilledCommands?: boolean;
         lazyConnect?: boolean;
-        tls?: {
-            ca: Buffer;
-        };
+        tls?: tls.ConnectionOptions;
         sentinels?: Array<{ host: string; port: number; }>;
         name?: string;
         /**
diff --git a/types/ioredis/ioredis-tests.ts b/types/ioredis/ioredis-tests.ts
index e8e32062dc..7dd98879a5 100644
--- a/types/ioredis/ioredis-tests.ts
+++ b/types/ioredis/ioredis-tests.ts
@@ -29,7 +29,10 @@ new Redis({
     password: 'auth',
     db: 0,
     retryStrategy() { return false; },
-    showFriendlyErrorStack: true
+    showFriendlyErrorStack: true,
+    tls: {
+        servername: 'tlsservername'
+    }
 });
 
 const pub = new Redis();

From 25062452103575f9c4df7e7da42c84f5d2ae73aa Mon Sep 17 00:00:00 2001
From: Leonard Thieu <leonard.thieu@gmail.com>
Date: Sat, 16 Jun 2018 14:55:01 -0400
Subject: [PATCH 136/180] [jquery] Fix error due to breaking change in
 TypeScript lib declarations.

---
 types/jquery/index.d.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/types/jquery/index.d.ts b/types/jquery/index.d.ts
index 72dff2b418..ae9f6f93d5 100644
--- a/types/jquery/index.d.ts
+++ b/types/jquery/index.d.ts
@@ -6361,7 +6361,9 @@ declare namespace JQuery {
         };
 
         // Writable properties on XMLHttpRequest
-        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials' | 'msCaching'>> { }
+        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials'>> {
+            msCaching?: string;
+        }
     }
 
     interface Transport {

From 0f029030bd3760ccf40514fb309b2936650ad092 Mon Sep 17 00:00:00 2001
From: Alexader <alexander.v.tarasyuk@gmail.com>
Date: Sat, 16 Jun 2018 22:12:39 +0300
Subject: [PATCH 137/180] Wrap events to NativeSyntheticEvent

---
 types/react-native/index.d.ts     | 17 ++++++--------
 types/react-native/test/index.tsx | 37 +++++++++++++++++++++++++------
 2 files changed, 37 insertions(+), 17 deletions(-)

diff --git a/types/react-native/index.d.ts b/types/react-native/index.d.ts
index 1614ba91f0..6ddeeb9eda 100644
--- a/types/react-native/index.d.ts
+++ b/types/react-native/index.d.ts
@@ -1088,10 +1088,11 @@ export interface TextInputFocusEventData {
     eventCount: number;
 }
 
-export interface TextInputScrollEvent {
-    nativeEvent: {
-        contentOffset: { x: number; y: number; }
-    }
+/**
+ * @see TextInputProps.onScroll
+ */
+export interface TextInputScrollEventData {
+    contentOffset: { x: number; y: number; }
 }
 
 /**
@@ -1232,7 +1233,7 @@ export interface TextInputProps
      *
      * May also contain other properties from ScrollEvent but on Android contentSize is not provided for performance reasons.
      */
-    onScroll?: (event: TextInputScrollEvent) => void;
+    onScroll?: (e: NativeSyntheticEvent<TextInputScrollEventData>) => void;
 
     /**
      * The string that will be rendered before text input has been entered
@@ -3435,10 +3436,6 @@ interface ImageLoadEventData extends ImageLoadEventDataAndroid {
     }
 }
 
-export interface ImageLoadEvent {
-    nativeEvent: ImageLoadEventData;
-}
-
 /**
  * @see https://facebook.github.io/react-native/docs/image.html
  */
@@ -3461,7 +3458,7 @@ export interface ImagePropsBase extends ImagePropsIOS, ImagePropsAndroid, Access
      * Invoked when load completes successfully
      * { source: { url, height, width } }.
      */
-    onLoad?: (event: ImageLoadEvent) => void;
+    onLoad?: (event: NativeSyntheticEvent<ImageLoadEventData>) => void;
 
     /**
      * Invoked when load either succeeds or fails
diff --git a/types/react-native/test/index.tsx b/types/react-native/test/index.tsx
index d48fdedce4..36e85698fa 100644
--- a/types/react-native/test/index.tsx
+++ b/types/react-native/test/index.tsx
@@ -24,7 +24,7 @@ import {
     Dimensions,
     Image,
     ImageStyle,
-    ImageLoadEvent,
+    ImageLoadEventData,
     InteractionManager,
     ListView,
     ListViewDataSource,
@@ -56,7 +56,7 @@ import {
     StatusBar,
     NativeSyntheticEvent,
     GestureResponderEvent,
-    TextInputScrollEvent,
+    TextInputScrollEventData
 } from "react-native";
 
 declare module "react-native" {
@@ -151,6 +151,25 @@ const viewProperty = StyleSheet.flatten(viewStyle).backgroundColor;
 const textProperty = StyleSheet.flatten(textStyle).fontSize;
 const imageProperty = StyleSheet.flatten(imageStyle).resizeMode;
 
+const testNativeSyntheticEvent = <T extends {}>(e: NativeSyntheticEvent<T>): void => {
+    e.isDefaultPrevented();
+    e.preventDefault();
+    e.isPropagationStopped();
+    e.stopPropagation();
+    e.persist();
+    e.cancelable;
+    e.bubbles;
+    e.currentTarget;
+    e.defaultPrevented;
+    e.eventPhase;
+    e.isTrusted;
+    e.nativeEvent;
+    e.target;
+    e.timeStamp;
+    e.type;
+    e.nativeEvent;
+}
+
 class CustomView extends React.Component {
     render() {
         return <Text style={[StyleSheet.absoluteFill, { ...StyleSheet.absoluteFillObject }]}>Custom View</Text>;
@@ -459,15 +478,18 @@ class TextInputTest extends React.Component<{}, {username: string}> {
         console.log(`text: ${ text }`);
     }
 
-    onScroll = (e: TextInputScrollEvent) => {
+    onScroll = (e: NativeSyntheticEvent<TextInputScrollEventData>) => {
+        testNativeSyntheticEvent(e);
         console.log(`x: ${ e.nativeEvent.contentOffset.x }`);
         console.log(`y: ${ e.nativeEvent.contentOffset.y }`);
     }
 
     handleOnBlur = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
+        testNativeSyntheticEvent(e);
     }
 
     handleOnFocus = (e: NativeSyntheticEvent<TextInputFocusEventData>) => {
+        testNativeSyntheticEvent(e);
     }
 
     render() {
@@ -512,10 +534,11 @@ class StatusBarTest extends React.Component {
 }
 
 export class ImageTest extends React.Component {
-    onLoad(event: ImageLoadEvent) {
-        console.log('height:', event.nativeEvent.source.height);
-        console.log('width:', event.nativeEvent.source.width);
-        console.log('url:', event.nativeEvent.source.url);
+    onLoad(e: NativeSyntheticEvent<ImageLoadEventData>) {
+        testNativeSyntheticEvent(e);
+        console.log('height:', e.nativeEvent.source.height);
+        console.log('width:', e.nativeEvent.source.width);
+        console.log('url:', e.nativeEvent.source.url);
     }
 
     render() {

From 87817e7b36fa0aa75b024e4b0eb264e04a1f3687 Mon Sep 17 00:00:00 2001
From: hans windhoff <hansrwindhoff@gmail.com>
Date: Sat, 16 Jun 2018 15:38:06 -0600
Subject: [PATCH 138/180] Remove reference to crossfilter

As per:
https://github.com/DefinitelyTyped/DefinitelyTyped/issues/26548
---
 types/dc/dc-tests.ts | 5 +++++
 types/dc/index.d.ts  | 4 ----
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/types/dc/dc-tests.ts b/types/dc/dc-tests.ts
index 643594276d..7e1a49727e 100644
--- a/types/dc/dc-tests.ts
+++ b/types/dc/dc-tests.ts
@@ -1,3 +1,8 @@
+import * as CrossFilter from 'crossfilter';
+import * as d3 from "d3";
+import * as dc from "dc";
+
+
 interface IYelpData {
     city: string;
     review_count: number;
diff --git a/types/dc/index.d.ts b/types/dc/index.d.ts
index 4ba0e5e4ab..9100acdc26 100644
--- a/types/dc/index.d.ts
+++ b/types/dc/index.d.ts
@@ -5,10 +5,6 @@
 //                 matthias jobst <https://github.com/MatthiasJobst>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-// this makes only sense together with d3 and crossfilter so you need the d3.d.ts and crossfilter.d.ts files
-
-///<reference types="crossfilter" />
-
 import * as d3 from "d3";
 
 export = dc;

From 9e33d7d9536f86ff16ff9b10d3579353917b4cbf Mon Sep 17 00:00:00 2001
From: islishude <lishude@aliyun.com>
Date: Sun, 17 Jun 2018 10:58:28 +0800
Subject: [PATCH 139/180] fix(node): fix ECDH.converKey()

---
 types/node/index.d.ts    |  4 ++--
 types/node/node-tests.ts | 13 +++++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 5d6b9e9d79..69018ec5f0 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -5836,8 +5836,8 @@ declare module "crypto" {
     export function getCiphers(): string[];
     export function getCurves(): string[];
     export function getHashes(): string[];
-    export interface ECDH {
-        convertKey(key: string | Buffer /*| TypedArray*/ | DataView, curve: string, inputEncoding?: string, outputEncoding?: string, format?: string): Buffer | string;
+    export class ECDH {
+        static convertKey(key: string | Buffer /*| TypedArray*/ | DataView, curve: string, inputEncoding?: "latin1" | "hex" | "base64", outputEncoding?: "latin1" | "hex" | "base64", format?: "uncompressed" | "compressed" | "hybrid"): Buffer | string;
         generateKeys(): Buffer;
         generateKeys(encoding: HexBase64Latin1Encoding, format?: ECDHKeyFormat): string;
         computeSecret(other_public_key: Buffer): Buffer;
diff --git a/types/node/node-tests.ts b/types/node/node-tests.ts
index c8f61b948a..a4850ff4ef 100644
--- a/types/node/node-tests.ts
+++ b/types/node/node-tests.ts
@@ -1151,6 +1151,19 @@ namespace crypto_tests {
         crypto.randomFill(arr, 2, (err: Error, buf: Uint8Array) => void {});
         crypto.randomFill(arr, 2, 3, (err: Error, buf: Uint8Array) => void {});
     }
+
+    {
+        let key: string | Buffer = Buffer.from("buf");
+        let curve = "secp256k1";
+        let ret: string | Buffer = crypto.ECDH.convertKey(key, curve);
+        key = "0xfff";
+        ret = crypto.ECDH.convertKey(key, curve);
+        ret = crypto.ECDH.convertKey(key, curve, "hex");
+        ret = crypto.ECDH.convertKey(key, curve, "hex", "hex");
+        ret = crypto.ECDH.convertKey(key, curve, "hex", "hex", "uncompressed");
+        ret = crypto.ECDH.convertKey(key, curve, "hex", "hex", "compressed");
+        ret = crypto.ECDH.convertKey(key, curve, "hex", "hex", "hybrid");
+    }
 }
 
 //////////////////////////////////////////////////

From 8900f2e6aafa5c66ba365721bf39e955a76ad535 Mon Sep 17 00:00:00 2001
From: Josh Holmer <jholmer.in@gmail.com>
Date: Sat, 16 Jun 2018 23:28:26 -0400
Subject: [PATCH 140/180] [query-string] Update definitions for 6.1

---
 types/query-string/index.d.ts            | 4 +++-
 types/query-string/query-string-tests.ts | 1 +
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/types/query-string/index.d.ts b/types/query-string/index.d.ts
index db823e67d2..8a2f4a30ea 100644
--- a/types/query-string/index.d.ts
+++ b/types/query-string/index.d.ts
@@ -1,14 +1,16 @@
-// Type definitions for query-string 5.1
+// Type definitions for query-string 6.1
 // Project: https://github.com/sindresorhus/query-string
 // Definitions by: Sam Verschueren <https://github.com/SamVerschueren>
 //                 Tanguy Krotoff <https://github.com/tkrotoff>
 //                 HuHuanming <https://github.com/huhuanming>
 //                 Madara Uchiha <https://github.com/MadaraUchiha>
+//                 Josh Holmer <https://github.com/shssoichiro>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.2
 
 export interface ParseOptions {
     arrayFormat?: 'bracket' | 'index' | 'none';
+    decode?: boolean;
 }
 
 /**
diff --git a/types/query-string/query-string-tests.ts b/types/query-string/query-string-tests.ts
index 6e948cf6e5..69c70655ed 100644
--- a/types/query-string/query-string-tests.ts
+++ b/types/query-string/query-string-tests.ts
@@ -24,6 +24,7 @@ import * as queryString from 'query-string';
     let fooBar: { foo: 'bar' };
     fooBar = queryString.parse('?foo=bar');
     fooBar = queryString.parse('#foo=bar');
+    fooBar = queryString.parse('?foo=bar%20baz', { decode: true });
 
     let fooBarBaz: { foo: ['bar', 'baz'] };
     fooBarBaz = queryString.parse('&foo=bar&foo=baz');

From d44f6de28b0e79a32048773e280b91aa83c718a4 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Sun, 17 Jun 2018 21:17:11 +1000
Subject: [PATCH 141/180] Missing definitions in module "dns"

Add loads of `Any*Record` blocks to fill it in as well.

Missing definition for `dns.resolveAny` and `dns.resolve(domain, 'ANY')` in `@types/node`
---
 types/node/index.d.ts | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 5d6b9e9d79..fd9656d3f8 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -25,6 +25,7 @@
 //                 Alexander T. <https://github.com/a-tarasyuk>
 //                 Lishude <https://github.com/islishude>
 //                 Andrew Makarov <https://github.com/r3nya>
+//                 Zane Hannan AU <https://github.com/ZaneHannanAU>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /** inspector module types */
@@ -2560,10 +2561,18 @@ declare module "dns" {
         ttl: number;
     }
 
+    export interface AnyRecordWithTtl extends RecordWithTtl {
+        type: "A" | "AAAA";
+    }
+                                                       
     export interface MxRecord {
         priority: number;
         exchange: string;
     }
+    
+    export interface AnyMxRecord extends MxRecord {
+        type: "MX";
+    }
 
     export interface NaptrRecord {
         flags: string;
@@ -2574,6 +2583,10 @@ declare module "dns" {
         preference: number;
     }
 
+    export interface AnyNaptrRecord extends NaptrRecord {
+        type: "NAPTR"
+    }
+
     export interface SoaRecord {
         nsname: string;
         hostmaster: string;
@@ -2584,6 +2597,10 @@ declare module "dns" {
         minttl: number;
     }
 
+    export interface AnySoaRecord extends SoaRecord {
+        type: "SOA";
+    }
+
     export interface SrvRecord {
         priority: number;
         weight: number;
@@ -2591,9 +2608,14 @@ declare module "dns" {
         name: string;
     }
 
+    export interface AnySrvRecord extends SrvRecord {
+        type: "SRV";
+    }
+
     export function resolve(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "A", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "AAAA", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
+    export function resolve(hostname: string, rrtype: "ANY", callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>) => void): void;
     export function resolve(hostname: string, rrtype: "CNAME", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "MX", callback: (err: NodeJS.ErrnoException, addresses: MxRecord[]) => void): void;
     export function resolve(hostname: string, rrtype: "NAPTR", callback: (err: NodeJS.ErrnoException, addresses: NaptrRecord[]) => void): void;
@@ -2637,6 +2659,7 @@ declare module "dns" {
         export function __promisify__(hostname: string, options?: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
     }
 
+    export function resolveAny(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>) => void): void;
     export function resolveCname(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolveMx(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: MxRecord[]) => void): void;
     export function resolveNaptr(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: NaptrRecord[]) => void): void;

From af005cc3ee7f0bcd3336553b0d5994e5ba7b3cf1 Mon Sep 17 00:00:00 2001
From: Derek Brown <derek@allderek.com>
Date: Sun, 17 Jun 2018 07:30:18 -0400
Subject: [PATCH 142/180] Add `rejectOnError` to `define`

---
 types/sequelize/index.d.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/types/sequelize/index.d.ts b/types/sequelize/index.d.ts
index 2772eaa905..0d9a96bfc4 100644
--- a/types/sequelize/index.d.ts
+++ b/types/sequelize/index.d.ts
@@ -5262,6 +5262,11 @@ declare namespace sequelize {
          * Set to true or a string with the attribute name you want to use to enable.
          */
         version?: boolean | string;
+                     
+        /**
+         * Throws an error when no records found
+         */
+        rejectOnError?: boolean | Error;
     }
 
     /**

From 915af93399f14eb05b415f69f02972703128046d Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Sun, 17 Jun 2018 21:33:58 +1000
Subject: [PATCH 143/180] make travis-ci not throw

```ci
node failing:
Error: /home/travis/build/DefinitelyTyped/DefinitelyTyped/types/node/index.d.ts:2567:1
ERROR: 2567:1   no-trailing-whitespace  trailing whitespace
ERROR: 2572:1   no-trailing-whitespace  trailing whitespace
ERROR: 2587:22  semicolon               Missing semicolon
    at /home/travis/build/DefinitelyTyped/DefinitelyTyped/node_modules/dtslint/bin/index.js:101:19
    at Generator.next (<anonymous>)
    at fulfilled (/home/travis/build/DefinitelyTyped/DefinitelyTyped/node_modules/dtslint/bin/index.js:5:58)
    at <anonymous>
```
---
 types/node/index.d.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index fd9656d3f8..2ed6aa0a58 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -2564,12 +2564,12 @@ declare module "dns" {
     export interface AnyRecordWithTtl extends RecordWithTtl {
         type: "A" | "AAAA";
     }
-                                                       
+
     export interface MxRecord {
         priority: number;
         exchange: string;
     }
-    
+
     export interface AnyMxRecord extends MxRecord {
         type: "MX";
     }
@@ -2584,7 +2584,7 @@ declare module "dns" {
     }
 
     export interface AnyNaptrRecord extends NaptrRecord {
-        type: "NAPTR"
+        type: "NAPTR";
     }
 
     export interface SoaRecord {

From d003a793631d4b6af0b88daea21302b327552918 Mon Sep 17 00:00:00 2001
From: Carlos Precioso <kalprestito@gmail.com>
Date: Sun, 17 Jun 2018 15:02:59 +0200
Subject: [PATCH 144/180] [lodash/fp] Fix typo

---
 types/lodash/fp.d.ts                | 2 +-
 types/lodash/scripts/generate-fp.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/lodash/fp.d.ts b/types/lodash/fp.d.ts
index da68ea250e..c799bd734b 100644
--- a/types/lodash/fp.d.ts
+++ b/types/lodash/fp.d.ts
@@ -4760,6 +4760,6 @@ declare namespace _ {
         zipObjectDeep: LodashZipObjectDeep;
         zipWith: LodashZipWith;
         __: lodash.__;
-        placehodler: lodash.__;
+        placeholder: lodash.__;
     }
 }
diff --git a/types/lodash/scripts/generate-fp.ts b/types/lodash/scripts/generate-fp.ts
index 9a03fef544..817b485cf2 100644
--- a/types/lodash/scripts/generate-fp.ts
+++ b/types/lodash/scripts/generate-fp.ts
@@ -118,7 +118,7 @@ async function main() {
         "    interface LoDashFp {",
         ...interfaceGroups.map(g => `        ${g.functionName}: ${g.interfaces[0].name};`),
         "        __: lodash.__;",
-        "        placehodler: lodash.__;",
+        "        placeholder: lodash.__;",
         "    }",
         "}",
         "",

From bd5ba6e9d50ff3fc2f02106fbac1bec8136c07ce Mon Sep 17 00:00:00 2001
From: Daniel Chao <daniel.h.chao@gmail.com>
Date: Sun, 17 Jun 2018 10:43:30 -0700
Subject: [PATCH 145/180] add line ending stuff

---
 types/nodemailer/index.d.ts                   |  1 +
 .../index.d.ts}                               | 12 ++++------
 .../lib/sendmail-transport/le-unix.d.ts       |  7 ++++++
 .../lib/sendmail-transport/le-windows.d.ts    |  7 ++++++
 types/nodemailer/nodemailer-tests.ts          | 23 ++++++++++++++++++-
 types/nodemailer/tsconfig.json                |  4 +++-
 6 files changed, 45 insertions(+), 9 deletions(-)
 rename types/nodemailer/lib/{sendmail-transport.d.ts => sendmail-transport/index.d.ts} (84%)
 create mode 100644 types/nodemailer/lib/sendmail-transport/le-unix.d.ts
 create mode 100644 types/nodemailer/lib/sendmail-transport/le-windows.d.ts

diff --git a/types/nodemailer/index.d.ts b/types/nodemailer/index.d.ts
index 0b46c67789..31175bd148 100644
--- a/types/nodemailer/index.d.ts
+++ b/types/nodemailer/index.d.ts
@@ -2,6 +2,7 @@
 // Project: https://github.com/nodemailer/nodemailer
 // Definitions by: Rogier Schouten <https://github.com/rogierschouten>
 //                 Piotr Roszatycki <https://github.com/dex4er>
+//                 Daniel Chao <https://github.com/bioball>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.3
 
diff --git a/types/nodemailer/lib/sendmail-transport.d.ts b/types/nodemailer/lib/sendmail-transport/index.d.ts
similarity index 84%
rename from types/nodemailer/lib/sendmail-transport.d.ts
rename to types/nodemailer/lib/sendmail-transport/index.d.ts
index 92e461b01b..c2f970519e 100644
--- a/types/nodemailer/lib/sendmail-transport.d.ts
+++ b/types/nodemailer/lib/sendmail-transport/index.d.ts
@@ -1,14 +1,12 @@
 /// <reference types="node" />
 
-import { EventEmitter } from 'events';
+import { Transport, TransportOptions } from '../..';
 
-import { Transport, TransportOptions } from '..';
+import * as shared from './../shared';
 
-import * as shared from './shared';
-
-import Mail = require('./mailer');
-import MailMessage = require('./mailer/mail-message');
-import MimeNode = require('./mime-node');
+import Mail = require('./../mailer');
+import MailMessage = require('./../mailer/mail-message');
+import MimeNode = require('./../mime-node');
 
 declare namespace SendmailTransport {
     type MailOptions = Mail.Options;
diff --git a/types/nodemailer/lib/sendmail-transport/le-unix.d.ts b/types/nodemailer/lib/sendmail-transport/le-unix.d.ts
new file mode 100644
index 0000000000..2d2e203958
--- /dev/null
+++ b/types/nodemailer/lib/sendmail-transport/le-unix.d.ts
@@ -0,0 +1,7 @@
+/// <reference types="node" />
+
+import { Duplex } from 'stream';
+
+declare class LeUnix extends Duplex {}
+
+export = LeUnix;
diff --git a/types/nodemailer/lib/sendmail-transport/le-windows.d.ts b/types/nodemailer/lib/sendmail-transport/le-windows.d.ts
new file mode 100644
index 0000000000..3af80a5fb6
--- /dev/null
+++ b/types/nodemailer/lib/sendmail-transport/le-windows.d.ts
@@ -0,0 +1,7 @@
+/// <reference types="node" />
+
+import { Duplex } from 'stream';
+
+declare class LeWindows extends Duplex {}
+
+export = LeWindows;
diff --git a/types/nodemailer/nodemailer-tests.ts b/types/nodemailer/nodemailer-tests.ts
index 0caa84b0e0..b3218ba1ab 100644
--- a/types/nodemailer/nodemailer-tests.ts
+++ b/types/nodemailer/nodemailer-tests.ts
@@ -21,6 +21,8 @@ import SMTPTransport = require('nodemailer/lib/smtp-transport');
 import StreamTransport = require('nodemailer/lib/stream-transport');
 import wellKnown = require('nodemailer/lib/well-known');
 import XOAuth2 = require('nodemailer/lib/xoauth2');
+import LeWindows = require('nodemailer/lib/sendmail-transport/le-windows');
+import LeUnix = require('nodemailer/lib/sendmail-transport/le-unix');
 
 import * as fs from 'fs';
 import * as stream from 'stream';
@@ -722,6 +724,25 @@ function sendmail_test() {
     });
 }
 
+// line ending transforms using windows-style newlines
+
+function sendmail_line_endings_windows_test () {
+    function process_le (mail: MailMessage) {
+        const input = mail.message.createReadStream();
+        input.pipe(new LeWindows());
+    }
+}
+
+// line ending transforms using unix-style newlines
+
+function sendmail_line_endings_unix_test() {
+    function process_le(mail: MailMessage) {
+        const input = mail.message.createReadStream();
+        input.pipe(new LeUnix());
+    }
+}
+
+
 // 5. SES transport
 
 // Send a message using SES transport
@@ -1345,4 +1366,4 @@ function well_known_test() {
     if (options) {
         console.log(options.host, options.port, options.secure);
     }
-}
+}
\ No newline at end of file
diff --git a/types/nodemailer/tsconfig.json b/types/nodemailer/tsconfig.json
index f2c1ffbbe8..5977291812 100644
--- a/types/nodemailer/tsconfig.json
+++ b/types/nodemailer/tsconfig.json
@@ -31,7 +31,9 @@
         "lib/mime-funcs/mime-types.d.ts",
         "lib/mime-node.d.ts",
         "lib/qp.d.ts",
-        "lib/sendmail-transport.d.ts",
+        "lib/sendmail-transport/index.d.ts",
+        "lib/sendmail-transport/le-unix.d.ts",
+        "lib/sendmail-transport/le-windows.d.ts",
         "lib/ses-transport.d.ts",
         "lib/shared.d.ts",
         "lib/smtp-connection.d.ts",

From f1a1aba294e69da567230d280e162df819e24477 Mon Sep 17 00:00:00 2001
From: Daniel Chao <daniel.h.chao@gmail.com>
Date: Sun, 17 Jun 2018 10:55:53 -0700
Subject: [PATCH 146/180] fix tests for nodemailer

---
 types/nodemailer/nodemailer-tests.ts | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/types/nodemailer/nodemailer-tests.ts b/types/nodemailer/nodemailer-tests.ts
index b3218ba1ab..6f045df08b 100644
--- a/types/nodemailer/nodemailer-tests.ts
+++ b/types/nodemailer/nodemailer-tests.ts
@@ -726,8 +726,8 @@ function sendmail_test() {
 
 // line ending transforms using windows-style newlines
 
-function sendmail_line_endings_windows_test () {
-    function process_le (mail: MailMessage) {
+function sendmail_line_endings_windows_test() {
+    function process_le(mail: MailMessage) {
         const input = mail.message.createReadStream();
         input.pipe(new LeWindows());
     }
@@ -742,7 +742,6 @@ function sendmail_line_endings_unix_test() {
     }
 }
 
-
 // 5. SES transport
 
 // Send a message using SES transport
@@ -1366,4 +1365,4 @@ function well_known_test() {
     if (options) {
         console.log(options.host, options.port, options.secure);
     }
-}
\ No newline at end of file
+}

From 7b55f15c3e4b30173ec5994dd3072b1f58047dc5 Mon Sep 17 00:00:00 2001
From: khanhas <xuankhanh963@gmail.com>
Date: Mon, 18 Jun 2018 00:56:15 +0700
Subject: [PATCH 147/180] Added StyledText, Picker.Item

---
 types/proton-native/index.d.ts | 141 +++++++++++++++++++--------------
 1 file changed, 80 insertions(+), 61 deletions(-)

diff --git a/types/proton-native/index.d.ts b/types/proton-native/index.d.ts
index 635f180b0e..c3521ede1e 100644
--- a/types/proton-native/index.d.ts
+++ b/types/proton-native/index.d.ts
@@ -169,62 +169,7 @@ export interface AreaPathProps extends AreaBaseProps {
 
 export class AreaPath extends React.Component<AreaPathProps> { }
 
-export interface AreaTextProps extends AreaBaseProps {
-    style?: {
-        /**
-         * The background color, specified as a CSS color string.
-         */
-        backgroundColor?: string;
-        /**
-         * The text color, specified as a CSS color string.
-         */
-        color?: string;
-        /**
-         * The font family (only if available on the system).
-         */
-        fontFamily?: string;
-        /**
-         * The font size (in pt).
-         */
-        fontSize?: number;
-        /**
-         * Whether an italic font should be used.
-         */
-        fontStyle?: 'normal' | 'oblique' | 'italic';
-        /**
-         * Whether a bold font should be used (and the amount).
-         */
-        fontWeight?: 'minimum' | 'thin' | 'ultraLight' | 'light' | 'book' | 'normal' | 'medium' | 'semiBold' | 'bold' | 'ultraBold' | 'heavy' | 'ultraHeavy' | 'maximum' | number;
-        /**
-         * Wheter the text should be aligned to the left, center or right.
-         *
-         * **Works only on a top level text component, not it's children!**
-         */
-        textAlign?: 'left' | 'center' | 'right';
-        /**
-         * How wide or narrow the characters should be.
-         */
-        textStretch?: 'ultraCondensed' | 'extraCondensed' | 'condensed' | 'semiCondensed' | 'normal' | 'semiExpanded' | 'expanded' | 'extraExpanded' | 'ultraExpanded';
-        /**
-         * The text underline style.
-         */
-        textUnderline?: 'none' | 'single' | 'double' | 'suggestion';
-        /**
-         * The text underline color.
-         *
-         * A color string | 'spelling' | 'grammar' | 'auxiliary'
-         */
-        textUnderlineColor?: 'spelling' | 'grammar' | 'auxiliary' | string;
-    };
-    /**
-     * The x coordinate of the text's top left corner. (Only in a top level text component.)
-     */
-    x?: number | string;
-    /**
-     * The y coordinate of the text's top left corner. (Only in a top level text component.)
-     */
-    y?: number | string;
-}
+export interface AreaTextProps extends StyledTextProps, AreaBaseProps { }
 
 export class AreaText extends React.Component<AreaTextProps> { }
 
@@ -616,10 +561,18 @@ export interface PickerProps extends GridChildrenProps, Label, Stretchy {
     visible?: boolean;
 }
 
+export interface PickerItemProps {
+    children: string;
+}
+
+export class PickerItem extends React.Component<PickerItemProps> { }
+
 /**
  * A drop down menu where the user can pick different values.
  */
-export class Picker extends React.Component<PickerProps> { }
+export class Picker extends React.Component<PickerProps> {
+    static Item: typeof PickerItem;
+}
 
 export interface ProgressBarProps extends GridChildrenProps, Label, Stretchy {
     /**
@@ -764,6 +717,65 @@ export interface Stretchy {
     stretchy?: boolean;
 }
 
+export interface StyledTextProps {
+    style?: {
+        /**
+         * The background color, specified as a CSS color string.
+         */
+        backgroundColor?: string;
+        /**
+         * The text color, specified as a CSS color string.
+         */
+        color?: string;
+        /**
+         * The font family (only if available on the system).
+         */
+        fontFamily?: string;
+        /**
+         * The font size (in pt).
+         */
+        fontSize?: number;
+        /**
+         * Whether an italic font should be used.
+         */
+        fontStyle?: 'normal' | 'oblique' | 'italic';
+        /**
+         * Whether a bold font should be used (and the amount).
+         */
+        fontWeight?: 'minimum' | 'thin' | 'ultraLight' | 'light' | 'book' | 'normal' | 'medium' | 'semiBold' | 'bold' | 'ultraBold' | 'heavy' | 'ultraHeavy' | 'maximum' | number;
+        /**
+         * Wheter the text should be aligned to the left, center or right.
+         *
+         * **Works only on a top level text component, not it's children!**
+         */
+        textAlign?: 'left' | 'center' | 'right';
+        /**
+         * How wide or narrow the characters should be.
+         */
+        textStretch?: 'ultraCondensed' | 'extraCondensed' | 'condensed' | 'semiCondensed' | 'normal' | 'semiExpanded' | 'expanded' | 'extraExpanded' | 'ultraExpanded';
+        /**
+         * The text underline style.
+         */
+        textUnderline?: 'none' | 'single' | 'double' | 'suggestion';
+        /**
+         * The text underline color.
+         *
+         * A color string | 'spelling' | 'grammar' | 'auxiliary'
+         */
+        textUnderlineColor?: 'spelling' | 'grammar' | 'auxiliary' | string;
+    };
+    /**
+     * The x coordinate of the text's top left corner. (Only in a top level text component.)
+     */
+    x?: number | string;
+    /**
+     * The y coordinate of the text's top left corner. (Only in a top level text component.)
+     */
+    y?: number | string;
+}
+
+export class StyledText extends React.Component<StyledTextProps> { }
+
 export interface TabProps extends GridChildrenProps {
     /**
      * Whether the Tab is enabled.
@@ -896,17 +908,16 @@ export class Window extends React.Component<WindowProps> { }
 export function render(element: JSX.Element): void;
 
 /**
- * A method to display an alert, or a dialog to save or open a file.
+ * A method to display an alert.
  * @param type What type the dialog is. The current types are:
  * - Message - a simple message
  * - Error - an error message
  * - Open - open a file
  * - Save - save a file
- * @param options Options for the title and description if it is a Message or Error.
- * Required one of title and description (if it is Message or Error)
+ * @param options Options for the title and descript.
  */
 export function Dialog(
-    type: 'Message' | 'Error' | 'Open' | 'Save',
+    type: 'Message' | 'Error',
     options?: {
         title: string,
         description?: string
@@ -915,3 +926,11 @@ export function Dialog(
         description: string
     }
 ): void;
+
+/**
+ * A dialog to save or open a file. Returns chosen file path.
+ * @param type What type the dialog is. The current types are:
+ * - Open - open a file
+ * - Save - save a file
+ */
+export function Dialog(type: 'Open' | 'Save'): string;

From d2964c41bb3cbfc3d4994a477919c021267ea6f9 Mon Sep 17 00:00:00 2001
From: Daniel Chao <daniel.h.chao@gmail.com>
Date: Sun, 17 Jun 2018 10:57:51 -0700
Subject: [PATCH 148/180] Transform is more accurate

---
 types/nodemailer/lib/sendmail-transport/le-unix.d.ts    | 4 ++--
 types/nodemailer/lib/sendmail-transport/le-windows.d.ts | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/types/nodemailer/lib/sendmail-transport/le-unix.d.ts b/types/nodemailer/lib/sendmail-transport/le-unix.d.ts
index 2d2e203958..5f5a3bb25d 100644
--- a/types/nodemailer/lib/sendmail-transport/le-unix.d.ts
+++ b/types/nodemailer/lib/sendmail-transport/le-unix.d.ts
@@ -1,7 +1,7 @@
 /// <reference types="node" />
 
-import { Duplex } from 'stream';
+import { Transform } from 'stream';
 
-declare class LeUnix extends Duplex {}
+declare class LeUnix extends Transform {}
 
 export = LeUnix;
diff --git a/types/nodemailer/lib/sendmail-transport/le-windows.d.ts b/types/nodemailer/lib/sendmail-transport/le-windows.d.ts
index 3af80a5fb6..67ab01ff43 100644
--- a/types/nodemailer/lib/sendmail-transport/le-windows.d.ts
+++ b/types/nodemailer/lib/sendmail-transport/le-windows.d.ts
@@ -1,7 +1,7 @@
 /// <reference types="node" />
 
-import { Duplex } from 'stream';
+import { Transform } from 'stream';
 
-declare class LeWindows extends Duplex {}
+declare class LeWindows extends Transform {}
 
 export = LeWindows;

From 97786c25366c4dbd747980b4836102e9062ad5ed Mon Sep 17 00:00:00 2001
From: Leonard Thieu <leonard.thieu@gmail.com>
Date: Sat, 16 Jun 2018 14:55:01 -0400
Subject: [PATCH 149/180] [jquery] Fix error due to breaking change in
 TypeScript lib declarations.

(cherry picked from commit 2506245)
---
 types/jquery/index.d.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/types/jquery/index.d.ts b/types/jquery/index.d.ts
index a857f74f4a..050118a793 100644
--- a/types/jquery/index.d.ts
+++ b/types/jquery/index.d.ts
@@ -6363,7 +6363,9 @@ declare namespace JQuery {
         };
 
         // Writable properties on XMLHttpRequest
-        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials' | 'msCaching'>> { }
+        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials'>> {
+            msCaching?: string;
+        }
     }
 
     interface Transport {

From 2857609f3c4050f9415b3fe68dbcb0fd8bc15119 Mon Sep 17 00:00:00 2001
From: Tina Roh <tinaroh@gmail.com>
Date: Sun, 17 Jun 2018 13:54:38 -0700
Subject: [PATCH 150/180] Add style prop

---
 types/expo/index.d.ts     | 1 +
 types/expo/v26/index.d.ts | 1 +
 2 files changed, 2 insertions(+)

diff --git a/types/expo/index.d.ts b/types/expo/index.d.ts
index 048d7b884d..98e9076f05 100644
--- a/types/expo/index.d.ts
+++ b/types/expo/index.d.ts
@@ -2201,6 +2201,7 @@ export interface VideoProps {
     translateY?: number;
     rotation?: number;
     ref?: Ref<PlaybackObject>;
+    style?: StyleProp<ViewStyle>;
 }
 
 export interface VideoState {
diff --git a/types/expo/v26/index.d.ts b/types/expo/v26/index.d.ts
index 4e7a0ebdb3..f9bcd1af65 100644
--- a/types/expo/v26/index.d.ts
+++ b/types/expo/v26/index.d.ts
@@ -2181,6 +2181,7 @@ export interface VideoProps {
     translateY?: number;
     rotation?: number;
     ref?: Ref<PlaybackObject>;
+    style?: StyleProp<ViewStyle>;
 }
 
 export interface VideoState {

From 907c8276a33ed5c8cc245f3f167f0dd9981a5b12 Mon Sep 17 00:00:00 2001
From: Keith Kelly <k3ithk@gmail.com>
Date: Sun, 17 Jun 2018 17:46:43 -0400
Subject: [PATCH 151/180] Adds support for selection of different input and
 output streams

---
 types/inquirer/index.d.ts        |  6 ++++-
 types/inquirer/inquirer-tests.ts | 44 ++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/types/inquirer/index.d.ts b/types/inquirer/index.d.ts
index d9258f7a48..16494ecb68 100644
--- a/types/inquirer/index.d.ts
+++ b/types/inquirer/index.d.ts
@@ -21,6 +21,9 @@ declare namespace inquirer {
         | Question<T>
         | ReadonlyArray<Question<T>>
         | Rx.Observable<Question<T>>;
+    type OutputStreamOption = {output: NodeJS.WritableStream};
+    type InputStreamOption = {input: NodeJS.ReadableStream};
+    type StreamOptions = InputStreamOption | OutputStreamOption | (InputStreamOption & OutputStreamOption);
 
     interface Inquirer {
         restoreDefaultPrompts(): void;
@@ -32,8 +35,9 @@ declare namespace inquirer {
         registerPrompt(name: string, prompt: PromptModule): void;
         /**
          * Create a new self-contained prompt module.
+         * @param opt Object specifying input and output streams for the prompt
          */
-        createPromptModule(): PromptModule;
+        createPromptModule(opt?: StreamOptions): PromptModule;
         /**
          * Public CLI helper interface
          * @param questions Questions settings array
diff --git a/types/inquirer/inquirer-tests.ts b/types/inquirer/inquirer-tests.ts
index aa545adae0..85a81d761e 100644
--- a/types/inquirer/inquirer-tests.ts
+++ b/types/inquirer/inquirer-tests.ts
@@ -626,3 +626,47 @@ async function testAsyncPrompt(): Promise<void> {
 }
 
 testAsyncPrompt();
+
+/**
+ * Different prompt output example
+ */
+
+"use strict";
+//var inquirer = require("../lib/inquirer");
+
+var questions = [
+    {
+        type: "input",
+        name: "first_name",
+        message: "What's your first name",
+        prefix: "1 - "
+    },
+    {
+        type: "input",
+        name: "last_name",
+        message: "What's your last name",
+        default: function() {
+            return "Doe";
+        },
+        suffix: "!!"
+    },
+    {
+        type: "input",
+        name: "phone",
+        message: "What's your phone number",
+        validate: function(value: string): string | boolean {
+            var pass = value.match(
+                /^([01]{1})?[\-\.\s]?\(?(\d{3})\)?[\-\.\s]?(\d{3})[\-\.\s]?(\d{4})\s?((?:#|ext\.?\s?|x\.?\s?){1}(?:\d+)?)?$/i
+            );
+            if (pass) {
+                return true;
+            } else {
+                return "Please enter a valid phone number";
+            }
+        }
+    }
+];
+
+inquirer.createPromptModule({ output: process.stderr })(questions, function(answers) {
+    console.log(JSON.stringify(answers, null, "  "));
+});

From f8dbafddf56f0019d960dfb0f72a3a9202fb57a7 Mon Sep 17 00:00:00 2001
From: Keith Kelly <k3ithk@gmail.com>
Date: Sun, 17 Jun 2018 17:55:12 -0400
Subject: [PATCH 152/180] Adds kwkelly as contributor for inquirer

---
 types/inquirer/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/inquirer/index.d.ts b/types/inquirer/index.d.ts
index 16494ecb68..90697f2423 100644
--- a/types/inquirer/index.d.ts
+++ b/types/inquirer/index.d.ts
@@ -7,6 +7,7 @@
 //                 Jason Dreyzehner <https://github.com/bitjson>
 //                 Synarque <https://github.com/synarque>
 //                 Justin Rockwood <https://github.com/jrockwood>
+//                 Keith Kelly <https://github.com/kwkelly>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 // TypeScript Version: 2.3

From bac2d1db5698d9ca8ef8cbf2823f2aadc36606e8 Mon Sep 17 00:00:00 2001
From: Leonard Thieu <leonard-thieu@users.noreply.github.com>
Date: Sun, 17 Jun 2018 18:02:23 -0400
Subject: [PATCH 153/180] [jquery] Fix return types for `JQuery.map`,
 `JQueryStatic.map`, and `JQueryStatic()`. (#26524)

* [jquery] Fix return type of `JQuery.map`.

The type parameter of the JQuery object returned from `JQuery.map` depends on the return values of the callback. Previously, the type parameter was based on the object it was called on.

This fix requires dropping constraints on `JQuery`, `JQueryStatic`, `EventHandler`, and `EventHandlerBase` as `JQuery.map` may return `JQuery` objects that contain non-`Node` values.

* [jquery] Fix return type of `JQueryStatic.map`.

* [jquery] Declare type for `this` in callback for `JQueryStatic.map`.

* [jquery] Fix return type for `JQueryStatic()`.

* [bootstrap] Match change to `JQuery` interface.

* [flight] Fix test failure due to change in `@types/jquery`.

* [materialize-css] Fix test failure due to change in `@types/jquery`.

* [select2] Match changes to `@types/jquery` interfaces.

* [jquery] Fix error due to breaking change in TypeScript lib declarations.

(cherry picked from commit 2506245)
---
 types/bootstrap/index.d.ts                    |   2 +-
 types/flight/flight-tests.ts                  |   2 +-
 types/jquery/index.d.ts                       |  62 +++--
 types/jquery/jquery-tests.ts                  | 233 ++++++++++++++++--
 types/jquery/test/example-tests.ts            |   2 +-
 .../test/jquery-slim-window-module-tests.ts   |   2 +-
 .../jquery/test/jquery-window-module-tests.ts |   2 +-
 types/jquery/tslint.json                      |   1 +
 .../materialize-css/test/inputfields.test.ts  |   2 +-
 types/select2/index.d.ts                      |   6 +-
 10 files changed, 273 insertions(+), 41 deletions(-)

diff --git a/types/bootstrap/index.d.ts b/types/bootstrap/index.d.ts
index 2f43555a73..bba7b71c59 100755
--- a/types/bootstrap/index.d.ts
+++ b/types/bootstrap/index.d.ts
@@ -354,7 +354,7 @@ export type TooltipEvent = "show.bs.tooltip" | "shown.bs.tooltip" | "hide.bs.too
 // --------------------------------------------------------------------------------------
 
 declare global {
-    interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement> {
+    interface JQuery<TElement = HTMLElement> {
         alert(action?: "close" | "dispose"): this;
 
         button(action: "toggle" | "dispose"): this;
diff --git a/types/flight/flight-tests.ts b/types/flight/flight-tests.ts
index bd2f22d1c3..dd21f32f48 100644
--- a/types/flight/flight-tests.ts
+++ b/types/flight/flight-tests.ts
@@ -1,6 +1,6 @@
 
 declare var el: Element;
-declare var els: Element[];
+declare var els: HTMLElement[];
 declare var mixinFn: Function;
 
 function TestComponent() {
diff --git a/types/jquery/index.d.ts b/types/jquery/index.d.ts
index b0838f9a8d..79525510e9 100644
--- a/types/jquery/index.d.ts
+++ b/types/jquery/index.d.ts
@@ -40,7 +40,7 @@ type _Event = Event;
 // Used by JQuery.Promise3 and JQuery.Promise
 type _Promise<T> = Promise<T>;
 
-interface JQueryStatic<TElement extends Node = HTMLElement> {
+interface JQueryStatic<TElement = HTMLElement> {
     /**
      * @see {@link http://api.jquery.com/jquery.ajax/#jQuery-ajax1}
      * @deprecated Use jQuery.ajaxSetup(options)
@@ -137,23 +137,53 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
     // HACK: The discriminator parameter handles the edge case of passing a Window object to JQueryStatic. It doesn't actually exist on the factory function.
     <FElement extends Node = HTMLElement>(window: Window, discriminator: boolean): JQueryStatic<FElement>;
     /**
+     * Return a collection of matched elements either found in the DOM based on passed argument(s) or created
+     * by passing an HTML string.
+     *
+     * @param element_elementArray A DOM element to wrap in a jQuery object.
+     *                             An array containing a set of DOM elements to wrap in a jQuery object.
+     * @see {@link https://api.jquery.com/jQuery/}
+     * @since 1.0
+     */
+    <T extends Element>(element_elementArray: T | ArrayLike<T>): JQuery<T>;
+    /**
+     * Return a collection of matched elements either found in the DOM based on passed argument(s) or created
+     * by passing an HTML string.
+     *
+     * @param selection An existing jQuery object to clone.
+     * @see {@link https://api.jquery.com/jQuery/}
+     * @since 1.0
+     */
+    <T>(selection: JQuery<T>): JQuery<T>;
+    /**
+     * Accepts a string containing a CSS selector which is then used to match a set of elements.
+     *
      * Creates DOM elements on the fly from the provided string of raw HTML.
      *
      * Binds a function to be executed when the DOM has finished loading.
      *
      * @param selector_object_callback A string containing a selector expression
-     *                                 A DOM element to wrap in a jQuery object.
-     *                                 An array containing a set of DOM elements to wrap in a jQuery object.
-     *                                 A plain object to wrap in a jQuery object.
-     *                                 An existing jQuery object to clone.
+     *                                 A string of HTML to create on the fly. Note that this parses HTML, not XML.
      *                                 The function to execute when the DOM is ready.
      * @see {@link https://api.jquery.com/jQuery/}
      * @since 1.0
+     */
+    (selector_object_callback: JQuery.Selector | JQuery.htmlString | ((this: Document, $: JQueryStatic<TElement>) => void)): JQuery<TElement>; // tslint:disable-line:unified-signatures
+    /**
+     * Return a collection of matched elements either found in the DOM based on passed argument(s) or created by passing an HTML string.
+     *
+     * @param object A plain object to wrap in a jQuery object.
+     * @see {@link https://api.jquery.com/jQuery/}
+     * @since 1.0
+     */
+    <T extends JQuery.PlainObject>(object: T): JQuery<T>;
+    /**
+     * Returns an empty jQuery set.
+     *
+     * @see {@link https://api.jquery.com/jQuery/}
      * @since 1.4
      */
-    (selector_object_callback?: JQuery.Selector | JQuery.htmlString | JQuery.TypeOrArray<Element> | JQuery |
-        JQuery.PlainObject | Window |
-        ((this: Document, $: JQueryStatic<TElement>) => void)): JQuery<TElement>;
+    (): JQuery<TElement>;
     /**
      * A multi-purpose callbacks list object that provides a powerful way to manage callback lists.
      *
@@ -659,7 +689,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @see {@link https://api.jquery.com/jQuery.map/}
      * @since 1.0
      */
-    map<T, R>(array: T[], callback: (elementOfArray: T, indexInArray: number) => R): R[];
+    map<T, TReturn>(array: T[], callback: (this: Window, elementOfArray: T, indexInArray: number) => JQuery.TypeOrArray<TReturn> | null | undefined): TReturn[];
     /**
      * Translate all items in an array or object to new array of items.
      *
@@ -671,7 +701,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
      * @see {@link https://api.jquery.com/jQuery.map/}
      * @since 1.6
      */
-    map<T, K extends keyof T, R>(obj: T, callback: (propertyOfObject: T[K], key: K) => R): R[];
+    map<T, K extends keyof T, TReturn>(obj: T, callback: (this: Window, propertyOfObject: T[K], key: K) => JQuery.TypeOrArray<TReturn> | null | undefined): TReturn[];
     /**
      * Merge the contents of two arrays together into the first array.
      *
@@ -3098,7 +3128,7 @@ interface JQueryStatic<TElement extends Node = HTMLElement> {
     when(...deferreds: any[]): JQuery.Promise<any, any, never>;
 }
 
-interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement> {
+interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
     /**
      * A string containing the jQuery version number.
      *
@@ -4253,7 +4283,7 @@ interface JQuery<TElement extends Node = HTMLElement> extends Iterable<TElement>
      * @see {@link https://api.jquery.com/map/}
      * @since 1.2
      */
-    map(callback: (this: TElement, index: number, domElement: TElement) => any | any[] | null | undefined): this;
+    map<TReturn>(callback: (this: TElement, index: number, domElement: TElement) => JQuery.TypeOrArray<TReturn> | null | undefined): JQuery<TReturn>;
     /**
      * Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element.
      *
@@ -6363,7 +6393,9 @@ declare namespace JQuery {
         };
 
         // Writable properties on XMLHttpRequest
-        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials' | 'msCaching'>> { }
+        interface XHRFields extends Partial<Pick<XMLHttpRequest, 'onreadystatechange' | 'responseType' | 'timeout' | 'withCredentials'>> {
+            msCaching?: string;
+        }
     }
 
     interface Transport {
@@ -7922,9 +7954,9 @@ declare namespace JQuery {
 
     // endregion
 
-    interface EventHandler<TCurrentTarget extends EventTarget, TData = null> extends EventHandlerBase<TCurrentTarget, JQuery.Event<TCurrentTarget, TData>> { }
+    interface EventHandler<TCurrentTarget, TData = null> extends EventHandlerBase<TCurrentTarget, JQuery.Event<TCurrentTarget, TData>> { }
 
-    interface EventHandlerBase<TContext extends object, T> {
+    interface EventHandlerBase<TContext, T> {
         // Extra parameters can be passed from trigger()
         (this: TContext, t: T, ...args: any[]): void | false | any;
     }
diff --git a/types/jquery/jquery-tests.ts b/types/jquery/jquery-tests.ts
index 47a85b80d2..89dfabb97e 100644
--- a/types/jquery/jquery-tests.ts
+++ b/types/jquery/jquery-tests.ts
@@ -42,7 +42,7 @@ function JQueryStatic() {
         // $ExpectType JQuery<HTMLElement>
         $([new HTMLElement()]);
 
-        // $ExpectType JQuery<HTMLElement>
+        // $ExpectType JQuery<{ foo: string; hello: string; }>
         $({ foo: 'bar', hello: 'world' });
 
         // $ExpectType JQuery<HTMLElement>
@@ -58,6 +58,39 @@ function JQueryStatic() {
 
         // $ExpectType JQuery<HTMLElement>
         $();
+
+        // https://github.com/DefinitelyTyped/DefinitelyTyped/issues/19597#issuecomment-378218432
+        function issue_19597_378218432() {
+            let myDiv = $(document.createElement('div')); // gets default jQuery<HTMLElement> 8-/
+            // $ExpectType JQuery<HTMLDivElement>
+            myDiv;
+            myDiv.on('click', (evt) => {
+                let target = evt.target; // HTMLElement
+                // $ExpectType HTMLDivElement
+                target;
+            });
+            let myDiv1 = $<HTMLDivElement>(document.createElement('div')); // expected 0-2 Arguments but got 1. huh?
+            // let myDiv2 = $<HTMLDivElement, null>(document.createElement('div')); // expected 0-1 Arguments but got 2. huh?
+            let myForcedDiv: JQuery<HTMLDivElement> = $(document.createElement('div')) as any;
+            myForcedDiv.on('click', (evt) => {
+                let target = evt.target; // HTMLDivElement
+                // $ExpectType HTMLDivElement
+                target;
+            });
+            let myDoc = $(document); // gets default jQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
+            myDoc;
+            myDoc.on('click', (evt) => {
+                let target = evt.target; // HTMLElement
+                // $ExpectType Document
+                target;
+            });
+            let myDocForced: JQuery<Document> = $(document); // type HTMLElement is not assignable to Type Document
+            let myWindow = $(window); // gets default jQuery<HTMLElement>
+            // $ExpectType JQuery<Window>
+            myWindow;
+            let myWindowForced: JQuery<Window> = $(window); // type Window does not satisfy contraint Node
+        }
     }
 
     function ajaxSettings() {
@@ -699,7 +732,9 @@ function JQueryStatic() {
 
     function map() {
         // $ExpectType number[]
-        $.map([1, 2, 3], (elementOfArray, indexInArray) => {
+        $.map([1, 2, 3], function (elementOfArray, indexInArray) {
+            // $ExpectType Window
+            this;
             // $ExpectType number
             elementOfArray;
             // $ExpectType number
@@ -708,11 +743,49 @@ function JQueryStatic() {
             return 200 + 10;
         });
 
+        // $ExpectType number[]
+        $.map([1, 2, 3], function (elementOfArray, indexInArray) {
+            // $ExpectType Window
+            this;
+            // $ExpectType number
+            elementOfArray;
+            // $ExpectType number
+            indexInArray;
+
+            return [200, 10];
+        });
+
+        // $ExpectType (number | null)[]
+        $.map([1, 2, 3], function (elementOfArray, indexInArray) {
+            // $ExpectType Window
+            this;
+            // $ExpectType number
+            elementOfArray;
+            // $ExpectType number
+            indexInArray;
+
+            return [200, 10, null];
+        });
+
+        // $ExpectType (number | undefined)[]
+        $.map([1, 2, 3], function (elementOfArray, indexInArray) {
+            // $ExpectType Window
+            this;
+            // $ExpectType number
+            elementOfArray;
+            // $ExpectType number
+            indexInArray;
+
+            return [200, 10, undefined];
+        });
+
         // $ExpectType (false | 1)[]
         $.map({
             myProp: true,
             name: 'Rogers',
-        }, (propertyOfObject, key) => {
+        }, function (propertyOfObject, key) {
+            // $ExpectType Window
+            this;
             // $ExpectType string | boolean
             propertyOfObject;
             // $ExpectType "myProp" | "name"
@@ -725,6 +798,67 @@ function JQueryStatic() {
                     return false;
             }
         });
+
+        // $ExpectType (string | number | boolean)[]
+        $.map({
+            myProp: true,
+            name: 'Rogers',
+        }, function (propertyOfObject, key) {
+            // $ExpectType Window
+            this;
+            // $ExpectType string | boolean
+            propertyOfObject;
+            // $ExpectType "myProp" | "name"
+            key;
+
+            return [propertyOfObject, 24];
+        });
+
+        // $ExpectType (false | 1)[]
+        $.map({
+            myProp: true,
+            name: 'Rogers',
+            anotherProp: 70,
+        }, function (propertyOfObject, key) {
+            // $ExpectType Window
+            this;
+            // $ExpectType string | number | boolean
+            propertyOfObject;
+            // $ExpectType "myProp" | "name" | "anotherProp"
+            key;
+
+            switch (key) {
+                case 'myProp':
+                    return 1;
+                case 'name':
+                    return false;
+            }
+
+            return null;
+        });
+
+        // $ExpectType (false | 1)[]
+        $.map({
+            myProp: true,
+            name: 'Rogers',
+            anotherProp: 70,
+        }, function (propertyOfObject, key) {
+            // $ExpectType Window
+            this;
+            // $ExpectType string | number | boolean
+            propertyOfObject;
+            // $ExpectType "myProp" | "name" | "anotherProp"
+            key;
+
+            switch (key) {
+                case 'myProp':
+                    return 1;
+                case 'name':
+                    return false;
+            }
+
+            return undefined;
+        });
     }
 
     function merge() {
@@ -2041,7 +2175,7 @@ function JQuery() {
 
     function ajax() {
         function ajaxComplete() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxComplete(function(event, jqXHR, ajaxOptions) {
                 // $ExpectType Document
                 this;
@@ -2057,7 +2191,7 @@ function JQuery() {
         }
 
         function ajaxError() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxError(function(event, jqXHR, ajaxSettings, thrownError) {
                 // $ExpectType Document
                 this;
@@ -2075,7 +2209,7 @@ function JQuery() {
         }
 
         function ajaxSend() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxSend(function(event, jqXHR, ajaxOptions) {
                 // $ExpectType Document
                 this;
@@ -2091,7 +2225,7 @@ function JQuery() {
         }
 
         function ajaxStart() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxStart(function() {
                 // $ExpectType Document
                 this;
@@ -2101,7 +2235,7 @@ function JQuery() {
         }
 
         function ajaxStop() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxStop(function() {
                 // $ExpectType Document
                 this;
@@ -2111,7 +2245,7 @@ function JQuery() {
         }
 
         function ajaxSuccess() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<Document>
             $(document).ajaxSuccess(function(event, jqXHR, ajaxOptions, data) {
                 // $ExpectType Document
                 this;
@@ -5898,8 +6032,9 @@ function JQuery() {
         }
 
         function contents() {
-            // $ExpectType JQuery<HTMLElement | Comment | Text>
-            $('p').contents();
+            // TODO: Flaky test due to type ordering.
+            // // $ExpectType JQuery<HTMLElement | Comment | Text>
+            // $('p').contents();
         }
 
         function end() {
@@ -6131,7 +6266,7 @@ function JQuery() {
         }
 
         function map() {
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<string>
             $('p').map(function(index, domElement) {
                 // $ExpectType HTMLElement
                 this;
@@ -6143,7 +6278,7 @@ function JQuery() {
                 return 'myVal';
             });
 
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<string>
             $('p').map(function(index, domElement) {
                 // $ExpectType HTMLElement
                 this;
@@ -6155,7 +6290,7 @@ function JQuery() {
                 return ['myVal1', 'myVal2'];
             });
 
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<string | null>
             $('p').map(function(index, domElement) {
                 // $ExpectType HTMLElement
                 this;
@@ -6164,10 +6299,10 @@ function JQuery() {
                 // $ExpectType HTMLElement
                 domElement;
 
-                return null;
+                return ['myVal1', 'myVal2', null];
             });
 
-            // $ExpectType JQuery<HTMLElement>
+            // $ExpectType JQuery<string | undefined>
             $('p').map(function(index, domElement) {
                 // $ExpectType HTMLElement
                 this;
@@ -6176,8 +6311,72 @@ function JQuery() {
                 // $ExpectType HTMLElement
                 domElement;
 
-                return undefined;
+                return ['myVal1', 'myVal2', undefined];
             });
+
+            // $ExpectType JQuery<string>
+            $('p').map(function(index, domElement) {
+                // $ExpectType HTMLElement
+                this;
+                // $ExpectType number
+                index;
+                // $ExpectType HTMLElement
+                domElement;
+
+                let value: string;
+
+                if (index % 2 === 0) {
+                    return null;
+                }
+
+                value = 'myVal';
+
+                return value;
+            });
+
+            // $ExpectType JQuery<string>
+            $('p').map(function(index, domElement) {
+                // $ExpectType HTMLElement
+                this;
+                // $ExpectType number
+                index;
+                // $ExpectType HTMLElement
+                domElement;
+
+                let value: string;
+
+                if (index % 2 === 0) {
+                    return undefined;
+                }
+
+                value = 'myVal';
+
+                return value;
+            });
+
+            // // $ExpectType JQuery<never>
+            // $('p').map(function(index, domElement) {
+            //     // $ExpectType HTMLElement
+            //     this;
+            //     // $ExpectType number
+            //     index;
+            //     // $ExpectType HTMLElement
+            //     domElement;
+            //
+            //     return null;
+            // });
+
+            // // $ExpectType JQuery<never>
+            // $('p').map(function(index, domElement) {
+            //     // $ExpectType HTMLElement
+            //     this;
+            //     // $ExpectType number
+            //     index;
+            //     // $ExpectType HTMLElement
+            //     domElement;
+            //
+            //     return undefined;
+            // });
         }
 
         function slice() {
diff --git a/types/jquery/test/example-tests.ts b/types/jquery/test/example-tests.ts
index 728a42b3d6..f725cb2bcb 100644
--- a/types/jquery/test/example-tests.ts
+++ b/types/jquery/test/example-tests.ts
@@ -3428,7 +3428,7 @@ function examples() {
     function map_0() {
         $('p')
             .append($('input').map(function() {
-                return $(this).val();
+                return $(this).val() as string;
             })
                 .get()
                 .join(', '));
diff --git a/types/jquery/test/jquery-slim-window-module-tests.ts b/types/jquery/test/jquery-slim-window-module-tests.ts
index b47707cb23..bf4331d824 100644
--- a/types/jquery/test/jquery-slim-window-module-tests.ts
+++ b/types/jquery/test/jquery-slim-window-module-tests.ts
@@ -1,5 +1,5 @@
 import jq = require('jquery/dist/jquery.slim');
 
 const $window = jq(window);
-// $ExpectType JQuery<HTMLElement>
+// $ExpectType JQuery<Window>
 $window;
diff --git a/types/jquery/test/jquery-window-module-tests.ts b/types/jquery/test/jquery-window-module-tests.ts
index 6bc5486fb9..72cb44c5aa 100644
--- a/types/jquery/test/jquery-window-module-tests.ts
+++ b/types/jquery/test/jquery-window-module-tests.ts
@@ -1,7 +1,7 @@
 import jq = require('jquery');
 
 const $window = jq(window);
-// $ExpectType JQuery<HTMLElement>
+// $ExpectType JQuery<Window>
 $window;
 
 class CanvasLayersDirective {
diff --git a/types/jquery/tslint.json b/types/jquery/tslint.json
index deae83dc66..d1d7bd0a0a 100644
--- a/types/jquery/tslint.json
+++ b/types/jquery/tslint.json
@@ -14,6 +14,7 @@
         "no-empty-interface": false,
         "no-misused-new": false,
         "no-object-literal-type-assertion": false,
+        "no-redundant-jsdoc-2": false,
         "no-unnecessary-generics": false,
         "no-unnecessary-qualifier": false,
         "no-unnecessary-type-assertion": false,
diff --git a/types/materialize-css/test/inputfields.test.ts b/types/materialize-css/test/inputfields.test.ts
index ecde571537..15ea61c1ee 100644
--- a/types/materialize-css/test/inputfields.test.ts
+++ b/types/materialize-css/test/inputfields.test.ts
@@ -1,6 +1,6 @@
 import * as materialize from "materialize-css";
 
-const elem = document.querySelector('.whatever')!;
+const elem = document.querySelector('.whatever') as HTMLElement;
 
 M.textareaAutoResize(elem);
 M.textareaAutoResize($(elem));
diff --git a/types/select2/index.d.ts b/types/select2/index.d.ts
index a0c1ce3b1d..240b4b7f25 100644
--- a/types/select2/index.d.ts
+++ b/types/select2/index.d.ts
@@ -26,7 +26,7 @@ export type JQueryAjaxSettingsBase =
 /**
  * Same as jQuery v3 `JQuery.EventHandlerBase`.
  */
-export type JQueryEventHandlerBase<TContext extends object, T> =
+export type JQueryEventHandlerBase<TContext, T> =
     (this: TContext, t: T, ...args: any[]) => void | false;
 
 /**
@@ -221,7 +221,7 @@ export interface Options<Result = DataFormat | GroupedDataFormat, RemoteResult =
 // jQuery And Select2 Plugin
 // --------------------------------------------------------------------------
 
-export interface Select2Plugin<TElement extends Node = HTMLElement>  {
+export interface Select2Plugin<TElement = HTMLElement>  {
     amd: { require: Require; };
 
     defaults: {
@@ -252,7 +252,7 @@ export interface Select2Plugin<TElement extends Node = HTMLElement>  {
 }
 
 declare global {
-    interface JQuery<TElement extends Node = HTMLElement> {
+    interface JQuery<TElement = HTMLElement> {
         select2: Select2Plugin<TElement>;
         data(key: "select2"): Select2;
 

From 9ba0229a929fe8fccdcacff0212822dcaec05ebd Mon Sep 17 00:00:00 2001
From: Keith Kelly <k3ithk@gmail.com>
Date: Sun, 17 Jun 2018 19:04:50 -0400
Subject: [PATCH 154/180] Changes NodeJS.WritableStream to NodeJS.WriteStream
 and NodeJS.ReadableStream to NodeJS.ReadStream to correctly type check
 process.stdin, process.stdout, and process.stderr

---
 types/inquirer/index.d.ts | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/types/inquirer/index.d.ts b/types/inquirer/index.d.ts
index 90697f2423..9f23ad21aa 100644
--- a/types/inquirer/index.d.ts
+++ b/types/inquirer/index.d.ts
@@ -22,8 +22,12 @@ declare namespace inquirer {
         | Question<T>
         | ReadonlyArray<Question<T>>
         | Rx.Observable<Question<T>>;
-    type OutputStreamOption = {output: NodeJS.WritableStream};
-    type InputStreamOption = {input: NodeJS.ReadableStream};
+    interface OutputStreamOption {
+        output: NodeJS.WriteStream
+    }
+    interface InputStreamOption {
+        input: NodeJS.ReadStream
+    }
     type StreamOptions = InputStreamOption | OutputStreamOption | (InputStreamOption & OutputStreamOption);
 
     interface Inquirer {
@@ -38,7 +42,7 @@ declare namespace inquirer {
          * Create a new self-contained prompt module.
          * @param opt Object specifying input and output streams for the prompt
          */
-        createPromptModule(opt?: StreamOptions): PromptModule;
+        createPromptModule(opt?: OutputStreamOption): PromptModule;
         /**
          * Public CLI helper interface
          * @param questions Questions settings array

From 0fd0fa73ff572fa00d99f2ef7c1425d09f4f5d3d Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 10:13:29 +1000
Subject: [PATCH 155/180] Add promisified version

---
 types/node/index.d.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 2ed6aa0a58..11a2d1d663 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -2629,6 +2629,7 @@ declare module "dns" {
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     export namespace resolve {
         export function __promisify__(hostname: string, rrtype?: "A" | "AAAA" | "CNAME" | "NS" | "PTR"): Promise<string[]>;
+        export function __promisify__(hostname: string, rrtype: "ANY"): Promise<ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>>;
         export function __promisify__(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
         export function __promisify__(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
         export function __promisify__(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;

From 6edbf642eea7f41085027dbf7c20fdba16f0b332 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 10:34:39 +1000
Subject: [PATCH 156/180] Add test for `resolve(hostname, "ANY")`

Test for `resolveAny` not added as other tests for the same haven't been added.
---
 types/node/node-tests.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/types/node/node-tests.ts b/types/node/node-tests.ts
index c8f61b948a..329abeab29 100644
--- a/types/node/node-tests.ts
+++ b/types/node/node-tests.ts
@@ -3129,6 +3129,9 @@ namespace dns_tests {
     dns.resolve("nodejs.org", "AAAA", (err, addresses) => {
         const _addresses: string[] = addresses;
     });
+    dns.resolve("nodejs.org", "ANY", (err, addresses) => {
+        const _addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord> = addresses;
+    });
     dns.resolve("nodejs.org", "MX", (err, addresses) => {
         const _addresses: dns.MxRecord[] = addresses;
     });

From c7fc7d5905c9dc70ae5f8d50ff35baa1541716cb Mon Sep 17 00:00:00 2001
From: ckboyjiy <ckboyjiy@nate.com>
Date: Mon, 18 Jun 2018 09:41:32 +0900
Subject: [PATCH 157/180] Added a parameter in EventListener functions

---
 types/navermaps/index.d.ts | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/types/navermaps/index.d.ts b/types/navermaps/index.d.ts
index ec857696bf..8ba4d52bd5 100644
--- a/types/navermaps/index.d.ts
+++ b/types/navermaps/index.d.ts
@@ -39,7 +39,7 @@ declare namespace naver.maps {
    */
    interface MapEventListener {
      eventName: string;
-     listener: () => any;
+     listener: (event: any) => any;
      listenerId: string;
      target: any;
    }
@@ -1303,14 +1303,14 @@ declare namespace naver.maps {
 
   function Event(): void;
   namespace Event {
-    function addDOMListener(element: HTMLElement, eventName: string, listener: () => any): void;
-    function addListener(target: any, eventName: string, listener: () => any): MapEventListener;
+    function addDOMListener(element: HTMLElement, eventName: string, listener: (event: any) => any): void;
+    function addListener(target: any, eventName: string, listener: (event: any) => any): MapEventListener;
     function clearInstanceListeners(target: any): void;
     function clearListeners(target: any, fromEventName: string): void;
     function forward(source: any, fromEventName: string, target: any, toEventName: string): MapEventListener;
     function hasListener(target: any, eventName: string): boolean;
-    function once(target: any, eventName: string, listener: () => any): MapEventListener;
-    function removeDOMListener(element: HTMLElement, eventName: string, listener: () => any): void;
+    function once(target: any, eventName: string, listener: (event: any) => any): MapEventListener;
+    function removeDOMListener(element: HTMLElement, eventName: string, listener: (event: any) => any): void;
     function removeDOMListener(listeners: DOMEventListener | DOMEventListener[]): void;
     function removeListener(listeners: MapEventListener | MapEventListener[]): void;
     function resumeDispatch(target: any, eventName: string): void;

From b3dfeb51e02406d81968dedf03f36d97fffd2c41 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 10:52:13 +1000
Subject: [PATCH 158/180] Add `AnyTxtRecord`

---
 types/node/index.d.ts | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 11a2d1d663..83b63500cd 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -2612,10 +2612,15 @@ declare module "dns" {
         type: "SRV";
     }
 
+    export interface AnyTxtRecord {
+        type: "TXT";
+        entries: string[]
+    }
+
     export function resolve(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "A", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "AAAA", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
-    export function resolve(hostname: string, rrtype: "ANY", callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>) => void): void;
+    export function resolve(hostname: string, rrtype: "ANY", callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord | AnyTxtRecord>) => void): void;
     export function resolve(hostname: string, rrtype: "CNAME", callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolve(hostname: string, rrtype: "MX", callback: (err: NodeJS.ErrnoException, addresses: MxRecord[]) => void): void;
     export function resolve(hostname: string, rrtype: "NAPTR", callback: (err: NodeJS.ErrnoException, addresses: NaptrRecord[]) => void): void;
@@ -2629,7 +2634,7 @@ declare module "dns" {
     // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
     export namespace resolve {
         export function __promisify__(hostname: string, rrtype?: "A" | "AAAA" | "CNAME" | "NS" | "PTR"): Promise<string[]>;
-        export function __promisify__(hostname: string, rrtype: "ANY"): Promise<ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>>;
+        export function __promisify__(hostname: string, rrtype: "ANY"): Promise<ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord | AnyTxtRecord>>;
         export function __promisify__(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
         export function __promisify__(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
         export function __promisify__(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
@@ -2660,7 +2665,7 @@ declare module "dns" {
         export function __promisify__(hostname: string, options?: ResolveOptions): Promise<string[] | RecordWithTtl[]>;
     }
 
-    export function resolveAny(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord>) => void): void;
+    export function resolveAny(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord | AnyTxtRecord>) => void): void;
     export function resolveCname(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;
     export function resolveMx(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: MxRecord[]) => void): void;
     export function resolveNaptr(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: NaptrRecord[]) => void): void;

From 7521d75c2a5c1ca6c4481aa89df23f713ff67351 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 10:52:32 +1000
Subject: [PATCH 159/180] Fix references, add `AnyTxtRecord`

---
 types/node/node-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/node/node-tests.ts b/types/node/node-tests.ts
index 329abeab29..740866d475 100644
--- a/types/node/node-tests.ts
+++ b/types/node/node-tests.ts
@@ -3130,7 +3130,7 @@ namespace dns_tests {
         const _addresses: string[] = addresses;
     });
     dns.resolve("nodejs.org", "ANY", (err, addresses) => {
-        const _addresses: ReadonlyArray<AnySrvRecord | AnySoaRecord | AnyNaptrRecord | AnyRecordWithTtl | AnyMxRecord> = addresses;
+        const _addresses: ReadonlyArray<dns.AnySrvRecord | dms.AnySoaRecord | dns.AnyNaptrRecord | dns.AnyRecordWithTtl | dns.AnyMxRecord | dns.AnyTxtRecord> = addresses;
     });
     dns.resolve("nodejs.org", "MX", (err, addresses) => {
         const _addresses: dns.MxRecord[] = addresses;

From 057d36c5884d8c7279303946309dee814d44b983 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 11:44:19 +1000
Subject: [PATCH 160/180] add a semicolon

---
 types/node/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index 83b63500cd..ade922bb34 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -2614,7 +2614,7 @@ declare module "dns" {
 
     export interface AnyTxtRecord {
         type: "TXT";
-        entries: string[]
+        entries: string[];
     }
 
     export function resolve(hostname: string, callback: (err: NodeJS.ErrnoException, addresses: string[]) => void): void;

From 169b2063839b313fcabd4e4cded0bfa26690d8b8 Mon Sep 17 00:00:00 2001
From: ZaneHannanAU <ZaneHannanAU@users.noreply.github.com>
Date: Mon, 18 Jun 2018 11:48:35 +1000
Subject: [PATCH 161/180] ... fix spelling mistake

---
 types/node/node-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/node/node-tests.ts b/types/node/node-tests.ts
index 740866d475..5f82a36672 100644
--- a/types/node/node-tests.ts
+++ b/types/node/node-tests.ts
@@ -3130,7 +3130,7 @@ namespace dns_tests {
         const _addresses: string[] = addresses;
     });
     dns.resolve("nodejs.org", "ANY", (err, addresses) => {
-        const _addresses: ReadonlyArray<dns.AnySrvRecord | dms.AnySoaRecord | dns.AnyNaptrRecord | dns.AnyRecordWithTtl | dns.AnyMxRecord | dns.AnyTxtRecord> = addresses;
+        const _addresses: ReadonlyArray<dns.AnySrvRecord | dns.AnySoaRecord | dns.AnyNaptrRecord | dns.AnyRecordWithTtl | dns.AnyMxRecord | dns.AnyTxtRecord> = addresses;
     });
     dns.resolve("nodejs.org", "MX", (err, addresses) => {
         const _addresses: dns.MxRecord[] = addresses;

From ca21971cc3675fb6e450913eaf21f1f80777d938 Mon Sep 17 00:00:00 2001
From: Kyle Roach <kroach.work@gmail.com>
Date: Mon, 18 Jun 2018 05:09:17 -0400
Subject: [PATCH 162/180] (react-navigation) Allow setParams to be partial

---
 types/react-navigation/index.d.ts             |  2 +-
 .../react-navigation-tests.tsx                | 25 +++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/types/react-navigation/index.d.ts b/types/react-navigation/index.d.ts
index d13c342cf9..332f4e4645 100644
--- a/types/react-navigation/index.d.ts
+++ b/types/react-navigation/index.d.ts
@@ -576,7 +576,7 @@ export interface NavigationScreenProp<S, P = NavigationParams> {
   closeDrawer: () => any;
   toggleDrawer: () => any;
   getParam: <T extends keyof P>(param: T, fallback?: P[T]) => P[T];
-  setParams: (newParams: P) => boolean;
+  setParams: (newParams: Partial<P>) => boolean;
   addListener: (
     eventName: string,
     callback: NavigationEventCallback
diff --git a/types/react-navigation/react-navigation-tests.tsx b/types/react-navigation/react-navigation-tests.tsx
index 7563708163..03b6f76775 100644
--- a/types/react-navigation/react-navigation-tests.tsx
+++ b/types/react-navigation/react-navigation-tests.tsx
@@ -489,3 +489,28 @@ const CustomHeaderStack = createStackNavigator({
         }
     }
 });
+
+interface ScreenProps {
+    name: string;
+    onPlay(): void;
+}
+
+class SetParamsTest extends React.Component<NavigationScreenProps<ScreenProps>> {
+    componentDidMount() {
+        this.props.navigation.setParams({
+            onPlay: this.onPlay
+        });
+    }
+
+    onPlay = () => {
+        //
+    }
+
+    render() {
+        const name = this.props.navigation.getParam('name');
+
+        return (
+            <Text>My name is {name}</Text>
+        );
+    }
+}

From c8a873d4abddf141f31f9be39932b7aeaa32a049 Mon Sep 17 00:00:00 2001
From: ZSkycat <skycatmew@gmail.com>
Date: Mon, 18 Jun 2018 17:33:25 +0800
Subject: [PATCH 163/180] [webpack] fix WebpackConfig.Node value type

---
 types/webpack/index.d.ts | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/types/webpack/index.d.ts b/types/webpack/index.d.ts
index 0339a4ebb5..55d7dbd801 100644
--- a/types/webpack/index.d.ts
+++ b/types/webpack/index.d.ts
@@ -12,6 +12,7 @@
 //                 Jason Cheatham <https://github.com/jason0x43>
 //                 Dennis George <https://github.com/dennispg>
 //                 Christophe Hurpeau <https://github.com/christophehurpeau>
+//                 ZSkycat <https://github.com/ZSkycat>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.3
 
@@ -349,14 +350,16 @@ declare namespace webpack {
     type ExternalsFunctionElement = (context: any, request: any, callback: (error: any, result: any) => void) => any;
 
     interface Node {
-        console?: boolean;
+        console?: boolean | 'mock';
+        process?: boolean | 'mock';
         global?: boolean;
-        process?: boolean;
-        Buffer?: boolean;
-        __filename?: boolean | string;
-        __dirname?: boolean | string;
-        [nodeBuiltin: string]: boolean | string | undefined;
+        __filename?: boolean | 'mock';
+        __dirname?: boolean | 'mock';
+        Buffer?: boolean | 'mock';
+        setImmediate?: boolean | 'mock' | 'empty';
+        [nodeBuiltin: string]: boolean | 'mock' | 'empty' | undefined;
     }
+
     interface NewLoader {
         loader: string;
         options?: { [name: string]: any };

From 2003aafc568f219d14c72b02e9b71c782feb9d53 Mon Sep 17 00:00:00 2001
From: Holger Jeromin <mailgithub@katur.de>
Date: Mon, 18 Jun 2018 11:44:28 +0200
Subject: [PATCH 164/180] Adding more tests

---
 types/jquery/jquery-tests.ts | 44 ++++++++++++++++++++++++++++--------
 1 file changed, 35 insertions(+), 9 deletions(-)

diff --git a/types/jquery/jquery-tests.ts b/types/jquery/jquery-tests.ts
index 89dfabb97e..ea14206f2e 100644
--- a/types/jquery/jquery-tests.ts
+++ b/types/jquery/jquery-tests.ts
@@ -35,12 +35,36 @@ function JQueryStatic() {
 
         // $ExpectType JQuery<HTMLElement>
         $('<p></p>');
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>('<p></p>');
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>('<p></p>', document);
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>('p');
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>('p', document);        
 
         // $ExpectType JQuery<HTMLElement>
         $(new HTMLElement());
 
         // $ExpectType JQuery<HTMLElement>
         $([new HTMLElement()]);
+        
+        // $ExpectType JQuery<HTMLElement>
+        $(new HTMLParagraphElement());
+        
+        // $ExpectType JQuery<HTMLElement>
+        $([new HTMLParagraphElement()]);
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>(new HTMLParagraphElement());
+        
+        // $ExpectType JQuery<HTMLParagraphElement>
+        $<HTMLParagraphElement>([new HTMLParagraphElement()]);        
 
         // $ExpectType JQuery<{ foo: string; hello: string; }>
         $({ foo: 'bar', hello: 'world' });
@@ -61,35 +85,37 @@ function JQueryStatic() {
 
         // https://github.com/DefinitelyTyped/DefinitelyTyped/issues/19597#issuecomment-378218432
         function issue_19597_378218432() {
-            let myDiv = $(document.createElement('div')); // gets default jQuery<HTMLElement> 8-/
+            let myDiv = $(document.createElement('div'));
             // $ExpectType JQuery<HTMLDivElement>
             myDiv;
             myDiv.on('click', (evt) => {
-                let target = evt.target; // HTMLElement
+                let target = evt.target;
                 // $ExpectType HTMLDivElement
                 target;
             });
-            let myDiv1 = $<HTMLDivElement>(document.createElement('div')); // expected 0-2 Arguments but got 1. huh?
-            // let myDiv2 = $<HTMLDivElement, null>(document.createElement('div')); // expected 0-1 Arguments but got 2. huh?
+            let myDiv1 = $<HTMLDivElement>(document.createElement('div'));
+            
             let myForcedDiv: JQuery<HTMLDivElement> = $(document.createElement('div')) as any;
             myForcedDiv.on('click', (evt) => {
                 let target = evt.target; // HTMLDivElement
                 // $ExpectType HTMLDivElement
                 target;
             });
-            let myDoc = $(document); // gets default jQuery<HTMLElement>
+            let myDoc = $(document);
             // $ExpectType JQuery<Document>
             myDoc;
             myDoc.on('click', (evt) => {
-                let target = evt.target; // HTMLElement
+                let target = evt.target;
                 // $ExpectType Document
                 target;
             });
-            let myDocForced: JQuery<Document> = $(document); // type HTMLElement is not assignable to Type Document
-            let myWindow = $(window); // gets default jQuery<HTMLElement>
+            let myDocForced: JQuery<Document> = $(document);
+            let myWindow = $(window);
             // $ExpectType JQuery<Window>
             myWindow;
-            let myWindowForced: JQuery<Window> = $(window); // type Window does not satisfy contraint Node
+            let myWindowForced: JQuery<Window> = $(window);
+            // $ExpectType JQuery<Window>
+            myWindowForced;
         }
     }
 

From c915949234d17cf0f5e5d899520dd3137f38557f Mon Sep 17 00:00:00 2001
From: Martin Feckie <mfeckie@gmail.com>
Date: Mon, 18 Jun 2018 20:35:47 +1000
Subject: [PATCH 165/180] Allow any comparison type for rejectBy

---
 types/ember/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/ember/index.d.ts b/types/ember/index.d.ts
index 56a0879ae5..2c9c3c8b7e 100755
--- a/types/ember/index.d.ts
+++ b/types/ember/index.d.ts
@@ -1173,7 +1173,7 @@ declare module 'ember' {
              * key.  You can pass an optional second argument with the target value.  Otherwise
              * this will match any property that evaluates to false.
              */
-            rejectBy(key: string, value?: string): NativeArray<T>;
+            rejectBy(key: string, value?: any): NativeArray<T>;
             /**
              * Returns the first item in the array for which the callback returns true.
              * This method works similar to the `filter()` method defined in JavaScript 1.6

From 474ff5890649dd1246dbd92565f455d2c848e71d Mon Sep 17 00:00:00 2001
From: Josef Hornych <hornych@engeto.com>
Date: Mon, 18 Jun 2018 12:37:48 +0200
Subject: [PATCH 166/180] Added Client class and definitions of functions for
 Client.users

---
 types/intercom-client/LICENSE      | 21 ++++++++
 types/intercom-client/README.md    | 16 ++++++
 types/intercom-client/Scroll.d.ts  |  3 ++
 types/intercom-client/User.d.ts    | 85 ++++++++++++++++++++++++++++++
 types/intercom-client/index.d.ts   | 36 +++++++++++++
 types/intercom-client/package.json | 48 +++++++++++++++++
 6 files changed, 209 insertions(+)
 create mode 100644 types/intercom-client/LICENSE
 create mode 100644 types/intercom-client/README.md
 create mode 100644 types/intercom-client/Scroll.d.ts
 create mode 100644 types/intercom-client/User.d.ts
 create mode 100644 types/intercom-client/package.json

diff --git a/types/intercom-client/LICENSE b/types/intercom-client/LICENSE
new file mode 100644
index 0000000000..21071075c2
--- /dev/null
+++ b/types/intercom-client/LICENSE
@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation. All rights reserved.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE
diff --git a/types/intercom-client/README.md b/types/intercom-client/README.md
new file mode 100644
index 0000000000..481eebf5e4
--- /dev/null
+++ b/types/intercom-client/README.md
@@ -0,0 +1,16 @@
+# Installation
+> `npm install --save @types/intercom-client`
+
+# Summary
+This package contains type definitions for intercom-client (https://github.com/intercom/intercom-node).
+
+# Details
+Files were exported from https://www.github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/intercom-client
+
+Additional Details
+ * Last updated: Thu, 03 May 2018 15:33:57 GMT
+ * Dependencies: none
+ * Global values: none
+
+# Credits
+These definitions were written by Jinesh Shah <https://github.com/jineshshah36>, Josef Hornych <https://github.com/peping>.
diff --git a/types/intercom-client/Scroll.d.ts b/types/intercom-client/Scroll.d.ts
new file mode 100644
index 0000000000..2704a4cfbe
--- /dev/null
+++ b/types/intercom-client/Scroll.d.ts
@@ -0,0 +1,3 @@
+export declare class Scroll<T> {
+
+}
\ No newline at end of file
diff --git a/types/intercom-client/User.d.ts b/types/intercom-client/User.d.ts
new file mode 100644
index 0000000000..a6ff10875a
--- /dev/null
+++ b/types/intercom-client/User.d.ts
@@ -0,0 +1,85 @@
+import {Company} from "intercom-client";
+
+export type UserIdentifier = { "id": string } | { "user_id": string } | { "email": string }
+
+export interface Avatar {
+    "type": "avatar",
+    "image_url": string | null
+}
+
+export interface SocialProfile {
+    "name": "Twitter",
+    readonly "id": string,
+    "username": "th1sland",
+    "url": "http://twitter.com/th1sland"
+}
+
+export interface Segment {
+    readonly "id": string
+}
+
+export interface Tag {
+    readonly "id": string
+}
+
+interface LocationData {
+    "type": "location_data",
+    "city_name": string | null,
+    "continent_code": string | null,
+    "country_code": string | null,
+    "country_name": string | null,
+    "latitude": number | null,
+    "longitude": number | null,
+    "postal_code": string | null,
+    "region_name": string | null,
+    "timezone": string | null
+}
+
+export interface User {
+    "type": "user" | "contact",
+    readonly "id": string,
+    "user_id": string | null,
+    "email": string | null,
+    "app_id"?: string,
+    "phone": string | null,
+    "name": string | null,
+    readonly "updated_at": number,
+    "last_seen_ip": string | null,
+    "unsubscribed_from_emails": boolean,
+    "last_request_at": number | null,
+    "signed_up_at": number | null,
+    readonly "created_at": number,
+    "session_count": number,
+    "user_agent_data": string | null,
+    "pseudonym": string | null,
+    "anonymous": boolean,
+    "custom_attributes": {
+        [key: string]: any
+    },
+    "avatar": Avatar,
+    "location_data": LocationData | {},
+    "social_profiles": {
+        "type": "social_profile.list",
+        "social_profiles": SocialProfile[]
+    },
+    "companies": {
+        "type": "company.list",
+        "companies": Company[]
+    },
+    "segments": {
+        "type": "segment.list",
+        "segments": Segment[]
+
+    },
+    "tags": {
+        "type": "tag.list",
+        "tags": Tag[]
+    }
+}
+
+export interface List {
+    "type": "user.list",
+    "total_count": number,
+    "users": User[],
+    "pages": { "next"?: string, "page": number, "per_page": number, "total_pages": number }
+}
\ No newline at end of file
diff --git a/types/intercom-client/index.d.ts b/types/intercom-client/index.d.ts
index b68dc87e71..67b1e10476 100644
--- a/types/intercom-client/index.d.ts
+++ b/types/intercom-client/index.d.ts
@@ -3,6 +3,9 @@
 // Definitions by: Jinesh Shah <https://github.com/jineshshah36>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
+import {List as UserList, User, UserIdentifier} from './User';
+import {Scroll} from './Scroll';
+
 export interface IdentityVerificationOptions {
     secretKey: string;
     identifier: string;
@@ -11,3 +14,36 @@ export interface IdentityVerificationOptions {
 export const IdentityVerification: {
     userHash(opts: IdentityVerificationOptions): string;
 };
+
+
+export declare class Client {
+    constructor(auth: { token: string });
+    constructor(username: string, password: string);
+    constructor(auth: { appId: string, appApiKey: string });
+    
+    users: Users;
+}
+
+
+interface Company {
+    readonly "id": string
+}
+
+
+declare class Users {
+    create(user: Partial<User>): Promise<User>
+
+    update(user: UserIdentifier & Partial<User> ): Promise<User>
+
+    find(identifier: UserIdentifier): Promise<User>
+
+    list(): Promise<UserList>
+
+    listBy(params: {tag_id: string, segment_id: string}): Promise<UserList>
+
+    scroll: Scroll<User>
+
+    archive(): Promise<User>
+
+    requestPermanentDeletion(): Promise<{id: number}>
+}
\ No newline at end of file
diff --git a/types/intercom-client/package.json b/types/intercom-client/package.json
new file mode 100644
index 0000000000..99ab47808b
--- /dev/null
+++ b/types/intercom-client/package.json
@@ -0,0 +1,48 @@
+{
+  "_from": "@types/intercom-client",
+  "_id": "@types/intercom-client@2.9.0",
+  "_inBundle": false,
+  "_integrity": "sha512-BijYT7XATNJ4TOwj3OULC8FRt2OgGJ18wxV/M5Hjl4Ql7kXa/Mr0s0fgcuegn6SsmEqOg/CYCPEeUILzKXHR/g==",
+  "_location": "/@types/intercom-client",
+  "_phantomChildren": {},
+  "_requested": {
+    "type": "tag",
+    "registry": true,
+    "raw": "@types/intercom-client",
+    "name": "@types/intercom-client",
+    "escapedName": "@types%2fintercom-client",
+    "scope": "@types",
+    "rawSpec": "",
+    "saveSpec": null,
+    "fetchSpec": "latest"
+  },
+  "_requiredBy": [
+    "#DEV:/",
+    "#USER"
+  ],
+  "_resolved": "https://registry.npmjs.org/@types/intercom-client/-/intercom-client-2.9.0.tgz",
+  "_shasum": "7713308ace441835e687662bbf08d41393144295",
+  "_spec": "@types/intercom-client",
+  "_where": "C:\\Users\\Pepin\\Documents\\projects\\cqrs",
+  "bundleDependencies": false,
+  "contributors": [
+    {
+      "name": "Jinesh Shah",
+      "url": "https://github.com/jineshshah36"
+    }
+  ],
+  "dependencies": {},
+  "deprecated": false,
+  "description": "TypeScript definitions for intercom-client",
+  "license": "MIT",
+  "main": "",
+  "name": "@types/intercom-client",
+  "repository": {
+    "type": "git",
+    "url": "https://www.github.com/DefinitelyTyped/DefinitelyTyped.git"
+  },
+  "scripts": {},
+  "typeScriptVersion": "2.0",
+  "typesPublisherContentHash": "c27ac6cbc719f43db3d968722e9976bfc2d2d1380f77dae007bf5d360ed1aa84",
+  "version": "2.9.0"
+}

From 11e09dbbd3d90df695feffb7cad4db37d21c249d Mon Sep 17 00:00:00 2001
From: Josef Hornych <hornych@engeto.com>
Date: Mon, 18 Jun 2018 12:44:39 +0200
Subject: [PATCH 167/180] deleted package.json, which was an artifact from
 node-modules

---
 types/intercom-client/package.json | 48 ------------------------------
 1 file changed, 48 deletions(-)
 delete mode 100644 types/intercom-client/package.json

diff --git a/types/intercom-client/package.json b/types/intercom-client/package.json
deleted file mode 100644
index 99ab47808b..0000000000
--- a/types/intercom-client/package.json
+++ /dev/null
@@ -1,48 +0,0 @@
-{
-  "_from": "@types/intercom-client",
-  "_id": "@types/intercom-client@2.9.0",
-  "_inBundle": false,
-  "_integrity": "sha512-BijYT7XATNJ4TOwj3OULC8FRt2OgGJ18wxV/M5Hjl4Ql7kXa/Mr0s0fgcuegn6SsmEqOg/CYCPEeUILzKXHR/g==",
-  "_location": "/@types/intercom-client",
-  "_phantomChildren": {},
-  "_requested": {
-    "type": "tag",
-    "registry": true,
-    "raw": "@types/intercom-client",
-    "name": "@types/intercom-client",
-    "escapedName": "@types%2fintercom-client",
-    "scope": "@types",
-    "rawSpec": "",
-    "saveSpec": null,
-    "fetchSpec": "latest"
-  },
-  "_requiredBy": [
-    "#DEV:/",
-    "#USER"
-  ],
-  "_resolved": "https://registry.npmjs.org/@types/intercom-client/-/intercom-client-2.9.0.tgz",
-  "_shasum": "7713308ace441835e687662bbf08d41393144295",
-  "_spec": "@types/intercom-client",
-  "_where": "C:\\Users\\Pepin\\Documents\\projects\\cqrs",
-  "bundleDependencies": false,
-  "contributors": [
-    {
-      "name": "Jinesh Shah",
-      "url": "https://github.com/jineshshah36"
-    }
-  ],
-  "dependencies": {},
-  "deprecated": false,
-  "description": "TypeScript definitions for intercom-client",
-  "license": "MIT",
-  "main": "",
-  "name": "@types/intercom-client",
-  "repository": {
-    "type": "git",
-    "url": "https://www.github.com/DefinitelyTyped/DefinitelyTyped.git"
-  },
-  "scripts": {},
-  "typeScriptVersion": "2.0",
-  "typesPublisherContentHash": "c27ac6cbc719f43db3d968722e9976bfc2d2d1380f77dae007bf5d360ed1aa84",
-  "version": "2.9.0"
-}

From 1b0c321c143f7553f942abf7d0b00c7df31f762f Mon Sep 17 00:00:00 2001
From: Josef Hornych <hornych@engeto.com>
Date: Mon, 18 Jun 2018 14:02:34 +0200
Subject: [PATCH 168/180] Fixed linter errors

---
 types/intercom-client/Scroll.d.ts |  3 ++
 types/intercom-client/User.d.ts   | 85 +++++++++++++++++++++++++++++++
 types/intercom-client/index.d.ts  | 35 ++++++++++++-
 3 files changed, 122 insertions(+), 1 deletion(-)
 create mode 100644 types/intercom-client/Scroll.d.ts
 create mode 100644 types/intercom-client/User.d.ts

diff --git a/types/intercom-client/Scroll.d.ts b/types/intercom-client/Scroll.d.ts
new file mode 100644
index 0000000000..2704a4cfbe
--- /dev/null
+++ b/types/intercom-client/Scroll.d.ts
@@ -0,0 +1,3 @@
+export declare class Scroll<T> {
+
+}
\ No newline at end of file
diff --git a/types/intercom-client/User.d.ts b/types/intercom-client/User.d.ts
new file mode 100644
index 0000000000..d67fd963d2
--- /dev/null
+++ b/types/intercom-client/User.d.ts
@@ -0,0 +1,85 @@
+import {Company} from "intercom-client";
+
+export type UserIdentifier = { "id": string } | { "user_id": string } | { "email": string }
+
+export interface Avatar {
+    "type": "avatar",
+    "image_url": string | null
+}
+
+export interface SocialProfile {
+    "name": "Twitter",
+    readonly "id": string,
+    "username": "th1sland",
+    "url": "http://twitter.com/th1sland"
+}
+
+export interface Segment {
+    readonly "id": string
+}
+
+export interface Tag {
+    readonly "id": string
+}
+
+export interface LocationData {
+    "type": "location_data",
+    "city_name": string | null,
+    "continent_code": string | null,
+    "country_code": string | null,
+    "country_name": string | null,
+    "latitude": number | null,
+    "longitude": number | null,
+    "postal_code": string | null,
+    "region_name": string | null,
+    "timezone": string | null
+}
+
+export interface User {
+    "type": "user" | "contact",
+    readonly "id": string,
+    "user_id": string | null,
+    "email": string | null,
+    "app_id"?: string,
+    "phone": string | null,
+    "name": string | null,
+    readonly "updated_at": number,
+    "last_seen_ip": string | null,
+    "unsubscribed_from_emails": boolean,
+    "last_request_at": number | null,
+    "signed_up_at": number | null,
+    readonly "created_at": number,
+    "session_count": number,
+    "user_agent_data": string | null,
+    "pseudonym": string | null,
+    "anonymous": boolean,
+    "custom_attributes": {
+        [key: string]: any
+    },
+    "avatar": Avatar,
+    "location_data": LocationData | {},
+    "social_profiles": {
+        "type": "social_profile.list",
+        "social_profiles": SocialProfile[]
+    },
+    "companies": {
+        "type": "company.list",
+        "companies": Company[]
+    },
+    "segments": {
+        "type": "segment.list",
+        "segments": Segment[]
+
+    },
+    "tags": {
+        "type": "tag.list",
+        "tags": Tag[]
+    }
+}
+
+export interface List {
+    "type": "user.list",
+    "total_count": number,
+    "users": User[],
+    "pages": { "next"?: string, "page": number, "per_page": number, "total_pages": number }
+}
\ No newline at end of file
diff --git a/types/intercom-client/index.d.ts b/types/intercom-client/index.d.ts
index b68dc87e71..f5699464b6 100644
--- a/types/intercom-client/index.d.ts
+++ b/types/intercom-client/index.d.ts
@@ -1,7 +1,11 @@
 // Type definitions for intercom-client 2.9
 // Project: https://github.com/intercom/intercom-node
-// Definitions by: Jinesh Shah <https://github.com/jineshshah36>
+// Definitions by: Jinesh Shah <https://github.com/jineshshah36>, Josef Hornych <https://github.com/peping>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.1
+
+import { List as UserList, User, UserIdentifier } from './User';
+import { Scroll } from './Scroll';
 
 export interface IdentityVerificationOptions {
     secretKey: string;
@@ -11,3 +15,32 @@ export interface IdentityVerificationOptions {
 export const IdentityVerification: {
     userHash(opts: IdentityVerificationOptions): string;
 };
+
+export class Client {
+    constructor(auth: { token: string } | { appId: string, appApiKey: string });
+    constructor(username: string, password: string);
+
+    users: Users;
+}
+
+export interface Company {
+    readonly "id": string;
+}
+
+export class Users {
+    create(user: Partial<User>): Promise<User>;
+
+    update(user: UserIdentifier & Partial<User>): Promise<User>;
+
+    find(identifier: UserIdentifier): Promise<User>;
+
+    list(): Promise<UserList>;
+
+    listBy(params: {tag_id: string, segment_id: string}): Promise<UserList>;
+
+    scroll: Scroll<User>;
+
+    archive(): Promise<User>;
+
+    requestPermanentDeletion(): Promise<{id: number}>;
+}

From 419d0ee0caa44299b123949def26aaa5f3c5991c Mon Sep 17 00:00:00 2001
From: Adrien Coffre <ext-adrien.coffre@here.com>
Date: Mon, 18 Jun 2018 14:39:14 +0200
Subject: [PATCH 169/180] Add enabled property to viewoffset object.

---
 types/three/three-core.d.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/types/three/three-core.d.ts b/types/three/three-core.d.ts
index 4a07a2318c..41bc354ace 100644
--- a/types/three/three-core.d.ts
+++ b/types/three/three-core.d.ts
@@ -490,6 +490,7 @@ export class OrthographicCamera extends Camera {
 
     zoom: number;
     view: {
+        enabled: boolean,
         fullWidth: number,
         fullHeight: number,
         offsetX: number,
@@ -579,6 +580,7 @@ export class PerspectiveCamera extends Camera {
 
     focus: number;
     view: {
+        enabled: boolean,
         fullWidth: number,
         fullHeight: number,
         offsetX: number,

From 0868c66683b11b7ebd879c1b1109f1db11defc9e Mon Sep 17 00:00:00 2001
From: Holger Jeromin <mailgithub@katur.de>
Date: Mon, 18 Jun 2018 14:43:51 +0200
Subject: [PATCH 170/180] fix build

---
 types/jquery/jquery-tests.ts | 24 ++++++------------------
 1 file changed, 6 insertions(+), 18 deletions(-)

diff --git a/types/jquery/jquery-tests.ts b/types/jquery/jquery-tests.ts
index ea14206f2e..0d80f56669 100644
--- a/types/jquery/jquery-tests.ts
+++ b/types/jquery/jquery-tests.ts
@@ -35,36 +35,24 @@ function JQueryStatic() {
 
         // $ExpectType JQuery<HTMLElement>
         $('<p></p>');
-        
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>('<p></p>');
-        
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>('<p></p>', document);
-        
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>('p');
-        
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>('p', document);        
 
         // $ExpectType JQuery<HTMLElement>
         $(new HTMLElement());
 
         // $ExpectType JQuery<HTMLElement>
         $([new HTMLElement()]);
-        
+
         // $ExpectType JQuery<HTMLElement>
         $(new HTMLParagraphElement());
-        
+
         // $ExpectType JQuery<HTMLElement>
         $([new HTMLParagraphElement()]);
-        
+
         // $ExpectType JQuery<HTMLParagraphElement>
         $<HTMLParagraphElement>(new HTMLParagraphElement());
-        
+
         // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>([new HTMLParagraphElement()]);        
+        $<HTMLParagraphElement>([new HTMLParagraphElement()]);
 
         // $ExpectType JQuery<{ foo: string; hello: string; }>
         $({ foo: 'bar', hello: 'world' });
@@ -94,7 +82,7 @@ function JQueryStatic() {
                 target;
             });
             let myDiv1 = $<HTMLDivElement>(document.createElement('div'));
-            
+
             let myForcedDiv: JQuery<HTMLDivElement> = $(document.createElement('div')) as any;
             myForcedDiv.on('click', (evt) => {
                 let target = evt.target; // HTMLDivElement

From 07b8c88db991885751b3ab846c4e90276f1099f6 Mon Sep 17 00:00:00 2001
From: Holger Jeromin <mailgithub@katur.de>
Date: Mon, 18 Jun 2018 14:49:44 +0200
Subject: [PATCH 171/180] removing type parameter inline

---
 types/jquery/jquery-tests.ts | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/types/jquery/jquery-tests.ts b/types/jquery/jquery-tests.ts
index 0d80f56669..a8b47cddd1 100644
--- a/types/jquery/jquery-tests.ts
+++ b/types/jquery/jquery-tests.ts
@@ -42,18 +42,6 @@ function JQueryStatic() {
         // $ExpectType JQuery<HTMLElement>
         $([new HTMLElement()]);
 
-        // $ExpectType JQuery<HTMLElement>
-        $(new HTMLParagraphElement());
-
-        // $ExpectType JQuery<HTMLElement>
-        $([new HTMLParagraphElement()]);
-
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>(new HTMLParagraphElement());
-
-        // $ExpectType JQuery<HTMLParagraphElement>
-        $<HTMLParagraphElement>([new HTMLParagraphElement()]);
-
         // $ExpectType JQuery<{ foo: string; hello: string; }>
         $({ foo: 'bar', hello: 'world' });
 

From fead5f449c99f08fe6185081095b07cd176745a7 Mon Sep 17 00:00:00 2001
From: khanhas <xuankhanh963@gmail.com>
Date: Mon, 18 Jun 2018 19:50:38 +0700
Subject: [PATCH 172/180] Fixed Picker props type

---
 types/proton-native/index.d.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/types/proton-native/index.d.ts b/types/proton-native/index.d.ts
index c3521ede1e..62aa0dce25 100644
--- a/types/proton-native/index.d.ts
+++ b/types/proton-native/index.d.ts
@@ -546,15 +546,15 @@ export interface PickerProps extends GridChildrenProps, Label, Stretchy {
     /**
      * When a *non-editable* Picker is changed. The current selection is passed as an argument.
      */
-    onSelect?: (selection: string) => void;
+    onSelect?: (selection: number) => void;
     /**
      * What element is selected if the picker *is not* editable.
      */
-    selected?: boolean;
+    selected?: number;
     /**
      * What text is selected/typed if the picker *is* editable.
      */
-    text?: boolean;
+    text?: string;
     /**
      * Whether the Picker can be seen.
      */

From 199cb191f9fd390bff8e1a21d29380c4a51adf6e Mon Sep 17 00:00:00 2001
From: Josef Hornych <hornych@engeto.com>
Date: Mon, 18 Jun 2018 15:25:14 +0200
Subject: [PATCH 173/180] remove files not present in previous version
 (LICENSE, README.md)

---
 types/intercom-client/LICENSE   | 21 ---------------------
 types/intercom-client/README.md | 16 ----------------
 2 files changed, 37 deletions(-)
 delete mode 100644 types/intercom-client/LICENSE
 delete mode 100644 types/intercom-client/README.md

diff --git a/types/intercom-client/LICENSE b/types/intercom-client/LICENSE
deleted file mode 100644
index 21071075c2..0000000000
--- a/types/intercom-client/LICENSE
+++ /dev/null
@@ -1,21 +0,0 @@
-    MIT License
-
-    Copyright (c) Microsoft Corporation. All rights reserved.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE
diff --git a/types/intercom-client/README.md b/types/intercom-client/README.md
deleted file mode 100644
index 481eebf5e4..0000000000
--- a/types/intercom-client/README.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Installation
-> `npm install --save @types/intercom-client`
-
-# Summary
-This package contains type definitions for intercom-client (https://github.com/intercom/intercom-node).
-
-# Details
-Files were exported from https://www.github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/intercom-client
-
-Additional Details
- * Last updated: Thu, 03 May 2018 15:33:57 GMT
- * Dependencies: none
- * Global values: none
-
-# Credits
-These definitions were written by Jinesh Shah <https://github.com/jineshshah36>, Josef Hornych <https://github.com/peping>.

From b25e9ab4b215d439d2a1480c2c2f20fd17ea63c9 Mon Sep 17 00:00:00 2001
From: Josef Hornych <hornych@engeto.com>
Date: Mon, 18 Jun 2018 15:44:34 +0200
Subject: [PATCH 174/180] Fix linter errors

---
 types/intercom-client/User.d.ts  |  6 ++---
 types/intercom-client/index.d.ts | 39 --------------------------------
 2 files changed, 3 insertions(+), 42 deletions(-)

diff --git a/types/intercom-client/User.d.ts b/types/intercom-client/User.d.ts
index d67fd963d2..880b8b5681 100644
--- a/types/intercom-client/User.d.ts
+++ b/types/intercom-client/User.d.ts
@@ -9,9 +9,9 @@ export interface Avatar {
 
 export interface SocialProfile {
     "name": "Twitter",
-    readonly "id": string,
-    "username": "th1sland",
-    "url": "http://twitter.com/th1sland"
+    readonly "id": string | null,
+    "username": string | null,
+    "url": string | null
 }
 
 export interface Segment {
diff --git a/types/intercom-client/index.d.ts b/types/intercom-client/index.d.ts
index 427089bc66..4d9e572da0 100644
--- a/types/intercom-client/index.d.ts
+++ b/types/intercom-client/index.d.ts
@@ -3,13 +3,9 @@
 // Definitions by: Jinesh Shah <https://github.com/jineshshah36>, Josef Hornych <https://github.com/peping>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.1
-
 import { List as UserList, User, UserIdentifier } from './User';
 import { Scroll } from './Scroll';
 
-import {List as UserList, User, UserIdentifier} from './User';
-import {Scroll} from './Scroll';
-
 export interface IdentityVerificationOptions {
     secretKey: string;
     identifier: string;
@@ -19,40 +15,6 @@ export const IdentityVerification: {
     userHash(opts: IdentityVerificationOptions): string;
 };
 
-<<<<<<< HEAD
-
-export declare class Client {
-    constructor(auth: { token: string });
-    constructor(username: string, password: string);
-    constructor(auth: { appId: string, appApiKey: string });
-    
-    users: Users;
-}
-
-
-interface Company {
-    readonly "id": string
-}
-
-
-declare class Users {
-    create(user: Partial<User>): Promise<User>
-
-    update(user: UserIdentifier & Partial<User> ): Promise<User>
-
-    find(identifier: UserIdentifier): Promise<User>
-
-    list(): Promise<UserList>
-
-    listBy(params: {tag_id: string, segment_id: string}): Promise<UserList>
-
-    scroll: Scroll<User>
-
-    archive(): Promise<User>
-
-    requestPermanentDeletion(): Promise<{id: number}>
-}
-=======
 export class Client {
     constructor(auth: { token: string } | { appId: string, appApiKey: string });
     constructor(username: string, password: string);
@@ -81,4 +43,3 @@ export class Users {
 
     requestPermanentDeletion(): Promise<{id: number}>;
 }
->>>>>>> tmp

From 85ebc14bef3f5cdf8b8d999c000076102e746ccb Mon Sep 17 00:00:00 2001
From: Xuefei Li <frankvsense@gmail.com>
Date: Mon, 18 Jun 2018 08:56:09 -0700
Subject: [PATCH 175/180] [memoize-one] Support ES6 import for TypeScript
 definition (#26467)

* Update index.d.ts

Support ES6.

* Update memoize-one-tests.ts
---
 types/memoize-one/index.d.ts           | 11 ++++-------
 types/memoize-one/memoize-one-tests.ts |  4 ++--
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/types/memoize-one/index.d.ts b/types/memoize-one/index.d.ts
index caac3a4429..71f785e73c 100644
--- a/types/memoize-one/index.d.ts
+++ b/types/memoize-one/index.d.ts
@@ -1,12 +1,9 @@
 // Type definitions for memoize-one 3.1
 // Project: https://github.com/alexreardon/memoize-one#readme
-// Definitions by: Karol Majewski <https://github.com/karol-majewski>
+// Definitions by: Karol Majewski <https://github.com/karol-majewski>, Frank Li <https://github.com/franklixuefei>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-export = memoizeOne;
+declare function memoizeOne<T extends (...args: any[]) => any>(resultFn: T, isEqual?: EqualityFn): T;
+export type EqualityFn = (a: any, b: any) => boolean;
 
-declare function memoizeOne<T extends (...args: any[]) => any>(resultFn: T, isEqual?: memoizeOne.EqualityFn): T;
-
-declare namespace memoizeOne {
-    type EqualityFn = (a: any, b: any) => boolean;
-}
+export default memoizeOne;
diff --git a/types/memoize-one/memoize-one-tests.ts b/types/memoize-one/memoize-one-tests.ts
index 7ab20ac891..4feddf6e57 100644
--- a/types/memoize-one/memoize-one-tests.ts
+++ b/types/memoize-one/memoize-one-tests.ts
@@ -1,4 +1,4 @@
-import memoizeOne = require('memoize-one');
+import memoizeOne, { EqualityFn } from 'memoize-one';
 
 declare function add(a: number, b: number): number ;
 declare function lousyEqualityFn(a: any, b: any): boolean;
@@ -30,4 +30,4 @@ memoizeOne(add, (a: string, b: string) => 0); // $ExpectError
 /**
  * The `EqualityFn` type is publicly accessible.
  */
-const simpleIsEqual: memoizeOne.EqualityFn = (x: number, y: number): boolean => (x === y);
+const simpleIsEqual: EqualityFn = (x: number, y: number): boolean => (x === y);

From 3177220fa4272a8c35ca658c8a250d44eb4ea01d Mon Sep 17 00:00:00 2001
From: Keith Kelly <k3ithk@gmail.com>
Date: Mon, 18 Jun 2018 12:22:12 -0400
Subject: [PATCH 176/180] Fixes typo so that input and output are both options
 in createPromptModule

---
 types/inquirer/index.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/inquirer/index.d.ts b/types/inquirer/index.d.ts
index 9f23ad21aa..d00c037c71 100644
--- a/types/inquirer/index.d.ts
+++ b/types/inquirer/index.d.ts
@@ -42,7 +42,7 @@ declare namespace inquirer {
          * Create a new self-contained prompt module.
          * @param opt Object specifying input and output streams for the prompt
          */
-        createPromptModule(opt?: OutputStreamOption): PromptModule;
+        createPromptModule(opt?: StreamOptions): PromptModule;
         /**
          * Public CLI helper interface
          * @param questions Questions settings array

From 48996f6e0bce1ee2855c1203d541a147f4e8d232 Mon Sep 17 00:00:00 2001
From: Jordan Van Walleghem <jordan@swapcard.com>
Date: Mon, 18 Jun 2018 18:43:19 +0200
Subject: [PATCH 177/180] Fixed mongodb typings implicit any error

---
 types/mongodb/index.d.ts    | 2 +-
 types/mongodb/tsconfig.json | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/mongodb/index.d.ts b/types/mongodb/index.d.ts
index 273a0716b2..8f8205799e 100644
--- a/types/mongodb/index.d.ts
+++ b/types/mongodb/index.d.ts
@@ -1252,7 +1252,7 @@ export class Cursor<T = Default> extends Readable {
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#limit */
     limit(value: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#map */
-    map<U>(transform: (T) => U): Cursor<U>;
+    map<U>(transform: (el: T) => U): Cursor<U>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#max */
     max(max: number): Cursor<T>;
     /** http://mongodb.github.io/node-mongodb-native/3.0/api/Cursor.html#maxAwaitTimeMS */
diff --git a/types/mongodb/tsconfig.json b/types/mongodb/tsconfig.json
index 8ed16ed7e6..aae592b3bd 100644
--- a/types/mongodb/tsconfig.json
+++ b/types/mongodb/tsconfig.json
@@ -4,7 +4,7 @@
         "lib": [
             "es6"
         ],
-        "noImplicitAny": false,
+        "noImplicitAny": true,
         "noImplicitThis": true,
         "strictNullChecks": false,
         "strictFunctionTypes": true,

From 36845ce063906870e4aaff4163b68a79f472012e Mon Sep 17 00:00:00 2001
From: Daniel Chao <daniel.h.chao@gmail.com>
Date: Mon, 18 Jun 2018 11:16:18 -0700
Subject: [PATCH 178/180] Remove useless leading dot slash in imports

---
 types/nodemailer/lib/sendmail-transport/index.d.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/types/nodemailer/lib/sendmail-transport/index.d.ts b/types/nodemailer/lib/sendmail-transport/index.d.ts
index c2f970519e..d1bc9b888b 100644
--- a/types/nodemailer/lib/sendmail-transport/index.d.ts
+++ b/types/nodemailer/lib/sendmail-transport/index.d.ts
@@ -2,11 +2,11 @@
 
 import { Transport, TransportOptions } from '../..';
 
-import * as shared from './../shared';
+import * as shared from '../shared';
 
-import Mail = require('./../mailer');
-import MailMessage = require('./../mailer/mail-message');
-import MimeNode = require('./../mime-node');
+import Mail = require('../mailer');
+import MailMessage = require('../mailer/mail-message');
+import MimeNode = require('../mime-node');
 
 declare namespace SendmailTransport {
     type MailOptions = Mail.Options;

From 8bdcc5620cae1f0f45101c0ccdf2a472478670da Mon Sep 17 00:00:00 2001
From: Alex Jerabek <aljerabe@microsoft.com>
Date: Mon, 18 Jun 2018 13:36:25 -0700
Subject: [PATCH 179/180] Merging with master and cleaning up link changes

---
 types/office-js/index.d.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 90cfa63a67..b084e4b2ca 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -11191,7 +11191,7 @@ declare namespace Office {
          * @param options Optional. Provides an option for preserving context data of any type, unchanged, for use in a callback.
          * @param callback Optional. When the method completes, the function passed in the callback parameter is called with a single parameter of type AsyncResult.
          */
-        addHandlerAsync(eventType: Office.EventType, handler: (type: Office.EventType) => void, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
+        addHandlerAsync(eventType: EventType, handler: (type: EventType) => void, options?: AsyncContextOptions, callback?: (result: AsyncResult) => void): void;
         /**
          * Converts an item ID formatted for REST into EWS format.
          *
@@ -11567,7 +11567,7 @@ declare namespace Office {
          */
         key?: string;
         /**
-         * Specifies the {@link Office.MailboxEnums.ItemNotificationMessageType} of message. If type is ProgressIndicator or ErrorMessage, an icon is automatically supplied and the message is not persistent. Therefore the icon and persistent properties are not valid for these types of messages. Including them will result in an ArgumentException. If type is ProgressIndicator, the developer should remove or replace the progress indicator when the action is complete.
+         * Specifies the ItemNotificationMessageType of message. If type is ProgressIndicator or ErrorMessage, an icon is automatically supplied and the message is not persistent. Therefore the icon and persistent properties are not valid for these types of messages. Including them will result in an ArgumentException. If type is ProgressIndicator, the developer should remove or replace the progress indicator when the action is complete.
          */
         type: Office.MailboxEnums.ItemNotificationMessageType;
         /**
@@ -11994,7 +11994,7 @@ declare namespace Office {
         /**
          * Gets a recipient list for an appointment or message.
          *
-         * When the call completes, the asyncResult.value property will contain an array of{@link Office. EmailAddressDetails} objects.
+         * When the call completes, the asyncResult.value property will contain an array of{@link Office.EmailAddressDetails} objects.
          *
          * [Api set: Mailbox 1.1]
          *
@@ -13080,7 +13080,7 @@ declare namespace OfficeExtension {
         pendingStatements: string[];
     }
 
-    /** An abstract {@link Office.RequestContext} object that facilitates requests to the host Office application. The `Excel.run and `Word.run` methods provide a request context. */
+    /** An abstract RequestContext object that facilitates requests to the host Office application. The `Excel.run and `Word.run` methods provide a request context. */
     class ClientRequestContext {
         constructor(url?: string);
 

From 031a3356f65a8f009e774bd112daf27552e28a68 Mon Sep 17 00:00:00 2001
From: Daniel <dcochran@netflix.com>
Date: Mon, 18 Jun 2018 14:19:52 -0700
Subject: [PATCH 180/180] add semicolon

---
 types/superagent/superagent-tests.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/superagent/superagent-tests.ts b/types/superagent/superagent-tests.ts
index b2e00c6698..0c4b51f31e 100644
--- a/types/superagent/superagent-tests.ts
+++ b/types/superagent/superagent-tests.ts
@@ -397,7 +397,7 @@ const echoPlugin = (request: request.SuperAgentRequest) => {
   req.url = '' + req.url;
   req.cookies = '' + req.cookies;
   if (req.method) {
-    req.url = '/echo'
+    req.url = '/echo';
   }
 };