@gtkx/components 0.21.0 → 1.0.0-rc.1

package/dist/list-view.js

@@ -1,31 +1,56 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { GtkListView } from "@gtkx/jsx/gtk";
-import { CollectionView } from "./collection-view.js";
-const factoryBinding = {
-    install: (widget, factory) => widget.setFactory(factory),
-    uninstall: (widget) => widget.setFactory(null),
-};
-const headerFactoryBinding = {
-    install: (widget, factory) => widget.setHeaderFactory(factory),
-    uninstall: (widget) => widget.setHeaderFactory(null),
-};
-const modelBinding = {
-    install: (widget, model) => widget.setModel(model),
+import { CellRenderHost, createTreeRenderContext, HeaderRenderHost, itemRenderer, } from "./cell.js";
+import { makeFactoryInstaller, useCellContainers } from "./hooks/use-cell-containers.js";
+import { useCollectionWidget } from "./hooks/use-collection-widget.js";
+const factoryInstaller = makeFactoryInstaller((widget, factory) => widget.setFactory(factory));
+const headerFactoryInstaller = makeFactoryInstaller((widget, factory) => widget.setHeaderFactory(factory));
+const useListViewWiring = (props) => {
+    const { widgetRef, setRef, collection } = useCollectionWidget(props);
+    const useHeader = collection.useHeader;
+    const itemStore = useCellContainers({
+        object: widgetRef,
+        installer: factoryInstaller,
+        estimatedHeight: props.estimatedItemHeight,
+        estimatedWidth: props.estimatedItemWidth,
+    });
+    const headerStore = useCellContainers({
+        object: useHeader ? widgetRef : null,
+        installer: headerFactoryInstaller,
+        estimatedHeight: props.estimatedItemHeight,
+        estimatedWidth: props.estimatedItemWidth,
+    });
+    return {
+        setRef,
+        resolver: collection.resolver,
+        headerResolver: collection.headerResolver,
+        itemStore,
+        headerStore,
+        useHeader,
+        rowId: collection.rowId,
+    };
 };
 /**
- * A `GtkListView` driven by a declarative `items`/`renderItem` API with
- * optional controlled selection, section headers, and tree autoexpansion.
- * Supplying an external `model` switches to the uncontrolled form.
+ * Renders a Gtk.ListView: a scrollable, single-column list backed by a collection
+ * model, with each row drawn by renderItem and optional section headers.
  */
 export const ListView = (props) => {
-    const { ref, items, model, renderItem, autoexpand, renderHeader, selected, selectionMode, onSelectionChanged, estimatedItemHeight, estimatedItemWidth, ...intrinsicProps } = props;
-    const renderItemFn = renderItem;
-    const slotRenderer = (value, treeRow, isHeader) => {
-        if (isHeader)
-            return null;
-        return treeRow === null ? renderItemFn(value) : renderItemFn(value, treeRow);
-    };
-    const useHeader = model === undefined && typeof renderHeader === "function";
-    return (_jsx(CollectionView, { element: GtkListView, intrinsicProps: intrinsicProps, ref: ref, items: model === undefined ? items : undefined, model: model, renderItem: slotRenderer, autoexpand: autoexpand, renderHeader: useHeader ? (value) => renderHeader?.(value) ?? null : undefined, estimatedHeight: estimatedItemHeight, estimatedWidth: estimatedItemWidth, selected: selected, selectionMode: selectionMode, onSelectionChanged: onSelectionChanged, factoryBinding: factoryBinding, headerFactoryBinding: useHeader ? headerFactoryBinding : undefined, modelBinding: modelBinding }));
+    const { ref, items, sections, renderItem, renderHeader, selectedIds, selectionMode, onSelectionChanged, expandedIds, onExpandedChange, estimatedItemHeight, estimatedItemWidth, ...intrinsicProps } = props;
+    const wiring = useListViewWiring({
+        ref,
+        items,
+        sections,
+        renderHeader,
+        selectedIds,
+        selectionMode,
+        onSelectionChanged,
+        expandedIds,
+        onExpandedChange,
+        estimatedItemHeight,
+        estimatedItemWidth,
+    });
+    const treeContext = createTreeRenderContext(expandedIds, wiring.rowId);
+    const cellRenderer = itemRenderer(renderItem, treeContext);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkListView, { ...intrinsicProps, ref: wiring.setRef }), _jsx(CellRenderHost, { store: wiring.itemStore, resolver: wiring.resolver, render: cellRenderer }), _jsx(HeaderRenderHost, { useHeader: wiring.useHeader, store: wiring.headerStore, resolver: wiring.headerResolver, renderHeader: renderHeader })] }));
 };
 //# sourceMappingURL=list-view.js.map

