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

package/dist/index.d.cts

@@ -154,6 +154,30 @@ interface ReadXlsxResult {
  */
 declare function readXlsx(bytes: Uint8Array): Promise<ReadXlsxResult>;
 
+type InferredType = 'string' | 'number' | 'boolean' | 'date';
+interface InferredField {
+    readonly type: InferredType;
+    /** Target collection (sheet) name when this field looks like a foreign key. */
+    readonly references?: string;
+}
+interface InferredCollection {
+    readonly idField: string;
+    readonly fields: Record<string, InferredField>;
+}
+interface InferredSchema {
+    readonly collections: Record<string, InferredCollection>;
+}
+/**
+ * Infer a {@link InferredSchema} from an `.xlsx` byte stream. Sheets whose name
+ * starts with `_` (our smart-export meta sheets) are skipped; pass `skipSheets`
+ * to exclude more (e.g. summary sheets).
+ */
+declare function inferSchema(bytes: Uint8Array, options?: {
+    skipSheets?: readonly string[];
+}): Promise<InferredSchema>;
+/** Emit a Zod schema snippet (guidance) from an {@link InferredSchema}. */
+declare function zodSourceFor(schema: InferredSchema): string;
+
 /**
  * **@noy-db/as-xlsx** — Excel spreadsheet plaintext export for noy-db.
  *
@@ -244,6 +268,45 @@ interface AsXlsxSheetOptions {
      * global LANG cell via `VLOOKUP(code, …, MATCH(LANG, …))`.
      */
     readonly dictFields?: Record<string, string>;
+    /**
+     * Multi-vault export only: pull FK-referenced fields from a supporting vault
+     * into this sheet as extra columns. Each entry resolves `localField` on the
+     * primary record against the `keyField` of another vault's collection (matched
+     * by `from.label`/`from.collection`), and emits the `pick` field value as
+     * `column`. Appended AFTER the declared `columns` in declaration order.
+     * Unresolved FK (row not in the supporting-vault index) → empty cell.
+     * Ignored by single-vault `toBytes`.
+     */
+    readonly denormalize?: readonly MultiVaultDenormColumn[];
+}
+/**
+ * One denormalized column in a multi-vault export: pulls a field from a
+ * supporting vault into the primary sheet via an in-memory join.
+ *
+ * @example
+ * ```ts
+ * {
+ *   column: 'entityName',   // new column header in the primary sheet
+ *   localField: 'entityId', // FK field on the primary record
+ *   from: { label: 'directory', collection: 'entities', keyField: 'id', pick: 'name' },
+ * }
+ * ```
+ */
+interface MultiVaultDenormColumn {
+    /** Header of the new column to append to the primary sheet. */
+    readonly column: string;
+    /** Field on the primary record whose value is the FK. */
+    readonly localField: string;
+    readonly from: {
+        /** Label of the supporting vault entry (matches `MultiVaultXlsxEntry.label`). */
+        readonly label: string;
+        /** Collection in the supporting vault. */
+        readonly collection: string;
+        /** Field in the supporting record that is the join key (usually `'id'`). */
+        readonly keyField: string;
+        /** Field in the supporting record to copy as the denorm value. */
+        readonly pick: string;
+    };
 }
 /** One aggregate column in a smart-mode summary sheet (#414 P3). */
 interface AsXlsxSummaryAggregate {
@@ -274,6 +337,13 @@ interface AsXlsxOptions {
     readonly sheets: readonly AsXlsxSheetOptions[];
     /** Smart mode only: groupBy summary sheets (live SUMIFS/COUNTIFS/AVERAGEIFS). */
     readonly summaries?: readonly AsXlsxSummarySpec[];
+    /**
+     * Smart mode only: summary formula dialect. `'excel'` (default) emits
+     * cross-compatible per-row SUMIFS/COUNTIFS/AVERAGEIFS. `'sheets'` emits a
+     * single Google-Sheets `QUERY` formula per summary — **Sheets-only** (QUERY
+     * errors in Excel); use when the target is Google Sheets.
+     */
+    readonly dialect?: 'excel' | 'sheets';
     /**
      * Smart-workbook mode (#414). Emits a relational workbook instead of a flat
      * dump:
@@ -320,6 +390,61 @@ declare function download(vault: Vault, options: AsXlsxDownloadOptions): Promise
  * plaintext xlsx persists past the process (Tier 3 egress).
  */
 declare function write(vault: Vault, path: string, options: AsXlsxWriteOptions): Promise<void>;
+/**
+ * One vault entry in a multi-vault export. Supplies the pre-opened
+ * vault, the sheet specs to render for it, and an optional closure
+ * (per-collection id allowlist computed externally by the orchestrator).
+ */
+interface MultiVaultXlsxEntry {
+    readonly vault: Vault;
+    readonly sheets: readonly AsXlsxSheetOptions[];
+    /**
+     * Optional per-collection id allowlist (e.g. from walkCrossVaultClosure).
+     * When set, only rows whose `id` appears in the set are exported for that
+     * collection. Omit to export all rows.
+     */
+    readonly closure?: ReadonlyMap<string, ReadonlySet<string>>;
+    /**
+     * Optional display label for sheet-name prefixing.
+     * Defaults to `vault.name`.
+     */
+    readonly label?: string;
+}
+/** Options for {@link toBytesMultiVault}. */
+interface MultiVaultXlsxOptions {
+    /**
+     * Separator inserted between the vault label and the sheet name when
+     * building tab names. Default `'_'`. Names are then truncated to 31 chars
+     * (Excel limit) by `writeXlsx`.
+     */
+    readonly sheetSeparator?: string;
+}
+/**
+ * Build an `.xlsx` byte stream spanning **multiple vaults**. Each entry
+ * supplies a pre-opened vault with its sheet specs and an optional
+ * per-collection id-closure (rows filtered to exactly those ids). A
+ * `_manifest` sheet is prepended that lists every vault-collection pair
+ * and its exported record count.
+ *
+ * ## Auth
+ * Every vault in `entries` must independently hold `assertCanExport('plaintext','xlsx')`.
+ * The check fires fail-fast before any rows are materialised.
+ *
+ * ## Architecture
+ * This function is **edge-pure** — it takes pre-opened vaults and a
+ * pre-computed closure; it performs no cross-vault FK walk itself.
+ * Cross-vault orchestration lives in `@klum-db/lobby` (allowed direction).
+ *
+ * ## Two-pass execution (when `denormalize` is declared)
+ * **Pass 1** — load and closure-filter ALL entries' rows, building a
+ * `Map<"${label}/${collection}", Map<keyValue, row>>` index keyed by each
+ * sheet's `keyField` (default `'id'`). Only closure-filtered rows are indexed,
+ * so an FK pointing outside the closure yields an empty cell (correct: that
+ * row was not referenced / not exported).
+ * **Pass 2** — emit each sheet; for sheets with `denormalize`, append each
+ * denorm column AFTER the declared columns by resolving the index lookup.
+ */
+declare function toBytesMultiVault(entries: readonly MultiVaultXlsxEntry[], options?: MultiVaultXlsxOptions): Promise<Uint8Array>;
 
 type ImportPolicy = 'merge' | 'replace' | 'insert-only';
 /**
@@ -372,6 +497,14 @@ interface AsXlsxImportOptions {
      * Unknown labels (no match in any locale) pass through as-is.
      */
     readonly dicts?: Readonly<Record<string, readonly DictEntry[]>>;
+    /**
+     * Read a sheet produced by smart export (#414 P4). Reverses the smart layout:
+     * reconstructs i18n fields from their per-locale columns (`<f>__<loc>` →
+     * `{ loc: value }`), and drops derived columns — the i18n display column and
+     * every `<f>__label` (FK/dict) formula column. Code columns (the real values)
+     * pass through. Maps onto the existing collection schema (Mode A).
+     */
+    readonly smart?: boolean;
 }
 interface AsXlsxImportPlan {
     readonly plan: VaultDiff;
@@ -402,4 +535,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 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 };
+export { type AsXlsxDownloadOptions, type AsXlsxImportOptions, type AsXlsxImportPlan, type AsXlsxOptions, type AsXlsxSheetOptions, type AsXlsxSummaryAggregate, type AsXlsxSummarySpec, type AsXlsxWriteOptions, type ImportPolicy, type InferredCollection, type InferredField, type InferredSchema, type InferredType, type MultiVaultDenormColumn, type MultiVaultXlsxEntry, type MultiVaultXlsxOptions, type ReadXlsxResult, type ReadXlsxRow, type ReadXlsxSheet, XlsxDictAmbiguityError, type XlsxFormulaCell, type XlsxRow, type XlsxSheet, type XlsxStyledCell, type XlsxValidation, colLetter, download, formula, fromBytes, inferSchema, readXlsx, styled, toBytes, toBytesFromCollection, toBytesMultiVault, write, writeXlsx, zodSourceFor };

package/dist/index.d.ts

@@ -154,6 +154,30 @@ interface ReadXlsxResult {
  */
 declare function readXlsx(bytes: Uint8Array): Promise<ReadXlsxResult>;
 
+type InferredType = 'string' | 'number' | 'boolean' | 'date';
+interface InferredField {
+    readonly type: InferredType;
+    /** Target collection (sheet) name when this field looks like a foreign key. */
+    readonly references?: string;
+}
+interface InferredCollection {
+    readonly idField: string;
+    readonly fields: Record<string, InferredField>;
+}
+interface InferredSchema {
+    readonly collections: Record<string, InferredCollection>;
+}
+/**
+ * Infer a {@link InferredSchema} from an `.xlsx` byte stream. Sheets whose name
+ * starts with `_` (our smart-export meta sheets) are skipped; pass `skipSheets`
+ * to exclude more (e.g. summary sheets).
+ */
+declare function inferSchema(bytes: Uint8Array, options?: {
+    skipSheets?: readonly string[];
+}): Promise<InferredSchema>;
+/** Emit a Zod schema snippet (guidance) from an {@link InferredSchema}. */
+declare function zodSourceFor(schema: InferredSchema): string;
+
 /**
  * **@noy-db/as-xlsx** — Excel spreadsheet plaintext export for noy-db.
  *
@@ -244,6 +268,45 @@ interface AsXlsxSheetOptions {
      * global LANG cell via `VLOOKUP(code, …, MATCH(LANG, …))`.
      */
     readonly dictFields?: Record<string, string>;
+    /**
+     * Multi-vault export only: pull FK-referenced fields from a supporting vault
+     * into this sheet as extra columns. Each entry resolves `localField` on the
+     * primary record against the `keyField` of another vault's collection (matched
+     * by `from.label`/`from.collection`), and emits the `pick` field value as
+     * `column`. Appended AFTER the declared `columns` in declaration order.
+     * Unresolved FK (row not in the supporting-vault index) → empty cell.
+     * Ignored by single-vault `toBytes`.
+     */
+    readonly denormalize?: readonly MultiVaultDenormColumn[];
+}
+/**
+ * One denormalized column in a multi-vault export: pulls a field from a
+ * supporting vault into the primary sheet via an in-memory join.
+ *
+ * @example
+ * ```ts
+ * {
+ *   column: 'entityName',   // new column header in the primary sheet
+ *   localField: 'entityId', // FK field on the primary record
+ *   from: { label: 'directory', collection: 'entities', keyField: 'id', pick: 'name' },
+ * }
+ * ```
+ */
+interface MultiVaultDenormColumn {
+    /** Header of the new column to append to the primary sheet. */
+    readonly column: string;
+    /** Field on the primary record whose value is the FK. */
+    readonly localField: string;
+    readonly from: {
+        /** Label of the supporting vault entry (matches `MultiVaultXlsxEntry.label`). */
+        readonly label: string;
+        /** Collection in the supporting vault. */
+        readonly collection: string;
+        /** Field in the supporting record that is the join key (usually `'id'`). */
+        readonly keyField: string;
+        /** Field in the supporting record to copy as the denorm value. */
+        readonly pick: string;
+    };
 }
 /** One aggregate column in a smart-mode summary sheet (#414 P3). */
 interface AsXlsxSummaryAggregate {
@@ -274,6 +337,13 @@ interface AsXlsxOptions {
     readonly sheets: readonly AsXlsxSheetOptions[];
     /** Smart mode only: groupBy summary sheets (live SUMIFS/COUNTIFS/AVERAGEIFS). */
     readonly summaries?: readonly AsXlsxSummarySpec[];
+    /**
+     * Smart mode only: summary formula dialect. `'excel'` (default) emits
+     * cross-compatible per-row SUMIFS/COUNTIFS/AVERAGEIFS. `'sheets'` emits a
+     * single Google-Sheets `QUERY` formula per summary — **Sheets-only** (QUERY
+     * errors in Excel); use when the target is Google Sheets.
+     */
+    readonly dialect?: 'excel' | 'sheets';
     /**
      * Smart-workbook mode (#414). Emits a relational workbook instead of a flat
      * dump:
@@ -320,6 +390,61 @@ declare function download(vault: Vault, options: AsXlsxDownloadOptions): Promise
  * plaintext xlsx persists past the process (Tier 3 egress).
  */
 declare function write(vault: Vault, path: string, options: AsXlsxWriteOptions): Promise<void>;
+/**
+ * One vault entry in a multi-vault export. Supplies the pre-opened
+ * vault, the sheet specs to render for it, and an optional closure
+ * (per-collection id allowlist computed externally by the orchestrator).
+ */
+interface MultiVaultXlsxEntry {
+    readonly vault: Vault;
+    readonly sheets: readonly AsXlsxSheetOptions[];
+    /**
+     * Optional per-collection id allowlist (e.g. from walkCrossVaultClosure).
+     * When set, only rows whose `id` appears in the set are exported for that
+     * collection. Omit to export all rows.
+     */
+    readonly closure?: ReadonlyMap<string, ReadonlySet<string>>;
+    /**
+     * Optional display label for sheet-name prefixing.
+     * Defaults to `vault.name`.
+     */
+    readonly label?: string;
+}
+/** Options for {@link toBytesMultiVault}. */
+interface MultiVaultXlsxOptions {
+    /**
+     * Separator inserted between the vault label and the sheet name when
+     * building tab names. Default `'_'`. Names are then truncated to 31 chars
+     * (Excel limit) by `writeXlsx`.
+     */
+    readonly sheetSeparator?: string;
+}
+/**
+ * Build an `.xlsx` byte stream spanning **multiple vaults**. Each entry
+ * supplies a pre-opened vault with its sheet specs and an optional
+ * per-collection id-closure (rows filtered to exactly those ids). A
+ * `_manifest` sheet is prepended that lists every vault-collection pair
+ * and its exported record count.
+ *
+ * ## Auth
+ * Every vault in `entries` must independently hold `assertCanExport('plaintext','xlsx')`.
+ * The check fires fail-fast before any rows are materialised.
+ *
+ * ## Architecture
+ * This function is **edge-pure** — it takes pre-opened vaults and a
+ * pre-computed closure; it performs no cross-vault FK walk itself.
+ * Cross-vault orchestration lives in `@klum-db/lobby` (allowed direction).
+ *
+ * ## Two-pass execution (when `denormalize` is declared)
+ * **Pass 1** — load and closure-filter ALL entries' rows, building a
+ * `Map<"${label}/${collection}", Map<keyValue, row>>` index keyed by each
+ * sheet's `keyField` (default `'id'`). Only closure-filtered rows are indexed,
+ * so an FK pointing outside the closure yields an empty cell (correct: that
+ * row was not referenced / not exported).
+ * **Pass 2** — emit each sheet; for sheets with `denormalize`, append each
+ * denorm column AFTER the declared columns by resolving the index lookup.
+ */
+declare function toBytesMultiVault(entries: readonly MultiVaultXlsxEntry[], options?: MultiVaultXlsxOptions): Promise<Uint8Array>;
 
 type ImportPolicy = 'merge' | 'replace' | 'insert-only';
 /**
@@ -372,6 +497,14 @@ interface AsXlsxImportOptions {
      * Unknown labels (no match in any locale) pass through as-is.
      */
     readonly dicts?: Readonly<Record<string, readonly DictEntry[]>>;
+    /**
+     * Read a sheet produced by smart export (#414 P4). Reverses the smart layout:
+     * reconstructs i18n fields from their per-locale columns (`<f>__<loc>` →
+     * `{ loc: value }`), and drops derived columns — the i18n display column and
+     * every `<f>__label` (FK/dict) formula column. Code columns (the real values)
+     * pass through. Maps onto the existing collection schema (Mode A).
+     */
+    readonly smart?: boolean;
 }
 interface AsXlsxImportPlan {
     readonly plan: VaultDiff;
@@ -402,4 +535,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 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 };
+export { type AsXlsxDownloadOptions, type AsXlsxImportOptions, type AsXlsxImportPlan, type AsXlsxOptions, type AsXlsxSheetOptions, type AsXlsxSummaryAggregate, type AsXlsxSummarySpec, type AsXlsxWriteOptions, type ImportPolicy, type InferredCollection, type InferredField, type InferredSchema, type InferredType, type MultiVaultDenormColumn, type MultiVaultXlsxEntry, type MultiVaultXlsxOptions, type ReadXlsxResult, type ReadXlsxRow, type ReadXlsxSheet, XlsxDictAmbiguityError, type XlsxFormulaCell, type XlsxRow, type XlsxSheet, type XlsxStyledCell, type XlsxValidation, colLetter, download, formula, fromBytes, inferSchema, readXlsx, styled, toBytes, toBytesFromCollection, toBytesMultiVault, write, writeXlsx, zodSourceFor };

package/dist/index.js

@@ -419,6 +419,92 @@ function stringAttr(raw) {
   return "";
 }
 
+// src/infer.ts
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}([T ]\d{2}:\d{2})?/;
+function inferType(vals) {
+  if (vals.length === 0) return "string";
+  if (vals.every((v) => typeof v === "boolean")) return "boolean";
+  if (vals.every((v) => typeof v === "number")) return "number";
+  if (vals.every((v) => typeof v === "string" && ISO_DATE.test(v))) return "date";
+  return "string";
+}
+async function inferSchema(bytes, options = {}) {
+  const skip = new Set(options.skipSheets ?? []);
+  const decoded = await readXlsx(bytes);
+  const sheets = [];
+  for (const sh of decoded.sheets) {
+    if (sh.name.startsWith("_") || skip.has(sh.name)) continue;
+    const headerRow = sh.rows[0] ?? {};
+    const colToField = /* @__PURE__ */ new Map();
+    const fields = [];
+    for (const [letter, val] of Object.entries(headerRow)) {
+      const name = typeof val === "string" ? val.trim() : typeof val === "number" || typeof val === "boolean" ? String(val) : "";
+      if (!name) continue;
+      colToField.set(letter, name);
+      fields.push(name);
+    }
+    const records = sh.rows.slice(1).map((row) => {
+      const rec = {};
+      for (const [letter, val] of Object.entries(row)) {
+        const f = colToField.get(letter);
+        if (f !== void 0) rec[f] = val;
+      }
+      return rec;
+    });
+    sheets.push({ name: sh.name, fields, records });
+  }
+  const valuesOf = (s, f) => s.records.map((r) => r[f]).filter((v) => v != null && v !== "");
+  const idFieldOf = (s) => {
+    if (s.fields.includes("id")) return "id";
+    for (const f of s.fields) {
+      const vals = valuesOf(s, f);
+      if (vals.length > 0 && new Set(vals.map((v) => String(v))).size === vals.length) return f;
+    }
+    return s.fields[0] ?? "id";
+  };
+  const meta = sheets.map((s) => ({ s, idField: idFieldOf(s) }));
+  const idValuesByName = /* @__PURE__ */ new Map();
+  for (const { s, idField } of meta) {
+    idValuesByName.set(s.name, new Set(valuesOf(s, idField).map((v) => String(v))));
+  }
+  const collections = {};
+  for (const { s, idField } of meta) {
+    const fields = {};
+    for (const f of s.fields) {
+      const vals = valuesOf(s, f);
+      const type = inferType(vals);
+      let references;
+      if (f !== idField && type === "string" && vals.length > 0) {
+        const distinct = new Set(vals.map((v) => String(v)));
+        for (const { s: other } of meta) {
+          if (other.name === s.name) continue;
+          const ids = idValuesByName.get(other.name);
+          if (ids && ids.size > 0 && [...distinct].every((v) => ids.has(v))) {
+            references = other.name;
+            break;
+          }
+        }
+      }
+      fields[f] = references ? { type, references } : { type };
+    }
+    collections[s.name] = { idField, fields };
+  }
+  return { collections };
+}
+function zodSourceFor(schema) {
+  const zType = (t) => t === "number" ? "z.number()" : t === "boolean" ? "z.boolean()" : t === "date" ? "z.string().datetime()" : "z.string()";
+  const blocks = [`import { z } from 'zod'`];
+  for (const [name, c] of Object.entries(schema.collections)) {
+    const lines = Object.entries(c.fields).map(
+      ([f, d]) => `  ${f}: ${zType(d.type)},${d.references ? ` // \u2192 ${d.references}` : ""}`
+    );
+    blocks.push(`export const ${name}Schema = z.object({
+${lines.join("\n")}
+})`);
+  }
+  return blocks.join("\n\n");
+}
+
 // src/index.ts
 import { diffVault } from "@noy-db/hub";
 async function toBytesFromCollection(vault, collectionName) {
@@ -478,6 +564,95 @@ async function write(vault, path, options) {
   const { writeFile } = await import("fs/promises");
   await writeFile(path, bytes);
 }
+async function toBytesMultiVault(entries, options = {}) {
+  const sep = options.sheetSeparator ?? "_";
+  for (const entry of entries) {
+    entry.vault.assertCanExport("plaintext", "xlsx");
+  }
+  const loaded = [];
+  const denormIndex = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const prefix = entry.label ?? entry.vault.name;
+    for (const s of entry.sheets) {
+      const all = await entry.vault.collection(s.collection).list();
+      const records = [];
+      for (const item of all) {
+        const r = item;
+        const allow = entry.closure?.get(s.collection);
+        if (allow && !allow.has(String(r.id))) continue;
+        if (s.filter && !s.filter(r)) continue;
+        records.push(r);
+      }
+      loaded.push({ entry, prefix, sheetOpt: s, records });
+      const indexKey = `${prefix}/${s.collection}`;
+      const collectionIndex = denormIndex.get(indexKey) ?? /* @__PURE__ */ new Map();
+      denormIndex.set(indexKey, collectionIndex);
+      for (const r of records) {
+        const idVal = r.id;
+        if (idVal != null) collectionIndex.set(safeStringify(idVal), r);
+      }
+    }
+  }
+  for (const ls of loaded) {
+    for (const d of ls.sheetOpt.denormalize ?? []) {
+      if (d.from.keyField === "id") continue;
+      const indexKey = `${d.from.label}/${d.from.collection}`;
+      const idx = denormIndex.get(indexKey);
+      if (!idx) continue;
+      const srcLoaded = loaded.find(
+        (l) => l.prefix === d.from.label && l.sheetOpt.collection === d.from.collection
+      );
+      if (!srcLoaded) continue;
+      for (const r of srcLoaded.records) {
+        const kv = r[d.from.keyField];
+        if (kv != null) idx.set(safeStringify(kv), r);
+      }
+    }
+  }
+  const allSheets = [];
+  const manifestRows = [];
+  for (const { prefix, sheetOpt: s, records } of loaded) {
+    const baseColumns = s.columns ?? inferColumns(records);
+    const denormDefs = s.denormalize ?? [];
+    if (denormDefs.length === 0) {
+      const sheetName2 = `${prefix}${sep}${s.name}`;
+      allSheets.push(buildFlatSheet(sheetName2, baseColumns, records));
+      manifestRows.push([prefix, s.collection, records.length]);
+      continue;
+    }
+    const allColumns = [...baseColumns, ...denormDefs.map((d) => d.column)];
+    const sheetName = `${prefix}${sep}${s.name}`;
+    const rows = records.map((r) => {
+      const baseCells = baseColumns.map((c) => r[c] ?? null);
+      const denormCells = denormDefs.map((d) => {
+        const idxKey = `${d.from.label}/${d.from.collection}`;
+        const idx = denormIndex.get(idxKey);
+        if (!idx) return "";
+        const fkVal = r[d.localField];
+        if (fkVal == null) return "";
+        const supporting = idx.get(safeStringify(fkVal));
+        if (!supporting) return "";
+        return supporting[d.from.pick] ?? "";
+      });
+      return [...baseCells, ...denormCells];
+    });
+    allSheets.push({ name: sheetName, header: allColumns, rows });
+    manifestRows.push([prefix, s.collection, records.length]);
+  }
+  allSheets.unshift({
+    name: "_manifest",
+    header: ["Vault", "Collection", "Records"],
+    rows: manifestRows
+  });
+  return writeXlsx(allSheets);
+}
+function buildFlatSheet(name, columns, records) {
+  return {
+    name,
+    header: [...columns],
+    rows: records.map((r) => columns.map((c) => r[c] ?? null))
+  };
+}
 function safeStringify(v) {
   if (typeof v === "string") return v;
   if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);
@@ -636,6 +811,7 @@ async function buildSmartSheets(vault, options) {
       return [m.opt.name, m.records.length, Object.entries(refs).map(([f, r]) => `${f}\u2192${r.target}`).join(", ")];
     })
   };
