@gtkx/components 0.21.0 → 1.0.0-rc.2

package/dist/internal/use-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection.js","sourceRoot":"","sources":["../../src/internal/use-collection.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAK3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgB9C,SAAS,OAAO,CAAC,GAAoB,EAAE,KAAsB,EAAE,QAAwC;IACnG,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhB,OAAO;IACX,CAAC;IAED,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;IAExB,IAAI,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;YAAS,CAAC;QACP,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA8B;IACrD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5G,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAE7E,eAAe,CAAC,GAAG,EAAE;QACjB,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3B,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,OAA0B;IAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE3G,MAAM,SAAS,GAAG,YAAY,CAAC;QAC3B,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;KACvC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAsD,CAAC","sourcesContent":["import type { ReactElement, RefObject } from \"react\";\nimport { useLayoutEffect, useMemo, useState } from \"react\";\nimport type { ExpansionProps, Item, Section, SelectionProps } from \"../types.js\";\nimport type { CollectionIndex } from \"./collection-index.js\";\nimport type { CollectionModel } from \"./collection-model.js\";\nimport type { Collection } from \"./collection.js\";\nimport { createCollectionIndex } from \"./collection-index.js\";\nimport { createCollectionModel } from \"./collection-model.js\";\nimport { createCollection } from \"./collection.js\";\nimport { useExpansion } from \"./expansion.js\";\nimport { useSelection } from \"./selection.js\";\n\ntype CollectionDataOptions = {\n    items?: Item[] | undefined;\n    sections?: Section[] | undefined;\n    flat?: boolean | undefined;\n    applying?: RefObject<boolean> | undefined;\n};\n\ntype CollectionOptions = CollectionDataOptions & SelectionProps & ExpansionProps;\n\ntype CollectionResult = {\n    collection: Collection;\n    selection: ReactElement;\n};\n\nfunction runSync(gtk: CollectionModel, index: CollectionIndex, applying: RefObject<boolean> | undefined): void {\n    if (applying === undefined) {\n        gtk.sync(index);\n\n        return;\n    }\n\n    applying.current = true;\n\n    try {\n        gtk.sync(index);\n    } finally {\n        applying.current = false;\n    }\n}\n\nfunction useCollectionData(options: CollectionDataOptions): Collection {\n    const { items, sections, flat, applying } = options;\n    const [gtk] = useState(createCollectionModel);\n    const index = useMemo(() => createCollectionIndex(items, sections, flat === true), [items, sections, flat]);\n    const collection = useMemo(() => createCollection(gtk, index), [gtk, index]);\n\n    useLayoutEffect(() => {\n        runSync(gtk, index, applying);\n    }, [gtk, index, applying]);\n\n    return collection;\n}\n\nfunction useCollection(options: CollectionOptions): CollectionResult {\n    const collection = useCollectionData(options);\n    useExpansion({ collection, expandedIds: options.expandedIds, onExpandedChange: options.onExpandedChange });\n\n    const selection = useSelection({\n        collection,\n        selectedIds: options.selectedIds,\n        onSelectionChanged: options.onSelectionChanged,\n        selectionMode: options.selectionMode,\n    });\n\n    return { collection, selection };\n}\n\nexport { useCollection, useCollectionData, type CollectionDataOptions, type CollectionOptions };\n"]}

package/dist/internal/use-widget-ref.d.ts

@@ -0,0 +1,4 @@
+import type { Ref, RefCallback } from "react";
+declare const useWidgetRef: <T>(external: Ref<T | null> | null | undefined) => [T | null, RefCallback<T | null>];
+export { useWidgetRef };
+//# sourceMappingURL=use-widget-ref.d.ts.map

package/dist/internal/use-widget-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-widget-ref.d.ts","sourceRoot":"","sources":["../../src/internal/use-widget-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAI9C,QAAA,MAAM,YAAY,GAAI,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,CAAC,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,CAIrG,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/internal/use-widget-ref.js

