@open-mercato/core 0.6.8-develop.6972.1.275e435508 → 0.6.8-develop.6974.1.43440f247a

package/src/modules/staff/backend/staff/timesheets/page.tsx

@@ -3,6 +3,7 @@
 import * as React from 'react'
 import { Page, PageBody } from '@open-mercato/ui/backend/Page'
 import { Button } from '@open-mercato/ui/primitives/button'
+import { InlineInput } from '@open-mercato/ui/primitives/inline-input'
 import { apiCall, apiCallOrThrow, readApiResultOrThrow } from '@open-mercato/ui/backend/utils/apiCall'
 import { useGuardedMutation } from '@open-mercato/ui/backend/injection/useGuardedMutation'
 import { flash } from '@open-mercato/ui/backend/FlashMessages'
@@ -19,6 +20,11 @@ import { TimerBar } from '../../../lib/timesheets-ui/TimerBar'
 import { AddRowDropdown } from '../../../lib/timesheets-ui/AddRowDropdown'
 import { CreateProjectDialog } from '../../../lib/timesheets-ui/CreateProjectDialog'
 import { ProjectColorDot } from '../../../lib/timesheets-ui/ProjectColorDot'
+import {
+  formatMinutesAsDecimal,
+  parseDurationInput,
+  type DurationParseError,
+} from '../../../lib/timesheetsDuration'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 
 const logger = createLogger('staff')
@@ -30,6 +36,7 @@ type CellEntry = { id?: string; minutes: number }
 type EntryMap = Record<string, Record<string, CellEntry[]>>
 type DirtyMap = Record<string, Record<string, CellEntry>>
 type RawTextMap = Record<string, Record<string, string>>
+type CellErrorMap = Record<string, Record<string, DurationParseError>>
 type ViewMode = 'weekly' | 'monthly'
 type ViewType = 'timesheet' | 'list'
 
@@ -81,24 +88,14 @@ function isWeekendDay(date: Date): boolean {
   return d === 0 || d === 6
 }
 
-function minutesToDecimal(minutes: number): string {
-  if (minutes === 0) return ''
-  const hours = minutes / 60
-  return hours % 1 === 0 ? String(hours) : hours.toFixed(2).replace(/0+$/, '').replace(/\.$/, '')
-}
-
-function decimalToMinutes(value: string): number {
-  const trimmed = value.trim()
-  if (!trimmed) return 0
-  const num = parseFloat(trimmed.replace(',', '.'))
-  if (isNaN(num) || num < 0) return 0
-  return Math.min(Math.round(num * 60), 1440)
-}
-
 function getLocalizedDayName(date: Date): string {
   return date.toLocaleDateString(undefined, { weekday: 'short' })
 }
 