package/dist/list-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-view.js","sourceRoot":"","sources":["../src/list-view.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AAIzE,MAAM,cAAc,GAAG;IACnB,OAAO,EAAE,CAAC,MAAoB,EAAE,OAAkC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;IACjG,SAAS,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,oBAAoB,GAAG;IACzB,OAAO,EAAE,CAAC,MAAoB,EAAE,OAAkC,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC;IACvG,SAAS,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC;CACrE,CAAC;AAEF,MAAM,YAAY,GAA+B;IAC7C,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAA2B,CAAC;CAC3E,CAAC;AAUF;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAA2B,KAAmC,EAAa,EAAE;IACjG,MAAM,EACF,GAAG,EACH,KAAK,EACL,KAAK,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,GAAG,cAAc,EACpB,GAAG,KAKH,CAAC;IAEF,MAAM,YAAY,GAAG,UAAkE,CAAC;IACxF,MAAM,YAAY,GAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAClE,IAAI,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,KAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAU,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,UAAU,CAAC;IAE5E,OAAO,CACH,KAAC,cAAc,IACX,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,cAAc,EAC9B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAC9C,KAAK,EAAE,KAAkC,EACzC,UAAU,EAAE,YAAY,EACxB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,KAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,EACnF,eAAe,EAAE,mBAAmB,EACpC,cAAc,EAAE,kBAAkB,EAClC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,cAAc,EAC9B,oBAAoB,EAAE,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS,EAClE,YAAY,EAAE,YAAY,GAC5B,CACL,CAAC;AACN,CAAC,CAAC"}
+{"version":3,"file":"list-view.js","sourceRoot":"","sources":["../src/list-view.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkListView, type GtkListViewProps } from \"@gtkx/jsx/gtk\";\nimport type { ReactNode, Ref } from \"react\";\nimport {\n    type CellRenderer,\n    CellRenderHost,\n    createTreeRenderContext,\n    HeaderRenderHost,\n    itemRenderer,\n    type TreeRenderContext,\n} from \"./cell.js\";\nimport { makeFactoryInstaller, useCellContainers } from \"./hooks/use-cell-containers.js\";\nimport { useCollectionWidget } from \"./hooks/use-collection-widget.js\";\nimport type {\n    CollectionItemSizeProps,\n    ControlledExpansionProps,\n    ControlledSelectionProps,\n    ItemNode,\n    RenderItemProps,\n    SectionNode,\n} from \"./types.js\";\nimport type { CellContainerStore } from \"./utils/cell-container-store.js\";\nimport type { ItemResolver } from \"./utils/item-resolver.js\";\n\nconst factoryInstaller = makeFactoryInstaller<Gtk.ListView>((widget, factory) => widget.setFactory(factory));\n\nconst headerFactoryInstaller = makeFactoryInstaller<Gtk.ListView>((widget, factory) =>\n    widget.setHeaderFactory(factory),\n);\n\nexport type ListViewDeclarativeProps<T = unknown, S = unknown> = CollectionItemSizeProps &\n    ControlledSelectionProps &\n    ControlledExpansionProps & {\n        items?: ItemNode<T>[] | undefined;\n        sections?: SectionNode<S, T>[] | undefined;\n        renderItem: (props: RenderItemProps<T>) => ReactNode;\n        renderHeader?: ((info: { section: S }) => ReactNode) | 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 */\nexport type ListViewProps<T = unknown, S = unknown> = Omit<\n    GtkListViewProps,\n    \"model\" | \"factory\" | \"headerFactory\" | keyof ListViewDeclarativeProps<T, S>\n> &\n    ListViewDeclarativeProps<T, S>;\n\ninterface ListViewWiring<T, S> {\n    setRef: (value: Gtk.ListView | null) => void;\n    resolver: ItemResolver<T, S>;\n    headerResolver: ItemResolver<T, S>;\n    itemStore: CellContainerStore;\n    headerStore: CellContainerStore;\n    useHeader: boolean;\n    rowId: (row: Gtk.TreeListRow) => string | undefined;\n}\n\nconst useListViewWiring = <T, S>(props: NormalizedListViewProps<T, S>): ListViewWiring<T, S> => {\n    const { widgetRef, setRef, collection } = useCollectionWidget<Gtk.ListView, T, S>(props);\n\n    const useHeader = collection.useHeader;\n\n    const itemStore = useCellContainers<Gtk.ListView>({\n        object: widgetRef,\n        installer: factoryInstaller,\n        estimatedHeight: props.estimatedItemHeight,\n        estimatedWidth: props.estimatedItemWidth,\n    });\n    const headerStore = useCellContainers<Gtk.ListView>({\n        object: useHeader ? widgetRef : null,\n        installer: headerFactoryInstaller,\n        estimatedHeight: props.estimatedItemHeight,\n        estimatedWidth: props.estimatedItemWidth,\n    });\n\n    return {\n        setRef,\n        resolver: collection.resolver,\n        headerResolver: collection.headerResolver,\n        itemStore,\n        headerStore,\n        useHeader,\n        rowId: collection.rowId,\n    };\n};\n\ntype NormalizedListViewProps<T, S> = ListViewDeclarativeProps<T, S> & {\n    ref?: Ref<Gtk.ListView | null>;\n    estimatedItemHeight?: number;\n    estimatedItemWidth?: number;\n    [key: string]: unknown;\n};\n\n/**\n * Renders a Gtk.ListView: a scrollable, single-column list backed by a collection\n * model, with each row drawn by renderItem and optional section headers.\n */\nexport const ListView = <T = unknown, S = unknown>(props: ListViewProps<T, S>): ReactNode => {\n    const {\n        ref,\n        items,\n        sections,\n        renderItem,\n        renderHeader,\n        selectedIds,\n        selectionMode,\n        onSelectionChanged,\n        expandedIds,\n        onExpandedChange,\n        estimatedItemHeight,\n        estimatedItemWidth,\n        ...intrinsicProps\n    } = props as NormalizedListViewProps<T, S>;\n\n    const wiring = useListViewWiring<T, S>({\n        ref,\n        items,\n        sections,\n        renderHeader,\n        selectedIds,\n        selectionMode,\n        onSelectionChanged,\n        expandedIds,\n        onExpandedChange,\n        estimatedItemHeight,\n        estimatedItemWidth,\n    } as NormalizedListViewProps<T, S>);\n\n    const treeContext: TreeRenderContext = createTreeRenderContext(expandedIds, wiring.rowId);\n    const cellRenderer: CellRenderer<T, S> = itemRenderer<T, S>(renderItem, treeContext);\n\n    return (\n        <>\n            <GtkListView {...intrinsicProps} ref={wiring.setRef} />\n            <CellRenderHost store={wiring.itemStore} resolver={wiring.resolver} render={cellRenderer} />\n            <HeaderRenderHost\n                useHeader={wiring.useHeader}\n                store={wiring.headerStore}\n                resolver={wiring.headerResolver}\n                renderHeader={renderHeader}\n            />\n        </>\n    );\n};\n"]}

