@bldrs-ai/conway 0.8.750 → 0.9.789

package/README.md

@@ -8,52 +8,60 @@ Conway includes two major subcomponents:
 
 ## Getting Started
 
-### Deps
-Conway generates a lot of code. To run code-generation, you'll need to install version 6.0 of the .NET framework.
+### Windows Setup
+1. [Install MinGW-64](https://github.com/msys2/msys2-installer/releases/download/2022-06-03/msys2-x86_64-20220603.exe) and add ```g++.exe``` location to your PATH variable.
 
-On a Ubuntu or Debian style distribution, you can install it like so:
-```
-sudo apt-get update && \
-  sudo apt-get install -y dotnet-sdk-6.0
-```
+### MacOS Setup 
 
-On macOS, it should be installable with brew using:
+1. Install the `gmake` and `node` dependencies via Homebrew (```brew install gmake node```).
+
+### EMSDK Setup
+1. Clone the [EMSDK](https://github.com/emscripten-core/emsdk) repo and add it to your path (see their instructions)
+2. Conway is using `3.1.72`
 ```
-brew install dotnet@6
+> cd $EMSDK
+> ./emsdk install 3.1.72
+> ./emsdk activate 3.1.72
+> cd $CONWAY
+conway> emcc -v
+emcc (Emscripten gcc/clang-like replacement + linker emulating GNU ld) 3.1.72 (437140d149d9c977ffc8b09dbaf9b0f5a02db190)
+...
 ```
 
 ### Initial Build
- 
-Clone the repository, then in the root directory of the repository, run the yarn install, followed by using yarn to initialise the IFC-gen submodule:
-```
-# 1) Setup your EMSDK environment
-# 2) Make sure you're in main repo, not fork
-git pull  # if you get an error about a submodule not found, run yarn submodule-update here and then pull again
-yarn install
-yarn submodule-update
-
-cd dependencies/conway-geom/dependencies/wasm/
-# Answer yes or all to replace files if they've already been unzipped before
-unzip dependencies.zip
-cd -
 
+Clone the Conway repository, then in the root directory of the repository:
+```
+# Make sure EMSDK environment is set up.
+yarn setup
 yarn build
 yarn test
 ```
 
-### Pulling in Updated Source Changes
-After this, you can build using either an incremental build (which will rebuild the typescript only and will lead to the fastest build times), a yarn build (will recompile the wasm module and build the typescript source), or a full rebuild, which will clean all build artefacts and perform code-gen, before running a build.
+### Example Uses
+You can now load your IFC files. From the Conway root:
+1. ```yarn browser model.ifc```
+2. ```yarn validator model.ifc "IFCWINDOW.OverallHeight <= 1500"```
 
-For the incremental build:
+See the full example docs at [Browser.md](examples/Browser.md) and [Validator.md](examples/Validator.md)
+
+## Development
+Update your client with changes since your last sync:
 ```
-yarn build-incremental
+git pull
+yarn setup
 ```
 
-For the wasm / typescript build:
+For the full build of both conway (TypeScript) and conway-geom (WASM subproject):
 ```
 yarn build
 ```
 
+Build just conway, not conway-geom, e.g. for updating just the Conway API or tools:
+```
+yarn build-incremental
+```
+
 For a full, clean rebuild:
 ```
 yarn build-rebuild
@@ -69,8 +77,6 @@ And finally, using the watch functionality, you can also have the code automatic
 yarn build-test-watch
 ```
 
-If you have Visual Studio Code, Conway also comes with a Visual Studio Code workspace to add IDE accessability to these features, and also let you edit the IFC-gen C# code in place.
-
 # Production NPM Build
 ```
 yarn test