@freighttech/ui 0.13.18

package/dist/backend/dynamic-table/utils/importMapping.js

@@ -0,0 +1,118 @@
+function normalizeHeader(header) {
+  return header.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/ł/gi, "l").toLowerCase().replace(/[^a-z0-9]+/g, "");
+}
+function fieldKeys(field) {
+  const raw = [field.field, field.label, ...field.labels ?? []];
+  const keys = /* @__PURE__ */ new Set();
+  for (const value of raw) {
+    const key = normalizeHeader(value);
+    if (key) keys.add(key);
+  }
+  return [...keys];
+}
+function buildDefaultMapping(headers, fields) {
+  const index = /* @__PURE__ */ new Map();
+  for (const field of fields) {
+    for (const key of fieldKeys(field)) {
+      if (!index.has(key)) index.set(key, field.field);
+    }
+  }
+  const mapping = {};
+  const claimed = /* @__PURE__ */ new Set();
+  for (const header of headers) {
+    const target = index.get(normalizeHeader(header));
+    if (!target || claimed.has(target)) continue;
+    mapping[header] = target;
+    claimed.add(target);
+  }
+  return mapping;
+}
+function validateMapping(mapping, headers, fields, options = {}) {
+  const byField = new Map(fields.map((f) => [f.field, f]));
+  const headerSet = new Set(headers);
+  const issues = [];
+  const usedFields = /* @__PURE__ */ new Map();
+  for (const [header, target] of Object.entries(mapping)) {
+    if (!headerSet.has(header)) continue;
+    const field = byField.get(target);
+    if (!field) {
+      issues.push({ code: "unknown_field", header, field: target, label: header });
+      continue;
+    }
+    if (field.relation) {
+      issues.push({
+        code: "relation_unsupported",
+        header,
+        field: field.field,
+        label: header
+      });
+      continue;
+    }
+    usedFields.set(target, (usedFields.get(target) ?? 0) + 1);
+  }
+  for (const [target, count] of usedFields) {
+    if (count > 1) {
+      const field = byField.get(target);
+      issues.push({
+        code: "duplicate_field",
+        field: target,
+        label: field?.label ?? target
+      });
+    }
+  }
+  if (options.requireRequired !== false) {
+    for (const field of fields) {
+      if (!field.required || field.relation) continue;
+      if (!usedFields.has(field.field)) {
+        issues.push({ code: "missing_required", field: field.field, label: field.label });
+      }
+    }
+  }
+  return issues;
+}
+function pruneMapping(mapping, issues) {
+  const badHeaders = new Set(
+    issues.filter((i) => i.header && i.code !== "missing_required").map((i) => i.header)
+  );
+  const pruned = {};
+  for (const [header, target] of Object.entries(mapping)) {
+    if (badHeaders.has(header)) continue;
+    pruned[header] = target;
+  }
+  return pruned;
+}
+function applyMapping(values, mapping) {
+  const out = {};
+  for (const [header, target] of Object.entries(mapping)) {
+    if (!(header in values)) continue;
+    const raw = values[header];
+    out[target] = raw === "" ? null : raw;
+  }
+  return out;
+}
+function fieldsFromColumns(columns, options = {}) {
+  const idColumn = options.idColumn ?? "id";
+  const fields = [];
+  for (const col of columns) {
+    const label = col.title ?? col.data;
+    const type = col.type === "numeric" ? "numeric" : col.type === "date" ? "date" : col.type === "boolean" ? "boolean" : "text";
+    fields.push({
+      field: col.data,
+      label,
+      labels: label === col.data ? void 0 : [col.data],
+      type,
+      relation: Boolean(col.exportValue),
+      matchKey: col.data === idColumn
+    });
+  }
+  return fields;
+}
+export {
+  applyMapping,
+  buildDefaultMapping,
+  fieldsFromColumns,
+  normalizeHeader,
+  pruneMapping,
+  validateMapping
+};
+//# sourceMappingURL=importMapping.js.map

