@a3s-lab/office 0.15.0 → 0.16.0

package/dist/5184.js

@@ -25,7 +25,7 @@ const WORK_TEMPLATES = [
         id: 'blank-spreadsheet',
         kind: 'spreadsheet',
         name: '空白表格',
-        description: '公式、筛选与多工作表',
+        description: '公式、表格、筛选与多工作表',
         accent: '#16a36a'
     },
     {

package/dist/8715.js

@@ -1,4 +1,160 @@
 import { createOfficeId as createWorkId, directChild, attribute } from "./5184.js";
+const CELL_REFERENCE = /\$?([A-Z]{1,3})\$?([1-9]\d*)/i;
+const CELL_OR_RANGE = new RegExp(`^${CELL_REFERENCE.source}(?::${CELL_REFERENCE.source})?$`, 'i');
+const COLUMN_RANGE = /^\$?([A-Z]{1,3}):\$?([A-Z]{1,3})$/i;
+const ROW_RANGE = /^\$?([1-9]\d*):\$?([1-9]\d*)$/;
+const DEFINED_NAME = /^[\p{L}_\\][\p{L}\p{N}_.\\]*$/u;
+function isValidSpreadsheetDefinedName(value) {
+    const name = value.trim();
+    if (!name || Array.from(name).length > 255 || !DEFINED_NAME.test(name) || /^_xlnm\./i.test(name)) return false;
+    if (/^[A-Z]{1,3}[1-9]\d*$/i.test(name) || /^R\d+C\d+$/i.test(name)) return false;
+    return true;
+}
+function normalizeSpreadsheetPrintArea(value) {
+    const parts = splitRangeList(value.trim().replace(/^=/, ''));
+    if (!parts.length) return null;
+    const normalized = parts.map((part)=>{
+        const reference = unqualifiedReference(part);
+        if (!CELL_OR_RANGE.test(reference) && !COLUMN_RANGE.test(reference) && !ROW_RANGE.test(reference)) return null;
+        return reference.replace(/[A-Z]+/gi, (column)=>column.toUpperCase());
+    });
+    return normalized.every((part)=>Boolean(part)) ? normalized.join(',') : null;
+}
+function normalizeSpreadsheetPrintTitleRows(value) {
+    const match = ROW_RANGE.exec(unqualifiedReference(value.trim().replace(/^=/, '')));
+    if (!match) return null;
+    const start = Number(match[1]);
+    const end = Number(match[2]);
+    return `$${Math.min(start, end)}:$${Math.max(start, end)}`;
+}
+function normalizeSpreadsheetPrintTitleColumns(value) {
+    const match = COLUMN_RANGE.exec(unqualifiedReference(value.trim().replace(/^=/, '')));
+    if (!match) return null;
+    const start = decodeColumn(match[1]);
+    const end = decodeColumn(match[2]);
+    return `$${encodeColumn(Math.min(start, end))}:$${encodeColumn(Math.max(start, end))}`;
+}
+function parseSpreadsheetPrintTitles(value) {
+    let rows;
+    let columns;
+    for (const part of splitRangeList(value.trim().replace(/^=/, ''))){
+        const rowReference = normalizeSpreadsheetPrintTitleRows(part);
+        if (rowReference) {
+            if (rows) return null;
+            const match = ROW_RANGE.exec(rowReference);
+            rows = [
+                Number(match[1]) - 1,
+                Number(match[2]) - 1
+            ];
+            continue;
+        }
+        const columnReference = normalizeSpreadsheetPrintTitleColumns(part);
+        if (!columnReference || columns) return null;
+        const match = COLUMN_RANGE.exec(columnReference);
+        columns = [
+            decodeColumn(match[1]),
+            decodeColumn(match[2])
+        ];
+    }
+    return rows || columns ? {
+        rows,
+        columns
+    } : null;
+}
+function parseSpreadsheetCellRanges(value) {
+    const parts = splitRangeList(value.trim().replace(/^=/, ''));
+    if (!parts.length) return null;
+    const ranges = parts.map((part)=>{
+        const cells = CELL_OR_RANGE.exec(unqualifiedReference(part));
+        if (!cells) return null;
+        const first = decodeCell(cells[1], cells[2]);
+        const second = cells[3] && cells[4] ? decodeCell(cells[3], cells[4]) : first;
+        return {
+            row: [
+                Math.min(first.row, second.row),
+                Math.max(first.row, second.row)
+            ],
+            column: [
+                Math.min(first.column, second.column),
+                Math.max(first.column, second.column)
+            ]
+        };
+    });
+    return ranges.every((range)=>Boolean(range)) ? ranges : null;
+}
+function formatSpreadsheetCellRanges(ranges) {
+    return ranges.map((range)=>{
+        const start = encodeCell(range.row[0], range.column[0]);
+        const end = encodeCell(range.row[1], range.column[1]);
+        return start === end ? start : `${start}:${end}`;
+    }).join(',');
+}
+function qualifySpreadsheetRange(value, sheetName) {
+    const prefix = `'${sheetName.replaceAll("'", "''")}'!`;
+    return splitRangeList(value).map((part)=>part.includes('!') ? part.trim() : `${prefix}${part.trim()}`).join(',');
+}
+function stripSpreadsheetSheetQualifier(value, sheetName) {
+    const quotedPrefix = `'${sheetName.replaceAll("'", "''")}'!`;
+    const plainPrefix = `${sheetName}!`;
+    return splitRangeList(value.trim().replace(/^=/, '')).map((part)=>{
+        const reference = part.trim();
+        if (reference.toLowerCase().startsWith(quotedPrefix.toLowerCase())) return reference.slice(quotedPrefix.length);
+        if (reference.toLowerCase().startsWith(plainPrefix.toLowerCase())) return reference.slice(plainPrefix.length);
+        return reference;
+    }).join(',');
+}
+function splitRangeList(value) {
+    const parts = [];
+    let current = '';
+    let quoted = false;
+    for(let index = 0; index < value.length; index += 1){
+        const character = value[index];
+        if ("'" === character) {
+            if (quoted && "'" === value[index + 1]) {
+                current += "''";
+                index += 1;
+                continue;
+            }
+            quoted = !quoted;
+        }
+        if (',' !== character || quoted) current += character;
+        else {
+            if (current.trim()) parts.push(current.trim());
+            current = '';
+        }
+    }
+    if (current.trim()) parts.push(current.trim());
+    return parts;
+}
+function unqualifiedReference(value) {
+    const reference = value.trim().replace(/^=/, '');
+    const separator = reference.lastIndexOf('!');
+    return separator >= 0 ? reference.slice(separator + 1) : reference;
+}
+function decodeCell(column, row) {
+    return {
+        row: Math.max(0, Number(row) - 1),
+        column: decodeColumn(column)
+    };
+}
+function decodeColumn(value) {
+    let result = 0;
+    for (const character of value.toUpperCase())result = 26 * result + character.charCodeAt(0) - 64;
+    return Math.max(0, result - 1);
+}
+function encodeCell(row, column) {
+    return `${encodeColumn(column)}${Math.max(0, row) + 1}`;
+}
+function encodeColumn(column) {
+    let value = Math.max(0, column) + 1;
+    let label = '';
+    while(value > 0){
+        value -= 1;
+        label = String.fromCharCode(65 + value % 26) + label;
+        value = Math.floor(value / 26);
+    }
+    return label;
+}
 function sparseArrayIndexes(values) {
     if (!values) return [];
     return Object.keys(values).flatMap((key)=>{
@@ -323,162 +479,6 @@ function formatPivotNumber(value) {
 function matchesPivotReportFilters(values, pivot) {
     return (pivot.reportFilters ?? []).every((filter)=>void 0 === filter.selectedItem || spreadsheetPivotFilterValueKey(normalizeSpreadsheetPivotFilterValue(values[filter.fieldIndex])) === spreadsheetPivotFilterValueKey(filter.selectedItem));
 }
-const CELL_REFERENCE = /\$?([A-Z]{1,3})\$?([1-9]\d*)/i;
-const CELL_OR_RANGE = new RegExp(`^${CELL_REFERENCE.source}(?::${CELL_REFERENCE.source})?$`, 'i');
-const COLUMN_RANGE = /^\$?([A-Z]{1,3}):\$?([A-Z]{1,3})$/i;
-const ROW_RANGE = /^\$?([1-9]\d*):\$?([1-9]\d*)$/;
-const DEFINED_NAME = /^[\p{L}_\\][\p{L}\p{N}_.\\]*$/u;
-function isValidSpreadsheetDefinedName(value) {
-    const name = value.trim();
-    if (!name || name.length > 255 || !DEFINED_NAME.test(name) || /^_xlnm\./i.test(name)) return false;
-    if (/^[A-Z]{1,3}[1-9]\d*$/i.test(name) || /^R\d+C\d+$/i.test(name)) return false;
-    return true;
-}
-function normalizeSpreadsheetPrintArea(value) {
-    const parts = splitRangeList(value.trim().replace(/^=/, ''));
-    if (!parts.length) return null;
-    const normalized = parts.map((part)=>{
-        const reference = unqualifiedReference(part);
-        if (!CELL_OR_RANGE.test(reference) && !COLUMN_RANGE.test(reference) && !ROW_RANGE.test(reference)) return null;
-        return reference.replace(/[A-Z]+/gi, (column)=>column.toUpperCase());
-    });
-    return normalized.every((part)=>Boolean(part)) ? normalized.join(',') : null;
-}
-function normalizeSpreadsheetPrintTitleRows(value) {
-    const match = ROW_RANGE.exec(unqualifiedReference(value.trim().replace(/^=/, '')));
-    if (!match) return null;
-    const start = Number(match[1]);
-    const end = Number(match[2]);
-    return `$${Math.min(start, end)}:$${Math.max(start, end)}`;
-}
-function normalizeSpreadsheetPrintTitleColumns(value) {
-    const match = COLUMN_RANGE.exec(unqualifiedReference(value.trim().replace(/^=/, '')));
-    if (!match) return null;
-    const start = decodeColumn(match[1]);
-    const end = decodeColumn(match[2]);
-    return `$${encodeColumn(Math.min(start, end))}:$${encodeColumn(Math.max(start, end))}`;
-}
-function parseSpreadsheetPrintTitles(value) {
-    let rows;
-    let columns;
-    for (const part of splitRangeList(value.trim().replace(/^=/, ''))){
-        const rowReference = normalizeSpreadsheetPrintTitleRows(part);
-        if (rowReference) {
-            if (rows) return null;
-            const match = ROW_RANGE.exec(rowReference);
-            rows = [
-                Number(match[1]) - 1,
-                Number(match[2]) - 1
-            ];
-            continue;
-        }
-        const columnReference = normalizeSpreadsheetPrintTitleColumns(part);
-        if (!columnReference || columns) return null;
-        const match = COLUMN_RANGE.exec(columnReference);
-        columns = [
-            decodeColumn(match[1]),
-            decodeColumn(match[2])
-        ];
-    }
-    return rows || columns ? {
-        rows,
-        columns
-    } : null;
-}
-function parseSpreadsheetCellRanges(value) {
-    const parts = splitRangeList(value.trim().replace(/^=/, ''));
-    if (!parts.length) return null;
-    const ranges = parts.map((part)=>{
-        const cells = CELL_OR_RANGE.exec(unqualifiedReference(part));
-        if (!cells) return null;
-        const first = decodeCell(cells[1], cells[2]);
-        const second = cells[3] && cells[4] ? decodeCell(cells[3], cells[4]) : first;
-        return {
-            row: [
-                Math.min(first.row, second.row),
-                Math.max(first.row, second.row)
-            ],
-            column: [
-                Math.min(first.column, second.column),
-                Math.max(first.column, second.column)
-            ]
-        };
-    });
-    return ranges.every((range)=>Boolean(range)) ? ranges : null;
-}
-function formatSpreadsheetCellRanges(ranges) {
-    return ranges.map((range)=>{
-        const start = encodeCell(range.row[0], range.column[0]);
-        const end = encodeCell(range.row[1], range.column[1]);
-        return start === end ? start : `${start}:${end}`;
-    }).join(',');
-}
-function qualifySpreadsheetRange(value, sheetName) {
-    const prefix = `'${sheetName.replaceAll("'", "''")}'!`;
-    return splitRangeList(value).map((part)=>part.includes('!') ? part.trim() : `${prefix}${part.trim()}`).join(',');
-}
-function stripSpreadsheetSheetQualifier(value, sheetName) {
-    const quotedPrefix = `'${sheetName.replaceAll("'", "''")}'!`;
-    const plainPrefix = `${sheetName}!`;
-    return splitRangeList(value.trim().replace(/^=/, '')).map((part)=>{
-        const reference = part.trim();
-        if (reference.toLowerCase().startsWith(quotedPrefix.toLowerCase())) return reference.slice(quotedPrefix.length);
-        if (reference.toLowerCase().startsWith(plainPrefix.toLowerCase())) return reference.slice(plainPrefix.length);
-        return reference;
-    }).join(',');
-}
-function splitRangeList(value) {
-    const parts = [];
-    let current = '';
-    let quoted = false;
-    for(let index = 0; index < value.length; index += 1){
-        const character = value[index];
-        if ("'" === character) {
-            if (quoted && "'" === value[index + 1]) {
-                current += "''";
-                index += 1;
-                continue;
-            }
-            quoted = !quoted;
-        }
-        if (',' !== character || quoted) current += character;
-        else {
-            if (current.trim()) parts.push(current.trim());
-            current = '';
-        }
-    }
-    if (current.trim()) parts.push(current.trim());
-    return parts;
-}
-function unqualifiedReference(value) {
-    const reference = value.trim().replace(/^=/, '');
-    const separator = reference.lastIndexOf('!');
-    return separator >= 0 ? reference.slice(separator + 1) : reference;
-}
-function decodeCell(column, row) {
-    return {
-        row: Math.max(0, Number(row) - 1),
-        column: decodeColumn(column)
-    };
-}
-function decodeColumn(value) {
-    let result = 0;
-    for (const character of value.toUpperCase())result = 26 * result + character.charCodeAt(0) - 64;
-    return Math.max(0, result - 1);
-}
-function encodeCell(row, column) {
-    return `${encodeColumn(column)}${Math.max(0, row) + 1}`;
-}
-function encodeColumn(column) {
-    let value = Math.max(0, column) + 1;
-    let label = '';
-    while(value > 0){
-        value -= 1;
-        label = String.fromCharCode(65 + value % 26) + label;
-        value = Math.floor(value / 26);
-    }
-    return label;
-}
 const MAXIMUM_SOURCE_CELLS = 100000;
 const MAXIMUM_OUTPUT_CELLS = 20000;
 const MAXIMUM_XLSX_ROW = 1048575;

package/dist/internal/collaboration/office-spreadsheet-collaboration-records.d.ts

@@ -8,6 +8,8 @@ export declare const SPREADSHEET_RECORD_CHARTS = "charts";
 export declare const SPREADSHEET_RECORD_CHART_ORDER = "chartOrder";
 export declare const SPREADSHEET_RECORD_PIVOTS = "pivotTables";
 export declare const SPREADSHEET_RECORD_PIVOT_ORDER = "pivotOrder";
+export declare const SPREADSHEET_RECORD_TABLES = "tables";
+export declare const SPREADSHEET_RECORD_TABLE_ORDER = "tableOrder";
 export declare function initializeSpreadsheetSheetRecord(record: Y.Map<unknown>, sheet: WorkSpreadsheetSheet): void;
 export declare function patchSpreadsheetSheetRecord(record: Y.Map<unknown>, previous: WorkSpreadsheetSheet | undefined, next: WorkSpreadsheetSheet): void;
 export declare function readSpreadsheetSheetRecord(record: Y.Map<unknown>, id: string): WorkSpreadsheetSheet;

package/dist/internal/collaboration/office-spreadsheet-collaboration-validation-support.d.ts

@@ -0,0 +1,6 @@
+export declare function requiredCoordinate(value: unknown, maximum: number, label: string, sheetId: string): number;
+export declare function requiredInputRecord(value: unknown, label: string): Record<string, unknown>;
+export declare function requiredIdentifier(value: unknown, label: string): string;
+export declare function requiredNonEmptyString(value: unknown, label: string): string;
+export declare function validateJsonRecord(value: Record<string, unknown>, label: string): Record<string, unknown>;
+export declare function invalidWorkOfficeSpreadsheetInput(expected: string): never;

package/dist/internal/features/work/editors/spreadsheet-auto-filter.d.ts

@@ -5,5 +5,6 @@ export interface SpreadsheetAutoFilterRange {
     column: [number, number];
 }
 export declare function spreadsheetAutoFilterRange(sheet: WorkSpreadsheetSheet, selection: Selection): SpreadsheetAutoFilterRange | null;
+export declare function spreadsheetSelectionOrCurrentRegion(sheet: WorkSpreadsheetSheet, selection: Selection): SpreadsheetAutoFilterRange | null;
 export declare function spreadsheetAutoFilterHeaderColumn(sheet: WorkSpreadsheetSheet | undefined, selection: Selection): number | null;
 export declare function toggleSpreadsheetAutoFilter(content: WorkSpreadsheetContent, sheetId: string, selection: Selection): WorkSpreadsheetContent | null;

package/dist/internal/features/work/editors/spreadsheet-command-catalog.d.ts

@@ -21,7 +21,13 @@ export declare const spreadsheetRibbonTabs: readonly [{
     readonly id: "view";
     readonly label: "视图";
 }];
-export type SpreadsheetRibbonTabId = (typeof spreadsheetRibbonTabs)[number]['id'];
+export declare const spreadsheetTableDesignRibbonTab: {
+    readonly id: "tableDesign";
+    readonly label: "表格设计";
+    readonly compactLabel: "设计";
+    readonly contextual: true;
+};
+export type SpreadsheetRibbonTabId = (typeof spreadsheetRibbonTabs)[number]['id'] | typeof spreadsheetTableDesignRibbonTab.id;
 export interface SpreadsheetCommandShortcut {
     label: string;
     aria: string;
@@ -757,6 +763,20 @@ export declare const spreadsheetCommandCatalog: {
             readonly group: "charts";
         };
     };
+    readonly table: {
+        readonly id: "insert.table";
+        readonly label: "表格";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "insert";
+            readonly group: "tables";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+T";
+            readonly aria: "Control+T Meta+T";
+            readonly editor: readonly ["Mod-t"];
+        };
+    };
     readonly hyperlink: {
         readonly id: "insert.hyperlink";
         readonly label: "超链接";

package/dist/internal/features/work/editors/spreadsheet-command-controller.d.ts

@@ -18,6 +18,7 @@ import { type SpreadsheetKeyboardSelection, type SpreadsheetSelectionMove, type
 import type { SpreadsheetPasteContent } from './spreadsheet-paste-special';
 import { type SpreadsheetDecimalPlacesDirection } from './spreadsheet-number-format-command';
 import { type SpreadsheetSheetMoveDirection } from './spreadsheet-sheet-model';
+import type { SpreadsheetTableDesignPatch, SpreadsheetTableRequest, SpreadsheetTableTarget } from './spreadsheet-table';
 export interface SpreadsheetWorkbookCommandPort {
     autoFillCell: (copyRange: SpreadsheetCommandRange, applyRange: SpreadsheetCommandRange, direction: SpreadsheetCellFillDirection) => void;
     batchCallApis: (apiCalls: Array<{
@@ -127,6 +128,10 @@ export interface SpreadsheetHyperlinkCommandPort {
     canOpen: boolean;
     open: (request: SpreadsheetHyperlinkCell) => boolean;
 }
+export interface SpreadsheetTableCommandPort {
+    canOpen: boolean;
+    open: (target: SpreadsheetTableTarget) => boolean;
+}
 export interface SpreadsheetNavigationCommandPort {
     canOpenFind: boolean;
     canOpenGoTo: boolean;
@@ -150,6 +155,7 @@ export interface SpreadsheetEditorCommands {
     applyAutoSum: (functionName: SpreadsheetAutoSumFunction) => boolean;
     applyFormatPainter: (target: SpreadsheetCommandSelection) => boolean;
     applyHyperlink: (request: SpreadsheetHyperlinkRequest) => boolean;
+    applyTable: (request: SpreadsheetTableRequest) => boolean;
     cancelFormatPainter: () => boolean;
     clearSelectedCells: (mode?: SpreadsheetCellClearMode) => boolean;
     copySelection: () => boolean;
@@ -170,6 +176,7 @@ export interface SpreadsheetEditorCommands {
     openGoTo: () => boolean;
     openHyperlink: () => boolean;
     openPasteSpecial: () => boolean;
+    openTable: () => boolean;
     pasteCells: (values: readonly (readonly unknown[])[]) => boolean;
     pasteSelection: () => boolean;
     pasteSpecial: (content: SpreadsheetPasteContent) => boolean;
@@ -190,6 +197,8 @@ export interface SpreadsheetEditorCommands {
     setZoom: (percent: number) => boolean;
     sortSelectedCells: (direction: SpreadsheetSortDirection) => boolean;
     toggleAutoFilter: () => boolean;
+    updateTable: (sheetId: string, tableId: string, patch: SpreadsheetTableDesignPatch) => boolean;
+    convertTableToRange: (sheetId: string, tableId: string) => boolean;
     undo: () => boolean;
 }
 export type SpreadsheetEditorCanCommands = OfficeEditorCanCommands<SpreadsheetEditorCommands>;
@@ -210,6 +219,7 @@ export interface SpreadsheetCommandContext {
     navigation: SpreadsheetNavigationCommandPort;
     onChange: (content: WorkSpreadsheetContent) => void;
     selection: SpreadsheetCommandSelection | null;
+    table: SpreadsheetTableCommandPort;
     targetSheetGridSize?: SpreadsheetGridSize | null;
     targetSheetId: string;
     toolbarCell: Cell | null;

package/dist/internal/features/work/editors/spreadsheet-editor-ribbon.d.ts

@@ -1,5 +1,5 @@
 import type { Cell, Selection } from '@fortune-sheet/core';
-import type { WorkSpreadsheetContent } from '../work-types';
+import type { WorkSpreadsheetContent, WorkSpreadsheetTable } from '../work-types';
 import type { SpreadsheetResolvedCellBorders } from './spreadsheet-cell-border';
 import { type SpreadsheetRibbonTabId } from './spreadsheet-command-catalog';
 import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
@@ -7,8 +7,10 @@ import type { SpreadsheetFormatPainterMode } from './spreadsheet-format-painter'
 import type { SpreadsheetWorkbookPanelView } from './spreadsheet-workbook-panel';
 import { type WorkOfficeFileAction } from './work-office-chrome';
 export type { SpreadsheetRibbonTabId } from './spreadsheet-command-catalog';
-export declare function SpreadsheetEditorRibbon({ activeTab, autoFilterActive, can, commands, content, fileActions, findOpen, formatPainterMode, freezePanesActive, freezePanesSelection, gridLinesVisible, panelId, onTabChange, onTogglePanel, panel, toolbarCell, toolbarCellBorders, }: {
+export declare function SpreadsheetEditorRibbon({ activeTab, activeTable, activeTableSheetId, autoFilterActive, can, commands, content, fileActions, findOpen, formatPainterMode, freezePanesActive, freezePanesSelection, gridLinesVisible, panelId, onTabChange, onTogglePanel, panel, toolbarCell, toolbarCellBorders, }: {
     activeTab: SpreadsheetRibbonTabId;
+    activeTable?: WorkSpreadsheetTable | null;
+    activeTableSheetId?: string;
     autoFilterActive?: boolean;
     can: SpreadsheetEditorCanCommands;
     commands: SpreadsheetEditorCommands;

package/dist/internal/features/work/editors/spreadsheet-table-command.d.ts

@@ -0,0 +1,3 @@
+import type { SpreadsheetCommandContext, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+import { type OfficeEditorExtension } from './office-editor-extension';
+export declare function createSpreadsheetTableExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

package/dist/internal/features/work/editors/spreadsheet-table-conversion.d.ts

@@ -0,0 +1,7 @@
+import type { WorkSpreadsheetContent, WorkSpreadsheetTable } from '../work-types';
+export declare function canMaterializeSpreadsheetTableAppearance(table: WorkSpreadsheetTable): boolean;
+/**
+ * Convert to Range removes ListObject semantics, so the render-only style must
+ * become native cell formatting to preserve the appearance users confirmed.
+ */
+export declare function materializeSpreadsheetTableAppearance(content: WorkSpreadsheetContent, sheetId: string, table: WorkSpreadsheetTable): WorkSpreadsheetContent | null;

package/dist/internal/features/work/editors/spreadsheet-table-dialog.d.ts

@@ -0,0 +1,8 @@
+import type { SpreadsheetTableDialogSource, SpreadsheetTableDialogValue } from './spreadsheet-table';
+export declare function SpreadsheetTableDialog({ source, restoreFocusTarget, onApply, onClose, onValidate, }: {
+    source: SpreadsheetTableDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetTableDialogValue) => boolean;
+    onClose: () => void;
+    onValidate: (value: SpreadsheetTableDialogValue) => string | null;
+}): import("react").JSX.Element;

package/dist/internal/features/work/editors/spreadsheet-table-limits.d.ts

@@ -0,0 +1 @@
+export declare const MAX_SPREADSHEET_TABLE_CELLS = 100000;

package/dist/internal/features/work/editors/spreadsheet-table-reconciliation.d.ts

@@ -0,0 +1,21 @@
+import type { Op } from '@fortune-sheet/core';
+import type { WorkSpreadsheetSheet } from '../work-types';
+export type SpreadsheetTableStructureChange = {
+    axis: 'column' | 'row';
+    count: number;
+    direction: 'lefttop' | 'rightbottom';
+    index: number;
+    kind: 'insert';
+} | {
+    axis: 'column' | 'row';
+    end: number;
+    kind: 'delete';
+    start: number;
+};
+export declare function canApplySpreadsheetTableStructureChange(sheet: WorkSpreadsheetSheet | undefined, change: SpreadsheetTableStructureChange): boolean;
+/**
+ * Reconciles Fortune's cell and whole-row/column operation stream with the
+ * browser-owned ListObject model. Fortune preserves unknown sheet metadata,
+ * but it cannot update table ranges, column identities, or filter offsets.
+ */
+export declare function reconcileSpreadsheetTablesAfterFortune(sheets: WorkSpreadsheetSheet[], sourceSheets: WorkSpreadsheetSheet[], operations?: readonly Op[]): WorkSpreadsheetSheet[];

package/dist/internal/features/work/editors/spreadsheet-table-render.d.ts

@@ -0,0 +1,16 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { SpreadsheetTableCellRenderStyle } from './spreadsheet-table-style';
+export interface SpreadsheetTableRenderCellInfo {
+    column: number;
+    endX: number;
+    endY: number;
+    row: number;
+    startX: number;
+    startY: number;
+}
+export interface SpreadsheetTableConditionalStyle {
+    cellColor?: string;
+    textColor?: string;
+}
+export declare function beginSpreadsheetTableCellRender(_cell: Cell | null, tableStyle: SpreadsheetTableCellRenderStyle | null, conditionalStyle: SpreadsheetTableConditionalStyle | undefined, context: CanvasRenderingContext2D): void;
+export declare function finishSpreadsheetTableCellRender(_cell: Cell | null, cellInfo: SpreadsheetTableRenderCellInfo, tableStyle: SpreadsheetTableCellRenderStyle | null, context: CanvasRenderingContext2D): void;

package/dist/internal/features/work/editors/spreadsheet-table-ribbon.d.ts

@@ -0,0 +1,8 @@
+import type { WorkSpreadsheetTable } from '../work-types';
+import type { SpreadsheetEditorCanCommands, SpreadsheetEditorCommands } from './spreadsheet-command-controller';
+export declare function SpreadsheetTableDesignRibbon({ can, commands, sheetId, table, }: {
+    can: SpreadsheetEditorCanCommands;
+    commands: SpreadsheetEditorCommands;
+    sheetId: string;
+    table: WorkSpreadsheetTable;
+}): import("react").JSX.Element;

package/dist/internal/features/work/editors/spreadsheet-table-style.d.ts

@@ -0,0 +1,31 @@
+import type { WorkSpreadsheetTable, WorkSpreadsheetTableStyle } from '../work-types';
+export interface SpreadsheetTableStylePalette {
+    border: string;
+    header: string;
+    headerText: string;
+    primaryRow: string;
+    secondaryRow: string;
+    stripeColumn: string;
+    text: string;
+    total: string;
+    totalText: string;
+}
+export interface SpreadsheetTableStyleChoice {
+    label: string;
+    ooxmlName: string;
+    palette: SpreadsheetTableStylePalette;
+    style: Exclude<WorkSpreadsheetTableStyle, {
+        family: 'none';
+    }>;
+}
+export interface SpreadsheetTableCellRenderStyle {
+    background: string;
+    bold: boolean;
+    borderColor: string;
+    role: 'body' | 'header' | 'totals';
+    tableId: string;
+    textColor: string;
+}
+export declare function spreadsheetTableStyleChoices(): readonly SpreadsheetTableStyleChoice[];
+export declare function spreadsheetTableStylePalette(style: WorkSpreadsheetTableStyle): SpreadsheetTableStylePalette | null;
+export declare function createSpreadsheetTableRenderResolver(tables: readonly WorkSpreadsheetTable[]): (row: number, column: number) => SpreadsheetTableCellRenderStyle | null;

package/dist/internal/features/work/editors/spreadsheet-table.d.ts

@@ -0,0 +1,55 @@
+import type { Selection } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent, WorkSpreadsheetSheet, WorkSpreadsheetTable, WorkSpreadsheetTableStyle } from '../work-types';
+import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+export { MAX_SPREADSHEET_TABLE_CELLS } from './spreadsheet-table-limits';
+export interface SpreadsheetTableTarget {
+    sheetId: string;
+    selection: Selection;
+}
+export interface SpreadsheetTableDialogValue {
+    headerRow: boolean;
+    rangeReference: string;
+}
+export interface SpreadsheetTableDialogSource {
+    name: string;
+    range: SpreadsheetCellRange;
+    rangeReference: string;
+    sheetId: string;
+    sheetName: string;
+    value: SpreadsheetTableDialogValue;
+}
+export interface SpreadsheetTableRequest {
+    headerRow: boolean;
+    name: string;
+    range: SpreadsheetCellRange;
+    sheetId: string;
+    style?: WorkSpreadsheetTableStyle;
+}
+export type SpreadsheetTableValidation = {
+    columns: string[];
+    name: string;
+    ok: true;
+    range: SpreadsheetCellRange;
+    sheet: WorkSpreadsheetSheet;
+} | {
+    code: SpreadsheetTableErrorCode;
+    message: string;
+    ok: false;
+};
+export type SpreadsheetTableErrorCode = 'auto-filter-overlap' | 'invalid-column-name' | 'invalid-name' | 'invalid-range' | 'invalid-style' | 'merged-range' | 'name-conflict' | 'out-of-bounds' | 'protected-range' | 'pivot-table' | 'range-too-large' | 'sheet-not-found' | 'table-overlap';
+export interface SpreadsheetTableDesignPatch {
+    name?: string;
+    showColumnStripes?: boolean;
+    showFirstColumn?: boolean;
+    showLastColumn?: boolean;
+    showRowStripes?: boolean;
+    style?: WorkSpreadsheetTableStyle;
+}
+export declare function createSpreadsheetTableDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetTableTarget): SpreadsheetTableDialogSource | null;
+export declare function spreadsheetTableRangeFromText(value: string): SpreadsheetCellRange | null;
+export declare function validateSpreadsheetTableRequest(content: WorkSpreadsheetContent, request: SpreadsheetTableRequest): SpreadsheetTableValidation;
+export declare function applySpreadsheetTable(content: WorkSpreadsheetContent, request: SpreadsheetTableRequest): WorkSpreadsheetContent | null;
+export declare function updateSpreadsheetTable(content: WorkSpreadsheetContent, sheetId: string, tableId: string, patch: SpreadsheetTableDesignPatch): WorkSpreadsheetContent | null;
+export declare function convertSpreadsheetTableToRange(content: WorkSpreadsheetContent, sheetId: string, tableId: string): WorkSpreadsheetContent | null;
+export declare function spreadsheetTableAtCell(sheet: WorkSpreadsheetSheet | undefined, row: number, column: number): WorkSpreadsheetTable | null;
+export declare function spreadsheetTableFailureMessage(content: WorkSpreadsheetContent, request: SpreadsheetTableRequest): string | null;

package/dist/internal/features/work/editors/use-spreadsheet-table.d.ts

@@ -0,0 +1,23 @@
+import type { Selection } from '@fortune-sheet/core';
+import type { WorkSpreadsheetContent } from '../work-types';
+import type { SpreadsheetEditorCommands, SpreadsheetTableCommandPort } from './spreadsheet-command-controller';
+export interface SpreadsheetTableSelectionState {
+    selection: Selection;
+    sheetId: string;
+}
+export declare function useSpreadsheetTable({ commandsRef, contentRef, focusGrid, getGridFocusTarget, getLiveSelection, preview, }: {
+    commandsRef: {
+        current: SpreadsheetEditorCommands | null;
+    };
+    contentRef: {
+        current: WorkSpreadsheetContent;
+    };
+    focusGrid: (focusOrigin: Element | null) => void;
+    getGridFocusTarget: () => HTMLElement | null;
+    getLiveSelection: () => Selection | undefined;
+    preview: boolean;
+}): {
+    commandPort: SpreadsheetTableCommandPort;
+    selectionForChange: () => SpreadsheetTableSelectionState | null;
+    dialog: import("react").JSX.Element | null;
+};