From bbc6a27c0394914f331dd6457f81166448e04d60 Mon Sep 17 00:00:00 2001
From: Cameron Martin <cameronmartin123@gmail.com>
Date: Wed, 19 Dec 2018 21:49:05 +0000
Subject: [PATCH 01/61] [@babel/traverse]: Allowed node aliases as keys in
 visitors.

This is made possible by https://github.com/babel/babel/pull/9110.

When the next version after v7.2.2 is released, the package.json can be updated and the build will no longer fail.
---
 types/babel__traverse/babel__traverse-tests.ts | 5 +++++
 types/babel__traverse/index.d.ts               | 2 ++
 2 files changed, 7 insertions(+)

diff --git a/types/babel__traverse/babel__traverse-tests.ts b/types/babel__traverse/babel__traverse-tests.ts
index 70f8c5f0b6..98a0338021 100644
--- a/types/babel__traverse/babel__traverse-tests.ts
+++ b/types/babel__traverse/babel__traverse-tests.ts
@@ -150,3 +150,8 @@ const VisitorStateTest: Visitor<SomeVisitorState> = {
         }
     }
 };
+
+const VisitorAliasTest: Visitor = {
+    Function() {},
+    Expression() {},
+};
diff --git a/types/babel__traverse/index.d.ts b/types/babel__traverse/index.d.ts
index 89e242129b..fe817d5daf 100644
--- a/types/babel__traverse/index.d.ts
+++ b/types/babel__traverse/index.d.ts
@@ -145,6 +145,8 @@ export class Binding {
 
 export type Visitor<S = {}> = VisitNodeObject<S, Node> & {
     [Type in Node["type"]]?: VisitNode<S, Extract<Node, { type: Type; }>>;
+} & {
+    [K in keyof t.Aliases]?: VisitNode<S, t.Aliases[K]>
 };
 
 export type VisitNode<S, P> = VisitNodeFunction<S, P> | VisitNodeObject<S, P>;

From a57f667049a912095a0d11490ee6bcb5a5ed97af Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Tue, 8 Jan 2019 23:18:16 +0000
Subject: [PATCH 02/61] Allow dynamic CSS values based on component props

---
 types/react-jss/lib/injectSheet.d.ts | 50 +++++++++++++++++-----------
 1 file changed, 30 insertions(+), 20 deletions(-)

diff --git a/types/react-jss/lib/injectSheet.d.ts b/types/react-jss/lib/injectSheet.d.ts
index fd66af5c38..be3bee933b 100644
--- a/types/react-jss/lib/injectSheet.d.ts
+++ b/types/react-jss/lib/injectSheet.d.ts
@@ -53,26 +53,35 @@ export type PropsOf<C> = C extends new (props: infer P) => React.Component
  */
 export type PropInjector<InjectedProps, AdditionalProps = {}> = <
   C extends React.ComponentType<ConsistentWith<PropsOf<C>, InjectedProps>>
->(
+  >(
   component: C
 ) => React.ComponentType<
   Omit<JSX.LibraryManagedAttributes<C, PropsOf<C>>, keyof InjectedProps> &
-    AdditionalProps
->;
+  AdditionalProps
+  >;
 
-export interface CSSProperties extends CSS.Properties<number | string> {
+type cssNumberOrString = CSS.Properties<number | string>
+
+// Allow functions that take the properties of the component and return a CSS value
+export type CssRule<Props> = {
+  [K in keyof cssNumberOrString]:
+  | (cssNumberOrString[K])
+  | ((props: Props) => cssNumberOrString[K])
+}[keyof CSS.Properties]
+
+export interface CSSProperties<Props> {
   // Allow pseudo selectors and media queries
   [k: string]:
-    | CSS.Properties<number | string>[keyof CSS.Properties]
-    | CSSProperties;
+    | CssRule<Props>
+    | CSSProperties<Props>;
 }
-export type Styles<ClassKey extends string = string> = Record<
+export type Styles<ClassKey extends string = string, Props = {}> = Record<
   ClassKey,
-  CSSProperties
->;
-export type StyleCreator<C extends string = string, T extends {} = {}> = (
+  CSSProperties<Props>
+  >;
+export type StyleCreator<C extends string = string, T extends {} = {}, Props = {}> = (
   theme: T
-) => Styles<C>;
+) => Styles<C, Props>;
 
 export interface Theming {
   channel: string;
@@ -89,15 +98,16 @@ export interface InjectOptions extends CreateStyleSheetOptions {
 export type ClassNameMap<C extends string> = Record<C, string>;
 export type WithSheet<
   S extends string | Styles | StyleCreator<string, any>,
-  GivenTheme = undefined
-> = {
+  GivenTheme = undefined,
+  Props = {}
+  > = {
   classes: ClassNameMap<
     S extends string
       ? S
-      : S extends StyleCreator<infer C, any>
-        ? C
-        : S extends Styles<infer C> ? C : never
-  >;
+      : S extends StyleCreator<infer C, any, Props>
+      ? C
+      : S extends Styles<infer C, Props> ? C : never
+    >;
 } & WithTheme<S extends StyleCreator<string, infer T> ? T : GivenTheme>;
 
 export interface WithTheme<T> {
@@ -110,7 +120,7 @@ export interface StyledComponentProps<ClassKey extends string = string> {
   innerRef?: React.Ref<any> | React.RefObject<any>;
 }
 
-export default function injectSheet<C extends string, T extends object>(
-  stylesOrCreator: Styles<C> | StyleCreator<C, T>,
+export default function injectSheet<C extends string, T extends object, Props = {}>(
+  stylesOrCreator: Styles<C, Props> | StyleCreator<C, T, Props>,
   options?: InjectOptions
-): PropInjector<WithSheet<C, T>, StyledComponentProps<C>>;
+): PropInjector<WithSheet<C, T, Props>, StyledComponentProps<C>>;

From 6f2624fb38349499664984ca14893f72f9c4e461 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Tue, 8 Jan 2019 23:31:16 +0000
Subject: [PATCH 03/61] Add attribution, fix linter errors

---
 types/react-jss/index.d.ts           |  1 +
 types/react-jss/lib/injectSheet.d.ts | 10 ++++------
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/types/react-jss/index.d.ts b/types/react-jss/index.d.ts
index 7656897a08..c2ee0a008a 100644
--- a/types/react-jss/index.d.ts
+++ b/types/react-jss/index.d.ts
@@ -1,6 +1,7 @@
 // Type definitions for react-jss 8.6
 // Project: https://github.com/cssinjs/react-jss#readme
 // Definitions by: Sebastian Silbermann <https://github.com/eps1lon>
+//                 James Lawrence <https://github.com/jlaw90>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 import { createGenerateClassName, JSS, SheetsRegistry } from "jss";
diff --git a/types/react-jss/lib/injectSheet.d.ts b/types/react-jss/lib/injectSheet.d.ts
index be3bee933b..5aa3b0925b 100644
--- a/types/react-jss/lib/injectSheet.d.ts
+++ b/types/react-jss/lib/injectSheet.d.ts
@@ -60,14 +60,12 @@ export type PropInjector<InjectedProps, AdditionalProps = {}> = <
   AdditionalProps
   >;
 
-type cssNumberOrString = CSS.Properties<number | string>
-
 // Allow functions that take the properties of the component and return a CSS value
 export type CssRule<Props> = {
-  [K in keyof cssNumberOrString]:
-  | (cssNumberOrString[K])
-  | ((props: Props) => cssNumberOrString[K])
-}[keyof CSS.Properties]
+  [K in keyof CSS.Properties<number | string>]:
+  | (CSS.Properties<number | string>[K])
+  | ((props: Props) => CSS.Properties<number | string>[K])
+}[keyof CSS.Properties];
 
 export interface CSSProperties<Props> {
   // Allow pseudo selectors and media queries

From 6eb77511162839e409a5dbaeff533006b655a312 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Thu, 10 Jan 2019 01:05:38 +0000
Subject: [PATCH 04/61] Rename to DynamicCSSRule

---
 types/react-jss/lib/injectSheet.d.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/types/react-jss/lib/injectSheet.d.ts b/types/react-jss/lib/injectSheet.d.ts
index 5aa3b0925b..ef6bdb3dbb 100644
--- a/types/react-jss/lib/injectSheet.d.ts
+++ b/types/react-jss/lib/injectSheet.d.ts
@@ -61,16 +61,16 @@ export type PropInjector<InjectedProps, AdditionalProps = {}> = <
   >;
 
 // Allow functions that take the properties of the component and return a CSS value
-export type CssRule<Props> = {
+export type DynamicCSSRule<Props> = {
   [K in keyof CSS.Properties<number | string>]:
-  | (CSS.Properties<number | string>[K])
+  | CSS.Properties<number | string>[K]
   | ((props: Props) => CSS.Properties<number | string>[K])
 }[keyof CSS.Properties];
 
 export interface CSSProperties<Props> {
   // Allow pseudo selectors and media queries
   [k: string]:
-    | CssRule<Props>
+    | DynamicCSSRule<Props>
     | CSSProperties<Props>;
 }
 export type Styles<ClassKey extends string = string, Props = {}> = Record<

From 3180fea53f4827c599e89369d613b33d4e167048 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Thu, 10 Jan 2019 01:06:44 +0000
Subject: [PATCH 05/61] Update tests - had to disable strict function checking,
 if anyone knows how to make it work with this, please do!

---
 types/react-jss/react-jss-tests.tsx | 59 ++++++++++++++++-------------
 types/react-jss/tsconfig.json       |  2 +-
 2 files changed, 33 insertions(+), 28 deletions(-)

diff --git a/types/react-jss/react-jss-tests.tsx b/types/react-jss/react-jss-tests.tsx
index 803170bb99..6e86bed492 100644
--- a/types/react-jss/react-jss-tests.tsx
+++ b/types/react-jss/react-jss-tests.tsx
@@ -17,42 +17,44 @@ interface MyTheme {
 /**
  * helper function to counter typescripts type widening
  */
-function createStyles<C extends string>(styles: Styles<C>): Styles<C> {
+function createStyles<Props = {}, C extends string = string>(styles: Styles<C, Props>): Styles<C, Props> {
   return styles;
 }
 
-const styles = (theme: MyTheme) =>
-  createStyles({
-    myButton: {
-      color: theme.color.primary,
-      margin: 1,
-      "& span": {
-        fontWeight: "revert"
-      }
-    },
-    myLabel: {
-      fontStyle: "italic"
-    }
-  });
 
-interface ButtonProps extends WithSheet<typeof styles> {
+interface ButtonProps {
   label: string;
+  active?: boolean;
 }
 
-const Button: React.SFC<ButtonProps> = ({ classes, children }) => {
+const styles = (theme: MyTheme) => createStyles({
+  myButton: {
+    color: (props: ButtonProps) => props.active ? 'red': theme.color.primary,
+    margin: 1,
+    "& span": {
+      fontWeight: "revert"
+    }
+  },
+  myLabel: {
+    fontStyle: "italic"
+  }
+});
+const Button: React.SFC<ButtonProps & WithSheet<typeof styles>> = ({active, classes, children}) => {
   return (
-    <button className={classes.myButton}>
-      <span className={classes.myLabel}>{children}</span>
-    </button>
+    <>
+      <button className={classes.myButton}>
+        <span className={classes.myLabel}>{children}</span>
+      </button>
+    </>
   );
 };
 
 const ManuallyStyles = () => {
   return (
     <Button
-      classes={{ myButton: "my-button", myLabel: "my-label" }}
+      classes={{myButton: "my-button", myLabel: "my-label"}}
       label="Hello, World!"
-      theme={{ color: { primary: "red", secondary: "blue" } }}
+      theme={{color: {primary: "red", secondary: "blue"}}}
     />
   );
 };
@@ -67,7 +69,10 @@ const darkTheme: MyTheme = {
 };
 const App = () => (
   <ThemeProvider theme={darkTheme}>
-    <StyledButton label="I'm dark" />
+    <>
+      <StyledButton label="I'm dark"/>
+      <StyledButton label="I'm active" active/>
+    </>
   </ThemeProvider>
 );
 
@@ -77,7 +82,7 @@ function ssrRender(req: any, res: { send: (text: string) => any }) {
 
   const body = mockedRenderToString(
     <JssProvider classNamePrefix="dt-" registry={sheets}>
-      <StyledButton label="I come from the server" />
+      <StyledButton label="I come from the server"/>
     </JssProvider>
   );
 
@@ -87,10 +92,10 @@ function ssrRender(req: any, res: { send: (text: string) => any }) {
   return res.send(
     mockedRenderToString(
       <html>
-        <head>
-          <style type="text/css">{sheets.toString()}</style>
-        </head>
-        <body>{body}</body>
+      <head>
+        <style type="text/css">{sheets.toString()}</style>
+      </head>
+      <body>{body}</body>
       </html>
     )
   );
diff --git a/types/react-jss/tsconfig.json b/types/react-jss/tsconfig.json
index 161f1a346c..bd1b3e736c 100644
--- a/types/react-jss/tsconfig.json
+++ b/types/react-jss/tsconfig.json
@@ -15,7 +15,7 @@
         "noEmit": true,
         "forceConsistentCasingInFileNames": true,
         "jsx": "react",
-        "strictFunctionTypes": true
+        "strictFunctionTypes": false
     },
     "files": [
         "index.d.ts",

From e81b769a344d0b62d881379dead57d601c011d09 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Thu, 10 Jan 2019 01:17:09 +0000
Subject: [PATCH 06/61] Oops, fix linting...

---
 types/react-jss/react-jss-tests.tsx | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/types/react-jss/react-jss-tests.tsx b/types/react-jss/react-jss-tests.tsx
index 6e86bed492..9e2bf9a376 100644
--- a/types/react-jss/react-jss-tests.tsx
+++ b/types/react-jss/react-jss-tests.tsx
@@ -21,7 +21,6 @@ function createStyles<Props = {}, C extends string = string>(styles: Styles<C, P
   return styles;
 }
 
-
 interface ButtonProps {
   label: string;
   active?: boolean;
@@ -29,7 +28,7 @@ interface ButtonProps {
 
 const styles = (theme: MyTheme) => createStyles({
   myButton: {
-    color: (props: ButtonProps) => props.active ? 'red': theme.color.primary,
+    color: (props: ButtonProps) => props.active ? 'red' : theme.color.primary,
     margin: 1,
     "& span": {
       fontWeight: "revert"

From 35548ef37d949a980819b97fd5136f7783b91003 Mon Sep 17 00:00:00 2001
From: David Lechner <david@lechnology.com>
Date: Fri, 18 Jan 2019 23:46:23 -0600
Subject: [PATCH 07/61] [ssh2-streams] Add missing optional mode property to
 TransferOptions

Comes from: https://github.com/mscdex/ssh2-streams/blob/master/SFTPStream.md#sftpstream-methods
---
 types/ssh2-streams/index.d.ts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/types/ssh2-streams/index.d.ts b/types/ssh2-streams/index.d.ts
index df1e001e0a..690145ec17 100644
--- a/types/ssh2-streams/index.d.ts
+++ b/types/ssh2-streams/index.d.ts
@@ -1628,6 +1628,11 @@ export interface TransferOptions {
      * Called every time a part of a file was transferred
      */
     step?: (total_transferred: number, chunk: number, total: number) => void;
+    
+    /**
+     * Integer or string representing the file mode to set for the uploaded file.
+     */
+    mode?: number | string;
 }
 
 export interface ReadStreamOptions {
@@ -1703,4 +1708,4 @@ export interface ParsedKey {
 export interface ReadFileOptions {
     encoding?: string;
     flag?: string;
-}
\ No newline at end of file
+}

From 833f1e3214bc93876e6112eafac9ddf8c6095271 Mon Sep 17 00:00:00 2001
From: Dimitri Benin <dimitri.benin@gmail.com>
Date: Mon, 21 Jan 2019 00:12:24 +0100
Subject: [PATCH 08/61] [diff] move v3 to sub-dir

---
 types/diff/{ => v3}/diff-tests.ts |  0
 types/diff/{ => v3}/index.d.ts    |  0
 types/diff/{ => v3}/tsconfig.json | 11 ++++++++---
 types/diff/{ => v3}/tslint.json   |  0
 4 files changed, 8 insertions(+), 3 deletions(-)
 rename types/diff/{ => v3}/diff-tests.ts (100%)
 rename types/diff/{ => v3}/index.d.ts (100%)
 rename types/diff/{ => v3}/tsconfig.json (76%)
 rename types/diff/{ => v3}/tslint.json (100%)

diff --git a/types/diff/diff-tests.ts b/types/diff/v3/diff-tests.ts
similarity index 100%
rename from types/diff/diff-tests.ts
rename to types/diff/v3/diff-tests.ts
diff --git a/types/diff/index.d.ts b/types/diff/v3/index.d.ts
similarity index 100%
rename from types/diff/index.d.ts
rename to types/diff/v3/index.d.ts
diff --git a/types/diff/tsconfig.json b/types/diff/v3/tsconfig.json
similarity index 76%
rename from types/diff/tsconfig.json
rename to types/diff/v3/tsconfig.json
index 9a1fdba840..92e1861ec8 100644
--- a/types/diff/tsconfig.json
+++ b/types/diff/v3/tsconfig.json
@@ -9,10 +9,15 @@
         "noImplicitThis": true,
         "strictNullChecks": false,
         "strictFunctionTypes": true,
-        "baseUrl": "../",
+        "baseUrl": "../../",
         "typeRoots": [
-            "../"
+            "../../"
         ],
+        "paths": {
+            "diff": [
+                "diff/v3"
+            ]
+        },
         "types": [],
         "noEmit": true,
         "forceConsistentCasingInFileNames": true
@@ -21,4 +26,4 @@
         "index.d.ts",
         "diff-tests.ts"
     ]
-}
\ No newline at end of file
+}
diff --git a/types/diff/tslint.json b/types/diff/v3/tslint.json
similarity index 100%
rename from types/diff/tslint.json
rename to types/diff/v3/tslint.json

From a33191a1c65d50c6ba016f45a18a17126c864d21 Mon Sep 17 00:00:00 2001
From: Dimitri Benin <dimitri.benin@gmail.com>
Date: Mon, 21 Jan 2019 01:07:45 +0100
Subject: [PATCH 09/61] [diff] Add types for v4

---
 types/diff/diff-tests.ts | 121 ++++++++++++
 types/diff/index.d.ts    | 402 +++++++++++++++++++++++++++++++++++++++
 types/diff/tsconfig.json |  23 +++
 types/diff/tslint.json   |   1 +
 4 files changed, 547 insertions(+)
 create mode 100644 types/diff/diff-tests.ts
 create mode 100644 types/diff/index.d.ts
 create mode 100644 types/diff/tsconfig.json
 create mode 100644 types/diff/tslint.json

diff --git a/types/diff/diff-tests.ts b/types/diff/diff-tests.ts
new file mode 100644
index 0000000000..845b307132
--- /dev/null
+++ b/types/diff/diff-tests.ts
@@ -0,0 +1,121 @@
+import * as diff from 'diff';
+
+const one = 'beep boop';
+const other = 'beep boob blah';
+
+let changes = diff.diffChars(one, other);
+examineChanges(changes);
+
+// $ExpectType void
+diff.diffChars(one, other, {
+    callback: (err, value) => {
+        err; // $ExpectType undefined
+        value; // $ExpectType Change[] | undefined
+    },
+});
+// $ExpectType void
+diff.diffChars(one, other, (err, value) => {
+    err; // $ExpectType undefined
+    value; // $ExpectType Change[] | undefined
+});
+
+const diffArraysResult = diff.diffArrays(['a', 'b', 'c'], ['a', 'c', 'd']);
+diffArraysResult.forEach(result => {
+    result.added; // $ExpectType boolean | undefined
+    result.removed; // $ExpectType boolean | undefined
+    result.value; // $ExpectType string[]
+    result.count; // $ExpectType number | undefined
+});
+
+interface DiffObj {
+    value: number;
+}
+const a: DiffObj = { value: 0 };
+const b: DiffObj = { value: 1 };
+const c: DiffObj = { value: 2 };
+const d: DiffObj = { value: 3 };
+const arrayOptions: diff.ArrayOptions<DiffObj, DiffObj> = {
+    comparator: (left, right) => {
+        return left.value === right.value;
+    },
+};
+const arrayChanges = diff.diffArrays([a, b, c], [a, b, d], arrayOptions);
+arrayChanges.forEach(result => {
+    result.added; // $ExpectType boolean | undefined
+    result.removed; // $ExpectType boolean | undefined
+    result.value; // $ExpectType DiffObj[]
+    result.count; // $ExpectType number | undefined
+});
+
+// --------------------------
+
+class LineDiffWithoutWhitespace extends diff.Diff {
+    tokenize(value: string): any {
+        return value.split(/^/m);
+    }
+
+    equals(left: string, right: string): boolean {
+        return left.trim() === right.trim();
+    }
+}
+
+const obj = new LineDiffWithoutWhitespace();
+changes = obj.diff(one, other);
+examineChanges(changes);
+
+function examineChanges(diff: diff.Change[]) {
+    diff.forEach(part => {
+        part.added; // $ExpectType boolean | undefined
+        part.removed; // $ExpectType boolean | undefined
+        part.value; // $ExpectType string
+        part.count; // $ExpectType number | undefined
+    });
+}
+
+function verifyPatchMethods(oldStr: string, newStr: string, uniDiff: diff.ParsedDiff) {
+    const verifyPatch = diff.parsePatch(
+        diff.createTwoFilesPatch('oldFile.ts', 'newFile.ts', oldStr, newStr, 'old', 'new', {
+            context: 1,
+        })
+    );
+
+    if (
+        JSON.stringify(verifyPatch[0], Object.keys(verifyPatch[0]).sort()) !==
+        JSON.stringify(uniDiff, Object.keys(uniDiff).sort())
+    ) {
+        throw new Error('Patch did not match uniDiff');
+    }
+}
+function verifyApplyMethods(oldStr: string, newStr: string, uniDiff: diff.ParsedDiff) {
+    const verifyApply = [diff.applyPatch(oldStr, uniDiff), diff.applyPatch(oldStr, [uniDiff])];
+    diff.applyPatches([uniDiff], {
+        loadFile: (index, callback) => {
+            index; // $ExpectType ParsedDiff
+            callback(undefined, one);
+        },
+        patched: (index, content) => {
+            index; // $ExpectType ParsedDiff
+            verifyApply.push(content);
+        },
+        complete: (err?: Error) => {
+            if (err) {
+                throw err;
+            }
+
+            verifyApply.forEach(result => {
+                if (result !== newStr) {
+                    throw new Error('Result did not match newStr');
+                }
+            });
+        },
+    });
+}
+
+const uniDiffPatch = diff.structuredPatch('oldFile.ts', 'newFile.ts', one, other, 'old', 'new', {
+    context: 1,
+});
+verifyPatchMethods(one, other, uniDiffPatch);
+
+const uniDiffStr = diff.createPatch('file.ts', one, other, 'old', 'new', { context: 1 });
+const uniDiffApply = diff.parsePatch(uniDiffStr)[0];
+verifyApplyMethods(one, other, uniDiffApply);
diff --git a/types/diff/index.d.ts b/types/diff/index.d.ts
new file mode 100644
index 0000000000..fa0e4e2e3d
--- /dev/null
+++ b/types/diff/index.d.ts
@@ -0,0 +1,402 @@
+// Type definitions for diff 4.0
+// Project: https://github.com/kpdecker/jsdiff
+// Definitions by: vvakame <https://github.com/vvakame>
+//                 szdc <https://github.com/szdc>
+//                 moc-yuto <https://github.com/moc-yuto>
+//                 BendingBender <https://github.com/BendingBender>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.2
+
+export as namespace Diff;
+
+export type Callback = (err: undefined, value?: Change[]) => void;
+
+export interface CallbackOptions {
+    /**
+     * Callback to call with the result instead of returning the result directly.
+     */
+    callback: Callback;
+}
+
+export interface BaseOptions {
+    /**
+     * `true` to ignore casing difference.
+     * @default false
+     */
+    ignoreCase?: boolean;
+}
+
+export interface WordsOptions extends BaseOptions {
+    /**
+     * `true` to ignore leading and trailing whitespace. This is the same as `diffWords()`.
+     */
+    ignoreWhitespace?: boolean;
+}
+
+export interface LinesOptions extends BaseOptions {
+    /**
+     * `true` to ignore leading and trailing whitespace. This is the same as `diffTrimmedLines()`.
+     */
+    ignoreWhitespace?: boolean;
+
+    /**
+     * `true` to treat newline characters as separate tokens. This allows for changes to the newline structure
+     * to occur independently of the line content and to be treated as such. In general this is the more
+     * human friendly form of `diffLines()` and `diffLines()` is better suited for patches and other computer
+     * friendly output.
+     */
+    newlineIsToken?: boolean;
+}
+
+export interface JsonOptions extends LinesOptions {
+    /**
+     * Replacer used to stringify the properties of the passed objects.
+     */
+    stringifyReplacer?: (key: string, value: any) => any;
+
+    /**
+     * The value to use when `undefined` values in the passed objects are encountered during stringification.
+     * Will only be used if `stringifyReplacer` option wasn't specified.
+     * @default undefined
+     */
+    undefinedReplacement?: any;
+}
+
+export interface ArrayOptions<TLeft, TRight> extends BaseOptions {
+    /**
+     * Comparator for custom equality checks.
+     */
+    comparator?: (left: TLeft, right: TRight) => boolean;
+}
+
+export interface PatchOptions extends LinesOptions {
+    /**
+     * Describes how many lines of context should be included.
+     * @default 4
+     */
+    context?: number;
+}
+
+export interface ApplyPatchOptions {
+    /**
+     * Number of lines that are allowed to differ before rejecting a patch.
+     * @default 0
+     */
+    fuzzFactor?: number;
+
+    /**
+     * Callback used to compare to given lines to determine if they should be considered equal when patching.
+     * Should return `false` if the lines should be rejected.
+     *
+     * @default strict equality
+     */
+    compareLine?: (
+        lineNumber: number,
+        line: string,
+        operation: '-' | ' ',
+        patchContent: string
+    ) => boolean;
+}
+
+export interface ApplyPatchesOptions {
+    loadFile(index: ParsedDiff, callback: (err: any, data: string) => void): void;
+    patched(index: ParsedDiff, content: string, callback: (err: any) => void): void;
+    complete(err: any): void;
+}
+
+export interface Change {
+    count?: number;
+    /**
+     * Text content.
+     */
+    value: string;
+    /**
+     * `true` if the value was inserted into the new string.
+     */
+    added?: boolean;
+    /**
+     * `true` if the value was removed from the old string.
+     */
+    removed?: boolean;
+}
+
+export interface ArrayChange<T> {
+    value: T[];
+    count?: number;
+    added?: boolean;
+    removed?: boolean;
+}
+
+export interface ParsedDiff {
+    index?: string;
+    oldFileName?: string;
+    newFileName?: string;
+    oldHeader?: string;
+    newHeader?: string;
+    hunks: Hunk[];
+}
+
+export interface Hunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+}
+
+export interface BestPath {
+    newPos: number;
+    componenets: Change[];
+}
+
+export class Diff {
+    diff(
+        oldString: string,
+        newString: string,
+        options?: Callback | (ArrayOptions<any, any> & Partial<CallbackOptions>)
+    ): Change[];
+
+    pushComponent(components: Change[], added: boolean, removed: boolean): void;
+
+    extractCommon(
+        basePath: BestPath,
+        newString: string,
+        oldString: string,
+        diagonalPath: number
+    ): number;
+
+    equals(left: any, right: any): boolean;
+
+    removeEmpty(array: any[]): any[];
+
+    castInput(value: any): any;
+
+    join(chars: string[]): string;
+
+    tokenize(value: string): any; // return types are string or string[]
+}
+
+/**
+ * Diffs two blocks of text, comparing character by character.
+ *
+ * @returns A list of change objects.
+ */
+export function diffChars(oldStr: string, newStr: string, options?: BaseOptions): Change[];
+export function diffChars(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (BaseOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing word by word, ignoring whitespace.
+ *
+ * @returns A list of change objects.
+ */
+export function diffWords(oldStr: string, newStr: string, options?: WordsOptions): Change[];
+export function diffWords(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (WordsOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing word by word, treating whitespace as significant.
+ *
+ * @returns A list of change objects.
+ */
+export function diffWordsWithSpace(
+    oldStr: string,
+    newStr: string,
+    options?: WordsOptions
+): Change[];
+export function diffWordsWithSpace(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (WordsOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing line by line.
+ *
+ * @returns A list of change objects.
+ */
+export function diffLines(oldStr: string, newStr: string, options?: LinesOptions): Change[];
+export function diffLines(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (LinesOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing line by line, ignoring leading and trailing whitespace.
+ *
+ * @returns A list of change objects.
+ */
+export function diffTrimmedLines(oldStr: string, newStr: string, options?: LinesOptions): Change[];
+export function diffTrimmedLines(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (LinesOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing sentence by sentence.
+ *
+ * @returns A list of change objects.
+ */
+export function diffSentences(oldStr: string, newStr: string, options?: BaseOptions): Change[];
+export function diffSentences(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (BaseOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two blocks of text, comparing CSS tokens.
+ *
+ * @returns A list of change objects.
+ */
+export function diffCss(oldStr: string, newStr: string, options?: BaseOptions): Change[];
+export function diffCss(
+    oldStr: string,
+    newStr: string,
+    options: Callback | (BaseOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two JSON objects, comparing the fields defined on each. The order of fields, etc does not matter
+ * in this comparison.
+ *
+ * @returns A list of change objects.
+ */
+export function diffJson(
+    oldObj: string | object,
+    newObj: string | object,
+    options?: JsonOptions
+): Change[];
+export function diffJson(
+    oldObj: string | object,
+    newObj: string | object,
+    options: Callback | (JsonOptions & CallbackOptions)
+): void;
+
+/**
+ * Diffs two arrays, comparing each item for strict equality (`===`).
+ *
+ * @returns A list of change objects.
+ */
+export function diffArrays<TOld, TNew>(
+    oldArr: TOld[],
+    newArr: TNew[],
+    options?: ArrayOptions<TOld, TNew>
+): Array<ArrayChange<TOld | TNew>>;
+
+/**
+ * Creates a unified diff patch.
+ *
+ * @param oldFileName String to be output in the filename section of the patch for the removals.
+ * @param newFileName String to be output in the filename section of the patch for the additions.
+ * @param oldStr Original string value.
+ * @param newStr New string value.
+ * @param oldHeader Additional information to include in the old file header.
+ * @param newHeader Additional information to include in the new file header.
+ */
+export function createTwoFilesPatch(
+    oldFileName: string,
+    newFileName: string,
+    oldStr: string,
+    newStr: string,
+    oldHeader?: string,
+    newHeader?: string,
+    options?: PatchOptions
+): string;
+
+/**
+ * Creates a unified diff patch.
+ * Just like `createTwoFilesPatch()`, but with `oldFileName` being equal to `newFileName`.
+ *
+ * @param fileName String to be output in the filename section.
+ * @param oldStr Original string value.
+ * @param newStr New string value.
+ * @param oldHeader Additional information to include in the old file header.
+ * @param newHeader Additional information to include in the new file header.
+ */
+export function createPatch(
+    fileName: string,
+    oldStr: string,
+    newStr: string,
+    oldHeader?: string,
+    newHeader?: string,
+    options?: PatchOptions
+): string;
+
+/**
+ * This method is similar to `createTwoFilesPatch()`, but returns a data structure suitable for further processing.
+ * Parameters are the same as `createTwoFilesPatch()`.
+ *
+ * @param oldFileName String to be output in the `oldFileName` hunk property.
+ * @param newFileName String to be output in the `newFileName` hunk property.
+ * @param oldStr Original string value.
+ * @param newStr New string value.
+ * @param oldHeader Additional information to include in the `oldHeader` hunk property.
+ * @param newHeader Additional information to include in the `newHeader` hunk property.
+ * @returns An object with an array of hunk objects.
+ */
+export function structuredPatch(
+    oldFileName: string,
+    newFileName: string,
+    oldStr: string,
+    newStr: string,
+    oldHeader?: string,
+    newHeader?: string,
+    options?: PatchOptions
+): ParsedDiff;
+
+/**
+ * Applies a unified diff patch.
+ *
+ * @param patch May be a string diff or the output from the `parsePatch()` or `structuredPatch()` methods.
+ * @returns A string containing new version of provided data.
+ */
+export function applyPatch(
+    source: string,
+    patch: string | ParsedDiff | [ParsedDiff],
+    options?: ApplyPatchOptions
+): string;
+
+/**
+ * Applies one or more patches.
+ * This method will iterate over the contents of the patch and apply to data provided through callbacks.
+ *
+ * The general flow for each patch index is:
+ *
+ * 1. `options.loadFile(index, callback)` is called. The caller should then load the contents of the file
+ * and then pass that to the `callback(err, data)` callback. Passing an `err` will terminate further patch execution.
+ * 2. `options.patched(index, content, callback)` is called once the patch has been applied. `content` will be
+ * the return value from `applyPatch()`. When it's ready, the caller should call `callback(err)` callback.
+ * Passing an `err` will terminate further patch execution.
+ * 3. Once all patches have been applied or an error occurs, the `options.complete(err)` callback is made.
+ */
+export function applyPatches(patch: string | ParsedDiff[], options: ApplyPatchesOptions): void;
+
+/**
+ * Parses a patch into structured data.
+ *
+ * @returns A JSON object representation of the a patch, suitable for use with the `applyPatch()` method.
+ */
+export function parsePatch(diffStr: string, options?: { strict?: boolean }): ParsedDiff[];
+
+/**
+ * Converts a list of changes to a serialized XML format.
+ */
+export function convertChangesToXML(changes: Change[]): string;
+
+/**
+ * Converts a list of changes to [DMP](http://code.google.com/p/google-diff-match-patch/wiki/API) format.
+ */
+export function convertChangesToDMP(changes: Change[]): Array<[1 | 0 | -1, string]>;
+
+export function merge(mine: string, theirs: string, base: string): ParsedDiff;
+
+export function canonicalize(obj: any, stack: any[], replacementStack: any[]): any;
diff --git a/types/diff/tsconfig.json b/types/diff/tsconfig.json
new file mode 100644
index 0000000000..b32089d091
--- /dev/null
+++ b/types/diff/tsconfig.json
@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "diff-tests.ts"
+    ]
+}
diff --git a/types/diff/tslint.json b/types/diff/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/diff/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From 3182b6a95d66bc377b5baf91a2140ce22441cad7 Mon Sep 17 00:00:00 2001
From: rhysd <lin90162@yahoo.co.jp>
Date: Tue, 22 Jan 2019 12:53:18 +0900
Subject: [PATCH 10/61] [obelisk.js] obelisk.js now can be imported as module

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

diff --git a/types/obelisk.js/index.d.ts b/types/obelisk.js/index.d.ts
index 2e4cf8bc3d..68e91d53b7 100644
--- a/types/obelisk.js/index.d.ts
+++ b/types/obelisk.js/index.d.ts
@@ -1,8 +1,9 @@
-// Type definitions for obelisk.js v1.1.0
+// Type definitions for obelisk.js v1.2.1
 // Project: https://github.com/nosir/obelisk.js/
 // Definitions by: Brian Drupieski <https://github.com/bdrupieski>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
+export = obelisk;
 declare namespace obelisk {
 
     export var version: string;
diff --git a/types/obelisk.js/obelisk.js-tests.ts b/types/obelisk.js/obelisk.js-tests.ts
index e47b474467..c0f931f042 100644
--- a/types/obelisk.js/obelisk.js-tests.ts
+++ b/types/obelisk.js/obelisk.js-tests.ts
@@ -1,3 +1,5 @@
+import * as obelisk from 'obelisk.js';
+
 function test_brick() {
     var canvas = <HTMLCanvasElement>document.getElementById('canvas-demo');
 
@@ -143,4 +145,4 @@ function test_gif_rendering() {
     var floorDimension = new obelisk.CubeDimension((size - 2) * (WIDTH + 2), (size - 2) * 9, size);
     var floor = new obelisk.Cube(floorDimension, new obelisk.CubeColor(), false);
     pixelViewFloor.renderObject(floor, new obelisk.Point3D(-20, -30, 0));
-}
\ No newline at end of file
+}

From f3bd3b816376cc8a152c5247e8fc82602d53edc3 Mon Sep 17 00:00:00 2001
From: Cameron Martin <cameronmartin123@gmail.com>
Date: Tue, 22 Jan 2019 22:34:24 +0000
Subject: [PATCH 11/61] Updated babel types version.

---
 types/babel__traverse/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/babel__traverse/package.json b/types/babel__traverse/package.json
index 2442a952db..47a2d3dc48 100644
--- a/types/babel__traverse/package.json
+++ b/types/babel__traverse/package.json
@@ -1,6 +1,6 @@
 {
     "private": true,
     "dependencies": {
-        "@babel/types": "^7.0.0"
+        "@babel/types": "^7.3.0"
     }
 }

From af36b578212f32d74acf45d1b1c8d8d855b293ec Mon Sep 17 00:00:00 2001
From: Josias Iquabius <iquabius@gmail.com>
Date: Tue, 22 Jan 2019 21:53:30 -0300
Subject: [PATCH 12/61] Add support for state types in Next.js' App component

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

diff --git a/types/next/app.d.ts b/types/next/app.d.ts
index 392b997f89..3e933c09c6 100644
--- a/types/next/app.d.ts
+++ b/types/next/app.d.ts
@@ -53,6 +53,6 @@ export type AppComponentType<P = {}, IP = P, C = NextAppContext> = NextComponent
 >;
 
 export class Container extends React.Component {}
-export default class App<P = {}> extends React.Component<P & DefaultAppIProps & AppProps> {
+export default class App<P = {}, S = {}> extends React.Component<P & DefaultAppIProps & AppProps, S> {
     static getInitialProps(context: NextAppContext): Promise<DefaultAppIProps>;
 }

From ae2e67ec402419a7e67f0cbdd6c45068a6b8c2ee Mon Sep 17 00:00:00 2001
From: rhysd <lin90162@yahoo.co.jp>
Date: Wed, 23 Jan 2019 11:33:21 +0900
Subject: [PATCH 13/61] [obelisk.js] Lines support added at v1.2.1

---
 types/obelisk.js/index.d.ts          | 28 ++++++++++++++++++++++++++++
 types/obelisk.js/obelisk.js-tests.ts | 27 +++++++++++++++++++++++++++
 2 files changed, 55 insertions(+)

diff --git a/types/obelisk.js/index.d.ts b/types/obelisk.js/index.d.ts
index 68e91d53b7..91c481d198 100644
--- a/types/obelisk.js/index.d.ts
+++ b/types/obelisk.js/index.d.ts
@@ -112,6 +112,10 @@ declare namespace obelisk {
         getByHorizontalColor(horizontal: number): SlopeColor;
     }
 
+    export class LineColor extends AbstractColor {
+        constructor(border?: number, inner?: number);
+    }
+
     export class AbstractDimension {
         constructor();
 
@@ -145,6 +149,18 @@ declare namespace obelisk {
         constructor(xAxis?: number, yAxis?: number);
     }
 
+    export class LineXDimension extends AbstractDimension {
+        constructor(axis?: number);
+    }
+
+    export class LineYDimension extends AbstractDimension {
+        constructor(axis?: number);
+    }
+
+    export class LineZDimension extends AbstractDimension {
+        constructor(axis?: number);
+    }
+
     export class BitmapData {
         constructor(w: number, h: number, useDefaultCanvas?: boolean);
 
@@ -226,4 +242,16 @@ declare namespace obelisk {
     export class SlopeWest extends AbstractPrimitive {
         constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
     }
+
+    export class LineX extends AbstractPrimitive {
+        constructor(dimension?: LineXDimension, color?: LineColor, useDefaultCanvas?: boolean);
+    }
+
+    export class LineY extends AbstractPrimitive {
+        constructor(dimension?: LineYDimension, color?: LineColor, useDefaultCanvas?: boolean);
+    }
+
+    export class LineZ extends AbstractPrimitive {
+        constructor(dimension?: LineZDimension, color?: LineColor, useDefaultCanvas?: boolean);
+    }
 }
diff --git a/types/obelisk.js/obelisk.js-tests.ts b/types/obelisk.js/obelisk.js-tests.ts
index c0f931f042..4cc4328409 100644
--- a/types/obelisk.js/obelisk.js-tests.ts
+++ b/types/obelisk.js/obelisk.js-tests.ts
@@ -146,3 +146,30 @@ function test_gif_rendering() {
     var floor = new obelisk.Cube(floorDimension, new obelisk.CubeColor(), false);
     pixelViewFloor.renderObject(floor, new obelisk.Point3D(-20, -30, 0));
 }
+
+function test_line_rendering() {
+    var canvas = document.getElementById('canvas-demo') as HTMLCanvasElement;
+
+    // create pixel view container in point
+    var point = new obelisk.Point(400, 200);
+    var pixelView = new obelisk.PixelView(canvas, point);
+
+    // create brick
+    var colorX = new obelisk.LineColor(obelisk.ColorPattern.PINK);
+    var colorY = new obelisk.LineColor(obelisk.ColorPattern.BLACK);
+    var colorZ = new obelisk.LineColor(obelisk.ColorPattern.BLUE);
+
+    var dimensionX = new obelisk.LineXDimension(100);
+    var dimensionY = new obelisk.LineYDimension(100);
+    var dimensionZ = new obelisk.LineZDimension(100);
+
+    var lineX = new obelisk.LineX(dimensionX, colorX);
+    var lineY = new obelisk.LineY(dimensionY, colorY);
+    var lineZ = new obelisk.LineZ(dimensionZ, colorZ);
+
+    // render in view
+    var p3D = new obelisk.Point3D(0, 0, 0);
+    pixelView.renderObject(lineX, p3D);
+    pixelView.renderObject(lineY, p3D);
+    pixelView.renderObject(lineZ, p3D);
+}

From 353ca607b47960fa772ab68463961993a95bac6d Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Wed, 23 Jan 2019 17:11:49 +0100
Subject: [PATCH 14/61] Handle ComponentType

---
 types/enzyme/index.d.ts | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/types/enzyme/index.d.ts b/types/enzyme/index.d.ts
index 0818b4e5ce..58e5938a8f 100644
--- a/types/enzyme/index.d.ts
+++ b/types/enzyme/index.d.ts
@@ -27,7 +27,9 @@ export interface ComponentClass<Props> {
     new(props: Props, context?: any): Component<Props>;
 }
 
-export type StatelessComponent<Props> = (props: Props, context?: any) => JSX.Element;
+export type StatelessComponent<Props> = (props: Props, context?: any) => JSX.Element | null;
+
+export type ComponentType<Props> = ComponentClass<Props> | StatelessComponent<Props>;
 
 /**
  * Many methods in Enzyme's API accept a selector as an argument. Selectors in Enzyme can fall into one of the
@@ -372,8 +374,8 @@ export class ShallowWrapper<P = {}, S = {}, C = Component> {
      * Find every node in the render tree that matches the provided selector.
      * @param selector The selector to match.
      */
-    find<P2>(component: ComponentClass<P2>): ShallowWrapper<P2, any>;
     find<P2>(statelessComponent: StatelessComponent<P2>): ShallowWrapper<P2, never>;
+    find<P2>(component: ComponentType<P2>): ShallowWrapper<P2, any>;
     find(props: EnzymePropSelector): ShallowWrapper<any, any>;
     find(selector: string): ShallowWrapper<HTMLAttributes, any>;
 
@@ -381,8 +383,8 @@ export class ShallowWrapper<P = {}, S = {}, C = Component> {
      * Removes nodes in the current wrapper that do not match the provided selector.
      * @param selector The selector to match.
      */
-    filter<P2>(component: ComponentClass<P2>): ShallowWrapper<P2, any>;
     filter<P2>(statelessComponent: StatelessComponent<P2>): ShallowWrapper<P2, never>;
+    filter<P2>(component: ComponentType<P2>): ShallowWrapper<P2, any>;
     filter(props: EnzymePropSelector | string): ShallowWrapper<P, S>;
 
     /**
@@ -394,8 +396,8 @@ export class ShallowWrapper<P = {}, S = {}, C = Component> {
      * Returns a new wrapper with all of the children of the node(s) in the current wrapper. Optionally, a selector
      * can be provided and it will filter the children by this selector.
      */
-    children<P2>(component: ComponentClass<P2>): ShallowWrapper<P2, any>;
     children<P2>(statelessComponent: StatelessComponent<P2>): ShallowWrapper<P2, never>;
+    children<P2>(component: ComponentType<P2>): ShallowWrapper<P2, any>;
     children(selector: string): ShallowWrapper<HTMLAttributes, any>;
     children(props?: EnzymePropSelector): ShallowWrapper<any, any>;
 
@@ -425,8 +427,8 @@ export class ShallowWrapper<P = {}, S = {}, C = Component> {
      *
      * Note: can only be called on a wrapper of a single node.
      */
-    parents<P2>(component: ComponentClass<P2>): ShallowWrapper<P2, any>;
     parents<P2>(statelessComponent: StatelessComponent<P2>): ShallowWrapper<P2, never>;
+    parents<P2>(component: ComponentType<P2>): ShallowWrapper<P2, any>;
     parents(selector: string): ShallowWrapper<HTMLAttributes, any>;
     parents(props?: EnzymePropSelector): ShallowWrapper<any, any>;
 
@@ -436,8 +438,8 @@ export class ShallowWrapper<P = {}, S = {}, C = Component> {
      *
      * Note: can only be called on a wrapper of a single node.
      */
-    closest<P2>(component: ComponentClass<P2>): ShallowWrapper<P2, any>;
     closest<P2>(statelessComponent: StatelessComponent<P2>): ShallowWrapper<P2, never>;
+    closest<P2>(component: ComponentType<P2>): ShallowWrapper<P2, any>;
     closest(props: EnzymePropSelector): ShallowWrapper<any, any>;
     closest(selector: string): ShallowWrapper<HTMLAttributes, any>;
 
@@ -487,8 +489,8 @@ export class ReactWrapper<P = {}, S = {}, C = Component> {
      * Find every node in the render tree that matches the provided selector.
      * @param selector The selector to match.
      */
-    find<P2>(component: ComponentClass<P2>): ReactWrapper<P2, any>;
     find<P2>(statelessComponent: StatelessComponent<P2>): ReactWrapper<P2, never>;
+    find<P2>(component: ComponentType<P2>): ReactWrapper<P2, any>;
     find(props: EnzymePropSelector): ReactWrapper<any, any>;
     find(selector: string): ReactWrapper<HTMLAttributes, any>;
 
@@ -501,16 +503,16 @@ export class ReactWrapper<P = {}, S = {}, C = Component> {
      * Removes nodes in the current wrapper that do not match the provided selector.
      * @param selector The selector to match.
      */
-    filter<P2>(component: ComponentClass<P2>): ReactWrapper<P2, any>;
     filter<P2>(statelessComponent: StatelessComponent<P2>): ReactWrapper<P2, never>;
+    filter<P2>(component: ComponentType<P2>): ReactWrapper<P2, any>;
     filter(props: EnzymePropSelector | string): ReactWrapper<P, S>;
 
     /**
      * Returns a new wrapper with all of the children of the node(s) in the current wrapper. Optionally, a selector
      * can be provided and it will filter the children by this selector.
      */
-    children<P2>(component: ComponentClass<P2>): ReactWrapper<P2, any>;
     children<P2>(statelessComponent: StatelessComponent<P2>): ReactWrapper<P2, never>;
+    children<P2>(component: ComponentType<P2>): ReactWrapper<P2, any>;
     children(selector: string): ReactWrapper<HTMLAttributes, any>;
     children(props?: EnzymePropSelector): ReactWrapper<any, any>;
 
@@ -526,8 +528,8 @@ export class ReactWrapper<P = {}, S = {}, C = Component> {
      *
      * Note: can only be called on a wrapper of a single node.
      */
-    parents<P2>(component: ComponentClass<P2>): ReactWrapper<P2, any>;
     parents<P2>(statelessComponent: StatelessComponent<P2>): ReactWrapper<P2, never>;
+    parents<P2>(component: ComponentType<P2>): ReactWrapper<P2, any>;
     parents(selector: string): ReactWrapper<HTMLAttributes, any>;
     parents(props?: EnzymePropSelector): ReactWrapper<any, any>;
 
@@ -537,8 +539,8 @@ export class ReactWrapper<P = {}, S = {}, C = Component> {
      *
      * Note: can only be called on a wrapper of a single node.
      */
-    closest<P2>(component: ComponentClass<P2>): ReactWrapper<P2, any>;
     closest<P2>(statelessComponent: StatelessComponent<P2>): ReactWrapper<P2, never>;
+    closest<P2>(component: ComponentType<P2>): ReactWrapper<P2, any>;
     closest(props: EnzymePropSelector): ReactWrapper<any, any>;
     closest(selector: string): ReactWrapper<HTMLAttributes, any>;
 

From e92ff96b548a1056de14b2a1f1f905f9826abbc9 Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Fri, 25 Jan 2019 10:18:29 +0100
Subject: [PATCH 15/61] Add tests

---
 types/enzyme/enzyme-tests.tsx | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/types/enzyme/enzyme-tests.tsx b/types/enzyme/enzyme-tests.tsx
index 0711243d0c..879f06dc3c 100644
--- a/types/enzyme/enzyme-tests.tsx
+++ b/types/enzyme/enzyme-tests.tsx
@@ -35,6 +35,10 @@ interface MyComponentState {
     stateProperty: string;
 }
 
+function toComponentType<T>(Component: ComponentClass<T> | StatelessComponent<T>): ComponentClass<T> | StatelessComponent<T> {
+  return Component;
+}
+
 class MyComponent extends Component<MyComponentProps, MyComponentState> {
     handleEcho(value: string) {
         return value;
@@ -59,6 +63,8 @@ const MyStatelessComponent = (props: StatelessProps) => <span />;
 
 const AnotherStatelessComponent = (props: AnotherStatelessProps) => <span />;
 
+const ComponentType = toComponentType(MyComponent);
+
 // Enzyme.configure
 function configureTest() {
     const configureAdapter: { adapter: EnzymeAdapter } = { adapter: {} };
@@ -859,6 +865,14 @@ function ReactWrapperTest() {
         reactWrapper = new ReactWrapper<MyComponentProps, MyComponentState>(<MyComponent stringProp="1" numberProp={1} />, undefined, { attachTo: document.createElement('div') });
         reactWrapper = new ReactWrapper<MyComponentProps, MyComponentState>(<MyComponent stringProp="1" numberProp={1} />, reactWrapper, { attachTo: document.createElement('div') });
     }
+
+    function test_component_type() {
+      const wrapper1 = shallow(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
+      wrapper1.find(ComponentType);
+
+      const wrapper2 = mount(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
+      wrapper2.find(ComponentType);
+    }
 }
 
 // CheerioWrapper

From f486782118baf4c29ba2b4c31ecd7f69623291be Mon Sep 17 00:00:00 2001
From: Hinaser <rindo.hinase@gmail.com>
Date: Fri, 25 Jan 2019 18:48:31 +0900
Subject: [PATCH 16/61] [uuidv4] Add types

---
 types/uuidv4/index.d.ts      | 34 ++++++++++++++++++++++++++++++++++
 types/uuidv4/tsconfig.json   | 23 +++++++++++++++++++++++
 types/uuidv4/tslint.json     |  1 +
 types/uuidv4/uuidv4-tests.ts | 13 +++++++++++++
 4 files changed, 71 insertions(+)
 create mode 100644 types/uuidv4/index.d.ts
 create mode 100644 types/uuidv4/tsconfig.json
 create mode 100644 types/uuidv4/tslint.json
 create mode 100644 types/uuidv4/uuidv4-tests.ts

diff --git a/types/uuidv4/index.d.ts b/types/uuidv4/index.d.ts
new file mode 100644
index 0000000000..e181a39244
--- /dev/null
+++ b/types/uuidv4/index.d.ts
@@ -0,0 +1,34 @@
+// Type definitions for uuidv4 2.0
+// Project: https://github.com/thenativeweb/uuidv4#readme
+// Definitions by: Rindo Hinase <https://github.com/Hinaser>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+declare const uuidv4: UUIDv4;
+
+interface UUIDv4_is {
+    (value: string): boolean;
+}
+
+type EmptyUUIDv4 = '00000000-0000-0000-0000-000000000000';
+
+interface UUIDv4_empty {
+    (): string;
+}
+
+interface UUIDv4_FromString {
+    (text: string): string;
+}
+
+interface UUIDv4 {
+    (): string;
+    is: UUIDv4_is;
+    empty: UUIDv4_empty;
+    fromString: UUIDv4_FromString;
+}
+
+// If you read this because linter warns you like '... has no default export'
+// please try to write import statement like
+//     import * as uuidv4 from 'uuidv4'
+// rather than
+//     import uuidv4 from 'uuidv4'
+export = uuidv4;
diff --git a/types/uuidv4/tsconfig.json b/types/uuidv4/tsconfig.json
new file mode 100644
index 0000000000..4ae973d9cb
--- /dev/null
+++ b/types/uuidv4/tsconfig.json
@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "strictFunctionTypes": true,
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "uuidv4-tests.ts"
+    ]
+}
diff --git a/types/uuidv4/tslint.json b/types/uuidv4/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/uuidv4/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }
diff --git a/types/uuidv4/uuidv4-tests.ts b/types/uuidv4/uuidv4-tests.ts
new file mode 100644
index 0000000000..0c5f915d95
--- /dev/null
+++ b/types/uuidv4/uuidv4-tests.ts
@@ -0,0 +1,13 @@
+import * as uuidv4 from 'uuidv4'; // uuidv4 is () => string
+
+// $ExpectType string
+uuidv4();
+
+// $ExpectType string
+uuidv4.empty();
+
+// $ExpectType boolean
+uuidv4.is('00000000-0000-0000-0000-000000000000');
+
+// $ExpectType string
+uuidv4.fromString("test");

From b5284de385714315acebd92edfe089538f592129 Mon Sep 17 00:00:00 2001
From: Ifiok Jr <ifiokotung@gmail.com>
Date: Fri, 7 Dec 2018 00:15:52 +0000
Subject: [PATCH 17/61] add typings for @google-cloud/tasks

---
 .../google-cloud__tasks-tests.ts              |   18 +
 types/google-cloud__tasks/index.d.ts          | 1633 +++++++++++++++++
 types/google-cloud__tasks/package.json        |   14 +
 .../ts3.1/google-cloud__tasks-tests.ts        |   21 +
 types/google-cloud__tasks/ts3.1/index.d.ts    | 1622 ++++++++++++++++
 types/google-cloud__tasks/ts3.1/tsconfig.json |   19 +
 types/google-cloud__tasks/ts3.1/tslint.json   |    1 +
 types/google-cloud__tasks/tsconfig.json       |   19 +
 types/google-cloud__tasks/tslint.json         |    1 +
 9 files changed, 3348 insertions(+)
 create mode 100644 types/google-cloud__tasks/google-cloud__tasks-tests.ts
 create mode 100644 types/google-cloud__tasks/index.d.ts
 create mode 100644 types/google-cloud__tasks/package.json
 create mode 100644 types/google-cloud__tasks/ts3.1/google-cloud__tasks-tests.ts
 create mode 100644 types/google-cloud__tasks/ts3.1/index.d.ts
 create mode 100644 types/google-cloud__tasks/ts3.1/tsconfig.json
 create mode 100644 types/google-cloud__tasks/ts3.1/tslint.json
 create mode 100644 types/google-cloud__tasks/tsconfig.json
 create mode 100644 types/google-cloud__tasks/tslint.json

diff --git a/types/google-cloud__tasks/google-cloud__tasks-tests.ts b/types/google-cloud__tasks/google-cloud__tasks-tests.ts
new file mode 100644
index 0000000000..4539f345ff
--- /dev/null
+++ b/types/google-cloud__tasks/google-cloud__tasks-tests.ts
@@ -0,0 +1,18 @@
+import Tasks, { Queue } from "@google-cloud/tasks";
+
+const client = new Tasks({});
+
+const formattedParent = client.locationPath("[PROJECT]", "[LOCATION]");
+const queue: Partial<Queue> = {};
+const request = {
+  parent: formattedParent,
+  queue
+};
+client
+  .createQueue(request)
+  .then(([queue]) => {
+    const q = queue;
+  })
+  .catch(err => {
+    console.error(err);
+  });
diff --git a/types/google-cloud__tasks/index.d.ts b/types/google-cloud__tasks/index.d.ts
new file mode 100644
index 0000000000..b7c2099f68
--- /dev/null
+++ b/types/google-cloud__tasks/index.d.ts
@@ -0,0 +1,1633 @@
+// Type definitions for @google-cloud/tasks 0.2
+// Project: https://github.com/googleapis/nodejs-tasks (Does not have to be to GitHub, but prefer linking to a source code repository rather than to a project website.)
+// Definitions by: Ifiok Jr. <https://github.com/ifiokjr>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+// TypeScript Version: 2.8
+
+/// <reference types="node" />
+
+// import * as gax from "google-gax";
+import { Transform } from "stream";
+// import { GoogleAuthOptions, GoogleError, CallOptions, GoogleAuth } from "google-gax";
+export type GoogleError = any;
+export type GoogleAuthOptions = any;
+export type CallOptions = any;
+export type GoogleAuth = any;
+
+export interface CloudTasksConfig extends GoogleAuthOptions {
+  key?: string;
+  autoRetry?: boolean;
+  maxRetries?: number;
+  libName?: string;
+  libVersion?: string;
+  promise?: PromiseConstructor;
+}
+
+export interface AppEngineHttpQueue {
+  appEngineRoutingOverride: AppEngineRouting;
+}
+
+export interface AppEngineHttpRequest {
+  appEngineRouting: AppEngineRouting;
+  body: string;
+  headers: {
+    [key: string]: string;
+  };
+  httpMethod: string;
+  relativeUri: string;
+}
+
+export interface AppEngineRouting {
+  host: string;
+  instance: string;
+  service: string;
+  version: string;
+}
+
+export interface Attempt {
+  dispatchTime: string;
+  responseStatus: Status;
+  responseTime: string;
+  scheduleTime: string;
+}
+
+export interface Binding {
+  condition: Expr;
+  members: string[];
+  role: string;
+}
+
+export interface CreateTaskRequest {
+  responseView: View;
+  task: Partial<Task>;
+}
+
+export interface Expr {
+  description: string;
+  expression: string;
+  location: string;
+  title: string;
+}
+
+export interface ListLocationsResponse {
+  locations: Location[];
+  nextPageToken?: string;
+}
+
+export interface ListQueuesResponse {
+  nextPageToken?: string;
+  queues: Queue[];
+}
+
+export interface ListTasksResponse {
+  nextPageToken?: string;
+  tasks: Task[];
+}
+
+export interface Location {
+  displayName: string;
+  labels: {
+    [key: string]: string;
+  };
+  locationId: string;
+  metadata: {
+    [key: string]: any;
+  };
+  name: string;
+}
+
+export interface Policy {
+  bindings: Binding[];
+  etag: string;
+  version: number;
+}
+
+export interface Queue {
+  appEngineHttpQueue: AppEngineHttpQueue;
+  name: string;
+  purgeTime: string;
+  rateLimits: RateLimits;
+  retryConfig: RetryConfig;
+  state: string;
+}
+
+export interface RateLimits {
+  maxBurstSize: number;
+  maxConcurrentDispatches: number;
+  maxDispatchesPerSecond: number;
+}
+
+export interface RetryConfig {
+  maxAttempts: number;
+  maxBackoff: string;
+  maxDoublings: number;
+  maxRetryDuration: string;
+  minBackoff: string;
+}
+
+export interface RunTaskRequest {
+  responseView?: View;
+}
+
+export interface SetIamPolicyRequest {
+  policy: Partial<Policy>;
+}
+
+export interface Status {
+  code: number;
+  details: Array<{
+    [key: string]: any;
+  }>;
+  message: string;
+}
+
+/**
+ * `VIEW_UNSPECIFIED = 0;`
+ * When Unspecified. Defaults to the behaviour of BASIC.
+ *
+ * `BASIC = 1;`
+ * The basic view omits fields which can be large or can contain
+ * sensitive data.
+ * This view does not include the
+ * ([payload in AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] and
+ * [payload in PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These payloads are
+ * desirable to return only when needed, because they can be large
+ * and because of the sensitivity of the data that you choose to
+ * store in it.
+ *
+ * `FULL = 2;`
+ * All information is returned.
+ *
+ * Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+ * `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+ * permission on the [Queue][google.cloud.tasks.v2beta2.Queue] resource.
+ */
+export type View = 0 | 1 | 2;
+
+export interface Task {
+  appEngineHttpRequest: AppEngineHttpRequest;
+  createTime: string;
+  dispatchCount: number;
+  firstAttempt: Attempt;
+  lastAttempt: Attempt;
+  name: string;
+  responseCount: number;
+  scheduleTime: string;
+  view: View;
+}
+
+export interface TestIamPermissionsRequest {
+  permissions?: string[];
+}
+
+export interface TestIamPermissionsResponse {
+  permissions?: string[];
+}
+
+export interface PromiseLike<T> extends Promise<T> {
+  /**
+   * Cancel the ongoing promise
+   */
+  cancel(): void;
+}
+
+export type Keys<T> = keyof T;
+
+export type EnhancedPick<
+  T,
+  Req extends keyof T,
+  Opt extends keyof T
+> = Required<Pick<T, Req>> & Partial<Pick<T, Req>>;
+
+export type ProjectIdCallback = (
+  err?: Error | null,
+  projectId?: string | null
+) => void;
+
+export type APICallback<T = any> = (
+  err: GoogleError | null,
+  response?: T
+) => void;
+
+export type APIPaginatedCallback<T = any, U = any, V = any> = (
+  err: GoogleError | null,
+  response?: T,
+  next?: U | null,
+  rawResponse?: V
+) => void;
+
+export interface CallOptionsWithPagination extends CallOptions {
+  autoPaginate: false;
+}
+
+export interface MethodOverload<T, R> {
+  (data: T, options?: CallOptions): PromiseLike<[R]>;
+  (data: T, options: CallOptions, callback: APICallback<R>): void;
+  (data: T, callback: APICallback<R>): void;
+}
+
+export interface PaginatedMethodOverload<T, R, U, V = T> {
+  (data: T, options: CallOptionsWithPagination): PromiseLike<[R, V, U]>;
+  (data: T, options?: CallOptions): PromiseLike<[R]>;
+  (data: T, options: CallOptions, callback: APICallback<R>): void;
+  (
+    data: T,
+    options: CallOptionsWithPagination,
+    callback: APIPaginatedCallback<R, V, U>
+  ): void;
+  (data: T, callback: APICallback<R>): void;
+}
+
+export interface ParentRequest {
+  /**
+   * The location name. For example: projects/PROJECT_ID/locations/LOCATION_ID
+   */
+  parent: string;
+}
+
+export interface ResourceRequest {
+  /**
+   * The resource for which the policy is being requested. resource is usually specified as a path. For example, a Project resource is specified as projects/{project}.
+   */
+  resource: string;
+}
+
+export interface ListRequestObject extends ParentRequest {
+  /**
+   * `filter` can be used to specify a subset of queues. Any Queue field can be used as a filter and several operators as supported.
+   * For example: <=, <, >=, >, !=, =, :. The filter syntax is the same as described in Stackdriver's Advanced Logs Filters.
+   * Sample filter "state: PAUSED".
+   * Note that using filters might cause fewer queues than the requested page_size to be returned.
+   */
+  filter?: string;
+
+  /**
+   * The maximum number of resources contained in the underlying API response. If page streaming is performed per-resource,
+   * this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page.
+   */
+  pageSize?: number;
+}
+
+export interface NamedRequest {
+  /**
+   * The resource name of the queue. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
+   */
+  name: string;
+}
+
+export type CreateNamedRequest<N extends string, T> = ParentRequest &
+  { [P in N]: T };
+export type UpdateNamedRequest<N extends string, T> = ParentRequest &
+  { [P in N]: T };
+
+/**
+ * Cloud Tasks allows developers to manage the execution of background
+ * work in their applications.
+ */
+export default class CloudTasksClient {
+  /**
+   * The DNS address for this API service.
+   * @default 'cloudtasks.googleapis.com'
+   */
+  static readonly servicePath: string;
+
+  /**
+   * The port for this API service.
+   * @default 443
+   */
+  static readonly port: number;
+
+  /**
+   * The scopes needed to make gRPC calls for every method defined
+   * in this service.
+   * @default ["https://www.googleapis.com/auth/cloud-platform"]
+   */
+  static readonlyscopes: string;
+
+  auth: GoogleAuth;
+
+  /**
+   * Construct an instance of CloudTasksClient.
+   *
+   * @param [options] - The configuration object. See the subsequent
+   *   parameters for more details.
+   * @param [options.credentials] - Credentials object.
+   * @param [options.credentials.client_email]
+   * @param [options.credentials.private_key]
+   * @param [options.email] - Account email address. Required when
+   *     using a .pem or .p12 keyFilename.
+   * @param [options.keyFilename] - Full path to the a .json, .pem, or
+   *     .p12 key downloaded from the Google Developers Console. If you provide
+   *     a path to a JSON file, the projectId option below is not necessary.
+   *     NOTE: .pem and .p12 require you to specify options.email as well.
+   * @param [options.port] - The port on which to connect to
+   *     the remote host.
+   * @param [options.projectId] - The project ID from the Google
+   *     Developer's Console, e.g. 'grape-spaceship-123'. We will also check
+   *     the environment variable GCLOUD_PROJECT for your project ID. If your
+   *     app is running in an environment which supports
+   *     {@link https://developers.google.com/identity/protocols/application-default-credentials Application Default Credentials},
+   *     your project ID will be detected automatically.
+   * @param [options.promise] - Custom promise module to use instead
+   *     of native Promises.
+   * @param [options.servicePath] - The domain name of the
+   *     API remote host.
+   */
+  constructor(config: CloudTasksConfig);
+
+  /**
+   * Return the project ID used by this class.
+   * @param callback - the callback to
+   *   be called with the current project Id.
+   */
+  getProjectId(): PromiseLike<string>;
+  getProjectId(callback: ProjectIdCallback): void;
+
+  // -------------------
+  // -- Service calls --
+  // -------------------
+
+  /**
+   * Lists queues.
+   *
+   * Queues are returned in lexicographical order.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   * @param [request.filter]
+   *   `filter` can be used to specify a subset of queues. Any Queue
+   *   field can be used as a filter and several operators as supported.
+   *   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+   *   described in
+   *   [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+   *
+   *   Sample filter "state: PAUSED".
+   *
+   *   Note that using filters might cause fewer queues than the
+   *   requested page_size to be returned.
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *
+   *   When autoPaginate: false is specified through options, it contains the result
+   *   in a single response. If the response indicates the next page exists, the third
+   *   parameter is set to be used for the next request object. The fourth parameter keeps
+   *   the raw response object of an object representing [ListQueuesResponse]{@link google.cloud.tasks.v2beta3.ListQueuesResponse}.
+   *   The first element of the array is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *
+   *   When autoPaginate: false is specified through options, the array has three elements.
+   *   The first element is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue} in a single response.
+   *   The second element is the next request object if the response
+   *   indicates the next page exists, or null. The third element is
+   *   an object representing [ListQueuesResponse]{@link google.cloud.tasks.v2beta3.ListQueuesResponse}.
+   *
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * // Iterate over all elements.
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   *
+   * client.listQueues({parent: formattedParent})
+   *   .then(responses => {
+   *     const resources = responses[0];
+   *     for (let i = 0; i < resources.length; i += 1) {
+   *       // doThingsWith(resources[i])
+   *     }
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   *
+   * // Or obtain the paged response.
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   *
+   *
+   * const options = {autoPaginate: false};
+   * const callback = responses => {
+   *   // The actual resources in a response.
+   *   const resources = responses[0];
+   *   // The next request if the response shows that there are more responses.
+   *   const nextRequest = responses[1];
+   *   // The actual response object, if necessary.
+   *   // const rawResponse = responses[2];
+   *   for (let i = 0; i < resources.length; i += 1) {
+   *     // doThingsWith(resources[i]);
+   *   }
+   *   if (nextRequest) {
+   *     // Fetch the next page.
+   *     return client.listQueues(nextRequest, options).then(callback);
+   *   }
+   * }
+   * client.listQueues({parent: formattedParent}, options)
+   *   .then(callback)
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  listQueues: PaginatedMethodOverload<
+    ListRequestObject,
+    Queue[],
+    ListQueuesResponse
+  >;
+
+  /**
+   * Equivalent to {@link listQueues}, but returns a NodeJS Stream object.
+   *
+   * This fetches the paged responses for {@link listQueues} continuously
+   * and invokes the callback registered for 'data' event for each element in the
+   * responses.
+   *
+   * The returned object has 'end' method when no more elements are required.
+   *
+   * autoPaginate option will be ignored.
+   *
+   * @see {@link https://nodejs.org/api/stream.html}
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   * @param [request.filter]
+   *   `filter` can be used to specify a subset of queues. Any Queue
+   *   field can be used as a filter and several operators as supported.
+   *   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+   *   described in
+   *   [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+   *
+   *   Sample filter "state: PAUSED".
+   *
+   *   Note that using filters might cause fewer queues than the
+   *   requested page_size to be returned.
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   *   An object stream which emits an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue} on 'data' event.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   * client.listQueuesStream({parent: formattedParent})
+   *   .on('data', element => {
+   *     // doThingsWith(element)
+   *   }).on('error', err => {
+   *     console.log(err);
+   *   });
+   */
+  listQueuesStream(
+    request: ListRequestObject,
+    options?: CallOptions
+  ): Transform;
+
+  /**
+   * Gets a queue.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The resource name of the queue. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.getQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Creates a queue.
+   *
+   * Queues created with this method allow tasks to live for a maximum of 31
+   * days. After a task is 31 days old, the task will be deleted regardless of whether
+   * it was dispatched or not.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name in which the queue will be created.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   *
+   *   The list of allowed locations can be obtained by calling Cloud
+   *   Tasks' implementation of
+   *   ListLocations.
+   * @param request.queue
+   *   Required.
+   *
+   *   The queue to create.
+   *
+   *   Queue's name cannot be the same as an existing queue.
+   *
+   *   This object should have the same structure as [Queue]{@link google.cloud.tasks.v2beta3.Queue}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   * const queue = {};
+   * const request = {
+   *   parent: formattedParent,
+   *   queue: queue,
+   * };
+   * client.createQueue(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  createQueue: MethodOverload<
+    CreateNamedRequest<"queue", Partial<Queue>>,
+    Queue
+  >;
+
+  /**
+   * Updates a queue.
+   *
+   * This method creates the queue if it does not exist and updates
+   * the queue if it does exist.
+   *
+   * Queues created with this method allow tasks to live for a maximum of 31
+   * days. After a task is 31 days old, the task will be deleted regardless of whether
+   * it was dispatched or not.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.queue
+   *   Required.
+   *
+   *   The queue to create or update.
+   *
+   *   The queue's name must be specified.
+   *
+   *   Output only fields cannot be modified using UpdateQueue.
+   *   Any value specified for an output only field will be ignored.
+   *   The queue's name cannot be changed.
+   *
+   *   This object should have the same structure as [Queue]{@link google.cloud.tasks.v2beta3.Queue}
+   * @param [request.updateMask]
+   *   A mask used to specify which fields of the queue are being updated.
+   *
+   *   If empty, then all fields will be updated.
+   *
+   *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const queue = {};
+   * client.updateQueue({queue: queue})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  updateQueue: MethodOverload<
+    UpdateNamedRequest<
+      "queue",
+      EnhancedPick<
+        Queue,
+        "name",
+        "appEngineHttpQueue" | "rateLimits" | "retryConfig"
+      >
+    >,
+    Queue
+  >;
+
+  /**
+   * Deletes a queue.
+   *
+   * This command will delete the queue even if it has tasks in it.
+   *
+   * Note: If you delete a queue, a queue with the same name can't be created
+   * for 7 days.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.deleteQueue({name: formattedName}).catch(err => {
+   *   console.error(err);
+   * });
+   */
+  deleteQueue: MethodOverload<NamedRequest, void>;
+
+  /**
+   * Purges a queue by deleting all of its tasks.
+   *
+   * All tasks created before this method is called are permanently deleted.
+   *
+   * Purge operations can take up to one minute to take effect. Tasks
+   * might be dispatched before the purge takes effect. A purge is irreversible.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.purgeQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  purgeQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Pauses the queue.
+   *
+   * If a queue is paused then the system will stop dispatching tasks
+   * until the queue is resumed via
+   * ResumeQueue. Tasks can still be added
+   * when the queue is paused. A queue is paused if its
+   * state is PAUSED.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.pauseQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  pauseQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Resume a queue.
+   *
+   * This method resumes a queue after it has been
+   * PAUSED or
+   * DISABLED. The state of a queue is stored
+   * in the queue's state; after calling this method it
+   * will be set to RUNNING.
+   *
+   * WARNING: Resuming many high-QPS queues at the same time can
+   * lead to target overloading. If you are resuming high-QPS
+   * queues, follow the 500/50/5 pattern described in
+   * [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.resumeQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  resumeQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Gets the access control policy for a Queue.
+   * Returns an empty policy if the resource exists and does not have a policy
+   * set.
+   *
+   * Authorization requires the following
+   * [Google IAM](https://cloud.google.com/iam) permission on the specified
+   * resource parent:
+   *
+   * * `cloudtasks.queues.getIamPolicy`
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy is being requested.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The first element of the array is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.getIamPolicy({resource: formattedResource})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getIamPolicy: MethodOverload<ResourceRequest, Policy>;
+
+  /**
+   * Sets the access control policy for a Queue. Replaces any existing
+   * policy.
+   *
+   * Note: The Cloud Console does not check queue-level IAM permissions yet.
+   * Project-level permissions are required to use the Cloud Console.
+   *
+   * Authorization requires the following
+   * [Google IAM](https://cloud.google.com/iam) permission on the specified
+   * resource parent:
+   *
+   * * `cloudtasks.queues.setIamPolicy`
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy is being specified.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param request.policy
+   *   REQUIRED: The complete policy to be applied to the `resource`. The size of
+   *   the policy is limited to a few 10s of KB. An empty policy is a
+   *   valid policy but certain Cloud Platform services (such as Projects)
+   *   might reject them.
+   *
+   *   This object should have the same structure as [Policy]{@link google.iam.v1.Policy}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The first element of the array is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const policy = {};
+   * const request = {
+   *   resource: formattedResource,
+   *   policy: policy,
+   * };
+   * client.setIamPolicy(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  setIamPolicy: MethodOverload<ResourceRequest & SetIamPolicyRequest, Policy>;
+
+  /**
+   * Returns permissions that a caller has on a Queue.
+   * If the resource does not exist, this will return an empty set of
+   * permissions, not a NOT_FOUND error.
+   *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy detail is being requested.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param request.permissions
+   *   The set of permissions to check for the `resource`. Permissions with
+   *   wildcards (such as '*' or 'storage.*') are not allowed. For more
+   *   information see
+   *   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [TestIamPermissionsResponse]{@link google.iam.v1.TestIamPermissionsResponse}.
+   *   The first element of the array is an object representing [TestIamPermissionsResponse]{@link google.iam.v1.TestIamPermissionsResponse}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const permissions = [];
+   * const request = {
+   *   resource: formattedResource,
+   *   permissions: permissions,
+   * };
+   * client.testIamPermissions(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  testIamPermissions: MethodOverload<
+    ResourceRequest & TestIamPermissionsRequest,
+    TestIamPermissionsResponse
+  >;
+
+  /**
+   * Lists the tasks in a queue.
+   *
+   * By default, only the BASIC view is retrieved
+   * due to performance considerations;
+   * response_view controls the
+   * subset of information which is returned.
+   *
+   * The tasks may be returned in any order. The ordering may change at any
+   * time.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is Array of [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *
+   *   When autoPaginate: false is specified through options, it contains the result
+   *   in a single response. If the response indicates the next page exists, the third
+   *   parameter is set to be used for the next request object. The fourth parameter keeps
+   *   the raw response object of an object representing [ListTasksResponse]{@link google.cloud.tasks.v2beta3.ListTasksResponse}.
+   *   The first element of the array is Array of [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *
+   *   When autoPaginate: false is specified through options, the array has three elements.
+   *   The first element is Array of [Task]{@link google.cloud.tasks.v2beta3.Task} in a single response.
+   *   The second element is the next request object if the response
+   *   indicates the next page exists, or null. The third element is
+   *   an object representing [ListTasksResponse]{@link google.cloud.tasks.v2beta3.ListTasksResponse}.
+   *
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * // Iterate over all elements.
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   *
+   * client.listTasks({parent: formattedParent})
+   *   .then(responses => {
+   *     const resources = responses[0];
+   *     for (let i = 0; i < resources.length; i += 1) {
+   *       // doThingsWith(resources[i])
+   *     }
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   *
+   * // Or obtain the paged response.
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   *
+   *
+   * const options = {autoPaginate: false};
+   * const callback = responses => {
+   *   // The actual resources in a response.
+   *   const resources = responses[0];
+   *   // The next request if the response shows that there are more responses.
+   *   const nextRequest = responses[1];
+   *   // The actual response object, if necessary.
+   *   // const rawResponse = responses[2];
+   *   for (let i = 0; i < resources.length; i += 1) {
+   *     // doThingsWith(resources[i]);
+   *   }
+   *   if (nextRequest) {
+   *     // Fetch the next page.
+   *     return client.listTasks(nextRequest, options).then(callback);
+   *   }
+   * }
+   * client.listTasks({parent: formattedParent}, options)
+   *   .then(callback)
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  listTasks: PaginatedMethodOverload<
+    ListRequestObject & RunTaskRequest,
+    Task[],
+    ListTasksResponse
+  >;
+
+  /**
+   * Equivalent to {@link listTasks}, but returns a NodeJS Stream object.
+   *
+   * This fetches the paged responses for {@link listTasks} continuously
+   * and invokes the callback registered for 'data' event for each element in the
+   * responses.
+   *
+   * The returned object has 'end' method when no more elements are required.
+   *
+   * autoPaginate option will be ignored.
+   *
+   * @see {@link https://nodejs.org/api/stream.html}
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   *   An object stream which emits an object representing [Task]{@link google.cloud.tasks.v2beta3.Task} on 'data' event.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.listTasksStream({parent: formattedParent})
+   *   .on('data', element => {
+   *     // doThingsWith(element)
+   *   }).on('error', err => {
+   *     console.log(err);
+   *   });
+   */
+  listTasksStream(
+    request: ListRequestObject & RunTaskRequest,
+    options?: CallOptions
+  ): Transform;
+
+  /**
+   * Gets a task.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.getTask({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getTask: MethodOverload<NamedRequest & RunTaskRequest, Task>;
+  /**
+   * Creates a task and adds it to a queue.
+   *
+   * Tasks cannot be updated after creation; there is no UpdateTask command.
+   *
+   * * For App Engine queues, the maximum task size is
+   *   100KB.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   *
+   *   The queue must already exist.
+   * @param request.task
+   *   Required.
+   *
+   *   The task to add.
+   *
+   *   Task names have the following format:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
+   *   The user can optionally specify a task name. If a
+   *   name is not specified then the system will generate a random
+   *   unique task id, which will be set in the task returned in the
+   *   response.
+   *
+   *   If schedule_time is not set or is in the
+   *   past then Cloud Tasks will set it to the current time.
+   *
+   *   Task De-duplication:
+   *
+   *   Explicitly specifying a task ID enables task de-duplication.  If
+   *   a task's ID is identical to that of an existing task or a task
+   *   that was deleted or executed recently then the call will fail
+   *   with ALREADY_EXISTS.
+   *   If the task's queue was created using Cloud Tasks, then another task with
+   *   the same name can't be created for ~1hour after the original task was
+   *   deleted or executed. If the task's queue was created using queue.yaml or
+   *   queue.xml, then another task with the same name can't be created
+   *   for ~9days after the original task was deleted or executed.
+   *
+   *   Because there is an extra lookup cost to identify duplicate task
+   *   names, these CreateTask calls have significantly
+   *   increased latency. Using hashed strings for the task id or for
+   *   the prefix of the task id is recommended. Choosing task ids that
+   *   are sequential or have sequential prefixes, for example using a
+   *   timestamp, causes an increase in latency and error rates in all
+   *   task commands. The infrastructure relies on an approximately
+   *   uniform distribution of task ids to store and serve tasks
+   *   efficiently.
+   *
+   *   This object should have the same structure as [Task]{@link google.cloud.tasks.v2beta3.Task}
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const task = {};
+   * const request = {
+   *   parent: formattedParent,
+   *   task: task,
+   * };
+   * client.createTask(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  createTask: MethodOverload<CreateTaskRequest, Task>;
+
+  /**
+   * Deletes a task.
+   *
+   * A task can be deleted if it is scheduled or dispatched. A task
+   * cannot be deleted if it has executed successfully or permanently
+   * failed.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.deleteTask({name: formattedName}).catch(err => {
+   *   console.error(err);
+   * });
+   */
+  deleteTask: MethodOverload<NamedRequest, void>;
+
+  /**
+   * Forces a task to run now.
+   *
+   * When this method is called, Cloud Tasks will dispatch the task, even if
+   * the task is already running, the queue has reached its RateLimits or
+   * is PAUSED.
+   *
+   * This command is meant to be used for manual debugging. For
+   * example, RunTask can be used to retry a failed
+   * task after a fix has been made or to manually force a task to be
+   * dispatched now.
+   *
+   * The dispatched task is returned. That is, the task that is returned
+   * contains the status after the task is dispatched but
+   * before the task is received by its target.
+   *
+   * If Cloud Tasks receives a successful response from the task's
+   * target, then the task will be deleted; otherwise the task's
+   * schedule_time will be reset to the time that
+   * RunTask was called plus the retry delay specified
+   * in the queue's RetryConfig.
+   *
+   * RunTask returns
+   * NOT_FOUND when it is called on a
+   * task that has already succeeded or permanently failed.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.runTask({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  runTask: MethodOverload<NamedRequest & RunTaskRequest, Task>;
+
+  // --------------------
+  // -- Path templates --
+  // --------------------
+
+  /**
+   * Return a fully-qualified project resource name string.
+   *
+   * @param project
+   */
+  projectPath(project: string): string;
+
+  /**
+   * Return a fully-qualified location resource name string.
+   *
+   * @param project
+   * @param location
+   */
+  locationPath(project: string, location: string): string;
+
+  /**
+   * Return a fully-qualified queue resource name string.
+   *
+   * @param project
+   * @param location
+   * @param queue
+   */
+  queuePath(project: string, location: string, queue: string): string;
+
+  /**
+   * Return a fully-qualified task resource name string.
+   *
+   * @param project
+   * @param location
+   * @param queue
+   * @param task
+   */
+  taskPath(
+    project: string,
+    location: string,
+    queue: string,
+    task: string
+  ): string;
+
+  /**
+   * Parse the projectName from a project resource.
+   *
+   * @param projectName
+   *   A fully-qualified path representing a project resources.
+   */
+  matchProjectFromProjectName(projectName: string): string;
+
+  /**
+   * Parse the locationName from a location resource.
+   *
+   * @param locationName
+   *   A fully-qualified path representing a location resources.
+   */
+  matchProjectFromLocationName(locationName: string): string;
+
+  /**
+   * Parse the locationName from a location resource.
+   *
+   * @param locationName
+   *   A fully-qualified path representing a location resources.
+   */
+  matchLocationFromLocationName(locationName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchProjectFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchLocationFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchQueueFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchProjectFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchLocationFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchQueueFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchTaskFromTaskName(taskName: string): string;
+}
diff --git a/types/google-cloud__tasks/package.json b/types/google-cloud__tasks/package.json
new file mode 100644
index 0000000000..c4a850824a
--- /dev/null
+++ b/types/google-cloud__tasks/package.json
@@ -0,0 +1,14 @@
+{
+    "private": true,
+    "dependencies": {
+        "google-gax": "^0.22.1"
+    },
+    "types": "index",
+    "typesVersions": {
+        ">=3.1.0-0": {
+            "*": [
+                "ts3.1/*"
+            ]
+        }
+    }
+}
diff --git a/types/google-cloud__tasks/ts3.1/google-cloud__tasks-tests.ts b/types/google-cloud__tasks/ts3.1/google-cloud__tasks-tests.ts
new file mode 100644
index 0000000000..94a7ebcfa4
--- /dev/null
+++ b/types/google-cloud__tasks/ts3.1/google-cloud__tasks-tests.ts
@@ -0,0 +1,21 @@
+import Tasks, { Queue } from "@google-cloud/tasks";
+
+const client = new Tasks({});
+
+// $ExpectError
+const failedClient = new Tasks({ unrecognized: "" });
+
+const formattedParent = client.locationPath("[PROJECT]", "[LOCATION]");
+const queue: Partial<Queue> = {};
+const request = {
+  parent: formattedParent,
+  queue
+};
+client
+  .createQueue(request)
+  .then(([queue]) => {
+    const q = queue;
+  })
+  .catch(err => {
+    console.error(err);
+  });
diff --git a/types/google-cloud__tasks/ts3.1/index.d.ts b/types/google-cloud__tasks/ts3.1/index.d.ts
new file mode 100644
index 0000000000..2ffadd1941
--- /dev/null
+++ b/types/google-cloud__tasks/ts3.1/index.d.ts
@@ -0,0 +1,1622 @@
+/// <reference types="node" />
+
+// import * as gax from "google-gax";
+import { Transform } from "stream";
+import { GoogleAuthOptions, GoogleError, CallOptions, GoogleAuth } from "google-gax";
+
+export interface CloudTasksConfig extends GoogleAuthOptions {
+  key?: string;
+  autoRetry?: boolean;
+  maxRetries?: number;
+  libName?: string;
+  libVersion?: string;
+  promise?: PromiseConstructor;
+}
+
+export interface AppEngineHttpQueue {
+  appEngineRoutingOverride: AppEngineRouting;
+}
+
+export interface AppEngineHttpRequest {
+  appEngineRouting: AppEngineRouting;
+  body: string;
+  headers: {
+    [key: string]: string;
+  };
+  httpMethod: string;
+  relativeUri: string;
+}
+
+export interface AppEngineRouting {
+  host: string;
+  instance: string;
+  service: string;
+  version: string;
+}
+
+export interface Attempt {
+  dispatchTime: string;
+  responseStatus: Status;
+  responseTime: string;
+  scheduleTime: string;
+}
+
+export interface Binding {
+  condition: Expr;
+  members: string[];
+  role: string;
+}
+
+export interface CreateTaskRequest {
+  responseView: View;
+  task: Partial<Task>;
+}
+
+export interface Expr {
+  description: string;
+  expression: string;
+  location: string;
+  title: string;
+}
+
+export interface ListLocationsResponse {
+  locations: Location[];
+  nextPageToken?: string;
+}
+
+export interface ListQueuesResponse {
+  nextPageToken?: string;
+  queues: Queue[];
+}
+
+export interface ListTasksResponse {
+  nextPageToken?: string;
+  tasks: Task[];
+}
+
+export interface Location {
+  displayName: string;
+  labels: {
+    [key: string]: string;
+  };
+  locationId: string;
+  metadata: {
+    [key: string]: any;
+  };
+  name: string;
+}
+
+export interface Policy {
+  bindings: Binding[];
+  etag: string;
+  version: number;
+}
+
+export interface Queue {
+  appEngineHttpQueue: AppEngineHttpQueue;
+  name: string;
+  purgeTime: string;
+  rateLimits: RateLimits;
+  retryConfig: RetryConfig;
+  state: string;
+}
+
+export interface RateLimits {
+  maxBurstSize: number;
+  maxConcurrentDispatches: number;
+  maxDispatchesPerSecond: number;
+}
+
+export interface RetryConfig {
+  maxAttempts: number;
+  maxBackoff: string;
+  maxDoublings: number;
+  maxRetryDuration: string;
+  minBackoff: string;
+}
+
+export interface RunTaskRequest {
+  responseView?: View;
+}
+
+export interface SetIamPolicyRequest {
+  policy: Partial<Policy>;
+}
+
+export interface Status {
+  code: number;
+  details: Array<{
+    [key: string]: any;
+  }>;
+  message: string;
+}
+
+/**
+ * `VIEW_UNSPECIFIED = 0;`
+ * When Unspecified. Defaults to the behaviour of BASIC.
+ *
+ * `BASIC = 1;`
+ * The basic view omits fields which can be large or can contain
+ * sensitive data.
+ * This view does not include the
+ * ([payload in AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] and
+ * [payload in PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These payloads are
+ * desirable to return only when needed, because they can be large
+ * and because of the sensitivity of the data that you choose to
+ * store in it.
+ *
+ * `FULL = 2;`
+ * All information is returned.
+ *
+ * Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+ * `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+ * permission on the [Queue][google.cloud.tasks.v2beta2.Queue] resource.
+ */
+export type View = 0 | 1 | 2;
+
+export interface Task {
+  appEngineHttpRequest: AppEngineHttpRequest;
+  createTime: string;
+  dispatchCount: number;
+  firstAttempt: Attempt;
+  lastAttempt: Attempt;
+  name: string;
+  responseCount: number;
+  scheduleTime: string;
+  view: View;
+}
+
+export interface TestIamPermissionsRequest {
+  permissions?: string[];
+}
+
+export interface TestIamPermissionsResponse {
+  permissions?: string[];
+}
+
+export interface PromiseLike<T> extends Promise<T> {
+  /**
+   * Cancel the ongoing promise
+   */
+  cancel(): void;
+}
+
+export type Keys<T> = keyof T;
+
+export type EnhancedPick<
+  T,
+  Req extends keyof T,
+  Opt extends keyof T
+> = Required<Pick<T, Req>> & Partial<Pick<T, Req>>;
+
+export type ProjectIdCallback = (
+  err?: Error | null,
+  projectId?: string | null
+) => void;
+
+export type APICallback<T = any> = (
+  err: GoogleError | null,
+  response?: T
+) => void;
+
+export type APIPaginatedCallback<T = any, U = any, V = any> = (
+  err: GoogleError | null,
+  response?: T,
+  next?: U | null,
+  rawResponse?: V
+) => void;
+
+export interface CallOptionsWithPagination extends CallOptions {
+  autoPaginate: false;
+}
+
+export interface MethodOverload<T, R> {
+  (data: T, options?: CallOptions): PromiseLike<[R]>;
+  (data: T, options: CallOptions, callback: APICallback<R>): void;
+  (data: T, callback: APICallback<R>): void;
+}
+
+export interface PaginatedMethodOverload<T, R, U, V = T> {
+  (data: T, options: CallOptionsWithPagination): PromiseLike<[R, V, U]>;
+  (data: T, options?: CallOptions): PromiseLike<[R]>;
+  (data: T, options: CallOptions, callback: APICallback<R>): void;
+  (
+    data: T,
+    options: CallOptionsWithPagination,
+    callback: APIPaginatedCallback<R, V, U>
+  ): void;
+  (data: T, callback: APICallback<R>): void;
+}
+
+export interface ParentRequest {
+  /**
+   * The location name. For example: projects/PROJECT_ID/locations/LOCATION_ID
+   */
+  parent: string;
+}
+
+export interface ResourceRequest {
+  /**
+   * The resource for which the policy is being requested. resource is usually specified as a path. For example, a Project resource is specified as projects/{project}.
+   */
+  resource: string;
+}
+
+export interface ListRequestObject extends ParentRequest {
+  /**
+   * `filter` can be used to specify a subset of queues. Any Queue field can be used as a filter and several operators as supported.
+   * For example: <=, <, >=, >, !=, =, :. The filter syntax is the same as described in Stackdriver's Advanced Logs Filters.
+   * Sample filter "state: PAUSED".
+   * Note that using filters might cause fewer queues than the requested page_size to be returned.
+   */
+  filter?: string;
+
+  /**
+   * The maximum number of resources contained in the underlying API response. If page streaming is performed per-resource,
+   * this parameter does not affect the return value. If page streaming is performed per-page, this determines the maximum number of resources in a page.
+   */
+  pageSize?: number;
+}
+
+export interface NamedRequest {
+  /**
+   * The resource name of the queue. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
+   */
+  name: string;
+}
+
+export type CreateNamedRequest<N extends string, T> = ParentRequest &
+  { [P in N]: T };
+export type UpdateNamedRequest<N extends string, T> = ParentRequest &
+  { [P in N]: T };
+
+/**
+ * Cloud Tasks allows developers to manage the execution of background
+ * work in their applications.
+ */
+export default class CloudTasksClient {
+  /**
+   * The DNS address for this API service.
+   * @default 'cloudtasks.googleapis.com'
+   */
+  static readonly servicePath: string;
+
+  /**
+   * The port for this API service.
+   * @default 443
+   */
+  static readonly port: number;
+
+  /**
+   * The scopes needed to make gRPC calls for every method defined
+   * in this service.
+   * @default ["https://www.googleapis.com/auth/cloud-platform"]
+   */
+  static readonlyscopes: string;
+
+  auth: GoogleAuth;
+
+  /**
+   * Construct an instance of CloudTasksClient.
+   *
+   * @param [options] - The configuration object. See the subsequent
+   *   parameters for more details.
+   * @param [options.credentials] - Credentials object.
+   * @param [options.credentials.client_email]
+   * @param [options.credentials.private_key]
+   * @param [options.email] - Account email address. Required when
+   *     using a .pem or .p12 keyFilename.
+   * @param [options.keyFilename] - Full path to the a .json, .pem, or
+   *     .p12 key downloaded from the Google Developers Console. If you provide
+   *     a path to a JSON file, the projectId option below is not necessary.
+   *     NOTE: .pem and .p12 require you to specify options.email as well.
+   * @param [options.port] - The port on which to connect to
+   *     the remote host.
+   * @param [options.projectId] - The project ID from the Google
+   *     Developer's Console, e.g. 'grape-spaceship-123'. We will also check
+   *     the environment variable GCLOUD_PROJECT for your project ID. If your
+   *     app is running in an environment which supports
+   *     {@link https://developers.google.com/identity/protocols/application-default-credentials Application Default Credentials},
+   *     your project ID will be detected automatically.
+   * @param [options.promise] - Custom promise module to use instead
+   *     of native Promises.
+   * @param [options.servicePath] - The domain name of the
+   *     API remote host.
+   */
+  constructor(config: CloudTasksConfig);
+
+  /**
+   * Return the project ID used by this class.
+   * @param callback - the callback to
+   *   be called with the current project Id.
+   */
+  getProjectId(): PromiseLike<string>;
+  getProjectId(callback: ProjectIdCallback): void;
+
+  // -------------------
+  // -- Service calls --
+  // -------------------
+
+  /**
+   * Lists queues.
+   *
+   * Queues are returned in lexicographical order.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   * @param [request.filter]
+   *   `filter` can be used to specify a subset of queues. Any Queue
+   *   field can be used as a filter and several operators as supported.
+   *   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+   *   described in
+   *   [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+   *
+   *   Sample filter "state: PAUSED".
+   *
+   *   Note that using filters might cause fewer queues than the
+   *   requested page_size to be returned.
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *
+   *   When autoPaginate: false is specified through options, it contains the result
+   *   in a single response. If the response indicates the next page exists, the third
+   *   parameter is set to be used for the next request object. The fourth parameter keeps
+   *   the raw response object of an object representing [ListQueuesResponse]{@link google.cloud.tasks.v2beta3.ListQueuesResponse}.
+   *   The first element of the array is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *
+   *   When autoPaginate: false is specified through options, the array has three elements.
+   *   The first element is Array of [Queue]{@link google.cloud.tasks.v2beta3.Queue} in a single response.
+   *   The second element is the next request object if the response
+   *   indicates the next page exists, or null. The third element is
+   *   an object representing [ListQueuesResponse]{@link google.cloud.tasks.v2beta3.ListQueuesResponse}.
+   *
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * // Iterate over all elements.
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   *
+   * client.listQueues({parent: formattedParent})
+   *   .then(responses => {
+   *     const resources = responses[0];
+   *     for (let i = 0; i < resources.length; i += 1) {
+   *       // doThingsWith(resources[i])
+   *     }
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   *
+   * // Or obtain the paged response.
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   *
+   *
+   * const options = {autoPaginate: false};
+   * const callback = responses => {
+   *   // The actual resources in a response.
+   *   const resources = responses[0];
+   *   // The next request if the response shows that there are more responses.
+   *   const nextRequest = responses[1];
+   *   // The actual response object, if necessary.
+   *   // const rawResponse = responses[2];
+   *   for (let i = 0; i < resources.length; i += 1) {
+   *     // doThingsWith(resources[i]);
+   *   }
+   *   if (nextRequest) {
+   *     // Fetch the next page.
+   *     return client.listQueues(nextRequest, options).then(callback);
+   *   }
+   * }
+   * client.listQueues({parent: formattedParent}, options)
+   *   .then(callback)
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  listQueues: PaginatedMethodOverload<
+    ListRequestObject,
+    Queue[],
+    ListQueuesResponse
+  >;
+
+  /**
+   * Equivalent to {@link listQueues}, but returns a NodeJS Stream object.
+   *
+   * This fetches the paged responses for {@link listQueues} continuously
+   * and invokes the callback registered for 'data' event for each element in the
+   * responses.
+   *
+   * The returned object has 'end' method when no more elements are required.
+   *
+   * autoPaginate option will be ignored.
+   *
+   * @see {@link https://nodejs.org/api/stream.html}
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   * @param [request.filter]
+   *   `filter` can be used to specify a subset of queues. Any Queue
+   *   field can be used as a filter and several operators as supported.
+   *   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+   *   described in
+   *   [Stackdriver's Advanced Logs Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+   *
+   *   Sample filter "state: PAUSED".
+   *
+   *   Note that using filters might cause fewer queues than the
+   *   requested page_size to be returned.
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   *   An object stream which emits an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue} on 'data' event.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   * client.listQueuesStream({parent: formattedParent})
+   *   .on('data', element => {
+   *     // doThingsWith(element)
+   *   }).on('error', err => {
+   *     console.log(err);
+   *   });
+   */
+  listQueuesStream(
+    request: ListRequestObject,
+    options?: CallOptions
+  ): Transform;
+
+  /**
+   * Gets a queue.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The resource name of the queue. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.getQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Creates a queue.
+   *
+   * Queues created with this method allow tasks to live for a maximum of 31
+   * days. After a task is 31 days old, the task will be deleted regardless of whether
+   * it was dispatched or not.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The location name in which the queue will be created.
+   *   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+   *
+   *   The list of allowed locations can be obtained by calling Cloud
+   *   Tasks' implementation of
+   *   ListLocations.
+   * @param request.queue
+   *   Required.
+   *
+   *   The queue to create.
+   *
+   *   Queue's name cannot be the same as an existing queue.
+   *
+   *   This object should have the same structure as [Queue]{@link google.cloud.tasks.v2beta3.Queue}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.locationPath('[PROJECT]', '[LOCATION]');
+   * const queue = {};
+   * const request = {
+   *   parent: formattedParent,
+   *   queue: queue,
+   * };
+   * client.createQueue(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  createQueue: MethodOverload<
+    CreateNamedRequest<"queue", Partial<Queue>>,
+    Queue
+  >;
+
+  /**
+   * Updates a queue.
+   *
+   * This method creates the queue if it does not exist and updates
+   * the queue if it does exist.
+   *
+   * Queues created with this method allow tasks to live for a maximum of 31
+   * days. After a task is 31 days old, the task will be deleted regardless of whether
+   * it was dispatched or not.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.queue
+   *   Required.
+   *
+   *   The queue to create or update.
+   *
+   *   The queue's name must be specified.
+   *
+   *   Output only fields cannot be modified using UpdateQueue.
+   *   Any value specified for an output only field will be ignored.
+   *   The queue's name cannot be changed.
+   *
+   *   This object should have the same structure as [Queue]{@link google.cloud.tasks.v2beta3.Queue}
+   * @param [request.updateMask]
+   *   A mask used to specify which fields of the queue are being updated.
+   *
+   *   If empty, then all fields will be updated.
+   *
+   *   This object should have the same structure as [FieldMask]{@link google.protobuf.FieldMask}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const queue = {};
+   * client.updateQueue({queue: queue})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  updateQueue: MethodOverload<
+    UpdateNamedRequest<
+      "queue",
+      EnhancedPick<
+        Queue,
+        "name",
+        "appEngineHttpQueue" | "rateLimits" | "retryConfig"
+      >
+    >,
+    Queue
+  >;
+
+  /**
+   * Deletes a queue.
+   *
+   * This command will delete the queue even if it has tasks in it.
+   *
+   * Note: If you delete a queue, a queue with the same name can't be created
+   * for 7 days.
+   *
+   * WARNING: Using this method may have unintended side effects if you are
+   * using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+   * Read
+   * [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
+   * before using this method.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.deleteQueue({name: formattedName}).catch(err => {
+   *   console.error(err);
+   * });
+   */
+  deleteQueue: MethodOverload<NamedRequest, void>;
+
+  /**
+   * Purges a queue by deleting all of its tasks.
+   *
+   * All tasks created before this method is called are permanently deleted.
+   *
+   * Purge operations can take up to one minute to take effect. Tasks
+   * might be dispatched before the purge takes effect. A purge is irreversible.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.purgeQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  purgeQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Pauses the queue.
+   *
+   * If a queue is paused then the system will stop dispatching tasks
+   * until the queue is resumed via
+   * ResumeQueue. Tasks can still be added
+   * when the queue is paused. A queue is paused if its
+   * state is PAUSED.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.pauseQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  pauseQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Resume a queue.
+   *
+   * This method resumes a queue after it has been
+   * PAUSED or
+   * DISABLED. The state of a queue is stored
+   * in the queue's state; after calling this method it
+   * will be set to RUNNING.
+   *
+   * WARNING: Resuming many high-QPS queues at the same time can
+   * lead to target overloading. If you are resuming high-QPS
+   * queues, follow the 500/50/5 pattern described in
+   * [Managing Cloud Tasks Scaling Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The first element of the array is an object representing [Queue]{@link google.cloud.tasks.v2beta3.Queue}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.resumeQueue({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  resumeQueue: MethodOverload<NamedRequest, Queue>;
+
+  /**
+   * Gets the access control policy for a Queue.
+   * Returns an empty policy if the resource exists and does not have a policy
+   * set.
+   *
+   * Authorization requires the following
+   * [Google IAM](https://cloud.google.com/iam) permission on the specified
+   * resource parent:
+   *
+   * * `cloudtasks.queues.getIamPolicy`
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy is being requested.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The first element of the array is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.getIamPolicy({resource: formattedResource})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getIamPolicy: MethodOverload<ResourceRequest, Policy>;
+
+  /**
+   * Sets the access control policy for a Queue. Replaces any existing
+   * policy.
+   *
+   * Note: The Cloud Console does not check queue-level IAM permissions yet.
+   * Project-level permissions are required to use the Cloud Console.
+   *
+   * Authorization requires the following
+   * [Google IAM](https://cloud.google.com/iam) permission on the specified
+   * resource parent:
+   *
+   * * `cloudtasks.queues.setIamPolicy`
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy is being specified.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param request.policy
+   *   REQUIRED: The complete policy to be applied to the `resource`. The size of
+   *   the policy is limited to a few 10s of KB. An empty policy is a
+   *   valid policy but certain Cloud Platform services (such as Projects)
+   *   might reject them.
+   *
+   *   This object should have the same structure as [Policy]{@link google.iam.v1.Policy}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The first element of the array is an object representing [Policy]{@link google.iam.v1.Policy}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const policy = {};
+   * const request = {
+   *   resource: formattedResource,
+   *   policy: policy,
+   * };
+   * client.setIamPolicy(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  setIamPolicy: MethodOverload<ResourceRequest & SetIamPolicyRequest, Policy>;
+
+  /**
+   * Returns permissions that a caller has on a Queue.
+   * If the resource does not exist, this will return an empty set of
+   * permissions, not a NOT_FOUND error.
+   *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.resource
+   *   REQUIRED: The resource for which the policy detail is being requested.
+   *   `resource` is usually specified as a path. For example, a Project
+   *   resource is specified as `projects/{project}`.
+   * @param request.permissions
+   *   The set of permissions to check for the `resource`. Permissions with
+   *   wildcards (such as '*' or 'storage.*') are not allowed. For more
+   *   information see
+   *   [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [TestIamPermissionsResponse]{@link google.iam.v1.TestIamPermissionsResponse}.
+   *   The first element of the array is an object representing [TestIamPermissionsResponse]{@link google.iam.v1.TestIamPermissionsResponse}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedResource = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const permissions = [];
+   * const request = {
+   *   resource: formattedResource,
+   *   permissions: permissions,
+   * };
+   * client.testIamPermissions(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  testIamPermissions: MethodOverload<
+    ResourceRequest & TestIamPermissionsRequest,
+    TestIamPermissionsResponse
+  >;
+
+  /**
+   * Lists the tasks in a queue.
+   *
+   * By default, only the BASIC view is retrieved
+   * due to performance considerations;
+   * response_view controls the
+   * subset of information which is returned.
+   *
+   * The tasks may be returned in any order. The ordering may change at any
+   * time.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is Array of [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *
+   *   When autoPaginate: false is specified through options, it contains the result
+   *   in a single response. If the response indicates the next page exists, the third
+   *   parameter is set to be used for the next request object. The fourth parameter keeps
+   *   the raw response object of an object representing [ListTasksResponse]{@link google.cloud.tasks.v2beta3.ListTasksResponse}.
+   *   The first element of the array is Array of [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *
+   *   When autoPaginate: false is specified through options, the array has three elements.
+   *   The first element is Array of [Task]{@link google.cloud.tasks.v2beta3.Task} in a single response.
+   *   The second element is the next request object if the response
+   *   indicates the next page exists, or null. The third element is
+   *   an object representing [ListTasksResponse]{@link google.cloud.tasks.v2beta3.ListTasksResponse}.
+   *
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * // Iterate over all elements.
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   *
+   * client.listTasks({parent: formattedParent})
+   *   .then(responses => {
+   *     const resources = responses[0];
+   *     for (let i = 0; i < resources.length; i += 1) {
+   *       // doThingsWith(resources[i])
+   *     }
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   *
+   * // Or obtain the paged response.
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   *
+   *
+   * const options = {autoPaginate: false};
+   * const callback = responses => {
+   *   // The actual resources in a response.
+   *   const resources = responses[0];
+   *   // The next request if the response shows that there are more responses.
+   *   const nextRequest = responses[1];
+   *   // The actual response object, if necessary.
+   *   // const rawResponse = responses[2];
+   *   for (let i = 0; i < resources.length; i += 1) {
+   *     // doThingsWith(resources[i]);
+   *   }
+   *   if (nextRequest) {
+   *     // Fetch the next page.
+   *     return client.listTasks(nextRequest, options).then(callback);
+   *   }
+   * }
+   * client.listTasks({parent: formattedParent}, options)
+   *   .then(callback)
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  listTasks: PaginatedMethodOverload<
+    ListRequestObject & RunTaskRequest,
+    Task[],
+    ListTasksResponse
+  >;
+
+  /**
+   * Equivalent to {@link listTasks}, but returns a NodeJS Stream object.
+   *
+   * This fetches the paged responses for {@link listTasks} continuously
+   * and invokes the callback registered for 'data' event for each element in the
+   * responses.
+   *
+   * The returned object has 'end' method when no more elements are required.
+   *
+   * autoPaginate option will be ignored.
+   *
+   * @see {@link https://nodejs.org/api/stream.html}
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [request.pageSize]
+   *   The maximum number of resources contained in the underlying API
+   *   response. If page streaming is performed per-resource, this
+   *   parameter does not affect the return value. If page streaming is
+   *   performed per-page, this determines the maximum number of
+   *   resources in a page.
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   *   An object stream which emits an object representing [Task]{@link google.cloud.tasks.v2beta3.Task} on 'data' event.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * client.listTasksStream({parent: formattedParent})
+   *   .on('data', element => {
+   *     // doThingsWith(element)
+   *   }).on('error', err => {
+   *     console.log(err);
+   *   });
+   */
+  listTasksStream(
+    request: ListRequestObject & RunTaskRequest,
+    options?: CallOptions
+  ): Transform;
+
+  /**
+   * Gets a task.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.getTask({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  getTask: MethodOverload<NamedRequest & RunTaskRequest, Task>;
+  /**
+   * Creates a task and adds it to a queue.
+   *
+   * Tasks cannot be updated after creation; there is no UpdateTask command.
+   *
+   * * For App Engine queues, the maximum task size is
+   *   100KB.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.parent
+   *   Required.
+   *
+   *   The queue name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+   *
+   *   The queue must already exist.
+   * @param request.task
+   *   Required.
+   *
+   *   The task to add.
+   *
+   *   Task names have the following format:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
+   *   The user can optionally specify a task name. If a
+   *   name is not specified then the system will generate a random
+   *   unique task id, which will be set in the task returned in the
+   *   response.
+   *
+   *   If schedule_time is not set or is in the
+   *   past then Cloud Tasks will set it to the current time.
+   *
+   *   Task De-duplication:
+   *
+   *   Explicitly specifying a task ID enables task de-duplication.  If
+   *   a task's ID is identical to that of an existing task or a task
+   *   that was deleted or executed recently then the call will fail
+   *   with ALREADY_EXISTS.
+   *   If the task's queue was created using Cloud Tasks, then another task with
+   *   the same name can't be created for ~1hour after the original task was
+   *   deleted or executed. If the task's queue was created using queue.yaml or
+   *   queue.xml, then another task with the same name can't be created
+   *   for ~9days after the original task was deleted or executed.
+   *
+   *   Because there is an extra lookup cost to identify duplicate task
+   *   names, these CreateTask calls have significantly
+   *   increased latency. Using hashed strings for the task id or for
+   *   the prefix of the task id is recommended. Choosing task ids that
+   *   are sequential or have sequential prefixes, for example using a
+   *   timestamp, causes an increase in latency and error rates in all
+   *   task commands. The infrastructure relies on an approximately
+   *   uniform distribution of task ids to store and serve tasks
+   *   efficiently.
+   *
+   *   This object should have the same structure as [Task]{@link google.cloud.tasks.v2beta3.Task}
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedParent = client.queuePath('[PROJECT]', '[LOCATION]', '[QUEUE]');
+   * const task = {};
+   * const request = {
+   *   parent: formattedParent,
+   *   task: task,
+   * };
+   * client.createTask(request)
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  createTask: MethodOverload<CreateTaskRequest, Task>;
+
+  /**
+   * Deletes a task.
+   *
+   * A task can be deleted if it is scheduled or dispatched. A task
+   * cannot be deleted if it has executed successfully or permanently
+   * failed.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.deleteTask({name: formattedName}).catch(err => {
+   *   console.error(err);
+   * });
+   */
+  deleteTask: MethodOverload<NamedRequest, void>;
+
+  /**
+   * Forces a task to run now.
+   *
+   * When this method is called, Cloud Tasks will dispatch the task, even if
+   * the task is already running, the queue has reached its RateLimits or
+   * is PAUSED.
+   *
+   * This command is meant to be used for manual debugging. For
+   * example, RunTask can be used to retry a failed
+   * task after a fix has been made or to manually force a task to be
+   * dispatched now.
+   *
+   * The dispatched task is returned. That is, the task that is returned
+   * contains the status after the task is dispatched but
+   * before the task is received by its target.
+   *
+   * If Cloud Tasks receives a successful response from the task's
+   * target, then the task will be deleted; otherwise the task's
+   * schedule_time will be reset to the time that
+   * RunTask was called plus the retry delay specified
+   * in the queue's RetryConfig.
+   *
+   * RunTask returns
+   * NOT_FOUND when it is called on a
+   * task that has already succeeded or permanently failed.
+   *
+   * @param request
+   *   The request object that will be sent.
+   * @param request.name
+   *   Required.
+   *
+   *   The task name. For example:
+   *   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+   * @param [request.responseView]
+   *   The response_view specifies which subset of the Task will be
+   *   returned.
+   *
+   *   By default response_view is BASIC; not all
+   *   information is retrieved by default because some data, such as
+   *   payloads, might be desirable to return only when needed because
+   *   of its large size or because of the sensitivity of data that it
+   *   contains.
+   *
+   *   Authorization for FULL requires
+   *   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+   *   permission on the Task resource.
+   *
+   *   The number should be among the values of [View]{@link google.cloud.tasks.v2beta3.View}
+   * @param [options]
+   *   Optional parameters. You can override the default settings for this call, e.g, timeout,
+   *   retries, paginations, etc. See [gax.CallOptions]{@link https://googleapis.github.io/gax-nodejs/global.html#CallOptions} for the details.
+   * @param [callback]
+   *   The function which will be called with the result of the API call.
+   *
+   *   The second parameter to the callback is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The first element of the array is an object representing [Task]{@link google.cloud.tasks.v2beta3.Task}.
+   *   The promise has a method named "cancel" which cancels the ongoing API call.
+   *
+   * @example
+   *
+   * import CloudTasks from '@google-cloud/tasks';
+   *
+   * const client = new tasks.v2beta3.CloudTasksClient({
+   *   // optional auth parameters.
+   * });
+   *
+   * const formattedName = client.taskPath('[PROJECT]', '[LOCATION]', '[QUEUE]', '[TASK]');
+   * client.runTask({name: formattedName})
+   *   .then(responses => {
+   *     const response = responses[0];
+   *     // doThingsWith(response)
+   *   })
+   *   .catch(err => {
+   *     console.error(err);
+   *   });
+   */
+  runTask: MethodOverload<NamedRequest & RunTaskRequest, Task>;
+
+  // --------------------
+  // -- Path templates --
+  // --------------------
+
+  /**
+   * Return a fully-qualified project resource name string.
+   *
+   * @param project
+   */
+  projectPath(project: string): string;
+
+  /**
+   * Return a fully-qualified location resource name string.
+   *
+   * @param project
+   * @param location
+   */
+  locationPath(project: string, location: string): string;
+
+  /**
+   * Return a fully-qualified queue resource name string.
+   *
+   * @param project
+   * @param location
+   * @param queue
+   */
+  queuePath(project: string, location: string, queue: string): string;
+
+  /**
+   * Return a fully-qualified task resource name string.
+   *
+   * @param project
+   * @param location
+   * @param queue
+   * @param task
+   */
+  taskPath(
+    project: string,
+    location: string,
+    queue: string,
+    task: string
+  ): string;
+
+  /**
+   * Parse the projectName from a project resource.
+   *
+   * @param projectName
+   *   A fully-qualified path representing a project resources.
+   */
+  matchProjectFromProjectName(projectName: string): string;
+
+  /**
+   * Parse the locationName from a location resource.
+   *
+   * @param locationName
+   *   A fully-qualified path representing a location resources.
+   */
+  matchProjectFromLocationName(locationName: string): string;
+
+  /**
+   * Parse the locationName from a location resource.
+   *
+   * @param locationName
+   *   A fully-qualified path representing a location resources.
+   */
+  matchLocationFromLocationName(locationName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchProjectFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchLocationFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the queueName from a queue resource.
+   *
+   * @param queueName
+   *   A fully-qualified path representing a queue resources.
+   */
+  matchQueueFromQueueName(queueName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchProjectFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchLocationFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchQueueFromTaskName(taskName: string): string;
+
+  /**
+   * Parse the taskName from a task resource.
+   *
+   * @param taskName
+   *   A fully-qualified path representing a task resources.
+   */
+  matchTaskFromTaskName(taskName: string): string;
+}
diff --git a/types/google-cloud__tasks/ts3.1/tsconfig.json b/types/google-cloud__tasks/ts3.1/tsconfig.json
new file mode 100644
index 0000000000..08ba955879
--- /dev/null
+++ b/types/google-cloud__tasks/ts3.1/tsconfig.json
@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["es6"],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "paths": {
+            "@google-cloud/tasks": ["google-cloud__tasks"]
+        },
+        "baseUrl": "../../",
+        "typeRoots": ["../../"],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": ["index.d.ts", "google-cloud__tasks-tests.ts"]
+}
diff --git a/types/google-cloud__tasks/ts3.1/tslint.json b/types/google-cloud__tasks/ts3.1/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/google-cloud__tasks/ts3.1/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }
diff --git a/types/google-cloud__tasks/tsconfig.json b/types/google-cloud__tasks/tsconfig.json
new file mode 100644
index 0000000000..498e1217fc
--- /dev/null
+++ b/types/google-cloud__tasks/tsconfig.json
@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["es6"],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "paths": {
+            "@google-cloud/tasks": ["google-cloud__tasks"]
+        },
+        "baseUrl": "../",
+        "typeRoots": ["../"],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": ["index.d.ts", "google-cloud__tasks-tests.ts"]
+}
diff --git a/types/google-cloud__tasks/tslint.json b/types/google-cloud__tasks/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/google-cloud__tasks/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From 9b298ff48f05e74972ee500c90ad11e6791fbe20 Mon Sep 17 00:00:00 2001
From: Ifiok Jr <ifiokotung@gmail.com>
Date: Sat, 26 Jan 2019 06:23:19 +0000
Subject: [PATCH 18/61] fix(@google-cloud/tasks): pr requests

---
 types/google-cloud__tasks/index.d.ts       | 12 +++---------
 types/google-cloud__tasks/ts3.1/index.d.ts | 16 ++++++++--------
 2 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/types/google-cloud__tasks/index.d.ts b/types/google-cloud__tasks/index.d.ts
index b7c2099f68..c3347c8ea4 100644
--- a/types/google-cloud__tasks/index.d.ts
+++ b/types/google-cloud__tasks/index.d.ts
@@ -1,5 +1,5 @@
 // Type definitions for @google-cloud/tasks 0.2
-// Project: https://github.com/googleapis/nodejs-tasks (Does not have to be to GitHub, but prefer linking to a source code repository rather than to a project website.)
+// Project: https://github.com/googleapis/nodejs-tasks
 // Definitions by: Ifiok Jr. <https://github.com/ifiokjr>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
@@ -7,9 +7,7 @@
 
 /// <reference types="node" />
 
-// import * as gax from "google-gax";
 import { Transform } from "stream";
-// import { GoogleAuthOptions, GoogleError, CallOptions, GoogleAuth } from "google-gax";
 export type GoogleError = any;
 export type GoogleAuthOptions = any;
 export type CallOptions = any;
@@ -91,9 +89,7 @@ export interface Location {
     [key: string]: string;
   };
   locationId: string;
-  metadata: {
-    [key: string]: any;
-  };
+  metadata: object;
   name: string;
 }
 
@@ -136,9 +132,7 @@ export interface SetIamPolicyRequest {
 
 export interface Status {
   code: number;
-  details: Array<{
-    [key: string]: any;
-  }>;
+  details: object[];
   message: string;
 }
 
diff --git a/types/google-cloud__tasks/ts3.1/index.d.ts b/types/google-cloud__tasks/ts3.1/index.d.ts
index 2ffadd1941..6b09fdd06d 100644
--- a/types/google-cloud__tasks/ts3.1/index.d.ts
+++ b/types/google-cloud__tasks/ts3.1/index.d.ts
@@ -1,8 +1,12 @@
 /// <reference types="node" />
 
-// import * as gax from "google-gax";
 import { Transform } from "stream";
-import { GoogleAuthOptions, GoogleError, CallOptions, GoogleAuth } from "google-gax";
+import {
+  GoogleAuthOptions,
+  GoogleError,
+  CallOptions,
+  GoogleAuth
+} from "google-gax";
 
 export interface CloudTasksConfig extends GoogleAuthOptions {
   key?: string;
@@ -80,9 +84,7 @@ export interface Location {
     [key: string]: string;
   };
   locationId: string;
-  metadata: {
-    [key: string]: any;
-  };
+  metadata: object;
   name: string;
 }
 
@@ -125,9 +127,7 @@ export interface SetIamPolicyRequest {
 
 export interface Status {
   code: number;
-  details: Array<{
-    [key: string]: any;
-  }>;
+  details: object[];
   message: string;
 }
 

From 7f3293acfc9931805585202606ca63079f5a332d Mon Sep 17 00:00:00 2001
From: rhysd <lin90162@yahoo.co.jp>
Date: Sat, 26 Jan 2019 15:51:43 +0900
Subject: [PATCH 19/61] enable file header check and fix version format

---
 types/obelisk.js/index.d.ts  | 2 +-
 types/obelisk.js/tslint.json | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/obelisk.js/index.d.ts b/types/obelisk.js/index.d.ts
index 91c481d198..7a4266905f 100644
--- a/types/obelisk.js/index.d.ts
+++ b/types/obelisk.js/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for obelisk.js v1.2.1
+// Type definitions for obelisk.js 1.2
 // Project: https://github.com/nosir/obelisk.js/
 // Definitions by: Brian Drupieski <https://github.com/bdrupieski>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
diff --git a/types/obelisk.js/tslint.json b/types/obelisk.js/tslint.json
index d67ffb3a73..40aa0a5f91 100644
--- a/types/obelisk.js/tslint.json
+++ b/types/obelisk.js/tslint.json
@@ -7,7 +7,7 @@
         "ban-types": false,
         "callable-types": false,
         "comment-format": false,
-        "dt-header": false,
+        "dt-header": true,
         "eofline": false,
         "export-just-namespace": false,
         "import-spacing": false,

From 1acfe93407b93b23fa26cc22804caeefd4039dd8 Mon Sep 17 00:00:00 2001
From: rhysd <lin90162@yahoo.co.jp>
Date: Sat, 26 Jan 2019 15:52:09 +0900
Subject: [PATCH 20/61] use `export as namespace` instead of `export =`

---
 types/obelisk.js/index.d.ts | 483 ++++++++++++++++++------------------
 1 file changed, 244 insertions(+), 239 deletions(-)

diff --git a/types/obelisk.js/index.d.ts b/types/obelisk.js/index.d.ts
index 7a4266905f..d28643e2c5 100644
--- a/types/obelisk.js/index.d.ts
+++ b/types/obelisk.js/index.d.ts
@@ -3,255 +3,260 @@
 // Definitions by: Brian Drupieski <https://github.com/bdrupieski>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-export = obelisk;
-declare namespace obelisk {
+export as namespace obelisk;
 
-    export var version: string;
-    export var author: string;
+export var version: string;
+export var author: string;
 
-    export class Matrix {
-        constructor(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number);
+export class Matrix {
+    constructor(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number);
 
-        a: number;
-        b: number;
-        c: number;
-        d: number;
-        tx: number;
-        ty: number;
-    }
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    tx: number;
+    ty: number;
+}
+
+export class Point {
+    constructor(x?: number, y?: number);
 
-    export class Point {
-        constructor(x?: number, y?: number);
+    x: number;
+    y: number;
+}
 
-        x: number;
-        y: number;
-    }
+export class Point3D {
+    constructor(x?: number, y?: number, z?: number);
+
+    x: number;
+    y: number;
+    z: number;
+
+    toGlobalCoordinates(offset?: obelisk.Point): obelisk.Point;
+}
+
+export class ColorGeom {
+    static get32(color: number): number;
+    static applyBrightness(color: number, brightness: number, highlight?: boolean): number;
+}
+
+export class ColorPattern {
+    static GRASS_GREEN: number;
+    static YELLOW: number;
+    static WINE_RED: number;
+    static PINK: number;
+    static PURPLE: number;
+    static BLUE: number;
+    static GRAY: number;
+    static BLACK: number;
+    static FINE_COLORS: number[];
+
+    static getRandomComfortableColor(): number;
+}
+
+export class CanvasTool {
+    static getPixel(imageData: ImageData, x: number, y: number): number;
+}
+
+export class CanvasManager {
+    static defaultCanvas: HTMLCanvasElement;
+
+    static getDefaultCanvas(): HTMLCanvasElement;
+    static getNewCanvas(): HTMLCanvasElement;
+}
+
+export class AbstractColor {
+    constructor();
+
+    inner: number;
+    border: number;
+    borderHighlight: number;
+    left: number;
+    right: number;
+    horizontal: number;
+    leftSlope: number;
+    rightSlope: number;
+}
+
+export class CubeColor extends AbstractColor {
+    constructor(border?: number, borderHighlight?: number, left?: number, right?: number, horizontal?: number);
+
+    BRIGHTNESS_GAIN: number;
+
+    getByHorizontalColor(horizontal: number): CubeColor;
+}
+
+export class PyramidColor extends AbstractColor {
+    constructor(border?: number, borderHighlight?: number, left?: number, right?: number);
+
+    BRIGHTNESS_GAIN: number;
+
+    getByRightColor(horizontal: number): PyramidColor;
+}
+
+export class SideColor extends AbstractColor {
+    constructor(border?: number, inner?: number);
+
+    BRIGHTNESS_GAIN: number;
+
+    getByInnerColor(inner: number): SideColor;
+}
+
+export class SlopeColor extends AbstractColor {
+    constructor(
+        border?: number,
+        borderHighlight?: number,
+        left?: number,
+        right?: number,
+        leftSlope?: number,
+        rightSlope?: number,
+    );
+
+    BRIGHTNESS_GAIN: number;
+
+    getByHorizontalColor(horizontal: number): SlopeColor;
+}
+
+export class LineColor extends AbstractColor {
+    constructor(border?: number, inner?: number);
+}
+
+export class AbstractDimension {
+    constructor();
+
+    xAxis: number;
+    yAxis: number;
+    zAxis: number;
+    tall: boolean;
+}
+
+export class BrickDimension extends AbstractDimension {
+    constructor(xAxis?: number, yAxis?: number);
+}
+
+export class CubeDimension extends AbstractDimension {
+    constructor(xAxis?: number, yAxis?: number, zAxis?: number);
+}
+
+export class PyramidDimension extends AbstractDimension {
+    constructor(axis?: number, tall?: boolean);
+}
+
+export class SideXDimension extends AbstractDimension {
+    constructor(xAxis?: number, zAxis?: number);
+}
+
+export class SideYDimension extends AbstractDimension {
+    constructor(yAxis?: number, zAxis?: number);
+}
 
-    export class Point3D {
-        constructor(x?: number, y?: number, z?: number);
+export class SlopeDimension extends AbstractDimension {
+    constructor(xAxis?: number, yAxis?: number);
+}
 
-        x: number;
-        y: number;
-        z: number;
+export class LineXDimension extends AbstractDimension {
+    constructor(axis?: number);
+}
 
-        toGlobalCoordinates(offset?: obelisk.Point): obelisk.Point;
-    }
+export class LineYDimension extends AbstractDimension {
+    constructor(axis?: number);
+}
+
+export class LineZDimension extends AbstractDimension {
+    constructor(axis?: number);
+}
+
+export class BitmapData {
+    constructor(w: number, h: number, useDefaultCanvas?: boolean);
+
+    imageData: ImageData;
+    canvas: HTMLCanvasElement;
+    context: CanvasRenderingContext2D;
 
-    export class ColorGeom {
-        static get32(color: number): number;
-        static applyBrightness(color: number, brightness: number, highlight?: boolean): number;
-    }
+    setPixel(posX: number, posY: number, color: number): void;
+    setPixelByIndex(index: number, color: number): void;
+    checkPixelAvailable(x: number, y: number): boolean;
+    floodFill(posX: number, posY: number, color: number): void;
+}
 
-    export class ColorPattern {
-        static GRASS_GREEN: number;
-        static YELLOW: number;
-        static WINE_RED: number;
-        static PINK: number;
-        static PURPLE: number;
-        static BLUE: number;
-        static GRAY: number;
-        static BLACK: number;
-        static FINE_COLORS: number[];
+export class PixelObject {
+    constructor(primitive: AbstractPrimitive, point3D?: Point3D);
 
-        static getRandomComfortableColor(): number;
-    }
+    x: number;
+    y: number;
+    canvas: HTMLCanvasElement;
+}
+
+export class PixelView {
+    constructor(canvas: HTMLCanvasElement, point?: Point);
+
+    canvas: HTMLCanvasElement;
+    context: CanvasRenderingContext2D;
+    point: Point;
+
+    renderObject(primitive: AbstractPrimitive, point3D?: Point3D): void;
+    clear(): void;
+}
+
+export class AbstractPrimitive {
+    constructor();
+
+    canvas: HTMLCanvasElement;
+    w: number;
+    h: number;
+    dimension: AbstractDimension;
+    color: AbstractColor;
+    border: boolean;
+    bitmapData: BitmapData;
+    useDefaultCanvas: boolean;
+    matrix: Matrix;
+}
 
-    export class CanvasTool {
-        static getPixel(imageData: ImageData, x: number, y: number): number;
-    }
-
-    export class CanvasManager {
-        static defaultCanvas: HTMLCanvasElement;
-
-        static getDefaultCanvas(): HTMLCanvasElement;
-        static getNewCanvas(): HTMLCanvasElement;
-    }
-
-    export class AbstractColor {
-        constructor();
-
-        inner: number;
-        border: number;
-        borderHighlight: number;
-        left: number;
-        right: number;
-        horizontal: number;
-        leftSlope: number;
-        rightSlope: number;
-    }
-
-    export class CubeColor extends AbstractColor {
-        constructor(border?: number, borderHighlight?: number, left?: number, right?: number, horizontal?: number);
-
-        BRIGHTNESS_GAIN: number;
-
-        getByHorizontalColor(horizontal: number): CubeColor;
-    }
-
-    export class PyramidColor extends AbstractColor {
-        constructor(border?: number, borderHighlight?: number, left?: number, right?: number);
-
-        BRIGHTNESS_GAIN: number;
-
-        getByRightColor(horizontal: number): PyramidColor;
-    }
-
-    export class SideColor extends AbstractColor {
-        constructor(border?: number, inner?: number);
-
-        BRIGHTNESS_GAIN: number;
-
-        getByInnerColor(inner: number): SideColor;
-    }
-
-    export class SlopeColor extends AbstractColor {
-        constructor(border?: number, borderHighlight?: number, left?: number, right?: number, leftSlope?: number, rightSlope?: number);
-
-        BRIGHTNESS_GAIN: number;
-
-        getByHorizontalColor(horizontal: number): SlopeColor;
-    }
-
-    export class LineColor extends AbstractColor {
-        constructor(border?: number, inner?: number);
-    }
-
-    export class AbstractDimension {
-        constructor();
-
-        xAxis: number;
-        yAxis: number;
-        zAxis: number;
-        tall: boolean;
-    }
-
-    export class BrickDimension extends AbstractDimension {
-        constructor(xAxis?: number, yAxis?: number);
-    }
-
-    export class CubeDimension extends AbstractDimension {
-        constructor(xAxis?: number, yAxis?: number, zAxis?: number);
-    }
-
-    export class PyramidDimension extends AbstractDimension {
-        constructor(axis?: number, tall?: boolean);
-    }
-
-    export class SideXDimension extends AbstractDimension {
-        constructor(xAxis?: number, zAxis?: number);
-    }
-
-    export class SideYDimension extends AbstractDimension {
-        constructor(yAxis?: number, zAxis?: number);
-    }
-
-    export class SlopeDimension extends AbstractDimension {
-        constructor(xAxis?: number, yAxis?: number);
-    }
-
-    export class LineXDimension extends AbstractDimension {
-        constructor(axis?: number);
-    }
-
-    export class LineYDimension extends AbstractDimension {
-        constructor(axis?: number);
-    }
-
-    export class LineZDimension extends AbstractDimension {
-        constructor(axis?: number);
-    }
-
-    export class BitmapData {
-        constructor(w: number, h: number, useDefaultCanvas?: boolean);
-
-        imageData: ImageData;
-        canvas: HTMLCanvasElement;
-        context : CanvasRenderingContext2D;
-
-        setPixel(posX: number, posY: number, color: number): void;
-        setPixelByIndex(index: number, color: number): void;
-        checkPixelAvailable(x: number, y: number): boolean;
-        floodFill(posX: number, posY: number, color: number): void;
-    }
-
-    export class PixelObject {
-        constructor(primitive: AbstractPrimitive, point3D?: Point3D);
-
-        x: number;
-        y: number;
-        canvas: HTMLCanvasElement;
-    }
-
-    export class PixelView {
-        constructor(canvas: HTMLCanvasElement, point?: Point);
-
-        canvas: HTMLCanvasElement;
-        context: CanvasRenderingContext2D;
-        point: Point;
-
-        renderObject(primitive: AbstractPrimitive, point3D?: Point3D): void;
-        clear(): void;
-    }
-
-    export class AbstractPrimitive {
-        constructor();
-
-        canvas: HTMLCanvasElement;
-        w: number;
-        h: number;
-        dimension: AbstractDimension;
-        color: AbstractColor;
-        border: boolean;
-        bitmapData: BitmapData;
-        useDefaultCanvas: boolean;
-        matrix: Matrix;
-    }
-
-    export class Brick extends AbstractPrimitive {
-        constructor(dimension?: BrickDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class Cube extends AbstractPrimitive {
-        constructor(dimension?: CubeDimension, color?: CubeColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class Pyramid extends AbstractPrimitive {
-        constructor(dimension?: PyramidDimension, color?: PyramidColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SideX extends AbstractPrimitive {
-        constructor(dimension?: SideXDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SideY extends AbstractPrimitive {
-        constructor(dimension?: SideYDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SlopeEast extends AbstractPrimitive {
-        constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SlopeNorth extends AbstractPrimitive {
-        constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SlopeSouth extends AbstractPrimitive {
-        constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class SlopeWest extends AbstractPrimitive {
-        constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
-    }
-
-    export class LineX extends AbstractPrimitive {
-        constructor(dimension?: LineXDimension, color?: LineColor, useDefaultCanvas?: boolean);
-    }
-
-    export class LineY extends AbstractPrimitive {
-        constructor(dimension?: LineYDimension, color?: LineColor, useDefaultCanvas?: boolean);
-    }
-
-    export class LineZ extends AbstractPrimitive {
-        constructor(dimension?: LineZDimension, color?: LineColor, useDefaultCanvas?: boolean);
-    }
+export class Brick extends AbstractPrimitive {
+    constructor(dimension?: BrickDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class Cube extends AbstractPrimitive {
+    constructor(dimension?: CubeDimension, color?: CubeColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class Pyramid extends AbstractPrimitive {
+    constructor(dimension?: PyramidDimension, color?: PyramidColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SideX extends AbstractPrimitive {
+    constructor(dimension?: SideXDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SideY extends AbstractPrimitive {
+    constructor(dimension?: SideYDimension, color?: SideColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SlopeEast extends AbstractPrimitive {
+    constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SlopeNorth extends AbstractPrimitive {
+    constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SlopeSouth extends AbstractPrimitive {
+    constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class SlopeWest extends AbstractPrimitive {
+    constructor(dimension?: SlopeDimension, color?: SlopeColor, border?: boolean, useDefaultCanvas?: boolean);
+}
+
+export class LineX extends AbstractPrimitive {
+    constructor(dimension?: LineXDimension, color?: LineColor, useDefaultCanvas?: boolean);
+}
+
+export class LineY extends AbstractPrimitive {
+    constructor(dimension?: LineYDimension, color?: LineColor, useDefaultCanvas?: boolean);
+}
+
+export class LineZ extends AbstractPrimitive {
+    constructor(dimension?: LineZDimension, color?: LineColor, useDefaultCanvas?: boolean);
 }

From 0bb06233bd7a9595be5e4c249955a2b98ce599bc Mon Sep 17 00:00:00 2001
From: Hinaser <rindo.hinase@gmail.com>
Date: Sat, 26 Jan 2019 16:35:44 +0900
Subject: [PATCH 21/61] Restructured to more appropriate type definition

---
 types/uuidv4/index.d.ts | 40 ++++++++++++----------------------------
 1 file changed, 12 insertions(+), 28 deletions(-)

diff --git a/types/uuidv4/index.d.ts b/types/uuidv4/index.d.ts
index e181a39244..44f8fc4efe 100644
--- a/types/uuidv4/index.d.ts
+++ b/types/uuidv4/index.d.ts
@@ -3,32 +3,16 @@
 // Definitions by: Rindo Hinase <https://github.com/Hinaser>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
-declare const uuidv4: UUIDv4;
-
-interface UUIDv4_is {
-    (value: string): boolean;
-}
-
-type EmptyUUIDv4 = '00000000-0000-0000-0000-000000000000';
-
-interface UUIDv4_empty {
-    (): string;
-}
-
-interface UUIDv4_FromString {
-    (text: string): string;
-}
-
-interface UUIDv4 {
-    (): string;
-    is: UUIDv4_is;
-    empty: UUIDv4_empty;
-    fromString: UUIDv4_FromString;
-}
-
-// If you read this because linter warns you like '... has no default export'
-// please try to write import statement like
-//     import * as uuidv4 from 'uuidv4'
-// rather than
-//     import uuidv4 from 'uuidv4'
 export = uuidv4;
+
+declare function uuidv4(): string;
+
+declare namespace uuidv4 {
+    type EmptyUUIDv4 = '00000000-0000-0000-0000-000000000000';
+
+    function is(value: string): boolean;
+
+    function empty(): string;
+
+    function fromString(text: string): string;
+}

From 24106b4e6da5c5b99441855b00a579224660fca2 Mon Sep 17 00:00:00 2001
From: Josias Iquabius <iquabius@gmail.com>
Date: Sat, 26 Jan 2019 09:04:58 -0300
Subject: [PATCH 22/61] Add ErrorTestAppWithState to Next.js' tests

---
 types/next/test/next-app-tests.tsx | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/types/next/test/next-app-tests.tsx b/types/next/test/next-app-tests.tsx
index eaa2c0ad07..514cc24436 100644
--- a/types/next/test/next-app-tests.tsx
+++ b/types/next/test/next-app-tests.tsx
@@ -6,6 +6,10 @@ interface TestAppProps {
     pageProps: any;
 }
 
+interface TestAppState {
+    color: string;
+}
+
 interface TypedQuery extends DefaultQuery {
     id?: string;
 }
@@ -33,6 +37,20 @@ class TestAppWithProps extends App<TestAppProps & WithExampleProps> {
     }
 }
 
+class ErrorTestAppWithState extends App<TestAppProps & WithExampleProps, TestAppState> {
+    static async getInitialProps({ Component, router, ctx }: NextAppContext) {
+        const pageProps = Component.getInitialProps && (await Component.getInitialProps(ctx));
+        return { pageProps };
+    }
+
+    render() {
+        const { Component, router, pageProps, example } = this.props;
+        return <Component {...pageProps} example={example} />;
+    }
+
+    state: {}; // $ExpectError
+}
+
 class TestAppWithTypedQuery extends App {
     static async getInitialProps({ ctx }: NextAppContext<TypedQuery>) {
         const { id } = ctx.query;

From daac60683d589dc6dd84ad6c61f9c0a9bd4a7b3d Mon Sep 17 00:00:00 2001
From: Vincent Langlet <VincentLanglet@users.noreply.github.com>
Date: Sat, 26 Jan 2019 13:08:10 +0100
Subject: [PATCH 23/61] Update enzyme-tests.tsx

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

diff --git a/types/enzyme/enzyme-tests.tsx b/types/enzyme/enzyme-tests.tsx
index 879f06dc3c..b92f553584 100644
--- a/types/enzyme/enzyme-tests.tsx
+++ b/types/enzyme/enzyme-tests.tsx
@@ -868,10 +868,10 @@ function ReactWrapperTest() {
 
     function test_component_type() {
       const wrapper1 = shallow(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
-      wrapper1.find(ComponentType);
+      wrapper1.find(ComponentType).props().stringProp; // $ExpectType string
 
       const wrapper2 = mount(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
-      wrapper2.find(ComponentType);
+      wrapper2.find(ComponentType).props().stringProp; // $ExpectType string
     }
 }
 

From fba358da45c6dda900a64c299bb08055de535e65 Mon Sep 17 00:00:00 2001
From: Vincent Langlet <VincentLanglet@users.noreply.github.com>
Date: Sat, 26 Jan 2019 13:27:05 +0100
Subject: [PATCH 24/61] Update enzyme-tests.tsx

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

diff --git a/types/enzyme/enzyme-tests.tsx b/types/enzyme/enzyme-tests.tsx
index b92f553584..0c7e2c2e90 100644
--- a/types/enzyme/enzyme-tests.tsx
+++ b/types/enzyme/enzyme-tests.tsx
@@ -868,10 +868,10 @@ function ReactWrapperTest() {
 
     function test_component_type() {
       const wrapper1 = shallow(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
-      wrapper1.find(ComponentType).props().stringProp; // $ExpectType string
+      wrapper1.find<MyComponentProps>(ComponentType).props().stringProp; // $ExpectType string
 
       const wrapper2 = mount(<div><ComponentType stringProp={"S"} numberProp={1} /></div>);
-      wrapper2.find(ComponentType).props().stringProp; // $ExpectType string
+      wrapper2.find<MyComponentProps>(ComponentType).props().stringProp; // $ExpectType string
     }
 }
 

From 068b736687abcd792ad46d65d5d932003bdaf80c Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Sat, 26 Jan 2019 12:50:21 +0000
Subject: [PATCH 25/61] Revert tsconfig.json

---
 types/react-jss/tsconfig.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/types/react-jss/tsconfig.json b/types/react-jss/tsconfig.json
index bd1b3e736c..161f1a346c 100644
--- a/types/react-jss/tsconfig.json
+++ b/types/react-jss/tsconfig.json
@@ -15,7 +15,7 @@
         "noEmit": true,
         "forceConsistentCasingInFileNames": true,
         "jsx": "react",
-        "strictFunctionTypes": false
+        "strictFunctionTypes": true
     },
     "files": [
         "index.d.ts",

From e8582cee865f01c9c7fd77c7350d639ff074ad26 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Sat, 26 Jan 2019 12:50:55 +0000
Subject: [PATCH 26/61] Widening the return type seems to fix the issue - but
 I'm still not sure why?

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

diff --git a/types/react-jss/react-jss-tests.tsx b/types/react-jss/react-jss-tests.tsx
index 9e2bf9a376..4895aa9682 100644
--- a/types/react-jss/react-jss-tests.tsx
+++ b/types/react-jss/react-jss-tests.tsx
@@ -17,8 +17,8 @@ interface MyTheme {
 /**
  * helper function to counter typescripts type widening
  */
-function createStyles<Props = {}, C extends string = string>(styles: Styles<C, Props>): Styles<C, Props> {
-  return styles;
+function createStyles<Props = {}, C extends string = string>(styles: Styles<C, Props>): Styles<C> {
+  return styles as Styles<C>;
 }
 
 interface ButtonProps {

From 2509b847fc45b601c44b0f47e2b4e314a09113b7 Mon Sep 17 00:00:00 2001
From: David Lechner <david@lechnology.com>
Date: Sat, 26 Jan 2019 17:33:50 -0600
Subject: [PATCH 27/61] [ssh2-streams] Add test for fastGet and fastPut
 overloads

This adds a test for the overloads of fastGet and fastPut that include
the optional TranferOptions parameter.
---
 types/ssh2-streams/index.d.ts            | 2 +-
 types/ssh2-streams/ssh2-streams-tests.ts | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/types/ssh2-streams/index.d.ts b/types/ssh2-streams/index.d.ts
index 690145ec17..54d6359538 100644
--- a/types/ssh2-streams/index.d.ts
+++ b/types/ssh2-streams/index.d.ts
@@ -1628,7 +1628,7 @@ export interface TransferOptions {
      * Called every time a part of a file was transferred
      */
     step?: (total_transferred: number, chunk: number, total: number) => void;
-    
+
     /**
      * Integer or string representing the file mode to set for the uploaded file.
      */
diff --git a/types/ssh2-streams/ssh2-streams-tests.ts b/types/ssh2-streams/ssh2-streams-tests.ts
index 9ae121a454..7fd73756d5 100644
--- a/types/ssh2-streams/ssh2-streams-tests.ts
+++ b/types/ssh2-streams/ssh2-streams-tests.ts
@@ -102,4 +102,6 @@ sftp.createReadStream("path");
 sftp.createWriteStream("path");
 sftp.data(0, buffer);
 sftp.fastGet("remotePath", "localPath", () => {});
-sftp.fastPut("localPath", "remotePath", () => {});
\ No newline at end of file
+sftp.fastGet("remotePath", "localPath", { concurrency: 64, chunkSize: 32768, step: () => {} }, () => {});
+sftp.fastPut("localPath", "remotePath", () => {});
+sftp.fastPut("localPath", "remotePath", { concurrency: 64, chunkSize: 32768, step: () => {}, mode: '0755' }, () => {});

From 966470e9e5f06e80625a2fa6d89ec1663aed7efd Mon Sep 17 00:00:00 2001
From: Denis Cappellin <denis-11@cappell.in>
Date: Sun, 27 Jan 2019 12:10:10 +0100
Subject: [PATCH 28/61] Add missing definition for writeLong

---
 types/bytebuffer/index.d.ts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/types/bytebuffer/index.d.ts b/types/bytebuffer/index.d.ts
index bafed6edf8..eaa1a509d5 100644
--- a/types/bytebuffer/index.d.ts
+++ b/types/bytebuffer/index.d.ts
@@ -127,7 +127,7 @@ declare class ByteBuffer
      * Calculates the number of UTF8 characters of a string.JavaScript itself uses UTF- 16, so that a string's length property does not reflect its actual UTF8 size if it contains code points larger than 0xFFFF.
      */
     static calculateUTF8Chars( str: string ): number;
-    
+
     /**
      * Calculates the number of UTF8 bytes of a string. This is an alias of ByteBuffer#calculateUTF8Bytes.
      */
@@ -574,6 +574,11 @@ declare class ByteBuffer
      */
     writeInt8( value: number, offset?: number ): ByteBuffer;
 
+    /**
+     * Write a 64bit signed integer. This is an alias of ByteBuffer#writeInt64.
+     */
+     writeLong( value: number | Long, offset?: number ): ByteBuffer;
+
     /**
      * Writes a 16bit signed integer. This is an alias of ByteBuffer#writeInt16.
      */

From 5a05abfba06b5a64de3b0de770f28aa02c793cd4 Mon Sep 17 00:00:00 2001
From: Dolan Miu <dolan_miu@hotmail.com>
Date: Sun, 27 Jan 2019 17:47:55 +0000
Subject: [PATCH 29/61] Export RepositoryInitOptions

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

diff --git a/types/nodegit/index.d.ts b/types/nodegit/index.d.ts
index d1afcd6ea4..704ff9b037 100644
--- a/types/nodegit/index.d.ts
+++ b/types/nodegit/index.d.ts
@@ -79,7 +79,7 @@ export { Refspec } from './ref-spec';
 export { Reference } from './reference';
 export { RemoteCallbacks } from './remote-callbacks';
 export { Remote } from './remote';
-export { Repository } from './repository';
+export { Repository, RepositoryInitOptions } from './repository';
 export { Reset } from './reset';
 export { Revparse } from './rev-parse';
 export { Revwalk } from './rev-walk';

From 7f27ae1f9169cdf2225fb89466d44cbaa1f6cf88 Mon Sep 17 00:00:00 2001
From: Dolan Miu <dolan_miu@hotmail.com>
Date: Sun, 27 Jan 2019 17:49:49 +0000
Subject: [PATCH 30/61] Version bump

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

diff --git a/types/nodegit/index.d.ts b/types/nodegit/index.d.ts
index 704ff9b037..680aec7174 100644
--- a/types/nodegit/index.d.ts
+++ b/types/nodegit/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for nodegit 0.22
+// Type definitions for nodegit 0.24
 // Project: https://github.com/nodegit/nodegit
 // Definitions by: Dolan Miu <https://github.com/dolanmiu>, Tobias Nießen <https://github.com/tniessen>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

From 3317a1c2cf540224a0d9630a281b3c7cfe99a3b0 Mon Sep 17 00:00:00 2001
From: Oliver Joseph Ash <oliverjash@gmail.com>
Date: Mon, 28 Jan 2019 07:11:27 +0000
Subject: [PATCH 31/61] Revert "Fix RefForwardingComponent argument type.
 (#30373)" (#32343)

This reverts commit 0d49c9a4c64f865be4b5d5cd5833110c56ca301a.
---
 types/react-is/react-is-tests.tsx | 2 +-
 types/react/index.d.ts            | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/types/react-is/react-is-tests.tsx b/types/react-is/react-is-tests.tsx
index afbf0aabb6..d41b2a828b 100644
--- a/types/react-is/react-is-tests.tsx
+++ b/types/react-is/react-is-tests.tsx
@@ -6,7 +6,7 @@ import * as ReactIs from 'react-is';
 // Determining if a Component is Valid
 
 interface CompProps {
-    forwardedRef: React.Ref<any> | null;
+    forwardedRef: React.Ref<any>;
     children?: React.ReactNode;
 }
 
diff --git a/types/react/index.d.ts b/types/react/index.d.ts
index e561e8f131..52c6a63b80 100644
--- a/types/react/index.d.ts
+++ b/types/react/index.d.ts
@@ -475,7 +475,7 @@ declare namespace React {
     }
 
     interface RefForwardingComponent<T, P = {}> {
-        (props: P & { children?: ReactNode }, ref: Ref<T> | null): ReactElement<any> | null;
+        (props: P & { children?: ReactNode }, ref: Ref<T>): ReactElement<any> | null;
         propTypes?: WeakValidationMap<P>;
         contextTypes?: ValidationMap<any>;
         defaultProps?: Partial<P>;

From 9c52db4e04dba26365933c5a0833f092b36229a8 Mon Sep 17 00:00:00 2001
From: Kyle Uehlein <kyleuehlein@gmail.com>
Date: Mon, 28 Jan 2019 11:35:10 -0500
Subject: [PATCH 32/61] [@types/node] add definition for child_process.execFile
 options

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

diff --git a/types/node/index.d.ts b/types/node/index.d.ts
index c63b6c892b..417782b2f3 100644
--- a/types/node/index.d.ts
+++ b/types/node/index.d.ts
@@ -32,6 +32,7 @@
 //                 Zane Hannan AU <https://github.com/ZaneHannanAU>
 //                 Jeremie Rodriguez <https://github.com/jeremiergz>
 //                 Samuel Ainsworth <https://github.com/samuela>
+//                 Kyle Uehlein <https://github.com/kuehlein>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 /** inspector module types */
@@ -2886,6 +2887,7 @@ declare module "child_process" {
         gid?: number;
         windowsHide?: boolean;
         windowsVerbatimArguments?: boolean;
+        shell?: boolean | string;
     }
     interface ExecFileOptionsWithStringEncoding extends ExecFileOptions {
         encoding: BufferEncoding;

From d3dc58f92271d04961b9bf8e97a20e87af2ffc7f Mon Sep 17 00:00:00 2001
From: taozhi8833998 <taozhi8833998@163.com>
Date: Tue, 29 Jan 2019 01:11:52 +0800
Subject: [PATCH 33/61] Added type definitions for node-sql-parser

---
 types/node-sql-parser/index.d.ts              | 97 +++++++++++++++++++
 .../node-sql-parser/node-sql-parser-tests.ts  | 19 ++++
 types/node-sql-parser/tsconfig.json           | 25 +++++
 types/node-sql-parser/tslint.json             |  1 +
 4 files changed, 142 insertions(+)
 create mode 100644 types/node-sql-parser/index.d.ts
 create mode 100644 types/node-sql-parser/node-sql-parser-tests.ts
 create mode 100644 types/node-sql-parser/tsconfig.json
 create mode 100644 types/node-sql-parser/tslint.json

diff --git a/types/node-sql-parser/index.d.ts b/types/node-sql-parser/index.d.ts
new file mode 100644
index 0000000000..c711212c63
--- /dev/null
+++ b/types/node-sql-parser/index.d.ts
@@ -0,0 +1,97 @@
+// Type definitions for node-sql-parser 1.0
+// Project: https://github.com/taozhi8833998/node-sql-parser#readme
+// Definitions by: taozhi8833998 <https://github.com/taozhi8833998>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.4
+
+export interface With {
+  name: string;
+  stmt: any[];
+  columns?: any[];
+}
+export type WhilteListCheckMode = 'table' | 'column';
+export interface TableColumnAst {
+  tableList: string[];
+  columnsList: string[];
+  ast: AST[] | AST;
+}
+export interface From {
+  db: string | null;
+  table: string;
+  as: string | null;
+}
+export interface Dual {
+  type: 'dual';
+}
+export interface Limit {
+  type: string;
+  value: number;
+}
+export interface OrderBy {
+  type: 'ASC' | 'DESC';
+  expr: any;
+}
+export interface ColumnRef {
+  type: 'column_ref';
+  table: string | null;
+  column: string;
+}
+export interface SetList {
+  column: string;
+  value: any;
+  table: string | null;
+}
+export interface InsertReplaceValue {
+  type: 'expr_list';
+  value: any[];
+}
+export interface Select {
+  with: With | null;
+  type: 'select';
+  options: any[] | null;
+  distinct: 'DISTINCT' | null;
+  columns: any[] | '*';
+  from: Array<From | Dual> | null;
+  where: any;
+  groupby: ColumnRef[] | null;
+  having: any[] | null;
+  orderby: OrderBy[] | null;
+  limit: Limit[] | null;
+}
+export interface Insert_Replace {
+  type: 'replace' | 'insert';
+  db: string | null;
+  table: string;
+  columns: string[] | null;
+  values: InsertReplaceValue[];
+}
+export interface Update {
+  type: 'udpate';
+  db: string | null;
+  table: string;
+  set: SetList[];
+  where: any;
+}
+export interface Delete {
+  type: 'delete';
+  tables: any;
+  from: Array<From | Dual>;
+  where: any;
+}
+export type AST = Select | Insert_Replace | Update | Delete;
+
+export class Parser {
+  constructor();
+
+  parse(sql: string): TableColumnAst;
+
+  astify(sql: string): AST[] | AST;
+
+  sqlify(ast: AST[] | AST): string;
+
+  whiteListCheck(sql: string, whiteList: string[], type?: WhilteListCheckMode): Error | undefined;
+
+  tableList(sql: string): string[];
+
+  columnList(sql: string): string[];
+}
diff --git a/types/node-sql-parser/node-sql-parser-tests.ts b/types/node-sql-parser/node-sql-parser-tests.ts
new file mode 100644
index 0000000000..050c69a855
--- /dev/null
+++ b/types/node-sql-parser/node-sql-parser-tests.ts
@@ -0,0 +1,19 @@
+import { Parser } from 'node-sql-parser';
+
+const parser = new Parser();
+const sql = 'select id from tableA';
+
+// $ExpectType Select | Insert_Replace | Update | Delete | AST[]
+const selectAst = parser.astify(sql);
+
+// $ExpectType string
+parser.sqlify(selectAst);
+
+// $ExpectType string[]
+parser.tableList(sql);
+
+// $ExpectType string[]
+parser.columnList(sql);
+
+// $ExpectType Error | undefined
+parser.whiteListCheck(sql, ['select::null::tableA'], 'table');
diff --git a/types/node-sql-parser/tsconfig.json b/types/node-sql-parser/tsconfig.json
new file mode 100644
index 0000000000..c7f24afb95
--- /dev/null
+++ b/types/node-sql-parser/tsconfig.json
@@ -0,0 +1,25 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "node-sql-parser-tests.ts"
+    ]
+}
diff --git a/types/node-sql-parser/tslint.json b/types/node-sql-parser/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/node-sql-parser/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From 06261e9c3998e4080dadb903882e6415bf44e295 Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <thoma471@googlemail.com>
Date: Mon, 28 Jan 2019 19:23:11 +0100
Subject: [PATCH 34/61] Added typings for Next-seo

---
 types/next-seo/index.d.ts        | 85 ++++++++++++++++++++++++++++++++
 types/next-seo/next-seo-tests.ts | 48 ++++++++++++++++++
 types/next-seo/tsconfig.json     | 25 ++++++++++
 types/next-seo/tslint.json       |  1 +
 4 files changed, 159 insertions(+)
 create mode 100644 types/next-seo/index.d.ts
 create mode 100644 types/next-seo/next-seo-tests.ts
 create mode 100644 types/next-seo/tsconfig.json
 create mode 100644 types/next-seo/tslint.json

diff --git a/types/next-seo/index.d.ts b/types/next-seo/index.d.ts
new file mode 100644
index 0000000000..a3542c9fe9
--- /dev/null
+++ b/types/next-seo/index.d.ts
@@ -0,0 +1,85 @@
+// Type definitions for next-seo 1.10
+// Project: https://github.com/garmeeh/next-seo#readme
+// Definitions by: Thomas Kosiewski <https://github.com/ThomasK33>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+import { Component } from "react";
+
+declare module "next-seo" {
+    interface INextSeoProps {
+        config: IConfig;
+    }
+
+    interface IConfig {
+        title?: string;
+        titleTemplate?: string;
+        description?: string;
+        canonical?: string;
+
+        dangerouslySetAllPagesToNoIndex?: boolean;
+        noindex?: boolean;
+
+        twitter?: ITwitter;
+        facebook?: IFacebook;
+        openGraph?: IOpenGraph;
+    }
+
+    interface ITwitter {
+        cardType?: string;
+        site?: string;
+        handle?: string;
+    }
+
+    interface IFacebook {
+        appId?: number;
+    }
+
+    interface IOpenGraph {
+        url?: string;
+        type?: string;
+        title?: string;
+        description?: string;
+        images?: ReadonlyArray<IOpenGraphImages>;
+        defaultImageHeight?: number;
+        defaultImageWidth?: number;
+        locale?: string;
+        site_name?: string;
+
+        profile?: IOpenGraphProfile;
+        book?: IOpenGraphBook;
+        article?: IOpenGraphArticle;
+    }
+
+    interface IOpenGraphImages {
+        url?: string,
+        width?: number,
+        height?: number,
+        alt?: string,
+    }
+
+    interface IOpenGraphProfile {
+        firstName?: string;
+        lastName?: string;
+        username?: string;
+        gender?: string;
+    }
+
+    interface IOpenGraphBook {
+        authors?: ReadonlyArray<string>;
+        isbn?: string;
+        releaseDate?: string;
+        tags?: ReadonlyArray<string>;
+    }
+
+    interface IOpenGraphArticle {
+        publishedTime?: string;
+        modifiedTime?: string;
+        expirationTime?: string;
+
+        authors?: ReadonlyArray<string>;
+        section?: string;
+        tags?: ReadonlyArray<string>;
+    }
+
+    export default class NextSeo extends Component<INextSeoProps> { }
+}
diff --git a/types/next-seo/next-seo-tests.ts b/types/next-seo/next-seo-tests.ts
new file mode 100644
index 0000000000..3c2da4b032
--- /dev/null
+++ b/types/next-seo/next-seo-tests.ts
@@ -0,0 +1,48 @@
+import NextSeo from 'next-seo';
+
+new NextSeo({
+    config: {
+        canonical: "",
+        dangerouslySetAllPagesToNoIndex: false,
+        description: "",
+        facebook: {
+            appId: 0,
+        },
+        noindex: false,
+        openGraph: {
+            book: {
+                authors: [""],
+                isbn: "",
+                releaseDate: "",
+                tags: [""],
+            },
+            defaultImageHeight: 0,
+            defaultImageWidth: 0,
+            description: "",
+            images: [{
+                alt: "",
+                height: 0,
+                url: "",
+                width: 0,
+            }],
+            locale: "",
+            profile: {
+                firstName: "",
+                gender: "",
+                lastName: "",
+                username: "",
+            },
+            site_name: "",
+            title: "",
+            type: "",
+            url: "",
+        },
+        title: "",
+        titleTemplate: "",
+        twitter: {
+            cardType: "",
+            handle: "",
+            site: "",
+        },
+    },
+});
diff --git a/types/next-seo/tsconfig.json b/types/next-seo/tsconfig.json
new file mode 100644
index 0000000000..faea26b9bc
--- /dev/null
+++ b/types/next-seo/tsconfig.json
@@ -0,0 +1,25 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "target": "es6",
+        "jsx": "react",
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "next-seo-tests.ts"
+    ]
+}
diff --git a/types/next-seo/tslint.json b/types/next-seo/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/next-seo/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From ac4b9e6cdd80c9bcda463b8024ae501cf5732cdd Mon Sep 17 00:00:00 2001
From: Thomas Kosiewski <thoma471@googlemail.com>
Date: Mon, 28 Jan 2019 19:44:37 +0100
Subject: [PATCH 35/61] Next-seo: Test fixes

---
 types/next-seo/index.d.ts | 153 +++++++++++++++++++-------------------
 1 file changed, 76 insertions(+), 77 deletions(-)

diff --git a/types/next-seo/index.d.ts b/types/next-seo/index.d.ts
index a3542c9fe9..8d7c487393 100644
--- a/types/next-seo/index.d.ts
+++ b/types/next-seo/index.d.ts
@@ -2,84 +2,83 @@
 // Project: https://github.com/garmeeh/next-seo#readme
 // Definitions by: Thomas Kosiewski <https://github.com/ThomasK33>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.8
 
 import { Component } from "react";
 
-declare module "next-seo" {
-    interface INextSeoProps {
-        config: IConfig;
-    }
-
-    interface IConfig {
-        title?: string;
-        titleTemplate?: string;
-        description?: string;
-        canonical?: string;
-
-        dangerouslySetAllPagesToNoIndex?: boolean;
-        noindex?: boolean;
-
-        twitter?: ITwitter;
-        facebook?: IFacebook;
-        openGraph?: IOpenGraph;
-    }
-
-    interface ITwitter {
-        cardType?: string;
-        site?: string;
-        handle?: string;
-    }
-
-    interface IFacebook {
-        appId?: number;
-    }
-
-    interface IOpenGraph {
-        url?: string;
-        type?: string;
-        title?: string;
-        description?: string;
-        images?: ReadonlyArray<IOpenGraphImages>;
-        defaultImageHeight?: number;
-        defaultImageWidth?: number;
-        locale?: string;
-        site_name?: string;
-
-        profile?: IOpenGraphProfile;
-        book?: IOpenGraphBook;
-        article?: IOpenGraphArticle;
-    }
-
-    interface IOpenGraphImages {
-        url?: string,
-        width?: number,
-        height?: number,
-        alt?: string,
-    }
-
-    interface IOpenGraphProfile {
-        firstName?: string;
-        lastName?: string;
-        username?: string;
-        gender?: string;
-    }
-
-    interface IOpenGraphBook {
-        authors?: ReadonlyArray<string>;
-        isbn?: string;
-        releaseDate?: string;
-        tags?: ReadonlyArray<string>;
-    }
-
-    interface IOpenGraphArticle {
-        publishedTime?: string;
-        modifiedTime?: string;
-        expirationTime?: string;
-
-        authors?: ReadonlyArray<string>;
-        section?: string;
-        tags?: ReadonlyArray<string>;
-    }
-
-    export default class NextSeo extends Component<INextSeoProps> { }
+export interface NextSeoProps {
+    config: Config;
 }
+
+export interface Config {
+    title?: string;
+    titleTemplate?: string;
+    description?: string;
+    canonical?: string;
+
+    dangerouslySetAllPagesToNoIndex?: boolean;
+    noindex?: boolean;
+
+    twitter?: Twitter;
+    facebook?: Facebook;
+    openGraph?: OpenGraph;
+}
+
+export interface Twitter {
+    cardType?: string;
+    site?: string;
+    handle?: string;
+}
+
+export interface Facebook {
+    appId?: number;
+}
+
+export interface OpenGraph {
+    url?: string;
+    type?: string;
+    title?: string;
+    description?: string;
+    images?: ReadonlyArray<OpenGraphImages>;
+    defaultImageHeight?: number;
+    defaultImageWidth?: number;
+    locale?: string;
+    site_name?: string;
+
+    profile?: OpenGraphProfile;
+    book?: OpenGraphBook;
+    article?: OpenGraphArticle;
+}
+
+export interface OpenGraphImages {
+    url?: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+}
+
+export interface OpenGraphProfile {
+    firstName?: string;
+    lastName?: string;
+    username?: string;
+    gender?: string;
+}
+
+export interface OpenGraphBook {
+    authors?: ReadonlyArray<string>;
+    isbn?: string;
+    releaseDate?: string;
+    tags?: ReadonlyArray<string>;
+}
+
+export interface OpenGraphArticle {
+    publishedTime?: string;
+    modifiedTime?: string;
+    expirationTime?: string;
+
+    authors?: ReadonlyArray<string>;
+    section?: string;
+    tags?: ReadonlyArray<string>;
+}
+
+export default class NextSeo extends Component<NextSeoProps> { }

From 0059907e00c0293e534cfe57dfd10d48679f4204 Mon Sep 17 00:00:00 2001
From: James Lawrence <jlaw90@hotmail.com>
Date: Mon, 28 Jan 2019 18:53:34 +0000
Subject: [PATCH 36/61] Disable no-unnecessary-generics test

---
 types/react-jss/react-jss-tests.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/types/react-jss/react-jss-tests.tsx b/types/react-jss/react-jss-tests.tsx
index 4895aa9682..0ba2ee3d8b 100644
--- a/types/react-jss/react-jss-tests.tsx
+++ b/types/react-jss/react-jss-tests.tsx
@@ -17,6 +17,7 @@ interface MyTheme {
 /**
  * helper function to counter typescripts type widening
  */
+// tslint:disable-next-line:no-unnecessary-generics
 function createStyles<Props = {}, C extends string = string>(styles: Styles<C, Props>): Styles<C> {
   return styles as Styles<C>;
 }

From 754b2a35843567a6b2eb5ad0f275132671e46d24 Mon Sep 17 00:00:00 2001
From: Elizabeth Samuel <elizs@microsoft.com>
Date: Mon, 28 Jan 2019 11:20:10 -0800
Subject: [PATCH 37/61] [office-js] [office-js-preview] Fix occurrence typos
 (#32551)

---
 types/office-js-preview/index.d.ts | 12 ++++++------
 types/office-js/index.d.ts         | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/types/office-js-preview/index.d.ts b/types/office-js-preview/index.d.ts
index fab2c5095a..75e9ed910f 100644
--- a/types/office-js-preview/index.d.ts
+++ b/types/office-js-preview/index.d.ts
@@ -10844,8 +10844,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>
@@ -12648,8 +12648,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>
@@ -14303,8 +14303,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>
diff --git a/types/office-js/index.d.ts b/types/office-js/index.d.ts
index 0c13640c74..f0fee147ba 100644
--- a/types/office-js/index.d.ts
+++ b/types/office-js/index.d.ts
@@ -10844,8 +10844,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>
@@ -12648,8 +12648,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>
@@ -14303,8 +14303,8 @@ declare namespace Office {
          *   </tr>
          *   <tr>
          *     <td>Appointment items</td>
-         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurence.</td>
-         *     <td>IPM.Appointment,IPM.Appointment.Occurence</td>
+         *     <td>These are calendar items of the item class IPM.Appointment or IPM.Appointment.Occurrence.</td>
+         *     <td>IPM.Appointment,IPM.Appointment.Occurrence</td>
          *   </tr>
          *   <tr>
          *     <td>Message items</td>

From 5614607c3b565bcd927cc3d8d0191336a757232c Mon Sep 17 00:00:00 2001
From: Kasra Bigdeli <kasra85@gmail.com>
Date: Mon, 28 Jan 2019 11:26:19 -0800
Subject: [PATCH 38/61] Updated Dockerode Service definition (#32508)

* Updated Dockerode Service definition

Added logs to Service definition of Dockerode. Service, similar to Container, has log related methods:
https://github.com/apocas/dockerode/blob/master/lib/service.js#L140
https://github.com/apocas/dockerode/blob/master/lib/container.js#L990

* Removed name from authors

* Removed whitespace
---
 types/dockerode/index.d.ts | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/types/dockerode/index.d.ts b/types/dockerode/index.d.ts
index bdbda1ed95..0581057dea 100644
--- a/types/dockerode/index.d.ts
+++ b/types/dockerode/index.d.ts
@@ -174,6 +174,10 @@ declare namespace Dockerode {
 
     update(options: {}, callback: Callback<any>): void;
     update(options: {}): Promise<any>;
+
+    logs(options: ContainerLogsOptions, callback: Callback<NodeJS.ReadableStream>): void;
+    logs(callback: Callback<NodeJS.ReadableStream>): void;
+    logs(options?: ContainerLogsOptions): Promise<NodeJS.ReadableStream>;
   }
 
   class Task {

From 5578dc104ff1381d4e5629c24426202a488ba517 Mon Sep 17 00:00:00 2001
From: Manav Mishra <30835480+manav-m@users.noreply.github.com>
Date: Tue, 29 Jan 2019 01:00:43 +0530
Subject: [PATCH 39/61] Breakpoints can be arbitrary according to
 documentation. (#32414)

Change Typings to accomodate that.
---
 types/react-grid-layout/index.d.ts            | 19 +++++++-------
 .../react-grid-layout-tests.tsx               | 25 +++++++++++++++++++
 2 files changed, 35 insertions(+), 9 deletions(-)

diff --git a/types/react-grid-layout/index.d.ts b/types/react-grid-layout/index.d.ts
index 91c8ad1f9c..c643e976c3 100644
--- a/types/react-grid-layout/index.d.ts
+++ b/types/react-grid-layout/index.d.ts
@@ -4,6 +4,7 @@
 //                 Ali Taheri <https://github.com/alitaheri>,
 //                 Zheyang Song <https://github.com/ZheyangSong>,
 //                 Andrew Hathaway <https://github.com/andrewhathaway>
+//                 Manav Mishra <https://github.com/manav-m>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
@@ -12,11 +13,11 @@ import * as React from "react";
 export as namespace ReactGridLayout;
 export = ReactGridLayout;
 
-declare class ReactGridLayout extends React.Component<ReactGridLayout.ReactGridLayoutProps> { }
+declare class ReactGridLayout extends React.Component<
+    ReactGridLayout.ReactGridLayoutProps
+> {}
 
 declare namespace ReactGridLayout {
-    type Breakpoints = 'lg' | 'md' | 'sm' | 'xs' | 'xxs';
-
     interface Layout {
         /**
          * A string corresponding to the component key.
@@ -85,9 +86,9 @@ declare namespace ReactGridLayout {
         isResizable?: boolean;
     }
 
-    type Layouts = {
-        [P in Breakpoints]?: Layout[];
-    };
+    interface Layouts {
+        [P: string]: Layout[];
+    }
 
     type ItemCallback = (
         layout: Layout[],
@@ -263,12 +264,12 @@ declare namespace ReactGridLayout {
          *
          * Breakpoint names are arbitrary but must match in the cols and layouts objects.
          */
-        breakpoints?: {[P in Breakpoints]: number };
+        breakpoints?: { [P: string]: number };
 
         /**
          * Number of cols. This is a breakpoint -> cols map, e.g. `{lg: 12, md: 10, ...}`.
          */
-        cols?: {[P in Breakpoints]: number };
+        cols?: { [P: string]: number };
 
         /**
          * layouts is an object mapping breakpoints to layouts.
@@ -298,7 +299,7 @@ declare namespace ReactGridLayout {
         ): void;
     }
 
-    class Responsive extends React.Component<ResponsiveProps> { }
+    class Responsive extends React.Component<ResponsiveProps> {}
 
     interface WidthProviderProps {
         /**
diff --git a/types/react-grid-layout/react-grid-layout-tests.tsx b/types/react-grid-layout/react-grid-layout-tests.tsx
index 78ecf594ef..70c88bae0d 100644
--- a/types/react-grid-layout/react-grid-layout-tests.tsx
+++ b/types/react-grid-layout/react-grid-layout-tests.tsx
@@ -54,6 +54,31 @@ class ResponsiveGridTest extends React.Component {
   }
 }
 
+class ResponsiveGridTestWithCustomBreakpoints extends React.Component {
+  render() {
+    const layouts = {
+      lg: [
+        { i: '1', x: 0, y: 0, w: 1, h: 2, static: true },
+        { i: '2', x: 1, y: 0, w: 3, h: 2, minW: 2, maxW: 4 },
+        { i: '3', x: 4, y: 0, w: 1, h: 2 }
+      ]
+    };
+
+    return (
+      <Responsive
+        layouts={layouts}
+        width={800}
+        breakpoints={{ lg: 468, sm: 0 }}
+        cols={{ lg: 12, sm: 6 }}
+      >
+        <div key="1">a</div>
+        <div key="2">b</div>
+        <div key="3">c</div>
+      </Responsive>
+    );
+  }
+}
+
 class ResponsiveGridWidthProviderTest extends React.Component {
   render() {
     return (

From 157516ea3499d503e7f201729da2e5d7eb61a1c7 Mon Sep 17 00:00:00 2001
From: "Matt R. Wilson" <mwilson@shutterstock.com>
Date: Mon, 28 Jan 2019 12:32:49 -0700
Subject: [PATCH 40/61] [@types/opossum] Add new CircuitBreaker.shutdown().

https://github.com/nodeshift/opossum/pull/250
---
 types/opossum/index.d.ts       | 4 +++-
 types/opossum/opossum-tests.ts | 2 ++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/types/opossum/index.d.ts b/types/opossum/index.d.ts
index b17a1dd0be..612615ad86 100644
--- a/types/opossum/index.d.ts
+++ b/types/opossum/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for opossum 1.9
+// Type definitions for opossum 1.10
 // Project: https://github.com/nodeshift/opossum
 // Definitions by: Quinn Langille <https://github.com/quinnlangille>
 //                 Willy Zhang <https://github.com/merufm>
@@ -23,6 +23,7 @@ export class CircuitBreaker extends EventEmitter {
     readonly closed: boolean;
     readonly opened: boolean;
     readonly halfOpen: boolean;
+    readonly isShutdown: boolean;
     readonly status: Status;
     readonly stats: Stats;
     readonly hystrixStats: HystrixStats;
@@ -40,6 +41,7 @@ export class CircuitBreaker extends EventEmitter {
         func: (...args: any[]) => Promise<any>,
         interval?: number
     ): void;
+    shutdown(): void;
 }
 
 export enum Event {
diff --git a/types/opossum/opossum-tests.ts b/types/opossum/opossum-tests.ts
index ebbf0bea47..69d64497f0 100644
--- a/types/opossum/opossum-tests.ts
+++ b/types/opossum/opossum-tests.ts
@@ -39,6 +39,7 @@ breaker.closed; // $ExpectType boolean
 breaker.opened; // $ExpectType boolean
 breaker.halfOpen; // $ExpectType boolean
 breaker.warmUp; // $ExpectType boolean
+breaker.isShutdown; // $ExpectType boolean
 breaker.volumeThreshold; // $ExpectType number
 breaker.status.stats.latencyMean; // $ExpectType number
 breaker.stats.latencyTimes; // $ExpectType number[]
@@ -49,6 +50,7 @@ breaker.open(); // $ExpectType void
 breaker.close(); // $ExpectType void
 breaker.disable(); // $ExpectType void
 breaker.enable(); // $ExpectType void
+breaker.shutdown(); // $ExpectType void
 
 // The following are examples are from the libs README and official documentation
 // https://nodeshift.github.io/opossum/index.html.

From 05763bae96de831c29ba3e052703630fe9454bb4 Mon Sep 17 00:00:00 2001
From: Krzysztof Grzybek <krzysztof.grzybek89@gmail.com>
Date: Mon, 28 Jan 2019 21:01:19 +0100
Subject: [PATCH 41/61] add text clipper

---
 types/text-clipper/index.d.ts            | 15 +++++++++++++++
 types/text-clipper/text-clipper-tests.ts |  5 +++++
 types/text-clipper/tsconfig.json         | 23 +++++++++++++++++++++++
 types/text-clipper/tslint.json           |  1 +
 4 files changed, 44 insertions(+)
 create mode 100644 types/text-clipper/index.d.ts
 create mode 100644 types/text-clipper/text-clipper-tests.ts
 create mode 100644 types/text-clipper/tsconfig.json
 create mode 100644 types/text-clipper/tslint.json

diff --git a/types/text-clipper/index.d.ts b/types/text-clipper/index.d.ts
new file mode 100644
index 0000000000..1f86ac405b
--- /dev/null
+++ b/types/text-clipper/index.d.ts
@@ -0,0 +1,15 @@
+// Type definitions for text-clipper 1.2
+// Project: https://github.com/arendjr/text-clipper
+// Definitions by: Krzysztof Grzybek <https://github.com/krzysztof-grzybek>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+interface Options {
+    breakWords?: boolean;
+    html?: boolean;
+    imageWeight?: number;
+    indicator?: string;
+    maxLines?: number;
+}
+
+declare function clip(string: string, maxLength: number, options?: Options): string;
+export = clip;
diff --git a/types/text-clipper/text-clipper-tests.ts b/types/text-clipper/text-clipper-tests.ts
new file mode 100644
index 0000000000..f4ca7e6f19
--- /dev/null
+++ b/types/text-clipper/text-clipper-tests.ts
@@ -0,0 +1,5 @@
+import clip = require('text-clipper');
+
+clip('text', 123); // $ExpectType string
+clip('text', 123, { breakWords: true, html: false }); // $ExpectType string
+clip('text', 123, { imageWeight: 123, indicator: 'something', maxLines: 321 }); // $ExpectType string
diff --git a/types/text-clipper/tsconfig.json b/types/text-clipper/tsconfig.json
new file mode 100644
index 0000000000..caf06929bb
--- /dev/null
+++ b/types/text-clipper/tsconfig.json
@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "text-clipper-tests.ts"
+    ]
+}
diff --git a/types/text-clipper/tslint.json b/types/text-clipper/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/text-clipper/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From 140d0dc3e477b99a4bd1e1b6452560bfd702f35f Mon Sep 17 00:00:00 2001
From: Andrew MacLeay <amacleay@cloudhealthtech.com>
Date: Mon, 28 Jan 2019 15:24:13 -0500
Subject: [PATCH 42/61] @storybook/addon-notes: support global decorator

Support the global decorator usage supplied in [the README](https://github.com/storybooks/storybook/blob/9f30442098e5350f5ba4872887cf9d1a03146e74/addons/ondevice-notes/README.md#getting-started)
---
 types/storybook__addon-notes/index.d.ts                      | 4 ++++
 .../storybook__addon-notes/storybook__addon-notes-tests.tsx  | 5 ++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/types/storybook__addon-notes/index.d.ts b/types/storybook__addon-notes/index.d.ts
index b669ce0a9c..096da8fa34 100644
--- a/types/storybook__addon-notes/index.d.ts
+++ b/types/storybook__addon-notes/index.d.ts
@@ -17,5 +17,9 @@ export type WithNotesOptions = string | {
     markdownOptions?: MarkedOptions;
 };
 
+// It would be preferable to infer the argument types, but that requires TS v 3.1
+// export function withNotes(...args: StoryDecorator extends (...a: infer A) => any ? A : never): ReturnType<StoryDecorator>;
+export function withNotes(story: RenderFunction, context: { kind: string, story: string }): ReturnType<StoryDecorator>;
+// Less-preferred but still supported:
 export function withNotes(options?: WithNotesOptions): StoryDecorator;
 export function withMarkdownNotes(markdown: string, options?: MarkedOptions): StoryDecorator;
diff --git a/types/storybook__addon-notes/storybook__addon-notes-tests.tsx b/types/storybook__addon-notes/storybook__addon-notes-tests.tsx
index ebf24ce227..edfe0daf14 100644
--- a/types/storybook__addon-notes/storybook__addon-notes-tests.tsx
+++ b/types/storybook__addon-notes/storybook__addon-notes-tests.tsx
@@ -1,8 +1,11 @@
 import * as React from 'react';
 
-import { storiesOf } from '@storybook/react';
+import { addDecorator, storiesOf } from '@storybook/react';
 import { withNotes, withMarkdownNotes, } from '@storybook/addon-notes';
 
+// New, preferred global registration:
+addDecorator(withNotes);
+
 const SIMPLE_MARKDOWN = `
 ## Markdown for component
 

From 739ed3b1cf86fda9b015b5dda5966fa9cdf70341 Mon Sep 17 00:00:00 2001
From: Andrew Kaiser <kaisea.rpi@gmail.com>
Date: Mon, 28 Jan 2019 15:27:24 -0500
Subject: [PATCH 43/61] add variable arg function type inference, tests
 (#32390)

---
 types/better-sqlite3/better-sqlite3-tests.ts |  9 ++++++++
 types/better-sqlite3/index.d.ts              | 23 +++++++++++++-------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/types/better-sqlite3/better-sqlite3-tests.ts b/types/better-sqlite3/better-sqlite3-tests.ts
index dddd69bea8..f5a6c0e070 100644
--- a/types/better-sqlite3/better-sqlite3-tests.ts
+++ b/types/better-sqlite3/better-sqlite3-tests.ts
@@ -69,3 +69,12 @@ trans.default('name');
 trans.deferred('name');
 trans.immediate('name');
 trans.exclusive('name');
+
+const transTyped = db.transaction((param: number) => stmt.all(param));
+transTyped(1);
+trans.default(1);
+trans.deferred(1);
+trans.immediate(1);
+trans.exclusive(1);
+// $ExpectError
+transTyped('name');
diff --git a/types/better-sqlite3/index.d.ts b/types/better-sqlite3/index.d.ts
index 2c027ff6e6..32a71d96af 100644
--- a/types/better-sqlite3/index.d.ts
+++ b/types/better-sqlite3/index.d.ts
@@ -4,10 +4,17 @@
 //                 Mathew Rumsey <https://github.com/matrumz>
 //                 Santiago Aguilar <https://github.com/sant123>
 //                 Alessandro Vergani <https://github.com/loghorn>
+//                 Andrew Kaiser <https://github.com/andykais>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 3.0
 
 import Integer = require("integer");
 
+type VariableArgFunction = (...params: any[]) => any;
+type ArgumentTypes<F extends VariableArgFunction> = F extends (...args: infer A) => any
+  ? A
+  : never;
+
 declare namespace BetterSqlite3 {
     interface Statement {
         database: Database;
@@ -34,12 +41,12 @@ declare namespace BetterSqlite3 {
         type: string | null;
     }
 
-    interface Transaction {
-        (...params: any[]): any;
-        default(...params: any[]): any;
-        deferred(...params: any[]): any;
-        immediate(...params: any[]): any;
-        exclusive(...params: any[]): any;
+    interface Transaction<F extends VariableArgFunction> {
+        (...params: ArgumentTypes<F>): any;
+        default(...params: ArgumentTypes<F>): any;
+        deferred(...params: ArgumentTypes<F>): any;
+        immediate(...params: ArgumentTypes<F>): any;
+        exclusive(...params: ArgumentTypes<F>): any;
     }
 
     interface Database {
@@ -50,7 +57,7 @@ declare namespace BetterSqlite3 {
         inTransaction: boolean;
 
         prepare(source: string): Statement;
-        transaction(fn: (...params: any[]) => any): Transaction;
+        transaction<F extends VariableArgFunction>(fn: F): Transaction<F>;
         exec(source: string): this;
         pragma(source: string, options?: Database.PragmaOptions): any;
         checkpoint(databaseName?: string): this;
@@ -113,7 +120,7 @@ declare namespace Database {
     type SqliteError = typeof SqliteError;
     type Statement = BetterSqlite3.Statement;
     type ColumnDefinition = BetterSqlite3.ColumnDefinition;
-    type Transaction = BetterSqlite3.Transaction;
+    type Transaction = BetterSqlite3.Transaction<VariableArgFunction>;
     type Database = BetterSqlite3.Database;
 }
 

From 680362adbb5070cba84edf2f8f8e4b8f32a50902 Mon Sep 17 00:00:00 2001
From: Benjamin Lichtman <uniqueiniquity@users.noreply.github.com>
Date: Mon, 28 Jan 2019 12:29:45 -0800
Subject: [PATCH 44/61] Allow simple form of valid test case in ruletester
 (#32559)

---
 types/eslint/eslint-tests.ts | 8 ++++++++
 types/eslint/index.d.ts      | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/types/eslint/eslint-tests.ts b/types/eslint/eslint-tests.ts
index ed211d220e..6d175716b3 100644
--- a/types/eslint/eslint-tests.ts
+++ b/types/eslint/eslint-tests.ts
@@ -539,4 +539,12 @@ ruleTester.run('my-rule', rule, {
     ]
 });
 
+ruleTester.run('simple-valid-test', rule, {
+    valid: [
+        'foo',
+        'bar',
+        { code: 'foo', options: [{ allowFoo: true }] },
+    ]
+});
+
 //#endregion
diff --git a/types/eslint/index.d.ts b/types/eslint/index.d.ts
index 01f39ee83e..f1a585046c 100644
--- a/types/eslint/index.d.ts
+++ b/types/eslint/index.d.ts
@@ -540,7 +540,7 @@ export class RuleTester {
         name: string,
         rule: Rule.RuleModule,
         tests: {
-            valid?: RuleTester.ValidTestCase[];
+            valid?: Array<string | RuleTester.ValidTestCase>;
             invalid?: RuleTester.InvalidTestCase[];
         },
     ): void;

From 2148b16febe5ff94f031de6c2ec1a616cc9b44de Mon Sep 17 00:00:00 2001
From: Robin <RobinPerris@users.noreply.github.com>
Date: Mon, 28 Jan 2019 20:31:34 +0000
Subject: [PATCH 45/61] + detailed sql errors (#32513)

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

diff --git a/types/mssql/index.d.ts b/types/mssql/index.d.ts
index 891186f7ee..085ab122c1 100644
--- a/types/mssql/index.d.ts
+++ b/types/mssql/index.d.ts
@@ -288,6 +288,12 @@ export declare class RequestError implements Error {
     public name: string;
     public message: string;
     public code: string;
+    public number?: number;
+    public state?: number;
+    public class?: number;
+    public lineNumber?: number;
+    public serverName?: string;
+    public procName?: string;
 }
 
 export declare class Transaction extends events.EventEmitter {

From 6a792386c1727436b70d9328d7e5a92155de6ca8 Mon Sep 17 00:00:00 2001
From: Dan Rumney <dancrumb@gmail.com>
Date: Mon, 28 Jan 2019 14:40:10 -0600
Subject: [PATCH 46/61] Add definition for `default()` method signature
 (#32532)

* Add definition for `default()` method signature

Per the documentation (https://github.com/jquense/yup#mixeddefault-any) a call to `default` with no value should return an instance of the type that the schema describes, rather than the schema itself.

* Update index.d.ts

Make `value` no longer optional in the `default` definition
---
 types/yup/index.d.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/types/yup/index.d.ts b/types/yup/index.d.ts
index ffba765581..9f3cb687a2 100644
--- a/types/yup/index.d.ts
+++ b/types/yup/index.d.ts
@@ -8,6 +8,7 @@
 //                 Vincent Pizzo <https://github.com/vincentjames501>
 //                 Robert Bullen <https://github.com/robertbullen>
 //                 Yusuke Sato <https://github.com/sat0yu>
+//                 Dan Rumney <https://github.com/dancrumb>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
@@ -66,7 +67,8 @@ export interface Schema<T> {
     strict(isStrict: boolean): this;
     strip(strip: boolean): this;
     withMutation(fn: (current: this) => void): void;
-    default(value?: any): this;
+    default(value: any): this;
+    default(): T;
     nullable(isNullable: boolean): this;
     required(message?: TestOptionsMessage): this;
     notRequired(): this;

From 480b0531a3283f79839876cc7cac4e2467c467d2 Mon Sep 17 00:00:00 2001
From: Declan <pl0xy@users.noreply.github.com>
Date: Mon, 28 Jan 2019 20:48:38 +0000
Subject: [PATCH 47/61] [@types/aws-lambda] Add Amazon Lex events (#32502)

* [aws-lambda] Add types for Amazon Lex events

* fix: Fixed Typo in `AWSLambda.LexDialogActionClose.fulfillmentState`

* fix: removed a blank line
---
 types/aws-lambda/aws-lambda-tests.ts | 110 +++++++++++++++++++++++++++
 types/aws-lambda/index.d.ts          |  97 +++++++++++++++++++++++
 2 files changed, 207 insertions(+)

diff --git a/types/aws-lambda/aws-lambda-tests.ts b/types/aws-lambda/aws-lambda-tests.ts
index 92f0a6999b..ba6ebdc5ac 100644
--- a/types/aws-lambda/aws-lambda-tests.ts
+++ b/types/aws-lambda/aws-lambda-tests.ts
@@ -1056,3 +1056,113 @@ const firehoseEventHandler: AWSLambda.FirehoseTransformationHandler = (
         ]
     });
 };
+
+declare let lexEvent: AWSLambda.LexEvent;
+lexEvent = {
+    currentIntent: {
+        name: 'intent-name',
+        slots: {
+            slot1: null,
+            slot2: 'value2',
+        },
+        slotDetails: {
+            slot1: {
+                resolutions: [
+                    { value: 'value1' },
+                ],
+                originalValue: 'originalValue',
+            }
+        },
+        confirmationStatus: 'None',
+    },
+    bot: {
+        name: 'bot name',
+        alias: 'bot alias',
+        version: 'bot version',
+    },
+    userId: 'User ID specified in the POST request to Amazon Lex.',
+    inputTranscript: 'Text used to process the request',
+    invocationSource: 'FulfillmentCodeHook',
+    outputDialogMode: 'Text',
+    messageVersion: '1.0',
+    sessionAttributes: {
+        key1: 'value1',
+        key2: 'value2',
+    },
+    requestAttributes: {
+        key1: 'value1',
+        key2: 'value2',
+    }
+};
+
+declare let lexResult: AWSLambda.LexResult;
+declare let lexDialogAction: AWSLambda.LexDialogAction;
+declare let lexDialogActionBase: AWSLambda.LexDialogActionBase;
+declare let lexDialogActionClose: AWSLambda.LexDialogActionClose;
+declare let lexDialogActionConfirmIntent: AWSLambda.LexDialogActionConfirmIntent;
+declare let lexDialogActionDelegate: AWSLambda.LexDialogActionDelegate;
+declare let lexDialogActionElicitIntent: AWSLambda.LexDialogActionElicitIntent;
+declare let lexDialogActionElicitSlot: AWSLambda.LexDialogActionElicitSlot;
+declare let lexGenericAttachment: AWSLambda.LexGenericAttachment;
+
+lexResult = {
+    sessionAttributes: {
+        attrib1: 'Value One',
+    },
+    dialogAction: {
+        type: 'Close',
+        fulfillmentState: 'Failed',
+    },
+};
+
+str = lexGenericAttachment.title;
+str = lexGenericAttachment.subTitle;
+str = lexGenericAttachment.imageUrl;
+str = lexGenericAttachment.attachmentLinkUrl;
+str = lexGenericAttachment.buttons[0].text;
+str = lexGenericAttachment.buttons[0].value;
+
+lexDialogAction.type === 'Close';
+lexDialogAction.type === 'ConfirmIntent';
+lexDialogAction.type === 'Delegate';
+lexDialogAction.type === 'ElicitIntent';
+lexDialogAction.type === 'ElicitSlot';
+
+lexDialogActionBase.message!.contentType === 'CustomPayload';
+lexDialogActionBase.message!.contentType === 'PlainText';
+lexDialogActionBase.message!.contentType === 'SSML';
+str = lexDialogActionBase.message!.content;
+num = lexDialogActionBase.responseCard!.version;
+lexDialogActionBase.responseCard!.contentType === 'application/vnd.amazonaws.card.generic';
+// $ExpectType LexGenericAttachment
+lexDialogActionBase.responseCard!.genericAttachments[0];
+
+lexDialogActionClose.type === 'Close';
+lexDialogActionClose.fulfillmentState === 'Failed';
+lexDialogActionClose.fulfillmentState === 'Fulfilled';
+
+lexDialogActionConfirmIntent.type === 'ConfirmIntent';
+str = lexDialogActionConfirmIntent.intentName;
+strOrNull = lexDialogActionConfirmIntent.slots['example'];
+
+lexDialogActionDelegate.type === 'Delegate';
+strOrNull = lexDialogActionDelegate.slots['example'];
+
+lexDialogActionElicitIntent.type === 'ElicitIntent';
+lexDialogActionElicitSlot.type === 'ElicitSlot';
+strOrNull = lexDialogActionElicitSlot.slots['example'];
+str = lexDialogActionElicitSlot.slotToElicit;
+str = lexDialogActionElicitSlot.intentName;
+
+const lexEventHandler: AWSLambda.LexHandler = async (
+    event: AWSLambda.LexEvent,
+    context: AWSLambda.Context,
+) => {
+    // $ExpectType LexEvent
+    event;
+
+    // $ExpectType Context
+    context;
+    str = context.functionName;
+    return lexResult;
+};
diff --git a/types/aws-lambda/index.d.ts b/types/aws-lambda/index.d.ts
index 4cafe3d2da..52314529bc 100644
--- a/types/aws-lambda/index.d.ts
+++ b/types/aws-lambda/index.d.ts
@@ -876,6 +876,100 @@ export interface SQSMessageAttributes {
     [name: string]: SQSMessageAttribute;
 }
 
+// Lex
+// https://docs.aws.amazon.com/lambda/latest/dg/invoking-lambda-function.html#supported-event-source-lex
+export interface LexEvent {
+    currentIntent: {
+        name: string;
+        slots: { [name: string]: string | null };
+        slotDetails: LexSlotDetails;
+        confirmationStatus: 'None' | 'Confirmed' | 'Denied';
+    };
+    bot: {
+        name: string;
+        alias: string;
+        version: string;
+    };
+    userId: string;
+    inputTranscript: string;
+    invocationSource: 'DialogCodeHook' | 'FulfillmentCodeHook';
+    outputDialogMode: 'Text' | 'Voice';
+    messageVersion: '1.0';
+    sessionAttributes: { [key: string]: string };
+    requestAttributes: { [key: string]: string } | null;
+}
+
+export interface LexSlotResolution {
+    value: string;
+}
+
+export interface LexSlotDetails {
+    [name: string]: {
+        // The following line only works in TypeScript Version: 3.0, The array should have at least 1 and no more than 5 items
+        // resolutions: [LexSlotResolution, LexSlotResolution?, LexSlotResolution?, LexSlotResolution?, LexSlotResolution?];
+        resolutions: LexSlotResolution[]
+        originalValue: string;
+    };
+}
+
+export interface LexGenericAttachment {
+    title: string;
+    subTitle: string;
+    imageUrl: string;
+    attachmentLinkUrl: string;
+    buttons: Array<{
+        text: string;
+        value: string;
+    }>;
+}
+
+export interface LexDialogActionBase {
+    type: 'Close' | 'ElicitIntent' | 'ElicitSlot' | 'ConfirmIntent';
+    message?: {
+        contentType: 'PlainText' | 'SSML' | 'CustomPayload';
+        content: string;
+    };
+    responseCard?: {
+        version: number;
+        contentType: 'application/vnd.amazonaws.card.generic';
+        genericAttachments: LexGenericAttachment[];
+    };
+}
+
+export interface LexDialogActionClose extends LexDialogActionBase {
+    type: 'Close';
+    fulfillmentState: 'Fulfilled' | 'Failed';
+}
+
+export interface LexDialogActionElicitIntent extends LexDialogActionBase {
+    type: 'ElicitIntent';
+}
+
+export interface LexDialogActionElicitSlot extends LexDialogActionBase {
+    type: 'ElicitSlot';
+    intentName: string;
+    slots: { [name: string]: string | null };
+    slotToElicit: string;
+}
+
+export interface LexDialogActionConfirmIntent extends LexDialogActionBase {
+    type: 'ConfirmIntent';
+    intentName: string;
+    slots: { [name: string]: string | null };
+}
+
+export interface LexDialogActionDelegate {
+    type: 'Delegate';
+    slots: { [name: string]: string | null };
+}
+
+export type LexDialogAction = LexDialogActionClose | LexDialogActionElicitIntent | LexDialogActionElicitSlot | LexDialogActionConfirmIntent | LexDialogActionDelegate;
+
+export interface LexResult {
+    sessionAttributes?: { [key: string]: string };
+    dialogAction: LexDialogAction;
+}
+
 /**
  * AWS Lambda handler function.
  * http://docs.aws.amazon.com/lambda/latest/dg/nodejs-prog-model-handler.html
@@ -938,6 +1032,9 @@ export type ScheduledHandler = Handler<ScheduledEvent, void>;
 
 // TODO: Alexa
 
+export type LexHandler = Handler<LexEvent, LexResult>;
+export type LexCallback = Callback<LexResult>;
+
 export type APIGatewayProxyHandler = Handler<APIGatewayProxyEvent, APIGatewayProxyResult>;
 export type APIGatewayProxyCallback = Callback<APIGatewayProxyResult>;
 export type ProxyHandler = APIGatewayProxyHandler; // Old name

From e76fa57bc07c57af2f8bc305b17a4a8c482a8553 Mon Sep 17 00:00:00 2001
From: Corban Brook <corbanbrook@gmail.com>
Date: Mon, 28 Jan 2019 15:50:45 -0500
Subject: [PATCH 48/61] Added missing userData to BufferGeometry (#32533)

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

diff --git a/types/three/three-core.d.ts b/types/three/three-core.d.ts
index 639fba5ba5..4866cbfd54 100755
--- a/types/three/three-core.d.ts
+++ b/types/three/three-core.d.ts
@@ -867,6 +867,7 @@ export class BufferGeometry extends EventDispatcher {
     boundingBox: Box3;
     boundingSphere: Sphere;
     drawRange: { start: number, count: number };
+    userData: {[key: string]: any};
 
     getIndex(): BufferAttribute;
     setIndex( index: BufferAttribute|number[] ): void;

From 18d3e314ea092b6fabf6225b8a69e40e3aba8b77 Mon Sep 17 00:00:00 2001
From: Zain Afzal <zain.afz@gmail.com>
Date: Wed, 23 Jan 2019 15:41:39 +1100
Subject: [PATCH 49/61] Fixed Label Rendering callback in react-json-tree

---
 types/react-json-tree/index.d.ts | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/types/react-json-tree/index.d.ts b/types/react-json-tree/index.d.ts
index d0ab7cab62..600de66fb8 100644
--- a/types/react-json-tree/index.d.ts
+++ b/types/react-json-tree/index.d.ts
@@ -1,6 +1,7 @@
-// Type definitions for react-json-tree v0.6.5
+// Type definitions for react-json-tree v0.6.6
 // Project: https://github.com/alexkuz/react-json-tree/
 // Definitions by: Grant Nestor <https://github.com/gnestor>
+//                 Zain Afzal <https://github.com/zainafzal08>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
@@ -18,7 +19,7 @@ export interface JSONTreeProps extends Props<JSONTreeComponent> {
     sortObjectKeys?: Function | boolean;
     shouldExpandNode?: (keyPath: (string | number)[], data: [any] | {}, level: number) => boolean;
     getItemString?: (type: string, data: [any] | {}, itemType: string, itemString: string) => JSX.Element;
-    labelRenderer?: (raw: [string, string]) => JSX.Element;
+    labelRenderer?: (keyPath: string[], nodeType: string, expanded: boolean, expandable: boolean) => JSX.Element;
     valueRenderer?: (displayValue: string|number, rawValue?: string|number|boolean|null, ...keyPath: (string|number)[]) => JSX.Element;
     postprocessValue?: (raw: string) => JSX.Element;
     isCustomNode?: () => boolean;

From d74ed1acba85573440e78cff4a57c8c7386cc4e0 Mon Sep 17 00:00:00 2001
From: Zain Afzal <zain.afz@gmail.com>
Date: Wed, 23 Jan 2019 15:48:34 +1100
Subject: [PATCH 50/61] Make paramaters after keyPath optional

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

diff --git a/types/react-json-tree/index.d.ts b/types/react-json-tree/index.d.ts
index 600de66fb8..6fc37c4941 100644
--- a/types/react-json-tree/index.d.ts
+++ b/types/react-json-tree/index.d.ts
@@ -19,7 +19,7 @@ export interface JSONTreeProps extends Props<JSONTreeComponent> {
     sortObjectKeys?: Function | boolean;
     shouldExpandNode?: (keyPath: (string | number)[], data: [any] | {}, level: number) => boolean;
     getItemString?: (type: string, data: [any] | {}, itemType: string, itemString: string) => JSX.Element;
-    labelRenderer?: (keyPath: string[], nodeType: string, expanded: boolean, expandable: boolean) => JSX.Element;
+    labelRenderer?: (keyPath: string[], nodeType?: string, expanded?: boolean, expandable?: boolean) => JSX.Element;
     valueRenderer?: (displayValue: string|number, rawValue?: string|number|boolean|null, ...keyPath: (string|number)[]) => JSX.Element;
     postprocessValue?: (raw: string) => JSX.Element;
     isCustomNode?: () => boolean;

From 409fc7fb164367a80c75efa02c97877c9511bf22 Mon Sep 17 00:00:00 2001
From: Zain Afzal <zain.afz@gmail.com>
Date: Tue, 29 Jan 2019 07:54:29 +1100
Subject: [PATCH 51/61] Fixed header

---
 types/react-json-tree/index.d.ts  | 2 +-
 types/react-json-tree/tslint.json | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/types/react-json-tree/index.d.ts b/types/react-json-tree/index.d.ts
index 6fc37c4941..c57cdd3d51 100644
--- a/types/react-json-tree/index.d.ts
+++ b/types/react-json-tree/index.d.ts
@@ -1,4 +1,4 @@
-// Type definitions for react-json-tree v0.6.6
+// Type definitions for react-json-tree 0.6
 // Project: https://github.com/alexkuz/react-json-tree/
 // Definitions by: Grant Nestor <https://github.com/gnestor>
 //                 Zain Afzal <https://github.com/zainafzal08>
diff --git a/types/react-json-tree/tslint.json b/types/react-json-tree/tslint.json
index e3610fefae..92d14c6344 100644
--- a/types/react-json-tree/tslint.json
+++ b/types/react-json-tree/tslint.json
@@ -7,7 +7,6 @@
         "ban-types": false,
         "callable-types": false,
         "comment-format": false,
-        "dt-header": false,
         "eofline": false,
         "export-just-namespace": false,
         "import-spacing": false,

From c2627760b9a77adb447524da1fca719cda319987 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20D=C3=BCfel?= <christian@duefel.de>
Date: Mon, 28 Jan 2019 22:07:58 +0100
Subject: [PATCH 52/61] Add type definitions for fastify-rate-limit

---
 .../fastify-rate-limit-tests.ts               | 22 ++++++
 types/fastify-rate-limit/index.d.ts           | 74 +++++++++++++++++++
 types/fastify-rate-limit/package.json         |  6 ++
 types/fastify-rate-limit/tsconfig.json        | 21 ++++++
 types/fastify-rate-limit/tslint.json          |  1 +
 5 files changed, 124 insertions(+)
 create mode 100644 types/fastify-rate-limit/fastify-rate-limit-tests.ts
 create mode 100644 types/fastify-rate-limit/index.d.ts
 create mode 100644 types/fastify-rate-limit/package.json
 create mode 100644 types/fastify-rate-limit/tsconfig.json
 create mode 100644 types/fastify-rate-limit/tslint.json

diff --git a/types/fastify-rate-limit/fastify-rate-limit-tests.ts b/types/fastify-rate-limit/fastify-rate-limit-tests.ts
new file mode 100644
index 0000000000..ee79951f48
--- /dev/null
+++ b/types/fastify-rate-limit/fastify-rate-limit-tests.ts
@@ -0,0 +1,22 @@
+import fastifyRateLimit = require("fastify-rate-limit");
+import * as IORedis from 'ioredis';
+import { FastifyRequest, DefaultQuery } from "fastify";
+import { IncomingMessage } from "http";
+
+fastifyRateLimit();
+
+const fastifyRateLimitOptions: fastifyRateLimit.FastifyRateLimitOptions<FastifyRequest<IncomingMessage, DefaultQuery, {test: string}>> = {
+    max: 3,
+    timeWindow: 5000,
+    cache: 10000,
+    whitelist: ['127.0.0.1'],
+    redis: new IORedis({ host: '127.0.0.1' }),
+    skipOnError: true, // default false
+    keyGenerator: (req) => {
+        return req.headers['x-real-ip']
+        || req.headers['x-client-ip']
+        || req.headers['x-forwarded-for']
+        || req.params.test
+        || req.ip;
+    },
+};
diff --git a/types/fastify-rate-limit/index.d.ts b/types/fastify-rate-limit/index.d.ts
new file mode 100644
index 0000000000..888611ad72
--- /dev/null
+++ b/types/fastify-rate-limit/index.d.ts
@@ -0,0 +1,74 @@
+// Type definitions for fastify-rate-limit 2.0
+// Project: https://github.com/fastify/fastify-rate-limit#readme
+// Definitions by: Christian D <https://github.com/pc-jedi>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+// TypeScript Version: 2.8
+
+import { Redis } from "ioredis";
+import { FastifyRequest } from "fastify";
+import { IncomingMessage } from "http";
+
+declare function fastifyRateLimit(): void;
+
+declare namespace fastifyRateLimit {
+  interface FastifyRateLimitOptions<T = FastifyRequest<IncomingMessage>> {
+    /**
+     * Is the maximum number of requests a single client can perform inside a
+     * timeWindow.
+     *
+     * default: 1000
+     */
+    max?: number;
+
+    /**
+     * The duration of the time window, can be expressed in milliseconds (as a
+     * number) or as a string, see ms too see the supported formats
+     *
+     * default: 1000 * 60
+     */
+    timeWindow?: number;
+
+    /**
+     * This plugin internally uses a lru cache to handle the clients, you can
+     * change the size of the cache with this option.
+     *
+     * default: 5000
+     */
+    cache?: number;
+
+    /**
+     * Array of string of ips to exclude from rate limiting.
+     *
+     * default: []
+     */
+    whitelist?: string[];
+
+    /**
+     * By default this plugins uses an in-memory store, which is fast but if
+     * you application works on more than one server it is useless, since the
+     * data is store locally. You can pass a Redis client here and magically
+     * the issue is solved. To achieve the maximum speed, this plugins requires
+     * the use of ioredis.
+     *
+     * default: null
+     */
+    redis?: Redis;
+
+    /**
+     * If `true` it will skip errors generated by the storage (eg, redis not
+     * reachable).
+     *
+     * default: false
+     */
+    skipOnError?: boolean;
+
+    /**
+     * Function to generate a unique identifier for each incoming request.
+     *
+     * default: (req) => req.ip
+     */
+    keyGenerator?: (req: T) => string;
+  }
+}
+
+export = fastifyRateLimit;
diff --git a/types/fastify-rate-limit/package.json b/types/fastify-rate-limit/package.json
new file mode 100644
index 0000000000..e8c68ab969
--- /dev/null
+++ b/types/fastify-rate-limit/package.json
@@ -0,0 +1,6 @@
+{
+    "private": true,
+    "dependencies": {
+        "fastify": "^1.11.2"
+    }
+}
diff --git a/types/fastify-rate-limit/tsconfig.json b/types/fastify-rate-limit/tsconfig.json
new file mode 100644
index 0000000000..5dc0e91ea2
--- /dev/null
+++ b/types/fastify-rate-limit/tsconfig.json
@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": ["index.d.ts", "fastify-rate-limit-tests.ts"],
+    "exclude": ["node-modules"]
+}
diff --git a/types/fastify-rate-limit/tslint.json b/types/fastify-rate-limit/tslint.json
new file mode 100644
index 0000000000..3db14f85ea
--- /dev/null
+++ b/types/fastify-rate-limit/tslint.json
@@ -0,0 +1 @@
+{ "extends": "dtslint/dt.json" }

From 71bd0ba07bc8a99bd413d5c631f0daefb72014c1 Mon Sep 17 00:00:00 2001
From: Dan <32849715+ddangelo-shoprunner@users.noreply.github.com>
Date: Mon, 28 Jan 2019 18:11:49 -0500
Subject: [PATCH 53/61] auth0-js - Including optional props AuthorizeOptions -
 acccessType; approvalPrompt (#32520)

* Including optional properties AuthorizeOptions - acccessType; approvalForce

auth-0.js actually forwards any param you send it (minus a specific black list).
Auth0 Support and Community use these optional params, although they are not specifically called out in the Auth0 API documentation.
Auth0 Support and Community even specify these are needed especially to get Google refresh_tokens (vie email Support Ticket, as well as the Community link below)
https://community.auth0.com/t/cant-get-google-refresh-token-using-auth0-js/11756

* Corrected to use field approvalPrompt

* fixed typo
---
 types/auth0-js/index.d.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/types/auth0-js/index.d.ts b/types/auth0-js/index.d.ts
index a38c928333..f2cc95105c 100644
--- a/types/auth0-js/index.d.ts
+++ b/types/auth0-js/index.d.ts
@@ -812,6 +812,8 @@ export interface AuthorizeOptions {
     login_hint?: string;
 	prompt?: string;
     mode?: "login" | "signUp";
+    acccessType?: string;
+    approvalPrompt?: string;
 }
 
 export interface CheckSessionOptions extends AuthorizeOptions {

From 78feba777260833b6e8a328c7ed8888bb6580849 Mon Sep 17 00:00:00 2001
From: Borewit <Borewit@users.noreply.github.com>
Date: Tue, 29 Jan 2019 00:14:15 +0100
Subject: [PATCH 54/61] Needle: export NeedleResponse (#32535)

* Export NeedleResponse

* simply 'NeedleResponse' type test, get rid of function
---
 types/needle/index.d.ts      | 1 +
 types/needle/needle-tests.ts | 8 ++++++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/types/needle/index.d.ts b/types/needle/index.d.ts
index 509e212c6e..af879cfacc 100644
--- a/types/needle/index.d.ts
+++ b/types/needle/index.d.ts
@@ -247,6 +247,7 @@ declare namespace needle {
     export type NeedleCallback = core.NeedleCallback;
     export type NeedleHttpVerbs = core.NeedleHttpVerbs;
     export type NeedleOptions = core.NeedleOptions;
+    export type NeedleResponse = core.NeedleResponse;
     export type ReadableStream = core.ReadableStream;
 
     /**
diff --git a/types/needle/needle-tests.ts b/types/needle/needle-tests.ts
index a216b1f686..fac7efa58c 100644
--- a/types/needle/needle-tests.ts
+++ b/types/needle/needle-tests.ts
@@ -73,14 +73,18 @@ function API_head() {
 
 function API_get() {
     // using promises
+    let resp: needle.NeedleResponse;
+
     needle('get', 'google.com/search?q=syd+barrett')
-        .then((resp) => {
+        .then((_resp) => {
             // if no http:// is found, Needle will automagically prepend it.
+            resp = _resp;
         });
 
     // using callback
-    needle.get('google.com/search?q=syd+barrett', (err, resp) => {
+    needle.get('google.com/search?q=syd+barrett', (err, _resp) => {
         // if no http:// is found, Needle will automagically prepend it.
+        resp = _resp;  // assign response
     });
 }
 

From 4a91c57f19a024a9c273e5151bd482eca4fd44b4 Mon Sep 17 00:00:00 2001
From: AntoineC <aecz@gft.com>
Date: Tue, 29 Jan 2019 00:16:51 +0100
Subject: [PATCH 55/61] Add Settings interface (#32352)

Add test for settings on paper and new created PaperScope instance
---
 types/paper/index.d.ts     | 48 +++++++++++++++++---------------------
 types/paper/paper-tests.ts |  4 ++++
 2 files changed, 25 insertions(+), 27 deletions(-)

diff --git a/types/paper/index.d.ts b/types/paper/index.d.ts
index 6c1f2979fb..08a6d794ad 100644
--- a/types/paper/index.d.ts
+++ b/types/paper/index.d.ts
@@ -21,26 +21,7 @@ declare module paper {
     /**
     * Gives access to paper's configurable settings.
     */
-    export var settings: {
-        
-        /**
-         * controls whether newly created items are automatically inserted into the scene graph, by adding them to project.activeLayer — default: true
-         */
-        insertItems: boolean;
-        /**
-         * controls what value newly created items have their item.applyMatrix property set to (Note that not all items can set this to false) — default: true
-         */
-        applyMatrix: boolean;
-        /**
-         * the size of the curve handles when drawing selections — default: 4
-         */
-        handleSize: number;
-        /*
-         * the default tolerance for hit- tests, when no value is specified — default: 0
-         */
-        hitTolerance: number;
-
-    };
+    export var settings: Settings;
 
     /**
      * The currently active project.
@@ -1163,13 +1144,7 @@ declare module paper {
         /**
         * Gives access to paper's configurable settings.
         */
-        settings: {
-
-            applyMatrix: boolean;
-            handleSize: number;
-            hitTolerance: number;
-
-        };
+        settings: Settings;
 
         /**
          * The currently active project.
@@ -5481,6 +5456,25 @@ declare module paper {
         type: 'mousedown' | 'mouseup' | 'mousedrag' | 'click' | 'doubleclick' | 'mousemove' | 'mouseenter' | 'mouseleave';
 
     }
+	
+	export interface Settings {
+        /**
+         * controls whether newly created items are automatically inserted into the scene graph, by adding them to project.activeLayer — default: true
+         */
+        insertItems: boolean;
+        /**
+         * controls what value newly created items have their item.applyMatrix property set to (Note that not all items can set this to false) — default: true
+         */
+        applyMatrix: boolean;
+        /**
+         * the size of the curve handles when drawing selections — default: 4
+         */
+        handleSize: number;
+        /*
+         * the default tolerance for hit- tests, when no value is specified — default: 0
+         */
+        hitTolerance: number;
+    }
 }
 
 declare module 'paper'
diff --git a/types/paper/paper-tests.ts b/types/paper/paper-tests.ts
index 1d1bc32abe..280b68c0e9 100644
--- a/types/paper/paper-tests.ts
+++ b/types/paper/paper-tests.ts
@@ -81,6 +81,10 @@ hitTestResults = paper.project.hitTestAll(hitTestPoint, hitOptionsInterfaceFull)
 
 paper.view.scaling = new paper.Point(1, 1);
 
+paper.settings.insertItems = true
+const paperScope = new paper.PaperScope();
+paperScope.settings.insertItems = false;
+
 function Examples() {
     function BooleanOperations(){
         let text = new paper.PointText({

From 42e879f2223be2d15023d1c04d16d68d55b04726 Mon Sep 17 00:00:00 2001
From: Igor Goldvekht <goldvekht.igor@gmail.com>
Date: Mon, 28 Jan 2019 18:20:14 -0500
Subject: [PATCH 56/61] [snoowrap] Fix typings for some Promise returning
 functions (#32505)

* Fix typings for some Promise returning functions

* Add semicolon
---
 types/snoowrap/dist/objects/LiveThread.d.ts |  4 +-
 types/snoowrap/dist/objects/RedditUser.d.ts | 16 +++----
 types/snoowrap/dist/objects/Submission.d.ts |  5 +--
 types/snoowrap/dist/objects/Subreddit.d.ts  | 46 ++++++++++-----------
 types/snoowrap/dist/objects/WikiPage.d.ts   |  4 +-
 types/snoowrap/snoowrap-tests.ts            |  4 ++
 6 files changed, 41 insertions(+), 38 deletions(-)

diff --git a/types/snoowrap/dist/objects/LiveThread.d.ts b/types/snoowrap/dist/objects/LiveThread.d.ts
index ba34886fbb..594fc50247 100644
--- a/types/snoowrap/dist/objects/LiveThread.d.ts
+++ b/types/snoowrap/dist/objects/LiveThread.d.ts
@@ -26,8 +26,8 @@ export default class LiveThread extends RedditContent<LiveThread> {
   deleteUpdate(options: { id: string; }): Promise<this>;
   editSettings(options: LiveThreadSettings): Promise<this>;
   getContributors(): Promise<RedditUser[]>;
-  getDiscussions(options?: ListingOptions): Listing<Submission>;
-  getRecentUpdates(options?: ListingOptions): Listing<LiveUpdate>;
+  getDiscussions(options?: ListingOptions): Promise<Listing<Submission>>;
+  getRecentUpdates(options?: ListingOptions): Promise<Listing<LiveUpdate>>;
   inviteContributor(options: { name: string; permissions: Permissions[]}): Promise<this>;
   leaveContributor(): Promise<this>;
   removeContributor(options: { name: string; }): Promise<this>;
diff --git a/types/snoowrap/dist/objects/RedditUser.d.ts b/types/snoowrap/dist/objects/RedditUser.d.ts
index a93cac98cd..35bc56eb9e 100644
--- a/types/snoowrap/dist/objects/RedditUser.d.ts
+++ b/types/snoowrap/dist/objects/RedditUser.d.ts
@@ -100,18 +100,18 @@ export default class RedditUser extends RedditContent<RedditUser> {
 
   assignFlair(options: any): Promise<this>;
   friend(options: any): Promise<this>;
-  getComments(options?: any): Listing<Comment>;
-  getDownvotedContent(options?: any): Listing<Comment | Submission>;
+  getComments(options?: any): Promise<Listing<Comment>>;
+  getDownvotedContent(options?: any): Promise<Listing<Comment | Submission>>;
   getFriendInformation(): Promise<any>;
-  getGildedContent(options?: any): Listing<Comment | Submission>;
-  getHiddenContent(options?: any): Listing<Comment | Submission>;
+  getGildedContent(options?: any): Promise<Listing<Comment | Submission>>;
+  getHiddenContent(options?: any): Promise<Listing<Comment | Submission>>;
   getMultireddit(name: string): MultiReddit;
   getMultireddits(): Promise<MultiReddit[]>;
-  getOverview(options?: any): Listing<Comment | Submission>;
-  getSavedContent(options?: any): Listing<Comment | Submission>;
-  getSubmissions(options?: any): Listing<Submission>;
+  getOverview(options?: any): Promise<Listing<Comment | Submission>>;
+  getSavedContent(options?: any): Promise<Listing<Comment | Submission>>;
+  getSubmissions(options?: any): Promise<Listing<Submission>>;
   getTrophies(): Promise<any>;
-  getUpvotedContent(options?: any): Listing<Comment | Submission>;
+  getUpvotedContent(options?: any): Promise<Listing<Comment | Submission>>;
   giveGold(months: string): Promise<any>;
   unfriend(): Promise<any>;
 }
diff --git a/types/snoowrap/dist/objects/Submission.d.ts b/types/snoowrap/dist/objects/Submission.d.ts
index e2e7dc78d1..5986ac59cc 100644
--- a/types/snoowrap/dist/objects/Submission.d.ts
+++ b/types/snoowrap/dist/objects/Submission.d.ts
@@ -1,8 +1,7 @@
 import { Sort } from '../..';
 import Comment from './Comment';
 import Listing, { ListingOptions } from './Listing';
-import RedditUser from './RedditUser';
-import Subreddit, { FlairTemplate } from './Subreddit';
+import { FlairTemplate } from './Subreddit';
 import VoteableContent, { RichTextFlair } from './VoteableContent';
 
 interface Media {
@@ -113,7 +112,7 @@ export default class Submission extends VoteableContent<Submission> {
   assignFlair(options: { text: string; cssClass: string; }): Promise<this>;
   disableContestMode(): Promise<this>;
   enableContestMode(): Promise<this>;
-  getDuplicates(options?: ListingOptions): Listing<Submission>;
+  getDuplicates(options?: ListingOptions): Promise<Listing<Submission>>;
   getLinkFlairTemplates(): Promise<FlairTemplate[]>;
   /* @deprecated */ getRelated(options?: ListingOptions): Submission;
   hide(): Promise<this>;
diff --git a/types/snoowrap/dist/objects/Subreddit.d.ts b/types/snoowrap/dist/objects/Subreddit.d.ts
index 67623a17af..a9de52632d 100644
--- a/types/snoowrap/dist/objects/Subreddit.d.ts
+++ b/types/snoowrap/dist/objects/Subreddit.d.ts
@@ -1,12 +1,12 @@
-import { Sort, ModAction, SubmitSelfPostOptions, SubmitLinkOptions, BaseSearchOptions } from '../..';
+import { BaseSearchOptions, ModAction, Sort, SubmitLinkOptions, SubmitSelfPostOptions } from '../..';
 import Comment from './Comment';
 import Listing, { ListingOptions } from './Listing';
 import PrivateMessage from './PrivateMessage';
 import RedditContent from './RedditContent';
 import RedditUser from './RedditUser';
 import Submission from './Submission';
-import WikiPage, { WikiPageRevision } from './WikiPage';
 import { RichTextFlair } from './VoteableContent';
+import WikiPage, { WikiPageRevision } from './WikiPage';
 
 export default class Subreddit extends RedditContent<Subreddit> {
   accounts_active_is_fuzzed: boolean;
@@ -108,40 +108,40 @@ export default class Subreddit extends RedditContent<Subreddit> {
   deleteImage(options: { imageName: string; }): Promise<this>;
   deleteUserFlair(name: string): Promise<this>;
   editSettings(options: SubredditSettings): Promise<this>;
-  getBannedUsers(options?: ListingOptions & { name?: string }): Listing<BannedUser>;
-  getContributors(options?: ListingOptions & { name?: string }): Listing<Contributor>;
-  getControversial(options?: ListingOptions & { time?: string }): Listing<Submission>;
-  getEdited(options?: ListingOptions & { only?: 'links' | 'comments' }): Listing<Submission | Comment>;
-  getHot(options?: ListingOptions): Listing<Submission>;
+  getBannedUsers(options?: ListingOptions & { name?: string }): Promise<Listing<BannedUser>>;
+  getContributors(options?: ListingOptions & { name?: string }): Promise<Listing<Contributor>>;
+  getControversial(options?: ListingOptions & { time?: string }): Promise<Listing<Submission>>;
+  getEdited(options?: ListingOptions & { only?: 'links' | 'comments' }): Promise<Listing<Submission | Comment>>;
+  getHot(options?: ListingOptions): Promise<Listing<Submission>>;
   getLinkFlairTemplates(linkId: string): Promise<FlairTemplate[]>;
-  getModerationLog(opts?: ListingOptions & { mods?: string[]; type?: ModActionType}): Listing<ModAction>;
+  getModerationLog(opts?: ListingOptions & { mods?: string[]; type?: ModActionType}): Promise<Listing<ModAction>>;
   getModerators(options?: ListingOptions & { name?: string }): RedditUser[];
-  getModmail(options?: ListingOptions): Listing<PrivateMessage>;
-  getModqueue(options?: ListingOptions & { only?: 'links' | 'comments' }): Listing<Submission | Comment>;
-  getMutedUsers(options?: ListingOptions & { name?: string }): Listing<MutedUser>;
+  getModmail(options?: ListingOptions): Promise<Listing<PrivateMessage>>;
+  getModqueue(options?: ListingOptions & { only?: 'links' | 'comments' }): Promise<Listing<Submission | Comment>>;
+  getMutedUsers(options?: ListingOptions & { name?: string }): Promise<Listing<MutedUser>>;
   getMyFlair(): Promise<FlairTemplate>;
-  getNew(options?: ListingOptions): Listing<Submission>;
-  getNewComments(options?: ListingOptions): Listing<Comment>;
+  getNew(options?: ListingOptions): Promise<Listing<Submission>>;
+  getNewComments(options?: ListingOptions): Promise<Listing<Comment>>;
   getRandomSubmission(): Promise<Submission>;
   getRecommendedSubreddits(options?: { omit?: string[]; }): Promise<Subreddit[]>;
-  getReports(options?: ListingOptions & { only?: 'links' | 'comments' }): Listing<Submission | Comment>;
-  getRising(options?: ListingOptions): Listing<Submission>;
+  getReports(options?: ListingOptions & { only?: 'links' | 'comments' }): Promise<Listing<Submission | Comment>>;
+  getRising(options?: ListingOptions): Promise<Listing<Submission>>;
   getRules(): Promise<{ rules: Rule[]; site_rules: string[] }>;
   getSettings(): Promise<SubredditSettings>;
-  getSpam(options?: ListingOptions & { only?: 'links' | 'comments' }): Listing<Submission | Comment>;
+  getSpam(options?: ListingOptions & { only?: 'links' | 'comments' }): Promise<Listing<Submission | Comment>>;
   getSticky(options?: { num?: number }): Promise<Submission>;
   getStylesheet(): Promise<string>;
   getSubmitText(): Promise<string>;
-  getTop(options?: ListingOptions & { time?: Timespan }): Listing<Submission>;
-  getUnmoderated(options?: ListingOptions & { only?: 'links' | 'comments' }): Listing<Submission | Comment>;
+  getTop(options?: ListingOptions & { time?: Timespan }): Promise<Listing<Submission>>;
+  getUnmoderated(options?: ListingOptions & { only?: 'links' | 'comments' }): Promise<Listing<Submission | Comment>>;
   getUserFlair(name: string): Promise<FlairTemplate>;
-  getUserFlairList(options?: ListingOptions & { name?: string; }): Listing<UserFlair>;
+  getUserFlairList(options?: ListingOptions & { name?: string; }): Promise<Listing<UserFlair>>;
   getUserFlairTemplates(): Promise<FlairTemplate[]>;
-  getWikiBannedUsers(options?: ListingOptions & { name?: string }): Listing<BannedUser>;
-  getWikiContributors(options?: ListingOptions & { name?: string }): Listing<Contributor>;
+  getWikiBannedUsers(options?: ListingOptions & { name?: string }): Promise<Listing<BannedUser>>;
+  getWikiContributors(options?: ListingOptions & { name?: string }): Promise<Listing<Contributor>>;
   getWikiPage(name: string): WikiPage;
   getWikiPages(): Promise<WikiPage[]>;
-  getWikiRevisions(options?: ListingOptions): Listing<WikiPageRevision>;
+  getWikiRevisions(options?: ListingOptions): Promise<Listing<WikiPageRevision>>;
   hideMyFlair(): Promise<this>;
   inviteModerator(options: { name: string; permissions?: ModeratorPermission[]; }): Promise<this>;
   leaveContributor(): Promise<this>;
@@ -151,7 +151,7 @@ export default class Subreddit extends RedditContent<Subreddit> {
   removeModerator(options: { name: string; }): Promise<this>;
   removeWikiContributor(options: { name: string; }): Promise<this>;
   revokeModeratorInvite(options: { name: string; }): Promise<this>;
-  search(options: BaseSearchOptions): Listing<Submission>;
+  search(options: BaseSearchOptions): Promise<Listing<Submission>>;
   selectMyFlair(options: { flair_template_id: string; text?: string; }): Promise<this>;
   setModeratorPermissions(options: { name: string; permissions: ModeratorPermission; }): Promise<this>;
   setMultipleUserFlairs(flairs: Array<{
diff --git a/types/snoowrap/dist/objects/WikiPage.d.ts b/types/snoowrap/dist/objects/WikiPage.d.ts
index ab9de1bdf6..88f16e2f23 100644
--- a/types/snoowrap/dist/objects/WikiPage.d.ts
+++ b/types/snoowrap/dist/objects/WikiPage.d.ts
@@ -13,8 +13,8 @@ export default class WikiPage extends RedditContent<WikiPage> {
   addEditor(options: { name: string; }): Promise<this>;
   edit(options: EditOptions): Promise<this>;
   editSettings(options: Settings): Promise<this>;
-  getDiscussions(options?: ListingOptions): Listing<Submission>;
-  getRevisions(options?: ListingOptions): Listing<WikiPageRevision>;
+  getDiscussions(options?: ListingOptions): Promise<Listing<Submission>>;
+  getRevisions(options?: ListingOptions): Promise<Listing<WikiPageRevision>>;
   getSettings(): Promise<Settings>;
   hideRevision(options: { id: string; }): Promise<this>;
   removeEditor(options: { name: string; }): Promise<this>;
diff --git a/types/snoowrap/snoowrap-tests.ts b/types/snoowrap/snoowrap-tests.ts
index b83a9514f1..61aca46ffa 100644
--- a/types/snoowrap/snoowrap-tests.ts
+++ b/types/snoowrap/snoowrap-tests.ts
@@ -81,3 +81,7 @@ export function submissionSearch(query: string, subreddit: string): Promise<List
 export function subredditSearch(query: string): Promise<Listing<Subreddit>> {
   return r.searchSubreddits({ query });
 }
+
+export function getHotFromSubreddit(subreddit: string): Promise<Listing<Submission>> {
+  return r.getSubreddit(subreddit).getHot({ limit: 10 });
+}

From 7abf322d4eeed043575c2e9234c54ff2d693816f Mon Sep 17 00:00:00 2001
From: Martin Helmich <kontakt@martin-helmich.de>
Date: Tue, 29 Jan 2019 00:39:51 +0100
Subject: [PATCH 57/61] [vis] DataSet.get may return null + type parameter for
 DataSet.map (#32570)

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

diff --git a/types/vis/index.d.ts b/types/vis/index.d.ts
index 84ff769270..187c01c9b7 100644
--- a/types/vis/index.d.ts
+++ b/types/vis/index.d.ts
@@ -459,7 +459,7 @@ export class DataSet<T extends DataItem | DataGroup | Node | Edge> {
    * @returns When no item is found, null is returned when a single item was requested,
    * and and empty Array is returned in case of multiple id's.
    */
-  get(id: IdType, options?: DataSelectionOptions<T>): T;
+  get(id: IdType, options?: DataSelectionOptions<T>): T|null;
 
   /**
    * Get multiple items from the DataSet.
@@ -494,7 +494,7 @@ export class DataSet<T extends DataItem | DataGroup | Node | Edge> {
    * @param [options] Optional options.
    * @returns The mapped items.
    */
-  map(callback: (item: T, id: IdType) => any, options?: DataSelectionOptions<T>): any[];
+  map<M>(callback: (item: T, id: IdType) => M, options?: DataSelectionOptions<T>): M[];
 
   /**
    * Find the item with maximum value of specified field.
@@ -589,7 +589,7 @@ export interface DataSelectionOptions<T> {
   /**
    * Order the items by a field name or custom sort function.
    */
-  order?: string | any;
+  order?: string | ((a: T, b: T) => number);
 
   /**
    * Determine the type of output of the get function.
@@ -597,7 +597,7 @@ export interface DataSelectionOptions<T> {
    * The default returnType is an Array.
    * The Object type will return a JSON object with the ID's as keys.
    */
-  returnType?: string;
+  returnType?: "Array" | "Object";
 }
 
 export class DataView<T extends DataItem | DataGroup> {

From 2e803abbff20cb20cc6ba158d676304d1b3eeedd Mon Sep 17 00:00:00 2001
From: Dale Fenton <fentondale@gmail.com>
Date: Mon, 28 Jan 2019 18:44:17 -0500
Subject: [PATCH 58/61] Add types for Menu.Divider and Menu.Header (#32299)

* add Menu.Divider and Menu.Header to Menu class

* remove csstype dependency, just grab it from React

* update renderToken prop definition from v3.0 upgrade

* add typings for <Token /> and other exported Components, update tests

* fix labelKey type to only allow for property names of an object where the value is a string

* add ClearButton test
---
 types/react-bootstrap-typeahead/index.d.ts    | 316 +++++++++++++++---
 types/react-bootstrap-typeahead/package.json  |   6 -
 .../react-bootstrap-typeahead-tests.tsx       |  92 ++++-
 3 files changed, 343 insertions(+), 71 deletions(-)
 delete mode 100644 types/react-bootstrap-typeahead/package.json

diff --git a/types/react-bootstrap-typeahead/index.d.ts b/types/react-bootstrap-typeahead/index.d.ts
index 52f99825d5..2f1ad8b7be 100644
--- a/types/react-bootstrap-typeahead/index.d.ts
+++ b/types/react-bootstrap-typeahead/index.d.ts
@@ -4,37 +4,121 @@
 //                 Rajab Shakirov <https://github.com/radziksh>
 //                 Paito Anderson <https://github.com/PaitoAnderson>
 //                 Andreas Richter <https://github.com/arichter83>
+//                 Dale Fenton <https://github.com/dalevfenton>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// TypeScript Version: 2.8
-// TODO: <Token> components
+// TypeScript Version: 2.9
 
 import * as React from 'react';
-import * as CSS from 'csstype';
+export type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
+export type StringPropertyNames<T extends object> = { [K in keyof T]: T[K] extends string ? K : never }[keyof T];
 
-export interface TypeaheadFilterbyProps {
-    filterBy: string[];
-    labelKey: (string | (() => void));
-    multiple: boolean;
-    selected: any[];
-    caseSensitive: boolean;
-    ignoreDiacritics: boolean;
+/* ---------------------------------------------------------------------------
+                       Constants and Enumerated Types
+--------------------------------------------------------------------------- */
+export type TypeaheadModel = string|object;
+export type TypeaheadBsSizes = 'large' | 'lg' | 'small' | 'sm';
+export type TypeaheadAlign = 'justify' | 'left' | 'right';
+// if options is an object, only let labelKey be a key of that object, whose value is a string
+// or a custom label function that takes a single option and returns a string for the label
+export type TypeaheadLabelKey<T extends TypeaheadModel> = T extends object ? (StringPropertyNames<T> | ((option: T) => string)) : never;
+// don't allow onBlur, onChange, onFocus or onKeyDown as members of inputProps
+// those props should be supplied directly to <Typeahead /> or <AsyncTypeahead />
+export interface InputProps extends Omit<React.InputHTMLAttributes<'input'>, 'onBlur'|'onChange'|'onFocus'|'onKeyDown'> { }
+
+/* ---------------------------------------------------------------------------
+                            Typeahead Contexts
+--------------------------------------------------------------------------- */
+export interface TypeaheadContext<T extends TypeaheadModel> {
+    activeIndex?: number;
+    hintText?: string;
+    initialItem?: T;
+    isOnlyResult?: boolean;
+    onActiveItemChange?: (options: T) => void;
+    onAdd?: (option: T) => void;
+    onInitialItemChange?: (option: T) => void;
+    onMenuItemClick?: (option: T, e: Event) => void;
+    selectHintOnEnter?: boolean;
+}
+
+export interface TypeaheadState<T extends TypeaheadModel> {
+    activeIndex: number|null;
+    activeItem: T|null;
+    initialItem: T|null;
+    isFocused: boolean;
+    selected: T[];
+    showMenu: boolean;
+    shownResults: number;
     text: string;
 }
 
-export interface TypeaheadMenuProps<T> {
+export interface InputContainerPropsSingle<T extends TypeaheadModel> {
+    'aria-activedescendant': string;
+    'aria-autocomplete': 'list' | 'both';
+    'aria-expanded': boolean | 'true' | 'false';
+    'aria-haspopup': 'listbox';
+    'aria-owns': string;
+    autoComplete: string;
+    disabled: boolean;
+    inputRef: React.LegacyRef<HTMLInputElement>;
+    onBlur: (e: Event) => void;
+    onChange: (selected: T[]) => void;
+    onClick: (e: Event) => void;
+    onFocus: (e: Event) => void;
+    onKeyDown: (e: Event) => void;
+    placeholder: string|null;
+    role: 'combobox';
+    value: string;
+}
+
+export interface InputContainerPropsMultiple<T extends TypeaheadModel> extends Omit<InputContainerPropsSingle<T>, 'role'> {
+    inputClassName: string;
+    labelKey: TypeaheadLabelKey<T>;
+    onRemove: (e: Event) => void;
+    renderToken: (selectedItem: T, props: TypeaheadMenuProps<T>, index: number) => React.ReactNode;
+    role: '';
+    selected: T[];
+}
+
+export type HintedInputContextKeys = 'hintText' | 'initialItem' | 'onAdd' | 'selectHintOnEnter';
+export interface HintedInputContext<T extends TypeaheadModel> extends Pick<TypeaheadContext<T>, HintedInputContextKeys> {}
+
+export type MenuItemContextKeys = 'activeIndex' | 'isOnlyResult' | 'onActiveItemChange' | 'onInitialItemChange' | 'onMenuItemClick';
+export interface MenuItemContext<T extends TypeaheadModel> extends Pick<TypeaheadContext<T>, MenuItemContextKeys> {}
+
+export interface TokenContext {
+    active: boolean;
+    onBlur: (e: any) => void;
+    onClick: (e: any) => void;
+    onFocus: (e: any) => void;
+    onKeyDown: (e: any) => void;
+}
+
+/* ---------------------------------------------------------------------------
+                       Typeahead Props and Component
+--------------------------------------------------------------------------- */
+export interface TypeaheadContainerProps<T extends TypeaheadModel> {
+    activeIndex: number | null;
+    activeItem: T | null;
+    initialItem: T | null;
+    isFocused: boolean;
+    selected: T[];
+    showMenu: boolean;
+    shownResults: number;
     text: string;
 }
 
-export interface TypeaheadProps<T> {
-    /* For localized accessibility: Should return a string indicating the number of results for screen readers. Receives the current results. */
+export interface TypeaheadProps<T extends TypeaheadModel> {
+    /* For localized accessibility: Should return a string indicating the number of results for screen readers.
+    Receives the current results. */
     a11yNumResults?: () => void;
 
-    /* For localized accessibility: Should return a string indicating the number of selections for screen readers. Receives the current selections. */
+    /* For localized accessibility: Should return a string indicating the number of selections for screen readers.
+    Receives the current selections. */
     a11yNumSelected?: () => void;
 
     /* Specify menu alignment. The default value is justify, which makes the menu as wide as the input and truncates long values.
        Specifying left or right will align the menu to that side and the width will be determined by the length of menu item values. */
-    align?: 'justify' | 'left' | 'right';
+    align?: TypeaheadAlign;
 
     /* Allows the creation of new selections on the fly. Any new items will be added to the list of selections,
        but not the list of original options unless handled as such by Typeahead's parent.
@@ -49,7 +133,7 @@ export interface TypeaheadProps<T> {
     bodyContainer?: boolean;
 
     /* Specify the size of the input. */
-    bsSize?: 'large' | 'lg' | 'small' | 'sm';
+    bsSize?: TypeaheadBsSizes;
 
     /* Whether or not filtering should be case-sensitive. */
     caseSensitive?: boolean;
@@ -60,6 +144,9 @@ export interface TypeaheadProps<T> {
     /* The initial value displayed in the text input. */
     defaultInputValue?: string;
 
+     /* Whether or not the menu is displayed upon initial render. */
+    defaultOpen?: boolean;
+
     /* Specify any pre-selected options. Use only if you want the component to be uncontrolled. */
     defaultSelected?: T[];
 
@@ -74,7 +161,10 @@ export interface TypeaheadProps<T> {
     emptyLabel?: string;
 
     /* Either an array of fields in option to search, or a custom filtering callback. */
-    filterBy?: (string[] | ((option: T | string, props: TypeaheadFilterbyProps) => boolean));
+    filterBy?: (string[] | ((option: T, props: AllTypeaheadOwnAndInjectedProps<T>) => boolean));
+
+    /* Whether or not to automatically adjust the position of the menu when it reaches the viewport boundaries. */
+    flip?: boolean;
 
     /* Highlights the menu item if there is only one result and allows selecting that item by hitting enter.
        Does not work with allowNew. */
@@ -84,7 +174,7 @@ export interface TypeaheadProps<T> {
     ignoreDiacritics?: boolean;
 
     /* Props to be applied directly to the input. onBlur, onChange, onFocus, and onKeyDown are ignored. */
-    inputProps?: object;
+    inputProps?: InputProps;
 
     /* Bootstrap 4 only. Adds the `is-invalid` classname to the `form-control`. */
     isInvalid?: boolean;
@@ -95,8 +185,9 @@ export interface TypeaheadProps<T> {
     /* Bootstrap 4 only. Adds the `is-valid` classname to the `form-control`. */
     isValid?: boolean;
 
-    /* Specify which option key to use for display or a render function. By default, the selector will use the label key. */
-    labelKey?: string | ((option: T | string) => string);
+    /* Specify which option key to use for display or a render function.
+       By default, the selector will use the label key. */
+    labelKey?: TypeaheadLabelKey<T>;
 
     /* Maximum height of the dropdown menu. */
     maxHeight?: string;
@@ -105,6 +196,9 @@ export interface TypeaheadProps<T> {
        so as not to render too many DOM nodes in the case of large data sets. */
     maxResults?: number;
 
+    /* Id applied to the top-level menu element. Required for accessibility. */
+    menuId?: string;
+
     /* Number of input characters that must be entered before showing results. */
     minLength?: number;
 
@@ -115,28 +209,35 @@ export interface TypeaheadProps<T> {
     newSelectionPrefix?: string;
 
     /* Invoked when the input is blurred. Receives an event. */
-    onBlur?: (e: Event) => any;
+    onBlur?: (e: Event) => void;
 
     /* Invoked whenever items are added or removed. Receives an array of the selected options. */
-    onChange?: (selected: T[]) => any;
+    onChange?: (selected: T[]) => void;
 
     /* Invoked when the input is focused. Receives an event. */
-    onFocus?: (e: Event) => any;
+    onFocus?: (e: Event) => void;
 
     /* Invoked when the input value changes. Receives the string value of the input, as well as the original event. */
-    onInputChange?: (input: string, e: Event) => any;
+    onInputChange?: (input: string, e: Event) => void;
 
     /* Invoked when a key is pressed. Receives an event. */
-    onKeyDown?: (e: Event) => any;
+    onKeyDown?: (e: Event) => void;
 
-    /* Invoked when the menu is hidden. */
-    onMenuHide?: (e: Event) => any;
+    /* DEPRECATED: Invoked when the menu is hidden. */
+    onMenuHide?: () => void;
 
-    /* Invoked when the menu is shown. */
-    onMenuShow?: (e: Event) => any;
+    /* DEPRECATED: Invoked when the menu is shown. */
+    onMenuShow?: () => void;
+
+    /* 	Invoked when menu visibility changes. */
+    onMenuToggle?: (show: boolean) => void;
 
     /* Invoked when the pagination menu item is clicked. */
-    onPaginate?: (e: Event) => any;
+    onPaginate?: (e: Event, numResults: number) => void;
+
+    /* Whether or not the menu should be displayed. undefined allows the component to control visibility,
+    while true and false show and hide the menu, respectively. */
+    open?: boolean;
 
     /* Full set of options, including any pre-selected options. */
     options: T[];
@@ -151,13 +252,13 @@ export interface TypeaheadProps<T> {
     placeholder?: string;
 
     /* Callback for custom menu rendering. */
-    renderMenu?: (results: Array<T | string>, menuProps: any) => any;
+    renderMenu?: (results: T[], menuProps: any) => React.ReactNode;
 
     /* Provides a hook for customized rendering of menu item contents. */
-    renderMenuItemChildren?: (option: T, props: TypeaheadMenuProps<T>, index: number) => any;
+    renderMenuItemChildren?: (option: T, props: TypeaheadMenuProps<T>, index: number) => React.ReactNode;
 
     /* Provides a hook for customized rendering of tokens when multiple selections are enabled. */
-    renderToken?: (selectedItem: T | string, onRemove: () => void) => any;
+    renderToken?: (selectedItem: T, props: TypeaheadMenuProps<T>, index: number) => React.ReactNode;
 
     /* The selected option(s) displayed in the input. Use this prop if you want to control the component via its parent. */
     selected?: T[];
@@ -166,9 +267,13 @@ export interface TypeaheadProps<T> {
     selectHintOnEnter?: boolean;
 }
 
-export const Typeahead: React.ClassicComponentClass<TypeaheadProps<any>>;
+export type AllTypeaheadOwnAndInjectedProps<T extends TypeaheadModel> = TypeaheadProps<T> & TypeaheadContainerProps<T>;
+export class Typeahead<T extends TypeaheadModel> extends React.Component<TypeaheadProps<T>> { }
 
-export interface AsyncTypeaheadProps<T> extends TypeaheadProps<T> {
+/* ---------------------------------------------------------------------------
+                       AsyncTypeahead Props and Component
+--------------------------------------------------------------------------- */
+export interface AsyncTypeaheadProps<T extends TypeaheadModel> extends TypeaheadProps<T> {
     /* 	Delay, in milliseconds, before performing search. */
     delay?: number;
 
@@ -179,45 +284,148 @@ export interface AsyncTypeaheadProps<T> extends TypeaheadProps<T> {
     onSearch: (query: string) => void;
 
     /* Message displayed in the menu when there is no user input. */
-    promptText?: string;
+    promptText?: React.ReactNode;
 
     /* Message to display in the menu while the request is pending. */
-    searchText?: string;
+    searchText?: React.ReactNode;
 
     /* Whether or not the component should cache query results. */
     useCache?: boolean;
 }
 
-export const AsyncTypeahead: React.ClassicComponentClass<AsyncTypeaheadProps<any>>;
+export class AsyncTypeahead<T extends TypeaheadModel> extends React.Component<AsyncTypeaheadProps<T>> { }
 
-export interface HighligherProps<T> {
-    key?: string;
-    search: string;
-    optionId?: any;
+/* ---------------------------------------------------------------------------
+        TypeaheadInputSingle & TypeaheadInputMulti Props and Component
+--------------------------------------------------------------------------- */
+export interface BaseTypeaheadInputProps extends React.InputHTMLAttributes<'input'> {
+    type: 'text';
 }
 
-export const Highlighter: React.ClassicComponentClass<HighligherProps<any>>;
+export interface TypeaheadSingleInputWithHocProps<T extends TypeaheadModel> extends
+    Omit<BaseTypeaheadInputProps, keyof InputContainerPropsSingle<T>>,
+    InputContainerPropsSingle<T> {}
 
-export interface MenuProps<T> {
+export interface TypeaheadMulitInputWithHocProps<T extends TypeaheadModel> extends
+    Omit<BaseTypeaheadInputProps, keyof InputContainerPropsMultiple<T>>,
+    HintedInputContext<T>,
+    InputContainerPropsMultiple<T> {}
+
+export type TypeaheadInputPropKeys = 'bsSize'|'disabled'|'inputProps'|'labelKey'|'multiple'|
+                                     'onBlur'|'onChange'|'onFocus'|'onKeyDown'|'placeholder'|'renderToken'|'selected';
+
+export type TypeaheadInputProps<T extends TypeaheadModel> = Pick<TypeaheadProps<T>, TypeaheadInputPropKeys>;
+
+export class TypeaheadInputSingle<T extends TypeaheadModel> extends React.Component<TypeaheadSingleInputWithHocProps<T>> { }
+export class TypeaheadInputMulti<T extends TypeaheadModel> extends React.Component<TypeaheadMulitInputWithHocProps<T>> { }
+
+/* ---------------------------------------------------------------------------
+                       Highlighter Props and Component
+--------------------------------------------------------------------------- */
+export interface HighligherProps {
+    children: React.ReactNode;
+    search: string;
+}
+
+export class Highlighter extends React.PureComponent<HighligherProps> { }
+
+/* ---------------------------------------------------------------------------
+                       ClearButton Props and Component
+--------------------------------------------------------------------------- */
+export interface ClearButtonProps extends React.HTMLAttributes<'button'> {
+    bsSize?: TypeaheadBsSizes;
+    label?: string;
+    onClick: React.HTMLAttributes<'button'>['onClick']; // make onClick requried
+}
+
+export const ClearButton: React.FunctionComponent<ClearButtonProps>;
+
+/* ---------------------------------------------------------------------------
+                       Loader Props and Component
+--------------------------------------------------------------------------- */
+export interface LoaderProps {
+    bsSize: TypeaheadBsSizes;
+}
+
+export const Loader: React.FunctionComponent<LoaderProps>;
+
+/* ---------------------------------------------------------------------------
+                       AutosizeInput Props and Component
+--------------------------------------------------------------------------- */
+export interface AutosizeInputProps extends Pick<React.InputHTMLAttributes<'input'>, 'className' | 'style'> {
+    inputClassName?: string;
+    inputRef?: React.LegacyRef<HTMLInputElement>;
+    inputStyle?: Pick<React.CSSProperties, 'boxSizing' | 'width'>;
+    style: React.CSSProperties;
+}
+
+export class AutosizeInput extends React.Component<AutosizeInputProps> { }
+
+/* ---------------------------------------------------------------------------
+                       Menu Props and Component
+--------------------------------------------------------------------------- */
+export interface MenuProps {
     id: string;
     className?: string;
     emptyLabel?: string;
-    innerRef?: string;
+    innerRef?: React.LegacyRef<HTMLUListElement>;
     maxHeight?: string;
-    style?: CSS.Properties;
+    style?: React.CSSProperties;
+    text?: string;
 }
 
-export const Menu: React.ClassicComponentClass<MenuProps<any>>;
+export type MenuHeaderProps = Omit<React.HTMLProps<'li'>, 'className'>;
 
-export interface MenuItemProps<T> {
+export class Menu extends React.Component<MenuProps> {
+    static Divider: React.FunctionComponent;
+    static Header: React.FunctionComponent<MenuHeaderProps>;
+}
+
+/* ---------------------------------------------------------------------------
+                       TypeaheadMenu Props and Component
+--------------------------------------------------------------------------- */
+// prop names that Typeahead provides to TypeaheadMenu
+export type TypeaheadMenuPropsPick = 'labelKey' | 'newSelectionPrefix'| 'options' | 'renderMenuItemChildren';
+export interface TypeaheadMenuProps<T extends TypeaheadModel> extends MenuProps, Pick<AllTypeaheadOwnAndInjectedProps<T>, TypeaheadMenuPropsPick> {}
+export class TypeaheadMenu<T extends TypeaheadModel> extends React.Component<TypeaheadMenuProps<T>> { }
+
+/* ---------------------------------------------------------------------------
+                       Menu Item Props and Component
+--------------------------------------------------------------------------- */
+export interface BaseMenuItemProps extends React.HTMLProps<'li'> {
+    active?: boolean;
+}
+export class BaseMenuItem extends React.Component<BaseMenuItemProps> { }
+
+export interface MenuItemProps<T extends TypeaheadModel> extends BaseMenuItemProps {
     option: T;
     position: number;
     label?: string;
-    active?: boolean;
-    className?: string;
-    disabled?: boolean;
-    onClick?: (e: Event) => any;
-    onMouseDown?: (e: Event) => any;
 }
 
-export const MenuItem: React.ClassicComponentClass<MenuItemProps<any>>;
+export class MenuItem<T extends TypeaheadModel> extends React.Component<MenuItemProps<T>> { }
+
+/* ---------------------------------------------------------------------------
+                       Overlay Props and Component
+--------------------------------------------------------------------------- */
+export type OverlayTypeaheadProps = Pick<TypeaheadProps<any>, 'align' | 'dropup' | 'flip' | 'onMenuHide' | 'onMenuShow' | 'onMenuToggle'>;
+
+export interface OverlayProps extends OverlayTypeaheadProps {
+    children?: React.ReactNode;
+    className?: string;
+    container: HTMLElement;
+    referenceElement?: HTMLElement;
+    show?: boolean;
+}
+
+export class Overlay extends React.Component<OverlayProps> { }
+
+/* ---------------------------------------------------------------------------
+                       Token Props and Component
+--------------------------------------------------------------------------- */
+export interface TokenProps extends React.HTMLProps<'div'> {
+    active?: boolean;
+    onRemove?: () => void; // Token does not invoke onRemove with any parameters
+}
+
+export class Token extends React.Component<TokenProps> { }
diff --git a/types/react-bootstrap-typeahead/package.json b/types/react-bootstrap-typeahead/package.json
deleted file mode 100644
index e6696d08e7..0000000000
--- a/types/react-bootstrap-typeahead/package.json
+++ /dev/null
@@ -1,6 +0,0 @@
-{
-  "private": true,
-  "dependencies": {
-    "csstype": "^2.2.0"
-  }
-}
diff --git a/types/react-bootstrap-typeahead/react-bootstrap-typeahead-tests.tsx b/types/react-bootstrap-typeahead/react-bootstrap-typeahead-tests.tsx
index c77052a3c6..7e2c3a29a6 100644
--- a/types/react-bootstrap-typeahead/react-bootstrap-typeahead-tests.tsx
+++ b/types/react-bootstrap-typeahead/react-bootstrap-typeahead-tests.tsx
@@ -1,25 +1,78 @@
 import * as React from 'react';
-import { Typeahead, Highlighter, Menu, MenuItem } from 'react-bootstrap-typeahead';
+import { ClearButton, Typeahead, Highlighter, Menu, MenuItem, Token } from 'react-bootstrap-typeahead';
 
-const options = [
-    { name: 'Alabama', population: 4780127, capital: 'Montgomery', region: 'South' },
-    { name: 'Alaska', population: 710249, capital: 'Juneau', region: 'West' },
-    { name: 'Arizona', population: 6392307, capital: 'Phoenix', region: 'West' },
-    { name: 'Arkansas', population: 2915958, capital: 'Little Rock', region: 'South' },
-    { name: 'California', population: 37254503, capital: 'Sacramento', region: 'West' },
-    { name: 'Colorado', population: 5029324, capital: 'Denver', region: 'West' },
+interface State {
+    capital: string;
+    name: string;
+    population: number;
+    region: string;
+    setValue: (value: State) => void;
+}
+interface GroupedStates {
+    [key: string]: State[];
+}
+type StringPropertyNames<T> = { [K in keyof T]: T[K] extends string ? K : never }[keyof T];
+type StateKeysValid = StringPropertyNames<State>;
+const options: State[] = [
+    { name: 'Alabama', population: 4780127, capital: 'Montgomery', region: 'South', setValue: () => {} },
+    { name: 'Alaska', population: 710249, capital: 'Juneau', region: 'West', setValue: () => {} },
+    { name: 'Arizona', population: 6392307, capital: 'Phoenix', region: 'West', setValue: () => {} },
+    { name: 'Arkansas', population: 2915958, capital: 'Little Rock', region: 'South', setValue: () => {} },
+    { name: 'California', population: 37254503, capital: 'Sacramento', region: 'West', setValue: () => {} },
+    { name: 'Colorado', population: 5029324, capital: 'Denver', region: 'West', setValue: () => {} },
 ];
 
+const stateNames = options.map(o => o.name);
+
+const groups: GroupedStates = options.reduce((accum: GroupedStates, option: State) => {
+    const optKey = option.name.slice(0, 1).toLowerCase();
+    if (accum[optKey] !== undefined) {
+        accum[optKey].push(option);
+    } else {
+        accum[optKey] = [option];
+    }
+    return accum;
+}, {});
+
 class BasicExample extends React.Component {
     state = {
         multiple: false,
     };
 
+    genCustomMenu = () => {
+        const menuItems = Object.keys(groups).reduce((accum, letter) => {
+            const header = [
+                <Menu.Divider key={`${letter}-start`} />,
+                <Menu.Header key={`${letter}-header`}>
+                    {`States starting with: ${letter.toUpperCase()}`}
+                    <ClearButton onClick={() => {}} />
+                </Menu.Header>,
+                <Menu.Divider key={`${letter}-end`} />,
+            ];
+            const states = groups[letter].map((state: State, index: number) => {
+                return (<MenuItem key={state.name} position={index} option={state}>{state.name}</MenuItem>);
+            });
+            return [...accum, ...header, ...states];
+        }, [] as JSX.Element[]);
+
+        return menuItems;
+    }
+
     render() {
         const { multiple } = this.state;
 
         return (
             <div>
+                <Typeahead
+                    options={stateNames}
+                    placeholder="Choose a name"
+                />
+                <Typeahead
+                    options={stateNames}
+                    placeholder="Choose a name"
+                    multiple
+                    filterBy={(option, props) => (props.text.indexOf(option) !== -1)}
+                />
                 <Typeahead
                     labelKey="name"
                     multiple={multiple}
@@ -33,7 +86,7 @@ class BasicExample extends React.Component {
                     multiple={multiple}
                     options={options}
                     maxHeight='300px'
-                    filterBy={(option, props) => (props.text.indexOf(option) !== -1) }
+                    filterBy={(option, props) => (props.text.indexOf(option.name) !== -1) }
                     placeholder="Choose a state..."
                 />
                 <Typeahead
@@ -41,7 +94,7 @@ class BasicExample extends React.Component {
                     multiple={multiple}
                     options={options}
                     maxHeight='300px'
-                    filterBy={(option, {text}) => (text.indexOf(option) !== -1) }
+                    filterBy={(option, {text}) => (text.indexOf(option.name) !== -1) }
                     placeholder="Choose a state..."
                 />
                 <Typeahead
@@ -49,7 +102,7 @@ class BasicExample extends React.Component {
                     options={options}
                     placeholder="Choose a state..."
                     renderMenuItemChildren={ (option, props, index) =>
-                        <Highlighter key="name" search={props.text}>
+                        <Highlighter key="name" search={props.text || ""}>
                             {option.name} {index}
                         </Highlighter>
                     }
@@ -69,6 +122,23 @@ class BasicExample extends React.Component {
                     ))}
                   </Menu>
                 </Typeahead>
+                <Typeahead
+                    labelKey="name"
+                    options={options}
+                    placeholder="Choose a state..."
+                    renderToken={(selectedItem, props, index) => {
+                        return <Token
+                            active
+                            disabled={false}
+                            tabIndex={5}
+                            href="https://test.com"
+                            onRemove={() => console.log(props.text)}>
+                            {selectedItem.name}<ClearButton onClick={() => {}} />
+                            </Token>;
+                    }}
+                >
+                    <Menu id="menu-id">{...this.genCustomMenu()}</Menu>
+                </Typeahead>
             </div>
         );
     }

From a8f1326ba72ece5f12189e5c8006967a23c014be Mon Sep 17 00:00:00 2001
From: Kosaku Kurino <kousaku.maron@gmail.com>
Date: Tue, 29 Jan 2019 08:48:52 +0900
Subject: [PATCH 59/61] [types/recharts]Add index definitation in PieProps
 (#32441)

* Add index definitation in PieProps

I can not see the "index" parameter in the document, but it actually exists and I added it for frequent use when creating custom labels.

document
http://recharts.org/en-US/api/Pie

* [types/recharts] add PieLabelRenderProps def

PieLabelRenderProps extends PieProps

* fix error

add semi

* update PieProps labels def

```
label?: {
        offsetRadius: number;
    } | React.ReactElement<any> | ContentRenderer<any> | boolean;
```

to:

```
label?: {
        offsetRadius: number;
    } | React.ReactElement<any> | ContentRenderer<PieLabelRenderProps> | boolean;
```

* fix error

```
label?: {
        offsetRadius: number;
    } | React.ReactElement<any> | ContentRenderer<PieLabelRenderProps> | boolean;
```

to:

```
label?: {
        offsetRadius: number;
    } | React.ReactElement<any> | ContentRenderer<PieLabelRenderProps & any> | boolean;
```

* update PieLabelRenderProps properties

add className

* Edit PieRenderProps

add name to PieLabelRenderProps.
delete className from PieLabelRenderProps.

* Update PieLabelRenderProps

update PieLabelRenderProps' name property

* add parameter to PieLabelRenderProps

add parameter to PieLabelRenderProps
---
 types/recharts/index.d.ts | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/types/recharts/index.d.ts b/types/recharts/index.d.ts
index 426e74d6ba..fc127e9251 100644
--- a/types/recharts/index.d.ts
+++ b/types/recharts/index.d.ts
@@ -12,6 +12,7 @@
 //                 Harry Cruse <https://github.com/crusectrl>
 //                 Andrew Palugniok <https://github.com/apalugniok>
 //                 Robert Stigsson <https://github.com/RobertStigsson>
+//                 Kosaku Kurino <https://github.com/kousaku-maron>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 // TypeScript Version: 2.8
 
@@ -451,12 +452,23 @@ export interface PieProps extends EventAttributes, Partial<PresentationAttribute
     labelLine?: object | ContentRenderer<LineProps & any> | React.ReactElement<any> | boolean;
     label?: {
         offsetRadius: number;
-    } | React.ReactElement<any> | ContentRenderer<any> | boolean;
+    } | React.ReactElement<any> | ContentRenderer<PieLabelRenderProps> | boolean;
     activeShape?: object | ContentRenderer<any> | React.ReactElement<any>;
     activeIndex?: number | number[];
     blendStroke?: boolean;
 }
 
+export interface PieLabelRenderProps extends PieProps {
+    name: string;
+    percent?: number;
+    stroke: string;
+    index?: number;
+    textAnchor: string;
+    x: number;
+    y: number;
+    [key: string]: any;
+}
+
 export class Pie extends React.Component<PieProps> { }
 
 // NOTE: the lib's implementation doesn't inherits the event props (it's kept in this definition due to the previous typing definition has it).

From a345bad39bc7f14bf98254b92320028141c28781 Mon Sep 17 00:00:00 2001
From: Ryo Ota <nwtgck@gmail.com>
Date: Tue, 29 Jan 2019 09:13:40 +0900
Subject: [PATCH 60/61] [multiparty] Add types for multiparty.Form#on() methods
 and originalFilename renaming (#32440)

* Add types for multiparty.Form#on() methods

* Rename originalFileName to originalFilename
---
 types/multiparty/index.d.ts | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/types/multiparty/index.d.ts b/types/multiparty/index.d.ts
index ca968fefcf..1dbb3e272b 100644
--- a/types/multiparty/index.d.ts
+++ b/types/multiparty/index.d.ts
@@ -19,6 +19,13 @@ export declare class Form extends events.EventEmitter {
      * @param callback
      */
     parse(request: http.IncomingMessage, callback?: (error: Error, fields: any, files: any) => any): void;
+
+    on(event: "part", listener: (part: Part) => void): this;
+    on(event: "close", listener: () => void): this;
+    on(event: "error", listener: (err: Error) => void): this;
+    on(event: "progress", listener: (bytesReceived: number, bytesExpected: number) => void): this;
+    on(event: "field", listener: (name: string, value: string) => void): this;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
 }
 
 export interface File {
@@ -29,7 +36,7 @@ export interface File {
     /**
      * the filename that the user reports for the file
      */
-    originalFileName: string;
+    originalFilename: string;
     /**
      * the absolute path of the uploaded file on disk
      */
@@ -44,7 +51,7 @@ export interface File {
     size: number;
 }
 
-interface Part extends stream.Readable {
+export interface Part extends stream.Readable {
     /**
      * the headers for this part. For example, you may be interested in content-type
      */

From ea2b36990777f7e09cce172235770c6c9793210a Mon Sep 17 00:00:00 2001
From: Patrick Chatain <patrickchatain@hotmail.com>
Date: Tue, 29 Jan 2019 01:16:21 +0100
Subject: [PATCH 61/61] [Bull] Add missing getJobCountByTypes definition
 (#32514)

* Add getJobCountByTypes definition

* Update index.d.ts

* getJobCountByTypes types can also be a string
---
 types/bull/index.d.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/types/bull/index.d.ts b/types/bull/index.d.ts
index b2fb68d4d7..bbafa0301c 100644
--- a/types/bull/index.d.ts
+++ b/types/bull/index.d.ts
@@ -585,6 +585,11 @@ declare namespace Bull {
      */
     getJobCounts(): Promise<JobCounts>;
 
+    /**
+     * Returns a promise that resolves with the job counts for the given queue of the given types.
+     */
+    getJobCountByTypes(types: string[] | string): Promise<JobCounts>;
+
     /**
      * Returns a promise that resolves with the quantity of completed jobs.
      */