@workglow/tasks 0.2.19 → 0.2.21

package/dist/node.js

@@ -4,8 +4,8 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 // src/task/image/registerImageRasterCodec.node.ts
 import { registerImageRasterCodec } from "@workglow/util/media";
 
-// src/task/image/imageRasterCodecNode.ts
-import { parseDataUri } from "@workglow/util/media";
+// src/task/image/imageRasterCodec.server.ts
+import { decodeBufferToRaw, encodeRawPixels } from "@workglow/util/media";
 
 // src/task/image/imageCodecLimits.ts
 var MAX_DECODED_PIXELS = 1e8;
@@ -69,7 +69,13 @@ function normalizeOutputMimeType(mimeType) {
   throw new Error(`Image raster codec: unsupported output mime type "${mimeType}". ` + `Supported: ${SUPPORTED_OUTPUT_MIME_TYPES.join(", ")}.`);
 }
 
-// src/task/image/imageRasterCodecNode.ts
+// src/task/image/imageRasterCodec.server.ts
+function parseDataUri(dataUri) {
+  const match = dataUri.match(/^data:([^;]+);base64,(.+)$/);
+  if (!match)
+    throw new Error("Invalid base64 data URI");
+  return { mimeType: match[1], base64: match[2] };
+}
 function expandGrayAlphaToRgba(src, width, height) {
   const n = width * height;
   const dst = new Uint8ClampedArray(n * 4);
@@ -83,35 +89,20 @@ function expandGrayAlphaToRgba(src, width, height) {
   }
   return dst;
 }
