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

package/dist/modules/staff/lib/timesheets-reports/reportConfigData.js

@@ -0,0 +1,135 @@
+function readString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function readNumber(value) {
+  if (typeof value === "number") return Number.isFinite(value) ? value : null;
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+  return null;
+}
+function toCandidateProject(row) {
+  const id = readString(row.id);
+  if (!id) return null;
+  return {
+    id,
+    name: readString(row.name) ?? readString(row.code) ?? id,
+    hourlyRate: readNumber(row.hourly_rate ?? row.hourlyRate),
+    currencyCode: readString(row.currency_code ?? row.currencyCode)
+  };
+}
+function toLine(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const row = raw;
+  const key = readString(row.key);
+  if (key === null) return null;
+  return {
+    key,
+    label: readString(row.label) ?? key,
+    minutes: readNumber(row.minutes) ?? 0,
+    rate: readNumber(row.rate),
+    amount: readNumber(row.amount) ?? 0,
+    entryCount: readNumber(row.entryCount) ?? 0,
+    hasOverride: row.hasOverride === true,
+    children: Array.isArray(row.children) ? row.children.map(toLine).filter((line) => line !== null) : []
+  };
+}
+function parseReportPreview(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  const row = payload;
+  const totalsRaw = row.totals ?? {};
+  const roundingRaw = row.rounding ?? {};
+  const grouping = row.grouping;
+  const nonbillableMode = row.nonbillableMode;
+  return {
+    currencyCode: readString(row.currencyCode),
+    grouping: grouping === "project_person" || grouping === "project_day" ? grouping : "project_task",
+    nonbillableMode: nonbillableMode === "exclude" ? "exclude" : "separate",
+    includeAlreadyReported: row.includeAlreadyReported === true,
+    showRates: row.showRates === true,
+    projects: Array.isArray(row.projects) ? row.projects.map((entry) => {
+      if (!entry || typeof entry !== "object") return null;
+      const project = entry;
+      const id = readString(project.id);
+      if (!id) return null;
+      return {
+        id,
+        name: readString(project.name) ?? id,
+        hourlyRate: readNumber(project.hourlyRate),
+        currencyCode: readString(project.currencyCode),
+        entryCount: readNumber(project.entryCount) ?? 0,
+        billableMinutes: readNumber(project.billableMinutes) ?? 0,
+        nonbillableMinutes: readNumber(project.nonbillableMinutes) ?? 0,
+        amount: readNumber(project.amount)
+      };
+    }).filter((project) => project !== null) : [],
+    groups: Array.isArray(row.groups) ? row.groups.map((entry) => {
+      if (!entry || typeof entry !== "object") return null;
+      const group = entry;
+      const key = readString(group.key);
+      if (key === null) return null;
+      return {
+        key,
+        kind: group.kind === "nonbillable" ? "nonbillable" : "project",
+        label: readString(group.label) ?? key,
+        rate: readNumber(group.rate),
+        minutes: readNumber(group.minutes) ?? 0,
+        amount: readNumber(group.amount) ?? 0,
+        entryCount: readNumber(group.entryCount) ?? 0,
+        lines: Array.isArray(group.lines) ? group.lines.map(toLine).filter((line) => line !== null) : []
+      };
+    }).filter((group) => group !== null) : [],
+    totals: {
+      entryCount: readNumber(totalsRaw.entryCount) ?? 0,
+      billableMinutes: readNumber(totalsRaw.billableMinutes) ?? 0,
+      nonbillableMinutes: readNumber(totalsRaw.nonbillableMinutes) ?? 0,
+      totalAmount: readNumber(totalsRaw.totalAmount)
+    },
+    alreadyReportedCount: readNumber(row.alreadyReportedCount) ?? 0,
+    alreadyReportedMinutes: readNumber(row.alreadyReportedMinutes) ?? 0,
+    alreadyReportedIn: Array.isArray(row.alreadyReportedIn) ? row.alreadyReportedIn.map((entry) => {
+      if (!entry || typeof entry !== "object") return null;
+      const source = entry;
+      const reportId = readString(source.reportId);
+      if (!reportId) return null;
+      return {
+        reportId,
+        reference: readString(source.reference),
+        title: readString(source.title),
+        entryCount: readNumber(source.entryCount) ?? 0,
+        minutes: readNumber(source.minutes) ?? 0
+      };
+    }).filter((source) => source !== null) : [],
+    rounding: {
+      unitMinutes: readNumber(roundingRaw.unitMinutes) ?? 0,
+      direction: readString(roundingRaw.direction) ?? "up"
+    }
+  };
+}
+function readCurrencyConflict(error) {
+  const body = error?.body ?? error;
+  if (!body || typeof body !== "object") return null;
+  const row = body;
+  if (row.code !== "report_currency_conflict") return null;
+  const currencies = Array.isArray(row.currencies) ? row.currencies.filter((code) => typeof code === "string") : [];
+  const offenders = Array.isArray(row.offenders) ? row.offenders.map((entry) => {
+    if (!entry || typeof entry !== "object") return null;
+    const offender = entry;
+    const id = readString(offender.id);
+    if (!id) return null;
+    return {
+      id,
+      name: readString(offender.name) ?? id,
+      currencyCode: readString(offender.currencyCode)
+    };
+  }).filter((offender) => offender !== null) : [];
+  return { currencies, offenders };
+}
+export {
+  parseReportPreview,
+  readCurrencyConflict,
+  readNumber,
+  toCandidateProject
+};
+//# sourceMappingURL=reportConfigData.js.map

