@flighthq/texture 0.2.1-next.841.373388f → 0.3.0-next.1032.e2b99fc

package/dist/videoTexture.d.ts

@@ -1,13 +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;
+import type { Matrix3Like, Texture, TextureLike, VideoResource } from '@flighthq/types/contract';
+export declare function advanceVideoTexture(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>>): Texture;
+export declare function getVideoTextureHeight(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 isVideoTextureFrameReady(texture: Readonly<TextureLike>): boolean;
+export declare function resetVideoTextureFrame(texture: TextureLike): void;
+export declare function setVideoTextureSource(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,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AASlG,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,gBAAgB,GAAG,MAAM,CAG1E;AAMD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAYlF;AAKD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAgBhG;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,YAAY,CAYlH;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;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAExG;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"}
+{"version":3,"file":"videoTexture.d.ts","sourceRoot":"","sources":["../src/videoTexture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOhH,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,OAAO,CAOxG;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;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"}

package/dist/videoTexture.js

@@ -1,113 +1,98 @@
-import { createEntity } from '@flighthq/entity';
-import { cloneVector2, copyVector2, createVector2, inverseMatrix3 } from '@flighthq/geometry';
-import { cloneSampler, copySampler, createSampler } from './sampler';
-import { getTextureUvMatrix } from './texture';
-// 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;
+import { createEntity } from '@flighthq/entity/contract';
+import { inverseMatrix3 } from '@flighthq/geometry/contract';
+import { VideoTextureBackingKind } 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
+// backing and owns the upload revision; Texture.version mirrors it as the sampled object's dirty-bit.
+export function advanceVideoTexture(texture) {
+    const image = texture.storage.image;
+    if (image == null)
+        return texture.version;
+    updateVideoImageSize(image);
+    image.version = (image.version + 1) >>> 0;
+    texture.version = image.version;
+    return texture.version;
 }
-// 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.
+// Clones sampling/UV state while sharing the borrowed video ImageResource and its upload cache key.
 export function cloneVideoTexture(source) {
-    return createEntity({
-        colorSpace: source.colorSpace,
-        flipX: source.flipX,
-        flipY: source.flipY,
-        frameId: -1,
-        sampler: cloneSampler(source.sampler),
-        source: source.source,
-        uvOffset: cloneVector2(source.uvOffset),
-        uvRotation: source.uvRotation,
-        uvScale: cloneVector2(source.uvScale),
-    });
+    return cloneTexture(source);
 }
-// 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.
+// Copies a video-backed Texture through the universal Texture field copier.
 export function copyVideoTexture(out, source) {
-    const colorSpace = source.colorSpace;
-    const flipX = source.flipX;
-    const flipY = source.flipY;
-    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.flipX = flipX;
-    out.flipY = flipY;
-    out.frameId = frameId;
-    out.source = src;
-    out.uvRotation = uvRotation;
+    copyTexture(out, source);
 }
-// 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.
+// Wraps a VideoResource's borrowed host element in an ImageResource backing 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) {
-    return createEntity({
-        colorSpace: opts?.colorSpace ?? 'srgb',
-        flipX: opts?.flipX ?? false,
-        flipY: opts?.flipY ?? false,
-        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),
+    const image = createVideoImageResource(source);
+    return createTexture({
+        ...opts,
+        storage: { dimension: '2d', image },
+        version: image?.version ?? INITIAL_VIDEO_VERSION,
     });
 }
-// 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;
+// 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;
 }
-// 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);
+// Video-named compatibility entry over the universal Texture UV transform.
+export function getVideoTextureInverseUvMatrix(out, texture) {
+    getVideoTextureUvMatrix(out, texture);
     inverseMatrix3(out, out);
 }
-// Composes the KHR_texture_transform fields (flip, uvOffset, uvRotation, uvScale) into the column-major
-// 3×3 matrix a shader consumes at sample time. A VideoTexture is a TextureUvTransform, so this delegates
-// to getTextureUvMatrix — one uv-transform path (flip → scale → rotate → translate) for both texture
-// kinds. Out-param form.
-export function getVideoTextureUvMatrix(out, videoTexture) {
-    getTextureUvMatrix(out, videoTexture);
+// Video-named compatibility entry over the universal Texture UV transform.
+export function getVideoTextureUvMatrix(out, texture) {
+    getTextureUvMatrix(out, texture);
 }
-// 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;
+// 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;
 }
-// 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;
+// 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);
 }
-// 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;
+// Resets the shared backing revision so its next advance wraps to 0 and every state re-uploads.
+export function resetVideoTextureFrame(texture) {
+    const image = texture.storage.image;
+    if (image != null)
+        image.version = INITIAL_VIDEO_VERSION;
+    texture.version = INITIAL_VIDEO_VERSION;
+}
+// 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) {
+    if (texture.storage.dimension !== '2d')
+        throw new Error('setVideoTextureSource requires 2d texture storage');
+    texture.storage.image = createVideoImageResource(source);
+    texture.version = INITIAL_VIDEO_VERSION;
+}
+function createVideoImageResource(source) {
+    if (source.element === null)
+        return null;
+    const image = createEntity({
+        height: 0,
+        kind: VideoTextureBackingKind,
+        source: source.element,
+        version: INITIAL_VIDEO_VERSION,
+        width: 0,
+    });
+    updateVideoImageSize(image);
+    return image;
+}
+function getVideoElement(texture) {
+    return texture.storage.image?.source ?? null;
 }
