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

package/dist/internal/collection.js

@@ -0,0 +1,64 @@
+import { getId } from "./collection-model.js";
+const ascending = (a, b) => a - b;
+function visitRow(tree, position, visit) {
+    const row = tree.getRow(position);
+    if (row === null) {
+        return;
+    }
+    visit(row, getId(row.getItem()));
+}
+function eachRow(tree, visit) {
+    for (let position = 0; position < tree.getNItems(); position++) {
+        visitRow(tree, position, visit);
+    }
+}
+function collectWanted(item, position, wanted, out) {
+    const id = getId(item);
+    if (id !== null && wanted.has(id)) {
+        out.push(position);
+    }
+}
+function scanPositions(tree, ids) {
+    const wanted = new Set(ids);
+    const positions = [];
+    const count = tree.getNItems();
+    for (let position = 0; position < count; position++) {
+        collectWanted(tree.getItem(position), position, wanted, positions);
+    }
+    return positions;
+}
+function indexPositions(index, ids) {
+    const positions = [];
+    for (const id of ids) {
+        const position = index.positionFor(id);
+        if (position >= 0) {
+            positions.push(position);
+        }
+    }
+    return positions.toSorted(ascending);
+}
+function positionsFor(gtk, index, ids) {
+    if (!index.isTree) {
+        return indexPositions(index, ids);
+    }
+    const tree = gtk.treeModel();
+    return tree === null ? [] : scanPositions(tree, ids);
+}
+function positionFor(gtk, index, id) {
+    const [first = -1] = positionsFor(gtk, index, [id]);
+    return first;
+}
+function createCollection(gtk, index) {
+    return {
+        isTree: index.isTree,
+        model: gtk.model,
+        treeModel: () => (index.isTree ? gtk.treeModel() : null),
+        itemFor: index.itemFor,
+        sectionFor: index.sectionFor,
+        idAt: (position) => getId(gtk.model.getItem(position)),
+        positionFor: (id) => positionFor(gtk, index, id),
+        positionsFor: (ids) => positionsFor(gtk, index, ids),
+    };
+}
+export { createCollection, eachRow };
+//# sourceMappingURL=collection.js.map

package/dist/internal/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/internal/collection.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { Item } from \"../types.js\";\nimport type { CollectionIndex } from \"./collection-index.js\";\nimport type { CollectionModel } from \"./collection-model.js\";\nimport { getId } from \"./collection-model.js\";\n\ntype Collection = {\n    isTree: boolean;\n    model: Gtk.FlattenListModel;\n    treeModel: () => Gtk.TreeListModel | null;\n    itemFor: (id: string) => Item | undefined;\n    sectionFor: (id: string) => unknown;\n    idAt: (position: number) => string | null;\n    positionFor: (id: string) => number;\n    positionsFor: (ids: string[]) => number[];\n};\n\nconst ascending = (a: number, b: number): number => a - b;\n\nfunction visitRow(\n    tree: Gtk.TreeListModel,\n    position: number,\n    visit: (row: Gtk.TreeListRow, id: string | null) => void,\n): void {\n    const row = tree.getRow(position);\n\n    if (row === null) {\n        return;\n    }\n\n    visit(row, getId(row.getItem()));\n}\n\nfunction eachRow(tree: Gtk.TreeListModel, visit: (row: Gtk.TreeListRow, id: string | null) => void): void {\n    for (let position = 0; position < tree.getNItems(); position++) {\n        visitRow(tree, position, visit);\n    }\n}\n\nfunction collectWanted(item: GObject.Object | null, position: number, wanted: Set<string>, out: number[]): void {\n    const id = getId(item);\n\n    if (id !== null && wanted.has(id)) {\n        out.push(position);\n    }\n}\n\nfunction scanPositions(tree: Gtk.TreeListModel, ids: string[]): number[] {\n    const wanted = new Set(ids);\n    const positions: number[] = [];\n    const count = tree.getNItems();\n\n    for (let position = 0; position < count; position++) {\n        collectWanted(tree.getItem(position), position, wanted, positions);\n    }\n\n    return positions;\n}\n\nfunction indexPositions(index: CollectionIndex, ids: string[]): number[] {\n    const positions: number[] = [];\n\n    for (const id of ids) {\n        const position = index.positionFor(id);\n\n        if (position >= 0) {\n            positions.push(position);\n        }\n    }\n\n    return positions.toSorted(ascending);\n}\n\nfunction positionsFor(gtk: CollectionModel, index: CollectionIndex, ids: string[]): number[] {\n    if (!index.isTree) {\n        return indexPositions(index, ids);\n    }\n\n    const tree = gtk.treeModel();\n\n    return tree === null ? [] : scanPositions(tree, ids);\n}\n\nfunction positionFor(gtk: CollectionModel, index: CollectionIndex, id: string): number {\n    const [first = -1] = positionsFor(gtk, index, [id]);\n\n    return first;\n}\n\nfunction createCollection(gtk: CollectionModel, index: CollectionIndex): Collection {\n    return {\n        isTree: index.isTree,\n        model: gtk.model,\n        treeModel: () => (index.isTree ? gtk.treeModel() : null),\n        itemFor: index.itemFor,\n        sectionFor: index.sectionFor,\n        idAt: (position) => getId(gtk.model.getItem(position)),\n        positionFor: (id) => positionFor(gtk, index, id),\n        positionsFor: (ids) => positionsFor(gtk, index, ids),\n    };\n}\n\nexport { createCollection, eachRow, type Collection };\n"]}