package/dist/menu-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-items.d.ts","sourceRoot":"","sources":["../src/menu-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyB5C,eAAO,MAAM,cAAc,GAAI,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,KAAG,IAG5E,CAAC;AAcF,eAAO,MAAM,cAAc,GAAI,GAAG,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,KAAG,OAI7E,CAAC"}
+{"version":3,"file":"menu-items.d.ts","sourceRoot":"","sources":["../src/menu-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyB5C,eAAO,MAAM,cAAc,SAAU,GAAG,CAAC,IAAI,WAAW,SAAS,EAAE,GAAG,IAAI,KAAG,IAG5E,CAAC;AAcF,eAAO,MAAM,cAAc,MAAO,SAAS,EAAE,GAAG,IAAI,KAAK,SAAS,EAAE,GAAG,IAAI,KAAG,OAI7E,CAAC"}

package/dist/menu-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu-items.js","sourceRoot":"","sources":["../src/menu-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,MAAM,cAAc,GAAG,CAAC,OAAoB,EAAY,EAAE;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5B,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAc,EAAE,OAAoB,EAAQ,EAAE;IACjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,SAAS;QACb,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAc,EAAE,OAA2B,EAAQ,EAAE;IAChF,IAAI,CAAC,SAAS,EAAE,CAAC;IACjB,IAAI,OAAO;QAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAY,EAAE,CAAY,EAAW,EAAE,CACvD,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;IACnB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;IACrB,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IACpC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,CAA0B,EAAE,CAA0B,EAAW,EAAE;IACvF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAc,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAqB,EAAE,CAAqB,EAAW,EAAE;IACpF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC"}
+{"version":3,"file":"menu-items.js","sourceRoot":"","sources":["../src/menu-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,MAAM,cAAc,GAAG,CAAC,OAAoB,EAAY,EAAE;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5B,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAc,EAAE,OAAoB,EAAQ,EAAE;IACjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,SAAS;QACb,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACvE,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAc,EAAE,OAA2B,EAAQ,EAAE;IAChF,IAAI,CAAC,SAAS,EAAE,CAAC;IACjB,IAAI,OAAO;QAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAY,EAAE,CAAY,EAAW,EAAE,CACvD,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;IACnB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;IACrB,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IACpC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,CAA0B,EAAE,CAA0B,EAAW,EAAE;IACvF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAc,CAAC,CAAC,CAAC;AACxG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAqB,EAAE,CAAqB,EAAW,EAAE;IACpF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC","sourcesContent":["import * as Gio from \"@gtkx/gi/gio\";\nimport type { MenuEntry } from \"./types.js\";\n\nconst buildMenuModel = (entries: MenuEntry[]): Gio.Menu => {\n    const menu = new Gio.Menu();\n    appendEntries(menu, entries);\n    return menu;\n};\n\nconst appendEntries = (menu: Gio.Menu, entries: MenuEntry[]): void => {\n    for (const entry of entries) {\n        if (entry.section !== undefined) {\n            menu.appendSection(entry.label ?? null, buildMenuModel(entry.section));\n            continue;\n        }\n        if (entry.submenu !== undefined) {\n            menu.appendSubmenu(entry.label ?? null, buildMenuModel(entry.submenu));\n            continue;\n        }\n        const item = new Gio.MenuItem();\n        if (entry.label !== undefined) item.setLabel(entry.label);\n        if (entry.action !== undefined) item.setDetailedAction(entry.action);\n        menu.appendItem(item);\n    }\n};\n\nexport const applyMenuItems = (menu: Gio.Menu, entries: MenuEntry[] | null): void => {\n    menu.removeAll();\n    if (entries) appendEntries(menu, entries);\n};\n\nconst entryEqual = (a: MenuEntry, b: MenuEntry): boolean =>\n    a.label === b.label &&\n    a.action === b.action &&\n    entryListEqual(a.submenu, b.submenu) &&\n    entryListEqual(a.section, b.section);\n\nconst entryListEqual = (a: MenuEntry[] | undefined, b: MenuEntry[] | undefined): boolean => {\n    if (a === b) return true;\n    if (a === undefined || b === undefined) return false;\n    return a.length === b.length && a.every((entry, index) => entryEqual(entry, b[index] as MenuEntry));\n};\n\nexport const menuItemsEqual = (a: MenuEntry[] | null, b: MenuEntry[] | null): boolean => {\n    if (a === b) return true;\n    if (a === null || b === null) return false;\n    return entryListEqual(a, b);\n};\n"]}

package/dist/menu.d.ts

@@ -1,18 +1,14 @@
 import type * as Gio from "@gtkx/gi/gio";
 import { type GMenuProps } from "@gtkx/jsx/gio";
 import { type ReactNode, type Ref } from "react";
-import type { MenuItemsProps } from "./types.js";
-/**
- * Props for the {@link Menu} component: the raw `GMenu` element surface with a
- * declarative `items` model layered on top.
- */
+import type { MenuEntry } from "./types.js";
+export type MenuItemsProps = {
+    items?: MenuEntry[] | null | undefined;
+};
+/** Props for {@link Menu}, combining Gio.Menu props with a declarative items array. */
 export type MenuProps = Omit<GMenuProps, keyof MenuItemsProps> & MenuItemsProps & {
     ref?: Ref<Gio.Menu | null>;
 };
-/**
- * A declarative `Gio.Menu` built from an `items` tree of {@link MenuEntry}
- * values. Rebuilds the underlying menu model whenever the item structure
- * changes.
- */
+/** Builds a Gio.Menu model from a declarative array of {@link MenuEntry} items. */
 export declare const Menu: (props: MenuProps) => ReactNode;
 //# sourceMappingURL=menu.d.ts.map

package/dist/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../src/menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,GAAG,EAA2B,MAAM,OAAO,CAAC;AAEzF,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC,GAAG,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;CAAE,CAAC;AAEjH;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,KAAG,SAevC,CAAC"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../src/menu.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,GAAG,EAA2B,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,cAAc,CAAC,GAAG,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;CAAE,CAAC;AAEjH,mFAAmF;AACnF,eAAO,MAAM,IAAI,UAAW,SAAS,KAAG,SAgBvC,CAAC"}

package/dist/menu.js

@@ -1,15 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
 import { GMenu } from "@gtkx/jsx/gio";
-import { useForwardedRef } from "@gtkx/react";
-import { createElement, useLayoutEffect, useRef } from "react";
+import { useMergeRefs } from "@gtkx/react/internal";
+import { useLayoutEffect, useRef } from "react";
 import { applyMenuItems, menuItemsEqual } from "./menu-items.js";
-/**
- * A declarative `Gio.Menu` built from an `items` tree of {@link MenuEntry}
- * values. Rebuilds the underlying menu model whenever the item structure
- * changes.
- */
+/** Builds a Gio.Menu model from a declarative array of {@link MenuEntry} items. */
 export const Menu = (props) => {
     const { items, ref, ...rest } = props;
-    const [menuRef, mergedRef] = useForwardedRef(ref);
+    const menuRef = useRef(null);
+    const mergedRef = useMergeRefs(ref, menuRef);
     const appliedRef = useRef(null);
     useLayoutEffect(() => {
         const menu = menuRef.current;
@@ -21,6 +19,6 @@ export const Menu = (props) => {
         appliedRef.current = entries;
         applyMenuItems(menu, entries);
     });
-    return createElement(GMenu, { ...rest, ref: mergedRef });
+    return _jsx(GMenu, { ...rest, ref: mergedRef });
 };
 //# sourceMappingURL=menu.js.map

package/dist/menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAmB,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAA4B,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAa,EAAE;IAChD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAEpD,eAAe,CAAC,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC;QAC9B,IAAI,cAAc,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,OAAO;QACxD,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;AAC7D,CAAC,CAAC"}
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../src/menu.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAmB,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAA4B,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjE,mFAAmF;AACnF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAa,EAAE;IAChD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAEpD,eAAe,CAAC,GAAG,EAAE;QACjB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC;QAC9B,IAAI,cAAc,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;YAAE,OAAO;QACxD,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,KAAC,KAAK,OAAK,IAAI,EAAE,GAAG,EAAE,SAAS,GAAI,CAAC;AAC/C,CAAC,CAAC","sourcesContent":["import type * as Gio from \"@gtkx/gi/gio\";\nimport { GMenu, type GMenuProps } from \"@gtkx/jsx/gio\";\nimport { useMergeRefs } from \"@gtkx/react/internal\";\nimport { type ReactNode, type Ref, useLayoutEffect, useRef } from \"react\";\nimport { applyMenuItems, menuItemsEqual } from \"./menu-items.js\";\nimport type { MenuEntry } from \"./types.js\";\n\nexport type MenuItemsProps = {\n    items?: MenuEntry[] | null | undefined;\n};\n\n/** Props for {@link Menu}, combining Gio.Menu props with a declarative items array. */\nexport type MenuProps = Omit<GMenuProps, keyof MenuItemsProps> & MenuItemsProps & { ref?: Ref<Gio.Menu | null> };\n\n/** Builds a Gio.Menu model from a declarative array of {@link MenuEntry} items. */\nexport const Menu = (props: MenuProps): ReactNode => {\n    const { items, ref, ...rest } = props;\n    const menuRef = useRef<Gio.Menu | null>(null);\n    const mergedRef = useMergeRefs(ref, menuRef);\n    const appliedRef = useRef<MenuEntry[] | null>(null);\n\n    useLayoutEffect(() => {\n        const menu = menuRef.current;\n        if (!menu) return;\n        const entries = items ?? null;\n        if (menuItemsEqual(appliedRef.current, entries)) return;\n        appliedRef.current = entries;\n        applyMenuItems(menu, entries);\n    });\n\n    return <GMenu {...rest} ref={mergedRef} />;\n};\n"]}

