@mog-sdk/node 0.1.10 → 0.1.12

package/dist/index.js

@@ -272,36 +272,6 @@ var init_errors = __esm({
   }
 });
 
-// ../../contracts/src/document/protection.ts
-var DEFAULT_PROTECTION_OPTIONS, DEFAULT_WORKBOOK_PROTECTION_OPTIONS;
-var init_protection = __esm({
-  "../../contracts/src/document/protection.ts"() {
-    "use strict";
-    init_esm_shims();
-    DEFAULT_PROTECTION_OPTIONS = {
-      // Selection defaults to true (users can always select cells)
-      selectLockedCells: true,
-      selectUnlockedCells: true,
-      // All other operations blocked by default
-      insertRows: false,
-      insertColumns: false,
-      deleteRows: false,
-      deleteColumns: false,
-      formatCells: false,
-      formatColumns: false,
-      formatRows: false,
-      sort: false,
-      useAutoFilter: false,
-      usePivotTableReports: false,
-      editObjects: false,
-      editScenarios: false
-    };
-    DEFAULT_WORKBOOK_PROTECTION_OPTIONS = {
-      structure: true
-    };
-  }
-});
-
 // ../../infra/transport/src/command-metadata.gen.ts
 var BYTES_TUPLE_COMMANDS, RECALC_COMMANDS;
 var init_command_metadata_gen = __esm({
@@ -1311,6 +1281,106 @@ var init_schemas = __esm({
   }
 });
 
+// ../../kernel/src/api/worksheet/change-accumulator.ts
+function colToLetter(col) {
+  let result = "";
+  let c = col;
+  while (c >= 0) {
+    result = String.fromCharCode(c % 26 + 65) + result;
+    c = Math.floor(c / 26) - 1;
+  }
+  return result;
+}
+function toA1(row, col) {
+  return `${colToLetter(col)}${row + 1}`;
+}
+var ChangeAccumulator;
+var init_change_accumulator = __esm({
+  "../../kernel/src/api/worksheet/change-accumulator.ts"() {
+    "use strict";
+    init_esm_shims();
+    ChangeAccumulator = class {
+      constructor() {
+        this.trackers = /* @__PURE__ */ new Set();
+        /**
+         * Pending direct edits set before a mutation, consumed by the next ingest().
+         * Since JS is single-threaded, setDirectEdits() before the bridge call
+         * guarantees these are consumed by the corresponding ingest().
+         */
+        this.pendingDirectEdits = null;
+      }
+      /**
+       * Set the direct edit positions for the next mutation.
+       * Called by cell-operations before triggering the bridge call.
+       * Consumed (cleared) by the next ingest() call.
+       */
+      setDirectEdits(edits) {
+        this.pendingDirectEdits = edits;
+      }
+      /**
+       * Called by MutationResultHandler after every mutation.
+       *
+       * @param changedCells - RecalcResult.changedCells from the MutationResult
+       * @param directEdits - The (sheetId, row, col) tuples that were directly written
+       *                      (to distinguish direct vs cascade)
+       * @param source - user or remote
+       */
+      ingest(changedCells, directEdits, source) {
+        if (this.trackers.size === 0) {
+          this.pendingDirectEdits = null;
+          return;
+        }
+        if (changedCells.length === 0) {
+          this.pendingDirectEdits = null;
+          return;
+        }
+        const edits = directEdits ?? this.pendingDirectEdits;
+        this.pendingDirectEdits = null;
+        const directSet = /* @__PURE__ */ new Set();
+        if (edits) {
+          for (const e of edits) {
+            directSet.add(`${e.sheetId}:${e.row}:${e.col}`);
+          }
+        }
+        const recordsBySheet = /* @__PURE__ */ new Map();
+        for (const cell of changedCells) {
+          const key = `${cell.sheetId}:${cell.row}:${cell.col}`;
+          const origin = source === "remote" ? "remote" : directSet.has(key) ? "direct" : "cascade";
+          const record = {
+            address: toA1(cell.row, cell.col),
+            row: cell.row,
+            col: cell.col,
+            origin,
+            type: "modified"
+          };
+          let list = recordsBySheet.get(cell.sheetId);
+          if (!list) {
+            list = [];
+            recordsBySheet.set(cell.sheetId, list);
+          }
+          list.push(record);
+        }
+        for (const tracker of this.trackers) {
+          const records = recordsBySheet.get(tracker.sheetId);
+          if (records && records.length > 0) {
+            tracker._ingest(records);
+          }
+        }
+      }
+      register(tracker) {
+        this.trackers.add(tracker);
+      }
+      unregister(tracker) {
+        this.trackers.delete(tracker);
+      }
+      /** Number of active trackers. */
+      get activeCount() {
+        return this.trackers.size;
+      }
+    };
+  }
+});
+
 // ../../kernel/src/bridges/mutation-result-handler.ts
 function resolvedPosition(row, col) {
   if (row === POSITION_SENTINEL || col === POSITION_SENTINEL) {
@@ -1323,6 +1393,7 @@ var init_mutation_result_handler = __esm({
   "../../kernel/src/bridges/mutation-result-handler.ts"() {
     "use strict";
     init_esm_shims();
+    init_change_accumulator();
     POSITION_SENTINEL = 4294967295;
     MutationResultHandler = class {
       constructor(eventBus, onUndoDescription) {
@@ -1332,6 +1403,7 @@ var init_mutation_result_handler = __esm({
         this.errorCallbacks = [];
         this.eventBus = eventBus;
         this.onUndoDescription = onUndoDescription;
+        this.changeAccumulator = new ChangeAccumulator();
       }
       /** Set the ViewportCoordinatorRegistry for per-viewport dimension patching. */
       setCoordinatorRegistry(registry2) {
@@ -1353,8 +1425,9 @@ var init_mutation_result_handler = __esm({
        *
        * @param result - MutationResult from a Rust IPC command
        * @param source - Whether this mutation originated from the local user or remote collaboration
+       * @param directEdits - Optional positions of directly-written cells (to distinguish direct vs cascade)
        */
-      applyAndNotify(result, source = "user") {
+      applyAndNotify(result, source = "user", directEdits) {
         if (result.recalc) {
           this.handleRecalcResult(result.recalc, source);
         }
@@ -1415,6 +1488,9 @@ var init_mutation_result_handler = __esm({
         if (result.undoDescription) {
           this.handleUndoDescription(result.undoDescription);
         }
+        if (this.changeAccumulator.activeCount > 0 && result.recalc?.changedCells?.length) {
+          this.changeAccumulator.ingest(result.recalc.changedCells, directEdits ?? null, source);
+        }
       }
       /**
        * Register an error callback for mutation failures.
@@ -2104,101 +2180,6 @@ var init_mutation_result_handler = __esm({
   }
 });
 
-// ../../contracts/src/core/commands.ts
-var init_commands = __esm({
-  "../../contracts/src/core/commands.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/core.ts
-var init_core2 = __esm({
-  "../../contracts/src/core/core.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/disposable.ts
-var init_disposable = __esm({
-  "../../contracts/src/core/disposable.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/event-base.ts
-var init_event_base = __esm({
-  "../../contracts/src/core/event-base.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/execution.ts
-var init_execution = __esm({
-  "../../contracts/src/core/execution.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/result.ts
-var init_result = __esm({
-  "../../contracts/src/core/result.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/schema.ts
-var init_schema = __esm({
-  "../../contracts/src/core/schema.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/formatted-text.ts
-function asFormattedText(s) {
-  return s;
-}
-function displayStringOrNull(text) {
-  return text;
-}
-var init_formatted_text = __esm({
-  "../../contracts/src/core/formatted-text.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/testing.ts
-var init_testing = __esm({
-  "../../contracts/src/core/testing.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/core/index.ts
-var init_core3 = __esm({
-  "../../contracts/src/core/index.ts"() {
-    "use strict";
-    init_esm_shims();
-    init_commands();
-    init_core2();
-    init_disposable();
-    init_event_base();
-    init_execution();
-    init_result();
-    init_schema();
-    init_formatted_text();
-    init_testing();
-  }
-});
-
 // ../../kernel/src/bridges/wire/constants.gen.ts
 var HEADER_SIZE, CELL_STRIDE, MERGE_STRIDE, DIM_STRIDE, NO_STRING, MUTATION_HEADER_SIZE, PATCH_STRIDE, OFF_NUMBER_VALUE, OFF_DISPLAY_OFF, OFF_ERROR_OFF, OFF_FLAGS, OFF_FORMAT_IDX, OFF_DISPLAY_LEN, OFF_ERROR_LEN, OFF_BG_COLOR_OVERRIDE, OFF_FONT_COLOR_OVERRIDE, DATA_BAR_ENTRY_STRIDE, ICON_ENTRY_STRIDE, MUT_HAS_PROJECTION_CHANGES, MUT_HAS_ERRORS, MUT_HAS_PALETTE, ICON_SET_NAMES;
 var init_constants_gen = __esm({
@@ -2256,12 +2237,12 @@ var init_constants_gen = __esm({
 });
 
 // ../../kernel/src/bridges/wire/binary-mutation-reader.ts
+import { asFormattedText } from "@mog-sdk/spreadsheet-contracts/core";
 var sharedDecoder, BinaryMutationReader;
 var init_binary_mutation_reader = __esm({
   "../../kernel/src/bridges/wire/binary-mutation-reader.ts"() {
     "use strict";
     init_esm_shims();
-    init_core3();
     init_constants_gen();
     sharedDecoder = new TextDecoder("utf-8");
     BinaryMutationReader = class {
@@ -2555,6 +2536,7 @@ var init_binary_mutation_reader = __esm({
 });
 
 // ../../kernel/src/bridges/wire/binary-viewport-buffer.ts
+import { asFormattedText as asFormattedText2, displayStringOrNull } from "@mog-sdk/spreadsheet-contracts/core";
 function rgbaU32ToHex(value) {
   const r = value >>> 24 & 255;
   const g = value >>> 16 & 255;
@@ -2566,7 +2548,6 @@ var init_binary_viewport_buffer = __esm({
   "../../kernel/src/bridges/wire/binary-viewport-buffer.ts"() {
     "use strict";
     init_esm_shims();
-    init_core3();
     init_constants_gen();
     init_constants_gen();
     sharedEncoder = new TextEncoder();
@@ -3663,7 +3644,7 @@ var init_binary_viewport_buffer = __esm({
        */
       get displayText() {
         const decoded = this._buffer.getOrDecodeString(this._displayOff, this._displayLen);
-        return decoded !== null ? asFormattedText(decoded) : null;
+        return decoded !== null ? asFormattedText2(decoded) : null;
       }
       /**
        * Get the error text for the current cell.
@@ -3722,6 +3703,7 @@ var init_binary_viewport_buffer = __esm({
 });
 
 // ../../kernel/src/bridges/wire/viewport-coordinator.ts
+import { displayStringOrNull as displayStringOrNull2 } from "@mog-sdk/spreadsheet-contracts/core";
 function cellKey(row, col) {
   return `${row},${col}`;
 }
@@ -3731,7 +3713,6 @@ var init_viewport_coordinator = __esm({
     "use strict";
     init_esm_shims();
     init_binary_viewport_buffer();
-    init_core3();
     ViewportCoordinator = class {
       constructor(viewportId) {
         /** Monotonically increasing version, incremented on every write. */
@@ -3852,7 +3833,7 @@ var init_viewport_coordinator = __esm({
             flags: reader.patchFlags(i),
             numberValue: reader.patchNumberValue(i),
             formatIdx: reader.patchFormatIdx(i),
-            displayString: displayStringOrNull(reader.patchDisplayText(i)),
+            displayString: displayStringOrNull2(reader.patchDisplayText(i)),
             errorString: reader.patchErrorText(i),
             bgColorOverride: reader.patchBgColorOverride(i),
             fontColorOverride: reader.patchFontColorOverride(i),
@@ -3869,7 +3850,7 @@ var init_viewport_coordinator = __esm({
             flags: reader.spillPatchFlags(i),
             numberValue: reader.spillPatchNumberValue(i),
             formatIdx: reader.spillPatchFormatIdx(i),
-            displayString: displayStringOrNull(reader.spillPatchDisplayText(i)),
+            displayString: displayStringOrNull2(reader.spillPatchDisplayText(i)),
             errorString: reader.spillPatchErrorText(i),
             bgColorOverride: reader.spillPatchBgColorOverride(i),
             fontColorOverride: reader.spillPatchFontColorOverride(i),
@@ -5978,6 +5959,9 @@ var init_compute_bridge_gen = __esm({
       getCellFormatWithCf(sheetId, cellId, row, col) {
         return this.core.query(this.core.transport.call("compute_get_cell_format_with_cf", { docId: this.core.docId, sheetId, cellId, row, col }));
       }
+      getResolvedFormat(sheetId, row, col) {
+        return this.core.query(this.core.transport.call("compute_get_resolved_format", { docId: this.core.docId, sheetId, row, col }));
+      }
       setCellFormat(sheetId, cellId, format) {
         return this.core.mutatePlain(this.core.transport.call("compute_set_cell_format", { docId: this.core.docId, sheetId, cellId, format }));
       }
@@ -6727,6 +6711,7 @@ __export(compute_bridge_exports, {
   wireTableToTableConfig: () => wireTableToTableConfig,
   wireToIdentityFormula: () => wireToIdentityFormula
 });
+import { DEFAULT_PROTECTION_OPTIONS } from "@mog-sdk/spreadsheet-contracts/protection";
 function emptyMutationResult() {
   return {
     recalc: {
@@ -6797,7 +6782,6 @@ var init_compute_bridge = __esm({
     "use strict";
     init_esm_shims();
     init_formula_string();
-    init_protection();
     init_src();
     init_compute_wire_converters();
     init_compute_core();
@@ -7223,65 +7207,8 @@ var init_compute_bridge = __esm({
   }
 });
 
-// ../../contracts/src/rendering/grid-renderer.ts
-var init_grid_renderer = __esm({
-  "../../contracts/src/rendering/grid-renderer.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/rendering/constants.ts
-var DEFAULT_COL_WIDTH_WINDOWS, DEFAULT_COL_WIDTH_MACOS, _isMac, DEFAULT_COL_WIDTH;
-var init_constants = __esm({
-  "../../contracts/src/rendering/constants.ts"() {
-    "use strict";
-    init_esm_shims();
-    DEFAULT_COL_WIDTH_WINDOWS = 64;
-    DEFAULT_COL_WIDTH_MACOS = 72;
-    _isMac = typeof navigator !== "undefined" && /Mac/.test(navigator.platform ?? "");
-    DEFAULT_COL_WIDTH = _isMac ? DEFAULT_COL_WIDTH_MACOS : DEFAULT_COL_WIDTH_WINDOWS;
-  }
-});
-
-// ../../contracts/src/rendering/data-sources.ts
-var DEFAULT_CHROME_THEME;
-var init_data_sources = __esm({
-  "../../contracts/src/rendering/data-sources.ts"() {
-    "use strict";
-    init_esm_shims();
-    DEFAULT_CHROME_THEME = {
-      canvasBackground: "#ffffff",
-      gridlineColor: "#e0e0e0",
-      headerBackground: "#f8f9fa",
-      headerText: "#333333",
-      headerBorder: "#dadce0",
-      headerHighlightBackground: "#e8eaed",
-      headerHighlightText: "#1a73e8",
-      selectionFill: "rgba(66, 133, 244, 0.1)",
-      selectionBorder: "#4285f4",
-      activeCellBorder: "#1a73e8",
-      fillHandleColor: "#4285f4",
-      dragSourceColor: "rgba(66, 133, 244, 0.15)",
-      dragTargetColor: "#4285f4",
-      scrollbarTrack: "#f1f1f1",
-      scrollbarThumb: "#c1c1c1"
-    };
-  }
-});
-
-// ../../contracts/src/rendering/index.ts
-var init_rendering = __esm({
-  "../../contracts/src/rendering/index.ts"() {
-    "use strict";
-    init_esm_shims();
-    init_grid_renderer();
-    init_constants();
-    init_data_sources();
-  }
-});
-
 // ../../kernel/src/domain/sheets/sheet-meta-defaults.ts
+import { DEFAULT_COL_WIDTH as _PLATFORM_COL_WIDTH } from "@mog-sdk/spreadsheet-contracts/rendering";
 function getSheetMetaDefault(field) {
   const def = SHEET_META_SCHEMA[field];
   return def.default;
@@ -7291,9 +7218,8 @@ var init_sheet_meta_defaults = __esm({
   "../../kernel/src/domain/sheets/sheet-meta-defaults.ts"() {
     "use strict";
     init_esm_shims();
-    init_rendering();
     SHEET_META_DEFAULT_ROW_HEIGHT = 20;
-    SHEET_META_DEFAULT_COL_WIDTH = DEFAULT_COL_WIDTH;
+    SHEET_META_DEFAULT_COL_WIDTH = _PLATFORM_COL_WIDTH;
     SHEET_META_DEFAULT_GRIDLINE_COLOR = "#e2e2e2";
     SHEET_META_SCHEMA = {
       // ===========================================================================
@@ -7784,16 +7710,18 @@ var init_core_defaults = __esm({
 async function getMeta(ctx, sheetId) {
   const name = await ctx.computeBridge.getSheetName(sheetId);
   if (name === null) return void 0;
-  const [frozen, tabColor, hidden] = await Promise.all([
+  const [frozen, tabColor, hidden, defaultRowHeight, defaultColWidth] = await Promise.all([
     ctx.computeBridge.getFrozenPanesQuery(sheetId),
     ctx.computeBridge.getTabColorQuery(sheetId),
-    ctx.computeBridge.isSheetHidden(sheetId)
+    ctx.computeBridge.isSheetHidden(sheetId),
+    ctx.computeBridge.getDefaultRowHeight(sheetId),
+    ctx.computeBridge.getDefaultColWidth(sheetId)
   ]);
   return {
     id: sheetId,
     name,
-    defaultRowHeight: 20,
-    defaultColWidth: 100,
+    defaultRowHeight,
+    defaultColWidth,
     frozenRows: frozen.rows,
     frozenCols: frozen.cols,
     tabColor: tabColor ?? void 0,
@@ -7820,6 +7748,7 @@ var init_sheet_meta = __esm({
 });
 
 // ../../spreadsheet-utils/src/range.ts
+import { MAX_COLS, MAX_ROWS } from "@mog-sdk/spreadsheet-contracts/core";
 function normalizeRange(range2) {
   return {
     startRow: Math.min(range2.startRow, range2.endRow),
@@ -7835,12 +7764,11 @@ var init_range = __esm({
   "../../spreadsheet-utils/src/range.ts"() {
     "use strict";
     init_esm_shims();
-    init_core3();
   }
 });
 
 // ../../spreadsheet-utils/src/a1.ts
-function colToLetter2(col) {
+function colToLetter3(col) {
   if (col < 0) {
     throw new Error("Column number must be >= 0");
   }
@@ -7860,8 +7788,8 @@ function letterToCol(letters) {
   }
   return result - 1;
 }
-function toA1(row, col) {
-  return `${colToLetter2(col)}${row + 1}`;
+function toA12(row, col) {
+  return `${colToLetter3(col)}${row + 1}`;
 }
 function parseCellAddress(ref) {
   const match = ref.match(CELL_ADDRESS_REGEX);
@@ -9292,7 +9220,7 @@ var init_data_extractor = __esm({
 });
 
 // ../../charts/src/core/index.ts
-var init_core4 = __esm({
+var init_core2 = __esm({
   "../../charts/src/core/index.ts"() {
     "use strict";
     init_esm_shims();
@@ -13276,7 +13204,7 @@ var init_src2 = __esm({
   "../../charts/src/index.ts"() {
     "use strict";
     init_esm_shims();
-    init_core4();
+    init_core2();
     init_primitives();
     init_compiler();
   }
@@ -16352,7 +16280,7 @@ function toDisposable(fn) {
   return disposable;
 }
 var DisposableBase, DisposableStore, DisposableNone;
-var init_disposable2 = __esm({
+var init_disposable = __esm({
   "../../spreadsheet-utils/src/disposable.ts"() {
     "use strict";
     init_esm_shims();
@@ -16416,7 +16344,7 @@ function ok(value) {
 function err(error) {
   return { ok: false, error };
 }
-var init_result2 = __esm({
+var init_result = __esm({
   "../../spreadsheet-utils/src/result.ts"() {
     "use strict";
     init_esm_shims();
@@ -16429,7 +16357,7 @@ var init_subscribable = __esm({
   "../../kernel/src/services/primitives/subscribable.ts"() {
     "use strict";
     init_esm_shims();
-    init_disposable2();
+    init_disposable();
     Subscribable = class extends DisposableBase {
       constructor() {
         super(...arguments);
@@ -16489,7 +16417,7 @@ var init_event_emitter = __esm({
   "../../kernel/src/services/primitives/event-emitter.ts"() {
     "use strict";
     init_esm_shims();
-    init_disposable2();
+    init_disposable();
     TypedEventEmitter = class extends DisposableBase {
       constructor() {
         super(...arguments);
@@ -16554,8 +16482,8 @@ var init_primitives3 = __esm({
   "../../kernel/src/services/primitives/index.ts"() {
     "use strict";
     init_esm_shims();
-    init_disposable2();
-    init_result2();
+    init_disposable();
+    init_result();
     init_subscribable();
     init_event_emitter();
   }
@@ -24605,34 +24533,8 @@ var init_equation_bridge = __esm({
   }
 });
 
-// ../../contracts/src/bridges/ink-recognition-bridge.ts
-var DEFAULT_RECOGNITION_THRESHOLDS;
-var init_ink_recognition_bridge = __esm({
-  "../../contracts/src/bridges/ink-recognition-bridge.ts"() {
-    "use strict";
-    init_esm_shims();
-    DEFAULT_RECOGNITION_THRESHOLDS = {
-      line: 0.7,
-      rectangle: 0.65,
-      ellipse: 0.7,
-      triangle: 0.6,
-      arrow: 0.6,
-      star: 0.65,
-      text: 0.5
-    };
-  }
-});
-
-// ../../contracts/src/bridges/index.ts
-var init_bridges = __esm({
-  "../../contracts/src/bridges/index.ts"() {
-    "use strict";
-    init_esm_shims();
-    init_ink_recognition_bridge();
-  }
-});
-
 // ../../kernel/src/domain/drawing/ink-recognition-bridge.ts
+import { DEFAULT_RECOGNITION_THRESHOLDS } from "@mog-sdk/spreadsheet-contracts/bridges";
 function createInkRecognitionBridge(initialThresholds) {
   let thresholds = {
     ...DEFAULT_RECOGNITION_THRESHOLDS,
@@ -25048,11 +24950,10 @@ async function recognizeWithBrowserAPI(strokes) {
   }
   return null;
 }
-var init_ink_recognition_bridge2 = __esm({
+var init_ink_recognition_bridge = __esm({
   "../../kernel/src/domain/drawing/ink-recognition-bridge.ts"() {
     "use strict";
     init_esm_shims();
-    init_bridges();
   }
 });
 
@@ -30065,7 +29966,7 @@ var init_arrows = __esm({
 
 // ../../canvas/drawing/shapes/src/presets/constants.ts
 var KAPPA;
-var init_constants2 = __esm({
+var init_constants = __esm({
   "../../canvas/drawing/shapes/src/presets/constants.ts"() {
     "use strict";
     init_esm_shims();
@@ -30089,7 +29990,7 @@ var init_primitives4 = __esm({
     "use strict";
     init_esm_shims();
     init_src3();
-    init_constants2();
+    init_constants();
   }
 });
 
@@ -30099,7 +30000,7 @@ var init_basic = __esm({
     "use strict";
     init_esm_shims();
     init_src3();
-    init_constants2();
+    init_constants();
     init_primitives4();
     init_registry3();
     init_primitives4();
@@ -70172,438 +70073,21 @@ var init_rules = __esm({
   }
 });
 
-// ../../contracts/src/smartart/layouts.ts
-var init_layouts2 = __esm({
-  "../../contracts/src/smartart/layouts.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-algorithm-types.ts
-var ParameterId, VALID_PARAMS_BY_ALGORITHM;
-var init_ooxml_algorithm_types = __esm({
-  "../../contracts/src/smartart/ooxml-algorithm-types.ts"() {
-    "use strict";
-    init_esm_shims();
-    ParameterId = {
-      // ── Alignment Parameters ──────────────────────────────────────────────────
-      /** Horizontal alignment of children within the layout area. */
-      horzAlign: "horzAlign",
-      /** Vertical alignment of children within the layout area. */
-      vertAlign: "vertAlign",
-      /** Horizontal alignment for individual nodes (hierarchy algorithms). */
-      nodeHorzAlign: "nodeHorzAlign",
-      /** Vertical alignment for individual nodes (hierarchy algorithms). */
-      nodeVertAlign: "nodeVertAlign",
-      /** Hierarchy alignment (16 possible values for tree orientation). */
-      hierAlign: "hierAlign",
-      /** Text alignment (whether text should be aligned with shape). */
-      alignTx: "alignTx",
-      // ── Direction Parameters ──────────────────────────────────────────────────
-      /** Child direction (horizontal or vertical arrangement of children). */
-      chDir: "chDir",
-      /** Child alignment (how children align on the cross-axis). */
-      chAlign: "chAlign",
-      /** Secondary child alignment (for complex hierarchy layouts). */
-      secChAlign: "secChAlign",
-      /** Linear direction (which edge children flow from). */
-      linDir: "linDir",
-      /** Secondary linear direction (for complex hierarchy layouts). */
-      secLinDir: "secLinDir",
-      /** Text direction (horizontal or vertical text blocks). */
-      txDir: "txDir",
-      /** Text block direction (horizontal or vertical text flow). */
-      txBlDir: "txBlDir",
-      /** Growth direction (which corner the snake starts from). */
-      grDir: "grDir",
-      /** Flow direction (whether snake flows by row or column). */
-      flowDir: "flowDir",
-      /** Continue direction (same direction or reversed for each row). */
-      contDir: "contDir",
-      // ── Connector Parameters ──────────────────────────────────────────────────
-      /** Connector routing style (straight, bend, curve, long curve). */
-      connRout: "connRout",
-      /** Beginning/start arrowhead style for connectors. */
-      begSty: "begSty",
-      /** Ending arrowhead style for connectors. */
-      endSty: "endSty",
-      /** Connector dimension (1D, 2D, or custom). */
-      dim: "dim",
-      /** Source node name for connector routing. */
-      srcNode: "srcNode",
-      /** Destination node name for connector routing. */
-      dstNode: "dstNode",
-      /** Beginning connection points (which points on the source shape). */
-      begPts: "begPts",
-      /** Ending connection points (which points on the destination shape). */
-      endPts: "endPts",
-      /** Bend point position for right-angle connectors. */
-      bendPt: "bendPt",
-      // ── Cycle/Circular Parameters ─────────────────────────────────────────────
-      /** Start angle in degrees for cycle algorithm. */
-      stAng: "stAng",
-      /** Span angle in degrees for cycle algorithm. */
-      spanAng: "spanAng",
-      /** Rotation path (none or along the circular path). */
-      rotPath: "rotPath",
-      /** Center shape mapping (whether first node goes to center). */
-      ctrShpMap: "ctrShpMap",
-      // ── Snake Parameters ──────────────────────────────────────────────────────
-      /** Breakpoint logic for snake wrapping (end of canvas, balanced, fixed). */
-      bkpt: "bkpt",
-      /** Breakpoint fixed value (number of items per row when bkpt=fixed). */
-      bkPtFixedVal: "bkPtFixedVal",
-      /** Offset mode for staggered rows in snake layout. */
-      off: "off",
-      // ── Linear/Sequence Parameters ────────────────────────────────────────────
-      /** Starting element index (which node type starts the alternating sequence). */
-      stElem: "stElem",
-      /** Starting bullet level for text algorithm. */
-      stBulletLvl: "stBulletLvl",
-      // ── Pyramid Parameters ────────────────────────────────────────────────────
-      /** Pyramid accent position (before or after the level). */
-      pyraAcctPos: "pyraAcctPos",
-      /** Pyramid accent text margin (step or stack behavior). */
-      pyraAcctTxMar: "pyraAcctTxMar",
-      /** Pyramid level node name. */
-      pyraLvlNode: "pyraLvlNode",
-      /** Pyramid accent background node name. */
-      pyraAcctBkgdNode: "pyraAcctBkgdNode",
-      /** Pyramid accent text node name. */
-      pyraAcctTxNode: "pyraAcctTxNode",
-      // ── Text Parameters ───────────────────────────────────────────────────────
-      /** Parent text LTR alignment. */
-      parTxLTRAlign: "parTxLTRAlign",
-      /** Parent text RTL alignment. */
-      parTxRTLAlign: "parTxRTLAlign",
-      /** Shape text LTR alignment for children. */
-      shpTxLTRAlignCh: "shpTxLTRAlignCh",
-      /** Shape text RTL alignment for children. */
-      shpTxRTLAlignCh: "shpTxRTLAlignCh",
-      /** Text anchor horizontal position. */
-      txAnchorHorz: "txAnchorHorz",
-      /** Text anchor vertical position. */
-      txAnchorVert: "txAnchorVert",
-      /** Text anchor horizontal position for children. */
-      txAnchorHorzCh: "txAnchorHorzCh",
-      /** Text anchor vertical position for children. */
-      txAnchorVertCh: "txAnchorVertCh",
-      /** Auto text rotation mode (none, upright, gravity-based). */
-      autoTxRot: "autoTxRot",
-      // ── Spacing & Sizing Parameters ───────────────────────────────────────────
-      /** Aspect ratio value. */
-      ar: "ar",
-      /** Line spacing for parent text (percentage). */
-      lnSpPar: "lnSpPar",
-      /** Line spacing after parent paragraph (percentage). */
-      lnSpAfParP: "lnSpAfParP",
-      /** Line spacing for child text (percentage). */
-      lnSpCh: "lnSpCh",
-      /** Line spacing after child paragraph (percentage). */
-      lnSpAfChP: "lnSpAfChP",
-      // ── Hierarchy-Specific Parameters ─────────────────────────────────────────
-      /** Root short distance flag (hierarchy algorithms). */
-      rtShortDist: "rtShortDist",
-      // ── Fallback Parameter ────────────────────────────────────────────────────
-      /** Fallback dimension for the algorithm. */
-      fallback: "fallback"
-    };
-    VALID_PARAMS_BY_ALGORITHM = {
-      composite: [ParameterId.ar],
-      lin: [
-        ParameterId.linDir,
-        ParameterId.chDir,
-        ParameterId.chAlign,
-        ParameterId.horzAlign,
-        ParameterId.vertAlign,
-        ParameterId.stElem,
-        ParameterId.fallback,
-        ParameterId.nodeHorzAlign,
-        ParameterId.nodeVertAlign
-      ],
-      snake: [
-        ParameterId.grDir,
-        ParameterId.flowDir,
-        ParameterId.contDir,
-        ParameterId.bkpt,
-        ParameterId.bkPtFixedVal,
-        ParameterId.off
-      ],
-      cycle: [ParameterId.stAng, ParameterId.spanAng, ParameterId.rotPath, ParameterId.ctrShpMap],
-      hierRoot: [
-        ParameterId.hierAlign,
-        ParameterId.nodeHorzAlign,
-        ParameterId.nodeVertAlign,
-        ParameterId.rtShortDist
-      ],
-      hierChild: [
-        ParameterId.chAlign,
-        ParameterId.linDir,
-        ParameterId.secChAlign,
-        ParameterId.secLinDir
-      ],
-      pyra: [
-        ParameterId.linDir,
-        ParameterId.txDir,
-        ParameterId.pyraAcctPos,
-        ParameterId.pyraAcctTxMar,
-        ParameterId.pyraLvlNode,
-        ParameterId.pyraAcctBkgdNode,
-        ParameterId.pyraAcctTxNode
-      ],
-      conn: [
-        ParameterId.srcNode,
-        ParameterId.dstNode,
-        ParameterId.connRout,
-        ParameterId.begSty,
-        ParameterId.endSty,
-        ParameterId.dim,
-        ParameterId.bendPt,
-        ParameterId.begPts,
-        ParameterId.endPts
-      ],
-      tx: [
-        ParameterId.parTxLTRAlign,
-        ParameterId.parTxRTLAlign,
-        ParameterId.shpTxLTRAlignCh,
-        ParameterId.shpTxRTLAlignCh,
-        ParameterId.txAnchorVert,
-        ParameterId.txAnchorHorz,
-        ParameterId.txAnchorVertCh,
-        ParameterId.txAnchorHorzCh,
-        ParameterId.txBlDir,
-        ParameterId.autoTxRot,
-        ParameterId.stBulletLvl,
-        ParameterId.lnSpPar,
-        ParameterId.lnSpAfParP,
-        ParameterId.lnSpCh,
-        ParameterId.lnSpAfChP,
-        ParameterId.alignTx
-      ],
-      sp: []
-    };
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-data-model-types.ts
-var init_ooxml_data_model_types = __esm({
-  "../../contracts/src/smartart/ooxml-data-model-types.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-drawing-types.ts
-var init_ooxml_drawing_types = __esm({
-  "../../contracts/src/smartart/ooxml-drawing-types.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-engine-types.ts
-var POSITIONAL_CONSTRAINT_TYPES, DIMENSIONAL_CONSTRAINT_TYPES, MARGIN_CONSTRAINT_TYPES, FONT_CONSTRAINT_TYPES, SPACING_CONSTRAINT_TYPES, GEOMETRY_CONSTRAINT_TYPES, USER_DEFINED_CONSTRAINT_TYPES, ALL_CONSTRAINT_TYPES, ALL_ELEMENT_TYPES, ALL_FUNCTION_TYPES, ALL_FUNCTION_OPERATORS, ALL_FUNCTION_ARGUMENTS;
-var init_ooxml_engine_types = __esm({
-  "../../contracts/src/smartart/ooxml-engine-types.ts"() {
-    "use strict";
-    init_esm_shims();
-    POSITIONAL_CONSTRAINT_TYPES = [
-      "l",
-      "t",
-      "r",
-      "b",
-      "lOff",
-      "tOff",
-      "rOff",
-      "bOff",
-      "ctrX",
-      "ctrY",
-      "ctrXOff",
-      "ctrYOff"
-    ];
-    DIMENSIONAL_CONSTRAINT_TYPES = [
-      "w",
-      "h",
-      "wOff",
-      "hOff"
-    ];
-    MARGIN_CONSTRAINT_TYPES = [
-      "lMarg",
-      "tMarg",
-      "rMarg",
-      "bMarg",
-      "begMarg",
-      "endMarg"
-    ];
-    FONT_CONSTRAINT_TYPES = [
-      "primFontSz",
-      "secFontSz"
-    ];
-    SPACING_CONSTRAINT_TYPES = [
-      "sp",
-      "sibSp",
-      "secSibSp"
-    ];
-    GEOMETRY_CONSTRAINT_TYPES = [
-      "connDist",
-      "diam",
-      "stemThick",
-      "begPad",
-      "endPad",
-      "wArH",
-      "hArH",
-      "bendDist"
-    ];
-    USER_DEFINED_CONSTRAINT_TYPES = [
-      "userA",
-      "userB",
-      "userC",
-      "userD",
-      "userE",
-      "userF",
-      "userG",
-      "userH",
-      "userI",
-      "userJ",
-      "userK",
-      "userL",
-      "userM",
-      "userN",
-      "userO",
-      "userP",
-      "userQ",
-      "userR",
-      "userS",
-      "userT",
-      "userU",
-      "userV",
-      "userW",
-      "userX",
-      "userY",
-      "userZ"
-    ];
-    ALL_CONSTRAINT_TYPES = [
-      ...POSITIONAL_CONSTRAINT_TYPES,
-      ...DIMENSIONAL_CONSTRAINT_TYPES,
-      ...MARGIN_CONSTRAINT_TYPES,
-      ...FONT_CONSTRAINT_TYPES,
-      ...SPACING_CONSTRAINT_TYPES,
-      ...GEOMETRY_CONSTRAINT_TYPES,
-      "pyraAcctRatio",
-      "alignOff",
-      ...USER_DEFINED_CONSTRAINT_TYPES,
-      "none"
-    ];
-    ALL_ELEMENT_TYPES = [
-      "all",
-      "doc",
-      "node",
-      "norm",
-      "nonNorm",
-      "asst",
-      "nonAsst",
-      "parTrans",
-      "pres",
-      "sibTrans"
-    ];
-    ALL_FUNCTION_TYPES = [
-      "cnt",
-      "pos",
-      "revPos",
-      "posEven",
-      "posOdd",
-      "var",
-      "depth",
-      "maxDepth"
-    ];
-    ALL_FUNCTION_OPERATORS = [
-      "equ",
-      "neq",
-      "gt",
-      "lt",
-      "gte",
-      "lte"
-    ];
-    ALL_FUNCTION_ARGUMENTS = [
-      "none",
-      "orgChart",
-      "chMax",
-      "chPref",
-      "bulEnabled",
-      "dir",
-      "hierBranch",
-      "animOne",
-      "animLvl",
-      "resizeHandles"
-    ];
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-layout-types.ts
-var init_ooxml_layout_types = __esm({
-  "../../contracts/src/smartart/ooxml-layout-types.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/ooxml-style-types.ts
-var init_ooxml_style_types = __esm({
-  "../../contracts/src/smartart/ooxml-style-types.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/styles.ts
-var init_styles3 = __esm({
-  "../../contracts/src/smartart/styles.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/types.ts
-var init_types4 = __esm({
-  "../../contracts/src/smartart/types.ts"() {
-    "use strict";
-    init_esm_shims();
-  }
-});
-
-// ../../contracts/src/smartart/index.ts
-var init_smartart = __esm({
-  "../../contracts/src/smartart/index.ts"() {
-    "use strict";
-    init_esm_shims();
-    init_layouts2();
-    init_ooxml_algorithm_types();
-    init_ooxml_data_model_types();
-    init_ooxml_drawing_types();
-    init_ooxml_engine_types();
-    init_ooxml_layout_types();
-    init_ooxml_style_types();
-    init_styles3();
-    init_types4();
-  }
-});
-
 // ../../canvas/drawing/smartart/src/engine/algorithms/composite.ts
+import { AlgorithmType } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_composite = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/composite.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/linear.ts
+import { AlgorithmType as AlgorithmType2 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_linear2 = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/linear.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
   }
 });
 
@@ -70616,82 +70100,82 @@ var init_param_utils = __esm({
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/snake.ts
+import { AlgorithmType as AlgorithmType3 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_snake = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/snake.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/cycle.ts
+import { AlgorithmType as AlgorithmType4 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_cycle2 = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/cycle.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/hier-root.ts
+import { AlgorithmType as AlgorithmType5 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_hier_root = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/hier-root.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/hier-child.ts
+import { AlgorithmType as AlgorithmType6 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_hier_child = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/hier-child.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/pyramid.ts
+import { AlgorithmType as AlgorithmType7 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_pyramid2 = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/pyramid.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/connector.ts
+import { AlgorithmType as AlgorithmType8 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_connector = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/connector.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_connector_routing();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/text.ts
+import { AlgorithmType as AlgorithmType9 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_text3 = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/text.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_param_utils();
   }
 });
 
 // ../../canvas/drawing/smartart/src/engine/algorithms/space.ts
+import { AlgorithmType as AlgorithmType10 } from "@mog-sdk/spreadsheet-contracts/smartart";
 var init_space = __esm({
   "../../canvas/drawing/smartart/src/engine/algorithms/space.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
   }
 });
 
@@ -70850,12 +70334,18 @@ var init_drawing_parser = __esm({
 });
 
 // ../../canvas/drawing/smartart/src/parser/layout-def-parser.ts
+import {
+  ALL_ELEMENT_TYPES,
+  ALL_FUNCTION_ARGUMENTS,
+  ALL_FUNCTION_OPERATORS,
+  ALL_FUNCTION_TYPES,
+  VARIABLE_LIST_DEFAULTS
+} from "@mog-sdk/spreadsheet-contracts/smartart";
 var VALID_ELEMENT_TYPES, VALID_FUNCTION_TYPES, VALID_FUNCTION_OPERATORS, VALID_FUNCTION_ARGUMENTS;
 var init_layout_def_parser = __esm({
   "../../canvas/drawing/smartart/src/parser/layout-def-parser.ts"() {
     "use strict";
     init_esm_shims();
-    init_smartart();
     init_data_model_parser();
     init_drawingml_helpers();
     init_xml_helpers();
@@ -74757,7 +74247,7 @@ var init_cell_anchor_resolver = __esm({
 });
 
 // ../../kernel/src/floating-objects/types.ts
-var init_types5 = __esm({
+var init_types4 = __esm({
   "../../kernel/src/floating-objects/types.ts"() {
     "use strict";
     init_esm_shims();
@@ -74856,7 +74346,7 @@ var init_picture_manager = __esm({
     "use strict";
     init_esm_shims();
     init_document();
-    init_types5();
+    init_types4();
   }
 });
 
@@ -74958,7 +74448,7 @@ var init_textbox_manager = __esm({
   "../../kernel/src/floating-objects/managers/textbox-manager.ts"() {
     "use strict";
     init_esm_shims();
-    init_types5();
+    init_types4();
     DEFAULT_TEXTBOX_FILL = { type: "solid", color: "#ffffff" };
     DEFAULT_TEXTBOX_BORDER = { style: "solid", color: "#000000", width: 1 };
   }
@@ -76139,7 +75629,7 @@ var init_kernel_context = __esm({
     init_esm_shims();
     init_chart_bridge();
     init_equation_bridge();
-    init_ink_recognition_bridge2();
+    init_ink_recognition_bridge();
     init_locale_bridge();
     init_pivot_bridge();
     init_schema_bridge();
@@ -77149,21 +76639,8 @@ var WorkbookHistoryImpl = class {
 
 // ../../kernel/src/api/workbook/names.ts
 init_esm_shims();
-
-// ../../contracts/src/api/index.ts
-init_esm_shims();
-
-// ../../contracts/src/api/types.ts
-init_esm_shims();
-
-// ../../contracts/src/api/worksheet/index.ts
-init_esm_shims();
-
-// ../../contracts/src/api/worksheet/format-mappings.ts
-init_esm_shims();
-
-// ../../kernel/src/api/workbook/names.ts
 init_errors();
+import { RangeValueType } from "@mog-sdk/spreadsheet-contracts/api";
 
 // ../../kernel/src/domain/formulas/named-ranges.ts
 init_esm_shims();
@@ -77295,6 +76772,10 @@ async function getRefersToA1(ctx, name) {
   const a1 = await ctx.computeBridge.toA1Display(NIL_SHEET_ID, wire);
   return a1.startsWith("=") ? a1 : `=${a1}`;
 }
+async function getVisible(ctx) {
+  const rustNames = await ctx.computeBridge.getVisibleNamedRanges();
+  return rustNames.map(mapRustNamedRange);
+}
 async function create2(ctx, input, contextSheet, _origin = "user") {
   const formula = await ctx.computeBridge.toIdentityFormula(contextSheet, input.refersToA1);
   const rawFormula = formula;
@@ -77380,7 +76861,7 @@ async function update2(ctx, id, updates, contextSheet, _origin = "user") {
   }
   const newName = updates.name ?? existing.name;
   if (newName !== existing.name) {
-    void ctx.computeBridge.removeNamedRange(existing.name);
+    void ctx.computeBridge.removeNamedRangeById(existing.id);
   }
   let refersToWire = identityFormulaToWire(existing.refersTo);
   if (updates.refersToA1) {
@@ -77467,7 +76948,7 @@ async function remove(ctx, id, _origin = "user") {
   if (!existing) {
     throw new KernelError("DOMAIN_DEFINED_NAME_NOT_FOUND", `Defined name with ID ${id} not found`);
   }
-  void ctx.computeBridge.removeNamedRange(existing.name);
+  void ctx.computeBridge.removeNamedRangeById(existing.id);
 }
 async function exportNames(ctx) {
   const all = await getAll(ctx);
@@ -77492,7 +76973,7 @@ function sanitizeLabel(label) {
   }
   return name;
 }
-function colToLetter(col) {
+function colToLetter2(col) {
   let result = "";
   let c = col;
   while (c >= 0) {
@@ -77566,7 +77047,7 @@ async function createFromSelection(ctx, sheetId, range2, options, _origin = "use
       result.skippedReasons.push({ label: name, reason: validation.message ?? "invalid name" });
       return;
     }
-    const refersToA1 = refStartRow === refEndRow && refStartCol === refEndCol ? `=$${colToLetter(refStartCol)}$${refStartRow + 1}` : `=$${colToLetter(refStartCol)}$${refStartRow + 1}:$${colToLetter(refEndCol)}$${refEndRow + 1}`;
+    const refersToA1 = refStartRow === refEndRow && refStartCol === refEndCol ? `=$${colToLetter2(refStartCol)}$${refStartRow + 1}` : `=$${colToLetter2(refStartCol)}$${refStartRow + 1}:$${colToLetter2(refEndCol)}$${refEndRow + 1}`;
     try {
       await create2(ctx, { name: sanitized, refersToA1 }, sheetId);
       existingKeys.add(key);
@@ -77781,13 +77262,13 @@ var WorkbookNamesImpl = class {
     if (!values) return null;
     return values.map(
       (row) => row.map((cell) => {
-        if (cell === null || cell === void 0) return "Empty" /* Empty */;
-        if (typeof cell === "boolean") return "Boolean" /* Boolean */;
-        if (typeof cell === "number") return "Double" /* Double */;
-        if (typeof cell === "string") return "String" /* String */;
+        if (cell === null || cell === void 0) return RangeValueType.Empty;
+        if (typeof cell === "boolean") return RangeValueType.Boolean;
+        if (typeof cell === "number") return RangeValueType.Double;
+        if (typeof cell === "string") return RangeValueType.String;
         if (typeof cell === "object" && cell !== null && "type" in cell)
-          return "Error" /* Error */;
-        return "String" /* String */;
+          return RangeValueType.Error;
+        return RangeValueType.String;
       })
     );
   }
@@ -77879,7 +77360,7 @@ var BUILT_IN_LISTS = [
 ];
 
 // ../../kernel/src/domain/workbook/workbook.ts
-init_protection();
+import { DEFAULT_WORKBOOK_PROTECTION_OPTIONS } from "@mog-sdk/spreadsheet-contracts/protection";
 
 // ../../spreadsheet-utils/src/protection.ts
 init_esm_shims();
@@ -78335,9 +77816,9 @@ init_sheet_meta();
 
 // ../../kernel/src/api/worksheet/worksheet-impl.ts
 init_esm_shims();
-init_core3();
 init_errors3();
 init_errors();
+import { displayStringOrNull as displayStringOrNull3 } from "@mog-sdk/spreadsheet-contracts/core";
 
 // ../../kernel/src/bridges/wire/cell-metadata-cache.ts
 init_esm_shims();
@@ -78838,6 +78319,7 @@ init_cell_properties();
 var MAX_RANGE_CELLS = 1e4;
 var MAX_RANGE_BOUNDING_BOX = 5e5;
 var MAX_DESCRIBE_OUTPUT_CHARS = 5e4;
+var MAX_SUMMARY_NAMED_RANGES = 20;
 async function getStyleHints(ctx, sheetId, row, col) {
   const format = await getFormat(ctx, sheetId, row, col);
   if (!format) return null;
@@ -78927,7 +78409,7 @@ function generateFormulaDocumentation(analysis) {
   const lines = [""];
   for (const info of significantPatterns) {
     const examples = info.cells.slice(0, 2).map((cell) => {
-      const addr = `${colToLetter2(cell.col)}${cell.row + 1}`;
+      const addr = `${colToLetter3(cell.col)}${cell.row + 1}`;
       return `${addr}: =${cell.formula}`;
     });
     const exampleStr = examples.length > 0 ? `  (e.g. ${examples.join(", ")})` : "";
@@ -78986,7 +78468,7 @@ function buildLeftContext(leftCells, startRow, startCol, endRow) {
     found.sort((a, b) => a.col - b.col);
     const tokens = found.map((f) => {
       const prefix = "\u2192".repeat(Math.max(0, f.indent));
-      const addr = `${colToLetter2(f.col)}${row + 1}`;
+      const addr = `${colToLetter3(f.col)}${row + 1}`;
       return `${prefix}${addr}:${f.text}`;
     });
     lines.push(tokens.join(" | "));
@@ -79058,7 +78540,7 @@ function buildAboveContext(aboveCells, startRow, startCol, endCol) {
       sawNumeric = true;
       continue;
     }
-    const addr = `${colToLetter2(c)}${bestRow + 1}`;
+    const addr = `${colToLetter3(c)}${bestRow + 1}`;
     if (tokens.length > 0 && sawNumeric) tokens.push("...");
     tokens.push(`${addr}:${d}`);
     sawNumeric = false;
@@ -79116,8 +78598,8 @@ function consolidateRanges(cells) {
         covered.add(`${r},${c}`);
       }
     }
-    const start = `${colToLetter2(cell.col)}${cell.row + 1}`;
-    const end = `${colToLetter2(endCol)}${endRow + 1}`;
+    const start = `${colToLetter3(cell.col)}${cell.row + 1}`;
+    const end = `${colToLetter3(endCol)}${endRow + 1}`;
     ranges.push(start === end ? start : `${start}:${end}`);
   }
   return ranges;
@@ -79188,9 +78670,12 @@ async function getDisplayValue(ctx, sheetId, row, col) {
 async function getCell(ctx, sheetId, row, col) {
   const data = await getData(ctx, sheetId, row, col);
   if (!data) return void 0;
+  const fmt = await getFormat(ctx, sheetId, row, col);
   return {
     value: (data.formula !== void 0 ? data.computed : rawToCellValue(data.raw)) ?? null,
-    formula: data.formula
+    formula: data.formula,
+    format: fmt ?? void 0,
+    formatted: await getDisplayValue(ctx, sheetId, row, col) ?? void 0
   };
 }
 async function getDisplayValue2(ctx, sheetId, row, col) {
@@ -79211,10 +78696,11 @@ 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);
-  const result = await ctx.computeBridge.setCellsByPosition(sheetId, [{ row, col, input }]);
+  ctx.computeBridge.getMutationHandler()?.changeAccumulator.setDirectEdits([{ sheetId, row, col }]);
+  await ctx.computeBridge.setCellsByPosition(sheetId, [{ row, col, input }]);
 }
 async function setCells(ctx, sheetId, cells) {
-  if (cells.length === 0) return { cellsWritten: 0 };
+  if (cells.length === 0) return { cellsWritten: 0, errors: null };
   const edits = cells.map((cell) => {
     let row;
     let col;
@@ -79236,13 +78722,20 @@ async function setCells(ctx, sheetId, cells) {
   }
   const uniqueEdits = Array.from(deduped.values());
   const duplicatesRemoved = edits.length - uniqueEdits.length;
+  ctx.computeBridge.getMutationHandler()?.changeAccumulator.setDirectEdits(
+    uniqueEdits.map((e) => ({ sheetId, row: e.row, col: e.col }))
+  );
   await ctx.computeBridge.setCellsByPosition(sheetId, uniqueEdits);
-  const result = { cellsWritten: uniqueEdits.length };
+  const result = { cellsWritten: uniqueEdits.length, errors: null };
   if (duplicatesRemoved > 0) {
     result.warnings = [
-      createWarning("API_DUPLICATE_COORDINATES", `${duplicatesRemoved} duplicate coordinate(s) resolved by last-write-wins`, {
-        duplicatesRemoved
-      })
+      createWarning(
+        "API_DUPLICATE_COORDINATES",
+        `${duplicatesRemoved} duplicate coordinate(s) resolved by last-write-wins`,
+        {
+          duplicatesRemoved
+        }
+      )
     ];
   }
   return result;
@@ -79343,7 +78836,7 @@ async function batchGetCellPositions(ctx, sheetId, cellIds) {
 
 // ../../kernel/src/api/worksheet/operations/dependency-operations.ts
 init_esm_shims();
-function colToLetter3(col) {
+function colToLetter4(col) {
   let result = "";
   let c = col;
   while (c >= 0) {
@@ -79354,11 +78847,11 @@ function colToLetter3(col) {
 }
 async function getDependents(ctx, sheetId, row, col) {
   const results = await ctx.computeBridge.getDependents(sheetId, row, col);
-  return results.map((r) => `${colToLetter3(r.col)}${r.row + 1}`);
+  return results.map((r) => `${colToLetter4(r.col)}${r.row + 1}`);
 }
 async function getPrecedents(ctx, sheetId, row, col) {
   const results = await ctx.computeBridge.getPrecedents(sheetId, row, col);
-  return results.map((r) => `${colToLetter3(r.col)}${r.row + 1}`);
+  return results.map((r) => `${colToLetter4(r.col)}${r.row + 1}`);
 }
 
 // ../../kernel/src/api/worksheet/operations/fill-operations.ts
@@ -79411,7 +78904,8 @@ async function autoFill(ctx, sheetId, sourceRange, targetRange, mode) {
   return {
     patternType: fillData?.patternType ?? "copy",
     filledCellCount: fillData?.filledCellCount ?? 0,
-    warnings: fillData?.warnings ?? []
+    warnings: fillData?.warnings ?? [],
+    changes: fillData?.changes ?? []
   };
 }
 function splitRangeForSeries(range2, direction) {
@@ -79735,14 +79229,14 @@ async function regexSearch(ctx, sheetId, patterns, options) {
     for (const { regex, source } of compiledPatterns) {
       regex.lastIndex = 0;
       if (regex.test(valueStr)) {
-        const address = `${colToLetter2(cell.col)}${cell.row + 1}`;
+        const address = `${colToLetter3(cell.col)}${cell.row + 1}`;
         results.push({ address, value: valueStr, sheetName, matchedPattern: source });
         break;
       }
       if (options?.includeFormulas && cell.formula) {
         regex.lastIndex = 0;
         if (regex.test(cell.formula)) {
-          const address = `${colToLetter2(cell.col)}${cell.row + 1}`;
+          const address = `${colToLetter3(cell.col)}${cell.row + 1}`;
           results.push({ address, value: valueStr, sheetName, matchedPattern: source });
           break;
         }
@@ -79898,7 +79392,7 @@ async function clearRange2(ctx, sheetId, range2) {
         }
       }
     }
-    return { success: true, data: void 0, affectedCells };
+    return { success: true, data: { cellCount }, affectedCells };
   } catch (e) {
     return {
       success: false,
@@ -79911,6 +79405,10 @@ async function clearRange2(ctx, sheetId, range2) {
 init_esm_shims();
 init_a1();
 init_value_conversions();
+import {
+  NumberFormatCategory,
+  RangeValueType as RangeValueType2
+} from "@mog-sdk/spreadsheet-contracts/api";
 async function clearWithMode(ctx, sheetId, range2, applyTo = "all") {
   const n = normalizeRange(range2);
   const promises = [];
@@ -79930,6 +79428,8 @@ async function clearWithMode(ctx, sheetId, range2, applyTo = "all") {
     promises.push(clearHyperlinksInRange(ctx, sheetId, n));
   }
   await Promise.all(promises);
+  const cellCount = (n.endRow - n.startRow + 1) * (n.endCol - n.startCol + 1);
+  return { cellCount };
 }
 async function clearHyperlinksInRange(ctx, sheetId, range2) {
   const rangeResult = await ctx.computeBridge.queryRange(
@@ -80008,7 +79508,7 @@ async function getValueTypes(ctx, sheetId, range2) {
     for (let col = n.startCol; col <= n.endCol; col++) {
       const cell = cellMap.get(`${row},${col}`);
       if (!cell) {
-        rowData.push("Empty" /* Empty */);
+        rowData.push(RangeValueType2.Empty);
       } else {
         rowData.push(classifyValueType(viewportCellValueToCellValue(cell.value)));
       }
@@ -80018,12 +79518,12 @@ async function getValueTypes(ctx, sheetId, range2) {
   return result;
 }
 function classifyValueType(value) {
-  if (value === null || value === void 0) return "Empty" /* Empty */;
-  if (typeof value === "string") return value === "" ? "Empty" /* Empty */ : "String" /* String */;
-  if (typeof value === "number") return "Double" /* Double */;
-  if (typeof value === "boolean") return "Boolean" /* Boolean */;
-  if (typeof value === "object" && value !== null && "type" in value) return "Error" /* Error */;
-  return "String" /* String */;
+  if (value === null || value === void 0) return RangeValueType2.Empty;
+  if (typeof value === "string") return value === "" ? RangeValueType2.Empty : RangeValueType2.String;
+  if (typeof value === "number") return RangeValueType2.Double;
+  if (typeof value === "boolean") return RangeValueType2.Boolean;
+  if (typeof value === "object" && value !== null && "type" in value) return RangeValueType2.Error;
+  return RangeValueType2.String;
 }
 async function findInRange(ctx, sheetId, range2, text, options) {
   const n = normalizeRange(range2);
@@ -80048,7 +79548,7 @@ async function findInRange(ctx, sheetId, range2, text, options) {
     const valueStr = cell.formatted ?? viewportCellValueToString(cell.value);
     if (pattern.test(valueStr)) {
       return {
-        address: `${colToLetter2(cell.col)}${cell.row + 1}`,
+        address: `${colToLetter3(cell.col)}${cell.row + 1}`,
         value: valueStr
       };
     }
@@ -80120,46 +79620,46 @@ async function getNumberFormatCategories(ctx, sheetId, range2) {
 }
 function detectFormatType(formatCode) {
   if (!formatCode || formatCode === "" || formatCode === "General") {
-    return "General" /* General */;
+    return NumberFormatCategory.General;
   }
   if (formatCode === "@") {
-    return "Text" /* Text */;
+    return NumberFormatCategory.Text;
   }
   const stripped = formatCode.replace(/\[[^\]]*\]/g, "").replace(/"[^"]*"/g, "");
   if (/[yYmMdD]/.test(stripped) && /[yYdD]/.test(stripped)) {
-    return "Date" /* Date */;
+    return NumberFormatCategory.Date;
   }
   if (/[hHsS]/.test(stripped)) {
     if (/[yYdD]/.test(stripped)) {
-      return "Date" /* Date */;
+      return NumberFormatCategory.Date;
     }
-    return "Time" /* Time */;
+    return NumberFormatCategory.Time;
   }
   if (/AM\/PM/i.test(stripped)) {
-    return "Time" /* Time */;
+    return NumberFormatCategory.Time;
   }
   if (stripped.includes("%")) {
-    return "Percentage" /* Percentage */;
+    return NumberFormatCategory.Percentage;
   }
   if (/[eE][+-]/.test(stripped)) {
-    return "Scientific" /* Scientific */;
+    return NumberFormatCategory.Scientific;
   }
   if (stripped.includes("/") && !/[yYmMdDhHsS]/.test(stripped)) {
-    return "Fraction" /* Fraction */;
+    return NumberFormatCategory.Fraction;
   }
   if (/[_*]/.test(stripped) && /[$(]/.test(stripped)) {
-    return "Accounting" /* Accounting */;
+    return NumberFormatCategory.Accounting;
   }
   if (/[$€£¥₹]/.test(formatCode)) {
-    return "Currency" /* Currency */;
+    return NumberFormatCategory.Currency;
   }
   if (/^0{5}/.test(stripped) || /^0{3}-0{2}-0{4}/.test(stripped)) {
-    return "Special" /* Special */;
+    return NumberFormatCategory.Special;
   }
   if (/[#0]/.test(stripped)) {
-    return "Number" /* Number */;
+    return NumberFormatCategory.Number;
   }
-  return "Custom" /* Custom */;
+  return NumberFormatCategory.Custom;
 }
 
 // ../../kernel/src/api/worksheet/operations/sort-operations.ts
@@ -80935,6 +80435,84 @@ var WorksheetBindingsImpl = class {
   }
 };
 
+// ../../kernel/src/api/worksheet/index.ts
+init_change_accumulator();
+
+// ../../kernel/src/api/worksheet/changes.ts
+init_esm_shims();
+function parseRangeScope(scope) {
+  const match = scope.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
+  if (!match) return null;
+  const startCol = letterToCol2(match[1].toUpperCase());
+  const startRow = parseInt(match[2], 10) - 1;
+  const endCol = letterToCol2(match[3].toUpperCase());
+  const endRow = parseInt(match[4], 10) - 1;
+  return { startRow, startCol, endRow, endCol };
+}
+function letterToCol2(letters) {
+  let col = 0;
+  for (let i = 0; i < letters.length; i++) {
+    col = col * 26 + (letters.charCodeAt(i) - 64);
+  }
+  return col - 1;
+}
+var ChangeTrackerImpl = class {
+  constructor(sheetId, options, unregister) {
+    this._active = true;
+    this.buffer = [];
+    this.sheetId = sheetId;
+    this.unregister = unregister;
+    this.scopeBounds = options?.scope ? parseRangeScope(options.scope) : null;
+    this.excludeOrigins = options?.excludeOrigins && options.excludeOrigins.length > 0 ? new Set(options.excludeOrigins) : null;
+  }
+  // --- TrackerHandle (called by ChangeAccumulator) ---
+  _ingest(records) {
+    if (!this._active) return;
+    for (const record of records) {
+      if (this.excludeOrigins?.has(record.origin)) continue;
+      if (this.scopeBounds) {
+        const { startRow, startCol, endRow, endCol } = this.scopeBounds;
+        if (record.row < startRow || record.row > endRow || record.col < startCol || record.col > endCol) {
+          continue;
+        }
+      }
+      this.buffer.push(record);
+    }
+  }
+  // --- ChangeTracker public API ---
+  collect() {
+    const result = this.buffer;
+    this.buffer = [];
+    return result;
+  }
+  close() {
+    if (!this._active) return;
+    this._active = false;
+    this.buffer = [];
+    this.unregister();
+  }
+  get active() {
+    return this._active;
+  }
+};
+var WorksheetChangesImpl = class {
+  constructor(ctx, sheetId) {
+    this.ctx = ctx;
+    this.sheetId = sheetId;
+  }
+  track(options) {
+    const accumulator = this.ctx.computeBridge.getMutationHandler()?.changeAccumulator;
+    if (!accumulator) {
+      throw new Error("Change tracking unavailable: MutationResultHandler not initialized");
+    }
+    const tracker = new ChangeTrackerImpl(this.sheetId, options, () => {
+      accumulator.unregister(tracker);
+    });
+    accumulator.register(tracker);
+    return tracker;
+  }
+};
+
 // ../../kernel/src/api/worksheet/charts.ts
 init_esm_shims();
 function buildStatisticalExtra(config) {
@@ -81364,7 +80942,7 @@ function cellRefToA1(cellRef) {
   const col = parseInt(parts[0], 10);
   const row = parseInt(parts[1], 10);
   if (isNaN(col) || isNaN(row)) return cellRef;
-  return toA1(row, col);
+  return toA12(row, col);
 }
 function toApiComment(c) {
   const text = c.content ?? c.runs.map((r) => r.text).join("");
@@ -81465,7 +81043,7 @@ var WorksheetCommentsImpl = class {
     return {
       content,
       author: first.author,
-      cellAddress: toA1(row, col)
+      cellAddress: toA12(row, col)
     };
   }
   async removeNote(a, b) {
@@ -81808,7 +81386,7 @@ var WorksheetFiltersImpl = class {
       }
     }
     return {
-      range: `${toA1(filter.startRow ?? 0, filter.startCol ?? 0)}:${toA1(filter.endRow ?? 0, filter.endCol ?? 0)}`,
+      range: `${toA12(filter.startRow ?? 0, filter.startCol ?? 0)}:${toA12(filter.endRow ?? 0, filter.endCol ?? 0)}`,
       columns
     };
   }
@@ -82183,7 +81761,12 @@ var WorksheetFormatsImpl = class {
       col = b;
       format = c;
     }
-    await this.ctx.computeBridge.setFormatForRanges(this.sheetId, [[row, col, row, col]], format);
+    const result = await this.ctx.computeBridge.setFormatForRanges(
+      this.sheetId,
+      [[row, col, row, col]],
+      format
+    );
+    return { cellCount: result.propertyChanges?.length ?? 0 };
   }
   async setRange(a, b) {
     let range2;
@@ -82195,11 +81778,12 @@ var WorksheetFormatsImpl = class {
       range2 = a;
     }
     const n = normalizeRange(range2);
-    await this.ctx.computeBridge.setFormatForRanges(
+    const result = await this.ctx.computeBridge.setFormatForRanges(
       this.sheetId,
       [[n.startRow, n.startCol, n.endRow, n.endCol]],
       b
     );
+    return { cellCount: result.propertyChanges?.length ?? 0 };
   }
   async setRanges(ranges, format) {
     const boundedRanges = [];
@@ -82230,9 +81814,11 @@ var WorksheetFormatsImpl = class {
   }
   async get(a, b) {
     const { row, col } = resolveCell(a, b);
-    const result = await this.ctx.computeBridge.queryRange(this.sheetId, row, col, row, col);
-    if (!result?.cells || result.cells.length === 0) return null;
-    return result.cells[0]?.format ?? null;
+    return this.ctx.computeBridge.getResolvedFormat(
+      this.sheetId,
+      row,
+      col
+    );
   }
   async adjustIndent(a, b, c) {
     let row, col, amount;
@@ -82256,7 +81842,8 @@ var WorksheetFormatsImpl = class {
   async clearFill(a, b) {
     const { row, col } = resolveCell(a, b);
     const rangeTuple = [row, col, row, col];
-    const current = await this.get(row, col);
+    const result = await this.ctx.computeBridge.queryRange(this.sheetId, row, col, row, col);
+    const current = result?.cells?.[0]?.format ?? null;
     await this.ctx.computeBridge.clearFormatForRanges(this.sheetId, [rangeTuple]);
     if (current) {
       const { backgroundColor, patternType, patternForegroundColor, gradientFill, ...rest } = current;
@@ -83016,8 +82603,8 @@ init_esm_shims();
 init_errors();
 function formatDataSource(sourceSheetName, sourceRange) {
   if (!sourceRange) return "";
-  const start = toA1(sourceRange.startRow, sourceRange.startCol);
-  const end = toA1(sourceRange.endRow, sourceRange.endCol);
+  const start = toA12(sourceRange.startRow, sourceRange.startCol);
+  const end = toA12(sourceRange.endRow, sourceRange.endCol);
   const sheetRef = sourceSheetName ?? "Unknown";
   const needsQuotes = /[^A-Za-z0-9_]/.test(sheetRef);
   const quotedSheet = needsQuotes ? `'${sheetRef}'` : sheetRef;
@@ -83109,7 +82696,7 @@ var WorksheetPivotsImpl = class _WorksheetPivotsImpl {
     }
     return pivots.map((p) => {
       const apiConfig = dataConfigToApiConfig(p, p.sourceSheetName);
-      const location = p.outputLocation ? toA1(p.outputLocation.row, p.outputLocation.col) : void 0;
+      const location = p.outputLocation ? toA12(p.outputLocation.row, p.outputLocation.col) : void 0;
       return {
         name: p.name ?? p.id,
         dataSource: apiConfig.dataSource,
@@ -83630,7 +83217,7 @@ init_errors();
 
 // ../../kernel/src/api/worksheet/operations/sheet-management-operations.ts
 init_esm_shims();
-init_protection();
+import { DEFAULT_PROTECTION_OPTIONS as DEFAULT_PROTECTION_OPTIONS2 } from "@mog-sdk/spreadsheet-contracts/protection";
 function parseCellRef2(ref) {
   const match = ref.match(/^([A-Z]+)(\d+)$/i);
   if (!match) return null;
@@ -83642,7 +83229,7 @@ function parseCellRef2(ref) {
   }
   return { row: rowNum - 1, col: col - 1 };
 }
-function colToLetter4(col) {
+function colToLetter5(col) {
   let result = "";
   let c = col;
   while (c >= 0) {
@@ -83652,8 +83239,8 @@ function colToLetter4(col) {
   return result;
 }
 function printRangeToA1(range2) {
-  const startRef = `${colToLetter4(range2.startCol)}${range2.startRow + 1}`;
-  const endRef = `${colToLetter4(range2.endCol)}${range2.endRow + 1}`;
+  const startRef = `${colToLetter5(range2.startCol)}${range2.startRow + 1}`;
+  const endRef = `${colToLetter5(range2.endCol)}${range2.endRow + 1}`;
   return `${startRef}:${endRef}`;
 }
 async function getPageBreaks(ctx, sheetId) {
@@ -84053,7 +83640,11 @@ var WorksheetSlicersImpl = class {
     this.sheetId = sheetId;
   }
   async add(config) {
-    const storedConfig = config;
+    const caption = config.caption ?? config.name ?? "";
+    const storedConfig = {
+      ...config,
+      caption
+    };
     await this.ctx.computeBridge.createSlicer(this.sheetId, storedConfig);
     return storedConfig.id ?? "";
   }
@@ -84767,7 +84358,7 @@ var WorksheetStructureImpl = class {
   async getMergedRegions() {
     const regions = await getAll3(this.ctx, this.sheetId);
     return regions.map((r) => ({
-      range: `${toA1(r.startRow, r.startCol)}:${toA1(r.endRow, r.endCol)}`,
+      range: `${toA12(r.startRow, r.startCol)}:${toA12(r.endRow, r.endCol)}`,
       startRow: r.startRow,
       startCol: r.startCol,
       endRow: r.endRow,
@@ -84830,8 +84421,8 @@ function parseA1Range(range2) {
   };
 }
 function bridgeTableToTableInfo(table) {
-  const startLetter = colToLetter2(table.range.startCol);
-  const endLetter = colToLetter2(table.range.endCol);
+  const startLetter = colToLetter3(table.range.startCol);
+  const endLetter = colToLetter3(table.range.endCol);
   const startRowA1 = table.range.startRow + 1;
   const endRowA1 = table.range.endRow + 1;
   const range2 = `${startLetter}${startRowA1}:${endLetter}${endRowA1}`;
@@ -84876,16 +84467,16 @@ function getDataBodyRangeFromInfo(table) {
   const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
   const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
   if (dataStartRow > dataEndRow) return null;
-  const startLetter = colToLetter2(parsed.startCol);
-  const endLetter = colToLetter2(parsed.endCol);
+  const startLetter = colToLetter3(parsed.startCol);
+  const endLetter = colToLetter3(parsed.endCol);
   return `${startLetter}${dataStartRow + 1}:${endLetter}${dataEndRow + 1}`;
 }
 function getHeaderRowRangeFromInfo(table) {
   if (!table.hasHeaders) return null;
   const parsed = parseA1Range(table.range);
   if (!parsed) return null;
-  const startLetter = colToLetter2(parsed.startCol);
-  const endLetter = colToLetter2(parsed.endCol);
+  const startLetter = colToLetter3(parsed.startCol);
+  const endLetter = colToLetter3(parsed.endCol);
   const headerRow = parsed.startRow + 1;
   return `${startLetter}${headerRow}:${endLetter}${headerRow}`;
 }
@@ -84893,8 +84484,8 @@ function getTotalRowRangeFromInfo(table) {
   if (!table.showTotals) return null;
   const parsed = parseA1Range(table.range);
   if (!parsed) return null;
-  const startLetter = colToLetter2(parsed.startCol);
-  const endLetter = colToLetter2(parsed.endCol);
+  const startLetter = colToLetter3(parsed.startCol);
+  const endLetter = colToLetter3(parsed.endCol);
   const totalRow = parsed.endRow + 1;
   return `${startLetter}${totalRow}:${endLetter}${totalRow}`;
 }
@@ -84937,9 +84528,9 @@ var WorksheetTablesImpl = class {
     if (!match) {
       throw new KernelError("COMPUTE_ERROR", `Invalid range: ${range2}`);
     }
-    const startCol = letterToCol2(match[1]);
+    const startCol = letterToCol3(match[1]);
     const startRow = parseInt(match[2], 10) - 1;
-    const endCol = letterToCol2(match[3]);
+    const endCol = letterToCol3(match[3]);
     const endRow = parseInt(match[4], 10) - 1;
     await this.ctx.computeBridge.createTable(
       this.sheetId,
@@ -85019,9 +84610,9 @@ var WorksheetTablesImpl = class {
     if (!parsed) {
       throw new KernelError("COMPUTE_ERROR", `Invalid table range: ${table.range}`);
     }
-    const startCol = letterToCol2(parsed[1]);
+    const startCol = letterToCol3(parsed[1]);
     const startRow = parseInt(parsed[2], 10) - 1;
-    const endCol = letterToCol2(parsed[3]);
+    const endCol = letterToCol3(parsed[3]);
     const endRow = parseInt(parsed[4], 10) - 1;
     const filter = await getFilterForRange(this.ctx, this.sheetId, {
       startRow,
@@ -85042,9 +84633,9 @@ var WorksheetTablesImpl = class {
     if (!match) {
       throw new KernelError("COMPUTE_ERROR", `Invalid range: ${newRange}`);
     }
-    const startCol = letterToCol2(match[1]);
+    const startCol = letterToCol3(match[1]);
     const startRow = parseInt(match[2], 10) - 1;
-    const endCol = letterToCol2(match[3]);
+    const endCol = letterToCol3(match[3]);
     const endRow = parseInt(match[4], 10) - 1;
     await this.ctx.computeBridge.resizeTable(name, startRow, startCol, endRow, endCol);
   }
@@ -85175,8 +84766,8 @@ var WorksheetTablesImpl = class {
     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;
-    const startLetter = colToLetter2(parsed.startCol);
-    const endLetter = colToLetter2(parsed.endCol);
+    const startLetter = colToLetter3(parsed.startCol);
+    const endLetter = colToLetter3(parsed.endCol);
     return `${startLetter}${absRow + 1}:${endLetter}${absRow + 1}`;
   }
   async getRowValues(tableName, index) {
@@ -85215,7 +84806,7 @@ var WorksheetTablesImpl = class {
     const dataStartRow = table.hasHeaders ? parsed.startRow + 1 : parsed.startRow;
     const dataEndRow = table.showTotals ? parsed.endRow - 1 : parsed.endRow;
     if (dataStartRow > dataEndRow) return null;
-    const letter = colToLetter2(col);
+    const letter = colToLetter3(col);
     return `${letter}${dataStartRow + 1}:${letter}${dataEndRow + 1}`;
   }
   async getColumnHeaderRange(tableName, columnIndex) {
@@ -85225,7 +84816,7 @@ var WorksheetTablesImpl = class {
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
-    const letter = colToLetter2(col);
+    const letter = colToLetter3(col);
     const headerRow = parsed.startRow + 1;
     return `${letter}${headerRow}`;
   }
@@ -85236,7 +84827,7 @@ var WorksheetTablesImpl = class {
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
-    const letter = colToLetter2(col);
+    const letter = colToLetter3(col);
     return `${letter}${parsed.startRow + 1}:${letter}${parsed.endRow + 1}`;
   }
   async getColumnTotalRange(tableName, columnIndex) {
@@ -85246,7 +84837,7 @@ var WorksheetTablesImpl = class {
     if (!parsed) return null;
     const col = parsed.startCol + columnIndex;
     if (col > parsed.endCol) return null;
-    const letter = colToLetter2(col);
+    const letter = colToLetter3(col);
     const totalRow = parsed.endRow + 1;
     return `${letter}${totalRow}`;
   }
@@ -85345,7 +84936,7 @@ var WorksheetTablesImpl = class {
   async sortClear(_tableName) {
   }
 };
-function letterToCol2(letters) {
+function letterToCol3(letters) {
   let col = 0;
   for (let i = 0; i < letters.length; i++) {
     col = col * 26 + (letters.toUpperCase().charCodeAt(i) - 64);
@@ -85356,9 +84947,9 @@ function parseA1Range2(range2) {
   const match = range2.match(/^([A-Z]+)(\d+):([A-Z]+)(\d+)$/i);
   if (!match) return null;
   return {
-    startCol: letterToCol2(match[1]),
+    startCol: letterToCol3(match[1]),
     startRow: parseInt(match[2], 10) - 1,
-    endCol: letterToCol2(match[3]),
+    endCol: letterToCol3(match[3]),
     endRow: parseInt(match[4], 10) - 1
   };
 }
@@ -85547,8 +85138,8 @@ function rangeSchemaToValidationRule(schema) {
     const start = parseRefIdSimple(ref.startId);
     const end = parseRefIdSimple(ref.endId);
     if (start && end) {
-      const startA1 = toA1(start.row, start.col);
-      const endA1 = toA1(end.row, end.col);
+      const startA1 = toA12(start.row, start.col);
+      const endA1 = toA12(end.row, end.col);
       range2 = startA1 === endA1 ? startA1 : `${startA1}:${endA1}`;
     }
   }
@@ -85581,8 +85172,8 @@ function rangeSchemaToValidationRule(schema) {
       const srcStart = parseRefIdSimple(src.startId);
       const srcEnd = parseRefIdSimple(src.endId);
       if (srcStart && srcEnd) {
-        const srcStartA1 = toA1(srcStart.row, srcStart.col);
-        const srcEndA1 = toA1(srcEnd.row, srcEnd.col);
+        const srcStartA1 = toA12(srcStart.row, srcStart.col);
+        const srcEndA1 = toA12(srcEnd.row, srcEnd.col);
         rule.listSource = srcStartA1 === srcEndA1 ? `=${srcStartA1}` : `=${srcStartA1}:${srcEndA1}`;
       }
     }
@@ -87799,11 +87390,12 @@ var WorksheetImpl = class {
     if (!result.success) {
       throw result.error;
     }
+    return result.data;
   }
   async clear(range2, applyTo) {
     const parsed = parseCellRange(range2);
     if (!parsed) throw new KernelError("COMPUTE_ERROR", `Invalid range: "${range2}"`);
-    await clearWithMode(
+    return clearWithMode(
       this.ctx,
       this.sheetId,
       { sheetId: this.sheetId, ...parsed },
@@ -87851,7 +87443,7 @@ var WorksheetImpl = class {
       format: format ?? void 0,
       hyperlink: hyperlink ?? void 0,
       isMerged: mergeInfo !== void 0,
-      mergedRegion: mergeInfo ? `${toA1(mergeInfo.startRow, mergeInfo.startCol)}:${toA1(mergeInfo.endRow, mergeInfo.endCol)}` : void 0
+      mergedRegion: mergeInfo ? `${toA12(mergeInfo.startRow, mergeInfo.startCol)}:${toA12(mergeInfo.endRow, mergeInfo.endCol)}` : void 0
     };
   }
   async getRawRangeData(range2, _includeFormula) {
@@ -87878,7 +87470,8 @@ var WorksheetImpl = class {
         } else {
           rowData.push({
             value: viewportCellValueToCellValue(vc.value) ?? null,
-            formula: vc.formula
+            formula: vc.formula,
+            format: vc.format ?? void 0
           });
         }
       }
@@ -87903,10 +87496,10 @@ var WorksheetImpl = class {
     const { row, col } = resolveCell(address);
     const data = await getCell(this.ctx, this.sheetId, row, col);
     if (!data) return "";
-    const rawValue = viewportCellValueToString(data.value);
-    let result = rawValue;
+    const displayValue = await getDisplayValue2(this.ctx, this.sheetId, row, col);
+    let result = displayValue;
     if (data.formula) {
-      result = rawValue !== "" ? `${rawValue}(${data.formula})` : `(${data.formula})`;
+      result = displayValue !== "" ? `${displayValue}(${data.formula})` : `(${data.formula})`;
     }
     const styleHintsStr = await getStyleHints(this.ctx, this.sheetId, row, col);
     if (styleHintsStr) {
@@ -87965,17 +87558,15 @@ var WorksheetImpl = class {
     }
     for (let row = parsed.startRow; row <= parsed.endRow; row++) {
       const rowValues = [];
-      let hasContent = false;
       for (let col = parsed.startCol; col <= parsed.endCol; col++) {
-        const cellAddr = toA1(row, col);
+        const cellAddr = toA12(row, col);
         const vc = cellMap.get(`${row},${col}`);
         if (!vc) {
           rowValues.push(`${cellAddr}:`);
           continue;
         }
-        const rawValue = viewportCellValueToString(vc.value);
-        let cellStr = rawValue;
-        hasContent = true;
+        const displayValue = vc.formatted ?? viewportCellValueToString(vc.value);
+        let cellStr = displayValue;
         if (vc.formula) {
           const abbreviation = formulaAnalysis.formulaToId.get(`${row},${col}`);
           if (abbreviation) {
@@ -87986,9 +87577,7 @@ var WorksheetImpl = class {
         }
         rowValues.push(`${cellAddr}:${cellStr}`);
       }
-      if (hasContent) {
-        outputParts.push(rowValues.join(" | "));
-      }
+      outputParts.push(rowValues.join(" | "));
     }
     const formulaDocs = generateFormulaDocumentation(formulaAnalysis);
     if (formulaDocs.length > 0) {
@@ -88077,8 +87666,8 @@ var WorksheetImpl = class {
     lines.push(`Sheet: ${meta.name}`);
     const bounds = await this.ctx.computeBridge.getDataBounds(this.sheetId);
     if (bounds) {
-      const startAddr = toA1(bounds.minRow, bounds.minCol);
-      const endAddr = toA1(bounds.maxRow, bounds.maxCol);
+      const startAddr = toA12(bounds.minRow, bounds.minCol);
+      const endAddr = toA12(bounds.maxRow, bounds.maxCol);
       lines.push(`Used Range: ${startAddr}:${endAddr}`);
       lines.push(
         `Dimensions: ${bounds.maxRow - bounds.minRow + 1} rows x ${bounds.maxCol - bounds.minCol + 1} columns`
@@ -88098,20 +87687,31 @@ var WorksheetImpl = class {
     const tables = await getTablesInSheet(this.ctx, this.sheetId);
     if (tables.length > 0) {
       const tableDescs = tables.map((t) => {
-        const r = `${toA1(t.range.startRow, t.range.startCol)}:${toA1(t.range.endRow, t.range.endCol)}`;
+        const r = `${toA12(t.range.startRow, t.range.startCol)}:${toA12(t.range.endRow, t.range.endCol)}`;
         return `${t.name} at ${r}`;
       });
       lines.push(`Tables: ${tables.length} (${tableDescs.join(", ")})`);
     }
-    const allNamedRanges = await getAll(this.ctx);
-    const sheetNamedRanges = allNamedRanges.filter((nr) => nr.scope === this.sheetId || !nr.scope);
-    if (sheetNamedRanges.length > 0) {
+    const allVisible = await getVisible(this.ctx);
+    const scoped = allVisible.filter((nr) => nr.scope === this.sheetId || !nr.scope);
+    const valid = scoped.filter((nr) => !nr.refersTo.template.includes("#REF!"));
+    const broken = scoped.length - valid.length;
+    if (valid.length > 0 || broken > 0) {
+      const toShow = valid.slice(0, MAX_SUMMARY_NAMED_RANGES);
       const nrDescs = [];
-      for (const nr of sheetNamedRanges) {
+      for (const nr of toShow) {
         const a1 = await getRefersToA1(this.ctx, nr);
         nrDescs.push(`${nr.name}=${a1}`);
       }
-      lines.push(`Named Ranges: ${sheetNamedRanges.length} (${nrDescs.join(", ")})`);
+      let label = `Named Ranges: ${valid.length}`;
+      if (broken > 0) label += ` valid, ${broken} broken (#REF!) omitted`;
+      if (nrDescs.length > 0) {
+        const showing = valid.length > MAX_SUMMARY_NAMED_RANGES ? `showing ${MAX_SUMMARY_NAMED_RANGES}: ` : "";
+        const more = valid.length > MAX_SUMMARY_NAMED_RANGES ? ` \u2014 ${valid.length - MAX_SUMMARY_NAMED_RANGES} more not shown` : "";
+        lines.push(`${label} (${showing}${nrDescs.join(", ")})${more}`);
+      } else {
+        lines.push(label);
+      }
     }
     const maxRows = options?.maxRows;
     const maxCols = options?.maxCols;
@@ -88141,9 +87741,7 @@ var WorksheetImpl = class {
       }
       const firstRowCells = (rowMap.get(finalRange.startRow) ?? []).slice().sort((a, b) => a.col - b.col);
       if (firstRowCells.length > 0) {
-        const allStrings = firstRowCells.every(
-          (vc) => typeof vc.value === "string" && !vc.formula
-        );
+        const allStrings = firstRowCells.every((vc) => typeof vc.value === "string" && !vc.formula);
         if (allStrings) {
           const headers = firstRowCells.map((vc) => String(vc.value));
           lines.push(`Headers: ${headers.join(", ")}`);
@@ -88180,7 +87778,7 @@ var WorksheetImpl = class {
         const rowData = [];
         for (const vc of cells) {
           const rawValue = viewportCellValueToString(vc.value);
-          const addr = toA1(vc.row, vc.col);
+          const addr = toA12(vc.row, vc.col);
           if (vc.formula) {
             rowData.push(`${addr}:${rawValue}(=${vc.formula})`);
           } else {
@@ -88204,7 +87802,7 @@ var WorksheetImpl = class {
   async getUsedRange() {
     const range2 = await getUsedRange2(this.ctx, this.sheetId);
     if (!range2) return null;
-    return `${toA1(range2.startRow, range2.startCol)}:${toA1(range2.endRow, range2.endCol)}`;
+    return `${toA12(range2.startRow, range2.startCol)}:${toA12(range2.endRow, range2.endCol)}`;
   }
   async getCurrentRegion(row, col) {
     return getCurrentRegion(this.ctx, this.sheetId, row, col);
@@ -88214,15 +87812,15 @@ var WorksheetImpl = class {
   }
   async findCells(predicate) {
     const addresses = await findCells(this.ctx, this.sheetId, predicate);
-    return addresses.map((a) => toA1(a.row, a.col));
+    return addresses.map((a) => toA12(a.row, a.col));
   }
   async findByValue(value) {
     const addresses = await findByValue(this.ctx, this.sheetId, value);
-    return addresses.map((a) => toA1(a.row, a.col));
+    return addresses.map((a) => toA12(a.row, a.col));
   }
   async findByFormula(pattern) {
     const addresses = await findByFormula(this.ctx, this.sheetId, pattern);
-    return addresses.map((a) => toA1(a.row, a.col));
+    return addresses.map((a) => toA12(a.row, a.col));
   }
   async regexSearch(patterns, options) {
     const results = await regexSearch(this.ctx, this.sheetId, patterns, {
@@ -88361,7 +87959,7 @@ var WorksheetImpl = class {
     await this.setRange(start.row, start.col, allRows);
     const endRow = start.row + allRows.length - 1;
     const endCol = start.col + headers.length - 1;
-    const rangeA1 = `${toA1(start.row, start.col)}:${toA1(endRow, endCol)}`;
+    const rangeA1 = `${toA12(start.row, start.col)}:${toA12(endRow, endCol)}`;
     await this.tables.add(rangeA1, { name, hasHeaders: true });
   }
   // ===========================================================================
@@ -88604,7 +88202,7 @@ var WorksheetImpl = class {
         case 1:
           return accessor.numberValue;
         case 2:
-          return displayStringOrNull(accessor.displayText);
+          return displayStringOrNull3(accessor.displayText);
         case 3:
           return accessor.numberValue !== 0;
         case 4: {
@@ -88754,6 +88352,9 @@ var WorksheetImpl = class {
     }
     return this._cellMetadata;
   }
+  get changes() {
+    return this._changes ??= new WorksheetChangesImpl(this.ctx, this.sheetId);
+  }
   get formats() {
     return this._formats ??= new WorksheetFormatsImpl(this.ctx, this.sheetId);
   }
@@ -89225,7 +88826,7 @@ var WorkbookThemeImpl = class {
 
 // ../../kernel/src/api/workbook/workbook-impl.ts
 init_esm_shims();
-init_disposable2();
+init_disposable();
 init_errors();
 
 // ../../kernel/src/domain/form-controls/index.ts
@@ -89812,26 +89413,7 @@ var globalRegistry = new FunctionRegistry();
 
 // ../../spreadsheet-utils/src/function-catalog.ts
 init_esm_shims();
-
-// ../../contracts/src/utils/function-registry.ts
-init_esm_shims();
-var FunctionCategory = /* @__PURE__ */ ((FunctionCategory2) => {
-  FunctionCategory2["MATH"] = "Math";
-  FunctionCategory2["STATISTICAL"] = "Statistical";
-  FunctionCategory2["TEXT"] = "Text";
-  FunctionCategory2["LOGICAL"] = "Logical";
-  FunctionCategory2["DATE_TIME"] = "Date & Time";
-  FunctionCategory2["LOOKUP"] = "Lookup & Reference";
-  FunctionCategory2["FINANCIAL"] = "Financial";
-  FunctionCategory2["INFORMATION"] = "Information";
-  FunctionCategory2["DATABASE"] = "Database";
-  FunctionCategory2["ENGINEERING"] = "Engineering";
-  FunctionCategory2["WEB"] = "Web";
-  FunctionCategory2["TESTING"] = "Testing";
-  return FunctionCategory2;
-})(FunctionCategory || {});
-
-// ../../spreadsheet-utils/src/function-catalog.ts
+import { FunctionCategory } from "@mog-sdk/spreadsheet-contracts/utils/function-registry";
 var C = FunctionCategory;
 var INLINE_FUNCTIONS = [
   // Aggregates
@@ -90698,7 +90280,7 @@ function convertToFunctionInfo(metadata) {
 
 // ../../kernel/src/api/workbook/viewport.ts
 init_esm_shims();
-init_disposable2();
+init_disposable();
 var regionCounter = 0;
 var ViewportRegionImpl = class extends DisposableBase {
   constructor(sheetId, bounds, computeBridge, viewportId) {
@@ -90752,7 +90334,7 @@ var WorkbookViewportImpl = class {
 };
 
 // ../../kernel/src/api/workbook/workbook-impl.ts
-init_rendering();
+import { DEFAULT_CHROME_THEME } from "@mog-sdk/spreadsheet-contracts/rendering";
 var API_EVENT_TO_INTERNAL = {
   cellChanged: "cell:changed",
   rangeChanged: "range:changed",
@@ -91087,6 +90669,34 @@ var WorkbookImpl = class {
       calculationSettings: calcSettings
     });
   }
+  async getIterativeCalculation() {
+    const settings = await this.ctx.computeBridge.getWorkbookSettings();
+    return settings.calculationSettings?.enableIterativeCalculation ?? false;
+  }
+  async setIterativeCalculation(enabled) {
+    const settings = await this.ctx.computeBridge.getWorkbookSettings();
+    const calcSettings = {
+      ...settings.calculationSettings ?? {},
+      enableIterativeCalculation: enabled
+    };
+    await this.ctx.computeBridge.patchWorkbookSettings({
+      calculationSettings: calcSettings
+    });
+  }
+  async setMaxIterations(n) {
+    const settings = await this.ctx.computeBridge.getWorkbookSettings();
+    const calcSettings = { ...settings.calculationSettings ?? {}, maxIterations: n };
+    await this.ctx.computeBridge.patchWorkbookSettings({
+      calculationSettings: calcSettings
+    });
+  }
+  async setConvergenceThreshold(threshold) {
+    const settings = await this.ctx.computeBridge.getWorkbookSettings();
+    const calcSettings = { ...settings.calculationSettings ?? {}, maxChange: threshold };
+    await this.ctx.computeBridge.patchWorkbookSettings({
+      calculationSettings: calcSettings
+    });
+  }
   async getUsePrecisionAsDisplayed() {
     const settings = await this.ctx.computeBridge.getWorkbookSettings();
     return !(settings.calculationSettings?.fullPrecision ?? true);
@@ -91246,7 +90856,7 @@ var WorkbookImpl = class {
   // Utilities (sync)
   // ===========================================================================
   indexToAddress(row, col) {
-    return toA1(row, col);
+    return toA12(row, col);
   }
   addressToIndex(address) {
     const parsed = parseCellAddress(address);
@@ -91498,6 +91108,7 @@ var api_spec_default = {
     },
     ws: {
       smartArt: "WorksheetSmartArt",
+      changes: "WorksheetChanges",
       formats: "WorksheetFormats",
       layout: "WorksheetLayout",
       view: "WorksheetView",
@@ -91609,6 +91220,26 @@ var api_spec_default = {
           docstring: "Set the calculation mode.\nConvenience mutator \u2014 patches `calculationSettings.calcMode`.",
           usedTypes: []
         },
+        getIterativeCalculation: {
+          signature: "getIterativeCalculation(): Promise<boolean>;",
+          docstring: "Get whether iterative calculation is enabled for circular references.\nConvenience accessor \u2014 equivalent to `(await getSettings()).calculationSettings.enableIterativeCalculation`.",
+          usedTypes: []
+        },
+        setIterativeCalculation: {
+          signature: "setIterativeCalculation(enabled: boolean): Promise<void>;",
+          docstring: "Set whether iterative calculation is enabled for circular references.\nConvenience mutator \u2014 patches `calculationSettings.enableIterativeCalculation`.",
+          usedTypes: []
+        },
+        setMaxIterations: {
+          signature: "setMaxIterations(n: number): Promise<void>;",
+          docstring: "Set the maximum number of iterations for iterative calculation.\nConvenience mutator \u2014 patches `calculationSettings.maxIterations`.",
+          usedTypes: []
+        },
+        setConvergenceThreshold: {
+          signature: "setConvergenceThreshold(threshold: number): Promise<void>;",
+          docstring: "Set the convergence threshold (maximum change) for iterative calculation.\nConvenience mutator \u2014 patches `calculationSettings.maxChange`.",
+          usedTypes: []
+        },
         getUsePrecisionAsDisplayed: {
           signature: "getUsePrecisionAsDisplayed(): Promise<boolean>;",
           docstring: "Whether to use displayed precision instead of full (15-digit) precision.\nConvenience accessor \u2014 inverted from `calculationSettings.fullPrecision`.",
@@ -91820,18 +91451,21 @@ var api_spec_default = {
           usedTypes: []
         },
         clearData: {
-          signature: "clearData(range: string): Promise<void>;",
+          signature: "clearData(range: string): Promise<ClearResult>;",
           docstring: 'Clear all cell data (values and formulas) in a range (A1 notation, e.g. "A1:C3").',
-          usedTypes: []
+          usedTypes: [
+            "ClearResult"
+          ]
         },
         clear: {
-          signature: "clear(range: string, applyTo?: ClearApplyTo): Promise<void>;",
+          signature: "clear(range: string, applyTo?: ClearApplyTo): Promise<ClearResult>;",
           docstring: `Unified clear with mode selection (OfficeJS Range.clear equivalent).
 
 @param range - A1 range string (e.g. "A1:C3")
 @param applyTo - What to clear: 'all' (default), 'contents', 'formats', 'hyperlinks'`,
           usedTypes: [
-            "ClearApplyTo"
+            "ClearApplyTo",
+            "ClearResult"
           ]
         },
         getValue: {
@@ -92710,21 +92344,36 @@ var api_spec_default = {
         }
       }
     },
+    WorksheetChanges: {
+      docstring: "Sub-API for opt-in change tracking on a worksheet.",
+      functions: {
+        track: {
+          signature: "track(options?: ChangeTrackOptions): ChangeTracker;",
+          docstring: "Create a change tracker that accumulates cell-level change records\nfrom this point forward.\n\n@param options - Optional scope and origin filters\n@returns A ChangeTracker handle \u2014 call collect() to drain, close() when done",
+          usedTypes: [
+            "ChangeTrackOptions",
+            "ChangeTracker"
+          ]
+        }
+      }
+    },
     WorksheetFormats: {
       docstring: "Sub-API for cell formatting operations on a worksheet.",
       functions: {
         set: {
-          signature: "set(address: string, format: CellFormat): Promise<void>;",
+          signature: "set(address: string, format: CellFormat): Promise<FormatChangeResult>;",
           docstring: 'Set format for a single cell.\n\n@param address - A1-style cell address (e.g. "A1", "B3")\n@param format - Format properties to apply',
           usedTypes: [
-            "CellFormat"
+            "CellFormat",
+            "FormatChangeResult"
           ]
         },
         setRange: {
-          signature: "setRange(range: string, format: CellFormat): Promise<void>;",
+          signature: "setRange(range: string, format: CellFormat): Promise<FormatChangeResult>;",
           docstring: 'Set format for a contiguous range.\n\n@param range - A1-style range string (e.g. "A1:B2")\n@param format - Format properties to apply',
           usedTypes: [
-            "CellFormat"
+            "CellFormat",
+            "FormatChangeResult"
           ]
         },
         setRanges: {
@@ -92741,10 +92390,10 @@ var api_spec_default = {
           usedTypes: []
         },
         get: {
-          signature: "get(address: string): Promise<CellFormat | null>;",
-          docstring: "Get the format of a single cell.\n\n@param address - A1-style cell address\n@returns The cell format, or null if no format is set",
+          signature: "get(address: string): Promise<ResolvedCellFormat>;",
+          docstring: "Get the fully-resolved format of a single cell.\n\nReturns a dense CellFormat with all fields present (null for unset properties,\nnever undefined). Includes the full cascade (default \u2192 col \u2192 row \u2192 table \u2192 cell \u2192 CF)\nwith theme colors resolved to hex.\n\n@param address - A1-style cell address\n@returns The resolved cell format (always an object, never null)",
           usedTypes: [
-            "CellFormat"
+            "ResolvedCellFormat"
           ]
         },
         adjustIndent: {
@@ -93553,7 +93202,7 @@ var api_spec_default = {
           usedTypes: []
         },
         setCriteria: {
-          signature: "setCriteria(\n    filterId: string,\n    col: number,\n    criteria: ColumnFilterCriteria,\n  ): Promise<void>;",
+          signature: "setCriteria(filterId: string, col: number, criteria: ColumnFilterCriteria): Promise<void>;",
           docstring: "Set filter criteria for a column using filter ID.\n\n@param filterId - Filter ID\n@param col - Column index (0-based)\n@param criteria - Filter criteria to apply",
           usedTypes: [
             "ColumnFilterCriteria"
@@ -94871,6 +94520,11 @@ var api_spec_default = {
       definition: "'standard' | 'stacked' | 'percentStacked'",
       docstring: ""
     },
+    AutoFillChange: {
+      name: "AutoFillChange",
+      definition: "{\n  row: number;\n  col: number;\n  type: 'value' | 'formula' | 'format' | 'clear';\n}",
+      docstring: "A single cell change produced by the fill engine."
+    },
     AutoFillMode: {
       name: "AutoFillMode",
       definition: "| 'auto' // Detect pattern automatically (default)\n  | 'copy' // Always copy (no series)\n  | 'series' // Force series interpretation\n  | 'days' // Force date unit: days\n  | 'weekdays' // Force date unit: weekdays\n  | 'months' // Force date unit: months\n  | 'years' // Force date unit: years\n  | 'formats' // Copy formats only\n  | 'values' // Copy values only (no formats)\n  | 'withoutFormats' // Copy values + formulas, skip formats\n  | 'linearTrend' // Force linear regression trend\n  | 'growthTrend'",
@@ -94878,7 +94532,7 @@ var api_spec_default = {
     },
     AutoFillResult: {
       name: "AutoFillResult",
-      definition: "{\n  /** The pattern that was detected (or forced by mode) */\n  patternType: FillPatternType;\n  /** Number of cells that were filled */\n  filledCellCount: number;\n  /** Any warnings generated during fill */\n  warnings: AutoFillWarning[];\n}",
+      definition: "{\n  /** The pattern that was detected (or forced by mode) */\n  patternType: FillPatternType;\n  /** Number of cells that were filled */\n  filledCellCount: number;\n  /** Any warnings generated during fill */\n  warnings: AutoFillWarning[];\n  /** Per-cell changes listing each cell written */\n  changes: AutoFillChange[];\n}",
       docstring: "Result from autoFill() \u2014 summary of what the fill engine did."
     },
     AutoFillWarning: {
@@ -95225,6 +94879,37 @@ Example: { ignoreError: true } to suppress error indicators. */
       definition: "{\n  /** If true, value is treated as a formula (prefixed with =) */\n  asFormula?: boolean;\n}",
       docstring: "Options controlling how a cell value is interpreted when written."
     },
+    ChangeOrigin: {
+      name: "ChangeOrigin",
+      definition: "'direct' | 'cascade' | 'remote'",
+      docstring: "Origin of a change: direct write, formula recalculation, or remote collaborator."
+    },
+    ChangeRecord: {
+      name: "ChangeRecord",
+      definition: `{
+  /** Cell address in A1 notation (e.g. "B1"). */
+  address: string;
+  /** 0-based row index. */
+  row: number;
+  /** 0-based column index. */
+  col: number;
+  /** What caused this change. */
+  origin: ChangeOrigin;
+  /** Type of change. */
+  type: 'modified';
+}`,
+      docstring: "WorksheetChanges \u2014 Sub-API for opt-in change tracking.\n\nCreates lightweight trackers that accumulate cell-level change records\nacross mutations. Trackers are opt-in to avoid bloating return values;\nthey return addresses + metadata only (no cell values) so callers can\nhydrate via getRange() when needed.\n\nInspired by:\n- Excel OfficeJS onChanged (lightweight payload + lazy hydration)\n- Firestore onSnapshot (query-scoped subscriptions)\n- Yjs transaction.origin (source/origin tagging for collab)"
+    },
+    ChangeTrackOptions: {
+      name: "ChangeTrackOptions",
+      definition: '{\n  /** Only track changes within this range (A1 notation, e.g. "A1:Z100"). Omit for whole-sheet. */\n  scope?: string;\n  /** Exclude changes from these origin types. */\n  excludeOrigins?: ChangeOrigin[];\n}',
+      docstring: "Options for creating a change tracker."
+    },
+    ChangeTracker: {
+      name: "ChangeTracker",
+      definition: "{\n  /** Drain all accumulated changes since creation or last collect() call.\nReturns addresses + metadata only (no cell values) \u2014 call ws.getRange()\nto hydrate if needed. */\n  collect(): ChangeRecord[];;\n  /** Stop tracking and release internal resources. */\n  close(): void;;\n  /** Whether this tracker is still active (not closed). */\n  active: boolean;\n}",
+      docstring: "A handle that accumulates change records across mutations."
+    },
     Chart: {
       name: "Chart",
       definition: "{\n  id: string;\n  sheetId?: string;\n  createdAt?: number;\n  updatedAt?: number;\n}",
@@ -95359,6 +95044,11 @@ that are stored on the chart but not part of the core config schema. */
       definition: "'all' | 'contents' | 'formats' | 'hyperlinks'",
       docstring: "Determines which aspects of a range to clear.\nMatches OfficeJS Excel.ClearApplyTo enum."
     },
+    ClearResult: {
+      name: "ClearResult",
+      definition: "{\n  /** Number of cells in the cleared range. */\n  cellCount: number;\n}",
+      docstring: "Confirmation returned by clearData() and clear()."
+    },
     CodeResult: {
       name: "CodeResult",
       definition: "{\n  /** Whether execution completed successfully */\n  success: boolean;\n  /** Captured console output */\n  output?: string;\n  /** Error message (if success is false) */\n  error?: string;\n  /** Execution duration in milliseconds */\n  duration?: number;\n}",
@@ -95572,6 +95262,11 @@ Used in condition filters where users specify rules like
       definition: "| 'shape'\n  | 'connector'\n  | 'picture'\n  | 'textbox'\n  | 'chart'\n  | 'camera'\n  | 'equation'\n  | 'smartart'\n  | 'drawing'\n  | 'oleObject'\n  | 'formControl'\n  | 'slicer'\n  | 'wordart'",
       docstring: "Type discriminator for floating objects. Superset of Rust FloatingObjectKind (12 variants) + legacy TS-only 'wordart'."
     },
+    FormatChangeResult: {
+      name: "FormatChangeResult",
+      definition: "{\n  /** Number of cells whose formatting was changed */\n  cellCount: number;\n}",
+      docstring: "Result of a format set/setRange operation."
+    },
     FormatEntry: {
       name: "FormatEntry",
       definition: '{\n  /** Cell value descriptor */\n  value: { type: string; value?: unknown };\n  /** Number format code (e.g., "#,##0.00") */\n  formatCode: string;\n}',
@@ -95940,6 +95635,11 @@ Used in condition filters where users specify rules like
       definition: "{\n  /** Number of duplicate rows removed */\n  removedCount: number;\n  /** Number of unique rows remaining */\n  remainingCount: number;\n}",
       docstring: "Result of a remove-duplicates operation."
     },
+    ResolvedCellFormat: {
+      name: "ResolvedCellFormat",
+      definition: "{\n  [K in keyof CellFormat]-?: CellFormat[K] | null;\n}",
+      docstring: "Dense cell format where every property is explicitly present (null when unset). Returned by formats.get()."
+    },
     RichTextSegment: {
       name: "RichTextSegment",
       definition: "{\n  text: string;\n  bold?: boolean;\n  italic?: boolean;\n  underline?: boolean;\n  strikethrough?: boolean;\n  color?: string;\n  fontName?: string;\n  fontSize?: number;\n}",
@@ -96020,7 +95720,7 @@ Used in condition filters where users specify rules like
     },
     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  /** Non-fatal warnings (e.g., deduplication, coercion) */\n  warnings?: OperationWarning[];\n}",
+      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 }> | null;\n  /** Non-fatal warnings (e.g., deduplication, coercion) */\n  warnings?: OperationWarning[];\n}",
       docstring: "Result of a bulk setCells() operation."
     },
     ShadowAlignment: {
@@ -96424,8 +96124,7 @@ Used in condition filters where users specify rules like
       definition: "{\n  /** All sheets in the workbook */\n  sheets: SheetSnapshot[];\n  /** ID of the currently active sheet */\n  activeSheetId: string;\n  /** Total number of sheets */\n  sheetCount: number;\n}",
       docstring: "A summary snapshot of the entire workbook state."
     }
-  },
-  generated: "2026-04-02T22:03:24.772Z"
+  }
 };
 
 // src/api-describe.ts