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

package/dist/internal/selection.js

@@ -93,6 +93,7 @@ function useSelection(options) {
         onSelectionChanged: () => {
             reportSelection(selection, collection, last, onSelectionChanged);
         },
+        onItemsChanged: options.onItemsChanged,
     });
 }
 export { useSelection };

package/dist/internal/selection.js.map

@@ -1 +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"]}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/internal/selection.tsx"],"names":[],"mappings":";AAEA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAuBlE,SAAS,cAAc,CAAC,SAA6B,EAAE,UAAsB;IACzE,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,EAAiB,EAAE,GAAa;IAC5C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,SAA8B,EAAE,SAAmB;IAC7E,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,SAAS,CAAC,WAAW,EAAE,CAAC;QAExB,OAAO;IACX,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,mBAAmB,CAAC,SAA6B,EAAE,SAAmB;IAC3E,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEvC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,cAAc,CAAC,SAA6B,EAAE,UAAsB,EAAE,GAAa;IACxF,IAAI,SAAS,YAAY,GAAG,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO;IACX,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAE/C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO;IACX,CAAC;IAED,IAAI,SAAS,YAAY,GAAG,CAAC,eAAe,EAAE,CAAC;QAC3C,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE3C,OAAO;IACX,CAAC;IAED,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,eAAe,CACpB,SAAoC,EACpC,UAAsB,EACtB,IAAmB,EACnB,kBAAgE;IAEhE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO;IACX,CAAC;IAED,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACnD,OAAO;IACX,CAAC;IAED,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACf,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA0C,EAAE,KAA4B;IAC9F,IAAI,IAAI,KAAK,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAC,iBAAiB,OAAK,KAAK,GAAI,CAAC;IAC5C,CAAC;IAED,IAAI,IAAI,KAAK,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAClC,OAAO,KAAC,cAAc,OAAK,KAAK,GAAI,CAAC;IACzC,CAAC;IAED,OAAO,KAAC,kBAAkB,OAAK,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,SAAG,CAAC;AAC5E,CAAC;AAED,SAAS,aAAa,CAClB,SAAoC,EACpC,UAAsB,EACtB,WAAwC;IAExC,IAAI,SAAS,KAAK,IAAI,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QAC5C,OAAO;IACX,CAAC;IAED,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB;IACrB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,OAAyB;IAC3C,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAC/E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAA4B,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAgB,gBAAgB,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAS,EAAE;QACrC,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,eAAe,CAAC,GAAG,EAAE;QACjB,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC;IACb,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzC,OAAO,gBAAgB,CAAC,aAAa,EAAE;QACnC,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,kBAAkB,EAAE,GAAG,EAAE;YACrB,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACrE,CAAC;QACD,cAAc,EAAE,OAAO,CAAC,cAAc;KACzC,CAAC,CAAC;AACP,CAAC;AAED,OAAO,EAAE,YAAY,EAAyB,CAAC","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    onItemsChanged: () => void;\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    onItemsChanged: () => 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        onItemsChanged: options.onItemsChanged,\n    });\n}\n\nexport { useSelection, type SelectionOptions };\n"]}

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

