@gtkx/native 1.6.0 → 2.0.0-beta.10

package/README.md

@@ -5,15 +5,15 @@
 <h1 align="center">GTKX</h1>
 
 <p align="center">
-  The React framework for Linux, built on GTK.<br />
-  Write native GTK4 desktop applications with React and TypeScript.
-  Real GTK widgets, the GNOME stack, and standard web tooling.
+  The React framework for Linux.<br />
+  Write native GNOME applications with React and TypeScript.
+  Real Adwaita and GTK4 widgets with standard web tooling.
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
   <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
-  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <img src="https://img.shields.io/badge/node-%E2%89%A526.7-339933?logo=node.js&logoColor=white" alt="Node >= 26.7" />
   <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
   <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
   <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
@@ -38,11 +38,12 @@
 
 ## Demo
 
-The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
+This app starts with an Adwaita application shell, renders native GTK4 widgets inside it, and uses ordinary React hooks and events:
 
 ```tsx
 import * as Gtk from "@gtkx/gi/gtk";
-import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { AdwApplication, AdwApplicationWindow, AdwHeaderBar, AdwToolbarView } from "@gtkx/jsx/adw";
+import { GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
 import { createRoot, quit } from "@gtkx/react";
 import { useState } from "react";
 
@@ -50,38 +51,40 @@ const Counter = () => {
   const [count, setCount] = useState(0);
 
   return (
-    <GtkApplicationWindow
+    <AdwApplicationWindow
       title="Hello GTKX"
       defaultWidth={400}
       defaultHeight={300}
       onCloseRequest={quit}
     >
-      <GtkBox
-        orientation={Gtk.Orientation.VERTICAL}
-        spacing={20}
-        marginTop={40}
-        marginBottom={40}
-        marginStart={40}
-        marginEnd={40}
-        valign={Gtk.Align.CENTER}
-        halign={Gtk.Align.CENTER}
-      >
-        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
-        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
-        <GtkButton
-          label="Increment"
-          onClicked={() => setCount((c) => c + 1)}
-          cssClasses={["suggested-action", "pill"]}
-        />
-      </GtkBox>
-    </GtkApplicationWindow>
+      <AdwToolbarView topBar={<AdwHeaderBar />}>
+        <GtkBox
+          orientation={Gtk.Orientation.VERTICAL}
+          spacing={20}
+          marginTop={40}
+          marginBottom={40}
+          marginStart={40}
+          marginEnd={40}
+          valign={Gtk.Align.CENTER}
+          halign={Gtk.Align.CENTER}
+        >
+          <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+          <GtkLabel cssClasses={["title-2"]}>{`Count: ${String(count)}`}</GtkLabel>
+          <GtkButton
+            label="Increment"
+            onClicked={() => setCount((c) => c + 1)}
+            cssClasses={["suggested-action", "pill"]}
+          />
+        </GtkBox>
+      </AdwToolbarView>
+    </AdwApplicationWindow>
   );
 };
 
 const App = () => (
-  <GtkApplication>
+  <AdwApplication>
     <Counter />
-  </GtkApplication>
+  </AdwApplication>
 );
 
 createRoot().render(<App />);
@@ -91,9 +94,9 @@ This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/
 
 ## Why GTKX
 
-### A declarative layer for the GNOME stack
+### Adwaita-first application development
 
-GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+GTKX uses Adwaita as the foundation for applications, windows, navigation, dialogs, and adaptive layouts, with the complete GTK4 toolkit underneath. It adds a declarative React layer and an integrated TypeScript toolchain to the GNOME platform:
 
 - a React reconciler that exposes every GObject as a JSX element,
 - a CLI for scaffolding, development, and production builds,
@@ -102,29 +105,29 @@ GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing r
 - a Testing Library-style API for querying and driving your widgets in tests,
 - and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
 
-### The full GNOME API surface
+### Native GNOME widgets, without a compatibility layer
 
-React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX renders real Adwaita and GTK4 widgets and exposes any other GObject-Introspection library on your system. It is GNOME-native and Linux-only by design.
 
 ### Why Node.js, and why generated bindings
 
 GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [Why GTKX guide](https://gtkx.dev/guide/why-gtkx) covers what running on Node.js means day to day.
 
-GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+GTKX generates the TypeScript types and native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. `Adw-1` is the sole default GIR root; its GIR include pulls in `Gtk-4.0`, so codegen covers both complete API surfaces. Neither belongs in a GTKX 2 `libraries` list.
 
-At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
+At runtime, the native Rust core calls straight into the system Adwaita, GTK4, and GLib libraries through libffi, without loading libgirepository at all.
 
 ## Quick start
 
-GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+GTKX is Linux-only and needs Node.js 26.7 or later. See [Requirements](#requirements).
 
 Scaffold a new app with the `create-gtkx` initializer:
 
 ```sh