package/dist/internal/expansion.d.ts

@@ -0,0 +1,9 @@
+import type { Collection } from "./collection.js";
+type ExpansionOptions = {
+    collection: Collection;
+    expandedIds?: string[] | null | undefined;
+    onExpandedChange?: ((ids: string[]) => void) | null | undefined;
+};
+declare function useExpansion(options: ExpansionOptions): void;
+export { useExpansion, type ExpansionOptions };
+//# sourceMappingURL=expansion.d.ts.map

package/dist/internal/expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expansion.d.ts","sourceRoot":"","sources":["../../src/internal/expansion.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,KAAK,gBAAgB,GAAG;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,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;AA6FF,iBAAS,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAgBrD;AAED,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/internal/expansion.js

@@ -0,0 +1,75 @@
+import { useSignal } from "@gtkx/react";
+import { useEffectEvent, useLayoutEffect, useRef, useState } from "react";
+import { eachRow } from "./collection.js";
+function newLastExpansion() {
+    return { key: "" };
+}
+function collectExpanded(row, id, ids) {
+    if (id !== null && row.getExpanded()) {
+        ids.push(id);
+    }
+}
+function expandRow(row, id, wanted) {
+    const isDesired = id !== null && wanted.has(id);
+    if (row.isExpandable() && row.getExpanded() !== isDesired) {
+        row.setExpanded(isDesired);
+    }
+}
+function applyExpansion(tree, expandedIds) {
+    const wanted = new Set(expandedIds);
+    eachRow(tree, (row, id) => {
+        expandRow(row, id, wanted);
+    });
+}
+function reportExpansion(collection, last, onExpandedChange) {
+    const tree = collection.treeModel();
+    if (tree === null) {
+        return;
+    }
+    const ids = [];
+    eachRow(tree, (row, id) => {
+        collectExpanded(row, id, ids);
+    });
+    const key = ids.join(" ");
+    if (last.key === key) {
+        return;
+    }
+    last.key = key;
+    onExpandedChange?.(ids);
+}
+function reportWhenIdle(collection, last, expanding, onExpandedChange) {
+    if (expanding.current) {
+        return;
+    }
+    reportExpansion(collection, last, onExpandedChange);
+}
+function runControlledExpansion(collection, expandedIds, expanding, report) {
+    const tree = collection.treeModel();
+    if (tree === null || expandedIds == null) {
+        return;
+    }
+    expanding.current = true;
+    try {
+        applyExpansion(tree, expandedIds);
+    }
+    finally {
+        expanding.current = false;
+    }
+    report();
+}
+function useExpansion(options) {
+    const { collection, expandedIds, onExpandedChange } = options;
+    const [last] = useState(newLastExpansion);
+    const expanding = useRef(false);
+    const report = useEffectEvent(() => {
+        reportWhenIdle(collection, last, expanding, onExpandedChange);
+    });
+    useSignal(collection.isTree ? collection.model : null, "items-changed", () => {
+        reportWhenIdle(collection, last, expanding, onExpandedChange);
+    });
+    useLayoutEffect(() => {
+        runControlledExpansion(collection, expandedIds, expanding, report);
+    }, [collection, expandedIds]);
+}
+export { useExpansion };
+//# sourceMappingURL=expansion.js.map

