apexify.js 4.9.30 → 5.0.1

package/dist/cjs/Canvas/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/Canvas/utils/utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAKH,wCAA0I;AA2BtI,oGA3BK,wBAAmB,OA2BL;AACnB,uGA5B0B,2BAAsB,OA4B1B;AACtB,iGA7BkD,qBAAgB,OA6BlD;AA+BhB,gGA5DoE,oBAAe,OA4DpE;AACf,4FA7DqF,gBAAW,OA6DrF;AACX,2FA9DkG,eAAU,OA8DlG;AA7Dd,6DAA6J;AAkDzJ,0FAlDK,2BAAS,OAkDL;AACT,8FAnDgB,+BAAa,OAmDhB;AACb,mGApD+B,oCAAkB,OAoD/B;AAClB,wFArDmD,yBAAO,OAqDnD;AAAE,gGArDmD,iCAAe,OAqDnD;AACxB,4FAtD6E,6BAAW,OAsD7E;AAEX,kGAxD0F,mCAAiB,OAwD1F;AADjB,4FAvD6G,6BAAW,OAuD7G;AAtDf,uDAAwD;AAmEpD,kGAnEK,gCAAiB,OAmEL;AAlErB,iFAAkF;AAmE9E,+GAnEK,0DAA8B,OAmEL;AAlElC,2DAA+D;AA0B3D,yFA1BK,yBAAQ,OA0BL;AACR,4FA3Be,4BAAW,OA2Bf;AA1Bf,mEAA4K;AA2BxK,2FA3BK,8BAAU,OA2BL;AACV,4FA5BiB,+BAAW,OA4BjB;AACX,0FA7B8B,6BAAS,OA6B9B;AACT,kGA9ByC,qCAAiB,OA8BzC;AACjB,2FA/B4D,8BAAU,OA+B5D;AAKV,0FApCwE,6BAAS,OAoCxE;AADT,0FAnCmF,6BAAS,OAmCnF;AAET,6FArC8F,gCAAY,OAqC9F;AACZ,4FAtC4G,+BAAW,OAsC5G;AACX,0FAvCyH,6BAAS,OAuCzH;AAtCb,sDAAmD;AAoB/C,4FApBK,yBAAW,OAoBL;AAnBf,4CAAuE;AA8BnE,iGA9BK,yBAAgB,OA8BL;AAChB,yFA/BuB,iBAAQ,OA+BvB;AACR,0FAhCiC,kBAAS,OAgCjC;AA/Bb,qDAAgF;AAI5E,oFAJK,gBAAG,OAIL;AAEH,4FANU,wBAAW,OAMV;AACX,uFAPuB,mBAAM,OAOvB;AACN,wFAR+B,oBAAO,OAQ/B;AACP,qFATwC,iBAAI,OASxC;AARR,4CAA4E;AAyDxE,0FAzDK,kBAAS,OAyDL;AACT,8FA1DgB,sBAAa,OA0DhB;AACb,gGA3D+B,wBAAe,OA2D/B"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/Canvas/utils/utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;AAKH,wCAA0I;AAkCtI,oGAlCK,wBAAmB,OAkCL;AACnB,uGAnC0B,2BAAsB,OAmC1B;AACtB,iGApCkD,qBAAgB,OAoClD;AA+BhB,gGAnEoE,oBAAe,OAmEpE;AACf,4FApEqF,gBAAW,OAoErF;AACX,2FArEkG,eAAU,OAqElG;AApEd,6DAA6J;AAyDzJ,0FAzDK,2BAAS,OAyDL;AACT,8FA1DgB,+BAAa,OA0DhB;AACb,mGA3D+B,oCAAkB,OA2D/B;AAClB,wFA5DmD,yBAAO,OA4DnD;AAAE,gGA5DmD,iCAAe,OA4DnD;AACxB,4FA7D6E,6BAAW,OA6D7E;AAEX,kGA/D0F,mCAAiB,OA+D1F;AADjB,4FA9D6G,6BAAW,OA8D7G;AA7Df,uDAAwD;AA0EpD,kGA1EK,gCAAiB,OA0EL;AAzErB,iFAAkF;AA0E9E,+GA1EK,0DAA8B,OA0EL;AAzElC,2DAA+D;AAiC3D,yFAjCK,yBAAQ,OAiCL;AACR,4FAlCe,4BAAW,OAkCf;AAjCf,mEAA4K;AAkCxK,2FAlCK,8BAAU,OAkCL;AACV,4FAnCiB,+BAAW,OAmCjB;AACX,0FApC8B,6BAAS,OAoC9B;AACT,kGArCyC,qCAAiB,OAqCzC;AACjB,2FAtC4D,8BAAU,OAsC5D;AAKV,0FA3CwE,6BAAS,OA2CxE;AADT,0FA1CmF,6BAAS,OA0CnF;AAET,6FA5C8F,gCAAY,OA4C9F;AACZ,4FA7C4G,+BAAW,OA6C5G;AACX,0FA9CyH,6BAAS,OA8CzH;AA7Cb,sDAAmD;AA2B/C,4FA3BK,yBAAW,OA2BL;AA1Bf,4CAAuE;AAqCnE,iGArCK,yBAAgB,OAqCL;AAChB,yFAtCuB,iBAAQ,OAsCvB;AACR,0FAvCiC,kBAAS,OAuCjC;AAtCb,qDAAgF;AAW5E,oFAXK,gBAAG,OAWL;AAEH,4FAbU,wBAAW,OAaV;AACX,uFAduB,mBAAM,OAcvB;AACN,wFAf+B,oBAAO,OAe/B;AACP,qFAhBwC,iBAAI,OAgBxC;AAfR,4CAA4E;AAgExE,0FAhEK,kBAAS,OAgEL;AACT,8FAjEgB,sBAAa,OAiEhB;AACb,gGAlE+B,wBAAe,OAkE/B;AAjEnB,uDAAsI;AAwElI,+FAxEK,6BAAc,OAwEL;AACd,8FAzEqB,4BAAa,OAyErB;AACb,2GA1EoC,yCAA0B,OA0EpC;AAC1B,qGA3EgE,mCAAoB,OA2EhE;AACpB,8FA5EsF,4BAAa,OA4EtF;AA3EjB,uDAA+G;AA6E3G,8FA7EK,4BAAa,OA6EL;AACb,+FA9EoB,6BAAc,OA8EpB;AACd,yGA/EoC,uCAAwB,OA+EpC;AACxB,+FAhF8D,6BAAc,OAgF9D;AA/ElB,+DAA4D;AAiFxD,iGAjFK,mCAAgB,OAiFL;AAhFpB,0DAA+J;AAkF3J,0FAlFK,yBAAS,OAkFL;AACT,2FAnFgB,0BAAU,OAmFhB;AACV,iGApF4B,gCAAgB,OAoF5B;AAChB,qGArF8C,oCAAoB,OAqF9C;AACpB,iGAtFoE,gCAAgB,OAsFpE;AAChB,iGAvFsF,gCAAgB,OAuFtF;AAChB,mGAxFwG,kCAAkB,OAwFxG;AAvFtB,+DAA6E;AAyFzE,gGAzFK,iCAAe,OAyFL;AACf,gGA1FsB,iCAAe,OA0FtB;AAzFnB,6DAAuE;AA2FnE,6FA3FK,6BAAY,OA2FL;AACZ,8FA5FmB,8BAAa,OA4FnB;AA3FjB,iEAA2E;AA6FvE,8FA7FK,gCAAa,OA6FL;AACb,+FA9FoB,iCAAc,OA8FpB"}

