@nmmty/lazycanvas 0.6.0 → 0.6.2

package/dist/structures/components/TextLayer.js

@@ -15,8 +15,8 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     props;
     /**
      * Constructs a new TextLayer instance.
-     * @param props {ITextLayerProps} - The properties of the Text Layer.
-     * @param misc {IBaseLayerMisc} - Miscellaneous options for the layer.
+     * @param {ITextLayerProps} [props] - The properties of the Text Layer.
+     * @param {IBaseLayerMisc} [misc] - Miscellaneous options for the layer.
      */
     constructor(props, misc) {
         super(types_1.LayerType.Text, props || {}, misc);
@@ -25,7 +25,7 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the text of the text layer.
-     * @param text {string} - The text content of the layer.
+     * @param {string} [text] - The text content of the layer.
      * @returns {this} The current instance for chaining.
      */
     setText(text) {
@@ -34,9 +34,9 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the font of the text layer.
-     * @param familyOrConfig {string | { family: string; size: number; weight: AnyWeight }} - The font family or configuration object.
-     * @param size {number} - The font size (required if `familyOrConfig` is a string).
-     * @param weight {AnyWeight} - The font weight (required if `familyOrConfig` is a string).
+     * @param {string | { family: string; size: number; weight: AnyWeight }} [familyOrConfig] - The font family or configuration object.
+     * @param {number} [size] - The font size (required if `familyOrConfig` is a string).
+     * @param {AnyWeight} [weight] - The font weight (required if `familyOrConfig` is a string).
      * @returns {this} The current instance for chaining.
      * @throws {LazyError} If size or weight is not provided when `familyOrConfig` is a string.
      */
@@ -63,15 +63,14 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Configures the multiline properties of the text layer.
-     * @param enabled {boolean} - Whether multiline is enabled.
-     * @param width {ScaleType} - The width of the multiline text area.
-     * @param height {ScaleType} - The height of the multiline text area.
-     * @param spacing {number} - The spacing between lines (optional).
+     * @param {ScaleType} [width] - The width of the multiline text area.
+     * @param {ScaleType} [height] - The height of the multiline text area.
+     * @param {number} [spacing] - The spacing between lines (optional).
      * @returns {this} The current instance for chaining.
      */
-    setMultiline(enabled, width, height, spacing) {
+    setMultiline(width, height, spacing) {
         this.props.multiline = {
-            enabled: enabled,
+            enabled: true,
             spacing: spacing || 1.1,
         };
         this.props.size = {
@@ -82,21 +81,25 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the color of the text layer.
-     * @param color {ColorType} - The color of the text.
+     * @param {ColorType} [color] - The base color of the text.
+     * @param {SubStringColor[]} [sub] - Optional substring colors for partial text coloring.
      * @returns {this} The current instance for chaining.
      * @throws {LazyError} If the color is not provided or invalid.
      */
-    setColor(color) {
+    setColor(color, ...sub) {
         if (!color)
             throw new LazyUtil_1.LazyError('The color of the layer must be provided');
         if (!(0, utils_1.isColor)(color))
             throw new LazyUtil_1.LazyError('The color of the layer must be a valid color');
         this.props.fillStyle = color;
+        if (sub && sub.length > 0) {
+            this.props.subStringColors = sub;
+        }
         return this;
     }
     /**
      * Sets the alignment of the text layer.
-     * @param align {AnyTextAlign} - The alignment of the text.
+     * @param {AnyTextAlign} [align] - The alignment of the text.
      * @returns {this} The current instance for chaining.
      */
     setAlign(align) {
@@ -105,7 +108,7 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the baseline of the text layer.
-     * @param baseline {AnyTextBaseline} - The baseline of the text.
+     * @param {AnyTextBaseline} [baseline] - The baseline of the text.
      * @returns {this} The current instance for chaining.
      */
     setBaseline(baseline) {
@@ -114,7 +117,7 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the direction of the text layer.
-     * @param direction {AnyTextDirection} - The direction of the text.
+     * @param {AnyTextDirection} [direction] - The direction of the text.
      * @returns {this} The current instance for chaining.
      */
     setDirection(direction) {
@@ -123,12 +126,12 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Configures the stroke properties of the text layer.
-     * @param width {number} - The width of the stroke.
-     * @param cap {string} - The cap style of the stroke (optional).
-     * @param join {string} - The join style of the stroke (optional).
-     * @param dash {number[]} - The dash pattern of the stroke (optional).
-     * @param dashOffset {number} - The dash offset of the stroke (optional).
-     * @param miterLimit {number} - The miter limit of the stroke (optional).
+     * @param {number} [width] - The width of the stroke.
+     * @param {string} [cap] - The cap style of the stroke.
+     * @param {string} [join] - The join style of the stroke.
+     * @param {number[]} [dash] - The dash pattern of the stroke.
+     * @param {number} [dashOffset] - The dash offset of the stroke.
+     * @param {number} [miterLimit] - The miter limit of the stroke.
      * @returns {this} The current instance for chaining.
      */
     setStroke(width, cap, join, dash, dashOffset, miterLimit) {
@@ -145,7 +148,7 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the spacing between words in the text layer.
-     * @param wordSpacing {number} - The spacing between words.
+     * @param {number} [wordSpacing] - The spacing between words.
      * @returns {this} The current instance for chaining.
      */
     setWordSpacing(wordSpacing) {
@@ -154,7 +157,7 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Sets the spacing between letters in the text layer.
-     * @param letterSpacing {number} - The spacing between letters.
+     * @param {number} [letterSpacing] - The spacing between letters.
      * @returns {this} The current instance for chaining.
      */
     setLetterSpacing(letterSpacing) {
@@ -163,8 +166,8 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Measures the dimensions of the text.
-     * @param ctx {SKRSContext2D} - The canvas rendering context.
-     * @param canvas {Canvas | SvgCanvas} - The canvas instance.
+     * @param {SKRSContext2D} [ctx] - The canvas rendering context.
+     * @param {Canvas | SvgCanvas} [canvas] - The canvas instance.
      * @returns {Object} The width and height of the text.
      */
     measureText(ctx, canvas) {
@@ -181,10 +184,10 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Draws the text layer on the canvas.
-     * @param ctx {SKRSContext2D} - The canvas rendering context.
-     * @param canvas {Canvas | SvgCanvas} - The canvas instance.
-     * @param manager {LayersManager} - The layers manager.
-     * @param debug {boolean} - Whether to enable debug logging.
+     * @param {SKRSContext2D} [ctx] - The canvas rendering context.
+     * @param {Canvas | SvgCanvas} [canvas] - The canvas instance.
+     * @param {LayersManager} [manager] - The layers manager.
+     * @param {boolean} [debug] - Whether to enable debug logging.
      */
     async draw(ctx, canvas, manager, debug) {
         const parcer = (0, utils_1.parser)(ctx, canvas, manager);
@@ -222,10 +225,12 @@ class TextLayer extends BaseLayer_1.BaseLayer {
                 let ym = y;
                 lines = [];
                 let line = '';
+                let charOffset = 0; // Track position in original text
                 for (let word of words) {
                     let linePlus = line + word + ' ';
                     if (ctx.measureText(linePlus).width > w) {
-                        lines.push({ text: line, x: xm, y: ym });
+                        lines.push({ text: line, x: xm, y: ym, startOffset: charOffset });
+                        charOffset += line.length;
                         line = word + ' ';
                         ym += lineHeight;
                     }
@@ -233,46 +238,137 @@ class TextLayer extends BaseLayer_1.BaseLayer {
                         line = linePlus;
                     }
                 }
-                lines.push({ text: line, x: xm, y: ym });
+                lines.push({ text: line, x: xm, y: ym, startOffset: charOffset });
                 if (ym > ym + h)
                     break;
             }
             for (let line of lines) {
-                this.drawText(this.props, ctx, fillStyle, line.text, line.x, line.y, w);
+                this.drawText(this.props, ctx, fillStyle, line.text, line.x, line.y, w, line.startOffset);
             }
         }
         else {
             ctx.font = `${this.props.font.weight} ${this.props.font.size}px ${this.props.font.family}`;
-            this.drawText(this.props, ctx, fillStyle, this.props.text, x, y, w);
+            this.drawText(this.props, ctx, fillStyle, this.props.text, x, y, w, 0);
         }
         ctx.closePath();
         ctx.restore();
     }
     /**
      * Draws the text on the canvas.
-     * @param props {ITextLayerProps} - The properties of the text layer.
-     * @param ctx {SKRSContext2D} - The canvas rendering context.
-     * @param fillStyle {string | CanvasGradient | CanvasPattern} - The fill style for the text.
-     * @param text {string} - The text content.
-     * @param x {number} - The x-coordinate of the text.
-     * @param y {number} - The y-coordinate of the text.
-     * @param w {number} - The width of the text area.
+     * @param {ITextLayerProps} [props] - The properties of the text layer.
+     * @param {SKRSContext2D} [ctx] - The canvas rendering context.
+     * @param {string | CanvasGradient | CanvasPattern}  [fillStyle] - The fill style for the text.
+     * @param {string} [text] - The text content.
+     * @param {number} [x] - The x-coordinate of the text.
+     * @param {number} [y] - The y-coordinate of the text.
+     * @param {number} [w] - The width of the text area.
+     * @param {number} [textOffset] - The offset of this text segment in the original full text (for multiline support).
      */
-    drawText(props, ctx, fillStyle, text, x, y, w) {
-        if (props.filled) {
-            ctx.fillStyle = fillStyle;
-            ctx.fillText(text, x, y, w);
+    drawText(props, ctx, fillStyle, text, x, y, w, textOffset = 0) {
+        // If no substring colors are defined, draw normally
+        if (!props.subStringColors || props.subStringColors.length === 0) {
+            if (props.filled) {
+                ctx.fillStyle = fillStyle;
+                ctx.fillText(text, x, y, w);
+            }
+            else {
+                ctx.strokeStyle = fillStyle;
+                ctx.lineWidth = props.stroke?.width || 1;
+                ctx.lineCap = props.stroke?.cap || 'butt';
+                ctx.lineJoin = props.stroke?.join || 'miter';
+                ctx.miterLimit = props.stroke?.miterLimit || 10;
+                ctx.lineDashOffset = props.stroke?.dashOffset || 0;
+                ctx.setLineDash(props.stroke?.dash || []);
+                ctx.strokeText(text, x, y, w);
+            }
+            return;
         }
-        else {
-            ctx.strokeStyle = fillStyle;
-            ctx.lineWidth = props.stroke?.width || 1;
-            ctx.lineCap = props.stroke?.cap || 'butt';
-            ctx.lineJoin = props.stroke?.join || 'miter';
-            ctx.miterLimit = props.stroke?.miterLimit || 10;
-            ctx.lineDashOffset = props.stroke?.dashOffset || 0;
-            ctx.setLineDash(props.stroke?.dash || []);
-            ctx.strokeText(text, x, y, w);
+        // Draw text with substring colors
+        const textLength = text.length;
+        let currentX = x;
+        // Save original text alignment and set to left for manual positioning
+        const originalAlign = ctx.textAlign;
+        ctx.textAlign = 'left';
+        // Adjust starting X based on text alignment
+        const alignValue = props.align;
+        if (alignValue === types_1.TextAlign.Center || alignValue === 'center') {
+            const totalWidth = ctx.measureText(text).width;
+            currentX = x - totalWidth / 2;
+        }
+        else if (alignValue === types_1.TextAlign.Right || alignValue === 'right' || alignValue === types_1.TextAlign.End || alignValue === 'end') {
+            const totalWidth = ctx.measureText(text).width;
+            currentX = x - totalWidth;
+        }
+        // Create segments based on substring colors
+        const segments = [];
+        // Sort substring colors by start position
+        const sortedColors = [...props.subStringColors].sort((a, b) => a.start - b.start);
+        let currentIndex = 0;
+        for (const subColor of sortedColors) {
+            // Adjust positions based on textOffset (for multiline support)
+            const globalStart = subColor.start;
+            const globalEnd = subColor.end;
+            const lineStart = textOffset;
+            const lineEnd = textOffset + textLength;
+            // Skip if this color segment doesn't overlap with current line
+            if (globalEnd <= lineStart || globalStart >= lineEnd) {
+                continue;
+            }
+            // Calculate local positions within this line
+            const localStart = Math.max(0, globalStart - lineStart);
+            const localEnd = Math.min(textLength, globalEnd - lineStart);
+            // Add base color segment before this substring color
+            if (currentIndex < localStart) {
+                segments.push({
+                    text: text.substring(currentIndex, localStart),
+                    color: fillStyle,
+                    start: currentIndex,
+                    end: localStart
+                });
+            }
+            // Add colored substring
+            if (localStart < localEnd) {
+                segments.push({
+                    text: text.substring(localStart, localEnd),
+                    color: subColor.color,
+                    start: localStart,
+                    end: localEnd
+                });
+                currentIndex = localEnd;
+            }
+        }
+        // Add remaining text with base color
+        if (currentIndex < textLength) {
+            segments.push({
+                text: text.substring(currentIndex),
+                color: fillStyle,
+                start: currentIndex,
+                end: textLength
+            });
+        }
+        // Draw each segment
+        for (const segment of segments) {
+            if (segment.text.length === 0)
+                continue;
+            const segmentWidth = ctx.measureText(segment.text).width;
+            if (props.filled) {
+                ctx.fillStyle = segment.color;
+                ctx.fillText(segment.text, currentX, y);
+            }
+            else {
+                ctx.strokeStyle = segment.color;
+                ctx.lineWidth = props.stroke?.width || 1;
+                ctx.lineCap = props.stroke?.cap || 'butt';
+                ctx.lineJoin = props.stroke?.join || 'miter';
+                ctx.miterLimit = props.stroke?.miterLimit || 10;
+                ctx.lineDashOffset = props.stroke?.dashOffset || 0;
+                ctx.setLineDash(props.stroke?.dash || []);
+                ctx.strokeText(segment.text, currentX, y);
+            }
+            currentX += segmentWidth;
         }
+        // Restore original text alignment
+        ctx.textAlign = originalAlign;
     }
     /**
      * Converts the Text Layer to a JSON representation.
@@ -290,29 +386,29 @@ class TextLayer extends BaseLayer_1.BaseLayer {
     }
     /**
      * Validates the properties of the Text Layer.
-     * @param props {ITextLayerProps} - The properties to validate.
+     * @param {ITextLayerProps} [data] - The properties to validate.
      * @returns {ITextLayerProps} The validated properties.
      */
-    validateProps(props) {
+    validateProps(data) {
         return {
-            ...super.validateProps(props),
-            text: props.text || "",
+            ...super.validateProps(data),
+            filled: data.filled || true,
+            fillStyle: data.fillStyle || '#000000',
+            text: data.text || "",
             font: {
-                family: props.font?.family || "Arial",
-                size: props.font?.size || 16,
-                weight: props.font?.weight || types_1.FontWeight.Regular,
+                family: data.font?.family || "Arial",
+                size: data.font?.size || 16,
+                weight: data.font?.weight || types_1.FontWeight.Regular,
             },
             multiline: {
-                enabled: props.multiline?.enabled || false,
-                spacing: props.multiline?.spacing || 1.1,
+                enabled: data.multiline?.enabled || false,
+                spacing: data.multiline?.spacing || 1.1,
             },
             size: {
-                width: props.size?.width || "vw",
-                height: props.size?.height || 0,
+                width: data.size?.width || "vw",
+                height: data.size?.height || 0,
             },
-            align: props.align || types_1.TextAlign.Left,
-            fillStyle: props.fillStyle || "#000000",
-            filled: props.filled !== undefined ? props.filled : true,
+            align: data.align || types_1.TextAlign.Left,
         };
     }
 }

package/dist/structures/helpers/Exporter.d.ts

@@ -16,24 +16,24 @@ export declare class Exporter {
     constructor(canvas: LazyCanvas);
     /**
      * Saves a file to the filesystem.
-     * @param buffer {any} - The data to be saved.
-     * @param extension {Extensions} - The file extension.
-     * @param name {string} - The name of the file (optional).
+     * @param {any} [buffer] - The data to be saved.
+     * @param {Extensions} [extension] - The file extension.
+     * @param {string} [name] - The name of the file (optional).
      * @throws {LazyError} If the buffer or extension is not provided.
      */
     private saveFile;
     /**
      * Exports all layers from the LayersManager as an array of JSON objects.
-     * @param manager {LayersManager} - The LayersManager instance.
+     * @param {LayersManager} [manager] - The LayersManager instance.
      * @returns {any[]} An array of JSON representations of the layers.
      */
     private exportLayers;
     /**
      * Exports the canvas to the specified format.
-     * @param exportType {AnyExport} - The type of export (e.g., "png", "json").
-     * @param opts {Object} - Optional settings.
-     * @param opts.name {string} - The name of the file (optional).
-     * @param opts.saveAsFile {boolean} - Whether to save the export as a file (optional).
+     * @param {AnyExport} [exportType] - The type of export (e.g., "png", "json").
+     * @param {Object} [opts] - Optional settings.
+     * @param {string} [opts.name] - The name of the file (optional).
+     * @param {boolean} [opts.saveAsFile] - Whether to save the export as a file (optional).
      * @returns {Promise<Buffer | SKRSContext2D | Canvas | SvgCanvas | string>} The exported data.
      * @throws {LazyError} If the export type is not supported.
      */
@@ -43,7 +43,7 @@ export declare class Exporter {
     }): Promise<Buffer | SKRSContext2D | Canvas | SvgCanvas | string>;
     /**
      * Synchronously exports the canvas to the specified format.
-     * @param exportType {AnyExport} - The type of export (e.g., "json").
+     * @param {AnyExport} [exportType] - The type of export (e.g., "json").
      * @returns {IOLazyCanvas | void} The exported data or void if the export type is unsupported.
      */
     syncExport(exportType: AnyExport): IOLazyCanvas | void;

package/dist/structures/helpers/Exporter.js

@@ -56,9 +56,9 @@ class Exporter {
     }
     /**
      * Saves a file to the filesystem.
-     * @param buffer {any} - The data to be saved.
-     * @param extension {Extensions} - The file extension.
-     * @param name {string} - The name of the file (optional).
+     * @param {any} [buffer] - The data to be saved.
+     * @param {Extensions} [extension] - The file extension.
+     * @param {string} [name] - The name of the file (optional).
      * @throws {LazyError} If the buffer or extension is not provided.
      */
     async saveFile(buffer, extension, name) {
@@ -70,7 +70,7 @@ class Exporter {
     }
     /**
      * Exports all layers from the LayersManager as an array of JSON objects.
-     * @param manager {LayersManager} - The LayersManager instance.
+     * @param {LayersManager} [manager] - The LayersManager instance.
      * @returns {any[]} An array of JSON representations of the layers.
      */
     exportLayers(manager) {
@@ -82,10 +82,10 @@ class Exporter {
     }
     /**
      * Exports the canvas to the specified format.
-     * @param exportType {AnyExport} - The type of export (e.g., "png", "json").
-     * @param opts {Object} - Optional settings.
-     * @param opts.name {string} - The name of the file (optional).
-     * @param opts.saveAsFile {boolean} - Whether to save the export as a file (optional).
+     * @param {AnyExport} [exportType] - The type of export (e.g., "png", "json").
+     * @param {Object} [opts] - Optional settings.
+     * @param {string} [opts.name] - The name of the file (optional).
+     * @param {boolean} [opts.saveAsFile] - Whether to save the export as a file (optional).
      * @returns {Promise<Buffer | SKRSContext2D | Canvas | SvgCanvas | string>} The exported data.
      * @throws {LazyError} If the export type is not supported.
      */
@@ -167,7 +167,7 @@ class Exporter {
     }
     /**
      * Synchronously exports the canvas to the specified format.
-     * @param exportType {AnyExport} - The type of export (e.g., "json").
+     * @param {AnyExport} [exportType] - The type of export (e.g., "json").
      * @returns {IOLazyCanvas | void} The exported data or void if the export type is unsupported.
      */
     syncExport(exportType) {

package/dist/structures/helpers/Font.d.ts

@@ -53,28 +53,28 @@ export declare class Font implements IFont {
     constructor();
     /**
      * Sets the font family.
-     * @param family {string} - The `family` of the font.
+     * @param {string} [family] - The `family` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the family is not provided.
      */
     setFamily(family: string): this;
     /**
      * Sets the font weight.
-     * @param weight {AnyWeight} - The `weight` of the font.
+     * @param {AnyWeight} [weight] - The `weight` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the weight is not provided.
      */
     setWeight(weight: AnyWeight): this;
     /**
      * Sets the file path of the font.
-     * @param path {string} - The `path` of the font.
+     * @param {string} [path] - The `path` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the path is not provided.
      */
     setPath(path: string): this;
     /**
      * Sets the base64 representation of the font.
-     * @param base64 {Buffer} - The `base64` of the font.
+     * @param {Buffer} [base64] - The `base64` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the base64 is not provided.
      */

package/dist/structures/helpers/Font.js

@@ -31,7 +31,7 @@ class Font {
     }
     /**
      * Sets the font family.
-     * @param family {string} - The `family` of the font.
+     * @param {string} [family] - The `family` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the family is not provided.
      */
@@ -43,7 +43,7 @@ class Font {
     }
     /**
      * Sets the font weight.
-     * @param weight {AnyWeight} - The `weight` of the font.
+     * @param {AnyWeight} [weight] - The `weight` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the weight is not provided.
      */
@@ -55,7 +55,7 @@ class Font {
     }
     /**
      * Sets the file path of the font.
-     * @param path {string} - The `path` of the font.
+     * @param {string} [path] - The `path` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the path is not provided.
      */
@@ -67,7 +67,7 @@ class Font {
     }
     /**
      * Sets the base64 representation of the font.
-     * @param base64 {Buffer} - The `base64` of the font.
+     * @param {Buffer} [base64] - The `base64` of the font.
      * @returns {this} The current instance for chaining.
      * @throws {Error} If the base64 is not provided.
      */

package/dist/structures/helpers/Gradient.d.ts

@@ -1,6 +1,6 @@
 import { AnyCentring, AnyGradientType, FillType, StringColorType, ScaleType } from "../../types";
 import { SKRSContext2D } from "@napi-rs/canvas";
-import { LayersManager } from "../managers/LayersManager";
+import { LayersManager } from "../managers";
 /**
  * Interface representing a gradient.
  */
@@ -82,54 +82,59 @@ export declare class Gradient implements IGradient {
     angle?: number;
     /**
      * Constructs a new Gradient instance.
-     * @param opts {Object} - Optional properties for the gradient.
-     * @param opts.props {IGradient} - The gradient properties.
+     * @param {Object} [opts] - Optional properties for the gradient.
+     * @param {IGradient} [opts.props] - The gradient properties.
      */
     constructor(opts?: {
         props?: IGradient;
     });
     /**
      * Sets the type of the gradient.
-     * @param type {AnyGradientType} - The type of the gradient (e.g., linear, radial, conic).
+     * @param {AnyGradientType} [type] - The type of the gradient (e.g., linear, radial, conic).
      * @returns {this} The current instance for chaining.
      */
     setType(type: AnyGradientType): this;
     /**
      * Adds points to the gradient.
-     * @param points {GradientPoint[]} - The points to add to the gradient.
+     * @param {GradientPoint[]} [points] - The points to add to the gradient.
      * @returns {this} The current instance for chaining.
      */
     addPoints(...points: GradientPoint[]): this;
     /**
      * Sets the points of the gradient.
-     * @param points {GradientPoint[]} - The points to set for the gradient.
+     * @param {GradientPoint[]} [points] - The points to set for the gradient.
      * @returns {this} The current instance for chaining.
      */
     setPoints(...points: GradientPoint[]): this;
     /**
      * Removes points from the gradient by their indexes.
-     * @param indexes {number[]} - The indexes of the points to remove.
+     * @param {number[]} [indexes] - The indexes of the points to remove.
      * @returns {this} The current instance for chaining.
      */
     removePoints(...indexes: number[]): this;
     /**
      * Adds color stops to the gradient.
-     * @param stops {GradientColorStop[]} - The color stops to add to the gradient.
+     * @param {GradientColorStop[]} [stops] - The color stops to add to the gradient.
      * @returns {this} The current instance for chaining.
      */
     addStops(...stops: GradientColorStop[]): this;
     /**
      * Sets the color stops of the gradient.
-     * @param stops {GradientColorStop[]} - The color stops to set for the gradient.
+     * @param {GradientColorStop[]} [stops] - The color stops to set for the gradient.
      * @returns {this} The current instance for chaining.
      */
     setStops(...stops: GradientColorStop[]): this;
     /**
      * Removes color stops from the gradient by their indexes.
-     * @param indexes {number[]} - The indexes of the color stops to remove.
+     * @param {number[]} [indexes] - The indexes of the color stops to remove.
      * @returns {this} The current instance for chaining.
      */
     removeStops(...indexes: number[]): this;
+    /**
+     * Sets the angle of the gradient (used for linear gradients).
+     * @param {number} [angle] - The angle in degrees.
+     * @returns {this} The current instance for chaining.
+     */
     setAngle(angle: number): this;
     draw(ctx: SKRSContext2D, opts?: {
         debug?: boolean;