package/dist/internal/expansion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expansion.js","sourceRoot":"","sources":["../../src/internal/expansion.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { RefObject } from \"react\";\nimport { useSignal } from \"@gtkx/react\";\nimport { useEffectEvent, useLayoutEffect, useRef, useState } from \"react\";\nimport type { Collection } from \"./collection.js\";\nimport { eachRow } from \"./collection.js\";\n\ntype ExpansionOptions = {\n    collection: Collection;\n    expandedIds?: string[] | null | undefined;\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n};\n\ntype LastExpansion = { key: string };\n\nfunction newLastExpansion(): LastExpansion {\n    return { key: \"\" };\n}\n\nfunction collectExpanded(row: Gtk.TreeListRow, id: string | null, ids: string[]): void {\n    if (id !== null && row.getExpanded()) {\n        ids.push(id);\n    }\n}\n\nfunction expandRow(row: Gtk.TreeListRow, id: string | null, wanted: Set<string>): void {\n    const isDesired = id !== null && wanted.has(id);\n\n    if (row.isExpandable() && row.getExpanded() !== isDesired) {\n        row.setExpanded(isDesired);\n    }\n}\n\nfunction applyExpansion(tree: Gtk.TreeListModel, expandedIds: string[]): void {\n    const wanted = new Set(expandedIds);\n\n    eachRow(tree, (row, id) => {\n        expandRow(row, id, wanted);\n    });\n}\n\nfunction reportExpansion(\n    collection: Collection,\n    last: LastExpansion,\n    onExpandedChange: ((ids: string[]) => void) | null | undefined,\n): void {\n    const tree = collection.treeModel();\n\n    if (tree === null) {\n        return;\n    }\n\n    const ids: string[] = [];\n\n    eachRow(tree, (row, id) => {\n        collectExpanded(row, id, ids);\n    });\n\n    const key = ids.join(\" \");\n\n    if (last.key === key) {\n        return;\n    }\n\n    last.key = key;\n    onExpandedChange?.(ids);\n}\n\nfunction reportWhenIdle(\n    collection: Collection,\n    last: LastExpansion,\n    expanding: RefObject<boolean>,\n    onExpandedChange: ((ids: string[]) => void) | null | undefined,\n): void {\n    if (expanding.current) {\n        return;\n    }\n\n    reportExpansion(collection, last, onExpandedChange);\n}\n\nfunction runControlledExpansion(\n    collection: Collection,\n    expandedIds: string[] | null | undefined,\n    expanding: RefObject<boolean>,\n    report: () => void,\n): void {\n    const tree = collection.treeModel();\n\n    if (tree === null || expandedIds == null) {\n        return;\n    }\n\n    expanding.current = true;\n\n    try {\n        applyExpansion(tree, expandedIds);\n    } finally {\n        expanding.current = false;\n    }\n\n    report();\n}\n\nfunction useExpansion(options: ExpansionOptions): void {\n    const { collection, expandedIds, onExpandedChange } = options;\n    const [last] = useState<LastExpansion>(newLastExpansion);\n    const expanding = useRef(false);\n\n    const report = useEffectEvent((): void => {\n        reportWhenIdle(collection, last, expanding, onExpandedChange);\n    });\n\n    useSignal(collection.isTree ? collection.model : null, \"items-changed\", () => {\n        reportWhenIdle(collection, last, expanding, onExpandedChange);\n    });\n\n    useLayoutEffect(() => {\n        runControlledExpansion(collection, expandedIds, expanding, report);\n    }, [collection, expandedIds]);\n}\n\nexport { useExpansion, type ExpansionOptions };\n"]}

