PR: Merge upstream Common v8 branch plus my fixes

.changeset/array-module-refactor.md

@@ -0,0 +1,48 @@
+---
+"@evolu/common": major
+---
+
+Refactored the Array module with breaking changes, better naming, and new helpers.
+
+### Breaking Changes
+
+**Removed `isNonEmptyReadonlyArray`** — use `isNonEmptyArray` instead. The function now handles both mutable and readonly arrays via overloads:
+
+```ts
+// Before
+if (isNonEmptyReadonlyArray(readonlyArr)) { ... }
+if (isNonEmptyArray(mutableArr)) { ... }
+
+// After — one function for both
+if (isNonEmptyArray(readonlyArr)) { ... }
+if (isNonEmptyArray(mutableArr)) { ... }
+```
+
+**Renamed mutation functions** for consistency with the `...Array` suffix pattern:
+
+- `shiftArray` → `shiftFromArray`
+- `popArray` → `popFromArray`
+
+### New Functions
+
+- **`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
+- **`reverseArray`** — returns a new reversed array (wraps `toReversed`), preserving non-empty type
+- **`spliceArray`** — returns a new array with elements removed/replaced (wraps `toSpliced`)
+
+### Migration
+
+```ts
+// isNonEmptyReadonlyArray → isNonEmptyArray
+-import { isNonEmptyReadonlyArray } from "@evolu/common";
++import { isNonEmptyArray } from "@evolu/common";
+
+// shiftArray → shiftFromArray
+-import { shiftArray } from "@evolu/common";
++import { shiftFromArray } from "@evolu/common";
+
+// popArray → popFromArray
+-import { popArray } from "@evolu/common";
++import { popFromArray } from "@evolu/common";
+```

.changeset/gentle-pumas-eat.md

@@ -0,0 +1,14 @@
+---
+"@evolu/react-native": major
+"@evolu/react-web": major
+"@evolu/common": major
+"@evolu/nodejs": major
+"@evolu/react": major
+"@evolu/vue": major
+"@evolu/web": major
+"@evolu/relay": major
+---
+
+# Update Node.js requirement
+
+Updated minimum Node.js version from 22 to 24 (current LTS)

.changeset/global-error-scope.md

@@ -0,0 +1,12 @@
+---
+"@evolu/common": minor
+"@evolu/web": minor
+"@evolu/nodejs": minor
+---
+
+Added `GlobalErrorScope` interface for platform-agnostic global error handling
+
+- Added `GlobalErrorScope` interface representing execution contexts that capture uncaught errors and unhandled promise rejections
+- Added `handleGlobalError` helper to forward errors to scope callbacks
+- Added `createGlobalErrorScope` for browser windows in `@evolu/web`
+- Added `createGlobalErrorScope` for Node.js processes in `@evolu/nodejs`

.changeset/lazy-rename.md

@@ -0,0 +1,5 @@
+---
+"@evolu/common": major
+---
+
+Renamed `LazyValue<T>` to `Lazy<T>` for brevity

.changeset/lovely-aliens-camp.md

@@ -0,0 +1,22 @@
+---
+"@evolu/common": minor
+---
+
+Added `createObjectURL` helper for safe, disposable `URL.createObjectURL` usage using JS Resource Management so the URL is disposed automatically when the scope ends.
+
+Example:
+
+```ts
+const handleDownloadDatabaseClick = () => {
+  void evolu.exportDatabase().then((data) => {
+    using objectUrl = createObjectURL(
+      new Blob([data], { type: "application/x-sqlite3" }),
+    );
+
+    const link = document.createElement("a");
+    link.href = objectUrl.url;
+    link.download = `${evolu.name}.sqlite3`;
+    link.click();
+  });
+};
+```

.changeset/red-wings-itch.md

@@ -0,0 +1,9 @@
+---
+"@evolu/react-native": major
+"@evolu/react-web": major
+"@evolu/common": major
+"@evolu/web": major
+---
+
+- Merged `@evolu/common/local-first/Platform.ts` into `@evolu/common/Platform.ts`
+- Made `@evolu/react-web` re-export everything from `@evolu/web`, allowing React users to install only `@evolu/react-web`

.changeset/result-never-inference.md

@@ -0,0 +1,5 @@
+---
+"@evolu/common": major
+---
+
+Changed `ok()` to return `Result<T, never>` and `err()` to return `Result<never, E>` for correct type inference.

.changeset/smart-refs-store.md

@@ -0,0 +1,5 @@
+---
+"@evolu/common": minor
+---
+
+Added optional equality function to `Ref` and `ReadonlyStore` interface. `Ref.set` and `Ref.modify` now return `boolean` indicating whether state was updated. `Store` now uses `Ref` internally for state management.

.changeset/spotty-coats-sort.md

@@ -0,0 +1,11 @@
+---
+"@evolu/common": minor
+---
+
+Added Resource Management polyfills
+
+Provides `Symbol.dispose`, `Symbol.asyncDispose`, `DisposableStack`, and `AsyncDisposableStack` for environments without native support (e.g., Safari). This enables the `using` and `await using` declarations for automatic resource cleanup.
+
+Polyfills are installed automatically when importing `@evolu/common`.
+
+See `Result.test.ts` for usage patterns combining `Result` with `using`, `DisposableStack`, and `AsyncDisposableStack`.

.changeset/tough-cats-fall.md

@@ -0,0 +1,68 @@
+---
+"@evolu/common": major
+"@evolu/web": major
+---
+
+Replaced interface-based symmetric encryption with direct function-based API
+
+### Breaking Changes
+
+**Removed:**
+
+- `SymmetricCrypto` interface
+- `SymmetricCryptoDep` interface
+- `createSymmetricCrypto()` factory function
+- `SymmetricCryptoDecryptError` error type
+
+**Added:**
+
+- `encryptWithXChaCha20Poly1305()` - Direct encryption function with explicit algorithm name
+- `decryptWithXChaCha20Poly1305()` - Direct decryption function
+- `XChaCha20Poly1305Ciphertext` - Branded type for ciphertext
+- `Entropy24` - Branded type for 24-byte nonces
+- `DecryptWithXChaCha20Poly1305Error` - Algorithm-specific error type
+- `xChaCha20Poly1305NonceLength` - Constant for nonce length (24)
+
+### Migration Guide
+
+**Before:**
+
+```ts
+const symmetricCrypto = createSymmetricCrypto({ randomBytes });
+const { nonce, ciphertext } = symmetricCrypto.encrypt(plaintext, key);
+const result = symmetricCrypto.decrypt(ciphertext, key, nonce);
+```
+
+**After:**
+
+```ts
+const [ciphertext, nonce] = encryptWithXChaCha20Poly1305({ randomBytes })(
+  plaintext,
+  key,
+);
+const result = decryptWithXChaCha20Poly1305(ciphertext, nonce, key);
+```
+
+**Error handling:**
+
+```ts
+// Before
+if (!result.ok && result.error.type === "SymmetricCryptoDecryptError") { ... }
+
+// After
+if (!result.ok && result.error.type === "DecryptWithXChaCha20Poly1305Error") { ... }
+```
+
+**Dependency injection:**
+
+```ts
+// Before
+interface Deps extends SymmetricCryptoDep { ... }
+
+// After - only encrypt needs RandomBytesDep
+interface Deps extends RandomBytesDep { ... }
+```
+
+### Rationale
+
+This change improves API extensibility by using explicit function names instead of a generic interface. Adding new encryption algorithms (e.g., `encryptWithAES256GCM`) is now straightforward without breaking existing code.

.changeset/transferable-error-rename.md

@@ -0,0 +1,5 @@
+---
+"@evolu/common": major
+---
+
+Renamed `TransferableError` to `UnknownError` to better reflect its purpose as a wrapper for unknown errors caught at runtime, not just errors that need to be transferred between contexts

.changeset/typed-discriminant.md

@@ -0,0 +1,22 @@
+---
+"@evolu/common": minor
+---
+
+Added `Typed` interface and `typed` factory for discriminated unions
+
+Discriminated unions model mutually exclusive states where each variant is a distinct type. This makes illegal states unrepresentable — invalid combinations cannot exist.
+
+```ts
+// Type-only usage for static discrimination
+interface Pending extends Typed<"Pending"> {
+  readonly createdAt: DateIso;
+}
+interface Shipped extends Typed<"Shipped"> {
+  readonly trackingNumber: TrackingNumber;
+}
+type OrderState = Pending | Shipped;
+
+// Runtime validation with typed() factory
+const Pending = typed("Pending", { createdAt: DateIso });
+const Shipped = typed("Shipped", { trackingNumber: TrackingNumber });
+```

.changeset/worker-abstraction-refactor.md

@@ -0,0 +1,16 @@
+---
+"@evolu/common": major
+"@evolu/web": major
+"@evolu/react-native": major
+"@evolu/react-web": major
+---
+
+Refactored worker abstraction to support all platforms uniformly:
+
+- Added platform-agnostic worker interfaces: `Worker<Input, Output>`, `SharedWorker<Input, Output>`, `MessagePort<Input, Output>`, `MessageChannel<Input, Output>`
+- Added worker-side interfaces: `WorkerScope<Input, Output>` and `SharedWorkerScope<Input, Output>` that extend `GlobalErrorScope` for unified error handling
+- Changed `onMessage` from a method to a property for consistency with Web APIs
+- Made all worker and message port interfaces `Disposable` for proper resource cleanup
+- Added default generic parameters (`Output = never`) for simpler one-way communication patterns
+- Added complete web platform implementations: `createWorker`, `createSharedWorker`, `createMessageChannel`, `createWorkerScope`, `createSharedWorkerScope`, `createMessagePort`
+- Added React Native polyfills for Workers and MessageChannel

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+- OS: [e.g. iOS]
+- Browser [e.g. chrome, safari]
+- Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+- Device: [e.g. iPhone6]
+- OS: [e.g. iOS8.1]
+- Browser [e.g. stock browser, safari]
+- Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.