image-edit-tools 1.0.0

package/dist/ops/remove-bg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-bg.js","sourceRoot":"","sources":["../../src/ops/remove-bg.ts"],"names":[],"mappings":"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"}

package/dist/ops/resize.d.ts

@@ -0,0 +1,3 @@
+import { ResizeOptions, ImageInput, ImageResult } from '../types.js';
+export declare function resize(input: ImageInput, options: ResizeOptions): Promise<ImageResult>;
+//# sourceMappingURL=resize.d.ts.map

package/dist/ops/resize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/ops/resize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAKhF,wBAAsB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA+C5F"}

package/dist/ops/resize.js

@@ -0,0 +1,54 @@
+import sharp from 'sharp';
+import { ErrorCode } from '../types.js';
+import { loadImage } from '../utils/load-image.js';
+import { err, ok } from '../utils/result.js';
+import { getImageMetadata, isPositiveInt } from '../utils/validate.js';
+export async function resize(input, options) {
+    try {
+        const buffer = await loadImage(input);
+        let width = options.width;
+        let height = options.height;
+        if (options.scale) {
+            if (options.scale <= 0)
+                return err('Scale must be positive', ErrorCode.INVALID_INPUT);
+            const meta = await getImageMetadata(buffer);
+            width = Math.round(meta.width * options.scale);
+            height = Math.round(meta.height * options.scale);
+        }
+        if (width !== undefined && !isPositiveInt(width)) {
+            return err('Width must be a positive integer', ErrorCode.INVALID_INPUT);
+        }
+        if (height !== undefined && !isPositiveInt(height)) {
+            return err('Height must be a positive integer', ErrorCode.INVALID_INPUT);
+        }
+        if (width === undefined && height === undefined) {
+            return err('Must provide width, height, or scale', ErrorCode.INVALID_INPUT);
+        }
+        let kernel;
+        if (options.kernel === 'linear')
+            kernel = 'mitchell';
+        else if (options.kernel)
+            kernel = options.kernel;
+        const output = await sharp(buffer)
+            .resize({
+            width,
+            height,
+            fit: options.fit,
+            kernel,
+            withoutEnlargement: options.withoutEnlargement
+        })
+            .toBuffer();
+        return ok(output);
+    }
+    catch (e) {
+        const msg = e.message || '';
+        if (msg.includes('HTTP'))
+            return err(msg, ErrorCode.FETCH_FAILED);
+        if (msg.includes('ENOENT'))
+            return err('File not found', ErrorCode.INVALID_INPUT);
+        if (msg.includes('unsupported image format'))
+            return err('Corrupt or unsupported input', ErrorCode.INVALID_INPUT);
+        return err(msg, ErrorCode.PROCESSING_FAILED);
+    }
+}
+//# sourceMappingURL=resize.js.map

package/dist/ops/resize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../src/ops/resize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA0C,SAAS,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAiB,EAAE,OAAsB;IACpE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QAEtC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1B,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAE5B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC;gBAAE,OAAO,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;YACtF,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC5C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC,kCAAkC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,OAAO,GAAG,CAAC,mCAAmC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,GAAG,CAAC,sCAAsC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAC9E,CAAC;QAED,IAAI,MAA0C,CAAC;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ;YAAE,MAAM,GAAG,UAAU,CAAC;aAChD,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;aAC/B,MAAM,CAAC;YACN,KAAK;YACL,MAAM;YACN,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM;YACN,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;SAC/C,CAAC;aACD,QAAQ,EAAE,CAAC;QAEd,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAClE,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAClF,IAAI,GAAG,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAAE,OAAO,GAAG,CAAC,8BAA8B,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAClH,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/ops/watermark.d.ts

@@ -0,0 +1,3 @@
+import { WatermarkOptions, ImageInput, ImageResult } from '../types.js';
+export declare function watermark(input: ImageInput, options: WatermarkOptions): Promise<ImageResult>;
+//# sourceMappingURL=watermark.d.ts.map

package/dist/ops/watermark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watermark.d.ts","sourceRoot":"","sources":["../../src/ops/watermark.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AA2B/F,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgHlG"}

package/dist/ops/watermark.js

@@ -0,0 +1,142 @@
+import sharp from 'sharp';
+import { ErrorCode } from '../types.js';
+import { loadImage } from '../utils/load-image.js';
+import { err, ok } from '../utils/result.js';
+import { getImageMetadata } from '../utils/validate.js';
+import { addText } from './add-text.js';
+import { resize } from './resize.js';
+const posToGravity = {
+    'top-left': 'northwest',
+    'top-center': 'north',
+    'top-right': 'northeast',
+    'center': 'center',
+    'bottom-left': 'southwest',
+    'bottom-center': 'south',
+    'bottom-right': 'southeast'
+};
+const posToAnchor = {
+    'top-left': 'top-left',
+    'top-center': 'top-center',
+    'top-right': 'top-right',
+    'center': 'center',
+    'bottom-left': 'bottom-left',
+    'bottom-center': 'bottom-center',
+    'bottom-right': 'bottom-right'
+};
+export async function watermark(input, options) {
+    try {
+        const buffer = await loadImage(input);
+        const meta = await getImageMetadata(buffer);
+        const position = options.position || 'bottom-right';
+        if (options.type === 'text') {
+            if (position === 'tile') {
+                const spacing = options.tileSpacing ?? 50;
+                const fontSize = options.fontSize ?? 24;
+                const color = options.color ?? '#ffffff';
+                const opacity = options.opacity ?? 0.5;
+                const charWidth = fontSize * 0.6;
+                const w = options.text.length * charWidth;
+                const h = fontSize;
+                const cols = Math.ceil(meta.width / Math.max(1, (w + spacing)));
+                const rows = Math.ceil(meta.height / Math.max(1, (h + spacing)));
+                const layers = [];
+                for (let r = 0; r < rows; r++) {
+                    for (let c = 0; c < cols; c++) {
+                        layers.push({
+                            text: options.text,
+                            x: c * (w + spacing),
+                            y: r * (h + spacing),
+                            fontSize,
+                            color,
+                            opacity,
+                            anchor: 'top-left'
+                        });
+                    }
+                }
+                return addText(buffer, { layers });
+            }
+            else {
+                const anchor = posToAnchor[position] || 'bottom-right';
+                let x = 0, y = 0;
+                const pad = 10;
+                const fontSize = options.fontSize ?? 24;
+                if (position.includes('left'))
+                    x = pad;
+                else if (position.includes('right'))
+                    x = meta.width - pad;
+                else
+                    x = meta.width / 2;
+                if (position.includes('top'))
+                    y = pad;
+                else if (position.includes('bottom'))
+                    y = meta.height - pad;
+                else
+                    y = meta.height / 2;
+                return addText(buffer, {
+                    layers: [{
+                            text: options.text,
+                            x, y, anchor,
+                            fontSize,
+                            color: options.color ?? '#ffffff',
+                            opacity: options.opacity ?? 0.5
+                        }]
+                });
+            }
+        }
+        else if (options.type === 'image') {
+            let wmBuf = await loadImage(options.image);
+            const wmMeta = await getImageMetadata(wmBuf);
+            if (options.scale && options.scale !== 1.0) {
+                const r = await resize(wmBuf, { scale: options.scale });
+                if (!r.ok)
+                    return r;
+                wmBuf = r.data;
+            }
+            if (options.opacity !== undefined && options.opacity >= 0 && options.opacity < 1) {
+                wmBuf = await sharp(wmBuf)
+                    .ensureAlpha()
+                    .composite([
+                    {
+                        input: Buffer.from([255, 255, 255, Math.round(options.opacity * 255)]),
+                        raw: { width: 1, height: 1, channels: 4 },
+                        tile: true,
+                        blend: 'dest-in'
+                    }
+                ])
+                    .toBuffer();
+            }
+            if (position === 'tile') {
+                const spacing = options.tileSpacing ?? 0;
+                if (spacing > 0) {
+                    wmBuf = await sharp(wmBuf)
+                        .ensureAlpha()
+                        .extend({ bottom: spacing, right: spacing, background: { r: 0, g: 0, b: 0, alpha: 0 } })
+                        .toBuffer();
+                }
+                const output = await sharp(buffer)
+                    .composite([{ input: wmBuf, tile: true, blend: 'over' }])
+                    .toBuffer();
+                return ok(output);
+            }
+            else {
+                const gravity = posToGravity[position] || 'southeast';
+                const output = await sharp(buffer)
+                    .composite([{ input: wmBuf, gravity, blend: 'over' }])
+                    .toBuffer();
+                return ok(output);
+            }
+        }
+        return err('Invalid watermark type', ErrorCode.INVALID_INPUT);
+    }
+    catch (e) {
+        const msg = e.message || '';
+        if (msg.includes('HTTP'))
+            return err(msg, ErrorCode.FETCH_FAILED);
+        if (msg.includes('ENOENT'))
+            return err('File not found', ErrorCode.INVALID_INPUT);
+        if (msg.includes('unsupported image format'))
+            return err('Corrupt or unsupported input', ErrorCode.INVALID_INPUT);
+        return err(msg, ErrorCode.PROCESSING_FAILED);
+    }
+}
+//# sourceMappingURL=watermark.js.map

