chore: sync with upstream/common-v8 and polish monorepo

- Sync all commits from upstream/common-v8
- Resolve conflicts in Task.ts and Task.test.ts
- Unify dependencies across monorepo (React 19.2.3, TS 5.9.3, Vitest 4.0.17)
- Update root README.md to use Bun and Biome conventions
- Migrate root package.json scripts to Bun
- Fix Typedoc generation by disabling Prettier integration
- Fix linting and types in apps/web and packages

Author: miccy

README.md

@@ -1,72 +1,66 @@
 # Evolu
 
-Evolu is a TypeScript library and local-first platform.
+Evolu is a local-first platform designed for privacy, ease of use, and no vendor lock-in. It provides a set of libraries to build apps that work offline, sync automatically, and encrypt data end-to-end.
 
-## Documentation
+[evolu.dev](https://www.evolu.dev)
 
-For detailed information and usage examples, please visit [evolu.dev](https://www.evolu.dev).
+## Features
 
-## Community
+- **Local-First**: Data lives on the device first.
+- **Privacy-Centric**: End-to-end encryption by default.
+- **Sync**: Automatic sync across devices using CRDTs.
+- **Typed**: Built with TypeScript for type safety.
+- **SQL**: SQLite support in the browser and on devices.
 
-The Evolu community is on [GitHub Discussions](https://github.com/evoluhq/evolu/discussions), where you can ask questions and voice ideas.
+## Requirements
 
-To chat with other community members, you can join the [Evolu Discord](https://discord.gg/2J8yyyyxtZ).
+- [Bun](https://bun.sh) (latest)
+- Node.js >= 22
 
-[![X](https://img.shields.io/twitter/url/https/x.com/evoluhq.svg?style=social&label=Follow%20%40evoluhq)](https://x.com/evoluhq)
+## Development
 
-## Developing
+Evolu is a monorepo managed by **Turbo** and **Bun**. We use **Biome** for linting and formatting.
 
-Evolu monorepo uses [pnpm](https://pnpm.io).
+### Getting Started
 
 Install dependencies:
 
+```bash
+bun install
 ```
-pnpm install
-```
-
-Build scripts
-
-- `pnpm build` - Build packages
-- `pnpm build:web` - Build docs and web
-
-Web build notes
-
-- Uses webpack (`next build --webpack`) because SharedWorker is required.
-- Uses `NODE_OPTIONS=--max-old-space-size-percentage=75` to avoid V8 heap OOM on large docs builds.
-- On macOS Tahoe, you may need to raise Launch Services limits too (shell `ulimit -n` is not enough):
-  - `sudo launchctl limit maxfiles 262144 262144`
 
-Start dev
+Start the development environment (web docs + examples):
 
-> **Warning**: Run `pnpm build` before running dev. Packages must be built first.
-
-- `pnpm dev` - Dev server for web
-- `pnpm ios` - Run iOS example (requires `pnpm dev` running)
-- `pnpm android` - Run Android example (requires `pnpm dev` running)
-
-Examples
-
-> **Note**: To work on examples with local packages, run `pnpm examples:toggle-deps` first.
-
-- `pnpm examples:react-nextjs:dev` - Dev server for React Next.js example
-- `pnpm examples:react-vite-pwa:dev` - Dev server for React Vite PWA example
-- `pnpm examples:svelte-vite-pwa:dev` - Dev server for Svelte Vite PWA example
-- `pnpm examples:vue-vite-pwa:dev` - Dev server for Vue Vite PWA example
-- `pnpm examples:build` - Build all examples
+```bash
+bun dev
+```
 
-Linting
+### Scripts
 
-- `pnpm lint` - Lint code
-- `pnpm lint-monorepo` - Lint monorepo structure
+- **Linting**: `bun run lint` (Check code quality with Biome)
+- **Formatting**: `bun run format` (Apply formatting with Biome)
+- **Testing**: `bun run test` (Run tests with Vitest)
+- **Build**: `bun run build` (Build all packages)
+- **Clean**: `bun run clean` (Clean artifacts and node_modules)
 
-Testing
+## Project Structure
 
-- `pnpm test` - Run tests
+- `packages/`
+  - `common`: Core logic, platform-agnostic.
+  - `react`: React hooks and components.
+  - `react-native`: React Native integration.
+  - `web`: Web-specific implementations.
+  - `server`: Sync and signaling server.
+- `apps/`
+  - `web`: Documentation and website (Next.js).
+- `examples/`: Sample applications demonstrating usage.
 
-Release
+## Community
 
-- `pnpm changeset` - Describe changes for release log
+- [GitHub Discussions](https://github.com/evoluhq/evolu/discussions)
+- [Discord](https://discord.gg/2J8yyyyxtZ)
+- [X (Twitter)](https://x.com/evoluhq)
 
-Verify
+## License
 
-- `pnpm verify` - Run all checks (build, lint, test) before commit
+MIT

apps/web/package.json

@@ -35,8 +35,8 @@
 		"motion": "^12.26.1",
 		"next": "^16.1.1",
 		"next-themes": "^0.4.6",
-		"react": "^19.1.0",
-		"react-dom": "^19.1.0",
+		"react": "19.2.3",
+		"react-dom": "19.2.3",
 		"react-highlight-words": "^0.21.0",
 		"remark": "^15.0.1",
 		"remark-gfm": "^4.0.1",
@@ -55,8 +55,8 @@
 		"@evolu/tsconfig": "workspace:*",
 		"@types/mdx": "^2.0.13",
 		"@types/node": "^24.10.7",
-		"@types/react": "^19.2.8",
-		"@types/react-dom": "^19.1.11",
+		"@types/react": "~19.2.8",
+		"@types/react-dom": "~19.2.3",
 		"@types/react-highlight-words": "^0.20.1",
 		"@types/rss": "^0.0.32",
 		"cross-env": "^10.0.0",

bun.lock

@@ -17,10 +17,10 @@
 		"@evolu/web": "latest"
 	},
 	"devDependencies": {
-		"@evolu/biome-config": "workspace:*",
 		"@analogjs/vite-plugin-angular": "^2.2.1",
 		"@angular/build": "^21.0.5",
 		"@angular/compiler-cli": "^21.0.8",
+		"@evolu/biome-config": "workspace:*",
 		"@tailwindcss/vite": "^4.1.18",
 		"@vite-pwa/assets-generator": "^1.0.0",
 		"tailwindcss": "^4.1.18",

examples/angular-vite-pwa/package.json

@@ -25,7 +25,7 @@
 		"@vitejs/plugin-react": "^5.1.2",
 		"electron": "39.2.7",
 		"electron-builder": "^26.4.0",
-		"typescript": "^5.9.2",
+		"typescript": "^5.9.3",
 		"vite": "^7.3.1",
 		"vite-plugin-electron": "^0.29.0",
 		"vite-plugin-electron-renderer": "^0.14.5"

examples/react-electron/package.json

@@ -48,10 +48,10 @@
 		"set.prototype.union": "^1.1.3"
 	},
 	"devDependencies": {
-		"@evolu/biome-config": "workspace:*",
 		"@babel/core": "^7.28.0",
 		"@babel/plugin-transform-explicit-resource-management": "^7.28.0",
 		"@babel/plugin-transform-modules-commonjs": "^7.27.1",
+		"@evolu/biome-config": "workspace:*",
 		"@types/react": "~19.2.8",
 		"typescript": "^5.9.3"
 	}

examples/react-expo/package.json

@@ -33,6 +33,6 @@
 		"vite": "^7.3.1",
 		"vite-plugin-pwa": "^1.0.2",
 		"workbox-core": "^7.3.0",
-		"workbox-window": "^7.3.0"
+		"workbox-window": "^7.4.0"
 	}
 }

examples/react-vite-pwa/package.json

@@ -4,21 +4,21 @@
 	"scripts": {
 		"dev": "turbo --filter @evolu/* dev --filter web --concurrency=11",
 		"build": "turbo --filter @evolu/* build",
-		"build:web": "pnpm build:docs && turbo --filter web build",
-		"build:docs": "typedoc && pnpm --filter=web run fix:docs",
+		"build:web": "bun run build:docs && turbo --filter web build",
+		"build:docs": "typedoc && bun run --filter=web fix:docs",
 		"test": "turbo run test",
 		"test:coverage": "turbo run test:coverage",
 		"test:watch": "turbo run test:watch",
 		"start": "turbo start",
-		"lint": "turbo lint && pnpm lint:root",
+		"lint": "turbo lint && bun run lint:root",
 		"lint:root": "biome check *.json *.yaml scripts",
-		"format": "turbo format && pnpm format:root",
+		"format": "turbo format && bun run format:root",
 		"format:root": "biome check *.json *.yaml scripts --write",
-		"lint-monorepo": "pnpm dlx sherif@latest",
-		"verify": "pnpm build && pnpm test && pnpm lint && pnpm lint-monorepo && pnpm typedoc",
-		"clean": "turbo clean && rimraf node_modules pnpm-lock.yaml .turbo .eslintcache out",
+		"lint-monorepo": "bunx sherif@latest",
+		"verify": "bun run build && bun run test && bun run lint && bun run lint-monorepo && bun run typedoc",
+		"clean": "turbo clean && rimraf node_modules pnpm-lock.yaml bun.lock .turbo .eslintcache out",
 		"version": "changeset version",
-		"release": "pnpm run build && changeset publish",
+		"release": "bun run build && changeset publish",
 		"ios": "cd examples/react-expo && pnpm ios",
 		"android": "cd examples/react-expo && pnpm android",
 		"bench": "turbo bench",
@@ -39,7 +39,7 @@
 		"typedoc": "^0.28.16",
 		"typedoc-plugin-markdown": "^4.9.0",
 		"typescript": "^5.9.3",
-		"vitest": "^4.0.16"
+		"vitest": "^4.0.17"
 	},
 	"engines": {
 		"node": ">=24.0.0"

package.json

@@ -733,6 +733,9 @@ export interface FiberSnapshot {
 
 	/** Child snapshots in spawn (start) order. */
 	readonly children: ReadonlyArray<FiberSnapshot>;
+
+	/** The abort mask depth. `0` means abortable, `>= 1` means unabortable. */
+	readonly abortMask: AbortMask;
 }
 
 /**
@@ -1174,7 +1177,7 @@ const createRunnerInternal =
 						abortMask,
 					};
 				}
-				return snapshot;
+				return snapshot!;
 			};
 			run.onEvent = undefined;
 

packages/common/src/Task.ts

@@ -83,7 +83,7 @@
 		"react-native": "^0.81.5",
 		"react-native-nitro-modules": "^0.31.10",
 		"react-native-sensitive-info": "6.0.0-rc.11",
-		"react-native-svg": "^15.15.1",
+		"react-native-svg": "15.15.1",
 		"typescript": "^5.9.3",
 		"vitest": "^4.0.17"
 	},