+function getLocalizedCellDate(date: Date): string {
+  return date.toLocaleDateString(undefined, { weekday: 'long', month: 'long', day: 'numeric' })
+}
+
 // --- Derived date ranges ---
 
 function getWeekDays(weekStart: Date): Date[] {
@@ -156,6 +153,7 @@ export default function MyTimesheetsPage() {
   const [rawEntries, setRawEntries] = React.useState<RawTimeEntry[]>([])
   const [dirty, setDirty] = React.useState<DirtyMap>({})
   const [rawText, setRawText] = React.useState<RawTextMap>({})
+  const [cellErrors, setCellErrors] = React.useState<CellErrorMap>({})
   const [staffMemberId, setStaffMemberId] = React.useState<string | null>(null)
   const [staffMemberMissing, setStaffMemberMissing] = React.useState(false)
   const [isInitialLoad, setIsInitialLoad] = React.useState(true)
@@ -180,6 +178,21 @@ export default function MyTimesheetsPage() {
     blockedMessage: t('ui.forms.flash.saveBlocked', 'Save blocked by validation'),
   })
 
+  const durationFormatHint = t(
+    'staff.timesheets.my.duration.hint',
+    'Enter hours (8 or 1.5), h:mm (1:30) or minutes (90m). Max 24h per day.',
+  )
+  const describeDurationCell = React.useCallback((projectName: string, date: Date): string => (
+    t('staff.timesheets.my.duration.cellLabel', 'Duration for {project} on {date}')
+      .replace('{project}', projectName)
+      .replace('{date}', getLocalizedCellDate(date))
+  ), [t])
+  const describeDurationError = React.useCallback((reason: DurationParseError): string => (
+    reason === 'out_of_range'
+      ? t('staff.timesheets.my.duration.errors.out_of_range', 'Maximum 24h per day. Use 1:30 or 90m for shorter entries.')
+      : t('staff.timesheets.my.duration.errors.invalid', 'Unrecognised duration. Use 8, 1.5, 1:30, 90m or 1h 30m.')
+  ), [t])
+
   // --- Feature check ---
   React.useEffect(() => {
     let cancelled = false
@@ -343,6 +356,7 @@ export default function MyTimesheetsPage() {
       setEntries(map)
       setDirty({})
       setRawText({})
+      setCellErrors({})
     } catch (error) {
       logger.error('staff.timesheets.my.load', { err: error })
       flash(t('staff.timesheets.my.errors.load', 'Failed to load timesheets.'), 'error')
@@ -358,21 +372,57 @@ export default function MyTimesheetsPage() {
   }, [loadData, scopeVersion])
 
   // --- Cell handlers ---
+  const clearCellError = React.useCallback((projectId: string, dateKey: string) => {
+    setCellErrors((prev) => {
+      const projectErrors = prev[projectId]
+      if (!projectErrors || projectErrors[dateKey] === undefined) return prev
+      const nextProjectErrors = { ...projectErrors }
+      delete nextProjectErrors[dateKey]
+      const next = { ...prev }
+      if (Object.keys(nextProjectErrors).length > 0) next[projectId] = nextProjectErrors
+      else delete next[projectId]
+      return next
+    })
+  }, [])
+
   const handleCellChange = React.useCallback((projectId: string, dateKey: string, value: string) => {
-    // Only allow digits, dots, and commas (decimal separators)
-    const sanitized = value.replace(/[^0-9.,]/g, '')
+    clearCellError(projectId, dateKey)
     setRawText((prev) => {
       const projectTexts = { ...(prev[projectId] ?? {}) }
-      projectTexts[dateKey] = sanitized
+      projectTexts[dateKey] = value
       return { ...prev, [projectId]: projectTexts }
     })
+  }, [clearCellError])
+
+  const dropDirtyCell = React.useCallback((projectId: string, dateKey: string) => {
+    setDirty((prev) => {
+      const projectEntries = prev[projectId]
+      if (!projectEntries || projectEntries[dateKey] === undefined) return prev
+      const nextProjectEntries = { ...projectEntries }
+      delete nextProjectEntries[dateKey]
+      const next = { ...prev }
+      if (Object.keys(nextProjectEntries).length > 0) next[projectId] = nextProjectEntries
+      else delete next[projectId]
+      return next
+    })
   }, [])
 
   const handleCellBlur = React.useCallback((projectId: string, dateKey: string, currentValue: string) => {
     const editedText = rawText[projectId]?.[dateKey]
     const text = editedText ?? currentValue
     if (text === undefined) return
-    const minutes = decimalToMinutes(text)
+    const parsed = parseDurationInput(text)
+    if (!parsed.ok) {
+      dropDirtyCell(projectId, dateKey)
+      setCellErrors((prev) => {
+        const projectErrors = { ...(prev[projectId] ?? {}) }
+        projectErrors[dateKey] = parsed.reason
+        return { ...prev, [projectId]: projectErrors }
+      })
+      return
+    }
+    clearCellError(projectId, dateKey)
+    const minutes = parsed.minutes
     const cellEntries = entries[projectId]?.[dateKey] ?? []
     const existingMinutes = cellEntries.reduce((sum, e) => sum + e.minutes, 0)
 
@@ -395,7 +445,7 @@ export default function MyTimesheetsPage() {
       }
       return { ...prev, [projectId]: projectTexts }
     })
-  }, [rawText, entries])
+  }, [rawText, entries, clearCellError, dropDirtyCell])
 
   const getCellValue = React.useCallback((projectId: string, dateKey: string): number => {
     const dirtyCell = dirty[projectId]?.[dateKey] as CellEntry | undefined
@@ -406,12 +456,30 @@ export default function MyTimesheetsPage() {
 
   // --- Save ---
   const hasChanges = Object.keys(dirty).length > 0 || Object.keys(rawText).length > 0
+  const invalidCellCount = React.useMemo(
+    () => Object.values(cellErrors).reduce((sum, projectErrors) => sum + Object.keys(projectErrors).length, 0),
+    [cellErrors],
+  )
+  const pendingSummary = React.useMemo(() => {
+    let cells = 0
+    let minutes = 0
+    for (const dateMap of Object.values(dirty)) {
+      for (const cell of Object.values(dateMap)) {
+        cells += 1
+        minutes += cell.minutes
+      }
+    }
+    return { cells, minutes }
+  }, [dirty])
 
   const handleSave = React.useCallback(async () => {
-    if (!hasChanges) return
+    if (!hasChanges || invalidCellCount > 0) return
+    const summary = t('staff.timesheets.my.confirm_save.summary', '{count} cell(s), {total}h in total.')
+      .replace('{count}', String(pendingSummary.cells))
+      .replace('{total}', formatMinutesAsDecimal(pendingSummary.minutes) || '0')
     const confirmed = await confirm({
       title: t('staff.timesheets.my.confirm_save.title', 'Save changes?'),
-      text: t('staff.timesheets.my.confirm_save.body', 'Your timesheet entries will be saved.'),
+      text: `${t('staff.timesheets.my.confirm_save.body', 'Your timesheet entries will be saved.')} ${summary}`,
     })
     if (!confirmed) return
 
@@ -454,7 +522,7 @@ export default function MyTimesheetsPage() {
     } finally {
       setIsSaving(false)
     }
-  }, [dirty, entries, hasChanges, confirm, t, loadData, runMutation, mutationContextId, staffMemberId, retryLastMutation])
+  }, [dirty, entries, hasChanges, invalidCellCount, pendingSummary, confirm, t, loadData, runMutation, mutationContextId, staffMemberId, retryLastMutation])
 
   // --- Totals ---
   const getRowTotal = React.useCallback((projectId: string): number => {
@@ -612,6 +680,12 @@ export default function MyTimesheetsPage() {
         delete next[project.id]
         return next
       })
+      setCellErrors((prev) => {
+        if (!prev[project.id]) return prev
+        const next = { ...prev }
+        delete next[project.id]
+        return next
+      })
     } catch (error) {
       logger.error('staff.timesheets.my.removeRow', { err: error })
       flash(t('staff.timesheets.my.removeRow.error', 'Could not remove the project. Please try again.'), 'error')
@@ -692,7 +766,7 @@ export default function MyTimesheetsPage() {
                 ? t('staff.timesheets.my.weekTotal', 'Week Total')
                 : t('staff.timesheets.my.total_hours', 'Total Hours')}
             </p>
-            <p className="text-2xl font-semibold">{minutesToDecimal(grandTotal) || '0'}</p>
+            <p className="text-2xl font-semibold">{formatMinutesAsDecimal(grandTotal) || '0'}</p>
           </div>
           <div className="rounded-lg border bg-card p-4">
             <p className="text-sm text-muted-foreground">{t('staff.timesheets.my.working_days', 'Working Days')}</p>
@@ -700,7 +774,7 @@ export default function MyTimesheetsPage() {
           </div>
           <div className="rounded-lg border bg-card p-4">
             <p className="text-sm text-muted-foreground">{t('staff.timesheets.my.daily_average', 'Daily Average')}</p>
-            <p className="text-2xl font-semibold">{minutesToDecimal(Math.round(dailyAverage)) || '0'}</p>
+            <p className="text-2xl font-semibold">{formatMinutesAsDecimal(Math.round(dailyAverage)) || '0'}</p>
           </div>
           <div className="rounded-lg border bg-card p-4">
             <p className="text-sm text-muted-foreground">{t('staff.timesheets.my.status', 'Status')}</p>
@@ -735,12 +809,16 @@ export default function MyTimesheetsPage() {
               onViewTypeChange={setViewType}
             />
             <div className="flex items-center gap-2">
-              {hasChanges && (
-                <span className="text-xs text-amber-600 font-medium">
+              {invalidCellCount > 0 ? (
+                <span className="text-xs text-status-error-text font-medium">
+                  {t('staff.timesheets.my.duration.blocked', 'Fix the highlighted durations to save')}
+                </span>
+              ) : hasChanges && (
+                <span className="text-xs text-status-warning-text font-medium">
                   {t('staff.timesheets.my.unsaved', 'Unsaved changes')}
                 </span>
               )}
-              <Button size="sm" type="button" onClick={handleSave} disabled={!hasChanges || isSaving}>
+              <Button size="sm" type="button" onClick={handleSave} disabled={!hasChanges || isSaving || invalidCellCount > 0}>
                 {isSaving ? t('staff.timesheets.my.saving', 'Saving...') : t('staff.timesheets.my.save_changes', 'Save Changes')}
               </Button>
             </div>
@@ -839,30 +917,40 @@ export default function MyTimesheetsPage() {
                       const weekend = isWeekendDay(date)
                       const cellMinutes = getCellValue(project.id, dateKey)
                       const isDirty = dirty[project.id]?.[dateKey] !== undefined
+                      const cellError = cellErrors[project.id]?.[dateKey]
+                      const cellErrorMessage = cellError ? describeDurationError(cellError) : undefined
                       return (
                         <td key={dateKey} className={`px-0.5 py-0.5 ${weekend ? 'bg-muted/40' : ''}`}>
                           {weekend ? (
                             <div className="rounded px-1 py-1 text-center text-xs text-muted-foreground/50">-</div>
                           ) : (
-                            <input
+                            <InlineInput
                               type="text"
-                              inputMode="decimal"
-                              className={`mx-auto block rounded border text-center tabular-nums transition-colors
-                                ${viewMode === 'weekly' ? 'w-12 px-1 py-0.5 text-xs' : 'w-8 px-0 py-1 text-[10px]'}
-                                ${isDirty ? 'border-amber-400 bg-amber-50' : 'border-muted-foreground/20 bg-transparent'}
-                                ${cellMinutes > 0 ? 'font-semibold' : 'text-muted-foreground'}
-                                hover:border-muted-foreground/40 focus:border-primary focus:bg-background focus:outline-none`}
-                              value={rawText[project.id]?.[dateKey] ?? minutesToDecimal(cellMinutes)}
+                              inputMode="text"
+                              showBorderOnHover={false}
+                              className={`mx-auto flex h-6 border transition-colors
+                                ${viewMode === 'weekly' ? 'w-12 px-1' : 'w-8 px-0'}
+                                ${cellError
+                                  ? 'bg-status-error-bg'
+                                  : isDirty
+                                    ? 'border-status-warning-border bg-status-warning-bg'
+                                    : 'border-muted-foreground/20 bg-transparent hover:border-muted-foreground/40'}`}
+                              inputClassName={`text-center text-xs tabular-nums
+                                ${cellError ? 'text-status-error-text' : cellMinutes > 0 ? 'font-semibold' : 'text-muted-foreground'}`}
+                              value={rawText[project.id]?.[dateKey] ?? formatMinutesAsDecimal(cellMinutes)}
                               onChange={(e) => handleCellChange(project.id, dateKey, e.target.value)}
                               onBlur={(event) => handleCellBlur(project.id, dateKey, event.currentTarget.value)}
                               placeholder={t('staff.timesheets.my.durationPlaceholder', '0')}
+                              aria-invalid={cellError !== undefined}
+                              aria-label={describeDurationCell(project.name, date)}
+                              title={cellErrorMessage ?? durationFormatHint}
                             />
                           )}
                         </td>
                       )
                     })}
                     <td className="px-3 py-1.5 text-right font-semibold text-xs tabular-nums">
-                      {minutesToDecimal(getRowTotal(project.id)) || '0'}
+                      {formatMinutesAsDecimal(getRowTotal(project.id)) || '0'}
                     </td>
                   </tr>
                 ))}
@@ -888,14 +976,15 @@ export default function MyTimesheetsPage() {
                     const dayMinutes = getDayTotal(date)
                     return (
                       <td key={formatDateKey(date)} className={`py-2 text-center text-xs tabular-nums ${weekend ? 'text-muted-foreground/50' : ''}`}>
-                        {weekend ? '-' : (minutesToDecimal(dayMinutes) || '-')}
+                        {weekend ? '-' : (formatMinutesAsDecimal(dayMinutes) || '-')}
                       </td>
                     )
                   })}