@@ -1,11 +1,10 @@
-import type { ReactElement, RefObject } from "react";
-import type { ExpansionProps, Item, Section, SelectionProps } from "../types.js";
+import type { ReactElement } from "react";
+import type { ExpansionProps, ListItem, ListSection, 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;
+    items?: ListItem[] | undefined;
+    sections?: ListSection[] | undefined;
+    isFlat?: boolean | undefined;
 };
 type CollectionOptions = CollectionDataOptions & SelectionProps & ExpansionProps;
 type CollectionResult = {

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

@@ -1 +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"}
+{"version":3,"file":"use-collection.d.ts","sourceRoot":"","sources":["../../src/internal/use-collection.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD,KAAK,qBAAqB,GAAG;IACzB,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC,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;AAEF,iBAAS,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAWrE;AAED,iBAAS,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAkBnE;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,CAAC"}

package/dist/internal/use-collection.js

@@ -4,37 +4,29 @@ 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 { items, sections, isFlat } = options;
     const [gtk] = useState(createCollectionModel);
-    const index = useMemo(() => createCollectionIndex(items, sections, flat === true), [items, sections, flat]);
+    const index = useMemo(() => createCollectionIndex(items, sections, isFlat === true), [items, sections, isFlat]);
     const collection = useMemo(() => createCollection(gtk, index), [gtk, index]);
     useLayoutEffect(() => {
-        runSync(gtk, index, applying);
-    }, [gtk, index, applying]);
+        gtk.sync(index);
+    }, [gtk, index]);
     return collection;
 }
 function useCollection(options) {
     const collection = useCollectionData(options);
-    useExpansion({ collection, expandedIds: options.expandedIds, onExpandedChange: options.onExpandedChange });
+    const onItemsChanged = useExpansion({
+        collection,
+        expandedIds: options.expandedIds,
+        onExpandedChange: options.onExpandedChange,
+    });
     const selection = useSelection({
         collection,
         selectedIds: options.selectedIds,
         onSelectionChanged: options.onSelectionChanged,
         selectionMode: options.selectionMode,
+        onItemsChanged,
     });
     return { collection, selection };
 }

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

@@ -1 +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"]}
+{"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;AAG3D,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;AAe9C,SAAS,iBAAiB,CAAC,OAA8B;IACrD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC5C,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,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAChH,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,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IAEjB,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,OAA0B;IAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,cAAc,GAAG,YAAY,CAAC;QAChC,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC7C,CAAC,CAAC;IAEH,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;QACpC,cAAc;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAsD,CAAC","sourcesContent":["import type { ReactElement } from \"react\";\nimport { useLayoutEffect, useMemo, useState } from \"react\";\nimport type { ExpansionProps, ListItem, ListSection, SelectionProps } from \"../types.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?: ListItem[] | undefined;\n    sections?: ListSection[] | undefined;\n    isFlat?: boolean | undefined;\n};\n\ntype CollectionOptions = CollectionDataOptions & SelectionProps & ExpansionProps;\n\ntype CollectionResult = {\n    collection: Collection;\n    selection: ReactElement;\n};\n\nfunction useCollectionData(options: CollectionDataOptions): Collection {\n    const { items, sections, isFlat } = options;\n    const [gtk] = useState(createCollectionModel);\n    const index = useMemo(() => createCollectionIndex(items, sections, isFlat === true), [items, sections, isFlat]);\n    const collection = useMemo(() => createCollection(gtk, index), [gtk, index]);\n\n    useLayoutEffect(() => {\n        gtk.sync(index);\n    }, [gtk, index]);\n\n    return collection;\n}\n\nfunction useCollection(options: CollectionOptions): CollectionResult {\n    const collection = useCollectionData(options);\n\n    const onItemsChanged = useExpansion({\n        collection,\n        expandedIds: options.expandedIds,\n        onExpandedChange: options.onExpandedChange,\n    });\n\n    const selection = useSelection({\n        collection,\n        selectedIds: options.selectedIds,\n        onSelectionChanged: options.onSelectionChanged,\n        selectionMode: options.selectionMode,\n        onItemsChanged,\n    });\n\n    return { collection, selection };\n}\n\nexport { useCollection, useCollectionData, type CollectionDataOptions, type CollectionOptions };\n"]}

package/dist/types.d.ts

@@ -1,23 +1,17 @@
 import type * as Gtk from "@gtkx/gi/gtk";
-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>;
+import type { GtkColumnViewColumnProps, GtkColumnViewProps, GtkDropDownProps, GtkGridViewProps, GtkListViewProps } from "@gtkx/jsx/gtk";
+import type { ReactNode } from "react";
 /**
  * A single item in a collection model, identified by a stable id and holding an
  * arbitrary value. Nested items form a tree.
  */