@@ -0,0 +1,8 @@
+import { useMergedRef } from "@gtkx/react/internal";
+import { useState } from "react";
+const useWidgetRef = (external) => {
+    const [widget, setWidget] = useState(null);
+    return [widget, useMergedRef(external, setWidget)];
+};
+export { useWidgetRef };
+//# sourceMappingURL=use-widget-ref.js.map

package/dist/internal/use-widget-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-widget-ref.js","sourceRoot":"","sources":["../../src/internal/use-widget-ref.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,MAAM,YAAY,GAAG,CAAI,QAA0C,EAAqC,EAAE;IACtG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IAErD,OAAO,CAAC,MAAM,EAAE,YAAY,CAAW,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { Ref, RefCallback } from \"react\";\nimport { useMergedRef } from \"@gtkx/react/internal\";\nimport { useState } from \"react\";\n\nconst useWidgetRef = <T>(external: Ref<T | null> | null | undefined): [T | null, RefCallback<T | null>] => {\n    const [widget, setWidget] = useState<T | null>(null);\n\n    return [widget, useMergedRef<T | null>(external, setWidget)];\n};\n\nexport { useWidgetRef };\n"]}

package/dist/list-view.d.ts

@@ -1,16 +1,9 @@
-import { type GtkListViewProps } from "@gtkx/jsx/gtk";
 import type { ReactNode } from "react";
 import type { ListViewProps } from "./types.js";
 /**
- * Props for the {@link ListView} component: the raw `GtkListView` element
- * surface with its factory/model wiring replaced by the declarative
- * {@link ListViewProps} API.
+ * Renders a Gtk.ListView from declarative items or sections, with per-row rendering,
+ * controlled selection, controlled tree expansion, and estimated item sizing.
  */
-export type ListViewComponentProps<T = unknown, S = unknown> = Omit<GtkListViewProps, keyof ListViewProps<T, S>> & ListViewProps<T, S>;
-/**
- * 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.
- */
-export declare const ListView: <T = unknown, S = unknown>(props: ListViewComponentProps<T, S>) => ReactNode;
+declare function ListView<T = unknown, S = unknown>(props: ListViewProps<T, S>): ReactNode;
+export { ListView };
 //# sourceMappingURL=list-view.d.ts.map