package/dist/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../lib/index.ts","../../lib/utils.ts","../../lib/canvas/apexpainter.ts","../../lib/canvas/utils/types.ts","../../lib/canvas/utils/utils.ts","../../lib/canvas/utils/background/bg.ts","../../lib/canvas/utils/charts/charts.ts","../../lib/canvas/utils/custom/customlines.ts","../../lib/canvas/utils/general/conversion.ts","../../lib/canvas/utils/general/general functions.ts","../../lib/canvas/utils/image/imagefilters.ts","../../lib/canvas/utils/image/imageproperties.ts","../../lib/canvas/utils/image/professionalimagefilters.ts","../../lib/canvas/utils/image/simpleprofessionalfilters.ts","../../lib/canvas/utils/patterns/enhancedpatternrenderer.ts","../../lib/canvas/utils/shapes/shapes.ts","../../lib/canvas/utils/texts/enhancedtextrenderer.ts","../../lib/canvas/utils/texts/textproperties.ts"],"version":"5.7.3"}
+{"root":["../../lib/index.ts","../../lib/utils.ts","../../lib/canvas/apexpainter.ts","../../lib/canvas/utils/types.ts","../../lib/canvas/utils/utils.ts","../../lib/canvas/utils/background/bg.ts","../../lib/canvas/utils/charts/charts.ts","../../lib/canvas/utils/custom/advancedlines.ts","../../lib/canvas/utils/custom/customlines.ts","../../lib/canvas/utils/general/batchoperations.ts","../../lib/canvas/utils/general/conversion.ts","../../lib/canvas/utils/general/general functions.ts","../../lib/canvas/utils/general/imagecompression.ts","../../lib/canvas/utils/general/imagestitching.ts","../../lib/canvas/utils/image/imageeffects.ts","../../lib/canvas/utils/image/imagefilters.ts","../../lib/canvas/utils/image/imagemasking.ts","../../lib/canvas/utils/image/imageproperties.ts","../../lib/canvas/utils/image/professionalimagefilters.ts","../../lib/canvas/utils/image/simpleprofessionalfilters.ts","../../lib/canvas/utils/patterns/enhancedpatternrenderer.ts","../../lib/canvas/utils/shapes/shapes.ts","../../lib/canvas/utils/texts/enhancedtextrenderer.ts","../../lib/canvas/utils/texts/textpathrenderer.ts","../../lib/canvas/utils/texts/textproperties.ts","../../types/imgur.d.ts"],"version":"5.9.2"}

