@flighthq/application-gl 0.3.0-edge.1458.0c01b63

package/dist/contract.d.ts

@@ -0,0 +1,2 @@
+export * from './glApplicationRenderView';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/contract.js

@@ -0,0 +1,2 @@
+export * from './glApplicationRenderView';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/glApplicationRenderView.d.ts

@@ -0,0 +1,4 @@
+import type { ApplicationWindow, GlApplicationRenderView, GlApplicationRenderViewOptions } from '@flighthq/types/contract';
+export declare function createGlApplicationRenderView(window: ApplicationWindow, canvas: HTMLCanvasElement, options?: Readonly<GlApplicationRenderViewOptions>): GlApplicationRenderView;
+export declare function destroyGlApplicationRenderView(view: GlApplicationRenderView): void;
+//# sourceMappingURL=glApplicationRenderView.d.ts.map

package/dist/glApplicationRenderView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glApplicationRenderView.d.ts","sourceRoot":"","sources":["../src/glApplicationRenderView.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,8BAA8B,EAG/B,MAAM,0BAA0B,CAAC;AAMlC,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,QAAQ,CAAC,8BAA8B,CAAM,GACrD,uBAAuB,CAoBzB;AAID,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAIlF"}

package/dist/glApplicationRenderView.js

@@ -0,0 +1,57 @@
+import { createApplicationRenderView, detachApplicationRenderView } from '@flighthq/application/contract';
+import { createViewport } from '@flighthq/node/contract';
+import { createGlRenderState, createGlRenderTarget, destroyGlRenderState, destroyGlRenderTarget, invalidateGlRenderStateCache, resizeGlRenderTarget, } from '@flighthq/render-gl/contract';
+// Allocates the GL realization of an ApplicationRenderView. Creation does not attach the resize signal;
+// call attachApplicationRenderView explicitly when the window should drive subsequent synchronization.
+// The returned view owns the state and target allocated here; destroy it with
+// destroyGlApplicationRenderView.
+export function createGlApplicationRenderView(window, canvas, options = {}) {
+    const width = Math.max(0, Math.round(window.width * window.devicePixelRatio));
+    const height = Math.max(0, Math.round(window.height * window.devicePixelRatio));
+    synchronizeGlCanvasBackingStore(canvas, width, height);
+    const renderState = createGlRenderState(canvas, {
+        ...options.render,
+        pixelRatio: window.devicePixelRatio,
+    });
+    const renderTarget = createGlRenderTarget(renderState, {
+        ...options.target,
+        height,
+        width,
+    });
+    const viewport = createViewport({
+        devicePixelRatio: window.devicePixelRatio,
+        height,
+        width,
+    });
+    return createApplicationRenderView(window, renderState, renderTarget, viewport, resizeGlApplicationRenderView);
+}
+// Detaches window observation and deterministically frees the target and state owned by
+// createGlApplicationRenderView. The canvas and ApplicationWindow remain caller-owned.
+export function destroyGlApplicationRenderView(view) {
+    detachApplicationRenderView(view);
+    destroyGlRenderTarget(view.renderState, view.renderTarget);
+    destroyGlRenderState(view.renderState);
+}
+function resizeGlApplicationRenderView(renderState, renderTarget, width, height) {
+    if (synchronizeGlCanvasBackingStore(renderState.canvas, width, height)) {
+        invalidateGlRenderStateCache(renderState);
+    }
+    const storageWidth = Math.max(1, Math.ceil(width));
+    const storageHeight = Math.max(1, Math.ceil(height));
+    if (renderTarget.width !== storageWidth || renderTarget.height !== storageHeight) {
+        resizeGlRenderTarget(renderState, renderTarget, width, height);
+    }
+}
+function synchronizeGlCanvasBackingStore(canvas, width, height) {
+    let changed = false;
+    if (canvas.width !== width) {
+        canvas.width = width;
+        changed = true;
+    }
+    if (canvas.height !== height) {
+        canvas.height = height;
+        changed = true;
+    }
+    return changed;
+}
+//# sourceMappingURL=glApplicationRenderView.js.map

package/dist/glApplicationRenderView.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createGlApplicationRenderView, destroyGlApplicationRenderView } from './contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createGlApplicationRenderView, destroyGlApplicationRenderView } from './contract';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@flighthq/application-gl",
+  "version": "0.3.0-edge.1458.0c01b63",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/application-gl"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/application": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/node": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/render-gl": "0.3.0-edge.1458.0c01b63",
+    "@flighthq/types": "0.3.0-edge.1458.0c01b63"
+  },
+  "devDependencies": {
+    "@flighthq/signals": "*",
+    "typescript": "^5.3.0"
+  },
+  "description": "WebGL application render-view assembly linking windows, targets, state, and viewport",
+  "sideEffects": false
+}

package/src/glApplicationRenderView.test.ts

