bloody-engine 1.0.2 → 1.0.4

package/dist/web/platforms/browser/browser-context.d.ts

@@ -0,0 +1,31 @@
+import { RenderingContext, RenderingContextOptions } from '../../rendering/rendering-context';
+/**
+ * Browser-based WebGL rendering context implementation
+ * Manages rendering to an HTML canvas element
+ */
+export declare class BrowserRenderingContext implements RenderingContext {
+    glContext: WebGLRenderingContext;
+    width: number;
+    height: number;
+    isBrowser: boolean;
+    private canvas;
+    constructor(options: RenderingContextOptions);
+    resize(width: number, height: number): void;
+    getViewport(): {
+        width: number;
+        height: number;
+    };
+    clear(color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }): void;
+    present(): void;
+    dispose(): void;
+    /**
+     * Get the underlying canvas element (browser-specific)
+     */
+    getCanvas(): HTMLCanvasElement;
+}
+//# sourceMappingURL=browser-context.d.ts.map

package/dist/web/platforms/browser/browser-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-context.d.ts","sourceRoot":"","sources":["../../../../src/platforms/browser/browser-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAQ;IAE1B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,EAAE,uBAAuB;IA0B5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ3C,WAAW,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIhD,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASnE,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,SAAS,IAAI,iBAAiB;CAG/B"}

package/dist/web/platforms/browser/browser-resource-loader.d.ts

@@ -0,0 +1,67 @@
+import { IResourceLoader, ResourceLoadOptions, ResourceLoadResult } from '../../core/resource-loader';
+/**
+ * Resource loader implementation for browser environments
+ * Uses the Fetch API to load resources from URLs
+ */
+export declare class BrowserResourceLoader implements IResourceLoader {
+    /**
+     * Base URL for resolving relative paths
+     */
+    private baseUrl;
+    /**
+     * Default request timeout in milliseconds
+     */
+    private defaultTimeout;
+    /**
+     * Create a new browser resource loader
+     * @param baseUrl Optional base URL for resolving relative paths (defaults to current origin)
+     * @param timeout Default timeout for requests in milliseconds (default: 10000)
+     */
+    constructor(baseUrl?: string, timeout?: number);
+    /**
+     * Get the current origin (protocol + host + port)
+     */
+    private getCurrentOrigin;
+    /**
+     * Resolve a relative path against the base URL
+     * @param path Relative or absolute path
+     * @returns Resolved absolute URL
+     */
+    private resolvePath;
+    /**
+     * Load a single resource from a URL
+     * @param path URL or relative path to the resource
+     * @param options Optional loading configuration
+     * @returns Promise resolving to the resource content
+     */
+    load(path: string, options?: ResourceLoadOptions): Promise<string>;
+    /**
+     * Load multiple resources in parallel
+     * @param paths Array of URLs or paths
+     * @param options Optional loading configuration
+     * @returns Promise resolving to array of load results
+     */
+    loadMultiple(paths: string[], options?: ResourceLoadOptions): Promise<ResourceLoadResult[]>;
+    /**
+     * Check if the path is valid for loading in the browser
+     * @param path URL or path to check
+     * @returns true if the path can be loaded
+     */
+    canLoad(path: string): boolean;
+    /**
+     * Set a new base URL for resolving relative paths
+     * @param baseUrl New base URL
+     */
+    setBaseUrl(baseUrl: string): void;
+    /**
+     * Get the current base URL
+     * @returns Current base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Set the default request timeout
+     * @param timeout Timeout in milliseconds
+     */
+    setTimeout(timeout: number): void;
+}
+//# sourceMappingURL=browser-resource-loader.d.ts.map

package/dist/web/platforms/browser/browser-resource-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-resource-loader.d.ts","sourceRoot":"","sources":["../../../../src/platforms/browser/browser-resource-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;OAEG;IACH,OAAO,CAAC,OAAO,CAAS;IAExB;;OAEG;IACH,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;OAIG;gBACS,OAAO,GAAE,MAAW,EAAE,OAAO,GAAE,MAAc;IAKzD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA8CxE;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsBhC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAe9B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAGlC"}

package/dist/web/platforms/node/node-context.d.ts

