apexify.js 4.7.95 → 4.8.0

package/dist/esm/ai/{modals-chat → modals}/groq/whisper.js

@@ -13,15 +13,14 @@ const https_1 = __importDefault(require("https"));
  * Gets the file size of a given path.
  */
 function getFileSize(filePath) {
-    const stats = fs_1.default.statSync(filePath);
-    return stats.size;
+    return fs_1.default.statSync(filePath).size;
 }
 /**
  * Creates a readable stream from a local file or a remote URL.
  */
 async function createReadableStream(filepathOrUrl) {
-    const maxFileSizeBytes = 25 * 1024 * 1024;
-    if (filepathOrUrl.startsWith('http')) {
+    const maxFileSizeBytes = 25 * 1024 * 1024; // 25MB limit
+    if (filepathOrUrl.startsWith("http")) {
         const parsedUrl = new url_1.URL(filepathOrUrl);
         const fileExtension = path_1.default.extname(parsedUrl.pathname);
         const tempFilePath = `temp-file-${Date.now()}${fileExtension}`;
@@ -29,38 +28,31 @@ async function createReadableStream(filepathOrUrl) {
             const file = fs_1.default.createWriteStream(tempFilePath);
             const request = https_1.default.get(filepathOrUrl, (response) => {
                 let fileSize = 0;
-                response.on('data', (chunk) => {
+                response.on("data", (chunk) => {
                     fileSize += chunk.length;
                     if (fileSize > maxFileSizeBytes) {
-                        request.destroy(); // Stop downloading
+                        request.destroy();
                         file.close();
-                        fs_1.default.unlink(tempFilePath, () => {
-                            resolve('File size exceeds the limit (25MB)');
-                        });
-                        return; // Ensure function stops here
+                        fs_1.default.unlink(tempFilePath, () => resolve({ stream: null, error: "File size exceeds the limit (25MB)" }));
+                        return;
                     }
                 });
                 response.pipe(file);
-                file.on('finish', () => {
-                    file.close(() => {
-                        if (fileSize <= maxFileSizeBytes) {
-                            resolve(fs_1.default.createReadStream(tempFilePath));
-                        }
-                    });
+                file.on("finish", () => {
+                    file.close();
+                    resolve({ stream: fs_1.default.createReadStream(tempFilePath), tempFilePath }); // ✅ Ensure fs.ReadStream
                 });
             });
-            request.on('error', (err) => {
-                fs_1.default.unlink(tempFilePath, () => {
-                    reject(err);
-                });
+            request.on("error", (err) => {
+                fs_1.default.unlink(tempFilePath, () => reject(err));
             });
         });
     }
     else {
         if (getFileSize(filepathOrUrl) > maxFileSizeBytes) {
-            return 'File size exceeds the limit (25MB)';
+            return { stream: null, error: "File size exceeds the limit (25MB)" };
         }
-        return fs_1.default.createReadStream(filepathOrUrl);
+        return { stream: fs_1.default.createReadStream(filepathOrUrl) }; // ✅ Ensure fs.ReadStream
     }
 }
 /**
@@ -72,36 +64,45 @@ async function whisper(prompt, filepath, lang, API_KEY) {
             apiKey: API_KEY || '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',
         });
         // Ensure filepath is properly resolved
-        const resolvedFilePath = filepath.startsWith('http') || path_1.default.isAbsolute(filepath)
+        const resolvedFilePath = filepath.startsWith("http") || path_1.default.isAbsolute(filepath)
             ? filepath
             : path_1.default.join(process.cwd(), filepath);
-        const fileStream = await createReadableStream(resolvedFilePath);
-        if (typeof fileStream === 'string') {
-            return fileStream;
-        }
+        const { stream: fileStream, tempFilePath, error } = await createReadableStream(resolvedFilePath);
+        if (error)
+            return error;
+        if (!fileStream)
+            return "Failed to create a readable file stream.";
+        // ✅ Ensure `fileStream` is a valid `fs.ReadStream`
         const transcription = await groq.audio.transcriptions.create({
-            file: fileStream,
+            file: fileStream, // ✅ Ensure correct type
             model: "whisper-large-v3-turbo",
             prompt: prompt,
             temperature: 1,
-            language: lang || 'eng',
+            language: lang || "eng",
             response_format: "verbose_json",
         });
+        // ✅ Delete the temp file if it was downloaded from a URL
+        if (tempFilePath && fs_1.default.existsSync(tempFilePath)) {
+            fs_1.default.unlinkSync(tempFilePath);
+        }
         return transcription.text;
     }
     catch (err) {
         if (err?.status) {
             switch (err.status) {
-                case 400: return 'Bad request, try again after a minute please.';
-                case 429: return 'Rate limit exceeded, try again later or provide your own API key.';
-                case 401: return 'Invalid API key provided.';
+                case 400:
+                    return "Bad request, try again after a minute.";
+                case 429:
+                    return "Rate limit exceeded, try again later or provide your own API key.";
+                case 401:
+                    return "Invalid API key provided.";
                 default:
                     console.error(err);
                     return "An unknown error occurred.";
             }
         }
         console.error(err);
-        return 'An unknown error occurred.';
+        return "An unknown error occurred.";
     }
 }
 //# sourceMappingURL=whisper.js.map

package/dist/esm/ai/modals/groq/whisper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.js","sourceRoot":"","sources":["../../../../../lib/ai/modals/groq/whisper.ts"],"names":[],"mappings":"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"}

package/dist/esm/ai/modals/hercai/chatModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatModels.d.ts","sourceRoot":"","sources":["../../../../../lib/ai/modals/hercai/chatModels.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAA;AAE/I,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAevJ"}

package/dist/esm/ai/modals/hercai/chatModels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatModels.js","sourceRoot":"","sources":["../../../../../lib/ai/modals/hercai/chatModels.ts"],"names":[],"mappings":";;AAIA,gCAeC;AAnBD,mCAAgC;AAChC,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,6CAA6C,CAAC,CAAC;AAGlE,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,KAAmB,EAAE,YAAqB,EAAE,MAAyC;IAClI,IAAI,CAAC;QAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,CAAC;aAAM,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAE9I,OAAO,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAChG,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,kCAAkC,CAAC;IAC9C,CAAC;AACL,CAAC"}

package/dist/esm/ai/utils.d.ts

@@ -1,6 +1,6 @@
 import { readFile } from "./functions/readFiles";
 import { ApexChat, ApexImagine, ApexListener, ApexVideo, ApexText2Speech, resetHistory } from "./ApexModules";
 import { typeWriter } from "./functions/typeWriter";
-import { groqAnalyzer } from "./modals-chat/groq/imageAnalyzer";
+import { groqAnalyzer } from "./modals/groq/imageAnalyzer";
 export { readFile, ApexChat, ApexImagine, ApexListener, typeWriter, groqAnalyzer, ApexVideo, ApexText2Speech, resetHistory };
 //# sourceMappingURL=utils.d.ts.map

package/dist/esm/ai/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/ai/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAE;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGhE,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACb,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../lib/ai/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAE;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACb,CAAC"}

package/dist/esm/ai/utils.js

@@ -12,6 +12,6 @@ Object.defineProperty(exports, "ApexText2Speech", { enumerable: true, get: funct
 Object.defineProperty(exports, "resetHistory", { enumerable: true, get: function () { return ApexModules_1.resetHistory; } });
 const typeWriter_1 = require("./functions/typeWriter");
 Object.defineProperty(exports, "typeWriter", { enumerable: true, get: function () { return typeWriter_1.typeWriter; } });
-const imageAnalyzer_1 = require("./modals-chat/groq/imageAnalyzer");
+const imageAnalyzer_1 = require("./modals/groq/imageAnalyzer");
 Object.defineProperty(exports, "groqAnalyzer", { enumerable: true, get: function () { return imageAnalyzer_1.groqAnalyzer; } });
 //# sourceMappingURL=utils.js.map

package/dist/esm/ai/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/ai/utils.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAO/C,yFAPO,oBAAQ,OAOP;AANV,+CAA8G;AAO5G,yFAPO,sBAAQ,OAOP;AACR,4FARiB,yBAAW,OAQjB;AACX,6FAT8B,0BAAY,OAS9B;AAGZ,0FAZ4C,uBAAS,OAY5C;AACT,gGAbuD,6BAAe,OAavD;AACf,6FAdwE,0BAAY,OAcxE;AAbd,uDAAqD;AASnD,2FATO,uBAAU,OASP;AARZ,oEAAgE;AAS9D,6FATO,4BAAY,OASP"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../lib/ai/utils.ts"],"names":[],"mappings":";;;AAAA,qDAAiD;AAO/C,yFAPO,oBAAQ,OAOP;AANV,+CAA8G;AAO5G,yFAPO,sBAAQ,OAOP;AACR,4FARiB,yBAAW,OAQjB;AACX,6FAT8B,0BAAY,OAS9B;AAGZ,0FAZ4C,uBAAS,OAY5C;AACT,gGAbuD,6BAAe,OAavD;AACf,6FAdwE,0BAAY,OAcxE;AAbd,uDAAqD;AASnD,2FATO,uBAAU,OASP;AARZ,+DAA2D;AASzD,6FATO,4BAAY,OASP"}

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

@@ -1,5 +1,5 @@
-import { SKRSContext2D } from "@napi-rs/canvas";
-import { OutputFormat, CanvasConfig, TextObject, ImageProperties, GIFOptions, GIFResults, CustomOptions, cropOptions, GradientConfig, Frame, PatternOptions, ExtractFramesOptions, ResizeOptions } from "./utils/utils";
+import { PathLike } from "fs";
+import { OutputFormat, CanvasConfig, TextObject, ImageProperties, GIFOptions, GIFResults, CustomOptions, cropOptions, Frame, PatternOptions, ExtractFramesOptions, ResizeOptions, MaskOptions, BlendOptions } from "./utils/utils";
 interface CanvasResults {
     buffer: Buffer;
     canvas: CanvasConfig;
@@ -30,14 +30,14 @@ export declare class ApexPainter {
         duration: number;
     }[], options: GIFOptions): Promise<GIFResults | any>;
     resize(resizeOptions: ResizeOptions): Promise<Buffer<ArrayBufferLike>>;
-    imgConverter(imagePath: string, newExtension: string): Promise<Buffer<ArrayBufferLike>>;
-    processImage(imagePath: string, filters: any[]): Promise<Buffer<ArrayBufferLike>>;
-    colorsFilter(imagePath: string, filterColor: any, opacity?: number): Promise<any>;
-    colorAnalysis(imagePath: string): Promise<{
+    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>;
+    colorAnalysis(source: string): Promise<{
         color: string;
         frequency: string;
     }[]>;
-    colorsRemover(imagePath: string, colorToRemove: {
+    colorsRemover(source: string, colorToRemove: {
         red: number;
         green: number;
         blue: number;
@@ -51,7 +51,7 @@ export declare class ApexPainter {
             y: number;
         };
         opacity?: number;
-    }[], baseImageBuffer: Buffer): Promise<Buffer>;
+    }[], 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: {
         chartType: string;
         chartNumber: number;
@@ -65,7 +65,7 @@ export declare class ApexPainter {
      * @param {Object} options - Options to customize the pattern.
      * @returns {Promise<Buffer>} - The adjusted image buffer.
      */
-    setPatternBackground(buffer: Buffer, options: PatternOptions): Promise<Buffer<ArrayBufferLike>>;
+    patterns(buffer: Buffer, options: PatternOptions): Promise<Buffer<ArrayBufferLike>>;
     /**
      * Fills the specified area with a gradient.
      * @param ctx The rendering context of the canvas.
@@ -75,7 +75,7 @@ export declare class ApexPainter {
      * @param x The x offset of the area.
      * @param y The y offset of the area.
      */
-    fillWithGradient(ctx: SKRSContext2D, width: number, height: number, gradient: GradientConfig, x?: number, y?: number): Promise<void>;
+    private fillWithGradient;
     /**
      * Draws a dots pattern in the specified area.
      * @param ctx The rendering context of the canvas.
@@ -85,7 +85,7 @@ export declare class ApexPainter {
      * @param x The x offset of the area.
      * @param y The y offset of the area.
      */
-    drawDotsPattern(ctx: SKRSContext2D, width: number, height: number, options: PatternOptions, x?: number, y?: number): Promise<void>;
+    private drawDotsPattern;
     /**
      * Draws a stripes pattern in the specified area.
      * @param ctx The rendering context of the canvas.
@@ -95,7 +95,7 @@ export declare class ApexPainter {
      * @param x The x offset of the area.
      * @param y The y offset of the area.
      */
-    drawStripesPattern(ctx: SKRSContext2D, width: number, height: number, options: PatternOptions, x?: number, y?: number): Promise<void>;
+    private drawStripesPattern;
     /**
    * Draws a grid pattern in the specified area.
    * @param ctx The rendering context of the canvas.
@@ -105,7 +105,7 @@ export declare class ApexPainter {
    * @param x The x offset of the area.
    * @param y The y offset of the area.
    */
-    drawGridPattern(ctx: SKRSContext2D, width: number, height: number, options: PatternOptions, x?: number, y?: number): Promise<void>;
+    private drawGridPattern;
     /**
      * Draws a checkerboard pattern in the specified area.
      * @param ctx The rendering context of the canvas.
@@ -115,7 +115,7 @@ export declare class ApexPainter {
      * @param x The x offset of the area.
      * @param y The y offset of the area.
      */
-    drawCheckerboardPattern(ctx: SKRSContext2D, width: number, height: number, options: PatternOptions, x?: number, y?: number): Promise<void>;
+    private drawCheckerboardPattern;
     /**
      * Draws a custom image pattern in the specified area.
      * @param ctx The rendering context of the canvas.
@@ -125,7 +125,12 @@ export declare class ApexPainter {
      * @param x The x offset of the area.
      * @param y The y offset of the area.
      */
-    drawCustomPattern(ctx: SKRSContext2D, width: number, height: number, options: PatternOptions, x?: number, y?: number): Promise<void>;
+    private drawCustomPattern;
+    private drawWavePattern;
+    private drawNoisePattern;
+    private drawDiagonalCheckerboardPattern;
+    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?: {
         gif?: boolean;
         gifPath?: string;

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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"}

package/dist/esm/canvas/ApexPainter.js

@@ -113,7 +113,6 @@ class ApexPainter {
                 if (mergedTextOptions.fontPath) {
                     canvas_1.GlobalFonts.registerFromPath(path_1.default.join(process.cwd(), mergedTextOptions.fontPath), (mergedTextOptions.fontName || 'customFont'));
                 }
-                const size = { width: existingImage.width, height: existingImage.height };
                 (0, utils_1.drawText)(ctx, mergedTextOptions);
             }
             return canvas.toBuffer("image/png");
@@ -261,29 +260,30 @@ class ApexPainter {
     async resize(resizeOptions) {
         return (0, utils_1.resizingImg)(resizeOptions);
     }
-    async imgConverter(imagePath, newExtension) {
-        return (0, utils_1.converter)(imagePath, newExtension);
+    async imgConverter(source, newExtension) {
+        return (0, utils_1.converter)(source, newExtension);
     }
-    async processImage(imagePath, filters) {
-        return (0, utils_1.imgEffects)(imagePath, filters);
+    async effects(source, filters) {
+        return (0, utils_1.imgEffects)(source, filters);
     }
-    async colorsFilter(imagePath, filterColor, opacity) {
-        return (0, utils_1.applyColorFilters)(imagePath, filterColor, opacity);
+    async colorsFilter(source, filterColor, opacity) {
+        return (0, utils_1.applyColorFilters)(source, filterColor, opacity);
     }
-    async colorAnalysis(imagePath) {
-        return (0, utils_1.detectColors)(imagePath);
+    async colorAnalysis(source) {
+        return (0, utils_1.detectColors)(source);
     }
-    async colorsRemover(imagePath, colorToRemove) {
-        return (0, utils_1.removeColor)(imagePath, colorToRemove);
+    async colorsRemover(source, colorToRemove) {
+        return (0, utils_1.removeColor)(source, colorToRemove);
     }
     async removeBackground(imageURL, apiKey) {
         return (0, utils_1.bgRemoval)(imageURL, apiKey);
     }
-    async blend(layers, baseImageBuffer) {
+    async blend(layers, baseImageBuffer, defaultBlendMode = 'source-over') {
         try {
             const baseImage = await (0, canvas_1.loadImage)(baseImageBuffer);
             const canvas = (0, canvas_1.createCanvas)(baseImage.width, baseImage.height);
             const ctx = canvas.getContext('2d');
+            ctx.globalCompositeOperation = defaultBlendMode;
             ctx.drawImage(baseImage, 0, 0);
             for (const layer of layers) {
                 const layerImage = await (0, canvas_1.loadImage)(layer.image);
@@ -292,7 +292,7 @@ class ApexPainter {
                 ctx.drawImage(layerImage, layer.position?.x || 0, layer.position?.y || 0);
             }
             ctx.globalAlpha = 1.0;
-            ctx.globalCompositeOperation = 'source-over';
+            ctx.globalCompositeOperation = defaultBlendMode; // Reset to user-defined default
             return canvas.toBuffer('image/png');
         }
         catch (error) {
@@ -370,12 +370,8 @@ class ApexPainter {
         }
         const shapeNames = ['circle', 'square', 'triangle', 'pentagon', 'hexagon', 'heptagon', 'octagon', 'star', 'kite', 'arrow', 'star', 'oval', 'heart', 'diamond', 'trapezoid', 'cloud'];
         const isShape = shapeNames.includes(source.toLowerCase());
-        if (opacity !== undefined) {
-            ctx.globalAlpha = opacity;
-        }
         if (isShape) {
-            (0, utils_1.drawShape)(ctx, { source, x, y, width, height, rotation, borderRadius, stroke, shadow, isFilled, color, gradient, borderPosition, filling });
-            ctx.globalAlpha = 1.0;
+            (0, utils_1.drawShape)(ctx, { source, x, y, width, height, opacity, rotation, borderRadius, stroke, shadow, isFilled, color, gradient, borderPosition, filling });
             return;
         }
         let loadedImage;
@@ -402,6 +398,9 @@ class ApexPainter {
             ctx.translate(focusX, focusY);
             ctx.scale(scale, scale);
         }
+        if (opacity !== undefined) {
+            ctx.globalAlpha = opacity;
+        }
         if (blur > 0) {
             ctx.filter = `blur(${blur}px)`;
         }
@@ -411,9 +410,12 @@ class ApexPainter {
             throw new Error('Under construction');
         }
         (0, utils_1.imageRadius)(ctx, loadedImage, x, y, width, height, borderRadius, borderPosition);
+        ctx.globalAlpha = 1.0;
+        if (stroke?.opacity)
+            ctx.globalAlpha = stroke.opacity;
         (0, utils_1.applyStroke)(ctx, stroke, x, y, width, height, undefined);
-        ctx.restore();
         ctx.globalAlpha = 1.0;
+        ctx.restore();
     }
     async extractFrames(videoSource, options) {
         const frames = [];
@@ -485,7 +487,7 @@ class ApexPainter {
      * @param {Object} options - Options to customize the pattern.
      * @returns {Promise<Buffer>} - The adjusted image buffer.
      */
-    async setPatternBackground(buffer, options) {
+    async patterns(buffer, options) {
         const img = await (0, canvas_1.loadImage)(buffer);
         const canvas = (0, canvas_1.createCanvas)(img.width, img.height);
         const ctx = canvas.getContext('2d');
@@ -521,6 +523,15 @@ class ApexPainter {
             case 'custom':
                 await this.drawCustomPattern(ctx, width, height, options, x, y);
                 break;
+            case 'noise':
+                await this.drawNoisePattern(ctx, width, height, x, y);
+                break;
+            case 'waves':
+                await this.drawWavePattern(ctx, width, height, options, x, y);
+                break;
+            case 'diagonal-checkerboard':
+                await this.drawDiagonalCheckerboardPattern(ctx, width, height, options, x, y);
+                break;
             default:
                 throw new Error('Invalid pattern type specified.');
         }
@@ -663,6 +674,115 @@ class ApexPainter {
         ctx.fillRect(0, 0, width, height);
         ctx.resetTransform();
     }
+    async drawWavePattern(ctx, width, height, options, x = 0, y = 0) {
+        const color = options.color || 'black';
+        const waveHeight = options.size || 10;
+        const frequency = options.spacing || 20;
+        ctx.strokeStyle = color;
+        ctx.lineWidth = 2;
+        for (let posY = y; posY < y + height; posY += frequency) {
+            ctx.beginPath();
+            for (let posX = x; posX < x + width; posX += 5) {
+                const waveY = posY + Math.sin(posX / frequency) * waveHeight;
+                ctx.lineTo(posX, waveY);
+            }
+            ctx.stroke();
+        }
+    }
+    async drawNoisePattern(ctx, width, height, x = 0, y = 0) {
+        const imageData = ctx.createImageData(width, height);
+        const data = imageData.data;
+        for (let i = 0; i < data.length; i += 4) {
+            const gray = Math.random() * 255;
+            data[i] = gray;
+            data[i + 1] = gray;
+            data[i + 2] = gray;
+            data[i + 3] = Math.random() * 255;
+        }
+        ctx.putImageData(imageData, x, y);
+    }
+    async drawDiagonalCheckerboardPattern(ctx, width, height, options, x = 0, y = 0) {
+        const color1 = options.color || 'black';
+        const color2 = options.secondaryColor || 'white';
+        const size = options.size || 20;
+        ctx.save();
+        ctx.translate(x + width / 2, y + height / 2);
+        ctx.rotate(Math.PI / 4);
+        ctx.translate(-width / 2, -height / 2);
+        for (let posY = 0; posY < height; posY += size) {
+            for (let posX = 0; posX < width; posX += size) {
+                ctx.fillStyle = (Math.floor(posX / size) + Math.floor(posY / size)) % 2 === 0 ? color1 : color2;
+                ctx.fillRect(posX, posY, size, size);
+            }
+        }
+        ctx.restore();
+    }
+    async masking(source, maskSource, options = { type: "alpha" }) {
+        const img = await (0, canvas_1.loadImage)(source);
+        const mask = await (0, canvas_1.loadImage)(maskSource);
+        const canvas = (0, canvas_1.createCanvas)(img.width, img.height);
+        const ctx = canvas.getContext("2d");
+        ctx.drawImage(img, 0, 0, img.width, img.height);
+        const maskCanvas = (0, canvas_1.createCanvas)(img.width, img.height);
+        const maskCtx = maskCanvas.getContext("2d");
+        maskCtx.drawImage(mask, 0, 0, img.width, img.height);
+        const maskData = maskCtx.getImageData(0, 0, img.width, img.height);
+        const imgData = ctx.getImageData(0, 0, img.width, img.height);
+        for (let i = 0; i < maskData.data.length; i += 4) {
+            let alphaValue = 255;
+            if (options.type === "grayscale") {
+                const grayscale = maskData.data[i] * 0.3 + maskData.data[i + 1] * 0.59 + maskData.data[i + 2] * 0.11;
+                alphaValue = grayscale >= (options.threshold ?? 128) ? 255 : 0;
+            }
+            else if (options.type === "alpha") {
+                alphaValue = maskData.data[i + 3];
+            }
+            else if (options.type === "color" && options.colorKey) {
+                const colorMatch = maskData.data[i] === parseInt(options.colorKey.slice(1, 3), 16) &&
+                    maskData.data[i + 1] === parseInt(options.colorKey.slice(3, 5), 16) &&
+                    maskData.data[i + 2] === parseInt(options.colorKey.slice(5, 7), 16);
+                alphaValue = colorMatch ? 0 : 255;
+            }
+            if (options.invert)
+                alphaValue = 255 - alphaValue;
+            imgData.data[i + 3] = alphaValue;
+        }
+        ctx.putImageData(imgData, 0, 0);
+        return canvas.toBuffer("image/png");
+    }
+    async gradientBlend(source, options) {
+        const img = await (0, canvas_1.loadImage)(source);
+        const canvas = (0, canvas_1.createCanvas)(img.width, img.height);
+        const ctx = canvas.getContext("2d");
+        ctx.drawImage(img, 0, 0, img.width, img.height);
+        let gradient;
+        if (options.type === "linear") {
+            const angle = options.angle ?? 0;
+            const radians = (angle * Math.PI) / 180;
+            const x1 = img.width / 2 - (Math.cos(radians) * img.width) / 2;
+            const y1 = img.height / 2 - (Math.sin(radians) * img.height) / 2;
+            const x2 = img.width / 2 + (Math.cos(radians) * img.width) / 2;
+            const y2 = img.height / 2 + (Math.sin(radians) * img.height) / 2;
+            gradient = ctx.createLinearGradient(x1, y1, x2, y2);
+        }
+        else if (options.type === "radial") {
+            gradient = ctx.createRadialGradient(img.width / 2, img.height / 2, 0, img.width / 2, img.height / 2, Math.max(img.width, img.height));
+        }
+        else {
+            gradient = ctx.createConicGradient(Math.PI, img.width / 2, img.height / 2);
+        }
+        options.colors.forEach(({ stop, color }) => gradient.addColorStop(stop, color));
+        ctx.fillStyle = gradient;
+        ctx.globalCompositeOperation = options.blendMode ?? "multiply";
+        ctx.fillRect(0, 0, img.width, img.height);
+        if (options.maskSource) {
+            const mask = await (0, canvas_1.loadImage)(options.maskSource);
+            ctx.globalCompositeOperation = "destination-in";
+            ctx.drawImage(mask, 0, 0, img.width, img.height);
+        }
+        ctx.globalCompositeOperation = "source-over";
+        return canvas.toBuffer("image/png");
+    }
     async animate(frames, defaultDuration, defaultWidth = 800, defaultHeight = 600, options) {
         const buffers = [];
         const isNode = typeof process !== 'undefined' && process.versions != null && process.versions.node != null;
@@ -717,7 +837,7 @@ class ApexPainter {
                 fillStyle = gradient;
             }
             if (frame.pattern) {
-                const patternImage = await (0, canvas_1.loadImage)(frame.pattern.imagePath);
+                const patternImage = await (0, canvas_1.loadImage)(frame.pattern.source);
                 const pattern = ctx.createPattern(patternImage, frame.pattern.repeat || 'repeat');
                 fillStyle = pattern;
             }
@@ -728,8 +848,8 @@ class ApexPainter {
                 ctx.fillStyle = fillStyle;
                 ctx.fillRect(0, 0, width, height);
             }
-            if (frame.imagePath) {
-                const image = await (0, canvas_1.loadImage)(frame.imagePath);
+            if (frame.source) {
+                const image = await (0, canvas_1.loadImage)(frame.source);
                 ctx.globalCompositeOperation = frame.blendMode || 'source-over';
                 ctx.drawImage(image, 0, 0, width, height);
             }