-                  <td className="px-3 py-2 text-right tabular-nums font-semibold">{minutesToDecimal(grandTotal) || '0'}</td>
+                  <td className="px-3 py-2 text-right tabular-nums font-semibold">{formatMinutesAsDecimal(grandTotal) || '0'}</td>
                 </tr>
               </tfoot>
             </table>
+            <p className="px-3 py-2 text-xs text-muted-foreground">{durationFormatHint}</p>
           </div>
         )}
         </div>

package/src/modules/staff/i18n/de.json

@@ -967,10 +967,16 @@
   "staff.timesheets.my.calendar.prevMonth": "Previous month",
   "staff.timesheets.my.calendar.thisWeek": "This week",
   "staff.timesheets.my.confirm_save.body": "Your timesheet entries will be saved.",
+  "staff.timesheets.my.confirm_save.summary": "{count} Zelle(n), insgesamt {total} h.",
   "staff.timesheets.my.confirm_save.title": "Save changes?",
   "staff.timesheets.my.createProfile": "Create Team Member Profile",
   "staff.timesheets.my.daily_average": "Daily Average",
   "staff.timesheets.my.daily_total": "Daily Total",
+  "staff.timesheets.my.duration.blocked": "Markierte Zeiten korrigieren, um zu speichern",
+  "staff.timesheets.my.duration.cellLabel": "Dauer für {project} am {date}",
+  "staff.timesheets.my.duration.errors.invalid": "Zeitangabe nicht erkannt. Verwende 8, 1,5, 1:30, 90m oder 1h 30m.",
+  "staff.timesheets.my.duration.errors.out_of_range": "Maximal 24 h pro Tag. Verwende 1:30 oder 90m für kürzere Eintragungen.",
+  "staff.timesheets.my.duration.hint": "Stunden (8 oder 1,5), h:mm (1:30) oder Minuten (90m) eingeben. Max. 24 h pro Tag.",
   "staff.timesheets.my.durationPlaceholder": "0",
   "staff.timesheets.my.errors.load": "Failed to load timesheets.",
   "staff.timesheets.my.errors.save": "Failed to save timesheets.",