package/dist/ops/watermark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watermark.js","sourceRoot":"","sources":["../../src/ops/watermark.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA6C,SAAS,EAAc,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,YAAY,GAA2B;IAC3C,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,OAAO;IACrB,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,WAAW;IAC1B,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,WAAW;CAC5B,CAAC;AAEF,MAAM,WAAW,GAA+B;IAC9C,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,YAAY;IAC1B,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,QAAQ;IAClB,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,eAAe;IAChC,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAiB,EAAE,OAAyB;IAC1E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC;QAEpD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;gBACzC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;gBAEvC,MAAM,SAAS,GAAG,QAAQ,GAAG,GAAG,CAAC;gBACjC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC;gBAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAEjE,MAAM,MAAM,GAAU,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;4BACpB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC;4BACpB,QAAQ;4BACR,KAAK;4BACL,OAAO;4BACP,MAAM,EAAE,UAAU;yBACnB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBACD,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;gBACvD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBACjB,MAAM,GAAG,GAAG,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAExC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,CAAC,GAAG,GAAG,CAAC;qBAClC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;;oBACrD,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;gBAExB,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,CAAC,GAAG,GAAG,CAAC;qBACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;;oBACvD,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAEzB,OAAO,OAAO,CAAC,MAAM,EAAE;oBACrB,MAAM,EAAE,CAAC;4BACP,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,CAAC,EAAE,CAAC,EAAE,MAAM;4BACZ,QAAQ;4BACR,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS;4BACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,GAAG;yBAChC,CAAC;iBACH,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpC,IAAI,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAE7C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxD,IAAI,CAAC,CAAC,CAAC,EAAE;oBAAE,OAAO,CAAgB,CAAC;gBACnC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;YACjB,CAAC;YAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;gBACjF,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;qBACvB,WAAW,EAAE;qBACb,SAAS,CAAC;oBACT;wBACE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;wBACtE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;wBACzC,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,SAAS;qBACjB;iBACF,CAAC;qBACD,QAAQ,EAAE,CAAC;YAChB,CAAC;YAED,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;gBACzC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBACf,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;yBACvB,WAAW,EAAE;yBACb,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,KAAK,EAAC,CAAC,EAAC,EAAE,CAAC;yBAC9E,QAAQ,EAAE,CAAC;gBACjB,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;qBAC/B,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;qBACxD,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC;gBACtD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;qBAC/B,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;qBACrD,QAAQ,EAAE,CAAC;gBACd,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC,wBAAwB,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAClE,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAClF,IAAI,GAAG,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAAE,OAAO,GAAG,CAAC,8BAA8B,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAClH,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,233 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Accepted image input formats.
+ * - Buffer: raw image bytes
+ * - string starting with 'http': fetched via HTTP
+ * - string starting with 'data:': base64 data URI
+ * - string (other): treated as filesystem path
+ */
+export type ImageInput = Buffer | string;
+export type Ok<T> = {
+    ok: true;
+    data: T;
+};
+export type Err = {
+    ok: false;
+    error: string;
+    code: ErrorCode;
+};
+export type Result<T> = Ok<T> | Err;
+export type ImageResult = Result<Buffer>;
+export declare enum ErrorCode {
+    INVALID_INPUT = "INVALID_INPUT",
+    UNSUPPORTED_FORMAT = "UNSUPPORTED_FORMAT",
+    OUT_OF_BOUNDS = "OUT_OF_BOUNDS",
+    FETCH_FAILED = "FETCH_FAILED",
+    PROCESSING_FAILED = "PROCESSING_FAILED",
+    MODEL_NOT_FOUND = "MODEL_NOT_FOUND",
+    TIMEOUT = "TIMEOUT"
+}
+export type CropOptions = {
+    mode?: 'absolute';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | {
+    mode: 'ratio';
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+} | {
+    mode: 'aspect';
+    aspectRatio: string;
+    anchor?: 'center' | 'top' | 'bottom' | 'face';
+} | {
+    mode: 'subject';
+};
+export type ResizeFit = 'cover' | 'contain' | 'fill' | 'inside' | 'outside';
+export type ResizeKernel = 'lanczos3' | 'nearest' | 'linear';
+export interface ResizeOptions {
+    width?: number;
+    height?: number;
+    scale?: number;
+    fit?: ResizeFit;
+    kernel?: ResizeKernel;
+    /** Preserve aspect ratio when only one dimension is given. Default: true */
+    withoutEnlargement?: boolean;
+}
+export interface PadOptions {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+    /** Square canvas shorthand: centers image and pads to this size */
+    size?: number;
+    /** CSS hex color or 'transparent'. Default: '#ffffff' */
+    color?: string;
+}
+export interface AdjustOptions {
+    /** -100 to +100 */
+    brightness?: number;
+    /** -100 to +100 */
+    contrast?: number;
+    /** -100 to +100 */
+    saturation?: number;
+    /** 0 to 360 degrees */
+    hue?: number;
+    /** 0 to 100 */
+    sharpness?: number;
+    /** -100 (cool) to +100 (warm) */
+    temperature?: number;
+}
+export type FilterPreset = 'grayscale' | 'sepia' | 'invert' | 'vintage' | 'unsharp';
+export type FilterOptions = {
+    preset: Exclude<FilterPreset, 'blur'>;
+} | {
+    preset: 'blur';
+    radius: number;
+};
+export interface BlurRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Blur strength (sigma). Default: 10 */
+    radius?: number;
+}
+export type TextAnchor = 'top-left' | 'top-center' | 'top-right' | 'middle-left' | 'center' | 'middle-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+export interface TextBackground {
+    color: string;
+    padding?: number;
+    opacity?: number;
+    borderRadius?: number;
+}
+export interface TextLayer {
+    text: string;
+    x: number;
+    y: number;
+    anchor?: TextAnchor;
+    fontSize?: number;
+    fontFamily?: string;
+    /** Google Fonts URL or local file path */
+    fontUrl?: string;
+    color?: string;
+    opacity?: number;
+    align?: 'left' | 'center' | 'right';
+    /** Wrap text at this pixel width */
+    maxWidth?: number;
+    lineHeight?: number;
+    background?: TextBackground;
+}
+export type BlendMode = 'over' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten';
+export interface CompositeLayer {
+    image: ImageInput;
+    x?: number;
+    y?: number;
+    blend?: BlendMode;
+    opacity?: number;
+}
+export type WatermarkPosition = 'top-left' | 'top-center' | 'top-right' | 'center' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'tile';
+export type WatermarkOptions = {
+    type: 'text';
+    text: string;
+    position?: WatermarkPosition;
+    fontSize?: number;
+    color?: string;
+    opacity?: number;
+    tileSpacing?: number;
+} | {
+    type: 'image';
+    image: ImageInput;
+    position?: WatermarkPosition;
+    opacity?: number;
+    scale?: number;
+    tileSpacing?: number;
+};
+export type Gravity = 'NorthWest' | 'North' | 'NorthEast' | 'West' | 'Center' | 'East' | 'SouthWest' | 'South' | 'SouthEast';
+export interface OverlayOptions {
+    gravity?: Gravity;
+    offsetX?: number;
+    offsetY?: number;
+    opacity?: number;
+    blend?: BlendMode;
+}
+export type RemoveBgEngine = 'onnx' | 'webai';
+export interface RemoveBgOptions {
+    engine?: RemoveBgEngine;
+    /** Replace transparency with this solid color instead */
+    replaceColor?: string;
+    /** Replace background with this image */
+    replaceImage?: ImageInput;
+}
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    confidence: number;
+}
+export type OutputFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif';
+export interface ConvertOptions {
+    format: OutputFormat;
+    /** 0–100. Default: 80 */
+    quality?: number;
+    /** PNG only. 0–9. Default: 6 */
+    compressionLevel?: number;
+    /** Strip all metadata. Default: true */
+    stripMetadata?: boolean;
+}
+export interface OptimizeOptions {
+    /** Target file size in KB. Quality is adjusted automatically */
+    maxSizeKB?: number;
+    /** Resize so the longest dimension does not exceed this value */
+    maxDimension?: number;
+    /** Auto-select format (WebP if alpha, JPEG otherwise). Default: true */
+    autoFormat?: boolean;
+}
+export interface ImageMetadata {
+    width: number;
+    height: number;
+    format: string;
+    fileSize: number;
+    colorSpace?: string;
+    hasAlpha: boolean;
+    channels: number;
+    density?: number;
+    exif?: Record<string, unknown>;
+}
+export type PipelineOperation = ({
+    op: 'crop';
+} & CropOptions) | ({
+    op: 'resize';
+} & ResizeOptions) | ({
+    op: 'pad';
+} & PadOptions) | ({
+    op: 'adjust';
+} & AdjustOptions) | ({
+    op: 'filter';
+} & FilterOptions) | ({
+    op: 'blurRegion';
+    regions: BlurRegion[];
+}) | ({
+    op: 'addText';
+    layers: TextLayer[];
+}) | ({
+    op: 'composite';
+    layers: CompositeLayer[];
+}) | ({
+    op: 'watermark';
+} & WatermarkOptions) | ({
+    op: 'convert';
+} & ConvertOptions) | ({
+    op: 'optimize';
+} & OptimizeOptions) | ({
+    op: 'removeBg';
+} & RemoveBgOptions);
+export interface BatchOptions {
+    concurrency?: number;
+    onProgress?: (done: number, total: number) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,12 @@
+// ─── Input ────────────────────────────────────────────────────────────────────
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["UNSUPPORTED_FORMAT"] = "UNSUPPORTED_FORMAT";
+    ErrorCode["OUT_OF_BOUNDS"] = "OUT_OF_BOUNDS";
+    ErrorCode["FETCH_FAILED"] = "FETCH_FAILED";
+    ErrorCode["PROCESSING_FAILED"] = "PROCESSING_FAILED";
+    ErrorCode["MODEL_NOT_FOUND"] = "MODEL_NOT_FOUND";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAkBjF,MAAM,CAAN,IAAY,SAQX;AARD,WAAY,SAAS;IACnB,4CAA+B,CAAA;IAC/B,sDAAyC,CAAA;IACzC,4CAA+B,CAAA;IAC/B,0CAA6B,CAAA;IAC7B,oDAAuC,CAAA;IACvC,gDAAmC,CAAA;IACnC,gCAAmB,CAAA;AACrB,CAAC,EARW,SAAS,KAAT,SAAS,QAQpB"}

package/dist/utils/load-image.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+import { ImageInput } from '../types.js';
+/**
+ * Resolves any ImageInput variant to a Buffer.
+ * Handles: Buffer (passthrough), URL (fetch), base64 data URI (decode), file path (readFile).
+ */
+export declare function loadImage(input: ImageInput): Promise<Buffer>;
+//# sourceMappingURL=load-image.d.ts.map

package/dist/utils/load-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-image.d.ts","sourceRoot":"","sources":["../../src/utils/load-image.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlE"}

package/dist/utils/load-image.js

@@ -0,0 +1,22 @@
+import { readFile } from 'fs/promises';
+import fetch from 'node-fetch';
+/**
+ * Resolves any ImageInput variant to a Buffer.
+ * Handles: Buffer (passthrough), URL (fetch), base64 data URI (decode), file path (readFile).
+ */
+export async function loadImage(input) {
+    if (Buffer.isBuffer(input))
+        return input;
+    if (input.startsWith('data:')) {
+        const base64 = input.split(',')[1];
+        return Buffer.from(base64, 'base64');
+    }
+    if (input.startsWith('http://') || input.startsWith('https://')) {
+        const res = await fetch(input);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        return Buffer.from(await res.arrayBuffer());
+    }
+    return readFile(input);
+}
+//# sourceMappingURL=load-image.js.map

package/dist/utils/load-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-image.js","sourceRoot":"","sources":["../../src/utils/load-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAiB;IAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/result.d.ts

@@ -0,0 +1,4 @@
+import { Ok, Err, ErrorCode } from '../types.js';
+export declare const ok: <T>(data: T) => Ok<T>;
+export declare const err: (error: string, code: ErrorCode) => Err;
+//# sourceMappingURL=result.d.ts.map

package/dist/utils/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEhD,eAAO,MAAM,EAAE,YAAa,CAAC,KAAG,GAAG,CAAC,CAAyB,CAAA;AAC7D,eAAO,MAAM,GAAG,UAAW,MAAM,QAAQ,SAAS,KAAG,GAAmC,CAAA"}

package/dist/utils/result.js

@@ -0,0 +1,3 @@
+export const ok = (data) => ({ ok: true, data });
+export const err = (error, code) => ({ ok: false, error, code });
+//# sourceMappingURL=result.js.map

package/dist/utils/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,EAAE,GAAG,CAAI,IAAO,EAAS,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;AAC7D,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,IAAe,EAAO,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA"}

package/dist/utils/validate.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Helper to ensure a value is a positive integer.
+ */
+export declare function isPositiveInt(val: any): boolean;
+/**
+ * Helper to get basic dimensions securely via sharp metadata
+ */
+export declare function getImageMetadata(buffer: Buffer): Promise<{
+    width: number;
+    height: number;
+    hasAlpha: boolean;
+    format: string;
+}>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":";;AAEA;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM;;;;;GAQpD"}

package/dist/utils/validate.js

@@ -0,0 +1,20 @@
+import sharp from 'sharp';
+/**
+ * Helper to ensure a value is a positive integer.
+ */
+export function isPositiveInt(val) {
+    return typeof val === 'number' && Number.isInteger(val) && val > 0;
+}
+/**
+ * Helper to get basic dimensions securely via sharp metadata
+ */
+export async function getImageMetadata(buffer) {
+    const metadata = await sharp(buffer).metadata();
+    return {
+        width: metadata.width ?? 0,
+        height: metadata.height ?? 0,
+        hasAlpha: metadata.hasAlpha ?? false,
+        format: metadata.format ?? 'unknown'
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChD,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,CAAC;QAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;QAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,KAAK;QACpC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,SAAS;KACrC,CAAC;AACJ,CAAC"}

package/docs/AGENTS.md

@@ -0,0 +1,18 @@
+# Guide for AI Agents
+
+Welcome, fellow AI agent! `image-edit-tools` is designed specifically for you to perform robust, deterministic image edits without writing custom scripts.
+
+## Core Tenets
+1. **Never Throw**: All tools return a guaranteed structured JSON response with either `{ ok: true, data: ... }` or `{ ok: false, error: ... }`. You don't need to wrap in `try/catch`.
+2. **Flexible Input**: For the `image` parameter, you can pass a URL, local file path, or Base64 data URI (e.g. `data:image/png;base64,...`).
+3. **Data URIs**: Results containing an image buffer are automatically encoded as Base64 Data URIs in the output `data` field, so you can immediate use them in downstream vision models or HTML.
+
+## Best Practices
+- **Pipelines**: Instead of calling `image_crop`, then `image_resize`, then `image_convert` using three separate tool calls (which transfers images back and forth 3 times), use the `image_pipeline` tool! Pass an array of operations. It is dramatically faster and avoids memory overhead.
+- **Analysis First**: When instructed to edit an image based on its content (e.g. "Blur the person's face"), first call `image_detect_faces`. Parse the coordinates, then construct an `image_blur_region` payload using exactly those coordinates.
+- **No Side Effects**: All tools are pure functions. They compute and return the image. If the user asks you to modify a file, you must take the data URI returned by the tool and write it back to the file system using your filesystem tools.
+
+## Example Chain (Watermarking)
+1. **Goal**: Add a bottom-right watermark.
+2. **Action**: Call `image_watermark` with `image: "/path/to/source.jpg"`, `type: "text"`, `text: "Draft"`, `position: "bottom-right"`.
+3. **Save**: Take `result.data` (Base64), decode it using standard encoding logic, and save it to the requested location.