@flighthq/render-gl 0.1.0 → 0.2.1-next.410.a23f189

package/dist/glTestHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"glTestHelper.js","sourceRoot":"","sources":["../src/glTestHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D,MAAM,UAAU,aAAa,CAAC,OAAsE;IAMlG,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;IACnB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,IAAI;QAC/C,mBAAmB,EAAE,OAAO,EAAE,mBAAmB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KAClE,CAAkB,CAAC;IAEpB,4CAA4C;IAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QACnB,MAAM;QACN,EAAE;QACF,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IAEH,iGAAiG;IACjG,yDAAyD;IACzD,MAAM,OAAO,GAAG,0BAA0B,EAAE,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACrB,gBAAgB,EAAE,IAAI;QACtB,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,CAAC;QACnB,cAAc,EAAE,IAAI;QACpB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,IAAI;QAC1B,YAAY,EAAE,IAAI,OAAO,EAAmC;QAC5D,SAAS;QACT,mBAAmB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QACxF,gBAAgB,EAAE,EAAiB;QACnC,eAAe,EAAE,EAAiB;QAClC,cAAc,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC;QACpC,WAAW,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC;QAChC,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,CAAC;QACnB,yBAAyB,EAAE,IAAI;QAC/B,uBAAuB,EAAE,IAAI,YAAY,CAAC,EAAE,GAAG,GAAG,CAAC;QACnD,kBAAkB,EAAE,IAAI;KACe,CAAC,CAAC;IAC3C,KAAK,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC;IAElC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAC7E,uEAAuE;AACvE,mFAAmF;AACnF,MAAM,UAAU,MAAM;IACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA2B,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,OAAO,EAAE,EAAkB;QAC3B,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,EAA0B;QACrC,QAAQ,EAAE,EAA0B;QACpC,kBAAkB,EAAE,EAA0B;QAC9C,cAAc,EAAE,EAA0B;QAC1C,oBAAoB,EAAE,EAA0B;QAChD,UAAU,EAAE,EAA0B;KACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"glTestHelper.js","sourceRoot":"","sources":["../src/glTestHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D,MAAM,UAAU,aAAa,CAAC,OAAsE;IAMlG,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;IACnB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC;IACpB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,IAAI;QAC/C,mBAAmB,EAAE,OAAO,EAAE,mBAAmB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;KAClE,CAAkB,CAAC;IAEpB,4CAA4C;IAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QACnB,MAAM;QACN,EAAE;QACF,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IAEH,iGAAiG;IACjG,yDAAyD;IACzD,MAAM,OAAO,GAAG,0BAA0B,EAAE,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACrB,gBAAgB,EAAE,IAAI;QACtB,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,CAAC;QACnB,cAAc,EAAE,IAAI;QACpB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,IAAI;QAC1B,YAAY,EAAE,IAAI,OAAO,EAAmC;QAC5D,yBAAyB,EAAE,IAAI,OAAO,EAAE;QACxC,SAAS;QACT,mBAAmB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QACxF,gBAAgB,EAAE,EAAiB;QACnC,eAAe,EAAE,EAAiB;QAClC,cAAc,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC;QACpC,WAAW,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC;QAChC,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;QACb,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,CAAC;QACnB,yBAAyB,EAAE,IAAI;QAC/B,uBAAuB,EAAE,IAAI,YAAY,CAAC,EAAE,GAAG,GAAG,CAAC;QACnD,kBAAkB,EAAE,IAAI;KACe,CAAC,CAAC;IAC3C,KAAK,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC;IAElC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAC7E,uEAAuE;AACvE,mFAAmF;AACnF,MAAM,UAAU,MAAM;IACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA2B,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,OAAO,EAAE,EAAkB;QAC3B,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,EAA0B;QACrC,QAAQ,EAAE,EAA0B;QACpC,kBAAkB,EAAE,EAA0B;QAC9C,cAAc,EAAE,EAA0B;QAC1C,oBAAoB,EAAE,EAA0B;QAChD,UAAU,EAAE,EAA0B;KACvC,CAAC;AACJ,CAAC"}

package/dist/glTextureUpload.d.ts

@@ -0,0 +1,5 @@
+import type { ImageResource } from '@flighthq/types';
+export declare function uploadGlTextureData(gl: WebGL2RenderingContext, target: number, width: number, height: number, data: Readonly<Uint8ClampedArray<ArrayBuffer>>): void;
+export declare function uploadGlTextureElement(gl: WebGL2RenderingContext, target: number, source: TexImageSource): void;
+export declare function uploadGlTextureImageResource(gl: WebGL2RenderingContext, target: number, image: Readonly<ImageResource>): void;
+//# sourceMappingURL=glTextureUpload.d.ts.map

package/dist/glTextureUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glTextureUpload.d.ts","sourceRoot":"","sources":["../src/glTextureUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWrD,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,sBAAsB,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,GAC7C,IAAI,CAYN;AAID,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAE/G;AAMD,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,sBAAsB,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC7B,IAAI,CAGN"}

package/dist/glTextureUpload.js

@@ -0,0 +1,27 @@
+// Raw texel-upload primitives. Each writes level 0 of the texture currently bound at `target` — the GL
+// enum for a 2D texture (gl.TEXTURE_2D) or a cube face (gl.TEXTURE_CUBE_MAP_POSITIVE_X + face). They set
+// no sampler or pixel-store state: premultiply, wrap, and filter are the caller's policy applied around
+// the call, so one primitive serves both the premultiplied 2D sprite path and the raw-radiance cube path.
+// The caller owns creating and binding the texture and choosing the target.
+// Uploads raw CPU pixels (rgba8, straight from a Surface's `data`) through the ArrayBufferView overload.
+// The portable bedrock upload — no web types in the signature — so a native GL/Vulkan backend reimplements
+// it 1:1. `width`/`height` are the pixel dimensions the data fills.
+export function uploadGlTextureData(gl, target, width, height, data) {
+    gl.texImage2D(target, 0, gl.RGBA, width, height, 0, gl.RGBA, gl.UNSIGNED_BYTE, data);
+}
+// Uploads a decoded DOM element (image, canvas, ImageBitmap, VideoFrame) through the TexImageSource
+// overload — the web fast-path, a zero-CPU-copy GPU DMA. Absent on non-web hosts, which carry only `data`.
+export function uploadGlTextureElement(gl, target, source) {
+    gl.texImage2D(target, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, source);
+}
+// Dispatches an ImageResource to whichever representation it carries: the element fast-path when a decoded
+// `source` is present, else the portable `data` path (a generated Surface). The seam that makes data-backed
+// resources first-class — the same texture uploads whether it was loaded (element) or generated in memory
+// (data). Assumes the resource has pixels in at least one form.
+export function uploadGlTextureImageResource(gl, target, image) {
+    if (image.source !== null)
+        uploadGlTextureElement(gl, target, image.source);
+    else
+        uploadGlTextureData(gl, target, image.width, image.height, image.data);
+}
+//# sourceMappingURL=glTextureUpload.js.map

package/dist/glTextureUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glTextureUpload.js","sourceRoot":"","sources":["../src/glTextureUpload.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,yGAAyG;AACzG,wGAAwG;AACxG,0GAA0G;AAC1G,4EAA4E;AAE5E,yGAAyG;AACzG,2GAA2G;AAC3G,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CACjC,EAA0B,EAC1B,MAAc,EACd,KAAa,EACb,MAAc,EACd,IAA8C;IAE9C,EAAE,CAAC,UAAU,CACX,MAAM,EACN,CAAC,EACD,EAAE,CAAC,IAAI,EACP,KAAK,EACL,MAAM,EACN,CAAC,EACD,EAAE,CAAC,IAAI,EACP,EAAE,CAAC,aAAa,EAChB,IAAsC,CACvC,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,2GAA2G;AAC3G,MAAM,UAAU,sBAAsB,CAAC,EAA0B,EAAE,MAAc,EAAE,MAAsB;IACvG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,2GAA2G;AAC3G,4GAA4G;AAC5G,0GAA0G;AAC1G,gEAAgE;AAChE,MAAM,UAAU,4BAA4B,CAC1C,EAA0B,EAC1B,MAAc,EACd,KAA8B;IAE9B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAwB,CAAC,CAAC;;QACzF,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAK,CAAC,CAAC;AAC/E,CAAC"}

package/dist/glTextureVideoUpload.d.ts

@@ -0,0 +1,3 @@
+import type { VideoTexture } from '@flighthq/types';
+export declare function uploadGlTextureVideoFrame(gl: WebGL2RenderingContext, videoTexture: Readonly<VideoTexture>, uploadedFrameId: number): number;
+//# sourceMappingURL=glTextureVideoUpload.d.ts.map

package/dist/glTextureVideoUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glTextureVideoUpload.d.ts","sourceRoot":"","sources":["../src/glTextureVideoUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAcpD,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,sBAAsB,EAC1B,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,EACpC,eAAe,EAAE,MAAM,GACtB,MAAM,CAUR"}

package/dist/glTextureVideoUpload.js

@@ -0,0 +1,24 @@
+import { uploadGlTextureElement } from './glTextureUpload';
+// The per-frame video-to-GPU upload path. A VideoTexture's backing HTMLVideoElement decodes new pixels
+// continuously, so a driver re-uploads the currently-bound GL texture whenever the element's frame
+// advances — but not on frames where nothing changed (a paused or stalled stream), which would waste a
+// full-frame DMA. `uploadedFrameId` is the id the caller last uploaded; this compares it to the
+// VideoTexture's `frameId` and re-uploads through the element fast-path only on a change, returning the
+// id now on the GPU so the caller stores it for the next frame.
+//
+// The caller owns creating, binding, and setting sampler/pixel-store state on the texture; this writes
+// level 0 at gl.TEXTURE_2D. Returns `uploadedFrameId` unchanged (no GL call) when the frame has not
+// advanced or the element has no decoded frame yet, so it is safe to call every frame unconditionally.
+export function uploadGlTextureVideoFrame(gl, videoTexture, uploadedFrameId) {
+    if (videoTexture.frameId === uploadedFrameId)
+        return uploadedFrameId;
+    const element = videoTexture.source.element;
+    // A first-frame guard: HAVE_CURRENT_DATA (2) with non-zero dimensions. texImage2D on an element with
+    // no decoded frame throws in some browsers, so skip until a frame exists and report no upload.
+    if (element === null || element.readyState < 2 || element.videoWidth <= 0 || element.videoHeight <= 0) {
+        return uploadedFrameId;
+    }
+    uploadGlTextureElement(gl, gl.TEXTURE_2D, element);
+    return videoTexture.frameId;
+}
+//# sourceMappingURL=glTextureVideoUpload.js.map

package/dist/glTextureVideoUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glTextureVideoUpload.js","sourceRoot":"","sources":["../src/glTextureVideoUpload.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,uGAAuG;AACvG,mGAAmG;AACnG,uGAAuG;AACvG,gGAAgG;AAChG,wGAAwG;AACxG,gEAAgE;AAChE,EAAE;AACF,uGAAuG;AACvG,oGAAoG;AACpG,uGAAuG;AACvG,MAAM,UAAU,yBAAyB,CACvC,EAA0B,EAC1B,YAAoC,EACpC,eAAuB;IAEvB,IAAI,YAAY,CAAC,OAAO,KAAK,eAAe;QAAE,OAAO,eAAe,CAAC;IACrE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5C,qGAAqG;IACrG,+FAA+F;IAC/F,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;QACtG,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,sBAAsB,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,EAAE,OAAoC,CAAC,CAAC;IAChF,OAAO,YAAY,CAAC,OAAO,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -1,14 +1,21 @@
 export * from './glBackground';
+export * from './glCompressedTexture';
 export * from './glDraw';
 export * from './glElement';
 export * from './glFullscreenPass';
+export * from './glLinearToSrgbPass';
 export * from './glMaterialRegistry';
+export * from './glPresentRenderTarget';
 export * from './glProgram';
 export * from './glReadback';
+export * from './glRenderPass';
 export * from './glRenderState';
 export * from './glRenderTarget';
 export * from './glRenderTargetPool';
 export * from './glShader';
 export * from './glShaderBinding';
+export * from './glSkinPaletteTexture';
+export * from './glTextureUpload';
+export * from './glTextureVideoUpload';
 export type { GlRenderTarget } from '@flighthq/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,13 +1,20 @@
 export * from './glBackground';
+export * from './glCompressedTexture';
 export * from './glDraw';
 export * from './glElement';
 export * from './glFullscreenPass';
+export * from './glLinearToSrgbPass';
 export * from './glMaterialRegistry';
+export * from './glPresentRenderTarget';
 export * from './glProgram';
 export * from './glReadback';
+export * from './glRenderPass';
 export * from './glRenderState';
 export * from './glRenderTarget';
 export * from './glRenderTargetPool';
 export * from './glShader';
 export * from './glShaderBinding';
+export * from './glSkinPaletteTexture';
+export * from './glTextureUpload';
+export * from './glTextureVideoUpload';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/render-gl",
-  "version": "0.1.0",
+  "version": "0.2.1-next.410.a23f189",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/render-gl"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,10 +32,10 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/displayobject": "0.1.0",
-    "@flighthq/geometry": "0.1.0",
-    "@flighthq/render": "0.1.0",
-    "@flighthq/types": "0.1.0"
+    "@flighthq/displayobject": "0.2.1-next.410.a23f189",
+    "@flighthq/geometry": "0.2.1-next.410.a23f189",
+    "@flighthq/render": "0.2.1-next.410.a23f189",
+    "@flighthq/types": "0.2.1-next.410.a23f189"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/glBackground.test.ts

@@ -1,3 +1,5 @@
+import { BlendMode } from '@flighthq/types';
+
 import { renderGlBackground } from './glBackground';
 import { getGlRenderStateRuntime } from './glRenderState';
 import { createGlState } from './glTestHelper';
@@ -30,7 +32,7 @@ describe('renderGlBackground', () => {
   it('resets currentBlendMode to null', () => {
     const { state } = createGlState();
     const runtime = getGlRenderStateRuntime(state);
-    runtime.currentBlendMode = 0;
+    runtime.currentBlendMode = BlendMode.Add;
     renderGlBackground(state);
     expect(runtime.currentBlendMode).toBeNull();
   });

package/src/glCompressedTexture.test.ts

@@ -0,0 +1,276 @@
+import type { GlCompressedTextureSupport, ImageResource, TextureContainer } from '@flighthq/types';
+
+import {
+  detectGlCompressedTextureSupport,
+  getGlCompressedTextureFormat,
+  hasGlCompressedTextureFormat,
+  registerGlCompressedTextureDecoder,
+  registerGlCompressedTextureUpload,
+  uploadGlCompressedTextureContainer,
+} from './glCompressedTexture';
+import { getGlRenderStateRuntime } from './glRenderState';
+import { createGlState } from './glTestHelper';
+
+// The subset of extension enum constants the tests exercise (BC3 via s3tc, ASTC 4x4).
+const S3TC_EXT = { COMPRESSED_RGBA_S3TC_DXT5_EXT: 0x83f3 };
+const ASTC_EXT = { COMPRESSED_RGBA_ASTC_4x4_KHR: 0x93b0 };
+
+// A WebGL2 mock whose getExtension returns only the named extension objects; every other extension
+// resolves to null so a format outside the supported set maps to -1.
+function makeGl(available: Readonly<Record<string, Record<string, number>>>): WebGL2RenderingContext {
+  return {
+    RGBA: 0x1908,
+    UNSIGNED_BYTE: 0x1401,
+    TEXTURE_2D: 0x0de1,
+    TEXTURE_2D_ARRAY: 0x8c1a,
+    TEXTURE_CUBE_MAP_POSITIVE_X: 0x8515,
+    getExtension: vi.fn((name: string) => available[name] ?? null),
+    compressedTexImage2D: vi.fn(),
+    compressedTexSubImage3D: vi.fn(),
+    texStorage3D: vi.fn(),
+    texImage2D: vi.fn(),
+  } as unknown as WebGL2RenderingContext;
+}
+
+function makeContainer(): TextureContainer {
+  return {
+    format: 'bc3',
+    width: 4,
+    height: 4,
+    depth: 1,
+    mipLevels: 1,
+    layers: 1,
+    faces: 1,
+    supercompression: 'None',
+    levels: [{ byteOffset: 0, byteLength: 16, width: 4, height: 4 }],
+  };
+}
+
+// A compressed-only ImageResource wrapping makeContainer, for exercising the installed upload seam.
+function uploadableCompressedImage(): ImageResource {
+  return {
+    source: null,
+    data: null,
+    compressed: { container: makeContainer(), payload: new Uint8Array(16) },
+    width: 4,
+    height: 4,
+    version: 1,
+    alphaType: 'straight',
+  } as unknown as ImageResource;
+}
+
+describe('detectGlCompressedTextureSupport', () => {
+  it('reports a family true only when its extension resolves', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_astc: ASTC_EXT });
+    const support = detectGlCompressedTextureSupport(gl);
+    expect(support.astc).toBe(true);
+    expect(support.s3tc).toBe(false);
+    expect(support.bptc).toBe(false);
+  });
+
+  it('requires both s3tc and s3tc_srgb for the s3tc flag', () => {
+    const onlyBase = detectGlCompressedTextureSupport(makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT }));
+    expect(onlyBase.s3tc).toBe(false);
+    const both = detectGlCompressedTextureSupport(
+      makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT, WEBGL_compressed_texture_s3tc_srgb: {} }),
+    );
+    expect(both.s3tc).toBe(true);
+  });
+});
+
+describe('getGlCompressedTextureFormat', () => {
+  it('resolves the GL enum from the live extension object', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    expect(getGlCompressedTextureFormat(gl, 'bc3')).toBe(0x83f3);
+  });
+
+  it('returns -1 when the extension is absent', () => {
+    const gl = makeGl({});
+    expect(getGlCompressedTextureFormat(gl, 'bc3')).toBe(-1);
+  });
+
+  it('returns -1 for uncompressed and Basis-intermediate formats', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    expect(getGlCompressedTextureFormat(gl, 'rgba8unorm')).toBe(-1);
+    expect(getGlCompressedTextureFormat(gl, 'etc1s')).toBe(-1);
+    expect(getGlCompressedTextureFormat(gl, 'uastc')).toBe(-1);
+  });
+});
+
+describe('hasGlCompressedTextureFormat', () => {
+  const support: GlCompressedTextureSupport = {
+    astc: true,
+    bptc: false,
+    etc: false,
+    pvrtc: false,
+    rgtc: false,
+    s3tc: true,
+  };
+
+  it('maps a format to its family flag, including the srgb twin', () => {
+    expect(hasGlCompressedTextureFormat(support, 'bc3')).toBe(true);
+    expect(hasGlCompressedTextureFormat(support, 'bc3Srgb')).toBe(true);
+    expect(hasGlCompressedTextureFormat(support, 'astc8x8')).toBe(true);
+    expect(hasGlCompressedTextureFormat(support, 'bc7')).toBe(false);
+    expect(hasGlCompressedTextureFormat(support, 'etc2Rgb')).toBe(false);
+  });
+
+  it('is false for a non-compressed format', () => {
+    expect(hasGlCompressedTextureFormat(support, 'rgba8unorm')).toBe(false);
+  });
+});
+
+describe('registerGlCompressedTextureDecoder', () => {
+  it('installs the decoder on the render-state runtime and clears it with null', () => {
+    const { state } = createGlState();
+    const decode = vi.fn(() => new Uint8ClampedArray(4));
+    registerGlCompressedTextureDecoder(state, decode);
+    expect(getGlRenderStateRuntime(state).compressedTextureDecoder).toBe(decode);
+    registerGlCompressedTextureDecoder(state, null);
+    expect(getGlRenderStateRuntime(state).compressedTextureDecoder).toBeNull();
+  });
+});
+
+describe('registerGlCompressedTextureUpload', () => {
+  it('installs the compressed upload seam on the render-state runtime and clears it with null', () => {
+    const { state } = createGlState();
+    registerGlCompressedTextureUpload(state);
+    expect(getGlRenderStateRuntime(state).compressedTextureUpload).toBeTypeOf('function');
+    registerGlCompressedTextureUpload(state, null);
+    expect(getGlRenderStateRuntime(state).compressedTextureUpload).toBeNull();
+  });
+
+  it('uploads a compressed-only ImageResource once installed, threading the registered decoder', () => {
+    const { state, gl } = createGlState();
+    const rgba = new Uint8ClampedArray(4 * 4 * 4);
+    const decode = vi.fn(() => rgba);
+    registerGlCompressedTextureUpload(state);
+    registerGlCompressedTextureDecoder(state, decode);
+    const uploader = getGlRenderStateRuntime(state).compressedTextureUpload!;
+    const ok = uploader(gl, uploadableCompressedImage(), decode);
+    expect(ok).toBe(true);
+    expect(decode).toHaveBeenCalledWith('bc3', 4, 4, expect.any(Uint8Array));
+  });
+
+  it('reports false for a resource with no compressed payload', () => {
+    const { state, gl } = createGlState();
+    registerGlCompressedTextureUpload(state);
+    const uploader = getGlRenderStateRuntime(state).compressedTextureUpload!;
+    const plain = { source: null, data: null, compressed: null } as unknown as ImageResource;
+    expect(uploader(gl, plain, null)).toBe(false);
+  });
+});
+
+describe('uploadGlCompressedTextureContainer', () => {
+  it('drives compressedTexImage2D per level on the native path', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    const payload = new Uint8Array(16);
+    const ok = uploadGlCompressedTextureContainer(gl, makeContainer(), payload);
+    expect(ok).toBe(true);
+    expect(gl.compressedTexImage2D).toHaveBeenCalledTimes(1);
+    expect(gl.compressedTexImage2D).toHaveBeenCalledWith(gl.TEXTURE_2D, 0, 0x83f3, 4, 4, 0, expect.any(Uint8Array));
+    expect(gl.texImage2D).not.toHaveBeenCalled();
+  });
+
+  it('decodes to RGBA and uploads via texImage2D when native support is missing', () => {
+    const gl = makeGl({});
+    const payload = new Uint8Array(16);
+    const rgba = new Uint8ClampedArray(4 * 4 * 4);
+    const decode = vi.fn(() => rgba);
+    const ok = uploadGlCompressedTextureContainer(gl, makeContainer(), payload, decode);
+    expect(ok).toBe(true);
+    expect(decode).toHaveBeenCalledWith('bc3', 4, 4, expect.any(Uint8Array));
+    expect(gl.texImage2D).toHaveBeenCalledWith(gl.TEXTURE_2D, 0, gl.RGBA, 4, 4, 0, gl.RGBA, gl.UNSIGNED_BYTE, rgba);
+    expect(gl.compressedTexImage2D).not.toHaveBeenCalled();
+  });
+
+  it('returns false when neither native support nor a decoder is available', () => {
+    const gl = makeGl({});
+    expect(uploadGlCompressedTextureContainer(gl, makeContainer(), new Uint8Array(16))).toBe(false);
+    expect(gl.compressedTexImage2D).not.toHaveBeenCalled();
+    expect(gl.texImage2D).not.toHaveBeenCalled();
+  });
+
+  it('returns false when the decoder cannot handle the format', () => {
+    const gl = makeGl({});
+    const decode = vi.fn(() => null);
+    expect(uploadGlCompressedTextureContainer(gl, makeContainer(), new Uint8Array(16), decode)).toBe(false);
+  });
+
+  it('slices each level from the payload at its byte range', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    const container: TextureContainer = {
+      ...makeContainer(),
+      mipLevels: 2,
+      levels: [
+        { byteOffset: 0, byteLength: 16, width: 4, height: 4 },
+        { byteOffset: 16, byteLength: 8, width: 2, height: 2 },
+      ],
+    };
+    const payload = new Uint8Array(24);
+    uploadGlCompressedTextureContainer(gl, container, payload);
+    expect(gl.compressedTexImage2D).toHaveBeenCalledTimes(2);
+    const secondCall = (gl.compressedTexImage2D as ReturnType<typeof vi.fn>).mock.calls[1];
+    const view = secondCall[6] as Uint8Array;
+    expect(view.byteOffset).toBe(16);
+    expect(view.byteLength).toBe(8);
+  });
+
+  it('returns false without uploading when the container is still supercompressed', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    const container: TextureContainer = { ...makeContainer(), supercompression: 'Zstd' };
+    expect(uploadGlCompressedTextureContainer(gl, container, new Uint8Array(16))).toBe(false);
+    expect(gl.compressedTexImage2D).not.toHaveBeenCalled();
+    expect(gl.texImage2D).not.toHaveBeenCalled();
+  });
+
+  it('targets each cube face from the flat mip+face index', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    // A single-mip cubemap: six faces, flat index === face since mipLevels === 1.
+    const levels = Array.from({ length: 6 }, (_unused, face) => ({
+      byteOffset: face * 16,
+      byteLength: 16,
+      width: 4,
+      height: 4,
+    }));
+    const container: TextureContainer = { ...makeContainer(), faces: 6, levels };
+    uploadGlCompressedTextureContainer(gl, container, new Uint8Array(6 * 16));
+    expect(gl.compressedTexImage2D).toHaveBeenCalledTimes(6);
+    const calls = (gl.compressedTexImage2D as ReturnType<typeof vi.fn>).mock.calls;
+    for (let face = 0; face < 6; face += 1) {
+      expect(calls[face][0]).toBe(gl.TEXTURE_CUBE_MAP_POSITIVE_X + face);
+      expect(calls[face][1]).toBe(0);
+    }
+    expect(gl.texStorage3D).not.toHaveBeenCalled();
+  });
+
+  it('allocates immutable storage once and sub-uploads each layer of an array into TEXTURE_2D_ARRAY', () => {
+    const gl = makeGl({ WEBGL_compressed_texture_s3tc: S3TC_EXT });
+    // A single-mip, two-layer array (layer-major): flat index 0 = layer 0, index 1 = layer 1.
+    const container: TextureContainer = {
+      ...makeContainer(),
+      layers: 2,
+      levels: [
+        { byteOffset: 0, byteLength: 16, width: 4, height: 4 },
+        { byteOffset: 16, byteLength: 16, width: 4, height: 4 },
+      ],
+    };
+    uploadGlCompressedTextureContainer(gl, container, new Uint8Array(32));
+    expect(gl.texStorage3D).toHaveBeenCalledTimes(1);
+    expect(gl.texStorage3D).toHaveBeenCalledWith(gl.TEXTURE_2D_ARRAY, 1, 0x83f3, 4, 4, 2);
+    expect(gl.compressedTexSubImage3D).toHaveBeenCalledTimes(2);
+    const subCalls = (gl.compressedTexSubImage3D as ReturnType<typeof vi.fn>).mock.calls;
+    expect(subCalls[0][4]).toBe(0);
+    expect(subCalls[1][4]).toBe(1);
+    expect(gl.compressedTexImage2D).not.toHaveBeenCalled();
+  });
+
+  it('returns false for a cubemap the device cannot upload natively (no face-by-face decode)', () => {
+    const gl = makeGl({});
+    const container: TextureContainer = { ...makeContainer(), faces: 6 };
+    const decode = vi.fn(() => new Uint8ClampedArray(4 * 4 * 4));
+    expect(uploadGlCompressedTextureContainer(gl, container, new Uint8Array(6 * 16), decode)).toBe(false);
+    expect(decode).not.toHaveBeenCalled();
+    expect(gl.texImage2D).not.toHaveBeenCalled();
+  });
+});