@gtkx/gl 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/overrides.d.ts

@@ -1,37 +1,48 @@
 import type { DebugSeverity, DebugSource, DebugType, GLsync, GLuint, SyncObjectMask, SyncStatus } from "./generated/types.js";
+/**
+ * A debug message reported by the GL driver.
+ */
+type DebugMessage = {
+    /** The origin of the message (API, window system, shader compiler, and so on). */
+    source: DebugSource;
+    /** The category of the message (error, deprecated behavior, performance, and so on). */
+    type: DebugType;
+    /** The driver-assigned identifier of the message. */
+    id: GLuint;
+    /** The severity level of the message. */
+    severity: DebugSeverity;
+    /** The human-readable message text. */
+    message: string;
+};
+/**
+ * Callback invoked for each GL debug message reported by the driver.
+ * @param message The message reported by the driver.
+ */
+type DebugMessageCallback = (message: DebugMessage) => void;
 /**
  * Reads the info log for a shader object, containing compilation diagnostics.
  * @param shader The name of the shader object to query.
  * @returns The shader info log, or an empty string when none is available.
  */
-export declare function getShaderInfoLog(shader: GLuint): string;
+declare function getShaderInfoLog(shader: GLuint): string;
 /**
  * Reads the info log for a program object, containing linking diagnostics.
  * @param program The name of the program object to query.
  * @returns The program info log, or an empty string when none is available.
  */
-export declare function getProgramInfoLog(program: GLuint): string;
+declare function getProgramInfoLog(program: GLuint): string;
 /**
  * Reads the info log for a program pipeline object, containing validation diagnostics.
  * @param pipeline The name of the program pipeline object to query.
  * @returns The pipeline info log, or an empty string when none is available.
  */
-export declare function getProgramPipelineInfoLog(pipeline: GLuint): string;
-/**
- * Callback invoked for each GL debug message reported by the driver.
- * @param source The origin of the message (API, window system, shader compiler, and so on).
- * @param type The category of the message (error, deprecated behavior, performance, and so on).
- * @param id The driver-assigned identifier of the message.
- * @param severity The severity level of the message.
- * @param message The human-readable message text.
- */
-export type DebugMessageCallback = (source: DebugSource, type: DebugType, id: GLuint, severity: DebugSeverity, message: string) => void;
+declare function getProgramPipelineInfoLog(pipeline: GLuint): string;
 /**
  * Installs a callback that receives GL debug messages, enabling synchronous debug output.
  * Passing null removes any previously installed callback.
  * @param callback The handler to invoke for each debug message, or null to clear it.
  */
-export declare function debugMessageCallback(callback: DebugMessageCallback | null): void;
+declare function debugMessageCallback(callback: DebugMessageCallback | null): void;
 /**
  * Blocks until a sync object is signaled or the timeout elapses, looping over glClientWaitSync
  * in bounded chunks so long waits are not truncated by the driver's per-call limit.
@@ -40,5 +51,6 @@ export declare function debugMessageCallback(callback: DebugMessageCallback | nu
  * @param timeoutNs The total time to wait, in nanoseconds.
  * @returns The status of the sync object: signaled, condition satisfied, or timeout expired.
  */
-export declare function clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus;
+declare function clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus;
+export { getShaderInfoLog, getProgramInfoLog, getProgramPipelineInfoLog, debugMessageCallback, clientWaitSyncLoop, type DebugMessage, type DebugMessageCallback, };
 //# sourceMappingURL=overrides.d.ts.map

