@transloadit/zod 4.3.0 → 4.3.1

package/dist/v3/robots/image-merge.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v3';
-import { color_without_alpha, imageQualitySchema, interpolateRobot, robotBase, robotUse, } from "./_instructions-primitives.js";
+import { color_without_alpha_with_named, interpolateRobot, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,
@@ -49,13 +48,25 @@ It's recommended to use this Robot with
 similar size before merging them.
 `),
     format: z
-        .enum(['jpg', 'png'])
+        .enum(['jpg', 'png', 'webp'])
         .default('png')
         .describe('The output format for the modified image.'),
     direction: z
         .enum(['horizontal', 'vertical'])
         .default('horizontal')
-        .describe('Specifies the direction which the images are displayed.'),
+        .describe(`
+Specifies the direction which the images are displayed.
+
+Only applies to the default spritesheet layout. Ignored when \`effect\` is set to \`polaroid-stack\` or \`mosaic\`, as those effects use their own layout algorithms.
+`),
+    effect: z
+        .enum(['mosaic', 'polaroid-stack'])
+        .optional()
+        .describe(`
+Applies a styled collage layout instead of a plain horizontal or vertical spritesheet.
+
+Currently supports \`polaroid-stack\`, which renders the inputs as overlapping instant photos on a canvas, and \`mosaic\`, which builds a justified tiled collage.
+`),
     // TODO: default is not between 1 and 10
     border: z
         .number()
@@ -65,13 +76,62 @@ similar size before merging them.
 An integer value which defines the gap between images on the spritesheet.
 
 A value of \`10\` would cause the images to have the largest gap between them, while a value of \`1\` would place the images side-by-side.
+
+When \`effect\` is \`polaroid-stack\`, this value is instead used as canvas padding so the outermost photos keep that many pixels of distance from the edge.
+
+When \`effect\` is \`mosaic\`, this value is used both as the outer canvas padding and as the gutter width between neighbouring tiles.
 `),
