@gtkx/ffi 0.1.37 → 0.1.40

package/README.md

@@ -134,13 +134,13 @@ test("increments count when clicking button", async () => {
   await screen.findByText("Count: 1");
 });
 
-test("can also use fireEvent for low-level events", async () => {
+test("can also use fireEvent for low-level signals", async () => {
   await render(<App />);
 
   const button = await screen.findByRole(AccessibleRole.BUTTON, {
     name: "Increment",
   });
-  fireEvent.click(button);
+  fireEvent(button, "clicked");
 
   await screen.findByText("Count: 1");
 });
@@ -156,14 +156,13 @@ Query types: `ByRole`, `ByText`, `ByLabelText`, `ByTestId`
 **User Interactions**:
 - `userEvent.click(element)` - Simulate click
 - `userEvent.dblClick(element)` - Simulate double click
+- `userEvent.activate(element)` - Activate element (e.g., press Enter in input)
 - `userEvent.type(element, text)` - Type text into input
 - `userEvent.clear(element)` - Clear input text
 - `userEvent.setup()` - Create reusable instance
 
 **Low-level Events**:
-- `fireEvent(element, signalName)` - Emit any GTK signal
-- `fireEvent.click(element)` - Emit clicked signal
-- `fireEvent.activate(element)` - Emit activate signal
+- `fireEvent(element, signalName, ...args)` - Emit any GTK signal with optional arguments
 
 **Utilities**:
 - `waitFor(callback)` - Wait for condition

package/dist/codegen/ffi-generator.js

@@ -1725,7 +1725,9 @@ ${allArgs ? `${allArgs},` : ""}
             const jsParamName = toValidIdentifier(toCamelCase(param.name));
             const needsPtr = mapped.ffi.type === "gobject" || mapped.ffi.type === "boxed";
             const valueName = needsPtr ? `(${jsParamName} as any)?.ptr ?? ${jsParamName}` : jsParamName;
-            return `${indent}  {\n${indent}    type: ${this.generateTypeDescriptor(mapped.ffi)},\n${indent}    value: ${valueName},\n${indent}  }`;
+            const isOptional = this.typeMapper.isNullable(param);
+            const optionalPart = isOptional ? `,\n${indent}    optional: true` : "";
+            return `${indent}  {\n${indent}    type: ${this.generateTypeDescriptor(mapped.ffi)},\n${indent}    value: ${valueName}${optionalPart},\n${indent}  }`;
         })
             .join(",\n");
     }

package/dist/generated/gdk/app-launch-context.js

@@ -47,6 +47,7 @@ export class AppLaunchContext extends Gio.AppLaunchContext {
             {
                 type: { type: "gobject", borrowed: true },
                 value: icon?.ptr ?? icon,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -59,6 +60,7 @@ export class AppLaunchContext extends Gio.AppLaunchContext {
             {
                 type: { type: "string" },
                 value: iconName,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/clipboard.js

@@ -80,6 +80,7 @@ export class Clipboard extends GObject.GObject {
             {
                 type: { type: "ref", innerType: { type: "string" } },
                 value: outMimeType,
+                optional: true,
             },
             {
                 type: {
@@ -200,6 +201,7 @@ export class Clipboard extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: provider?.ptr ?? provider,
+                optional: true,
             },
         ], { type: "boolean" });
     }

package/dist/generated/gdk/content-deserializer.js

@@ -116,6 +116,7 @@ export class ContentDeserializer extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
             {
                 type: { type: "callback", trampoline: "destroy" },

package/dist/generated/gdk/content-formats.js

@@ -21,6 +21,7 @@ export class ContentFormats {
             {
                 type: { type: "array", itemType: { type: "string" } },
                 value: mimeTypes,
+                optional: true,
             },
             {
                 type: { type: "int", size: 32, unsigned: true },
@@ -78,6 +79,7 @@ export class ContentFormats {
                     innerType: { type: "int", size: 64, unsigned: true },
                 },
                 value: nGtypes,
+                optional: true,
             },
         ], { type: "array", itemType: { type: "int", size: 64, unsigned: true } });
     }
@@ -93,6 +95,7 @@ export class ContentFormats {
                     innerType: { type: "int", size: 64, unsigned: true },
                 },
                 value: nMimeTypes,
+                optional: true,
             },
         ], { type: "array", itemType: { type: "string" } });
     }

package/dist/generated/gdk/content-provider.js

