Release 4.0.0 alpha.2 [master]

.editorconfig

@@ -6,4 +6,4 @@ root = true
 # 4 space indentation
 [*.js]
 indent_style = space
-indent_size = 4
+indent_size = 4

.gitattributes

@@ -0,0 +1,4 @@
+/.yarn/**            linguist-vendored
+/.yarn/releases/*    binary
+/.yarn/plugins/**/*  binary
+/.pnp.*              binary linguist-generated

.gitignore

@@ -1,9 +1,10 @@
-build/
 node_modules/
-coverage/
-*.log
-demo/**/dist/**
-/test/ts/*.js
-/test/ts/*.js.map
 .tscache/
 .DS_Store
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions

.lgtm.yml

@@ -1,5 +1,5 @@
 path_classifiers:
   test:
-    - test
+    - '**/test'
   generated:
-    - dist
+    - '**/dist'

.travis.yml

@@ -15,12 +15,14 @@ addons:
 
 before_install:
   - npm install -g grunt-cli
+  - corepack enable
 
-install: npm install
+install:
+  - yarn install
 
 before_script:
-  - grunt install
+  - yarn run dist
 
 script:
-  - npm run test
-  - npm run lint
+  - yarn run test
+  - yarn run lint

.yarnrc.yml

@@ -0,0 +1,11 @@
+logFilters:
+  - level: discard
+    text: "load-grunt-config@npm:0.19.2 doesn't provide grunt (p9ff33), requested by jit-grunt"
+
+nodeLinker: node-modules
+
+plugins:
+  - path: .yarn/plugins/@yarnpkg/plugin-workspace-tools.cjs
+    spec: "@yarnpkg/plugin-workspace-tools"
+
+yarnPath: .yarn/releases/yarn-3.4.1.cjs

README.md

@@ -43,7 +43,6 @@ Further **information**, **examples** and **documentation** can be found at [joi
 * SVG based
 * ... a lot more
 
-
 ## Supported browsers
 
 * Latest Google Chrome (including mobile)
@@ -61,106 +60,107 @@ If you want to work on *JointJS* locally, use the following guidelines to get st
 Make sure you have the following dependencies installed on your system:
 * [Node.js](https://nodejs.org/)
 * [grunt-cli](http://gruntjs.com/using-the-cli)
-* git
+* [git](https://git-scm.com/)
+* [yarn](https://yarnpkg.com/getting-started/install)
+
+Make sure that you are using Yarn version >= 2.0.0, so that you have access to [Yarn workspace ranges](https://yarnpkg.com/features/workspaces#workspace-ranges-workspace) functionality. If you are using [Volta](https://volta.sh/), it will automatically read this restriction from `package.json`.
 
 ### Setup
 
 Clone this git repository:
-```
+```bash
 git clone https://github.com/clientIO/joint.git
 ```
 
-Change into the joint directory:
-```
+Navigate to the `joint` directory:
+```bash
 cd joint
 ```
 
-Install all NPM dependencies:
-```
-npm install
+Install all dependencies:
+```bash
+yarn install
 ```
 
-Generate build files from the source code:
-```
-grunt install
+Generate distribution files from the source code:
+```bash
+yarn run dist
 ```
 
-You are ready now to browse our demos:
+You are now ready to browse our example applications, which combine functionality from multiple JointJS packages:
+```bash
+cd examples
 ```
-cd demo
+Refer to each application's `README.md` file for additional instructions.
+
+You can also browse the demo applications of our JointJS Core package:
+```bash
+cd packages/joint-core/demo
 ```
+Most demos can be run by simply opening the `index.html` file in your browser. Some demos have additional instructions, which you can find in their respective `README.md` files.
 
 ### Tests
 
 To run all tests:
-```
-grunt test
+```bash
+yarn run test
 ```
 
 To run only the server-side tests:
-```
-grunt test:server
+```bash
+yarn run test-server
 ```
 
 To run only the client-side tests:
-```
-grunt test:client
+```bash
+yarn run test-client
 ```
 
+To run only TypeScript tests:
+```bash
+yarn run test-ts
+```
 
 ### Lint
 
 To check for linting errors in `src` and `types` directories:
-
-```
-npm run lint
+```bash
+yarn run lint
 ```
 
 To auto fix errors, run eslint for `src` and `types` directories:
-
-```
-npm run lint:fix
+```bash
+yarn run lint-fix
 ```
 
 ### Code Coverage Reports
 
 To output a code coverage report in HTML:
-```
-grunt test:coverage
+```bash
+yarn run test-coverage
 ```
 
 To output a code coverage report in [lcov format](http://ltp.sourceforge.net/coverage/lcov/geninfo.1.php):
-```
-grunt test:coverage --reporter="lcov"
-```
-
-The output for all unit tests will be saved in the `coverage` directory.
-
-
-### Building Distribution Files
-
-The `dist` directory contains pre-built distribution files. To re-build them, run the following:
-```
-grunt dist
+```bash
+yarn run test-coverage-lcov
 ```
 
+The output for all unit tests will be saved in the `packages/joint-core/coverage` directory.
 
 ## Documentation
 
-The source for the *JointJS* documentation (plus *Geometry* and *Vectorizer* libraries) are included in this repository; see the `docs` directory. The documentation can be built into stand-alone HTML documents like this:
+The source files for the *JointJS* documentation (plus *Geometry* and *Vectorizer* libraries) are included in this repository; see the `packages/joint-core/docs` directory. The documentation can be built into stand-alone HTML documents like this:
+```bash
+yarn run build-docs
 ```
-grunt build:docs
-```
-The output of the above command can be found at `build/docs`.
-
+The output of the above command can be found at `packages/joint-core/build/docs`.
 
 ## Contributors
 
 <a href="https://github.com/clientIO/joint/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=clientIO/joint" />
 </a>
 
-
 ## License
 
 The *JointJS* library is licensed under the [Mozilla Public License 2.0](https://github.com/clientIO/joint/blob/master/LICENSE).