package/dist/overlay.d.ts

@@ -0,0 +1,24 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+import { type GtkOverlayProps } from "@gtkx/jsx/gtk";
+import { type ElementType, type ReactNode, type Ref } from "react";
+import type { ChildProps } from "./types.js";
+/** Props for {@link Overlay}. */
+export type OverlayProps = GtkOverlayProps & {
+    ref?: Ref<Gtk.Overlay | null>;
+};
+export type OverlayPlacementProps = {
+    /** Whether this overlay contributes to the Overlay's measured size. */
+    measure?: boolean | null | undefined;
+    /** Whether the overlay is clipped to the main child's allocation. */
+    clipOverlay?: boolean | null | undefined;
+};
+/** Adds a single widget as an overlay on top of an {@link Overlay}'s main child. */
+export type OverlayChildProps<C extends ElementType> = ChildProps<C, OverlayPlacementProps>;
+/**
+ * Renders a Gtk.Overlay: a main child with one or more widgets stacked on top,
+ * declared via {@link Overlay.Child}. Non-Child children form the main content.
+ */
+export declare const Overlay: ((props: OverlayProps) => ReactNode) & {
+    Child: <C extends ElementType>(props: OverlayChildProps<C>) => ReactNode;
+};
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAY,KAAK,WAAW,EAAkB,KAAK,SAAS,EAAE,KAAK,GAAG,EAAU,MAAM,OAAO,CAAC;AAErG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAChC,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,IAAI,UAAU,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;AA0C5F;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,CAAC,GAAG;IACzD,KAAK,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;CAkB5E,CAAC"}

