Fix Flow warnings

Author: jessebeach

.flowconfig

@@ -2,3 +2,5 @@
 <PROJECT_ROOT>/lib/.*
 <PROJECT_ROOT>/docs/.*
 <PROJECT_ROOT>/reports/.*
+[options]
+suppress_type=$FlowFixMe

__mocks__/IdentifierMock.js

@@ -1,4 +1,13 @@
-export default function IdentifierMock(ident) {
+/**
+ * @flow
+ */
+
+export type IdentifierMockType = {|
+  type: 'Identifier',
+  name: string,
+|};
+
+export default function IdentifierMock(ident: string): IdentifierMockType {
   return {
     type: 'Identifier',
     name: ident,

__mocks__/JSXAttributeMock.js

@@ -1,7 +1,20 @@
+/**
+ * @flow
+ */
+
 import toAST from 'to-ast'; // eslint-disable-line import/no-extraneous-dependencies
 import JSXExpressionContainerMock from './JSXExpressionContainerMock';
 
-export default function JSXAttributeMock(prop, value, isExpressionContainer = false) {
+export type JSXAttributeMockType = {
+  type: 'JSXAttribute',
+  name: {
+    type: 'JSXIdentifier',
+    name: string,
+  },
+  value: mixed,
+};
+
+export default function JSXAttributeMock(prop: string, value: mixed, isExpressionContainer?: boolean = false): JSXAttributeMockType {
   let astValue;
   if (value && value.type !== undefined) {
     astValue = value;

__mocks__/JSXElementMock.js

@@ -2,26 +2,26 @@
  * @flow
  */
 
-import JSXAttributeMock from './JSXAttributeMock';
+import type { JSXAttributeMockType } from './JSXAttributeMock';
 
-export type TJSXElementMock = {
+export type JSXElementMockType = {
   type: 'JSXElement',
   openingElement: {
     type: 'JSXOpeningElement',
     name: {
       type: 'JSXIdentifier',
       name: string,
     },
-    attributes: Array<JSXAttributeMock>,
+    attributes: Array<JSXAttributeMockType>,
   },
   children: Array<Node>,
 };
 
 export default function JSXElementMock(
   tagName: string,
-  attributes: Array<JSXAttributeMock> = [],
-  children: Array<Node> = [],
-): TJSXElementMock {
+  attributes: Array<JSXAttributeMockType> = [],
+  children?: Array<Node> = [],
+): JSXElementMockType {
   return {
     type: 'JSXElement',
     openingElement: {

__mocks__/JSXExpressionContainerMock.js

@@ -1,4 +1,13 @@
-export default function JSXExpressionContainerMock(exp) {
+/**
+ * @flow
+ */
+
+export type JSXExpressionContainerMockType = {
+  type: 'JSXExpressionContainer',
+  expression: mixed,
+}
+
+export default function JSXExpressionContainerMock(exp: mixed): JSXExpressionContainerMockType {
   return {
     type: 'JSXExpressionContainer',
     expression: exp,

__mocks__/JSXSpreadAttributeMock.js

@@ -3,8 +3,14 @@
  */
 
 import IdentifierMock from './IdentifierMock';
+import type { IdentifierMockType } from './IdentifierMock';
 
-export default function JSXSpreadAttributeMock(identifier: string) {
+export type JSXSpreadAttributeMockType = {
+  type: 'JSXSpreadAttribute',
+  argument: IdentifierMockType,
+};
+
+export default function JSXSpreadAttributeMock(identifier: string): JSXSpreadAttributeMockType {
   return {
     type: 'JSXSpreadAttribute',
     argument: IdentifierMock(identifier),

__mocks__/JSXTextMock.js

@@ -1,7 +1,14 @@
 /**
  * @flow
  */
-export default function JSXTextMock(value: string) {
+
+export type JSXTextMockType = {|
+  type: 'JSXText',
+  value: string,
+  raw: string,
+|};
+
+export default function JSXTextMock(value: string): JSXTextMockType {
   return {
     type: 'JSXText',
     value,

__mocks__/LiteralMock.js

@@ -1,7 +1,14 @@
 /**
  * @flow
  */
-export default function LiteralMock(value: string) {
+
+export type LiteralMockType = {|
+  type: 'Literal',
+  value: string,
+  raw: string,
+|};
+
+export default function LiteralMock(value: string): LiteralMockType {
   return {
     type: 'Literal',
     value,

__mocks__/genInteractives.js

@@ -7,7 +7,8 @@ import includes from 'array-includes';
 import JSXAttributeMock from './JSXAttributeMock';
 import JSXElementMock from './JSXElementMock';
 
-import type { TJSXElementMock } from './JSXElementMock';
+import type { JSXElementMockType } from './JSXElementMock';
+import type { JSXAttributeMockType } from './JSXAttributeMock';
 
 const domElements = [...dom.keys()];
 const roleNames = [...roles.keys()];
@@ -147,7 +148,7 @@ const nonInteractiveRoles = roleNames
   // aria-activedescendant, thus in practice we treat it as a widget.
   .filter((role) => !includes(['toolbar'], role));
 
-export function genElementSymbol(openingElement: Object) {
+export function genElementSymbol(openingElement: Object): string {
   return (
     openingElement.name.name + (openingElement.attributes.length > 0
       ? `${openingElement.attributes
@@ -158,8 +159,8 @@ export function genElementSymbol(openingElement: Object) {
   );
 }
 
-export function genInteractiveElements(): Array<TJSXElementMock> {
-  return Object.keys(interactiveElementsMap).map((elementSymbol: string): TJSXElementMock => {
+export function genInteractiveElements(): Array<JSXElementMockType> {
+  return Object.keys(interactiveElementsMap).map((elementSymbol: string): JSXElementMockType => {
     const bracketIndex = elementSymbol.indexOf('[');
     let name = elementSymbol;
     if (bracketIndex > -1) {
@@ -170,15 +171,15 @@ export function genInteractiveElements(): Array<TJSXElementMock> {
   });
 }
 
-export function genInteractiveRoleElements(): Array<TJSXElementMock> {
-  return [...interactiveRoles, 'button article', 'fakerole button article'].map((value): TJSXElementMock => JSXElementMock(
+export function genInteractiveRoleElements(): Array<JSXElementMockType> {
+  return [...interactiveRoles, 'button article', 'fakerole button article'].map((value): JSXElementMockType => JSXElementMock(
     'div',
     [JSXAttributeMock('role', value)],
   ));
 }
 
-export function genNonInteractiveElements(): Array<TJSXElementMock> {
-  return Object.keys(nonInteractiveElementsMap).map((elementSymbol): TJSXElementMock => {
+export function genNonInteractiveElements(): Array<JSXElementMockType> {
+  return Object.keys(nonInteractiveElementsMap).map((elementSymbol): JSXElementMockType => {
     const bracketIndex = elementSymbol.indexOf('[');
     let name = elementSymbol;
     if (bracketIndex > -1) {
@@ -189,25 +190,25 @@ export function genNonInteractiveElements(): Array<TJSXElementMock> {
   });
 }
 
-export function genNonInteractiveRoleElements() {
+export function genNonInteractiveRoleElements(): Array<JSXElementMockType> {
   return [
     ...nonInteractiveRoles,
     'article button',
     'fakerole article button',
   ].map((value) => JSXElementMock('div', [JSXAttributeMock('role', value)]));
 }
 
-export function genAbstractRoleElements() {
+export function genAbstractRoleElements(): Array<JSXElementMockType> {
   return abstractRoles.map((value) => JSXElementMock('div', [JSXAttributeMock('role', value)]));
 }
 
-export function genNonAbstractRoleElements() {
+export function genNonAbstractRoleElements(): Array<JSXElementMockType> {
   return nonAbstractRoles.map((value) => JSXElementMock('div', [JSXAttributeMock('role', value)]));
 }
 
-export function genIndeterminantInteractiveElements(): Array<TJSXElementMock> {
+export function genIndeterminantInteractiveElements(): Array<JSXElementMockType> {
   return Object.keys(indeterminantInteractiveElementsMap).map((name) => {
-    const attributes = indeterminantInteractiveElementsMap[name].map(({ prop, value }): TJSXElementMock => JSXAttributeMock(prop, value));
+    const attributes = indeterminantInteractiveElementsMap[name].map(({ prop, value }): JSXAttributeMockType => JSXAttributeMock(prop, value));
     return JSXElementMock(name, attributes);
   });
 }

__tests__/__util__/ruleOptionsMapperFactory.js

@@ -9,7 +9,11 @@ type ESLintTestRunnerTestCase = {
   parserOptions: ?Array<mixed>
 };
 
-export default function ruleOptionsMapperFactory(ruleOptions: Array<mixed> = []) {
+type RuleOptionsMapperFactoryType = (
+  params: ESLintTestRunnerTestCase
+) => ESLintTestRunnerTestCase;
+
+export default function ruleOptionsMapperFactory(ruleOptions: Array<mixed> = []): RuleOptionsMapperFactoryType {
   // eslint-disable-next-line
   return ({ code, errors, options, parserOptions }: ESLintTestRunnerTestCase): ESLintTestRunnerTestCase => {
     return {