@@ -28,6 +28,7 @@ export class ContentProvider extends GObject.GObject {
             {
                 type: { type: "array", itemType: { type: "gobject" } },
                 value: providers,
+                optional: true,
             },
             {
                 type: { type: "int", size: 64, unsigned: true },

package/dist/generated/gdk/content-serializer.js

@@ -120,6 +120,7 @@ export class ContentSerializer extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
             {
                 type: { type: "callback", trampoline: "destroy" },

package/dist/generated/gdk/cursor.js

@@ -15,6 +15,7 @@ export class Cursor extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: fallback?.ptr ?? fallback,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, Cursor);
@@ -36,6 +37,7 @@ export class Cursor extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: fallback?.ptr ?? fallback,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, Cursor);
@@ -50,6 +52,7 @@ export class Cursor extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
             {
                 type: { type: "callback", trampoline: "destroy" },
@@ -58,6 +61,7 @@ export class Cursor extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: fallback?.ptr ?? fallback,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
     }

package/dist/generated/gdk/device.js

@@ -163,10 +163,12 @@ export class Device extends GObject.GObject {
             {
                 type: { type: "ref", innerType: { type: "float", size: 64 } },
                 value: winX,
+                optional: true,
             },
             {
                 type: { type: "ref", innerType: { type: "float", size: 64 } },
                 value: winY,
+                optional: true,
             },
         ], { type: "gobject", borrowed: true });
         if (ptr === null)

package/dist/generated/gdk/display-manager.js

@@ -66,6 +66,7 @@ export class DisplayManager extends GObject.GObject {
             {
                 type: { type: "string" },
                 value: name,
+                optional: true,
             },
         ], { type: "gobject", borrowed: true });
         if (ptr === null)

package/dist/generated/gdk/display.js

@@ -57,6 +57,7 @@ export class Display extends GObject.GObject {
             {
                 type: { type: "string" },
                 value: displayName,
+                optional: true,
             },
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, Display);
@@ -291,6 +292,7 @@ export class Display extends GObject.GObject {
                     },
                 },
                 value: keys,
+                optional: true,
             },
             {
                 type: {
@@ -301,6 +303,7 @@ export class Display extends GObject.GObject {
                     },
                 },
                 value: keyvals,
+                optional: true,
             },
             {
                 type: {
@@ -436,6 +439,7 @@ export class Display extends GObject.GObject {
                     innerType: { type: "int", size: 32, unsigned: true },
                 },
                 value: keyval,
+                optional: true,
             },
             {
                 type: {
@@ -443,6 +447,7 @@ export class Display extends GObject.GObject {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: effectiveGroup,
+                optional: true,
             },
             {
                 type: {
@@ -450,6 +455,7 @@ export class Display extends GObject.GObject {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: level,
+                optional: true,
             },
             {
                 type: {
@@ -457,6 +463,7 @@ export class Display extends GObject.GObject {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: consumed,
+                optional: true,
             },
         ], { type: "boolean" });
     }

package/dist/generated/gdk/dmabuf-formats.js

@@ -38,6 +38,7 @@ export class DmabufFormats {
                     lib: "libgtk-4.so.1",
                 },
                 value: formats2?.ptr ?? formats2,
+                optional: true,
             },
         ], { type: "boolean" });
     }

package/dist/generated/gdk/dmabuf-texture-builder.js