package/dist/backend/dynamic-table/utils/importMapping.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/importMapping.ts"],
+  "sourcesContent": ["/**\n * Headers \u2192 fields. Pure, dependency-free, shared by the server (which builds\n * the default mapping) and the panel (which lets a user override it).\n *\n * The default mapping is what makes **export \u2192 edit \u2192 re-import** work with\n * zero configuration: `utils/exportTable.ts` writes `col.title ?? col.data` as\n * the header, so a field whose `labels` include that title round-trips without\n * the user touching the mapping UI.\n */\nimport type {\n  ImportFieldDef,\n  ImportMapping,\n  ImportMappingIssue,\n} from '../types/import';\nimport type { ColumnDef } from '../types/index';\n\n/**\n * Fold a header down to a comparison key: lowercase, diacritics stripped,\n * punctuation and whitespace collapsed. \"Numer faktury\", \"numer_faktury\" and\n * \"Numer Faktury \" all land on `numerfaktury`, which is the tolerance a user\n * pasting a colleague's spreadsheet actually needs.\n */\nexport function normalizeHeader(header: string): string {\n  return header\n    .normalize('NFD')\n    // Combining marks \u2014 \u0142 has no decomposition, so it is handled below.\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/\u0142/gi, 'l')\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '');\n}\n\n/** Every accepted spelling of a field, normalized. */\nfunction fieldKeys(field: ImportFieldDef): string[] {\n  const raw = [field.field, field.label, ...(field.labels ?? [])];\n  const keys = new Set<string>();\n  for (const value of raw) {\n    const key = normalizeHeader(value);\n    if (key) keys.add(key);\n  }\n  return [...keys];\n}\n\n/**\n * Auto-map file headers onto target fields by normalized label.\n *\n * First match wins per field: a file with both \"Net amount\" and \"netAmount\"\n * maps the first and leaves the second unmapped rather than silently letting\n * the later column overwrite the earlier one.\n */\nexport function buildDefaultMapping(\n  headers: string[],\n  fields: ImportFieldDef[],\n): ImportMapping {\n  const index = new Map<string, string>();\n  for (const field of fields) {\n    for (const key of fieldKeys(field)) {\n      if (!index.has(key)) index.set(key, field.field);\n    }\n  }\n\n  const mapping: ImportMapping = {};\n  const claimed = new Set<string>();\n  for (const header of headers) {\n    const target = index.get(normalizeHeader(header));\n    if (!target || claimed.has(target)) continue;\n    mapping[header] = target;\n    claimed.add(target);\n  }\n  return mapping;\n}\n\n/**\n * Check a mapping against the file's headers and the module's fields.\n *\n * Relation fields are reported as `relation_unsupported` rather than resolved:\n * the generic path cannot know whether \"Maersk\" is contractor `a1b2\u2026` and a\n * wrong guess writes the wrong record (spec A1).\n */\nexport function validateMapping(\n  mapping: ImportMapping,\n  headers: string[],\n  fields: ImportFieldDef[],\n  options: { requireRequired?: boolean } = {},\n): ImportMappingIssue[] {\n  const byField = new Map(fields.map((f) => [f.field, f]));\n  const headerSet = new Set(headers);\n  const issues: ImportMappingIssue[] = [];\n  const usedFields = new Map<string, number>();\n\n  for (const [header, target] of Object.entries(mapping)) {\n    if (!headerSet.has(header)) continue;\n    const field = byField.get(target);\n    if (!field) {\n      issues.push({ code: 'unknown_field', header, field: target, label: header });\n      continue;\n    }\n    if (field.relation) {\n      issues.push({\n        code: 'relation_unsupported',\n        header,\n        field: field.field,\n        label: header,\n      });\n      continue;\n    }\n    usedFields.set(target, (usedFields.get(target) ?? 0) + 1);\n  }\n\n  for (const [target, count] of usedFields) {\n    if (count > 1) {\n      const field = byField.get(target);\n      issues.push({\n        code: 'duplicate_field',\n        field: target,\n        label: field?.label ?? target,\n      });\n    }\n  }\n\n  if (options.requireRequired !== false) {\n    for (const field of fields) {\n      if (!field.required || field.relation) continue;\n      if (!usedFields.has(field.field)) {\n        issues.push({ code: 'missing_required', field: field.field, label: field.label });\n      }\n    }\n  }\n\n  return issues;\n}\n\n/**\n * Drop mappings that `validateMapping` rejected, so a preview can still run on\n * the columns that ARE sound. A relation column being refused must not take the\n * other forty columns down with it.\n */\nexport function pruneMapping(\n  mapping: ImportMapping,\n  issues: ImportMappingIssue[],\n): ImportMapping {\n  const badHeaders = new Set(\n    issues.filter((i) => i.header && i.code !== 'missing_required').map((i) => i.header as string),\n  );\n  const pruned: ImportMapping = {};\n  for (const [header, target] of Object.entries(mapping)) {\n    if (badHeaders.has(header)) continue;\n    pruned[header] = target;\n  }\n  return pruned;\n}\n\n/**\n * Apply a mapping to one parsed row. Unmapped headers are dropped; an empty\n * cell yields `null` so \"the user cleared this\" is distinguishable from \"the\n * column was not in the file at all\" (absent key).\n */\nexport function applyMapping(\n  values: Record<string, string>,\n  mapping: ImportMapping,\n): Record<string, string | null> {\n  const out: Record<string, string | null> = {};\n  for (const [header, target] of Object.entries(mapping)) {\n    if (!(header in values)) continue;\n    const raw = values[header];\n    out[target] = raw === '' ? null : raw;\n  }\n  return out;\n}\n\n/**\n * Derive importable field defs from a table's own `ColumnDef`s.\n *\n * This is the generic path's default: whatever the grid shows and exports is\n * what it can read back. Columns that carry an `exportValue` hook are treated\n * as relation-shaped \u2014 a column whose stored cell value needs a projection to\n * become text cannot be reversed by parsing that text back (spec A1).\n */\nexport function fieldsFromColumns(\n  columns: ColumnDef[],\n  options: { idColumn?: string } = {},\n): ImportFieldDef[] {\n  const idColumn = options.idColumn ?? 'id';\n  const fields: ImportFieldDef[] = [];\n  for (const col of columns) {\n    const label = col.title ?? col.data;\n    const type: ImportFieldDef['type'] =\n      col.type === 'numeric' ? 'numeric'\n      : col.type === 'date' ? 'date'\n      : col.type === 'boolean' ? 'boolean'\n      : 'text';\n    fields.push({\n      field: col.data,\n      label,\n      labels: label === col.data ? undefined : [col.data],\n      type,\n      relation: Boolean(col.exportValue),\n      matchKey: col.data === idColumn,\n    });\n  }\n  return fields;\n}\n"],
+  "mappings": "AAsBO,SAAS,gBAAgB,QAAwB;AACtD,SAAO,OACJ,UAAU,KAAK,EAEf,QAAQ,oBAAoB,EAAE,EAC9B,QAAQ,OAAO,GAAG,EAClB,YAAY,EACZ,QAAQ,eAAe,EAAE;AAC9B;AAGA,SAAS,UAAU,OAAiC;AAClD,QAAM,MAAM,CAAC,MAAM,OAAO,MAAM,OAAO,GAAI,MAAM,UAAU,CAAC,CAAE;AAC9D,QAAM,OAAO,oBAAI,IAAY;AAC7B,aAAW,SAAS,KAAK;AACvB,UAAM,MAAM,gBAAgB,KAAK;AACjC,QAAI,IAAK,MAAK,IAAI,GAAG;AAAA,EACvB;AACA,SAAO,CAAC,GAAG,IAAI;AACjB;AASO,SAAS,oBACd,SACA,QACe;AACf,QAAM,QAAQ,oBAAI,IAAoB;AACtC,aAAW,SAAS,QAAQ;AAC1B,eAAW,OAAO,UAAU,KAAK,GAAG;AAClC,UAAI,CAAC,MAAM,IAAI,GAAG,EAAG,OAAM,IAAI,KAAK,MAAM,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,QAAM,UAAyB,CAAC;AAChC,QAAM,UAAU,oBAAI,IAAY;AAChC,aAAW,UAAU,SAAS;AAC5B,UAAM,SAAS,MAAM,IAAI,gBAAgB,MAAM,CAAC;AAChD,QAAI,CAAC,UAAU,QAAQ,IAAI,MAAM,EAAG;AACpC,YAAQ,MAAM,IAAI;AAClB,YAAQ,IAAI,MAAM;AAAA,EACpB;AACA,SAAO;AACT;AASO,SAAS,gBACd,SACA,SACA,QACA,UAAyC,CAAC,GACpB;AACtB,QAAM,UAAU,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACvD,QAAM,YAAY,IAAI,IAAI,OAAO;AACjC,QAAM,SAA+B,CAAC;AACtC,QAAM,aAAa,oBAAI,IAAoB;AAE3C,aAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACtD,QAAI,CAAC,UAAU,IAAI,MAAM,EAAG;AAC5B,UAAM,QAAQ,QAAQ,IAAI,MAAM;AAChC,QAAI,CAAC,OAAO;AACV,aAAO,KAAK,EAAE,MAAM,iBAAiB,QAAQ,OAAO,QAAQ,OAAO,OAAO,CAAC;AAC3E;AAAA,IACF;AACA,QAAI,MAAM,UAAU;AAClB,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN;AAAA,QACA,OAAO,MAAM;AAAA,QACb,OAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AACA,eAAW,IAAI,SAAS,WAAW,IAAI,MAAM,KAAK,KAAK,CAAC;AAAA,EAC1D;AAEA,aAAW,CAAC,QAAQ,KAAK,KAAK,YAAY;AACxC,QAAI,QAAQ,GAAG;AACb,YAAM,QAAQ,QAAQ,IAAI,MAAM;AAChC,aAAO,KAAK;AAAA,QACV,MAAM;AAAA,QACN,OAAO;AAAA,QACP,OAAO,OAAO,SAAS;AAAA,MACzB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,MAAI,QAAQ,oBAAoB,OAAO;AACrC,eAAW,SAAS,QAAQ;AAC1B,UAAI,CAAC,MAAM,YAAY,MAAM,SAAU;AACvC,UAAI,CAAC,WAAW,IAAI,MAAM,KAAK,GAAG;AAChC,eAAO,KAAK,EAAE,MAAM,oBAAoB,OAAO,MAAM,OAAO,OAAO,MAAM,MAAM,CAAC;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAOO,SAAS,aACd,SACA,QACe;AACf,QAAM,aAAa,IAAI;AAAA,IACrB,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE,IAAI,CAAC,MAAM,EAAE,MAAgB;AAAA,EAC/F;AACA,QAAM,SAAwB,CAAC;AAC/B,aAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACtD,QAAI,WAAW,IAAI,MAAM,EAAG;AAC5B,WAAO,MAAM,IAAI;AAAA,EACnB;AACA,SAAO;AACT;AAOO,SAAS,aACd,QACA,SAC+B;AAC/B,QAAM,MAAqC,CAAC;AAC5C,aAAW,CAAC,QAAQ,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACtD,QAAI,EAAE,UAAU,QAAS;AACzB,UAAM,MAAM,OAAO,MAAM;AACzB,QAAI,MAAM,IAAI,QAAQ,KAAK,OAAO;AAAA,EACpC;AACA,SAAO;AACT;AAUO,SAAS,kBACd,SACA,UAAiC,CAAC,GAChB;AAClB,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,SAA2B,CAAC;AAClC,aAAW,OAAO,SAAS;AACzB,UAAM,QAAQ,IAAI,SAAS,IAAI;AAC/B,UAAM,OACJ,IAAI,SAAS,YAAY,YACvB,IAAI,SAAS,SAAS,SACtB,IAAI,SAAS,YAAY,YACzB;AACJ,WAAO,KAAK;AAAA,MACV,OAAO,IAAI;AAAA,MACX;AAAA,MACA,QAAQ,UAAU,IAAI,OAAO,SAAY,CAAC,IAAI,IAAI;AAAA,MAClD;AAAA,MACA,UAAU,QAAQ,IAAI,WAAW;AAAA,MACjC,UAAU,IAAI,SAAS;AAAA,IACzB,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/importParse.js