package/dist/overlay.js

@@ -0,0 +1,49 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { GtkOverlay } from "@gtkx/jsx/gtk";
+import { useMergeRefs } from "@gtkx/react/internal";
+import { Children, isValidElement, useRef } from "react";
+import { createParentContext, usePlacedChild } from "./hooks/use-placed-child.js";
+const { Context: OverlayContext, useParentRef: useOverlayRef } = createParentContext("<Overlay.Child> must be a child of <Overlay>");
+const placementOf = (props) => ({
+    measure: props.measure ?? false,
+    clipOverlay: props.clipOverlay ?? false,
+});
+const samePlacement = (a, b) => a.measure === b.measure && a.clipOverlay === b.clipOverlay;
+const OverlayChild = ({ component, measure, clipOverlay, ref, ...rest }) => {
+    const overlayRef = useOverlayRef();
+    const Component = component;
+    return usePlacedChild({
+        render: (placeRef) => _jsx(Component, { ...rest, ref: placeRef }),
+        ref,
+        placement: placementOf({ measure, clipOverlay }),
+        samePlacement,
+        place: (widget, placement) => {
+            const overlay = overlayRef.current;
+            if (!overlay)
+                return;
+            if (widget.getParent() !== overlay)
+                overlay.addOverlay(widget);
+            overlay.setMeasureOverlay(widget, placement.measure);
+            overlay.setClipOverlay(widget, placement.clipOverlay);
+        },
+        release: (widget) => {
+            const overlay = overlayRef.current;
+            if (overlay && widget.getParent() === overlay)
+                overlay.removeOverlay(widget);
+        },
+    });
+};
+const isOverlayChild = (node) => isValidElement(node) && node.type === OverlayChild;
+/**
+ * Renders a Gtk.Overlay: a main child with one or more widgets stacked on top,
+ * declared via {@link Overlay.Child}. Non-Child children form the main content.
+ */
+export const Overlay = Object.assign(({ children, ref, ...rest }) => {
+    const overlayRef = useRef(null);
+    const mergedRef = useMergeRefs(ref, overlayRef);
+    const items = Children.toArray(children);
+    const overlays = items.filter(isOverlayChild);
+    const base = items.filter((node) => !isOverlayChild(node));
+    return (_jsxs(_Fragment, { children: [_jsx(GtkOverlay, { ...rest, ref: mergedRef, children: base }), _jsx(OverlayContext.Provider, { value: overlayRef, children: overlays })] }));
+}, { Child: OverlayChild });
+//# sourceMappingURL=overlay.js.map

