@mog-sdk/node 0.1.9-beta.2 → 0.1.9

package/dist/index.js

@@ -527,9 +527,7 @@ function getPlatformPackageName() {
   }
   const pkg = platformMap[process.arch];
   if (!pkg) {
-    throw new Error(
-      `Unsupported architecture ${process.arch} on ${process.platform}`
-    );
+    throw new Error(`Unsupported architecture ${process.arch} on ${process.platform}`);
   }
   return pkg;
 }
@@ -652,14 +650,14 @@ function deepSnakeToCamel(obj) {
   }
   return obj;
 }
-function createNapiTransport(engine, serdeParams) {
+function createNapiTransport(engine, serdeParams, addon) {
   return {
     async call(command, args) {
-      const fn = engine[command];
+      const fn = engine[command] ?? addon?.[snakeToCamel(command)];
       if (!fn) {
         throw new TransportError(
           command,
-          `Method "${command}" not found on napi engine. The compute-core-napi binary is likely out of date \u2014 rebuild with: cd compute-core-napi && npm run build`
+          `Method "${command}" not found on napi engine${addon ? " or addon module" : ""}. The compute-core-napi binary is likely out of date \u2014 rebuild with: cd compute-core-napi && npm run build`
         );
       }
       try {
@@ -687,7 +685,8 @@ function createNapiTransport(engine, serdeParams) {
           }
           return value;
         });
-        const result = fn.call(engine, ...positionalArgs);
+        const isEngineFn = !!engine[command];
+        const result = fn.call(isEngineFn ? engine : addon, ...positionalArgs);
         if (typeof result === "string") {
           try {
             return deepSnakeToCamel(JSON.parse(result));
@@ -719,7 +718,7 @@ function createLazyNapiTransport(addon) {
       if (command === "compute_init") {
         const snapshotJson = typeof args.snapshot === "string" ? args.snapshot : JSON.stringify(args.snapshot);
         const engine = new addon.ComputeEngine(snapshotJson);
-        innerTransport = createNapiTransport(engine, DEFAULT_NAPI_SERDE_PARAMS);
+        innerTransport = createNapiTransport(engine, DEFAULT_NAPI_SERDE_PARAMS, addon);
         const initResultJson = engine.compute_take_init_result?.();
         if (initResultJson) {
           return deepSnakeToCamel(JSON.parse(initResultJson));
@@ -6635,6 +6634,9 @@ var init_compute_bridge_gen = __esm({
       pivotGetAll(sheetId) {
         return this.core.query(this.core.transport.call("compute_pivot_get_all", { docId: this.core.docId, sheetId }));
       }
+      pivotComputeFromSource(sheetId, pivotId, expansionState) {
+        return this.core.query(this.core.transport.call("compute_pivot_compute_from_source", { docId: this.core.docId, sheetId, pivotId, expansionState }));
+      }
       pivotRegisterDef(sheetId, pivotId, totalRows, totalCols, firstDataRow, firstDataCol) {
         return this.core.mutatePlain(this.core.transport.call("compute_pivot_register_def", { docId: this.core.docId, sheetId, pivotId, totalRows, totalCols, firstDataRow, firstDataCol }));
       }
@@ -7004,7 +7006,9 @@ var init_compute_bridge = __esm({
             parentId: options?.parentId ?? null
           }
         );
-        const tuple = normalizeBytesTuple(raw);
+        const tuple = normalizeBytesTuple(
+          raw
+        );
         const result = await this.core.mutate(Promise.resolve(tuple));
         const comment = extractMutationData(result);
         if (!comment) {
@@ -7111,14 +7115,9 @@ var init_compute_bridge = __esm({
       // ===========================================================================
       /** Get protection options for a sheet. Returns per-operation permissions when protected. */
       async getSheetProtectionOptions(sheetId) {
-        const config = await this.core.query(
-          this.core.transport.call("compute_get_sheet_protection_config", {
-            docId: this.core.docId,
-            sheetId
-          })
-        );
-        if (!config.isProtected) return null;
-        return DEFAULT_PROTECTION_OPTIONS;
+        const settings = await this.getSheetSettings(sheetId);
+        if (!settings.isProtected) return null;
+        return { ...DEFAULT_PROTECTION_OPTIONS, ...settings.protectionOptions };
       }
       /** Set multiple sheet settings at once (iterates entries). */
       async setSheetSettings(sheetId, updates) {
@@ -7158,7 +7157,8 @@ var init_compute_bridge = __esm({
         const tuples = edits.map(
           (e) => [sheetId, e.row, e.col, e.input]
         );
-        return this.batchSetCellsByPosition(tuples, false);
+        const result = await this.batchSetCellsByPosition(tuples, false);
+        return result;
       }
       /** Patch workbook settings — reads current, merges partial, writes full. */
       async patchWorkbookSettings(settings) {
@@ -7838,35 +7838,6 @@ function letterToCol(letters) {
   }
   return result - 1;
 }
-function parseA1(address) {
-  const match = address.match(/^([A-Za-z]+)(\d+)$/);
-  if (!match) {
-    throw new Error(`Invalid cell address: ${address}`);
-  }
-  return {
-    row: parseInt(match[2], 10) - 1,
-    col: letterToCol(match[1])
-  };
-}
-function parseA1Range(range2) {
-  const [start, end] = range2.split(":");
-  const startPos = parseA1(start);
-  if (!end) {
-    return {
-      startRow: startPos.row,
-      startCol: startPos.col,
-      endRow: startPos.row,
-      endCol: startPos.col
-    };
-  }
-  const endPos = parseA1(end);
-  return {
-    startRow: Math.min(startPos.row, endPos.row),
-    startCol: Math.min(startPos.col, endPos.col),
-    endRow: Math.max(startPos.row, endPos.row),
-    endCol: Math.max(startPos.col, endPos.col)
-  };
-}
 function toA1(row, col) {
   return `${colToLetter2(col)}${row + 1}`;
 }
@@ -7988,13 +7959,13 @@ async function getChartDataRange(ctx, chart) {
   const sheetId = chart.sheetId;
   if (!sheetId) {
     if (!chart.dataRange) return null;
-    return parseA1Range(chart.dataRange);
+    return parseCellRange(chart.dataRange);
   }
   if (chart.dataRangeIdentity) {
     return resolveCellIdRange(ctx, sheetId, chart.dataRangeIdentity);
   }
   if (!chart.dataRange) return null;
-  return parseA1Range(chart.dataRange);
+  return parseCellRange(chart.dataRange);
 }
 async function getMaxZIndex(ctx, sheetId) {
   const charts = await getAll2(ctx, sheetId);
@@ -9136,7 +9107,11 @@ var init_statistics = __esm({
 
 // ../../charts/src/core/data-extractor.ts
 function parseRange(range2) {
-  return parseA1Range(range2);
+  const parsed = parseCellRange(range2);
+  if (!parsed) {
+    throw new Error(`Invalid cell range: ${range2}`);
+  }
+  return parsed;
 }
 function toNumber(value) {
   if (value === null || value === void 0 || value === "") {
@@ -15786,6 +15761,26 @@ var init_cell_properties = __esm({
   }
 });
 
+// ../../kernel/src/api/internal/value-conversions.ts
+function viewportCellValueToCellValue(cv) {
+  return cv;
+}
+function viewportCellValueToString(cv) {
+  if (cv === null || cv === void 0) return "";
+  if (typeof cv === "string") return cv;
+  if (typeof cv === "number") return String(cv);
+  if (typeof cv === "boolean") return cv ? "TRUE" : "FALSE";
+  if (isCellError(cv)) return errorDisplayString(cv.value);
+  return "";
+}
+var init_value_conversions = __esm({
+  "../../kernel/src/api/internal/value-conversions.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_errors3();
+  }
+});
+
 // ../../kernel/src/domain/drawing/ink/ink-tool-defaults.ts
 function getDefaultToolSettings(tool) {
   return {
@@ -25149,8 +25144,7 @@ var init_pivot_bridge = __esm({
   "../../kernel/src/bridges/pivot-bridge.ts"() {
     "use strict";
     init_esm_shims();
-    init_rich_text();
-    init_cell_reads();
+    init_value_conversions();
     init_sheet_meta();
     init_compute_core();
     PivotBridge = class {
@@ -25256,30 +25250,22 @@ var init_pivot_bridge = __esm({
        * Uses cached result if available and valid.
        */
       async compute(sheetId, pivotId, forceRefresh = false) {
-        const config = await this.ctx.computeBridge.pivotGet(sheetId, pivotId);
-        if (!config) {
-          return null;
-        }
         const configVersion = this.getConfigVersion(pivotId);
-        const dataVersion = this.getDataVersion(config.sourceSheetId);
+        const dataVersion = this.getDataVersion(sheetId);
         if (!forceRefresh) {
           const cached = this.cache.get(pivotId);
           if (cached && cached.configVersion === configVersion && cached.dataVersion === dataVersion) {
             return cached.result;
           }
         }
-        const data = await this.getSourceData(config);
-        if (!data) {
-          return null;
-        }
         const expansionState = this.ctx.pivotExpansionProvider?.getExpansionState(pivotId) ?? {
           expandedRows: {},
           expandedColumns: {}
         };
         try {
-          const result = await this.ctx.computeBridge.pivotCompute(
-            config,
-            data,
+          const result = await this.ctx.computeBridge.pivotComputeFromSource(
+            sheetId,
+            pivotId,
             expansionState ?? null
           );
           this.cache.set(pivotId, {
@@ -25451,23 +25437,26 @@ var init_pivot_bridge = __esm({
       }
       /**
        * Get data from a cell range.
-       * Uses Cells domain module instead of SpreadsheetStore
+       * Uses queryRange for bulk cell reading (works in all modes including headless/NAPI).
        */
       async getDataFromRange(sheetId, range2) {
+        const rangeResult = await this.ctx.computeBridge.queryRange(
+          sheetId,
+          range2.startRow,
+          range2.startCol,
+          range2.endRow,
+          range2.endCol
+        );
+        const cellMap = /* @__PURE__ */ new Map();
+        for (const cell of rangeResult.cells) {
+          cellMap.set(`${cell.row},${cell.col}`, cell);
+        }
         const data = [];
         for (let row = range2.startRow; row <= range2.endRow; row++) {
           const rowData = [];
           for (let col = range2.startCol; col <= range2.endCol; col++) {
-            const cellData = await getData(this.ctx, sheetId, row, col);
-            let value;
-            if (!cellData) {
-              value = null;
-            } else if (cellData.formula !== void 0) {
-              value = cellData.computed ?? null;
-            } else {
-              value = cellData.raw !== void 0 ? rawToCellValue(cellData.raw) : null;
-            }
-            rowData.push(value);
+            const cell = cellMap.get(`${row},${col}`);
+            rowData.push(cell ? viewportCellValueToCellValue(cell.value) ?? null : null);
           }
           data.push(rowData);
         }
@@ -76396,7 +76385,7 @@ var init_document_lifecycle_system = __esm({
             await databaseBridge.initialize();
           } catch (err2) {
             const msg = err2 instanceof Error ? err2.message : String(err2);
-            if (msg.includes("Unknown WASM function") || msg.includes("compute_init must be called before")) {
+            if (msg.includes("Unknown WASM function") || msg.includes("compute_init must be called before") || msg.includes("not found")) {
               console.debug(
                 "[DocumentLifecycleSystem] DatabaseBridge unavailable in this environment \u2014 database features disabled."
               );
@@ -77753,7 +77742,8 @@ var WorkbookNamesImpl = class {
         if (typeof cell === "boolean") return "Boolean" /* Boolean */;
         if (typeof cell === "number") return "Double" /* Double */;
         if (typeof cell === "string") return "String" /* String */;
-        if (typeof cell === "object" && cell !== null && "type" in cell) return "Error" /* Error */;
+        if (typeof cell === "object" && cell !== null && "type" in cell)
+          return "Error" /* Error */;
         return "String" /* String */;
       })
     );
@@ -79133,20 +79123,8 @@ function analyzeStylePatterns(cells) {
   return lines;
 }
 
-// ../../kernel/src/api/internal/value-conversions.ts
-init_esm_shims();
-init_errors3();
-function viewportCellValueToCellValue(cv) {
-  return cv;
-}
-function viewportCellValueToString(cv) {
-  if (cv === null || cv === void 0) return "";
-  if (typeof cv === "string") return cv;
-  if (typeof cv === "number") return String(cv);
-  if (typeof cv === "boolean") return cv ? "TRUE" : "FALSE";
-  if (isCellError(cv)) return errorDisplayString(cv.value);
-  return "";
-}
+// ../../kernel/src/api/worksheet/worksheet-impl.ts
+init_value_conversions();
 
 // ../../kernel/src/api/worksheet/operations/cell-operations.ts
 init_esm_shims();
@@ -79205,18 +79183,27 @@ async function setCell(ctx, sheetId, row, col, value) {
     throw KernelError.from(null, "COMPUTE_ERROR", `Invalid cell address: row=${row}, col=${col}`);
   }
   const input = value === null || value === void 0 ? "" : value === "" ? "\0" : String(value);
-  await ctx.computeBridge.setCellsByPosition(sheetId, [{ row, col, input }]);
-}
-async function batchSetCells(ctx, sheetId, updates) {
-  if (updates.length === 0) return;
-  const edits = updates.map(
-    ({ row, col, value }) => ({
-      row,
-      col,
-      input: typeof value === "string" && value.startsWith("=") ? value : value === null || value === void 0 ? "" : value === "" ? "\0" : String(value)
-    })
-  );
+  const result = await ctx.computeBridge.setCellsByPosition(sheetId, [{ row, col, input }]);
+}
+async function setCells(ctx, sheetId, cells) {
+  if (cells.length === 0) return { cellsWritten: 0 };
+  const edits = cells.map((cell) => {
+    let row;
+    let col;
+    if ("addr" in cell && typeof cell.addr === "string") {
+      const resolved = resolveCell(cell.addr);
+      row = resolved.row;
+      col = resolved.col;
+    } else {
+      row = cell.row;
+      col = cell.col;
+    }
+    const { value } = cell;
+    const input = typeof value === "string" && value.startsWith("=") ? value : value === null || value === void 0 ? "" : value === "" ? "\0" : String(value);
+    return { row, col, input };
+  });
   await ctx.computeBridge.setCellsByPosition(sheetId, edits);
+  return { cellsWritten: edits.length };
 }
 async function setDateValue(ctx, sheetId, row, col, year, month, day) {
   const cellId = await ctx.computeBridge.getCellIdAt(sheetId, row, col);
@@ -79254,13 +79241,6 @@ async function setTimeValue(ctx, sheetId, row, col, hours, minutes, seconds) {
     });
   }
 }
-async function batchSetFormulas(ctx, sheetId, updates) {
-  if (updates.length === 0) return;
-  const edits = updates.map(
-    ({ row, col, formula }) => ({ row, col, input: formula })
-  );
-  await ctx.computeBridge.setCellsByPosition(sheetId, edits);
-}
 async function relocateCells(ctx, sheetId, srcStartRow, srcStartCol, srcEndRow, srcEndCol, targetRow, targetCol) {
   await ctx.computeBridge.relocateCells(
     sheetId,
@@ -79631,6 +79611,7 @@ async function getMergeAt(ctx, sheetId, row, col) {
 // ../../kernel/src/api/worksheet/operations/query-operations.ts
 init_esm_shims();
 init_a1();
+init_value_conversions();
 async function getUsedRange2(ctx, sheetId) {
   const bounds = await ctx.computeBridge.getDataBounds(sheetId);
   if (!bounds) return null;
@@ -79761,6 +79742,7 @@ async function getRangeWithIdentity(ctx, sheetId, startRow, startCol, endRow, en
 // ../../kernel/src/api/worksheet/operations/range-operations.ts
 init_esm_shims();
 init_errors();
+init_value_conversions();
 async function getRange(ctx, sheetId, range2) {
   const normalized = normalizeRange(range2);
   const rangeResult = await ctx.computeBridge.queryRange(
@@ -79795,6 +79777,30 @@ async function getRange(ctx, sheetId, range2) {
   }
   return result;
 }
+async function getRangeFormulas(ctx, sheetId, range2) {
+  const normalized = normalizeRange(range2);
+  const rangeResult = await ctx.computeBridge.queryRange(
+    sheetId,
+    normalized.startRow,
+    normalized.startCol,
+    normalized.endRow,
+    normalized.endCol
+  );
+  const cellMap = /* @__PURE__ */ new Map();
+  for (const cell of rangeResult.cells) {
+    cellMap.set(`${cell.row},${cell.col}`, cell);
+  }
+  const result = [];
+  for (let row = normalized.startRow; row <= normalized.endRow; row++) {
+    const rowData = [];
+    for (let col = normalized.startCol; col <= normalized.endCol; col++) {
+      const cell = cellMap.get(`${row},${col}`);
+      rowData.push(cell?.formula ?? null);
+    }
+    result.push(rowData);
+  }
+  return result;
+}
 async function setRange(ctx, sheetId, startRow, startCol, values) {
   if (!isValidAddress(startRow, startCol)) {
     throw KernelError.from(
@@ -79862,6 +79868,7 @@ async function clearRange2(ctx, sheetId, range2) {
 // ../../kernel/src/api/worksheet/operations/range-query-operations.ts
 init_esm_shims();
 init_a1();
+init_value_conversions();
 async function clearWithMode(ctx, sheetId, range2, applyTo = "all") {
   const n = normalizeRange(range2);
   const promises = [];
@@ -80933,7 +80940,7 @@ function chartConfigToInternal(config) {
     visible: true,
     printable: true,
     opacity: 1,
-    name: config.title ?? "",
+    name: config.name ?? "",
     createdAt: now,
     updatedAt: now,
     // FloatingObjectData discriminator
@@ -81101,7 +81108,9 @@ var WorksheetChartsImpl = class _WorksheetChartsImpl {
   // ===========================================================================
   async add(config) {
     if (!config.type) throw invalidChartConfig("type is required");
-    if (!config.dataRange) throw invalidChartConfig("dataRange is required");
+    const hasSeriesValues = config.series?.some((s) => s.values);
+    if (!config.dataRange && !hasSeriesValues)
+      throw invalidChartConfig("dataRange is required when series[].values are not provided");
     const chartId = config.id || `chart-${Date.now()}-${_WorksheetChartsImpl._idCounter++}`;
     const configWithId = { ...config, id: chartId };
     const internalConfig = chartConfigToInternal(configWithId);
@@ -82198,16 +82207,22 @@ var WorksheetFormatsImpl = class {
     const current = await this.get(row, col);
     const currentIndent = current?.indent ?? 0;
     const newIndent = Math.max(0, Math.min(250, currentIndent + amount));
-    await this.ctx.computeBridge.setFormatForRanges(this.sheetId, [[row, col, row, col]], { indent: newIndent });
+    await this.ctx.computeBridge.setFormatForRanges(this.sheetId, [[row, col, row, col]], {
+      indent: newIndent
+    });
   }
   async clearFill(a, b) {
     const { row, col } = resolveCell(a, b);
-    await this.ctx.computeBridge.setFormatForRanges(this.sheetId, [[row, col, row, col]], {
-      backgroundColor: "",
-      patternType: "none",
-      patternForegroundColor: "",
-      gradientFill: void 0
-    });
+    const rangeTuple = [row, col, row, col];
+    const current = await this.get(row, col);
+    await this.ctx.computeBridge.clearFormatForRanges(this.sheetId, [rangeTuple]);
+    if (current) {
+      const { backgroundColor, patternType, patternForegroundColor, gradientFill, ...rest } = current;
+      const hasRest = Object.keys(rest).length > 0;
+      if (hasRest) {
+        await this.ctx.computeBridge.setFormatForRanges(this.sheetId, [rangeTuple], rest);
+      }
+    }
   }
   async getNumberFormatCategory(a, b) {
     const { row, col } = resolveCell(a, b);
@@ -82646,14 +82661,20 @@ var WorksheetNamesImpl = class {
   async remove(name) {
     const defined = await getByName(this.ctx, name, this.sheetId);
     if (!defined) {
-      throw new KernelError("COMPUTE_ERROR", `Named range "${name}" not found in this sheet's scope.`);
+      throw new KernelError(
+        "COMPUTE_ERROR",
+        `Named range "${name}" not found in this sheet's scope.`
+      );
     }
     await remove(this.ctx, defined.id, "api");
   }
   async update(name, updates) {
     const defined = await getByName(this.ctx, name, this.sheetId);
     if (!defined) {
-      throw new KernelError("COMPUTE_ERROR", `Named range "${name}" not found in this sheet's scope.`);
+      throw new KernelError(
+        "COMPUTE_ERROR",
+        `Named range "${name}" not found in this sheet's scope.`
+      );
     }
     const refersToA1 = updates.reference ? updates.reference.startsWith("=") ? updates.reference : `=${updates.reference}` : void 0;
     await update2(
@@ -83053,12 +83074,21 @@ var WorksheetPivotsImpl = class _WorksheetPivotsImpl {
         );
       }
     }
-    return pivots.map((p) => ({
-      name: p.name ?? p.id,
-      dataSource: formatDataSource(sheetNameCache.get(p.sourceSheetId) ?? null, p.sourceRange),
-      contentArea: "",
-      filterArea: void 0
-    }));
+    return pivots.map((p) => {
+      const apiConfig = dataConfigToApiConfig(p, sheetNameCache.get(p.sourceSheetId) ?? null);
+      const location = p.outputLocation ? toA1(p.outputLocation.row, p.outputLocation.col) : void 0;
+      return {
+        name: p.name ?? p.id,
+        dataSource: apiConfig.dataSource,
+        contentArea: "",
+        filterArea: void 0,
+        location,
+        rowFields: apiConfig.rowFields,
+        columnFields: apiConfig.columnFields,
+        valueFields: apiConfig.valueFields,
+        filterFields: apiConfig.filterFields
+      };
+    });
   }
   async get(name) {
     const pivot = await this.findPivotByName(name);
@@ -83209,6 +83239,99 @@ var WorksheetPivotsImpl = class _WorksheetPivotsImpl {
   async getDrillDownData(pivotId, rowKey, columnKey) {
     return await this.ctx.pivot.getDrillDownData(this.sheetId, pivotId, rowKey, columnKey);
   }
+  async queryPivot(pivotName, filters) {
+    const pivot = await this.findPivotByName(pivotName);
+    if (!pivot) return null;
+    const pivotId = pivot.id ?? pivot.name;
+    const result = await this.ctx.pivot.compute(this.sheetId, pivotId);
+    if (!result) return null;
+    const fieldNameById = /* @__PURE__ */ new Map();
+    for (const f of pivot.fields) {
+      fieldNameById.set(f.id, f.name);
+    }
+    const rowPlacements = pivot.placements.filter((p) => p.area === "row").sort((a, b) => a.position - b.position);
+    const colPlacements = pivot.placements.filter((p) => p.area === "column").sort((a, b) => a.position - b.position);
+    const valuePlacements = pivot.placements.filter((p) => p.area === "value").sort((a, b) => a.position - b.position);
+    const rowFieldNames = rowPlacements.map((p) => fieldNameById.get(p.fieldId) ?? p.fieldId);
+    const colFieldNames = colPlacements.map((p) => fieldNameById.get(p.fieldId) ?? p.fieldId);
+    const valueFieldLabels = valuePlacements.map((p) => {
+      if (p.displayName) return p.displayName;
+      const name = fieldNameById.get(p.fieldId) ?? p.fieldId;
+      const agg = p.aggregateFunction ?? "sum";
+      return `${agg.charAt(0).toUpperCase() + agg.slice(1)} of ${name}`;
+    });
+    const numDataCols = result.rows.length > 0 ? result.rows[0].values.length : 0;
+    const colDimensionTuples = [];
+    if (colPlacements.length > 0 && result.columnHeaders.length > 0) {
+      for (let i = 0; i < numDataCols; i++) {
+        colDimensionTuples.push({});
+      }
+      for (const level of result.columnHeaders) {
+        const fieldName = fieldNameById.get(level.fieldId) ?? level.fieldId;
+        let colIndex = 0;
+        for (const header of level.headers) {
+          if (!header.isSubtotal && !header.isGrandTotal) {
+            for (let s = 0; s < header.span; s++) {
+              if (colIndex + s < numDataCols) {
+                colDimensionTuples[colIndex + s][fieldName] = header.value;
+              }
+            }
+          }
+          colIndex += header.span;
+        }
+      }
+    }
+    const records = [];
+    for (const row of result.rows) {
+      if (row.isSubtotal || row.isGrandTotal) continue;
+      const rowDimensions = {};
+      for (const header of row.headers) {
+        if (header.isSubtotal || header.isGrandTotal) continue;
+        const fieldName = fieldNameById.get(header.fieldId) ?? header.fieldId;
+        rowDimensions[fieldName] = header.value;
+      }
+      if (colDimensionTuples.length > 0) {
+        for (let colIdx = 0; colIdx < colDimensionTuples.length; colIdx++) {
+          const colDims = colDimensionTuples[colIdx];
+          if (!colDims || Object.keys(colDims).length === 0) continue;
+          const dimensions = { ...rowDimensions, ...colDims };
+          const values = {};
+          if (valuePlacements.length <= 1) {
+            values[valueFieldLabels[0] ?? "Value"] = row.values[colIdx] ?? null;
+          } else {
+            const valueIndex = colIdx % valuePlacements.length;
+            values[valueFieldLabels[valueIndex] ?? "Value"] = row.values[colIdx] ?? null;
+          }
+          records.push({ dimensions, values });
+        }
+      } else {
+        const values = {};
+        for (let i = 0; i < valuePlacements.length; i++) {
+          values[valueFieldLabels[i] ?? `Value${i}`] = row.values[i] ?? null;
+        }
+        records.push({ dimensions: rowDimensions, values });
+      }
+    }
+    const filteredRecords = filters ? records.filter((record) => {
+      for (const [field, filterValue] of Object.entries(filters)) {
+        const dimValue = record.dimensions[field];
+        if (Array.isArray(filterValue)) {
+          if (!filterValue.some((fv) => String(fv) === String(dimValue))) return false;
+        } else {
+          if (String(filterValue) !== String(dimValue)) return false;
+        }
+      }
+      return true;
+    }) : records;
+    return {
+      pivotName,
+      rowFields: rowFieldNames,
+      columnFields: colFieldNames,
+      valueFields: valueFieldLabels,
+      records: filteredRecords,
+      sourceRowCount: result.sourceRowCount
+    };
+  }
   // ===========================================================================
   // Expansion State (delegated to PivotExpansionStateProvider)
   // ===========================================================================
@@ -83594,12 +83717,18 @@ async function setPrintArea(ctx, sheetId, area) {
   try {
     const rangeParts = area.split(":");
     if (rangeParts.length !== 2) {
-      return { success: false, error: operationFailed("setPrintArea", `Invalid range format: ${area}`) };
+      return {
+        success: false,
+        error: operationFailed("setPrintArea", `Invalid range format: ${area}`)
+      };
     }
     const start = parseCellRef2(rangeParts[0]);
     const end = parseCellRef2(rangeParts[1]);
     if (!start || !end) {
-      return { success: false, error: operationFailed("setPrintArea", `Invalid cell reference in range: ${area}`) };
+      return {
+        success: false,
+        error: operationFailed("setPrintArea", `Invalid cell reference in range: ${area}`)
+      };
     }
     const printRange = {
       startRow: start.row,
@@ -83810,10 +83939,10 @@ var WorksheetProtectionImpl = class {
     };
   }
   async getSelectionMode() {
-    const options = await this.ctx.computeBridge.getSheetProtectionOptions(this.sheetId);
-    if (!options) return "normal";
-    const selectLocked = options.selectLockedCells ?? true;
-    const selectUnlocked = options.selectUnlockedCells ?? true;
+    const settings = await this.ctx.computeBridge.getSheetSettings(this.sheetId);
+    const opts = settings.protectionOptions;
+    const selectLocked = opts?.selectLockedCells ?? true;
+    const selectUnlocked = opts?.selectUnlockedCells ?? true;
     if (selectLocked && selectUnlocked) return "normal";
     if (!selectLocked && selectUnlocked) return "unlockedOnly";
     return "none";
@@ -83855,11 +83984,15 @@ var WorksheetSettingsImpl = class {
     );
   }
   async getStandardHeight() {
-    const settings = await this.ctx.computeBridge.getSheetSettings(this.sheetId);
+    const settings = await this.ctx.computeBridge.getSheetSettings(
+      this.sheetId
+    );
     return settings.defaultRowHeight;
   }
   async getStandardWidth() {
-    const settings = await this.ctx.computeBridge.getSheetSettings(this.sheetId);
+    const settings = await this.ctx.computeBridge.getSheetSettings(
+      this.sheetId
+    );
     return settings.defaultColWidth;
   }
   async setStandardWidth(width) {
@@ -83937,9 +84070,7 @@ var WorksheetSlicersImpl = class {
     const columnName = stored.source.columnCellId;
     let absCol = -1;
     if (table.columns.length > 0) {
-      const colIndex = table.columns.findIndex(
-        (c) => c.name === columnName || c.id === columnName
-      );
+      const colIndex = table.columns.findIndex((c) => c.name === columnName || c.id === columnName);
       if (colIndex >= 0) absCol = table.range.startCol + colIndex;
     }
     if (absCol < 0 && table.hasHeaderRow) {
@@ -83976,9 +84107,7 @@ var WorksheetSlicersImpl = class {
       const cell = cellsJson.find((c) => c.row === r);
       columnData.push(extractCellValue2(cell?.value));
     }
-    const selectedSet = new Set(
-      stored.selectedValues.map((v) => String(v ?? ""))
-    );
+    const selectedSet = new Set(stored.selectedValues.map((v) => String(v ?? "")));
     const hasSelection = selectedSet.size > 0 && !(selectedSet.size === 1 && selectedSet.has(""));
     const valueCounts = /* @__PURE__ */ new Map();
     for (const v of columnData) {
@@ -84660,7 +84789,7 @@ init_errors();
 
 // ../../kernel/src/api/worksheet/operations/table-operations.ts
 init_esm_shims();
-function parseA1Range2(range2) {
+function parseA1Range(range2) {
   const match = range2.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
   if (!match) return null;
   return {
@@ -84698,7 +84827,7 @@ function bridgeTableToTableInfo(table) {
   };
 }
 function getTableColumnDataCellsFromInfo(table, colIndex) {
-  const parsed = parseA1Range2(table.range);
+  const parsed = parseA1Range(table.range);
   if (!parsed) return [];
   const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
   const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
@@ -84712,7 +84841,7 @@ function getTableColumnDataCellsFromInfo(table, colIndex) {
   return cells;
 }
 function getDataBodyRangeFromInfo(table) {
-  const parsed = parseA1Range2(table.range);
+  const parsed = parseA1Range(table.range);
   if (!parsed) return null;
   const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
   const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
@@ -84723,7 +84852,7 @@ function getDataBodyRangeFromInfo(table) {
 }
 function getHeaderRowRangeFromInfo(table) {
   if (!table.hasHeaders) return null;
-  const parsed = parseA1Range2(table.range);
+  const parsed = parseA1Range(table.range);
   if (!parsed) return null;
   const startLetter = colToLetter2(parsed.startCol);
   const endLetter = colToLetter2(parsed.endCol);
@@ -84732,7 +84861,7 @@ function getHeaderRowRangeFromInfo(table) {
 }
 function getTotalRowRangeFromInfo(table) {
   if (!table.showTotals) return null;
-  const parsed = parseA1Range2(table.range);
+  const parsed = parseA1Range(table.range);
   if (!parsed) return null;
   const startLetter = colToLetter2(parsed.startCol);
   const endLetter = colToLetter2(parsed.endCol);
@@ -84979,16 +85108,13 @@ var WorksheetTablesImpl = class {
   // Row CRUD
   // ---------------------------------------------------------------------------
   async addRow(tableName, index, values) {
-    const result = await this.ctx.computeBridge.addTableDataRow(
-      tableName,
-      index ?? null
-    );
+    const result = await this.ctx.computeBridge.addTableDataRow(tableName, index ?? null);
     const insertRow = typeof result.data === "number" ? result.data : parseInt(result.data, 10);
     insertRows(this.ctx, this.sheetId, null, insertRow, 1, "api");
     if (values && values.length > 0) {
       const table = await this.get(tableName);
       if (!table) return;
-      const parsed = parseA1Range3(table.range);
+      const parsed = parseA1Range2(table.range);
       if (!parsed) return;
       const edits = values.map((val, i) => ({
         row: insertRow,
@@ -85006,7 +85132,7 @@ var WorksheetTablesImpl = class {
   async getRowCount(tableName) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return 0;
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
@@ -85015,7 +85141,7 @@ var WorksheetTablesImpl = class {
   async getRowRange(tableName, index) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid table range: ${table.range}`);
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const absRow = dataStartRow + index;
@@ -85026,23 +85152,16 @@ var WorksheetTablesImpl = class {
   async getRowValues(tableName, index) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return [];
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const absRow = dataStartRow + index;
-    const values = await this.ctx.computeBridge.getCellsInRange(
-      this.sheetId,
-      absRow,
-      parsed.startCol,
-      absRow,
-      parsed.endCol
-    );
-    return values;
+    return queryRangeValues(this.ctx, this.sheetId, absRow, parsed.startCol, absRow, parsed.endCol);
   }
   async setRowValues(tableName, index, values) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return;
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const absRow = dataStartRow + index;
@@ -85059,7 +85178,7 @@ var WorksheetTablesImpl = class {
   async getColumnDataBodyRange(tableName, columnIndex) {
     const table = await this.get(tableName);
     if (!table) return null;
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
@@ -85072,7 +85191,7 @@ var WorksheetTablesImpl = class {
   async getColumnHeaderRange(tableName, columnIndex) {
     const table = await this.get(tableName);
     if (!table || !table.hasHeaders) return null;
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
@@ -85083,7 +85202,7 @@ var WorksheetTablesImpl = class {
   async getColumnRange(tableName, columnIndex) {
     const table = await this.get(tableName);
     if (!table) return null;
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
@@ -85093,7 +85212,7 @@ var WorksheetTablesImpl = class {
   async getColumnTotalRange(tableName, columnIndex) {
     const table = await this.get(tableName);
     if (!table || !table.showTotals) return null;
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
@@ -85104,26 +85223,19 @@ var WorksheetTablesImpl = class {
   async getColumnValues(tableName, columnIndex) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return [];
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return [];
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
     if (dataStartRow > dataEndRow) return [];
-    const values = await this.ctx.computeBridge.getCellsInRange(
-      this.sheetId,
-      dataStartRow,
-      col,
-      dataEndRow,
-      col
-    );
-    return values;
+    return queryRangeValues(this.ctx, this.sheetId, dataStartRow, col, dataEndRow, col);
   }
   async setColumnValues(tableName, columnIndex, values) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return;
@@ -85141,25 +85253,30 @@ var WorksheetTablesImpl = class {
   async sortApply(tableName, fields) {
     const table = await this.get(tableName);
     if (!table) throw new KernelError("COMPUTE_ERROR", `Table not found: ${tableName}`);
-    const parsed = parseA1Range3(table.range);
+    const parsed = parseA1Range2(table.range);
     if (!parsed) return;
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
     if (dataStartRow > dataEndRow) return;
     const numCols = parsed.endCol - parsed.startCol + 1;
     const numRows = dataEndRow - dataStartRow + 1;
-    const rawValues = await this.ctx.computeBridge.getCellsInRange(
+    const rangeResult = await this.ctx.computeBridge.queryRange(
       this.sheetId,
       dataStartRow,
       parsed.startCol,
       dataEndRow,
       parsed.endCol
     );
+    const cellMap = /* @__PURE__ */ new Map();
+    for (const cell of rangeResult.cells) {
+      cellMap.set(`${cell.row},${cell.col}`, cell);
+    }
     const rows = [];
     for (let r = 0; r < numRows; r++) {
       const row = [];
       for (let c = 0; c < numCols; c++) {
-        row.push(rawValues[r * numCols + c] ?? "");
+        const cell = cellMap.get(`${dataStartRow + r},${parsed.startCol + c}`);
+        row.push(cell?.value ?? null);
       }
       rows.push(row);
     }
@@ -85185,10 +85302,11 @@ var WorksheetTablesImpl = class {
     for (let r = 0; r < numRows; r++) {
       const srcRow = rows[indices[r]];
       for (let c = 0; c < numCols; c++) {
+        const val = srcRow[c];
         edits.push({
           row: dataStartRow + r,
           col: parsed.startCol + c,
-          input: srcRow[c]
+          input: val == null ? "" : String(val)
         });
       }
     }
@@ -85204,7 +85322,7 @@ function letterToCol2(letters) {
   }
   return col - 1;
 }
-function parseA1Range3(range2) {
+function parseA1Range2(range2) {
   const match = range2.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
   if (!match) return null;
   return {
@@ -85214,6 +85332,27 @@ function parseA1Range3(range2) {
     endRow: parseInt(match[4], 10) - 1
   };
 }
+async function queryRangeValues(ctx, sheetId, startRow, startCol, endRow, endCol) {
+  const rangeResult = await ctx.computeBridge.queryRange(
+    sheetId,
+    startRow,
+    startCol,
+    endRow,
+    endCol
+  );
+  const cellMap = /* @__PURE__ */ new Map();
+  for (const cell of rangeResult.cells) {
+    cellMap.set(`${cell.row},${cell.col}`, cell);
+  }
+  const values = [];
+  for (let r = startRow; r <= endRow; r++) {
+    for (let c = startCol; c <= endCol; c++) {
+      const cell = cellMap.get(`${r},${c}`);
+      values.push(cell?.value ?? null);
+    }
+  }
+  return values;
+}
 
 // ../../kernel/src/api/worksheet/validation.ts
 init_esm_shims();
@@ -87649,6 +87788,16 @@ var WorksheetImpl = class {
     const formula = await getFormula(this.ctx, this.sheetId, row, col);
     return formula ?? null;
   }
+  async getFormulas(range2) {
+    const bounds = resolveRange(range2);
+    return getRangeFormulas(this.ctx, this.sheetId, {
+      sheetId: this.sheetId,
+      startRow: bounds.startRow,
+      startCol: bounds.startCol,
+      endRow: bounds.endRow,
+      endCol: bounds.endCol
+    });
+  }
   // ===========================================================================
   // Bulk reads
   // ===========================================================================
@@ -87724,13 +87873,10 @@ var WorksheetImpl = class {
     const { row, col } = resolveCell(address);
     const data = await getCell(this.ctx, this.sheetId, row, col);
     if (!data) return "";
-    const displayValue = await getDisplayValue2(this.ctx, this.sheetId, row, col);
-    let result = displayValue;
+    const rawValue = viewportCellValueToString(data.value);
+    let result = rawValue;
     if (data.formula) {
-      result = displayValue !== "" ? `${displayValue}(${data.formula})` : `(${data.formula})`;
-    }
-    if (data.value === 0 && displayValue !== "0" && displayValue !== "") {
-      result = `${result} [0]`;
+      result = rawValue !== "" ? `${rawValue}(${data.formula})` : `(${data.formula})`;
     }
     const styleHintsStr = await getStyleHints(this.ctx, this.sheetId, row, col);
     if (styleHintsStr) {
@@ -87792,8 +87938,8 @@ var WorksheetImpl = class {
           rowValues.push(`${cellAddr}:`);
           continue;
         }
-        const displayValue = vc.formatted ?? viewportCellValueToString(vc.value);
-        let cellStr = displayValue;
+        const rawValue = viewportCellValueToString(vc.value);
+        let cellStr = rawValue;
         hasContent = true;
         if (vc.formula) {
           const abbreviation = formulaAnalysis.formulaToId.get(`${row},${col}`);
@@ -87803,10 +87949,6 @@ var WorksheetImpl = class {
             cellStr = `${cellStr}(=${vc.formula})`;
           }
         }
-        const cellValue = viewportCellValueToCellValue(vc.value);
-        if (cellValue === 0 && displayValue !== "0" && displayValue !== "") {
-          cellStr = `${cellStr} [0]`;
-        }
         rowValues.push(`${cellAddr}:${cellStr}`);
       }
       if (hasContent) {
@@ -87963,12 +88105,12 @@ var WorksheetImpl = class {
         cells.sort((a, b) => a.col - b.col);
         const rowData = [];
         for (const vc of cells) {
-          const displayValue = vc.formatted ?? viewportCellValueToString(vc.value);
+          const rawValue = viewportCellValueToString(vc.value);
           const addr = toA1(vc.row, vc.col);
           if (vc.formula) {
-            rowData.push(`${addr}:${displayValue}(=${vc.formula})`);
+            rowData.push(`${addr}:${rawValue}(=${vc.formula})`);
           } else {
-            rowData.push(`${addr}:${displayValue}`);
+            rowData.push(`${addr}:${rawValue}`);
           }
         }
         if (rowData.length > 0) {
@@ -88018,18 +88160,31 @@ var WorksheetImpl = class {
   async findInRange(range2, text, options) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    return findInRange(this.ctx, this.sheetId, { sheetId: this.sheetId, ...parsed }, text, {
-      caseSensitive: options?.matchCase,
-      wholeCell: options?.entireCell
-    });
+    return findInRange(
+      this.ctx,
+      this.sheetId,
+      { sheetId: this.sheetId, ...parsed },
+      text,
+      {
+        caseSensitive: options?.matchCase,
+        wholeCell: options?.entireCell
+      }
+    );
   }
   async replaceAll(range2, text, replacement, options) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    return replaceAll(this.ctx, this.sheetId, { sheetId: this.sheetId, ...parsed }, text, replacement, {
-      caseSensitive: options?.matchCase,
-      wholeCell: options?.entireCell
-    });
+    return replaceAll(
+      this.ctx,
+      this.sheetId,
+      { sheetId: this.sheetId, ...parsed },
+      text,
+      replacement,
+      {
+        caseSensitive: options?.matchCase,
+        wholeCell: options?.entireCell
+      }
+    );
   }
   async getExtendedRange(range2, direction, activeCell) {
     const parsed = parseCellRange(range2);
@@ -88052,17 +88207,26 @@ var WorksheetImpl = class {
   async getDisplayText(range2) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    return getDisplayText(this.ctx, this.sheetId, { sheetId: this.sheetId, ...parsed });
+    return getDisplayText(this.ctx, this.sheetId, {
+      sheetId: this.sheetId,
+      ...parsed
+    });
   }
   async getValueTypes(range2) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    return getValueTypes(this.ctx, this.sheetId, { sheetId: this.sheetId, ...parsed });
+    return getValueTypes(this.ctx, this.sheetId, {
+      sheetId: this.sheetId,
+      ...parsed
+    });
   }
   async getNumberFormatCategories(range2) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    return getNumberFormatCategories(this.ctx, this.sheetId, { sheetId: this.sheetId, ...parsed });
+    return getNumberFormatCategories(this.ctx, this.sheetId, {
+      sheetId: this.sheetId,
+      ...parsed
+    });
   }
   // ===========================================================================
   // Sort / batch / autofill
@@ -88106,11 +88270,8 @@ var WorksheetImpl = class {
     if (!cellRange) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
     return fillSeries(this.ctx, this.sheetId, cellRange, options);
   }
-  async batchSetCells(updates) {
-    await batchSetCells(this.ctx, this.sheetId, updates);
-  }
-  async batchSetFormulas(updates) {
-    await batchSetFormulas(this.ctx, this.sheetId, updates);
+  async setCells(cells) {
+    return setCells(this.ctx, this.sheetId, cells);
   }
   // ===========================================================================
   // One-liner table creation
@@ -88256,11 +88417,21 @@ var WorksheetImpl = class {
     const sheetId = this.sheetId;
     const targetPos = resolveCell(targetCell);
     const changingPos = resolveCell(changingCell);
-    const formulaCellId = await getCellIdAt2(this.ctx, sheetId, targetPos.row, targetPos.col);
+    const formulaCellId = await getCellIdAt2(
+      this.ctx,
+      sheetId,
+      targetPos.row,
+      targetPos.col
+    );
     if (!formulaCellId) {
       throw new KernelError("COMPUTE_ERROR", `Target cell ${targetCell} has no content.`);
     }
-    const inputCellId = await getCellIdAt2(this.ctx, sheetId, changingPos.row, changingPos.col);
+    const inputCellId = await getCellIdAt2(
+      this.ctx,
+      sheetId,
+      changingPos.row,
+      changingPos.col
+    );
     if (!inputCellId) {
       throw new KernelError("COMPUTE_ERROR", `Changing cell ${changingCell} has no content.`);
     }
@@ -89799,18 +89970,42 @@ var STATISTICAL_FUNCTIONS = [
   ["BETAINV", C.STATISTICAL, "Returns the inverse of the beta distribution (compatibility)", 3, 5],
   ["BINOM.DIST", C.STATISTICAL, "Returns the binomial distribution probability", 4, 4],
   ["BINOM.DIST.RANGE", C.STATISTICAL, "Returns the binomial distribution probability range", 3, 4],
-  ["BINOM.INV", C.STATISTICAL, "Returns the smallest value for which the binomial CDF is >= criterion", 3, 3],
+  [
+    "BINOM.INV",
+    C.STATISTICAL,
+    "Returns the smallest value for which the binomial CDF is >= criterion",
+    3,
+    3
+  ],
   ["BINOMDIST", C.STATISTICAL, "Returns the binomial distribution (compatibility)", 4, 4],
   ["CHIDIST", C.STATISTICAL, "Returns the chi-squared distribution (compatibility)", 2, 2],
-  ["CHIINV", C.STATISTICAL, "Returns the inverse of the chi-squared distribution (compatibility)", 2, 2],
+  [
+    "CHIINV",
+    C.STATISTICAL,
+    "Returns the inverse of the chi-squared distribution (compatibility)",
+    2,
+    2
+  ],
   ["CHISQ.DIST", C.STATISTICAL, "Returns the chi-squared distribution", 3, 3],
   ["CHISQ.DIST.RT", C.STATISTICAL, "Returns the right-tailed chi-squared distribution", 2, 2],
   ["CHISQ.INV", C.STATISTICAL, "Returns the inverse of the chi-squared distribution", 2, 2],
-  ["CHISQ.INV.RT", C.STATISTICAL, "Returns the inverse of the right-tailed chi-squared distribution", 2, 2],
+  [
+    "CHISQ.INV.RT",
+    C.STATISTICAL,
+    "Returns the inverse of the right-tailed chi-squared distribution",
+    2,
+    2
+  ],
   ["CHISQ.TEST", C.STATISTICAL, "Returns the chi-squared test statistic", 2, 2],
   ["CHITEST", C.STATISTICAL, "Returns the chi-squared test (compatibility)", 2, 2],
   ["CONFIDENCE", C.STATISTICAL, "Returns the confidence interval (compatibility)", 3, 3],
-  ["CONFIDENCE.NORM", C.STATISTICAL, "Returns the confidence interval using a normal distribution", 3, 3],
+  [
+    "CONFIDENCE.NORM",
+    C.STATISTICAL,
+    "Returns the confidence interval using a normal distribution",
+    3,
+    3
+  ],
   ["CONFIDENCE.T", C.STATISTICAL, "Returns the confidence interval using a t-distribution", 3, 3],
   ["CORREL", C.STATISTICAL, "Returns the correlation coefficient between two data sets", 2, 2],
   ["COVAR", C.STATISTICAL, "Returns covariance (compatibility)", 2, 2],
@@ -89833,7 +90028,13 @@ var STATISTICAL_FUNCTIONS = [
   ["FORECAST.ETS", C.STATISTICAL, "Returns a forecasted value using exponential smoothing", 3, 7],
   ["FORECAST.ETS.CONFINT", C.STATISTICAL, "Returns a confidence interval for a forecast", 3, 7],
   ["FORECAST.ETS.SEASONALITY", C.STATISTICAL, "Returns the seasonal pattern length", 2, 4],
-  ["FORECAST.ETS.STAT", C.STATISTICAL, "Returns a statistical value for a time series forecast", 3, 7],
+  [
+    "FORECAST.ETS.STAT",
+    C.STATISTICAL,
+    "Returns a statistical value for a time series forecast",
+    3,
+    7
+  ],
   ["FORECAST.LINEAR", C.STATISTICAL, "Returns a value along a linear trend", 3, 3],
   ["FREQUENCY", C.STATISTICAL, "Returns a frequency distribution as a vertical array", 2, 2],
   ["FTEST", C.STATISTICAL, "Returns the F-test (compatibility)", 2, 2],
@@ -89841,10 +90042,22 @@ var STATISTICAL_FUNCTIONS = [
   ["GAMMA.DIST", C.STATISTICAL, "Returns the gamma distribution", 4, 4],
   ["GAMMA.INV", C.STATISTICAL, "Returns the inverse of the gamma distribution", 3, 3],
   ["GAMMADIST", C.STATISTICAL, "Returns the gamma distribution (compatibility)", 4, 4],
-  ["GAMMAINV", C.STATISTICAL, "Returns the inverse of the gamma distribution (compatibility)", 3, 3],
+  [
+    "GAMMAINV",
+    C.STATISTICAL,
+    "Returns the inverse of the gamma distribution (compatibility)",
+    3,
+    3
+  ],
   ["GAMMALN", C.STATISTICAL, "Returns the natural logarithm of the gamma function", 1, 1],
   ["GAMMALN.PRECISE", C.STATISTICAL, "Returns the natural logarithm of the gamma function", 1, 1],
-  ["GAUSS", C.STATISTICAL, "Returns 0.5 less than the standard normal cumulative distribution", 1, 1],
+  [
+    "GAUSS",
+    C.STATISTICAL,
+    "Returns 0.5 less than the standard normal cumulative distribution",
+    1,
+    1
+  ],
   ["GEOMEAN", C.STATISTICAL, "Returns the geometric mean", 1, -1],
   ["GROWTH", C.STATISTICAL, "Returns values along an exponential trend", 1, 4],
   ["HARMEAN", C.STATISTICAL, "Returns the harmonic mean", 1, -1],
@@ -89854,24 +90067,54 @@ var STATISTICAL_FUNCTIONS = [
   ["KURT", C.STATISTICAL, "Returns the kurtosis of a data set", 1, -1],
   ["LINEST", C.STATISTICAL, "Returns the parameters of a linear trend", 1, 4],
   ["LOGEST", C.STATISTICAL, "Returns the parameters of an exponential trend", 1, 4],
-  ["LOGINV", C.STATISTICAL, "Returns the inverse of the lognormal distribution (compatibility)", 3, 3],
+  [
+    "LOGINV",
+    C.STATISTICAL,
+    "Returns the inverse of the lognormal distribution (compatibility)",
+    3,
+    3
+  ],
   ["LOGNORM.DIST", C.STATISTICAL, "Returns the lognormal distribution", 4, 4],
   ["LOGNORM.INV", C.STATISTICAL, "Returns the inverse of the lognormal distribution", 3, 3],
   ["LOGNORMDIST", C.STATISTICAL, "Returns the lognormal distribution (compatibility)", 3, 3],
   ["MAXA", C.STATISTICAL, "Returns the maximum value including text and logical values", 1, -1],
   ["MINA", C.STATISTICAL, "Returns the minimum value including text and logical values", 1, -1],
   ["MODE", C.STATISTICAL, "Returns the most common value (compatibility)", 1, -1],
-  ["MODE.MULT", C.STATISTICAL, "Returns a vertical array of the most frequently occurring values", 1, -1],
+  [
+    "MODE.MULT",
+    C.STATISTICAL,
+    "Returns a vertical array of the most frequently occurring values",
+    1,
+    -1
+  ],
   ["NEGBINOM.DIST", C.STATISTICAL, "Returns the negative binomial distribution", 4, 4],
-  ["NEGBINOMDIST", C.STATISTICAL, "Returns the negative binomial distribution (compatibility)", 3, 3],
+  [
+    "NEGBINOMDIST",
+    C.STATISTICAL,
+    "Returns the negative binomial distribution (compatibility)",
+    3,
+    3
+  ],
   ["NORM.DIST", C.STATISTICAL, "Returns the normal distribution", 4, 4],
   ["NORM.INV", C.STATISTICAL, "Returns the inverse of the normal distribution", 3, 3],
   ["NORM.S.DIST", C.STATISTICAL, "Returns the standard normal distribution", 2, 2],
   ["NORM.S.INV", C.STATISTICAL, "Returns the inverse of the standard normal distribution", 1, 1],
   ["NORMDIST", C.STATISTICAL, "Returns the normal distribution (compatibility)", 4, 4],
-  ["NORMINV", C.STATISTICAL, "Returns the inverse of the normal distribution (compatibility)", 3, 3],
+  [
+    "NORMINV",
+    C.STATISTICAL,
+    "Returns the inverse of the normal distribution (compatibility)",
+    3,
+    3
+  ],
   ["NORMSDIST", C.STATISTICAL, "Returns the standard normal distribution (compatibility)", 1, 1],
-  ["NORMSINV", C.STATISTICAL, "Returns the inverse of the standard normal distribution (compatibility)", 1, 1],
+  [
+    "NORMSINV",
+    C.STATISTICAL,
+    "Returns the inverse of the standard normal distribution (compatibility)",
+    1,
+    1
+  ],
   ["PEARSON", C.STATISTICAL, "Returns the Pearson product moment correlation coefficient", 2, 2],
   ["PERCENTILE", C.STATISTICAL, "Returns the k-th percentile of values (compatibility)", 2, 2],
   ["PERCENTILE.EXC", C.STATISTICAL, "Returns the k-th percentile (exclusive)", 2, 2],
@@ -89879,7 +90122,13 @@ var STATISTICAL_FUNCTIONS = [
   ["PERCENTRANK", C.STATISTICAL, "Returns the percentage rank (compatibility)", 2, 3],
   ["PERCENTRANK.EXC", C.STATISTICAL, "Returns the percentage rank (exclusive)", 2, 3],
   ["PERCENTRANK.INC", C.STATISTICAL, "Returns the percentage rank (inclusive)", 2, 3],
-  ["PHI", C.STATISTICAL, "Returns the value of the density function for a standard normal distribution", 1, 1],
+  [
+    "PHI",
+    C.STATISTICAL,
+    "Returns the value of the density function for a standard normal distribution",
+    1,
+    1
+  ],
   ["POISSON", C.STATISTICAL, "Returns the Poisson distribution (compatibility)", 3, 3],
   ["POISSON.DIST", C.STATISTICAL, "Returns the Poisson distribution", 3, 3],
   ["PROB", C.STATISTICAL, "Returns the probability of values in a range", 3, 4],
@@ -89897,9 +90146,27 @@ var STATISTICAL_FUNCTIONS = [
   ["STDEV", C.STATISTICAL, "Estimates standard deviation based on a sample (compatibility)", 1, -1],
   ["STDEV.P", C.STATISTICAL, "Calculates standard deviation based on the entire population", 1, -1],
   ["STDEV.S", C.STATISTICAL, "Estimates standard deviation based on a sample", 1, -1],
-  ["STDEVA", C.STATISTICAL, "Estimates standard deviation including text and logical values", 1, -1],
-  ["STDEVP", C.STATISTICAL, "Calculates standard deviation based on the entire population (compatibility)", 1, -1],
-  ["STDEVPA", C.STATISTICAL, "Calculates standard deviation of a population including text and logical values", 1, -1],
+  [
+    "STDEVA",
+    C.STATISTICAL,
+    "Estimates standard deviation including text and logical values",
+    1,
+    -1
+  ],
+  [
+    "STDEVP",
+    C.STATISTICAL,
+    "Calculates standard deviation based on the entire population (compatibility)",
+    1,
+    -1
+  ],
+  [
+    "STDEVPA",
+    C.STATISTICAL,
+    "Calculates standard deviation of a population including text and logical values",
+    1,
+    -1
+  ],
   ["STEYX", C.STATISTICAL, "Returns the standard error of the predicted y-value", 2, 2],
   ["T.DIST", C.STATISTICAL, "Returns the Student t-distribution", 3, 3],
   ["T.DIST.2T", C.STATISTICAL, "Returns the two-tailed Student t-distribution", 2, 2],
@@ -89908,7 +90175,13 @@ var STATISTICAL_FUNCTIONS = [
   ["T.INV.2T", C.STATISTICAL, "Returns the inverse of the two-tailed Student t-distribution", 2, 2],
   ["T.TEST", C.STATISTICAL, "Returns the t-test statistic", 4, 4],
   ["TDIST", C.STATISTICAL, "Returns the Student t-distribution (compatibility)", 3, 3],
-  ["TINV", C.STATISTICAL, "Returns the inverse of the Student t-distribution (compatibility)", 2, 2],
+  [
+    "TINV",
+    C.STATISTICAL,
+    "Returns the inverse of the Student t-distribution (compatibility)",
+    2,
+    2
+  ],
   ["TREND", C.STATISTICAL, "Returns values along a linear trend", 1, 4],
   ["TRIMMEAN", C.STATISTICAL, "Returns the mean of the interior of a data set", 2, 2],
   ["TTEST", C.STATISTICAL, "Returns the t-test (compatibility)", 4, 4],
@@ -89916,8 +90189,20 @@ var STATISTICAL_FUNCTIONS = [
   ["VAR.P", C.STATISTICAL, "Calculates variance based on the entire population", 1, -1],
   ["VAR.S", C.STATISTICAL, "Estimates variance based on a sample", 1, -1],
   ["VARA", C.STATISTICAL, "Estimates variance including text and logical values", 1, -1],
-  ["VARP", C.STATISTICAL, "Calculates variance based on the entire population (compatibility)", 1, -1],
-  ["VARPA", C.STATISTICAL, "Calculates variance of a population including text and logical values", 1, -1],
+  [
+    "VARP",
+    C.STATISTICAL,
+    "Calculates variance based on the entire population (compatibility)",
+    1,
+    -1
+  ],
+  [
+    "VARPA",
+    C.STATISTICAL,
+    "Calculates variance of a population including text and logical values",
+    1,
+    -1
+  ],
   ["WEIBULL", C.STATISTICAL, "Returns the Weibull distribution (compatibility)", 4, 4],
   ["WEIBULL.DIST", C.STATISTICAL, "Returns the Weibull distribution", 4, 4],
   ["Z.TEST", C.STATISTICAL, "Returns the one-tailed P-value of a z-test", 2, 3],
@@ -89925,37 +90210,103 @@ var STATISTICAL_FUNCTIONS = [
 ];
 var DATETIME_FUNCTIONS = [
   ["DATE", C.DATE_TIME, "Returns the serial number of a particular date", 3, 3],
-  ["DATEDIF", C.DATE_TIME, "Calculates the number of days, months, or years between two dates", 3, 3],
+  [
+    "DATEDIF",
+    C.DATE_TIME,
+    "Calculates the number of days, months, or years between two dates",
+    3,
+    3
+  ],
   ["DATEVALUE", C.DATE_TIME, "Converts a date in text format to a serial number", 1, 1],
   ["DAY", C.DATE_TIME, "Converts a serial number to a day of the month", 1, 1],
   ["DAYS", C.DATE_TIME, "Returns the number of days between two dates", 2, 2],
-  ["DAYS360", C.DATE_TIME, "Calculates the number of days between two dates on a 360-day year", 2, 3],
-  ["EDATE", C.DATE_TIME, "Returns the serial number of a date that is a given number of months before or after the start date", 2, 2],
+  [
+    "DAYS360",
+    C.DATE_TIME,
+    "Calculates the number of days between two dates on a 360-day year",
+    2,
+    3
+  ],
+  [
+    "EDATE",
+    C.DATE_TIME,
+    "Returns the serial number of a date that is a given number of months before or after the start date",
+    2,
+    2
+  ],
   ["EOMONTH", C.DATE_TIME, "Returns the serial number of the last day of the month", 2, 2],
   ["HOUR", C.DATE_TIME, "Converts a serial number to an hour", 1, 1],
   ["ISOWEEKNUM", C.DATE_TIME, "Returns the ISO week number of the year", 1, 1],
   ["MINUTE", C.DATE_TIME, "Converts a serial number to a minute", 1, 1],
   ["MONTH", C.DATE_TIME, "Converts a serial number to a month", 1, 1],
   ["NETWORKDAYS", C.DATE_TIME, "Returns the number of whole workdays between two dates", 2, 3],
-  ["NETWORKDAYS.INTL", C.DATE_TIME, "Returns the number of whole workdays between two dates (custom weekends)", 2, 4],
+  [
+    "NETWORKDAYS.INTL",
+    C.DATE_TIME,
+    "Returns the number of whole workdays between two dates (custom weekends)",
+    2,
+    4
+  ],
   ["SECOND", C.DATE_TIME, "Converts a serial number to a second", 1, 1],
   ["TIME", C.DATE_TIME, "Returns the serial number of a particular time", 3, 3],
   ["TIMEVALUE", C.DATE_TIME, "Converts a time in text format to a serial number", 1, 1],
   ["WEEKDAY", C.DATE_TIME, "Converts a serial number to a day of the week", 1, 2],
   ["WEEKNUM", C.DATE_TIME, "Returns the week number of the year", 1, 2],
-  ["WORKDAY", C.DATE_TIME, "Returns a date that is a given number of workdays before or after", 2, 3],
-  ["WORKDAY.INTL", C.DATE_TIME, "Returns a date that is a given number of workdays before or after (custom weekends)", 2, 4],
+  [
+    "WORKDAY",
+    C.DATE_TIME,
+    "Returns a date that is a given number of workdays before or after",
+    2,
+    3
+  ],
+  [
+    "WORKDAY.INTL",
+    C.DATE_TIME,
+    "Returns a date that is a given number of workdays before or after (custom weekends)",
+    2,
+    4
+  ],
   ["YEAR", C.DATE_TIME, "Converts a serial number to a year", 1, 1],
-  ["YEARFRAC", C.DATE_TIME, "Returns the year fraction representing the number of whole days", 2, 3]
+  [
+    "YEARFRAC",
+    C.DATE_TIME,
+    "Returns the year fraction representing the number of whole days",
+    2,
+    3
+  ]
 ];
 var FINANCIAL_FUNCTIONS = [
   ["ACCRINT", C.FINANCIAL, "Returns the accrued interest for a security", 6, 8],
-  ["ACCRINTM", C.FINANCIAL, "Returns the accrued interest for a security that pays at maturity", 3, 5],
+  [
+    "ACCRINTM",
+    C.FINANCIAL,
+    "Returns the accrued interest for a security that pays at maturity",
+    3,
+    5
+  ],
   ["AMORDEGRC", C.FINANCIAL, "Returns the depreciation for each accounting period (French)", 6, 7],
-  ["AMORLINC", C.FINANCIAL, "Returns the depreciation for each accounting period (French, linear)", 6, 7],
-  ["COUPDAYBS", C.FINANCIAL, "Returns the number of days from the beginning of the coupon period", 3, 4],
+  [
+    "AMORLINC",
+    C.FINANCIAL,
+    "Returns the depreciation for each accounting period (French, linear)",
+    6,
+    7
+  ],
+  [
+    "COUPDAYBS",
+    C.FINANCIAL,
+    "Returns the number of days from the beginning of the coupon period",
+    3,
+    4
+  ],
   ["COUPDAYS", C.FINANCIAL, "Returns the number of days in the coupon period", 3, 4],
-  ["COUPDAYSNC", C.FINANCIAL, "Returns the number of days from the settlement date to the next coupon", 3, 4],
+  [
+    "COUPDAYSNC",
+    C.FINANCIAL,
+    "Returns the number of days from the settlement date to the next coupon",
+    3,
+    4
+  ],
   ["COUPNCD", C.FINANCIAL, "Returns the next coupon date after the settlement date", 3, 4],
   ["COUPNUM", C.FINANCIAL, "Returns the number of coupons payable", 3, 4],
   ["COUPPCD", C.FINANCIAL, "Returns the previous coupon date before the settlement date", 3, 4],
@@ -89980,15 +90331,39 @@ var FINANCIAL_FUNCTIONS = [
   ["NOMINAL", C.FINANCIAL, "Returns the annual nominal interest rate", 2, 2],
   ["NPER", C.FINANCIAL, "Returns the number of periods for an investment", 3, 5],
   ["NPV", C.FINANCIAL, "Returns the net present value of an investment", 2, -1],
-  ["PDURATION", C.FINANCIAL, "Returns the number of periods for an investment to reach a value", 3, 3],
+  [
+    "PDURATION",
+    C.FINANCIAL,
+    "Returns the number of periods for an investment to reach a value",
+    3,
+    3
+  ],
   ["PMT", C.FINANCIAL, "Returns the periodic payment for an annuity", 3, 5],
   ["PPMT", C.FINANCIAL, "Returns the payment on the principal", 4, 6],
   ["PRICE", C.FINANCIAL, "Returns the price per $100 face value of a security", 6, 7],
-  ["PRICEDISC", C.FINANCIAL, "Returns the price per $100 face value of a discounted security", 4, 5],
-  ["PRICEMAT", C.FINANCIAL, "Returns the price per $100 face value of a security that pays at maturity", 5, 6],
+  [
+    "PRICEDISC",
+    C.FINANCIAL,
+    "Returns the price per $100 face value of a discounted security",
+    4,
+    5
+  ],
+  [
+    "PRICEMAT",
+    C.FINANCIAL,
+    "Returns the price per $100 face value of a security that pays at maturity",
+    5,
+    6
+  ],
   ["PV", C.FINANCIAL, "Returns the present value of an investment", 3, 5],
   ["RATE", C.FINANCIAL, "Returns the interest rate per period", 3, 6],
-  ["RECEIVED", C.FINANCIAL, "Returns the amount received at maturity for a fully invested security", 4, 5],
+  [
+    "RECEIVED",
+    C.FINANCIAL,
+    "Returns the amount received at maturity for a fully invested security",
+    4,
+    5
+  ],
   ["RRI", C.FINANCIAL, "Returns an equivalent interest rate for growth", 3, 3],
   ["SLN", C.FINANCIAL, "Returns the straight-line depreciation", 3, 3],
   ["SYD", C.FINANCIAL, "Returns the sum-of-years digits depreciation", 4, 4],
@@ -90013,9 +90388,21 @@ var ENGINEERING_FUNCTIONS = [
   ["BITAND", C.ENGINEERING, "Returns a bitwise AND of two numbers", 2, 2],
   ["BITLSHIFT", C.ENGINEERING, "Returns a number shifted left by a specified number of bits", 2, 2],
   ["BITOR", C.ENGINEERING, "Returns a bitwise OR of two numbers", 2, 2],
-  ["BITRSHIFT", C.ENGINEERING, "Returns a number shifted right by a specified number of bits", 2, 2],
+  [
+    "BITRSHIFT",
+    C.ENGINEERING,
+    "Returns a number shifted right by a specified number of bits",
+    2,
+    2
+  ],
   ["BITXOR", C.ENGINEERING, "Returns a bitwise XOR of two numbers", 2, 2],
-  ["COMPLEX", C.ENGINEERING, "Converts real and imaginary coefficients into a complex number", 2, 3],
+  [
+    "COMPLEX",
+    C.ENGINEERING,
+    "Converts real and imaginary coefficients into a complex number",
+    2,
+    3
+  ],
   ["CONVERT", C.ENGINEERING, "Converts a number from one measurement system to another", 3, 3],
   ["DEC2BIN", C.ENGINEERING, "Converts a decimal number to binary", 1, 2],
   ["DEC2HEX", C.ENGINEERING, "Converts a decimal number to hexadecimal", 1, 2],
@@ -91569,6 +91956,14 @@ var api_spec_default = {
             "ask"
           ]
         },
+        getFormulas: {
+          signature: "getFormulas(range: string): Promise<(string | null)[][]>;",
+          docstring: "Get formulas for a range. Returns 2D array: formula string or null per cell.",
+          usedTypes: [],
+          tags: [
+            "ask"
+          ]
+        },
         getRawCellData: {
           signature: "getRawCellData(address: string, includeFormula?: boolean): Promise<RawCellData>;",
           docstring: "Get raw cell data (value, formula, format, borders, etc.) by A1 address.",
@@ -91644,7 +92039,7 @@ var api_spec_default = {
           ]
         },
         findDataEdge: {
-          signature: "findDataEdge(row: number, col: number, direction: 'up' | 'down' | 'left' | 'right'): Promise<{row: number; col: number}>;",
+          signature: "findDataEdge(\n    row: number,\n    col: number,\n    direction: 'up' | 'down' | 'left' | 'right',\n  ): Promise<{ row: number; col: number }>;",
           docstring: "Find the data edge in a direction (Excel's Ctrl+Arrow). Single bridge call to Rust.",
           usedTypes: [],
           tags: [
@@ -91790,18 +92185,12 @@ var api_spec_default = {
             "action"
           ]
         },
-        batchSetCells: {
-          signature: "batchSetCells(updates: Array<{ row: number; col: number; value: any }>): Promise<void>;",
-          docstring: "Batch-write cell values (fire-and-forget to compute engine).\nMore efficient than calling setCell() in a loop \u2014 sends one batch IPC call.",
-          usedTypes: [],
-          tags: [
-            "action"
-          ]
-        },
-        batchSetFormulas: {
-          signature: "batchSetFormulas(updates: Array<{ row: number; col: number; formula: string }>): Promise<void>;",
-          docstring: 'Batch-write cell formulas (fire-and-forget to compute engine).\nEach formula string should start with "=".',
-          usedTypes: [],
+        setCells: {
+          signature: "setCells(cells: Array<{ addr: string; value: any }>): Promise<SetCellsResult>;",
+          docstring: 'Bulk-write scattered cell values and/or formulas in a single IPC call.\nValues starting with "=" are treated as formulas.\n\nSupports both A1 addressing and numeric (row, col) addressing.',
+          usedTypes: [
+            "SetCellsResult"
+          ],
           tags: [
             "action"
           ]
@@ -92012,7 +92401,7 @@ var api_spec_default = {
           ]
         },
         on: {
-          signature: "on(event: 'sheetAdded' | 'sheetRemoved' | 'sheetRenamed' | 'activeSheetChanged', handler: (event: any) => void): () => void;",
+          signature: "on(\n    event: 'sheetAdded' | 'sheetRemoved' | 'sheetRenamed' | 'activeSheetChanged',\n    handler: (event: any) => void,\n  ): () => void;",
           docstring: "Subscribe to sheet collection events.\nFires for: sheetAdded, sheetRemoved, sheetRenamed, activeSheetChanged.\n\n@param event - Event type\n@param handler - Event handler\n@returns Unsubscribe function",
           usedTypes: [],
           tags: [
@@ -94674,7 +95063,7 @@ var api_spec_default = {
           ]
         },
         sortApply: {
-          signature: "sortApply(tableName: string, fields: Array<{ columnIndex: number; ascending?: boolean }>): Promise<void>;",
+          signature: "sortApply(\n    tableName: string,\n    fields: Array<{ columnIndex: number; ascending?: boolean }>,\n  ): Promise<void>;",
           docstring: "Apply sort fields to a table.\n\n@param tableName - Table name\n@param fields - Array of sort field descriptors",
           usedTypes: [],
           tags: [
@@ -94848,6 +95237,17 @@ var api_spec_default = {
             "ask"
           ]
         },
+        queryPivot: {
+          signature: "queryPivot(\n    pivotName: string,\n    filters?: Record<string, CellValue | CellValue[]>,\n  ): Promise<PivotQueryResult | null>;",
+          docstring: "Query a pivot table by name, returning flat records optionally filtered by dimension values.\nEliminates the need to manually traverse hierarchical PivotTableResult trees.\n\n@param pivotName - Pivot table name\n@param filters - Optional dimension filters: field name \u2192 value or array of values to include\n@returns Flat query result, or null if pivot not found or not computable",
+          usedTypes: [
+            "CellValue",
+            "PivotQueryResult"
+          ],
+          tags: [
+            "ask"
+          ]
+        },
         refresh: {
           signature: "refresh(pivotId: string): Promise<void>;",
           docstring: "Refresh a pivot table (recompute without cache).\n\n@param pivotId - Pivot table ID",
@@ -94865,7 +95265,7 @@ var api_spec_default = {
           ]
         },
         addCalculatedField: {
-          signature: "addCalculatedField(\n    pivotId: string,\n    field: CalculatedField,\n  ): Promise<void>;",
+          signature: "addCalculatedField(pivotId: string, field: CalculatedField): Promise<void>;",
           docstring: "Add a calculated field to a pivot table.\n\n@param pivotId - Pivot table ID\n@param field - Calculated field definition (fieldId, name, formula)",
           usedTypes: [
             "CalculatedField"
@@ -96345,8 +96745,8 @@ Example: { ignoreError: true } to suppress error indicators. */
   width: number;
   /** Chart height in cells */
   height: number;
-  /** Data range in A1 notation (e.g., "A1:D10") */
-  dataRange: string;
+  /** Data range in A1 notation (e.g., "A1:D10"). Optional when series[].values are provided. */
+  dataRange?: string;
   /** Series labels range in A1 notation */
   seriesRange?: string;
   /** Category labels range in A1 notation */
@@ -96944,6 +97344,16 @@ Used in condition filters where users specify rules like
       definition: "{\n  /** Index of slice to explode (pull out from center) */\n  explodedIndex?: number;\n  /** Array of indices to explode */\n  explodedIndices?: number[];\n  /** Distance to explode (0-1, default 0.1) */\n  explodeOffset?: number;\n  /** Allow clicking to select/explode slices */\n  selectable?: boolean;\n}",
       docstring: "Pie/doughnut slice configuration for exploded slices"
     },
+    PivotQueryRecord: {
+      name: "PivotQueryRecord",
+      definition: '{\n  /** Dimension values keyed by field name (e.g., { Region: "North", Year: 2021 }) */\n  dimensions: Record<string, CellValue>;\n  /** Aggregated values keyed by value field label (e.g., { "Sum of Amount": 110 }) */\n  values: Record<string, CellValue>;\n}',
+      docstring: "A single flat record from a pivot query result."
+    },
+    PivotQueryResult: {
+      name: "PivotQueryResult",
+      definition: "{\n  /** Pivot table name */\n  pivotName: string;\n  /** Row dimension field names */\n  rowFields: string[];\n  /** Column dimension field names */\n  columnFields: string[];\n  /** Value field labels */\n  valueFields: string[];\n  /** Flat records \u2014 one per data intersection, excluding subtotals and grand totals */\n  records: PivotQueryRecord[];\n  /** Total source row count */\n  sourceRowCount: number;\n}",
+      docstring: "Result of queryPivot() \u2014 flat, agent-friendly records instead of hierarchy trees."
+    },
     PivotTableConfig: {
       name: "PivotTableConfig",
       definition: '{\n  /** Pivot table name */\n  name: string;\n  /** Source data range in A1 notation (e.g., "Sheet1!A1:E100") */\n  dataSource: string;\n  /** Target sheet name (defaults to a new sheet) */\n  targetSheet?: string;\n  /** Target cell address (defaults to A1) */\n  targetAddress?: string;\n  /** Field names for the row area */\n  rowFields?: string[];\n  /** Field names for the column area */\n  columnFields?: string[];\n  /** Value field configurations */\n  valueFields?: PivotValueField[];\n  /** Field names for the filter area */\n  filterFields?: string[];\n}',
@@ -96956,7 +97366,7 @@ Used in condition filters where users specify rules like
     },
     PivotTableInfo: {
       name: "PivotTableInfo",
-      definition: "{\n  /** Pivot table name */\n  name: string;\n  /** Source data range */\n  dataSource: string;\n  /** Range occupied by the pivot table content */\n  contentArea: string;\n  /** Range occupied by filter dropdowns (if any) */\n  filterArea?: string;\n}",
+      definition: '{\n  /** Pivot table name */\n  name: string;\n  /** Source data range (e.g., "Sheet1!A1:D100") */\n  dataSource: string;\n  /** Range occupied by the pivot table content */\n  contentArea: string;\n  /** Range occupied by filter dropdowns (if any) */\n  filterArea?: string;\n  /** Output anchor location as A1 reference (e.g., "G1") */\n  location?: string;\n  /** Row dimension field names */\n  rowFields?: string[];\n  /** Column dimension field names */\n  columnFields?: string[];\n  /** Value fields with aggregation info */\n  valueFields?: PivotValueField[];\n  /** Filter field names */\n  filterFields?: string[];\n}',
       docstring: "Summary information about an existing pivot table."
     },
     PivotValueField: {
@@ -97094,6 +97504,11 @@ Used in condition filters where users specify rules like
       definition: "'rows' | 'columns'",
       docstring: "Data series orientation"
     },
+    SetCellsResult: {
+      name: "SetCellsResult",
+      definition: "{\n  /** Number of cells successfully written */\n  cellsWritten: number;\n  /** Per-cell errors, if any (omitted when all succeed) */\n  errors?: Array<{ addr: string; error: string }>;\n}",
+      docstring: "Result of a bulk setCells() operation."
+    },
     ShadowAlignment: {
       name: "ShadowAlignment",
       definition: "| 'tl' // Top-left\n  | 't' // Top-center\n  | 'tr' // Top-right\n  | 'l' // Middle-left\n  | 'ctr' // Center\n  | 'r' // Middle-right\n  | 'bl' // Bottom-left\n  | 'b' // Bottom-center\n  | 'br'",
@@ -97496,7 +97911,7 @@ Used in condition filters where users specify rules like
       docstring: "A summary snapshot of the entire workbook state."
     }
   },
-  generated: "2026-04-01T03:19:27.745Z"
+  generated: "2026-04-01T18:35:30.029Z"
 };
 
 // src/api-describe.ts
@@ -97512,6 +97927,44 @@ var rootInterfaces = {
   wb: "Workbook",
   ws: "Worksheet"
 };
+var BUILTIN_TYPE_NAMES = /* @__PURE__ */ new Set([
+  "Promise",
+  "Partial",
+  "Required",
+  "Readonly",
+  "Pick",
+  "Omit",
+  "Array",
+  "Record",
+  "Map",
+  "Set",
+  "Uint8Array",
+  "ArrayBuffer",
+  "Function",
+  "Object",
+  "Date",
+  "RegExp",
+  "Error",
+  "Symbol",
+  "string",
+  "number",
+  "boolean",
+  "void",
+  "null",
+  "undefined",
+  "any",
+  "never",
+  "unknown"
+]);
+function extractTypeRefs(definition) {
+  const refs = [];
+  for (const [, name] of definition.matchAll(/\b([A-Z][A-Za-z0-9]+)\b/g)) {
+    if (!BUILTIN_TYPE_NAMES.has(name)) {
+      refs.push(name);
+    }
+  }
+  return refs;
+}
 function getMethodsExcludingAccessors(ifaceName, root) {
   const iface = api_spec_default.interfaces[ifaceName];
   if (!iface) return [];
@@ -97607,10 +98060,20 @@ function resolveMethod(ifaceName, methodName, fullPath) {
   const fn = iface.functions[methodName];
   if (!fn) return null;
   const types = {};
-  for (const typeName of fn.usedTypes) {
+  const queue = [...fn.usedTypes];
+  const seen = new Set(queue);
+  while (queue.length > 0) {
+    const typeName = queue.shift();
     const resolved = resolveType(typeName);
-    if (resolved) {
-      types[typeName] = resolved;
+    if (!resolved) continue;
+    types[typeName] = resolved;
+    if (resolved.definition) {
+      for (const ref of extractTypeRefs(resolved.definition)) {
+        if (!seen.has(ref)) {
+          seen.add(ref);
+          queue.push(ref);
+        }
+      }
     }
   }
   return {
@@ -97622,7 +98085,104 @@ function resolveMethod(ifaceName, methodName, fullPath) {
     types
   };
 }
-var api = { describe };
+var methodCache = /* @__PURE__ */ new Map();
+function cachedResolveMethod(ifaceName, methodName, fullPath) {
+  if (methodCache.has(fullPath)) return methodCache.get(fullPath);
+  const result = resolveMethod(ifaceName, methodName, fullPath);
+  methodCache.set(fullPath, result);
+  return result;
+}
+var RESERVED_PROPS = /* @__PURE__ */ new Set([
+  "name",
+  "path",
+  "docstring",
+  "methods",
+  "subApis",
+  "types",
+  "tags",
+  "signature"
+]);
+function buildSubApiNode(ifaceName, root, accessor) {
+  const iface = api_spec_default.interfaces[ifaceName];
+  const fullPath = `${root}.${accessor}`;
+  const node = {
+    name: ifaceName,
+    path: fullPath,
+    docstring: iface?.docstring ?? "",
+    methods: buildMethodSummaries(ifaceName)
+  };
+  if (iface) {
+    for (const methodName of Object.keys(iface.functions)) {
+      if (RESERVED_PROPS.has(methodName)) continue;
+      Object.defineProperty(node, methodName, {
+        get() {
+          return cachedResolveMethod(ifaceName, methodName, `${fullPath}.${methodName}`);
+        },
+        enumerable: true,
+        configurable: true
+      });
+    }
+  }
+  return node;
+}
+function buildRootNode(root) {
+  const ifaceName = rootInterfaces[root];
+  const accessors = subApiAccessors[root] ?? /* @__PURE__ */ new Set();
+  const node = {
+    name: ifaceName,
+    methods: buildMethodSummaries(ifaceName, accessors),
+    subApis: [...accessors]
+  };
+  const subs = api_spec_default.subApis[root] ?? {};
+  for (const [accessor, subIfaceName] of Object.entries(subs)) {
+    if (RESERVED_PROPS.has(accessor)) continue;
+    let cached;
+    Object.defineProperty(node, accessor, {
+      get() {
+        if (!cached) cached = buildSubApiNode(subIfaceName, root, accessor);
+        return cached;
+      },
+      enumerable: true,
+      configurable: true
+    });
+  }
+  const iface = api_spec_default.interfaces[ifaceName];
+  if (iface) {
+    for (const methodName of Object.keys(iface.functions)) {
+      if (accessors.has(methodName) || RESERVED_PROPS.has(methodName) || methodName in node)
+        continue;
+      Object.defineProperty(node, methodName, {
+        get() {
+          return cachedResolveMethod(ifaceName, methodName, `${root}.${methodName}`);
+        },
+        enumerable: true,
+        configurable: true
+      });
+    }
+  }
+  return node;
+}
+function buildTypesNode() {
+  const node = {};
+  for (const name of Object.keys(api_spec_default.types)) {
+    let cached;
+    Object.defineProperty(node, name, {
+      get() {
+        if (cached === void 0) cached = resolveType(name);
+        return cached;
+      },
+      enumerable: true,
+      configurable: true
+    });
+  }
+  return node;
+}
+var api = {
+  describe,
+  wb: buildRootNode("wb"),
+  ws: buildRootNode("ws"),
+  types: buildTypesNode()
+};
 
 // src/boot.ts
 init_esm_shims();
@@ -97745,8 +98305,6 @@ var HeadlessEngine = class {
       ctx: this.context,
       eventBus: this.context.eventBus
     });
-    this._workbook.getActiveSheet();
-    await this._workbook.refreshSheetMetadata();
   }
   /**
    * Get or set the active sheet ID.
@@ -97822,7 +98380,13 @@ var CoordinatorHandle = class _CoordinatorHandle {
   }
   push(participantId, update4, touchedSheetIds, participantSv) {
     const fn = this.addon["coordinator_push"];
-    const result = fn(this.handle, participantId, Buffer.from(update4), touchedSheetIds, Buffer.from(participantSv));
+    const result = fn(
+      this.handle,
+      participantId,
+      Buffer.from(update4),
+      touchedSheetIds,
+      Buffer.from(participantSv)
+    );
     return typeof result === "string" ? JSON.parse(result) : result;
   }
   pull(participantId, participantSv) {
@@ -97959,14 +98523,7 @@ var CollaborativeEngine = class _CollaborativeEngine {
         await engine.computeBridge.syncApply(pushRaw.serverDiff);
       }
     }
-    return new _CollaborativeEngine(
-      engine,
-      coordinator,
-      participantId,
-      syncMode,
-      10,
-      false
-    );
+    return new _CollaborativeEngine(engine, coordinator, participantId, syncMode, 10, false);
   }
   // ---------------------------------------------------------------------------
   // Public API
@@ -98055,11 +98612,7 @@ var CollaborativeEngine = class _CollaborativeEngine {
   // ---------------------------------------------------------------------------
   /** Acquire a lock. Returns lock ID. */
   async lock(scope, ttlSeconds = 60) {
-    return this._coordinator.acquireLock(
-      this._participantId,
-      scope,
-      ttlSeconds * 1e3
-    );
+    return this._coordinator.acquireLock(this._participantId, scope, ttlSeconds * 1e3);
   }
   /** Release a lock. */
   async unlock(lockId) {