-    background: color_without_alpha.default('#FFFFFF').describe(`
+    background: color_without_alpha_with_named.default('#fff').describe(`
 Either the hexadecimal code or [name](https://www.imagemagick.org/script/color.php#color_names) of the color used to fill the background (only shown with a border > 1).
 
-By default, the background of transparent images is changed to white.
+By default, the background of transparent images is changed to white. Set to \`none\` or \`transparent\` for a transparent canvas — requires \`format\` \`png\` or \`webp\` to preserve alpha.
 
 For details about how to preserve transparency across all image types, see [this demo](/demos/image-manipulation/properly-preserve-transparency-across-all-image-types/).
+`),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe(`
+The output canvas width in pixels.
+
+This is mainly used by styled effects such as \`polaroid-stack\` and \`mosaic\`.
+`),
+    height: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe(`
+The output canvas height in pixels.
+
+This is mainly used by styled effects such as \`polaroid-stack\` and \`mosaic\`.
+`),
+    seed: z
+        .number()
+        .int()
+        .optional()
+        .describe(`
+Optional deterministic seed used by styled effects such as \`polaroid-stack\` and \`mosaic\`.
+`),
+    shuffle: z
+        .boolean()
+        .default(false)
+        .describe(`
+Whether styled effects such as \`polaroid-stack\` and \`mosaic\` may shuffle the input order before laying out the canvas.
+`),
+    coverage: z
+        .number()
+        .min(0.5)
+        .max(3)
+        .optional()
+        .describe(`
+Area-coverage multiplier for the \`polaroid-stack\` effect. Controls how large each polaroid is relative to the canvas and consequently how much of the canvas is covered by photos.
+
+The default of \`1.5\` leaves a subtle beige border along some edges. Use \`2.0\`–\`2.5\` for edge-to-edge coverage (photos overlap more). Values below \`1.0\` produce smaller, more widely spaced polaroids.
+
+Has no effect on the \`mosaic\` style or on plain spritesheets.
 `),
     adaptive_filtering: z
         .boolean()
@@ -79,7 +139,15 @@ For details about how to preserve transparency across all image types, see [this
         .describe(`
 Controls the image compression for PNG images. Setting to \`true\` results in smaller file size, while increasing processing time. It is encouraged to keep this option disabled.
 `),
-    quality: imageQualitySchema,
+    quality: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(100)
+        .describe(`
+Controls the image compression for JPG, PNG, and WebP images. Please also take a look at [🤖/image/optimize](/docs/robots/image-optimize/).
+`),
 })
     .strict();
 export const robotImageMergeInstructionsWithHiddenFieldsSchema = robotImageMergeInstructionsSchema.extend({

package/dist/v3/robots/image-ocr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-ocr.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-ocr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AASnE,eAAO,MAAM,IAAI,EAAE,cAyClB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BjC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}
+{"version":3,"file":"image-ocr.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-ocr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AASnE,eAAO,MAAM,IAAI,EAAE,cAwClB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BjC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}

package/dist/v3/robots/image-ocr.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v3';
 import { aiProviderSchema, granularitySchema, interpolateRobot, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,

package/dist/v3/robots/image-optimize.d.ts

@@ -62,6 +62,7 @@ export declare const robotImageOptimizeInstructionsSchema: z.ZodObject<{
     progressive: z.ZodDefault<z.ZodBoolean>;
     preserve_meta_data: z.ZodDefault<z.ZodBoolean>;
     fix_breaking_images: z.ZodDefault<z.ZodBoolean>;
+    lossy: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     robot: "/image/optimize";
     result: boolean;
@@ -71,6 +72,7 @@ export declare const robotImageOptimizeInstructionsSchema: z.ZodObject<{
     progressive: boolean;
     preserve_meta_data: boolean;
     fix_breaking_images: boolean;
+    lossy: boolean;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -112,6 +114,7 @@ export declare const robotImageOptimizeInstructionsSchema: z.ZodObject<{
     progressive?: boolean | undefined;
     preserve_meta_data?: boolean | undefined;
     fix_breaking_images?: boolean | undefined;
+    lossy?: boolean | undefined;
 }>;
 export declare const robotImageOptimizeInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     output_meta: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
@@ -171,6 +174,7 @@ export declare const robotImageOptimizeInstructionsWithHiddenFieldsSchema: z.Zod
     progressive: z.ZodDefault<z.ZodBoolean>;
     preserve_meta_data: z.ZodDefault<z.ZodBoolean>;
     fix_breaking_images: z.ZodDefault<z.ZodBoolean>;
+    lossy: z.ZodDefault<z.ZodBoolean>;
 } & {
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, "strict", z.ZodTypeAny, {
@@ -181,6 +185,7 @@ export declare const robotImageOptimizeInstructionsWithHiddenFieldsSchema: z.Zod
     progressive: boolean;
     preserve_meta_data: boolean;
     fix_breaking_images: boolean;
+    lossy: boolean;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -223,6 +228,7 @@ export declare const robotImageOptimizeInstructionsWithHiddenFieldsSchema: z.Zod
     progressive?: boolean | undefined;
     preserve_meta_data?: boolean | undefined;
     fix_breaking_images?: boolean | undefined;
+    lossy?: boolean | undefined;
 }>;
 export type RobotImageOptimizeInstructions = z.infer<typeof robotImageOptimizeInstructionsSchema>;
 export type RobotImageOptimizeInstructionsWithHiddenFields = z.infer<typeof robotImageOptimizeInstructionsWithHiddenFieldsSchema>;
@@ -285,6 +291,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsSchema: z.ZodOb
     progressive: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     preserve_meta_data: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     fix_breaking_images: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    lossy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
 }, "strict", z.ZodTypeAny, {
     robot: "/image/optimize";
     result: string | boolean;
@@ -294,6 +301,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsSchema: z.ZodOb
     progressive: string | boolean;
     preserve_meta_data: string | boolean;
     fix_breaking_images: string | boolean;
+    lossy: string | boolean;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -335,6 +343,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsSchema: z.ZodOb
     progressive?: string | boolean | undefined;
     preserve_meta_data?: string | boolean | undefined;
     fix_breaking_images?: string | boolean | undefined;
+    lossy?: string | boolean | undefined;
 }>;
 export type InterpolatableRobotImageOptimizeInstructions = InterpolatableRobotImageOptimizeInstructionsInput;
 export type InterpolatableRobotImageOptimizeInstructionsInput = z.input<typeof interpolatableRobotImageOptimizeInstructionsSchema>;
@@ -396,6 +405,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsWithHiddenField
     progressive: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     preserve_meta_data: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     fix_breaking_images: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    lossy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, "strict", z.ZodTypeAny, {
     robot: "/image/optimize";
@@ -405,6 +415,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsWithHiddenField
     progressive: string | boolean;
     preserve_meta_data: string | boolean;
     fix_breaking_images: string | boolean;
+    lossy: string | boolean;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -447,6 +458,7 @@ export declare const interpolatableRobotImageOptimizeInstructionsWithHiddenField
     progressive?: string | boolean | undefined;
     preserve_meta_data?: string | boolean | undefined;
     fix_breaking_images?: string | boolean | undefined;
+    lossy?: string | boolean | undefined;
 }>;
 export type InterpolatableRobotImageOptimizeInstructionsWithHiddenFields = z.infer<typeof interpolatableRobotImageOptimizeInstructionsWithHiddenFieldsSchema>;
 export type InterpolatableRobotImageOptimizeInstructionsWithHiddenFieldsInput = z.input<typeof interpolatableRobotImageOptimizeInstructionsWithHiddenFieldsSchema>;

package/dist/v3/robots/image-optimize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-optimize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-optimize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,eAAO,MAAM,IAAI,EAAE,cAkClB,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7D,CAAA;AAEJ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AACjG,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,oDAAoD,CAC5D,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9D,CAAA;AACD,MAAM,MAAM,4CAA4C,GACtD,iDAAiD,CAAA;AAEnD,MAAM,MAAM,iDAAiD,GAAG,CAAC,CAAC,KAAK,CACrE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9E,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,kEAAkE,CAC1E,CAAA;AACD,MAAM,MAAM,iEAAiE,GAAG,CAAC,CAAC,KAAK,CACrF,OAAO,kEAAkE,CAC1E,CAAA"}
+{"version":3,"file":"image-optimize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-optimize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,eAAO,MAAM,IAAI,EAAE,cAiClB,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7D,CAAA;AAEJ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AACjG,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,oDAAoD,CAC5D,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9D,CAAA;AACD,MAAM,MAAM,4CAA4C,GACtD,iDAAiD,CAAA;AAEnD,MAAM,MAAM,iDAAiD,GAAG,CAAC,CAAC,KAAK,CACrE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9E,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,kEAAkE,CAC1E,CAAA;AACD,MAAM,MAAM,iEAAiE,GAAG,CAAC,CAAC,KAAK,CACrF,OAAO,kEAAkE,CAC1E,CAAA"}

package/dist/v3/robots/image-optimize.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v3';
 import { interpolateRobot, optimize_priority, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,
@@ -22,13 +21,13 @@ export const meta = {
     purpose_word: 'optimize',
     purpose_words: 'Optimize images without quality loss',
     service_slug: 'image-manipulation',
-    slot_count: 15,
+    slot_count: 5,
     title: 'Optimize images without quality loss',
     typical_file_size_mb: 0.8,
     typical_file_type: 'image',
     name: 'ImageOptimizeRobot',
     priceFactor: 1,
-    queueSlotCount: 15,
+    queueSlotCount: 5,
     isAllowedForUrlTransform: true,
     trackOutputFileSize: true,
     isInternal: false,
@@ -47,6 +46,9 @@ It works well together with [🤖/image/resize](/docs/robots/image-resize/) to b
 
 > [!Note]
 > This <dfn>Robot</dfn> accepts all image types and will just pass on unsupported image types unoptimized. Hence, there is no need to set up [🤖/file/filter](/docs/robots/file-filter/) workflows for this.
+
+> [!Note]
+> PNG optimization uses only lossless (optipng) compressors by default. To also enable lossy compression (pngquant), set \`lossy: true\`. When enabled, both lossy and lossless compressors compete and the smallest result wins, which may cause color shifts in some images.
 `),
     priority: optimize_priority.describe(`
 Provides different algorithms for better or worse compression for your images, but that run slower or faster. The value \`"conversion-speed"\` will result in an average compression ratio of 18%. \`"compression-ratio"\` will result in an average compression ratio of 31%.
@@ -68,6 +70,17 @@ Specifies if the image's metadata should be preserved during the optimization, o
         .default(true)
         .describe(`
 If set to \`true\` this parameter tries to fix images that would otherwise make the underlying tool error out and thereby break your <dfn>Assemblies</dfn>. This can sometimes result in a larger file size, though.
+`),
+    lossy: z
+        .boolean()
+        .default(false)
+        .describe(`
+When set to \`false\` (the default), only lossless PNG optimizers are used, disabling pngquant to preserve color accuracy.
+
+When set to \`true\`, both lossy and lossless PNG optimizers compete and the smallest result wins. This allows pngquant, a lossy compressor that reduces PNGs to a 256-color palette, which may cause noticeable color shifts in images with rich color palettes, subtle gradients, or brand-specific colors.
+
+> [!Note]
+> This parameter only affects PNG optimization. JPEG, GIF, WebP, and SVG optimization is unaffected.
 `),
 })
     .strict();

package/dist/v3/robots/image-resize.d.ts

@@ -250,6 +250,7 @@ export declare const robotImageResizeInstructionsSchema: z.ZodObject<{
     trim_whitespace: z.ZodDefault<z.ZodBoolean>;
     clip: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     negate: z.ZodDefault<z.ZodBoolean>;
+    clut: z.ZodDefault<z.ZodBoolean>;
     density: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     monochrome: z.ZodDefault<z.ZodBoolean>;
     shave: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodNumber, string, number>]>>;
@@ -273,8 +274,8 @@ export declare const robotImageResizeInstructionsSchema: z.ZodObject<{
     density: string | null;
     trim_whitespace: boolean;
     frame: number | null;
-    adaptive_filtering: boolean;
     quality: number;
+    adaptive_filtering: boolean;
     progressive: boolean;
     gravity: "left" | "right" | "bottom" | "bottom-left" | "bottom-right" | "center" | "top" | "top-left" | "top-right";
     flatten: boolean;
@@ -296,6 +297,7 @@ export declare const robotImageResizeInstructionsSchema: z.ZodObject<{
     watermark_repeat_y: boolean;
     clip: string | boolean;
     negate: boolean;
+    clut: boolean;
     monochrome: boolean;
     type?: "Bilevel" | "ColorSeparation" | "ColorSeparationAlpha" | "Grayscale" | "GrayscaleAlpha" | "Palette" | "PaletteAlpha" | "TrueColor" | "TrueColorAlpha" | undefined;
     alpha?: "Transparent" | "Remove" | "Set" | "Activate" | "Background" | "Copy" | "Deactivate" | "Extract" | "Off" | "On" | "Opaque" | "Shape" | undefined;
@@ -433,8 +435,8 @@ export declare const robotImageResizeInstructionsSchema: z.ZodObject<{
     colorspace?: "CMY" | "CMYK" | "Gray" | "HCL" | "HCLp" | "HSB" | "HSI" | "HSL" | "HSV" | "HWB" | "Jzazbz" | "Lab" | "LCHab" | "LCHuv" | "LMS" | "Log" | "Luv" | "OHTA" | "OkLab" | "OkLCH" | "Rec601YCbCr" | "Rec709YCbCr" | "RGB" | "scRGB" | "sRGB" | "Transparent" | "Undefined" | "xyY" | "XYZ" | "YCbCr" | "YCC" | "YDbDr" | "YIQ" | "YPbPr" | "YUV" | undefined;
     trim_whitespace?: boolean | undefined;
     frame?: number | null | undefined;
-    adaptive_filtering?: boolean | undefined;
     quality?: number | undefined;
+    adaptive_filtering?: boolean | undefined;
     progressive?: boolean | undefined;
     gravity?: "left" | "right" | "bottom" | "bottom-left" | "bottom-right" | "center" | "top" | "top-left" | "top-right" | undefined;
     preclip_alpha?: "Transparent" | "Remove" | "Set" | "Activate" | "Background" | "Copy" | "Deactivate" | "Extract" | "Off" | "On" | "Opaque" | "Shape" | undefined;
@@ -457,6 +459,7 @@ export declare const robotImageResizeInstructionsSchema: z.ZodObject<{
     watermark_repeat_y?: boolean | undefined;
     clip?: string | boolean | undefined;
     negate?: boolean | undefined;
+    clut?: boolean | undefined;
     monochrome?: boolean | undefined;
     shave?: string | number | undefined;
 }>;
@@ -586,6 +589,7 @@ export declare const robotImageResizeInstructionsWithHiddenFieldsSchema: z.ZodOb
     trim_whitespace: z.ZodDefault<z.ZodBoolean>;
     clip: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     negate: z.ZodDefault<z.ZodBoolean>;
+    clut: z.ZodDefault<z.ZodBoolean>;
     density: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     monochrome: z.ZodDefault<z.ZodBoolean>;
     shave: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodNumber, string, number>]>>;
@@ -700,8 +704,8 @@ export declare const robotImageResizeInstructionsWithHiddenFieldsSchema: z.ZodOb
     density: string | null;
     trim_whitespace: boolean;
     frame: number | null;
-    adaptive_filtering: boolean;
     quality: number;
+    adaptive_filtering: boolean;
     progressive: boolean;
     gravity: "left" | "right" | "bottom" | "bottom-left" | "bottom-right" | "center" | "top" | "top-left" | "top-right";
     flatten: boolean;
@@ -723,6 +727,7 @@ export declare const robotImageResizeInstructionsWithHiddenFieldsSchema: z.ZodOb
     watermark_repeat_y: boolean;
     clip: string | boolean;
     negate: boolean;
+    clut: boolean;
     monochrome: boolean;
     type?: "Bilevel" | "ColorSeparation" | "ColorSeparationAlpha" | "Grayscale" | "GrayscaleAlpha" | "Palette" | "PaletteAlpha" | "TrueColor" | "TrueColorAlpha" | undefined;
     alpha?: "Transparent" | "Remove" | "Set" | "Activate" | "Background" | "Copy" | "Deactivate" | "Extract" | "Off" | "On" | "Opaque" | "Shape" | undefined;
@@ -869,8 +874,8 @@ export declare const robotImageResizeInstructionsWithHiddenFieldsSchema: z.ZodOb
     trim_whitespace?: boolean | undefined;
     stack?: string | undefined;
     frame?: number | null | undefined;
-    adaptive_filtering?: boolean | undefined;
     quality?: number | undefined;
+    adaptive_filtering?: boolean | undefined;
     progressive?: boolean | undefined;
     gravity?: "left" | "right" | "bottom" | "bottom-left" | "bottom-right" | "center" | "top" | "top-left" | "top-right" | undefined;
     preclip_alpha?: "Transparent" | "Remove" | "Set" | "Activate" | "Background" | "Copy" | "Deactivate" | "Extract" | "Off" | "On" | "Opaque" | "Shape" | undefined;
@@ -893,6 +898,7 @@ export declare const robotImageResizeInstructionsWithHiddenFieldsSchema: z.ZodOb
     watermark_repeat_y?: boolean | undefined;
     clip?: string | boolean | undefined;
     negate?: boolean | undefined;
+    clut?: boolean | undefined;
     monochrome?: boolean | undefined;
     shave?: string | number | undefined;
     watermark_position_x?: number | undefined;
@@ -1106,6 +1112,7 @@ export declare const interpolatableRobotImageResizeInstructionsSchema: z.ZodObje
     trim_whitespace: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     clip: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>]>>;
     negate: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    clut: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     density: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     monochrome: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     shave: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodNumber, string, number>]>]>>;
@@ -1129,8 +1136,8 @@ export declare const interpolatableRobotImageResizeInstructionsSchema: z.ZodObje
     density: string | null;
     trim_whitespace: string | boolean;
     frame: string | number | null;
-    adaptive_filtering: string | boolean;
     quality: string | number;
+    adaptive_filtering: string | boolean;
     progressive: string | boolean;
     gravity: string;
     flatten: string | boolean;
@@ -1152,6 +1159,7 @@ export declare const interpolatableRobotImageResizeInstructionsSchema: z.ZodObje
     watermark_repeat_y: string | boolean;
     clip: string | boolean;
     negate: string | boolean;
+    clut: string | boolean;
     monochrome: string | boolean;
     type?: string | undefined;
     alpha?: string | undefined;
@@ -1289,8 +1297,8 @@ export declare const interpolatableRobotImageResizeInstructionsSchema: z.ZodObje
     colorspace?: string | undefined;
     trim_whitespace?: string | boolean | undefined;
     frame?: string | number | null | undefined;
-    adaptive_filtering?: string | boolean | undefined;
     quality?: string | number | undefined;
+    adaptive_filtering?: string | boolean | undefined;
     progressive?: string | boolean | undefined;
     gravity?: string | undefined;
     preclip_alpha?: string | undefined;
@@ -1313,6 +1321,7 @@ export declare const interpolatableRobotImageResizeInstructionsSchema: z.ZodObje
     watermark_repeat_y?: string | boolean | undefined;
     clip?: string | boolean | undefined;
     negate?: string | boolean | undefined;
+    clut?: string | boolean | undefined;
     monochrome?: string | boolean | undefined;
     shave?: string | number | undefined;
 }>;
@@ -1444,6 +1453,7 @@ export declare const interpolatableRobotImageResizeInstructionsWithHiddenFieldsS
     trim_whitespace: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     clip: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>]>>;
     negate: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    clut: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     density: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     monochrome: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     shave: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodNumber, string, number>]>]>>;
