build: renew toolchain (turbo + biome + vitest 4 + esbuild + tsc 6)

Replace nx 19 with turborepo 2.9, eslint+prettier with biome 2.4,
@web/test-runner with vitest 4 (browser mode + Playwright provider),
and unify shadow-objects build into a single build.mjs (esbuild
transpile + tsc emit-only declarations + esbuild inline-worker
bundle). Introduce pnpm catalog: as version single-source-of-truth
across all workspace packages. Bump TypeScript to 6, esbuild to
0.28, Playwright to 1.59, happy-dom to 20. Bump shadow-objects
to 0.31.0-dev.

dist/ of @spearwolf/shadow-objects stays byte-compatible (file list
+ dist/package.json identical to prior release). Side-effect: the
./bundle.js export now actually contains the bundled worker and
element registrations — previous releases shipped a 790-byte stub
because src-side sideEffects markers no longer matched the new
entry path.

Verification snapshots and the design doc live under
docs/superpowers/specs/. Full clean+build+test cycle: ~7.6s cold,
~70ms warm (FULL TURBO).

See CHANGELOG.md (root) for build-system details and
packages/shadow-objects/CHANGELOG.md for the package-level
[Unreleased] entry.

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

Author: spearwolf

.eslintignore

@@ -45,8 +45,11 @@ tsconfig.*.tsbuildinfo
 /blob-report/
 /playwright/.cache/
 
-.nx/cache
-.nx/workspace-data
+# turborepo
+.turbo
+
+# packaged-for-publish output
+.npm-pkg
 
 # git worktrees
 .worktrees

.eslintrc.json

@@ -1,14 +1,8 @@
 {
-    "cSpell.words": [
-        "ents",
-        "plah",
-        "Shae",
-        "testresult",
-        "transferables"
-    ],
-    "editor.formatOnSave": true,
-    "editor.codeActionsOnSave": {
-        "source.organizeImports": "always",
-        "source.formatDocument": "always"
-    }
+  "cSpell.words": ["ents", "plah", "Shae", "testresult", "transferables"],
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "always",
+    "source.formatDocument": "always"
+  }
 }

.gitignore

@@ -77,19 +77,22 @@ Uses Signals and Effects (via `@spearwolf/signalize`).
     - Check `packages/shadow-objects-e2e/` for end-to-end tests.
     - Public API changes must be tested in E2E if possible.
 
-<!-- nx configuration start-->
-<!-- Leave the start & end comments to automatically receive updates. -->
-
-# General Guidelines for working with Nx
-
-- When running tasks (for example build, lint, test, e2e, etc.), always prefer running the task through `nx` (i.e. `nx run`, `nx run-many`, `nx affected`) instead of using the underlying tooling directly
-- You have access to the Nx MCP server and its tools, use them to help the user
-- When answering questions about the repository, use the `nx_workspace` tool first to gain an understanding of the workspace architecture where applicable.
-- When working in individual projects, use the `nx_project_details` mcp tool to analyze and understand the specific project structure and dependencies
-- For questions around nx configuration, best practices or if you're unsure, use the `nx_docs` tool to get relevant, up-to-date docs. Always use this instead of assuming things about nx configuration
-- If the user needs help with an Nx configuration or project graph error, use the `nx_workspace` tool to get any errors
-
-<!-- nx configuration end-->
+# Toolchain (post-2026-renewal)
+
+| Concern | Tool |
+|---|---|
+| Package manager | `pnpm` (workspaces + `catalog:` for dependency-version SSOT) |
+| Monorepo orchestrator | `turborepo` — pipeline in `turbo.json` |
+| TypeScript | `tsc` 6 — only emits `.d.ts` (declaration-only) |
+| Bundler / transpiler | `esbuild` 0.28 (lib transpile + single-file inline-worker bundle) |
+| Unit / integration tests | `vitest` 4 (happy-dom for unit, `@vitest/browser` + Playwright provider for DOM-integration) |
+| E2E | `@playwright/test` 1.59 |
+| Lint + format | `biome` 2.4 (replaces eslint + prettier) |
+| Dev server | `vite` (only `shae-offscreen-canvas` demo and `shadow-objects-e2e`) |
+
+**Dependency versions:** never write a plain version range in a per-package `package.json`. Add the version to the `catalog:` block of `pnpm-workspace.yaml` and reference it from each package as `"<dep>": "catalog:"`.
+
+**Run tasks via turbo (`pnpm build`, `pnpm test`, …) instead of invoking the underlying tools directly** — the cache and the cross-package dependency graph are defined there. See `CLAUDE.md` for the full command reference.
 
 # General Context Information for the AI assistant
 

.prettierignore

