@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7180.1.9717fbbb43

package/dist/modules/staff/lib/time-tracking-ui/timeEntryListData.js

@@ -0,0 +1,151 @@
+import {
+  clockFromApiValue,
+  dateFromApiValue,
+  readRowBoolean,
+  readRowNumber,
+  readRowString
+} from "./timeEntryDialogState.js";
+const TIME_ENTRY_LOCKED_CODE = "time_entry_locked";
+const COPY_DAY_TARGET_NOT_EMPTY_CODE = "copy_day_target_not_empty";
+const EMPTY_TIME_ENTRY_DIRECTORY = {
+  taskTitles: /* @__PURE__ */ new Map(),
+  projectLabels: /* @__PURE__ */ new Map()
+};
+function readTagIds(row) {
+  const tags = Array.isArray(row.tags) ? row.tags : [];
+  return tags.map((tag) => tag && typeof tag === "object" ? readRowString(tag, "id") : null).filter((value) => value !== null);
+}
+function toTimeEntryListRow(row, directory = EMPTY_TIME_ENTRY_DIRECTORY) {
+  const id = readRowString(row, "id");
+  if (!id) return null;
+  const taskId = readRowString(row, "task_id", "taskId");
+  const timeProjectId = readRowString(row, "time_project_id", "timeProjectId");
+  return {
+    id,
+    date: dateFromApiValue(readRowString(row, "date")),
+    taskId,
+    taskTitle: taskId ? directory.taskTitles.get(taskId) ?? null : null,
+    timeProjectId,
+    projectLabel: timeProjectId ? directory.projectLabels.get(timeProjectId) ?? null : null,
+    description: readRowString(row, "description", "notes"),
+    startText: clockFromApiValue(readRowString(row, "started_at", "startedAt")),
+    endText: clockFromApiValue(readRowString(row, "ended_at", "endedAt")),
+    durationMinutes: readRowNumber(row, "duration_minutes", "durationMinutes") ?? 0,
+    roundedMinutes: readRowNumber(row, "rounded_minutes", "roundedMinutes"),
+    isBillable: readRowBoolean(row, true, "is_billable", "isBillable"),
+    cost: readRowNumber(row, "cost"),
+    currencyCode: readRowString(row, "currencyCode", "rate_currency_code", "rateCurrencyCode"),
+    rateOverrideAmount: readRowNumber(row, "rate_override_amount", "rateOverrideAmount"),
+    isLocked: readRowBoolean(row, false, "isLocked", "is_locked"),
+    lockedReportId: readRowString(row, "lockedReportId", "locked_report_id"),
+    updatedAt: readRowString(row, "updated_at", "updatedAt"),
+    tagIds: readTagIds(row)
+  };
+}
+function summarizeTimeEntries(rows) {
+  const byCurrency = /* @__PURE__ */ new Map();
+  let totalMinutes = 0;
+  for (const row of rows) {
+    totalMinutes += Number.isFinite(row.durationMinutes) ? row.durationMinutes : 0;
+    if (row.cost === null || !Number.isFinite(row.cost)) continue;
+    const key = row.currencyCode ?? "";
+    const current = byCurrency.get(key);
+    if (current) current.amount += row.cost;
+    else byCurrency.set(key, { currencyCode: row.currencyCode ?? null, amount: row.cost });
+  }
+  return {
+    visibleCount: rows.length,
+    totalMinutes,
+    money: Array.from(byCurrency.values())
+  };
+}
+function errorPayloads(error) {
+  if (!error || typeof error !== "object") return [];
+  const bags = [error];
+  const nested = error.body;
+  if (nested && typeof nested === "object") bags.push(nested);
+  return bags;
+}
+function readErrorCode(error) {
+  for (const bag of errorPayloads(error)) {
+    if (typeof bag.code === "string" && bag.code.length > 0) return bag.code;
+  }
+  return null;
+}
+function readErrorStatus(error) {
+  for (const bag of errorPayloads(error)) {
+    if (typeof bag.status === "number" && Number.isFinite(bag.status)) return bag.status;
+  }
+  return null;
+}
+function isEntryLockedError(error) {
+  const code = readErrorCode(error);
+  return code === TIME_ENTRY_LOCKED_CODE || code === "entry_locked";
+}
+function readCopyDayTargetConflict(error) {
+  if (readErrorCode(error) !== COPY_DAY_TARGET_NOT_EMPTY_CODE) return null;
+  for (const bag of errorPayloads(error)) {
+    if (bag.code !== COPY_DAY_TARGET_NOT_EMPTY_CODE) continue;
+    const count = bag.existingEntryCount;
+    const ids = Array.isArray(bag.existingEntryIds) ? bag.existingEntryIds.length : 0;
+    return {
+      toDate: typeof bag.toDate === "string" ? bag.toDate : null,
+      existingEntryCount: typeof count === "number" && Number.isFinite(count) ? count : ids
+    };
+  }
+  return { toDate: null, existingEntryCount: 0 };
+}
+function toIsoDay(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+}
+function currentWeekRange(now = /* @__PURE__ */ new Date()) {
+  const start = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  const weekday = (start.getDay() + 6) % 7;
+  start.setDate(start.getDate() - weekday);
+  const end = new Date(start);
+  end.setDate(end.getDate() + 6);
+  return { from: toIsoDay(start), to: toIsoDay(end) };
+}
+function formatEntryDay(isoDate, locale) {
+  if (!isoDate) return "";
+  const parsed = /* @__PURE__ */ new Date(`${isoDate}T00:00:00`);
+  if (Number.isNaN(parsed.getTime())) return isoDate;
+  try {
+    return new Intl.DateTimeFormat(locale, { weekday: "short", day: "numeric", month: "short" }).format(parsed);
+  } catch {
+    return isoDate;
+  }
+}
+function formatEntryClockRange(row) {
+  if (!row.startText && !row.endText) return null;
+  if (row.startText && row.endText) return `${row.startText} \u2013 ${row.endText}`;
+  return row.startText || row.endText;
+}
+function collectDirectoryIds(rows) {
+  const taskIds = /* @__PURE__ */ new Set();
+  const projectIds = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    if (row.taskId) taskIds.add(row.taskId);
+    if (row.timeProjectId) projectIds.add(row.timeProjectId);
+  }
+  return { taskIds: Array.from(taskIds), projectIds: Array.from(projectIds) };
+}
+export {
+  COPY_DAY_TARGET_NOT_EMPTY_CODE,
+  EMPTY_TIME_ENTRY_DIRECTORY,
+  TIME_ENTRY_LOCKED_CODE,
+  collectDirectoryIds,
+  currentWeekRange,
+  formatEntryClockRange,
+  formatEntryDay,
+  isEntryLockedError,
+  readCopyDayTargetConflict,
+  readErrorCode,
+  readErrorStatus,
+  summarizeTimeEntries,
+  toTimeEntryListRow
+};
+//# sourceMappingURL=timeEntryListData.js.map

