bloody-engine 1.0.5 → 1.0.6

package/README.md

@@ -1,15 +1,16 @@
 # Bloody Engine
 
-A WebGL-based 2.5D graphics engine for isometric rendering, written in TypeScript. Designed for both browser and Node.js environments with full isomorphic support.
+A WebGL-based 2.5D graphics engine for isometric rendering on Node.js, written in TypeScript. Designed for server-side rendering and headless graphics processing.
 
 ## Features
 
 - **2.5D Rendering** - Optimized for isometric and dimetric projections
-- **Cross-Platform** - Works in browsers and Node.js (headless rendering)
+- **Server-Side Rendering** - Headless WebGL rendering on Node.js using `gl` and `@kmamal/sdl`
 - **Batch Rendering** - Efficient sprite batching with GPU-accelerated transformations
 - **Resource Management** - Unified asset loading pipeline for textures and resources
 - **TypeScript** - Fully typed for excellent developer experience
 - **Depth Sorting** - Proper 2.5D occlusion handling
+- **Window Management** - SDL-based window creation for interactive applications
 
 ## Installation
 
@@ -19,49 +20,59 @@ npm install bloody-engine
 
 ## Quick Start
 
-### Browser
-
 ```typescript
-import { BloodyEngine } from 'bloody-engine';
-
-// Initialize engine
-const engine = new BloodyEngine({
-  width: 800,
-  height: 600
-});
-
-// Start rendering loop
-engine.start();
-```
+import { GraphicsDevice, Shader, Texture } from 'bloody-engine';
+
+// Create a graphics device with SDL window
+const device = new GraphicsDevice(800, 600);
+
+// Get the WebGL context
+const gl = device.getGLContext();
+
+// Create a shader
+const shader = device.createShader(`
+  attribute vec3 aPosition;
+  uniform mat4 uMatrix;
+
+  void main() {
+    gl_Position = uMatrix * vec4(aPosition, 1.0);
+  }
+`, `
+  precision mediump float;
+  uniform vec3 uColor;
+
+  void main() {
+    gl_FragColor = vec4(uColor, 1.0);
+  }
+`);
+
+// Create a texture from PNG
+const { PNG } = require('pngjs');
+const fs = require('fs/promises');
+const pngData = await fs.readFile('texture.png');
+const png = PNG.sync.read(pngData);
+const texture = Texture.createFromPNG(gl, png);
 
-### Node.js
-
-```typescript
-import { BloodyEngine } from 'bloody-engine';
-
-// Initialize engine for headless rendering
-const engine = new BloodyEngine({
-  width: 800,
-  height: 600,
-  headless: true
-});
-
-// Render and capture output
-engine.renderFrame();
-const pixels = engine.getPixels();
+// Render
+device.clear({ r: 0.1, g: 0.1, b: 0.1, a: 1.0 });
+shader.use();
+// ... rendering code ...
+device.present();
+
+// For headless rendering, capture the output
+const context = device.getRenderingContext();
+const pixels = context.readPixels();
 ```
 
-## Documentation
-
-For detailed documentation and architecture, see [docs/README.MD](docs/README.MD).
-
 ## Examples
 
+### Sprite Batch Rendering
+
 ```typescript
-// Create a sprite batch renderer
-import { SpriteBatchRenderer, Texture } from 'bloody-engine';
+import { SpriteBatchRenderer, Camera, Texture } from 'bloody-engine';
 
-const batchRenderer = new SpriteBatchRenderer(gl, shader);
+const batchRenderer = new SpriteBatchRenderer(gl, shader, 1000);
+const camera = new Camera(0, 0, 1.0);
 
 // Add sprites
 batchRenderer.addQuad({
@@ -79,6 +90,43 @@ batchRenderer.addQuad({
 batchRenderer.render(camera);
 ```
 
