@pixerate/editor 0.23.0 → 0.24.0

package/dist/{chunk-K3R5NG2D.js → chunk-U5KWZU4X.js}

@@ -1,15 +1,23 @@
+import {
+  parseCsv,
+  parseTsv,
+  serializeCsv,
+  serializeTsv
+} from "./chunk-664LQYFJ.js";
 import {
   FormulaEvaluator,
+  NumberFormat,
   WHOLE_COLUMN_END_ROW,
   colNameToIndex,
   compareValues,
   describeFormulaError,
-  formatCellDisplay,
+  formatTextFunction,
   getFormulaArgumentSpecIndex,
   getFormulaFunction,
   getFormulaSignature,
   getFormulaSignatureParts,
   indexToColName,
+  isBlank,
   isFormulaError,
   numericValue,
   parseCellInput,
@@ -17,8 +25,9 @@ import {
   parseIsoDate,
   searchFormulaFunctions,
   sortCompareValues,
+  toText,
   tokenizeFormula
-} from "./chunk-QBJ22YZR.js";
+} from "./chunk-3CN2WD3X.js";
 
 // src/spreadsheet/formula/dependency-graph.ts
 var columnDependencyKey = (col) => `${col.toUpperCase()}:`;
@@ -566,6 +575,68 @@ function applyFormulaSuggestion(input, caret, name) {
   return { value, caret: start + insert.length + (hasParen ? 1 : 0) };
 }
 
