@lnsy/data-table 0.1.0

package/src/file-io.js

@@ -0,0 +1,203 @@
+/**
+ * File I/O Module
+ *
+ * Load, save, import, and export for <data-table>.
+ * Formats: .lss (native), CSV, JSON, XLSX/XLS/ODS (import only).
+ *
+ * Single-sheet: all formats operate on one rectangular data grid.
+ */
+
+import * as XLSX from 'xlsx';
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function triggerDownload(blob, filename) {
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = filename;
+  document.body.appendChild(a);
+  a.click();
+  document.body.removeChild(a);
+  URL.revokeObjectURL(url);
+}
+
+function readFileAsText(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(reader.result);
+    reader.onerror = () => reject(reader.error);
+    reader.readAsText(file);
+  });
+}
+
+function readFileAsArrayBuffer(file) {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(reader.result);
+    reader.onerror = () => reject(reader.error);
+    reader.readAsArrayBuffer(file);
+  });
+}
+
+export function createHiddenFileInput(accept, callback) {
+  const input = document.createElement('input');
+  input.type = 'file';
+  input.accept = accept;
+  input.style.display = 'none';
+  input.onchange = (e) => {
+    const file = e.target.files[0];
+    if (file) callback(file);
+    document.body.removeChild(input);
+  };
+  document.body.appendChild(input);
+  input.click();
+}
+
+/** Normalize imported rows into an array-of-arrays of strings. */
+function normalizeData(data) {
+  if (!Array.isArray(data)) return [];
+  return data
+    .filter((row) => Array.isArray(row))
+    .map((row) =>
+      row.map((cell) => (cell === null || cell === undefined ? '' : String(cell)))
+    );
+}
+
+/**
+ * Drop trailing all-empty rows and columns so exports don't carry the
+ * spreadsheet's padding grid.
+ */
+function trimTrailingEmpties(data) {
+  const rows = data.filter((row) => row.some((cell) => cell !== ''));
+  if (rows.length === 0) return [];
+  let lastCol = 0;
+  for (const row of rows) {
+    for (let c = row.length - 1; c >= 0; c--) {
+      if (row[c] !== '') {
+        lastCol = Math.max(lastCol, c);
+        break;
+      }
+    }
+  }
+  return rows.map((row) => row.slice(0, lastCol + 1));
+}
+
+function applyToComponent(component, data) {
+  component.setData(normalizeData(data));
+}
+
+// ---------------------------------------------------------------------------
+// .lss — LNSY Spread Sheet (native format)
+// ---------------------------------------------------------------------------
+
+export function saveLSS(component, filename) {
+  const payload = {
+    version: '3.0',
+    format: 'lnsy-spreadsheet',
+    createdAt: new Date().toISOString(),
+    // Single sheet. Formulas are stored as raw "=…" strings.
+    sheet: {
+      name: 'Sheet1',
+      data: trimTrailingEmpties(component.getData()),
+    },
+  };
+
+  const blob = new Blob([JSON.stringify(payload, null, 2)], {
+    type: 'application/json',
+  });
+  triggerDownload(blob, filename || 'table.lss');
+}
+
+export async function loadLSS(component, file) {
+  const text = await readFileAsText(file);
+  let payload;
+  try {
+    payload = JSON.parse(text);
+  } catch {
+    throw new Error('Invalid .lss file: not valid JSON');
+  }
+
+  if (payload.format !== 'lnsy-spreadsheet') {
+    throw new Error('Invalid .lss file: unrecognized format');
+  }
+
+  // v1.0/v2.0 stored `data` (+ optional sheets array); v3.0 stores `sheet`.
+  let data;
+  if (payload.sheet?.data) {
+    data = payload.sheet.data;
+  } else if (Array.isArray(payload.sheets) && payload.sheets.length > 0) {
+    data = payload.sheets[0].data; // single sheet now: take the first
+  } else if (Array.isArray(payload.data)) {
+    data = payload.data;
+  } else {
+    return;
+  }
+
+  applyToComponent(component, data);
+}
+
+// ---------------------------------------------------------------------------
+// CSV
+// ---------------------------------------------------------------------------
+
+export function exportCSV(component, filename) {
+  // Like spreadsheet apps, CSV exchange uses computed values.
+  // (.lss keeps raw formulas; see saveLSS.)
+  const data = trimTrailingEmpties(component.getData()).map((row, r) =>
+    row.map((cell, c) =>
+      typeof cell === 'string' && cell.startsWith('=')
+        ? String(component.getComputedValue(r, c))
+        : cell
+    )
+  );
+  const ws = XLSX.utils.aoa_to_sheet(data);
+  const csv = XLSX.utils.sheet_to_csv(ws);
+  triggerDownload(new Blob([csv], { type: 'text/csv' }), filename || 'table.csv');
+}
+
+export async function importCSV(component, file) {
+  const buffer = await readFileAsArrayBuffer(file);
+  const workbook = XLSX.read(buffer, { type: 'array' });
+  const sheet = workbook.Sheets[workbook.SheetNames[0]];
+  applyToComponent(component, XLSX.utils.sheet_to_json(sheet, { header: 1 }));
+}
+
+// ---------------------------------------------------------------------------
+// JSON
+// ---------------------------------------------------------------------------
+
+export function exportJSON(component, filename) {
+  const data = trimTrailingEmpties(component.getData());
+  triggerDownload(
+    new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' }),
+    filename || 'table.json'
+  );
+}
+
+export async function importJSON(component, file) {
+  const text = await readFileAsText(file);
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    throw new Error('Invalid JSON file');
+  }
+  if (!Array.isArray(data)) {
+    throw new Error('Invalid JSON file: expected a two-dimensional array');
+  }
+  applyToComponent(component, data);
+}
+
+// ---------------------------------------------------------------------------
+// XLSX / XLS / ODS (import)
+// ---------------------------------------------------------------------------
+
+export async function importSpreadsheetFile(component, file) {
+  const buffer = await readFileAsArrayBuffer(file);
+  const workbook = XLSX.read(buffer, { type: 'array' });
+  const sheet = workbook.Sheets[workbook.SheetNames[0]];
+  applyToComponent(component, XLSX.utils.sheet_to_json(sheet, { header: 1 }));
+}