@gtkx/components 2.0.0-beta.10 → 2.0.0-beta.11

package/dist/internal/tree-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree-order.js","sourceRoot":"","sources":["../../src/internal/tree-order.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ListItem } from \"../types.js\";\nimport type { CollectionIndex, Level } from \"./collection-index.js\";\nimport type { SlotMap } from \"./slots.js\";\n\ntype VisibleRow = {\n    item: ListItem;\n    position: number;\n    isOpen: boolean;\n    isMarked: boolean;\n};\n\ntype VisibleOrder = {\n    expandedPaths: string[];\n    expandedIds: string[];\n};\n\ntype MatchedRows = {\n    positions: number[];\n    ids: string[];\n};\n\ntype RowVisitor = (row: VisibleRow) => void;\n\ntype WalkOptions = {\n    index: CollectionIndex;\n    slots: SlotMap;\n    marks?: SlotMap | undefined;\n    visit?: RowVisitor | undefined;\n};\n\ntype LevelFrame = {\n    level: Level;\n    cursor: number;\n};\n\ntype WalkFrame = LevelFrame & {\n    open: Set<number> | undefined;\n    marked: Set<number> | undefined;\n};\n\ntype WalkState = {\n    options: WalkOptions;\n    stack: WalkFrame[];\n    row: VisibleRow;\n    order: VisibleOrder;\n};\n\ntype OpenFrame = LevelFrame & {\n    owner: ListItem | null;\n};\n\ntype OpenWalk = {\n    index: CollectionIndex;\n    ids: Set<string>;\n    paths: Set<string>;\n    stack: OpenFrame[];\n    ancestors: Set<ListItem>;\n};\n\nconst NO_ITEM: ListItem = { id: \"\", value: undefined };\n\nfunction advanceStack<F extends LevelFrame>(\n    stack: F[],\n    onSlot: (frame: F, slot: number) => void,\n    onLeave?: (frame: F) => void,\n): void {\n    const frame = stack.at(-1);\n\n    if (frame === undefined) {\n        return;\n    }\n\n    if (frame.cursor >= frame.level.items.length) {\n        stack.pop();\n        onLeave?.(frame);\n\n        return;\n    }\n\n    const slot = frame.cursor;\n    frame.cursor += 1;\n    onSlot(frame, slot);\n}\n\nfunction frameFor(options: WalkOptions, level: Level): WalkFrame {\n    return { level, cursor: 0, open: options.slots.get(level.path), marked: options.marks?.get(level.path) };\n}\n\nfunction descend(state: WalkState, level: Level, slot: number): void {\n    const child = state.options.index.childLevel(level, slot);\n\n    if (child === undefined) {\n        return;\n    }\n\n    state.order.expandedPaths.push(child.path);\n    state.order.expandedIds.push(state.row.item.id);\n    state.stack.push(frameFor(state.options, child));\n}\n\nfunction visitSlot(state: WalkState, frame: WalkFrame, slot: number): void {\n    const item = frame.level.items[slot];\n\n    if (item === undefined) {\n        return;\n    }\n\n    const { row } = state;\n    row.item = item;\n    row.isOpen = frame.open?.has(slot) ?? false;\n    row.isMarked = frame.marked?.has(slot) ?? false;\n    state.options.visit?.(row);\n    row.position += 1;\n\n    if (row.isOpen) {\n        descend(state, frame.level, slot);\n    }\n}\n\nfunction walkVisible(options: WalkOptions): VisibleOrder {\n    const order: VisibleOrder = { expandedPaths: [], expandedIds: [] };\n    const row: VisibleRow = { item: NO_ITEM, position: 0, isOpen: false, isMarked: false };\n    const frames = options.index.groups.map((level) => frameFor(options, level));\n    const state: WalkState = { options, stack: frames.toReversed(), row, order };\n\n    const onSlot = (frame: WalkFrame, slot: number): void => {\n        visitSlot(state, frame, slot);\n    };\n\n    while (state.stack.length > 0) {\n        advanceStack(state.stack, onSlot);\n    }\n\n    return order;\n}\n\nfunction openSlot(walk: OpenWalk, frame: OpenFrame, slot: number): void {\n    const item = frame.level.items[slot];\n\n    if (item === undefined || !walk.ids.has(item.id) || walk.ancestors.has(item)) {\n        return;\n    }\n\n    const child = walk.index.childLevel(frame.level, slot);\n\n    if (child === undefined) {\n        return;\n    }\n\n    walk.paths.add(child.path);\n    walk.ancestors.add(item);\n    walk.stack.push({ level: child, cursor: 0, owner: item });\n}\n\nfunction leaveOpenFrame(walk: OpenWalk, frame: OpenFrame): void {\n    if (frame.owner !== null) {\n        walk.ancestors.delete(frame.owner);\n    }\n}\n\nfunction expandedPathsFor(index: CollectionIndex, ids: Set<string>): Set<string> {\n    const paths: Set<string> = new Set();\n\n    if (ids.size === 0 || !index.isTree) {\n        return paths;\n    }\n\n    const frames = index.groups.map((level) => ({ level, cursor: 0, owner: null }));\n    const walk: OpenWalk = { index, ids, paths, stack: frames.toReversed(), ancestors: new Set() };\n\n    const onSlot = (frame: OpenFrame, slot: number): void => {\n        openSlot(walk, frame, slot);\n    };\n\n    const onLeave = (frame: OpenFrame): void => {\n        leaveOpenFrame(walk, frame);\n    };\n\n    while (walk.stack.length > 0) {\n        advanceStack(walk.stack, onSlot, onLeave);\n    }\n\n    return paths;\n}\n\nfunction findRows(index: CollectionIndex, slots: SlotMap, ids: Set<string>): MatchedRows {\n    const positions: number[] = [];\n    const found: string[] = [];\n\n    walkVisible({\n        index,\n        slots,\n        visit: (row) => {\n            if (!ids.has(row.item.id)) {\n                return;\n            }\n\n            positions.push(row.position);\n            found.push(row.item.id);\n        },\n    });\n\n    return { positions, ids: found };\n}\n\nfunction findIds(index: CollectionIndex, slots: SlotMap, positions: Set<number>): string[] {\n    const found: string[] = [];\n\n    walkVisible({\n        index,\n        slots,\n        visit: (row) => {\n            if (!positions.has(row.position)) {\n                return;\n            }\n\n            found.push(row.item.id);\n        },\n    });\n\n    return found;\n}\n\nexport {\n    expandedPathsFor,\n    findIds,\n    findRows,\n    walkVisible,\n    type MatchedRows,\n    type VisibleOrder,\n    type WalkOptions,\n};\n"]}
+{"version":3,"file":"tree-order.js","sourceRoot":"","sources":["../../src/internal/tree-order.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ListItem } from \"../types.js\";\nimport type { CollectionIndex, Level } from \"./collection-index.js\";\nimport type { SlotMap } from \"./slots.js\";\n\ntype VisibleRow = {\n    item: ListItem;\n    position: number;\n    isOpen: boolean;\n    isMarked: boolean;\n};\n\ntype VisibleOrder = {\n    expandedPaths: string[];\n    expandedIds: string[];\n};\n\ntype MatchedRows = {\n    positions: number[];\n    ids: string[];\n};\n\ntype RowVisitor = (row: VisibleRow) => void;\n\ntype WalkOptions = {\n    index: CollectionIndex;\n    slots: SlotMap;\n    marks?: SlotMap | undefined;\n    visit?: RowVisitor | undefined;\n};\n\ntype WalkState = {\n    position: number;\n    order: VisibleOrder;\n};\n\nfunction walkLevel(options: WalkOptions, level: Level, state: WalkState): void {\n    const open = options.slots.get(level.path);\n    const marked = options.marks?.get(level.path);\n\n    for (const [slot, item] of level.items.entries()) {\n        const isOpen = open?.has(slot) ?? false;\n        options.visit?.({ item, position: state.position, isOpen, isMarked: marked?.has(slot) ?? false });\n        state.position += 1;\n\n        if (!isOpen) {\n            continue;\n        }\n\n        const child = options.index.childLevel(level, slot);\n\n        if (child !== undefined) {\n            state.order.expandedPaths.push(child.path);\n            state.order.expandedIds.push(item.id);\n            walkLevel(options, child, state);\n        }\n    }\n}\n\nfunction walkVisible(options: WalkOptions): VisibleOrder {\n    const state: WalkState = { position: 0, order: { expandedPaths: [], expandedIds: [] } };\n\n    for (const level of options.index.groups) {\n        walkLevel(options, level, state);\n    }\n\n    return state.order;\n}\n\nfunction expandLevel(index: CollectionIndex, level: Level, ids: Set<string>, paths: Set<string>): void {\n    for (const [slot, item] of level.items.entries()) {\n        if (!ids.has(item.id)) {\n            continue;\n        }\n\n        const child = index.childLevel(level, slot);\n\n        if (child !== undefined) {\n            paths.add(child.path);\n            expandLevel(index, child, ids, paths);\n        }\n    }\n}\n\nfunction expandedPathsFor(index: CollectionIndex, ids: Set<string>): Set<string> {\n    const paths: Set<string> = new Set();\n\n    if (ids.size === 0 || !index.isTree) {\n        return paths;\n    }\n\n    for (const level of index.groups) {\n        expandLevel(index, level, ids, paths);\n    }\n\n    return paths;\n}\n\nfunction findRows(index: CollectionIndex, slots: SlotMap, ids: Set<string>): MatchedRows {\n    const positions: number[] = [];\n    const found: string[] = [];\n\n    walkVisible({\n        index,\n        slots,\n        visit: (row) => {\n            if (!ids.has(row.item.id)) {\n                return;\n            }\n\n            positions.push(row.position);\n            found.push(row.item.id);\n        },\n    });\n\n    return { positions, ids: found };\n}\n\nfunction findIds(index: CollectionIndex, slots: SlotMap, positions: Set<number>): string[] {\n    const found: string[] = [];\n\n    walkVisible({\n        index,\n        slots,\n        visit: (row) => {\n            if (!positions.has(row.position)) {\n                return;\n            }\n\n            found.push(row.item.id);\n        },\n    });\n\n    return found;\n}\n\nexport {\n    expandedPathsFor,\n    findIds,\n    findRows,\n    walkVisible,\n    type MatchedRows,\n    type VisibleOrder,\n    type WalkOptions,\n};\n"]}

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