@@ -87,12 +87,12 @@ ComponentContext│  ─ Destroy
 
 ### 2.3 Verwendete Technologien
 
-- **TypeScript** (strict, aber **`strictNullChecks: false`** — Achtung: das ist eine bewusste Lockerung, die Typen-Sicherheit signifikant einschränkt).
+- **TypeScript 6** (strict, aber **`strictNullChecks: false`** — Achtung: das ist eine bewusste Lockerung, die Typen-Sicherheit signifikant einschränkt).
 - **`@spearwolf/signalize` 0.28.0** — Signals/Effects.
 - **`@spearwolf/eventize` 4.3.1** — Event-Emitter.
-- **esbuild 0.27.3** — Bundling, mit `esbuild-plugin-inline-worker` für den Worker-Inline.
-- **vitest 1.6.1** für Unit-Tests, **`@web/test-runner`** für browser-basierte Funktionstests, **Playwright** für E2E.
-- **nx 19.8.14** als Monorepo-Orchestrator, **pnpm 9.1.2**, Node ≥ 24.13.0.
+- **esbuild 0.28** — Bundling, mit `esbuild-plugin-inline-worker` für den Worker-Inline.
+- **vitest 4** für Unit-Tests (happy-dom) und Integrationstests (browser-mode + Playwright-Provider). **Playwright** für E2E.
+- **turborepo 2.9** als Monorepo-Orchestrator, **biome 2.4** für Lint/Format, **pnpm 9.15** mit `catalog:`-SSOT, Node ≥ 24.13.0.
 
 ### 2.4 Lebenszyklus einer Entity (vereinfacht)
 
@@ -262,38 +262,39 @@ Wenn ein `<shae-ent>`-Vater aus dem DOM entfernt wird, das Kind aber selbst noch
 
 ## 5. Build & Tooling
 
+> **2026-05-09 — Build-System wurde grundlegend erneuert.** Details: [`CHANGELOG.md`](CHANGELOG.md) (Top-Level), Design-Doku: [`docs/superpowers/specs/2026-05-09-build-system-renewal-design.md`](docs/superpowers/specs/2026-05-09-build-system-renewal-design.md). Die folgenden Abschnitte spiegeln den neuen Stand und nur noch die offenen Punkte.
+
 ### 5.1 Pipeline (`packages/shadow-objects`)
 
-Vier Stufen: `compile:lib` (TS → `dist/`) → `compile:bundle` (TS → `build/`, JS für esbuild) → `bundle.mjs` (Worker zuerst inline-bundeln, dann Hauptbundle mit `esbuild-plugin-inline-worker`) → `makePackageJson.mjs` (überschreibt Pfade, resolvt `workspace:*`, wendet `package.override.json` an).
+Ein Skript: `node build.mjs`. Drei Stages — esbuild-Transpile (`src/**` → `dist/src/**`, preserved layout) + tsc emit-only Declarations (`tsconfig.lib.json`) + esbuild Inline-Worker-Bundle (`dist/src/bundle.js` → `dist/bundle.js`). Anschließend `scripts/makePackageJson.mjs` für `dist/package.json` (resolvt `workspace:*` + `catalog:`, wendet `package.override.json` an).
 
 Veröffentlicht wird `dist/` mit ESM-only, mehreren Subpath-Exports (`./elements.js`, `./shae-ent.js`, `./shae-prop.js`, `./shae-worker.js`, `./shadow-objects.js`, `./shadow-objects.worker.js`, `./bundle.js`).
 
-**Auffälligkeiten:**
-- Zwei parallele TS-Outputs (`dist/` und `build/`) für gleiche Quellen.
-- `package.override.json` mit doppelter `sideEffects`-Liste — zwei Wahrheitsquellen, Wartungs-Stolperstein.
+**Verbleibende Auffälligkeiten:**
+- `package.override.json` und `package.json#sideEffects` enthalten noch tote `build/src/...`-Pfade aus der alten Pipeline. Folgenlos (doppelte Wahrheit), sollte aber konsolidiert werden.
 - `exports`-Konditionen: Reihenfolge `import` vor `types`. Unter strikter Node-ESM-Resolution (`moduleResolution: node16/nodenext`) sollte `types` zuerst stehen. Aktuell unter `bundler` toleriert, aber latentes Risiko für Konsumenten.
 
 ### 5.2 Dependency-Hygiene
 