package/dist/modules/staff/lib/time-tracking-ui/timeEntryListData.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking-ui/timeEntryListData.ts"],
+  "sourcesContent": ["/**\n * The reading half of screen 10 \u2014 everything the entries list needs that is not\n * React. Kept out of the page so the rules the mockup's notes describe can be\n * tested as arithmetic rather than through a rendered table.\n *\n * Three of those rules live here:\n *\n *  1. **Money is never summed across currencies.** `summarizeTimeEntries`\n *     returns one subtotal PER currency instead of a single number. A tenant\n *     billing one client in PLN and another in EUR would otherwise read a\n *     footer total that is arithmetically valid and financially meaningless.\n *     The renderer decides between \"one currency \u2192 show it\" and \"several \u2192\n *     show them apart\", but it can never be handed a pre-added figure.\n *  2. **A non-billable entry has no cost, not a zero cost.** The list route\n *     already answers `null` for it (screen 10 note 5); nothing here turns that\n *     into `0`, and the totals skip it rather than adding nothing to a currency\n *     that would then appear in the footer.\n *  3. **The lock and the copy-day refusal are read off the response body, not\n *     off the status code.** `409` covers an optimistic-lock conflict, a locked\n *     entry and a non-empty copy-day target, and each one needs a different\n *     sentence in front of the user.\n */\n\nimport {\n  clockFromApiValue,\n  dateFromApiValue,\n  readRowBoolean,\n  readRowNumber,\n  readRowString,\n  type ApiRow,\n} from './timeEntryDialogState'\n\n/** The shared refusal code every write path answers when an entry is frozen in a report. */\nexport const TIME_ENTRY_LOCKED_CODE = 'time_entry_locked'\n\n/** The refusal a second \"copy yesterday\" click gets instead of a doubled day. */\nexport const COPY_DAY_TARGET_NOT_EMPTY_CODE = 'copy_day_target_not_empty'\n\nexport type TimeEntryListRow = {\n  id: string\n  date: string\n  taskId: string | null\n  taskTitle: string | null\n  timeProjectId: string | null\n  projectLabel: string | null\n  description: string | null\n  startText: string\n  endText: string\n  durationMinutes: number\n  roundedMinutes: number | null\n  isBillable: boolean\n  cost: number | null\n  currencyCode: string | null\n  rateOverrideAmount: number | null\n  isLocked: boolean\n  lockedReportId: string | null\n  updatedAt: string | null\n  tagIds: string[]\n}\n\nexport type TimeEntryDirectory = {\n  taskTitles: ReadonlyMap<string, string>\n  projectLabels: ReadonlyMap<string, string>\n}\n\nexport const EMPTY_TIME_ENTRY_DIRECTORY: TimeEntryDirectory = {\n  taskTitles: new Map<string, string>(),\n  projectLabels: new Map<string, string>(),\n}\n\nfunction readTagIds(row: ApiRow): string[] {\n  const tags = Array.isArray(row.tags) ? row.tags : []\n  return tags\n    .map((tag) => (tag && typeof tag === 'object' ? readRowString(tag as ApiRow, 'id') : null))\n    .filter((value): value is string => value !== null)\n}\n\nexport function toTimeEntryListRow(\n  row: ApiRow,\n  directory: TimeEntryDirectory = EMPTY_TIME_ENTRY_DIRECTORY,\n): TimeEntryListRow | null {\n  const id = readRowString(row, 'id')\n  if (!id) return null\n  const taskId = readRowString(row, 'task_id', 'taskId')\n  const timeProjectId = readRowString(row, 'time_project_id', 'timeProjectId')\n  return {\n    id,\n    date: dateFromApiValue(readRowString(row, 'date')),\n    taskId,\n    taskTitle: taskId ? directory.taskTitles.get(taskId) ?? null : null,\n    timeProjectId,\n    projectLabel: timeProjectId ? directory.projectLabels.get(timeProjectId) ?? null : null,\n    description: readRowString(row, 'description', 'notes'),\n    startText: clockFromApiValue(readRowString(row, 'started_at', 'startedAt')),\n    endText: clockFromApiValue(readRowString(row, 'ended_at', 'endedAt')),\n    durationMinutes: readRowNumber(row, 'duration_minutes', 'durationMinutes') ?? 0,\n    roundedMinutes: readRowNumber(row, 'rounded_minutes', 'roundedMinutes'),\n    isBillable: readRowBoolean(row, true, 'is_billable', 'isBillable'),\n    cost: readRowNumber(row, 'cost'),\n    currencyCode: readRowString(row, 'currencyCode', 'rate_currency_code', 'rateCurrencyCode'),\n    rateOverrideAmount: readRowNumber(row, 'rate_override_amount', 'rateOverrideAmount'),\n    isLocked: readRowBoolean(row, false, 'isLocked', 'is_locked'),\n    lockedReportId: readRowString(row, 'lockedReportId', 'locked_report_id'),\n    updatedAt: readRowString(row, 'updated_at', 'updatedAt'),\n    tagIds: readTagIds(row),\n  }\n}\n\nexport type MoneySubtotal = {\n  currencyCode: string | null\n  amount: number\n}\n\nexport type TimeEntriesSummary = {\n  visibleCount: number\n  totalMinutes: number\n  /** One entry per currency present among the priced rows; never pre-added. */\n  money: MoneySubtotal[]\n}\n\n/**\n * The mockup's `Razem (5 z 23 wpis\u00F3w) \u00B7 15:15 \u00B7 4 315,00 PLN`.\n *\n * The time total is the sum of the durations the table SHOWS, so the footer\n * always reconciles against the column above it; cost is the server's `cost`,\n * which is derived from rounded minutes and is therefore not a function of the\n * displayed duration.\n */\nexport function summarizeTimeEntries(rows: readonly TimeEntryListRow[]): TimeEntriesSummary {\n  const byCurrency = new Map<string, MoneySubtotal>()\n  let totalMinutes = 0\n  for (const row of rows) {\n    totalMinutes += Number.isFinite(row.durationMinutes) ? row.durationMinutes : 0\n    if (row.cost === null || !Number.isFinite(row.cost)) continue\n    const key = row.currencyCode ?? ''\n    const current = byCurrency.get(key)\n    if (current) current.amount += row.cost\n    else byCurrency.set(key, { currencyCode: row.currencyCode ?? null, amount: row.cost })\n  }\n  return {\n    visibleCount: rows.length,\n    totalMinutes,\n    money: Array.from(byCurrency.values()),\n  }\n}\n\ntype ErrorBag = Record<string, unknown>\n\n/**\n * `raiseCrudError` spreads the response body onto the thrown Error, but a\n * caller that re-wraps it can leave the payload one level down. Both shapes are\n * read so a lock refusal never degrades into \"something went wrong\".\n */\nfunction errorPayloads(error: unknown): ErrorBag[] {\n  if (!error || typeof error !== 'object') return []\n  const bags: ErrorBag[] = [error as ErrorBag]\n  const nested = (error as { body?: unknown }).body\n  if (nested && typeof nested === 'object') bags.push(nested as ErrorBag)\n  return bags\n}\n\nexport function readErrorCode(error: unknown): string | null {\n  for (const bag of errorPayloads(error)) {\n    if (typeof bag.code === 'string' && bag.code.length > 0) return bag.code\n  }\n  return null\n}\n\nexport function readErrorStatus(error: unknown): number | null {\n  for (const bag of errorPayloads(error)) {\n    if (typeof bag.status === 'number' && Number.isFinite(bag.status)) return bag.status\n  }\n  return null\n}\n\n/**\n * True for the `409 time_entry_locked` every write path answers for an entry a\n * closed report has frozen. `entry_locked` is accepted as well so a route that\n * spells the code without its resource prefix still reads as a lock rather than\n * as a generic failure.\n */\nexport function isEntryLockedError(error: unknown): boolean {\n  const code = readErrorCode(error)\n  return code === TIME_ENTRY_LOCKED_CODE || code === 'entry_locked'\n}\n\nexport type CopyDayTargetConflict = {\n  toDate: string | null\n  existingEntryCount: number\n}\n\n/**\n * The `409 copy_day_target_not_empty` that names what is already on the target\n * day. Returning the count is the whole point: the user has to be told what\n * they would be adding to before they are offered `allowDuplicates`.\n */\nexport function readCopyDayTargetConflict(error: unknown): CopyDayTargetConflict | null {\n  if (readErrorCode(error) !== COPY_DAY_TARGET_NOT_EMPTY_CODE) return null\n  for (const bag of errorPayloads(error)) {\n    if (bag.code !== COPY_DAY_TARGET_NOT_EMPTY_CODE) continue\n    const count = bag.existingEntryCount\n    const ids = Array.isArray(bag.existingEntryIds) ? bag.existingEntryIds.length : 0\n    return {\n      toDate: typeof bag.toDate === 'string' ? bag.toDate : null,\n      existingEntryCount: typeof count === 'number' && Number.isFinite(count) ? count : ids,\n    }\n  }\n  return { toDate: null, existingEntryCount: 0 }\n}\n\nexport type IsoDateRange = {\n  from: string\n  to: string\n}\n\nfunction toIsoDay(date: Date): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  return `${year}-${month}-${day}`\n}\n\n/**\n * Monday-to-Sunday, matching the mockup's \"Okres: ten tydzie\u0144\" default. The\n * week is computed in local time because a time entry is addressed by its\n * calendar day, not by an instant.\n */\nexport function currentWeekRange(now: Date = new Date()): IsoDateRange {\n  const start = new Date(now.getFullYear(), now.getMonth(), now.getDate())\n  const weekday = (start.getDay() + 6) % 7\n  start.setDate(start.getDate() - weekday)\n  const end = new Date(start)\n  end.setDate(end.getDate() + 6)\n  return { from: toIsoDay(start), to: toIsoDay(end) }\n}\n\n/**\n * `pon 20 lip` \u2014 the weekday the mockup leads each row with. The locale is left\n * to the runtime by default, exactly as `formatDate`/`formatCurrency` do, so a\n * date on this page reads the same way as a date anywhere else in the backoffice.\n */\nexport function formatEntryDay(isoDate: string, locale?: string): string {\n  if (!isoDate) return ''\n  const parsed = new Date(`${isoDate}T00:00:00`)\n  if (Number.isNaN(parsed.getTime())) return isoDate\n  try {\n    return new Intl.DateTimeFormat(locale, { weekday: 'short', day: 'numeric', month: 'short' }).format(parsed)\n  } catch {\n    return isoDate\n  }\n}\n\n/** `09:00 \u2013 11:30`, or an em-dash when the entry carries no clock times. */\nexport function formatEntryClockRange(row: Pick<TimeEntryListRow, 'startText' | 'endText'>): string | null {\n  if (!row.startText && !row.endText) return null\n  if (row.startText && row.endText) return `${row.startText} \u2013 ${row.endText}`\n  return row.startText || row.endText\n}\n\nexport function collectDirectoryIds(rows: readonly TimeEntryListRow[]): {\n  taskIds: string[]\n  projectIds: string[]\n} {\n  const taskIds = new Set<string>()\n  const projectIds = new Set<string>()\n  for (const row of rows) {\n    if (row.taskId) taskIds.add(row.taskId)\n    if (row.timeProjectId) projectIds.add(row.timeProjectId)\n  }\n  return { taskIds: Array.from(taskIds), projectIds: Array.from(projectIds) }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/time-tracking-ui/timeTrackingSettingsForm.js

@@ -0,0 +1,105 @@
+import { formatDuration } from "../time-tracking/duration.js";
+import { roundMinutes } from "../time-tracking/rounding.js";
+import { contributedTimeTrackingSettingKeys } from "../time-tracking/settingKeys.js";
+import { readTimeTrackingSettingValue } from "../time-tracking/settings.js";
+const ROUNDING_UNIT_OPTIONS = [0, 5, 10, 15];
+const ROUNDING_EXAMPLE_MINUTES = [62, 76, 3, 120];
+function buildRoundingExamples(rounding) {
+  return ROUNDING_EXAMPLE_MINUTES.map((rawMinutes) => {
+    const roundedMinutes = roundMinutes(rawMinutes, rounding);
+    return {
+      rawMinutes,
+      roundedMinutes,
+      rawLabel: formatDuration(rawMinutes, "clock"),
+      roundedLabel: formatDuration(roundedMinutes, "clock")
+    };
+  });
+}
+function formatSignedMinutes(minutes) {
+  const safe = Number.isFinite(minutes) ? Math.round(minutes) : 0;
+  const magnitude = formatDuration(Math.abs(safe), "clock");
+  if (safe > 0) return `+${magnitude}`;
+  if (safe < 0) return `\u2212${magnitude}`;
+  return magnitude;
+}
+const MAX_ASSIGNMENT_GRACE_DAYS_INPUT = 365;
+function toSettingsDraft(settings) {
+  return {
+    roundingUnitMinutes: settings.rounding.unitMinutes,
+    roundingDirection: settings.rounding.direction,
+    defaultsBillable: settings.defaults.billable,
+    defaultsChainStartFromPreviousEnd: settings.defaults.chainStartFromPreviousEnd,
+    dailyHoursText: settings.targets.dailyHours === null ? "" : String(settings.targets.dailyHours),
+    warningsOverlap: settings.warnings.overlap,
+    warningsRunningTimer: settings.warnings.runningTimer,
+    assignmentGraceDaysText: String(settings.access.assignmentGraceDays),
+    contributed: Object.fromEntries(
+      contributedTimeTrackingSettingKeys().map((entry) => [
+        entry.id,
+        readTimeTrackingSettingValue(settings, entry.id)
+      ])
+    )
+  };
+}
+function parseDailyHours(text) {
+  const trimmed = text.trim();
+  if (trimmed.length === 0) return null;
+  const parsed = Number(trimmed.replace(",", "."));
+  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 24) return void 0;
+  return parsed;
+}
+function parseGraceDays(text) {
+  const trimmed = text.trim();
+  if (trimmed.length === 0) return void 0;
+  const parsed = Number(trimmed);
+  if (!Number.isInteger(parsed) || parsed < 0 || parsed > MAX_ASSIGNMENT_GRACE_DAYS_INPUT) return void 0;
+  return parsed;
+}
+function settingsDraftErrors(draft) {
+  const errors = [];
+  if (parseDailyHours(draft.dailyHoursText) === void 0) errors.push("dailyHours");
+  if (parseGraceDays(draft.assignmentGraceDaysText) === void 0) errors.push("assignmentGraceDays");
+  return errors;
+}
+function draftRounding(draft) {
+  return { unitMinutes: draft.roundingUnitMinutes, direction: draft.roundingDirection };
+}
+function toSettingsPayload(draft) {
+  const dailyHours = parseDailyHours(draft.dailyHoursText);
+  const assignmentGraceDays = parseGraceDays(draft.assignmentGraceDaysText);
+  if (dailyHours === void 0 || assignmentGraceDays === void 0) return null;
+  const payload = {
+    rounding: draftRounding(draft),
+    defaults: {
+      billable: draft.defaultsBillable,
+      chainStartFromPreviousEnd: draft.defaultsChainStartFromPreviousEnd
+    },
+    targets: { dailyHours },
+    warnings: { overlap: draft.warningsOverlap, runningTimer: draft.warningsRunningTimer },
+    access: { assignmentGraceDays }
+  };
+  for (const entry of contributedTimeTrackingSettingKeys()) {
+    const group = payload[entry.group] ?? {};
+    group[entry.key] = draft.contributed[entry.id];
+    payload[entry.group] = group;
+  }
+  return payload;
+}
+function isSettingsDraftDirty(draft, baseline) {
+  return draft.roundingUnitMinutes !== baseline.roundingUnitMinutes || draft.roundingDirection !== baseline.roundingDirection || draft.defaultsBillable !== baseline.defaultsBillable || draft.defaultsChainStartFromPreviousEnd !== baseline.defaultsChainStartFromPreviousEnd || draft.dailyHoursText.trim() !== baseline.dailyHoursText.trim() || draft.warningsOverlap !== baseline.warningsOverlap || draft.warningsRunningTimer !== baseline.warningsRunningTimer || draft.assignmentGraceDaysText.trim() !== baseline.assignmentGraceDaysText.trim() || contributedTimeTrackingSettingKeys().some(
+    (entry) => !Object.is(draft.contributed[entry.id], baseline.contributed[entry.id])
+  );
+}
+export {
+  MAX_ASSIGNMENT_GRACE_DAYS_INPUT,
+  ROUNDING_EXAMPLE_MINUTES,
+  ROUNDING_UNIT_OPTIONS,
+  buildRoundingExamples,
+  draftRounding,
+  formatSignedMinutes,
+  isSettingsDraftDirty,
+  settingsDraftErrors,
+  toSettingsDraft,
+  toSettingsPayload
+};
+//# sourceMappingURL=timeTrackingSettingsForm.js.map