@@ -0,0 +1,121 @@
+import * as XLSX from "xlsx";
+import { IMPORT_MAX_FILE_BYTES, IMPORT_MAX_ROWS } from "../types/import.js";
+class ImportParseError extends Error {
+  constructor(code, message, details = {}) {
+    super(message);
+    this.name = "ImportParseError";
+    this.code = code;
+    this.details = details;
+  }
+}
+function byteLength(input) {
+  if (typeof input === "string") {
+    return input.length * 2;
+  }
+  if (input instanceof Uint8Array) return input.byteLength;
+  return input.byteLength;
+}
+function cellToString(value) {
+  if (value === null || value === void 0) return "";
+  if (value instanceof Date) {
+    const iso = value.toISOString();
+    return Number.isNaN(value.getTime()) ? "" : iso.slice(0, 10);
+  }
+  if (typeof value === "boolean") return value ? "true" : "false";
+  return String(value).trim();
+}
+function normalizeHeaders(raw) {
+  const trimmed = raw.map((h) => cellToString(h));
+  let end = trimmed.length;
+  while (end > 0 && trimmed[end - 1] === "") end -= 1;
+  const seen = /* @__PURE__ */ new Map();
+  const headers = [];
+  for (let i = 0; i < end; i++) {
+    const base = trimmed[i] || `Column ${i + 1}`;
+    const count = (seen.get(base) ?? 0) + 1;
+    seen.set(base, count);
+    headers.push(count === 1 ? base : `${base} (${count})`);
+  }
+  return headers;
+}
+function parseImportFile(input, options = {}) {
+  const maxRows = options.maxRows ?? IMPORT_MAX_ROWS;
+  const maxBytes = options.maxBytes ?? IMPORT_MAX_FILE_BYTES;
+  const sheetIndex = options.sheetIndex ?? 0;
+  const size = byteLength(input);
+  if (size > maxBytes) {
+    throw new ImportParseError("file_too_large", "File exceeds the size limit", {
+      bytes: size,
+      limit: maxBytes
+    });
+  }
+  if (size === 0) {
+    throw new ImportParseError("empty_file", "File is empty");
+  }
+  let workbook;
+  try {
+    if (typeof input === "string") {
+      const text = input.charCodeAt(0) === 65279 ? input.slice(1) : input;
+      workbook = XLSX.read(text, { type: "string", raw: true });
+    } else {
+      const bytes = input instanceof Uint8Array ? input : new Uint8Array(input);
+      workbook = XLSX.read(bytes, { type: "array", cellDates: true });
+    }
+  } catch (err) {
+    throw new ImportParseError("unreadable", "File could not be read as CSV or Excel", {
+      cause: err instanceof Error ? err.message : String(err)
+    });
+  }
+  const sheetName = workbook.SheetNames[sheetIndex];
+  const sheet = sheetName ? workbook.Sheets[sheetName] : void 0;
+  if (!sheet) {
+    throw new ImportParseError("empty_file", "Workbook contains no readable sheet");
+  }
+  const matrix = XLSX.utils.sheet_to_json(sheet, {
+    header: 1,
+    blankrows: false,
+    defval: "",
+    // Raw values, NOT the display text: a date cell must reach us as a `Date`
+    // (so it becomes `2026-08-03`) rather than as whatever `8/3/26` format the
+    // author happened to apply.
+    raw: true
+  });
+  if (!matrix.length) {
+    throw new ImportParseError("empty_file", "Sheet contains no rows");
+  }
+  const headers = normalizeHeaders(matrix[0] ?? []);
+  if (!headers.length) {
+    throw new ImportParseError("no_headers", "First row carries no column headers");
+  }
+  const body = matrix.slice(1);
+  const rows = [];
+  for (const line of body) {
+    const values = {};
+    let hasData = false;
+    for (let c = 0; c < headers.length; c++) {
+      const cell = cellToString(line[c]);
+      values[headers[c]] = cell;
+      if (cell !== "") hasData = true;
+    }
+    if (!hasData) continue;
+    rows.push({ sourceRowNumber: rows.length + 1, values });
+    if (rows.length > maxRows) {
+      throw new ImportParseError("too_many_rows", "File exceeds the row limit", {
+        // Report what the file actually holds so "split it in parts" is actionable.
+        count: body.filter(
+          (l) => l.some((v) => cellToString(v) !== "")
+        ).length,
+        limit: maxRows
+      });
+    }
+  }
+  if (!rows.length) {
+    throw new ImportParseError("empty_file", "File has headers but no data rows");
+  }
+  return { headers, rows, sheetName };
+}
+export {
+  ImportParseError,
+  parseImportFile
+};
+//# sourceMappingURL=importParse.js.map

