Update Yarn and Better Document Dependencies

.github/workflows/package_vscode_plugin.yml

@@ -35,6 +35,7 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version-file: ".node-version"
+      - run: corepack enable
       - name: Build harper-ls
         uses: houseabsolute/actions-rust-cross@v0
         with:

.github/workflows/precommit.yml

@@ -20,6 +20,7 @@ jobs:
       - uses: actions/setup-node@v4
         with:
           node-version-file: ".node-version"
+      - run: corepack enable
       - name: Install `pandoc`
         run: sudo apt-get update && sudo apt-get install pandoc -y
       - name: Install `wasm-pack`

Dockerfile

@@ -14,6 +14,7 @@ RUN wasm-pack build --release --target web
 
 FROM node:${NODE_VERSION} AS node-build
 
+RUN corepack enable
 RUN apt-get update && apt-get install git pandoc -y
 
 RUN mkdir -p /usr/build/

justfile

@@ -16,7 +16,7 @@ build-harperjs: build-wasm
   perl -pi -e 's/new URL\(.*\)/new URL()/g' "{{justfile_directory()}}/harper-wasm/pkg/harper_wasm.js"
 
   cd "{{justfile_directory()}}/packages/harper.js"
-  yarn install -f
+  yarn install
   yarn run build
 
   # Generate API reference
@@ -27,7 +27,7 @@ test-harperjs: build-harperjs
   set -eo pipefail
 
   cd "{{justfile_directory()}}/packages/harper.js"
-  yarn install -f
+  yarn install
   yarn playwright install
   yarn test
 
@@ -44,7 +44,7 @@ dev-web:
   just build-harperjs
 
   cd "{{justfile_directory()}}/packages/web"
-  yarn install -f
+  yarn install
   yarn dev
 
 # Build the Harper website.
@@ -53,7 +53,7 @@ build-web: build-harperjs
   set -eo pipefail
 
   cd "{{justfile_directory()}}/packages/web"
-  yarn install -f
+  yarn install
   yarn run build
 
 # Build the Harper Obsidian plugin.
@@ -63,7 +63,7 @@ build-obsidian: build-harperjs
 
   cd "{{justfile_directory()}}/packages/obsidian-plugin"
 
-  yarn install -f
+  yarn install
   yarn build
 
   zip harper-obsidian-plugin.zip manifest.json main.js
@@ -85,7 +85,7 @@ test-vscode:
 
   cd "$ext_dir"
 
-  yarn install -f
+  yarn install
   # For environments without displays like CI servers or containers
   if [[ "$(uname)" == "Linux" ]] && [[ -z "$DISPLAY" ]]; then
     xvfb-run --auto-servernum yarn test
@@ -116,7 +116,7 @@ package-vscode target="":
 
   cd "$ext_dir"
 
-  yarn install -f
+  yarn install
   if [[ -n "{{target}}" ]]; then
     yarn package --target {{target}}
   else

packages/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

packages/harper.js/examples/commonjs-simple/yarn.lock

@@ -1,8 +1,21 @@
-# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
-# yarn lockfile v1
+# This file is generated by running "yarn install" inside your project.
+# Manual changes might be lost - proceed with caution!
 
+__metadata:
+  version: 8
+  cacheKey: 10c0
 
-harper.js@^0.14.0:
-  version "0.14.0"
-  resolved "https://registry.yarnpkg.com/harper.js/-/harper.js-0.14.0.tgz#16d511070d4474dca501d4de1c76f7849ec0accb"
-  integrity sha512-WRzop2PmFK2AZiqNMHHWDFIqFmS7DeoNVhyibyu7T6wuSe24E1Tunolz8ZzMPfcaKuBB2SY+yGbyTOyj+/QD8g==
+"commonjs-simple@workspace:.":
+  version: 0.0.0-use.local
+  resolution: "commonjs-simple@workspace:."
+  dependencies:
+    harper.js: "npm:^0.14.0"
+  languageName: unknown
+  linkType: soft
+
+"harper.js@npm:^0.14.0":
+  version: 0.14.0
+  resolution: "harper.js@npm:0.14.0"
+  checksum: 10c0/7ee0a61fddff4c4cdf28a7338abaa5d34dc4823a070c5d49277fd6682dcba3394c55e3f47f903194fda4a422c6bd8e442f6c2c653c45dd0f48d3e3174f18dca9
+  languageName: node
+  linkType: hard

packages/package.json

@@ -7,14 +7,14 @@
 		"harper.js"
 	],
 	"devDependencies": {
+		"@typescript-eslint/eslint-plugin": "^8.18.1",
+		"@typescript-eslint/parser": "^8.18.1",
 		"eslint": "^8.28.0",
 		"eslint-config-prettier": "^10.0.1",
 		"eslint-plugin-prettier": "^5.2.1",
 		"eslint-plugin-svelte": "^2.46.1",
 		"prettier": "^3.4.2",
-		"prettier-plugin-svelte": "^3.0.3",
-		"@typescript-eslint/eslint-plugin": "^8.18.1",
-		"@typescript-eslint/parser": "^8.18.1"
+		"prettier-plugin-svelte": "^3.0.3"
 	},
-	"packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+	"packageManager": "yarn@4.6.0+sha512.5383cc12567a95f1d668fbe762dfe0075c595b4bfff433be478dbbe24e05251a8e8c3eb992a986667c1d53b6c3a9c85b8398c35a960587fbd9fa3a0915406728"
 }

packages/vscode-plugin/package.json

@@ -909,14 +909,13 @@
 	"scripts": {
 		"watch:esbuild": "node esbuild.cjs --watch",
 		"watch:tsc": "tsc --noEmit --watch",
-		"pretest": "yarn lint && tsc && node esbuild.cjs",
-		"test": "node build/tests/runTests.js",
+		"test": "yarn lint && tsc && node esbuild.cjs && node build/tests/runTests.js",
 		"vscode:prepublish": "yarn lint && tsc --noEmit && node esbuild.cjs --production",
 		"package": "vsce package",
 		"lint": "eslint src --ext ts"
 	},
 	"devDependencies": {
-		"@types/jasmine": "^5.1.6",
+		"@types/jasmine": "^5.1.4",
 		"@types/node": "22.x",
 		"@types/vscode": "^1.89.0",
 		"@typescript-eslint/eslint-plugin": "^7.7.1",
@@ -925,7 +924,7 @@
 		"@vscode/vsce": "^3.0.0",
 		"esbuild": "^0.25.0",
 		"eslint": "^8.57.0",
-		"jasmine": "^5.6.0",
+		"jasmine": "^5.3.0",
 		"typescript": "^5.7.3"
 	},
 	"dependencies": {

packages/web/src/routes/docs/contributors/environment/+page.md

@@ -14,6 +14,14 @@ To use the tooling required to build and debug Harper, you'll need the following
 - `zip`
 - `pandoc`
 
+To run integration tests, you may also need `libnss3` and/or `libasound3`.
+These are installable in Ubuntu using `apt-get`.
+
+```bash
+sudo apt-get install libnss3
+sudo apt-get install libasound2
+```
+
 We develop a set of tools, accessible via `just`, to build and debug Harper's algorithm (otherwise known as `harper-core`) and its various integrations.
 The source code is in the `justfile` [at the root of the repository](https://github.com/Automattic/harper/blob/master/justfile).
 To see all the tools in the toolbox, run: