@quake2ts/engine 0.0.1

package/dist/types/render/webgpu/resources.d.ts

@@ -0,0 +1,240 @@
+export interface ResourceTracker {
+    trackBuffer(buffer: GPUBufferResource): void;
+    trackTexture(texture: Texture2D | TextureCubeMap): void;
+    untrackBuffer(buffer: GPUBufferResource): void;
+    untrackTexture(texture: Texture2D | TextureCubeMap): void;
+}
+export declare class GPUResourceTracker implements ResourceTracker {
+    private _totalBufferMemory;
+    private _totalTextureMemory;
+    private _bufferCount;
+    private _textureCount;
+    trackBuffer(buffer: GPUBufferResource): void;
+    trackTexture(texture: Texture2D | TextureCubeMap): void;
+    untrackBuffer(buffer: GPUBufferResource): void;
+    untrackTexture(texture: Texture2D | TextureCubeMap): void;
+    get totalBufferMemory(): number;
+    get totalTextureMemory(): number;
+    get bufferCount(): number;
+    get textureCount(): number;
+    reset(): void;
+}
+export declare function setResourceTracker(tracker: ResourceTracker): void;
+export declare function getResourceTracker(): ResourceTracker | undefined;
+export declare class GPUBufferResource {
+    protected readonly device: GPUDevice;
+    readonly buffer: GPUBuffer;
+    readonly size: number;
+    readonly usage: GPUBufferUsageFlags;
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        usage: GPUBufferUsageFlags;
+        label?: string;
+        mappedAtCreation?: boolean;
+    });
+    write(data: BufferSource, offset?: number): void;
+    mapAsync(mode: GPUMapModeFlags, offset?: number, size?: number): Promise<void>;
+    getMappedRange(offset?: number, size?: number): ArrayBuffer;
+    unmap(): void;
+    destroy(): void;
+}
+export declare class VertexBuffer extends GPUBufferResource {
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        label?: string;
+        usage?: GPUBufferUsageFlags;
+    });
+}
+export declare class IndexBuffer extends GPUBufferResource {
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        label?: string;
+        usage?: GPUBufferUsageFlags;
+    });
+}
+export declare class UniformBuffer extends GPUBufferResource {
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        label?: string;
+        usage?: GPUBufferUsageFlags;
+    });
+}
+export declare class StorageBuffer extends GPUBufferResource {
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        label?: string;
+        usage?: GPUBufferUsageFlags;
+    });
+}
+export interface TextureUploadOptions {
+    width?: number;
+    height?: number;
+    depthOrArrayLayers?: number;
+    mipLevel?: number;
+    bytesPerRow?: number;
+    rowsPerImage?: number;
+}
+export declare class Texture2D {
+    protected readonly device: GPUDevice;
+    readonly texture: GPUTexture;
+    readonly width: number;
+    readonly height: number;
+    readonly format: GPUTextureFormat;
+    private static mipmapPipelines;
+    private static mipmapSamplers;
+    constructor(device: GPUDevice, descriptor: {
+        width: number;
+        height: number;
+        format: GPUTextureFormat;
+        usage?: GPUTextureUsageFlags;
+        mipLevelCount?: number;
+        label?: string;
+    });
+    upload(data: BufferSource, options?: TextureUploadOptions): void;
+    private getMipmapPipeline;
+    private getMipmapSampler;
+    generateMipmaps(commandEncoder: GPUCommandEncoder): void;
+    createView(descriptor?: GPUTextureViewDescriptor): GPUTextureView;
+    destroy(): void;
+    get memorySize(): number;
+}
+export declare class TextureCubeMap {
+    protected readonly device: GPUDevice;
+    readonly texture: GPUTexture;
+    readonly size: number;
+    readonly format: GPUTextureFormat;
+    constructor(device: GPUDevice, descriptor: {
+        size: number;
+        format: GPUTextureFormat;
+        usage?: GPUTextureUsageFlags;
+        mipLevelCount?: number;
+        label?: string;
+    });
+    uploadFace(face: number, data: BufferSource, mipLevel?: number): void;
+    createView(): GPUTextureView;
+    destroy(): void;
+    get memorySize(): number;
+}
+export interface SamplerDescriptor {
+    minFilter?: GPUFilterMode;
+    magFilter?: GPUFilterMode;
+    mipmapFilter?: GPUMipmapFilterMode;
+    addressModeU?: GPUAddressMode;
+    addressModeV?: GPUAddressMode;
+    addressModeW?: GPUAddressMode;
+    maxAnisotropy?: number;
+    compare?: GPUCompareFunction;
+    label?: string;
+}
+export declare class Sampler {
+    readonly sampler: GPUSampler;
+    constructor(device: GPUDevice, descriptor: SamplerDescriptor);
+    destroy(): void;
+}
+export declare function createLinearSampler(device: GPUDevice): Sampler;
+export declare function createNearestSampler(device: GPUDevice): Sampler;
+export declare function createClampSampler(device: GPUDevice): Sampler;
+export declare function createRepeatSampler(device: GPUDevice): Sampler;
+export declare class ShaderModule {
+    protected readonly device: GPUDevice;
+    readonly module: GPUShaderModule;
+    constructor(device: GPUDevice, descriptor: {
+        code: string;
+        label?: string;
+    });
+    get compilationInfo(): Promise<GPUCompilationInfo>;
+}
+export interface PipelineDescriptor {
+    vertex: {
+        module: ShaderModule;
+        entryPoint: string;
+        buffers: GPUVertexBufferLayout[];
+    };
+    fragment?: {
+        module: ShaderModule;
+        entryPoint: string;
+        targets: GPUColorTargetState[];
+    };
+    primitive?: GPUPrimitiveState;
+    depthStencil?: GPUDepthStencilState;
+    multisample?: GPUMultisampleState;
+    layout: GPUPipelineLayout | 'auto';
+    label?: string;
+}
+export declare class RenderPipeline {
+    protected readonly device: GPUDevice;
+    readonly pipeline: GPURenderPipeline;
+    constructor(device: GPUDevice, descriptor: PipelineDescriptor);
+    get layout(): GPUPipelineLayout;
+    destroy(): void;
+}
+export declare class ComputePipeline {
+    protected readonly device: GPUDevice;
+    readonly pipeline: GPUComputePipeline;
+    constructor(device: GPUDevice, descriptor: {
+        compute: {
+            module: ShaderModule;
+            entryPoint: string;
+        };
+        layout: GPUPipelineLayout | 'auto';
+        label?: string;
+    });
+    get layout(): GPUPipelineLayout;
+    destroy(): void;
+}
+export interface BindGroupLayoutDescriptor {
+    entries: {
+        binding: number;
+        visibility: GPUShaderStageFlags;
+        buffer?: GPUBufferBindingLayout;
+        texture?: GPUTextureBindingLayout;
+        sampler?: GPUSamplerBindingLayout;
+        storageTexture?: GPUStorageTextureBindingLayout;
+    }[];
+    label?: string;
+}
+export declare class BindGroupLayout {
+    protected readonly device: GPUDevice;
+    readonly layout: GPUBindGroupLayout;
+    constructor(device: GPUDevice, descriptor: BindGroupLayoutDescriptor);
+}
+export interface BindGroupEntry {
+    binding: number;
+    resource: GPUBufferResource | GPUTextureView | Sampler | GPUBindingResource;
+}
+export declare class BindGroup {
+    protected readonly device: GPUDevice;
+    readonly bindGroup: GPUBindGroup;
+    constructor(device: GPUDevice, layout: BindGroupLayout, entries: BindGroupEntry[], label?: string);
+    destroy(): void;
+}
+export declare class BindGroupBuilder {
+    private label?;
+    private entries;
+    constructor(label?: string | undefined);
+    addUniformBuffer(binding: number, visibility: GPUShaderStageFlags): this;
+    addStorageBuffer(binding: number, visibility: GPUShaderStageFlags, type?: GPUBufferBindingType): this;
+    addTexture(binding: number, visibility: GPUShaderStageFlags, sampleType?: GPUTextureSampleType, viewDimension?: GPUTextureViewDimension): this;
+    addSampler(binding: number, visibility: GPUShaderStageFlags, type?: GPUSamplerBindingType): this;
+    build(device: GPUDevice): BindGroupLayout;
+}
+export declare class RenderPassDescriptorBuilder {
+    private descriptor;
+    constructor();
+    setColorAttachment(index: number, view: GPUTextureView, options?: {
+        loadOp?: GPULoadOp;
+        storeOp?: GPUStoreOp;
+        clearValue?: GPUColor;
+    }): this;
+    setDepthStencilAttachment(view: GPUTextureView, options?: {
+        depthLoadOp?: GPULoadOp;
+        depthStoreOp?: GPUStoreOp;
+        depthClearValue?: number;
+        stencilLoadOp?: GPULoadOp;
+        stencilStoreOp?: GPUStoreOp;
+        stencilClearValue?: number;
+    }): this;
+    build(): GPURenderPassDescriptor;
+}
+export declare function createRenderPassDescriptor(): RenderPassDescriptorBuilder;
+//# sourceMappingURL=resources.d.ts.map

