@gtkx/components 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/size-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"size-group.d.ts","sourceRoot":"","sources":["../src/size-group.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AAGzC,OAAO,EAEH,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,GAAG,EAKX,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgB7C,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG;IACzB,oEAAoE;IACpE,IAAI,CAAC,EAAE,GAAG,CAAC,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAoCvE;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC,GAAG;IAC7D,KAAK,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;CAgB9E,CAAC"}
+{"version":3,"file":"size-group.d.ts","sourceRoot":"","sources":["../src/size-group.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAoB,MAAM,OAAO,CAAC;AAItE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAStE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC,GAAG;IAC/D,KAAK,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;CAC9E,CAAC;AAIF;;;GAGG;AACH,QAAA,MAAM,SAAS,EAAE,kBAA4E,CAAC;AAoD9F,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/size-group.js

@@ -1,57 +1,41 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { GtkSizeGroup } from "@gtkx/jsx/gtk";
-import { useMergeRefs } from "@gtkx/react/internal";
-import { createContext, useCallback, useContext, useRef, } from "react";
+import { useMergedRef } from "@gtkx/react/internal";
+import { createContext, useCallback, useContext, useState } from "react";
 const SizeGroupContext = createContext(null);
-const useSizeGroupRegistry = () => {
-    const registry = useContext(SizeGroupContext);
-    if (!registry)
+const SizeGroupChild = SizeGroupChildImpl;
+/**
+ * Creates a Gtk.SizeGroup that keeps widgets joined through `SizeGroup.Child`
+ * at a common size in the given mode, without contributing a widget of its own.
+ */
+const SizeGroup = Object.assign(SizeGroupRoot, { Child: SizeGroupChild });
+const useRegister = () => {
+    const register = useContext(SizeGroupContext);
+    if (register === null) {
         throw new Error("<SizeGroup.Child> must be a child of <SizeGroup>");
-    return registry;
+    }
+    return register;
 };
-const SizeGroupChild = ({ component, ref, ...rest }) => {
-    const registry = useSizeGroupRegistry();
-    const joinGroup = useCallback((widget) => {
-        if (widget === null)
+function SizeGroupChildImpl(props) {
+    const { component: Component, ref, ...rest } = props;
+    const refCallback = useMergedRef(ref, useRegister());
+    return _jsx(Component, { ...rest, ref: refCallback });
+}
+const addWidget = (widgets, widget) => widgets.includes(widget) ? widgets : [...widgets, widget];
+const removeWidget = (widgets, widget) => widgets.filter((entry) => entry !== widget);
+function SizeGroupRoot(props) {
+    const { mode, ref, children } = props;
+    const [widgets, setWidgets] = useState([]);
+    const register = useCallback((widget) => {
+        if (widget === null) {
             return;
-        registry.addWidget(widget);
-        return () => registry.removeWidget(widget);
-    }, [registry]);
-    const Component = component;
-    const setWidget = useMergeRefs(ref, joinGroup);
-    return _jsx(Component, { ...rest, ref: setWidget });
-};
-const createRegistry = () => {
-    const members = new Set();
-    let group = null;
-    return {
-        addWidget: (widget) => {
-            members.add(widget);
-            group?.addWidget(widget);
-        },
-        removeWidget: (widget) => {
-            members.delete(widget);
-            group?.removeWidget(widget);
-        },
-        setGroup: (next) => {
-            group = next;
-            if (next)
-                for (const member of members)
-                    next.addWidget(member);
-        },
-    };
-};
-/**
- * Creates a Gtk.SizeGroup that keeps its member widgets at a common size. Members join the group
- * through {@link SizeGroup.Child}.
- */
-export const SizeGroup = Object.assign(({ mode, ref, children }) => {
-    const registryRef = useRef(null);
-    if (registryRef.current === null)
-        registryRef.current = createRegistry();
-    const registry = registryRef.current;
-    const setGroup = useCallback((group) => registry.setGroup(group), [registry]);
-    const mergedRef = useMergeRefs(ref, setGroup);
-    return (_jsxs(_Fragment, { children: [_jsx(GtkSizeGroup, { ref: mergedRef, mode: mode }), _jsx(SizeGroupContext.Provider, { value: registry, children: children })] }));
-}, { Child: SizeGroupChild });
+        }
+        setWidgets((previous) => addWidget(previous, widget));
+        return () => {
+            setWidgets((previous) => removeWidget(previous, widget));
+        };
+    }, [setWidgets]);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkSizeGroup, { ref: ref, mode: mode, widgets: widgets }), _jsx(SizeGroupContext.Provider, { value: register, children: children })] }));
+}
+export { SizeGroup };
 //# sourceMappingURL=size-group.js.map

