From a2e8f985d29dd05348714c8eaff56bb9177f16b2 Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Fri, 27 Feb 2026 22:33:57 -0800
Subject: [PATCH] feat(web): recurring timer badge, recurringTimerId field,
 generateTimerFromRecurrence helper

---
 web/src/components/TimerCard.tsx |  9 ++++++
 web/src/lib/recurrence.ts        | 47 ++++++++++++++++++++++++++++++++
 web/src/lib/timer-engine.ts      |  1 +
 3 files changed, 57 insertions(+)

diff --git a/web/src/components/TimerCard.tsx b/web/src/components/TimerCard.tsx
index 1e4de66..a0982d9 100644
--- a/web/src/components/TimerCard.tsx
+++ b/web/src/components/TimerCard.tsx
@@ -103,6 +103,15 @@ export function TimerCard({ timer }: TimerCardProps) {
               <Tag size={10} /> {timer.category}
             </span>
           )}
+          {timer.recurringTimerId && (
+            <span
+              className="text-xs px-1.5 py-0.5 rounded-full flex items-center gap-0.5"
+              style={{ backgroundColor: 'rgba(46,230,214,0.15)', color: 'var(--cm-accent-secondary)' }}
+              title="Recurring timer"
+            >
+              <Repeat size={10} />
+            </span>
+          )}
           {timer.linkedTimerId && (
             <span
               className="text-xs px-1.5 py-0.5 rounded-full"
diff --git a/web/src/lib/recurrence.ts b/web/src/lib/recurrence.ts
index d87f239..a9887f0 100644
--- a/web/src/lib/recurrence.ts
+++ b/web/src/lib/recurrence.ts
@@ -240,6 +240,53 @@ export function createCustomRule(
   return { frequency: 'custom', daysOfWeek, timeOfDay: timeOfDayMinutes, endDate };
 }
 
+// ── Timer Generation ─────────────────────────────────────────
+
+/**
+ * Generate a Timer from a RecurringTimer for the next occurrence.
+ * The generated timer has `recurringTimerId` set for badge display.
+ */
+export function generateTimerFromRecurrence(
+  recurring: RecurringTimer,
+  label: string,
+  urgency: import('./urgency').UrgencyLevel = 'standard',
+  category?: string,
+): import('./timer-engine').Timer | null {
+  if (recurring.paused) return null;
+
+  const afterDate = recurring.skipNext
+    ? getOccurrenceAfterSkip(recurring.recurrence, recurring.lastOccurrence ?? Date.now())
+    : getNextOccurrence(recurring.recurrence, recurring.lastOccurrence ?? Date.now());
+
+  if (!afterDate) return null;
+
+  const now = Date.now();
+  const id = `${recurring.id}-${afterDate}`;
+
+  return {
+    id,
+    type: 'alarm',
+    label,
+    urgency,
+    state: 'active',
+    targetTime: afterDate,
+    duration: null,
+    createdAt: now,
+    startedAt: now,
+    pausedAt: null,
+    firedAt: null,
+    dismissedAt: null,
+    completedAt: null,
+    elapsedBeforePause: 0,
+    cascade: { preset: 'standard', intervals: [] },
+    warnings: [],
+    snoozeCount: 0,
+    snoozedUntil: null,
+    category,
+    recurringTimerId: recurring.id,
+  };
+}
+
 // ── Display Helpers ───────────────────────────────────────────
 
 /**
diff --git a/web/src/lib/timer-engine.ts b/web/src/lib/timer-engine.ts
index b902d11..b48e522 100644
--- a/web/src/lib/timer-engine.ts
+++ b/web/src/lib/timer-engine.ts
@@ -57,6 +57,7 @@ export interface Timer {
   category?: string;
   tags?: string[];
   linkedTimerId?: string | null;
+  recurringTimerId?: string | null;
 }
 
 export interface PomodoroConfig {