-type Item<T = unknown> = {
+type ListItem<T = unknown> = {
     /** Stable identifier used to track the item across updates and selection. */
     id: string;
+    /** Payload handed to the cell renderer as `ListItemRenderArgs.item`. */
     value: T;
-    children?: Item<T>[] | undefined;
+    /** Child items nested under this one, which turn a plain item list into a tree. */
+    children?: ListItem<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. */
@@ -26,63 +20,88 @@ type Item<T = unknown> = {
     indentForIcon?: boolean | undefined;
 };
 /** A group of items rendered under a shared section header. */
-type Section<S = unknown, T = unknown> = {
+type ListSection<S = unknown, T = unknown> = {
     /** Stable identifier used to track the section across updates. */
     id: string;
+    /** Payload handed to the section header renderer as `ListSectionRenderArgs.section`. */
     value: S;
     /** Items belonging to this section. */
-    data: Item<T>[];
+    data: ListItem<T>[];
 };
-/** Arguments passed to an {@link ItemRenderer} when rendering one cell. */
-type RenderItemArgs<T> = {
+/** Arguments passed to a {@link ListItemRenderer} when rendering one cell. */
+type ListItemRenderArgs<T> = {
+    /** Value of the `ListItem` being rendered. */
     item: T;
+    /** Position of the item in the flattened item list, which excludes section headers and collapsed tree rows. */
     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;
 };
-/** Arguments passed to a {@link HeaderRenderer} when rendering one section header. */
-type RenderHeaderArgs<S> = {
+/** Arguments passed to a {@link ListSectionRenderer} when rendering one section header. */
+type ListSectionRenderArgs<S> = {
+    /** Value of the `ListSection` whose header is being rendered. */
     section: S;
 };
 /** Renders the contents of one cell of a collection view. */
-type ItemRenderer<T> = (args: RenderItemArgs<T>) => ReactNode;
+type ListItemRenderer<T> = (args: ListItemRenderArgs<T>) => ReactNode;
 /** Renders the contents of one section header of a collection view. */
-type HeaderRenderer<S> = (args: RenderHeaderArgs<S>) => ReactNode;
+type ListSectionRenderer<S> = (args: ListSectionRenderArgs<S>) => ReactNode;
+/** Size a collection view requests for each cell before its contents render, keeping scroll estimates steady. */
 type ItemSizeProps = {
+    /** Height in pixels every cell asks for until its contents render; unset lets each cell size itself. */
     estimatedItemHeight?: number | undefined;
+    /** Width in pixels every cell asks for until its contents render; unset lets each cell size itself. */
     estimatedItemWidth?: number | undefined;
 };
+/** Controlled selection shared by the multi-item collection views. */
 type SelectionProps = {
+    /** Ids of the items to keep selected; omitting it leaves the view's own selection alone. */
     selectedIds?: string[] | null | undefined;
+    /** Called with the ids of every selected item whenever the selection changes, and once on mount. */
     onSelectionChanged?: ((ids: string[]) => void) | null | undefined;
+    /** How much the user may select, one item at a time unless `MULTIPLE` or `NONE` is given. */
     selectionMode?: Gtk.SelectionMode | null | undefined;
 };
+/** Controlled expansion for the views that turn nested `ListItem.children` into a tree. */
 type ExpansionProps = {
+    /** Ids of the items to keep expanded; omitting it leaves the rows' own expanded state alone. */
     expandedIds?: string[] | null | undefined;
+    /** Called with the ids of every expanded row whenever expansion changes. */
     onExpandedChange?: ((ids: string[]) => void) | null | undefined;
 };
+/** The data a collection view renders, either as a plain item list or grouped into sections. */
 type SourceProps<T, S> = {
-    items?: Item<T>[] | undefined;
-    sections?: Section<S, T>[] | undefined;
+    /** Items to render, nesting through `ListItem.children` for a tree; ignored once `sections` is given. */
+    items?: ListItem<T>[] | undefined;
+    /** Items grouped under section headers, rendered in place of `items`. */
+    sections?: ListSection<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"> & {
+type ColumnViewColumn<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" | "sorter" | "id" | "title"> & {
     /** Stable identifier, also used to address the column through sorting props. */
     id: string;
+    /** Text shown in the column header. */
     title: string;
-    renderCell: ItemRenderer<T>;
-    /** Whether clicking the column header sorts by it. */
-    sortable?: boolean | undefined;
+    /** Renders the contents of this column's cell for one item. */
+    renderCell: ListItemRenderer<T>;
+    /** Makes the column header clickable, reporting the choice through `onSortChanged`. */
+    isSortable?: boolean | undefined;
+    /** Menu element popped up as the column header's context menu, on a right-click. */
     headerMenu?: ReactNode;
 };
+/** The declarative collection props {@link ColumnView} adds on top of Gtk.ColumnView's own. */
 type ColumnViewOwnProps<T, S> = SelectionProps & ExpansionProps & SourceProps<T, S> & Omit<ItemSizeProps, "estimatedItemWidth"> & {
-    columns: Column<T>[];
-    renderHeader?: HeaderRenderer<S> | null | undefined;
+    /** Columns to render, in order; each carries its own cell renderer. */
+    columns: ColumnViewColumn<T>[];
+    /** Renders the header shown above each section. */
+    renderHeader?: ListSectionRenderer<S> | null | undefined;
     /** Id of the column the view is sorted by, making sorting controlled. */
     sortColumn?: string | null | undefined;
+    /** Direction `sortColumn` is sorted in, defaulting to ascending. */
     sortOrder?: Gtk.SortType | null | undefined;
+    /** Called when the user sorts from a header, with the primary column's id, or null, and its order. */
     onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;
 };
 /**
@@ -92,24 +111,33 @@ type ColumnViewOwnProps<T, S> = SelectionProps & ExpansionProps & SourceProps<T,
  * header renderer, and the columns to render.
  */
 type ColumnViewProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "columns" | "model" | "headerFactory" | keyof ColumnViewOwnProps<T, S>> & ColumnViewOwnProps<T, S>;
+/** The declarative collection props {@link DropDown} and `ComboRow` add on top of their widget's own. */
 type DropDownOwnProps<T, S> = SourceProps<T, S> & {
     /** Id of the currently selected item, making the selection controlled. */
     selectedId?: string | null | undefined;
+    /** Called with the id of the item that became selected. */
     onSelectionChanged?: ((id: string) => void) | null | undefined;
-    renderItem?: ItemRenderer<T> | null | undefined;
+    /** Renders the collapsed display, and the popup rows too unless `renderListItem` is given. */
+    renderItem?: ListItemRenderer<T> | null | undefined;
     /** Renderer for items in the open popup list, falling back to renderItem when omitted. */
-    renderListItem?: ItemRenderer<T> | null | undefined;
+    renderListItem?: ListItemRenderer<T> | null | undefined;
     /** Renderer for section headers in the popup list. */
-    renderHeader?: HeaderRenderer<S> | null | undefined;
+    renderHeader?: ListSectionRenderer<S> | null | undefined;
 };
+/** A drop-down-shaped widget's props with its model and factories swapped for the declarative collection props. */
+type DropDownWidgetProps<Widget, T, S> = Omit<Widget, "model" | "factory" | "listFactory" | "headerFactory" | keyof DropDownOwnProps<T, S>> & DropDownOwnProps<T, S>;
 /**
- * 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.
+ * Props for {@link DropDown}. Combines the underlying Gtk.DropDown props with the declarative
+ * collection props: flat items or grouped sections, controlled single selection, and renderers
+ * for the collapsed display, popup rows, and popup section headers.
  */
-type DropDownProps<T = unknown, S = unknown, C extends ElementType = typeof GtkDropDown> = WidgetProps<C, DropDownOwnProps<T, S>, "model" | "factory" | "listFactory" | "headerFactory">;
+type DropDownProps<T = unknown, S = unknown> = DropDownWidgetProps<GtkDropDownProps, T, S>;
+/** The declarative collection props {@link GridView} adds on top of Gtk.GridView's own. */
 type GridViewOwnProps<T> = ItemSizeProps & SelectionProps & {
-    items?: Item<T>[] | undefined;
-    renderItem: ItemRenderer<T>;
+    /** Items to render as cells; a grid is always flat, so `ListItem.children` is ignored. */
+    items?: ListItem<T>[] | undefined;
+    /** Renders the contents of one cell. */
+    renderItem: ListItemRenderer<T>;
 };
 /**
  * Props for {@link GridView}. Combines the underlying Gtk.GridView props with
@@ -117,9 +145,12 @@ type GridViewOwnProps<T> = ItemSizeProps & SelectionProps & {
  * and estimated item sizing.
  */
 type GridViewProps<T = unknown> = Omit<GtkGridViewProps, "model" | "factory" | keyof GridViewOwnProps<T>> & GridViewOwnProps<T>;
+/** The declarative collection props {@link ListView} adds on top of Gtk.ListView's own. */
 type ListViewOwnProps<T, S> = ItemSizeProps & SelectionProps & ExpansionProps & SourceProps<T, S> & {
-    renderItem: ItemRenderer<T>;
-    renderHeader?: HeaderRenderer<S> | null | undefined;
+    /** Renders the contents of one row. */
+    renderItem: ListItemRenderer<T>;
+    /** Renders the header shown above each section. */
+    renderHeader?: ListSectionRenderer<S> | null | undefined;
 };
 /**
  * Props for {@link ListView}. Combines the underlying Gtk.ListView props with
@@ -128,14 +159,5 @@ type ListViewOwnProps<T, S> = ItemSizeProps & SelectionProps & ExpansionProps &
  * estimated item sizing.
  */
 type ListViewProps<T = unknown, S = unknown> = Omit<GtkListViewProps, "model" | "factory" | "headerFactory" | keyof ListViewOwnProps<T, S>> & ListViewOwnProps<T, S>;
-/** Props for {@link SizeGroup}. */
-type SizeGroupProps = {
-    /** How the group equalizes sizes: horizontal, vertical, or both. */
-    mode?: Gtk.SizeGroupMode | null | undefined;
-    ref?: Ref<Gtk.SizeGroup | null>;
-    children?: ReactNode;
-};
-/** Adds a single widget, rendered by the given component, to the enclosing {@link SizeGroup}. */
-type SizeGroupChildProps<C extends ElementType> = ChildProps<C>;
-export { type SelectionProps, type ExpansionProps, type ChildProps, type WidgetProps, type Item, type Section, type RenderItemArgs, type RenderHeaderArgs, type ItemRenderer, type HeaderRenderer, type Column, type ColumnViewProps, type DropDownProps, type GridViewProps, type ListViewProps, type SizeGroupProps, type SizeGroupChildProps, };
+export { type SelectionProps, type ExpansionProps, type DropDownOwnProps, type DropDownWidgetProps, type ListItem, type ListSection, type ListItemRenderArgs, type ListSectionRenderArgs, type ListItemRenderer, type ListSectionRenderer, type ColumnViewColumn, type ColumnViewProps, type DropDownProps, type GridViewProps, type ListViewProps, };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA+MA,OAAO,EAgBN,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type {\n    GtkColumnViewColumnProps,\n    GtkColumnViewProps,\n    GtkDropDownProps,\n    GtkGridViewProps,\n    GtkListViewProps,\n} from \"@gtkx/jsx/gtk\";\nimport type { ReactNode } from \"react\";\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 ListItem<T = unknown> = {\n    /** Stable identifier used to track the item across updates and selection. */\n    id: string;\n    /** Payload handed to the cell renderer as `ListItemRenderArgs.item`. */\n    value: T;\n    /** Child items nested under this one, which turn a plain item list into a tree. */\n    children?: ListItem<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 ListSection<S = unknown, T = unknown> = {\n    /** Stable identifier used to track the section across updates. */\n    id: string;\n    /** Payload handed to the section header renderer as `ListSectionRenderArgs.section`. */\n    value: S;\n    /** Items belonging to this section. */\n    data: ListItem<T>[];\n};\n\n/** Arguments passed to a {@link ListItemRenderer} when rendering one cell. */\ntype ListItemRenderArgs<T> = {\n    /** Value of the `ListItem` being rendered. */\n    item: T;\n    /** Position of the item in the flattened item list, which excludes section headers and collapsed tree rows. */\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 ListSectionRenderer} when rendering one section header. */\ntype ListSectionRenderArgs<S> = {\n    /** Value of the `ListSection` whose header is being rendered. */\n    section: S;\n};\n\n/** Renders the contents of one cell of a collection view. */\ntype ListItemRenderer<T> = (args: ListItemRenderArgs<T>) => ReactNode;\n/** Renders the contents of one section header of a collection view. */\ntype ListSectionRenderer<S> = (args: ListSectionRenderArgs<S>) => ReactNode;\n\n/** Size a collection view requests for each cell before its contents render, keeping scroll estimates steady. */\ntype ItemSizeProps = {\n    /** Height in pixels every cell asks for until its contents render; unset lets each cell size itself. */\n    estimatedItemHeight?: number | undefined;\n    /** Width in pixels every cell asks for until its contents render; unset lets each cell size itself. */\n    estimatedItemWidth?: number | undefined;\n};\n\n/** Controlled selection shared by the multi-item collection views. */\ntype SelectionProps = {\n    /** Ids of the items to keep selected; omitting it leaves the view's own selection alone. */\n    selectedIds?: string[] | null | undefined;\n    /** Called with the ids of every selected item whenever the selection changes, and once on mount. */\n    onSelectionChanged?: ((ids: string[]) => void) | null | undefined;\n    /** How much the user may select, one item at a time unless `MULTIPLE` or `NONE` is given. */\n    selectionMode?: Gtk.SelectionMode | null | undefined;\n};\n\n/** Controlled expansion for the views that turn nested `ListItem.children` into a tree. */\ntype ExpansionProps = {\n    /** Ids of the items to keep expanded; omitting it leaves the rows' own expanded state alone. */\n    expandedIds?: string[] | null | undefined;\n    /** Called with the ids of every expanded row whenever expansion changes. */\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n};\n\n/** The data a collection view renders, either as a plain item list or grouped into sections. */\ntype SourceProps<T, S> = {\n    /** Items to render, nesting through `ListItem.children` for a tree; ignored once `sections` is given. */\n    items?: ListItem<T>[] | undefined;\n    /** Items grouped under section headers, rendered in place of `items`. */\n    sections?: ListSection<S, T>[] | undefined;\n};\n\n/** One column of a {@link ColumnView}, pairing Gtk.ColumnViewColumn props with a cell renderer. */\ntype ColumnViewColumn<T = unknown> = Omit<GtkColumnViewColumnProps, \"factory\" | \"sorter\" | \"id\" | \"title\"> & {\n    /** Stable identifier, also used to address the column through sorting props. */\n    id: string;\n    /** Text shown in the column header. */\n    title: string;\n    /** Renders the contents of this column's cell for one item. */\n    renderCell: ListItemRenderer<T>;\n    /** Makes the column header clickable, reporting the choice through `onSortChanged`. */\n    isSortable?: boolean | undefined;\n    /** Menu element popped up as the column header's context menu, on a right-click. */\n    headerMenu?: ReactNode;\n};\n\n/** The declarative collection props {@link ColumnView} adds on top of Gtk.ColumnView's own. */\ntype ColumnViewOwnProps<T, S> = SelectionProps &\n    ExpansionProps &\n    SourceProps<T, S> &\n    Omit<ItemSizeProps, \"estimatedItemWidth\"> & {\n        /** Columns to render, in order; each carries its own cell renderer. */\n        columns: ColumnViewColumn<T>[];\n        /** Renders the header shown above each section. */\n        renderHeader?: ListSectionRenderer<S> | null | undefined;\n        /** Id of the column the view is sorted by, making sorting controlled. */\n        sortColumn?: string | null | undefined;\n        /** Direction `sortColumn` is sorted in, defaulting to ascending. */\n        sortOrder?: Gtk.SortType | null | undefined;\n        /** Called when the user sorts from a header, with the primary column's id, or null, and its order. */\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\n/** The declarative collection props {@link DropDown} and `ComboRow` add on top of their widget's own. */\ntype DropDownOwnProps<T, S> = SourceProps<T, S> & {\n    /** Id of the currently selected item, making the selection controlled. */\n    selectedId?: string | null | undefined;\n    /** Called with the id of the item that became selected. */\n    onSelectionChanged?: ((id: string) => void) | null | undefined;\n    /** Renders the collapsed display, and the popup rows too unless `renderListItem` is given. */\n    renderItem?: ListItemRenderer<T> | null | undefined;\n    /** Renderer for items in the open popup list, falling back to renderItem when omitted. */\n    renderListItem?: ListItemRenderer<T> | null | undefined;\n    /** Renderer for section headers in the popup list. */\n    renderHeader?: ListSectionRenderer<S> | null | undefined;\n};\n\n/** A drop-down-shaped widget's props with its model and factories swapped for the declarative collection props. */\ntype DropDownWidgetProps<Widget, T, S> = Omit<\n    Widget,\n    \"model\" | \"factory\" | \"listFactory\" | \"headerFactory\" | keyof DropDownOwnProps<T, S>\n> &\nDropDownOwnProps<T, S>;\n\n/**\n * Props for {@link DropDown}. Combines the underlying Gtk.DropDown props with the declarative\n * collection props: flat items or grouped sections, controlled single selection, and renderers\n * for the collapsed display, popup rows, and popup section headers.\n */\ntype DropDownProps<T = unknown, S = unknown> = DropDownWidgetProps<GtkDropDownProps, T, S>;\n\n/** The declarative collection props {@link GridView} adds on top of Gtk.GridView's own. */\ntype GridViewOwnProps<T> = ItemSizeProps &\n    SelectionProps & {\n        /** Items to render as cells; a grid is always flat, so `ListItem.children` is ignored. */\n        items?: ListItem<T>[] | undefined;\n        /** Renders the contents of one cell. */\n        renderItem: ListItemRenderer<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\n/** The declarative collection props {@link ListView} adds on top of Gtk.ListView's own. */\ntype ListViewOwnProps<T, S> = ItemSizeProps &\n    SelectionProps &\n    ExpansionProps &\n    SourceProps<T, S> & {\n        /** Renders the contents of one row. */\n        renderItem: ListItemRenderer<T>;\n        /** Renders the header shown above each section. */\n        renderHeader?: ListSectionRenderer<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\nexport {\n    type SelectionProps,\n    type ExpansionProps,\n    type DropDownOwnProps,\n    type DropDownWidgetProps,\n    type ListItem,\n    type ListSection,\n    type ListItemRenderArgs,\n    type ListSectionRenderArgs,\n    type ListItemRenderer,\n    type ListSectionRenderer,\n    type ColumnViewColumn,\n    type ColumnViewProps,\n    type DropDownProps,\n    type GridViewProps,\n    type ListViewProps,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/components",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "description": "High-level GTKX components for declarative collection views, menus, and containers with attach-time placement",
   "keywords": [
     "gtkx",
@@ -44,8 +44,8 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@gtkx/react": "1.0.0-rc.2",
-    "@gtkx/utils": "1.0.0-rc.2"
+    "@gtkx/react": "1.0.0-rc.4",
+    "@gtkx/utils": "1.0.0-rc.4"
   },
   "peerDependencies": {
     "react": "^19.2"
@@ -53,10 +53,10 @@
   "devDependencies": {
     "@codspeed/vitest-plugin": "^5.7.1",
     "vitest": "^4.1.10",
-    "@gtkx/config": "1.0.0-rc.2",
-    "@gtkx/runtime": "1.0.0-rc.2",
-    "@gtkx/testing": "1.0.0-rc.2",
-    "@gtkx/vitest": "1.0.0-rc.2"
+    "@gtkx/config": "1.0.0-rc.4",
+    "@gtkx/runtime": "1.0.0-rc.4",
+    "@gtkx/testing": "1.0.0-rc.4",
+    "@gtkx/vitest": "1.0.0-rc.4"
   },
   "scripts": {
     "bench": "NODE_ENV=production vitest bench --run --config vitest.bench.config.ts",

package/src/adw/combo-row.tsx

@@ -0,0 +1,21 @@
+import type { ReactNode } from "react";
+import { AdwComboRow } from "@gtkx/jsx/adw";
+import type { DropDownBaseProps } from "../internal/drop-down.js";
+import type { ComboRowProps } from "./types.js";
+import { DropDownBase } from "../internal/drop-down.js";
+
+/** Call signature of {@link ComboRow}, generic in the item and section value types. */
+type ComboRowComponent = <T = unknown, S = unknown>(props: ComboRowProps<T, S>) => ReactNode;
+
+/**
+ * Renders an `Adw.ComboRow` backed by a collection model, presenting the same choice as a
+ * `DropDown` in the shape of a preferences row, with customizable renderers for the row
+ * display, popup rows, and popup section headers, and controlled selection.
+ */
+const ComboRow: ComboRowComponent = ComboRowImpl as ComboRowComponent;
+
+function ComboRowImpl(props: DropDownBaseProps): ReactNode {
+    return <DropDownBase {...props} component={AdwComboRow} />;
+}
+
+export { ComboRow };

package/src/adw/index.ts

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

package/src/adw/types.ts

@@ -1,7 +1,14 @@
 import type * as Adw from "@gtkx/gi/adw";
-import type { AdwToastProps } from "@gtkx/jsx/adw";
+import type { AdwComboRowProps, AdwToastProps } from "@gtkx/jsx/adw";
 import type { ReactNode, RefObject } from "react";
+import type { DropDownWidgetProps } from "../types.js";
 
+/**
+ * Props for {@link ComboRow}. Combines the underlying Adw.ComboRow props with the declarative
+ * collection props: flat items or grouped sections, controlled single selection, and renderers
+ * for the row display, popup rows, and popup section headers.
+ */
+type ComboRowProps<T = unknown, S = unknown> = DropDownWidgetProps<AdwComboRowProps, T, S>;
 /**
  * Describes a toast raised through {@link useToast}: the construct-time properties of an
  * `Adw.Toast` plus its `button-clicked` and `dismissed` handlers.
@@ -12,7 +19,7 @@ type ToastOptions = Adw.ToastConstructorProps & Pick<AdwToastProps, "onButtonCli
 type ToastController = {
     /** Builds a toast, shows it through the overlay, and returns it. */
     show: (options?: ToastOptions) => Adw.Toast;
-    /** Dismisses a single toast, typically one returned by {@link ToastController.show}. */
+    /** Dismisses a single toast, typically one returned by `ToastController.show`. */
     dismiss: (toast: Adw.Toast) => void;
 };
 
@@ -26,7 +33,14 @@ type ToastOverlayController = {
 type ToastProviderProps = {
     /** Ref also given to the `AdwToastOverlay` the toasts appear over. */
     overlayRef: RefObject<Adw.ToastOverlay | null>;
+    /** Subtree whose `useToast` and `useToastOverlay` calls target that overlay. */
     children?: ReactNode | undefined;
 };
 
-export { type ToastOptions, type ToastController, type ToastOverlayController, type ToastProviderProps };
+export {
+    type ComboRowProps,
+    type ToastOptions,
+    type ToastController,
+    type ToastOverlayController,
+    type ToastProviderProps,
+};