+  const dialect = options.dialect ?? "excel";
   const summarySheets = [];
   for (const spec of options.summaries ?? []) {
     const src = sheetMeta.get(spec.from);
@@ -643,6 +819,26 @@ async function buildSmartSheets(vault, options) {
     const gCol = src?.colIndex.get(spec.groupBy);
     if (!src || !srcMat || gCol === void 0) continue;
     const gLetter = colLetter(gCol);
+    if (dialect === "sheets") {
+      const selects = [];
+      const labels = [];
+      for (const a of spec.aggregates) {
+        if (a.op === "count") {
+          selects.push(`COUNT(${gLetter})`);
+          labels.push(`COUNT(${gLetter}) '${a.label}'`);
+          continue;
+        }
+        const vIdx = a.field ? src.colIndex.get(a.field) : void 0;
+        if (vIdx === void 0) continue;
+        const vL = colLetter(vIdx);
+        const fn = a.op === "sum" ? "SUM" : "AVG";
+        selects.push(`${fn}(${vL})`);
+        labels.push(`${fn}(${vL}) '${a.label}'`);
+      }
+      const q = `QUERY('${src.name}'!A:ZZ, "SELECT ${gLetter}, ${selects.join(", ")} GROUP BY ${gLetter} LABEL ${labels.join(", ")}", 1)`;
+      summarySheets.push({ name: spec.name, rows: [[formula(q)]] });
+      continue;
+    }
     const seen = /* @__PURE__ */ new Set();
     const groups = [];
     for (const r of srcMat.records) {
@@ -772,6 +968,13 @@ async function fromBytes(vault, bytes, options) {
     } catch {
     }
   }
+  const i18nBases = /* @__PURE__ */ new Set();
+  if (options.smart) {
+    for (const field of colToField.values()) {
+      const m = /^(.+)__(.+)$/.exec(field);
+      if (m && m[2] !== "label") i18nBases.add(m[1]);
+    }
+  }
   const records = [];
   for (let i = headerRowIdx + 1; i < allRows.length; i++) {
     const row = allRows[i];
@@ -780,6 +983,22 @@ async function fromBytes(vault, bytes, options) {
     for (const [col, value] of Object.entries(row)) {
       const field = colToField.get(col);
       if (field === void 0) continue;
+      if (options.smart) {
+        if (field.endsWith("__label")) continue;
+        const lm = /^(.+)__(.+)$/.exec(field);
+        if (lm && lm[2] !== "label" && i18nBases.has(lm[1])) {
+          const base = lm[1];
+          const coerced2 = coerceXlsxCell(value, types[base]);
+          if (coerced2 !== void 0 && coerced2 !== "") {
+            const map = record[base] ?? {};
+            map[lm[2]] = coerced2;
+            record[base] = map;
+            hasAny = true;
+          }
+          continue;
+        }
+        if (i18nBases.has(field)) continue;
+      }
       const coerced = coerceXlsxCell(value, types[field]);
       if (coerced !== void 0) {
         const invMap = invertMaps.get(field);
@@ -888,11 +1107,14 @@ export {
   download,
   formula,
   fromBytes,
+  inferSchema,
   readXlsx,
   styled,
   toBytes,
   toBytesFromCollection,
+  toBytesMultiVault,
   write,
-  writeXlsx
+  writeXlsx,
+  zodSourceFor
 };
 //# sourceMappingURL=index.js.map