@pixagram/renderart 0.4.5 → 1.0.0

package/dist/index.d.mts

@@ -1,305 +0,0 @@
-/**
- * Common types for RenderArt module
- */
-/** RGBA pixel data as Uint8ClampedArray or Uint8Array */
-type PixelData = Uint8ClampedArray | Uint8Array;
-/** Input image data structure */
-interface ImageInput {
-    /** Raw RGBA pixel data */
-    data: PixelData;
-    /** Image width in pixels */
-    width: number;
-    /** Image height in pixels */
-    height: number;
-}
-/** Output image data structure */
-interface ImageOutput {
-    /** Raw RGBA pixel data */
-    data: Uint8ClampedArray;
-    /** Output width in pixels */
-    width: number;
-    /** Output height in pixels */
-    height: number;
-}
-/** Rendering backend type */
-type Backend = 'gpu' | 'cpu' | 'auto';
-/** CRT effect configuration */
-interface CrtOptions {
-    /** Scale factor (2-32, default: 3) */
-    scale?: number;
-    /** Horizontal warp intensity (0.0-0.1, default: 0.015) */
-    warpX?: number;
-    /** Vertical warp intensity (0.0-0.1, default: 0.02) */
-    warpY?: number;
-    /** Scanline hardness (-10 to 0, default: -4) */
-    scanHardness?: number;
-    /** Scanline opacity (0.0-1.0, default: 0.5) */
-    scanOpacity?: number;
-    /** Shadow mask opacity (0.0-1.0, default: 0.3) */
-    maskOpacity?: number;
-    /** Enable barrel distortion (default: true) */
-    enableWarp?: boolean;
-    /** Enable scanlines (default: true) */
-    enableScanlines?: boolean;
-    /** Enable shadow mask (default: true) */
-    enableMask?: boolean;
-    /** Rendering backend (default: 'auto') */
-    backend?: Backend;
-}
-/** CRT preset names */
-type CrtPreset = 'default' | 'authentic' | 'subtle' | 'flat';
-/** Hexagon orientation */
-type HexOrientation = 'flat-top' | 'pointy-top';
-/** Hexagonal upscaling configuration */
-interface HexOptions {
-    /** Scale factor (2-32, default: 16) */
-    scale?: number;
-    /** Hexagon orientation (default: 'flat-top') */
-    orientation?: HexOrientation;
-    /** Draw hexagon borders (default: false) */
-    drawBorders?: boolean;
-    /** Border color as CSS color or 0xRRGGBBAA (default: '#282828') */
-    borderColor?: string | number;
-    /** Border thickness in pixels (default: 1) */
-    borderThickness?: number;
-    /** Background color (default: 'transparent') */
-    backgroundColor?: string | number;
-    /** Rendering backend (default: 'auto') */
-    backend?: Backend;
-}
-/** HEX preset names */
-type HexPreset = 'default' | 'bordered' | 'pointy';
-/** xBRZ scaling configuration */
-interface XbrzOptions {
-    /** Scale factor (2-6, default: 2) */
-    scale?: number;
-    /** Luminance weight for edge detection (0.0-1.0, default: 1.0) */
-    luminanceWeight?: number;
-    /** Equal color tolerance (0-50, default: 30) */
-    equalColorTolerance?: number;
-    /** Dominant direction threshold (3.5-6.0, default: 4.4) */
-    dominantDirectionThreshold?: number;
-    /** Steep direction threshold (2.0-3.0, default: 2.2) */
-    steepDirectionThreshold?: number;
-}
-/** XBRZ preset names */
-type XbrzPreset = 'default' | 'sharp' | 'smooth';
-/** Renderer capabilities */
-interface RendererCapabilities {
-    /** WebGL2 GPU rendering available */
-    gpu: boolean;
-    /** WASM CPU rendering available */
-    cpu: boolean;
-    /** Maximum texture size (GPU) */
-    maxTextureSize: number;
-    /** Recommended backend for current device */
-    recommendedBackend: Backend;
-}
-/** Render statistics */
-interface RenderStats {
-    /** Rendering time in milliseconds */
-    renderTimeMs: number;
-    /** Backend used for rendering */
-    backend: Backend;
-    /** Input dimensions */
-    inputSize: {
-        width: number;
-        height: number;
-    };
-    /** Output dimensions */
-    outputSize: {
-        width: number;
-        height: number;
-    };
-}
-/** Common renderer interface */
-interface Renderer<TOptions> {
-    /** Render image with options */
-    render(input: ImageInput | ImageData, options?: TOptions): ImageOutput;
-    /** Check if renderer is ready */
-    isReady(): boolean;
-    /** Dispose resources */
-    dispose(): void;
-}
-
-/**
- * CRT GPU Renderer using WebGL2
- *
- * High-performance CRT effect rendering using fragment shaders.
- */
-
-/** CRT GPU Renderer */
-declare class CrtGpuRenderer implements Renderer<CrtOptions> {
-    private gl;
-    private canvas;
-    private program;
-    private texture;
-    private uniforms;
-    private initialized;
-    private currentCanvasSize;
-    private currentTexSize;
-    /** Create a new CRT GPU renderer */
-    static create(): CrtGpuRenderer;
-    private init;
-    private createShader;
-    /** Check if renderer is ready */
-    isReady(): boolean;
-    /** Render CRT effect */
-    render(input: ImageInput | ImageData, options?: CrtOptions): ImageOutput;
-    /** Dispose resources */
-    dispose(): void;
-}
-/** CRT presets */
-declare const CRT_PRESETS: Record<string, Partial<CrtOptions>>;
-
-/**
- * Hexagonal GPU Renderer using WebGL2
- *
- * High-performance hexagonal pixel grid transformation using fragment shaders.
- */
-
-/** Calculate output dimensions for hex rendering */
-declare function hexGetDimensions(srcWidth: number, srcHeight: number, scale: number, orientation?: HexOrientation): {
-    width: number;
-    height: number;
-};
-/** HEX GPU Renderer */
-declare class HexGpuRenderer implements Renderer<HexOptions> {
-    private gl;
-    private canvas;
-    private program;
-    private texture;
-    private uniforms;
-    private initialized;
-    private currentCanvasSize;
-    private currentTexSize;
-    /** Create a new HEX GPU renderer */
-    static create(): HexGpuRenderer;
-    private init;
-    private createShader;
-    /** Check if renderer is ready */
-    isReady(): boolean;
-    /** Render hexagonal effect */
-    render(input: ImageInput | ImageData, options?: HexOptions): ImageOutput;
-    /** Dispose resources */
-    dispose(): void;
-}
-/** HEX presets */
-declare const HEX_PRESETS: Record<string, Partial<HexOptions>>;
-
-/**
- * WASM Module Loader
- *
- * Simple manual initialization pattern.
- * User must call initWasm() with the WASM module before using CPU renderers.
- */
-
-/**
- * Initialize WASM module.
- *
- * @example
- * ```typescript
- * import init, * as wasmModule from '@pixagram/renderart/dist/renderart_wasm_bg.js';
- * import { initWasm } from '@pixagram/renderart';
- *
- * await init();
- * initWasm(wasmModule);
- * ```
- */
-declare function initWasm(wasmModule: any): void;
-/** Check if WASM is loaded */
-declare function isWasmLoaded(): boolean;
-/** CRT CPU Renderer using WASM */
-declare class CrtCpuRenderer {
-    /** Create renderer (WASM must be initialized first) */
-    static create(): CrtCpuRenderer;
-    /** Check if renderer is ready */
-    isReady(): boolean;
-    /** Render CRT effect */
-    render(input: ImageInput | ImageData, options?: CrtOptions): ImageOutput;
-    dispose(): void;
-}
-/** HEX CPU Renderer using WASM */
-declare class HexCpuRenderer {
-    static create(): HexCpuRenderer;
-    isReady(): boolean;
-    render(input: ImageInput | ImageData, options?: HexOptions): ImageOutput;
-    getDimensions(srcWidth: number, srcHeight: number, scale: number, orientation?: HexOrientation): {
-        width: number;
-        height: number;
-    };
-    dispose(): void;
-}
-/** XBRZ CPU Renderer using WASM */
-declare class XbrzCpuRenderer {
-    static create(): XbrzCpuRenderer;
-    isReady(): boolean;
-    render(input: ImageInput | ImageData, options?: XbrzOptions): ImageOutput;
-    dispose(): void;
-}
-/** XBRZ presets */
-declare const XBRZ_PRESETS: Record<string, Partial<XbrzOptions>>;
-
-/**
- * RenderArt - Unified Pixel Art Rendering Engine
- *
- * GPU renderers work standalone. CPU renderers require WASM initialization.
- */
-
-/** CRT rendering engine */
-declare class CrtEngine {
-    private gpuRenderer;
-    private cpuRenderer;
-    private gpuAvailable;
-    constructor(gpuAvailable: boolean);
-    private ensureGpu;
-    private ensureCpu;
-    /** Render with options or preset */
-    render(input: ImageInput | ImageData, optionsOrPreset?: CrtOptions | CrtPreset): ImageOutput;
-    /** Synchronous GPU-only render */
-    renderSync(input: ImageInput | ImageData, options?: CrtOptions): ImageOutput;
-    dispose(): void;
-}
-/** HEX rendering engine */
-declare class HexEngine {
-    private gpuRenderer;
-    private cpuRenderer;
-    private gpuAvailable;
-    constructor(gpuAvailable: boolean);
-    private ensureGpu;
-    private ensureCpu;
-    render(input: ImageInput | ImageData, optionsOrPreset?: HexOptions | HexPreset): ImageOutput;
-    renderSync(input: ImageInput | ImageData, options?: HexOptions): ImageOutput;
-    getDimensions(srcWidth: number, srcHeight: number, options?: HexOptions): {
-        width: number;
-        height: number;
-    };
-    dispose(): void;
-}
-/** XBRZ rendering engine (CPU/WASM only) */
-declare class XbrzEngine {
-    private cpuRenderer;
-    private ensureCpu;
-    render(input: ImageInput | ImageData, optionsOrPreset?: XbrzOptions | XbrzPreset): ImageOutput;
-    dispose(): void;
-}
-/** Main RenderArt instance */
-declare class RenderArt {
-    readonly crt: CrtEngine;
-    readonly hex: HexEngine;
-    readonly xbrz: XbrzEngine;
-    readonly capabilities: RendererCapabilities;
-    private constructor();
-    /**
-     * Create RenderArt instance.
-     * For CPU/WASM support, call initWasm() first.
-     */
-    static create(): RenderArt;
-    /**
-     * Create GPU-only RenderArt instance (no WASM needed).
-     */
-    static createGpuOnly(): RenderArt;
-    dispose(): void;
-}
-
-export { type Backend, CRT_PRESETS, CrtCpuRenderer, CrtEngine, CrtGpuRenderer, type CrtOptions, type CrtPreset, HEX_PRESETS, HexCpuRenderer, HexEngine, HexGpuRenderer, type HexOptions, type HexOrientation, type HexPreset, type ImageInput, type ImageOutput, type PixelData, RenderArt, type RenderStats, type Renderer, type RendererCapabilities, XBRZ_PRESETS, XbrzCpuRenderer, XbrzEngine, type XbrzOptions, type XbrzPreset, hexGetDimensions, initWasm, isWasmLoaded };