feat(timesheet): improve inline edit autosave

src/locales/en.ts

@@ -701,6 +701,10 @@ export const en = {
     noProjectsFoundLabel: "No projects found.",
     deletedProjectLabel: "Deleted project",
     deletedTagLabel: "Deleted tag",
+    startRequiredError: "Start date and time are required.",
+    endRequiredError: "End date and time must both be filled.",
+    invalidEndTimeError: "End time is invalid.",
+    endBeforeStartError: "End must be after start.",
   },
 
   reports: {

src/locales/fa.ts

@@ -698,6 +698,10 @@ export const fa = {
     noProjectsFoundLabel: "پروژه‌ای پیدا نشد.",
     deletedProjectLabel: "پروژه حذف‌شده",
     deletedTagLabel: "تگ حذف‌شده",
+    startRequiredError: "تاریخ و زمان شروع الزامی است.",
+    endRequiredError: "تاریخ و زمان پایان باید هر دو وارد شوند.",
+    invalidEndTimeError: "زمان پایان معتبر نیست.",
+    endBeforeStartError: "پایان باید بعد از شروع باشد.",
   },
   reports: {
     title: "گزارش‌ها",

src/pages/Timesheet.tsx

@@ -152,6 +152,18 @@ const handleFormattedTimeInputChange = (
   });
 };
 
