@flighthq/render 0.5.1-next.1629.669e7c5 → 0.5.1-next.1680.bdc44c6

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.1-next.1629.669e7c5](https://github.com/flighthq/flight/tree/669e7c57b5177f4dba43dd9e861db543c4d72d2d/packages/render)
-- [License](https://github.com/flighthq/flight/blob/669e7c57b5177f4dba43dd9e861db543c4d72d2d/LICENSE.md)
+- [Source for @flighthq/render@0.5.1-next.1680.bdc44c6](https://github.com/flighthq/flight/tree/bdc44c63675b7c50301154e66b79e2d29d6262da/packages/render)
+- [License](https://github.com/flighthq/flight/blob/bdc44c63675b7c50301154e66b79e2d29d6262da/LICENSE.md)

package/dist/contract.d.ts

@@ -1,3 +1,4 @@
+export * from './mergeRenderOptions';
 export * from './enableColorAdjustmentGuards';
 export * from './enableColorAdjustments';
 export * from './enableSceneRenderGuards';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,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,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,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,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/contract.js

@@ -1,3 +1,4 @@
+export * from './mergeRenderOptions';
 export * from './enableColorAdjustmentGuards';
 export * from './enableColorAdjustments';
 export * from './enableSceneRenderGuards';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,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,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,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,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/imageSurface.d.ts

@@ -1,4 +1,5 @@
-import type { ImageSurface, ImageSurfaceCreator } from '@flighthq/types/contract';
-export declare function createImageSurface(provider: Readonly<ImageSurfaceCreator>, width: number, height: number): ImageSurface | null;
-export declare function destroyImageSurface(surface: ImageSurface): void;
+import type { CanvasSurface, HostCanvasCapability } from '@flighthq/types/contract';
+export declare function createCanvasHostSurface(host: Readonly<HostCanvasCapability>, width: number, height: number): CanvasSurface | null;
+export declare function destroyCanvasHostSurface(surface: CanvasSurface): void;
+export declare function getCanvasHostSurface(surface: CanvasSurface): Readonly<HostCanvasCapability> | null;
 //# sourceMappingURL=imageSurface.d.ts.map

package/dist/imageSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageSurface.d.ts","sourceRoot":"","sources":["../src/imageSurface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAElF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EACvC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,IAAI,CAIrB;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAK/D"}
+{"version":3,"file":"imageSurface.d.ts","sourceRoot":"","sources":["../src/imageSurface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAItB;AAKD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKrE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAElG"}

package/dist/imageSurface.js

@@ -1,18 +1,21 @@
-export function createImageSurface(provider, width, height) {
-    const surface = provider.createImageSurface(width, height);
+export function createCanvasHostSurface(host, width, height) {
+    const surface = host.createSurface(width, height);
     if (surface !== null)
-        _surfaceProviders.set(surface, provider);
+        _surfaceHosts.set(surface, host);
     return surface;
 }
-// A surface must return to the provider that allocated it even when the provider reference 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 destroyImageSurface(surface) {
-    const provider = _surfaceProviders.get(surface);
-    if (provider === undefined)
+// A surface must return to the host that allocated it even when the host reference changes during its
+// lifetime. Delete the ownership record before invoking the host so repeated or reentrant destruction is
+// a no-op and no non-GC resource can be freed twice.
+export function destroyCanvasHostSurface(surface) {
+    const host = _surfaceHosts.get(surface);
+    if (host === undefined)
         return;
-    _surfaceProviders.delete(surface);
-    provider.destroyImageSurface(surface);
+    _surfaceHosts.delete(surface);
+    host.destroySurface(surface);
 }
-const _surfaceProviders = new WeakMap();
+export function getCanvasHostSurface(surface) {
+    return _surfaceHosts.get(surface) ?? null;
+}
+const _surfaceHosts = new WeakMap();
 //# sourceMappingURL=imageSurface.js.map

package/dist/imageSurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageSurface.js","sourceRoot":"","sources":["../src/imageSurface.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,QAAuC,EACvC,KAAa,EACb,MAAc;IAEd,MAAM,OAAO,GAAG,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,IAAI;QAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mGAAmG;AACnG,+FAA+F;AAC/F,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACvD,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,mBAAmB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAA+C,CAAC"}
+{"version":3,"file":"imageSurface.js","sourceRoot":"","sources":["../src/imageSurface.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CACrC,IAAoC,EACpC,KAAa,EACb,MAAc;IAEd,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,IAAI;QAAE,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sGAAsG;AACtG,yGAAyG;AACzG,qDAAqD;AACrD,MAAM,UAAU,wBAAwB,CAAC,OAAsB;IAC7D,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,aAAa,GAAG,IAAI,OAAO,EAAiD,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { mergeRenderOptions } from './mergeRenderOptions';
 export * from './enableColorAdjustments';
 export * from './enableSceneRenderGuards';
 export * from './explainScene2DPipelineCoverage';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACrG,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzE,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACrG,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzE,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { mergeRenderOptions } from './mergeRenderOptions';
 export * from './enableColorAdjustments';
 export * from './enableSceneRenderGuards';
 export * from './explainScene2DPipelineCoverage';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACrG,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzE,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACrG,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzE,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/mergeRenderOptions.d.ts

@@ -0,0 +1,24 @@
+import type { RenderStateOptions } from '@flighthq/types/contract';
+/**
+ * Composes render-state option fragments into one, field by field.
+ *
+ * Every field of `RenderStateOptions` is named explicitly rather than folded by a generic deep merge.
+ * That is the point: a generic merge has to GUESS how an unfamiliar field composes, and it guesses
+ * silently. Naming each field means adding one to `RenderStateOptions` without deciding how it merges
+ * shows up as a compile error here and a failing exhaustiveness test, instead of as a field that
+ * quietly takes the last fragment's value in someone's build.
+ *
+ * The three shapes compose differently, and the difference is load-bearing:
+ *
+ * - **Kind-keyed maps merge**, later fragments winning per key. Two content files naming different
+ *   kinds must both survive; two naming the same kind agree.
+ * - **Nullable policy functions are last-wins scalars.** A tessellator or a guard is one choice, not a
+ *   collection, so the most recently stated fragment is the one the caller asked for.
+ * - **`undefined` never overwrites.** A fragment that does not mention a field is silent about it, which
+ *   is different from a fragment that sets it to null.
+ *
+ * Deterministic and non-mutating: no input map is aliased into the result, and the result depends only
+ * on argument order.
+ */
+export declare function mergeRenderOptions(...options: readonly Readonly<RenderStateOptions>[]): RenderStateOptions;
+//# sourceMappingURL=mergeRenderOptions.d.ts.map

package/dist/mergeRenderOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeRenderOptions.d.ts","sourceRoot":"","sources":["../src/mergeRenderOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,OAAO,EAAE,SAAS,QAAQ,CAAC,kBAAkB,CAAC,EAAE,GAAG,kBAAkB,CAuB1G"}

package/dist/mergeRenderOptions.js

@@ -0,0 +1,49 @@
+/**
+ * Composes render-state option fragments into one, field by field.
+ *
+ * Every field of `RenderStateOptions` is named explicitly rather than folded by a generic deep merge.
+ * That is the point: a generic merge has to GUESS how an unfamiliar field composes, and it guesses
+ * silently. Naming each field means adding one to `RenderStateOptions` without deciding how it merges
+ * shows up as a compile error here and a failing exhaustiveness test, instead of as a field that
+ * quietly takes the last fragment's value in someone's build.
+ *
+ * The three shapes compose differently, and the difference is load-bearing:
+ *
+ * - **Kind-keyed maps merge**, later fragments winning per key. Two content files naming different
+ *   kinds must both survive; two naming the same kind agree.
+ * - **Nullable policy functions are last-wins scalars.** A tessellator or a guard is one choice, not a
+ *   collection, so the most recently stated fragment is the one the caller asked for.
+ * - **`undefined` never overwrites.** A fragment that does not mention a field is silent about it, which
+ *   is different from a fragment that sets it to null.
+ *
+ * Deterministic and non-mutating: no input map is aliased into the result, and the result depends only
+ * on argument order.
+ */
+export function mergeRenderOptions(...options) {
+    const merged = {};
+    for (const fragment of options) {
+        if (fragment.canvasShapeCommands !== undefined) {
+            merged.canvasShapeCommands = new Map([...(merged.canvasShapeCommands ?? []), ...fragment.canvasShapeCommands]);
+        }
+        if (fragment.colorAdjustments !== undefined)
+            merged.colorAdjustments = fragment.colorAdjustments;
+        if (fragment.colorAdjustmentUnsupportedGuard !== undefined) {
+            merged.colorAdjustmentUnsupportedGuard = fragment.colorAdjustmentUnsupportedGuard;
+        }
+        if (fragment.effectPaddingResolvers !== undefined) {
+            merged.effectPaddingResolvers = new Map([
+                ...(merged.effectPaddingResolvers ?? []),
+                ...fragment.effectPaddingResolvers,
+            ]);
+        }
+        if (fragment.nodeRenderers !== undefined) {
+            merged.nodeRenderers = new Map([...(merged.nodeRenderers ?? []), ...fragment.nodeRenderers]);
+        }
+        if (fragment.renderRootGuard !== undefined)
+            merged.renderRootGuard = fragment.renderRootGuard;
+        if (fragment.strokeTessellator !== undefined)
+            merged.strokeTessellator = fragment.strokeTessellator;
+    }
+    return merged;
+}
+//# sourceMappingURL=mergeRenderOptions.js.map

package/dist/mergeRenderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeRenderOptions.js","sourceRoot":"","sources":["../src/mergeRenderOptions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAG,OAAgD;IACpF,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACjH,CAAC;QACD,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS;YAAE,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QACjG,IAAI,QAAQ,CAAC,+BAA+B,KAAK,SAAS,EAAE,CAAC;YAC3D,MAAM,CAAC,+BAA+B,GAAG,QAAQ,CAAC,+BAA+B,CAAC;QACpF,CAAC;QACD,IAAI,QAAQ,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,sBAAsB,GAAG,IAAI,GAAG,CAAC;gBACtC,GAAG,CAAC,MAAM,CAAC,sBAAsB,IAAI,EAAE,CAAC;gBACxC,GAAG,QAAQ,CAAC,sBAAsB;aACnC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;YAAE,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;QAC9F,IAAI,QAAQ,CAAC,iBAAiB,KAAK,SAAS;YAAE,MAAM,CAAC,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;IACtG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/renderState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderState.d.ts","sourceRoot":"","sources":["../src/renderState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,+BAA+B,EAC/B,WAAW,EACX,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAIzE;AAOD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAkB7D;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAO3D;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,WAAW,GAAG,+BAA+B,GAAG,IAAI,CAE7G;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAW9G"}
+{"version":3,"file":"renderState.d.ts","sourceRoot":"","sources":["../src/renderState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,+BAA+B,EAC/B,WAAW,EACX,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAIzE;AAOD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAkB7D;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAO3D;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,WAAW,GAAG,+BAA+B,GAAG,IAAI,CAE7G;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAE5E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAY9G"}

package/dist/renderState.js

@@ -53,7 +53,8 @@ export function initializeRenderState(state, obj) {
     state.currentClipDepth = obj?.currentClipDepth ?? 0;
     state.displayObjectClipHooks = obj?.displayObjectClipHooks ?? null;
     state.pixelRatio = obj?.pixelRatio ?? 1;
-    state.imageSurfaceProvider = obj?.imageSurfaceProvider ?? null;
+    state.canvasHost = obj?.canvasHost ?? null;
+    state.imageHost = obj?.imageHost ?? null;
     state.renderAlpha = obj?.renderAlpha ?? 1;
     state.renderBlendMode = obj?.renderBlendMode ?? BlendMode.Normal;
     state.roundPixels = obj?.roundPixels ?? false;

package/dist/renderState.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/render",
-  "version": "0.5.1-next.1629.669e7c5",
+  "version": "0.5.1-next.1680.bdc44c6",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,18 +38,18 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/adjustments": "0.5.1-next.1629.669e7c5",
-    "@flighthq/camera": "0.5.1-next.1629.669e7c5",
-    "@flighthq/color": "0.5.1-next.1629.669e7c5",
-    "@flighthq/entity": "0.5.1-next.1629.669e7c5",
-    "@flighthq/geometry": "0.5.1-next.1629.669e7c5",
-    "@flighthq/log": "0.5.1-next.1629.669e7c5",
-    "@flighthq/materials": "0.5.1-next.1629.669e7c5",
-    "@flighthq/mesh": "0.5.1-next.1629.669e7c5",
-    "@flighthq/node": "0.5.1-next.1629.669e7c5",
-    "@flighthq/registry": "0.5.1-next.1629.669e7c5",
-    "@flighthq/signals": "0.5.1-next.1629.669e7c5",
-    "@flighthq/types": "0.5.1-next.1629.669e7c5"
+    "@flighthq/adjustments": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/camera": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/color": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/entity": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/geometry": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/log": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/materials": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/mesh": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/node": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/registry": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/signals": "0.5.1-next.1680.bdc44c6",
+    "@flighthq/types": "0.5.1-next.1680.bdc44c6"
   },
   "devDependencies": {
     "@flighthq/scene2d": "*",

package/src/imageSurface.test.ts

@@ -1,74 +1,89 @@
-import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
-import type { Entity, ImageSurface, ImageSurfaceCreator } from '@flighthq/types/contract';
+import type { CanvasSurface, HostCanvasCapability } from '@flighthq/types/contract';
 
-import { createImageSurface, destroyImageSurface } from './imageSurface';
+import { createCanvasHostSurface, destroyCanvasHostSurface, getCanvasHostSurface } from './imageSurface';
 
-function entityProvider(fields: Omit<ImageSurfaceCreator, keyof Entity>): ImageSurfaceCreator {
-  return (() => {
-    const out = allocateEntity<any>();
-    Object.assign(out, fields);
-    return finishEntity(out);
-  })();
+function mockHost(overrides: Partial<HostCanvasCapability> = {}): HostCanvasCapability {
+  return {
+    acquire: () => null,
+    create: () => null,
+    createImageResource: () => ({}) as any,
+    createSurface: overrides.createSurface ?? (() => null),
+    destroySurface: overrides.destroySurface ?? (() => {}),
+    release: () => {},
+    ...overrides,
+  } as HostCanvasCapability;
 }
 
-describe('createImageSurface', () => {
-  it('passes exact dimensions through the given provider and preserves its result', () => {
-    const surface = {} as ImageSurface;
-    const create = vi.fn(() => surface);
-    const provider = entityProvider({ createImageSurface: create, destroyImageSurface() {} });
+describe('createCanvasHostSurface', () => {
+  it('passes exact dimensions through the given host and preserves its result', () => {
+    const surface = {} as CanvasSurface;
+    const createSurface = vi.fn(() => surface);
+    const host = mockHost({ createSurface });
 
-    expect(createImageSurface(provider, 30, 40)).toBe(surface);
-    expect(create).toHaveBeenCalledOnce();
-    expect(create).toHaveBeenCalledWith(30, 40);
+    expect(createCanvasHostSurface(host, 30, 40)).toBe(surface);
+    expect(createSurface).toHaveBeenCalledOnce();
+    expect(createSurface).toHaveBeenCalledWith(30, 40);
   });
 
-  it('preserves provider refusal as expected absence', () => {
-    const provider = entityProvider({ createImageSurface: () => null, destroyImageSurface() {} });
-    expect(createImageSurface(provider, 10, 20)).toBeNull();
+  it('preserves host refusal as expected absence', () => {
+    const host = mockHost({ createSurface: () => null });
+    expect(createCanvasHostSurface(host, 10, 20)).toBeNull();
   });
 });
 
-describe('destroyImageSurface', () => {
-  it('routes each surface to its creator even when different providers were used', () => {
-    const firstSurface = {} as ImageSurface;
-    const secondSurface = {} as ImageSurface;
+describe('destroyCanvasHostSurface', () => {
+  it('routes each surface to its host even when different hosts were used', () => {
+    const firstSurface = {} as CanvasSurface;
+    const secondSurface = {} as CanvasSurface;
     const firstDestroy = vi.fn();
     const secondDestroy = vi.fn();
-    const first = entityProvider({
-      createImageSurface: () => firstSurface,
-      destroyImageSurface: firstDestroy,
-    });
-    const second = entityProvider({
-      createImageSurface: () => secondSurface,
-      destroyImageSurface: secondDestroy,
-    });
+    const first = mockHost({ createSurface: () => firstSurface, destroySurface: firstDestroy });
+    const second = mockHost({ createSurface: () => secondSurface, destroySurface: secondDestroy });
 
-    expect(createImageSurface(first, 10, 20)).toBe(firstSurface);
-    expect(createImageSurface(second, 30, 40)).toBe(secondSurface);
+    expect(createCanvasHostSurface(first, 10, 20)).toBe(firstSurface);
+    expect(createCanvasHostSurface(second, 30, 40)).toBe(secondSurface);
 
-    destroyImageSurface(firstSurface);
-    destroyImageSurface(secondSurface);
+    destroyCanvasHostSurface(firstSurface);
+    destroyCanvasHostSurface(secondSurface);
 
     expect(firstDestroy).toHaveBeenCalledExactlyOnceWith(firstSurface);
     expect(secondDestroy).toHaveBeenCalledExactlyOnceWith(secondSurface);
   });
 
   it('is a no-op after the surface has been destroyed once', () => {
-    const surface = {} as ImageSurface;
-    const destroy = vi.fn();
-    const provider = entityProvider({
-      createImageSurface: () => surface,
-      destroyImageSurface: destroy,
-    });
-    expect(createImageSurface(provider, 10, 20)).toBe(surface);
-
-    destroyImageSurface(surface);
-    destroyImageSurface(surface);
-
-    expect(destroy).toHaveBeenCalledOnce();
+    const surface = {} as CanvasSurface;
+    const destroySurface = vi.fn();
+    const host = mockHost({ createSurface: () => surface, destroySurface });
+    expect(createCanvasHostSurface(host, 10, 20)).toBe(surface);
+
+    destroyCanvasHostSurface(surface);
+    destroyCanvasHostSurface(surface);
+
+    expect(destroySurface).toHaveBeenCalledOnce();
   });
 
   it('is a no-op for an unknown surface', () => {
-    expect(() => destroyImageSurface({} as ImageSurface)).not.toThrow();
+    expect(() => destroyCanvasHostSurface({} as CanvasSurface)).not.toThrow();
+  });
+});
+
+describe('getCanvasHostSurface', () => {
+  it('returns the host that created the surface', () => {
+    const surface = {} as CanvasSurface;
+    const host = mockHost({ createSurface: () => surface });
+    createCanvasHostSurface(host, 1, 1);
+    expect(getCanvasHostSurface(surface)).toBe(host);
+  });
+
+  it('returns null for an unknown surface', () => {
+    expect(getCanvasHostSurface({} as CanvasSurface)).toBeNull();
+  });
+
+  it('returns null after the surface has been destroyed', () => {
+    const surface = {} as CanvasSurface;
+    const host = mockHost({ createSurface: () => surface });
+    createCanvasHostSurface(host, 1, 1);
+    destroyCanvasHostSurface(surface);
+    expect(getCanvasHostSurface(surface)).toBeNull();
   });
 });

package/src/mergeRenderOptions.test.ts

@@ -0,0 +1,79 @@
+import type { RenderStateOptions } from '@flighthq/types/contract';
+
+import { mergeRenderOptions } from './mergeRenderOptions';
+
+// Every field of RenderStateOptions, listed once. The exhaustiveness test below compares this against
+// what the type actually declares, so ADDING A FIELD TO RenderStateOptions FAILS HERE until someone
+// decides how it composes. That is the drift alarm: a silently unmerged field is the failure mode a
+// generic deep merge would have hidden.
+const MAP_FIELDS = ['canvasShapeCommands', 'effectPaddingResolvers', 'nodeRenderers'] as const;
+const LAST_WINS_FIELDS = [
+  'colorAdjustments',
+  'colorAdjustmentUnsupportedGuard',
+  'renderRootGuard',
+  'strokeTessellator',
+] as const;
+
+describe('mergeRenderOptions', () => {
+  it('covers every field RenderStateOptions declares', () => {
+    const probe: Required<RenderStateOptions> = {
+      canvasShapeCommands: new Map(),
+      colorAdjustments: null,
+      colorAdjustmentUnsupportedGuard: null,
+      effectPaddingResolvers: new Map(),
+      nodeRenderers: new Map(),
+      renderRootGuard: null,
+      strokeTessellator: null,
+    };
+    expect(Object.keys(probe).sort()).toEqual([...MAP_FIELDS, ...LAST_WINS_FIELDS].sort());
+  });
+
+  it.each(MAP_FIELDS)('merges %s so entries from both fragments survive', (field) => {
+    const merged = mergeRenderOptions(
+      { [field]: new Map([['A', 'first']]) } as never,
+      { [field]: new Map([['B', 'second']]) } as never,
+    );
+    expect([...(merged[field] as unknown as Map<string, string>).entries()]).toEqual([
+      ['A', 'first'],
+      ['B', 'second'],
+    ]);
+  });
+
+  it.each(MAP_FIELDS)('lets a later fragment win per key in %s', (field) => {
+    const merged = mergeRenderOptions(
+      { [field]: new Map([['A', 'first']]) } as never,
+      { [field]: new Map([['A', 'second']]) } as never,
+    );
+    expect((merged[field] as unknown as Map<string, string>).get('A')).toBe('second');
+  });
+
+  it.each(MAP_FIELDS)('does not alias an input map into the result for %s', (field) => {
+    const input = new Map([['A', 'first']]);
+    const merged = mergeRenderOptions({ [field]: input } as never);
+    (merged[field] as unknown as Map<string, string>).set('B', 'added');
+    expect([...input.keys()]).toEqual(['A']);
+  });
+
+  it.each(LAST_WINS_FIELDS)('takes the last stated value for %s', (field) => {
+    const first = (() => null) as never;
+    const second = (() => null) as never;
+    expect(mergeRenderOptions({ [field]: first } as never, { [field]: second } as never)[field]).toBe(second);
+  });
+
+  it.each([...MAP_FIELDS, ...LAST_WINS_FIELDS])('leaves %s untouched when a later fragment omits it', (field) => {
+    const stated = mergeRenderOptions({ [field]: new Map([['A', 'v']]) } as never, {});
+    expect(stated[field]).toBeDefined();
+  });
+
+  it('distinguishes an omitted field from one explicitly set to null', () => {
+    const tessellator = (() => null) as never;
+    expect(mergeRenderOptions({ strokeTessellator: tessellator }, {}).strokeTessellator).toBe(tessellator);
+    expect(mergeRenderOptions({ strokeTessellator: tessellator }, { strokeTessellator: null }).strokeTessellator).toBe(
+      null,
+    );
+  });
+
+  it('returns an empty object for no fragments', () => {
+    expect(mergeRenderOptions()).toEqual({});
+  });
+});