@flighthq/image-codec 0.3.0 → 0.3.1-next.1041.35b950c

package/dist/contract.d.ts

@@ -4,6 +4,7 @@ export * from './encodeImage';
 export * from './explainImageDecodeFailure';
 export * from './explainImageEncodeFailure';
 export * from './imageDecoderRegistry';
+export * from './imageBitmapComposerRegistry';
 export * from './imageEncoderRegistry';
 export * from './registerWebImageDecoders';
 export * from './registerWebImageEncoders';

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,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,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,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}

package/dist/contract.js

@@ -4,6 +4,7 @@ export * from './encodeImage';
 export * from './explainImageDecodeFailure';
 export * from './explainImageEncodeFailure';
 export * from './imageDecoderRegistry';
+export * from './imageBitmapComposerRegistry';
 export * from './imageEncoderRegistry';
 export * from './registerWebImageDecoders';
 export * from './registerWebImageEncoders';

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,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,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,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC"}

package/dist/imageBitmapComposerRegistry.d.ts

@@ -0,0 +1,8 @@
+import type { ImageBitmapComposer } from '@flighthq/types/contract';
+export declare function clearImageBitmapComposers(): void;
+export declare function getImageBitmapComposer(kind: string): ImageBitmapComposer | null;
+export declare function getImageBitmapComposerKinds(): readonly string[];
+export declare function hasImageBitmapComposer(kind: string): boolean;
+export declare function registerImageBitmapComposer(kind: string, composer: ImageBitmapComposer): void;
+export declare function unregisterImageBitmapComposer(kind: string): void;
+//# sourceMappingURL=imageBitmapComposerRegistry.d.ts.map

package/dist/imageBitmapComposerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBitmapComposerRegistry.d.ts","sourceRoot":"","sources":["../src/imageBitmapComposerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAE/E;AAED,wBAAgB,2BAA2B,IAAI,SAAS,MAAM,EAAE,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAE7F;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhE"}

package/dist/imageBitmapComposerRegistry.js

@@ -0,0 +1,23 @@
+export function clearImageBitmapComposers() {
+    composers.clear();
+}
+export function getImageBitmapComposer(kind) {
+    return composers.get(kind) ?? null;
+}
+export function getImageBitmapComposerKinds() {
+    return Array.from(composers.keys());
+}
+export function hasImageBitmapComposer(kind) {
+    return composers.has(kind);
+}
+export function registerImageBitmapComposer(kind, composer) {
+    composers.set(kind, composer);
+}
+export function unregisterImageBitmapComposer(kind) {
+    composers.delete(kind);
+}
+// Open, format-neutral composer registry. A container puts only the stable key and payload bytes on a
+// reference; its package owns the callback that understands those bytes. Last registration wins so an
+// application can replace a built-in producer deliberately without embedding executable state in a scene.
+const composers = new Map();
+//# sourceMappingURL=imageBitmapComposerRegistry.js.map

package/dist/imageBitmapComposerRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBitmapComposerRegistry.js","sourceRoot":"","sources":["../src/imageBitmapComposerRegistry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB;IACvC,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,QAA6B;IACrF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,sGAAsG;AACtG,sGAAsG;AACtG,0GAA0G;AAC1G,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/image-codec",
-  "version": "0.3.0",
+  "version": "0.3.1-next.1041.35b950c",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.3.0"
+    "@flighthq/types": "0.3.1-next.1041.35b950c"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/imageBitmapComposerRegistry.test.ts

@@ -0,0 +1,72 @@
+import type { ImageBitmapComposer } from '@flighthq/types/contract';
+
+import {
+  clearImageBitmapComposers,
+  getImageBitmapComposer,
+  getImageBitmapComposerKinds,
+  hasImageBitmapComposer,
+  registerImageBitmapComposer,
+  unregisterImageBitmapComposer,
+} from './imageBitmapComposerRegistry';
+
+const composer: ImageBitmapComposer = () => null;
+
+afterEach(() => {
+  clearImageBitmapComposers();
+});
+
+describe('clearImageBitmapComposers', () => {
+  it('removes every registered composer', () => {
+    registerImageBitmapComposer('acme/raw-raster', composer);
+    clearImageBitmapComposers();
+
+    expect(hasImageBitmapComposer('acme/raw-raster')).toBe(false);
+  });
+});
+
+describe('getImageBitmapComposer', () => {
+  it('returns the registered composer or null for a missing kind', () => {
+    expect(getImageBitmapComposer('acme/raw-raster')).toBeNull();
+    registerImageBitmapComposer('acme/raw-raster', composer);
+
+    expect(getImageBitmapComposer('acme/raw-raster')).toBe(composer);
+  });
+});
+
+describe('getImageBitmapComposerKinds', () => {
+  it('returns an insertion-ordered enumeration detached from registry state', () => {
+    registerImageBitmapComposer('acme/raw-raster', composer);
+    expect(getImageBitmapComposerKinds()).toEqual(['acme/raw-raster']);
+    (getImageBitmapComposerKinds() as string[]).length = 0;
+
+    expect(getImageBitmapComposerKinds()).toEqual(['acme/raw-raster']);
+  });
+});
+
+describe('hasImageBitmapComposer', () => {
+  it('reports whether a kind is registered', () => {
+    expect(hasImageBitmapComposer('acme/raw-raster')).toBe(false);
+    registerImageBitmapComposer('acme/raw-raster', composer);
+
+    expect(hasImageBitmapComposer('acme/raw-raster')).toBe(true);
+  });
+});
+
+describe('registerImageBitmapComposer', () => {
+  it('uses the final registration for a kind', () => {
+    const replacement: ImageBitmapComposer = () => null;
+    registerImageBitmapComposer('acme/raw-raster', composer);
+    registerImageBitmapComposer('acme/raw-raster', replacement);
+
+    expect(getImageBitmapComposer('acme/raw-raster')).toBe(replacement);
+  });
+});
+
+describe('unregisterImageBitmapComposer', () => {
+  it('removes one registered kind', () => {
+    registerImageBitmapComposer('acme/raw-raster', composer);
+    unregisterImageBitmapComposer('acme/raw-raster');
+
+    expect(getImageBitmapComposer('acme/raw-raster')).toBeNull();
+  });
+});

