@flighthq/scene2d-dom 0.3.0-next.906.07cea63 → 0.3.0

package/dist/enableDomTextureResolverGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableDomTextureResolverGuards.js","sourceRoot":"","sources":["../src/enableDomTextureResolverGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAGvG,MAAM,UAAU,kCAAkC,CAAC,KAAqB;IACtE,OAAO,8BAA8B,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAqB;IAClE,0BAA0B,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/explainDomTextureResolution.d.ts

@@ -0,0 +1,3 @@
+import type { DomRenderState, Texture, TextureResolutionExplanation } from '@flighthq/types/contract';
+export declare function explainDomTextureResolution(state: DomRenderState, texture: Readonly<Texture>): TextureResolutionExplanation;
+//# sourceMappingURL=explainDomTextureResolution.d.ts.map

package/dist/explainDomTextureResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainDomTextureResolution.d.ts","sourceRoot":"","sources":["../src/explainDomTextureResolution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAItG,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GACzB,4BAA4B,CAU9B"}

package/dist/explainDomTextureResolution.js

@@ -0,0 +1,14 @@
+import { getTextureSourceKind } from '@flighthq/texture/contract';
+import { getDomRenderStateRuntime } from './domRenderState';
+export function explainDomTextureResolution(state, texture) {
+    const kind = getTextureSourceKind(texture);
+    if (kind === null)
+        return { kind, status: 'missing-kind' };
+    return {
+        kind,
+        status: getDomRenderStateRuntime(state).domTextureResolverRegistry?.has(kind) === true
+            ? 'registered'
+            : 'missing-resolver',
+    };
+}
+//# sourceMappingURL=explainDomTextureResolution.js.map

package/dist/explainDomTextureResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainDomTextureResolution.js","sourceRoot":"","sources":["../src/explainDomTextureResolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,UAAU,2BAA2B,CACzC,KAAqB,EACrB,OAA0B;IAE1B,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC3D,OAAO;QACL,IAAI;QACJ,MAAM,EACJ,wBAAwB,CAAC,KAAK,CAAC,CAAC,0BAA0B,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI;YAC5E,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,kBAAkB;KACzB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export { createDomRenderState, defaultDomBitmapRenderer, defaultDomNativeTextRenderer, defaultDomRichTextRenderer, defaultDomScale9ShapeRenderer, defaultDomShapeRenderer, defaultDomTextLabelRenderer, defaultDomVideoRenderer, enableDomBlendModeSupport, enableDomClipSupport, enableDomRenderCache, enableDomTextInput, renderDomBackground, renderDomScene2D, } from './contract';
+export { createDomRenderState, defaultDomHtmlViewRenderer, defaultDomMorphShapeRenderer, defaultDomNativeTextRenderer, defaultDomRichTextRenderer, defaultDomScale9ShapeRenderer, defaultDomShapeRenderer, defaultDomSpriteRenderer, defaultDomTextLabelRenderer, enableDomBlendModeSupport, enableDomClipSupport, enableDomCssFilterSupport, enableDomRenderCache, enableDomTextInput, enableDomTextureResolverGuards, explainDomTextureResolution, registerDomBitmapTextureResolver, registerDomImageTextureResolver, registerDomTextureResolver, renderDomBackground, renderDomScene2D, setDomCssFilter, } from './contract';
+export { getDomShapeRasterizer, registerDomShapeRasterizer } from './domShapeRasterizer';
 //# 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,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,2BAA2B,EAC3B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export { createDomRenderState, defaultDomBitmapRenderer, defaultDomNativeTextRenderer, defaultDomRichTextRenderer, defaultDomScale9ShapeRenderer, defaultDomShapeRenderer, defaultDomTextLabelRenderer, defaultDomVideoRenderer, enableDomBlendModeSupport, enableDomClipSupport, enableDomRenderCache, enableDomTextInput, renderDomBackground, renderDomScene2D, } from './contract';