package/dist/overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACR,aAAa,EACb,WAAW,EACX,SAAS,EAGT,MAAM,EACN,MAAM,EACN,cAAc,EACd,UAAU,EACb,MAAM,sBAAsB,CAAC;AAkB9B;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAC/B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,KACd,IAAI,CAAC;AAcV;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAWhF;AAID;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAYrG"}
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,aAAa,EACb,WAAW,EACX,SAAS,EAGT,MAAM,EACN,MAAM,EACN,cAAc,EACd,UAAU,EACb,MAAM,sBAAsB,CAAC;AAc9B;;GAEG;AACH,KAAK,YAAY,GAAG;IAChB,kFAAkF;IAClF,MAAM,EAAE,WAAW,CAAC;IACpB,wFAAwF;IACxF,IAAI,EAAE,SAAS,CAAC;IAChB,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,QAAQ,EAAE,aAAa,CAAC;IACxB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AAoC5D;;;;GAIG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;GAIG;AACH,iBAAS,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAczE;AAcD;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAoB9F;AAED,OAAO,EACH,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC5B,CAAC"}

package/dist/overrides.js

@@ -1,10 +1,18 @@
 import { t } from "@gtkx/runtime";
 import { clientWaitSync, enable, getProgramiv, getProgramPipelineiv, getShaderiv, LIB } from "./generated/commands.js";
 import { ALREADY_SIGNALED, CONDITION_SATISFIED, DEBUG_OUTPUT, DEBUG_OUTPUT_SYNCHRONOUS, INFO_LOG_LENGTH, TIMEOUT_EXPIRED, } from "./generated/enums.js";
