@flighthq/texture 0.1.0

package/dist/cubeTexture.d.ts

@@ -0,0 +1,9 @@
+import type { CubeTexture, CubeTextureLike, ImageResource } from '@flighthq/types';
+export declare function cloneCubeTexture(source: Readonly<CubeTextureLike>): CubeTexture;
+export declare function copyCubeTexture(out: CubeTextureLike, source: Readonly<CubeTextureLike>): void;
+export declare function createCubeTexture(opts?: Readonly<Partial<CubeTextureLike>>): CubeTexture;
+export declare function equalsCubeTexture(a: Readonly<CubeTextureLike> | null | undefined, b: Readonly<CubeTextureLike> | null | undefined): boolean;
+export declare function getCubeTextureFaceSize(cube: Readonly<CubeTextureLike>): number;
+export declare function isCubeTextureComplete(cube: Readonly<CubeTextureLike>): boolean;
+export declare function setCubeTextureFace(cube: CubeTextureLike, faceIndex: number, image: ImageResource | null): void;
+//# sourceMappingURL=cubeTexture.d.ts.map

package/dist/cubeTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubeTexture.d.ts","sourceRoot":"","sources":["../src/cubeTexture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,WAAW,CAM/E;AAKD,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,CAiB7F;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,WAAW,CAMxF;AAID,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/C,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9C,OAAO,CAST;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,MAAM,CAM9E;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,OAAO,CAE9E;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAE9G"}

package/dist/cubeTexture.js

@@ -0,0 +1,83 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneSampler, copySampler, createSampler, equalsSampler } from './sampler';
+// Allocates an independent CubeTexture over the SAME six face pixels: each ImageResource reference
+// is shared (the faces array itself is a fresh copy, so reassigning a face on the clone does not
+// touch the source), while the Sampler is deep-cloned so the cubes sample independently.
+export function cloneCubeTexture(source) {
+    return createEntity({
+        colorSpace: source.colorSpace,
+        faces: source.faces.slice(),
+        sampler: cloneSampler(source.sampler),
+    });
+}
+// Copies every CubeTexture field from source into out in place. Each face reference is shared;
+// the Sampler is copied into out's existing Sampler entity (its identity is preserved). Safe when
+// out aliases source: all input values are read into locals before any writes.
+export function copyCubeTexture(out, source) {
+    const colorSpace = source.colorSpace;
+    const f0 = source.faces[0];
+    const f1 = source.faces[1];
+    const f2 = source.faces[2];
+    const f3 = source.faces[3];
+    const f4 = source.faces[4];
+    const f5 = source.faces[5];
+    copySampler(out.sampler, source.sampler);
+    out.colorSpace = colorSpace;
+    const faces = out.faces;
+    faces[0] = f0;
+    faces[1] = f1;
+    faces[2] = f2;
+    faces[3] = f3;
+    faces[4] = f4;
+    faces[5] = f5;
+}
+// Builds a CubeTexture: six unbound faces (all null, in the canonical +X, -X, +Y, -Y, +Z, -Z
+// order), a default Sampler, and 'srgb' color space (the environment-radiance default). Pass
+// CubeTextureLike fields to override any of these; a supplied `faces` array is copied.
+export function createCubeTexture(opts) {
+    return createEntity({
+        colorSpace: opts?.colorSpace ?? 'srgb',
+        faces: opts?.faces ? opts.faces.slice() : [null, null, null, null, null, null],
+        sampler: opts?.sampler ? cloneSampler(opts.sampler) : createSampler(),
+    });
+}
+// True when both cube textures describe identical state: same color space, same sampler state, and
+// the same face references in every slot. Returns false for null/undefined operands.
+export function equalsCubeTexture(a, b) {
+    if (!a || !b)
+        return false;
+    if (a === b)
+        return true;
+    if (a.colorSpace !== b.colorSpace)
+        return false;
+    if (!equalsSampler(a.sampler, b.sampler))
+        return false;
+    for (let i = 0; i < 6; i++) {
+        if (a.faces[i] !== b.faces[i])
+            return false;
+    }
+    return true;
+}
+// Returns the pixel size (width = height for a cube face) of the first non-null face, or -1 when
+// no face is bound. Cube faces are assumed square; width is used as the canonical face size.
+export function getCubeTextureFaceSize(cube) {
+    for (let i = 0; i < 6; i++) {
+        const face = cube.faces[i];
+        if (face !== null)
+            return face.width;
+    }
+    return -1;
+}
+// True when all six faces are non-null. Materials and IBL pipelines (skybox, reflections) gate
+// sampling behind this; an incomplete cube is treated as absent.
+export function isCubeTextureComplete(cube) {
+    return cube.faces.every((face) => face !== null);
+}
+// Assigns a single face image in place. Use the CubeFace* constants from @flighthq/types
+// (CubeFacePositiveX = 0, CubeFaceNegativeX = 1, CubeFacePositiveY = 2, CubeFaceNegativeY = 3,
+// CubeFacePositiveZ = 4, CubeFaceNegativeZ = 5) instead of magic-number indices.
+// Pass null to unbind the face.
+export function setCubeTextureFace(cube, faceIndex, image) {
+    cube.faces[faceIndex] = image;
+}
+//# sourceMappingURL=cubeTexture.js.map

