@nmmty/lazycanvas 0.6.5 → 1.0.0-dev.10

package/dist/structures/components/ClearLayer.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClearLayer = void 0;
-const types_1 = require("../../types");
-const utils_1 = require("../../utils/utils");
-const LazyUtil_1 = require("../../utils/LazyUtil");
-const utils_2 = require("../../utils/utils");
-/**
- * Class representing a Clear Layer.
- */
-class ClearLayer {
-    /**
-     * The unique identifier of the layer.
-     */
-    id;
-    /**
-     * The type of the layer, which is `Clear`.
-     */
-    type = types_1.LayerType.Clear;
-    /**
-     * The z-index of the layer, determining its stacking order.
-     */
-    zIndex;
-    /**
-     * The visibility of the layer.
-     */
-    visible;
-    /**
-     * The properties of the Clear Layer.
-     */
-    props;
-    /**
-     * Constructs a new ClearLayer instance.
-     * @param {IClearLayerProps} [props] - The properties of the Clear Layer.
-     * @param {IBaseLayerMisc} [misc] - Miscellaneous options for the layer.
-     */
-    constructor(props, misc) {
-        this.id = misc?.id || (0, utils_2.generateID)(types_1.LayerType.Clear);
-        this.type = types_1.LayerType.Clear;
-        this.zIndex = misc?.zIndex || 1;
-        this.visible = misc?.visible || true;
-        this.props = props ? props : {};
-        this.props = this.validateProps(this.props);
-    }
-    /**
-     * Sets the position of the layer in the 2D plane.
-     * @param {ScaleType} [x] - The x-coordinate of the layer.
-     * @param {ScaleType} [y] - The y-coordinate of the layer.
-     * @returns {this} The current instance for chaining.
-     */
-    setPosition(x, y) {
-        this.props.x = x;
-        this.props.y = y;
-        return this;
-    }
-    /**
-     * Sets the size of the layer.
-     * @param {ScaleType} [width] - The width of the layer.
-     * @param {ScaleType} [height] - The height of the layer.
-     * @returns {this} The current instance for chaining.
-     */
-    setSize(width, height) {
-        this.props.size = {
-            width,
-            height
-        };
-        return this;
-    }
-    /**
-     * 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 centring type of the layer.
-     * @param {AnyCentring} [centring] - The centring type of the layer.
-     * @returns {this} The current instance for chaining.
-     */
-    setCentring(centring) {
-        this.props.centring = centring;
-        return this;
-    }
-    /**
-     * Sets the visibility of the layer.
-     * @param {boolean} [visible] - 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 {number} [zIndex] - The z-index value of the layer.
-     * @returns {this} The current instance for chaining.
-     */
-    setZIndex(zIndex) {
-        this.zIndex = zIndex;
-        return this;
-    }
-    /**
-     * Draws the Clear Layer on the canvas.
-     * @param {SKRSContext2D} [ctx] - The canvas rendering context.
-     * @param {Canvas | SvgCanvas} [canvas] - The canvas instance.
-     * @param {LayersManager} [manager] - The layer's manager.
-     * @param {boolean} [debug] - 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({
-            xs: { v: this.props.x },
-            ys: { v: this.props.y, options: LazyUtil_1.defaultArg.vl(true) },
-            w: { v: this.props.size.width },
-        });
-        const h = parcer.parse(this.props.size.height, LazyUtil_1.defaultArg.wh(w), LazyUtil_1.defaultArg.vl(true));
-        let { x, y } = (0, utils_1.centring)(this.props.centring, this.type, w, h, xs, ys);
-        if (debug)
-            LazyUtil_1.LazyLog.log('none', `ClearLayer:`, { x, y, w, h });
-        ctx.clearRect(x, y, w, h);
-    }
-    /**
-     * Converts the Clear Layer to a JSON representation.
-     * @returns {IClearLayer} The JSON representation of the Clear Layer.
-     */
-    toJSON() {
-        let copy = { ...this.props };
-        for (const key of ['x', 'y', 'size.width', 'size.height']) {
-            if (copy[key] && typeof copy[key] === 'object' && 'toJSON' in copy[key]) {
-                copy[key] = copy[key].toJSON();
-            }
-        }
-        return {
-            id: this.id,
-            type: this.type,
-            zIndex: this.zIndex,
-            visible: this.visible,
-            props: copy,
-        };
-    }
-    validateProps(props) {
-        return {
-            x: props.x || 0,
-            y: props.y || 0,
-            size: {
-                width: props.size?.width || 0,
-                height: props.size?.height || 0
-            },
-            centring: props.centring || 'none',
-            globalComposite: props.globalComposite || 'source-over'
-        };
-    }
-}
-exports.ClearLayer = ClearLayer;

