bloody-engine 1.0.3 → 1.0.5

package/dist/web/rendering/vertex.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 2.5D Sprite Vertex Structure
+ *
+ * Defines the vertex format for 2.5D sprites with support for:
+ * - Position (x, y, z)
+ * - Texture coordinates (u, v)
+ * - Color tint (r, g, b, a)
+ * - Texture index (for texture atlases)
+ *
+ * Vertex Layout (9 floats per vertex):
+ * [0-2] Position:    x, y, z
+ * [3-4] TexCoord:    u, v
+ * [5-8] Color:       r, g, b, a
+ * [9]   TexIndex:    texture index (integer passed as float)
+ */
+/**
+ * Represents a single vertex with all 2.5D sprite attributes
+ */
+export interface SpriteVertex {
+    /** Position in world space */
+    x: number;
+    y: number;
+    z: number;
+    /** Texture coordinates */
+    u: number;
+    v: number;
+    /** Color tint (0-1 range) */
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+    /** Texture index for texture atlas selection */
+    texIndex: number;
+}
+/**
+ * Float layout per vertex in the vertex buffer
+ * Total: 10 floats per vertex
+ */
+export declare const VERTEX_LAYOUT: {
+    readonly FLOATS_PER_VERTEX: 10;
+    readonly POSITION_OFFSET: 0;
+    readonly TEXCOORD_OFFSET: 3;
+    readonly COLOR_OFFSET: 5;
+    readonly TEXINDEX_OFFSET: 9;
+    readonly STRIDE: number;
+};
+/**
+ * Convert a SpriteVertex to a Float32Array segment
+ * Useful for building vertex buffers
+ */
+export declare function spriteVertexToArray(vertex: SpriteVertex): Float32Array;
+/**
+ * Create a default sprite vertex
+ * Useful for initialization
+ */
+export declare function createDefaultSpriteVertex(): SpriteVertex;
+/**
+ * Sprite quad instance data for batch rendering
+ * Extends the basic QuadInstance with 2.5D sprite features
+ */
+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;
+}
+/**
+ * Generate 6 vertices (2 triangles) for a quad with the specified properties
+ *
+ * @param instance The sprite quad instance data
+ * @returns Array of 6 vertices forming the quad
+ */
+export declare function generateQuadVertices(instance: SpriteQuadInstance): SpriteVertex[];
+//# sourceMappingURL=vertex.d.ts.map

package/dist/web/rendering/vertex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex.d.ts","sourceRoot":"","sources":["../../../src/rendering/vertex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAatE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAaxD;AAED;;;GAGG;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;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,GAC3B,YAAY,EAAE,CAmEhB"}

package/dist/web/scene/scene.d.ts

