feat: support npm workspaces for local development

Add workspaces configuration and workspace-aware scripts for developing
with local packages (such as frontend-base).  Decouple clean from build
in the Makefile so watch mode can rebuild without wiping dist/.

Part of openedx/frontend-base#184

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: arbrandes

.gitignore

@@ -3,6 +3,9 @@ npm-debug.log
 coverage
 module.config.js
 dist/
+packages/
+/.turbo
+/turbo.json
 /*.tgz
 
 ### i18n ###

Makefile

@@ -10,6 +10,8 @@ transifex_input = $(i18n)/transifex_input.json
 # This directory must match .babelrc .
 transifex_temp = ./temp/babel-plugin-formatjs
 
+TURBO = TURBO_TELEMETRY_DISABLED=1 turbo --dangerously-disable-package-manager-check
+
 NPM_TESTS=build i18n_extract lint test
 
 .PHONY: test
@@ -24,10 +26,27 @@ test.npm.%: validate-no-uncommitted-package-lock-changes
 requirements:  ## install ci requirements
 	npm ci
 
+# turbo.site.json is the standalone turbo config for this package.  It is
+# renamed to avoid conflicts with turbo v2's workspace validation, which
+# rejects root task syntax (//#) and requires "extends" in package-level
+# turbo.json files, such as when running in a site repository. The targets
+# below copy it into place before running turbo and clean up after.
+turbo.json: turbo.site.json
+	cp $< $@
+
+build-packages: turbo.json
+	$(TURBO) run build; rm -f turbo.json
+
+clean-packages: turbo.json
+	$(TURBO) run clean; rm -f turbo.json
+
+dev-packages: turbo.json
+	$(TURBO) run watch:build dev:site; rm -f turbo.json
+
 clean:
 	rm -rf dist
 
-build: clean
+build:
 	tsc --project tsconfig.build.json
 	tsc-alias -p tsconfig.build.json
 	find src -type f \( -name '*.scss' -o -name '*.png' -o -name '*.svg' \) -exec sh -c '\

nodemon.json

@@ -0,0 +1,6 @@
+{
+  "watch": [
+    "src"
+  ],
+  "ext": "js,jsx,ts,tsx,scss,png,svg"
+}

package.json

@@ -13,6 +13,9 @@
   "files": [
     "/dist"
   ],
+  "workspaces": [
+    "packages/*"
+  ],
   "browserslist": [
     "extends @edx/browserslist-config"
   ],
@@ -22,13 +25,18 @@
   ],
   "scripts": {
     "build": "make build",
+    "build:packages": "make build-packages",
     "clean": "make clean",
+    "clean:packages": "make clean-packages",
     "dev": "PORT=1996 PUBLIC_PATH=/learner-dashboard openedx dev",
+    "dev:site": "npm run dev",
+    "dev:packages": "make dev-packages",
     "i18n_extract": "openedx formatjs extract",
     "lint": "openedx lint .",
     "lint:fix": "openedx lint --fix .",
-    "prepack": "npm run build",
-    "test": "openedx test --coverage --passWithNoTests"
+    "prepack": "npm run clean && npm run build",
+    "test": "openedx test --coverage --passWithNoTests",
+    "watch:build": "nodemon --exec 'npm run build'"
   },
   "author": "Open edX",
   "license": "AGPL-3.0",
@@ -69,10 +77,12 @@
     "jest-environment-jsdom": "^29.7.0",
     "jest-expect-message": "^1.1.3",
     "jest-when": "^3.6.0",
+    "nodemon": "^3",
     "react-dev-utils": "^12.0.0",
     "react-test-renderer": "^18.3.1",
     "redux-mock-store": "^1.5.4",
-    "tsc-alias": "^1.8.16"
+    "tsc-alias": "^1.8.16",
+    "turbo": "^2.8.16"
   },
   "peerDependencies": {
     "@openedx/frontend-base": "^1.0.0-alpha.13",

turbo.site.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"],
+      "cache": false
+    },
+    "clean": {
+      "cache": false
+    },
+    "watch:build": {
+      "dependsOn": ["^build"],
+      "persistent": true,
+      "cache": false
+    },
+    "//#dev:site": {
+      "dependsOn": ["^build"],
+      "persistent": true,
+      "cache": false
+    }
+  }
+}