feat(m0): adopt Biome for linting and formatting

.changeset/add-types-utilities.md

@@ -0,0 +1,14 @@
+---
+"@evolu/common": minor
+---
+
+Added new types and utilities to Types.ts:
+
+- `Awaitable<T>` - type for values that can be sync or async
+- `isPromiseLike` - type guard to check if a value is a PromiseLike
+- `Digit`, `Digit1To9`, `Digit1To6`, `Digit1To23`, `Digit1To51`, `Digit1To99`, `Digit1To59` - template literal types for numeric validation
+- `UnionToIntersection<U>` - converts a union to an intersection
+
+`Awaitable<T>` represents values that can be either synchronous or asynchronous (`T | PromiseLike<T>`). This type is useful for functions that may complete synchronously or asynchronously depending on runtime conditions.
+
+`isPromiseLike()` is a type guard to check if an Awaitable value is async, allowing conditional await only when necessary.

.changeset/array-module-refactor.md

@@ -0,0 +1,52 @@
+---
+"@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 Constants
+
+- **`emptyArray`** — use as a default or initial value to avoid allocating new empty arrays
+
+### 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/config.json

@@ -1,11 +1,11 @@
 {
-  "$schema": "https://unpkg.com/@changesets/config@2.1.1/schema.json",
-  "changelog": "@changesets/cli/changelog",
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "restricted",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": ["web", "@example/*"]
+	"$schema": "https://unpkg.com/@changesets/config@2.1.1/schema.json",
+	"changelog": "@changesets/cli/changelog",
+	"commit": false,
+	"fixed": [],
+	"linked": [],
+	"access": "restricted",
+	"baseBranch": "main",
+	"updateInternalDependencies": "patch",
+	"ignore": ["web", "@example/*"]
 }

.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/listeners-module.md

@@ -0,0 +1,19 @@
+---
+"@evolu/common": patch
+---
+
+Added Listeners module for publish-subscribe notifications
+
+### Example
+
+```ts
+// Without payload (default)
+const listeners = createListeners();
+listeners.subscribe(() => console.log("notified"));
+listeners.notify();
+
+// With typed payload
+const listeners = createListeners<{ id: string }>();
+listeners.subscribe((event) => console.log(event.id));
+listeners.notify({ id: "123" });
+```

.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/next-result-done.md

@@ -0,0 +1,18 @@
+---
+"@evolu/common": minor
+---
+
+Added pull-based protocol types for modeling three-outcome operations
+
+New types and utilities for iterators and streams where completion is a normal outcome, not an error:
+
+- `Done<D>` - Signal type for normal completion with optional summary value
+- `done(value)` - Factory function to create Done instances
+- `NextResult<A, E, D>` - Result that can complete with value, error, or done
+- `nextResult(ok, err, done)` - Factory for creating NextResult Type instances
+- `UnknownNextResult` - Type instance for runtime `.is()` checks
+- `InferDone<R>` - Extracts the done value type from a NextResult
+- `NextTask<T, E, D>` - Task that can complete with value, error, or done
+- `InferTaskDone<T>` - Extracts the done value type from a NextTask
+
+The naming follows the existing pattern: `Result` → `NextResult`, `Task` → `NextTask`.

.changeset/random-number-brand.md

@@ -0,0 +1,9 @@
+---
+"@evolu/common": minor
+---
+
+Added `RandomNumber` branded type for type-safe random values
+
+- `RandomNumber` — branded `number` type for values in [0, 1) range
+- `Random.next()` now returns `RandomNumber` instead of `number`
+- Prevents accidentally passing arbitrary numbers where random values are expected

.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/schedule-module.md

@@ -0,0 +1,42 @@
+---
+"@evolu/common": minor
+---
+
+Added Schedule module for composable scheduling strategies.
+
+**Schedule** is a composable abstraction for retry, repeat, and rate limiting. Each schedule is a state machine: calling `schedule(deps)` creates a step function, and each `step(input)` returns `Ok([Output, Millis])` or `Err(Done<void>)` to stop.
+
+**Constructors:**
+
+- `forever` — never stops, no delay (base for composition)
+- `once` — runs exactly once
+- `recurs(n)` — runs n times
+- `spaced(duration)` — constant delay
+- `exponential(base, factor?)` — exponential backoff
+- `linear(base)` — linear backoff
+- `fibonacci(initial)` — Fibonacci backoff
+- `fixed(interval)` — window-aligned intervals
+- `windowed(interval)` — sleeps until next window boundary
+- `fromDelay(duration)` — single delay
+- `fromDelays(...durations)` — sequence of delays
+- `elapsed` — outputs elapsed time
+- `during(duration)` — runs for specified duration
+- `succeed(value)` — constant output
+- `unfold(initial, next)` — state machine
+
+**Combinators:**
+
+- Limiting: `take`, `maxElapsed`, `maxDelay`
+- Delay: `jitter`, `delayed`, `addDelay`, `modifyDelay`, `compensateExecution`
+- Filtering: `whileInput`, `untilInput`, `whileOutput`, `untilOutput`, `resetAfter`
+- Transform: `map`, `passthrough`, `fold`, `repetitions`, `delays`
+- Collection: `collectAllOutputs`, `collectInputs`, `collectWhile`, `collectUntil`
+- Composition: `sequence`, `intersect`, `union`, `whenInput`
+- Side effects: `tapOutput`, `tapInput`
+
+**Presets:**
+
+- `retryStrategyAws` — exponential backoff (100ms base), max 2 retries, 20s cap, full jitter
+- `retryStrategyAwsThrottled` — same but with 1s base for rate limiting
+
+All APIs are marked `@experimental`.

.changeset/set-module.md

@@ -0,0 +1,28 @@
+---
+"@evolu/common": minor
+---
+
+Added Set module with type-safe helpers for immutable set operations.
+
+**Types:**
+
+- `NonEmptyReadonlySet<T>` — branded type for sets with at least one element (no mutable variant because `clear()`/`delete()` would break the guarantee)
+
+**Constants:**
+
+- `emptySet` — singleton empty set to avoid allocations
+
+**Type Guards:**
+
+- `isNonEmptySet` — narrows to branded `NonEmptyReadonlySet`
+
+**Transformations:**
+
+- `addToSet` — returns branded non-empty set with item added
+- `deleteFromSet` — returns new set with item removed
+- `mapSet` — maps over set, preserves non-empty type
+- `filterSet` — filters set with predicate or refinement
+
+**Accessors:**
+
+- `firstInSet` — returns first element by insertion order (requires branded type)

.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/time-module-refactor.md

@@ -0,0 +1,34 @@
+---
+"@evolu/common": major
+---
+
+Refactored Time module for type safety, consistency, and better abstractions.
+
+**Type safety:**
+
+- Changed `Time.now()` return type from `number` to `Millis`
+- Added `Millis` branded type with efficient 6-byte serialization (max value: year 10889)
+- Added `minMillis` and `maxMillis` constants
+- Both `now()` and `nowIso()` now throw on invalid values for consistent error handling
+
+**Timer abstraction:**
+
+- Added `Time.setTimeout` and `Time.clearTimeout` for platform-agnostic timers
+- Added `TimeoutId` opaque type for timeout handles
+- Added `TestTime` interface with `advance()` for controllable time in tests
+- Updated `createTestTime` with `startAt` and `autoIncrement` options
+
+**Duration literals:**
+
+- Renamed `DurationString` to `DurationLiteral`
+- Each duration has exactly one canonical form (e.g., "1000ms" must be written as "1s")
+- Added decimal support: "1.5s" (1500ms), "1.5h" (90 minutes)
+- Added weeks ("1w" to "51w") and years ("1y" to "99y")
+- Removed combination syntax ("1h 30m") in favor of decimals ("1.5h")
+- Months not supported (variable length)
+
+**UI responsiveness constants:**
+
+- `ms60fps` (16ms frame budget at 60fps)
+- `ms120fps` (8ms frame budget at 120fps)
+- `msLongTask` (50ms long task threshold for use with `yieldNow`)