@react-x11/components 0.11.0 → 0.13.0

package/src/html/surfaces.ts

@@ -8,7 +8,7 @@
 import { Surface } from 'react-x11/ntk';
 
 /** ntk's `Surface`, as this uses it. */
-interface SurfaceLike {
+export interface SurfaceLike {
   getContext(kind: '2d'): unknown;
   destroy?(): void;
 }
@@ -18,6 +18,26 @@ interface Kept {
   pixels: number;
 }
 
+/**
+ * A transparent surface of its own, the caller's to destroy once drawn: a
+ * masked element is drawn on one and composited. Null where the backend
+ * has no offscreen surface — the headless mock.
+ */
+export function newSurface(
+  app: unknown,
+  width: number,
+  height: number,
+): SurfaceLike | null {
+  try {
+    return new Surface(app as never, {
+      width,
+      height,
+    }) as unknown as SurfaceLike;
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Surfaces by key, the least recently drawn given up first once they hold
  * more than `budget` pixels. One too large for a quarter of the budget is