package/dist/size-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"size-group.js","sourceRoot":"","sources":["../src/size-group.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkSizeGroup } from \"@gtkx/jsx/gtk\";\nimport { useMergeRefs } from \"@gtkx/react/internal\";\nimport {\n    createContext,\n    type ElementType,\n    type ReactNode,\n    type Ref,\n    type RefCallback,\n    useCallback,\n    useContext,\n    useRef,\n} from \"react\";\nimport type { ChildProps } from \"./types.js\";\n\ntype SizeGroupRegistry = {\n    addWidget: (widget: Gtk.Widget) => void;\n    removeWidget: (widget: Gtk.Widget) => void;\n    setGroup: (group: Gtk.SizeGroup | null) => void;\n};\n\nconst SizeGroupContext = createContext<SizeGroupRegistry | null>(null);\n\nconst useSizeGroupRegistry = (): SizeGroupRegistry => {\n    const registry = useContext(SizeGroupContext);\n    if (!registry) throw new Error(\"<SizeGroup.Child> must be a child of <SizeGroup>\");\n    return registry;\n};\n\n/** Props for {@link SizeGroup}. */\nexport type SizeGroupProps = {\n    /** How the group equalizes sizes: horizontal, vertical, or both. */\n    mode?: Gtk.SizeGroupMode | null | undefined;\n    ref?: Ref<Gtk.SizeGroup | null>;\n    children?: ReactNode;\n};\n\n/** Adds a single widget, rendered by the given component, to the enclosing {@link SizeGroup}. */\nexport type SizeGroupChildProps<C extends ElementType> = ChildProps<C>;\n\nconst SizeGroupChild = <C extends ElementType>({ component, ref, ...rest }: SizeGroupChildProps<C>): ReactNode => {\n    const registry = useSizeGroupRegistry();\n    const joinGroup = useCallback<RefCallback<Gtk.Widget>>(\n        (widget) => {\n            if (widget === null) return;\n            registry.addWidget(widget);\n            return () => registry.removeWidget(widget);\n        },\n        [registry],\n    );\n    const Component: ElementType = component;\n    const setWidget = useMergeRefs<Gtk.Widget>(ref, joinGroup);\n    return <Component {...rest} ref={setWidget} />;\n};\n\nconst createRegistry = (): SizeGroupRegistry => {\n    const members = new Set<Gtk.Widget>();\n    let group: Gtk.SizeGroup | null = null;\n    return {\n        addWidget: (widget) => {\n            members.add(widget);\n            group?.addWidget(widget);\n        },\n        removeWidget: (widget) => {\n            members.delete(widget);\n            group?.removeWidget(widget);\n        },\n        setGroup: (next) => {\n            group = next;\n            if (next) for (const member of members) next.addWidget(member);\n        },\n    };\n};\n\n/**\n * Creates a Gtk.SizeGroup that keeps its member widgets at a common size. Members join the group\n * through {@link SizeGroup.Child}.\n */\nexport const SizeGroup: ((props: SizeGroupProps) => ReactNode) & {\n    Child: <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;\n} = Object.assign(\n    ({ mode, ref, children }: SizeGroupProps): ReactNode => {\n        const registryRef = useRef<SizeGroupRegistry | null>(null);\n        if (registryRef.current === null) registryRef.current = createRegistry();\n        const registry = registryRef.current;\n        const setGroup = useCallback<RefCallback<Gtk.SizeGroup>>((group) => registry.setGroup(group), [registry]);\n        const mergedRef = useMergeRefs<Gtk.SizeGroup>(ref, setGroup);\n        return (\n            <>\n                <GtkSizeGroup ref={mergedRef} mode={mode} />\n                <SizeGroupContext.Provider value={registry}>{children}</SizeGroupContext.Provider>\n            </>\n        );\n    },\n    { Child: SizeGroupChild },\n);\n"]}
+{"version":3,"file":"size-group.js","sourceRoot":"","sources":["../src/size-group.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAczE,MAAM,gBAAgB,GAAG,aAAa,CAAkB,IAAI,CAAC,CAAC;AAC9D,MAAM,cAAc,GAAG,kBAAyF,CAAC;AACjH;;;GAGG;AACH,MAAM,SAAS,GAAuB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;AAE9F,MAAM,WAAW,GAAG,GAAa,EAAE;IAC/B,MAAM,QAAQ,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAE9C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAEF,SAAS,kBAAkB,CAAC,KAAiC;IACzD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACrD,MAAM,WAAW,GAAG,YAAY,CAAoB,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;IAExE,OAAO,KAAC,SAAS,OAAK,IAAI,EAAE,GAAG,EAAE,WAAW,GAAI,CAAC;AACrD,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,OAAqB,EAAE,MAAkB,EAAgB,EAAE,CAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,YAAY,GAAG,CAAC,OAAqB,EAAE,MAAkB,EAAgB,EAAE,CAC7E,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;AAEhD,SAAS,aAAa,CAAC,KAAqB;IACxC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,WAAW,CACxB,CAAC,MAAM,EAAE,EAAE;QACP,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO;QACX,CAAC;QAED,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAEtD,OAAO,GAAG,EAAE;YACR,UAAU,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC;IACN,CAAC,EACD,CAAC,UAAU,CAAC,CACf,CAAC;IAEF,OAAO,CACH,8BACI,KAAC,YAAY,IAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAI,EACxD,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,QAAQ,YAAG,QAAQ,GAA6B,IACnF,CACN,CAAC;AACN,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { ElementType, ReactNode, Ref, RefCallback } from \"react\";\nimport { GtkSizeGroup } from \"@gtkx/jsx/gtk\";\nimport { useMergedRef } from \"@gtkx/react/internal\";\nimport { createContext, useCallback, useContext, useState } from \"react\";\nimport type { SizeGroupChildProps, SizeGroupProps } from \"./types.js\";\n\ntype Register = RefCallback<Gtk.Widget | null>;\n\ntype SizeGroupChildRuntimeProps = {\n    component: ElementType;\n    ref?: Ref<Gtk.Widget | null> | undefined;\n} & Record<string, unknown>;\n\ntype SizeGroupComponent = ((props: SizeGroupProps) => ReactNode) & {\n    Child: <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;\n};\n\nconst SizeGroupContext = createContext<Register | null>(null);\nconst SizeGroupChild = SizeGroupChildImpl as <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;\n/**\n * Creates a Gtk.SizeGroup that keeps widgets joined through `SizeGroup.Child`\n * at a common size in the given mode, without contributing a widget of its own.\n */\nconst SizeGroup: SizeGroupComponent = Object.assign(SizeGroupRoot, { Child: SizeGroupChild });\n\nconst useRegister = (): Register => {\n    const register = useContext(SizeGroupContext);\n\n    if (register === null) {\n        throw new Error(\"<SizeGroup.Child> must be a child of <SizeGroup>\");\n    }\n\n    return register;\n};\n\nfunction SizeGroupChildImpl(props: SizeGroupChildRuntimeProps): ReactNode {\n    const { component: Component, ref, ...rest } = props;\n    const refCallback = useMergedRef<Gtk.Widget | null>(ref, useRegister());\n\n    return <Component {...rest} ref={refCallback} />;\n}\n\nconst addWidget = (widgets: Gtk.Widget[], widget: Gtk.Widget): Gtk.Widget[] =>\n    widgets.includes(widget) ? widgets : [...widgets, widget];\n\nconst removeWidget = (widgets: Gtk.Widget[], widget: Gtk.Widget): Gtk.Widget[] =>\n    widgets.filter((entry) => entry !== widget);\n\nfunction SizeGroupRoot(props: SizeGroupProps): ReactNode {\n    const { mode, ref, children } = props;\n    const [widgets, setWidgets] = useState<Gtk.Widget[]>([]);\n\n    const register = useCallback<Register>(\n        (widget) => {\n            if (widget === null) {\n                return;\n            }\n\n            setWidgets((previous) => addWidget(previous, widget));\n\n            return () => {\n                setWidgets((previous) => removeWidget(previous, widget));\n            };\n        },\n        [setWidgets],\n    );\n\n    return (\n        <>\n            <GtkSizeGroup ref={ref} mode={mode} widgets={widgets} />\n            <SizeGroupContext.Provider value={register}>{children}</SizeGroupContext.Provider>\n        </>\n    );\n}\n\nexport { SizeGroup };\n"]}

