@paged-media/plugin-sdk 0.2.16-canary.0 → 0.2.17-canary.0

package/dist/index.js

@@ -984,6 +984,87 @@ function createBundleHost(getEditor, manifest, options) {
       }
     }
   };
+  const imageChannel = () => getEditor().images;
+  const images = {
+    claimImageResource(elementId, opts) {
+      requireDeclared(
+        hasRendering("resourceProvider"),
+        "images.claimImageResource",
+        'capabilities.rendering must include "resourceProvider"'
+      );
+      const channel = imageChannel();
+      if (!channel) {
+        log.warn(
+          `images.claimImageResource("${elementId}") ignored \u2014 the host wired no resource channel (probe supports("rendering.resourceProvider@1"))`
+        );
+        return store.add(toDisposable(() => {
+        }));
+      }
+      let released = false;
+      const off = channel.onResourceTilesNeeded((need) => {
+        if (released || need.imageId !== elementId) return;
+        void (async () => {
+          const tiles = [];
+          for (const [x, y] of need.tiles) {
+            let tile;
+            try {
+              tile = await opts.source(need.level, x, y);
+            } catch (err) {
+              log.warn(
+                `images.source(level ${need.level}, ${x}, ${y}) threw \u2014 tile skipped`,
+                err
+              );
+              continue;
+            }
+            if (!tile) continue;
+            tiles.push({
+              x: tile.x,
+              y: tile.y,
+              width: tile.width,
+              height: tile.height,
+              // The wire carries a plain number[]; Array.from copies the
+              // RGBA8 view (isolate-proxy-safe, like the scene-layer path).
+              rgba: Array.from(tile.rgba)
+            });
+          }
+          if (released || tiles.length === 0) return;
+          try {
+            await channel.submitTiles(
+              elementId,
+              need.level,
+              tiles,
+              need.generation
+            );
+          } catch (err) {
+            log.warn(
+              `images.submitTiles("${elementId}", level ${need.level}) failed`,
+              err
+            );
+          }
+        })();
+      });
+      void channel.claim({
+        imageId: elementId,
+        levels: opts.levels,
+        tileSize: opts.tileSize,
+        baseWidth: opts.baseWidth,
+        baseHeight: opts.baseHeight,
+        revision: opts.revision()
+      }).catch((err) => {
+        log.warn(`images.claim("${elementId}") failed`, err);
+      });
+      return store.add(
+        toDisposable(() => {
+          if (released) return;
+          released = true;
+          off();
+          void channel.release(elementId).catch((err) => {
+            log.warn(`images.release("${elementId}") failed`, err);
+          });
+        })
+      );
+    }
+  };
   const blobBackend = options?.blobStore;
   const blobQuota = Math.min(
     BLOB_BUDGETS.defaultQuotaBytes,
@@ -1084,6 +1165,9 @@ function createBundleHost(getEditor, manifest, options) {
   if (getEditor().sceneLayers) {
     featureSet.add("rendering.sceneLayer@1");
   }
+  if (getEditor().images) {
+    featureSet.add("rendering.resourceProvider@1");
+  }
   if (options?.shell) {
     featureSet.add("shell.openPanel@1");
     featureSet.add("shell.pickFile@1");
@@ -1130,6 +1214,7 @@ function createBundleHost(getEditor, manifest, options) {
     bindings,
     widgets,
     assets,
+    images,
     clipboard,
     supports: (feature) => featureSet.has(feature),
     get editor() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paged-media/plugin-sdk",
-  "version": "0.2.16-canary.0",
+  "version": "0.2.17-canary.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "@paged-media/plugin-api": "0.2.16-canary.0"
+    "@paged-media/plugin-api": "0.2.17-canary.0"
   },
   "peerDependencies": {
     "react": "^18.3.0"