-var _sharp;
-async function getSharp() {
-  if (!_sharp) {
-    try {
-      _sharp = (await import("sharp")).default;
-    } catch {
-      throw new Error("The Node/Bun image raster codec requires the optional 'sharp' package. Install it with: npm install sharp  (or bun add sharp)");
-    }
-  }
-  return _sharp;
-}
 async function decodeDataUri(dataUri) {
   assertIsDataUri(dataUri);
   const declaredMime = extractDataUriMimeType(dataUri);
   if (declaredMime && REJECTED_DECODE_MIME_TYPES.has(declaredMime)) {
-    throw new Error(`Image raster codec: refusing to rasterize "${declaredMime}". Vector and animated formats lose information when converted to pixels. Convert to PNG, JPEG, or WebP before passing to the codec.`);
+    throw new Error(`Image raster codec: refusing to rasterize "${declaredMime}". ` + `Vector and animated formats lose information when converted to pixels. ` + `Convert to PNG, JPEG, or WebP before passing to the codec.`);
   }
-  const sharp = await getSharp();
   const { base64 } = parseDataUri(dataUri);
   const estimatedBytes = Math.ceil(base64.length * 3 / 4);
   assertWithinByteBudget(estimatedBytes, MAX_INPUT_BYTES_NODE);
   const buffer = Buffer.from(base64, "base64");
-  const { data, info } = await sharp(buffer, {
+  const { data, width, height, channels: ch } = await decodeBufferToRaw(buffer, {
     limitInputPixels: MAX_DECODED_PIXELS,
     sequentialRead: true
-  }).raw().toBuffer({ resolveWithObject: true });
-  const width = info.width;
-  const height = info.height;
-  const ch = info.channels;
+  });
   assertWithinPixelBudget(width, height);
   if (ch === 2) {
     return {
@@ -132,11 +123,9 @@ async function decodeDataUri(dataUri) {
   throw new Error(`Unsupported decoded channel count: ${ch}`);
 }
 async function encodeDataUri(image, mimeType) {
-  const sharp = await getSharp();
   const { data, width, height, channels } = image;
   const fmt = normalizeOutputMimeType(mimeType);
-  const base = sharp(Buffer.from(data), { raw: { width, height, channels } });
-  const out = fmt === "image/jpeg" ? await base.jpeg({ quality: 92, mozjpeg: true }).toBuffer() : fmt === "image/webp" ? await base.webp({ quality: 92 }).toBuffer() : await base.png({ compressionLevel: 6 }).toBuffer();
+  const out = fmt === "image/jpeg" ? await encodeRawPixels({ data, width, height, channels }, { format: "jpeg", quality: 92, mozjpeg: true }) : fmt === "image/webp" ? await encodeRawPixels({ data, width, height, channels }, { format: "webp", quality: 92 }) : await encodeRawPixels({ data, width, height, channels }, { format: "png", compressionLevel: 6 });
   return `data:${fmt};base64,${out.toString("base64")}`;
 }
 function createNodeImageRasterCodec() {
@@ -188,7 +177,7 @@ function cpuBoxBlur(bin, radius) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp("cpu", "blur", (image, { radius }) => {
-  return CpuImage.fromImageBinary(cpuBoxBlur(image.getBinary(), Math.max(1, radius | 0)));
+  return CpuImage.fromRaw(cpuBoxBlur(image.getBinary(), Math.max(1, radius | 0)));
 });
 
 // src/task/image/border/border.cpu.ts
@@ -224,7 +213,7 @@ function cpuBorder(bin, borderWidth, color) {
   return { data: dst, width: dstW, height: dstH, channels: outCh };
 }
 registerFilterOp2("cpu", "border", (image, { borderWidth, color }) => {
-  return CpuImage2.fromImageBinary(cpuBorder(image.getBinary(), borderWidth, color));
+  return CpuImage2.fromRaw(cpuBorder(image.getBinary(), borderWidth, color));
 });
 
 // src/task/image/brightness/brightness.cpu.ts
@@ -247,7 +236,7 @@ function cpuBrightness(bin, amount) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp3("cpu", "brightness", (image, { amount }) => {
-  return CpuImage3.fromImageBinary(cpuBrightness(image.getBinary(), amount));
+  return CpuImage3.fromRaw(cpuBrightness(image.getBinary(), amount));
 });
 
 // src/task/image/contrast/contrast.cpu.ts
@@ -275,7 +264,7 @@ function cpuContrast(bin, amount) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp4("cpu", "contrast", (image, { amount }) => {
-  return CpuImage4.fromImageBinary(cpuContrast(image.getBinary(), amount));
+  return CpuImage4.fromRaw(cpuContrast(image.getBinary(), amount));
 });
 
 // src/task/image/crop/crop.cpu.ts
@@ -300,7 +289,7 @@ function cpuCrop(bin, left, top, width, height) {
   return { data: dst, width: w, height: h, channels };
 }
 registerFilterOp5("cpu", "crop", (image, { left, top, width, height }) => {
-  return CpuImage5.fromImageBinary(cpuCrop(image.getBinary(), left, top, width, height));
+  return CpuImage5.fromRaw(cpuCrop(image.getBinary(), left, top, width, height));
 });
 
 // src/task/image/flip/flip.cpu.ts
@@ -329,7 +318,7 @@ function cpuFlip(bin, direction) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp6("cpu", "flip", (image, { direction }) => {
-  return CpuImage6.fromImageBinary(cpuFlip(image.getBinary(), direction));
+  return CpuImage6.fromRaw(cpuFlip(image.getBinary(), direction));
 });
 
 // src/task/image/grayscale/grayscale.cpu.ts
@@ -356,7 +345,7 @@ function cpuGrayscale(bin) {
   return { data: dst, width, height, channels: 4 };
 }
 registerFilterOp7("cpu", "grayscale", (image, _params) => {
-  return CpuImage7.fromImageBinary(cpuGrayscale(image.getBinary()));
+  return CpuImage7.fromRaw(cpuGrayscale(image.getBinary()));
 });
 
 // src/task/image/invert/invert.cpu.ts
@@ -379,7 +368,7 @@ function cpuInvert(bin) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp8("cpu", "invert", (image, _params) => {
-  return CpuImage8.fromImageBinary(cpuInvert(image.getBinary()));
+  return CpuImage8.fromRaw(cpuInvert(image.getBinary()));
 });
 
 // src/task/image/pixelate/pixelate.cpu.ts
@@ -415,7 +404,7 @@ function cpuPixelate(bin, blockSize) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp9("cpu", "pixelate", (image, { blockSize }) => {
-  return CpuImage9.fromImageBinary(cpuPixelate(image.getBinary(), blockSize));
+  return CpuImage9.fromRaw(cpuPixelate(image.getBinary(), blockSize));
 });
 
 // src/task/image/posterize/posterize.cpu.ts
@@ -443,7 +432,7 @@ function cpuPosterize(bin, levels) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp10("cpu", "posterize", (image, { levels }) => {
-  return CpuImage10.fromImageBinary(cpuPosterize(image.getBinary(), levels));
+  return CpuImage10.fromRaw(cpuPosterize(image.getBinary(), levels));
 });
 
 // src/task/image/resize/resize.cpu.ts
@@ -465,7 +454,7 @@ function cpuResize(bin, dstW, dstH) {
   return { data: dst, width: dstW, height: dstH, channels };
 }
 registerFilterOp11("cpu", "resize", (image, { width, height }) => {
-  return CpuImage11.fromImageBinary(cpuResize(image.getBinary(), width, height));
+  return CpuImage11.fromRaw(cpuResize(image.getBinary(), width, height));
 });
 
 // src/task/image/rotate/rotate.cpu.ts
@@ -499,7 +488,7 @@ function cpuRotate(bin, angle) {
   return { data: dst, width: dstW, height: dstH, channels };
 }
 registerFilterOp12("cpu", "rotate", (image, { angle }) => {
-  return CpuImage12.fromImageBinary(cpuRotate(image.getBinary(), angle));
+  return CpuImage12.fromRaw(cpuRotate(image.getBinary(), angle));
 });
 
 // src/task/image/sepia/sepia.cpu.ts
@@ -528,7 +517,7 @@ function cpuSepia(bin) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp13("cpu", "sepia", (image, _params) => {
-  return CpuImage13.fromImageBinary(cpuSepia(image.getBinary()));
+  return CpuImage13.fromRaw(cpuSepia(image.getBinary()));
 });
 
 // src/task/image/threshold/threshold.cpu.ts
@@ -553,7 +542,7 @@ function cpuThreshold(bin, value) {
   return { data: dst, width, height, channels };
 }
 registerFilterOp14("cpu", "threshold", (image, { value }) => {
-  return CpuImage14.fromImageBinary(cpuThreshold(image.getBinary(), value));
+  return CpuImage14.fromRaw(cpuThreshold(image.getBinary(), value));
 });
 
 // src/task/image/tint/tint.cpu.ts
@@ -593,7 +582,7 @@ function cpuTint(bin, tr, tg, tb, amount) {
 }
 registerFilterOp15("cpu", "tint", (image, { color, amount }) => {
   const { r: tr, g: tg, b: tb } = resolveColor2(color);
-  return CpuImage15.fromImageBinary(cpuTint(image.getBinary(), tr, tg, tb, amount));
+  return CpuImage15.fromRaw(cpuTint(image.getBinary(), tr, tg, tb, amount));
 });
 
 // src/task/image/transparency/transparency.cpu.ts
@@ -615,7 +604,7 @@ function cpuTransparency(bin, amount) {
   return { data: dst, width, height, channels: 4 };
 }
 registerFilterOp16("cpu", "transparency", (image, { amount }) => {
-  return CpuImage16.fromImageBinary(cpuTransparency(image.getBinary(), amount));
+  return CpuImage16.fromRaw(cpuTransparency(image.getBinary(), amount));
 });
 
 // src/task/image/blur/blur.sharp.ts
@@ -736,14 +725,32 @@ registerFilterOp29("sharp", "threshold", (image, { value }) => {
 
 // src/task/image/tint/tint.sharp.ts
 import { registerFilterOp as registerFilterOp30, resolveColor as resolveColor4 } from "@workglow/util/media";
-registerFilterOp30("sharp", "tint", (image, { color }) => {
+registerFilterOp30("sharp", "tint", (image, { color, amount }) => {
   const { r, g, b } = resolveColor4(color);
-  return image.apply((p) => p.tint({ r, g, b }));
+  const a = 1 - amount;
+  const offR = r * amount;
+  const offG = g * amount;
+  const offB = b * amount;
+  return image.apply((p) => p.linear([a, a, a], [offR, offG, offB]));
 });
 
 // src/codec.node.ts
-import { applyFilter, registerPreviewResizeFn } from "@workglow/util/media";
-registerPreviewResizeFn((image, width, height) => applyFilter(image, "resize", { width, height }));
+import {
+  GpuImageFactory,
+  applyFilter,
+  registerPreviewResizeFn
+} from "@workglow/util/media";
+registerPreviewResizeFn(async (value, width, height) => {
+  const gpu = await GpuImageFactory.from(value);
+  try {
+    const out = applyFilter(gpu, "resize", { width, height });
+    gpu.dispose();
+    return await out.toImageValue(value.previewScale);
+  } catch (err) {
+    gpu.dispose();
+    throw err;
+  }
+});
 
 // src/task/image/imageTextRender.ts
 import { createServiceToken, globalServiceRegistry } from "@workglow/util";
@@ -792,6 +799,7 @@ async function renderImageTextToRgba(params) {
 }
 
 // src/task/image/imageTextRender.server.ts
+import { decodeBufferToRaw as decodeBufferToRaw2 } from "@workglow/util/media";
 function buildTextSvg(params) {
   const { width, height, text, font, fontSize, bold, italic, color, position } = params;
   const lines = escapeImageTextXmlText(text).split(`
@@ -820,25 +828,20 @@ function buildTextSvg(params) {
 function createServerImageTextRenderer() {
   return {
     async renderToRgba(params) {
-      let sharp;
-      try {
-        sharp = (await import("sharp")).default;
-      } catch {
-        throw new Error("ImageTextTask: rendering text on this runtime requires the optional 'sharp' package (install with: bun add sharp)");
-      }
       const svg = buildTextSvg(params);
       const buffer = Buffer.from(svg, "utf8");
-      const { data, info } = await sharp(buffer, {
+      const { data, width, height, channels } = await decodeBufferToRaw2(buffer, {
         limitInputPixels: MAX_DECODED_PIXELS,
-        sequentialRead: true
-      }).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
-      if (info.channels !== 4) {
-        throw new Error(`ImageTextTask: expected RGBA from sharp, got ${info.channels} channels`);
+        sequentialRead: true,
+        ensureAlpha: true
+      });
+      if (channels !== 4) {
+        throw new Error(`ImageTextTask: expected RGBA from sharp, got ${channels} channels`);
       }
       return {
         data: new Uint8ClampedArray(data),
-        width: info.width,
-        height: info.height,
+        width,
+        height,
         channels: 4
       };
     }
@@ -6486,88 +6489,53 @@ import {
 } from "@workglow/util/media";
 
 // src/task/image/ImageFilterTask.ts
-import {
-  Task as Task42
-} from "@workglow/task-graph";
-import {
-  applyFilter as applyFilter2,
-  CpuImage as CpuImage17,
-  GpuImageFactory,
-  getGpuImageFactory,
-  hasFilterOp,
-  previewSource
-} from "@workglow/util/media";
+import { Task as Task42 } from "@workglow/task-graph";
+import { applyFilter as applyFilter2, CpuImage as CpuImage17, GpuImageFactory as GpuImageFactory2, hasFilterOp } from "@workglow/util/media";
 
 class ImageFilterTask extends Task42 {
   scalePreviewParams(params, _scale) {
     return params;
   }
-  async hydrateInput(image) {
-    if (image !== null && typeof image === "object" && "backend" in image && "retain" in image && "release" in image && "materialize" in image) {
-      return image;
-    }
-    if (typeof image === "string" && image.startsWith("data:")) {
-      return GpuImageFactory.fromDataUri(image);
-    }
-    if (typeof Blob !== "undefined" && image instanceof Blob) {
-      return GpuImageFactory.fromBlob(image);
-    }
-    if (typeof ImageBitmap !== "undefined" && image instanceof ImageBitmap) {
-      const fromImageBitmap = getGpuImageFactory("fromImageBitmap");
-      if (!fromImageBitmap) {
-        throw new Error("ImageFilterTask: received ImageBitmap but GpuImage.fromImageBitmap is not registered " + "in this runtime. ImageBitmap inputs require the browser entry point.");
+  async runFilter(input) {
+    const previewScale = input.image.previewScale;
+    let gpu = await GpuImageFactory2.from(input.image);
+    try {
+      if (!hasFilterOp(gpu.backend, this.filterName)) {
+        const cpu = await CpuImage17.from(input.image);
+        gpu.dispose();
+        gpu = cpu;
       }
-      return fromImageBitmap(image);
-    }
-    if (image !== null && typeof image === "object" && "data" in image && "width" in image && "height" in image && "channels" in image) {
-      const bin = image;
-      const asyncFactory = getGpuImageFactory("fromImageBinaryAsync");
-      if (asyncFactory)
-        return asyncFactory(bin);
-      return GpuImageFactory.fromImageBinary(bin);
-    }
-    const ctor = image && typeof image === "object" && image.constructor ? image.constructor.name : typeof image;
-    const keys = image && typeof image === "object" ? Object.keys(image).slice(0, 10).join(", ") : "";
-    throw new Error(`ImageFilterTask: input.image is not a recognized image shape (got ${ctor}` + (keys ? ` with keys [${keys}]` : "") + `). Expected one of: GpuImage instance, raw ImageBinary, Blob, ImageBitmap, ` + `or a data: URI string.`);
-  }
-  async execute(input, ctx) {
-    let inputImage = await this.hydrateInput(input.image);
-    if (!hasFilterOp(inputImage.backend, this.filterName)) {
-      const bin = await inputImage.materialize();
-      const cpu = CpuImage17.fromImageBinary(bin, inputImage.previewScale);
-      inputImage.release();
-      inputImage = cpu;
-    }
-    const params = this.scalePreviewParams(this.opParams(input), inputImage.previewScale);
-    const out = applyFilter2(inputImage, this.filterName, params);
-    inputImage.release();
-    ctx.resourceScope?.register(`gpuimage:${String(this.id)}:image`, async () => out.release());
-    return { image: out };
+      const params = this.scalePreviewParams(this.opParams(input), previewScale);
+      const out = applyFilter2(gpu, this.filterName, params);
+      gpu.dispose();
+      try {
+        const value = await out.toImageValue(previewScale);
+        return { image: value };
+      } catch (err) {
+        try {
+          out.dispose();
+        } catch {}
+        throw err;
+      }
+    } catch (err) {
+      gpu.dispose();
+      throw err;
+    }
+  }
+  async execute(input, _ctx) {
+    return this.runFilter(input);
   }
   async executePreview(input, _ctx) {
-    const inputImage = await this.hydrateInput(input.image);
-    let sourced = previewSource(inputImage);
-    if (!hasFilterOp(sourced.backend, this.filterName)) {
-      const bin = await sourced.materialize();
-      const cpu = CpuImage17.fromImageBinary(bin, sourced.previewScale);
-      if (sourced !== inputImage)
-        sourced.release();
-      sourced = cpu;
-    }
-    const params = this.scalePreviewParams(this.opParams(input), sourced.previewScale);
-    const out = applyFilter2(sourced, this.filterName, params);
-    if (sourced !== inputImage)
-      sourced.release();
-    return { image: out };
+    return this.runFilter(input);
   }
 }
 // src/task/image/blur/ImageBlurTask.ts
 import { CreateWorkflow as CreateWorkflow16, Workflow as Workflow17 } from "@workglow/task-graph";
-import { GpuImageSchema } from "@workglow/util/media";
+import { ImageValueSchema } from "@workglow/util/media";
 var inputSchema41 = {
   type: "object",
   properties: {
-    image: GpuImageSchema({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema({ title: "Image", description: "Source image" }),
     radius: {
       type: "number",
       title: "Radius",
@@ -6582,7 +6550,7 @@ var inputSchema41 = {
 };
 var outputSchema40 = {
   type: "object",
-  properties: { image: GpuImageSchema({ title: "Image", description: "Blurred image" }) },
+  properties: { image: ImageValueSchema({ title: "Image", description: "Blurred image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6609,11 +6577,11 @@ class ImageBlurTask extends ImageFilterTask {
 Workflow17.prototype.imageBlur = CreateWorkflow16(ImageBlurTask);
 // src/task/image/border/ImageBorderTask.ts
 import { CreateWorkflow as CreateWorkflow17, Workflow as Workflow18 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema2 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema2 } from "@workglow/util/media";
 var inputSchema42 = {
   type: "object",
   properties: {
-    image: GpuImageSchema2({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema2({ title: "Image", description: "Source image" }),
     borderWidth: {
       type: "integer",
       title: "Border Width",
@@ -6646,7 +6614,7 @@ var inputSchema42 = {
 };
 var outputSchema41 = {
   type: "object",
-  properties: { image: GpuImageSchema2({ title: "Image", description: "Image with border" }) },
+  properties: { image: ImageValueSchema2({ title: "Image", description: "Image with border" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6676,11 +6644,11 @@ class ImageBorderTask extends ImageFilterTask {
 Workflow18.prototype.imageBorder = CreateWorkflow17(ImageBorderTask);
 // src/task/image/brightness/ImageBrightnessTask.ts
 import { CreateWorkflow as CreateWorkflow18, Workflow as Workflow19 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema3 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema3 } from "@workglow/util/media";
 var inputSchema43 = {
   type: "object",
   properties: {
-    image: GpuImageSchema3({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema3({ title: "Image", description: "Source image" }),
     amount: {
       type: "number",
       title: "Amount",
@@ -6695,7 +6663,7 @@ var inputSchema43 = {
 };
 var outputSchema42 = {
   type: "object",
-  properties: { image: GpuImageSchema3({ title: "Image", description: "Brightness-adjusted image" }) },
+  properties: { image: ImageValueSchema3({ title: "Image", description: "Brightness-adjusted image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6719,11 +6687,11 @@ class ImageBrightnessTask extends ImageFilterTask {
 Workflow19.prototype.imageBrightness = CreateWorkflow18(ImageBrightnessTask);
 // src/task/image/contrast/ImageContrastTask.ts
 import { CreateWorkflow as CreateWorkflow19, Workflow as Workflow20 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema4 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema4 } from "@workglow/util/media";
 var inputSchema44 = {
   type: "object",
   properties: {
-    image: GpuImageSchema4({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema4({ title: "Image", description: "Source image" }),
     amount: {
       type: "number",
       title: "Amount",
@@ -6738,7 +6706,7 @@ var inputSchema44 = {
 };
 var outputSchema43 = {
   type: "object",
-  properties: { image: GpuImageSchema4({ title: "Image", description: "Contrast-adjusted image" }) },
+  properties: { image: ImageValueSchema4({ title: "Image", description: "Contrast-adjusted image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6762,11 +6730,11 @@ class ImageContrastTask extends ImageFilterTask {
 Workflow20.prototype.imageContrast = CreateWorkflow19(ImageContrastTask);
 // src/task/image/crop/ImageCropTask.ts
 import { CreateWorkflow as CreateWorkflow20, Workflow as Workflow21 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema5 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema5 } from "@workglow/util/media";
 var inputSchema45 = {
   type: "object",
   properties: {
-    image: GpuImageSchema5({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema5({ title: "Image", description: "Source image" }),
     left: { type: "integer", title: "Left", description: "Left offset", minimum: 0, default: 0 },
     top: { type: "integer", title: "Top", description: "Top offset", minimum: 0, default: 0 },
     width: { type: "integer", title: "Width", description: "Crop width", minimum: 1 },
@@ -6777,7 +6745,7 @@ var inputSchema45 = {
 };
 var outputSchema44 = {
   type: "object",
-  properties: { image: GpuImageSchema5({ title: "Image", description: "Cropped image" }) },
+  properties: { image: ImageValueSchema5({ title: "Image", description: "Cropped image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6814,11 +6782,11 @@ class ImageCropTask extends ImageFilterTask {
 Workflow21.prototype.imageCrop = CreateWorkflow20(ImageCropTask);
 // src/task/image/flip/ImageFlipTask.ts
 import { CreateWorkflow as CreateWorkflow21, Workflow as Workflow22 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema6 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema6 } from "@workglow/util/media";
 var inputSchema46 = {
   type: "object",
   properties: {
-    image: GpuImageSchema6({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema6({ title: "Image", description: "Source image" }),
     direction: {
       type: "string",
       enum: ["horizontal", "vertical"],
@@ -6832,7 +6800,7 @@ var inputSchema46 = {
 };
 var outputSchema45 = {
   type: "object",
-  properties: { image: GpuImageSchema6({ title: "Image", description: "Flipped image" }) },
+  properties: { image: ImageValueSchema6({ title: "Image", description: "Flipped image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6856,16 +6824,16 @@ class ImageFlipTask extends ImageFilterTask {
 Workflow22.prototype.imageFlip = CreateWorkflow21(ImageFlipTask);
 // src/task/image/grayscale/ImageGrayscaleTask.ts
 import { CreateWorkflow as CreateWorkflow22, Workflow as Workflow23 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema7 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema7 } from "@workglow/util/media";
 var inputSchema47 = {
   type: "object",
-  properties: { image: GpuImageSchema7({ title: "Image", description: "Source image" }) },
+  properties: { image: ImageValueSchema7({ title: "Image", description: "Source image" }) },
   required: ["image"],
   additionalProperties: false
 };
 var outputSchema46 = {
   type: "object",
-  properties: { image: GpuImageSchema7({ title: "Image", description: "Grayscale image" }) },
+  properties: { image: ImageValueSchema7({ title: "Image", description: "Grayscale image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6889,16 +6857,16 @@ class ImageGrayscaleTask extends ImageFilterTask {
 Workflow23.prototype.imageGrayscale = CreateWorkflow22(ImageGrayscaleTask);
 // src/task/image/invert/ImageInvertTask.ts
 import { CreateWorkflow as CreateWorkflow23, Workflow as Workflow24 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema8 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema8 } from "@workglow/util/media";
 var inputSchema48 = {
   type: "object",
-  properties: { image: GpuImageSchema8({ title: "Image", description: "Source image" }) },
+  properties: { image: ImageValueSchema8({ title: "Image", description: "Source image" }) },
   required: ["image"],
   additionalProperties: false
 };
 var outputSchema47 = {
   type: "object",
-  properties: { image: GpuImageSchema8({ title: "Image", description: "Inverted image" }) },
+  properties: { image: ImageValueSchema8({ title: "Image", description: "Inverted image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6922,11 +6890,11 @@ class ImageInvertTask extends ImageFilterTask {
 Workflow24.prototype.imageInvert = CreateWorkflow23(ImageInvertTask);
 // src/task/image/pixelate/ImagePixelateTask.ts
 import { CreateWorkflow as CreateWorkflow24, Workflow as Workflow25 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema9 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema9 } from "@workglow/util/media";
 var inputSchema49 = {
   type: "object",
   properties: {
-    image: GpuImageSchema9({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema9({ title: "Image", description: "Source image" }),
     blockSize: {
       type: "integer",
       title: "Block Size",
@@ -6941,7 +6909,7 @@ var inputSchema49 = {
 };
 var outputSchema48 = {
   type: "object",
-  properties: { image: GpuImageSchema9({ title: "Image", description: "Pixelated image" }) },
+  properties: { image: ImageValueSchema9({ title: "Image", description: "Pixelated image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -6968,11 +6936,11 @@ class ImagePixelateTask extends ImageFilterTask {
 Workflow25.prototype.imagePixelate = CreateWorkflow24(ImagePixelateTask);
 // src/task/image/posterize/ImagePosterizeTask.ts
 import { CreateWorkflow as CreateWorkflow25, Workflow as Workflow26 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema10 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema10 } from "@workglow/util/media";
 var inputSchema50 = {
   type: "object",
   properties: {
-    image: GpuImageSchema10({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema10({ title: "Image", description: "Source image" }),
     levels: {
       type: "integer",
       title: "Levels",
@@ -6987,7 +6955,7 @@ var inputSchema50 = {
 };
 var outputSchema49 = {
   type: "object",
-  properties: { image: GpuImageSchema10({ title: "Image", description: "Posterized image" }) },
+  properties: { image: ImageValueSchema10({ title: "Image", description: "Posterized image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7013,11 +6981,11 @@ Workflow26.prototype.imagePosterize = CreateWorkflow25(ImagePosterizeTask);
 import { getImageRasterCodec, registerImageRasterCodec as registerImageRasterCodec2 } from "@workglow/util/media";
 // src/task/image/resize/ImageResizeTask.ts
 import { CreateWorkflow as CreateWorkflow26, Workflow as Workflow27 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema11 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema11 } from "@workglow/util/media";
 var inputSchema51 = {
   type: "object",
   properties: {
-    image: GpuImageSchema11({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema11({ title: "Image", description: "Source image" }),
     width: { type: "integer", title: "Width", description: "Target width in pixels", minimum: 1 },
     height: { type: "integer", title: "Height", description: "Target height in pixels", minimum: 1 },
     fit: {
@@ -7038,7 +7006,7 @@ var inputSchema51 = {
 };
 var outputSchema50 = {
   type: "object",
-  properties: { image: GpuImageSchema11({ title: "Image", description: "Resized image" }) },
+  properties: { image: ImageValueSchema11({ title: "Image", description: "Resized image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7075,11 +7043,11 @@ class ImageResizeTask extends ImageFilterTask {
 Workflow27.prototype.imageResize = CreateWorkflow26(ImageResizeTask);
 // src/task/image/rotate/ImageRotateTask.ts
 import { CreateWorkflow as CreateWorkflow27, Workflow as Workflow28 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema12 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema12 } from "@workglow/util/media";
 var inputSchema52 = {
   type: "object",
   properties: {
-    image: GpuImageSchema12({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema12({ title: "Image", description: "Source image" }),
     angle: {
       type: "integer",
       enum: [90, 180, 270],
@@ -7097,7 +7065,7 @@ var inputSchema52 = {
 };
 var outputSchema51 = {
   type: "object",
-  properties: { image: GpuImageSchema12({ title: "Image", description: "Rotated image" }) },
+  properties: { image: ImageValueSchema12({ title: "Image", description: "Rotated image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7179,16 +7147,16 @@ var ColorFromSchemaOptions = {
 };
 // src/task/image/sepia/ImageSepiaTask.ts
 import { CreateWorkflow as CreateWorkflow28, Workflow as Workflow29 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema13 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema13 } from "@workglow/util/media";
 var inputSchema53 = {
   type: "object",
-  properties: { image: GpuImageSchema13({ title: "Image", description: "Source image" }) },
+  properties: { image: ImageValueSchema13({ title: "Image", description: "Source image" }) },
   required: ["image"],
   additionalProperties: false
 };
 var outputSchema52 = {
   type: "object",
-  properties: { image: GpuImageSchema13({ title: "Image", description: "Sepia-toned image" }) },
+  properties: { image: ImageValueSchema13({ title: "Image", description: "Sepia-toned image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7219,7 +7187,7 @@ import {
 import {
   CpuImage as CpuImage18,
   getPreviewBudget,
-  GpuImageSchema as GpuImageSchema14,
+  ImageValueSchema as ImageValueSchema14,
   resolveColor as resolveColor5
 } from "@workglow/util/media";
 function toRgbaImage(image) {
@@ -7296,7 +7264,7 @@ var IMAGE_TEXT_POSITION_LABELS = {
   "bottom-center": "Bottom center",
   "bottom-right": "Bottom right"
 };
-var backgroundImageProperty = GpuImageSchema14({
+var backgroundImageProperty = ImageValueSchema14({
   title: "Image",
   description: "Background image to render the text onto"
 });
@@ -7361,7 +7329,7 @@ var inputSchema54 = {
 var outputSchema53 = {
   type: "object",
   properties: {
-    image: GpuImageSchema14({ title: "Image", description: "Raster image with text" })
+    image: ImageValueSchema14({ title: "Image", description: "Raster image with text" })
   },
   required: ["image"],
   additionalProperties: false
@@ -7384,7 +7352,8 @@ function requireStandaloneDims(input) {
   return { width: input.width, height: input.height };
 }
 async function renderTextOverBackground(params, backgroundImage, previewScale) {
-  const background = await backgroundImage.materialize();
+  const cpu = await CpuImage18.from(backgroundImage);
+  const background = cpu.getBinary();
   const overlay = await renderImageTextToRgba({
     text: params.text,
     font: params.font,
@@ -7398,7 +7367,7 @@ async function renderTextOverBackground(params, backgroundImage, previewScale) {
   });
   const composited = compositeTextOverBackground(background, overlay);
   return {
-    image: CpuImage18.fromImageBinary(composited, previewScale)
+    image: await CpuImage18.fromRaw(composited).toImageValue(previewScale)
   };
 }
 async function renderTextStandalone(params, width, height, previewScale) {
@@ -7414,7 +7383,7 @@ async function renderTextStandalone(params, width, height, previewScale) {
     position: params.position
   });
   return {
-    image: CpuImage18.fromImageBinary(textBinary, previewScale)
+    image: await CpuImage18.fromRaw(textBinary).toImageValue(previewScale)
   };
 }
 async function runText(input) {
@@ -7464,11 +7433,11 @@ class ImageTextTask extends Task43 {
 Workflow30.prototype.imageText = CreateWorkflow29(ImageTextTask);
 // src/task/image/threshold/ImageThresholdTask.ts
 import { CreateWorkflow as CreateWorkflow30, Workflow as Workflow31 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema15 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema15 } from "@workglow/util/media";
 var inputSchema55 = {
   type: "object",
   properties: {
-    image: GpuImageSchema15({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema15({ title: "Image", description: "Source image" }),
     value: {
       type: "number",
       title: "Value",
@@ -7483,7 +7452,7 @@ var inputSchema55 = {
 };
 var outputSchema54 = {
   type: "object",
-  properties: { image: GpuImageSchema15({ title: "Image", description: "Thresholded image" }) },
+  properties: { image: ImageValueSchema15({ title: "Image", description: "Thresholded image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7507,11 +7476,11 @@ class ImageThresholdTask extends ImageFilterTask {
 Workflow31.prototype.imageThreshold = CreateWorkflow30(ImageThresholdTask);
 // src/task/image/tint/ImageTintTask.ts
 import { CreateWorkflow as CreateWorkflow31, Workflow as Workflow32 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema16 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema16 } from "@workglow/util/media";
 var inputSchema56 = {
   type: "object",
   properties: {
-    image: GpuImageSchema16({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema16({ title: "Image", description: "Source image" }),
     color: ColorValueSchema({ title: "Color", description: "Tint color" }),
     amount: {
       type: "number",
@@ -7527,7 +7496,7 @@ var inputSchema56 = {
 };
 var outputSchema55 = {
   type: "object",
-  properties: { image: GpuImageSchema16({ title: "Image", description: "Tinted image" }) },
+  properties: { image: ImageValueSchema16({ title: "Image", description: "Tinted image" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -7554,11 +7523,11 @@ class ImageTintTask extends ImageFilterTask {
 Workflow32.prototype.imageTint = CreateWorkflow31(ImageTintTask);
 // src/task/image/transparency/ImageTransparencyTask.ts
 import { CreateWorkflow as CreateWorkflow32, Workflow as Workflow33 } from "@workglow/task-graph";
-import { GpuImageSchema as GpuImageSchema17 } from "@workglow/util/media";
+import { ImageValueSchema as ImageValueSchema17 } from "@workglow/util/media";
 var inputSchema57 = {
   type: "object",
   properties: {
-    image: GpuImageSchema17({ title: "Image", description: "Source image" }),
+    image: ImageValueSchema17({ title: "Image", description: "Source image" }),
     amount: {
       type: "number",
       title: "Amount",
@@ -7573,7 +7542,7 @@ var inputSchema57 = {
 };
 var outputSchema56 = {
   type: "object",
-  properties: { image: GpuImageSchema17({ title: "Image", description: "Image with adjusted transparency" }) },
+  properties: { image: ImageValueSchema17({ title: "Image", description: "Image with adjusted transparency" }) },
   required: ["image"],
   additionalProperties: false
 };
@@ -16602,4 +16571,4 @@ export {
   ArrayTask
 };
 
-//# debugId=FAF7FA49938F2E7164756E2164756E21
+//# debugId=C616C723AAF9A52064756E2164756E21