package/dist/backend/dynamic-table/utils/importParse.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/importParse.ts"],
+  "sourcesContent": ["/**\n * File \u2192 rows. **SERVER-SIDE ONLY.**\n *\n * The browser uploads bytes; this runs in the route handler. Parsing in both\n * places is how a preview and its commit drift apart, so there is deliberately\n * no client entry point \u2014 `components/ImportPanel.tsx` does not import this\n * file, and a test asserts that it never starts to.\n *\n * `xlsx` (vendored as `@freighttech/xlsx@0.20.3`) reads BOTH formats: `XLSX.read`\n * sniffs a CSV buffer just as happily as a ZIP workbook, and `sheet_to_json`\n * flattens either into rows. No second CSV parser is needed.\n *\n * Precedent: `packages/facilities/.../services/excel-parse.service.ts`.\n */\nimport * as XLSX from 'xlsx';\nimport { IMPORT_MAX_FILE_BYTES, IMPORT_MAX_ROWS } from '../types/import';\n\nexport type ImportParseErrorCode =\n  | 'file_too_large'\n  | 'too_many_rows'\n  | 'empty_file'\n  | 'no_headers'\n  | 'unreadable';\n\n/**\n * A parse failure the user can act on. Route handlers map `code` onto a\n * message; nothing here is localized, because `packages/ui` server code has no\n * request locale.\n */\nexport class ImportParseError extends Error {\n  readonly code: ImportParseErrorCode;\n  /** Interpolation values for the caller's i18n string (e.g. `{ count, limit }`). */\n  readonly details: Record<string, unknown>;\n\n  constructor(code: ImportParseErrorCode, message: string, details: Record<string, unknown> = {}) {\n    super(message);\n    this.name = 'ImportParseError';\n    this.code = code;\n    this.details = details;\n  }\n}\n\nexport interface ParsedImportFile {\n  /** Header labels in file order, blanks dropped, duplicates suffixed. */\n  headers: string[];\n  /** Data rows keyed by header. `sourceRowNumber` is the 1-based data row. */\n  rows: Array<{ sourceRowNumber: number; values: Record<string, string> }>;\n  sheetName: string;\n}\n\nexport interface ParseImportFileOptions {\n  /** Max data rows accepted. Defaults to `IMPORT_MAX_ROWS` (1,000). */\n  maxRows?: number;\n  /** Max byte length accepted. Defaults to `IMPORT_MAX_FILE_BYTES` (10 MB). */\n  maxBytes?: number;\n  /** Sheet to read. Defaults to the first. */\n  sheetIndex?: number;\n}\n\ntype ParseInput = ArrayBuffer | Uint8Array | string;\n\nfunction byteLength(input: ParseInput): number {\n  if (typeof input === 'string') {\n    // A rough upper bound is fine \u2014 the cap exists to stop pathological files,\n    // not to be byte-exact on a string that was already fully materialized.\n    return input.length * 2;\n  }\n  if (input instanceof Uint8Array) return input.byteLength;\n  return input.byteLength;\n}\n\n/**\n * Turn a SheetJS cell value into the string the mapper works with.\n *\n * Everything downstream is string-shaped because that is what a spreadsheet\n * cell *is* to the user, and because the module's own zod validators already\n * own coercion. Dates are the one exception worth normalizing here: SheetJS\n * hands back a `Date` for a real date cell, and `String(date)` would produce a\n * locale-dependent blob that no validator accepts.\n */\nfunction cellToString(value: unknown): string {\n  if (value === null || value === undefined) return '';\n  if (value instanceof Date) {\n    // ISO date (no time) \u2014 the shape every date validator in the codebase takes.\n    const iso = value.toISOString();\n    return Number.isNaN(value.getTime()) ? '' : iso.slice(0, 10);\n  }\n  if (typeof value === 'boolean') return value ? 'true' : 'false';\n  return String(value).trim();\n}\n\n/**\n * Normalize the header row: trim, drop trailing blanks, and suffix duplicates\n * so `{ header: field }` mapping stays a total function. Two columns both\n * called \"Amount\" become \"Amount\" and \"Amount (2)\".\n */\nfunction normalizeHeaders(raw: unknown[]): string[] {\n  const trimmed = raw.map((h) => cellToString(h));\n  // Drop trailing empties \u2014 spreadsheets routinely carry phantom columns.\n  let end = trimmed.length;\n  while (end > 0 && trimmed[end - 1] === '') end -= 1;\n\n  const seen = new Map<string, number>();\n  const headers: string[] = [];\n  for (let i = 0; i < end; i++) {\n    const base = trimmed[i] || `Column ${i + 1}`;\n    const count = (seen.get(base) ?? 0) + 1;\n    seen.set(base, count);\n    headers.push(count === 1 ? base : `${base} (${count})`);\n  }\n  return headers;\n}\n\n/**\n * Parse an uploaded `.xlsx` or `.csv` into headers + string-valued rows.\n *\n * Caps are checked BEFORE and immediately AFTER the read: the byte cap stops a\n * 50 MB workbook from expanding into 400 MB of heap, and the row cap is\n * enforced on the parsed sheet because a small file can still declare a huge\n * range.\n *\n * @throws {ImportParseError}\n */\nexport function parseImportFile(\n  input: ParseInput,\n  options: ParseImportFileOptions = {},\n): ParsedImportFile {\n  const maxRows = options.maxRows ?? IMPORT_MAX_ROWS;\n  const maxBytes = options.maxBytes ?? IMPORT_MAX_FILE_BYTES;\n  const sheetIndex = options.sheetIndex ?? 0;\n\n  const size = byteLength(input);\n  if (size > maxBytes) {\n    throw new ImportParseError('file_too_large', 'File exceeds the size limit', {\n      bytes: size,\n      limit: maxBytes,\n    });\n  }\n  if (size === 0) {\n    throw new ImportParseError('empty_file', 'File is empty');\n  }\n\n  let workbook: XLSX.WorkBook;\n  try {\n    if (typeof input === 'string') {\n      // Strip a UTF-8 BOM \u2014 our own CSV export writes one so Excel picks the\n      // encoding up, and SheetJS would otherwise fold it into header one.\n      const text = input.charCodeAt(0) === 0xfeff ? input.slice(1) : input;\n      // `raw: true` on a CSV read stops SheetJS type-sniffing every cell:\n      // without it an invoice number like `FV/1/2026` is helpfully turned into\n      // a date. Everything arrives as a string, which is what a CSV cell is.\n      workbook = XLSX.read(text, { type: 'string', raw: true });\n    } else {\n      const bytes = input instanceof Uint8Array ? input : new Uint8Array(input);\n      // A real XLSX carries typed cells, so `cellDates` gives us `Date`\n      // objects rather than serial numbers; `cellToString` renders them ISO.\n      workbook = XLSX.read(bytes, { type: 'array', cellDates: true });\n    }\n  } catch (err) {\n    throw new ImportParseError('unreadable', 'File could not be read as CSV or Excel', {\n      cause: err instanceof Error ? err.message : String(err),\n    });\n  }\n\n  const sheetName = workbook.SheetNames[sheetIndex];\n  const sheet = sheetName ? workbook.Sheets[sheetName] : undefined;\n  if (!sheet) {\n    throw new ImportParseError('empty_file', 'Workbook contains no readable sheet');\n  }\n\n  const matrix = XLSX.utils.sheet_to_json<unknown[]>(sheet, {\n    header: 1,\n    blankrows: false,\n    defval: '',\n    // Raw values, NOT the display text: a date cell must reach us as a `Date`\n    // (so it becomes `2026-08-03`) rather than as whatever `8/3/26` format the\n    // author happened to apply.\n    raw: true,\n  });\n\n  if (!matrix.length) {\n    throw new ImportParseError('empty_file', 'Sheet contains no rows');\n  }\n\n  const headers = normalizeHeaders(matrix[0] ?? []);\n  if (!headers.length) {\n    throw new ImportParseError('no_headers', 'First row carries no column headers');\n  }\n\n  const body = matrix.slice(1);\n  const rows: ParsedImportFile['rows'] = [];\n  for (const line of body) {\n    const values: Record<string, string> = {};\n    let hasData = false;\n    for (let c = 0; c < headers.length; c++) {\n      const cell = cellToString((line as unknown[])[c]);\n      values[headers[c]] = cell;\n      if (cell !== '') hasData = true;\n    }\n    // A wholly blank line is spreadsheet padding, not a record.\n    if (!hasData) continue;\n    rows.push({ sourceRowNumber: rows.length + 1, values });\n\n    if (rows.length > maxRows) {\n      throw new ImportParseError('too_many_rows', 'File exceeds the row limit', {\n        // Report what the file actually holds so \"split it in parts\" is actionable.\n        count: body.filter((l) =>\n          (l as unknown[]).some((v) => cellToString(v) !== ''),\n        ).length,\n        limit: maxRows,\n      });\n    }\n  }\n\n  if (!rows.length) {\n    throw new ImportParseError('empty_file', 'File has headers but no data rows');\n  }\n\n  return { headers, rows, sheetName: sheetName as string };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/lookupColumns.js

@@ -0,0 +1,28 @@
+import { jsx } from "react/jsx-runtime";
+function lookupColumnDataKey(ref) {
+  return `lookup__${ref.source}__${ref.field}`;
+}
+function isLookupColumnKey(key) {
+  return key.startsWith("lookup__");
+}
+function buildLookupColumnDefs(refs) {
+  return refs.map((r) => ({
+    data: lookupColumnDataKey(r),
+    title: r.label,
+    readOnly: true,
+    renderer: (value) => {
+      const isEmpty = value == null || value === "";
+      return /* @__PURE__ */ jsx("span", { className: isEmpty ? "text-m3-on-surface-variant" : void 0, children: isEmpty ? "\u2014" : String(value) });
+    }
+  }));
+}
+function lookupColumnsToParam(refs) {
+  return refs.map((r) => `${r.source}:${r.field}`).join(",");
+}
+export {
+  buildLookupColumnDefs,
+  isLookupColumnKey,
+  lookupColumnDataKey,
+  lookupColumnsToParam
+};
+//# sourceMappingURL=lookupColumns.js.map

package/dist/backend/dynamic-table/utils/lookupColumns.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/lookupColumns.tsx"],
+  "sourcesContent": ["import * as React from 'react'\nimport type { ColumnDef } from '../types/index'\nimport type { LookupColumnRef } from '../types/perspective'\n\n/**\n * Row field / column data key for a linked (lookup) column. The server enriches\n * each row with this key (see `@freighttech/table-lookups` resolver), and the\n * grid renders a read-only column for it. Keeping the `lookup__` prefix matches\n * the shipped convention; the `<source>__<field>` tail makes the key derivable on\n * both client and server with no stored column key.\n */\nexport function lookupColumnDataKey(ref: { source: string; field: string }): string {\n  return `lookup__${ref.source}__${ref.field}`\n}\n\n/** True when a column data key belongs to a linked (lookup) column. */\nexport function isLookupColumnKey(key: string): boolean {\n  return key.startsWith('lookup__')\n}\n\n/**\n * Build read-only DynamicTable column defs for a perspective's linked columns.\n * The cell value lives at `row[lookup__<source>__<field>]`, attached server-side.\n * Linked columns are never editable (editing would write back to the source,\n * breaking the unidirectional rule), so every column is `readOnly`.\n */\nexport function buildLookupColumnDefs(refs: LookupColumnRef[]): ColumnDef[] {\n  return refs.map((r) => ({\n    data: lookupColumnDataKey(r),\n    title: r.label,\n    readOnly: true,\n    renderer: (value: unknown) => {\n      const isEmpty = value == null || value === ''\n      return (\n        <span className={isEmpty ? 'text-m3-on-surface-variant' : undefined}>\n          {isEmpty ? '\u2014' : String(value)}\n        </span>\n      )\n    },\n  }))\n}\n\n/** Serialize a perspective's linked columns into the `lookups` query param value\n *  (`source:field,source:field`). Empty when there are no linked columns. */\nexport function lookupColumnsToParam(refs: LookupColumnRef[]): string {\n  return refs.map((r) => `${r.source}:${r.field}`).join(',')\n}\n"],
+  "mappings": "AAkCQ;AAvBD,SAAS,oBAAoB,KAAgD;AAClF,SAAO,WAAW,IAAI,MAAM,KAAK,IAAI,KAAK;AAC5C;AAGO,SAAS,kBAAkB,KAAsB;AACtD,SAAO,IAAI,WAAW,UAAU;AAClC;AAQO,SAAS,sBAAsB,MAAsC;AAC1E,SAAO,KAAK,IAAI,CAAC,OAAO;AAAA,IACtB,MAAM,oBAAoB,CAAC;AAAA,IAC3B,OAAO,EAAE;AAAA,IACT,UAAU;AAAA,IACV,UAAU,CAAC,UAAmB;AAC5B,YAAM,UAAU,SAAS,QAAQ,UAAU;AAC3C,aACE,oBAAC,UAAK,WAAW,UAAU,+BAA+B,QACvD,oBAAU,WAAM,OAAO,KAAK,GAC/B;AAAA,IAEJ;AAAA,EACF,EAAE;AACJ;AAIO,SAAS,qBAAqB,MAAiC;AACpE,SAAO,KAAK,IAAI,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG;AAC3D;",
+  "names": []
+}

