@beyondwork/xlsx-substrate-bindings 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/LICENSE.md +31 -0
  2. package/dist/ai/index.d.ts +2 -0
  3. package/dist/ai/index.js +1 -0
  4. package/dist/ai/types.d.ts +320 -0
  5. package/dist/ai/types.js +23 -0
  6. package/dist/index.d.ts +46 -0
  7. package/dist/index.js +72 -0
  8. package/dist/runtime/index.d.ts +2 -0
  9. package/dist/runtime/index.js +1 -0
  10. package/dist/runtime/types.d.ts +1379 -0
  11. package/dist/runtime/types.js +15 -0
  12. package/dist/shared.d.ts +69 -0
  13. package/dist/shared.js +1 -0
  14. package/dist/ui/index.d.ts +2 -0
  15. package/dist/ui/index.js +1 -0
  16. package/dist/ui/types.d.ts +765 -0
  17. package/dist/ui/types.js +12 -0
  18. package/dist/wasm/bridge-contract.d.ts +541 -0
  19. package/dist/wasm/bridge-contract.js +862 -0
  20. package/dist/wasm/chart-test-fixture.d.ts +19 -0
  21. package/dist/wasm/chart-test-fixture.js +42 -0
  22. package/dist/wasm/index.d.ts +9 -0
  23. package/dist/wasm/index.js +67 -0
  24. package/dist/wasm/media-test-fixture.d.ts +44 -0
  25. package/dist/wasm/media-test-fixture.js +160 -0
  26. package/dist/wasm/session-router.d.ts +98 -0
  27. package/dist/wasm/session-router.js +184 -0
  28. package/dist/wasm/sheet-window-binary-reference.d.ts +9 -0
  29. package/dist/wasm/sheet-window-binary-reference.js +308 -0
  30. package/dist/wasm/sheet-window-binary.d.ts +279 -0
  31. package/dist/wasm/sheet-window-binary.js +636 -0
  32. package/dist/wasm/volatile-test-fixture.d.ts +7 -0
  33. package/dist/wasm/volatile-test-fixture.js +35 -0
  34. package/dist/wasm/web.d.ts +59 -0
  35. package/dist/wasm/web.js +60 -0
  36. package/generated/wasm/package.json +3 -0
  37. package/generated/wasm/sheet-window-binary.mjs +482 -0
  38. package/generated/wasm/snippets/ironcalc_base-89b4f49381e1e289/inline0.js +45 -0
  39. package/generated/wasm/xlsx_substrate_wasm.d.ts +336 -0
  40. package/generated/wasm/xlsx_substrate_wasm.js +2108 -0
  41. package/generated/wasm/xlsx_substrate_wasm_bg.wasm +0 -0
  42. package/generated/wasm/xlsx_substrate_wasm_bg.wasm.d.ts +105 -0
  43. package/generated/wasm-web/package.json +3 -0
  44. package/generated/wasm-web/snippets/ironcalc_base-89b4f49381e1e289/inline0.js +42 -0
  45. package/generated/wasm-web/xlsx_substrate_wasm.d.ts +466 -0
  46. package/generated/wasm-web/xlsx_substrate_wasm.js +2109 -0
  47. package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm +0 -0
  48. package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm.d.ts +105 -0
  49. package/package.json +41 -3
  50. package/README.md +0 -3
@@ -0,0 +1,184 @@
1
+ import { supportsRuntimeSessionMutations } from "./index.js";
2
+ export function createXlsxWorkbookMutationRouter(bridge, init) {
3
+ let currentBytes = init.bytes;
4
+ if (init.sessionHandleId !== undefined && supportsRuntimeSessionMutations(bridge)) {
5
+ const handleId = init.sessionHandleId;
6
+ // Revision the cached `currentBytes` reflect. The opening bytes ARE
7
+ // revision 0 of the session, so byte reads before the first mutation
8
+ // skip the export round-trip.
9
+ let exportedAtRevision = 0;
10
+ let latestRevision = 0;
11
+ const track = (result) => {
12
+ if (result.session !== undefined) {
13
+ latestRevision = Math.max(latestRevision, result.session.revision);
14
+ }
15
+ return result;
16
+ };
17
+ const exportBytes = (request = {}) => {
18
+ const result = bridge.exportRuntimeSessionBytes(handleId, request);
19
+ track(result);
20
+ if (result.exportedBytes !== undefined) {
21
+ currentBytes = result.exportedBytes;
22
+ exportedAtRevision = result.session.revision;
23
+ }
24
+ return {
25
+ verdict: result.verdict,
26
+ bytes: result.exportedBytes ?? currentBytes,
27
+ source: "session-export",
28
+ session: result.session,
29
+ blockers: result.blockers,
30
+ warnings: result.warnings
31
+ };
32
+ };
33
+ return {
34
+ mode: "session",
35
+ sessionHandleId: handleId,
36
+ currentBytes: () => {
37
+ if (latestRevision === exportedAtRevision) {
38
+ return currentBytes;
39
+ }
40
+ // Auto-export-first: never hand out pre-session bytes while the
41
+ // session holds newer truth.
42
+ const snapshot = exportBytes();
43
+ if (snapshot.verdict !== "applied" && snapshot.verdict !== "applied-with-warnings") {
44
+ throw new Error(`xlsx session-mode currentBytes(): session export ${snapshot.verdict}; refusing to serve stale pre-session bytes (${snapshot.blockers[0]?.message ?? "no blocker detail"})`);
45
+ }
46
+ return snapshot.bytes;
47
+ },
48
+ commitCellFormula(request) {
49
+ return track(bridge.commitCellFormulaInSession(handleId, request));
50
+ },
51
+ commitRangeClear(request) {
52
+ return track(bridge.commitRangeClearInSession(handleId, request));
53
+ },
54
+ commitRangeFill(request) {
55
+ return track(bridge.commitRangeFillInSession(handleId, request));
56
+ },
57
+ commitRangePaste(request) {
58
+ return track(bridge.commitRangePasteInSession(handleId, request));
59
+ },
60
+ commitRangeTransfer(request) {
61
+ return track(bridge.commitRangeTransferInSession(handleId, request));
62
+ },
63
+ commitRangeFormat(request) {
64
+ return track(bridge.commitRangeFormatInSession(handleId, request));
65
+ },
66
+ resizeColumnWidth(request) {
67
+ return track(bridge.resizeColumnWidthInSession(handleId, request));
68
+ },
69
+ resizeRowHeight(request) {
70
+ return track(bridge.resizeRowHeightInSession(handleId, request));
71
+ },
72
+ setColumnHidden(request) {
73
+ return track(bridge.setColumnHiddenInSession(handleId, request));
74
+ },
75
+ setRowHidden(request) {
76
+ return track(bridge.setRowHiddenInSession(handleId, request));
77
+ },
78
+ setFrozenPane(request) {
79
+ return track(bridge.setFrozenPaneInSession(handleId, request));
80
+ },
81
+ mergeCells(request) {
82
+ return track(bridge.mergeCellsInSession(handleId, request));
83
+ },
84
+ mutateSheetStructure(request) {
85
+ return track(bridge.mutateSheetStructureInSession(handleId, request));
86
+ },
87
+ mutateSheetTabs(request) {
88
+ return track(bridge.mutateSheetTabsInSession(handleId, request));
89
+ },
90
+ commitTableAppendRow(request) {
91
+ return track(bridge.commitTableAppendRowInSession(handleId, request));
92
+ },
93
+ commitShiftCells(request) {
94
+ return track(bridge.commitShiftCellsInSession(handleId, request));
95
+ },
96
+ recalculate(request = {}) {
97
+ return track(bridge.recalculateInSession(handleId, request));
98
+ },
99
+ exportWorkbookBytes(request = {}) {
100
+ return exportBytes(request);
101
+ }
102
+ };
103
+ }
104
+ const adopt = (result) => {
105
+ if (result.exportedBytes !== undefined) {
106
+ currentBytes = result.exportedBytes;
107
+ }
108
+ return result;
109
+ };
110
+ return {
111
+ mode: "bytes",
112
+ currentBytes: () => currentBytes,
113
+ commitCellFormula(request) {
114
+ return adopt(bridge.commitCellFormula(currentBytes, request));
115
+ },
116
+ commitRangeClear(request) {
117
+ return adopt(bridge.commitRangeClear(currentBytes, request));
118
+ },
119
+ commitRangeFill(request) {
120
+ return adopt(bridge.commitRangeFill(currentBytes, request));
121
+ },
122
+ commitRangePaste(request) {
123
+ return adopt(bridge.commitRangePaste(currentBytes, request));
124
+ },
125
+ commitRangeTransfer(request) {
126
+ return adopt(bridge.commitRangeTransfer(currentBytes, request));
127
+ },
128
+ commitRangeFormat(request) {
129
+ return adopt(bridge.commitRangeFormat(currentBytes, request));
130
+ },
131
+ resizeColumnWidth(request) {
132
+ return adopt(bridge.resizeColumnWidth(currentBytes, request));
133
+ },
134
+ resizeRowHeight(request) {
135
+ return adopt(bridge.resizeRowHeight(currentBytes, request));
136
+ },
137
+ setColumnHidden(request) {
138
+ return adopt(bridge.setColumnHidden(currentBytes, request));
139
+ },
140
+ setRowHidden(request) {
141
+ return adopt(bridge.setRowHidden(currentBytes, request));
142
+ },
143
+ setFrozenPane(request) {
144
+ return adopt(bridge.setFrozenPane(currentBytes, request));
145
+ },
146
+ mergeCells(request) {
147
+ return adopt(bridge.mergeCells(currentBytes, request));
148
+ },
149
+ mutateSheetStructure(request) {
150
+ return adopt(bridge.mutateSheetStructure(currentBytes, request));
151
+ },
152
+ mutateSheetTabs(request) {
153
+ return adopt(bridge.mutateSheetTabs(currentBytes, request));
154
+ },
155
+ commitTableAppendRow(request) {
156
+ return adopt(bridge.commitTableAppendRow(currentBytes, request));
157
+ },
158
+ commitShiftCells(request) {
159
+ return adopt(bridge.commitShiftCells(currentBytes, request));
160
+ },
161
+ recalculate(request = {}) {
162
+ // Both paths accept explicit volatile inputs; only mode is session-only.
163
+ const { mode: strippedMode, ...byteRequest } = request;
164
+ const result = adopt(bridge.recalculateFormulas(currentBytes, byteRequest));
165
+ if (strippedMode === undefined) {
166
+ return result;
167
+ }
168
+ const warning = {
169
+ code: "session-request-fields-stripped",
170
+ message: "byte-based recalculate ignored session-only request field: mode (byte recalculation always uses the full plan)"
171
+ };
172
+ return { ...result, warnings: [...result.warnings, warning] };
173
+ },
174
+ exportWorkbookBytes() {
175
+ return {
176
+ verdict: "applied",
177
+ bytes: currentBytes,
178
+ source: "byte-truth",
179
+ blockers: [],
180
+ warnings: []
181
+ };
182
+ }
183
+ };
184
+ }
@@ -0,0 +1,9 @@
1
+ import type { XlsxUiSheetWindowReadback } from "../ui/index.ts";
2
+ import { type XlsxSheetWindowBinaryEnvelope } from "./sheet-window-binary.ts";
3
+ /**
4
+ * Encode a JSON sheet-window readback into the hybrid binary envelope.
5
+ * Throws when the readback holds structure the v1 layout cannot represent
6
+ * (which would indicate the layout spec needs re-agreement, not a silent
7
+ * widening here).
8
+ */
9
+ export declare function encodeSheetWindowBinaryReference(readback: XlsxUiSheetWindowReadback): XlsxSheetWindowBinaryEnvelope;
@@ -0,0 +1,308 @@
1
+ import { SHEET_WINDOW_BINARY_HEADER_BYTES, SHEET_WINDOW_BINARY_MAGIC, SHEET_WINDOW_BINARY_SCHEMA_ID, SHEET_WINDOW_BINARY_SECTION_ENTRY_BYTES, SHEET_WINDOW_BINARY_VERSION, SHEET_WINDOW_CELL_RECORD_BYTES, SHEET_WINDOW_FLAG_PAINT_GEOMETRY, SHEET_WINDOW_LINE_RECORD_BYTES, SHEET_WINDOW_MARKER_SEPARATOR, SHEET_WINDOW_OUTLINE_NONE, SHEET_WINDOW_PAINT_CELL_RECORD_BYTES, SHEET_WINDOW_PAINT_LINE_RECORD_BYTES, SHEET_WINDOW_RECT_RECORD_BYTES, SHEET_WINDOW_SECTION_CELLS, SHEET_WINDOW_SECTION_COLS, SHEET_WINDOW_SECTION_PAINT_CELLS, SHEET_WINDOW_SECTION_PAINT_COLS, SHEET_WINDOW_SECTION_PAINT_ROWS, SHEET_WINDOW_SECTION_RECTS, SHEET_WINDOW_SECTION_ROWS, SHEET_WINDOW_SECTION_STRBLOB, SHEET_WINDOW_SECTION_STRTAB, SHEET_WINDOW_STRTAB_ENTRY_BYTES, SHEET_WINDOW_U32_NONE } from "./sheet-window-binary.js";
2
+ /**
3
+ * TS REFERENCE ENCODER for the `xlsx-sheet-window-binary/1` layout.
4
+ *
5
+ * Test/bench support only — production encoding is the Rust
6
+ * `encode_sheet_window_binary` in crates/sheets-wasm (the wasm export owns
7
+ * the hot path). This module exists so that:
8
+ *
9
+ * 1. the decoder is provable TODAY against live JSON readbacks (encode the
10
+ * JSON readback -> decode -> deepStrictEqual), independent of the Rust
11
+ * encoder landing;
12
+ * 2. the golden-bytes fixture freezes the byte layout — any layout drift on
13
+ * either side breaks the golden and forces re-agreeing the layout spec +
14
+ * a header version bump;
15
+ * 3. the bench can measure the JS decode lane before the wasm export exists.
16
+ *
17
+ * The input is the exact object shape the JSON path produces, so encoding is
18
+ * a structural transcription; see sheet-window-binary.ts for the layout and
19
+ * the documented deviations from the T5 contract draft.
20
+ */
21
+ class StringInterner {
22
+ ids = new Map();
23
+ entries = [""]; // entry 0 reserved (absent)
24
+ intern(value) {
25
+ if (value === undefined) {
26
+ return 0;
27
+ }
28
+ const existing = this.ids.get(value);
29
+ if (existing !== undefined) {
30
+ return existing;
31
+ }
32
+ const id = this.entries.length;
33
+ this.entries.push(value);
34
+ this.ids.set(value, id);
35
+ return id;
36
+ }
37
+ }
38
+ function align8(value) {
39
+ return (value + 7) & ~7;
40
+ }
41
+ function rangeKey(range) {
42
+ return `${range.start.row}:${range.start.column}:${range.end.row}:${range.end.column}`;
43
+ }
44
+ function encodeLineSection(lines, lineField, metricField, customField, interner) {
45
+ const bytes = new Uint8Array(lines.length * SHEET_WINDOW_LINE_RECORD_BYTES);
46
+ const view = new DataView(bytes.buffer);
47
+ lines.forEach((line, i) => {
48
+ const o = i * SHEET_WINDOW_LINE_RECORD_BYTES;
49
+ view.setUint32(o, line[lineField], true);
50
+ view.setUint32(o + 4, interner.intern(line[metricField]), true);
51
+ view.setUint32(o + 8, interner.intern(line.precision), true);
52
+ view.setUint32(o + 12, interner.intern(line.hiddenPosture ?? undefined), true);
53
+ let flags = 0;
54
+ if (line.hidden)
55
+ flags |= 0x01;
56
+ if (line[customField])
57
+ flags |= 0x02;
58
+ if (line.collapsed)
59
+ flags |= 0x04;
60
+ view.setUint8(o + 16, flags);
61
+ const outline = line.outlineLevel;
62
+ view.setUint8(o + 17, outline === undefined || outline === null ? SHEET_WINDOW_OUTLINE_NONE : outline);
63
+ });
64
+ return bytes;
65
+ }
66
+ /**
67
+ * Encode a JSON sheet-window readback into the hybrid binary envelope.
68
+ * Throws when the readback holds structure the v1 layout cannot represent
69
+ * (which would indicate the layout spec needs re-agreement, not a silent
70
+ * widening here).
71
+ */
72
+ export function encodeSheetWindowBinaryReference(readback) {
73
+ const interner = new StringInterner();
74
+ const rareCells = [];
75
+ const mergedIndexByKey = new Map();
76
+ readback.mergedRanges.forEach((merged, index) => {
77
+ mergedIndexByKey.set(rangeKey(merged.sourceRange), index);
78
+ });
79
+ const cellBytes = new Uint8Array(readback.cells.length * SHEET_WINDOW_CELL_RECORD_BYTES);
80
+ const cellView = new DataView(cellBytes.buffer);
81
+ readback.cells.forEach((cell, i) => {
82
+ const o = i * SHEET_WINDOW_CELL_RECORD_BYTES;
83
+ cellView.setUint32(o, cell.address.row, true);
84
+ cellView.setUint32(o + 4, cell.address.column, true);
85
+ const strIds = [
86
+ cell.cellId,
87
+ cell.displayText,
88
+ cell.valueKind,
89
+ cell.formulaText,
90
+ cell.displayFingerprint,
91
+ cell.styleRef,
92
+ cell.displayFormatPosture,
93
+ cell.formatCode,
94
+ cell.fillColor,
95
+ cell.fontColor,
96
+ cell.fontName,
97
+ cell.fontSizePoints,
98
+ cell.displayTextColor,
99
+ cell.horizontalAlignment,
100
+ cell.mergeRole,
101
+ cell.editability
102
+ ];
103
+ strIds.forEach((value, slot) => {
104
+ cellView.setUint32(o + 8 + slot * 4, interner.intern(value), true);
105
+ });
106
+ cellView.setUint32(o + 72, cell.numFmtId === undefined ? SHEET_WINDOW_U32_NONE : cell.numFmtId, true);
107
+ let flags = 0;
108
+ if (cell.bold)
109
+ flags |= 0x0001;
110
+ if (cell.italic)
111
+ flags |= 0x0002;
112
+ if (cell.underline)
113
+ flags |= 0x0004;
114
+ if (cell.wrapText)
115
+ flags |= 0x0008;
116
+ if (cell.borderTop)
117
+ flags |= 0x0010;
118
+ if (cell.borderRight)
119
+ flags |= 0x0020;
120
+ if (cell.borderBottom)
121
+ flags |= 0x0040;
122
+ if (cell.borderLeft)
123
+ flags |= 0x0080;
124
+ // X5-U-008 (ii): two spare bits (8-9) carry vertical alignment.
125
+ if (cell.verticalAlignment === "top")
126
+ flags |= 0x0100;
127
+ else if (cell.verticalAlignment === "middle")
128
+ flags |= 0x0200;
129
+ else if (cell.verticalAlignment === "bottom")
130
+ flags |= 0x0300;
131
+ cellView.setUint16(o + 76, flags, true);
132
+ let mergedIdx = SHEET_WINDOW_U32_NONE;
133
+ if (cell.mergeRole !== "unmerged") {
134
+ if (!cell.mergeRange || !cell.mergeOwner) {
135
+ throw new Error(`sheet-window reference encoder: merged cell ${i} lacks mergeRange/mergeOwner`);
136
+ }
137
+ const found = mergedIndexByKey.get(rangeKey(cell.mergeRange));
138
+ if (found === undefined) {
139
+ throw new Error(`sheet-window reference encoder: merged cell ${i} range not present in mergedRanges — layout re-agreement needed`);
140
+ }
141
+ mergedIdx = found;
142
+ }
143
+ cellView.setUint32(o + 80, mergedIdx, true);
144
+ const hasRare = cell.selectionHandle !== undefined || cell.blockers.length > 0 || cell.hyperlink !== undefined;
145
+ let rareIdx = SHEET_WINDOW_U32_NONE;
146
+ if (hasRare) {
147
+ rareIdx = rareCells.length;
148
+ rareCells.push({
149
+ ...(cell.selectionHandle !== undefined ? { selectionHandle: cell.selectionHandle } : {}),
150
+ ...(cell.blockers.length > 0 ? { blockers: cell.blockers } : {}),
151
+ // X5-U-009 (bridge v31): the link rides the side table.
152
+ ...(cell.hyperlink !== undefined ? { hyperlink: cell.hyperlink } : {})
153
+ });
154
+ }
155
+ cellView.setUint32(o + 84, rareIdx, true);
156
+ const markers = cell.postureMarkers;
157
+ if (markers.some((marker) => marker.includes(SHEET_WINDOW_MARKER_SEPARATOR))) {
158
+ throw new Error("sheet-window reference encoder: posture marker contains the reserved separator");
159
+ }
160
+ cellView.setUint32(o + 88, markers.length === 0 ? 0 : interner.intern(markers.join(SHEET_WINDOW_MARKER_SEPARATOR)), true);
161
+ });
162
+ const geometry = readback.paintGeometry;
163
+ const sections = [
164
+ {
165
+ sectionId: SHEET_WINDOW_SECTION_ROWS,
166
+ bytes: encodeLineSection(readback.rows, "row", "heightPoints", "customHeight", interner),
167
+ recordCount: readback.rows.length
168
+ },
169
+ {
170
+ sectionId: SHEET_WINDOW_SECTION_COLS,
171
+ bytes: encodeLineSection(readback.columns, "column", "width", "customWidth", interner),
172
+ recordCount: readback.columns.length
173
+ },
174
+ { sectionId: SHEET_WINDOW_SECTION_CELLS, bytes: cellBytes, recordCount: readback.cells.length }
175
+ ];
176
+ if (geometry) {
177
+ const paintLines = (lines, field) => {
178
+ const bytes = new Uint8Array(lines.length * SHEET_WINDOW_PAINT_LINE_RECORD_BYTES);
179
+ const view = new DataView(bytes.buffer);
180
+ lines.forEach((line, i) => {
181
+ const o = i * SHEET_WINDOW_PAINT_LINE_RECORD_BYTES;
182
+ view.setUint32(o, line[field], true);
183
+ view.setUint32(o + 4, interner.intern(line.precision), true);
184
+ view.setUint8(o + 8, line.hidden ? 0x01 : 0x00);
185
+ view.setFloat64(o + 16, line.offsetPx, true);
186
+ view.setFloat64(o + 24, line.sizePx, true);
187
+ });
188
+ return bytes;
189
+ };
190
+ const rectCountTotal = geometry.cells.reduce((count, cell) => count + cell.rects.length, 0);
191
+ const rectBytes = new Uint8Array(rectCountTotal * SHEET_WINDOW_RECT_RECORD_BYTES);
192
+ const rectView = new DataView(rectBytes.buffer);
193
+ const paintCellBytes = new Uint8Array(geometry.cells.length * SHEET_WINDOW_PAINT_CELL_RECORD_BYTES);
194
+ const paintCellView = new DataView(paintCellBytes.buffer);
195
+ let rectCursor = 0;
196
+ geometry.cells.forEach((cell, i) => {
197
+ const o = i * SHEET_WINDOW_PAINT_CELL_RECORD_BYTES;
198
+ paintCellView.setUint32(o, cell.address.row, true);
199
+ paintCellView.setUint32(o + 4, cell.address.column, true);
200
+ paintCellView.setUint32(o + 8, rectCursor, true);
201
+ paintCellView.setUint16(o + 12, cell.rects.length, true);
202
+ paintCellView.setUint8(o + 14, cell.hidden ? 0x01 : 0x00);
203
+ paintCellView.setUint32(o + 16, interner.intern(cell.precision), true);
204
+ paintCellView.setUint32(o + 20, cell.mergeOwner ? cell.mergeOwner.row : SHEET_WINDOW_U32_NONE, true);
205
+ paintCellView.setUint32(o + 24, cell.mergeOwner ? cell.mergeOwner.column : SHEET_WINDOW_U32_NONE, true);
206
+ for (const rect of cell.rects) {
207
+ const ro = rectCursor * SHEET_WINDOW_RECT_RECORD_BYTES;
208
+ rectView.setFloat64(ro, rect.xPx, true);
209
+ rectView.setFloat64(ro + 8, rect.yPx, true);
210
+ rectView.setFloat64(ro + 16, rect.widthPx, true);
211
+ rectView.setFloat64(ro + 24, rect.heightPx, true);
212
+ rectView.setUint32(ro + 32, interner.intern(rect.coordinateSpace.kind), true);
213
+ const region = "region" in rect.coordinateSpace ? rect.coordinateSpace.region : undefined;
214
+ rectView.setUint32(ro + 36, interner.intern(region), true);
215
+ rectView.setUint32(ro + 40, interner.intern(rect.precision), true);
216
+ rectCursor += 1;
217
+ }
218
+ });
219
+ sections.push({
220
+ sectionId: SHEET_WINDOW_SECTION_PAINT_ROWS,
221
+ bytes: paintLines(geometry.rows, "row"),
222
+ recordCount: geometry.rows.length
223
+ }, {
224
+ sectionId: SHEET_WINDOW_SECTION_PAINT_COLS,
225
+ bytes: paintLines(geometry.columns, "column"),
226
+ recordCount: geometry.columns.length
227
+ }, { sectionId: SHEET_WINDOW_SECTION_RECTS, bytes: rectBytes, recordCount: rectCountTotal }, {
228
+ sectionId: SHEET_WINDOW_SECTION_PAINT_CELLS,
229
+ bytes: paintCellBytes,
230
+ recordCount: geometry.cells.length
231
+ });
232
+ }
233
+ // String sections encode LAST so every interned id exists.
234
+ const encoder = new TextEncoder();
235
+ const encodedStrings = interner.entries.map((value) => encoder.encode(value));
236
+ const blobLen = encodedStrings.reduce((len, chunk) => len + chunk.byteLength, 0);
237
+ const blobBytes = new Uint8Array(blobLen);
238
+ const strtabBytes = new Uint8Array(encodedStrings.length * SHEET_WINDOW_STRTAB_ENTRY_BYTES);
239
+ const strtabView = new DataView(strtabBytes.buffer);
240
+ let blobCursor = 0;
241
+ encodedStrings.forEach((chunk, id) => {
242
+ if (id !== 0) {
243
+ blobBytes.set(chunk, blobCursor);
244
+ strtabView.setUint32(id * SHEET_WINDOW_STRTAB_ENTRY_BYTES, blobCursor, true);
245
+ strtabView.setUint32(id * SHEET_WINDOW_STRTAB_ENTRY_BYTES + 4, chunk.byteLength, true);
246
+ blobCursor += chunk.byteLength;
247
+ }
248
+ });
249
+ sections.push({ sectionId: SHEET_WINDOW_SECTION_STRTAB, bytes: strtabBytes, recordCount: encodedStrings.length }, { sectionId: SHEET_WINDOW_SECTION_STRBLOB, bytes: blobBytes, recordCount: blobLen });
250
+ const tableBytes = sections.length * SHEET_WINDOW_BINARY_SECTION_ENTRY_BYTES;
251
+ let cursor = align8(SHEET_WINDOW_BINARY_HEADER_BYTES + tableBytes);
252
+ const offsets = sections.map((section) => {
253
+ const offset = cursor;
254
+ cursor = align8(cursor + section.bytes.byteLength);
255
+ return offset;
256
+ });
257
+ const totalByteLen = cursor;
258
+ const bytes = new Uint8Array(totalByteLen);
259
+ const view = new DataView(bytes.buffer);
260
+ view.setUint32(0, SHEET_WINDOW_BINARY_MAGIC, true);
261
+ view.setUint16(4, SHEET_WINDOW_BINARY_VERSION, true);
262
+ view.setUint16(6, geometry ? SHEET_WINDOW_FLAG_PAINT_GEOMETRY : 0, true);
263
+ view.setUint32(8, sections.length, true);
264
+ view.setUint32(12, totalByteLen, true);
265
+ sections.forEach((section, i) => {
266
+ const o = SHEET_WINDOW_BINARY_HEADER_BYTES + i * SHEET_WINDOW_BINARY_SECTION_ENTRY_BYTES;
267
+ view.setUint32(o, section.sectionId, true);
268
+ view.setUint32(o + 4, offsets[i], true);
269
+ view.setUint32(o + 8, section.bytes.byteLength, true);
270
+ view.setUint32(o + 12, section.recordCount, true);
271
+ bytes.set(section.bytes, offsets[i]);
272
+ });
273
+ const rest = {
274
+ envelope: readback.envelope,
275
+ status: readback.status,
276
+ workbookId: readback.workbookId,
277
+ canonicalHash: readback.canonicalHash,
278
+ activeSheetId: readback.activeSheetId,
279
+ sheetName: readback.sheetName,
280
+ viewport: readback.viewport,
281
+ coordinatePosture: readback.coordinatePosture,
282
+ // X5-U-018: carry the right-to-left flag through the reference encoder's
283
+ // `rest` (default false for the common left-to-right sheet).
284
+ rightToLeft: readback.rightToLeft ?? false,
285
+ // UX-P-104: the sheet extent rides the `rest` half too, matching the Rust
286
+ // encoder's `sheetExtent`.
287
+ sheetExtent: readback.sheetExtent,
288
+ sheetWindowOrigin: readback.sheetWindowOrigin,
289
+ cache: readback.cache,
290
+ mergedRanges: readback.mergedRanges,
291
+ panePartitions: readback.panePartitions,
292
+ // X5-U-011: typed data-validation rules ride the `rest` half, matching the
293
+ // Rust encoder's `dataValidations` (always present, empty when none).
294
+ dataValidations: readback.dataValidations ?? [],
295
+ activeSelection: readback.activeSelection,
296
+ accessibility: readback.accessibility,
297
+ capabilities: readback.capabilities,
298
+ blockers: readback.blockers,
299
+ paintGeometryPresent: geometry !== undefined,
300
+ paintGeometryActiveSelection: geometry?.activeSelection,
301
+ paintGeometryObjects: geometry?.objects,
302
+ // X5-U-017: sparkline glyphs ride the `rest` half, matching the Rust
303
+ // encoder's `paintGeometrySparklines`.
304
+ paintGeometrySparklines: geometry?.sparklines,
305
+ rareCells
306
+ };
307
+ return { schemaId: SHEET_WINDOW_BINARY_SCHEMA_ID, bytes, rest };
308
+ }