@@ -25,10 +25,12 @@ export class DmabufTextureBuilder extends GObject.GObject {
             {
                 type: { type: "callback", trampoline: "destroy" },
                 value: destroy,
+                optional: true,
             },
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
             {
                 type: {
@@ -199,6 +201,7 @@ export class DmabufTextureBuilder extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: colorState?.ptr ?? colorState,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -336,6 +339,7 @@ export class DmabufTextureBuilder extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: region?.ptr ?? region,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -348,6 +352,7 @@ export class DmabufTextureBuilder extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: texture?.ptr ?? texture,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/frame-clock.js

@@ -106,6 +106,7 @@ export class FrameClock extends GObject.GObject {
                     innerType: { type: "int", size: 64, unsigned: false },
                 },
                 value: refreshIntervalReturn,
+                optional: true,
             },
             {
                 type: {

package/dist/generated/gdk/functions.js

@@ -235,6 +235,7 @@ export const contentDeserializeAsync = (stream, mimeType, type, ioPriority, canc
         {
             type: { type: "gobject", borrowed: true },
             value: cancellable?.ptr ?? cancellable,
+            optional: true,
         },
         {
             type: {
@@ -244,6 +245,7 @@ export const contentDeserializeAsync = (stream, mimeType, type, ioPriority, canc
                 resultType: { type: "gobject", borrowed: true },
             },
             value: callback,
+            optional: true,
         },
     ], { type: "undefined" });
 };
@@ -315,6 +317,7 @@ export const contentRegisterDeserializer = (mimeType, type, deserialize, notify,
         {
             type: { type: "int", size: 64, unsigned: true },
             value: data,
+            optional: true,
         },
         {
             type: { type: "callback", trampoline: "destroy" },
@@ -339,6 +342,7 @@ export const contentRegisterSerializer = (type, mimeType, serialize, notify, dat
         {
             type: { type: "int", size: 64, unsigned: true },
             value: data,
+            optional: true,
         },
         {
             type: { type: "callback", trampoline: "destroy" },
@@ -372,6 +376,7 @@ export const contentSerializeAsync = (stream, mimeType, value, ioPriority, cance
         {
             type: { type: "gobject", borrowed: true },
             value: cancellable?.ptr ?? cancellable,
+            optional: true,
         },
         {
             type: {
@@ -381,6 +386,7 @@ export const contentSerializeAsync = (stream, mimeType, value, ioPriority, cance
                 resultType: { type: "gobject", borrowed: true },
             },
             value: callback,
+            optional: true,
         },
     ], { type: "undefined" });
 };

package/dist/generated/gdk/glcontext.js

@@ -72,6 +72,7 @@ export class GLContext extends DrawContext {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: major,
+                optional: true,
             },
             {
                 type: {
@@ -79,6 +80,7 @@ export class GLContext extends DrawContext {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: minor,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/gltexture-builder.js

@@ -24,10 +24,12 @@ export class GLTextureBuilder extends GObject.GObject {
             {
                 type: { type: "callback", trampoline: "destroy" },
                 value: destroy,
+                optional: true,
             },
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, Texture);
@@ -158,6 +160,7 @@ export class GLTextureBuilder extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: context?.ptr ?? context,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -218,6 +221,7 @@ export class GLTextureBuilder extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: sync,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -235,6 +239,7 @@ export class GLTextureBuilder extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: region?.ptr ?? region,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -247,6 +252,7 @@ export class GLTextureBuilder extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: texture?.ptr ?? texture,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/gltexture.js

@@ -30,6 +30,7 @@ export class GLTexture extends Texture {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: data,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
     }

package/dist/generated/gdk/memory-texture-builder.js

@@ -151,6 +151,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: bytes?.ptr ?? bytes,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -253,6 +254,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: region?.ptr ?? region,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -265,6 +267,7 @@ export class MemoryTextureBuilder extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: texture?.ptr ?? texture,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/rectangle.js

@@ -74,6 +74,7 @@ export class Rectangle {
                     },
                 },
                 value: dest,
+                optional: true,
             },
         ], { type: "boolean" });
     }

package/dist/generated/gdk/surface.js

@@ -204,10 +204,12 @@ export class Surface extends GObject.GObject {
             {
                 type: { type: "ref", innerType: { type: "float", size: 64 } },
                 value: x,
+                optional: true,
             },
             {
                 type: { type: "ref", innerType: { type: "float", size: 64 } },
                 value: y,
+                optional: true,
             },
             {
                 type: {
@@ -215,6 +217,7 @@ export class Surface extends GObject.GObject {
                     innerType: { type: "int", size: 32, unsigned: false },
                 },
                 value: mask,
+                optional: true,
             },
         ], { type: "boolean" });
     }
@@ -317,6 +320,7 @@ export class Surface extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: cursor?.ptr ?? cursor,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -350,6 +354,7 @@ export class Surface extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: region?.ptr ?? region,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -367,6 +372,7 @@ export class Surface extends GObject.GObject {
                     lib: "libgtk-4.so.1",
                 },
                 value: region?.ptr ?? region,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/toplevel-layout.js

@@ -114,6 +114,7 @@ export class ToplevelLayout {
             {
                 type: { type: "gobject", borrowed: true },
                 value: monitor?.ptr ?? monitor,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdk/toplevel.js

@@ -48,6 +48,7 @@ export class Toplevel {
             {
                 type: { type: "gobject", borrowed: true },
                 value: device?.ptr ?? device,
+                optional: true,
             },
             {
                 type: { type: "int", size: 32, unsigned: false },
@@ -112,6 +113,7 @@ export class Toplevel {
             {
                 type: { type: "gobject", borrowed: true },
                 value: event?.ptr ?? event,
+                optional: true,
             },
         ], { type: "undefined" });
     }

package/dist/generated/gdkpixbuf/pixbuf-animation-iter.js

@@ -22,6 +22,7 @@ export class PixbufAnimationIter extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: currentTime,
+                optional: true,
             },
         ], { type: "boolean" });
     }

package/dist/generated/gdkpixbuf/pixbuf-animation.js

@@ -25,6 +25,7 @@ export class PixbufAnimation extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: cancellable?.ptr ?? cancellable,
+                optional: true,
             },
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, PixbufAnimation);
@@ -56,6 +57,7 @@ export class PixbufAnimation extends GObject.GObject {
             {
                 type: { type: "gobject", borrowed: true },
                 value: cancellable?.ptr ?? cancellable,
+                optional: true,
             },
             {
                 type: {
@@ -65,6 +67,7 @@ export class PixbufAnimation extends GObject.GObject {
                     resultType: { type: "gobject", borrowed: true },
                 },
                 value: callback,
+                optional: true,
             },
         ], { type: "undefined" });
     }
@@ -85,6 +88,7 @@ export class PixbufAnimation extends GObject.GObject {
             {
                 type: { type: "int", size: 64, unsigned: true },
                 value: startTime,
+                optional: true,
             },
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, PixbufAnimationIter);