package/dist/types.d.ts

@@ -1,22 +1,23 @@
 import type * as Gtk from "@gtkx/gi/gtk";
-import type { ComponentPropsWithRef, ElementType } from "react";
-/** Props of a container's Child component: the widget to render, its own props, and any placement props. */
-export type ChildProps<C extends ElementType, Placement = unknown> = Placement & {
+import type { GtkColumnViewColumnProps, GtkColumnViewProps, GtkDropDown, GtkGridViewProps, GtkListViewProps } from "@gtkx/jsx/gtk";
+import type { ComponentPropsWithRef, ElementType, ReactNode, Ref } from "react";
+/** Props of a container's Child component: the widget to render and its own props. */
+type ChildProps<C extends ElementType> = {
     component: C;
-} & Omit<ComponentPropsWithRef<C>, keyof Placement>;
+} & ComponentPropsWithRef<C>;
 /** Props of a component whose backing widget defaults to one type but can be swapped through `component`. */
-export type WidgetProps<C extends ElementType, Own = unknown, ExtraOmit extends string = never> = Own & {
+type WidgetProps<C extends ElementType, Own = unknown, ExtraOmit extends string = never> = Own & {
     component?: C;
 } & Omit<ComponentPropsWithRef<C>, ExtraOmit | keyof Own>;
 /**
  * A single item in a collection model, identified by a stable id and holding an
  * arbitrary value. Nested items form a tree.
  */
-export type ItemNode<T = unknown> = {
+type Item<T = unknown> = {
     /** Stable identifier used to track the item across updates and selection. */
     id: string;
     value: T;
-    children?: ItemNode<T>[] | undefined;
+    children?: Item<T>[] | undefined;
     /** Hides the tree expander arrow even when the item has children. */
     hideExpander?: boolean | undefined;
     /** Adds indentation matching the item's depth in the tree. */
@@ -25,15 +26,15 @@ export type ItemNode<T = unknown> = {
     indentForIcon?: boolean | undefined;
 };
 /** A group of items rendered under a shared section header. */
-export type SectionNode<S = unknown, T = unknown> = {
+type Section<S = unknown, T = unknown> = {
     /** Stable identifier used to track the section across updates. */
     id: string;
     value: S;
     /** Items belonging to this section. */
-    data: ItemNode<T>[];
+    data: Item<T>[];
 };
-/** Props passed to a renderItem callback when rendering one cell. */
-export type RenderItemProps<T> = {
+/** Arguments passed to an {@link ItemRenderer} when rendering one cell. */
+type RenderItemArgs<T> = {
     item: T;
     index: number;
     /** Depth of the item within a tree, starting at zero for top-level items. */
@@ -41,28 +42,100 @@ export type RenderItemProps<T> = {
     /** Whether the item is currently expanded in a tree view. */
     isExpanded?: boolean | undefined;
 };
-export type CollectionItemSizeProps = {
+/** Arguments passed to a {@link HeaderRenderer} when rendering one section header. */
+type RenderHeaderArgs<S> = {
+    section: S;
+};
+/** Renders the contents of one cell of a collection view. */
+type ItemRenderer<T> = (args: RenderItemArgs<T>) => ReactNode;
+/** Renders the contents of one section header of a collection view. */
+type HeaderRenderer<S> = (args: RenderHeaderArgs<S>) => ReactNode;
+type ItemSizeProps = {
     estimatedItemHeight?: number | undefined;
     estimatedItemWidth?: number | undefined;
 };
-export type ControlledSelectionProps = {
+type SelectionProps = {
     selectedIds?: string[] | null | undefined;
     onSelectionChanged?: ((ids: string[]) => void) | null | undefined;
     selectionMode?: Gtk.SelectionMode | null | undefined;
 };
-export type ControlledExpansionProps = {
+type ExpansionProps = {
     expandedIds?: string[] | null | undefined;
     onExpandedChange?: ((ids: string[]) => void) | null | undefined;
 };
-/** Declarative description of a single menu item, optionally nesting a submenu or section. */
-export type MenuEntry = {
-    /** Text shown for the item. */
-    label?: string | undefined;
-    /** Action name activated when the item is chosen, for example "app.quit". */
-    action?: string | undefined;
-    /** Nested entries shown as a submenu opened from this item. */
-    submenu?: MenuEntry[] | undefined;
-    /** Nested entries grouped as a visually separated section. */
-    section?: MenuEntry[] | undefined;
+type SourceProps<T, S> = {
+    items?: Item<T>[] | undefined;
+    sections?: Section<S, T>[] | undefined;
+};
+/** One column of a {@link ColumnView}, pairing Gtk.ColumnViewColumn props with a cell renderer. */
+type Column<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" | "sorter" | "id" | "title"> & {
+    /** Stable identifier, also used to address the column through sorting props. */
+    id: string;
+    title: string;
+    renderCell: ItemRenderer<T>;
+    /** Whether clicking the column header sorts by it. */
+    sortable?: boolean | undefined;
+    headerMenu?: ReactNode;
+};
+type ColumnViewOwnProps<T, S> = SelectionProps & ExpansionProps & SourceProps<T, S> & Omit<ItemSizeProps, "estimatedItemWidth"> & {
+    columns: Column<T>[];
+    renderHeader?: HeaderRenderer<S> | null | undefined;
+    /** Id of the column the view is sorted by, making sorting controlled. */
+    sortColumn?: string | null | undefined;
+    sortOrder?: Gtk.SortType | null | undefined;
+    onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;
+};
+/**
+ * Props for {@link ColumnView}. Combines the underlying Gtk.ColumnView props with
+ * declarative collection props: flat items or grouped sections, controlled selection
+ * and expansion, sorting (sortColumn, sortOrder, onSortChanged), an optional section
+ * header renderer, and the columns to render.
+ */
+type ColumnViewProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "columns" | "model" | "headerFactory" | keyof ColumnViewOwnProps<T, S>> & ColumnViewOwnProps<T, S>;
+type DropDownOwnProps<T, S> = SourceProps<T, S> & {
+    /** Id of the currently selected item, making the selection controlled. */
+    selectedId?: string | null | undefined;
+    onSelectionChanged?: ((id: string) => void) | null | undefined;
+    renderItem?: ItemRenderer<T> | null | undefined;
+    /** Renderer for items in the open popup list, falling back to renderItem when omitted. */
+    renderListItem?: ItemRenderer<T> | null | undefined;
+    /** Renderer for section headers in the popup list. */
+    renderHeader?: HeaderRenderer<S> | null | undefined;
+};
+/**
+ * Props for {@link DropDown}. The backing widget is chosen through the `component` prop, defaulting to
+ * GtkDropDown, and its own props combine with the declarative collection props.
+ */
+type DropDownProps<T = unknown, S = unknown, C extends ElementType = typeof GtkDropDown> = WidgetProps<C, DropDownOwnProps<T, S>, "model" | "factory" | "listFactory" | "headerFactory">;
+type GridViewOwnProps<T> = ItemSizeProps & SelectionProps & {
+    items?: Item<T>[] | undefined;
+    renderItem: ItemRenderer<T>;
+};
+/**
+ * Props for {@link GridView}. Combines the underlying Gtk.GridView props with
+ * declarative collection props: items, a per-cell renderItem, controlled selection,
+ * and estimated item sizing.
+ */
+type GridViewProps<T = unknown> = Omit<GtkGridViewProps, "model" | "factory" | keyof GridViewOwnProps<T>> & GridViewOwnProps<T>;
+type ListViewOwnProps<T, S> = ItemSizeProps & SelectionProps & ExpansionProps & SourceProps<T, S> & {
+    renderItem: ItemRenderer<T>;
+    renderHeader?: HeaderRenderer<S> | null | undefined;
+};
+/**
+ * Props for {@link ListView}. Combines the underlying Gtk.ListView props with
+ * declarative collection props: flat items or grouped sections, a per-row renderItem,
+ * an optional section header renderer, controlled selection and expansion, and
+ * estimated item sizing.
+ */
+type ListViewProps<T = unknown, S = unknown> = Omit<GtkListViewProps, "model" | "factory" | "headerFactory" | keyof ListViewOwnProps<T, S>> & ListViewOwnProps<T, S>;
+/** Props for {@link SizeGroup}. */
+type SizeGroupProps = {
+    /** How the group equalizes sizes: horizontal, vertical, or both. */
+    mode?: Gtk.SizeGroupMode | null | undefined;
+    ref?: Ref<Gtk.SizeGroup | null>;
+    children?: ReactNode;
 };
+/** Adds a single widget, rendered by the given component, to the enclosing {@link SizeGroup}. */
+type SizeGroupChildProps<C extends ElementType> = ChildProps<C>;
+export { type SelectionProps, type ExpansionProps, type ChildProps, type WidgetProps, type Item, type Section, type RenderItemArgs, type RenderHeaderArgs, type ItemRenderer, type HeaderRenderer, type Column, type ColumnViewProps, type DropDownProps, type GridViewProps, type ListViewProps, type SizeGroupProps, type SizeGroupChildProps, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { ComponentPropsWithRef, ElementType } from \"react\";\n\n/** Props of a container's Child component: the widget to render, its own props, and any placement props. */\nexport type ChildProps<C extends ElementType, Placement = unknown> = Placement & {\n    component: C;\n} & Omit<ComponentPropsWithRef<C>, keyof Placement>;\n\n/** Props of a component whose backing widget defaults to one type but can be swapped through `component`. */\nexport type WidgetProps<C extends ElementType, Own = unknown, ExtraOmit extends string = never> = Own & {\n    component?: C;\n} & Omit<ComponentPropsWithRef<C>, ExtraOmit | keyof Own>;\n\n/**\n * A single item in a collection model, identified by a stable id and holding an\n * arbitrary value. Nested items form a tree.\n */\nexport type ItemNode<T = unknown> = {\n    /** Stable identifier used to track the item across updates and selection. */\n    id: string;\n    value: T;\n    children?: ItemNode<T>[] | undefined;\n    /** Hides the tree expander arrow even when the item has children. */\n    hideExpander?: boolean | undefined;\n    /** Adds indentation matching the item's depth in the tree. */\n    indentForDepth?: boolean | undefined;\n    /** Reserves indentation space for an expander icon. */\n    indentForIcon?: boolean | undefined;\n};\n\n/** A group of items rendered under a shared section header. */\nexport type SectionNode<S = unknown, T = unknown> = {\n    /** Stable identifier used to track the section across updates. */\n    id: string;\n    value: S;\n    /** Items belonging to this section. */\n    data: ItemNode<T>[];\n};\n\n/** Props passed to a renderItem callback when rendering one cell. */\nexport type RenderItemProps<T> = {\n    item: T;\n    index: number;\n    /** Depth of the item within a tree, starting at zero for top-level items. */\n    depth?: number | undefined;\n    /** Whether the item is currently expanded in a tree view. */\n    isExpanded?: boolean | undefined;\n};\n\nexport type CollectionItemSizeProps = {\n    estimatedItemHeight?: number | undefined;\n    estimatedItemWidth?: number | undefined;\n};\n\nexport type ControlledSelectionProps = {\n    selectedIds?: string[] | null | undefined;\n    onSelectionChanged?: ((ids: string[]) => void) | null | undefined;\n    selectionMode?: Gtk.SelectionMode | null | undefined;\n};\n\nexport type ControlledExpansionProps = {\n    expandedIds?: string[] | null | undefined;\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n};\n\n/** Declarative description of a single menu item, optionally nesting a submenu or section. */\nexport type MenuEntry = {\n    /** Text shown for the item. */\n    label?: string | undefined;\n    /** Action name activated when the item is chosen, for example \"app.quit\". */\n    action?: string | undefined;\n    /** Nested entries shown as a submenu opened from this item. */\n    submenu?: MenuEntry[] | undefined;\n    /** Nested entries grouped as a visually separated section. */\n    section?: MenuEntry[] | undefined;\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4LA,OAAO,EAkBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type {\n    GtkColumnViewColumnProps,\n    GtkColumnViewProps,\n    GtkDropDown,\n    GtkGridViewProps,\n    GtkListViewProps,\n} from \"@gtkx/jsx/gtk\";\nimport type { ComponentPropsWithRef, ElementType, ReactNode, Ref } from \"react\";\n\n/** Props of a container's Child component: the widget to render and its own props. */\ntype ChildProps<C extends ElementType> = {\n    component: C;\n} & ComponentPropsWithRef<C>;\n\n/** Props of a component whose backing widget defaults to one type but can be swapped through `component`. */\ntype WidgetProps<C extends ElementType, Own = unknown, ExtraOmit extends string = never> = Own & {\n    component?: C;\n} & Omit<ComponentPropsWithRef<C>, ExtraOmit | keyof Own>;\n\n/**\n * A single item in a collection model, identified by a stable id and holding an\n * arbitrary value. Nested items form a tree.\n */\ntype Item<T = unknown> = {\n    /** Stable identifier used to track the item across updates and selection. */\n    id: string;\n    value: T;\n    children?: Item<T>[] | undefined;\n    /** Hides the tree expander arrow even when the item has children. */\n    hideExpander?: boolean | undefined;\n    /** Adds indentation matching the item's depth in the tree. */\n    indentForDepth?: boolean | undefined;\n    /** Reserves indentation space for an expander icon. */\n    indentForIcon?: boolean | undefined;\n};\n\n/** A group of items rendered under a shared section header. */\ntype Section<S = unknown, T = unknown> = {\n    /** Stable identifier used to track the section across updates. */\n    id: string;\n    value: S;\n    /** Items belonging to this section. */\n    data: Item<T>[];\n};\n\n/** Arguments passed to an {@link ItemRenderer} when rendering one cell. */\ntype RenderItemArgs<T> = {\n    item: T;\n    index: number;\n    /** Depth of the item within a tree, starting at zero for top-level items. */\n    depth?: number | undefined;\n    /** Whether the item is currently expanded in a tree view. */\n    isExpanded?: boolean | undefined;\n};\n\n/** Arguments passed to a {@link HeaderRenderer} when rendering one section header. */\ntype RenderHeaderArgs<S> = {\n    section: S;\n};\n\n/** Renders the contents of one cell of a collection view. */\ntype ItemRenderer<T> = (args: RenderItemArgs<T>) => ReactNode;\n/** Renders the contents of one section header of a collection view. */\ntype HeaderRenderer<S> = (args: RenderHeaderArgs<S>) => ReactNode;\n\ntype ItemSizeProps = {\n    estimatedItemHeight?: number | undefined;\n    estimatedItemWidth?: number | undefined;\n};\n\ntype SelectionProps = {\n    selectedIds?: string[] | null | undefined;\n    onSelectionChanged?: ((ids: string[]) => void) | null | undefined;\n    selectionMode?: Gtk.SelectionMode | null | undefined;\n};\n\ntype ExpansionProps = {\n    expandedIds?: string[] | null | undefined;\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n};\n\ntype SourceProps<T, S> = {\n    items?: Item<T>[] | undefined;\n    sections?: Section<S, T>[] | undefined;\n};\n\n/** One column of a {@link ColumnView}, pairing Gtk.ColumnViewColumn props with a cell renderer. */\ntype Column<T = unknown> = Omit<GtkColumnViewColumnProps, \"factory\" | \"sorter\" | \"id\" | \"title\"> & {\n    /** Stable identifier, also used to address the column through sorting props. */\n    id: string;\n    title: string;\n    renderCell: ItemRenderer<T>;\n    /** Whether clicking the column header sorts by it. */\n    sortable?: boolean | undefined;\n    headerMenu?: ReactNode;\n};\n\ntype ColumnViewOwnProps<T, S> = SelectionProps &\n    ExpansionProps &\n    SourceProps<T, S> &\n    Omit<ItemSizeProps, \"estimatedItemWidth\"> & {\n        columns: Column<T>[];\n        renderHeader?: HeaderRenderer<S> | null | undefined;\n        /** Id of the column the view is sorted by, making sorting controlled. */\n        sortColumn?: string | null | undefined;\n        sortOrder?: Gtk.SortType | null | undefined;\n        onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;\n    };\n\n/**\n * Props for {@link ColumnView}. Combines the underlying Gtk.ColumnView props with\n * declarative collection props: flat items or grouped sections, controlled selection\n * and expansion, sorting (sortColumn, sortOrder, onSortChanged), an optional section\n * header renderer, and the columns to render.\n */\ntype ColumnViewProps<T = unknown, S = unknown> = Omit<\n    GtkColumnViewProps,\n    \"columns\" | \"model\" | \"headerFactory\" | keyof ColumnViewOwnProps<T, S>\n> &\nColumnViewOwnProps<T, S>;\n\ntype DropDownOwnProps<T, S> = SourceProps<T, S> & {\n    /** Id of the currently selected item, making the selection controlled. */\n    selectedId?: string | null | undefined;\n    onSelectionChanged?: ((id: string) => void) | null | undefined;\n    renderItem?: ItemRenderer<T> | null | undefined;\n    /** Renderer for items in the open popup list, falling back to renderItem when omitted. */\n    renderListItem?: ItemRenderer<T> | null | undefined;\n    /** Renderer for section headers in the popup list. */\n    renderHeader?: HeaderRenderer<S> | null | undefined;\n};\n\n/**\n * Props for {@link DropDown}. The backing widget is chosen through the `component` prop, defaulting to\n * GtkDropDown, and its own props combine with the declarative collection props.\n */\ntype DropDownProps<T = unknown, S = unknown, C extends ElementType = typeof GtkDropDown> = WidgetProps<\n    C,\n    DropDownOwnProps<T, S>,\n    \"model\" | \"factory\" | \"listFactory\" | \"headerFactory\"\n>;\n\ntype GridViewOwnProps<T> = ItemSizeProps &\n    SelectionProps & {\n        items?: Item<T>[] | undefined;\n        renderItem: ItemRenderer<T>;\n    };\n\n/**\n * Props for {@link GridView}. Combines the underlying Gtk.GridView props with\n * declarative collection props: items, a per-cell renderItem, controlled selection,\n * and estimated item sizing.\n */\ntype GridViewProps<T = unknown> = Omit<GtkGridViewProps, \"model\" | \"factory\" | keyof GridViewOwnProps<T>> &\n    GridViewOwnProps<T>;\n\ntype ListViewOwnProps<T, S> = ItemSizeProps &\n    SelectionProps &\n    ExpansionProps &\n    SourceProps<T, S> & {\n        renderItem: ItemRenderer<T>;\n        renderHeader?: HeaderRenderer<S> | null | undefined;\n    };\n\n/**\n * Props for {@link ListView}. Combines the underlying Gtk.ListView props with\n * declarative collection props: flat items or grouped sections, a per-row renderItem,\n * an optional section header renderer, controlled selection and expansion, and\n * estimated item sizing.\n */\ntype ListViewProps<T = unknown, S = unknown> = Omit<\n    GtkListViewProps,\n    \"model\" | \"factory\" | \"headerFactory\" | keyof ListViewOwnProps<T, S>\n> &\nListViewOwnProps<T, S>;\n\n/** Props for {@link SizeGroup}. */\ntype SizeGroupProps = {\n    /** How the group equalizes sizes: horizontal, vertical, or both. */\n    mode?: Gtk.SizeGroupMode | null | undefined;\n    ref?: Ref<Gtk.SizeGroup | null>;\n    children?: ReactNode;\n};\n\n/** Adds a single widget, rendered by the given component, to the enclosing {@link SizeGroup}. */\ntype SizeGroupChildProps<C extends ElementType> = ChildProps<C>;\n\nexport {\n    type SelectionProps,\n    type ExpansionProps,\n    type ChildProps,\n    type WidgetProps,\n    type Item,\n    type Section,\n    type RenderItemArgs,\n    type RenderHeaderArgs,\n    type ItemRenderer,\n    type HeaderRenderer,\n    type Column,\n    type ColumnViewProps,\n    type DropDownProps,\n    type GridViewProps,\n    type ListViewProps,\n    type SizeGroupProps,\n    type SizeGroupChildProps,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/components",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.2",
   "description": "High-level GTKX components for declarative collection views, menus, and containers with attach-time placement",
   "keywords": [
     "gtkx",
@@ -29,6 +29,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./adw": {
+      "types": "./dist/adw/index.d.ts",
+      "default": "./dist/adw/index.js"
     }
   },
   "sideEffects": false,
@@ -40,15 +44,22 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/utils": "1.0.0-rc.1",
-    "@gtkx/react": "1.0.0-rc.1"
+    "@gtkx/react": "1.0.0-rc.2",
+    "@gtkx/utils": "1.0.0-rc.2"
   },
   "peerDependencies": {
-    "react": "^19"
+    "react": "^19.2"
+  },
+  "devDependencies": {
+    "@codspeed/vitest-plugin": "^5.7.1",
+    "vitest": "^4.1.10",
+    "@gtkx/config": "1.0.0-rc.2",
+    "@gtkx/runtime": "1.0.0-rc.2",
+    "@gtkx/testing": "1.0.0-rc.2",
+    "@gtkx/vitest": "1.0.0-rc.2"
   },
   "scripts": {
-    "build": "tsc -b tsconfig.lib.json",
-    "typecheck": "tsc -b --emitDeclarationOnly",
+    "bench": "NODE_ENV=production vitest bench --run --config vitest.bench.config.ts",
     "release": "tsx ../../scripts/release-package.ts"
   }
 }

package/src/adw/index.ts

@@ -0,0 +1,2 @@
+export { ToastProvider, useToast, useToastOverlay } from "./toast.js";
+export type { ToastController, ToastOptions, ToastOverlayController, ToastProviderProps } from "./types.js";

package/src/adw/toast.tsx

@@ -0,0 +1,74 @@
+import type { ReactNode, RefObject } from "react";
+import * as Adw from "@gtkx/gi/adw";
+import { createContext, useContext, useMemo } from "react";
+import type { ToastController, ToastOptions, ToastOverlayController, ToastProviderProps } from "./types.js";
+
+type OverlayRef = RefObject<Adw.ToastOverlay | null>;
+
+const ToastContext = createContext<OverlayRef | null>(null);
+
+const useOverlayRef = (): OverlayRef => {
+    const overlayRef = useContext(ToastContext);
+
+    if (overlayRef === null) {
+        throw new Error("useToast and useToastOverlay must be used within a ToastProvider");
+    }
+
+    return overlayRef;
+};
+
+const buildToast = (options: ToastOptions): Adw.Toast => {
+    const { onButtonClicked, onDismissed, ...props } = options;
+    const toast = new Adw.Toast(props);
+
+    if (onButtonClicked != null) {
+        toast.on("button-clicked", onButtonClicked);
+    }
+
+    if (onDismissed != null) {
+        toast.on("dismissed", onDismissed);
+    }
+
+    return toast;
+};
+
+/** Shares an Adw.ToastOverlay reference with the toast hooks in every descendant. */
+function ToastProvider(props: ToastProviderProps): ReactNode {
+    return <ToastContext.Provider value={props.overlayRef}>{props.children}</ToastContext.Provider>;
+}
+
+/** Returns a {@link ToastController} that shows and dismisses toasts on the nearest provider's overlay. */
+function useToast(): ToastController {
+    const overlayRef = useOverlayRef();
+
+    return useMemo<ToastController>(
+        () => ({
+            show: (options?: ToastOptions) => {
+                const toast = buildToast(options ?? {});
+                overlayRef.current?.addToast(toast);
+
+                return toast;
+            },
+            dismiss: (toast: Adw.Toast) => {
+                toast.dismiss();
+            },
+        }),
+        [overlayRef],
+    );
+}
+
+/** Returns a {@link ToastOverlayController} for the nearest provider's overlay as a whole. */
+function useToastOverlay(): ToastOverlayController {
+    const overlayRef = useOverlayRef();
+
+    return useMemo<ToastOverlayController>(
+        () => ({
+            dismissAll: () => {
+                overlayRef.current?.dismissAll();
+            },
+        }),
+        [overlayRef],
+    );
+}
+
+export { ToastProvider, useToast, useToastOverlay };

package/src/adw/types.ts

@@ -0,0 +1,32 @@
+import type * as Adw from "@gtkx/gi/adw";
+import type { AdwToastProps } from "@gtkx/jsx/adw";
+import type { ReactNode, RefObject } from "react";
+
+/**
+ * Describes a toast raised through {@link useToast}: the construct-time properties of an
+ * `Adw.Toast` plus its `button-clicked` and `dismissed` handlers.
+ */
+type ToastOptions = Adw.ToastConstructorProps & Pick<AdwToastProps, "onButtonClicked" | "onDismissed">;
+
+/** Imperative controls for individual toasts, returned by {@link useToast}. */
+type ToastController = {
+    /** Builds a toast, shows it through the overlay, and returns it. */
+    show: (options?: ToastOptions) => Adw.Toast;
+    /** Dismisses a single toast, typically one returned by {@link ToastController.show}. */
+    dismiss: (toast: Adw.Toast) => void;
+};
+
+/** Imperative controls for the overlay as a whole, returned by {@link useToastOverlay}. */
+type ToastOverlayController = {
+    /** Dismisses the shown toast and every queued one. */
+    dismissAll: () => void;
+};
+
+/** Props for {@link ToastProvider}. */
+type ToastProviderProps = {
+    /** Ref also given to the `AdwToastOverlay` the toasts appear over. */
+    overlayRef: RefObject<Adw.ToastOverlay | null>;
+    children?: ReactNode | undefined;
+};
+
+export { type ToastOptions, type ToastController, type ToastOverlayController, type ToastProviderProps };