@push.rocks/smartbrowser 4.0.1 → 4.1.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartbrowser',
-    version: '4.0.1',
+    version: '4.1.0',
     description: 'A simplified Puppeteer wrapper for easy automation and testing tasks.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwwQkFBMEI7SUFDaEMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVFQUF1RTtDQUNyRixDQUFBIn0=

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartbrowser',
-    version: '4.0.1',
+    version: '4.1.0',
     description: 'A simplified Puppeteer wrapper for easy automation and testing tasks.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUsMEJBQTBCO0lBQ2hDLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSx1RUFBdUU7Q0FDckYsQ0FBQSJ9

package/dist_ts_web/classes.livebrowsercanvasrenderer.d.ts

@@ -1,11 +1,12 @@
-import type { ILiveBrowserCanvasRendererOptions } from './interfaces.livebrowsercanvas.js';
+import type { ILiveBrowserCanvasRendererOptions, ILiveBrowserCanvasRendererStatistics } from './interfaces.livebrowsercanvas.js';
 /**
  * Renders transport-neutral live browser frames and maps DOM input back to the
  * currently displayed SmartPuppeteer frame identity.
  */
 export declare class LiveBrowserCanvasRenderer {
     private readonly canvas;
-    private readonly canvasContext;
+    private readonly canvasContext?;
+    private readonly bitmapContext?;
     private readonly client;
     private readonly focusTarget;
     private readonly resizeTarget?;
@@ -36,16 +37,21 @@ export declare class LiveBrowserCanvasRenderer {
     private highestFrameSequence;
     private queuedFrame?;
     private frameProcessingPromise?;
+    private pendingDraw?;
+    private drawSchedule?;
     private acknowledgementPromises;
     private rawDecodeSettlementPromises;
     private inputBlocked;
     private inputCommands;
-    private inputProcessing;
+    private inFlightInputCommands;
+    private inFlightWheelCommands;
     private inputIdleResolvers;
     private inputResetTail;
     private inputResetPromise?;
     private inputResetCount;
-    private inputOverflowRecoveryPending;
+    private pendingWheel?;
+    private wheelFlushSchedule?;
+    private wheelFrameElapsed;
     private pressedKeys;
     private pressedMouseButtons;
     private capturedPointerIds;
@@ -54,9 +60,16 @@ export declare class LiveBrowserCanvasRenderer {
     private viewportProcessing;
     private viewportProcessingPromise?;
     private resizeFence?;
+    private resizeDebounceTimer?;
+    private pendingResizeSize?;
+    private readonly statistics;
     constructor(optionsArg: ILiveBrowserCanvasRendererOptions);
     get isRunning(): boolean;
     get isSuspended(): boolean;
+    /**
+     * Cumulative frame and input counters for this renderer instance across runs.
+     */
+    getStatistics(): ILiveBrowserCanvasRendererStatistics;
     start(): Promise<void>;
     stop(): Promise<void>;
     /**
@@ -83,6 +96,7 @@ export declare class LiveBrowserCanvasRenderer {
     private restoreCanvasAndFocus;
     private installDomListeners;
     private installResizeObserver;
+    private clearResizeDebounce;
     private handleEvent;
     private applyState;
     private isStateAheadOfDisplayedFrame;
@@ -90,12 +104,35 @@ export declare class LiveBrowserCanvasRenderer {
     private ensureFrameProcessor;
     private processFrameQueue;
     private processFrame;
+    /**
+     * Keeps only the newest decoded bitmap and presents it on the next animation frame.
+     */
+    private setPendingDraw;
+    private discardPendingDraw;
+    private drawPendingFrame;
+    /**
+     * Presents one decoded bitmap. The canvas backing store is reallocated only
+     * when the frame dimensions differ from the current intrinsic dimensions.
+     */
+    private paintBitmap;
     private canRenderFrame;
     private acknowledgeFrame;
     private handlePointerDown;
     private handlePointerMove;
     private handlePointerUp;
     private handleWheel;
+    /**
+     * Flushes accumulated wheel input at most once per animation frame and only
+     * while no wheel dispatch is in flight; the settling dispatch flushes the rest.
+     */
+    private tryFlushPendingWheel;
+    private scheduleWheelFlush;
+    /**
+     * Moves the accumulated wheel input into the command queue regardless of the
+     * frame gate so that later discrete commands stay behind it.
+     */
+    private flushPendingWheel;
+    private discardPendingWheel;
     private handleKey;
     private mapCoordinates;
     private getMouseButton;
@@ -103,10 +140,21 @@ export declare class LiveBrowserCanvasRenderer {
     private requireInputFrame;
     private isDisplayedFrameCurrent;
     private enqueueInputCommand;
+    /**
+     * Coalescable commands never exhaust capacity: they merge into a same-kind
+     * queue tail or evict the oldest queued coalescable command under pressure.
+     */
+    private enqueueCoalescableCommand;
+    private dropOldestCoalescableCommand;
+    /**
+     * Dispatches queued commands in order with a bounded number in flight. The
+     * remote session processes operations sequentially, so order is preserved.
+     */
     private processInputCommands;
+    private dispatchInputCommand;
+    private handleInputDispatchFailure;
     private waitForInputIdle;
     private scheduleInputReset;
-    private recoverFromInputOverflow;
     private releasePressedInput;
     private tryInputRelease;
     private reportInputReleaseError;
@@ -118,6 +166,12 @@ export declare class LiveBrowserCanvasRenderer {
     private makeFocusTargetFocusable;
     private restoreFocusTarget;
     private clearCanvas;
+    /**
+     * Runs work on the next animation frame, or after one nominal frame period
+     * when the document is not visible and animation frames would not fire.
+     */
+    private scheduleAnimationFrame;
+    private cancelScheduledFrame;
     private callFrameRendered;
     private reportError;
     private requestSuspend;