Merge branch 'dev' into snyk-fix-b658d13147eb97b3e73c0a339ef562f8

Signed-off-by: Miccy <code@miccy.dev>

Author: miccy

.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,12 @@
+---
+"@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
+---
+
+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.