+const selectTimeSegment = (input: HTMLInputElement) => {
+  const cursor = input.selectionStart ?? 0;
+  const start = cursor <= 2 ? 0 : cursor <= 5 ? 3 : 6;
+  const end = start + 2;
+
+  window.requestAnimationFrame(() => {
+    if (document.activeElement === input) {
+      input.setSelectionRange(start, end);
+    }
+  });
+};
+
 const isValidTimeValue = (value: string) => {
   if (!/^\d{2}:\d{2}:\d{2}$/.test(value)) return false;
   const [hours, minutes, seconds] = value.split(":").map(Number);
@@ -447,23 +459,34 @@ const toggleTagId = (currentTags: string[], tagId: string) =>
 
 const buildPayloadFromState = (
   state: EntryFormState,
-  options: { includeWorkspace: boolean; workspaceId?: string },
+  options: { includeWorkspace: boolean; workspaceId?: string; messages?: Partial<Record<"startRequired" | "endRequired" | "invalidEndTime" | "endBeforeStart", string>> },
 ): { payload?: TimeEntryPayload; error?: string } => {
+  const messages = {
+    startRequired: "Start date and time are required.",
+    endRequired: "End date and time must both be filled.",
+    invalidEndTime: "End time is invalid.",
+    endBeforeStart: "End must be after start.",
+    ...options.messages,
+  };
   const startDateTime = combineDateAndTime(state.startDate, state.startTime);
   if (!startDateTime) {
-    return { error: "Start date and time are required." };
+    return { error: messages.startRequired };
   }
 
   let endDateTime: string | null = null;
   const hasEndValue = Boolean(state.endDate || state.endTime);
   if (hasEndValue) {
     if (!state.endDate || !state.endTime) {
-      return { error: "End date and time must both be filled." };
+      return { error: messages.endRequired };
     }
 
     endDateTime = combineDateAndTime(state.endDate, state.endTime);
     if (!endDateTime) {
-      return { error: "End time is invalid." };
+      return { error: messages.invalidEndTime };
+    }
+
+    if (new Date(endDateTime).getTime() <= new Date(startDateTime).getTime()) {
+      return { error: messages.endBeforeStart };
     }
   }
 
@@ -605,12 +628,14 @@ function TimeField({
   label,
   value,
   onChange,
+  onBlur,
   placeholder,
   compact = false,
 }: {
   label: string;
   value: string;
   onChange: (value: string) => void;
+  onBlur?: () => void;
   placeholder?: string;
   compact?: boolean;
 }) {
@@ -626,6 +651,9 @@ function TimeField({
         placeholder={placeholder || "HH:MM:SS"}
         className={compact ? "h-9 px-2 text-xs" : ""}
         onChange={(event) => handleFormattedTimeInputChange(event, onChange)}
+        onFocus={(event) => selectTimeSegment(event.currentTarget)}
+        onClick={(event) => selectTimeSegment(event.currentTarget)}
+        onBlur={onBlur}
       />
     </div>
   );
@@ -670,6 +698,7 @@ function TagMultiSelect({
   onToggleTag,
   emptyHint,
   title,
+  onDropdownClose,
   compact = false,
   portalOwnerId,
   className = "",
@@ -681,6 +710,7 @@ function TagMultiSelect({
   onToggleTag: (tagId: string) => void;
   emptyHint: string;
   title: string;
+  onDropdownClose?: () => void;
   compact?: boolean;
   portalOwnerId?: string;
   className?: string;
@@ -692,6 +722,7 @@ function TagMultiSelect({
   const wrapperRef = useRef<HTMLDivElement>(null);
   const buttonRef = useRef<HTMLButtonElement>(null);
   const dropdownRef = useRef<HTMLDivElement>(null);
+  const wasOpenRef = useRef(false);
   const [dropdownStyle, setDropdownStyle] = useState<React.CSSProperties>({});
 
   useEffect(() => {
@@ -741,6 +772,13 @@ function TagMultiSelect({
     };
   }, [isOpen]);
 
+  useEffect(() => {
+    if (wasOpenRef.current && !isOpen) {
+      onDropdownClose?.();
+    }
+    wasOpenRef.current = isOpen;
+  }, [isOpen, onDropdownClose]);
+
   useEffect(() => {
     if (!isOpen) {
       setSearchQuery("");
@@ -1072,12 +1110,14 @@ function CompactDateTimeField({
   timeValue,
   onDateChange,
   onTimeChange,
+  onTimeBlur,
 }: {
   label: string;
   dateValue: string;
   timeValue: string;
   onDateChange: (value: string) => void;
   onTimeChange: (value: string) => void;
+  onTimeBlur?: () => void;
 }) {
   return (
     <div className="min-w-[208px]">
@@ -1100,6 +1140,9 @@ function CompactDateTimeField({
           placeholder="HH:MM:SS"
           className="h-9 min-w-[88px] border-0 bg-transparent px-2 text-xs shadow-none focus-visible:ring-0 focus-visible:ring-offset-0"
           onChange={(event) => onTimeChange(formatTimeInputValue(event.target.value))}
+          onFocus={(event) => selectTimeSegment(event.currentTarget)}
+          onClick={(event) => selectTimeSegment(event.currentTarget)}
+          onBlur={onTimeBlur}
         />
       </div>
     </div>
@@ -1111,11 +1154,15 @@ function InlineTimeRangeField({
   endTime,
   onStartTimeChange,
   onEndTimeChange,
+  onStartTimeBlur,
+  onEndTimeBlur,
 }: {
   startTime: string;
   endTime: string;
   onStartTimeChange: (value: string) => void;
   onEndTimeChange: (value: string) => void;
+  onStartTimeBlur?: () => void;
+  onEndTimeBlur?: () => void;
 }) {
   return (
     <div className="flex h-12 items-center justify-center border-s border-slate-200 px-2 text-xs text-slate-600 dark:border-slate-800 dark:text-slate-200">
@@ -1128,6 +1175,9 @@ function InlineTimeRangeField({
         placeholder="HH:MM:SS"
         className="h-9 min-w-[68px] border-0 bg-transparent dark:bg-transparent px-0 text-center text-xs shadow-none focus-visible:ring-0 focus-visible:ring-offset-0"
         onChange={(event) => handleFormattedTimeInputChange(event, onStartTimeChange)}
+        onFocus={(event) => selectTimeSegment(event.currentTarget)}
+        onClick={(event) => selectTimeSegment(event.currentTarget)}
+        onBlur={onStartTimeBlur}
       />
       <span className="px-1 text-slate-400">-</span>
       <Input
@@ -1139,6 +1189,9 @@ function InlineTimeRangeField({
         placeholder="HH:MM:SS"
         className="h-9 min-w-[68px] border-0 bg-transparent dark:bg-transparent px-0 text-center text-xs shadow-none focus-visible:ring-0 focus-visible:ring-offset-0"
         onChange={(event) => handleFormattedTimeInputChange(event, onEndTimeChange)}
+        onFocus={(event) => selectTimeSegment(event.currentTarget)}
+        onClick={(event) => selectTimeSegment(event.currentTarget)}
+        onBlur={onEndTimeBlur}
       />
     </div>
   );
@@ -1149,12 +1202,14 @@ function DateRangePopover({
   endDate,
   onStartDateChange,
   onEndDateChange,
+  onCommit,
   portalOwnerId,
 }: {
   startDate: string;
   endDate: string;
   onStartDateChange: (value: string) => void;
   onEndDateChange: (value: string) => void;
+  onCommit?: () => void;
   portalOwnerId?: string;
 }) {
   const [isOpen, setIsOpen] = useState(false);
@@ -1219,8 +1274,22 @@ function DateRangePopover({
             className="rounded-2xl border border-slate-200 bg-white p-3 shadow-xl dark:border-slate-700 dark:bg-slate-950"
           >
             <div className="grid gap-3">
-              <JalaliDatePicker label="Start date" value={startDate} onChange={onStartDateChange} />
-              <JalaliDatePicker label="End date" value={endDate} onChange={onEndDateChange} />
+              <JalaliDatePicker
+                label="Start date"
+                value={startDate}
+                onChange={(value) => {
+                  onStartDateChange(value);
+                  window.setTimeout(() => onCommit?.(), 0);
+                }}
+              />
+              <JalaliDatePicker
+                label="End date"
+                value={endDate}
+                onChange={(value) => {
+                  onEndDateChange(value);
+                  window.setTimeout(() => onCommit?.(), 0);
+                }}
+              />
             </div>
           </div>,
           document.body,
@@ -1251,6 +1320,7 @@ function EntryEditorFields({
   onChange,
   onToggleTag,
   onProjectChange,
+  onCommit,
   projects,
   tags,
   t,
@@ -1259,9 +1329,10 @@ function EntryEditorFields({
   portalOwnerId,
 }: {
   state: EntryFormState;
-  onChange: (patch: Partial<EntryFormState>) => void;
+  onChange: (patch: Partial<EntryFormState>, saveMode?: "none" | "immediate" | "debounce") => void;
   onToggleTag: (tagId: string) => void;
   onProjectChange?: (projectId: string) => void;
+  onCommit?: () => void;
   projects: Project[];
   tags: Tag[];
   t: any;
@@ -1276,7 +1347,9 @@ function EntryEditorFields({
         <div className="flex min-w-0 items-center">
           <Input
             value={state.description}
-            onChange={(event) => onChange({ description: event.target.value })}
+            onChange={(event) => {
+              onChange({ description: event.target.value }, "debounce");
+            }}
             placeholder={t.timesheet?.descriptionPlaceholder || "What are you working on?"}
             className="h-12 w-[200px] 2xl:w-[400px] shrink-0 rounded-none border-0 bg-transparent px-0 pe-3 text-sm shadow-none placeholder:text-slate-300 focus-visible:ring-0 focus-visible:ring-offset-0 truncate dark:bg-transparent dark:text-slate-100 dark:placeholder:text-slate-600"
           />
@@ -1288,7 +1361,7 @@ function EntryEditorFields({
               <ProjectInlineSelect
                 projects={projects}
                 value={state.projectId}
-                onChange={(projectId) => (onProjectChange ? onProjectChange(projectId) : onChange({ projectId }))}
+                onChange={(projectId) => (onProjectChange ? onProjectChange(projectId) : onChange({ projectId }, "immediate"))}
                 placeholder={t.timesheet?.projectLabel || "Project"}
                 searchPlaceholder={t.timesheet?.searchProjectsLabel || t.projects?.searchPlaceholder || "Search projects..."}
                 emptyLabel={t.timesheet?.noProjectsFoundLabel || "No projects found."}
@@ -1317,13 +1390,14 @@ function EntryEditorFields({
             portalOwnerId={portalOwnerId}
             className="w-full min-w-0 overflow-hidden 2xl:w-auto 2xl:max-w-none"
             buttonClassName="w-full min-w-0 max-w-full justify-start overflow-hidden 2xl:w-auto 2xl:max-w-none"
+            onDropdownClose={onCommit}
           />
         </div>
 
         <div className="w-10">
           <BillableIconButton
             checked={state.isBillable}
-            onChange={(checked) => onChange({ isBillable: checked })}
+            onChange={(checked) => onChange({ isBillable: checked }, "immediate")}
             label={t.timesheet?.billable || "Billable"}
             compact
           />
@@ -1335,6 +1409,8 @@ function EntryEditorFields({
             endTime={state.endTime}
             onStartTimeChange={(value) => onChange({ startTime: value })}
             onEndTimeChange={(value) => onChange({ endTime: value })}
+            onStartTimeBlur={onCommit}
+            onEndTimeBlur={onCommit}
           />
         </div>
 
@@ -1342,8 +1418,8 @@ function EntryEditorFields({
           <DateRangePopover
             startDate={state.startDate}
             endDate={state.endDate}
-            onStartDateChange={(value) => onChange({ startDate: value })}
-            onEndDateChange={(value) => onChange({ endDate: value })}
+            onStartDateChange={(value) => onChange({ startDate: value }, "immediate")}
+            onEndDateChange={(value) => onChange({ endDate: value }, "immediate")}
             portalOwnerId={portalOwnerId}
           />
         </div>
@@ -1358,8 +1434,10 @@ function EntryEditorFields({
           {t.timesheet?.descriptionLabel || "Description"}
         </label>
         <Input
-          value={state.description}
-          onChange={(event) => onChange({ description: event.target.value })}
+            value={state.description}
+          onChange={(event) => {
+            onChange({ description: event.target.value }, "debounce");
+          }}
           placeholder={t.timesheet?.descriptionPlaceholder || "What are you working on?"}
           className={compact ? "h-9 px-2 text-xs placeholder:text-slate-300 dark:placeholder:text-slate-600" : "placeholder:text-slate-300 dark:placeholder:text-slate-600"}
         />
@@ -1370,8 +1448,10 @@ function EntryEditorFields({
           {t.timesheet?.projectLabel || "Project"}
         </label>
         <SearchableSelect
-          value={state.projectId}
-          onChange={(value) => onChange({ projectId: String(value) })}
+            value={state.projectId}
+            onChange={(value) => {
+            onChange({ projectId: String(value) }, "immediate");
+          }}
           options={[
             { value: "", label: t.timesheet?.noProject || "No project" },
             ...projects.map((project) => ({
@@ -1393,13 +1473,16 @@ function EntryEditorFields({
           <JalaliDatePicker
             label={t.timesheet?.startLabel || "Start"}
             value={state.startDate}
-            onChange={(date) => onChange({ startDate: date })}
+            onChange={(date) => {
+              onChange({ startDate: date }, "immediate");
+            }}
             inputClassName={compact ? "h-9 px-2 text-xs" : undefined}
           />
           <TimeField
             label={t.timesheet?.timeLabel || "Time"}
             value={state.startTime}
             onChange={(value) => onChange({ startTime: value })}
+            onBlur={onCommit}
             compact={compact}
           />
         </div>
@@ -1408,13 +1491,16 @@ function EntryEditorFields({
           <JalaliDatePicker
             label={t.timesheet?.endLabel || "End"}
             value={state.endDate}
-            onChange={(date) => onChange({ endDate: date })}
+            onChange={(date) => {
+              onChange({ endDate: date }, "immediate");
+            }}
             inputClassName={compact ? "h-9 px-2 text-xs" : undefined}
           />
           <TimeField
             label={t.timesheet?.timeLabel || "Time"}
             value={state.endTime}
             onChange={(value) => onChange({ endTime: value })}
+            onBlur={onCommit}
             compact={compact}
           />
         </div>
@@ -1423,7 +1509,9 @@ function EntryEditorFields({
       <div>
         <BillableIconButton
           checked={state.isBillable}
-          onChange={(checked) => onChange({ isBillable: checked })}
+          onChange={(checked) => {
+            onChange({ isBillable: checked }, "immediate");
+          }}
           label={t.timesheet?.billable || "Billable"}
         />
       </div>
@@ -1432,6 +1520,7 @@ function EntryEditorFields({
         tags={tags}
         selectedTags={state.tags}
         onToggleTag={onToggleTag}
+        onDropdownClose={onCommit}
         emptyHint={t.timesheet?.noTagsHint || "Create tags first from the Tags page."}
         title={t.tags?.title || "Tags"}
         compact={compact}
@@ -1467,6 +1556,7 @@ function RecordedEntryCard({
   const rowRef = useRef<HTMLDivElement>(null);
   const isSavingRef = useRef(false);
   const pendingSignatureRef = useRef<string | null>(null);
+  const descriptionSaveTimeoutRef = useRef<number | null>(null);
   const editorOwnerId = `time-entry-editor-${entry.id}`;
   const timesheetCopy = (t.timesheet as { saveError?: string; saveSuccess?: string }) || {};
   const saveErrorText = timesheetCopy.saveError || "Failed to save time entry";
@@ -1483,6 +1573,10 @@ function RecordedEntryCard({
   );
 
   useEffect(() => {
+    if (descriptionSaveTimeoutRef.current) {
+      window.clearTimeout(descriptionSaveTimeoutRef.current);
+      descriptionSaveTimeoutRef.current = null;
+    }
     const nextDraft = buildEntryFormState(entry);
     const nextSignature = serializeEntryDraft(nextDraft);
     syncedSignatureRef.current = nextSignature;
@@ -1491,14 +1585,27 @@ function RecordedEntryCard({
     setValidationMessage("");
   }, [entry]);
 
+  useEffect(() => () => {
+    if (descriptionSaveTimeoutRef.current) {
+      window.clearTimeout(descriptionSaveTimeoutRef.current);
+    }
+  }, []);
+
   const isInsideEditorContext = useCallback((target: EventTarget | null) => {
     if (!(target instanceof Node)) return false;
     if (rowRef.current?.contains(target)) return true;
     return target instanceof Element && Boolean(target.closest(`[data-entry-editor-owner="${editorOwnerId}"]`));
   }, [editorOwnerId]);
 
-  const commitDraft = useCallback(async () => {
-    const currentSignature = serializeEntryDraft(draft);
+  const validationMessages = useMemo(() => ({
+    startRequired: t.timesheet?.startRequiredError || "Start date and time are required.",
+    endRequired: t.timesheet?.endRequiredError || "End date and time must both be filled.",
+    invalidEndTime: t.timesheet?.invalidEndTimeError || "End time is invalid.",
+    endBeforeStart: t.timesheet?.endBeforeStartError || "End must be after start.",
+  }), [t.timesheet]);
+
+  const commitDraftState = useCallback(async (nextDraft: EntryFormState) => {
+    const currentSignature = serializeEntryDraft(nextDraft);
     if (currentSignature === syncedSignatureRef.current) {
       setValidationMessage("");
       return false;
@@ -1508,7 +1615,7 @@ function RecordedEntryCard({
       return false;
     }
 
-    const { payload, error } = buildPayloadFromState(draft, { includeWorkspace: false });
+    const { payload, error } = buildPayloadFromState(nextDraft, { includeWorkspace: false, messages: validationMessages });
     if (!payload) {
       setValidationMessage(error || "");
       return false;
@@ -1530,56 +1637,40 @@ function RecordedEntryCard({
     } catch (error) {
       console.error(error);
       pendingSignatureRef.current = null;
-      toast.error(saveErrorText);
+      toast.error(error instanceof Error ? error.message : saveErrorText);
       return false;
     } finally {
       isSavingRef.current = false;
     }
-  }, [draft, entry.id, onEntryUpdated, saveErrorText, saveSuccessText]);
+  }, [entry.id, onEntryUpdated, saveErrorText, saveSuccessText, validationMessages]);
+
+  const commitDraft = useCallback(async () => commitDraftState(draft), [commitDraftState, draft]);
 
   const commitPatchedDraft = useCallback(async (patch: Partial<EntryFormState>) => {
     const nextDraft = { ...draft, ...patch };
-    const nextSignature = serializeEntryDraft(nextDraft);
     setDraft(nextDraft);
+    return commitDraftState(nextDraft);
+  }, [commitDraftState, draft]);
 
-    if (nextSignature === syncedSignatureRef.current) {
-      setValidationMessage("");
-      return false;
-    }
+  const handleDraftChange = useCallback((patch: Partial<EntryFormState>, saveMode: "none" | "immediate" | "debounce" = "none") => {
+    setDraft((current) => {
+      const nextDraft = { ...current, ...patch };
+      if (descriptionSaveTimeoutRef.current) {
+        window.clearTimeout(descriptionSaveTimeoutRef.current);
+        descriptionSaveTimeoutRef.current = null;
+      }
 
-    if (isSavingRef.current || pendingSignatureRef.current === nextSignature) {
-      return false;
-    }
+      if (saveMode === "immediate") {
+        window.setTimeout(() => void commitDraftState(nextDraft), 0);
+      } else if (saveMode === "debounce") {
+        descriptionSaveTimeoutRef.current = window.setTimeout(() => {
+          void commitDraftState(nextDraft);
+        }, 700);
+      }
 
-    const { payload, error } = buildPayloadFromState(nextDraft, { includeWorkspace: false });
-    if (!payload) {
-      setValidationMessage(error || "");
-      return false;
-    }
-
-    setValidationMessage("");
-    isSavingRef.current = true;
-    pendingSignatureRef.current = nextSignature;
-
-    try {
-      const updatedEntry = await updateTimeEntry(entry.id, payload);
-      const updatedDraft = buildEntryFormState(updatedEntry);
-      const updatedSignature = serializeEntryDraft(updatedDraft);
-      syncedSignatureRef.current = updatedSignature;
-      pendingSignatureRef.current = updatedSignature;
-      setDraft(updatedDraft);
-      onEntryUpdated(updatedEntry);
-      toast.success(saveSuccessText);
-      return true;
-    } catch (error) {
-      console.error(error);
-      pendingSignatureRef.current = null;
-      toast.error(saveErrorText);
-      return false;
-    } finally {
-      isSavingRef.current = false;
-    }
-  }, [draft, entry.id, onEntryUpdated, saveErrorText, saveSuccessText]);
+      return nextDraft;
+    });
+  }, [commitDraftState]);
 
   useEffect(() => {
     const handlePointerDown = (event: MouseEvent) => {
@@ -1610,8 +1701,9 @@ function RecordedEntryCard({
         <div className="space-y-4">
           <EntryEditorFields
             state={draft}
-            onChange={(patch) => setDraft((current) => ({ ...current, ...patch }))}
-            onToggleTag={(tagId) => setDraft((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))}
+            onChange={handleDraftChange}
+            onCommit={commitDraft}
+            onToggleTag={(tagId) => handleDraftChange({ tags: toggleTagId(draft.tags, tagId) })}
             onProjectChange={(projectId) => void commitPatchedDraft({ projectId })}
             projects={editorProjects}
             tags={editorTags}
@@ -1660,8 +1752,9 @@ function RecordedEntryCard({
       <div className="flex min-w-0 items-center">
         <EntryEditorFields
           state={draft}
-          onChange={(patch) => setDraft((current) => ({ ...current, ...patch }))}
-          onToggleTag={(tagId) => setDraft((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))}
+          onChange={handleDraftChange}
+          onCommit={commitDraft}
+          onToggleTag={(tagId) => handleDraftChange({ tags: toggleTagId(draft.tags, tagId) })}
           onProjectChange={(projectId) => void commitPatchedDraft({ projectId })}
           projects={editorProjects}
           tags={editorTags}
@@ -1725,8 +1818,11 @@ function MobileRecordedEntryCard({
   const buttonRef = useRef<HTMLButtonElement>(null);
   const dropdownRef = useRef<HTMLDivElement>(null);
   const touchStartXRef = useRef<number | null>(null);
+  const touchStartYRef = useRef<number | null>(null);
+  const touchGestureRef = useRef<"pending" | "swipe" | "scroll">("pending");
   const [menuOpen, setMenuOpen] = useState(false);
   const [swipeOffset, setSwipeOffset] = useState(0);
+  const [touchGesture, setTouchGesture] = useState<"pending" | "swipe" | "scroll">("pending");
   const [menuStyle, setMenuStyle] = useState<React.CSSProperties>({});
 
   useEffect(() => {
@@ -1780,6 +1876,9 @@ function MobileRecordedEntryCard({
 
   const closeSwipe = () => {
     touchStartXRef.current = null;
+    touchStartYRef.current = null;
+    touchGestureRef.current = "pending";
+    setTouchGesture("pending");
     setSwipeOffset(0);
   };
 
@@ -1788,15 +1887,40 @@ function MobileRecordedEntryCard({
       setMenuOpen(false);
     }
     touchStartXRef.current = event.touches[0]?.clientX ?? null;
+    touchStartYRef.current = event.touches[0]?.clientY ?? null;
+    touchGestureRef.current = "pending";
+    setTouchGesture("pending");
   };
 
   const handleTouchMove = (event: React.TouchEvent<HTMLDivElement>) => {
-    if (touchStartXRef.current === null) return;
-    const delta = (event.touches[0]?.clientX ?? 0) - touchStartXRef.current;
-    setSwipeOffset(Math.max(-88, Math.min(88, delta)));
+    if (touchStartXRef.current === null || touchStartYRef.current === null) return;
+    const deltaX = (event.touches[0]?.clientX ?? 0) - touchStartXRef.current;
+    const deltaY = (event.touches[0]?.clientY ?? 0) - touchStartYRef.current;
+    const absX = Math.abs(deltaX);
+    const absY = Math.abs(deltaY);
+
+    if (touchGestureRef.current === "pending" && (absX > 8 || absY > 8)) {
+      touchGestureRef.current = absX > absY + 8 ? "swipe" : "scroll";
+      setTouchGesture(touchGestureRef.current);
+    }
+
+    if (touchGestureRef.current === "scroll") {
+      setSwipeOffset(0);
+      return;
+    }
+
+    if (touchGestureRef.current === "swipe") {
+      event.preventDefault();
+      setSwipeOffset(Math.max(-88, Math.min(88, deltaX)));
+    }
   };
 
   const handleTouchEnd = () => {
+    if (touchGestureRef.current !== "swipe") {
+      closeSwipe();
+      return;
+    }
+
     if (swipeOffset <= -72) {
       closeSwipe();
       onDelete(entry);
@@ -1823,7 +1947,7 @@ function MobileRecordedEntryCard({
 
       <div
         className="relative bg-white px-4 py-5 transition-transform duration-150 ease-out dark:bg-slate-900/95"
-        style={{ transform: `translateX(${swipeOffset}px)` }}
+        style={{ transform: `translateX(${swipeOffset}px)`, touchAction: touchGesture === "swipe" ? "none" : "pan-y" }}
         onTouchStart={handleTouchStart}
         onTouchMove={handleTouchMove}
         onTouchEnd={handleTouchEnd}
@@ -2065,6 +2189,10 @@ export default function Timesheet() {
     noTagsFoundLabel?: string;
     searchProjectsLabel?: string;
     noProjectsFoundLabel?: string;
+    startRequiredError?: string;
+    endRequiredError?: string;
+    invalidEndTimeError?: string;
+    endBeforeStartError?: string;
   }) || {};
 
   const [projects, setProjects] = useState<Project[]>([]);
@@ -2111,6 +2239,7 @@ export default function Timesheet() {
   const timerDraftSignatureRef = useRef(serializeTimerDraft(EMPTY_TIMER_DRAFT));
   const pendingTimerSignatureRef = useRef<string | null>(serializeTimerDraft(EMPTY_TIMER_DRAFT));
   const isTimerSavingRef = useRef(false);
+  const timerDescriptionSaveTimeoutRef = useRef<number | null>(null);
   const timerEditorOwnerId = "running-timer-editor";
 
   const [deleteModal, setDeleteModal] = useState<{ isOpen: boolean; entry: TimeEntry | null }>({
@@ -2149,6 +2278,17 @@ export default function Timesheet() {
     () => buildTagOptionsForEntry(tags, editingEntry, formState.tags),
     [editingEntry, formState.tags, tags],
   );
+  const entryValidationMessages = useMemo(() => ({
+    startRequired: extendedTimesheet.startRequiredError || "Start date and time are required.",
+    endRequired: extendedTimesheet.endRequiredError || "End date and time must both be filled.",
+    invalidEndTime: extendedTimesheet.invalidEndTimeError || "End time is invalid.",
+    endBeforeStart: extendedTimesheet.endBeforeStartError || "End must be after start.",
+  }), [
+    extendedTimesheet.endBeforeStartError,
+    extendedTimesheet.endRequiredError,
+    extendedTimesheet.invalidEndTimeError,
+    extendedTimesheet.startRequiredError,
+  ]);
 
   useEffect(() => {
     if (!runningEntry) return;
@@ -2299,6 +2439,11 @@ export default function Timesheet() {
   }, [loadRunningEntry]);
 
   useEffect(() => {
+    if (timerDescriptionSaveTimeoutRef.current) {
+      window.clearTimeout(timerDescriptionSaveTimeoutRef.current);
+      timerDescriptionSaveTimeoutRef.current = null;
+    }
+
     if (!runningEntry) {
       setTimerClockAnchor(null);
       timerDraftSignatureRef.current = serializeTimerDraft(EMPTY_TIMER_DRAFT);
@@ -2313,19 +2458,25 @@ export default function Timesheet() {
     setTimerDraft(nextDraft);
   }, [runningEntry]);
 
+  useEffect(() => () => {
+    if (timerDescriptionSaveTimeoutRef.current) {
+      window.clearTimeout(timerDescriptionSaveTimeoutRef.current);
+    }
+  }, []);
+
   const isInsideTimerEditorContext = useCallback((target: EventTarget | null) => {
     if (!(target instanceof Node)) return false;
     if (desktopTimerRef.current?.contains(target) || mobileTimerRef.current?.contains(target)) return true;
     return target instanceof Element && Boolean(target.closest(`[data-entry-editor-owner="${timerEditorOwnerId}"]`));
   }, [timerEditorOwnerId]);
 
-  const commitTimerDraft = useCallback(async () => {
+  const commitTimerDraftState = useCallback(async (nextDraft: TimerDraftState) => {
     const saveErrorText = extendedTimesheet.saveError || "Failed to save time entry";
     const saveSuccessText = extendedTimesheet.saveSuccess || "Time entry saved";
 
     if (!runningEntry) return false;
 
-    const currentSignature = serializeTimerDraft(timerDraft);
+    const currentSignature = serializeTimerDraft(nextDraft);
     if (currentSignature === timerDraftSignatureRef.current) {
       return false;
     }
@@ -2339,10 +2490,10 @@ export default function Timesheet() {
 
     try {
       const updatedEntry = await updateTimeEntry(runningEntry.id, {
-        description: timerDraft.description.trim(),
-        project_id: timerDraft.projectId || null,
-        tags: timerDraft.tags,
-        is_billable: timerDraft.isBillable,
+        description: nextDraft.description.trim(),
+        project_id: nextDraft.projectId || null,
+        tags: nextDraft.tags,
+        is_billable: nextDraft.isBillable,
       });
 
       const syncedDraft = buildTimerDraftState(updatedEntry);
@@ -2360,12 +2511,34 @@ export default function Timesheet() {
     } catch (error) {
       console.error(error);
       pendingTimerSignatureRef.current = null;
-      toast.error(saveErrorText);
+      toast.error(error instanceof Error ? error.message : saveErrorText);
       return false;
     } finally {
       isTimerSavingRef.current = false;
     }
-  }, [extendedTimesheet.saveError, extendedTimesheet.saveSuccess, runningEntry, timerDraft]);
+  }, [extendedTimesheet.saveError, extendedTimesheet.saveSuccess, runningEntry]);
+
+  const commitTimerDraft = useCallback(async () => commitTimerDraftState(timerDraft), [commitTimerDraftState, timerDraft]);
+
+  const updateTimerDraft = useCallback((patch: Partial<TimerDraftState>, saveMode: "none" | "immediate" | "debounce" = "none") => {
+    setTimerDraft((current) => {
+      const nextDraft = { ...current, ...patch };
+      if (timerDescriptionSaveTimeoutRef.current) {
+        window.clearTimeout(timerDescriptionSaveTimeoutRef.current);
+        timerDescriptionSaveTimeoutRef.current = null;
+      }
+
+      if (saveMode === "immediate") {
+        window.setTimeout(() => void commitTimerDraftState(nextDraft), 0);
+      } else if (saveMode === "debounce") {
+        timerDescriptionSaveTimeoutRef.current = window.setTimeout(() => {
+          void commitTimerDraftState(nextDraft);
+        }, 700);
+      }
+
+      return nextDraft;
+    });
+  }, [commitTimerDraftState]);
 
   useEffect(() => {
     if (!runningEntry) return;
@@ -2407,12 +2580,14 @@ export default function Timesheet() {
     setFormState(buildEntryFormState(entry));
   };
 
-  const handleSaveEntryModal = async () => {
+  const handleSaveEntryModal = async (event?: React.FormEvent<HTMLFormElement>) => {
+    event?.preventDefault();
     if (modalMode === "manual" && !activeWorkspace?.id) return;
 
     const { payload, error } = buildPayloadFromState(formState, {
       includeWorkspace: modalMode === "manual",
       workspaceId: activeWorkspace?.id,
+      messages: entryValidationMessages,
     });
 
     if (!payload) {
@@ -2438,7 +2613,7 @@ export default function Timesheet() {
       setFormState(EMPTY_FORM);
     } catch (error) {
       console.error(error);
-      toast.error(t.timesheet?.saveError || "Failed to save time entry");
+      toast.error(error instanceof Error ? error.message : (t.timesheet?.saveError || "Failed to save time entry"));
     } finally {
       setIsSaving(false);
     }
@@ -2535,7 +2710,8 @@ export default function Timesheet() {
     setDiscardTimerModal({ isOpen: false, entry: null });
   };
 
-  const confirmDelete = async () => {
+  const confirmDelete = async (event?: React.FormEvent<HTMLFormElement>) => {
+    event?.preventDefault();
     if (!deleteModal.entry) return;
 
     try {
@@ -2567,7 +2743,8 @@ export default function Timesheet() {
     }
   };
 
-  const confirmRestart = async () => {
+  const confirmRestart = async (event?: React.FormEvent<HTMLFormElement>) => {
+    event?.preventDefault();
     if (!restartModal.entry) return;
 
     try {
@@ -2709,7 +2886,7 @@ export default function Timesheet() {
             <Input
             value={timerDraft.description}
             placeholder={t.timesheet?.descriptionPlaceholder || "What are you working on?"}
-            onChange={(event) => setTimerDraft((current) => ({ ...current, description: event.target.value }))}
+            onChange={(event) => updateTimerDraft({ description: event.target.value }, "debounce")}
             disabled={isStartingTimer}
             className="h-12 rounded-none border-0 bg-transparent px-5 text-sm shadow-none placeholder:text-slate-300 focus-visible:ring-0 focus-visible:ring-offset-0 dark:bg-transparent dark:placeholder:text-slate-600"
             />
@@ -2718,7 +2895,7 @@ export default function Timesheet() {
           <div className="flex shrink-0 items-center">
             <SearchableSelect
               value={timerDraft.projectId}
-              onChange={(value) => setTimerDraft((current) => ({ ...current, projectId: String(value) }))}
+              onChange={(value) => updateTimerDraft({ projectId: String(value) }, "immediate")}
               options={[
                 { value: "", label: t.timesheet?.projectLabel || "Project" },
                 ...runningTimerProjects.map((project) => ({
@@ -2740,9 +2917,8 @@ export default function Timesheet() {
             <TagMultiSelect
               tags={runningTimerTags}
               selectedTags={timerDraft.tags}
-              onToggleTag={(tagId) =>
-                setTimerDraft((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))
-              }
+              onToggleTag={(tagId) => updateTimerDraft({ tags: toggleTagId(timerDraft.tags, tagId) })}
+              onDropdownClose={() => void commitTimerDraft()}
               emptyHint={t.timesheet?.noTagsHint || "Create tags first from the Tags page."}
               title={t.tags?.title || "Tags"}
               compact
@@ -2755,7 +2931,7 @@ export default function Timesheet() {
           <div className="flex shrink-0 items-center">
             <BillableIconButton
               checked={timerDraft.isBillable}
-              onChange={(checked) => setTimerDraft((current) => ({ ...current, isBillable: checked }))}
+              onChange={(checked) => updateTimerDraft({ isBillable: checked }, "immediate")}
               label={t.timesheet?.billable || "Billable"}
               disabled={isStartingTimer}
               compact
@@ -2817,7 +2993,7 @@ export default function Timesheet() {
           <Input
             value={timerDraft.description}
             placeholder={t.timesheet?.descriptionPlaceholder || "What are you working on?"}
-            onChange={(event) => setTimerDraft((current) => ({ ...current, description: event.target.value }))}
+            onChange={(event) => updateTimerDraft({ description: event.target.value }, "debounce")}
             disabled={isStartingTimer}
             className="h-10 border-slate-200 bg-slate-50 text-sm placeholder:text-slate-300 dark:border-slate-700 dark:bg-slate-900 dark:placeholder:text-slate-600"
           />
@@ -2825,7 +3001,7 @@ export default function Timesheet() {
           <div className="grid grid-cols-[minmax(0,1fr)_auto] gap-2">
             <SearchableSelect
               value={timerDraft.projectId}
-              onChange={(value) => setTimerDraft((current) => ({ ...current, projectId: String(value) }))}
+              onChange={(value) => updateTimerDraft({ projectId: String(value) }, "immediate")}
               options={[
                 { value: "", label: t.timesheet?.projectLabel || "Project" },
                 ...runningTimerProjects.map((project) => ({
@@ -2852,9 +3028,8 @@ export default function Timesheet() {
               <TagMultiSelect
                 tags={runningTimerTags}
                 selectedTags={timerDraft.tags}
-                onToggleTag={(tagId) =>
-                  setTimerDraft((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))
-                }
+                onToggleTag={(tagId) => updateTimerDraft({ tags: toggleTagId(timerDraft.tags, tagId) })}
+                onDropdownClose={() => void commitTimerDraft()}
                 emptyHint={t.timesheet?.noTagsHint || "Create tags first from the Tags page."}
                 title={t.tags?.title || "Tags"}
                 compact
@@ -2863,7 +3038,7 @@ export default function Timesheet() {
 
               <BillableIconButton
                 checked={timerDraft.isBillable}
-                onChange={(checked) => setTimerDraft((current) => ({ ...current, isBillable: checked }))}
+                onChange={(checked) => updateTimerDraft({ isBillable: checked }, "immediate")}
                 label={t.timesheet?.billable || "Billable"}
                 disabled={isStartingTimer}
                 compact
@@ -3045,21 +3220,23 @@ export default function Timesheet() {
             <Button variant="secondary" onClick={closeCreateModal}>
               {t.actions?.cancel || "Cancel"}
             </Button>
-            <Button onClick={() => void handleSaveEntryModal()} disabled={isSaving}>
+            <Button type="submit" form="time-entry-modal-form" disabled={isSaving}>
               {isSaving ? "..." : (modalMode === "edit" ? (t.save || "Save") : (t.create || "Create"))}
             </Button>
           </>
         }
       >
-        <EntryEditorFields
-          state={formState}
-          onChange={(patch) => setFormState((current) => ({ ...current, ...patch }))}
-          onToggleTag={(tagId) => setFormState((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))}
-          projects={modalProjects}
-          tags={modalTags}
-          t={t}
-          isRtl={isRtl}
-        />
+        <form id="time-entry-modal-form" onSubmit={handleSaveEntryModal}>
+          <EntryEditorFields
+            state={formState}
+            onChange={(patch) => setFormState((current) => ({ ...current, ...patch }))}
+            onToggleTag={(tagId) => setFormState((current) => ({ ...current, tags: toggleTagId(current.tags, tagId) }))}
+            projects={modalProjects}
+            tags={modalTags}
+            t={t}
+            isRtl={isRtl}
+          />
+        </form>
       </Modal>
 
       {deleteModal.entry && (
@@ -3073,13 +3250,13 @@ export default function Timesheet() {
               <Button variant="secondary" onClick={closeDeleteModal}>
                 {t.actions?.cancel || "Cancel"}
               </Button>
-              <Button variant="destructive" onClick={confirmDelete} disabled={isDeleting}>
+              <Button type="submit" form="delete-time-entry-form" variant="destructive" disabled={isDeleting}>
                 {isDeleting ? "..." : (t.actions?.delete || "Delete")}
               </Button>
             </>
           }
         >
-          <div className="space-y-3">
+          <form id="delete-time-entry-form" onSubmit={confirmDelete} className="space-y-3">
             <p className="text-sm leading-relaxed text-slate-600 dark:text-slate-400">
               {extendedTimesheet.deleteConfirmMessage || t.timesheet?.deleteConfirmMessage || "Are you sure you want to delete this time entry?"}
             </p>
@@ -3092,7 +3269,7 @@ export default function Timesheet() {
                 {deleteModal.entry.end_time ? ` - ${formatDateTime(deleteModal.entry.end_time, lang)}` : ""}
               </p>
             </div>
-          </div>
+          </form>
         </Modal>
       )}
 
@@ -3107,13 +3284,13 @@ export default function Timesheet() {
               <Button variant="secondary" onClick={closeRestartModal}>
                 {t.actions?.cancel || "Cancel"}
               </Button>
-              <Button onClick={() => void confirmRestart()} disabled={isRestarting}>
+              <Button type="submit" form="restart-time-entry-form" disabled={isRestarting}>
                 {isRestarting ? "..." : (t.timesheet?.startTimer || "Start")}
               </Button>
             </>
           }
         >
-          <div className="space-y-3">
+          <form id="restart-time-entry-form" onSubmit={confirmRestart} className="space-y-3">
             <p className="text-sm leading-relaxed text-slate-600 dark:text-slate-400">
               {extendedTimesheet.restartConfirmMessage || t.timesheet?.restartConfirmMessage || "Start a new running timer from this entry?"}
             </p>
@@ -3126,7 +3303,7 @@ export default function Timesheet() {
                 {restartModal.entry.end_time ? ` - ${formatDateTime(restartModal.entry.end_time, lang)}` : ""}
               </p>
             </div>
-          </div>
+          </form>
         </Modal>
       )}
 
@@ -3141,13 +3318,20 @@ export default function Timesheet() {
               <Button variant="secondary" onClick={closeDiscardTimerModal}>
                 {t.actions?.cancel || "Cancel"}
               </Button>
-              <Button variant="destructive" onClick={() => void handleDiscardTimerDraft()} disabled={isDiscardingTimer}>
+              <Button type="submit" form="discard-timer-form" variant="destructive" disabled={isDiscardingTimer}>
                 {isDiscardingTimer ? "..." : ((t.actions as { discard?: string } | undefined)?.discard || "Discard")}
               </Button>
             </>
           }
         >
-          <div className="space-y-3">
+          <form
+            id="discard-timer-form"
+            onSubmit={(event) => {
+              event.preventDefault();
+              void handleDiscardTimerDraft();
+            }}
+            className="space-y-3"
+          >
             <p className="text-sm leading-relaxed text-slate-600 dark:text-slate-400">
               {extendedTimesheet.discardConfirmMessage || t.timesheet?.discardConfirmMessage || "Are you sure you want to discard this running timer?"}
             </p>
@@ -3159,7 +3343,7 @@ export default function Timesheet() {
                 {formatDateTime(discardTimerModal.entry.start_time, lang)}
               </p>
             </div>
-          </div>
+          </form>
         </Modal>
       )}