package/src/modules/staff/i18n/en.json

@@ -967,10 +967,16 @@
   "staff.timesheets.my.calendar.prevMonth": "Previous month",
   "staff.timesheets.my.calendar.thisWeek": "This week",
   "staff.timesheets.my.confirm_save.body": "Your timesheet entries will be saved.",
+  "staff.timesheets.my.confirm_save.summary": "{count} cell(s), {total}h in total.",
   "staff.timesheets.my.confirm_save.title": "Save changes?",
   "staff.timesheets.my.createProfile": "Create My Profile",
   "staff.timesheets.my.daily_average": "Daily Average",
   "staff.timesheets.my.daily_total": "Daily Total",
+  "staff.timesheets.my.duration.blocked": "Fix the highlighted durations to save",
+  "staff.timesheets.my.duration.cellLabel": "Duration for {project} on {date}",
+  "staff.timesheets.my.duration.errors.invalid": "Unrecognised duration. Use 8, 1.5, 1:30, 90m or 1h 30m.",
+  "staff.timesheets.my.duration.errors.out_of_range": "Maximum 24h per day. Use 1:30 or 90m for shorter entries.",
+  "staff.timesheets.my.duration.hint": "Enter hours (8 or 1.5), h:mm (1:30) or minutes (90m). Max 24h per day.",
   "staff.timesheets.my.durationPlaceholder": "0",
   "staff.timesheets.my.errors.load": "Failed to load timesheets.",
   "staff.timesheets.my.errors.save": "Failed to save timesheets.",

