@paged-media/plugin-sdk 0.2.56-canary.0 → 0.2.57-canary.0

package/dist/index.js

@@ -16486,7 +16486,9 @@ function createBundleHost(getEditor, manifest, options) {
     // like `getPlacedImage` (no injected provider): the document registry
     // is the engine's. Fill-only — the engine is asked first whether it
     // holds the face, and a held face is never sent again — so a bundle
-    // cannot change how text that already resolves is drawn.
+    // cannot change how text that already resolves is drawn. ADR 330 — its
+    // lifetime is the client's: one with `registerDocumentFont` scopes the
+    // face to the open document (`@2`).
     async registerDocumentFont(bytes, family, style) {
       requireDeclared(
         hasAsset("fonts"),
@@ -16512,7 +16514,7 @@ function createBundleHost(getEditor, manifest, options) {
           container === "woff" ? "a WOFF or WOFF2 face \u2014 the canvas reads TrueType and OpenType only" : "the bytes are not a TrueType or OpenType face"
         );
       }
-      const face = Array.from(bytes);
+      const face = bytes.slice();
       let client;
       try {
         client = getEditor().client;
@@ -16528,10 +16530,20 @@ function createBundleHost(getEditor, manifest, options) {
           if (held.kind === "fontFaceBytes" && held.payload.found && (style === void 0 || held.payload.style === style)) {
             return { status: "held" };
           }
-          const reply = await client.send({
-            kind: "registerFont",
-            payload: { family, style: style ?? null, bytes: face, scope: "document" }
-          });
+          const scoped = client.registerDocumentFont;
+          let reply;
+          if (typeof scoped === "function") {
+            try {
+              reply = await scoped.call(client, family, face, style ?? null);
+            } catch (err) {
+              return refuse3(err instanceof Error ? err.message : String(err));
+            }
+          } else {
+            reply = await client.send({
+              kind: "registerFont",
+              payload: { family, style: style ?? null, bytes: Array.from(face), scope: "document" }
+            });
+          }
           if (reply.kind !== "fontRegistered") {
             return refuse3(`the engine answered ${reply.kind}`);
           }
@@ -17158,6 +17170,9 @@ function createBundleHost(getEditor, manifest, options) {
       featureSet.add("rendering.sceneLayer.binary@1");
     }
   }
+  if (typeof getEditor().client?.registerDocumentFont === "function") {
+    featureSet.add("assets.documentFont@2");
+  }
   if (typeof getEditor().mutateWithBytes === "function") {
     featureSet.add("document.mutateBinary@1");
   }
@@ -17651,6 +17666,46 @@ function makeEngineEditor(worker, recorder, onToolPreview, onToolPreviews, overl
     const raw = worker.handleMessage(envelope);
     return JSON.parse(raw);
   };
+  const registry = [];
+  let openDocId = null;
+  const documentScope = (payload) => (payload?.scope ?? "document") === "document";
+  const registerFace = (face) => {
+    const reply = dispatch("registerFont", {
+      family: face.family,
+      style: face.style,
+      bytes: face.bytes,
+      scope: "document"
+    });
+    if (reply.kind !== "fontRegistered") return false;
+    registry.push(face);
+    return true;
+  };
+  const note = (kind, payload, reply) => {
+    if (kind === "registerFont" && reply.kind === "fontRegistered" && documentScope(payload)) {
+      const p = payload;
+      registry.push({ family: p.family, style: p.style ?? null, bytes: p.bytes, owner: null });
+    } else if (kind === "clearFontRegistry" && reply.kind === "fontRegistryCleared" && documentScope(payload)) {
+      registry.length = 0;
+    }
+  };
+  const loads = {
+    begin() {
+      const dropped = registry.filter((f) => f.owner !== null);
+      if (dropped.length === 0) return dropped;
+      const keep = registry.filter((f) => f.owner === null);
+      registry.length = 0;
+      dispatch("clearFontRegistry");
+      for (const face of keep) registerFace(face);
+      return dropped;
+    },
+    end(reply, dropped) {
+      if (reply.kind === "documentLoaded") {
+        openDocId = reply.payload.docId;
+        return;
+      }
+      for (const face of dropped) registerFace(face);
+    }
+  };
   const recordingRegistry = (kind) => ({
     register(contribution) {
       const entry = {
@@ -17742,13 +17797,27 @@ function makeEngineEditor(worker, recorder, onToolPreview, onToolPreviews, overl
     },
     async send(message) {
       const m = message;
+      if (m.kind === "loadDocument" || m.kind === "newBlankDocument") {
+        const dropped = loads.begin();
+        const loaded = dispatch(m.kind, m.payload);
+        loads.end(loaded, dropped);
+        return loaded;
+      }
       const reply = dispatch(m.kind, m.payload);
+      note(m.kind, m.payload, reply);
       if (documentChangeOf(reply) !== null) fanOut(reply);
       return reply;
     },
     subscribe(listener) {
       listeners.add(listener);
       return () => listeners.delete(listener);
+    },
+    async registerDocumentFont(family, bytes, style) {
+      if (openDocId === null) throw new Error("no document is open to give the face to");
+      const face = { family, style, bytes: Array.from(bytes), owner: openDocId };
+      const reply = dispatch("registerFont", { family, style, bytes: face.bytes, scope: "document" });
+      if (reply.kind === "fontRegistered") registry.push(face);
+      return reply;
     }
   };
   const editor = {
@@ -17824,7 +17893,7 @@ function makeEngineEditor(worker, recorder, onToolPreview, onToolPreviews, overl
       }
     };
   }
-  return { editor, fanOut };
+  return { editor, fanOut, loads };
 }
 async function createHeadlessHost(options = {}) {
   const engine = await loadHeadlessEngine(options);
@@ -17833,7 +17902,7 @@ async function createHeadlessHost(options = {}) {
   let lastPreview = null;
   let lastPreviews = null;
   const overlayLayerMap = /* @__PURE__ */ new Map();
-  const { editor, fanOut } = makeEngineEditor(
+  const { editor, fanOut, loads } = makeEngineEditor(
     worker,
     contributions,
     (value) => {
@@ -17846,9 +17915,11 @@ async function createHeadlessHost(options = {}) {
     options.engineShaper === true
   );
   const loadDirect = (bytes) => {
+    const dropped = loads.begin();
     const reply = JSON.parse(
       options.defaultFont ? worker.loadDocumentDirect(seqCounter++, bytes, options.defaultFont) : worker.loadDocumentDirect(seqCounter++, bytes)
     );
+    loads.end(reply, dropped);
     if (reply.kind === "documentLoaded") {
       try {
         worker.runResolveJson();

package/package.json

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