DanielWalnut 459dd78707
perf(frontend): bound delivery, bundles, and long-running UI work (#4622)
* docs: design frontend performance remediation

* docs: plan frontend performance remediation

* test(frontend): add route asset performance budgets

* perf(nginx): compress textual responses safely

* perf(frontend): lazy load case study media

* perf(frontend): bound static demo file tracing

* perf(frontend): restore static locale boundaries

* perf(frontend): defer closed workspace panels

* perf(frontend): split editors and deduplicate highlighting

* perf(frontend): index incremental message derivation

* perf(frontend): stabilize paged history cache policy

* perf(frontend): bound streaming markdown renders

* perf(frontend): virtualize message history

* perf(frontend): bound and virtualize chat lists

* perf(frontend): suspend inactive decorative animation

* perf(browser): stream latest frames as binary

* perf(artifacts): stream bounded text previews

* docs: finalize performance runtime boundaries

* style(backend): apply test formatting

* fix(frontend): keep translation functions client-side

* perf(frontend): defer decorative animation bundles

* test(frontend): lock optimized route budgets

* fix: harden frontend performance boundaries

* test(frontend): update i18n provider fixture

* fix(frontend): preserve sidebar pagination position

* style(backend): format artifact range test
2026-08-01 22:19:59 +08:00

64 lines
1.6 KiB
TypeScript

/** Coalesces lossy browser frames to the display refresh rate. */
export class LatestBrowserFrameBuffer {
private pendingFrame: Blob | null = null;
private pendingFrameRequest: number | null = null;
private currentUrl: string | null = null;
private readonly listeners = new Set<() => void>();
getSnapshot = () => this.currentUrl;
subscribe = (listener: () => void) => {
this.listeners.add(listener);
return () => this.listeners.delete(listener);
};
push(frame: Blob) {
this.pendingFrame = frame;
if (this.pendingFrameRequest !== null) return;
this.pendingFrameRequest = requestAnimationFrame(() => {
this.pendingFrameRequest = null;
const latestFrame = this.pendingFrame;
this.pendingFrame = null;
if (!latestFrame) return;
const nextUrl = URL.createObjectURL(latestFrame);
this.revokeCurrentObjectUrl();
this.currentUrl = nextUrl;
this.notify();
});
}
replaceWithUrl(url: string) {
this.cancelPendingFrame();
this.revokeCurrentObjectUrl();
this.currentUrl = url;
this.notify();
}
dispose() {
this.cancelPendingFrame();
this.revokeCurrentObjectUrl();
this.notify();
}
private cancelPendingFrame() {
this.pendingFrame = null;
if (this.pendingFrameRequest !== null) {
cancelAnimationFrame(this.pendingFrameRequest);
this.pendingFrameRequest = null;
}
}
private revokeCurrentObjectUrl() {
if (this.currentUrl?.startsWith("blob:")) {
URL.revokeObjectURL(this.currentUrl);
}
this.currentUrl = null;
}
private notify() {
this.listeners.forEach((listener) => listener());
}
}