package/dist/modules/staff/lib/time-tracking-ui/timeTrackingSettingsForm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking-ui/timeTrackingSettingsForm.ts"],
+  "sourcesContent": ["/**\n * Pure state for the module settings screen (T7.1, screen 16).\n *\n * The screen edits two numbers that are legitimately empty-able or bounded\n * (`targets.dailyHours` may be blank = no target; `access.assignmentGraceDays` is\n * an integer day count), so the draft keeps them as the TEXT the user typed and\n * converts only at the edges. Stripping a half-typed number back into the field is\n * the same defect `DurationInput` was built to avoid.\n *\n * `buildRoundingExamples` is the screen's most load-bearing function: note 1 of the\n * mockup requires the worked examples to recompute live, because rounding is a rule\n * people misread and its effect is otherwise invisible until an invoice. It calls\n * `roundMinutes` \u2014 the same function the write path calls \u2014 so a preview that\n * disagreed with reality is not expressible here.\n */\n\nimport { formatDuration } from '../time-tracking/duration'\nimport { roundMinutes, type RoundingSettings, type RoundingUnitMinutes } from '../time-tracking/rounding'\nimport { contributedTimeTrackingSettingKeys } from '../time-tracking/settingKeys'\nimport { readTimeTrackingSettingValue, type TimeTrackingSettings } from '../time-tracking/settings'\n\nexport const ROUNDING_UNIT_OPTIONS: readonly RoundingUnitMinutes[] = [0, 5, 10, 15]\n\n/**\n * The four cases from the mockup: just over a unit, past the halfway point, a\n * minimum-charge case, and one that is already exact and must not move.\n */\nexport const ROUNDING_EXAMPLE_MINUTES: readonly number[] = [62, 76, 3, 120]\n\nexport type RoundingExample = {\n  rawMinutes: number\n  roundedMinutes: number\n  rawLabel: string\n  roundedLabel: string\n}\n\nexport function buildRoundingExamples(rounding: RoundingSettings): RoundingExample[] {\n  return ROUNDING_EXAMPLE_MINUTES.map((rawMinutes) => {\n    const roundedMinutes = roundMinutes(rawMinutes, rounding)\n    return {\n      rawMinutes,\n      roundedMinutes,\n      rawLabel: formatDuration(rawMinutes, 'clock'),\n      roundedLabel: formatDuration(roundedMinutes, 'clock'),\n    }\n  })\n}\n\n/** `+38:15` / `\u221212:30` / `0:00`, for the impact card's delta against raw time. */\nexport function formatSignedMinutes(minutes: number): string {\n  const safe = Number.isFinite(minutes) ? Math.round(minutes) : 0\n  const magnitude = formatDuration(Math.abs(safe), 'clock')\n  if (safe > 0) return `+${magnitude}`\n  if (safe < 0) return `\u2212${magnitude}`\n  return magnitude\n}\n\nexport type TimeTrackingSettingsDraft = {\n  roundingUnitMinutes: RoundingUnitMinutes\n  roundingDirection: RoundingSettings['direction']\n  defaultsBillable: boolean\n  defaultsChainStartFromPreviousEnd: boolean\n  /** Free text: empty means \"no daily target\", which is a real, storable value. */\n  dailyHoursText: string\n  warningsOverlap: boolean\n  warningsRunningTimer: boolean\n  assignmentGraceDaysText: string\n  /**\n   * EP-42 \u2014 every contributed setting key, by its `<group>.<key>` id, carried through\n   * the draft untouched so the page's own Save round-trips a contribution it knows\n   * nothing about. The eight built-ins are NOT in here: the page renders those itself.\n   */\n  contributed: Record<string, unknown>\n}\n\n\nexport const MAX_ASSIGNMENT_GRACE_DAYS_INPUT = 365\n\nexport function toSettingsDraft(settings: TimeTrackingSettings): TimeTrackingSettingsDraft {\n  return {\n    roundingUnitMinutes: settings.rounding.unitMinutes,\n    roundingDirection: settings.rounding.direction,\n    defaultsBillable: settings.defaults.billable,\n    defaultsChainStartFromPreviousEnd: settings.defaults.chainStartFromPreviousEnd,\n    dailyHoursText: settings.targets.dailyHours === null ? '' : String(settings.targets.dailyHours),\n    warningsOverlap: settings.warnings.overlap,\n    warningsRunningTimer: settings.warnings.runningTimer,\n    assignmentGraceDaysText: String(settings.access.assignmentGraceDays),\n    contributed: Object.fromEntries(\n      contributedTimeTrackingSettingKeys().map((entry) => [\n        entry.id,\n        readTimeTrackingSettingValue(settings, entry.id),\n      ]),\n    ),\n  }\n}\n\nexport type SettingsDraftFieldError = 'dailyHours' | 'assignmentGraceDays'\n\nfunction parseDailyHours(text: string): number | null | undefined {\n  const trimmed = text.trim()\n  if (trimmed.length === 0) return null\n  const parsed = Number(trimmed.replace(',', '.'))\n  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 24) return undefined\n  return parsed\n}\n\nfunction parseGraceDays(text: string): number | undefined {\n  const trimmed = text.trim()\n  if (trimmed.length === 0) return undefined\n  const parsed = Number(trimmed)\n  if (!Number.isInteger(parsed) || parsed < 0 || parsed > MAX_ASSIGNMENT_GRACE_DAYS_INPUT) return undefined\n  return parsed\n}\n\n/** Which fields currently hold text that cannot be saved. Empty means the draft is valid. */\nexport function settingsDraftErrors(draft: TimeTrackingSettingsDraft): SettingsDraftFieldError[] {\n  const errors: SettingsDraftFieldError[] = []\n  if (parseDailyHours(draft.dailyHoursText) === undefined) errors.push('dailyHours')\n  if (parseGraceDays(draft.assignmentGraceDaysText) === undefined) errors.push('assignmentGraceDays')\n  return errors\n}\n\nexport function draftRounding(draft: TimeTrackingSettingsDraft): RoundingSettings {\n  return { unitMinutes: draft.roundingUnitMinutes, direction: draft.roundingDirection }\n}\n\n/** The PUT body. Returns null when the draft still holds unsaveable text. */\nexport function toSettingsPayload(draft: TimeTrackingSettingsDraft): TimeTrackingSettings | null {\n  const dailyHours = parseDailyHours(draft.dailyHoursText)\n  const assignmentGraceDays = parseGraceDays(draft.assignmentGraceDaysText)\n  if (dailyHours === undefined || assignmentGraceDays === undefined) return null\n  const payload: TimeTrackingSettings = {\n    rounding: draftRounding(draft),\n    defaults: {\n      billable: draft.defaultsBillable,\n      chainStartFromPreviousEnd: draft.defaultsChainStartFromPreviousEnd,\n    },\n    targets: { dailyHours },\n    warnings: { overlap: draft.warningsOverlap, runningTimer: draft.warningsRunningTimer },\n    access: { assignmentGraceDays },\n  }\n  for (const entry of contributedTimeTrackingSettingKeys()) {\n    const group = (payload[entry.group] ?? {}) as Record<string, unknown>\n    group[entry.key] = draft.contributed[entry.id]\n    payload[entry.group] = group\n  }\n  return payload\n}\n\nexport function isSettingsDraftDirty(\n  draft: TimeTrackingSettingsDraft,\n  baseline: TimeTrackingSettingsDraft,\n): boolean {\n  return (\n    draft.roundingUnitMinutes !== baseline.roundingUnitMinutes ||\n    draft.roundingDirection !== baseline.roundingDirection ||\n    draft.defaultsBillable !== baseline.defaultsBillable ||\n    draft.defaultsChainStartFromPreviousEnd !== baseline.defaultsChainStartFromPreviousEnd ||\n    draft.dailyHoursText.trim() !== baseline.dailyHoursText.trim() ||\n    draft.warningsOverlap !== baseline.warningsOverlap ||\n    draft.warningsRunningTimer !== baseline.warningsRunningTimer ||\n    draft.assignmentGraceDaysText.trim() !== baseline.assignmentGraceDaysText.trim() ||\n    contributedTimeTrackingSettingKeys().some(\n      (entry) => !Object.is(draft.contributed[entry.id], baseline.contributed[entry.id]),\n    )\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/time-tracking-ui/timesheetData.js

@@ -0,0 +1,132 @@
+import {
+  countWorkingDays,
+  eachDayIso,
+  isWeekendIso
+} from "./timesheetPeriod.js";
+import { toTimeEntryListRow } from "./timeEntryListData.js";
+import { readRowString } from "./timeEntryDialogState.js";
+function toTimesheetEntry(row, directory) {
+  const base = toTimeEntryListRow(row, directory);
+  if (!base) return null;
+  return { ...base, staffMemberId: readRowString(row, "staff_member_id", "staffMemberId") };
+}
+function buildTimesheetDays(range, entries) {
+  const byDate = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const bucket = byDate.get(entry.date);
+    if (bucket) bucket.push(entry);
+    else byDate.set(entry.date, [entry]);
+  }
+  return eachDayIso(range).map((date) => {
+    const dayEntries = (byDate.get(date) ?? []).slice().sort(compareEntriesByClock);
+    let totalMinutes = 0;
+    let billableMinutes = 0;
+    for (const entry of dayEntries) {
+      const minutes = Number.isFinite(entry.durationMinutes) ? entry.durationMinutes : 0;
+      totalMinutes += minutes;
+      if (entry.isBillable) billableMinutes += minutes;
+    }
+    return { date, isWeekend: isWeekendIso(date), entries: dayEntries, totalMinutes, billableMinutes };
+  });
+}
+function compareEntriesByClock(left, right) {
+  if (left.startText && right.startText) return left.startText.localeCompare(right.startText);
+  if (left.startText) return -1;
+  if (right.startText) return 1;
+  return 0;
+}
+function summarizeTimesheet(days, range, dailyHours) {
+  let totalMinutes = 0;
+  let billableMinutes = 0;
+  for (const day of days) {
+    totalMinutes += day.totalMinutes;
+    billableMinutes += day.billableMinutes;
+  }
+  const workingDays = countWorkingDays(range);
+  const hasTarget = typeof dailyHours === "number" && Number.isFinite(dailyHours) && dailyHours > 0;
+  const targetMinutes = hasTarget ? Math.round(workingDays * dailyHours * 60) : null;
+  return {
+    totalMinutes,
+    billableMinutes,
+    targetMinutes,
+    deltaMinutes: targetMinutes === null ? null : totalMinutes - targetMinutes,
+    workingDays
+  };
+}
+function resolveLoadScaleMinutes(days, dailyHours) {
+  if (typeof dailyHours === "number" && Number.isFinite(dailyHours) && dailyHours > 0) {
+    return Math.round(dailyHours * 60);
+  }
+  let longest = 0;
+  for (const day of days) {
+    if (day.totalMinutes > longest) longest = day.totalMinutes;
+  }
+  return longest > 0 ? longest : null;
+}
+function loadPercent(totalMinutes, scaleMinutes) {
+  if (!scaleMinutes || scaleMinutes <= 0) return 0;
+  if (totalMinutes <= 0) return 0;
+  return Math.min(100, Math.round(totalMinutes / scaleMinutes * 100));
+}
+function pickDefaultExpandedDay(days, dailyHours, todayIsoValue) {
+  const past = days.filter((day) => day.date <= todayIsoValue);
+  if (past.length === 0) return null;
+  const hasTarget = typeof dailyHours === "number" && Number.isFinite(dailyHours) && dailyHours > 0;
+  if (hasTarget) {
+    const target = Math.round(dailyHours * 60);
+    let best = null;
+    for (const day of past) {
+      if (day.isWeekend) continue;
+      const shortfall = target - day.totalMinutes;
+      if (shortfall <= 0) continue;
+      if (!best || shortfall > best.shortfall || shortfall === best.shortfall && day.date > best.date) {
+        best = { date: day.date, shortfall };
+      }
+    }
+    if (best) return best.date;
+  }
+  for (let index = past.length - 1; index >= 0; index -= 1) {
+    if (past[index].entries.length > 0) return past[index].date;
+  }
+  return null;
+}
+const CLOCK_PATTERN = /^(\d{1,2}):(\d{2})$/;
+function clockToMinutes(value) {
+  const match = CLOCK_PATTERN.exec(value);
+  if (!match) return null;
+  const hours = Number(match[1]);
+  const minutes = Number(match[2]);
+  if (hours > 23 || minutes > 59) return null;
+  return hours * 60 + minutes;
+}
+function suggestNextStartClock(day) {
+  if (!day) return null;
+  let latest = null;
+  for (const entry of day.entries) {
+    if (!entry.endText) continue;
+    const minutes = clockToMinutes(entry.endText);
+    if (minutes === null) continue;
+    if (!latest || minutes > latest.minutes) latest = { minutes, text: entry.endText };
+  }
+  return latest?.text ?? null;
+}
+function indexDaysByDate(days) {
+  const index = /* @__PURE__ */ new Map();
+  for (const day of days) index.set(day.date, day);
+  return index;
+}
+function entryChipLabel(entry, fallback) {
+  return entry.projectLabel ?? entry.taskTitle ?? entry.description ?? fallback;
+}
+export {
+  buildTimesheetDays,
+  entryChipLabel,
+  indexDaysByDate,
+  loadPercent,
+  pickDefaultExpandedDay,
+  resolveLoadScaleMinutes,
+  suggestNextStartClock,
+  summarizeTimesheet,
+  toTimesheetEntry
+};
+//# sourceMappingURL=timesheetData.js.map