package/src/registerWebImageDecoders.test.ts

@@ -6,6 +6,12 @@ import { registerWebImageDecoders } from './registerWebImageDecoders';
 // jsdom / node lack createImageBitmap + OffscreenCanvas + Blob; these minimal stand-ins let the
 // canvas decoder run. getImageData always returns straight (non-premultiplied) RGBA, matching the browser.
 const straightPixels = [200, 100, 50, 128];
+let bitmapCloseMock: ReturnType<typeof vi.fn>;
+let createImageBitmapMock: ReturnType<typeof vi.fn>;
+
+class MockBlob {
+  constructor(readonly parts: readonly unknown[]) {}
+}
 
 class MockOffscreenCanvas {
   constructor(
@@ -13,7 +19,8 @@ class MockOffscreenCanvas {
     readonly height: number,
   ) {}
 
-  getContext(): unknown {
+  getContext(contextId: string): unknown {
+    if (contextId !== '2d') return null;
     return {
       drawImage: vi.fn(),
       getImageData: () => ({ data: new Uint8ClampedArray(straightPixels) }),
@@ -22,17 +29,11 @@ class MockOffscreenCanvas {
 }
 
 beforeEach(() => {
-  vi.stubGlobal(
-    'createImageBitmap',
-    vi.fn(async () => ({ width: 1, height: 1, close: vi.fn() })),
-  );
+  bitmapCloseMock = vi.fn();
+  createImageBitmapMock = vi.fn(async () => ({ width: 1, height: 1, close: bitmapCloseMock }));
+  vi.stubGlobal('createImageBitmap', createImageBitmapMock);
   vi.stubGlobal('OffscreenCanvas', MockOffscreenCanvas);
-  vi.stubGlobal(
-    'Blob',
-    class {
-      constructor(readonly parts: readonly unknown[]) {}
-    },
-  );
+  vi.stubGlobal('Blob', MockBlob);
 });
 
 afterEach(() => {
@@ -55,6 +56,18 @@ describe('registerWebImageDecoders', () => {
     expect(result.width).toBe(1);
     expect(result.height).toBe(1);
     expect(Array.from(result.data)).toEqual(straightPixels);
+    expect(bitmapCloseMock).toHaveBeenCalledOnce();
+  });
+
+  it('forwards only the bytes inside the supplied view to createImageBitmap', async () => {
+    registerWebImageDecoders();
+    const decoder = getImageDecoder('image/png');
+    const backing = new Uint8Array([1, 2, 3, 4, 5, 6]);
+
+    await decoder!(backing.subarray(1, 5));
+
+    const blob = createImageBitmapMock.mock.calls[0][0] as MockBlob;
+    expect(Array.from(blob.parts[0] as Uint8Array)).toEqual([2, 3, 4, 5]);
   });
 
   it('premultiplies the straight result when premultiplyAlpha is requested', async () => {

package/src/registerWebImageEncoders.test.ts

@@ -16,7 +16,8 @@ class MockOffscreenCanvas {
     readonly height: number,
   ) {}
 
-  getContext(): unknown {
+  getContext(contextId: string): unknown {
+    if (contextId !== '2d') return null;
     return { putImageData: vi.fn() };
   }
 
@@ -25,22 +26,25 @@ class MockOffscreenCanvas {
   }
 }
 
+class MockImageData {
+  constructor(
+    readonly data: Uint8ClampedArray,
+    readonly width: number,
+    readonly height: number,
+  ) {
+    if (data.length !== width * height * 4) {
+      throw new DOMException('ImageData data length must equal width * height * 4', 'IndexSizeError');
+    }
+  }
+}
+
 function fakeImage(): DecodedImage {
   return { data: new Uint8ClampedArray([10, 20, 30, 255]), width: 1, height: 1 };
 }
 
 beforeEach(() => {
   vi.stubGlobal('OffscreenCanvas', MockOffscreenCanvas);
-  vi.stubGlobal(
-    'ImageData',
-    class {
-      constructor(
-        readonly data: Uint8ClampedArray,
-        readonly width: number,
-        readonly height: number,
-      ) {}
-    },
-  );
+  vi.stubGlobal('ImageData', MockImageData);
 });
 
 afterEach(() => {