package/dist/internal/selection.d.ts

@@ -0,0 +1,12 @@
+import type { ReactElement } from "react";
+import * as Gtk from "@gtkx/gi/gtk";
+import type { Collection } from "./collection.js";
+type SelectionOptions = {
+    collection: Collection;
+    selectedIds?: string[] | null | undefined;
+    onSelectionChanged?: ((ids: string[]) => void) | null | undefined;
+    selectionMode?: Gtk.SelectionMode | null | undefined;
+};
+declare function useSelection(options: SelectionOptions): ReactElement;
+export { useSelection, type SelectionOptions };
+//# sourceMappingURL=selection.d.ts.map

package/dist/internal/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/internal/selection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,gBAAgB,GAAG;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,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;AA2HF,iBAAS,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAqB7D;AAED,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/internal/selection.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkMultiSelection, GtkNoSelection, GtkSingleSelection } from "@gtkx/jsx/gtk";
+import { useEffectEvent, useLayoutEffect, useState } from "react";
+function getSelectedIds(selection, collection) {
+    const bitset = selection.getSelection();
+    const size = Number(bitset.getSize());
+    const ids = [];
+    for (let index = 0; index < size; index++) {
+        pushId(collection.idAt(bitset.getNth(index)), ids);
+    }
+    return ids;
+}
+function pushId(id, ids) {
+    if (id !== null) {
+        ids.push(id);
+    }
+}
+function applySingleSelection(selection, positions) {
+    const [first] = positions;
+    if (first === undefined) {
+        selection.unselectAll();
+        return;
+    }
+    selection.selectItem(first, true);
+}
+function applyMultiSelection(selection, positions) {
+    const selected = Gtk.Bitset.newEmpty();
+    for (const position of positions) {
+        selected.add(position);
+    }
+    selection.setSelection(selected, Gtk.Bitset.newRange(0, selection.getNItems()));
+}
+function applySelection(selection, collection, ids) {
+    if (selection instanceof Gtk.NoSelection) {
+        return;
+    }
+    const positions = collection.positionsFor(ids);
+    if (ids.length > 0 && positions.length === 0) {
+        return;
+    }
+    if (selection instanceof Gtk.SingleSelection) {
+        applySingleSelection(selection, positions);
+        return;
+    }
+    applyMultiSelection(selection, positions);
+}
+function reportSelection(selection, collection, last, onSelectionChanged) {
+    if (selection === null) {
+        return;
+    }
+    const ids = getSelectedIds(selection, collection);
+    const key = ids.join(" ");
+    if (last.selection === selection && last.key === key) {
+        return;
+    }
+    last.selection = selection;
+    last.key = key;
+    onSelectionChanged?.(ids);
+}
+function selectionElement(mode, props) {
+    if (mode === Gtk.SelectionMode.MULTIPLE) {
+        return _jsx(GtkMultiSelection, { ...props });
+    }
+    if (mode === Gtk.SelectionMode.NONE) {
+        return _jsx(GtkNoSelection, { ...props });
+    }
+    return _jsx(GtkSingleSelection, { ...props, autoselect: false, canUnselect: true });
+}
+function syncSelection(selection, collection, selectedIds) {
+    if (selection === null || selectedIds == null) {
+        return;
+    }
+    applySelection(selection, collection, selectedIds);
+}
+function newLastSelection() {
+    return { selection: null, key: null };
+}
+function useSelection(options) {
+    const { collection, selectedIds, onSelectionChanged, selectionMode } = options;
+    const [selection, setSelection] = useState(null);
+    const [last] = useState(newLastSelection);
+    const report = useEffectEvent(() => {
+        reportSelection(selection, collection, last, onSelectionChanged);
+    });
+    useLayoutEffect(() => {
+        syncSelection(selection, collection, selectedIds);
+        report();
+    }, [selection, collection, selectedIds]);
+    return selectionElement(selectionMode, {
+        ref: setSelection,
+        model: collection.model,
+        onSelectionChanged: () => {
+            reportSelection(selection, collection, last, onSelectionChanged);
+        },
+    });
+}
+export { useSelection };
+//# sourceMappingURL=selection.js.map

