@gtkx/react 0.11.0 → 0.12.0

package/dist/host-config.js

@@ -1,4 +1,4 @@
-import { beginBatch, endBatch, getObjectId } from "@gtkx/ffi";
+import { beginBatch, endBatch, getNativeId } from "@gtkx/ffi";
 import React from "react";
 import { createNode } from "./factory.js";
 import { signalStore } from "./nodes/internal/signal-store.js";
@@ -8,7 +8,7 @@ if (!globalThis.__GTKX_CONTAINER_NODE_CACHE__) {
 }
 const containerNodeCache = globalThis.__GTKX_CONTAINER_NODE_CACHE__;
 const getOrCreateContainerNode = (container) => {
-    const id = getObjectId(container.id);
+    const id = getNativeId(container.handle);
     let node = containerNodeCache.get(id);
     if (!node) {
         const type = container.constructor.glibTypeName;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./jsx.js";
 export { createPortal } from "./portal.js";
 export { reconciler } from "./reconciler.js";
-export { ApplicationContext, quit, render, setHotReloading, update, useApplication } from "./render.js";
+export { ApplicationContext, getApplication, quit, render, setHotReloading, update, useApplication, } from "./render.js";

package/dist/index.js

@@ -1,4 +1,4 @@
 export * from "./jsx.js";
 export { createPortal } from "./portal.js";
 export { reconciler } from "./reconciler.js";
-export { ApplicationContext, quit, render, setHotReloading, update, useApplication } from "./render.js";
+export { ApplicationContext, getApplication, quit, render, setHotReloading, update, useApplication, } from "./render.js";

package/dist/nodes/internal/list-item-renderer.js

@@ -1,4 +1,4 @@
-import { getObjectId } from "@gtkx/ffi";
+import { getNativeId } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { createFiberRoot } from "../../fiber-root.js";
 import { reconciler } from "../../reconciler.js";
@@ -29,7 +29,7 @@ export class ListItemRenderer {
     }
     initialize() {
         signalStore.set(this, this.factory, "setup", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const box = new Gtk.Box(Gtk.Orientation.VERTICAL, 0);
             listItem.setChild(box);
             const fiberRoot = createFiberRoot(box);
@@ -38,7 +38,7 @@ export class ListItemRenderer {
             reconciler.getInstance().updateContainer(element, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "bind", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (!fiberRoot)
                 return;
@@ -50,14 +50,14 @@ export class ListItemRenderer {
             reconciler.getInstance().updateContainer(element, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "unbind", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (!fiberRoot)
                 return;
             reconciler.getInstance().updateContainer(null, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "teardown", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (fiberRoot) {
                 reconciler.getInstance().updateContainer(null, fiberRoot, null, () => { });

package/dist/nodes/internal/signal-store.js

@@ -1,4 +1,4 @@
-import { getObjectId } from "@gtkx/ffi";
+import { getNativeId } from "@gtkx/ffi";
 import * as GObject from "@gtkx/ffi/gobject";
 const LIFECYCLE_SIGNALS = new Set([
     "realize",
@@ -27,7 +27,7 @@ class SignalStore {
         return map;
     }
     disconnect(owner, obj, signal) {
-        const objectId = getObjectId(obj.id);
+        const objectId = getNativeId(obj.handle);
         const key = `${objectId}:${signal}`;
         const ownerMap = this.ownerHandlers.get(owner);
         const existing = ownerMap?.get(key);
@@ -37,7 +37,7 @@ class SignalStore {
         }
     }
     connect(owner, obj, signal, handler) {
-        const objectId = getObjectId(obj.id);
+        const objectId = getNativeId(obj.handle);
         const key = `${objectId}:${signal}`;
         const handlerId = obj.connect(signal, handler);
         this.getOwnerMap(owner).set(key, { obj, handlerId });

package/dist/nodes/internal/tree-list-item-renderer.js

@@ -1,4 +1,4 @@
-import { getObjectId } from "@gtkx/ffi";
+import { getNativeId } from "@gtkx/ffi";
 import * as Gtk from "@gtkx/ffi/gtk";
 import { createFiberRoot } from "../../fiber-root.js";
 import { reconciler } from "../../reconciler.js";
@@ -29,7 +29,7 @@ export class TreeListItemRenderer {
     }
     initialize() {
         signalStore.set(this, this.factory, "setup", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const expander = new Gtk.TreeExpander();
             const box = new Gtk.Box(Gtk.Orientation.VERTICAL, 0);
             expander.setChild(box);
@@ -40,7 +40,7 @@ export class TreeListItemRenderer {
             reconciler.getInstance().updateContainer(element, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "bind", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (!fiberRoot)
                 return;
@@ -71,7 +71,7 @@ export class TreeListItemRenderer {
             reconciler.getInstance().updateContainer(element, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "unbind", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (!fiberRoot)
                 return;
@@ -82,7 +82,7 @@ export class TreeListItemRenderer {
             reconciler.getInstance().updateContainer(null, fiberRoot, null, () => { });
         });
         signalStore.set(this, this.factory, "teardown", (_self, listItem) => {
-            const ptr = getObjectId(listItem.id);
+            const ptr = getNativeId(listItem.handle);
             const fiberRoot = this.fiberRoots.get(ptr);
             if (fiberRoot) {
                 reconciler.getInstance().updateContainer(null, fiberRoot, null, () => { });

package/dist/reconciler.d.ts

@@ -1,9 +1,33 @@
 import { type ReconcilerInstance } from "./host-config.js";
+/**
+ * Manages the React reconciler instance for GTKX.
+ *
+ * This class wraps the React Reconciler and handles initialization
+ * including DevTools integration for development environments.
+ *
+ * @internal
+ */
 declare class Reconciler {
     private instance;
     constructor();
+    /**
+     * Returns the underlying React Reconciler instance.
+     *
+     * @returns The React Reconciler instance for direct reconciler operations
+     */
     getInstance(): ReconcilerInstance;
     private injectDevTools;
 }
+/**
+ * The GTKX React reconciler instance.
+ *
+ * Provides low-level access to the React reconciler for advanced use cases.
+ * Most applications should use {@link render} instead.
+ *
+ * @example
+ * ```tsx
+ * const instance = reconciler.getInstance();
+ * ```
+ */
 export declare const reconciler: Reconciler;
 export {};

package/dist/reconciler.js

@@ -1,12 +1,25 @@
 import ReactReconciler from "react-reconciler";
 import packageJson from "../package.json" with { type: "json" };
 import { createHostConfig } from "./host-config.js";
+/**
+ * Manages the React reconciler instance for GTKX.
+ *
+ * This class wraps the React Reconciler and handles initialization
+ * including DevTools integration for development environments.
+ *
+ * @internal
+ */
 class Reconciler {
     instance;
     constructor() {
         this.instance = ReactReconciler(createHostConfig());
         this.injectDevTools();
     }
+    /**
+     * Returns the underlying React Reconciler instance.
+     *
+     * @returns The React Reconciler instance for direct reconciler operations
+     */
     getInstance() {
         return this.instance;
     }
@@ -20,4 +33,15 @@ class Reconciler {
         });
     }
 }
+/**
+ * The GTKX React reconciler instance.
+ *
+ * Provides low-level access to the React reconciler for advanced use cases.
+ * Most applications should use {@link render} instead.
+ *
+ * @example
+ * ```tsx
+ * const instance = reconciler.getInstance();
+ * ```
+ */
 export const reconciler = new Reconciler();

package/dist/render.d.ts

@@ -35,6 +35,15 @@ export declare const ApplicationContext: React.Context<Gtk.Application | null>;
  * @see {@link ApplicationContext} for the underlying context
  */
 export declare const useApplication: () => Gtk.Application;
+/**
+ * Returns the current GTK Application instance.
+ *
+ * Returns null if no application has been rendered yet.
+ * Used by tools that need access to the running application.
+ *
+ * @returns The current GTK Application or null
+ */
+export declare const getApplication: () => Gtk.Application | null;
 /**
  * Sets the hot reloading state.
  *

package/dist/render.js

@@ -46,6 +46,17 @@ export const useApplication = () => {
 let container = null;
 let app = null;
 let isHotReloading = false;
+/**
+ * Returns the current GTK Application instance.
+ *
+ * Returns null if no application has been rendered yet.
+ * Used by tools that need access to the running application.
+ *
+ * @returns The current GTK Application or null
+ */
+export const getApplication = () => {
+    return app;
+};
 /**
  * Sets the hot reloading state.
  *

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@gtkx/react",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Build GTK4 desktop applications with React and TypeScript",
   "keywords": [
+    "gtkx",
     "gtk",
     "gtk4",
     "react",
@@ -36,8 +37,8 @@
   ],
   "dependencies": {
     "react-reconciler": "^0.33.0",
-    "@gtkx/ffi": "0.11.0",
-    "@gtkx/gir": "0.11.0"
+    "@gtkx/ffi": "0.12.0",
+    "@gtkx/gir": "0.12.0"
   },
   "devDependencies": {
     "@types/react-reconciler": "^0.32.3"