@@ -0,0 +1,31 @@
+import { RenderingContext, RenderingContextOptions } from '../../rendering/rendering-context';
+/**
+ * Node.js-based WebGL rendering context implementation
+ * Uses headless-gl (node-gl) for server-side rendering
+ */
+export declare class NodeRenderingContext implements RenderingContext {
+    glContext: WebGLRenderingContext;
+    width: number;
+    height: number;
+    isBrowser: boolean;
+    constructor(options: RenderingContextOptions);
+    resize(width: number, height: number): void;
+    getViewport(): {
+        width: number;
+        height: number;
+    };
+    clear(color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }): void;
+    present(): void;
+    dispose(): void;
+    /**
+     * Read the current framebuffer contents as RGBA pixel data
+     * Used for capturing frames for display or saving
+     */
+    readPixels(): Uint8Array;
+}
+//# sourceMappingURL=node-context.d.ts.map

package/dist/web/platforms/node/node-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-context.d.ts","sourceRoot":"","sources":["../../../../src/platforms/node/node-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAS;gBAEf,OAAO,EAAE,uBAAuB;IAiB5C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAU3C,WAAW,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIhD,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASnE,OAAO,IAAI,IAAI;IAKf,OAAO,IAAI,IAAI;IAOf;;;OAGG;IACH,UAAU,IAAI,UAAU;CAazB"}

package/dist/web/platforms/node/node-resource-loader.d.ts

@@ -0,0 +1,73 @@
+import { Stats } from 'fs';
+import { IResourceLoader, ResourceLoadOptions, ResourceLoadResult } from '../../core/resource-loader';
+/**
+ * Resource loader implementation for Node.js environments
+ * Uses fs.promises to load resources from the file system
+ */
+export declare class NodeResourceLoader implements IResourceLoader {
+    /**
+     * Base directory for resolving relative paths
+     */
+    private baseDir;
+    /**
+     * Create a new Node.js resource loader
+     * @param baseDir Optional base directory for resolving relative paths (defaults to current working directory)
+     */
+    constructor(baseDir?: string);
+    /**
+     * Resolve a relative path against the base directory
+     * @param filePath Relative or absolute file path
+     * @returns Resolved absolute file path
+     */
+    private resolvePath;
+    /**
+     * Load a single resource from a file
+     * @param filePath File path (relative or absolute)
+     * @param options Optional loading configuration
+     * @returns Promise resolving to the file content
+     */
+    load(filePath: string, options?: ResourceLoadOptions): Promise<string>;
+    /**
+     * Load multiple resources in parallel
+     * @param filePaths Array of file paths
+     * @param options Optional loading configuration
+     * @returns Promise resolving to array of load results
+     */
+    loadMultiple(filePaths: string[], options?: ResourceLoadOptions): Promise<ResourceLoadResult[]>;
+    /**
+     * Check if the path is valid for loading in Node.js
+     * @param filePath File path to check
+     * @returns true if the path can be loaded
+     */
+    canLoad(filePath: string): boolean;
+    /**
+     * Check if a file exists without loading it
+     * @param filePath File path to check
+     * @returns Promise resolving to true if file exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Get file statistics (size, modification time, etc.)
+     * @param filePath File path to check
+     * @returns Promise resolving to file stats
+     */
+    getStats(filePath: string): Promise<Stats>;
+    /**
+     * Set a new base directory for resolving relative paths
+     * @param baseDir New base directory
+     */
+    setBaseDir(baseDir: string): void;
+    /**
+     * Get the current base directory
+     * @returns Current base directory
+     */
+    getBaseDir(): string;
+    /**
+     * List all files in a directory
+     * @param dirPath Directory path to list
+     * @param recursive Whether to recursively list subdirectories (default: false)
+     * @returns Promise resolving to array of file paths
+     */
+    listDirectory(dirPath: string, recursive?: boolean): Promise<string[]>;
+}
+//# sourceMappingURL=node-resource-loader.d.ts.map

package/dist/web/platforms/node/node-resource-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-resource-loader.d.ts","sourceRoot":"","sources":["../../../../src/platforms/node/node-resource-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD;;OAEG;IACH,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,OAAO,GAAE,MAAsB;IAI3C;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAUnB;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuC5E;;;;;OAKG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsBhC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKhD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;OAKG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC;CAkBrB"}

