feat: merged v3 to master

Author: sampotts

.babelrc

@@ -0,0 +1,16 @@
+**/node_modules/**
+**/build/**
+**/dist/**
+.eslintrc.js
+tailwind.config.js
+jest-preprocess.js
+setupFilesAfterEnv.js
+jest.config.js
+tsdx.config.js
+tsdx.config.base.js
+
+types/**
+# enable linter later
+docs/**
+example/**
+coverage

.eslintignore

@@ -0,0 +1,97 @@
+{
+  "extends": ["airbnb-typescript", "prettier"],
+  "plugins": ["simple-import-sort", "import", "prettier"],
+  "env": {
+    "jest": true,
+    "browser": true
+  },
+  "overrides": [
+    {
+      "files": [
+        "packages/components/src/**/**/*.ts",
+        "packages/components/src/**/**/*.tsx",
+        "packages/hooks/src/**/**/*.ts",
+        "packages/hooks/src/**/**/*.tsx",
+        "packages/search-ui/src/**/**/*.ts",
+        "packages/search-ui/src/**/**/*.tsx",
+        "packages/utils/src/**/**/*.ts",
+        "packages/utils/src/**/**/*.tsx",
+        "packages/styles/src/**/**/*.ts",
+        "packages/styles/src/**/**/*.tsx"
+      ],
+      "rules": {
+        // Prettier setup
+        "prettier/prettier": "error",
+
+        // Fix up spacing between declarations
+        "padding-line-between-statements": [
+          "error",
+          {
+            "blankLine": "never",
+            "prev": ["singleline-const", "singleline-let", "singleline-var"],
+            "next": ["singleline-const", "singleline-let", "singleline-var"]
+          }
+        ],
+
+        // Sort imports
+        "sort-imports": "off",
+        "import/order": "off",
+        "simple-import-sort/imports": "error",
+        "simple-import-sort/exports": "error",
+
+        // Named or default is fine
+        "import/prefer-default-export": "off",
+
+        // TODO: We should fix up the paths so we can re-enable this rule
+        // https://github.com/benmosher/eslint-plugin-import/blob/master/docs/rules/no-extraneous-dependencies.md
+        "import/no-extraneous-dependencies": "off",
+
+        // Not required with TS
+        "react/prop-types": "off",
+        "react/require-default-props": "off",
+
+        // Useful feature
+        "react/jsx-props-no-spreading": "off",
+
+        "react/react-in-jsx-scope": "off",
+
+        // Fix TypeScript extension issues
+        // https://github.com/airbnb/javascript/blob/master/packages/eslint-config-airbnb-base/rules/imports.js#L139
+        // https://stackoverflow.com/questions/59265981/typescript-eslint-missing-file-extension-ts-import-extensions
+        "import/extensions": [
+          "error",
+          "ignorePackages",
+          {
+            "js": "never",
+            "mjs": "never",
+            "jsx": "never",
+            "ts": "never",
+            "tsx": "never"
+          }
+        ],
+
+        // Let prettier take care of it
+        "@typescript-eslint/indent": "off",
+
+        // This one is annoying
+        "@typescript-eslint/explicit-function-return-type": "off",
+
+        // Dangling commas make merge/diffs easier
+        "@typescript-eslint/comma-dangle": "off"
+      }
+    }
+  ],
+  "settings": {
+    "react": {
+      "pragma": "h",
+      "version": "detect"
+    }
+  },
+  "parserOptions": {
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    },
+    "project": "./tsconfig.json"
+  }
+}

.eslintrc

@@ -1,75 +1,13 @@
-
-# Created by https://www.gitignore.io/api/node
-
-### 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
+.DS_Store
+node_modules
+dist
 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 (http://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
-
-# built files
-lib/
-dist/
-.docz/
-
-# dev
-dev/
-
-# cache files
-.rpt2_cache/
+node_modules
+package-lock.json
+yarn.lock
+!/yarn.lock
 
-# End of https://www.gitignore.io/api/node
+.yalc
+yalc.lock

.gcloudignore

@@ -1 +1 @@
-10.9
+12.16.1

.gitignore

@@ -0,0 +1,13 @@
+build/
+dist/
+coverage/
+__snapshots__/
+node_modules/
+storybook-static/
+package-lock.json
+yarn.lock
+package.json
+.cache/
+# next.js
+.next/
+out/

.nvmrc

@@ -0,0 +1,7 @@
+{
+  "useTabs": false,
+  "tabWidth": 2,
+  "printWidth": 120,
+  "singleQuote": true,
+  "trailingComma": "all"
+}

.prettierignore

@@ -1,6 +1,7 @@
 language: node_js
-node_js:
-  - "10"
-before_install:
-  - curl -o- -L https://yarnpkg.com/install.sh | bash
-  - export PATH="$HOME/.yarn/bin:$PATH"
+node_js: node
+cache: yarn
+jobs:
+  include:
+    - stage: Test
+      script: yarn test:ci && yarn build

.prettierrc

@@ -0,0 +1,14 @@
+{
+  // See http://go.microsoft.com/fwlink/?LinkId=827846
+  // for the documentation about the extensions.json format
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "wayou.vscode-todo-highlight",
+    "wix.vscode-import-cost",
+    "pflannery.vscode-versionlens",
+    "heybourn.headwind",
+    "bradlc.vscode-tailwindcss",
+    "jpoissonnier.vscode-styled-components"
+  ]
+}

.prettierrc.js

@@ -2,32 +2,79 @@
 
 We recommend that you use an [example](./example) or external app when developing and testing changes to this library.
 
-## Setup
+You can install all the dependencies in the root directory. Since the monorepo uses Lerna and Yarn Workspaces, npm CLI is not supported (only yarn).
 
-You can use linking to see new library changes as you're developing them.
+```sh
+yarn install
+```
+
+This will install all dependencies in each project, build them, and symlink them via Lerna
+
+## Development workflow
 
-In the library repo root:
+In one terminal, run tsdx watch in parallel:
 
-```shell
-$ yarn             # fetches the dependencies
-$ yarn build       # produces a built version of the package
-$ cd dist          # move to the dist directory (now containing the built package)
-$ yarn link        # link the package
-$ cd ..            # go back to the repo root
-$ yarn build:watch # rebuild on changes
+```sh
+yarn start
 ```
 
-Now in an example dir:
+This builds each package to `<packages>/<package>/dist` and runs the project in watch mode so any edits you save inside `<packages>/<package>/src` cause a rebuild to `<packages>/<package>/dist`. The results will stream to to the terminal.
 
-```shell
-$ yarn                   # fetch the dependencies
-$ yarn link sajari-react # use the version of sajari-react in the repo
-$ yarn start             # build/start your app...
+### Using the example/playground
+
+You can play with local packages in the Parcel-powered example/playground.
+
+```sh
+cd example
+yarn install # or yarn install
+yarn start
 ```
 
+This will start the example/playground on `localhost:1234`. If you have lerna running watch in parallel mode in one terminal, and then you run parcel, your playground will hot reload when you make changes to any imported module whose source is inside of `packages/*/src/*`. Note that to accomplish this, each package's `start` command passes TDSX the `--noClean` flag. This prevents Parcel from exploding between rebuilds because of File Not Found errors.
+
+Important Safety Tip: When adding/altering packages in the playground, use `alias` object in package.json. This will tell Parcel to resolve them to the filesystem instead of trying to install the package from NPM. It also fixes duplicate React errors you may run into.
+
+#### Yalc
+
+[Yalc](https://github.com/whitecolor/yalc) is an alternative to `yarn/npm link` (and Parcel aliasing) that many developers find useful because it more closely mimics how NPM works. It works kind of like a local package registry via filesystem and symlinking magic.
+
+To do this, install yalc globally.
+
+Using NPM:
+
+```sh
+npm i yalc -g
+```
+
+Using Yarn:
+
+```sh
+yarn global add yalc
+```
+
+Then in each package's `start` command add a [`yalc publish`](https://github.com/whitecolor/yalc#publish) or `yalc push` as an TSDX `--onSuccess` hook.
+
+```diff
+"scripts": {
+-   "start": "tsdx watch --verbose --noClean",
++   "start": "tsdx watch --verbose --noClean --onSuccess yalc publish",
+    "build": "tsdx build --tsconfig tsconfig.build.json",
+    "test": "tsdx test",
+    "lint": "tsdx lint",
+    "prepublish": "npm run build"
+  },
+```
+
+In your example directory, now add each package via yalc
+
+```sh
+yalc add <package>
+# or
+yalc link <package>
+```
+
+There's definitely room for improvement with this workflow, so please contribute if you come up with something better.
+
 ## Release
 
-1. Update [package.json](package.json) with the new version number
-1. Create a release commit with a message of the form `pkg: release <version>` and push to GitHub
-1. Create a tag with the new version number and push to GitHub
-1. Run `npm publish . --tag latest --access public`
+1. Run `yarn release` which will trigger lerna to bump the appropriate package versions and build changelogs based on commits.