package/dist/modules/staff/lib/timesheets-reports/reportConfigData.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportConfigData.ts"],
+  "sourcesContent": ["/**\n * Client-side shapes for the report config screen (13) and the preview endpoint\n * that feeds it. Kept out of the page component so the parsing is unit-testable\n * without mounting React.\n */\n\nexport type ReportCandidateProject = {\n  id: string\n  name: string\n  hourlyRate: number | null\n  currencyCode: string | null\n}\n\nexport type PreviewProjectRow = {\n  id: string\n  name: string\n  hourlyRate: number | null\n  currencyCode: string | null\n  entryCount: number\n  billableMinutes: number\n  nonbillableMinutes: number\n  amount: number | null\n}\n\nexport type PreviewAlreadyReportedSource = {\n  reportId: string\n  reference: string | null\n  title: string | null\n  entryCount: number\n  minutes: number\n}\n\nexport type PreviewLine = {\n  key: string\n  label: string\n  minutes: number\n  rate: number | null\n  amount: number\n  entryCount: number\n  hasOverride: boolean\n  children: PreviewLine[]\n}\n\nexport type PreviewGroup = {\n  key: string\n  kind: 'project' | 'nonbillable'\n  label: string\n  rate: number | null\n  minutes: number\n  amount: number\n  entryCount: number\n  lines: PreviewLine[]\n}\n\nexport type ReportPreview = {\n  currencyCode: string | null\n  grouping: 'project_task' | 'project_person' | 'project_day'\n  nonbillableMode: 'separate' | 'exclude'\n  includeAlreadyReported: boolean\n  showRates: boolean\n  projects: PreviewProjectRow[]\n  groups: PreviewGroup[]\n  totals: {\n    entryCount: number\n    billableMinutes: number\n    nonbillableMinutes: number\n    totalAmount: number | null\n  }\n  alreadyReportedCount: number\n  alreadyReportedMinutes: number\n  alreadyReportedIn: PreviewAlreadyReportedSource[]\n  rounding: { unitMinutes: number; direction: string }\n}\n\nfunction readString(value: unknown): string | null {\n  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null\n}\n\nexport function readNumber(value: unknown): number | null {\n  if (typeof value === 'number') return Number.isFinite(value) ? value : null\n  if (typeof value === 'string' && value.trim().length > 0) {\n    const parsed = Number.parseFloat(value)\n    return Number.isFinite(parsed) ? parsed : null\n  }\n  return null\n}\n\n/** Maps a `/time-projects` list row onto the pick-list's candidate shape. */\nexport function toCandidateProject(row: Record<string, unknown>): ReportCandidateProject | null {\n  const id = readString(row.id)\n  if (!id) return null\n  return {\n    id,\n    name: readString(row.name) ?? readString(row.code) ?? id,\n    hourlyRate: readNumber(row.hourly_rate ?? row.hourlyRate),\n    currencyCode: readString(row.currency_code ?? row.currencyCode),\n  }\n}\n\nfunction toLine(raw: unknown): PreviewLine | null {\n  if (!raw || typeof raw !== 'object') return null\n  const row = raw as Record<string, unknown>\n  const key = readString(row.key)\n  if (key === null) return null\n  return {\n    key,\n    label: readString(row.label) ?? key,\n    minutes: readNumber(row.minutes) ?? 0,\n    rate: readNumber(row.rate),\n    amount: readNumber(row.amount) ?? 0,\n    entryCount: readNumber(row.entryCount) ?? 0,\n    hasOverride: row.hasOverride === true,\n    children: Array.isArray(row.children)\n      ? row.children.map(toLine).filter((line): line is PreviewLine => line !== null)\n      : [],\n  }\n}\n\n/**\n * Defensive because the preview response is money the screen renders verbatim:\n * a shape surprise must yield an empty sheet, never a plausible-looking wrong\n * number. Missing amounts read as `null` and are rendered as \"\u2014\".\n */\nexport function parseReportPreview(payload: unknown): ReportPreview | null {\n  if (!payload || typeof payload !== 'object') return null\n  const row = payload as Record<string, unknown>\n  const totalsRaw = (row.totals ?? {}) as Record<string, unknown>\n  const roundingRaw = (row.rounding ?? {}) as Record<string, unknown>\n  const grouping = row.grouping\n  const nonbillableMode = row.nonbillableMode\n\n  return {\n    currencyCode: readString(row.currencyCode),\n    grouping:\n      grouping === 'project_person' || grouping === 'project_day' ? grouping : 'project_task',\n    nonbillableMode: nonbillableMode === 'exclude' ? 'exclude' : 'separate',\n    includeAlreadyReported: row.includeAlreadyReported === true,\n    showRates: row.showRates === true,\n    projects: Array.isArray(row.projects)\n      ? row.projects\n          .map((entry) => {\n            if (!entry || typeof entry !== 'object') return null\n            const project = entry as Record<string, unknown>\n            const id = readString(project.id)\n            if (!id) return null\n            return {\n              id,\n              name: readString(project.name) ?? id,\n              hourlyRate: readNumber(project.hourlyRate),\n              currencyCode: readString(project.currencyCode),\n              entryCount: readNumber(project.entryCount) ?? 0,\n              billableMinutes: readNumber(project.billableMinutes) ?? 0,\n              nonbillableMinutes: readNumber(project.nonbillableMinutes) ?? 0,\n              amount: readNumber(project.amount),\n            } satisfies PreviewProjectRow\n          })\n          .filter((project): project is PreviewProjectRow => project !== null)\n      : [],\n    groups: Array.isArray(row.groups)\n      ? row.groups\n          .map((entry) => {\n            if (!entry || typeof entry !== 'object') return null\n            const group = entry as Record<string, unknown>\n            const key = readString(group.key)\n            if (key === null) return null\n            return {\n              key,\n              kind: group.kind === 'nonbillable' ? 'nonbillable' : 'project',\n              label: readString(group.label) ?? key,\n              rate: readNumber(group.rate),\n              minutes: readNumber(group.minutes) ?? 0,\n              amount: readNumber(group.amount) ?? 0,\n              entryCount: readNumber(group.entryCount) ?? 0,\n              lines: Array.isArray(group.lines)\n                ? group.lines.map(toLine).filter((line): line is PreviewLine => line !== null)\n                : [],\n            } satisfies PreviewGroup\n          })\n          .filter((group): group is PreviewGroup => group !== null)\n      : [],\n    totals: {\n      entryCount: readNumber(totalsRaw.entryCount) ?? 0,\n      billableMinutes: readNumber(totalsRaw.billableMinutes) ?? 0,\n      nonbillableMinutes: readNumber(totalsRaw.nonbillableMinutes) ?? 0,\n      totalAmount: readNumber(totalsRaw.totalAmount),\n    },\n    alreadyReportedCount: readNumber(row.alreadyReportedCount) ?? 0,\n    alreadyReportedMinutes: readNumber(row.alreadyReportedMinutes) ?? 0,\n    alreadyReportedIn: Array.isArray(row.alreadyReportedIn)\n      ? row.alreadyReportedIn\n          .map((entry) => {\n            if (!entry || typeof entry !== 'object') return null\n            const source = entry as Record<string, unknown>\n            const reportId = readString(source.reportId)\n            if (!reportId) return null\n            return {\n              reportId,\n              reference: readString(source.reference),\n              title: readString(source.title),\n              entryCount: readNumber(source.entryCount) ?? 0,\n              minutes: readNumber(source.minutes) ?? 0,\n            } satisfies PreviewAlreadyReportedSource\n          })\n          .filter((source): source is PreviewAlreadyReportedSource => source !== null)\n      : [],\n    rounding: {\n      unitMinutes: readNumber(roundingRaw.unitMinutes) ?? 0,\n      direction: readString(roundingRaw.direction) ?? 'up',\n    },\n  }\n}\n\nexport type CurrencyConflict = {\n  currencies: string[]\n  offenders: Array<{ id: string; name: string; currencyCode: string | null }>\n}\n\n/**\n * Risk R2 surfaced rather than swallowed. The server refuses a mixed selection\n * with `422 report_currency_conflict`; the screen has to be able to say WHICH\n * projects disagree, or the user is left toggling checkboxes at random.\n */\nexport function readCurrencyConflict(error: unknown): CurrencyConflict | null {\n  const body = (error as { body?: unknown } | null)?.body ?? error\n  if (!body || typeof body !== 'object') return null\n  const row = body as Record<string, unknown>\n  if (row.code !== 'report_currency_conflict') return null\n  const currencies = Array.isArray(row.currencies)\n    ? row.currencies.filter((code): code is string => typeof code === 'string')\n    : []\n  const offenders = Array.isArray(row.offenders)\n    ? row.offenders\n        .map((entry) => {\n          if (!entry || typeof entry !== 'object') return null\n          const offender = entry as Record<string, unknown>\n          const id = readString(offender.id)\n          if (!id) return null\n          return {\n            id,\n            name: readString(offender.name) ?? id,\n            currencyCode: readString(offender.currencyCode),\n          }\n        })\n        .filter((offender): offender is CurrencyConflict['offenders'][number] => offender !== null)\n    : []\n  return { currencies, offenders }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/reportConfigState.js

@@ -0,0 +1,48 @@
+import { resolvePeriodRange, todayIso } from "../time-tracking-ui/timesheetPeriod.js";
+const REPORT_PERIOD_PRESETS = ["week", "month", "year"];
+function isReportPeriodPreset(value) {
+  return value === "week" || value === "month" || value === "year";
+}
+function presetRange(kind, anchorIso = todayIso()) {
+  return resolvePeriodRange(kind, anchorIso);
+}
+function initialReportPeriod(anchorIso = todayIso()) {
+  const range = presetRange("month", anchorIso);
+  return { kind: "month", from: range.from, to: range.to };
+}
+function applyPreset(state, kind, anchorIso = todayIso()) {
+  const anchor = state.from || anchorIso;
+  const range = presetRange(kind, anchor);
+  return { kind, from: range.from, to: range.to };
+}
+function applyBound(state, bound, value) {
+  const current = bound === "from" ? state.from : state.to;
+  if (value === current) return state;
+  const next = { ...state, [bound]: value };
+  next.kind = "custom";
+  return next;
+}
+function isValidReportPeriod(state) {
+  if (!state.from || !state.to) return false;
+  return state.to >= state.from;
+}
+function spansMultipleMonths(state) {
+  if (!state.from || !state.to) return false;
+  return state.from.slice(0, 7) !== state.to.slice(0, 7);
+}
+function defaultReportTitle(customerName, period, fallbackCustomer) {
+  const name = customerName && customerName.trim().length > 0 ? customerName.trim() : fallbackCustomer;
+  return `${name} \xB7 ${period.from} \u2013 ${period.to}`;
+}
+export {
+  REPORT_PERIOD_PRESETS,
+  applyBound,
+  applyPreset,
+  defaultReportTitle,
+  initialReportPeriod,
+  isReportPeriodPreset,
+  isValidReportPeriod,
+  presetRange,
+  spansMultipleMonths
+};
+//# sourceMappingURL=reportConfigState.js.map

package/dist/modules/staff/lib/timesheets-reports/reportConfigState.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportConfigState.ts"],
+  "sourcesContent": ["/**\n * D-4 made executable: a period preset FILLS an editable From/To pair, and the\n * moment either date is moved by hand the report's `period_kind` becomes\n * `custom`.\n *\n * The mockup drew fixed Week / Month / Year buttons and \u00A78 described the same,\n * but consulting invoices rarely stop at a calendar boundary \u2014 the screen 13\n * example is itself a 1 June \u2013 19 July range. Rather than choosing between the\n * two, the preset is a shortcut that seeds the dates and then gets out of the\n * way. Keeping the preset highlighted after the user moved a date would be a\n * lie about what is going to be reported, so it is dropped rather than kept.\n */\n\nimport { resolvePeriodRange, todayIso, type TimesheetDateRange } from '../time-tracking-ui/timesheetPeriod'\n\nexport type ReportPeriodKind = 'week' | 'month' | 'year' | 'custom'\n\nexport const REPORT_PERIOD_PRESETS: readonly Exclude<ReportPeriodKind, 'custom'>[] = ['week', 'month', 'year']\n\nexport type ReportPeriodState = {\n  kind: ReportPeriodKind\n  from: string\n  to: string\n}\n\nexport function isReportPeriodPreset(value: unknown): value is Exclude<ReportPeriodKind, 'custom'> {\n  return value === 'week' || value === 'month' || value === 'year'\n}\n\nexport function presetRange(\n  kind: Exclude<ReportPeriodKind, 'custom'>,\n  anchorIso: string = todayIso(),\n): TimesheetDateRange {\n  return resolvePeriodRange(kind, anchorIso)\n}\n\nexport function initialReportPeriod(anchorIso: string = todayIso()): ReportPeriodState {\n  const range = presetRange('month', anchorIso)\n  return { kind: 'month', from: range.from, to: range.to }\n}\n\n/** Applying a preset replaces both dates and restores the preset kind. */\nexport function applyPreset(\n  state: ReportPeriodState,\n  kind: Exclude<ReportPeriodKind, 'custom'>,\n  anchorIso: string = todayIso(),\n): ReportPeriodState {\n  // Anchor on the range the user is already looking at so \"Month\" next to a\n  // June range means June, not whatever month it happens to be today.\n  const anchor = state.from || anchorIso\n  const range = presetRange(kind, anchor)\n  return { kind, from: range.from, to: range.to }\n}\n\n/**\n * Moving a bound by hand. The kind drops to `custom` only when the date actually\n * changed, so re-typing the same value does not silently relabel the period.\n */\nexport function applyBound(\n  state: ReportPeriodState,\n  bound: 'from' | 'to',\n  value: string,\n): ReportPeriodState {\n  const current = bound === 'from' ? state.from : state.to\n  if (value === current) return state\n  const next: ReportPeriodState = { ...state, [bound]: value } as ReportPeriodState\n  next.kind = 'custom'\n  return next\n}\n\nexport function isValidReportPeriod(state: ReportPeriodState): boolean {\n  if (!state.from || !state.to) return false\n  return state.to >= state.from\n}\n\n/** The period spans more than one calendar month, which screen 13 calls out. */\nexport function spansMultipleMonths(state: ReportPeriodState): boolean {\n  if (!state.from || !state.to) return false\n  return state.from.slice(0, 7) !== state.to.slice(0, 7)\n}\n\nexport function defaultReportTitle(\n  customerName: string | null,\n  period: ReportPeriodState,\n  fallbackCustomer: string,\n): string {\n  const name = customerName && customerName.trim().length > 0 ? customerName.trim() : fallbackCustomer\n  return `${name} \u00B7 ${period.from} \u2013 ${period.to}`\n}\n"],
+  "mappings": "AAaA,SAAS,oBAAoB,gBAAyC;AAI/D,MAAM,wBAAwE,CAAC,QAAQ,SAAS,MAAM;AAQtG,SAAS,qBAAqB,OAA8D;AACjG,SAAO,UAAU,UAAU,UAAU,WAAW,UAAU;AAC5D;AAEO,SAAS,YACd,MACA,YAAoB,SAAS,GACT;AACpB,SAAO,mBAAmB,MAAM,SAAS;AAC3C;AAEO,SAAS,oBAAoB,YAAoB,SAAS,GAAsB;AACrF,QAAM,QAAQ,YAAY,SAAS,SAAS;AAC5C,SAAO,EAAE,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI,MAAM,GAAG;AACzD;AAGO,SAAS,YACd,OACA,MACA,YAAoB,SAAS,GACV;AAGnB,QAAM,SAAS,MAAM,QAAQ;AAC7B,QAAM,QAAQ,YAAY,MAAM,MAAM;AACtC,SAAO,EAAE,MAAM,MAAM,MAAM,MAAM,IAAI,MAAM,GAAG;AAChD;AAMO,SAAS,WACd,OACA,OACA,OACmB;AACnB,QAAM,UAAU,UAAU,SAAS,MAAM,OAAO,MAAM;AACtD,MAAI,UAAU,QAAS,QAAO;AAC9B,QAAM,OAA0B,EAAE,GAAG,OAAO,CAAC,KAAK,GAAG,MAAM;AAC3D,OAAK,OAAO;AACZ,SAAO;AACT;AAEO,SAAS,oBAAoB,OAAmC;AACrE,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,GAAI,QAAO;AACrC,SAAO,MAAM,MAAM,MAAM;AAC3B;AAGO,SAAS,oBAAoB,OAAmC;AACrE,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,GAAI,QAAO;AACrC,SAAO,MAAM,KAAK,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC;AACvD;AAEO,SAAS,mBACd,cACA,QACA,kBACQ;AACR,QAAM,OAAO,gBAAgB,aAAa,KAAK,EAAE,SAAS,IAAI,aAAa,KAAK,IAAI;AACpF,SAAO,GAAG,IAAI,SAAM,OAAO,IAAI,WAAM,OAAO,EAAE;AAChD;",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/reportExport.js

@@ -0,0 +1,262 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { serializeExport } from "@open-mercato/shared/lib/crud/exporters";
+import { buildPdf, PDF_CONTENT_TYPE } from "./pdf.js";
+import { buildXlsx, XLSX_CONTENT_TYPE } from "./xlsx.js";
+import { formatReportMinutes } from "./reportTotals.js";
+import {
+  getReportExportFormat,
+  registerBuiltInReportExportFormat,
+  reportExportFormatIds
+} from "./reportExportFormats.js";
+const logger = createLogger("staff").child({ component: "timesheets-reports/reportExport" });
+function normalizeReportExportFormat(value) {
+  if (typeof value !== "string") return null;
+  return getReportExportFormat(value) ? value : null;
+}
+function supportedReportExportFormats() {
+  return reportExportFormatIds();
+}
+function formatAmount(value, currencyCode) {
+  if (value === null || value === void 0) return "\u2014";
+  const fixed = value.toFixed(2);
+  return currencyCode ? `${fixed} ${currencyCode}` : fixed;
+}
+const COLUMN_LABEL_X = 42;
+const COLUMN_TIME_X = 400;
+const COLUMN_RATE_X = 470;
+const COLUMN_AMOUNT_X = 553;
+function pdfLinesForLine(line, depth, isNonBillable, showRates, currencyCode, labels) {
+  const label = line.hasOverride ? `${line.label} (${labels.overrideBadge})` : line.label;
+  const cells = [
+    { text: `${"    ".repeat(depth)}${label}`, x: COLUMN_LABEL_X, muted: depth > 0 },
+    { text: formatReportMinutes(line.minutes), x: COLUMN_TIME_X, align: "right" }
+  ];
+  if (showRates) {
+    cells.push({
+      text: isNonBillable ? "\u2014" : formatAmount(line.rate, null),
+      x: COLUMN_RATE_X,
+      align: "right"
+    });
+  }
+  cells.push({
+    text: isNonBillable ? "\u2014" : formatAmount(line.amount, null),
+    x: COLUMN_AMOUNT_X,
+    align: "right"
+  });
+  return [
+    { kind: "cells", cells },
+    ...line.children.flatMap(
+      (child) => pdfLinesForLine(child, depth + 1, isNonBillable, showRates, currencyCode, labels)
+    )
+  ];
+}
+function buildReportPdfLines(input) {
+  const { labels } = input;
+  const lines = [
+    {
+      kind: "cells",
+      cells: [{ text: labels.documentTitle, x: COLUMN_LABEL_X, size: 8, muted: true }]
+    },
+    { kind: "cells", cells: [{ text: input.customerName, x: COLUMN_LABEL_X, size: 15, bold: true }] },
+    { kind: "cells", cells: [{ text: input.periodLabel, x: COLUMN_LABEL_X, muted: true }] },
+    {
+      kind: "cells",
+      cells: [
+        {
+          text: `${labels.reference}: ${input.reference}`,
+          x: COLUMN_AMOUNT_X,
+          align: "right",
+          muted: true
+        }
+      ]
+    }
+  ];
+  if (input.issuedByLabel) {
+    lines.push({
+      kind: "cells",
+      cells: [
+        {
+          text: `${labels.issuedBy}: ${input.issuedByLabel}${input.issuedAtLabel ? ` \xB7 ${input.issuedAtLabel}` : ""}`,
+          x: COLUMN_AMOUNT_X,
+          align: "right",
+          muted: true
+        }
+      ]
+    });
+  }
+  lines.push({ kind: "space", height: 10 }, { kind: "rule" });
+  for (const group of input.groups) {
+    const isNonBillable = group.kind === "nonbillable";
+    lines.push({
+      kind: "cells",
+      cells: [
+        { text: group.label, x: COLUMN_LABEL_X, bold: true },
+        { text: formatReportMinutes(group.minutes), x: COLUMN_TIME_X, align: "right", bold: true },
+        {
+          text: formatAmount(isNonBillable ? 0 : group.amount, input.currencyCode),
+          x: COLUMN_AMOUNT_X,
+          align: "right",
+          bold: true
+        }
+      ]
+    });
+    if (input.showRates && !isNonBillable && group.rate !== null) {
+      lines.push({
+        kind: "cells",
+        cells: [{ text: `${formatAmount(group.rate, input.currencyCode)}/h`, x: COLUMN_LABEL_X, muted: true, size: 8 }]
+      });
+    }
+    const header = [
+      { text: labels.line, x: COLUMN_LABEL_X, size: 8, muted: true },
+      { text: labels.time, x: COLUMN_TIME_X, align: "right", size: 8, muted: true }
+    ];
+    if (input.showRates) {
+      header.push({ text: labels.rate, x: COLUMN_RATE_X, align: "right", size: 8, muted: true });
+    }
+    header.push({ text: labels.amount, x: COLUMN_AMOUNT_X, align: "right", size: 8, muted: true });
+    lines.push({ kind: "cells", cells: header });
+    for (const line of group.lines) {
+      lines.push(
+        ...pdfLinesForLine(line, 0, isNonBillable, input.showRates, input.currencyCode, labels)
+      );
+    }
+    lines.push({ kind: "space", height: 8 }, { kind: "rule" });
+  }
+  lines.push(
+    {
+      kind: "cells",
+      cells: [
+        { text: labels.total, x: COLUMN_LABEL_X, bold: true, size: 11 },
+        {
+          text: formatAmount(input.totals.totalAmount, input.currencyCode),
+          x: COLUMN_AMOUNT_X,
+          align: "right",
+          bold: true,
+          size: 11
+        }
+      ]
+    },
+    {
+      kind: "cells",
+      cells: [
+        {
+          text: labels.totalHint.replace("{billable}", formatReportMinutes(input.totals.billableMinutes)).replace("{nonbillable}", formatReportMinutes(input.totals.nonbillableMinutes)).replace("{rounding}", input.roundingLabel),
+          x: COLUMN_LABEL_X,
+          size: 8,
+          muted: true
+        }
+      ]
+    }
+  );
+  return lines;
+}
+function buildReportTable(input) {
+  const { labels } = input;
+  const columns = [
+    { field: "date", header: labels.date },
+    { field: "project", header: labels.project },
+    { field: "task", header: labels.task },
+    { field: "person", header: labels.person },
+    { field: "description", header: labels.description },
+    { field: "rawMinutes", header: labels.rawMinutes },
+    { field: "roundedMinutes", header: labels.roundedMinutes },
+    { field: "hours", header: labels.time },
+    { field: "billable", header: labels.billable },
+    ...input.showRates ? [{ field: "rate", header: labels.rate }] : [],
+    { field: "amount", header: labels.amount }
+  ];
+  const rows = input.rows.map((row) => {
+    const record = {
+      date: row.date,
+      project: row.projectName,
+      task: row.taskLabel,
+      person: row.personLabel,
+      description: row.description,
+      rawMinutes: row.rawMinutes,
+      roundedMinutes: row.minutes,
+      hours: row.hours,
+      billable: row.isBillable ? labels.yes : labels.no,
+      amount: row.amount === null ? "" : row.amount.toFixed(2)
+    };
+    if (input.showRates) record.rate = row.rate === null ? "" : row.rate.toFixed(2);
+    return record;
+  });
+  return { columns, rows };
+}
+function exportBaseName(input) {
+  return input.reference || "report";
+}
+registerBuiltInReportExportFormat({
+  id: "pdf",
+  labelKey: "staff.time_tracking.reports.export.format.pdf",
+  mimeType: PDF_CONTENT_TYPE,
+  extension: "pdf",
+  serialize: (input) => ({
+    body: buildPdf({ title: input.title, lines: buildReportPdfLines(input) }),
+    contentType: PDF_CONTENT_TYPE,
+    filename: `${exportBaseName(input)}.pdf`
+  })
+});
+registerBuiltInReportExportFormat({
+  id: "csv",
+  labelKey: "staff.time_tracking.reports.export.format.csv",
+  mimeType: "text/csv",
+  extension: "csv",
+  serialize: (input) => {
+    const serialized = serializeExport(buildReportTable(input), "csv");
+    return {
+      // The BOM is what makes Excel open a UTF-8 CSV with Polish names intact
+      // instead of mojibake; every other consumer ignores it.
+      body: Buffer.concat([Buffer.from("\uFEFF", "utf8"), Buffer.from(serialized.body, "utf8")]),
+      contentType: serialized.contentType,
+      filename: `${exportBaseName(input)}.csv`
+    };
+  }
+});
+registerBuiltInReportExportFormat({
+  id: "xlsx",
+  labelKey: "staff.time_tracking.reports.export.format.xlsx",
+  mimeType: XLSX_CONTENT_TYPE,
+  extension: "xlsx",
+  serialize: (input) => {
+    const table = buildReportTable(input);
+    const rows = [
+      table.columns.map((column) => column.header),
+      ...table.rows.map(
+        (row) => table.columns.map((column) => {
+          const value = row[column.field];
+          if (column.field === "rate" || column.field === "amount") {
+            const parsed = typeof value === "string" && value.length > 0 ? Number.parseFloat(value) : null;
+            return parsed !== null && Number.isFinite(parsed) ? parsed : "";
+          }
+          return typeof value === "number" ? value : value === null || value === void 0 ? "" : String(value);
+        })
+      )
+    ];
+    return {
+      body: buildXlsx({ name: exportBaseName(input).slice(0, 31), rows }),
+      contentType: XLSX_CONTENT_TYPE,
+      filename: `${exportBaseName(input)}.xlsx`
+    };
+  }
+});
+function serializeReportExport(format, input) {
+  const definition = getReportExportFormat(format);
+  if (!definition) {
+    throw new Error(`[internal] unknown report export format: ${String(format)}`);
+  }
+  try {
+    return definition.serialize(input);
+  } catch (err) {
+    logger.error("a report export format failed to serialize", { format: definition.id, err });
+    throw new Error(`[internal] report export format ${definition.id} failed to serialize`);
+  }
+}
+export {
+  buildReportPdfLines,
+  buildReportTable,
+  normalizeReportExportFormat,
+  serializeReportExport,
+  supportedReportExportFormats
+};
+//# sourceMappingURL=reportExport.js.map

package/dist/modules/staff/lib/timesheets-reports/reportExport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportExport.ts"],
+  "sourcesContent": ["/**\n * Turning a computed report into the three deliverables of US-G4.\n *\n * Screen 14 note 3 sets the split: **PDF mirrors the sheet** the client is\n * shown \u2014 the same groups, the same rolled-up lines, the same grand total \u2014 and\n * **CSV/XLSX add the raw columns** (date, person, description) an accounts\n * department reconciles against. All three honour the current grouping, the\n * filters, the rounding and the currency, because all three are built from the\n * same `ReportSheet` the screen rendered.\n *\n * No format locks anything (screen 14 note 5). Exporting appends an `exported`\n * event and nothing else.\n */\n\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { serializeExport, type PreparedExport } from '@open-mercato/shared/lib/crud/exporters'\nimport { buildPdf, PDF_CONTENT_TYPE, type PdfLine } from './pdf'\nimport { buildXlsx, XLSX_CONTENT_TYPE } from './xlsx'\nimport { formatReportMinutes, type ReportGroup, type ReportLine } from './reportTotals'\nimport type { ReportRow } from './reportRows'\nimport {\n  getReportExportFormat,\n  registerBuiltInReportExportFormat,\n  reportExportFormatIds,\n  type ReportExportFormat,\n} from './reportExportFormats'\n\nconst logger = createLogger('staff').child({ component: 'timesheets-reports/reportExport' })\n\nexport type { ReportExportFormat }\n\n/**\n * EP-35: the accepted set is the registry, not a literal union, so a contributed\n * format is accepted here and documented by the route's OpenAPI enum without\n * either being edited.\n */\nexport function normalizeReportExportFormat(value: unknown): ReportExportFormat | null {\n  if (typeof value !== 'string') return null\n  return getReportExportFormat(value) ? value : null\n}\n\nexport function supportedReportExportFormats(): string[] {\n  return reportExportFormatIds()\n}\n\nexport type ReportExportLabels = {\n  documentTitle: string\n  issuedBy: string\n  reference: string\n  period: string\n  line: string\n  time: string\n  rate: string\n  amount: string\n  total: string\n  totalHint: string\n  nonbillable: string\n  overrideBadge: string\n  date: string\n  project: string\n  task: string\n  person: string\n  description: string\n  billable: string\n  yes: string\n  no: string\n  rawMinutes: string\n  roundedMinutes: string\n}\n\nexport type ReportExportInput = {\n  reference: string\n  title: string\n  customerName: string\n  periodLabel: string\n  issuedByLabel: string | null\n  issuedAtLabel: string | null\n  currencyCode: string | null\n  showRates: boolean\n  groups: readonly ReportGroup[]\n  rows: readonly ReportRow[]\n  totals: { billableMinutes: number; nonbillableMinutes: number; totalAmount: number }\n  roundingLabel: string\n  labels: ReportExportLabels\n}\n\nexport type SerializedReportExport = {\n  body: Buffer\n  contentType: string\n  filename: string\n}\n\nfunction formatAmount(value: number | null | undefined, currencyCode: string | null): string {\n  if (value === null || value === undefined) return '\u2014'\n  const fixed = value.toFixed(2)\n  return currencyCode ? `${fixed} ${currencyCode}` : fixed\n}\n\nconst COLUMN_LABEL_X = 42\nconst COLUMN_TIME_X = 400\nconst COLUMN_RATE_X = 470\nconst COLUMN_AMOUNT_X = 553\n\n/** Recursion is one level deep by construction (D-2), but written generally. */\nfunction pdfLinesForLine(\n  line: ReportLine,\n  depth: number,\n  isNonBillable: boolean,\n  showRates: boolean,\n  currencyCode: string | null,\n  labels: ReportExportLabels,\n): PdfLine[] {\n  const label = line.hasOverride ? `${line.label} (${labels.overrideBadge})` : line.label\n  const cells = [\n    { text: `${'    '.repeat(depth)}${label}`, x: COLUMN_LABEL_X, muted: depth > 0 },\n    { text: formatReportMinutes(line.minutes), x: COLUMN_TIME_X, align: 'right' as const },\n  ]\n  if (showRates) {\n    cells.push({\n      text: isNonBillable ? '\u2014' : formatAmount(line.rate, null),\n      x: COLUMN_RATE_X,\n      align: 'right' as const,\n    })\n  }\n  cells.push({\n    text: isNonBillable ? '\u2014' : formatAmount(line.amount, null),\n    x: COLUMN_AMOUNT_X,\n    align: 'right' as const,\n  })\n\n  return [\n    { kind: 'cells', cells },\n    ...line.children.flatMap((child) =>\n      pdfLinesForLine(child, depth + 1, isNonBillable, showRates, currencyCode, labels),\n    ),\n  ]\n}\n\n/** The PDF mirrors the on-screen sheet, group for group and line for line. */\nexport function buildReportPdfLines(input: ReportExportInput): PdfLine[] {\n  const { labels } = input\n  const lines: PdfLine[] = [\n    {\n      kind: 'cells',\n      cells: [{ text: labels.documentTitle, x: COLUMN_LABEL_X, size: 8, muted: true }],\n    },\n    { kind: 'cells', cells: [{ text: input.customerName, x: COLUMN_LABEL_X, size: 15, bold: true }] },\n    { kind: 'cells', cells: [{ text: input.periodLabel, x: COLUMN_LABEL_X, muted: true }] },\n    {\n      kind: 'cells',\n      cells: [\n        {\n          text: `${labels.reference}: ${input.reference}`,\n          x: COLUMN_AMOUNT_X,\n          align: 'right',\n          muted: true,\n        },\n      ],\n    },\n  ]\n  if (input.issuedByLabel) {\n    lines.push({\n      kind: 'cells',\n      cells: [\n        {\n          text: `${labels.issuedBy}: ${input.issuedByLabel}${input.issuedAtLabel ? ` \u00B7 ${input.issuedAtLabel}` : ''}`,\n          x: COLUMN_AMOUNT_X,\n          align: 'right',\n          muted: true,\n        },\n      ],\n    })\n  }\n  lines.push({ kind: 'space', height: 10 }, { kind: 'rule' })\n\n  for (const group of input.groups) {\n    const isNonBillable = group.kind === 'nonbillable'\n    lines.push({\n      kind: 'cells',\n      cells: [\n        { text: group.label, x: COLUMN_LABEL_X, bold: true },\n        { text: formatReportMinutes(group.minutes), x: COLUMN_TIME_X, align: 'right', bold: true },\n        {\n          text: formatAmount(isNonBillable ? 0 : group.amount, input.currencyCode),\n          x: COLUMN_AMOUNT_X,\n          align: 'right',\n          bold: true,\n        },\n      ],\n    })\n    if (input.showRates && !isNonBillable && group.rate !== null) {\n      lines.push({\n        kind: 'cells',\n        cells: [{ text: `${formatAmount(group.rate, input.currencyCode)}/h`, x: COLUMN_LABEL_X, muted: true, size: 8 }],\n      })\n    }\n\n    const header = [\n      { text: labels.line, x: COLUMN_LABEL_X, size: 8, muted: true },\n      { text: labels.time, x: COLUMN_TIME_X, align: 'right' as const, size: 8, muted: true },\n    ]\n    if (input.showRates) {\n      header.push({ text: labels.rate, x: COLUMN_RATE_X, align: 'right' as const, size: 8, muted: true })\n    }\n    header.push({ text: labels.amount, x: COLUMN_AMOUNT_X, align: 'right' as const, size: 8, muted: true })\n    lines.push({ kind: 'cells', cells: header })\n\n    for (const line of group.lines) {\n      lines.push(\n        ...pdfLinesForLine(line, 0, isNonBillable, input.showRates, input.currencyCode, labels),\n      )\n    }\n    lines.push({ kind: 'space', height: 8 }, { kind: 'rule' })\n  }\n\n  lines.push(\n    {\n      kind: 'cells',\n      cells: [\n        { text: labels.total, x: COLUMN_LABEL_X, bold: true, size: 11 },\n        {\n          text: formatAmount(input.totals.totalAmount, input.currencyCode),\n          x: COLUMN_AMOUNT_X,\n          align: 'right',\n          bold: true,\n          size: 11,\n        },\n      ],\n    },\n    {\n      kind: 'cells',\n      cells: [\n        {\n          text: labels.totalHint\n            .replace('{billable}', formatReportMinutes(input.totals.billableMinutes))\n            .replace('{nonbillable}', formatReportMinutes(input.totals.nonbillableMinutes))\n            .replace('{rounding}', input.roundingLabel),\n          x: COLUMN_LABEL_X,\n          size: 8,\n          muted: true,\n        },\n      ],\n    },\n  )\n\n  return lines\n}\n\n/**\n * The raw table. `rawMinutes` sits beside `roundedMinutes` on purpose: the\n * difference between them IS the rounding, and an accountant asking why an\n * amount is what it is should be able to see it rather than derive it.\n */\nexport function buildReportTable(input: ReportExportInput): PreparedExport {\n  const { labels } = input\n  const columns = [\n    { field: 'date', header: labels.date },\n    { field: 'project', header: labels.project },\n    { field: 'task', header: labels.task },\n    { field: 'person', header: labels.person },\n    { field: 'description', header: labels.description },\n    { field: 'rawMinutes', header: labels.rawMinutes },\n    { field: 'roundedMinutes', header: labels.roundedMinutes },\n    { field: 'hours', header: labels.time },\n    { field: 'billable', header: labels.billable },\n    ...(input.showRates ? [{ field: 'rate', header: labels.rate }] : []),\n    { field: 'amount', header: labels.amount },\n  ]\n\n  const rows = input.rows.map((row) => {\n    const record: Record<string, unknown> = {\n      date: row.date,\n      project: row.projectName,\n      task: row.taskLabel,\n      person: row.personLabel,\n      description: row.description,\n      rawMinutes: row.rawMinutes,\n      roundedMinutes: row.minutes,\n      hours: row.hours,\n      billable: row.isBillable ? labels.yes : labels.no,\n      amount: row.amount === null ? '' : row.amount.toFixed(2),\n    }\n    if (input.showRates) record.rate = row.rate === null ? '' : row.rate.toFixed(2)\n    return record\n  })\n\n  return { columns, rows }\n}\n\nfunction exportBaseName(input: ReportExportInput): string {\n  return input.reference || 'report'\n}\n\nregisterBuiltInReportExportFormat({\n  id: 'pdf',\n  labelKey: 'staff.time_tracking.reports.export.format.pdf',\n  mimeType: PDF_CONTENT_TYPE,\n  extension: 'pdf',\n  serialize: (input) => ({\n    body: buildPdf({ title: input.title, lines: buildReportPdfLines(input) }),\n    contentType: PDF_CONTENT_TYPE,\n    filename: `${exportBaseName(input)}.pdf`,\n  }),\n})\n\nregisterBuiltInReportExportFormat({\n  id: 'csv',\n  labelKey: 'staff.time_tracking.reports.export.format.csv',\n  mimeType: 'text/csv',\n  extension: 'csv',\n  serialize: (input) => {\n    const serialized = serializeExport(buildReportTable(input), 'csv')\n    return {\n      // The BOM is what makes Excel open a UTF-8 CSV with Polish names intact\n      // instead of mojibake; every other consumer ignores it.\n      body: Buffer.concat([Buffer.from('\uFEFF', 'utf8'), Buffer.from(serialized.body, 'utf8')]),\n      contentType: serialized.contentType,\n      filename: `${exportBaseName(input)}.csv`,\n    }\n  },\n})\n\nregisterBuiltInReportExportFormat({\n  id: 'xlsx',\n  labelKey: 'staff.time_tracking.reports.export.format.xlsx',\n  mimeType: XLSX_CONTENT_TYPE,\n  extension: 'xlsx',\n  serialize: (input) => {\n    const table = buildReportTable(input)\n    const rows = [\n      table.columns.map((column) => column.header),\n      ...table.rows.map((row) =>\n        table.columns.map((column) => {\n          const value = row[column.field]\n          if (column.field === 'rate' || column.field === 'amount') {\n            const parsed = typeof value === 'string' && value.length > 0 ? Number.parseFloat(value) : null\n            return parsed !== null && Number.isFinite(parsed) ? parsed : ''\n          }\n          return typeof value === 'number' ? value : value === null || value === undefined ? '' : String(value)\n        }),\n      ),\n    ]\n    return {\n      body: buildXlsx({ name: exportBaseName(input).slice(0, 31), rows }),\n      contentType: XLSX_CONTENT_TYPE,\n      filename: `${exportBaseName(input)}.xlsx`,\n    }\n  },\n})\n\n/**\n * A contributed `serialize` is the one strategy whose failure cannot be absorbed:\n * the caller asked for a named format and every fallback would answer with bytes of\n * a different type under the requested filename and MIME. So the throw propagates \u2014\n * but it is caught and re-raised as an internal error naming the format, so the one\n * request fails with something diagnosable instead of a stack trace from a third\n * party's serializer.\n */\nexport function serializeReportExport(\n  format: ReportExportFormat,\n  input: ReportExportInput,\n): SerializedReportExport {\n  const definition = getReportExportFormat(format)\n  if (!definition) {\n    throw new Error(`[internal] unknown report export format: ${String(format)}`)\n  }\n  try {\n    return definition.serialize(input)\n  } catch (err) {\n    logger.error('a report export format failed to serialize', { format: definition.id, err })\n    throw new Error(`[internal] report export format ${definition.id} failed to serialize`)\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/staff/lib/timesheets-reports/reportExportFormats.js

@@ -0,0 +1,34 @@
+import { extensionPoints } from "@open-mercato/core/modules/staff/extension-points";
+import { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from "../time-tracking/registries/registry.js";
+const BUILT_IN_REPORT_EXPORT_FORMAT_IDS = ["pdf", "csv", "xlsx"];
+const REPORT_EXPORT_FORMAT_REGISTRY_ID = extensionPoints.hosts.reportExportFormatRegistry.spotId;
+const registry = createStrategyRegistry(REPORT_EXPORT_FORMAT_REGISTRY_ID);
+function registerReportExportFormat(format) {
+  return registry.register(format);
+}
+function registerBuiltInReportExportFormat(format) {
+  registry.registerBuiltIn({ ...format, priority: BUILT_IN_STRATEGY_PRIORITY });
+  return () => {
+  };
+}
+function listReportExportFormats() {
+  return registry.list();
+}
+function reportExportFormatIds() {
+  const builtIn = BUILT_IN_REPORT_EXPORT_FORMAT_IDS.filter((id) => registry.has(id));
+  const contributed = registry.ids().filter((id) => !builtIn.includes(id));
+  return [...builtIn, ...contributed];
+}
+function getReportExportFormat(id) {
+  return registry.get(id);
+}
+export {
+  BUILT_IN_REPORT_EXPORT_FORMAT_IDS,
+  REPORT_EXPORT_FORMAT_REGISTRY_ID,
+  getReportExportFormat,
+  listReportExportFormats,
+  registerBuiltInReportExportFormat,
+  registerReportExportFormat,
+  reportExportFormatIds
+};
+//# sourceMappingURL=reportExportFormats.js.map

package/dist/modules/staff/lib/timesheets-reports/reportExportFormats.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/timesheets-reports/reportExportFormats.ts"],
+  "sourcesContent": ["/**\n * EP-35 \u2014 the report export format registry.\n *\n * It lives beside `reportExport.ts` rather than inside it because the built-in\n * `pdf`/`csv`/`xlsx` serializers ARE that file: keeping the registry here lets\n * `reportExport.ts` register into it at module load without an import cycle.\n *\n * Every consumer of the format list \u2014 `normalizeReportExportFormat`, the export\n * route's OpenAPI query enum, the 400 body listing the accepted formats \u2014 reads\n * this registry, so a contributed format is accepted and documented without\n * touching either file.\n */\n\nimport { extensionPoints } from '@open-mercato/core/modules/staff/extension-points'\nimport { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from '../time-tracking/registries/registry'\nimport type { ReportExportInput, SerializedReportExport } from './reportExport'\n\nexport const BUILT_IN_REPORT_EXPORT_FORMAT_IDS = ['pdf', 'csv', 'xlsx'] as const\n\nexport type BuiltInReportExportFormat = (typeof BUILT_IN_REPORT_EXPORT_FORMAT_IDS)[number]\n\n/**\n * Widened from the original `'pdf' | 'csv' | 'xlsx'` union so a contributed id\n * is assignable. The union arm keeps the three built-ins as completions.\n */\nexport type ReportExportFormat = BuiltInReportExportFormat | (string & {})\n\nexport type ReportExportFormatDefinition = {\n  id: string\n  labelKey: string\n  mimeType: string\n  extension: string\n  priority?: number\n  serialize(input: ReportExportInput): SerializedReportExport\n}\n\nexport const REPORT_EXPORT_FORMAT_REGISTRY_ID = extensionPoints.hosts.reportExportFormatRegistry.spotId\n\nconst registry = createStrategyRegistry<ReportExportFormatDefinition>(REPORT_EXPORT_FORMAT_REGISTRY_ID)\n\nexport function registerReportExportFormat(format: ReportExportFormatDefinition): () => void {\n  return registry.register(format)\n}\n\n/**\n * The three formats the module ships. They register at the built-in priority so\n * `listReportExportFormats()` orders any contribution ahead of them.\n */\nexport function registerBuiltInReportExportFormat(\n  format: Omit<ReportExportFormatDefinition, 'priority'>,\n): () => void {\n  registry.registerBuiltIn({ ...format, priority: BUILT_IN_STRATEGY_PRIORITY })\n  return () => {}\n}\n\nexport function listReportExportFormats(): ReportExportFormatDefinition[] {\n  return registry.list()\n}\n\n/** Built-ins first, in the order the module shipped them, then contributions. */\nexport function reportExportFormatIds(): string[] {\n  const builtIn = BUILT_IN_REPORT_EXPORT_FORMAT_IDS.filter((id) => registry.has(id))\n  const contributed = registry.ids().filter((id) => !builtIn.includes(id as BuiltInReportExportFormat))\n  return [...builtIn, ...contributed]\n}\n\nexport function getReportExportFormat(\n  id: string | null | undefined,\n): ReportExportFormatDefinition | null {\n  return registry.get(id)\n}\n"],
+  "mappings": "AAaA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB,kCAAkC;AAG5D,MAAM,oCAAoC,CAAC,OAAO,OAAO,MAAM;AAmB/D,MAAM,mCAAmC,gBAAgB,MAAM,2BAA2B;AAEjG,MAAM,WAAW,uBAAqD,gCAAgC;AAE/F,SAAS,2BAA2B,QAAkD;AAC3F,SAAO,SAAS,SAAS,MAAM;AACjC;AAMO,SAAS,kCACd,QACY;AACZ,WAAS,gBAAgB,EAAE,GAAG,QAAQ,UAAU,2BAA2B,CAAC;AAC5E,SAAO,MAAM;AAAA,EAAC;AAChB;AAEO,SAAS,0BAA0D;AACxE,SAAO,SAAS,KAAK;AACvB;AAGO,SAAS,wBAAkC;AAChD,QAAM,UAAU,kCAAkC,OAAO,CAAC,OAAO,SAAS,IAAI,EAAE,CAAC;AACjF,QAAM,cAAc,SAAS,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,SAAS,EAA+B,CAAC;AACpG,SAAO,CAAC,GAAG,SAAS,GAAG,WAAW;AACpC;AAEO,SAAS,sBACd,IACqC;AACrC,SAAO,SAAS,IAAI,EAAE;AACxB;",
+  "names": []
+}