package/dist/list-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-view.d.ts","sourceRoot":"","sources":["../src/list-view.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAO,MAAM,OAAO,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC5G,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SAiDxF,CAAC"}
+{"version":3,"file":"list-view.d.ts","sourceRoot":"","sources":["../src/list-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD;;;GAGG;AACH,iBAAS,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAwBjF;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/list-view.js

@@ -1,31 +1,35 @@
-import { jsx as _jsx } 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 { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { GtkListView, GtkSignalListItemFactory } from "@gtkx/jsx/gtk";
+import { omit } from "@gtkx/utils";
+import { HeaderPortals, ItemPortals, useHeaderCells, useItemCells } from "./internal/cells.js";
+import { useCollection } from "./internal/use-collection.js";
+const LIST_VIEW_PROPS = [
+    "items",
+    "sections",
+    "renderItem",
+    "renderHeader",
+    "selectedIds",
+    "onSelectionChanged",
+    "selectionMode",
+    "expandedIds",
+    "onExpandedChange",
+    "estimatedItemHeight",
+    "estimatedItemWidth",
+];
 /**
- * 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 from declarative items or sections, with per-row rendering,
+ * controlled selection, controlled tree expansion, and estimated item sizing.
  */
-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 }));
-};
+function ListView(props) {
+    const { renderItem, renderHeader, expandedIds, estimatedItemHeight, estimatedItemWidth } = props;
+    const rest = omit(props, LIST_VIEW_PROPS);
+    const size = { width: estimatedItemWidth ?? -1, height: estimatedItemHeight ?? -1 };
+    const { collection, selection } = useCollection(props);
+    const itemCells = useItemCells(size);
+    const headerCells = useHeaderCells(size);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkListView, { model: selection, factory: _jsx(GtkSignalListItemFactory, { ...itemCells.handlers }), ...(renderHeader != null && {
+                    headerFactory: _jsx(GtkSignalListItemFactory, { ...headerCells.handlers }),
+                }), ...rest }), _jsx(ItemPortals, { store: itemCells, render: renderItem, collection: collection, expandedIds: expandedIds }), renderHeader != null && (_jsx(HeaderPortals, { store: headerCells, render: renderHeader, collection: collection }))] }));
+}
+export { ListView };
 //# 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":";AACA,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,eAAe,GAAG;IACpB,OAAO;IACP,UAAU;IACV,YAAY;IACZ,cAAc;IACd,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,aAAa;IACb,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;CACoB,CAAC;AAE7C;;;GAGG;AACH,SAAS,QAAQ,CAA2B,KAA0B;IAClE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAC;IACjG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,kBAAkB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,IAAI,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEzC,OAAO,CACH,8BACI,KAAC,WAAW,IACR,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,KAAC,wBAAwB,OAAK,SAAS,CAAC,QAAQ,GAAI,KACzD,CAAC,YAAY,IAAI,IAAI,IAAI;oBACzB,aAAa,EAAE,KAAC,wBAAwB,OAAK,WAAW,CAAC,QAAQ,GAAI;iBACxE,CAAC,KACE,IAAI,GACV,EACF,KAAC,WAAW,IAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAI,EACtG,YAAY,IAAI,IAAI,IAAI,CACrB,KAAC,aAAa,IAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAI,CACtF,IACF,CACN,CAAC;AACN,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["import type { ReactNode } from \"react\";\nimport { GtkListView, GtkSignalListItemFactory } from \"@gtkx/jsx/gtk\";\nimport { omit } from \"@gtkx/utils\";\nimport type { ListViewProps } from \"./types.js\";\nimport { HeaderPortals, ItemPortals, useHeaderCells, useItemCells } from \"./internal/cells.js\";\nimport { useCollection } from \"./internal/use-collection.js\";\n\nconst LIST_VIEW_PROPS = [\n    \"items\",\n    \"sections\",\n    \"renderItem\",\n    \"renderHeader\",\n    \"selectedIds\",\n    \"onSelectionChanged\",\n    \"selectionMode\",\n    \"expandedIds\",\n    \"onExpandedChange\",\n    \"estimatedItemHeight\",\n    \"estimatedItemWidth\",\n] as const satisfies (keyof ListViewProps)[];\n\n/**\n * Renders a Gtk.ListView from declarative items or sections, with per-row rendering,\n * controlled selection, controlled tree expansion, and estimated item sizing.\n */\nfunction ListView<T = unknown, S = unknown>(props: ListViewProps<T, S>): ReactNode {\n    const { renderItem, renderHeader, expandedIds, estimatedItemHeight, estimatedItemWidth } = props;\n    const rest = omit(props, LIST_VIEW_PROPS);\n    const size = { width: estimatedItemWidth ?? -1, height: estimatedItemHeight ?? -1 };\n    const { collection, selection } = useCollection(props);\n    const itemCells = useItemCells(size);\n    const headerCells = useHeaderCells(size);\n\n    return (\n        <>\n            <GtkListView\n                model={selection}\n                factory={<GtkSignalListItemFactory {...itemCells.handlers} />}\n                {...(renderHeader != null && {\n                    headerFactory: <GtkSignalListItemFactory {...headerCells.handlers} />,\n                })}\n                {...rest}\n            />\n            <ItemPortals store={itemCells} render={renderItem} collection={collection} expandedIds={expandedIds} />\n            {renderHeader != null && (\n                <HeaderPortals store={headerCells} render={renderHeader} collection={collection} />\n            )}\n        </>\n    );\n}\n\nexport { ListView };\n"]}

package/dist/size-group.d.ts

