@gtkx/react 0.1.50 → 0.1.52

package/dist/batch.js

@@ -5,10 +5,15 @@ export const beginCommit = () => {
 };
 export const endCommit = () => {
     inCommit = false;
-    for (const callback of pendingFlushes) {
-        callback();
+    if (pendingFlushes.size > 0) {
+        const callbacks = [...pendingFlushes];
+        pendingFlushes.clear();
+        queueMicrotask(() => {
+            for (const callback of callbacks) {
+                callback();
+            }
+        });
     }
-    pendingFlushes.clear();
 };
 export const scheduleFlush = (callback) => {
     if (inCommit) {

package/dist/codegen/jsx-generator.js

@@ -5,6 +5,8 @@ const COLUMN_VIEW_WIDGET = "ColumnView";
 const DROPDOWN_WIDGETS = new Set(["DropDown"]);
 const GRID_WIDGETS = new Set(["Grid"]);
 const NOTEBOOK_WIDGET = "Notebook";
+const STACK_WIDGET = "Stack";
+const POPOVER_MENU_WIDGET = "PopoverMenu";
 const INTERNALLY_PROVIDED_PARAMS = {
     ApplicationWindow: new Set(["application"]),
 };
@@ -33,6 +35,8 @@ const isColumnViewWidget = (widgetName) => widgetName === COLUMN_VIEW_WIDGET;
 const isDropDownWidget = (widgetName) => DROPDOWN_WIDGETS.has(widgetName);
 const isGridWidget = (widgetName) => GRID_WIDGETS.has(widgetName);
 const isNotebookWidget = (widgetName) => widgetName === NOTEBOOK_WIDGET;
+const isStackWidget = (widgetName) => widgetName === STACK_WIDGET;
+const isPopoverMenuWidget = (widgetName) => widgetName === POPOVER_MENU_WIDGET;
 const sanitizeDoc = (doc) => {
     let result = doc;
     result = result.replace(/<picture>[\s\S]*?<\/picture>/gi, "");
@@ -140,7 +144,7 @@ export class JsxGenerator {
             `import type { ReactNode, Ref } from "react";`,
             ...externalImports,
             `import type * as Gtk from "@gtkx/ffi/gtk";`,
-            `import type { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, NotebookPageProps, SlotProps } from "../types.js";`,
+            `import type { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, MenuItemProps, MenuRootProps, MenuSectionProps, MenuSubmenuProps, NotebookPageProps, SlotProps, StackPageProps, StackRootProps } from "../types.js";`,
             "",
         ].join("\n");
     }
@@ -150,7 +154,7 @@ export class JsxGenerator {
     generateCommonTypes(widgetClass) {
         const widgetPropsContent = this.generateWidgetPropsContent(widgetClass);
         return `
-export { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, NotebookPageProps, SlotProps };
+export { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, MenuItemProps, MenuRootProps, MenuSectionProps, MenuSubmenuProps, NotebookPageProps, SlotProps, StackPageProps, StackRootProps };
 
 ${widgetPropsContent}
 `;
@@ -581,11 +585,17 @@ ${widgetPropsContent}
                 isColumnViewWidget(widget.name) ||
                 isDropDownWidget(widget.name) ||
                 isGridWidget(widget.name) ||
-                isNotebookWidget(widget.name);
+                isNotebookWidget(widget.name) ||
+                isStackWidget(widget.name) ||
+                isPopoverMenuWidget(widget.name);
             const docComment = widget.doc ? formatDoc(widget.doc).trimEnd() : "";
             if (hasMeaningfulSlots) {
                 // For list widgets, generate wrapper components with proper generics
-                if (isListWidget(widget.name) || isColumnViewWidget(widget.name) || isDropDownWidget(widget.name)) {
+                if (isListWidget(widget.name) ||
+                    isColumnViewWidget(widget.name) ||
+                    isDropDownWidget(widget.name) ||
+                    isStackWidget(widget.name) ||
+                    isPopoverMenuWidget(widget.name)) {
                     const wrapperComponents = this.generateGenericWrapperComponents(widget.name, metadata);
                     const exportMembers = this.getWrapperExportMembers(widget.name, metadata);
                     if (docComment) {
@@ -619,6 +629,38 @@ ${widgetPropsContent}
                 }
             }
         }
+        // Add ApplicationMenu and Menu namespace components
+        lines.push(`/**
+ * Sets the application-wide menu bar.
+ * The menu will appear in the window's title bar on supported platforms.
+ * Use Menu.Item, Menu.Section, and Menu.Submenu as children.
+ */
+export function ApplicationMenu(props: MenuRootProps): import("react").ReactElement {
+\treturn createElement("ApplicationMenu", props);
+}
+
+function MenuItem(props: MenuItemProps): import("react").ReactElement {
+\treturn createElement("Menu.Item", props);
+}
+
+function MenuSection(props: MenuSectionProps): import("react").ReactElement {
+\treturn createElement("Menu.Section", props);
+}
+
+function MenuSubmenu(props: MenuSubmenuProps): import("react").ReactElement {
+\treturn createElement("Menu.Submenu", props);
+}
+
+/**
+ * Declarative menu builder for use with PopoverMenu and ApplicationMenu.
+ * Use Menu.Item for action items, Menu.Section for groups, Menu.Submenu for nested menus.
+ */
+export const Menu = {
+\tItem: MenuItem,
+\tSection: MenuSection,
+\tSubmenu: MenuSubmenu,
+};
+`);
         return `${lines.join("\n")}\n`;
     }
     getWrapperExportMembers(widgetName, metadata) {
@@ -634,6 +676,14 @@ ${widgetPropsContent}
         else if (isDropDownWidget(widgetName)) {
             members.push(`Item: ${name}Item`);
         }
+        else if (isStackWidget(widgetName)) {
+            members.push(`Page: ${name}Page`);
+        }
+        else if (isPopoverMenuWidget(widgetName)) {
+            members.push(`Item: ${name}Item`);
+            members.push(`Section: ${name}Section`);
+            members.push(`Submenu: ${name}Submenu`);
+        }
         // Add named child slots
         for (const slot of metadata.namedChildSlots) {
             members.push(`${slot.slotName}: ${name}${slot.slotName}`);
@@ -710,6 +760,32 @@ ${widgetPropsContent}
             lines.push(`\treturn createElement("${name}.Item", props);`);
             lines.push(`}`);
         }
+        else if (isStackWidget(widgetName)) {
+            lines.push(`function ${name}Root(props: StackRootProps & ${name}Props): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("${name}.Root", props);`);
+            lines.push(`}`);
+            lines.push(``);
+            lines.push(`function ${name}Page(props: StackPageProps): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("${name}.Page", props);`);
+            lines.push(`}`);
+        }
+        else if (isPopoverMenuWidget(widgetName)) {
+            lines.push(`function ${name}Root(props: MenuRootProps & ${name}Props): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("${name}.Root", props);`);
+            lines.push(`}`);
+            lines.push(``);
+            lines.push(`function ${name}Item(props: MenuItemProps): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("Menu.Item", props);`);
+            lines.push(`}`);
+            lines.push(``);
+            lines.push(`function ${name}Section(props: MenuSectionProps): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("Menu.Section", props);`);
+            lines.push(`}`);
+            lines.push(``);
+            lines.push(`function ${name}Submenu(props: MenuSubmenuProps): import("react").ReactElement {`);
+            lines.push(`\treturn createElement("Menu.Submenu", props);`);
+            lines.push(`}`);
+        }
         for (const slot of metadata.namedChildSlots) {
             lines.push(``);
             lines.push(`function ${name}${slot.slotName}(props: SlotProps): import("react").ReactElement {`);
@@ -734,7 +810,9 @@ ${widgetPropsContent}
                 isColumnViewWidget(widget.name) ||
                 isDropDownWidget(widget.name) ||
                 isGridWidget(widget.name) ||
-                isNotebookWidget(widget.name);
+                isNotebookWidget(widget.name) ||
+                isStackWidget(widget.name) ||
+                isPopoverMenuWidget(widget.name);
             if (hasMeaningfulSlots) {
                 elements.push(`"${widgetName}.Root": ${propsName};`);
             }
@@ -760,7 +838,16 @@ ${widgetPropsContent}
             if (isNotebookWidget(widget.name)) {
                 elements.push(`"${widgetName}.Page": NotebookPageProps;`);
             }
+            if (isStackWidget(widget.name)) {
+                elements.push(`"${widgetName}.Page": StackPageProps;`);
+            }
         }
+        // Add shared Menu elements (used by PopoverMenu, PopoverMenuBar, and ApplicationMenu)
+        elements.push(`"Menu.Item": MenuItemProps;`);
+        elements.push(`"Menu.Section": MenuSectionProps;`);
+        elements.push(`"Menu.Submenu": MenuSubmenuProps;`);
+        // Add ApplicationMenu element
+        elements.push(`ApplicationMenu: MenuRootProps;`);
         return `
 declare global {
 \tnamespace React {

package/dist/container-interfaces.d.ts

@@ -18,6 +18,26 @@ export interface PageContainer {
     removePage(child: Gtk.Widget): void;
     updatePageLabel(child: Gtk.Widget, label: string): void;
 }
+/**
+ * Props for Stack pages.
+ */
+export interface StackPageProps {
+    name?: string;
+    title?: string;
+    iconName?: string;
+    needsAttention?: boolean;
+    visible?: boolean;
+    useUnderline?: boolean;
+}
+/**
+ * Interface for Stack containers.
+ */
+export interface StackPageContainer {
+    addStackPage(child: Gtk.Widget, props: StackPageProps): void;
+    insertStackPageBefore(child: Gtk.Widget, props: StackPageProps, beforeChild: Gtk.Widget): void;
+    removeStackPage(child: Gtk.Widget): void;
+    updateStackPageProps(child: Gtk.Widget, props: StackPageProps): void;
+}
 /**
  * Interface for grid-based containers.
  */
@@ -46,6 +66,7 @@ export interface ColumnContainer {
 }
 export declare const isChildContainer: (node: Node) => node is Node & ChildContainer;
 export declare const isPageContainer: (node: Node) => node is Node & PageContainer;
+export declare const isStackPageContainer: (node: Node) => node is Node & StackPageContainer;
 export declare const isGridContainer: (node: Node) => node is Node & GridContainer;
 export declare const isItemContainer: <T>(node: Node) => node is Node & ItemContainer<T>;
 export declare const isColumnContainer: (node: Node) => node is Node & ColumnContainer;

package/dist/container-interfaces.js

@@ -1,5 +1,6 @@
 export const isChildContainer = (node) => "attachChild" in node && "detachChild" in node && "insertChildBefore" in node;
 export const isPageContainer = (node) => "addPage" in node && "removePage" in node && "insertPageBefore" in node && "updatePageLabel" in node;
+export const isStackPageContainer = (node) => "addStackPage" in node && "removeStackPage" in node && "updateStackPageProps" in node;
 export const isGridContainer = (node) => "attachToGrid" in node && "removeFromGrid" in node;
 export const isItemContainer = (node) => "addItem" in node && "insertItemBefore" in node && "removeItem" in node;
 export const isColumnContainer = (node) => "addColumn" in node && "removeColumn" in node && "getSortFn" in node;

package/dist/factory.js

@@ -6,10 +6,12 @@ import { FlowBoxNode } from "./nodes/flow-box.js";
 import { GridChildNode, GridNode } from "./nodes/grid.js";
 import { ListItemNode, ListViewNode } from "./nodes/list.js";
 import { ListBoxNode } from "./nodes/list-box.js";
+import { ApplicationMenuNode, MenuItemNode, MenuSectionNode, MenuSubmenuNode, PopoverMenuBarNode, PopoverMenuRootNode, } from "./nodes/menu.js";
 import { NotebookNode, NotebookPageNode } from "./nodes/notebook.js";
 import { OverlayNode } from "./nodes/overlay.js";
 import { RootNode } from "./nodes/root.js";
 import { SlotNode } from "./nodes/slot.js";
+import { StackNode, StackPageNode } from "./nodes/stack.js";
 import { TextViewNode } from "./nodes/text-view.js";
 import { WidgetNode } from "./nodes/widget.js";
 import { WindowNode } from "./nodes/window.js";
@@ -23,11 +25,18 @@ const NODE_CLASSES = [
     DropDownItemNode,
     GridChildNode,
     NotebookPageNode,
+    StackPageNode,
+    MenuItemNode,
+    MenuSectionNode,
+    MenuSubmenuNode,
     SlotNode,
     // Specialized widget nodes
     WindowNode,
     AboutDialogNode,
     TextViewNode,
+    ApplicationMenuNode,
+    PopoverMenuRootNode,
+    PopoverMenuBarNode,
     // Container nodes
     ActionBarNode,
     FlowBoxNode,
@@ -38,13 +47,16 @@ const NODE_CLASSES = [
     ColumnViewNode,
     ListViewNode,
     NotebookNode,
+    StackNode,
     // Catch-all (must be last)
     WidgetNode,
 ];
 export const createNode = (type, props, existingWidget) => {
     for (const NodeClass of NODE_CLASSES) {
         if (NodeClass.matches(type, existingWidget)) {
-            return new NodeClass(type, props, existingWidget);
+            const node = new NodeClass(type, existingWidget);
+            node.initialize(props);
+            return node;
         }
     }
     throw new Error(`No matching node class for type: ${type}`);

package/dist/generated/jsx.d.ts

@@ -3,8 +3,8 @@ import type { ReactNode, Ref } from "react";
 import type * as Gdk from "@gtkx/ffi/gdk";
 import type * as Gio from "@gtkx/ffi/gio";
 import type * as Gtk from "@gtkx/ffi/gtk";
-import type { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, NotebookPageProps, SlotProps } from "../types.js";
-export { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, NotebookPageProps, SlotProps, };
+import type { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, MenuItemProps, MenuRootProps, MenuSectionProps, MenuSubmenuProps, NotebookPageProps, SlotProps, StackPageProps, StackRootProps } from "../types.js";
+export { ColumnViewColumnProps, ColumnViewRootProps, GridChildProps, ListItemProps, ListViewRenderProps, MenuItemProps, MenuRootProps, MenuSectionProps, MenuSubmenuProps, NotebookPageProps, SlotProps, StackPageProps, StackRootProps, };
 /**
  * The base class for all widgets.
  *
@@ -10043,6 +10043,10 @@ export declare const Popover: {
     Child: "Popover.Child";
     DefaultWidget: "Popover.DefaultWidget";
 };
+declare function PopoverMenuRoot(props: MenuRootProps & PopoverMenuProps): import("react").ReactElement;
+declare function PopoverMenuItem(props: MenuItemProps): import("react").ReactElement;
+declare function PopoverMenuSection(props: MenuSectionProps): import("react").ReactElement;
+declare function PopoverMenuSubmenu(props: MenuSubmenuProps): import("react").ReactElement;
 /**
  * A subclass of `GtkPopover` that implements menu behavior.
  *
@@ -10161,7 +10165,12 @@ export declare const Popover: {
  * [enum@Gtk.AccessibleRole.checkbox] or [enum@Gtk.AccessibleRole.menu_item_radio]
  * roles, depending on the action they are connected to.
  */
-export declare const PopoverMenu: "PopoverMenu";
+export declare const PopoverMenu: {
+    Root: typeof PopoverMenuRoot;
+    Item: typeof PopoverMenuItem;
+    Section: typeof PopoverMenuSection;
+    Submenu: typeof PopoverMenuSubmenu;
+};
 /**
  * Presents a horizontal bar of items that pop up menus when clicked.
  *
@@ -10984,6 +10993,9 @@ export declare const SpinButton: "SpinButton";
  * `GtkSpinner` uses the [enum@Gtk.AccessibleRole.progress_bar] role.
  */
 export declare const Spinner: "Spinner";
+declare function StackRoot(props: StackRootProps & StackProps): import("react").ReactElement;
+declare function StackPage(props: StackPageProps): import("react").ReactElement;
+declare function StackVisibleChild(props: SlotProps): import("react").ReactElement;
 /**
  * Shows one of its children at a time.
  *
@@ -11035,8 +11047,9 @@ export declare const Spinner: "Spinner";
  * pages, which are the accessible parent objects of the child widgets.
  */
 export declare const Stack: {
-    Root: "Stack.Root";
-    VisibleChild: "Stack.VisibleChild";
+    Root: typeof StackRoot;
+    Page: typeof StackPage;
+    VisibleChild: typeof StackVisibleChild;
 };
 /**
  * Uses a sidebar to switch between `GtkStack` pages.
@@ -11731,6 +11744,24 @@ export declare const WindowControls: "WindowControls";
  * role.
  */
 export declare const WindowHandle: "WindowHandle";
+/**
+ * Sets the application-wide menu bar.
+ * The menu will appear in the window's title bar on supported platforms.
+ * Use Menu.Item, Menu.Section, and Menu.Submenu as children.
+ */
+export declare function ApplicationMenu(props: MenuRootProps): import("react").ReactElement;
+declare function MenuItem(props: MenuItemProps): import("react").ReactElement;
+declare function MenuSection(props: MenuSectionProps): import("react").ReactElement;
+declare function MenuSubmenu(props: MenuSubmenuProps): import("react").ReactElement;
+/**
+ * Declarative menu builder for use with PopoverMenu and ApplicationMenu.
+ * Use Menu.Item for action items, Menu.Section for groups, Menu.Submenu for nested menus.
+ */
+export declare const Menu: {
+    Item: typeof MenuItem;
+    Section: typeof MenuSection;
+    Submenu: typeof MenuSubmenu;
+};
 declare global {
     namespace React {
         namespace JSX {
@@ -11839,7 +11870,7 @@ declare global {
                 "Popover.Root": PopoverProps;
                 "Popover.Child": SlotProps;
                 "Popover.DefaultWidget": SlotProps;
-                PopoverMenu: PopoverMenuProps;
+                "PopoverMenu.Root": PopoverMenuProps;
                 PopoverMenuBar: PopoverMenuBarProps;
                 PrintUnixDialog: PrintUnixDialogProps;
                 ProgressBar: ProgressBarProps;
@@ -11865,6 +11896,7 @@ declare global {
                 Spinner: SpinnerProps;
                 "Stack.Root": StackProps;
                 "Stack.VisibleChild": SlotProps;
+                "Stack.Page": StackPageProps;
                 "StackSidebar.Root": StackSidebarProps;
                 "StackSidebar.Stack": SlotProps;
                 "StackSwitcher.Root": StackSwitcherProps;
@@ -11885,6 +11917,10 @@ declare global {
                 WindowControls: WindowControlsProps;
                 WindowHandle: WindowHandleProps;
                 "WindowHandle.Child": SlotProps;
+                "Menu.Item": MenuItemProps;
+                "Menu.Section": MenuSectionProps;
+                "Menu.Submenu": MenuSubmenuProps;
+                ApplicationMenu: MenuRootProps;
             }
         }
     }

package/dist/generated/jsx.js

@@ -4095,6 +4095,18 @@ export const Popover = {
     Child: "Popover.Child",
     DefaultWidget: "Popover.DefaultWidget",
 };
+function PopoverMenuRoot(props) {
+    return createElement("PopoverMenu.Root", props);
+}
+function PopoverMenuItem(props) {
+    return createElement("Menu.Item", props);
+}
+function PopoverMenuSection(props) {
+    return createElement("Menu.Section", props);
+}
+function PopoverMenuSubmenu(props) {
+    return createElement("Menu.Submenu", props);
+}
 /**
  * A subclass of `GtkPopover` that implements menu behavior.
  *
@@ -4213,7 +4225,12 @@ export const Popover = {
  * [enum@Gtk.AccessibleRole.checkbox] or [enum@Gtk.AccessibleRole.menu_item_radio]
  * roles, depending on the action they are connected to.
  */
-export const PopoverMenu = "PopoverMenu";
+export const PopoverMenu = {
+    Root: PopoverMenuRoot,
+    Item: PopoverMenuItem,
+    Section: PopoverMenuSection,
+    Submenu: PopoverMenuSubmenu,
+};
 /**
  * Presents a horizontal bar of items that pop up menus when clicked.
  *
@@ -5036,6 +5053,15 @@ export const SpinButton = "SpinButton";
  * `GtkSpinner` uses the [enum@Gtk.AccessibleRole.progress_bar] role.
  */
 export const Spinner = "Spinner";
+function StackRoot(props) {
+    return createElement("Stack.Root", props);
+}
+function StackPage(props) {
+    return createElement("Stack.Page", props);
+}
+function StackVisibleChild(props) {
+    return createElement("Stack.VisibleChild", props);
+}
 /**
  * Shows one of its children at a time.
  *
@@ -5087,8 +5113,9 @@ export const Spinner = "Spinner";
  * pages, which are the accessible parent objects of the child widgets.
  */
 export const Stack = {
-    Root: "Stack.Root",
-    VisibleChild: "Stack.VisibleChild",
+    Root: StackRoot,
+    Page: StackPage,
+    VisibleChild: StackVisibleChild,
 };
 /**
  * Uses a sidebar to switch between `GtkStack` pages.
@@ -5783,3 +5810,29 @@ export const WindowControls = "WindowControls";
  * role.
  */
 export const WindowHandle = "WindowHandle";
+/**
+ * Sets the application-wide menu bar.
+ * The menu will appear in the window's title bar on supported platforms.
+ * Use Menu.Item, Menu.Section, and Menu.Submenu as children.
+ */
+export function ApplicationMenu(props) {
+    return createElement("ApplicationMenu", props);
+}
+function MenuItem(props) {
+    return createElement("Menu.Item", props);
+}
+function MenuSection(props) {
+    return createElement("Menu.Section", props);
+}
+function MenuSubmenu(props) {
+    return createElement("Menu.Submenu", props);
+}
+/**
+ * Declarative menu builder for use with PopoverMenu and ApplicationMenu.
+ * Use Menu.Item for action items, Menu.Section for groups, Menu.Submenu for nested menus.
+ */
+export const Menu = {
+    Item: MenuItem,
+    Section: MenuSection,
+    Submenu: MenuSubmenu,
+};

package/dist/node.d.ts

@@ -1,12 +1,21 @@
 import * as Gtk from "@gtkx/ffi/gtk";
 import type { Props, ROOT_NODE_CONTAINER } from "./factory.js";
-export declare abstract class Node<T extends Gtk.Widget | undefined = Gtk.Widget | undefined> {
+export declare abstract class Node<T extends Gtk.Widget | undefined = Gtk.Widget | undefined, S extends object | undefined = object | undefined> {
     static matches(_type: string, _existingWidget?: Gtk.Widget | typeof ROOT_NODE_CONTAINER): boolean;
     protected signalHandlers: Map<string, number>;
     protected widget: T;
     protected widgetType: string;
+    protected nodeType: string;
+    private _state;
+    protected get state(): S;
+    protected set state(value: S);
     protected isVirtual(): boolean;
-    constructor(type: string, props: Props, existingWidget?: Gtk.Widget);
+    constructor(type: string, existingWidget?: Gtk.Widget);
+    /**
+     * Initializes the node with props. Called by the reconciler after construction.
+     * Subclasses can override to perform custom initialization.
+     */
+    initialize(props: Props): void;
     protected createWidget(type: string, props: Props): T;
     getWidget(): T;
     appendChild(child: Node): void;

package/dist/node.js

@@ -14,18 +14,37 @@ export class Node {
         return false;
     }
     signalHandlers = new Map();
-    widget;
+    widget = undefined;
     widgetType;
+    nodeType;
+    _state = null;
+    get state() {
+        if (this._state === null) {
+            throw new Error(`${this.constructor.name} not initialized`);
+        }
+        return this._state;
+    }
+    set state(value) {
+        this._state = value;
+    }
     isVirtual() {
         return false;
     }
-    constructor(type, props, existingWidget) {
+    constructor(type, existingWidget) {
+        this.nodeType = type;
         this.widgetType = type.split(".")[0] || type;
         if (existingWidget) {
             this.widget = existingWidget;
-            return;
         }
-        this.widget = (this.isVirtual() ? undefined : this.createWidget(type, props));
+    }
+    /**
+     * Initializes the node with props. Called by the reconciler after construction.
+     * Subclasses can override to perform custom initialization.
+     */
+    initialize(props) {
+        if (!this.widget && !this.isVirtual()) {
+            this.widget = this.createWidget(this.nodeType, props);
+        }
         this.updateProps({}, props);
     }
     createWidget(type, props) {

package/dist/nodes/column-view.d.ts

@@ -1,25 +1,28 @@
 import * as Gtk from "@gtkx/ffi/gtk";
+import type Reconciler from "react-reconciler";
 import { type ColumnContainer, type ItemContainer } from "../container-interfaces.js";
 import type { Props } from "../factory.js";
 import { Node } from "../node.js";
-import type { ColumnSortFn } from "../types.js";
-export declare class ColumnViewNode extends Node<Gtk.ColumnView> implements ItemContainer<unknown>, ColumnContainer {
+import type { ColumnSortFn, RenderItemFn } from "../types.js";
+interface ColumnViewState {
+    stringList: Gtk.StringList;
+    selectionModel: Gtk.SingleSelection;
+    sortListModel: Gtk.SortListModel;
+    items: unknown[];
+    columns: ColumnViewColumnNode[];
+    committedLength: number;
+    sortColumn: string | null;
+    sortOrder: Gtk.SortType;
+    sortFn: ColumnSortFn<unknown, string> | null;
+    isSorting: boolean;
+    onSortChange: ((column: string | null, order: Gtk.SortType) => void) | null;
+    sorterChangedHandlerId: number | null;
+    lastNotifiedColumn: string | null;
+    lastNotifiedOrder: Gtk.SortType;
+}
+export declare class ColumnViewNode extends Node<Gtk.ColumnView, ColumnViewState> implements ItemContainer<unknown>, ColumnContainer {
     static matches(type: string): boolean;
-    private stringList;
-    private selectionModel;
-    private sortListModel;
-    private items;
-    private columns;
-    private committedLength;
-    private sortColumn;
-    private sortOrder;
-    private sortFn;
-    private isSorting;
-    private onSortChange;
-    private sorterChangedHandlerId;
-    private lastNotifiedColumn;
-    private lastNotifiedOrder;
-    constructor(type: string, props: Props);
+    initialize(props: Props): void;
     private connectSorterChangedSignal;
     private waitForSortComplete;
     private disconnectSorterChangedSignal;
@@ -39,17 +42,23 @@ export declare class ColumnViewNode extends Node<Gtk.ColumnView> implements Item
     protected consumedProps(): Set<string>;
     updateProps(oldProps: Props, newProps: Props): void;
 }
-export declare class ColumnViewColumnNode extends Node {
+interface ListItemInfo {
+    box: Gtk.Box;
+    fiberRoot: Reconciler.FiberRoot;
+}
+interface ColumnViewColumnState {
+    column: Gtk.ColumnViewColumn;
+    factory: Gtk.SignalListItemFactory;
+    renderCell: RenderItemFn<unknown>;
+    columnId: string | null;
+    sorter: Gtk.CustomSorter | null;
+    listItemCache: Map<number, ListItemInfo>;
+}
+export declare class ColumnViewColumnNode extends Node<never, ColumnViewColumnState> {
     static matches(type: string): boolean;
     protected isVirtual(): boolean;
-    private column;
-    private factory;
-    private renderCell;
     private columnView;
-    private listItemCache;
-    private columnId;
-    private sorter;
-    constructor(type: string, props: Props);
+    initialize(props: Props): void;
     getColumn(): Gtk.ColumnViewColumn;
     getId(): string | null;
     setColumnView(columnView: ColumnViewNode | null): void;
@@ -64,9 +73,10 @@ export declare class ColumnViewItemNode extends Node {
     static matches(type: string): boolean;
     protected isVirtual(): boolean;
     private item;
-    constructor(type: string, props: Props);
+    initialize(props: Props): void;
     getItem(): unknown;
     attachToParent(parent: Node): void;
     attachToParentBefore(parent: Node, before: Node): void;
     detachFromParent(parent: Node): void;
 }
+export {};