package/dist/esm/Canvas/ApexPainter.d.ts

@@ -1,5 +1,5 @@
 import { PathLike } from "fs";
-import { OutputFormat, CanvasConfig, TextProperties, ImageProperties, GIFOptions, GIFResults, CustomOptions, cropOptions, Frame, ExtractFramesOptions, ResizeOptions, MaskOptions, BlendOptions } from "./utils/utils";
+import { OutputFormat, CanvasConfig, TextProperties, ImageProperties, GIFOptions, GIFResults, CustomOptions, cropOptions, GradientConfig, Frame, ExtractFramesOptions, ResizeOptions, MaskOptions, BlendOptions, ImageFilter, BatchOperation, ChainOperation, StitchOptions, CollageLayout, CompressionOptions, PaletteOptions, SaveOptions, SaveResult } from "./utils/utils";
 interface CanvasResults {
     buffer: Buffer;
     canvas: CanvasConfig;
@@ -7,146 +7,23 @@ interface CanvasResults {
 export declare class ApexPainter {
     #private;
     private format?;
+    private saveCounter;
     constructor({ type }?: OutputFormat);
-    /**
-     * Creates a canvas with the given configuration.
-     * Applies rotation, shadow, border effects, background, and stroke.
-     *
-     * @param canvas - Canvas configuration object containing:
-     *   - width: Canvas width in pixels
-     *   - height: Canvas height in pixels
-     *   - x: X position offset (default: 0)
-     *   - y: Y position offset (default: 0)
-     *   - colorBg: Solid color background (hex, rgb, rgba, hsl, etc.)
-     *   - gradientBg: Gradient background configuration
-     *   - customBg: Custom background image buffer
-     *   - zoom: Canvas zoom level (default: 1)
-     *   - pattern: Pattern background configuration
-     *   - noise: Noise effect configuration
-     *
-     * @returns Promise<CanvasResults> - Object containing canvas buffer and configuration
-     *
-     * @throws Error if canvas configuration is invalid or conflicting
-     *
-     * @example
-     * ```typescript
-     * const result = await painter.createCanvas({
-     *   width: 800,
-     *   height: 600,
-     *   colorBg: '#ffffff',
-     *   zoom: 1.5
-     * });
-     * const buffer = result.buffer;
-     * ```
-     */
     createCanvas(canvas: CanvasConfig): Promise<CanvasResults>;
-    /**
-     * Draws one or more images (or shapes) on an existing canvas buffer.
-     *
-     * @param images - Single ImageProperties object or array of ImageProperties containing:
-     *   - source: Image path/URL/Buffer or ShapeType ('rectangle', 'circle', etc.)
-     *   - x: X position on canvas
-     *   - y: Y position on canvas
-     *   - width: Image/shape width (optional, defaults to original size)
-     *   - height: Image/shape height (optional, defaults to original size)
-     *   - inherit: Use original image dimensions (boolean)
-     *   - fit: Image fitting mode ('fill', 'contain', 'cover', 'scale-down', 'none')
-     *   - align: Image alignment ('center', 'start', 'end')
-     *   - rotation: Rotation angle in degrees (default: 0)
-     *   - opacity: Opacity level 0-1 (default: 1)
-     *   - blur: Blur radius in pixels (default: 0)
-     *   - borderRadius: Border radius or 'circular' (default: 0)
-     *   - borderPosition: Border position ('all', 'top', 'bottom', 'left', 'right')
-     *   - filters: Array of image filters to apply
-     *   - shape: Shape properties (when source is a shape)
-     *   - shadow: Shadow configuration
-     *   - stroke: Stroke configuration
-     *   - boxBackground: Background behind image/shape
-     *
-     * @param canvasBuffer - Existing canvas buffer (Buffer) or CanvasResults object
-     *
-     * @returns Promise<Buffer> - Updated canvas buffer in PNG format
-     *
-     * @throws Error if source, x, or y are missing
-     *
-     * @example
-     * ```typescript
-     * const result = await painter.createImage([
-     *   {
-     *     source: 'rectangle',
-     *     x: 100, y: 100,
-     *     width: 200, height: 150,
-     *     shape: { fill: true, color: '#ff6b6b' },
-     *     shadow: { color: 'rgba(0,0,0,0.3)', offsetX: 5, offsetY: 5, blur: 10 }
-     *   }
-     * ], canvasBuffer);
-     * ```
-     */
     createImage(images: ImageProperties | ImageProperties[], canvasBuffer: CanvasResults | Buffer): Promise<Buffer>;
-    /**
-     * Creates text on an existing canvas buffer with enhanced styling options.
-     *
-     * @param textArray - Single TextProperties object or array of TextProperties containing:
-     *   - text: Text content to render (required)
-     *   - x: X position on canvas (required)
-     *   - y: Y position on canvas (required)
-     *   - fontPath: Path to custom font file (.ttf, .otf, .woff, etc.)
-     *   - fontName: Custom font name (used with fontPath)
-     *   - fontSize: Font size in pixels (default: 16)
-     *   - fontFamily: Font family name (e.g., 'Arial', 'Helvetica')
-     *   - bold: Make text bold (boolean)
-     *   - italic: Make text italic (boolean)
-     *   - underline: Add underline decoration (boolean)
-     *   - overline: Add overline decoration (boolean)
-     *   - strikethrough: Add strikethrough decoration (boolean)
-     *   - highlight: Highlight text with background color and opacity
-     *   - lineHeight: Line height multiplier (default: 1.4)
-     *   - letterSpacing: Space between letters in pixels
-     *   - wordSpacing: Space between words in pixels
-     *   - maxWidth: Maximum width for text wrapping
-     *   - maxHeight: Maximum height for text (truncates with ellipsis)
-     *   - textAlign: Horizontal text alignment ('left', 'center', 'right', 'start', 'end')
-     *   - textBaseline: Vertical text baseline ('alphabetic', 'bottom', 'hanging', 'ideographic', 'middle', 'top')
-     *   - color: Text color (hex, rgb, rgba, hsl, etc.)
-     *   - gradient: Gradient fill for text
-     *   - opacity: Text opacity (0-1, default: 1)
-     *   - glow: Text glow effect with color, intensity, and opacity
-     *   - shadow: Text shadow effect with color, offset, blur, and opacity
-     *   - stroke: Text stroke/outline with color, width, gradient, and opacity
-     *   - rotation: Text rotation in degrees
-     *
-     * @param canvasBuffer - Existing canvas buffer (Buffer) or CanvasResults object
-     *
-     * @returns Promise<Buffer> - Updated canvas buffer in PNG format
-     *
-     * @throws Error if text, x, or y are missing, or if canvas buffer is invalid
-     *
-     * @example
-     * ```typescript
-     * const result = await painter.createText([
-     *   {
-     *     text: "Hello World!",
-     *     x: 100, y: 100,
-     *     fontSize: 24,
-     *     bold: true,
-     *     color: '#ff6b6b',
-     *     shadow: { color: 'rgba(0,0,0,0.3)', offsetX: 2, offsetY: 2, blur: 4 },
-     *     underline: true,
-     *     highlight: { color: '#ffff00', opacity: 0.3 }
-     *   }
-     * ], canvasBuffer);
-     * ```
-     */
     createText(textArray: TextProperties | TextProperties[], canvasBuffer: CanvasResults | Buffer): Promise<Buffer>;
-    createCustom(options: CustomOptions[], buffer: CanvasResults | Buffer): Promise<Buffer>;
+    createCustom(options: CustomOptions | CustomOptions[], buffer: CanvasResults | Buffer): Promise<Buffer>;
     createGIF(gifFrames: {
         background: string;
         duration: number;
-    }[], options: GIFOptions): Promise<GIFResults | any>;
-    resize(resizeOptions: ResizeOptions): Promise<Buffer<ArrayBufferLike>>;
-    imgConverter(source: string, newExtension: string): Promise<Buffer<ArrayBufferLike>>;
-    effects(source: string, filters: any[]): Promise<Buffer<ArrayBufferLike>>;
-    colorsFilter(source: string, filterColor: any, opacity?: number): Promise<any>;
+    }[], options: GIFOptions): Promise<GIFResults | Buffer | string | Array<{
+        attachment: NodeJS.ReadableStream | any;
+        name: string;
+    }> | undefined>;
+    resize(resizeOptions: ResizeOptions): Promise<Buffer>;
+    imgConverter(source: string, newExtension: string): Promise<Buffer>;
+    effects(source: string, filters: ImageFilter[]): Promise<Buffer>;
+    colorsFilter(source: string, filterColor: string | GradientConfig, opacity?: number): Promise<Buffer>;
     colorAnalysis(source: string): Promise<{
         color: string;
         frequency: string;
@@ -155,24 +32,26 @@ export declare class ApexPainter {
         red: number;
         green: number;
         blue: number;
-    }): Promise<Buffer<ArrayBufferLike> | undefined>;
-    removeBackground(imageURL: string, apiKey: string): Promise<Buffer<ArrayBufferLike> | undefined>;
-    blend(layers: {
+    }): Promise<Buffer | undefined>;
+    removeBackground(imageURL: string, apiKey: string): Promise<Buffer | undefined>;
+    blend(layers: Array<{
         image: string | Buffer;
-        blendMode: 'source-over' | 'source-in' | 'source-out' | 'source-atop' | 'destination-over' | 'destination-in' | 'destination-out' | 'destination-atop' | 'lighter' | 'copy' | 'xor' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity';
+        blendMode: GlobalCompositeOperation;
         position?: {
             x: number;
             y: number;
         };
         opacity?: number;
-    }[], baseImageBuffer: Buffer, defaultBlendMode?: 'source-over' | 'source-in' | 'source-out' | 'source-atop' | 'destination-over' | 'destination-in' | 'destination-out' | 'destination-atop' | 'lighter' | 'copy' | 'xor' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity'): Promise<Buffer>;
-    createChart(data: any, type: {
+    }>, baseImageBuffer: Buffer, defaultBlendMode?: GlobalCompositeOperation): Promise<Buffer>;
+    createChart(data: unknown, type: {
         chartType: string;
         chartNumber: number;
-    }): Promise<Buffer<ArrayBufferLike> | undefined>;
+    }): Promise<Buffer>;
     cropImage(options: cropOptions): Promise<Buffer>;