+const glDebugMessageCallbackBinding = t.bind(LIB, "glDebugMessageCallback", [
+    t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string("borrowed"), t.uint64], t.void, {
+        userDataIndex: 6,
+        scope: "forever",
+    }),
+], t.void);
+const MAX_WAIT_CHUNK_NS = 1_000_000_000;
 const readInfoLog = (symbol, id, query) => {
     const length = query(id, INFO_LOG_LENGTH);
-    if (length <= 0)
+    if (length <= 0) {
         return "";
+    }
     const written = { value: 0 };
     const log = { value: "" };
     t.bind(LIB, symbol, [t.uint32, t.int32, t.ref(t.int32), t.ref(t.string("borrowed", length))], t.void)(id, length, written, log);
@@ -15,7 +23,7 @@ const readInfoLog = (symbol, id, query) => {
  * @param shader The name of the shader object to query.
  * @returns The shader info log, or an empty string when none is available.
  */
-export function getShaderInfoLog(shader) {
+function getShaderInfoLog(shader) {
     return readInfoLog("glGetShaderInfoLog", shader, getShaderiv);
 }
 /**
@@ -23,7 +31,7 @@ export function getShaderInfoLog(shader) {
  * @param program The name of the program object to query.
  * @returns The program info log, or an empty string when none is available.
  */
-export function getProgramInfoLog(program) {
+function getProgramInfoLog(program) {
     return readInfoLog("glGetProgramInfoLog", program, getProgramiv);
 }
 /**
@@ -31,30 +39,35 @@ export function getProgramInfoLog(program) {
  * @param pipeline The name of the program pipeline object to query.
  * @returns The pipeline info log, or an empty string when none is available.
  */
-export function getProgramPipelineInfoLog(pipeline) {
+function getProgramPipelineInfoLog(pipeline) {
     return readInfoLog("glGetProgramPipelineInfoLog", pipeline, getProgramPipelineiv);
 }
-const glDebugMessageCallbackBinding = t.bind(LIB, "glDebugMessageCallback", [
-    t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string("borrowed"), t.uint64], t.void, {
-        userDataIndex: 6,
-        scope: "forever",
-    }),
-], t.void);
 /**
  * Installs a callback that receives GL debug messages, enabling synchronous debug output.
  * Passing null removes any previously installed callback.
  * @param callback The handler to invoke for each debug message, or null to clear it.
  */
-export function debugMessageCallback(callback) {
+function debugMessageCallback(callback) {
     if (callback === null) {
         glDebugMessageCallbackBinding(null);
         return;
     }
     enable(DEBUG_OUTPUT);
     enable(DEBUG_OUTPUT_SYNCHRONOUS);
-    glDebugMessageCallbackBinding((source, type, id, severity, _length, message) => callback(source, type, id, severity, message));
+    glDebugMessageCallbackBinding((...args) => {
+        const [source, type, id, severity, , message] = args;
+        callback({ source, type, id, severity, message });
+    });
 }
-const MAX_WAIT_CHUNK_NS = 1_000_000_000;
+const settledSyncStatus = (status) => {
+    if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED) {
+        return status;
+    }
+    if (status !== TIMEOUT_EXPIRED) {
+        return status;
+    }
+    return null;
+};
 /**
  * Blocks until a sync object is signaled or the timeout elapses, looping over glClientWaitSync
  * in bounded chunks so long waits are not truncated by the driver's per-call limit.
@@ -63,20 +76,21 @@ const MAX_WAIT_CHUNK_NS = 1_000_000_000;
  * @param timeoutNs The total time to wait, in nanoseconds.
  * @returns The status of the sync object: signaled, condition satisfied, or timeout expired.
  */
-export function clientWaitSyncLoop(sync, flags, timeoutNs) {
+function clientWaitSyncLoop(sync, flags, timeoutNs) {
     let remaining = timeoutNs;
     let currentFlags = flags;
     for (;;) {
         const chunk = Math.min(remaining, MAX_WAIT_CHUNK_NS);
-        const status = clientWaitSync(sync, currentFlags, chunk);
-        if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED)
-            return status;
-        if (status !== TIMEOUT_EXPIRED)
-            return status;
+        const settled = settledSyncStatus(clientWaitSync(sync, currentFlags, chunk));
+        if (settled !== null) {
+            return settled;
+        }
         remaining -= chunk;
-        if (remaining <= 0)
+        if (remaining <= 0) {
             return TIMEOUT_EXPIRED;
+        }
         currentFlags = 0;
     }
 }
+export { getShaderInfoLog, getProgramInfoLog, getProgramPipelineInfoLog, debugMessageCallback, clientWaitSyncLoop, };
 //# sourceMappingURL=overrides.js.map

package/dist/overrides.js.map

@@ -1 +1 @@
-{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"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","sourcesContent":["import { t } from \"@gtkx/runtime\";\nimport { clientWaitSync, enable, getProgramiv, getProgramPipelineiv, getShaderiv, LIB } from \"./generated/commands.js\";\nimport {\n    ALREADY_SIGNALED,\n    CONDITION_SATISFIED,\n    DEBUG_OUTPUT,\n    DEBUG_OUTPUT_SYNCHRONOUS,\n    INFO_LOG_LENGTH,\n    TIMEOUT_EXPIRED,\n} from \"./generated/enums.js\";\nimport type {\n    DebugSeverity,\n    DebugSource,\n    DebugType,\n    GLenum,\n    GLint,\n    GLsync,\n    GLuint,\n    SyncObjectMask,\n    SyncStatus,\n} from \"./generated/types.js\";\n\ntype LengthQuery = (id: GLuint, pname: GLenum) => GLint;\n\nconst readInfoLog = (symbol: string, id: GLuint, query: LengthQuery): string => {\n    const length = query(id, INFO_LOG_LENGTH);\n    if (length <= 0) return \"\";\n    const written = { value: 0 };\n    const log = { value: \"\" };\n    t.bind(LIB, symbol, [t.uint32, t.int32, t.ref(t.int32), t.ref(t.string(\"borrowed\", length))], t.void)(\n        id,\n        length,\n        written,\n        log,\n    );\n    return log.value;\n};\n\n/**\n * Reads the info log for a shader object, containing compilation diagnostics.\n * @param shader The name of the shader object to query.\n * @returns The shader info log, or an empty string when none is available.\n */\nexport function getShaderInfoLog(shader: GLuint): string {\n    return readInfoLog(\"glGetShaderInfoLog\", shader, getShaderiv);\n}\n\n/**\n * Reads the info log for a program object, containing linking diagnostics.\n * @param program The name of the program object to query.\n * @returns The program info log, or an empty string when none is available.\n */\nexport function getProgramInfoLog(program: GLuint): string {\n    return readInfoLog(\"glGetProgramInfoLog\", program, getProgramiv);\n}\n\n/**\n * Reads the info log for a program pipeline object, containing validation diagnostics.\n * @param pipeline The name of the program pipeline object to query.\n * @returns The pipeline info log, or an empty string when none is available.\n */\nexport function getProgramPipelineInfoLog(pipeline: GLuint): string {\n    return readInfoLog(\"glGetProgramPipelineInfoLog\", pipeline, getProgramPipelineiv);\n}\n\n/**\n * Callback invoked for each GL debug message reported by the driver.\n * @param source The origin of the message (API, window system, shader compiler, and so on).\n * @param type The category of the message (error, deprecated behavior, performance, and so on).\n * @param id The driver-assigned identifier of the message.\n * @param severity The severity level of the message.\n * @param message The human-readable message text.\n */\nexport type DebugMessageCallback = (\n    source: DebugSource,\n    type: DebugType,\n    id: GLuint,\n    severity: DebugSeverity,\n    message: string,\n) => void;\n\nconst glDebugMessageCallbackBinding = t.bind(\n    LIB,\n    \"glDebugMessageCallback\",\n    [\n        t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string(\"borrowed\"), t.uint64], t.void, {\n            userDataIndex: 6,\n            scope: \"forever\",\n        }),\n    ],\n    t.void,\n);\n\n/**\n * Installs a callback that receives GL debug messages, enabling synchronous debug output.\n * Passing null removes any previously installed callback.\n * @param callback The handler to invoke for each debug message, or null to clear it.\n */\nexport function debugMessageCallback(callback: DebugMessageCallback | null): void {\n    if (callback === null) {\n        glDebugMessageCallbackBinding(null);\n        return;\n    }\n    enable(DEBUG_OUTPUT);\n    enable(DEBUG_OUTPUT_SYNCHRONOUS);\n    glDebugMessageCallbackBinding(\n        (source: GLenum, type: GLenum, id: GLuint, severity: GLenum, _length: number, message: string) =>\n            callback(source, type, id, severity, message),\n    );\n}\n\nconst MAX_WAIT_CHUNK_NS = 1_000_000_000;\n\n/**\n * Blocks until a sync object is signaled or the timeout elapses, looping over glClientWaitSync\n * in bounded chunks so long waits are not truncated by the driver's per-call limit.\n * @param sync The sync object (fence) to wait on.\n * @param flags Flags controlling the wait, such as flushing pending commands on the first call.\n * @param timeoutNs The total time to wait, in nanoseconds.\n * @returns The status of the sync object: signaled, condition satisfied, or timeout expired.\n */\nexport function clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus {\n    let remaining = timeoutNs;\n    let currentFlags = flags;\n    for (;;) {\n        const chunk = Math.min(remaining, MAX_WAIT_CHUNK_NS);\n        const status = clientWaitSync(sync, currentFlags, chunk);\n        if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED) return status;\n        if (status !== TIMEOUT_EXPIRED) return status;\n        remaining -= chunk;\n        if (remaining <= 0) return TIMEOUT_EXPIRED;\n        currentFlags = 0;\n    }\n}\n"]}
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../src/overrides.ts"],"names":[],"mappings":"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","sourcesContent":["import { t } from \"@gtkx/runtime\";\nimport type {\n    DebugSeverity,\n    DebugSource,\n    DebugType,\n    GLenum,\n    GLint,\n    GLsync,\n    GLuint,\n    SyncObjectMask,\n    SyncStatus,\n} from \"./generated/types.js\";\nimport { clientWaitSync, enable, getProgramiv, getProgramPipelineiv, getShaderiv, LIB } from \"./generated/commands.js\";\nimport {\n    ALREADY_SIGNALED,\n    CONDITION_SATISFIED,\n    DEBUG_OUTPUT,\n    DEBUG_OUTPUT_SYNCHRONOUS,\n    INFO_LOG_LENGTH,\n    TIMEOUT_EXPIRED,\n} from \"./generated/enums.js\";\n\ntype LengthQuery = (id: GLuint, pname: GLenum) => GLint;\ntype DebugCallbackArgs = [GLenum, GLenum, GLuint, GLenum, number, string];\n\n/**\n * A debug message reported by the GL driver.\n */\ntype DebugMessage = {\n    /** The origin of the message (API, window system, shader compiler, and so on). */\n    source: DebugSource;\n    /** The category of the message (error, deprecated behavior, performance, and so on). */\n    type: DebugType;\n    /** The driver-assigned identifier of the message. */\n    id: GLuint;\n    /** The severity level of the message. */\n    severity: DebugSeverity;\n    /** The human-readable message text. */\n    message: string;\n};\n\n/**\n * Callback invoked for each GL debug message reported by the driver.\n * @param message The message reported by the driver.\n */\ntype DebugMessageCallback = (message: DebugMessage) => void;\n\nconst glDebugMessageCallbackBinding = t.bind(\n    LIB,\n    \"glDebugMessageCallback\",\n    [\n        t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string(\"borrowed\"), t.uint64], t.void, {\n            userDataIndex: 6,\n            scope: \"forever\",\n        }),\n    ],\n    t.void,\n);\n\nconst MAX_WAIT_CHUNK_NS = 1_000_000_000;\n\nconst readInfoLog = (symbol: string, id: GLuint, query: LengthQuery): string => {\n    const length = query(id, INFO_LOG_LENGTH);\n\n    if (length <= 0) {\n        return \"\";\n    }\n\n    const written = { value: 0 };\n    const log = { value: \"\" };\n\n    t.bind(LIB, symbol, [t.uint32, t.int32, t.ref(t.int32), t.ref(t.string(\"borrowed\", length))], t.void)(\n        id,\n        length,\n        written,\n        log,\n    );\n\n    return log.value;\n};\n\n/**\n * Reads the info log for a shader object, containing compilation diagnostics.\n * @param shader The name of the shader object to query.\n * @returns The shader info log, or an empty string when none is available.\n */\nfunction getShaderInfoLog(shader: GLuint): string {\n    return readInfoLog(\"glGetShaderInfoLog\", shader, getShaderiv);\n}\n\n/**\n * Reads the info log for a program object, containing linking diagnostics.\n * @param program The name of the program object to query.\n * @returns The program info log, or an empty string when none is available.\n */\nfunction getProgramInfoLog(program: GLuint): string {\n    return readInfoLog(\"glGetProgramInfoLog\", program, getProgramiv);\n}\n\n/**\n * Reads the info log for a program pipeline object, containing validation diagnostics.\n * @param pipeline The name of the program pipeline object to query.\n * @returns The pipeline info log, or an empty string when none is available.\n */\nfunction getProgramPipelineInfoLog(pipeline: GLuint): string {\n    return readInfoLog(\"glGetProgramPipelineInfoLog\", pipeline, getProgramPipelineiv);\n}\n\n/**\n * Installs a callback that receives GL debug messages, enabling synchronous debug output.\n * Passing null removes any previously installed callback.\n * @param callback The handler to invoke for each debug message, or null to clear it.\n */\nfunction debugMessageCallback(callback: DebugMessageCallback | null): void {\n    if (callback === null) {\n        glDebugMessageCallbackBinding(null);\n\n        return;\n    }\n\n    enable(DEBUG_OUTPUT);\n    enable(DEBUG_OUTPUT_SYNCHRONOUS);\n\n    glDebugMessageCallbackBinding((...args: DebugCallbackArgs) => {\n        const [source, type, id, severity, , message] = args;\n        callback({ source, type, id, severity, message });\n    });\n}\n\nconst settledSyncStatus = (status: SyncStatus): SyncStatus | null => {\n    if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED) {\n        return status;\n    }\n\n    if (status !== TIMEOUT_EXPIRED) {\n        return status;\n    }\n\n    return null;\n};\n\n/**\n * Blocks until a sync object is signaled or the timeout elapses, looping over glClientWaitSync\n * in bounded chunks so long waits are not truncated by the driver's per-call limit.\n * @param sync The sync object (fence) to wait on.\n * @param flags Flags controlling the wait, such as flushing pending commands on the first call.\n * @param timeoutNs The total time to wait, in nanoseconds.\n * @returns The status of the sync object: signaled, condition satisfied, or timeout expired.\n */\nfunction clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus {\n    let remaining = timeoutNs;\n    let currentFlags = flags;\n\n    for (;;) {\n        const chunk = Math.min(remaining, MAX_WAIT_CHUNK_NS);\n        const settled = settledSyncStatus(clientWaitSync(sync, currentFlags, chunk));\n\n        if (settled !== null) {\n            return settled;\n        }\n\n        remaining -= chunk;\n\n        if (remaining <= 0) {\n            return TIMEOUT_EXPIRED;\n        }\n\n        currentFlags = 0;\n    }\n}\n\nexport {\n    getShaderInfoLog,\n    getProgramInfoLog,\n    getProgramPipelineInfoLog,\n    debugMessageCallback,\n    clientWaitSyncLoop,\n    type DebugMessage,\n    type DebugMessageCallback,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/gl",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.2",
   "description": "Generated OpenGL 4.6 core bindings plus override helpers for GTKX GLArea rendering",
   "keywords": [
     "gtkx",
@@ -40,17 +40,49 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/runtime": "1.0.0-rc.1",
-    "@gtkx/native": "1.0.0-rc.1"
+    "@gtkx/runtime": "1.0.0-rc.2",
+    "@gtkx/native": "1.0.0-rc.2"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
-    "@gtkx/codegen": "1.0.0-rc.1",
-    "@gtkx/utils": "1.0.0-rc.1"
+    "@types/node": "^26.1.2",
+    "vitest": "^4.1.10",
+    "@gtkx/codegen": "1.0.0-rc.2",
+    "@gtkx/utils": "1.0.0-rc.2",
+    "@gtkx/vitest": "1.0.0-rc.2"
+  },
+  "nx": {
+    "targets": {
+      "codegen": {
+        "cache": true,
+        "dependsOn": [
+          "gtkx:codegen"
+        ],
+        "inputs": [
+          "{projectRoot}/scripts/**/*",
+          "{projectRoot}/src/overrides.ts",
+          "^production",
+          "{workspaceRoot}/packages/codegen/src/khronos/**/*"
+        ],
+        "outputs": [
+          "{projectRoot}/src/generated/**"
+        ]
+      },
+      "build": {
+        "dependsOn": [
+          "^build",
+          "gtkx:codegen",
+          "codegen"
+        ],
+        "inputs": [
+          "...",
+          {
+            "dependentTasksOutputFiles": "**/*.ts"
+          }
+        ]
+      }
+    }
   },
   "scripts": {
-    "build": "tsc -b tsconfig.lib.json",
-    "typecheck": "tsc -b --emitDeclarationOnly",
     "codegen": "NODE_OPTIONS=--conditions=source tsx ./scripts/codegen.ts",
     "release": "tsx ../../scripts/release-package.ts"
   }

package/src/overrides.ts

@@ -1,13 +1,4 @@
 import { t } from "@gtkx/runtime";
-import { clientWaitSync, enable, getProgramiv, getProgramPipelineiv, getShaderiv, LIB } from "./generated/commands.js";
-import {
-    ALREADY_SIGNALED,
-    CONDITION_SATISFIED,
-    DEBUG_OUTPUT,
-    DEBUG_OUTPUT_SYNCHRONOUS,
-    INFO_LOG_LENGTH,
-    TIMEOUT_EXPIRED,
-} from "./generated/enums.js";
 import type {
     DebugSeverity,
     DebugSource,
@@ -19,20 +10,72 @@ import type {
     SyncObjectMask,
     SyncStatus,
 } from "./generated/types.js";
+import { clientWaitSync, enable, getProgramiv, getProgramPipelineiv, getShaderiv, LIB } from "./generated/commands.js";
+import {
+    ALREADY_SIGNALED,
+    CONDITION_SATISFIED,
+    DEBUG_OUTPUT,
+    DEBUG_OUTPUT_SYNCHRONOUS,
+    INFO_LOG_LENGTH,
+    TIMEOUT_EXPIRED,
+} from "./generated/enums.js";
 
 type LengthQuery = (id: GLuint, pname: GLenum) => GLint;
+type DebugCallbackArgs = [GLenum, GLenum, GLuint, GLenum, number, string];
+
+/**
+ * A debug message reported by the GL driver.
+ */
+type DebugMessage = {
+    /** The origin of the message (API, window system, shader compiler, and so on). */
+    source: DebugSource;
+    /** The category of the message (error, deprecated behavior, performance, and so on). */
+    type: DebugType;
+    /** The driver-assigned identifier of the message. */
+    id: GLuint;
+    /** The severity level of the message. */
+    severity: DebugSeverity;
+    /** The human-readable message text. */
+    message: string;
+};
+
+/**
+ * Callback invoked for each GL debug message reported by the driver.
+ * @param message The message reported by the driver.
+ */
+type DebugMessageCallback = (message: DebugMessage) => void;
+
+const glDebugMessageCallbackBinding = t.bind(
+    LIB,
+    "glDebugMessageCallback",
+    [
+        t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string("borrowed"), t.uint64], t.void, {
+            userDataIndex: 6,
+            scope: "forever",
+        }),
+    ],
+    t.void,
+);
+
+const MAX_WAIT_CHUNK_NS = 1_000_000_000;
 
 const readInfoLog = (symbol: string, id: GLuint, query: LengthQuery): string => {
     const length = query(id, INFO_LOG_LENGTH);
-    if (length <= 0) return "";
+
+    if (length <= 0) {
+        return "";
+    }
+
     const written = { value: 0 };
     const log = { value: "" };
+
     t.bind(LIB, symbol, [t.uint32, t.int32, t.ref(t.int32), t.ref(t.string("borrowed", length))], t.void)(
         id,
         length,
         written,
         log,
     );
+
     return log.value;
 };
 
@@ -41,7 +84,7 @@ const readInfoLog = (symbol: string, id: GLuint, query: LengthQuery): string =>
  * @param shader The name of the shader object to query.
  * @returns The shader info log, or an empty string when none is available.
  */
-export function getShaderInfoLog(shader: GLuint): string {
+function getShaderInfoLog(shader: GLuint): string {
     return readInfoLog("glGetShaderInfoLog", shader, getShaderiv);
 }
 
@@ -50,7 +93,7 @@ export function getShaderInfoLog(shader: GLuint): string {
  * @param program The name of the program object to query.
  * @returns The program info log, or an empty string when none is available.
  */
-export function getProgramInfoLog(program: GLuint): string {
+function getProgramInfoLog(program: GLuint): string {
     return readInfoLog("glGetProgramInfoLog", program, getProgramiv);
 }
 
@@ -59,57 +102,42 @@ export function getProgramInfoLog(program: GLuint): string {
  * @param pipeline The name of the program pipeline object to query.
  * @returns The pipeline info log, or an empty string when none is available.
  */
-export function getProgramPipelineInfoLog(pipeline: GLuint): string {
+function getProgramPipelineInfoLog(pipeline: GLuint): string {
     return readInfoLog("glGetProgramPipelineInfoLog", pipeline, getProgramPipelineiv);
 }
 
-/**
- * Callback invoked for each GL debug message reported by the driver.
- * @param source The origin of the message (API, window system, shader compiler, and so on).
- * @param type The category of the message (error, deprecated behavior, performance, and so on).
- * @param id The driver-assigned identifier of the message.
- * @param severity The severity level of the message.
- * @param message The human-readable message text.
- */
-export type DebugMessageCallback = (
-    source: DebugSource,
-    type: DebugType,
-    id: GLuint,
-    severity: DebugSeverity,
-    message: string,
-) => void;
-
-const glDebugMessageCallbackBinding = t.bind(
-    LIB,
-    "glDebugMessageCallback",
-    [
-        t.callback([t.uint32, t.uint32, t.uint32, t.uint32, t.int32, t.string("borrowed"), t.uint64], t.void, {
-            userDataIndex: 6,
-            scope: "forever",
-        }),
-    ],
-    t.void,
-);
-
 /**
  * Installs a callback that receives GL debug messages, enabling synchronous debug output.
  * Passing null removes any previously installed callback.
  * @param callback The handler to invoke for each debug message, or null to clear it.
  */
-export function debugMessageCallback(callback: DebugMessageCallback | null): void {
+function debugMessageCallback(callback: DebugMessageCallback | null): void {
     if (callback === null) {
         glDebugMessageCallbackBinding(null);
+
         return;
     }
+
     enable(DEBUG_OUTPUT);
     enable(DEBUG_OUTPUT_SYNCHRONOUS);
-    glDebugMessageCallbackBinding(
-        (source: GLenum, type: GLenum, id: GLuint, severity: GLenum, _length: number, message: string) =>
-            callback(source, type, id, severity, message),
-    );
+
+    glDebugMessageCallbackBinding((...args: DebugCallbackArgs) => {
+        const [source, type, id, severity, , message] = args;
+        callback({ source, type, id, severity, message });
+    });
 }
 
-const MAX_WAIT_CHUNK_NS = 1_000_000_000;
+const settledSyncStatus = (status: SyncStatus): SyncStatus | null => {
+    if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED) {
+        return status;
+    }
+
+    if (status !== TIMEOUT_EXPIRED) {
+        return status;
+    }
+
+    return null;
+};
 
 /**
  * Blocks until a sync object is signaled or the timeout elapses, looping over glClientWaitSync
@@ -119,16 +147,34 @@ const MAX_WAIT_CHUNK_NS = 1_000_000_000;
  * @param timeoutNs The total time to wait, in nanoseconds.
  * @returns The status of the sync object: signaled, condition satisfied, or timeout expired.
  */
-export function clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus {
+function clientWaitSyncLoop(sync: GLsync, flags: SyncObjectMask, timeoutNs: number): SyncStatus {
     let remaining = timeoutNs;
     let currentFlags = flags;
+
     for (;;) {
         const chunk = Math.min(remaining, MAX_WAIT_CHUNK_NS);
-        const status = clientWaitSync(sync, currentFlags, chunk);
-        if (status === ALREADY_SIGNALED || status === CONDITION_SATISFIED) return status;
-        if (status !== TIMEOUT_EXPIRED) return status;
+        const settled = settledSyncStatus(clientWaitSync(sync, currentFlags, chunk));
+
+        if (settled !== null) {
+            return settled;
+        }
+
         remaining -= chunk;
-        if (remaining <= 0) return TIMEOUT_EXPIRED;
+
+        if (remaining <= 0) {
+            return TIMEOUT_EXPIRED;
+        }
+
         currentFlags = 0;
     }
 }
+
+export {
+    getShaderInfoLog,
+    getProgramInfoLog,
+    getProgramPipelineInfoLog,
+    debugMessageCallback,
+    clientWaitSyncLoop,
+    type DebugMessage,
+    type DebugMessageCallback,
+};