@beyondwork/xlsx-substrate-bindings 0.0.0-stage → 0.2.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 (47) hide show
  1. package/LICENSE.md +31 -0
  2. package/README.md +135 -2
  3. package/dist/ai/agent-metadata.d.ts +363 -0
  4. package/dist/ai/agent-metadata.js +227 -0
  5. package/dist/ai/index.d.ts +6 -0
  6. package/dist/ai/index.js +7 -0
  7. package/dist/ai/mutation-bridge.d.ts +82 -0
  8. package/dist/ai/mutation-bridge.js +179 -0
  9. package/dist/ai/types.d.ts +765 -0
  10. package/dist/ai/types.js +23 -0
  11. package/dist/index.d.ts +50 -0
  12. package/dist/index.js +90 -0
  13. package/dist/runtime/index.d.ts +2 -0
  14. package/dist/runtime/index.js +1 -0
  15. package/dist/runtime/types.d.ts +1435 -0
  16. package/dist/runtime/types.js +15 -0
  17. package/dist/shared.d.ts +69 -0
  18. package/dist/shared.js +1 -0
  19. package/dist/ui/index.d.ts +2 -0
  20. package/dist/ui/index.js +1 -0
  21. package/dist/ui/types.d.ts +765 -0
  22. package/dist/ui/types.js +12 -0
  23. package/dist/wasm/ai-session-bridge.d.ts +97 -0
  24. package/dist/wasm/ai-session-bridge.js +154 -0
  25. package/dist/wasm/bridge-contract.d.ts +643 -0
  26. package/dist/wasm/bridge-contract.js +1001 -0
  27. package/dist/wasm/index.d.ts +50 -0
  28. package/dist/wasm/index.js +297 -0
  29. package/dist/wasm/memory-budget.d.ts +77 -0
  30. package/dist/wasm/memory-budget.js +532 -0
  31. package/dist/wasm/runtime-guard.d.ts +141 -0
  32. package/dist/wasm/runtime-guard.js +373 -0
  33. package/dist/wasm/session-router.d.ts +98 -0
  34. package/dist/wasm/session-router.js +184 -0
  35. package/dist/wasm/sheet-window-binary-reference.d.ts +9 -0
  36. package/dist/wasm/sheet-window-binary-reference.js +308 -0
  37. package/dist/wasm/sheet-window-binary.d.ts +279 -0
  38. package/dist/wasm/sheet-window-binary.js +636 -0
  39. package/dist/wasm/web.d.ts +72 -0
  40. package/dist/wasm/web.js +142 -0
  41. package/generated/wasm-web/package.json +3 -0
  42. package/generated/wasm-web/snippets/ironcalc_base-89b4f49381e1e289/inline0.js +42 -0
  43. package/generated/wasm-web/xlsx_substrate_wasm.d.ts +532 -0
  44. package/generated/wasm-web/xlsx_substrate_wasm.js +2493 -0
  45. package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm +0 -0
  46. package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm.d.ts +120 -0
  47. package/package.json +55 -3