@@ -0,0 +1,12 @@
+import type { ElementType, ReactNode } from "react";
+import type { SizeGroupChildProps, SizeGroupProps } from "./types.js";
+type SizeGroupComponent = ((props: SizeGroupProps) => ReactNode) & {
+    Child: <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;
+};
+/**
+ * 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.
+ */
+declare const SizeGroup: SizeGroupComponent;
+export { SizeGroup };
+//# 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":"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

@@ -0,0 +1,41 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { GtkSizeGroup } from "@gtkx/jsx/gtk";
+import { useMergedRef } from "@gtkx/react/internal";
+import { createContext, useCallback, useContext, useState } from "react";
+const SizeGroupContext = createContext(null);
+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 register;
+};
+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;
+        }
+        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

@@ -0,0 +1 @@
+{"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,198 +1,141 @@
-import type * as Gio from "@gtkx/gi/gio";
-import type * as GObject from "@gtkx/gi/gobject";
 import type * as Gtk from "@gtkx/gi/gtk";
-import type { ReactNode } from "react";
+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;
+} & ComponentPropsWithRef<C>;
+/** Props of a component whose backing widget defaults to one type but can be swapped through `component`. */
+type WidgetProps<C extends ElementType, Own = unknown, ExtraOmit extends string = never> = Own & {
+    component?: C;
+} & Omit<ComponentPropsWithRef<C>, ExtraOmit | keyof Own>;
 /**
- * A declarative item rendered by the {@link ListView}, {@link GridView},
- * {@link ColumnView}, and {@link DropDown} components.
- *
- * A non-section item carries an arbitrary value of type `T` and may declare
- * tree `children`. A section item carries a value of type `S` and groups a list
- * of child items underneath a header.
+ * A single item in a collection model, identified by a stable id and holding an
+ * arbitrary value. Nested items form a tree.
  */
