feat: support npm workspaces for local development

Add workspaces configuration and workspace-aware scripts for developing
with local packages (such as frontend-base).

Also, since npm skips bin-linking for workspace packages during install,
do it when frontend-base is built.

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
 i18n = ./src/i18n
 
@@ -8,10 +10,35 @@ 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 $< $@
+
+# NPM doesn't bin-link workspace packages during install, so it must be done manually.
+bin-link:
+	[ -f packages/frontend-base/package.json ] && npm rebuild --ignore-scripts @openedx/frontend-base || true
+
+build-packages: turbo.json
+	$(TURBO) run build; rm -f turbo.json
+	$(MAKE) bin-link
+
+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
+
+dev-site: bin-link
+	npm run dev
+
 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"
+}