sync(common-v8): cautious wave1 cherry-pick sync (#58)

## Summary
Cautious, commit-by-commit `upstream/common-v8` sync wave from a
history-separated upstream branch (no merge, no unrelated-history
merge).

This PR ports low-risk/high-value pieces and explicitly defers high-risk
runtime/dependency waves.

## Candidate upstream commits and decisions

### PORTED
- `e903c47d` Add Set shim typings and refactor Abort polyfills
- Ported as fork-equivalent: added
`packages/react-native/src/Polyfills.ts` and
`packages/react-native/src/SetPrototypeShimModules.d.ts`.
- `a4287569` Improved polyfills for web and React Native runtimes
(selective)
  - Ported selective parts in fork-relevant paths:
    - `packages/common/src/Polyfills.ts`
    - `packages/common/test/_browserSetup.ts`
    - `packages/react-native/test/Polyfills.test.ts`
- `8c4101ac` Simplified cleaning (selective)
  - Ported safe root `.gitignore` patterns only.

### SKIPPED
- `edf950f6` VSCode settings only (`.vscode/settings.json`)
- `c06944fa` `apps/web` docs/minimal playground (not relevant in this
fork layout for wave1)

### DEFERRED
- `ec61d7fd` Expo 55 mega-wave (large lockfile/deps churn)
- `9364b02c` shared sync resource management refactor (runtime-heavy)
- Equivalent worker bootstrap from `a4287569` in web worker was tested
and reverted due regression:
- `@evolu/web (webkit)` `Worker.worker.test.ts` failed with `Object not
disposable`
  - deferred to wave2 runtime branch

## Fork-compat adjustments included
- Switched `@evolu/common/polyfills` imports to `@evolu/common` (fork
export shape).
- Added explicit `set.prototype.*` dependencies to
`packages/react-native/package.json`.
- Tightened Promise polyfill typing for TS 5.9/Node 24+ to keep build
green.

## Risks and mitigations
- **Risk:** polyfill behavior differences across RN/web runtimes.
  - **Mitigation:** added/ran dedicated `Polyfills.test.ts` (19 tests).
- **Risk:** web worker runtime regression from direct upstream mapping.
- **Mitigation:** reverted problematic worker bootstrap equivalent in
wave1; keep for wave2 investigation.
- **Risk:** cleanup changes accidentally hiding important artifacts.
- **Mitigation:** only additive, conservative `.gitignore` changes; no
destructive clean script switch.

## Validation (local)
Required gates from plan:
- `bun run build` ✅
- `bun run test` ✅
- `bun run lint` ✅ (Biome warnings only in upstream-derived test style;
no errors)
- `bun run coverage:lane:active` ✅
- `(cd examples/react-expo && bun run web:export)` ✅

Targeted checks:
- `bunx vitest run --project react-native
packages/react-native/test/Polyfills.test.ts` ✅

## Wave2 plan
Next branch: `sync/common-v8-2026-03-01-wave2-runtime`
- Tackle deferred runtime refactor (`9364b02c`)
- Re-evaluate selected parts of Expo55 wave (`ec61d7fd`) with explicit
lockfile/dependency strategy
- Revisit web worker polyfill bootstrap with architecture-specific
adaptation + focused webkit worker tests


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

## Poznámky k vydání

* **Nové funkce**
* Polyfilly pro React Native (Promise statické metody,
AbortController/AbortSignal) veřejně dostupné.
  * Polyfilly pro metody Set prototype.
  * Nová asynchronní pomocná funkce arrayFromAsync.

* **Dokumentace**
  * Přepsané tabulky v README a aktualizovaný obrázek.

* **Testy**
* Přidána rozsáhlá sada testů pro polyfily a abort/timeout; přesun
některých testů.

* **Chores**
  * Aktualizovány položky .gitignore a drobné verze devDependencies.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: miccy

.changeset/array-module-refactor.md

@@ -30,6 +30,7 @@ if (isNonEmptyArray(mutableArr)) { ... }
 ### New Functions
 
 - **`arrayFrom`** — creates a readonly array from an iterable or by generating elements with a length and mapper
+- **`arrayFromAsync`** — creates a readonly array from an async iterable (or iterable of promises) and awaits all values
 - **`flatMapArray`** — maps each element to an array and flattens the result, preserving non-empty type when applicable
 - **`concatArrays`** — concatenates two arrays, returning non-empty when at least one input is non-empty
 - **`sortArray`** — returns a new sorted array (wraps `toSorted`), preserving non-empty type

.gitignore

@@ -20,6 +20,19 @@ coverage
 tmp
 __screenshots__
 *.tsBuildInfo
+*.tsbuildinfo
 .generated
 
 .ai/
+.vite
+next-env.d.ts
+
+# apps/relay
+apps/relay/data/*
+!apps/relay/data/.gitkeep
+
+# examples/react-expo
+examples/react-expo/.expo/
+examples/react-expo/expo-env.d.ts
+examples/react-expo/ios
+examples/react-expo/android

README.md

@@ -14,39 +14,55 @@ Evolu is a TypeScript library and local-first platform.
 ## 🪴 Project Activity
 
 <p align="center">
-  <img src="https://repobeats.axiom.co/api/embed/<hash>.svg" alt="Repobeats analytics image" />
+  <img src="https://repobeats.axiom.co/api/embed/9dbe31e742524e552a28ac3a7edf1d06e987b2ae.svg" alt="Repobeats analytics image" />
 </p>
 
 ## Integration Matrix
 
-Coverage snapshot date: `2026-02-27` (from `bun run test:coverage` and `bun run test:coverage:bun`).
-
-| Package | Supported Versions | Implementation Status | Coverage (Statements / Branches) | Notes |
-| --- | --- | --- | --- | --- |
-| `@evolu/common` | Node `>=24.0.0` | Stable core | `94.47% / 89.57%` | Main engine + local-first protocol/runtime. |
-| `@evolu/web` | `@evolu/common ^7.4.1` | Stable | `99.33% / 93.71%` | Browser runtime (Worker/SharedWorker/Web Locks path). |
-| `@evolu/nodejs` | Node `>=24.0.0`, `@evolu/common ^7.4.1` | Stable | `95.74% / 87.50%` | Includes relay adapter hardening (WS lifecycle + subscribe/broadcast/unsubscribe + restart coverage). |
-| `@evolu/react-web` | React `>=19`, React DOM `>=19`, `@evolu/web ^2.4.0` | Stable thin adapter | `100% / 100%` | Thin web integration wrapper. |
-| `@evolu/react-native` | React Native `>=0.84`, Expo `>=55`, `@op-engineering/op-sqlite >=12` | Lane-gated hardening | `100.00% / 100.00%` (lane gate) | Strict file gates (`react-native` + `expo`) are enforced at `100/100/100/100` for scoped source files. |
-| `@evolu/react` | React `>=19` | Wrapper support | `0% / 0%` | Hook wrappers; coverage expansion planned. |
-| `@evolu/vue` | Vue `>=3.5.29` | Wrapper support | `0% / 0%` | Composition API wrappers; coverage expansion planned. |
-| `@evolu/svelte` | Svelte `>=5.53.3`, `@evolu/web ^2.4.0` | Wrapper support | `0% / 0%` | Store-based wrappers; coverage expansion planned. |
-| `@evolu/bun` (private) | `@evolu/common ^7.4.1`, Bun `1.3.x` | Experimental adapter | `100% / 100%` | Measured via Bun coverage runner on `BunDbWorker.ts`. |
+Coverage snapshot date: `2026-03-01` (from `bun run verify`).
+
+| Package                | Baseline                                | Status               |
+| ---------------------- | --------------------------------------- | -------------------- |
+| `@evolu/common`        | Node `>=24.0.0`                         | Stable core          |
+| `@evolu/web`           | Browser + `@evolu/common ^7.4.1`        | Stable               |
+| `@evolu/nodejs`        | Node `>=24.0.0` + `@evolu/common ^7.4.1` | Stable               |
+| `@evolu/react-web`     | React `>=19` + `@evolu/web ^2.4.0`      | Thin adapter         |
+| `@evolu/react-native`  | RN `>=0.84`, Expo `>=55`                | Lane-gated hardening |
+| `@evolu/react`         | React `>=19`                            | Wrapper support      |
+| `@evolu/vue`           | Vue `>=3.5.29`                          | Wrapper support      |
+| `@evolu/svelte`        | Svelte `>=5.53.3`                       | Wrapper support      |
+| `@evolu/bun` (private) | Bun `1.3.x` + `@evolu/common ^7.4.1`    | Experimental adapter |
+
+Coverage notes (Statements / Branches):
+
+- `@evolu/common`: `94.46% / 89.64%`
+- `@evolu/web`: `98.90% / 93.30%`
+- `@evolu/nodejs`: `95.74% / 85.71%`
+- `@evolu/react-native`: `99.32% / 98.17%` + strict `react-native`/`expo` file gates at `100/100/100/100`
+- `@evolu/bun` (private): `100% / 100%` (`BunDbWorker.ts`)
+- Wrapper packages (`@evolu/react`, `@evolu/vue`, `@evolu/svelte`) are still coverage-expansion candidates.
 
 ## Planned Integrations (Roadmap View)
 
-| Integration | Fit | Priority | Expected Path | Main Risk / Blocker |
-| --- | --- | --- | --- | --- |
-| Next.js (App Router) | Very high | P0 | Official `@evolu/react-web` guide + production example for Server/Client boundaries. | SSR/client boundary handling and Worker lifecycle in edge runtimes. |
-| TanStack Start | Very high | P0 | Use `@evolu/react` + `@evolu/web`, focus on SSR/client boundary docs and example app. | SSR edge cases (worker lifecycle and hydration boundary). |
-| Astro | High | P0 | Client-island integration on top of `@evolu/web`, starter template + docs. | Island hydration timing and worker boot ordering. |
-| SvelteKit | High | P1 | `@evolu/svelte` + `@evolu/web` reference app with SSR-aware browser-only init. | Avoiding server-side execution for browser worker primitives. |
-| Nuxt 3 | High | P1 | Vue composables + client-only plugin/module (`@evolu/vue` + `@evolu/web`). | Nitro/SSR split and client plugin ordering. |
-| Remix / React Router | High | P1 | React adapter with explicit browser init boundaries and route loader guidance. | Loader/action patterns can accidentally cross server/client boundary. |
-| Tauri | High | P1 | Web runtime in WebView + optional Rust-side relay bridge for desktop sync scenarios. | Packaging/runtime differences across desktop targets. |
-| Electron | High | P1 | Reuse web runtime in renderer + optional Node relay bridge in main process. | Multi-process lifecycle and secure IPC boundaries. |
-| Capacitor (Ionic) | Medium | P2 | Reuse web runtime in WebView first, then mobile storage/perf hardening. | Mobile WebView storage consistency and background lifecycle constraints. |
-| Flutter | Medium/Low | P2 | Separate adapter/SDK (likely not a thin wrapper) or protocol-level bridge. | Different runtime/language model (Dart), no direct reuse of TS hooks. |
+| Integration          | Priority | Focus                                          |
+| -------------------- | -------- | ---------------------------------------------- |
+| Next.js (App Router) | P0       | Official web guide + SSR/client boundary docs |
+| TanStack Start       | P0       | React/web adapter docs + production example    |
+| Astro                | P0       | Client-island starter + worker boot guidance   |
+| SvelteKit            | P1       | Browser-only init reference app                |
+| Nuxt 3               | P1       | Client plugin/module integration path          |
+| Remix / React Router | P1       | Explicit browser init in route patterns        |
+| Tauri                | P1       | WebView runtime + optional relay bridge        |
+| Electron             | P1       | Renderer runtime + optional main-process relay |
+| Capacitor (Ionic)    | P2       | WebView-first runtime hardening                |
+| Flutter              | P2       | Separate SDK/bridge exploration                |
+
+Main blockers to track:
+
+- SSR/client boundaries and hydration order in framework runtimes.
+- Worker lifecycle consistency across browser, edge, and desktop shells.
+- Desktop packaging/process boundaries (Electron/Tauri).
+- Mobile WebView storage consistency and background lifecycle.
 
 Current recommendation:
 
@@ -63,15 +79,15 @@ Current recommendation:
 
 Third-party runtime dependencies used by `@evolu/common`:
 
-| Dependency | Why It Is Used |
-| --- | --- |
-| `@noble/ciphers` | Audited cryptographic ciphers for encryption flows. |
-| `@noble/hashes` | Audited hash primitives used by protocol/auth internals. |
-| `@scure/bip39` | Mnemonic handling for owner/account recovery flows. |
+| Dependency        | Why It Is Used                                                |
+| ----------------- | ------------------------------------------------------------- |
+| `@noble/ciphers`  | Audited cryptographic ciphers for encryption flows.           |
+| `@noble/hashes`   | Audited hash primitives used by protocol/auth internals.      |
+| `@scure/bip39`    | Mnemonic handling for owner/account recovery flows.           |
 | `disposablestack` | Disposable stack compatibility utility for cleanup semantics. |
-| `kysely` | Typed SQL query builder integration. |
-| `msgpackr` | Binary message serialization for protocol payloads. |
-| `zod` | Runtime schema validation and parsing. |
+| `kysely`          | Typed SQL query builder integration.                          |
+| `msgpackr`        | Binary message serialization for protocol payloads.           |
+| `zod`             | Runtime schema validation and parsing.                        |
 
 Dependency policy:
 

apps/relay/package.json

@@ -19,7 +19,7 @@
   },
   "devDependencies": {
     "@evolu/tsconfig": "workspace:*",
-    "@types/node": "^25.3.2",
+    "@types/node": "^25.3.3",
     "typescript": "^5.9.3"
   },
   "engines": {