image-edit-tools 1.0.5 → 1.0.6

package/src/ops/rotate.ts

@@ -0,0 +1,27 @@
+import sharp from 'sharp';
+import { RotateOptions, ImageInput, ImageResult, ErrorCode } from '../types.js';
+import { loadImage } from '../utils/load-image.js';
+import { err, ok } from '../utils/result.js';
+
+export async function rotate(input: ImageInput, options: RotateOptions): Promise<ImageResult> {
+  try {
+    const buffer = await loadImage(input);
+    const angle = options.angle % 360;
+
+    if (angle === 0) return ok(buffer);
+
+    const bgColor = options.background ?? { r: 0, g: 0, b: 0, alpha: 0 };
+    const background = typeof bgColor === 'string'
+      ? bgColor
+      : bgColor;
+
+    const output = await sharp(buffer)
+      .rotate(angle, { background })
+      .png()
+      .toBuffer();
+
+    return ok(output);
+  } catch (e: any) {
+    return err(e.message || 'Rotation failed', ErrorCode.PROCESSING_FAILED);
+  }
+}

package/src/types.ts

@@ -128,6 +128,12 @@ export interface TextLayer {
   maxWidth?: number;
   lineHeight?: number;
   background?: TextBackground;
+  /** Letter spacing in pixels. Default: 0 */
+  letterSpacing?: number;
+  /** Text stroke (outline) */
+  stroke?: { color: string; width: number };
+  /** Text shadow */
+  textShadow?: { color: string; offsetX: number; offsetY: number; blur?: number };
 }
 
 // ─── Composite ────────────────────────────────────────────────────────────────
@@ -245,6 +251,94 @@ export interface ImageMetadata {
   exif?: Record<string, unknown>;
 }
 
+// ─── Rotate ───────────────────────────────────────────────────────────────────
+
+export interface RotateOptions {
+  /** Rotation angle in degrees (0–360). Positive = clockwise. */
+  angle: number;
+  /** Background color for exposed areas. Default: 'transparent' */
+  background?: string;
+}
+
+// ─── GradientOverlay ──────────────────────────────────────────────────────────
+
+export type GradientDirection = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+
+export interface GradientOverlayOptions {
+  /** Direction the gradient fades FROM (opaque end). Default: 'bottom' */
+  direction?: GradientDirection;
+  /** Gradient color. Default: '#000000' */
+  color?: string;
+  /** Opacity of the opaque end. 0–1. Default: 0.7 */
+  opacity?: number;
+  /** How much of the image the gradient covers. 0–1. Default: 0.5 */
+  coverage?: number;
+}
+
+// ─── ClipToShape ──────────────────────────────────────────────────────────────
+
+export type ClipShape = 'circle' | 'ellipse' | 'rounded-rect';
+
+export interface ClipToShapeOptions {
+  shape: ClipShape;
+  /** Border radius for 'rounded-rect'. Default: 32 */
+  borderRadius?: number;
+}
+
+// ─── DrawShape ────────────────────────────────────────────────────────────────
+
+export type ShapeType = 'rect' | 'circle' | 'ellipse' | 'line';
+
+export interface DrawShapeOptions {
+  /** Canvas width */
+  width: number;
+  /** Canvas height */
+  height: number;
+  /** Shape to draw */
+  shape: ShapeType;
+  /** Fill color. Default: 'transparent' */
+  fill?: string;
+  /** Fill opacity. 0–1. Default: 1 */
+  fillOpacity?: number;
+  /** Stroke color */
+  stroke?: string;
+  /** Stroke width. Default: 0 */
+  strokeWidth?: number;
+  /** Border radius (rect only). Default: 0 */
+  borderRadius?: number;
+  /** Circle/ellipse center X. Defaults to canvas center */
+  cx?: number;
+  /** Circle/ellipse center Y. Defaults to canvas center */
+  cy?: number;
+  /** Circle radius or ellipse rx */
+  r?: number;
+  /** Ellipse ry */
+  ry?: number;
+  /** Line start X */
+  x1?: number;
+  /** Line start Y */
+  y1?: number;
+  /** Line end X */
+  x2?: number;
+  /** Line end Y */
+  y2?: number;
+}
+
+// ─── DropShadow ───────────────────────────────────────────────────────────────
+
+export interface DropShadowOptions {
+  /** Shadow color. Default: 'rgba(0,0,0,0.5)' */
+  color?: string;
+  /** Shadow offset X. Default: 4 */
+  offsetX?: number;
+  /** Shadow offset Y. Default: 4 */
+  offsetY?: number;
+  /** Blur radius. Default: 8 */
+  blur?: number;
+  /** Expand canvas to fit shadow. Default: true */
+  expand?: boolean;
+}
+
 // ─── Pipeline ─────────────────────────────────────────────────────────────────
 
 export type PipelineOperation =
@@ -259,9 +353,14 @@ export type PipelineOperation =
   | ({ op: 'watermark' } & WatermarkOptions)
   | ({ op: 'convert' } & ConvertOptions)
   | ({ op: 'optimize' } & OptimizeOptions)
-  | ({ op: 'removeBg' } & RemoveBgOptions);
+  | ({ op: 'removeBg' } & RemoveBgOptions)
+  | ({ op: 'rotate' } & RotateOptions)
+  | ({ op: 'gradientOverlay' } & GradientOverlayOptions)
+  | ({ op: 'clipToShape' } & ClipToShapeOptions)
+  | ({ op: 'dropShadow' } & DropShadowOptions);
 
 export interface BatchOptions {
   concurrency?: number;
   onProgress?: (done: number, total: number) => void;
 }
