@gtkx/react 0.1.49 → 0.1.51

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.
  *
@@ -5925,12 +5925,6 @@ export interface WindowControlsProps extends WidgetProps {
 export interface WindowHandleProps extends WidgetProps {
     ref?: Ref<Gtk.WindowHandle>;
 }
-export declare const CONSTRUCTOR_PARAMS: Record<string, {
-    name: string;
-    hasDefault: boolean;
-}[]>;
-export declare const PROP_SETTERS: Record<string, Record<string, string>>;
-export declare const SETTER_GETTERS: Record<string, Record<string, string>>;
 /**
  * The base class for all widgets.
  *
@@ -7071,11 +7065,20 @@ export declare const ColorChooserWidget: "ColorChooserWidget";
  * it gets the .color style class.
  */
 export declare const ColorDialogButton: "ColorDialogButton";
+/**
+ * Props for the ColumnView.Root component with type-safe item and column rendering.
+ * @typeParam T - The type of items in the column view.
+ * @typeParam C - The union type of column IDs for type-safe sorting.
+ */
 interface ColumnViewRootPropsExtended<T = unknown, C extends string = string> extends ColumnViewProps, ColumnViewRootProps<T, C> {
 }
 declare function ColumnViewRoot<T = unknown, C extends string = string>(props: ColumnViewRootPropsExtended<T, C>): import("react").ReactElement;
+/**
+ * Props for ColumnView.Column with type-safe cell rendering.
+ * @typeParam T - The type of items passed to the renderCell function.
+ */
 interface ColumnViewGenericColumnProps<T> extends Omit<ColumnViewColumnProps, "renderCell"> {
-    /** Render function for column cells. Called with null during setup. */
+    /** Render function for column cells. Called with null during setup (for loading state). */
     renderCell: (item: T | null) => import("react").ReactElement;
 }
 declare function ColumnViewColumn<T>(props: ColumnViewGenericColumnProps<T>): import("react").ReactElement;
@@ -7491,10 +7494,14 @@ export declare const DragIcon: "DragIcon";
  * creating your own `GtkWidget` subclass.
  */
 export declare const DrawingArea: "DrawingArea";
+/**
+ * Props for the DropDown.Root component with type-safe item handling.
+ * @typeParam T - The type of items in the dropdown.
+ */
 interface DropDownRootProps<T> extends Omit<DropDownProps, "itemLabel" | "onSelectionChanged"> {
-    /** Function to convert item to display label */
+    /** Function to convert an item to its display label. */
     itemLabel?: (item: T) => string;
-    /** Called when selection changes */
+    /** Called when the selected item changes. */
     onSelectionChanged?: (item: T, index: number) => void;
 }
 declare function DropDownRoot<T>(props: DropDownRootProps<T>): import("react").ReactElement;
@@ -8517,8 +8524,12 @@ export declare const Grid: {
     Root: "Grid.Root";
     Child: "Grid.Child";
 };
+/**
+ * Props for the GridView.Root component with type-safe item rendering.
+ * @typeParam T - The type of items in the list.
+ */
 interface GridViewRootProps<T> extends Omit<GridViewProps, "renderItem"> {
-    /** Render function for list items. Called with null during setup. */
+    /** Render function for list items. Called with null during setup (for loading state). */
     renderItem: (item: T | null) => import("react").ReactElement;
 }
 declare function GridViewRoot<T>(props: GridViewRootProps<T>): import("react").ReactElement;
@@ -9295,8 +9306,12 @@ export declare const ListBox: "ListBox";
  * when necessary.
  */
 export declare const ListBoxRow: "ListBoxRow";
+/**
+ * Props for the ListView.Root component with type-safe item rendering.
+ * @typeParam T - The type of items in the list.
+ */
 interface ListViewRootProps<T> extends Omit<ListViewProps, "renderItem"> {
-    /** Render function for list items. Called with null during setup. */
+    /** Render function for list items. Called with null during setup (for loading state). */
     renderItem: (item: T | null) => import("react").ReactElement;
 }
 declare function ListViewRoot<T>(props: ListViewRootProps<T>): import("react").ReactElement;
@@ -10028,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.
  *
@@ -10146,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.
  *
@@ -10969,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.
  *
@@ -11020,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.
@@ -11716,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 {
@@ -11824,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;
@@ -11850,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;
@@ -11870,6 +11917,10 @@ declare global {
                 WindowControls: WindowControlsProps;
                 WindowHandle: WindowHandleProps;
                 "WindowHandle.Child": SlotProps;
+                "Menu.Item": MenuItemProps;
+                "Menu.Section": MenuSectionProps;
+                "Menu.Submenu": MenuSubmenuProps;
+                ApplicationMenu: MenuRootProps;
             }
         }
     }