package/src/modules/staff/i18n/es.json

@@ -967,10 +967,16 @@
   "staff.timesheets.my.calendar.prevMonth": "Previous month",
   "staff.timesheets.my.calendar.thisWeek": "This week",
   "staff.timesheets.my.confirm_save.body": "Your timesheet entries will be saved.",
+  "staff.timesheets.my.confirm_save.summary": "{count} celda(s), {total} h en total.",
   "staff.timesheets.my.confirm_save.title": "Save changes?",
   "staff.timesheets.my.createProfile": "Create Team Member Profile",
   "staff.timesheets.my.daily_average": "Daily Average",
   "staff.timesheets.my.daily_total": "Daily Total",
+  "staff.timesheets.my.duration.blocked": "Corrige las duraciones marcadas para guardar",
+  "staff.timesheets.my.duration.cellLabel": "Duración de {project} el {date}",
+  "staff.timesheets.my.duration.errors.invalid": "Duración no reconocida. Usa 8, 1,5, 1:30, 90m o 1h 30m.",
+  "staff.timesheets.my.duration.errors.out_of_range": "Máximo 24 h por día. Usa 1:30 o 90m para entradas más cortas.",
+  "staff.timesheets.my.duration.hint": "Introduce horas (8 o 1,5), h:mm (1:30) o minutos (90m). Máximo 24 h por día.",
   "staff.timesheets.my.durationPlaceholder": "0",
   "staff.timesheets.my.errors.load": "Failed to load timesheets.",
   "staff.timesheets.my.errors.save": "Failed to save timesheets.",