package/dist/structures/components/Group.js

@@ -1,153 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Group = void 0;
-const types_1 = require("../../types");
-const utils_1 = require("../../utils/utils");
-const LazyUtil_1 = require("../../utils/LazyUtil");
-/**
- * Class representing a group of layer's.
- */
-class Group {
-    /**
-     * The unique identifier of the group.
-     */
-    id;
-    /**
-     * The type of the group, which is `Group`.
-     */
-    type = types_1.LayerType.Group;
-    /**
-     * The visibility of the group.
-     */
-    visible;
-    /**
-     * The z-index of the group, determining its stacking order.
-     */
-    zIndex;
-    /**
-     * The layer's contained within the group.
-     */
-    layers;
-    props;
-    /**
-     * Constructs a new Group instance.
-     * @param {string} [opts.id] - The unique identifier of the group.
-     * @param {boolean} [opts.visible] - The visibility of the group.
-     * @param {number} [opts.zIndex] - The z-index of the group.
-     */
-    constructor(opts) {
-        this.id = opts?.id || (0, utils_1.generateID)(types_1.LayerType.Group);
-        this.visible = opts?.visible || true;
-        this.zIndex = opts?.zIndex || 1;
-        this.layers = [];
-        this.props = {};
-    }
-    /**
-     * Sets the ID of the group.
-     * @param {string} [id] - The unique identifier of the group.
-     * @returns {this} The current instance for chaining.
-     */
-    setID(id) {
-        this.id = id;
-        return this;
-    }
-    /**
-     * Sets the visibility of the group.
-     * @param {boolean} [visible] - The visibility state of the group.
-     * @returns {this} The current instance for chaining.
-     */
-    setVisible(visible) {
-        this.visible = visible;
-        return this;
-    }
-    /**
-     * Sets the z-index of the group.
-     * @param {number} [zIndex] - The z-index value of the group.
-     * @returns {this} The current instance for chaining.
-     */
-    setZIndex(zIndex) {
-        this.zIndex = zIndex;
-        return this;
-    }
-    /**
-     * Adds components to the group.
-     * @param {AnyLayer[]} [components] - The components to add to the group.
-     * @returns {this} The current instance for chaining.
-     */
-    add(...components) {
-        let layersArray = components.flat();
-        layersArray = layersArray.filter(l => l !== undefined);
-        layersArray = layersArray.sort((a, b) => a.zIndex - b.zIndex);
-        this.layers.push(...layersArray);
-        return this;
-    }
-    /**
-     * Removes a component from the group by its ID.
-     * @param {string} [id] - The unique identifier of the component to remove.
-     * @returns {this} The current instance for chaining.
-     */
-    remove(id) {
-        this.layers = this.layers.filter(c => c.id !== id);
-        return this;
-    }
-    /**
-     * Clears all components from the group.
-     * @returns {this} The current instance for chaining.
-     */
-    clear() {
-        this.layers = [];
-        return this;
-    }
-    /**
-     * Retrieves a component from the group by its ID.
-     * @param {string} [id] - The unique identifier of the component to retrieve.
-     * @returns {AnyLayer | undefined} The component with the specified ID, or undefined if not found.
-     */
-    get(id) {
-        return this.layers.find(c => c.id === id);
-    }
-    /**
-     * Retrieves all components from the group.
-     * @returns {AnyLayer[]} An array of all components in the group.
-     */
-    getAll() {
-        return this.layers;
-    }
-    /**
-     * Gets the number of components in the group.
-     * @returns {number} The number of components in the group.
-     */
-    get length() {
-        return this.layers.length;
-    }
-    async draw(ctx, canvas, manager, debug) {
-        for (const subLayer of this.layers) {
-            if (debug)
-                LazyUtil_1.LazyLog.log('info', `Rendering ${subLayer.id}...\nData:`, subLayer.toJSON());
-            if (subLayer.visible) {
-                if ('globalComposite' in subLayer.props && subLayer.props.globalComposite) {
-                    ctx.globalCompositeOperation = subLayer.props.globalComposite;
-                }
-                else {
-                    ctx.globalCompositeOperation = 'source-over';
-                }
-                await subLayer.draw(ctx, canvas, manager, debug);
-                ctx.shadowColor = 'transparent';
-            }
-        }
-    }
-    /**
-     * Converts the group to a JSON representation.
-     * @returns {IGroup} The JSON representation of the group.
-     */
-    toJSON() {
-        return {
-            id: this.id,
-            type: this.type,
-            visible: this.visible,
-            zIndex: this.zIndex,
-            layers: this.layers.map(c => c.toJSON())
-        };
-    }
-}
-exports.Group = Group;

