@noy-db/as-xlsx 0.2.0-pre.2 → 0.2.0-pre.21

package/dist/index.d.ts

@@ -39,7 +39,39 @@ import { DictEntry, VaultDiff, Vault } from '@noy-db/hub';
  *
  * @module
  */
-/** One row in a sheet. Values are coerced per type at emit time. */
+/**
+ * A formula cell. Emits `<f>` so the spreadsheet recomputes live; `v` is an
+ * optional cached result (what the formula currently evaluates to) so the value
+ * shows immediately on open and survives a round-trip read. Build via
+ * {@link formula}. The formula string must NOT include a leading `=`.
+ */
+interface XlsxFormulaCell {
+    readonly __xlsxFormula: string;
+    readonly v?: string | number | boolean;
+}
+/** Build a {@link XlsxFormulaCell}. `f` is the formula body without a leading `=`. */
+declare function formula(f: string, cachedValue?: string | number | boolean): XlsxFormulaCell;
+/**
+ * A value cell carrying a number-format code (e.g. `'#,##0.00'` for currency,
+ * `'yyyy-mm-dd'` for dates). Build via {@link styled}. The format only renders
+ * meaningfully on numeric values.
+ */
+interface XlsxStyledCell {
+    readonly __xlsxStyle: string;
+    readonly v: string | number | boolean | null;
+}
+/** Build a {@link XlsxStyledCell} — a value plus an Excel number-format code. */
+declare function styled(value: string | number | boolean | null, numberFormat: string): XlsxStyledCell;
+/** A data-validation rule (dropdown) over a cell range. */
+interface XlsxValidation {
+    /** Target range in A1 notation, e.g. `'B2:B100'`. */
+    readonly sqref: string;
+    /** Inline allowed values → a `"a,b,c"` list. Mutually exclusive with `formula1`. */
+    readonly values?: readonly string[];
+    /** Explicit `formula1` (e.g. a range ref `Clients!$A$2:$A$999`). */
+    readonly formula1?: string;
+}
+/** One row in a sheet. A cell is a primitive value or an {@link XlsxFormulaCell}. */
 type XlsxRow = ReadonlyArray<unknown>;
 /** One sheet in a workbook. */
 interface XlsxSheet {
@@ -60,12 +92,19 @@ interface XlsxSheet {
      * for "auto" columns and a number for explicit widths.
      */
     readonly widths?: ReadonlyArray<number | undefined>;
+    /** Data-validation dropdowns applied to ranges on this sheet. */
+    readonly validations?: readonly XlsxValidation[];
 }
 /**
  * Build a complete `.xlsx` byte stream from the supplied sheet data.
  * Pure — no I/O beyond the internal zip concatenation.
  */
-declare function writeXlsx(sheets: readonly XlsxSheet[]): Promise<Uint8Array>;
+declare function writeXlsx(sheets: readonly XlsxSheet[], options?: {
+    definedNames?: ReadonlyArray<{
+        readonly name: string;
+        readonly ref: string;
+    }>;
+}): Promise<Uint8Array>;
 /**
  * Convert a 1-based column index to Excel A1 letter notation.
  * 1 → A, 26 → Z, 27 → AA, 702 → ZZ, 703 → AAA.
@@ -179,11 +218,77 @@ interface AsXlsxSheetOptions {
      * mirrors `XlsxSheet.widths`, which it threads through.
      */
     readonly widths?: ReadonlyArray<number | undefined>;
+    /**
+     * Smart mode only: per-field Excel number-format codes (e.g.
+     * `{ amount: '#,##0.00' }` for currency). The value is coerced to a number so
+     * the format renders. Money has no introspection signal, so currency
+     * formatting is opt-in here.
+     */
+    readonly numberFormats?: Record<string, string>;
+    /**
+     * Smart mode only: per-field explicit dropdown value lists. Overrides the
+     * auto-detected enum/ref dropdown for that field.
+     */
+    readonly dropdowns?: Record<string, readonly string[]>;
+    /**
+     * Smart mode only: fields whose stored value is a multi-locale i18n map
+     * (`{ en: '…', th: '…' }`). Each becomes per-locale columns plus a display
+     * column resolved **live by the global LANG cell** (change LANG → every label
+     * re-renders). Read raw, so open the export vault without an active locale.
+     */
+    readonly i18nFields?: readonly string[];
+    /**
+     * Smart mode only: map a dict-backed (code) field to its dictionary name, e.g.
+     * `{ status: 'status' }`. Emits a hidden `_Lookups_<dict>` sheet (code +
+     * per-locale labels) and a `<field>__label` display column resolved by the
+     * global LANG cell via `VLOOKUP(code, …, MATCH(LANG, …))`.
+     */
+    readonly dictFields?: Record<string, string>;
+}
+/** One aggregate column in a smart-mode summary sheet (#414 P3). */
+interface AsXlsxSummaryAggregate {
+    /** Column header for this aggregate. */
+    readonly label: string;
+    readonly op: 'sum' | 'count' | 'avg';
+    /** Field to aggregate — required for `sum`/`avg`, ignored for `count`. */
+    readonly field?: string;
+}
+/**
+ * A groupBy summary sheet (#414 P3): groups the source collection's sheet by
+ * `groupBy` and emits live SUMIFS/COUNTIFS/AVERAGEIFS columns (values cached at
+ * export). The source value columns must be numeric for the live formulas to
+ * compute (apply `numberFormats` to money fields).
+ */
+interface AsXlsxSummarySpec {
+    /** Summary sheet name. */
+    readonly name: string;
+    /** Source collection (must be exported as a sheet). */
+    readonly from: string;
+    /** Field to group by. */
+    readonly groupBy: string;
+    readonly aggregates: readonly AsXlsxSummaryAggregate[];
 }
 /** Single-collection convenience — passed where a sheet-list is accepted. */
 interface AsXlsxOptions {
     /** One or more sheets. At least one required. */
     readonly sheets: readonly AsXlsxSheetOptions[];
+    /** Smart mode only: groupBy summary sheets (live SUMIFS/COUNTIFS/AVERAGEIFS). */
+    readonly summaries?: readonly AsXlsxSummarySpec[];
+    /**
+     * Smart-workbook mode (#414). Emits a relational workbook instead of a flat
+     * dump:
+     *   - every sheet is **id-first** (record `id` in column A);
+     *   - each foreign-key field (auto-detected via `vault.dumpSchema()`) gets a
+     *     `<field>__label` column — a cross-sheet `VLOOKUP` that resolves the
+     *     reference to the target's first field, carrying a **cached** label so it
+     *     shows immediately and recomputes live on edit;
+     *   - a `_manifest` index sheet lists every collection, its row count, and
+     *     its refs.
+     *
+     * Requires unique sheet names ≤ 31 chars (so cross-sheet refs resolve) and an
+     * `id` field on records. Defaults to the existing flat export when omitted.
+     */
+    readonly smart?: boolean;
 }
 /** Options for `download()` — adds optional filename. */
 interface AsXlsxDownloadOptions extends AsXlsxOptions {
@@ -297,4 +402,4 @@ interface AsXlsxImportPlan {
  */
 declare function fromBytes(vault: Vault, bytes: Uint8Array, options: AsXlsxImportOptions): Promise<AsXlsxImportPlan>;
 
-export { type AsXlsxDownloadOptions, type AsXlsxImportOptions, type AsXlsxImportPlan, type AsXlsxOptions, type AsXlsxSheetOptions, type AsXlsxWriteOptions, type ImportPolicy, type ReadXlsxResult, type ReadXlsxRow, type ReadXlsxSheet, XlsxDictAmbiguityError, type XlsxRow, type XlsxSheet, colLetter, download, fromBytes, readXlsx, toBytes, toBytesFromCollection, write, writeXlsx };
+export { type AsXlsxDownloadOptions, type AsXlsxImportOptions, type AsXlsxImportPlan, type AsXlsxOptions, type AsXlsxSheetOptions, type AsXlsxSummaryAggregate, type AsXlsxSummarySpec, type AsXlsxWriteOptions, type ImportPolicy, type ReadXlsxResult, type ReadXlsxRow, type ReadXlsxSheet, XlsxDictAmbiguityError, type XlsxFormulaCell, type XlsxRow, type XlsxSheet, type XlsxStyledCell, type XlsxValidation, colLetter, download, formula, fromBytes, readXlsx, styled, toBytes, toBytesFromCollection, write, writeXlsx };

package/dist/index.js

@@ -2,7 +2,19 @@
 import { writeZip } from "@noy-db/as-zip";
 var XML_HEADER = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
 var ENCODER = new TextEncoder();
-async function writeXlsx(sheets) {
+function formula(f, cachedValue) {
+  return cachedValue === void 0 ? { __xlsxFormula: f } : { __xlsxFormula: f, v: cachedValue };
+}
+function isFormulaCell(v) {
+  return typeof v === "object" && v !== null && typeof v.__xlsxFormula === "string";
+}
+function styled(value, numberFormat) {
+  return { __xlsxStyle: numberFormat, v: value };
+}
+function isStyledCell(v) {
+  return typeof v === "object" && v !== null && typeof v.__xlsxStyle === "string";
+}
+async function writeXlsx(sheets, options = {}) {
   if (sheets.length === 0) {
     throw new Error("writeXlsx: at least one sheet is required");
   }
@@ -27,6 +39,16 @@ async function writeXlsx(sheets) {
     stringIndex.set(s, idx);
     return idx;
   };
+  const numFmtCodes = [];
+  const styleIndexByCode = /* @__PURE__ */ new Map();
+  const internStyle = (code) => {
+    const existing = styleIndexByCode.get(code);
+    if (existing !== void 0) return existing;
+    const idx = numFmtCodes.length + 1;
+    numFmtCodes.push(code);
+    styleIndexByCode.set(code, idx);
+    return idx;
+  };
   const sheetXmls = safeSheets.map((sheet) => {
     const lines = [
       XML_HEADER,
@@ -56,12 +78,42 @@ async function writeXlsx(sheets) {
     }
     for (const row of sheet.rows) {
       rowNum++;
-      const cells = row.map((value, i) => cellXml(value, i + 1, rowNum, internString)).join("");
+      const cells = row.map((value, i) => cellXml(value, i + 1, rowNum, internString, internStyle)).join("");
       lines.push(`<row r="${rowNum}">${cells}</row>`);
     }
-    lines.push("</sheetData>", "</worksheet>");
+    lines.push("</sheetData>");
+    if (sheet.validations && sheet.validations.length > 0) {
+      lines.push(`<dataValidations count="${sheet.validations.length}">`);
+      for (const dv of sheet.validations) {
+        const f1 = dv.formula1 ?? `"${(dv.values ?? []).join(",")}"`;
+        lines.push(
+          `<dataValidation type="list" allowBlank="1" showInputMessage="1" showErrorMessage="1" sqref="${escapeXmlAttr(dv.sqref)}"><formula1>${escapeXmlText(f1)}</formula1></dataValidation>`
+        );
+      }
+      lines.push("</dataValidations>");
+    }
+    lines.push("</worksheet>");
     return lines.join("");
   });
+  const hasStyles = numFmtCodes.length > 0;
+  const stylesXml = hasStyles ? [
+    XML_HEADER,
+    '<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">',
+    `<numFmts count="${numFmtCodes.length}">`,
+    ...numFmtCodes.map((code, i) => `<numFmt numFmtId="${164 + i}" formatCode="${escapeXmlAttr(code)}"/>`),
+    "</numFmts>",
+    '<fonts count="1"><font><sz val="11"/><name val="Calibri"/></font></fonts>',
+    '<fills count="1"><fill><patternFill patternType="none"/></fill></fills>',
+    '<borders count="1"><border/></borders>',
+    '<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>',
+    `<cellXfs count="${numFmtCodes.length + 1}">`,
+    '<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>',
+    ...numFmtCodes.map(
+      (_, i) => `<xf numFmtId="${164 + i}" fontId="0" fillId="0" borderId="0" xfId="0" applyNumberFormat="1"/>`
+    ),
+    "</cellXfs>",
+    "</styleSheet>"
+  ].join("") : "";
   const sheetEntries = safeSheets.map((s, i) => ({
     index: i + 1,
     id: `rId${i + 1}`,
@@ -78,6 +130,7 @@ async function writeXlsx(sheets) {
       (s) => `<Override PartName="/${s.path}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>`
     ),
     '<Override PartName="/xl/sharedStrings.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"/>',
+    ...hasStyles ? ['<Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/>'] : [],
     "</Types>"
   ].join("");
   const rootRels = XML_HEADER + '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml"/></Relationships>';
@@ -89,6 +142,13 @@ async function writeXlsx(sheets) {
       (s) => `<sheet name="${escapeXmlAttr(s.name)}" sheetId="${s.index}" r:id="${s.id}"/>`
     ),
     "</sheets>",
+    ...options.definedNames && options.definedNames.length > 0 ? [
+      "<definedNames>",
+      ...options.definedNames.map(
+        (d) => `<definedName name="${escapeXmlAttr(d.name)}">${escapeXmlText(d.ref)}</definedName>`
+      ),
+      "</definedNames>"
+    ] : [],
     "</workbook>"
   ].join("");
   const workbookRels = [
@@ -98,6 +158,7 @@ async function writeXlsx(sheets) {
       (s) => `<Relationship Id="${s.id}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet${s.index}.xml"/>`
     ),
     `<Relationship Id="rIdSharedStrings" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings" Target="sharedStrings.xml"/>`,
+    ...hasStyles ? [`<Relationship Id="rIdStyles" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>`] : [],
     "</Relationships>"
   ].join("");
   const sharedStringsXml = [
@@ -112,12 +173,28 @@ async function writeXlsx(sheets) {
     { path: "xl/workbook.xml", bytes: ENCODER.encode(workbookXml) },
     { path: "xl/_rels/workbook.xml.rels", bytes: ENCODER.encode(workbookRels) },
     { path: "xl/sharedStrings.xml", bytes: ENCODER.encode(sharedStringsXml) },
+    ...hasStyles ? [{ path: "xl/styles.xml", bytes: ENCODER.encode(stylesXml) }] : [],
     ...sheetEntries.map((s, i) => ({ path: s.path, bytes: ENCODER.encode(sheetXmls[i] ?? "") }))
   ];
   return await writeZip(entries);
 }
-function cellXml(value, colIdx, rowNum, intern) {
+function cellXml(value, colIdx, rowNum, intern, internStyle) {
   const ref = `${colLetter(colIdx)}${rowNum}`;
+  if (isStyledCell(value)) {
+    const s2 = internStyle(value.__xlsxStyle);
+    const v = value.v;
+    if (v === null || v === void 0 || v === "") return `<c r="${ref}" s="${s2}"/>`;
+    if (typeof v === "number" && Number.isFinite(v)) return `<c r="${ref}" s="${s2}"><v>${v}</v></c>`;
+    if (typeof v === "boolean") return `<c r="${ref}" s="${s2}" t="b"><v>${v ? 1 : 0}</v></c>`;
+    return `<c r="${ref}" s="${s2}" t="s"><v>${intern(typeof v === "string" ? v : String(v))}</v></c>`;
+  }
+  if (isFormulaCell(value)) {
+    const f = escapeXmlText(value.__xlsxFormula);
+    if (value.v === void 0) return `<c r="${ref}"><f>${f}</f></c>`;
+    if (typeof value.v === "number" && Number.isFinite(value.v)) return `<c r="${ref}"><f>${f}</f><v>${value.v}</v></c>`;
+    if (typeof value.v === "boolean") return `<c r="${ref}" t="b"><f>${f}</f><v>${value.v ? 1 : 0}</v></c>`;
+    return `<c r="${ref}" t="str"><f>${f}</f><v>${escapeXmlText(String(value.v))}</v></c>`;
+  }
   if (value === null || value === void 0 || value === "") return `<c r="${ref}"/>`;
   if (typeof value === "number" && Number.isFinite(value)) {
     return `<c r="${ref}"><v>${value}</v></c>`;
@@ -354,6 +431,10 @@ async function toBytes(vault, options) {
   if (options.sheets.length === 0) {
     throw new Error("as-xlsx: at least one sheet is required");
   }
+  if (options.smart) {
+    const { sheets, definedNames } = await buildSmartSheets(vault, options);
+    return writeXlsx(sheets, { definedNames });
+  }
   const materialisedSheets = [];
   for (const sheetOpt of options.sheets) {
     const collection = vault.collection(sheetOpt.collection);
@@ -397,6 +478,229 @@ async function write(vault, path, options) {
   const { writeFile } = await import("fs/promises");
   await writeFile(path, bytes);
 }
+function safeStringify(v) {
+  if (typeof v === "string") return v;
+  if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);
+  if (v == null) return "";
+  try {
+    return JSON.stringify(v) ?? "";
+  } catch {
+    return "";
+  }
+}
+function asCached(v) {
+  if (typeof v === "number" || typeof v === "boolean" || typeof v === "string") return v;
+  return safeStringify(v);
+}
+async function buildSmartSheets(vault, options) {
+  const snapshot = await vault.dumpSchema();
+  const sheetNameByCollection = /* @__PURE__ */ new Map();
+  for (const s of options.sheets) sheetNameByCollection.set(s.collection, s.name);
+  const mats = [];
+  const localeSet = /* @__PURE__ */ new Set();
+  for (const sheetOpt of options.sheets) {
+    const collection = vault.collection(sheetOpt.collection);
+    const list = await collection.list();
+    const records = [];
+    for (const item of list) {
+      const r = item;
+      if (sheetOpt.filter && !sheetOpt.filter(r)) continue;
+      records.push(r);
+    }
+    const base = sheetOpt.columns ?? inferColumns(records);
+    const cols = ["id", ...base.filter((c) => c !== "id")];
+    const labelCol = cols.find((c) => c !== "id");
+    const labelMap = /* @__PURE__ */ new Map();
+    if (labelCol) {
+      for (const r of records) if (r.id != null) labelMap.set(safeStringify(r.id), r[labelCol]);
+    }
+    const i18nFields = (sheetOpt.i18nFields ?? []).filter((f) => cols.includes(f));
+    for (const f of i18nFields) {
+      for (const r of records) {
+        const v = r[f];
+        if (v && typeof v === "object") for (const loc of Object.keys(v)) localeSet.add(loc);
+      }
+    }
+    mats.push({ opt: sheetOpt, records, cols, labelMap, i18nFields });
+  }
+  const matByCollection = new Map(mats.map((m) => [m.opt.collection, m]));
+  const dictEntries = /* @__PURE__ */ new Map();
+  for (const m of mats) {
+    for (const [field, dictName] of Object.entries(m.opt.dictFields ?? {})) {
+      if (!m.cols.includes(field) || dictEntries.has(dictName)) continue;
+      dictEntries.set(dictName, await vault.dictionary(dictName).list());
+    }
+  }
+  for (const entries of dictEntries.values()) {
+    for (const e of entries) for (const loc of Object.keys(e.labels)) localeSet.add(loc);
+  }
+  const locales = [...localeSet].sort();
+  const hasLang = locales.length > 0;
+  const defaultLocale = locales.includes("en") ? "en" : locales[0] ?? "en";
+  const ifChain = (refOf) => {
+    if (locales.length === 0) return '""';
+    let expr = refOf(locales[0]);
+    for (let k = locales.length - 1; k >= 0; k--) {
+      expr = `IF(LANG="${locales[k]}",${refOf(locales[k])},${expr})`;
+    }
+    return expr;
+  };
+  const sheetMeta = /* @__PURE__ */ new Map();
+  const dataSheets = mats.map((m) => {
+    const refs = snapshot.collections[m.opt.collection]?.refs ?? {};
+    const fields = snapshot.collections[m.opt.collection]?.fields ?? {};
+    const i18nSet = new Set(m.i18nFields);
+    const refFields = Object.keys(refs).filter((f) => m.cols.includes(f) && matByCollection.has(refs[f].target));
+    const baseCols = m.cols.filter((c) => !i18nSet.has(c));
+    const i18nFlat = m.i18nFields.flatMap((f) => [f, ...locales.map((l) => `${f}__${l}`)]);
+    const dictPairs = Object.entries(m.opt.dictFields ?? {}).filter(([f]) => m.cols.includes(f));
+    const header = [
+      ...baseCols,
+      ...i18nFlat,
+      ...dictPairs.map(([f]) => `${f}__label`),
+      ...refFields.map((f) => `${f}__label`)
+    ];
+    const colIndex = /* @__PURE__ */ new Map();
+    header.forEach((h, i) => colIndex.set(h, i + 1));
+    sheetMeta.set(m.opt.collection, { name: m.opt.name, colIndex });
+    const lastRow = Math.max(m.records.length + 1, 2);
+    const validations = [];
+    for (const field of baseCols) {
+      const colL = colLetter(colIndex.get(field));
+      const sqref = `${colL}2:${colL}${lastRow}`;
+      const explicit = m.opt.dropdowns?.[field];
+      if (explicit && explicit.length > 0) {
+        validations.push({ sqref, values: explicit });
+        continue;
+      }
+      const rf = refs[field];
+      if (rf && matByCollection.has(rf.target)) {
+        const targetSheet = sheetNameByCollection.get(rf.target);
+        const targetRows = Math.max(matByCollection.get(rf.target).records.length + 1, 2);
+        validations.push({ sqref, formula1: `'${targetSheet}'!$A$2:$A$${targetRows}` });
+        continue;
+      }
+      const enumVals = fields[field]?.constraints?.["values"];
+      if (Array.isArray(enumVals) && enumVals.length > 0) validations.push({ sqref, values: enumVals.map((v) => safeStringify(v)) });
+    }
+    const rows = m.records.map((r, i) => {
+      const rowNum = i + 2;
+      const baseCells = baseCols.map((c) => {
+        const raw = c === "id" ? r.id ?? null : r[c] ?? null;
+        const fmt = m.opt.numberFormats?.[c];
+        if (fmt === void 0) return raw;
+        const num = typeof raw === "string" && raw.trim() !== "" && Number.isFinite(Number(raw)) ? Number(raw) : raw;
+        return styled(num, fmt);
+      });
+      const i18nCells = m.i18nFields.flatMap((f) => {
+        const rawMap = r[f] && typeof r[f] === "object" ? r[f] : {};
+        const display = formula(
+          ifChain((l) => `${colLetter(colIndex.get(`${f}__${l}`))}${rowNum}`),
+          asCached(rawMap[defaultLocale] ?? "")
+        );
+        return [display, ...locales.map((l) => rawMap[l] ?? null)];
+      });
+      const dictCells = dictPairs.map(([f, dn]) => {
+        const codeRef = `${colLetter(colIndex.get(f))}${rowNum}`;
+        const lk = `_Lookups_${dn}`;
+        const f1 = `IFERROR(VLOOKUP(${codeRef},'${lk}'!$A:$ZZ,MATCH(LANG,'${lk}'!$1:$1,0),FALSE),${codeRef})`;
+        const code = r[f];
+        const entry = code == null ? void 0 : dictEntries.get(dn)?.find((e) => e.key === safeStringify(code));
+        return formula(f1, asCached(entry?.labels[defaultLocale] ?? (code ?? "")));
+      });
+      const refCells = refFields.map((f) => {
+        const target = refs[f].target;
+        const targetSheet = sheetNameByCollection.get(target);
+        const targetMat = matByCollection.get(target);
+        const codeRef = `${colLetter(colIndex.get(f))}${rowNum}`;
+        const f1 = `IFERROR(VLOOKUP(${codeRef},'${targetSheet}'!$A:$ZZ,2,FALSE),"")`;
+        const code = r[f];
+        const cached = code == null ? "" : asCached(targetMat.labelMap.get(safeStringify(code)));
+        return formula(f1, cached);
+      });
+      return [...baseCells, ...i18nCells, ...dictCells, ...refCells];
+    });
+    return {
+      name: m.opt.name,
+      header,
+      rows,
+      ...validations.length > 0 ? { validations } : {},
+      ...m.opt.widths !== void 0 ? { widths: m.opt.widths } : {}
+    };
+  });
+  const manifest = {
+    name: "_manifest",
+    header: ["Collection", "Records", "Refs"],
+    rows: mats.map((m) => {
+      const refs = snapshot.collections[m.opt.collection]?.refs ?? {};
+      return [m.opt.name, m.records.length, Object.entries(refs).map(([f, r]) => `${f}\u2192${r.target}`).join(", ")];
+    })
+  };
+  const summarySheets = [];
+  for (const spec of options.summaries ?? []) {
+    const src = sheetMeta.get(spec.from);
+    const srcMat = matByCollection.get(spec.from);
+    const gCol = src?.colIndex.get(spec.groupBy);
+    if (!src || !srcMat || gCol === void 0) continue;
+    const gLetter = colLetter(gCol);
+    const seen = /* @__PURE__ */ new Set();
+    const groups = [];
+    for (const r of srcMat.records) {
+      const k = safeStringify(r[spec.groupBy]);
+      if (!seen.has(k)) {
+        seen.add(k);
+        groups.push(r[spec.groupBy]);
+      }
+    }
+    const header = [spec.groupBy, ...spec.aggregates.map((a) => a.label)];
+    const rows = groups.map((g, i) => {
+      const rowNum = i + 2;
+      const groupRecs = srcMat.records.filter((r) => safeStringify(r[spec.groupBy]) === safeStringify(g));
+      const cells = [g];
+      for (const a of spec.aggregates) {
+        if (a.op === "count") {
+          cells.push(formula(`COUNTIFS('${src.name}'!$${gLetter}:$${gLetter},$A${rowNum})`, groupRecs.length));
+          continue;
+        }
+        const vIdx = a.field ? src.colIndex.get(a.field) : void 0;
+        if (vIdx === void 0) {
+          cells.push(null);
+          continue;
+        }
+        const vLetter = colLetter(vIdx);
+        const nums = groupRecs.map((r) => Number(r[a.field])).filter((n) => Number.isFinite(n));
+        const sum = nums.reduce((s, n) => s + n, 0);
+        const cached = a.op === "sum" ? sum : nums.length ? sum / nums.length : 0;
+        const fn = a.op === "sum" ? "SUMIFS" : "AVERAGEIFS";
+        cells.push(
+          formula(`${fn}('${src.name}'!$${vLetter}:$${vLetter},'${src.name}'!$${gLetter}:$${gLetter},$A${rowNum})`, cached)
+        );
+      }
+      return cells;
+    });
+    summarySheets.push({ name: spec.name, header, rows });
+  }
+  const lookupSheets = [...dictEntries.entries()].map(([dn, entries]) => ({
+    name: `_Lookups_${dn}`,
+    header: ["Code", ...locales],
+    rows: entries.map((e) => [e.key, ...locales.map((l) => e.labels[l] ?? "")])
+  }));
+  const settingsSheets = [];
+  const definedNames = [];
+  if (hasLang) {
+    settingsSheets.push({
+      name: "_settings",
+      header: ["Setting", "Value"],
+      rows: [["Language", defaultLocale]],
+      validations: [{ sqref: "B2:B2", values: locales }]
+    });
+    definedNames.push({ name: "LANG", ref: `'_settings'!$B$2` });
+  }
+  return {
+    sheets: [...settingsSheets, ...lookupSheets, manifest, ...summarySheets, ...dataSheets],
+    definedNames
+  };
+}
 function inferColumns(records) {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
@@ -582,8 +886,10 @@ export {
   XlsxDictAmbiguityError,
   colLetter,
   download,
+  formula,
   fromBytes,
   readXlsx,
+  styled,
   toBytes,
   toBytesFromCollection,
   write,