@flighthq/texture 0.2.0 → 0.2.1-next.410.a23f189

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './cubeTexture';
 export * from './sampler';
 export * from './texture';
+export * from './videoTexture';
 //# 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,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './cubeTexture';
 export * from './sampler';
 export * from './texture';
+export * from './videoTexture';
 //# 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,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/texture.d.ts

@@ -1,12 +1,13 @@
-import type { ImageResource, Matrix3Like, Texture, TextureLike, Vector2Like } from '@flighthq/types';
+import type { ImageResource, Matrix3Like, Texture, TextureLike, TextureUvTransform, Vector2Like } from '@flighthq/types';
 export declare function cloneTexture(source: Readonly<TextureLike>): Texture;
 export declare function copyTexture(out: TextureLike, source: Readonly<TextureLike>): void;
 export declare function createTexture(opts?: Readonly<Partial<TextureLike>>): Texture;
 export declare function equalsTexture(a: Readonly<TextureLike> | null | undefined, b: Readonly<TextureLike> | null | undefined): boolean;
 export declare function getTextureHeight(texture: Readonly<TextureLike>): number;
 export declare function getTextureInverseUvMatrix(out: Matrix3Like, texture: Readonly<TextureLike>): void;
-export declare function getTextureUvMatrix(out: Matrix3Like, texture: Readonly<TextureLike>): void;
+export declare function getTextureUvMatrix(out: Matrix3Like, texture: Readonly<TextureUvTransform>): void;
 export declare function getTextureWidth(texture: Readonly<TextureLike>): number;
+export declare function hasTextureUvTransform(texture: Readonly<TextureUvTransform>): boolean;
 export declare function isTextureReady(texture: Readonly<TextureLike>): boolean;
 export declare function resetTextureUvTransform(texture: TextureLike): void;
 export declare function setTextureImage(texture: TextureLike, image: ImageResource | null): void;

package/dist/texture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../src/texture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAOrG,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CASnE;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAUjF;AAKD,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAS5E;AAID,wBAAgB,aAAa,CAC3B,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3C,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAaT;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAEvE;AAQD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAGhG;AAQD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAkBzF;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAEtE;AAID,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAEtE;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMlE;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEvF;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGnF;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhF;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGlF;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAU/G"}
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../src/texture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAOzB,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAUnE;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAYjF;AAKD,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAU5E;AAID,wBAAgB,aAAa,CAC3B,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3C,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAaT;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAEvE;AAQD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAGhG;AASD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAkBhG;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAEtE;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAQpF;AAID,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAEtE;AAID,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMlE;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEvF;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGnF;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhF;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAGlF;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAU/G"}

package/dist/texture.js