+### Resource Loading
+
+```typescript
+import { NodeResourceLoader } from 'bloody-engine';
+
+const loader = new NodeResourceLoader('./assets');
+
+// Load a shader
+const vertexSource = await loader.load('shaders/basic.vert');
+const fragmentSource = await loader.load('shaders/basic.frag');
+
+// Batch load multiple resources
+const { succeeded, failed } = await loader.loadMultiple([
+  'textures/sprite1.png',
+  'textures/sprite2.png',
+  'shaders/shader.vert'
+]);
+```
+
+## Dependencies
+
+- **gl** - Headless WebGL for Node.js
+- **@kmamal/sdl** - SDL2 bindings for window and input management
+- **pngjs** - PNG image decoding
+
+## Documentation
+
+For detailed documentation and architecture, see [docs/README.MD](docs/README.MD).
+
+## Building
+
+```bash
+npm run build
+```
+
+This will generate the distribution files in `dist/node/`.
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.

package/dist/node/core/resource-loader-factory.d.ts

@@ -0,0 +1,58 @@
+import { IResourceLoader } from './resource-loader';
+/**
+ * Environment type enumeration
+ */
+export declare enum Environment {
+    /** Node.js environment (file system APIs available) */
+    NODE = "node"
+}
+/**
+ * Resource loader factory configuration
+ */
+export interface ResourceLoaderFactoryOptions {
+    /**
+     * Base directory for Node.js resource loader
+     */
+    baseDir?: string;
+}
+/**
+ * Factory class for creating resource loaders
+ * Creates Node.js resource loaders
+ */
+export declare class ResourceLoaderFactory {
+    /**
+     * Detect the current runtime environment
+     * @returns The detected environment type (always NODE)
+     */
+    static detectEnvironment(): Environment;
+    /**
+     * Check if the current environment is a browser
+     * @returns false (not browser)
+     */
+    static isBrowser(): boolean;
+    /**
+     * Check if the current environment is Node.js
+     * @returns true
+     */
+    static isNode(): boolean;
+    /**
+     * Create a Node.js resource loader
+     * @param options Optional factory configuration
+     * @returns A Node.js resource loader instance
+     */
+    static create(options?: ResourceLoaderFactoryOptions): Promise<IResourceLoader>;
+    /**
+     * Create a Node.js resource loader
+     * @param options Optional factory configuration
+     * @returns A Node.js resource loader instance
+     */
+    static createNodeLoader(options?: ResourceLoaderFactoryOptions): Promise<IResourceLoader>;
+}
+/**
+ * Convenience function to create a resource loader
+ * Shortcut for ResourceLoaderFactory.create()
+ * @param options Optional factory configuration
+ * @returns A resource loader instance
+ */
+export declare function createResourceLoader(options?: ResourceLoaderFactoryOptions): Promise<IResourceLoader>;
+//# sourceMappingURL=resource-loader-factory.d.ts.map

package/dist/node/core/resource-loader-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader-factory.d.ts","sourceRoot":"","sources":["../../../src/core/resource-loader-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;GAEG;AACH,oBAAY,WAAW;IACrB,uDAAuD;IACvD,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,WAAW;IAIvC;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAIxB;;;;OAIG;WACU,MAAM,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAIrF;;;;OAIG;WACU,gBAAgB,CAC3B,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC;CAG5B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,eAAe,CAAC,CAE1B"}

package/dist/node/core/resource-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/resource-pipeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAEf,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA8CD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAMtE;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxE;;;;;OAKG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,CAAC;IA4B3B;;;;;;OAMG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,EACF,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAkB/B;;;;;OAKG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,CAAC;IAS3B;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;;OAGG;IACH,SAAS,IAAI,eAAe;CAG7B;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,CAAC,EAAE,uBAAuB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}

package/dist/{web → node}/examples/resource-loader-demo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-loader-demo.d.ts","sourceRoot":"","sources":["../../../src/examples/resource-loader-demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH;;GAEG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAyRlE"}
+{"version":3,"file":"resource-loader-demo.d.ts","sourceRoot":"","sources":["../../../src/examples/resource-loader-demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH;;GAEG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CA+QlE"}