@nightkatana/kronosys-app 1.0.0-beta.0

package/lib/reportingNonFinalIndicators.ts

@@ -0,0 +1,102 @@
+import type { KronosysUpdatePayload } from "./kronosysApi";
+import { calendarDateKeyInTimeZone } from "./dashboardTimeZone";
+import {
+  UNDATED_KEY,
+  collectTasksDeduped,
+  dayInRange,
+  mergeSessionsFromPayload,
+  taskCountsTowardArchivedSessionReporting,
+  taskMatchesTags,
+} from "./reportingAggregate";
+import type { LooseSession, LooseTask } from "./reportingAggregate";
+
+function taskIncludedInReportingTaskMetrics(session: LooseSession, task: LooseTask): boolean {
+  if (session.archived === true) {
+    return taskCountsTowardArchivedSessionReporting(task);
+  }
+  return true;
+}
+
+export type ReportingNonFinalFlags = {
+  /** Session courante ouverte ou tâches « en cours » visibles dans les agrégats (données encore mouvantes). */
+  sessionsNonFinal: boolean;
+  /** Au moins une tâche non terminée dans la plage (filtres inclus) avec un @projet. */
+  projectsNonFinal: boolean;
+  /** Au moins une tâche non terminée dans la plage avec au moins une étiquette #. */
+  tagsNonFinal: boolean;
+};
+
+function sumActiveTasksAcrossDays(tasksByDayActive: Record<string, number> | undefined): number {
+  if (!tasksByDayActive) {
+    return 0;
+  }
+  let s = 0;
+  for (const v of Object.values(tasksByDayActive)) {
+    s += v ?? 0;
+  }
+  return s;
+}
+
+/**
+ * Signaux pour afficher des pastilles « données non finales » (session / projets / étiquettes).
+ */
+export function computeReportingNonFinalFlags(
+  payload: KronosysUpdatePayload | null,
+  tagSet: Set<string>,
+  dateFromTrim: string,
+  dateToTrim: string,
+  tasksByDayActive: Record<string, number> | undefined,
+  timeZone: string,
+  defaultTagBucketEnabled: boolean = true
+): ReportingNonFinalFlags {
+  const cur = payload?.current as { sessionId?: string; archived?: boolean } | undefined;
+  const liveSessionOpen = Boolean(cur?.sessionId?.trim()) && cur?.archived !== true;
+  const hasActiveTasksInAgg = sumActiveTasksAcrossDays(tasksByDayActive) > 0;
+  /** Session live ou présence de tâches non terminées dans les totaux affichés. */
+  const sessionsNonFinal = liveSessionOpen || hasActiveTasksInAgg;
+
+  let projectsNonFinal = false;
+  let tagsNonFinal = false;
+  if (!payload) {
+    return { sessionsNonFinal, projectsNonFinal, tagsNonFinal };
+  }
+
+  const from = dateFromTrim.trim() || null;
+  const to = dateToTrim.trim() || null;
+  const unbounded = !from && !to;
+  const sessions = mergeSessionsFromPayload(payload);
+
+  for (const s of sessions) {
+    const tasks = collectTasksDeduped(s);
+    const matching = tasks.filter((t) => taskMatchesTags(t, tagSet, defaultTagBucketEnabled));
+    for (const t of matching) {
+      if (!taskIncludedInReportingTaskMetrics(s, t)) {
+        continue;
+      }
+      if (t.isDone === true) {
+        continue;
+      }
+      const taskDay = calendarDateKeyInTimeZone(t.endTime ?? t.startTime, timeZone);
+      const bucket = taskDay ?? (unbounded ? UNDATED_KEY : null);
+      if (!bucket) {
+        continue;
+      }
+      if (!unbounded && !dayInRange(bucket, from, to)) {
+        continue;
+      }
+      const proj = typeof t.project === "string" ? t.project.trim() : "";
+      if (proj) {
+        projectsNonFinal = true;
+      }
+      const tags = t.tags || [];
+      if (tags.some((x) => String(x).trim().length > 0)) {
+        tagsNonFinal = true;
+      }
+      if (projectsNonFinal && tagsNonFinal) {
+        return { sessionsNonFinal, projectsNonFinal, tagsNonFinal };
+      }
+    }
+  }
+
+  return { sessionsNonFinal, projectsNonFinal, tagsNonFinal };
+}

