@flighthq/image-codec 0.3.0-next.906.07cea63 → 0.3.0

package/dist/contract.d.ts

@@ -1,6 +1,8 @@
 export * from './decodeImage';
 export * from './detectImageMimeType';
 export * from './encodeImage';
+export * from './explainImageDecodeFailure';
+export * from './explainImageEncodeFailure';
 export * from './imageDecoderRegistry';
 export * from './imageEncoderRegistry';
 export * from './registerWebImageDecoders';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}

package/dist/contract.js

@@ -1,6 +1,8 @@
 export * from './decodeImage';
 export * from './detectImageMimeType';
 export * from './encodeImage';
+export * from './explainImageDecodeFailure';
+export * from './explainImageEncodeFailure';
 export * from './imageDecoderRegistry';
 export * from './imageEncoderRegistry';
 export * from './registerWebImageDecoders';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}

package/dist/detectImageMimeType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detectImageMimeType.d.ts","sourceRoot":"","sources":["../src/detectImageMimeType.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CA+B3F"}
+{"version":3,"file":"detectImageMimeType.d.ts","sourceRoot":"","sources":["../src/detectImageMimeType.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CA4C3F"}

package/dist/detectImageMimeType.js

@@ -25,9 +25,39 @@ export function detectImageMimeType(data) {
         b[10] === 0x42 &&
         b[11] === 0x50)
         return 'image/webp';
+    // AVIF: ISO-BMFF FileTypeBox whose major or compatible brands include avif/avis.
+    if (isAvifFileTypeBox(b))
+        return 'image/avif';
+    // ICO: 00 00 01 00
+    if (b[0] === 0x00 && b[1] === 0x00 && b[2] === 0x01 && b[3] === 0x00)
+        return 'image/x-icon';
+    // TIFF: little-endian II*\0 or big-endian MM\0*
+    if ((b[0] === 0x49 && b[1] === 0x49 && b[2] === 0x2a && b[3] === 0x00) ||
+        (b[0] === 0x4d && b[1] === 0x4d && b[2] === 0x00 && b[3] === 0x2a))
+        return 'image/tiff';
     // BMP: 42 4D
     if (b[0] === 0x42 && b[1] === 0x4d)
         return 'image/bmp';
     return null;
 }
+function isAvifFileTypeBox(bytes) {
+    if (bytes.byteLength < 16 || bytes[4] !== 0x66 || bytes[5] !== 0x74 || bytes[6] !== 0x79 || bytes[7] !== 0x70)
+        return false;
+    const boxSize = bytes[0] * 0x1000000 + bytes[1] * 0x10000 + bytes[2] * 0x100 + bytes[3];
+    if (boxSize < 16 || boxSize > bytes.byteLength || (boxSize - 16) % 4 !== 0)
+        return false;
+    if (isAvifBrand(bytes, 8))
+        return true;
+    for (let offset = 16; offset < boxSize; offset += 4) {
+        if (isAvifBrand(bytes, offset))
+            return true;
+    }
+    return false;
+}
+function isAvifBrand(bytes, offset) {
+    return (bytes[offset] === 0x61 &&
+        bytes[offset + 1] === 0x76 &&
+        bytes[offset + 2] === 0x69 &&
+        (bytes[offset + 3] === 0x66 || bytes[offset + 3] === 0x73));
+}
 //# sourceMappingURL=detectImageMimeType.js.map

package/dist/detectImageMimeType.js.map