package/dist/internal/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/internal/selection.tsx"],"names":[],"mappings":"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","sourcesContent":["import type * as Gio from \"@gtkx/gi/gio\";\nimport type { ReactElement } from \"react\";\nimport * as Gtk from \"@gtkx/gi/gtk\";\nimport { GtkMultiSelection, GtkNoSelection, GtkSingleSelection } from \"@gtkx/jsx/gtk\";\nimport { useEffectEvent, useLayoutEffect, useState } from \"react\";\nimport type { Collection } from \"./collection.js\";\n\ntype SelectionOptions = {\n    collection: Collection;\n    selectedIds?: string[] | null | undefined;\n    onSelectionChanged?: ((ids: string[]) => void) | null | undefined;\n    selectionMode?: Gtk.SelectionMode | null | undefined;\n};\n\ntype LastSelection = {\n    selection: Gtk.SelectionModel | null;\n    key: string | null;\n};\n\ntype SelectionElementProps = {\n    ref: (value: Gtk.SelectionModel | null) => void;\n    model: Gio.ListModel;\n    onSelectionChanged: () => void;\n};\n\nfunction getSelectedIds(selection: Gtk.SelectionModel, collection: Collection): string[] {\n    const bitset = selection.getSelection();\n    const size = Number(bitset.getSize());\n    const ids: string[] = [];\n\n    for (let index = 0; index < size; index++) {\n        pushId(collection.idAt(bitset.getNth(index)), ids);\n    }\n\n    return ids;\n}\n\nfunction pushId(id: string | null, ids: string[]): void {\n    if (id !== null) {\n        ids.push(id);\n    }\n}\n\nfunction applySingleSelection(selection: Gtk.SingleSelection, positions: number[]): void {\n    const [first] = positions;\n\n    if (first === undefined) {\n        selection.unselectAll();\n\n        return;\n    }\n\n    selection.selectItem(first, true);\n}\n\nfunction applyMultiSelection(selection: Gtk.SelectionModel, positions: number[]): void {\n    const selected = Gtk.Bitset.newEmpty();\n\n    for (const position of positions) {\n        selected.add(position);\n    }\n\n    selection.setSelection(selected, Gtk.Bitset.newRange(0, selection.getNItems()));\n}\n\nfunction applySelection(selection: Gtk.SelectionModel, collection: Collection, ids: string[]): void {\n    if (selection instanceof Gtk.NoSelection) {\n        return;\n    }\n\n    const positions = collection.positionsFor(ids);\n\n    if (ids.length > 0 && positions.length === 0) {\n        return;\n    }\n\n    if (selection instanceof Gtk.SingleSelection) {\n        applySingleSelection(selection, positions);\n\n        return;\n    }\n\n    applyMultiSelection(selection, positions);\n}\n\nfunction reportSelection(\n    selection: Gtk.SelectionModel | null,\n    collection: Collection,\n    last: LastSelection,\n    onSelectionChanged: ((ids: string[]) => void) | null | undefined,\n): void {\n    if (selection === null) {\n        return;\n    }\n\n    const ids = getSelectedIds(selection, collection);\n    const key = ids.join(\" \");\n\n    if (last.selection === selection && last.key === key) {\n        return;\n    }\n\n    last.selection = selection;\n    last.key = key;\n    onSelectionChanged?.(ids);\n}\n\nfunction selectionElement(mode: Gtk.SelectionMode | null | undefined, props: SelectionElementProps): ReactElement {\n    if (mode === Gtk.SelectionMode.MULTIPLE) {\n        return <GtkMultiSelection {...props} />;\n    }\n\n    if (mode === Gtk.SelectionMode.NONE) {\n        return <GtkNoSelection {...props} />;\n    }\n\n    return <GtkSingleSelection {...props} autoselect={false} canUnselect />;\n}\n\nfunction syncSelection(\n    selection: Gtk.SelectionModel | null,\n    collection: Collection,\n    selectedIds: string[] | null | undefined,\n): void {\n    if (selection === null || selectedIds == null) {\n        return;\n    }\n\n    applySelection(selection, collection, selectedIds);\n}\n\nfunction newLastSelection(): LastSelection {\n    return { selection: null, key: null };\n}\n\nfunction useSelection(options: SelectionOptions): ReactElement {\n    const { collection, selectedIds, onSelectionChanged, selectionMode } = options;\n    const [selection, setSelection] = useState<Gtk.SelectionModel | null>(null);\n    const [last] = useState<LastSelection>(newLastSelection);\n\n    const report = useEffectEvent((): void => {\n        reportSelection(selection, collection, last, onSelectionChanged);\n    });\n\n    useLayoutEffect(() => {\n        syncSelection(selection, collection, selectedIds);\n        report();\n    }, [selection, collection, selectedIds]);\n\n    return selectionElement(selectionMode, {\n        ref: setSelection,\n        model: collection.model,\n        onSelectionChanged: () => {\n            reportSelection(selection, collection, last, onSelectionChanged);\n        },\n    });\n}\n\nexport { useSelection, type SelectionOptions };\n"]}

