@flighthq/texture 0.5.1-next.1295.2b6bfa3 → 0.5.1-next.1345.0995dc5

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/texture`. The `@flig
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/texture@0.5.1-next.1295.2b6bfa3](https://github.com/flighthq/flight/tree/2b6bfa33110e26cbdd959441a6c36a4c78109ab8/packages/texture)
-- [License](https://github.com/flighthq/flight/blob/2b6bfa33110e26cbdd959441a6c36a4c78109ab8/LICENSE.md)
+- [Source for @flighthq/texture@0.5.1-next.1345.0995dc5](https://github.com/flighthq/flight/tree/0995dc5f840e6b57c3e85ecd2123aa798cf60b29/packages/texture)
+- [License](https://github.com/flighthq/flight/blob/0995dc5f840e6b57c3e85ecd2123aa798cf60b29/LICENSE.md)

package/dist/videoTexture.d.ts

@@ -1,15 +1,15 @@
-import type { EntityConstruction, HostImageSource, ImageResource, Matrix3Like, Texture, Texture2D, TextureLike, VideoResource } from '@flighthq/types/contract';
-export declare function advanceVideoTexture(texture: TextureLike): number;
+import type { EntityConstruction, HostImageSource, HostVideoProvider, ImageResource, Matrix3Like, Texture, Texture2D, TextureLike, VideoResource } from '@flighthq/types/contract';
+export declare function advanceVideoTexture(hostVideo: Readonly<HostVideoProvider>, texture: TextureLike): number;
 export declare function cloneVideoTexture(source: Readonly<TextureLike>): Texture;
 export declare function copyVideoTexture(out: TextureLike, source: Readonly<TextureLike>): void;
-export declare function createVideoTexture(source: VideoResource, opts?: Readonly<Partial<TextureLike>>): Texture2D;
+export declare function createVideoTexture(hostVideo: Readonly<HostVideoProvider>, source: VideoResource, opts?: Readonly<Partial<TextureLike>>): Texture2D;
 export declare function destroyVideoTexture(texture: Texture2D): void;
-export declare function getVideoTextureHeight(texture: Readonly<TextureLike>): number;
+export declare function getVideoTextureHeight(hostVideo: Readonly<HostVideoProvider>, texture: Readonly<TextureLike>): number;
 export declare function getVideoTextureInverseUvMatrix(out: Matrix3Like, texture: Readonly<TextureLike>): void;
 export declare function getVideoTextureUvMatrix(out: Matrix3Like, texture: Readonly<TextureLike>): void;
-export declare function getVideoTextureWidth(texture: Readonly<TextureLike>): number;
+export declare function getVideoTextureWidth(hostVideo: Readonly<HostVideoProvider>, texture: Readonly<TextureLike>): number;
 export declare function initializeVideoImageResource(out: EntityConstruction<ImageResource>, source: HostImageSource, version: number): void;
-export declare function isVideoTextureFrameReady(texture: Readonly<TextureLike>): boolean;
+export declare function isVideoTextureFrameReady(hostVideo: Readonly<HostVideoProvider>, texture: Readonly<TextureLike>): boolean;
 export declare function resetVideoTextureFrame(texture: TextureLike): void;
-export declare function setVideoTextureSource(texture: TextureLike, source: VideoResource): void;
+export declare function setVideoTextureSource(hostVideo: Readonly<HostVideoProvider>, texture: TextureLike, source: VideoResource): void;
 //# sourceMappingURL=videoTexture.d.ts.map

package/dist/videoTexture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoTexture.d.ts","sourceRoot":"","sources":["../src/videoTexture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,OAAO,EACP,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,0BAA0B,CAAC;AAOlC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAOhE;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAExE;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAEtF;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,SAAS,CAQ1G;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAG5D;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAG5E;AAGD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAGrG;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAE9F;AAGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAG3E;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,kBAAkB,CAAC,aAAa,CAAC,EACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CAQN;AAGD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAKhF;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAIjE;AAID,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAIvF"}
+{"version":3,"file":"videoTexture.d.ts","sourceRoot":"","sources":["../src/videoTexture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,OAAO,EACP,SAAS,EACT,WAAW,EACX,aAAa,EACd,MAAM,0BAA0B,CAAC;AAOlC,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAOxG;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAExE;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAEtF;AAKD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GACpC,SAAS,CAQX;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAG5D;AAGD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAIpH;AAGD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAGrG;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAE9F;AAGD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAInH;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,kBAAkB,CAAC,aAAa,CAAC,EACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd,IAAI,CAQN;AAGD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC7B,OAAO,CAQT;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAIjE;AAID,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,aAAa,GACpB,IAAI,CAIN"}

package/dist/videoTexture.js

@@ -4,11 +4,11 @@ import { ImageTextureSourceKind } from '@flighthq/types/contract';
 import { cloneTexture, copyTexture, createTexture, getTextureUvMatrix } from './texture';
 // Marks a fresh decoded frame on a video-backed Texture. The ImageResource is the shared CPU-origin source
 // and owns the upload revision; Texture.version mirrors it as the sampled object's dirty-bit.
-export function advanceVideoTexture(texture) {
+export function advanceVideoTexture(hostVideo, texture) {
     const image = getVideoImage(texture);
     if (image == null)
         return texture.version;
-    updateVideoImageSize(image);
+    updateVideoImageSize(hostVideo, image);
     image.version = (image.version + 1) >>> 0;
     texture.version = image.version;
     return texture.version;
@@ -24,8 +24,8 @@ export function copyVideoTexture(out, source) {
 // Wraps a VideoResource's borrowed host element in an ImageResource source and returns the same
 // universal Texture type used by still images and render targets. The all-ones initial revision
 // preserves the former first advanceVideoTexture result of 0 after u32 wrap.
-export function createVideoTexture(source, opts) {
-    const image = createVideoImageResource(source);
+export function createVideoTexture(hostVideo, source, opts) {
+    const image = createVideoImageResource(hostVideo, source);
     return createTexture({
         ...opts,
         dimension: '2d',
@@ -40,9 +40,10 @@ export function destroyVideoTexture(texture) {
     texture.version = INITIAL_VIDEO_VERSION;
 }
 // Returns the decoded frame height, or -1 while the borrowed host element is absent/unready.
-export function getVideoTextureHeight(texture) {
-    const element = getVideoElement(texture);
-    return element !== null && element.videoHeight > 0 ? element.videoHeight : -1;
+export function getVideoTextureHeight(hostVideo, texture) {
+    const source = getVideoSource(texture);
+    const height = source !== null ? (hostVideo.getHeight?.(source) ?? 0) : 0;
+    return height > 0 ? height : -1;
 }
 // Video-named compatibility entry over the universal Texture UV transform.
 export function getVideoTextureInverseUvMatrix(out, texture) {
@@ -54,9 +55,10 @@ export function getVideoTextureUvMatrix(out, texture) {
     getTextureUvMatrix(out, texture);
 }
 // Returns the decoded frame width, or -1 while the borrowed host element is absent/unready.
-export function getVideoTextureWidth(texture) {
-    const element = getVideoElement(texture);
-    return element !== null && element.videoWidth > 0 ? element.videoWidth : -1;
+export function getVideoTextureWidth(hostVideo, texture) {
+    const source = getVideoSource(texture);
+    const width = source !== null ? (hostVideo.getWidth?.(source) ?? 0) : 0;
+    return width > 0 ? width : -1;
 }
 export function initializeVideoImageResource(out, source, version) {
     out.alphaType = 'straight';
@@ -68,9 +70,12 @@ export function initializeVideoImageResource(out, source, version) {
     out.width = 0;
 }
 // True once the borrowed host element exposes a decoded current frame and non-zero dimensions.
-export function isVideoTextureFrameReady(texture) {
-    const element = getVideoElement(texture);
-    return (element !== null && element.readyState >= HAVE_CURRENT_DATA && element.videoWidth > 0 && element.videoHeight > 0);
+export function isVideoTextureFrameReady(hostVideo, texture) {
+    const source = getVideoSource(texture);
+    return (source !== null &&
+        hostVideo.isReady?.(source) === true &&
+        (hostVideo.getWidth?.(source) ?? 0) > 0 &&
+        (hostVideo.getHeight?.(source) ?? 0) > 0);
 }
 // Resets the shared source revision so its next advance wraps to 0 and every state re-uploads.
 export function resetVideoTextureFrame(texture) {
@@ -81,32 +86,30 @@ export function resetVideoTextureFrame(texture) {
 }
 // Replaces the immutable host-backed identity and resets its upload revision. The VideoResource
 // remains the loader/lifecycle object; Texture stores only its current host handle.
-export function setVideoTextureSource(texture, source) {
+export function setVideoTextureSource(hostVideo, texture, source) {
     if (texture.dimension !== '2d')
         throw new Error('setVideoTextureSource requires a Texture2D');
-    texture.source = createVideoImageResource(source);
+    texture.source = createVideoImageResource(hostVideo, source);
     texture.version = INITIAL_VIDEO_VERSION;
 }
-function createVideoImageResource(source) {
+function createVideoImageResource(hostVideo, source) {
     if (source.element === null)
         return null;
     const image = allocateEntity();
     initializeVideoImageResource(image, source.element, INITIAL_VIDEO_VERSION);
-    updateVideoImageSize(image);
+    updateVideoImageSize(hostVideo, image);
     return finishEntity(image);
 }
-function getVideoElement(texture) {
+function getVideoSource(texture) {
     return getVideoImage(texture)?.source ?? null;
 }
 function getVideoImage(texture) {
     return texture.dimension === '2d' ? texture.source : null;
 }
-function updateVideoImageSize(image) {
-    const element = image.source;
-    image.width = element.videoWidth || 0;
-    image.height = element.videoHeight || 0;
+function updateVideoImageSize(hostVideo, image) {
+    image.width = hostVideo.getWidth?.(image.source) ?? 0;
+    image.height = hostVideo.getHeight?.(image.source) ?? 0;
 }
-// HTMLMediaElement.HAVE_CURRENT_DATA and the u32 predecessor of the first public frame revision.
-const HAVE_CURRENT_DATA = 2;
+// The u32 predecessor of the first public frame revision.
 const INITIAL_VIDEO_VERSION = 0xffffffff;
 //# sourceMappingURL=videoTexture.js.map

package/dist/videoTexture.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/texture",
-  "version": "0.5.1-next.1295.2b6bfa3",
+  "version": "0.5.1-next.1345.0995dc5",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.5.1-next.1295.2b6bfa3",
-    "@flighthq/geometry": "0.5.1-next.1295.2b6bfa3",
-    "@flighthq/types": "0.5.1-next.1295.2b6bfa3"
+    "@flighthq/entity": "0.5.1-next.1345.0995dc5",
+    "@flighthq/geometry": "0.5.1-next.1345.0995dc5",
+    "@flighthq/types": "0.5.1-next.1345.0995dc5"
   },
   "devDependencies": {
     "@flighthq/video": "*",

package/src/videoTexture.test.ts

@@ -1,5 +1,5 @@
 import { createMatrix3, createVector2 } from '@flighthq/geometry/contract';
-import type { ImageResource, VideoResource } from '@flighthq/types/contract';
+import type { HostVideoProvider, ImageResource, VideoResource } from '@flighthq/types/contract';
 import { createVideoResource } from '@flighthq/video/contract';
 
 import { getTextureSource } from './texture';
@@ -19,16 +19,27 @@ import {
   setVideoTextureSource,
 } from './videoTexture';
 
+const testVideoHost = {
+  canPlayType: () => true,
+  getHeight: (source) => (source as HTMLVideoElement).videoHeight,
+  getWidth: (source) => (source as HTMLVideoElement).videoWidth,
+  isReady: (source) => (source as HTMLVideoElement).readyState >= 2,
+} satisfies HostVideoProvider;
+
 function makeVideoResource(readyState = 4, videoWidth = 320, videoHeight = 240): VideoResource {
-  return createVideoResource({ readyState, videoWidth, videoHeight } as unknown as HTMLVideoElement);
+  return createVideoResource({
+    readyState,
+    videoWidth,
+    videoHeight,
+  } as unknown as HTMLVideoElement);
 }
 
 describe('advanceVideoTexture', () => {
   it('bumps the source and Texture versions and returns the new value', () => {
-    const vt = createVideoTexture(makeVideoResource());
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
     expect(vt.version).toBe(0xffffffff);
-    expect(advanceVideoTexture(vt)).toBe(0);
-    expect(advanceVideoTexture(vt)).toBe(1);
+    expect(advanceVideoTexture(testVideoHost, vt)).toBe(0);
+    expect(advanceVideoTexture(testVideoHost, vt)).toBe(1);
     expect(vt.version).toBe(1);
     expect(getTextureSource(vt)?.version).toBe(1);
   });
@@ -37,8 +48,8 @@ describe('advanceVideoTexture', () => {
 describe('cloneVideoTexture', () => {
   it('shares the source but deep-clones sampler and uv vectors', () => {
     const source = makeVideoResource();
-    const vt = createVideoTexture(source, { uvOffset: createVector2(2, 3) });
-    advanceVideoTexture(vt);
+    const vt = createVideoTexture(testVideoHost, source, { uvOffset: createVector2(2, 3) });
+    advanceVideoTexture(testVideoHost, vt);
     const clone = cloneVideoTexture(vt);
     expect(getTextureSource(clone)).toBe(getTextureSource(vt));
     expect(clone.sampler).not.toBe(vt.sampler);
@@ -50,9 +61,12 @@ describe('cloneVideoTexture', () => {
 
 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());
+    const a = createVideoTexture(testVideoHost, makeVideoResource(), {
+      colorSpace: 'linear',
+      uvScale: createVector2(4, 5),
+    });
+    advanceVideoTexture(testVideoHost, a);
+    const b = createVideoTexture(testVideoHost, makeVideoResource());
     copyVideoTexture(b, a);
     expect(b.colorSpace).toBe('linear');
     expect(b.version).toBe(0);
@@ -66,7 +80,7 @@ describe('copyVideoTexture', () => {
 describe('createVideoTexture', () => {
   it('returns a universal srgb Texture with a borrowed host-image source', () => {
     const source = makeVideoResource();
-    const vt = createVideoTexture(source);
+    const vt = createVideoTexture(testVideoHost, source);
     expect(vt.colorSpace).toBe('srgb');
     expect((getTextureSource(vt) as ImageResource).source).toBe(source.element);
     expect(vt.version).toBe(0xffffffff);
@@ -74,12 +88,47 @@ describe('createVideoTexture', () => {
     expect(vt.uvScale.x).toBe(1);
     expect(vt.uvRotation).toBe(0);
   });
+
+  it('reads dimensions and readiness only through the supplied host provider', () => {
+    const resource = makeVideoResource(0, 320, 240);
+    const getHeight = vi.fn(() => 12);
+    const getWidth = vi.fn(() => 34);
+    const isReady = vi.fn(() => true);
+    const hostVideo = {
+      canPlayType: () => true,
+      getHeight,
+      getWidth,
+      isReady,
+    } satisfies HostVideoProvider;
+
+    const texture = createVideoTexture(hostVideo, resource);
+
+    expect(getTextureSource(texture)?.height).toBe(12);
+    expect(getTextureSource(texture)?.width).toBe(34);
+    expect(getVideoTextureHeight(hostVideo, texture)).toBe(12);
+    expect(getVideoTextureWidth(hostVideo, texture)).toBe(34);
+    expect(isVideoTextureFrameReady(hostVideo, texture)).toBe(true);
+    expect(getHeight).toHaveBeenCalledWith(resource.element);
+    expect(getWidth).toHaveBeenCalledWith(resource.element);
+    expect(isReady).toHaveBeenCalledWith(resource.element);
+  });
+
+  it('uses dimension and readiness sentinels when the provider omits inspection methods', () => {
+    const hostVideo = { canPlayType: () => false } satisfies HostVideoProvider;
+    const texture = createVideoTexture(hostVideo, makeVideoResource());
+
+    expect(getTextureSource(texture)?.height).toBe(0);
+    expect(getTextureSource(texture)?.width).toBe(0);
+    expect(getVideoTextureHeight(hostVideo, texture)).toBe(-1);
+    expect(getVideoTextureWidth(hostVideo, texture)).toBe(-1);
+    expect(isVideoTextureFrameReady(hostVideo, texture)).toBe(false);
+  });
 });
 
 describe('destroyVideoTexture', () => {
   it('nulls the texture source and resets the version', () => {
-    const vt = createVideoTexture(makeVideoResource());
-    advanceVideoTexture(vt);
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
+    advanceVideoTexture(testVideoHost, vt);
     expect(getTextureSource(vt)).not.toBeNull();
     destroyVideoTexture(vt);
     expect(getTextureSource(vt)).toBeNull();
@@ -89,39 +138,46 @@ describe('destroyVideoTexture', () => {
   it('does not modify the borrowed video resource', () => {
     const resource = makeVideoResource();
     const element = resource.element;
-    const vt = createVideoTexture(resource);
+    const vt = createVideoTexture(testVideoHost, resource);
     destroyVideoTexture(vt);
     expect(resource.element).toBe(element);
   });
 
   it('is idempotent', () => {
-    const vt = createVideoTexture(makeVideoResource());
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
     destroyVideoTexture(vt);
     destroyVideoTexture(vt);
     expect(getTextureSource(vt)).toBeNull();
   });
 
   it('makes subsequent accessor calls return sentinel values', () => {
-    const vt = createVideoTexture(makeVideoResource());
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
     destroyVideoTexture(vt);
-    expect(getVideoTextureWidth(vt)).toBe(-1);
-    expect(getVideoTextureHeight(vt)).toBe(-1);
-    expect(isVideoTextureFrameReady(vt)).toBe(false);
-    expect(advanceVideoTexture(vt)).toBe(0xffffffff);
+    expect(getVideoTextureWidth(testVideoHost, vt)).toBe(-1);
+    expect(getVideoTextureHeight(testVideoHost, vt)).toBe(-1);
+    expect(isVideoTextureFrameReady(testVideoHost, vt)).toBe(false);
+    expect(advanceVideoTexture(testVideoHost, vt)).toBe(0xffffffff);
   });
 });
 
 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(createVideoResource()))).toBe(-1);
+    expect(
+      getVideoTextureHeight(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(4, 320, 240))),
+    ).toBe(240);
+    expect(getVideoTextureHeight(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(0, 0, 0)))).toBe(
+      -1,
+    );
+    expect(getVideoTextureHeight(testVideoHost, createVideoTexture(testVideoHost, createVideoResource()))).toBe(-1);
   });
 });
 
 describe('getVideoTextureInverseUvMatrix', () => {
   it('inverts the forward uv-transform', () => {
-    const vt = createVideoTexture(makeVideoResource(), { uvScale: createVector2(2, 2), uvOffset: createVector2(1, 0) });
+    const vt = createVideoTexture(testVideoHost, makeVideoResource(), {
+      uvScale: createVector2(2, 2),
+      uvOffset: createVector2(1, 0),
+    });
     const forward = createMatrix3();
     const inverse = createMatrix3();
     getVideoTextureUvMatrix(forward, vt);
@@ -140,7 +196,7 @@ describe('getVideoTextureInverseUvMatrix', () => {
 
 describe('getVideoTextureUvMatrix', () => {
   it('composes scale, rotation, and offset in column-major layout', () => {
-    const vt = createVideoTexture(makeVideoResource(), {
+    const vt = createVideoTexture(testVideoHost, makeVideoResource(), {
       uvScale: createVector2(2, 3),
       uvOffset: createVector2(5, 7),
     });
@@ -156,9 +212,11 @@ describe('getVideoTextureUvMatrix', () => {
 
 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(createVideoResource()))).toBe(-1);
+    expect(getVideoTextureWidth(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(4, 320, 240)))).toBe(
+      320,
+    );
+    expect(getVideoTextureWidth(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(0, 0, 0)))).toBe(-1);
+    expect(getVideoTextureWidth(testVideoHost, createVideoTexture(testVideoHost, createVideoResource()))).toBe(-1);
   });
 });
 
@@ -170,18 +228,26 @@ describe('initializeVideoImageResource', () => {
 
 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(createVideoResource()))).toBe(false);
+    expect(
+      isVideoTextureFrameReady(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(4, 320, 240))),
+    ).toBe(true);
+    expect(
+      isVideoTextureFrameReady(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(1, 320, 240))),
+    ).toBe(false);
+    expect(isVideoTextureFrameReady(testVideoHost, createVideoTexture(testVideoHost, makeVideoResource(4, 0, 0)))).toBe(
+      false,
+    );
+    expect(isVideoTextureFrameReady(testVideoHost, createVideoTexture(testVideoHost, createVideoResource()))).toBe(
+      false,
+    );
   });
 });
 
 describe('resetVideoTextureFrame', () => {
   it('sets the shared revision to the u32 pre-first-frame sentinel', () => {
-    const vt = createVideoTexture(makeVideoResource());
-    advanceVideoTexture(vt);
-    advanceVideoTexture(vt);
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
+    advanceVideoTexture(testVideoHost, vt);
+    advanceVideoTexture(testVideoHost, vt);
     resetVideoTextureFrame(vt);
     expect(vt.version).toBe(0xffffffff);
     expect(getTextureSource(vt)?.version).toBe(0xffffffff);
@@ -189,12 +255,12 @@ describe('resetVideoTextureFrame', () => {
 });
 describe('setVideoTextureSource', () => {
   it('swaps the borrowed host handle and resets the version', () => {
-    const vt = createVideoTexture(makeVideoResource());
-    advanceVideoTexture(vt);
+    const vt = createVideoTexture(testVideoHost, makeVideoResource());
+    advanceVideoTexture(testVideoHost, vt);
     const next = makeVideoResource(4, 640, 480);
-    setVideoTextureSource(vt, next);
+    setVideoTextureSource(testVideoHost, vt, next);
     expect((getTextureSource(vt) as ImageResource).source).toBe(next.element);
     expect(vt.version).toBe(0xffffffff);
-    expect(getVideoTextureWidth(vt)).toBe(640);
+    expect(getVideoTextureWidth(testVideoHost, vt)).toBe(640);
   });
 });