package/dist/web/platforms/node/sdl-window.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SDL Window wrapper for displaying rendered content
+ * Handles window creation, event polling, and surface updates
+ */
+export declare class SDLWindow {
+    private window;
+    private width;
+    private height;
+    private title;
+    private closed;
+    constructor(width: number, height: number, title?: string);
+    /**
+     * Get window dimensions
+     */
+    getDimensions(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Display pixel data in the window
+     * @param pixels Uint8Array of RGBA pixel data
+     */
+    updatePixels(pixels: Uint8Array): void;
+    /**
+     * Register an event handler
+     */
+    on(eventName: string, handler: Function): void;
+    /**
+     * Check if window is still open
+     */
+    isOpen(): boolean;
+    /**
+     * Cleanup and close window
+     */
+    cleanup(): void;
+    /**
+     * Destroy the window (alias for cleanup)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=sdl-window.d.ts.map

package/dist/web/platforms/node/sdl-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdl-window.d.ts","sourceRoot":"","sources":["../../../../src/platforms/node/sdl-window.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAwB;IA6B1E;;OAEG;IACH,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIlD;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAkBtC;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI;IAkB9C;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/web/projection.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for 2.5D Isometric Projection Mathematics
+ */
+export {};
+//# sourceMappingURL=projection.test.d.ts.map

package/dist/web/projection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.test.d.ts","sourceRoot":"","sources":["../../src/projection.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/web/public-api.d.ts

@@ -0,0 +1,20 @@
+export { GraphicsDevice } from './core/grahpic-device';
+export type { RenderingContext, RenderingContextOptions, } from './rendering/rendering-context';
+export { BrowserRenderingContext } from './platforms/browser/browser-context';
+export { NodeRenderingContext } from './platforms/node/node-context';
+export { RenderingContextFactory } from './rendering/rendering-context-factory';
+export { Shader } from './core/shader';
+export { Texture } from './core/texture';
+export { VertexBuffer, IndexBuffer } from './core/buffer';
+export { BatchRenderer, SpriteBatchRenderer } from './rendering/batch-renderer';
+export type { QuadInstance, SpriteQuadInstance } from './rendering/batch-renderer';
+export { Camera, Matrix4 } from './rendering/camera';
+export type { IResourceLoader, ResourceLoadResult, ResourceLoadOptions, BatchLoadResult, } from './core/resource-loader';
+export { BrowserResourceLoader, } from './platforms/browser/browser-resource-loader';
+export { NodeResourceLoader } from './platforms/node/node-resource-loader';
+export { ResourceLoaderFactory, Environment, createResourceLoader, } from './core/resource-loader-factory';
+export type { ResourceLoaderFactoryOptions } from './core/resource-loader-factory';
+export { ResourcePipeline, createResourcePipeline, } from './core/resource-pipeline';
+export type { ShaderSource, NamedShaderSource, ResourcePipelineOptions, } from './core/resource-pipeline';
+export { runBrowserResourceLoaderDemo } from './examples/resource-loader-demo';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/web/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../src/public-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGrD,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,qBAAqB,GACtB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/web/rendering/batch-renderer.d.ts

@@ -0,0 +1,273 @@
+import { Shader } from '../core/shader';
+import { Texture } from '../core/texture';
+import { Camera } from './camera';
+/**
+ * V1 Quad instance data (for backward compatibility)
+ */
+export interface QuadInstance {
+    /** X position */
+    x: number;
+    /** Y position */
+    y: number;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Rotation in radians */
+    rotation: number;
+    /** Color as [r, g, b] (0-1 range) */
+    color: [number, number, number];
+}
+/**
+ * V2 Sprite Quad instance data with full 2.5D support
+ */
+export interface SpriteQuadInstance {
+    /** Position in 2.5D space */
+    x: number;
+    y: number;
+    z: number;
+    /** Width and height */
+    width: number;
+    height: number;
+    /** Rotation in radians */
+    rotation: number;
+    /** Color tint (0-1 range, default white) */
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    /** Texture coordinates (UV region in texture atlas) */
+    uvRect?: {
+        uMin: number;
+        vMin: number;
+        uMax: number;
+        vMax: number;
+    };
+    /** Texture index for atlas selection */
+    texIndex?: number;
+    /** Grid position for GPU-based transformation (optional) */
+    gridX?: number;
+    gridY?: number;
+}
+/**
+ * V1 Batch Renderer for backward compatibility
+ * Renders 2D colored quads with position and texture coordinates
+ *
+ * Features:
+ * - Dynamic vertex buffer for per-frame updates
+ * - Batch rendering of multiple quads in single draw call
+ * - Simple 2D positioning and coloring
+ */
+export declare class BatchRenderer {
+    private gl;
+    private shader;
+    private vertexBuffer;
+    private maxQuads;
+    private vertexData;
+    private quads;
+    private isDirty;
+    private verticesPerQuad;
+    private floatsPerVertex;
+    private texture;
+    /**
+     * Create a new batch renderer (V1)
+     * @param gl WebGL rendering context
+     * @param shader Shader program to use
+     * @param maxQuads Maximum number of quads to batch (default 1000)
+     */
+    constructor(gl: WebGLRenderingContext, shader: Shader, maxQuads?: number);
+    /**
+     * Set the texture for batch rendering
+     * @param texture The texture to use when rendering
+     */
+    setTexture(texture: Texture | null): void;
+    /**
+     * Add a quad to the batch
+     * @param quad Quad instance to add
+     */
+    addQuad(quad: QuadInstance): void;
+    /**
+     * Clear all quads from the batch
+     */
+    clear(): void;
+    /**
+     * Get number of quads currently in batch
+     */
+    getQuadCount(): number;
+    /**
+     * Update the batch - rebuilds vertex buffer if quads changed
+     */
+    update(): void;
+    /**
+     * Render the batch
+     * @param camera Optional camera for view transform (defaults to identity matrix)
+     */
+    render(camera?: Camera): void;
+    /**
+     * Generate vertices for a quad with rotation applied
+     * Returns 6 vertices (2 triangles)
+     * @private
+     */
+    private generateQuadVertices;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * V2 Batch Renderer for 2.5D sprites
+ * Supports position (x, y, z), texture coordinates (u, v),
+ * color tint (r, g, b, a), and texture index for texture atlases
+ */
+export declare class SpriteBatchRenderer {
+    private gl;
+    private shader;
+    private vertexBuffer;
+    private maxQuads;
+    private vertexData;
+    private quads;
+    private isDirty;
+    private verticesPerQuad;
+    private floatsPerVertex;
+    private texture;
+    private depthTestEnabled;
+    /**
+     * Create a new sprite batch renderer (V2)
+     * @param gl WebGL rendering context
+     * @param shader Shader program to use (should be SHADERS_V2)
+     * @param maxQuads Maximum number of quads to batch (default 1000)
+     */
+    constructor(gl: WebGLRenderingContext, shader: Shader, maxQuads?: number);
+    /**
+     * Set the texture for batch rendering
+     * @param texture The texture to use when rendering
+     */
+    setTexture(texture: Texture | null): void;
+    /**
+     * Add a sprite quad to the batch
+     * @param quad Sprite quad instance to add
+     */
+    addQuad(quad: SpriteQuadInstance): void;
+    /**
+     * Clear all quads from the batch
+     */
+    clear(): void;
+    /**
+     * Get number of quads currently in batch
+     */
+    getQuadCount(): number;
+    /**
+     * Update the batch - rebuilds vertex buffer if quads changed
+     */
+    update(): void;
+    /**
+     * Set whether depth testing is enabled
+     * When enabled, sprites with lower Z values appear behind sprites with higher Z values
+     * @param enabled Whether to enable depth testing (default true)
+     */
+    setDepthTestEnabled(enabled: boolean): void;
+    /**
+     * Render the batch
+     * @param camera Optional camera for view transform (defaults to identity matrix)
+     */
+    render(camera?: Camera): void;
+    /**
+     * Generate vertices for a quad with rotation applied
+     * Returns 6 vertices (2 triangles)
+     * @private
+     */
+    private generateQuadVertices;
+    /**
+     * Dispose resources
+     */
+    dispose(): void;
+}
+/**
+ * GPU-Based Sprite Batch Renderer (V3)
+ *
+ * This version moves the 2.5D transformation from CPU to GPU.
+ * The vertex shader handles isometric projection, rotation, and camera transform.
+ *
+ * Key differences from SpriteBatchRenderer (V2):
+ * - Stores grid position (gridX, gridY) instead of screen position (x, y)
+ * - Passes local offset to shader for GPU-based rotation
+ * - Shader handles isometric projection and camera transform
+ * - Reduced CPU overhead for transformation calculations
+ *
+ * Vertex Layout (12 floats per vertex):
+ * [0-1] GridPosition: gridX, gridY
+ * [2]   ZPosition:    z
+ * [3-4] LocalOffset:  localX, localY (quad corner offset)
+ * [5-6] TexCoord:     u, v
+ * [7-10] Color:       r, g, b, a
+ * [11]  TexIndex:     texture index
+ */
+export declare class GPUBasedSpriteBatchRenderer {
+    private gl;
+    private shader;
+    private vertexBuffer;
+    private maxQuads;
+    private vertexData;
+    private quads;
+    private isDirty;
+    private verticesPerQuad;
+    private floatsPerVertex;
+    private texture;
+    private depthTestEnabled;
+    private tileSize;
+    private zScale;
+    private resolution;
+    /**
+     * Create a new GPU-based sprite batch renderer (V3)
+     * @param gl WebGL rendering context
+     * @param shader Shader program to use (should be SHADERS_V3)
+     * @param maxQuads Maximum number of quads to batch (default 1000)
+     * @param tileSize Tile size for isometric projection (default {width: 64, height: 32})
+     * @param zScale Scale factor for Z height (default 1.0)
+     */
+    constructor(gl: WebGLRenderingContext, shader: Shader, maxQuads?: number, tileSize?: {
+        width: number;
+        height: number;
+    }, zScale?: number);
+    /**
+     * Set the texture for batch rendering
+     * @param texture The texture to use when rendering
+     */
+    setTexture(texture: Texture | null): void;
+    /**
+     * Add a sprite quad to the batch
+     * If gridX and gridY are provided, uses GPU transformation.
+     * Otherwise, converts x, y to grid coordinates.
+     * @param quad Sprite quad instance to add
+     */
+    addQuad(quad: SpriteQuadInstance): void;
+    /**
+     * Clear all quads from the batch
+     */
+    clear(): void;
+    /**
+     * Get number of quads currently in batch
+     */
+    getQuadCount(): number;
+    /**
+     * Update the batch - rebuilds vertex buffer if quads changed
+     */
+    update(): void;
+    /**
+     * Set whether depth testing is enabled
+     * @param enabled Whether to enable depth testing (default true)
+     */
+    setDepthTestEnabled(enabled: boolean): void;
+    /**
+     * Render the batch with GPU-based transformation
+     * @param camera Camera for view transform
+     */
+    render(camera: Camera): void;
+    /**
+     * Clean up GPU resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=batch-renderer.d.ts.map

package/dist/web/rendering/batch-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-renderer.d.ts","sourceRoot":"","sources":["../../../src/rendering/batch-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,uDAAuD;IACvD,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAwB;IAEvC;;;;;OAKG;gBAED,EAAE,EAAE,qBAAqB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAa;IAwBzB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAIzC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IASjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;IAmCd;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAwE7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,gBAAgB,CAAiB;IAEzC;;;;;OAKG;gBAED,EAAE,EAAE,qBAAqB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAa;IAwBzB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAIzC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IASvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;IA+Dd;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3C;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IA8G7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAwE5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,EAAE,CAAwB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,gBAAgB,CAAiB;IAGzC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAoC;IAEtD;;;;;;;OAOG;gBAED,EAAE,EAAE,qBAAqB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAa,EACvB,QAAQ,GAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAA8B,EACvE,MAAM,GAAE,MAAY;IA0BtB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI;IAIzC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IASvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,MAAM,IAAI,IAAI;IA4Fd;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3C;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoK5B;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}