package/dist/types/render/webgpu/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../src/render/webgpu/resources.ts"],"names":[],"mappings":"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"}

package/dist/types/render/webgpu/shaders/mipmapShader.d.ts

@@ -0,0 +1,2 @@
+export declare const MIPMAP_SHADER = "\nstruct VSOutput {\n  @builtin(position) position: vec4f,\n  @location(0) texcoord: vec2f,\n};\n\n@vertex\nfn vs_main(@builtin(vertex_index) vertexIndex : u32) -> VSOutput {\n  var pos = array<vec2f, 6>(\n    vec2f(-1.0, -1.0), vec2f(1.0, -1.0), vec2f(-1.0, 1.0),\n    vec2f(-1.0, 1.0), vec2f(1.0, -1.0), vec2f(1.0, 1.0)\n  );\n\n  var output: VSOutput;\n  output.position = vec4f(pos[vertexIndex], 0.0, 1.0);\n  // Remap from [-1, 1] to [0, 1] for texcoord, Y is flipped in WebGPU clip space vs texture UV\n  // Clip space: (-1,-1) is bottom-left. UV: (0,0) is top-left usually?\n  // Wait, WebGPU clip space Y is up. UV (0,0) is top-left.\n  // Quad vertices are full screen.\n  output.texcoord = pos[vertexIndex] * vec2f(0.5, -0.5) + vec2f(0.5, 0.5);\n  return output;\n}\n\n@group(0) @binding(0) var imgSampler: sampler;\n@group(0) @binding(1) var img: texture_2d<f32>;\n\n@fragment\nfn fs_main(in: VSOutput) -> @location(0) vec4f {\n  return textureSample(img, imgSampler, in.texcoord);\n}\n";
+//# sourceMappingURL=mipmapShader.d.ts.map

