@nmmty/lazycanvas 0.6.5 → 1.0.0-dev.3

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

@@ -1,230 +0,0 @@
-import { LazyCanvas } from "../LazyCanvas";
-import { AnyLayer } from "../../types";
-import { Group } from "../components";
-import { Canvas, SKRSContext2D, SvgCanvas } from "@napi-rs/canvas";
-/**
- * Interface representing a LazyCanvas plugin.
- */
-export interface ILazyCanvasPlugin {
-    /**
-     * The unique name of the plugin.
-     */
-    name: string;
-    /**
-     * The version of the plugin.
-     */
-    version: string;
-    /**
-     * Optional description of the plugin.
-     */
-    description?: string;
-    /**
-     * Optional author of the plugin.
-     */
-    author?: string;
-    /**
-     * Optional dependencies on other plugins.
-     */
-    dependencies?: string[];
-    /**
-     * Optional configuration object for the plugin.
-     */
-    config?: any;
-    /**
-     * Optional private data storage for the plugin.
-     */
-    private?: any;
-    /**
-     * Method called when the plugin is installed.
-     * @param canvas - The LazyCanvas instance.
-     * @returns true if installation was successful, false otherwise.
-     */
-    install(canvas: LazyCanvas): boolean;
-    /**
-     * Optional method called when the plugin is uninstalled.
-     * @param canvas - The LazyCanvas instance.
-     * @returns true if uninstallation was successful, false otherwise.
-     */
-    uninstall?(canvas: LazyCanvas): boolean;
-    /**
-     * Optional hooks for lifecycle events.
-     */
-    hooks?: IPluginHooks;
-}
-/**
- * Interface representing plugin hooks for lifecycle events.
- */
-export interface IPluginHooks {
-    /**
-     * Called before rendering starts.
-     */
-    beforeRender?(canvas: LazyCanvas): void;
-    /**
-     * Called after rendering completes.
-     */
-    afterRender?(canvas: LazyCanvas): void;
-    /**
-     * Called before export starts.
-     */
-    beforeExport?(canvas: LazyCanvas): void;
-    /**
-     * Called after export completes.
-     */
-    afterExport?(canvas: LazyCanvas, result: string | Buffer<ArrayBufferLike> | SKRSContext2D | Canvas | SvgCanvas): void;
-    /**
-     * Called when canvas is resized.
-     */
-    onResize?(canvas: LazyCanvas, ratio: number): void;
-    /**
-     * Called when a layer is added.
-     */
-    onLayerAdded?(canvas: LazyCanvas, layer: AnyLayer | Group): void;
-    /**
-     * Called when a layer is removed.
-     */
-    onLayerRemoved?(canvas: LazyCanvas, layerId: string): void;
-    /**
-     * Called when canvas is created/recreated.
-     */
-    onCanvasCreated?(canvas: LazyCanvas, width: number, height: number): void;
-    /**
-     * Called when a layer is modified.
-     */
-    onLayerModified?(canvas: LazyCanvas, layer: AnyLayer | Group): void;
-    /**
-     * Called when animation frame is processed.
-     */
-    onAnimationFrame?(canvas: LazyCanvas, frame: number): void;
-    /**
-     * Called when an error occurs.
-     */
-    onError?(canvas: LazyCanvas, error: Error): void;
-}
-/**
- * Interface representing the PluginManager.
- */
-export interface IPluginManager {
-    /**
-     * A map storing installed plugins with their names as keys.
-     */
-    plugins: Map<string, ILazyCanvasPlugin>;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug: boolean;
-    /**
-     * Reference to the LazyCanvas instance.
-     */
-    canvas: LazyCanvas;
-    /**
-     * Registers a plugin.
-     * @param plugin - The plugin to register.
-     */
-    register(plugin: ILazyCanvasPlugin): void;
-    /**
-     * Unregisters a plugin by name.
-     * @param pluginName - The name of the plugin to unregister.
-     * @throws {LazyError} If the plugin is not found or if other plugins depend on it.
-     */
-    unregister(pluginName: string): void;
-    /**
-     * Gets a plugin by name.
-     * @param pluginName - The name of the plugin.
-     */
-    get(pluginName: string): ILazyCanvasPlugin | undefined;
-    /**
-     * Lists all registered plugin names.
-     */
-    list(): string[];
-    /**
-     * Checks if a plugin is registered.
-     * @param pluginName - The name of the plugin.
-     */
-    has(pluginName: string): boolean;
-    /**
-     * Executes a hook for all plugins that implement it.
-     * @param hookName - The name of the hook to execute.
-     * @param args - Arguments to pass to the hook.
-     */
-    executeHook(hookName: keyof IPluginHooks, ...args: any[]): void;
-}
-/**
- * Class representing a manager for handling plugins.
- */
-export declare class PluginManager implements IPluginManager {
-    /**
-     * A map storing installed plugins with their names as keys.
-     */
-    plugins: Map<string, ILazyCanvasPlugin>;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug: boolean;
-    /**
-     * Reference to the LazyCanvas instance.
-     */
-    canvas: LazyCanvas;
-    /**
-     * Constructs a new PluginManager instance.
-     * @param {LazyCanvas} [canvas] - The LazyCanvas instance.
-     * @param {Object} [opts] - Optional settings for the PluginManager.
-     * @param {boolean} [opts.debug] - Whether debugging is enabled.
-     */
-    constructor(canvas: LazyCanvas, opts?: {
-        debug?: boolean;
-    });
-    /**
-     * Registers a plugin.
-     * @param {ILazyCanvasPlugin} [plugin] - The plugin to register.
-     * @throws {LazyError} If a plugin with the same name is already registered.
-     */
-    register(plugin: ILazyCanvasPlugin): void;
-    /**
-     * Unregisters a plugin by name.
-     * @param {string} [pluginName] - The name of the plugin to unregister.
-     * @throws {LazyError} If the plugin is not found or if other plugins depend on it.
-     */
-    unregister(pluginName: string): void;
-    /**
-     * Gets a plugin by name.
-     * @param {string} [pluginName] - The name of the plugin.
-     * @returns The plugin or undefined if not found.
-     */
-    get(pluginName: string): ILazyCanvasPlugin | undefined;
-    /**
-     * Lists all registered plugin names.
-     * @returns Array of plugin names.
-     */
-    list(): string[];
-    /**
-     * Checks if a plugin is registered.
-     * @param {string} [pluginName] - The name of the plugin.
-     * @returns True if the plugin is registered, false otherwise.
-     */
-    has(pluginName: string): boolean;
-    /**
-     * Executes a hook for all plugins that implement it.
-     * @param {keyof IPluginHooks} [hookName] - The name of the hook to execute.
-     * @param {any} [args] - Arguments to pass to the hook.
-     */
-    executeHook(hookName: keyof IPluginHooks, ...args: any[]): void;
-    /**
-     * Executes the onError hook for all plugins when an error occurs.
-     * @param error - The error that occurred.
-     */
-    private executeErrorHook;
-    /**
-     * Gets plugin information.
-     * @returns Array of plugin information objects.
-     */
-    getPluginInfo(): Array<{
-        name: string;
-        version: string;
-        description?: string;
-        dependencies?: string[];
-    }>;
-    /**
-     * Clears all plugins.
-     */
-    clear(): void;
-}