package/dist/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../src/overlay.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkOverlay, type GtkOverlayProps } from \"@gtkx/jsx/gtk\";\nimport { useMergeRefs } from \"@gtkx/react/internal\";\nimport { Children, type ElementType, isValidElement, type ReactNode, type Ref, useRef } from \"react\";\nimport { createParentContext, usePlacedChild } from \"./hooks/use-placed-child.js\";\nimport type { ChildProps } from \"./types.js\";\n\nconst { Context: OverlayContext, useParentRef: useOverlayRef } = createParentContext<Gtk.Overlay>(\n    \"<Overlay.Child> must be a child of <Overlay>\",\n);\n\n/** Props for {@link Overlay}. */\nexport type OverlayProps = GtkOverlayProps & { ref?: Ref<Gtk.Overlay | null> };\n\nexport type OverlayPlacementProps = {\n    /** Whether this overlay contributes to the Overlay's measured size. */\n    measure?: boolean | null | undefined;\n    /** Whether the overlay is clipped to the main child's allocation. */\n    clipOverlay?: boolean | null | undefined;\n};\n\n/** Adds a single widget as an overlay on top of an {@link Overlay}'s main child. */\nexport type OverlayChildProps<C extends ElementType> = ChildProps<C, OverlayPlacementProps>;\n\ntype OverlayPlacement = { measure: boolean; clipOverlay: boolean };\n\nconst placementOf = (props: OverlayPlacementProps): OverlayPlacement => ({\n    measure: props.measure ?? false,\n    clipOverlay: props.clipOverlay ?? false,\n});\n\nconst samePlacement = (a: OverlayPlacement, b: OverlayPlacement): boolean =>\n    a.measure === b.measure && a.clipOverlay === b.clipOverlay;\n\nconst OverlayChild = <C extends ElementType>({\n    component,\n    measure,\n    clipOverlay,\n    ref,\n    ...rest\n}: OverlayChildProps<C>): ReactNode => {\n    const overlayRef = useOverlayRef();\n    const Component: ElementType = component;\n    return usePlacedChild<Gtk.Widget, OverlayPlacement>({\n        render: (placeRef) => <Component {...rest} ref={placeRef} />,\n        ref,\n        placement: placementOf({ measure, clipOverlay }),\n        samePlacement,\n        place: (widget, placement) => {\n            const overlay = overlayRef.current;\n            if (!overlay) return;\n            if (widget.getParent() !== overlay) overlay.addOverlay(widget);\n            overlay.setMeasureOverlay(widget, placement.measure);\n            overlay.setClipOverlay(widget, placement.clipOverlay);\n        },\n        release: (widget) => {\n            const overlay = overlayRef.current;\n            if (overlay && widget.getParent() === overlay) overlay.removeOverlay(widget);\n        },\n    });\n};\n\nconst isOverlayChild = (node: ReactNode): boolean => isValidElement(node) && node.type === OverlayChild;\n\n/**\n * Renders a Gtk.Overlay: a main child with one or more widgets stacked on top,\n * declared via {@link Overlay.Child}. Non-Child children form the main content.\n */\nexport const Overlay: ((props: OverlayProps) => ReactNode) & {\n    Child: <C extends ElementType>(props: OverlayChildProps<C>) => ReactNode;\n} = Object.assign(\n    ({ children, ref, ...rest }: OverlayProps): ReactNode => {\n        const overlayRef = useRef<Gtk.Overlay | null>(null);\n        const mergedRef = useMergeRefs<Gtk.Overlay>(ref, overlayRef);\n        const items = Children.toArray(children);\n        const overlays = items.filter(isOverlayChild);\n        const base = items.filter((node) => !isOverlayChild(node));\n        return (\n            <>\n                <GtkOverlay {...rest} ref={mergedRef}>\n                    {base}\n                </GtkOverlay>\n                <OverlayContext.Provider value={overlayRef}>{overlays}</OverlayContext.Provider>\n            </>\n        );\n    },\n    { Child: OverlayChild },\n);\n"]}

