@gjsify/webgl 0.48.0 → 0.50.0

package/README.md

@@ -227,6 +227,36 @@ predicted wrongly once — see [Platform coverage](#platform-coverage) above. Ho
 `gjsify run packages/framework/webgl/scripts/probe-gl-host.js`, which also draws a
 shader-free pattern so a blank window cannot be mistaken for a failed shader.
 
+## HiDPI: the two canvas bridges are NOT symmetric
+
+**This asymmetry is a whole bug class, and it is invisible on every machine you are likely to develop on.**
+
+GTK silently pre-scales a `Gtk.DrawingArea`'s Cairo context, so Canvas2D code written in logical pixels renders sharp with nothing to do. `Gtk.GLArea` does **not**: its framebuffer is `allocation x scale-factor` and `gl.viewport` is in raw device pixels.
+
+So the GL side reports the DRAWING BUFFER in device pixels (`canvas.width` / `canvas.height`, hence `gl.drawingBufferWidth`) while CSS layout size stays logical (`clientWidth` / `offsetWidth`), and `installGlobals()` publishes `devicePixelRatio` as an ACCESSOR over the widget's live `get_scale_factor()`. The identity
+
+```
+clientWidth * devicePixelRatio === canvas.width
+```
+
+is what lets an unmodified Three.js or Excalibur viewport cover the whole framebuffer.
+
+Reporting the allocation as `canvas.width` — as this bridge did until 2026-08 — is invisible at scale-factor 1, which is every desktop, every CI runner and every test VM. On the first scale-factor-3 host it drew each scene into the bottom-left NINTH of its widget: measured on a OnePlus 6T running postmarketOS / GNOME Mobile, where the teapot, the pixel-postprocessing and the Excalibur showcases all rendered a 120x218 corner of a 360x655-logical widget.
+
+`@gjsify/dom-elements`' register seeds `devicePixelRatio: 1` as the widget-less default only. A real `Gtk.GLArea` cannot regression-test this, because its host reports 1 — `html-canvas-element.spec.ts` varies the scale factor through a stub, which is the entire point of that stub.
+
+## Naming the GL you actually got
+
+`WEBGL_debug_renderer_info` is implemented (the spec'd `VENDOR` / `RENDERER` stay masked) and `bridge.rendererInfo` reads it, so a CPU rasteriser (`isSoftwareRenderer`) costs ONE stderr line. A GPU-less host is otherwise invisible: every draw call succeeds, and only the frame budget tells.
+
+**It is DIAGNOSTIC ONLY.** The same driver carries a demand-driven three.js scene and needs 1.1 s for a single textured full-screen draw in a game, so a renderer swap keys on a MEASURED frame budget, never on this string.
+
+## Resize, clone and the WebGL2 overrides
+
+- On resize `WebGLBridge` dispatches a DOM `resize` and re-invokes the last rAF callback — demand-driven re-render, no animation loop.
+- A canvas clones PLAIN (`_createCloneTarget`): there is one GLArea and it stays with the original.
+- `WebGL2RenderingContext` overrides `texImage2D`, `texSubImage2D` and `drawElements` from the WebGL1 base, bypassing WebGL1 format/type validation — the native Vala side handles all GLES 3.2 formats.
+
 ## Diagnosing a host
 
 ```bash

package/lib/types/webgl-bridge.d.ts

@@ -128,11 +128,8 @@ export declare const WebGLBridge: {
         $signals: Gtk.GLArea.SignalSignatures;
         _init(...args: any[]): void;
         connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
         connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
-        emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
         vfunc_render(context: Gdk.GLContext): boolean;
         vfunc_resize(width: number, height: number): void;
         attach_buffers(): void;
@@ -632,11 +629,8 @@ export declare const WebGLBridge: {
             $signals: Gtk.GLArea.SignalSignatures;
             _init(...args: any[]): void;
             connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-            connect(signal: string, callback: (...args: any[]) => any): number;
             connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-            connect_after(signal: string, callback: (...args: any[]) => any): number;
-            emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-            emit(signal: string, ...args: any[]): void;
+            emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
             vfunc_render(context: Gdk.GLContext): boolean;
             vfunc_resize(width: number, height: number): void;
             attach_buffers(): void;
@@ -1136,11 +1130,8 @@ export declare const WebGLBridge: {
                 $signals: Gtk.GLArea.SignalSignatures;
                 _init(...args: any[]): void;
                 connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-                connect(signal: string, callback: (...args: any[]) => any): number;
                 connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-                connect_after(signal: string, callback: (...args: any[]) => any): number;
-                emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-                emit(signal: string, ...args: any[]): void;
+                emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
                 vfunc_render(context: Gdk.GLContext): boolean;
                 vfunc_resize(width: number, height: number): void;
                 attach_buffers(): void;
@@ -1640,11 +1631,8 @@ export declare const WebGLBridge: {
                 $signals: Gtk.GLArea.SignalSignatures;
                 _init(...args: any[]): void;
                 connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-                connect(signal: string, callback: (...args: any[]) => any): number;
                 connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-                connect_after(signal: string, callback: (...args: any[]) => any): number;
-                emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-                emit(signal: string, ...args: any[]): void;
+                emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
                 vfunc_render(context: Gdk.GLContext): boolean;
                 vfunc_resize(width: number, height: number): void;
                 attach_buffers(): void;
@@ -2144,11 +2132,8 @@ export declare const WebGLBridge: {
             $signals: Gtk.GLArea.SignalSignatures;
             _init(...args: any[]): void;
             connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-            connect(signal: string, callback: (...args: any[]) => any): number;
             connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-            connect_after(signal: string, callback: (...args: any[]) => any): number;
-            emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-            emit(signal: string, ...args: any[]): void;
+            emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
             vfunc_render(context: Gdk.GLContext): boolean;
             vfunc_resize(width: number, height: number): void;
             attach_buffers(): void;
@@ -2648,11 +2633,8 @@ export declare const WebGLBridge: {
         $signals: Gtk.GLArea.SignalSignatures;
         _init(...args: any[]): void;
         connect<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-        connect(signal: string, callback: (...args: any[]) => any): number;
         connect_after<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, callback: GObject.SignalCallback</*elided*/ any, Gtk.GLArea.SignalSignatures[K]>): number;
-        connect_after(signal: string, callback: (...args: any[]) => any): number;
-        emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]> extends [any, ...infer Q] ? Q : never): void;
-        emit(signal: string, ...args: any[]): void;
+        emit<K extends keyof Gtk.GLArea.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Gtk.GLArea.SignalSignatures[K]>): void;
         vfunc_render(context: Gdk.GLContext): boolean;
         vfunc_resize(width: number, height: number): void;
         attach_buffers(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/webgl",
-    "version": "0.48.0",
+    "version": "0.50.0",
     "description": "WebGL module for Gjs",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -61,21 +61,21 @@
         "WebGL"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.48.0",
-        "@gjsify/unit": "^0.48.0",
+        "@gjsify/cli": "^0.50.0",
+        "@gjsify/unit": "^0.50.0",
         "@types/bit-twiddle": "^1.0.3",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },
     "dependencies": {
-        "@girs/gdkpixbuf-2.0": "4.6.0",
-        "@girs/gjs": "4.6.0",
-        "@girs/gtk-4.0": "4.6.0",
+        "@girs/gdkpixbuf-2.0": "5.0.0",
+        "@girs/gjs": "5.0.0",
+        "@girs/gtk-4.0": "5.0.0",
         "@girs/gwebgl-0.1": "0.1.0-4.0.0-rc.5",
-        "@gjsify/dom-elements": "^0.48.0",
-        "@gjsify/dom-events": "^0.48.0",
-        "@gjsify/event-bridge": "^0.48.0",
-        "@gjsify/utils": "^0.48.0",
+        "@gjsify/dom-elements": "^0.50.0",
+        "@gjsify/dom-events": "^0.50.0",
+        "@gjsify/event-bridge": "^0.50.0",
+        "@gjsify/utils": "^0.50.0",
         "bit-twiddle": "^1.0.2",
         "glsl-tokenizer": "^2.1.5"
     },
@@ -90,13 +90,13 @@
     },
     "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/framework/webgl#readme",
     "optionalDependencies": {
-        "@gjsify/webgl-darwin-arm64": "0.48.0",
-        "@gjsify/webgl-darwin-x64": "0.48.0",
-        "@gjsify/webgl-linux-arm64": "0.48.0",
-        "@gjsify/webgl-linux-ppc64": "0.48.0",
-        "@gjsify/webgl-linux-riscv64": "0.48.0",
-        "@gjsify/webgl-linux-s390x": "0.48.0",
-        "@gjsify/webgl-linux-x64": "0.48.0",
-        "@gjsify/webgl-win32-x64": "0.48.0"
+        "@gjsify/webgl-darwin-arm64": "0.50.0",
+        "@gjsify/webgl-darwin-x64": "0.50.0",
+        "@gjsify/webgl-linux-arm64": "0.50.0",
+        "@gjsify/webgl-linux-ppc64": "0.50.0",
+        "@gjsify/webgl-linux-riscv64": "0.50.0",
+        "@gjsify/webgl-linux-s390x": "0.50.0",
+        "@gjsify/webgl-linux-x64": "0.50.0",
+        "@gjsify/webgl-win32-x64": "0.50.0"
     }
 }