@@ -11,7 +11,11 @@ type CollectionResult = {
     collection: Collection;
     selection: ReactElement;
 };
-declare function useCollectionData(options: CollectionDataOptions): Collection;
+type CollectionDataResult = {
+    collection: Collection;
+    model: ReactElement;
+};
+declare function useCollectionData(options: CollectionDataOptions): CollectionDataResult;
 declare function useCollection(options: CollectionOptions): CollectionResult;
 export { useCollection, useCollectionData };
 //# sourceMappingURL=use-collection.d.ts.map

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,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,CAAC"}
+{"version":3,"file":"use-collection.d.ts","sourceRoot":"","sources":["../../src/internal/use-collection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,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,KAAK,oBAAoB,GAAG;IACxB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,iBAAS,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAwB/E;AAED,iBAAS,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAmBnE;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/internal/use-collection.js

@@ -1,21 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { GtkFlattenListModel } from "@gtkx/jsx/gtk";
 import { useLayoutEffect, useMemo, useState } from "react";
 import { createCollectionIndex } from "./collection-index.js";
-import { createCollectionModel } from "./collection-model.js";
+import { CollectionRoot, createCollectionModel } from "./collection-model.js";
 import { createCollection } from "./collection.js";
 import { useExpansion } from "./expansion.js";
 import { useSelection } from "./selection.js";
 function useCollectionData(options) {
     const { items, sections, isFlat } = options;
-    const [collectionModel] = useState(createCollectionModel);
+    const [gtkModel] = useState(createCollectionModel);
+    const [root, setRoot] = useState(null);
+    const [model, setModel] = useState(null);
     const index = useMemo(() => createCollectionIndex(items, sections, isFlat === true), [items, sections, isFlat]);
-    const collection = useMemo(() => createCollection(collectionModel, index), [collectionModel, index]);
+    const collection = useMemo(() => createCollection(gtkModel, index, model), [gtkModel, index, model]);
     useLayoutEffect(() => {
-        collectionModel.sync(index);
-    }, [collectionModel, index]);
-    return collection;
+        if (root !== null && model !== null) {
+            gtkModel.bind(root, model);
+        }
+        return gtkModel.clear;
+    }, [gtkModel, root, model]);
+    useLayoutEffect(() => {
+        gtkModel.sync(index);
+    }, [gtkModel, index, root, model]);
+    return {
+        collection,
+        model: _jsx(GtkFlattenListModel, { ref: setModel, model: _jsx(CollectionRoot, { ref: setRoot }) }),
+    };
 }
 function useCollection(options) {
-    const collection = useCollectionData(options);
+    const { collection, model } = useCollectionData(options);
     const onItemsChanged = useExpansion({
         collection,
         expandedIds: options.expandedIds,
@@ -23,6 +36,7 @@ function useCollection(options) {
     });
     const selection = useSelection({
         collection,
+        model,
         selectedIds: options.selectedIds,
         onSelectionChanged: options.onSelectionChanged,
         selectionMode: options.selectionMode,

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;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,eAAe,CAAC,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC1D,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,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;IAErG,eAAe,CAAC,GAAG,EAAE;QACjB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;IAE7B,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,EAAE,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 [collectionModel] = useState(createCollectionModel);\n    const index = useMemo(() => createCollectionIndex(items, sections, isFlat === true), [items, sections, isFlat]);\n    const collection = useMemo(() => createCollection(collectionModel, index), [collectionModel, index]);\n\n    useLayoutEffect(() => {\n        collectionModel.sync(index);\n    }, [collectionModel, 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 };\n"]}
+{"version":3,"file":"use-collection.js","sourceRoot":"","sources":["../../src/internal/use-collection.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAA4B,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoB9C,SAAS,iBAAiB,CAAC,OAA8B;IACrD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACnD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAA6B,IAAI,CAAC,CAAC;IACnE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAC;IACtE,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,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAErG,eAAe,CAAC,GAAG,EAAE;QACjB,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAC,KAAK,CAAC;IAC1B,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAE5B,eAAe,CAAC,GAAG,EAAE;QACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnC,OAAO;QACH,UAAU;QACV,KAAK,EAAE,KAAC,mBAAmB,IAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAC,cAAc,IAAC,GAAG,EAAE,OAAO,GAAI,GAAI;KACzF,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,OAA0B;IAC7C,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEzD,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,KAAK;QACL,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,EAAE,CAAC","sourcesContent":["import type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { ReactElement } from \"react\";\nimport { GtkFlattenListModel } from \"@gtkx/jsx/gtk\";\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 { CollectionRoot, type CollectionRootStore, 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\ntype CollectionDataResult = {\n    collection: Collection;\n    model: ReactElement;\n};\n\nfunction useCollectionData(options: CollectionDataOptions): CollectionDataResult {\n    const { items, sections, isFlat } = options;\n    const [gtkModel] = useState(createCollectionModel);\n    const [root, setRoot] = useState<CollectionRootStore | null>(null);\n    const [model, setModel] = useState<Gtk.FlattenListModel | null>(null);\n    const index = useMemo(() => createCollectionIndex(items, sections, isFlat === true), [items, sections, isFlat]);\n    const collection = useMemo(() => createCollection(gtkModel, index, model), [gtkModel, index, model]);\n\n    useLayoutEffect(() => {\n        if (root !== null && model !== null) {\n            gtkModel.bind(root, model);\n        }\n\n        return gtkModel.clear;\n    }, [gtkModel, root, model]);\n\n    useLayoutEffect(() => {\n        gtkModel.sync(index);\n    }, [gtkModel, index, root, model]);\n\n    return {\n        collection,\n        model: <GtkFlattenListModel ref={setModel} model={<CollectionRoot ref={setRoot} />} />,\n    };\n}\n\nfunction useCollection(options: CollectionOptions): CollectionResult {\n    const { collection, model } = 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        model,\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 };\n"]}

package/dist/list-item-factory.d.ts

@@ -0,0 +1,10 @@
+import type * as GObject from "@gtkx/gi/gobject";
+import type { ReactNode } from "react";
+import type { ListItemFactoryProps } from "./types.js";
+/**
+ * Creates a Gtk.SignalListItemFactory that renders objects from an existing native model with React.
+ * Estimated dimensions keep cells stable until their content mounts.
+ */
+declare function ListItemFactory<T extends GObject.Object>({ renderItem, estimatedItemHeight, estimatedItemWidth, }: ListItemFactoryProps<T>): ReactNode;
+export { ListItemFactory };
+//# sourceMappingURL=list-item-factory.d.ts.map

package/dist/list-item-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-item-factory.d.ts","sourceRoot":"","sources":["../src/list-item-factory.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD;;;GAGG;AACH,iBAAS,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,EAAE,EAC/C,UAAU,EACV,mBAAwB,EACxB,kBAAuB,GAC1B,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAUrC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/list-item-factory.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { GtkSignalListItemFactory } from "@gtkx/jsx/gtk";
+import { NativeItemPortals, useItemCells } from "./internal/cells.js";
+/**
+ * Creates a Gtk.SignalListItemFactory that renders objects from an existing native model with React.
+ * Estimated dimensions keep cells stable until their content mounts.
+ */
+function ListItemFactory({ renderItem, estimatedItemHeight = -1, estimatedItemWidth = -1, }) {
+    const size = { width: estimatedItemWidth, height: estimatedItemHeight };
+    const cells = useItemCells(size);
+    return (_jsxs(_Fragment, { children: [_jsx(GtkSignalListItemFactory, { ...cells.handlers }), _jsx(NativeItemPortals, { registry: cells, render: renderItem, size: size })] }));
+}
+export { ListItemFactory };
+//# sourceMappingURL=list-item-factory.js.map

package/dist/list-item-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-item-factory.js","sourceRoot":"","sources":["../src/list-item-factory.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;GAGG;AACH,SAAS,eAAe,CAA2B,EAC/C,UAAU,EACV,mBAAmB,GAAG,CAAC,CAAC,EACxB,kBAAkB,GAAG,CAAC,CAAC,GACD;IACtB,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjC,OAAO,CACH,8BACI,KAAC,wBAAwB,OAAK,KAAK,CAAC,QAAQ,GAAI,EAChD,KAAC,iBAAiB,IAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAI,IACvE,CACN,CAAC;AACN,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import type * as GObject from \"@gtkx/gi/gobject\";\nimport type { ReactNode } from \"react\";\nimport { GtkSignalListItemFactory } from \"@gtkx/jsx/gtk\";\nimport type { ListItemFactoryProps } from \"./types.js\";\nimport { NativeItemPortals, useItemCells } from \"./internal/cells.js\";\n\n/**\n * Creates a Gtk.SignalListItemFactory that renders objects from an existing native model with React.\n * Estimated dimensions keep cells stable until their content mounts.\n */\nfunction ListItemFactory<T extends GObject.Object>({\n    renderItem,\n    estimatedItemHeight = -1,\n    estimatedItemWidth = -1,\n}: ListItemFactoryProps<T>): ReactNode {\n    const size = { width: estimatedItemWidth, height: estimatedItemHeight };\n    const cells = useItemCells(size);\n\n    return (\n        <>\n            <GtkSignalListItemFactory {...cells.handlers} />\n            <NativeItemPortals registry={cells} render={renderItem} size={size} />\n        </>\n    );\n}\n\nexport { ListItemFactory };\n"]}

package/dist/toast.d.ts

@@ -1,10 +1,8 @@
 import type { ReactNode } from "react";
-import type { ToastController, ToastOverlayController, ToastProviderProps } from "./types.js";
-/** Shares an Adw.ToastOverlay reference with the toast hooks in every descendant. */
+import type { ToastController, ToastProviderProps } from "./types.js";
+/** Shares an Adw.ToastOverlay reference with useToast in every descendant. */
 declare function ToastProvider(props: ToastProviderProps): ReactNode;
 /** Returns a {@link ToastController} that shows and dismisses toasts on the nearest provider's overlay. */
 declare function useToast(): ToastController;
-/** Returns a {@link ToastOverlayController} for the nearest provider's overlay as a whole. */
-declare function useToastOverlay(): ToastOverlayController;
-export { ToastProvider, useToast, useToastOverlay };
+export { ToastProvider, useToast };
 //# sourceMappingURL=toast.d.ts.map

package/dist/toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../src/toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAgB,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmC5G,qFAAqF;AACrF,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAE3D;AAED,2GAA2G;AAC3G,iBAAS,QAAQ,IAAI,eAAe,CAiBnC;AAED,8FAA8F;AAC9F,iBAAS,eAAe,IAAI,sBAAsB,CAWjD;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../src/toast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAgB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmCpF,8EAA8E;AAC9E,iBAAS,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAE3D;AAED,2GAA2G;AAC3G,iBAAS,QAAQ,IAAI,eAAe,CAiBnC;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

package/dist/toast.js

@@ -5,7 +5,7 @@ const ToastContext = createContext(null);
 const useOverlayRef = () => {
     const overlayRef = useContext(ToastContext);
     if (overlayRef === null) {
-        throw new Error("useToast and useToastOverlay must be used within a ToastProvider");
+        throw new Error("useToast must be used within a ToastProvider");
     }
     return overlayRef;
 };
@@ -24,7 +24,7 @@ const buildToast = (options) => {
     }
     return toast;
 };
-/** Shares an Adw.ToastOverlay reference with the toast hooks in every descendant. */
+/** Shares an Adw.ToastOverlay reference with useToast in every descendant. */
 function ToastProvider(props) {
     return _jsx(ToastContext.Provider, { value: props.overlayRef, children: props.children });
 }
@@ -37,19 +37,10 @@ function useToast() {
             overlayRef.current?.addToast(toast);
             return toast;
         },
-        dismiss: (toast) => {
-            toast.dismiss();
-        },
-    }), [overlayRef]);
-}
-/** Returns a {@link ToastOverlayController} for the nearest provider's overlay as a whole. */
-function useToastOverlay() {
-    const overlayRef = useOverlayRef();
-    return useMemo(() => ({
         dismissAll: () => {
             overlayRef.current?.dismissAll();
         },
     }), [overlayRef]);
 }
