Method handleSortOrderDrop

src/bases/TaskListView.ts:1324–1463

(
		draggedPath: string,
		targetPath: string,
		above: boolean,
		targetGroupKey: string | null,
		sourceGroupKey: string | null,
		targetVisiblePaths?: string[]
	)

	}

	private async handleSortOrderDrop(
		draggedPath: string,
		targetPath: string,
		above: boolean,
		targetGroupKey: string | null,
		sourceGroupKey: string | null,
		targetVisiblePaths?: string[]
	): Promise<void> {
		const groupByPropertyId = this.getGroupByPropertyId();
		const reorderScopeKey = this.getReorderScopeQueueKey(targetGroupKey, groupByPropertyId);
		await this.dropQueue.enqueue(reorderScopeKey, async () => {
			const groupDropPlan = buildTaskListGroupDropPlan({
				groupByPropertyId,
				sourceGroupKey,
				targetGroupKey,
				lookupMappingKey: (propertyName) =>
					this.plugin.fieldMapper.lookupMappingKey(propertyName),
				isListTypeProperty: (propertyName) => this.isListTypeProperty(propertyName),
			});

			if (groupDropPlan.isFormulaGrouping) {
				new Notice(
					this.plugin.i18n.translate("views.taskList.errors.formulaGroupingReadOnly")
				);
				return;
			}

			// Compute sort_order first (read-only — no file writes yet)
			const sortOrderPlan = await prepareSortOrderUpdate(
				targetPath,
				above,
				targetGroupKey,
				groupDropPlan.cleanGroupBy,
				draggedPath,
				this.plugin,
				{
					taskInfoCache: this.taskInfoCache,
					visibleTaskPaths:
						targetVisiblePaths ?? this.getVisibleSortScopePaths(targetGroupKey),
					candidateTaskPaths: this.getCandidateSortScopePaths(targetGroupKey),
				}
			);
			if (sortOrderPlan.sortOrder === null) return;

			const totalEditedNotes = sortOrderPlan.additionalWrites.length + 1;
			if (totalEditedNotes > this.LARGE_REORDER_WARNING_THRESHOLD) {
				const confirmed = await this.confirmLargeReorder(totalEditedNotes, targetGroupKey);
				if (!confirmed) return;
			}

			// Determine if we need to write anything
			const needsWrite = groupDropPlan.needsGroupUpdate || sortOrderPlan !== null;
			if (!needsWrite) {
				this.debouncedRefresh();
				return;
			}

			const file = this.plugin.app.vault.getAbstractFileByPath(draggedPath);