+export { createDomRenderState, defaultDomHtmlViewRenderer, defaultDomMorphShapeRenderer, defaultDomNativeTextRenderer, defaultDomRichTextRenderer, defaultDomScale9ShapeRenderer, defaultDomShapeRenderer, defaultDomSpriteRenderer, defaultDomTextLabelRenderer, enableDomBlendModeSupport, enableDomClipSupport, enableDomCssFilterSupport, enableDomRenderCache, enableDomTextInput, enableDomTextureResolverGuards, explainDomTextureResolution, registerDomBitmapTextureResolver, registerDomImageTextureResolver, registerDomTextureResolver, renderDomBackground, renderDomScene2D, setDomCssFilter, } from './contract';
+export { getDomShapeRasterizer, registerDomShapeRasterizer } from './domShapeRasterizer';
 //# 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,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,8BAA8B,EAC9B,2BAA2B,EAC3B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@flighthq/scene2d-dom",
-  "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,21 +38,25 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/color": "0.3.0-next.906.07cea63",
-    "@flighthq/scene2d": "0.3.0-next.906.07cea63",
-    "@flighthq/scene2d-canvas": "0.3.0-next.906.07cea63",
-    "@flighthq/entity": "0.3.0-next.906.07cea63",
-    "@flighthq/geometry": "0.3.0-next.906.07cea63",
-    "@flighthq/image": "0.3.0-next.906.07cea63",
-    "@flighthq/node": "0.3.0-next.906.07cea63",
-    "@flighthq/render": "0.3.0-next.906.07cea63",
-    "@flighthq/shape": "0.3.0-next.906.07cea63",
-    "@flighthq/text": "0.3.0-next.906.07cea63",
-    "@flighthq/textinput": "0.3.0-next.906.07cea63",
-    "@flighthq/textlayout": "0.3.0-next.906.07cea63",
-    "@flighthq/types": "0.3.0-next.906.07cea63"
+    "@flighthq/color": "0.3.0",
+    "@flighthq/scene2d": "0.3.0",
+    "@flighthq/scene2d-canvas": "0.3.0",
+    "@flighthq/entity": "0.3.0",
+    "@flighthq/geometry": "0.3.0",
+    "@flighthq/image": "0.3.0",
+    "@flighthq/log": "0.3.0",
+    "@flighthq/node": "0.3.0",
+    "@flighthq/render": "0.3.0",
+    "@flighthq/signals": "0.3.0",
+    "@flighthq/shape": "0.3.0",
+    "@flighthq/text": "0.3.0",
+    "@flighthq/textinput": "0.3.0",
+    "@flighthq/textlayout": "0.3.0",
+    "@flighthq/texture": "0.3.0",
+    "@flighthq/types": "0.3.0"
   },
   "devDependencies": {
+    "@flighthq/bitmap": "*",
     "@flighthq/image": "*",
     "typescript": "^5.3.0"
   },

package/src/domBitmapTextureResolver.test.ts

@@ -0,0 +1,17 @@
+import { createBitmap } from '@flighthq/bitmap/contract';
+import { createTexture } from '@flighthq/texture/contract';
+
+import { registerDomBitmapTextureResolver } from './domBitmapTextureResolver';
+import { createDomRenderState } from './domRenderState';
+import { resolveDomTexture } from './domTextureResolver';
+
+describe('registerDomBitmapTextureResolver', () => {
+  it('materializes a Bitmap as a canvas source', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const bitmap = createBitmap(2, 2, 0xffffffff);
+    registerDomBitmapTextureResolver(state);
+    expect(resolveDomTexture(state, createTexture({ dimension: '2d', source: bitmap }))).toBeInstanceOf(
+      HTMLCanvasElement,
+    );
+  });
+});

package/src/domHtmlView.test.ts

@@ -3,13 +3,13 @@ import { getOrCreateRenderProxy2D } from '@flighthq/render/contract';
 import { createHtmlView } from '@flighthq/scene2d/contract';
 import { HtmlViewKind } from '@flighthq/types/contract';
 
