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

@@ -1,3 +1,5 @@
+TURBO = TURBO_TELEMETRY_DISABLED=1 turbo --dangerously-disable-package-manager-check
+
 intl_imports = ./node_modules/.bin/intl-imports.js
 transifex_utils = ./node_modules/.bin/transifex-utils.js
 i18n = ./src/i18n
@@ -13,10 +15,27 @@ precommit:
 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' -exec sh -c '\

nodemon.json

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

package.json

@@ -16,6 +16,9 @@
   "files": [
     "/dist"
   ],
+  "workspaces": [
+    "packages/*"
+  ],
   "browserslist": [
     "extends @edx/browserslist-config"
   ],
@@ -25,14 +28,19 @@
   ],
   "scripts": {
     "build": "make build",
+    "build:packages": "make build-packages",
     "clean": "make clean",
+    "clean:packages": "make clean-packages",
     "dev": "PORT=1999 PUBLIC_PATH=/authn 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",
+    "prepack": "npm run clean && npm run build",
     "snapshot": "openedx test --updateSnapshot",
-    "test": "openedx test --coverage --passWithNoTests"
+    "test": "openedx test --coverage --passWithNoTests",
+    "watch:build": "nodemon --exec 'npm run build'"
   },
   "author": "Open edX",
   "license": "AGPL-3.0",
@@ -68,9 +76,11 @@
     "babel-plugin-formatjs": "10.5.38",
     "eslint-plugin-import": "2.31.0",
     "jest": "^29.7.0",
+    "nodemon": "^3.1.14",
     "react-test-renderer": "^18.3.1",
     "ts-jest": "^29.4.0",
-    "tsc-alias": "^1.8.16"
+    "tsc-alias": "^1.8.16",
+    "turbo": "^2.8.16"
   },
   "peerDependencies": {
     "@openedx/frontend-base": "^1.0.0-alpha.14",

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
+    }
+  }
+}