package/dist/cubeTexture.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './cubeTexture';
+export * from './sampler';
+export * from './texture';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './cubeTexture';
+export * from './sampler';
+export * from './texture';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/sampler.d.ts

@@ -0,0 +1,10 @@
+import type { Sampler, SamplerLike } from '@flighthq/types';
+export declare function cloneSampler(source: Readonly<SamplerLike>): Sampler;
+export declare function copySampler(out: SamplerLike, source: Readonly<SamplerLike>): void;
+export declare function createAnisotropicSampler(level: number): Sampler;
+export declare function createClampLinearSampler(): Sampler;
+export declare function createPixelArtSampler(): Sampler;
+export declare function createSampler(opts?: Readonly<Partial<SamplerLike>>): Sampler;
+export declare function createTilingSampler(): Sampler;
+export declare function equalsSampler(a: Readonly<SamplerLike> | null | undefined, b: Readonly<SamplerLike> | null | undefined): boolean;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../src/sampler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CASnE;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAOjF;AAKD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAID,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAID,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAKD,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAS5E;AAID,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;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,CAWT"}

package/dist/sampler.js

@@ -0,0 +1,71 @@
+import { createEntity } from '@flighthq/entity';
+// Allocates an independent Sampler with the same sampling state. Sampler holds only plain values,
+// so the clone shares nothing mutable with its source.
+export function cloneSampler(source) {
+    return createEntity({
+        anisotropy: source.anisotropy,
+        magFilter: source.magFilter,
+        minFilter: source.minFilter,
+        mipmaps: source.mipmaps,
+        wrapU: source.wrapU,
+        wrapV: source.wrapV,
+    });
+}
+// Copies every sampling field from source into out in place. Safe when out aliases source: all
+// reads precede the writes implicitly because each field is read and written independently.
+export function copySampler(out, source) {
+    out.anisotropy = source.anisotropy;
+    out.magFilter = source.magFilter;
+    out.minFilter = source.minFilter;
+    out.mipmaps = source.mipmaps;
+    out.wrapU = source.wrapU;
+    out.wrapV = source.wrapV;
+}
+// Anisotropic sampler for high-quality surface textures rendered at oblique angles. Uses the given
+// anisotropy level (typically 4 or 16 — capped to hardware maximum by the backend), with
+// trilinear filtering and clamp-to-edge. Pass level 1 to disable anisotropy.
+export function createAnisotropicSampler(level) {
+    return createSampler({ anisotropy: level });
+}
+// Clamp-to-edge linear sampler — the default preset, named for explicit use in builder code and
+// materials that want to signal their intent clearly. Clamp/linear/trilinear/mipmaps on.
+export function createClampLinearSampler() {
+    return createSampler();
+}
+// Pixel-art sampler: nearest-neighbor filtering, clamp-to-edge, mipmaps disabled. Produces crisp,
+// unsmoothed pixels for retro / pixel-art rendering styles.
+export function createPixelArtSampler() {
+    return createSampler({ magFilter: 'nearest', minFilter: 'nearest', mipmaps: false });
+}
+// Builds a Sampler with the AAA-default sampling state: clamp-to-edge on both axes, linear
+// magnification, trilinear minification, a generated mip chain, and anisotropy disabled (1). Pass
+// SamplerLike fields to override any of these.
+export function createSampler(opts) {
+    return createEntity({
+        anisotropy: opts?.anisotropy ?? 1,
+        magFilter: opts?.magFilter ?? 'linear',
+        minFilter: opts?.minFilter ?? 'linear-mipmap-linear',
+        mipmaps: opts?.mipmaps ?? true,
+        wrapU: opts?.wrapU ?? 'clamp-to-edge',
+        wrapV: opts?.wrapV ?? 'clamp-to-edge',
+    });
+}
+// Tiling sampler: repeat wrap on both axes, trilinear filtering, mipmaps on. Suitable for
+// seamless tiling surface textures (terrain, ground planes, repeating patterns).
+export function createTilingSampler() {
+    return createSampler({ wrapU: 'repeat', wrapV: 'repeat' });
+}
+// True when both samplers describe identical sampling state. Returns false for null/undefined
+// operands so callers can compare nullable references directly.
+export function equalsSampler(a, b) {
+    if (!a || !b)
+        return false;
+    return (a === b ||
+        (a.anisotropy === b.anisotropy &&
+            a.magFilter === b.magFilter &&
+            a.minFilter === b.minFilter &&
+            a.mipmaps === b.mipmaps &&
+            a.wrapU === b.wrapU &&
+            a.wrapV === b.wrapV));
+}
+//# sourceMappingURL=sampler.js.map