-export type ListItem<T = unknown, S = unknown> = {
+type Item<T = unknown> = {
+    /** Stable identifier used to track the item across updates and selection. */
     id: string;
     value: T;
-    section?: false | undefined;
-    children?: ListItem<T, S>[] | 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. */
     indentForDepth?: boolean | undefined;
+    /** Reserves indentation space for an expander icon. */
     indentForIcon?: boolean | undefined;
-} | {
+};
+/** A group of items rendered under a shared section header. */
+type Section<S = unknown, T = unknown> = {
+    /** Stable identifier used to track the section across updates. */
     id: string;
     value: S;
-    section: true;
-    children: ListItem<T, S>[];
+    /** Items belonging to this section. */
+    data: Item<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. */
+    depth?: number | undefined;
+    /** Whether the item is currently expanded in a tree view. */
+    isExpanded?: boolean | undefined;
 };
-type ListViewSharedProps = {
+/** 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;
 };
-type ListViewControlledSelectionProps = {
-    selected?: string[] | null | undefined;
+type SelectionProps = {
+    selectedIds?: string[] | null | undefined;
     onSelectionChanged?: ((ids: string[]) => void) | null | undefined;
     selectionMode?: Gtk.SelectionMode | null | undefined;
 };
-type UncontrolledItemType<T> = [T] extends [GObject.Object] ? T : GObject.Object;
-/**
- * Props for the {@link ListView} component, replacing the raw `GtkListView`
- * factory/model surface with a declarative `items`/`renderItem` API, optional
- * controlled selection, section headers, and tree autoexpansion. Supplying an
- * external `model` switches to the uncontrolled form.
- */
-export type ListViewProps<T = unknown, S = unknown> = ListViewSharedProps & ((ListViewControlledSelectionProps & {
-    items?: ListItem<T, S>[] | undefined;
-    renderItem: (item: T, row?: Gtk.TreeListRow | null) => ReactNode;
-    autoexpand?: boolean | undefined;
-    renderHeader?: ((item: S) => ReactNode) | null | undefined;
-    model?: never;
-}) | {
-    model: Gio.ListModel;
-    renderItem: (item: UncontrolledItemType<T>) => ReactNode;
-    items?: never;
-    autoexpand?: never;
-    renderHeader?: never;
-    selected?: never;
-    onSelectionChanged?: never;
-    selectionMode?: never;
-});
-/**
- * Props for the {@link GridView} component, replacing the raw `GtkGridView`
- * factory/model surface with a declarative `items`/`renderItem` API and
- * optional controlled selection. Supplying an external `model` switches to the
- * uncontrolled form.
- */
-export type GridViewProps<T = unknown> = ListViewSharedProps & ((ListViewControlledSelectionProps & {
-    items?: ListItem<T>[] | undefined;
-    renderItem: (item: T) => ReactNode;
-    model?: never;
-}) | {
-    model: Gio.ListModel;
-    renderItem: (item: UncontrolledItemType<T>) => ReactNode;
-    items?: never;
-    selected?: never;
-    onSelectionChanged?: never;
-    selectionMode?: never;
-});
-type ColumnViewSortProps = {
-    sortColumn?: string | null | undefined;
-    sortOrder?: Gtk.SortType | null | undefined;
-    onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;
-    estimatedRowHeight?: number | null | undefined;
+type ExpansionProps = {
+    expandedIds?: string[] | null | undefined;
+    onExpandedChange?: ((ids: string[]) => void) | null | undefined;
 };
-/**
- * Props for the {@link ColumnView} component, replacing the raw `GtkColumnView`
- * surface with a declarative `items` model, optional controlled selection,
- * controlled sorting, and section headers. Columns are declared as
- * {@link ColumnViewColumn} children. Supplying an external `model` switches to
- * the uncontrolled form.
- */
-export type ColumnViewProps<T = unknown, S = unknown> = ColumnViewSortProps & ((ListViewControlledSelectionProps & {
-    items?: ListItem<T, S>[] | undefined;
-    renderHeader?: ((item: S) => ReactNode) | null | undefined;
-    model?: never;
-}) | {
-    model: Gio.ListModel;
-    items?: never;
-    renderHeader?: never;
-    selected?: never;
-    onSelectionChanged?: never;
-    selectionMode?: never;
-});
-/**
- * Props for a single {@link ColumnViewColumn} of a {@link ColumnView},
- * replacing the raw `GtkColumnViewColumn` factory/sorter surface with a
- * declarative `renderCell` callback and an optional header context menu.
- */
-export type ColumnViewColumnProps<T = unknown> = {
-    title: string;
-    expand?: boolean | undefined;
-    resizable?: boolean | undefined;
-    fixedWidth?: number | 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;
-    visible?: boolean | undefined;
-    renderCell: (item: T) => ReactNode;
     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 shared by the {@link DropDown} and {@link ComboRow} components,
- * replacing the raw factory/model surface with declarative `items`, controlled
- * `selectedId`, and per-slot renderers for the selected face, the popup list,
- * and section headers. Supplying an external `model` switches to the
- * uncontrolled form.
+ * 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.
  */
-export type DropDownProps<T = unknown, S = unknown> = {
-    items?: ListItem<T, S>[] | undefined;
+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?: ((item: T) => ReactNode) | null | undefined;
-    renderListItem?: ((item: T) => ReactNode) | null | undefined;
-    renderHeader?: ((item: S) => ReactNode) | null | undefined;
-    model?: never;
-} | {
-    model: Gio.ListModel;
-    renderItem?: ((item: UncontrolledItemType<T>) => ReactNode) | null | undefined;
-    renderListItem?: ((item: UncontrolledItemType<T>) => ReactNode) | null | undefined;
-    items?: never;
-    selectedId?: never;
-    onSelectionChanged?: never;
-    renderHeader?: never;
+    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;
 };
 /**
- * A single declarative entry in a {@link Menu} model. An entry is a plain item
- * (`label` plus `action`), a `submenu`, or a `section` of nested entries.
+ * 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.
  */
-export type MenuEntry = {
-    label?: string | undefined;
-    action?: string | undefined;
-    submenu?: MenuEntry[] | undefined;
-    section?: MenuEntry[] | undefined;
+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>;
 };
 /**
- * The declarative menu-model surface added by the {@link Menu} component on top
- * of the raw `GMenu` element.
+ * 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.
  */
-export type MenuItemsProps = {
-    items?: MenuEntry[] | null | undefined;
-};
-/**
- * Props for a `<ConstraintLayout.Constraint>` declaring a single relation
- * between a target attribute and a source attribute within a
- * {@link ConstraintLayout}.
- */
-export type ConstraintProps = {
-    target?: string;
-    targetAttribute: Gtk.ConstraintAttribute;
-    relation?: Gtk.ConstraintRelation;
-    source?: string;
-    sourceAttribute?: Gtk.ConstraintAttribute;
-    multiplier?: number;
-    constant?: number;
-    strength?: number;
-};
-/**
- * Props for a `<ConstraintLayout.Guide>` declaring an invisible layout guide
- * that other constraints can reference by `id` within a {@link ConstraintLayout}.
- */
-export type ConstraintGuideProps = {
-    id: string;
-    minWidth?: number;
-    minHeight?: number;
-    natWidth?: number;
-    natHeight?: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    strength?: Gtk.ConstraintStrength;
+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 a `<ConstraintLayout.Vfl>` declaring constraints through the GTK
- * Visual Format Language within a {@link ConstraintLayout}.
+ * 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.
  */
-export type ConstraintVflProps = {
-    lines: string[];
-    hspacing?: number;
-    vspacing?: number;
+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;
 };
-export {};
+/** 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":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EACR,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAEhF,sFAAsF;AACtF,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI;IACrC,SAAS,EAAE,CAAC,CAAC;CAChB,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;AAE7B,6GAA6G;AAC7G,KAAK,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,GAAG,OAAO,EAAE,SAAS,SAAS,MAAM,GAAG,KAAK,IAAI,GAAG,GAAG;IAC7F,SAAS,CAAC,EAAE,CAAC,CAAC;CACjB,GAAG,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,CAAC,CAAC;AAE1D;;;GAGG;AACH,KAAK,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI;IACrB,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IACjC,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,+DAA+D;AAC/D,KAAK,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACrC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,CAAC;IACT,uCAAuC;IACvC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;CACnB,CAAC;AAEF,2EAA2E;AAC3E,KAAK,cAAc,CAAC,CAAC,IAAI;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,sFAAsF;AACtF,KAAK,gBAAgB,CAAC,CAAC,IAAI;IACvB,OAAO,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,6DAA6D;AAC7D,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;AAC9D,uEAAuE;AACvE,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;AAElE,KAAK,aAAa,GAAG;IACjB,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE,aAAa,CAAC,EAAE,GAAG,CAAC,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACnE,CAAC;AAEF,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI;IACrB,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,mGAAmG;AACnG,KAAK,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG;IAC/F,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,cAAc,GAC1C,cAAc,GACd,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACjB,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7F,CAAC;AAEN;;;;;GAKG;AACH,KAAK,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CACjD,kBAAkB,EAClB,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CACzE,GACD,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzB,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAC9C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/D,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,0FAA0F;IAC1F,cAAc,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACpD,sDAAsD;IACtD,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,KAAK,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,WAAW,GAAG,OAAO,WAAW,IAAI,WAAW,CAClG,CAAC,EACD,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,CACxD,CAAC;AAEF,KAAK,gBAAgB,CAAC,CAAC,IAAI,aAAa,GACpC,cAAc,GAAG;IACb,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9B,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEN;;;;GAIG;AACH,KAAK,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC,GACrG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAExB,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,IAAI,aAAa,GACvC,cAAc,GACd,cAAc,GACd,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAChB,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,CAAC;AAEN;;;;;GAKG;AACH,KAAK,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CAC/C,gBAAgB,EAChB,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CACvE,GACD,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvB,mCAAmC;AACnC,KAAK,cAAc,GAAG;IAClB,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,KAAK,mBAAmB,CAAC,CAAC,SAAS,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAEhE,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,CAAC"}

package/dist/types.js.map

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