@a3s-lab/office 0.11.0 → 0.12.0

package/README.md

@@ -578,11 +578,32 @@ import {
   importOfficeFile,
 } from '@a3s-lab/office/core';
 
-const imported = await importOfficeFile(file);
+const controller = new AbortController();
+const imported = await importOfficeFile(file, {
+  signal: controller.signal,
+  onProgress: ({ stage, progress }) => {
+    console.info(stage, `${Math.round(progress * 100)}%`);
+  },
+});
 const output = await createArtifactBlob(imported);
 const blankDeck = createArtifact('blank-presentation');
 ```
 
+Import progress advances monotonically through `reading`, `parsing`,
+`analyzing`, and `finalizing`. Calling `controller.abort()` rejects with an
+`AbortError`; large reads and parser checkpoints yield so a host can keep the
+progress and Cancel controls responsive.
+
+Spreadsheet import and export preserve sparse worksheets up to the XLSX limit
+of 1,048,576 rows by 16,384 columns. The logical `data.length`, `row`, and
+`column` dimensions can be large while only populated indexes are materialized.
+Virtual scrolling never emits `onChange`, and editing a far blank row creates
+only that row. Data-validation regions remain compact in
+`dataValidationRanges`; direct `dataVerification` entries take precedence.
+Protection ranges, passwordless editable ranges, and conditional formatting
+also remain compact and round-trip through native XLSX records without
+allocating every covered cell.
+
 Use `downloadArtifact` to start a browser download or
 `createArtifactBlob` when your application owns upload and persistence.
 Imported DOCX artifacts are source-backed: safe source-only OPC parts,
@@ -1338,6 +1359,7 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.12.0 documentation](https://a3s-lab.github.io/Office/docs/0.12.0/)
 - [A3S Office 0.11.0 documentation](https://a3s-lab.github.io/Office/docs/0.11.0/)
 - [A3S Office 0.10.0 documentation](https://a3s-lab.github.io/Office/docs/0.10.0/)
 - [A3S Office 0.9.2 documentation](https://a3s-lab.github.io/Office/docs/0.9.2/)

package/dist/0~spreadsheet-editor.js

@@ -4,12 +4,12 @@ import { Workbook } from "@fortune-sheet/react";
 import { AlignCenter, AlignLeft, AlignRight, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, AlignVerticalJustifyStart, ArrowDown, ArrowLeft, ArrowRight, ArrowUp, BarChart3, BetweenHorizontalEnd, BetweenHorizontalStart, BetweenVerticalEnd, BetweenVerticalStart, Bold, Bookmark, Calculator, Check, ChevronDown, ChevronLeft, ChevronRight, ClipboardPaste, Cloud, Columns3, Copy, CopyPlus, DecimalsArrowLeft, DecimalsArrowRight, Eraser, Eye, EyeOff, FileX2, Grid3X3, Italic, KeyRound, Layers2, Link2Off, ListFilter, Merge, MessageSquareX, MoveHorizontal, MoveVertical, Paintbrush, Palette, PanelLeft, PanelTop, PanelsTopLeft, Pencil, Percent, Plus, Printer, Redo2, RefreshCw, Rows3, Save, Scissors, Search, ShieldCheck, SortAsc, SortDesc, TableProperties, Trash2, Underline, Undo2, WrapText, X } from "lucide-react";
 import { Fragment as external_react_Fragment, useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { genarate, indexToColumnChar, update as core_update } from "@fortune-sheet/core";
-import { withoutEditableRange, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, editableRangeRequiresCredentials, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSpreadsheetConditionalVisualOptions, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, effectiveSpreadsheetPageSetup, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, withEditableRange, spreadsheetConditionalComparisonNeedsUpperValue, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, isSpreadsheetConditionalComparisonOperator, drawSpreadsheetConditionalIcon, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, sheetProtectionAuthority, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, spreadsheetConditionalThresholdsEqual, editableRangeCellCount, unlockedCellCount } from "./4476.js";
+import { withoutEditableRange, readOfficeSpreadsheetCollaboration as readWorkOfficeSpreadsheetCollaboration, SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS, editableRangeRequiresCredentials, normalizeSpreadsheetConditionalIconSetFormat, defaultSpreadsheetDataBarOptions, spreadsheetConditionalThresholdValue, normalizeSpreadsheetConditionalVisualOptions, withSheetProtection, spreadsheetProtectionKey, defaultSpreadsheetColorScaleThresholds, effectiveSpreadsheetPageSetup, protectedSheetCount, SPREADSHEET_CONDITIONAL_ICON_SETS, withSheetSelectionPermissions, withEditableRange, spreadsheetConditionalComparisonNeedsUpperValue, createOfficeSpreadsheetCollaborationBinding as createWorkOfficeSpreadsheetCollaborationBinding, isSpreadsheetConditionalComparisonOperator, drawSpreadsheetConditionalIcon, spreadsheetConditionalIconForValue, defaultSpreadsheetConditionalIconThresholds, sheetProtectionAuthority, replaceOfficeSpreadsheetCollaboration as replaceWorkOfficeSpreadsheetCollaboration, spreadsheetConditionalThresholdsEqual, editableRangeCellCount, unlockedCellCount } from "./4476.js";
+import { workSpreadsheetChartSupportsGrouping, createSpreadsheetChartFromSelection, normalizeWorkSpreadsheetDataLabelPosition, normalizeSpreadsheetPrintTitleColumns, normalizeSpreadsheetPrintTitleRows, formulaHasStructuredReference, normalizeWorkSpreadsheetErrorBars, defaultPivotValueCaption, workSpreadsheetChartSupportsBarSpacing, normalizeWorkSpreadsheetChartGrouping, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetScatterStyle, spreadsheetPivotAggregationLabel, workSpreadsheetChartAxisIsCategoryAxis, reconcileSpreadsheetChartPreviews, normalizeWorkSpreadsheetChartAxes, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetChartLegendPosition, spreadsheetChartCount, workSpreadsheetChartTypeLabel, sparseArrayEntries, normalizeWorkSpreadsheetTrendline, spreadsheetPivotOutputContains, effectiveSpreadsheetCalculationSettings, normalizeWorkSpreadsheetDataLabels, spreadsheetPivotIntersects, normalizeSpreadsheetPrintArea, spreadsheetCellAddress, formatSpreadsheetCellRanges, normalizeWorkSpreadsheetChartLayout, spreadsheetFormulaRangeForCell, workSpreadsheetChartAxisIsValueAxis, normalizeWorkSpreadsheetChartSmoothLines, spreadsheetPivotFilterValueKey, normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetChartSeriesStyle, volatileSpreadsheetFormulaFunctions, sparseArrayIndexes, normalizeWorkSpreadsheetBubbleSizeRepresents, workSpreadsheetChartSupportsTrendlines, normalizeWorkSpreadsheetChartLegendOverlay, parseSpreadsheetChartReference, workSpreadsheetChartGroupingIsStacked, normalizeWorkSpreadsheetChartGapWidth, workSpreadsheetChartSupportsSmoothLines, refreshSpreadsheetPivotTables, createSpreadsheetPivotFromSelection, spreadsheetPivotCount, reconcileSpreadsheetPivots, sparseMatrixColumnCount, workSpreadsheetChartSupportsErrorBars, formulaHasExternalReference, isValidSpreadsheetDefinedName, spreadsheetPivotValidation, deleteSpreadsheetPivotTable, workSpreadsheetChartAxisDefaultLabelPosition, workSpreadsheetChartSupportsSeriesAnalysis, parseSpreadsheetCellRanges, spreadsheetPivotFields, spreadsheetPivotFilterItems, normalizeWorkSpreadsheetChartOverlap, spreadsheetFormulaRangeConflict, spreadsheetSheetsWithChartPreviews, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetChartAxisShowsMajorGridlinesByDefault, workSpreadsheetChartSupportsAxes, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetRadarStyle } from "./8715.js";
 import { useOfficeTaskPaneEscape, OfficeCheckbox, CommittedOfficeNumberField, useOfficeDialog, useOfficeTaskPaneModal, createOfficeKernelClient, officeFontFamilies, CollectionState, OfficeNumberField, handleOfficeTaskPaneKeyDown } from "./0~7048.js";
 import { isOfficeShortcutBlocked, OfficeColorPicker } from "./0~3635.js";
 import { createOfficeEditorExtension, useOfficeEditorRuntime, useOfficeEditorKeyboardShortcuts } from "./0~3557.js";
 import { showToast } from "./6489.js";
-import { workSpreadsheetChartSupportsGrouping, createSpreadsheetChartFromSelection, normalizeWorkSpreadsheetDataLabelPosition, normalizeSpreadsheetPrintTitleRows, normalizeSpreadsheetPrintTitleColumns, formulaHasStructuredReference, normalizeWorkSpreadsheetErrorBars, defaultPivotValueCaption, workSpreadsheetChartSupportsBarSpacing, normalizeWorkSpreadsheetChartGrouping, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetScatterStyle, spreadsheetPivotAggregationLabel, workSpreadsheetChartAxisIsCategoryAxis, reconcileSpreadsheetChartPreviews, normalizeWorkSpreadsheetChartAxes, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetChartLegendPosition, spreadsheetChartCount, workSpreadsheetChartTypeLabel, normalizeWorkSpreadsheetTrendline, spreadsheetPivotOutputContains, effectiveSpreadsheetCalculationSettings, normalizeWorkSpreadsheetDataLabels, spreadsheetPivotIntersects, normalizeSpreadsheetPrintArea, spreadsheetCellAddress, formatSpreadsheetCellRanges, normalizeWorkSpreadsheetChartLayout, spreadsheetFormulaRangeForCell, workSpreadsheetChartAxisIsValueAxis, normalizeWorkSpreadsheetChartSmoothLines, spreadsheetPivotFilterValueKey, normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetChartSeriesStyle, volatileSpreadsheetFormulaFunctions, normalizeWorkSpreadsheetBubbleSizeRepresents, workSpreadsheetChartSupportsTrendlines, normalizeWorkSpreadsheetChartLegendOverlay, parseSpreadsheetChartReference, workSpreadsheetChartGroupingIsStacked, normalizeWorkSpreadsheetChartGapWidth, workSpreadsheetChartSupportsSmoothLines, refreshSpreadsheetPivotTables, createSpreadsheetPivotFromSelection, spreadsheetPivotCount, reconcileSpreadsheetPivots, workSpreadsheetChartSupportsErrorBars, formulaHasExternalReference, isValidSpreadsheetDefinedName, spreadsheetPivotValidation, deleteSpreadsheetPivotTable, workSpreadsheetChartAxisDefaultLabelPosition, workSpreadsheetChartSupportsSeriesAnalysis, parseSpreadsheetCellRanges, spreadsheetPivotFields, spreadsheetPivotFilterItems, normalizeWorkSpreadsheetChartOverlap, spreadsheetFormulaRangeConflict, spreadsheetSheetsWithChartPreviews, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetChartAxisShowsMajorGridlinesByDefault, workSpreadsheetChartSupportsAxes, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetRadarStyle } from "./8715.js";
 import { unsupportedSpreadsheetFormulaFunctions } from "./0~work-spreadsheet-formula-support.js";
 import { WorkspaceContextMenu, isWorkspaceContextMenuKeyboardEvent, WorkOfficeZoomControls, WorkOfficeStatusBar, WorkOfficeRibbon, workspaceContextMenuPosition, OfficeSelect, WorkOfficeRibbonGroup, WorkOfficePreviewBar, WorkOfficeRibbonButton } from "./0~4595.js";
 import { moveOfficeMenuFocus, stepOfficeZoom, Popover, useOfficeRemoteParticipants, button_Button, officePresenceColor, useOfficePublishPresenceLocation, icon_button_IconButton, office_text_field_OfficeTextField, useDialogFocusScope, useOfficeEditorWheelZoom } from "./0~6090.js";
@@ -440,18 +440,10 @@ function cellKey(row, column) {
     return `${row}_${column}`;
 }
 function forEachCell(data, ranges, visit) {
-    const maximumRow = data.length - 1;
-    const maximumColumn = Math.max(0, ...data.map((cells)=>cells.length - 1));
-    for (const range of ranges){
-        const startRow = Math.max(0, Math.min(maximumRow, range.row[0]));
-        const endRow = Math.max(0, Math.min(maximumRow, range.row[1]));
-        const startColumn = Math.max(0, Math.min(maximumColumn, range.column[0]));
-        const endColumn = Math.max(0, Math.min(maximumColumn, range.column[1]));
-        for(let row = startRow; row <= endRow; row += 1)for(let column = startColumn; column <= endColumn; column += 1)visit({
-            row,
-            column
-        });
-    }
+    for (const [row, cells] of sparseArrayEntries(data))for (const [column] of sparseArrayEntries(cells))if (ranges.some((range)=>row >= range.row[0] && row <= range.row[1] && column >= range.column[0] && column <= range.column[1])) visit({
+        row,
+        column
+    });
 }
 function cellValue(data, row, column) {
     return data[row]?.[column]?.v ?? null;
@@ -547,11 +539,12 @@ function spreadsheetSelectionSummary(sheet, selection) {
         const rowEnd = Math.min(range.row[1] ?? rowStart, sheet.data.length - 1);
         const columnStart = range.column[0] ?? 0;
         const columnEnd = range.column[1] ?? columnStart;
-        for(let rowIndex = rowStart; rowIndex <= rowEnd; rowIndex += 1){
+        for (const rowIndex of sparseArrayIndexes(sheet.data)){
+            if (rowIndex < rowStart || rowIndex > rowEnd) continue;
             const row = sheet.data[rowIndex];
-            if (!row) continue;
-            const populatedColumnEnd = Math.min(columnEnd, row.length - 1);
-            for(let columnIndex = columnStart; columnIndex <= populatedColumnEnd; columnIndex += 1)collect(row[columnIndex]);
+            if (row) {
+                for (const columnIndex of sparseArrayIndexes(row))if (!(columnIndex < columnStart) && !(columnIndex > columnEnd)) collect(row[columnIndex]);
+            }
         }
     } else {
         const rowStart = range.row[0] ?? 0;
@@ -607,28 +600,66 @@ function spreadsheetSheetsWithFiniteSelections(sheets) {
         }));
 }
 function spreadsheetSheetsForFortune(sheets) {
-    return structuredClone(sheets).map((sheet)=>{
-        for (const merge of Object.values(sheet.config?.merge ?? {}))for(let rowIndex = merge.r; rowIndex < merge.r + merge.rs; rowIndex += 1){
-            const row = sheet.data?.[rowIndex];
-            if (row) for(let columnIndex = merge.c; columnIndex < merge.c + merge.cs; columnIndex += 1)row[columnIndex] = {
-                ...row[columnIndex] ?? {},
-                mc: rowIndex === merge.r && columnIndex === merge.c ? {
-                    ...merge
-                } : {
-                    r: merge.r,
-                    c: merge.c
+    return sheets.map((sheet)=>{
+        const { celldata: sourceCellData, data, ...sourceMetadata } = sheet;
+        const projected = structuredClone(sourceMetadata);
+        const cells = new Map();
+        if (data) for (const rowIndex of sparseArrayIndexes(data)){
+            const row = data[rowIndex];
+            if (row) for (const columnIndex of sparseArrayIndexes(row)){
+                const cell = row[columnIndex];
+                if (null != cell) cells.set(`${rowIndex}_${columnIndex}`, {
+                    r: rowIndex,
+                    c: columnIndex,
+                    v: structuredClone(cell)
+                });
+            }
+        }
+        else for (const entry of sourceCellData ?? [])cells.set(`${entry.r}_${entry.c}`, structuredClone(entry));
+        for (const merge of Object.values(projected.config?.merge ?? {}))for(let rowIndex = merge.r; rowIndex < merge.r + merge.rs; rowIndex += 1)for(let columnIndex = merge.c; columnIndex < merge.c + merge.cs; columnIndex += 1){
+            const key = `${rowIndex}_${columnIndex}`;
+            const current = cells.get(key);
+            cells.set(key, {
+                r: rowIndex,
+                c: columnIndex,
+                v: {
+                    ...current?.v ?? {},
+                    mc: rowIndex === merge.r && columnIndex === merge.c ? {
+                        ...merge
+                    } : {
+                        r: merge.r,
+                        c: merge.c
+                    }
                 }
-            };
+            });
         }
         return {
-            ...sheet,
-            celldata: sheet.data ? sheet.data.flatMap((row, rowIndex)=>row.flatMap((cell, columnIndex)=>null == cell ? [] : [
-                        {
-                            r: rowIndex,
-                            c: columnIndex,
-                            v: cell
-                        }
-                    ])) : sheet.celldata ?? []
+            ...projected,
+            celldata: Array.from(cells.values()).sort((left, right)=>left.r - right.r || left.c - right.c)
+        };
+    });
+}
+function spreadsheetSheetsFromFortune(sheets, sourceSheets) {
+    return sheets.map((sheet, index)=>{
+        const source = (sheet.id ? sourceSheets.find((candidate)=>candidate.id === sheet.id) : void 0) ?? sourceSheets[index];
+        const cells = spreadsheetPopulatedCellData(sheet);
+        const { celldata: _cellData, data: _data, ...metadata } = sheet;
+        const useMatrix = source ? void 0 !== source.data : void 0 !== sheet.data;
+        if (!useMatrix) return {
+            ...metadata,
+            celldata: cells
+        };
+        const data = [];
+        data.length = Math.max(sheet.data?.length ?? 0, source?.data?.length ?? 0, positiveSpreadsheetDimension(sheet.row));
+        for (const { r: rowIndex, c: columnIndex, v: cell } of cells){
+            const row = data[rowIndex] ?? [];
+            data[rowIndex] = row;
+            row.length = Math.max(row.length, sheet.data?.[rowIndex]?.length ?? 0, source?.data?.[rowIndex]?.length ?? 0, positiveSpreadsheetDimension(sheet.column));
+            row[columnIndex] = cell;
+        }
+        return {
+            ...metadata,
+            data
         };
     });
 }
@@ -644,7 +675,9 @@ function finiteSpreadsheetSelection(selection) {
     };
 }
 function sameSpreadsheetWorkbookState(changed, rendered) {
-    return JSON.stringify(changed.map(spreadsheetSheetWithoutTransientSelection)) === JSON.stringify(rendered.map(spreadsheetSheetWithoutTransientSelection));
+    const left = changed.map(spreadsheetSheetWithoutTransientSelection);
+    const right = rendered.map(spreadsheetSheetWithoutTransientSelection);
+    return sameSpreadsheetHistoryValue(left, right);
 }
 function sameSpreadsheetHistoryContent(left, right) {
     return sameSpreadsheetHistoryValue({
@@ -737,8 +770,33 @@ function finiteSpreadsheetIndex(value, fallback) {
     return 'number' == typeof value && Number.isFinite(value) ? Math.max(0, Math.trunc(value)) : fallback;
 }
 function spreadsheetSheetWithoutTransientSelection(sheet) {
-    const { celldata: _cellData, luckysheet_select_save: _selection, luckysheet_selection_range: _range, ...content } = sheet;
-    return content;
+    const { celldata: _cellData, calcChain: _calculationChain, data: _data, dynamicArray_compute: _dynamicArrayComputation, luckysheet_select_save: _selection, luckysheet_selection_range: _range, zoomRatio, ...content } = sheet;
+    return {
+        ...content,
+        ...void 0 === zoomRatio || 1 === zoomRatio ? {} : {
+            zoomRatio
+        },
+        celldata: spreadsheetPopulatedCellData(sheet)
+    };
+}
+function spreadsheetPopulatedCellData(sheet) {
+    const cells = [];
+    if (void 0 !== sheet.data) for (const rowIndex of sparseArrayIndexes(sheet.data)){
+        const row = sheet.data[rowIndex];
+        if (row) for (const columnIndex of sparseArrayIndexes(row)){
+            const cell = row[columnIndex];
+            if (null != cell) cells.push({
+                r: rowIndex,
+                c: columnIndex,
+                v: cell
+            });
+        }
+    }
+    else for (const cell of sheet.celldata ?? [])if (null != cell.v) cells.push(cell);
+    return cells.sort((left, right)=>left.r - right.r || left.c - right.c);
+}
+function positiveSpreadsheetDimension(value) {
+    return 'number' == typeof value && Number.isFinite(value) && value > 0 ? Math.floor(value) : 0;
 }
 function sameSpreadsheetHistoryValue(left, right) {
     if (left === right) return true;
@@ -748,7 +806,9 @@ function sameSpreadsheetHistoryValue(left, right) {
     if (leftFormulaCell || rightFormulaCell) return Boolean(leftFormulaCell && rightFormulaCell && sameSpreadsheetFormulaHistoryCell(leftFormulaCell, rightFormulaCell));
     if (Array.isArray(left) || Array.isArray(right)) {
         if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) return false;
-        return left.every((value, index)=>sameSpreadsheetHistoryValue(value, right[index]));
+        const leftKeys = Object.keys(left).filter((key)=>void 0 !== left[Number(key)]);
+        const rightKeys = Object.keys(right).filter((key)=>void 0 !== right[Number(key)]);
+        return leftKeys.length === rightKeys.length && leftKeys.every((key)=>Object.hasOwn(right, key) && sameSpreadsheetHistoryValue(left[Number(key)], right[Number(key)]));
     }
     if ('object' != typeof left || 'object' != typeof right) return false;
     const leftRecord = left;
@@ -1471,13 +1531,13 @@ function spreadsheetSelectionContainsFocus(selection, focus) {
 }
 function spreadsheetSheetBounds(sheet) {
     const dataRows = sheet.data?.length ?? 0;
-    const dataColumns = Math.max(0, ...sheet.data?.map((row)=>row?.length ?? 0) ?? []);
+    const dataColumns = sparseMatrixColumnCount(sheet.data);
     return {
-        lastRow: positiveSpreadsheetDimension(sheet.row, dataRows, spreadsheetDefaultRows) - 1,
-        lastColumn: positiveSpreadsheetDimension(sheet.column, dataColumns, spreadsheetDefaultColumns) - 1
+        lastRow: spreadsheet_keyboard_navigation_positiveSpreadsheetDimension(sheet.row, dataRows, spreadsheetDefaultRows) - 1,
+        lastColumn: spreadsheet_keyboard_navigation_positiveSpreadsheetDimension(sheet.column, dataColumns, spreadsheetDefaultColumns) - 1
     };
 }
-function positiveSpreadsheetDimension(configured, dataDimension, fallback) {
+function spreadsheet_keyboard_navigation_positiveSpreadsheetDimension(configured, dataDimension, fallback) {
     const value = Number(configured);
     if (Number.isFinite(value) && value > 0) return Math.max(1, Math.trunc(value));
     if (dataDimension > 0) return dataDimension;
@@ -1817,11 +1877,10 @@ function createSpreadsheetEditorExtensions() {
                             return Boolean(sheet && (context.editable || context.view && 1 !== sheet.hide));
                         },
                         execute: (context, sheetId)=>{
-                            if (!context.editable) {
-                                const sheet = context.content.sheets.find((candidate)=>candidate.id === sheetId);
-                                if (!sheet || 1 === sheet.hide) return false;
-                                return context.view?.activateSheet(sheetId) ?? false;
-                            }
+                            const sheet = context.content.sheets.find((candidate)=>candidate.id === sheetId);
+                            if (!sheet) return false;
+                            if (context.view && 1 !== sheet.hide) return context.view?.activateSheet(sheetId) ?? false;
+                            if (!context.editable) return false;
                             return applySpreadsheetSheetChange(context, activateSpreadsheetSheet(context.content, sheetId));
                         }
                     },
@@ -2134,7 +2193,7 @@ function spreadsheetStructureExtent(context, axis) {
     const range = spreadsheetStructureRange(liveRange(context), axis);
     if (!sheet) return range[1] + 1;
     if ('row' === axis) return Math.max(sheet.row ?? 0, sheet.data?.length ?? 0, range[1] + 1);
-    const dataWidth = Math.max(0, ...(sheet.data ?? []).map((row)=>row.length));
+    const dataWidth = sparseMatrixColumnCount(sheet.data);
     return Math.max(sheet.column ?? 0, dataWidth, range[1] + 1);
 }
 function clearSelectedCells(context, mode = 'contents') {
@@ -2757,7 +2816,7 @@ function scanSpreadsheetFormulas(content) {
     for (const sheet of content.sheets){
         summary.normalizedSharedFormulaGroups += sheet.formulaMetadata?.normalizedSharedFormulaGroups ?? 0;
         summary.normalizedSharedFormulaCells += sheet.formulaMetadata?.normalizedSharedFormulaCells ?? 0;
-        for (const [row, cells] of (sheet.data ?? []).entries())for (const [column, cell] of cells.entries()){
+        for (const [row, cells] of sparseArrayEntries(sheet.data))for (const [column, cell] of sparseArrayEntries(cells)){
             if (!cell?.f) continue;
             const address = spreadsheetCellAddress(row, column);
             const location = `${sheet.name}!${address}`;
@@ -5459,17 +5518,11 @@ function spreadsheetFindMatches(sheet, query) {
 }
 function indexedSpreadsheetCells(sheet) {
     const indexed = new Map();
-    for(let row = 0; row < (sheet.data?.length ?? 0); row += 1){
-        const cells = sheet.data?.[row];
-        if (cells) for(let column = 0; column < cells.length; column += 1){
-            const cell = cells[column];
-            if (cell) indexed.set(`${row}:${column}`, {
-                row,
-                column,
-                cell
-            });
-        }
-    }
+    for (const [row, cells] of sparseArrayEntries(sheet.data))for (const [column, cell] of sparseArrayEntries(cells))if (cell) indexed.set(`${row}:${column}`, {
+        row,
+        column,
+        cell
+    });
     for (const entry of sheet.celldata ?? []){
         if (!Number.isSafeInteger(entry.r) || !Number.isSafeInteger(entry.c) || entry.r < 0 || entry.c < 0 || !entry.v) continue;
         const key = `${entry.r}:${entry.c}`;
@@ -9643,7 +9696,7 @@ function SpreadsheetProtectionPanel({ content, onChange }) {
         if (ranges.some((range, index)=>index !== selectedIndex && range.name.trim().toLowerCase() === name.toLowerCase())) return void setError('当前工作表中已经存在这个区域名称。');
         if (editableRangeCellCount(parsed) > MAX_EDITABLE_RANGE_CELLS) return void setError('一次最多可设置 100,000 个可编辑单元格。');
         const maximumRow = Math.max(1, sheet.row ?? sheet.data?.length ?? 1) - 1;
-        const maximumColumn = Math.max(1, sheet.column ?? Math.max(0, ...(sheet.data ?? []).map((row)=>row.length))) - 1;
+        const maximumColumn = Math.max(1, sheet.column ?? sparseMatrixColumnCount(sheet.data)) - 1;
         if (parsed.some((range)=>range.row[1] > maximumRow || range.column[1] > maximumColumn)) return void setError(`范围必须位于当前工作表的 ${maximumRow + 1} 行 × ${maximumColumn + 1} 列以内。`);
         const index = selectedIndex ?? ranges.length;
         updateSheet(withEditableRange(sheet, selectedIndex, {
@@ -10682,12 +10735,9 @@ function sparseSpreadsheetCells(sheet, maximumCells) {
     };
     if (sheet.data) {
         if (sheet.data.length > OFFICE_KERNEL_SPREADSHEET_MAX_ROWS) return null;
-        for(let row = 0; row < sheet.data.length; row += 1){
-            const values = sheet.data[row];
-            if (values) {
-                if (values.length > 16384) return null;
-                for(let column = 0; column < values.length; column += 1)if (!appendCell(values[column], row, column)) return null;
-            }
+        for (const [row, values] of sparseArrayEntries(sheet.data)){
+            if (values.length > 16384) return null;
+            for (const [column, cell] of sparseArrayEntries(values))if (!appendCell(cell, row, column)) return null;
         }
     } else for (const entry of sheet.celldata ?? [])if (!appendCell(entry.v, entry.r, entry.c)) return null;
     return cells.sort((left, right)=>left.row - right.row || left.column - right.column);
@@ -11316,9 +11366,7 @@ function spreadsheetCellReader(sheet) {
 }
 function spreadsheetUsedBounds(sheet) {
     let lastRow = Math.max((sheet.data?.length ?? 1) - 1, 0);
-    let lastColumn = Math.max(...sheet.data?.map((row)=>Math.max((row?.length ?? 1) - 1, 0)) ?? [
-        0
-    ]);
+    let lastColumn = Math.max(sparseMatrixColumnCount(sheet.data) - 1, 0);
     for (const cell of sheet.celldata ?? []){
         lastRow = Math.max(lastRow, cell.r);
         lastColumn = Math.max(lastColumn, cell.c);
@@ -11940,9 +11988,7 @@ function spreadsheetFormatPainterSheetBounds(sheet, target, pattern) {
     const requestedColumnCount = Math.max(target.column[0], target.column[1]) + pattern.columnCount;
     return {
         rowCount: positiveInteger(sheet.row) ?? Math.max(sheet.data?.length ?? 0, requestedRowCount),
-        columnCount: positiveInteger(sheet.column) ?? Math.max(...sheet.data?.map((row)=>row?.length ?? 0) ?? [
-            0
-        ], requestedColumnCount)
+        columnCount: positiveInteger(sheet.column) ?? Math.max(sparseMatrixColumnCount(sheet.data), requestedColumnCount)
     };
 }
 function positiveInteger(value) {
@@ -12035,6 +12081,7 @@ function useSpreadsheetCollaboration({ initialContent, onChange, session }) {
     const sessionRef = useRef(session);
     if (sessionRef.current !== session) throw new Error('SpreadsheetEditor collaboration sessions cannot be replaced while mounted. Remount the editor for another shared workbook.');
     const viewStateRef = useRef(spreadsheetCollaborationViewState(initialContent));
+    const [derivedOrigin] = useState(()=>session.createOrigin('system', 'spreadsheet-calculation'));
     const [content, setContent] = useState(()=>spreadsheetContentWithCollaborationViewState(readWorkOfficeSpreadsheetCollaboration(session), viewStateRef.current));
     const contentRef = useRef(content);
     const bindingRef = useRef(void 0);
@@ -12042,15 +12089,15 @@ function useSpreadsheetCollaboration({ initialContent, onChange, session }) {
     const onChangeRef = useRef(onChange);
     onChangeRef.current = onChange;
     contentRef.current = content;
+    const project = useCallback((sharedContent)=>{
+        const projected = spreadsheetContentWithCollaborationViewState(sharedContent, viewStateRef.current);
+        contentRef.current = projected;
+        setContent(projected);
+        return projected;
+    }, []);
     useEffect(()=>{
         const binding = createWorkOfficeSpreadsheetCollaborationBinding(session);
         bindingRef.current = binding;
-        const project = (sharedContent)=>{
-            const projected = spreadsheetContentWithCollaborationViewState(sharedContent, viewStateRef.current);
-            contentRef.current = projected;
-            setContent(projected);
-            return projected;
-        };
         const unsubscribeContent = binding.subscribe(({ content: next })=>{
             onChangeRef.current(project(next));
         });
@@ -12069,11 +12116,12 @@ function useSpreadsheetCollaboration({ initialContent, onChange, session }) {
             binding.destroy();
         };
     }, [
+        project,
         session
     ]);
     const commit = useCallback((next)=>{
-        updateSpreadsheetCollaborationViewState(viewStateRef.current, next);
         const previous = contentRef.current;
+        updateSpreadsheetCollaborationViewStateForContentChange(viewStateRef.current, previous, next);
         const binding = bindingRef.current;
         if (binding?.replace(previous, next)) {
             contentRef.current = spreadsheetContentWithCollaborationViewState(binding.content(), viewStateRef.current);
@@ -12083,17 +12131,42 @@ function useSpreadsheetCollaboration({ initialContent, onChange, session }) {
         contentRef.current = projected;
         setContent(projected);
     }, []);
+    const commitDerived = useCallback((next)=>{
+        const previous = contentRef.current;
+        const binding = bindingRef.current;
+        if (binding && replaceWorkOfficeSpreadsheetCollaboration(session, previous, next, derivedOrigin)) {
+            contentRef.current = spreadsheetContentWithCollaborationViewState(binding.content(), viewStateRef.current);
+            return;
+        }
+        project(binding?.content() ?? previous);
+    }, [
+        derivedOrigin,
+        project,
+        session
+    ]);
     const view = useMemo(()=>({
             activateSheet: (sheetId)=>{
+                const sharedContent = bindingRef.current?.content() ?? contentRef.current;
+                const sheet = sharedContent.sheets.find((candidate)=>candidate.id === sheetId && 1 !== candidate.hide);
+                if (!sheet) return false;
+                if (viewStateRef.current.activeSheetId === sheetId) return true;
                 viewStateRef.current.activeSheetId = sheetId;
+                project(sharedContent);
+                return true;
             },
             select: (sheetId, selection)=>{
                 viewStateRef.current.selections.set(sheetId, finiteSpreadsheetSelection(selection));
             },
             setZoom: (sheetId, zoomRatio)=>{
+                const sharedContent = bindingRef.current?.content() ?? contentRef.current;
+                if (!sharedContent.sheets.some((sheet)=>sheet.id === sheetId)) return;
+                if (viewStateRef.current.zoomBySheet.get(sheetId) === zoomRatio) return;
                 viewStateRef.current.zoomBySheet.set(sheetId, zoomRatio);
+                project(sharedContent);
             }
-        }), []);
+        }), [
+        project
+    ]);
     const history = useMemo(()=>({
             canRedo: bindingRef.current?.canRedo() ?? false,
             canUndo: bindingRef.current?.canUndo() ?? false,
@@ -12106,6 +12179,7 @@ function useSpreadsheetCollaboration({ initialContent, onChange, session }) {
         content,
         history,
         onChange: commit,
+        onDerivedChange: commitDerived,
         readOnly: 'edit' !== session.mode,
         view
     };
@@ -12125,16 +12199,21 @@ function spreadsheetCollaborationViewState(content) {
         zoomBySheet
     };
 }
-function updateSpreadsheetCollaborationViewState(view, content) {
-    pruneSpreadsheetCollaborationViewState(view, content);
-    const active = content.sheets.find((sheet)=>1 === sheet.status);
+function updateSpreadsheetCollaborationViewStateForContentChange(view, previous, next) {
+    pruneSpreadsheetCollaborationViewState(view, next);
+    if (!spreadsheetSheetVisibilityChanged(previous, next)) return;
+    const active = next.sheets.find((sheet)=>1 === sheet.status && 1 !== sheet.hide);
     if (active?.id) view.activeSheetId = active.id;
-    for (const sheet of content.sheets){
-        if (!sheet.id) continue;
-        const selection = sheet.luckysheet_select_save?.at(-1);
-        if (selection) view.selections.set(sheet.id, finiteSpreadsheetSelection(selection));
-        if (void 0 !== sheet.zoomRatio) view.zoomBySheet.set(sheet.id, sheet.zoomRatio);
-    }
+}
+function spreadsheetSheetVisibilityChanged(previous, next) {
+    if (previous.sheets.length !== next.sheets.length) return true;
+    const previousById = new Map(previous.sheets.flatMap((sheet)=>sheet.id ? [
+            [
+                sheet.id,
+                sheet.hide
+            ]
+        ] : []));
+    return next.sheets.some((sheet)=>!sheet.id || !previousById.has(sheet.id) || previousById.get(sheet.id) !== sheet.hide);
 }
 function spreadsheetContentWithCollaborationViewState(content, view) {
     pruneSpreadsheetCollaborationViewState(view, content);
@@ -12194,10 +12273,11 @@ function CollaborativeSpreadsheetEditor(props) {
         collaborationHistory: shared.history,
         collaborationView: shared.view,
         onChange: shared.onChange,
+        onDerivedChange: shared.onDerivedChange,
         preview: props.preview || shared.readOnly
     });
 }
-function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHistory, collaborationView, kernelWasmUrl, preview, saveStatus = '已自动保存', fileActions, onChange, onAgentRequest }) {
+function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHistory, collaborationView, kernelWasmUrl, preview, saveStatus = '已自动保存', fileActions, onChange, onDerivedChange, onAgentRequest }) {
     const materializedContent = useMemo(()=>refreshSpreadsheetPivotTables(content), [
         content
     ]);
@@ -12396,19 +12476,24 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
     const workbookSheetsRef = useRef(workbookSheets);
     workbookSheetsRef.current = displayedWorkbookSheets;
     const handleWorkbookChange = useCallback((sheets)=>{
-        if (ignoreChangeDuringExternalSync(sameSpreadsheetWorkbookState(sheets, workbookSheetsRef.current))) return void takeWorkbookOperations();
+        const controlledSheets = spreadsheetSheetsFromFortune(sheets, contentRef.current.sheets);
+        const matchesRenderedWorkbook = sameSpreadsheetWorkbookState(controlledSheets, workbookSheetsRef.current);
+        if (ignoreChangeDuringExternalSync(matchesRenderedWorkbook)) return void takeWorkbookOperations();
         const operations = takeWorkbookOperations();
-        if (previewRef.current || !operations.length && !calculation.hasPendingResultPatches() && sameSpreadsheetWorkbookState(sheets, workbookSheetsRef.current)) return;
-        const withCharts = reconcileSpreadsheetChartPreviews(contentRef.current, sheets);
+        const hasPendingResultPatches = calculation.hasPendingResultPatches();
+        if (previewRef.current || matchesRenderedWorkbook && !hasPendingResultPatches) return;
+        const withCharts = reconcileSpreadsheetChartPreviews(contentRef.current, controlledSheets);
         const next = reconcileSpreadsheetPivots(contentRef.current, withCharts.sheets);
         contentRef.current = next;
         acceptWorkbookContent(next);
         calculation.synchronizeWorkbook(next, operations);
-        spreadsheetCommandsRef.current?.setSpreadsheetContent(next);
+        if (matchesRenderedWorkbook && onDerivedChange) onDerivedChange(next);
+        else spreadsheetCommandsRef.current?.setSpreadsheetContent(next);
     }, [
         acceptWorkbookContent,
         calculation,
         ignoreChangeDuringExternalSync,
+        onDerivedChange,
         takeWorkbookOperations
     ]);
     const handleWorkbookOperations = useCallback((operations)=>{
@@ -12514,14 +12599,14 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         pasteSpreadsheetSelection(browserSpreadsheetClipboard, commands.pasteCells);
         return true;
     };
-    const activateReadOnlySpreadsheetSheet = useCallback((sheetId)=>{
-        if (!previewRef.current) return false;
+    const activateLocalSpreadsheetSheet = useCallback((sheetId)=>{
+        if (!previewRef.current && !collaborationView) return false;
         const sheet = contentRef.current.sheets.find((candidate)=>candidate.id === sheetId && 1 !== candidate.hide);
         if (!sheet) return false;
         activeSheetIdRef.current = sheetId;
-        collaborationView?.activateSheet(sheetId);
+        if (collaborationView && !collaborationView.activateSheet(sheetId)) return false;
         setSelectionState(null);
-        setPreviewActiveSheetId(sheetId);
+        if (previewRef.current) setPreviewActiveSheetId(sheetId);
         try {
             workbookRef.current?.activateSheet({
                 id: sheetId
@@ -12564,8 +12649,8 @@ function SpreadsheetEditorSurface({ autoFocus = true, content, collaborationHist
         selection: selectionState,
         targetSheetId: toolbarSheetId,
         toolbarCell,
-        view: preview ? {
-            activateSheet: activateReadOnlySpreadsheetSheet
+        view: preview || collaborationView ? {
+            activateSheet: activateLocalSpreadsheetSheet
         } : null,
         workbook: workbookInstance
     }, spreadsheetExtensions);

package/dist/0~work-docx-import.js

@@ -2777,8 +2777,8 @@ function work_docx_table_sizing_import_textNodes(root) {
 }
 const work_docx_import_WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
 const work_docx_import_XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
-async function prepareDocxImport(buffer) {
-    const archive = await OoxmlPackage.load(buffer);
+async function prepareDocxImport(buffer, sourcePackage) {
+    const archive = sourcePackage ?? await OoxmlPackage.load(buffer);
     const bibliography = (await readDocxBibliography(archive)).bibliography;
     const fallback = documentInitialSectionLayout({
         type: 'document',

package/dist/0~work-office-diagnostics.js

@@ -1626,14 +1626,15 @@ async function diagnoseXlsxPivots(archive) {
     });
     return issues;
 }
-async function analyzeDocxCompatibility(file, messages) {
+async function analyzeDocxCompatibility(file, messages, sourcePackage) {
     const issues = [
         work_office_diagnostics_issue('docx.page-layout', 'Page layout', 'Per-section paper size, orientation, exact native page margins, one-to-six equal or custom-width columns, section breaks, and explicit page breaks are preserved; exact pagination and line wrapping may normalize.'),
         work_office_diagnostics_issue('docx.package-state', 'OOXML package state', 'Source-backed export retains safe source-only parts byte-for-byte and reconnects their content types and relationships. Passive relationship-free extensions in settings XML, uniquely matched style or numbering identities, stable picture drawings, unchanged native-identity paragraphs, stable table, row, or cell scopes, and uniquely matched footnote, endnote, comment, or comment-thread records are preserved against the final package graph. Text-stable direct, supported-hyperlink-wrapped, and eligible static-content-control note and comment runs retain paragraph, table, wrapper, run, and run-property metadata; native note tables and DrawingML pictures remain editable, note image relationships and media targets are repaired and validated, bounded structured OMML equations remain atomically updateable in supported Word stories, uniquely matched table-bearing rich-text controls are reconstructed, safe web, mail, and internal note/comment links are rebound to collision-free final relationship IDs, and content-control ID collisions are rewritten. Native note, comment, and note-picture identities survive reorderings, comment durable IDs are rebound to regenerated paragraph IDs, and eligible source font-table metadata is retained. Generated Word semantics remain authoritative; source-only, changed-text or table structure, malformed, duplicate or cross-kind, active, unsupported wrappers, mixed-semantic, unsafe relationship-bound, legacy VML, non-picture drawings, or unsupported rich content may normalize.', 'info')
     ];
     for (const message of messages)issues.push(work_office_diagnostics_issue(`docx.converter.${message.type}`, 'Document conversion', message.message, 'error' === message.type ? 'error' : 'warning'));
     try {
-        const archive = await OoxmlPackage.load(await file.arrayBuffer());
+        const archive = void 0 === sourcePackage ? await OoxmlPackage.load(await file.arrayBuffer()) : sourcePackage;
+        if (!archive) throw new Error('The DOCX package could not be loaded.');
         const packagePaths = archive.paths('');
         const normalizedPackagePaths = packagePaths.map((path)=>path.toLowerCase());
         const document = archive.has('word/document.xml') ? await archive.xml('word/document.xml') : null;
@@ -1723,7 +1724,7 @@ async function analyzeDocxCompatibility(file, messages) {
     }
     return report(file, 'DOCX', issues);
 }
-async function analyzeSpreadsheetCompatibility(file, extension, workbook) {
+async function analyzeSpreadsheetCompatibility(file, extension, workbook, sourcePackage) {
     if ('csv' === extension) return null;
     const sourceFormat = extension.toUpperCase();
     const issues = [];
@@ -1748,7 +1749,8 @@ async function analyzeSpreadsheetCompatibility(file, extension, workbook) {
         if ((workbook.Workbook?.Sheets?.[index]?.Hidden ?? 0) > 0) issues.push(work_office_diagnostics_issue('sheet.hidden', 'Hidden worksheets', 'Hidden worksheet state is preserved but can be changed by the editor.', 'info', name));
     }
     if ('xlsx' === extension) try {
-        const archive = await OoxmlPackage.load(await file.arrayBuffer());
+        const archive = void 0 === sourcePackage ? await OoxmlPackage.load(await file.arrayBuffer()) : sourcePackage;
+        if (!archive) throw new Error('The XLSX package could not be loaded.');
         await inspectXlsxPackage(archive, issues);
     } catch  {
         issues.push(work_office_diagnostics_issue('xlsx.inspect', 'Package inspection', 'Some XLSX features could not be inspected before conversion.'));

package/dist/0~work-pptx-import.js

@@ -478,8 +478,8 @@ const EMU_PER_INCH = 914400;
 const DEFAULT_SLIDE_WIDTH = 13.333;
 const DEFAULT_SLIDE_HEIGHT = 7.5;
 const MAX_EMBEDDED_IMAGE_BYTES = 11534336;
-async function importPptxPresentation(file) {
-    const archive = await OoxmlPackage.load(await file.arrayBuffer());
+async function importPptxPresentation(file, sourceBytes) {
+    const archive = await OoxmlPackage.load(sourceBytes ?? await file.arrayBuffer());
     if (!archive.has('ppt/presentation.xml')) throw new Error('The selected file is not a valid PPTX presentation.');
     const presentation = await archive.xml('ppt/presentation.xml');
     const presentationRelationships = await archive.relationships('ppt/presentation.xml');