main
md 1.08 KB

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.