Skip to content

feat: live-sync client for pushing layouts to the plugin - #1

Merged
gitKBDL merged 1 commit into
mainfrom
feature/live-sync
Jun 23, 2026
Merged

gitKBDL merged 1 commit into
mainfrom
feature/live-sync

Conversation

@gitKBDL

@gitKBDL gitKBDL commented Jun 23, 2026

Copy link
Copy Markdown
Owner

Add a cloud-free live-sync client that streams the current layout to a running AdvancedGUI plugin over its WebSocket server (default ws://localhost:27757), reusing the existing finalized serialization.

  • SyncManager: builds the exact wire payload the plugin's LayoutManager.syncFromJson expects — { name, componentTree (stringified finalized GroupComponent, double-encoded), invisible[] } — via convertToFinalized; debounced push on the history change signal; ack heartbeat; mixed-content guard (https can only reach ws:// on loopback); resource-drift warning (images/gifs/fonts cannot be synced).
  • LiveSync.vue: header panel with status pill, server field, connect/disconnect, and a copyable "/ag sync " command.
  • tests/sync.payload.test.ts: wire-contract tests, validating the finalized colors against the plugin deserializer mirror and the https loopback guard.

Verified end to end against a real Paper server running AdvancedGUI 3.0.3: the editor payload loads and applies with no parse errors.

Add a cloud-free live-sync client that streams the current layout to a
running AdvancedGUI plugin over its WebSocket server (default
ws://localhost:27757), reusing the existing finalized serialization.

- SyncManager: builds the exact wire payload the plugin's
  LayoutManager.syncFromJson expects — { name, componentTree (stringified
  finalized GroupComponent, double-encoded), invisible[] } — via
  convertToFinalized; debounced push on the history change signal;
  ack heartbeat; mixed-content guard (https can only reach ws:// on
  loopback); resource-drift warning (images/gifs/fonts cannot be synced).
- LiveSync.vue: header panel with status pill, server field,
  connect/disconnect, and a copyable "/ag sync <key> <layout>" command.
- tests/sync.payload.test.ts: wire-contract tests, validating the
  finalized colors against the plugin deserializer mirror and the
  https loopback guard.

Verified end to end against a real Paper server running AdvancedGUI
3.0.3: the editor payload loads and applies with no parse errors.
Repository owner deleted a comment from chatgpt-codex-connector Bot Jun 23, 2026
@gitKBDL
gitKBDL merged commit 1ffc29f into main Jun 23, 2026
2 checks passed
@gitKBDL
gitKBDL deleted the feature/live-sync branch June 23, 2026 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant