Merge pull request #36 from SQLoot/bun-first

PR: merge fixed bun-first to main

Author: miccy

.changeset/array-module-refactor.md

@@ -35,6 +35,7 @@ if (isNonEmptyArray(mutableArr)) { ... }
 - **`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`)
+- **`zipArray`** — combines multiple arrays into an array of tuples, preserving non-empty type
 
 ### Migration
 

…eset/console-static-level-inheritance.md .changeset/console-improved.md.changeset/console-static-level-inheritance.md renamed to .changeset/console-improved.md .changeset/console-static-level-inheritance.md renamed to .changeset/console-improved.md

@@ -8,7 +8,7 @@ Redesigned Console with structured logging and pluggable outputs
 
 - Replaced `enabled` property with `ConsoleLevel` filtering (trace < debug < log < info < warn < error < silent)
 - Removed `enableLogging` config option - use `level` instead
-- Removed `createConsoleWithTime` - use `createConsoleEntryFormatter` with `formatEntry` option
+- Removed `createConsoleWithTime` - use `createConsoleFormatter` with `format` option
 - Removed `assert` method
 - Changed `TestConsole.getLogsSnapshot()` to `getEntriesSnapshot()` returning `ConsoleEntry` objects
 - Changed `TestConsole.clearLogs()` to `clearEntries()`
@@ -21,6 +21,9 @@ Redesigned Console with structured logging and pluggable outputs
 - `children: ReadonlySet<Console>` tracks child consoles for batch operations
 - `name` property identifies consoles
 - `getLevel()`, `setLevel(level | null)`, `hasOwnLevel()` for runtime level control
-- `createConsoleEntryFormatter` for timestamps (relative, absolute, iso) and path prefixes
+- `createConsoleFormatter` for timestamps (relative, absolute, iso) and path prefixes
 - `createNativeConsoleOutput` and `createConsoleArrayOutput` built-in outputs
 - Static level inheritance - children inherit parent's level at creation, then are independent
+- `createConsoleStoreOutput` — a `ConsoleOutput` that stores the latest entry in a `ReadonlyStore` for observing log entries (e.g., forwarding from workers to main thread)
+- `createMultiOutput` — fans out entries to multiple outputs (e.g., native console + store)
+- Simplified `testCreateConsole` to delegate to `createConsole` internally

.changeset/lovely-aliens-camp.md

@@ -2,7 +2,7 @@
 "@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.
+Added `createObjectURL` helper for safe, disposable `URL.createObjectURL` usage using JS Resource management so the URL is disposed automatically when the scope ends.
 
 Example:
 

.changeset/set-module.md

@@ -12,7 +12,7 @@ Added Set module with type-safe helpers for immutable set operations.
 
 - `emptySet` — singleton empty set to avoid allocations
 
-**Type Guards:**
+**Type guards:**
 
 - `isNonEmptySet` — narrows to branded `NonEmptyReadonlySet`
 

.changeset/spotty-coats-sort.md

@@ -2,7 +2,7 @@
 "@evolu/common": minor
 ---
 
-Added Resource Management polyfills
+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.
 

.changeset/worker-abstraction-refactor.md

@@ -8,9 +8,9 @@
 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
+- Added worker-side interfaces: `WorkerSelf<Input, Output>` and `SharedWorkerSelf<Input, Output>` for typed worker `self` wrappers
 - 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 complete web platform implementations: `createWorker`, `createSharedWorker`, `createMessageChannel`, `createWorkerSelf`, `createSharedWorkerSelf`, `createMessagePort`
 - Added React Native polyfills for Workers and MessageChannel

apps/web/next.config.mjs

@@ -17,6 +17,32 @@ const withMDX = nextMDX({
 const nextConfig = {
   reactStrictMode: true,
   pageExtensions: ["js", "jsx", "ts", "tsx", "mdx"],
+
+  // Resolve workspace @evolu/* packages to TypeScript source for live reload.
+  // The "source" condition matches the export added to each package.json.
+  // The extensionAlias maps .js imports to .ts since packages use NodeNext
+  // module resolution with explicit .js extensions (required for npm publishing).
+  transpilePackages: [
+    "@evolu/common",
+    "@evolu/web",
+    "@evolu/react",
+    "@evolu/react-web",
+  ],
+  webpack(config) {
+    config.resolve.conditionNames = [
+      "source",
+      "browser",
+      "import",
+      "module",
+      "require",
+      "default",
+    ];
+    config.resolve.extensionAlias = {
+      ".js": [".ts", ".tsx", ".js"],
+    };
+    return config;
+  },
+
   outputFileTracingIncludes: {
     "/**/*": ["./src/app/**/*.mdx"],
   },

apps/web/package.json

@@ -17,6 +17,7 @@
   ],
   "dependencies": {
     "@algolia/autocomplete-core": "^1.19.4",
+    "@emotion/is-prop-valid": "^1.4.0",
     "@evolu/common": "workspace:*",
     "@evolu/react": "workspace:*",
     "@evolu/react-web": "workspace:*",

apps/web/src/app/(docs)/docs/local-first/page.mdx

@@ -94,6 +94,23 @@ const Schema = {
   `createdAt`, `updatedAt`, `isDeleted`, and `ownerId`.
 </Note>
 
+## Bun hot workflow (schema iteration)
+
+If you run your app entrypoint directly with Bun, you can use hot mode while
+iterating on schema and mutations:
+
+```bash
+bun --hot ./apps/relay/src/index.ts
+```
+
+This keeps process startup fast during development and reloads on file changes.
+
+<Note>
+  Schema changes can invalidate existing local data during development. If you
+  hit schema mismatch errors, reset local state (for example with
+  `resetAppOwner({ reload: false })`) before retrying.
+</Note>
+
 ## Create Evolu
 
 After defining the schema, create an Evolu instance for your environment.

apps/web/src/app/(playgrounds)/playgrounds/minimal/EvoluMinimalExample.tsx

@@ -27,6 +27,15 @@ const Schema = {
 
 const deps = createEvoluDeps();
 
+deps.evoluError.subscribe(() => {
+  const error = deps.evoluError.get();
+  if (!error) return;
+
+  alert("🚨 Evolu error occurred! Check the console.");
+  // eslint-disable-next-line no-console
+  console.error(error);
+});
+
 // Create Evolu instance for the React web platform.
 const evolu = Evolu.createEvolu(deps)(Schema, {
   name: Evolu.SimpleName.orThrow("minimal-example"),
@@ -46,20 +55,6 @@ const evolu = Evolu.createEvolu(deps)(Schema, {
 // in tests via the EvoluProvider.
 const useEvolu = createUseEvolu(evolu);
 
-/**
- * Subscribe to Evolu errors (database, network, sync issues). These should not
- * happen in normal operation, so always log them for debugging. Show users a
- * friendly error message instead of technical details.
- */
-evolu.subscribeError(() => {
-  const error = evolu.getError();
-  if (!error) return;
-
-  alert("🚨 Evolu error occurred! Check the console.");
-  // eslint-disable-next-line no-console
-  console.error(error);
-});
-
 export const EvoluMinimalExample: FC = () => (
   <div className="min-h-screen px-8 py-8">
     <div className="mx-auto max-w-md">