@@ -1555,8 +1565,8 @@ export declare const interpolatableRobotImageResizeInstructionsWithHiddenFieldsS
     density: string | null;
     trim_whitespace: string | boolean;
     frame: string | number | null;
-    adaptive_filtering: string | boolean;
     quality: string | number;
+    adaptive_filtering: string | boolean;
     progressive: string | boolean;
     gravity: string;
     flatten: string | boolean;
@@ -1578,6 +1588,7 @@ export declare const interpolatableRobotImageResizeInstructionsWithHiddenFieldsS
     watermark_repeat_y: string | boolean;
     clip: string | boolean;
     negate: string | boolean;
+    clut: string | boolean;
     monochrome: string | boolean;
     type?: string | undefined;
     alpha?: string | undefined;
@@ -1724,8 +1735,8 @@ export declare const interpolatableRobotImageResizeInstructionsWithHiddenFieldsS
     trim_whitespace?: string | boolean | undefined;
     stack?: string | undefined;
     frame?: string | number | null | undefined;
-    adaptive_filtering?: string | boolean | undefined;
     quality?: string | number | undefined;
+    adaptive_filtering?: string | boolean | undefined;
     progressive?: string | boolean | undefined;
     gravity?: string | undefined;
     preclip_alpha?: string | undefined;
