Sync upstream common-v8 2026-03-03

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
   "vcs": {
     "enabled": true,
     "clientKind": "git",

examples/angular-vite-pwa/package.json

@@ -15,7 +15,7 @@
     "@evolu/web": "workspace:*"
   },
   "devDependencies": {
-    "@analogjs/vite-plugin-angular": "^2.2.2",
+    "@analogjs/vite-plugin-angular": "^2.3.1",
     "@angular/build": "^21.1.5",
     "@angular/compiler-cli": "^21.1.5",
     "@tailwindcss/vite": "^4.2.1",

examples/react-nextjs/package.json

@@ -24,7 +24,7 @@
     "@types/node": "^25.3.3",
     "@types/react": "~19.2.14",
     "@types/react-dom": "~19.2.3",
-    "postcss": "^8.5.6",
+    "postcss": "^8.5.8",
     "tailwindcss": "^4.2.1",
     "typescript": "^5.9.3"
   }

package.json

@@ -16,6 +16,7 @@
     "build": "turbo --filter @evolu/* build",
     "build:web": "bun run build:docs && turbo --filter web build",
     "build:docs": "bun run docs:generate:api",
+    "typecheck": "tsc --build tsconfig.typecheck.json",
     "test": "bun run test:preflight && bunx vitest run",
     "test:preflight": "bun run test:preflight:bun && bun run test:preflight:node",
     "test:preflight:bun": "bun ./scripts/ensure-better-sqlite3.mts --runtime=bun",
@@ -49,7 +50,7 @@
     "sync:guard:common-v8": "bun ./scripts/sync-guard-common-v8.mts",
     "sync:guard:common-v8:strict": "bun ./scripts/sync-guard-common-v8.mts --strict",
     "verify:fast": "bun run build && bun run test && bun run lint && bun run lint-monorepo",
-    "verify": "bun run format && bun run build && bun run test && bun run test:coverage && bun run lint && bun run lint-monorepo",
+    "verify": "bun run typecheck && bun run format && bun run build && bun run test && bun run test:coverage && bun run lint && bun run lint-monorepo",
     "clean": "turbo clean && rimraf node_modules bun.lock .turbo out coverage",
     "version": "changeset version",
     "release": "bun run build && changeset publish",
@@ -66,7 +67,7 @@
     "docs:sync:website": "bun ./scripts/docs-sync-website.mts"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.4",
+    "@biomejs/biome": "^2.4.5",
     "@changesets/cli": "^2.29.8",
     "@types/webpack": "^5.28.5",
     "@vitest/browser": "^4.0.18",
@@ -80,6 +81,9 @@
     "vitest": "^4.0.18",
     "webpack": "^5.105.2"
   },
+  "overrides": {
+    "serialize-javascript": "^7.0.3"
+  },
   "engines": {
     "node": ">=24.0.0"
   },

packages/astro/package.json

@@ -22,6 +22,9 @@
     "clean": "rimraf .turbo node_modules dist"
   },
   "devDependencies": {
+    "@evolu/common": "workspace:*",
+    "@evolu/react": "workspace:*",
+    "@evolu/react-web": "workspace:*",
     "@evolu/tsconfig": "workspace:*",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"

packages/bun/tsconfig.build.json

@@ -0,0 +1,6 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["src"],
+  "exclude": ["dist", "node_modules", "test"],
+  "references": [{ "path": "../common/tsconfig.build.json" }]
+}

packages/common/src/local-first/Schema.ts

@@ -30,6 +30,7 @@ import {
   type StandardSchemaV1,
 } from "../Type.js";
 import type { Simplify } from "../Types.js";
+import type { jsonArrayFrom, jsonObjectFrom } from "./Kysely.js";
 import type { AppOwner } from "./Owner.js";
 import { OwnerId } from "./Owner.js";
 import type { Query, Row } from "./Query.js";
@@ -392,6 +393,11 @@ export const evoluSchemaToSqliteSchema = <S extends EvoluSchema>(
 /**
  * Creates a query builder from a {@link EvoluSchema}.
  *
+ * Supports Kysely relation-style query composition (nested objects/arrays via
+ * JSON subqueries), such as {@link jsonObjectFrom} and {@link jsonArrayFrom} from
+ * the
+ * {@link https://kysely.dev/docs/recipes/relations | Kysely relations recipe}.
+ *
  * ### Example
  *
  * ```ts