@poe-platform/safe-bash 0.1.761 → 0.1.763

package/dist/safe-bash-command-wkhtmltopdf/index.js

@@ -11606,14 +11606,18 @@ function evaluateContentStreamToDisplayList(params) {
   const paths = [];
   const images = [];
   const operations = [];
+  let capturedOperations;
+  let insideSoftMask = false;
   const emit = (operation) => {
-    const { clipPaths, clipImages } = curState();
-    if (clipPaths || clipImages) operation = { ...operation, value: {
+    const { clipPaths, clipImages, softMask } = curState();
+    if (clipPaths || clipImages || softMask) operation = { ...operation, value: {
       ...operation.value,
       ...clipPaths ? { clipPaths } : {},
-      ...clipImages ? { clipImages } : {}
+      ...clipImages ? { clipImages } : {},
+      ...softMask ? { softMask } : {}
     } };
-    operations.push(operation);
+    (capturedOperations ?? operations).push(operation);
+    if (insideSoftMask) return;
     switch (operation.kind) {
       case "path":
         paths.push(operation.value);
@@ -11719,7 +11723,7 @@ function evaluateContentStreamToDisplayList(params) {
     );
     return { r: kClamp(r), g: kClamp(g), b: kClamp(b) };
   };
-  const applyStateOperator = (st, operator, ops, activeResources) => {
+  const applyStateOperator = (st, operator, ops, activeResources, activeFonts, depth) => {
     const num = (i, fb = 0) => ops[i]?.kind === "number" ? ops[i].value : fb;
     if (operator === "cm") {
       const m = [num(0, 1), num(1, 0), num(2, 0), num(3, 1), num(4, 0), num(5, 0)];
@@ -11802,6 +11806,46 @@ function evaluateContentStreamToDisplayList(params) {
       const extDict = params.cosDoc.resolveDict(dictGet(activeResources, "ExtGState"));
       const gsDict = extDict ? params.cosDoc.resolveDict(dictGet(extDict, ops[0].decoded)) : void 0;
       if (gsDict) {
+        const mask = params.cosDoc.resolve(dictGet(gsDict, "SMask"));
+        if (mask?.kind === "name" && mask.decoded === "None") {
+          st.softMask = void 0;
+        } else if (mask?.kind === "dict") {
+          const subtype = params.cosDoc.resolve(dictGet(mask, "S"));
+          const form = params.cosDoc.resolve(dictGet(mask, "G"));
+          if (form?.kind === "stream" && subtype?.kind === "name" && (subtype.decoded === "Alpha" || subtype.decoded === "Luminosity")) {
+            if (depth >= 8) throw new PdfError("E_LIMIT", "Soft-mask nesting exceeds the form depth limit");
+            const parentOperations = capturedOperations;
+            const parentInsideSoftMask = insideSoftMask;
+            const savedTextState = { pendingTextClip, hasTextClip, activeTm, activeTlm };
+            const captured = [];
+            capturedOperations = captured;
+            insideSoftMask = true;
+            const maskState = { ...st, softMask: void 0, fillAlpha: 1, strokeAlpha: 1, blendMode: "Normal" };
+            delete maskState.clipPaths;
+            delete maskState.clipImages;
+            delete maskState.clipRect;
+            stateStack.push(maskState);
+            try {
+              paintForm(form, activeResources, activeFonts, depth, void 0, void 0, true);
+            } finally {
+              stateStack.pop();
+              capturedOperations = parentOperations;
+              insideSoftMask = parentInsideSoftMask;
+              ({ pendingTextClip, hasTextClip, activeTm, activeTlm } = savedTextState);
+            }
+            const group = params.cosDoc.resolveDict(dictGet(form.dict, "Group"));
+            const colorSpace = group ? dictGet(group, "CS") : void 0;
+            const bc = params.cosDoc.resolveArray(dictGet(mask, "BC"));
+            const components = bc?.items.map((item) => {
+              const value = params.cosDoc.resolve(item);
+              return value?.kind === "number" ? value.value : 0;
+            });
+            const [r, g, b] = components ? convertColorSpaceComponentsToRgb(params.cosDoc, colorSpace, "DeviceRGB", components, activeResources) : [0, 0, 0];
+            const transfer = params.cosDoc.resolve(dictGet(mask, "TR"));
+            const transferMap = transfer?.kind === "dict" || transfer?.kind === "stream" ? Uint8Array.from({ length: 256 }, (_, i) => Math.floor(kClamp(Math.fround(evalShadingFunctionToComponents(params.cosDoc, transfer, Math.fround(i / 255))[0] ?? 0)) * 255)) : void 0;
+            st.softMask = { subtype: subtype.decoded, operations: captured, backdrop: { r, g, b }, transferMap };
+          }
+        }
         const bmNode = params.cosDoc.resolve(dictGet(gsDict, "BM"));
         if (bmNode?.kind === "name") {
           st.blendMode = bmNode.decoded === "Compatible" ? "Normal" : bmNode.decoded;
@@ -11888,6 +11932,84 @@ function evaluateContentStreamToDisplayList(params) {
     ] }], void 0, void 0, resources, activeFonts, depth);
     stateStack.pop();
   };
+  const paintForm = (form, activeResources, activeFonts, depth, mcid, actualText, maskGroup = false) => {
+    const st = curState();
+    const group = params.cosDoc.resolveDict(dictGet(form.dict, "Group"));
+    const groupType = group ? params.cosDoc.resolve(dictGet(group, "S")) : void 0;
+    const isolated = group ? params.cosDoc.resolve(dictGet(group, "I")) : void 0;
+    const isolate = !maskGroup && groupType?.kind === "name" && groupType.decoded === "Transparency" && isolated?.kind === "boolean" && isolated.value;
+    const formStreamBytes = params.cosDoc.decodeStream(form);
+    const formNodes = parseContentStream(formStreamBytes);
+    const formResDict = params.cosDoc.resolveDict(dictGet(form.dict, "Resources")) ?? activeResources;
+    const formFonts = new Map(activeFonts);
+    for (const [k, v] of resolvePageFonts(params.cosDoc, formResDict).entries()) {
+      formFonts.set(k, v);
+    }
+    let nextCtm = [...st.ctm];
+    const matArr = params.cosDoc.resolveArray(dictGet(form.dict, "Matrix"));
+    if (matArr && matArr.items.length >= 6) {
+      const mn = (idx, fb = 0) => {
+        const resolved = params.cosDoc.resolve(matArr.items[idx]);
+        return resolved?.kind === "number" ? resolved.value : fb;
+      };
+      const formMat = [mn(0, 1), mn(1, 0), mn(2, 0), mn(3, 1), mn(4, 0), mn(5, 0)];
+      nextCtm = multiplyMatrices(formMat, nextCtm);
+    }
+    let nextClip = !isolate && st.clipRect ? [...st.clipRect] : void 0;
+    let nextClipPaths = isolate ? void 0 : st.clipPaths;
+    const bboxArr = params.cosDoc.resolveArray(dictGet(form.dict, "BBox"));
+    if (bboxArr && bboxArr.items.length >= 4) {
+      const bn = (idx, fb = 0) => {
+        const resolved = params.cosDoc.resolve(bboxArr.items[idx]);
+        return resolved?.kind === "number" ? resolved.value : fb;
+      };
+      const bx0 = bn(0, 0), by0 = bn(1, 0), bx1 = bn(2, 0), by1 = bn(3, 0);
+      const pts = [
+        transformPoint(nextCtm, bx0, by0),
+        transformPoint(nextCtm, bx1, by0),
+        transformPoint(nextCtm, bx1, by1),
+        transformPoint(nextCtm, bx0, by1)
+      ];
+      nextClipPaths = [...nextClipPaths ?? [], [
+        ...pts.map(([x, y], index) => ({ kind: index === 0 ? "move" : "line", x, y })),
+        { kind: "close" }
+      ]];
+      const fMinX = Math.min(...pts.map((p) => p[0]));
+      const fMinY = Math.min(...pts.map((p) => p[1]));
+      const fMaxX = Math.max(...pts.map((p) => p[0]));
+      const fMaxY = Math.max(...pts.map((p) => p[1]));
+      if (fMaxX > fMinX && fMaxY > fMinY) {
+        nextClip = nextClip ? [
+          Math.max(nextClip[0], fMinX),
+          Math.max(nextClip[1], fMinY),
+          Math.min(nextClip[2], fMaxX),
+          Math.min(nextClip[3], fMaxY)
+        ] : [fMinX, fMinY, fMaxX, fMaxY];
+      }
+    }
+    const parentOperations = capturedOperations;
+    const children = [];
+    const nextState = { ...st, ctm: nextCtm };
+    if (isolate) {
+      capturedOperations = children;
+      nextState.fillAlpha = nextState.strokeAlpha = 1;
+      nextState.blendMode = "Normal";
+      nextState.softMask = void 0;
+      delete nextState.clipImages;
+      delete nextState.clipPaths;
+      delete nextState.clipRect;
+    }
+    if (nextClip) nextState.clipRect = nextClip;
+    if (nextClipPaths) nextState.clipPaths = nextClipPaths;
+    stateStack.push(nextState);
+    try {
+      walkNodes(formNodes, mcid, actualText, formResDict, formFonts, depth + 1);
+    } finally {
+      stateStack.pop();
+      capturedOperations = parentOperations;
+    }
+    if (isolate) emit({ kind: "group", value: { operations: children, alpha: st.fillAlpha, blendMode: st.blendMode, clipRect: st.clipRect } });
+  };
   const walkNodes = (nodes, mcid, actualText, activeResources = params.resourcesDict, activeFonts = fonts, depth = 0) => {
     for (const node of nodes) {
       switch (node.kind) {
@@ -11932,7 +12054,7 @@ function evaluateContentStreamToDisplayList(params) {
           break;
         }
         case "state-op": {
-          applyStateOperator(curState(), node.operator, node.operands, activeResources);
+          applyStateOperator(curState(), node.operator, node.operands, activeResources, activeFonts, depth);
           break;
         }
         case "path-op": {
@@ -12218,53 +12340,7 @@ function evaluateContentStreamToDisplayList(params) {
                   ...st.clipRect ? { clipRect: [...st.clipRect] } : {}
                 }, patternMask, activeResources, activeFonts, depth);
               } else if (sub === "Form" && depth < 8) {
-                const formStreamBytes = params.cosDoc.decodeStream(xobjNode);
-                const formNodes = parseContentStream(formStreamBytes);
-                const formResDict = params.cosDoc.resolveDict(dictGet(xobjNode.dict, "Resources")) ?? activeResources;
-                const formFonts = new Map(activeFonts);
-                for (const [k, v] of resolvePageFonts(params.cosDoc, formResDict).entries()) {
-                  formFonts.set(k, v);
-                }
-                let nextCtm = [...st.ctm];
-                const matArr = params.cosDoc.resolveArray(dictGet(xobjNode.dict, "Matrix"));
-                if (matArr && matArr.items.length >= 6) {
-                  const mn = (idx, fb = 0) => {
-                    const resolved = params.cosDoc.resolve(matArr.items[idx]);
-                    return resolved?.kind === "number" ? resolved.value : fb;
-                  };
-                  const formMat = [mn(0, 1), mn(1, 0), mn(2, 0), mn(3, 1), mn(4, 0), mn(5, 0)];
-                  nextCtm = multiplyMatrices(formMat, nextCtm);
-                }
-                let nextClip = st.clipRect ? [...st.clipRect] : void 0;
-                const bboxArr = params.cosDoc.resolveArray(dictGet(xobjNode.dict, "BBox"));
-                if (bboxArr && bboxArr.items.length >= 4) {
-                  const bn = (idx, fb = 0) => {
-                    const resolved = params.cosDoc.resolve(bboxArr.items[idx]);
-                    return resolved?.kind === "number" ? resolved.value : fb;
-                  };
-                  const bx0 = bn(0, 0), by0 = bn(1, 0), bx1 = bn(2, 0), by1 = bn(3, 0);
-                  const pts = [
-                    transformPoint(nextCtm, bx0, by0),
-                    transformPoint(nextCtm, bx1, by0),
-                    transformPoint(nextCtm, bx0, by1),
-                    transformPoint(nextCtm, bx1, by1)
-                  ];
-                  const fMinX = Math.min(...pts.map((p) => p[0]));
-                  const fMinY = Math.min(...pts.map((p) => p[1]));
-                  const fMaxX = Math.max(...pts.map((p) => p[0]));
-                  const fMaxY = Math.max(...pts.map((p) => p[1]));
-                  if (fMaxX > fMinX && fMaxY > fMinY) {
-                    nextClip = nextClip ? [
-                      Math.max(nextClip[0], fMinX),
-                      Math.max(nextClip[1], fMinY),
-                      Math.min(nextClip[2], fMaxX),
-                      Math.min(nextClip[3], fMaxY)
-                    ] : [fMinX, fMinY, fMaxX, fMaxY];
-                  }
-                }
-                stateStack.push({ ...st, ctm: nextCtm, ...nextClip ? { clipRect: nextClip } : {} });
-                walkNodes(formNodes, mcid, actualText, formResDict, formFonts, depth + 1);
-                if (stateStack.length > 1) stateStack.pop();
+                paintForm(xobjNode, activeResources, activeFonts, depth, mcid, actualText);
               }
             }
           }
@@ -12483,7 +12559,7 @@ function evaluateContentStreamToDisplayList(params) {
                 st.textRenderMode = cmd.mode;
                 break;
               case "state-op":
-                applyStateOperator(st, cmd.operator, cmd.operands, activeResources);
+                applyStateOperator(st, cmd.operator, cmd.operands, activeResources, activeFonts, depth);
                 break;
               case "show-text":
                 emitTokenBytes(cmd.token.bytes);
@@ -13961,6 +14037,47 @@ function flattenCubic(x1, y1, x2, y2, x3, y3, x4, y4) {
   points.push([x4, y4]);
   return points;
 }
+function sampleImageLinear(image, x, y, out) {
+  x = Math.max(0, Math.min(image.width - 1, x));
+  y = Math.max(0, Math.min(image.height - 1, y));
+  const x0 = Math.floor(x), y0 = Math.floor(y);
+  const fx = x - x0, fy = y - y0;
+  out.fill(0);
+  for (let j = 0; j < 2; j++) {
+    for (let i = 0; i < 2; i++) {
+      const offset = (Math.min(image.height - 1, y0 + j) * image.width + Math.min(image.width - 1, x0 + i)) * 4;
+      const alpha = image.data[offset + 3] * (i ? fx : 1 - fx) * (j ? fy : 1 - fy);
+      out[0] = out[0] + image.data[offset] * alpha;
+      out[1] = out[1] + image.data[offset + 1] * alpha;
+      out[2] = out[2] + image.data[offset + 2] * alpha;
+      out[3] = out[3] + alpha;
+    }
+  }
+  if (out[3] > 0) {
+    out[0] = out[0] / out[3];
+    out[1] = out[1] / out[3];
+    out[2] = out[2] / out[3];
+  }
+}
+function downscaleImage(image, widthScale, heightScale) {
+  const sample = new Float64Array(4);
+  while (widthScale > 2 && image.width > 1 || heightScale > 2 && image.height > 1) {
+    const width = widthScale > 2 ? Math.ceil(image.width / 2) : image.width;
+    const height = heightScale > 2 ? Math.ceil(image.height / 2) : image.height;
+    const data = new Uint8Array(width * height * 4);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        sampleImageLinear(image, (x + 0.5) * image.width / width - 0.5, (y + 0.5) * image.height / height - 0.5, sample);
+        const offset = (y * width + x) * 4;
+        for (let c = 0; c < 4; c++) data[offset + c] = Math.round(sample[c]);
+      }
+    }
+    widthScale /= image.width / width;
+    heightScale /= image.height / height;
+    image = { width, height, data };
+  }
+  return image;
+}
 function decodePng(pngBytes) {
   if (pngBytes.length < 24 || pngBytes[0] !== 137 || pngBytes[1] !== 80 || pngBytes[2] !== 78 || pngBytes[3] !== 71) {
     throw new Error("Invalid PNG signature");
@@ -14558,6 +14675,30 @@ function paintOperations(displayList) {
     ...displayList.glyphs.map((value) => ({ kind: "glyph", value }))
   ];
 }
+function renderSoftMask(mask, displayList, scale) {
+  const bitmap = renderDisplayListToBitmap({
+    ...displayList,
+    rotation: 0,
+    glyphs: [],
+    paths: [],
+    images: [],
+    operations: mask.operations
+  }, { scale, transparent: true });
+  const { data } = bitmap;
+  for (let i = 0; i < data.length; i += 4) {
+    let value = data[i + 3];
+    if (mask.subtype === "Luminosity") {
+      const alpha = value / 255;
+      const r = Math.round(data[i] * alpha + mask.backdrop.r * 255 * (1 - alpha));
+      const g = Math.round(data[i + 1] * alpha + mask.backdrop.g * 255 * (1 - alpha));
+      const b = Math.round(data[i + 2] * alpha + mask.backdrop.b * 255 * (1 - alpha));
+      value = Math.round(pdfLum(r, g, b));
+    }
+    data[i] = data[i + 1] = data[i + 2] = 0;
+    data[i + 3] = mask.transferMap?.[value] ?? value;
+  }
+  return bitmap;
+}
 function renderDisplayListToBitmap(displayList, options = {}) {
   const baseScale = options.scale ?? (options.dpi ? options.dpi / 72 : 1.5);
   const scaleX = options.dpiX !== void 0 ? options.dpiX / 72 : baseScale;
@@ -14581,10 +14722,28 @@ function renderDisplayListToBitmap(displayList, options = {}) {
   const aaTxt = options.antialiasText !== false;
   let cachedClips;
   let cachedClipMask;
+  let cachedSoftMask;
+  let cachedSoftMaskPixels;
   const imageClipMasks = /* @__PURE__ */ new Map();
   for (const original of paintOperations(displayList)) {
     if (original.kind === "glyph" && (original.value.renderMode === 3 || !original.value.outline && !original.value.unicode.trim())) continue;
-    const operation = original.kind === "glyph" ? { kind: "path", value: glyphPaint(original.value) } : original;
+    let operation = original.kind === "glyph" ? { kind: "path", value: glyphPaint(original.value) } : original;
+    if (operation.kind === "group") {
+      const group = operation.value;
+      const bitmap = renderDisplayListToBitmap({ ...displayList, rotation: 0, operations: group.operations }, { ...options, scale, dpiX: void 0, dpiY: void 0, cropRect: void 0, transparent: true });
+      for (let i = 3; i < bitmap.data.length; i += 4) bitmap.data[i] = Math.round(bitmap.data[i] * group.alpha);
+      operation = { kind: "image", value: {
+        name: "TransparencyGroup",
+        width: bitmap.width,
+        height: bitmap.height,
+        decodedRgba: bitmap.data,
+        matrix: [bitmap.width / scale, 0, 0, bitmap.height / scale, 0, displayList.height - bitmap.height / scale],
+        colorSpace: "DeviceRGB",
+        bitsPerComponent: 8,
+        blendMode: group.blendMode,
+        clipRect: group.clipRect
+      } };
+    }
     const clips = original.value.clipPaths;
     let clipMask = clips && clips === cachedClips ? cachedClipMask : void 0;
     if (clips && !clipMask) {
@@ -14598,6 +14757,19 @@ function renderDisplayListToBitmap(displayList, options = {}) {
       cachedClips = clips;
       cachedClipMask = clipMask;
     }
+    const softMask = original.value.softMask;
+    if (softMask) {
+      if (softMask !== cachedSoftMask) {
+        cachedSoftMaskPixels = renderSoftMask(softMask, displayList, scale).data;
+        cachedSoftMask = softMask;
+      }
+      if (clipMask) {
+        clipMask = clipMask.slice();
+        for (let i = 3; i < clipMask.length; i += 4) clipMask[i] = Math.round(clipMask[i] * cachedSoftMaskPixels[i] / 255);
+      } else {
+        clipMask = cachedSoftMaskPixels;
+      }
+    }
     const imageClips = original.value.clipImages;
     if (imageClips) {
       let imageMask = imageClipMasks.get(imageClips);
@@ -14701,6 +14873,17 @@ function renderDisplayListToBitmap(displayList, options = {}) {
       const maxPx = Math.min(width - 1, clipMaxPx, Math.ceil(Math.max(...cornersPx)) - 1);
       const minPy = Math.max(0, clipMinPy, Math.floor(Math.min(...cornersPy)));
       const maxPy = Math.min(height - 1, clipMaxPy, Math.ceil(Math.max(...cornersPy)) - 1);
+      if (minPx > maxPx || minPy > maxPy) continue;
+      const source = downscaleImage(
+        { width: img.width, height: img.height, data: img.decodedRgba },
+        Math.hypot(d, c) * img.width / Math.abs(det * scale),
+        Math.hypot(b, a) * img.height / Math.abs(det * scale)
+      );
+      const ax = a * scale / img.width, ay = b * scale / img.width;
+      const bx = c * scale / img.height, by = d * scale / img.height;
+      const s1 = ax * ax + ay * ay, s2 = bx * bx + by * by, cross = ax * bx + ay * by;
+      const smooth = Math.fround((s1 + s2 + Math.hypot(s1 - s2, 2 * cross)) / 2) <= 1;
+      const sample = new Float64Array(4);
       for (let py = minPy; py <= maxPy; py++) {
         const yPdf = displayList.height - (py + 0.5) / scale;
         if (img.clipRect && (yPdf < img.clipRect[1] || yPdf > img.clipRect[3])) continue;
@@ -14712,9 +14895,14 @@ function renderDisplayListToBitmap(displayList, options = {}) {
           const u = (d * dxPdf - c * dyPdf) / det;
           const v = (-b * dxPdf + a * dyPdf) / det;
           if (u < 0 || u > 1 || v < 0 || v > 1) continue;
-          const sx = Math.min(img.width - 1, Math.max(0, Math.floor(u * img.width)));
-          const sy = Math.min(img.height - 1, Math.max(0, Math.floor((1 - v) * img.height)));
-          const sIdx = (sy * img.width + sx) * 4;
+          if (smooth) {
+            sampleImageLinear(source, u * source.width - 0.5, (1 - v) * source.height - 0.5, sample);
+          } else {
+            const sx = Math.min(source.width - 1, Math.max(0, Math.floor(u * source.width)));
+            const sy = Math.min(source.height - 1, Math.max(0, Math.floor((1 - v) * source.height)));
+            const sIdx = (sy * source.width + sx) * 4;
+            for (let c2 = 0; c2 < 4; c2++) sample[c2] = source.data[sIdx + c2];
+          }
           blendPixel(
             rgba,
             width,
@@ -14722,11 +14910,11 @@ function renderDisplayListToBitmap(displayList, options = {}) {
             px,
             py,
             {
-              r: img.decodedRgba[sIdx] / 255,
-              g: img.decodedRgba[sIdx + 1] / 255,
-              b: img.decodedRgba[sIdx + 2] / 255
+              r: sample[0] / 255,
+              g: sample[1] / 255,
+              b: sample[2] / 255
             },
-            img.decodedRgba[sIdx + 3] / 255,
+            sample[3] / 255,
             img.blendMode,
             clipMask
           );
@@ -43344,3 +43532,8 @@ export {
  * Adapted from PDFium third_party/agg23/agg_curves.cpp, curve4_div.
  * See THIRD_PARTY_NOTICES.md for the pinned revision and adaptations.
  */
+/*!
+ * Staged image reduction adapted from Mozilla PDF.js CanvasGraphics._scaleImage.
+ * Copyright 2012 Mozilla Foundation. Licensed under Apache-2.0.
+ * See THIRD_PARTY_NOTICES.md for the source revision and adaptations.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-bash",
-  "version": "0.1.761",
+  "version": "0.1.763",
   "description": "Extensible virtual shell with pluggable filesystems and streaming commands",
   "type": "module",
   "license": "MIT",
@@ -841,7 +841,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.761",
+    "@poe-platform/safe-fs": "0.1.763",
     "pdf-lib": "1.17.1",
     "@noble/hashes": "2.4.0",
     "pako": "3.0.1",

package/third-party/pdf-ast/THIRD_PARTY_NOTICES.md

@@ -349,6 +349,29 @@ The source fixture and hashes are recorded in `src/fixtures/SOURCES.md`.
 The one-pixel gradient expectation is independently verified by Poppler and
 MuPDF; PDF.js's `paintSolidColorImageMask` optimization loses that pattern.
 
+`src/render/image-sampling.ts` adapts `CanvasGraphics._scaleImage` from the same
+pinned PDF.js revision (Copyright 2012 Mozilla Foundation, Apache-2.0). The
+successive half-size canvas draws use local bilinear sampling with premultiplied
+alpha; only the current reduction level is retained. Source-axis footprints
+come from the inverse image transform to preserve rotated anisotropic reductions.
+Final downscaling uses smoothing, as in `getImageSmoothingEnabled`, with one
+device pixel as the enlargement threshold. `image-downsampling.test.ts` adds
+memory-only stripe, alpha, transform, stencil, and save/reopen regressions;
+the unchanged upstream issue13372 fixture also covers reduced patterned masks.
+
+ExtGState soft-mask evaluation and rendering follow PDF.js `handleSMask`,
+`beginGroup`, `_prepareSMaskCanvas`, and `_bakeSMaskCanvas` at the same revision
+(Mozilla Foundation, Apache-2.0). The adapter captures page-coordinate mask
+paints, resets group alpha/blend/soft-mask state, converts the luminosity
+backdrop before filtering, and builds a 256-entry transfer table. Isolated
+Forms retain their own paint groups so outer opacity is applied once.
+Bitmap masks retain only the current prepared surface; SVG masks use the
+export resolution while isolated Form contents remain vector groups.
+`soft-mask.test.ts` ports four unchanged upstream equality fixtures, recorded
+in `src/fixtures/SOURCES.md`, and adds local alpha/transform/group tests plus
+the original issue17069 signature regression. Soft-mask evaluation is bounded
+by the existing eight-level Form limit; mask-only text is excluded from extraction.
+
 Malformed dictionary-key recovery follows PDF.js `Parser.getObj`, skipping
 stray non-Name tokens only in local repair mode. Damaged optional ToUnicode
 streams follow `PartialEvaluator.readToUnicode` error recovery while retaining