@flighthq/render 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/render`. The `@fligh
 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/render@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/render)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/render@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/render)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/contract.d.ts

@@ -10,6 +10,7 @@ export * from './renderMaterial';
 export * from './renderProxy';
 export * from './renderProxyAdapter';
 export * from './renderQueue';
+export * from './raster2DSurface';
 export * from './explainScene2DCoverage';
 export * from './renderRegistryGuards';
 export * from './renderRegistrySignals';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/contract.js

@@ -10,6 +10,7 @@ export * from './renderMaterial';
 export * from './renderProxy';
 export * from './renderProxyAdapter';
 export * from './renderQueue';
+export * from './raster2DSurface';
 export * from './explainScene2DCoverage';
 export * from './renderRegistryGuards';
 export * from './renderRegistrySignals';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { areColorAdjustmentsEnabled, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRaster2DSurfaceProvider, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
 export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# 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,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { areColorAdjustmentsEnabled, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, createRaster2DSurface, destroyRaster2DSurface, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRaster2DSurfaceProvider, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
 export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# 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,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/raster2DSurface.d.ts

@@ -0,0 +1,10 @@
+import type { BackendExplanation, Raster2DSurface, Raster2DSurfaceProvider } from '@flighthq/types/contract';
+export declare function createRaster2DSurface(width: number, height: number): Raster2DSurface | null;
+export declare function destroyRaster2DSurface(surface: Raster2DSurface): void;
+export declare function explainRaster2DSurfaceProvider(): BackendExplanation;
+export declare function getRaster2DSurfaceProvider(): Readonly<Raster2DSurfaceProvider>;
+export declare function hasRaster2DSurfaceHostProvider(): boolean;
+export declare function installRaster2DSurfaceHostProvider(provider: Readonly<Raster2DSurfaceProvider>): void;
+export declare function resetRaster2DSurfaceProviderForTest(): void;
+export declare function setRaster2DSurfaceProvider(provider: Readonly<Raster2DSurfaceProvider> | null): void;
+//# sourceMappingURL=raster2DSurface.d.ts.map

package/dist/raster2DSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster2DSurface.d.ts","sourceRoot":"","sources":["../src/raster2DSurface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAE7G,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAK3F;AAKD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAKrE;AAED,wBAAgB,8BAA8B,IAAI,kBAAkB,CAQnE;AAED,wBAAgB,0BAA0B,IAAI,QAAQ,CAAC,uBAAuB,CAAC,CAE9E;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAExD;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAMpG;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAI1D;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,IAAI,GAAG,IAAI,CAEnG"}

package/dist/raster2DSurface.js

@@ -0,0 +1,59 @@
+export function createRaster2DSurface(width, height) {
+    const provider = getRaster2DSurfaceProvider();
+    const surface = provider.createRaster2DSurface(width, height);
+    if (surface !== null)
+        _surfaceProviders.set(surface, provider);
+    return surface;
+}
+// A surface must return to the provider that allocated it even when process-global provider selection
+// changes during its lifetime. Delete the ownership record before invoking the provider so repeated or
+// reentrant destruction is a no-op and no non-GC resource can be freed twice.
+export function destroyRaster2DSurface(surface) {
+    const provider = _surfaceProviders.get(surface);
+    if (provider === undefined)
+        return;
+    _surfaceProviders.delete(surface);
+    provider.destroyRaster2DSurface(surface);
+}
+export function explainRaster2DSurfaceProvider() {
+    if (_custom !== null) {
+        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
+    }
+    if (_host !== null) {
+        return { conflict: _hostConflict, layer: 'host', operation: null, viability: 'unobserved' };
+    }
+    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
+}
+export function getRaster2DSurfaceProvider() {
+    return _custom ?? _host ?? _sentinel;
+}
+export function hasRaster2DSurfaceHostProvider() {
+    return _host !== null;
+}
+export function installRaster2DSurfaceHostProvider(provider) {
+    if (_host !== null) {
+        if (_host !== provider)
+            _hostConflict = true;
+        return;
+    }
+    _host = provider;
+}
+export function resetRaster2DSurfaceProviderForTest() {
+    _custom = null;
+    _host = null;
+    _hostConflict = false;
+}
+export function setRaster2DSurfaceProvider(provider) {
+    _custom = provider;
+}
+const _sentinel = {
+    createRaster2DSurface() {
+        return null;
+    },
+    destroyRaster2DSurface() { },
+};
+const _surfaceProviders = new WeakMap();
+let _custom = null;
+let _host = null;
+let _hostConflict = false;
+//# sourceMappingURL=raster2DSurface.js.map

package/dist/raster2DSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster2DSurface.js","sourceRoot":"","sources":["../src/raster2DSurface.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,MAAc;IACjE,MAAM,QAAQ,GAAG,0BAA0B,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAI,OAAO,KAAK,IAAI;QAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sGAAsG;AACtG,uGAAuG;AACvG,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,OAAwB;IAC7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,IAAI,KAAK,IAAI,SAAS,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,QAA2C;IAC5F,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,KAAK,KAAK,QAAQ;YAAE,aAAa,GAAG,IAAI,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,KAAK,GAAG,QAAQ,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAG,IAAI,CAAC;IACb,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAkD;IAC3F,OAAO,GAAG,QAAQ,CAAC;AACrB,CAAC;AAED,MAAM,SAAS,GAAsC;IACnD,qBAAqB;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,sBAAsB,KAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAsD,CAAC;AAC5F,IAAI,OAAO,GAA6C,IAAI,CAAC;AAC7D,IAAI,KAAK,GAA6C,IAAI,CAAC;AAC3D,IAAI,aAAa,GAAG,KAAK,CAAC"}

package/dist/renderRegistryGuards.js

@@ -64,7 +64,7 @@ function getRenderRegistryMissMessage(state, registry) {
             return 'drawGlShape: a fill this node uses has no tessellated form and no rasterizer is registered, so it does not draw — call registerGlShapeRasterizer(state, createCanvasShapeRasterizer(resolvers))';
         case RenderRegistry.TextureResolver:
             if ('gl' in state)
-                return 'resolveGlTexture: texture source kind has no registered resolver — call registerGlTextureResolver(state, sourceKind, resolver), or copyGlRenderStateRegistrations(offscreenState, screenState) after a late screen registration';
+                return 'resolveGlTexture: texture source kind has no registered resolver — rebuild the GlPipeline with the required resolver and create the render state from that pipeline';
             if ('device' in state)
                 return 'resolveWgpuTexture: texture source kind has no registered resolver — call registerWgpuTextureResolver(state, sourceKind, resolver)';
             if ('element' in state)

package/dist/renderRegistryGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderRegistryGuards.js","sourceRoot":"","sources":["../src/renderRegistryGuards.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"renderRegistryGuards.js","sourceRoot":"","sources":["../src/renderRegistryGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,MAAM,UAAU,8BAA8B,CAAC,KAAkB;IAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAkB;IAC3D,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,OAAO,GAAG,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5B,aAAa,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;QAClF,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAkB;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAkB,EAAE,QAAwB;IAChF,QAAQ,QAAQ,EAAE,CAAC;QACjB,6FAA6F;QAC7F,kCAAkC;QAClC,KAAK,cAAc,CAAC,gBAAgB;YAClC,OAAO,mKAAmK,CAAC;QAC7K,KAAK,cAAc,CAAC,qBAAqB;YACvC,OAAO,8IAA8I,CAAC;QACxJ,6FAA6F;QAC7F,gGAAgG;QAChG,oGAAoG;QACpG,qGAAqG;QACrG,4BAA4B;QAC5B,KAAK,cAAc,CAAC,qBAAqB;YACvC,OAAO,8SAA8S,CAAC;QACxT,kGAAkG;QAClG,8FAA8F;QAC9F,2DAA2D;QAC3D,KAAK,cAAc,CAAC,gBAAgB;YAClC,IAAI,QAAQ,IAAI,KAAK;gBACnB,OAAO,iKAAiK,CAAC;YAC3K,OAAO,6JAA6J,CAAC;QACvK,kGAAkG;QAClG,+FAA+F;QAC/F,oEAAoE;QACpE,KAAK,cAAc,CAAC,eAAe;YACjC,IAAI,QAAQ,IAAI,KAAK;gBACnB,OAAO,gKAAgK,CAAC;YAC1K,OAAO,4JAA4J,CAAC;QACtK,KAAK,cAAc,CAAC,YAAY;YAC9B,OAAO,wGAAwG,CAAC;QAClH,KAAK,cAAc,CAAC,mBAAmB;YACrC,OAAO,wIAAwI,CAAC;QAClJ,sGAAsG;QACtG,KAAK,cAAc,CAAC,eAAe;YACjC,IAAI,QAAQ,IAAI,KAAK;gBACnB,OAAO,qMAAqM,CAAC;YAC/M,IAAI,SAAS,IAAI,KAAK;gBACpB,OAAO,mMAAmM,CAAC;YAC7M,OAAO,iMAAiM,CAAC;QAC3M,KAAK,cAAc,CAAC,eAAe;YACjC,IAAI,IAAI,IAAI,KAAK;gBACf,OAAO,qKAAqK,CAAC;YAC/K,IAAI,QAAQ,IAAI,KAAK;gBACnB,OAAO,oIAAoI,CAAC;YAC9I,IAAI,SAAS,IAAI,KAAK;gBACpB,OAAO,kIAAkI,CAAC;YAC5I,OAAO,mLAAmL,CAAC;IAC/L,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAkB,EAAE,OAAe,EAAE,QAAwB,EAAE,IAAU;IACzG,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO;IAC5G,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChC,OAAO,CACL,wBAAwB,OAAO,IAAI,QAAQ,IAAI,IAAI,EAAE,EACrD,QAAQ,CAAC,IAAI,EACb;QACE,IAAI;QACJ,OAAO,EAAE,4BAA4B,CAAC,KAAK,EAAE,QAAQ,CAAC;QACtD,QAAQ;KACT,EACD,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,OAAO,EAAuB,CAAC;AACrD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAqC,CAAC;AACtE,IAAI,YAAY,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/render",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,17 +38,17 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/adjustments": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/color": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/entity": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/geometry": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/log": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/materials": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/mesh": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/node": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/registry": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/signals": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/adjustments": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/color": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/entity": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/geometry": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/log": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/materials": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/mesh": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/node": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/registry": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/signals": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "@flighthq/camera": "*",

package/src/raster2DSurface.test.ts

@@ -0,0 +1,158 @@
+import type { Raster2DSurface } from '@flighthq/types/contract';
+
+import {
+  createRaster2DSurface,
+  destroyRaster2DSurface,
+  explainRaster2DSurfaceProvider,
+  getRaster2DSurfaceProvider,
+  hasRaster2DSurfaceHostProvider,
+  installRaster2DSurfaceHostProvider,
+  resetRaster2DSurfaceProviderForTest,
+  setRaster2DSurfaceProvider,
+} from './raster2DSurface';
+
+afterEach(() => {
+  resetRaster2DSurfaceProviderForTest();
+});
+
+describe('createRaster2DSurface', () => {
+  it('passes exact dimensions through the selected provider and preserves its result', () => {
+    const surface = {} as Raster2DSurface;
+    const createSurface = vi.fn(() => surface);
+    setRaster2DSurfaceProvider({ createRaster2DSurface: createSurface, destroyRaster2DSurface() {} });
+
+    expect(createRaster2DSurface(30, 40)).toBe(surface);
+    expect(createSurface).toHaveBeenCalledOnce();
+    expect(createSurface).toHaveBeenCalledWith(30, 40);
+  });
+
+  it('preserves provider refusal as expected absence', () => {
+    setRaster2DSurfaceProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+    expect(createRaster2DSurface(10, 20)).toBeNull();
+  });
+});
+
+describe('destroyRaster2DSurface', () => {
+  it('routes each surface to its creator after the selected provider changes', () => {
+    const firstSurface = {} as Raster2DSurface;
+    const secondSurface = {} as Raster2DSurface;
+    const firstDestroy = vi.fn();
+    const secondDestroy = vi.fn();
+    setRaster2DSurfaceProvider({
+      createRaster2DSurface: () => firstSurface,
+      destroyRaster2DSurface: firstDestroy,
+    });
+    expect(createRaster2DSurface(10, 20)).toBe(firstSurface);
+
+    setRaster2DSurfaceProvider({
+      createRaster2DSurface: () => secondSurface,
+      destroyRaster2DSurface: secondDestroy,
+    });
+    expect(createRaster2DSurface(30, 40)).toBe(secondSurface);
+
+    destroyRaster2DSurface(firstSurface);
+    destroyRaster2DSurface(secondSurface);
+
+    expect(firstDestroy).toHaveBeenCalledExactlyOnceWith(firstSurface);
+    expect(secondDestroy).toHaveBeenCalledExactlyOnceWith(secondSurface);
+  });
+
+  it('is a no-op after the creator has destroyed the surface once', () => {
+    const surface = {} as Raster2DSurface;
+    const destroySurface = vi.fn();
+    setRaster2DSurfaceProvider({
+      createRaster2DSurface: () => surface,
+      destroyRaster2DSurface: destroySurface,
+    });
+    expect(createRaster2DSurface(10, 20)).toBe(surface);
+
+    destroyRaster2DSurface(surface);
+    destroyRaster2DSurface(surface);
+
+    expect(destroySurface).toHaveBeenCalledOnce();
+  });
+});
+
+describe('explainRaster2DSurfaceProvider', () => {
+  it('reports the stable sentinel as host-not-enabled', () => {
+    expect(explainRaster2DSurfaceProvider()).toEqual({
+      conflict: false,
+      layer: 'host-not-enabled',
+      operation: null,
+      viability: 'unobserved',
+    });
+  });
+
+  it('reports a competing host installation without replacing the first host', () => {
+    const first = { createRaster2DSurface: () => null, destroyRaster2DSurface() {} };
+    const second = { createRaster2DSurface: () => null, destroyRaster2DSurface() {} };
+    installRaster2DSurfaceHostProvider(first);
+    installRaster2DSurfaceHostProvider(second);
+
+    expect(explainRaster2DSurfaceProvider()).toMatchObject({ conflict: true, layer: 'host' });
+  });
+});
+
+describe('getRaster2DSurfaceProvider', () => {
+  it('uses one stable null-returning sentinel when no provider is installed', () => {
+    const sentinel = getRaster2DSurfaceProvider();
+    expect(getRaster2DSurfaceProvider()).toBe(sentinel);
+    expect(sentinel.createRaster2DSurface(10, 20)).toBeNull();
+  });
+
+  it('selects a custom provider over the host provider', () => {
+    const host = { createRaster2DSurface: () => null, destroyRaster2DSurface() {} };
+    const custom = { createRaster2DSurface: () => null, destroyRaster2DSurface() {} };
+    installRaster2DSurfaceHostProvider(host);
+    setRaster2DSurfaceProvider(custom);
+
+    expect(getRaster2DSurfaceProvider()).toBe(custom);
+  });
+});
+
+describe('hasRaster2DSurfaceHostProvider', () => {
+  it('reports only the host slot', () => {
+    setRaster2DSurfaceProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+    expect(hasRaster2DSurfaceHostProvider()).toBe(false);
+    installRaster2DSurfaceHostProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+    expect(hasRaster2DSurfaceHostProvider()).toBe(true);
+  });
+});
+
+describe('installRaster2DSurfaceHostProvider', () => {
+  it('keeps the first host provider', () => {
+    const first = { createRaster2DSurface: () => null, destroyRaster2DSurface() {} };
+    installRaster2DSurfaceHostProvider(first);
+    installRaster2DSurfaceHostProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+
+    expect(getRaster2DSurfaceProvider()).toBe(first);
+  });
+});
+
+describe('resetRaster2DSurfaceProviderForTest', () => {
+  it('clears custom, host, and conflict state', () => {
+    installRaster2DSurfaceHostProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+    installRaster2DSurfaceHostProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+    setRaster2DSurfaceProvider({ createRaster2DSurface: () => null, destroyRaster2DSurface() {} });
+
+    resetRaster2DSurfaceProviderForTest();
+
+    expect(hasRaster2DSurfaceHostProvider()).toBe(false);
+    expect(explainRaster2DSurfaceProvider()).toMatchObject({ conflict: false, layer: 'host-not-enabled' });
+  });
+});
+
+describe('setRaster2DSurfaceProvider', () => {
+  it('reveals the host provider again when custom is cleared', () => {
+    const hostSurface = { width: 1 } as Raster2DSurface;
+    const customSurface = { width: 2 } as Raster2DSurface;
+    const host = { createRaster2DSurface: () => hostSurface, destroyRaster2DSurface() {} };
+    installRaster2DSurfaceHostProvider(host);
+    setRaster2DSurfaceProvider({ createRaster2DSurface: () => customSurface, destroyRaster2DSurface() {} });
+
+    expect(createRaster2DSurface(1, 1)).toBe(customSurface);
+    setRaster2DSurfaceProvider(null);
+    expect(getRaster2DSurfaceProvider()).toBe(host);
+    expect(createRaster2DSurface(1, 1)).toBe(hostSurface);
+  });
+});