@ultimat3/realtime 27.5.0 → 27.6.0

package/README.md

@@ -87,7 +87,7 @@ class — stay on `.`.
 | hooks | `.` | `useQuery`, `useRecord`, `useRecords` (by key, or a whole type: `RecordSelection`), `useMutation`, `useMutationQueue`, `useOutbox`, `useConnection`, `useChannel`, `usePresence`, `hasPageSocket`, `installRealtime` |
 | channel records, no replicator | `./server` | `recordPublisher` — an app's committed rows as channel `records`, sequenced per producer ([below](#channel-records-with-no-replicator)) |
 | channels | `.` | `channel`, `channelRef`, `ChannelHandle`, `topic`, `readPresence`, the channel frame types |
-| first paint | `.` | `holdFirstPaint`, `FIRST_PAINT_HOLD_MS` (1 s) — what the island bootstrap awaits before `mount`: the boot's restore and the open outbox, capped (#506) |
+| first paint | `.` | `holdFirstPaint`, `FIRST_PAINT_HOLD_MS` (1 s) — what the island bootstrap awaits before `mount`, for an island that reads the store or the outbox: the boot's restore and the open outbox, capped (#506). An island taking only `useChannel` / `usePresence` / `useConnection` never awaits it and is never hidden |
 | offline | `.` | `pageOutbox`, `recordPersister`, `persistedTypes`, `openLocalStore`, `pageLocalStore`, `memoryLocalStore()` |
 | the socket's worker | `./sync-worker` | the SharedWorker entry — no exports |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/realtime",
-  "version": "27.5.0",
+  "version": "27.6.0",
   "description": "Three-tier realtime: channels, live queries, local-first sync — one protocol, one mutator shape",
   "license": "MIT",
   "type": "module",
@@ -40,10 +40,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "27.5.0",
-    "@ultimat3/entity": "27.5.0",
-    "@ultimat3/policy": "27.5.0",
-    "@ultimat3/query": "27.5.0",
+    "@ultimat3/core": "27.6.0",
+    "@ultimat3/entity": "27.6.0",
+    "@ultimat3/policy": "27.6.0",
+    "@ultimat3/query": "27.6.0",
     "nats": "2.29.3"
   }
 }

package/src/error-titles.ts

@@ -5,7 +5,10 @@
 // rebuilds a node's refusal by code in `refusalError`, and `page-errors.ts` constructs codes from
 // here without importing it) and by `errors.ts`, so constructing a server refusal registers too.
 
-import { registerErrorCodes } from '@ultimat3/core';
+// From `/page`, never core's barrel: this module is in every island chunk that reaches realtime,
+// and the barrel's own anchors are core's and schema's titles tables — 4,571 B minified of titles
+// no realtime island reads (`page-errors-bundle.test.ts`). The registry is one module either way.
+import { registerErrorCodes } from '@ultimat3/core/page';
 
 /** Codes this package declares and owns. */
 export const REALTIME_OWNED_ERROR_CODES = [

package/src/first-paint-hold.ts

@@ -1,7 +1,7 @@
-// What a realtime island's bootstrap awaits before its `mount` may run (#506, owner option 3): the
-// page boot's disk restore AND the outbox it opened, so the island's first render already carries
-// the overlays a reload rebuilds from the queue — never the server's stale count. Capped, because
-// an IndexedDB that hangs must cost the hold, never the island.
+// What the bootstrap of a realtime island that READS the store or the outbox awaits before `mount`
+// (#506, owner option 3; one that only follows a channel never imports this): the page boot's disk
+// restore AND the outbox it opened, so the first render already carries the overlays a reload
+// rebuilds from the queue. Capped, because an IndexedDB that hangs must cost the hold, never the island.
 
 import { peekOutbox } from './outbox-slot';
 import { pageRealtime } from './page-store';