package/src/modules/staff/i18n/ko.json

@@ -967,10 +967,16 @@
   "staff.timesheets.my.calendar.prevMonth": "이전 달",
   "staff.timesheets.my.calendar.thisWeek": "이번 주",
   "staff.timesheets.my.confirm_save.body": "근무 시간표 항목이 저장됩니다.",
+  "staff.timesheets.my.confirm_save.summary": "{count}개 셀, 총 {total}시간.",
   "staff.timesheets.my.confirm_save.title": "변경 사항을 저장하시겠습니까?",
   "staff.timesheets.my.createProfile": "내 프로필 만들기",
   "staff.timesheets.my.daily_average": "일 평균",
   "staff.timesheets.my.daily_total": "일 합계",
+  "staff.timesheets.my.duration.blocked": "저장하려면 표시된 시간을 수정하세요",
+  "staff.timesheets.my.duration.cellLabel": "{date} {project} 작업 시간",
+  "staff.timesheets.my.duration.errors.invalid": "인식할 수 없는 시간입니다. 8, 1.5, 1:30, 90m 또는 1h 30m 형식을 사용하세요.",
+  "staff.timesheets.my.duration.errors.out_of_range": "하루 최대 24시간입니다. 더 짧은 입력에는 1:30 또는 90m을 사용하세요.",
+  "staff.timesheets.my.duration.hint": "시간(8 또는 1.5), h:mm(1:30) 또는 분(90m)을 입력하세요. 하루 최대 24시간.",
   "staff.timesheets.my.durationPlaceholder": "0",
   "staff.timesheets.my.errors.load": "근무 시간표를 불러오지 못했습니다.",
   "staff.timesheets.my.errors.save": "근무 시간표를 저장하지 못했습니다.",

package/src/modules/staff/i18n/pl.json

@@ -967,10 +967,16 @@
   "staff.timesheets.my.calendar.prevMonth": "Poprzedni miesiąc",
   "staff.timesheets.my.calendar.thisWeek": "Ten tydzień",
   "staff.timesheets.my.confirm_save.body": "Twoje wpisy w karcie czasu pracy zostaną zapisane.",