package/dist/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../src/sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,kGAAkG;AAClG,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,MAA6B;IACxD,OAAO,YAAY,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,MAA6B;IACzE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACnC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACjC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACjC,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC7B,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;AAC3B,CAAC;AAED,mGAAmG;AACnG,yFAAyF;AACzF,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,aAAa,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,gGAAgG;AAChG,yFAAyF;AACzF,MAAM,UAAU,wBAAwB;IACtC,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED,kGAAkG;AAClG,4DAA4D;AAC5D,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,2FAA2F;AAC3F,kGAAkG;AAClG,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAAC,IAAqC;IACjE,OAAO,YAAY,CAAC;QAClB,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,CAAC;QACjC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,QAAQ;QACtC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,sBAAsB;QACpD,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC9B,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,eAAe;QACrC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,eAAe;KACtC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,iFAAiF;AACjF,MAAM,UAAU,mBAAmB;IACjC,OAAO,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,8FAA8F;AAC9F,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAC3B,CAA2C,EAC3C,CAA2C;IAE3C,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,OAAO,CACL,CAAC,KAAK,CAAC;QACP,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU;YAC5B,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAC3B,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;YAC3B,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YACvB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YACnB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,CACvB,CAAC;AACJ,CAAC"}

package/dist/texture.d.ts

@@ -0,0 +1,17 @@
+import type { ImageResource, Matrix3Like, Texture, TextureLike, 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 getTextureWidth(texture: Readonly<TextureLike>): number;
+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;
+export declare function setTextureUvOffset(texture: TextureLike, x: number, y: number): void;
+export declare function setTextureUvRotation(texture: TextureLike, radians: number): void;
+export declare function setTextureUvScale(texture: TextureLike, x: number, y: number): void;
+export declare function transformTextureUv(out: Vector2Like, texture: Readonly<TextureLike>, u: number, v: number): void;
+//# sourceMappingURL=texture.d.ts.map

package/dist/texture.d.ts.map

@@ -0,0 +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;AAOD,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"}

package/dist/texture.js

@@ -0,0 +1,151 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneVector2, copyVector2, createVector2, inverseMatrix3 } from '@flighthq/geometry';
+import { cloneSampler, copySampler, createSampler, equalsSampler } from './sampler';
+// Allocates an independent Texture over the SAME image pixels: the ImageResource reference is
+// shared (clone the resource separately to upload into a second render state), while the Sampler
+// and the uv-transform vectors are deep-cloned so the two textures can be sampled independently.
+export function cloneTexture(source) {
+    return createEntity({
+        colorSpace: source.colorSpace,
+        image: source.image,
+        sampler: cloneSampler(source.sampler),
+        uvOffset: cloneVector2(source.uvOffset),
+        uvRotation: source.uvRotation,
+        uvScale: cloneVector2(source.uvScale),
+    });
+}
+// Copies every Texture field from source into out in place. The image reference is shared; the
+// Sampler and uv-transform vectors are copied into out's existing entities (their identities are
+// preserved). Safe when out aliases source.
+export function copyTexture(out, source) {
+    const colorSpace = source.colorSpace;
+    const image = source.image;
+    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.uvRotation = uvRotation;
+}
+// Builds a Texture: an unbound image slot (null), a default Sampler, 'srgb' color space (the
+// albedo default — data maps override to 'linear'), and an identity KHR_texture_transform
+// (zero offset, unit scale, no rotation). Pass TextureLike fields to override any of these.
+export function createTexture(opts) {
+    return createEntity({
+        colorSpace: opts?.colorSpace ?? 'srgb',
+        image: opts?.image ?? null,
+        sampler: opts?.sampler ? cloneSampler(opts.sampler) : createSampler(),
+        uvOffset: opts?.uvOffset ? cloneVector2(opts.uvOffset) : createVector2(0, 0),
+        uvRotation: opts?.uvRotation ?? 0,
+        uvScale: opts?.uvScale ? cloneVector2(opts.uvScale) : createVector2(1, 1),
+    });
+}
+// True when both textures describe identical state: same color space, same sampler state, the same
+// image reference, and the same uv-transform values. Returns false for null/undefined operands.
+export function equalsTexture(a, b) {
+    if (!a || !b)
+        return false;
+    if (a === b)
+        return true;
+    return (a.colorSpace === b.colorSpace &&
+        a.image === b.image &&
+        a.uvRotation === b.uvRotation &&
+        a.uvOffset.x === b.uvOffset.x &&
+        a.uvOffset.y === b.uvOffset.y &&
+        a.uvScale.x === b.uvScale.x &&
+        a.uvScale.y === b.uvScale.y &&
+        equalsSampler(a.sampler, b.sampler));
+}
+// Returns the pixel height of the texture's bound image, or -1 when no image is bound.
+export function getTextureHeight(texture) {
+    return texture.image !== null ? texture.image.height : -1;
+}
+// Composes the KHR_texture_transform fields and inverts the result, producing the matrix that maps
+// already-transformed uv coordinates back to the unit-square source uv. The forward transform is
+// affine, so the inverse always exists for a non-degenerate (non-zero) scale; a zero scale yields a
+// degenerate inverse (matching inverseMatrix3's affine-singular handling).
+// Out-param form — write into a pre-allocated Matrix3 to avoid per-call allocation.
+export function getTextureInverseUvMatrix(out, texture) {
+    getTextureUvMatrix(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:
+// 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).
+export function getTextureUvMatrix(out, texture) {
+    const r = texture.uvRotation;
+    const sx = texture.uvScale.x;
+    const sy = texture.uvScale.y;
+    const tx = texture.uvOffset.x;
+    const ty = texture.uvOffset.y;
+    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;
+}
+// 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 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) {
+    return texture.image !== null;
+}
+// Resets the KHR_texture_transform to identity in place: zero offset, no rotation, unit scale.
+// Leaves the image, color space, and sampler untouched.
+export function resetTextureUvTransform(texture) {
+    texture.uvOffset.x = 0;
+    texture.uvOffset.y = 0;
+    texture.uvRotation = 0;
+    texture.uvScale.x = 1;
+    texture.uvScale.y = 1;
+}
+// Binds (or clears, with null) the texture's image source in place. Does not touch sampling state
+// or the uv-transform.
+export function setTextureImage(texture, image) {
+    texture.image = image;
+}
+// Sets the uv offset (scroll/translation) in place. Equivalent to assigning texture.uvOffset
+// directly but provides a named mutator for the KHR_texture_transform model.
+export function setTextureUvOffset(texture, x, y) {
+    texture.uvOffset.x = x;
+    texture.uvOffset.y = y;
+}
+// Sets the uv rotation in radians in place.
+export function setTextureUvRotation(texture, radians) {
+    texture.uvRotation = radians;
+}
+// Sets the uv scale (tiling) in place.
+export function setTextureUvScale(texture, x, y) {
+    texture.uvScale.x = x;
+    texture.uvScale.y = y;
+}
+// Applies the texture's KHR_texture_transform (scale → rotate → translate) to a single (u, v)
+// coordinate, writing the transformed coordinate into out. Equivalent to multiplying [u, v, 1] by
+// getTextureUvMatrix's result, computed inline to avoid allocating a scratch matrix.
+// Out-param form — out may be any Vector2; no aliasing hazard (u and v are scalar inputs).
+export function transformTextureUv(out, texture, u, v) {
+    const r = texture.uvRotation;
+    const sx = texture.uvScale.x;
+    const sy = texture.uvScale.y;
+    const tx = texture.uvOffset.x;
+    const ty = texture.uvOffset.y;
+    const cosR = Math.cos(r);
+    const sinR = Math.sin(r);
+    out.x = sx * cosR * u - sy * sinR * v + tx;
+    out.y = sx * sinR * u + sy * cosR * v + ty;
+}
+//# sourceMappingURL=texture.js.map

package/dist/texture.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@flighthq/texture",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Textures and samplers: image-backed material texture bindings and cubemaps",
+  "sideEffects": false
+}

