@wp-playground/remote 3.1.46 → 3.1.47

package/lib/capture-site-thumbnail.d.ts

@@ -0,0 +1,12 @@
+import type { SiteThumbnail } from './playground-client';
+/**
+ * Renders the current WordPress document as a compact site thumbnail.
+ *
+ * This module is loaded inside the WordPress iframe. The remote frame cannot
+ * read that document when Document-Isolation-Policy is active, so capture must
+ * happen on this side of the frame boundary. DOM and computed-style work must
+ * remain in this event loop. The resource worker handles supported fetches,
+ * and the phase callbacks yield so other tasks can run during the remaining
+ * renderer work.
+ */
+export declare function captureSiteThumbnail(): Promise<SiteThumbnail>;

package/lib/playground-client.d.ts

@@ -30,6 +30,19 @@ export interface WebClientMixin extends ProgressReceiver {
      * Gets the current URL.
      */
     getCurrentURL(): Promise<string>;
+    /**
+     * Renders the site's front page in a disposable 1024×768 browsing context
+     * and returns a compact 320×240 image.
+     *
+     * This method does not persist the image or synchronize it with OPFS.
+     * Callers own the result's lifecycle and must discard it if the site changes
+     * while the asynchronous capture is running.
+     *
+     * DOM cloning and canvas rendering run in the captured document's event
+     * loop. A worker handles supported resource fetches, while explicit task
+     * yields keep that document responsive during cloning.
+     */
+    captureSiteThumbnail(): Promise<SiteThumbnail>;
     /**
      * Sets the iframe sandbox flags.
      * @param flags The iframe sandbox flags.
@@ -60,6 +73,12 @@ export interface WebClientMixin extends ProgressReceiver {
     unmountOpfs(mountpoint: string): Promise<void>;
     boot(options: WorkerBootOptions): Promise<void>;
 }
+export type SiteThumbnail = {
+    /** The encoded image's MIME type. */
+    mime: string;
+    /** The base64 payload without a data URL prefix. */
+    data: string;
+};
 /**
  * The Playground Client interface.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wp-playground/remote",
-	"version": "3.1.46",
+	"version": "3.1.47",
 	"description": "WordPress Playground remote host",
 	"repository": {
 		"type": "git",
@@ -25,5 +25,5 @@
 		"access": "public",
 		"directory": "../../../dist/packages/playground/remote"
 	},
-	"gitHead": "581c7c172428159eb4e6c5309054a568cd39a97a"
+	"gitHead": "c7d8be823578baddc82de1bac34f8882632dab90"
 }