-import { defaultHtmlViewRenderer, drawDomHtmlView } from './domHtmlView';
+import { defaultDomHtmlViewRenderer, drawDomHtmlView } from './domHtmlView';
 import { createDomRenderState, getDomRenderStateRuntime } from './domRenderState';
 
 function makeState() {
   const container = document.createElement('div');
   const state = createDomRenderState(container);
-  registerRenderer(state, HtmlViewKind, defaultHtmlViewRenderer);
+  registerRenderer(state, HtmlViewKind, defaultDomHtmlViewRenderer);
   return state;
 }
 
@@ -19,10 +19,10 @@ function drawGetEl(state: ReturnType<typeof makeState>, drawFn: () => void): HTM
   return getDomRenderStateRuntime(state).domCurrentElement;
 }
 
-describe('defaultHtmlViewRenderer', () => {
+describe('defaultDomHtmlViewRenderer', () => {
   it('has submit, and createData', () => {
-    expect(typeof defaultHtmlViewRenderer.submit).toBe('function');
-    expect(typeof defaultHtmlViewRenderer.createData).toBe('function');
+    expect(typeof defaultDomHtmlViewRenderer.submit).toBe('function');
+    expect(typeof defaultDomHtmlViewRenderer.createData).toBe('function');
   });
 });
 

package/src/domImageSource.test.ts

@@ -1,47 +1,54 @@
-import { createImageResource, invalidateImageResource } from '@flighthq/image/contract';
-import type { ImageResource } from '@flighthq/types/contract';
+import { createBitmap, invalidateBitmap } from '@flighthq/bitmap/contract';
+import { createImageResource } from '@flighthq/image/contract';
+import { createTexture } from '@flighthq/texture/contract';
 
-import { explainDomImageSource, resolveDomImageSource } from './domImageSource';
+import { registerDomBitmapTextureResolver } from './domBitmapTextureResolver';
+import { explainDomImageSource } from './domImageSource';
+import { registerDomImageTextureResolver } from './domImageTextureResolver';
 import { createDomRenderState } from './domRenderState';
+import { resolveDomTexture } from './domTextureResolver';
 
 function makeState() {
   return createDomRenderState(document.createElement('div'));
 }
 
-function makeDataOnlyResource(width = 4, height = 4): ImageResource {
-  const resource = createImageResource();
-  resource.width = width;
-  resource.height = height;
-  resource.data = new Uint8ClampedArray(width * height * 4).fill(255);
-  return resource;
-}
-
 describe('explainDomImageSource', () => {
-  it('reports element, data, and none for the three representations', () => {
-    expect(explainDomImageSource(createImageResource(document.createElement('img')))).toBe('element');
-    expect(explainDomImageSource(makeDataOnlyResource())).toBe('data');
-    expect(explainDomImageSource(createImageResource())).toBe('none');
+  it('reports element and data for the two drawable representations', () => {
+    expect(explainDomImageSource(createImageResource(globalThis.document.createElement('img')))).toBe('element');
+    expect(explainDomImageSource(createBitmap(4, 4, 0xffffffff))).toBe('data');
   });
 });
 
-describe('resolveDomImageSource', () => {
-  it('returns the host source element directly', () => {
+describe('registerDomBitmapTextureResolver', () => {
+  it('materializes and caches a Bitmap, rebuilding on version bump', () => {
     const state = makeState();
-    const img = document.createElement('img');
-    expect(resolveDomImageSource(state, createImageResource(img))).toBe(img);
+    const bitmap = createBitmap(4, 4, 0xffffffff);
+    const texture = createTexture({ dimension: '2d', source: bitmap });
+    registerDomBitmapTextureResolver(state);
+    const first = resolveDomTexture(state, texture);
+    expect(first).toBeInstanceOf(HTMLCanvasElement);
+    expect(resolveDomTexture(state, texture)).toBe(first);
+    invalidateBitmap(bitmap);
+    expect(resolveDomTexture(state, texture)).not.toBe(first);
   });
+});
 
-  it('materializes and caches a canvas for a data-only resource, rebuilding on version bump', () => {
+describe('registerDomImageTextureResolver', () => {
+  it('returns the host source element directly', () => {
     const state = makeState();
-    const resource = makeDataOnlyResource();
-    const first = resolveDomImageSource(state, resource);
-    expect(first).toBeInstanceOf(HTMLCanvasElement);
-    expect(resolveDomImageSource(state, resource)).toBe(first);
-    invalidateImageResource(resource);
-    expect(resolveDomImageSource(state, resource)).not.toBe(first);
+    const img = document.createElement('img');
+    const texture = createTexture({ dimension: '2d', source: createImageResource(img) });
+    registerDomImageTextureResolver(state);
+    expect(resolveDomTexture(state, texture)).toBe(img);
   });
+});
 
-  it('returns null when the resource carries neither pixels form', () => {
-    expect(resolveDomImageSource(makeState(), createImageResource())).toBeNull();
+describe('resolveDomTexture', () => {
+  it('returns null when no matching source resolver is registered', () => {
+    const texture = createTexture({
+      dimension: '2d',
+      source: createImageResource(globalThis.document.createElement('img')),
+    });
+    expect(resolveDomTexture(makeState(), texture)).toBeNull();
   });
 });

package/src/domImageTextureResolver.test.ts

@@ -0,0 +1,24 @@
+import { createImageResource } from '@flighthq/image/contract';
+import { createTexture } from '@flighthq/texture/contract';
+
+import { registerDomImageTextureResolver } from './domImageTextureResolver';
+import { createDomRenderState } from './domRenderState';
+import { resolveDomTexture } from './domTextureResolver';
+
+describe('registerDomImageTextureResolver', () => {
+  it('returns the host image source directly', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const source = document.createElement('img');
+    const texture = createTexture({ dimension: '2d', source: createImageResource(source) });
+    registerDomImageTextureResolver(state);
+    expect(resolveDomTexture(state, texture)).toBe(source);
+  });
+
+  it('returns a host video through the same image source kind', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const source = document.createElement('video');
+    const texture = createTexture({ dimension: '2d', source: createImageResource(source) });
+    registerDomImageTextureResolver(state);
+    expect(resolveDomTexture(state, texture)).toBe(source);
+  });
+});

package/src/domScale9Shape.test.ts

@@ -3,6 +3,9 @@ import { appendShapeBeginFill, appendShapeRectangle, createScale9Shape } from '@
 
 import { createDomRenderState, getDomRenderStateRuntime } from './domRenderState';
 import { createDomScale9ShapeData, defaultDomScale9ShapeRenderer, drawDomScale9Shape } from './domScale9Shape';
+import { registerDomShapeRasterizer } from './domShapeRasterizer';
+
+const noopRasterizer = (): void => {};
 
 const grid = { height: 80, width: 80, x: 10, y: 10 };
 
@@ -13,6 +16,7 @@ function getCurrentElement(state: ReturnType<typeof createDomRenderState>): HTML
 describe('createDomScale9ShapeData', () => {
   it('creates empty renderer data', () => {
     const state = createDomRenderState(document.createElement('div'));
+    registerDomShapeRasterizer(state, noopRasterizer);
     const shape = createScale9Shape(grid);
 
     const data = createDomScale9ShapeData(state, shape);
@@ -32,6 +36,7 @@ describe('defaultDomScale9ShapeRenderer', () => {
 describe('drawDomScale9Shape', () => {
   it('returns early when commands are empty', () => {
     const state = createDomRenderState(document.createElement('div'));
+    registerDomShapeRasterizer(state, noopRasterizer);
     const shape = createScale9Shape(grid);
     const data = getOrCreateRenderProxy2D(state, shape);
     data.rendererData = createDomScale9ShapeData(state, shape);
@@ -43,6 +48,7 @@ describe('drawDomScale9Shape', () => {
 
   it('returns early when rendererData is null', () => {
     const state = createDomRenderState(document.createElement('div'));
+    registerDomShapeRasterizer(state, noopRasterizer);
     const shape = createScale9Shape(grid);
     appendShapeBeginFill(shape, 0xff0000);
     appendShapeRectangle(shape, 0, 0, 100, 100);
@@ -55,6 +61,7 @@ describe('drawDomScale9Shape', () => {
 
   it('renders remapped commands into a canvas and strips object scale from the transform', () => {
     const state = createDomRenderState(document.createElement('div'));
+    registerDomShapeRasterizer(state, noopRasterizer);
     const shape = createScale9Shape(grid);
     shape.scaleX = 2;
     shape.scaleY = 3;

package/src/domShape.test.ts

@@ -5,15 +5,16 @@ import { appendShapeBeginFill, appendShapeEndFill, appendShapeRectangle, createS
 import { ShapeKind } from '@flighthq/types/contract';
 
 import { createDomRenderState, getDomRenderStateRuntime } from './domRenderState';
-import { defaultDomShapeRenderer, drawDomShape } from './domShape';
+import { defaultDomMorphShapeRenderer, defaultDomShapeRenderer, drawDomShape } from './domShape';
+import { registerDomShapeRasterizer } from './domShapeRasterizer';
 
-beforeAll(() => {
-  registerCanvasShapeCommands(defaultCanvasShapeCommands);
-});
+const noopRasterizer = (): void => {};
 
 function makeState() {
   const container = document.createElement('div');
   const state = createDomRenderState(container);
+  registerCanvasShapeCommands(state, defaultCanvasShapeCommands);
+  registerDomShapeRasterizer(state, noopRasterizer);
   registerRenderer(state, ShapeKind, defaultDomShapeRenderer);
   return state;
 }
@@ -29,6 +30,10 @@ describe('defaultDomShapeRenderer', () => {
     expect(typeof defaultDomShapeRenderer.submit).toBe('function');
     expect(typeof defaultDomShapeRenderer.createData).toBe('function');
   });
+
+  it('provides the MorphShape renderer alias', () => {
+    expect(defaultDomMorphShapeRenderer).toBe(defaultDomShapeRenderer);
+  });
 });
 
 describe('drawDomShape', () => {

package/src/domShapeRasterizer.test.ts

@@ -0,0 +1,32 @@
+import { createRenderState, enableRenderRegistryGuards, explainRenderRegistryMisses } from '@flighthq/render/contract';
+import { RenderRegistry } from '@flighthq/types/contract';
+
+import { createDomRenderState } from './domRenderState';
+import { getDomShapeRasterizer, registerDomShapeRasterizer } from './domShapeRasterizer';
+
+describe('getDomShapeRasterizer', () => {
+  it('reports none until one is registered', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    expect(getDomShapeRasterizer(state)).toBeNull();
+  });
+});
+
+describe('registerDomShapeRasterizer', () => {
+  it('installs the rasterizer the shape path draws non-solid fills through', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const rasterizer = (): void => {};
+
+    registerDomShapeRasterizer(state, rasterizer);
+
+    expect(getDomShapeRasterizer(state)).toBe(rasterizer);
+  });
+
+  it('removes one again, so a state can drop back to tessellation only', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    registerDomShapeRasterizer(state, (): void => {});
+
+    registerDomShapeRasterizer(state, null);
+
+    expect(getDomShapeRasterizer(state)).toBeNull();
+  });
+});

package/src/domSprite.test.ts

@@ -0,0 +1,58 @@
+import { createImageResource, createImageResourceFromCanvas } from '@flighthq/image/contract';
+import { getOrCreateRenderProxy2D, registerRenderer } from '@flighthq/render/contract';
+import { createSprite } from '@flighthq/scene2d/contract';
+import { createTexture } from '@flighthq/texture/contract';
+import { SpriteKind } from '@flighthq/types/contract';
+
+import { registerDomImageTextureResolver } from './domImageTextureResolver';
+import { createDomRenderState, getDomRenderStateRuntime } from './domRenderState';
+import { defaultDomSpriteRenderer, drawDomSprite } from './domSprite';
+
+function drawElement(source: CanvasImageSource): HTMLElement | null {
+  const state = createDomRenderState(document.createElement('div'));
+  registerDomImageTextureResolver(state);
+  registerRenderer(state, SpriteKind, defaultDomSpriteRenderer);
+  const image = createImageResource(source);
+  image.width = 64;
+  image.height = 64;
+  const sprite = createSprite({
+    data: { texture: createTexture({ dimension: '2d', source: image }) },
+  });
+  drawDomSprite(state, getOrCreateRenderProxy2D(state, sprite));
+  return getDomRenderStateRuntime(state).domCurrentElement;
+}
+
+describe('defaultDomSpriteRenderer', () => {
+  it('has submit and createData functions', () => {
+    expect(typeof defaultDomSpriteRenderer.createData).toBe('function');
+    expect(typeof defaultDomSpriteRenderer.isDirty).toBe('function');
+    expect(defaultDomSpriteRenderer.submit).toBe(drawDomSprite);
+  });
+});
+
+describe('drawDomSprite', () => {
+  it('renders an image texture as an img element', () => {
+    const image = document.createElement('img');
+    image.src = 'test.png';
+    expect(drawElement(image)?.tagName).toBe('IMG');
+  });
+
+  it('renders a canvas-backed texture as a canvas element', () => {
+    const canvas = document.createElement('canvas');
+    canvas.width = 64;
+    canvas.height = 64;
+    const image = createImageResourceFromCanvas(canvas);
+    const state = createDomRenderState(document.createElement('div'));
+    registerDomImageTextureResolver(state);
+    registerRenderer(state, SpriteKind, defaultDomSpriteRenderer);
+    const sprite = createSprite({
+      data: { texture: createTexture({ dimension: '2d', source: image }) },
+    });
+    drawDomSprite(state, getOrCreateRenderProxy2D(state, sprite));
+    expect(getDomRenderStateRuntime(state).domCurrentElement?.tagName).toBe('CANVAS');
+  });
+
+  it('uses the source video element directly', () => {
+    expect(drawElement(document.createElement('video'))?.tagName).toBe('VIDEO');
+  });
+});

package/src/domTextureResolver.test.ts

@@ -0,0 +1,28 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { createImageResource } from '@flighthq/image/contract';
+import { createTexture } from '@flighthq/texture/contract';
+import type { TextureSource } from '@flighthq/types/contract';
+
+import { createDomRenderState } from './domRenderState';
+import { registerDomTextureResolver, resolveDomTexture } from './domTextureResolver';
+
+describe('registerDomTextureResolver', () => {
+  it('registers and removes one state-scoped resolver', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const textureSource = createEntity({ height: 1, kind: 'acme.test', version: 0, width: 1 }) as TextureSource;
+    const texture = createTexture({ dimension: '2d', source: textureSource });
+    const canvas = document.createElement('canvas');
+    registerDomTextureResolver(state, 'acme.test', () => canvas);
+    expect(resolveDomTexture(state, texture)).toBe(canvas);
+    registerDomTextureResolver(state, 'acme.test', null);
+    expect(resolveDomTexture(state, texture)).toBeNull();
+  });
+});
+
+describe('resolveDomTexture', () => {
+  it('returns null without a matching resolver', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const image = createImageResource(globalThis.document.createElement('img'));
+    expect(resolveDomTexture(state, createTexture({ dimension: '2d', source: image }))).toBeNull();
+  });
+});

package/src/enableDomTextureResolverGuards.test.ts

@@ -0,0 +1,58 @@
+import { addLogSink, createMemoryLogSink, getMemoryLogSinkEntries, removeLogSink } from '@flighthq/log/contract';
+import { createTexture } from '@flighthq/texture/contract';
+import type { Image } from '@flighthq/types/contract';
+
+import { createDomRenderState } from './domRenderState';
+import { registerDomTextureResolver, resolveDomTexture } from './domTextureResolver';
+import { areDomTextureResolverGuardsEnabled, enableDomTextureResolverGuards } from './enableDomTextureResolverGuards';
+
+describe('areDomTextureResolverGuardsEnabled', () => {
+  it('reports whether diagnostics were installed for the state', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    expect(areDomTextureResolverGuardsEnabled(state)).toBe(false);
+
+    enableDomTextureResolverGuards(state);
+    expect(areDomTextureResolverGuardsEnabled(state)).toBe(true);
+  });
+});
+
+describe('enableDomTextureResolverGuards', () => {
+  it('is idempotent', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    enableDomTextureResolverGuards(state);
+    enableDomTextureResolverGuards(state);
+    expect(areDomTextureResolverGuardsEnabled(state)).toBe(true);
+  });
+
+  it('warns once for a missing resolver and stays silent for a registered resolver returning null', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const missing = textureWithKind('acme.missing.dom');
+    const registered = textureWithKind('acme.registered.dom');
+    const sink = createMemoryLogSink(4);
+    addLogSink(sink.sink);
+    enableDomTextureResolverGuards(state);
+    registerDomTextureResolver(state, 'acme.registered.dom', () => null);
+    try {
+      expect(resolveDomTexture(state, missing)).toBeNull();
+      expect(resolveDomTexture(state, missing)).toBeNull();
+      expect(resolveDomTexture(state, registered)).toBeNull();
+
+      const entries = getMemoryLogSinkEntries(sink);
+      expect(entries).toHaveLength(1);
+      expect(entries[0]?.data).toMatchObject({
+        kind: 'acme.missing.dom',
+        message:
+          'resolveDomTexture: texture source kind has no registered resolver — call registerDomTextureResolver(state, sourceKind, resolver)',
+      });
+    } finally {
+      removeLogSink(sink.sink);
+    }
+  });
+});
+
+function textureWithKind(kind: string) {
+  return createTexture({
+    dimension: '2d',
+    source: { kind } as Image,
+  });
+}

package/src/explainDomTextureResolution.test.ts

@@ -0,0 +1,32 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { createTexture } from '@flighthq/texture/contract';
+import type { TextureSource } from '@flighthq/types/contract';
+
+import { createDomRenderState } from './domRenderState';
+import { registerDomTextureResolver } from './domTextureResolver';
+import { explainDomTextureResolution } from './explainDomTextureResolution';
+
+describe('explainDomTextureResolution', () => {
+  it('distinguishes missing kinds, missing resolvers, and registered resolvers', () => {
+    const state = createDomRenderState(document.createElement('div'));
+    const texture = createTexture({
+      dimension: '2d',
+      source: createEntity({ height: 1, kind: 'acme.test', version: 0, width: 1 }) as TextureSource,
+    });
+
+    expect(explainDomTextureResolution(state, createTexture())).toEqual({
+      kind: null,
+      status: 'missing-kind',
+    });
+    expect(explainDomTextureResolution(state, texture)).toEqual({
+      kind: 'acme.test',
+      status: 'missing-resolver',
+    });
+
+    registerDomTextureResolver(state, 'acme.test', () => null);
+    expect(explainDomTextureResolution(state, texture)).toEqual({
+      kind: 'acme.test',
+      status: 'registered',
+    });
+  });
+});

package/dist/domBitmap.d.ts

@@ -1,4 +0,0 @@
-import type { Scene2DRenderer, DomRenderState, RenderProxy2D } from '@flighthq/types/contract';
-export declare function drawDomBitmap(state: DomRenderState, renderProxy: RenderProxy2D): void;
-export declare const defaultDomBitmapRenderer: Scene2DRenderer;
-//# sourceMappingURL=domBitmap.d.ts.map

package/dist/domBitmap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"domBitmap.d.ts","sourceRoot":"","sources":["../src/domBitmap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EAGd,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAelC,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,GAAG,IAAI,CAkBrF;AAoFD,eAAO,MAAM,wBAAwB,EAAE,eAGtC,CAAC"}

package/dist/domBitmap.js

@@ -1,81 +0,0 @@
-import { createEntity } from '@flighthq/entity/contract';
-import { resolveDomImageSource } from './domImageSource';
-import { applyDomStyle, prepareDomElement, setDomRendererElement } from './domStyle';
-function createDomBitmapData(_state, _source) {
-    return createEntity({ canvas: null, context: null, image: null });
-}
-export function drawDomBitmap(state, renderProxy) {
-    const data = renderProxy.rendererData;
-    if (data === null)
-        return;
-    const source = renderProxy.source;
-    const imageSource = source.data.image;
-    if (imageSource === null)
-        return;
-    // Resolve to a drawable element, materializing one from raw pixels for a data-only Surface.
-    const src = resolveDomImageSource(state, imageSource);
-    if (src === null)
-        return;
-    const sr = source.data.sourceRectangle ?? null;
-    if (sr === null && src instanceof HTMLImageElement) {
-        renderBitmapAsImage(state, renderProxy, data, src);
-    }
-    else {
-        renderBitmapAsCanvas(state, renderProxy, data, imageSource.width, imageSource.height, src, sr);
-    }
-}
-function renderBitmapAsImage(state, renderProxy, data, src) {
-    if (data.canvas !== null) {
-        data.canvas = null;
-        data.context = null;
-    }
-    if (data.image === null) {
-        data.image = document.createElement('img');
-        data.image.crossOrigin = 'anonymous';
-        prepareDomElement(data.image);
-    }
-    if (data.image.src !== src.src) {
-        data.image.src = src.src;
-    }
-    applyDomStyle(state, data.image, renderProxy);
-    setDomRendererElement(state, data.image);
-}
-function renderBitmapAsCanvas(state, renderProxy, data, width, height, src, sourceRectangle = null) {
-    if (data.image !== null) {
-        data.image = null;
-    }
-    if (data.canvas === null) {
-        data.canvas = document.createElement('canvas');
-        data.context = data.canvas.getContext('2d');
-        prepareDomElement(data.canvas);
-    }
-    const source = renderProxy.source;
-    const smoothing = source.data.smoothing && state.allowSmoothing;
-    const drawWidth = sourceRectangle !== null ? sourceRectangle.width : width;
-    const drawHeight = sourceRectangle !== null ? sourceRectangle.height : height;
-    // Size the backing store at physical pixels and constrain layout to logical pixels via CSS so the
-    // bitmap stays crisp on HiDPI displays, matching the canvas backend's createCanvasElement. Resizing
-    // clears the canvas and resets context state, so apply the scale afterward.
-    const pixelRatio = state.pixelRatio;
-    data.canvas.width = drawWidth * pixelRatio;
-    data.canvas.height = drawHeight * pixelRatio;
-    data.canvas.style.width = `${drawWidth}px`;
-    data.canvas.style.height = `${drawHeight}px`;
-    const ctx = data.context;
-    if (pixelRatio !== 1)
-        ctx.scale(pixelRatio, pixelRatio);
-    ctx.imageSmoothingEnabled = smoothing;
-    if (sourceRectangle !== null) {
-        ctx.drawImage(src, sourceRectangle.x, sourceRectangle.y, sourceRectangle.width, sourceRectangle.height, 0, 0, sourceRectangle.width, sourceRectangle.height);
-    }
-    else {
-        ctx.drawImage(src, 0, 0, width, height);
-    }
-    applyDomStyle(state, data.canvas, renderProxy);
-    setDomRendererElement(state, data.canvas);
-}
-export const defaultDomBitmapRenderer = {
-    createData: createDomBitmapData,
-    submit: drawDomBitmap,
-};
-//# sourceMappingURL=domBitmap.js.map