package/dist/size-group.d.ts

@@ -0,0 +1,20 @@
+import type * as Gtk from "@gtkx/gi/gtk";
+import { type ElementType, type ReactNode, type Ref } from "react";
+import type { ChildProps } from "./types.js";
+/** Props for {@link SizeGroup}. */
+export 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}. */
+export type SizeGroupChildProps<C extends ElementType> = ChildProps<C>;
+/**
+ * Creates a Gtk.SizeGroup that keeps its member widgets at a common size. Members join the group
+ * through {@link SizeGroup.Child}.
+ */
+export declare const SizeGroup: ((props: SizeGroupProps) => ReactNode) & {
+    Child: <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;
+};
+//# sourceMappingURL=size-group.d.ts.map

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

@@ -0,0 +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"}

package/dist/size-group.js

@@ -0,0 +1,57 @@
+import { Fragment as _Fragment, jsx as _jsx, 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";
+const SizeGroupContext = createContext(null);
+const useSizeGroupRegistry = () => {
+    const registry = useContext(SizeGroupContext);
+    if (!registry)
+        throw new Error("<SizeGroup.Child> must be a child of <SizeGroup>");
+    return registry;
+};
+const SizeGroupChild = ({ component, ref, ...rest }) => {
+    const registry = useSizeGroupRegistry();
+    const joinGroup = 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 });
+//# sourceMappingURL=size-group.js.map

package/dist/size-group.js.map

@@ -0,0 +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"]}