-- `@spearwolf/eventize@4.3.1`, `@spearwolf/signalize@0.28.0` konsistent über alle Pakete. ✅
-- **Drift bei Tooling:** `sinon` 17/18/19 nebeneinander, `@web/test-runner` 0.18 vs 0.20, `vite` 5 vs 6, Playwright 1.58.1 vs 1.58.2.
-- `vitest@1.6.1` (aktuell v3.x), `eslint@8.57.1` (EOL), `@typescript-eslint/*@7` (eines hinten), `nx@19` (mehrere Major hinten).
+- Versionen leben jetzt zentral in `pnpm-workspace.yaml#catalog:` — keine Drift mehr möglich. ✅
+- Tooling auf modernen Major-Versionen: vitest 4, biome 2.4, turbo 2.9, esbuild 0.28, Playwright 1.59, TypeScript 6, happy-dom 20. ✅
 - Kern-Lib hat **keine `peerDependencies`** — `@spearwolf/eventize`/`signalize` sind harte Deps; bei Mehrfach-Resolutionen drohen Duplikate.
 
 ### 5.3 Lint / TS
 
 - `strict: true` **mit `strictNullChecks: false`** — die größte Typensicherheits-Lücke.
-- ESLint-Root deaktiviert global `no-explicit-any`, `ban-ts-comment`, `ban-types`, `no-non-null-assertion`. Bewusste Lockerung, aber in Kombination mit `strictNullChecks: false` riskant.
+- Biome-Root deaktiviert (analog zur alten ESLint-Config) `noExplicitAny`, `noTsIgnore`, `noNonNullAssertion`, `noImplicitAnyLet`. Bewusste Lockerung, aber in Kombination mit `strictNullChecks: false` riskant.
 - `any`-Hotspots (heuristisch): `ConsoleLogger.ts` (~20), `Kernel.ts` (~11), `ShadowObject.ts` (~4).
+- Biome meldet aktuell ~30 Warnings im Source (z. B. `useIterableCallbackReturn`, `noShadowRestrictedNames`, `useNodejsImportProtocol`). Schrittweise abarbeiten oder bewusst weiter unterdrücken.
 
 ### 5.4 CI-Gap
 
-Die GitHub-Action ruft `pnpm run ci` = `build + lint + test:ci`. **`test:ci` schließt `shadow-objects-e2e` aus.** Damit wird der gesamte Worker-Roundtrip nicht von CI verifiziert. Da `RemoteWorkerEnv` ohnehin keine Unit-Tests hat, ist das ein doppelt-blinder Punkt.
+Die GitHub-Action ruft `pnpm run ci` = `turbo run build typecheck test --filter=!shadow-objects-e2e && pnpm lint`. **`test:ci` schließt `shadow-objects-e2e` weiterhin aus.** Damit wird der gesamte Worker-Roundtrip nicht von CI verifiziert. Da `RemoteWorkerEnv` ohnehin keine Unit-Tests hat, ist das ein doppelt-blinder Punkt.
 
 ### 5.5 Sonstige Stolperfallen auf frischer Maschine
 
 - `pnpm install` installiert keine Playwright-Browser — manuelles `pnpm exec playwright install chromium firefox` nötig (wird in CLAUDE.md erwähnt).
-- `engines.node: ">=24.13.0"` blockiert Mitwirkende auf Node 22.x.
+- `engines.node: ">=24.13.0"` blockiert Mitwirkende auf Node 22.x. Hinweis: Node 24+ ships eine inerte `localStorage`-Stub auf `globalThis`; für Tests gefixt durch `packages/shadow-objects/vitest.setup.ts`.
 - `make:todo` ist Honor-System (kein Pre-Commit-Hook, kein CI-Check).
 - Manuelles `CHANGELOG.md`-Pflegen ohne Changesets/release-please.
 
@@ -340,12 +341,12 @@ Ein reines JS-Paket (kein TS), `src/` wird ohne Bundle-Schritt veröffentlicht.
 ### 7.3 Mittelfristig
 
 14. **`strictNullChecks: true`** schrittweise einschalten — größter Hebel für Typensicherheit.
