image-edit-tools 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+docs/** linguist-generated=true
+*-lock.json linguist-generated=true

package/README.md

@@ -0,0 +1,41 @@
+# Image Edit Tools
+
+A TypeScript-first, deterministic, purely functional image editing SDK designed for AI Agents (Cursor, Windsurf, Claude).
+
+- **Pure Functions**: No side effects, no mutations, all strict structural typing.
+- **Agent Native**: Includes a built-in Model Context Protocol (MCP) server so AI agents can use all operations natively!
+- **Never Throws**: Every function returns `{ok, data}` or `{ok, false, error}`.
+- **Versatile**: Crop, resize, pad, adjust colors, watermark, composite, AI background removal, OCR, face detection, and more.
+
+## Installation
+```bash
+npm install image-edit-tools
+```
+
+## Quick Start (Code)
+```typescript
+import { crop, resize, pad } from 'image-edit-tools';
+
+const result = await resize('/path/to/img.jpg', { width: 800 });
+if (!result.ok) {
+    console.error(result.error);
+    return;
+}
+// Returns a Buffer.
+// Can be saved, piped, or passed explicitly!
+```
+
+## Running the MCP Server
+If you are an AI assistant integrating this context provider natively:
+```json
+{
+  "mcpServers": {
+    "image-edit-tools": {
+      "command": "npx",
+      "args": ["-y", "image-edit-tools"]
+    }
+  }
+}
+```
+
+Learn more about mapping AI behaviors in [AGENTS.md](./docs/AGENTS.md).

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export * from './types.js';
+export * from './utils/result.js';
+export * from './utils/load-image.js';
+export { crop } from './ops/crop.js';
+export { resize } from './ops/resize.js';
+export { pad } from './ops/pad.js';
+export { adjust } from './ops/adjust.js';
+export { filter } from './ops/filter.js';
+export { blurRegion } from './ops/blur-region.js';
+export { addText } from './ops/add-text.js';
+export { composite } from './ops/composite.js';
+export { watermark } from './ops/watermark.js';
+export { overlay } from './ops/overlay.js';
+export { removeBg } from './ops/remove-bg.js';
+export { detectSubject } from './ops/detect-subject.js';
+export { convert } from './ops/convert.js';
+export { optimize } from './ops/optimize.js';
+export { getMetadata } from './ops/get-metadata.js';
+export { getDominantColors } from './ops/get-dominant-colors.js';
+export { detectFaces } from './ops/detect-faces.js';
+export { extractText } from './ops/extract-text.js';
+export { pipeline } from './ops/pipeline.js';
+export { batch } from './ops/batch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+export * from './types.js';
+export * from './utils/result.js';
+export * from './utils/load-image.js';
+export { crop } from './ops/crop.js';
+export { resize } from './ops/resize.js';
+export { pad } from './ops/pad.js';
+export { adjust } from './ops/adjust.js';
+export { filter } from './ops/filter.js';
+export { blurRegion } from './ops/blur-region.js';
+export { addText } from './ops/add-text.js';
+export { composite } from './ops/composite.js';
+export { watermark } from './ops/watermark.js';
+export { overlay } from './ops/overlay.js';
+export { removeBg } from './ops/remove-bg.js';
+export { detectSubject } from './ops/detect-subject.js';
+export { convert } from './ops/convert.js';
+export { optimize } from './ops/optimize.js';
+export { getMetadata } from './ops/get-metadata.js';
+export { getDominantColors } from './ops/get-dominant-colors.js';
+export { detectFaces } from './ops/detect-faces.js';
+export { extractText } from './ops/extract-text.js';
+export { pipeline } from './ops/pipeline.js';
+export { batch } from './ops/batch.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,aAAa,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import './server.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,aAAa,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":""}

package/dist/mcp/server.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { allTools, handleTool } from './tools.js';
+const server = new Server({ name: 'image-edit-tools', version: '1.0.0' }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: allTools }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    const text = await handleTool(name, args ?? {});
+    return { content: [{ type: 'text', text }] };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAA;AAClG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAA;AAED,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;AAEnF,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AAC9C,CAAC,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA"}

package/dist/mcp/tools.d.ts

@@ -0,0 +1,4 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const allTools: Tool[];
+export declare function handleTool(name: string, args: Record<string, any>): Promise<string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI1D,eAAO,MAAM,QAAQ,EAAE,IAAI,EA0N1B,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDzF"}

package/dist/mcp/tools.js

@@ -0,0 +1,285 @@
+import * as api from '../index.js';
+export const allTools = [
+    {
+        name: 'image_crop',
+        description: 'Crops an image. Supports absolute coords, ratio, aspect ratio, or subject mode.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string', description: 'Base64 data URI, HTTP URL, or local path' },
+                mode: { type: 'string', enum: ['absolute', 'ratio', 'aspect', 'subject'] },
+                x: { type: 'number' }, y: { type: 'number' }, width: { type: 'number' }, height: { type: 'number' },
+                left: { type: 'number' }, top: { type: 'number' }, right: { type: 'number' }, bottom: { type: 'number' },
+                aspectRatio: { type: 'string' }, anchor: { type: 'string' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_resize',
+        description: 'Resizes an image. Specify width/height or a scale multiplier.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                width: { type: 'number' }, height: { type: 'number' }, scale: { type: 'number' },
+                fit: { type: 'string', enum: ['cover', 'contain', 'fill', 'inside', 'outside'] },
+                kernel: { type: 'string' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_pad',
+        description: 'Pads an image edges. Supports absolute edges or square target size with custom color.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                top: { type: 'number' }, right: { type: 'number' }, bottom: { type: 'number' }, left: { type: 'number' },
+                size: { type: 'number' }, color: { type: 'string' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_adjust',
+        description: 'Adjusts brightness, contrast, saturation, hue, sharpness, and temperature (-100 to 100).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                brightness: { type: 'number', description: 'Range: -100 to 100' },
+                contrast: { type: 'number', description: 'Range: -100 to 100' },
+                saturation: { type: 'number', description: 'Range: -100 to 100' },
+                hue: { type: 'number', description: 'Range: 0 to 360' },
+                sharpness: { type: 'number', description: 'Range: 0 to 100' },
+                temperature: { type: 'number', description: 'Range: -100 to 100' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_filter',
+        description: 'Applies preset filters: grayscale, sepia, invert, vintage, unsharp, or blur with radius.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                preset: { type: 'string', enum: ['grayscale', 'sepia', 'invert', 'vintage', 'unsharp', 'blur'] },
+                radius: { type: 'number' }
+            },
+            required: ['image', 'preset']
+        }
+    },
+    {
+        name: 'image_blur_region',
+        description: 'Blurs specific absolute regions in the image.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                regions: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            x: { type: 'number' }, y: { type: 'number' },
+                            width: { type: 'number' }, height: { type: 'number' },
+                            radius: { type: 'number', description: 'Blur radius' }
+                        },
+                        required: ['x', 'y', 'width', 'height']
+                    }
+                }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_add_text',
+        description: 'Adds text layers. Requires x, y, text, font size, and optional alignment parameters.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                layers: { type: 'array', items: { type: 'object' } }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_composite',
+        description: 'Composites images together with blend modes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                layers: { type: 'array', items: { type: 'object' } }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_watermark',
+        description: 'Applies watermarks either text or image at discrete positions or tiled.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                type: { type: 'string', enum: ['text', 'image'] },
+                text: { type: 'string' }, imageLayer: { type: 'string' },
+                position: { type: 'string' }, opacity: { type: 'number' }
+            },
+            required: ['image', 'type']
+        }
+    },
+    {
+        name: 'image_remove_bg',
+        description: 'Removes background using AI model RMBG-1.4. Optionally replaces with color or image.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                replaceColor: { type: 'string' },
+                replaceImage: { type: 'string' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_convert',
+        description: 'Converts image to jpeg, png, webp, avif, or gif.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                format: { type: 'string', enum: ['jpeg', 'png', 'webp', 'avif', 'gif'] },
+                quality: { type: 'number' },
+                stripMetadata: { type: 'boolean' }
+            },
+            required: ['image', 'format']
+        }
+    },
+    {
+        name: 'image_optimize',
+        description: 'Optimizes an image to fit max size in KB or max dimension.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                maxSizeKB: { type: 'number' }, maxDimension: { type: 'number' }, autoFormat: { type: 'boolean' }
+            },
+            required: ['image']
+        }
+    },
+    {
+        name: 'image_get_metadata',
+        description: 'Returns image metadata like dimensions, format, hasAlpha.',
+        inputSchema: { type: 'object', properties: { image: { type: 'string' } }, required: ['image'] }
+    },
+    {
+        name: 'image_get_dominant_colors',
+        description: 'Returns hex values of the primary colors in the image.',
+        inputSchema: { type: 'object', properties: { image: { type: 'string' }, count: { type: 'number' } }, required: ['image'] }
+    },
+    {
+        name: 'image_detect_faces',
+        description: 'Detects bounding boxes around faces/people in the image using AI.',
+        inputSchema: { type: 'object', properties: { image: { type: 'string' } }, required: ['image'] }
+    },
+    {
+        name: 'image_extract_text',
+        description: 'Runs OCR using tesseract.js to extract text from the image.',
+        inputSchema: { type: 'object', properties: { image: { type: 'string' }, lang: { type: 'string' } }, required: ['image'] }
+    },
+    {
+        name: 'image_pipeline',
+        description: 'Runs a sequence of operations on the image seamlessly in memory.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                image: { type: 'string' },
+                operations: { type: 'array', items: { type: 'object' } }
+            },
+            required: ['image', 'operations']
+        }
+    },
+    {
+        name: 'image_batch',
+        description: 'Runs a single operation on multiple images.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                images: { type: 'array', items: { type: 'string' } },
+                operation: { type: 'string' },
+                options: { type: 'object' }
+            },
+            required: ['images', 'operation', 'options']
+        }
+    }
+];
+export async function handleTool(name, args) {
+    const image = args.image;
+    let result;
+    if (name === 'image_pipeline')
+        result = await api.pipeline(image, args.operations);
+    else if (name === 'image_batch')
+        result = await api.batch(args.images, args.operation, args.options);
+    else if (name === 'image_crop')
+        result = await api.crop(image, args);
+    else if (name === 'image_resize')
+        result = await api.resize(image, args);
+    else if (name === 'image_pad')
+        result = await api.pad(image, args);
+    else if (name === 'image_adjust')
+        result = await api.adjust(image, args);
+    else if (name === 'image_filter')
+        result = await api.filter(image, args);
+    else if (name === 'image_blur_region')
+        result = await api.blurRegion(image, args);
+    else if (name === 'image_add_text')
+        result = await api.addText(image, args);
+    else if (name === 'image_composite')
+        result = await api.composite(image, args);
+    else if (name === 'image_watermark') {
+        const opts = { ...args };
+        if (opts.type === 'image' && opts.imageLayer)
+            opts.image = opts.imageLayer;
+        result = await api.watermark(image, opts);
+    }
+    else if (name === 'image_remove_bg')
+        result = await api.removeBg(image, args);
+    else if (name === 'image_convert')
+        result = await api.convert(image, args);
+    else if (name === 'image_optimize')
+        result = await api.optimize(image, args);
+    else if (name === 'image_get_metadata') {
+        const meta = await api.getMetadata(image);
+        return JSON.stringify(meta.ok ? meta.data : { error: meta.error, code: meta.code });
+    }
+    else if (name === 'image_get_dominant_colors') {
+        const cols = await api.getDominantColors(image, args.count);
+        return JSON.stringify(cols);
+    }
+    else if (name === 'image_detect_faces') {
+        const faces = await api.detectFaces(image);
+        return JSON.stringify(faces);
+    }
+    else if (name === 'image_extract_text') {
+        const txt = await api.extractText(image, args);
+        return JSON.stringify(txt);
+    }
+    else {
+        return JSON.stringify({ error: `Tool ${name} not implemented`, code: 'INVALID_INPUT' });
+    }
+    if (result && !result.ok) {
+        return JSON.stringify({ error: result.error, code: result.code });
+    }
+    else if (result && Buffer.isBuffer(result.data)) {
+        const fmt = args.format || 'png';
+        const b64 = result.data.toString('base64');
+        return JSON.stringify({ ok: true, data: `data:image/${fmt};base64,${b64}` });
+    }
+    return JSON.stringify(result);
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/ops/add-text.d.ts

@@ -0,0 +1,5 @@
+import { TextLayer, ImageInput, ImageResult } from '../types.js';
+export declare function addText(input: ImageInput, options: {
+    layers: TextLayer[];
+}): Promise<ImageResult>;
+//# sourceMappingURL=add-text.d.ts.map

package/dist/ops/add-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-text.d.ts","sourceRoot":"","sources":["../../src/ops/add-text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AA4CxF,wBAAsB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CA6FvG"}

package/dist/ops/add-text.js

@@ -0,0 +1,129 @@
+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';
+function wrapText(text, fontSize, maxWidth) {
+    if (!maxWidth)
+        return [text];
+    const charWidth = fontSize * 0.6; // Approximation
+    const maxChars = Math.max(1, Math.floor(maxWidth / charWidth));
+    const words = text.split(' ');
+    const lines = [];
+    let currentLine = '';
+    for (const word of words) {
+        if ((currentLine + ' ' + word).trim().length <= maxChars) {
+            currentLine = (currentLine + ' ' + word).trim();
+        }
+        else {
+            if (currentLine)
+                lines.push(currentLine);
+            currentLine = word;
+        }
+    }
+    if (currentLine)
+        lines.push(currentLine);
+    return lines;
+}
+function getAnchorProps(anchor = 'top-left') {
+    const parts = anchor.split('-');
+    const yAlign = parts.length === 2 ? parts[0] : parts[0] === 'center' ? 'middle' : parts[0];
+    const xAlign = parts.length === 2 ? parts[1] : parts[0] === 'center' ? 'center' : 'left';
+    let dominantBaseline = 'hanging'; // top
+    if (yAlign === 'bottom')
+        dominantBaseline = 'auto'; // bottom is harder, usually means using y directly on baseline, but we can do mathematical offset. We'll rely on SVG baselines.
+    else if (yAlign === 'middle' || yAlign === 'center')
+        dominantBaseline = 'middle';
+    else if (yAlign === 'auto')
+        dominantBaseline = 'auto';
+    // Sharp's librsvg supports dominant-baseline: text-before-edge (top), middle, alphabetic (bottom)
+    const baselineMap = { top: 'text-before-edge', middle: 'middle', bottom: 'alphabetic', center: 'middle' };
+    let textAnchor = 'start';
+    if (xAlign === 'center')
+        textAnchor = 'middle';
+    else if (xAlign === 'right')
+        textAnchor = 'end';
+    return { textAnchor, dominantBaseline: baselineMap[yAlign] || 'text-before-edge' };
+}
+export async function addText(input, options) {
+    try {
+        const buffer = await loadImage(input);
+        const meta = await getImageMetadata(buffer);
+        if (!options.layers || !Array.isArray(options.layers)) {
+            return err('Layers array required', ErrorCode.INVALID_INPUT);
+        }
+        const { width, height } = meta;
+        let defs = '';
+        let svgBody = '';
+        let fontImports = new Set();
+        for (let i = 0; i < options.layers.length; i++) {
+            const layer = options.layers[i];
+            const fontSize = layer.fontSize ?? 24;
+            const color = layer.color ?? '#000000';
+            const opacity = layer.opacity ?? 1.0;
+            const fontFamily = layer.fontFamily ?? 'sans-serif';
+            if (layer.fontUrl)
+                fontImports.add(`@import url('${layer.fontUrl}');`);
+            const lines = wrapText(layer.text, fontSize, layer.maxWidth);
+            const lineHeight = layer.lineHeight ?? 1.2;
+            const totalHeight = lines.length * fontSize * lineHeight;
+            const approxMaxWidth = Math.max(...lines.map(l => l.length * fontSize * 0.6));
+            const { textAnchor, dominantBaseline } = getAnchorProps(layer.anchor);
+            let align = textAnchor;
+            if (layer.align) {
+                align = layer.align === 'left' ? 'start' : layer.align === 'right' ? 'end' : 'middle';
+            }
+            const style = `font-family: ${fontFamily}; font-size: ${fontSize}px; fill: ${color}; opacity: ${opacity}; text-anchor: ${align}; dominant-baseline: ${dominantBaseline};`;
+            let layerSvg = '';
+            if (layer.background) {
+                const bg = layer.background;
+                const pad = bg.padding ?? 0;
+                const bgOpacity = bg.opacity ?? 1.0;
+                const radius = bg.borderRadius ?? 0;
+                let rectX = layer.x - pad;
+                let rectY = layer.y - pad;
+                if (textAnchor === 'middle') {
+                    rectX = layer.x - (approxMaxWidth / 2) - pad;
+                }
+                else if (textAnchor === 'end') {
+                    rectX = layer.x - approxMaxWidth - pad;
+                }
+                if (dominantBaseline === 'middle') {
+                    rectY = layer.y - (totalHeight / 2) - pad;
+                }
+                else if (dominantBaseline === 'alphabetic') { // bottom
+                    rectY = layer.y - totalHeight - pad + fontSize;
+                }
+                layerSvg += `<rect x="${rectX}" y="${rectY}" width="${approxMaxWidth + pad * 2}" height="${totalHeight + pad * 2}" fill="${bg.color}" opacity="${bgOpacity}" rx="${radius}" ry="${radius}" />`;
+            }
+            layerSvg += `<text x="${layer.x}" y="${layer.y}" style="${style}">`;
+            lines.forEach((line, idx) => {
+                let dy = idx === 0 ? 0 : fontSize * lineHeight;
+                layerSvg += `<tspan x="${layer.x}" dy="${dy}">${line}</tspan>`;
+            });
+            layerSvg += `</text>`;
+            svgBody += `<g style="isolation: isolate">${layerSvg}</g>`;
+        }
+        const fontStyle = fontImports.size > 0 ? `<style>${Array.from(fontImports).join('\n')}</style>` : '';
+        const svgString = `<svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      ${fontStyle}
+      ${defs}
+      ${svgBody}
+    </svg>`;
+        const output = await sharp(buffer)
+            .composite([{ input: Buffer.from(svgString), blend: 'over' }])
+            .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=add-text.js.map

package/dist/ops/add-text.js.map

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

package/dist/ops/adjust.d.ts

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

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

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