apexify.js 4.9.27 → 4.9.28

package/README.md

@@ -85,22 +85,24 @@ const canvas = await painter.createCanvas({
   borderRadius: 20
 });
 
-// Add a beautiful heart shape
+// Add a beautiful heart shape (single object)
 const heartImage = await painter.createImage({
   source: 'heart',
   x: 300,
   y: 200,
   width: 200,
   height: 200,
-  fill: true,
-  gradient: {
-    type: 'radial',
-    colors: [
-      { color: '#FF6B6B', position: 0 },
-      { color: '#FF1744', position: 1 }
-    ],
-    center: { x: 100, y: 100 },
-    radius: 100
+  shape: {
+    fill: true,
+    gradient: {
+      type: 'radial',
+      colors: [
+        { color: '#FF6B6B', position: 0 },
+        { color: '#FF1744', position: 1 }
+      ],
+      center: { x: 100, y: 100 },
+      radius: 100
+    }
   },
   shadow: {
     color: '#000',
@@ -112,9 +114,9 @@ const heartImage = await painter.createImage({
     color: '#FFF',
     width: 5
   }
-});
+}, canvas.buffer);
 
-// Add stunning text
+// Add stunning text (single object)
 const textImage = await painter.createText({
   text: 'ApexPainter',
   x: 400,
@@ -151,6 +153,75 @@ const textImage = await painter.createText({
 fs.writeFileSync('beautiful-artwork.png', textImage);
 ```
 
+### 📝 **Flexible Array Support**
+
+Both `createImage()` and `createText()` methods accept **single objects** OR **arrays of objects**:
+
+```typescript
+// ✅ Single Object
+await painter.createImage({
+  source: 'heart',
+  x: 100, y: 100,
+  width: 200, height: 200,
+  shape: { fill: true, color: '#ff6b6b' }
+}, canvasBuffer);
+
+// ✅ Array of Objects
+await painter.createImage([
+  {
+    source: 'rectangle',
+    x: 50, y: 50,
+    width: 100, height: 80,
+    shape: { fill: true, color: '#ff6b6b' }
+  },
+  {
+    source: 'circle',
+    x: 200, y: 50,
+    width: 80, height: 80,
+    shape: { fill: true, color: '#4ecdc4' }
+  },
+  {
+    source: 'star',
+    x: 350, y: 50,
+    width: 80, height: 80,
+    shape: { fill: true, color: '#45b7d1' }
+  }
+], canvasBuffer);
+
+// ✅ Single Text Object
+await painter.createText({
+  text: 'Hello World',
+  x: 100, y: 100,
+  fontSize: 24,
+  color: '#ff6b6b'
+}, canvasBuffer);
+
+// ✅ Array of Text Objects
+await painter.createText([
+  {
+    text: 'Title',
+    x: 100, y: 50,
+    fontSize: 32,
+    bold: true,
+    color: '#2c3e50'
+  },
+  {
+    text: 'Subtitle',
+    x: 100, y: 100,
+    fontSize: 18,
+    color: '#666'
+  },
+  {
+    text: 'Body text with effects',
+    x: 100, y: 150,
+    fontSize: 14,
+    color: '#333',
+    glow: { color: '#ffd700', intensity: 0.5 },
+    shadow: { color: '#000', offsetX: 2, offsetY: 2, blur: 4 }
+  }
+], canvasBuffer);
+```
+
 ---
 
 ## 🎯 Real-World Examples
@@ -273,11 +344,19 @@ const buttonText = await painter.createText({
 | Method | Description | Parameters |
 |--------|-------------|------------|
 | `createCanvas()` | Create a new canvas with background | `CanvasConfig` |
-| `createImage()` | Add shapes/images to canvas | `ImageProperties` |
-| `createText()` | Add text to canvas | `TextProperties` |
+| `createImage()` | Add shapes/images to canvas | `ImageProperties \| ImageProperties[]` |
+| `createText()` | Add text to canvas | `TextProperties \| TextProperties[]` |
 | `createChart()` | Generate charts | `ChartConfig` |
 | `createGIF()` | Create animated GIFs | `GIFConfig` |
 
+### 🔄 **Flexible Parameters**
+
+Both `createImage()` and `createText()` methods accept:
+- **Single Object**: `ImageProperties` or `TextProperties`
+- **Array of Objects**: `ImageProperties[]` or `TextProperties[]`
+
+This allows you to add multiple elements in one call for better performance and cleaner code.
+
 ### Shape Types
 
 - `rectangle` - Standard rectangle

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apexify.js",
-  "version": "4.9.27",
+  "version": "4.9.28",
   "description": "🎨 Advanced Canvas Rendering Library - Professional image processing, shape drawing, text effects, patterns, filters, and charts. Built with TypeScript & Rust for high performance.",
   "author": "zenith-79",
   "license": "MIT",