@gtkx/react 0.11.1 → 0.12.1

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/jsx.d.ts

@@ -84,7 +84,7 @@ export type StringListItemProps = {
  *
  * @see {@link GridChild} for usage
  */
-export type GridChildProps = SlotProps & {
+export type GridChildProps = Omit<SlotProps, "id"> & {
     /** Column index (0-based) */
     column?: number;
     /** Row index (0-based) */
@@ -99,7 +99,7 @@ export type GridChildProps = SlotProps & {
  *
  * @see {@link FixedChild} for usage
  */
-export type FixedChildProps = SlotProps & {
+export type FixedChildProps = Omit<SlotProps, "id"> & {
     /** X coordinate in pixels */
     x?: number;
     /** Y coordinate in pixels */
@@ -153,7 +153,7 @@ export type ColumnViewRootProps<C extends string = string> = {
 /**
  * Props for notebook (tabbed) pages.
  */
-export type NotebookPageProps = SlotProps & {
+export type NotebookPageProps = Omit<SlotProps, "id"> & {
     /** Tab label text (optional when using Notebook.PageTab) */
     label?: string;
 };
@@ -164,7 +164,7 @@ export type NotebookPageTabProps = SlotProps;
 /**
  * Props for the root Stack component.
  */
-export type StackRootProps = SlotProps & {
+export type StackRootProps = Omit<SlotProps, "id"> & {
     /** Name of the currently visible child page */
     visibleChildName?: string;
 };
@@ -173,7 +173,7 @@ export type StackRootProps = SlotProps & {
  *
  * @see {@link StackPage} for usage
  */
-export type StackPageProps = SlotProps & {
+export type StackPageProps = Omit<SlotProps, "id"> & {
     /** Unique name for this page (used with visibleChildName) */
     name?: string;
     /** Display title shown in stack switchers */
@@ -227,7 +227,7 @@ export type MenuSubmenuProps = {
 /**
  * Props for children within an Overlay container.
  */
-export type OverlayChildProps = SlotProps & {
+export type OverlayChildProps = Omit<SlotProps, "id"> & {
     /** Whether to include this child in size measurement */
     measure?: boolean;
     /** Whether to clip this overlay child to the main child bounds */

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/nodes/slot.d.ts

@@ -1,9 +1,10 @@
 import type * as Gtk from "@gtkx/ffi/gtk";
 import type { SlotProps } from "../jsx.js";
 import type { Node } from "../node.js";
+import type { Props } from "../types.js";
 import { VirtualNode } from "./virtual.js";
 type SlotNodeProps = Omit<SlotProps, "children">;
-export declare class SlotNode<P extends SlotNodeProps = SlotNodeProps> extends VirtualNode<P> {
+export declare class SlotNode<P extends Props = SlotNodeProps> extends VirtualNode<P> {
     static priority: number;
     static matches(type: string): boolean;
     parent?: Gtk.Widget;

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,6 +1,6 @@
 {
   "name": "@gtkx/react",
-  "version": "0.11.1",
+  "version": "0.12.1",
   "description": "Build GTK4 desktop applications with React and TypeScript",
   "keywords": [
     "gtkx",
@@ -37,8 +37,8 @@
   ],
   "dependencies": {
     "react-reconciler": "^0.33.0",
-    "@gtkx/ffi": "0.11.1",
-    "@gtkx/gir": "0.11.1"
+    "@gtkx/ffi": "0.12.1",
+    "@gtkx/gir": "0.12.1"
   },
   "devDependencies": {
     "@types/react-reconciler": "^0.32.3"