File size: 1,106 Bytes
6918275
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Sync Components DOX

## Purpose

- Own WebUI state synchronization status UI and store.

## Ownership

- `sync-store.js` owns sync status state.
- `sync-status.html` owns sync indicator markup and the `sync-status-end`
  extension point for connection-related controls.

## Local Contracts

- Keep sync state compatible with WebSocket state-sync events.
- Apply `state_push` snapshots sequentially because WebSocket subscribers do not await async callbacks; later pushes must not race earlier full renders.
- A queued state push that finishes after transport loss must not overwrite the
  `DISCONNECTED` mode or flush reconnect notifications.
- Avoid noisy user-facing alerts for transient sync state unless existing UX expects them.
- Keep the compact status cluster free of native title tooltips; interactive
  extensions must provide accessible names directly.

## Work Guidance

- Coordinate sync changes with WebSocket client and backend WebSocket extensions.

## Verification

- Smoke-test connection, reconnect, and state refresh indicators after changes.

## Child DOX Index

No child DOX files.