-15. **Tooling-Drift bereinigen:** vitest, ESLint, nx, sinon, vite auf einheitliche Major-Versionen ziehen.
-16. **`exports`-Konditionen umsortieren** (`types` vor `import`) für strikte Node-ESM-Konsumenten.
-17. **`peerDependencies` für `@spearwolf/eventize`/`signalize`** dokumentiert beschließen.
-18. **API-Aufräumen:** `appendRoute` aufteilen, `onDestroy`-Tripel-Bedeutung dokumentieren oder trennen, `IShadowObjectEnvProxy.isDestroyed`/`error`-Surface ergänzen, Worker-Timeouts konfigurierbar machen.
-19. **Performance-Knopf:** `disableStructuredClone` als Default für `LocalShadowObjectEnv`; optionales RAF-Coalescing bei hoher Update-Frequenz.
-20. **`package.override.json`-Mechanik** in `AGENTS.md`/`CLAUDE.md` dokumentieren, Doppel-`sideEffects` zu einer Wahrheit konsolidieren.
+15. **`exports`-Konditionen umsortieren** (`types` vor `import`) für strikte Node-ESM-Konsumenten.
+16. **`peerDependencies` für `@spearwolf/eventize`/`signalize`** dokumentiert beschließen.
+17. **API-Aufräumen:** `appendRoute` aufteilen, `onDestroy`-Tripel-Bedeutung dokumentieren oder trennen, `IShadowObjectEnvProxy.isDestroyed`/`error`-Surface ergänzen, Worker-Timeouts konfigurierbar machen.
+18. **Performance-Knopf:** `disableStructuredClone` als Default für `LocalShadowObjectEnv`; optionales RAF-Coalescing bei hoher Update-Frequenz.
+19. **`sideEffects`-Listen konsolidieren:** `package.json` und `package.override.json` haben noch tote `build/src/...`-Einträge aus der alten Build-Pipeline — auf `dist/src/...` reduzieren.
+20. **Biome-Warnings abarbeiten** (~30 Stück): `useIterableCallbackReturn`, `noShadowRestrictedNames` etc. — entweder fixen oder Regel bewusst abschalten.
 
 ### 7.4 Beispiel-App / Dokumentation
 

.prettierrc

@@ -0,0 +1,26 @@
+# Monorepo Changelog
+
+Top-level changes that are not tied to a single published package — build system, monorepo orchestration, lint/format, dev workflow. Per-package runtime and API changes live in each package's own `CHANGELOG.md`.
+
+The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## 2026-05-09 — Build-system renewal
+
+- **Monorepo orchestrator:** replaced `nx` 19 with `turborepo` 2.9. Removed `nx.json` and all per-package `project.json` files. Pipeline now in `turbo.json`.
+- **Lint + format:** replaced `eslint` 8 + `prettier` 3 (and 9 plugins) with `biome` 2.4. Single config at `biome.json`. Removed `.eslintrc.json`, `.eslintignore`, `.prettierrc`, `.prettierignore`.
+- **Dependency-version SSOT:** introduced pnpm `catalog:` (in `pnpm-workspace.yaml`). All workspace `package.json` files reference shared deps via `"<dep>": "catalog:"`. The `makePackageJson.mjs` publish helper resolves `catalog:` refs alongside `workspace:*`.
+- **TypeScript:** bumped to 6.0. Dropped deprecated `baseUrl` and `downlevelIteration` from the root `tsconfig.json`.
+- **Build:** unified `packages/shadow-objects` build into a single `build.mjs` (esbuild transpile + tsc emit-only declarations + esbuild inline-worker bundle + makePackageJson). Removed `tsconfig.bundle.json`, `tsconfig.tests.json`, `bundle.mjs`, the `run-s`/`rimraf` script chain, and the intermediate `build/` directory.
+- **Test runners:** consolidated on `vitest` 4.
+  - Core lib (`shadow-objects`): vitest reads `*.spec.ts` directly (no precompile step). Removed the generated `tests/` tree.
+  - Integration (`shadow-objects-testing`): switched from `@web/test-runner` to `vitest` browser mode with the Playwright provider (real Chromium for accurate Custom Elements semantics). Chai assertion style preserved via `@esm-bundle/chai`.
+  - Canvas (`shae-offscreen-canvas`): switched from `@web/test-runner` to `vitest` + happy-dom.
+  - Shared `vitest.setup.ts` patches Node 24+'s inert `localStorage`/`sessionStorage` globals (which shadow happy-dom's working Storage) and shims mocha's `after`/`before` to vitest's `afterAll`/`beforeAll` for migrated specs.
+- **Tooling bumps:** `esbuild` 0.27 → 0.28, `@playwright/test` 1.58 → 1.59, `happy-dom` 14 → 20, added `jsdom` 29 as backup env.
+- **Dropped devDeps:** `nx`, `@nx/*`, `eslint*`, `@typescript-eslint/*`, `prettier*`, `npm-run-all`, `@rollup/plugin-node-resolve`, `react`, `@types/react`, `@web/test-runner` (workspace-wide).
+
+### Verification
+
+- `dist/` of `@spearwolf/shadow-objects` is byte-compatible with the previous version (file list identical except for the removal of an accidentally-published `tsconfig.lib.tsbuildinfo`; `dist/package.json` byte-identical). Snapshots: `docs/superpowers/specs/dist-snapshot.txt`, `docs/superpowers/specs/dist-package.json.snapshot`.
+- Cold full cycle (`pnpm cbt`): ~7.6 s for clean + build + test + e2e (7 turbo tasks, 191 unit/integration + 32 e2e). Warm cache: ~70 ms (FULL TURBO).
+- Design doc: `docs/superpowers/specs/2026-05-09-build-system-renewal-design.md`.