+// src/spreadsheet/numfmt/presets.ts
+var NUMBER_FORMAT_PRESETS = [
+  { id: "general", label: "General", code: "General" },
+  { id: "number", label: "Number (0.00)", code: "0.00" },
+  { id: "currency", label: "Currency ($1,234.50)", code: '"$"#,##0.00' },
+  { id: "percent", label: "Percent (12.5%)", code: "0.0%" },
+  { id: "date", label: "Date (3/14/2026)", code: "m/d/yyyy" },
+  { id: "time", label: "Time (1:30 PM)", code: "h:mm AM/PM" }
+];
+function numberFormatForCellFormat(format) {
+  switch (format) {
+    case "currency":
+      return '"$"#,##0.00';
+    case "percentage":
+      return "0%";
+    case "date":
+      return "m/d/yyyy";
+    default:
+      return void 0;
+  }
+}
+function cellFormatForNumberFormat(code) {
+  switch (NumberFormat.parseCached(code).kind()) {
+    case "number":
+    case "fraction":
+    case "scientific":
+    case "special":
+      return "number";
+    case "currency":
+    case "accounting":
+      return "currency";
+    case "percentage":
+      return "percentage";
+    case "date":
+      return "date";
+    case "text":
+      return "text";
+    default:
+      return void 0;
+  }
+}
+var isGeneralNumberFormat = (code) => code === void 0 || NumberFormat.parseCached(code).isGeneral();
+
+// src/spreadsheet/formula/format.ts
+function formatCellForDisplay(cell) {
+  if (!cell) return { text: "", numeric: false };
+  if (cell.error) return { text: cell.error, numeric: false };
+  const { value } = cell;
+  const code = cell.numberFormat ?? (typeof value === "number" ? numberFormatForCellFormat(cell.format) : void 0);
+  if (code !== void 0 && !isGeneralNumberFormat(code) && !isBlank(value) && typeof value !== "boolean") {
+    return NumberFormat.parseCached(code).format(value);
+  }
+  return { text: toText(value), numeric: typeof value === "number" };
+}
+function formatCellDisplay(cell) {
+  return formatCellForDisplay(cell).text;
+}
+function formatValueWithCode(value, format) {
+  const result = formatTextFunction(value, format);
+  return "text" in result ? result.text : null;
+}
+
 // src/spreadsheet/datasource/index.ts
 var DataSourceBinder = class {
   dataSources = /* @__PURE__ */ new Map();
@@ -912,113 +983,6 @@ function getFillDirection(source, target) {
   return null;
 }
 
-// src/spreadsheet/csv.ts
-var BOM = "\uFEFF";
-function parseCsv(text, options = {}) {
-  const delimiter = options.delimiter ?? ",";
-  if (delimiter.length !== 1 || delimiter === '"' || delimiter === "\n" || delimiter === "\r") {
-    throw new Error(`Invalid CSV delimiter: ${JSON.stringify(delimiter)}`);
-  }
-  const input = text.startsWith(BOM) ? text.slice(1) : text;
-  const records = [];
-  let record = [];
-  let field = "";
-  let i = 0;
-  let recordStarted = false;
-  const endField = () => {
-    record.push(field);
-    field = "";
-  };
-  const endRecord = () => {
-    endField();
-    records.push(record);
-    record = [];
-    recordStarted = false;
-  };
-  let atFieldStart = true;
-  while (i < input.length) {
-    const char = input[i];
-    if (char === '"' && atFieldStart) {
-      const quoted = readQuoted(input, i, delimiter);
-      if (quoted.wellFormed || !options.requireWellFormedQuotes) {
-        recordStarted = true;
-        atFieldStart = false;
-        field += quoted.value;
-        i = quoted.end;
-        continue;
-      }
-    }
-    if (char === delimiter) {
-      recordStarted = true;
-      endField();
-      atFieldStart = true;
-      i++;
-      continue;
-    }
-    if (char === "\r" || char === "\n") {
-      endRecord();
-      atFieldStart = true;
-      i += char === "\r" && input[i + 1] === "\n" ? 2 : 1;
-      continue;
-    }
-    recordStarted = true;
-    atFieldStart = false;
-    field += char;
-    i++;
-  }
-  if (recordStarted || field !== "" || record.length > 0) endRecord();
-  return records;
-}
-function readQuoted(input, start, delimiter) {
-  let value = "";
-  let i = start + 1;
-  while (i < input.length) {
-    if (input[i] === '"') {
-      if (input[i + 1] === '"') {
-        value += '"';
-        i += 2;
-        continue;
-      }
-      const next = input[i + 1];
-      const wellFormed = next === void 0 || next === delimiter || next === "\r" || next === "\n";
-      return { value, end: i + 1, wellFormed };
-    }
-    value += input[i];
-    i++;
-  }
-  return { value, end: i, wellFormed: false };
-}
-function escapeCsvField(value, delimiter = ",", quoteAll = false) {
-  if (quoteAll || value.includes(delimiter) || /["\r\n]/.test(value)) {
-    return `"${value.replace(/"/g, '""')}"`;
-  }
-  return value;
-}
-function serializeCsv(rows, options = {}) {
-  const delimiter = options.delimiter ?? ",";
-  const lineEnding = options.lineEnding ?? "\r\n";
-  const body = rows.map(
-    (row) => row.map((value) => escapeCsvField(value == null ? "" : String(value), delimiter, options.quoteAll)).join(delimiter)
-  ).join(lineEnding);
-  return options.bom ? BOM + body : body;
-}
-function parseTsv(text) {
-  const normalized = text.startsWith(BOM) ? text.slice(1) : text;
-  if (!normalized.includes('"')) {
-    const body = normalized.replace(/\r\n?/g, "\n").replace(/\n$/, "");
-    return body === "" ? [] : body.split("\n").map((line) => line.split("	"));
-  }
-  return parseCsv(normalized, { delimiter: "	", requireWellFormedQuotes: true });
-}
-function serializeTsv(rows) {
-  return rows.map(
-    (row) => row.map((value) => {
-      const text = value == null ? "" : String(value);
-      return /[\t\r\n]/.test(text) || text.startsWith('"') ? `"${text.replace(/"/g, '""')}"` : text;
-    }).join("	")
-  ).join("\n");
-}
-
 // src/spreadsheet/clipboard.ts
 var SPREADSHEET_CLIPBOARD_MIME = "application/x.pixerate.spreadsheet+json";
 var displayText = (value) => value === null || value === void 0 ? "" : String(value);
@@ -1422,7 +1386,7 @@ var SpreadsheetController = class {
         const cell = cells[col.id];
         if (!cell || typeof cell.raw !== "string" || cell.raw.startsWith("=")) continue;
         if (col.type === "bound" && col.binding && row.recordId) continue;
-        const typed = this.typedCell(cell.raw, cell.format);
+        const typed = this.typedCell(cell.raw, cell.format, col, cell);
         cell.value = typed.value;
         if (typed.numberFormat) cell.numberFormat = typed.numberFormat;
         else delete cell.numberFormat;
@@ -1436,14 +1400,31 @@ var SpreadsheetController = class {
    * `CellFormat` to use: the automatic one (currency, percentage, date,
    * number) when `format` is unset or `text` (the default of new columns).
    */
-  typedCell(raw, format) {
+  typedCell(raw, format, col, existing) {
     const parsed = parseCellInput(raw);
+    const fixed = this.fixedNumberFormat(col, existing);
+    const numberFormat = fixed ?? parsed.numberFormat;
     return {
       value: parsed.value,
-      ...parsed.numberFormat ? { numberFormat: parsed.numberFormat } : {},
-      format: parsed.cellFormat && (!format || format === "text") ? parsed.cellFormat : format
+      ...numberFormat ? { numberFormat } : {},
+      ...existing?.explicitNumberFormat ? { explicitNumberFormat: true } : {},
+      format: fixed === void 0 && parsed.cellFormat && (!format || format === "text") ? parsed.cellFormat : format
     };
   }
+  /**
+   * The number format a cell keeps whatever is typed into it: its explicit
+   * one, else its column's. Undefined lets typed input choose one.
+   */
+  fixedNumberFormat(col, existing) {
+    if (existing?.explicitNumberFormat && existing.numberFormat !== void 0) return existing.numberFormat;
+    return col?.numberFormat && !isGeneralNumberFormat(col.numberFormat) ? col.numberFormat : void 0;
+  }
+  /** `numberFormat` / `explicitNumberFormat` fields for a formula, bound or spilled cell. */
+  fixedNumberFormatFields(col, existing) {
+    const numberFormat = this.fixedNumberFormat(col, existing);
+    if (numberFormat === void 0) return {};
+    return existing?.explicitNumberFormat ? { numberFormat, explicitNumberFormat: true } : { numberFormat };
+  }
   /**
    * Typed input for a bound field, coerced by the field's declared type:
    * number, boolean and date fields get a number, boolean or ISO date when
@@ -1501,10 +1482,13 @@ var SpreadsheetController = class {
       const spilled = this.spillCells.get(spillCellId(rowId, colId));
       if (spilled) return spilled;
     }
-    if (existing) return existing;
+    if (existing && !existing.explicitNumberFormat) return existing;
     const col = this.document.columns.find((c) => c.id === colId);
     const row = this.document.rows.find((r) => r.id === rowId);
-    return this.getDerivedCell(row, col);
+    const derived = this.getDerivedCell(row, col);
+    if (!existing) return derived;
+    if (derived.raw === "") return existing;
+    return { ...derived, numberFormat: existing.numberFormat, explicitNumberFormat: true };
   }
   /** Value of a cell with no stored data: bound record value, column formula, or blank. */
   getDerivedCell(row, col) {
@@ -1517,17 +1501,19 @@ var SpreadsheetController = class {
       return {
         raw: boundVal !== void 0 ? String(boundVal) : "",
         value: boundVal ?? "",
-        format: col.format
+        format: col.format,
+        ...this.fixedNumberFormatFields(col, void 0)
       };
     }
     if (col && col.type === "formula" && col.formula) {
       return {
         raw: col.formula,
         value: "",
-        format: col.format
+        format: col.format,
+        ...this.fixedNumberFormatFields(col, void 0)
       };
     }
-    return { raw: "", value: "", format: col?.format };
+    return { raw: "", value: "", format: col?.format, ...this.fixedNumberFormatFields(col, void 0) };
   }
   setCellValue(rowId, colId, raw) {
     this.recordSnapshot();
@@ -1537,15 +1523,16 @@ var SpreadsheetController = class {
     const col = this.document.columns.find((c) => c.id === colId);
     const row = this.document.rows.find((r) => r.id === rowId);
     const isFormula = raw.startsWith("=");
+    const existing = this.document.cells[rowId][colId];
     let cell;
     if (col?.type === "bound" && col.binding && row?.recordId) {
       const value = this.boundInputValue(col.binding.dataSource, col.binding.field, raw);
       this.binder.commitBoundValue(col.binding.dataSource, row.recordId, col.binding.field, value);
-      cell = { raw, value, format: col.format };
+      cell = { raw, value, format: col.format, ...this.fixedNumberFormatFields(col, existing) };
     } else if (isFormula) {
-      cell = { raw, value: raw, format: col?.format };
+      cell = { raw, value: raw, format: col?.format, ...this.fixedNumberFormatFields(col, existing) };
     } else {
-      cell = { raw, ...this.typedCell(raw, col?.format) };
+      cell = { raw, ...this.typedCell(raw, col?.format, col, existing) };
     }
     const cellKey = this.getCellKey(rowId, colId);
     this.depGraph.setCellFormula(cellKey, isFormula ? raw : null);
@@ -1748,7 +1735,13 @@ var SpreadsheetController = class {
         const rowObj = this.document.rows[row + r];
         const key = `${column.key}${row + r + 1}`.toUpperCase();
         const value = array.values[c * rows + r] ?? "";
-        const display = { raw: "", value, format: column.format, spillAnchor: anchor };
+        const display = {
+          raw: "",
+          value,
+          format: column.format,
+          spillAnchor: anchor,
+          ...this.fixedNumberFormatFields(column, this.document.cells[rowObj.id]?.[column.id])
+        };
         if (isFormulaError(value)) {
           display.error = value;
           display.errorMessage = describeFormulaError(value);
@@ -1973,6 +1966,7 @@ var SpreadsheetController = class {
       binding: config?.binding,
       formula: config?.formula,
       format: config?.format || "text",
+      ...config?.numberFormat ? { numberFormat: config.numberFormat } : {},
       readOnly: config?.readOnly
     };
     this.shiftReferences({ axis: "col", index, type: "insert" });
@@ -2460,6 +2454,94 @@ var SpreadsheetController = class {
       this.table[key] = value;
     });
   }
+  // --- Number formats ---
+  //
+  // Cells are replaced, never mutated in place: framework bindings compare
+  // cell objects by identity to decide what to re-render.
+  /**
+   * Sets an explicit number format code (e.g. `0.00`, `"$"#,##0.00`,
+   * `m/d/yyyy`, `[Red]0;[Blue]-0`) on every cell in `range`, including blank
+   * cells, so values typed later keep it. `null` removes explicit formats: the
+   * cells go back to their column's format or the one chosen for typed input.
+   * Undoable as one step. Returns false when there is no range.
+   */
+  setCellNumberFormat(range, code) {
+    if (!range) return false;
+    const r = normalizeRange(range);
+    this.recordSnapshot();
+    const kind = code === null ? void 0 : cellFormatForNumberFormat(code);
+    for (let ri = r.startRow; ri <= r.endRow; ri++) {
+      const row = this.document.rows[ri];
+      if (!row) continue;
+      for (let ci = r.startCol; ci <= r.endCol; ci++) {
+        const col = this.document.columns[ci];
+        if (!col) continue;
+        const cells = this.document.cells[row.id] ??= {};
+        const existing = cells[col.id];
+        if (code === null) {
+          if (!existing?.explicitNumberFormat) continue;
+          if (existing.raw === "" && existing.value === "" && !existing.error) {
+            delete cells[col.id];
+          } else {
+            const { explicitNumberFormat: _explicit, ...rest } = existing;
+            cells[col.id] = this.withNumberFormat(rest, this.implicitNumberFormat(rest, col, row));
+          }
+        } else {
+          cells[col.id] = {
+            ...existing ?? { raw: "", value: "" },
+            format: kind ?? existing?.format ?? col.format,
+            numberFormat: code,
+            explicitNumberFormat: true
+          };
+        }
+        this.refreshSpilledNumberFormat(row, col);
+      }
+    }
+    this.document.updatedAt = Date.now();
+    this.notifyChange();
+    return true;
+  }
+  /**
+   * Sets the number format code of a column (`null` or `General` clears it).
+   * Its cells without an explicit format of their own use it, including
+   * values typed later; when cleared they go back to the format chosen for
+   * typed input. Undoable.
+   */
+  setColumnNumberFormat(colId, code) {
+    const col = this.getColumn(colId);
+    if (!col) return;
+    this.recordSnapshot();
+    if (code === null || isGeneralNumberFormat(code)) delete col.numberFormat;
+    else col.numberFormat = code;
+    for (const row of this.document.rows) {
+      const cells = this.document.cells[row.id];
+      const cell = cells?.[col.id];
+      if (cells && cell && !cell.explicitNumberFormat) {
+        cells[col.id] = this.withNumberFormat(cell, this.implicitNumberFormat(cell, col, row));
+      }
+      this.refreshSpilledNumberFormat(row, col);
+    }
+    this.document.updatedAt = Date.now();
+    this.notifyChange();
+  }
+  /** The column's format, or the one typed input chose (typed cells only). */
+  implicitNumberFormat(cell, col, row) {
+    const typed = cell.raw !== "" && !cell.raw.startsWith("=") && !(col.type === "bound" && col.binding && row.recordId);
+    return this.fixedNumberFormat(col, void 0) ?? (typed ? parseCellInput(cell.raw).numberFormat : void 0);
+  }
+  /** A copy of `cell` with `numberFormat` set, or removed when undefined. */
+  withNumberFormat(cell, numberFormat) {
+    const { numberFormat: _old, ...rest } = cell;
+    return numberFormat === void 0 ? rest : { ...rest, numberFormat };
+  }
+  /** Re-applies the stored cell's (or the column's) format to a spilled value shown there. */
+  refreshSpilledNumberFormat(row, col) {
+    const id = spillCellId(row.id, col.id);
+    const spilled = this.spillCells.get(id);
+    if (!spilled) return;
+    const { numberFormat: _old, explicitNumberFormat: _explicit, ...rest } = spilled;
+    this.spillCells.set(id, { ...rest, ...this.fixedNumberFormatFields(col, this.document.cells[row.id]?.[col.id]) });
+  }
   // --- Hide / unhide ---
   hideRows(indices) {
     this.setHidden("row", indices, true);
@@ -2793,6 +2875,17 @@ function stepInOrder(order, from, delta) {
 }
 
 // src/spreadsheet/menu.ts
+function runSpreadsheetMenuItem(item, ask) {
+  if (!item.input) {
+    item.run();
+    return true;
+  }
+  const prompt = ask ?? ((label, value) => typeof window !== "undefined" && window.prompt ? window.prompt(label, value) : null);
+  const text = prompt(item.input.label, item.input.defaultValue ?? "");
+  if (text === null || text === void 0) return false;
+  item.run(text);
+  return true;
+}
 function clampMenuPosition(point, size, viewport, margin = 4) {
   const place = (start, length, limit) => {
     if (start + length <= limit - margin) return Math.max(margin, start);
@@ -2927,6 +3020,31 @@ function getSpreadsheetMenuItems(controller, cell) {
       }
     }
   ];
+  const currentFormat = cellData.numberFormat;
+  const presetMatch = NUMBER_FORMAT_PRESETS.find(
+    (p) => p.id === "general" ? isGeneralNumberFormat(currentFormat) : p.code === currentFormat
+  );
+  NUMBER_FORMAT_PRESETS.forEach((preset, i) => {
+    items.push({
+      id: `number-format-${preset.id}`,
+      label: `Format cells: ${preset.label}`,
+      separatorBefore: i === 0,
+      checked: presetMatch === preset,
+      run: () => {
+        controller.setCellNumberFormat(selection, preset.code);
+      }
+    });
+  });
+  items.push({
+    id: "number-format-custom",
+    label: "Format cells: Custom\u2026",
+    checked: !presetMatch,
+    input: { label: "Number format code, e.g. #,##0.00;[Red](#,##0.00)", defaultValue: currentFormat ?? "General" },
+    run: (code) => {
+      if (code === void 0) return;
+      controller.setCellNumberFormat(selection, code.trim() === "" ? null : code);
+    }
+  });
   if (grouping) {
     items.push(
       {
@@ -2985,6 +3103,8 @@ var SPREADSHEET_TABLE_ACTIONS = [
   "toggleGroupCollapsed",
   "getGroups",
   "transposeRange",
+  "setCellNumberFormat",
+  "setColumnNumberFormat",
   "exportToCsv",
   "importFromCsv",
   "copyToClipboardData",
@@ -3053,6 +3173,13 @@ export {
   getFormulaCaretContext,
   getFormulaHints,
   applyFormulaSuggestion,
+  NUMBER_FORMAT_PRESETS,
+  numberFormatForCellFormat,
+  cellFormatForNumberFormat,
+  isGeneralNumberFormat,
+  formatCellForDisplay,
+  formatCellDisplay,
+  formatValueWithCode,
   DataSourceBinder,
   normalizeRange,
   rangeContains,
@@ -3068,11 +3195,6 @@ export {
   fillSeries,
   computeFillTarget,
   getFillDirection,
-  parseCsv,
-  escapeCsvField,
-  serializeCsv,
-  parseTsv,
-  serializeTsv,
   SPREADSHEET_CLIPBOARD_MIME,
   serializeHtmlTable,
   parseHtmlTable,
@@ -3087,6 +3209,7 @@ export {
   computeRowGroups,
   buildSpreadsheetView,
   SpreadsheetController,
+  runSpreadsheetMenuItem,
   clampMenuPosition,
   getSpreadsheetMenuItems,
   SPREADSHEET_TABLE_ACTIONS,
@@ -3097,4 +3220,4 @@ export {
   registerSpreadsheetImportAdapters,
   importFileIntoSpreadsheet
 };
-//# sourceMappingURL=chunk-K3R5NG2D.js.map
+//# sourceMappingURL=chunk-U5KWZU4X.js.map