@flighthq/image 0.5.1-next.1069.554a2ac → 0.5.1-next.1197.6a425ce

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/image`. The `@flight
 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/image@0.5.1-next.1069.554a2ac](https://github.com/flighthq/flight/tree/554a2acc3fecf189b89b0729308ff890a15c21cc/packages/image)
-- [License](https://github.com/flighthq/flight/blob/554a2acc3fecf189b89b0729308ff890a15c21cc/LICENSE.md)
+- [Source for @flighthq/image@0.5.1-next.1197.6a425ce](https://github.com/flighthq/flight/tree/6a425ce64e6d501dac8218fe625e73d58da88639/packages/image)
+- [License](https://github.com/flighthq/flight/blob/6a425ce64e6d501dac8218fe625e73d58da88639/LICENSE.md)

package/dist/contract.d.ts

@@ -1,7 +1,8 @@
 export * from './imageResource';
 export * from './imageResourceFrom';
+export * from './imageSourceDimensions';
+export * from './imageTestHelper';
 export * from './imageResourceReference';
 export { initializeCompressedImageResource } from './imageResource';
 export { initializeEmbeddedImageResourceReference, initializeExternalImageResourceReference, } from './imageResourceReference';
-export { initializeImageResourceFromCanvas, initializeImageResourceFromImageBitmap, initializeImageResourceFromImageElement, } from './imageResourceFrom';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,EACjC,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,0BAA0B,CAAC"}

package/dist/contract.js

@@ -1,7 +1,8 @@
 export * from './imageResource';
 export * from './imageResourceFrom';
+export * from './imageSourceDimensions';
+export * from './imageTestHelper';
 export * from './imageResourceReference';
 export { initializeCompressedImageResource } from './imageResource';
 export { initializeEmbeddedImageResourceReference, initializeExternalImageResourceReference, } from './imageResourceReference';
-export { initializeImageResourceFromCanvas, initializeImageResourceFromImageBitmap, initializeImageResourceFromImageElement, } from './imageResourceFrom';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,EACjC,sCAAsC,EACtC,uCAAuC,GACxC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,wCAAwC,EACxC,wCAAwC,GACzC,MAAM,0BAA0B,CAAC"}

package/dist/imageResource.d.ts

@@ -1,7 +1,7 @@
-import type { CompressedImageData, CompressedImageResource, EntityConstruction, ImageResource } from '@flighthq/types/contract';
+import type { CompressedImageData, CompressedImageResource, EntityConstruction, HostImageSource, ImageResource } from '@flighthq/types/contract';
 export declare function cloneImageResource(resource: Readonly<ImageResource>): ImageResource;
 export declare function createCompressedImageResource(compressed: Readonly<CompressedImageData>): CompressedImageResource;
-export declare function createImageResource(image: CanvasImageSource): ImageResource;
+export declare function createImageResource(image: HostImageSource): ImageResource;
 export declare function initializeCompressedImageResource(out: EntityConstruction<CompressedImageResource>, compressed: Readonly<CompressedImageData>): void;
 export declare function invalidateImageResource(resource: ImageResource): void;
 export declare function isImageResourceEmpty(resource: Readonly<ImageResource>): boolean;

package/dist/imageResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageResource.d.ts","sourceRoot":"","sources":["../src/imageResource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAUnF;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,uBAAuB,CAIhH;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAW3E;AAID,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,EAChD,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACxC,IAAI,CAQN;AAGD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGrE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAE/E"}
+{"version":3,"file":"imageResource.d.ts","sourceRoot":"","sources":["../src/imageResource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAElB,eAAe,EACf,aAAa,EACd,MAAM,0BAA0B,CAAC;AAOlC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAUnF;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,uBAAuB,CAIhH;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,CAWzE;AAID,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,EAChD,UAAU,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACxC,IAAI,CAQN;AAGD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGrE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAE/E"}

package/dist/imageResource.js

@@ -1,5 +1,6 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { CompressedImageTextureSourceKind, ImageTextureSourceKind } from '@flighthq/types/contract';
+import { getHostImageSourceDimensions } from './imageSourceDimensions';
 // Allocates a new resource identity over the same borrowed host image. The host handle is shared by
 // reference; the clone owns an independent version counter for renderer cache invalidation.
 export function cloneImageResource(resource) {
@@ -18,6 +19,9 @@ export function createCompressedImageResource(compressed) {
     initializeCompressedImageResource(out, compressed);
     return finishEntity(out);
 }
+// Wraps a borrowed host handle whose size is read through the registered host dimension resolver. A
+// caller that already holds the size — a host factory building from its own canvas or decoded bitmap —
+// sets width and height directly instead and needs no resolver.
 export function createImageResource(image) {
     const resource = allocateEntity();
     resource.alphaType = DECODED_ALPHA_TYPE;
@@ -49,21 +53,19 @@ export function invalidateImageResource(resource) {
 export function isImageResourceEmpty(resource) {
     return resource.width <= 0 || resource.height <= 0;
 }
-// Reads pixel dimensions from the current host element. Video sources carry their size on
-// videoWidth/videoHeight; every other CanvasImageSource exposes width/height directly.
+// Re-reads pixel dimensions from the borrowed handle through the host resolver. With no resolver
+// registered the resource keeps the dimensions it already carries, which is what a host factory that
+// measured its own source at construction wants.
 function updateImageResourceSize(resource) {
-    const element = resource.source;
-    if (element === null)
+    const source = resource.source;
+    if (source === null)
         return;
-    if (element instanceof HTMLVideoElement) {
-        resource.width = element.videoWidth;
-        resource.height = element.videoHeight;
-    }
-    else {
-        const sized = element;
-        resource.width = sized.width;
-        resource.height = sized.height;
-    }
+    _measured.height = resource.height;
+    _measured.width = resource.width;
+    if (!getHostImageSourceDimensions(source, _measured))
+        return;
+    resource.height = _measured.height;
+    resource.width = _measured.width;
 }
 // What a HOST decode yields, and the only honest default for a source whose pixels we never touch.
 // Every browser image/canvas/ImageBitmap decode is straight-alpha sRGB, so declaring it is a statement
@@ -72,4 +74,6 @@ function updateImageResourceSize(resource) {
 // `alphaType !== 'premultiplied'` guard starts protecting ImageResource the way it already protects Bitmap.
 const DECODED_ALPHA_TYPE = 'straight';
 const DECODED_GAMUT = 'srgb';
+// Scratch pair reused by the size re-read; measuring a resource never allocates.
+const _measured = { height: 0, width: 0 };
 //# sourceMappingURL=imageResource.js.map

package/dist/imageResource.js.map

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

package/dist/imageResourceFrom.d.ts

@@ -1,14 +1,8 @@
-import type { Bitmap, EntityConstruction, HasGraphicsImage, ImageResource } from '@flighthq/types/contract';
-export declare function createImageResourceFromBitmap(host: Readonly<HasGraphicsImage>, bitmap: Readonly<Bitmap>): ImageResource | null;
-export declare function createImageResourceFromCanvas(canvas: HTMLCanvasElement): ImageResource;
-export declare function createImageResourceFromImageBitmap(bitmap: ImageBitmap): ImageResource;
-export declare function createImageResourceFromImageElement(img: HTMLImageElement): ImageResource;
-export declare function initializeImageResourceFromCanvas(out: EntityConstruction<ImageResource>, canvas: HTMLCanvasElement): void;
-export declare function initializeImageResourceFromImageBitmap(out: EntityConstruction<ImageResource>, bitmap: ImageBitmap): void;
-export declare function initializeImageResourceFromImageElement(out: EntityConstruction<ImageResource>, img: HTMLImageElement): void;
+import type { Bitmap, HostImageProvider, ImageResource } from '@flighthq/types/contract';
+export declare function createImageResourceFromBitmap(hostImage: Readonly<HostImageProvider>, bitmap: Readonly<Bitmap>): ImageResource | null;
 export declare function isImageUrlSameOrigin(url: string): boolean;
-export declare function loadImageResourceFromBase64(host: Readonly<HasGraphicsImage>, base64: string, mimeType: string, signal?: AbortSignal): Promise<ImageResource>;
-export declare function loadImageResourceFromBlob(host: Readonly<HasGraphicsImage>, blob: Blob, signal?: AbortSignal): Promise<ImageResource>;
-export declare function loadImageResourceFromBytes(host: Readonly<HasGraphicsImage>, bytes: Uint8Array, mimeType?: string, signal?: AbortSignal): Promise<ImageResource>;
-export declare function loadImageResourceFromUrl(host: Readonly<HasGraphicsImage>, url: string, crossOrigin?: 'anonymous' | 'use-credentials', signal?: AbortSignal): Promise<ImageResource>;
+export declare function loadImageResourceFromBase64(hostImage: Readonly<HostImageProvider>, base64: string, mimeType: string, signal?: AbortSignal): Promise<ImageResource>;
+export declare function loadImageResourceFromBlob(hostImage: Readonly<HostImageProvider>, blob: Blob, signal?: AbortSignal): Promise<ImageResource>;
+export declare function loadImageResourceFromBytes(hostImage: Readonly<HostImageProvider>, bytes: Uint8Array, mimeType?: string, signal?: AbortSignal): Promise<ImageResource>;
+export declare function loadImageResourceFromUrl(hostImage: Readonly<HostImageProvider>, url: string, crossOrigin?: 'anonymous' | 'use-credentials', signal?: AbortSignal): Promise<ImageResource>;
 //# sourceMappingURL=imageResourceFrom.d.ts.map

package/dist/imageResourceFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageResourceFrom.d.ts","sourceRoot":"","sources":["../src/imageResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG5G,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GACvB,aAAa,GAAG,IAAI,CAItB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAItF;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAIrF;AAED,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAIxF;AAED,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,kBAAkB,CAAC,aAAa,CAAC,EACtC,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAQN;AAED,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,kBAAkB,CAAC,aAAa,CAAC,EACtC,MAAM,EAAE,WAAW,GAClB,IAAI,CAQN;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,kBAAkB,CAAC,aAAa,CAAC,EACtC,GAAG,EAAE,gBAAgB,GACpB,IAAI,CAQN;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,EAC7C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAExB"}
+{"version":3,"file":"imageResourceFrom.d.ts","sourceRoot":"","sources":["../src/imageResourceFrom.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzF,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GACvB,aAAa,GAAG,IAAI,CAItB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACtC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,EAC7C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/imageResourceFrom.js

@@ -1,54 +1,10 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import { detectImageMimeType } from '@flighthq/image-codec/contract';
-import { ImageTextureSourceKind } from '@flighthq/types/contract';
-export function createImageResourceFromBitmap(host, bitmap) {
-    const backend = host.graphics.image;
+export function createImageResourceFromBitmap(hostImage, bitmap) {
+    const backend = hostImage;
     if (backend.createImageFromBitmap === undefined)
         return null;
     return backend.createImageFromBitmap(bitmap);
 }
-export function createImageResourceFromCanvas(canvas) {
-    const out = allocateEntity();
-    initializeImageResourceFromCanvas(out, canvas);
-    return finishEntity(out);
-}
-export function createImageResourceFromImageBitmap(bitmap) {
-    const out = allocateEntity();
-    initializeImageResourceFromImageBitmap(out, bitmap);
-    return finishEntity(out);
-}
-export function createImageResourceFromImageElement(img) {
-    const out = allocateEntity();
-    initializeImageResourceFromImageElement(out, img);
-    return finishEntity(out);
-}
-export function initializeImageResourceFromCanvas(out, canvas) {
-    out.alphaType = DECODED_ALPHA_TYPE;
-    out.gamut = DECODED_GAMUT;
-    out.height = canvas.height;
-    out.kind = ImageTextureSourceKind;
-    out.source = canvas;
-    out.version = 0;
-    out.width = canvas.width;
-}
-export function initializeImageResourceFromImageBitmap(out, bitmap) {
-    out.alphaType = DECODED_ALPHA_TYPE;
-    out.gamut = DECODED_GAMUT;
-    out.height = bitmap.height;
-    out.kind = ImageTextureSourceKind;
-    out.source = bitmap;
-    out.version = 0;
-    out.width = bitmap.width;
-}
-export function initializeImageResourceFromImageElement(out, img) {
-    out.alphaType = DECODED_ALPHA_TYPE;
-    out.gamut = DECODED_GAMUT;
-    out.height = img.height;
-    out.kind = ImageTextureSourceKind;
-    out.source = img;
-    out.version = 0;
-    out.width = img.width;
-}
 export function isImageUrlSameOrigin(url) {
     if (url.startsWith('data:') || url.startsWith('blob:'))
         return true;
@@ -59,29 +15,27 @@ export function isImageUrlSameOrigin(url) {
         return true;
     }
 }
-export async function loadImageResourceFromBase64(host, base64, mimeType, signal) {
-    return loadImageResourceFromUrl(host, `data:${mimeType};base64,${base64}`, undefined, signal);
+export async function loadImageResourceFromBase64(hostImage, base64, mimeType, signal) {
+    return loadImageResourceFromUrl(hostImage, `data:${mimeType};base64,${base64}`, undefined, signal);
 }
-export async function loadImageResourceFromBlob(host, blob, signal) {
+export async function loadImageResourceFromBlob(hostImage, blob, signal) {
     const url = URL.createObjectURL(blob);
     try {
-        return await loadImageResourceFromUrl(host, url, undefined, signal);
+        return await loadImageResourceFromUrl(hostImage, url, undefined, signal);
     }
     finally {
         URL.revokeObjectURL(url);
     }
 }
-export async function loadImageResourceFromBytes(host, bytes, mimeType, signal) {
+export async function loadImageResourceFromBytes(hostImage, bytes, mimeType, signal) {
     const type = mimeType ?? detectImageMimeType(bytes);
     if (type === null) {
         throw new Error('Unable to determine image type from bytes');
     }
     const buf = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
-    return loadImageResourceFromBlob(host, new Blob([buf], { type }), signal);
+    return loadImageResourceFromBlob(hostImage, new Blob([buf], { type }), signal);
 }
-export async function loadImageResourceFromUrl(host, url, crossOrigin, signal) {
-    return host.graphics.image.loadImageFromUrl(url, crossOrigin, signal);
+export async function loadImageResourceFromUrl(hostImage, url, crossOrigin, signal) {
+    return hostImage.loadImageFromUrl(url, crossOrigin, signal);
 }
-const DECODED_ALPHA_TYPE = 'straight';
-const DECODED_GAMUT = 'srgb';
 //# sourceMappingURL=imageResourceFrom.js.map

package/dist/imageResourceFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageResourceFrom.js","sourceRoot":"","sources":["../src/imageResourceFrom.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"imageResourceFrom.js","sourceRoot":"","sources":["../src/imageResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,MAAM,UAAU,6BAA6B,CAC3C,SAAsC,EACtC,MAAwB;IAExB,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1B,IAAI,OAAO,CAAC,qBAAqB,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,SAAsC,EACtC,MAAc,EACd,QAAgB,EAChB,MAAoB;IAEpB,OAAO,wBAAwB,CAAC,SAAS,EAAE,QAAQ,QAAQ,WAAW,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,SAAsC,EACtC,IAAU,EACV,MAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,MAAM,wBAAwB,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,SAAsC,EACtC,KAAiB,EACjB,QAAiB,EACjB,MAAoB;IAEpB,MAAM,IAAI,GAAG,QAAQ,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,GAAG,GAAI,KAAK,CAAC,MAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IACvG,OAAO,yBAAyB,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAsC,EACtC,GAAW,EACX,WAA6C,EAC7C,MAAoB;IAEpB,OAAO,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/dist/imageResourceReference.d.ts

@@ -1,12 +1,11 @@
-import type { AlphaType, EmbeddedImageResourceReference, ExternalImageResourceReference, ImageResourceFailure, ImageResourceFetch, ImageResourceReference, ImageResourceReferenceResolutionExplanation, TextureSource, EntityConstruction } from '@flighthq/types/contract';
+import type { AlphaType, EmbeddedImageResourceReference, ExternalImageResourceReference, ImageResourceFailure, ImageResourceFetch, ImageResourceReference, ImageBitmapCompositionResolver, ImageResourceReferenceResolutionExplanation, TextureSource, EntityConstruction } from '@flighthq/types/contract';
 export declare function createEmbeddedImageResourceReference(bytes: Uint8Array, mimeType?: string | null, alphaType?: AlphaType): EmbeddedImageResourceReference;
 export declare function createExternalImageResourceReference(uri: string, basePath?: string | null): ExternalImageResourceReference;
 export declare function createImageResourceFailure(cause: unknown): ImageResourceFailure;
-export declare function disableImageBitmapComposition(): void;
-export declare function enableImageBitmapComposition(): void;
 export declare function explainImageResourceReferenceResolution(ref: Readonly<ImageResourceReference>): ImageResourceReferenceResolutionExplanation;
 export declare function initializeEmbeddedImageResourceReference(out: EntityConstruction<EmbeddedImageResourceReference>, bytes: Uint8Array, mimeType?: string | null, alphaType?: AlphaType): void;
 export declare function initializeExternalImageResourceReference(out: EntityConstruction<ExternalImageResourceReference>, uri: string, basePath?: string | null): void;
+export declare function registerImageBitmapCompositionResolver(resolver: ImageBitmapCompositionResolver | null): void;
 export declare function resetFailedImageResourceReference(ref: ImageResourceReference): boolean;
 export declare function resolveImageResourceReference(ref: ImageResourceReference, fetch: ImageResourceFetch, signal: AbortSignal): Promise<TextureSource | null>;
 //# sourceMappingURL=imageResourceReference.d.ts.map

package/dist/imageResourceReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageResourceReference.d.ts","sourceRoot":"","sources":["../src/imageResourceReference.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,SAAS,EAET,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,2CAA2C,EAC3C,aAAa,EACb,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,SAAsB,GAChC,8BAA8B,CAIhC;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,8BAA8B,CAIhC;AAiCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAa/E;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAKD,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AA0BD,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACpC,2CAA2C,CAO7C;AAKD,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,kBAAkB,CAAC,8BAA8B,CAAC,EACvD,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,SAAsB,GAChC,IAAI,CAQN;AAED,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,kBAAkB,CAAC,8BAA8B,CAAC,EACvD,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,IAAI,CAQN;AAID,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAKtF;AAUD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkC/B"}
+{"version":3,"file":"imageResourceReference.d.ts","sourceRoot":"","sources":["../src/imageResourceReference.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EAET,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,2CAA2C,EAC3C,aAAa,EACb,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,SAAsB,GAChC,8BAA8B,CAIhC;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,8BAA8B,CAIhC;AAiCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAa/E;AAID,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACpC,2CAA2C,CAO7C;AAOD,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,kBAAkB,CAAC,8BAA8B,CAAC,EACvD,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,SAAsB,GAChC,IAAI,CAQN;AAED,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,kBAAkB,CAAC,8BAA8B,CAAC,EACvD,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,IAAI,CAQN;AAMD,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,8BAA8B,GAAG,IAAI,GAAG,IAAI,CAE5G;AAID,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAKtF;AAUD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkC/B"}

package/dist/imageResourceReference.js

@@ -1,5 +1,5 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import { decodeImage, decodeImagePremultiplied, explainImageDecodeFailure, getImageBitmapComposer, } from '@flighthq/image-codec/contract';
+import { decodeImage, decodeImagePremultiplied, explainImageDecodeFailure } from '@flighthq/image-codec/contract';
 import { BitmapTextureSourceKind, ImageResourceFailureKind, ImageResourceReferenceKind, ResourceResolutionState, } from '@flighthq/types/contract';
 export function createEmbeddedImageResourceReference(bytes, mimeType = null, alphaType = 'straight') {
     const out = allocateEntity();
@@ -53,28 +53,6 @@ export function createImageResourceFailure(cause) {
     out.name = null;
     return finishEntity(out);
 }
-export function disableImageBitmapComposition() {
-    _resolveImageBitmapComposition = null;
-}
-// Installs the optional decoded-pixel join without making an ordinary embedded-image consumer retain
-// its registry lookup or straight-decode branch. A format package calls this beside its composer
-// registrations; until then the nullable hook leaves the original hot path byte-for-byte tree-shakable.
-export function enableImageBitmapComposition() {
-    _resolveImageBitmapComposition = resolveImageBitmapComposition;
-}
-async function resolveImageBitmapComposition(ref, signal) {
-    signal.throwIfAborted();
-    const composition = ref.bitmapComposition;
-    const composer = getImageBitmapComposer(composition.kind);
-    if (composer === null)
-        return null;
-    // A composer always receives straight decoded pixels. It may also own a raw raster with no MIME
-    // decoder, in which case decoded is null and its plain payload is the complete input.
-    const decoded = await decodeImage(ref.bytes, ref.mimeType ?? undefined);
-    signal.throwIfAborted();
-    return composer(decoded, composition.payload);
-}
-let _resolveImageBitmapComposition = null;
 // Returns a detached plain-data explanation suitable for logs, tools, and serialization. It never throws
 // and exposes no resolver runtime or raw thrown value.
 export function explainImageResourceReferenceResolution(ref) {
@@ -85,6 +63,7 @@ export function explainImageResourceReferenceResolution(ref) {
         state: ref.state,
     };
 }
+let _resolveImageBitmapComposition = null;
 // `bytes` is retained as the view the container handed over, not a copy: a parser carves an image payload
 // out of its source and the reference borrows it, so a document that never resolves an image never pays for
 // its pixels. `textures` starts empty and each waiting Texture subscribes itself.
@@ -106,6 +85,13 @@ export function initializeExternalImageResourceReference(out, uri, basePath = nu
     out.textures = [];
     out.uri = uri;
 }
+// The slot the optional decoded-pixel join installs into, so an ordinary embedded-image consumer keeps
+// neither a composer registry nor a second decode branch. Whoever owns the composers — the web host
+// today, through enableWebImageBitmapComposition — puts its resolver here and passes null to take it back;
+// until something does, the nullable hook leaves the original hot path byte-for-byte tree-shakable.
+export function registerImageBitmapCompositionResolver(resolver) {
+    _resolveImageBitmapComposition = resolver;
+}
 // Returns a failed reference to the requestable state. Loading/resolved/unresolved references are unchanged
 // so this atom cannot invalidate live work or a successfully bound resource accidentally.
 export function resetFailedImageResourceReference(ref) {

package/dist/imageResourceReference.js.map

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

package/dist/imageSourceDimensions.d.ts

@@ -0,0 +1,6 @@
+import type { HostImageDimensionResolver, HostImageDimensions, HostImageSource } from '@flighthq/types/contract';
+export declare function getHostImageSourceDimensions(source: HostImageSource, out: HostImageDimensions): boolean;
+export declare function hasHostImageDimensionResolver(): boolean;
+export declare function registerHostImageDimensionResolver(resolver: HostImageDimensionResolver): void;
+export declare function unregisterHostImageDimensionResolver(): void;
+//# sourceMappingURL=imageSourceDimensions.d.ts.map

package/dist/imageSourceDimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageSourceDimensions.d.ts","sourceRoot":"","sources":["../src/imageSourceDimensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKjH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAGvG;AAID,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAKD,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAE7F;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/imageSourceDimensions.js

@@ -0,0 +1,24 @@
+// Reads the pixel size of a borrowed host handle through the registered host resolver, returning false
+// when no resolver is registered or the registered one does not recognize this handle. `out` is left
+// untouched in both cases, so a caller keeps whatever dimensions it already had.
+export function getHostImageSourceDimensions(source, out) {
+    if (_resolver === null)
+        return false;
+    return _resolver(source, out);
+}
+// True once a host has installed its resolver. A caller that measures sources can require this rather
+// than discovering silently-zero dimensions at draw time.
+export function hasHostImageDimensionResolver() {
+    return _resolver !== null;
+}
+// Installs the host's measurer. Opt-in, like every other host capability: an application registers the
+// one its platform provides (registerWebImageDimensionResolver for the browser) and nothing in this
+// package reaches for a platform global. Last registration wins.
+export function registerHostImageDimensionResolver(resolver) {
+    _resolver = resolver;
+}
+export function unregisterHostImageDimensionResolver() {
+    _resolver = null;
+}
+let _resolver = null;
+//# sourceMappingURL=imageSourceDimensions.js.map

package/dist/imageSourceDimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageSourceDimensions.js","sourceRoot":"","sources":["../src/imageSourceDimensions.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,qGAAqG;AACrG,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAAC,MAAuB,EAAE,GAAwB;IAC5F,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,sGAAsG;AACtG,0DAA0D;AAC1D,MAAM,UAAU,6BAA6B;IAC3C,OAAO,SAAS,KAAK,IAAI,CAAC;AAC5B,CAAC;AAED,uGAAuG;AACvG,oGAAoG;AACpG,iEAAiE;AACjE,MAAM,UAAU,kCAAkC,CAAC,QAAoC;IACrF,SAAS,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,oCAAoC;IAClD,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,IAAI,SAAS,GAAsC,IAAI,CAAC"}

package/dist/imageTestHelper.d.ts

@@ -0,0 +1,5 @@
+import type { HostImageDimensionResolver } from '@flighthq/types/contract';
+export declare function registerTestImageDimensionResolver(): void;
+export declare const testImageDimensionResolver: HostImageDimensionResolver;
+export declare function unregisterTestImageDimensionResolver(): void;
+//# sourceMappingURL=imageTestHelper.d.ts.map

package/dist/imageTestHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageTestHelper.d.ts","sourceRoot":"","sources":["../src/imageTestHelper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAc3E,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AAID,eAAO,MAAM,0BAA0B,EAAE,0BAMxC,CAAC;AAGF,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/imageTestHelper.js

@@ -0,0 +1,29 @@
+import { registerHostImageDimensionResolver, unregisterHostImageDimensionResolver } from './imageSourceDimensions';
+// Measuring a borrowed handle belongs to the host, which leaves every portable package's tests needing a
+// host they must not depend on: pulling @flighthq/host-web into a renderer package's tests would invert
+// the layering the seam cleanup established. This is the portable stand-in — the same structural read a
+// browser host performs, owned by the package that owns the seam, so a test names one dependency instead
+// of hand-rolling a resolver literal.
+//
+// Register in beforeEach and clear in afterEach. Clearing is not tidiness: the slot is module state
+// shared by every test file in a Vitest process, so a file that registers and never clears can satisfy a
+// LATER file's missing registration. That is not hypothetical — it hid a real defect, where
+// scene2d-canvas passed in the broad suite and failed run on its own.
+export function registerTestImageDimensionResolver() {
+    registerHostImageDimensionResolver(testImageDimensionResolver);
+}
+// Reads width and height off any handle that carries them, and declines one that does not, exactly as a
+// host resolver must.
+export const testImageDimensionResolver = (source, out) => {
+    const sized = source;
+    if (typeof sized.width !== 'number' || typeof sized.height !== 'number')
+        return false;
+    out.height = sized.height;
+    out.width = sized.width;
+    return true;
+};
+// Pairs with registerTestImageDimensionResolver so a suite leaves the slot as it found it.
+export function unregisterTestImageDimensionResolver() {
+    unregisterHostImageDimensionResolver();
+}
+//# sourceMappingURL=imageTestHelper.js.map

package/dist/imageTestHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageTestHelper.js","sourceRoot":"","sources":["../src/imageTestHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAEnH,yGAAyG;AACzG,wGAAwG;AACxG,wGAAwG;AACxG,yGAAyG;AACzG,sCAAsC;AACtC,EAAE;AACF,oGAAoG;AACpG,yGAAyG;AACzG,4FAA4F;AAC5F,sEAAsE;AACtE,MAAM,UAAU,kCAAkC;IAChD,kCAAkC,CAAC,0BAA0B,CAAC,CAAC;AACjE,CAAC;AAED,wGAAwG;AACxG,sBAAsB;AACtB,MAAM,CAAC,MAAM,0BAA0B,GAA+B,CAAC,MAAM,EAAE,GAAG,EAAW,EAAE;IAC7F,MAAM,KAAK,GAAG,MAA+D,CAAC;IAC9E,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtF,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,oCAAoC;IAClD,oCAAoC,EAAE,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { cloneImageResource, createCompressedImageResource, createEmbeddedImageResourceReference, createExternalImageResourceReference, createImageResource, createImageResourceFailure, createImageResourceFromBitmap, createImageResourceFromCanvas, createImageResourceFromImageBitmap, createImageResourceFromImageElement, disableImageBitmapComposition, enableImageBitmapComposition, explainImageResourceReferenceResolution, isImageResourceEmpty, isImageUrlSameOrigin, loadImageResourceFromBase64, loadImageResourceFromBlob, loadImageResourceFromBytes, loadImageResourceFromUrl, resetFailedImageResourceReference, resolveImageResourceReference, } from './contract';
+export { cloneImageResource, createCompressedImageResource, createEmbeddedImageResourceReference, createExternalImageResourceReference, createImageResource, createImageResourceFailure, createImageResourceFromBitmap, explainImageResourceReferenceResolution, isImageResourceEmpty, isImageUrlSameOrigin, loadImageResourceFromBase64, loadImageResourceFromBlob, loadImageResourceFromBytes, loadImageResourceFromUrl, resetFailedImageResourceReference, resolveImageResourceReference, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,oCAAoC,EACpC,oCAAoC,EACpC,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,4BAA4B,EAC5B,uCAAuC,EACvC,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,oCAAoC,EACpC,oCAAoC,EACpC,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,uCAAuC,EACvC,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { cloneImageResource, createCompressedImageResource, createEmbeddedImageResourceReference, createExternalImageResourceReference, createImageResource, createImageResourceFailure, createImageResourceFromBitmap, createImageResourceFromCanvas, createImageResourceFromImageBitmap, createImageResourceFromImageElement, disableImageBitmapComposition, enableImageBitmapComposition, explainImageResourceReferenceResolution, isImageResourceEmpty, isImageUrlSameOrigin, loadImageResourceFromBase64, loadImageResourceFromBlob, loadImageResourceFromBytes, loadImageResourceFromUrl, resetFailedImageResourceReference, resolveImageResourceReference, } from './contract';
+export { cloneImageResource, createCompressedImageResource, createEmbeddedImageResourceReference, createExternalImageResourceReference, createImageResource, createImageResourceFailure, createImageResourceFromBitmap, explainImageResourceReferenceResolution, isImageResourceEmpty, isImageUrlSameOrigin, loadImageResourceFromBase64, loadImageResourceFromBlob, loadImageResourceFromBytes, loadImageResourceFromUrl, resetFailedImageResourceReference, resolveImageResourceReference, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,oCAAoC,EACpC,oCAAoC,EACpC,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,mCAAmC,EACnC,6BAA6B,EAC7B,4BAA4B,EAC5B,uCAAuC,EACvC,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC7B,oCAAoC,EACpC,oCAAoC,EACpC,mBAAmB,EACnB,0BAA0B,EAC1B,6BAA6B,EAC7B,uCAAuC,EACvC,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/image",
-  "version": "0.5.1-next.1069.554a2ac",
+  "version": "0.5.1-next.1197.6a425ce",
   "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.1069.554a2ac",
-    "@flighthq/image-codec": "0.5.1-next.1069.554a2ac",
-    "@flighthq/types": "0.5.1-next.1069.554a2ac"
+    "@flighthq/entity": "0.5.1-next.1197.6a425ce",
+    "@flighthq/image-codec": "0.5.1-next.1197.6a425ce",
+    "@flighthq/types": "0.5.1-next.1197.6a425ce"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/imageResource.test.ts

@@ -9,6 +9,19 @@ import {
   invalidateImageResource,
   isImageResourceEmpty,
 } from './imageResource';
+import { registerTestImageDimensionResolver, unregisterTestImageDimensionResolver } from './imageTestHelper';
+
+// Measuring a borrowed handle is the host's job, so these tests install the portable stand-in. Without
+// one a resource keeps whatever size it was constructed with, which is the behavior
+// imageSourceDimensions.test.ts covers. Clearing after each test is what keeps this file from silently
+// supplying a resolver to a later one.
+beforeEach(() => {
+  registerTestImageDimensionResolver();
+});
+
+afterEach(() => {
+  unregisterTestImageDimensionResolver();
+});
 
 function makeCompressed(): CompressedImageData {
   return {

package/src/imageResourceFrom.test.ts

@@ -1,24 +1,27 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import type { Bitmap, HasGraphicsImage, ImageBackend, ImageResource } from '@flighthq/types/contract';
+import type { Bitmap, HostImageProvider, ImageResource } from '@flighthq/types/contract';
 import { BitmapTextureSourceKind, EntityRuntimeKey } from '@flighthq/types/contract';
 
 import { createImageResource } from './imageResource';
 import {
   createImageResourceFromBitmap,
-  createImageResourceFromCanvas,
-  createImageResourceFromImageBitmap,
-  createImageResourceFromImageElement,
-  initializeImageResourceFromCanvas,
-  initializeImageResourceFromImageBitmap,
-  initializeImageResourceFromImageElement,
   isImageUrlSameOrigin,
   loadImageResourceFromBase64,
   loadImageResourceFromBlob,
   loadImageResourceFromBytes,
   loadImageResourceFromUrl,
 } from './imageResourceFrom';
+import { registerTestImageDimensionResolver, unregisterTestImageDimensionResolver } from './imageTestHelper';
 
-function webHost(): HasGraphicsImage {
+beforeEach(() => {
+  registerTestImageDimensionResolver();
+});
+
+afterEach(() => {
+  unregisterTestImageDimensionResolver();
+});
+
+function webHost(): { readonly graphics: { readonly image: HostImageProvider } } {
   return {
     graphics: {
       image: {
@@ -30,7 +33,7 @@ function webHost(): HasGraphicsImage {
           const domImageData = new globalThis.ImageData(bitmap.width, bitmap.height);
           domImageData.data.set(bitmap.data);
           canvas.getContext('2d')!.putImageData(domImageData, 0, 0);
-          return createImageResourceFromCanvas(canvas);
+          return createImageResource(canvas);
         },
         async loadImageFromUrl(
           url: string,
@@ -59,14 +62,14 @@ function webHost(): HasGraphicsImage {
           } else {
             await img.decode();
           }
-          return createImageResourceFromImageElement(img);
+          return createImageResource(img);
         },
       },
     },
-  } as HasGraphicsImage;
+  } as { readonly graphics: { readonly image: HostImageProvider } };
 }
 
-let host: HasGraphicsImage;
+let host: { readonly graphics: { readonly image: HostImageProvider } };
 
 beforeEach(() => {
   host = webHost();
@@ -84,25 +87,25 @@ describe('createImageResourceFromBitmap', () => {
     const bitmap = createTestBitmap(3, 2);
     const expected = {} as ImageResource;
     const createImageFromBitmap = vi.fn((_bitmap: Readonly<Bitmap>) => expected);
-    const backend: ImageBackend = {
+    const backend: HostImageProvider = {
       [EntityRuntimeKey]: undefined,
       createImageFromBitmap,
       loadImageFromUrl: vi.fn(),
     };
-    const customHost = { graphics: { image: backend } } as HasGraphicsImage;
+    const customHost = { graphics: { image: backend } } as { readonly graphics: { readonly image: HostImageProvider } };
     vi.stubGlobal('document', undefined);
 
-    expect(createImageResourceFromBitmap(customHost, bitmap)).toBe(expected);
+    expect(createImageResourceFromBitmap(customHost.graphics.image, bitmap)).toBe(expected);
     expect(createImageFromBitmap).toHaveBeenCalledWith(bitmap);
   });
 
   it('returns null for backend absence without throwing or falling back to DOM', () => {
     const createElement = vi.spyOn(document, 'createElement');
-    const backend: ImageBackend = { [EntityRuntimeKey]: undefined, loadImageFromUrl: vi.fn() };
-    const customHost = { graphics: { image: backend } } as HasGraphicsImage;
+    const backend: HostImageProvider = { [EntityRuntimeKey]: undefined, loadImageFromUrl: vi.fn() };
+    const customHost = { graphics: { image: backend } } as { readonly graphics: { readonly image: HostImageProvider } };
 
-    expect(() => createImageResourceFromBitmap(customHost, createTestBitmap(1, 1))).not.toThrow();
-    expect(createImageResourceFromBitmap(customHost, createTestBitmap(1, 1))).toBeNull();
+    expect(() => createImageResourceFromBitmap(customHost.graphics.image, createTestBitmap(1, 1))).not.toThrow();
+    expect(createImageResourceFromBitmap(customHost.graphics.image, createTestBitmap(1, 1))).toBeNull();
     expect(createElement).not.toHaveBeenCalled();
   });
 
@@ -116,7 +119,7 @@ describe('createImageResourceFromBitmap', () => {
     bitmap.kind = BitmapTextureSourceKind;
     bitmap.version = 0;
     bitmap.width = 4;
-    const resource = createImageResourceFromBitmap(host, bitmap);
+    const resource = createImageResourceFromBitmap(host.graphics.image, bitmap);
     expect(resource).not.toBeNull();
     if (resource === null) return;
     expect(resource.width).toBe(4);
@@ -138,92 +141,6 @@ function createTestBitmap(width: number, height: number): Bitmap {
   return finishEntity(out);
 }
 
-describe('createImageResourceFromCanvas', () => {
-  it('wraps a canvas with correct dimensions', () => {
-    const canvas = document.createElement('canvas');
-    canvas.width = 320;
-    canvas.height = 240;
-    const resource = createImageResourceFromCanvas(canvas);
-
-    expect(resource.source).toBe(canvas);
-    expect(resource.width).toBe(320);
-    expect(resource.height).toBe(240);
-  });
-
-  it('reflects the canvas dimensions at wrap time', () => {
-    const canvas = document.createElement('canvas');
-    canvas.width = 0;
-    canvas.height = 0;
-    const resource = createImageResourceFromCanvas(canvas);
-
-    expect(resource.width).toBe(0);
-    expect(resource.height).toBe(0);
-  });
-
-  it('returns a new object each call', () => {
-    const canvas = document.createElement('canvas');
-    expect(createImageResourceFromCanvas(canvas)).not.toBe(createImageResourceFromCanvas(canvas));
-  });
-});
-
-describe('createImageResourceFromImageBitmap', () => {
-  it('wraps an ImageBitmap with correct dimensions', () => {
-    const bitmap = { width: 64, height: 128, close: () => {} } as ImageBitmap;
-    const resource = createImageResourceFromImageBitmap(bitmap);
-
-    expect(resource.source).toBe(bitmap);
-    expect(resource.width).toBe(64);
-    expect(resource.height).toBe(128);
-  });
-
-  it('returns a new object each call', () => {
-    const bitmap = { width: 1, height: 1, close: () => {} } as ImageBitmap;
-    expect(createImageResourceFromImageBitmap(bitmap)).not.toBe(createImageResourceFromImageBitmap(bitmap));
-  });
-});
-
-describe('createImageResourceFromImageElement', () => {
-  it('wraps an HTMLImageElement with correct dimensions', () => {
-    const img = { width: 200, height: 100 } as HTMLImageElement;
-    const resource = createImageResourceFromImageElement(img);
-
-    expect(resource.source).toBe(img);
-    expect(resource.width).toBe(200);
-    expect(resource.height).toBe(100);
-  });
-
-  it('reflects zero dimensions for an unloaded image element', () => {
-    const img = document.createElement('img');
-    const resource = createImageResourceFromImageElement(img);
-
-    expect(resource.width).toBe(0);
-    expect(resource.height).toBe(0);
-  });
-
-  it('returns a new object each call', () => {
-    const img = document.createElement('img');
-    expect(createImageResourceFromImageElement(img)).not.toBe(createImageResourceFromImageElement(img));
-  });
-});
-
-describe('initializeImageResourceFromCanvas', () => {
-  it('is the construction initializer of createImageResourceFromCanvas', () => {
-    expect(typeof initializeImageResourceFromCanvas).toBe('function');
-  });
-});
-
-describe('initializeImageResourceFromImageBitmap', () => {
-  it('is the construction initializer of createImageResourceFromImageBitmap', () => {
-    expect(typeof initializeImageResourceFromImageBitmap).toBe('function');
-  });
-});
-
-describe('initializeImageResourceFromImageElement', () => {
-  it('is the construction initializer of createImageResourceFromImageElement', () => {
-    expect(typeof initializeImageResourceFromImageElement).toBe('function');
-  });
-});
-
 describe('isImageUrlSameOrigin', () => {
   it('returns true for data: URLs', () => {
     expect(isImageUrlSameOrigin('data:image/png;base64,abc')).toBe(true);
@@ -244,20 +161,20 @@ describe('isImageUrlSameOrigin', () => {
 
 describe('loadImageResourceFromBase64', () => {
   it('resolves to an ImageResource', async () => {
-    const resource = await loadImageResourceFromBase64(host, 'abc123', 'image/png');
+    const resource = await loadImageResourceFromBase64(host.graphics.image, 'abc123', 'image/png');
     expect(resource).not.toBeNull();
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 
   it('builds a data: URL from the base64 string and mime type', async () => {
-    const resource = await loadImageResourceFromBase64(host, 'aGVsbG8=', 'image/png');
+    const resource = await loadImageResourceFromBase64(host.graphics.image, 'aGVsbG8=', 'image/png');
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 });
 describe('loadImageResourceFromBlob', () => {
   it('resolves to an ImageResource', async () => {
     const blob = new Blob([], { type: 'image/png' });
-    const resource = await loadImageResourceFromBlob(host, blob);
+    const resource = await loadImageResourceFromBlob(host.graphics.image, blob);
     expect(resource).not.toBeNull();
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
@@ -265,7 +182,7 @@ describe('loadImageResourceFromBlob', () => {
   it('revokes the object URL after loading', async () => {
     const revokeSpy = vi.spyOn(URL, 'revokeObjectURL');
     const blob = new Blob([], { type: 'image/png' });
-    await loadImageResourceFromBlob(host, blob);
+    await loadImageResourceFromBlob(host.graphics.image, blob);
     expect(revokeSpy).toHaveBeenCalledOnce();
   });
 
@@ -273,7 +190,7 @@ describe('loadImageResourceFromBlob', () => {
     HTMLImageElement.prototype.decode = vi.fn().mockRejectedValue(new Error('load failed'));
     const revokeSpy = vi.spyOn(URL, 'revokeObjectURL');
     const blob = new Blob([], { type: 'image/png' });
-    await expect(loadImageResourceFromBlob(host, blob)).rejects.toThrow('load failed');
+    await expect(loadImageResourceFromBlob(host.graphics.image, blob)).rejects.toThrow('load failed');
     expect(revokeSpy).toHaveBeenCalledOnce();
   });
 });
@@ -281,24 +198,26 @@ describe('loadImageResourceFromBlob', () => {
 describe('loadImageResourceFromBytes', () => {
   it('throws when mime type cannot be detected and none is provided', async () => {
     const bytes = new Uint8Array([0x00, 0x01, 0x02, 0x03]);
-    await expect(loadImageResourceFromBytes(host, bytes)).rejects.toThrow('Unable to determine image type');
+    await expect(loadImageResourceFromBytes(host.graphics.image, bytes)).rejects.toThrow(
+      'Unable to determine image type',
+    );
   });
 
   it('uses the provided mimeType and bypasses detection', async () => {
     const bytes = new Uint8Array(16);
-    const resource = await loadImageResourceFromBytes(host, bytes, 'image/png');
+    const resource = await loadImageResourceFromBytes(host.graphics.image, bytes, 'image/png');
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 
   it('detects PNG and resolves', async () => {
     const bytes = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 0, 0, 0, 0, 0, 0, 0, 0]);
-    const resource = await loadImageResourceFromBytes(host, bytes);
+    const resource = await loadImageResourceFromBytes(host.graphics.image, bytes);
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 
   it('detects JPEG and resolves', async () => {
     const bytes = new Uint8Array([0xff, 0xd8, 0xff, 0xe0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]);
-    const resource = await loadImageResourceFromBytes(host, bytes);
+    const resource = await loadImageResourceFromBytes(host.graphics.image, bytes);
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 });
@@ -315,7 +234,7 @@ describe('loadImageResourceFromUrl', () => {
       },
     }) as typeof Image;
 
-    await loadImageResourceFromUrl(host, '/images/logo.png');
+    await loadImageResourceFromUrl(host.graphics.image, '/images/logo.png');
     expect(capturedImg?.crossOrigin).toBeNull();
 
     globalThis.Image = origImage;
@@ -325,7 +244,7 @@ describe('loadImageResourceFromUrl', () => {
     const controller = new AbortController();
     controller.abort(new Error('cancelled'));
     await expect(
-      loadImageResourceFromUrl(host, 'data:image/png;base64,abc', undefined, controller.signal),
+      loadImageResourceFromUrl(host.graphics.image, 'data:image/png;base64,abc', undefined, controller.signal),
     ).rejects.toThrow('cancelled');
   });
 
@@ -343,7 +262,7 @@ describe('loadImageResourceFromUrl', () => {
     const controller = new AbortController();
 
     try {
-      const promise = loadImageResourceFromUrl(host, '/images/slow.png', undefined, controller.signal);
+      const promise = loadImageResourceFromUrl(host.graphics.image, '/images/slow.png', undefined, controller.signal);
       controller.abort(new Error('cancelled'));
       await expect(promise).rejects.toThrow('cancelled');
       expect(capturedImg?.getAttribute('src')).toBe('');
@@ -357,7 +276,7 @@ describe('loadImageResourceFromUrl', () => {
     const add = vi.spyOn(controller.signal, 'addEventListener');
     const remove = vi.spyOn(controller.signal, 'removeEventListener');
 
-    await loadImageResourceFromUrl(host, '/images/logo.png', undefined, controller.signal);
+    await loadImageResourceFromUrl(host.graphics.image, '/images/logo.png', undefined, controller.signal);
 
     expect(add).toHaveBeenCalledOnce();
     expect(remove).toHaveBeenCalledOnce();
@@ -365,7 +284,7 @@ describe('loadImageResourceFromUrl', () => {
   });
 
   it('resolves to an ImageResource whose source is an HTMLImageElement', async () => {
-    const resource = await loadImageResourceFromUrl(host, 'data:image/png;base64,abc');
+    const resource = await loadImageResourceFromUrl(host.graphics.image, 'data:image/png;base64,abc');
     expect(resource.source).toBeInstanceOf(HTMLImageElement);
   });
 
@@ -380,7 +299,7 @@ describe('loadImageResourceFromUrl', () => {
       },
     }) as typeof Image;
 
-    await loadImageResourceFromUrl(host, 'https://cdn.other-domain.com/image.png', crossOrigin);
+    await loadImageResourceFromUrl(host.graphics.image, 'https://cdn.other-domain.com/image.png', crossOrigin);
     expect(capturedImg?.crossOrigin).toBe(crossOrigin);
 
     globalThis.Image = origImage;

package/src/imageResourceReference.test.ts

@@ -1,10 +1,5 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import {
-  clearImageBitmapComposers,
-  clearImageDecoders,
-  registerImageBitmapComposer,
-  registerImageDecoder,
-} from '@flighthq/image-codec/contract';
+import { clearImageDecoders, registerImageDecoder } from '@flighthq/image-codec/contract';
 import type { Bitmap, ImageResource, ImageDecoder } from '@flighthq/types/contract';
 import {
   BitmapTextureSourceKind,
@@ -17,11 +12,10 @@ import {
   createEmbeddedImageResourceReference,
   createExternalImageResourceReference,
   createImageResourceFailure,
-  disableImageBitmapComposition,
-  enableImageBitmapComposition,
   explainImageResourceReferenceResolution,
   initializeEmbeddedImageResourceReference,
   initializeExternalImageResourceReference,
+  registerImageBitmapCompositionResolver,
   resetFailedImageResourceReference,
   resolveImageResourceReference,
 } from './imageResourceReference';
@@ -38,8 +32,7 @@ beforeEach(() => {
 });
 
 afterEach(() => {
-  disableImageBitmapComposition();
-  clearImageBitmapComposers();
+  registerImageBitmapCompositionResolver(null);
   clearImageDecoders();
 });
 
@@ -91,37 +84,6 @@ describe('createImageResourceFailure', () => {
   });
 });
 
-describe('disableImageBitmapComposition', () => {
-  it('restores the ordinary decoder path for a reference that carries composition data', async () => {
-    const composer = vi.fn().mockReturnValue(createTestBitmap('straight'));
-    registerImageBitmapComposer('acme/alpha-plane', composer);
-    enableImageBitmapComposition();
-    disableImageBitmapComposition();
-    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]), 'image/png');
-    ref.bitmapComposition = { kind: 'acme/alpha-plane', payload: new Uint8Array([7]) };
-
-    const source = await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal);
-
-    expect(composer).not.toHaveBeenCalled();
-    expect(decoder).toHaveBeenCalledWith(ref.bytes);
-    expect(source?.kind).toBe(BitmapTextureSourceKind);
-  });
-});
-
-describe('enableImageBitmapComposition', () => {
-  it('installs the registered decoded-pixel composition route', async () => {
-    const bitmap = createTestBitmap('straight');
-    const composer = vi.fn().mockReturnValue(bitmap);
-    registerImageBitmapComposer('acme/alpha-plane', composer);
-    enableImageBitmapComposition();
-    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]), 'image/png');
-    ref.bitmapComposition = { kind: 'acme/alpha-plane', payload: new Uint8Array([7]) };
-
-    expect(await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal)).toBe(bitmap);
-    expect(composer).toHaveBeenCalledOnce();
-  });
-});
-
 describe('explainImageResourceReferenceResolution', () => {
   it('detaches the failure so a caller cannot mutate the reference', () => {
     const ref = createEmbeddedImageResourceReference(new Uint8Array(1));
@@ -164,6 +126,34 @@ function createTestBitmap(alphaType: Bitmap['alphaType']): Bitmap {
   out.width = 1;
   return finishEntity(out);
 }
+describe('registerImageBitmapCompositionResolver', () => {
+  it('routes a reference that carries composition data through the installed resolver', async () => {
+    const bitmap = createTestBitmap('straight');
+    const resolver = vi.fn().mockResolvedValue(bitmap);
+    registerImageBitmapCompositionResolver(resolver);
+    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]), 'image/png');
+    ref.bitmapComposition = { kind: 'acme/alpha-plane', payload: new Uint8Array([7]) };
+
+    expect(await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal)).toBe(bitmap);
+    expect(resolver).toHaveBeenCalledOnce();
+    expect(decoder).not.toHaveBeenCalled();
+  });
+
+  // Null is how the owner takes the join back out. The slot is the whole of image's knowledge about
+  // composition, so an emptied slot must leave the ordinary straight-decode path exactly as it was.
+  it('restores the ordinary decode path when the resolver is taken back out', async () => {
+    registerImageBitmapCompositionResolver(vi.fn().mockResolvedValue(createTestBitmap('straight')));
+    registerImageBitmapCompositionResolver(null);
+    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]), 'image/png');
+    ref.bitmapComposition = { kind: 'acme/alpha-plane', payload: new Uint8Array([7]) };
+
+    const source = await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal);
+
+    expect(decoder).toHaveBeenCalledWith(ref.bytes);
+    expect(source?.kind).toBe(BitmapTextureSourceKind);
+  });
+});
+
 describe('resetFailedImageResourceReference', () => {
   it('clears a failed reference back to unresolved', () => {
     const ref = createExternalImageResourceReference('a.png');
@@ -213,50 +203,6 @@ describe('resolveImageResourceReference', () => {
     expect(source?.alphaType).toBe('premultiplied');
   });
 
-  it('hands straight decoded pixels and plain payload bytes to a registered Bitmap composer', async () => {
-    const payload = new Uint8Array([7, 8, 9]);
-    const bitmap = createTestBitmap('straight');
-    const composer = vi.fn().mockReturnValue(bitmap);
-    registerImageBitmapComposer('acme/alpha-plane', composer);
-    enableImageBitmapComposition();
-    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]), 'image/png', 'premultiplied');
-    ref.bitmapComposition = { kind: 'acme/alpha-plane', payload };
-
-    const source = await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal);
-
-    expect(decoder).toHaveBeenCalledWith(ref.bytes);
-    expect(composer).toHaveBeenCalledWith(
-      { data: new Uint8ClampedArray([0x11, 0x22, 0x33, 0x44]), height: 1, width: 1 },
-      payload,
-    );
-    expect(source).toBe(bitmap);
-  });
-
-  it('lets a registered raw-pixel producer return a Bitmap when no MIME decoder recognizes the bytes', async () => {
-    const bitmap = createTestBitmap('opaque');
-    const composer = vi.fn().mockReturnValue(bitmap);
-    registerImageBitmapComposer('acme/raw-raster', composer);
-    enableImageBitmapComposition();
-    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]));
-    ref.bitmapComposition = { kind: 'acme/raw-raster', payload: ref.bytes };
-
-    const source = await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal);
-
-    expect(composer).toHaveBeenCalledWith(null, ref.bytes);
-    expect(source).toBe(bitmap);
-  });
-
-  it('reports an unavailable resource when its declared Bitmap composer is not registered', async () => {
-    enableImageBitmapComposition();
-    const ref = createEmbeddedImageResourceReference(new Uint8Array([1]));
-    ref.bitmapComposition = { kind: 'acme/missing', payload: ref.bytes };
-
-    expect(await resolveImageResourceReference(ref, unusedFetch, new AbortController().signal)).toBeNull();
-    expect(decoder).not.toHaveBeenCalled();
-    expect(ref.state).toBe(ResourceResolutionState.Failed);
-    expect(ref.failure?.kind).toBe(ImageResourceFailureKind.Unavailable);
-  });
-
   it('retains the missing-decoder cause when embedded bytes cannot be decoded', async () => {
     clearImageDecoders();
     const ref = createEmbeddedImageResourceReference(new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]));

package/src/imageSourceDimensions.test.ts

@@ -0,0 +1,88 @@
+import type { HostImageSource } from '@flighthq/types/contract';
+
+import {
+  getHostImageSourceDimensions,
+  hasHostImageDimensionResolver,
+  registerHostImageDimensionResolver,
+  unregisterHostImageDimensionResolver,
+} from './imageSourceDimensions';
+
+// The slot is module state, so every test starts from an empty one rather than from whatever the
+// previous test installed.
+afterEach(() => {
+  unregisterHostImageDimensionResolver();
+});
+
+const sizedSource = { height: 4, width: 8 } as unknown as HostImageSource;
+
+describe('getHostImageSourceDimensions', () => {
+  it('measures through the registered resolver', () => {
+    registerHostImageDimensionResolver((source, out) => {
+      const sized = source as unknown as { height: number; width: number };
+      out.height = sized.height;
+      out.width = sized.width;
+      return true;
+    });
+    const out = { height: 0, width: 0 };
+
+    expect(getHostImageSourceDimensions(sizedSource, out)).toBe(true);
+    expect(out).toStrictEqual({ height: 4, width: 8 });
+  });
+
+  // Reporting false rather than zero is the whole contract: a caller that already measured its source
+  // keeps that size instead of having it overwritten with a number no host produced.
+  it('reports false and leaves out untouched with no resolver registered', () => {
+    const out = { height: 11, width: 22 };
+
+    expect(getHostImageSourceDimensions(sizedSource, out)).toBe(false);
+    expect(out).toStrictEqual({ height: 11, width: 22 });
+  });
+
+  it('reports false when the registered resolver declines the handle', () => {
+    registerHostImageDimensionResolver(() => false);
+    const out = { height: 11, width: 22 };
+
+    expect(getHostImageSourceDimensions(sizedSource, out)).toBe(false);
+    expect(out).toStrictEqual({ height: 11, width: 22 });
+  });
+});
+
+describe('hasHostImageDimensionResolver', () => {
+  it('is false before a host registers one', () => {
+    expect(hasHostImageDimensionResolver()).toBe(false);
+  });
+
+  it('is true once a host registers one', () => {
+    registerHostImageDimensionResolver(() => true);
+    expect(hasHostImageDimensionResolver()).toBe(true);
+  });
+});
+
+describe('registerHostImageDimensionResolver', () => {
+  it('replaces a previously registered resolver', () => {
+    registerHostImageDimensionResolver((_source, out) => {
+      out.height = 1;
+      out.width = 1;
+      return true;
+    });
+    registerHostImageDimensionResolver((_source, out) => {
+      out.height = 2;
+      out.width = 3;
+      return true;
+    });
+    const out = { height: 0, width: 0 };
+    getHostImageSourceDimensions(sizedSource, out);
+
+    expect(out).toStrictEqual({ height: 2, width: 3 });
+  });
+});
+
+describe('unregisterHostImageDimensionResolver', () => {
+  it('empties the slot so measuring reports false again', () => {
+    registerHostImageDimensionResolver(() => true);
+    unregisterHostImageDimensionResolver();
+
+    expect(hasHostImageDimensionResolver()).toBe(false);
+    expect(getHostImageSourceDimensions(sizedSource, { height: 0, width: 0 })).toBe(false);
+  });
+});

package/src/imageTestHelper.test.ts

@@ -0,0 +1,50 @@
+import type { HostImageSource } from '@flighthq/types/contract';
+
+import { getHostImageSourceDimensions, hasHostImageDimensionResolver } from './imageSourceDimensions';
+import {
+  registerTestImageDimensionResolver,
+  testImageDimensionResolver,
+  unregisterTestImageDimensionResolver,
+} from './imageTestHelper';
+
+afterEach(() => {
+  unregisterTestImageDimensionResolver();
+});
+
+describe('registerTestImageDimensionResolver', () => {
+  it('fills the slot so a portable test can measure a sized handle', () => {
+    registerTestImageDimensionResolver();
+    const out = { height: 0, width: 0 };
+
+    expect(hasHostImageDimensionResolver()).toBe(true);
+    expect(getHostImageSourceDimensions({ height: 3, width: 9 } as unknown as HostImageSource, out)).toBe(true);
+    expect(out).toStrictEqual({ height: 3, width: 9 });
+  });
+});
+
+describe('testImageDimensionResolver', () => {
+  it('reads width and height off a sized handle', () => {
+    const out = { height: 0, width: 0 };
+
+    expect(testImageDimensionResolver({ height: 6, width: 12 } as unknown as HostImageSource, out)).toBe(true);
+    expect(out).toStrictEqual({ height: 6, width: 12 });
+  });
+
+  // Declining rather than reporting zero is the resolver contract, and the stand-in has to honor it or a
+  // test would prove something the real host does not do.
+  it('declines a handle carrying no numeric size and leaves out untouched', () => {
+    const out = { height: 5, width: 7 };
+
+    expect(testImageDimensionResolver({} as unknown as HostImageSource, out)).toBe(false);
+    expect(out).toStrictEqual({ height: 5, width: 7 });
+  });
+});
+
+describe('unregisterTestImageDimensionResolver', () => {
+  it('empties the slot so no later test file inherits this one', () => {
+    registerTestImageDimensionResolver();
+    unregisterTestImageDimensionResolver();
+
+    expect(hasHostImageDimensionResolver()).toBe(false);
+  });
+});