@paged-media/plugin-sdk 0.2.53-canary.0 → 0.2.55-canary.0

package/dist/index.js

@@ -393,6 +393,28 @@ async function planCoreDelete(a, swatchId, pageId, protocol) {
   }
 }
 
+// src/document-change.ts
+function documentChangeOf(msg) {
+  switch (msg.kind) {
+    case "mutationApplied": {
+      const reflow = msg.payload.reflow;
+      return {
+        kind: msg.kind,
+        pageIds: [...msg.payload.pageIds ?? []],
+        ...reflow ? { reflow: { frameId: reflow.frameId, contentBox: reflow.contentBox } } : {}
+      };
+    }
+    case "undoApplied":
+    case "redoApplied":
+    case "gestureCommitted":
+      return { kind: msg.kind, pageIds: [...msg.payload.pageIds ?? []] };
+    case "scriptResult":
+      return { kind: msg.kind, pageIds: [], pagesUnknown: true };
+    default:
+      return null;
+  }
+}
+
 // ../plugin-api/src/catalog.json
 var pathAliases = [
   {
@@ -11663,7 +11685,7 @@ function createCoreObjectsV70(getEditor) {
     subscribed = true;
     try {
       unsubscribe = client().subscribe((msg) => {
-        if (msg.kind === "mutationApplied" || msg.kind === "undoApplied" || msg.kind === "redoApplied" || msg.kind === "documentLoaded") {
+        if (documentChangeOf(msg) !== null || msg.kind === "documentLoaded") {
           generation++;
           for (const l of listeners) l();
         }
@@ -14165,6 +14187,12 @@ var HOST_FEATURES = [
   // needed — DESIGN.md §4.3d).
   "document.parentOf@1",
   "document.onDidChange@1",
+  // ADR 327 — `onDidChange` reports EVERY committed change: a canvas
+  // gesture's commit (`gestureCommitted`) and a script run (`scriptResult`,
+  // `pagesUnknown`) as well as mutations, undos and redos. STATIC: the
+  // editor's client hands every reply to its subscribers, and the headless
+  // harness does the same for these.
+  "document.onDidChange@2",
   // W-22 — the document-opened event. STATIC: it is the client's
   // `documentLoaded` broadcast filtered, and every host posts that on
   // every load (File ▸ Open, File ▸ New, a native-document open).
@@ -14188,6 +14216,11 @@ var HOST_FEATURES = [
   // like the channel's own `overlay.toolPreview@1`. The headless harness
   // records the shape verbatim.
   "overlay.text@1",
+  // ADR 328 — the document-face door. STATIC like `assets.images@1`: the
+  // engine's document registry answers it (protocol 70's `scope`), no
+  // injected source is involved, and the worker handshake refuses an engine
+  // older than the pin. Fill-only; a refusal comes back as an outcome.
+  "assets.documentFont@1",
   // C-5 / I-04 (core v42): the placed-image bytes read is engine-served
   // through the wire (no injected source), so it is unconditionally
   // implemented at the pinned canvas-wasm — unlike assets.fonts@1, which
@@ -14287,6 +14320,16 @@ function sceneFaceLedger(provider) {
   }
   return ledger;
 }
+var documentFaceQueues = /* @__PURE__ */ new WeakMap();
+function faceContainer(bytes) {
+  if (bytes.byteLength < 4) return null;
+  const magic = String.fromCharCode(bytes[0], bytes[1], bytes[2], bytes[3]);
+  if (magic === "\0
\0\0" || magic === "true" || magic === "OTTO" || magic === "ttcf") {
+    return "sfnt";
+  }
+  if (magic === "wOFF" || magic === "wOF2") return "woff";
+  return null;
+}
 var BLOB_BUDGETS = {
   /** Default per-plugin blob ceiling, in bytes (64 MiB). */
   defaultQuotaBytes: 64 * 1024 * 1024
@@ -15333,7 +15376,7 @@ function createBundleHost(getEditor, manifest, options) {
       if (!parentIndexWired) {
         parentIndexWired = true;
         const off = getEditor().client.subscribe((msg) => {
-          if (msg.kind === "mutationApplied" || msg.kind === "undoApplied" || msg.kind === "redoApplied" || // A newly opened document invalidates everything; the kind
+          if (documentChangeOf(msg) !== null || // A newly opened document invalidates everything; the kind
           // is matched defensively (not every host posts it).
           msg.kind === "documentLoaded") {
             parentIndex = null;
@@ -15425,14 +15468,8 @@ function createBundleHost(getEditor, manifest, options) {
     onDidChange(listener) {
       requireDocRead("document.onDidChange");
       const off = getEditor().client.subscribe((msg) => {
-        if (msg.kind === "mutationApplied" || msg.kind === "undoApplied" || msg.kind === "redoApplied") {
-          const reflow = msg.kind === "mutationApplied" ? msg.payload.reflow : void 0;
-          listener({
-            kind: msg.kind,
-            pageIds: msg.payload.pageIds,
-            ...reflow ? { reflow: { frameId: reflow.frameId, contentBox: reflow.contentBox } } : {}
-          });
-        }
+        const change = documentChangeOf(msg);
+        if (change) listener(change);
       });
       return store.add(toDisposable(off));
     },
@@ -15490,6 +15527,12 @@ function createBundleHost(getEditor, manifest, options) {
       const editor = getEditor();
       const applied = await editor.client.setElementSelection(ids, mode);
       editor.selection.setElementSelection(applied);
+      try {
+        editor.selection.setElementGeometry(
+          await editor.client.elementGeometry(applied)
+        );
+      } catch {
+      }
       return applied;
     },
     onDidChange(listener) {
@@ -16022,6 +16065,68 @@ function createBundleHost(getEditor, manifest, options) {
         })
       );
     },
+    // ADR 328 — a face for the DOCUMENT where it holds none. Engine-served
+    // 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.
+    async registerDocumentFont(bytes, family, style) {
+      requireDeclared(
+        hasAsset("fonts"),
+        "assets.registerDocumentFont",
+        'capabilities.assets must include "fonts"'
+      );
+      const label = `assets.registerDocumentFont("${family}"${style ? `, "${style}"` : ""})`;
+      const refuse3 = (reason) => {
+        log.warn(`${label} refused: ${reason}`);
+        return { status: "refused", reason };
+      };
+      const denied = denyWrite(hasDoc("write"), "assets.registerDocumentFont", "capabilities.document.write");
+      if (denied !== null) return refuse3(denied);
+      if (family.trim() === "") return refuse3("the family is empty");
+      if (bytes.byteLength > ASSET_BUDGETS.maxFontFaceBytes) {
+        return refuse3(
+          `${bytes.byteLength} bytes is over the ${ASSET_BUDGETS.maxFontFaceBytes}-byte per-face cap`
+        );
+      }
+      const container = faceContainer(bytes);
+      if (container !== "sfnt") {
+        return refuse3(
+          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);
+      let client;
+      try {
+        client = getEditor().client;
+      } catch (err) {
+        return refuse3(`no engine to give the face to (${String(err)})`);
+      }
+      const run = async () => {
+        try {
+          const held = await client.send({
+            kind: "requestFontFaceBytes",
+            payload: { family, style: style ?? null }
+          });
+          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" }
+          });
+          if (reply.kind !== "fontRegistered") {
+            return refuse3(`the engine answered ${reply.kind}`);
+          }
+          return { status: "registered", pageIds: [...reply.payload.pageIds ?? []] };
+        } catch (err) {
+          return refuse3(`the engine could not be reached (${String(err)})`);
+        }
+      };
+      const queued = (documentFaceQueues.get(client) ?? Promise.resolve()).then(run, run);
+      documentFaceQueues.set(client, queued);
+      return queued;
+    },
     // C-5 / I-04 (core v42): a placed DOCUMENT image's ORIGINAL bytes,
     // straight from the engine's resolver/parse cache through the
     // `requestPlacedAssetBytes` wire query — no injected source needed
@@ -17221,6 +17326,7 @@ function makeEngineEditor(worker, recorder, onToolPreview, onToolPreviews, overl
     async send(message) {
       const m = message;
       const reply = dispatch(m.kind, m.payload);
+      if (documentChangeOf(reply) !== null) fanOut(reply);
       return reply;
     },
     subscribe(listener) {

package/package.json

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