-    private drawImage;
-    extractFrames(videoSource: string | Buffer, options: ExtractFramesOptions): Promise<any[]>;
+    extractFrames(videoSource: string | Buffer, options: ExtractFramesOptions): Promise<Array<{
+        source: string;
+        isRemote: boolean;
+    }>>;
     masking(source: string | Buffer | PathLike | Uint8Array, maskSource: string | Buffer | PathLike | Uint8Array, options?: MaskOptions): Promise<Buffer>;
     gradientBlend(source: string | Buffer | PathLike | Uint8Array, options: BlendOptions): Promise<Buffer>;
     animate(frames: Frame[], defaultDuration: number, defaultWidth?: number, defaultHeight?: number, options?: {
@@ -182,8 +61,142 @@ export declare class ApexPainter {
         onFrame?: (index: number) => void;
         onEnd?: () => void;
     }): Promise<Buffer[] | undefined>;
-    validHex(hexColor: string): any;
-    outPut(results: any): Promise<void | Buffer | string | Blob | Object | HTMLCanvasElement>;
+    /**
+     * Processes multiple operations in parallel
+     * @param operations - Array of operations to process
+     * @returns Array of result buffers
+     */
+    batch(operations: BatchOperation[]): Promise<Buffer[]>;
+    /**
+     * Chains multiple operations sequentially
+     * @param operations - Array of operations to chain
+     * @returns Final result buffer
+     */
+    chain(operations: ChainOperation[]): Promise<Buffer>;
+    /**
+     * Stitches multiple images together
+     * @param images - Array of image sources
+     * @param options - Stitching options
+     * @returns Stitched image buffer
+     */
+    stitchImages(images: Array<string | Buffer>, options?: StitchOptions): Promise<Buffer>;
+    /**
+     * Creates an image collage
+     * @param images - Array of image sources with optional dimensions
+     * @param layout - Collage layout configuration
+     * @returns Collage image buffer
+     */
+    createCollage(images: Array<{
+        source: string | Buffer;
+        width?: number;
+        height?: number;
+    }>, layout: CollageLayout): Promise<Buffer>;
+    /**
+     * Compresses an image with quality control
+     * @param image - Image source (path, URL, or Buffer)
+     * @param options - Compression options
+     * @returns Compressed image buffer
+     */
+    compress(image: string | Buffer, options?: CompressionOptions): Promise<Buffer>;
+    /**
+     * Extracts color palette from an image
+     * @param image - Image source (path, URL, or Buffer)
+     * @param options - Palette extraction options
+     * @returns Array of colors with percentages
+     */
+    extractPalette(image: string | Buffer, options?: PaletteOptions): Promise<Array<{
+        color: string;
+        percentage: number;
+    }>>;
+    /**
+     * Validates a hexadecimal color string.
+     * @param hexColor - Hexadecimal color string to validate (format: #RRGGBB)
+     * @returns True if the color is valid
+     * @throws Error if the color format is invalid
+     *
+     * @example
+     * ```typescript
+     * painter.validHex('#ff0000'); // true
+     * painter.validHex('#FF00FF'); // true
+     * painter.validHex('invalid'); // throws Error
+     * ```
+     */
+    validHex(hexColor: string): boolean;
+    /**
+     * Converts results to the configured output format.
+     * @param results - Buffer or result to convert
+     * @returns Converted result in the configured format
+     * @throws Error if format is unsupported or conversion fails
+     *
+     * @example
+     * ```typescript
+     * const painter = new ApexPainter({ type: 'base64' });
+     * const result = await painter.createCanvas({ width: 100, height: 100 });
+     * const base64String = await painter.outPut(result.buffer); // Returns base64 string
+     * ```
+     */
+    outPut(results: Buffer): Promise<Buffer | string | Blob | ArrayBuffer>;
+    /**
+     * Advanced save method to save buffers to local files with extensive customization options.
+     *
+     * @param buffer - Buffer to save (from createCanvas, createImage, createText, etc.)
+     * @param options - Save options for file path, format, naming, etc.
+     * @returns SaveResult with file path, name, size, and format
+     *
+     * @example
+     * ```typescript
+     * // Simple save with auto-generated name
+     * const canvas = await painter.createCanvas({ width: 800, height: 600 });
+     * const result = await painter.save(canvas.buffer);
+     * // Saves to: ./ApexPainter_output/20241220_143025_123.png
+     *
+     * // Custom filename and directory
+     * await painter.save(canvas.buffer, {
+     *   directory: './my-images',
+     *   filename: 'my-canvas',
+     *   format: 'jpg',
+     *   quality: 95
+     * });
+     *
+     * // Save with counter naming
+     * await painter.save(canvas.buffer, {
+     *   naming: 'counter',
+     *   prefix: 'image-',
+     *   counterStart: 1
+     * });
+     * // Saves to: ./ApexPainter_output/image-1.png, image-2.png, etc.
+     *
+     * // Save multiple buffers
+     * const buffers = [canvas1.buffer, canvas2.buffer, canvas3.buffer];
+     * const results = await painter.saveMultiple(buffers, {
+     *   prefix: 'batch-',
+     *   naming: 'counter'
+     * });
+     * ```
+     */
+    save(buffer: Buffer, options?: SaveOptions): Promise<SaveResult>;
+    /**
+     * Save multiple buffers at once with batch options.
+     *
+     * @param buffers - Array of buffers to save
+     * @param options - Save options (applied to all files)
+     * @returns Array of SaveResult objects
+     *
+     * @example
+     * ```typescript
+     * const canvas1 = await painter.createCanvas({ width: 800, height: 600 });
+     * const canvas2 = await painter.createCanvas({ width: 800, height: 600 });
+     * const results = await painter.saveMultiple([canvas1.buffer, canvas2.buffer], {
+     *   prefix: 'batch-',
+     *   naming: 'counter'
+     * });
+     * ```
+     */
+    saveMultiple(buffers: Buffer[], options?: SaveOptions): Promise<SaveResult[]>;
+    /**
+     * Reset the save counter (useful when using 'counter' naming).
+     */
+    resetSaveCounter(): void;
 }
 export {};
 //# sourceMappingURL=ApexPainter.d.ts.map

package/dist/esm/Canvas/ApexPainter.d.ts.map

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