package/dist/structures/managers/AnimationManager.d.ts

@@ -1,120 +0,0 @@
-import { AnyColorSpace } from "../../types";
-/**
- * Interface representing the animation manager.
- */
-export interface IAnimationManager {
-    /**
-     * The options for the animation manager.
-     */
-    options: IAnimationOptions;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug: boolean;
-}
-/**
- * Interface representing the animation options.
- */
-export interface IAnimationOptions {
-    /**
-     * The frame rate of the animation.
-     */
-    frameRate: number;
-    /**
-     * The maximum number of colors in the animation.
-     */
-    maxColors: number;
-    /**
-     * The color space used in the animation.
-     */
-    colorSpace: AnyColorSpace;
-    /**
-     * Whether the animation should loop.
-     */
-    loop: boolean;
-    /**
-     * Whether the animation should have transparency.
-     */
-    transparency: boolean;
-    /**
-     * Utility options for the animation.
-     */
-    utils: {
-        /**
-         * Whether to clear the content of previous frames.
-         */
-        clear: boolean;
-        /**
-         * Buffer-related options.
-         */
-        buffer: {
-            /**
-             * The size of the frame buffer.
-             */
-            size: number;
-        };
-    };
-}
-/**
- * Class representing the animation manager, which handles animation settings and options.
- */
-export declare class AnimationManager implements IAnimationManager {
-    /**
-     * The options for the animation manager.
-     */
-    options: IAnimationOptions;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug: boolean;
-    /**
-     * Constructs a new AnimationManager instance.
-     * @param {Object} [opts] - Optional settings for the animation manager.
-     * @param {boolean} [opts.debug] - Whether debugging is enabled.
-     * @param {Object} [opts.settings] - Additional settings for the animation manager.
-     * @param {IAnimationOptions} [opts.settings.options] - The animation options.
-     */
-    constructor(opts?: {
-        debug?: boolean;
-        settings?: {
-            options?: IAnimationOptions;
-        };
-    });
-    /**
-     * Sets the frame rate of the animation.
-     * @param {number} [frameRate] - The frame rate of the animation (default is 30).
-     * @returns {this} The current instance for chaining.
-     */
-    setFrameRate(frameRate: number): this;
-    /**
-     * Sets whether the animation should loop.
-     * @param {boolean} [loop] - Whether the animation should loop (default is true).
-     * @returns {this} The current instance for chaining.
-     */
-    setLoop(loop: boolean): this;
-    /**
-     * Sets whether the animation should have transparency.
-     * @param {boolean} [transparency] - Whether the animation should have transparency (default is true).
-     * @returns {this} The current instance for chaining.
-     */
-    setTransparent(transparency: boolean): this;
-    /**
-     * Sets the RGB format of the animation.
-     * @param {ColorSpace} [rgb] - The RGB format of the animation (default is RGB565).
-     * @returns {this} The current instance for chaining.
-     */
-    setRGBFormat(rgb: AnyColorSpace): this;
-    /**
-     * Sets the maximum number of colors in the animation.
-     * @param {number} [maxColors] - The maximum number of colors (default is 256).
-     * @returns {this} The current instance for chaining.
-     */
-    setMaxColors(maxColors: number): this;
-    /**
-     * Sets whether the content of previous frames will be cleared.
-     * @param {boolean} [clear] - Whether to clear the content of previous frames (default is true).
-     * @param {number} [bufferSize] - The size of the frame buffer (default is 0).
-     * @returns {this} The current instance for chaining.
-     */
-    setClear(clear: boolean, bufferSize?: number): this;
-}

