Obtain WASM/JS files from emscripten-forge (#37)

* Obtain WASM/JS files from emscripten-forge

Co-authored-by: Thorsten Beier <[email protected]>

* Update CI

* Install micromamba in check-release CI

* Install micromamba in prep-release CI run

---------

Co-authored-by: Thorsten Beier <[email protected]>

.github/workflows/check-release.yml

@@ -15,8 +15,13 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+
+      - name: Install micromamba executable
+        uses: mamba-org/setup-micromamba@main
+
       - name: Base Setup
         uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1
+
       - name: Check Release
         uses: jupyter-server/jupyter_releaser/.github/actions/check-release@v2
         with:

.github/workflows/prep-release.yml

@@ -29,7 +29,11 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1
+      - name: Install micromamba executable
+        uses: mamba-org/setup-micromamba@main
+
+      - name: Base Setup
+        uses: jupyterlab/maintainer-tools/.github/actions/base-setup@v1
 
       - name: Prep Release
         id: prep-release

.github/workflows/test.yml

@@ -24,15 +24,21 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Install node
-        uses: actions/setup-node@v4
+      - name: Set conda environment
+        uses: mamba-org/setup-micromamba@main
         with:
-          node-version: 20
+          environment-name: cockle
+          environment-file: environment-dev.yml
+          init-shell: bash
+          cache-downloads: true
 
       - name: Install dependencies
         run: |
           npm install
 
+      - name: Fetch wasm dependencies
+        run: npm run fetch:wasm
+
       - name: Build
         run: |
           npm run build

.gitignore

@@ -5,3 +5,7 @@ tsconfig.tsbuildinfo
 .eslintcache
 playwright-report/
 test-results/
+test/package-lock.json
+*.js
+*.wasm
+cockle_wasm_env/

README.md

@@ -4,10 +4,18 @@ In-browser bash-like shell implemented in a combination of TypeScript and WebAss
 
 Used in the [JupyterLite terminal extension](https://github.com/jupyterlite/terminal).
 
+The commands used here are either built-in commands implemented in TypeScript, or WebAssembly
+commands compiled into .js and .wasm files. The latter are built by
+[Emscripten-forge](https://emscripten-forge.org/) and are added to the `cockle` NPM package using
+a `micromamba` environment as part of the `npm prepack` process.
+
 To build:
 
 ```bash
+micromamba env create -f environment-dev.yml -y
+micromamba activate cockle
 npm install
+npm run fetch:wasm
 npm run build
 npm run lint:check
 ```

environment-dev.yml

@@ -0,0 +1,6 @@
+name: cockle
+channels:
+  - conda-forge
+dependencies:
+  - micromamba
+  - nodejs =20