Proposal: Monorepo

.eslintignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+coverage

.gitignore

@@ -1,6 +1,7 @@
 node_modules
 coverage
 dist
+lib
 .opt-in
 .opt-out
 .DS_Store

.travis.yml

@@ -7,7 +7,7 @@ notifications:
   email: false
 node_js: '8'
 install: npm install
-script: npm run validate
+script: lerna run validate
 after_success: kcd-scripts travis-after-success
 branches:
   only: master

docs/README.md

@@ -0,0 +1,5 @@
+# DOM Testing Packages
+
+- [dom-testing-library](../packages/dom-testing-library) Core library
+- [react-testing-library](../packages/react-testing-library) Wrapper for React
+- [@dom-testing/addon-async](../packages/dom-testing-addon-async) Async query addon

lerna.json

@@ -0,0 +1,6 @@
+{
+  "packages": [
+    "packages/*"
+  ],
+  "version": "independent"
+}

package.json

@@ -1,73 +1,17 @@
 {
-  "name": "dom-testing-library",
-  "version": "0.0.0-semantically-released",
-  "description": "Simple and complete DOM testing utilities that encourage good testing practices.",
-  "main": "dist/index.js",
-  "umd:main": "dist/dom-testing-library.umd.js",
-  "source": "src/index.js",
-  "typings": "typings",
-  "keywords": [
-    "testing",
-    "ui",
-    "dom",
-    "jsdom",
-    "unit",
-    "integration",
-    "functional",
-    "end-to-end",
-    "e2e"
-  ],
-  "author": "Kent C. Dodds <[email protected]> (http://kentcdodds.com/)",
+  "name": "dom-testing",
+  "private": true,
   "license": "MIT",
-  "engines": {
-    "node": ">=6"
-  },
-  "scripts": {
-    "add-contributor": "kcd-scripts contributors add",
-    "build": "kcd-scripts build && kcd-scripts build --bundle umd --no-clean",
-    "lint": "kcd-scripts lint",
-    "test": "kcd-scripts test",
-    "test:update": "npm test -- --updateSnapshot --coverage",
-    "validate": "kcd-scripts validate",
-    "setup": "npm install && npm run validate -s",
-    "precommit": "kcd-scripts precommit",
-    "dtslint": "dtslint typings"
-  },
-  "files": [
-    "dist",
-    "typings"
+  "workspaces": [
+    "packages/*"
   ],
-  "dependencies": {
-    "pretty-format": "^22.4.3",
-    "mutationobserver-shim": "^0.3.2",
-    "wait-for-expect": "^1.0.0"
+  "scripts": {
+    "postinstall": "npm-run-all bootstrap",
+    "bootstrap": "lerna bootstrap"
   },
   "devDependencies": {
-    "dtslint": "^0.3.0",
-    "jest-dom": "^1.7.0",
-    "jest-in-case": "^1.0.2",
-    "kcd-scripts": "^0.41.0",
-    "microbundle": "^0.4.4"
-  },
-  "eslintConfig": {
-    "extends": "./node_modules/kcd-scripts/eslint.js",
-    "rules": {
-      "import/prefer-default-export": "off",
-      "import/no-unassigned-import": "off",
-      "import/no-useless-path-segments": "off"
-    }
-  },
-  "eslintIgnore": [
-    "node_modules",
-    "coverage",
-    "dist"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/kentcdodds/dom-testing-library.git"
-  },
-  "bugs": {
-    "url": "https://github.com/kentcdodds/dom-testing-library/issues"
-  },
-  "homepage": "https://github.com/kentcdodds/dom-testing-library#readme"
+    "kcd-scripts": "^0.44.0",
+    "lerna": "^3.3.2",
+    "npm-run-all": "^4.1.3"
+  }
 }

packages/dom-testing-addon-async/.eslintignore

@@ -0,0 +1,6 @@
+node_modules
+flow-typed
+lib
+dist
+.cache
+coverage

packages/dom-testing-addon-async/.eslintrc

@@ -0,0 +1,31 @@
+{
+  "parser": "babel-eslint",
+  "plugins": [
+    "flowtype",
+    "prettier",
+    "jsx-a11y"
+  ],
+  "extends": [
+    "prettier",
+    "prettier/flowtype",
+    "prettier/react",
+    "plugin:flowtype/recommended",
+    "plugin:prettier/recommended",
+    "plugin:jsx-a11y/recommended",
+    "react-app"
+  ],
+  "rules": {
+    "prettier/prettier": [
+      "error",
+      {
+        "parser": "flow",
+        "trailingComma": "all"
+      }
+    ]
+  },
+  "env": {
+    "node": true,
+    "browser": true,
+    "jest": true
+  }
+}

packages/dom-testing-addon-async/.flowconfig

@@ -0,0 +1,11 @@
+[ignore]
+
+[include]
+
+[libs]
+
+[lints]
+
+[options]
+
+[strict]

packages/dom-testing-addon-async/.gitignore

@@ -0,0 +1,123 @@
+# File created using '.gitignore Generator' for Visual Studio Code: https://bit.ly/vscode-gig
+
+# Created by https://www.gitignore.io/api/macos,visualstudiocode,node
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# next.js build output
+.next
+
+# nuxt.js build output
+.nuxt
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+
+# End of https://www.gitignore.io/api/macos,visualstudiocode,node
+
+# Custom rules (everything added below won't be overriden by 'Generate .gitignore File' if you use 'Update' option)
+
+/lib/*
+/dist/*
+!/lib/index.js.flow
+!/dist/index.js.flow

packages/dom-testing-addon-async/CODEOWNERS

@@ -0,0 +1,5 @@
+# Maintainers of this addon will be requested for code review
+
+*    @alexkrolick
+*.js @alexkrolick
+*.md @alexkrolick

packages/dom-testing-addon-async/README.md

@@ -0,0 +1,45 @@
+# @dom-testing/addon-async
+
+Async query addon for dom-testing-library
+
+## Usage
+
+### `find*`
+
+Fach of the `get` and `getAll` queries from `dom-testing-library` are wrapped in an async `find` API.
+
+The find APIs return a Promise and retry automatically until they time out. The timeout can be specified as an option in the last argument.
+
+```js
+import { findByLabelText, findByText } from '@dom-testing/addon-async'
+
+fireEvent.click(getByRole('log-in'))
+// This element doesn't appear immediately:
+const usernameElement = await findByLabelText('username', {timeout: 200})
+usernameElement.value = 'chucknorris'
+// wait for error state
+expect(await findByText('Error: Name must be capitalized')).not.toBeNull()
+// expect NOT to see success state
+await expect(findByText('Everything OK!')).rejects.toMatchInlineSnapshot()
+```
+
+### `waitFor`
+
+`waitFor` is a utility function that lets you retry queries until they succeed or time out. Unlike `dom-testing-library#wait`, `waitFor` returns the result of the function. It is used internally to create the find APIs.
+
+The first argument is the query. A new async function is returned if this is the only argument. If there are more arguments, it returns a Promise which resolves with the result of calling the async function with the arguments. If the last argument is an object with a "timeout" key, it will be used as the timeout for the retries. The Promise is rejected with the last error thrown by the callback.
+
+```js
+const usernameElement = await waitFor(getByLabelText, container, 'username')
+usernameElement.value = 'chucknorris'
+```
+
+You can create your own async queries by passing only the first argument:
+
+```js
+const waitForText = waitFor(getByText)
+
+const headline = await waitForText('news flash')
+
+expect(headline).toBeDefined() // do something
+```