package/dist/structures/managers/AnimationManager.js

@@ -1,99 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnimationManager = void 0;
-const types_1 = require("../../types");
-/**
- * Class representing the animation manager, which handles animation settings and options.
- */
-class AnimationManager {
-    /**
-     * The options for the animation manager.
-     */
-    options;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug;
-    /**
-     * Constructs a new AnimationManager instance.
-     * @param {Object} [opts] - Optional settings for the animation manager.
-     * @param {boolean} [opts.debug] - Whether debugging is enabled.
-     * @param {Object} [opts.settings] - Additional settings for the animation manager.
-     * @param {IAnimationOptions} [opts.settings.options] - The animation options.
-     */
-    constructor(opts) {
-        this.options = opts?.settings?.options || {
-            frameRate: 30,
-            maxColors: 256,
-            colorSpace: types_1.ColorSpace.RGB565,
-            loop: true,
-            transparency: true,
-            utils: {
-                clear: true,
-                buffer: {
-                    size: 0
-                }
-            }
-        };
-        this.debug = opts?.debug || false;
-    }
-    /**
-     * Sets the frame rate of the animation.
-     * @param {number} [frameRate] - The frame rate of the animation (default is 30).
-     * @returns {this} The current instance for chaining.
-     */
-    setFrameRate(frameRate) {
-        this.options.frameRate = frameRate;
-        return this;
-    }
-    /**
-     * Sets whether the animation should loop.
-     * @param {boolean} [loop] - Whether the animation should loop (default is true).
-     * @returns {this} The current instance for chaining.
-     */
-    setLoop(loop) {
-        this.options.loop = loop;
-        return this;
-    }
-    /**
-     * Sets whether the animation should have transparency.
-     * @param {boolean} [transparency] - Whether the animation should have transparency (default is true).
-     * @returns {this} The current instance for chaining.
-     */
-    setTransparent(transparency) {
-        this.options.transparency = transparency;
-        return this;
-    }
-    /**
-     * Sets the RGB format of the animation.
-     * @param {ColorSpace} [rgb] - The RGB format of the animation (default is RGB565).
-     * @returns {this} The current instance for chaining.
-     */
-    setRGBFormat(rgb) {
-        this.options.colorSpace = rgb;
-        return this;
-    }
-    /**
-     * Sets the maximum number of colors in the animation.
-     * @param {number} [maxColors] - The maximum number of colors (default is 256).
-     * @returns {this} The current instance for chaining.
-     */
-    setMaxColors(maxColors) {
-        this.options.maxColors = maxColors;
-        return this;
-    }
-    /**
-     * Sets whether the content of previous frames will be cleared.
-     * @param {boolean} [clear] - Whether to clear the content of previous frames (default is true).
-     * @param {number} [bufferSize] - The size of the frame buffer (default is 0).
-     * @returns {this} The current instance for chaining.
-     */
-    setClear(clear, bufferSize) {
-        this.options.utils.clear = clear;
-        if (bufferSize) {
-            this.options.utils.buffer.size = bufferSize;
-        }
-        return this;
-    }
-}
-exports.AnimationManager = AnimationManager;