package/dist/structures/managers/PluginManager.js

@@ -1,182 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PluginManager = void 0;
-const LazyUtil_1 = require("../../utils/LazyUtil");
-/**
- * Class representing a manager for handling plugins.
- */
-class PluginManager {
-    /**
-     * A map storing installed plugins with their names as keys.
-     */
-    plugins;
-    /**
-     * Whether debugging is enabled.
-     */
-    debug;
-    /**
-     * Reference to the LazyCanvas instance.
-     */
-    canvas;
-    /**
-     * Constructs a new PluginManager instance.
-     * @param {LazyCanvas} [canvas] - The LazyCanvas instance.
-     * @param {Object} [opts] - Optional settings for the PluginManager.
-     * @param {boolean} [opts.debug] - Whether debugging is enabled.
-     */
-    constructor(canvas, opts) {
-        this.plugins = new Map();
-        this.debug = opts?.debug || false;
-        this.canvas = canvas;
-    }
-    /**
-     * Registers a plugin.
-     * @param {ILazyCanvasPlugin} [plugin] - The plugin to register.
-     * @throws {LazyError} If a plugin with the same name is already registered.
-     */
-    register(plugin) {
-        if (this.plugins.has(plugin.name)) {
-            throw new LazyUtil_1.LazyError(`Plugin '${plugin.name}' is already registered`);
-        }
-        // Check dependencies
-        if (plugin.dependencies) {
-            for (const dependency of plugin.dependencies) {
-                if (!this.plugins.has(dependency)) {
-                    throw new LazyUtil_1.LazyError(`Plugin '${plugin.name}' requires dependency '${dependency}' which is not installed`);
-                }
-            }
-        }
-        try {
-            const result = plugin.install(this.canvas);
-            this.plugins.set(plugin.name, plugin);
-            if (this.debug) {
-                LazyUtil_1.LazyLog.log('info', `Plugin '${plugin.name}' v${plugin.version} registered successfully`);
-            }
-        }
-        catch (error) {
-            throw new LazyUtil_1.LazyError(`Failed to install plugin '${plugin.name}': ${error}`);
-        }
-    }
-    /**
-     * Unregisters a plugin by name.
-     * @param {string} [pluginName] - The name of the plugin to unregister.
-     * @throws {LazyError} If the plugin is not found or if other plugins depend on it.
-     */
-    unregister(pluginName) {
-        const plugin = this.plugins.get(pluginName);
-        if (!plugin) {
-            throw new LazyUtil_1.LazyError(`Plugin '${pluginName}' is not registered`);
-        }
-        // Check if other plugins depend on this one
-        this.plugins.forEach((p, name) => {
-            if (name !== pluginName && p.dependencies?.includes(pluginName)) {
-                throw new LazyUtil_1.LazyError(`Cannot unregister plugin '${pluginName}' because plugin '${name}' depends on it`);
-            }
-        });
-        try {
-            if (plugin.uninstall) {
-                plugin.uninstall(this.canvas);
-            }
-            this.plugins.delete(pluginName);
-            if (this.debug) {
-                LazyUtil_1.LazyLog.log('info', `Plugin '${pluginName}' unregistered successfully`);
-            }
-        }
-        catch (error) {
-            throw new LazyUtil_1.LazyError(`Failed to uninstall plugin '${pluginName}': ${error}`);
-        }
-    }
-    /**
-     * Gets a plugin by name.
-     * @param {string} [pluginName] - The name of the plugin.
-     * @returns The plugin or undefined if not found.
-     */
-    get(pluginName) {
-        return this.plugins.get(pluginName);
-    }
-    /**
-     * Lists all registered plugin names.
-     * @returns Array of plugin names.
-     */
-    list() {
-        return Array.from(this.plugins.keys());
-    }
-    /**
-     * Checks if a plugin is registered.
-     * @param {string} [pluginName] - The name of the plugin.
-     * @returns True if the plugin is registered, false otherwise.
-     */
-    has(pluginName) {
-        return this.plugins.has(pluginName);
-    }
-    /**
-     * Executes a hook for all plugins that implement it.
-     * @param {keyof IPluginHooks} [hookName] - The name of the hook to execute.
-     * @param {any} [args] - Arguments to pass to the hook.
-     */
-    executeHook(hookName, ...args) {
-        this.plugins.forEach(plugin => {
-            try {
-                const hook = plugin.hooks?.[hookName];
-                if (hook) {
-                    hook(...args);
-                }
-            }
-            catch (error) {
-                if (this.debug) {
-                    LazyUtil_1.LazyLog.log('error', `Error executing hook '${hookName}' for plugin '${plugin.name}': ${error}`);
-                }
-                // Execute onError hook for all plugins when a hook fails
-                this.executeErrorHook(error);
-            }
-        });
-    }
-    /**
-     * Executes the onError hook for all plugins when an error occurs.
-     * @param error - The error that occurred.
-     */
-    executeErrorHook(error) {
-        this.plugins.forEach(plugin => {
-            try {
-                const errorHook = plugin.hooks?.onError;
-                if (errorHook) {
-                    errorHook(this.canvas, error);
-                }
-            }
-            catch (hookError) {
-                if (this.debug) {
-                    LazyUtil_1.LazyLog.log('error', `Error in onError hook for plugin '${plugin.name}': ${hookError}`);
-                }
-            }
-        });
-    }
-    /**
-     * Gets plugin information.
-     * @returns Array of plugin information objects.
-     */
-    getPluginInfo() {
-        return Array.from(this.plugins.values()).map(plugin => ({
-            name: plugin.name,
-            version: plugin.version,
-            description: plugin.description,
-            dependencies: plugin.dependencies
-        }));
-    }
-    /**
-     * Clears all plugins.
-     */
-    clear() {
-        const pluginNames = this.list();
-        for (const name of pluginNames) {
-            try {
-                this.unregister(name);
-            }
-            catch (error) {
-                if (this.debug) {
-                    LazyUtil_1.LazyLog.log('error', `Error unregistering plugin '${name}': ${error}`);
-                }
-            }
-        }
-    }
-}
-exports.PluginManager = PluginManager;