package/dist/internal/use-collection.d.ts

@@ -0,0 +1,18 @@
+import type { ReactElement, RefObject } from "react";
+import type { ExpansionProps, Item, Section, SelectionProps } from "../types.js";
+import type { Collection } from "./collection.js";
+type CollectionDataOptions = {
+    items?: Item[] | undefined;
+    sections?: Section[] | undefined;
+    flat?: boolean | undefined;
+    applying?: RefObject<boolean> | undefined;
+};
+type CollectionOptions = CollectionDataOptions & SelectionProps & ExpansionProps;
+type CollectionResult = {
+    collection: Collection;
+    selection: ReactElement;
+};
+declare function useCollectionData(options: CollectionDataOptions): Collection;
+declare function useCollection(options: CollectionOptions): CollectionResult;
+export { useCollection, useCollectionData, type CollectionDataOptions, type CollectionOptions };
+//# sourceMappingURL=use-collection.d.ts.map

package/dist/internal/use-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection.d.ts","sourceRoot":"","sources":["../../src/internal/use-collection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,KAAK,qBAAqB,GAAG;IACzB,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,KAAK,iBAAiB,GAAG,qBAAqB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEjF,KAAK,gBAAgB,GAAG;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,YAAY,CAAC;CAC3B,CAAC;AAkBF,iBAAS,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAWrE;AAED,iBAAS,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAYnE;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/internal/use-collection.js