@@ -8,6 +8,7 @@ export function cloneTexture(source) {
     return createEntity({
         colorSpace: source.colorSpace,
         image: source.image,
+        resource: source.resource ?? null,
         sampler: cloneSampler(source.sampler),
         uvOffset: cloneVector2(source.uvOffset),
         uvRotation: source.uvRotation,
@@ -20,12 +21,14 @@ export function cloneTexture(source) {
 export function copyTexture(out, source) {
     const colorSpace = source.colorSpace;
     const image = source.image;
+    const resource = source.resource ?? null;
     const uvRotation = source.uvRotation;
     copySampler(out.sampler, source.sampler);
     copyVector2(out.uvOffset, source.uvOffset);
     copyVector2(out.uvScale, source.uvScale);
     out.colorSpace = colorSpace;
     out.image = image;
+    out.resource = resource;
     out.uvRotation = uvRotation;
 }
 // Builds a Texture: an unbound image slot (null), a default Sampler, 'srgb' color space (the
@@ -35,6 +38,7 @@ export function createTexture(opts) {
     return createEntity({
         colorSpace: opts?.colorSpace ?? 'srgb',
         image: opts?.image ?? null,
+        resource: opts?.resource ?? null,
         sampler: opts?.sampler ? cloneSampler(opts.sampler) : createSampler(),
         uvOffset: opts?.uvOffset ? cloneVector2(opts.uvOffset) : createVector2(0, 0),
         uvRotation: opts?.uvRotation ?? 0,
@@ -72,8 +76,9 @@ export function getTextureInverseUvMatrix(out, texture) {
     inverseMatrix3(out, out);
 }
 // Composes the KHR_texture_transform fields (uvOffset, uvRotation, uvScale) into the 3×3 matrix
-// a shader consumes at sample time. Row-major layout matching @flighthq/geometry Matrix3.
-// The resulting transform applies: scale → rotate → translate, per the KHR_texture_transform spec:
+// a shader consumes at sample time. Column-major layout matching @flighthq/geometry Matrix3, so it
+// uploads to a GL/WGSL mat3 uniform with no transpose. The resulting transform applies:
+// scale → rotate → translate, per the KHR_texture_transform spec:
 // row 0 = [sx*cos(r), -sy*sin(r), tx]; row 1 = [sx*sin(r), sy*cos(r), ty]; row 2 = [0, 0, 1].
 // Out-param form — write result into a pre-allocated Matrix3 to avoid per-call allocation.
 // Safe when out is an unrelated scratch; not intended for aliased input (no in-param here).
@@ -86,20 +91,31 @@ export function getTextureUvMatrix(out, texture) {
     const cosR = Math.cos(r);
     const sinR = Math.sin(r);
     const m = out.m;
-    m[0] = sx * cosR;
-    m[1] = -sy * sinR;
-    m[2] = tx;
-    m[3] = sx * sinR;
-    m[4] = sy * cosR;
-    m[5] = ty;
-    m[6] = 0;
-    m[7] = 0;
-    m[8] = 1;
+    m[0] = sx * cosR; // (0,0)
+    m[1] = sx * sinR; // (1,0)
+    m[2] = 0; // (2,0)
+    m[3] = -sy * sinR; // (0,1)
+    m[4] = sy * cosR; // (1,1)
+    m[5] = 0; // (2,1)
+    m[6] = tx; // (0,2)
+    m[7] = ty; // (1,2)
+    m[8] = 1; // (2,2)
 }
 // Returns the pixel width of the texture's bound image, or -1 when no image is bound.
 export function getTextureWidth(texture) {
     return texture.image !== null ? texture.image.width : -1;
 }
+// True when the texture carries a non-identity KHR_texture_transform — any non-unit scale, non-zero
+// offset, or non-zero rotation. GPU material renderers gate the HAS_UV_TRANSFORM shader variant on
+// this so an untiled surface pays nothing for the uv-transform uniform or the extra vertex multiply;
+// only a texture that actually remaps its uv compiles the transforming path.
+export function hasTextureUvTransform(texture) {
+    return (texture.uvScale.x !== 1 ||
+        texture.uvScale.y !== 1 ||
+        texture.uvOffset.x !== 0 ||
+        texture.uvOffset.y !== 0 ||
+        texture.uvRotation !== 0);
+}
 // True once the texture references a pixel source. A texture with a null image is treated as an
 // absent slot by materials, so this is the gate a material samples behind.
 export function isTextureReady(texture) {

package/dist/texture.js.map

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

package/dist/videoTexture.d.ts

@@ -0,0 +1,13 @@
+import type { Matrix3Like, VideoResource, VideoTexture, VideoTextureLike } from '@flighthq/types';
+export declare function advanceVideoTexture(videoTexture: VideoTextureLike): number;
+export declare function cloneVideoTexture(source: Readonly<VideoTextureLike>): VideoTexture;
+export declare function copyVideoTexture(out: VideoTextureLike, source: Readonly<VideoTextureLike>): void;
+export declare function createVideoTexture(source: VideoResource, opts?: Readonly<Partial<VideoTextureLike>>): VideoTexture;
+export declare function getVideoTextureHeight(videoTexture: Readonly<VideoTextureLike>): number;
+export declare function getVideoTextureInverseUvMatrix(out: Matrix3Like, videoTexture: Readonly<VideoTextureLike>): void;
+export declare function getVideoTextureUvMatrix(out: Matrix3Like, videoTexture: Readonly<VideoTextureLike>): void;
+export declare function getVideoTextureWidth(videoTexture: Readonly<VideoTextureLike>): number;
+export declare function isVideoTextureFrameReady(videoTexture: Readonly<VideoTextureLike>): boolean;
+export declare function resetVideoTextureFrame(videoTexture: VideoTextureLike): void;
+export declare function setVideoTextureSource(videoTexture: VideoTextureLike, source: VideoResource): void;
+//# sourceMappingURL=videoTexture.d.ts.map

package/dist/videoTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoTexture.d.ts","sourceRoot":"","sources":["../src/videoTexture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAQlG,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,GAAG,MAAM,CAG1E;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAUlF;AAKD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAYhG;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,YAAY,CAUlH;AAKD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAGtF;AAKD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAG/G;AAKD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAkBxG;AAID,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAGrF;AAKD,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAK1F;AAID,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAE3E;AAID,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAGjG"}

package/dist/videoTexture.js

@@ -0,0 +1,119 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneVector2, copyVector2, createVector2, inverseMatrix3 } from '@flighthq/geometry';
+import { cloneSampler, copySampler, createSampler } from './sampler';
+// Marks a fresh decoded frame as available for upload by bumping `frameId`. A driver calls this once
+// per rendered frame when the backing element reports new pixels (readyState advanced, or a
+// requestVideoFrameCallback fired); the GPU uploader compares the id against the one it last uploaded
+// and re-uploads only on a change, so a paused stream costs no upload. Returns the new id.
+export function advanceVideoTexture(videoTexture) {
+    videoTexture.frameId += 1;
+    return videoTexture.frameId;
+}
+// Allocates an independent VideoTexture over the SAME video stream: the VideoResource reference is
+// shared (an HTMLVideoElement cannot be duplicated), while the Sampler and uv-transform vectors are
+// deep-cloned so two textures over one stream sample independently. `frameId` resets to -1 so the
+// clone forces its own first upload.
+export function cloneVideoTexture(source) {
+    return createEntity({
+        colorSpace: source.colorSpace,
+        frameId: -1,
+        sampler: cloneSampler(source.sampler),
+        source: source.source,
+        uvOffset: cloneVector2(source.uvOffset),
+        uvRotation: source.uvRotation,
+        uvScale: cloneVector2(source.uvScale),
+    });
+}
+// Copies every VideoTexture field from source into out in place. The VideoResource reference is
+// shared; the Sampler and uv-transform vectors are copied into out's existing entities. Safe when out
+// aliases source.
+export function copyVideoTexture(out, source) {
+    const colorSpace = source.colorSpace;
+    const frameId = source.frameId;
+    const src = source.source;
+    const uvRotation = source.uvRotation;
+    copySampler(out.sampler, source.sampler);
+    copyVector2(out.uvOffset, source.uvOffset);
+    copyVector2(out.uvScale, source.uvScale);
+    out.colorSpace = colorSpace;
+    out.frameId = frameId;
+    out.source = src;
+    out.uvRotation = uvRotation;
+}
+// Builds a VideoTexture over a VideoResource: a default Sampler, 'srgb' color space (video is
+// display-referred), an identity KHR_texture_transform, and `frameId` -1 (no frame uploaded yet).
+// Pass VideoTextureLike fields to override any of these.
+export function createVideoTexture(source, opts) {
+    return createEntity({
+        colorSpace: opts?.colorSpace ?? 'srgb',
+        frameId: opts?.frameId ?? -1,
+        sampler: opts?.sampler ? cloneSampler(opts.sampler) : createSampler(),
+        source: opts?.source ?? source,
+        uvOffset: opts?.uvOffset ? cloneVector2(opts.uvOffset) : createVector2(0, 0),
+        uvRotation: opts?.uvRotation ?? 0,
+        uvScale: opts?.uvScale ? cloneVector2(opts.uvScale) : createVector2(1, 1),
+    });
+}
+// Returns the pixel height of the current video frame, or -1 when no element is attached or no frame
+// has decoded yet (videoHeight is 0). Reads the element directly, so the value tracks a resolution
+// change mid-stream.
+export function getVideoTextureHeight(videoTexture) {
+    const element = videoTexture.source.element;
+    return element !== null && element.videoHeight > 0 ? element.videoHeight : -1;
+}
+// Composes the KHR_texture_transform fields and inverts the result, producing the matrix that maps
+// already-transformed uv back to the unit-square source uv. A zero scale is singular, so inverseMatrix3
+// fills the matrix with NaN. Out-param form — write into a pre-allocated Matrix3.
+export function getVideoTextureInverseUvMatrix(out, videoTexture) {
+    getVideoTextureUvMatrix(out, videoTexture);
+    inverseMatrix3(out, out);
+}
+// Composes the KHR_texture_transform fields (uvOffset, uvRotation, uvScale) into the column-major 3×3
+// matrix a shader consumes at sample time — the same layout getTextureUvMatrix produces, so a material
+// samples a VideoTexture through one uv-transform path. scale → rotate → translate. Out-param form.
+export function getVideoTextureUvMatrix(out, videoTexture) {
+    const r = videoTexture.uvRotation;
+    const sx = videoTexture.uvScale.x;
+    const sy = videoTexture.uvScale.y;
+    const tx = videoTexture.uvOffset.x;
+    const ty = videoTexture.uvOffset.y;
+    const cosR = Math.cos(r);
+    const sinR = Math.sin(r);
+    const m = out.m;
+    m[0] = sx * cosR;
+    m[1] = sx * sinR;
+    m[2] = 0;
+    m[3] = -sy * sinR;
+    m[4] = sy * cosR;
+    m[5] = 0;
+    m[6] = tx;
+    m[7] = ty;
+    m[8] = 1;
+}
+// Returns the pixel width of the current video frame, or -1 when no element is attached or no frame
+// has decoded yet.
+export function getVideoTextureWidth(videoTexture) {
+    const element = videoTexture.source.element;
+    return element !== null && element.videoWidth > 0 ? element.videoWidth : -1;
+}
+// True when the backing element has decoded at least the current frame (readyState >=
+// HAVE_CURRENT_DATA) and its dimensions are known — the gate a material samples behind and a driver
+// checks before calling advanceVideoTexture. False while metadata/first-frame is still buffering.
+export function isVideoTextureFrameReady(videoTexture) {
+    const element = videoTexture.source.element;
+    return (element !== null && element.readyState >= HAVE_CURRENT_DATA && element.videoWidth > 0 && element.videoHeight > 0);
+}
+// Resets `frameId` to -1 so the next upload re-sends the current frame regardless of history. Used
+// after a context loss (the GPU texture is gone) or a source swap to force a re-upload.
+export function resetVideoTextureFrame(videoTexture) {
+    videoTexture.frameId = -1;
+}
+// Binds a different video stream and resets `frameId` to -1 so the new stream's first frame uploads.
+// Does not touch sampling state or the uv-transform.
+export function setVideoTextureSource(videoTexture, source) {
+    videoTexture.source = source;
+    videoTexture.frameId = -1;
+}
+// HTMLMediaElement.HAVE_CURRENT_DATA — data for the current playback position is available.
+const HAVE_CURRENT_DATA = 2;
+//# sourceMappingURL=videoTexture.js.map

package/dist/videoTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoTexture.js","sourceRoot":"","sources":["../src/videoTexture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAErE,qGAAqG;AACrG,4FAA4F;AAC5F,sGAAsG;AACtG,2FAA2F;AAC3F,MAAM,UAAU,mBAAmB,CAAC,YAA8B;IAChE,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1B,OAAO,YAAY,CAAC,OAAO,CAAC;AAC9B,CAAC;AAED,mGAAmG;AACnG,oGAAoG;AACpG,kGAAkG;AAClG,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAAC,MAAkC;IAClE,OAAO,YAAY,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;QACrC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,gGAAgG;AAChG,sGAAsG;AACtG,kBAAkB;AAClB,MAAM,UAAU,gBAAgB,CAAC,GAAqB,EAAE,MAAkC;IACxF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;IAC5B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;IACjB,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;AAC9B,CAAC;AAED,8FAA8F;AAC9F,kGAAkG;AAClG,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,IAA0C;IAClG,OAAO,YAAY,CAAC;QAClB,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,MAAM;QACtC,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE;QACrE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,MAAM;QAC9B,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5E,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;KAC1E,CAAC,CAAC;AACL,CAAC;AAED,qGAAqG;AACrG,mGAAmG;AACnG,qBAAqB;AACrB,MAAM,UAAU,qBAAqB,CAAC,YAAwC;IAC5E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5C,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,mGAAmG;AACnG,wGAAwG;AACxG,kFAAkF;AAClF,MAAM,UAAU,8BAA8B,CAAC,GAAgB,EAAE,YAAwC;IACvG,uBAAuB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3C,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,sGAAsG;AACtG,uGAAuG;AACvG,oGAAoG;AACpG,MAAM,UAAU,uBAAuB,CAAC,GAAgB,EAAE,YAAwC;IAChG,MAAM,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC;IAClC,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACT,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACT,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACV,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACV,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACX,CAAC;AAED,oGAAoG;AACpG,mBAAmB;AACnB,MAAM,UAAU,oBAAoB,CAAC,YAAwC;IAC3E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5C,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,sFAAsF;AACtF,oGAAoG;AACpG,kGAAkG;AAClG,MAAM,UAAU,wBAAwB,CAAC,YAAwC;IAC/E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;IAC5C,OAAO,CACL,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,CACjH,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CAAC,YAA8B;IACnE,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,qGAAqG;AACrG,qDAAqD;AACrD,MAAM,UAAU,qBAAqB,CAAC,YAA8B,EAAE,MAAqB;IACzF,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,4FAA4F;AAC5F,MAAM,iBAAiB,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/texture",
-  "version": "0.2.0",
+  "version": "0.2.1-next.410.a23f189",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -32,9 +32,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.2.0",
-    "@flighthq/geometry": "0.2.0",
-    "@flighthq/types": "0.2.0"
+    "@flighthq/entity": "0.2.1-next.410.a23f189",
+    "@flighthq/geometry": "0.2.1-next.410.a23f189",
+    "@flighthq/types": "0.2.1-next.410.a23f189"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/texture.test.ts

@@ -11,6 +11,7 @@ import {
   getTextureInverseUvMatrix,
   getTextureUvMatrix,
   getTextureWidth,
+  hasTextureUvTransform,
   isTextureReady,
   resetTextureUvTransform,
   setTextureImage,
@@ -222,7 +223,7 @@ describe('getTextureUvMatrix', () => {
 
     getTextureUvMatrix(out, texture);
 
-    // Row-major: identity = [1,0,0; 0,1,0; 0,0,1]
+    // Identity = [1,0,0; 0,1,0; 0,0,1]
     expect(out.m[0]).toBeCloseTo(1);
     expect(out.m[1]).toBeCloseTo(0);
     expect(out.m[2]).toBeCloseTo(0);
@@ -241,8 +242,9 @@ describe('getTextureUvMatrix', () => {
 
     getTextureUvMatrix(out, texture);
 
-    expect(out.m[2]).toBeCloseTo(0.25); // tx
-    expect(out.m[5]).toBeCloseTo(0.75); // ty
+    // Column-major: the translation column is m[6], m[7].
+    expect(out.m[6]).toBeCloseTo(0.25); // tx
+    expect(out.m[7]).toBeCloseTo(0.75); // ty
   });
 
   it('encodes scale in the diagonal', () => {
@@ -267,12 +269,13 @@ describe('getTextureUvMatrix', () => {
 
     const cosR = Math.cos(r);
     const sinR = Math.sin(r);
-    expect(out.m[0]).toBeCloseTo(2 * cosR); // sx*cos(r)
-    expect(out.m[1]).toBeCloseTo(-2 * sinR); // -sy*sin(r)
-    expect(out.m[2]).toBeCloseTo(0.1); // tx
-    expect(out.m[3]).toBeCloseTo(2 * sinR); // sx*sin(r)
-    expect(out.m[4]).toBeCloseTo(2 * cosR); // sy*cos(r)
-    expect(out.m[5]).toBeCloseTo(0.2); // ty
+    // Column-major storage of rows [sx·cos, -sy·sin, tx], [sx·sin, sy·cos, ty], [0,0,1].
+    expect(out.m[0]).toBeCloseTo(2 * cosR); // (0,0) sx*cos(r)
+    expect(out.m[1]).toBeCloseTo(2 * sinR); // (1,0) sx*sin(r)
+    expect(out.m[3]).toBeCloseTo(-2 * sinR); // (0,1) -sy*sin(r)
+    expect(out.m[4]).toBeCloseTo(2 * cosR); // (1,1) sy*cos(r)
+    expect(out.m[6]).toBeCloseTo(0.1); // (0,2) tx
+    expect(out.m[7]).toBeCloseTo(0.2); // (1,2) ty
   });
 });
 
@@ -290,6 +293,41 @@ describe('getTextureWidth', () => {
   });
 });
 
+describe('hasTextureUvTransform', () => {
+  it('is false for a freshly created identity-transform texture', () => {
+    expect(hasTextureUvTransform(createTexture())).toBe(false);
+  });
+
+  it('is true when the scale is non-unit', () => {
+    const texture = createTexture();
+    setTextureUvScale(texture, 2, 2);
+
+    expect(hasTextureUvTransform(texture)).toBe(true);
+  });
+
+  it('is true when the offset is non-zero', () => {
+    const texture = createTexture();
+    setTextureUvOffset(texture, 0.25, 0);
+
+    expect(hasTextureUvTransform(texture)).toBe(true);
+  });
+
+  it('is true when the rotation is non-zero', () => {
+    const texture = createTexture();
+    setTextureUvRotation(texture, 0.5);
+
+    expect(hasTextureUvTransform(texture)).toBe(true);
+  });
+
+  it('is false again after resetTextureUvTransform', () => {
+    const texture = createTexture();
+    setTextureUvScale(texture, 3, 4);
+    resetTextureUvTransform(texture);
+
+    expect(hasTextureUvTransform(texture)).toBe(false);
+  });
+});
+
 describe('isTextureReady', () => {
   it('is false with a null image and true once bound', () => {
     const texture = createTexture();
@@ -398,8 +436,9 @@ describe('transformTextureUv', () => {
     const u = 0.3;
     const v = 0.8;
     const m = matrix.m;
-    const expectedX = m[0] * u + m[1] * v + m[2];
-    const expectedY = m[3] * u + m[4] * v + m[5];
+    // Column-major: row 0 = m[0], m[3], m[6]; row 1 = m[1], m[4], m[7].
+    const expectedX = m[0] * u + m[3] * v + m[6];
+    const expectedY = m[1] * u + m[4] * v + m[7];
     const out = createVector2(0, 0);
 
     transformTextureUv(out, texture, u, v);

package/src/videoTexture.test.ts

@@ -0,0 +1,157 @@
+import { createMatrix3, createVector2 } from '@flighthq/geometry';
+import type { VideoResource } from '@flighthq/types';
+
+import {
+  advanceVideoTexture,
+  cloneVideoTexture,
+  copyVideoTexture,
+  createVideoTexture,
+  getVideoTextureHeight,
+  getVideoTextureInverseUvMatrix,
+  getVideoTextureUvMatrix,
+  getVideoTextureWidth,
+  isVideoTextureFrameReady,
+  resetVideoTextureFrame,
+  setVideoTextureSource,
+} from './videoTexture';
+
+// A minimal element carrier: only the fields the VideoTexture accessors read.
+function makeVideoResource(readyState = 4, videoWidth = 320, videoHeight = 240): VideoResource {
+  return {
+    element: { readyState, videoWidth, videoHeight } as unknown as HTMLVideoElement,
+  };
+}
+
+describe('advanceVideoTexture', () => {
+  it('bumps frameId and returns the new value', () => {
+    const vt = createVideoTexture(makeVideoResource());
+    expect(vt.frameId).toBe(-1);
+    expect(advanceVideoTexture(vt)).toBe(0);
+    expect(advanceVideoTexture(vt)).toBe(1);
+    expect(vt.frameId).toBe(1);
+  });
+});
+
+describe('cloneVideoTexture', () => {
+  it('shares the source but deep-clones sampler and uv vectors and resets frameId', () => {
+    const source = makeVideoResource();
+    const vt = createVideoTexture(source, { uvOffset: createVector2(2, 3) });
+    advanceVideoTexture(vt);
+    const clone = cloneVideoTexture(vt);
+    expect(clone.source).toBe(source);
+    expect(clone.sampler).not.toBe(vt.sampler);
+    expect(clone.uvOffset).not.toBe(vt.uvOffset);
+    expect(clone.uvOffset.x).toBe(2);
+    expect(clone.frameId).toBe(-1);
+  });
+});
+
+describe('copyVideoTexture', () => {
+  it('copies fields into out and is safe when out aliases source', () => {
+    const a = createVideoTexture(makeVideoResource(), { colorSpace: 'linear', uvScale: createVector2(4, 5) });
+    advanceVideoTexture(a);
+    const b = createVideoTexture(makeVideoResource());
+    copyVideoTexture(b, a);
+    expect(b.colorSpace).toBe('linear');
+    expect(b.frameId).toBe(0);
+    expect(b.source).toBe(a.source);
+    expect(b.uvScale.x).toBe(4);
+    copyVideoTexture(a, a);
+    expect(a.uvScale.x).toBe(4);
+  });
+});
+
+describe('createVideoTexture', () => {
+  it('defaults to srgb, identity uv-transform, and frameId -1', () => {
+    const source = makeVideoResource();
+    const vt = createVideoTexture(source);
+    expect(vt.colorSpace).toBe('srgb');
+    expect(vt.source).toBe(source);
+    expect(vt.frameId).toBe(-1);
+    expect(vt.uvOffset.x).toBe(0);
+    expect(vt.uvScale.x).toBe(1);
+    expect(vt.uvRotation).toBe(0);
+  });
+});
+
+describe('getVideoTextureHeight', () => {
+  it('returns the element videoHeight when a frame is decoded, else -1', () => {
+    expect(getVideoTextureHeight(createVideoTexture(makeVideoResource(4, 320, 240)))).toBe(240);
+    expect(getVideoTextureHeight(createVideoTexture(makeVideoResource(0, 0, 0)))).toBe(-1);
+    expect(getVideoTextureHeight(createVideoTexture({ element: null }))).toBe(-1);
+  });
+});
+
+describe('getVideoTextureInverseUvMatrix', () => {
+  it('inverts the forward uv-transform', () => {
+    const vt = createVideoTexture(makeVideoResource(), { uvScale: createVector2(2, 2), uvOffset: createVector2(1, 0) });
+    const forward = createMatrix3();
+    const inverse = createMatrix3();
+    getVideoTextureUvMatrix(forward, vt);
+    getVideoTextureInverseUvMatrix(inverse, vt);
+    // forward * inverse should be identity: a point mapped forward then back returns to itself.
+    const m = forward.m;
+    const i = inverse.m;
+    // (forward maps (0,0) -> (1,0); inverse must map (1,0) -> (0,0))
+    const px = i[0] * 1 + i[3] * 0 + i[6];
+    const py = i[1] * 1 + i[4] * 0 + i[7];
+    expect(px).toBeCloseTo(0);
+    expect(py).toBeCloseTo(0);
+    expect(m[0]).toBe(2);
+  });
+});
+
+describe('getVideoTextureUvMatrix', () => {
+  it('composes scale, rotation, and offset in column-major layout', () => {
+    const vt = createVideoTexture(makeVideoResource(), {
+      uvScale: createVector2(2, 3),
+      uvOffset: createVector2(5, 7),
+    });
+    const out = createMatrix3();
+    getVideoTextureUvMatrix(out, vt);
+    expect(out.m[0]).toBe(2);
+    expect(out.m[4]).toBe(3);
+    expect(out.m[6]).toBe(5);
+    expect(out.m[7]).toBe(7);
+    expect(out.m[8]).toBe(1);
+  });
+});
+
+describe('getVideoTextureWidth', () => {
+  it('returns the element videoWidth when a frame is decoded, else -1', () => {
+    expect(getVideoTextureWidth(createVideoTexture(makeVideoResource(4, 320, 240)))).toBe(320);
+    expect(getVideoTextureWidth(createVideoTexture(makeVideoResource(0, 0, 0)))).toBe(-1);
+    expect(getVideoTextureWidth(createVideoTexture({ element: null }))).toBe(-1);
+  });
+});
+
+describe('isVideoTextureFrameReady', () => {
+  it('is true only when the element has a decoded frame with known dimensions', () => {
+    expect(isVideoTextureFrameReady(createVideoTexture(makeVideoResource(4, 320, 240)))).toBe(true);
+    expect(isVideoTextureFrameReady(createVideoTexture(makeVideoResource(1, 320, 240)))).toBe(false);
+    expect(isVideoTextureFrameReady(createVideoTexture(makeVideoResource(4, 0, 0)))).toBe(false);
+    expect(isVideoTextureFrameReady(createVideoTexture({ element: null }))).toBe(false);
+  });
+});
+
+describe('resetVideoTextureFrame', () => {
+  it('sets frameId back to -1', () => {
+    const vt = createVideoTexture(makeVideoResource());
+    advanceVideoTexture(vt);
+    advanceVideoTexture(vt);
+    resetVideoTextureFrame(vt);
+    expect(vt.frameId).toBe(-1);
+  });
+});
+
+describe('setVideoTextureSource', () => {
+  it('swaps the source and resets frameId', () => {
+    const vt = createVideoTexture(makeVideoResource());
+    advanceVideoTexture(vt);
+    const next = makeVideoResource(4, 640, 480);
+    setVideoTextureSource(vt, next);
+    expect(vt.source).toBe(next);
+    expect(vt.frameId).toBe(-1);
+    expect(getVideoTextureWidth(vt)).toBe(640);
+  });
+});