@khanacademy/graphql-flow 1.1.2 → 2.0.0

package/{dist/parser/parse.js.flow → src/parser/parse.ts}

@@ -1,4 +1,4 @@
-// @flow
+import {isTruthy} from '@khanacademy/wonder-stuff-core';
 import type {
     BabelNodeImportDeclaration,
     BabelNodeVariableDeclarator,
@@ -11,6 +11,8 @@ import traverse from '@babel/traverse'; // eslint-disable-line flowtype-errors/u
 
 import path from 'path';
 
+import {getPathWithExtension} from './utils';
+
 /**
  * This file is responsible for finding all gql`-annotated
  * template strings in a set of provided files, and for resolving
@@ -40,40 +42,54 @@ import path from 'path';
  *   in `gqlOp<Type>()` or not (to inform an auto-wrapper of the future)
  */
 
-export type Template = {|
-    literals: Array<string>,
-    expressions: Array<Document | Import>,
-    loc: Loc,
-|};
-export type Loc = {start: number, end: number, path: string, line: number};
+export type Template = {
+    literals: Array<string>
+    expressions: Array<Document | Import>
+    loc: Loc
+};
+export type Loc = {
+    start: number
+    end: number
+    path: string
+    line: number
+};
 
-export type Document = {|
-    type: 'document',
-    source: Template,
-|};
-export type Import = {|
-    type: 'import',
-    name: string,
-    path: string,
-    loc: Loc,
-|};
+export type Document = {
+    type: 'document'
+    source: Template
+};
+export type Import = {
+    type: 'import'
+    name: string
+    path: string
+    loc: Loc
+};
 
-export type Operation = {|
-    source: Template,
+export type Operation = {
+    source: Template
     // TODO: Determine if an operation is already wrapped
     // in `gqlOp` so we can automatically wrap if needed.
     // needsWrapping: boolean,
-|};
+};
 
-export type FileResult = {|
-    path: string,
-    operations: Array<Operation>,
-    exports: {[key: string]: Document | Import},
-    locals: {[key: string]: Document | Import},
-    errors: Array<{loc: Loc, message: string}>,
-|};
+export type FileResult = {
+    path: string
+    operations: Array<Operation>
+    exports: {
+        [key: string]: Document | Import
+    }
+    locals: {
+        [key: string]: Document | Import
+    }
+    errors: Array<{
+        loc: Loc
+        message: string
+    }>
+};
 
-export type Files = {[path: string]: FileResult};
+export type Files = {
+    [path: string]: FileResult
+};
 
 /**
  * Finds all referenced imports that might possibly be relevant
@@ -84,11 +100,12 @@ export type Files = {[path: string]: FileResult};
  * from a graphql template are treated as relevant.
  */
 const listExternalReferences = (file: FileResult): Array<string> => {
-    const paths = {};
+    const paths: Record<string, any> = {};
     const add = (v: Document | Import, followImports: boolean) => {
         if (v.type === 'import') {
             if (followImports) {
-                paths[v.path] = true;
+                const absPath = getPathWithExtension(v.path);
+                paths[absPath] = true;
             }
         } else {
             v.source.expressions.forEach((expr) => add(expr, true));
@@ -123,7 +140,10 @@ const listExternalReferences = (file: FileResult): Array<string> => {
 
 export const processFile = (
     filePath: string,
-    contents: string | {text: string, resolvedPath: string},
+    contents: string | {
+        text: string
+        resolvedPath: string
+    },
 ): FileResult => {
     const dir = path.dirname(filePath);
     const result: FileResult = {
@@ -137,7 +157,7 @@ export const processFile = (
         typeof contents === 'string' ? filePath : contents.resolvedPath;
     const text = typeof contents === 'string' ? contents : contents.text;
     const plugins = resolved.match(/\.tsx?$/)
-        ? ['typescript', filePath.endsWith('x') ? 'jsx' : null].filter(Boolean)
+        ? ['typescript', filePath.endsWith('x') ? 'jsx' : null].filter(isTruthy)
         : [['flow', {enums: true}], 'jsx'];
     /* eslint-disable flowtype-errors/uncovered */
     const ast: BabelNodeFile = parse(text, {
@@ -147,7 +167,9 @@ export const processFile = (
     });
     /* eslint-enable flowtype-errors/uncovered */
     const gqlTagNames = [];
-    const seenTemplates: {[key: number]: Document | false} = {};
+    const seenTemplates: {
+        [key: number]: Document | false
+    } = {};
 
     ast.program.body.forEach((toplevel) => {
         if (toplevel.type === 'ImportDeclaration') {
@@ -173,7 +195,7 @@ export const processFile = (
                 const importPath = source.value.startsWith('.')
                     ? path.resolve(path.join(dir, source.value))
                     : source.value;
-                toplevel.specifiers?.forEach((spec) => {
+                toplevel.specifiers?.forEach((spec: unknown) => {
                     if (
                         spec.type === 'ExportSpecifier' &&
                         spec.exported.type === 'Identifier'
@@ -192,7 +214,7 @@ export const processFile = (
                     }
                 });
             } else {
-                toplevel.specifiers?.forEach((spec) => {
+                toplevel.specifiers?.forEach((spec: unknown) => {
                     if (spec.type === 'ExportSpecifier') {
                         const local = result.locals[spec.local.name];
                         if (local && spec.exported.type === 'Identifier') {
@@ -282,7 +304,7 @@ export const processFile = (
 
     /* eslint-disable flowtype-errors/uncovered */
     traverse(ast, {
-        TaggedTemplateExpression(path) {
+        TaggedTemplateExpression(path: unknown) {
             visitTpl(path.node, (name) => {
                 const binding = path.scope.getBinding(name);
                 const start = binding.path.node.init
@@ -303,10 +325,10 @@ export const processFile = (
 const processTemplate = (
     tpl: BabelNodeTaggedTemplateExpression,
     result: FileResult,
-    getTemplate?: (name: string) => Document | null,
     // getBinding?: (name: string) => Binding,
     // seenTemplates,
-): ?Template => {
+    getTemplate?: (name: string) => Document | null,
+): Template | null | undefined => {
     // 'cooked' is the string as runtime javascript will see it.
     const literals = tpl.quasi.quasis.map((q) => q.value.cooked || '');
     const expressions = tpl.quasi.expressions.map(
@@ -344,7 +366,7 @@ const processTemplate = (
     }
     return {
         literals,
-        expressions: expressions.filter(Boolean),
+        expressions: expressions.filter(isTruthy),
         loc: {
             line: tpl.loc?.start.line ?? -1,
             start: tpl.start ?? -1,
@@ -354,18 +376,16 @@ const processTemplate = (
     };
 };
 
-const getLocals = (
-    dir,
-    toplevel: BabelNodeImportDeclaration,
-    myPath: string,
-): ?{[key: string]: Import} => {
+const getLocals = (dir: unknown, toplevel: BabelNodeImportDeclaration, myPath: string): {
+    [key: string]: Import
+} | null | undefined => {
     if (toplevel.importKind === 'type') {
         return null;
     }
     const importPath = toplevel.source.value.startsWith('.')
         ? path.resolve(path.join(dir, toplevel.source.value))
         : toplevel.source.value;
-    const locals = {};
+    const locals: Record<string, any> = {};
     toplevel.specifiers.forEach((spec) => {
         if (spec.type === 'ImportDefaultSpecifier') {
             locals[spec.local.name] = {
@@ -391,9 +411,10 @@ const getLocals = (
 
 export const processFiles = (
     filePaths: Array<string>,
-    getFileSource: (
-        path: string,
-    ) => string | {text: string, resolvedPath: string},
+    getFileSource: (path: string) => string | {
+        text: string
+        resolvedPath: string
+    },
 ): Files => {
     const files: Files = {};
     const toProcess = filePaths.slice();

package/{dist/parser/resolve.js.flow → src/parser/resolve.ts}

@@ -1,18 +1,19 @@
-// @flow
 import gql from 'graphql-tag';
+import {getPathWithExtension} from './utils';
 import type {DocumentNode} from 'graphql/language/ast';
 import type {FileResult, Files, Import, Template, Document} from './parse';
 
 export type Resolved = {
     [key: string]: {
-        document: DocumentNode,
-        raw: Template,
-    },
+        document: DocumentNode
+        raw: Template
+    }
 };
 
-export const resolveDocuments = (
-    files: Files,
-): {resolved: Resolved, errors: FileResult['errors']} => {
+export const resolveDocuments = (files: Files): {
+    resolved: Resolved
+    errors: FileResult['errors']
+} => {
     const resolved: Resolved = {};
     const errors: FileResult['errors'] = [];
     Object.keys(files).forEach((path) => {
@@ -34,27 +35,30 @@ const resolveImport = (
     expr: Import,
     files: Files,
     errors: FileResult['errors'],
-    seen: {[key: string]: true},
-): ?Document => {
-    if (seen[expr.path]) {
+    seen: {
+        [key: string]: true
+    },
+): Document | null | undefined => {
+    const absPath: string = getPathWithExtension(expr.path);
+    if (seen[absPath]) {
         errors.push({
             loc: expr.loc,
-            message: `Circular import ${Object.keys(seen).join(' -> ')} -> ${
-                expr.path
-            }`,
+            message: `Circular import ${Object.keys(seen).join(
+                ' -> ',
+            )} -> ${absPath}`,
         });
         return null;
     }
-    seen[expr.path] = true;
-    const res = files[expr.path];
+    seen[absPath] = true;
+    const res = files[absPath];
     if (!res) {
-        errors.push({loc: expr.loc, message: `No file ${expr.path}`});
+        errors.push({loc: expr.loc, message: `No file ${absPath}`});
         return null;
     }
     if (!res.exports[expr.name]) {
         errors.push({
             loc: expr.loc,
-            message: `${expr.path} has no valid gql export ${expr.name}`,
+            message: `${absPath} has no valid gql export ${expr.name}`,
         });
         return null;
     }
@@ -70,8 +74,10 @@ const resolveGqlTemplate = (
     files: Files,
     errors: FileResult['errors'],
     resolved: Resolved,
-    seen: {[key: string]: Template},
-): ?DocumentNode => {
+    seen: {
+        [key: string]: Template
+    },
+): DocumentNode | null | undefined => {
     const key = template.loc.path + ':' + template.loc.line;
     if (seen[key]) {
         errors.push({

package/src/parser/utils.ts

@@ -0,0 +1,24 @@
+import fs from 'fs';
+
+export const getPathWithExtension = (pathWithoutExtension: string): string => {
+    if (
+        /\.(less|css|png|gif|jpg|jpeg|js|jsx|ts|tsx|mjs)$/.test(
+            pathWithoutExtension,
+        )
+    ) {
+        return pathWithoutExtension;
+    }
+    if (fs.existsSync(pathWithoutExtension + '.js')) {
+        return pathWithoutExtension + '.js';
+    }
+    if (fs.existsSync(pathWithoutExtension + '.jsx')) {
+        return pathWithoutExtension + '.jsx';
+    }
+    if (fs.existsSync(pathWithoutExtension + '.tsx')) {
+        return pathWithoutExtension + '.tsx';
+    }
+    if (fs.existsSync(pathWithoutExtension + '.ts')) {
+        return pathWithoutExtension + '.ts';
+    }
+    throw new Error("Can't find file at " + pathWithoutExtension);
+};

package/{dist/schemaFromIntrospectionData.js.flow → src/schemaFromIntrospectionData.ts}

@@ -1,4 +1,3 @@
-// @flow
 /**
  * Takes the introspectionQuery response and parses it into the "Schema"
  * type that we use to look up types, interfaces, etc.
@@ -6,9 +5,7 @@
 import type {IntrospectionQuery} from 'graphql';
 import type {Schema} from './types';
 
-export const schemaFromIntrospectionData = (
-    schema: IntrospectionQuery,
-): Schema => {
+export const schemaFromIntrospectionData = (schema: IntrospectionQuery): Schema => {
     const result: Schema = {
         interfacesByName: {},
         typesByName: {},

package/src/types.ts

@@ -0,0 +1,97 @@
+import type {Node} from '@babel/types';
+import type {
+    FragmentDefinitionNode,
+    IntrospectionEnumType,
+    IntrospectionField,
+    IntrospectionInputObjectType,
+    IntrospectionInterfaceType,
+    IntrospectionObjectType,
+    IntrospectionUnionType,
+    SelectionNode,
+} from 'graphql';
+
+export type Selections = ReadonlyArray<SelectionNode>;
+
+export type GenerateConfig = {
+    schemaFilePath: string
+    match?: ReadonlyArray<RegExp | string>
+    exclude?: ReadonlyArray<RegExp | string>
+    typeScript?: boolean
+    scalars?: Scalars
+    strictNullability?: boolean
+    /**
+     * The command that users should run to regenerate the types files.
+     */
+    regenerateCommand?: string
+    readOnlyArray?: boolean
+    splitTypes?: boolean
+    generatedDirectory?: string
+    exportAllObjectTypes?: boolean
+    typeFileName?: string
+    experimentalEnums?: boolean
+    omitFileExtensions?: boolean
+};
+
+export type CrawlConfig = {
+    root: string
+    pragma?: string
+    loosePragma?: string
+    ignorePragma?: string
+    dumpOperations?: string
+};
+
+export type Config = {
+    crawl: CrawlConfig
+    generate: GenerateConfig | Array<GenerateConfig>
+};
+
+export type Schema = {
+    interfacesByName: {
+        [key: string]: IntrospectionInterfaceType & {
+            fieldsByName: {
+                [key: string]: IntrospectionField
+            }
+            possibleTypesByName: {
+                [key: string]: boolean
+            }
+        }
+    }
+    inputObjectsByName: {
+        [key: string]: IntrospectionInputObjectType
+    }
+    typesByName: {
+        [key: string]: IntrospectionObjectType & {
+            fieldsByName: {
+                [key: string]: IntrospectionField
+            }
+        }
+    }
+    unionsByName: {
+        [key: string]: IntrospectionUnionType
+    }
+    enumsByName: {
+        [key: string]: IntrospectionEnumType
+    }
+};
+
+export type Context = {
+    path: Array<string>
+    strictNullability: boolean
+    readOnlyArray: boolean
+    fragments: {
+        [key: string]: FragmentDefinitionNode
+    }
+    schema: Schema
+    scalars: Scalars
+    errors: Array<string>
+    allObjectTypes: null | {
+        [key: string]: Node
+    }
+    typeScript: boolean
+    experimentalEnumsMap?: {
+        [key: string]: Node
+    } // index signature that is populated with declarations
+};
+export type Scalars = {
+    [key: string]: 'string' | 'number' | 'boolean'
+};

package/src/utils.ts

@@ -0,0 +1,73 @@
+import * as babelTypes from '@babel/types';
+import {TSPropertySignature} from '@babel/types';
+
+export const liftLeadingPropertyComments = (property: TSPropertySignature): TSPropertySignature => {
+    return transferLeadingComments(property.typeAnnotation!, property);
+};
+
+export const maybeAddDescriptionComment = <T extends babelTypes.Node>(description: string | null | undefined, node: T): T => {
+    if (description) {
+        addCommentAsLineComments(description, node);
+    }
+    return node;
+};
+
+export function addCommentAsLineComments(
+    description: string,
+    res: babelTypes.Node,
+) {
+    if (res.leadingComments?.length) {
+        res.leadingComments[0].value += '\n\n---\n\n' + description;
+    } else {
+        babelTypes.addComment(
+            res,
+            'leading',
+            '* ' + description,
+            false, // this specifies that it's a block comment, not a line comment
+        );
+    }
+}
+
+export const transferLeadingComments = <T extends babelTypes.Node>(source: babelTypes.Node, dest: T): T => {
+    if (source.leadingComments?.length) {
+        dest.leadingComments = [
+            ...(dest.leadingComments || []),
+            ...source.leadingComments,
+        ];
+        source.leadingComments = [];
+    }
+    return dest;
+};
+
+export function nullableType(type: babelTypes.TSType): babelTypes.TSType {
+    return babelTypes.tsUnionType([type, babelTypes.tsNullKeyword(), babelTypes.tsUndefinedKeyword()]);
+}
+
+export function isnNullableType(type: babelTypes.TSType): boolean {
+    let hasNull = false;
+    let hasUndefined = false;
+    if (type.type === 'TSUnionType') {
+        for (const t of type.types) {
+            if (t.type === 'TSNullKeyword') {
+                hasNull = true;
+            } else if (t.type === 'TSUndefinedKeyword') {
+                hasUndefined = true;
+            }
+        }
+    }
+    return hasNull && hasUndefined;
+}
+
+export function objectTypeFromProperties(properties: babelTypes.TSPropertySignature[]): babelTypes.TSTypeLiteral {
+    let exitingProperties: Record<string, boolean> = {};
+    let filteredProperties = properties.filter((p) => {
+        if (p.key.type === 'Identifier') {
+            if (exitingProperties[p.key.name]) {
+                return false;
+            }
+            exitingProperties[p.key.name] = true;
+        }
+        return true;
+    });
+    return babelTypes.tsTypeLiteral(filteredProperties);
+}

package/tools/{find-files-with-gql.js → find-files-with-gql.ts}

@@ -1,4 +1,3 @@
-// @flow
 const path = require('path');
 const {execSync} = require('child_process');
 
@@ -9,7 +8,7 @@ export const findRepoRoot = (): string => {
         });
         return res.trim();
         // eslint-disable-next-line flowtype-errors/uncovered
-    } catch (err) {
+    } catch (err: any) {
         throw new Error(
             // eslint-disable-next-line flowtype-errors/uncovered
             `Unable to use git rev-parse to find the repository root. ${err.message}`,
@@ -31,7 +30,7 @@ export const findGraphqlTagReferences = (root: string): Array<string> => {
             .split('\n')
             .map((relative) => path.join(root, relative));
         // eslint-disable-next-line flowtype-errors/uncovered
-    } catch (err) {
+    } catch (err: any) {
         throw new Error(
             // eslint-disable-next-line flowtype-errors/uncovered
             `Unable to use git grep to find files with gql tags. ${err.message}`,

package/tsconfig.json

@@ -0,0 +1,110 @@
+{
+  "exclude": ["node_modules/**", "dist/**"],
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "es2018",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "es2015",                                /* Specify what module code is generated. */
+    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+    "moduleResolution": "bundler",                     /* Specify how TypeScript looks up a file from a given module specifier. */
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "allowImportingTsExtensions": true,               /* Allow imports to include TypeScript file extensions. Requires '--moduleResolution bundler' and either '--noEmit' or '--emitDeclarationOnly' to be set. */
+    // "resolvePackageJsonExports": true,                /* Use the package.json 'exports' field when resolving package imports. */
+    "resolvePackageJsonImports": true,                /* Use the package.json 'imports' field when resolving imports. */
+    // "customConditions": [],                           /* Conditions to set in addition to the resolver-specific defaults when resolving imports. */
+    // "resolveJsonModule": true,                        /* Enable importing .json files. */
+    // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+    /* Interop Constraints */
+    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
+
+    /* Type Checking */
+    "strict": true,                                      /* Enable all strict type-checking options. */
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
+  }
+}

package/types/flow-to-ts.d.ts

@@ -0,0 +1 @@
+declare module '@khanacademy/flow-to-ts/dist/convert.bundle';