@@ -0,0 +1,139 @@
+import { ProjectionConfig, GridCoord } from '../rendering/projection';
+/**
+ * Scene configuration and constants
+ * Shared between Node.js and Browser rendering
+ */
+export declare const SCENE_CONFIG: {
+    width: number;
+    height: number;
+    targetFPS: number;
+};
+export declare const PROJECTION_CONFIG: ProjectionConfig;
+/**
+ * Entity for visualization (used in projection demo)
+ */
+export interface VisualizationEntity {
+    id: string;
+    name: string;
+    gridPos: GridCoord;
+    color: [number, number, number];
+    size: number;
+}
+/**
+ * Projection visualization entities to render
+ */
+export declare const PROJECTION_ENTITIES: VisualizationEntity[];
+export declare const GEOMETRY: {
+    quad: {
+        name: string;
+        vertices: Float32Array<ArrayBuffer>;
+        stride: number;
+    };
+    triangle: {
+        name: string;
+        vertices: Float32Array<ArrayBuffer>;
+        stride: number;
+    };
+};
+export declare const SHADERS_V1: {
+    vertex: string;
+    fragment: string;
+};
+export declare const SHADERS_V2: {
+    vertex: string;
+    fragment: string;
+};
+export declare const SHADERS: {
+    vertex: string;
+    fragment: string;
+};
+/**
+ * SHADERS_V3 - GPU-Based 2.5D Transformation
+ *
+ * This version moves the isometric projection from CPU to GPU.
+ * The vertex shader receives grid coordinates and transforms them to screen space.
+ *
+ * Attributes:
+ * - aGridPosition: Grid position (x, y) in world space
+ * - aZPosition: Z position for depth layering
+ * - aLocalOffset: Local offset from quad center (for rotation)
+ * - aTexCoord: Texture coordinates
+ * - aColor: Color tint
+ * - aTexIndex: Texture atlas index
+ *
+ * Uniforms:
+ * - uTileSize: Size of tiles (width, height) for isometric projection
+ * - uCamera: Camera position (x, y) and zoom
+ * - uRotation: Rotation angle in radians
+ * - uQuadSize: Size of the quad (width, height)
+ * - uZScale: Scale factor for Z height (vertical exaggeration)
+ * - uResolution: Screen resolution for NDC conversion
+ */
+export declare const SHADERS_V3: {
+    vertex: string;
+    fragment: string;
+};
+export declare const TEXTURE_CONFIG: {
+    size: number;
+    type: string;
+};
+export declare const ANIMATION_CONFIG: {
+    background: {
+        offsetR: number;
+        amplitudeR: number;
+        speedR: number;
+        offsetG: number;
+        amplitudeG: number;
+        speedG: number;
+        offsetB: number;
+        amplitudeB: number;
+        speedB: number;
+    };
+    quads: {
+        count: number;
+        scale: number;
+        baseRadius: number;
+        radiusVariation: number;
+        radiusSpeed: number;
+        orbitalSpeed: number;
+        rotationSpeed: number;
+        colors: number[][];
+    };
+    triangles: {
+        count: number;
+        scale: number;
+        baseRadius: number;
+        radiusVariation: number;
+        radiusSpeed: number;
+        orbitalSpeed: number;
+        rotationSpeed: number;
+        rotationDirection: number;
+        colors: number[][];
+    };
+};
+/**
+ * Calculate background color for a given elapsed time
+ */
+export declare function getBackgroundColor(elapsedSeconds: number): {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};
+/**
+ * Calculate quad transformations for animation
+ */
+export declare function getQuadTransforms(elapsedSeconds: number): {
+    matrix: Float32Array<ArrayBuffer>;
+    color: number[];
+    index: number;
+}[];
+/**
+ * Calculate triangle transformations for animation
+ */
+export declare function getTriangleTransforms(elapsedSeconds: number): {
+    matrix: Float32Array<ArrayBuffer>;
+    color: number[];
+    index: number;
+}[];
+//# sourceMappingURL=scene.d.ts.map

package/dist/web/scene/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/scene/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE3E;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;CAIxB,CAAC;AAMF,eAAO,MAAM,iBAAiB,kBAI7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,EAoCpD,CAAC;AAGF,eAAO,MAAM,QAAQ;;;;;;;;;;;CA6DpB,CAAC;AAKF,eAAO,MAAM,UAAU;;;CA2BtB,CAAC;AAKF,eAAO,MAAM,UAAU;;;CAsCtB,CAAC;AAGF,eAAO,MAAM,OAAO;;;CAAa,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,UAAU;;;CAgFtB,CAAC;AAGF,eAAO,MAAM,cAAc;;;CAG1B,CAAC;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C5B,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM;;;;;EAQxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM;;;;IA6CvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM;;;;IA8C3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bloody-engine",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A WebGL-based 2.5D graphics engine for isometric rendering",
   "license": "MIT",
   "type": "module",
@@ -39,8 +39,8 @@
   "scripts": {
     "dev": "vite",
     "build": "npm run build:web && npm run build:node",
-    "build:web": "vite build --config vite.config.web.ts",
-    "build:node": "vite build --config vite.config.node.ts",
+    "build:web": "tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist/web && vite build --config vite.config.web.ts",
+    "build:node": "tsc --emitDeclarationOnly --declaration --declarationMap --outDir dist/node && vite build --config vite.config.node.ts",
     "build:demo": "vite build --config vite.config.demo.ts",
     "preview": "vite preview",
     "demo": "npm run build:demo && node dist/demo/index.js"
@@ -49,7 +49,8 @@
     "@types/gl": "^6.0.5",
     "@types/node": "^20.10.6",
     "typescript": "^5.3.3",
-    "vite": "^7.3.0"
+    "vite": "^7.3.0",
+    "vite-plugin-dts": "^4.5.4"
   },
   "dependencies": {
     "@kmamal/sdl": "^0.11.13",