-// 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;
+function updateVideoImageSize(image) {
+    const element = image.source;
+    image.width = element.videoWidth || 0;
+    image.height = element.videoHeight || 0;
 }
-// HTMLMediaElement.HAVE_CURRENT_DATA — data for the current playback position is available.
+// HTMLMediaElement.HAVE_CURRENT_DATA and the u32 predecessor of the first public frame revision.
 const HAVE_CURRENT_DATA = 2;
+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.2.1-next.841.373388f",
+  "version": "0.3.0-next.1032.e2b99fc",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -13,6 +13,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
     }
   },
   "files": [
@@ -32,9 +36,9 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.2.1-next.841.373388f",
-    "@flighthq/geometry": "0.2.1-next.841.373388f",
-    "@flighthq/types": "0.2.1-next.841.373388f"
+    "@flighthq/entity": "0.3.0-next.1032.e2b99fc",
+    "@flighthq/geometry": "0.3.0-next.1032.e2b99fc",
+    "@flighthq/types": "0.3.0-next.1032.e2b99fc"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/cubeTexture.test.ts

@@ -1,5 +1,5 @@
-import type { ImageResource } from '@flighthq/types';
-import { CubeFaceNegativeX, CubeFacePositiveX, CubeFacePositiveY } from '@flighthq/types';
+import type { CubeTexture, ImageResource, TextureCubeImages } from '@flighthq/types/contract';
+import { CubeFaceNegativeX, CubeFacePositiveX, CubeFacePositiveY } from '@flighthq/types/contract';
 
 import {
   cloneCubeTexture,
@@ -15,27 +15,27 @@ import { createSampler, equalsSampler } from './sampler';
 const fakeFace = { width: 64, height: 64 } as ImageResource;
 const fakeFace2 = { width: 128, height: 128 } as ImageResource;
 
-const allFaces: readonly (ImageResource | null)[] = [fakeFace, fakeFace, fakeFace, fakeFace, fakeFace, fakeFace];
+const allFaces: TextureCubeImages = [fakeFace, fakeFace, fakeFace, fakeFace, fakeFace, fakeFace];
 
 describe('cloneCubeTexture', () => {
   it('shares the face references in a fresh array and deep-clones the sampler', () => {
     const source = createCubeTexture({
       colorSpace: 'linear',
-      faces: [fakeFace, null, null, null, null, null],
+      images: [fakeFace, null, null, null, null, null],
     });
 
     const copy = cloneCubeTexture(source);
 
     expect(copy).not.toBe(source);
     expect(copy.colorSpace).toStrictEqual('linear');
-    expect(copy.faces).not.toBe(source.faces);
-    expect(copy.faces[0]).toBe(fakeFace);
+    expect(copy.storage.images).not.toBe(source.storage.images);
+    expect(copy.storage.images[0]).toBe(fakeFace);
     expect(copy.sampler).not.toBe(source.sampler);
     expect(equalsSampler(copy.sampler, source.sampler)).toBe(true);
 
     // A fresh faces array means reassigning a face on the clone cannot reach the source.
-    expect(copy.faces).not.toBe(source.faces);
-    expect(source.faces[1]).toBeNull();
+    expect(copy.storage.images).not.toBe(source.storage.images);
+    expect(source.storage.images[1]).toBeNull();
   });
 });
 
@@ -43,7 +43,7 @@ describe('copyCubeTexture', () => {
   it('writes every field from source into a distinct out, preserving sampler identity', () => {
     const source = createCubeTexture({
       colorSpace: 'linear',
-      faces: [fakeFace, null, null, null, null, null],
+      images: [fakeFace, null, null, null, null, null],
     });
     const out = createCubeTexture();
     const outSampler = out.sampler;
@@ -51,7 +51,7 @@ describe('copyCubeTexture', () => {
     copyCubeTexture(out, source);
 
     expect(out.colorSpace).toStrictEqual('linear');
-    expect(out.faces[0]).toBe(fakeFace);
+    expect(out.storage.images[0]).toBe(fakeFace);
     expect(out.sampler).toBe(outSampler);
     expect(equalsSampler(out.sampler, source.sampler)).toBe(true);
   });
@@ -59,13 +59,13 @@ describe('copyCubeTexture', () => {
   it('is safe when out aliases source', () => {
     const cube = createCubeTexture({
       colorSpace: 'linear',
-      faces: [fakeFace, null, null, null, null, null],
+      images: [fakeFace, null, null, null, null, null],
     });
 
     copyCubeTexture(cube, cube);
 
     expect(cube.colorSpace).toStrictEqual('linear');
-    expect(cube.faces[0]).toBe(fakeFace);
+    expect(cube.storage.images[0]).toBe(fakeFace);
   });
 });
 
@@ -73,25 +73,26 @@ describe('createCubeTexture', () => {
   it('applies the default six unbound faces, srgb, default sampler', () => {
     const cube = createCubeTexture();
 
-    expect(cube.faces).toHaveLength(6);
-    expect(cube.faces.every((face) => face === null)).toBe(true);
+    expectTypeOf(cube).toEqualTypeOf<CubeTexture>();
+    expect(cube.storage.images).toHaveLength(6);
+    expect(cube.storage.images.every((face) => face === null)).toBe(true);
     expect(cube.colorSpace).toStrictEqual('srgb');
     expect(equalsSampler(cube.sampler, createSampler())).toBe(true);
   });
 
   it('copies a supplied faces array rather than aliasing it', () => {
-    const faces = [fakeFace, null, null, null, null, null];
-    const cube = createCubeTexture({ faces });
+    const images: TextureCubeImages = [fakeFace, null, null, null, null, null];
+    const cube = createCubeTexture({ images });
 
-    expect(cube.faces).not.toBe(faces);
-    expect(cube.faces[0]).toBe(fakeFace);
+    expect(cube.storage.images).not.toBe(images);
+    expect(cube.storage.images[0]).toBe(fakeFace);
   });
 });
 
 describe('equalsCubeTexture', () => {
   it('is true for cubes with the same color space, sampler, and face references', () => {
-    const a = createCubeTexture({ colorSpace: 'linear', faces: allFaces });
-    const b = createCubeTexture({ colorSpace: 'linear', faces: allFaces });
+    const a = createCubeTexture({ colorSpace: 'linear', images: allFaces });
+    const b = createCubeTexture({ colorSpace: 'linear', images: allFaces });
 
     expect(equalsCubeTexture(a, b)).toBe(true);
     expect(equalsCubeTexture(a, a)).toBe(true);
@@ -105,9 +106,9 @@ describe('equalsCubeTexture', () => {
   });
 
   it('is false when a face reference differs', () => {
-    const a = createCubeTexture({ faces: allFaces });
-    const b = createCubeTexture({ faces: allFaces });
-    (b.faces as (ImageResource | null)[])[0] = fakeFace2;
+    const a = createCubeTexture({ images: allFaces });
+    const b = createCubeTexture({ images: allFaces });
+    (b.storage.images as unknown as (ImageResource | null)[])[0] = fakeFace2;
 
     expect(equalsCubeTexture(a, b)).toBe(false);
   });
@@ -130,7 +131,7 @@ describe('equalsCubeTexture', () => {
 
 describe('getCubeTextureFaceSize', () => {
   it('returns the width of the first non-null face', () => {
-    const cube = createCubeTexture({ faces: [null, fakeFace, null, null, null, null] });
+    const cube = createCubeTexture({ images: [null, fakeFace, null, null, null, null] });
 
     expect(getCubeTextureFaceSize(cube)).toStrictEqual(64);
   });
@@ -144,13 +145,13 @@ describe('getCubeTextureFaceSize', () => {
 
 describe('isCubeTextureComplete', () => {
   it('is false when any face is null', () => {
-    const cube = createCubeTexture({ faces: [fakeFace, null, null, null, null, null] });
+    const cube = createCubeTexture({ images: [fakeFace, null, null, null, null, null] });
 
     expect(isCubeTextureComplete(cube)).toBe(false);
   });
 
   it('is true when all six faces are bound', () => {
-    const cube = createCubeTexture({ faces: allFaces });
+    const cube = createCubeTexture({ images: allFaces });
 
     expect(isCubeTextureComplete(cube)).toBe(true);
   });
@@ -161,14 +162,14 @@ describe('setCubeTextureFace', () => {
     const cube = createCubeTexture();
 
     setCubeTextureFace(cube, CubeFacePositiveX, fakeFace);
-    expect(cube.faces[CubeFacePositiveX]).toBe(fakeFace);
-    expect(cube.faces[CubeFaceNegativeX]).toBeNull();
+    expect(cube.storage.images[CubeFacePositiveX]).toBe(fakeFace);
+    expect(cube.storage.images[CubeFaceNegativeX]).toBeNull();
   });
 
   it('unbinds a face when passed null', () => {
-    const cube = createCubeTexture({ faces: allFaces });
+    const cube = createCubeTexture({ images: allFaces });
 
     setCubeTextureFace(cube, CubeFacePositiveY, null);
-    expect(cube.faces[CubeFacePositiveY]).toBeNull();
+    expect(cube.storage.images[CubeFacePositiveY]).toBeNull();
   });
 });

package/src/renderTexture.test.ts

@@ -0,0 +1,48 @@
+import type { RenderTexture } from '@flighthq/types/contract';
+
+import { createRenderTexture } from './renderTexture';
+import { createSampler } from './sampler';
+
+describe('createRenderTexture', () => {
+  it('creates a linear render target with identity UVs and no depth by default', () => {
+    const texture = createRenderTexture({ height: 32, width: 64 });
+
+    expectTypeOf(texture).toEqualTypeOf<RenderTexture>();
+    expect(texture).toMatchObject({
+      colorSpace: 'linear',
+      flipX: false,
+      flipY: false,
+      storage: {
+        dimension: '2d',
+        image: null,
+        target: { colorSpace: 'linear', height: 32, width: 64 },
+      },
+      uvOffset: { x: 0, y: 0 },
+      uvRotation: 0,
+      uvScale: { x: 1, y: 1 },
+      version: 0,
+    });
+  });
+
+  it('applies sampling, depth, color-space, and uv overrides without aliasing mutable values', () => {
+    const sampler = createSampler({ magFilter: 'nearest' });
+    const uvOffset = { x: 0.25, y: 0.5 };
+    const texture = createRenderTexture({
+      colorSpace: 'srgb',
+      depth: 'depth-stencil',
+      flipY: false,
+      height: 16,
+      sampler,
+      uvOffset,
+      width: 8,
+    });
+
+    expect(texture.colorSpace).toBe('srgb');
+    expect(texture.storage.target.depth).toBe('depth-stencil');
+    expect(texture.flipY).toBe(false);
+    expect(texture.sampler.magFilter).toBe('nearest');
+    expect(texture.sampler).not.toBe(sampler);
+    expect(texture.uvOffset).toMatchObject(uvOffset);
+    expect(texture.uvOffset).not.toBe(uvOffset);
+  });
+});