+

package/tests/unit/clip-to-shape.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import sharp from 'sharp'
+import { clipToShape } from '../../src/ops/clip-to-shape.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const fixture = (name: string) => readFileSync(join(__dirname, '../fixtures', name))
+
+describe('clipToShape', () => {
+  let sampleJpeg: Buffer
+
+  beforeAll(() => {
+    sampleJpeg = fixture('sample.jpg')
+  })
+
+  it('clips to circle', async () => {
+    const result = await clipToShape(sampleJpeg, { shape: 'circle' })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    expect(meta.hasAlpha).toBe(true)
+  })
+
+  it('clips to rounded-rect with custom radius', async () => {
+    const result = await clipToShape(sampleJpeg, { shape: 'rounded-rect', borderRadius: 64 })
+    expect(result.ok).toBe(true)
+  })
+
+  it('clips to ellipse', async () => {
+    const result = await clipToShape(sampleJpeg, { shape: 'ellipse' })
+    expect(result.ok).toBe(true)
+  })
+})

package/tests/unit/draw-shape.test.ts

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest'
+import sharp from 'sharp'
+import { drawShape } from '../../src/ops/draw-shape.js'
+
+describe('drawShape', () => {
+  it('draws a filled rect', async () => {
+    const result = await drawShape({ width: 200, height: 100, shape: 'rect', fill: '#FF0000', borderRadius: 16 })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    expect(meta.width).toBe(200)
+    expect(meta.height).toBe(100)
+  })
+
+  it('draws a circle with stroke', async () => {
+    const result = await drawShape({ width: 100, height: 100, shape: 'circle', fill: '#00FF00', stroke: '#000000', strokeWidth: 3 })
+    expect(result.ok).toBe(true)
+  })
+
+  it('draws an ellipse', async () => {
+    const result = await drawShape({ width: 200, height: 100, shape: 'ellipse', fill: '#0000FF' })
+    expect(result.ok).toBe(true)
+  })
+
+  it('draws a line', async () => {
+    const result = await drawShape({ width: 200, height: 200, shape: 'line', stroke: '#FF0000', strokeWidth: 4, x1: 10, y1: 10, x2: 190, y2: 190 })
+    expect(result.ok).toBe(true)
+  })
+
+  it('returns error for unknown shape', async () => {
+    const result = await drawShape({ width: 100, height: 100, shape: 'hexagon' as any })
+    expect(result.ok).toBe(false)
+  })
+})

package/tests/unit/drop-shadow.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import sharp from 'sharp'
+import { dropShadow } from '../../src/ops/drop-shadow.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const fixture = (name: string) => readFileSync(join(__dirname, '../fixtures', name))
+
+describe('dropShadow', () => {
+  let logoPng: Buffer
+
+  beforeAll(() => {
+    logoPng = fixture('logo.png') // 100x100
+  })
+
+  it('adds drop shadow with expanded canvas', async () => {
+    const result = await dropShadow(logoPng, { blur: 8, offsetX: 4, offsetY: 4 })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    // Canvas should be expanded
+    expect(meta.width).toBeGreaterThan(100)
+    expect(meta.height).toBeGreaterThan(100)
+  })
+
+  it('adds shadow without expanding canvas', async () => {
+    const result = await dropShadow(logoPng, { expand: false, blur: 4 })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    expect(meta.width).toBe(100)
+    expect(meta.height).toBe(100)
+  })
+
+  it('uses default options', async () => {
+    const result = await dropShadow(logoPng)
+    expect(result.ok).toBe(true)
+  })
+})

package/tests/unit/gradient-overlay.test.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { gradientOverlay } from '../../src/ops/gradient-overlay.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const fixture = (name: string) => readFileSync(join(__dirname, '../fixtures', name))
+
+describe('gradientOverlay', () => {
+  let sampleJpeg: Buffer
+
+  beforeAll(() => {
+    sampleJpeg = fixture('sample.jpg')
+  })
+
+  it('applies default bottom gradient', async () => {
+    const result = await gradientOverlay(sampleJpeg)
+    expect(result.ok).toBe(true)
+  })
+
+  it('applies gradient with custom direction and color', async () => {
+    const result = await gradientOverlay(sampleJpeg, {
+      direction: 'top-right', color: '#FF0000', opacity: 0.5, coverage: 0.8
+    })
+    expect(result.ok).toBe(true)
+  })
+})

package/tests/unit/rotate.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect, beforeAll } from 'vitest'
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import sharp from 'sharp'
+import { rotate } from '../../src/ops/rotate.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const fixture = (name: string) => readFileSync(join(__dirname, '../fixtures', name))
+
+describe('rotate', () => {
+  let sampleJpeg: Buffer
+
+  beforeAll(() => {
+    sampleJpeg = fixture('sample.jpg')
+  })
+
+  it('rotates 90 degrees', async () => {
+    const result = await rotate(sampleJpeg, { angle: 90 })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    // 400x300 rotated 90° → 300x400
+    expect(meta.width).toBe(300)
+    expect(meta.height).toBe(400)
+  })
+
+  it('rotates 45 degrees with transparent bg', async () => {
+    const result = await rotate(sampleJpeg, { angle: 45 })
+    expect(result.ok).toBe(true)
+    if (!result.ok) return
+    const meta = await sharp(result.data).metadata()
+    // Canvas expands for 45° rotation
+    expect(meta.width).toBeGreaterThan(400)
+  })
+
+  it('returns same buffer for 0 degrees', async () => {
+    const result = await rotate(sampleJpeg, { angle: 0 })
+    expect(result.ok).toBe(true)
+  })
+})