@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.
- package/LICENSE.md +31 -0
- package/README.md +135 -2
- package/dist/ai/agent-metadata.d.ts +363 -0
- package/dist/ai/agent-metadata.js +227 -0
- package/dist/ai/index.d.ts +6 -0
- package/dist/ai/index.js +7 -0
- package/dist/ai/mutation-bridge.d.ts +82 -0
- package/dist/ai/mutation-bridge.js +179 -0
- package/dist/ai/types.d.ts +765 -0
- package/dist/ai/types.js +23 -0
- package/dist/index.d.ts +50 -0
- package/dist/index.js +90 -0
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.js +1 -0
- package/dist/runtime/types.d.ts +1435 -0
- package/dist/runtime/types.js +15 -0
- package/dist/shared.d.ts +69 -0
- package/dist/shared.js +1 -0
- package/dist/ui/index.d.ts +2 -0
- package/dist/ui/index.js +1 -0
- package/dist/ui/types.d.ts +765 -0
- package/dist/ui/types.js +12 -0
- package/dist/wasm/ai-session-bridge.d.ts +97 -0
- package/dist/wasm/ai-session-bridge.js +154 -0
- package/dist/wasm/bridge-contract.d.ts +643 -0
- package/dist/wasm/bridge-contract.js +1001 -0
- package/dist/wasm/index.d.ts +50 -0
- package/dist/wasm/index.js +297 -0
- package/dist/wasm/memory-budget.d.ts +77 -0
- package/dist/wasm/memory-budget.js +532 -0
- package/dist/wasm/runtime-guard.d.ts +141 -0
- package/dist/wasm/runtime-guard.js +373 -0
- package/dist/wasm/session-router.d.ts +98 -0
- package/dist/wasm/session-router.js +184 -0
- package/dist/wasm/sheet-window-binary-reference.d.ts +9 -0
- package/dist/wasm/sheet-window-binary-reference.js +308 -0
- package/dist/wasm/sheet-window-binary.d.ts +279 -0
- package/dist/wasm/sheet-window-binary.js +636 -0
- package/dist/wasm/web.d.ts +72 -0
- package/dist/wasm/web.js +142 -0
- package/generated/wasm-web/package.json +3 -0
- package/generated/wasm-web/snippets/ironcalc_base-89b4f49381e1e289/inline0.js +42 -0
- package/generated/wasm-web/xlsx_substrate_wasm.d.ts +532 -0
- package/generated/wasm-web/xlsx_substrate_wasm.js +2493 -0
- package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm +0 -0
- package/generated/wasm-web/xlsx_substrate_wasm_bg.wasm.d.ts +120 -0
- 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;
|