package/src/cubeTexture.test.ts

@@ -0,0 +1,174 @@
+import type { ImageResource } from '@flighthq/types';
+import { CubeFaceNegativeX, CubeFacePositiveX, CubeFacePositiveY } from '@flighthq/types';
+
+import {
+  cloneCubeTexture,
+  copyCubeTexture,
+  createCubeTexture,
+  equalsCubeTexture,
+  getCubeTextureFaceSize,
+  isCubeTextureComplete,
+  setCubeTextureFace,
+} from './cubeTexture';
+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];
+
+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],
+    });
+
+    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.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();
+  });
+});
+
+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],
+    });
+    const out = createCubeTexture();
+    const outSampler = out.sampler;
+
+    copyCubeTexture(out, source);
+
+    expect(out.colorSpace).toStrictEqual('linear');
+    expect(out.faces[0]).toBe(fakeFace);
+    expect(out.sampler).toBe(outSampler);
+    expect(equalsSampler(out.sampler, source.sampler)).toBe(true);
+  });
+
+  it('is safe when out aliases source', () => {
+    const cube = createCubeTexture({
+      colorSpace: 'linear',
+      faces: [fakeFace, null, null, null, null, null],
+    });
+
+    copyCubeTexture(cube, cube);
+
+    expect(cube.colorSpace).toStrictEqual('linear');
+    expect(cube.faces[0]).toBe(fakeFace);
+  });
+});
+
+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);
+    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 });
+
+    expect(cube.faces).not.toBe(faces);
+    expect(cube.faces[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 });
+
+    expect(equalsCubeTexture(a, b)).toBe(true);
+    expect(equalsCubeTexture(a, a)).toBe(true);
+  });
+
+  it('is false when colorSpace differs', () => {
+    const a = createCubeTexture({ colorSpace: 'linear' });
+    const b = createCubeTexture({ colorSpace: 'srgb' });
+
+    expect(equalsCubeTexture(a, b)).toBe(false);
+  });
+
+  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;
+
+    expect(equalsCubeTexture(a, b)).toBe(false);
+  });
+
+  it('is false when the sampler differs', () => {
+    const a = createCubeTexture();
+    const b = createCubeTexture({ sampler: createSampler({ mipmaps: false }) });
+
+    expect(equalsCubeTexture(a, b)).toBe(false);
+  });
+
+  it('is false for null or undefined operands', () => {
+    const a = createCubeTexture();
+
+    expect(equalsCubeTexture(a, null)).toBe(false);
+    expect(equalsCubeTexture(null, a)).toBe(false);
+    expect(equalsCubeTexture(undefined, undefined)).toBe(false);
+  });
+});
+
+describe('getCubeTextureFaceSize', () => {
+  it('returns the width of the first non-null face', () => {
+    const cube = createCubeTexture({ faces: [null, fakeFace, null, null, null, null] });
+
+    expect(getCubeTextureFaceSize(cube)).toStrictEqual(64);
+  });
+
+  it('returns -1 when all faces are null', () => {
+    const cube = createCubeTexture();
+
+    expect(getCubeTextureFaceSize(cube)).toStrictEqual(-1);
+  });
+});
+
+describe('isCubeTextureComplete', () => {
+  it('is false when any face is null', () => {
+    const cube = createCubeTexture({ faces: [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 });
+
+    expect(isCubeTextureComplete(cube)).toBe(true);
+  });
+});
+
+describe('setCubeTextureFace', () => {
+  it('binds a face using a named face constant', () => {
+    const cube = createCubeTexture();
+
+    setCubeTextureFace(cube, CubeFacePositiveX, fakeFace);
+    expect(cube.faces[CubeFacePositiveX]).toBe(fakeFace);
+    expect(cube.faces[CubeFaceNegativeX]).toBeNull();
+  });
+
+  it('unbinds a face when passed null', () => {
+    const cube = createCubeTexture({ faces: allFaces });
+
+    setCubeTextureFace(cube, CubeFacePositiveY, null);
+    expect(cube.faces[CubeFacePositiveY]).toBeNull();
+  });
+});

package/src/sampler.test.ts

@@ -0,0 +1,144 @@
+import {
+  cloneSampler,
+  copySampler,
+  createAnisotropicSampler,
+  createClampLinearSampler,
+  createPixelArtSampler,
+  createSampler,
+  createTilingSampler,
+  equalsSampler,
+} from './sampler';
+
+describe('cloneSampler', () => {
+  it('copies every field into an independent entity', () => {
+    const source = createSampler({
+      anisotropy: 8,
+      magFilter: 'nearest',
+      minFilter: 'nearest-mipmap-nearest',
+      mipmaps: false,
+      wrapU: 'repeat',
+      wrapV: 'mirror-repeat',
+    });
+
+    const copy = cloneSampler(source);
+
+    expect(copy).not.toBe(source);
+    expect(equalsSampler(copy, source)).toBe(true);
+
+    copy.anisotropy = 2;
+    expect(source.anisotropy).toStrictEqual(8);
+  });
+});
+
+describe('copySampler', () => {
+  it('writes every field from source into a distinct out', () => {
+    const source = createSampler({ anisotropy: 4, mipmaps: false, wrapU: 'repeat' });
+    const out = createSampler();
+
+    copySampler(out, source);
+
+    expect(out).not.toBe(source);
+    expect(equalsSampler(out, source)).toBe(true);
+  });
+
+  it('is safe when out aliases source', () => {
+    const source = createSampler({ anisotropy: 4, wrapV: 'mirror-repeat' });
+
+    copySampler(source, source);
+
+    expect(source.anisotropy).toStrictEqual(4);
+    expect(source.wrapV).toStrictEqual('mirror-repeat');
+  });
+});
+
+describe('createAnisotropicSampler', () => {
+  it('sets anisotropy to the supplied level, keeps other defaults', () => {
+    const sampler = createAnisotropicSampler(16);
+
+    expect(sampler.anisotropy).toStrictEqual(16);
+    expect(sampler.magFilter).toStrictEqual('linear');
+    expect(sampler.minFilter).toStrictEqual('linear-mipmap-linear');
+    expect(sampler.mipmaps).toBe(true);
+    expect(sampler.wrapU).toStrictEqual('clamp-to-edge');
+    expect(sampler.wrapV).toStrictEqual('clamp-to-edge');
+  });
+});
+
+describe('createClampLinearSampler', () => {
+  it('produces the default sampler state', () => {
+    const sampler = createClampLinearSampler();
+
+    expect(equalsSampler(sampler, createSampler())).toBe(true);
+  });
+});
+
+describe('createPixelArtSampler', () => {
+  it('uses nearest-neighbor filtering, clamp-to-edge, and no mipmaps', () => {
+    const sampler = createPixelArtSampler();
+
+    expect(sampler.magFilter).toStrictEqual('nearest');
+    expect(sampler.minFilter).toStrictEqual('nearest');
+    expect(sampler.mipmaps).toBe(false);
+    expect(sampler.wrapU).toStrictEqual('clamp-to-edge');
+    expect(sampler.wrapV).toStrictEqual('clamp-to-edge');
+  });
+});
+
+describe('createSampler', () => {
+  it('applies the default sampling state', () => {
+    const sampler = createSampler();
+
+    expect(sampler.anisotropy).toStrictEqual(1);
+    expect(sampler.magFilter).toStrictEqual('linear');
+    expect(sampler.minFilter).toStrictEqual('linear-mipmap-linear');
+    expect(sampler.mipmaps).toBe(true);
+    expect(sampler.wrapU).toStrictEqual('clamp-to-edge');
+    expect(sampler.wrapV).toStrictEqual('clamp-to-edge');
+  });
+
+  it('overrides only the supplied fields', () => {
+    const sampler = createSampler({ anisotropy: 16, wrapU: 'repeat' });
+
+    expect(sampler.anisotropy).toStrictEqual(16);
+    expect(sampler.wrapU).toStrictEqual('repeat');
+    expect(sampler.wrapV).toStrictEqual('clamp-to-edge');
+    expect(sampler.mipmaps).toBe(true);
+  });
+});
+
+describe('createTilingSampler', () => {
+  it('uses repeat wrap on both axes with trilinear filtering', () => {
+    const sampler = createTilingSampler();
+
+    expect(sampler.wrapU).toStrictEqual('repeat');
+    expect(sampler.wrapV).toStrictEqual('repeat');
+    expect(sampler.magFilter).toStrictEqual('linear');
+    expect(sampler.minFilter).toStrictEqual('linear-mipmap-linear');
+    expect(sampler.mipmaps).toBe(true);
+  });
+});
+
+describe('equalsSampler', () => {
+  it('is true for identical state and the same reference', () => {
+    const a = createSampler({ anisotropy: 4 });
+    const b = createSampler({ anisotropy: 4 });
+
+    expect(equalsSampler(a, b)).toBe(true);
+    expect(equalsSampler(a, a)).toBe(true);
+  });
+
+  it('is false when any field differs', () => {
+    const a = createSampler();
+    const b = createSampler({ mipmaps: false });
+
+    expect(equalsSampler(a, b)).toBe(false);
+  });
+
+  it('is false for null or undefined operands', () => {
+    const a = createSampler();
+
+    expect(equalsSampler(a, null)).toBe(false);
+    expect(equalsSampler(null, a)).toBe(false);
+    expect(equalsSampler(undefined, undefined)).toBe(false);
+  });
+});

package/src/texture.test.ts

@@ -0,0 +1,410 @@
+import { createMatrix3, createVector2, inverseMatrix3 } from '@flighthq/geometry';
+import type { ImageResource } from '@flighthq/types';
+
+import { createSampler, equalsSampler } from './sampler';
+import {
+  cloneTexture,
+  copyTexture,
+  createTexture,
+  equalsTexture,
+  getTextureHeight,
+  getTextureInverseUvMatrix,
+  getTextureUvMatrix,
+  getTextureWidth,
+  isTextureReady,
+  resetTextureUvTransform,
+  setTextureImage,
+  setTextureUvOffset,
+  setTextureUvRotation,
+  setTextureUvScale,
+  transformTextureUv,
+} from './texture';
+
+const fakeImage = { width: 32, height: 64 } as ImageResource;
+
+describe('cloneTexture', () => {
+  it('shares the image but deep-clones the sampler and uv vectors', () => {
+    const source = createTexture({
+      colorSpace: 'linear',
+      image: fakeImage,
+      uvRotation: 0.5,
+    });
+    source.uvOffset.x = 0.25;
+    source.uvScale.y = 3;
+
+    const copy = cloneTexture(source);
+
+    expect(copy).not.toBe(source);
+    expect(copy.image).toBe(fakeImage);
+    expect(copy.colorSpace).toStrictEqual('linear');
+    expect(copy.uvRotation).toStrictEqual(0.5);
+    expect(copy.sampler).not.toBe(source.sampler);
+    expect(equalsSampler(copy.sampler, source.sampler)).toBe(true);
+    expect(copy.uvOffset).not.toBe(source.uvOffset);
+    expect(copy.uvOffset.x).toStrictEqual(0.25);
+    expect(copy.uvScale.y).toStrictEqual(3);
+
+    copy.uvOffset.x = 0.9;
+    expect(source.uvOffset.x).toStrictEqual(0.25);
+  });
+});
+
+describe('copyTexture', () => {
+  it('writes every field from source into a distinct out, preserving out entity identities', () => {
+    const source = createTexture({ colorSpace: 'linear', image: fakeImage, uvRotation: 1 });
+    source.uvScale.x = 4;
+    const out = createTexture();
+    const outSampler = out.sampler;
+    const outOffset = out.uvOffset;
+
+    copyTexture(out, source);
+
+    expect(out.image).toBe(fakeImage);
+    expect(out.colorSpace).toStrictEqual('linear');
+    expect(out.uvRotation).toStrictEqual(1);
+    expect(out.uvScale.x).toStrictEqual(4);
+    expect(out.sampler).toBe(outSampler);
+    expect(out.uvOffset).toBe(outOffset);
+  });
+
+  it('is safe when out aliases source', () => {
+    const source = createTexture({ colorSpace: 'linear', image: fakeImage, uvRotation: 2 });
+    source.uvScale.x = 7;
+
+    copyTexture(source, source);
+
+    expect(source.colorSpace).toStrictEqual('linear');
+    expect(source.image).toBe(fakeImage);
+    expect(source.uvRotation).toStrictEqual(2);
+    expect(source.uvScale.x).toStrictEqual(7);
+  });
+});
+
+describe('createTexture', () => {
+  it('applies the default unbound, srgb, identity-transform state', () => {
+    const texture = createTexture();
+
+    expect(texture.image).toBeNull();
+    expect(texture.colorSpace).toStrictEqual('srgb');
+    expect(texture.uvRotation).toStrictEqual(0);
+    expect(texture.uvOffset.x).toStrictEqual(0);
+    expect(texture.uvOffset.y).toStrictEqual(0);
+    expect(texture.uvScale.x).toStrictEqual(1);
+    expect(texture.uvScale.y).toStrictEqual(1);
+    expect(equalsSampler(texture.sampler, createSampler())).toBe(true);
+  });
+
+  it('clones supplied sampler and uv vectors rather than aliasing them', () => {
+    const sampler = createSampler({ anisotropy: 8 });
+    const texture = createTexture({ sampler });
+
+    expect(texture.sampler).not.toBe(sampler);
+    expect(texture.sampler.anisotropy).toStrictEqual(8);
+  });
+});
+
+describe('equalsTexture', () => {
+  it('is true for textures with identical state and same image reference', () => {
+    const a = createTexture({ image: fakeImage, colorSpace: 'linear' });
+    const b = createTexture({ image: fakeImage, colorSpace: 'linear' });
+
+    expect(equalsTexture(a, b)).toBe(true);
+    expect(equalsTexture(a, a)).toBe(true);
+  });
+
+  it('is false when the image reference differs', () => {
+    const other = { width: 4, height: 4 } as ImageResource;
+    const a = createTexture({ image: fakeImage });
+    const b = createTexture({ image: other });
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false when colorSpace differs', () => {
+    const a = createTexture({ colorSpace: 'linear' });
+    const b = createTexture({ colorSpace: 'srgb' });
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false when uvRotation differs', () => {
+    const a = createTexture({ uvRotation: 0.5 });
+    const b = createTexture({ uvRotation: 0 });
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false when uvOffset differs', () => {
+    const a = createTexture();
+    const b = createTexture();
+    b.uvOffset.x = 0.5;
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false when uvScale differs', () => {
+    const a = createTexture();
+    const b = createTexture();
+    b.uvScale.y = 2;
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false when the sampler differs', () => {
+    const a = createTexture();
+    const b = createTexture({ sampler: createSampler({ mipmaps: false }) });
+
+    expect(equalsTexture(a, b)).toBe(false);
+  });
+
+  it('is false for null or undefined operands', () => {
+    const a = createTexture();
+
+    expect(equalsTexture(a, null)).toBe(false);
+    expect(equalsTexture(null, a)).toBe(false);
+    expect(equalsTexture(undefined, undefined)).toBe(false);
+  });
+});
+
+describe('getTextureHeight', () => {
+  it('returns the image height when an image is bound', () => {
+    const texture = createTexture({ image: fakeImage });
+
+    expect(getTextureHeight(texture)).toStrictEqual(64);
+  });
+
+  it('returns -1 when no image is bound', () => {
+    const texture = createTexture();
+
+    expect(getTextureHeight(texture)).toStrictEqual(-1);
+  });
+});
+
+describe('getTextureInverseUvMatrix', () => {
+  it('produces the identity matrix for the default uv transform', () => {
+    const texture = createTexture();
+    const out = createMatrix3();
+
+    getTextureInverseUvMatrix(out, texture);
+
+    expect(out.m[0]).toBeCloseTo(1);
+    expect(out.m[1]).toBeCloseTo(0);
+    expect(out.m[2]).toBeCloseTo(0);
+    expect(out.m[3]).toBeCloseTo(0);
+    expect(out.m[4]).toBeCloseTo(1);
+    expect(out.m[5]).toBeCloseTo(0);
+    expect(out.m[8]).toBeCloseTo(1);
+  });
+
+  it('equals inverting the composed forward uv matrix', () => {
+    const texture = createTexture({ uvRotation: Math.PI / 6 });
+    setTextureUvScale(texture, 2, 3);
+    setTextureUvOffset(texture, 0.1, 0.2);
+
+    // The documented contract: compose getTextureUvMatrix, then inverse it via geometry.
+    const expected = createMatrix3();
+    getTextureUvMatrix(expected, texture);
+    inverseMatrix3(expected, expected);
+
+    const out = createMatrix3();
+    getTextureInverseUvMatrix(out, texture);
+
+    for (let k = 0; k < 9; k++) {
+      expect(out.m[k]).toBeCloseTo(expected.m[k]);
+    }
+  });
+});
+
+describe('getTextureUvMatrix', () => {
+  it('produces the identity matrix for the default uv transform', () => {
+    const texture = createTexture();
+    const out = createMatrix3();
+
+    getTextureUvMatrix(out, texture);
+
+    // Row-major: 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);
+    expect(out.m[3]).toBeCloseTo(0);
+    expect(out.m[4]).toBeCloseTo(1);
+    expect(out.m[5]).toBeCloseTo(0);
+    expect(out.m[6]).toBeCloseTo(0);
+    expect(out.m[7]).toBeCloseTo(0);
+    expect(out.m[8]).toBeCloseTo(1);
+  });
+
+  it('encodes offset in the translation column', () => {
+    const texture = createTexture();
+    setTextureUvOffset(texture, 0.25, 0.75);
+    const out = createMatrix3();
+
+    getTextureUvMatrix(out, texture);
+
+    expect(out.m[2]).toBeCloseTo(0.25); // tx
+    expect(out.m[5]).toBeCloseTo(0.75); // ty
+  });
+
+  it('encodes scale in the diagonal', () => {
+    const texture = createTexture();
+    setTextureUvScale(texture, 2, 3);
+    const out = createMatrix3();
+
+    getTextureUvMatrix(out, texture);
+
+    expect(out.m[0]).toBeCloseTo(2); // sx*cos(0) = sx
+    expect(out.m[4]).toBeCloseTo(3); // sy*cos(0) = sy
+  });
+
+  it('matches KHR_texture_transform formula for a rotated, scaled, offset texture', () => {
+    const r = Math.PI / 4;
+    const texture = createTexture({ uvRotation: r });
+    setTextureUvScale(texture, 2, 2);
+    setTextureUvOffset(texture, 0.1, 0.2);
+    const out = createMatrix3();
+
+    getTextureUvMatrix(out, texture);
+
+    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
+  });
+});
+
+describe('getTextureWidth', () => {
+  it('returns the image width when an image is bound', () => {
+    const texture = createTexture({ image: fakeImage });
+
+    expect(getTextureWidth(texture)).toStrictEqual(32);
+  });
+
+  it('returns -1 when no image is bound', () => {
+    const texture = createTexture();
+
+    expect(getTextureWidth(texture)).toStrictEqual(-1);
+  });
+});
+
+describe('isTextureReady', () => {
+  it('is false with a null image and true once bound', () => {
+    const texture = createTexture();
+
+    expect(isTextureReady(texture)).toBe(false);
+
+    texture.image = fakeImage;
+    expect(isTextureReady(texture)).toBe(true);
+  });
+});
+
+describe('resetTextureUvTransform', () => {
+  it('restores the identity transform while leaving image, color space, and sampler untouched', () => {
+    const texture = createTexture({ colorSpace: 'linear', image: fakeImage });
+    const sampler = texture.sampler;
+    setTextureUvOffset(texture, 0.4, 0.6);
+    setTextureUvRotation(texture, Math.PI);
+    setTextureUvScale(texture, 5, 7);
+
+    resetTextureUvTransform(texture);
+
+    expect(texture.uvOffset.x).toStrictEqual(0);
+    expect(texture.uvOffset.y).toStrictEqual(0);
+    expect(texture.uvRotation).toStrictEqual(0);
+    expect(texture.uvScale.x).toStrictEqual(1);
+    expect(texture.uvScale.y).toStrictEqual(1);
+    expect(texture.colorSpace).toStrictEqual('linear');
+    expect(texture.image).toBe(fakeImage);
+    expect(texture.sampler).toBe(sampler);
+  });
+});
+
+describe('setTextureImage', () => {
+  it('binds and clears the image in place', () => {
+    const texture = createTexture();
+
+    setTextureImage(texture, fakeImage);
+    expect(texture.image).toBe(fakeImage);
+
+    setTextureImage(texture, null);
+    expect(texture.image).toBeNull();
+  });
+});
+
+describe('setTextureUvOffset', () => {
+  it('updates the uvOffset in place', () => {
+    const texture = createTexture();
+
+    setTextureUvOffset(texture, 0.3, 0.7);
+
+    expect(texture.uvOffset.x).toBeCloseTo(0.3);
+    expect(texture.uvOffset.y).toBeCloseTo(0.7);
+  });
+});
+
+describe('setTextureUvRotation', () => {
+  it('updates uvRotation in place', () => {
+    const texture = createTexture();
+
+    setTextureUvRotation(texture, Math.PI);
+
+    expect(texture.uvRotation).toBeCloseTo(Math.PI);
+  });
+});
+
+describe('setTextureUvScale', () => {
+  it('updates the uvScale in place', () => {
+    const texture = createTexture();
+
+    setTextureUvScale(texture, 4, 8);
+
+    expect(texture.uvScale.x).toBeCloseTo(4);
+    expect(texture.uvScale.y).toBeCloseTo(8);
+  });
+});
+
+describe('transformTextureUv', () => {
+  it('leaves a coordinate unchanged under the identity transform', () => {
+    const texture = createTexture();
+    const out = createVector2(0, 0);
+
+    transformTextureUv(out, texture, 0.25, 0.75);
+
+    expect(out.x).toBeCloseTo(0.25);
+    expect(out.y).toBeCloseTo(0.75);
+  });
+
+  it('applies scale then offset', () => {
+    const texture = createTexture();
+    setTextureUvScale(texture, 2, 3);
+    setTextureUvOffset(texture, 0.1, 0.2);
+    const out = createVector2(0, 0);
+
+    transformTextureUv(out, texture, 0.5, 0.5);
+
+    expect(out.x).toBeCloseTo(2 * 0.5 + 0.1);
+    expect(out.y).toBeCloseTo(3 * 0.5 + 0.2);
+  });
+
+  it('matches multiplying the coordinate by getTextureUvMatrix', () => {
+    const texture = createTexture({ uvRotation: Math.PI / 3 });
+    setTextureUvScale(texture, 1.5, 2.5);
+    setTextureUvOffset(texture, 0.2, 0.4);
+    const matrix = createMatrix3();
+    getTextureUvMatrix(matrix, texture);
+    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];
+    const out = createVector2(0, 0);
+
+    transformTextureUv(out, texture, u, v);
+
+    expect(out.x).toBeCloseTo(expectedX);
+    expect(out.y).toBeCloseTo(expectedY);
+  });
+});