package/dist/backend/dynamic-table/utils/perspectiveTransforms.js

@@ -0,0 +1,191 @@
+import { BASE_VIEW_PERSPECTIVE_NAME, isTableViewMode } from "../types/perspective.js";
+import { isAggregationFn } from "../types/grouping.js";
+import { parseConditionalFormats } from "./conditionalFormat.js";
+import { parseFormulaColumns } from "./formulaColumns.js";
+import { parseRollupColumns } from "./rollupColumns.js";
+function parseLookupColumns(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object") continue;
+    const { source, field, label } = entry;
+    if (typeof source !== "string" || !source) continue;
+    if (typeof field !== "string" || !field) continue;
+    out.push({ source, field, label: typeof label === "string" && label ? label : field });
+  }
+  return out;
+}
+function parseAggregations(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const entry of raw) {
+    if (!entry || typeof entry !== "object") continue;
+    const { id, field, fn, dimension } = entry;
+    if (typeof field !== "string" || !field) continue;
+    if (!isAggregationFn(fn)) continue;
+    const rule = {
+      id: typeof id === "string" && id ? id : `agg-${field}`,
+      field,
+      fn
+    };
+    if (typeof dimension === "string" && dimension) rule.dimension = dimension;
+    out.push(rule);
+  }
+  return out;
+}
+function parseViewMode(raw) {
+  if (raw === void 0 || raw === null) return void 0;
+  return isTableViewMode(raw) ? raw : "table";
+}
+function parsePerspectiveOrigin(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const { templateId, version, name, copiedAt } = raw;
+  if (typeof templateId !== "string" || !templateId) return void 0;
+  if (typeof version !== "string" || !version) return void 0;
+  return {
+    templateId,
+    version,
+    name: typeof name === "string" ? name : "",
+    copiedAt: typeof copiedAt === "string" ? copiedAt : ""
+  };
+}
+function parsePerspectivePublication(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const { roleIds, publishedAt } = raw;
+  if (!Array.isArray(roleIds)) return void 0;
+  const ids = roleIds.filter((id) => typeof id === "string" && id.length > 0);
+  if (!ids.length) return void 0;
+  return { roleIds: ids, publishedAt: typeof publishedAt === "string" ? publishedAt : "" };
+}
+function templateVersionOf(dto) {
+  return dto.updatedAt || dto.createdAt;
+}
+function apiTemplateToDynamicTable(dto, allColumns, defaultHiddenColumns = []) {
+  const base = apiToDynamicTable(dto, allColumns, defaultHiddenColumns);
+  return {
+    ...base,
+    // A template is a thing to copy, never a thing that is your default or your
+    // base view — drop both flags rather than carrying them into someone's space.
+    isDefault: false,
+    isBaseView: false,
+    publication: void 0,
+    roleId: dto.roleId,
+    roleName: dto.roleName ?? null,
+    version: templateVersionOf(dto)
+  };
+}
+function apiToDynamicTable(dto, allColumns, defaultHiddenColumns = []) {
+  const { columnOrder = [], columnVisibility = {} } = dto.settings;
+  const visible = columnOrder.length > 0 ? columnOrder.filter((col) => columnVisibility[col] !== false) : allColumns.filter((col) => !defaultHiddenColumns.includes(col));
+  const hidden = allColumns.filter((col) => !visible.includes(col));
+  const unseenColumns = columnOrder.length > 0 ? allColumns.filter(
+    (col) => !columnOrder.includes(col) && !(col in columnVisibility)
+  ) : [];
+  const apiFilters = dto.settings.filters;
+  const filters = Array.isArray(apiFilters) ? apiFilters : apiFilters?.rows ?? [];
+  const color = apiFilters?._color;
+  const sorting = (dto.settings.sorting ?? []).map((s) => ({
+    id: s.id,
+    field: s.id,
+    direction: s.desc ? "desc" : "asc"
+  }));
+  const grouping = (dto.settings.grouping ?? []).map((g) => ({
+    id: g.id,
+    field: g.field,
+    direction: g.desc ? "desc" : "asc"
+  }));
+  const aggregations = parseAggregations(apiFilters?._aggregations);
+  const lookupColumns = parseLookupColumns(apiFilters?._lookups);
+  const rollupColumns = parseRollupColumns(apiFilters?._rollups);
+  const rawDateFormat = apiFilters?._dateFormat;
+  const dateFormat = typeof rawDateFormat === "string" && rawDateFormat ? rawDateFormat : void 0;
+  const conditionalFormats = parseConditionalFormats(apiFilters?._conditionalFormats);
+  const frozenColumns = Array.isArray(apiFilters?._frozenColumns) ? apiFilters._frozenColumns.filter(
+    (k) => typeof k === "string" && k.length > 0
+  ) : void 0;
+  const formulas = parseFormulaColumns(apiFilters?._formulas);
+  const viewMode = parseViewMode(apiFilters?._viewMode);
+  const origin = parsePerspectiveOrigin(apiFilters?._origin);
+  const publication = parsePerspectivePublication(apiFilters?._published);
+  const isBaseView = apiFilters?._baseView === true && dto.name === BASE_VIEW_PERSPECTIVE_NAME;
+  return {
+    id: dto.id,
+    name: dto.name,
+    color,
+    columns: { visible, hidden },
+    unseenColumns,
+    filters,
+    sorting,
+    grouping,
+    aggregations,
+    lookupColumns,
+    rollupColumns,
+    formulas,
+    dateFormat,
+    conditionalFormats,
+    frozenColumns,
+    viewMode,
+    isDefault: dto.isDefault,
+    isBaseView,
+    origin,
+    publication
+  };
+}
+function dynamicTableToApi(config) {
+  const columnVisibility = {};
+  config.columns.visible.forEach((col) => columnVisibility[col] = true);
+  config.columns.hidden.forEach((col) => columnVisibility[col] = false);
+  return {
+    columnOrder: config.columns.visible,
+    columnVisibility,
+    // `v: 2` marks the current filter shape. The upstream perspectives service
+    // (`maybeMigrateLegacyFilterValues`) DROPS any `filters` object that lacks
+    // either `v === 2` or a `root` key, treating it as a legacy value it can't
+    // migrate — so without this marker the saved filters silently vanish on load.
+    // `_aggregations` rides here too (passthrough record), since the settings
+    // schema would strip it as an unknown top-level key.
+    filters: {
+      v: 2,
+      rows: config.filters,
+      _color: config.color,
+      _aggregations: config.aggregations ?? [],
+      _lookups: config.lookupColumns ?? [],
+      _rollups: config.rollupColumns ?? [],
+      _dateFormat: config.dateFormat,
+      _conditionalFormats: config.conditionalFormats ?? [],
+      _formulas: config.formulas ?? [],
+      // Written only when the view actually pins something, so a view that has
+      // never used the feature does not grow an empty key — same rule as
+      // `_viewMode` below.
+      ...config.frozenColumns && config.frozenColumns.length > 0 ? { _frozenColumns: config.frozenColumns } : {},
+      // Written only when the view has a mode, so a table-only view does not
+      // grow a key. `parseViewMode` treats absent and 'table' identically.
+      ...config.viewMode ? { _viewMode: config.viewMode } : {},
+      // Personalization metadata — see `apiToDynamicTable` for why it cannot
+      // live at the top level. Written only when set, so a plain personal view
+      // does not grow three null keys.
+      ...config.origin ? { _origin: config.origin } : {},
+      ...config.publication ? { _published: config.publication } : {},
+      ...config.isBaseView ? { _baseView: true } : {}
+    },
+    sorting: config.sorting.map((s) => ({
+      id: s.field,
+      desc: s.direction === "desc"
+    })),
+    grouping: (config.grouping ?? []).map((g) => ({
+      id: g.id,
+      field: g.field,
+      desc: g.direction === "desc"
+    }))
+  };
+}
+export {
+  apiTemplateToDynamicTable,
+  apiToDynamicTable,
+  dynamicTableToApi,
+  parsePerspectiveOrigin,
+  parsePerspectivePublication,
+  parseViewMode,
+  templateVersionOf
+};
+//# sourceMappingURL=perspectiveTransforms.js.map