@@ -0,0 +1,42 @@
+import { useLayoutEffect, useMemo, useState } from "react";
+import { createCollectionIndex } from "./collection-index.js";
+import { createCollectionModel } from "./collection-model.js";
+import { createCollection } from "./collection.js";
+import { useExpansion } from "./expansion.js";
+import { useSelection } from "./selection.js";
+function runSync(gtk, index, applying) {
+    if (applying === undefined) {
+        gtk.sync(index);
+        return;
+    }
+    applying.current = true;
+    try {
+        gtk.sync(index);
+    }
+    finally {
+        applying.current = false;
+    }
+}
+function useCollectionData(options) {
+    const { items, sections, flat, applying } = options;
+    const [gtk] = useState(createCollectionModel);
+    const index = useMemo(() => createCollectionIndex(items, sections, flat === true), [items, sections, flat]);
+    const collection = useMemo(() => createCollection(gtk, index), [gtk, index]);
+    useLayoutEffect(() => {
+        runSync(gtk, index, applying);
+    }, [gtk, index, applying]);
+    return collection;
+}
+function useCollection(options) {
+    const collection = useCollectionData(options);
+    useExpansion({ collection, expandedIds: options.expandedIds, onExpandedChange: options.onExpandedChange });
+    const selection = useSelection({
+        collection,
+        selectedIds: options.selectedIds,
+        onSelectionChanged: options.onSelectionChanged,
+        selectionMode: options.selectionMode,
+    });
+    return { collection, selection };
+}
+export { useCollection, useCollectionData };
+//# sourceMappingURL=use-collection.js.map

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,24 +1,9 @@
-import { type GtkListViewProps } from "@gtkx/jsx/gtk";
 import type { ReactNode } from "react";
-import type { CollectionItemSizeProps, ControlledExpansionProps, ControlledSelectionProps, ItemNode, RenderItemProps, SectionNode } from "./types.js";
-export type ListViewDeclarativeProps<T = unknown, S = unknown> = CollectionItemSizeProps & ControlledSelectionProps & ControlledExpansionProps & {
-    items?: ItemNode<T>[] | undefined;
-    sections?: SectionNode<S, T>[] | undefined;
-    renderItem: (props: RenderItemProps<T>) => ReactNode;
-    renderHeader?: ((info: {
-        section: S;
-    }) => ReactNode) | null | undefined;
-};
+import type { ListViewProps } from "./types.js";
 /**
- * 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.
+ * Renders a Gtk.ListView from declarative items or sections, with per-row rendering,
+ * controlled selection, controlled tree expansion, and estimated item sizing.
  */
-export type ListViewProps<T = unknown, S = unknown> = Omit<GtkListViewProps, "model" | "factory" | "headerFactory" | keyof ListViewDeclarativeProps<T, S>> & ListViewDeclarativeProps<T, S>;
-/**
- * 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 declare const ListView: <T = unknown, S = unknown>(props: ListViewProps<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":"AACA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAO,MAAM,OAAO,CAAC;AAW5C,OAAO,KAAK,EACR,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,QAAQ,EACR,eAAe,EACf,WAAW,EACd,MAAM,YAAY,CAAC;AAUpB,MAAM,MAAM,wBAAwB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,uBAAuB,GACpF,wBAAwB,GACxB,wBAAwB,GAAG;IACvB,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACrD,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,KAAK,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC3E,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CACtD,gBAAgB,EAChB,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,MAAM,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAC/E,GACG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAgDnC;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,SA8C/E,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,56 +1,35 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { GtkListView } from "@gtkx/jsx/gtk";
-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,
-    };
-};
+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",
+];
 /**
- * Renders a Gtk.ListView: a scrollable, single-column list backed by a collection
- * model, with each row drawn by renderItem and optional section headers.
+ * 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, 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 })] }));
-};
+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":"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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"]}
+{"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

@@ -1,20 +1,12 @@
-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;
+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;
 };
-/** 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}.
+ * 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.
  */
-export declare const SizeGroup: ((props: SizeGroupProps) => ReactNode) & {
-    Child: <C extends ElementType>(props: SizeGroupChildProps<C>) => ReactNode;
-};
+declare const SizeGroup: SizeGroupComponent;
+export { SizeGroup };
 //# sourceMappingURL=size-group.d.ts.map