package/lib/reportingStrings.ts

@@ -0,0 +1,491 @@
+import type { Lang } from "./dashboardCopy";
+import {
+  reportingMetricHelpEn,
+  reportingMetricHelpFr,
+  type ReportingMetricHelpBlock,
+} from "./reportingMetricHelp";
+
+export type ReportingNavStrings = {
+  dashboard: string;
+  reporting: string;
+  settings: string;
+  /** Guide d’utilisation in-app (`/guide`). */
+  guide: string;
+};
+
+export type ReportingStrings = ReportingNavStrings &
+  ReportingMetricHelpBlock & {
+  title: string;
+  subtitle: string;
+  /** Règle d’inclusion des tâches des sessions archivées dans les agrégats. */
+  archivedSessionsReportingNote: string;
+  /**
+   * Encart lorsqu’il existe du temps enregistré sur des tâches d’archives exclues des graphiques.
+   * Placeholder `{duration}` remplacé par une durée lisible (p. ex. « 6 min »).
+   */
+  reportingArchivedExcludedAside: string;
+  filtersTitle: string;
+  dateFrom: string;
+  dateTo: string;
+  today: string;
+  clearDates: string;
+  /** Efface la plage de dates et toutes les étiquettes sélectionnées. */
+  resetAllFilters: string;
+  /** Libellé du groupe de boutons jour / semaine / mois / année. */
+  presetPeriodLabel: string;
+  presetDay: string;
+  presetWeek: string;
+  presetMonth: string;
+  presetYear: string;
+  /** Précision calendrier (ex. semaine lundi–dimanche). */
+  presetPeriodHint: string;
+  tagsLabel: string;
+  tagsHint: string;
+  /** aria-label du bouton (?) — portée des filtres dates / étiquettes. */
+  filtersHelpAriaLabel: string;
+  /** Explication session vs tâche, presets, étiquettes, archives. */
+  filtersHelpBody: string;
+  /** Légende avant les pastilles vertes « données non finales » (filtres). */
+  reportingNonFinalLegend: string;
+  /** Pastille : session ou tâches en cours dans la plage. */
+  reportingNonFinalSessionsBadge: string;
+  /** Pastille : tâches non terminées avec @projet. */
+  reportingNonFinalProjectsBadge: string;
+  /** Pastille : tâches non terminées avec #étiquettes. */
+  reportingNonFinalTagsBadge: string;
+  /** Pastille courte à côté des titres de section lorsque dates ou étiquettes filtrent les données. */
+  sectionFilteredBadge: string;
+  /** Infobulle / précision sur la pastille « filtré ». */
+  sectionFilteredBadgeTitle: string;
+  summarySessionsInRange: string;
+  summaryTaskEvents: string;
+  summaryKronoFocusCompleted: string;
+  summaryKronoFocusTasksUsed: string;
+  summaryKronoFocusCycles: string;
+  summaryTaskTimeRecorded: string;
+  summarySessionCoding: string;
+  summarySessionActive: string;
+  summarySessionWallClock: string;
+  /** Sessions dont l’hôte a enregistré un début prévu (assiduité). */
+  summaryAssiduityWithReference: string;
+  /** Nombre de sessions commencées après l’heure de référence. */
+  summaryAssiduityLateSessions: string;
+  /** Somme des retards (minutes) sur les seules sessions en retard. */
+  summaryAssiduityLateTotal: string;
+  /** Retard moyen parmi les sessions en retard, ou em dash si aucune. */
+  summaryAssiduityAvgLateWhenLate: string;
+  chartSessionsPerDay: string;
+  chartTasksByStatusPerDay: string;
+  chartTaskTimePerDay: string;
+  chartSessionWallPerDay: string;
+  legendSessions: string;
+  legendDone: string;
+  legendActive: string;
+  tableDay: string;
+  tableSessions: string;
+  tableDone: string;
+  tableActive: string;
+  /** Temps enregistré sur les tâches (durationMs), par jour de tâche. */
+  tableTaskTime: string;
+  /** Temps de codage session (codingMinutesSession), par jour de session. */
+  tableSessionCoding: string;
+  tableSessionWall: string;
+  undatedLabel: string;
+  loading: string;
+  noRowsInRange: string;
+  /** Tableau temps par projet. */
+  projectSectionTitle: string;
+  /** Sous-titre calendrier hebdo par @projet. */
+  projectWeeklyCalendarTitle: string;
+  projectColProject: string;
+  projectColTasks: string;
+  projectColTime: string;
+  projectUnassigned: string;
+  projectTableHint: string;
+  /** Temps tâche par #tag — usage type affectation WBS / NWA (SAP). */
+  tagTimeSectionTitle: string;
+  tagTimeSectionHint: string;
+  tagTimeByDayTitle: string;
+  tagTimeByWeekTitle: string;
+  tagWeekStartsOnLegend: string;
+  weekStartsMonday: string;
+  weekStartsSunday: string;
+  weekStartsSaturday: string;
+  tagWeekSumColumn: string;
+  tagTimeColTag: string;
+  tagTimeColDay: string;
+  tagTimeColMinutes: string;
+  tagTimeUntagged: string;
+  /** aria-label du bouton chevron : ligne regroupant les étiquettes projet#code sous @projet. */
+  tagWeekScopedRollupToggleAria: string;
+  summaryLinesWrittenTotal: string;
+  summaryLinesWrittenHuman: string;
+  summaryLinesWrittenAi: string;
+  locByLanguageSectionTitle: string;
+  locByLanguageColLang: string;
+  locByLanguageColLines: string;
+  codingSignalsSectionTitle: string;
+  codingSignalsColLang: string;
+  codingSignalsColCount: string;
+  locMetricsHint: string;
+  workspaceSnapshotTitle: string;
+  workspaceSnapshotIntro: string;
+  workspaceSnapshotRefresh: string;
+  workspaceSnapshotRefreshing: string;
+  workspaceSnapshotSourceGit: string;
+  workspaceSnapshotSourceWalk: string;
+  workspaceSnapshotTotalLines: string;
+  workspaceSnapshotFileCount: string;
+  workspaceSnapshotColLang: string;
+  workspaceSnapshotColLines: string;
+  workspaceSnapshotColPercent: string;
+  workspaceSnapshotNoWorkspace: string;
+  workspaceSnapshotEmpty: string;
+  workspaceSnapshotError: string;
+  /** Indication lorsque l’instantané semble indisponible ou obsolète. */
+  workspaceSnapshotRefreshHint: string;
+  /** Sommaire de page (navigation interne). */
+  tocTitle: string;
+  tocNavAria: string;
+  /** Libellé court pour la grille d’indicateurs (pas de titre visible dans la section). */
+  tocSummaryKpis: string;
+  /** Libellé pour le tableau jour / sessions / tâches. */
+  tocDailyTable: string;
+  tocTagTimeSection: string;
+  /** Navigation entre semaines (graphiques + tableau + calendrier par étiquette). */
+  weekNavPrev: string;
+  weekNavNext: string;
+  weekNavAriaLabel: string;
+  tocWeekNav: string;
+  weekNavHelpHint: string;
+  weekNavNoTagDataThisWeek: string;
+  weekNavNoProjectDataThisWeek: string;
+  /** Section lignes écrites + tableaux par langage (agrégés). */
+  tocLocSection: string;
+  /** Bouton flottant retour en haut de page. */
+  scrollToTopAria: string;
+  };
+
+const en: ReportingStrings = {
+  dashboard: "Dashboard",
+  reporting: "Reporting",
+  settings: "Settings",
+  guide: "User guide",
+  title: "Reporting",
+  subtitle:
+    "Aggregates from Kronosys history (local API). Filter by date range and tags. Task time by @project is included.",
+  archivedSessionsReportingNote:
+    "Archived sessions: task rows, recorded task time, time by project, and per-task KronoFocus counts include only tasks marked done with every subtask checked. Session-level coding and active time still cover the whole session.",
+  reportingArchivedExcludedAside:
+    "Besides the KPI totals above, {duration} is logged on archived tasks that charts exclude (task not done, or a checklist item still open). That time does not appear in time-by-project or by-tag views.",
+  filtersTitle: "Filters",
+  dateFrom: "From",
+  dateTo: "To",
+  today: "Today",
+  clearDates: "All dates",
+  resetAllFilters: "Reset filters",
+  presetPeriodLabel: "Quick range",
+  presetDay: "Day",
+  presetWeek: "Week",
+  presetMonth: "Month",
+  presetYear: "Year",
+  presetPeriodHint: "Week is Monday–Sunday (local dates). “Day” is today.",
+  tagsLabel: "Tags",
+  tagsHint: "Leave empty to include all tasks. Sessions are included only if at least one task matches.",
+  filtersHelpAriaLabel: "How reporting filters apply",
+  filtersHelpBody: `Where dates and tags apply on this page
+
+• Workspace folder snapshot (lines in the open project): ignores filters — not Kronosys history.
+
+• Summary KPIs, charts, day-by-day table: filters apply. Session-day side: session count, session coding/active/wall time, KronoFocus sessions completed, lines written, and (when the host stored a planned start) punctuality aggregates: reference count, late session count, cumulative and average late minutes. Task-day side: task rows, recorded task time, done/in-progress counts, task KronoFocus used/cycles.
+
+• “Lines by language” and “Coding signals” tables: session day within the range; with tags selected, a whole session is dropped if no task matches (same rule as elsewhere).
+
+• Week navigation: does not re-filter; it picks which week to show among data already in range.
+
+• Recorded time by #tag (day list + weekly calendars): task day + tag filter.
+
+• Recorded time by @project (weekly calendars): task day + tag filter (there is no separate @project filter).
+
+Reminder — two “day” notions
+
+• Session metrics use the session day (saved or end).
+
+• Task metrics use the task day (end or start).
+
+Quick presets set the range; “Week” is Monday–Sunday (local), which may differ from “week starts on” for the weekly calendars only.
+
+Tags: with at least one tag selected, any session with no matching task is excluded entirely.
+
+Archived sessions: task-based metrics only count fully completed tasks (subtasks included) — see the summary indicators help as well.`,
+  reportingNonFinalLegend: "Open work —",
+  reportingNonFinalSessionsBadge: "Sessions",
+  reportingNonFinalProjectsBadge: "Projects",
+  reportingNonFinalTagsBadge: "Tags",
+  sectionFilteredBadge: "Filtered",
+  sectionFilteredBadgeTitle: "These figures reflect the date range and tag filters at the top of the page.",
+  summarySessionsInRange: "Sessions (in range)",
+  summaryTaskEvents: "Task rows (in range)",
+  summaryKronoFocusCompleted: "KronoFocus sessions completed (session total)",
+  summaryKronoFocusTasksUsed: "Tasks with KronoFocus used",
+  summaryKronoFocusCycles: "KronoFocus cycles (tasks)",
+  summaryTaskTimeRecorded: "Recorded task time",
+  summarySessionCoding: "Session coding time",
+  summarySessionActive: "Session active time",
+  summarySessionWallClock: "Session wall-clock time",
+  summaryAssiduityWithReference: "Sessions (planned start recorded)",
+  summaryAssiduityLateSessions: "Late starts (after planned time)",
+  summaryAssiduityLateTotal: "Cumulative late time",
+  summaryAssiduityAvgLateWhenLate: "Average late (when late)",
+  chartSessionsPerDay: "Sessions per day",
+  chartTasksByStatusPerDay: "Tasks per day by status",
+  chartTaskTimePerDay: "Recorded task time per day",
+  chartSessionWallPerDay: "Session wall-clock time per day",
+  legendSessions: "Sessions",
+  legendDone: "Done",
+  legendActive: "In progress",
+  tableDay: "Day",
+  tableSessions: "Sessions",
+  tableDone: "Done",
+  tableActive: "Active",
+  tableTaskTime: "Task time",
+  tableSessionCoding: "Session coding",
+  tableSessionWall: "Session span",
+  undatedLabel: "Undated",
+  loading: "Loading…",
+  noRowsInRange: "No data in this range for the current filters.",
+  projectSectionTitle: "Recorded time by project",
+  projectWeeklyCalendarTitle: "Weekly calendar",
+  projectColProject: "Project",
+  projectColTasks: "Tasks",
+  projectColTime: "Recorded time",
+  projectUnassigned: "(no project)",
+  projectTableHint:
+    "One line per calendar week, then one table: each @project on its own row, seven day columns and a week total — same week navigation and week-start setting as the tag calendar above.",
+  tagTimeSectionTitle: "Recorded task time by tag",
+  tagTimeSectionHint:
+    "Map each #tag to an external key (e.g. SAP WBS or NWA). A task’s full recorded time is counted under every tag on that task (tag totals can overlap). In the by-day table and the weekly calendar, several `project#code` tags for the same project (same day or same week) appear under one @project row—expand to see each tag line.",
+  tagTimeByDayTitle: "By calendar day",
+  tagTimeByWeekTitle: "Weekly calendar",
+  tagWeekStartsOnLegend: "Week starts on",
+  weekStartsMonday: "Monday",
+  weekStartsSunday: "Sunday",
+  weekStartsSaturday: "Saturday",
+  tagWeekSumColumn: "Week Σ",
+  tagTimeColTag: "Tag",
+  tagTimeColDay: "Task day",
+  tagTimeColMinutes: "Recorded time",
+  tagTimeUntagged: "default",
+  tagWeekScopedRollupToggleAria: "Show or hide per-tag breakdown for this project",
+  summaryLinesWrittenTotal: "Lines written (sessions in range)",
+  summaryLinesWrittenHuman: "Lines — human (est., sum)",
+  summaryLinesWrittenAi: "Lines — AI (est., sum)",
+  locByLanguageSectionTitle: "Lines by language (aggregated)",
+  locByLanguageColLang: "Language",
+  locByLanguageColLines: "Lines",
+  codingSignalsSectionTitle: "Coding signals by language (aggregated)",
+  codingSignalsColLang: "Language",
+  codingSignalsColCount: "Signals",
+  locMetricsHint:
+    "Totals sum each session’s stored counters for sessions included in the range (same rule as session coding time). Tag filter still excludes whole sessions with no matching task.",
+  workspaceSnapshotTitle: "Open folder — lines by language (snapshot)",
+  workspaceSnapshotIntro:
+    "Independent of sessions and tasks: approximate line counts in the first workspace folder (tracked files via Git when available, otherwise a walk with common extensions). Cached ~5 minutes.",
+  workspaceSnapshotRefresh: "Refresh snapshot",
+  workspaceSnapshotRefreshing: "Refreshing…",
+  workspaceSnapshotSourceGit: "Source: Git tracked files",
+  workspaceSnapshotSourceWalk: "Source: folder walk (non-Git or empty ls-files)",
+  workspaceSnapshotTotalLines: "Total lines (approx.)",
+  workspaceSnapshotFileCount: "Files scanned",
+  workspaceSnapshotColLang: "Language",
+  workspaceSnapshotColLines: "Lines",
+  workspaceSnapshotColPercent: "Share",
+  workspaceSnapshotNoWorkspace: "No workspace root configured for the snapshot.",
+  workspaceSnapshotEmpty: "No matching source files found.",
+  workspaceSnapshotError: "Could not build snapshot.",
+  workspaceSnapshotRefreshHint: "Use “Refresh snapshot” after changing workspace paths or exclusions in Settings.",
+  tocTitle: "On this page",
+  tocNavAria: "Reporting — sections on this page",
+  tocSummaryKpis: "Summary indicators",
+  tocDailyTable: "Day-by-day table",
+  tocTagTimeSection: "Time by tag",
+  weekNavPrev: "Previous week",
+  weekNavNext: "Next week",
+  weekNavAriaLabel: "Week navigation for charts and tables",
+  tocWeekNav: "Week navigation",
+  weekNavHelpHint:
+    "Shown when several weeks in the range have session data (wall-clock time or session count), or otherwise weeks from recorded task time by tag or by project. Charts, the day table, and the weekly calendars follow the selected week.",
+  weekNavNoTagDataThisWeek: "No recorded task time for this week.",
+  weekNavNoProjectDataThisWeek: "No recorded task time by project for this week.",
+  tocLocSection: "Lines & coding signals",
+  scrollToTopAria: "Back to top",
+  ...reportingMetricHelpEn,
+};
+
+const fr: ReportingStrings = {
+  dashboard: "Tableau de bord",
+  reporting: "Rapports",
+  settings: "Paramètres",
+  guide: "Guide d’utilisation",
+  title: "Rapports",
+  subtitle:
+    "Agrégats à partir de l’historique Kronosys (API locale). Filtrez par plage de dates et par étiquettes. Le temps par @projet est inclus.",
+  archivedSessionsReportingNote:
+    "Sessions archivées : les lignes de tâches, le temps enregistré sur les tâches, le temps par projet et les comptes KronoFocus par tâche ne retiennent que les tâches marquées terminées dont toutes les sous-tâches sont cochées. Les temps de codage et d’activité au niveau session restent ceux de la session entière.",
+  reportingArchivedExcludedAside:
+    "En complément des indicateurs ci-dessus, {duration} figure sur des tâches d’archives que les graphiques excluent (tâche non terminée ou point non coché). Ce temps n’apparaît pas dans le temps par projet ni par étiquette.",
+  filtersTitle: "Filtres",
+  dateFrom: "Du",
+  dateTo: "Au",
+  today: "Aujourd’hui",
+  clearDates: "Toutes les dates",
+  resetAllFilters: "Réinitialiser les filtres",
+  presetPeriodLabel: "Période rapide",
+  presetDay: "Jour",
+  presetWeek: "Semaine",
+  presetMonth: "Mois",
+  presetYear: "Année",
+  presetPeriodHint: "La semaine va du lundi au dimanche (dates locales). « Jour » = aujourd’hui.",
+  tagsLabel: "Étiquettes",
+  tagsHint:
+    "Laissez vide pour toutes les tâches. Une session n’est comptée que si au moins une tâche correspond.",
+  filtersHelpAriaLabel: "Comment s’appliquent les filtres des rapports",
+  filtersHelpBody: `Où agissent les dates et les étiquettes sur cette page
+
+• Instantané « Dossier ouvert » (lignes par langage du workspace) : hors filtres — ce n’est pas l’historique Kronosys.
+
+• Indicateurs de synthèse, graphiques, tableau par jour : la plage et les étiquettes s’appliquent. Côté jour de session : nombre de sessions, temps de codage et d’activité, durée murale, KronoFocus « sessions terminées », lignes écrites, et (si l’hôte a enregistré un début prévu) indicateurs d’assiduité : sessions avec référence, sessions en retard, retard cumulé, retard moyen lorsqu’en retard. Côté jour de tâche : lignes de tâches, temps enregistré, tâches terminées / en cours, KronoFocus côté tâches.
+
+• Tableaux « Lignes par langage » et « Signaux de codage » : jour de session dans la plage ; avec étiquettes sélectionnées, toute la session est exclue si aucune tâche ne correspond (même règle qu’ailleurs).
+
+• Navigation par semaine : ne refiltre pas les données ; elle choisit la semaine affichée parmi celles déjà retenues par la plage.
+
+• Temps enregistré par #étiquette (liste par jour + calendriers hebdo) : jour de tâche + filtre d’étiquettes.
+
+• Temps enregistré par @projet (calendriers hebdo) : jour de tâche + filtre d’étiquettes (pas de filtre séparé sur le nom de projet).
+
+Rappel — deux notions de « jour »
+
+• Les indicateurs « session » utilisent le jour de la session (enregistrement ou fin).
+
+• Les indicateurs « tâche » utilisent le jour de la tâche (fin ou début).
+
+Les périodes rapides fixent la plage ; « Semaine » = lundi–dimanche (local), ce qui peut différer du réglage « La semaine commence » des seuls calendriers hebdomadaires.
+
+Étiquettes : dès qu’au moins une étiquette est choisie, toute session sans aucune tâche correspondante est entièrement exclue.
+
+Sessions archivées : pour les métriques basées sur les tâches, seules les tâches entièrement bouclées (sous-tâches comprises) sont prises en compte — voir aussi l’aide des indicateurs de synthèse.`,
+  reportingNonFinalLegend: "Travail ouvert —",
+  reportingNonFinalSessionsBadge: "Sessions",
+  reportingNonFinalProjectsBadge: "Projets",
+  reportingNonFinalTagsBadge: "Étiquettes",
+  sectionFilteredBadge: "Filtré",
+  sectionFilteredBadgeTitle:
+    "Ces chiffres tiennent compte de la plage de dates et des étiquettes choisies en haut de page.",
+  summarySessionsInRange: "Sessions (plage)",
+  summaryTaskEvents: "Lignes de tâches (plage)",
+  summaryKronoFocusCompleted: "Sessions KronoFocus terminées (total par session)",
+  summaryKronoFocusTasksUsed: "Tâches avec KronoFocus utilisé",
+  summaryKronoFocusCycles: "Cycles KronoFocus (tâches)",
+  summaryTaskTimeRecorded: "Temps enregistré sur les tâches",
+  summarySessionCoding: "Temps de codage (sessions)",
+  summarySessionActive: "Temps actif (sessions)",
+  summarySessionWallClock: "Durée murale des sessions",
+  summaryAssiduityWithReference: "Sessions (début prévu enregistré)",
+  summaryAssiduityLateSessions: "Départs en retard (après l’heure prévue)",
+  summaryAssiduityLateTotal: "Retard cumulé",
+  summaryAssiduityAvgLateWhenLate: "Retard moyen (si en retard)",
+  chartSessionsPerDay: "Sessions par jour",
+  chartTasksByStatusPerDay: "Tâches par jour et par statut",
+  chartTaskTimePerDay: "Temps enregistré sur les tâches par jour",
+  chartSessionWallPerDay: "Durée murale des sessions par jour",
+  legendSessions: "Sessions",
+  legendDone: "Terminées",
+  legendActive: "En cours",
+  tableDay: "Jour",
+  tableSessions: "Sessions",
+  tableDone: "Terminées",
+  tableActive: "En cours",
+  tableTaskTime: "Temps (tâches)",
+  tableSessionCoding: "Codage (sessions)",
+  tableSessionWall: "Durée session",
+  undatedLabel: "Sans date",
+  loading: "Chargement…",
+  noRowsInRange: "Aucune donnée dans cette plage pour les filtres actuels.",
+  projectSectionTitle: "Temps enregistré par projet",
+  projectWeeklyCalendarTitle: "Calendrier hebdomadaire",
+  projectColProject: "Projet",
+  projectColTasks: "Tâches",
+  projectColTime: "Temps enregistré",
+  projectUnassigned: "(sans projet)",
+  projectTableHint:
+    "Une ligne par semaine calendaire, puis un tableau : chaque @projet sur sa propre ligne, sept colonnes jour et le total de la semaine — même navigation par semaine et même premier jour de semaine que le calendrier par étiquette ci-dessus.",
+  tagTimeSectionTitle: "Temps enregistré par étiquette",
+  tagTimeSectionHint:
+    "Chaque #tag peut correspondre à une clé externe (ex. poste WBS ou NWA dans SAP). La durée enregistrée complète d’une tâche est comptée pour chaque étiquette associée (les totaux par étiquette peuvent se chevaucher). Dans le tableau par jour et le calendrier hebdomadaire, plusieurs étiquettes `projet#code` pour un même projet (même jour ou même semaine) sont regroupées sous une ligne @projet : développez-la pour voir chaque ligne d’étiquette.",
+  tagTimeByDayTitle: "Par jour calendaire",
+  tagTimeByWeekTitle: "Calendrier hebdomadaire",
+  tagWeekStartsOnLegend: "La semaine commence",
+  weekStartsMonday: "Lundi",
+  weekStartsSunday: "Dimanche",
+  weekStartsSaturday: "Samedi",
+  tagWeekSumColumn: "Σ semaine",
+  tagTimeColTag: "Étiquette",
+  tagTimeColDay: "Jour (tâche)",
+  tagTimeColMinutes: "Temps enregistré",
+  tagTimeUntagged: "défaut",
+  tagWeekScopedRollupToggleAria: "Afficher ou masquer le détail des étiquettes pour ce projet",
+  summaryLinesWrittenTotal: "Lignes écrites (sessions dans la plage)",
+  summaryLinesWrittenHuman: "Lignes — humain (estim., somme)",
+  summaryLinesWrittenAi: "Lignes — IA (estim., somme)",
+  locByLanguageSectionTitle: "Lignes par langage (agrégé)",
+  locByLanguageColLang: "Langage",
+  locByLanguageColLines: "Lignes",
+  codingSignalsSectionTitle: "Signaux de codage par langage (agrégé)",
+  codingSignalsColLang: "Langage",
+  codingSignalsColCount: "Signaux",
+  locMetricsHint:
+    "Les totaux additionnent les compteurs enregistrés par session pour les sessions dans la plage (même règle que le temps de codage des sessions). Le filtre d’étiquettes exclut encore toute la session si aucune tâche ne correspond.",
+  workspaceSnapshotTitle: "Dossier ouvert — lignes par langage (instantané)",
+  workspaceSnapshotIntro:
+    "Indépendant des sessions et des tâches : estimation du nombre de lignes dans le premier dossier du workspace (fichiers suivis par Git si possible, sinon parcours avec extensions courantes). Mise en cache ~5 minutes.",
+  workspaceSnapshotRefresh: "Rafraîchir l’instantané",
+  workspaceSnapshotRefreshing: "Actualisation…",
+  workspaceSnapshotSourceGit: "Source : fichiers suivis par Git",
+  workspaceSnapshotSourceWalk: "Source : parcours du dossier (sans Git ou liste Git vide)",
+  workspaceSnapshotTotalLines: "Total de lignes (approx.)",
+  workspaceSnapshotFileCount: "Fichiers parcourus",
+  workspaceSnapshotColLang: "Langage",
+  workspaceSnapshotColLines: "Lignes",
+  workspaceSnapshotColPercent: "Part",
+  workspaceSnapshotNoWorkspace: "Aucune racine de workspace configurée pour l’instantané.",
+  workspaceSnapshotEmpty: "Aucun fichier source correspondant trouvé.",
+  workspaceSnapshotError: "Impossible de construire l’instantané.",
+  workspaceSnapshotRefreshHint:
+    "Utilisez « Rafraîchir l’instantané » après un changement de chemins ou d’exclusions du workspace dans les paramètres.",
+  tocTitle: "Sur cette page",
+  tocNavAria: "Rapports — sections de la page",
+  tocSummaryKpis: "Indicateurs de synthèse",
+  tocDailyTable: "Tableau par jour",
+  tocTagTimeSection: "Temps par étiquette",
+  weekNavPrev: "Semaine précédente",
+  weekNavNext: "Semaine suivante",
+  weekNavAriaLabel: "Navigation par semaine pour les graphiques et tableaux",
+  tocWeekNav: "Navigation par semaine",
+  weekNavHelpHint:
+    "Affiché lorsque plusieurs semaines dans la plage ont des données de session (durée murale ou nombre de sessions), sinon des semaines issues du temps enregistré par étiquette ou par projet. Les graphiques, le tableau par jour et les calendriers hebdomadaires suivent la semaine sélectionnée.",
+  weekNavNoTagDataThisWeek: "Aucun temps de tâche enregistré pour cette semaine.",
+  weekNavNoProjectDataThisWeek: "Aucun temps de tâche par projet pour cette semaine.",
+  tocLocSection: "Lignes et signaux de codage",
+  scrollToTopAria: "Retour en haut de la page",
+  ...reportingMetricHelpFr,
+};
+
+export function reportingStrings(lang: Lang): ReportingStrings {
+  return lang === "fr" ? fr : en;
+}
+
+export function reportingNav(lang: Lang): ReportingNavStrings {
+  const s = reportingStrings(lang);
+  return { dashboard: s.dashboard, reporting: s.reporting, settings: s.settings, guide: s.guide };
+}