teamplay 0.4.0-alpha.34 → 0.4.0-alpha.35

package/orm/Compat/README.md

@@ -589,6 +589,9 @@ They are designed to behave close to StartupJS hooks, but adapted to Teamplay’
 General notes:
 - Hooks should be used inside `observer()` components to get reactive updates.
 - Sync hooks (`useDoc`, `useQuery`) use Suspense by default (via `useSub`).
+- In compatibility mode, sync hooks are strict (`defer: false`) to match racer-like
+  semantics and avoid transient `undefined` / empty snapshots during fast navigation.
+  This is enforced by compat hooks (user `defer` option is ignored for sync hooks).
 - Async hooks (`useAsyncDoc`, `useAsyncQuery`) never throw; they return `undefined` until ready.
 - Batch hooks use a Suspense batch barrier (`useBatch`) and wait for both
   subscribe promises and DataTree materialization readiness.

package/orm/Compat/hooksCompat.js

@@ -84,7 +84,7 @@ export function useBatch () {
 
 export function useDoc$ (collection, id, options) {
   const $doc = getDocSignal(collection, id, 'useDoc')
-  const normalizedOptions = options ? { ...options, async: false } : options
+  const normalizedOptions = normalizeSyncSubOptions(options)
   return useSub($doc, undefined, normalizedOptions)
 }
 
@@ -119,14 +119,14 @@ export function useAsyncDoc (collection, id, options) {
 
 export function useQuery$ (collection, query, options) {
   const $collection = getCollectionSignal(collection, query, 'useQuery')
-  const normalizedOptions = options ? { ...options, async: false } : options
+  const normalizedOptions = normalizeSyncSubOptions(options)
   const $query = useSub($collection, normalizeQuery(query, 'useQuery'), normalizedOptions)
   return $query
 }
 
 export function useQuery (collection, query, options) {
   const $collection = getCollectionSignal(collection, query, 'useQuery')
-  const normalizedOptions = options ? { ...options, async: false } : options
+  const normalizedOptions = normalizeSyncSubOptions(options)
   const $query = useSub($collection, normalizeQuery(query, 'useQuery'), normalizedOptions)
   return [$query.get(), $collection]
 }
@@ -324,6 +324,18 @@ const BATCH_SUB_OPTIONS = Object.freeze({
   defer: false
 })
 
+function normalizeSyncSubOptions (options) {
+  if (!isCompatEnv()) {
+    return options ? { ...options, async: false } : options
+  }
+  return {
+    ...(options || {}),
+    async: false,
+    // Compat sync hooks are strict by design: no deferred snapshots between route/tab switches.
+    defer: false
+  }
+}
+
 function getDocIdFromSignal ($doc) {
   const path = typeof $doc?.path === 'function' ? $doc.path() : ''
   const segments = path ? path.split('.').filter(Boolean) : []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamplay",
-  "version": "0.4.0-alpha.34",
+  "version": "0.4.0-alpha.35",
   "description": "Full-stack signals ORM with multiplayer",
   "type": "module",
   "main": "index.js",
@@ -81,5 +81,5 @@
     ]
   },
   "license": "MIT",
-  "gitHead": "619024ea6ea3699ab461c279791a59e5a58334ab"
+  "gitHead": "92ba9ceb7dfb2ede1ccf1e7bb4d06cf71e2efafc"
 }