package/dist/modules/staff/lib/time-tracking-ui/timesheetData.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking-ui/timesheetData.ts"],
+  "sourcesContent": ["/**\n * The reading half of the timesheet (screens 11 and 12) \u2014 day buckets, load\n * bars, the period footer and the two \"smart\" defaults the mockups ask for.\n *\n * Kept pure and out of the React tree for the same reason as `timesheetPeriod`:\n * every number a consultant will later defend in front of a client should be\n * testable as arithmetic.\n *\n * Three decisions are encoded here rather than in a component:\n *\n *  1. **A load bar has a scale even without a target.** Screen 11 note 6 is\n *     explicit that `targets.dailyHours` is a proposal; when a tenant clears it\n *     the bars scale to the longest day of the period instead of disappearing,\n *     so \"light day vs heavy day\" (US-E3) still reads at a glance.\n *  2. **Weekends do not raise the target but do raise the total** (screen 12\n *     note 4). `countWorkingDays` supplies the target; the totals sum every day.\n *  3. **Money is never summed across currencies** \u2014 this module deliberately\n *     exposes no money total at all. The timesheet is a time surface; cost lives\n *     on the entries list and the report, both of which subtotal per currency.\n */\n\nimport {\n  countWorkingDays,\n  eachDayIso,\n  isWeekendIso,\n  type TimesheetDateRange,\n} from './timesheetPeriod'\nimport { toTimeEntryListRow, type TimeEntryDirectory, type TimeEntryListRow } from './timeEntryListData'\nimport { readRowString, type ApiRow } from './timeEntryDialogState'\n\n/**\n * A timesheet row is an entries-list row plus the person who logged it \u2014 a Team\n * Leader filtering to \"everyone\" needs the author on the line (screen 12 note 1),\n * and a Team Member never sees a row that is not theirs anyway.\n */\nexport type TimesheetEntry = TimeEntryListRow & {\n  staffMemberId: string | null\n}\n\nexport function toTimesheetEntry(row: ApiRow, directory?: TimeEntryDirectory): TimesheetEntry | null {\n  const base = toTimeEntryListRow(row, directory)\n  if (!base) return null\n  return { ...base, staffMemberId: readRowString(row, 'staff_member_id', 'staffMemberId') }\n}\n\nexport type TimesheetDay = {\n  date: string\n  isWeekend: boolean\n  entries: TimesheetEntry[]\n  totalMinutes: number\n  billableMinutes: number\n}\n\nexport function buildTimesheetDays(\n  range: TimesheetDateRange,\n  entries: readonly TimesheetEntry[],\n): TimesheetDay[] {\n  const byDate = new Map<string, TimesheetEntry[]>()\n  for (const entry of entries) {\n    const bucket = byDate.get(entry.date)\n    if (bucket) bucket.push(entry)\n    else byDate.set(entry.date, [entry])\n  }\n  return eachDayIso(range).map((date) => {\n    const dayEntries = (byDate.get(date) ?? []).slice().sort(compareEntriesByClock)\n    let totalMinutes = 0\n    let billableMinutes = 0\n    for (const entry of dayEntries) {\n      const minutes = Number.isFinite(entry.durationMinutes) ? entry.durationMinutes : 0\n      totalMinutes += minutes\n      if (entry.isBillable) billableMinutes += minutes\n    }\n    return { date, isWeekend: isWeekendIso(date), entries: dayEntries, totalMinutes, billableMinutes }\n  })\n}\n\n/** Entries read top-to-bottom in the order the day was worked; clock-less ones last. */\nfunction compareEntriesByClock(left: TimesheetEntry, right: TimesheetEntry): number {\n  if (left.startText && right.startText) return left.startText.localeCompare(right.startText)\n  if (left.startText) return -1\n  if (right.startText) return 1\n  return 0\n}\n\nexport type TimesheetSummary = {\n  totalMinutes: number\n  billableMinutes: number\n  /** `null` when the tenant cleared `targets.dailyHours` \u2014 there is then nothing to be over or under. */\n  targetMinutes: number | null\n  deltaMinutes: number | null\n  workingDays: number\n}\n\nexport function summarizeTimesheet(\n  days: readonly TimesheetDay[],\n  range: TimesheetDateRange,\n  dailyHours: number | null | undefined,\n): TimesheetSummary {\n  let totalMinutes = 0\n  let billableMinutes = 0\n  for (const day of days) {\n    totalMinutes += day.totalMinutes\n    billableMinutes += day.billableMinutes\n  }\n  const workingDays = countWorkingDays(range)\n  const hasTarget = typeof dailyHours === 'number' && Number.isFinite(dailyHours) && dailyHours > 0\n  const targetMinutes = hasTarget ? Math.round(workingDays * dailyHours * 60) : null\n  return {\n    totalMinutes,\n    billableMinutes,\n    targetMinutes,\n    deltaMinutes: targetMinutes === null ? null : totalMinutes - targetMinutes,\n    workingDays,\n  }\n}\n\n/**\n * The scale a day's bar is drawn against. With a daily target it is that target,\n * so 8:00 fills the bar; without one it is the longest day in the period, so the\n * bars still rank the days against each other (screen 11 note 6).\n */\nexport function resolveLoadScaleMinutes(\n  days: readonly TimesheetDay[],\n  dailyHours: number | null | undefined,\n): number | null {\n  if (typeof dailyHours === 'number' && Number.isFinite(dailyHours) && dailyHours > 0) {\n    return Math.round(dailyHours * 60)\n  }\n  let longest = 0\n  for (const day of days) {\n    if (day.totalMinutes > longest) longest = day.totalMinutes\n  }\n  return longest > 0 ? longest : null\n}\n\n/** 0\u2013100. A day over target pins at 100 \u2014 the bar reads \"full\", the number reads the overage. */\nexport function loadPercent(totalMinutes: number, scaleMinutes: number | null): number {\n  if (!scaleMinutes || scaleMinutes <= 0) return 0\n  if (totalMinutes <= 0) return 0\n  return Math.min(100, Math.round((totalMinutes / scaleMinutes) * 100))\n}\n\n/**\n * Screen 12 note 2 \u2014 \"only the day that deviates from the target is expanded\".\n *\n * Deviation is measured against the daily target on working days that have\n * already happened; a Thursday nobody has worked yet is not a gap, it is the\n * future. The largest shortfall wins, later days breaking ties, so closing out a\n * week always opens on the day that still needs attention. With no target (or no\n * shortfall) the most recent day carrying entries is opened instead, because an\n * all-collapsed list gives the user nothing to act on.\n */\nexport function pickDefaultExpandedDay(\n  days: readonly TimesheetDay[],\n  dailyHours: number | null | undefined,\n  todayIsoValue: string,\n): string | null {\n  const past = days.filter((day) => day.date <= todayIsoValue)\n  if (past.length === 0) return null\n  const hasTarget = typeof dailyHours === 'number' && Number.isFinite(dailyHours) && dailyHours > 0\n  if (hasTarget) {\n    const target = Math.round(dailyHours * 60)\n    let best: { date: string; shortfall: number } | null = null\n    for (const day of past) {\n      if (day.isWeekend) continue\n      const shortfall = target - day.totalMinutes\n      if (shortfall <= 0) continue\n      if (!best || shortfall > best.shortfall || (shortfall === best.shortfall && day.date > best.date)) {\n        best = { date: day.date, shortfall }\n      }\n    }\n    if (best) return best.date\n  }\n  for (let index = past.length - 1; index >= 0; index -= 1) {\n    if (past[index].entries.length > 0) return past[index].date\n  }\n  return null\n}\n\nconst CLOCK_PATTERN = /^(\\d{1,2}):(\\d{2})$/\n\nfunction clockToMinutes(value: string): number | null {\n  const match = CLOCK_PATTERN.exec(value)\n  if (!match) return null\n  const hours = Number(match[1])\n  const minutes = Number(match[2])\n  if (hours > 23 || minutes > 59) return null\n  return hours * 60 + minutes\n}\n\n/**\n * Screen 12 note 3 \u2014 the quick-add row's start time is prefilled with the end of\n * the previous entry of that day. The latest end wins rather than the last row in\n * document order, so an entry added out of sequence cannot drag the suggestion\n * backwards. Returns `null` for a day whose entries carry no clocks, in which\n * case the field simply opens empty.\n */\nexport function suggestNextStartClock(day: TimesheetDay | null | undefined): string | null {\n  if (!day) return null\n  let latest: { minutes: number; text: string } | null = null\n  for (const entry of day.entries) {\n    if (!entry.endText) continue\n    const minutes = clockToMinutes(entry.endText)\n    if (minutes === null) continue\n    if (!latest || minutes > latest.minutes) latest = { minutes, text: entry.endText }\n  }\n  return latest?.text ?? null\n}\n\nexport type TimesheetDayIndex = ReadonlyMap<string, TimesheetDay>\n\nexport function indexDaysByDate(days: readonly TimesheetDay[]): TimesheetDayIndex {\n  const index = new Map<string, TimesheetDay>()\n  for (const day of days) index.set(day.date, day)\n  return index\n}\n\n/**\n * The chip label inside a calendar cell \u2014 the project when we know it, the task\n * when we do not, and the description as a last resort. A cell that shows a bare\n * dash tells the user nothing, so something always renders.\n */\nexport function entryChipLabel(entry: TimesheetEntry, fallback: string): string {\n  return entry.projectLabel ?? entry.taskTitle ?? entry.description ?? fallback\n}\n"],
+  "mappings": "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",
+  "names": []
+}