@a3s-lab/office 0.14.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/core.js

@@ -7,6 +7,6 @@ export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./4476.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./2180.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
 export { core_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

package/dist/index.js

@@ -10,6 +10,6 @@ export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./4476.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./2180.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
 export { src_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, src_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, src_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

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,34 @@ 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: "超链接";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "insert";
+            readonly group: "links";
+        };
+        readonly shortcut: {
+            readonly label: "Cmd/Ctrl+K";
+            readonly aria: "Control+K Meta+K";
+            readonly editor: readonly ["Mod-k"];
+        };
+    };
     readonly printSettings: {
         readonly id: "pageLayout.printSettings";
         readonly label: "打印设置";
@@ -835,6 +869,15 @@ export declare const spreadsheetCommandCatalog: {
             readonly editor: readonly ["Alt-ArrowDown"];
         };
     };
+    readonly dataValidation: {
+        readonly id: "data.validation";
+        readonly label: "数据验证";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "data";
+            readonly group: "dataTools";
+        };
+    };
     readonly pivotTable: {
         readonly id: "data.pivotTable";
         readonly label: "数据透视表";

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

@@ -9,13 +9,16 @@ import type { SpreadsheetCellFormatRequest } from './spreadsheet-cell-format';
 import type { SpreadsheetCellRange } from './spreadsheet-cell-range';
 import type { SpreadsheetCellStyleChoice } from './spreadsheet-cell-style';
 import type { SpreadsheetCellFillDirection } from './spreadsheet-cell-fill';
+import type { SpreadsheetDataValidationRequest, SpreadsheetDataValidationTarget } from './spreadsheet-data-validation';
 import { type SpreadsheetCellMergeCommand } from './spreadsheet-cell-merge';
 import type { SpreadsheetFormatPainterMode } from './spreadsheet-format-painter';
+import type { SpreadsheetHyperlinkCell, SpreadsheetHyperlinkRequest } from './spreadsheet-hyperlink';
 import { type SpreadsheetFreezePanePreset } from './spreadsheet-freeze-panes';
 import { type SpreadsheetKeyboardSelection, type SpreadsheetSelectionMove, type SpreadsheetSelectionScope } from './spreadsheet-keyboard-navigation';
 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<{
@@ -117,6 +120,18 @@ export interface SpreadsheetFormatCellsCommandPort {
     canOpen: boolean;
     open: (request: SpreadsheetFormatCellsOpenRequest) => boolean;
 }
+export interface SpreadsheetDataValidationCommandPort {
+    canOpen: boolean;
+    open: (request: SpreadsheetDataValidationTarget) => boolean;
+}
+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;
@@ -136,8 +151,11 @@ export interface SpreadsheetEditorCommands {
     adjustDecimalPlaces: (direction: SpreadsheetDecimalPlacesDirection) => boolean;
     applyCellStyle: (preset: SpreadsheetCellStyleChoice) => boolean;
     applyCellFormat: (request: SpreadsheetCellFormatRequest) => boolean;
+    applyDataValidation: (request: SpreadsheetDataValidationRequest) => boolean;
     applyAutoSum: (functionName: SpreadsheetAutoSumFunction) => boolean;
     applyFormatPainter: (target: SpreadsheetCommandSelection) => boolean;
+    applyHyperlink: (request: SpreadsheetHyperlinkRequest) => boolean;
+    applyTable: (request: SpreadsheetTableRequest) => boolean;
     cancelFormatPainter: () => boolean;
     clearSelectedCells: (mode?: SpreadsheetCellClearMode) => boolean;
     copySelection: () => boolean;
@@ -152,14 +170,19 @@ export interface SpreadsheetEditorCommands {
     moveSheet: (sheetId: string, direction: SpreadsheetSheetMoveDirection) => boolean;
     moveSelection: (move: SpreadsheetSelectionMove, extend: boolean) => boolean;
     openAutoFilterMenu: () => boolean;
+    openDataValidation: () => boolean;
     openFind: () => boolean;
     openFormatCells: () => boolean;
     openGoTo: () => boolean;
+    openHyperlink: () => boolean;
     openPasteSpecial: () => boolean;
+    openTable: () => boolean;
     pasteCells: (values: readonly (readonly unknown[])[]) => boolean;
     pasteSelection: () => boolean;
     pasteSpecial: (content: SpreadsheetPasteContent) => boolean;
     recalculateFormula: (scope: 'selection' | 'workbook') => boolean;
+    removeHyperlink: (target: SpreadsheetHyperlinkCell) => boolean;
+    removeDataValidation: (target: SpreadsheetDataValidationTarget) => boolean;
     renameSheet: (sheetId: string, name: string) => boolean;
     redo: () => boolean;
     setCellFormat: (attribute: keyof Cell, value: unknown) => boolean;
@@ -174,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>;
@@ -183,15 +208,18 @@ export interface SpreadsheetCommandContext {
     calculation: SpreadsheetCalculationCommandPort | null;
     clipboard: SpreadsheetClipboardCommandPort;
     content: WorkSpreadsheetContent;
+    dataValidation: SpreadsheetDataValidationCommandPort;
     editable: boolean;
     fallbackRange: SpreadsheetCommandRange;
     formulaBar: SpreadsheetFormulaBarCommandPort | null;
     formatPainter: SpreadsheetFormatPainterCommandPort;
     formatCells: SpreadsheetFormatCellsCommandPort;
+    hyperlink: SpreadsheetHyperlinkCommandPort;
     history: SpreadsheetHistoryCommandPort | null;
     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-data-validation-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 createSpreadsheetDataValidationExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

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

@@ -0,0 +1,9 @@
+import { type SpreadsheetDataValidationDialogSource, type SpreadsheetDataValidationDialogValue } from './spreadsheet-data-validation';
+export declare function SpreadsheetDataValidationDialog({ source, restoreFocusTarget, onApply, onClose, onRemove, onValidate, }: {
+    source: SpreadsheetDataValidationDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetDataValidationDialogValue) => boolean;
+    onClose: () => void;
+    onRemove: () => boolean;
+    onValidate: (value: SpreadsheetDataValidationDialogValue) => string | null;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,50 @@
+import type { WorkSpreadsheetContent, WorkSpreadsheetDataValidationItem, WorkSpreadsheetSheet } from '../work-types';
+import { type SpreadsheetCellRange } from './spreadsheet-cell-range';
+export declare const MAX_SPREADSHEET_DATA_VALIDATION_CELLS = 10000;
+export type SpreadsheetDataValidationType = 'date' | 'dropdown' | 'number' | 'number_integer' | 'text_length';
+export type SpreadsheetDataValidationOperator = 'between' | 'equal' | 'greaterOrEqualTo' | 'lessThan' | 'lessThanOrEqualTo' | 'moreThanThe' | 'noEarlierThan' | 'noLaterThan' | 'notBetween' | 'notEqualTo' | 'earlierThan' | 'laterThan';
+export interface SpreadsheetDataValidationDialogValue {
+    hintShow: boolean;
+    hintValue: string;
+    prohibitInput: boolean;
+    type: SpreadsheetDataValidationType;
+    type2: SpreadsheetDataValidationOperator | '';
+    value1: string;
+    value2: string;
+}
+export interface SpreadsheetDataValidationTarget {
+    activeCell: {
+        row: number;
+        column: number;
+    };
+    ranges: readonly SpreadsheetCellRange[];
+    sheetId: string;
+}
+export interface SpreadsheetDataValidationRequest extends SpreadsheetDataValidationTarget {
+    value: SpreadsheetDataValidationDialogValue;
+}
+export interface SpreadsheetDataValidationDialogSource extends SpreadsheetDataValidationTarget {
+    hasValidation: boolean;
+    mixed: boolean;
+    rangeReference: string;
+    sheetName: string;
+    value: SpreadsheetDataValidationDialogValue;
+}
+export type SpreadsheetDataValidationResult = {
+    item: WorkSpreadsheetDataValidationItem;
+    ok: true;
+    ranges: SpreadsheetCellRange[];
+    sheet: WorkSpreadsheetSheet;
+} | {
+    code: SpreadsheetDataValidationErrorCode;
+    message: string;
+    ok: false;
+};
+export type SpreadsheetDataValidationErrorCode = 'invalid-date' | 'invalid-list-source' | 'invalid-number' | 'invalid-operator' | 'invalid-range' | 'invalid-text-length' | 'missing-value' | 'multiple-list-columns' | 'out-of-bounds' | 'protected-range' | 'range-too-large' | 'sheet-not-found' | 'value-order';
+export declare function spreadsheetDataValidationOperators(type: SpreadsheetDataValidationType): readonly SpreadsheetDataValidationOperator[];
+export declare function createSpreadsheetDataValidationDialogSource(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): SpreadsheetDataValidationDialogSource | null;
+export declare function validateSpreadsheetDataValidationRequest(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): SpreadsheetDataValidationResult;
+export declare function applySpreadsheetDataValidation(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): WorkSpreadsheetContent | null;
+export declare function removeSpreadsheetDataValidation(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): WorkSpreadsheetContent | null;
+export declare function canRemoveSpreadsheetDataValidation(content: WorkSpreadsheetContent, target: SpreadsheetDataValidationTarget): boolean;
+export declare function spreadsheetDataValidationFailureMessage(content: WorkSpreadsheetContent, request: SpreadsheetDataValidationRequest): string | 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-editor-support.d.ts

@@ -32,6 +32,7 @@ export declare function sameSpreadsheetWorkbookState(changed: WorkSpreadsheetCon
 export declare function sameSpreadsheetWorkbookStateAfterOperations(changed: WorkSpreadsheetContent['sheets'], rendered: WorkSpreadsheetContent['sheets'], operations: readonly Op[]): boolean | null;
 export declare function sameSpreadsheetHistoryContent(left: WorkSpreadsheetContent, right: WorkSpreadsheetContent): boolean;
 export declare function spreadsheetContentWithSelection(content: WorkSpreadsheetContent, sheetId: string, selection: Selection | null | undefined): WorkSpreadsheetContent;
+export declare function spreadsheetContentWithSelections(content: WorkSpreadsheetContent, sheetId: string, selections: readonly Selection[]): WorkSpreadsheetContent;
 export declare function isSpreadsheetNativeTextUndoTarget(target: EventTarget | null): boolean;
 export declare function isSpreadsheetCellEditingTarget(target: EventTarget | null): boolean;
 export declare function spreadsheetFormulaBarSelectAllTarget(event: KeyboardEvent): HTMLElement | null;

package/dist/internal/features/work/editors/spreadsheet-hyperlink-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 createSpreadsheetHyperlinkExtension(): OfficeEditorExtension<SpreadsheetCommandContext, SpreadsheetEditorCommands>;

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

@@ -0,0 +1,9 @@
+import type { SpreadsheetHyperlinkDialogSource, SpreadsheetHyperlinkDialogValue } from './spreadsheet-hyperlink';
+export declare function SpreadsheetHyperlinkDialog({ source, restoreFocusTarget, onApply, onClose, onRemove, onValidate, }: {
+    source: SpreadsheetHyperlinkDialogSource;
+    restoreFocusTarget: () => HTMLElement | null;
+    onApply: (value: SpreadsheetHyperlinkDialogValue) => boolean;
+    onClose: () => void;
+    onRemove: () => boolean;
+    onValidate: (value: SpreadsheetHyperlinkDialogValue) => string | null;
+}): import("react").JSX.Element;