package/dist/types/render/webgpu/shaders/mipmapShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mipmapShader.d.ts","sourceRoot":"","sources":["../../../../../src/render/webgpu/shaders/mipmapShader.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,0+BA8BzB,CAAC"}

package/dist/types/render/webgpu/shaders/spriteShader.d.ts

@@ -0,0 +1,2 @@
+export declare const SPRITE_SHADER = "\n// Sprite Rendering Shader (WGSL)\n\nstruct VertexInput {\n  @location(0) position: vec2f,\n  @location(1) texcoord: vec2f,\n  @location(2) color: vec4f,\n}\n\nstruct VertexOutput {\n  @builtin(position) position: vec4f,\n  @location(0) texcoord: vec2f,\n  @location(1) color: vec4f,\n}\n\nstruct Uniforms {\n  projection: mat4x4f,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n\n@vertex\nfn vs_main(input: VertexInput) -> VertexOutput {\n  var output: VertexOutput;\n  // Orthographic projection: Input is screen coords (pixels), Z is 0.0, W is 1.0\n  output.position = uniforms.projection * vec4f(input.position, 0.0, 1.0);\n  output.texcoord = input.texcoord;\n  output.color = input.color;\n  return output;\n}\n\n@group(1) @binding(0) var texSampler: sampler;\n@group(1) @binding(1) var tex: texture_2d<f32>;\n\n@fragment\nfn fs_main(input: VertexOutput) -> @location(0) vec4f {\n  let texColor = textureSample(tex, texSampler, input.texcoord);\n  return texColor * input.color;\n}\n\n@fragment\nfn fs_solid(input: VertexOutput) -> @location(0) vec4f {\n  return input.color;\n}\n";
+//# sourceMappingURL=spriteShader.d.ts.map