-export { ToastProvider, useToast, useToastOverlay };
+export { ToastProvider, useToast };
 //# sourceMappingURL=toast.js.map

package/dist/toast.js.map

@@ -1 +1 @@
-{"version":3,"file":"toast.js","sourceRoot":"","sources":["../src/toast.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAK3D,MAAM,YAAY,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAC;AAE5D,MAAM,aAAa,GAAG,GAAe,EAAE;IACnC,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACxF,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,OAAqB,EAAa,EAAE;IACpD,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC5B,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACtB,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YACvB,WAAW,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,qFAAqF;AACrF,SAAS,aAAa,CAAC,KAAyB;IAC5C,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,CAAC,UAAU,YAAG,KAAK,CAAC,QAAQ,GAAyB,CAAC;AACpG,CAAC;AAED,2GAA2G;AAC3G,SAAS,QAAQ;IACb,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,OAAO,OAAO,CACV,GAAG,EAAE,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,OAAsB,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACxC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEpC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,CAAC,KAAgB,EAAE,EAAE;YAC1B,KAAK,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;KACJ,CAAC,EACF,CAAC,UAAU,CAAC,CACf,CAAC;AACN,CAAC;AAED,8FAA8F;AAC9F,SAAS,eAAe;IACpB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,OAAO,OAAO,CACV,GAAG,EAAE,CAAC,CAAC;QACH,UAAU,EAAE,GAAG,EAAE;YACb,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QACrC,CAAC;KACJ,CAAC,EACF,CAAC,UAAU,CAAC,CACf,CAAC;AACN,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import type { ReactNode, RefObject } from \"react\";\nimport * as Adw from \"@gtkx/gi/adw\";\nimport { createContext, useContext, useMemo } from \"react\";\nimport type { ToastController, ToastOptions, ToastOverlayController, ToastProviderProps } from \"./types.js\";\n\ntype OverlayRef = RefObject<Adw.ToastOverlay | null>;\n\nconst ToastContext = createContext<OverlayRef | null>(null);\n\nconst useOverlayRef = (): OverlayRef => {\n    const overlayRef = useContext(ToastContext);\n\n    if (overlayRef === null) {\n        throw new Error(\"useToast and useToastOverlay must be used within a ToastProvider\");\n    }\n\n    return overlayRef;\n};\n\nconst buildToast = (options: ToastOptions): Adw.Toast => {\n    const { onButtonClicked, onDismissed, ...props } = options;\n    const toast = new Adw.Toast(props);\n\n    if (onButtonClicked != null) {\n        toast.on(\"button-clicked\", () => {\n            onButtonClicked(toast);\n        });\n    }\n\n    if (onDismissed != null) {\n        toast.on(\"dismissed\", () => {\n            onDismissed(toast);\n        });\n    }\n\n    return toast;\n};\n\n/** Shares an Adw.ToastOverlay reference with the toast hooks in every descendant. */\nfunction ToastProvider(props: ToastProviderProps): ReactNode {\n    return <ToastContext.Provider value={props.overlayRef}>{props.children}</ToastContext.Provider>;\n}\n\n/** Returns a {@link ToastController} that shows and dismisses toasts on the nearest provider's overlay. */\nfunction useToast(): ToastController {\n    const overlayRef = useOverlayRef();\n\n    return useMemo<ToastController>(\n        () => ({\n            show: (options?: ToastOptions) => {\n                const toast = buildToast(options ?? {});\n                overlayRef.current?.addToast(toast);\n\n                return toast;\n            },\n            dismiss: (toast: Adw.Toast) => {\n                toast.dismiss();\n            },\n        }),\n        [overlayRef],\n    );\n}\n\n/** Returns a {@link ToastOverlayController} for the nearest provider's overlay as a whole. */\nfunction useToastOverlay(): ToastOverlayController {\n    const overlayRef = useOverlayRef();\n\n    return useMemo<ToastOverlayController>(\n        () => ({\n            dismissAll: () => {\n                overlayRef.current?.dismissAll();\n            },\n        }),\n        [overlayRef],\n    );\n}\n\nexport { ToastProvider, useToast, useToastOverlay };\n"]}
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../src/toast.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAK3D,MAAM,YAAY,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAC;AAE5D,MAAM,aAAa,GAAG,GAAe,EAAE;IACnC,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE5C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,OAAqB,EAAa,EAAE;IACpD,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC5B,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACtB,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YACvB,WAAW,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,8EAA8E;AAC9E,SAAS,aAAa,CAAC,KAAyB;IAC5C,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,CAAC,UAAU,YAAG,KAAK,CAAC,QAAQ,GAAyB,CAAC;AACpG,CAAC;AAED,2GAA2G;AAC3G,SAAS,QAAQ;IACb,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,OAAO,OAAO,CACV,GAAG,EAAE,CAAC,CAAC;QACH,IAAI,EAAE,CAAC,OAAsB,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACxC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEpC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE;YACb,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QACrC,CAAC;KACJ,CAAC,EACF,CAAC,UAAU,CAAC,CACf,CAAC;AACN,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC","sourcesContent":["import type { ReactNode, RefObject } from \"react\";\nimport * as Adw from \"@gtkx/gi/adw\";\nimport { createContext, useContext, useMemo } from \"react\";\nimport type { ToastController, ToastOptions, ToastProviderProps } from \"./types.js\";\n\ntype OverlayRef = RefObject<Adw.ToastOverlay | null>;\n\nconst ToastContext = createContext<OverlayRef | null>(null);\n\nconst useOverlayRef = (): OverlayRef => {\n    const overlayRef = useContext(ToastContext);\n\n    if (overlayRef === null) {\n        throw new Error(\"useToast must be used within a ToastProvider\");\n    }\n\n    return overlayRef;\n};\n\nconst buildToast = (options: ToastOptions): Adw.Toast => {\n    const { onButtonClicked, onDismissed, ...props } = options;\n    const toast = new Adw.Toast(props);\n\n    if (onButtonClicked != null) {\n        toast.on(\"button-clicked\", () => {\n            onButtonClicked(toast);\n        });\n    }\n\n    if (onDismissed != null) {\n        toast.on(\"dismissed\", () => {\n            onDismissed(toast);\n        });\n    }\n\n    return toast;\n};\n\n/** Shares an Adw.ToastOverlay reference with useToast in every descendant. */\nfunction ToastProvider(props: ToastProviderProps): ReactNode {\n    return <ToastContext.Provider value={props.overlayRef}>{props.children}</ToastContext.Provider>;\n}\n\n/** Returns a {@link ToastController} that shows and dismisses toasts on the nearest provider's overlay. */\nfunction useToast(): ToastController {\n    const overlayRef = useOverlayRef();\n\n    return useMemo<ToastController>(\n        () => ({\n            show: (options?: ToastOptions) => {\n                const toast = buildToast(options ?? {});\n                overlayRef.current?.addToast(toast);\n\n                return toast;\n            },\n            dismissAll: () => {\n                overlayRef.current?.dismissAll();\n            },\n        }),\n        [overlayRef],\n    );\n}\n\nexport { ToastProvider, useToast };\n"]}

