Function EntryToCalendarEvents

plugins/schedule/macro-schedule-tab.cpp:105–158

Returns one CalendarEvent per occurrence of entry within [rangeStart, rangeEnd]. For non-repeating entries this is at most one event. A hard cap of 500 occurrences prevents infinite loops for misconfigured entries.

// For non-repeating entries this is at most one event.
// A hard cap of 500 occurrences prevents infinite loops for misconfigured entries.
static QList<CalendarEvent>
EntryToCalendarEvents(const MacroScheduleEntry &entry, const QDate &rangeStart,
		      const QDate &rangeEnd)
{
	QList<CalendarEvent> result;

	const QDateTime windowStart(rangeStart, QTime(0, 0));
	const QDateTime windowEnd(rangeEnd, QTime(23, 59, 59));

	// Walk occurrences starting from the entry's first trigger time.
	// We use a copy to advance lastTriggered without modifying the real entry.
	MacroScheduleEntry cursor = entry;
	cursor.lastTriggered =
		QDateTime(); // start from the very first occurrence
	cursor.timesTriggered = 0;

	static constexpr int MAX_OCCURRENCES = 500;

	for (int i = 0; i < MAX_OCCURRENCES; ++i) {
		const QDateTime next = cursor.NextTriggerTime();
		if (!next.isValid() || next > windowEnd) {
			break;
		}

		if (next >= windowStart) {
			CalendarEvent ev;
			// Use id + occurrence index to make each event unique
			// while still allowing the tab to look up the parent entry.
			ev.id = QString::fromStdString(entry.id);
			ev.title = entry.GetSummary();
			ev.color = ColorForEntry(entry);
			ev.userData = ev.id;
			ev.start = next;
			if (entry.hasEndDate && entry.endDate.isValid()) {
				ev.end = entry.endDate;
			}
			result.append(ev);
		}

		if (!entry.doesRepeat) {
			break; // one-shot — no more occurrences
		}

		// Advance cursor past this occurrence
		cursor.lastTriggered = next;
		++cursor.timesTriggered;

		if (cursor.IsExpired()) {
			break;
		}
	}

	return result;
}

// ---------------------------------------------------------------------------
// Table columns