Method renderGroupedVirtual

src/bases/TaskListView.ts:1818–1887

(
		items: TaskListRenderItem[],
		visibleProperties: string[] | undefined,
		cardOptions: TaskCardOptions
	)

	}

	private async renderGroupedVirtual(
		items: TaskListRenderItem[],
		visibleProperties: string[] | undefined,
		cardOptions: TaskCardOptions
	): Promise<void> {
		// Populate group key lookup for cross-group drag detection
		this.syncGroupedDragMetadata(items);

		if (!this.virtualScroller) {
			this.virtualScroller = new VirtualScroller<TaskListVirtualItem>({
				container: this.itemsContainer!,
				items: items,
				// itemHeight omitted - automatically calculated from sample (headers + cards)
				overscan: 5,
				renderItem: (item) => {
					if (!("type" in item)) {
						throw new Error("Unexpected flat task item in grouped renderer");
					}
					if (item.type === "primary-header" || item.type === "sub-header") {
						return this.createGroupHeader(item);
					} else {
						const cardEl = createTaskCard(
							item.task,
							this.plugin,
							visibleProperties,
							cardOptions
						);
						// Attach drag handlers for sort_order reordering
						this.configureCardForManualReordering(cardEl, item.task, item.groupKey);
						this.taskInfoCache.set(item.task.path, item.task);
						this.lastTaskSignatures.set(
							item.task.path,
							this.buildTaskSignature(item.task)
						);
						return cardEl;
					}
				},
				getItemKey: (item) => {
					if (!("type" in item)) {
						return item.path;
					}
					if (item.type === "primary-header") {
						return `primary-${item.groupKey}`;
					} else if (item.type === "sub-header") {
						return `sub-${item.groupKey}:${item.subGroupKey}`;
					} else {
						return item.task.path;
					}
				},
			});

			window.setTimeout(() => {
				this.virtualScroller?.recalculate();
			}, 0);
		} else {
			this.resetVirtualScrollerIfCardRenderChanged(
				this.buildCardRenderSignature(visibleProperties, cardOptions)
			);