+  "staff.timesheets.my.confirm_save.summary": "Zaznaczone komórki: {count}, łącznie {total} h.",
   "staff.timesheets.my.confirm_save.title": "Zapisać zmiany?",
   "staff.timesheets.my.createProfile": "Create Team Member Profile",
   "staff.timesheets.my.daily_average": "Średnia dzienna",
   "staff.timesheets.my.daily_total": "Suma dzienna",
+  "staff.timesheets.my.duration.blocked": "Popraw zaznaczone czasy, aby zapisać",
+  "staff.timesheets.my.duration.cellLabel": "Czas dla {project} w dniu {date}",
+  "staff.timesheets.my.duration.errors.invalid": "Nierozpoznany czas. Użyj 8, 1,5, 1:30, 90m lub 1h 30m.",
+  "staff.timesheets.my.duration.errors.out_of_range": "Maksymalnie 24 h na dzień. Dla krótszych wpisów użyj 1:30 lub 90m.",
+  "staff.timesheets.my.duration.hint": "Podaj godziny (8 lub 1,5), h:mm (1:30) albo minuty (90m). Maks. 24 h na dzień.",
   "staff.timesheets.my.durationPlaceholder": "0",
   "staff.timesheets.my.errors.load": "Nie udało się załadować kart czasu pracy.",
   "staff.timesheets.my.errors.save": "Nie udało się zapisać kart czasu pracy.",

package/src/modules/staff/lib/timesheetsDuration.ts

@@ -0,0 +1,56 @@
+const MINUTES_PER_HOUR = 60
+
+export const MAX_DURATION_MINUTES = 24 * MINUTES_PER_HOUR
+
+export type DurationParseError = 'invalid' | 'out_of_range'
+
+export type DurationParseResult =
+  | { ok: true; minutes: number }
+  | { ok: false; reason: DurationParseError }
+
+const NUMBER_SOURCE = '(?:\\d+(?:[.,]\\d*)?|[.,]\\d+)'
+
+const CLOCK_PATTERN = /^(\d+):([0-5]?\d)$/
+const DECIMAL_HOURS_PATTERN = new RegExp(`^${NUMBER_SOURCE}$`)
+const UNIT_PATTERN = new RegExp(`^(?:(${NUMBER_SOURCE})\\s*h)?\\s*(?:(${NUMBER_SOURCE})\\s*m(?:in)?)?$`)
+
+function toNumber(raw: string): number {
+  return Number.parseFloat(raw.replace(',', '.'))
+}
+
+function resolveMinutes(rawMinutes: number): DurationParseResult {
+  if (!Number.isFinite(rawMinutes)) return { ok: false, reason: 'invalid' }
+  const minutes = Math.round(rawMinutes)
+  if (minutes < 0) return { ok: false, reason: 'invalid' }
+  if (minutes > MAX_DURATION_MINUTES) return { ok: false, reason: 'out_of_range' }
+  return { ok: true, minutes }
+}
+
+export function parseDurationInput(value: string): DurationParseResult {
+  const normalized = value.trim().toLowerCase()
+  if (!normalized) return { ok: true, minutes: 0 }
+
+  const clock = CLOCK_PATTERN.exec(normalized)
+  if (clock) {
+    return resolveMinutes(toNumber(clock[1]) * MINUTES_PER_HOUR + toNumber(clock[2]))
+  }
+
+  if (DECIMAL_HOURS_PATTERN.test(normalized)) {
+    return resolveMinutes(toNumber(normalized) * MINUTES_PER_HOUR)
+  }
+
+  const units = UNIT_PATTERN.exec(normalized)
+  if (units && (units[1] !== undefined || units[2] !== undefined)) {
+    const hours = units[1] === undefined ? 0 : toNumber(units[1])
+    const minutes = units[2] === undefined ? 0 : toNumber(units[2])
+    return resolveMinutes(hours * MINUTES_PER_HOUR + minutes)
+  }
+
+  return { ok: false, reason: 'invalid' }
+}
+
+export function formatMinutesAsDecimal(minutes: number): string {
+  if (minutes === 0) return ''
+  const hours = minutes / MINUTES_PER_HOUR
+  return hours % 1 === 0 ? String(hours) : hours.toFixed(2).replace(/0+$/, '').replace(/\.$/, '')
+}