@gjsify/webgl 0.22.0 → 0.23.0

package/README.md

@@ -30,9 +30,43 @@ widget.onReady((canvas, gl) => {
 window.set_child(widget);
 ```
 
+## Globals
+
+The package root is a **side-effect-free barrel** — importing it gives you named
+exports and nothing else. Browser globals are installed by the dedicated
+`/register` subpath:
+
+```typescript
+import '@gjsify/webgl/register';   // globalThis.WebGLRenderingContext, globalThis.WebGL2RenderingContext
+```
+
+You normally never write that import: `gjsify build` defaults to `--globals auto`,
+which detects a free `WebGLRenderingContext` / `WebGL2RenderingContext` reference in
+the bundled output and injects the subpath for you. Application and example code
+should rely on that (see the tree-shakeable-globals convention in `AGENTS.md`) — an
+explicit `/register` import in app code hides auto-detection gaps.
+
+What each entry point gives you:
+
+| | `@gjsify/webgl` | `@gjsify/webgl/register` | `WebGLBridge.installGlobals()` |
+|---|---|---|---|
+| `WebGLRenderingContext`, `WebGL2RenderingContext`, `HTMLCanvasElement`, `WebGLBridge`, the WebGL object + extension classes | named exports | — | — |
+| `globalThis.WebGLRenderingContext`, `globalThis.WebGL2RenderingContext` | — | ✅ (installed only when absent) | ✅ (installed unconditionally) |
+| `globalThis.requestAnimationFrame`, `globalThis.cancelAnimationFrame`, `globalThis.performance` | — | — | ✅ |
+
+The `'webgl'` / `'webgl2'` contexts themselves need no register: this package's
+`HTMLCanvasElement` subclass answers `getContext('webgl')` directly, so a
+`WebGLBridge` works even with `--globals none`.
+
+> **Changed after 0.22.0** — up to and including 0.22.0, `import { WebGLBridge } from '@gjsify/webgl'`
+> installed `WebGLRenderingContext` / `WebGL2RenderingContext` on `globalThis` as an
+> import side effect. They now come from `/register` (or `installGlobals()`). See
+> [ADR 0012](https://github.com/gjsify/gjsify/blob/main/docs/adr/0012-framework-register-ownership.md).
+
 ## Running GJS apps that use this package
 
-This package ships prebuilt native libraries for supported platforms:
+This package ships prebuilt native libraries for the platforms listed under
+[Platform coverage](#platform-coverage) — today that is Linux only:
 
 ```
 prebuilds/
@@ -43,6 +77,9 @@ prebuilds/
   linux-riscv64/  libgwebgl.so + Gwebgl-0.1.typelib
 ```
 
+There is **no macOS or Windows prebuild**; on those platforms `getContext('webgl')`
+has no native backend.
+
 Use the gjsify CLI to run your app — it automatically sets `LD_LIBRARY_PATH` and
 `GI_TYPELIB_PATH` so GJS can find the native library:
 
@@ -86,6 +123,25 @@ to the repository. They are included in the npm package via the `files` field.
 - [stackgl/headless-gl](https://github.com/stackgl/headless-gl)
 - [Maia-Everett/valagl](https://github.com/Maia-Everett/valagl)
 
+## Platform coverage
+
+| Platform | Prebuild | Built by |
+|---|---|---|
+| `linux-x86_64` | ✅ `libgwebgl.so` + `Gwebgl-0.1.typelib` | native runner |
+| `linux-aarch64` | ✅ | native runner |
+| `linux-ppc64`, `linux-s390x`, `linux-riscv64` | ✅ | QEMU emulation |
+| macOS (`darwin-arm64` / `darwin-x64`) | ❌ | **unverified, see below** |
+| Windows | ❌ | — no Vala/GI bridge in this repo targets Windows |
+
+**macOS is not blocked — it is unverified, and a green build would not be enough.** The
+build needs gtk4 + libepoxy + gdk-pixbuf from Homebrew (all available). The real question is
+runtime: GTK4's macOS (Quartz) backend goes through CGL, which tops out at desktop OpenGL 4.1
+Core and offers no GLES 3.2 — the profile this Vala bridge is written against. So compiling
+successfully on macOS would say nothing about whether `Gtk.GLArea` can actually render a
+WebGL2 context there. `meson.build` already emits the correct `.dylib` typelib leaf; the
+manual-dispatch `build-prebuilds-macos-experimental` job in the prebuilds workflow exists to
+establish the compile half of the answer.
+
 ## License
 
 MIT

package/lib/esm/index.js

@@ -1 +1 @@
-import{WebGLContextAttributes as e}from"./webgl-context-attributes.js";import{WebGLUniformLocation as t}from"./webgl-uniform-location.js";import{OESElementIndexUint as n,getOESElementIndexUint as r}from"./extensions/oes-element-index-unit.js";import{OESStandardDerivatives as i,getOESStandardDerivatives as a}from"./extensions/oes-standard-derivatives.js";import{OESTextureFloat as o,getOESTextureFloat as s}from"./extensions/oes-texture-float.js";import{OESTextureFloatLinear as c,getOESTextureFloatLinear as l}from"./extensions/oes-texture-float-linear.js";import{STACKGLDestroyContext as u,getSTACKGLDestroyContext as d}from"./extensions/stackgl-destroy-context.js";import{STACKGLResizeDrawingBuffer as f,getSTACKGLResizeDrawingBuffer as p}from"./extensions/stackgl-resize-drawing-buffer.js";import{EXTBlendMinMax as m,getEXTBlendMinMax as h}from"./extensions/ext-blend-minmax.js";import{EXTColorBufferFloat as g,getEXTColorBufferFloat as _}from"./extensions/ext-color-buffer-float.js";import{EXTColorBufferHalfFloat as v,getEXTColorBufferHalfFloat as y}from"./extensions/ext-color-buffer-half-float.js";import{EXTTextureFilterAnisotropic as b,getEXTTextureFilterAnisotropic as x}from"./extensions/ext-texture-filter-anisotropic.js";import{OESTextureHalfFloat as S,getOESTextureHalfFloat as C}from"./extensions/oes-texture-half-float.js";import{WebGLTextureUnit as w}from"./webgl-texture-unit.js";import{WebGLBuffer as T}from"./webgl-buffer.js";import{WebGLVertexArrayGlobalAttribute as E,WebGLVertexArrayGlobalState as D,WebGLVertexArrayObjectAttribute as O,WebGLVertexArrayObjectState as k}from"./webgl-vertex-attribute.js";import{WebGLFramebuffer as A}from"./webgl-framebuffer.js";import{WebGLProgram as j}from"./webgl-program.js";import{WebGLRenderbuffer as M}from"./webgl-renderbuffer.js";import{WebGLShader as N}from"./webgl-shader.js";import{WebGLTexture as P}from"./webgl-texture.js";import{WebGLDrawingBufferWrapper as F}from"./webgl-drawing-buffer-wrapper.js";import{WebGLShaderPrecisionFormat as I}from"./webgl-shader-precision-format.js";import{WebGLActiveInfo as L}from"./webgl-active-info.js";import{WebGLContextBase as R}from"./webgl-context-base.js";import{WebGLRenderingContext as z}from"./webgl-rendering-context.js";import{WebGLQuery as B}from"./webgl-query.js";import{WebGLSampler as V}from"./webgl-sampler.js";import{WebGLSync as H}from"./webgl-sync.js";import{WebGLTransformFeedback as U}from"./webgl-transform-feedback.js";import{WebGLVertexArrayObject as W}from"./webgl-vertex-array-object.js";import{WebGL2RenderingContext as G}from"./webgl2-rendering-context.js";import{HTMLCanvasElement as K}from"./html-canvas-element.js";import{WebGLBridge as q}from"./webgl-bridge.js";import"@girs/gtk-4.0";import"@girs/gjs";import"@girs/gio-2.0";const J=globalThis;J.WebGLRenderingContext=z,J.WebGL2RenderingContext=G;export{m as EXTBlendMinMax,g as EXTColorBufferFloat,v as EXTColorBufferHalfFloat,b as EXTTextureFilterAnisotropic,K as HTMLCanvasElement,n as OESElementIndexUint,i as OESStandardDerivatives,o as OESTextureFloat,c as OESTextureFloatLinear,S as OESTextureHalfFloat,u as STACKGLDestroyContext,f as STACKGLResizeDrawingBuffer,G as WebGL2RenderingContext,L as WebGLActiveInfo,q as WebGLBridge,T as WebGLBuffer,e as WebGLContextAttributes,R as WebGLContextBase,F as WebGLDrawingBufferWrapper,A as WebGLFramebuffer,j as WebGLProgram,B as WebGLQuery,M as WebGLRenderbuffer,z as WebGLRenderingContext,V as WebGLSampler,N as WebGLShader,I as WebGLShaderPrecisionFormat,H as WebGLSync,P as WebGLTexture,w as WebGLTextureUnit,U as WebGLTransformFeedback,t as WebGLUniformLocation,E as WebGLVertexArrayGlobalAttribute,D as WebGLVertexArrayGlobalState,W as WebGLVertexArrayObject,O as WebGLVertexArrayObjectAttribute,k as WebGLVertexArrayObjectState,h as getEXTBlendMinMax,_ as getEXTColorBufferFloat,y as getEXTColorBufferHalfFloat,x as getEXTTextureFilterAnisotropic,r as getOESElementIndexUint,a as getOESStandardDerivatives,s as getOESTextureFloat,l as getOESTextureFloatLinear,C as getOESTextureHalfFloat,d as getSTACKGLDestroyContext,p as getSTACKGLResizeDrawingBuffer};
+import{WebGLContextAttributes as e}from"./webgl-context-attributes.js";import{WebGLUniformLocation as t}from"./webgl-uniform-location.js";import{OESElementIndexUint as n,getOESElementIndexUint as r}from"./extensions/oes-element-index-unit.js";import{OESStandardDerivatives as i,getOESStandardDerivatives as a}from"./extensions/oes-standard-derivatives.js";import{OESTextureFloat as o,getOESTextureFloat as s}from"./extensions/oes-texture-float.js";import{OESTextureFloatLinear as c,getOESTextureFloatLinear as l}from"./extensions/oes-texture-float-linear.js";import{STACKGLDestroyContext as u,getSTACKGLDestroyContext as d}from"./extensions/stackgl-destroy-context.js";import{STACKGLResizeDrawingBuffer as f,getSTACKGLResizeDrawingBuffer as p}from"./extensions/stackgl-resize-drawing-buffer.js";import{EXTBlendMinMax as m,getEXTBlendMinMax as h}from"./extensions/ext-blend-minmax.js";import{EXTColorBufferFloat as g,getEXTColorBufferFloat as _}from"./extensions/ext-color-buffer-float.js";import{EXTColorBufferHalfFloat as v,getEXTColorBufferHalfFloat as y}from"./extensions/ext-color-buffer-half-float.js";import{EXTTextureFilterAnisotropic as b,getEXTTextureFilterAnisotropic as x}from"./extensions/ext-texture-filter-anisotropic.js";import{OESTextureHalfFloat as S,getOESTextureHalfFloat as C}from"./extensions/oes-texture-half-float.js";import{WebGLTextureUnit as w}from"./webgl-texture-unit.js";import{WebGLBuffer as T}from"./webgl-buffer.js";import{WebGLVertexArrayGlobalAttribute as E,WebGLVertexArrayGlobalState as D,WebGLVertexArrayObjectAttribute as O,WebGLVertexArrayObjectState as k}from"./webgl-vertex-attribute.js";import{WebGLFramebuffer as A}from"./webgl-framebuffer.js";import{WebGLProgram as j}from"./webgl-program.js";import{WebGLRenderbuffer as M}from"./webgl-renderbuffer.js";import{WebGLShader as N}from"./webgl-shader.js";import{WebGLTexture as P}from"./webgl-texture.js";import{WebGLDrawingBufferWrapper as F}from"./webgl-drawing-buffer-wrapper.js";import{WebGLShaderPrecisionFormat as I}from"./webgl-shader-precision-format.js";import{WebGLActiveInfo as L}from"./webgl-active-info.js";import{WebGLContextBase as R}from"./webgl-context-base.js";import{WebGLRenderingContext as z}from"./webgl-rendering-context.js";import{WebGLQuery as B}from"./webgl-query.js";import{WebGLSampler as V}from"./webgl-sampler.js";import{WebGLSync as H}from"./webgl-sync.js";import{WebGLTransformFeedback as U}from"./webgl-transform-feedback.js";import{WebGLVertexArrayObject as W}from"./webgl-vertex-array-object.js";import{WebGL2RenderingContext as G}from"./webgl2-rendering-context.js";import{HTMLCanvasElement as K}from"./html-canvas-element.js";import{WebGLBridge as q}from"./webgl-bridge.js";import"@girs/gtk-4.0";import"@girs/gjs";import"@girs/gio-2.0";export{m as EXTBlendMinMax,g as EXTColorBufferFloat,v as EXTColorBufferHalfFloat,b as EXTTextureFilterAnisotropic,K as HTMLCanvasElement,n as OESElementIndexUint,i as OESStandardDerivatives,o as OESTextureFloat,c as OESTextureFloatLinear,S as OESTextureHalfFloat,u as STACKGLDestroyContext,f as STACKGLResizeDrawingBuffer,G as WebGL2RenderingContext,L as WebGLActiveInfo,q as WebGLBridge,T as WebGLBuffer,e as WebGLContextAttributes,R as WebGLContextBase,F as WebGLDrawingBufferWrapper,A as WebGLFramebuffer,j as WebGLProgram,B as WebGLQuery,M as WebGLRenderbuffer,z as WebGLRenderingContext,V as WebGLSampler,N as WebGLShader,I as WebGLShaderPrecisionFormat,H as WebGLSync,P as WebGLTexture,w as WebGLTextureUnit,U as WebGLTransformFeedback,t as WebGLUniformLocation,E as WebGLVertexArrayGlobalAttribute,D as WebGLVertexArrayGlobalState,W as WebGLVertexArrayObject,O as WebGLVertexArrayObjectAttribute,k as WebGLVertexArrayObjectState,h as getEXTBlendMinMax,_ as getEXTColorBufferFloat,y as getEXTColorBufferHalfFloat,x as getEXTTextureFilterAnisotropic,r as getOESElementIndexUint,a as getOESStandardDerivatives,s as getOESTextureFloat,l as getOESTextureFloatLinear,C as getOESTextureHalfFloat,d as getSTACKGLDestroyContext,p as getSTACKGLResizeDrawingBuffer};

package/lib/esm/register.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";import{WebGLRenderingContext as e}from"./webgl-rendering-context.js";import{WebGL2RenderingContext as t}from"./webgl2-rendering-context.js";function defineGlobalIfMissing(e,t){globalThis[e]===void 0&&Object.defineProperty(globalThis,e,{value:t,writable:!0,configurable:!0})}defineGlobalIfMissing(`WebGLRenderingContext`,e),defineGlobalIfMissing(`WebGL2RenderingContext`,t);

package/lib/esm/register.spec.js

@@ -0,0 +1 @@
+import{__name as e}from"./_virtual/_rolldown/runtime.js";import{describe as t,expect as n,it as r,on as i}from"@gjsify/unit";import{WebGL2RenderingContext as a,WebGLContextBase as o,WebGLRenderingContext as s}from"@gjsify/webgl";import"@gjsify/webgl/register";var c=e(async()=>{await i(`Gjs`,async()=>{await t(`@gjsify/webgl/register — owned globals`,async()=>{await r(`installs WebGLRenderingContext on globalThis`,async()=>{let e=globalThis;n(typeof e.WebGLRenderingContext).toBe(`function`),n(e.WebGLRenderingContext).toBe(s)}),await r(`installs WebGL2RenderingContext on globalThis`,async()=>{let e=globalThis;n(typeof e.WebGL2RenderingContext).toBe(`function`),n(e.WebGL2RenderingContext).toBe(a)}),await r(`installs two distinct constructors over the shared context base`,async()=>{let e=globalThis,t=e.WebGLRenderingContext,r=e.WebGL2RenderingContext;n(t).not.toBe(r),n(Object.getPrototypeOf(t.prototype)).toBe(o.prototype),n(Object.getPrototypeOf(r.prototype)).toBe(o.prototype)})}),await t(`@gjsify/webgl/register — idempotency`,async()=>{for(let e of[`WebGLRenderingContext`,`WebGL2RenderingContext`])await r(`${e} is installed writable + configurable`,async()=>{let t=Object.getOwnPropertyDescriptor(globalThis,e);n(t).toBeDefined(),n(t?.writable).toBe(!0),n(t?.configurable).toBe(!0)}),await r(`re-defining ${e} does not throw`,async()=>{let t=Object.getOwnPropertyDescriptor(globalThis,e),r=!1;try{Object.defineProperty(globalThis,e,t)}catch{r=!0}n(r).toBe(!1)})})})},`default`);export{c as default};

package/lib/esm/test.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import e from"./webgl1.spec.js";import t from"./webgl2.spec.js";import{run as n}from"@gjsify/unit";n({testSuite:async()=>{await e(),await t()}});
+import"./_virtual/_rolldown/runtime.js";import e from"./register.spec.js";import t from"./webgl1.spec.js";import n from"./webgl2.spec.js";import{run as r}from"@gjsify/unit";r({testSuite:async()=>{await t(),await n()},registerSuite:e});

package/lib/esm/webgl-bridge.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{HTMLCanvasElement as e}from"./html-canvas-element.js";import{notifyElementResize as t}from"@gjsify/dom-elements";import n from"gi://GObject";import r from"gi://GLib?version=2.0";import i from"gi://Gtk?version=4.0";import{attachEventControllers as a}from"@gjsify/event-bridge";import{Event as o}from"@gjsify/dom-events";const s=n.registerClass({GTypeName:`GjsifyWebGLBridge`},class WebGLBridge extends i.GLArea{constructor(n){super(n),this._canvas=null,this._readyCallbacks=[],this._resizeCallbacks=[],this._renderTag=null,this._tickCallbackId=null,this._frameCallback=null,this._lastFrameCallback=null,this._lastFrameTime=0,this._replaying=!1,this._frameCallbackId=0,this._nextFrameId=1,this._timeOrigin=r.get_monotonic_time(),this.set_use_es(!0),this.set_required_version(3,2),this.set_has_depth_buffer(!0),this.set_has_stencil_buffer(!0),a(this,()=>this._canvas,{captureKeys:!0}),this._tickCallbackId=this.add_tick_callback((e,t)=>(this._frameCallback!==null&&this.queue_render(),r.SOURCE_CONTINUE));let i=this.connect(`render`,()=>{this.disconnect(i),this.make_current(),this._canvas=new e(this);{let e=globalThis;e.document?.body&&e.document.body.appendChild(this._canvas)}this._canvas.getContext(`webgl2`);let t=this._canvas.getContext(`webgl`);if(t){for(let e of this._readyCallbacks)e(this._canvas,t);this._readyCallbacks=[]}return this._renderTag=this.connect(`render`,e=>{let t=(r.get_monotonic_time()-this._timeOrigin)/1e3;if(this._frameCallback!==null){globalThis.__GJSIFY_DEBUG_RAF===!0&&console.log(`[rAF] frame callback fires t=${t.toFixed(1)}`);let e=this._frameCallback;this._frameCallback=null,this._frameCallbackId=0,this._lastFrameCallback=e,this._lastFrameTime=t,e(t)}else if(this._lastFrameCallback!==null){this._replaying=!0;try{this._lastFrameCallback(this._lastFrameTime)}finally{this._replaying=!1}}return!0}),!0});this.connect(`resize`,()=>{let e=this.get_allocated_width(),n=this.get_allocated_height();this._canvas&&(this._canvas.dispatchEvent(new o(`resize`)),t(this._canvas,e,n));for(let t of this._resizeCallbacks)t(e,n);this._frameCallback&&this.requestAnimationFrame(this._frameCallback)}),this.connect(`unrealize`,()=>{this._renderTag!==null&&(this.disconnect(this._renderTag),this._renderTag=null),this._tickCallbackId!==null&&(this.remove_tick_callback(this._tickCallbackId),this._tickCallbackId=null),this._frameCallback=null,this._lastFrameCallback=null,this._lastFrameTime=0,this._replaying=!1,this._canvas=null})}get canvas(){return this._canvas}onReady(e){if(this._canvas){let t=this._canvas.getContext(`webgl`);if(t){e(this._canvas,t);return}}this._readyCallbacks.push(e)}onWebGLReady(e){this.onReady(e)}onResize(e){this._resizeCallbacks.push(e)}requestAnimationFrame(e){let t=this._nextFrameId++;return this._replaying?t:(this._frameCallback=e,this._frameCallbackId=t,this.queue_render(),t)}cancelAnimationFrame(e){e!==0&&e===this._frameCallbackId&&(this._frameCallback=null,this._frameCallbackId=0,this._lastFrameCallback=null,this._lastFrameTime=0)}installGlobals(){let e=globalThis;e.requestAnimationFrame=e=>this.requestAnimationFrame(e),e.cancelAnimationFrame=e=>this.cancelAnimationFrame(e);let t=this._timeOrigin;e.performance={now:()=>(r.get_monotonic_time()-t)/1e3,timeOrigin:Date.now()}}});export{s as WebGLBridge};
+import"./_virtual/_rolldown/runtime.js";import{WebGLRenderingContext as e}from"./webgl-rendering-context.js";import{WebGL2RenderingContext as t}from"./webgl2-rendering-context.js";import{HTMLCanvasElement as n}from"./html-canvas-element.js";import{notifyElementResize as r}from"@gjsify/dom-elements";import i from"gi://GObject";import a from"gi://GLib?version=2.0";import o from"gi://Gtk?version=4.0";import{attachEventControllers as s}from"@gjsify/event-bridge";import{Event as c}from"@gjsify/dom-events";const l=i.registerClass({GTypeName:`GjsifyWebGLBridge`},class WebGLBridge extends o.GLArea{constructor(e){super(e),this._canvas=null,this._readyCallbacks=[],this._resizeCallbacks=[],this._renderTag=null,this._tickCallbackId=null,this._frameCallback=null,this._lastFrameCallback=null,this._lastFrameTime=0,this._replaying=!1,this._frameCallbackId=0,this._nextFrameId=1,this._timeOrigin=a.get_monotonic_time(),this.set_use_es(!0),this.set_required_version(3,2),this.set_has_depth_buffer(!0),this.set_has_stencil_buffer(!0),s(this,()=>this._canvas,{captureKeys:!0}),this._tickCallbackId=this.add_tick_callback((e,t)=>(this._frameCallback!==null&&this.queue_render(),a.SOURCE_CONTINUE));let t=this.connect(`render`,()=>{this.disconnect(t),this.make_current(),this._canvas=new n(this);{let e=globalThis;e.document?.body&&e.document.body.appendChild(this._canvas)}this._canvas.getContext(`webgl2`);let e=this._canvas.getContext(`webgl`);if(e){for(let t of this._readyCallbacks)t(this._canvas,e);this._readyCallbacks=[]}return this._renderTag=this.connect(`render`,e=>{let t=(a.get_monotonic_time()-this._timeOrigin)/1e3;if(this._frameCallback!==null){globalThis.__GJSIFY_DEBUG_RAF===!0&&console.log(`[rAF] frame callback fires t=${t.toFixed(1)}`);let e=this._frameCallback;this._frameCallback=null,this._frameCallbackId=0,this._lastFrameCallback=e,this._lastFrameTime=t,e(t)}else if(this._lastFrameCallback!==null){this._replaying=!0;try{this._lastFrameCallback(this._lastFrameTime)}finally{this._replaying=!1}}return!0}),!0});this.connect(`resize`,()=>{let e=this.get_allocated_width(),t=this.get_allocated_height();this._canvas&&(this._canvas.dispatchEvent(new c(`resize`)),r(this._canvas,e,t));for(let n of this._resizeCallbacks)n(e,t);this._frameCallback&&this.requestAnimationFrame(this._frameCallback)}),this.connect(`unrealize`,()=>{this._renderTag!==null&&(this.disconnect(this._renderTag),this._renderTag=null),this._tickCallbackId!==null&&(this.remove_tick_callback(this._tickCallbackId),this._tickCallbackId=null),this._frameCallback=null,this._lastFrameCallback=null,this._lastFrameTime=0,this._replaying=!1,this._canvas=null})}get canvas(){return this._canvas}onReady(e){if(this._canvas){let t=this._canvas.getContext(`webgl`);if(t){e(this._canvas,t);return}}this._readyCallbacks.push(e)}onWebGLReady(e){this.onReady(e)}onResize(e){this._resizeCallbacks.push(e)}requestAnimationFrame(e){let t=this._nextFrameId++;return this._replaying?t:(this._frameCallback=e,this._frameCallbackId=t,this.queue_render(),t)}cancelAnimationFrame(e){e!==0&&e===this._frameCallbackId&&(this._frameCallback=null,this._frameCallbackId=0,this._lastFrameCallback=null,this._lastFrameTime=0)}installGlobals(){let n=globalThis;n.requestAnimationFrame=e=>this.requestAnimationFrame(e),n.cancelAnimationFrame=e=>this.cancelAnimationFrame(e),n.WebGLRenderingContext=e,n.WebGL2RenderingContext=t;let r=this._timeOrigin;n.performance={now:()=>(a.get_monotonic_time()-r)/1e3,timeOrigin:Date.now()}}});export{l as WebGLBridge};

package/lib/types/register.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -10,7 +10,8 @@ type WebGLReadyCallback = (canvas: globalThis.HTMLCanvasElement, gl: globalThis.
  * - Creates an `HTMLCanvasElement` wrapping the GLArea on first render
  * - Fires `onReady()` callbacks with (canvas, gl) once the context is available
  * - Provides `requestAnimationFrame()` backed by GTK frame clock (vsync) + render signal
- * - `installGlobals()` sets `globalThis.requestAnimationFrame` and `globalThis.performance`
+ * - `installGlobals()` sets `globalThis.{requestAnimationFrame, cancelAnimationFrame,
+ *   performance, WebGLRenderingContext, WebGL2RenderingContext}`
  *
  * Usage:
  * ```ts
@@ -85,8 +86,18 @@ export declare const WebGLBridge: {
          */
         cancelAnimationFrame(id: number): void;
         /**
-         * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-         * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+         * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+         * `cancelAnimationFrame`, `performance` and the two WebGL context
+         * constructors — so that browser-targeted code (e.g. Three.js) works
+         * unchanged on GJS.
+         *
+         * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+         * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+         * and its `/register` install the same set, `installGlobals()` being the
+         * explicit imperative path (`@gjsify/webgl/register` keeps the
+         * if-undefined guard instead). They used to reach `globalThis` for free
+         * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+         * write into `register.ts` must not shrink what this method does.
          */
         installGlobals(): void;
         get allowed_apis(): Gdk.GLAPI;
@@ -570,8 +581,18 @@ export declare const WebGLBridge: {
              */
             cancelAnimationFrame(id: number): void;
             /**
-             * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-             * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+             * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+             * `cancelAnimationFrame`, `performance` and the two WebGL context
+             * constructors — so that browser-targeted code (e.g. Three.js) works
+             * unchanged on GJS.
+             *
+             * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+             * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+             * and its `/register` install the same set, `installGlobals()` being the
+             * explicit imperative path (`@gjsify/webgl/register` keeps the
+             * if-undefined guard instead). They used to reach `globalThis` for free
+             * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+             * write into `register.ts` must not shrink what this method does.
              */
             installGlobals(): void;
             get allowed_apis(): Gdk.GLAPI;
@@ -1055,8 +1076,18 @@ export declare const WebGLBridge: {
                  */
                 cancelAnimationFrame(id: number): void;
                 /**
-                 * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-                 * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+                 * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+                 * `cancelAnimationFrame`, `performance` and the two WebGL context
+                 * constructors — so that browser-targeted code (e.g. Three.js) works
+                 * unchanged on GJS.
+                 *
+                 * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+                 * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+                 * and its `/register` install the same set, `installGlobals()` being the
+                 * explicit imperative path (`@gjsify/webgl/register` keeps the
+                 * if-undefined guard instead). They used to reach `globalThis` for free
+                 * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+                 * write into `register.ts` must not shrink what this method does.
                  */
                 installGlobals(): void;
                 get allowed_apis(): Gdk.GLAPI;
@@ -1540,8 +1571,18 @@ export declare const WebGLBridge: {
                  */
                 cancelAnimationFrame(id: number): void;
                 /**
-                 * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-                 * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+                 * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+                 * `cancelAnimationFrame`, `performance` and the two WebGL context
+                 * constructors — so that browser-targeted code (e.g. Three.js) works
+                 * unchanged on GJS.
+                 *
+                 * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+                 * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+                 * and its `/register` install the same set, `installGlobals()` being the
+                 * explicit imperative path (`@gjsify/webgl/register` keeps the
+                 * if-undefined guard instead). They used to reach `globalThis` for free
+                 * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+                 * write into `register.ts` must not shrink what this method does.
                  */
                 installGlobals(): void;
                 get allowed_apis(): Gdk.GLAPI;
@@ -2025,8 +2066,18 @@ export declare const WebGLBridge: {
              */
             cancelAnimationFrame(id: number): void;
             /**
-             * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-             * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+             * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+             * `cancelAnimationFrame`, `performance` and the two WebGL context
+             * constructors — so that browser-targeted code (e.g. Three.js) works
+             * unchanged on GJS.
+             *
+             * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+             * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+             * and its `/register` install the same set, `installGlobals()` being the
+             * explicit imperative path (`@gjsify/webgl/register` keeps the
+             * if-undefined guard instead). They used to reach `globalThis` for free
+             * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+             * write into `register.ts` must not shrink what this method does.
              */
             installGlobals(): void;
             get allowed_apis(): Gdk.GLAPI;
@@ -2510,8 +2561,18 @@ export declare const WebGLBridge: {
          */
         cancelAnimationFrame(id: number): void;
         /**
-         * Sets browser globals (`requestAnimationFrame`, `performance`) so that
-         * browser-targeted code (e.g. Three.js) works unchanged on GJS.
+         * Sets the browser globals this bridge owns — `requestAnimationFrame`,
+         * `cancelAnimationFrame`, `performance` and the two WebGL context
+         * constructors — so that browser-targeted code (e.g. Three.js) works
+         * unchanged on GJS.
+         *
+         * `WebGLRenderingContext` / `WebGL2RenderingContext` are installed
+         * UNCONDITIONALLY here: per ADR 0012 rule 5 a bridge's `installGlobals()`
+         * and its `/register` install the same set, `installGlobals()` being the
+         * explicit imperative path (`@gjsify/webgl/register` keeps the
+         * if-undefined guard instead). They used to reach `globalThis` for free
+         * as a side effect of importing the `@gjsify/webgl` barrel; moving that
+         * write into `register.ts` must not shrink what this method does.
          */
         installGlobals(): void;
         get allowed_apis(): Gdk.GLAPI;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/webgl",
-    "version": "0.22.0",
+    "version": "0.23.0",
     "description": "WebGL module for Gjs",
     "module": "lib/esm/index.js",
     "types": "lib/types/index.d.ts",
@@ -9,13 +9,27 @@
         ".": {
             "types": "./lib/types/index.d.ts",
             "default": "./lib/esm/index.js"
+        },
+        "./register": {
+            "types": "./lib/types/register.d.ts",
+            "default": "./lib/esm/register.js"
         }
     },
+    "sideEffects": [
+        "./lib/esm/register.js"
+    ],
     "files": [
         "lib",
         "prebuilds"
     ],
     "gjsify": {
+        "platforms": [
+            "linux-x86_64",
+            "linux-aarch64",
+            "linux-ppc64",
+            "linux-s390x",
+            "linux-riscv64"
+        ],
         "prebuilds": "prebuilds",
         "runtimes": {
             "gjs": "polyfill",
@@ -34,7 +48,7 @@
         "build:gjsify": "gjsify build --library 'src/ts/**/*.{ts,js}'",
         "build:meson": "gjsify run init:meson && meson compile -C build",
         "build:types": "gjsify tsc",
-        "build:prebuilds": "gjsify run build:meson && mkdir -p prebuilds/linux-x86_64 && cp build/libgwebgl.so build/Gwebgl-0.1.typelib prebuilds/linux-x86_64/",
+        "build:prebuilds": "gjsify run build:meson && node ../../../scripts/stage-prebuild.mjs .",
         "build:test": "gjsify build src/ts/test.ts --app gjs --outfile test.gjs.js",
         "build:conformance": "gjsify build src/ts/conformance-test.ts --app gjs --outfile conformance.gjs.js",
         "test": "gjsify run build:gjsify && gjsify run build:test && gjsify run test:gjs",
@@ -46,8 +60,8 @@
         "WebGL"
     ],
     "devDependencies": {
-        "@gjsify/cli": "^0.22.0",
-        "@gjsify/unit": "^0.22.0",
+        "@gjsify/cli": "^0.23.0",
+        "@gjsify/unit": "^0.23.0",
         "@types/bit-twiddle": "^1.0.3",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
@@ -57,10 +71,10 @@
         "@girs/gjs": "^4.1.0",
         "@girs/gtk-4.0": "^4.1.0",
         "@girs/gwebgl-0.1": "0.1.0-4.0.0-rc.5",
-        "@gjsify/dom-elements": "^0.22.0",
-        "@gjsify/dom-events": "^0.22.0",
-        "@gjsify/event-bridge": "^0.22.0",
-        "@gjsify/utils": "^0.22.0",
+        "@gjsify/dom-elements": "^0.23.0",
+        "@gjsify/dom-events": "^0.23.0",
+        "@gjsify/event-bridge": "^0.23.0",
+        "@gjsify/utils": "^0.23.0",
         "bit-twiddle": "^1.0.2",
         "glsl-tokenizer": "^2.1.5"
     },