@gtkx/ffi 0.3.4 → 0.3.5

package/README.md

@@ -41,7 +41,14 @@ Edit your code and see changes instantly—no restart needed.
 ### Example
 
 ```tsx
-import { render, ApplicationWindow, Box, Button, Label, quit } from "@gtkx/react";
+import {
+  render,
+  ApplicationWindow,
+  Box,
+  Button,
+  Label,
+  quit,
+} from "@gtkx/react";
 import { Orientation } from "@gtkx/ffi/gtk";
 import { useState } from "react";
 
@@ -74,7 +81,7 @@ const primary = css`
   color: white;
 `;
 
-<Button label="Click me" cssClasses={[primary]} />
+<Button label="Click me" cssClasses={[primary]} />;
 ```
 
 GTK also provides built-in classes like `suggested-action`, `destructive-action`, `card`, and `heading`.
@@ -90,7 +97,9 @@ afterEach(() => cleanup());
 test("increments count", async () => {
   await render(<App />);
 
-  const button = await screen.findByRole(AccessibleRole.BUTTON, { name: "Increment" });
+  const button = await screen.findByRole(AccessibleRole.BUTTON, {
+    name: "Increment",
+  });
   await userEvent.click(button);
 
   await screen.findByText("Count: 1");
@@ -103,10 +112,10 @@ User events: `click`, `dblClick`, `type`, `clear`, `tab`, `selectOptions`
 
 ## Examples
 
-| Example | Description |
-| ------- | ----------- |
-| [gtk4-demo](examples/gtk4-demo) | Widget showcase |
-| [todo](examples/todo) | Todo app with tests |
+| Example                         | Description         |
+| ------------------------------- | ------------------- |
+| [gtk4-demo](examples/gtk4-demo) | Widget showcase     |
+| [todo](examples/todo)           | Todo app with tests |
 
 ```bash
 cd examples/gtk4-demo && pnpm dev
@@ -114,15 +123,15 @@ cd examples/gtk4-demo && pnpm dev
 
 ## Packages
 
-| Package | Description |
-| ------- | ----------- |
-| [@gtkx/cli](packages/cli) | CLI with HMR dev server |
-| [@gtkx/react](packages/react) | React reconciler and JSX components |
-| [@gtkx/ffi](packages/ffi) | TypeScript bindings for GTK4/GLib/GIO |
-| [@gtkx/native](packages/native) | Rust native module (libffi bridge) |
-| [@gtkx/css](packages/css) | CSS-in-JS styling |
-| [@gtkx/testing](packages/testing) | Testing utilities |
-| [@gtkx/gir](packages/gir) | GObject Introspection parser |
+| Package                           | Description                           |
+| --------------------------------- | ------------------------------------- |
+| [@gtkx/cli](packages/cli)         | CLI with HMR dev server               |
+| [@gtkx/react](packages/react)     | React reconciler and JSX components   |
+| [@gtkx/ffi](packages/ffi)         | TypeScript bindings for GTK4/GLib/GIO |
+| [@gtkx/native](packages/native)   | Rust native module (libffi bridge)    |
+| [@gtkx/css](packages/css)         | CSS-in-JS styling                     |
+| [@gtkx/testing](packages/testing) | Testing utilities                     |
+| [@gtkx/gir](packages/gir)         | GObject Introspection parser          |
 
 ## Requirements
 
@@ -136,7 +145,6 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 - [Report a bug](https://github.com/eugeniodepalo/gtkx/issues/new?template=bug_report.md)
 - [Request a feature](https://github.com/eugeniodepalo/gtkx/issues/new?template=feature_request.md)
-- [Read the Code of Conduct](CODE_OF_CONDUCT.md)
 
 ## License
 

package/dist/native.d.ts

@@ -35,6 +35,14 @@ type TypeWithGlibTypeName<T extends NativeObject> = {
  * @throws Error if the object does not implement the interface/class
  */
 export declare const getInterface: <T extends NativeObject>(obj: NativeObject, targetType: TypeWithGlibTypeName<T>) => T;
+/**
+ * Attempts to cast an object to a specific interface or class type.
+ * Returns null if the object does not implement the requested interface.
+ * @param obj - The object to get the interface from
+ * @param targetType - The interface or class type to cast to
+ * @returns The object typed as the target type, or null if not implemented
+ */
+export declare const tryGetInterface: <T extends NativeObject>(obj: NativeObject, targetType: TypeWithGlibTypeName<T>) => T | null;
 /**
  * Starts the GTK application with the given application ID.
  * Sets up a keep-alive timer to prevent Node.js from exiting.

package/dist/native.js

@@ -69,6 +69,22 @@ export const getInterface = (obj, targetType) => {
     }
     return obj;
 };
+/**
+ * Attempts to cast an object to a specific interface or class type.
+ * Returns null if the object does not implement the requested interface.
+ * @param obj - The object to get the interface from
+ * @param targetType - The interface or class type to cast to
+ * @returns The object typed as the target type, or null if not implemented
+ */
+export const tryGetInterface = (obj, targetType) => {
+    const targetGType = typeFromName(targetType.glibTypeName);
+    if (targetGType === 0)
+        return null;
+    const objId = getObjectId(obj.id);
+    if (!typeCheckInstanceIsA(objId, targetGType))
+        return null;
+    return obj;
+};
 const keepAlive = () => {
     keepAliveTimeout = setTimeout(() => keepAlive(), 2147483647);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/ffi",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Generated TypeScript FFI bindings for GTK4 libraries",
   "keywords": [
     "gtk",
@@ -46,10 +46,10 @@
     "dist"
   ],
   "dependencies": {
-    "@gtkx/native": "0.3.4"
+    "@gtkx/native": "0.3.5"
   },
   "devDependencies": {
-    "@gtkx/gir": "0.3.4"
+    "@gtkx/gir": "0.3.5"
   },
   "scripts": {
     "build": "tsc -b && cp ../../README.md .",