-npm create gtkx
+npm create gtkx@beta
 ```
 
-The same command works with other package managers: `pnpm create gtkx` or `yarn create gtkx`.
+The same command works with other package managers: `pnpm create gtkx@beta` or `yarn create gtkx@beta`.
 
 Then run your new app:
 
@@ -145,8 +148,8 @@ The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tu
 
 GTKX is Linux-only. You need:
 
-- Linux with the GTK4 (4.20 or later) and GLib development libraries, plus Adwaita (1.8 or later) once your project binds `Adw-1`
-- Node.js 24 or later
+- Linux with the Adwaita (1.8 or later), GTK4 (4.20 or later), and GLib development libraries
+- Node.js 26.7 or later
 
 The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
 
@@ -154,10 +157,10 @@ The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other tar
 
 Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 
-- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
-- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
-- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
-- [`animations`](https://github.com/gtkx-org/gtkx/tree/main/examples/animations): a tour of `@gtkx/animated`, React Spring animations driven by the GTK frame clock.
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the Adwaita counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): the official GTK4 widget showcase in an Adwaita application shell, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): an Adwaita browser built around `WebKitWebView`.
+- [`animations`](https://github.com/gtkx-org/gtkx/tree/main/examples/animations): an Adwaita showcase for `@gtkx/animated`, with React Spring animations driven by the GTK frame clock.
 - [`navigation`](https://github.com/gtkx-org/gtkx/tree/main/examples/navigation): a tour of `@gtkx/navigation`, React Navigation's stack, tab, and drawer navigators rendered with libadwaita.
 - [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
 
@@ -167,7 +170,7 @@ GTKX is stable and ready for production use.
 
 ## Contributing
 
-Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 26.7 or later, pnpm, and a Rust toolchain.
 
 ## License
 

package/index.d.ts

@@ -7,13 +7,26 @@ export declare class ExternalObject<T> {
     [K: symbol]: T
   }
 }
+/**
+ * Registers `listener` for every `GLib` log record the process writes, whichever thread logs it,
+ * and returns the id `removeLogListener` takes. The public `onLog` wrapper in `main.js` pairs the
+ * two into a subscription. Records are queued to the JavaScript thread and delivered
+ * asynchronously; a level `GLib` treats as fatal aborts the process before the queued delivery
+ * runs, and removing a listener does not cancel records already queued for it.
+ */
+export declare function addLogListener(listener: (level: "error" | "critical" | "warning" | "message" | "info" | "debug", domain: string, message: string) => void): number
+
 /**
  * Allocates a zero-filled native memory block of `size` bytes and returns an opaque handle to it.
- * The optional `gtype` must be a registered boxed `GType` and selects `g_boxed_free` as the
- * handle's destructor instead of `g_free`.
+ * A `gtype` naming a registered boxed type selects `g_boxed_free` as the handle's destructor, so a
+ * type whose free function has to run is torn down properly. A `gtype` that is registered but not
+ * boxed, such as one from `g_pointer_type_register_static`, has no boxed free function to select,
+ * so the handle owns the block as a plain struct and releases it with `g_free`.
  */
 export declare function alloc(size: number, gtype?: bigint | undefined | null): ExternalObject<Handle>
 
+export declare function armParentDeath(expectedParent: number, expectedProcessGroupOwner?: number | undefined | null, expectedProcessGroupOwnerStartTime?: string | undefined | null): boolean
+
 /**
  * Container layout used to marshal an array: a plain C `array`, a `glist`, `gslist`, `gptrarray`,
  * `garray`, `gbytearray`, a `sized` buffer, a `fixed`-length buffer, or a `cursor` pointing into
@@ -115,7 +128,9 @@ export type CallbackScope =  'call'|
 
 /**
  * Copies `size` bytes from the `src` handle's memory into the `dest` handle's memory, rejecting
- * either handle when it points at nothing rather than reading or writing at address zero.
+ * either handle when it points at nothing rather than reading or writing at address zero. A
+ * handle that records how many bytes it allocated also rejects a size reaching past them; one
+ * over memory C returned records no count, so its bounds are the caller's to respect.
  */
 export declare function copy(dest: ExternalObject<Handle>, src: ExternalObject<Handle>, size: number): unknown
 
@@ -136,21 +151,30 @@ export type Descriptor =
   | { kind: 'biguint64' }
   | { kind: 'float32' }
   | { kind: 'float64' }
-  | { kind: 'enum', sharedLibrary: string, getTypeFnName: string, isSigned: boolean }
-  | { kind: 'flags', sharedLibrary: string, getTypeFnName: string, isSigned: boolean, mask?: number }
-  | { kind: 'boolean' }
-  | { kind: 'string', ownership: Ownership, length?: number }
-  | { kind: 'object', ownership: Ownership, isCallScoped?: boolean }
-  | { kind: 'unichar' }
-  | { kind: 'void' }
-  | { kind: 'buffer' }
-  | { kind: 'boxed', ownership: Ownership, typeName: string, sharedLibrary?: string, getTypeFnName?: string, freeFnName?: string, isCallerAllocated?: boolean, size?: number, isInline?: boolean }
-  | { kind: 'struct', ownership: Ownership, size?: number, isCallerAllocated?: boolean, isInline?: boolean }
-  | { kind: 'fundamental', ownership: Ownership, sharedLibrary: string, refFnName: string, unrefFnName: string, typeName?: string, isCallerAllocated?: boolean, isInline?: boolean }
-  | { kind: 'array', itemDescriptor: Descriptor, arrayKind: ArrayKind, ownership: Ownership, baseParamIndex?: number, sizeParamIndex?: number, fixedSize?: number, elementSize?: number, isBytes?: boolean, isCallerAllocated?: boolean }
-  | { kind: 'hashtable', keyDescriptor: Descriptor, valueDescriptor: Descriptor, ownership: Ownership }
-  | { kind: 'callback', argDescriptors: Array<Descriptor>, returnDescriptor: Descriptor, hasDestroy?: boolean, destroyKind?: DestroyNotifyKind, hasUserData?: boolean, userDataIndex?: number, canThrow?: boolean, scope?: CallbackScope }
-  | { kind: 'ref', innerDescriptor: Descriptor, inout?: boolean }
+  | { kind: 'enum', sharedLibrary: string, getTypeFnName: string, isSigned: boolean, /**
+   * Member values of an enumeration with no registered `GType`, which the GIR is the only
+   * source of. `None` leaves the membership check to the `GType`'s `GEnumClass`.
+   */
+members?: Array<number> }
+| { kind: 'flags', sharedLibrary: string, getTypeFnName: string, isSigned: boolean, mask?: number }
+| { kind: 'boolean' }
+| { kind: 'string', ownership: Ownership, length?: number, /**
+ * Whether the instance holding the slot owns the string in it, so that a write releases
+ * what it displaces. Set only on record fields GIR spells as a non-`const` `char *`.
+ */
+hasOwnedStorage?: boolean }
+| { kind: 'object', ownership: Ownership, isCallScoped?: boolean, /** `GType` name of the declared type, which an argument's instance must be one of. */
+typeName?: string }
+| { kind: 'unichar' }
+| { kind: 'void' }
+| { kind: 'buffer' }
+| { kind: 'boxed', ownership: Ownership, typeName: string, sharedLibrary?: string, getTypeFnName?: string, freeFnName?: string, isCallerAllocated?: boolean, size?: number, isInline?: boolean }
+| { kind: 'struct', ownership: Ownership, size?: number, isCallerAllocated?: boolean, isInline?: boolean, sharedLibrary?: string, copyFnName?: string, freeFnName?: string }
+| { kind: 'fundamental', ownership: Ownership, sharedLibrary: string, refFnName: string, unrefFnName: string, typeName?: string, isCallerAllocated?: boolean, isInline?: boolean }
+| { kind: 'array', itemDescriptor: Descriptor, arrayKind: ArrayKind, ownership: Ownership, baseParamIndex?: number, sizeParamIndex?: number, fixedSize?: number, elementSize?: number, isBytes?: boolean, isCallerAllocated?: boolean, isZeroTerminated?: boolean, preserveNull?: boolean }
+| { kind: 'hashtable', keyDescriptor: Descriptor, valueDescriptor: Descriptor, ownership: Ownership }
+| { kind: 'callback', argDescriptors: Array<Descriptor>, returnDescriptor: Descriptor, hasDestroy?: boolean, destroyKind?: DestroyNotifyKind, hasUserData?: boolean, userDataIndex?: number, canThrow?: boolean, scope?: CallbackScope }
+| { kind: 'ref', innerDescriptor: Descriptor, inout?: boolean }
 
 /**
  * Signature of the destroy the callee is handed: `destroyNotify` is a `GDestroyNotify`, taking the
@@ -324,6 +348,12 @@ export interface RegisterClassVfunc {
   fn: (...args: never[]) => unknown
 }
 
+/**
+ * Removes the listener `addLogListener` returned `id` for; an unknown or already removed id is
+ * ignored.
+ */
+export declare function removeLogListener(id: number): void
+
 /**
  * Calls the `getTypeFnName` registration function in `sharedLibrary` and returns the resulting
  * `GType`, or 0 when the symbol is absent.
@@ -344,6 +374,17 @@ export declare function setFundamentalWrapper(handle: ExternalObject<Handle>, wr
  */
 export declare function setWrapper(handle: ExternalObject<Handle>, wrapper: object): void
 
+/**
+ * Resolves `symbolName` in `sharedLibrary` to the address it is exported at. It is how a binding
+ * names a C function it never calls itself, for a callee that stores the pointer — the way
+ * `g_closure_set_marshal` takes `g_cclosure_marshal_generic`.
+ *
+ * # Errors
+ *
+ * Fails when the library cannot be loaded or does not export the symbol.
+ */
+export declare function symbolAddress(sharedLibrary: string, symbolName: string): bigint
+
 /**
  * Encodes `value` with `fieldDescriptor` and writes it into the handle's memory at `offset` bytes,
  * rejecting a handle that points at nothing rather than writing at the bare offset.

package/index.js

@@ -5,7 +5,6 @@
 
 import { createRequire } from 'module'
 const require = createRequire(import.meta.url)
-const __dirname = new URL('.', import.meta.url).pathname
 
 const { readFileSync } = require('fs')
 let nativeBinding = null
@@ -81,8 +80,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-android-arm64')
         const bindingPackageVersion = require('@gtkx/native-android-arm64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -97,8 +96,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-android-arm-eabi')
         const bindingPackageVersion = require('@gtkx/native-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -118,8 +117,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-win32-x64-gnu')
         const bindingPackageVersion = require('@gtkx/native-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -134,8 +133,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-win32-x64-msvc')
         const bindingPackageVersion = require('@gtkx/native-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -151,8 +150,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-win32-ia32-msvc')
         const bindingPackageVersion = require('@gtkx/native-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -167,8 +166,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-win32-arm64-msvc')
         const bindingPackageVersion = require('@gtkx/native-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -186,8 +185,8 @@ function requireNative() {
     try {
       const binding = require('@gtkx/native-darwin-universal')
       const bindingPackageVersion = require('@gtkx/native-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -202,8 +201,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-darwin-x64')
         const bindingPackageVersion = require('@gtkx/native-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -218,8 +217,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-darwin-arm64')
         const bindingPackageVersion = require('@gtkx/native-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -238,8 +237,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-freebsd-x64')
         const bindingPackageVersion = require('@gtkx/native-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -254,8 +253,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-freebsd-arm64')
         const bindingPackageVersion = require('@gtkx/native-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -275,8 +274,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-x64-musl')
           const bindingPackageVersion = require('@gtkx/native-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -291,8 +290,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-x64-gnu')
           const bindingPackageVersion = require('@gtkx/native-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -309,8 +308,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-arm64-musl')
           const bindingPackageVersion = require('@gtkx/native-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -325,8 +324,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-arm64-gnu')
           const bindingPackageVersion = require('@gtkx/native-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -343,8 +342,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-arm-musleabihf')
           const bindingPackageVersion = require('@gtkx/native-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -359,8 +358,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@gtkx/native-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -377,8 +376,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-loong64-musl')
           const bindingPackageVersion = require('@gtkx/native-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -393,8 +392,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-loong64-gnu')
           const bindingPackageVersion = require('@gtkx/native-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -411,8 +410,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-riscv64-musl')
           const bindingPackageVersion = require('@gtkx/native-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -427,8 +426,8 @@ function requireNative() {
         try {
           const binding = require('@gtkx/native-linux-riscv64-gnu')
           const bindingPackageVersion = require('@gtkx/native-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -444,8 +443,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-linux-ppc64-gnu')
         const bindingPackageVersion = require('@gtkx/native-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -460,8 +459,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-linux-s390x-gnu')
         const bindingPackageVersion = require('@gtkx/native-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -480,8 +479,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-openharmony-arm64')
         const bindingPackageVersion = require('@gtkx/native-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -496,8 +495,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-openharmony-x64')
         const bindingPackageVersion = require('@gtkx/native-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -512,8 +511,8 @@ function requireNative() {
       try {
         const binding = require('@gtkx/native-openharmony-arm')
         const bindingPackageVersion = require('@gtkx/native-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '1.6.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0-beta.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -652,8 +651,8 @@ if (!nativeBinding || forceWasi) {
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
           const bindingPackageVersion = require('@gtkx/native-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '1.6.0') {
-            throw new Error(`WASI binding package version mismatch, expected 1.6.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0-beta.10') {
+            throw new Error(`WASI binding package version mismatch, expected 2.0.0-beta.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@gtkx/native-wasm32-wasi')
@@ -703,8 +702,10 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { alloc, ArrayKind, bind, bindField, bindFunctionPointer, bindVfunc, call, CallbackScope, copy, DestroyNotifyKind, getFundamentalWrapper, getType, getTypeClass, getWrapper, init, keepAlive, newObject, Ownership, quit, read, readField, registerClass, resolveType, setFundamentalWrapper, setWrapper, write, writeField } = nativeBinding
+const { addLogListener, alloc, armParentDeath, ArrayKind, bind, bindField, bindFunctionPointer, bindVfunc, call, CallbackScope, copy, DestroyNotifyKind, getFundamentalWrapper, getType, getTypeClass, getWrapper, init, keepAlive, newObject, Ownership, quit, read, readField, registerClass, removeLogListener, resolveType, setFundamentalWrapper, setWrapper, symbolAddress, write, writeField } = nativeBinding
+export { addLogListener }
 export { alloc }
+export { armParentDeath }
 export { ArrayKind }
 export { bind }
 export { bindField }
@@ -726,8 +727,10 @@ export { quit }
 export { read }
 export { readField }
 export { registerClass }
+export { removeLogListener }
 export { resolveType }
 export { setFundamentalWrapper }
 export { setWrapper }
+export { symbolAddress }
 export { write }
 export { writeField }

package/internal.d.ts

@@ -0,0 +1 @@
+export { armParentDeath } from "./index.js";

package/internal.js

@@ -0,0 +1 @@
+export { armParentDeath } from "./index.js";

package/main.d.ts

@@ -24,3 +24,23 @@ declare module "./index.js" {
      */
     export type Ref = { value: unknown };
 }
+
+type LogLevel = "error" | "critical" | "warning" | "message" | "info" | "debug";
+
+type LogListener = (level: LogLevel, domain: string, message: string) => void;
+
+type LogSubscription = { unsubscribe(): void };
+
+/**
+ * Subscribes `listener` to every GLib log record the process writes, whichever thread logs it,
+ * and returns the subscription whose `unsubscribe` removes it again. The listener receives the
+ * level name, the log domain and the message. Records are queued to the JavaScript thread and
+ * delivered asynchronously, so a check that reads what the listener collected has to yield to the
+ * event loop once after the logging call. A level GLib treats as fatal, including one made fatal
+ * through `logSetAlwaysFatal`, aborts the process before the queued delivery runs, so such a
+ * listener never sees it. `unsubscribe` stops further records from being queued but does not cancel
+ * the ones already queued, so the listener can still run for those after `unsubscribe` returns.
+ */
+declare function onLog(listener: LogListener): LogSubscription;
+
+export { type LogLevel, type LogListener, type LogSubscription, onLog };

package/main.js

@@ -1,3 +1,15 @@
-import "./init.js";
+import "./bootstrap.js";
+import { addLogListener, removeLogListener } from "./index.js";
+
+const onLog = (listener) => {
+    const id = addLogListener(listener);
+
+    return {
+        unsubscribe: () => {
+            removeLogListener(id);
+        },
+    };
+};
 
 export * from "./index.js";
+export { onLog };

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@gtkx/native",
-  "version": "1.6.0",
-  "description": "Rust addon for GTK: loads libraries, marshals values, tracks GObjects.",
+  "version": "2.0.0-beta.10",
+  "description": "Rust FFI addon for the GTKX GNOME stack and GObject libraries.",
   "keywords": [
     "gtkx",
     "gtk",
     "gtk4",
+    "adwaita",
+    "gnome",
     "native",
     "ffi",
     "rust",
@@ -30,16 +32,22 @@
     ".": {
       "types": "./main.d.ts",
       "default": "./main.js"
+    },
+    "./internal": {
+      "types": "./internal.d.ts",
+      "default": "./internal.js"
     }
   },
   "sideEffects": [
-    "./init.js",
+    "./bootstrap.js",
     "./main.js"
   ],
   "files": [
+    "bootstrap.js",
     "index.js",
     "index.d.ts",
-    "init.js",
+    "internal.js",
+    "internal.d.ts",
     "main.js",
     "main.d.ts"
   ],
@@ -62,17 +70,6 @@
         {
           "runtime": "uname -m"
         }
-      ],
-      "crateTests": [
-        "crate",
-        "sharedGlobals",
-        "{projectRoot}/tests/**/*",
-        "{projectRoot}/test-support/**/*",
-        "{workspaceRoot}/scripts/run-headless.ts",
-        "{workspaceRoot}/scripts/cargo-nightly.ts",
-        "{workspaceRoot}/scripts/coverage-target.ts",
-        "{workspaceRoot}/scripts/rust-nightly.ts",
-        "{workspaceRoot}/packages/utils/src/**/*"
       ]
     },
     "targets": {
@@ -94,54 +91,13 @@
           "{projectRoot}/native.*.node"
         ]
       },
-      "test": {
-        "dependsOn": [
-          "build",
-          "test:asan",
-          "test:miri"
-        ],
-        "cache": true,
-        "inputs": [
-          "crateTests"
-        ],
-        "outputs": []
-      },
-      "test:asan": {
-        "dependsOn": [
-          "build"
-        ],
-        "cache": true,
-        "inputs": [
-          "crateTests"
-        ],
-        "outputs": []
-      },
-      "test:miri": {
-        "dependsOn": [
-          "build"
-        ],
-        "cache": true,
-        "inputs": [
-          "crateTests"
-        ],
-        "outputs": []
-      },
-      "coverage": {
-        "dependsOn": [
-          "build"
-        ],
-        "cache": true,
-        "inputs": [
-          "crateTests"
-        ],
-        "outputs": [
-          "{projectRoot}/coverage/**"
-        ]
-      },
       "lint:rust": {
         "cache": true,
         "inputs": [
-          "crateTests"
+          "crate",
+          "{workspaceRoot}/rustfmt.toml",
+          "{workspaceRoot}/scripts/cargo-nightly.ts",
+          "{workspaceRoot}/scripts/rust-nightly.ts"
         ],
         "outputs": []
       },
@@ -170,28 +126,31 @@
           "create-npm-dirs"
         ],
         "cache": false
+      },
+      "test": {
+        "dependsOn": [
+          "build"
+        ],
+        "cache": true
       }
     }
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=26.7.0"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.8.6"
+    "@gtkx/vitest": "2.0.0-beta.10",
+    "@napi-rs/cli": "^3.9.0"
   },
   "optionalDependencies": {
-    "@gtkx/native-linux-arm64-gnu": "1.6.0",
-    "@gtkx/native-linux-x64-gnu": "1.6.0"
+    "@gtkx/native-linux-arm64-gnu": "2.0.0-beta.10",
+    "@gtkx/native-linux-x64-gnu": "2.0.0-beta.10"
   },
   "scripts": {
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release --esm --no-dts-cache --no-const-enum",
-    "coverage": "mkdir -p coverage && tsx ../../scripts/coverage-target.ts && tsx ../../scripts/run-headless.ts cargo +nightly llvm-cov --lcov --output-path coverage/native.lcov.info --fail-under-lines 70 -- --test-threads=1",
     "create-npm-dirs": "napi create-npm-dirs",
     "lint:rust": "tsx ../../scripts/cargo-nightly.ts fmt --check && cargo clippy --all-targets -- -D warnings",
-    "test:asan": "RUSTFLAGS=\"-Zsanitizer=address\" ASAN_OPTIONS=\"detect_leaks=1:abort_on_error=1:detect_stack_use_after_return=1\" tsx ../../scripts/run-headless.ts cargo +nightly test --target x86_64-unknown-linux-gnu -- --test-threads=1",
-    "test:miri": "tsx ../../scripts/run-headless.ts cargo +nightly miri test --test integer_codec --test descriptor_into_codec",
-    "test": "tsx ../../scripts/run-headless.ts cargo test -- --test-threads=1",
     "release": "tsx ../../scripts/prepublish-native.ts && tsx ../../scripts/release-package.ts"
   }
 }