@flighthq/surface 0.3.0-next.906.07cea63 → 0.5.1-edge.1467.7e2fc7d

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) 2013-2026 Joshua Granick and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @flighthq/surface
+
+Surface allocation, ownership tracking, and lifecycle
+
+## Install
+
+```sh
+npm install @flighthq/surface
+```
+
+Import the supported application-facing API from `@flighthq/surface`. The `@flighthq/surface/contract` export is the wider package-to-package contract used to compose Flight itself.
+
+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/surface@0.5.1-edge.1467.7e2fc7d](https://github.com/flighthq/flight/tree/7e2fc7df5378313ceaf21ba8d6ef39cc18a6f4ad/packages/surface)
+- [License](https://github.com/flighthq/flight/blob/7e2fc7df5378313ceaf21ba8d6ef39cc18a6f4ad/LICENSE.md)

package/dist/canvasSurface.d.ts

@@ -0,0 +1,5 @@
+import type { AppWindow, CanvasSurface, HostCanvasCapability, NativeSurfaceHandle } from '@flighthq/types/contract';
+export declare function createCanvasSurface(capability: Readonly<HostCanvasCapability>, window: Readonly<AppWindow>, width: number, height: number, options?: Readonly<CanvasRenderingContext2DSettings>): CanvasSurface | null;
+export declare function createCanvasSurfaceFromNativeHandle(capability: Readonly<HostCanvasCapability>, handle: NativeSurfaceHandle, options?: Readonly<CanvasRenderingContext2DSettings>): CanvasSurface | null;
+export declare function destroyCanvasSurface(capability: Readonly<HostCanvasCapability>, surface: Readonly<CanvasSurface>): void;
+//# sourceMappingURL=canvasSurface.d.ts.map

package/dist/canvasSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasSurface.d.ts","sourceRoot":"","sources":["../src/canvasSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAEb,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAMlC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAC1C,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,QAAQ,CAAC,gCAAgC,CAAC,GACnD,aAAa,GAAG,IAAI,CAItB;AAGD,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,gCAAgC,CAAC,GACnD,aAAa,GAAG,IAAI,CAOtB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAC1C,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,GAC/B,IAAI,CAEN"}

package/dist/canvasSurface.js

@@ -0,0 +1,24 @@
+import { finishEntity } from '@flighthq/entity/contract';
+import { allocateSurface } from './surface';
+// Allocates a drawable in the given window, sized in device pixels, and acquires a 2D context on it.
+// Returns null when the host cannot rasterize 2D on it.
+export function createCanvasSurface(capability, window, width, height, options) {
+    const handle = capability.create(window, width, height, options);
+    if (handle === null)
+        return null;
+    return createCanvasSurfaceFromNativeHandle(capability, handle, options);
+}
+// Acquires a 2D context on a drawable the caller already owns. The caller keeps ownership of it.
+export function createCanvasSurfaceFromNativeHandle(capability, handle, options) {
+    const surface = allocateSurface(handle);
+    surface.__brand = 'CanvasSurface';
+    const context = capability.acquire(surface, options);
+    if (context === null)
+        return null;
+    surface.context = context;
+    return finishEntity(surface);
+}
+export function destroyCanvasSurface(capability, surface) {
+    capability.release(surface);
+}
+//# sourceMappingURL=canvasSurface.js.map

package/dist/canvasSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasSurface.js","sourceRoot":"","sources":["../src/canvasSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AASzD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,qGAAqG;AACrG,wDAAwD;AACxD,MAAM,UAAU,mBAAmB,CACjC,UAA0C,EAC1C,MAA2B,EAC3B,KAAa,EACb,MAAc,EACd,OAAoD;IAEpD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,mCAAmC,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,mCAAmC,CACjD,UAA0C,EAC1C,MAA2B,EAC3B,OAAoD;IAEpD,MAAM,OAAO,GAAG,eAAe,CAAgB,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,OAAO,GAAG,eAAwB,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,OAAwB,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAA6C,CAAC,OAAO,GAAG,OAAO,CAAC;IACjE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAA0C,EAC1C,OAAgC;IAEhC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/dist/contract.d.ts

@@ -1,42 +1,6 @@
+export * from './canvasSurface';
+export * from './glSurface';
 export * from './surface';
-export * from './surfaceAffine';
-export * from './surfaceAlpha';
-export * from './surfaceBevel';
-export * from './surfaceBlur';
-export * from './surfaceChannel';
-export * from './surfaceColorMatrix';
-export * from './surfaceCompare';
-export * from './surfaceComposite';
-export * from './surfaceConvolution';
-export * from './surfaceCopy';
-export * from './surfaceCoverage';
-export * from './surfaceCrop';
-export * from './surfaceDisplacement';
-export * from './surfaceDissolve';
-export * from './surfaceDraw';
-export * from './surfaceEncode';
-export * from './surfaceFill';
-export * from './surfaceFingerprint';
-export * from './surfaceFlip';
-export * from './surfaceFormat';
-export * from './surfaceFrom';
-export * from './surfaceGradient';
-export * from './surfaceGradientFill';
-export * from './surfaceHistogram';
-export * from './surfaceImageChannel';
-export * from './surfaceMedian';
-export * from './surfaceMorphological';
-export * from './surfaceNoise';
-export * from './surfacePaletteMap';
-export * from './surfacePixel';
-export * from './surfacePixelate';
-export * from './surfaceQuery';
-export * from './surfaceRegion';
-export * from './surfaceResize';
-export * from './surfaceRotate';
-export * from './surfaceShadow';
-export * from './surfaceSharpen';
-export * from './surfaceTone';
-export * from './surfaceTransform';
-export * from './surfaceWarp';
+export * from './surfaceDisplay';
+export * from './wgpuSurface';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/contract.js

@@ -1,42 +1,6 @@
+export * from './canvasSurface';
+export * from './glSurface';
 export * from './surface';
-export * from './surfaceAffine';
-export * from './surfaceAlpha';
-export * from './surfaceBevel';
-export * from './surfaceBlur';
-export * from './surfaceChannel';
-export * from './surfaceColorMatrix';
-export * from './surfaceCompare';
-export * from './surfaceComposite';
-export * from './surfaceConvolution';
-export * from './surfaceCopy';
-export * from './surfaceCoverage';
-export * from './surfaceCrop';
-export * from './surfaceDisplacement';
-export * from './surfaceDissolve';
-export * from './surfaceDraw';
-export * from './surfaceEncode';
-export * from './surfaceFill';
-export * from './surfaceFingerprint';
-export * from './surfaceFlip';
-export * from './surfaceFormat';
-export * from './surfaceFrom';
-export * from './surfaceGradient';
-export * from './surfaceGradientFill';
-export * from './surfaceHistogram';
-export * from './surfaceImageChannel';
-export * from './surfaceMedian';
-export * from './surfaceMorphological';
-export * from './surfaceNoise';
-export * from './surfacePaletteMap';
-export * from './surfacePixel';
-export * from './surfacePixelate';
-export * from './surfaceQuery';
-export * from './surfaceRegion';
-export * from './surfaceResize';
-export * from './surfaceRotate';
-export * from './surfaceShadow';
-export * from './surfaceSharpen';
-export * from './surfaceTone';
-export * from './surfaceTransform';
-export * from './surfaceWarp';
+export * from './surfaceDisplay';
+export * from './wgpuSurface';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/glSurface.d.ts

@@ -0,0 +1,5 @@
+import type { AppWindow, GlContextOptions, GlSurface, HostGlCapability, NativeSurfaceHandle } from '@flighthq/types/contract';
+export declare function createGlSurface(capability: Readonly<HostGlCapability>, window: Readonly<AppWindow>, width: number, height: number, options?: Readonly<GlContextOptions>): GlSurface | null;
+export declare function createGlSurfaceFromNativeHandle(capability: Readonly<HostGlCapability>, handle: NativeSurfaceHandle, options?: Readonly<GlContextOptions>): GlSurface | null;
+export declare function destroyGlSurface(capability: Readonly<HostGlCapability>, surface: Readonly<GlSurface>): void;
+//# sourceMappingURL=glSurface.d.ts.map

package/dist/glSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glSurface.d.ts","sourceRoot":"","sources":["../src/glSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EAET,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAQlC,wBAAgB,eAAe,CAC7B,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACnC,SAAS,GAAG,IAAI,CAIlB;AAID,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACnC,SAAS,GAAG,IAAI,CASlB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAE3G"}

package/dist/glSurface.js

@@ -0,0 +1,29 @@
+import { finishEntity } from '@flighthq/entity/contract';
+import { allocateSurface } from './surface';
+// Allocates a drawable in the given window, sized in device pixels, and acquires a GL context on it. The
+// window is what the host needs to make a drawable at all — the document on web, the SDL_Window on SDL —
+// and is not retained: a surface is not one-to-one with a window, and welding one on would assert that it
+// is. Returns null when the host cannot allocate a drawable or the driver refuses a context.
+export function createGlSurface(capability, window, width, height, options) {
+    const handle = capability.create(window, width, height, options);
+    if (handle === null)
+        return null;
+    return createGlSurfaceFromNativeHandle(capability, handle, options);
+}
+// Acquires a GL context on a drawable the caller already owns — an adopted canvas or native window. The
+// caller keeps ownership of the drawable; destroyGlSurface releases the context, never the drawable.
+export function createGlSurfaceFromNativeHandle(capability, handle, options) {
+    const surface = allocateSurface(handle);
+    surface.__brand = 'GlSurface';
+    // The runtime is already attached, which is all `acquire` reads; the context it returns is the last
+    // field the entity needs before it is finished.
+    const context = capability.acquire(surface, options);
+    if (context === null)
+        return null;
+    surface.context = context;
+    return finishEntity(surface);
+}
+export function destroyGlSurface(capability, surface) {
+    capability.release(surface);
+}
+//# sourceMappingURL=glSurface.js.map

package/dist/glSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glSurface.js","sourceRoot":"","sources":["../src/glSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAUzD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,yGAAyG;AACzG,yGAAyG;AACzG,0GAA0G;AAC1G,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAC7B,UAAsC,EACtC,MAA2B,EAC3B,KAAa,EACb,MAAc,EACd,OAAoC;IAEpC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,+BAA+B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,wGAAwG;AACxG,qGAAqG;AACrG,MAAM,UAAU,+BAA+B,CAC7C,UAAsC,EACtC,MAA2B,EAC3B,OAAoC;IAEpC,MAAM,OAAO,GAAG,eAAe,CAAY,MAAM,CAAC,CAAC;IACnD,OAAO,CAAC,OAAO,GAAG,WAAoB,CAAC;IACvC,oGAAoG;IACpG,gDAAgD;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,OAAoB,EAAE,OAAO,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAyC,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7D,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAsC,EAAE,OAA4B;IACnG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
-export { ImageChannel, SURFACE_NOISE_CHANNEL_A, SURFACE_NOISE_CHANNEL_B, SURFACE_NOISE_CHANNEL_G, SURFACE_NOISE_CHANNEL_R, applySurfaceColorScaleBias, applySurfaceCurve, applySurfaceLevels, applySurfacePaletteMap, applySurfaceThreshold, bevelSurface, blurSurfacePixelsHorizontal, blurSurfacePixelsHorizontalWeighted, blurSurfacePixelsVertical, blurSurfacePixelsVerticalWeighted, boxBlurSurface, buildSurfaceBrightnessColorMatrix, buildSurfaceContrastColorMatrix, buildSurfaceGradientRamp, buildSurfaceGrayscaleColorMatrix, buildSurfaceHueRotationColorMatrix, buildSurfaceInvertColorMatrix, buildSurfaceSaturationColorMatrix, buildSurfaceSepiaColorMatrix, cloneSurface, colorMatrixSurface, compareSurface, compareSurfaceFingerprints, compositeSurfacePixels, compositeSurfaceRegion, computeGaussianKernel, concatSurfaceColorMatrix, convertSurfaceAlphaType, convertSurfacePixelOrder, convolveSurface, copySurfaceAlpha, copySurfaceChannel, copySurfacePixels, createImageResourceFromSurface, createSurface, createSurfaceFingerprint, createSurfaceFromCanvas, createSurfaceFromImageResource, createSurfaceFromImageSource, createSurfaceRegion, cropSurface, dilateSurface, displaceSurface, dissolveSurfacePixels, drawSurface, dropShadowSurface, encodeSurface, equalizeSurfaceHistogram, erodeSurface, extendSurface, extractSurfacePixels, extractSurfacePixels32, fillSurfaceLinearGradient, fillSurfaceNoise, fillSurfacePerlinNoise, fillSurfaceRadialGradient, fillSurfaceRectangle, fillSurfaceTurbulence, flipSurfaceHorizontal, flipSurfaceVertical, floodFillSurface, formatSurfaceFingerprint, gaussianBlurSurface, getSurfaceColorBoundsRectangle, getSurfaceCoverage, getSurfaceHistogram, getSurfaceMismatch, getSurfacePixel, getSurfacePixelChannel, getSurfacePixelLuminance, getSurfacePixelRgb, glowSurface, gradientBevelSurface, gradientGlowSurface, innerGlowSurface, innerShadowSurface, medianSurface, mergeSurface, mergeSurfaceChannels, multiplySurfaceAlpha, parseSurfaceFingerprint, pixelateSurface, premultiplySurfacePixels, resizeSurface, rotateSurface, rotateSurface180, rotateSurfaceClockwise, rotateSurfaceCounterClockwise, scrollSurface, setSurfaceAlpha, setSurfaceColorMatrixIdentity, setSurfacePixel, setSurfacePixelRgb, setSurfaceRegion, sharpenSurface, splitSurfaceChannels, transformSurface, trimSurface, unpremultiplySurfacePixels, warpSurface, warpSurfaceQuad, writeSurfacePixels, writeSurfacePixels32, } from './contract';
+export { createCanvasSurface, createCanvasSurfaceFromNativeHandle, destroyCanvasSurface } from './contract';
+export { createGlSurface, createGlSurfaceFromNativeHandle, destroyGlSurface } from './contract';
+export { createWgpuSurface, createWgpuSurfaceFromNativeHandle, destroyWgpuSurface } from './contract';
+export { resizeSurface, setSurfaceDisplaySize } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,mCAAmC,EACnC,yBAAyB,EACzB,iCAAiC,EACjC,cAAc,EACd,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,EAChC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,4BAA4B,EAC5B,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,EACb,eAAe,EACf,6BAA6B,EAC7B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mCAAmC,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,5 @@
-export { ImageChannel, SURFACE_NOISE_CHANNEL_A, SURFACE_NOISE_CHANNEL_B, SURFACE_NOISE_CHANNEL_G, SURFACE_NOISE_CHANNEL_R, applySurfaceColorScaleBias, applySurfaceCurve, applySurfaceLevels, applySurfacePaletteMap, applySurfaceThreshold, bevelSurface, blurSurfacePixelsHorizontal, blurSurfacePixelsHorizontalWeighted, blurSurfacePixelsVertical, blurSurfacePixelsVerticalWeighted, boxBlurSurface, buildSurfaceBrightnessColorMatrix, buildSurfaceContrastColorMatrix, buildSurfaceGradientRamp, buildSurfaceGrayscaleColorMatrix, buildSurfaceHueRotationColorMatrix, buildSurfaceInvertColorMatrix, buildSurfaceSaturationColorMatrix, buildSurfaceSepiaColorMatrix, cloneSurface, colorMatrixSurface, compareSurface, compareSurfaceFingerprints, compositeSurfacePixels, compositeSurfaceRegion, computeGaussianKernel, concatSurfaceColorMatrix, convertSurfaceAlphaType, convertSurfacePixelOrder, convolveSurface, copySurfaceAlpha, copySurfaceChannel, copySurfacePixels, createImageResourceFromSurface, createSurface, createSurfaceFingerprint, createSurfaceFromCanvas, createSurfaceFromImageResource, createSurfaceFromImageSource, createSurfaceRegion, cropSurface, dilateSurface, displaceSurface, dissolveSurfacePixels, drawSurface, dropShadowSurface, encodeSurface, equalizeSurfaceHistogram, erodeSurface, extendSurface, extractSurfacePixels, extractSurfacePixels32, fillSurfaceLinearGradient, fillSurfaceNoise, fillSurfacePerlinNoise, fillSurfaceRadialGradient, fillSurfaceRectangle, fillSurfaceTurbulence, flipSurfaceHorizontal, flipSurfaceVertical, floodFillSurface, formatSurfaceFingerprint, gaussianBlurSurface, getSurfaceColorBoundsRectangle, getSurfaceCoverage, getSurfaceHistogram, getSurfaceMismatch, getSurfacePixel, getSurfacePixelChannel, getSurfacePixelLuminance, getSurfacePixelRgb, glowSurface, gradientBevelSurface, gradientGlowSurface, innerGlowSurface, innerShadowSurface, medianSurface, mergeSurface, mergeSurfaceChannels, multiplySurfaceAlpha, parseSurfaceFingerprint, pixelateSurface, premultiplySurfacePixels, resizeSurface, rotateSurface, rotateSurface180, rotateSurfaceClockwise, rotateSurfaceCounterClockwise, scrollSurface, setSurfaceAlpha, setSurfaceColorMatrixIdentity, setSurfacePixel, setSurfacePixelRgb, setSurfaceRegion, sharpenSurface, splitSurfaceChannels, transformSurface, trimSurface, unpremultiplySurfacePixels, warpSurface, warpSurfaceQuad, writeSurfacePixels, writeSurfacePixels32, } from './contract';
+export { createCanvasSurface, createCanvasSurfaceFromNativeHandle, destroyCanvasSurface } from './contract';
+export { createGlSurface, createGlSurfaceFromNativeHandle, destroyGlSurface } from './contract';
+export { createWgpuSurface, createWgpuSurfaceFromNativeHandle, destroyWgpuSurface } from './contract';
+export { resizeSurface, setSurfaceDisplaySize } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,2BAA2B,EAC3B,mCAAmC,EACnC,yBAAyB,EACzB,iCAAiC,EACjC,cAAc,EACd,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,EAChC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EACjC,4BAA4B,EAC5B,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,EAC5B,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,EACb,eAAe,EACf,6BAA6B,EAC7B,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mCAAmC,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/surface.d.ts

@@ -1,16 +1,5 @@
-import type { AlphaType, Surface } from '@flighthq/types/contract';
-export declare function cloneSurface(source: Readonly<Surface>): Surface;
-/**
- * Converts the alpha representation of `out` in place between `'straight'` and
- * `'premultiplied'`. If `out.alphaType` already matches `target`, this is a
- * no-op (neither pixel data nor the metadata field changes).
- *
- * - `'straight' → 'premultiplied'`: RGB channels are multiplied by alpha/255.
- * - `'premultiplied' → 'straight'`: RGB channels are divided by alpha/255.
- *   Pixels with alpha=0 are left as `(0,0,0,0)`.
- *
- * Updates `out.alphaType` to `target` after conversion.
- */
-export declare function convertSurfaceAlphaType(out: Surface, target: AlphaType): void;
-export declare function createSurface(width: number, height: number, color?: number): Surface;
+import type { EntityConstruction, NativeSurfaceHandle, Surface, SurfaceRuntime } from '@flighthq/types/contract';
+export declare function allocateSurface<T extends Surface>(handle: NativeSurfaceHandle): EntityConstruction<T>;
+export declare function getSurfaceHandle(surface: Readonly<Surface>): NativeSurfaceHandle;
+export declare function getSurfaceRuntime(surface: Readonly<Surface>): SurfaceRuntime;
 //# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnE,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAY/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6B7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAyBvF"}
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAOjH,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAMrG;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,cAAc,CAE5E"}

package/dist/surface.js

@@ -1,86 +1,22 @@
-import { createEntity } from '@flighthq/entity/contract';
-import { invalidateImageResource } from '@flighthq/image/contract';
-export function cloneSurface(source) {
-    return createEntity({
-        alphaType: source.alphaType,
-        colorSpace: source.colorSpace,
-        compressed: null,
-        data: new Uint8ClampedArray(source.data),
-        format: source.format,
-        height: source.height,
-        source: null,
-        version: 0,
-        width: source.width,
-    });
+import { allocateEntity, createEntityRuntime } from '@flighthq/entity/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+// Allocates a surface entity around a drawable the host just created, before any context is acquired on
+// it. The handle goes on the runtime because it is a platform object that only the allocating host may
+// narrow; the entity carries no trace of it, which is what keeps the portable layers free of DOM and
+// native types. Per-kind factories add their own context field and finish the entity.
+export function allocateSurface(handle) {
+    const surface = allocateEntity();
+    const runtime = createEntityRuntime();
+    runtime.handle = handle;
+    surface[EntityRuntimeKey] = runtime;
+    return surface;
 }
-/**
- * Converts the alpha representation of `out` in place between `'straight'` and
- * `'premultiplied'`. If `out.alphaType` already matches `target`, this is a
- * no-op (neither pixel data nor the metadata field changes).
- *
- * - `'straight' → 'premultiplied'`: RGB channels are multiplied by alpha/255.
- * - `'premultiplied' → 'straight'`: RGB channels are divided by alpha/255.
- *   Pixels with alpha=0 are left as `(0,0,0,0)`.
- *
- * Updates `out.alphaType` to `target` after conversion.
- */
-export function convertSurfaceAlphaType(out, target) {
-    if (out.alphaType === target)
-        return;
-    const data = out.data;
-    const len = out.width * out.height * 4;
-    if (target === 'premultiplied') {
-        for (let i = 0; i < len; i += 4) {
-            const a = data[i + 3] / 255;
-            data[i] = Math.round(data[i] * a);
-            data[i + 1] = Math.round(data[i + 1] * a);
-            data[i + 2] = Math.round(data[i + 2] * a);
-        }
-    }
-    else {
-        for (let i = 0; i < len; i += 4) {
-            const a = data[i + 3];
-            if (a === 0) {
-                data[i] = 0;
-                data[i + 1] = 0;
-                data[i + 2] = 0;
-            }
-            else {
-                const inv = 255 / a;
-                data[i] = Math.min(255, Math.round(data[i] * inv));
-                data[i + 1] = Math.min(255, Math.round(data[i + 1] * inv));
-                data[i + 2] = Math.min(255, Math.round(data[i + 2] * inv));
-            }
-        }
-    }
-    // Mutate the alphaType metadata field.
-    out.alphaType = target;
-    invalidateImageResource(out);
+// The drawable a surface was built around. Hosts narrow this to their own platform type; portable code
+// passes the surface itself and never reads through here.
+export function getSurfaceHandle(surface) {
+    return getSurfaceRuntime(surface).handle;
 }
-export function createSurface(width, height, color = 0) {
-    const data = new Uint8ClampedArray(width * height * 4);
-    if (color !== 0) {
-        const r = (color >>> 24) & 0xff;
-        const g = (color >> 16) & 0xff;
-        const b = (color >> 8) & 0xff;
-        const a = color & 0xff;
-        for (let i = 0; i < data.length; i += 4) {
-            data[i] = r;
-            data[i + 1] = g;
-            data[i + 2] = b;
-            data[i + 3] = a;
-        }
-    }
-    return createEntity({
-        alphaType: 'straight',
-        colorSpace: 'srgb',
-        compressed: null,
-        data,
-        format: 'rgba8unorm',
-        height,
-        source: null,
-        version: 0,
-        width,
-    });
+export function getSurfaceRuntime(surface) {
+    return surface[EntityRuntimeKey];
 }
 //# sourceMappingURL=surface.js.map

package/dist/surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,wGAAwG;AACxG,uGAAuG;AACvG,qGAAqG;AACrG,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAoB,MAA2B;IAC5E,MAAM,OAAO,GAAG,cAAc,EAAK,CAAC;IACpC,MAAM,OAAO,GAAG,mBAAmB,EAAoB,CAAC;IACxD,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uGAAuG;AACvG,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA0B;IAC1D,OAAO,OAAO,CAAC,gBAAgB,CAAmB,CAAC;AACrD,CAAC"}

package/dist/surfaceDisplay.d.ts

@@ -0,0 +1,4 @@
+import type { HostSurfaceDisplayCapability, HostSurfaceResizeCapability, Surface } from '@flighthq/types/contract';
+export declare function resizeSurface(capability: Readonly<HostSurfaceResizeCapability>, surface: Readonly<Surface>, width: number, height: number): void;
+export declare function setSurfaceDisplaySize(capability: Readonly<HostSurfaceDisplayCapability>, surface: Readonly<Surface>, width: number, height: number): void;
+//# sourceMappingURL=surfaceDisplay.d.ts.map

package/dist/surfaceDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDisplay.d.ts","sourceRoot":"","sources":["../src/surfaceDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAInH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,QAAQ,CAAC,2BAA2B,CAAC,EACjD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAEN;AAID,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,QAAQ,CAAC,4BAA4B,CAAC,EAClD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAEN"}

package/dist/surfaceDisplay.js

@@ -0,0 +1,11 @@
+// Resizes a surface's backing store, in device pixels. The context or acquisition reads the new size
+// live, so nothing on the surface has to be updated alongside it.
+export function resizeSurface(capability, surface, width, height) {
+    capability.resize(surface, width, height);
+}
+// Sets the size a surface is presented at, in logical pixels. Independent of the backing-store size: the
+// ratio is the app's render scale, which equals the device pixel ratio only when the app chooses that.
+export function setSurfaceDisplaySize(capability, surface, width, height) {
+    capability.setDisplaySize(surface, width, height);
+}
+//# sourceMappingURL=surfaceDisplay.js.map

package/dist/surfaceDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDisplay.js","sourceRoot":"","sources":["../src/surfaceDisplay.ts"],"names":[],"mappings":"AAEA,qGAAqG;AACrG,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAC3B,UAAiD,EACjD,OAA0B,EAC1B,KAAa,EACb,MAAc;IAEd,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,yGAAyG;AACzG,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CACnC,UAAkD,EAClD,OAA0B,EAC1B,KAAa,EACb,MAAc;IAEd,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/wgpuSurface.d.ts

@@ -0,0 +1,5 @@
+import type { AppWindow, HostWgpuCapability, NativeSurfaceHandle, WgpuHostAcquisitionOptions, WgpuSurface } from '@flighthq/types/contract';
+export declare function createWgpuSurface(capability: Readonly<HostWgpuCapability>, window: Readonly<AppWindow>, width: number, height: number, options?: Readonly<WgpuHostAcquisitionOptions>): Promise<WgpuSurface | null>;
+export declare function createWgpuSurfaceFromNativeHandle(capability: Readonly<HostWgpuCapability>, handle: NativeSurfaceHandle, options?: Readonly<WgpuHostAcquisitionOptions>): Promise<WgpuSurface | null>;
+export declare function destroyWgpuSurface(capability: Readonly<HostWgpuCapability>, surface: Readonly<WgpuSurface>): void;
+//# sourceMappingURL=wgpuSurface.d.ts.map

package/dist/wgpuSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuSurface.d.ts","sourceRoot":"","sources":["../src/wgpuSurface.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EAET,kBAAkB,EAClB,mBAAmB,EAEnB,0BAA0B,EAC1B,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAQlC,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACxC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAI7B;AAGD,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACxC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAC7C,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7B;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAEjH"}

package/dist/wgpuSurface.js

@@ -0,0 +1,30 @@
+import { finishEntity } from '@flighthq/entity/contract';
+import { allocateSurface } from './surface';
+// Allocates a drawable in the given window, sized in device pixels, and acquires a WebGPU device and
+// presentation context for it. Returns null when the environment cannot provide WebGPU at all — no
+// drawable, no adapter, no device — which is an expected outcome on a machine without it rather than API
+// misuse, so it reports through the return value like every other expected failure here.
+export async function createWgpuSurface(capability, window, width, height, options) {
+    const handle = capability.create(window, width, height);
+    if (handle === null)
+        return null;
+    return createWgpuSurfaceFromNativeHandle(capability, handle, options);
+}
+// Acquires a device and presentation context for a drawable the caller already owns.
+export async function createWgpuSurfaceFromNativeHandle(capability, handle, options) {
+    const surface = allocateSurface(handle);
+    surface.__brand = 'WgpuSurface';
+    let acquisition;
+    try {
+        acquisition = await capability.acquire(surface, options ?? {});
+    }
+    catch {
+        return null;
+    }
+    surface.acquisition = acquisition;
+    return finishEntity(surface);
+}
+export function destroyWgpuSurface(capability, surface) {
+    capability.release(surface.acquisition);
+}
+//# sourceMappingURL=wgpuSurface.js.map

package/dist/wgpuSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuSurface.js","sourceRoot":"","sources":["../src/wgpuSurface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAWzD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,qGAAqG;AACrG,mGAAmG;AACnG,yGAAyG;AACzG,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAwC,EACxC,MAA2B,EAC3B,KAAa,EACb,MAAc,EACd,OAA8C;IAE9C,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,iCAAiC,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,UAAwC,EACxC,MAA2B,EAC3B,OAA8C;IAE9C,MAAM,OAAO,GAAG,eAAe,CAAc,MAAM,CAAC,CAAC;IACrD,OAAO,CAAC,OAAO,GAAG,aAAsB,CAAC;IACzC,IAAI,WAAgC,CAAC;IACrC,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAsB,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACA,OAA2C,CAAC,WAAW,GAAG,WAAW,CAAC;IACvE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAwC,EAAE,OAA8B;IACzG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@flighthq/surface",
-  "version": "0.3.0-next.906.07cea63",
+  "version": "0.5.1-edge.1467.7e2fc7d",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,13 +38,12 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/image": "0.3.0-next.906.07cea63",
-    "@flighthq/entity": "0.3.0-next.906.07cea63",
-    "@flighthq/types": "0.3.0-next.906.07cea63"
+    "@flighthq/entity": "0.5.1-edge.1467.7e2fc7d",
+    "@flighthq/types": "0.5.1-edge.1467.7e2fc7d"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Pixel-level image manipulation using browser ImageData",
+  "description": "Surface allocation, ownership tracking, and lifecycle",
   "sideEffects": false
 }

package/src/canvasSurface.test.ts

@@ -0,0 +1,68 @@
+import { finishEntity } from '@flighthq/entity/contract';
+import type { AppWindow, CanvasSurface, Entity, HostCanvasCapability } from '@flighthq/types/contract';
+
+import { createCanvasSurface, createCanvasSurfaceFromNativeHandle, destroyCanvasSurface } from './canvasSurface';
+import { allocateSurface, getSurfaceHandle } from './surface';
+
+function canvasCapability(fields: HostCanvasCapability): HostCanvasCapability {
+  return finishEntity(Object.assign(allocateSurface(null), fields) as never) as unknown as HostCanvasCapability;
+}
+
+const appWindow = {} as AppWindow;
+const context = {} as CanvasRenderingContext2D;
+
+describe('createCanvasSurface', () => {
+  it('allocates a drawable in the window and acquires a 2D context on it', () => {
+    const create = vi.fn(() => 'canvas');
+    const acquire = vi.fn(() => context);
+    const surface = createCanvasSurface(canvasCapability({ acquire, create, release() {} }), appWindow, 320, 240);
+
+    expect(surface!.__brand).toBe('CanvasSurface');
+    expect(surface!.context).toBe(context);
+    expect(getSurfaceHandle(surface!)).toBe('canvas');
+    expect(create).toHaveBeenCalledExactlyOnceWith(appWindow, 320, 240, undefined);
+  });
+
+  it('returns null without acquiring when the window cannot yield a drawable', () => {
+    const acquire = vi.fn(() => context);
+    expect(
+      createCanvasSurface(canvasCapability({ acquire, create: () => null, release() {} }), appWindow, 8, 8),
+    ).toBeNull();
+    expect(acquire).not.toHaveBeenCalled();
+  });
+
+  it('returns null when the drawable cannot rasterize 2D', () => {
+    expect(
+      createCanvasSurface(
+        canvasCapability({ acquire: () => null, create: () => 'canvas', release() {} }),
+        appWindow,
+        8,
+        8,
+      ),
+    ).toBeNull();
+  });
+});
+
+describe('createCanvasSurfaceFromNativeHandle', () => {
+  it('adopts a drawable the caller owns without allocating one', () => {
+    const create = vi.fn(() => 'unused');
+    const surface = createCanvasSurfaceFromNativeHandle(
+      canvasCapability({ acquire: () => context, create, release() {} }),
+      'adopted',
+    );
+
+    expect(getSurfaceHandle(surface!)).toBe('adopted');
+    expect(create).not.toHaveBeenCalled();
+  });
+});
+
+describe('destroyCanvasSurface', () => {
+  it('releases the surface through the capability', () => {
+    const release = vi.fn();
+    const capability = canvasCapability({ acquire: () => context, create: () => 'canvas', release });
+    const surface = createCanvasSurface(capability, appWindow, 8, 8) as CanvasSurface;
+    destroyCanvasSurface(capability, surface);
+
+    expect(release).toHaveBeenCalledExactlyOnceWith(surface);
+  });
+});