@nmmty/lazycanvas 0.4.0 → 0.5.1

package/dist/structures/components/MorphLayer.js

@@ -2,27 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MorphLayer = void 0;
 const BaseLayer_1 = require("./BaseLayer");
-const enum_1 = require("../../types/enum");
+const types_1 = require("../../types");
 const utils_1 = require("../../utils/utils");
 const LazyUtil_1 = require("../../utils/LazyUtil");
-const Gradient_1 = require("../helpers/Gradient");
-const Pattern_1 = require("../helpers/Pattern");
+/**
+ * Class representing a Morph Layer, extending the BaseLayer class.
+ */
 class MorphLayer extends BaseLayer_1.BaseLayer {
+    /**
+     * The properties of the Morph Layer.
+     */
     props;
-    constructor(props) {
-        super(enum_1.LayerType.Morph, props || {});
+    /**
+     * Constructs a new MorphLayer instance.
+     * @param props {IMorphLayerProps} - The properties of the Morph Layer.
+     * @param misc {IBaseLayerMisc} - Miscellaneous options for the layer.
+     */
+    constructor(props, misc) {
+        super(types_1.LayerType.Morph, props || {}, misc);
         this.props = props ? props : {};
         if (!this.props.fillStyle)
             this.props.fillStyle = '#000000';
         if (!this.props.filled && this.props.filled !== false)
             this.props.filled = true;
-        this.props.centring = enum_1.Centring.Center;
+        this.props.centring = types_1.Centring.Center;
     }
     /**
-     * @description Sets size of the morph layer. You can use `numbers`, `percentages`, `px`, `vw`, `vh`, `vmin`, `vmax`.
-     * @param width {ScaleType} - The `width` of the morph layer.
-     * @param height {ScaleType} - The `height` of the morph layer.
-     * @param radius {ScaleType} - The `radius` of the morph layer. (optional)
+     * Sets the size of the Morph Layer.
+     * @param width {ScaleType} - The width of the Morph Layer.
+     * @param height {ScaleType} - The height of the Morph Layer.
+     * @param radius {ScaleType} - The radius of the Morph Layer (optional).
+     * @returns {this} The current instance for chaining.
      */
     setSize(width, height, radius) {
         this.props.size = {
@@ -33,33 +43,28 @@ class MorphLayer extends BaseLayer_1.BaseLayer {
         return this;
     }
     /**
-     * @description Sets the color of the layer. You can use `hex`, `rgb`, `rgba`, `hsl`, `hsla`, and `Gradient`color.
-     * @param color {string} - The `color` of the layer.
+     * Sets the color of the Morph Layer.
+     * @param color {string} - The color of the Morph Layer.
+     * @returns {this} The current instance for chaining.
+     * @throws {LazyError} If the color is not provided or invalid.
      */
     setColor(color) {
         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');
-        let fill = (0, utils_1.parseColor)(color);
-        if (fill instanceof Gradient_1.Gradient || fill instanceof Pattern_1.Pattern) {
-            this.props.fillStyle = fill;
-        }
-        else {
-            let arr = fill.split(':');
-            this.props.fillStyle = arr[0];
-            this.props.opacity = parseFloat(arr[1]) || 1;
-        }
+        this.props.fillStyle = color;
         return this;
     }
     /**
-     * @description Sets the stroke of the layer.
-     * @param width {number} - The `width` of the stroke.
-     * @param cap {string} - The `cap` of the stroke.
-     * @param join {string} - The `join` of the stroke.
-     * @param dash {number[]} - The `dash` of the stroke.
-     * @param dashOffset {number} - The `dashOffset` of the stroke.
-     * @param miterLimit {number} - The `miterLimit` of the stroke.
+     * Sets the stroke properties of the Morph Layer.
+     * @param width {number} - The width of the stroke.
+     * @param cap {string} - The cap style of the stroke.
+     * @param join {string} - The join style of the stroke.
+     * @param dash {number[]} - The dash pattern of the stroke.
+     * @param dashOffset {number} - The dash offset of the stroke.
+     * @param miterLimit {number} - The miter limit of the stroke.
+     * @returns {this} The current instance for chaining.
      */
     setStroke(width, cap, join, dash, dashOffset, miterLimit) {
         this.props.stroke = {
@@ -73,13 +78,21 @@ class MorphLayer extends BaseLayer_1.BaseLayer {
         return this;
     }
     /**
-     * @description Sets the fills of the layer. If `true` the layer will be filled, if `false` the layer will be stroked.
-     * @param filled {boolean} - The `filled` of the layer.
+     * Sets whether the Morph Layer should be filled or stroked.
+     * @param filled {boolean} - If true, the layer will be filled; otherwise, it will be stroked.
+     * @returns {this} The current instance for chaining.
      */
     setFilled(filled) {
         this.props.filled = filled;
         return this;
     }
+    /**
+     * Draws the Morph 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.
+     */
     async draw(ctx, canvas, manager, debug) {
         const parcer = (0, utils_1.parser)(ctx, canvas, manager);
         const { xs, ys, w } = parcer.parseBatch({
@@ -127,12 +140,18 @@ class MorphLayer extends BaseLayer_1.BaseLayer {
         ctx.restore();
     }
     /**
-     * @returns {IMorphLayer}
+     * Converts the Morph Layer to a JSON representation.
+     * @returns {IMorphLayer} The JSON representation of the Morph Layer.
      */
     toJSON() {
         let data = super.toJSON();
-        data.props = this.props;
-        return { ...data };
+        let copy = { ...this.props };
+        for (const key of ['x', 'y', 'size.width', 'size.height', 'size.radius', 'fillStyle']) {
+            if (copy[key] && typeof copy[key] === 'object' && 'toJSON' in copy[key]) {
+                copy[key] = copy[key].toJSON();
+            }
+        }
+        return { ...data, props: copy };
     }
 }
 exports.MorphLayer = MorphLayer;

package/dist/structures/components/Path2DLayer.d.ts

@@ -0,0 +1,164 @@
+import { Canvas, DOMMatrix2DInit, FillType, Path2D, PathOp, SKRSContext2D, StrokeOptions, SvgCanvas } from "@napi-rs/canvas";
+import { AnyFilter, AnyGlobalCompositeOperation, ColorType, LayerType } from "../../types";
+import { BaseLayer, IBaseLayer, IBaseLayerMisc, IBaseLayerProps } from "./BaseLayer";
+import { LayersManager } from "../managers/LayersManager";
+export interface IPath2DLayer extends IBaseLayer {
+    type: LayerType.Path;
+    props: IPath2DLayerProps;
+}
+export interface IPath2DLayerProps extends IBaseLayerProps {
+    path2D: Path2D;
+    /**
+     * The stroke properties of the Path2D.
+     */
+    stroke: {
+        /**
+         * The width of the stroke.
+         */
+        width: number;
+        /**
+         * The cap style of the stroke.
+         */
+        cap: CanvasLineCap;
+        /**
+         * The join style of the stroke.
+         */
+        join: CanvasLineJoin;
+        /**
+         * The dash offset of the stroke.
+         */
+        dashOffset: number;
+        /**
+         * The dash pattern of the stroke.
+         */
+        dash: number[];
+        /**
+         * The miter limit of the stroke.
+         */
+        miterLimit: number;
+    };
+    loadFromSVG: boolean;
+    clipPath: boolean;
+}
+export declare class Path2DLayer extends BaseLayer<IPath2DLayerProps> {
+    id: string;
+    type: LayerType.Path;
+    zIndex: number;
+    visible: boolean;
+    props: IPath2DLayerProps;
+    constructor(props?: IPath2DLayerProps, misc?: IBaseLayerMisc);
+    /**
+     * Sets the unique identifier of the layer.
+     *
+     * @param {string} id - The unique identifier.
+     * @returns {this} The current instance for chaining.
+     */
+    setID(id: string): this;
+    /**
+     * Sets the visibility of the layer.
+     * @param visible {boolean} - The visibility state of the layer.
+     * @returns {this} The current instance for chaining.
+     */
+    setVisible(visible: boolean): this;
+    /**
+     * Sets the z-index of the layer.
+     * @param zIndex {number} - The z-index value of the layer.
+     * @returns {this} The current instance for chaining.
+     */
+    setZIndex(zIndex: number): this;
+    /**
+     * Sets the global composite operation for the layer.
+     * @param {AnyGlobalCompositeOperation} operation - The composite operation.
+     * @returns {this} The current instance for chaining.
+     */
+    setGlobalCompositeOperation(operation: AnyGlobalCompositeOperation): this;
+    /**
+     * Sets the filter effects for the layer.
+     * @param {...AnyFilter} filter - The filter effects to apply.
+     * @returns {this} The current instance for chaining.
+     */
+    setFilters(...filter: AnyFilter[]): this;
+    /**
+     * Sets the transformation matrix of the layer.
+     * @param {DOMMatrix2DInit} matrix - The transformation matrix.
+     * @returns {this} The current instance for chaining.
+     */
+    setMatrix(matrix: DOMMatrix2DInit): this;
+    /**
+     * Sets the scale of the layer in the x and y directions.
+     * @param {number} x - The scale factor in the x direction.
+     * @param {number} y - The scale factor in the y direction.
+     * @returns {this} The current instance for chaining.
+     */
+    setScale(x: number, y: number): this;
+    /**
+     * Sets the translation of the layer in the x and y directions.
+     * @param {number} x - The translation in the x direction.
+     * @param {number} y - The translation in the y direction.
+     * @returns {this} The current instance for chaining.
+     */
+    setTranslate(x: number, y: number): this;
+    /**
+     * Sets the opacity of the layer.
+     * @param {number} opacity - The opacity value, between 0 and 1.
+     * @returns {this} The current instance for chaining.
+     */
+    setOpacity(opacity: number): this;
+    /**
+     * Sets the stroke properties of the Path2D Layer.
+     * @param width {number} - The width of the stroke.
+     * @param cap {string} - The cap style of the stroke.
+     * @param join {string} - The join style of the stroke.
+     * @param dash {number[]} - The dash pattern of the stroke.
+     * @param dashOffset {number} - The dash offset of the stroke.
+     * @param miterLimit {number} - The miter limit of the stroke.
+     * @returns {this} The current instance for chaining.
+     */
+    setStroke(width: number, cap?: CanvasLineCap, join?: CanvasLineJoin, dash?: number[], dashOffset?: number, miterLimit?: number): this;
+    /**
+     * Sets whether the Path2D Layer should be filled or stroked.
+     * @param filled {boolean} - If true, the layer will be filled; otherwise, it will be stroked.
+     * @returns {this} The current instance for chaining.
+     */
+    setFilled(filled: boolean): this;
+    /**
+     * Sets the color of the Path2D Layer.
+     * @param color {string} - The color of the Path2D Layer.
+     * @returns {this} The current instance for chaining.
+     * @throws {LazyError} If the color is not provided or invalid.
+     */
+    setColor(color: ColorType): this;
+    setPath(path: Path2D | string): this;
+    loadFromSVG(path: true): this;
+    setClipPath(clipPath: boolean): this;
+    toSVGString(): string;
+    addPath(path: Path2D, transform?: DOMMatrix2DInit | undefined): this;
+    arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, anticlockwise?: boolean): this;
+    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): this;
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): this;
+    closePath(): this;
+    ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, anticlockwise?: boolean): this;
+    lineTo(x: number, y: number): this;
+    moveTo(x: number, y: number): this;
+    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): this;
+    rect(x: number, y: number, width: number, height: number): this;
+    stroke(stroke?: StrokeOptions): this;
+    op(path: Path2D, op: PathOp): this;
+    getFillType(): FillType;
+    getFillTypeString(): string;
+    setFillType(fillType: FillType): this;
+    simplify(): this;
+    asWinding(): this;
+    transform(matrix: DOMMatrix2DInit): this;
+    getBounds(): [left: number, top: number, right: number, bottom: number];
+    computeTightBounds(): [left: number, top: number, right: number, bottom: number];
+    trim(start: number, end: number, isComplement?: boolean): this;
+    equals(path: Path2DLayer): boolean;
+    roundRect(x: number, y: number, width: number, height: number, radius: number): this;
+    draw(ctx: SKRSContext2D, canvas: Canvas | SvgCanvas, manager: LayersManager, debug: boolean): Promise<void>;
+    /**
+     * Converts the Path2D Layer to a JSON representation.
+     * @returns {IPath2DLayer} The JSON representation of the Path2D Layer.
+     */
+    toJSON(): IPath2DLayer;
+}

package/dist/structures/components/Path2DLayer.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Path2DLayer = void 0;
+const canvas_1 = require("@napi-rs/canvas");
+const types_1 = require("../../types");
+const utils_1 = require("../../utils/utils");
+const BaseLayer_1 = require("./BaseLayer");
+const LazyUtil_1 = require("../../utils/LazyUtil");
+class Path2DLayer extends BaseLayer_1.BaseLayer {
+    id;
+    type = types_1.LayerType.Path;
+    zIndex;
+    visible;
+    props;
+    constructor(props, misc) {
+        super(types_1.LayerType.Path, props || {}, misc);
+        this.id = misc?.id || (0, utils_1.generateID)(types_1.LayerType.Path);
+        this.zIndex = misc?.zIndex || 1;
+        this.visible = misc?.visible || true;
+        this.props = props ? props : {};
+    }
+    /**
+     * Sets the unique identifier of the layer.
+     *
+     * @param {string} id - The unique identifier.
+     * @returns {this} The current instance for chaining.
+     */
+    setID(id) {
+        this.id = id;
+        return this;
+    }
+    /**
+     * Sets the visibility of the layer.
+     * @param visible {boolean} - The visibility state of the layer.
+     * @returns {this} The current instance for chaining.
+     */
+    setVisible(visible) {
+        this.visible = visible;
+        return this;
+    }
+    /**
+     * Sets the z-index of the layer.
+     * @param zIndex {number} - The z-index value of the layer.
+     * @returns {this} The current instance for chaining.
+     */
+    setZIndex(zIndex) {
+        this.zIndex = zIndex;
+        return this;
+    }
+    /**
+     * Sets the global composite operation for the layer.
+     * @param {AnyGlobalCompositeOperation} operation - The composite operation.
+     * @returns {this} The current instance for chaining.
+     */
+    setGlobalCompositeOperation(operation) {
+        this.props.globalComposite = operation;
+        return this;
+    }
+    /**
+     * Sets the filter effects for the layer.
+     * @param {...AnyFilter} filter - The filter effects to apply.
+     * @returns {this} The current instance for chaining.
+     */
+    setFilters(...filter) {
+        this.props.filter = filter.join(' ');
+        return this;
+    }
+    /**
+     * Sets the transformation matrix of the layer.
+     * @param {DOMMatrix2DInit} matrix - The transformation matrix.
+     * @returns {this} The current instance for chaining.
+     */
+    setMatrix(matrix) {
+        this.props.transform = { ...this.props.transform, matrix };
+        return this;
+    }
+    /**
+     * Sets the scale of the layer in the x and y directions.
+     * @param {number} x - The scale factor in the x direction.
+     * @param {number} y - The scale factor in the y direction.
+     * @returns {this} The current instance for chaining.
+     */
+    setScale(x, y) {
+        this.props.transform = { ...this.props.transform, scale: { x, y } };
+        return this;
+    }
+    /**
+     * Sets the translation of the layer in the x and y directions.
+     * @param {number} x - The translation in the x direction.
+     * @param {number} y - The translation in the y direction.
+     * @returns {this} The current instance for chaining.
+     */
+    setTranslate(x, y) {
+        this.props.transform = { ...this.props.transform, translate: { x, y } };
+        return this;
+    }
+    /**
+     * Sets the opacity of the layer.
+     * @param {number} opacity - The opacity value, between 0 and 1.
+     * @returns {this} The current instance for chaining.
+     */
+    setOpacity(opacity) {
+        this.props.opacity = opacity;
+        return this;
+    }
+    /**
+     * Sets the stroke properties of the Path2D Layer.
+     * @param width {number} - The width of the stroke.
+     * @param cap {string} - The cap style of the stroke.
+     * @param join {string} - The join style of the stroke.
+     * @param dash {number[]} - The dash pattern of the stroke.
+     * @param dashOffset {number} - The dash offset of the stroke.
+     * @param miterLimit {number} - The miter limit of the stroke.
+     * @returns {this} The current instance for chaining.
+     */
+    setStroke(width, cap, join, dash, dashOffset, miterLimit) {
+        this.props.stroke = {
+            width,
+            cap: cap || 'butt',
+            join: join || 'miter',
+            dash: dash || [],
+            dashOffset: dashOffset || 0,
+            miterLimit: miterLimit || 10,
+        };
+        return this;
+    }
+    /**
+     * Sets whether the Path2D Layer should be filled or stroked.
+     * @param filled {boolean} - If true, the layer will be filled; otherwise, it will be stroked.
+     * @returns {this} The current instance for chaining.
+     */
+    setFilled(filled) {
+        this.props.filled = filled;
+        return this;
+    }
+    /**
+     * Sets the color of the Path2D Layer.
+     * @param color {string} - The color of the Path2D Layer.
+     * @returns {this} The current instance for chaining.
+     * @throws {LazyError} If the color is not provided or invalid.
+     */
+    setColor(color) {
+        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;
+        return this;
+    }
+    setPath(path) {
+        this.props.path2D = path instanceof canvas_1.Path2D ? path : new canvas_1.Path2D(path);
+        return this;
+    }
+    loadFromSVG(path) {
+        this.props.loadFromSVG = path;
+        return this;
+    }
+    setClipPath(clipPath) {
+        this.props.clipPath = clipPath;
+        return this;
+    }
+    toSVGString() {
+        return this.props.path2D.toSVGString();
+    }
+    addPath(path, transform) {
+        this.props.path2D.addPath(path, transform);
+        return this;
+    }
+    arc(x, y, radius, startAngle, endAngle, anticlockwise) {
+        this.props.path2D.arc(x, y, radius, startAngle, endAngle, anticlockwise);
+        return this;
+    }
+    arcTo(x1, y1, x2, y2, radius) {
+        this.props.path2D.arcTo(x1, y1, x2, y2, radius);
+        return this;
+    }
+    bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y) {
+        this.props.path2D.bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y);
+        return this;
+    }
+    closePath() {
+        this.props.path2D.closePath();
+        return this;
+    }
+    ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle, anticlockwise) {
+        this.props.path2D.ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle, anticlockwise);
+        return this;
+    }
+    lineTo(x, y) {
+        this.props.path2D.lineTo(x, y);
+        return this;
+    }
+    moveTo(x, y) {
+        this.props.path2D.moveTo(x, y);
+        return this;
+    }
+    quadraticCurveTo(cpx, cpy, x, y) {
+        this.props.path2D.quadraticCurveTo(cpx, cpy, x, y);
+        return this;
+    }
+    rect(x, y, width, height) {
+        this.props.path2D.rect(x, y, width, height);
+        return this;
+    }
+    stroke(stroke) {
+        this.props.path2D.stroke(stroke);
+        return this;
+    }
+    op(path, op) {
+        this.props.path2D.op(path, op);
+        return this;
+    }
+    getFillType() {
+        return this.props.path2D.getFillType();
+    }
+    getFillTypeString() {
+        return this.props.path2D.getFillTypeString();
+    }
+    setFillType(fillType) {
+        this.props.path2D.setFillType(fillType);
+        return this;
+    }
+    simplify() {
+        this.props.path2D.simplify();
+        return this;
+    }
+    asWinding() {
+        this.props.path2D.asWinding();
+        return this;
+    }
+    transform(matrix) {
+        this.props.path2D.transform(matrix);
+        return this;
+    }
+    getBounds() {
+        return this.props.path2D.getBounds();
+    }
+    computeTightBounds() {
+        return this.props.path2D.computeTightBounds();
+    }
+    trim(start, end, isComplement) {
+        this.props.path2D.trim(start, end, isComplement);
+        return this;
+    }
+    equals(path) {
+        return this.props.path2D.equals(path.props.path2D);
+    }
+    roundRect(x, y, width, height, radius) {
+        this.props.path2D.roundRect(x, y, width, height, radius);
+        return this;
+    }
+    async draw(ctx, canvas, manager, debug) {
+        ctx.beginPath();
+        ctx.save();
+        let fillStyle = await (0, utils_1.parseFillStyle)(ctx, this.props.fillStyle);
+        (0, utils_1.transform)(ctx, this.props.transform, { width: 0, height: 0, x: 0, y: 0, type: this.type });
+        (0, utils_1.opacity)(ctx, this.props.opacity);
+        ctx.globalCompositeOperation = this.props.globalComposite;
+        if (this.props.clipPath) {
+            ctx.clip(this.props.path2D);
+        }
+        else if (this.props.filled) {
+            ctx.fillStyle = fillStyle;
+            ctx.fill(this.props.path2D);
+        }
+        else {
+            ctx.strokeStyle = fillStyle;
+            ctx.lineWidth = this.props.stroke.width;
+            ctx.lineCap = this.props.stroke.cap;
+            ctx.lineJoin = this.props.stroke.join;
+            ctx.miterLimit = this.props.stroke.miterLimit;
+            ctx.lineDashOffset = this.props.stroke.dashOffset;
+            ctx.setLineDash(this.props.stroke.dash);
+            ctx.stroke(this.props.path2D);
+        }
+        ctx.restore();
+        ctx.closePath();
+    }
+    /**
+     * Converts the Path2D Layer to a JSON representation.
+     * @returns {IPath2DLayer} The JSON representation of the Path2D Layer.
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            type: this.type,
+            zIndex: this.zIndex,
+            visible: this.visible,
+            props: this.props
+        };
+    }
+}
+exports.Path2DLayer = Path2DLayer;