@@ -1748,6 +1759,7 @@ export declare const interpolatableRobotImageResizeInstructionsWithHiddenFieldsS
     watermark_repeat_y?: string | boolean | undefined;
     clip?: string | boolean | undefined;
     negate?: string | boolean | undefined;
+    clut?: string | boolean | undefined;
     monochrome?: string | boolean | undefined;
     shave?: string | number | undefined;
     watermark_position_x?: string | number | undefined;

package/dist/v3/robots/image-resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-resize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-resize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image-resize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-resize.ts"],"names":[],"mappings":"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"}

package/dist/v3/robots/image-resize.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v3';
 import { color_without_alpha_with_named, colorspaceSchema, complexHeightSchema, complexWidthSchema, imageQualitySchema, interpolateRobot, percentageSchema, positionSchema, robotBase, robotImagemagick, robotUse, unsafeCoordinatesSchema, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,
@@ -520,6 +519,43 @@ Apply the clipping path to other operations in the resize job, if one is present
         .default(false)
         .describe(`
 Replace each pixel with its complementary color, effectively negating the image. Especially useful when testing clipping.
+`),
+    clut: z
+        .boolean()
+        .default(false)
+        .describe(`
+Applies a Color Look-Up Table (CLUT) image to remap the colors of the input image using ImageMagick's \`-clut\` operator. When enabled, a second input file must be supplied via the \`use\` parameter with \`"as": "clut"\`.
+
+This operation currently runs via ImageMagick convert stack (not image-resizer daemon), even if \`stack: "daemon"\` is requested.
+
+When using multiple inputs, you should provide your primary image as \`"as": "base"\`. If no explicit \`base\` alias is set, Transloadit will use the first non-auxiliary input (a file that is not tagged as \`watermark\` or \`clut\`) as the primary image.
+
+The CLUT image acts as a gradient map: each pixel's color channels in the input are replaced with the corresponding color from the CLUT image, based on channel intensity. This is a powerful color grading technique widely used in photography and design workflows.
+
+Example:
+
+\`\`\`json
+{
+  "steps": {
+    ":original": {
+      "robot": "/upload/handle"
+    },
+    "lut_image": {
+      "robot": "/upload/handle"
+    },
+    "color_graded": {
+      "robot": "/image/resize",
+      "use": {
+        "steps": [
+          { "name": ":original", "as": "base" },
+          { "name": "lut_image", "as": "clut" }
+        ]
+      },
+      "clut": true
+    }
+  }
+}
+\`\`\`
 `),
     density: z
         .string()