@bloopjs/toodle 0.0.103 → 0.1.1

package/dist/Toodle.d.ts

@@ -1,3 +1,9 @@
+import type { IBackendShader } from "./backends/IBackendShader";
+import type { BlendMode } from "./backends/IRenderBackend";
+import type { BackendType, IRenderBackend } from "./backends/mod";
+import { WebGLBackend } from "./backends/webgl2/mod";
+import { WebGPUBackend } from "./backends/webgpu/mod";
+import type { PostProcess } from "./backends/webgpu/postprocess/mod";
 import type { Color } from "./coreTypes/Color";
 import type { Point } from "./coreTypes/Point";
 import type { Limits, LimitsOptions } from "./limits";
@@ -7,9 +13,6 @@ import { JumboQuadNode, type JumboQuadOptions } from "./scene/JumboQuadNode";
 import { QuadNode, type QuadOptions } from "./scene/QuadNode";
 import { type NodeOptions, SceneNode } from "./scene/SceneNode";
 import type { Resolution } from "./screen/resolution";
-import type { IShader } from "./shaders/IShader";
-import type { PostProcess } from "./shaders/postprocess/mod";
-import { QuadShader, type QuadShaderOpts } from "./shaders/QuadShader";
 import { TextNode, type TextOptions } from "./text/TextNode";
 import { AssetManager, type TextureId } from "./textures/AssetManager";
 export declare class Toodle {
@@ -32,11 +35,6 @@ export declare class Toodle {
         /** number of instances enqueued last frame */
         instancesEnqueued: number;
     };
-    /** sometimes for debugging you might want to access the GPU device, this should not be necessary in normal operation */
-    debug: {
-        device: GPUDevice;
-        presentationFormat: GPUTextureFormat;
-    };
     /**
      * Camera. This applies a 2d perspective projection matrix to any nodes drawn with toodle.draw
      */
@@ -50,10 +48,11 @@ export declare class Toodle {
      * it's unlikely that you want to use the constructor directly.
      * see {@link Toodle.attach} for creating a Toodle instance that draws to a canvas.
      */
-    constructor(device: GPUDevice, context: GPUCanvasContext, presentationFormat: GPUTextureFormat, canvas: HTMLCanvasElement, resolution: Resolution, options: ToodleOptions);
+    constructor(backend: IRenderBackend, canvas: HTMLCanvasElement, resolution: Resolution, options: ToodleOptions);
     /**
      * Screen shader is an optional slot for post-processing effects.
      * Note that this will do the main render pass to an offscreen texture, which may impact performance.
+     * Currently only supported in WebGPU mode.
      */
     get postprocess(): PostProcess | null;
     set postprocess(value: PostProcess | null);
@@ -161,14 +160,14 @@ export declare class Toodle {
      *
      * @param label Debug name of the shader
      * @param instanceCount - The maximum number of instances that will be processed by the shader. Note that a worst-case buffer of this many instances will be immediately allocated.
-     * @param userCode - The WGSL code to be used for the shader.
+     * @param userCode - The WGSL code to be used for the shader (WebGPU only).
      * @param blendMode - The blend mode to be used for the shader.
      *
      * @example
      *
      *
      */
-    QuadShader(label: string, instanceCount: number, userCode: string, shaderOpts?: QuadShaderOpts): QuadShader;
+    QuadShader(label: string, instanceCount: number, userCode: string, shaderOpts?: QuadShaderOpts): IBackendShader;
     /**
      * Create a new quad node.
      *
@@ -211,7 +210,7 @@ export declare class Toodle {
     Text(fontId: string, text: string, textOpts?: TextOptions): TextNode;
     shapes: {
         Rect: (options?: QuadOptions) => QuadNode;
-        Circle: (options?: QuadOptions) => QuadNode;
+        Circle: (options?: CircleOptions) => QuadNode;
         Line: (options: LineOptions) => QuadNode;
     };
     /**
@@ -235,14 +234,15 @@ export declare class Toodle {
      */
     destroy(): void;
     /**
-     * Advanced and niche features
+     * Get the render backend instance.
+     * Cast to WebGPUBackend or WebGLBackend to access backend-specific properties.
+     *
+     * @example
+     * if (toodle.backend instanceof WebGPUBackend) {
+     *   const device = toodle.backend.device;
+     * }
      */
-    extra: {
-        /**
-         * Get the GPU device used by this Toodle instance.
-         */
-        device: () => GPUDevice;
-    };
+    get backend(): WebGPUBackend | WebGLBackend;
 }
 export type StartFrameOptions = {
     /**
@@ -270,6 +270,26 @@ export type ToodleOptions = {
      */
     filter?: "nearest" | "linear";
     limits?: LimitsOptions;
+    /**
+     * The rendering backend to use.
+     *
+     * **auto**: Automatically detect the best available backend (WebGPU > WebGL).
+     *
+     * **webgpu**: Use WebGPU backend. Throws if WebGPU is not available.
+     *
+     * **webgl2**: Use WebGL 2 backend (fallback for older browsers).
+     *
+     * @default "auto"
+     */
+    backend?: BackendType | "auto";
+};
+export type CircleOptions = Omit<QuadOptions, "size"> & {
+    /**
+     * The radius of the circle in pixels.
+     * The diameter will be radius * 2.
+     * @default 50
+     */
+    radius?: number;
 };
 export type LineOptions = {
     /**
@@ -291,7 +311,7 @@ export type LineOptions = {
     /**
      * The shader to use for the line.
      */
-    shader?: IShader;
+    shader?: IBackendShader;
     /**
      * The layer to draw the line on.
      */
@@ -301,4 +321,14 @@ export type LineOptions = {
      */
     key?: string;
 };
+export type QuadShaderOpts = {
+    /**
+     * Blend mode for alpha compositing.
+     */
+    blendMode?: BlendMode;
+    /**
+     * Which texture atlas to bind (default: "default").
+     */
+    atlasId?: string;
+};
 //# sourceMappingURL=Toodle.d.ts.map

package/dist/Toodle.d.ts.map

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

package/dist/backends/IBackendShader.d.ts

@@ -0,0 +1,48 @@
+import type { EngineUniform } from "../coreTypes/EngineUniform";
+import type { SceneNode } from "../scene/SceneNode";
+import type { BlendMode } from "./IRenderBackend";
+/**
+ * Options for creating a quad shader.
+ */
+export type QuadShaderCreationOpts = {
+    /** Debug label for the shader */
+    label: string;
+    /** Maximum number of instances this shader can process per frame */
+    instanceCount: number;
+    /** User-defined shader code (WGSL for WebGPU, GLSL for WebGL) */
+    userCode?: string;
+    /** Blend mode for alpha compositing */
+    blendMode?: BlendMode;
+    /** Which texture atlas to bind (default: "default") */
+    atlasId?: string;
+};
+/**
+ * Backend-agnostic shader interface.
+ *
+ * This interface abstracts the differences between WebGPU and WebGL shaders.
+ * Each backend provides its own implementation.
+ */
+export interface IBackendShader {
+    /** Debug label for the shader */
+    readonly label: string;
+    /**
+     * Prepare for a new frame.
+     * Called once per frame before any processBatch calls.
+     *
+     * @param uniform - Engine uniforms (view-projection, resolution)
+     */
+    startFrame(uniform: EngineUniform): void;
+    /**
+     * Process a batch of nodes and issue draw calls.
+     *
+     * @param nodes - The nodes to render
+     * @returns Number of draw calls issued
+     */
+    processBatch(nodes: SceneNode[]): number;
+    /**
+     * Cleanup after frame.
+     * Called once per frame after all processBatch calls.
+     */
+    endFrame(): void;
+}
+//# sourceMappingURL=IBackendShader.d.ts.map

package/dist/backends/IBackendShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBackendShader.d.ts","sourceRoot":"","sources":["../../src/backends/IBackendShader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEzC;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAC;CAClB"}

package/dist/backends/IRenderBackend.d.ts

@@ -0,0 +1,92 @@
+import type { Color } from "../coreTypes/Color";
+import type { EngineUniform } from "../coreTypes/EngineUniform";
+import type { Size } from "../coreTypes/Size";
+import type { Limits } from "../limits";
+import type { CpuTextureAtlas } from "../textures/types";
+import type { IBackendShader, QuadShaderCreationOpts } from "./IBackendShader";
+import type { ITextureAtlas, TextureAtlasOptions } from "./ITextureAtlas";
+export type BackendType = "webgpu" | "webgl2";
+export type BlendFactor = "one" | "zero" | "src-alpha" | "one-minus-src-alpha" | "dst-alpha" | "one-minus-dst-alpha";
+export type BlendOperation = "add" | "subtract" | "reverse-subtract";
+export type BlendMode = {
+    color: {
+        srcFactor: BlendFactor;
+        dstFactor: BlendFactor;
+        operation: BlendOperation;
+    };
+    alpha: {
+        srcFactor: BlendFactor;
+        dstFactor: BlendFactor;
+        operation: BlendOperation;
+    };
+};
+/**
+ * The render backend interface abstracts WebGPU and WebGL differences.
+ *
+ * Implementations handle GPU-specific operations like texture management,
+ * shader creation, and frame lifecycle.
+ */
+export interface IRenderBackend {
+    /** The type of backend ("webgpu" or "webgl2") */
+    readonly type: BackendType;
+    /** Engine limits (texture size, instance count, etc.) */
+    readonly limits: Limits;
+    /** Size of the default texture atlas */
+    readonly atlasSize: Size;
+    /** Default atlas ID (always "default") */
+    readonly defaultAtlasId: string;
+    /**
+     * Begin a new frame.
+     * WebGPU: Creates command encoder and render pass
+     * WebGL: Clears the canvas if loadOp is "clear"
+     */
+    startFrame(clearColor: Color, loadOp: "clear" | "load"): void;
+    /**
+     * End the current frame and submit to GPU.
+     * WebGPU: Ends render pass and submits command buffer
+     * WebGL: Flushes pending operations
+     */
+    endFrame(): void;
+    /**
+     * Update engine uniforms (view-projection matrix, resolution).
+     * Called once per frame before shader processing.
+     */
+    updateEngineUniform(uniform: EngineUniform): void;
+    /**
+     * Upload a CPU texture atlas to a GPU texture array layer.
+     * @param atlas - The CPU-side atlas data to upload
+     * @param layerIndex - Which layer in the texture array to upload to
+     * @param atlasId - Which atlas to upload to (default: "default")
+     */
+    uploadAtlas(atlas: CpuTextureAtlas, layerIndex: number, atlasId?: string): Promise<void>;
+    /**
+     * Create a new texture atlas.
+     * @param id - Unique identifier for this atlas
+     * @param options - Atlas configuration (format, layers, size)
+     */
+    createTextureAtlas(id: string, options?: TextureAtlasOptions): ITextureAtlas;
+    /**
+     * Get a texture atlas by ID.
+     * @param id - Atlas identifier or defaults to "default"
+     * @returns The atlas, or null if not found
+     */
+    getTextureAtlas(id?: string): ITextureAtlas | null;
+    /**
+     * Destroy a texture atlas and free GPU resources.
+     * @param id - Atlas identifier
+     */
+    destroyTextureAtlas(id: string): void;
+    /**
+     * Create a quad shader for instanced rendering.
+     */
+    createQuadShader(opts: QuadShaderCreationOpts): IBackendShader;
+    /**
+     * Handle canvas resize.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Clean up GPU resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IRenderBackend.d.ts.map

package/dist/backends/IRenderBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRenderBackend.d.ts","sourceRoot":"","sources":["../../src/backends/IRenderBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,MAAM,GACN,WAAW,GACX,qBAAqB,GACrB,WAAW,GACX,qBAAqB,CAAC;AAC1B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE;QACL,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,EAAE,cAAc,CAAC;KAC3B,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,EAAE,WAAW,CAAC;QACvB,SAAS,EAAE,cAAc,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAE9D;;;;OAIG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,WAAW,CACT,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAE7E;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAEnD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc,CAAC;IAE/D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/backends/ITextureAtlas.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Supported texture atlas formats.
+ */
+export type TextureAtlasFormat = "rgba8unorm" | "rg8unorm";
+/**
+ * Options for creating a texture atlas.
+ */
+export type TextureAtlasOptions = {
+    /** Texture format (default: "rgba8unorm") */
+    format?: TextureAtlasFormat;
+    /** Number of array layers (default: limits.textureArrayLayers) */
+    layers?: number;
+    /** Atlas size in pixels (default: limits.textureSize) */
+    size?: number;
+};
+/**
+ * Backend-agnostic texture atlas interface.
+ *
+ * Texture atlases are GPU texture arrays that store multiple textures.
+ * Each backend manages its atlases and provides this common interface.
+ */
+export interface ITextureAtlas {
+    /** Unique identifier for this atlas */
+    readonly id: string;
+    /** Texture format */
+    readonly format: TextureAtlasFormat;
+    /** Number of array layers */
+    readonly layers: number;
+    /** Size in pixels (width = height) */
+    readonly size: number;
+    /** Underlying GPU handle (GPUTexture for WebGPU, WebGLTexture for WebGL) */
+    readonly handle: unknown;
+}
+//# sourceMappingURL=ITextureAtlas.d.ts.map

package/dist/backends/ITextureAtlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITextureAtlas.d.ts","sourceRoot":"","sources":["../../src/backends/ITextureAtlas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B"}

package/dist/backends/detection.d.ts

@@ -0,0 +1,16 @@
+import type { BackendType } from "./IRenderBackend";
+/**
+ * Detect the best available rendering backend.
+ *
+ * Tries WebGPU first (better performance), falls back to WebGL 2.
+ */
+export declare function detectBackend(): Promise<BackendType>;
+/**
+ * Check if WebGPU is available in the current environment.
+ */
+export declare function isWebGPUAvailable(): boolean;
+/**
+ * Check if WebGL 2 is available in the current environment.
+ */
+export declare function isWebGL2Available(): boolean;
+//# sourceMappingURL=detection.d.ts.map

package/dist/backends/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/backends/detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAc1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/dist/backends/mod.d.ts

@@ -0,0 +1,9 @@
+export { detectBackend, isWebGL2Available, isWebGPUAvailable, } from "./detection";
+export type { IBackendShader, QuadShaderCreationOpts } from "./IBackendShader";
+export type { BackendType, BlendFactor, BlendMode, BlendOperation, IRenderBackend, } from "./IRenderBackend";
+export type { ITextureAtlas, TextureAtlasFormat, TextureAtlasOptions, } from "./ITextureAtlas";
+export { defaultFragmentShader as defaultGLSLFragmentShader } from "./webgl2/glsl/quad.glsl";
+export { WebGLBackend } from "./webgl2/WebGLBackend";
+export { type PostProcess, PostProcessDefaults, } from "./webgpu/postprocess/mod";
+export { WebGPUBackend } from "./webgpu/WebGPUBackend";
+//# sourceMappingURL=mod.d.ts.map

package/dist/backends/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/backends/mod.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,IAAI,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EACL,KAAK,WAAW,EAChB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backends/webgl2/WebGLBackend.d.ts

@@ -0,0 +1,51 @@
+import type { Color } from "../../coreTypes/Color";
+import type { EngineUniform } from "../../coreTypes/EngineUniform";
+import type { Size } from "../../coreTypes/Size";
+import type { Limits, LimitsOptions } from "../../limits";
+import type { CpuTextureAtlas } from "../../textures/types";
+import type { IBackendShader, QuadShaderCreationOpts } from "../IBackendShader";
+import type { IRenderBackend } from "../IRenderBackend";
+import type { ITextureAtlas, TextureAtlasFormat, TextureAtlasOptions } from "../ITextureAtlas";
+export type WebGLBackendOptions = {
+    limits?: LimitsOptions;
+    format?: "rgba8unorm" | "rg8unorm";
+};
+/**
+ * WebGL 2 implementation of the render backend.
+ */
+export declare class WebGLBackend implements IRenderBackend {
+    #private;
+    readonly type: "webgl2";
+    readonly limits: Limits;
+    readonly atlasSize: Size;
+    readonly defaultAtlasId = "default";
+    private constructor();
+    /**
+     * Create a WebGL 2 backend attached to a canvas.
+     */
+    static create(canvas: HTMLCanvasElement, options?: WebGLBackendOptions): Promise<WebGLBackend>;
+    startFrame(clearColor: Color, loadOp: "clear" | "load"): void;
+    endFrame(): void;
+    updateEngineUniform(_uniform: EngineUniform): void;
+    uploadAtlas(atlas: CpuTextureAtlas, layerIndex: number, atlasId?: string): Promise<void>;
+    createQuadShader(opts: QuadShaderCreationOpts): IBackendShader;
+    createTextureAtlas(id: string, options?: TextureAtlasOptions): ITextureAtlas;
+    getTextureAtlas(id: string): ITextureAtlas | null;
+    destroyTextureAtlas(id: string): void;
+    /**
+     * Get the default texture atlas handle.
+     * @deprecated Use getTextureAtlas("default").handle instead
+     */
+    get textureArrayHandle(): WebGLTexture;
+    resize(_width: number, _height: number): void;
+    destroy(): void;
+    /**
+     * Get the WebGL 2 rendering context.
+     */
+    get gl(): WebGL2RenderingContext;
+    /**
+     * Get the presentation format (of the default atlas).
+     */
+    get presentationFormat(): TextureAtlasFormat;
+}
+//# sourceMappingURL=WebGLBackend.d.ts.map

package/dist/backends/webgl2/WebGLBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLBackend.d.ts","sourceRoot":"","sources":["../../../src/backends/webgl2/WebGLBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAa,YAAW,cAAc;;IACjD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,aAAa;IAMpC,OAAO;IAcP;;OAEG;WACU,MAAM,CACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IA4BxB,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAqB7D,QAAQ,IAAI,IAAI;IAKhB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI5C,WAAW,CACf,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IA2ChB,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc;IAU9D,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa;IAwC5E,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIjD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQrC;;;OAGG;IACH,IAAI,kBAAkB,IAAI,YAAY,CAErC;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7C,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,IAAI,EAAE,IAAI,sBAAsB,CAE/B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;CACF"}

package/dist/backends/webgl2/WebGLQuadShader.d.ts

@@ -0,0 +1,17 @@
+import type { EngineUniform } from "../../coreTypes/EngineUniform";
+import type { SceneNode } from "../../scene/SceneNode";
+import type { IBackendShader } from "../IBackendShader";
+import type { WebGLBackend } from "./WebGLBackend";
+/**
+ * WebGL 2 implementation of quad shader for instanced rendering.
+ */
+export declare class WebGLQuadShader implements IBackendShader {
+    #private;
+    readonly label: string;
+    constructor(label: string, backend: WebGLBackend, instanceCount: number, userFragmentShader?: string, atlasId?: string);
+    startFrame(uniform: EngineUniform): void;
+    processBatch(nodes: SceneNode[]): number;
+    endFrame(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=WebGLQuadShader.d.ts.map

package/dist/backends/webgl2/WebGLQuadShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLQuadShader.d.ts","sourceRoot":"","sources":["../../../src/backends/webgl2/WebGLQuadShader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOnD;;GAEG;AACH,qBAAa,eAAgB,YAAW,cAAc;;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAiBrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM;IA8GlB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAkDxC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM;IAgDxC,QAAQ,IAAI,IAAI;IAyBhB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/backends/webgl2/glsl/quad.glsl.d.ts

@@ -0,0 +1,12 @@
+export declare const vertexShader = "#version 300 es\nprecision highp float;\n\n// Engine uniforms\nuniform mat3 u_viewProjection;\nuniform vec2 u_resolution;\n\n// Instance data attributes\n// location 0-2 are the model matrix for this instanced quad (mat3 as 3 vec3s)\nlayout(location = 0) in vec4 a_model0;\nlayout(location = 1) in vec4 a_model1;\nlayout(location = 2) in vec4 a_model2;\n// location 3 is the tint color\nlayout(location = 3) in vec4 a_tint;\n// location 4 is the uv offset and scale\nlayout(location = 4) in vec4 a_uvOffsetAndScale;\n// location 5 is the crop offset and scale\nlayout(location = 5) in vec4 a_cropOffsetAndScale;\n// location 6 is the atlas index (integer attribute)\nlayout(location = 6) in uint a_atlasIndex;\n\n// Outputs to fragment shader\nout vec4 v_uv; // xy = atlas uv, zw = original uv\nout vec4 v_tint;\nflat out int v_atlasIndex;\n\n// Lookup tables for unit quad positions and UVs\nconst vec2 posLookup[4] = vec2[4](\n  vec2(-0.5, 0.5),\n  vec2(-0.5, -0.5),\n  vec2(0.5, 0.5),\n  vec2(0.5, -0.5)\n);\n\nconst vec2 uvLookup[4] = vec2[4](\n  vec2(0.0, 0.0),\n  vec2(0.0, 1.0),\n  vec2(1.0, 0.0),\n  vec2(1.0, 1.0)\n);\n\nvoid main() {\n  // Reconstruct model matrix from instance data\n  mat3 modelMatrix = mat3(a_model0.xyz, a_model1.xyz, a_model2.xyz);\n\n  // Transform vertex position\n  vec2 localPosition = posLookup[gl_VertexID];\n  vec2 cropOffset = a_cropOffsetAndScale.xy;\n  vec2 cropScale = a_cropOffsetAndScale.zw;\n  vec2 croppedPosition = localPosition * cropScale + cropOffset;\n  vec3 worldPosition = modelMatrix * vec3(croppedPosition, 1.0);\n  vec3 clipPosition = u_viewProjection * worldPosition;\n  gl_Position = vec4(clipPosition.xy, 0.0, 1.0);\n\n  // Set UV coordinates\n  vec2 originalUv = uvLookup[gl_VertexID];\n  vec2 atlasUv = originalUv * a_uvOffsetAndScale.zw * cropScale + a_uvOffsetAndScale.xy;\n  v_uv = vec4(atlasUv, originalUv);\n\n  // Pass through tint and atlas index\n  v_tint = a_tint;\n  v_atlasIndex = int(a_atlasIndex);\n}\n\n";
+/**
+ * Default fragment shader for WebGL2 quad rendering.
+ * Custom fragment shaders must follow the same contract:
+ * - Required uniforms: u_resolution, u_textureArray
+ * - Required inputs: v_uv (vec4), v_tint (vec4), v_atlasIndex (flat int)
+ * - Required output: fragColor (vec4)
+ */
+export declare const fragmentShader = "#version 300 es\nprecision highp float;\nprecision highp sampler2DArray;\n\n// Engine uniforms\nuniform vec2 u_resolution;\n\n// Texture array sampler\nuniform sampler2DArray u_textureArray;\n\n// Inputs from vertex shader\nin vec4 v_uv; // xy = atlas uv, zw = original uv\nin vec4 v_tint;\nflat in int v_atlasIndex;\n\n// Output color\nout vec4 fragColor;\n\nvoid main() {\n  vec2 atlasUv = v_uv.xy;\n  vec2 originalUv = v_uv.zw;\n\n  if (v_atlasIndex == 1000) {\n    // Rectangle - return solid color\n    fragColor = vec4(1.0, 1.0, 1.0, 1.0) * v_tint;\n  } else if (v_atlasIndex == 1001) {\n    // Circle\n    float edgeWidth = 4.0 / max(u_resolution.x, u_resolution.y);\n    float centerDistance = 2.0 * distance(vec2(0.5, 0.5), originalUv);\n    float alpha = 1.0 - smoothstep(1.0 - edgeWidth, 1.0 + edgeWidth, centerDistance);\n    fragColor = vec4(v_tint.rgb, alpha * v_tint.a);\n  } else {\n    // Texture - sample from texture array\n    vec4 color = texture(u_textureArray, vec3(atlasUv, float(v_atlasIndex)));\n    fragColor = color * v_tint;\n  }\n}\n";
+/** Alias for users who want to extend the default shader */
+export declare const defaultFragmentShader = "#version 300 es\nprecision highp float;\nprecision highp sampler2DArray;\n\n// Engine uniforms\nuniform vec2 u_resolution;\n\n// Texture array sampler\nuniform sampler2DArray u_textureArray;\n\n// Inputs from vertex shader\nin vec4 v_uv; // xy = atlas uv, zw = original uv\nin vec4 v_tint;\nflat in int v_atlasIndex;\n\n// Output color\nout vec4 fragColor;\n\nvoid main() {\n  vec2 atlasUv = v_uv.xy;\n  vec2 originalUv = v_uv.zw;\n\n  if (v_atlasIndex == 1000) {\n    // Rectangle - return solid color\n    fragColor = vec4(1.0, 1.0, 1.0, 1.0) * v_tint;\n  } else if (v_atlasIndex == 1001) {\n    // Circle\n    float edgeWidth = 4.0 / max(u_resolution.x, u_resolution.y);\n    float centerDistance = 2.0 * distance(vec2(0.5, 0.5), originalUv);\n    float alpha = 1.0 - smoothstep(1.0 - edgeWidth, 1.0 + edgeWidth, centerDistance);\n    fragColor = vec4(v_tint.rgb, alpha * v_tint.a);\n  } else {\n    // Texture - sample from texture array\n    vec4 color = texture(u_textureArray, vec3(atlasUv, float(v_atlasIndex)));\n    fragColor = color * v_tint;\n  }\n}\n";
+//# sourceMappingURL=quad.glsl.d.ts.map

package/dist/backends/webgl2/glsl/quad.glsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quad.glsl.d.ts","sourceRoot":"","sources":["../../../../src/backends/webgl2/glsl/quad.glsl.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,g8DAgExB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,4iCAqC1B,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,4iCAAiB,CAAC"}

package/dist/backends/webgl2/mod.d.ts

@@ -0,0 +1,3 @@
+export { WebGLBackend, type WebGLBackendOptions } from "./WebGLBackend";
+export { WebGLQuadShader } from "./WebGLQuadShader";
+//# sourceMappingURL=mod.d.ts.map

package/dist/backends/webgl2/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/backends/webgl2/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/backends/webgpu/ShaderDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShaderDescriptor.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/ShaderDescriptor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC"}

package/dist/{textures → backends/webgpu}/TextureComputeShader.d.ts

@@ -1,4 +1,4 @@
-import type { TextureWithMetadata } from "./types";
+import type { TextureWithMetadata } from "../../textures/types";
 /**
  * A GPU-based texture processor that uses compute shaders to:
  * 1. Find the non-transparent bounding box in a texture.

package/dist/backends/webgpu/TextureComputeShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureComputeShader.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/TextureComputeShader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAwBhE;;;;;GAKG;AACH,qBAAa,oBAAoB;;gBAQ7B,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,kBAAkB,EAChC,aAAa,EAAE,kBAAkB,EACjC,sBAAsB,EAAE,kBAAkB;IAiB5C;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS;IAU/B;;;OAGG;IACG,cAAc,CAClB,cAAc,EAAE,mBAAmB,GAClC,OAAO,CAAC,mBAAmB,CAAC;CA2NhC"}

package/dist/backends/webgpu/WebGPUBackend.d.ts

@@ -0,0 +1,67 @@
+import type { Color } from "../../coreTypes/Color";
+import type { EngineUniform } from "../../coreTypes/EngineUniform";
+import type { Size } from "../../coreTypes/Size";
+import type { Limits, LimitsOptions } from "../../limits";
+import type { CpuTextureAtlas } from "../../textures/types";
+import type { IBackendShader, QuadShaderCreationOpts } from "../IBackendShader";
+import type { IRenderBackend } from "../IRenderBackend";
+import type { ITextureAtlas, TextureAtlasOptions } from "../ITextureAtlas";
+import type { PostProcess } from "./postprocess/mod";
+export type WebGPUBackendOptions = {
+    limits?: LimitsOptions;
+    format?: "rgba8unorm" | "rg8unorm";
+};
+/**
+ * WebGPU implementation of the render backend.
+ */
+export declare class WebGPUBackend implements IRenderBackend {
+    #private;
+    readonly type: "webgpu";
+    readonly limits: Limits;
+    readonly atlasSize: Size;
+    readonly defaultAtlasId = "default";
+    private constructor();
+    /**
+     * Create a WebGPU backend attached to a canvas.
+     */
+    static create(canvas: HTMLCanvasElement, options?: WebGPUBackendOptions): Promise<WebGPUBackend>;
+    startFrame(clearColor: Color, loadOp: "clear" | "load"): void;
+    endFrame(): void;
+    updateEngineUniform(_uniform: EngineUniform): void;
+    uploadAtlas(atlas: CpuTextureAtlas, layerIndex: number, atlasId?: string): Promise<void>;
+    createQuadShader(opts: QuadShaderCreationOpts): IBackendShader;
+    createTextureAtlas(id: string, options?: TextureAtlasOptions): ITextureAtlas;
+    getTextureAtlas(id?: string): ITextureAtlas | null;
+    destroyTextureAtlas(id: string): void;
+    resize(_width: number, _height: number): void;
+    destroy(): void;
+    /**
+     * Set a post-processor for screen effects.
+     * Setting a post-processor will cause the main render to go to an offscreen texture.
+     * Note: Ping-pong textures are not destroyed when setting to null to avoid
+     * race conditions with in-flight command buffers. They are cleaned up on destroy().
+     */
+    setPostprocess(processor: PostProcess | null): void;
+    /**
+     * Get the current post-processor.
+     */
+    getPostprocess(): PostProcess | null;
+    /**
+     * Get the GPU device for advanced operations.
+     */
+    get device(): GPUDevice;
+    /**
+     * Get the canvas context.
+     */
+    get context(): GPUCanvasContext;
+    /**
+     * Get the presentation format.
+     */
+    get presentationFormat(): GPUTextureFormat;
+    /**
+     * Get the current render pass encoder.
+     * Only available between startFrame() and endFrame().
+     */
+    get renderPass(): GPURenderPassEncoder;
+}
+//# sourceMappingURL=WebGPUBackend.d.ts.map

package/dist/backends/webgpu/WebGPUBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGPUBackend.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/WebGPUBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,aAAa;IAapC,OAAO;IAkBP;;OAEG;WACU,MAAM,CACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC;IA4CzB,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAqB7D,QAAQ,IAAI,IAAI;IAsBhB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAK5C,WAAW,CACf,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAoChB,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc;IAW9D,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,aAAa;IAwB5E,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIlD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQrC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAW7C,OAAO,IAAI,IAAI;IAUf;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IASnD;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAiCpC;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,CAEtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,gBAAgB,CAE9B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,gBAAgB,CAEzC;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,oBAAoB,CAMrC;CACF"}

package/dist/backends/webgpu/WebGPUQuadShader.d.ts

@@ -0,0 +1,18 @@
+import type { EngineUniform } from "../../coreTypes/EngineUniform";
+import type { SceneNode } from "../../scene/SceneNode";
+import type { IBackendShader } from "../IBackendShader";
+import type { BlendMode } from "../IRenderBackend";
+import type { WebGPUBackend } from "./WebGPUBackend";
+/**
+ * WebGPU implementation of quad shader for instanced rendering.
+ */
+export declare class WebGPUQuadShader implements IBackendShader {
+    #private;
+    readonly label: string;
+    readonly code: string;
+    constructor(label: string, backend: WebGPUBackend, instanceCount: number, userCode?: string, blendMode?: BlendMode, atlasId?: string);
+    startFrame(uniform: EngineUniform): void;
+    processBatch(nodes: SceneNode[]): number;
+    endFrame(): void;
+}
+//# sourceMappingURL=WebGPUQuadShader.d.ts.map

package/dist/backends/webgpu/WebGPUQuadShader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGPUQuadShader.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/WebGPUQuadShader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAQnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AASrD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,cAAc;;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAcpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,CAAC,EAAE,MAAM;IAyHlB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAkBxC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM;IA4DxC,QAAQ,IAAI,IAAI;CA4CjB"}

package/dist/backends/webgpu/mod.d.ts

@@ -0,0 +1,3 @@
+export { WebGPUBackend, type WebGPUBackendOptions } from "./WebGPUBackend";
+export { WebGPUQuadShader } from "./WebGPUQuadShader";
+//# sourceMappingURL=mod.d.ts.map

package/dist/backends/webgpu/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/backends/webgpu/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/backends/webgpu/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,UAK/C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,gBAAgB,CA4ClB;AAuED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,iBAA8B,GACvC,qBAAqB,CAkDvB;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,QAaxD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAqB9D"}

package/dist/{shaders → backends/webgpu}/postprocess/blur.d.ts

@@ -1,3 +1,3 @@
-import type { Color } from "../../coreTypes/Color";
+import type { Color } from "../../../coreTypes/Color";
 export declare function blur(encoder: GPUCommandEncoder, context: GPUCanvasContext, device: GPUDevice, clearColor: Color, presentationFormat: GPUTextureFormat, pingpong: [GPUTexture, GPUTexture]): void;
 //# sourceMappingURL=blur.d.ts.map