@@ -0,0 +1,118 @@
+import {
+  attachApplicationRenderView,
+  createApplicationWindow,
+  synchronizeApplicationRenderView,
+} from '@flighthq/application/contract';
+import { emitSignal } from '@flighthq/signals/contract';
+import type { GlRenderState, GlRenderTarget } from '@flighthq/types/contract';
+
+import { createGlApplicationRenderView, destroyGlApplicationRenderView } from './glApplicationRenderView';
+
+const mocks = vi.hoisted(() => ({
+  createGlRenderState: vi.fn(),
+  createGlRenderTarget: vi.fn(),
+  createViewport: vi.fn(),
+  destroyGlRenderState: vi.fn(),
+  destroyGlRenderTarget: vi.fn(),
+  invalidateGlRenderStateCache: vi.fn(),
+  resizeGlRenderTarget: vi.fn(),
+}));
+
+vi.mock('@flighthq/node/contract', () => ({
+  createViewport: mocks.createViewport,
+}));
+
+vi.mock('@flighthq/render-gl/contract', () => ({
+  createGlRenderState: mocks.createGlRenderState,
+  createGlRenderTarget: mocks.createGlRenderTarget,
+  destroyGlRenderState: mocks.destroyGlRenderState,
+  destroyGlRenderTarget: mocks.destroyGlRenderTarget,
+  invalidateGlRenderStateCache: mocks.invalidateGlRenderStateCache,
+  resizeGlRenderTarget: mocks.resizeGlRenderTarget,
+}));
+
+beforeEach(() => {
+  mocks.createGlRenderState.mockImplementation((canvas: HTMLCanvasElement, options: { pixelRatio: number }) => ({
+    canvas,
+    pixelRatio: options.pixelRatio,
+    renderTransform2D: { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 },
+  }));
+  mocks.createGlRenderTarget.mockImplementation(
+    (_state: GlRenderState, descriptor: { height: number; width: number }) => ({
+      height: Math.max(1, descriptor.height),
+      width: Math.max(1, descriptor.width),
+    }),
+  );
+  mocks.createViewport.mockImplementation((options) => ({ ...options, x: 0, y: 0 }));
+  mocks.resizeGlRenderTarget.mockImplementation(
+    (_state: GlRenderState, target: GlRenderTarget, width: number, height: number) => {
+      target.width = Math.max(1, width);
+      target.height = Math.max(1, height);
+    },
+  );
+});
+
+describe('createGlApplicationRenderView', () => {
+  it('allocates and links the GL state, target, and device-pixel viewport', () => {
+    const window = createApplicationWindow();
+    window.width = 320;
+    window.height = 180;
+    window.devicePixelRatio = 2;
+    const canvas = document.createElement('canvas');
+
+    const view = createGlApplicationRenderView(window, canvas, {
+      render: { antialias: false },
+      target: { colorSpace: 'linear', depth: 'depth-stencil' },
+    });
+
+    expect(canvas.width).toBe(640);
+    expect(canvas.height).toBe(360);
+    expect(mocks.createGlRenderState).toHaveBeenCalledWith(canvas, { antialias: false, pixelRatio: 2 });
+    expect(mocks.createGlRenderTarget).toHaveBeenCalledWith(view.renderState, {
+      colorSpace: 'linear',
+      depth: 'depth-stencil',
+      height: 360,
+      width: 640,
+    });
+    expect(view.viewport).toMatchObject({ devicePixelRatio: 2, height: 360, width: 640, x: 0, y: 0 });
+  });
+
+  it('changes the backing store and target only when a synchronized window extent changes', () => {
+    const window = createApplicationWindow();
+    window.width = 20;
+    window.height = 10;
+    const canvas = document.createElement('canvas');
+    const view = createGlApplicationRenderView(window, canvas);
+    mocks.invalidateGlRenderStateCache.mockClear();
+    mocks.resizeGlRenderTarget.mockClear();
+
+    synchronizeApplicationRenderView(view);
+    expect(mocks.invalidateGlRenderStateCache).not.toHaveBeenCalled();
+    expect(mocks.resizeGlRenderTarget).not.toHaveBeenCalled();
+
+    window.width = 30;
+    synchronizeApplicationRenderView(view);
+    expect(canvas.width).toBe(30);
+    expect(mocks.invalidateGlRenderStateCache).toHaveBeenCalledWith(view.renderState);
+    expect(mocks.resizeGlRenderTarget).toHaveBeenCalledWith(view.renderState, view.renderTarget, 30, 10);
+  });
+});
+
+describe('destroyGlApplicationRenderView', () => {
+  it('detaches resize observation and destroys the owned target before the state', () => {
+    const window = createApplicationWindow();
+    window.width = 20;
+    window.height = 10;
+    const view = createGlApplicationRenderView(window, document.createElement('canvas'));
+    attachApplicationRenderView(view);
+    mocks.resizeGlRenderTarget.mockClear();
+
+    destroyGlApplicationRenderView(view);
+    window.width = 30;
+    emitSignal(window.onResize);
+
+    expect(mocks.resizeGlRenderTarget).not.toHaveBeenCalled();
+    expect(mocks.destroyGlRenderTarget).toHaveBeenCalledWith(view.renderState, view.renderTarget);
+    expect(mocks.destroyGlRenderState).toHaveBeenCalledWith(view.renderState);
+  });
+});