package/dist/types/render/webgpu/shaders/spriteShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteShader.d.ts","sourceRoot":"","sources":["../../../../../src/render/webgpu/shaders/spriteShader.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,olCA4CzB,CAAC"}

package/dist/types/runtime.d.ts

@@ -0,0 +1,19 @@
+import type { EngineExports } from './index.js';
+import { EngineHost, type ClientRenderer, type EngineHostOptions, type GameFrameResult, type GameSimulation } from './host.js';
+export declare class EngineRuntime<FrameState = unknown> {
+    private readonly engine;
+    private readonly host;
+    private started;
+    constructor(engine: EngineExports, host: EngineHost<FrameState>);
+    start(): void;
+    stop(): void;
+    pump(elapsedMs: number): void;
+    getLatestFrame(): GameFrameResult<FrameState> | undefined;
+    isRunning(): boolean;
+}
+import { AudioApi, AudioApiOptions, SubtitleClient } from './audio/api.js';
+export declare function createEngineRuntime<FrameState = unknown>(engine: EngineExports, game: GameSimulation<FrameState>, client: ClientRenderer<FrameState> & SubtitleClient, audioOptions: AudioApiOptions, options?: EngineHostOptions): {
+    runtime: EngineRuntime<FrameState>;
+    audio: AudioApi;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAE/H,qBAAa,aAAa,CAAC,UAAU,GAAG,OAAO;IAGjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAiB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFzE,OAAO,CAAC,OAAO,CAAS;gBAEK,MAAM,EAAE,aAAa,EAAmB,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAEjG,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAOZ,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI7B,cAAc,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,SAAS;IAIzD,SAAS,IAAI,OAAO;CAGrB;AAED,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3E,wBAAgB,mBAAmB,CAAC,UAAU,GAAG,OAAO,EACtD,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,EACnD,YAAY,EAAE,eAAe,EAC7B,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAKzD"}

package/dist/types/stream/streamingBuffer.d.ts

@@ -0,0 +1,102 @@
+/**
+ * StreamingBuffer - Continuous buffer for network message parsing
+ *
+ * Matches vanilla Quake 2's net_message buffer architecture from:
+ * - /home/user/quake2/full/qcommon/msg.c (MSG_Read* functions)
+ * - /home/user/quake2/full/client/cl_main.c:1798-1799 (buffer initialization)
+ *
+ * Maintains a continuous stream buffer that can be incrementally filled with
+ * data from demo blocks or network packets, while preserving read position
+ * for stateful parsing.
+ */
+export declare class StreamingBuffer {
+    private buffer;
+    private readOffset;
+    private writeOffset;
+    private static readonly INITIAL_SIZE;
+    private static readonly MAX_STRING_LENGTH;
+    constructor(initialCapacity?: number);
+    /**
+     * Append new data to the buffer (for demos: append blocks; for network: append packets)
+     * Grows buffer if needed to accommodate new data.
+     */
+    append(data: ArrayBuffer | Uint8Array): void;
+    /**
+     * Check if we have N bytes available from current read position
+     */
+    hasBytes(count: number): boolean;
+    /**
+     * Get number of bytes available for reading
+     */
+    available(): number;
+    /**
+     * Read one byte and advance position
+     * Reference: MSG_ReadByte() in /home/user/quake2/full/qcommon/msg.c
+     */
+    readByte(): number;
+    /**
+     * Read 2-byte short (little-endian) and advance position
+     * Reference: MSG_ReadShort() in /home/user/quake2/full/qcommon/msg.c
+     */
+    readShort(): number;
+    /**
+     * Read 4-byte long (little-endian) and advance position
+     * Reference: MSG_ReadLong() in /home/user/quake2/full/qcommon/msg.c
+     */
+    readLong(): number;
+    /**
+     * Read 4-byte float (little-endian) and advance position
+     */
+    readFloat(): number;
+    /**
+     * Read null-terminated string and advance position
+     * Reference: MSG_ReadString() in /home/user/quake2/full/qcommon/msg.c
+     */
+    readString(): string;
+    /**
+     * Read raw bytes without advancing position (peek)
+     */
+    peekBytes(count: number): Uint8Array;
+    /**
+     * Read raw bytes and advance position
+     */
+    readBytes(count: number): Uint8Array;
+    /**
+     * Alias for readBytes to match tests
+     */
+    readData(count: number): Uint8Array;
+    /**
+     * Get current read position (for debugging/state tracking)
+     */
+    getReadPosition(): number;
+    /**
+     * Get current write position (for debugging/state tracking)
+     */
+    getWritePosition(): number;
+    /**
+     * Set read position (use with caution - mainly for testing)
+     */
+    setReadPosition(position: number): void;
+    /**
+     * Grow buffer to accommodate more data
+     * Doubles current size or grows to required size, whichever is larger
+     */
+    private grow;
+    /**
+     * Compact buffer - remove consumed data to free memory
+     * Copies unread data to beginning of buffer and resets offsets
+     *
+     * Call this periodically when processing large streams to prevent
+     * unbounded memory growth.
+     */
+    compact(): void;
+    /**
+     * Get total buffer capacity
+     */
+    getCapacity(): number;
+    /**
+     * Reset buffer to initial state (clear all data)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=streamingBuffer.d.ts.map

package/dist/types/stream/streamingBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingBuffer.d.ts","sourceRoot":"","sources":["../../../src/stream/streamingBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAa;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAErC,eAAe,GAAE,MAAqC;IAMlE;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI;IAc5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAOlB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAWnB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAalB;;OAEG;IACH,SAAS,IAAI,MAAM;IAUnB;;;OAGG;IACH,UAAU,IAAI,MAAM;IA4BpB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAOpC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IASpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAInC;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOvC;;;OAGG;IACH,OAAO,CAAC,IAAI;IAUZ;;;;;;OAMG;IACH,OAAO,IAAI,IAAI;IAuBf;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAIhB"}

package/dist/types/tools/lightmapExport.d.ts

@@ -0,0 +1,17 @@
+import { BspMap } from '../assets/bsp.js';
+export interface LightmapExport {
+    readonly width: number;
+    readonly height: number;
+    readonly data: Uint8Array;
+}
+/**
+ * Extracts all valid lightmaps from a BSP map and packs them into a series of atlases.
+ * This function does not require a WebGL context.
+ *
+ * @param map The parsed BSP map.
+ * @param atlasSize The width/height of the generated atlases (default 1024).
+ * @param padding Padding between packed lightmaps (default 1).
+ * @returns An array of atlases, each containing width, height, and raw RGBA pixel data.
+ */
+export declare function exportLightmaps(map: BspMap, atlasSize?: number, padding?: number): LightmapExport[];
+//# sourceMappingURL=lightmapExport.d.ts.map

package/dist/types/tools/lightmapExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightmapExport.d.ts","sourceRoot":"","sources":["../../../src/tools/lightmapExport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,kBAAkB,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,OAAO,SAAI,GAAG,cAAc,EAAE,CAmB5F"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@quake2ts/engine",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs",
+      "default": "./dist/esm/index.js"
+    },
+    "./browser": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/browser/index.js"
+    }
+  },
+  "unpkg": "./dist/browser/index.js",
+  "jsdelivr": "./dist/browser/index.js",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@wasm-audio-decoders/ogg-vorbis": "^0.1.20",
+    "gl-matrix": "^3.4.4",
+    "@quake2ts/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@napi-rs/canvas": "^0.1.52",
+    "@types/node": "^25.0.3",
+    "@webgpu/types": "^0.1.68",
+    "fake-indexeddb": "^6.0.0",
+    "pixelmatch": "^7.1.0",
+    "pngjs": "^7.0.0",
+    "tsup": "^8.1.0",
+    "vitest": "^1.5.3",
+    "webgpu": "^0.3.8",
+    "@quake2ts/game": "0.0.1",
+    "@quake2ts/test-utils": "^0.0.1"
+  },
+  "scripts": {
+    "build": "pnpm run build:types && pnpm run build:bundles",
+    "build:types": "tsc -b",
+    "build:bundles": "tsup",
+    "test": "pnpm run test:unit",
+    "test:unit": "TEST_TYPE=unit vitest run --passWithNoTests",
+    "test:integration": "TEST_TYPE=integration vitest run --passWithNoTests",
+    "test:webgpu": "cross-env TEST_TYPE=webgpu vitest run",
+    "test:visual": "vitest run tests/integration/visual",
+    "test:visual:update": "vitest run tests/integration/visual --update-snapshots",
+    "test:visual:watch": "vitest tests/integration/visual"
+  }
+}