package/dist/types/types.d.ts

@@ -1,107 +0,0 @@
-import { Gradient, Link, Pattern } from "../structures/helpers";
-import {
-    MorphLayer,
-    ImageLayer,
-    TextLayer,
-    BezierLayer,
-    QuadraticLayer,
-    LineLayer,
-    ClearLayer,
-    Path2DLayer,
-    IMorphLayer,
-    IBezierLayer,
-    IClearLayer,
-    IImageLayer,
-    ITextLayer,
-    IQuadraticLayer,
-    ILineLayer,
-    IPath2DLayer,
-    IPolygonLayer,
-    PolygonLayer
-} from "../structures/components";
-import {
-    FontWeight,
-    GradientType,
-    TextAlign,
-    TextBaseline,
-    TextDirection,
-    LineCap,
-    LineJoin,
-    Export,
-    Centring,
-    PatternType,
-    LinkType,
-    GlobalCompositeOperation,
-    ColorSpace,
-} from "./enum";
-
-export type ScaleType = `link-w-${string}-${number}` | `link-h-${string}-${number}` | `link-x-${string}-${number}` | `link-y-${string}-${number}` | `${number}%` | `${number}px` | number | 'vw' | 'vh' | 'vmin' | 'vmax' | Link;
-
-export type StringColorType = `rgba(${number}, ${number}, ${number}, ${number})` | `rgb(${number}, ${number}, ${number})` | `hsl(${number}, ${number}%, ${number}%)` | `hsla(${number}, ${number}%, ${number}%, ${number})` | `#${string}` | string;
-
-export type ColorType = Gradient | Pattern | StringColorType;
-
-export type JSONLayer = IMorphLayer | IImageLayer | ITextLayer | IBezierLayer | IQuadraticLayer | ILineLayer | IClearLayer | IPath2DLayer | IPolygonLayer;
-
-export type AnyLayer = MorphLayer | ImageLayer | TextLayer | BezierLayer | QuadraticLayer | LineLayer | ClearLayer | Path2DLayer | PolygonLayer;
-
-export type AnyWeight = FontWeight | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | 950;
-
-export type AnyGradientType = GradientType | 'linear' | 'radial' | 'conic';
-
-export type AnyTextAlign = TextAlign | 'left' | 'right' | 'center' | 'start' | 'end';
-
-export type AnyTextBaseline = TextBaseline | 'top' | 'hanging' | 'middle' | 'alphabetic' | 'ideographic' | 'bottom';
-
-export type AnyTextDirection = TextDirection | 'ltr' | 'rtl' | 'inherit';
-
-export type AnyLineCap = LineCap | 'butt' | 'round' | 'square';
-
-export type AnyLineJoin = LineJoin | 'bevel' | 'round' | 'miter';
-
-export type AnyExport = Export | 'canvas' | 'ctx' | 'buffer' | 'svg' | 'png' | 'jpeg' | 'jpg' | 'gif' | 'webp' | 'yaml' | 'json';
-
-export type AnyCentring = Centring | 'start' | 'start-top' | 'start-bottom' | 'center' | 'center-top' | 'center-bottom' | 'end' | 'end-top' | 'end-bottom' | 'none';
-
-export type AnyPatternType = PatternType | 'repeat' | 'repeat-x' | 'repeat-y' | 'no-repeat';
-
-export type AnyLinkType = LinkType | 'width' | 'height' | 'x' | 'y';
-
-export type AnyGlobalCompositeOperation = GlobalCompositeOperation | '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';
-
-export type AnyColorSpace = ColorSpace | 'rgb565' | 'rgba4444' | 'rgba444';
-
-export type AnyFilter = `sepia(${number}%)` | `saturate(${number}%)` | `opacity(${number}%)` | `invert(${number}%)` | `hue-rotate(${number}deg)` | `grayscale(${number}%)` | `drop-shadow(${number}px ${number}px ${number}px ${string})` | `contrast(${number}%)` | `brightness(${number}%)` | `blur(${number}px)`;
-
-export type Point = {
-    x: ScaleType;
-    y: ScaleType;
-}
-
-export type PointNumber = {
-    x: number;
-    y: number;
-};
-
-export type Extensions = 'svg' | 'png' | 'jpeg' | 'jpg' | 'gif' | 'webp' | 'yaml' | 'json';
-
-export interface Transform {
-    rotate: number;
-    scale: {
-        x: number;
-        y: number;
-    };
-    translate: {
-        x: number;
-        y: number;
-    };
-    matrix: DOMMatrix2DInit;
-}
-
-export type RadiusCorner = 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom' | 'all';
-
-export type SubStringColor = {
-    color: StringColorType;
-    start: number;
-    end: number;
-}