@@ -0,0 +1,643 @@
1
+ import { type RawXlsxAiSessionModule, type XlsxAiSessionBridgeMethods } from "./ai-session-bridge.ts";
2
+ import type { XlsxAiCompressedContextRequest, XlsxAiCompressedContextResult, XlsxAiCompressedDrilldownRequest, XlsxAiCompressedDrilldownResult, XlsxAiFormulaExplanationResult, XlsxAiReferenceQuery, XlsxAiReferenceResolution, XlsxAiScopeListRequest, XlsxAiScopeListResult, XlsxAiWorkbookInspection } from "../ai/index.ts";
3
+ import type { XlsxFormulaCommitRequest, XlsxFormulaCommitResult, XlsxFormulaRecalculateRequest, XlsxFormulaRecalculateResult, XlsxLayoutMetricResizeRequest, XlsxLayoutMetricResizeResult, XlsxLayoutMetricVisibilityRequest, XlsxLayoutMetricVisibilityResult, XlsxFrozenPaneRequest, XlsxFrozenPaneResult, XlsxMergeCellsRequest, XlsxMergeCellsResult, XlsxOutlineGroupVisibilityResult, XlsxOutlineLevelRequest, XlsxOutlineLevelResult, XlsxSheetStructureMutationRequest, XlsxSheetStructureMutationResult, XlsxSheetTabMutationRequest, XlsxSheetTabMutationResult, XlsxDefinedNameMutationRequest, XlsxDefinedNameMutationResult, XlsxShiftCellsCommitRequest, XlsxShiftCellsCommitResult, XlsxRangeFilterApplyRequest, XlsxRangeFilterClearRequest, XlsxRangeFilterResult, XlsxRangeSortRequest, XlsxRangeSortResult, XlsxTableAppendRowRequest, XlsxTableAppendRowResult, XlsxKernelActionRequest, XlsxKernelActionValidation, XlsxKernelCreateRequest, XlsxKernelMutationResult, XlsxKernelPanelReadback, XlsxRangeClearCommitRequest, XlsxRangeClearCommitResult, XlsxRangeFormatCommitRequest, XlsxRangeDataValidationCommitRequest, XlsxRangeDataValidationCommitResult, XlsxReviewCommentCommitRequest, XlsxReviewCommentCommitResult, XlsxFindRequest, XlsxFindResult, XlsxGoToRequest, XlsxGoToResult, XlsxDataRegionRequest, XlsxDataRegionResult, XlsxRangeHyperlinkCommitRequest, XlsxRangeHyperlinkCommitResult, XlsxRangeFormatCommitResult, XlsxRangeFillCommitRequest, XlsxRangeFillCommitResult, XlsxRangePasteCommitRequest, XlsxRangePasteCommitResult, XlsxRangeTransferCommitRequest, XlsxRangeTransferCommitResult, XlsxRuntimeSessionDelimitedExportRequest, XlsxRuntimeSessionDelimitedExportResult, XlsxRuntimeSessionExportRequest, XlsxRuntimeSessionExportResult, XlsxSelectionSetClearCommitRequest, XlsxSelectionSetFormatCommitRequest, XlsxSelectionSetPasteCommitRequest, XlsxSessionRecalculateRequest, XlsxWorkflowContextInput } from "../runtime/index.ts";
4
+ import type { XlsxScopeHandle } from "../shared.ts";
5
+ import { type XlsxWasmMemoryReadback, type XlsxWasmRuntime } from "./runtime-guard.ts";
6
+ import { type XlsxSheetWindowBinaryEnvelope } from "./sheet-window-binary.ts";
7
+ import type { XlsxUiAccessibilitySummary, XlsxUiOverlayLanesReadback, XlsxUiOverlayLanesRequest, XlsxUiSelectionCursor, XlsxUiSelectionReadback, XlsxUiSelectionSetReadback, XlsxUiSheetWindowReadback, XlsxUiSessionBinding, XlsxUiStateClass, XlsxUiStateNamespace, XlsxUiViewportHint, XlsxUiViewportReadback } from "../ui/index.ts";
8
+ export { createXlsxWasmRuntime, deserializeXlsxWasmBridgeError, isXlsxWasmBridgeError, serializeXlsxWasmBridgeError, XlsxWasmBridgeError, type SerializedXlsxWasmBridgeError, type XlsxWasmAdmissionOptions, type XlsxWasmBridgeErrorCode, type XlsxWasmBridgeErrorDetails, type XlsxWasmInstanceSource, type XlsxWasmMemoryReadback, type XlsxWasmReinstantiate, type XlsxWasmRuntime, type XlsxWasmRuntimeOptions } from "./runtime-guard.ts";
9
+ export { estimateXlsxPackageMemory, readWasmMemoryLimits, XLSX_WASM_LINEAR_MEMORY_MAXIMUM_BYTES, type XlsxPackageMemoryEstimate, type XlsxWasmMemoryLimits } from "./memory-budget.ts";
10
+ export interface XlsxWasmBridgeStatus {
11
+ readonly packageName: "@beyondwork/xlsx-substrate-bindings";
12
+ readonly role: "wasm-ai-ui-runtime-binding";
13
+ readonly bridgeVersion: "xlsx-wasm-bridge-v46";
14
+ readonly capabilities: readonly ("workflow-context-v1" | "workflow-context-v2" | "workflow-overlay-lanes-v1" | "sheet-window-paint-geometry-v1" | "sheet-window-coordinate-posture-v1" | "formula-diagnostics-v2" | "formula-address-commit-v1" | "formula-recalculate-commit-v1" | "formula-recalculate-volatile-inputs-v1" | "formula-translation-interaction-v1" | "kernel-ui-v1" | "runtime-session-handles-v1" | "runtime-session-mutations-v1" | "staged-open-v1" | "sheet-window-cache-v1" | "readback-envelope-v1" | "preserve-only-entities-v1" | "selection-set-v1" | "multi-area-mutation-v1" | "range-fill-commit-v1" | "range-paste-commit-v1" | "range-clear-commit-v1" | "range-format-commit-v1" | "range-transfer-v1" | "layout-metric-resize-v1" | "layout-metric-visibility-v1" | "outline-group-visibility-v1" | "sheet-structure-v1" | "sheet-tabs-v1" | "table-mutation-v1" | "filter-sort-v1" | "sort-commit-v1" | "operation-pattern-hints-v1" | "ai-compressed-bundles-v1" | "ui-capability-records-v1" | "drawing-media-v1" | "drawing-chart-v1" | "sheet-window-binary-v1" | "frozen-pane-v1" | "sheet-window-extent-v1" | "selection-cursor-v1" | "merge-cells-v1" | "shift-cells-v1" | "selection-set-capabilities-v1" | "find-v1" | "go-to-v1" | "data-region-v1" | "ai-session-agent-v1" | "defined-names-v1")[];
15
+ readonly wasmBinding: "mounted";
16
+ readonly nativeBinding: "not-mounted";
17
+ readonly readOnly: false;
18
+ }
19
+ export interface XlsxRuntimeSessionOpenRequest {
20
+ readonly sourceLabel?: string;
21
+ readonly loadMode?: "full" | "active-sheet-preview";
22
+ readonly requestedActiveSheetId?: string;
23
+ }
24
+ export interface XlsxRuntimeSessionHandle {
25
+ readonly handleId: string;
26
+ readonly workbookId: string;
27
+ /**
28
+ * Session identity at open — deterministically rooted in the loaded bytes,
29
+ * so two sessions opened from identical bytes start with identical
30
+ * identity. Opaque; equality/advancement only (see
31
+ * `XlsxRuntimeSessionMutationReceipt.canonicalHash`).
32
+ */
33
+ readonly canonicalHash: string;
34
+ readonly sourceLabel: string;
35
+ readonly hydration: XlsxRuntimeSessionHydration;
36
+ }
37
+ export interface XlsxRuntimeSessionHydration {
38
+ readonly mode: "full" | "active-sheet-preview";
39
+ readonly activeSheetId?: string;
40
+ readonly importedWorksheetCount: number;
41
+ readonly deferredWorksheetCount: number;
42
+ }
43
+ export interface XlsxRuntimeSessionDisposeResult {
44
+ readonly handleId: string;
45
+ readonly disposed: boolean;
46
+ }
47
+ export interface XlsxSelectionSetRequest {
48
+ readonly handles: readonly XlsxScopeHandle[];
49
+ readonly viewportHint?: XlsxUiViewportHint;
50
+ readonly workflowContext?: XlsxWorkflowContextInput;
51
+ readonly activeScopeId?: string;
52
+ readonly anchorScopeId?: string;
53
+ }
54
+ export interface XlsxWasmBridge extends XlsxAiSessionBridgeMethods {
55
+ readonly status: XlsxWasmBridgeStatus;
56
+ /**
57
+ * R4: the live instance's linear memory in bytes (`memory.buffer.byteLength`,
58
+ * read on the JS side; no wasm call). Undefined when the loader could not
59
+ * see the instance's memory.
60
+ */
61
+ wasmMemoryBytes(): number | undefined;
62
+ /**
63
+ * R4: set the high-water mark (with `bytes`) and read the memory posture.
64
+ * Linear memory never shrinks, so `aboveHighWater` stays true until the
65
+ * instance is replaced: the host's cue to recycle its worker.
66
+ */
67
+ highWater(bytes?: number): XlsxWasmMemoryReadback;
68
+ openWorkbookRuntimeSession(bytes: Uint8Array, request?: XlsxRuntimeSessionOpenRequest): XlsxRuntimeSessionHandle;
69
+ disposeWorkbookRuntimeSession(handleId: string): XlsxRuntimeSessionDisposeResult;
70
+ inspectWorkbookRuntimeSession(handleId: string): XlsxAiWorkbookInspection;
71
+ listRuntimeSessionScopes(handleId: string, request?: XlsxAiScopeListRequest): XlsxAiScopeListResult;
72
+ readRuntimeSessionCompressedContext(handleId: string, request?: XlsxAiCompressedContextRequest): XlsxAiCompressedContextResult;
73
+ readRuntimeSessionCompressedDrilldown(handleId: string, request: XlsxAiCompressedDrilldownRequest): XlsxAiCompressedDrilldownResult;
74
+ explainRuntimeSessionFormula(handleId: string, target: XlsxScopeHandle | XlsxAiReferenceQuery): XlsxAiFormulaExplanationResult | XlsxAiReferenceResolution;
75
+ bindUiRuntimeSession(handleId: string, requestedActiveSheetId?: string): XlsxUiSessionBinding;
76
+ readRuntimeSessionSelection(handleId: string, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput, selectionCursor?: XlsxUiSelectionCursor): XlsxUiSelectionReadback;
77
+ readRuntimeSessionSelectionSet(handleId: string, request: XlsxSelectionSetRequest): XlsxUiSelectionSetReadback;
78
+ summarizeRuntimeSessionAccessibility(handleId: string, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput): XlsxUiAccessibilitySummary;
79
+ /**
80
+ * X5-U-038 (bridge v34): Excel's Find over the canonical session workbook
81
+ * — current sheet or every visible sheet, values or formulas, match case,
82
+ * match entire cell, `?` `*` `~` wildcards. Read-only; the answer is the
83
+ * ordered match list with a cell handle per match and the count facts, or
84
+ * the typed refusal of the query.
85
+ */
86
+ findInRuntimeSession(handleId: string, request: XlsxFindRequest): XlsxFindResult;
87
+ /**
88
+ * X5-U-023 (bridge v35): name-box / Go To resolution over the canonical
89
+ * session workbook — an address, a range, whole rows or columns, a
90
+ * sheet-qualified reference, or a defined name with Excel's scope
91
+ * precedence. Read-only; the answer is the target sheet, range, label and
92
+ * the selection handle the selection command takes, or a typed refusal.
93
+ */
94
+ goToInRuntimeSession(handleId: string, request: XlsxGoToRequest): XlsxGoToResult;
95
+ /**
96
+ * X3-R-012 (bridge v40): Excel's Ctrl+Arrow / Ctrl+Shift+Arrow / Ctrl+A
97
+ * targets over the canonical session workbook — `Range.End` of the
98
+ * active cell in a direction, the same edge as an extended selection's
99
+ * head, or `Range.CurrentRegion` (the whole sheet once the selection
100
+ * covers it). Read-only; the answer is the target's sheet, range, label
101
+ * and the selection handle the selection command takes, or a typed
102
+ * refusal.
103
+ */
104
+ dataRegionInRuntimeSession(handleId: string, request: XlsxDataRegionRequest): XlsxDataRegionResult;
105
+ readRuntimeSessionSheetWindow(handleId: string, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxUiSheetWindowReadback;
106
+ /**
107
+ * T5 (`xlsx-sheet-window-binary/1`): the binary sheet-window export —
108
+ * same parameters as `readRuntimeSessionSheetWindow`, returns the hybrid
109
+ * `{ schemaId, bytes, rest }` envelope instead of the serde'd DTO.
110
+ *
111
+ * OPTIONAL — feature-detected on the raw wasm module object so older
112
+ * builds keep mounting; use `readSheetWindowDecoded` (which feature-detects
113
+ * and falls back to the JSON export) rather than probing this directly.
114
+ */
115
+ readRuntimeSessionSheetWindowBinary?(handleId: string, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxSheetWindowBinaryEnvelope;
116
+ /**
117
+ * T5 convenience seam: binary sheet-window readback decoded to the exact
118
+ * `XlsxUiSheetWindowReadback` shape when the wasm build exposes
119
+ * `readRuntimeSessionSheetWindowBinary`; the JSON export otherwise. On a
120
+ * decode error the bridge logs once and permanently falls back to JSON
121
+ * for this bridge instance (defensive, not expected). One seam for all
122
+ * consumers — readback/tile-scheduler/painter code changes zero lines.
123
+ */
124
+ readSheetWindowDecoded(handleId: string, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxUiSheetWindowReadback;
125
+ readRuntimeSessionOverlayLanes(handleId: string, request?: XlsxUiOverlayLanesRequest): XlsxUiOverlayLanesReadback;
126
+ readRuntimeSessionKernelPanel(handleId: string, workflowContext?: XlsxWorkflowContextInput): XlsxKernelPanelReadback;
127
+ /**
128
+ * BR-3 (bridge v18): digest-addressed media bytes for a verified drawing
129
+ * media handle (`media:sha256:<64-hex>`). One-shot and uncached — the
130
+ * substrate recomputes the SHA-256 per call, so never invoke per paint
131
+ * frame; consumers keep a decode cache keyed by digest. Refusals throw
132
+ * typed `XlsxMediaAccessErrorCode` strings.
133
+ */
134
+ readRuntimeSessionMediaBytes(handleId: string, mediaId: string): XlsxMediaBytesReadback;
135
+ /**
136
+ * D4-R2b (bridge v20): digest-addressed chart XML for a verified drawing
137
+ * chart handle (`chart:sha256:<64-hex>`). One-shot and uncached — the
138
+ * substrate recomputes the SHA-256 per call, so never invoke per paint
139
+ * frame; consumers keep a preview store keyed by digest. The workbook
140
+ * theme XML rides along when present. Refusals throw typed
141
+ * `XlsxChartAccessErrorCode` strings.
142
+ */
143
+ readRuntimeSessionChartBytes(handleId: string, chartId: string): XlsxChartBytesReadback;
144
+ inspectWorkbook(bytes: Uint8Array, sourceLabel?: string): XlsxAiWorkbookInspection;
145
+ readPreserveOnlyEntities(bytes: Uint8Array, sourceLabel?: string): XlsxPreserveOnlyEntitiesReadback;
146
+ readRuntimeSessionPreserveOnlyEntities(handleId: string): XlsxPreserveOnlyEntitiesReadback;
147
+ listScopes(bytes: Uint8Array, request?: XlsxAiScopeListRequest): XlsxAiScopeListResult;
148
+ readCompressedContext(bytes: Uint8Array, request?: XlsxAiCompressedContextRequest): XlsxAiCompressedContextResult;
149
+ readCompressedDrilldown(bytes: Uint8Array, request: XlsxAiCompressedDrilldownRequest): XlsxAiCompressedDrilldownResult;
150
+ resolveReference(bytes: Uint8Array, query: XlsxAiReferenceQuery): XlsxAiReferenceResolution;
151
+ explainFormula(bytes: Uint8Array, target: XlsxScopeHandle | XlsxAiReferenceQuery): XlsxAiFormulaExplanationResult | XlsxAiReferenceResolution;
152
+ bindUiSession(bytes: Uint8Array, requestedActiveSheetId?: string): XlsxUiSessionBinding;
153
+ classifyUiState(namespace: XlsxUiStateNamespace): XlsxUiStateClass;
154
+ projectViewportHint(bytes: Uint8Array, hint: XlsxUiViewportHint): XlsxUiViewportReadback;
155
+ readSelection(bytes: Uint8Array, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput, selectionCursor?: XlsxUiSelectionCursor): XlsxUiSelectionReadback;
156
+ readSelectionSet(bytes: Uint8Array, request: XlsxSelectionSetRequest): XlsxUiSelectionSetReadback;
157
+ summarizeAccessibility(bytes: Uint8Array, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput): XlsxUiAccessibilitySummary;
158
+ readSheetWindow(bytes: Uint8Array, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxUiSheetWindowReadback;
159
+ readWorkflowOverlayLanes(bytes: Uint8Array, request?: XlsxUiOverlayLanesRequest): XlsxUiOverlayLanesReadback;
160
+ readKernelPanel(bytes: Uint8Array, workflowContext?: XlsxWorkflowContextInput): XlsxKernelPanelReadback;
161
+ validateKernelAction(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelActionValidation;
162
+ createKernelBinding(bytes: Uint8Array, request: XlsxKernelCreateRequest): XlsxKernelMutationResult;
163
+ updateKernelSource(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
164
+ startKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
165
+ completeKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
166
+ cancelKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
167
+ detachKernelOutput(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
168
+ deleteKernelBinding(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelMutationResult;
169
+ commitCellFormula(bytes: Uint8Array, request: XlsxFormulaCommitRequest): XlsxFormulaCommitResult;
170
+ recalculateFormulas(bytes: Uint8Array, request?: XlsxFormulaRecalculateRequest): XlsxFormulaRecalculateResult;
171
+ /**
172
+ * T1 (runtime-session-mutations-v1): stateful in-session mutation ports.
173
+ * Same request DTOs as the byte-based exports minus the bytes; results are
174
+ * the byte-based result DTOs with `exportedBytes` absent plus a `session`
175
+ * receipt block. Commits accumulate dirt; `recalculateInSession` drains it
176
+ * (mode "dirty" default, "full" forces the full plan).
177
+ *
178
+ * OPTIONAL — feature-detected on the raw wasm module object so older wasm
179
+ * builds (without the `runtime-session-mutations-v1` exports) still mount
180
+ * the bridge with the byte-based mutation surface intact. Use
181
+ * `supportsRuntimeSessionMutations(bridge)` before routing edits here.
182
+ */
183
+ commitCellFormulaInSession?(handleId: string, request: XlsxFormulaCommitRequest): XlsxFormulaCommitResult;
184
+ commitRangeClearInSession?(handleId: string, request: XlsxRangeClearCommitRequest): XlsxRangeClearCommitResult;
185
+ recalculateInSession?(handleId: string, request?: XlsxSessionRecalculateRequest): XlsxFormulaRecalculateResult;
186
+ exportRuntimeSessionBytes?(handleId: string, request?: XlsxRuntimeSessionExportRequest): XlsxRuntimeSessionExportResult;
187
+ /**
188
+ * X5-U-012: full-sheet delimited-text (CSV/TSV) export of one sheet, read
189
+ * only. Separately optional from the mutation family above — it landed
190
+ * later, so a wasm build can carry the mutation ports without it, and a
191
+ * caller must feature-detect this one method rather than assume it from
192
+ * `supportsRuntimeSessionMutations`.
193
+ */
194
+ exportRuntimeSessionDelimitedText?(handleId: string, request?: XlsxRuntimeSessionDelimitedExportRequest): XlsxRuntimeSessionDelimitedExportResult;
195
+ commitRangeFillInSession?(handleId: string, request: XlsxRangeFillCommitRequest): XlsxRangeFillCommitResult;
196
+ commitRangePasteInSession?(handleId: string, request: XlsxRangePasteCommitRequest): XlsxRangePasteCommitResult;
197
+ commitRangeTransferInSession?(handleId: string, request: XlsxRangeTransferCommitRequest): XlsxRangeTransferCommitResult;
198
+ commitRangeFormatInSession?(handleId: string, request: XlsxRangeFormatCommitRequest): XlsxRangeFormatCommitResult;
199
+ resizeColumnWidthInSession?(handleId: string, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
200
+ resizeRowHeightInSession?(handleId: string, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
201
+ setColumnHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
202
+ setRowHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
203
+ setFrozenPaneInSession?(handleId: string, request: XlsxFrozenPaneRequest): XlsxFrozenPaneResult;
204
+ mergeCellsInSession?(handleId: string, request: XlsxMergeCellsRequest): XlsxMergeCellsResult;
205
+ mutateSheetStructureInSession?(handleId: string, request: XlsxSheetStructureMutationRequest): XlsxSheetStructureMutationResult;
206
+ mutateSheetTabsInSession?(handleId: string, request: XlsxSheetTabMutationRequest): XlsxSheetTabMutationResult;
207
+ commitTableAppendRowInSession?(handleId: string, request: XlsxTableAppendRowRequest): XlsxTableAppendRowResult;
208
+ commitShiftCellsInSession?(handleId: string, request: XlsxShiftCellsCommitRequest): XlsxShiftCellsCommitResult;
209
+ /**
210
+ * UX-P-102 phase P2a (bridge v42): the six families that had only a bytes
211
+ * export now commit on the resident session too — selection-set paste /
212
+ * clear / format, hyperlink, data validation and review comment. Same
213
+ * request DTOs as their bytes exports; same results minus `exportedBytes`
214
+ * plus the `session` receipt.
215
+ */
216
+ commitSelectionSetPasteInSession?(handleId: string, request: XlsxSelectionSetPasteCommitRequest): XlsxRangePasteCommitResult;
217
+ commitSelectionSetClearInSession?(handleId: string, request: XlsxSelectionSetClearCommitRequest): XlsxRangeClearCommitResult;
218
+ commitSelectionSetFormatInSession?(handleId: string, request: XlsxSelectionSetFormatCommitRequest): XlsxRangeFormatCommitResult;
219
+ commitRangeHyperlinkInSession?(handleId: string, request: XlsxRangeHyperlinkCommitRequest): XlsxRangeHyperlinkCommitResult;
220
+ commitRangeDataValidationInSession?(handleId: string, request: XlsxRangeDataValidationCommitRequest): XlsxRangeDataValidationCommitResult;
221
+ commitReviewCommentInSession?(handleId: string, request: XlsxReviewCommentCommitRequest): XlsxReviewCommentCommitResult;
222
+ /**
223
+ * UX-P-102 phase P2b (bridge v43): the last six bytes-only families commit
224
+ * on the resident session too — filter apply / clear, sort, row / column
225
+ * outline-group visibility and outline level. Same request DTOs as their
226
+ * bytes exports; same results minus `exportedBytes` plus the `session`
227
+ * receipt.
228
+ */
229
+ commitApplyFilterInSession?(handleId: string, request: XlsxRangeFilterApplyRequest): XlsxRangeFilterResult;
230
+ commitClearFilterInSession?(handleId: string, request: XlsxRangeFilterClearRequest): XlsxRangeFilterResult;
231
+ commitApplySortInSession?(handleId: string, request: XlsxRangeSortRequest): XlsxRangeSortResult;
232
+ setRowOutlineGroupHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
233
+ setColumnOutlineGroupHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
234
+ setSheetOutlineLevelInSession?(handleId: string, request: XlsxOutlineLevelRequest): XlsxOutlineLevelResult;
235
+ /**
236
+ * X5-U-023 (bridge v44): Name Manager authoring on the resident session —
237
+ * create, edit or delete one workbook- or sheet-scoped defined name. Same
238
+ * request DTO as `defineName`; same result minus `exportedBytes` plus the
239
+ * `session` receipt. The commit drops the keep-alive graph, so the drain
240
+ * recalculates every reader in full.
241
+ */
242
+ defineNameInSession?(handleId: string, request: XlsxDefinedNameMutationRequest): XlsxDefinedNameMutationResult;
243
+ commitRangeFill(bytes: Uint8Array, request: XlsxRangeFillCommitRequest): XlsxRangeFillCommitResult;
244
+ commitRangePaste(bytes: Uint8Array, request: XlsxRangePasteCommitRequest): XlsxRangePasteCommitResult;
245
+ commitRangeTransfer(bytes: Uint8Array, request: XlsxRangeTransferCommitRequest): XlsxRangeTransferCommitResult;
246
+ commitRangeClear(bytes: Uint8Array, request: XlsxRangeClearCommitRequest): XlsxRangeClearCommitResult;
247
+ commitRangeFormat(bytes: Uint8Array, request: XlsxRangeFormatCommitRequest): XlsxRangeFormatCommitResult;
248
+ commitRangeHyperlink(bytes: Uint8Array, request: XlsxRangeHyperlinkCommitRequest): XlsxRangeHyperlinkCommitResult;
249
+ /**
250
+ * X5-U-011 (bridge v31): author or clear a data-validation rule over a range.
251
+ * v32: `ruleType` gains `any` and `time`, and the comparison kinds take an
252
+ * optional `operator` (single-bound operators read `minimum` alone).
253
+ */
254
+ commitRangeDataValidation(bytes: Uint8Array, request: XlsxRangeDataValidationCommitRequest): XlsxRangeDataValidationCommitResult;
255
+ /**
256
+ * X5-U-010b (bridge v33): the `review.comment` verb on one cell — create a
257
+ * note or a threaded comment, edit, reply, resolve, reopen, delete.
258
+ */
259
+ commitReviewComment(bytes: Uint8Array, request: XlsxReviewCommentCommitRequest): XlsxReviewCommentCommitResult;
260
+ commitSelectionSetPaste(bytes: Uint8Array, request: XlsxSelectionSetPasteCommitRequest): XlsxRangePasteCommitResult;
261
+ commitSelectionSetClear(bytes: Uint8Array, request: XlsxSelectionSetClearCommitRequest): XlsxRangeClearCommitResult;
262
+ commitSelectionSetFormat(bytes: Uint8Array, request: XlsxSelectionSetFormatCommitRequest): XlsxRangeFormatCommitResult;
263
+ resizeColumnWidth(bytes: Uint8Array, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
264
+ resizeRowHeight(bytes: Uint8Array, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
265
+ setColumnHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
266
+ setRowHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
267
+ /** X5-U-004 freeze/unfreeze panes (frozen-pane-v1). */
268
+ setFrozenPane(bytes: Uint8Array, request: XlsxFrozenPaneRequest): XlsxFrozenPaneResult;
269
+ /** X5-U-037 merge/unmerge cells (merge-cells-v1). */
270
+ mergeCells(bytes: Uint8Array, request: XlsxMergeCellsRequest): XlsxMergeCellsResult;
271
+ setColumnOutlineGroupHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
272
+ setRowOutlineGroupHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
273
+ setSheetOutlineLevel(bytes: Uint8Array, request: XlsxOutlineLevelRequest): XlsxOutlineLevelResult;
274
+ mutateSheetStructure(bytes: Uint8Array, request: XlsxSheetStructureMutationRequest): XlsxSheetStructureMutationResult;
275
+ commitTableAppendRow(bytes: Uint8Array, request: XlsxTableAppendRowRequest): XlsxTableAppendRowResult;
276
+ commitApplyFilter(bytes: Uint8Array, request: XlsxRangeFilterApplyRequest): XlsxRangeFilterResult;
277
+ commitClearFilter(bytes: Uint8Array, request: XlsxRangeFilterClearRequest): XlsxRangeFilterResult;
278
+ commitApplySort(bytes: Uint8Array, request: XlsxRangeSortRequest): XlsxRangeSortResult;
279
+ mutateSheetTabs(bytes: Uint8Array, request: XlsxSheetTabMutationRequest): XlsxSheetTabMutationResult;
280
+ /** X5-U-023 (bridge v44): create, edit or delete one defined name, then export (defined-names-v1). */
281
+ defineName(bytes: Uint8Array, request: XlsxDefinedNameMutationRequest): XlsxDefinedNameMutationResult;
282
+ /** X5-U-006 insert/delete cells with shift (shift-cells-v1). */
283
+ commitShiftCells(bytes: Uint8Array, request: XlsxShiftCellsCommitRequest): XlsxShiftCellsCommitResult;
284
+ }
285
+ export interface XlsxWasmBridgeLoadResult {
286
+ readonly wasmBinding: "mounted" | "not-mounted";
287
+ readonly bridge?: XlsxWasmBridge;
288
+ readonly reason?: string;
289
+ }
290
+ /**
291
+ * T1: bridge narrowed to the runtime-session-mutations-v1 surface. Produced
292
+ * by `supportsRuntimeSessionMutations`; never construct by casting.
293
+ */
294
+ export interface XlsxRuntimeSessionMutationBridge extends XlsxWasmBridge {
295
+ commitCellFormulaInSession(handleId: string, request: XlsxFormulaCommitRequest): XlsxFormulaCommitResult;
296
+ commitRangeClearInSession(handleId: string, request: XlsxRangeClearCommitRequest): XlsxRangeClearCommitResult;
297
+ recalculateInSession(handleId: string, request?: XlsxSessionRecalculateRequest): XlsxFormulaRecalculateResult;
298
+ exportRuntimeSessionBytes(handleId: string, request?: XlsxRuntimeSessionExportRequest): XlsxRuntimeSessionExportResult;
299
+ commitRangeFillInSession(handleId: string, request: XlsxRangeFillCommitRequest): XlsxRangeFillCommitResult;
300
+ commitRangePasteInSession(handleId: string, request: XlsxRangePasteCommitRequest): XlsxRangePasteCommitResult;
301
+ commitRangeTransferInSession(handleId: string, request: XlsxRangeTransferCommitRequest): XlsxRangeTransferCommitResult;
302
+ commitRangeFormatInSession(handleId: string, request: XlsxRangeFormatCommitRequest): XlsxRangeFormatCommitResult;
303
+ resizeColumnWidthInSession(handleId: string, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
304
+ resizeRowHeightInSession(handleId: string, request: XlsxLayoutMetricResizeRequest): XlsxLayoutMetricResizeResult;
305
+ setColumnHiddenInSession(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
306
+ setRowHiddenInSession(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxLayoutMetricVisibilityResult;
307
+ setFrozenPaneInSession(handleId: string, request: XlsxFrozenPaneRequest): XlsxFrozenPaneResult;
308
+ mergeCellsInSession(handleId: string, request: XlsxMergeCellsRequest): XlsxMergeCellsResult;
309
+ mutateSheetStructureInSession(handleId: string, request: XlsxSheetStructureMutationRequest): XlsxSheetStructureMutationResult;
310
+ mutateSheetTabsInSession(handleId: string, request: XlsxSheetTabMutationRequest): XlsxSheetTabMutationResult;
311
+ commitTableAppendRowInSession(handleId: string, request: XlsxTableAppendRowRequest): XlsxTableAppendRowResult;
312
+ commitShiftCellsInSession(handleId: string, request: XlsxShiftCellsCommitRequest): XlsxShiftCellsCommitResult;
313
+ commitSelectionSetPasteInSession(handleId: string, request: XlsxSelectionSetPasteCommitRequest): XlsxRangePasteCommitResult;
314
+ commitSelectionSetClearInSession(handleId: string, request: XlsxSelectionSetClearCommitRequest): XlsxRangeClearCommitResult;
315
+ commitSelectionSetFormatInSession(handleId: string, request: XlsxSelectionSetFormatCommitRequest): XlsxRangeFormatCommitResult;
316
+ commitRangeHyperlinkInSession(handleId: string, request: XlsxRangeHyperlinkCommitRequest): XlsxRangeHyperlinkCommitResult;
317
+ commitRangeDataValidationInSession(handleId: string, request: XlsxRangeDataValidationCommitRequest): XlsxRangeDataValidationCommitResult;
318
+ commitReviewCommentInSession(handleId: string, request: XlsxReviewCommentCommitRequest): XlsxReviewCommentCommitResult;
319
+ commitApplyFilterInSession(handleId: string, request: XlsxRangeFilterApplyRequest): XlsxRangeFilterResult;
320
+ commitClearFilterInSession(handleId: string, request: XlsxRangeFilterClearRequest): XlsxRangeFilterResult;
321
+ commitApplySortInSession(handleId: string, request: XlsxRangeSortRequest): XlsxRangeSortResult;
322
+ setRowOutlineGroupHiddenInSession(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
323
+ setColumnOutlineGroupHiddenInSession(handleId: string, request: XlsxLayoutMetricVisibilityRequest): XlsxOutlineGroupVisibilityResult;
324
+ setSheetOutlineLevelInSession(handleId: string, request: XlsxOutlineLevelRequest): XlsxOutlineLevelResult;
325
+ defineNameInSession(handleId: string, request: XlsxDefinedNameMutationRequest): XlsxDefinedNameMutationResult;
326
+ }
327
+ /**
328
+ * T1 feature detection: true when the mounted wasm build advertises
329
+ * `runtime-session-mutations-v1` AND the session-mutation methods were
330
+ * attached from the raw module object. Older wasm builds fail this check and
331
+ * callers must stay on the byte-based mutation surface (see
332
+ * `createXlsxWorkbookMutationRouter` for the routing/fallback seam).
333
+ */
334
+ /**
335
+ * The capabilities in `required` that `bridge` does not advertise. Hosts gate
336
+ * on the capabilities they call instead of pinning a bridge version, which
337
+ * changes whenever the native contract grows.
338
+ */
339
+ export declare function missingXlsxWasmCapabilities(bridge: XlsxWasmBridge, required: readonly string[]): string[];
340
+ export declare function supportsRuntimeSessionMutations(bridge: XlsxWasmBridge): bridge is XlsxRuntimeSessionMutationBridge;
341
+ export interface RawXlsxWasmModule extends RawXlsxAiSessionModule {
342
+ getWasmStatus(): XlsxWasmBridgeStatus;
343
+ openWorkbookRuntimeSession(bytes: Uint8Array, request?: XlsxRuntimeSessionOpenRequest): XlsxRuntimeSessionHandle;
344
+ disposeWorkbookRuntimeSession(handleId: string): XlsxRuntimeSessionDisposeResult;
345
+ inspectWorkbookRuntimeSession(handleId: string): XlsxAiWorkbookInspection;
346
+ listRuntimeSessionScopes(handleId: string, request?: XlsxAiScopeListRequest): XlsxAiScopeListResult;
347
+ readRuntimeSessionCompressedContext(handleId: string, request?: XlsxAiCompressedContextRequest): XlsxAiCompressedContextResult;
348
+ readRuntimeSessionCompressedDrilldown(handleId: string, request: XlsxAiCompressedDrilldownRequest): XlsxAiCompressedDrilldownResult;
349
+ explainRuntimeSessionFormula(handleId: string, target: XlsxScopeHandle | XlsxAiReferenceQuery): XlsxAiFormulaExplanationResult | XlsxAiReferenceResolution;
350
+ bindUiRuntimeSession(handleId: string, requestedActiveSheetId?: string): XlsxUiSessionBinding;
351
+ readRuntimeSessionSelection(handleId: string, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput, selectionCursor?: XlsxUiSelectionCursor): XlsxUiSelectionReadback;
352
+ readRuntimeSessionSelectionSet(handleId: string, request: XlsxSelectionSetRequest): XlsxUiSelectionSetReadback;
353
+ summarizeRuntimeSessionAccessibility(handleId: string, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput): XlsxUiAccessibilitySummary;
354
+ /**
355
+ * X5-U-038 (bridge v34): Excel's Find over the canonical session workbook
356
+ * — current sheet or every visible sheet, values or formulas, match case,
357
+ * match entire cell, `?` `*` `~` wildcards. Read-only; the answer is the
358
+ * ordered match list with a cell handle per match and the count facts, or
359
+ * the typed refusal of the query.
360
+ */
361
+ findInRuntimeSession(handleId: string, request: XlsxFindRequest): XlsxFindResult;
362
+ /**
363
+ * X5-U-023 (bridge v35): name-box / Go To resolution over the canonical
364
+ * session workbook — an address, a range, whole rows or columns, a
365
+ * sheet-qualified reference, or a defined name with Excel's scope
366
+ * precedence. Read-only; the answer is the target sheet, range, label and
367
+ * the selection handle the selection command takes, or a typed refusal.
368
+ */
369
+ goToInRuntimeSession(handleId: string, request: XlsxGoToRequest): XlsxGoToResult;
370
+ /** X3-R-012 (bridge v40): Excel's Ctrl+Arrow / Ctrl+Shift+Arrow / Ctrl+A targets over the canonical session workbook. Read-only. */
371
+ dataRegionInRuntimeSession(handleId: string, request: XlsxDataRegionRequest): XlsxDataRegionResult;
372
+ readRuntimeSessionSheetWindow(handleId: string, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxUiSheetWindowReadback;
373
+ /**
374
+ * Optional T5 binary sheet-window export — absent on wasm builds older
375
+ * than `sheet-window-binary-v1`; the mount gate does not require it.
376
+ */
377
+ readRuntimeSessionSheetWindowBinary?(handleId: string, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): RawXlsxSheetWindowBinaryEnvelope;
378
+ readRuntimeSessionOverlayLanes(handleId: string, request?: XlsxUiOverlayLanesRequest): XlsxUiOverlayLanesReadback;
379
+ readRuntimeSessionKernelPanel(handleId: string, workflowContext?: XlsxWorkflowContextInput): XlsxKernelPanelReadback;
380
+ readRuntimeSessionMediaBytes(handleId: string, mediaId: string): RawXlsxMediaBytesReadback;
381
+ readRuntimeSessionChartBytes(handleId: string, chartId: string): XlsxChartBytesReadback;
382
+ inspectWorkbook(bytes: Uint8Array, sourceLabel?: string): XlsxAiWorkbookInspection;
383
+ readPreserveOnlyEntities(bytes: Uint8Array, sourceLabel?: string): XlsxPreserveOnlyEntitiesReadback;
384
+ readRuntimeSessionPreserveOnlyEntities(handleId: string): XlsxPreserveOnlyEntitiesReadback;
385
+ listScopes(bytes: Uint8Array, request?: XlsxAiScopeListRequest): XlsxAiScopeListResult;
386
+ readCompressedContext(bytes: Uint8Array, request?: XlsxAiCompressedContextRequest): XlsxAiCompressedContextResult;
387
+ readCompressedDrilldown(bytes: Uint8Array, request: XlsxAiCompressedDrilldownRequest): XlsxAiCompressedDrilldownResult;
388
+ resolveReference(bytes: Uint8Array, query: XlsxAiReferenceQuery): XlsxAiReferenceResolution;
389
+ explainFormula(bytes: Uint8Array, target: XlsxScopeHandle | XlsxAiReferenceQuery): XlsxAiFormulaExplanationResult | XlsxAiReferenceResolution;
390
+ bindUiSession(bytes: Uint8Array, requestedActiveSheetId?: string): XlsxUiSessionBinding;
391
+ classifyUiState(namespace: XlsxUiStateNamespace): XlsxUiStateClass;
392
+ projectViewportHint(bytes: Uint8Array, hint: XlsxUiViewportHint): XlsxUiViewportReadback;
393
+ readSelection(bytes: Uint8Array, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput, selectionCursor?: XlsxUiSelectionCursor): XlsxUiSelectionReadback;
394
+ readSelectionSet(bytes: Uint8Array, request: XlsxSelectionSetRequest): XlsxUiSelectionSetReadback;
395
+ summarizeAccessibility(bytes: Uint8Array, handle: XlsxScopeHandle, viewportHint?: XlsxUiViewportHint, workflowContext?: XlsxWorkflowContextInput): XlsxUiAccessibilitySummary;
396
+ readSheetWindow(bytes: Uint8Array, viewportHint: XlsxUiViewportHint, activeHandle?: XlsxScopeHandle, workflowContext?: XlsxWorkflowContextInput): XlsxUiSheetWindowReadback;
397
+ readWorkflowOverlayLanes(bytes: Uint8Array, request?: XlsxUiOverlayLanesRequest): XlsxUiOverlayLanesReadback;
398
+ readKernelPanel(bytes: Uint8Array, workflowContext?: XlsxWorkflowContextInput): XlsxKernelPanelReadback;
399
+ validateKernelAction(bytes: Uint8Array, request: XlsxKernelActionRequest): XlsxKernelActionValidation;
400
+ createKernelBinding(bytes: Uint8Array, request: XlsxKernelCreateRequest): RawXlsxKernelMutationResult;
401
+ updateKernelSource(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
402
+ startKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
403
+ completeKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
404
+ cancelKernelRun(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
405
+ detachKernelOutput(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
406
+ deleteKernelBinding(bytes: Uint8Array, request: XlsxKernelActionRequest): RawXlsxKernelMutationResult;
407
+ commitCellFormula(bytes: Uint8Array, request: XlsxFormulaCommitRequest): RawXlsxFormulaCommitResult;
408
+ recalculateFormulas(bytes: Uint8Array, request?: XlsxFormulaRecalculateRequest): RawXlsxFormulaRecalculateResult;
409
+ /**
410
+ * Optional runtime-session-mutations-v1 exports — absent on older
411
+ * generated wasm builds; the mount gate does not require them.
412
+ */
413
+ commitCellFormulaInSession?(handleId: string, request: XlsxFormulaCommitRequest): RawXlsxFormulaCommitResult;
414
+ commitRangeClearInSession?(handleId: string, request: XlsxRangeClearCommitRequest): RawXlsxRangeClearCommitResult;
415
+ recalculateInSession?(handleId: string, request?: XlsxSessionRecalculateRequest): RawXlsxFormulaRecalculateResult;
416
+ exportRuntimeSessionBytes?(handleId: string, request?: XlsxRuntimeSessionExportRequest): RawXlsxRuntimeSessionExportResult;
417
+ /** X5-U-012 delimited-text export; absent on wasm builds older than it. */
418
+ exportRuntimeSessionDelimitedText?(handleId: string, request?: XlsxRuntimeSessionDelimitedExportRequest): XlsxRuntimeSessionDelimitedExportResult;
419
+ commitRangeFillInSession?(handleId: string, request: XlsxRangeFillCommitRequest): RawXlsxRangeFillCommitResult;
420
+ commitRangePasteInSession?(handleId: string, request: XlsxRangePasteCommitRequest): RawXlsxRangePasteCommitResult;
421
+ commitRangeTransferInSession?(handleId: string, request: XlsxRangeTransferCommitRequest): RawXlsxRangeTransferCommitResult;
422
+ commitRangeFormatInSession?(handleId: string, request: XlsxRangeFormatCommitRequest): RawXlsxRangeFormatCommitResult;
423
+ resizeColumnWidthInSession?(handleId: string, request: XlsxLayoutMetricResizeRequest): RawXlsxLayoutMetricResizeResult;
424
+ resizeRowHeightInSession?(handleId: string, request: XlsxLayoutMetricResizeRequest): RawXlsxLayoutMetricResizeResult;
425
+ setColumnHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): RawXlsxLayoutMetricVisibilityResult;
426
+ setRowHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): RawXlsxLayoutMetricVisibilityResult;
427
+ setFrozenPaneInSession?(handleId: string, request: XlsxFrozenPaneRequest): RawXlsxFrozenPaneResult;
428
+ mergeCellsInSession?(handleId: string, request: XlsxMergeCellsRequest): RawXlsxMergeCellsResult;
429
+ mutateSheetStructureInSession?(handleId: string, request: XlsxSheetStructureMutationRequest): RawXlsxSheetStructureMutationResult;
430
+ mutateSheetTabsInSession?(handleId: string, request: XlsxSheetTabMutationRequest): RawXlsxSheetTabMutationResult;
431
+ commitTableAppendRowInSession?(handleId: string, request: XlsxTableAppendRowRequest): RawXlsxTableAppendRowResult;
432
+ commitShiftCellsInSession?(handleId: string, request: XlsxShiftCellsCommitRequest): RawXlsxShiftCellsCommitResult;
433
+ commitSelectionSetPasteInSession?(handleId: string, request: XlsxSelectionSetPasteCommitRequest): RawXlsxRangePasteCommitResult;
434
+ commitSelectionSetClearInSession?(handleId: string, request: XlsxSelectionSetClearCommitRequest): RawXlsxRangeClearCommitResult;
435
+ commitSelectionSetFormatInSession?(handleId: string, request: XlsxSelectionSetFormatCommitRequest): RawXlsxRangeFormatCommitResult;
436
+ commitRangeHyperlinkInSession?(handleId: string, request: XlsxRangeHyperlinkCommitRequest): RawXlsxRangeHyperlinkCommitResult;
437
+ commitRangeDataValidationInSession?(handleId: string, request: XlsxRangeDataValidationCommitRequest): RawXlsxRangeDataValidationCommitResult;
438
+ commitReviewCommentInSession?(handleId: string, request: XlsxReviewCommentCommitRequest): RawXlsxReviewCommentCommitResult;
439
+ commitApplyFilterInSession?(handleId: string, request: XlsxRangeFilterApplyRequest): RawXlsxRangeFilterResult;
440
+ commitClearFilterInSession?(handleId: string, request: XlsxRangeFilterClearRequest): RawXlsxRangeFilterResult;
441
+ commitApplySortInSession?(handleId: string, request: XlsxRangeSortRequest): RawXlsxRangeSortResult;
442
+ setRowOutlineGroupHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): RawXlsxOutlineGroupVisibilityResult;
443
+ setColumnOutlineGroupHiddenInSession?(handleId: string, request: XlsxLayoutMetricVisibilityRequest): RawXlsxOutlineGroupVisibilityResult;
444
+ setSheetOutlineLevelInSession?(handleId: string, request: XlsxOutlineLevelRequest): RawXlsxOutlineLevelResult;
445
+ defineNameInSession?(handleId: string, request: XlsxDefinedNameMutationRequest): RawXlsxDefinedNameMutationResult;
446
+ commitRangeFill(bytes: Uint8Array, request: XlsxRangeFillCommitRequest): RawXlsxRangeFillCommitResult;
447
+ commitRangePaste(bytes: Uint8Array, request: XlsxRangePasteCommitRequest): RawXlsxRangePasteCommitResult;
448
+ commitRangeTransfer(bytes: Uint8Array, request: XlsxRangeTransferCommitRequest): RawXlsxRangeTransferCommitResult;
449
+ commitRangeClear(bytes: Uint8Array, request: XlsxRangeClearCommitRequest): RawXlsxRangeClearCommitResult;
450
+ commitRangeFormat(bytes: Uint8Array, request: XlsxRangeFormatCommitRequest): RawXlsxRangeFormatCommitResult;
451
+ commitRangeHyperlink(bytes: Uint8Array, request: XlsxRangeHyperlinkCommitRequest): RawXlsxRangeHyperlinkCommitResult;
452
+ commitRangeDataValidation(bytes: Uint8Array, request: XlsxRangeDataValidationCommitRequest): RawXlsxRangeDataValidationCommitResult;
453
+ commitReviewComment(bytes: Uint8Array, request: XlsxReviewCommentCommitRequest): RawXlsxReviewCommentCommitResult;
454
+ commitSelectionSetPaste(bytes: Uint8Array, request: XlsxSelectionSetPasteCommitRequest): RawXlsxRangePasteCommitResult;
455
+ commitSelectionSetClear(bytes: Uint8Array, request: XlsxSelectionSetClearCommitRequest): RawXlsxRangeClearCommitResult;
456
+ commitSelectionSetFormat(bytes: Uint8Array, request: XlsxSelectionSetFormatCommitRequest): RawXlsxRangeFormatCommitResult;
457
+ resizeColumnWidth(bytes: Uint8Array, request: XlsxLayoutMetricResizeRequest): RawXlsxLayoutMetricResizeResult;
458
+ resizeRowHeight(bytes: Uint8Array, request: XlsxLayoutMetricResizeRequest): RawXlsxLayoutMetricResizeResult;
459
+ setColumnHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): RawXlsxLayoutMetricVisibilityResult;
460
+ setRowHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): RawXlsxLayoutMetricVisibilityResult;
461
+ setFrozenPane(bytes: Uint8Array, request: XlsxFrozenPaneRequest): RawXlsxFrozenPaneResult;
462
+ mergeCells(bytes: Uint8Array, request: XlsxMergeCellsRequest): RawXlsxMergeCellsResult;
463
+ setColumnOutlineGroupHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): RawXlsxOutlineGroupVisibilityResult;
464
+ setRowOutlineGroupHidden(bytes: Uint8Array, request: XlsxLayoutMetricVisibilityRequest): RawXlsxOutlineGroupVisibilityResult;
465
+ setSheetOutlineLevel(bytes: Uint8Array, request: XlsxOutlineLevelRequest): RawXlsxOutlineLevelResult;
466
+ mutateSheetStructure(bytes: Uint8Array, request: XlsxSheetStructureMutationRequest): RawXlsxSheetStructureMutationResult;
467
+ commitTableAppendRow(bytes: Uint8Array, request: XlsxTableAppendRowRequest): RawXlsxTableAppendRowResult;
468
+ commitApplyFilter(bytes: Uint8Array, request: XlsxRangeFilterApplyRequest): RawXlsxRangeFilterResult;
469
+ commitClearFilter(bytes: Uint8Array, request: XlsxRangeFilterClearRequest): RawXlsxRangeFilterResult;
470
+ commitApplySort(bytes: Uint8Array, request: XlsxRangeSortRequest): RawXlsxRangeSortResult;
471
+ mutateSheetTabs(bytes: Uint8Array, request: XlsxSheetTabMutationRequest): RawXlsxSheetTabMutationResult;
472
+ defineName(bytes: Uint8Array, request: XlsxDefinedNameMutationRequest): RawXlsxDefinedNameMutationResult;
473
+ commitShiftCells(bytes: Uint8Array, request: XlsxShiftCellsCommitRequest): RawXlsxShiftCellsCommitResult;
474
+ }
475
+ type RawXlsxFormulaCommitResult = Omit<XlsxFormulaCommitResult, "exportedBytes"> & {
476
+ readonly exportedBytes?: Uint8Array | readonly number[];
477
+ };
478
+ type RawXlsxFormulaRecalculateResult = Omit<XlsxFormulaRecalculateResult, "exportedBytes"> & {
479
+ readonly exportedBytes?: Uint8Array | readonly number[];
480
+ };
481
+ type RawXlsxRangeFillCommitResult = Omit<XlsxRangeFillCommitResult, "exportedBytes"> & {
482
+ readonly exportedBytes?: Uint8Array | readonly number[];
483
+ };
484
+ type RawXlsxRangePasteCommitResult = Omit<XlsxRangePasteCommitResult, "exportedBytes"> & {
485
+ readonly exportedBytes?: Uint8Array | readonly number[];
486
+ };
487
+ type RawXlsxRangeTransferCommitResult = Omit<XlsxRangeTransferCommitResult, "exportedBytes"> & {
488
+ readonly exportedBytes?: Uint8Array | readonly number[];
489
+ };
490
+ type RawXlsxRangeClearCommitResult = Omit<XlsxRangeClearCommitResult, "exportedBytes"> & {
491
+ readonly exportedBytes?: Uint8Array | readonly number[];
492
+ };
493
+ type RawXlsxRangeFormatCommitResult = Omit<XlsxRangeFormatCommitResult, "exportedBytes"> & {
494
+ readonly exportedBytes?: Uint8Array | readonly number[];
495
+ };
496
+ type RawXlsxRangeHyperlinkCommitResult = Omit<XlsxRangeHyperlinkCommitResult, "exportedBytes"> & {
497
+ readonly exportedBytes?: Uint8Array | readonly number[];
498
+ };
499
+ type RawXlsxRangeDataValidationCommitResult = Omit<XlsxRangeDataValidationCommitResult, "exportedBytes"> & {
500
+ readonly exportedBytes?: Uint8Array | readonly number[];
501
+ };
502
+ type RawXlsxReviewCommentCommitResult = Omit<XlsxReviewCommentCommitResult, "exportedBytes"> & {
503
+ readonly exportedBytes?: Uint8Array | readonly number[];
504
+ };
505
+ type RawXlsxLayoutMetricResizeResult = Omit<XlsxLayoutMetricResizeResult, "exportedBytes"> & {
506
+ readonly exportedBytes?: Uint8Array | readonly number[];
507
+ };
508
+ type RawXlsxLayoutMetricVisibilityResult = Omit<XlsxLayoutMetricVisibilityResult, "exportedBytes"> & {
509
+ readonly exportedBytes?: Uint8Array | readonly number[];
510
+ };
511
+ type RawXlsxOutlineGroupVisibilityResult = Omit<XlsxOutlineGroupVisibilityResult, "exportedBytes"> & {
512
+ readonly exportedBytes?: Uint8Array | readonly number[];
513
+ };
514
+ type RawXlsxOutlineLevelResult = Omit<XlsxOutlineLevelResult, "exportedBytes"> & {
515
+ readonly exportedBytes?: Uint8Array | readonly number[];
516
+ };
517
+ type RawXlsxFrozenPaneResult = Omit<XlsxFrozenPaneResult, "exportedBytes"> & {
518
+ readonly exportedBytes?: Uint8Array | readonly number[];
519
+ };
520
+ type RawXlsxMergeCellsResult = Omit<XlsxMergeCellsResult, "exportedBytes"> & {
521
+ readonly exportedBytes?: Uint8Array | readonly number[];
522
+ };
523
+ type RawXlsxSheetStructureMutationResult = Omit<XlsxSheetStructureMutationResult, "exportedBytes"> & {
524
+ readonly exportedBytes?: Uint8Array | readonly number[];
525
+ };
526
+ type RawXlsxTableAppendRowResult = Omit<XlsxTableAppendRowResult, "exportedBytes"> & {
527
+ readonly exportedBytes?: Uint8Array | readonly number[];
528
+ };
529
+ type RawXlsxRangeFilterResult = Omit<XlsxRangeFilterResult, "exportedBytes"> & {
530
+ readonly exportedBytes?: Uint8Array | readonly number[];
531
+ };
532
+ type RawXlsxRangeSortResult = Omit<XlsxRangeSortResult, "exportedBytes"> & {
533
+ readonly exportedBytes?: Uint8Array | readonly number[];
534
+ };
535
+ type RawXlsxSheetTabMutationResult = Omit<XlsxSheetTabMutationResult, "exportedBytes"> & {
536
+ readonly exportedBytes?: Uint8Array | readonly number[];
537
+ };
538
+ type RawXlsxDefinedNameMutationResult = Omit<XlsxDefinedNameMutationResult, "exportedBytes"> & {
539
+ readonly exportedBytes?: Uint8Array | readonly number[];
540
+ };
541
+ type RawXlsxShiftCellsCommitResult = Omit<XlsxShiftCellsCommitResult, "exportedBytes"> & {
542
+ readonly exportedBytes?: Uint8Array | readonly number[];
543
+ };
544
+ type RawXlsxKernelMutationResult = Omit<XlsxKernelMutationResult, "exportedBytes"> & {
545
+ readonly exportedBytes?: Uint8Array | readonly number[];
546
+ };
547
+ type RawXlsxRuntimeSessionExportResult = Omit<XlsxRuntimeSessionExportResult, "exportedBytes"> & {
548
+ readonly exportedBytes?: Uint8Array | readonly number[];
549
+ };
550
+ /**
551
+ * BR-3 (bridge v18) media-bytes readback: digest-verified bytes plus the
552
+ * allowlisted content type and SHA-256 hex digest.
553
+ */
554
+ export interface XlsxMediaBytesReadback {
555
+ readonly bytes: Uint8Array;
556
+ readonly contentType: string;
557
+ readonly sha256: string;
558
+ }
559
+ /**
560
+ * Typed refusal codes thrown by `readRuntimeSessionMediaBytes` — the
561
+ * one-to-one wire mirror of the substrate `MediaAccessError` variants.
562
+ */
563
+ export type XlsxMediaAccessErrorCode = "invalid-media-id" | "unknown-media-id" | "disallowed-path" | "disallowed-content-type" | "digest-mismatch";
564
+ type RawXlsxMediaBytesReadback = Omit<XlsxMediaBytesReadback, "bytes"> & {
565
+ readonly bytes: Uint8Array | readonly number[];
566
+ };
567
+ type RawXlsxSheetWindowBinaryEnvelope = Omit<XlsxSheetWindowBinaryEnvelope, "bytes"> & {
568
+ readonly bytes: Uint8Array | readonly number[];
569
+ };
570
+ /**
571
+ * D4-R2b (bridge v20) chart-bytes readback: digest-verified chart XML plus
572
+ * the workbook theme XML (when present) and the SHA-256 hex digest. Strings
573
+ * cross the bridge as-is — no byte normalization needed.
574
+ */
575
+ export interface XlsxChartBytesReadback {
576
+ readonly chartXml: string;
577
+ readonly themeXml?: string;
578
+ readonly sha256: string;
579
+ }
580
+ /**
581
+ * Typed refusal codes thrown by `readRuntimeSessionChartBytes` — the
582
+ * one-to-one wire mirror of the substrate `ChartAccessError` variants
583
+ * (same kebab vocabulary as the media family).
584
+ */
585
+ export type XlsxChartAccessErrorCode = "invalid-chart-id" | "unknown-chart-id" | "disallowed-path" | "disallowed-content-type" | "digest-mismatch";
586
+ export { createSheetWindowDecodedReader, decodeSheetWindowBinary, SHEET_WINDOW_BINARY_SCHEMA_ID, type SheetWindowBinaryDecodeOptions, type SheetWindowDecodedReaderDeps, type XlsxSheetWindowBinaryEnvelope, type XlsxSheetWindowBinaryRest, type XlsxSheetWindowRareCell } from "./sheet-window-binary.ts";
587
+ export interface XlsxPreserveOnlyEntityReadback {
588
+ readonly key: string;
589
+ readonly kind: "chart" | "pivot-table" | "pivot-cache" | "solver-model" | "scenario" | "external-source" | "validation-region" | "comment-thread" | "unknown";
590
+ readonly sourceLabel: string;
591
+ readonly sourceDigestPrefix: string;
592
+ readonly provenance: "generated" | "derived" | "marker-backed";
593
+ readonly editable: boolean;
594
+ }
595
+ export interface XlsxPreserveOnlyEntitiesReadback {
596
+ readonly verdict: "available";
597
+ readonly entityCount: number;
598
+ readonly entities: readonly XlsxPreserveOnlyEntityReadback[];
599
+ }
600
+ /**
601
+ * R5: the bridge version this package mounts. A host reports it with
602
+ * `generatedWasmModuleSha256()`; the package version policy (README, the
603
+ * package.json `conductor` field) moves the MINOR version whenever the
604
+ * published value of this constant changes.
605
+ */
606
+ export declare const BRIDGE_VERSION: XlsxWasmBridgeStatus["bridgeVersion"];
607
+ /**
608
+ * R5: the capabilities every mounted bridge advertises (the mount gate's
609
+ * list). Hosts gate on the capabilities they call; see
610
+ * `missingXlsxWasmCapabilities`.
611
+ */
612
+ export declare const BRIDGE_CAPABILITIES: readonly string[];
613
+ /**
614
+ * Result of validating a raw wasm module object against the bridge
615
+ * contract. `reason` is the soft not-mounted loader reason;
616
+ * `requiredModeMessage` is the message loaders throw in required mode
617
+ * (identical to `reason` except where the historical node loader
618
+ * distinguished them).
619
+ */
620
+ export type XlsxRawWasmModuleValidation = {
621
+ readonly ok: true;
622
+ readonly status: XlsxWasmBridgeStatus;
623
+ } | {
624
+ readonly ok: false;
625
+ readonly reason: string;
626
+ readonly requiredModeMessage: string;
627
+ };
628
+ /**
629
+ * Target-independent mount gate: role, bridge version, required
630
+ * capabilities, and required raw methods. Both the Node.js loader
631
+ * (`loadGeneratedXlsxWasmBridge`) and the browser loader
632
+ * (`loadXlsxWasmBridgeWeb`) run this exact check so the two artifacts can
633
+ * never mount divergent contracts.
634
+ */
635
+ export declare function validateRawXlsxWasmModule(raw: RawXlsxWasmModule): XlsxRawWasmModuleValidation;
636
+ /**
637
+ * Wrap a raw wasm module object in the typed bridge. Every call goes through
638
+ * `runtime` (R4): pre-admission against the memory budget before open and
639
+ * recalculate, and trap containment at the call boundary. Without a runtime
640
+ * the bridge builds one over `source` that can contain a trap but has no
641
+ * Module to re-instantiate from (the loaders always pass one that can).
642
+ */
643
+ export declare function createXlsxWasmBridge(source: RawXlsxWasmModule, status?: XlsxWasmBridgeStatus, runtime?: XlsxWasmRuntime): XlsxWasmBridge;