package/dist/types.d.ts

@@ -1,18 +1,20 @@
 import type * as Adw from "@gtkx/gi/adw";
+import type * as GObject from "@gtkx/gi/gobject";
 import type * as Gtk from "@gtkx/gi/gtk";
 import type { AdwComboRowProps, AdwToastProps } from "@gtkx/jsx/adw";
 import type { GtkColumnViewColumnProps, GtkColumnViewProps, GtkDropDownProps, GtkGridViewProps, GtkListViewProps } from "@gtkx/jsx/gtk";
+import type { Primitive } from "@gtkx/utils";
 import type { ReactNode, RefObject } 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 ListItem<T = unknown> = {
-    /** Stable identifier used to track the item across updates and selection, naming every row that carries it. */
+    /** Stable identifier, unique across the collection, used to preserve identity across updates and selection. */
     id: string;
     /** Payload handed to the cell renderer as `ListItemRenderArgs.item`. */
     value: T;
-    /** Child items nested under this one, which turn a plain item list into a tree, read only as rows are drawn. */
+    /** Child items in an acyclic tree, read only as rows are drawn. */
     children?: ListItem<T>[] | undefined;
     /** Hides the tree expander arrow even when the item has children, through `hide-expander`. */
     shouldHideExpander?: boolean | undefined;
@@ -23,7 +25,7 @@ type ListItem<T = unknown> = {
 };
 /** A group of items rendered under a shared section header. */
 type ListSection<S = unknown, T = unknown> = {
-    /** Stable identifier used to track the section across updates. */
+    /** Stable identifier, unique among sections, used to track the section across updates. */
     id: string;
     /** Payload handed to the section header renderer as `ListSectionRenderArgs.section`. */
     value: S;
@@ -76,6 +78,9 @@ type ItemSizeProps = {
     /** Width in pixels every cell asks for until its contents render; unset lets each cell size itself. */
     estimatedItemWidth?: number | undefined;
 };
+type ListItemFactoryProps<T extends GObject.Object> = ItemSizeProps & {
+    renderItem: ListItemRenderer<T>;
+};
 /** The flat-collection hint shared by {@link ListView} and {@link ColumnView}. */
 type FlatnessProps = {
     /**
@@ -89,8 +94,7 @@ type FlatnessProps = {
 type SelectionProps = {
     /**
      * Ids of the items to keep selected; omitting it keeps nothing selected, and `onSelectionChanged` is how a
-     * user's selection is adopted into it. An id repeated in several branches of a tree names every matching row,
-     * and a single-selection view takes the first of them.
+     * user's selection is adopted into it.
      */
     selectedIds?: string[] | null | undefined;
     /** Called with one id per selected row whenever the selection changes, and once on mount. */
@@ -113,9 +117,7 @@ type ExpanderDescriptions = {
 type ExpansionProps = {
     /**
      * Ids of the items to keep expanded; omitting it keeps every row collapsed, and `onExpandedChange` is how a
-     * user's expansion is adopted into it. An id repeated in several branches names every matching row, so all of
-     * them expand together. An item whose children lead back to itself expands one level at a time, since a row
-     * repeating an item already expanded above it stays collapsed.
+     * user's expansion is adopted into it.
      */
     expandedIds?: string[] | null | undefined;
     /** Called with one id per expanded row, in visible order, whenever expansion changes. */
@@ -137,12 +139,15 @@ type SortProps = {
     onSortChanged?: ((column: string | null, order: Gtk.SortType) => void) | null | undefined;
 };
 /** The data a collection view renders, either as a plain item list or grouped into sections. */
-type SourceProps<T, S> = {
-    /** Items to render, nesting through `ListItem.children` for a tree; ignored once `sections` is given. */
+type SourceProps<T, S> = ({
+    /** Items to render, nesting through `ListItem.children` for a tree. */
     items?: ListItem<T>[] | undefined;
-    /** Items grouped under section headers, rendered in place of `items`. */
-    sections?: ListSection<S, T>[] | undefined;
-};
+} & Partial<Record<"sections", undefined>> & Partial<Record<"renderHeader", null | undefined>>) | ({
+    /** Items grouped under section headers. */
+    sections: ListSection<S, T>[];
+    /** Renders the header shown above each section. */
+    renderHeader?: ListSectionRenderer<S> | null | undefined;
+} & Partial<Record<"items", undefined>>);
 /** One column of a {@link ColumnView}, pairing Gtk.ColumnViewColumn props with a cell renderer. */
 type ColumnViewColumn<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" | "sorter" | "id" | "title"> & {
     /** Stable identifier, also used to address the column through sorting props. */
@@ -160,37 +165,28 @@ type ColumnViewColumn<T = unknown> = Omit<GtkColumnViewColumnProps, "factory" |
 type ColumnViewOwnProps<T, S> = SelectionProps & ExpansionProps & SortProps & SourceProps<T, S> & FlatnessProps & Omit<ItemSizeProps, "estimatedItemWidth"> & {
     /** 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;
     /** Resolves the props of the row carrying one item's cells, such as its screen-reader label. */
     rowProps?: ListRowPropsResolver<T> | null | undefined;
 };
 /**
- * Props for {@link ColumnView}. Combines the underlying Gtk.ColumnView props with
- * declarative collection props: flat items or grouped sections, controlled selection
- * and expansion, sorting (sortColumn, sortOrder, onSortChanged), an optional section
- * header renderer, per-row props, and the columns to render.
+ * Native `Gtk.ColumnView` props with declarative columns and collections, controlled selection, expansion, and sorting.
  */
-type ColumnViewProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "columns" | "model" | "headerFactory" | "rowFactory" | keyof ColumnViewOwnProps<T, S>> & ColumnViewOwnProps<T, S>;
+type ColumnViewProps<T = unknown, S = unknown> = Omit<GtkColumnViewProps, "children" | "columns" | "model" | "headerFactory" | "rowFactory" | 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;
-    /** Renders the collapsed display, and the popup rows too unless `renderListItem` is given. */
+    selectedId?: string | undefined;
+    /** Called with the selected id, or `null` when the model becomes empty. */
+    onSelectionChanged?: ((id: string | null) => void) | null | undefined;
+    /** Renders the collapsed display and, unless overridden, the popup rows. Required for non-primitive values. */
     renderItem?: ListItemRenderer<T> | null | undefined;
     /** Renderer for items in the open popup list, falling back to renderItem when omitted. */
     renderListItem?: ListItemRenderer<T> | null | undefined;
-    /** Renderer for section headers in the popup list. */
-    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>;
+type DropDownWidgetProps<Widget, T, S> = Omit<Widget, "model" | "factory" | "listFactory" | "headerFactory" | keyof DropDownOwnProps<T, S>> & DropDownOwnProps<T, S> & (SourceProps<T & Primitive, S> | Record<"renderItem", ListItemRenderer<T>>);
 /**
- * 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.
+ * Native `Gtk.DropDown` props with declarative collections, controlled selection, and display/popup renderers.
  */
 type DropDownProps<T = unknown, S = unknown> = DropDownWidgetProps<GtkDropDownProps, T, S>;
 /** The declarative collection props {@link GridView} adds on top of Gtk.GridView's own. */
@@ -201,29 +197,21 @@ type GridViewOwnProps<T> = ItemSizeProps & SelectionProps & {
     renderItem: ListItemRenderer<T>;
 };
 /**
- * Props for {@link GridView}. Combines the underlying Gtk.GridView props with
- * declarative collection props: items, a per-cell renderItem, controlled selection,
- * and estimated item sizing.
+ * Native `Gtk.GridView` props with declarative cells, controlled selection, and estimated 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> & FlatnessProps & {
     /** 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
- * 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.
+ * Native `Gtk.ListView` props with declarative rows and sections, controlled selection and expansion,
+ * and estimated sizing.
  */
 type ListViewProps<T = unknown, S = unknown> = Omit<GtkListViewProps, "model" | "factory" | "headerFactory" | keyof ListViewOwnProps<T, S>> & ListViewOwnProps<T, S>;
 /**
- * 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.
+ * Native `Adw.ComboRow` props with declarative collections, controlled selection, and display/popup renderers.
  */
 type ComboRowProps<T = unknown, S = unknown> = DropDownWidgetProps<AdwComboRowProps, T, S>;
 /**
@@ -231,15 +219,10 @@ type ComboRowProps<T = unknown, S = unknown> = DropDownWidgetProps<AdwComboRowPr
  * `Adw.Toast` plus its `button-clicked` and `dismissed` handlers.
  */
 type ToastOptions = Adw.ToastConstructorProps & Pick<AdwToastProps, "onButtonClicked" | "onDismissed">;
-/** Imperative controls for individual toasts, returned by {@link useToast}. */
+/** Imperative controls for toasts, returned by {@link useToast}. */
 type ToastController = {
     /** Builds a toast, shows it through the overlay, and returns it. */
     show: (options?: ToastOptions) => Adw.Toast;
-    /** Dismisses a single toast, typically one returned by `ToastController.show`. */
-    dismiss: (toast: Adw.Toast) => void;
-};
-/** Imperative controls for the overlay as a whole, returned by {@link useToastOverlay}. */
-type ToastOverlayController = {
     /** Dismisses the shown toast and every queued one. */
     dismissAll: () => void;
 };
@@ -247,8 +230,8 @@ 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. */
+    /** Subtree whose `useToast` calls target that overlay. */
     children?: ReactNode | undefined;
 };
-export { type SelectionProps, type ExpanderDescriptions, type ExpansionProps, type SortProps, type DropDownOwnProps, type ListItem, type ListSection, type ListItemRenderArgs, type ListRowProps, type ListSectionRenderArgs, type ListItemRenderer, type ListRowPropsResolver, type ListSectionRenderer, type ColumnViewColumn, type ColumnViewProps, type DropDownProps, type GridViewProps, type ListViewProps, type ComboRowProps, type ToastOptions, type ToastController, type ToastOverlayController, type ToastProviderProps, };
+export { type SelectionProps, type ExpanderDescriptions, type ExpansionProps, type SortProps, type DropDownOwnProps, type ListItem, type ListSection, type ListItemRenderArgs, type ListRowProps, type ListSectionRenderArgs, type ListItemRenderer, type ListItemFactoryProps, type ListRowPropsResolver, type ListSectionRenderer, type ColumnViewColumn, type ColumnViewProps, type DropDownProps, type GridViewProps, type ListViewProps, type ComboRowProps, type ToastOptions, type ToastController, type ToastProviderProps, };
 //# 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":"AAqTA,OAAO,EAwBN,CAAC","sourcesContent":["import type * as Adw from \"@gtkx/gi/adw\";\nimport type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { AdwComboRowProps, AdwToastProps } from \"@gtkx/jsx/adw\";\nimport type {\n    GtkColumnViewColumnProps,\n    GtkColumnViewProps,\n    GtkDropDownProps,\n    GtkGridViewProps,\n    GtkListViewProps,\n} from \"@gtkx/jsx/gtk\";\nimport type { ReactNode, RefObject } 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, naming every row that carries it. */\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, read only as rows are drawn. */\n    children?: ListItem<T>[] | undefined;\n    /** Hides the tree expander arrow even when the item has children, through `hide-expander`. */\n    shouldHideExpander?: boolean | undefined;\n    /** Adds indentation matching the item's depth in the tree, through `indent-for-depth`. */\n    shouldIndentForDepth?: boolean | undefined;\n    /** Reserves indentation space for an expander icon, through `indent-for-icon`. */\n    shouldIndentForIcon?: 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/**\n * Properties applied to the row that carries one item's cells. A Gtk.ColumnViewRow is not a widget, so\n * these are the only handles it offers; anything omitted falls back to the row's own default, which\n * leaves the accessibility strings unset rather than setting them to an empty string.\n */\ntype ListRowProps = {\n    /** Name a screen reader announces for the row, through `accessible-label`. */\n    accessibleLabel?: string | undefined;\n    /** Longer description a screen reader announces for the row, through `accessible-description`. */\n    accessibleDescription?: string | undefined;\n    /** Whether activating the row emits the view's `activate` signal; rows are activatable by default. */\n    isActivatable?: boolean | undefined;\n    /** Whether the row takes keyboard focus; rows are focusable by default. */\n    isFocusable?: boolean | undefined;\n    /** Whether clicking or keying the row tries to select it; rows are selectable by default. */\n    isSelectable?: 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/** Returns the {@link ListRowProps} to apply to the row displaying one item, re-run whenever the item renders. */\ntype ListRowPropsResolver<T> = (args: ListItemRenderArgs<T>) => ListRowProps;\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/** The flat-collection hint shared by {@link ListView} and {@link ColumnView}. */\ntype FlatnessProps = {\n    /**\n     * Declares every item a leaf, so the view skips tree discovery when synchronising a large collection\n     * instead of scanning each item for `children`. Must not be set when any item has children: those\n     * items would render as plain rows that never expand.\n     */\n    isFlat?: boolean | undefined;\n};\n\n/** Controlled selection shared by the multi-item collection views. */\ntype SelectionProps = {\n    /**\n     * Ids of the items to keep selected; omitting it keeps nothing selected, and `onSelectionChanged` is how a\n     * user's selection is adopted into it. An id repeated in several branches of a tree names every matching row,\n     * and a single-selection view takes the first of them.\n     */\n    selectedIds?: string[] | null | undefined;\n    /** Called with one id per selected row 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/**\n * Wording a screen reader announces for the control that expands and collapses a row. GTK names that control\n * after the row's own content and reports whether it is expanded, but says nothing about what activating it\n * does, so these strings supply that and belong in the application's own language.\n */\ntype ExpanderDescriptions = {\n    /** Announced while the row is collapsed, such as \"Expand\". */\n    expand: string;\n    /** Announced while the row is expanded, such as \"Collapse\". */\n    collapse: string;\n};\n\n/** Controlled expansion for the views that turn nested `ListItem.children` into a tree. */\ntype ExpansionProps = {\n    /**\n     * Ids of the items to keep expanded; omitting it keeps every row collapsed, and `onExpandedChange` is how a\n     * user's expansion is adopted into it. An id repeated in several branches names every matching row, so all of\n     * them expand together. An item whose children lead back to itself expands one level at a time, since a row\n     * repeating an item already expanded above it stays collapsed.\n     */\n    expandedIds?: string[] | null | undefined;\n    /** Called with one id per expanded row, in visible order, whenever expansion changes. */\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n    /**\n     * Wording announced for the expander of every row that can expand, describing what activating it does.\n     * Omitting it leaves those expanders described only by the row they carry, and rows that cannot expand or\n     * that hide their expander are never described.\n     */\n    expanderDescriptions?: ExpanderDescriptions | null | undefined;\n};\n\n/** Controlled sorting for the views whose headers can sort the collection. */\ntype SortProps = {\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/** 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    SortProps &\n    SourceProps<T, S> &\n    FlatnessProps &\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        /** Resolves the props of the row carrying one item's cells, such as its screen-reader label. */\n        rowProps?: ListRowPropsResolver<T> | 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, per-row props, and the columns to render.\n */\ntype ColumnViewProps<T = unknown, S = unknown> = Omit<\n    GtkColumnViewProps,\n    \"columns\" | \"model\" | \"headerFactory\" | \"rowFactory\" | 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    FlatnessProps & {\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\n/**\n * Props for {@link ComboRow}. Combines the underlying Adw.ComboRow props with the declarative\n * collection props: flat items or grouped sections, controlled single selection, and renderers\n * for the row display, popup rows, and popup section headers.\n */\ntype ComboRowProps<T = unknown, S = unknown> = DropDownWidgetProps<AdwComboRowProps, T, S>;\n/**\n * Describes a toast raised through {@link useToast}: the construct-time properties of an\n * `Adw.Toast` plus its `button-clicked` and `dismissed` handlers.\n */\ntype ToastOptions = Adw.ToastConstructorProps & Pick<AdwToastProps, \"onButtonClicked\" | \"onDismissed\">;\n\n/** Imperative controls for individual toasts, returned by {@link useToast}. */\ntype ToastController = {\n    /** Builds a toast, shows it through the overlay, and returns it. */\n    show: (options?: ToastOptions) => Adw.Toast;\n    /** Dismisses a single toast, typically one returned by `ToastController.show`. */\n    dismiss: (toast: Adw.Toast) => void;\n};\n\n/** Imperative controls for the overlay as a whole, returned by {@link useToastOverlay}. */\ntype ToastOverlayController = {\n    /** Dismisses the shown toast and every queued one. */\n    dismissAll: () => void;\n};\n\n/** Props for {@link ToastProvider}. */\ntype ToastProviderProps = {\n    /** Ref also given to the `AdwToastOverlay` the toasts appear over. */\n    overlayRef: RefObject<Adw.ToastOverlay | null>;\n    /** Subtree whose `useToast` and `useToastOverlay` calls target that overlay. */\n    children?: ReactNode | undefined;\n};\n\nexport {\n    type SelectionProps,\n    type ExpanderDescriptions,\n    type ExpansionProps,\n    type SortProps,\n    type DropDownOwnProps,\n    type ListItem,\n    type ListSection,\n    type ListItemRenderArgs,\n    type ListRowProps,\n    type ListSectionRenderArgs,\n    type ListItemRenderer,\n    type ListRowPropsResolver,\n    type ListSectionRenderer,\n    type ColumnViewColumn,\n    type ColumnViewProps,\n    type DropDownProps,\n    type GridViewProps,\n    type ListViewProps,\n    type ComboRowProps,\n    type ToastOptions,\n    type ToastController,\n    type ToastOverlayController,\n    type ToastProviderProps,\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqSA,OAAO,EAwBN,CAAC","sourcesContent":["import type * as Adw from \"@gtkx/gi/adw\";\nimport type * as GObject from \"@gtkx/gi/gobject\";\nimport type * as Gtk from \"@gtkx/gi/gtk\";\nimport type { AdwComboRowProps, AdwToastProps } from \"@gtkx/jsx/adw\";\nimport type {\n    GtkColumnViewColumnProps,\n    GtkColumnViewProps,\n    GtkDropDownProps,\n    GtkGridViewProps,\n    GtkListViewProps,\n} from \"@gtkx/jsx/gtk\";\nimport type { Primitive } from \"@gtkx/utils\";\nimport type { ReactNode, RefObject } 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, unique across the collection, used to preserve identity across updates and selection. */\n    id: string;\n    /** Payload handed to the cell renderer as `ListItemRenderArgs.item`. */\n    value: T;\n    /** Child items in an acyclic tree, read only as rows are drawn. */\n    children?: ListItem<T>[] | undefined;\n    /** Hides the tree expander arrow even when the item has children, through `hide-expander`. */\n    shouldHideExpander?: boolean | undefined;\n    /** Adds indentation matching the item's depth in the tree, through `indent-for-depth`. */\n    shouldIndentForDepth?: boolean | undefined;\n    /** Reserves indentation space for an expander icon, through `indent-for-icon`. */\n    shouldIndentForIcon?: boolean | undefined;\n};\n\n/** A group of items rendered under a shared section header. */\ntype ListSection<S = unknown, T = unknown> = {\n    /** Stable identifier, unique among sections, 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/**\n * Properties applied to the row that carries one item's cells. A Gtk.ColumnViewRow is not a widget, so\n * these are the only handles it offers; anything omitted falls back to the row's own default, which\n * leaves the accessibility strings unset rather than setting them to an empty string.\n */\ntype ListRowProps = {\n    /** Name a screen reader announces for the row, through `accessible-label`. */\n    accessibleLabel?: string | undefined;\n    /** Longer description a screen reader announces for the row, through `accessible-description`. */\n    accessibleDescription?: string | undefined;\n    /** Whether activating the row emits the view's `activate` signal; rows are activatable by default. */\n    isActivatable?: boolean | undefined;\n    /** Whether the row takes keyboard focus; rows are focusable by default. */\n    isFocusable?: boolean | undefined;\n    /** Whether clicking or keying the row tries to select it; rows are selectable by default. */\n    isSelectable?: 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/** Returns the {@link ListRowProps} to apply to the row displaying one item, re-run whenever the item renders. */\ntype ListRowPropsResolver<T> = (args: ListItemRenderArgs<T>) => ListRowProps;\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\ntype ListItemFactoryProps<T extends GObject.Object> = ItemSizeProps & {\n    renderItem: ListItemRenderer<T>;\n};\n\n/** The flat-collection hint shared by {@link ListView} and {@link ColumnView}. */\ntype FlatnessProps = {\n    /**\n     * Declares every item a leaf, so the view skips tree discovery when synchronising a large collection\n     * instead of scanning each item for `children`. Must not be set when any item has children: those\n     * items would render as plain rows that never expand.\n     */\n    isFlat?: boolean | undefined;\n};\n\n/** Controlled selection shared by the multi-item collection views. */\ntype SelectionProps = {\n    /**\n     * Ids of the items to keep selected; omitting it keeps nothing selected, and `onSelectionChanged` is how a\n     * user's selection is adopted into it.\n     */\n    selectedIds?: string[] | null | undefined;\n    /** Called with one id per selected row 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/**\n * Wording a screen reader announces for the control that expands and collapses a row. GTK names that control\n * after the row's own content and reports whether it is expanded, but says nothing about what activating it\n * does, so these strings supply that and belong in the application's own language.\n */\ntype ExpanderDescriptions = {\n    /** Announced while the row is collapsed, such as \"Expand\". */\n    expand: string;\n    /** Announced while the row is expanded, such as \"Collapse\". */\n    collapse: string;\n};\n\n/** Controlled expansion for the views that turn nested `ListItem.children` into a tree. */\ntype ExpansionProps = {\n    /**\n     * Ids of the items to keep expanded; omitting it keeps every row collapsed, and `onExpandedChange` is how a\n     * user's expansion is adopted into it.\n     */\n    expandedIds?: string[] | null | undefined;\n    /** Called with one id per expanded row, in visible order, whenever expansion changes. */\n    onExpandedChange?: ((ids: string[]) => void) | null | undefined;\n    /**\n     * Wording announced for the expander of every row that can expand, describing what activating it does.\n     * Omitting it leaves those expanders described only by the row they carry, and rows that cannot expand or\n     * that hide their expander are never described.\n     */\n    expanderDescriptions?: ExpanderDescriptions | null | undefined;\n};\n\n/** Controlled sorting for the views whose headers can sort the collection. */\ntype SortProps = {\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/** 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. */\n    items?: ListItem<T>[] | undefined;\n} & Partial<Record<\"sections\", undefined>> & Partial<Record<\"renderHeader\", null | undefined>>) | ({\n    /** Items grouped under section headers. */\n    sections: ListSection<S, T>[];\n    /** Renders the header shown above each section. */\n    renderHeader?: ListSectionRenderer<S> | null | undefined;\n} & Partial<Record<\"items\", undefined>>);\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    SortProps &\n    SourceProps<T, S> &\n    FlatnessProps &\n    Omit<ItemSizeProps, \"estimatedItemWidth\"> & {\n        /** Columns to render, in order; each carries its own cell renderer. */\n        columns: ColumnViewColumn<T>[];\n        /** Resolves the props of the row carrying one item's cells, such as its screen-reader label. */\n        rowProps?: ListRowPropsResolver<T> | null | undefined;\n    };\n\n/**\n * Native `Gtk.ColumnView` props with declarative columns and collections, controlled selection, expansion, and sorting.\n */\ntype ColumnViewProps<T = unknown, S = unknown> = Omit<\n    GtkColumnViewProps,\n    \"children\" | \"columns\" | \"model\" | \"headerFactory\" | \"rowFactory\" | 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 | undefined;\n    /** Called with the selected id, or `null` when the model becomes empty. */\n    onSelectionChanged?: ((id: string | null) => void) | null | undefined;\n    /** Renders the collapsed display and, unless overridden, the popup rows. Required for non-primitive values. */\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};\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(SourceProps<T & Primitive, S> | Record<\"renderItem\", ListItemRenderer<T>>);\n\n/**\n * Native `Gtk.DropDown` props with declarative collections, controlled selection, and display/popup renderers.\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 * Native `Gtk.GridView` props with declarative cells, controlled selection, and estimated 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    FlatnessProps & {\n        /** Renders the contents of one row. */\n        renderItem: ListItemRenderer<T>;\n    };\n\n/**\n * Native `Gtk.ListView` props with declarative rows and sections, controlled selection and expansion,\n * and estimated 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/**\n * Native `Adw.ComboRow` props with declarative collections, controlled selection, and display/popup renderers.\n */\ntype ComboRowProps<T = unknown, S = unknown> = DropDownWidgetProps<AdwComboRowProps, T, S>;\n/**\n * Describes a toast raised through {@link useToast}: the construct-time properties of an\n * `Adw.Toast` plus its `button-clicked` and `dismissed` handlers.\n */\ntype ToastOptions = Adw.ToastConstructorProps & Pick<AdwToastProps, \"onButtonClicked\" | \"onDismissed\">;\n\n/** Imperative controls for toasts, returned by {@link useToast}. */\ntype ToastController = {\n    /** Builds a toast, shows it through the overlay, and returns it. */\n    show: (options?: ToastOptions) => Adw.Toast;\n    /** Dismisses the shown toast and every queued one. */\n    dismissAll: () => void;\n};\n\n/** Props for {@link ToastProvider}. */\ntype ToastProviderProps = {\n    /** Ref also given to the `AdwToastOverlay` the toasts appear over. */\n    overlayRef: RefObject<Adw.ToastOverlay | null>;\n    /** Subtree whose `useToast` calls target that overlay. */\n    children?: ReactNode | undefined;\n};\n\nexport {\n    type SelectionProps,\n    type ExpanderDescriptions,\n    type ExpansionProps,\n    type SortProps,\n    type DropDownOwnProps,\n    type ListItem,\n    type ListSection,\n    type ListItemRenderArgs,\n    type ListRowProps,\n    type ListSectionRenderArgs,\n    type ListItemRenderer,\n    type ListItemFactoryProps,\n    type ListRowPropsResolver,\n    type ListSectionRenderer,\n    type ColumnViewColumn,\n    type ColumnViewProps,\n    type DropDownProps,\n    type GridViewProps,\n    type ListViewProps,\n    type ComboRowProps,\n    type ToastOptions,\n    type ToastController,\n    type ToastProviderProps,\n};\n"]}