package/dist/backend/dynamic-table/utils/perspectiveTransforms.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/backend/dynamic-table/utils/perspectiveTransforms.ts"],
+  "sourcesContent": ["import type { PerspectiveConfig, FilterRow, SortRule, LookupColumnRef } from '../types/index'\nimport type {\n  PerspectiveOrigin,\n  PerspectivePublication,\n  PerspectiveTemplate,\n} from '../types/perspective'\nimport { BASE_VIEW_PERSPECTIVE_NAME, isTableViewMode } from '../types/perspective'\nimport type { TableViewMode } from '../types/perspective'\nimport type { GroupRule, AggregationRule, AggregationFn } from '../types/grouping'\nimport { isAggregationFn } from '../types/grouping'\nimport { parseConditionalFormats } from './conditionalFormat'\nimport { parseFormulaColumns } from './formulaColumns'\nimport { parseRollupColumns } from './rollupColumns'\nimport type {\n  PerspectiveDto,\n  PerspectiveSettings,\n  RolePerspectiveDto,\n} from '@open-mercato/shared/modules/perspectives/types'\n\n/**\n * @deprecated Collapsed: `PerspectiveConfig` now carries `conditionalFormats`\n * itself, so this is a plain alias. Use `PerspectiveConfig`.\n */\nexport type DynamicTablePerspectiveConfig = PerspectiveConfig\n\n/**\n * Defensively parse the `_lookups` smuggled inside `settings.filters`. Drops\n * anything that isn't a well-formed `{ source, field, label }` so a malformed or\n * legacy value can never crash the table.\n */\nfunction parseLookupColumns(raw: unknown): LookupColumnRef[] {\n  if (!Array.isArray(raw)) return []\n  const out: LookupColumnRef[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { source, field, label } = entry as Record<string, unknown>\n    if (typeof source !== 'string' || !source) continue\n    if (typeof field !== 'string' || !field) continue\n    out.push({ source, field, label: typeof label === 'string' && label ? label : field })\n  }\n  return out\n}\n\n/**\n * Defensively parse the `_aggregations` smuggled inside `settings.filters`.\n * Drops anything that isn't a well-formed rule so a malformed/legacy value\n * can never crash the table.\n *\n * The function whitelist is `isAggregationFn` \u2014 i.e. `AGGREGATION_FNS` in\n * `types/grouping.ts`, the single source of truth. It used to be a local\n * `['sum']` literal, which meant a view saved with any other function silently\n * lost its rules on reload. That is also the forward-compatibility contract:\n * a view saved by a NEWER client carrying an unknown `fn` degrades to dropping\n * that one rule instead of throwing.\n */\nfunction parseAggregations(raw: unknown): AggregationRule[] {\n  if (!Array.isArray(raw)) return []\n  const out: AggregationRule[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object') continue\n    const { id, field, fn, dimension } = entry as Record<string, unknown>\n    if (typeof field !== 'string' || !field) continue\n    if (!isAggregationFn(fn)) continue\n    const rule: AggregationRule = {\n      id: typeof id === 'string' && id ? id : `agg-${field}`,\n      field,\n      fn: fn as AggregationFn,\n    }\n    // Carry the partition column through the round-trip. Dropping it would\n    // turn a saved per-currency breakdown back into a single cross-currency\n    // number on the next page load \u2014 silently, and looking correct.\n    if (typeof dimension === 'string' && dimension) rule.dimension = dimension\n    out.push(rule)\n  }\n  return out\n}\n\n/**\n * Defensively parse the `_viewMode` smuggled inside `settings.filters`.\n *\n * Same forward-compatibility contract as `parseAggregations`: a value written\n * by a NEWER client that we do not recognise degrades to `'table'` rather than\n * throwing. A saved view is data a user relies on; it must never be able to\n * break the page that reads it.\n *\n * `undefined` in \u21D2 `undefined` out, so \"never chosen\" survives a round-trip and\n * a host's own default (if it has one) still applies.\n */\nexport function parseViewMode(raw: unknown): TableViewMode | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  return isTableViewMode(raw) ? raw : 'table';\n}\n\n/**\n * Defensively parse `_origin` \u2014 the record of which shared template a view was\n * copied from, and at which version. A malformed or partial value is dropped\n * rather than half-trusted: a wrong `version` would later claim \"the template\n * changed\" (or hide that it did), which is worse than not knowing.\n */\nexport function parsePerspectiveOrigin(raw: unknown): PerspectiveOrigin | undefined {\n  if (!raw || typeof raw !== 'object') return undefined\n  const { templateId, version, name, copiedAt } = raw as Record<string, unknown>\n  if (typeof templateId !== 'string' || !templateId) return undefined\n  if (typeof version !== 'string' || !version) return undefined\n  return {\n    templateId,\n    version,\n    name: typeof name === 'string' ? name : '',\n    copiedAt: typeof copiedAt === 'string' ? copiedAt : '',\n  }\n}\n\n/** Defensively parse `_published` \u2014 which roles this view is shared with. */\nexport function parsePerspectivePublication(raw: unknown): PerspectivePublication | undefined {\n  if (!raw || typeof raw !== 'object') return undefined\n  const { roleIds, publishedAt } = raw as Record<string, unknown>\n  if (!Array.isArray(roleIds)) return undefined\n  const ids = roleIds.filter((id): id is string => typeof id === 'string' && id.length > 0)\n  if (!ids.length) return undefined\n  return { roleIds: ids, publishedAt: typeof publishedAt === 'string' ? publishedAt : '' }\n}\n\n/**\n * The version stamp a copy records. `updatedAt` when the template has been\n * re-published, else `createdAt` \u2014 never empty, so \"has it changed since I\n * copied it?\" is always answerable.\n */\nexport function templateVersionOf(dto: { updatedAt?: string | null; createdAt: string }): string {\n  return dto.updatedAt || dto.createdAt\n}\n\n/**\n * Convert a ROLE-scoped perspective DTO into a shared template.\n *\n * Same settings shape as a personal view \u2014 a template IS a view someone\n * published \u2014 plus the role it is published to and the version stamp a copy\n * records. Deliberately reuses `apiToDynamicTable` so a template can never\n * decode differently from the view it was made from.\n */\nexport function apiTemplateToDynamicTable(\n  dto: RolePerspectiveDto,\n  allColumns: string[],\n  defaultHiddenColumns: string[] = [],\n): PerspectiveTemplate {\n  const base = apiToDynamicTable(dto, allColumns, defaultHiddenColumns)\n  return {\n    ...base,\n    // A template is a thing to copy, never a thing that is your default or your\n    // base view \u2014 drop both flags rather than carrying them into someone's space.\n    isDefault: false,\n    isBaseView: false,\n    publication: undefined,\n    roleId: dto.roleId,\n    roleName: dto.roleName ?? null,\n    version: templateVersionOf(dto),\n  }\n}\n\n/**\n * Convert a perspective DTO from the API into a DynamicTable PerspectiveConfig.\n * Handles the mapping between API format (columnOrder, columnVisibility, etc.)\n * and DynamicTable format (visible/hidden arrays, FilterRow[], SortRule[]).\n */\nexport function apiToDynamicTable(\n  dto: PerspectiveDto,\n  allColumns: string[],\n  defaultHiddenColumns: string[] = [],\n): DynamicTablePerspectiveConfig {\n  const { columnOrder = [], columnVisibility = {} } = dto.settings\n\n  // A perspective saved before column config was persisted (or migrated from a\n  // legacy shape) has an empty `columnOrder`. Falling back to `allColumns` there\n  // would reveal every column the table declares hidden by default \u2014 the\n  // \"phantom fields in my saved view\" report. Honour the table's defaults\n  // instead; an explicit `columnOrder` still wins outright.\n  const visible =\n    columnOrder.length > 0\n      ? columnOrder.filter((col) => columnVisibility[col] !== false)\n      : allColumns.filter((col) => !defaultHiddenColumns.includes(col))\n  const hidden = allColumns.filter((col) => !visible.includes(col))\n\n  /**\n   * Columns this saved view has NEVER EXPRESSED AN OPINION ABOUT.\n   *\n   * `hidden` above cannot answer that question \u2014 it is DERIVED, \"everything the\n   * table declares that is not visible\", so a column added to the table config\n   * after this row was written is indistinguishable from one the user hid on\n   * purpose. The only place the difference survives is the raw stored maps: a\n   * key absent from BOTH `columnOrder` and `columnVisibility` was never decided,\n   * because saving writes an entry for every column either way\n   * (`dynamicTableToApi` below).\n   *\n   * Computed here rather than in `resolvePerspectiveState` for exactly that\n   * reason: by the time the config reaches the resolver the raw maps are gone.\n   * An empty `columnOrder` (a legacy row) means the view has no column opinions\n   * at all, and its defaults are already being honoured above \u2014 so nothing is\n   * \"unseen\" there either.\n   */\n  const unseenColumns =\n    columnOrder.length > 0\n      ? allColumns.filter(\n          (col) => !columnOrder.includes(col) && !(col in columnVisibility),\n        )\n      : []\n\n  const apiFilters = dto.settings.filters as Record<string, unknown> | undefined\n  const filters: FilterRow[] = Array.isArray(apiFilters)\n    ? (apiFilters as FilterRow[])\n    : ((apiFilters?.rows as FilterRow[]) ?? [])\n  const color = apiFilters?._color as PerspectiveConfig['color']\n\n  const sorting: SortRule[] = (dto.settings.sorting ?? []).map((s) => ({\n    id: s.id,\n    field: s.id,\n    direction: (s.desc ? 'desc' : 'asc') as 'asc' | 'desc',\n  }))\n\n  const grouping: GroupRule[] = (dto.settings.grouping ?? []).map((g) => ({\n    id: g.id,\n    field: g.field,\n    direction: (g.desc ? 'desc' : 'asc') as 'asc' | 'desc',\n  }))\n\n  // Aggregations ride inside `filters._aggregations` \u2014 the upstream settings\n  // schema strips unknown top-level keys, but `filters` is a passthrough record\n  // (same channel as `_color`).\n  const aggregations = parseAggregations(apiFilters?._aggregations)\n\n  // Linked (lookup) columns ride the same `filters` passthrough channel as\n  // `_aggregations`/`_color`.\n  const lookupColumns = parseLookupColumns(apiFilters?._lookups)\n\n  // Rollup (\"summarised\") columns \u2014 the one-to-many direction \u2014 ride the same\n  // channel. A top-level `rollups` key would be stripped by the settings schema\n  // and the columns would vanish on the first reload.\n  const rollupColumns = parseRollupColumns(apiFilters?._rollups)\n\n  // View-scoped date/time format rides the same passthrough channel. Opaque to\n  // the table; only a well-formed string survives (anything else \u2192 undefined,\n  // so renderers keep their default).\n  const rawDateFormat = apiFilters?._dateFormat\n  const dateFormat = typeof rawDateFormat === 'string' && rawDateFormat ? rawDateFormat : undefined\n\n  // View-scoped conditional formatting (\"Highlighting\") rides the same\n  // passthrough channel. Same trap as `_aggregations`: a top-level key would be\n  // stripped by the settings schema and the rules would vanish on reload.\n  const conditionalFormats = parseConditionalFormats(apiFilters?._conditionalFormats)\n\n  // Frozen (pinned sticky-left) columns ride the same passthrough channel, and\n  // for the same reason \u2014 measured, not assumed: saving a TOP-LEVEL\n  // `frozenColumns` against the running API returns 200 OK and the key never\n  // reaches the database, because the upstream settings schema is a bare\n  // `z.object` whose vocabulary is columnOrder/columnVisibility/filters/\n  // sorting/grouping/pageSize/searchValue, and Zod strips the rest (HEDGE-102).\n  //\n  // Defensive by construction, like the parsers around it: a legacy or\n  // hand-edited view that stored a non-array, or an array with non-string\n  // entries, loses the malformed parts rather than pinning `undefined` and\n  // wedging the sticky-offset maths.\n  const frozenColumns = Array.isArray(apiFilters?._frozenColumns)\n    ? (apiFilters._frozenColumns as unknown[]).filter(\n        (k): k is string => typeof k === 'string' && k.length > 0,\n      )\n    : undefined\n\n  // Calculated (\"formula\") columns ride the same passthrough channel. The\n  // parser is defensive by construction \u2014 a legacy or hand-edited view drops\n  // the malformed entries rather than crashing the table. Do not hand-roll a\n  // second one.\n  const formulas = parseFormulaColumns(apiFilters?._formulas)\n\n  // Personalization metadata rides the same passthrough channel, for the same\n  // reason: the upstream settings schema strips unknown TOP-LEVEL keys, so a\n  // `origin`/`published` field alongside `columnOrder` would be silently\n  // dropped on the way to the database and the view would forget where it came\n  // from on the very first reload.\n  // How this view draws its rows. Same passthrough channel, same trap: a\n  // top-level `viewMode` would be stripped by the settings schema and the view\n  // would open as a table every time.\n  const viewMode = parseViewMode(apiFilters?._viewMode)\n\n  const origin = parsePerspectiveOrigin(apiFilters?._origin)\n  const publication = parsePerspectivePublication(apiFilters?._published)\n  // Two independent signals for the base row, and BOTH must hold. The flag is\n  // authoritative; the reserved name is the belt-and-braces guard so a\n  // hand-edited settings blob cannot make an ordinary named view disappear from\n  // the tab strip.\n  const isBaseView = apiFilters?._baseView === true && dto.name === BASE_VIEW_PERSPECTIVE_NAME\n\n  return {\n    id: dto.id,\n    name: dto.name,\n    color,\n    columns: { visible, hidden },\n    unseenColumns,\n    filters,\n    sorting,\n    grouping,\n    aggregations,\n    lookupColumns,\n    rollupColumns,\n    formulas,\n    dateFormat,\n    conditionalFormats,\n    frozenColumns,\n    viewMode,\n    isDefault: dto.isDefault,\n    isBaseView,\n    origin,\n    publication,\n  }\n}\n\n/**\n * Convert a DynamicTable PerspectiveConfig into the API format (PerspectiveSettings).\n * Used when saving perspectives via the API.\n */\nexport function dynamicTableToApi(config: DynamicTablePerspectiveConfig): PerspectiveSettings {\n  const columnVisibility: Record<string, boolean> = {}\n  config.columns.visible.forEach((col) => (columnVisibility[col] = true))\n  config.columns.hidden.forEach((col) => (columnVisibility[col] = false))\n\n  return {\n    columnOrder: config.columns.visible,\n    columnVisibility,\n    // `v: 2` marks the current filter shape. The upstream perspectives service\n    // (`maybeMigrateLegacyFilterValues`) DROPS any `filters` object that lacks\n    // either `v === 2` or a `root` key, treating it as a legacy value it can't\n    // migrate \u2014 so without this marker the saved filters silently vanish on load.\n    // `_aggregations` rides here too (passthrough record), since the settings\n    // schema would strip it as an unknown top-level key.\n    filters: {\n      v: 2,\n      rows: config.filters,\n      _color: config.color,\n      _aggregations: config.aggregations ?? [],\n      _lookups: config.lookupColumns ?? [],\n      _rollups: config.rollupColumns ?? [],\n      _dateFormat: config.dateFormat,\n      _conditionalFormats: config.conditionalFormats ?? [],\n      _formulas: config.formulas ?? [],\n      // Written only when the view actually pins something, so a view that has\n      // never used the feature does not grow an empty key \u2014 same rule as\n      // `_viewMode` below.\n      ...(config.frozenColumns && config.frozenColumns.length > 0\n        ? { _frozenColumns: config.frozenColumns }\n        : {}),\n      // Written only when the view has a mode, so a table-only view does not\n      // grow a key. `parseViewMode` treats absent and 'table' identically.\n      ...(config.viewMode ? { _viewMode: config.viewMode } : {}),\n      // Personalization metadata \u2014 see `apiToDynamicTable` for why it cannot\n      // live at the top level. Written only when set, so a plain personal view\n      // does not grow three null keys.\n      ...(config.origin ? { _origin: config.origin } : {}),\n      ...(config.publication ? { _published: config.publication } : {}),\n      ...(config.isBaseView ? { _baseView: true } : {}),\n    },\n    sorting: config.sorting.map((s) => ({\n      id: s.field,\n      desc: s.direction === 'desc',\n    })),\n    grouping: (config.grouping ?? []).map((g) => ({\n      id: g.id,\n      field: g.field,\n      desc: g.direction === 'desc',\n    })),\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}