@@ -1 +1 @@
-{"version":3,"file":"detectImageMimeType.js","sourceRoot":"","sources":["../src/detectImageMimeType.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,iGAAiG;AACjG,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CAAC,IAAwC;IAC1E,MAAM,CAAC,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,+BAA+B;IAC/B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEzF,iBAAiB;IACjB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAEzE,+BAA+B;IAC/B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEzF,0CAA0C;IAC1C,IACE,CAAC,CAAC,UAAU,IAAI,EAAE;QAClB,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;QACd,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;QAEd,OAAO,YAAY,CAAC;IAEtB,aAAa;IACb,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEvD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"detectImageMimeType.js","sourceRoot":"","sources":["../src/detectImageMimeType.ts"],"names":[],"mappings":"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"}

package/dist/explainImageDecodeFailure.d.ts

@@ -0,0 +1,3 @@
+import type { ImageDecodeFailureExplanation } from '@flighthq/types/contract';
+export declare function explainImageDecodeFailure(bytes: Readonly<Uint8Array>, mimeType?: string): ImageDecodeFailureExplanation | null;
+//# sourceMappingURL=explainImageDecodeFailure.d.ts.map

package/dist/explainImageDecodeFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainImageDecodeFailure.d.ts","sourceRoot":"","sources":["../src/explainImageDecodeFailure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAO9E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,QAAQ,CAAC,EAAE,MAAM,GAChB,6BAA6B,GAAG,IAAI,CAKtC"}

package/dist/explainImageDecodeFailure.js

@@ -0,0 +1,13 @@
+import { detectImageMimeType } from './detectImageMimeType';
+import { getImageDecoder } from './imageDecoderRegistry';
+// Explains the two dispatcher failures that decodeImage represents with null. Returns null when the
+// same request can reach a registered decoder. This is a read-only query and never invokes the codec.
+export function explainImageDecodeFailure(bytes, mimeType) {
+    const type = mimeType ?? detectImageMimeType(bytes);
+    if (type === null)
+        return { mimeType: null, reason: 'mime-type-undetected' };
+    if (getImageDecoder(type) === null)
+        return { mimeType: type, reason: 'decoder-not-registered' };
+    return null;
+}
+//# sourceMappingURL=explainImageDecodeFailure.js.map

package/dist/explainImageDecodeFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainImageDecodeFailure.js","sourceRoot":"","sources":["../src/explainImageDecodeFailure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,oGAAoG;AACpG,sGAAsG;AACtG,MAAM,UAAU,yBAAyB,CACvC,KAA2B,EAC3B,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC7E,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IAChG,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/explainImageEncodeFailure.d.ts

@@ -0,0 +1,3 @@
+import type { ImageEncodeFailureExplanation } from '@flighthq/types/contract';
+export declare function explainImageEncodeFailure(mimeType: string): ImageEncodeFailureExplanation | null;
+//# sourceMappingURL=explainImageEncodeFailure.d.ts.map

package/dist/explainImageEncodeFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainImageEncodeFailure.d.ts","sourceRoot":"","sources":["../src/explainImageEncodeFailure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAM9E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,6BAA6B,GAAG,IAAI,CAGhG"}

package/dist/explainImageEncodeFailure.js

@@ -0,0 +1,9 @@
+import { getImageEncoder } from './imageEncoderRegistry';
+// Explains the dispatcher failure that encodeImage represents with null. Returns null when an encoder
+// is registered for the requested MIME type. This is a read-only query and never invokes the codec.
+export function explainImageEncodeFailure(mimeType) {
+    if (getImageEncoder(mimeType) !== null)
+        return null;
+    return { mimeType, reason: 'encoder-not-registered' };
+}
+//# sourceMappingURL=explainImageEncodeFailure.js.map

package/dist/explainImageEncodeFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainImageEncodeFailure.js","sourceRoot":"","sources":["../src/explainImageEncodeFailure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,sGAAsG;AACtG,oGAAoG;AACpG,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;AACxD,CAAC"}

package/dist/imageDecoderRegistry.d.ts

@@ -1,6 +1,7 @@
 import type { ImageDecoder } from '@flighthq/types/contract';
 export declare function clearImageDecoders(): void;
 export declare function getImageDecoder(mimeType: string): ImageDecoder | null;
+export declare function getImageDecoderMimeTypes(): readonly string[];
 export declare function hasImageDecoder(mimeType: string): boolean;
 export declare function registerImageDecoder(mimeType: string, decoder: ImageDecoder): void;
 export declare function unregisterImageDecoder(mimeType: string): void;

package/dist/imageDecoderRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageDecoderRegistry.d.ts","sourceRoot":"","sources":["../src/imageDecoderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D"}
+{"version":3,"file":"imageDecoderRegistry.d.ts","sourceRoot":"","sources":["../src/imageDecoderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErE;AAID,wBAAgB,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D"}

package/dist/imageDecoderRegistry.js

@@ -4,6 +4,11 @@ export function clearImageDecoders() {
 export function getImageDecoder(mimeType) {
     return decoders.get(mimeType) ?? null;
 }
+// Returns an insertion-ordered snapshot of the MIME types with registered decoders. Mutating the
+// returned array cannot change registry state.
+export function getImageDecoderMimeTypes() {
+    return Array.from(decoders.keys());
+}
 export function hasImageDecoder(mimeType) {
     return decoders.has(mimeType);
 }

package/dist/imageDecoderRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageDecoderRegistry.js","sourceRoot":"","sources":["../src/imageDecoderRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAqB;IAC1E,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,uGAAuG;AACvG,sGAAsG;AACtG,sDAAsD;AACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC"}
+{"version":3,"file":"imageDecoderRegistry.js","sourceRoot":"","sources":["../src/imageDecoderRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,iGAAiG;AACjG,+CAA+C;AAC/C,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAqB;IAC1E,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,uGAAuG;AACvG,sGAAsG;AACtG,sDAAsD;AACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC"}

package/dist/imageEncoderRegistry.d.ts

@@ -1,6 +1,7 @@
 import type { ImageEncoder } from '@flighthq/types/contract';
 export declare function clearImageEncoders(): void;
 export declare function getImageEncoder(mimeType: string): ImageEncoder | null;
+export declare function getImageEncoderMimeTypes(): readonly string[];
 export declare function hasImageEncoder(mimeType: string): boolean;
 export declare function registerImageEncoder(mimeType: string, encoder: ImageEncoder): void;
 export declare function unregisterImageEncoder(mimeType: string): void;

package/dist/imageEncoderRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageEncoderRegistry.d.ts","sourceRoot":"","sources":["../src/imageEncoderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D"}
+{"version":3,"file":"imageEncoderRegistry.d.ts","sourceRoot":"","sources":["../src/imageEncoderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErE;AAID,wBAAgB,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D"}

package/dist/imageEncoderRegistry.js

@@ -4,6 +4,11 @@ export function clearImageEncoders() {
 export function getImageEncoder(mimeType) {
     return encoders.get(mimeType) ?? null;
 }
+// Returns an insertion-ordered snapshot of the MIME types with registered encoders. Mutating the
+// returned array cannot change registry state.
+export function getImageEncoderMimeTypes() {
+    return Array.from(encoders.keys());
+}
 export function hasImageEncoder(mimeType) {
     return encoders.has(mimeType);
 }

package/dist/imageEncoderRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageEncoderRegistry.js","sourceRoot":"","sources":["../src/imageEncoderRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAqB;IAC1E,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,uGAAuG;AACvG,sGAAsG;AACtG,sDAAsD;AACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC"}
+{"version":3,"file":"imageEncoderRegistry.js","sourceRoot":"","sources":["../src/imageEncoderRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,iGAAiG;AACjG,+CAA+C;AAC/C,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAqB;IAC1E,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,uGAAuG;AACvG,sGAAsG;AACtG,sDAAsD;AACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { clearImageDecoders, clearImageEncoders, decodeImage, decodeImagePremultiplied, detectImageMimeType, encodeImage, getImageDecoder, getImageEncoder, hasImageDecoder, hasImageEncoder, registerImageDecoder, registerImageEncoder, registerWebImageDecoders, registerWebImageEncoders, unregisterImageDecoder, unregisterImageEncoder, } from './contract';
+export { clearImageDecoders, clearImageEncoders, decodeImage, decodeImagePremultiplied, detectImageMimeType, encodeImage, explainImageDecodeFailure, explainImageEncodeFailure, getImageDecoder, getImageDecoderMimeTypes, getImageEncoder, getImageEncoderMimeTypes, hasImageDecoder, hasImageEncoder, registerImageDecoder, registerImageEncoder, registerWebImageDecoders, registerWebImageEncoders, unregisterImageDecoder, unregisterImageEncoder, } 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,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { clearImageDecoders, clearImageEncoders, decodeImage, decodeImagePremultiplied, detectImageMimeType, encodeImage, getImageDecoder, getImageEncoder, hasImageDecoder, hasImageEncoder, registerImageDecoder, registerImageEncoder, registerWebImageDecoders, registerWebImageEncoders, unregisterImageDecoder, unregisterImageEncoder, } from './contract';
+export { clearImageDecoders, clearImageEncoders, decodeImage, decodeImagePremultiplied, detectImageMimeType, encodeImage, explainImageDecodeFailure, explainImageEncodeFailure, getImageDecoder, getImageDecoderMimeTypes, getImageEncoder, getImageEncoderMimeTypes, hasImageDecoder, hasImageEncoder, registerImageDecoder, registerImageEncoder, registerWebImageDecoders, registerWebImageEncoders, unregisterImageDecoder, unregisterImageEncoder, } 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,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@flighthq/image-codec",
-  "version": "0.3.0-next.906.07cea63",
+  "version": "0.3.0",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.3.0-next.906.07cea63"
+    "@flighthq/types": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/decodeImage.test.ts

@@ -53,7 +53,14 @@ describe('decodeImagePremultiplied', () => {
       fakeDecoded(),
     );
     registerImageDecoder('image/png', decoder);
-    await decodeImagePremultiplied(pngBytes);
+    await decodeImagePremultiplied(pngBytes, 'image/png');
+    expect(decoder).toHaveBeenCalledWith(pngBytes, { premultiplyAlpha: true });
+  });
+
+  it('auto-detects the MIME type when omitted', async () => {
+    const decoder = vi.fn(async () => fakeDecoded());
+    registerImageDecoder('image/png', decoder);
+    expect(await decodeImagePremultiplied(pngBytes)).toEqual(fakeDecoded());
     expect(decoder).toHaveBeenCalledWith(pngBytes, { premultiplyAlpha: true });
   });
 

package/src/detectImageMimeType.test.ts

@@ -48,6 +48,32 @@ describe('detectImageMimeType', () => {
     expect(detectImageMimeType(buf)).toBe('image/webp');
   });
 
+  it('detects AVIF from its major brand', () => {
+    expect(detectImageMimeType(createFileTypeBox('avif'))).toBe('image/avif');
+  });
+
+  it('detects AVIF sequences from a compatible brand', () => {
+    expect(detectImageMimeType(createFileTypeBox('mif1', 'avis'))).toBe('image/avif');
+  });
+
+  it('rejects a non-AVIF or truncated file type box', () => {
+    const brandOutsideBox = new Uint8Array(20);
+    brandOutsideBox.set(createFileTypeBox('isom'));
+    writeAscii(brandOutsideBox, 16, 'avif');
+    expect(detectImageMimeType(createFileTypeBox('isom', 'mp42'))).toBeNull();
+    expect(detectImageMimeType(createFileTypeBox('avif').subarray(0, 12))).toBeNull();
+    expect(detectImageMimeType(brandOutsideBox)).toBeNull();
+  });
+
+  it('detects ICO', () => {
+    expect(detectImageMimeType(new Uint8Array([0x00, 0x00, 0x01, 0x00]))).toBe('image/x-icon');
+  });
+
+  it('detects little-endian and big-endian TIFF', () => {
+    expect(detectImageMimeType(new Uint8Array([0x49, 0x49, 0x2a, 0x00]))).toBe('image/tiff');
+    expect(detectImageMimeType(new Uint8Array([0x4d, 0x4d, 0x00, 0x2a]))).toBe('image/tiff');
+  });
+
   it('detects BMP', () => {
     const buf = new ArrayBuffer(16);
     new Uint8Array(buf).set([0x42, 0x4d]);
@@ -58,3 +84,19 @@ describe('detectImageMimeType', () => {
     expect(detectImageMimeType(new Uint8Array([0x89, 0x50, 0x4e, 0x47]))).toBe('image/png');
   });
 });
+
+function createFileTypeBox(majorBrand: string, ...compatibleBrands: string[]): Uint8Array {
+  const bytes = new Uint8Array(16 + compatibleBrands.length * 4);
+  const size = bytes.byteLength;
+  bytes.set([(size >>> 24) & 0xff, (size >>> 16) & 0xff, (size >>> 8) & 0xff, size & 0xff]);
+  writeAscii(bytes, 4, 'ftyp');
+  writeAscii(bytes, 8, majorBrand);
+  for (let index = 0; index < compatibleBrands.length; index++) {
+    writeAscii(bytes, 16 + index * 4, compatibleBrands[index]);
+  }
+  return bytes;
+}
+
+function writeAscii(bytes: Uint8Array, offset: number, value: string): void {
+  for (let index = 0; index < 4; index++) bytes[offset + index] = value.charCodeAt(index);
+}

package/src/explainImageDecodeFailure.test.ts

@@ -0,0 +1,37 @@
+import { vi } from 'vitest';
+
+import { explainImageDecodeFailure } from './explainImageDecodeFailure';
+import { clearImageDecoders, registerImageDecoder } from './imageDecoderRegistry';
+
+const pngBytes = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+
+afterEach(() => {
+  clearImageDecoders();
+});
+
+describe('explainImageDecodeFailure', () => {
+  it('distinguishes an undetected MIME type from a missing decoder', () => {
+    expect(explainImageDecodeFailure(new Uint8Array([0, 1, 2, 3]))).toEqual({
+      mimeType: null,
+      reason: 'mime-type-undetected',
+    });
+    expect(explainImageDecodeFailure(pngBytes)).toEqual({
+      mimeType: 'image/png',
+      reason: 'decoder-not-registered',
+    });
+  });
+
+  it('reports the explicit MIME type when its decoder is missing', () => {
+    expect(explainImageDecodeFailure(pngBytes, 'image/custom')).toEqual({
+      mimeType: 'image/custom',
+      reason: 'decoder-not-registered',
+    });
+  });
+
+  it('returns null without invoking a registered decoder', () => {
+    const decoder = vi.fn();
+    registerImageDecoder('image/png', decoder);
+    expect(explainImageDecodeFailure(pngBytes)).toBeNull();
+    expect(decoder).not.toHaveBeenCalled();
+  });
+});

package/src/explainImageEncodeFailure.test.ts

@@ -0,0 +1,24 @@
+import { vi } from 'vitest';
+
+import { explainImageEncodeFailure } from './explainImageEncodeFailure';
+import { clearImageEncoders, registerImageEncoder } from './imageEncoderRegistry';
+
+afterEach(() => {
+  clearImageEncoders();
+});
+
+describe('explainImageEncodeFailure', () => {
+  it('reports a missing encoder and its requested MIME type', () => {
+    expect(explainImageEncodeFailure('image/custom')).toEqual({
+      mimeType: 'image/custom',
+      reason: 'encoder-not-registered',
+    });
+  });
+
+  it('returns null without invoking a registered encoder', () => {
+    const encoder = vi.fn();
+    registerImageEncoder('image/png', encoder);
+    expect(explainImageEncodeFailure('image/png')).toBeNull();
+    expect(encoder).not.toHaveBeenCalled();
+  });
+});

package/src/imageDecoderRegistry.test.ts

@@ -3,6 +3,7 @@ import type { DecodedImage, ImageDecoder } from '@flighthq/types/contract';
 import {
   clearImageDecoders,
   getImageDecoder,
+  getImageDecoderMimeTypes,
   hasImageDecoder,
   registerImageDecoder,
   unregisterImageDecoder,
@@ -39,6 +40,20 @@ describe('getImageDecoder', () => {
   });
 });
 
+describe('getImageDecoderMimeTypes', () => {
+  it('returns an empty snapshot before registration', () => {
+    expect(getImageDecoderMimeTypes()).toEqual([]);
+  });
+
+  it('returns an insertion-ordered snapshot isolated from the registry', () => {
+    registerImageDecoder('image/png', fakeDecoder);
+    registerImageDecoder('image/jpeg', fakeDecoder);
+    const mimeTypes = getImageDecoderMimeTypes() as string[];
+    mimeTypes.push('image/webp');
+    expect(getImageDecoderMimeTypes()).toEqual(['image/png', 'image/jpeg']);
+  });
+});
+
 describe('hasImageDecoder', () => {
   it('reflects registration state', () => {
     expect(hasImageDecoder('image/png')).toBe(false);

package/src/imageEncoderRegistry.test.ts

@@ -3,6 +3,7 @@ import type { ImageEncoder } from '@flighthq/types/contract';
 import {
   clearImageEncoders,
   getImageEncoder,
+  getImageEncoderMimeTypes,
   hasImageEncoder,
   registerImageEncoder,
   unregisterImageEncoder,
@@ -35,6 +36,20 @@ describe('getImageEncoder', () => {
   });
 });
 
+describe('getImageEncoderMimeTypes', () => {
+  it('returns an empty snapshot before registration', () => {
+    expect(getImageEncoderMimeTypes()).toEqual([]);
+  });
+
+  it('returns an insertion-ordered snapshot isolated from the registry', () => {
+    registerImageEncoder('image/png', fakeEncoder);
+    registerImageEncoder('image/jpeg', fakeEncoder);
+    const mimeTypes = getImageEncoderMimeTypes() as string[];
+    mimeTypes.push('image/webp');
+    expect(getImageEncoderMimeTypes()).toEqual(['image/png', 'image/jpeg']);
+  });
+});
+
 describe('hasImageEncoder', () => {
   it('reflects registration state', () => {
     expect(hasImageEncoder('image/png')).toBe(false);